@prisma-next/sql-errors 0.13.0 → 0.14.0

package/dist/index.d.mts

@@ -26,6 +26,21 @@ declare class SqlQueryError extends Error implements SqlDriverError<'sql_query'>
    */
   static is(error: unknown): error is SqlQueryError;
 }
+/**
+ * SQLSTATE for a unique-constraint / primary-key violation — the SQL-standard
+ * `unique_violation` class. Drivers normalize their target-specific codes (e.g.
+ * Postgres `23505`, SQLite `SQLITE_CONSTRAINT_UNIQUE`/`PRIMARYKEY`) onto this
+ * value on {@link SqlQueryError.sqlState}, so consumers classify violations
+ * without knowing any target-specific error shape.
+ */
+declare const UNIQUE_VIOLATION_SQLSTATE = "23505";
+/**
+ * Whether an error is a unique-constraint (or primary-key) violation, decided
+ * solely from the driver-normalized {@link SqlQueryError.sqlState}. Raw driver
+ * errors that were never normalized are not classified — callers run behind the
+ * driver, which always normalizes before the error escapes.
+ */
+declare function isUniqueConstraintViolation(error: unknown): boolean;
 /**
  * SQL connection error (timeouts, connection resets, etc.).
  */
@@ -43,5 +58,5 @@ declare class SqlConnectionError extends Error implements SqlDriverError<'sql_co
   static is(error: unknown): error is SqlConnectionError;
 }
 //#endregion
-export { SqlConnectionError, SqlQueryError };
+export { SqlConnectionError, SqlQueryError, UNIQUE_VIOLATION_SQLSTATE, isUniqueConstraintViolation };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts"],"mappings":";UAAiB,cAAA;EAAA,SACN,IAAA,EAAM,IAAI;AAAA;;;;cAKR,aAAA,SAAsB,KAAA,YAAiB,cAAA;EAAA,gBAClC,UAAA;EAAA,SACP,IAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;EAAA,SACA,KAAA;EAAA,SACA,MAAA;EAAA,SACA,MAAA;cAGP,OAAA,UACA,OAAA;IAAA,SACW,KAAA,GAAQ,KAAA;IAAA,SACR,QAAA;IAAA,SACA,UAAA;IAAA,SACA,KAAA;IAAA,SACA,MAAA;IAAA,SACA,MAAA;EAAA;EAfJ;;;EAAA,OA8BF,EAAA,CAAG,KAAA,YAAiB,KAAA,IAAS,aAAA;AAAA;;;;cAazB,kBAAA,SAA2B,KAAA,YAAiB,cAAA;EAAA,gBACvC,UAAA;EAAA,SACP,IAAA;EAAA,SACA,SAAA;cAGP,OAAA,UACA,OAAA;IAAA,SACW,KAAA,GAAQ,KAAA;IAAA,SACR,SAAA;EAAA;EAtBN;;;EAAA,OAiCA,EAAA,CAAG,KAAA,YAAiB,KAAA,IAAS,kBAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts"],"mappings":";UAAiB,cAAA;EAAA,SACN,IAAA,EAAM,IAAI;AAAA;;;;cAKR,aAAA,SAAsB,KAAA,YAAiB,cAAA;EAAA,gBAClC,UAAA;EAAA,SACP,IAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;EAAA,SACA,KAAA;EAAA,SACA,MAAA;EAAA,SACA,MAAA;cAGP,OAAA,UACA,OAAA;IAAA,SACW,KAAA,GAAQ,KAAA;IAAA,SACR,QAAA;IAAA,SACA,UAAA;IAAA,SACA,KAAA;IAAA,SACA,MAAA;IAAA,SACA,MAAA;EAAA;EAfJ;;;EAAA,OA8BF,EAAA,CAAG,KAAA,YAAiB,KAAA,IAAS,aAAA;AAAA;;;;;;;;cAiBzB,yBAAA;;;;;;;iBAQG,2BAAA,CAA4B,KAAc;;AAzBP;AAiBnD;cAea,kBAAA,SAA2B,KAAA,YAAiB,cAAA;EAAA,gBACvC,UAAA;EAAA,SACP,IAAA;EAAA,SACA,SAAA;cAGP,OAAA,UACA,OAAA;IAAA,SACW,KAAA,GAAQ,KAAA;IAAA,SACR,SAAA;EAAA;EAhB2C;AAO1D;;EAP0D,OA2BjD,EAAA,CAAG,KAAA,YAAiB,KAAA,IAAS,kBAAA;AAAA"}

package/dist/index.mjs

@@ -27,6 +27,23 @@ var SqlQueryError = class SqlQueryError extends Error {
 	}
 };
 /**
+* SQLSTATE for a unique-constraint / primary-key violation — the SQL-standard
+* `unique_violation` class. Drivers normalize their target-specific codes (e.g.
+* Postgres `23505`, SQLite `SQLITE_CONSTRAINT_UNIQUE`/`PRIMARYKEY`) onto this
+* value on {@link SqlQueryError.sqlState}, so consumers classify violations
+* without knowing any target-specific error shape.
+*/
+const UNIQUE_VIOLATION_SQLSTATE = "23505";
+/**
+* Whether an error is a unique-constraint (or primary-key) violation, decided
+* solely from the driver-normalized {@link SqlQueryError.sqlState}. Raw driver
+* errors that were never normalized are not classified — callers run behind the
+* driver, which always normalizes before the error escapes.
+*/
+function isUniqueConstraintViolation(error) {
+	return SqlQueryError.is(error) && error.sqlState === "23505";
+}
+/**
 * SQL connection error (timeouts, connection resets, etc.).
 */
 var SqlConnectionError = class SqlConnectionError extends Error {
@@ -46,6 +63,6 @@ var SqlConnectionError = class SqlConnectionError extends Error {
 	}
 };
 //#endregion
-export { SqlConnectionError, SqlQueryError };
+export { SqlConnectionError, SqlQueryError, UNIQUE_VIOLATION_SQLSTATE, isUniqueConstraintViolation };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["export interface SqlDriverError<Kind extends string> {\n  readonly kind: Kind;\n}\n/**\n * SQL query error for query-related failures (syntax errors, constraint violations, permissions).\n */\nexport class SqlQueryError extends Error implements SqlDriverError<'sql_query'> {\n  static readonly ERROR_NAME = 'SqlQueryError' as const;\n  readonly kind = 'sql_query' as const;\n  readonly sqlState: string | undefined;\n  readonly constraint: string | undefined;\n  readonly table: string | undefined;\n  readonly column: string | undefined;\n  readonly detail: string | undefined;\n\n  constructor(\n    message: string,\n    options?: {\n      readonly cause?: Error;\n      readonly sqlState?: string;\n      readonly constraint?: string;\n      readonly table?: string;\n      readonly column?: string;\n      readonly detail?: string;\n    },\n  ) {\n    super(message, { cause: options?.cause });\n    this.name = SqlQueryError.ERROR_NAME;\n    this.sqlState = options?.sqlState;\n    this.constraint = options?.constraint;\n    this.table = options?.table;\n    this.column = options?.column;\n    this.detail = options?.detail;\n  }\n\n  /**\n   * Type predicate to check if an error is a SqlQueryError.\n   */\n  static is(error: unknown): error is SqlQueryError {\n    return (\n      typeof error === 'object' &&\n      error !== null &&\n      Object.hasOwn(error, 'kind') &&\n      (error as { kind: unknown }).kind === 'sql_query'\n    );\n  }\n}\n\n/**\n * SQL connection error (timeouts, connection resets, etc.).\n */\nexport class SqlConnectionError extends Error implements SqlDriverError<'sql_connection'> {\n  static readonly ERROR_NAME = 'SqlConnectionError' as const;\n  readonly kind = 'sql_connection' as const;\n  readonly transient: boolean | undefined;\n\n  constructor(\n    message: string,\n    options?: {\n      readonly cause?: Error;\n      readonly transient?: boolean;\n    },\n  ) {\n    super(message, { cause: options?.cause });\n    this.name = SqlConnectionError.ERROR_NAME;\n    this.transient = options?.transient;\n  }\n\n  /**\n   * Type predicate to check if an error is a SqlConnectionError.\n   */\n  static is(error: unknown): error is SqlConnectionError {\n    return (\n      typeof error === 'object' &&\n      error !== null &&\n      Object.hasOwn(error, 'kind') &&\n      (error as { kind: unknown }).kind === 'sql_connection'\n    );\n  }\n}\n"],"mappings":";;;;AAMA,IAAa,gBAAb,MAAa,sBAAsB,MAA6C;CAC9E,OAAgB,aAAa;CAC7B,OAAgB;CAChB;CACA;CACA;CACA;CACA;CAEA,YACE,SACA,SAQA;EACA,MAAM,SAAS,EAAE,OAAO,SAAS,MAAM,CAAC;EACxC,KAAK,OAAO,cAAc;EAC1B,KAAK,WAAW,SAAS;EACzB,KAAK,aAAa,SAAS;EAC3B,KAAK,QAAQ,SAAS;EACtB,KAAK,SAAS,SAAS;EACvB,KAAK,SAAS,SAAS;CACzB;;;;CAKA,OAAO,GAAG,OAAwC;EAChD,OACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAO,OAAO,OAAO,MAAM,KAC1B,MAA4B,SAAS;CAE1C;AACF;;;;AAKA,IAAa,qBAAb,MAAa,2BAA2B,MAAkD;CACxF,OAAgB,aAAa;CAC7B,OAAgB;CAChB;CAEA,YACE,SACA,SAIA;EACA,MAAM,SAAS,EAAE,OAAO,SAAS,MAAM,CAAC;EACxC,KAAK,OAAO,mBAAmB;EAC/B,KAAK,YAAY,SAAS;CAC5B;;;;CAKA,OAAO,GAAG,OAA6C;EACrD,OACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAO,OAAO,OAAO,MAAM,KAC1B,MAA4B,SAAS;CAE1C;AACF"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["export interface SqlDriverError<Kind extends string> {\n  readonly kind: Kind;\n}\n/**\n * SQL query error for query-related failures (syntax errors, constraint violations, permissions).\n */\nexport class SqlQueryError extends Error implements SqlDriverError<'sql_query'> {\n  static readonly ERROR_NAME = 'SqlQueryError' as const;\n  readonly kind = 'sql_query' as const;\n  readonly sqlState: string | undefined;\n  readonly constraint: string | undefined;\n  readonly table: string | undefined;\n  readonly column: string | undefined;\n  readonly detail: string | undefined;\n\n  constructor(\n    message: string,\n    options?: {\n      readonly cause?: Error;\n      readonly sqlState?: string;\n      readonly constraint?: string;\n      readonly table?: string;\n      readonly column?: string;\n      readonly detail?: string;\n    },\n  ) {\n    super(message, { cause: options?.cause });\n    this.name = SqlQueryError.ERROR_NAME;\n    this.sqlState = options?.sqlState;\n    this.constraint = options?.constraint;\n    this.table = options?.table;\n    this.column = options?.column;\n    this.detail = options?.detail;\n  }\n\n  /**\n   * Type predicate to check if an error is a SqlQueryError.\n   */\n  static is(error: unknown): error is SqlQueryError {\n    return (\n      typeof error === 'object' &&\n      error !== null &&\n      Object.hasOwn(error, 'kind') &&\n      (error as { kind: unknown }).kind === 'sql_query'\n    );\n  }\n}\n\n/**\n * SQLSTATE for a unique-constraint / primary-key violation — the SQL-standard\n * `unique_violation` class. Drivers normalize their target-specific codes (e.g.\n * Postgres `23505`, SQLite `SQLITE_CONSTRAINT_UNIQUE`/`PRIMARYKEY`) onto this\n * value on {@link SqlQueryError.sqlState}, so consumers classify violations\n * without knowing any target-specific error shape.\n */\nexport const UNIQUE_VIOLATION_SQLSTATE = '23505';\n\n/**\n * Whether an error is a unique-constraint (or primary-key) violation, decided\n * solely from the driver-normalized {@link SqlQueryError.sqlState}. Raw driver\n * errors that were never normalized are not classified — callers run behind the\n * driver, which always normalizes before the error escapes.\n */\nexport function isUniqueConstraintViolation(error: unknown): boolean {\n  return SqlQueryError.is(error) && error.sqlState === UNIQUE_VIOLATION_SQLSTATE;\n}\n\n/**\n * SQL connection error (timeouts, connection resets, etc.).\n */\nexport class SqlConnectionError extends Error implements SqlDriverError<'sql_connection'> {\n  static readonly ERROR_NAME = 'SqlConnectionError' as const;\n  readonly kind = 'sql_connection' as const;\n  readonly transient: boolean | undefined;\n\n  constructor(\n    message: string,\n    options?: {\n      readonly cause?: Error;\n      readonly transient?: boolean;\n    },\n  ) {\n    super(message, { cause: options?.cause });\n    this.name = SqlConnectionError.ERROR_NAME;\n    this.transient = options?.transient;\n  }\n\n  /**\n   * Type predicate to check if an error is a SqlConnectionError.\n   */\n  static is(error: unknown): error is SqlConnectionError {\n    return (\n      typeof error === 'object' &&\n      error !== null &&\n      Object.hasOwn(error, 'kind') &&\n      (error as { kind: unknown }).kind === 'sql_connection'\n    );\n  }\n}\n"],"mappings":";;;;AAMA,IAAa,gBAAb,MAAa,sBAAsB,MAA6C;CAC9E,OAAgB,aAAa;CAC7B,OAAgB;CAChB;CACA;CACA;CACA;CACA;CAEA,YACE,SACA,SAQA;EACA,MAAM,SAAS,EAAE,OAAO,SAAS,MAAM,CAAC;EACxC,KAAK,OAAO,cAAc;EAC1B,KAAK,WAAW,SAAS;EACzB,KAAK,aAAa,SAAS;EAC3B,KAAK,QAAQ,SAAS;EACtB,KAAK,SAAS,SAAS;EACvB,KAAK,SAAS,SAAS;CACzB;;;;CAKA,OAAO,GAAG,OAAwC;EAChD,OACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAO,OAAO,OAAO,MAAM,KAC1B,MAA4B,SAAS;CAE1C;AACF;;;;;;;;AASA,MAAa,4BAA4B;;;;;;;AAQzC,SAAgB,4BAA4B,OAAyB;CACnE,OAAO,cAAc,GAAG,KAAK,KAAK,MAAM,aAAA;AAC1C;;;;AAKA,IAAa,qBAAb,MAAa,2BAA2B,MAAkD;CACxF,OAAgB,aAAa;CAC7B,OAAgB;CAChB;CAEA,YACE,SACA,SAIA;EACA,MAAM,SAAS,EAAE,OAAO,SAAS,MAAM,CAAC;EACxC,KAAK,OAAO,mBAAmB;EAC/B,KAAK,YAAY,SAAS;CAC5B;;;;CAKA,OAAO,GAAG,OAA6C;EACrD,OACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAO,OAAO,OAAO,MAAM,KAC1B,MAA4B,SAAS;CAE1C;AACF"}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@prisma-next/sql-errors",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "description": "Normalized SQL driver error types for Prisma Next",
   "devDependencies": {
-    "@prisma-next/test-utils": "0.13.0",
-    "@prisma-next/tsconfig": "0.13.0",
-    "@prisma-next/tsdown": "0.13.0",
+    "@prisma-next/test-utils": "0.14.0",
+    "@prisma-next/tsconfig": "0.14.0",
+    "@prisma-next/tsdown": "0.14.0",
     "tsdown": "0.22.1",
     "typescript": "5.9.3",
     "vitest": "4.1.8"

package/src/errors.ts

@@ -46,6 +46,25 @@ export class SqlQueryError extends Error implements SqlDriverError<'sql_query'>
   }
 }
 
+/**
+ * SQLSTATE for a unique-constraint / primary-key violation — the SQL-standard
+ * `unique_violation` class. Drivers normalize their target-specific codes (e.g.
+ * Postgres `23505`, SQLite `SQLITE_CONSTRAINT_UNIQUE`/`PRIMARYKEY`) onto this
+ * value on {@link SqlQueryError.sqlState}, so consumers classify violations
+ * without knowing any target-specific error shape.
+ */
+export const UNIQUE_VIOLATION_SQLSTATE = '23505';
+
+/**
+ * Whether an error is a unique-constraint (or primary-key) violation, decided
+ * solely from the driver-normalized {@link SqlQueryError.sqlState}. Raw driver
+ * errors that were never normalized are not classified — callers run behind the
+ * driver, which always normalizes before the error escapes.
+ */
+export function isUniqueConstraintViolation(error: unknown): boolean {
+  return SqlQueryError.is(error) && error.sqlState === UNIQUE_VIOLATION_SQLSTATE;
+}
+
 /**
  * SQL connection error (timeouts, connection resets, etc.).
  */

package/src/exports/index.ts

@@ -1 +1,6 @@
-export { SqlConnectionError, SqlQueryError } from '../errors';
+export {
+  isUniqueConstraintViolation,
+  SqlConnectionError,
+  SqlQueryError,
+  UNIQUE_VIOLATION_SQLSTATE,
+} from '../errors';