@haverstack/core 0.40.0 → 0.42.0

package/dist/collection.d.ts.map

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

package/dist/collection.js

@@ -0,0 +1,407 @@
+/**
+ * Collections — typed access to one type family
+ * -------------------------------------------------------
+ * `client.collection(handle)` returns a `Collection<C>`: every verb that
+ * addresses records of the handle's family, each taking and returning the
+ * handle's content type with one signature. Implemented once over the
+ * public `StackClient` verbs, so `Stack` and `ScopedStack` share it and a
+ * collection can do nothing its client could not.
+ *
+ * The collection's scope is the handle's whole family. Each record is read
+ * as stored and migrated in memory to the handle's version, one at a time,
+ * so a record the handle cannot represent — one stored at a newer version —
+ * is reported as a misfit rather than failing the page it sits on. A
+ * content write to a record at an older version commits its migration as a
+ * write of its own first. See docs/spec/data-model.md § Type handles.
+ */
+import { StackBadRequestError, StackMigrationError, StackPermissionError } from './errors.js';
+import { baseIdOf, parseTypeId } from './schema.js';
+import { StoredVersionError, WRITE_EXPECTATION } from './stack/write-expectation.js';
+import { translateArm, translateSortKey, UNMATCHABLE, UNTRANSLATABLE, } from './content-translation.js';
+/**
+ * A record the collection asked for does not fit the handle. Raised only
+ * in the app's own process and never on the wire, so it sits outside the
+ * `StackError` taxonomy. A write that raises it after writing says so.
+ * See docs/spec/wire-format.md § The taxonomy root.
+ */
+export class MisfitError extends Error {
+    reason;
+    record;
+    constructor(misfit, handle, written = false) {
+        super(`Record "${misfit.id}" is stored at ${misfit.record.typeId}, newer than ${handle.id}` +
+            (written ? '; the write landed.' : '.'));
+        this.name = 'MisfitError';
+        this.reason = misfit.reason;
+        this.record = misfit.record;
+    }
+}
+// -------------------------------------------------------
+// Implementation
+// -------------------------------------------------------
+const versionOf = (typeId) => parseTypeId(typeId).version;
+/**
+ * A filter's `typeId` would narrow the family to one version, so an untyped
+ * caller passing one has it dropped rather than honoured.
+ */
+const withoutTypeId = (filter) => {
+    const { typeId: _typeId, ...rest } = (filter ?? {});
+    return rest;
+};
+/**
+ * A filter's content predicate, or undefined when it names no key. Only
+ * records stored at the handle's version are guaranteed to hold content in
+ * the handle's shape, so a predicate is what has to be translated.
+ */
+const contentPredicate = (filter) => {
+    const content = Object.keys(filter.content ?? {}).length > 0 ? filter.content : undefined;
+    const present = filter.contentPresent?.length ? filter.contentPresent : undefined;
+    if (!content && !present)
+        return undefined;
+    return { ...(content && { content }), ...(present && { contentPresent: present }) };
+};
+/** `filter` without its content predicate, for a query that asks about the rest. */
+const withoutContent = (filter) => {
+    const { content: _content, contentPresent: _present, ...rest } = filter;
+    return rest;
+};
+/**
+ * A content query's cursor: the adapter's, with the versions the first page
+ * queried, so a version defined mid-pagination cannot change the arms or
+ * the sort a cursor resumes, and a later page lists no types.
+ */
+const encodeContentCursor = (versions, cursor) => {
+    const bytes = new TextEncoder().encode(JSON.stringify({ v: versions, c: cursor }));
+    let binary = '';
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary);
+};
+const decodeContentCursor = (raw, handle) => {
+    const malformed = () => new StackBadRequestError(`Invalid cursor: malformed "${raw}"`);
+    let parsed;
+    try {
+        const binary = atob(raw);
+        const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
+        parsed = JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch {
+        throw malformed();
+    }
+    const { v, c } = (parsed ?? {});
+    if (typeof c !== 'string' ||
+        !Array.isArray(v) ||
+        !v.every((id) => typeof id === 'string' && parseTypeId(id)?.baseId === handle.baseId)) {
+        throw malformed();
+    }
+    return { versions: v, cursor: c };
+};
+/**
+ * The collection over `handle`, shared by `Stack.collection()` and
+ * `ScopedStack.collection()`. `registry` is the opening `Stack`'s, which
+ * the app's own process filled. `listTypes` names the family's versions,
+ * which `StackClient` does not offer.
+ */
+export const createCollection = (client, registry, handle, listTypes) => {
+    if (handle.migratesFrom !== undefined && !registry.path(handle.migratesFrom, handle.id)) {
+        throw new StackMigrationError(`No migration from "${handle.migratesFrom}" to "${handle.id}" was passed to Stack.open().`);
+    }
+    const writer = client;
+    const family = { baseId: handle.baseId };
+    const expect = (expectation = family) => ({
+        [WRITE_EXPECTATION]: expectation,
+    });
+    const handleVersion = versionOf(handle.id);
+    /**
+     * One record of the family, migrated to the handle's version, or the
+     * misfit it is. An older record with no migration to bridge the gap is
+     * the app's setup, not the record's, and throws.
+     */
+    const classify = (record) => {
+        if (record.typeId === handle.id)
+            return { record: record };
+        if (versionOf(record.typeId) > handleVersion) {
+            return { misfit: { id: record.id, reason: 'newer-version', record } };
+        }
+        const migrate = registry.path(record.typeId, handle.id);
+        if (!migrate) {
+            throw new StackMigrationError(`Record "${record.id}" is at "${record.typeId}", and no migration passed to ` +
+                `Stack.open() carries it to "${handle.id}".`);
+        }
+        const content = migrate(record.content);
+        return { record: { ...record, typeId: handle.id, content } };
+    };
+    /** A record a write returned, narrowed as `get()` narrows it. */
+    const narrow = (record, written) => {
+        const result = classify(record);
+        if ('misfit' in result)
+            throw new MisfitError(result.misfit, handle, written);
+        return result.record;
+    };
+    /**
+     * A content write to a record stored at an older version: commit its
+     * migration as a write of its own, fenced to the state the caller read,
+     * then apply the write fenced to the version the migration produced. A
+     * patch never folds a migration in. See docs/spec/data-model.md § Type
+     * migrations.
+     */
+    const migrateThenMutate = async (stored, changes, opts) => {
+        const migrated = classify(stored);
+        if ('misfit' in migrated)
+            throw new MisfitError(migrated.misfit, handle);
+        let committed;
+        try {
+            committed = await client.commitMigration(stored.id, handle.id, migrated.record.content, {
+                ifVersion: stored.version,
+            });
+        }
+        catch (err) {
+            if (!(err instanceof StackPermissionError))
+                throw err;
+            throw new StackPermissionError(`Record "${stored.id}" is stored at ${stored.typeId} and must be migrated to ` +
+                `${handle.id} before this write: ${err.message}`);
+        }
+        const written = await writer.mutate(stored.id, changes, {
+            ...opts,
+            ifVersion: committed.version,
+            ...expect({ ...family, typeId: handle.id }),
+        });
+        return narrow(written, true);
+    };
+    /**
+     * Whether any record matches, or may match, `filter`. A scoped page can
+     * be empty with a cursor set, and reading on is unbounded, so that page
+     * counts as a match.
+     */
+    const anyMatch = async (filter) => {
+        const page = await client.query({ filter, limit: 1 });
+        return page.records.length > 0 || page.cursor !== null;
+    };
+    /** Whether a record stored at one of `typeIds` matches `filter` without its content keys. */
+    const anyAt = async (typeIds, filter) => {
+        if (typeIds.length === 0)
+            return false;
+        return anyMatch({ ...withoutContent(filter), typeId: typeIds });
+    };
+    /**
+     * Whether records at an older version hold what its arm left out: each
+     * residual is that arm with another source value in place, at its typeId.
+     */
+    const anyResidual = async (residuals, filter) => {
+        const rest = withoutContent(filter);
+        const found = await Promise.all(residuals.map((residual) => anyMatch({ ...rest, ...residual })));
+        return found.some(Boolean);
+    };
+    /**
+     * A content query as one arm per version it translates to, plus what the
+     * first page probes for `skipped`. `pinned` is the versions a first page
+     * chose, which a later page reuses. See docs/spec/data-model.md § Content
+     * queries across versions.
+     */
+    const planContentQuery = async (filter, sort, pinned) => {
+        const predicate = contentPredicate(filter);
+        const sortField = sort?.contentField;
+        const { capabilities } = client;
+        // A version past the adapter's cap is narrowed, newest kept first:
+        // the older a version, the fewer apps still write it.
+        const filterCap = predicate === undefined
+            ? Infinity
+            : capabilities.filter.content === 'none'
+                ? 0
+                : capabilities.filter.contentByType;
+        const sortCap = sortField === undefined ? Infinity : capabilities.sort.contentFieldByType;
+        const cap = Math.min(filterCap, sortCap);
+        const sortKind = (() => {
+            const def = sortField === undefined ? undefined : handle.schema[sortField];
+            return def && def.kind !== 'array' && def.kind !== 'object' ? def.kind : undefined;
+        })();
+        const family = (pinned
+            ? pinned.map((id) => ({ id, baseId: handle.baseId, version: versionOf(id) }))
+            : await listTypes())
+            .filter((type) => type.baseId === handle.baseId && type.version !== handleVersion)
+            .sort((a, b) => b.version - a.version);
+        const arms = { [handle.id]: predicate ?? {} };
+        const keys = sortField
+            ? { [handle.id]: { field: sortField } }
+            : {};
+        const narrowed = [];
+        const newer = [];
+        const residuals = [];
+        for (const type of family) {
+            if (type.version > handleVersion) {
+                newer.push(type.id);
+                continue;
+            }
+            const origins = registry.origins(type.id, handle.id);
+            const translated = !predicate
+                ? { arm: {}, residuals: [] }
+                : origins
+                    ? translateArm(origins, predicate)
+                    : UNTRANSLATABLE;
+            if (translated === UNMATCHABLE)
+                continue;
+            const key = sortField === undefined
+                ? undefined
+                : origins
+                    ? translateSortKey(origins, sortField, sortKind)
+                    : UNTRANSLATABLE;
+            if (translated === UNTRANSLATABLE ||
+                key === UNTRANSLATABLE ||
+                Object.keys(arms).length >= cap) {
+                narrowed.push(type.id);
+                continue;
+            }
+            arms[type.id] = translated.arm;
+            if (key)
+                keys[type.id] = key;
+            for (const arm of translated.residuals)
+                residuals.push({ ...arm, typeId: type.id });
+        }
+        const rest = withoutContent(filter);
+        const typeIds = Object.keys(arms);
+        if (typeIds.length === 1) {
+            return {
+                query: { filter: { ...filter, typeId: handle.id }, sort },
+                versions: typeIds,
+                narrowed,
+                newer,
+                residuals,
+            };
+        }
+        return {
+            query: {
+                filter: predicate ? { ...rest, contentByType: arms } : { ...rest, typeId: typeIds },
+                sort: sortField
+                    ? { contentFieldByType: keys, ...(sort?.direction && { direction: sort.direction }) }
+                    : sort,
+            },
+            versions: typeIds,
+            narrowed,
+            newer,
+            residuals,
+        };
+    };
+    const mutate = async (id, changes, opts = {}) => {
+        try {
+            const written = await writer.mutate(id, changes, {
+                ...opts,
+                ...expect({ ...family, typeId: handle.id }),
+            });
+            return narrow(written, true);
+        }
+        catch (err) {
+            if (!(err instanceof StoredVersionError))
+                throw err;
+            return migrateThenMutate(err.record, changes, opts);
+        }
+    };
+    return {
+        async get(id) {
+            const record = await client.get(id);
+            if (!record || baseIdOf(record.typeId) !== handle.baseId)
+                return null;
+            return narrow(record, false);
+        },
+        async query(query = {}) {
+            if (query.filter?.includeDeleted) {
+                throw new StackBadRequestError('A collection reads live records only; use the untyped query() to include soft-deleted records.');
+            }
+            // Stripped as well as untyped: either would change which records a
+            // page holds, or the shape they arrive in.
+            const { presentAt: _presentAt, filter, ...rest } = query;
+            // A concrete typeId needs no family lookup; baseId does.
+            const { baseId: _baseId, contentByType: _byType, ...unversioned } = withoutTypeId(filter);
+            const firstPage = rest.cursor === undefined;
+            let records;
+            let cursor;
+            let skipped;
+            if (!contentPredicate(unversioned) && rest.sort?.contentField === undefined) {
+                ({ records, cursor } = await client.query({
+                    ...rest,
+                    filter: { ...unversioned, baseId: handle.baseId },
+                }));
+                if (firstPage)
+                    skipped = { older: false, newer: false };
+            }
+            else {
+                const resumed = firstPage ? undefined : decodeContentCursor(rest.cursor, handle);
+                const plan = await planContentQuery(unversioned, rest.sort, resumed?.versions);
+                const [page, narrowed, residual, newer] = await Promise.all([
+                    client.query({ ...rest, cursor: resumed?.cursor, ...plan.query }),
+                    firstPage && anyAt(plan.narrowed, unversioned),
+                    firstPage && anyResidual(plan.residuals, unversioned),
+                    firstPage && anyAt(plan.newer, unversioned),
+                ]);
+                records = page.records;
+                cursor = page.cursor && encodeContentCursor(plan.versions, page.cursor);
+                if (firstPage)
+                    skipped = { older: narrowed || residual, newer };
+            }
+            const page = {
+                records: [],
+                misfits: [],
+                cursor,
+                ...(skipped && { skipped }),
+            };
+            for (const stored of records) {
+                const result = classify(stored);
+                if ('misfit' in result)
+                    page.misfits.push(result.misfit);
+                else
+                    page.records.push(result.record);
+            }
+            return page;
+        },
+        subscribe(handler, opts = {}) {
+            return client.subscribe((change) => {
+                const { record, ...rest } = change;
+                // A tombstone's content is `{}` under ScopedStack, so it is never
+                // typed as the handle's content on either surface. A record that
+                // migrated out of the family matches by its previous typeId.
+                if (!record || record.deletedAt || baseIdOf(record.typeId) !== handle.baseId) {
+                    return handler(rest);
+                }
+                let result;
+                try {
+                    result = classify(record);
+                }
+                catch {
+                    // A missing or failing migration: delivered as wherever the
+                    // emitter cannot supply the record, and get() says why.
+                    return handler(rest);
+                }
+                handler({ ...rest, ...result });
+            }, { ...opts, filter: { ...withoutTypeId(opts.filter), baseId: handle.baseId } });
+        },
+        async create(content, opts) {
+            return (await client.create(handle.id, content, opts));
+        },
+        mutate: (id, changes, opts) => mutate(id, changes, opts),
+        patchContent: (id, patch, opts) => mutate(id, { contentPatch: patch }, opts),
+        async associate(id, associations) {
+            return narrow(await writer.associate(id, associations, expect()), true);
+        },
+        async dissociate(id, associations) {
+            return narrow(await writer.dissociate(id, associations, expect()), true);
+        },
+        async amendAssociations(id, changes) {
+            return narrow(await writer.amendAssociations(id, changes, expect()), true);
+        },
+        async grantAccess(id, permissions) {
+            return narrow(await writer.grantAccess(id, permissions, expect()), true);
+        },
+        async revokeAccess(id, permissions) {
+            return narrow(await writer.revokeAccess(id, permissions, expect()), true);
+        },
+        async amendAccess(id, changes) {
+            return narrow(await writer.amendAccess(id, changes, expect()), true);
+        },
+        delete: (id, opts) => writer.delete(id, { ...opts, ...expect() }),
+        async undelete(id, opts) {
+            return narrow(await writer.undelete(id, { ...opts, ...expect() }), true);
+        },
+        async restoreVersion(id, version, opts) {
+            return narrow(await writer.restoreVersion(id, version, { ...opts, ...expect() }), true);
+        },
+    };
+};
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

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

package/dist/content-match.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Content predicates, evaluated in memory
+ * -------------------------------------------------------
+ * How a `content` filter value and a `contentPresent` path are matched
+ * against one content object: element-wise through arrays, with `null`
+ * standing for "no value". MemoryAdapter answers queries with it, and a
+ * collection decides a constant a migration added the same way, so a key
+ * dropped in core matches exactly what an adapter would have matched. See
+ * docs/spec/data-model.md § Nested content paths.
+ */
+import type { ContentArm } from './types/index.js';
+/**
+ * Every value reachable by walking `segments`, spreading arrays at each
+ * step — sqlite-shared's contentPathExists() walk, so a filter answers the
+ * same against either. Empty means the path reaches nothing, which a `null`
+ * filter value matches.
+ */
+export declare const valuesAtContentPath: (content: Record<string, unknown>, segments: string[]) => unknown[];
+/**
+ * Whether `content` satisfies a `content` and `contentPresent` predicate. A
+ * `null` filter value means "field absent or null", not "match nothing":
+ * plain `===` would miss an absent field (docs/spec/data-model.md § Filter).
+ */
+export declare const matchesContent: (content: Record<string, unknown>, predicate: ContentArm) => boolean;
+//# sourceMappingURL=content-match.d.ts.map

package/dist/content-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-match.d.ts","sourceRoot":"","sources":["../src/content-match.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,MAAM,EAAE,KACjB,OAAO,EAeT,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,UAAU,KAAG,OAYtF,CAAC"}

package/dist/content-match.js

@@ -0,0 +1,51 @@
+/**
+ * Content predicates, evaluated in memory
+ * -------------------------------------------------------
+ * How a `content` filter value and a `contentPresent` path are matched
+ * against one content object: element-wise through arrays, with `null`
+ * standing for "no value". MemoryAdapter answers queries with it, and a
+ * collection decides a constant a migration added the same way, so a key
+ * dropped in core matches exactly what an adapter would have matched. See
+ * docs/spec/data-model.md § Nested content paths.
+ */
+import { parseContentFilterKey } from './query-validation.js';
+/** An array stands for its elements; anything else stands for itself. */
+const spreadValue = (value) => (Array.isArray(value) ? value : [value]);
+/**
+ * Every value reachable by walking `segments`, spreading arrays at each
+ * step — sqlite-shared's contentPathExists() walk, so a filter answers the
+ * same against either. Empty means the path reaches nothing, which a `null`
+ * filter value matches.
+ */
+export const valuesAtContentPath = (content, segments) => {
+    let current = [content];
+    for (const segment of segments) {
+        const next = [];
+        for (const value of current) {
+            for (const item of spreadValue(value)) {
+                if (typeof item !== 'object' || item === null || Array.isArray(item))
+                    continue;
+                if (Object.hasOwn(item, segment))
+                    next.push(item[segment]);
+            }
+        }
+        current = next;
+    }
+    // The leaf spreads too, so a filter on `tags` matches a record whose
+    // `tags` array contains the value.
+    return current.flatMap(spreadValue);
+};
+/**
+ * Whether `content` satisfies a `content` and `contentPresent` predicate. A
+ * `null` filter value means "field absent or null", not "match nothing":
+ * plain `===` would miss an absent field (docs/spec/data-model.md § Filter).
+ */
+export const matchesContent = (content, predicate) => Object.entries(predicate.content ?? {}).every(([key, value]) => {
+    const found = valuesAtContentPath(content, parseContentFilterKey(key));
+    if (value === null || value === undefined) {
+        return found.length === 0 || found.some((v) => v === null || v === undefined);
+    }
+    return found.some((v) => v === value);
+}) &&
+    (predicate.contentPresent ?? []).every((key) => valuesAtContentPath(content, parseContentFilterKey(key)).some((v) => v !== null && v !== undefined));
+//# sourceMappingURL=content-match.js.map

package/dist/content-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-match.js","sourceRoot":"","sources":["../src/content-match.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,yEAAyE;AACzE,MAAM,WAAW,GAAG,CAAC,KAAc,EAAa,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAE5F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,OAAgC,EAChC,QAAkB,EACP,EAAE;IACb,IAAI,OAAO,GAAc,CAAC,OAAO,CAAC,CAAC;IACnC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAc,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAC/E,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAE,IAAgC,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;QACD,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,qEAAqE;IACrE,mCAAmC;IACnC,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAgC,EAAE,SAAqB,EAAW,EAAE,CACjG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;IAC7D,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;AACxC,CAAC,CAAC;IACF,CAAC,SAAS,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAC7C,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAC3D,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,CACrC,CACF,CAAC"}

package/dist/content-translation.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Content queries across versions
+ * -------------------------------------------------------
+ * A collection's content filter and sort are written in its handle's
+ * shape, and an adapter matches content as stored. These functions rewrite
+ * one predicate or sort field into an older version's shape, through the
+ * field origins a migration chain declares, or say why they cannot: an arm
+ * no record at that version can match is dropped, and one that does not
+ * translate is narrowed. See docs/spec/data-model.md § Content queries
+ * across versions.
+ */
+import type { FieldOrigins } from './migration-steps.js';
+import type { ContentArm, ContentSortKey, ScalarFieldKind } from './types/index.js';
+/** No record at the version can match, so its arm is dropped without a skip. */
+export declare const UNMATCHABLE = "unmatchable";
+/** The version is narrowed: left out of the query, and reported if it matches the rest. */
+export declare const UNTRANSLATABLE = "untranslatable";
+type Untranslated = typeof UNMATCHABLE | typeof UNTRANSLATABLE;
+/**
+ * An older version's arm, and the arms it leaves out: when two older
+ * values map to the one a key asks for, the arm asks for the first and
+ * each other one becomes a residual, which the first page probes for
+ * `skipped.older` rather than narrowing the version outright.
+ */
+export type TranslatedArm = {
+    arm: ContentArm;
+    residuals: ContentArm[];
+};
+/**
+ * `predicate`, written in the handle's shape, as the arm for the version
+ * `origins` describes. A key is translated by its top-level field: the
+ * rest of its path is kept, since steps reach top-level fields only.
+ */
+export declare const translateArm: (origins: FieldOrigins, predicate: ContentArm) => TranslatedArm | Untranslated;
+/**
+ * What a record at the version `origins` describes orders by, for a sort
+ * on the handle's `field` of `kind`. A remapped field is narrowed, since
+ * remapped values don't keep their order.
+ */
+export declare const translateSortKey: (origins: FieldOrigins, field: string, kind: ScalarFieldKind | undefined) => ContentSortKey | typeof UNTRANSLATABLE;
+export {};
+//# sourceMappingURL=content-translation.d.ts.map

package/dist/content-translation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-translation.d.ts","sourceRoot":"","sources":["../src/content-translation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEpF,gFAAgF;AAChF,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,2FAA2F;AAC3F,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C,KAAK,YAAY,GAAG,OAAO,WAAW,GAAG,OAAO,cAAc,CAAC;AAwB/D;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,SAAS,YAAY,EACrB,WAAW,UAAU,KACpB,aAAa,GAAG,YAmDlB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,YAAY,EACrB,OAAO,MAAM,EACb,MAAM,eAAe,GAAG,SAAS,KAChC,cAAc,GAAG,OAAO,cAM1B,CAAC"}