@owlmeans/postgres-resource 0.1.18-rc.2 → 0.1.18-rc.21

package/README.md

@@ -5,7 +5,7 @@ code-registered migrations, and custom SQL with resource-alias placeholders.
 
 ## Overview
 
-- `makePostgresResource<R, T>(alias, dbAlias?, serviceAlias?, maker?, tableName?)` — factory for Postgres resources
+- `makePostgresResource<R, T>(alias, dbAlias?, serviceAlias?, tableName?)` — factory for Postgres resources
 - `PostgresResource<T>` — extends `Resource<T>` with a Drizzle table, custom SQL, transactions, and field encryption
 - The resource's **AJV schema is the single source of truth for the table structure** — columns, types,
   nullability, defaults, primary key and indexes are all derived from it
@@ -16,7 +16,7 @@ code-registered migrations, and custom SQL with resource-alias placeholders.
 ## Installation
 
 ```bash
-bun add @owlmeans/postgres-resource @owlmeans/postgres pg
+bun add @owlmeans/postgres-resource@^0.1.18-rc.12 @owlmeans/postgres@^0.1.18-rc.13 pg
 ```
 
 `pg` and `ajv` are peer dependencies of this package. `@owlmeans/postgres` provides the connection
@@ -35,7 +35,7 @@ export interface ProjectResource extends PostgresResource<ProjectRecord> {}
 
 export const makeProjectResource: ResourceMaker<ProjectRecord, ProjectResource> = (dbAlias, serviceAlias) => {
   const resource = makePostgresResource<ProjectRecord, ProjectResource>(
-    RES_PROJECT, dbAlias, serviceAlias, makeProjectResource
+    RES_PROJECT, dbAlias, serviceAlias
   )
   resource.schema = ProjectSchema
   resource.index('idx_project_entity', { columns: ['entityId'] })
@@ -55,9 +55,17 @@ Use in a handler:
 ```typescript
 const projects = context.resource<ProjectResource>(RES_PROJECT)
 const record = await projects.create({ entityId, alias, title })
-const list = await projects.list({ criteria: { entityId } })
+
+const one = await projects.load({ entityId, alias })                  // null when absent
+const { items, total } = await projects.list(
+  { entityId, status: ['draft', 'active'] },                          // an array means "any of these"
+  { page: 0, size: 20, sort: [{ field: 'createdAt', order: 'desc' }] }
+)
 ```
 
+`size` defaults to `DEFAULT_PAGE_SIZE` (100); `list(where, { size: 0 })` lifts the limit. `total`
+always describes the whole match, independently of the page.
+
 ### Schema → table
 
 ```typescript
@@ -150,7 +158,7 @@ substituted blindly.
 
 ## API
 
-### `makePostgresResource<R, T>(alias, dbAlias?, serviceAlias?, maker?, tableName?): T`
+### `makePostgresResource<R, T>(alias, dbAlias?, serviceAlias?, tableName?): T`
 
 Creates a Postgres resource. `dbAlias` and `serviceAlias` default to `DEFAULT_DB_ALIAS`
 (`'postgres'`). `tableName` overrides the physical table name, which otherwise derives from the alias.
@@ -162,21 +170,28 @@ Extends `Resource<T>` with:
 - `schema?: AnySchema` — the source of truth for the table structure
 - `table: TableSpec` / `entity: PgRuntimeTable` — the compiled spec and the runtime Drizzle table
 - `db(): Promise<PostgresDb>` / `client(): Promise<Pool>`
-- `index(name, spec): this` / `migration(name, apply, stage?): this` — chainable declarations
+- `index(name, spec)` / `migration(name, apply, stage?)` — chainable declarations
 - `query` / `queryOne` / `execute` — raw rows and affected counts
 - `select` / `selectOne` — rows marshalled back into `T`
 - `ref(alias?): string` — fully qualified identifier of this or another resource
 - `transaction(fn)` — a `PostgresTx` with the same placeholder-aware helpers
-- `insert` / `upsert` / `patch` / `purge` / `count` — beyond the base contract
+- `insert` / `upsert` / `patch` — beyond the base contract
 - `lock(record, fields?)` / `unlock(record, fields?)` — encrypt/decrypt `secure` fields
 - `getDefaults(): Partial<T>`
 
+Type the resource once, where it is resolved — `context.resource<PostgresResource<Project>>(alias)` —
+rather than passing a record type per method call.
+
 ### `Resource<T>` methods (all implemented)
 
-`get`, `load`, `create`, `update`, `save`, `delete`, `pick`, `list`
+`get`, `load`, `list`, `count`, `create`, `update`, `save`, `delete`, `take`, `purge`
 
-`create` refuses a caller-supplied id (use `insert`); `update` replaces the whole record (use `patch`
-to merge); `pick` deletes the record it returns, atomically.
+`get` and `load` take either an id or a `Criteria<T>` (with an optional `sort`), so reading one
+record by several fields is a single call. `create` refuses a caller-supplied id (use `insert`);
+`update` replaces the whole record (use `patch` to merge); `take` deletes the record it returns,
+atomically, and raises when there is nothing to take where `delete` answers `null`; `purge` refuses
+an empty criteria rather than emptying the table. Every write option is rejected here except
+absence: `ttl` raises `UnsupportedArgumentError`, since Postgres has no row expiry.
 
 ### Errors
 
@@ -190,7 +205,7 @@ surface as `RecordExists` and not-null violations as `MisshapedRecord`.
 ### Constants
 
 - `DEFAULT_DB_ALIAS` — `'postgres'`
-- `DEFAULT_PAGE_SIZE` — `10`
+- `DEFAULT_PAGE_SIZE` — `100`, the cap `list()` applies when no `size` is named
 - `DEF_MIGRATIONS_TABLE` — `'_owlmeans_migrations'`
 - `PG_KEYWORD` — `'pg'`; `PG_MAX_IDENTIFIER` — `63`
 - `PgAutoSync`, `PgIndexMethod`, `PgReferentialAction`, `PgErrorCode`
@@ -209,7 +224,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
+npx @owlmeans/agent-skills@^0.1.18-rc.20
 ```
 
 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.0",
-  "generatedAt": "2026-08-16T22:20:50.509Z",
+  "version": "0.1.18-rc.21",
+  "generatedAt": "2026-09-12T14:21:25.465Z",
   "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.0"` in `dependencies` (peers `pg`, `ajv`)
+**Install:** `"@owlmeans/postgres-resource": "^0.1.18-rc.21"` 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**
@@ -18,15 +18,18 @@ and derives it from the resource's AJV schema.
 
 | Export | Description |
 |--------|-------------|
-| `makePostgresResource<R, T>(alias, dbAlias?, serviceAlias?, maker?, tableName?)` | The resource factory. Aliases default to `DEFAULT_DB_ALIAS` (`'postgres'`). |
-| `PostgresResource<T>` | `Resource<T>` + `table`/`entity`, custom SQL, transactions, `insert`/`upsert`/`patch`/`purge`/`count`, `lock`/`unlock`. |
-| `PostgresDbService`, `PostgresDb`, `PostgresTx` | Service contract implemented by `@owlmeans/postgres`; the db handle `{ drizzle, pool, schema, database }`; the transaction façade. |
+| `makePostgresResource<R, T>(alias, dbAlias?, serviceAlias?, tableName?)` | The resource factory. Aliases default to `DEFAULT_DB_ALIAS` (`'postgres'`); `tableName` overrides the physical table (else the sanitized alias). |
+| `PostgresResource<T>` | `Resource<T>` + `table`/`entity`, `db()`/`client()`, `index`, `ref`, `getDefaults`, custom SQL (`query`/`queryOne`/`execute`/`select`/`selectOne`), `transaction`, `insert`/`upsert`/`patch`, `lock`/`unlock`, `migration`/`migrations`. |
+| `PostgresDbService`, `PostgresDb`, `PostgresTx` | Service contract implemented by `@owlmeans/postgres`; the db handle `{ drizzle, pool, schema, database }`; the transaction façade (`client`, `query`/`queryOne`/`execute`, `ref`). |
+| `PostgresMeta` | The `DbConfig.meta` shape this package reads — `database`, `autoSync`, `url`, and the pool/probe knobs. |
 | `TableSpec`, `ColumnSpec`, `PgPropertyOverride`, `PgRootOverride`, `DdlPlan` | The compiled table description and the `pg:` vocabulary types. |
+| `PgIndexSpec`, `PgUniqueSpec`, `PgCheckSpec`, `PgReferenceSpec` | What `resource.index()` and the `pg:` overrides are written with. |
+| `criteriaToSql`, `sortToSql` | `Criteria<T>` → a WHERE clause and `Sort<T>` → the ORDER BY, for code that builds its own statement over the same table. |
 | `pgKeyword` | `{ keyword: 'pg', valid: true }` — register it when running AJV in strict mode. |
 | `schemaToTableSpec`, `pgTableName`, `pgIdentifier`, `quoteIdent`, `qualify`, `advisoryKey` | The compiler and identifier helpers. |
 | `refOf`, `resolvePlaceholders` | `{{alias}}` resolution — identifiers only. |
 | `PostgresError` family, `pgErrorToResourceError`, `describePgError` | Driver-error translation. |
-| `getDeclaration`, `resetDeclarations` | Module-scope index/migration declarations, keyed by alias. |
+| `getDeclaration`, `resetDeclarations` | Module-scope schema/index/migration declarations, keyed by alias. |
 | `DEFAULT_DB_ALIAS`, `DEFAULT_PAGE_SIZE`, `DEF_MIGRATIONS_TABLE`, `PgAutoSync`, `PgIndexMethod`, `PgReferentialAction`, `PgErrorCode` | Constants. |
 
 ## The schema is the table — never write DDL
@@ -34,7 +37,7 @@ and derives it from the resource's AJV schema.
 ```typescript
 export const makeProjectResource: ResourceMaker<ProjectRecord, ProjectResource> = (dbAlias, serviceAlias) => {
   const resource = makePostgresResource<ProjectRecord, ProjectResource>(
-    RES_PROJECT, dbAlias, serviceAlias, makeProjectResource
+    RES_PROJECT, dbAlias, serviceAlias
   )
   resource.schema = ProjectSchema
   resource.index('idx_project_entity', { columns: ['entityId'] })
@@ -48,12 +51,18 @@ Never call `pgTable`/`pgSchema`, never call `drizzle()`, never run `drizzle-kit`
 `CREATE TABLE`. Two owners of the same DDL is the failure mode this package exists to remove:
 reconciliation would drop what the other owner added.
 
+`schema`, `index()` and `migration()` all land in the module-scope declaration for the alias rather
+than on the resource object, so a maker that runs more than once for the same alias — a custom
+maker wrapping the built-in one, a spec calling it again — reads and extends the same declaration
+instead of starting a fresh, emptier one.
+
 | JSON Schema | Postgres |
 |---|---|
 | `string` · `string`+`format:'uuid'` | `text` · `uuid` |
 | `DateSchema` (`{type:'object', format:'date-time'}`) | `timestamptz` |
 | `integer` · `number` · `boolean` | `integer` · `double precision` · `boolean` |
-| `array`, nested `object` | `jsonb` |
+| `array` of plain `string`/`integer`/`number`/`boolean` items (no `format`, no `enum`) | native `<scalar>[]`, e.g. `text[]` |
+| any other `array` (objects, enums, formatted items, no `items`), nested `object` | `jsonb` |
 | string `enum` | `text` + `CHECK` |
 | `nullable: true` · in `required[]` | nullable · `NOT NULL` |
 | `secure: true` | ciphertext column, `lock`/`unlock` aware |
@@ -90,24 +99,41 @@ 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.
-`byName` in `utils/schema.ts` collapses them and warns.
+The compiler collapses the duplicates itself, keeps the first declaration and warns on the console.
 
 ## Reconciliation is authoritative — `PgAutoSync`
 
-At `init()`: introspect → diff → apply the whole `DdlPlan` in one transaction under
-`pg_advisory_xact_lock`, so concurrent replicas don't race. `DbConfig.meta.autoSync`:
+At `init()`: take a **session** advisory lock on the qualified table name → introspect → diff →
+apply the whole `DdlPlan` in one transaction → release the lock. The lock is session level, not
+`xact`, because it has to span the migrations as well as the DDL, and those run in transactions of
+their own inside it — only the plan itself is one `BEGIN`/`COMMIT`. Concurrent replicas therefore
+serialize on the whole initialization, not just on the DDL. `DbConfig.meta.autoSync`:
 
 | Value | Behaviour |
 |---|---|
 | `Full` (default) | add / retype+backfill / drop columns, reconcile indexes and constraints |
 | `Additive` | add only — never retypes, never drops |
-| `Off` | create if absent, otherwise leave alone |
+| `Off` | **no table DDL** — the structure is never diffed and no statement is emitted, so a missing table is never created and the first query dies with `42P01`. Only for a table something else already provisions |
+
+The schema root override `pg: { autoSync }` is a boolean and wins per table: it turns reconciliation
+back on for one table under `meta.autoSync: 'off'`, and off for one table under the other two modes.
+`Full` versus `Additive` still comes from the config.
 
 **`Full` DROPs columns the schema doesn't declare.** Adopting a table this package didn't create:
 boot once with `Additive`, confirm the plan comes out empty, then flip to `Full`. Columns listed in
 `pg.unmanaged` stay outside reconciliation's authority permanently. A cast Postgres cannot perform
 raises `PostgresCastRequired` instead of truncating.
 
+**A retype drops the column's default first and restores it after.** Postgres refuses
+`ALTER COLUMN … TYPE` outright when the column carries a DEFAULT it cannot cast to the new type
+(`42804 default for column "x" cannot be cast automatically`), and it refuses before reading a
+single row, so `USING` never gets a chance to help. Since the plan is one transaction, that refusal
+aborts the whole reconciliation and the resource then fails *every* boot with an error naming the
+column it is trying to fix. The plan therefore emits `DROP DEFAULT` → `ALTER … TYPE … USING` →
+`SET DEFAULT`, restoring the default from the spec rather than from what the column was carrying.
+The `id` column is where this shows up in practice: it is created with a `gen_random_uuid()::text`
+default, so any change to its declared type takes this path.
+
 ## Migrations bracket the sync
 
 `migration`/`migrations()` implement the shared `MigratableResource` capability from
@@ -141,10 +167,16 @@ resource.migration('0001-rescue-legacy', async tx => {
 
 ```typescript
 await projects.select(
-  `SELECT p.* FROM {{}} p JOIN {{users}} u ON u.id = {{self.ownerId}} WHERE u.active = $1`, [true]
+  `SELECT {{}}.* FROM {{}} JOIN {{users}} u ON u.id = {{self.ownerId}} WHERE u.active = $1`, [true]
 )
 ```
 
+**Do not alias a table a placeholder still names.** Every `{{…}}` expands to the *qualified*
+`"schema"."table"` — `{{self.ownerId}}` to `"schema"."table"."ownerId"` — so aliasing the same table
+as `p` in the `FROM` makes Postgres reject the expansion with `invalid reference to FROM-clause
+entry`. Either write the qualified form throughout, as above, or alias the table and stop using
+`{{self.…}}` for its columns.
+
 Postgres cannot bind an identifier as a parameter — that is the entire reason this mechanism exists.
 Values have no such excuse: they stay in `params` as `$1..$n`. An unknown alias or property raises
 `PostgresPlaceholderError` at parse time.
@@ -158,13 +190,45 @@ middleware `appendPostgres` installs — use that rather than reordering registr
 
 | Method | Semantics |
 |---|---|
-| `create` | refuses a caller-supplied id (`RecordExists`) — use `insert` |
+| `create` | refuses a caller-supplied id (`RecordExists`) — use `insert`; rejects `opts.ttl` with `UnsupportedArgumentError` (mongo parity) |
 | `update` | **replaces** the whole record — use `patch` to merge |
-| `pick` | `DELETE … RETURNING`: it deletes the record it returns, atomically |
-| `load` | rejects `opts.ttl` with `UnsupportedArgumentError` (mongo parity) |
+| `load(where, { sort })` / `get(where, { sort })` | one `SELECT … ORDER BY … LIMIT 1`, so "the newest matching row" is one statement rather than a list whose head is taken |
+| `delete` / `take` | one `DELETE … RETURNING`: the row is handed back by the statement that removed it. `take` **deletes** and throws `UnknownRecordError` on a miss |
+| `purge` | `DELETE … RETURNING` over the criteria; refuses an empty criteria object (`UnsupportedArgumentError('purge:no-criteria')`) rather than truncating the table |
+| `count` | `count(*)` over the criteria, no rows carried back |
 | `upsert` | `INSERT … ON CONFLICT DO UPDATE`, conflicting on the primary key by default |
 | `select`/`selectOne` | custom SQL marshalled back into `T`; `query`/`queryOne` return raw rows |
 
+## Paging
+
+Postgres is **PAGED**: `DEFAULT_PAGE_SIZE` is `100`, so `list(where)` with no `size` returns the
+first 100 rows — a table is unbounded, and an unpaged read is a production incident waiting for the
+row count to grow. `total` is counted separately, so it describes the whole match rather than the
+window, and `list(where, { size: 0 })` lifts the limit: the explicit, greppable way to read a whole
+table.
+
+`sort` becomes the `ORDER BY`, a bare field name ascending, and **the primary key is always
+appended as a tiebreak**. Postgres has no implicit row order, so paginating on a non-unique sort
+key silently duplicates and skips rows between pages — a difference from mongo that would surface
+as a data bug rather than an error.
+
+## Criteria against a table
+
+`criteriaToSql` answers the shared vocabulary ([[resource]]) in SQL, so one criteria object selects
+the same rows here as it does against a collection or in memory. What is specific to a table:
+
+- **A key naming no column raises `UnsupportedArgumentError`.** A typo that silently widened a
+  query to the whole table is worth being loud about — the schemaless stores cannot detect one.
+- **A dotted key reaches into a jsonb column** (`#>>`), and a criteria object against a jsonb
+  column becomes containment (`@>`). A dotted key over a non-jsonb column is refused, and `sort`
+  refuses dotted paths outright: ORDER BY names a column the caller actually declared.
+- `$contains`/`$contained`/`$overlaps` are the array operators `@>`, `<@` and `&&`;
+  `$like`/`$ilike` are `LIKE`/`ILIKE`; `$exists: true` and `$null: false` are `IS NOT NULL`, their
+  negations `IS NULL`.
+- **`{ $in: [null, …] }` is widened explicitly.** SQL `IN` never matches NULL, so a null in the
+  list would silently disappear; the condition becomes `IN (…) OR IS NULL` (and the `$nin` form
+  `NOT IN (…) AND IS NOT NULL`), which is what the other stores answer.
+
 ## Errors
 
 Drizzle raises `DrizzleQueryError` and hangs the `pg` error off `cause`, so the driver `code` is not
@@ -175,9 +239,9 @@ translation — consumers classify retryable DDL races on `42P01`/`42703`.
 
 ## Config
 
-`DbConfig.schema` is the Postgres **SCHEMA** (layer-suffixed by `dbName()`); the **DATABASE** comes
-from `meta.database` and is never suffixed. Values starting with `/` are read as files by the
-existing `fileConfigReader` middleware.
+`DbConfig.schema` is the Postgres **SCHEMA** (the service's `name(alias?)` returns it as given); the
+**DATABASE** comes from `meta.database`. Values starting with `/` are read as files by the existing
+`fileConfigReader` middleware.
 
 ## Tests
 

package/build/consts.d.ts

@@ -1,5 +1,12 @@
 export declare const DEFAULT_DB_ALIAS = "postgres";
-export declare const DEFAULT_PAGE_SIZE = 10;
+/**
+ * Rows `list()` returns when the caller names no `size`.
+ *
+ * A relational table is unbounded, so an unpaged read is a production incident waiting for
+ * the row count to grow. Asking for everything stays possible — and greppable — as
+ * `list(where, { size: 0 })`.
+ */
+export declare const DEFAULT_PAGE_SIZE = 100;
 /**
  * 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

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,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC;;;;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,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

@@ -1,5 +1,12 @@
 export const DEFAULT_DB_ALIAS = 'postgres';
-export const DEFAULT_PAGE_SIZE = 10;
+/**
+ * Rows `list()` returns when the caller names no `size`.
+ *
+ * A relational table is unbounded, so an unpaged read is a production incident waiting for
+ * the row count to grow. Asking for everything stays possible — and greppable — as
+ * `list(where, { size: 0 })`.
+ */
+export const DEFAULT_PAGE_SIZE = 100;
 /**
  * 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

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,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"}
+{"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"}

package/build/declarations.js

@@ -2,11 +2,11 @@ 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.
+ * A maker may run more than once for the same alias — a custom maker wrapping the built-in
+ * one, a maker called again by an app or a spec. Keying the declarations by alias makes that
+ * 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.
  */
 const declarations = new Map();
 export const getDeclaration = (alias) => {

package/build/resource.d.ts

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

package/build/resource.d.ts.map

@@ -1 +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,SAEtE,MAAM,YAAW,MAAM,iBAAmC,MAAM,uBAClD,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,cAAc,MAAM,KAC3D,CA+cF,CAAA"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACuD,cAAc,EAChF,MAAM,oBAAoB,CAAA;AAW3B,OAAO,KAAK,EAC8D,gBAAgB,EAEzF,MAAM,YAAY,CAAA;AAiBnB,eAAO,MAAM,oBAAoB,GAC/B,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,SAEtE,MAAM,YAAW,MAAM,iBAAmC,MAAM,cAC3D,MAAM,KACjB,CA4cF,CAAA"}