@xfcfam/xf-sql 0.1.0

package/dist/src/repository/structs/ForeignKeyViolationException.js

@@ -0,0 +1,23 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT, UPDATE or DELETE violates a FOREIGN KEY
+ * constraint.
+ *
+ * Common scenarios: inserting a row that references a non-existent
+ * parent; deleting a row that is still referenced by children.
+ */
+export class ForeignKeyViolationException extends DatabaseException {
+    /** Name of the violated foreign-key constraint, if known. */
+    constraint;
+    /** Table where the violation occurred, if known. */
+    table;
+    constructor(message, details = {}) {
+        super(message, { cause: details.cause });
+        this.name = 'ForeignKeyViolationException';
+        if (details.constraint !== undefined)
+            this.constraint = details.constraint;
+        if (details.table !== undefined)
+            this.table = details.table;
+    }
+}
+//# sourceMappingURL=ForeignKeyViolationException.js.map

package/dist/src/repository/structs/ForeignKeyViolationException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForeignKeyViolationException.js","sourceRoot":"","sources":["../../../../src/repository/structs/ForeignKeyViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,OAAO,4BAA6B,SAAQ,iBAAiB;IACjE,6DAA6D;IACpD,UAAU,CAAS;IAC5B,oDAAoD;IAC3C,KAAK,CAAS;IAEvB,YACE,OAAe,EACf,UAAoE,EAAE;QAEtE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAA;QAC1C,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;QAC1E,IAAI,OAAO,CAAC,KAAK,KAAU,SAAS;YAAE,IAAI,CAAC,KAAK,GAAQ,OAAO,CAAC,KAAK,CAAA;IACvE,CAAC;CACF"}

package/dist/src/repository/structs/NotNullViolationException.d.ts

@@ -0,0 +1,20 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT or UPDATE attempts to set a NOT NULL column
+ * to NULL.
+ *
+ * Almost always indicates a bug in the Repository or a missing input
+ * validation at the Business Layer.
+ */
+export declare class NotNullViolationException extends DatabaseException {
+    /** Table where the violation occurred, if known. */
+    readonly table?: string;
+    /** Column that was set to NULL, if known. */
+    readonly column?: string;
+    constructor(message: string, details?: {
+        table?: string;
+        column?: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=NotNullViolationException.d.ts.map

package/dist/src/repository/structs/NotNullViolationException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotNullViolationException.d.ts","sourceRoot":"","sources":["../../../../src/repository/structs/NotNullViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,iBAAiB;IAC9D,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;gBAGtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAOrE"}

package/dist/src/repository/structs/NotNullViolationException.js

@@ -0,0 +1,23 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT or UPDATE attempts to set a NOT NULL column
+ * to NULL.
+ *
+ * Almost always indicates a bug in the Repository or a missing input
+ * validation at the Business Layer.
+ */
+export class NotNullViolationException extends DatabaseException {
+    /** Table where the violation occurred, if known. */
+    table;
+    /** Column that was set to NULL, if known. */
+    column;
+    constructor(message, details = {}) {
+        super(message, { cause: details.cause });
+        this.name = 'NotNullViolationException';
+        if (details.table !== undefined)
+            this.table = details.table;
+        if (details.column !== undefined)
+            this.column = details.column;
+    }
+}
+//# sourceMappingURL=NotNullViolationException.js.map

package/dist/src/repository/structs/NotNullViolationException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotNullViolationException.js","sourceRoot":"","sources":["../../../../src/repository/structs/NotNullViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,OAAO,yBAA0B,SAAQ,iBAAiB;IAC9D,oDAAoD;IAC3C,KAAK,CAAS;IACvB,6CAA6C;IACpC,MAAM,CAAS;IAExB,YACE,OAAe,EACf,UAAgE,EAAE;QAElE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;QACvC,IAAI,OAAO,CAAC,KAAK,KAAM,SAAS;YAAE,IAAI,CAAC,KAAK,GAAI,OAAO,CAAC,KAAK,CAAA;QAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAChE,CAAC;CACF"}

package/dist/src/repository/structs/UniqueViolationException.d.ts

@@ -0,0 +1,36 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT or UPDATE violates a UNIQUE / PRIMARY KEY
+ * constraint.
+ *
+ * Carries the violated constraint name plus the table / column when
+ * the underlying driver exposes them, so the Business Layer can
+ * surface a domain-meaningful error without parsing strings.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await this.usersDb.createUser({ email: 'a@b.c', ... })
+ * } catch (err) {
+ *   if (err instanceof UniqueViolationException && err.column === 'email') {
+ *     throw new DomainError('Email already registered')
+ *   }
+ *   throw err
+ * }
+ * ```
+ */
+export declare class UniqueViolationException extends DatabaseException {
+    /** Name of the violated unique / primary-key constraint, if known. */
+    readonly constraint?: string;
+    /** Table where the violation occurred, if known. */
+    readonly table?: string;
+    /** Column involved in the violation, if known. */
+    readonly column?: string;
+    constructor(message: string, details?: {
+        constraint?: string;
+        table?: string;
+        column?: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=UniqueViolationException.d.ts.map

package/dist/src/repository/structs/UniqueViolationException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniqueViolationException.d.ts","sourceRoot":"","sources":["../../../../src/repository/structs/UniqueViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC7D,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;gBAGtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAQ1F"}

package/dist/src/repository/structs/UniqueViolationException.js

@@ -0,0 +1,40 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT or UPDATE violates a UNIQUE / PRIMARY KEY
+ * constraint.
+ *
+ * Carries the violated constraint name plus the table / column when
+ * the underlying driver exposes them, so the Business Layer can
+ * surface a domain-meaningful error without parsing strings.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await this.usersDb.createUser({ email: 'a@b.c', ... })
+ * } catch (err) {
+ *   if (err instanceof UniqueViolationException && err.column === 'email') {
+ *     throw new DomainError('Email already registered')
+ *   }
+ *   throw err
+ * }
+ * ```
+ */
+export class UniqueViolationException extends DatabaseException {
+    /** Name of the violated unique / primary-key constraint, if known. */
+    constraint;
+    /** Table where the violation occurred, if known. */
+    table;
+    /** Column involved in the violation, if known. */
+    column;
+    constructor(message, details = {}) {
+        super(message, { cause: details.cause });
+        this.name = 'UniqueViolationException';
+        if (details.constraint !== undefined)
+            this.constraint = details.constraint;
+        if (details.table !== undefined)
+            this.table = details.table;
+        if (details.column !== undefined)
+            this.column = details.column;
+    }
+}
+//# sourceMappingURL=UniqueViolationException.js.map

package/dist/src/repository/structs/UniqueViolationException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniqueViolationException.js","sourceRoot":"","sources":["../../../../src/repository/structs/UniqueViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IAC7D,sEAAsE;IAC7D,UAAU,CAAS;IAC5B,oDAAoD;IAC3C,KAAK,CAAS;IACvB,kDAAkD;IACzC,MAAM,CAAS;IAExB,YACE,OAAe,EACf,UAAqF,EAAE;QAEvF,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;QACtC,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;QAC1E,IAAI,OAAO,CAAC,KAAK,KAAU,SAAS;YAAE,IAAI,CAAC,KAAK,GAAQ,OAAO,CAAC,KAAK,CAAA;QACrE,IAAI,OAAO,CAAC,MAAM,KAAS,SAAS;YAAE,IAAI,CAAC,MAAM,GAAO,OAAO,CAAC,MAAM,CAAA;IACxE,CAAC;CACF"}

package/dist/src/repository/transfers/CheckViolationException.d.ts

@@ -0,0 +1,19 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT or UPDATE violates a CHECK constraint.
+ *
+ * The constraint name (when exposed by the driver) often matches the
+ * named CHECK in the schema, e.g. `users_age_positive_check`.
+ */
+export declare class CheckViolationException extends DatabaseException {
+    /** Name of the violated CHECK constraint, if known. */
+    readonly constraint?: string;
+    /** Table where the violation occurred, if known. */
+    readonly table?: string;
+    constructor(message: string, details?: {
+        constraint?: string;
+        table?: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=CheckViolationException.d.ts.map

package/dist/src/repository/transfers/CheckViolationException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckViolationException.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/CheckViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,iBAAiB;IAC5D,uDAAuD;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;gBAGrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAOzE"}

package/dist/src/repository/transfers/CheckViolationException.js

@@ -0,0 +1,22 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT or UPDATE violates a CHECK constraint.
+ *
+ * The constraint name (when exposed by the driver) often matches the
+ * named CHECK in the schema, e.g. `users_age_positive_check`.
+ */
+export class CheckViolationException extends DatabaseException {
+    /** Name of the violated CHECK constraint, if known. */
+    constraint;
+    /** Table where the violation occurred, if known. */
+    table;
+    constructor(message, details = {}) {
+        super(message, { cause: details.cause });
+        this.name = 'CheckViolationException';
+        if (details.constraint !== undefined)
+            this.constraint = details.constraint;
+        if (details.table !== undefined)
+            this.table = details.table;
+    }
+}
+//# sourceMappingURL=CheckViolationException.js.map

package/dist/src/repository/transfers/CheckViolationException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckViolationException.js","sourceRoot":"","sources":["../../../../src/repository/transfers/CheckViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;GAKG;AACH,MAAM,OAAO,uBAAwB,SAAQ,iBAAiB;IAC5D,uDAAuD;IAC9C,UAAU,CAAS;IAC5B,oDAAoD;IAC3C,KAAK,CAAS;IAEvB,YACE,OAAe,EACf,UAAoE,EAAE;QAEtE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;QACrC,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;QAC1E,IAAI,OAAO,CAAC,KAAK,KAAU,SAAS;YAAE,IAAI,CAAC,KAAK,GAAQ,OAAO,CAAC,KAAK,CAAA;IACvE,CAAC;CACF"}

package/dist/src/repository/transfers/ConnectionException.d.ts

@@ -0,0 +1,15 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when the database is unreachable — DNS failure, TCP refused,
+ * TLS handshake failure, statement / connection timeout, etc.
+ *
+ * The original transport error is preserved as the standard
+ * `Error.cause`. Use this alongside `RetryableRepository.withRetry`
+ * to back off and retry on transient transport failures.
+ */
+export declare class ConnectionException extends DatabaseException {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=ConnectionException.d.ts.map

package/dist/src/repository/transfers/ConnectionException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionException.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/ConnectionException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;gBAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D"}

package/dist/src/repository/transfers/ConnectionException.js

@@ -0,0 +1,16 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when the database is unreachable — DNS failure, TCP refused,
+ * TLS handshake failure, statement / connection timeout, etc.
+ *
+ * The original transport error is preserved as the standard
+ * `Error.cause`. Use this alongside `RetryableRepository.withRetry`
+ * to back off and retry on transient transport failures.
+ */
+export class ConnectionException extends DatabaseException {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ConnectionException';
+    }
+}
+//# sourceMappingURL=ConnectionException.js.map

package/dist/src/repository/transfers/ConnectionException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionException.js","sourceRoot":"","sources":["../../../../src/repository/transfers/ConnectionException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}

package/dist/src/repository/transfers/DatabaseException.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Base type for every database-related error raised through xf-sql.
+ *
+ * Every concrete dialect-specific Exception in `@xfcfam/xf-sql` is a
+ * subclass of `DatabaseException`. Consumers can branch on the
+ * specific subclass (e.g. `UniqueViolationException`) or fall back to
+ * `instanceof DatabaseException` to catch any DB-originated error.
+ */
+export declare class DatabaseException extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=DatabaseException.d.ts.map

package/dist/src/repository/transfers/DatabaseException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseException.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/DatabaseException.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D"}

package/dist/src/repository/transfers/DatabaseException.js

@@ -0,0 +1,15 @@
+/**
+ * Base type for every database-related error raised through xf-sql.
+ *
+ * Every concrete dialect-specific Exception in `@xfcfam/xf-sql` is a
+ * subclass of `DatabaseException`. Consumers can branch on the
+ * specific subclass (e.g. `UniqueViolationException`) or fall back to
+ * `instanceof DatabaseException` to catch any DB-originated error.
+ */
+export class DatabaseException extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'DatabaseException';
+    }
+}
+//# sourceMappingURL=DatabaseException.js.map

package/dist/src/repository/transfers/DatabaseException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseException.js","sourceRoot":"","sources":["../../../../src/repository/transfers/DatabaseException.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF"}

package/dist/src/repository/transfers/DeadlockException.d.ts

@@ -0,0 +1,16 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when the database detects a deadlock and aborts one of the
+ * conflicting transactions.
+ *
+ * Deadlocks are typically retryable — the transaction can be re-run
+ * and will usually succeed once the conflicting party has finished.
+ * Pair with `RetryableRepository.withRetry` or
+ * `RetryRestRepository`-style policies in your Logical.
+ */
+export declare class DeadlockException extends DatabaseException {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=DeadlockException.d.ts.map

package/dist/src/repository/transfers/DeadlockException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeadlockException.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/DeadlockException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,iBAAiB;gBAC1C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D"}

package/dist/src/repository/transfers/DeadlockException.js

@@ -0,0 +1,17 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when the database detects a deadlock and aborts one of the
+ * conflicting transactions.
+ *
+ * Deadlocks are typically retryable — the transaction can be re-run
+ * and will usually succeed once the conflicting party has finished.
+ * Pair with `RetryableRepository.withRetry` or
+ * `RetryRestRepository`-style policies in your Logical.
+ */
+export class DeadlockException extends DatabaseException {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'DeadlockException';
+    }
+}
+//# sourceMappingURL=DeadlockException.js.map

package/dist/src/repository/transfers/DeadlockException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeadlockException.js","sourceRoot":"","sources":["../../../../src/repository/transfers/DeadlockException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IACtD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF"}

package/dist/src/repository/transfers/ForeignKeyViolationException.d.ts

@@ -0,0 +1,20 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT, UPDATE or DELETE violates a FOREIGN KEY
+ * constraint.
+ *
+ * Common scenarios: inserting a row that references a non-existent
+ * parent; deleting a row that is still referenced by children.
+ */
+export declare class ForeignKeyViolationException extends DatabaseException {
+    /** Name of the violated foreign-key constraint, if known. */
+    readonly constraint?: string;
+    /** Table where the violation occurred, if known. */
+    readonly table?: string;
+    constructor(message: string, details?: {
+        constraint?: string;
+        table?: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=ForeignKeyViolationException.d.ts.map

package/dist/src/repository/transfers/ForeignKeyViolationException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForeignKeyViolationException.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/ForeignKeyViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;GAMG;AACH,qBAAa,4BAA6B,SAAQ,iBAAiB;IACjE,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;gBAGrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAOzE"}

package/dist/src/repository/transfers/ForeignKeyViolationException.js

@@ -0,0 +1,23 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT, UPDATE or DELETE violates a FOREIGN KEY
+ * constraint.
+ *
+ * Common scenarios: inserting a row that references a non-existent
+ * parent; deleting a row that is still referenced by children.
+ */
+export class ForeignKeyViolationException extends DatabaseException {
+    /** Name of the violated foreign-key constraint, if known. */
+    constraint;
+    /** Table where the violation occurred, if known. */
+    table;
+    constructor(message, details = {}) {
+        super(message, { cause: details.cause });
+        this.name = 'ForeignKeyViolationException';
+        if (details.constraint !== undefined)
+            this.constraint = details.constraint;
+        if (details.table !== undefined)
+            this.table = details.table;
+    }
+}
+//# sourceMappingURL=ForeignKeyViolationException.js.map

package/dist/src/repository/transfers/ForeignKeyViolationException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForeignKeyViolationException.js","sourceRoot":"","sources":["../../../../src/repository/transfers/ForeignKeyViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,OAAO,4BAA6B,SAAQ,iBAAiB;IACjE,6DAA6D;IACpD,UAAU,CAAS;IAC5B,oDAAoD;IAC3C,KAAK,CAAS;IAEvB,YACE,OAAe,EACf,UAAoE,EAAE;QAEtE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAA;QAC1C,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;QAC1E,IAAI,OAAO,CAAC,KAAK,KAAU,SAAS;YAAE,IAAI,CAAC,KAAK,GAAQ,OAAO,CAAC,KAAK,CAAA;IACvE,CAAC;CACF"}

package/dist/src/repository/transfers/NotNullViolationException.d.ts

@@ -0,0 +1,20 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT or UPDATE attempts to set a NOT NULL column
+ * to NULL.
+ *
+ * Almost always indicates a bug in the Repository or a missing input
+ * validation at the Business Layer.
+ */
+export declare class NotNullViolationException extends DatabaseException {
+    /** Table where the violation occurred, if known. */
+    readonly table?: string;
+    /** Column that was set to NULL, if known. */
+    readonly column?: string;
+    constructor(message: string, details?: {
+        table?: string;
+        column?: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=NotNullViolationException.d.ts.map

package/dist/src/repository/transfers/NotNullViolationException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotNullViolationException.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/NotNullViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,iBAAiB;IAC9D,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;gBAGtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAOrE"}

package/dist/src/repository/transfers/NotNullViolationException.js

@@ -0,0 +1,23 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT or UPDATE attempts to set a NOT NULL column
+ * to NULL.
+ *
+ * Almost always indicates a bug in the Repository or a missing input
+ * validation at the Business Layer.
+ */
+export class NotNullViolationException extends DatabaseException {
+    /** Table where the violation occurred, if known. */
+    table;
+    /** Column that was set to NULL, if known. */
+    column;
+    constructor(message, details = {}) {
+        super(message, { cause: details.cause });
+        this.name = 'NotNullViolationException';
+        if (details.table !== undefined)
+            this.table = details.table;
+        if (details.column !== undefined)
+            this.column = details.column;
+    }
+}
+//# sourceMappingURL=NotNullViolationException.js.map

package/dist/src/repository/transfers/NotNullViolationException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotNullViolationException.js","sourceRoot":"","sources":["../../../../src/repository/transfers/NotNullViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,OAAO,yBAA0B,SAAQ,iBAAiB;IAC9D,oDAAoD;IAC3C,KAAK,CAAS;IACvB,6CAA6C;IACpC,MAAM,CAAS;IAExB,YACE,OAAe,EACf,UAAgE,EAAE;QAElE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;QACvC,IAAI,OAAO,CAAC,KAAK,KAAM,SAAS;YAAE,IAAI,CAAC,KAAK,GAAI,OAAO,CAAC,KAAK,CAAA;QAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAChE,CAAC;CACF"}

package/dist/src/repository/transfers/UniqueViolationException.d.ts

@@ -0,0 +1,36 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT or UPDATE violates a UNIQUE / PRIMARY KEY
+ * constraint.
+ *
+ * Carries the violated constraint name plus the table / column when
+ * the underlying driver exposes them, so the Business Layer can
+ * surface a domain-meaningful error without parsing strings.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await this.usersDb.createUser({ email: 'a@b.c', ... })
+ * } catch (err) {
+ *   if (err instanceof UniqueViolationException && err.column === 'email') {
+ *     throw new DomainError('Email already registered')
+ *   }
+ *   throw err
+ * }
+ * ```
+ */
+export declare class UniqueViolationException extends DatabaseException {
+    /** Name of the violated unique / primary-key constraint, if known. */
+    readonly constraint?: string;
+    /** Table where the violation occurred, if known. */
+    readonly table?: string;
+    /** Column involved in the violation, if known. */
+    readonly column?: string;
+    constructor(message: string, details?: {
+        constraint?: string;
+        table?: string;
+        column?: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=UniqueViolationException.d.ts.map

package/dist/src/repository/transfers/UniqueViolationException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniqueViolationException.d.ts","sourceRoot":"","sources":["../../../../src/repository/transfers/UniqueViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC7D,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;gBAGtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAQ1F"}

package/dist/src/repository/transfers/UniqueViolationException.js

@@ -0,0 +1,40 @@
+import { DatabaseException } from './DatabaseException.js';
+/**
+ * Thrown when an INSERT or UPDATE violates a UNIQUE / PRIMARY KEY
+ * constraint.
+ *
+ * Carries the violated constraint name plus the table / column when
+ * the underlying driver exposes them, so the Business Layer can
+ * surface a domain-meaningful error without parsing strings.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await this.usersDb.createUser({ email: 'a@b.c', ... })
+ * } catch (err) {
+ *   if (err instanceof UniqueViolationException && err.column === 'email') {
+ *     throw new DomainError('Email already registered')
+ *   }
+ *   throw err
+ * }
+ * ```
+ */
+export class UniqueViolationException extends DatabaseException {
+    /** Name of the violated unique / primary-key constraint, if known. */
+    constraint;
+    /** Table where the violation occurred, if known. */
+    table;
+    /** Column involved in the violation, if known. */
+    column;
+    constructor(message, details = {}) {
+        super(message, { cause: details.cause });
+        this.name = 'UniqueViolationException';
+        if (details.constraint !== undefined)
+            this.constraint = details.constraint;
+        if (details.table !== undefined)
+            this.table = details.table;
+        if (details.column !== undefined)
+            this.column = details.column;
+    }
+}
+//# sourceMappingURL=UniqueViolationException.js.map

package/dist/src/repository/transfers/UniqueViolationException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniqueViolationException.js","sourceRoot":"","sources":["../../../../src/repository/transfers/UniqueViolationException.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IAC7D,sEAAsE;IAC7D,UAAU,CAAS;IAC5B,oDAAoD;IAC3C,KAAK,CAAS;IACvB,kDAAkD;IACzC,MAAM,CAAS;IAExB,YACE,OAAe,EACf,UAAqF,EAAE;QAEvF,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;QACtC,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;QAC1E,IAAI,OAAO,CAAC,KAAK,KAAU,SAAS;YAAE,IAAI,CAAC,KAAK,GAAQ,OAAO,CAAC,KAAK,CAAA;QACrE,IAAI,OAAO,CAAC,MAAM,KAAS,SAAS;YAAE,IAAI,CAAC,MAAM,GAAO,OAAO,CAAC,MAAM,CAAA;IACxE,CAAC;CACF"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@xfcfam/xf-sql",
+  "version": "0.1.0",
+  "description": "SQL Access Layer Generalization for the XF Architecture Model — encapsulates the Kysely query builder. Dialect-agnostic; pair with @xfcfam/xf-sql-postgres / @xfcfam/xf-sql-mysql / etc.",
+  "author": "XF Contributors",
+  "license": "MIT",
+  "homepage": "https://xfcfam.org",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xfcfam/lib-npm",
+    "directory": "packages/xf-sql"
+  },
+  "keywords": [
+    "xf",
+    "cfam",
+    "sql",
+    "kysely",
+    "database"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "kysely": "^0.27.0"
+  },
+  "peerDependencies": {
+    "@xfcfam/xf": "^0.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}