@owlmeans/mongo-resource 0.1.18-rc.2 → 0.1.18-rc.20

package/README.md

@@ -4,9 +4,9 @@ MongoDB-backed `Resource<T>` implementation — the primary database resource fo
 
 ## Overview
 
-- `makeMongoResource<R, T>(alias, dbAlias?, serviceAlias?, maker?, collectionName?)` — factory for MongoDB resources
+- `makeMongoResource<R, T>(alias, dbAlias?, serviceAlias?, collectionName?)` — factory for MongoDB resources
 - `MongoResource<T>` — extends `Resource<T>` with MongoDB collection, indexing, field encryption, code migrations and ObjectId references
-- Supports CRUD, list/pagination, AJV schema validation ($jsonSchema collection validators), and field-level locking (encryption)
+- Supports CRUD, criteria queries, sorting and paging, AJV schema validation ($jsonSchema collection validators), and field-level locking (encryption)
 - Declared references convert between the string ids records carry and the `ObjectId`s the collection stores — the same way `_id` already does
 - Code migrations run automatically at resource initialization, tracked in a per-database `_owlmeans_migrations` ledger
 - Used for all persistent data models in server applications
@@ -14,7 +14,7 @@ MongoDB-backed `Resource<T>` implementation — the primary database resource fo
 ## Installation
 
 ```bash
-bun add @owlmeans/mongo-resource
+bun add @owlmeans/mongo-resource@^0.1.18-rc.11
 ```
 
 ## Usage
@@ -29,9 +29,7 @@ import type { ResourceMaker } from '@owlmeans/resource'
 export interface ProjectResource extends MongoResource<ProjectRecord> {}
 
 export const makeProjectResource: ResourceMaker<ProjectRecord, ProjectResource> = (dbAlias, serviceAlias) => {
-  const resource = makeMongoResource<ProjectRecord>(
-    RES_PROJECT, dbAlias, serviceAlias, makeProjectResource
-  )
+  const resource = makeMongoResource<ProjectRecord, ProjectResource>(RES_PROJECT, dbAlias, serviceAlias)
   resource.schema = ProjectSchema
   resource.index('entity', { entityId: 1 })
   resource.index('alias', { alias: 1 })
@@ -50,29 +48,55 @@ 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 })
+const page = await projects.list({ entityId }, { page: 0, size: 20, sort: ['createdAt'] })
+const open = await projects.count({ status: ['draft', 'active'] })
 ```
 
 ## API
 
-### `makeMongoResource<R, T>(alias, dbAlias?, serviceAlias?, maker?, collectionName?): T`
+### `makeMongoResource<R, T>(alias, dbAlias?, serviceAlias?, collectionName?): T`
 
 Creates a MongoDB resource. `dbAlias` defaults to `DEFAULT_DB_ALIAS` (`'mongo'`).
 `collectionName` overrides the physical collection name (otherwise `resourcePrefix + alias`).
-Pass the maker itself as the 4th argument so `schema`/`index()` survive context switches;
-`migration()`/`reference()` survive regardless (module-scope declarations keyed by alias).
+`migration()` and `reference()` are kept in module-scope declarations keyed by alias, so a
+maker that runs more than once for the same alias re-declares the same entries and loses
+nothing.
 
 ### `MongoResource<T>`
 
-Extends `Resource<T>` (and the shared `MigratableResource<MongoTx>` capability) with:
+Extends `Resource<T>` with the shared `MigratableResource<MongoTx, MongoResource<T>>` and
+`LockableResource<T>` capabilities, plus:
 - `collection: Collection` — MongoDB collection
 - `db(): Promise<Db>` / `client(): Promise<MongoClient>`
 - `index(name, spec, options?): this` — define a collection index
 - `reference(field, targetAlias?): this` / `references()` — declare that a field stores another record's id (see below)
-- `migration(name, apply, stage?): this` / `migrations()` — register a code migration (see below)
+- `migration(name, apply, stage?)` / `migrations()` — register a code migration (see below)
 - `lock(record, fields?)` / `unlock(record, fields?)` — encrypt/decrypt secure fields
 - `getDefaults(): Partial<T>` — default values derived from schema
 
+### Criteria, sorting and paging
+
+`Criteria<T>` is the portable query shape from [`@owlmeans/resource`](../resource): a bare value
+is equality, a bare array is "any of these", `null` asks for the absence of a value and
+`undefined` is skipped so an untouched filter never empties a list. Every operator in the shared
+vocabulary — `$eq $ne $gt $gte $lt $lte $in $nin $exists $null $like $ilike $regex $startsWith
+$endsWith $between $contains $contained $overlaps`, plus `$and`/`$or`/`$not` — is translated into
+the mongo expression that answers the same question, so one criteria object means the same thing
+here as it does against Postgres or an in-memory store. `$exists` and `$null` both ask whether the
+field *has a value*, not whether the key is present. An operator outside the vocabulary raises
+`UnsupportedArgumentError`.
+
+Paging is per call: `list(where, { page, size, sort })`. Mongo pages by default —
+`DEFAULT_PAGE_SIZE` records when no `size` is given — because an unbounded read of a collection is
+not something a caller should get by omission. `list(where, { size: 0 })` asks for the whole
+result set explicitly. `ListResult.total` is always filled; `page` and `size` come back only when
+a limit was applied. `sort` takes field names (ascending) or `{ field, order: 'desc' }`, and `id`
+addresses `_id`.
+
+`criteriaToFilter(criteria, refs)` and `sortToMongo(sort)` are exported for code driving
+`resource.collection` directly.
+
 ### ObjectId references
 
 `reference(field, targetAlias?)` declares that a record field references another record's id.
@@ -100,7 +124,7 @@ The resource then treats the field exactly like `_id`:
 
 `migration(name, apply, stage?)` registers a code migration, applied once per database in
 declaration order and recorded in the `_owlmeans_migrations` collection (one ledger per
-database — an Entity-layer database tracks its own).
+database, so each database tracks its own).
 
 - `MigrationStage.Pre` runs before the validator/index update, `Post` after. On a collection
   created by this very boot, registered migrations are **baselined** (recorded, not run).
@@ -112,12 +136,23 @@ database — an Entity-layer database tracks its own).
 
 ### `Resource<T>` methods (all implemented)
 
-`get`, `load`, `create`, `update`, `save`, `delete`, `pick`, `list`
+`get`, `load`, `list`, `count`, `create`, `update`, `save`, `delete`, `take`, `purge`
+
+- `get`/`load` take either an id or a `Criteria<T>` with an optional `{ sort }`; `get` throws
+  `UnknownRecordError` where `load` answers `null`. An id that is not a mongo id finds nothing
+  rather than raising a driver error.
+- `update` replaces the whole record addressed by its `id`; `save` creates when the record
+  carries no id and replaces otherwise.
+- `delete(id)` and `take(id)` remove atomically through `findOneAndDelete` and hand the record
+  back — `take` throws `UnknownRecordError` on absence where `delete` answers `null`.
+- `purge(where)` is the bulk delete; it refuses an empty criteria object rather than emptying
+  the collection.
+- `ttl` is refused with `UnsupportedArgumentError` — a collection has no per-record expiry.
 
 ### Constants
 
 - `DEFAULT_DB_ALIAS` — `'mongo'`
-- `DEFAULT_PAGE_SIZE` — `10`
+- `DEFAULT_PAGE_SIZE` — `100`
 - `DEF_MIGRATIONS_COLLECTION` — `'_owlmeans_migrations'`
 
 ## Related Packages
@@ -133,7 +168,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/mongo-resource",
-  "version": "0.1.18-rc.0",
-  "generatedAt": "2026-08-16T22:20:50.501Z",
+  "version": "0.1.18-rc.20",
+  "generatedAt": "2026-09-12T14:21:25.463Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/mongo-resource
 
 **Layer:** Infra
-**Install:** `"@owlmeans/mongo-resource": "^0.1.18-rc.0"` in `dependencies` (peers `mongodb`, `ajv`)
+**Install:** `"@owlmeans/mongo-resource": "^0.1.18-rc.20"` in `dependencies` (peers `mongodb`, `ajv`)
 
 The Mongo counterpart of [[postgres-resource]]. A collection has no structure of its own, so
 here the resource layer owns the *validator* (`$jsonSchema` from the AJV schema), the indexes,
@@ -19,16 +19,21 @@ reference**.
 
 | Export | Description |
 |--------|-------------|
-| `makeMongoResource<R, T>(alias, dbAlias?, serviceAlias?, maker?, collectionName?)` | The resource factory. Aliases default to `DEFAULT_DB_ALIAS` (`'mongo'`). `collectionName` overrides the collection (else `resourcePrefix + alias`). |
-| `MongoResource<T>` | `Resource<T>` + `collection`, `index`, `reference`/`references`, `migration`/`migrations` (the shared `MigratableResource` capability), `lock`/`unlock`, `getDefaults`. |
+| `makeMongoResource<R, T>(alias, dbAlias?, serviceAlias?, collectionName?)` | The resource factory. Aliases default to `DEFAULT_DB_ALIAS` (`'mongo'`). `collectionName` overrides the collection (else `resourcePrefix + alias`). |
+| `MongoResource<T>` | `Resource<T>` + `collection`, `db()`/`client()`, `index`/`indexes`, `reference`/`references`, `migration`/`migrations` (the shared `MigratableResource` capability), `lock`/`unlock`, `getDefaults`, and the `dbAlias`/`serviceAlias` it was registered against. Anything naming a collection on another resource's behalf reads *that* resource's `dbAlias`, since two resources in one database can carry different `resourcePrefix`es. |
 | `MongoDbService`, `MongoTx` | Service contract implemented by `@owlmeans/mongo`; the façade handed to migrations (`db`, `collection`, `use(alias)`, `ref(alias)`). |
 | `MongoReference`, `MongoRefOptions` | A declared ObjectId reference and the `reference()` options (`resource`, `noIndex`). |
-| `marshalReference`, `demarshalReference`, `marshalCriteria`, `identityCriteria`, `isObjectIdHex` | The conversion layer — reuse these wherever raw driver access bypasses the resource. |
-| `convertReferenceField`, `reconcileReferences`, `refMigrationName` | The system reference migration's machinery. |
+| `marshalReference`, `demarshalReference`, `demarshalRefs`, `marshalCriteria`, `identityCriteria`, `isObjectIdHex` | The conversion layer — reuse these wherever raw driver access bypasses the resource. |
+| `criteriaToFilter`, `sortToMongo` | `Criteria<T>` → a mongo filter (references converted, every shared operator rewritten into a mongo expression) and `Sort<T>` → a mongo sort spec. |
+| `convertReferenceField`, `makeRefMigration`, `reconcileReferences`, `refMigrationName` | The system reference migration's machinery. |
 | `makeMongoTx`, `makeMongoMigrationStore` | The migration store (ledger) implementation. |
-| `getDeclaration`, `resetDeclarations` | Module-scope migration/reference declarations, keyed by alias. |
-| `schemaToMongoSchema`, `applyReferenceTypes`, `mongoCollectionName`, `updateIndexes` | Validator compilation and lifecycle helpers (deep import `utils/`). |
-| `DEFAULT_DB_ALIAS`, `DEFAULT_PAGE_SIZE`, `DEF_MIGRATIONS_COLLECTION` | Constants. |
+| `getDeclaration`, `resetDeclarations`, `MongoDeclaration` | Module-scope migration/reference declarations, keyed by alias; `resetDeclarations(alias?)` is the testing seam. |
+| `getSchemaSecureFeilds` | The `secure: true` schema properties `lock`/`unlock` operate on when the caller names no fields. |
+| `DEFAULT_DB_ALIAS`, `DEFAULT_PAGE_SIZE`, `DEF_MIGRATIONS_COLLECTION`, `DEF_MIGRATION_WAIT`, `DEF_MIGRATION_POLL`, `MONGO_DUPLICATE_KEY` | Constants. |
+
+Validator compilation and collection naming stay inside the package — the entry point exports
+nothing to reach them with, so a consumer shapes a collection by assigning `resource.schema` and
+declaring indexes, never by calling the compiler.
 
 ## Usage — the maker pattern
 
@@ -36,7 +41,7 @@ reference**.
 export const makeProjectStoryResource: ResourceMaker<ProjectStoryRecord, ProjectStoryResource> =
   (dbAlias, serviceAlias) => {
     const resource = makeMongoResource<ProjectStoryRecord, ProjectStoryResource>(
-      RES_PROJECT_STORY, dbAlias, serviceAlias, makeProjectStoryResource
+      RES_PROJECT_STORY, dbAlias, serviceAlias
     )
     resource.schema = ProjectStorySchema
     resource.reference('projectId', RES_PROJECT)
@@ -48,10 +53,9 @@ export const makeProjectStoryResource: ResourceMaker<ProjectStoryRecord, Project
 context.registerResource(makeProjectStoryResource())
 ```
 
-Pass the maker itself as the 4th argument — `reinitializeContext` re-runs it, which is what
-carries `schema` and `index()` calls across context switches. `migration()` and `reference()`
-survive regardless: they live in module-scope declarations keyed by alias, because losing one
-silently loses a data transformation.
+`migration()` and `reference()` live in module-scope declarations keyed by alias, so a maker
+that runs more than once for the same alias (a custom maker, a test) re-declares the same
+entries and loses nothing — losing one would silently lose a data transformation.
 
 ## ObjectId references
 
@@ -59,18 +63,18 @@ A field that stores **another record's id** is declared with `reference(field, t
 The resource then behaves for that field exactly as it does for `_id`:
 
 - **Records and criteria carry strings; the collection stores `ObjectId`s.** Conversion is
-  automatic in `create`/`update`/`save` (write), `get`/`load`/`list`/`delete`/`pick` (read and
-  lookup), and in `list` criteria — including `$in`/`$ne`-style operator objects, `$and`/`$or`/
-  `$nor` branches, and arrays of ids (elementwise). `$regex`/`$type`-style operands are left
-  alone.
+  automatic in `create`/`update`/`save` (write), `get`/`load`/`list`/`count`/`delete`/`take`/
+  `purge` (read and lookup), and in every criteria object — including operator objects,
+  `$and`/`$or`/`$not` branches, and arrays of ids (elementwise). `$regex`-style operands are
+  left alone.
 - **Writes are strict**: storing a non-24-hex value in a declared reference throws
   `MisshapedRecord('ref:<field>')` — a silent string would reintroduce the mixed-type state.
   Reads and criteria are tolerant: an unconverted legacy string comes back as-is; a non-id
   criteria value simply matches nothing (the auth `userId ?? profileId` fallback relies on
   this).
 - **`id` criteria address `_id`.** Documents never store an `id` field, so `list({ id })` and
-  `load(x, 'id')` are mapped onto `_id` with conversion — before this mapping they silently
-  matched nothing.
+  `load(id)` map onto `_id` with conversion; a criteria key naming a declared reference converts
+  the same way.
 - **The field is indexed** automatically (`ref_<field>`), unless `noIndex: true` or the
   resource already declares an index with the identical key pattern (mongo forbids two
   indexes over the same keys; a declared unique index wins).
@@ -96,7 +100,10 @@ version suffix** in `refMigrationName`, or every already-applied ledger raises
 
 Only fields assigned from another record's `.id` qualify. Known traps from the live codebase:
 
-- `entityId` / `entity` — IAM entity slug (also a Keycloak realm and a k8s namespace label)
+- `entityId` / `entitySlug` — the **organization entity**, never a document in this database.
+  `entitySlug` is the renameable name that travels on tokens and URLs; `entityId` is the stable id
+  the organization registry minted for it, and a deployment with no resolver stores the slug in the
+  same field. Neither is an `ObjectId`, and the field carries both shapes across deployments
 - `profileId` — composite key `"{type}:{accountId}"`; `credentials.userId` — external
   provider key `"{type}:{service}:{sub}"` (while `profile.userId` **is** a reference)
 - Stripe ids (`externalId`, `productId`, `taxId`), Cloudflare `providerId`, GitHub numeric ids
@@ -115,10 +122,22 @@ with `marshalReference(field, value)` and convert read-back documents' reference
 
 `resource.migration(name, apply, stage?)` — the shared `MigratableResource` capability from
 [[resource]]. Applied once per database, in declaration order, ledgered in
-`_owlmeans_migrations` (one ledger per database, so an Entity-layer database tracks its own).
+`_owlmeans_migrations` (one ledger per database, so each database tracks its own).
 
 - `Pre` runs **before** the validator is updated and indexes reconcile; `Post` after. A `Pre`
   body writes shapes the *old* validator allows; a `Post` body the *new* one.
+- **A `Pre` body that removes an indexed field must drop that index itself.** Indexes reconcile
+  *after* `Pre`, so the old index is still live and still enforcing while the body writes, whatever
+  the declaration now says. `$unset`ing an indexed field collapses every document onto
+  `{ <field>: null, … }`, and on a `unique` index the second one dies with E11000 — mid-migration,
+  after earlier collections were already rewritten, leaving the database half-migrated and the boot
+  aborting on every restart. Drop the stale index by name in the body first (guard on the key spec
+  so the drop is idempotent) and let reconciliation recreate it from the declaration.
+- **Index reconciliation matches by name and recreates on any difference.** A live index whose key
+  pattern or options differ from the declaration is dropped and created again, so a renamed field
+  does converge — after `Pre`, which is why the bullet above exists. Text indexes are the one
+  exception: a live index carrying `weights` is left as it is, and changing one means dropping it
+  yourself.
 - On a collection this boot just created, every registered migration is **baselined**
   (recorded, not run) — a fresh collection is born at head.
 - **No transactions**: a standalone `mongod` (the dev/CI target) rejects multi-document
@@ -140,25 +159,56 @@ with `marshalReference(field, value)` and convert read-back documents' reference
 2. absent → baseline all migrations; present → run `Pre` (system `$ref:` first if declared before app migrations)
 3. create collection (validator + indexes) or update validator + reconcile indexes
 4. present → run `Post`
-5. reconcile declared references (probe + repair — the double check)
+5. present → reconcile declared references (probe + repair — the double check)
+
+Steps 4 and 5 belong to the existing-collection path alone: a collection this boot created is
+already at head and carries no legacy strings to repair.
 
 ## Method semantics worth remembering
 
 | Method | Semantics |
 |---|---|
-| `create` | refuses a caller-supplied id (`RecordExists`) |
-| `update` | **replaces** the whole record (no merge) |
-| `pick` | deletes the record it returns |
-| `load`/`get` | rejects `opts.ttl` (`UnsupportedArgumentError`); second arg selects the lookup field |
+| `create` | refuses a caller-supplied id (`RecordExists`); rejects `opts.ttl` (`UnsupportedArgumentError`) |
+| `update` | **replaces** the whole record (no merge), keeping the document's `_id` |
+| `load(id)` / `get(id)` | a string that is not a 24-hex id matches nothing — `load` answers `null` and `get` throws, where handing it to `ObjectId` would raise a driver error at a call site that only asked whether the record exists |
+| `load(where, { sort })` / `get(where, { sort })` | `findOne` with the sort applied, so "the newest matching record" is one round trip |
 | `list` | criteria go through reference conversion; documents never store `id` — use `id` criteria freely, they map to `_id` |
+| `delete` / `take` | one `findOneAndDelete`: the record is handed back by the very operation that removed it, so two callers can never be given the same record. `take` **deletes** and throws `UnknownRecordError` on a miss |
+| `purge` | `deleteMany`; refuses an empty criteria object (`UnsupportedArgumentError('purge:no-criteria')`) rather than emptying the collection |
 | `lock`/`unlock` | encrypt/decrypt `secure: true` schema fields via the db service |
 
+## Paging
+
+Mongo is **PAGED**: `DEFAULT_PAGE_SIZE` is `100`, so `list(where)` with no `size` returns the first
+100 matches — a collection is unbounded and an unpaged read is an incident waiting for the document
+count to grow. `ListResult.total` counts every match regardless of the window, and
+`list(where, { size: 0 })` is the explicit, greppable ask for the whole result set. Asking for a
+page while lifting the limit contradicts itself and raises
+`UnsupportedArgumentError('page-without-size')` rather than quietly answering page 0.
+
+## Criteria against a collection
+
+`criteriaToFilter` rewrites the shared vocabulary ([[resource]]) into mongo expressions so one
+criteria object selects the same records here as it does in SQL and in memory. Two rewrites are
+worth knowing:
+
+- **`$exists` and `$null` compare against `null`**, not mongo's own `$exists`. The shared question
+  is whether a field *has a value*, which the other stores answer as `IS NULL` / `value == null`;
+  mongo's `$exists` answers whether the key is present, and a key present but null would part the
+  three stores over one object.
+- **`$like`/`$ilike` become anchored regular expressions** with `%` as any run and `_` as one
+  character; `$between` becomes `$gte`/`$lte`; and `$contains`/`$contained`/`$overlaps` mean over
+  an array field exactly what the postgres operators `@>`, `<@` and `&&` mean. An operator mongo
+  cannot answer raises `UnsupportedArgumentError` rather than being dropped.
+
 ## Tests
 
-Unit specs (conversion layer): `bun test ./tests` in this package — ungated. Integration
-specs that build a real `ServerContext` live in `@owlmeans/mongo` (`migration.spec.ts`,
-`references.spec.ts`), gated on `MONGO_URL` (see [[testing-integration]]); a dev port-forward
-to the cluster mongo satisfies the checked-in `.env`.
+`bun test ./tests` in this package runs the conversion-layer unit specs (`criteria.spec.ts`,
+`refs.spec.ts`) ungated, plus `crud.spec.ts`, which needs a real collection and self-skips behind
+the same `MONGO_URL` gate as the integration suites. Specs that build a real `ServerContext` live in
+`@owlmeans/mongo` (`crud.spec.ts`, `migration.spec.ts`, `references.spec.ts`), also gated on
+`MONGO_URL` — see [[testing-integration]]; a dev port-forward to the cluster mongo fills the
+`MONGO_URL` the repo's `.env.example` describes.
 
 ## Depends On
 

package/build/consts.d.ts

@@ -1,11 +1,15 @@
 export declare const DEFAULT_DB_ALIAS = "mongo";
-export declare const DEFAULT_PAGE_SIZE = 10;
+/**
+ * Page size a `list` call gets when it asks for none. Mongo cannot afford an unbounded read
+ * of a collection by omission, so paging is the default here — `list(where, { size: 0 })`
+ * asks for the whole result set, explicitly and greppably.
+ */
+export declare const DEFAULT_PAGE_SIZE = 100;
 /**
  * Collection that records which code-registered migrations have already been applied.
  *
- * One ledger per database, which is the right boundary: `dbName()` already varies the
- * database per Entity/User layer, so a tenant's migrations are tracked with the tenant's
- * data and dropping the database drops the ledger with it.
+ * One ledger per database, which is the right boundary: it sits beside the data its
+ * migrations changed, so dropping the database drops the ledger with it.
  */
 export declare const DEF_MIGRATIONS_COLLECTION = "_owlmeans_migrations";
 /**

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,UAAU,CAAA;AAEvC,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,yBAAyB,CAAA;AAE/D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAQ,CAAA;AAEvC,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAErC,yFAAyF;AACzF,eAAO,MAAM,mBAAmB,QAAQ,CAAA"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAA;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,yBAAyB,CAAA;AAE/D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAQ,CAAA;AAEvC,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAErC,yFAAyF;AACzF,eAAO,MAAM,mBAAmB,QAAQ,CAAA"}

package/build/consts.js

@@ -1,11 +1,15 @@
 export const DEFAULT_DB_ALIAS = 'mongo';
-export const DEFAULT_PAGE_SIZE = 10;
+/**
+ * Page size a `list` call gets when it asks for none. Mongo cannot afford an unbounded read
+ * of a collection by omission, so paging is the default here — `list(where, { size: 0 })`
+ * asks for the whole result set, explicitly and greppably.
+ */
+export const DEFAULT_PAGE_SIZE = 100;
 /**
  * Collection that records which code-registered migrations have already been applied.
  *
- * One ledger per database, which is the right boundary: `dbName()` already varies the
- * database per Entity/User layer, so a tenant's migrations are tracked with the tenant's
- * data and dropping the database drops the ledger with it.
+ * One ledger per database, which is the right boundary: it sits beside the data its
+ * migrations changed, so dropping the database drops the ledger with it.
  */
 export const DEF_MIGRATIONS_COLLECTION = '_owlmeans_migrations';
 /**

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,OAAO,CAAA;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAEnC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAA;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAA;AAEvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAA;AAErC,yFAAyF;AACzF,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAA"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAA;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAA;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAA;AAEvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAA;AAErC,yFAAyF;AACzF,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAA"}

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;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAA;IACtC,2FAA2F;IAC3F,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CACxC;AAcD,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,gBAQ9C,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,WAAY,MAAM,KAAG,IAOlD,CAAA"}
+{"version":3,"file":"declarations.d.ts","sourceRoot":"","sources":["../src/declarations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAA;IACtC,2FAA2F;IAC3F,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CACxC;AAaD,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,gBAQ9C,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,WAAY,MAAM,KAAG,IAOlD,CAAA"}

package/build/declarations.js

@@ -2,12 +2,11 @@ import { createMigrationRegistry } from '@owlmeans/resource';
 /**
  * Per-alias migration store, held at module scope rather than on the resource object.
  *
- * `reinitializeContext` rebuilds every resource from the maker, which drops anything a
- * caller attached by chaining afterwards. For indexes that is survivable — they already
- * exist in the database and `updateIndexes` only ever adds. Migrations are not: a layer
- * switch points the resource at a *different* database, and a registry emptied by the
- * rebuild would mean the entity database silently never gets the transformation. Keying
- * by alias makes the declarations outlive 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 registry, so nothing a caller declared
+ * by chaining 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/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;AAW5D;;;;;;;;;GASG;AACH,MAAM,YAAY,GAAkC,IAAI,GAAG,EAAE,CAAA;AAE7D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAoB,EAAE;IAChE,IAAI,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACzC,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,WAAW,GAAG,EAAE,UAAU,EAAE,uBAAuB,EAAW,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,EAAE,CAAA;QACvF,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;QAEpB,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;AAW5D;;;;;;;;GAQG;AACH,MAAM,YAAY,GAAkC,IAAI,GAAG,EAAE,CAAA;AAE7D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAoB,EAAE;IAChE,IAAI,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACzC,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,WAAW,GAAG,EAAE,UAAU,EAAE,uBAAuB,EAAW,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,EAAE,CAAA;QACvF,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;QAEpB,OAAM;IACR,CAAC;IACD,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC,CAAA"}

package/build/index.d.ts

@@ -3,6 +3,7 @@ export * from './consts.js';
 export * from './declarations.js';
 export * from './utils/migrations.js';
 export * from './utils/refs.js';
+export * from './utils/criteria.js';
 export * from './resource.js';
 export * from './helper.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

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

package/build/index.js

@@ -2,6 +2,7 @@ export * from './consts.js';
 export * from './declarations.js';
 export * from './utils/migrations.js';
 export * from './utils/refs.js';
+export * from './utils/criteria.js';
 export * from './resource.js';
 export * from './helper.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA"}

package/build/resource.d.ts

@@ -1,4 +1,4 @@
-import type { ResourceMaker, ResourceRecord } from '@owlmeans/resource';
+import type { ResourceRecord } from '@owlmeans/resource';
 import type { MongoResource } from './types.js';
-export declare const makeMongoResource: <R extends ResourceRecord, T extends MongoResource<R> = MongoResource<R>>(alias: string, dbAlias?: string, serviceAlias?: string, makeCustomResource?: ResourceMaker<R, T>, collectionName?: string) => T;
+export declare const makeMongoResource: <R extends ResourceRecord, T extends MongoResource<R> = MongoResource<R>>(alias: string, dbAlias?: string, serviceAlias?: string, collectionName?: 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":"AAIA,OAAO,KAAK,EAAgB,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAErF,OAAO,KAAK,EAAmD,aAAa,EAAW,MAAM,YAAY,CAAA;AAezG,eAAO,MAAM,iBAAiB,GAC5B,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,SAEhE,MAAM,YAAW,MAAM,iBAAmC,MAAM,uBAClD,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,mBAAmB,MAAM,KAChE,CAuTF,CAAA"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACuC,cAAc,EAChE,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAmD,aAAa,EAAW,MAAM,YAAY,CAAA;AAkBzG,eAAO,MAAM,iBAAiB,GAC5B,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,SAEhE,MAAM,YAAW,MAAM,iBAAmC,MAAM,mBACtD,MAAM,KACtB,CAsRF,CAAA"}