@haverstack/core 0.41.0 → 0.43.0

package/dist/collection.d.ts

@@ -0,0 +1,178 @@
+/**
+ * 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 type { MigrationRegistry } from './stack/migrations.js';
+import type { CreateRecordOptions, DeleteRecordOptions, DeleteResult, StackClient } from './stack/client.js';
+import type { ContentOf, ReadonlyTypeSchema, TypeHandle, UnlistedValue } from './type-handle.js';
+import type { AssociationEdit, AuthorityAssociation, ChangeFilter, DataAssociation, IfVersionOptions, NativeSortField, RecordChange, RecordFilter, RecordId, StackQuery, StackType, StackRecord, SubscribeOptions, Unsubscribe } from './types/index.js';
+/**
+ * Content `C` as a read returns it: an enum may hold a value the handle
+ * does not list, since an enum can widen in place. Never flattens `C`, so
+ * an app that names its content with an `interface` keeps that name.
+ */
+export type StoredContent<C> = C extends string ? string extends C ? C : C | UnlistedValue : C extends readonly (infer I)[] ? StoredContent<I>[] : C extends object ? {
+    [K in keyof C]: StoredContent<C[K]>;
+} : C;
+/**
+ * The `contentPatch` content `C` accepts: every field optional, and `null`
+ * (removal) only on a field that is optional in `C`.
+ */
+export type ContentPatch<C> = {
+    [K in keyof C]?: Pick<C, K> extends Required<Pick<C, K>> ? C[K] : Exclude<C[K], undefined> | null;
+};
+/** A record of the collection, migrated to the handle's version. */
+export interface CollectionRecord<C> extends Omit<StackRecord, 'content'> {
+    content: StoredContent<C>;
+}
+/**
+ * A record in the handle's family that the handle cannot represent. Stored
+ * at a version newer than the handle's, it cannot be migrated down.
+ */
+export type Misfit = {
+    id: RecordId;
+    reason: 'newer-version';
+    /** Untyped, as stored. */
+    record: StackRecord;
+};
+/**
+ * A page of a collection. Misfits do not count as records, so a page can
+ * hold fewer than `limit` records with a cursor still set: the results end
+ * when `cursor` is `null`, not when a page comes back short.
+ */
+export type CollectionPage<C> = {
+    records: CollectionRecord<C>[];
+    misfits: Misfit[];
+    cursor: string | null;
+    /**
+     * Set when records at a version a content filter or sort could not reach
+     * match, or may match, the rest of the query. On the first page only,
+     * since it depends on the query rather than the page. See
+     * docs/spec/data-model.md § Content queries across versions.
+     */
+    skipped?: {
+        older: boolean;
+        newer: boolean;
+    };
+};
+/**
+ * Path typing stops at this depth and accepts any suffix below it, since a
+ * recursive path type otherwise exceeds the compiler's instantiation limit.
+ * A typing limit, not a query limit: see docs/spec/data-model.md § Nested
+ * content paths.
+ */
+type PathDepth = [never, 0, 1, 2, 3, 4];
+/** What a filter value can equal: an adapter compares the value a path reaches. */
+type Leaf = string | number | boolean;
+/**
+ * Each content path of `V` reached at `P`, paired with the value a filter
+ * compares there. An array is matched element-wise, so it is its element.
+ * An object never equals a filter value, so its path takes only `null`.
+ */
+type PathEntry<P extends string, V, D extends number> = [D] extends [never] ? [P | `${P}.${string}`, Leaf] : V extends readonly (infer E)[] ? unknown extends E ? [P | `${P}.${string}`, Leaf] : PathEntry<P, E, PathDepth[D]> : V extends object ? string extends keyof V ? [P, null] | [`${P}.${string}`, Leaf] : [P, null] | FieldEntry<V, `${P}.`, PathDepth[D]> : [P, V];
+/** `Required<C>[K]` rather than `NonNullable`, which would leak into errors. */
+type FieldEntry<C, Prefix extends string, D extends number> = [D] extends [never] ? [`${Prefix}${string}`, Leaf] : {
+    [K in keyof C & string]-?: PathEntry<`${Prefix}${K}`, Required<C>[K], D>;
+}[keyof C & string];
+/**
+ * Every content path of `C`: its fields, and dotted paths through declared
+ * objects and arrays. Below an `open` object or array, or six segments
+ * deep, any suffix is a path.
+ */
+export type ContentPathOf<C> = FieldEntry<C, '', 5>[0];
+/** The top-level scalar fields of `C`, the ones a content sort reaches. */
+export type SortableFieldOf<C> = string extends keyof C ? string : {
+    [K in keyof C & string]-?: Required<C>[K] extends string | number | boolean ? K : never;
+}[keyof C & string];
+/**
+ * A collection reads live records of its own family only, as stored, so
+ * none of `typeId`, `baseId`, `includeDeleted`, `presentAt` or the per-Type
+ * shapes it generates itself is offered. Content filter keys and the sort
+ * field are checked against `C`, and carried to older versions through the
+ * migrations. See docs/spec/data-model.md § Type handles.
+ */
+export type CollectionQuery<C> = Omit<StackQuery, 'filter' | 'presentAt' | 'sort'> & {
+    filter?: Omit<RecordFilter, 'typeId' | 'baseId' | 'includeDeleted' | 'content' | 'contentPresent' | 'contentByType'> & {
+        content?: {
+            [E in FieldEntry<C, '', 5> as E[0]]?: E[1] | null;
+        };
+        contentPresent?: ContentPathOf<C>[];
+    };
+    sort?: {
+        field: NativeSortField;
+        contentField?: never;
+        direction?: 'asc' | 'desc';
+    } | {
+        field?: never;
+        contentField: SortableFieldOf<C>;
+        direction?: 'asc' | 'desc';
+    };
+};
+/** The family is the collection's, so neither `typeId` nor `baseId` is a filter key. */
+export type CollectionSubscribeOptions = Omit<SubscribeOptions, 'filter'> & {
+    filter?: Omit<ChangeFilter, 'typeId' | 'baseId'>;
+};
+/**
+ * A change to a record of the family. `record`, when present, is migrated
+ * to the handle's version; `typeId` stays the stored one. A change whose
+ * record does not fit carries `misfit` instead, and one whose record is a
+ * tombstone carries neither.
+ */
+export type CollectionChange<C> = Omit<RecordChange, 'record'> & {
+    record?: CollectionRecord<C>;
+    misfit?: Misfit;
+};
+/**
+ * Typed access to one type family. History (`getVersions`, `getVersion`,
+ * `getJournal`) spans versions by nature and stays on `StackClient`. See
+ * docs/spec/data-model.md § Type handles.
+ */
+export interface Collection<C> {
+    /** `null` for a missing record, a tombstone, or a record of another family. */
+    get(id: RecordId): Promise<CollectionRecord<C> | null>;
+    query(query?: CollectionQuery<C>): Promise<CollectionPage<C>>;
+    subscribe(handler: (change: CollectionChange<C>) => void, opts?: CollectionSubscribeOptions): Promise<Unsubscribe>;
+    create(content: C, opts?: CreateRecordOptions): Promise<CollectionRecord<C>>;
+    patchContent(id: RecordId, patch: ContentPatch<C>, opts?: IfVersionOptions): Promise<CollectionRecord<C>>;
+    setParent(id: RecordId, parentId: RecordId | null, opts?: IfVersionOptions): Promise<CollectionRecord<C>>;
+    setUnlisted(id: RecordId, unlisted: boolean, opts?: IfVersionOptions): Promise<CollectionRecord<C>>;
+    editAssociations(id: RecordId, edits: AssociationEdit[], opts?: IfVersionOptions): Promise<CollectionRecord<C>>;
+    setAssociations(id: RecordId, associations: DataAssociation[], opts?: IfVersionOptions): Promise<CollectionRecord<C>>;
+    editAccess(id: RecordId, edits: AssociationEdit[], opts?: IfVersionOptions): Promise<CollectionRecord<C>>;
+    setAccess(id: RecordId, permissions: AuthorityAssociation[], opts?: IfVersionOptions): Promise<CollectionRecord<C>>;
+    delete(id: RecordId, opts?: DeleteRecordOptions): Promise<DeleteResult>;
+    undelete(id: RecordId, opts?: IfVersionOptions): Promise<CollectionRecord<C>>;
+    restoreVersion(id: RecordId, version: number, opts?: IfVersionOptions): Promise<CollectionRecord<C>>;
+}
+/**
+ * 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 declare class MisfitError extends Error {
+    readonly reason: Misfit['reason'];
+    readonly record: StackRecord;
+    constructor(misfit: Misfit, handle: TypeHandle, written?: boolean);
+}
+/**
+ * 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 declare const createCollection: <S extends ReadonlyTypeSchema>(client: StackClient, registry: MigrationRegistry, handle: TypeHandle<S>, listTypes: () => Promise<StackType[]>) => Collection<ContentOf<S>>;
+export {};
+//# sourceMappingURL=collection.d.ts.map

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,397 @@
+/**
+ * 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 migrateThenPatch = async (stored, patch, 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.patchContent(stored.id, patch, {
+            ...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;
+        // Spanning versions takes the per-Type shape of each content key the
+        // query carries; an adapter without one gets the handle's version alone.
+        const spans = (predicate === undefined || capabilities.filter.contentByType) &&
+            (sortField === undefined || capabilities.sort.contentFieldByType);
+        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);
+        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 || !spans) {
+                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 patchContent = async (id, patch, opts = {}) => {
+        try {
+            const written = await writer.patchContent(id, patch, {
+                ...opts,
+                ...expect({ ...family, typeId: handle.id }),
+            });
+            return narrow(written, true);
+        }
+        catch (err) {
+            if (!(err instanceof StoredVersionError))
+                throw err;
+            return migrateThenPatch(err.record, patch, 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));
+        },
+        patchContent: (id, patch, opts) => patchContent(id, patch, opts),
+        async setParent(id, parentId, opts) {
+            return narrow(await writer.setParent(id, parentId, { ...opts, ...expect() }), true);
+        },
+        async setUnlisted(id, unlisted, opts) {
+            return narrow(await writer.setUnlisted(id, unlisted, { ...opts, ...expect() }), true);
+        },
+        async editAssociations(id, edits, opts) {
+            return narrow(await writer.editAssociations(id, edits, { ...opts, ...expect() }), true);
+        },
+        async setAssociations(id, associations, opts) {
+            return narrow(await writer.setAssociations(id, associations, { ...opts, ...expect() }), true);
+        },
+        async editAccess(id, edits, opts) {
+            return narrow(await writer.editAccess(id, edits, { ...opts, ...expect() }), true);
+        },
+        async setAccess(id, permissions, opts) {
+            return narrow(await writer.setAccess(id, permissions, { ...opts, ...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 — the walk sqlite-shared runs in SQL, 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"}