@tearleads/client-sdk 0.0.0-stage → 0.1.11

package/client/database.js

@@ -0,0 +1,77 @@
+import { createExecSql, } from "../data/sqlite/sqlSchema.js";
+import { createListenerSet } from "./listenerSet.js";
+export class Database {
+    listeners = createListenerSet();
+    snapshotValue = {
+        client: null,
+        execSql: null,
+        id: null,
+        status: "idle",
+    };
+    constructor(options) {
+        if (options) {
+            this.configure(options);
+        }
+    }
+    get client() {
+        return this.snapshotValue.client;
+    }
+    get execSql() {
+        return this.snapshotValue.execSql;
+    }
+    get id() {
+        return this.snapshotValue.id;
+    }
+    get snapshot() {
+        return this.snapshotValue;
+    }
+    get status() {
+        return this.snapshotValue.status;
+    }
+    clear(status = "idle") {
+        this.setSnapshot({
+            client: null,
+            execSql: null,
+            id: null,
+            status,
+        });
+    }
+    configure(options) {
+        const client = options.client ?? null;
+        const execSql = options.execSql ?? (client ? createExecSql(client) : null);
+        if (options.status === "ready" && !execSql) {
+            throw new Error("A ready SQLite database requires a configured executor or client.");
+        }
+        this.setSnapshot({
+            client,
+            execSql,
+            id: options.id ?? null,
+            status: options.status ?? (execSql ? "ready" : "idle"),
+        });
+    }
+    requireExecSql(operation = "This operation") {
+        if (!this.snapshotValue.execSql) {
+            throw new Error(`${operation} requires a configured SQLite executor.`);
+        }
+        return this.snapshotValue.execSql;
+    }
+    setClient(client, options = {}) {
+        this.configure({ ...options, client });
+    }
+    setExecSql(execSql, options = {}) {
+        this.configure({ ...options, execSql });
+    }
+    subscribe = (listener) => this.listeners.subscribe(listener);
+    setSnapshot(next) {
+        const previous = this.snapshotValue;
+        if (previous.client === next.client &&
+            previous.execSql === next.execSql &&
+            previous.id === next.id &&
+            previous.status === next.status) {
+            return;
+        }
+        this.snapshotValue = next;
+        this.listeners.notify();
+    }
+}
+//# sourceMappingURL=database.js.map

package/client/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["database.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createExecSql,\n  type ExecSql,\n  type ExecSqlClientLike,\n} from \"../data/sqlite/sqlSchema\";\nimport { createListenerSet } from \"./listenerSet\";\n\nexport type DatabaseStatus = \"idle\" | \"ready\" | \"error\" | \"terminated\";\n\nexport interface DatabaseSnapshot {\n  client: ExecSqlClientLike | null;\n  execSql: ExecSql | null;\n  id: string | null;\n  status: DatabaseStatus;\n}\n\nexport type DatabaseListener = () => void;\n\nexport interface DatabaseOptions {\n  client?: ExecSqlClientLike | null | undefined;\n  execSql?: ExecSql | null | undefined;\n  id?: string | null | undefined;\n  status?: DatabaseStatus | undefined;\n}\n\nexport class Database {\n  private readonly listeners = createListenerSet();\n  private snapshotValue: DatabaseSnapshot = {\n    client: null,\n    execSql: null,\n    id: null,\n    status: \"idle\",\n  };\n\n  constructor(options?: DatabaseOptions | undefined) {\n    if (options) {\n      this.configure(options);\n    }\n  }\n\n  get client(): ExecSqlClientLike | null {\n    return this.snapshotValue.client;\n  }\n\n  get execSql(): ExecSql | null {\n    return this.snapshotValue.execSql;\n  }\n\n  get id(): string | null {\n    return this.snapshotValue.id;\n  }\n\n  get snapshot(): DatabaseSnapshot {\n    return this.snapshotValue;\n  }\n\n  get status(): DatabaseStatus {\n    return this.snapshotValue.status;\n  }\n\n  clear(status: DatabaseStatus = \"idle\"): void {\n    this.setSnapshot({\n      client: null,\n      execSql: null,\n      id: null,\n      status,\n    });\n  }\n\n  configure(options: DatabaseOptions): void {\n    const client = options.client ?? null;\n    const execSql = options.execSql ?? (client ? createExecSql(client) : null);\n    if (options.status === \"ready\" && !execSql) {\n      throw new Error(\n        \"A ready SQLite database requires a configured executor or client.\",\n      );\n    }\n\n    this.setSnapshot({\n      client,\n      execSql,\n      id: options.id ?? null,\n      status: options.status ?? (execSql ? \"ready\" : \"idle\"),\n    });\n  }\n\n  requireExecSql(operation = \"This operation\"): ExecSql {\n    if (!this.snapshotValue.execSql) {\n      throw new Error(`${operation} requires a configured SQLite executor.`);\n    }\n\n    return this.snapshotValue.execSql;\n  }\n\n  setClient(\n    client: ExecSqlClientLike,\n    options: Omit<DatabaseOptions, \"client\" | \"execSql\"> = {},\n  ): void {\n    this.configure({ ...options, client });\n  }\n\n  setExecSql(\n    execSql: ExecSql,\n    options: Omit<DatabaseOptions, \"client\" | \"execSql\"> = {},\n  ): void {\n    this.configure({ ...options, execSql });\n  }\n\n  subscribe = (listener: DatabaseListener): (() => void) =>\n    this.listeners.subscribe(listener);\n\n  private setSnapshot(next: DatabaseSnapshot): void {\n    const previous = this.snapshotValue;\n    if (\n      previous.client === next.client &&\n      previous.execSql === next.execSql &&\n      previous.id === next.id &&\n      previous.status === next.status\n    ) {\n      return;\n    }\n\n    this.snapshotValue = next;\n    this.listeners.notify();\n  }\n}\n"]}

package/client/deviceFirst.d.ts

@@ -0,0 +1,33 @@
+import { type ContainerContentsStore, type ContainerContentsStoreOptions } from "../stores/container-contents/index.js";
+import { type LocalProjectionView } from "../stores/local-projection/index.js";
+import { type ReconciliationService } from "../sync/reconciliation/index.js";
+import { type ContainerContentsStoreWorkflowRuntime } from "../workflows/container-contents/runtime.js";
+import type { ContainerContents } from "./containerContents.js";
+import type { InternalRuntime } from "./workflowRuntime.js";
+export type { LocalProjectionView } from "../stores/local-projection/index.js";
+/** One domain scope's local read, local-write, and reconciliation handles. */
+export interface DeviceFirstContainerContents {
+    /**
+     * Locally durable container tree and mutation store. Ordinary tree writes
+     * update this store after local persistence and queue remote convergence in
+     * the background; security-sensitive remote operations keep their explicit
+     * online requirements.
+     */
+    readonly containerStore: ContainerContentsStore;
+    /** Background remote reconciliation; never awaited for first paint. */
+    readonly reconciler: ReconciliationService;
+    /** Synchronously readable container/document projection. */
+    readonly view: LocalProjectionView;
+}
+/**
+ * Device-first facade. Opens a shared scope that pairs immediate local reads
+ * and locally durable writes with background remote convergence.
+ */
+export interface DeviceFirst {
+    /** Open all device-first handles for the current domain scope. */
+    open(options?: ContainerContentsStoreOptions | undefined): DeviceFirstContainerContents;
+    /** Stop the current scope's reconciler (if one was created) on teardown. */
+    dispose(): void;
+}
+export declare function createDeviceFirst(runtimeService: InternalRuntime, containerContents: ContainerContents): DeviceFirst;
+export declare function createDeviceFirstWorkflowRuntime(runtimeService: InternalRuntime): ContainerContentsStoreWorkflowRuntime;

package/client/deviceFirst.js

@@ -0,0 +1,204 @@
+import { disposeDomainSyncCoordinator, isDatabaseUnavailableError, } from "../data/sync/syncCoordinator.js";
+import { isAutomaticRootCatchupContainerNode, isReconcilableContainerNode, isRemoteBackedContainerNode, } from "../stores/container-contents/index.js";
+import { openDocumentStore } from "../stores/documents/index.js";
+import { requestRegisteredDocumentRemoteSync, subscribeToPersistedDocumentDeletions, subscribeToPersistedDocuments, } from "../stores/documents/registry.js";
+import { getOrCreateLocalProjectionStore, } from "../stores/local-projection/index.js";
+import { connectReconciliationTriggers, createReconciliationService, } from "../sync/reconciliation/index.js";
+import { createReconciledDocumentContentPuller } from "../sync/reconciliation/documentContentPull.js";
+import { listAllContainerDocumentIdsFromApi } from "../workflows/container-contents/containerDocumentListing.js";
+import { probeUndiscoveredRemoteDocumentBatch } from "../workflows/container-contents/documentHydrationProbe.js";
+import { createContainerContentsDocumentsRuntime, createContainerContentsStoreWorkflowRuntime, } from "../workflows/container-contents/runtime.js";
+import { discoverContainerDocumentsForRuntime } from "./containerDocumentDiscovery.js";
+export function createDeviceFirst(runtimeService, containerContents) {
+    return new DeviceFirstService(runtimeService, containerContents);
+}
+function createInitialDocumentProbeHost(runtimeService, domainScope) {
+    return {
+        listContainerDocumentIds: (containerId) => {
+            const runtime = createDeviceFirstWorkflowRuntime(runtimeService);
+            return listAllContainerDocumentIdsFromApi({
+                apiClient: runtime.apiClient,
+                containerId,
+                reportErrors: false,
+            });
+        },
+        probeUndiscoveredDocumentsBatch: async (input) => {
+            const runtime = createDeviceFirstWorkflowRuntime(runtimeService);
+            return probeUndiscoveredRemoteDocumentBatch({
+                ...input,
+                host: {
+                    documentWorkflowRuntime: (containerId) => createContainerContentsDocumentsRuntime(runtime, containerId),
+                    openDocumentStore: (target) => openDocumentStore(domainScope, target.localId, target.runtime, target.documentId),
+                },
+                runtime,
+            });
+        },
+        reportInitialDocumentProbeComplete: (requestedCount) => {
+            runtimeService
+                .workflowInput()
+                .util.log(`Initial document hydration probe requested ${requestedCount} syncs`);
+        },
+    };
+}
+class DeviceFirstService {
+    runtimeService;
+    containerContents;
+    // A real Map (not WeakMap) so dispose() can iterate every scope seen this
+    // session. A running reconciler holds event subscriptions that keep an idle,
+    // stale-scope service (and its scope) reachable anyway, so WeakMap bought no
+    // GC here; the entries are released explicitly on dispose().
+    entriesByScope = new Map();
+    constructor(runtimeService, containerContents) {
+        this.runtimeService = runtimeService;
+        this.containerContents = containerContents;
+    }
+    open(options) {
+        return this.getOrCreateEntry(options).contents;
+    }
+    dispose() {
+        // Stop every reconciler created this session — not just the current
+        // scope's. A scope change (e.g. anonymous -> authenticated) leaves the old
+        // scope's reconciler subscribed and its coordinator pump live; tear them
+        // all down. Force-stop each scope's coordinator (which runs the reconciler
+        // lane) alongside stopping the service.
+        for (const [domainScope, entry] of this.entriesByScope) {
+            entry.contents.reconciler.stop();
+            entry.disconnectReconciliationTriggers();
+            entry.unsubscribePersistedDocumentDeletions();
+            entry.unsubscribePersistedDocuments();
+            disposeDomainSyncCoordinator(domainScope);
+        }
+        this.entriesByScope.clear();
+    }
+    workflowRuntime() {
+        return createDeviceFirstWorkflowRuntime(this.runtimeService);
+    }
+    getOrCreateEntry(options) {
+        const runtime = this.workflowRuntime();
+        const domainScope = runtime.state.domainScope;
+        const existing = this.entriesByScope.get(domainScope);
+        if (existing) {
+            // Do not call updateRuntime here: facade selectors run during React
+            // render, and updateRuntime emits synchronously. Hosts drive runtime
+            // updates through view.updateRuntime() from an effect instead.
+            return existing;
+        }
+        const store = getOrCreateLocalProjectionStore({
+            domainScope,
+            runtime,
+            options,
+        });
+        const service = createReconciliationService(this.createReconciliationHost(store, domainScope));
+        const disconnectReconciliationTriggers = connectReconciliationTriggers({
+            service,
+            store,
+        });
+        const unsubscribePersistedDocumentDeletions = subscribeToPersistedDocumentDeletions(domainScope, (localId) => {
+            store.removePersistedDocument(localId);
+        });
+        const unsubscribePersistedDocuments = subscribeToPersistedDocuments(domainScope, (document, change) => store.refreshPersistedDocument(document, change.placementChanged));
+        service.start();
+        const view = {
+            getSnapshot: () => store.getSnapshot(),
+            subscribe: (listener) => store.subscribe(listener),
+            setActiveContainer: (containerId) => store.setActiveContainer(containerId),
+            updateRuntime: (nextRuntime) => store.updateRuntime(nextRuntime),
+        };
+        const entry = {
+            contents: {
+                containerStore: store.getContainerStore(),
+                reconciler: service,
+                view,
+            },
+            disconnectReconciliationTriggers,
+            unsubscribePersistedDocumentDeletions,
+            unsubscribePersistedDocuments,
+        };
+        this.entriesByScope.set(domainScope, entry);
+        return entry;
+    }
+    createReconciliationHost(store, domainScope) {
+        const runtimeService = this.runtimeService;
+        const containerContents = this.containerContents;
+        const requestDocumentContentPull = createReconciledDocumentContentPuller({
+            getContainer: (containerId) => store
+                .getSnapshot()
+                .containers.find((container) => container.id === containerId) ?? null,
+            pullDocumentContent: (input) => containerContents.pullDocumentContent(input),
+            requestRegisteredDocumentRemoteSync: (localId, documentId) => requestRegisteredDocumentRemoteSync(domainScope, localId, documentId),
+        });
+        const canDiscoverContainerDocuments = (containerId) => {
+            const container = store
+                .getSnapshot()
+                .containers.find((node) => node.id === containerId);
+            return container ? isRemoteBackedContainerNode(container) : false;
+        };
+        const listKnownContainerIds = () => {
+            // A local-first id is not listable yet and may still be racing its create
+            // request. Once remote-backed, it participates normally; system contents
+            // are especially important during rematerialization because this device
+            // may not have authored them.
+            const homeOrganizationId = runtimeService.workflowInput().auth.organizationId;
+            return store
+                .getSnapshot()
+                .containers.flatMap((node) => isReconcilableContainerNode(node, homeOrganizationId)
+                ? [node.id]
+                : []);
+        };
+        const listAutomaticRootCatchupContainerIds = () => {
+            const homeOrganizationId = runtimeService.workflowInput().auth.organizationId;
+            return store
+                .getSnapshot()
+                .containers.flatMap((node) => isAutomaticRootCatchupContainerNode(node, homeOrganizationId)
+                ? [node.id]
+                : []);
+        };
+        return {
+            domainScope,
+            canDiscoverContainerDocuments,
+            getRuntimeStatus: () => {
+                const input = runtimeService.workflowInput();
+                return {
+                    dbStatus: input.infra.dbStatus,
+                    isAuthenticated: input.auth.isAuthenticated,
+                    online: input.state.online,
+                };
+            },
+            listKnownContainerIds,
+            // Root discovery can surface directly granted non-root containers, so
+            // retain every regular container. Exclude only this identity's own system
+            // children; cold/auth backfill and explicit full Refresh cover those.
+            listAutomaticRootCatchupContainerIds,
+            discoverContainerDocuments: (containerId, onFullListing, onPendingDiscovery) => discoverContainerDocumentsForRuntime({
+                containerId,
+                onFullListing,
+                onPendingDiscovery,
+                runtimeService,
+            }),
+            loadContainerDelta: (containerId) => store.loadContainerDelta(containerId),
+            applyReconciled: (delta) => store.applyReconciled(delta),
+            requestDocumentContentPull,
+            ...createInitialDocumentProbeHost(runtimeService, domainScope),
+            refreshTree: async () => {
+                await store.getContainerStore().refresh();
+            },
+            refreshRootTree: async () => {
+                await store.getContainerStore().refreshRootLane();
+            },
+            isIgnorableError: isDatabaseUnavailableError,
+            // Resolve the runtime per call: it is rebuilt as the active identity
+            // changes, and a reference captured here would report into a dead host.
+            logError: (message, error) => logReconciliationFailure(this.workflowRuntime(), message, error),
+        };
+    }
+}
+// Returns the host's result: both callbacks are declared `=> void` but may be
+// async, and the lane reporter only catches a rejection it is handed.
+function logReconciliationFailure(runtime, message, error) {
+    const { log, logError } = runtime.util;
+    return logError ? logError(message, error) : log(message);
+}
+export function createDeviceFirstWorkflowRuntime(runtimeService) {
+    return createContainerContentsStoreWorkflowRuntime(runtimeService.workflowInput(), runtimeService.adoptRootContainer);
+}
+//# sourceMappingURL=deviceFirst.js.map

package/client/deviceFirst.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceFirst.js","sourceRoot":"","sources":["deviceFirst.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DomainScope } from \"../data/domainScope\";\nimport {\n  disposeDomainSyncCoordinator,\n  isDatabaseUnavailableError,\n} from \"../data/sync/syncCoordinator\";\nimport {\n  type ContainerContentsStore,\n  type ContainerContentsStoreOptions,\n  isAutomaticRootCatchupContainerNode,\n  isReconcilableContainerNode,\n  isRemoteBackedContainerNode,\n} from \"../stores/container-contents\";\nimport { openDocumentStore } from \"../stores/documents\";\nimport {\n  requestRegisteredDocumentRemoteSync,\n  subscribeToPersistedDocumentDeletions,\n  subscribeToPersistedDocuments,\n} from \"../stores/documents/registry\";\nimport {\n  getOrCreateLocalProjectionStore,\n  type LocalProjectionStore,\n  type LocalProjectionView,\n} from \"../stores/local-projection\";\nimport {\n  connectReconciliationTriggers,\n  createReconciliationService,\n  type ReconciliationHost,\n  type ReconciliationService,\n} from \"../sync/reconciliation\";\nimport { createReconciledDocumentContentPuller } from \"../sync/reconciliation/documentContentPull\";\nimport { listAllContainerDocumentIdsFromApi } from \"../workflows/container-contents/containerDocumentListing\";\nimport { probeUndiscoveredRemoteDocumentBatch } from \"../workflows/container-contents/documentHydrationProbe\";\nimport {\n  type ContainerContentsStoreWorkflowRuntime,\n  createContainerContentsDocumentsRuntime,\n  createContainerContentsStoreWorkflowRuntime,\n} from \"../workflows/container-contents/runtime\";\nimport type { ContainerContents } from \"./containerContents\";\nimport { discoverContainerDocumentsForRuntime } from \"./containerDocumentDiscovery\";\nimport type { InternalRuntime } from \"./workflowRuntime\";\n\nexport type { LocalProjectionView } from \"../stores/local-projection\";\n\n/** One domain scope's local read, local-write, and reconciliation handles. */\nexport interface DeviceFirstContainerContents {\n  /**\n   * Locally durable container tree and mutation store. Ordinary tree writes\n   * update this store after local persistence and queue remote convergence in\n   * the background; security-sensitive remote operations keep their explicit\n   * online requirements.\n   */\n  readonly containerStore: ContainerContentsStore;\n  /** Background remote reconciliation; never awaited for first paint. */\n  readonly reconciler: ReconciliationService;\n  /** Synchronously readable container/document projection. */\n  readonly view: LocalProjectionView;\n}\n\n/**\n * Device-first facade. Opens a shared scope that pairs immediate local reads\n * and locally durable writes with background remote convergence.\n */\nexport interface DeviceFirst {\n  /** Open all device-first handles for the current domain scope. */\n  open(\n    options?: ContainerContentsStoreOptions | undefined,\n  ): DeviceFirstContainerContents;\n  /** Stop the current scope's reconciler (if one was created) on teardown. */\n  dispose(): void;\n}\n\nexport function createDeviceFirst(\n  runtimeService: InternalRuntime,\n  containerContents: ContainerContents,\n): DeviceFirst {\n  return new DeviceFirstService(runtimeService, containerContents);\n}\n\ninterface DeviceFirstScopeEntry {\n  contents: DeviceFirstContainerContents;\n  disconnectReconciliationTriggers: () => void;\n  unsubscribePersistedDocumentDeletions: () => void;\n  unsubscribePersistedDocuments: () => void;\n}\n\nfunction createInitialDocumentProbeHost(\n  runtimeService: InternalRuntime,\n  domainScope: ReconciliationHost[\"domainScope\"],\n): Pick<\n  ReconciliationHost,\n  | \"listContainerDocumentIds\"\n  | \"probeUndiscoveredDocumentsBatch\"\n  | \"reportInitialDocumentProbeComplete\"\n> {\n  return {\n    listContainerDocumentIds: (containerId) => {\n      const runtime = createDeviceFirstWorkflowRuntime(runtimeService);\n      return listAllContainerDocumentIdsFromApi({\n        apiClient: runtime.apiClient,\n        containerId,\n        reportErrors: false,\n      });\n    },\n    probeUndiscoveredDocumentsBatch: async (input) => {\n      const runtime = createDeviceFirstWorkflowRuntime(runtimeService);\n      return probeUndiscoveredRemoteDocumentBatch({\n        ...input,\n        host: {\n          documentWorkflowRuntime: (containerId) =>\n            createContainerContentsDocumentsRuntime(runtime, containerId),\n          openDocumentStore: (target) =>\n            openDocumentStore(\n              domainScope,\n              target.localId,\n              target.runtime,\n              target.documentId,\n            ),\n        },\n        runtime,\n      });\n    },\n    reportInitialDocumentProbeComplete: (requestedCount) => {\n      runtimeService\n        .workflowInput()\n        .util.log(\n          `Initial document hydration probe requested ${requestedCount} syncs`,\n        );\n    },\n  };\n}\n\nclass DeviceFirstService implements DeviceFirst {\n  // A real Map (not WeakMap) so dispose() can iterate every scope seen this\n  // session. A running reconciler holds event subscriptions that keep an idle,\n  // stale-scope service (and its scope) reachable anyway, so WeakMap bought no\n  // GC here; the entries are released explicitly on dispose().\n  private readonly entriesByScope = new Map<\n    DomainScope,\n    DeviceFirstScopeEntry\n  >();\n\n  constructor(\n    private readonly runtimeService: InternalRuntime,\n    private readonly containerContents: ContainerContents,\n  ) {}\n\n  open(\n    options?: ContainerContentsStoreOptions | undefined,\n  ): DeviceFirstContainerContents {\n    return this.getOrCreateEntry(options).contents;\n  }\n\n  dispose(): void {\n    // Stop every reconciler created this session — not just the current\n    // scope's. A scope change (e.g. anonymous -> authenticated) leaves the old\n    // scope's reconciler subscribed and its coordinator pump live; tear them\n    // all down. Force-stop each scope's coordinator (which runs the reconciler\n    // lane) alongside stopping the service.\n    for (const [domainScope, entry] of this.entriesByScope) {\n      entry.contents.reconciler.stop();\n      entry.disconnectReconciliationTriggers();\n      entry.unsubscribePersistedDocumentDeletions();\n      entry.unsubscribePersistedDocuments();\n      disposeDomainSyncCoordinator(domainScope);\n    }\n    this.entriesByScope.clear();\n  }\n\n  private workflowRuntime(): ContainerContentsStoreWorkflowRuntime {\n    return createDeviceFirstWorkflowRuntime(this.runtimeService);\n  }\n\n  private getOrCreateEntry(\n    options?: ContainerContentsStoreOptions | undefined,\n  ): DeviceFirstScopeEntry {\n    const runtime = this.workflowRuntime();\n    const domainScope = runtime.state.domainScope;\n    const existing = this.entriesByScope.get(domainScope);\n    if (existing) {\n      // Do not call updateRuntime here: facade selectors run during React\n      // render, and updateRuntime emits synchronously. Hosts drive runtime\n      // updates through view.updateRuntime() from an effect instead.\n      return existing;\n    }\n\n    const store = getOrCreateLocalProjectionStore({\n      domainScope,\n      runtime,\n      options,\n    });\n    const service = createReconciliationService(\n      this.createReconciliationHost(store, domainScope),\n    );\n    const disconnectReconciliationTriggers = connectReconciliationTriggers({\n      service,\n      store,\n    });\n    const unsubscribePersistedDocumentDeletions =\n      subscribeToPersistedDocumentDeletions(domainScope, (localId) => {\n        store.removePersistedDocument(localId);\n      });\n    const unsubscribePersistedDocuments = subscribeToPersistedDocuments(\n      domainScope,\n      (document, change) =>\n        store.refreshPersistedDocument(document, change.placementChanged),\n    );\n    service.start();\n\n    const view: LocalProjectionView = {\n      getSnapshot: () => store.getSnapshot(),\n      subscribe: (listener) => store.subscribe(listener),\n      setActiveContainer: (containerId) =>\n        store.setActiveContainer(containerId),\n      updateRuntime: (nextRuntime) => store.updateRuntime(nextRuntime),\n    };\n\n    const entry: DeviceFirstScopeEntry = {\n      contents: {\n        containerStore: store.getContainerStore(),\n        reconciler: service,\n        view,\n      },\n      disconnectReconciliationTriggers,\n      unsubscribePersistedDocumentDeletions,\n      unsubscribePersistedDocuments,\n    };\n    this.entriesByScope.set(domainScope, entry);\n    return entry;\n  }\n\n  private createReconciliationHost(\n    store: LocalProjectionStore,\n    domainScope: ReconciliationHost[\"domainScope\"],\n  ): ReconciliationHost {\n    const runtimeService = this.runtimeService;\n    const containerContents = this.containerContents;\n    const requestDocumentContentPull = createReconciledDocumentContentPuller({\n      getContainer: (containerId) =>\n        store\n          .getSnapshot()\n          .containers.find((container) => container.id === containerId) ?? null,\n      pullDocumentContent: (input) =>\n        containerContents.pullDocumentContent(input),\n      requestRegisteredDocumentRemoteSync: (localId, documentId) =>\n        requestRegisteredDocumentRemoteSync(domainScope, localId, documentId),\n    });\n    const canDiscoverContainerDocuments = (containerId: string) => {\n      const container = store\n        .getSnapshot()\n        .containers.find((node) => node.id === containerId);\n      return container ? isRemoteBackedContainerNode(container) : false;\n    };\n    const listKnownContainerIds = () => {\n      // A local-first id is not listable yet and may still be racing its create\n      // request. Once remote-backed, it participates normally; system contents\n      // are especially important during rematerialization because this device\n      // may not have authored them.\n      const homeOrganizationId =\n        runtimeService.workflowInput().auth.organizationId;\n      return store\n        .getSnapshot()\n        .containers.flatMap((node) =>\n          isReconcilableContainerNode(node, homeOrganizationId)\n            ? [node.id]\n            : [],\n        );\n    };\n    const listAutomaticRootCatchupContainerIds = () => {\n      const homeOrganizationId =\n        runtimeService.workflowInput().auth.organizationId;\n      return store\n        .getSnapshot()\n        .containers.flatMap((node) =>\n          isAutomaticRootCatchupContainerNode(node, homeOrganizationId)\n            ? [node.id]\n            : [],\n        );\n    };\n    return {\n      domainScope,\n      canDiscoverContainerDocuments,\n      getRuntimeStatus: () => {\n        const input = runtimeService.workflowInput();\n        return {\n          dbStatus: input.infra.dbStatus,\n          isAuthenticated: input.auth.isAuthenticated,\n          online: input.state.online,\n        };\n      },\n      listKnownContainerIds,\n      // Root discovery can surface directly granted non-root containers, so\n      // retain every regular container. Exclude only this identity's own system\n      // children; cold/auth backfill and explicit full Refresh cover those.\n      listAutomaticRootCatchupContainerIds,\n      discoverContainerDocuments: (\n        containerId,\n        onFullListing,\n        onPendingDiscovery,\n      ) =>\n        discoverContainerDocumentsForRuntime({\n          containerId,\n          onFullListing,\n          onPendingDiscovery,\n          runtimeService,\n        }),\n      loadContainerDelta: (containerId) =>\n        store.loadContainerDelta(containerId),\n      applyReconciled: (delta) => store.applyReconciled(delta),\n      requestDocumentContentPull,\n      ...createInitialDocumentProbeHost(runtimeService, domainScope),\n      refreshTree: async () => {\n        await store.getContainerStore().refresh();\n      },\n      refreshRootTree: async () => {\n        await store.getContainerStore().refreshRootLane();\n      },\n      isIgnorableError: isDatabaseUnavailableError,\n      // Resolve the runtime per call: it is rebuilt as the active identity\n      // changes, and a reference captured here would report into a dead host.\n      logError: (message, error) =>\n        logReconciliationFailure(this.workflowRuntime(), message, error),\n    };\n  }\n}\n\n// Returns the host's result: both callbacks are declared `=> void` but may be\n// async, and the lane reporter only catches a rejection it is handed.\nfunction logReconciliationFailure(\n  runtime: ContainerContentsStoreWorkflowRuntime,\n  message: string,\n  error: unknown,\n): unknown {\n  const { log, logError } = runtime.util;\n  return logError ? logError(message, error) : log(message);\n}\n\nexport function createDeviceFirstWorkflowRuntime(\n  runtimeService: InternalRuntime,\n): ContainerContentsStoreWorkflowRuntime {\n  return createContainerContentsStoreWorkflowRuntime(\n    runtimeService.workflowInput(),\n    runtimeService.adoptRootContainer,\n  );\n}\n"]}

package/client/documents.d.ts

@@ -0,0 +1,39 @@
+import type { StoredDocumentKind } from "../data/documents/documentKinds.js";
+import type { DocumentSummaryList, DocumentSummarySort, DocumentSummarySortDirection, DocumentSummarySortKey, ListDocumentSummariesInput } from "../data/persistence/documents/types.js";
+import { DEFAULT_DOCUMENT_ID as DEFAULT_LOCAL_DOCUMENT_ID, type DocumentStore, type DocumentsRuntime, type PersistedDocumentListener } from "../stores/documents/index.js";
+import type { InternalRuntime } from "./workflowRuntime.js";
+export type { DocumentAttachmentStatus, DocumentAttachmentUpload, DocumentContextValue, DocumentStore, DocumentsRuntime, PersistedDocumentListener, } from "../stores/documents/index.js";
+export type DocumentSortDirection = DocumentSummarySortDirection;
+export type DocumentSortKey = DocumentSummarySortKey;
+export type DocumentSort = DocumentSummarySort;
+export interface ListDocumentsInput extends ListDocumentSummariesInput {
+}
+export type DocumentList = DocumentSummaryList;
+export { DEFAULT_LOCAL_DOCUMENT_ID as DEFAULT_DOCUMENT_ID };
+export interface OpenDocumentInput {
+    readonly containerId?: string | null | undefined;
+    readonly documentId?: string | null | undefined;
+    readonly initialDocumentKind?: StoredDocumentKind | undefined;
+    readonly initialText?: string | undefined;
+    readonly localId?: string | undefined;
+}
+export interface OpenDocumentOptions {
+    readonly remoteSyncMode?: "on-demand" | "startup" | undefined;
+    readonly workflowRuntime?: DocumentsRuntime | undefined;
+}
+export interface DocumentSubscriptionOptions {
+    readonly containerId?: string | null | undefined;
+}
+export interface Documents {
+    delete(localId: string): Promise<boolean>;
+    findLocalIdByDocumentId(documentId: string): Promise<string | null>;
+    list(input?: ListDocumentsInput | undefined): Promise<DocumentList | null>;
+    open(input?: OpenDocumentInput | undefined, options?: OpenDocumentOptions | undefined): DocumentStore;
+    subscribe(listener: PersistedDocumentListener, options?: DocumentSubscriptionOptions | undefined): () => void;
+    workflowRuntime(containerId?: string | null | undefined): DocumentsRuntime;
+}
+interface DocumentsDependencies {
+    getDefaultContainerId: () => string | null;
+    runtime: InternalRuntime;
+}
+export declare function createDocuments(dependencies: DocumentsDependencies): Documents;

package/client/documents.js

@@ -0,0 +1,76 @@
+import { DEFAULT_DOCUMENT_KIND } from "../data/documents/documentConstants.js";
+import { DEFAULT_DOCUMENT_ID as DEFAULT_LOCAL_DOCUMENT_ID, openDocumentStore, subscribeToPersistedDocuments, } from "../stores/documents/index.js";
+import { emitPersistedDocumentDeletion } from "../stores/documents/registry.js";
+import { createDocumentsWorkflowRuntime, defaultDocumentsPersistence, deletePersistedDocument, reclaimDocumentOrphanBlobs, } from "../workflows/documents/index.js";
+export { DEFAULT_LOCAL_DOCUMENT_ID as DEFAULT_DOCUMENT_ID };
+export function createDocuments(dependencies) {
+    return new DocumentsService(dependencies);
+}
+class DocumentsService {
+    dependencies;
+    schemaEnsuresByExecSql = new WeakMap();
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+    }
+    async delete(localId) {
+        const runtime = this.workflowRuntime();
+        if (runtime.infra.dbStatus !== "ready") {
+            return false;
+        }
+        const deleted = await deletePersistedDocument({
+            documentProjectors: runtime.infra.documentProjectors,
+            execSql: runtime.infra.execSql,
+            localId,
+            persistence: defaultDocumentsPersistence,
+        });
+        if (!deleted)
+            return false;
+        void reclaimDocumentOrphanBlobs(runtime);
+        emitPersistedDocumentDeletion(runtime.state.domainScope, localId);
+        return true;
+    }
+    async findLocalIdByDocumentId(documentId) {
+        const runtime = this.dependencies.runtime.workflowInput();
+        if (runtime.infra.dbStatus !== "ready") {
+            return null;
+        }
+        await this.ensureSchema(runtime.infra.execSql);
+        return defaultDocumentsPersistence.findLocalIdByDocumentId(runtime.infra.execSql, documentId);
+    }
+    async list(input = {}) {
+        const runtime = this.dependencies.runtime.workflowInput();
+        if (runtime.infra.dbStatus !== "ready") {
+            return null;
+        }
+        await this.ensureSchema(runtime.infra.execSql);
+        return defaultDocumentsPersistence.listDocumentSummaries(runtime.infra.execSql, input);
+    }
+    workflowRuntime(containerId = this.dependencies.getDefaultContainerId()) {
+        const input = this.dependencies.runtime.workflowInput(containerId);
+        return createDocumentsWorkflowRuntime(input);
+    }
+    open(input = {}, options = {}) {
+        const { containerId, documentId = null, initialDocumentKind = DEFAULT_DOCUMENT_KIND, initialText = "", localId = DEFAULT_LOCAL_DOCUMENT_ID, } = input;
+        const runtime = options.workflowRuntime ?? this.workflowRuntime(containerId);
+        return openDocumentStore(runtime.state.domainScope, localId, runtime, documentId, initialText, initialDocumentKind, options.remoteSyncMode ?? "startup");
+    }
+    subscribe(listener, options = {}) {
+        return subscribeToPersistedDocuments(this.dependencies.runtime.workflowInput(options.containerId).state
+            .domainScope, listener);
+    }
+    ensureSchema(execSql) {
+        const existing = this.schemaEnsuresByExecSql.get(execSql);
+        if (existing) {
+            return existing;
+        }
+        const ensure = defaultDocumentsPersistence
+            .ensureSchema(execSql)
+            .catch((error) => {
+            this.schemaEnsuresByExecSql.delete(execSql);
+            throw error;
+        });
+        this.schemaEnsuresByExecSql.set(execSql, ensure);
+        return ensure;
+    }
+}
+//# sourceMappingURL=documents.js.map

package/client/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["documents.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEFAULT_DOCUMENT_KIND } from \"../data/documents/documentConstants\";\nimport type { StoredDocumentKind } from \"../data/documents/documentKinds\";\nimport type {\n  DocumentSummaryList,\n  DocumentSummarySort,\n  DocumentSummarySortDirection,\n  DocumentSummarySortKey,\n  ListDocumentSummariesInput,\n} from \"../data/persistence/documents/types\";\nimport type { ExecSql } from \"../data/sqlite/sqlSchema\";\nimport {\n  DEFAULT_DOCUMENT_ID as DEFAULT_LOCAL_DOCUMENT_ID,\n  type DocumentStore,\n  type DocumentsRuntime,\n  openDocumentStore,\n  type PersistedDocumentListener,\n  subscribeToPersistedDocuments,\n} from \"../stores/documents\";\nimport { emitPersistedDocumentDeletion } from \"../stores/documents/registry\";\nimport {\n  createDocumentsWorkflowRuntime,\n  defaultDocumentsPersistence,\n  deletePersistedDocument,\n  reclaimDocumentOrphanBlobs,\n} from \"../workflows/documents\";\nimport type { InternalRuntime } from \"./workflowRuntime\";\n\nexport type {\n  DocumentAttachmentStatus,\n  DocumentAttachmentUpload,\n  DocumentContextValue,\n  DocumentStore,\n  DocumentsRuntime,\n  PersistedDocumentListener,\n} from \"../stores/documents\";\n\nexport type DocumentSortDirection = DocumentSummarySortDirection;\nexport type DocumentSortKey = DocumentSummarySortKey;\n\nexport type DocumentSort = DocumentSummarySort;\n\nexport interface ListDocumentsInput extends ListDocumentSummariesInput {}\n\nexport type DocumentList = DocumentSummaryList;\n\nexport { DEFAULT_LOCAL_DOCUMENT_ID as DEFAULT_DOCUMENT_ID };\n\nexport interface OpenDocumentInput {\n  readonly containerId?: string | null | undefined;\n  readonly documentId?: string | null | undefined;\n  readonly initialDocumentKind?: StoredDocumentKind | undefined;\n  readonly initialText?: string | undefined;\n  readonly localId?: string | undefined;\n}\n\nexport interface OpenDocumentOptions {\n  readonly remoteSyncMode?: \"on-demand\" | \"startup\" | undefined;\n  readonly workflowRuntime?: DocumentsRuntime | undefined;\n}\n\nexport interface DocumentSubscriptionOptions {\n  readonly containerId?: string | null | undefined;\n}\n\nexport interface Documents {\n  delete(localId: string): Promise<boolean>;\n  findLocalIdByDocumentId(documentId: string): Promise<string | null>;\n  list(input?: ListDocumentsInput | undefined): Promise<DocumentList | null>;\n  open(\n    input?: OpenDocumentInput | undefined,\n    options?: OpenDocumentOptions | undefined,\n  ): DocumentStore;\n  subscribe(\n    listener: PersistedDocumentListener,\n    options?: DocumentSubscriptionOptions | undefined,\n  ): () => void;\n  workflowRuntime(containerId?: string | null | undefined): DocumentsRuntime;\n}\n\ninterface DocumentsDependencies {\n  getDefaultContainerId: () => string | null;\n  runtime: InternalRuntime;\n}\n\nexport function createDocuments(\n  dependencies: DocumentsDependencies,\n): Documents {\n  return new DocumentsService(dependencies);\n}\n\nclass DocumentsService implements Documents {\n  private readonly schemaEnsuresByExecSql = new WeakMap<\n    ExecSql,\n    Promise<void>\n  >();\n\n  constructor(private readonly dependencies: DocumentsDependencies) {}\n\n  async delete(localId: string): Promise<boolean> {\n    const runtime = this.workflowRuntime();\n    if (runtime.infra.dbStatus !== \"ready\") {\n      return false;\n    }\n\n    const deleted = await deletePersistedDocument({\n      documentProjectors: runtime.infra.documentProjectors,\n      execSql: runtime.infra.execSql,\n      localId,\n      persistence: defaultDocumentsPersistence,\n    });\n    if (!deleted) return false;\n    void reclaimDocumentOrphanBlobs(runtime);\n    emitPersistedDocumentDeletion(runtime.state.domainScope, localId);\n    return true;\n  }\n\n  async findLocalIdByDocumentId(documentId: string): Promise<string | null> {\n    const runtime = this.dependencies.runtime.workflowInput();\n    if (runtime.infra.dbStatus !== \"ready\") {\n      return null;\n    }\n\n    await this.ensureSchema(runtime.infra.execSql);\n    return defaultDocumentsPersistence.findLocalIdByDocumentId(\n      runtime.infra.execSql,\n      documentId,\n    );\n  }\n\n  async list(input: ListDocumentsInput = {}): Promise<DocumentList | null> {\n    const runtime = this.dependencies.runtime.workflowInput();\n    if (runtime.infra.dbStatus !== \"ready\") {\n      return null;\n    }\n\n    await this.ensureSchema(runtime.infra.execSql);\n    return defaultDocumentsPersistence.listDocumentSummaries(\n      runtime.infra.execSql,\n      input,\n    );\n  }\n\n  workflowRuntime(\n    containerId = this.dependencies.getDefaultContainerId(),\n  ): DocumentsRuntime {\n    const input = this.dependencies.runtime.workflowInput(containerId);\n    return createDocumentsWorkflowRuntime(input);\n  }\n\n  open(\n    input: OpenDocumentInput = {},\n    options: OpenDocumentOptions = {},\n  ): DocumentStore {\n    const {\n      containerId,\n      documentId = null,\n      initialDocumentKind = DEFAULT_DOCUMENT_KIND,\n      initialText = \"\",\n      localId = DEFAULT_LOCAL_DOCUMENT_ID,\n    } = input;\n    const runtime =\n      options.workflowRuntime ?? this.workflowRuntime(containerId);\n    return openDocumentStore(\n      runtime.state.domainScope,\n      localId,\n      runtime,\n      documentId,\n      initialText,\n      initialDocumentKind,\n      options.remoteSyncMode ?? \"startup\",\n    );\n  }\n\n  subscribe(\n    listener: PersistedDocumentListener,\n    options: DocumentSubscriptionOptions = {},\n  ): () => void {\n    return subscribeToPersistedDocuments(\n      this.dependencies.runtime.workflowInput(options.containerId).state\n        .domainScope,\n      listener,\n    );\n  }\n\n  private ensureSchema(execSql: ExecSql): Promise<void> {\n    const existing = this.schemaEnsuresByExecSql.get(execSql);\n    if (existing) {\n      return existing;\n    }\n\n    const ensure = defaultDocumentsPersistence\n      .ensureSchema(execSql)\n      .catch((error: unknown) => {\n        this.schemaEnsuresByExecSql.delete(execSql);\n        throw error;\n      });\n    this.schemaEnsuresByExecSql.set(execSql, ensure);\n    return ensure;\n  }\n}\n"]}

package/client/events.d.ts

@@ -0,0 +1,29 @@
+export interface EventsSnapshot {
+    connected: boolean;
+    events: ReadonlyArray<unknown>;
+}
+export type EventsListener = () => void;
+export declare class Events {
+    private readonly invalidateAccessCaches;
+    private connectedValue;
+    private connectionGenerationValue;
+    private readonly listeners;
+    private snapshotValue;
+    constructor(events?: ReadonlyArray<unknown>, invalidateAccessCaches?: () => void);
+    get connected(): boolean;
+    get connectionGeneration(): number;
+    get events(): ReadonlyArray<unknown>;
+    get snapshot(): EventsSnapshot;
+    clear(): void;
+    push(event: unknown): void;
+    /**
+     * Drop HTTP writer projections after an access/keying control signal or an
+     * event-stream gap. A peer re-key can make an otherwise-valid cached
+     * projection stale even when no local mutation touched the cache.
+     */
+    invalidateAccessState(): void;
+    setConnected(connected: boolean): void;
+    setEvents(events: ReadonlyArray<unknown>): void;
+    subscribe: (listener: EventsListener) => (() => void);
+    private updateSnapshot;
+}

package/client/events.js

@@ -0,0 +1,60 @@
+import { createListenerSet } from "./listenerSet.js";
+export class Events {
+    invalidateAccessCaches;
+    connectedValue = false;
+    connectionGenerationValue = 0;
+    listeners = createListenerSet();
+    snapshotValue;
+    constructor(events = [], invalidateAccessCaches = () => undefined) {
+        this.invalidateAccessCaches = invalidateAccessCaches;
+        this.snapshotValue = { connected: this.connectedValue, events };
+    }
+    get connected() {
+        return this.connectedValue;
+    }
+    get connectionGeneration() {
+        return this.connectionGenerationValue;
+    }
+    get events() {
+        return this.snapshotValue.events;
+    }
+    get snapshot() {
+        return this.snapshotValue;
+    }
+    clear() {
+        this.setEvents([]);
+    }
+    push(event) {
+        this.setEvents([...this.events, event]);
+    }
+    /**
+     * Drop HTTP writer projections after an access/keying control signal or an
+     * event-stream gap. A peer re-key can make an otherwise-valid cached
+     * projection stale even when no local mutation touched the cache.
+     */
+    invalidateAccessState() {
+        this.invalidateAccessCaches();
+    }
+    setConnected(connected) {
+        if (this.connectedValue === connected) {
+            return;
+        }
+        this.connectedValue = connected;
+        if (connected) {
+            this.connectionGenerationValue += 1;
+        }
+        this.updateSnapshot(this.events);
+    }
+    setEvents(events) {
+        if (this.events === events) {
+            return;
+        }
+        this.updateSnapshot(events);
+    }
+    subscribe = (listener) => this.listeners.subscribe(listener);
+    updateSnapshot(events) {
+        this.snapshotValue = { connected: this.connectedValue, events };
+        this.listeners.notify();
+    }
+}
+//# sourceMappingURL=events.js.map

package/client/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAQlD,MAAM,OAAO,MAAM;IAQE;IAPX,cAAc,GAAG,KAAK,CAAC;IACvB,yBAAyB,GAAG,CAAC,CAAC;IACrB,SAAS,GAAG,iBAAiB,EAAE,CAAC;IACzC,aAAa,CAAiB;IAEtC,YACE,SAAiC,EAAE,EAClB,yBAAqC,GAAG,EAAE,CAAC,SAAS;QAApD,2BAAsB,GAAtB,sBAAsB,CAA8B;QAErE,IAAI,CAAC,aAAa,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAClE,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,yBAAyB,CAAC;IACxC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,CAAC,KAAc;QACjB,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,qBAAqB;QACnB,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAChC,CAAC;IAED,YAAY,CAAC,SAAkB;QAC7B,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,yBAAyB,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,CAAC,MAA8B;QACtC,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS,GAAG,CAAC,QAAwB,EAAgB,EAAE,CACrD,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE7B,cAAc,CAAC,MAA8B;QACnD,IAAI,CAAC,aAAa,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;QAChE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;CACF","sourcesContent":["import { createListenerSet } from \"./listenerSet\";\nexport interface EventsSnapshot {\n  connected: boolean;\n  events: ReadonlyArray<unknown>;\n}\n\nexport type EventsListener = () => void;\n\nexport class Events {\n  private connectedValue = false;\n  private connectionGenerationValue = 0;\n  private readonly listeners = createListenerSet();\n  private snapshotValue: EventsSnapshot;\n\n  constructor(\n    events: ReadonlyArray<unknown> = [],\n    private readonly invalidateAccessCaches: () => void = () => undefined,\n  ) {\n    this.snapshotValue = { connected: this.connectedValue, events };\n  }\n\n  get connected(): boolean {\n    return this.connectedValue;\n  }\n\n  get connectionGeneration(): number {\n    return this.connectionGenerationValue;\n  }\n\n  get events(): ReadonlyArray<unknown> {\n    return this.snapshotValue.events;\n  }\n\n  get snapshot(): EventsSnapshot {\n    return this.snapshotValue;\n  }\n\n  clear(): void {\n    this.setEvents([]);\n  }\n\n  push(event: unknown): void {\n    this.setEvents([...this.events, event]);\n  }\n\n  /**\n   * Drop HTTP writer projections after an access/keying control signal or an\n   * event-stream gap. A peer re-key can make an otherwise-valid cached\n   * projection stale even when no local mutation touched the cache.\n   */\n  invalidateAccessState(): void {\n    this.invalidateAccessCaches();\n  }\n\n  setConnected(connected: boolean): void {\n    if (this.connectedValue === connected) {\n      return;\n    }\n\n    this.connectedValue = connected;\n    if (connected) {\n      this.connectionGenerationValue += 1;\n    }\n    this.updateSnapshot(this.events);\n  }\n\n  setEvents(events: ReadonlyArray<unknown>): void {\n    if (this.events === events) {\n      return;\n    }\n\n    this.updateSnapshot(events);\n  }\n\n  subscribe = (listener: EventsListener): (() => void) =>\n    this.listeners.subscribe(listener);\n\n  private updateSnapshot(events: ReadonlyArray<unknown>): void {\n    this.snapshotValue = { connected: this.connectedValue, events };\n    this.listeners.notify();\n  }\n}\n"]}