add numInsertedOrUpdatedRows to InsertResult.

[igalklebanov]

Also:

• Deprecate QueryResult.numUpdatedOrDeletedRows and add QueryResult.numAffectedRows.

---

• add to InsertResult.
• unit tests.
  - [ ] typings tests. tests for InsertResult already in place.

---

On MySQL, this field lets consumers know whether an insert...on duplicate key update query inserted OR updated some records. Real world scenario, publishing an event following the query, "entity {created | updated}".

With ON DUPLICATE KEY UPDATE, the affected-rows value per row is 1 if the row is inserted as a new row, 2 if an existing row is updated, and 0 if an existing row is set to its current values. If you specify the CLIENT_FOUND_ROWS flag to the mysql_real_connect() C API function when connecting to mysqld, the affected-rows value is 1 (not 0) if an existing row is set to its current values.
https://dev.mysql.com/doc/refman/8.0/en/insert-on-duplicate.html

The field is also relevant to inserts in Postgres..

The rowCount is populated from the command tag supplied by the PostgreSQL server. It's generally of the form: COMMAND [OID] [ROWS]. For DML commands (INSERT, UPDATE, etc), it reflects how many rows the server modified to process the command.
https://node-postgres.com/api/result

---

Things to consider:

Feels like QueryResult's numUpdatedOrDeletedRows should be renamed to numAffectedRows, which is more readable, neutral and aligned with MySQL terminology.

Stopped myself from doing this change as it'll break 3rd party drivers.

[igalklebanov]

• Added numAffectedRows to QueryResult. Added @deprecated to numUpdatedOrDeletedRows jsdoc.
• Added handling of both fields in built-in drivers & query builders.
• Added one-time outdated driver / plugin detection and "deprecation warning" @ query executor base.