@zudojs/database 1.4.0 → 1.5.0

package/README.md

@@ -117,6 +117,13 @@ runtime, which only exists with the `prisma-client-js` generator. With the
 `prisma-client` generator, construct the client yourself and pass it as
 `prisma`.
 
+**Writing your own transaction client** (a hand-written adapter, a test
+double, a PGlite wrapper): since 1.4.0 `DatabaseTransactionContext` is a real
+structural type rather than a type that resolved to `any`, so an object you
+return as one must implement all four raw-query methods — `$queryRaw`,
+`$executeRaw`, `$queryRawUnsafe` and `$executeRawUnsafe` — or TypeScript
+reports TS2739. Code that only *receives* a transaction client is unaffected.
+
 ## Querying
 
 ```typescript
@@ -173,6 +180,21 @@ cursor or its contents. Building keyset pages by hand? Fetch with
 `keysetFetchSort(sort, getKeysetDirection(payload))` and pass that
 `direction` to `createKeysetPage`.
 
+`paginateCursor` appends the id field to `sort` as a tiebreaker, so a cursor
+positioned at a row you hold must include it: use
+`users.createCursor(row, { sort })` (signed with `cursorSecret`), not
+`createKeysetCursor(row, sort)` with the bare sort, which `paginateCursor`
+rejects as missing the id field.
+
+A `Date` sort value is encoded at millisecond precision. PostgreSQL
+`timestamp`/`timestamptz` columns keep microseconds unless declared `(3)`,
+and Prisma returns `Date`s, so the cursor compares such a value as its
+millisecond bucket (`>= C AND < C + 1ms` for a tie) and lets the id
+tiebreaker order rows created in the same millisecond. That is exact for
+identical timestamps (rows inserted by one statement or transaction) and for
+ids that increase with insertion order (serial, ULID, UUIDv7) — with random
+ids, sort by a millisecond-precision column or add a monotonic tiebreaker.
+
 ## Migrations and seeds
 
 ```typescript
@@ -216,6 +238,31 @@ Each migration or seed runs in its own transaction by default
 (`perItemTransaction: true`); pass `transaction: { timeoutMs, maxWaitMs, isolationLevel }`
 to size it for long-running steps.
 
+A migration that cannot run inside a transaction (`CREATE INDEX CONCURRENTLY`,
+`ALTER TYPE ... ADD VALUE`) sets `transaction: false`. Its `up`/`down` then
+receive the root client and run outside any transaction; the applied check
+and the history record still happen in short transactions under the advisory
+lock, which is released while the body runs, so write such a migration
+idempotently (`IF NOT EXISTS`). It requires `perItemTransaction: true`; a
+batch runner refuses it at construction.
+
+```typescript
+{
+  version: 20260926120000,
+  name: "orders_customer_idx",
+  transaction: false,
+  up: (db) => db.$executeRawUnsafe(
+    'CREATE INDEX CONCURRENTLY IF NOT EXISTS "orders_customer_idx" ON "orders" ("customerId")',
+  ),
+  down: (db) => db.$executeRawUnsafe('DROP INDEX CONCURRENTLY IF EXISTS "orders_customer_idx"'),
+}
+```
+
+`createTransactionContext` here builds the immutable status record that
+`TransactionManager.run` reports (`transactionId`, `startedAt`, `status`);
+it is unrelated to the `createTransactionContext` of `@zudojs/transactions`,
+which creates that package's AsyncLocalStorage propagation store.
+
 ## Errors
 
 Errors your own transaction callback throws that are already `@zudojs/errors`

package/dist/cache/cache.memory.d.ts

@@ -164,4 +164,3 @@ export declare function getOrSet<TValue>(cache: DatabaseCache<TValue>, key: stri
  * namespace only.
  */
 export declare function invalidateByPrefix(cache: DatabaseCache, prefix: string): number;
-//# sourceMappingURL=cache.memory.d.ts.map

package/dist/cache/cache.memory.js

@@ -374,4 +374,3 @@ function validateKey(key) {
         throw new TypeError("A non-empty cache key is required.");
     }
 }
-//# sourceMappingURL=cache.memory.js.map

package/dist/cache/index.d.ts

@@ -4,4 +4,3 @@
  * In-memory LRU cache for database read results.
  */
 export { MemoryDatabaseCache, createDatabaseCache, createCacheKey, escapeCachePart, serializeCachePart, getOrSet, invalidateByPrefix, CACHE_KEY_SEPARATOR, type CacheEntry, type CacheOptions, type MemoryCacheOptions, type CacheStats, type DatabaseCache, } from "./cache.memory.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.js

@@ -4,4 +4,3 @@
  * In-memory LRU cache for database read results.
  */
 export { MemoryDatabaseCache, createDatabaseCache, createCacheKey, escapeCachePart, serializeCachePart, getOrSet, invalidateByPrefix, CACHE_KEY_SEPARATOR, } from "./cache.memory.js";
-//# sourceMappingURL=index.js.map

package/dist/database/database.core.d.ts

@@ -102,4 +102,3 @@ export declare function disconnectDatabase(): Promise<void>;
  * runtime environments.
  */
 export declare function resetDatabase(): Promise<void>;
-//# sourceMappingURL=database.core.d.ts.map

package/dist/database/database.core.js

@@ -150,4 +150,3 @@ export async function resetDatabase() {
     defaultDatabase = undefined;
     await database.destroy();
 }
-//# sourceMappingURL=database.core.js.map

package/dist/database/index.d.ts

@@ -4,4 +4,3 @@
  * High-level database lifecycle entry point.
  */
 export { Database, createDatabase, getDatabase, connectDatabase, disconnectDatabase, resetDatabase, } from "./database.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/database/index.js

@@ -4,4 +4,3 @@
  * High-level database lifecycle entry point.
  */
 export { Database, createDatabase, getDatabase, connectDatabase, disconnectDatabase, resetDatabase, } from "./database.core.js";
-//# sourceMappingURL=index.js.map

package/dist/databaseClient/databaseClient.core.d.ts

@@ -227,4 +227,3 @@ export declare function raceAbort<T>(promise: Promise<T>, signal: AbortSignal |
  * the delegates.
  */
 export declare function createDatabaseClient<TClient extends PrismaClientLike = PrismaClientLike>(options?: DatabaseClientOptions<TClient>): DatabaseClient<TransactionClientOf<TClient>>;
-//# sourceMappingURL=databaseClient.core.d.ts.map

package/dist/databaseClient/databaseClient.core.js

@@ -510,4 +510,3 @@ export function raceAbort(promise, signal) {
 export function createDatabaseClient(options = {}) {
     return new DatabaseClient(options);
 }
-//# sourceMappingURL=databaseClient.core.js.map

package/dist/databaseClient/databaseClient.errors.d.ts

@@ -11,7 +11,7 @@
  * `clientVersion`), so the mapping works regardless of which copy of
  * `@prisma/client` produced the error.
  */
-import { DatabaseError, DatabaseOperation, type BaseError, type DatabaseErrorOptions } from "@zudojs/errors";
+import { DatabaseError, DatabaseOperation, ErrorCode, type BaseError, type DatabaseErrorOptions } from "@zudojs/errors";
 import type { DatabaseErrorInfo } from "../databaseType/databaseType.type.js";
 /**
  * Structural `DatabaseError` guard.
@@ -67,10 +67,28 @@ export interface PrismaErrorLike {
     readonly message?: string;
     readonly retryable?: boolean;
 }
+/**
+ * How a Prisma error code is normalised: its classification, HTTP status,
+ * framework error code, client-safe message and whether that message may
+ * be exposed.
+ */
+export interface PrismaCodeMapping {
+    readonly kind: DatabaseErrorKind;
+    readonly statusCode: number;
+    readonly code: ErrorCode;
+    readonly message: string;
+    readonly expose: boolean;
+}
 /**
  * Codes that indicate a transient transaction failure worth retrying.
  */
 export declare const RETRYABLE_DATABASE_CODES: ReadonlySet<string>;
+/**
+ * The mapping {@link normalizeDatabaseError} applies to a Prisma error
+ * code, or `undefined` for a code it does not know. Shared with the
+ * repository mapper so both classify the same code the same way.
+ */
+export declare function getPrismaCodeMapping(code: string): PrismaCodeMapping | undefined;
 /**
  * Detects a Prisma error structurally.
  */
@@ -120,4 +138,3 @@ export declare function normalizeDatabaseError(error: unknown, options?: Normali
  * normalised first, so Prisma codes appear as `code`.
  */
 export declare function toDatabaseErrorInfo(error: unknown, options?: NormalizeDatabaseErrorOptions): DatabaseErrorInfo;
-//# sourceMappingURL=databaseClient.errors.d.ts.map

package/dist/databaseClient/databaseClient.errors.js

@@ -199,6 +199,14 @@ export const RETRYABLE_DATABASE_CODES = new Set([
     "40001", // PostgreSQL: serialization_failure
     "40P01", // PostgreSQL: deadlock_detected
 ]);
+/**
+ * The mapping {@link normalizeDatabaseError} applies to a Prisma error
+ * code, or `undefined` for a code it does not know. Shared with the
+ * repository mapper so both classify the same code the same way.
+ */
+export function getPrismaCodeMapping(code) {
+    return PRISMA_CODE_MAP[code];
+}
 /**
  * Detects a Prisma error structurally.
  */
@@ -435,4 +443,3 @@ export function toDatabaseErrorInfo(error, options = {}) {
         metadata,
     };
 }
-//# sourceMappingURL=databaseClient.errors.js.map

package/dist/databaseClient/databaseClient.logger.d.ts

@@ -17,4 +17,3 @@ export declare const DEFAULT_DATABASE_LOGGER_NAME = "@zudojs/database";
 export declare function createDatabaseLoggerAdapter(logger: Logger): DatabaseLogger;
 /** Creates the fallback database logger, backed by `@zudojs/logger`. */
 export declare function createDefaultLogger(): DatabaseLogger;
-//# sourceMappingURL=databaseClient.logger.d.ts.map

package/dist/databaseClient/databaseClient.logger.js

@@ -52,4 +52,3 @@ export function createDefaultLogger() {
         level: LoggerLevel.DEBUG,
     }));
 }
-//# sourceMappingURL=databaseClient.logger.js.map

package/dist/databaseClient/databaseClient.type.d.ts

@@ -50,4 +50,3 @@ export type DatabaseTransactionContext = {
 export type TransactionClientOf<TClient> = TClient extends {
     $transaction(callback: (transaction: infer TTransaction) => never, ...rest: never[]): unknown;
 } ? [TTransaction] extends [never] ? DatabaseTransactionContext : [TTransaction] extends [DatabaseTransactionContext] ? TTransaction : DatabaseTransactionContext : DatabaseTransactionContext;
-//# sourceMappingURL=databaseClient.type.d.ts.map

package/dist/databaseClient/databaseClient.type.js

@@ -9,4 +9,3 @@
  * default).
  */
 export {};
-//# sourceMappingURL=databaseClient.type.js.map

package/dist/databaseClient/index.d.ts

@@ -4,5 +4,4 @@
  * Prisma-backed database client and connection infrastructure.
  */
 export { DatabaseClient, DatabaseAbortError, createDatabaseClient, buildPrismaTransactionOptions, createAbortError, raceAbort, throwIfAborted, SUPPORTED_ISOLATION_LEVELS, type DatabaseClientOptions, type DatabaseTransactionContext, type PrismaClientLike, type PrismaDriverAdapterLike, type PrismaQueryEvent, type PrismaTransactionOptions, type PrismaSqlLike, type RawQueryOptions, type TransactionClientOf, } from "./databaseClient.core.js";
-export { normalizeDatabaseError, withDatabaseErrorMetadata, isPrismaError, isRetryableTransactionError, isConflictError, isNotFoundError, getDatabaseErrorCode, getDatabaseErrorKind, isDatabaseErrorLike, isNonDatabaseBaseError, toDatabaseErrorInfo, RETRYABLE_DATABASE_CODES, type DatabaseErrorKind, type NormalizeDatabaseErrorOptions, type PrismaErrorLike, } from "./databaseClient.errors.js";
-//# sourceMappingURL=index.d.ts.map
+export { normalizeDatabaseError, withDatabaseErrorMetadata, isPrismaError, isRetryableTransactionError, isConflictError, isNotFoundError, getDatabaseErrorCode, getDatabaseErrorKind, getPrismaCodeMapping, isDatabaseErrorLike, isNonDatabaseBaseError, toDatabaseErrorInfo, RETRYABLE_DATABASE_CODES, type DatabaseErrorKind, type NormalizeDatabaseErrorOptions, type PrismaCodeMapping, type PrismaErrorLike, } from "./databaseClient.errors.js";

package/dist/databaseClient/index.js

@@ -4,5 +4,4 @@
  * Prisma-backed database client and connection infrastructure.
  */
 export { DatabaseClient, DatabaseAbortError, createDatabaseClient, buildPrismaTransactionOptions, createAbortError, raceAbort, throwIfAborted, SUPPORTED_ISOLATION_LEVELS, } from "./databaseClient.core.js";
-export { normalizeDatabaseError, withDatabaseErrorMetadata, isPrismaError, isRetryableTransactionError, isConflictError, isNotFoundError, getDatabaseErrorCode, getDatabaseErrorKind, isDatabaseErrorLike, isNonDatabaseBaseError, toDatabaseErrorInfo, RETRYABLE_DATABASE_CODES, } from "./databaseClient.errors.js";
-//# sourceMappingURL=index.js.map
+export { normalizeDatabaseError, withDatabaseErrorMetadata, isPrismaError, isRetryableTransactionError, isConflictError, isNotFoundError, getDatabaseErrorCode, getDatabaseErrorKind, getPrismaCodeMapping, isDatabaseErrorLike, isNonDatabaseBaseError, toDatabaseErrorInfo, RETRYABLE_DATABASE_CODES, } from "./databaseClient.errors.js";

package/dist/databaseConnection/databaseConnection.manager.d.ts

@@ -165,4 +165,3 @@ export declare class DatabaseConnectionManager {
  * Creates a database connection manager.
  */
 export declare function createConnectionManager(options?: DatabaseConnectionManagerOptions): DatabaseConnectionManager;
-//# sourceMappingURL=databaseConnection.manager.d.ts.map

package/dist/databaseConnection/databaseConnection.manager.js

@@ -312,4 +312,3 @@ function sleep(milliseconds, signal) {
 export function createConnectionManager(options = {}) {
     return new DatabaseConnectionManager(options);
 }
-//# sourceMappingURL=databaseConnection.manager.js.map

package/dist/databaseConnection/index.d.ts

@@ -4,4 +4,3 @@
  * Connection lifecycle management with health checks.
  */
 export { DatabaseConnectionManager, createConnectionManager, type DatabaseConnectionEvent, type DatabaseConnectionListener, type DatabaseConnectionEventDetails, type DatabaseConnectionManagerOptions, type DatabaseReconnectOptions, } from "./databaseConnection.manager.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/databaseConnection/index.js

@@ -4,4 +4,3 @@
  * Connection lifecycle management with health checks.
  */
 export { DatabaseConnectionManager, createConnectionManager, } from "./databaseConnection.manager.js";
-//# sourceMappingURL=index.js.map

package/dist/databaseType/databaseType.type.d.ts

@@ -174,15 +174,17 @@ export interface DatabaseEntity<TId = string> {
     readonly updatedAt: Date;
 }
 /**
- * Soft-deletable entity contract.
+ * Soft-deletable entity contract. `TId` is the primary key type (default
+ * `string`), as on {@link DatabaseEntity}.
  */
-export interface SoftDeletableEntity extends DatabaseEntity {
+export interface SoftDeletableEntity<TId = string> extends DatabaseEntity<TId> {
     readonly deletedAt: Date | null;
 }
 /**
- * Auditable entity contract.
+ * Auditable entity contract. `TId` is the primary key type (default
+ * `string`), as on {@link DatabaseEntity}.
  */
-export interface AuditableEntity extends DatabaseEntity {
+export interface AuditableEntity<TId = string> extends DatabaseEntity<TId> {
     readonly createdBy?: string;
     readonly updatedBy?: string;
 }
@@ -221,4 +223,3 @@ export interface DatabaseLogger {
  * Default no-op database logger.
  */
 export declare const noopDatabaseLogger: DatabaseLogger;
-//# sourceMappingURL=databaseType.type.d.ts.map

package/dist/databaseType/databaseType.type.js

@@ -7,4 +7,3 @@ export const noopDatabaseLogger = Object.freeze({
     warn: () => undefined,
     error: () => undefined,
 });
-//# sourceMappingURL=databaseType.type.js.map

package/dist/databaseType/index.d.ts

@@ -4,4 +4,3 @@
  * Core type definitions for the database package.
  */
 export * from "./databaseType.type.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/databaseType/index.js

@@ -4,4 +4,3 @@
  * Core type definitions for the database package.
  */
 export * from "./databaseType.type.js";
-//# sourceMappingURL=index.js.map

package/dist/health/health.check.d.ts

@@ -71,4 +71,3 @@ export declare function assertDatabaseHealth(client: DatabaseClient, options?: D
  * Checks whether a database is reachable.
  */
 export declare function isDatabaseHealthy(client: DatabaseClient, options?: DatabaseHealthOptions): Promise<boolean>;
-//# sourceMappingURL=health.check.d.ts.map

package/dist/health/health.check.js

@@ -187,4 +187,3 @@ function normalizeHealthError(error) {
             : {}),
     };
 }
-//# sourceMappingURL=health.check.js.map

package/dist/health/index.d.ts

@@ -4,4 +4,3 @@
  * Database health and readiness monitoring.
  */
 export { checkDatabaseHealth, checkDatabaseReadiness, assertDatabaseHealth, isDatabaseHealthy, getHealthCheckCause, DatabaseUnhealthyError, DEFAULT_HEALTH_TIMEOUT_MS, type DatabaseHealthStatus, type DatabaseHealth, type DatabaseHealthOptions, type DatabaseReadiness, } from "./health.check.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/health/index.js

@@ -4,4 +4,3 @@
  * Database health and readiness monitoring.
  */
 export { checkDatabaseHealth, checkDatabaseReadiness, assertDatabaseHealth, isDatabaseHealthy, getHealthCheckCause, DatabaseUnhealthyError, DEFAULT_HEALTH_TIMEOUT_MS, } from "./health.check.js";
-//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -18,19 +18,18 @@
  */
 export type { DatabaseOperationOptions, DatabaseStatus, TransactionIsolationLevel, DatabaseOperation, DatabaseConnectionOptions, DatabaseClientHealth, DatabaseHealth as DatabaseHealthInfo, TransactionOptions, TransactionCallback, Repository, SoftDeletableRepository, PaginationInput, PaginationMeta, PaginatedResult, SortDirection, SortInput, QueryOptions, DatabaseEntity, SoftDeletableEntity, AuditableEntity, DatabaseErrorInfo, DatabaseLogger, } from "./databaseType/index.js";
 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 PrismaSqlLike, type RawQueryOptions, type TransactionClientOf, type DatabaseErrorKind, type NormalizeDatabaseErrorOptions, type PrismaErrorLike, } from "./databaseClient/index.js";
+export { DatabaseClient, DatabaseAbortError, createDatabaseClient, buildPrismaTransactionOptions, createAbortError, raceAbort, throwIfAborted, SUPPORTED_ISOLATION_LEVELS, normalizeDatabaseError, withDatabaseErrorMetadata, isPrismaError, isRetryableTransactionError, isConflictError, isNotFoundError, getPrismaCodeMapping, getDatabaseErrorCode, getDatabaseErrorKind, isDatabaseErrorLike, isNonDatabaseBaseError, toDatabaseErrorInfo, RETRYABLE_DATABASE_CODES, type DatabaseClientOptions, type DatabaseTransactionContext, type PrismaClientLike, type PrismaDriverAdapterLike, type PrismaQueryEvent, type PrismaTransactionOptions, type PrismaSqlLike, type RawQueryOptions, type TransactionClientOf, type DatabaseErrorKind, type NormalizeDatabaseErrorOptions, type PrismaErrorLike, type PrismaCodeMapping, } 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 RepositoryDelegateOperations, 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 CreateCursorOptions, 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";
 export { equals, notEquals, inList, notInList, lessThan, lessThanOrEqual, greaterThan, greaterThanOrEqual, contains, startsWith, endsWith, isNull, isNotNull, and, or, not, condition, allOf, anyOf, fromObject, dateRange, oneOf, noneOf, optionalEquals, optionalContains, hasConditions, flattenAnd, cloneFilter, between, matchesPattern, isEmpty, isNotEmpty, dateOnly, isBefore, isAfter, isBetween, notCondition, relational, } from "./queryBuilder/index.js";
-export { normalizePagination, normalizePage, normalizeLimit, calculateOffset, calculateTotalPages, createPaginationMeta, createPaginatedResult, getNextPage, getPreviousPage, isValidPage, getItemRange, paginateCollection, encodeCursor, decodeCursor, validateCursorPayload, decodeKeysetCursor, buildKeysetWhere, createKeysetCursor, createKeysetPage, KEYSET_BACKWARD_KEY, getKeysetDirection, reverseKeysetSort, keysetFetchSort, createInvalidCursorError, normalizeCursorPagination, createCursorPaginationMeta, createCursorPaginatedResult, DEFAULT_PAGE, DEFAULT_LIMIT, MAX_LIMIT, type NormalizedPagination, type CursorPaginationInput, type CursorPaginationMeta, type CursorPaginatedResult, type CursorPayload, type EncodeCursorOptions, type DecodeCursorOptions, type KeysetPageOptions, type KeysetWhere, type KeysetDirection, type InvalidCursorReason, } from "./pagination/index.js";
+export { normalizePagination, normalizePage, normalizeLimit, calculateOffset, calculateTotalPages, createPaginationMeta, createPaginatedResult, getNextPage, getPreviousPage, isValidPage, getItemRange, paginateCollection, encodeCursor, decodeCursor, validateCursorPayload, decodeKeysetCursor, buildKeysetWhere, createKeysetCursor, createKeysetPage, KEYSET_BACKWARD_KEY, getKeysetDirection, reverseKeysetSort, keysetFetchSort, createInvalidCursorError, isDateCursorValue, keysetStrictFilter, keysetTieFilter, nextMillisecond, normalizeCursorPagination, createCursorPaginationMeta, createCursorPaginatedResult, DEFAULT_PAGE, DEFAULT_LIMIT, MAX_LIMIT, type NormalizedPagination, type CursorPaginationInput, type CursorPaginationMeta, type CursorPaginatedResult, type CursorPayload, type EncodeCursorOptions, type DecodeCursorOptions, type KeysetPageOptions, type KeysetWhere, type KeysetDirection, type InvalidCursorReason, } from "./pagination/index.js";
 export { oneToOne, oneToMany, manyToOne, manyToMany, includeRelation, includeRelations, RelationRegistry, createRelationRegistry, validateRelation, validateInclude, toPrismaInclude, DEFAULT_INCLUDE_DEPTH, isRelationType, isCollectionRelation, isSingleRelation, type RelationDefinition, type RelationType, type RelationLoadOptions, type RelationInclude, type ToPrismaIncludeOptions, } from "./relations/index.js";
 export { DatabaseLockManager, createLockManager, acquireAdvisoryLock, lockRow, buildLockClause, normalizeAdvisoryKey, normalizeAdvisoryKeyPair, resolveLockTransactionOptions, type DatabaseLockMode, type DatabaseLockOptions, type DatabaseLockResult, } from "./locks/index.js";
 export { MemoryDatabaseCache, createDatabaseCache, createCacheKey, escapeCachePart, serializeCachePart, getOrSet, invalidateByPrefix, CACHE_KEY_SEPARATOR, type CacheEntry, type CacheOptions, type MemoryCacheOptions, type CacheStats, type DatabaseCache, } from "./cache/index.js";
 export { MigrationRunner, createMigrationRunner, normalizeMigrations, validateMigration, getLatestVersion, getCurrentVersion, DEFAULT_MIGRATION_TABLE, DEFAULT_MIGRATION_LOCK, SQL_IDENTIFIER_PATTERN, validateIdentifier, validateLockKey, quoteIdentifier, hashLockKey, fnv1a64, getSqlDialect, isSqlDialectName, UnsupportedDialectError, DEFAULT_SQL_DIALECT, type Migration, type MigrationRecord, type MigrationResult, type MigrationStatus, type MigrationRunnerOptions, type RunnerTransactionOptions, type SqlDialect, type SqlDialectName, } from "./migration/index.js";
 export { SeedRunner, createSeedRunner, normalizeSeeds, validateSeed, DEFAULT_SEED_TABLE, DEFAULT_SEED_LOCK, type Seed, type SeedRecord, type SeedResult, type SeedStatus, type SeedRunnerOptions, } from "./seed/index.js";
 export { checkDatabaseHealth, checkDatabaseReadiness, assertDatabaseHealth, isDatabaseHealthy, getHealthCheckCause, DatabaseUnhealthyError, DEFAULT_HEALTH_TIMEOUT_MS, type DatabaseHealthStatus, type DatabaseHealth, type DatabaseHealthOptions, type DatabaseReadiness, } from "./health/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -18,7 +18,7 @@
  */
 export { noopDatabaseLogger } from "./databaseType/index.js";
 // Client
-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, } from "./databaseClient/index.js";
+export { DatabaseClient, DatabaseAbortError, createDatabaseClient, buildPrismaTransactionOptions, createAbortError, raceAbort, throwIfAborted, SUPPORTED_ISOLATION_LEVELS, normalizeDatabaseError, withDatabaseErrorMetadata, isPrismaError, isRetryableTransactionError, isConflictError, isNotFoundError, getPrismaCodeMapping, getDatabaseErrorCode, getDatabaseErrorKind, isDatabaseErrorLike, isNonDatabaseBaseError, toDatabaseErrorInfo, RETRYABLE_DATABASE_CODES, } from "./databaseClient/index.js";
 // Connection
 export { DatabaseConnectionManager, createConnectionManager, } from "./databaseConnection/index.js";
 // Database facade
@@ -33,7 +33,7 @@ export { DatabaseUnitOfWork, createUnitOfWork, executeUnitOfWork, } from "./unit
 export { QueryBuilder, createQueryBuilder, toPrismaWhere, toPrismaArgs, toPrismaOrderBy, toPrismaSelect, toPrismaSkipTake, } from "./queryBuilder/index.js";
 export { equals, notEquals, inList, notInList, lessThan, lessThanOrEqual, greaterThan, greaterThanOrEqual, contains, startsWith, endsWith, isNull, isNotNull, and, or, not, condition, allOf, anyOf, fromObject, dateRange, oneOf, noneOf, optionalEquals, optionalContains, hasConditions, flattenAnd, cloneFilter, between, matchesPattern, isEmpty, isNotEmpty, dateOnly, isBefore, isAfter, isBetween, notCondition, relational, } from "./queryBuilder/index.js";
 // Pagination
-export { normalizePagination, normalizePage, normalizeLimit, calculateOffset, calculateTotalPages, createPaginationMeta, createPaginatedResult, getNextPage, getPreviousPage, isValidPage, getItemRange, paginateCollection, encodeCursor, decodeCursor, validateCursorPayload, decodeKeysetCursor, buildKeysetWhere, createKeysetCursor, createKeysetPage, KEYSET_BACKWARD_KEY, getKeysetDirection, reverseKeysetSort, keysetFetchSort, createInvalidCursorError, normalizeCursorPagination, createCursorPaginationMeta, createCursorPaginatedResult, DEFAULT_PAGE, DEFAULT_LIMIT, MAX_LIMIT, } from "./pagination/index.js";
+export { normalizePagination, normalizePage, normalizeLimit, calculateOffset, calculateTotalPages, createPaginationMeta, createPaginatedResult, getNextPage, getPreviousPage, isValidPage, getItemRange, paginateCollection, encodeCursor, decodeCursor, validateCursorPayload, decodeKeysetCursor, buildKeysetWhere, createKeysetCursor, createKeysetPage, KEYSET_BACKWARD_KEY, getKeysetDirection, reverseKeysetSort, keysetFetchSort, createInvalidCursorError, isDateCursorValue, keysetStrictFilter, keysetTieFilter, nextMillisecond, normalizeCursorPagination, createCursorPaginationMeta, createCursorPaginatedResult, DEFAULT_PAGE, DEFAULT_LIMIT, MAX_LIMIT, } from "./pagination/index.js";
 // Relations
 export { oneToOne, oneToMany, manyToOne, manyToMany, includeRelation, includeRelations, RelationRegistry, createRelationRegistry, validateRelation, validateInclude, toPrismaInclude, DEFAULT_INCLUDE_DEPTH, isRelationType, isCollectionRelation, isSingleRelation, } from "./relations/index.js";
 // Locks
@@ -46,4 +46,3 @@ export { MigrationRunner, createMigrationRunner, normalizeMigrations, validateMi
 export { SeedRunner, createSeedRunner, normalizeSeeds, validateSeed, DEFAULT_SEED_TABLE, DEFAULT_SEED_LOCK, } from "./seed/index.js";
 // Health
 export { checkDatabaseHealth, checkDatabaseReadiness, assertDatabaseHealth, isDatabaseHealthy, getHealthCheckCause, DatabaseUnhealthyError, DEFAULT_HEALTH_TIMEOUT_MS, } from "./health/index.js";
-//# sourceMappingURL=index.js.map

package/dist/locks/index.d.ts

@@ -4,4 +4,3 @@
  * Advisory and row-level database locking (PostgreSQL).
  */
 export { DatabaseLockManager, createLockManager, acquireAdvisoryLock, lockRow, buildLockClause, normalizeAdvisoryKey, normalizeAdvisoryKeyPair, resolveLockTransactionOptions, type DatabaseLockMode, type DatabaseLockOptions, type DatabaseLockResult, } from "./locks.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/locks/index.js

@@ -4,4 +4,3 @@
  * Advisory and row-level database locking (PostgreSQL).
  */
 export { DatabaseLockManager, createLockManager, acquireAdvisoryLock, lockRow, buildLockClause, normalizeAdvisoryKey, normalizeAdvisoryKeyPair, resolveLockTransactionOptions, } from "./locks.core.js";
-//# sourceMappingURL=index.js.map

package/dist/locks/locks.core.d.ts

@@ -131,4 +131,3 @@ export declare function normalizeAdvisoryKeyPair(namespace: string, lockKey: str
  * than `timeoutMs`.
  */
 export declare function resolveLockTransactionOptions(options?: DatabaseLockOptions): TransactionOptions | undefined;
-//# sourceMappingURL=locks.core.d.ts.map

package/dist/locks/locks.core.js

@@ -268,4 +268,3 @@ function validateId(id) {
         throw new TypeError("A database identifier must be a string or number.");
     }
 }
-//# sourceMappingURL=locks.core.js.map

package/dist/migration/index.d.ts

@@ -6,4 +6,3 @@
 export { MigrationRunner, createMigrationRunner, normalizeMigrations, validateMigration, getLatestVersion, getCurrentVersion, DEFAULT_MIGRATION_TABLE, DEFAULT_MIGRATION_LOCK, type Migration, type MigrationRecord, type MigrationResult, type MigrationStatus, type MigrationRunnerOptions, type RunnerTransactionOptions, } from "./migration.runner.js";
 export { SQL_IDENTIFIER_PATTERN, validateIdentifier, validateLockKey, quoteIdentifier, hashLockKey, fnv1a64, FNV1A_64_OFFSET_BASIS, FNV1A_64_PRIME, } from "./migration.helpers.js";
 export { getSqlDialect, isSqlDialectName, UnsupportedDialectError, DEFAULT_SQL_DIALECT, type SqlDialect, type SqlDialectName, } from "./migration.dialect.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/migration/index.js

@@ -6,4 +6,3 @@
 export { MigrationRunner, createMigrationRunner, normalizeMigrations, validateMigration, getLatestVersion, getCurrentVersion, DEFAULT_MIGRATION_TABLE, DEFAULT_MIGRATION_LOCK, } from "./migration.runner.js";
 export { SQL_IDENTIFIER_PATTERN, validateIdentifier, validateLockKey, quoteIdentifier, hashLockKey, fnv1a64, FNV1A_64_OFFSET_BASIS, FNV1A_64_PRIME, } from "./migration.helpers.js";
 export { getSqlDialect, isSqlDialectName, UnsupportedDialectError, DEFAULT_SQL_DIALECT, } from "./migration.dialect.js";
-//# sourceMappingURL=index.js.map

package/dist/migration/migration.dialect.d.ts

@@ -62,4 +62,3 @@ export declare function isSqlDialectName(value: unknown): value is SqlDialectNam
  * @throws {TypeError} for unknown dialect names.
  */
 export declare function getSqlDialect(name?: SqlDialectName): SqlDialect;
-//# sourceMappingURL=migration.dialect.d.ts.map

package/dist/migration/migration.dialect.js

@@ -60,4 +60,3 @@ export function getSqlDialect(name = DEFAULT_SQL_DIALECT) {
     }
     throw new TypeError(`Unknown SQL dialect: "${String(name)}".`);
 }
-//# sourceMappingURL=migration.dialect.js.map

package/dist/migration/migration.helpers.d.ts

@@ -63,4 +63,3 @@ export declare function fnv1a64(value: string): bigint;
  * Suitable as the single `bigint` argument of `pg_advisory_xact_lock`.
  */
 export declare function hashLockKey(value: string): bigint;
-//# sourceMappingURL=migration.helpers.d.ts.map

package/dist/migration/migration.helpers.js

@@ -58,6 +58,10 @@ export function validateMigration(migration) {
     if (migration.down !== undefined && typeof migration.down !== "function") {
         throw new TypeError(`Migration "${migration.name}" has an invalid down function.`);
     }
+    if (migration.transaction !== undefined &&
+        typeof migration.transaction !== "boolean") {
+        throw new TypeError(`Migration "${migration.name}" has an invalid transaction flag.`);
+    }
 }
 /**
  * Returns the highest registered migration version.
@@ -138,4 +142,3 @@ export function fnv1a64(value) {
 export function hashLockKey(value) {
     return BigInt.asIntN(64, fnv1a64(value));
 }
-//# sourceMappingURL=migration.helpers.js.map

package/dist/migration/migration.runner.d.ts

@@ -26,6 +26,14 @@ export declare class MigrationRunner<TTransaction extends DatabaseTransactionCon
      * Applies every pending migration in version order.
      */
     migrate(): Promise<MigrationResult>;
+    /**
+     * Applies a `transaction: false` migration: the applied check and the
+     * history record run in short transactions under the advisory lock, the
+     * body runs on the root client outside any transaction.
+     */
+    private applyDetached;
+    /** The root Prisma client, handed to migrations that opt out of a transaction. */
+    private rootClient;
     /**
      * Alias of {@link migrate}.
      */
@@ -58,7 +66,11 @@ export declare class MigrationRunner<TTransaction extends DatabaseTransactionCon
      */
     getHistory(): Promise<readonly MigrationRecord[]>;
     private rollbackSteps;
+    /** Reverts a `transaction: false` migration; see {@link applyDetached}. */
+    private revertDetached;
     private revertRecord;
+    private requireRollback;
+    private runDown;
     private computePending;
     private buildTransactionOptions;
     private executor;
@@ -72,4 +84,3 @@ export declare class MigrationRunner<TTransaction extends DatabaseTransactionCon
  * Creates a migration runner.
  */
 export declare function createMigrationRunner<TTransaction extends DatabaseTransactionContext = DatabaseTransactionContext>(client: DatabaseClient<TTransaction>, migrations: readonly Migration<TTransaction>[], options?: MigrationRunnerOptions): MigrationRunner<TTransaction>;
-//# sourceMappingURL=migration.runner.d.ts.map