@zudojs/database 1.4.0 → 1.5.0

package/dist/repository/repository.errors.js

@@ -1,5 +1,5 @@
 import { DatabaseError, DatabaseOperation, ErrorCode, } from "@zudojs/errors";
-import { isDatabaseErrorLike } from "../databaseClient/databaseClient.errors.js";
+import { getPrismaCodeMapping, isDatabaseErrorLike, } from "../databaseClient/databaseClient.errors.js";
 const PRISMA_CODE_PATTERN = /^P\d{4}$/;
 /**
  * Determines whether a value looks like a Prisma known request error.
@@ -53,6 +53,9 @@ export function toDatabaseOperation(operation) {
  * - `P2034` serialization failure → `ERR_DATABASE_TRANSACTION` / 409 (retryable)
  * - `P2024` pool timeout → `ERR_DATABASE_TIMEOUT` / 503
  * - `P1xxx` connection failures → `ERR_DATABASE_CONNECTION` / 503
+ * - every other code `normalizeDatabaseError` knows (`P2000` value too
+ *   long / 400, `P2004` constraint / 409, `P2011` null / 400, `P2014`,
+ *   `P2015`, `P2018`, `P2028`) → the same status, code and exposure
  *
  * Existing `DatabaseError`s are returned unchanged.
  */
@@ -139,6 +142,16 @@ export function mapRepositoryError(error, context) {
             statusCode: 503,
         });
     }
+    const mapping = getPrismaCodeMapping(error.code);
+    if (mapping !== undefined) {
+        return new DatabaseError(`${context.model} ${context.operation} failed: ${lowerFirst(mapping.message)}`, {
+            ...options,
+            code: mapping.code,
+            statusCode: mapping.statusCode,
+            expose: mapping.expose,
+            metadata: { ...metadata, kind: mapping.kind },
+        });
+    }
     return new DatabaseError(`${context.model} ${context.operation} failed.`, {
         ...options,
         code: ErrorCode.DATABASE_QUERY,
@@ -222,6 +235,9 @@ function toMetadataValue(value) {
     }
     return String(value);
 }
+function lowerFirst(value) {
+    return value.length === 0 ? value : value[0].toLowerCase() + value.slice(1);
+}
 function extractTarget(meta) {
     const target = meta?.["target"];
     if (typeof target === "string") {
@@ -232,4 +248,3 @@ function extractTarget(meta) {
     }
     return undefined;
 }
-//# sourceMappingURL=repository.errors.js.map

package/dist/seed/index.d.ts

@@ -4,4 +4,3 @@
  * Database seed runner with execution tracking (PostgreSQL).
  */
 export { SeedRunner, createSeedRunner, normalizeSeeds, validateSeed, DEFAULT_SEED_TABLE, DEFAULT_SEED_LOCK, type Seed, type SeedRecord, type SeedResult, type SeedStatus, type SeedRunnerOptions, } from "./seed.runner.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/seed/index.js

@@ -4,4 +4,3 @@
  * Database seed runner with execution tracking (PostgreSQL).
  */
 export { SeedRunner, createSeedRunner, normalizeSeeds, validateSeed, DEFAULT_SEED_TABLE, DEFAULT_SEED_LOCK, } from "./seed.runner.js";
-//# sourceMappingURL=index.js.map

package/dist/seed/seed.runner.d.ts

@@ -160,4 +160,3 @@ export declare function normalizeSeeds<TTransaction extends DatabaseTransactionC
  * Validates one seed definition.
  */
 export declare function validateSeed<TTransaction extends DatabaseTransactionContext = DatabaseTransactionContext>(seed: Seed<TTransaction>): void;
-//# sourceMappingURL=seed.runner.d.ts.map

package/dist/seed/seed.runner.js

@@ -368,4 +368,3 @@ function validateSeedName(name) {
         throw new TypeError("Seed name cannot exceed 255 characters.");
     }
 }
-//# sourceMappingURL=seed.runner.js.map

package/dist/transaction/index.d.ts

@@ -4,4 +4,3 @@
  * Managed transaction execution with retry support.
  */
 export { TransactionManager, createTransactionManager, withTransaction, withTransactionRetry, createTransactionContext, createTransactionId, getTransactionContextFromError, isTransactionActive, isTransactionCommitted, isTransactionFailed, type TransactionStatus, type TransactionContext, type TransactionOutcome, type TransactionRetryOptions, type ManagedTransactionOptions, } from "./transaction.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/transaction/index.js

@@ -4,4 +4,3 @@
  * Managed transaction execution with retry support.
  */
 export { TransactionManager, createTransactionManager, withTransaction, withTransactionRetry, createTransactionContext, createTransactionId, getTransactionContextFromError, isTransactionActive, isTransactionCommitted, isTransactionFailed, } from "./transaction.core.js";
-//# sourceMappingURL=index.js.map

package/dist/transaction/transaction.backoff.d.ts

@@ -30,4 +30,3 @@ export interface RetryDelayOptions {
  * @returns A finite delay in `[0, min(maxRetryDelayMs, 2^31-1)]`.
  */
 export declare function computeRetryDelay(attempt: number, options: RetryDelayOptions): number;
-//# sourceMappingURL=transaction.backoff.d.ts.map

package/dist/transaction/transaction.backoff.js

@@ -29,4 +29,3 @@ export function computeRetryDelay(attempt, options) {
     const random = options.random ?? Math.random;
     return Math.floor(random() * (capped + 1));
 }
-//# sourceMappingURL=transaction.backoff.js.map

package/dist/transaction/transaction.core.d.ts

@@ -5,7 +5,14 @@ import type { TransactionIsolationLevel, TransactionOptions } from "../databaseT
  */
 export type TransactionStatus = "idle" | "active" | "committed" | "rolled-back" | "failed";
 /**
- * Runtime transaction information.
+ * Runtime transaction information: the immutable status record
+ * `TransactionManager.run` reports in its `TransactionOutcome` and attaches
+ * to failures (see `getTransactionContextFromError`).
+ *
+ * Not the `TransactionContext` of `@zudojs/transactions`, which is the
+ * AsyncLocalStorage store its manager propagates transactions through.
+ * The two packages share the name but not the concept; import from the
+ * package whose manager you use.
  */
 export interface TransactionContext {
     readonly transactionId: string;
@@ -117,7 +124,14 @@ export declare function withTransaction<TResult, TTransaction extends DatabaseTr
  */
 export declare function withTransactionRetry<TResult, TTransaction extends DatabaseTransactionContext = DatabaseTransactionContext>(client: DatabaseClient<TTransaction>, callback: (transaction: TTransaction, context: TransactionContext) => Promise<TResult>, options?: TransactionRetryOptions): Promise<TResult>;
 /**
- * Creates an immutable transaction context.
+ * Creates an immutable transaction status record (see
+ * {@link TransactionContext}), as `TransactionManager.run` does for every
+ * transaction it opens.
+ *
+ * Unrelated to `createTransactionContext` from `@zudojs/transactions`,
+ * which creates the AsyncLocalStorage propagation store that package's
+ * manager runs callbacks in. This one holds no transaction and propagates
+ * nothing; it is data for logging and error reporting.
  */
 export declare function createTransactionContext(options?: ManagedTransactionOptions): TransactionContext;
 /**
@@ -137,4 +151,3 @@ export declare function isTransactionCommitted(context: TransactionContext): boo
  * Determines whether a transaction failed.
  */
 export declare function isTransactionFailed(context: TransactionContext): boolean;
-//# sourceMappingURL=transaction.core.d.ts.map

package/dist/transaction/transaction.core.js

@@ -123,7 +123,14 @@ export async function withTransactionRetry(client, callback, options = {}) {
     }
 }
 /**
- * Creates an immutable transaction context.
+ * Creates an immutable transaction status record (see
+ * {@link TransactionContext}), as `TransactionManager.run` does for every
+ * transaction it opens.
+ *
+ * Unrelated to `createTransactionContext` from `@zudojs/transactions`,
+ * which creates the AsyncLocalStorage propagation store that package's
+ * manager runs callbacks in. This one holds no transaction and propagates
+ * nothing; it is data for logging and error reporting.
  */
 export function createTransactionContext(options = {}) {
     return Object.freeze({
@@ -204,4 +211,3 @@ function sleep(milliseconds) {
         setTimeout(resolve, milliseconds);
     });
 }
-//# sourceMappingURL=transaction.core.js.map

package/dist/unitOfWork/index.d.ts

@@ -4,4 +4,3 @@
  * Groups multiple repository operations into a single transaction.
  */
 export { DatabaseUnitOfWork, createUnitOfWork, executeUnitOfWork, type UnitOfWork, type UnitOfWorkOptions, } from "./unitOfWork.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/unitOfWork/index.js

@@ -4,4 +4,3 @@
  * Groups multiple repository operations into a single transaction.
  */
 export { DatabaseUnitOfWork, createUnitOfWork, executeUnitOfWork, } from "./unitOfWork.core.js";
-//# sourceMappingURL=index.js.map

package/dist/unitOfWork/unitOfWork.core.d.ts

@@ -43,4 +43,3 @@ export declare function createUnitOfWork<TTransaction extends DatabaseTransactio
  * Executes a callback as a single database transaction.
  */
 export declare function executeUnitOfWork<TResult, TTransaction extends DatabaseTransactionContext = DatabaseTransactionContext>(client: DatabaseClient<TTransaction>, callback: TransactionCallback<TTransaction, TResult>, options?: TransactionOptions): Promise<TResult>;
-//# sourceMappingURL=unitOfWork.core.d.ts.map

package/dist/unitOfWork/unitOfWork.core.js

@@ -52,4 +52,3 @@ export function createUnitOfWork(client) {
 export async function executeUnitOfWork(client, callback, options) {
     return createUnitOfWork(client).execute(callback, options);
 }
-//# sourceMappingURL=unitOfWork.core.js.map

package/package.json

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