@owlmeans/postgres-resource 0.1.18-rc.41 → 0.1.18-rc.43

package/README.md

@@ -13,7 +13,7 @@ SQL. Other stores fit other shapes:
 ## Installation
 
 ```bash
-bun add @owlmeans/postgres-resource@^0.1.18-rc.41 @owlmeans/postgres@^0.1.18-rc.43 pg
+bun add @owlmeans/postgres-resource@^0.1.18-rc.43 @owlmeans/postgres@^0.1.18-rc.45 pg
 ```
 
 `pg` and `ajv` are peer dependencies of this package. `@owlmeans/postgres` provides the connection
@@ -81,7 +81,7 @@ await projects.update({ ...record, title: 'Renamed' })                // replace
 
 `size` defaults to `DEFAULT_PAGE_SIZE` (100); `list(where, { size: 0 })` lifts the limit. `total`
 always describes the whole match, independently of the page. `entityId` is the organization's
-stable record id from `requireEntityKey(req)`, never a value read off the token.
+stable record id from `makeEntityScope(req).requireEntityKey()`, never a value read off the token.
 
 ### Schema to table
 
@@ -224,7 +224,7 @@ are `@>`/`<@`/`&&` on array columns.
 `PostgresError` and its subclasses are `PostgresSyncError`, `PostgresCastRequired`,
 `PostgresConstraintError`, `PostgresForeignKeyError`, `PostgresCheckError`, `PostgresDeadlockError`
 (`retryable`), `PostgresPlaceholderError`, `PostgresConnectionError` and `PostgresBootstrapError`.
-Driver errors are translated by `pgErrorToResourceError`, which unwraps Drizzle's
+Driver errors are translated by `pgErrorHelper.pgErrorToResourceError`, which unwraps Drizzle's
 `DrizzleQueryError` to reach the `pg` error underneath and preserves the raw
 `code`/`detail`/`hint`/`severity` in the message. Unique violations surface as `RecordExists` and
 not-null violations as `MisshapedRecord`.
@@ -240,17 +240,17 @@ not-null violations as `MisshapedRecord`.
 | `PgPropertyOverride`, `PgRootOverride`, `PgIndexSpec`, `PgUniqueSpec`, `PgCheckSpec`, `PgReferenceSpec` | type | The `pg:` vocabulary and `index()` spec |
 | `LiveTable`, `LiveColumn`, `LiveIndex`, `LiveConstraint`, `DdlPlan`, `DdlStatement`, `DdlKind` | type | Introspection results and the reconciliation plan |
 | `pgKeyword` | const | `{ keyword: 'pg', valid: true }` for AJV strict mode |
-| `schemaToTableSpec`, `toFormatType` | function | The schema compiler |
-| `criteriaToSql`, `sortToSql` | function | `Criteria<T>` to a WHERE clause and `Sort<T>` to ORDER BY over the same table |
-| `refOf`, `resolvePlaceholders`, `resetPlaceholderCache`, `PlaceholderContext` | function / type | `{{alias}}` resolution, identifiers only |
-| `pgTableName`, `pgIdentifier`, `assertSqlIdentifier`, `quoteIdent`, `quoteLiteral`, `qualify`, `advisoryKey` | function | Identifier helpers |
-| `rowToRecord`, `resultToRecord`, `recordToValues`, `recordToFullValues`, `specToTable` | function | Row and record marshalling, Drizzle table construction |
-| `initializeTable`, `applyForeignKeys`, `TableInit` | function / type | The `init()` lifecycle |
-| `introspectTable`, `countNonNull`, `planSync`, `planForeignKeys`, `applyPlan`, `ensureSchema`, `acquireLock`, `releaseLock` | function | Reconciliation machinery |
+| `pgSchemaHelper` (`PgSchemaHelper`) | helper | The schema compiler: `schemaToTableSpec`, `toFormatType` |
+| `pgCriteriaHelper` (`PgCriteriaHelper`) | helper | `criteriaToSql` — `Criteria<T>` to a WHERE clause; `sortToSql` — `Sort<T>` to ORDER BY over the same table |
+| `pgPlaceholdersOf(context)` (`makePgPlaceholderHelper`, `PgPlaceholderHelper`), `resetPlaceholderCache`, `PlaceholderContext` | helper / function / type | `{{alias}}` resolution through one context — `refOf(self, alias?)`, `resolvePlaceholders(text, self)` — identifiers only |
+| `pgNameHelper` (`PgNameHelper`) | helper | Identifier helpers: `pgTableName`, `pgIdentifier`, `assertSqlIdentifier`, `quoteIdent`, `quoteLiteral`, `qualify`, `advisoryKey` |
+| `pgMarshalHelper` (`PgMarshalHelper`), `specToTable` | helper / function | Row and record marshalling (`rowToRecord`, `resultToRecord`, `recordToValues`, `recordToFullValues`), Drizzle table construction |
+| `makePgLifeCycleHelper(db)` (`PgLifeCycleHelper`), `TableInit` | helper / type | The `init()` lifecycle: `initializeTable`, `applyForeignKeys` |
+| `makePgIntrospectHelper(client)`, `makePgSyncHelper(client)`, `pgDiffHelper` | helper | Reconciliation machinery: `introspectTable`, `countNonNull`; `acquireLock`, `releaseLock`, `ensureSchema`, `applyPlan`; `planSync`, `planForeignKeys`, `canonicalDefinition` |
 | `makeTx`, `makeMigrationStore` | function | The migration façade and ledger |
-| `getDeclaration`, `resetDeclarations`, `PostgresDeclaration` | function / type | Module-scope declarations per alias; `resetDeclarations` is the testing seam |
+| `pgDeclarationHelper` (`PgDeclarationHelper`), `PostgresDeclaration` | helper / type | Module-scope declarations per alias: `getDeclaration`, and `resetDeclarations` — the testing seam |
 | `getSchemaSecureFeilds` | function | `secure: true` properties used by `lock`/`unlock` |
-| `pgErrorToResourceError`, `describePgError`, `PostgresError` family | function / class | Driver error translation |
+| `pgErrorHelper` (`PgErrorHelper`), `PostgresError` family | helper / class | Driver error translation: `pgErrorToResourceError`, `describePgError` |
 | `DEFAULT_DB_ALIAS`, `DEFAULT_PAGE_SIZE`, `DEF_MIGRATIONS_TABLE` | const | `'postgres'`, `100`, `'_owlmeans_migrations'` |
 | `PG_KEYWORD`, `PG_MAX_IDENTIFIER`, `ID_FIELD`, `DEF_SQL_TYPE`, `DEF_JSON_TYPE`, `DEF_ID_DEFAULT`, `STRING_RETURNING_TYPES` | const | Compiler constants |
 | `PgAutoSync`, `PgIndexMethod`, `PgReferentialAction`, `PgErrorCode`, `PgTypeOid` | enum | Reconciliation policy, index methods, FK actions, driver codes, type OIDs |
@@ -293,7 +293,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.46
+npx @owlmeans/agent-skills@^0.1.18-rc.49
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/postgres-resource",
-  "version": "0.1.18-rc.41",
-  "generatedAt": "2026-10-03T15:33:53.022Z",
+  "version": "0.1.18-rc.43",
+  "generatedAt": "2026-10-05T21:03:06.396Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/postgres-resource/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/postgres-resource
 
 **Layer:** Infra
-**Install:** `"@owlmeans/postgres-resource": "^0.1.18-rc.41"` in `dependencies` (peers `pg`, `ajv`)
+**Install:** `"@owlmeans/postgres-resource": "^0.1.18-rc.43"` in `dependencies` (peers `pg`, `ajv`)
 
 The Postgres counterpart of [[mongo-resource]]. The difference that governs everything else: a
 Mongo collection has no structure, a Postgres table does — so **the resource layer owns the DDL**
@@ -100,7 +100,7 @@ declaration sites merge into one `TableSpec` — the schema root, a per-property
 not an error. Two entries under one name would emit the same `CREATE INDEX` twice in a single DDL
 transaction, and Postgres answers the second with `42P07`, rolling back the plan that created the
 table: the resource then fails every boot with an error naming an index that does not exist.
-The compiler collapses the duplicates itself, keeps the first declaration and warns on the console.
+The compiler collapses the duplicates itself, keeps the first declaration and logs a warning.
 
 ## Reconciliation is authoritative — `PgAutoSync`
 

package/build/consts.d.ts

@@ -15,6 +15,15 @@ export declare const DEFAULT_PAGE_SIZE = 100;
 export declare const DEF_MIGRATIONS_TABLE = "_owlmeans_migrations";
 /** JSON Schema keyword carrying the Postgres specific overrides. */
 export declare const PG_KEYWORD = "pg";
+/**
+ * AJV keyword registration for consumers running in strict mode. The mapper reads the raw
+ * schema object and never validates through AJV, so this is purely to stop strict mode
+ * rejecting a schema that carries `pg` overrides.
+ */
+export declare const pgKeyword: {
+    keyword: string;
+    valid: boolean;
+};
 /** Postgres `NAMEDATALEN - 1`. Identifiers past this are silently truncated by the server. */
 export declare const PG_MAX_IDENTIFIER = 63;
 /** Property name that carries the record identity across every OwlMeans resource. */

package/build/consts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAA;AAEpC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,yBAAyB,CAAA;AAE1D,oEAAoE;AACpE,eAAO,MAAM,UAAU,OAAO,CAAA;AAE9B,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,qFAAqF;AACrF,eAAO,MAAM,QAAQ,OAAO,CAAA;AAE5B,iFAAiF;AACjF,eAAO,MAAM,YAAY,SAAS,CAAA;AAElC,eAAO,MAAM,aAAa,UAAU,CAAA;AAEpC,sEAAsE;AACtE,eAAO,MAAM,cAAc,4BAA4B,CAAA;AAEvD;;;;;;GAMG;AACH,oBAAY,UAAU;IACpB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,GAAG,QAAQ;CACZ;AAED,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED,oBAAY,mBAAmB;IAC7B,QAAQ,cAAc;IACtB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,OAAO,aAAa;IACpB,UAAU,gBAAgB;CAC3B;AAED;;;GAGG;AACH,oBAAY,WAAW;IACrB,eAAe,UAAU;IACzB,mBAAmB,UAAU;IAC7B,gBAAgB,UAAU;IAC1B,cAAc,UAAU;IACxB,cAAc,UAAU;IACxB,eAAe,UAAU;IACzB,cAAc,UAAU;IACxB,eAAe,UAAU;IACzB,eAAe,UAAU;IACzB,YAAY,UAAU;IACtB,gBAAgB,UAAU;IAC1B,yBAAyB,UAAU;IACnC,yBAAyB,UAAU;IACnC,sBAAsB,UAAU;IAChC,oBAAoB,UAAU;IAC9B,gBAAgB,UAAU;IAC1B,mBAAmB,UAAU;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,YAAI,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAU,CAAA;AAEhG,uFAAuF;AACvF,oBAAY,SAAS;IACnB,IAAI,OAAO;IACX,SAAS,OAAO;IAChB,WAAW,OAAO;CACnB"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAA;AAEpC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,yBAAyB,CAAA;AAE1D,oEAAoE;AACpE,eAAO,MAAM,UAAU,OAAO,CAAA;AAE9B;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;CAAuC,CAAA;AAE7D,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,qFAAqF;AACrF,eAAO,MAAM,QAAQ,OAAO,CAAA;AAE5B,iFAAiF;AACjF,eAAO,MAAM,YAAY,SAAS,CAAA;AAElC,eAAO,MAAM,aAAa,UAAU,CAAA;AAEpC,sEAAsE;AACtE,eAAO,MAAM,cAAc,4BAA4B,CAAA;AAEvD;;;;;;GAMG;AACH,oBAAY,UAAU;IACpB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,GAAG,QAAQ;CACZ;AAED,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED,oBAAY,mBAAmB;IAC7B,QAAQ,cAAc;IACtB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,OAAO,aAAa;IACpB,UAAU,gBAAgB;CAC3B;AAED;;;GAGG;AACH,oBAAY,WAAW;IACrB,eAAe,UAAU;IACzB,mBAAmB,UAAU;IAC7B,gBAAgB,UAAU;IAC1B,cAAc,UAAU;IACxB,cAAc,UAAU;IACxB,eAAe,UAAU;IACzB,cAAc,UAAU;IACxB,eAAe,UAAU;IACzB,eAAe,UAAU;IACzB,YAAY,UAAU;IACtB,gBAAgB,UAAU;IAC1B,yBAAyB,UAAU;IACnC,yBAAyB,UAAU;IACnC,sBAAsB,UAAU;IAChC,oBAAoB,UAAU;IAC9B,gBAAgB,UAAU;IAC1B,mBAAmB,UAAU;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,YAAI,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAU,CAAA;AAEhG,uFAAuF;AACvF,oBAAY,SAAS;IACnB,IAAI,OAAO;IACX,SAAS,OAAO;IAChB,WAAW,OAAO;CACnB"}

package/build/consts.js

@@ -15,6 +15,12 @@ export const DEFAULT_PAGE_SIZE = 100;
 export const DEF_MIGRATIONS_TABLE = '_owlmeans_migrations';
 /** JSON Schema keyword carrying the Postgres specific overrides. */
 export const PG_KEYWORD = 'pg';
+/**
+ * AJV keyword registration for consumers running in strict mode. The mapper reads the raw
+ * schema object and never validates through AJV, so this is purely to stop strict mode
+ * rejecting a schema that carries `pg` overrides.
+ */
+export const pgKeyword = { keyword: PG_KEYWORD, valid: true };
 /** 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. */

package/build/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAEpC;;;;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"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAA;AAE1D,oEAAoE;AACpE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAA;AAE9B;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AAE7D,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/types.d.ts

@@ -0,0 +1,12 @@
+import type { PostgresDeclaration } from '../types.js';
+/**
+ * The per-alias declaration store every postgres resource maker reads and extends — schema,
+ * indexes and migrations, keyed by resource alias.
+ */
+export interface PgDeclarationHelper {
+    /** The declaration of an alias, created empty on first use. */
+    getDeclaration: (alias: string) => PostgresDeclaration;
+    /** Testing seam — drops every declaration so a spec can redeclare a resource from scratch. */
+    resetDeclarations: (alias?: string) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/declarations/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/declarations/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,mBAAmB,CAAA;IACtD,8FAA8F;IAC9F,iBAAiB,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5C"}

package/build/declarations/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/declarations/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/declarations/types.ts"],"names":[],"mappings":""}

package/build/declarations.d.ts

@@ -1,12 +1,9 @@
-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>;
-}
+import type { PgDeclarationHelper } from './declarations/types.js';
+import type { PostgresDeclaration } from './types.js';
+export declare const createPgDeclarationHelper: () => PgDeclarationHelper;
+export declare const pgDeclarationHelper: PgDeclarationHelper;
+/** @deprecated compat:factory-refactor — use `pgDeclarationHelper.getDeclaration(…)` */
 export declare const getDeclaration: (alias: string) => PostgresDeclaration;
-/** Testing seam — drops every declaration so a spec can redeclare a resource from scratch. */
+/** @deprecated compat:factory-refactor — use `pgDeclarationHelper.resetDeclarations(…)` */
 export declare const resetDeclarations: (alias?: string) => void;
 //# sourceMappingURL=declarations.d.ts.map

package/build/declarations.d.ts.map

@@ -1 +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,UAAW,MAAM,KAAG,mBAQ9C,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,WAAY,MAAM,KAAG,IAMlD,CAAA"}
+{"version":3,"file":"declarations.d.ts","sourceRoot":"","sources":["../src/declarations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,KAAK,EAAc,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAgBjE,eAAO,MAAM,yBAAyB,QAAO,mBAoB5C,CAAA;AAED,eAAO,MAAM,mBAAmB,qBAA8B,CAAA;AAE9D,wFAAwF;AACxF,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,mBAAgE,CAAA;AAE/G,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,WAAY,MAAM,KAAG,IAAoD,CAAA"}

package/build/declarations.js

@@ -7,22 +7,32 @@ import { createMigrationRegistry } from '@owlmeans/resource';
  * a no-op: every run reads and extends the same schema, indexes and migrations, so nothing a
  * caller chained onto an earlier resource object is lost. Losing a migration is silent — the
  * data transformation simply never runs — which is why the store cannot live on the object.
+ *
+ * Process-wide for the same reason: it stays outside the factory, so every helper built from it
+ * reads the one store.
  */
 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);
+export const createPgDeclarationHelper = () => {
+    const getDeclaration = (alias) => {
+        let declaration = declarations.get(alias);
+        if (declaration == null) {
+            declaration = { indexes: [], migrations: createMigrationRegistry() };
+            declarations.set(alias, declaration);
+        }
+        return declaration;
+    };
+    const resetDeclarations = (alias) => {
+        if (alias == null) {
+            declarations.clear();
+            return;
+        }
+        declarations.delete(alias);
+    };
+    return { getDeclaration, resetDeclarations };
 };
+export const pgDeclarationHelper = createPgDeclarationHelper();
+/** @deprecated compat:factory-refactor — use `pgDeclarationHelper.getDeclaration(…)` */
+export const getDeclaration = (alias) => pgDeclarationHelper.getDeclaration(alias);
+/** @deprecated compat:factory-refactor — use `pgDeclarationHelper.resetDeclarations(…)` */
+export const resetDeclarations = (alias) => pgDeclarationHelper.resetDeclarations(alias);
 //# sourceMappingURL=declarations.js.map

package/build/declarations.js.map

@@ -1 +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"}
+{"version":3,"file":"declarations.js","sourceRoot":"","sources":["../src/declarations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAK5D;;;;;;;;;;;GAWG;AACH,MAAM,YAAY,GAAqC,IAAI,GAAG,EAAE,CAAA;AAEhE,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAwB,EAAE;IACjE,MAAM,cAAc,GAAG,CAAC,KAAa,EAAuB,EAAE;QAC5D,IAAI,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACzC,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;YACxB,WAAW,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,uBAAuB,EAAc,EAAE,CAAA;YAChF,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QACtC,CAAC;QAED,OAAO,WAAW,CAAA;IACpB,CAAC,CAAA;IAED,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAQ,EAAE;QACjD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,YAAY,CAAC,KAAK,EAAE,CAAA;YACpB,OAAM;QACR,CAAC;QACD,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC5B,CAAC,CAAA;IAED,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAA;AAC9C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,EAAE,CAAA;AAE9D,wFAAwF;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAuB,EAAE,CAAC,mBAAmB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;AAE/G,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAQ,EAAE,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAA"}

package/build/errors.d.ts

@@ -49,24 +49,4 @@ 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.
- * A migration may supply its resolved SQL; placeholders stay intact and parameter values
- * are never added. The statement travels in the message so error marshalling preserves it.
- */
-export declare const pgErrorToResourceError: (error: unknown, query?: string) => Error;
 //# sourceMappingURL=errors.d.ts.map

package/build/errors.d.ts.map

@@ -1 +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;IAE1E,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,oFAAoF;AACpF,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,OAAuB,QAAQ,SAAuC;IAEtE,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,OAAuB,QAAQ,SAA8C;IAE7E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,OAAuB,QAAQ,SAA6C;IAE5E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,uBAAwB,SAAQ,uBAAuB;IAClE,OAAuB,QAAQ,SAAkD;IAEjF,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,kBAAmB,SAAQ,uBAAuB;IAC7D,OAAuB,QAAQ,SAA6C;IAE5E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,sFAAsF;AACtF,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,OAAuB,QAAQ,SAA2C;IAE1E,SAAgB,SAAS,EAAE,OAAO,CAAO;IAEzC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,oEAAoE;AACpE,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,OAAuB,QAAQ,SAA8C;IAE7E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,OAAuB,QAAQ,SAA6C;IAE5E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,6CAA6C;AAC7C,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,OAAuB,QAAQ,SAA4C;IAE3E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AA0CD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,UAAW,OAAO,KAAG,MAOhD,CAAA;AAeD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,UAAW,OAAO,UAAU,MAAM,KAAG,KA4CvE,CAAA"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAuB,QAAQ,SAA2C;IAE1E,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,oFAAoF;AACpF,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,OAAuB,QAAQ,SAAuC;IAEtE,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,OAAuB,QAAQ,SAA8C;IAE7E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,OAAuB,QAAQ,SAA6C;IAE5E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,uBAAwB,SAAQ,uBAAuB;IAClE,OAAuB,QAAQ,SAAkD;IAEjF,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,kBAAmB,SAAQ,uBAAuB;IAC7D,OAAuB,QAAQ,SAA6C;IAE5E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,sFAAsF;AACtF,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,OAAuB,QAAQ,SAA2C;IAE1E,SAAgB,SAAS,EAAE,OAAO,CAAO;IAEzC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,oEAAoE;AACpE,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,OAAuB,QAAQ,SAA8C;IAE7E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,OAAuB,QAAQ,SAA6C;IAE5E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,6CAA6C;AAC7C,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,OAAuB,QAAQ,SAA4C;IAE3E,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}

package/build/errors.js

@@ -1,6 +1,5 @@
 import { ResilientError } from '@owlmeans/error';
-import { MisshapedRecord, RecordExists, ResourceError } from '@owlmeans/resource';
-import { PgErrorCode } from './consts.js';
+import { ResourceError } from '@owlmeans/resource';
 export class PostgresError extends ResourceError {
     static typeName = `${ResourceError.typeName}PostgresError`;
     constructor(message = 'error') {
@@ -81,115 +80,6 @@ export class PostgresBootstrapError extends PostgresError {
         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.
- * A migration may supply its resolved SQL; placeholders stay intact and parameter values
- * are never added. The statement travels in the message so error marshalling preserves it.
- */
-export const pgErrorToResourceError = (error, query) => {
-    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) + (query == null ? '' : `\nSQL: ${query}`);
-    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);

package/build/errors.js.map

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

package/build/index.d.ts

@@ -1,7 +1,10 @@
 export type * from './types.js';
 export * from './consts.js';
 export * from './declarations.js';
+export type * from './declarations/types.js';
 export * from './errors.js';
+export * from './pg-error.js';
+export type * from './pg-error/types.js';
 export * from './helper.js';
 export * from './resource.js';
 export * from './utils/index.js';

package/build/index.d.ts.map

@@ -1 +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"}
+{"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,mBAAmB,yBAAyB,CAAA;AAC5C,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,mBAAmB,qBAAqB,CAAA;AACxC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA"}

package/build/index.js

@@ -1,6 +1,7 @@
 export * from './consts.js';
 export * from './declarations.js';
 export * from './errors.js';
+export * from './pg-error.js';
 export * from './helper.js';
 export * from './resource.js';
 export * from './utils/index.js';

package/build/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AAEjC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAE7B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA"}

package/build/pg-error/types.d.ts

@@ -0,0 +1,24 @@
+/** Reading and translating the errors the `pg` driver raises. */
+export interface PgErrorHelper {
+    /**
+     * 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.
+     */
+    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.
+     * A migration may supply its resolved SQL; placeholders stay intact and parameter values
+     * are never added. The statement travels in the message so error marshalling preserves it.
+     */
+    pgErrorToResourceError: (error: unknown, query?: string) => Error;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/pg-error/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pg-error/types.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;OAUG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IAC3C;;;;;;OAMG;IACH,sBAAsB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,KAAK,CAAA;CAClE"}

package/build/pg-error/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/pg-error/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pg-error/types.ts"],"names":[],"mappings":""}

package/build/pg-error.d.ts

@@ -0,0 +1,4 @@
+import type { PgErrorHelper } from './pg-error/types.js';
+export declare const createPgErrorHelper: () => PgErrorHelper;
+export declare const pgErrorHelper: PgErrorHelper;
+//# sourceMappingURL=pg-error.d.ts.map

package/build/pg-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-error.d.ts","sourceRoot":"","sources":["../src/pg-error.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGxD,eAAO,MAAM,mBAAmB,QAAO,aAmGtC,CAAA;AAED,eAAO,MAAM,aAAa,eAAwB,CAAA"}

package/build/pg-error.js

@@ -0,0 +1,100 @@
+import { ResilientError } from '@owlmeans/error';
+import { MisshapedRecord, RecordExists } from '@owlmeans/resource';
+import { PgErrorCode } from './consts.js';
+import { PostgresCastRequired, PostgresCheckError, PostgresConnectionError, PostgresConstraintError, PostgresDeadlockError, PostgresError, PostgresForeignKeyError } from './errors.js';
+export const createPgErrorHelper = () => {
+    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;
+    };
+    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(' ');
+    };
+    const pgErrorToResourceError = (error, query) => {
+        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) + (query == null ? '' : `\nSQL: ${query}`);
+        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;
+    };
+    return { describePgError, pgErrorToResourceError };
+};
+export const pgErrorHelper = createPgErrorHelper();
+//# sourceMappingURL=pg-error.js.map