vsrepo 2.1.0 → 2.2.1

package/dist/types/utils/pagination.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=pagination.type.js.map

package/dist/types/utils/pagination.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.type.js","sourceRoot":"","sources":["../../../src/types/utils/pagination.type.ts"],"names":[],"mappings":""}

package/dist/types/utils/perform-data.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=perform-data.type.js.map

package/dist/types/utils/perform-data.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perform-data.type.js","sourceRoot":"","sources":["../../../src/types/utils/perform-data.type.ts"],"names":[],"mappings":""}

package/dist/types/utils/primitive.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=primitive.type.js.map

package/dist/types/utils/primitive.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.type.js","sourceRoot":"","sources":["../../../src/types/utils/primitive.type.ts"],"names":[],"mappings":""}

package/dist/types/utils/query-args.type.d.ts

@@ -0,0 +1,30 @@
+import { DbArg } from "../../internal/utils/db-arg.util";
+import { VSRepoOrmTypes } from "../vsrepo/vsrepo-orm-types.type";
+/**
+ * Types the parameter list of a `@QueryMethod` declared with
+ * `{ spreadArgs: true }`: the SQL placeholder values (`T`), in order,
+ * followed by an optional trailing {@link DbArg} — built via {@link withDb} —
+ * to run the query against a specific client or transaction instead of the
+ * repository's default one.
+ *
+ * @example
+ * ```typescript
+ * class UserRepository extends VSRepository<User, string> {
+ *     @QueryMethod('SELECT * FROM "user" WHERE email = $1 AND "userType" = $2', {
+ *         spreadArgs: true,
+ *     })
+ *     declare findByEmailAndType: (
+ *         ...args: QueryArgs<[email: string, userType: string]>
+ *     ) => Promise<User[]>;
+ * }
+ *
+ * await userRepository.findByEmailAndType("joao@email.com", "admin");
+ * await userRepository.findByEmailAndType("joao@email.com", "admin", withDb(tx));
+ * ```
+ *
+ * @publicApi
+ */
+export type QueryArgs<T extends Array<any> = [], O extends VSRepoOrmTypes = VSRepoOrmTypes> = [
+    ...T,
+    db?: DbArg<O>
+];

package/dist/types/utils/query-args.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=query-args.type.js.map

package/dist/types/utils/query-args.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-args.type.js","sourceRoot":"","sources":["../../../src/types/utils/query-args.type.ts"],"names":[],"mappings":""}

package/dist/types/utils/query-method-arg.type.d.ts

@@ -1,3 +1,4 @@
+import { VSRepoOrmTypes } from "../vsrepo/vsrepo-orm-types.type";
 /**
  * Single argument accepted by a method declared with `@QueryMethod`.
  *
@@ -19,9 +20,9 @@
  *
  * @publicApi
  */
-export type QueryMethodArg<T extends Array<any>> = {
+export type QueryMethodArg<T extends Array<any> = [], O extends VSRepoOrmTypes = VSRepoOrmTypes> = {
     /** Positional parameters injected into the SQL placeholders (`$1`, `$2`, ...). */
     args?: T;
     /** Database client or transaction to run this query in, instead of the repository's default client. */
-    db?: any;
+    db?: O["dbClient"] | O["dbTransaction"];
 };

package/dist/types/utils/query-method-arg.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=query-method-arg.type.js.map

package/dist/types/utils/query-method-arg.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-method-arg.type.js","sourceRoot":"","sources":["../../../src/types/utils/query-method-arg.type.ts"],"names":[],"mappings":""}

package/dist/types/utils/restrict-method-options.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=restrict-method-options.type.js.map

package/dist/types/utils/restrict-method-options.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restrict-method-options.type.js","sourceRoot":"","sources":["../../../src/types/utils/restrict-method-options.type.ts"],"names":[],"mappings":""}

package/dist/types/utils/see-mode.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=see-mode.type.js.map

package/dist/types/utils/see-mode.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"see-mode.type.js","sourceRoot":"","sources":["../../../src/types/utils/see-mode.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-args.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-args.type.js.map

package/dist/types/vsrepo/vsrepo-args.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-args.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-args.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-method.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-method.type.js.map

package/dist/types/vsrepo/vsrepo-method.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-method.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-method.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-options.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-options.type.js.map

package/dist/types/vsrepo/vsrepo-options.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-options.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-options.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-orm-types.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-orm-types.type.js.map

package/dist/types/vsrepo/vsrepo-orm-types.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-orm-types.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-orm-types.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-pretty-where.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-pretty-where.type.js.map

package/dist/types/vsrepo/vsrepo-pretty-where.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-pretty-where.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-pretty-where.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-query-options.type.d.ts

@@ -14,4 +14,18 @@ export type VSRepoQueryOptions<T extends VSRepoOrmTypes = VSRepoOrmTypes> = {
      * @default false
      */
     modifying?: boolean;
+    /**
+     * When `true`, the array returned by the underlying query is collapsed
+     * into its first element (`null` if the array is empty) before
+     * being resolved to the caller. Has no effect when the query resolves
+     * to something other than an array (e.g. a `modifying` query's
+     * affected-row count).
+     *
+     * Useful for queries you already know return at most one row (e.g. a
+     * `SELECT ... LIMIT 1` or a lookup by a unique column), where declaring
+     * the return type as an array would be misleading.
+     *
+     * @default false
+     */
+    singleResult?: boolean;
 };

package/dist/types/vsrepo/vsrepo-query-options.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-query-options.type.js.map

package/dist/types/vsrepo/vsrepo-query-options.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-query-options.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-query-options.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-query.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-query.type.js.map

package/dist/types/vsrepo/vsrepo-query.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-query.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-query.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-relations.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-relations.type.js.map

package/dist/types/vsrepo/vsrepo-relations.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-relations.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-relations.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-resolve-args-data.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-resolve-args-data.type.js.map

package/dist/types/vsrepo/vsrepo-resolve-args-data.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-resolve-args-data.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-resolve-args-data.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-select.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-select.type.js.map

package/dist/types/vsrepo/vsrepo-select.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-select.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-select.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-transaction-options.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-transaction-options.type.js.map

package/dist/types/vsrepo/vsrepo-transaction-options.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-transaction-options.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-transaction-options.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-ugly-where.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-ugly-where.type.js.map

package/dist/types/vsrepo/vsrepo-ugly-where.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-ugly-where.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-ugly-where.type.ts"],"names":[],"mappings":""}

package/dist/types/vsrepo/vsrepo-where.type.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=vsrepo-where.type.js.map

package/dist/types/vsrepo/vsrepo-where.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vsrepo-where.type.js","sourceRoot":"","sources":["../../../src/types/vsrepo/vsrepo-where.type.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vsrepo",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "ORM-agnostic repository pattern library with full TypeScript support and automatic type inference.",
   "homepage": "https://github.com/jaobrabo123/VSRepository#readme",
   "repository": {