@owlmeans/postgres-resource 0.1.15

package/build/consts.js

@@ -0,0 +1,86 @@
+export const DEFAULT_DB_ALIAS = 'postgres';
+export const DEFAULT_PAGE_SIZE = 10;
+/**
+ * Table that records which code-registered migrations have already been applied.
+ * Lives in the same Postgres schema as the resources it tracks, so dropping the
+ * schema drops the ledger with it.
+ */
+export const DEF_MIGRATIONS_TABLE = '_owlmeans_migrations';
+/** JSON Schema keyword carrying the Postgres specific overrides. */
+export const PG_KEYWORD = 'pg';
+/** Postgres `NAMEDATALEN - 1`. Identifiers past this are silently truncated by the server. */
+export const PG_MAX_IDENTIFIER = 63;
+/** Property name that carries the record identity across every OwlMeans resource. */
+export const ID_FIELD = 'id';
+/** Fallback when a scalar property can't be mapped to anything more specific. */
+export const DEF_SQL_TYPE = 'text';
+export const DEF_JSON_TYPE = 'jsonb';
+/** Server side identity default for the implicit `id` primary key. */
+export const DEF_ID_DEFAULT = 'gen_random_uuid()::text';
+/**
+ * How far structure reconciliation is allowed to go.
+ *
+ * `additive` is the adoption path for a table this package didn't create: it adds what's
+ * missing but never retypes and never drops, so a first boot against an existing schema
+ * converges without touching data. Flip to `full` once the plan comes out empty.
+ */
+export var PgAutoSync;
+(function (PgAutoSync) {
+    PgAutoSync["Full"] = "full";
+    PgAutoSync["Additive"] = "additive";
+    PgAutoSync["Off"] = "off";
+})(PgAutoSync || (PgAutoSync = {}));
+export var PgIndexMethod;
+(function (PgIndexMethod) {
+    PgIndexMethod["BTree"] = "btree";
+    PgIndexMethod["Hash"] = "hash";
+    PgIndexMethod["Gin"] = "gin";
+    PgIndexMethod["Gist"] = "gist";
+    PgIndexMethod["Brin"] = "brin";
+    PgIndexMethod["SpGist"] = "spgist";
+})(PgIndexMethod || (PgIndexMethod = {}));
+export var PgReferentialAction;
+(function (PgReferentialAction) {
+    PgReferentialAction["NoAction"] = "no action";
+    PgReferentialAction["Restrict"] = "restrict";
+    PgReferentialAction["Cascade"] = "cascade";
+    PgReferentialAction["SetNull"] = "set null";
+    PgReferentialAction["SetDefault"] = "set default";
+})(PgReferentialAction || (PgReferentialAction = {}));
+/**
+ * Postgres error codes the resource layer translates into framework errors. Sourced
+ * from the `pg` driver's `DatabaseError.code`.
+ */
+export var PgErrorCode;
+(function (PgErrorCode) {
+    PgErrorCode["UniqueViolation"] = "23505";
+    PgErrorCode["ForeignKeyViolation"] = "23503";
+    PgErrorCode["NotNullViolation"] = "23502";
+    PgErrorCode["CheckViolation"] = "23514";
+    PgErrorCode["UndefinedTable"] = "42P01";
+    PgErrorCode["UndefinedColumn"] = "42703";
+    PgErrorCode["DuplicateTable"] = "42P07";
+    PgErrorCode["DuplicateColumn"] = "42701";
+    PgErrorCode["DuplicateObject"] = "42710";
+    PgErrorCode["CannotCoerce"] = "42846";
+    PgErrorCode["DatatypeMismatch"] = "42804";
+    PgErrorCode["InvalidTextRepresentation"] = "22P02";
+    PgErrorCode["StringDataRightTruncation"] = "22001";
+    PgErrorCode["NumericValueOutOfRange"] = "22003";
+    PgErrorCode["SerializationFailure"] = "40001";
+    PgErrorCode["DeadlockDetected"] = "40P01";
+    PgErrorCode["NoActiveTransaction"] = "25001";
+})(PgErrorCode || (PgErrorCode = {}));
+/**
+ * Postgres reports scalar values of these types as strings to avoid precision loss.
+ * The marshaller converts them back using the resource's schema.
+ */
+export const STRING_RETURNING_TYPES = ['numeric', 'bigint', 'int8', 'decimal', 'money'];
+/** Built-in type OIDs the marshaller has to name to reach the driver's own parsers. */
+export var PgTypeOid;
+(function (PgTypeOid) {
+    PgTypeOid[PgTypeOid["Date"] = 1082] = "Date";
+    PgTypeOid[PgTypeOid["Timestamp"] = 1114] = "Timestamp";
+    PgTypeOid[PgTypeOid["TimestampTz"] = 1184] = "TimestampTz";
+})(PgTypeOid || (PgTypeOid = {}));
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAA;AAE1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAA;AAE1D,oEAAoE;AACpE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAA;AAE9B,8FAA8F;AAC9F,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAEnC,qFAAqF;AACrF,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAA;AAE5B,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAA;AAElC,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAA;AAEpC,sEAAsE;AACtE,MAAM,CAAC,MAAM,cAAc,GAAG,yBAAyB,CAAA;AAEvD;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,mCAAqB,CAAA;IACrB,yBAAW,CAAA;AACb,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AAED,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,8BAAa,CAAA;IACb,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,8BAAa,CAAA;IACb,kCAAiB,CAAA;AACnB,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB;AAED,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,6CAAsB,CAAA;IACtB,4CAAqB,CAAA;IACrB,0CAAmB,CAAA;IACnB,2CAAoB,CAAA;IACpB,iDAA0B,CAAA;AAC5B,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,WAkBX;AAlBD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,4CAA6B,CAAA;IAC7B,yCAA0B,CAAA;IAC1B,uCAAwB,CAAA;IACxB,uCAAwB,CAAA;IACxB,wCAAyB,CAAA;IACzB,uCAAwB,CAAA;IACxB,wCAAyB,CAAA;IACzB,wCAAyB,CAAA;IACzB,qCAAsB,CAAA;IACtB,yCAA0B,CAAA;IAC1B,kDAAmC,CAAA;IACnC,kDAAmC,CAAA;IACnC,+CAAgC,CAAA;IAChC,6CAA8B,CAAA;IAC9B,yCAA0B,CAAA;IAC1B,4CAA6B,CAAA;AAC/B,CAAC,EAlBW,WAAW,KAAX,WAAW,QAkBtB;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAU,CAAA;AAEhG,uFAAuF;AACvF,MAAM,CAAN,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,4CAAW,CAAA;IACX,sDAAgB,CAAA;IAChB,0DAAkB,CAAA;AACpB,CAAC,EAJW,SAAS,KAAT,SAAS,QAIpB"}

package/build/declarations.d.ts

@@ -0,0 +1,12 @@
+import type { MigrationRegistry } from '@owlmeans/resource';
+import type { AnySchema } from 'ajv';
+import type { PgIndexSpec, PostgresTx } from './types.js';
+export interface PostgresDeclaration {
+    schema?: AnySchema;
+    indexes: PgIndexSpec[];
+    migrations: MigrationRegistry<PostgresTx>;
+}
+export declare const getDeclaration: (alias: string) => PostgresDeclaration;
+/** Testing seam — drops every declaration so a spec can redeclare a resource from scratch. */
+export declare const resetDeclarations: (alias?: string) => void;
+//# sourceMappingURL=declarations.d.ts.map

package/build/declarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarations.d.ts","sourceRoot":"","sources":["../src/declarations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAEpC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,UAAU,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAA;CAC1C;AAaD,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,mBAQ9C,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,IAMlD,CAAA"}

package/build/declarations.js

@@ -0,0 +1,28 @@
+import { createMigrationRegistry } from '@owlmeans/resource';
+/**
+ * Per-alias declaration store, held at module scope rather than on the resource object.
+ *
+ * `reinitializeContext` rebuilds every resource, which drops anything a caller attached
+ * by chaining. Mongo lives with that by requiring the app to pass `makeCustomResource`
+ * and re-run the whole maker; migrations can't depend on that discipline, because losing
+ * one silently means a data transformation never runs. Keying the declarations by alias
+ * makes them survive any number of context switches.
+ */
+const declarations = new Map();
+export const getDeclaration = (alias) => {
+    let declaration = declarations.get(alias);
+    if (declaration == null) {
+        declaration = { indexes: [], migrations: createMigrationRegistry() };
+        declarations.set(alias, declaration);
+    }
+    return declaration;
+};
+/** Testing seam — drops every declaration so a spec can redeclare a resource from scratch. */
+export const resetDeclarations = (alias) => {
+    if (alias == null) {
+        declarations.clear();
+        return;
+    }
+    declarations.delete(alias);
+};
+//# sourceMappingURL=declarations.js.map

package/build/declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarations.js","sourceRoot":"","sources":["../src/declarations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAY5D;;;;;;;;GAQG;AACH,MAAM,YAAY,GAAqC,IAAI,GAAG,EAAE,CAAA;AAEhE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAuB,EAAE;IACnE,IAAI,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACzC,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,WAAW,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,uBAAuB,EAAc,EAAE,CAAA;QAChF,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;IACtC,CAAC;IAED,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAQ,EAAE;IACxD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,YAAY,CAAC,KAAK,EAAE,CAAA;QACpB,OAAM;IACR,CAAC;IACD,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC,CAAA"}

package/build/errors.d.ts

@@ -0,0 +1,70 @@
+import { ResourceError } from '@owlmeans/resource';
+export declare class PostgresError extends ResourceError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** Structure reconciliation failed. The message carries the offending statement. */
+export declare class PostgresSyncError extends PostgresError {
+    static typeName: string;
+    constructor(message: string);
+}
+/**
+ * Postgres refused to cast a column to its new type. Fix it with `pg: { using: '<expr>' }`
+ * on the property, or with a `pre` migration that performs the ALTER by hand — after
+ * which reconciliation sees no drift and emits nothing.
+ */
+export declare class PostgresCastRequired extends PostgresSyncError {
+    static typeName: string;
+    constructor(message: string);
+}
+export declare class PostgresConstraintError extends PostgresError {
+    static typeName: string;
+    constructor(message: string);
+}
+export declare class PostgresForeignKeyError extends PostgresConstraintError {
+    static typeName: string;
+    constructor(message: string);
+}
+export declare class PostgresCheckError extends PostgresConstraintError {
+    static typeName: string;
+    constructor(message: string);
+}
+/** Serialization failure or deadlock — the caller may retry the whole transaction. */
+export declare class PostgresDeadlockError extends PostgresError {
+    static typeName: string;
+    readonly retryable: boolean;
+    constructor(message: string);
+}
+/** A `{{alias}}` placeholder in custom SQL couldn't be resolved. */
+export declare class PostgresPlaceholderError extends PostgresError {
+    static typeName: string;
+    constructor(message: string);
+}
+export declare class PostgresConnectionError extends PostgresError {
+    static typeName: string;
+    constructor(message: string);
+}
+/** The least-privilege admin path failed. */
+export declare class PostgresBootstrapError extends PostgresError {
+    static typeName: string;
+    constructor(message: string);
+}
+/**
+ * The framework's error marshalling preserves only type, message and stack, so the
+ * Postgres diagnostics have to travel inside the message. Downstream tooling — notably
+ * the viable-agent fixer, which retries on `42P01` / `42703` — classifies on exactly
+ * this text, so the code always leads.
+ *
+ * `where` is deliberately never included: it can echo bound parameter values.
+ *
+ * Exported so a wrapper can quote the diagnostics without also quoting the translated error's
+ * own type prefix, which would nest one error vocabulary inside another's message.
+ */
+export declare const describePgError: (error: unknown) => string;
+/**
+ * Translate a raw `pg` driver error into the framework's error vocabulary, so a driver
+ * type never escapes the package. Errors that already are `ResilientError`s pass through
+ * untouched — the reconciler and the migration runner raise their own.
+ */
+export declare const pgErrorToResourceError: (error: unknown) => Error;
+//# sourceMappingURL=errors.d.ts.map

package/build/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAC0B,aAAa,EAC7C,MAAM,oBAAoB,CAAA;AAI3B,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAuB,QAAQ,SAA2C;gBAE9D,OAAO,GAAE,MAAgB;CAItC;AAED,oFAAoF;AACpF,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,OAAuB,QAAQ,SAAuC;gBAE1D,OAAO,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,OAAuB,QAAQ,SAA8C;gBAEjE,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,OAAuB,QAAQ,SAA6C;gBAEhE,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,uBAAwB,SAAQ,uBAAuB;IAClE,OAAuB,QAAQ,SAAkD;gBAErE,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,uBAAuB;IAC7D,OAAuB,QAAQ,SAA6C;gBAEhE,OAAO,EAAE,MAAM;CAI5B;AAED,sFAAsF;AACtF,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,OAAuB,QAAQ,SAA2C;IAE1E,SAAgB,SAAS,EAAE,OAAO,CAAO;gBAE7B,OAAO,EAAE,MAAM;CAI5B;AAED,oEAAoE;AACpE,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,OAAuB,QAAQ,SAA8C;gBAEjE,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,OAAuB,QAAQ,SAA6C;gBAEhE,OAAO,EAAE,MAAM;CAI5B;AAED,6CAA6C;AAC7C,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,OAAuB,QAAQ,SAA4C;gBAE/D,OAAO,EAAE,MAAM;CAI5B;AA0CD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,MAOhD,CAAA;AAeD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,KA4CvD,CAAA"}

package/build/errors.js

@@ -0,0 +1,201 @@
+import { ResilientError } from '@owlmeans/error';
+import { MisshapedRecord, RecordExists, ResourceError } from '@owlmeans/resource';
+import { PgErrorCode } from './consts.js';
+export class PostgresError extends ResourceError {
+    static typeName = `${ResourceError.typeName}PostgresError`;
+    constructor(message = 'error') {
+        super(`postgres:${message}`);
+        this.type = PostgresError.typeName;
+    }
+}
+/** Structure reconciliation failed. The message carries the offending statement. */
+export class PostgresSyncError extends PostgresError {
+    static typeName = `${PostgresError.typeName}SyncError`;
+    constructor(message) {
+        super(`sync:${message}`);
+        this.type = PostgresSyncError.typeName;
+    }
+}
+/**
+ * Postgres refused to cast a column to its new type. Fix it with `pg: { using: '<expr>' }`
+ * on the property, or with a `pre` migration that performs the ALTER by hand — after
+ * which reconciliation sees no drift and emits nothing.
+ */
+export class PostgresCastRequired extends PostgresSyncError {
+    static typeName = `${PostgresSyncError.typeName}CastRequired`;
+    constructor(message) {
+        super(`cast-required:${message}`);
+        this.type = PostgresCastRequired.typeName;
+    }
+}
+export class PostgresConstraintError extends PostgresError {
+    static typeName = `${PostgresError.typeName}ConstraintError`;
+    constructor(message) {
+        super(`constraint:${message}`);
+        this.type = PostgresConstraintError.typeName;
+    }
+}
+export class PostgresForeignKeyError extends PostgresConstraintError {
+    static typeName = `${PostgresConstraintError.typeName}ForeignKey`;
+    constructor(message) {
+        super(`foreign-key:${message}`);
+        this.type = PostgresForeignKeyError.typeName;
+    }
+}
+export class PostgresCheckError extends PostgresConstraintError {
+    static typeName = `${PostgresConstraintError.typeName}Check`;
+    constructor(message) {
+        super(`check:${message}`);
+        this.type = PostgresCheckError.typeName;
+    }
+}
+/** Serialization failure or deadlock — the caller may retry the whole transaction. */
+export class PostgresDeadlockError extends PostgresError {
+    static typeName = `${PostgresError.typeName}DeadlockError`;
+    retryable = true;
+    constructor(message) {
+        super(`deadlock:${message}`);
+        this.type = PostgresDeadlockError.typeName;
+    }
+}
+/** A `{{alias}}` placeholder in custom SQL couldn't be resolved. */
+export class PostgresPlaceholderError extends PostgresError {
+    static typeName = `${PostgresError.typeName}PlaceholderError`;
+    constructor(message) {
+        super(`placeholder:${message}`);
+        this.type = PostgresPlaceholderError.typeName;
+    }
+}
+export class PostgresConnectionError extends PostgresError {
+    static typeName = `${PostgresError.typeName}ConnectionError`;
+    constructor(message) {
+        super(`connection:${message}`);
+        this.type = PostgresConnectionError.typeName;
+    }
+}
+/** The least-privilege admin path failed. */
+export class PostgresBootstrapError extends PostgresError {
+    static typeName = `${PostgresError.typeName}BootstrapError`;
+    constructor(message) {
+        super(`bootstrap:${message}`);
+        this.type = PostgresBootstrapError.typeName;
+    }
+}
+const isDriverError = (error) => error != null && typeof error === 'object' && 'code' in error;
+/**
+ * Reach the `pg` error inside whatever wrapped it.
+ *
+ * Drizzle raises `DrizzleQueryError` and hangs the driver error off `cause`, so a unique
+ * violation arriving through the query builder carries no `code` at the top level. Reading
+ * only the outer error is what makes the whole vocabulary below collapse to one opaque
+ * class on every CRUD path — and it is exactly the paths that go through Drizzle.
+ *
+ * The walk is bounded because `cause` chains can be circular.
+ */
+const unwrap = (error) => {
+    let current = error;
+    for (let depth = 0; depth < 8; depth += 1) {
+        if (isDriverError(current)) {
+            return current;
+        }
+        const cause = current?.cause;
+        if (cause == null || cause === current) {
+            return error;
+        }
+        current = cause;
+    }
+    return error;
+};
+/**
+ * The framework's error marshalling preserves only type, message and stack, so the
+ * Postgres diagnostics have to travel inside the message. Downstream tooling — notably
+ * the viable-agent fixer, which retries on `42P01` / `42703` — classifies on exactly
+ * this text, so the code always leads.
+ *
+ * `where` is deliberately never included: it can echo bound parameter values.
+ *
+ * Exported so a wrapper can quote the diagnostics without also quoting the translated error's
+ * own type prefix, which would nest one error vocabulary inside another's message.
+ */
+export const describePgError = (error) => {
+    const driver = unwrap(error);
+    if (!isDriverError(driver)) {
+        return error instanceof Error ? error.message : `${error}`;
+    }
+    return describe(driver);
+};
+const describe = (error) => {
+    const parts = [error.code ?? 'unknown'];
+    if (error.message != null)
+        parts.push(error.message);
+    if (error.constraint != null)
+        parts.push(`constraint=${error.constraint}`);
+    if (error.table != null)
+        parts.push(`table=${error.table}`);
+    if (error.column != null)
+        parts.push(`column=${error.column}`);
+    if (error.detail != null)
+        parts.push(`detail=${error.detail}`);
+    if (error.hint != null)
+        parts.push(`hint=${error.hint}`);
+    if (error.severity != null)
+        parts.push(`severity=${error.severity}`);
+    return parts.join(' ');
+};
+/**
+ * Translate a raw `pg` driver error into the framework's error vocabulary, so a driver
+ * type never escapes the package. Errors that already are `ResilientError`s pass through
+ * untouched — the reconciler and the migration runner raise their own.
+ */
+export const pgErrorToResourceError = (error) => {
+    if (error instanceof ResilientError) {
+        return error;
+    }
+    const driver = unwrap(error);
+    if (!isDriverError(driver)) {
+        return error instanceof Error ? error : new PostgresError(`${error}`);
+    }
+    const message = describe(driver);
+    const produce = () => {
+        switch (driver.code) {
+            case PgErrorCode.UniqueViolation:
+                return new RecordExists(message);
+            case PgErrorCode.NotNullViolation:
+                return new MisshapedRecord(message);
+            case PgErrorCode.ForeignKeyViolation:
+                return new PostgresForeignKeyError(message);
+            case PgErrorCode.CheckViolation:
+                return new PostgresCheckError(message);
+            case PgErrorCode.DatatypeMismatch:
+            case PgErrorCode.CannotCoerce:
+                return new PostgresCastRequired(message);
+            case PgErrorCode.SerializationFailure:
+            case PgErrorCode.DeadlockDetected:
+                return new PostgresDeadlockError(message);
+            default:
+                break;
+        }
+        if (driver.code != null && driver.code.startsWith('08')) {
+            return new PostgresConnectionError(message);
+        }
+        if (driver.code != null && driver.code.startsWith('23')) {
+            return new PostgresConstraintError(message);
+        }
+        return new PostgresError(message);
+    };
+    const produced = produce();
+    /** The *original* error, wrapper and all — unwrapping is for classification, not for loss. */
+    produced.cause = error;
+    return produced;
+};
+ResilientError.registerErrorClass(PostgresError);
+ResilientError.registerErrorClass(PostgresSyncError);
+ResilientError.registerErrorClass(PostgresCastRequired);
+ResilientError.registerErrorClass(PostgresConstraintError);
+ResilientError.registerErrorClass(PostgresForeignKeyError);
+ResilientError.registerErrorClass(PostgresCheckError);
+ResilientError.registerErrorClass(PostgresDeadlockError);
+ResilientError.registerErrorClass(PostgresPlaceholderError);
+ResilientError.registerErrorClass(PostgresConnectionError);
+ResilientError.registerErrorClass(PostgresBootstrapError);
+//# sourceMappingURL=errors.js.map

package/build/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/build/helper.d.ts

@@ -0,0 +1,4 @@
+import type { AnySchema } from 'ajv';
+/** Properties marked `secure: true` — the fields `lock()`/`unlock()` operate on by default. */
+export declare const getSchemaSecureFeilds: (schema: AnySchema) => string[];
+//# sourceMappingURL=helper.d.ts.map

package/build/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,KAAK,CAAA;AAEpD,+FAA+F;AAC/F,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,KAAG,MAAM,EAGxC,CAAA"}

package/build/helper.js

@@ -0,0 +1,5 @@
+/** Properties marked `secure: true` — the fields `lock()`/`unlock()` operate on by default. */
+export const getSchemaSecureFeilds = (schema) => Object.entries(schema?.properties ?? {})
+    .filter(([, property]) => property.secure === true)
+    .map(([key]) => key);
+//# sourceMappingURL=helper.js.map

package/build/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAiB,EAAY,EAAE,CACnE,MAAM,CAAC,OAAO,CAAE,MAA8B,EAAE,UAAU,IAAI,EAAE,CAAC;KAC9D,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAE,QAAiC,CAAC,MAAM,KAAK,IAAI,CAAC;KAC5E,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA"}

package/build/index.d.ts

@@ -0,0 +1,8 @@
+export type * from './types.js';
+export * from './consts.js';
+export * from './declarations.js';
+export * from './errors.js';
+export * from './helper.js';
+export * from './resource.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA"}

package/build/index.js

@@ -0,0 +1,7 @@
+export * from './consts.js';
+export * from './declarations.js';
+export * from './errors.js';
+export * from './helper.js';
+export * from './resource.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA"}

package/build/resource.d.ts

@@ -0,0 +1,4 @@
+import type { ResourceMaker, ResourceRecord } from '@owlmeans/resource';
+import type { PostgresResource } from './types.js';
+export declare const makePostgresResource: <R extends ResourceRecord, T extends PostgresResource<R> = PostgresResource<R>>(alias: string, dbAlias?: string, serviceAlias?: string, makeCustomResource?: ResourceMaker<R, T>, tableName?: string) => T;
+//# sourceMappingURL=resource.d.ts.map

package/build/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACiB,aAAa,EAAE,cAAc,EACzD,MAAM,oBAAoB,CAAA;AAY3B,OAAO,KAAK,EAC8D,gBAAgB,EAEzF,MAAM,YAAY,CAAA;AA4BnB,eAAO,MAAM,oBAAoB,GAC/B,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,EAE7E,OAAO,MAAM,EAAE,UAAS,MAAyB,EAAE,eAAc,MAAyB,EAC1F,qBAAqB,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,MAAM,KAC3D,CAmdF,CAAA"}