docs: add RowDataPacket[][] with multipleStatements example

Author: wellwelwel

documentation/en/TypeScript-Examples.md

@@ -303,6 +303,7 @@ You can also check some code examples using **MySQL2** and **TypeScript** to und
 
 - [Extending and using **Interfaces** with `RowDataPacket`](../../examples/typescript/row-data-packet.ts)
 - [Extending and using **Interfaces** with `RowDataPacket` and `rowAsArray`](../../examples/typescript/row-data-packet-row-as-array.ts)
+- [Extending and using **Interfaces** with `RowDataPacket` and `multipleStatements`](../../examples/typescript/row-data-packet-multi-statements.ts)
 - Checking for `ResultSetHeader` or `RowDataPacket[]` using **Procedure Calls** (*in progress*)
 - Checking for `ResultSetHeader` or `RowDataPacket[][]` using **Procedure Calls** (*in progress*)
 - Creating a custom **MySQL2** **Class** (*in progress*)

examples/typescript/row-data-packet-multi-statements.ts

@@ -0,0 +1,80 @@
+/**
+ * The types are explicity for learning purpose
+ * By extending the `RowDataPacket`, you can use your Interface in `query` and `execute`
+ */
+
+import mysql, {
+  ConnectionOptions,
+  ResultSetHeader,
+  RowDataPacket,
+} from 'mysql2/promise';
+
+ interface User extends RowDataPacket {
+   /** id */
+   0: number;
+   /** name */
+   1: string;
+ }
+
+(async () => {
+  const access: ConnectionOptions = {
+    host: '',
+    user: '',
+    password: '',
+    database: '',
+    multipleStatements: true,
+  };
+
+  const conn = await mysql.createConnection(access);
+
+  /** Deleting the `users` table, if it exists */
+  await conn.query<ResultSetHeader>('DROP TABLE IF EXISTS `users`;');
+
+  /** Creating a minimal user table */
+  await conn.query<ResultSetHeader>(
+    'CREATE TABLE `users` (`id` INT(11) AUTO_INCREMENT, `name` VARCHAR(50), PRIMARY KEY (`id`));',
+  );
+
+  /** Inserting some users */
+  const [inserted] = await conn.execute<ResultSetHeader>(
+    'INSERT INTO `users`(`name`) VALUES(?), (?), (?), (?);',
+    ['Josh', 'John', 'Marie', 'Gween'],
+  );
+
+  console.log('Inserted:', inserted.affectedRows);
+
+  /** Getting users */
+  const [rows] = await conn.query<User[][]>(
+    [
+      'SELECT * FROM `users` ORDER BY `name` ASC LIMIT 2;',
+      'SELECT * FROM `users` ORDER BY `name` ASC LIMIT 2 OFFSET 2;',
+    ].join(' '),
+  );
+
+  rows.forEach((users) => {
+    users.forEach((user) => {
+      console.log('-----------');
+      console.log('id:  ', user.id);
+      console.log('name:', user.name);
+    });
+  });
+
+  await conn.end();
+})();
+
+/** Output
+  *
+  * Inserted: 4
+  * -----------
+  * id:   4
+  * name: Gween
+  * -----------
+  * id:   2
+  * name: John
+  * -----------
+  * id:   1
+  * name: Josh
+  * -----------
+  * id:   3
+  * name: Marie
+  */