@veloxts/orm 0.7.5 → 0.7.7

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @veloxts/orm
 
+## 0.7.7
+
+### Patch Changes
+
+- refactor(router): rename swaggerUIPlugin → swaggerPlugin, remove redundant exports
+- Updated dependencies
+  - @veloxts/core@0.7.7
+
+## 0.7.6
+
+### Patch Changes
+
+- feat(router): custom access levels for the Resource API + advanced Architectural Patterns
+- Updated dependencies
+  - @veloxts/core@0.7.6
+
 ## 0.7.5
 
 ### Patch Changes

package/dist/index.d.ts

@@ -38,4 +38,5 @@ export type { ConnectionState, ConnectionStatus, DatabaseClient, DatabaseWrapper
 export { isDatabaseClient } from './types.js';
 export type { Database } from './client.js';
 export { createDatabase } from './client.js';
+export { db, handlePrismaError } from './prisma-errors.js';
 export { databasePlugin } from './plugin.js';

package/dist/index.js

@@ -44,6 +44,10 @@ export const ORM_VERSION = packageJson.version ?? '0.0.0-unknown';
 export { isDatabaseClient } from './types.js';
 export { createDatabase } from './client.js';
 // ============================================================================
+// Prisma Error Handling
+// ============================================================================
+export { db, handlePrismaError } from './prisma-errors.js';
+// ============================================================================
 // Plugin
 // ============================================================================
 export { databasePlugin } from './plugin.js';

package/dist/prisma-errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Prisma Error Wrapper
+ *
+ * Converts Prisma-specific errors to VeloxTS error classes,
+ * providing consistent, domain-specific error messages.
+ *
+ * @module prisma-errors
+ */
+/**
+ * Convert a Prisma error to a VeloxTS error.
+ *
+ * Handles:
+ * - P2002 (Unique constraint) → ConflictError
+ * - P2001 / P2018 / P2025 (Record not found) → NotFoundError
+ * - P2003 (Foreign key constraint) → ValidationError
+ *
+ * Throws the original error if it is not a known Prisma error code.
+ *
+ * @param error - The caught error
+ * @throws A VeloxTS error or the original error if not a Prisma error
+ */
+export declare function handlePrismaError(error: unknown): never;
+/**
+ * Wraps a Prisma operation, converting known errors to VeloxTS errors.
+ *
+ * @param operation - An async function performing a Prisma query
+ * @returns The result of the operation
+ * @throws ConflictError, NotFoundError, ValidationError, or the original error
+ *
+ * @example
+ * ```typescript
+ * import { db } from '@veloxts/orm';
+ *
+ * // Instead of manual try/catch for P2002, P2025, etc.:
+ * const user = await db(() => prisma.user.create({ data: input }));
+ * // P2002 → ConflictError("A record with this email already exists", ["email"])
+ * // P2025 → NotFoundError("User")
+ * ```
+ */
+export declare function db<T>(operation: () => Promise<T>): Promise<T>;

package/dist/prisma-errors.js

@@ -0,0 +1,79 @@
+/**
+ * Prisma Error Wrapper
+ *
+ * Converts Prisma-specific errors to VeloxTS error classes,
+ * providing consistent, domain-specific error messages.
+ *
+ * @module prisma-errors
+ */
+import { ConflictError, NotFoundError, ValidationError } from '@veloxts/core';
+function isPrismaKnownRequestError(error) {
+    return (error instanceof Error &&
+        error.name === 'PrismaClientKnownRequestError' &&
+        'code' in error &&
+        typeof error.code === 'string');
+}
+/**
+ * Convert a Prisma error to a VeloxTS error.
+ *
+ * Handles:
+ * - P2002 (Unique constraint) → ConflictError
+ * - P2001 / P2018 / P2025 (Record not found) → NotFoundError
+ * - P2003 (Foreign key constraint) → ValidationError
+ *
+ * Throws the original error if it is not a known Prisma error code.
+ *
+ * @param error - The caught error
+ * @throws A VeloxTS error or the original error if not a Prisma error
+ */
+export function handlePrismaError(error) {
+    if (!isPrismaKnownRequestError(error)) {
+        throw error;
+    }
+    switch (error.code) {
+        case 'P2002': {
+            const fields = error.meta?.target ?? [];
+            const fieldNames = fields.length > 0 ? fields.join(', ') : 'field';
+            throw new ConflictError(`A record with this ${fieldNames} already exists`, fields.length > 0 ? fields : undefined);
+        }
+        case 'P2001':
+        case 'P2018':
+        case 'P2025': {
+            const model = error.meta?.modelName ?? error.meta?.cause ?? 'Record';
+            throw new NotFoundError(model);
+        }
+        case 'P2003': {
+            const field = error.meta?.field_name ?? 'field';
+            throw new ValidationError(`Related record not found for ${field}`, {
+                [field]: 'Related record not found',
+            });
+        }
+        default:
+            throw error;
+    }
+}
+/**
+ * Wraps a Prisma operation, converting known errors to VeloxTS errors.
+ *
+ * @param operation - An async function performing a Prisma query
+ * @returns The result of the operation
+ * @throws ConflictError, NotFoundError, ValidationError, or the original error
+ *
+ * @example
+ * ```typescript
+ * import { db } from '@veloxts/orm';
+ *
+ * // Instead of manual try/catch for P2002, P2025, etc.:
+ * const user = await db(() => prisma.user.create({ data: input }));
+ * // P2002 → ConflictError("A record with this email already exists", ["email"])
+ * // P2025 → NotFoundError("User")
+ * ```
+ */
+export async function db(operation) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        return handlePrismaError(error);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/orm",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "description": "Prisma wrapper with enhanced DX for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -19,7 +19,7 @@
     "fastify": "5.7.4",
     "pg": "8.18.0",
     "pg-format": "1.0.4",
-    "@veloxts/core": "0.7.5"
+    "@veloxts/core": "0.7.7"
   },
   "devDependencies": {
     "@types/pg": "8.16.0",