types: support no-SQL styles of ds.execute

Signed-off-by: Miroslav Bajtoš <mbajtoss@gmail.com>

types/__test__.ts

@@ -88,3 +88,30 @@ const db = new DataSource('db', {connector: 'memory'});
     await ctx.Model.expire('key', 100);
   });
 });
+
+//-------
+// DataSource supports different `execute` styles
+//-------
+(async function () {
+  // SQL style
+  const tx = await db.beginTransaction();
+  await db.execute('SELECT * FROM Product WHERE count > ?', [10], {
+    transaction: tx,
+  });
+  await tx.commit();
+
+  // MongoDB style
+  await db.execute('MyCollection', 'aggregate', [
+    {$lookup: { /* ... */ }},
+    {$unwind: '$data'},
+    {$out: 'tempData'}
+  ]);
+
+  // Neo4J style
+  await db.execute({
+    query: 'MATCH (u:User {email: {email}}) RETURN u',
+    params: {
+      email: 'alice@example.com',
+    },
+  });
+});

types/datasource.d.ts

@@ -298,12 +298,23 @@ export declare class DataSource extends EventEmitter {
   ping(callback: Callback): void;
 
   // Only promise variant, callback is intentionally not supported.
+  // Execute a SQL command
   execute(
     command: string | object,
     args?: any[] | object,
     options?: Options,
   ): Promise<any>;
 
+  // Execute a MongoDB command. `options` argument is not supported.
+  execute(
+    collectionName: string,
+    command: string,
+    ...args: any[],
+  ): Promise<any>;
+
+  // Free-form variant to support other connector types.
+  execute(...args: any[]): Promise<any>;
+
   /**
    * Begin a new transaction.
    *