@zudojs/database 1.3.0 → 1.3.2

package/README.md

@@ -72,6 +72,11 @@ await withTransaction(client, async (tx) => {
 await client.disconnect();
 ```
 
+A generated model delegate such as `prisma.user` is passed as-is, with no cast.
+`RepositoryDelegate` accepts any Prisma-style delegate whose rows match the
+entity type; `this.delegate` inside a subclass is typed with the arguments the
+repository passes (`RepositoryDelegateOperations`).
+
 `createDatabaseClient` accepts either a pre-built `prisma` instance or an
 `adapter` (in which case it constructs the `PrismaClient` for you). It throws a
 `DatabaseError` if neither is supplied.

package/dist/index.d.ts

@@ -21,7 +21,7 @@ export { noopDatabaseLogger } from "./databaseType/index.js";
 export { DatabaseClient, DatabaseAbortError, createDatabaseClient, buildPrismaTransactionOptions, createAbortError, raceAbort, throwIfAborted, SUPPORTED_ISOLATION_LEVELS, normalizeDatabaseError, withDatabaseErrorMetadata, isPrismaError, isRetryableTransactionError, isConflictError, isNotFoundError, getDatabaseErrorCode, getDatabaseErrorKind, isDatabaseErrorLike, isNonDatabaseBaseError, toDatabaseErrorInfo, RETRYABLE_DATABASE_CODES, type DatabaseClientOptions, type DatabaseTransactionContext, type PrismaClientLike, type PrismaDriverAdapterLike, type PrismaQueryEvent, type PrismaTransactionOptions, type RawQueryOptions, type DatabaseErrorKind, type NormalizeDatabaseErrorOptions, type PrismaErrorLike, } from "./databaseClient/index.js";
 export { DatabaseConnectionManager, createConnectionManager, type DatabaseConnectionEvent, type DatabaseConnectionListener, type DatabaseConnectionEventDetails, type DatabaseConnectionManagerOptions, type DatabaseReconnectOptions, } from "./databaseConnection/index.js";
 export { Database, createDatabase, getDatabase, connectDatabase, disconnectDatabase, resetDatabase, } from "./database/index.js";
-export { BaseRepository, mapRepositoryError, isPrismaErrorLike, toDatabaseOperation, type RepositoryDelegate, type BaseRepositoryOptions, type SoftDeleteOptions, type CursorQueryOptions, type TransactionClientLike, type RepositoryOperation, type RepositoryErrorContext, } from "./repository/index.js";
+export { BaseRepository, mapRepositoryError, isPrismaErrorLike, toDatabaseOperation, type RepositoryDelegate, type RepositoryDelegateOperations, type BaseRepositoryOptions, type SoftDeleteOptions, type CursorQueryOptions, type TransactionClientLike, type RepositoryOperation, type RepositoryErrorContext, } from "./repository/index.js";
 export { TransactionManager, createTransactionManager, withTransaction, withTransactionRetry, createTransactionContext, createTransactionId, getTransactionContextFromError, isTransactionActive, isTransactionCommitted, isTransactionFailed, type TransactionStatus, type TransactionContext, type TransactionOutcome, type TransactionRetryOptions, type ManagedTransactionOptions, } from "./transaction/index.js";
 export { DatabaseUnitOfWork, createUnitOfWork, executeUnitOfWork, type UnitOfWork, type UnitOfWorkOptions, } from "./unitOfWork/index.js";
 export { QueryBuilder, createQueryBuilder, toPrismaWhere, toPrismaArgs, toPrismaOrderBy, toPrismaSelect, toPrismaSkipTake, type QueryCondition, type QueryFilter, type QueryOperator, type RelationOperator, type QueryBuilderState, type PrismaWhere, type PrismaQueryArgs, type ToPrismaArgsOptions, } from "./queryBuilder/index.js";

package/dist/repository/index.d.ts

@@ -3,6 +3,7 @@
  *
  * Generic repository pattern with Prisma delegate support.
  */
-export { BaseRepository, type RepositoryDelegate, type BaseRepositoryOptions, type SoftDeleteOptions, type CursorQueryOptions, type TransactionClientLike, } from "./repository.base.js";
+export { BaseRepository, type BaseRepositoryOptions, type SoftDeleteOptions, type CursorQueryOptions, type TransactionClientLike, } from "./repository.base.js";
+export { type RepositoryDelegate, type RepositoryDelegateOperations, } from "./repository.delegate.js";
 export { mapRepositoryError, isPrismaErrorLike, toDatabaseOperation, toErrorMetadata, createAbortError, createTimeoutError, type RepositoryOperation, type RepositoryErrorContext, type PrismaErrorLike, } from "./repository.errors.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/repository/index.js

@@ -4,5 +4,6 @@
  * Generic repository pattern with Prisma delegate support.
  */
 export { BaseRepository, } from "./repository.base.js";
+export {} from "./repository.delegate.js";
 export { mapRepositoryError, isPrismaErrorLike, toDatabaseOperation, toErrorMetadata, createAbortError, createTimeoutError, } from "./repository.errors.js";
 //# sourceMappingURL=index.js.map

package/dist/repository/repository.base.d.ts

@@ -3,59 +3,8 @@ import { type CursorPaginatedResult } from "../pagination/pagination.core.js";
 import type { QueryBuilder } from "../queryBuilder/queryBuilder.core.js";
 import type { QueryBuilderState } from "../queryBuilder/queryBuilder.type.js";
 import type { RelationLoadOptions, RelationRegistry } from "../relations/relations.definition.js";
+import { type RepositoryDelegate, type RepositoryDelegateOperations } from "./repository.delegate.js";
 import { type RepositoryOperation } from "./repository.errors.js";
-/**
- * Generic Prisma-style delegate contract.
- *
- * This keeps the repository base class independent from generated
- * Prisma model types while still supporting standard CRUD operations.
- */
-export interface RepositoryDelegate<TEntity, TId = string, TCreateInput = Partial<TEntity>, TUpdateInput = Partial<TEntity>, TWhereInput = unknown> {
-    findUnique(args: {
-        where: unknown;
-    }): Promise<TEntity | null>;
-    findFirst(args: {
-        where?: TWhereInput;
-        orderBy?: unknown;
-        select?: unknown;
-    }): Promise<TEntity | null>;
-    findMany(args?: {
-        where?: TWhereInput;
-        skip?: number;
-        take?: number;
-        orderBy?: unknown;
-        select?: unknown;
-        include?: unknown;
-    }): Promise<readonly TEntity[]>;
-    create(args: {
-        data: TCreateInput;
-    }): Promise<TEntity>;
-    update(args: {
-        where: unknown;
-        data: TUpdateInput;
-    }): Promise<TEntity>;
-    delete(args: {
-        where: unknown;
-    }): Promise<TEntity>;
-    count(args?: {
-        where?: TWhereInput;
-    }): Promise<number>;
-    upsert?(args: {
-        where: unknown;
-        create: TCreateInput;
-        update: TUpdateInput;
-    }): Promise<TEntity>;
-    createMany?(args: {
-        data: readonly TCreateInput[];
-    }): Promise<{
-        count: number;
-    }>;
-    deleteMany?(args: {
-        where?: TWhereInput;
-    }): Promise<{
-        count: number;
-    }>;
-}
 /**
  * Soft-delete configuration.
  */
@@ -123,7 +72,7 @@ export type TransactionClientLike = Readonly<Record<string, unknown>>;
  * appropriate Prisma delegate plus any domain-specific behavior.
  */
 export declare abstract class BaseRepository<TEntity, TId = string, TCreateInput = Partial<TEntity>, TUpdateInput = Partial<TEntity>, TWhereInput = Record<string, unknown>> implements Repository<TEntity, TId, TCreateInput, TUpdateInput, TWhereInput>, SoftDeletableRepository<TEntity, TId, TCreateInput, TUpdateInput, TWhereInput> {
-    protected readonly delegate: RepositoryDelegate<TEntity, TId, TCreateInput, TUpdateInput, TWhereInput>;
+    protected readonly delegate: RepositoryDelegateOperations<TEntity, TId, TCreateInput, TUpdateInput, TWhereInput>;
     protected readonly modelName: string;
     protected readonly idField: string;
     protected readonly softDeleteField?: string;

package/dist/repository/repository.base.js

@@ -3,6 +3,7 @@ import { createPaginationMeta, normalizeLimit, normalizePage, } from "../paginat
 import { buildKeysetWhere, createKeysetPage, decodeKeysetCursor, } from "../pagination/pagination.keyset.js";
 import { getKeysetDirection, keysetFetchSort, } from "../pagination/pagination.keysetDirection.js";
 import { toPrismaArgs, toPrismaOrderBy, } from "../queryBuilder/queryBuilder.prisma.js";
+import { toDelegateOperations, } from "./repository.delegate.js";
 import { createAbortError, createTimeoutError, mapRepositoryError, } from "./repository.errors.js";
 const DEFAULT_SOFT_DELETE_FIELD = "deletedAt";
 const FIELD_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
@@ -29,7 +30,7 @@ export class BaseRepository {
         if (!delegate) {
             throw new TypeError("A repository delegate is required.");
         }
-        this.delegate = delegate;
+        this.delegate = toDelegateOperations(delegate);
         this.modelName = options.modelName ?? "DatabaseEntity";
         this.idField = validateFieldName(options.idField ?? "id", "idField");
         if (options.softDelete) {
@@ -70,7 +71,7 @@ export class BaseRepository {
         if (!delegate) {
             throw new TypeError("A repository delegate is required.");
         }
-        return this.rebind({ delegate });
+        return this.rebind({ delegate: toDelegateOperations(delegate) });
     }
     /**
      * Returns a copy of this repository whose reads include soft-deleted

package/dist/repository/repository.delegate.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Model delegate accepted by `BaseRepository`: any object exposing
+ * Prisma-style CRUD methods, including a generated Prisma model delegate
+ * such as `prisma.user`.
+ *
+ * The parameters are declared loosely on purpose, the same way
+ * `PrismaClientLike.$transaction` is. A generated delegate's methods are
+ * generic (`findFirst<T extends UserFindFirstArgs>(args?: SelectSubset<T,
+ * …>)`) and their argument types (`select?: UserSelect | null`,
+ * `where?: UserWhereInput`) cannot be assigned from a single hand-written
+ * argument shape, so a real client failed to type-check against the
+ * previous signatures and needed a cast. Any argument list is accepted
+ * here; the return types are still checked, so a delegate whose rows do not
+ * match `TEntity` is rejected. The arguments the repository actually passes
+ * are described by {@link RepositoryDelegateOperations}.
+ */
+export interface RepositoryDelegate<TEntity, TId = string, TCreateInput = Partial<TEntity>, TUpdateInput = Partial<TEntity>, TWhereInput = unknown> {
+    findUnique(...args: never[]): Promise<TEntity | null>;
+    findFirst(...args: never[]): Promise<TEntity | null>;
+    findMany(...args: never[]): Promise<readonly TEntity[]>;
+    create(...args: never[]): Promise<TEntity>;
+    update(...args: never[]): Promise<TEntity>;
+    delete(...args: never[]): Promise<TEntity>;
+    count(...args: never[]): Promise<number>;
+    upsert?(...args: never[]): Promise<TEntity>;
+    createMany?(...args: never[]): Promise<{
+        count: number;
+    }>;
+    deleteMany?(...args: never[]): Promise<{
+        count: number;
+    }>;
+}
+/**
+ * The calls `BaseRepository` makes on its delegate, with the arguments it
+ * passes. This is the type of `BaseRepository#delegate`, so subclasses can
+ * call the delegate directly.
+ */
+export interface RepositoryDelegateOperations<TEntity, TId = string, TCreateInput = Partial<TEntity>, TUpdateInput = Partial<TEntity>, TWhereInput = unknown> {
+    findUnique(args: {
+        where: unknown;
+    }): Promise<TEntity | null>;
+    findFirst(args: {
+        where?: TWhereInput;
+        orderBy?: unknown;
+        select?: unknown;
+    }): Promise<TEntity | null>;
+    findMany(args?: {
+        where?: TWhereInput;
+        skip?: number;
+        take?: number;
+        orderBy?: unknown;
+        select?: unknown;
+        include?: unknown;
+    }): Promise<readonly TEntity[]>;
+    create(args: {
+        data: TCreateInput;
+    }): Promise<TEntity>;
+    update(args: {
+        where: unknown;
+        data: TUpdateInput;
+    }): Promise<TEntity>;
+    delete(args: {
+        where: unknown;
+    }): Promise<TEntity>;
+    count(args?: {
+        where?: TWhereInput;
+    }): Promise<number>;
+    upsert?(args: {
+        where: unknown;
+        create: TCreateInput;
+        update: TUpdateInput;
+    }): Promise<TEntity>;
+    createMany?(args: {
+        data: readonly TCreateInput[];
+    }): Promise<{
+        count: number;
+    }>;
+    deleteMany?(args: {
+        where?: TWhereInput;
+    }): Promise<{
+        count: number;
+    }>;
+}
+/**
+ * Views a delegate through the calls the repository makes on it.
+ *
+ * The assertion is the narrowing that `RepositoryDelegate`'s loose
+ * parameters defer: the repository only ever passes the Prisma argument
+ * shapes described by `RepositoryDelegateOperations`, which every generated
+ * model delegate accepts at runtime.
+ */
+export declare function toDelegateOperations<TEntity, TId, TCreateInput, TUpdateInput, TWhereInput>(delegate: RepositoryDelegate<TEntity, TId, TCreateInput, TUpdateInput, TWhereInput>): RepositoryDelegateOperations<TEntity, TId, TCreateInput, TUpdateInput, TWhereInput>;
+//# sourceMappingURL=repository.delegate.d.ts.map

package/dist/repository/repository.delegate.js

@@ -0,0 +1,12 @@
+/**
+ * Views a delegate through the calls the repository makes on it.
+ *
+ * The assertion is the narrowing that `RepositoryDelegate`'s loose
+ * parameters defer: the repository only ever passes the Prisma argument
+ * shapes described by `RepositoryDelegateOperations`, which every generated
+ * model delegate accepts at runtime.
+ */
+export function toDelegateOperations(delegate) {
+    return delegate;
+}
+//# sourceMappingURL=repository.delegate.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudojs/database",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Database abstraction layer with clients, repositories, transactions, and query building for Zudojs applications.",
   "license": "MIT",
   "author": {
@@ -41,8 +41,8 @@
     "!dist/.tsbuildinfo"
   ],
   "dependencies": {
-    "@zudojs/errors": "1.3.0",
-    "@zudojs/logger": "1.4.0",
+    "@zudojs/errors": "1.3.1",
+    "@zudojs/logger": "1.4.2",
     "@zudojs/types": "1.2.0"
   },
   "peerDependencies": {