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

package/build/utils/refs.js

@@ -1,137 +1,16 @@
 import { MisshapedRecord } from '@owlmeans/resource';
 import { ObjectId } from 'mongodb';
+import { logger } from '@owlmeans/log';
+import { HEX24, LOGICAL_OPERATORS, OPAQUE_OPERATORS } from './consts.local.js';
+const log = logger('mongo-resource');
 /**
- * The only shape a stored reference is converted from. Deliberately stricter than
- * `ObjectId.isValid`, which also accepts any 12 character string and would silently
- * swallow short business keys.
- */
-const HEX24 = /^[0-9a-fA-F]{24}$/;
-export const isObjectIdHex = (value) => typeof value === 'string' && HEX24.test(value);
-/**
- * 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}
- */
-export const marshalReference = (field, value) => {
-    if (value == null) {
-        return value;
-    }
-    if (value instanceof ObjectId) {
-        return value;
-    }
-    if (Array.isArray(value)) {
-        return value.map(item => marshalReference(field, item));
-    }
-    if (isObjectIdHex(value)) {
-        return new ObjectId(value);
-    }
-    throw new MisshapedRecord(`ref:${field}`);
-};
-/** Read side: `ObjectId` back to the string records carry. Tolerates not yet migrated strings. */
-export const demarshalReference = (value) => {
-    if (value instanceof ObjectId) {
-        return value.toString();
-    }
-    if (Array.isArray(value)) {
-        return value.map(demarshalReference);
-    }
-    return value;
-};
-/** Convert every declared reference of a fetched document back to string ids, in place. */
-export const demarshalRefs = (record, refs) => {
-    if (refs.size < 1) {
-        return record;
-    }
-    for (const field of refs.keys()) {
-        const value = record[field];
-        if (value != null) {
-            record[field] = demarshalReference(value);
-        }
-    }
-    return record;
-};
-/**
- * Operators whose operand is never an id — a 24 hex string under `$regex` is a pattern,
- * not a reference.
- */
-const OPAQUE_OPERATORS = ['$regex', '$options', '$type', '$size', '$mod', '$exists', '$where'];
-const LOGICAL_OPERATORS = ['$and', '$or', '$nor'];
-const marshalCriteriaValue = (value) => {
-    if (typeof value === 'string') {
-        return isObjectIdHex(value) ? new ObjectId(value) : value;
-    }
-    if (Array.isArray(value)) {
-        return value.map(marshalCriteriaValue);
-    }
-    if (value != null && typeof value === 'object' && !(value instanceof ObjectId) && !(value instanceof Date)) {
-        return Object.fromEntries(Object.entries(value).map(([operator, operand]) => OPAQUE_OPERATORS.includes(operator)
-            ? [operator, operand]
-            : [operator, marshalCriteriaValue(operand)]));
-    }
-    return value;
-};
-/**
- * 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.
+ * Ledger registered body of the system reference migration.
  *
- * 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.
+ * 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 const marshalCriteria = (criteria, refs) => {
-    if (criteria == null) {
-        return criteria;
-    }
-    return Object.fromEntries(Object.entries(criteria).map(([key, value]) => {
-        if (LOGICAL_OPERATORS.includes(key) && Array.isArray(value)) {
-            return [key, value.map(sub => marshalCriteria(sub, refs))];
-        }
-        if (key === 'id' || key === '_id') {
-            return ['_id', marshalCriteriaValue(value)];
-        }
-        if (refs.has(key)) {
-            return [key, marshalCriteriaValue(value)];
-        }
-        return [key, value];
-    }));
-};
-/**
- * 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 const identityCriteria = (field, id, refs) => {
-    if (field === '_id') {
-        return { _id: new ObjectId(id) };
-    }
-    if (field === 'id') {
-        return { _id: isObjectIdHex(id) ? new ObjectId(id) : id };
-    }
-    if (refs.has(field)) {
-        return { [field]: isObjectIdHex(id) ? new ObjectId(id) : id };
-    }
-    return { [field]: id };
-};
-/**
- * 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 const refMigrationName = (field) => `$ref:${field}@1`;
-/** Ledger registered body of the system reference migration. */
 export const makeRefMigration = (field) => async (tx) => {
     await convertReferenceField(tx.collection, field);
 };
@@ -148,21 +27,10 @@ const convertScalar = (path) => ({
     ]
 });
 /**
- * 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.)
+ * The body {@link makeRefMigration} runs, kept at module level for the same reason it is; the
+ * helper exposes the very same function as `convertReferenceField`.
  */
-export const convertReferenceField = async (collection, field) => {
+const convertReferenceField = async (collection, field) => {
     const result = await collection.updateMany(
     /** An array valued field matches `$type: 'string'` when any element is a string. */
     { [field]: { $type: 'string' } }, [{
@@ -178,20 +46,109 @@ export const convertReferenceField = async (collection, field) => {
         }], { bypassDocumentValidation: true });
     return result.modifiedCount;
 };
-/**
- * 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 const reconcileReferences = async (collection, refs, alias) => {
-    for (const ref of refs) {
-        const remnant = await collection.findOne({ [ref.field]: { $type: 'string', $regex: HEX24 } }, { projection: { _id: 1 } });
-        if (remnant != null) {
-            const converted = await convertReferenceField(collection, ref.field);
-            console.warn(`@owlmeans/mongo-resource: ${alias}.${ref.field} held string ids outside the migration`
-                + ` ledger — converted ${converted} document(s)`);
-        }
-    }
+export const createMongoRefHelper = () => {
+    const isObjectIdHex = (value) => typeof value === 'string' && HEX24.test(value);
+    const marshalReference = (field, value) => {
+        if (value == null) {
+            return value;
+        }
+        if (value instanceof ObjectId) {
+            return value;
+        }
+        if (Array.isArray(value)) {
+            return value.map(item => marshalReference(field, item));
+        }
+        if (isObjectIdHex(value)) {
+            return new ObjectId(value);
+        }
+        throw new MisshapedRecord(`ref:${field}`);
+    };
+    const demarshalReference = (value) => {
+        if (value instanceof ObjectId) {
+            return value.toString();
+        }
+        if (Array.isArray(value)) {
+            return value.map(demarshalReference);
+        }
+        return value;
+    };
+    const demarshalRefs = (record, refs) => {
+        if (refs.size < 1) {
+            return record;
+        }
+        for (const field of refs.keys()) {
+            const value = record[field];
+            if (value != null) {
+                record[field] = demarshalReference(value);
+            }
+        }
+        return record;
+    };
+    const marshalCriteriaValue = (value) => {
+        if (typeof value === 'string') {
+            return isObjectIdHex(value) ? new ObjectId(value) : value;
+        }
+        if (Array.isArray(value)) {
+            return value.map(marshalCriteriaValue);
+        }
+        if (value != null && typeof value === 'object' && !(value instanceof ObjectId) && !(value instanceof Date)) {
+            return Object.fromEntries(Object.entries(value).map(([operator, operand]) => OPAQUE_OPERATORS.includes(operator)
+                ? [operator, operand]
+                : [operator, marshalCriteriaValue(operand)]));
+        }
+        return value;
+    };
+    const marshalCriteria = (criteria, refs) => {
+        if (criteria == null) {
+            return criteria;
+        }
+        return Object.fromEntries(Object.entries(criteria).map(([key, value]) => {
+            if (LOGICAL_OPERATORS.includes(key) && Array.isArray(value)) {
+                return [key, value.map(sub => marshalCriteria(sub, refs))];
+            }
+            if (key === 'id' || key === '_id') {
+                return ['_id', marshalCriteriaValue(value)];
+            }
+            if (refs.has(key)) {
+                return [key, marshalCriteriaValue(value)];
+            }
+            return [key, value];
+        }));
+    };
+    const identityCriteria = (field, id, refs) => {
+        if (field === '_id') {
+            return { _id: new ObjectId(id) };
+        }
+        if (field === 'id') {
+            return { _id: isObjectIdHex(id) ? new ObjectId(id) : id };
+        }
+        if (refs.has(field)) {
+            return { [field]: isObjectIdHex(id) ? new ObjectId(id) : id };
+        }
+        return { [field]: id };
+    };
+    const refMigrationName = (field) => `$ref:${field}@1`;
+    const reconcileReferences = async (collection, refs, alias) => {
+        for (const ref of refs) {
+            const remnant = await collection.findOne({ [ref.field]: { $type: 'string', $regex: HEX24 } }, { projection: { _id: 1 } });
+            if (remnant != null) {
+                const converted = await convertReferenceField(collection, ref.field);
+                log.warn('Reference field held string ids outside the migration ledger; converted', {
+                    resource: alias, field: ref.field, converted,
+                });
+            }
+        }
+    };
+    return {
+        isObjectIdHex, marshalReference, demarshalReference, demarshalRefs, marshalCriteria, identityCriteria,
+        refMigrationName, convertReferenceField, reconcileReferences
+    };
 };
+export const mongoRefHelper = createMongoRefHelper();
+/** @deprecated compat:factory-refactor — use `mongoRefHelper.isObjectIdHex(…)` */
+export const isObjectIdHex = (value) => mongoRefHelper.isObjectIdHex(value);
+/** @deprecated compat:factory-refactor — use `mongoRefHelper.marshalReference(…)` */
+export const marshalReference = (field, value) => mongoRefHelper.marshalReference(field, value);
+/** @deprecated compat:factory-refactor — use `mongoRefHelper.demarshalRefs(…)` */
+export const demarshalRefs = (record, refs) => mongoRefHelper.demarshalRefs(record, refs);
 //# sourceMappingURL=refs.js.map

package/build/utils/refs.js.map

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

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

@@ -0,0 +1,16 @@
+import type { AnySchema } from 'ajv';
+import type { Document } from 'mongodb';
+import type { MongoReference } from '../../types.js';
+/** An AJV schema as the `$jsonSchema` validator of a collection. */
+export interface MongoSchemaUtils {
+    /**
+     * Declared references are stored as `ObjectId`s while the AJV schema — which describes
+     * the records the app exchanges — keeps calling them strings. The collection validator
+     * describes what's stored, so the reference fields are overridden here after the plain
+     * conversion. Nullability and array shape carry over from the declared property.
+     */
+    applyReferenceTypes: (mongoSchema: Document, schema: AnySchema, refs: MongoReference[]) => Document;
+    /** The plain conversion of an object schema into a `$jsonSchema` document. */
+    schemaToMongoSchema: (schema: AnySchema) => Document;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/schema/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,mBAAmB,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,QAAQ,CAAA;IACnG,8EAA8E;IAC9E,mBAAmB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,QAAQ,CAAA;CACrD"}

package/build/utils/schema/types.js

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

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

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

package/build/utils/schema.d.ts

@@ -1,12 +1,4 @@
-import type { AnySchema } from 'ajv';
-import type { Document } from 'mongodb';
-import type { MongoReference } from '../types.js';
-/**
- * Declared references are stored as `ObjectId`s while the AJV schema — which describes
- * the records the app exchanges — keeps calling them strings. The collection validator
- * describes what's stored, so the reference fields are overridden here after the plain
- * conversion. Nullability and array shape carry over from the declared property.
- */
-export declare const applyReferenceTypes: (mongoSchema: Document, schema: AnySchema, refs: MongoReference[]) => Document;
-export declare const schemaToMongoSchema: (schema: AnySchema) => Document;
+import type { MongoSchemaUtils } from './schema/types.js';
+export declare const createMongoSchemaUtils: () => MongoSchemaUtils;
+export declare const mongoSchemaUtils: MongoSchemaUtils;
 //# sourceMappingURL=schema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,KAAK,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,gBACjB,QAAQ,UAAU,SAAS,QAAQ,cAAc,EAAE,KAC/D,QAoBF,CAAA;AAED,eAAO,MAAM,mBAAmB,WAAY,SAAS,KAAG,QAmCvD,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,eAAO,MAAM,sBAAsB,QAAO,gBAiHzC,CAAA;AAED,eAAO,MAAM,gBAAgB,kBAA2B,CAAA"}

package/build/utils/schema.js

@@ -1,94 +1,92 @@
-/**
- * Declared references are stored as `ObjectId`s while the AJV schema — which describes
- * the records the app exchanges — keeps calling them strings. The collection validator
- * describes what's stored, so the reference fields are overridden here after the plain
- * conversion. Nullability and array shape carry over from the declared property.
- */
-export const applyReferenceTypes = (mongoSchema, schema, refs) => {
-    if (mongoSchema.properties == null || refs.length < 1) {
-        return mongoSchema;
-    }
-    const properties = schema.properties ?? {};
-    for (const ref of refs) {
-        const declared = properties[ref.field];
-        if (declared == null || mongoSchema.properties[ref.field] == null) {
-            continue;
+export const createMongoSchemaUtils = () => {
+    const applyReferenceTypes = (mongoSchema, schema, refs) => {
+        if (mongoSchema.properties == null || refs.length < 1) {
+            return mongoSchema;
         }
-        mongoSchema.properties[ref.field] = declared.type === 'array'
-            ? {
-                bsonType: declared.nullable ? ['array', 'null'] : 'array',
-                items: { bsonType: 'objectId' }
+        const properties = schema.properties ?? {};
+        for (const ref of refs) {
+            const declared = properties[ref.field];
+            if (declared == null || mongoSchema.properties[ref.field] == null) {
+                continue;
             }
-            : { bsonType: declared.nullable ? ['objectId', 'null'] : 'objectId' };
-    }
-    return mongoSchema;
-};
-export const schemaToMongoSchema = (schema) => {
-    const _schema = schema;
-    if (_schema.type !== 'object') {
-        throw new SyntaxError('Only object schemas can be converted to mongo schema');
-    }
-    const mongoSchems = {
-        bsonType: 'object',
-        properties: _schema.properties != null
-            ? 'allOf' in _schema.properties
-                ? covertAllOfProperties(_schema.properties.allOf) :
-                convertProperties(_schema.properties ?? {})
-            : undefined,
-        additionalProperties: _schema.additionalProperties != null
-            ? convertAdditionalProperties(_schema.additionalProperties)
-            : false,
-        ...(_schema.required != null ? { required: _schema.required } : {}),
+            mongoSchema.properties[ref.field] = declared.type === 'array'
+                ? {
+                    bsonType: declared.nullable ? ['array', 'null'] : 'array',
+                    items: { bsonType: 'objectId' }
+                }
+                : { bsonType: declared.nullable ? ['objectId', 'null'] : 'objectId' };
+        }
+        return mongoSchema;
     };
-    if (_schema.nullable) {
-        mongoSchems.bsonType = [mongoSchems.bsonType, 'null'];
-    }
-    if ("properties" in mongoSchems && mongoSchems.properties == null) {
-        delete mongoSchems.properties;
-    }
-    if ("required" in mongoSchems && mongoSchems.required == null
-        || Array.isArray(mongoSchems.required) && mongoSchems.required.length === 0) {
-        delete mongoSchems.required;
-    }
-    return mongoSchems;
-};
-const convertAdditionalProperties = (additionalProperties) => {
-    if (typeof additionalProperties === 'boolean') {
-        return additionalProperties;
-    }
-    return convertToBsonType(additionalProperties);
-};
-const convertProperties = (properties) => Object.fromEntries(Object.entries(properties).map(([key, value]) => {
-    if (key === 'oneOf') {
-        throw new SyntaxError('We dont support schemas with oneof properties definition');
-    }
-    return [key, convertToBsonType(value)];
-}));
-const covertAllOfProperties = (allOf) => allOf.map(schema => convertProperties(schema.properties ?? {}))
-    .reduce((properties, schema) => ({ ...properties, ...schema }), {});
-const prepareScalarType = (value) => {
-    const type = (Array.isArray(value.type) ? value.type : [value.type])
-        .map(type => type === 'boolean' ? 'bool' : type);
-    if (value.nullable) {
-        type.push('null');
-    }
-    return type.length === 1 ? type[0] : type;
-};
-const convertToBsonType = (value) => {
-    if (Array.isArray(value.type)) {
-        if ('properties' in value || 'additionalProperties' in value) {
-            return {
-                ...schemaToMongoSchema({ ...value, type: 'object' }),
-                bsonType: prepareScalarType(value)
-            };
+    const schemaToMongoSchema = (schema) => {
+        const _schema = schema;
+        if (_schema.type !== 'object') {
+            throw new SyntaxError('Only object schemas can be converted to mongo schema');
+        }
+        const mongoSchems = {
+            bsonType: 'object',
+            properties: _schema.properties != null
+                ? 'allOf' in _schema.properties
+                    ? covertAllOfProperties(_schema.properties.allOf) :
+                    convertProperties(_schema.properties ?? {})
+                : undefined,
+            additionalProperties: _schema.additionalProperties != null
+                ? convertAdditionalProperties(_schema.additionalProperties)
+                : false,
+            ...(_schema.required != null ? { required: _schema.required } : {}),
+        };
+        if (_schema.nullable) {
+            mongoSchems.bsonType = [mongoSchems.bsonType, 'null'];
+        }
+        if ("properties" in mongoSchems && mongoSchems.properties == null) {
+            delete mongoSchems.properties;
+        }
+        if ("required" in mongoSchems && mongoSchems.required == null
+            || Array.isArray(mongoSchems.required) && mongoSchems.required.length === 0) {
+            delete mongoSchems.required;
         }
-        return { bsonType: prepareScalarType(value) };
-    }
-    return value.type === 'object'
-        // `DateSchema` is `{ type: 'object', format: 'date-time' }`, so a date is detected by
-        // format rather than type — but it still has to honor `nullable`, otherwise an optional
-        // date left unset (the driver writes `undefined` as `null`) fails collection validation.
-        ? value.format === 'date-time' ? { bsonType: value.nullable ? ['date', 'null'] : 'date' } : schemaToMongoSchema(value)
-        : { bsonType: prepareScalarType(value) };
+        return mongoSchems;
+    };
+    const convertAdditionalProperties = (additionalProperties) => {
+        if (typeof additionalProperties === 'boolean') {
+            return additionalProperties;
+        }
+        return convertToBsonType(additionalProperties);
+    };
+    const convertProperties = (properties) => Object.fromEntries(Object.entries(properties).map(([key, value]) => {
+        if (key === 'oneOf') {
+            throw new SyntaxError('We dont support schemas with oneof properties definition');
+        }
+        return [key, convertToBsonType(value)];
+    }));
+    const covertAllOfProperties = (allOf) => allOf.map(schema => convertProperties(schema.properties ?? {}))
+        .reduce((properties, schema) => ({ ...properties, ...schema }), {});
+    const prepareScalarType = (value) => {
+        const type = (Array.isArray(value.type) ? value.type : [value.type])
+            .map(type => type === 'boolean' ? 'bool' : type);
+        if (value.nullable) {
+            type.push('null');
+        }
+        return type.length === 1 ? type[0] : type;
+    };
+    const convertToBsonType = (value) => {
+        if (Array.isArray(value.type)) {
+            if ('properties' in value || 'additionalProperties' in value) {
+                return {
+                    ...schemaToMongoSchema({ ...value, type: 'object' }),
+                    bsonType: prepareScalarType(value)
+                };
+            }
+            return { bsonType: prepareScalarType(value) };
+        }
+        return value.type === 'object'
+            // `DateSchema` is `{ type: 'object', format: 'date-time' }`, so a date is detected by
+            // format rather than type — but it still has to honor `nullable`, otherwise an optional
+            // date left unset (the driver writes `undefined` as `null`) fails collection validation.
+            ? value.format === 'date-time' ? { bsonType: value.nullable ? ['date', 'null'] : 'date' } : schemaToMongoSchema(value)
+            : { bsonType: prepareScalarType(value) };
+    };
+    return { applyReferenceTypes, schemaToMongoSchema };
 };
+export const mongoSchemaUtils = createMongoSchemaUtils();
 //# sourceMappingURL=schema.js.map

package/build/utils/schema.js.map

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

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

@@ -0,0 +1,13 @@
+import type { MigrationStage } from '@owlmeans/resource';
+export interface LedgerRecord {
+    alias: string;
+    name: string;
+    stage: MigrationStage;
+    checksum: string | null;
+    baseline: boolean;
+    startedAt: Date;
+    /** `null` while a replica is running it — the claim, not the completion. */
+    completedAt: Date | null;
+    durationMs: number | null;
+}
+//# sourceMappingURL=types.local.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.local.d.ts","sourceRoot":"","sources":["../../src/utils/types.local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,cAAc,CAAA;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,IAAI,CAAA;IACf,4EAA4E;IAC5E,WAAW,EAAE,IAAI,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B"}

package/build/utils/types.local.js

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

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

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