@tearleads/client-sdk 0.0.0-stage → 0.1.11

package/stores/documents/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DomainScope } from \"../../data/domainScope\";\nimport {\n  registerInternalDocumentRelink,\n  relinkDocumentStoreWithCommitSideEffect,\n} from \"./documentStore/internalRelink\";\nimport type {\n  DocumentAttachmentUpload,\n  DocumentStore,\n  DocumentStoreFacade,\n  DocumentsRuntime,\n  PersistedDocumentListener,\n} from \"./types\";\n\ninterface DocumentStoreRegistry {\n  storeKeysByDocumentId: Map<string, string>;\n  storeKeysByLocalId: Map<string, string>;\n  storesByKey: Map<string, DocumentStoreFacade>;\n}\n\nconst documentStoreRegistriesByScope = new WeakMap<\n  DomainScope,\n  DocumentStoreRegistry\n>();\ntype PersistedDocumentDeletionListener = (localId: string) => void;\n\n// Per-scope listener plumbing shared by the persisted-document and\n// persisted-document-deletion channels: emit fans out to the scope's\n// listeners, and unsubscribing the last listener drops the scope entry.\nfunction createScopedListenerRegistry<\n  Listener extends (...args: never[]) => void,\n>() {\n  const listenersByScope = new WeakMap<DomainScope, Set<Listener>>();\n\n  return {\n    emit: (domainScope: DomainScope, ...args: Parameters<Listener>): void => {\n      const listeners = listenersByScope.get(domainScope);\n      if (!listeners) {\n        return;\n      }\n\n      for (const listener of listeners) {\n        listener(...args);\n      }\n    },\n    subscribe: (domainScope: DomainScope, listener: Listener): (() => void) => {\n      const listeners =\n        listenersByScope.get(domainScope) ?? new Set<Listener>();\n      listeners.add(listener);\n      listenersByScope.set(domainScope, listeners);\n\n      return () => {\n        listeners.delete(listener);\n        if (listeners.size === 0) {\n          listenersByScope.delete(domainScope);\n        }\n      };\n    },\n  };\n}\n\nconst persistedDocumentListeners =\n  createScopedListenerRegistry<PersistedDocumentListener>();\nconst persistedDocumentDeletionListeners =\n  createScopedListenerRegistry<PersistedDocumentDeletionListener>();\n\nexport function getOrCreateDocumentStoreRegistry(\n  domainScope: DomainScope,\n): DocumentStoreRegistry {\n  const existingRegistry = documentStoreRegistriesByScope.get(domainScope);\n  if (existingRegistry) {\n    return existingRegistry;\n  }\n\n  const nextRegistry: DocumentStoreRegistry = {\n    storeKeysByDocumentId: new Map(),\n    storeKeysByLocalId: new Map(),\n    storesByKey: new Map(),\n  };\n  documentStoreRegistriesByScope.set(domainScope, nextRegistry);\n  return nextRegistry;\n}\n\nexport function resolveDocumentStoreKey(\n  registry: DocumentStoreRegistry,\n  localId: string,\n  documentId: string | null,\n): string {\n  return (\n    (documentId ? registry.storeKeysByDocumentId.get(documentId) : undefined) ??\n    registry.storeKeysByLocalId.get(localId) ??\n    localId\n  );\n}\n\nexport function registerDocumentStore(\n  domainScope: DomainScope,\n  localId: string,\n  store: DocumentStoreFacade,\n  documentId: string | null,\n) {\n  const registry = getOrCreateDocumentStoreRegistry(domainScope);\n  const storeKey = resolveDocumentStoreKey(registry, localId, documentId);\n  registry.storeKeysByLocalId.set(localId, storeKey);\n  if (documentId) {\n    registry.storeKeysByDocumentId.set(documentId, storeKey);\n  }\n  registry.storesByKey.set(storeKey, store);\n}\n\nexport function registerDocumentStoreIdentity(\n  domainScope: DomainScope,\n  localId: string,\n  documentId: string | null,\n) {\n  if (!documentId) {\n    return;\n  }\n\n  const registry = getOrCreateDocumentStoreRegistry(domainScope);\n  const localStoreKey = registry.storeKeysByLocalId.get(localId) ?? localId;\n  const documentStoreKey =\n    registry.storeKeysByDocumentId.get(documentId) ?? documentId;\n\n  registry.storeKeysByLocalId.set(localId, documentStoreKey);\n  registry.storeKeysByDocumentId.set(documentId, documentStoreKey);\n\n  if (documentStoreKey === localStoreKey) {\n    return;\n  }\n\n  const localStore = registry.storesByKey.get(localStoreKey);\n  const documentStore = registry.storesByKey.get(documentStoreKey);\n  if (localStore) {\n    documentStore?.rebindTo(localStore);\n    registry.storesByKey.set(documentStoreKey, localStore);\n  }\n  registry.storesByKey.delete(localStoreKey);\n}\n\nexport function requestDocumentStoreSync(state: {\n  syncLane: {\n    requestSync: () => void;\n  } | null;\n}) {\n  state.syncLane?.requestSync();\n}\n\nexport function requestRegisteredDocumentRemoteSync(\n  domainScope: DomainScope,\n  localId: string,\n  documentId: string | null,\n): boolean {\n  const registry = documentStoreRegistriesByScope.get(domainScope);\n  if (!registry) {\n    return false;\n  }\n\n  const store = registry.storesByKey.get(\n    resolveDocumentStoreKey(registry, localId, documentId),\n  );\n  if (!store) {\n    return false;\n  }\n\n  // Explicit refresh uses this path to recover missed websocket invalidations\n  // without instantiating every unopened document discovered in the container.\n  store.requestRemoteSync();\n  return true;\n}\n\n/**\n * Discard a registered document's local edits through its store, so the\n * teardown serializes on the store's write machinery instead of racing an\n * in-flight persist that would resurrect the deleted rows. Only registered\n * stores qualify — an unregistered document has no lane submitting its queue,\n * so there is nothing this escape hatch could unstick. No deletion is\n * emitted: the document survives as a re-seeded shell that keeps its listing\n * entry, and the re-pull's own persist announces the restored content.\n *\n * Resolution is strict, unlike the read-side lookups: a destructive action\n * must never run against whichever store won a lookup priority. Both\n * identifiers must map to the SAME registered store — an unknown or stale\n * documentId refuses rather than trusting the localId alone — and the store\n * revalidates the expected documentId against its persisted record inside\n * the teardown's serialized mutation, so even a stale registry mapping\n * cannot discard a different identity's edits.\n */\nexport async function discardRegisteredDocumentLocalState(\n  domainScope: DomainScope,\n  localId: string,\n  documentId: string,\n): Promise<boolean> {\n  const registry = documentStoreRegistriesByScope.get(domainScope);\n  if (!registry) {\n    return false;\n  }\n\n  const localStoreKey = registry.storeKeysByLocalId.get(localId);\n  const documentStoreKey = registry.storeKeysByDocumentId.get(documentId);\n  if (\n    !localStoreKey ||\n    !documentStoreKey ||\n    documentStoreKey !== localStoreKey\n  ) {\n    return false;\n  }\n  const store = registry.storesByKey.get(localStoreKey);\n  if (!store) {\n    return false;\n  }\n\n  return store.discardLocalState(documentId);\n}\n\nexport function createDocumentStoreFacade(\n  initialStore: DocumentStore,\n): DocumentStoreFacade {\n  let targetStore = initialStore;\n  const listeners = new Set<() => void>();\n\n  const emitFacade = () => {\n    for (const listener of listeners) {\n      listener();\n    }\n  };\n\n  let unsubscribeTarget = targetStore.subscribe(() => {\n    emitFacade();\n  });\n\n  const connectTarget = (nextStore: DocumentStore) => {\n    if (targetStore === nextStore) {\n      return;\n    }\n\n    unsubscribeTarget();\n    targetStore = nextStore;\n    unsubscribeTarget = targetStore.subscribe(() => {\n      emitFacade();\n    });\n    emitFacade();\n  };\n\n  const facade: DocumentStoreFacade = {\n    addRow: (fields) => targetStore.addRow(fields),\n    assertCanRotateContentKey: () => targetStore.assertCanRotateContentKey(),\n    attachFiles: (files: ReadonlyArray<DocumentAttachmentUpload>) =>\n      targetStore.attachFiles(files),\n    discardLocalState: (expectedDocumentId: string) =>\n      targetStore.discardLocalState(expectedDocumentId),\n    ensureInitialized: () => targetStore.ensureInitialized(),\n    getSnapshot: () => targetStore.getSnapshot(),\n    removeAttachment: (slotId: string) => targetStore.removeAttachment(slotId),\n    removeRow: (id) => targetStore.removeRow(id),\n    replaceAttachment: (slotId: string, file: DocumentAttachmentUpload) =>\n      targetStore.replaceAttachment(slotId, file),\n    requestRemoteSync: () => targetStore.requestRemoteSync(),\n    requestRemoteSyncAndWait: (signal) =>\n      targetStore.requestRemoteSyncAndWait(signal),\n    requestSync: () => targetStore.requestSync(),\n    relink: (input) => targetStore.relink(input),\n    rebindTo: (store) => connectTarget(store),\n    setStructuredFields: (kind, patch, options) =>\n      targetStore.setStructuredFields(kind, patch, options),\n    setText: (value: string) => targetStore.setText(value),\n    subscribe: (listener: () => void) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    updateRowFields: (id, patch) => targetStore.updateRowFields(id, patch),\n    updateRuntime: (runtime: DocumentsRuntime) =>\n      targetStore.updateRuntime(runtime),\n  };\n  registerInternalDocumentRelink(facade, (input, commitSideEffect) =>\n    relinkDocumentStoreWithCommitSideEffect(\n      targetStore,\n      input,\n      commitSideEffect,\n    ),\n  );\n  return facade;\n}\n\nexport function emitPersistedDocument(\n  domainScope: DomainScope,\n  persistedDocument: Parameters<PersistedDocumentListener>[0],\n  placementChanged = false,\n): void {\n  persistedDocumentListeners.emit(domainScope, persistedDocument, {\n    placementChanged,\n  });\n}\n\nexport function subscribeToPersistedDocuments(\n  domainScope: DomainScope,\n  listener: PersistedDocumentListener,\n): () => void {\n  return persistedDocumentListeners.subscribe(domainScope, listener);\n}\n\nexport function emitPersistedDocumentDeletion(\n  domainScope: DomainScope,\n  localId: string,\n): void {\n  persistedDocumentDeletionListeners.emit(domainScope, localId);\n}\n\nexport function subscribeToPersistedDocumentDeletions(\n  domainScope: DomainScope,\n  listener: PersistedDocumentDeletionListener,\n): () => void {\n  return persistedDocumentDeletionListeners.subscribe(domainScope, listener);\n}\n\nexport function requestDomainDocumentSync(domainScope: DomainScope): void {\n  const registry = documentStoreRegistriesByScope.get(domainScope);\n  if (!registry) {\n    return;\n  }\n\n  for (const store of new Set(registry.storesByKey.values())) {\n    store.requestSync();\n  }\n}\n"]}

package/stores/documents/types.d.ts

@@ -0,0 +1,85 @@
+import type { ContainerAccessLevel } from "../../internal/crypto/index.js";
+import type { BlobByteSourceInput } from "../../data/blobContracts.js";
+import type { DocumentAttachment } from "../../data/documents/documentContent.js";
+import type { DocumentFieldValidationIssue, StoredDocumentKind } from "../../data/documents/documentKinds.js";
+import type { DocumentRow } from "../../data/documents/documentRowList.js";
+import type { DocumentSummary } from "../../data/documents/documentSummary.js";
+import type { DocumentsWorkflowRuntime, RelinkPersistedDocumentInput } from "../../workflows/documents/index.js";
+export declare const DEFAULT_DOCUMENT_ID = "default";
+export type DocumentsRuntime = DocumentsWorkflowRuntime;
+export type DocumentStructuredFieldPatch = Readonly<Record<string, string | undefined>>;
+export interface DocumentMutationOptions {
+    deferRemoteSync?: boolean | undefined;
+}
+export interface DocumentAttachmentUpload {
+    bytes: BlobByteSourceInput;
+    name: string;
+    mimeType: string | null;
+}
+export type DocumentAttachmentStatus = "syncing" | "intent-mismatch";
+export type AddDocumentRow = (fields: Readonly<Record<string, string>>) => Promise<string>;
+export type UpdateDocumentRowFields = (id: string, patch: Readonly<Record<string, string>>) => Promise<void>;
+export type RemoveDocumentRow = (id: string) => Promise<void>;
+export type DocumentContextValue = DocumentSnapshot & Pick<DocumentStore, "addRow" | "attachFiles" | "relink" | "removeAttachment" | "removeRow" | "replaceAttachment" | "requestSync" | "setStructuredFields" | "setText" | "updateRowFields">;
+export interface DocumentSnapshot {
+    attachments: ReadonlyArray<DocumentAttachment>;
+    attachmentStatusBySlotId: Readonly<Record<string, DocumentAttachmentStatus>>;
+    attachmentStorageKeyBySlotId: Readonly<Record<string, string>>;
+    canAttach: boolean;
+    canWrite: boolean;
+    currentAuthorId: string | null;
+    documentId: string | null;
+    documentKind: StoredDocumentKind;
+    effectiveAccessLevel: ContainerAccessLevel;
+    fieldValidationIssues: ReadonlyArray<DocumentFieldValidationIssue>;
+    ready: boolean;
+    rows: ReadonlyArray<DocumentRow>;
+    structuredFields: Readonly<Record<string, string>>;
+    text: string;
+    title: string;
+    syncing: boolean;
+}
+export interface DocumentStore {
+    addRow: AddDocumentRow;
+    /** Fail unless this store can produce a mergeable full-history checkpoint. */
+    assertCanRotateContentKey: () => Promise<Uint8Array>;
+    attachFiles: (files: ReadonlyArray<DocumentAttachmentUpload>) => void;
+    /**
+     * Convert this document's persisted local state to the discovered-share
+     * shell so the store re-pulls the server copy — the escape hatch for
+     * queued local writes that can no longer sync. `expectedDocumentId` is
+     * revalidated against the persisted record inside the teardown's
+     * serialized mutation, so a stale caller can never discard a different
+     * identity's edits. Refuses (returns false) local-only, unlinked,
+     * move-pending, and identity-mismatched documents.
+     */
+    discardLocalState: (expectedDocumentId: string) => Promise<boolean>;
+    ensureInitialized: () => Promise<boolean>;
+    getSnapshot: () => DocumentSnapshot;
+    removeAttachment: (slotId: string) => void;
+    removeRow: RemoveDocumentRow;
+    replaceAttachment: (slotId: string, file: DocumentAttachmentUpload) => Promise<void>;
+    /** Pull remote document updates even when no websocket event marked it dirty. */
+    requestRemoteSync: () => void;
+    /** Pull remote updates and report whether the requested sync pass completed. */
+    requestRemoteSyncAndWait: (signal?: AbortSignal | undefined) => Promise<boolean>;
+    requestSync: () => void;
+    relink: (input: DocumentStoreRelinkInput) => Promise<DocumentSummary | null>;
+    setStructuredFields: (kind: Exclude<StoredDocumentKind, "note">, patch: DocumentStructuredFieldPatch, options?: DocumentMutationOptions | undefined) => Promise<void>;
+    setText: (value: string) => Promise<void>;
+    subscribe: (listener: () => void) => () => void;
+    updateRowFields: UpdateDocumentRowFields;
+    updateRuntime: (runtime: DocumentsRuntime) => void;
+}
+export interface DocumentStoreFacade extends DocumentStore {
+    rebindTo: (store: DocumentStore) => void;
+}
+export type PersistedDocumentListener = (document: DocumentSummary, change: {
+    readonly placementChanged: boolean;
+}) => void;
+export interface DocumentStoreRelinkInput extends RelinkPersistedDocumentInput {
+    contentKeyBundle?: string | null | undefined;
+    documentKekTargets?: string | null | undefined;
+    documentManifestBundle?: string | null | undefined;
+    stillCurrent?: (() => boolean) | undefined;
+}

package/stores/documents/types.js

@@ -0,0 +1,2 @@
+export const DEFAULT_DOCUMENT_ID = "default";
+//# sourceMappingURL=types.js.map

package/stores/documents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC","sourcesContent":["import type { ContainerAccessLevel } from \"@tearleads/crypto\";\nimport type { BlobByteSourceInput } from \"../../data/blobContracts\";\nimport type { DocumentAttachment } from \"../../data/documents/documentContent\";\nimport type {\n  DocumentFieldValidationIssue,\n  StoredDocumentKind,\n} from \"../../data/documents/documentKinds\";\nimport type { DocumentRow } from \"../../data/documents/documentRowList\";\nimport type { DocumentSummary } from \"../../data/documents/documentSummary\";\nimport type {\n  DocumentsWorkflowRuntime,\n  RelinkPersistedDocumentInput,\n} from \"../../workflows/documents\";\n\nexport const DEFAULT_DOCUMENT_ID = \"default\";\n\nexport type DocumentsRuntime = DocumentsWorkflowRuntime;\nexport type DocumentStructuredFieldPatch = Readonly<\n  Record<string, string | undefined>\n>;\n\nexport interface DocumentMutationOptions {\n  deferRemoteSync?: boolean | undefined;\n}\n\nexport interface DocumentAttachmentUpload {\n  bytes: BlobByteSourceInput;\n  name: string;\n  mimeType: string | null;\n}\n\n// `syncing`: the slot's upload is still queued. `intent-mismatch`: the held\n// bytes are a validly signed served binding whose digest differs from the one\n// the document content records (its content update has not arrived).\nexport type DocumentAttachmentStatus = \"syncing\" | \"intent-mismatch\";\n\n// Add a row to the document's repeated-row list, returning the new row id.\nexport type AddDocumentRow = (\n  fields: Readonly<Record<string, string>>,\n) => Promise<string>;\n// Patch one or more cells of a single row (merges per-cell).\nexport type UpdateDocumentRowFields = (\n  id: string,\n  patch: Readonly<Record<string, string>>,\n) => Promise<void>;\nexport type RemoveDocumentRow = (id: string) => Promise<void>;\n\n// The store surface exposed through context: the snapshot fields plus the\n// store's mutation methods, spelled as a Pick so the two can't drift.\nexport type DocumentContextValue = DocumentSnapshot &\n  Pick<\n    DocumentStore,\n    | \"addRow\"\n    | \"attachFiles\"\n    | \"relink\"\n    | \"removeAttachment\"\n    | \"removeRow\"\n    | \"replaceAttachment\"\n    | \"requestSync\"\n    | \"setStructuredFields\"\n    | \"setText\"\n    | \"updateRowFields\"\n  >;\n\nexport interface DocumentSnapshot {\n  attachments: ReadonlyArray<DocumentAttachment>;\n  attachmentStatusBySlotId: Readonly<Record<string, DocumentAttachmentStatus>>;\n  attachmentStorageKeyBySlotId: Readonly<Record<string, string>>;\n  canAttach: boolean;\n  canWrite: boolean;\n  currentAuthorId: string | null;\n  documentId: string | null;\n  documentKind: StoredDocumentKind;\n  effectiveAccessLevel: ContainerAccessLevel;\n  fieldValidationIssues: ReadonlyArray<DocumentFieldValidationIssue>;\n  ready: boolean;\n  rows: ReadonlyArray<DocumentRow>;\n  structuredFields: Readonly<Record<string, string>>;\n  text: string;\n  title: string;\n  syncing: boolean;\n}\n\nexport interface DocumentStore {\n  addRow: AddDocumentRow;\n  /** Fail unless this store can produce a mergeable full-history checkpoint. */\n  assertCanRotateContentKey: () => Promise<Uint8Array>;\n  attachFiles: (files: ReadonlyArray<DocumentAttachmentUpload>) => void;\n  /**\n   * Convert this document's persisted local state to the discovered-share\n   * shell so the store re-pulls the server copy — the escape hatch for\n   * queued local writes that can no longer sync. `expectedDocumentId` is\n   * revalidated against the persisted record inside the teardown's\n   * serialized mutation, so a stale caller can never discard a different\n   * identity's edits. Refuses (returns false) local-only, unlinked,\n   * move-pending, and identity-mismatched documents.\n   */\n  discardLocalState: (expectedDocumentId: string) => Promise<boolean>;\n  ensureInitialized: () => Promise<boolean>;\n  getSnapshot: () => DocumentSnapshot;\n  removeAttachment: (slotId: string) => void;\n  removeRow: RemoveDocumentRow;\n  replaceAttachment: (\n    slotId: string,\n    file: DocumentAttachmentUpload,\n  ) => Promise<void>;\n  /** Pull remote document updates even when no websocket event marked it dirty. */\n  requestRemoteSync: () => void;\n  /** Pull remote updates and report whether the requested sync pass completed. */\n  requestRemoteSyncAndWait: (\n    signal?: AbortSignal | undefined,\n  ) => Promise<boolean>;\n  requestSync: () => void;\n  relink: (input: DocumentStoreRelinkInput) => Promise<DocumentSummary | null>;\n  setStructuredFields: (\n    kind: Exclude<StoredDocumentKind, \"note\">,\n    patch: DocumentStructuredFieldPatch,\n    options?: DocumentMutationOptions | undefined,\n  ) => Promise<void>;\n  setText: (value: string) => Promise<void>;\n  subscribe: (listener: () => void) => () => void;\n  updateRowFields: UpdateDocumentRowFields;\n  updateRuntime: (runtime: DocumentsRuntime) => void;\n}\n\nexport interface DocumentStoreFacade extends DocumentStore {\n  rebindTo: (store: DocumentStore) => void;\n}\n\nexport type PersistedDocumentListener = (\n  document: DocumentSummary,\n  change: { readonly placementChanged: boolean },\n) => void;\n\nexport interface DocumentStoreRelinkInput extends RelinkPersistedDocumentInput {\n  contentKeyBundle?: string | null | undefined;\n  documentKekTargets?: string | null | undefined;\n  documentManifestBundle?: string | null | undefined;\n  stillCurrent?: (() => boolean) | undefined;\n}\n"]}

package/stores/local-projection/index.d.ts

@@ -0,0 +1,3 @@
+export type { LocalProjectionStore } from "./localProjectionStore.js";
+export { getOrCreateLocalProjectionStore } from "./registry.js";
+export type { LocalProjectionReconciledDelta, LocalProjectionSnapshot, LocalProjectionView, } from "./types.js";

package/stores/local-projection/index.js

@@ -0,0 +1,2 @@
+export { getOrCreateLocalProjectionStore } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/stores/local-projection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export type { LocalProjectionStore } from \"./localProjectionStore\";\nexport { getOrCreateLocalProjectionStore } from \"./registry\";\nexport type {\n  LocalProjectionReconciledDelta,\n  LocalProjectionSnapshot,\n  LocalProjectionView,\n} from \"./types\";\n"]}

package/stores/local-projection/localProjectionStore.d.ts

@@ -0,0 +1,31 @@
+import type { DocumentSummary } from "../../data/documents/documentSummary.js";
+import type { ContainerContentsStoreRuntime } from "../container-contents/syncAgent.js";
+import type { ContainerContentsStore } from "../container-contents/types.js";
+import type { LocalProjectionReconciledDelta, LocalProjectionSnapshot } from "./types.js";
+/**
+ * Signals the local projection store raises so the background reconciler
+ * (Layer B) knows what to sync. The store never performs remote I/O itself.
+ */
+export interface LocalProjectionReconcileSignal {
+    reason: "hydrated" | "active-changed" | "prerequisites-regained" | "remote-containers-added";
+    activeContainerId: string | null;
+}
+export type LocalProjectionReconcileListener = (signal: LocalProjectionReconcileSignal) => void;
+export interface LocalProjectionStore {
+    getSnapshot: () => LocalProjectionSnapshot;
+    subscribe: (listener: () => void) => () => void;
+    setActiveContainer: (containerId: string | null) => void;
+    getActiveContainerId: () => string | null;
+    applyReconciled: (delta: LocalProjectionReconciledDelta) => void;
+    loadContainerDelta: (containerId: string) => Promise<LocalProjectionReconciledDelta>;
+    removePersistedDocument: (localId: string) => void;
+    refreshPersistedDocument: (document: DocumentSummary, placementChanged?: boolean) => void;
+    updateRuntime: (runtime: ContainerContentsStoreRuntime) => void;
+    /** Registered by the reconciler; returns an unsubscribe handle. */
+    onReconcileSignal: (listener: LocalProjectionReconcileListener) => () => void;
+    getContainerStore: () => ContainerContentsStore;
+}
+export declare function createLocalProjectionStore(input: {
+    containerStore: ContainerContentsStore;
+    runtime: ContainerContentsStoreRuntime;
+}): LocalProjectionStore;

package/stores/local-projection/localProjectionStore.js

@@ -0,0 +1,299 @@
+import { loadLocalContainerProjectionDocumentsFromRuntime } from "../../workflows/container-contents/projectionView.js";
+import { didRegainSyncPrerequisites } from "../../workflows/container-contents/syncLane.js";
+import { isReconcilableContainerNode, isRemoteBackedContainerNode, } from "../container-contents/reconcilableContainer.js";
+import { applyContainerSummaries, createSummaryCache, removeDocumentSummary, resetSummaryCache, snapshotLinkedContainerIdsByDocumentId, snapshotSummariesByContainerId, } from "./summaryCache.js";
+const EMPTY_SNAPSHOT = {
+    ready: false,
+    containers: [],
+    documentSummariesByContainerId: new Map(),
+    linkedContainerIdsByDocumentId: new Map(),
+};
+function computeSnapshot(state) {
+    const containerSnapshot = state.containerStore.getSnapshot();
+    return {
+        ready: containerSnapshot.ready,
+        containers: containerSnapshot.nodes,
+        documentSummariesByContainerId: snapshotSummariesByContainerId(state.cache),
+        linkedContainerIdsByDocumentId: snapshotLinkedContainerIdsByDocumentId(state.cache),
+    };
+}
+function emit(state) {
+    state.snapshot = computeSnapshot(state);
+    for (const listener of state.listeners) {
+        try {
+            listener();
+        }
+        catch {
+            // Keep one subscriber failure from blocking later subscribers.
+        }
+    }
+}
+function notifyReconcile(state, signal) {
+    for (const listener of state.reconcileListeners) {
+        try {
+            listener(signal);
+        }
+        catch {
+            // Reconciler failures must not break the read path.
+        }
+    }
+}
+function loadContainerSummaries(state, containerId) {
+    if (state.cache.hydratedContainerIds.has(containerId) ||
+        state.pendingSummaryReads.has(containerId) ||
+        state.runtime.infra.dbStatus !== "ready") {
+        return;
+    }
+    const pendingRead = {
+        discardResult: false,
+        reloadAfter: false,
+    };
+    void loadLocalContainerProjectionDocumentsFromRuntime({
+        containerIds: [containerId],
+        runtime: state.runtime,
+    })
+        .then((documents) => {
+        // A runtime reset (e.g. dbStatus loss) clears this entry and the cache
+        // mid-flight; do not apply a stale read to a freshly reset cache.
+        if (state.pendingSummaryReads.get(containerId) !== pendingRead ||
+            pendingRead.discardResult) {
+            return;
+        }
+        const changed = applyContainerSummaries(state.cache, {
+            containerId,
+            documentSummaries: documents.documentSummaries,
+            linkedContainerIdsByDocumentId: documents.linkedContainerIdsByDocumentId,
+        });
+        if (changed) {
+            emit(state);
+        }
+    })
+        .catch(() => {
+        // Local read failures fall back to an empty list; the reconciler retries.
+    })
+        .finally(() => {
+        if (state.pendingSummaryReads.get(containerId) !== pendingRead) {
+            return;
+        }
+        state.pendingSummaryReads.delete(containerId);
+        if (pendingRead.reloadAfter) {
+            state.cache.hydratedContainerIds.delete(containerId);
+            loadContainerSummaries(state, containerId);
+        }
+    });
+    state.pendingSummaryReads.set(containerId, pendingRead);
+}
+function refreshContainerSummaries(state, containerId, discardPendingRead = false) {
+    state.cache.hydratedContainerIds.delete(containerId);
+    const pendingRead = state.pendingSummaryReads.get(containerId);
+    if (pendingRead) {
+        // Publish ordinary reads before the trailing refresh so autosaves cannot
+        // starve first paint. Deletion and reconciliation must reject older rows.
+        pendingRead.reloadAfter = true;
+        pendingRead.discardResult ||= discardPendingRead;
+    }
+    else {
+        loadContainerSummaries(state, containerId);
+    }
+}
+function refreshPersistedDocument(state, document, placementChanged = false) {
+    state.documentRevision += 1;
+    const containerIds = new Set(state.pendingSummaryReads.keys());
+    if (state.activeContainerId &&
+        state.activeContainerId === document.containerId) {
+        containerIds.add(state.activeContainerId);
+    }
+    for (const [containerId, summaries] of state.cache.summariesByContainerId) {
+        if (containerId === document.containerId ||
+            summaries.some((summary) => summary.id === document.id)) {
+            containerIds.add(containerId);
+        }
+    }
+    for (const containerId of containerIds) {
+        refreshContainerSummaries(state, containerId, placementChanged);
+    }
+}
+function markHydratedIfReady(state) {
+    if (state.hydratedContainerSummaries ||
+        state.runtime.infra.dbStatus !== "ready" ||
+        !state.containerStore.getSnapshot().ready) {
+        return false;
+    }
+    state.hydratedContainerSummaries = true;
+    if (state.activeContainerId) {
+        loadContainerSummaries(state, state.activeContainerId);
+    }
+    return true;
+}
+function flushPendingPrerequisitesRegained(state) {
+    if (!state.pendingPrerequisitesRegained ||
+        !state.hydratedContainerSummaries ||
+        !state.containerStore.getSnapshot().ready) {
+        return;
+    }
+    state.pendingPrerequisitesRegained = false;
+    notifyReconcile(state, {
+        reason: "prerequisites-regained",
+        activeContainerId: state.activeContainerId,
+    });
+}
+function publishHydration(state) {
+    const didMarkHydrated = markHydratedIfReady(state);
+    emit(state);
+    if (didMarkHydrated) {
+        notifyReconcile(state, {
+            reason: "hydrated",
+            activeContainerId: state.activeContainerId,
+        });
+    }
+    // Backfills read getSnapshot(), so publish the tree before requesting them.
+    flushPendingPrerequisitesRegained(state);
+    return didMarkHydrated;
+}
+function resetProjection(state) {
+    state.documentRevision += 1;
+    resetSummaryCache(state.cache);
+    state.pendingSummaryReads.clear();
+    state.hydratedContainerSummaries = false;
+}
+function hasRemoteBackedContainerMembershipGrowth(previous, next, homeOrganizationId, activeContainerId) {
+    const isRemoteReconcilable = (container) => isReconcilableContainerNode(container, homeOrganizationId);
+    const previousIds = new Set(previous.flatMap((container) => isRemoteReconcilable(container) ? [container.id] : []));
+    if (next.some((container) => isRemoteReconcilable(container) && !previousIds.has(container.id))) {
+        return true;
+    }
+    if (!activeContainerId) {
+        return false;
+    }
+    const wasActiveRemoteBacked = previous.some((container) => container.id === activeContainerId &&
+        isRemoteBackedContainerNode(container));
+    return (!wasActiveRemoteBacked &&
+        next.some((container) => container.id === activeContainerId &&
+            isRemoteBackedContainerNode(container)));
+}
+function removePersistedDocumentFromCache(state, localId) {
+    state.documentRevision += 1;
+    // The deleted row may exist only in an in-flight first read, so invalidating
+    // just containers that already cached it would allow it to reappear offline.
+    for (const containerId of state.pendingSummaryReads.keys()) {
+        refreshContainerSummaries(state, containerId, true);
+    }
+    if (removeDocumentSummary(state.cache, localId)) {
+        emit(state);
+    }
+}
+function updateLocalProjectionRuntime(state, runtime) {
+    const previousRuntime = state.runtime;
+    state.runtime = runtime;
+    if (runtime.infra.execSql !== previousRuntime.infra.execSql ||
+        runtime.state.domainScope !== previousRuntime.state.domainScope) {
+        resetProjection(state);
+    }
+    state.containerStore.updateRuntime(runtime);
+    // Latch before the readiness checks so a regain that arrives while the
+    // database or container tree is still warming up is flushed after
+    // hydration instead of being lost to startup ordering.
+    if (didRegainSyncPrerequisites(previousRuntime, runtime)) {
+        state.pendingPrerequisitesRegained = true;
+    }
+    if (runtime.infra.dbStatus !== "ready") {
+        resetProjection(state);
+        emit(state);
+        return;
+    }
+    // Reload the active container's summaries when the local store becomes
+    // ready (e.g. first DB attach) so first paint reflects cached contents.
+    publishHydration(state);
+}
+export function createLocalProjectionStore(input) {
+    const state = {
+        activeContainerId: null,
+        documentRevision: 0,
+        deltaRevisions: new WeakMap(),
+        cache: createSummaryCache(),
+        containerStore: input.containerStore,
+        hydratedContainerSummaries: false,
+        listeners: new Set(),
+        pendingPrerequisitesRegained: false,
+        reconcileListeners: new Set(),
+        runtime: input.runtime,
+        snapshot: EMPTY_SNAPSHOT,
+        pendingSummaryReads: new Map(),
+    };
+    state.snapshot = computeSnapshot(state);
+    // Re-emit whenever the underlying container tree changes (mutations, remote
+    // hydration). This keeps the merged snapshot in step with the tree store.
+    input.containerStore.subscribe(() => {
+        const previousContainers = state.snapshot.containers;
+        const didMarkHydrated = publishHydration(state);
+        // Authentication can schedule the initial idle backfill before the
+        // asynchronous remote tree crawl discovers this identity's real root and
+        // system children. Re-arm backfill after those remotely-listable ids become
+        // visible. Compare membership, not node objects, so metadata/sync-state
+        // churn cannot create a reconciliation loop.
+        if (!didMarkHydrated &&
+            hasRemoteBackedContainerMembershipGrowth(previousContainers, state.snapshot.containers, state.runtime.auth.organizationId, state.activeContainerId)) {
+            notifyReconcile(state, {
+                reason: "remote-containers-added",
+                activeContainerId: state.activeContainerId,
+            });
+        }
+    });
+    return {
+        getSnapshot: () => state.snapshot,
+        subscribe: (listener) => {
+            state.listeners.add(listener);
+            return () => {
+                state.listeners.delete(listener);
+            };
+        },
+        setActiveContainer: (containerId) => {
+            if (state.activeContainerId === containerId) {
+                return;
+            }
+            state.activeContainerId = containerId;
+            if (containerId) {
+                refreshContainerSummaries(state, containerId);
+            }
+            notifyReconcile(state, {
+                reason: "active-changed",
+                activeContainerId: containerId,
+            });
+        },
+        getActiveContainerId: () => state.activeContainerId,
+        loadContainerDelta: async (containerId) => {
+            const revision = state.documentRevision;
+            const documents = await loadLocalContainerProjectionDocumentsFromRuntime({
+                containerIds: [containerId],
+                runtime: state.runtime,
+            });
+            const delta = { containerId, ...documents };
+            state.deltaRevisions.set(delta, revision);
+            return delta;
+        },
+        applyReconciled: (delta) => {
+            const revision = state.deltaRevisions.get(delta);
+            if (revision !== undefined && revision !== state.documentRevision) {
+                refreshContainerSummaries(state, delta.containerId, true);
+                return;
+            }
+            if (state.pendingSummaryReads.has(delta.containerId)) {
+                refreshContainerSummaries(state, delta.containerId, true);
+            }
+            if (applyContainerSummaries(state.cache, delta)) {
+                emit(state);
+            }
+        },
+        removePersistedDocument: (localId) => removePersistedDocumentFromCache(state, localId),
+        refreshPersistedDocument: (document, placementChanged) => refreshPersistedDocument(state, document, placementChanged),
+        updateRuntime: (runtime) => updateLocalProjectionRuntime(state, runtime),
+        onReconcileSignal: (listener) => {
+            state.reconcileListeners.add(listener);
+            return () => {
+                state.reconcileListeners.delete(listener);
+            };
+        },
+        getContainerStore: () => state.containerStore,
+    };
+}
+//# sourceMappingURL=localProjectionStore.js.map

package/stores/local-projection/localProjectionStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localProjectionStore.js","sourceRoot":"","sources":["localProjectionStore.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DocumentSummary } from \"../../data/documents/documentSummary\";\nimport { loadLocalContainerProjectionDocumentsFromRuntime } from \"../../workflows/container-contents/projectionView\";\nimport { didRegainSyncPrerequisites } from \"../../workflows/container-contents/syncLane\";\nimport {\n  isReconcilableContainerNode,\n  isRemoteBackedContainerNode,\n} from \"../container-contents/reconcilableContainer\";\nimport type { ContainerContentsStoreRuntime } from \"../container-contents/syncAgent\";\nimport type { ContainerContentsStore } from \"../container-contents/types\";\nimport {\n  applyContainerSummaries,\n  createSummaryCache,\n  removeDocumentSummary,\n  resetSummaryCache,\n  type SummaryCache,\n  snapshotLinkedContainerIdsByDocumentId,\n  snapshotSummariesByContainerId,\n} from \"./summaryCache\";\nimport type {\n  LocalProjectionReconciledDelta,\n  LocalProjectionSnapshot,\n} from \"./types\";\n\n/**\n * Signals the local projection store raises so the background reconciler\n * (Layer B) knows what to sync. The store never performs remote I/O itself.\n */\nexport interface LocalProjectionReconcileSignal {\n  reason:\n    | \"hydrated\"\n    | \"active-changed\"\n    | \"prerequisites-regained\"\n    | \"remote-containers-added\";\n  activeContainerId: string | null;\n}\n\nexport type LocalProjectionReconcileListener = (\n  signal: LocalProjectionReconcileSignal,\n) => void;\n\nexport interface LocalProjectionStore {\n  getSnapshot: () => LocalProjectionSnapshot;\n  subscribe: (listener: () => void) => () => void;\n  setActiveContainer: (containerId: string | null) => void;\n  getActiveContainerId: () => string | null;\n  applyReconciled: (delta: LocalProjectionReconciledDelta) => void;\n  loadContainerDelta: (\n    containerId: string,\n  ) => Promise<LocalProjectionReconciledDelta>;\n  removePersistedDocument: (localId: string) => void;\n  refreshPersistedDocument: (\n    document: DocumentSummary,\n    placementChanged?: boolean,\n  ) => void;\n  updateRuntime: (runtime: ContainerContentsStoreRuntime) => void;\n  /** Registered by the reconciler; returns an unsubscribe handle. */\n  onReconcileSignal: (listener: LocalProjectionReconcileListener) => () => void;\n  getContainerStore: () => ContainerContentsStore;\n}\n\ninterface LocalProjectionStoreState {\n  activeContainerId: string | null;\n  documentRevision: number;\n  deltaRevisions: WeakMap<LocalProjectionReconciledDelta, number>;\n  cache: SummaryCache;\n  containerStore: ContainerContentsStore;\n  hydratedContainerSummaries: boolean;\n  listeners: Set<() => void>;\n  /**\n   * A sync-prerequisite regain (auth, connectivity, or key pair) that arrived\n   * before the container tree was ready. The signal's reset-and-backfill must\n   * not be lost to startup ordering, so it is latched here and flushed once\n   * hydration completes.\n   */\n  pendingPrerequisitesRegained: boolean;\n  reconcileListeners: Set<LocalProjectionReconcileListener>;\n  runtime: ContainerContentsStoreRuntime;\n  snapshot: LocalProjectionSnapshot;\n  pendingSummaryReads: Map<string, PendingSummaryRead>;\n}\n\ninterface PendingSummaryRead {\n  discardResult: boolean;\n  reloadAfter: boolean;\n}\n\nconst EMPTY_SNAPSHOT: LocalProjectionSnapshot = {\n  ready: false,\n  containers: [],\n  documentSummariesByContainerId: new Map(),\n  linkedContainerIdsByDocumentId: new Map(),\n};\n\nfunction computeSnapshot(\n  state: LocalProjectionStoreState,\n): LocalProjectionSnapshot {\n  const containerSnapshot = state.containerStore.getSnapshot();\n  return {\n    ready: containerSnapshot.ready,\n    containers: containerSnapshot.nodes,\n    documentSummariesByContainerId: snapshotSummariesByContainerId(state.cache),\n    linkedContainerIdsByDocumentId: snapshotLinkedContainerIdsByDocumentId(\n      state.cache,\n    ),\n  };\n}\n\nfunction emit(state: LocalProjectionStoreState): void {\n  state.snapshot = computeSnapshot(state);\n  for (const listener of state.listeners) {\n    try {\n      listener();\n    } catch {\n      // Keep one subscriber failure from blocking later subscribers.\n    }\n  }\n}\n\nfunction notifyReconcile(\n  state: LocalProjectionStoreState,\n  signal: LocalProjectionReconcileSignal,\n): void {\n  for (const listener of state.reconcileListeners) {\n    try {\n      listener(signal);\n    } catch {\n      // Reconciler failures must not break the read path.\n    }\n  }\n}\n\nfunction loadContainerSummaries(\n  state: LocalProjectionStoreState,\n  containerId: string,\n): void {\n  if (\n    state.cache.hydratedContainerIds.has(containerId) ||\n    state.pendingSummaryReads.has(containerId) ||\n    state.runtime.infra.dbStatus !== \"ready\"\n  ) {\n    return;\n  }\n\n  const pendingRead: PendingSummaryRead = {\n    discardResult: false,\n    reloadAfter: false,\n  };\n  void loadLocalContainerProjectionDocumentsFromRuntime({\n    containerIds: [containerId],\n    runtime: state.runtime,\n  })\n    .then((documents) => {\n      // A runtime reset (e.g. dbStatus loss) clears this entry and the cache\n      // mid-flight; do not apply a stale read to a freshly reset cache.\n      if (\n        state.pendingSummaryReads.get(containerId) !== pendingRead ||\n        pendingRead.discardResult\n      ) {\n        return;\n      }\n      const changed = applyContainerSummaries(state.cache, {\n        containerId,\n        documentSummaries: documents.documentSummaries,\n        linkedContainerIdsByDocumentId:\n          documents.linkedContainerIdsByDocumentId,\n      });\n      if (changed) {\n        emit(state);\n      }\n    })\n    .catch(() => {\n      // Local read failures fall back to an empty list; the reconciler retries.\n    })\n    .finally(() => {\n      if (state.pendingSummaryReads.get(containerId) !== pendingRead) {\n        return;\n      }\n      state.pendingSummaryReads.delete(containerId);\n      if (pendingRead.reloadAfter) {\n        state.cache.hydratedContainerIds.delete(containerId);\n        loadContainerSummaries(state, containerId);\n      }\n    });\n\n  state.pendingSummaryReads.set(containerId, pendingRead);\n}\n\nfunction refreshContainerSummaries(\n  state: LocalProjectionStoreState,\n  containerId: string,\n  discardPendingRead = false,\n): void {\n  state.cache.hydratedContainerIds.delete(containerId);\n  const pendingRead = state.pendingSummaryReads.get(containerId);\n  if (pendingRead) {\n    // Publish ordinary reads before the trailing refresh so autosaves cannot\n    // starve first paint. Deletion and reconciliation must reject older rows.\n    pendingRead.reloadAfter = true;\n    pendingRead.discardResult ||= discardPendingRead;\n  } else {\n    loadContainerSummaries(state, containerId);\n  }\n}\n\nfunction refreshPersistedDocument(\n  state: LocalProjectionStoreState,\n  document: DocumentSummary,\n  placementChanged = false,\n): void {\n  state.documentRevision += 1;\n  const containerIds = new Set(state.pendingSummaryReads.keys());\n  if (\n    state.activeContainerId &&\n    state.activeContainerId === document.containerId\n  ) {\n    containerIds.add(state.activeContainerId);\n  }\n  for (const [containerId, summaries] of state.cache.summariesByContainerId) {\n    if (\n      containerId === document.containerId ||\n      summaries.some((summary) => summary.id === document.id)\n    ) {\n      containerIds.add(containerId);\n    }\n  }\n  for (const containerId of containerIds) {\n    refreshContainerSummaries(state, containerId, placementChanged);\n  }\n}\n\nfunction markHydratedIfReady(state: LocalProjectionStoreState): boolean {\n  if (\n    state.hydratedContainerSummaries ||\n    state.runtime.infra.dbStatus !== \"ready\" ||\n    !state.containerStore.getSnapshot().ready\n  ) {\n    return false;\n  }\n\n  state.hydratedContainerSummaries = true;\n  if (state.activeContainerId) {\n    loadContainerSummaries(state, state.activeContainerId);\n  }\n  return true;\n}\n\nfunction flushPendingPrerequisitesRegained(\n  state: LocalProjectionStoreState,\n): void {\n  if (\n    !state.pendingPrerequisitesRegained ||\n    !state.hydratedContainerSummaries ||\n    !state.containerStore.getSnapshot().ready\n  ) {\n    return;\n  }\n  state.pendingPrerequisitesRegained = false;\n  notifyReconcile(state, {\n    reason: \"prerequisites-regained\",\n    activeContainerId: state.activeContainerId,\n  });\n}\n\nfunction publishHydration(state: LocalProjectionStoreState): boolean {\n  const didMarkHydrated = markHydratedIfReady(state);\n  emit(state);\n  if (didMarkHydrated) {\n    notifyReconcile(state, {\n      reason: \"hydrated\",\n      activeContainerId: state.activeContainerId,\n    });\n  }\n  // Backfills read getSnapshot(), so publish the tree before requesting them.\n  flushPendingPrerequisitesRegained(state);\n  return didMarkHydrated;\n}\n\nfunction resetProjection(state: LocalProjectionStoreState): void {\n  state.documentRevision += 1;\n  resetSummaryCache(state.cache);\n  state.pendingSummaryReads.clear();\n  state.hydratedContainerSummaries = false;\n}\n\nfunction hasRemoteBackedContainerMembershipGrowth(\n  previous: LocalProjectionSnapshot[\"containers\"],\n  next: LocalProjectionSnapshot[\"containers\"],\n  homeOrganizationId: string | null,\n  activeContainerId: string | null,\n): boolean {\n  const isRemoteReconcilable = (\n    container: LocalProjectionSnapshot[\"containers\"][number],\n  ) => isReconcilableContainerNode(container, homeOrganizationId);\n  const previousIds = new Set(\n    previous.flatMap((container) =>\n      isRemoteReconcilable(container) ? [container.id] : [],\n    ),\n  );\n  if (\n    next.some(\n      (container) =>\n        isRemoteReconcilable(container) && !previousIds.has(container.id),\n    )\n  ) {\n    return true;\n  }\n  if (!activeContainerId) {\n    return false;\n  }\n  const wasActiveRemoteBacked = previous.some(\n    (container) =>\n      container.id === activeContainerId &&\n      isRemoteBackedContainerNode(container),\n  );\n  return (\n    !wasActiveRemoteBacked &&\n    next.some(\n      (container) =>\n        container.id === activeContainerId &&\n        isRemoteBackedContainerNode(container),\n    )\n  );\n}\n\nfunction removePersistedDocumentFromCache(\n  state: LocalProjectionStoreState,\n  localId: string,\n): void {\n  state.documentRevision += 1;\n  // The deleted row may exist only in an in-flight first read, so invalidating\n  // just containers that already cached it would allow it to reappear offline.\n  for (const containerId of state.pendingSummaryReads.keys()) {\n    refreshContainerSummaries(state, containerId, true);\n  }\n  if (removeDocumentSummary(state.cache, localId)) {\n    emit(state);\n  }\n}\n\nfunction updateLocalProjectionRuntime(\n  state: LocalProjectionStoreState,\n  runtime: ContainerContentsStoreRuntime,\n): void {\n  const previousRuntime = state.runtime;\n  state.runtime = runtime;\n  if (\n    runtime.infra.execSql !== previousRuntime.infra.execSql ||\n    runtime.state.domainScope !== previousRuntime.state.domainScope\n  ) {\n    resetProjection(state);\n  }\n  state.containerStore.updateRuntime(runtime);\n\n  // Latch before the readiness checks so a regain that arrives while the\n  // database or container tree is still warming up is flushed after\n  // hydration instead of being lost to startup ordering.\n  if (didRegainSyncPrerequisites(previousRuntime, runtime)) {\n    state.pendingPrerequisitesRegained = true;\n  }\n\n  if (runtime.infra.dbStatus !== \"ready\") {\n    resetProjection(state);\n    emit(state);\n    return;\n  }\n\n  // Reload the active container's summaries when the local store becomes\n  // ready (e.g. first DB attach) so first paint reflects cached contents.\n  publishHydration(state);\n}\n\nexport function createLocalProjectionStore(input: {\n  containerStore: ContainerContentsStore;\n  runtime: ContainerContentsStoreRuntime;\n}): LocalProjectionStore {\n  const state: LocalProjectionStoreState = {\n    activeContainerId: null,\n    documentRevision: 0,\n    deltaRevisions: new WeakMap(),\n    cache: createSummaryCache(),\n    containerStore: input.containerStore,\n    hydratedContainerSummaries: false,\n    listeners: new Set(),\n    pendingPrerequisitesRegained: false,\n    reconcileListeners: new Set(),\n    runtime: input.runtime,\n    snapshot: EMPTY_SNAPSHOT,\n    pendingSummaryReads: new Map(),\n  };\n  state.snapshot = computeSnapshot(state);\n\n  // Re-emit whenever the underlying container tree changes (mutations, remote\n  // hydration). This keeps the merged snapshot in step with the tree store.\n  input.containerStore.subscribe(() => {\n    const previousContainers = state.snapshot.containers;\n    const didMarkHydrated = publishHydration(state);\n    // Authentication can schedule the initial idle backfill before the\n    // asynchronous remote tree crawl discovers this identity's real root and\n    // system children. Re-arm backfill after those remotely-listable ids become\n    // visible. Compare membership, not node objects, so metadata/sync-state\n    // churn cannot create a reconciliation loop.\n    if (\n      !didMarkHydrated &&\n      hasRemoteBackedContainerMembershipGrowth(\n        previousContainers,\n        state.snapshot.containers,\n        state.runtime.auth.organizationId,\n        state.activeContainerId,\n      )\n    ) {\n      notifyReconcile(state, {\n        reason: \"remote-containers-added\",\n        activeContainerId: state.activeContainerId,\n      });\n    }\n  });\n\n  return {\n    getSnapshot: () => state.snapshot,\n    subscribe: (listener) => {\n      state.listeners.add(listener);\n      return () => {\n        state.listeners.delete(listener);\n      };\n    },\n    setActiveContainer: (containerId) => {\n      if (state.activeContainerId === containerId) {\n        return;\n      }\n      state.activeContainerId = containerId;\n      if (containerId) {\n        refreshContainerSummaries(state, containerId);\n      }\n      notifyReconcile(state, {\n        reason: \"active-changed\",\n        activeContainerId: containerId,\n      });\n    },\n    getActiveContainerId: () => state.activeContainerId,\n    loadContainerDelta: async (containerId) => {\n      const revision = state.documentRevision;\n      const documents = await loadLocalContainerProjectionDocumentsFromRuntime({\n        containerIds: [containerId],\n        runtime: state.runtime,\n      });\n      const delta = { containerId, ...documents };\n      state.deltaRevisions.set(delta, revision);\n      return delta;\n    },\n    applyReconciled: (delta) => {\n      const revision = state.deltaRevisions.get(delta);\n      if (revision !== undefined && revision !== state.documentRevision) {\n        refreshContainerSummaries(state, delta.containerId, true);\n        return;\n      }\n      if (state.pendingSummaryReads.has(delta.containerId)) {\n        refreshContainerSummaries(state, delta.containerId, true);\n      }\n      if (applyContainerSummaries(state.cache, delta)) {\n        emit(state);\n      }\n    },\n    removePersistedDocument: (localId) =>\n      removePersistedDocumentFromCache(state, localId),\n    refreshPersistedDocument: (document, placementChanged) =>\n      refreshPersistedDocument(state, document, placementChanged),\n    updateRuntime: (runtime) => updateLocalProjectionRuntime(state, runtime),\n    onReconcileSignal: (listener) => {\n      state.reconcileListeners.add(listener);\n      return () => {\n        state.reconcileListeners.delete(listener);\n      };\n    },\n    getContainerStore: () => state.containerStore,\n  };\n}\n"]}

package/stores/local-projection/registry.d.ts

@@ -0,0 +1,15 @@
+import type { DomainScope } from "../../data/domainScope.js";
+import { type ContainerContentsStoreOptions } from "../container-contents/index.js";
+import type { ContainerContentsStoreRuntime } from "../container-contents/syncAgent.js";
+import { type LocalProjectionStore } from "./localProjectionStore.js";
+/**
+ * Get (or lazily create) the device-first local projection store for a domain
+ * scope. The store is cached per scope so every consumer in the same
+ * storage/identity context shares one view — mirroring how the container
+ * contents store is cached.
+ */
+export declare function getOrCreateLocalProjectionStore(input: {
+    domainScope: DomainScope;
+    runtime: ContainerContentsStoreRuntime;
+    options?: ContainerContentsStoreOptions | undefined;
+}): LocalProjectionStore;

package/stores/local-projection/registry.js

@@ -0,0 +1,24 @@
+import { getOrCreateContainerContentsStore, } from "../container-contents/index.js";
+import { createLocalProjectionStore, } from "./localProjectionStore.js";
+const localProjectionStoresByScope = new WeakMap();
+/**
+ * Get (or lazily create) the device-first local projection store for a domain
+ * scope. The store is cached per scope so every consumer in the same
+ * storage/identity context shares one view — mirroring how the container
+ * contents store is cached.
+ */
+export function getOrCreateLocalProjectionStore(input) {
+    const existing = localProjectionStoresByScope.get(input.domainScope);
+    if (existing) {
+        existing.updateRuntime(input.runtime);
+        return existing;
+    }
+    const containerStore = getOrCreateContainerContentsStore(input.domainScope, input.runtime, input.options ?? {});
+    const store = createLocalProjectionStore({
+        containerStore,
+        runtime: input.runtime,
+    });
+    localProjectionStoresByScope.set(input.domainScope, store);
+    return store;
+}
+//# sourceMappingURL=registry.js.map

package/stores/local-projection/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["registry.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,iCAAiC,GAClC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,GAE3B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,4BAA4B,GAAG,IAAI,OAAO,EAG7C,CAAC;AAEJ;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAAC,KAI/C;IACC,MAAM,QAAQ,GAAG,4BAA4B,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACrE,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,cAAc,GAAG,iCAAiC,CACtD,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,OAAO,IAAI,EAAE,CACpB,CAAC;IACF,MAAM,KAAK,GAAG,0BAA0B,CAAC;QACvC,cAAc;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IACH,4BAA4B,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import type { DomainScope } from \"../../data/domainScope\";\nimport {\n  type ContainerContentsStoreOptions,\n  getOrCreateContainerContentsStore,\n} from \"../container-contents\";\nimport type { ContainerContentsStoreRuntime } from \"../container-contents/syncAgent\";\nimport {\n  createLocalProjectionStore,\n  type LocalProjectionStore,\n} from \"./localProjectionStore\";\n\nconst localProjectionStoresByScope = new WeakMap<\n  DomainScope,\n  LocalProjectionStore\n>();\n\n/**\n * Get (or lazily create) the device-first local projection store for a domain\n * scope. The store is cached per scope so every consumer in the same\n * storage/identity context shares one view — mirroring how the container\n * contents store is cached.\n */\nexport function getOrCreateLocalProjectionStore(input: {\n  domainScope: DomainScope;\n  runtime: ContainerContentsStoreRuntime;\n  options?: ContainerContentsStoreOptions | undefined;\n}): LocalProjectionStore {\n  const existing = localProjectionStoresByScope.get(input.domainScope);\n  if (existing) {\n    existing.updateRuntime(input.runtime);\n    return existing;\n  }\n\n  const containerStore = getOrCreateContainerContentsStore(\n    input.domainScope,\n    input.runtime,\n    input.options ?? {},\n  );\n  const store = createLocalProjectionStore({\n    containerStore,\n    runtime: input.runtime,\n  });\n  localProjectionStoresByScope.set(input.domainScope, store);\n  return store;\n}\n"]}