@sunfall/arc-db 0.1.0-alpha.0

package/dist/collection-reactive-binding.js

@@ -0,0 +1,95 @@
+import { invokeEffectInput, runWithRuntime, } from "@sunfall/arc-core";
+import { Effect, Fiber } from "effect";
+import { Query } from "./query-builder.js";
+/**
+ * Subscribes to the collection signals that framework adapters use to refresh
+ * collection-backed UI reads.
+ */
+export const subscribeCollectionReactiveSource = (runtime, collection, notify) => runWithRuntime(runtime, () => {
+    const version = collection.version();
+    const state = collection.state();
+    const unsubscribeVersion = version.subscribe(notify);
+    const unsubscribeState = state.subscribe(notify);
+    return () => {
+        unsubscribeVersion();
+        unsubscribeState();
+    };
+});
+/** Provides the runtime and scopes a collection/live-query Effect. */
+export const bindCollectionRuntimeEffect = (runtime, effect) => Effect.scoped(runtime.provide(effect));
+/** Returns true when two collection source lists have the same identity order. */
+export const sameCollectionReactiveSources = (left, right) => left.length === right.length && left.every((source, index) => Object.is(source, right[index]));
+/** Extracts the current failure value from a collection load state. */
+export const collectionStateError = (state) => state._tag === "Failure" ? state.error : undefined;
+/** Extracts the current failure value from a live-query state. */
+export const liveQueryStateError = (state) => state._tag === "Failure" ? state.error : undefined;
+/** Resolves live-query dependency options to the value used for equality. */
+export const collectionReactiveDepsValue = (deps) => typeof deps === "function" ? deps() : deps;
+/** Returns true when two framework live-query dependency values are equal. */
+export const sameCollectionReactiveDeps = (left, right) => {
+    if (Array.isArray(left) && Array.isArray(right)) {
+        return (left.length === right.length && left.every((value, index) => Object.is(value, right[index])));
+    }
+    return Object.is(left, right);
+};
+/** Copies array dependency values so later caller mutation cannot change memo identity. */
+export const snapshotCollectionReactiveDeps = (value) => Array.isArray(value) ? [...value] : value;
+/** Selects or recreates a runtime-bound LiveQuery for framework adapters. */
+export const selectCollectionReactiveLiveQuery = (runtime, input, deps, previous) => {
+    const stableLiveQueryInput = typeof input === "function" ? undefined : input;
+    if (previous !== undefined &&
+        previous.runtime === runtime &&
+        previous.stableLiveQueryInput === stableLiveQueryInput &&
+        sameCollectionReactiveDeps(previous.deps, deps)) {
+        return previous;
+    }
+    return {
+        runtime,
+        stableLiveQueryInput,
+        deps: snapshotCollectionReactiveDeps(deps),
+        live: runWithRuntime(runtime, () => typeof input === "function" ? Query.live(input) : input),
+    };
+};
+/**
+ * Creates the shared mount-time preload lifecycle used by React DB and Solid DB.
+ *
+ * The controller keeps generation checks in one place so stale preload failures
+ * cannot overwrite newer UI state after a source refresh or unmount.
+ */
+export const makeCollectionReactivePreloadController = (options) => {
+    let preloadFiber;
+    let preloadGeneration = 0;
+    const retireCurrentPreload = () => {
+        preloadGeneration++;
+        const fiber = preloadFiber;
+        preloadFiber = undefined;
+        return fiber;
+    };
+    const interruptEffect = () => Effect.suspend(() => {
+        const fiber = retireCurrentPreload();
+        return fiber === undefined
+            ? Effect.void
+            : Fiber.interrupt(fiber).pipe(Effect.catchCause(() => Effect.void));
+    });
+    const interrupt = () => {
+        const fiber = retireCurrentPreload();
+        if (fiber !== undefined) {
+            void options.runtime.runFork(Fiber.interrupt(fiber).pipe(Effect.catchCause(() => Effect.void)));
+        }
+    };
+    const start = (preloadEffect, enabled) => {
+        interrupt();
+        if (!enabled || preloadEffect === undefined) {
+            return;
+        }
+        const generation = ++preloadGeneration;
+        const isCurrentGeneration = () => preloadGeneration === generation;
+        preloadFiber = options.runtime.runFork(bindCollectionRuntimeEffect(options.runtime, preloadEffect).pipe(Effect.tap(() => isCurrentGeneration()
+            ? invokeEffectInput("CollectionReactivePreload.onSuccess", options.onSuccess).pipe(Effect.catchCause(() => Effect.void), Effect.asVoid)
+            : Effect.void), Effect.catch((error) => isCurrentGeneration()
+            ? invokeEffectInput("CollectionReactivePreload.onFailure", options.onFailure, error).pipe(Effect.catchCause(() => Effect.void), Effect.asVoid)
+            : Effect.void), Effect.catchCause(() => Effect.void)));
+    };
+    return { interruptEffect, interrupt, start };
+};
+//# sourceMappingURL=collection-reactive-binding.js.map

package/dist/collection-reactive-binding.js.map

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

package/dist/collection-registry.d.ts

@@ -0,0 +1,56 @@
+import type { AnyCollection, CollectionDefinitionDiagnostics, CollectionDiagnostics } from "./collection-contract.js";
+/**
+ * Duplicate-name handling for a Collection registry.
+ *
+ * `keep-first` retains the original definition; `replace` stores the latest
+ * definition. Duplicate attempts are recorded in diagnostics for both policies.
+ */
+export type CollectionDefinitionDuplicatePolicy = "keep-first" | "replace";
+/** Options for an isolated Collection Definition Registry Adapter. */
+export interface CollectionDefinitionRegistryOptions {
+    /** Duplicate-name handling. Defaults to `keep-first`. */
+    readonly duplicates?: CollectionDefinitionDuplicatePolicy;
+}
+/** Result of registering a Collection Definition. */
+export interface CollectionDefinitionRegistration {
+    readonly name: string;
+    readonly definition: AnyCollection;
+    readonly sequence: number;
+    readonly duplicate: boolean;
+    readonly retained: AnyCollection;
+}
+/** Diagnostic fact describing one duplicate Collection registration attempt. */
+export interface CollectionDefinitionDuplicateDiagnostics {
+    readonly name: string;
+    readonly policy: CollectionDefinitionDuplicatePolicy;
+    readonly retained: number;
+    readonly discarded: number;
+}
+/** Collection diagnostics plus duplicate registration facts. */
+export interface CollectionDefinitionRegistryDiagnostics extends CollectionDiagnostics {
+    readonly duplicates: readonly CollectionDefinitionDuplicateDiagnostics[];
+}
+/**
+ * Registry abstraction used by Collection factories to register named
+ * definitions, inspect retained definitions, and report duplicate
+ * registrations.
+ */
+export interface CollectionDefinitionRegistryAdapter {
+    register(name: string, definition: AnyCollection): CollectionDefinitionRegistration;
+    definitions(): ReadonlyMap<string, AnyCollection>;
+    diagnostics(): CollectionDefinitionRegistryDiagnostics;
+}
+/** Static diagnostics extracted from a Collection Definition. */
+export declare const collectionDefinitionDiagnostics: (definition: AnyCollection) => CollectionDefinitionDiagnostics;
+/** Creates an isolated Collection Definition Registry Adapter. */
+export declare const makeCollectionDefinitionRegistry: (options?: CollectionDefinitionRegistryOptions) => CollectionDefinitionRegistryAdapter;
+/** Process-wide Collection Definition Registry used by default collection factories. */
+export declare const defaultCollectionDefinitionRegistry: CollectionDefinitionRegistryAdapter;
+export declare const registerCollectionDefinition: (name: string, definition: AnyCollection) => void;
+/** Return the process-wide registry of named collection definitions. */
+export declare const collectionDefinitionRegistry: () => ReadonlyMap<string, AnyCollection>;
+/** Describe registered collections, indexes, handlers, sync, and persistence. */
+export declare const collectionDiagnostics: () => CollectionDiagnostics;
+/** Describe the default registry, including duplicate registrations. */
+export declare const collectionRegistryDiagnostics: () => CollectionDefinitionRegistryDiagnostics;
+//# sourceMappingURL=collection-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection-registry.d.ts","sourceRoot":"","sources":["../src/collection-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,+BAA+B,EAC/B,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,MAAM,MAAM,mCAAmC,GAAG,YAAY,GAAG,SAAS,CAAC;AAE3E,sEAAsE;AACtE,MAAM,WAAW,mCAAmC;IAClD,yDAAyD;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,mCAAmC,CAAC;CAC3D;AAED,qDAAqD;AACrD,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAED,gFAAgF;AAChF,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,mCAAmC,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,gEAAgE;AAChE,MAAM,WAAW,uCAAwC,SAAQ,qBAAqB;IACpF,QAAQ,CAAC,UAAU,EAAE,SAAS,wCAAwC,EAAE,CAAC;CAC1E;AAED;;;;GAIG;AACH,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,GAAG,gCAAgC,CAAC;IACpF,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClD,WAAW,IAAI,uCAAuC,CAAC;CACxD;AAcD,iEAAiE;AACjE,eAAO,MAAM,+BAA+B,eAC9B,aAAa,KACxB,+BAmCF,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,gCAAgC,aAClC,mCAAmC,KAC3C,mCAgFF,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,mCAAmC,qCAAqC,CAAC;AAEtF,eAAO,MAAM,4BAA4B,SAAU,MAAM,cAAc,aAAa,KAAG,IAEtF,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,QAAO,WAAW,CAAC,MAAM,EAAE,aAAa,CAC9B,CAAC;AAEpD,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,QAAO,qBAEvC,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,6BAA6B,QAAO,uCACE,CAAC"}

package/dist/collection-registry.js

@@ -0,0 +1,123 @@
+import { collectionIndexes } from "./collection-index-materialization.js";
+/** Static diagnostics extracted from a Collection Definition. */
+export const collectionDefinitionDiagnostics = (definition) => {
+    const options = definition.options;
+    const persistence = options.persistence;
+    return {
+        name: options.name,
+        readOnly: definition.readOnly === true,
+        inputSchema: options.input !== undefined,
+        outputSchema: options.output !== undefined,
+        initialData: options.initialData !== undefined,
+        indexes: Array.from(collectionIndexes(options), ([name, index]) => ({
+            name,
+            unique: index.unique === true,
+        })).sort((left, right) => left.name.localeCompare(right.name)),
+        load: options.load !== undefined,
+        handlers: {
+            insert: options.onInsert !== undefined,
+            update: options.onUpdate !== undefined,
+            delete: options.onDelete !== undefined,
+        },
+        policy: {
+            retry: options.policy?.retry !== undefined,
+        },
+        ...(options.sync === undefined ? {} : { sync: options.sync }),
+        persistence: {
+            enabled: persistence !== undefined,
+            ...(persistence?.key === undefined ? {} : { key: persistence.key }),
+            hydrate: persistence !== undefined && persistence.hydrate !== false,
+            restoreOnPreload: persistence !== undefined && persistence.restoreOnPreload !== false,
+            loadAfterRestore: persistence?.loadAfterRestore === true,
+            persistOnLoad: persistence !== undefined && persistence.persistOnLoad !== false,
+            persistOnMutation: persistence !== undefined && persistence.persistOnMutation !== false,
+            persistOnWrite: persistence !== undefined && persistence.persistOnWrite !== false,
+        },
+    };
+};
+/** Creates an isolated Collection Definition Registry Adapter. */
+export const makeCollectionDefinitionRegistry = (options = {}) => {
+    const duplicatePolicy = options.duplicates ?? "keep-first";
+    const definitions = new Map();
+    const entries = new Map();
+    const duplicates = [];
+    let nextSequence = 1;
+    return {
+        register: (_name, definition) => {
+            const name = definition.name;
+            const existing = entries.get(name);
+            if (existing?.definition === definition) {
+                return {
+                    name,
+                    definition,
+                    sequence: existing.sequence,
+                    duplicate: false,
+                    retained: definition,
+                };
+            }
+            const sequence = nextSequence++;
+            if (existing === undefined) {
+                definitions.set(name, definition);
+                entries.set(name, { definition, sequence });
+                return {
+                    name,
+                    definition,
+                    sequence,
+                    duplicate: false,
+                    retained: definition,
+                };
+            }
+            if (duplicatePolicy === "replace") {
+                definitions.set(name, definition);
+                entries.set(name, { definition, sequence });
+                duplicates.push({
+                    name,
+                    policy: duplicatePolicy,
+                    retained: sequence,
+                    discarded: existing.sequence,
+                });
+                return {
+                    name,
+                    definition,
+                    sequence,
+                    duplicate: true,
+                    retained: definition,
+                };
+            }
+            duplicates.push({
+                name,
+                policy: duplicatePolicy,
+                retained: existing.sequence,
+                discarded: sequence,
+            });
+            return {
+                name,
+                definition,
+                sequence,
+                duplicate: true,
+                retained: existing.definition,
+            };
+        },
+        definitions: () => new Map(definitions),
+        diagnostics: () => ({
+            collections: Array.from(definitions.values(), collectionDefinitionDiagnostics).sort((left, right) => left.name.localeCompare(right.name)),
+            duplicates: duplicates
+                .slice()
+                .sort((left, right) => left.name.localeCompare(right.name) || left.discarded - right.discarded),
+        }),
+    };
+};
+/** Process-wide Collection Definition Registry used by default collection factories. */
+export const defaultCollectionDefinitionRegistry = makeCollectionDefinitionRegistry();
+export const registerCollectionDefinition = (name, definition) => {
+    defaultCollectionDefinitionRegistry.register(name, definition);
+};
+/** Return the process-wide registry of named collection definitions. */
+export const collectionDefinitionRegistry = () => defaultCollectionDefinitionRegistry.definitions();
+/** Describe registered collections, indexes, handlers, sync, and persistence. */
+export const collectionDiagnostics = () => ({
+    collections: defaultCollectionDefinitionRegistry.diagnostics().collections,
+});
+/** Describe the default registry, including duplicate registrations. */
+export const collectionRegistryDiagnostics = () => defaultCollectionDefinitionRegistry.diagnostics();
+//# sourceMappingURL=collection-registry.js.map

package/dist/collection-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-registry.js","sourceRoot":"","sources":["../src/collection-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAkE1E,iEAAiE;AACjE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAC7C,UAAyB,EACQ,EAAE;IACnC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACnC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAExC,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,UAAU,CAAC,QAAQ,KAAK,IAAI;QACtC,WAAW,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS;QACxC,YAAY,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS;QAC1C,WAAW,EAAE,OAAO,CAAC,WAAW,KAAK,SAAS;QAC9C,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YAClE,IAAI;YACJ,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,IAAI;SAC9B,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9D,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS;QAChC,QAAQ,EAAE;YACR,MAAM,EAAE,OAAO,CAAC,QAAQ,KAAK,SAAS;YACtC,MAAM,EAAE,OAAO,CAAC,QAAQ,KAAK,SAAS;YACtC,MAAM,EAAE,OAAO,CAAC,QAAQ,KAAK,SAAS;SACvC;QACD,MAAM,EAAE;YACN,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,KAAK,SAAS;SAC3C;QACD,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QAC7D,WAAW,EAAE;YACX,OAAO,EAAE,WAAW,KAAK,SAAS;YAClC,GAAG,CAAC,WAAW,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC;YACnE,OAAO,EAAE,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,OAAO,KAAK,KAAK;YACnE,gBAAgB,EAAE,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,gBAAgB,KAAK,KAAK;YACrF,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,KAAK,IAAI;YACxD,aAAa,EAAE,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,aAAa,KAAK,KAAK;YAC/E,iBAAiB,EAAE,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,iBAAiB,KAAK,KAAK;YACvF,cAAc,EAAE,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,cAAc,KAAK,KAAK;SAClF;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,OAAO,GAAwC,EAAE,EACZ,EAAE;IACvC,MAAM,eAAe,GAAG,OAAO,CAAC,UAAU,IAAI,YAAY,CAAC;IAC3D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6C,CAAC;IACrE,MAAM,UAAU,GAA8C,EAAE,CAAC;IACjE,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,OAAO;QACL,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;YAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEnC,IAAI,QAAQ,EAAE,UAAU,KAAK,UAAU,EAAE,CAAC;gBACxC,OAAO;oBACL,IAAI;oBACJ,UAAU;oBACV,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,SAAS,EAAE,KAAK;oBAChB,QAAQ,EAAE,UAAU;iBACrB,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;YAEhC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC5C,OAAO;oBACL,IAAI;oBACJ,UAAU;oBACV,QAAQ;oBACR,SAAS,EAAE,KAAK;oBAChB,QAAQ,EAAE,UAAU;iBACrB,CAAC;YACJ,CAAC;YAED,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;gBAClC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC5C,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI;oBACJ,MAAM,EAAE,eAAe;oBACvB,QAAQ,EAAE,QAAQ;oBAClB,SAAS,EAAE,QAAQ,CAAC,QAAQ;iBAC7B,CAAC,CAAC;gBACH,OAAO;oBACL,IAAI;oBACJ,UAAU;oBACV,QAAQ;oBACR,SAAS,EAAE,IAAI;oBACf,QAAQ,EAAE,UAAU;iBACrB,CAAC;YACJ,CAAC;YAED,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI;gBACJ,MAAM,EAAE,eAAe;gBACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,SAAS,EAAE,QAAQ;aACpB,CAAC,CAAC;YACH,OAAO;gBACL,IAAI;gBACJ,UAAU;gBACV,QAAQ;gBACR,SAAS,EAAE,IAAI;gBACf,QAAQ,EAAE,QAAQ,CAAC,UAAU;aAC9B,CAAC;QACJ,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC;QACvC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YAClB,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,+BAA+B,CAAC,CAAC,IAAI,CACjF,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CACrD;YACD,UAAU,EAAE,UAAU;iBACnB,KAAK,EAAE;iBACP,IAAI,CACH,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CACzF;SACJ,CAAC;KACH,CAAC;AACJ,CAAC,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,mCAAmC,GAAG,gCAAgC,EAAE,CAAC;AAEtF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,IAAY,EAAE,UAAyB,EAAQ,EAAE;IAC5F,mCAAmC,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAuC,EAAE,CACnF,mCAAmC,CAAC,WAAW,EAAE,CAAC;AAEpD,iFAAiF;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAA0B,EAAE,CAAC,CAAC;IACjE,WAAW,EAAE,mCAAmC,CAAC,WAAW,EAAE,CAAC,WAAW;CAC3E,CAAC,CAAC;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAA4C,EAAE,CACzF,mCAAmC,CAAC,WAAW,EAAE,CAAC"}

package/dist/collection-row-ingress.d.ts

@@ -0,0 +1,16 @@
+import { EffectInputCallbackError } from "@sunfall/arc-core";
+import { Effect } from "effect";
+import type { CollectionDefinition, CollectionKey, CollectionOrigin } from "./collection-contract.js";
+import type { StoredRow } from "./collection-state.js";
+import { CollectionSnapshotCodecError, type CollectionSnapshotCodecOperation } from "./collection-snapshot-codec.js";
+interface CollectionRowIngressOptions {
+    readonly operation: CollectionSnapshotCodecOperation;
+    readonly path: string;
+    readonly synced: boolean;
+    readonly origin: CollectionOrigin;
+}
+export declare const ingestCollectionOutputRowsEffect: <A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>, values: ReadonlyArray<A>, options: CollectionRowIngressOptions) => Effect.Effect<ReadonlyArray<StoredRow<A, K>>, CollectionSnapshotCodecError | EffectInputCallbackError>;
+export declare const ingestCollectionMutationRowsEffect: <A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>, values: ReadonlyArray<A>, options: CollectionRowIngressOptions) => Effect.Effect<ReadonlyArray<StoredRow<A, K>>, CollectionSnapshotCodecError | EffectInputCallbackError>;
+export declare const ingestCollectionOutputRowsSync: <A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>, values: ReadonlyArray<A>, options: CollectionRowIngressOptions) => ReadonlyArray<StoredRow<A, K>>;
+export {};
+//# sourceMappingURL=collection-row-ingress.d.ts.map

package/dist/collection-row-ingress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-row-ingress.d.ts","sourceRoot":"","sources":["../src/collection-row-ingress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMvD,OAAO,EACL,4BAA4B,EAI5B,KAAK,gCAAgC,EACtC,MAAM,gCAAgC,CAAC;AAExC,UAAU,2BAA2B;IACnC,QAAQ,CAAC,SAAS,EAAE,gCAAgC,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAgMD,eAAO,MAAM,gCAAgC,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,EAAE,CAAC,EAAE,CAAC,cAClF,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,UACpC,aAAa,CAAC,CAAC,CAAC,WACf,2BAA2B,KACnC,MAAM,CAAC,MAAM,CACd,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAC9B,4BAA4B,GAAG,wBAAwB,CAUtD,CAAC;AAEJ,eAAO,MAAM,kCAAkC,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,EAAE,CAAC,EAAE,CAAC,cACpF,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,UACpC,aAAa,CAAC,CAAC,CAAC,WACf,2BAA2B,KACnC,MAAM,CAAC,MAAM,CACd,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAC9B,4BAA4B,GAAG,wBAAwB,CAKtD,CAAC;AAEJ,eAAO,MAAM,8BAA8B,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,EAAE,CAAC,EAAE,CAAC,cAChF,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,UACpC,aAAa,CAAC,CAAC,CAAC,WACf,2BAA2B,KACnC,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAU7B,CAAC"}

package/dist/collection-row-ingress.js

@@ -0,0 +1,110 @@
+import { EffectInputCallbackError } from "@sunfall/arc-core";
+import { Effect } from "effect";
+import { CollectionValueReadError, cloneCollectionValue, collectionExecutableValuePath, } from "./collection-value-detachment.js";
+import { CollectionSnapshotCodecError, decodeCollectionOutputValuesEffect, decodeCollectionOutputValuesSync, validateCollectionKey, } from "./collection-snapshot-codec.js";
+const collectionIngressCallbackError = (definition, operation, path, cause) => new EffectInputCallbackError({
+    operation: `Collection.getKey(${definition.name})`,
+    cause,
+    guidance: `Collection row ingress getKey callbacks must be synchronous, pure, and total. The failing ${operation} value was at ${path}.`,
+});
+const collectionIngressKey = (definition, value, operation, path) => {
+    try {
+        return validateCollectionKey(definition.getKey(value), operation, path);
+    }
+    catch (cause) {
+        if (cause instanceof CollectionSnapshotCodecError) {
+            throw cause;
+        }
+        throw collectionIngressCallbackError(definition, operation, path, cause);
+    }
+};
+const collectionIngressKeyEffect = (definition, value, operation, path) => Effect.try({
+    try: () => collectionIngressKey(definition, value, operation, path),
+    catch: (cause) => cause instanceof CollectionSnapshotCodecError || cause instanceof EffectInputCallbackError
+        ? cause
+        : collectionIngressCallbackError(definition, operation, path, cause),
+});
+const validateCollectionPlainRowValue = (value, operation, path) => {
+    try {
+        const executable = collectionExecutableValuePath(value, path);
+        if (executable !== undefined) {
+            throw new CollectionSnapshotCodecError({
+                operation,
+                path: executable.path,
+                reason: executable.reason,
+            });
+        }
+    }
+    catch (cause) {
+        if (cause instanceof CollectionSnapshotCodecError) {
+            throw cause;
+        }
+        throw collectionRowValueReadError(operation, cause);
+    }
+};
+const collectionRowValueReadError = (operation, cause) => {
+    const path = cause instanceof CollectionValueReadError ? cause.path : "$";
+    return new EffectInputCallbackError({
+        operation: `Collection.rowValue.${operation}`,
+        cause,
+        guidance: `Collection row values must be plain readable data before ${operation}. Reading row data at ${path} failed; move host getters/proxies behind collection load or mutation Effects.`,
+    });
+};
+const validateCollectionPlainRowValueEffect = (value, operation, path) => Effect.try({
+    try: () => validateCollectionPlainRowValue(value, operation, path),
+    catch: (cause) => cause instanceof CollectionSnapshotCodecError || cause instanceof EffectInputCallbackError
+        ? cause
+        : collectionRowValueReadError(operation, cause),
+});
+const cloneCollectionRowValue = (value, operation, path) => {
+    try {
+        return cloneCollectionValue(value, undefined, path);
+    }
+    catch (cause) {
+        throw collectionRowValueReadError(operation, cause);
+    }
+};
+const cloneCollectionRowValueEffect = (value, operation, path) => Effect.try({
+    try: () => cloneCollectionRowValue(value, operation, path),
+    catch: (cause) => cause instanceof EffectInputCallbackError
+        ? cause
+        : collectionRowValueReadError(operation, cause),
+});
+const storedRowsFromDecodedValuesEffect = (definition, values, options) => Effect.gen(function* () {
+    const rows = [];
+    for (const [index, decoded] of values.entries()) {
+        const valuePath = `${options.path}[${index}]`;
+        yield* validateCollectionPlainRowValueEffect(decoded, options.operation, valuePath);
+        const value = yield* cloneCollectionRowValueEffect(decoded, options.operation, valuePath);
+        const key = yield* collectionIngressKeyEffect(definition, value, options.operation, `${options.path}[${index}].key`);
+        rows.push({
+            key,
+            value,
+            synced: options.synced,
+            origin: options.origin,
+        });
+    }
+    return rows;
+});
+const storedRowsFromDecodedValuesSync = (definition, values, options) => {
+    const rows = [];
+    for (const [index, decoded] of values.entries()) {
+        const valuePath = `${options.path}[${index}]`;
+        validateCollectionPlainRowValue(decoded, options.operation, valuePath);
+        const value = cloneCollectionRowValue(decoded, options.operation, valuePath);
+        const key = collectionIngressKey(definition, value, options.operation, `${options.path}[${index}].key`);
+        rows.push({
+            key,
+            value,
+            synced: options.synced,
+            origin: options.origin,
+        });
+    }
+    return rows;
+};
+const decodeCollectionInputValuesEffect = (definition, values, operation, path) => decodeCollectionOutputValuesEffect(definition.options.input, values, operation, path);
+const decodeCollectionMutationValuesEffect = (definition, values, operation, path) => Effect.flatMap(decodeCollectionInputValuesEffect(definition, values, operation, `${path}.input`), (decodedInput) => decodeCollectionOutputValuesEffect(definition.options.output, decodedInput, operation, path));
+export const ingestCollectionOutputRowsEffect = (definition, values, options) => Effect.flatMap(decodeCollectionOutputValuesEffect(definition.options.output, values, options.operation, options.path), (decoded) => storedRowsFromDecodedValuesEffect(definition, decoded, options));
+export const ingestCollectionMutationRowsEffect = (definition, values, options) => Effect.flatMap(decodeCollectionMutationValuesEffect(definition, values, options.operation, options.path), (decoded) => storedRowsFromDecodedValuesEffect(definition, decoded, options));
+export const ingestCollectionOutputRowsSync = (definition, values, options) => storedRowsFromDecodedValuesSync(definition, decodeCollectionOutputValuesSync(definition.options.output, values, options.operation, options.path), options);
+//# sourceMappingURL=collection-row-ingress.js.map

package/dist/collection-row-ingress.js.map

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

package/dist/collection-runtime.d.ts

@@ -0,0 +1,20 @@
+import { EffectInputCallbackError, type EffectInput } from "@sunfall/arc-core";
+import { Effect, Scope } from "effect";
+import type { CollectionSnapshotCodecError } from "./collection-snapshot-codec.js";
+import type { CollectionChangeFeedAdapter, CollectionChangeFeedSubscribeOptions } from "./sync-adapter.js";
+import { type RuntimeCollectionStore } from "./runtime-collection-store.js";
+import type { AnyCollection, CollectionChange, CollectionDefinition, CollectionHydrateOptions, CollectionHydrationPayload, CollectionKey, CollectionOptions, CollectionPersistOptions, CollectionRuntimeError, CollectionWriteOptions } from "./collection-contract.js";
+export { collectionStoreEffect, currentCollectionStore, runWithCollectionStore, storeFor, subscribeCollectionEventsEffect, type RuntimeCollectionStore, } from "./runtime-collection-store.js";
+export declare const recordCollectionPreload: (definition: AnyCollection) => Effect.Effect<void>;
+export declare const persistenceKey: <A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>, options?: CollectionPersistOptions) => string;
+export declare const dehydrateCollections: (collections: Iterable<AnyCollection>, store?: RuntimeCollectionStore) => CollectionHydrationPayload;
+export declare const dehydrateCollectionsEffect: (collections: Iterable<AnyCollection>) => Effect.Effect<CollectionHydrationPayload, CollectionSnapshotCodecError | EffectInputCallbackError>;
+export declare const hydrateCollectionsEffect: (collections: Iterable<AnyCollection>, payload: CollectionHydrationPayload, options?: CollectionHydrateOptions) => Effect.Effect<void, CollectionSnapshotCodecError | EffectInputCallbackError>;
+export declare const validateCollectionsHydrationEffect: (collections: Iterable<AnyCollection>, payload: CollectionHydrationPayload, options?: CollectionHydrateOptions) => Effect.Effect<void, CollectionSnapshotCodecError | EffectInputCallbackError>;
+export declare const subscribeCollectionChangesEffect: <A extends object, K extends CollectionKey, E, R, FeedError = never, FeedRequirements = never>(definition: CollectionDefinition<A, K, E, R>, adapter: CollectionChangeFeedAdapter<A, K, FeedError, FeedRequirements, E, R>, options?: CollectionChangeFeedSubscribeOptions) => Effect.Effect<void, CollectionRuntimeError<E> | FeedError, R | FeedRequirements | Scope.Scope>;
+export declare const applyCollectionChangesEffect: <A extends object, K extends CollectionKey, E, R>(definition: CollectionDefinition<A, K, E, R>, changes: ReadonlyArray<CollectionChange<A, K>>, options?: CollectionWriteOptions) => Effect.Effect<void, CollectionRuntimeError<E>, R>;
+export declare const defineCollection: <A extends object, K extends CollectionKey = string, E = never, R = never>(options: Omit<CollectionOptions<A, K, E, R>, "load" | "refetch"> & {
+    readonly load?: () => EffectInput<ReadonlyArray<A>, E, R>;
+    readonly refetch?: () => EffectInput<ReadonlyArray<A>, E, R>;
+}, register: (name: string, definition: AnyCollection) => void) => CollectionDefinition<A, K, E, R>;
+//# sourceMappingURL=collection-runtime.d.ts.map

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

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