@sunfall/arc-db 0.1.0-alpha.0

package/dist/collection-mutation-workflow.js

@@ -0,0 +1,252 @@
+import { EffectInputCallbackError } from "@sunfall/arc-core";
+import { Clock, Deferred, Effect, Exit } from "effect";
+import { CollectionRowKeyChanged, CollectionRowNotFound } from "./collection-errors.js";
+import { dequeuePendingMutation, enqueuePendingMutation, recordPendingMutationAttempt, createCollectionTransaction, } from "./collection-mutation-queue.js";
+import { persistCollectionForReasonEffect } from "./collection-persistence.js";
+import { ingestCollectionMutationRowsEffect } from "./collection-row-ingress.js";
+import { applyOptimisticTransaction, bumpCollectionState, cloneStoredRow, commitOptimisticTransaction, markStoredRowsSynced, restoreStoredRows, rollbackOptimisticTransaction, } from "./collection-state.js";
+import { restoreCollectionStateSnapshot, snapshotCollectionState, withCollectionDurableCommitPermit, } from "./collection-write-commit.js";
+import { cloneFrozenCollectionTransaction, cloneFrozenCollectionValue, collectionValueChanges, } from "./collection-value-detachment.js";
+import { applyCollectionUpdateEffect, collectionCallbackEffect, collectionStateEffect, ensureCollectionRowKey, } from "./collection-projection-callback-policy.js";
+import { collectionStoreEffect } from "./runtime-collection-store.js";
+import { withCollectionPolicyRetry } from "./collection-policy.js";
+const toArray = (input) => Array.isArray(input) ? input : [input];
+const publishStoreEvent = (store, event) => store.publish(event);
+const persistMutationEffect = (definition, store) => persistCollectionForReasonEffect(definition, store, collectionStoreEffect, "mutation");
+const collectionMutationHandlerEffect = (definition, transaction) => Effect.gen(function* () {
+    const inserts = [];
+    const updates = [];
+    const deletes = [];
+    for (const mutation of transaction.mutations) {
+        switch (mutation._tag) {
+            case "Insert":
+                inserts.push(cloneFrozenCollectionValue(mutation.value));
+                break;
+            case "Update":
+                updates.push(cloneFrozenCollectionValue({
+                    key: mutation.key,
+                    previous: mutation.previous,
+                    value: mutation.value,
+                    changes: mutation.changes,
+                }));
+                break;
+            case "Delete":
+                deletes.push(cloneFrozenCollectionValue({ key: mutation.key, previous: mutation.previous }));
+                break;
+        }
+    }
+    const context = cloneFrozenCollectionValue({
+        transaction: cloneFrozenCollectionTransaction(transaction),
+    });
+    if (inserts.length > 0 && definition.options.onInsert) {
+        yield* collectionCallbackEffect(() => definition.options.onInsert(Object.freeze(inserts), context));
+    }
+    if (updates.length > 0 && definition.options.onUpdate) {
+        yield* collectionCallbackEffect(() => definition.options.onUpdate(Object.freeze(updates), context));
+    }
+    if (deletes.length > 0 && definition.options.onDelete) {
+        yield* collectionCallbackEffect(() => definition.options.onDelete(Object.freeze(deletes), context));
+    }
+});
+const completePendingMutationAttempt = (pending, attempt, exit) => Effect.gen(function* () {
+    if (pending.activeAttempt?.id === attempt.id) {
+        pending.activeAttempt = undefined;
+    }
+    yield* Deferred.done(attempt.deferred, exit).pipe(Effect.asVoid);
+});
+const publishMutationDequeued = (definition, state, store, transaction) => publishStoreEvent(store, {
+    _tag: "CollectionMutationDequeued",
+    collection: definition.name,
+    transaction: transaction.id,
+    pending: state.pendingMutations.size,
+});
+const rollbackPendingMutation = (definition, state, store, pending, mutation, error) => withCollectionDurableCommitPermit(state, Effect.uninterruptibleMask((restore) => Effect.gen(function* () {
+    if (!rollbackOptimisticTransaction(state, mutation)) {
+        restoreStoredRows(state, pending.rollbackRows);
+    }
+    dequeuePendingMutation(state, mutation.id);
+    const persistExit = yield* restore(persistMutationEffect(definition, store)).pipe(Effect.exit);
+    if (Exit.isFailure(persistExit)) {
+        return yield* Effect.failCause(persistExit.cause);
+    }
+    yield* publishMutationDequeued(definition, state, store, mutation);
+    yield* publishStoreEvent(store, {
+        _tag: "CollectionMutateRolledBack",
+        collection: definition.name,
+        transaction: mutation.id,
+        error,
+    });
+}))).pipe(Effect.flatMap(() => Effect.fail(error)));
+const commitPendingMutation = (definition, state, store, pending, mutation) => withCollectionDurableCommitPermit(state, Effect.uninterruptibleMask((restore) => Effect.gen(function* () {
+    if (!commitOptimisticTransaction(state, mutation)) {
+        markStoredRowsSynced(state, Array.from(pending.rollbackRows.keys()));
+    }
+    dequeuePendingMutation(state, mutation.id);
+    const persistExit = yield* restore(persistMutationEffect(definition, store)).pipe(Effect.exit);
+    if (Exit.isFailure(persistExit)) {
+        return yield* Effect.failCause(persistExit.cause);
+    }
+    yield* publishMutationDequeued(definition, state, store, mutation);
+    yield* publishStoreEvent(store, {
+        _tag: "CollectionMutateCommitted",
+        collection: definition.name,
+        transaction: mutation.id,
+        mutations: mutation.mutations.length,
+    });
+    return mutation;
+})));
+const runPendingMutation = (definition, state, store, pending, handler) => Effect.gen(function* () {
+    const active = pending.activeAttempt;
+    if (active) {
+        return yield* Deferred.await(active.deferred);
+    }
+    const attempt = {
+        id: ++state.nextMutationAttemptId,
+        deferred: yield* Deferred.make(),
+    };
+    pending.activeAttempt = attempt;
+    const runOwnerMutation = Effect.gen(function* () {
+        const mutation = recordPendingMutationAttempt(pending);
+        bumpCollectionState(state);
+        yield* publishStoreEvent(store, {
+            _tag: "CollectionMutateStarted",
+            collection: definition.name,
+            transaction: mutation.id,
+            mutations: mutation.mutations.length,
+        });
+        const exit = yield* Effect.exit(withCollectionPolicyRetry(definition, handler).pipe(Effect.matchEffect({
+            onFailure: (error) => rollbackPendingMutation(definition, state, store, pending, mutation, error),
+            onSuccess: () => commitPendingMutation(definition, state, store, pending, mutation),
+        })));
+        yield* completePendingMutationAttempt(pending, attempt, exit);
+        return yield* exit;
+    });
+    return yield* runOwnerMutation.pipe(Effect.onExit((exit) => Exit.isFailure(exit)
+        ? completePendingMutationAttempt(pending, attempt, exit)
+        : Effect.void));
+});
+const runCollectionMutationTransactionEffect = (definition, mutation, snapshots, handler) => Effect.gen(function* () {
+    const store = yield* collectionStoreEffect;
+    const state = yield* collectionStateEffect(definition, store);
+    const pending = yield* withCollectionDurableCommitPermit(state, Effect.uninterruptibleMask((restore) => Effect.gen(function* () {
+        const previousState = snapshotCollectionState(state);
+        const createdAt = yield* Clock.currentTimeMillis;
+        applyOptimisticTransaction(state, mutation, snapshots);
+        const pending = enqueuePendingMutation(state, mutation, snapshots, createdAt);
+        const persistExit = yield* restore(persistMutationEffect(definition, store)).pipe(Effect.exit);
+        if (Exit.isFailure(persistExit)) {
+            restoreCollectionStateSnapshot(state, previousState);
+            return yield* Effect.failCause(persistExit.cause);
+        }
+        yield* publishStoreEvent(store, {
+            _tag: "CollectionMutationQueued",
+            collection: definition.name,
+            transaction: mutation.id,
+            mutations: mutation.mutations.length,
+            pending: state.pendingMutations.size,
+        });
+        return pending;
+    })));
+    return yield* runPendingMutation(definition, state, store, pending, handler);
+});
+/**
+ * Flush restored or otherwise queued optimistic collection mutations.
+ *
+ * The workflow owns restored-pending replay, active attempt joiners, mutation
+ * retry policy, optimistic commit/rollback, lifecycle events, and mutation
+ * persistence so `Collection.define` can stay a small public facade.
+ */
+export const flushCollectionPendingMutationsEffect = (definition) => Effect.gen(function* () {
+    const store = yield* collectionStoreEffect;
+    const state = yield* collectionStateEffect(definition, store);
+    const flushed = [];
+    for (const entry of Array.from(state.pendingMutations.values())) {
+        const pending = state.pendingMutations.get(entry.transaction.id);
+        if (!pending) {
+            continue;
+        }
+        const handler = collectionMutationHandlerEffect(definition, pending.transaction);
+        const transaction = yield* runPendingMutation(definition, state, store, pending, handler);
+        flushed.push(transaction);
+    }
+    return flushed;
+});
+/** Optimistically insert rows and run the insert mutation workflow. */
+export const insertCollectionMutationEffect = (definition, input) => Effect.gen(function* () {
+    const store = yield* collectionStoreEffect;
+    const state = yield* collectionStateEffect(definition, store);
+    const rows = yield* ingestCollectionMutationRowsEffect(definition, toArray(input), {
+        operation: "mutation",
+        path: `$.collections[${definition.name}].mutations`,
+        synced: false,
+        origin: "local",
+    });
+    if (rows.length === 0) {
+        return createCollectionTransaction(state, definition.name, []);
+    }
+    const snapshots = new Map();
+    const mutations = [];
+    for (const row of rows) {
+        const previous = state.rows.get(row.key);
+        snapshots.set(row.key, previous ? cloneStoredRow(previous) : undefined);
+        mutations.push(previous
+            ? { _tag: "Insert", key: row.key, value: row.value, previous: previous.value }
+            : { _tag: "Insert", key: row.key, value: row.value });
+    }
+    const transaction = createCollectionTransaction(state, definition.name, mutations);
+    const handler = collectionMutationHandlerEffect(definition, transaction);
+    return yield* runCollectionMutationTransactionEffect(definition, transaction, snapshots, handler);
+});
+/** Optimistically update one row and run the update mutation workflow. */
+export const updateCollectionMutationEffect = (definition, key, update) => Effect.gen(function* () {
+    const store = yield* collectionStoreEffect;
+    const state = yield* collectionStateEffect(definition, store);
+    const row = state.rows.get(key);
+    if (!row) {
+        return yield* new CollectionRowNotFound({ collection: definition.name, key });
+    }
+    const previous = cloneStoredRow(row);
+    const updated = yield* applyCollectionUpdateEffect(definition, row.value, update);
+    const rows = yield* ingestCollectionMutationRowsEffect(definition, [updated.value], {
+        operation: "mutation",
+        path: `$.collections[${definition.name}].mutations`,
+        synced: false,
+        origin: "local",
+    });
+    const next = rows[0];
+    yield* ensureCollectionRowKey(definition, key, next.key);
+    const changes = collectionValueChanges(previous.value, next.value);
+    const snapshots = new Map([[key, previous]]);
+    const transaction = createCollectionTransaction(state, definition.name, [
+        {
+            _tag: "Update",
+            key,
+            previous: previous.value,
+            value: next.value,
+            changes,
+        },
+    ]);
+    const handler = collectionMutationHandlerEffect(definition, transaction);
+    return yield* runCollectionMutationTransactionEffect(definition, transaction, snapshots, handler);
+});
+/** Optimistically delete one row and run the delete mutation workflow. */
+export const deleteCollectionMutationEffect = (definition, key) => Effect.gen(function* () {
+    const store = yield* collectionStoreEffect;
+    const state = yield* collectionStateEffect(definition, store);
+    const row = state.rows.get(key);
+    if (!row) {
+        return yield* new CollectionRowNotFound({ collection: definition.name, key });
+    }
+    const previous = cloneStoredRow(row);
+    const snapshots = new Map([[key, previous]]);
+    const transaction = createCollectionTransaction(state, definition.name, [
+        {
+            _tag: "Delete",
+            key,
+            previous: previous.value,
+        },
+    ]);
+    const handler = collectionMutationHandlerEffect(definition, transaction);
+    return yield* runCollectionMutationTransactionEffect(definition, transaction, snapshots, handler);
+});
+//# sourceMappingURL=collection-mutation-workflow.js.map

package/dist/collection-mutation-workflow.js.map

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

package/dist/collection-persistence.d.ts

@@ -0,0 +1,48 @@
+import { EffectInputCallbackError } from "@sunfall/arc-core";
+import { Effect } from "effect";
+import { type CollectionState } from "./collection-state.js";
+import { type CollectionPersistenceStore } from "./collection-definition-snapshot.js";
+export type { CollectionPersistenceStore } from "./collection-definition-snapshot.js";
+import { CollectionSnapshotCodecError } from "./collection-snapshot-codec.js";
+import type { AnyCollection, CollectionDefinition, CollectionHydrateOptions, CollectionHydrationPayload, CollectionKey, CollectionMemoryStorage, CollectionOptions, CollectionPersistOptions, CollectionPersistedOptions, CollectionPersistenceConfig, CollectionPersistenceStorage, CollectionSnapshot, CollectionStorageLike } from "./collection-contract.js";
+declare const CollectionStorageError_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: "CollectionStorageError";
+} & Readonly<A>;
+/** Error raised by the sync Web Storage Adapter when a host method throws. */
+export declare class CollectionStorageError extends CollectionStorageError_base<{
+    readonly operation: "getItem" | "setItem" | "removeItem";
+    readonly key: string;
+    readonly cause: unknown;
+}> {
+}
+export declare function snapshotCollection<A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>, store: CollectionPersistenceStore, updatedAt?: number): CollectionSnapshot<A, K>;
+export declare function snapshotCollection(definition: AnyCollection, store: CollectionPersistenceStore, updatedAt?: number): CollectionSnapshot<any, any>;
+export declare const snapshotCollectionEffect: <A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>, storeEffect: Effect.Effect<CollectionPersistenceStore>) => Effect.Effect<CollectionSnapshot<A, K>, CollectionSnapshotCodecError | EffectInputCallbackError>;
+export declare function hydrateCollectionEffect<A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>, snapshot: CollectionSnapshot<A, K>, options: CollectionHydrateOptions | undefined, storeEffect: Effect.Effect<CollectionPersistenceStore>, store?: CollectionPersistenceStore): Effect.Effect<void, CollectionSnapshotCodecError | EffectInputCallbackError>;
+export declare function hydrateCollectionEffect(definition: AnyCollection, snapshot: CollectionSnapshot<any, any>, options: CollectionHydrateOptions | undefined, storeEffect: Effect.Effect<CollectionPersistenceStore>, store?: CollectionPersistenceStore): Effect.Effect<void, CollectionSnapshotCodecError | EffectInputCallbackError>;
+export declare const collectionPersistenceKey: <A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>, options?: CollectionPersistOptions) => string;
+export declare const persistCollectionEffect: <A extends object, K extends CollectionKey, E, R, PE, PR>(definition: CollectionDefinition<A, K, E, R>, storage: CollectionPersistenceStorage<PE, PR>, options: CollectionPersistOptions | undefined, storeEffect: Effect.Effect<CollectionPersistenceStore>, store?: CollectionPersistenceStore) => Effect.Effect<void, PE | CollectionSnapshotCodecError | EffectInputCallbackError, PR>;
+export declare const persistCollectionSnapshotEffect: <A extends object, K extends CollectionKey, E, R, PE, PR>(definition: CollectionDefinition<A, K, E, R>, snapshotEffect: Effect.Effect<CollectionSnapshot<A, K>, CollectionSnapshotCodecError | EffectInputCallbackError>, storage: CollectionPersistenceStorage<PE, PR>, options?: CollectionPersistOptions, store?: CollectionPersistenceStore) => Effect.Effect<CollectionSnapshot<A, K>, PE | CollectionSnapshotCodecError | EffectInputCallbackError, PR>;
+export declare const restoreCollectionEffect: <A extends object, K extends CollectionKey, E, R, PE, PR>(definition: CollectionDefinition<A, K, E, R>, storage: CollectionPersistenceStorage<PE, PR>, options: (CollectionPersistOptions & CollectionHydrateOptions) | undefined, storeEffect: Effect.Effect<CollectionPersistenceStore>, store?: CollectionPersistenceStore) => Effect.Effect<void, PE | CollectionSnapshotCodecError | EffectInputCallbackError, PR>;
+export declare function collectionPersistenceConfig<A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>): CollectionPersistenceConfig<E, R> | undefined;
+export declare function collectionPersistenceConfig<E, R>(definition: AnyCollection<E, R>): CollectionPersistenceConfig<E, R> | undefined;
+export declare const collectionPersistencePersistOptions: <E, R>(config: CollectionPersistenceConfig<E, R>) => CollectionPersistOptions;
+export declare const collectionPersistenceRestoreOptions: <E, R>(config: CollectionPersistenceConfig<E, R>) => CollectionPersistOptions & CollectionHydrateOptions;
+/**
+ * Merge collection and persistence error/requirement channels.
+ *
+ * Use before `Collection.define` when the persistence backend has a different
+ * Effect error or requirement type from the collection load/mutation handlers.
+ */
+export declare const persistedCollectionOptions: <A extends object, K extends CollectionKey = string, E = never, R = never, PE = never, PR = never>(options: CollectionPersistedOptions<A, K, E, R, PE, PR>) => CollectionOptions<A, K, E | PE, R | PR>;
+export declare const persistCollectionForReasonEffect: <A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>, store: CollectionPersistenceStore, storeEffect: Effect.Effect<CollectionPersistenceStore>, reason: "load" | "mutation" | "write") => Effect.Effect<void, E | CollectionSnapshotCodecError | EffectInputCallbackError, R>;
+export declare const restoreCollectionBeforePreloadEffect: <A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>, state: CollectionState<A, K, E>, store: CollectionPersistenceStore, storeEffect: Effect.Effect<CollectionPersistenceStore>, shouldRestore?: () => boolean) => Effect.Effect<boolean, E | CollectionSnapshotCodecError | EffectInputCallbackError, R>;
+export declare const dehydrateCollections: (collections: Iterable<AnyCollection>, store: CollectionPersistenceStore) => CollectionHydrationPayload;
+export declare const dehydrateCollectionsEffect: (collections: Iterable<AnyCollection>, storeEffect: Effect.Effect<CollectionPersistenceStore>) => Effect.Effect<CollectionHydrationPayload, CollectionSnapshotCodecError | EffectInputCallbackError>;
+export declare const hydrateCollectionsEffect: (collections: Iterable<AnyCollection>, payload: CollectionHydrationPayload, options: CollectionHydrateOptions | undefined, storeEffect: Effect.Effect<CollectionPersistenceStore>) => Effect.Effect<void, CollectionSnapshotCodecError | EffectInputCallbackError>;
+export declare const validateCollectionsHydrationEffect: (collections: Iterable<AnyCollection>, payload: CollectionHydrationPayload, options: CollectionHydrateOptions | undefined, storeEffect: Effect.Effect<CollectionPersistenceStore>) => Effect.Effect<void, CollectionSnapshotCodecError | EffectInputCallbackError>;
+/** Creates in-memory key/value storage for collection persistence tests and demos. */
+export declare const makeCollectionMemoryStorage: (initial?: Iterable<readonly [string, string]>) => CollectionMemoryStorage;
+/** Adapts synchronous Web Storage-like hosts into Effect-aware collection persistence storage. */
+export declare const collectionStorageFromSync: (storage: CollectionStorageLike) => CollectionPersistenceStorage<CollectionStorageError, never>;
+//# sourceMappingURL=collection-persistence.d.ts.map

package/dist/collection-persistence.d.ts.map

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