@sunfall/arc-db 0.1.0-alpha.0

package/dist/runtime-collection-store.js

@@ -0,0 +1,149 @@
+import { currentOrDefaultRuntime, ResourceStore, } from "@sunfall/arc-core";
+import { Effect, Option, PubSub, Scope } from "effect";
+import { CollectionStoreTypeId } from "./collection-ids.js";
+import { bumpCollectionState, makeCollectionState, } from "./collection-state.js";
+import { ingestCollectionOutputRowsSync } from "./collection-row-ingress.js";
+const initialDataPath = (definition) => `$.collections[${definition.name}].initialData`;
+const stateForDefinition = (state) => state;
+const initializeCollectionState = (definition, state) => {
+    if (state.initialized) {
+        return;
+    }
+    state.initialized = true;
+    const initialData = definition.options.initialData ?? [];
+    if (initialData.length === 0) {
+        return;
+    }
+    try {
+        const rows = ingestCollectionOutputRowsSync(definition, initialData, {
+            operation: "load",
+            path: initialDataPath(definition),
+            synced: true,
+            origin: "remote",
+        });
+        for (const row of rows) {
+            state.rows.set(row.key, row);
+        }
+        state.initialDataError = undefined;
+        state.loadState.set({ _tag: "Ready", waiting: false, updatedAt: Date.now() });
+        bumpCollectionState(state);
+    }
+    catch (error) {
+        state.rows.clear();
+        state.initialDataError = error;
+        state.loadState.set({
+            _tag: "Failure",
+            waiting: false,
+            error: state.initialDataError,
+        });
+    }
+};
+/**
+ * Runtime/request-local owner of collection state, diagnostics, and lifecycle
+ * events.
+ *
+ * The store is keyed through the active Resource Store's module registry, so
+ * SSR requests, client runtimes, and tests get isolated collection rows,
+ * pending mutation queues, and event streams.
+ */
+export class RuntimeCollectionStore {
+    [CollectionStoreTypeId] = CollectionStoreTypeId;
+    #states = new WeakMap();
+    #definitions = new Set();
+    #events = Effect.runSync(PubSub.sliding(1024));
+    disposeEffect = PubSub.shutdown(this.#events);
+    diagnostics = {
+        snapshot: () => this.diagnosticsSnapshot(),
+        snapshotEffect: Effect.sync(() => this.diagnosticsSnapshot()),
+    };
+    state(definition) {
+        const existing = this.#states.get(definition);
+        if (existing) {
+            return stateForDefinition(existing);
+        }
+        const state = makeCollectionState();
+        this.#definitions.add(definition);
+        this.#states.set(definition, state);
+        initializeCollectionState(definition, state);
+        return state;
+    }
+    diagnosticsSnapshot() {
+        let rowCount = 0;
+        let pendingMutationCount = 0;
+        let activeMutationCount = 0;
+        let optimisticRowCount = 0;
+        let loadingCount = 0;
+        let failureCount = 0;
+        for (const definition of this.#definitions) {
+            const state = this.#states.get(definition);
+            if (!state) {
+                continue;
+            }
+            rowCount += state.rows.size;
+            pendingMutationCount += state.pendingMutations.size;
+            optimisticRowCount += state.optimisticRows.size;
+            for (const pending of state.pendingMutations.values()) {
+                if (pending.activeAttempt !== undefined) {
+                    activeMutationCount += 1;
+                }
+            }
+            const loadState = state.loadState.get();
+            if (loadState.waiting) {
+                loadingCount += 1;
+            }
+            if (loadState._tag === "Failure") {
+                failureCount += 1;
+            }
+        }
+        return {
+            collectionCount: this.#definitions.size,
+            rowCount,
+            pendingMutationCount,
+            activeMutationCount,
+            optimisticRowCount,
+            loadingCount,
+            failureCount,
+        };
+    }
+    publish(event) {
+        return PubSub.publish(this.#events, event).pipe(Effect.asVoid);
+    }
+    subscribeEventsEffect() {
+        return PubSub.subscribe(this.#events);
+    }
+}
+const makeCollectionStore = () => new RuntimeCollectionStore();
+const isRuntimeCollectionStore = (value) => value instanceof RuntimeCollectionStore;
+/** Resolve the Runtime Collection Store attached to a Resource Store. */
+export const storeFor = (resourceStore) => {
+    const existing = resourceStore.moduleRegistry.get(CollectionStoreTypeId);
+    if (isRuntimeCollectionStore(existing)) {
+        return existing;
+    }
+    const store = makeCollectionStore();
+    resourceStore.moduleRegistry.register(CollectionStoreTypeId, store);
+    return store;
+};
+export const defaultRuntimeCollectionStore = () => storeFor(currentOrDefaultRuntime().resourceStore);
+const resourceStoreEffect = Effect.gen(function* () {
+    const store = yield* Effect.serviceOption(ResourceStore);
+    return Option.isSome(store) ? store.value : currentOrDefaultRuntime().resourceStore;
+});
+/** Access the active Runtime Collection Store from inside Effect. */
+export const collectionStoreEffect = Effect.map(resourceStoreEffect, storeFor);
+let currentCollectionStoreOverride;
+/** Access the active Runtime Collection Store from synchronous render/read seams. */
+export const currentCollectionStore = () => currentCollectionStoreOverride ?? defaultRuntimeCollectionStore();
+export const runWithCollectionStore = (store, evaluate) => {
+    const previous = currentCollectionStoreOverride;
+    currentCollectionStoreOverride = store;
+    try {
+        return evaluate();
+    }
+    finally {
+        currentCollectionStoreOverride = previous;
+    }
+};
+/** Subscribe to active Runtime Collection Store events inside a Scope. */
+export const subscribeCollectionEventsEffect = () => Effect.flatMap(collectionStoreEffect, (store) => store.subscribeEventsEffect());
+//# sourceMappingURL=runtime-collection-store.js.map

package/dist/runtime-collection-store.js.map

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

package/dist/server-collection.d.ts

@@ -0,0 +1,84 @@
+import { EffectInputCallbackError, type EffectInput, type RejectPromiseLikeValue, type ServerClientError, type ServerFunction } from "@sunfall/arc-core";
+import type { CollectionIndexRecord, CollectionKey, CollectionOptions, CollectionPolicy } from "./collection-contract.js";
+import { type CollectionSyncAdapter, type CollectionSyncDeletePayload, type CollectionSyncInsertPayload, type CollectionSyncUpdatePayload } from "./sync-adapter.js";
+/**
+ * Return type accepted from server collection operations.
+ *
+ * Use Effect-first callbacks or `ServerFunction`s so transport failures remain
+ * typed in the collection error channel.
+ */
+export type ServerCollectionResult<A, E = never, R = never> = EffectInput<A & RejectPromiseLikeValue<A>, E, R>;
+/**
+ * Server-backed operation used by `serverCollectionSyncAdapter`.
+ *
+ * A `ServerFunction` is invoked through `.effect(input)`; a plain callback is
+ * converted with `toEffect`.
+ */
+export type ServerCollectionOperation<I, A, E = never, R = never> = ServerFunction<I, A, E, R> | ((input: I) => ServerCollectionResult<A, E, R>);
+/** Insert payload accepted by a server-backed collection operation. */
+export type ServerCollectionInsertPayload<A extends object, K extends CollectionKey> = CollectionSyncInsertPayload<A, K>;
+/** Update payload accepted by a server-backed collection operation. */
+export type ServerCollectionUpdatePayload<A extends object, K extends CollectionKey> = CollectionSyncUpdatePayload<A, K>;
+/** Delete payload accepted by a server-backed collection operation. */
+export type ServerCollectionDeletePayload<A extends object, K extends CollectionKey> = CollectionSyncDeletePayload<A, K>;
+type ServerCollectionIdentity = {
+    readonly name: string;
+    readonly id?: string;
+} | {
+    readonly id: string;
+    readonly name?: string;
+};
+/**
+ * Options for a collection backed by server functions.
+ *
+ * Provide a stable `name` or `id`; it is used for collection identity, sync
+ * diagnostics, and persistence keys. Server client failures are included in the
+ * resulting collection error channel.
+ */
+export type ServerCollectionOptions<A extends object, K extends CollectionKey = string, E = never, R = never> = ServerCollectionIdentity & {
+    readonly input?: unknown;
+    readonly output?: unknown;
+    readonly policy?: CollectionPolicy<E | EffectInputCallbackError | ServerClientError>;
+    readonly getKey: (value: A) => K;
+    readonly indexes?: CollectionIndexRecord<A>;
+    readonly initialData?: ReadonlyArray<A>;
+    readonly load?: ServerCollectionOperation<void, ReadonlyArray<A>, E, R>;
+    readonly refetch?: ServerCollectionOperation<void, ReadonlyArray<A>, E, R>;
+    readonly insert?: ServerCollectionOperation<ServerCollectionInsertPayload<A, K>, void, E, R>;
+    readonly update?: ServerCollectionOperation<ServerCollectionUpdatePayload<A, K>, void, E, R>;
+    readonly delete?: ServerCollectionOperation<ServerCollectionDeletePayload<A, K>, void, E, R>;
+};
+declare const ServerCollectionMissingIdentity_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: "ServerCollectionMissingIdentity";
+} & Readonly<A>;
+/**
+ * Error thrown when server collection options omit both `name` and `id`.
+ */
+export declare class ServerCollectionMissingIdentity extends ServerCollectionMissingIdentity_base<{
+    readonly guidance: string;
+}> {
+}
+/**
+ * Build a sync adapter from server functions or Effect callbacks.
+ *
+ * Use this when you want to compose the adapter manually before passing it to
+ * `collectionSyncOptions` or `Collection.syncOptions`.
+ */
+export declare const serverCollectionSyncAdapter: <A extends object, K extends CollectionKey = string, E = never, R = never>(options: ServerCollectionOptions<A, K, E, R>) => CollectionSyncAdapter<A, K, E | EffectInputCallbackError | ServerClientError, R>;
+/**
+ * Build `Collection.define` options for a server-backed collection.
+ *
+ * Load/refetch and mutation operations are converted to Effect, and
+ * `ServerClientError` is added to the collection error channel.
+ *
+ * @example
+ * const todos = Collection.define(serverCollectionOptions({
+ *   name: "todos",
+ *   getKey: (todo) => todo.id,
+ *   load: listTodos,
+ *   update: updateTodos
+ * }))
+ */
+export declare const serverCollectionOptions: <A extends object, K extends CollectionKey = string, E = never, R = never>(options: ServerCollectionOptions<A, K, E, R>) => CollectionOptions<A, K, E | EffectInputCallbackError | ServerClientError, R>;
+export {};
+//# sourceMappingURL=server-collection.d.ts.map

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

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

package/dist/server-collection.js

@@ -0,0 +1,84 @@
+import { EffectInputCallbackError, isServerFunction, invokeEffectInput, } from "@sunfall/arc-core";
+import { Data, Effect } from "effect";
+import { collectionSyncOptions, } from "./sync-adapter.js";
+/**
+ * Error thrown when server collection options omit both `name` and `id`.
+ */
+export class ServerCollectionMissingIdentity extends Data.TaggedError("ServerCollectionMissingIdentity") {
+}
+const isServerCollectionFunction = (operation) => isServerFunction(operation);
+const runOperation = (operation, callback, input) => Effect.suspend(() => {
+    const current = operation();
+    if (isServerCollectionFunction(current)) {
+        return invokeEffectInput("Collection.server.operation", () => current.effect(input));
+    }
+    return invokeEffectInput("Collection.server.operation", callback);
+});
+const serverCollectionName = (options) => {
+    const name = options.name ?? options.id;
+    if (name === undefined) {
+        throw new ServerCollectionMissingIdentity({
+            guidance: "Pass a stable name or id so the collection can be keyed, synced, and traced.",
+        });
+    }
+    return name;
+};
+/**
+ * Build a sync adapter from server functions or Effect callbacks.
+ *
+ * Use this when you want to compose the adapter manually before passing it to
+ * `collectionSyncOptions` or `Collection.syncOptions`.
+ */
+export const serverCollectionSyncAdapter = (options) => ({
+    name: serverCollectionName(options),
+    ...(options.load === undefined
+        ? {}
+        : {
+            load: () => runOperation(() => options.load, () => options.load(undefined), undefined),
+        }),
+    ...(options.refetch === undefined
+        ? {}
+        : {
+            refetch: () => runOperation(() => options.refetch, () => options.refetch(undefined), undefined),
+        }),
+    ...(options.insert === undefined
+        ? {}
+        : {
+            insert: (payload) => runOperation(() => options.insert, () => options.insert(payload), payload),
+        }),
+    ...(options.update === undefined
+        ? {}
+        : {
+            update: (payload) => runOperation(() => options.update, () => options.update(payload), payload),
+        }),
+    ...(options.delete === undefined
+        ? {}
+        : {
+            delete: (payload) => runOperation(() => options.delete, () => options.delete(payload), payload),
+        }),
+});
+/**
+ * Build `Collection.define` options for a server-backed collection.
+ *
+ * Load/refetch and mutation operations are converted to Effect, and
+ * `ServerClientError` is added to the collection error channel.
+ *
+ * @example
+ * const todos = Collection.define(serverCollectionOptions({
+ *   name: "todos",
+ *   getKey: (todo) => todo.id,
+ *   load: listTodos,
+ *   update: updateTodos
+ * }))
+ */
+export const serverCollectionOptions = (options) => collectionSyncOptions({
+    name: serverCollectionName(options),
+    getKey: options.getKey,
+    sync: serverCollectionSyncAdapter(options),
+    ...(options.input === undefined ? {} : { input: options.input }),
+    ...(options.output === undefined ? {} : { output: options.output }),
+    ...(options.policy === undefined ? {} : { policy: options.policy }),
+    ...(options.indexes === undefined ? {} : { indexes: options.indexes }),
+    ...(options.initialData === undefined ? {} : { initialData: options.initialData }),
+});
+//# sourceMappingURL=server-collection.js.map

package/dist/server-collection.js.map

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

package/dist/sqlite-persistence.d.ts

@@ -0,0 +1,239 @@
+import { EffectInputCallbackError } from "@sunfall/arc-core";
+import type { EffectInput } from "@sunfall/arc-core";
+import type { CollectionPersistenceStorage } from "./collection-contract.js";
+/** Default SQLite table used by collection persistence helpers. */
+export declare const SQLITE_PERSISTENCE_DEFAULT_TABLE = "sunfall_arc_collection_persistence";
+/** Default namespace prefix for persisted collection snapshot rows. */
+export declare const SQLITE_PERSISTENCE_DEFAULT_NAMESPACE = "sunfall-arc:collections";
+/** Default schema version written to collection persistence rows. */
+export declare const SQLITE_PERSISTENCE_DEFAULT_SCHEMA_VERSION = 1;
+/**
+ * Namespaced key for one persisted collection snapshot.
+ */
+export interface SQLitePersistenceKey {
+    readonly namespace: string;
+    readonly key: string;
+}
+/**
+ * Row shape stored by the SQLite persistence driver.
+ */
+export interface SQLitePersistenceRow extends SQLitePersistenceKey {
+    readonly schemaVersion: number;
+    readonly value: string;
+    readonly updatedAt: number;
+}
+/**
+ * Effect-aware table adapter for persistence rows.
+ *
+ * Implement this directly for custom SQLite clients, or use
+ * `makeSQLiteStatementPersistenceDriver` for SQL statement based clients.
+ */
+export interface SQLitePersistenceTable<E = never, R = never> {
+    readonly ensure?: () => EffectInput<void, E, R>;
+    readonly get: (key: SQLitePersistenceKey) => EffectInput<SQLitePersistenceRow | null, E, R>;
+    readonly upsert: (row: SQLitePersistenceRow) => EffectInput<void, E, R>;
+    readonly delete?: (key: SQLitePersistenceKey) => EffectInput<void, E, R>;
+}
+/**
+ * Driver that resolves named persistence tables.
+ */
+export interface SQLitePersistenceDriver<E = never, R = never> {
+    readonly table: (name: string) => SQLitePersistenceTable<E, R>;
+}
+/**
+ * SQLite parameter value supported by generated persistence SQL.
+ */
+export type SQLiteStatementValue = string | number | null;
+/** Positional parameter list accepted by generated SQLite persistence SQL. */
+export type SQLiteStatementParams = ReadonlyArray<SQLiteStatementValue>;
+/**
+ * Row shape returned by generated SELECT statements.
+ */
+export interface SQLiteStatementRow {
+    readonly namespace?: unknown;
+    readonly key?: unknown;
+    readonly schema_version?: unknown;
+    readonly schemaVersion?: unknown;
+    readonly value?: unknown;
+    readonly updated_at?: unknown;
+    readonly updatedAt?: unknown;
+}
+/**
+ * Minimal SQL statement database used by the SQLite persistence driver.
+ */
+export interface SQLiteStatementDatabase<E = never, R = never> {
+    readonly execute: (sql: string, params?: SQLiteStatementParams) => EffectInput<void, E, R>;
+    readonly select: (sql: string, params?: SQLiteStatementParams) => EffectInput<ReadonlyArray<SQLiteStatementRow>, E, R>;
+}
+/**
+ * Prepared statement shape for clients with `run` and `all` methods.
+ */
+export interface SQLitePreparedStatement<Row extends SQLiteStatementRow = SQLiteStatementRow, E = never, R = never> {
+    readonly run: (...params: Array<SQLiteStatementValue>) => EffectInput<void, E, R>;
+    readonly all: (...params: Array<SQLiteStatementValue>) => EffectInput<ReadonlyArray<Row>, E, R>;
+}
+/**
+ * SQLite client shape for adapters that expose `prepare`.
+ */
+export interface SQLitePreparedStatementDatabase<Row extends SQLiteStatementRow = SQLiteStatementRow, E = never, R = never> {
+    readonly prepare: (sql: string) => EffectInput<SQLitePreparedStatement<Row, E, R>, E, R>;
+}
+/**
+ * Options for the prepared-statement adapter.
+ */
+export interface SQLitePreparedStatementDatabaseOptions {
+    readonly cache?: boolean;
+}
+/**
+ * SQL statement recorded by the in-memory statement database.
+ */
+export interface SQLiteMemoryStatement {
+    readonly sql: string;
+    readonly params?: SQLiteStatementParams;
+}
+/**
+ * In-memory implementation of the generated persistence SQL.
+ *
+ * Useful for tests and examples. It records statements and supports only the
+ * SQL generated by `makeSQLiteStatementPersistenceDriver`.
+ */
+export interface SQLiteMemoryStatementDatabase extends SQLiteStatementDatabase<never, never> {
+    readonly statements: ReadonlyArray<SQLiteMemoryStatement>;
+    row(table: string, namespace: string, key: string): SQLitePersistenceRow | undefined;
+    tableRows(table: string): ReadonlyArray<SQLitePersistenceRow>;
+    clear(): void;
+}
+/**
+ * Options for collection persistence stored in SQLite.
+ */
+export interface SQLitePersistenceOptions {
+    readonly namespace?: string;
+    readonly tableName?: string;
+    readonly schemaVersion?: number;
+    readonly now?: () => number;
+}
+declare const SQLitePersistenceInvalidTableName_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: "SQLitePersistenceInvalidTableName";
+} & Readonly<A>;
+/**
+ * Error raised before generating SQL for an invalid table name.
+ */
+export declare class SQLitePersistenceInvalidTableName extends SQLitePersistenceInvalidTableName_base<{
+    readonly tableName: string;
+    readonly reason: "Empty" | "ContainsNul";
+    readonly guidance: string;
+}> {
+}
+declare const SQLitePersistenceUnsupportedStatement_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: "SQLitePersistenceUnsupportedStatement";
+} & Readonly<A>;
+/**
+ * Error raised by the in-memory adapter for SQL outside the generated subset.
+ */
+export declare class SQLitePersistenceUnsupportedStatement extends SQLitePersistenceUnsupportedStatement_base<{
+    readonly sql: string;
+    readonly operation: "tableName" | "execute" | "select";
+    readonly guidance: string;
+}> {
+}
+declare const SQLitePersistenceInvalidRow_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: "SQLitePersistenceInvalidRow";
+} & Readonly<A>;
+/** Error raised when a SQLite statement row does not match the persistence row contract. */
+export declare class SQLitePersistenceInvalidRow extends SQLitePersistenceInvalidRow_base<{
+    readonly field: "namespace" | "key" | "schema_version" | "value" | "updated_at";
+    readonly value: unknown;
+    readonly expected: "string" | "finite-number";
+    readonly guidance: string;
+}> {
+}
+declare const SQLitePersistenceInvalidStatementParams_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: "SQLitePersistenceInvalidStatementParams";
+} & Readonly<A>;
+/** Error raised when generated in-memory SQLite statements receive malformed params. */
+export declare class SQLitePersistenceInvalidStatementParams extends SQLitePersistenceInvalidStatementParams_base<{
+    readonly operation: "insert" | "select" | "delete";
+    readonly field: "params" | "namespace" | "key" | "schema_version" | "value" | "updated_at";
+    readonly value: unknown;
+    readonly expected: "exact-param-count" | "string" | "finite-number";
+    readonly expectedCount?: number;
+    readonly actualCount?: number;
+    readonly guidance: string;
+}> {
+}
+/**
+ * Create an in-memory statement database that understands generated SQL.
+ *
+ * Use for tests or demos that need SQLite persistence behavior without a real
+ * SQLite runtime.
+ */
+export declare const makeSQLiteMemoryStatementDatabase: () => SQLiteMemoryStatementDatabase;
+/**
+ * Adapt a `prepare`/`run`/`all` SQLite client to the statement database shape.
+ *
+ * Enable `cache` to reuse prepared statements by SQL string.
+ */
+export declare const makeSQLitePreparedStatementDatabase: <Row extends SQLiteStatementRow = SQLiteStatementRow, E = never, R = never>(database: SQLitePreparedStatementDatabase<Row, E, R>, options?: SQLitePreparedStatementDatabaseOptions) => SQLiteStatementDatabase<E | EffectInputCallbackError, R>;
+/**
+ * Build a persistence driver from a simple SQL statement database.
+ *
+ * The driver creates the table if needed, stores snapshots by namespace/key,
+ * and quotes table names defensively.
+ */
+export declare const makeSQLiteStatementPersistenceDriver: <E = never, R = never>(database: SQLiteStatementDatabase<E, R>) => SQLitePersistenceDriver<E | EffectInputCallbackError | SQLitePersistenceInvalidRow, R>;
+/**
+ * Create `CollectionPersistenceStorage` backed by SQLite.
+ *
+ * Schema-version mismatches read as `null`, letting callers fall back to a
+ * fresh load. Database errors and services flow through the returned storage
+ * error and requirement channels.
+ *
+ * @example
+ * const storage = makeSQLitePersistenceStorage(
+ *   makeSQLiteStatementPersistenceDriver(database)
+ * )
+ */
+export declare const makeSQLitePersistenceStorage: <E = never, R = never>(driver: SQLitePersistenceDriver<E, R>, options?: SQLitePersistenceOptions) => CollectionPersistenceStorage<E | EffectInputCallbackError | SQLitePersistenceInvalidRow | SQLitePersistenceInvalidTableName, R>;
+/**
+ * SQLite persistence namespace for collection snapshot storage helpers.
+ */
+export declare namespace SQLitePersistence {
+    /** Namespaced row key for one persisted collection snapshot. */
+    type Key = SQLitePersistenceKey;
+    /** Persisted SQLite row shape used by the collection persistence driver. */
+    type Row = SQLitePersistenceRow;
+    /** Effect-aware table Adapter for persistence rows. */
+    type Table<E = never, R = never> = SQLitePersistenceTable<E, R>;
+    /** Adapter that resolves named persistence tables. */
+    type Driver<E = never, R = never> = SQLitePersistenceDriver<E, R>;
+    /** SQL statement recorded by the in-memory statement database. */
+    type MemoryStatement = SQLiteMemoryStatement;
+    /** In-memory statement database for tests and demos. */
+    type MemoryStatementDatabase = SQLiteMemoryStatementDatabase;
+    /** Prepared statement shape for SQLite clients with `run` and `all`. */
+    type PreparedStatement<Row extends SQLiteStatementRow = SQLiteStatementRow, E = never, R = never> = SQLitePreparedStatement<Row, E, R>;
+    /** SQLite client shape for adapters that expose `prepare`. */
+    type PreparedStatementDatabase<Row extends SQLiteStatementRow = SQLiteStatementRow, E = never, R = never> = SQLitePreparedStatementDatabase<Row, E, R>;
+    /** Options for prepared-statement database adaptation. */
+    type PreparedStatementDatabaseOptions = SQLitePreparedStatementDatabaseOptions;
+    /** SQLite statement parameter value supported by generated SQL. */
+    type StatementValue = SQLiteStatementValue;
+    /** Positional SQLite statement parameter list. */
+    type StatementParams = SQLiteStatementParams;
+    /** Row shape returned by generated SELECT statements. */
+    type StatementRow = SQLiteStatementRow;
+    /** Minimal SQL statement database used by the persistence driver. */
+    type StatementDatabase<E = never, R = never> = SQLiteStatementDatabase<E, R>;
+    /** Options for collection persistence stored in SQLite. */
+    type Options = SQLitePersistenceOptions;
+    /** Create `CollectionPersistenceStorage` backed by SQLite. */
+    const storage: <E = never, R = never>(driver: SQLitePersistenceDriver<E, R>, options?: SQLitePersistenceOptions) => CollectionPersistenceStorage<E | EffectInputCallbackError | SQLitePersistenceInvalidRow | SQLitePersistenceInvalidTableName, R>;
+    /** Adapt a `prepare`/`run`/`all` SQLite client to a statement database. */
+    const preparedStatementDatabase: <Row extends SQLiteStatementRow = SQLiteStatementRow, E = never, R = never>(database: SQLitePreparedStatementDatabase<Row, E, R>, options?: SQLitePreparedStatementDatabaseOptions) => SQLiteStatementDatabase<E | EffectInputCallbackError, R>;
+    /** Build a persistence driver from a simple SQL statement database. */
+    const statementDriver: <E = never, R = never>(database: SQLiteStatementDatabase<E, R>) => SQLitePersistenceDriver<E | EffectInputCallbackError | SQLitePersistenceInvalidRow, R>;
+    /** Create an in-memory statement database for tests and demos. */
+    const memoryStatementDatabase: () => SQLiteMemoryStatementDatabase;
+}
+export {};
+//# sourceMappingURL=sqlite-persistence.d.ts.map

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

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