@owlmeans/mongo-resource 0.1.18-rc.9 → 0.1.18

package/build/utils/life-cycle/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/life-cycle/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,oBAAoB,EAAE,CACpB,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,KACnF,OAAO,CAAC,UAAU,CAAC,CAAA;IACxB,yEAAyE;IACzE,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAChG,wFAAwF;IACxF,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;CACjG"}

package/build/utils/life-cycle/types.js

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

package/build/utils/life-cycle/types.js.map

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

package/build/utils/life-cycle.d.ts

@@ -1,31 +1,4 @@
-import type { DbConfig, ResourceRecord } from '@owlmeans/resource';
-import type { BasicContext } from '@owlmeans/context';
-import type { MongoResource } from '../types.js';
-import type { Db, Collection } from 'mongodb';
-/**
- * Bring a resource's collection to the shape its schema declares.
- *
- * Order is deliberate, and matches the Postgres counterpart:
- *
- *  1. probe for the collection
- *  2. absent → *baseline* every registered migration; present → run the `pre` ones
- *     (including the system `$ref:` migrations that convert declared references)
- *  3. create the collection, or update its validator and indexes
- *  4. present → run the `post` migrations
- *  5. reconcile declared references — the second half of their double check: the ledger
- *     said whether the `$ref:` migration ran, this probes the collection itself and
- *     converts whatever strings still slipped through
- *
- * Step 2 is what stops the two mechanisms colliding. A `pre` migration runs before the
- * validator is tightened, so it can reshape documents the new validator would reject. On a
- * collection this call just created there is nothing to reshape — replaying a historical
- * migration against a collection born in its final shape would at best scan for nothing —
- * so the migrations are recorded as satisfied instead of run.
- *
- * `context` is optional so the existing three-argument call keeps working; without it a
- * migration's `use`/`ref` can only address the owning resource.
- */
-export declare const initializeCollection: (db: Db, config: DbConfig, resource: MongoResource<ResourceRecord>, context?: BasicContext<any>) => Promise<Collection>;
-export declare const createCollection: (db: Db, name: string, resource: MongoResource<ResourceRecord>) => Promise<Collection>;
-export declare const updateCollection: (db: Db, name: string, resource: MongoResource<ResourceRecord>) => Promise<Collection>;
+import type { Db } from 'mongodb';
+import type { MongoLifeCycleUtils } from './life-cycle/types.js';
+export declare const makeMongoLifeCycleUtils: (db: Db) => MongoLifeCycleUtils;
 //# sourceMappingURL=life-cycle.d.ts.map

package/build/utils/life-cycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"life-cycle.d.ts","sourceRoot":"","sources":["../../src/utils/life-cycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAmB,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,KAAK,EAAE,EAAE,EAAE,UAAU,EAAgC,MAAM,SAAS,CAAA;AAS3E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,oBAAoB,OAC3B,EAAE,UAAU,QAAQ,YAAY,aAAa,CAAC,cAAc,CAAC,YACvD,YAAY,CAAC,GAAG,CAAC,KAC1B,OAAO,CAAC,UAAU,CAmBpB,CAAA;AA+DD,eAAO,MAAM,gBAAgB,OAAc,EAAE,QAAQ,MAAM,YAAY,aAAa,CAAC,cAAc,CAAC,KAAG,OAAO,CAAC,UAAU,CAoBxH,CAAA;AAED,eAAO,MAAM,gBAAgB,OAAc,EAAE,QAAQ,MAAM,YAAY,aAAa,CAAC,cAAc,CAAC,KAAG,OAAO,CAAC,UAAU,CAaxH,CAAA"}
+{"version":3,"file":"life-cycle.d.ts","sourceRoot":"","sources":["../../src/utils/life-cycle.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAE,EAA4C,MAAM,SAAS,CAAA;AAG3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAShE,eAAO,MAAM,uBAAuB,OAAQ,EAAE,KAAG,mBAsIhD,CAAA"}

package/build/utils/life-cycle.js

@@ -1,126 +1,110 @@
 import { MigrationStage, runMigrations } from '@owlmeans/resource';
+import { logger } from '@owlmeans/log';
 import { DEF_MIGRATIONS_COLLECTION } from '../consts.js';
-import { getDeclaration } from '../declarations.js';
+import { mongoDeclarationHelper } from '../declarations.js';
 import { mongoCollectionName } from './name.js';
-import { applyReferenceTypes, schemaToMongoSchema } from './schema.js';
-import { updateIndexes } from './indexes.js';
+import { mongoSchemaUtils } from './schema.js';
+import { mongoIndexUtils } from './indexes.js';
 import { makeMongoMigrationStore, makeMongoTx } from './migrations.js';
-import { reconcileReferences } from './refs.js';
-/**
- * Bring a resource's collection to the shape its schema declares.
- *
- * Order is deliberate, and matches the Postgres counterpart:
- *
- *  1. probe for the collection
- *  2. absent → *baseline* every registered migration; present → run the `pre` ones
- *     (including the system `$ref:` migrations that convert declared references)
- *  3. create the collection, or update its validator and indexes
- *  4. present → run the `post` migrations
- *  5. reconcile declared references — the second half of their double check: the ledger
- *     said whether the `$ref:` migration ran, this probes the collection itself and
- *     converts whatever strings still slipped through
- *
- * Step 2 is what stops the two mechanisms colliding. A `pre` migration runs before the
- * validator is tightened, so it can reshape documents the new validator would reject. On a
- * collection this call just created there is nothing to reshape — replaying a historical
- * migration against a collection born in its final shape would at best scan for nothing —
- * so the migrations are recorded as satisfied instead of run.
- *
- * `context` is optional so the existing three-argument call keeps working; without it a
- * migration's `use`/`ref` can only address the owning resource.
- */
-export const initializeCollection = async (db, config, resource, context) => {
-    const name = mongoCollectionName(config, resource);
-    const fresh = !await db.listCollections({ name }).hasNext();
-    appendReferenceIndexes(resource);
-    const migrate = prepareMigrations(db, config, resource, name, context);
-    await migrate(fresh ? { baseline: true } : { stage: MigrationStage.Pre });
-    const collection = fresh
-        ? await createCollection(db, name, resource)
-        : await updateCollection(db, name, resource);
-    if (!fresh) {
-        await migrate({ stage: MigrationStage.Post });
-        await reconcileReferences(collection, referencesOf(resource), resource.alias);
-    }
-    return collection;
-};
-/** Tolerates hand-built resource objects that predate the reference capability. */
-const referencesOf = (resource) => resource.references?.() ?? [];
-/**
- * A declared reference is indexed at the mongo level — that's part of its contract. The
- * index is appended unless the resource already declares one with the same key pattern
- * (mongo refuses two indexes over identical keys, and the existing one — possibly
- * unique — wins).
- */
-const appendReferenceIndexes = (resource) => {
-    for (const ref of referencesOf(resource)) {
-        if (ref.noIndex === true) {
-            continue;
+import { mongoRefHelper } from './refs.js';
+const log = logger('mongo-resource');
+export const makeMongoLifeCycleUtils = (db) => {
+    const { applyReferenceTypes, schemaToMongoSchema } = mongoSchemaUtils;
+    const initializeCollection = async (config, resource, context) => {
+        const name = mongoCollectionName(config, resource);
+        const fresh = !await db.listCollections({ name }).hasNext();
+        appendReferenceIndexes(resource);
+        const migrate = prepareMigrations(config, resource, name, context);
+        await migrate(fresh ? { baseline: true } : { stage: MigrationStage.Pre });
+        const collection = fresh
+            ? await createCollection(name, resource)
+            : await updateCollection(name, resource);
+        if (!fresh) {
+            await migrate({ stage: MigrationStage.Post });
+            await mongoRefHelper.reconcileReferences(collection, referencesOf(resource), resource.alias);
         }
-        resource.indexes = resource.indexes ?? [];
-        const spec = JSON.stringify({ [ref.field]: 1 });
-        const present = resource.indexes.some(index => JSON.stringify(index.index) === spec || index.name === `ref_${ref.field}`);
-        if (!present) {
-            resource.indexes.push({ name: `ref_${ref.field}`, index: { [ref.field]: 1 } });
+        return collection;
+    };
+    /** Tolerates hand-built resource objects that predate the reference capability. */
+    const referencesOf = (resource) => resource.references?.() ?? [];
+    /**
+     * A declared reference is indexed at the mongo level — that's part of its contract. The
+     * index is appended unless the resource already declares one with the same key pattern
+     * (mongo refuses two indexes over identical keys, and the existing one — possibly
+     * unique — wins).
+     */
+    const appendReferenceIndexes = (resource) => {
+        for (const ref of referencesOf(resource)) {
+            if (ref.noIndex === true) {
+                continue;
+            }
+            resource.indexes = resource.indexes ?? [];
+            const spec = JSON.stringify({ [ref.field]: 1 });
+            const present = resource.indexes.some(index => JSON.stringify(index.index) === spec || index.name === `ref_${ref.field}`);
+            if (!present) {
+                resource.indexes.push({ name: `ref_${ref.field}`, index: { [ref.field]: 1 } });
+            }
         }
-    }
-};
-/**
- * Bind the migration runner to this resource's database, or hand back a no-op when nothing
- * is registered — the overwhelmingly common case, and one that shouldn't pay for a ledger.
- */
-const prepareMigrations = (db, config, resource, name, context) => {
-    const registry = getDeclaration(resource.alias).migrations;
-    if (registry.list().length < 1) {
-        return async () => null;
-    }
-    const ledgerName = config.meta?.migrationsCollection
-        ?? DEF_MIGRATIONS_COLLECTION;
+    };
     /**
-     * `db.collection()` never round-trips, so taking the handle before the collection exists
-     * is safe — and on the fresh path the transaction is only ever baselined, never used.
+     * Bind the migration runner to this resource's database, or hand back a no-op when nothing
+     * is registered — the overwhelmingly common case, and one that shouldn't pay for a ledger.
      */
-    const tx = makeMongoTx(db, db.collection(name), config, context, resource.alias);
-    const store = makeMongoMigrationStore(db, tx, ledgerName);
-    return async (opts) => {
-        const report = await runMigrations(resource.alias, registry, store, opts);
-        if (report.applied.length > 0) {
-            console.log(`@owlmeans/mongo-resource: ${name} applied ${report.stage} migrations —`
-                + ` ${report.applied.join(', ')}`);
+    const prepareMigrations = (config, resource, name, context) => {
+        const registry = mongoDeclarationHelper.getDeclaration(resource.alias).migrations;
+        if (registry.list().length < 1) {
+            return async () => null;
         }
-        return report;
+        const ledgerName = config.meta?.migrationsCollection
+            ?? DEF_MIGRATIONS_COLLECTION;
+        /**
+         * `db.collection()` never round-trips, so taking the handle before the collection exists
+         * is safe — and on the fresh path the transaction is only ever baselined, never used.
+         */
+        const tx = makeMongoTx(db, db.collection(name), config, context, resource.alias);
+        const store = makeMongoMigrationStore(db, tx, ledgerName);
+        return async (opts) => {
+            const report = await runMigrations(resource.alias, registry, store, opts);
+            if (report.applied.length > 0) {
+                log.info('Migrations applied', {
+                    resource: resource.alias, collection: name, stage: report.stage, applied: report.applied,
+                }, { event: 'migration.applied' });
+            }
+            return report;
+        };
     };
-};
-export const createCollection = async (db, name, resource) => {
-    const collection = await db.createCollection(name, {
-        ...(resource.schema != null ? {
-            validator: {
-                $jsonSchema: patchJsonSchema(applyReferenceTypes(schemaToMongoSchema(resource.schema), resource.schema, resource.references()))
+    const createCollection = async (name, resource) => {
+        const collection = await db.createCollection(name, {
+            ...(resource.schema != null ? {
+                validator: {
+                    $jsonSchema: patchJsonSchema(applyReferenceTypes(schemaToMongoSchema(resource.schema), resource.schema, resource.references()))
+                }
+            } : {})
+        });
+        if (resource.indexes != null) {
+            await Promise.all(resource.indexes.map(async (index) => await collection.createIndex(index.index, {
+                name: index.name, ...((index.options != null) ? index.options : {})
+            })));
+        }
+        return collection;
+    };
+    const updateCollection = async (name, resource) => {
+        if (resource.schema != null) {
+            const $jsonSchema = patchJsonSchema(applyReferenceTypes(schemaToMongoSchema(resource.schema), resource.schema, resource.references()));
+            await db.command({ collMod: name, validator: { $jsonSchema } });
+        }
+        const collection = db.collection(name);
+        await mongoIndexUtils.updateIndexes(collection, resource);
+        return collection;
+    };
+    const patchJsonSchema = (schema) => {
+        if (schema.properties != null) {
+            if (schema.properties._id == null) {
+                schema.properties._id = { bsonType: 'objectId' };
             }
-        } : {})
-    });
-    if (resource.indexes != null) {
-        await Promise.all(resource.indexes.map(async (index) => await collection.createIndex(index.index, {
-            name: index.name, ...((index.options != null) ? index.options : {})
-        })));
-    }
-    return collection;
-};
-export const updateCollection = async (db, name, resource) => {
-    if (resource.schema != null) {
-        const $jsonSchema = patchJsonSchema(applyReferenceTypes(schemaToMongoSchema(resource.schema), resource.schema, resource.references()));
-        await db.command({ collMod: name, validator: { $jsonSchema } });
-    }
-    const collection = db.collection(name);
-    await updateIndexes(collection, resource);
-    return collection;
-};
-const patchJsonSchema = (schema) => {
-    if (schema.properties != null) {
-        if (schema.properties._id == null) {
-            schema.properties._id = { bsonType: 'objectId' };
         }
-    }
-    return schema;
+        return schema;
+    };
+    return { initializeCollection, createCollection, updateCollection };
 };
 //# sourceMappingURL=life-cycle.js.map

package/build/utils/life-cycle.js.map

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

package/build/utils/migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/utils/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAA6B,cAAc,EAAkB,MAAM,oBAAoB,CAAA;AAC7G,OAAO,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAK7C,OAAO,KAAK,EAAiC,OAAO,EAAE,MAAM,aAAa,CAAA;AAmBzE;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,OAClB,EAAE,cAAc,UAAU,UAAU,QAAQ,WAAW,YAAY,CAAC,GAAG,CAAC,QAAQ,MAAM,KACzF,OA6BF,CAAA;AAqBD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,OAC9B,EAAE,MAAM,OAAO,SAAQ,MAAM,KAChC,cAAc,CAAC,OAAO,CAwFxB,CAAA"}
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/utils/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAa,cAAc,EAAkB,MAAM,oBAAoB,CAAA;AAC7F,OAAO,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAG7C,OAAO,KAAK,EAAiC,OAAO,EAAE,MAAM,aAAa,CAAA;AAOzE;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,OAClB,EAAE,cAAc,UAAU,UAAU,QAAQ,WAAW,YAAY,CAAC,GAAG,CAAC,QAAQ,MAAM,KACzF,OA6BF,CAAA;AAqBD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,OAC9B,EAAE,MAAM,OAAO,SAAQ,MAAM,KAChC,cAAc,CAAC,OAAO,CAwFxB,CAAA"}

package/build/utils/migrations.js

@@ -1,5 +1,4 @@
-import { DEF_MIGRATION_POLL, DEF_MIGRATION_WAIT, DEF_MIGRATIONS_COLLECTION, MONGO_DUPLICATE_KEY } from '../consts.js';
-import { DEFAULT_DB_ALIAS } from '../consts.js';
+import { DEF_MIGRATION_POLL, DEF_MIGRATION_WAIT, DEF_MIGRATIONS_COLLECTION, MONGO_DUPLICATE_KEY, DEFAULT_DB_ALIAS } from '../consts.js';
 import { mongoCollectionName } from './name.js';
 const isDuplicateKey = (error) => error?.code === MONGO_DUPLICATE_KEY;
 /**

package/build/utils/migrations.js.map

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

package/build/utils/name.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"name.d.ts","sourceRoot":"","sources":["../../src/utils/name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAQhD,eAAO,MAAM,mBAAmB,WAAY,QAAQ,YAAY,aAAa,CAAC,cAAc,CAAC,KAAG,MAQ/F,CAAA"}
+{"version":3,"file":"name.d.ts","sourceRoot":"","sources":["../../src/utils/name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGhD,eAAO,MAAM,mBAAmB,WAAY,QAAQ,YAAY,aAAa,CAAC,cAAc,CAAC,KAAG,MAQ/F,CAAA"}

package/build/utils/name.js

@@ -1,8 +1,4 @@
-// Collection names must use only alphanumeric characters, underscore, and hyphen — no
-// colons or other delimiters. This guard enforces the rule for every collection created
-// through makeMongoResource across all projects (common/internal/app), failing fast at
-// initialization rather than silently creating a badly-named collection.
-const VALID_COLLECTION_NAME = /^[a-zA-Z0-9_-]+$/;
+import { VALID_COLLECTION_NAME } from './consts.local.js';
 export const mongoCollectionName = (config, resource) => {
     const name = `${config.resourcePrefix ?? ''}${resource.name ?? resource.alias}`;
     if (!VALID_COLLECTION_NAME.test(name)) {

package/build/utils/name.js.map

@@ -1 +1 @@
-{"version":3,"file":"name.js","sourceRoot":"","sources":["../../src/utils/name.ts"],"names":[],"mappings":"AAGA,sFAAsF;AACtF,wFAAwF;AACxF,uFAAuF;AACvF,yEAAyE;AACzE,MAAM,qBAAqB,GAAG,kBAAkB,CAAA;AAEhD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAgB,EAAE,QAAuC,EAAU,EAAE;IACvG,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAA;IAC/E,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,WAAW,CACnB,kCAAkC,IAAI,cAAc,QAAQ,CAAC,KAAK,oCAAoC,CACvG,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}
+{"version":3,"file":"name.js","sourceRoot":"","sources":["../../src/utils/name.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAgB,EAAE,QAAuC,EAAU,EAAE;IACvG,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAA;IAC/E,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,WAAW,CACnB,kCAAkC,IAAI,cAAc,QAAQ,CAAC,KAAK,oCAAoC,CACvG,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/build/utils/refs/types.d.ts

@@ -0,0 +1,78 @@
+import type { Collection, Document } from 'mongodb';
+import type { MongoReference } from '../../types.js';
+/** Declared ObjectId references: converting their values, their criteria and their stored data. */
+export interface MongoRefHelper {
+    /** A 24 hex string — the only shape a stored reference is converted from. */
+    isObjectIdHex: (value: unknown) => value is string;
+    /**
+     * Write side of a declared reference: the string id a record carries becomes the
+     * `ObjectId` the collection stores. Arrays convert elementwise.
+     *
+     * Strict on purpose — a declared reference holding something that is not a mongo id is
+     * either a mis-declared field (should never have been a reference) or a bug at the call
+     * site, and storing it as a string would silently reintroduce the mixed type state this
+     * mechanism exists to remove.
+     *
+     * @throws {MisshapedRecord}
+     */
+    marshalReference: (field: string, value: unknown) => unknown;
+    /** Read side: `ObjectId` back to the string records carry. Tolerates not yet migrated strings. */
+    demarshalReference: (value: unknown) => unknown;
+    /** Convert every declared reference of a fetched document back to string ids, in place. */
+    demarshalRefs: <T extends {}>(record: T, refs: Map<string, MongoReference>) => T;
+    /**
+     * Convert a mongo filter the way records are converted: values addressed at `_id` or at a
+     * declared reference become `ObjectId`s, and the `id` alias records actually carry is
+     * mapped onto `_id` — documents never store `id`, so before this mapping such criteria
+     * silently matched nothing.
+     *
+     * Tolerant by design: a value that is not 24 hex passes through unconverted. Criteria are
+     * matched against the collection, and against an `ObjectId` typed field a stray string
+     * matches nothing — which is exactly what it matched before the field was converted.
+     *
+     * Operators arrive already in mongo's own vocabulary — `criteriaToFilter` translates
+     * the portable one first, so this pass only has to convert values.
+     */
+    marshalCriteria: (criteria: Document | undefined, refs: Map<string, MongoReference>) => Document | undefined;
+    /**
+     * Criteria for addressing a single record by a field — `get`/`load`/`update`/`delete`.
+     *
+     * `_id` keeps its historical strictness (an invalid id throws through the driver). The
+     * `id` alias and declared references convert tolerantly, so a caller probing a reference
+     * with a value that is not a mongo id gets "not found" rather than a throw.
+     */
+    identityCriteria: (field: string, id: string, refs: Map<string, MongoReference>) => Document;
+    /**
+     * Name of the system migration that converts a reference field's stored strings.
+     *
+     * The `@1` is the body's version: the shared body (`makeRefMigration`) fingerprints identically
+     * for every field, so an edit to it would raise `MigrationConflict` against every ledger on
+     * the next boot. Any semantic change to {@link MongoRefHelper.convertReferenceField} must bump
+     * this suffix instead — the old name stays applied, the new one runs (idempotently) once.
+     */
+    refMigrationName: (field: string) => string;
+    /**
+     * Convert one reference field's stored string ids to `ObjectId`s — the body of the
+     * system migration and of the boot time reconciliation probe alike.
+     *
+     * Idempotent and interrupt safe: it matches only documents where the field (or one of
+     * its elements) is still a string, converts only values that are actually 24 hex, and
+     * leaves everything else exactly as it was. Safe to run concurrently from several
+     * replicas — a document converts once, the loser's filter no longer matches it.
+     *
+     * Validation is bypassed deliberately: at `Pre` stage the collection still carries the
+     * validator that declares the field a *string*, and after the switch a legacy document
+     * may violate the schema in unrelated ways — either would wedge the boot on a write
+     * that only makes the data more correct. (Bypassing requires the connection's user to
+     * hold the `bypassDocumentValidation` privilege — `dbOwner`/`root` do.)
+     */
+    convertReferenceField: (collection: Collection, field: string) => Promise<number>;
+    /**
+     * The second half of the double check the reference migration promises: the ledger says
+     * whether the migration ran; this probes whether the collection actually holds no
+     * convertible strings — and repairs it when the two disagree (a restored backup, a
+     * write from a legacy process, a ledger created by hand).
+     */
+    reconcileReferences: (collection: Collection, refs: MongoReference[], alias: string) => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/utils/refs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/refs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,MAAM,CAAA;IAClD;;;;;;;;;;OAUG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;IAC5D,kGAAkG;IAClG,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;IAC/C,2FAA2F;IAC3F,aAAa,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;IAChF;;;;;;;;;;;;OAYG;IACH,eAAe,EAAE,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,QAAQ,GAAG,SAAS,CAAA;IAC5G;;;;;;OAMG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,QAAQ,CAAA;IAC5F;;;;;;;OAOG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAC3C;;;;;;;;;;;;;;OAcG;IACH,qBAAqB,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACjF;;;;;OAKG;IACH,mBAAmB,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACtG"}

package/build/utils/refs/types.js

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

package/build/utils/refs/types.js.map

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

package/build/utils/refs.d.ts

@@ -1,74 +1,20 @@
-import type { ListCriteria } from '@owlmeans/resource';
-import type { Collection, Document } from 'mongodb';
 import type { MongoReference, MongoTx } from '../types.js';
-export declare const isObjectIdHex: (value: unknown) => value is string;
+import type { MongoRefHelper } from './refs/types.js';
 /**
- * Write side of a declared reference: the string id a record carries becomes the
- * `ObjectId` the collection stores. Arrays convert elementwise.
- *
- * Strict on purpose — a declared reference holding something that is not a mongo id is
- * either a mis-declared field (should never have been a reference) or a bug at the call
- * site, and storing it as a string would silently reintroduce the mixed type state this
- * mechanism exists to remove.
+ * Ledger registered body of the system reference migration.
  *
- * @throws {MisshapedRecord}
+ * Stays a module level factory, textually unchanged: the ledger fingerprints a migration by the
+ * source text of the function it registers (`apply.toString()`), so moving the returned closure —
+ * or renaming what it calls — changes the checksum and raises `MigrationConflict` against every
+ * ledger that already applied it.
  */
+export declare const makeRefMigration: (field: string) => (tx: MongoTx) => Promise<void>;
+export declare const createMongoRefHelper: () => MongoRefHelper;
+export declare const mongoRefHelper: MongoRefHelper;
+/** @deprecated compat:factory-refactor — use `mongoRefHelper.isObjectIdHex(…)` */
+export declare const isObjectIdHex: (value: unknown) => value is string;
+/** @deprecated compat:factory-refactor — use `mongoRefHelper.marshalReference(…)` */
 export declare const marshalReference: (field: string, value: unknown) => unknown;
-/** Read side: `ObjectId` back to the string records carry. Tolerates not yet migrated strings. */
-export declare const demarshalReference: (value: unknown) => unknown;
-/** Convert every declared reference of a fetched document back to string ids, in place. */
+/** @deprecated compat:factory-refactor — use `mongoRefHelper.demarshalRefs(…)` */
 export declare const demarshalRefs: <T extends {}>(record: T, refs: Map<string, MongoReference>) => T;
-/**
- * Convert list criteria the way records are converted: values addressed at `_id` or at a
- * declared reference become `ObjectId`s, and the `id` alias records actually carry is
- * mapped onto `_id` — documents never store `id`, so before this mapping such criteria
- * silently matched nothing.
- *
- * Tolerant by design: a value that is not 24 hex passes through unconverted. Criteria are
- * matched against the collection, and against an `ObjectId` typed field a stray string
- * matches nothing — which is exactly what it matched before the field was converted.
- */
-export declare const marshalCriteria: (criteria: ListCriteria | undefined, refs: Map<string, MongoReference>) => ListCriteria | undefined;
-/**
- * Criteria for addressing a single record by a field — `get`/`load`/`update`/`delete`.
- *
- * `_id` keeps its historical strictness (an invalid id throws through the driver). The
- * `id` alias and declared references convert tolerantly, so a caller probing a reference
- * with a value that is not a mongo id gets "not found" rather than a throw.
- */
-export declare const identityCriteria: (field: string, id: string, refs: Map<string, MongoReference>) => Document;
-/**
- * Name of the system migration that converts a reference field's stored strings.
- *
- * The `@1` is the body's version: the shared body below fingerprints identically for
- * every field, so an edit to it would raise `MigrationConflict` against every ledger on
- * the next boot. Any semantic change to {@link convertReferenceField} must bump this
- * suffix instead — the old name stays applied, the new one runs (idempotently) once.
- */
-export declare const refMigrationName: (field: string) => string;
-/** Ledger registered body of the system reference migration. */
-export declare const makeRefMigration: (field: string) => (tx: MongoTx) => Promise<void>;
-/**
- * Convert one reference field's stored string ids to `ObjectId`s — the body of the
- * system migration and of the boot time reconciliation probe alike.
- *
- * Idempotent and interrupt safe: it matches only documents where the field (or one of
- * its elements) is still a string, converts only values that are actually 24 hex, and
- * leaves everything else exactly as it was. Safe to run concurrently from several
- * replicas — a document converts once, the loser's filter no longer matches it.
- *
- * Validation is bypassed deliberately: at `Pre` stage the collection still carries the
- * validator that declares the field a *string*, and after the switch a legacy document
- * may violate the schema in unrelated ways — either would wedge the boot on a write
- * that only makes the data more correct. (Bypassing requires the connection's user to
- * hold the `bypassDocumentValidation` privilege — `dbOwner`/`root` do.)
- */
-export declare const convertReferenceField: (collection: Collection, field: string) => Promise<number>;
-/**
- * The second half of the double check the reference migration promises: the ledger says
- * whether the migration ran; this probes whether the collection actually holds no
- * convertible strings — and repairs it when the two disagree (a restored backup, a
- * write from a legacy process, a ledger created by hand).
- */
-export declare const reconcileReferences: (collection: Collection, refs: MongoReference[], alias: string) => Promise<void>;
 //# sourceMappingURL=refs.d.ts.map

package/build/utils/refs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/utils/refs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAS1D,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,KAAK,IAAI,MACR,CAAA;AAEhD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,UAAW,MAAM,SAAS,OAAO,KAAG,OAehE,CAAA;AAED,kGAAkG;AAClG,eAAO,MAAM,kBAAkB,UAAW,OAAO,KAAG,OASnD,CAAA;AAED,2FAA2F;AAC3F,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,EAAE,UAAU,CAAC,QAAQ,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,KAAG,CAY1F,CAAA;AA4BD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,aAChB,YAAY,GAAG,SAAS,QAAQ,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,KACpE,YAAY,GAAG,SAkBjB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,UACpB,MAAM,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,KAC3D,QAYF,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,MAA2B,CAAA;AAE5E,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,UAAW,MAAM,UAAgB,OAAO,KAAG,OAAO,CAAC,IAAI,CAEnF,CAAA;AAeD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,eAAsB,UAAU,SAAS,MAAM,KAAG,OAAO,CAAC,MAAM,CAmBjG,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,eAClB,UAAU,QAAQ,cAAc,EAAE,SAAS,MAAM,KAC5D,OAAO,CAAC,IAAI,CAcd,CAAA"}
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/utils/refs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAIrD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,UAAW,MAAM,UAAgB,OAAO,KAAG,OAAO,CAAC,IAAI,CAEnF,CAAA;AAwCD,eAAO,MAAM,oBAAoB,QAAO,cA6HvC,CAAA;AAED,eAAO,MAAM,cAAc,gBAAyB,CAAA;AAEpD,kFAAkF;AAClF,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,KAAK,IAAI,MAA6C,CAAA;AAErG,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,UAAW,MAAM,SAAS,OAAO,KAAG,OAAwD,CAAA;AAEzH,kFAAkF;AAClF,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,EAAE,UAAU,CAAC,QAAQ,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,KAAG,CAC/C,CAAA"}