@sunfall/arc-db 0.1.0-alpha.0

package/dist/collection-runtime.js

@@ -0,0 +1,256 @@
+import { EffectInputCallbackError, runFork } from "@sunfall/arc-core";
+import { Effect, Option, Scope } from "effect";
+import { CollectionRowKeyChanged, CollectionRowNotFound, ReadonlyCollectionMutation, } from "./collection-errors.js";
+import { CollectionTypeId } from "./collection-ids.js";
+import { CollectionPreloadCollector } from "./collection-preload.js";
+import { applyCollectionBaseRow, augmentCollectionRow, deleteCollectionBaseRow, rebaseCollectionBaseRows, } from "./collection-state.js";
+import { rowsByCollectionIndex } from "./collection-index-materialization.js";
+import { subscribeCollectionChangeFeedRuntimeEffect } from "./collection-change-feed-runtime.js";
+import { ingestCollectionMutationRowsEffect, ingestCollectionOutputRowsEffect, } from "./collection-row-ingress.js";
+import { pendingMutationSnapshots } from "./collection-mutation-queue.js";
+import { applyCollectionUpdateEffect, collectionStateEffect, ensureCollectionRowKey, } from "./collection-projection-callback-policy.js";
+import { deleteCollectionMutationEffect, flushCollectionPendingMutationsEffect, insertCollectionMutationEffect, updateCollectionMutationEffect, } from "./collection-mutation-workflow.js";
+import { collectionPersistenceKey, dehydrateCollections as dehydrateCollectionsWithStore, dehydrateCollectionsEffect as dehydrateCollectionsWithStoreEffect, hydrateCollectionEffect as hydrateCollectionWithStoreEffect, hydrateCollectionsEffect as hydrateCollectionsWithStoreEffect, validateCollectionsHydrationEffect as validateCollectionsHydrationWithStoreEffect, persistCollectionEffect as persistCollectionWithStoreEffect, persistCollectionForReasonEffect, restoreCollectionEffect as restoreCollectionWithStoreEffect, snapshotCollection as snapshotCollectionWithStore, snapshotCollectionEffect as snapshotCollectionWithStoreEffect, } from "./collection-persistence.js";
+import { commitCollectionWriteEffect } from "./collection-write-commit.js";
+import { runCollectionSyncLoadPolicyEffect } from "./collection-sync-load-policy.js";
+import { collectionStoreEffect, currentCollectionStore, } from "./runtime-collection-store.js";
+export { collectionStoreEffect, currentCollectionStore, runWithCollectionStore, storeFor, subscribeCollectionEventsEffect, } from "./runtime-collection-store.js";
+export const recordCollectionPreload = (definition) => Effect.gen(function* () {
+    const collector = yield* Effect.serviceOption(CollectionPreloadCollector);
+    if (Option.isSome(collector)) {
+        collector.value.definitions.push(definition);
+    }
+});
+const publishStoreEvent = (store, event) => store.publish(event);
+const toArray = (input) => Array.isArray(input) ? input : [input];
+const collectionState = (definition, store = currentCollectionStore()) => {
+    return store.state(definition);
+};
+const rowsByIndex = (definition, index, value) => {
+    const state = collectionState(definition);
+    return rowsByCollectionIndex(definition, state, index, value);
+};
+const collectionPendingMutations = (definition, store = currentCollectionStore()) => {
+    const state = collectionState(definition, store);
+    state.version.get();
+    return pendingMutationSnapshots(state);
+};
+const collectionPendingMutationsEffect = (definition) => Effect.map(collectionStoreEffect, (store) => collectionPendingMutations(definition, store));
+const snapshotCollection = (definition, store = currentCollectionStore(), updatedAt = Date.now()) => snapshotCollectionWithStore(definition, store, updatedAt);
+const snapshotCollectionEffect = (definition) => snapshotCollectionWithStoreEffect(definition, collectionStoreEffect);
+const hydrateCollectionEffect = (definition, snapshot, options = {}, store) => hydrateCollectionWithStoreEffect(definition, snapshot, options, collectionStoreEffect, store);
+export const persistenceKey = (definition, options = {}) => collectionPersistenceKey(definition, options);
+const persistCollectionEffect = (definition, storage, options = {}, store) => persistCollectionWithStoreEffect(definition, storage, options, collectionStoreEffect, store);
+const restoreCollectionEffect = (definition, storage, options = {}, store) => restoreCollectionWithStoreEffect(definition, storage, options, collectionStoreEffect, store);
+const persistForReasonEffect = (definition, store, reason) => persistCollectionForReasonEffect(definition, store, collectionStoreEffect, reason);
+export const dehydrateCollections = (collections, store = currentCollectionStore()) => dehydrateCollectionsWithStore(collections, store);
+export const dehydrateCollectionsEffect = (collections) => dehydrateCollectionsWithStoreEffect(collections, collectionStoreEffect);
+export const hydrateCollectionsEffect = (collections, payload, options = {}) => hydrateCollectionsWithStoreEffect(collections, payload, options, collectionStoreEffect);
+export const validateCollectionsHydrationEffect = (collections, payload, options = {}) => validateCollectionsHydrationWithStoreEffect(collections, payload, options, collectionStoreEffect);
+export const subscribeCollectionChangesEffect = (definition, adapter, options = {}) => Effect.gen(function* () {
+    if (definition.readOnly === true) {
+        return yield* Effect.fail(new ReadonlyCollectionMutation({
+            collection: definition.name,
+            operation: "subscribeChangesEffect",
+        }));
+    }
+    const dbStore = yield* collectionStoreEffect;
+    yield* subscribeCollectionChangeFeedRuntimeEffect({
+        collection: definition.name,
+        adapter,
+        options,
+        applyChanges: (changes, writeOptions) => applyCollectionChangesWithStoreEffect(definition, dbStore, changes, writeOptions),
+        publishFailure: (error) => publishStoreEvent(dbStore, {
+            _tag: "CollectionChangeFeedFailure",
+            collection: definition.name,
+            error,
+        }),
+    });
+}).pipe(Effect.asVoid);
+const writeRows = (definition, input, options = {}) => Effect.gen(function* () {
+    const values = toArray(input);
+    if (values.length === 0) {
+        return;
+    }
+    const dbStore = yield* collectionStoreEffect;
+    const state = yield* collectionStateEffect(definition, dbStore);
+    const rows = yield* ingestCollectionMutationRowsEffect(definition, values, {
+        operation: "write",
+        path: `$.collections[${definition.name}].rows`,
+        synced: options.synced ?? true,
+        origin: options.origin ?? "remote",
+    });
+    yield* commitCollectionWriteEffect({
+        collection: definition.name,
+        state,
+        mutations: rows.length,
+        apply: () => {
+            const rebaseKeys = new Set();
+            for (const row of rows) {
+                applyCollectionBaseRow(state, row, rebaseKeys);
+            }
+            rebaseCollectionBaseRows(state, rebaseKeys);
+        },
+        persistEffect: persistForReasonEffect(definition, dbStore, "write"),
+        publishEffect: (event) => publishStoreEvent(dbStore, event),
+    });
+});
+const writeUpdateRow = (definition, key, changes, options = {}) => Effect.gen(function* () {
+    const dbStore = yield* collectionStoreEffect;
+    const state = yield* collectionStateEffect(definition, dbStore);
+    const row = state.optimisticRows.get(key)?.base ?? state.rows.get(key);
+    if (!row) {
+        return yield* new CollectionRowNotFound({ collection: definition.name, key });
+    }
+    const updated = yield* applyCollectionUpdateEffect(definition, row.value, changes);
+    const rows = yield* ingestCollectionMutationRowsEffect(definition, [updated.value], {
+        operation: "write",
+        path: `$.collections[${definition.name}].rows`,
+        synced: options.synced ?? true,
+        origin: options.origin ?? "remote",
+    });
+    const next = rows[0];
+    yield* ensureCollectionRowKey(definition, key, next.key);
+    yield* commitCollectionWriteEffect({
+        collection: definition.name,
+        state,
+        mutations: 1,
+        apply: () => {
+            const rebaseKeys = new Set();
+            applyCollectionBaseRow(state, next, rebaseKeys);
+            rebaseCollectionBaseRows(state, rebaseKeys);
+        },
+        persistEffect: persistForReasonEffect(definition, dbStore, "write"),
+        publishEffect: (event) => publishStoreEvent(dbStore, event),
+    });
+});
+const writeDeleteRow = (definition, key) => Effect.gen(function* () {
+    const dbStore = yield* collectionStoreEffect;
+    const state = yield* collectionStateEffect(definition, dbStore);
+    const optimistic = state.optimisticRows.get(key);
+    const hasBaseRow = optimistic ? optimistic.base !== undefined : state.rows.has(key);
+    if (!hasBaseRow) {
+        return;
+    }
+    yield* commitCollectionWriteEffect({
+        collection: definition.name,
+        state,
+        mutations: 1,
+        apply: () => {
+            const rebaseKeys = new Set();
+            deleteCollectionBaseRow(state, key, rebaseKeys);
+            rebaseCollectionBaseRows(state, rebaseKeys);
+        },
+        persistEffect: persistForReasonEffect(definition, dbStore, "write"),
+        publishEffect: (event) => publishStoreEvent(dbStore, event),
+    });
+});
+const applyCollectionChangesWithStoreEffect = (definition, dbStore, changes, options = {}) => Effect.gen(function* () {
+    if (definition.readOnly === true) {
+        return yield* Effect.fail(new ReadonlyCollectionMutation({
+            collection: definition.name,
+            operation: "applyChangesEffect",
+        }));
+    }
+    if (changes.length === 0) {
+        return;
+    }
+    const state = yield* collectionStateEffect(definition, dbStore);
+    const upserts = [];
+    const deletes = [];
+    for (const change of changes) {
+        switch (change._tag) {
+            case "Upsert":
+                upserts.push(change.value);
+                break;
+            case "Delete":
+                deletes.push(change.key);
+                break;
+        }
+    }
+    const rows = yield* ingestCollectionOutputRowsEffect(definition, upserts, {
+        operation: "write",
+        path: `$.collections[${definition.name}].changes`,
+        synced: options.synced ?? true,
+        origin: options.origin ?? "remote",
+    });
+    yield* commitCollectionWriteEffect({
+        collection: definition.name,
+        state,
+        mutations: changes.length,
+        apply: () => {
+            const rebaseKeys = new Set();
+            for (const row of rows) {
+                applyCollectionBaseRow(state, row, rebaseKeys);
+            }
+            for (const key of deletes) {
+                deleteCollectionBaseRow(state, key, rebaseKeys);
+            }
+            rebaseCollectionBaseRows(state, rebaseKeys);
+        },
+        persistEffect: persistForReasonEffect(definition, dbStore, "write"),
+        publishEffect: (event) => publishStoreEvent(dbStore, event),
+    });
+});
+export const applyCollectionChangesEffect = (definition, changes, options = {}) => Effect.flatMap(collectionStoreEffect, (dbStore) => applyCollectionChangesWithStoreEffect(definition, dbStore, changes, options));
+export const defineCollection = (options, register) => {
+    let definition;
+    definition = {
+        [CollectionTypeId]: CollectionTypeId,
+        options: options,
+        name: options.name,
+        getKey: options.getKey,
+        state: () => collectionState(definition).loadState,
+        version: () => collectionState(definition).version,
+        get: (key) => {
+            const state = collectionState(definition);
+            state.version.get();
+            const row = state.rows.get(key);
+            return row ? augmentCollectionRow(definition, row) : undefined;
+        },
+        rows: () => {
+            const state = collectionState(definition);
+            state.version.get();
+            return Array.from(state.rows.values(), (row) => augmentCollectionRow(definition, row));
+        },
+        index: (index, value) => rowsByIndex(definition, index, value),
+        firstByIndex: (index, value) => rowsByIndex(definition, index, value)[0],
+        preloadEffect: () => Effect.gen(function* () {
+            yield* recordCollectionPreload(definition);
+            yield* runCollectionSyncLoadPolicyEffect(definition, { force: false });
+        }),
+        refetchEffect: () => Effect.gen(function* () {
+            yield* recordCollectionPreload(definition);
+            yield* runCollectionSyncLoadPolicyEffect(definition, { force: true });
+        }),
+        pendingMutationsEffect: () => collectionPendingMutationsEffect(definition),
+        pendingMutations: () => collectionPendingMutations(definition),
+        flushPendingMutationsEffect: () => flushCollectionPendingMutationsEffect(definition),
+        snapshotEffect: () => snapshotCollectionEffect(definition),
+        snapshot: () => snapshotCollection(definition),
+        hydrateEffect: (snapshot, hydrateOptions) => hydrateCollectionEffect(definition, snapshot, hydrateOptions),
+        hydrate: (snapshot, hydrateOptions) => {
+            void runFork(hydrateCollectionEffect(definition, snapshot, hydrateOptions));
+        },
+        persistEffect: (storage, persistOptions) => persistCollectionEffect(definition, storage, persistOptions),
+        restoreEffect: (storage, restoreOptions) => restoreCollectionEffect(definition, storage, restoreOptions),
+        insertEffect: (input) => insertCollectionMutationEffect(definition, input),
+        updateEffect: (key, update) => updateCollectionMutationEffect(definition, key, update),
+        deleteEffect: (key) => deleteCollectionMutationEffect(definition, key),
+        writeInsertEffect: (input, writeOptions) => writeRows(definition, input, writeOptions),
+        writeInsert: (input, writeOptions) => {
+            void runFork(writeRows(definition, input, writeOptions));
+        },
+        writeUpdateEffect: (key, changes, writeOptions) => writeUpdateRow(definition, key, changes, writeOptions),
+        writeUpdate: (key, changes, writeOptions) => {
+            void runFork(writeUpdateRow(definition, key, changes, writeOptions));
+        },
+        writeDeleteEffect: (key) => writeDeleteRow(definition, key),
+        writeDelete: (key) => {
+            void runFork(writeDeleteRow(definition, key));
+        },
+    };
+    register(options.name, definition);
+    return definition;
+};
+//# sourceMappingURL=collection-runtime.js.map

package/dist/collection-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-runtime.js","sourceRoot":"","sources":["../src/collection-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAoB,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,GAGzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAAE,0CAA0C,EAAE,MAAM,qCAAqC,CAAC;AACjG,OAAO,EACL,kCAAkC,EAClC,gCAAgC,GACjC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,8BAA8B,EAC9B,qCAAqC,EACrC,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,wBAAwB,EACxB,oBAAoB,IAAI,6BAA6B,EACrD,0BAA0B,IAAI,mCAAmC,EACjE,uBAAuB,IAAI,gCAAgC,EAC3D,wBAAwB,IAAI,iCAAiC,EAC7D,kCAAkC,IAAI,2CAA2C,EACjF,uBAAuB,IAAI,gCAAgC,EAC3D,gCAAgC,EAChC,uBAAuB,IAAI,gCAAgC,EAC3D,kBAAkB,IAAI,2BAA2B,EACjD,wBAAwB,IAAI,iCAAiC,GAC9D,MAAM,6BAA6B,CAAC;AAKrC,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAEvB,MAAM,+BAA+B,CAAC;AAqBvC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,QAAQ,EACR,+BAA+B,GAEhC,MAAM,+BAA+B,CAAC;AAEvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,UAAyB,EAAuB,EAAE,CACxF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,0BAA0B,CAAC,CAAC;IAC1E,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,MAAM,iBAAiB,GAAG,CACxB,KAA6B,EAC7B,KAA2B,EACN,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAE/C,MAAM,OAAO,GAAG,CAAI,KAA2B,EAAoB,EAAE,CACnE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAA0B,CAAC,CAAC,CAAC,CAAC,KAAU,CAAC,CAAC;AAEpE,MAAM,eAAe,GAAG,CACtB,UAA4C,EAC5C,KAAK,GAA2B,sBAAsB,EAA4B,EACxD,EAAE;IAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAClB,UAA4C,EAC5C,KAAa,EACb,KAA2B,EACS,EAAE;IACtC,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAC1C,OAAO,qBAAqB,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CACjC,UAA4C,EAC5C,KAAK,GAA2B,sBAAsB,EAA4B,EAClC,EAAE;IAClD,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACjD,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACpB,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF,MAAM,gCAAgC,GAAG,CACvC,UAA4C,EACmB,EAAE,CACjE,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,0BAA0B,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;AAE9F,MAAM,kBAAkB,GAAG,CACzB,UAA4C,EAC5C,KAAK,GAA2B,sBAAsB,EAA4B,EAClF,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EACI,EAAE,CAAC,2BAA2B,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AAEzF,MAAM,wBAAwB,GAAG,CAC/B,UAA4C,EAI5C,EAAE,CAAC,iCAAiC,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;AAE1E,MAAM,uBAAuB,GAAG,CAC9B,UAA4C,EAC5C,QAAkC,EAClC,OAAO,GAA6B,EAAE,EACtC,KAA8B,EACgD,EAAE,CAChF,gCAAgC,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC;AAEhG,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,UAA4C,EAC5C,OAAO,GAA6B,EAAE,EAC9B,EAAE,CAAC,wBAAwB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAE3D,MAAM,uBAAuB,GAAG,CAC9B,UAA4C,EAC5C,OAA6C,EAC7C,OAAO,GAA6B,EAAE,EACtC,KAA8B,EACyD,EAAE,CACzF,gCAAgC,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC;AAE/F,MAAM,uBAAuB,GAAG,CAC9B,UAA4C,EAC5C,OAA6C,EAC7C,OAAO,GAAwD,EAAE,EACjE,KAA8B,EACyD,EAAE,CACzF,gCAAgC,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC;AAE/F,MAAM,sBAAsB,GAAG,CAC7B,UAA4C,EAC5C,KAA6B,EAC7B,MAAqC,EACgD,EAAE,CACvF,gCAAgC,CAAC,UAAU,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,WAAoC,EACpC,KAAK,GAA2B,sBAAsB,EAA4B,EACtD,EAAE,CAAC,6BAA6B,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AAEnF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,WAAoC,EAIpC,EAAE,CAAC,mCAAmC,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,WAAoC,EACpC,OAAmC,EACnC,OAAO,GAA6B,EAAE,EACwC,EAAE,CAChF,iCAAiC,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAChD,WAAoC,EACpC,OAAmC,EACnC,OAAO,GAA6B,EAAE,EACwC,EAAE,CAChF,2CAA2C,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC;AAEpG,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAQ9C,UAA4C,EAC5C,OAA6E,EAC7E,OAAO,GAAyC,EAAE,EAC8C,EAAE,CAClG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,UAAU,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,0BAA0B,CAAC;YAC7B,UAAU,EAAE,UAAU,CAAC,IAAI;YAC3B,SAAS,EAAE,wBAAwB;SACpC,CAA8B,CAChC,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,qBAAqB,CAAC;IAC7C,KAAK,CAAC,CAAC,0CAA0C,CAAC;QAChD,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,OAAO;QACP,OAAO;QACP,YAAY,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,CACtC,qCAAqC,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC;QACnF,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CACxB,iBAAiB,CAAC,OAAO,EAAE;YACzB,IAAI,EAAE,6BAA6B;YACnC,UAAU,EAAE,UAAU,CAAC,IAAI;YAC3B,KAAK;SACN,CAAC;KACL,CAAC,CAAC;AACL,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAEzB,MAAM,SAAS,GAAG,CAChB,UAA4C,EAC5C,KAA2B,EAC3B,OAAO,GAA2B,EAAE,EACe,EAAE,CACrD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,qBAAqB,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,kCAAkC,CAAC,UAAU,EAAE,MAAM,EAAE;QACzE,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,iBAAiB,UAAU,CAAC,IAAI,QAAQ;QAC9C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,QAAQ;KACnC,CAAC,CAAC;IAEH,KAAK,CAAC,CAAC,2BAA2B,CAAC;QACjC,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,MAAM;QACtB,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,UAAU,GAAG,IAAI,GAAG,EAAK,CAAC;YAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,sBAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;YACjD,CAAC;YACD,wBAAwB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC9C,CAAC;QACD,aAAa,EAAE,sBAAsB,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC;QACnE,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,cAAc,GAAG,CACrB,UAA4C,EAC5C,GAAM,EACN,OAAmB,EACnB,OAAO,GAA2B,EAAE,EAKpC,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,qBAAqB,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,KAAK,CAAC,CAAC,IAAI,qBAAqB,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,2BAA2B,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,kCAAkC,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QAClF,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,iBAAiB,UAAU,CAAC,IAAI,QAAQ;QAC9C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,QAAQ;KACnC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAoB,CAAC;IACxC,KAAK,CAAC,CAAC,sBAAsB,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAEzD,KAAK,CAAC,CAAC,2BAA2B,CAAC;QACjC,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,KAAK;QACL,SAAS,EAAE,CAAC;QACZ,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,UAAU,GAAG,IAAI,GAAG,EAAK,CAAC;YAChC,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;YAChD,wBAAwB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC9C,CAAC;QACD,aAAa,EAAE,sBAAsB,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC;QACnE,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,cAAc,GAAG,CACrB,UAA4C,EAC5C,GAAM,EAC6C,EAAE,CACrD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,qBAAqB,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;IACT,CAAC;IAED,KAAK,CAAC,CAAC,2BAA2B,CAAC;QACjC,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,KAAK;QACL,SAAS,EAAE,CAAC;QACZ,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,UAAU,GAAG,IAAI,GAAG,EAAK,CAAC;YAChC,uBAAuB,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;YAChD,wBAAwB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC9C,CAAC;QACD,aAAa,EAAE,sBAAsB,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC;QACnE,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,qCAAqC,GAAG,CAC5C,UAA4C,EAC5C,OAA+B,EAC/B,OAA8C,EAC9C,OAAO,GAA2B,EAAE,EACe,EAAE,CACrD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,UAAU,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,0BAA0B,CAAC;YAC7B,UAAU,EAAE,UAAU,CAAC,IAAI;YAC3B,SAAS,EAAE,oBAAoB;SAChC,CAA8B,CAChC,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,QAAQ;gBACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC3B,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACzB,MAAM;QACV,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,gCAAgC,CAAC,UAAU,EAAE,OAAO,EAAE;QACxE,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,iBAAiB,UAAU,CAAC,IAAI,WAAW;QACjD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,QAAQ;KACnC,CAAC,CAAC;IAEH,KAAK,CAAC,CAAC,2BAA2B,CAAC;QACjC,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,KAAK;QACL,SAAS,EAAE,OAAO,CAAC,MAAM;QACzB,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,UAAU,GAAG,IAAI,GAAG,EAAK,CAAC;YAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,sBAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;YACjD,CAAC;YAED,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,uBAAuB,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;YAClD,CAAC;YAED,wBAAwB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC9C,CAAC;QACD,aAAa,EAAE,sBAAsB,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC;QACnE,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,UAA4C,EAC5C,OAA8C,EAC9C,OAAO,GAA2B,EAAE,EACe,EAAE,CACrD,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,OAAO,EAAE,EAAE,CAChD,qCAAqC,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAC7E,CAAC;AAEJ,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAM9B,OAGC,EACD,QAA2D,EACzB,EAAE;IACpC,IAAI,UAA4C,CAAC;IACjD,UAAU,GAAG;QACX,CAAC,gBAAgB,CAAC,EAAE,gBAAgB;QACpC,OAAO,EAAE,OAAwC;QACjD,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,SAAS;QAClD,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,OAAO;QAClD,GAAG,EAAE,CAAC,GAAM,EAAE,EAAE;YACd,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;YAC1C,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChC,OAAO,GAAG,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,CAAC;QACD,IAAI,EAAE,GAAG,EAAE;YACT,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;YAC1C,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;QACzF,CAAC;QACD,KAAK,EAAE,CAAC,KAAa,EAAE,KAA2B,EAAE,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC;QAC5F,YAAY,EAAE,CAAC,KAAa,EAAE,KAA2B,EAAE,EAAE,CAC3D,WAAW,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1C,aAAa,EAAE,GAAG,EAAE,CAClB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,KAAK,CAAC,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;YAC3C,KAAK,CAAC,CAAC,iCAAiC,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,CAAC,CAAC;QACJ,aAAa,EAAE,GAAG,EAAE,CAClB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,KAAK,CAAC,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;YAC3C,KAAK,CAAC,CAAC,iCAAiC,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC;QACJ,sBAAsB,EAAE,GAAG,EAAE,CAAC,gCAAgC,CAAC,UAAU,CAAC;QAC1E,gBAAgB,EAAE,GAAG,EAAE,CAAC,0BAA0B,CAAC,UAAU,CAAC;QAC9D,2BAA2B,EAAE,GAAG,EAAE,CAAC,qCAAqC,CAAC,UAAU,CAAC;QACpF,cAAc,EAAE,GAAG,EAAE,CAAC,wBAAwB,CAAC,UAAU,CAAC;QAC1D,QAAQ,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,UAAU,CAAC;QAC9C,aAAa,EAAE,CACb,QAAkC,EAClC,cAAyC,EACzC,EAAE,CAAC,uBAAuB,CAAC,UAAU,EAAE,QAAQ,EAAE,cAAc,CAAC;QAClE,OAAO,EAAE,CAAC,QAAkC,EAAE,cAAyC,EAAE,EAAE;YACzF,KAAK,OAAO,CAAC,uBAAuB,CAAC,UAAU,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;QAC9E,CAAC;QACD,aAAa,EAAE,CACb,OAA6C,EAC7C,cAAyC,EACzC,EAAE,CAAC,uBAAuB,CAAC,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC;QACjE,aAAa,EAAE,CACb,OAA6C,EAC7C,cAAoE,EACpE,EAAE,CAAC,uBAAuB,CAAC,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC;QACjE,YAAY,EAAE,CAAC,KAA2B,EAAE,EAAE,CAC5C,8BAA8B,CAAC,UAAU,EAAE,KAAK,CAAC;QACnD,YAAY,EAAE,CAAC,GAAM,EAAE,MAA2B,EAAE,EAAE,CACpD,8BAA8B,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC;QACzD,YAAY,EAAE,CAAC,GAAM,EAAE,EAAE,CAAC,8BAA8B,CAAC,UAAU,EAAE,GAAG,CAAC;QACzE,iBAAiB,EAAE,CAAC,KAA2B,EAAE,YAAqC,EAAE,EAAE,CACxF,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,CAAC;QAC5C,WAAW,EAAE,CAAC,KAA2B,EAAE,YAAqC,EAAE,EAAE;YAClF,KAAK,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,iBAAiB,EAAE,CAAC,GAAM,EAAE,OAAmB,EAAE,YAAqC,EAAE,EAAE,CACxF,cAAc,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC;QACxD,WAAW,EAAE,CAAC,GAAM,EAAE,OAAmB,EAAE,YAAqC,EAAE,EAAE;YAClF,KAAK,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;QACvE,CAAC;QACD,iBAAiB,EAAE,CAAC,GAAM,EAAE,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,GAAG,CAAC;QAC9D,WAAW,EAAE,CAAC,GAAM,EAAE,EAAE;YACtB,KAAK,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;QAChD,CAAC;KACyC,CAAC;IAE7C,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,UAA2B,CAAC,CAAC;IAEpD,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC"}

package/dist/collection-snapshot-codec.d.ts

@@ -0,0 +1,62 @@
+import { EffectInputCallbackError } from "@sunfall/arc-core";
+import { Effect } from "effect";
+import type { CollectionHydrateOptions, CollectionHydrationPayload, CollectionKey, CollectionPendingMutation, CollectionRowSnapshot, CollectionSnapshot } from "./collection-contract.js";
+import { type CollectionState, type PendingMutationEntry, type StoredRow } from "./collection-state.js";
+interface CollectionSnapshotDefinition<A extends object, K extends CollectionKey> {
+    readonly name: string;
+    readonly options: {
+        readonly output?: unknown;
+    };
+    getKey(value: A): K;
+}
+export type CollectionSnapshotCodecOperation = "decode" | "encode" | "load" | "hydrate" | "mutation" | "restore" | "snapshot" | "write";
+declare const CollectionSnapshotCodecError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "CollectionSnapshotCodecError";
+} & Readonly<A>;
+/**
+ * Typed failure for invalid collection snapshots or hydration payloads.
+ *
+ * `operation` identifies the codec phase, `path` is a JSONPath-like location
+ * in the payload, and `reason` describes the validation failure.
+ */
+export declare class CollectionSnapshotCodecError extends CollectionSnapshotCodecError_base<{
+    readonly operation: CollectionSnapshotCodecOperation;
+    readonly path: string;
+    readonly reason: string;
+}> {
+}
+export declare const validateCollectionKey: <K extends CollectionKey>(value: unknown, operation: CollectionSnapshotCodecOperation, path: string) => K;
+export declare const validateCollectionRowSnapshot: <A extends object, K extends CollectionKey>(value: unknown, operation: CollectionSnapshotCodecOperation, path: string) => CollectionRowSnapshot<A, K>;
+export declare const validateCollectionPendingMutation: <A extends object, K extends CollectionKey>(value: unknown, operation: CollectionSnapshotCodecOperation, path: string) => CollectionPendingMutation<A, K>;
+export declare const validateCollectionSnapshot: <A extends object, K extends CollectionKey>(value: unknown, operation?: CollectionSnapshotCodecOperation, path?: string) => CollectionSnapshot<A, K>;
+export declare const validateCollectionSnapshotEffect: <A extends object, K extends CollectionKey>(value: unknown, operation?: CollectionSnapshotCodecOperation, path?: string) => Effect.Effect<CollectionSnapshot<A, K>, CollectionSnapshotCodecError>;
+/**
+ * Decodes collection output schema failures into the snapshot codec error seam.
+ *
+ * Public Collection and Query Interfaces should not expose raw schema errors;
+ * callers see `CollectionSnapshotCodecError` with the
+ * path that failed inside the hydrated or loaded snapshot.
+ */
+export declare const decodeCollectionOutputValuesEffect: <A extends object>(schema: unknown, values: ReadonlyArray<A>, operation: CollectionSnapshotCodecOperation, path: string) => Effect.Effect<ReadonlyArray<A>, CollectionSnapshotCodecError>;
+export declare const decodeCollectionOutputValuesSync: <A extends object>(schema: unknown, values: ReadonlyArray<A>, operation: CollectionSnapshotCodecOperation, path: string) => ReadonlyArray<A>;
+export declare const validateCollectionSnapshotDefinitionEffect: <A extends object, K extends CollectionKey>(definition: CollectionSnapshotDefinition<A, K>, value: CollectionSnapshot<A, K>, operation?: CollectionSnapshotCodecOperation, path?: string) => Effect.Effect<CollectionSnapshot<A, K>, CollectionSnapshotCodecError | EffectInputCallbackError>;
+export declare const validateCollectionHydrationPayload: (value: unknown, operation?: CollectionSnapshotCodecOperation) => CollectionHydrationPayload;
+export declare const validateCollectionHydrationPayloadEffect: (value: unknown, operation?: CollectionSnapshotCodecOperation) => Effect.Effect<CollectionHydrationPayload, CollectionSnapshotCodecError>;
+export declare const storedRowSnapshot: <A extends object, K extends CollectionKey>(row: StoredRow<A, K>) => CollectionRowSnapshot<A, K>;
+export declare const storedRowFromSnapshot: <A extends object, K extends CollectionKey>(snapshot: CollectionRowSnapshot<A, K>) => StoredRow<A, K>;
+export declare const pendingMutationSnapshot: <A extends object, K extends CollectionKey>(entry: PendingMutationEntry<A, K>) => CollectionPendingMutation<A, K>;
+export declare const pendingEntryFromSnapshot: <A extends object, K extends CollectionKey>(snapshot: CollectionPendingMutation<A, K>) => PendingMutationEntry<A, K>;
+export declare const pendingMutationSnapshots: <A extends object, K extends CollectionKey>(state: CollectionState<A, K, any>) => ReadonlyArray<CollectionPendingMutation<A, K>>;
+export declare const collectionSnapshotFromState: <A extends object, K extends CollectionKey, E>(definition: {
+    readonly name: string;
+}, state: CollectionState<A, K, E>, updatedAt: number) => CollectionSnapshot<A, K>;
+export declare const collectionSnapshotFromValues: <A extends object, K extends CollectionKey>(name: string, values: ReadonlyArray<A>, getKey: (value: A) => K, updatedAt: number) => CollectionSnapshot<A, K>;
+export declare const collectionSnapshotFromValuesEffect: <A extends object, K extends CollectionKey>(name: string, values: ReadonlyArray<A>, getKey: (value: A) => K, updatedAt: number) => Effect.Effect<CollectionSnapshot<A, K>, EffectInputCallbackError>;
+export declare const validateCollectionSnapshotStateHydration: <A extends object, K extends CollectionKey, E>(state: CollectionState<A, K, E>, snapshot: CollectionSnapshot<A, K>, options: CollectionHydrateOptions) => void;
+export declare const validateCollectionSnapshotStateHydrationEffect: <A extends object, K extends CollectionKey, E>(state: CollectionState<A, K, E>, snapshot: CollectionSnapshot<A, K>, options: CollectionHydrateOptions) => Effect.Effect<void, CollectionSnapshotCodecError>;
+export declare const hydrateCollectionSnapshotState: <A extends object, K extends CollectionKey, E>(state: CollectionState<A, K, E>, value: CollectionSnapshot<A, K>, options: CollectionHydrateOptions, advanceTransactionIdentity: (id: string) => void) => CollectionSnapshot<A, K>;
+export declare const hydrateCollectionSnapshotStateEffect: <A extends object, K extends CollectionKey, E>(state: CollectionState<A, K, E>, value: CollectionSnapshot<A, K>, options: CollectionHydrateOptions, advanceTransactionIdentity: (id: string) => void) => Effect.Effect<CollectionSnapshot<A, K>, CollectionSnapshotCodecError>;
+export declare const encodeCollectionSnapshotEffect: <A extends object, K extends CollectionKey>(value: CollectionSnapshot<A, K>) => Effect.Effect<string, CollectionSnapshotCodecError>;
+export declare const decodeCollectionSnapshotEffect: <A extends object, K extends CollectionKey>(encoded: string) => Effect.Effect<CollectionSnapshot<A, K>, CollectionSnapshotCodecError>;
+export {};
+//# sourceMappingURL=collection-snapshot-codec.d.ts.map

package/dist/collection-snapshot-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-snapshot-codec.d.ts","sourceRoot":"","sources":["../src/collection-snapshot-codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAgB,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,aAAa,EAGb,yBAAyB,EAEzB,qBAAqB,EACrB,kBAAkB,EAEnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACf,MAAM,uBAAuB,CAAC;AAS/B,UAAU,4BAA4B,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;CACrB;AAED,MAAM,MAAM,gCAAgC,GACxC,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,SAAS,GACT,UAAU,GACV,SAAS,GACT,UAAU,GACV,OAAO,CAAC;;;;AAEZ;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,kCAAiD;IACjG,QAAQ,CAAC,SAAS,EAAE,gCAAgC,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;CAAG;AAqCL,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,aAAa,SACpD,OAAO,aACH,gCAAgC,QACrC,MAAM,KACX,CAQF,CAAC;AA6FF,eAAO,MAAM,6BAA6B,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,SAC9E,OAAO,aACH,gCAAgC,QACrC,MAAM,KACX,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAe5B,CAAC;AA8EF,eAAO,MAAM,iCAAiC,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,SAClF,OAAO,aACH,gCAAgC,QACrC,MAAM,KACX,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAyDhC,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,SAC3E,OAAO,cACH,gCAAgC,oBAE1C,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAmDzB,CAAC;AAgBF,eAAO,MAAM,gCAAgC,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,SACjF,OAAO,cACH,gCAAgC,oBAE1C,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,4BAA4B,CAInE,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC,GAAI,CAAC,SAAS,MAAM,UACzD,OAAO,UACP,aAAa,CAAC,CAAC,CAAC,aACb,gCAAgC,QACrC,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,4BAA4B,CA2B9D,CAAC;AAEF,eAAO,MAAM,gCAAgC,GAAI,CAAC,SAAS,MAAM,UACvD,OAAO,UACP,aAAa,CAAC,CAAC,CAAC,aACb,gCAAgC,QACrC,MAAM,KACX,aAAa,CAAC,CAAC,CA2BjB,CAAC;AA4EF,eAAO,MAAM,0CAA0C,GACrD,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,aAAa,cAEX,4BAA4B,CAAC,CAAC,EAAE,CAAC,CAAC,SACvC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,cACpB,gCAAgC,oBAE1C,MAAM,CAAC,MAAM,CACd,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EACxB,4BAA4B,GAAG,wBAAwB,CAiOrD,CAAC;AAEL,eAAO,MAAM,kCAAkC,UACtC,OAAO,cACH,gCAAgC,KAC1C,0BAwBF,CAAC;AAEF,eAAO,MAAM,wCAAwC,UAC5C,OAAO,cACH,gCAAgC,KAC1C,MAAM,CAAC,MAAM,CAAC,0BAA0B,EAAE,4BAA4B,CAIrE,CAAC;AAEL,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,OACpE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KACnB,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAK3B,CAAC;AAEH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,YACnE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,KACpC,SAAS,CAAC,CAAC,EAAE,CAAC,CAQhB,CAAC;AAYF,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,SACxE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,KAChC,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAK/B,CAAC;AAEH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,YACtE,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,KACxC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAkB3B,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,SACzE,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,KAChC,aAAa,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,CACsB,CAAC;AAEvE,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,EAAE,CAAC,cAC1E;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,SAC9B,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,aACpB,MAAM,KAChB,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAQzB,CAAC;AAEF,eAAO,MAAM,4BAA4B,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,QAC9E,MAAM,UACJ,aAAa,CAAC,CAAC,CAAC,UAChB,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,aACZ,MAAM,KAChB,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAUxB,CAAC;AAEH,eAAO,MAAM,kCAAkC,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,QACpF,MAAM,UACJ,aAAa,CAAC,CAAC,CAAC,UAChB,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,aACZ,MAAM,KAChB,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,wBAAwB,CAU/D,CAAC;AAEL,eAAO,MAAM,wCAAwC,GACnD,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,aAAa,EACvB,CAAC,SAEM,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,YACrB,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,WACzB,wBAAwB,KAChC,IAWF,CAAC;AAEF,eAAO,MAAM,8CAA8C,GACzD,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,aAAa,EACvB,CAAC,SAEM,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,YACrB,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,WACzB,wBAAwB,KAChC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,4BAA4B,CAI/C,CAAC;AAqDL,eAAO,MAAM,8BAA8B,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,EAAE,CAAC,SAClF,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,SACxB,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,WACtB,wBAAwB,8BACL,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,KAC/C,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAMvB,CAAC;AAEJ,eAAO,MAAM,oCAAoC,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,EAAE,CAAC,SACxF,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,SACxB,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,WACtB,wBAAwB,8BACL,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,KAC/C,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,4BAA4B,CAOpE,CAAC;AAEJ,eAAO,MAAM,8BAA8B,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,SAC/E,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,KAC9B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAcjD,CAAC;AAEL,eAAO,MAAM,8BAA8B,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,WAC7E,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,4BAA4B,CAInE,CAAC"}