@tearleads/client-sdk 0.1.63 → 0.1.65

package/stores/container-contents/remoteEvents/remoteContainerIngestion.js

@@ -0,0 +1,59 @@
+import { errorMessage } from "../../../data/shared/errorMessage.js";
+import { createRemoteContainerIngestor, } from "../../../workflows/container-contents/remoteHydration/index.js";
+import { resumeContainerContentsRecoveryHydration } from "../hydration/remoteHydrationRequest.js";
+import { getContainerContentsStoreLogLabel } from "../logLabel.js";
+export async function resumeRemoteContainerRecoveryWork(input) {
+    try {
+        await input.resumeIngestion();
+    }
+    catch (error) {
+        input.onIngestionError(error);
+        return;
+    }
+    try {
+        await input.resumeHydration();
+    }
+    catch (error) {
+        input.onHydrationError(error);
+    }
+}
+export function createRemoteContainerIngestionController(input) {
+    const { host, scheduleSync, state } = input;
+    const remoteContainerIngestor = createRemoteContainerIngestor({
+        getSerializationBarrier: () => state.initializePromise,
+        host,
+        state,
+    });
+    const scheduleAfterIngestion = () => {
+        if (state.runtime.infra.dbStatus === "ready" &&
+            state.documentStoresNeedPriming) {
+            scheduleSync();
+        }
+    };
+    const resumeIngestion = async () => {
+        const hadPendingIngestion = remoteContainerIngestor.hasPending();
+        await remoteContainerIngestor.resume();
+        if (hadPendingIngestion) {
+            scheduleAfterIngestion();
+        }
+    };
+    return {
+        ingest: async (remoteContainer) => {
+            await remoteContainerIngestor(remoteContainer);
+            scheduleAfterIngestion();
+        },
+        resumeInterruptedWork: () => resumeRemoteContainerRecoveryWork({
+            onHydrationError: (error) => {
+                state.runtime.util.log(`${getContainerContentsStoreLogLabel(state)}: failed to resume remote hydration: ${errorMessage(error)}`);
+            },
+            onIngestionError: (error) => {
+                state.runtime.util.log(`${getContainerContentsStoreLogLabel(state)}: failed to resume remote container ingestion: ${errorMessage(error)}`);
+            },
+            resumeHydration: async () => {
+                await resumeContainerContentsRecoveryHydration(state);
+            },
+            resumeIngestion,
+        }),
+    };
+}
+//# sourceMappingURL=remoteContainerIngestion.js.map

package/stores/container-contents/remoteEvents/remoteContainerIngestion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteContainerIngestion.js","sourceRoot":"","sources":["remoteContainerIngestion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EACL,6BAA6B,GAG9B,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EAAE,wCAAwC,EAAE,MAAM,qCAAqC,CAAC;AAC/F,OAAO,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AAQhE,MAAM,CAAC,KAAK,UAAU,iCAAiC,CAAC,KAKvD;IACC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wCAAwC,CAAC,KAIxD;IACC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAC5C,MAAM,uBAAuB,GAAG,6BAA6B,CAAC;QAC5D,uBAAuB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,iBAAiB;QACtD,IAAI;QACJ,KAAK;KACN,CAAC,CAAC;IACH,MAAM,sBAAsB,GAAG,GAAG,EAAE;QAClC,IACE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO;YACxC,KAAK,CAAC,yBAAyB,EAC/B,CAAC;YACD,YAAY,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC;IACF,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE;QACjC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,UAAU,EAAE,CAAC;QACjE,MAAM,uBAAuB,CAAC,MAAM,EAAE,CAAC;QACvC,IAAI,mBAAmB,EAAE,CAAC;YACxB,sBAAsB,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE;YAChC,MAAM,uBAAuB,CAAC,eAAe,CAAC,CAAC;YAC/C,sBAAsB,EAAE,CAAC;QAC3B,CAAC;QACD,qBAAqB,EAAE,GAAG,EAAE,CAC1B,iCAAiC,CAAC;YAChC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC1B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CACpB,GAAG,iCAAiC,CAAC,KAAK,CAAC,wCAAwC,YAAY,CAAC,KAAK,CAAC,EAAE,CACzG,CAAC;YACJ,CAAC;YACD,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC1B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CACpB,GAAG,iCAAiC,CAAC,KAAK,CAAC,kDAAkD,YAAY,CAAC,KAAK,CAAC,EAAE,CACnH,CAAC;YACJ,CAAC;YACD,eAAe,EAAE,KAAK,IAAI,EAAE;gBAC1B,MAAM,wCAAwC,CAAC,KAAK,CAAC,CAAC;YACxD,CAAC;YACD,eAAe;SAChB,CAAC;KACL,CAAC;AACJ,CAAC","sourcesContent":["import { errorMessage } from \"../../../data/shared/errorMessage\";\nimport {\n  createRemoteContainerIngestor,\n  type RemoteContainer,\n  type RemoteContainerHydrationHost,\n} from \"../../../workflows/container-contents/remoteHydration\";\nimport { resumeContainerContentsRecoveryHydration } from \"../hydration/remoteHydrationRequest\";\nimport { getContainerContentsStoreLogLabel } from \"../logLabel\";\nimport type { ContainerContentsStoreSyncState } from \"../syncAgent/syncAgentTypes\";\n\ninterface RemoteContainerIngestionController {\n  ingest: (remoteContainer: RemoteContainer) => Promise<void>;\n  resumeInterruptedWork: () => Promise<void>;\n}\n\nexport async function resumeRemoteContainerRecoveryWork(input: {\n  onIngestionError: (error: unknown) => void;\n  onHydrationError: (error: unknown) => void;\n  resumeHydration: () => Promise<void>;\n  resumeIngestion: () => Promise<void>;\n}): Promise<void> {\n  try {\n    await input.resumeIngestion();\n  } catch (error) {\n    input.onIngestionError(error);\n    return;\n  }\n  try {\n    await input.resumeHydration();\n  } catch (error) {\n    input.onHydrationError(error);\n  }\n}\n\nexport function createRemoteContainerIngestionController(input: {\n  host: RemoteContainerHydrationHost;\n  scheduleSync: () => void;\n  state: ContainerContentsStoreSyncState;\n}): RemoteContainerIngestionController {\n  const { host, scheduleSync, state } = input;\n  const remoteContainerIngestor = createRemoteContainerIngestor({\n    getSerializationBarrier: () => state.initializePromise,\n    host,\n    state,\n  });\n  const scheduleAfterIngestion = () => {\n    if (\n      state.runtime.infra.dbStatus === \"ready\" &&\n      state.documentStoresNeedPriming\n    ) {\n      scheduleSync();\n    }\n  };\n  const resumeIngestion = async () => {\n    const hadPendingIngestion = remoteContainerIngestor.hasPending();\n    await remoteContainerIngestor.resume();\n    if (hadPendingIngestion) {\n      scheduleAfterIngestion();\n    }\n  };\n\n  return {\n    ingest: async (remoteContainer) => {\n      await remoteContainerIngestor(remoteContainer);\n      scheduleAfterIngestion();\n    },\n    resumeInterruptedWork: () =>\n      resumeRemoteContainerRecoveryWork({\n        onHydrationError: (error) => {\n          state.runtime.util.log(\n            `${getContainerContentsStoreLogLabel(state)}: failed to resume remote hydration: ${errorMessage(error)}`,\n          );\n        },\n        onIngestionError: (error) => {\n          state.runtime.util.log(\n            `${getContainerContentsStoreLogLabel(state)}: failed to resume remote container ingestion: ${errorMessage(error)}`,\n          );\n        },\n        resumeHydration: async () => {\n          await resumeContainerContentsRecoveryHydration(state);\n        },\n        resumeIngestion,\n      }),\n  };\n}\n"]}

package/stores/container-contents/remoteEvents/remoteEventProjectionInvalidation.js

@@ -0,0 +1,36 @@
+import { invalidateContainerProjections } from "../../../workflows/container-contents/container-state/projectionCache.js";
+/**
+ * Drop every cached writer projection a hint invalidates, before hydration
+ * lands, so the next share or move fetches a fresh one instead of submitting
+ * against a stale manifest and conflicting. Descendants cite the same ancestor
+ * manifests in their paths, so the locally known subtree under each invalidated
+ * container is dropped too (an unhydrated subtree has nothing cached). Both
+ * layers go: the in-memory copies on each container state, and the api-client's
+ * cached writer projections that cite an invalidated container. Document
+ * projections cite their paths too, so they are found by citation rather than
+ * through the links, which live in SQLite; projections citing none of them stay
+ * cached (#2395). Each open document store drops its own in-memory copy on the
+ * same hint.
+ */
+export function invalidateCachedProjections(state, invalidated) {
+    if (invalidated.length === 0)
+        return;
+    const roots = new Set(invalidated);
+    const stale = new Set(invalidated);
+    for (const [id, containerState] of state.containersById) {
+        let parentId = containerState.container.parentId;
+        for (let depth = 0; parentId !== null &&
+            !roots.has(parentId) &&
+            depth < state.containersById.size; depth++)
+            parentId = state.containersById.get(parentId)?.container.parentId ?? null;
+        if (parentId !== null)
+            stale.add(id);
+    }
+    for (const id of stale) {
+        const containerState = state.containersById.get(id);
+        if (containerState)
+            invalidateContainerProjections(containerState);
+    }
+    state.runtime.apiClient.evictWriterProjectionsCiting(invalidated);
+}
+//# sourceMappingURL=remoteEventProjectionInvalidation.js.map

package/stores/container-contents/remoteEvents/remoteEventProjectionInvalidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteEventProjectionInvalidation.js","sourceRoot":"","sources":["remoteEventProjectionInvalidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,uEAAuE,CAAC;AAGvH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAA0E,EAC1E,WAA8B;IAE9B,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACrC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACnC,KAAK,MAAM,CAAC,EAAE,EAAE,cAAc,CAAC,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACxD,IAAI,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC;QACjD,KACE,IAAI,KAAK,GAAG,CAAC,EACb,QAAQ,KAAK,IAAI;YACjB,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;YACpB,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,IAAI,EACjC,KAAK,EAAE;YAEP,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,QAAQ,IAAI,IAAI,CAAC;QAC5E,IAAI,QAAQ,KAAK,IAAI;YAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,cAAc;YAAE,8BAA8B,CAAC,cAAc,CAAC,CAAC;IACrE,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,4BAA4B,CAAC,WAAW,CAAC,CAAC;AACpE,CAAC","sourcesContent":["import { invalidateContainerProjections } from \"../../../workflows/container-contents/container-state/projectionCache\";\nimport type { ContainerContentsStoreSyncState } from \"../syncAgent/syncAgentTypes\";\n\n/**\n * Drop every cached writer projection a hint invalidates, before hydration\n * lands, so the next share or move fetches a fresh one instead of submitting\n * against a stale manifest and conflicting. Descendants cite the same ancestor\n * manifests in their paths, so the locally known subtree under each invalidated\n * container is dropped too (an unhydrated subtree has nothing cached). Both\n * layers go: the in-memory copies on each container state, and the api-client's\n * cached writer projections that cite an invalidated container. Document\n * projections cite their paths too, so they are found by citation rather than\n * through the links, which live in SQLite; projections citing none of them stay\n * cached (#2395). Each open document store drops its own in-memory copy on the\n * same hint.\n */\nexport function invalidateCachedProjections(\n  state: Pick<ContainerContentsStoreSyncState, \"containersById\" | \"runtime\">,\n  invalidated: readonly string[],\n): void {\n  if (invalidated.length === 0) return;\n  const roots = new Set(invalidated);\n  const stale = new Set(invalidated);\n  for (const [id, containerState] of state.containersById) {\n    let parentId = containerState.container.parentId;\n    for (\n      let depth = 0;\n      parentId !== null &&\n      !roots.has(parentId) &&\n      depth < state.containersById.size;\n      depth++\n    )\n      parentId = state.containersById.get(parentId)?.container.parentId ?? null;\n    if (parentId !== null) stale.add(id);\n  }\n  for (const id of stale) {\n    const containerState = state.containersById.get(id);\n    if (containerState) invalidateContainerProjections(containerState);\n  }\n  state.runtime.apiClient.evictWriterProjectionsCiting(invalidated);\n}\n"]}

package/stores/container-contents/remoteEvents/remoteEventSync.js

@@ -0,0 +1,38 @@
+import { listContainerParentIdsForEventHydration, listContainerProjectionInvalidationIds, } from "../../../workflows/container-contents/containerEvents.js";
+import { listContainerMetadataDocumentUpdateIds } from "../../../workflows/container-contents/metadata/index.js";
+import { observeContainerBackgroundHydration } from "../hydration/backgroundHydration.js";
+import { bumpMetadataSyncSeq } from "../syncAgent/metadataSyncSignal.js";
+import { invalidateCachedProjections } from "./remoteEventProjectionInvalidation.js";
+export function handleContainerContentsRemoteEvents(input) {
+    const { requestHydration, scheduleSync, state } = input;
+    // Metadata events are classified through the initialized container records.
+    // Do not consume the cursor while a replacement database is still loading;
+    // initialization calls this handler again once those identities exist.
+    if (!state.initialized) {
+        return;
+    }
+    const nextEvents = state.runtime.state.events.slice(state.lastEventCount);
+    state.lastEventCount = state.runtime.state.events.length;
+    // A peer's grant, rekey, or recite changed a manifest this client's cached
+    // projections cite, without evicting this subscriber.
+    invalidateCachedProjections(state, listContainerProjectionInvalidationIds(nextEvents));
+    let addedHydrationLane = false;
+    for (const parentId of listContainerParentIdsForEventHydration(nextEvents)) {
+        if (!state.containerParentIdsNeedingHydration.has(parentId)) {
+            addedHydrationLane = true;
+        }
+        state.containerParentIdsNeedingHydration.add(parentId);
+    }
+    if (addedHydrationLane) {
+        observeContainerBackgroundHydration(state, requestHydration());
+    }
+    const metadataDocumentIds = listContainerMetadataDocumentUpdateIds(nextEvents, state.containersById.values(), state.locallyAcceptedMetadataUpdateIds);
+    for (const metadataDocumentId of metadataDocumentIds) {
+        state.metadataDocumentIdsNeedingSync.add(metadataDocumentId);
+        bumpMetadataSyncSeq(state.metadataSyncSignalSeqById, metadataDocumentId);
+    }
+    if (metadataDocumentIds.length > 0) {
+        scheduleSync();
+    }
+}
+//# sourceMappingURL=remoteEventSync.js.map

package/stores/container-contents/remoteEvents/remoteEventSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteEventSync.js","sourceRoot":"","sources":["remoteEventSync.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uCAAuC,EACvC,sCAAsC,GACvC,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EAAE,sCAAsC,EAAE,MAAM,gDAAgD,CAAC;AACxG,OAAO,EAAE,mCAAmC,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAElF,MAAM,UAAU,mCAAmC,CAAC,KAInD;IACC,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxD,4EAA4E;IAC5E,2EAA2E;IAC3E,uEAAuE;IACvE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1E,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IACzD,2EAA2E;IAC3E,sDAAsD;IACtD,2BAA2B,CACzB,KAAK,EACL,sCAAsC,CAAC,UAAU,CAAC,CACnD,CAAC;IACF,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,KAAK,MAAM,QAAQ,IAAI,uCAAuC,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3E,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5D,kBAAkB,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,kCAAkC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,kBAAkB,EAAE,CAAC;QACvB,mCAAmC,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,mBAAmB,GAAG,sCAAsC,CAChE,UAAU,EACV,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,EAC7B,KAAK,CAAC,gCAAgC,CACvC,CAAC;IACF,KAAK,MAAM,kBAAkB,IAAI,mBAAmB,EAAE,CAAC;QACrD,KAAK,CAAC,8BAA8B,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC7D,mBAAmB,CAAC,KAAK,CAAC,yBAAyB,EAAE,kBAAkB,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,YAAY,EAAE,CAAC;IACjB,CAAC;AACH,CAAC","sourcesContent":["import {\n  listContainerParentIdsForEventHydration,\n  listContainerProjectionInvalidationIds,\n} from \"../../../workflows/container-contents/containerEvents\";\nimport { listContainerMetadataDocumentUpdateIds } from \"../../../workflows/container-contents/metadata\";\nimport { observeContainerBackgroundHydration } from \"../hydration/backgroundHydration\";\nimport { bumpMetadataSyncSeq } from \"../syncAgent/metadataSyncSignal\";\nimport type { ContainerContentsStoreSyncState } from \"../syncAgent/syncAgentTypes\";\nimport { invalidateCachedProjections } from \"./remoteEventProjectionInvalidation\";\n\nexport function handleContainerContentsRemoteEvents(input: {\n  requestHydration: () => Promise<void>;\n  scheduleSync: () => void;\n  state: ContainerContentsStoreSyncState;\n}): void {\n  const { requestHydration, scheduleSync, state } = input;\n  // Metadata events are classified through the initialized container records.\n  // Do not consume the cursor while a replacement database is still loading;\n  // initialization calls this handler again once those identities exist.\n  if (!state.initialized) {\n    return;\n  }\n  const nextEvents = state.runtime.state.events.slice(state.lastEventCount);\n  state.lastEventCount = state.runtime.state.events.length;\n  // A peer's grant, rekey, or recite changed a manifest this client's cached\n  // projections cite, without evicting this subscriber.\n  invalidateCachedProjections(\n    state,\n    listContainerProjectionInvalidationIds(nextEvents),\n  );\n  let addedHydrationLane = false;\n  for (const parentId of listContainerParentIdsForEventHydration(nextEvents)) {\n    if (!state.containerParentIdsNeedingHydration.has(parentId)) {\n      addedHydrationLane = true;\n    }\n    state.containerParentIdsNeedingHydration.add(parentId);\n  }\n  if (addedHydrationLane) {\n    observeContainerBackgroundHydration(state, requestHydration());\n  }\n\n  const metadataDocumentIds = listContainerMetadataDocumentUpdateIds(\n    nextEvents,\n    state.containersById.values(),\n    state.locallyAcceptedMetadataUpdateIds,\n  );\n  for (const metadataDocumentId of metadataDocumentIds) {\n    state.metadataDocumentIdsNeedingSync.add(metadataDocumentId);\n    bumpMetadataSyncSeq(state.metadataSyncSignalSeqById, metadataDocumentId);\n  }\n  if (metadataDocumentIds.length > 0) {\n    scheduleSync();\n  }\n}\n"]}

package/stores/container-contents/remoteWrites/remoteWriteGuards.js

@@ -0,0 +1,54 @@
+import { findOrganizationSystemRootState, findSystemContainerStateForRoot, } from "../systemContainers/systemContainerLookup.js";
+import { isContainerInSubtree } from "../utils.js";
+const activeByState = new WeakMap();
+/** Invalidate remote settlement only when a local edit touches its subtree. */
+export function invalidateRemoteContainerWrites(state, changedIds, movedId) {
+    if (changedIds?.length === 0 && movedId === undefined)
+        return;
+    for (const write of activeByState.get(state) ?? []) {
+        let rootId;
+        if (typeof write.scope === "object") {
+            const root = state.containersById.get(write.scope.rootId);
+            if (root) {
+                rootId = (findSystemContainerStateForRoot(state, write.scope.systemSlot, root) ??
+                    findOrganizationSystemRootState(state, root.container.organizationId ||
+                        state.runtime.auth.organizationId ||
+                        "", write.scope.systemSlot))?.container.id;
+            }
+        }
+        else {
+            rootId = write.scope;
+        }
+        if (write.scope === undefined ||
+            changedIds === null ||
+            (rootId !== undefined &&
+                (changedIds.some((id) => isContainerInSubtree(state.containersById, id, rootId)) ||
+                    (movedId !== undefined &&
+                        isContainerInSubtree(state.containersById, rootId, movedId))))) {
+            write.changed = true;
+        }
+    }
+}
+export function trackRemoteContainerWrite(state, scope) {
+    const active = activeByState.get(state) ?? new Set();
+    activeByState.set(state, active);
+    const write = { changed: false, scope };
+    active.add(write);
+    return {
+        changed: () => write.changed,
+        dispose: () => {
+            active.delete(write);
+        },
+    };
+}
+/** An undiscovered system child has a stable slot before it has a local id. */
+export function invalidateRemoteSystemContainerWrite(state, rootId, systemSlot) {
+    for (const write of activeByState.get(state) ?? []) {
+        if (typeof write.scope === "object" &&
+            write.scope.rootId === rootId &&
+            write.scope.systemSlot === systemSlot) {
+            write.changed = true;
+        }
+    }
+}
+//# sourceMappingURL=remoteWriteGuards.js.map

package/stores/container-contents/remoteWrites/remoteWriteGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteWriteGuards.js","sourceRoot":"","sources":["remoteWriteGuards.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContainerSystemSlot } from \"@tearleads/validators/containerSystemSlot\";\nimport {\n  findOrganizationSystemRootState,\n  findSystemContainerStateForRoot,\n} from \"../systemContainers/systemContainerLookup\";\nimport type { ContainerContentsStoreState } from \"../types\";\nimport { isContainerInSubtree } from \"../utils\";\n\nexport type RemoteContainerWriteScope =\n  | string\n  | {\n      rootId: string;\n      systemSlot: ContainerSystemSlot;\n    };\ninterface ActiveRemoteWrite {\n  changed: boolean;\n  scope: RemoteContainerWriteScope | undefined;\n}\nconst activeByState = new WeakMap<\n  ContainerContentsStoreState,\n  Set<ActiveRemoteWrite>\n>();\n\n/** Invalidate remote settlement only when a local edit touches its subtree. */\nexport function invalidateRemoteContainerWrites(\n  state: ContainerContentsStoreState,\n  changedIds: readonly string[] | null,\n  movedId?: string,\n): void {\n  if (changedIds?.length === 0 && movedId === undefined) return;\n  for (const write of activeByState.get(state) ?? []) {\n    let rootId: string | undefined;\n    if (typeof write.scope === \"object\") {\n      const root = state.containersById.get(write.scope.rootId);\n      if (root) {\n        rootId = (\n          findSystemContainerStateForRoot(\n            state,\n            write.scope.systemSlot,\n            root,\n          ) ??\n          findOrganizationSystemRootState(\n            state,\n            root.container.organizationId ||\n              state.runtime.auth.organizationId ||\n              \"\",\n            write.scope.systemSlot,\n          )\n        )?.container.id;\n      }\n    } else {\n      rootId = write.scope;\n    }\n    if (\n      write.scope === undefined ||\n      changedIds === null ||\n      (rootId !== undefined &&\n        (changedIds.some((id) =>\n          isContainerInSubtree(state.containersById, id, rootId),\n        ) ||\n          (movedId !== undefined &&\n            isContainerInSubtree(state.containersById, rootId, movedId))))\n    ) {\n      write.changed = true;\n    }\n  }\n}\n\nexport function trackRemoteContainerWrite(\n  state: ContainerContentsStoreState,\n  scope?: RemoteContainerWriteScope,\n) {\n  const active = activeByState.get(state) ?? new Set<ActiveRemoteWrite>();\n  activeByState.set(state, active);\n  const write: ActiveRemoteWrite = { changed: false, scope };\n  active.add(write);\n  return {\n    changed: () => write.changed,\n    dispose: () => {\n      active.delete(write);\n    },\n  };\n}\n\n/** An undiscovered system child has a stable slot before it has a local id. */\nexport function invalidateRemoteSystemContainerWrite(\n  state: ContainerContentsStoreState,\n  rootId: string,\n  systemSlot: ContainerSystemSlot,\n): void {\n  for (const write of activeByState.get(state) ?? []) {\n    if (\n      typeof write.scope === \"object\" &&\n      write.scope.rootId === rootId &&\n      write.scope.systemSlot === systemSlot\n    ) {\n      write.changed = true;\n    }\n  }\n}\n"]}

package/stores/container-contents/remoteWrites/remoteWriteQueue.js

@@ -0,0 +1,51 @@
+import { errorMessage } from "../../../data/shared/errorMessage.js";
+import { trackRemoteContainerWrite, } from "./remoteWriteGuards.js";
+import { captureContainerWriteGeneration } from "./writeGeneration.js";
+const remoteWritesByState = new WeakMap();
+/** Online operations serialize together; local writes never wait for their I/O. */
+export function chainRemoteContainerTask(state, syncAgent, staleResult, work, scope, options = {}) {
+    const contextCurrent = captureContainerWriteGeneration(state);
+    const previous = remoteWritesByState.get(state);
+    const tail = previous?.current() ? previous.tail : Promise.resolve();
+    const task = tail.then(async () => {
+        if (!contextCurrent())
+            return staleResult;
+        // Install the guard at one local queue boundary. New writes can proceed
+        // immediately afterward; an ongoing stream cannot starve the remote task.
+        const boundary = state.writeChain
+            .catch(() => null)
+            .then(() => trackRemoteContainerWrite(state, scope));
+        state.writeChain = boundary.then(() => null);
+        const tracked = await boundary;
+        const isCurrent = () => contextCurrent() && !tracked.changed();
+        try {
+            if (!isCurrent())
+                return staleResult;
+            const result = await work(isCurrent);
+            // Only completed operations opt in. A replaced runtime always cancels.
+            return contextCurrent() &&
+                (!tracked.changed() || options.preserveResultOnLocalWrite)
+                ? result
+                : staleResult;
+        }
+        finally {
+            tracked.dispose();
+            if (contextCurrent() && tracked.changed()) {
+                // The HTTP side may have committed before a new local write invalidated
+                // this operation. Reconcile its authoritative result without allowing
+                // the older operation to install state over the user's newer write.
+                state.localContainersNeedRefresh = true;
+                void syncAgent.refreshLocalContainers().catch((error) => {
+                    state.runtime.util.log(`Container contents: local refresh failed (${errorMessage(error)})`);
+                });
+                syncAgent.scheduleRemoteHydration();
+            }
+        }
+    });
+    remoteWritesByState.set(state, {
+        current: contextCurrent,
+        tail: task.then(() => undefined, () => undefined),
+    });
+    return task;
+}
+//# sourceMappingURL=remoteWriteQueue.js.map

package/stores/container-contents/remoteWrites/remoteWriteQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteWriteQueue.js","sourceRoot":"","sources":["remoteWriteQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGjE,OAAO,EAEL,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAEpE,MAAM,mBAAmB,GAAG,IAAI,OAAO,EAGpC,CAAC;AAEJ,mFAAmF;AACnF,MAAM,UAAU,wBAAwB,CACtC,KAAkC,EAClC,SAGC,EACD,WAAc,EACd,IAA8C,EAC9C,KAAiC,EACjC,UAAoD,EAAE;IAEtD,MAAM,cAAc,GAAG,+BAA+B,CAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACrE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QAChC,IAAI,CAAC,cAAc,EAAE;YAAE,OAAO,WAAW,CAAC;QAC1C,wEAAwE;QACxE,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU;aAC9B,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;aACjB,IAAI,CAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACvD,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC;QAC/B,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/D,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,EAAE;gBAAE,OAAO,WAAW,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;YACrC,uEAAuE;YACvE,OAAO,cAAc,EAAE;gBACrB,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,OAAO,CAAC,0BAA0B,CAAC;gBAC1D,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,WAAW,CAAC;QAClB,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,cAAc,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC1C,wEAAwE;gBACxE,sEAAsE;gBACtE,oEAAoE;gBACpE,KAAK,CAAC,0BAA0B,GAAG,IAAI,CAAC;gBACxC,KAAK,SAAS,CAAC,sBAAsB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;oBAC/D,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CACpB,6CAA6C,YAAY,CAAC,KAAK,CAAC,GAAG,CACpE,CAAC;gBACJ,CAAC,CAAC,CAAC;gBACH,SAAS,CAAC,uBAAuB,EAAE,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE;QAC7B,OAAO,EAAE,cAAc;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI,CACb,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB;KACF,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import { errorMessage } from \"../../../data/shared/errorMessage\";\nimport type { ContainerContentsStoreSyncAgent } from \"../syncAgent\";\nimport type { ContainerContentsStoreState } from \"../types\";\nimport {\n  type RemoteContainerWriteScope,\n  trackRemoteContainerWrite,\n} from \"./remoteWriteGuards\";\nimport { captureContainerWriteGeneration } from \"./writeGeneration\";\n\nconst remoteWritesByState = new WeakMap<\n  ContainerContentsStoreState,\n  { current: () => boolean; tail: Promise<void> }\n>();\n\n/** Online operations serialize together; local writes never wait for their I/O. */\nexport function chainRemoteContainerTask<T>(\n  state: ContainerContentsStoreState,\n  syncAgent: Pick<\n    ContainerContentsStoreSyncAgent,\n    \"refreshLocalContainers\" | \"scheduleRemoteHydration\"\n  >,\n  staleResult: T,\n  work: (isCurrent: () => boolean) => Promise<T>,\n  scope?: RemoteContainerWriteScope,\n  options: { preserveResultOnLocalWrite?: boolean } = {},\n): Promise<T> {\n  const contextCurrent = captureContainerWriteGeneration(state);\n  const previous = remoteWritesByState.get(state);\n  const tail = previous?.current() ? previous.tail : Promise.resolve();\n  const task = tail.then(async () => {\n    if (!contextCurrent()) return staleResult;\n    // Install the guard at one local queue boundary. New writes can proceed\n    // immediately afterward; an ongoing stream cannot starve the remote task.\n    const boundary = state.writeChain\n      .catch(() => null)\n      .then(() => trackRemoteContainerWrite(state, scope));\n    state.writeChain = boundary.then(() => null);\n    const tracked = await boundary;\n    const isCurrent = () => contextCurrent() && !tracked.changed();\n    try {\n      if (!isCurrent()) return staleResult;\n      const result = await work(isCurrent);\n      // Only completed operations opt in. A replaced runtime always cancels.\n      return contextCurrent() &&\n        (!tracked.changed() || options.preserveResultOnLocalWrite)\n        ? result\n        : staleResult;\n    } finally {\n      tracked.dispose();\n      if (contextCurrent() && tracked.changed()) {\n        // The HTTP side may have committed before a new local write invalidated\n        // this operation. Reconcile its authoritative result without allowing\n        // the older operation to install state over the user's newer write.\n        state.localContainersNeedRefresh = true;\n        void syncAgent.refreshLocalContainers().catch((error: unknown) => {\n          state.runtime.util.log(\n            `Container contents: local refresh failed (${errorMessage(error)})`,\n          );\n        });\n        syncAgent.scheduleRemoteHydration();\n      }\n    }\n  });\n  remoteWritesByState.set(state, {\n    current: contextCurrent,\n    tail: task.then(\n      () => undefined,\n      () => undefined,\n    ),\n  });\n  return task;\n}\n"]}

package/stores/container-contents/remoteWrites/writeGeneration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeGeneration.js","sourceRoot":"","sources":["writeGeneration.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,8BAA8B,CAC5C,eAA8C,EAC9C,cAA6C;IAE7C,OAAO,CACL,eAAe,CAAC,kBAAkB,KAAK,cAAc,CAAC,kBAAkB;QACxE,eAAe,CAAC,SAAS,KAAK,cAAc,CAAC,SAAS;QACtD,eAAe,CAAC,IAAI,CAAC,qBAAqB;YACxC,cAAc,CAAC,IAAI,CAAC,qBAAqB;QAC3C,eAAe,CAAC,IAAI,CAAC,eAAe;YAClC,cAAc,CAAC,IAAI,CAAC,eAAe;QACrC,eAAe,CAAC,IAAI,CAAC,cAAc;YACjC,cAAc,CAAC,IAAI,CAAC,cAAc;QACpC,eAAe,CAAC,IAAI,CAAC,MAAM,KAAK,cAAc,CAAC,IAAI,CAAC,MAAM;QAC1D,eAAe,CAAC,MAAM,CAAC,oBAAoB;YACzC,cAAc,CAAC,MAAM,CAAC,oBAAoB;QAC5C,eAAe,CAAC,MAAM,CAAC,kBAAkB;YACvC,cAAc,CAAC,MAAM,CAAC,kBAAkB;QAC1C,eAAe,CAAC,MAAM,CAAC,cAAc;YACnC,cAAc,CAAC,MAAM,CAAC,cAAc;QACtC,eAAe,CAAC,KAAK,CAAC,SAAS,KAAK,cAAc,CAAC,KAAK,CAAC,SAAS;QAClE,eAAe,CAAC,KAAK,CAAC,QAAQ,KAAK,cAAc,CAAC,KAAK,CAAC,QAAQ;QAChE,eAAe,CAAC,KAAK,CAAC,kBAAkB;YACtC,cAAc,CAAC,KAAK,CAAC,kBAAkB;QACzC,eAAe,CAAC,KAAK,CAAC,OAAO,KAAK,cAAc,CAAC,KAAK,CAAC,OAAO;QAC9D,eAAe,CAAC,0BAA0B;YACxC,cAAc,CAAC,0BAA0B;QAC3C,eAAe,CAAC,KAAK,CAAC,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,WAAW;QACtE,eAAe,CAAC,KAAK,CAAC,WAAW,KAAK,cAAc,CAAC,KAAK,CAAC,WAAW,CACvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAkC;IAElC,MAAM,mBAAmB,GAAG,KAAK,CAAC,mBAAmB,CAAC;IACtD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC9C,OAAO,GAAG,EAAE,CACV,KAAK,CAAC,mBAAmB,KAAK,mBAAmB;QACjD,KAAK,CAAC,WAAW,KAAK,WAAW;QACjC,KAAK,CAAC,eAAe,KAAK,eAAe;QACzC,CAAC,8BAA8B,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC","sourcesContent":["import type { ContainerContentsStoreRuntime } from \"../syncAgent/syncAgentTypes\";\nimport type { ContainerContentsStoreState } from \"../types\";\n\nexport type ContainerWriteGuard = () => boolean;\n\nexport function didContainerWriteRuntimeChange(\n  previousRuntime: ContainerContentsStoreRuntime,\n  currentRuntime: ContainerContentsStoreRuntime,\n): boolean {\n  return (\n    previousRuntime.adoptRootContainer !== currentRuntime.adoptRootContainer ||\n    previousRuntime.apiClient !== currentRuntime.apiClient ||\n    previousRuntime.auth.defaultOrganizationId !==\n      currentRuntime.auth.defaultOrganizationId ||\n    previousRuntime.auth.isAuthenticated !==\n      currentRuntime.auth.isAuthenticated ||\n    previousRuntime.auth.organizationId !==\n      currentRuntime.auth.organizationId ||\n    previousRuntime.auth.userId !== currentRuntime.auth.userId ||\n    previousRuntime.crypto.encapsulationKeyPair !==\n      currentRuntime.crypto.encapsulationKeyPair ||\n    previousRuntime.crypto.signingFingerprint !==\n      currentRuntime.crypto.signingFingerprint ||\n    previousRuntime.crypto.signingKeyPair !==\n      currentRuntime.crypto.signingKeyPair ||\n    previousRuntime.infra.blobStore !== currentRuntime.infra.blobStore ||\n    previousRuntime.infra.dbStatus !== currentRuntime.infra.dbStatus ||\n    previousRuntime.infra.documentProjectors !==\n      currentRuntime.infra.documentProjectors ||\n    previousRuntime.infra.execSql !== currentRuntime.infra.execSql ||\n    previousRuntime.resolveTrustedUserIdentity !==\n      currentRuntime.resolveTrustedUserIdentity ||\n    previousRuntime.state.containerId !== currentRuntime.state.containerId ||\n    previousRuntime.state.domainScope !== currentRuntime.state.domainScope\n  );\n}\n\nexport function captureContainerWriteGeneration(\n  state: ContainerContentsStoreState,\n): ContainerWriteGuard {\n  const lifecycleGeneration = state.lifecycleGeneration;\n  const persistence = state.persistence;\n  const runtime = state.runtime;\n  const writeGeneration = state.writeGeneration;\n  return () =>\n    state.lifecycleGeneration === lifecycleGeneration &&\n    state.persistence === persistence &&\n    state.writeGeneration === writeGeneration &&\n    !didContainerWriteRuntimeChange(runtime, state.runtime);\n}\n"]}

package/stores/container-contents/state.d.ts

@@ -1,5 +1,5 @@
 import type { ContainerContentsPersistence } from "../../workflows/container-contents/containerPersistence.js";
-import type { ContainerContentsStoreRuntime, ContainerContentsStoreSyncAgent } from "./syncAgentTypes.js";
+import type { ContainerContentsStoreRuntime, ContainerContentsStoreSyncAgent } from "./syncAgent/syncAgentTypes.js";
 import type { ContainerContentsStoreState } from "./types.js";
 export declare function createContainerContentsStoreState(initialRuntime: ContainerContentsStoreRuntime, persistence: ContainerContentsPersistence, logLabel?: string | undefined): ContainerContentsStoreState;
 export declare function updateContainerContentsSnapshot(state: ContainerContentsStoreState): void;

package/stores/container-contents/state.js

@@ -1,8 +1,8 @@
 import { createContainerContentsProjectionUserKeyResolver, didContainerContentsProjectionKeyRuntimeChange, } from "../../workflows/container-contents/projectionKeys.js";
 import { didRegainSyncPrerequisites } from "../../workflows/container-contents/syncLane.js";
-import { ContainerStateMap } from "./containerStateMap.js";
+import { ContainerStateMap } from "./containerState/containerStateMap.js";
+import { didContainerWriteRuntimeChange } from "./remoteWrites/writeGeneration.js";
 import { getSnapshotNodes } from "./utils.js";
-import { didContainerWriteRuntimeChange } from "./writeGeneration.js";
 function areSyncStatesEqual(left, right) {
     return (left.lastError === right.lastError &&
         left.pendingAttachmentBytes === right.pendingAttachmentBytes &&

package/stores/container-contents/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["state.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContainerContentsPersistence } from \"../../workflows/container-contents/containerPersistence\";\nimport {\n  createContainerContentsProjectionUserKeyResolver,\n  didContainerContentsProjectionKeyRuntimeChange,\n} from \"../../workflows/container-contents/projectionKeys\";\nimport { didRegainSyncPrerequisites } from \"../../workflows/container-contents/syncLane\";\nimport { ContainerStateMap } from \"./containerStateMap\";\nimport type {\n  ContainerContentsStoreRuntime,\n  ContainerContentsStoreSyncAgent,\n} from \"./syncAgentTypes\";\nimport type {\n  ContainerContentsSnapshot,\n  ContainerContentsStoreState,\n  ContainerNode,\n} from \"./types\";\nimport { getSnapshotNodes } from \"./utils\";\nimport { didContainerWriteRuntimeChange } from \"./writeGeneration\";\n\nfunction areSyncStatesEqual(\n  left: ContainerNode[\"syncState\"],\n  right: ContainerNode[\"syncState\"],\n): boolean {\n  return (\n    left.lastError === right.lastError &&\n    left.pendingAttachmentBytes === right.pendingAttachmentBytes &&\n    left.pendingAttachmentCount === right.pendingAttachmentCount &&\n    left.pendingUpdateCount === right.pendingUpdateCount &&\n    left.status === right.status\n  );\n}\n\nfunction areSnapshotNodesEqual(\n  left: ReadonlyArray<ContainerNode>,\n  right: ReadonlyArray<ContainerNode>,\n): boolean {\n  if (left.length !== right.length) {\n    return false;\n  }\n\n  return left.every((leftNode, index) => {\n    const rightNode = right[index];\n    return (\n      rightNode !== undefined &&\n      leftNode.createdAt === rightNode.createdAt &&\n      leftNode.effectiveAccessLevel === rightNode.effectiveAccessLevel &&\n      leftNode.id === rightNode.id &&\n      leftNode.icon === rightNode.icon &&\n      leftNode.kind === rightNode.kind &&\n      leftNode.metadataDocumentId === rightNode.metadataDocumentId &&\n      leftNode.metadataReady === rightNode.metadataReady &&\n      leftNode.name === rightNode.name &&\n      leftNode.organizationId === rightNode.organizationId &&\n      leftNode.parentId === rightNode.parentId &&\n      areSyncStatesEqual(leftNode.syncState, rightNode.syncState) &&\n      leftNode.systemSlot === rightNode.systemSlot &&\n      leftNode.updatedAt === rightNode.updatedAt\n    );\n  });\n}\n\nfunction didStructuralRuntimeChange(\n  previousRuntime: ContainerContentsStoreRuntime,\n  nextRuntime: ContainerContentsStoreRuntime,\n): boolean {\n  // Structural sync also depends on connectivity and event delivery. Local\n  // writes use only the identity and storage checks shared below.\n  return (\n    didContainerWriteRuntimeChange(previousRuntime, nextRuntime) ||\n    previousRuntime.state.online !== nextRuntime.state.online ||\n    previousRuntime.state.peerScope !== nextRuntime.state.peerScope ||\n    previousRuntime.state.serverEventsConnectionGeneration !==\n      nextRuntime.state.serverEventsConnectionGeneration ||\n    previousRuntime.util.isRemoteSyncBlocked !==\n      nextRuntime.util.isRemoteSyncBlocked\n  );\n}\n\nexport function createContainerContentsStoreState(\n  initialRuntime: ContainerContentsStoreRuntime,\n  persistence: ContainerContentsPersistence,\n  logLabel?: string | undefined,\n): ContainerContentsStoreState {\n  return {\n    containersById: new ContainerStateMap(),\n    containerParentIdsNeedingHydration: new Set(),\n    documentStoresNeedPriming: true,\n    initializeGeneration: null,\n    initializePromise: null,\n    initialized: false,\n    localContainerRefreshPromise: null,\n    localContainerRefreshGeneration: null,\n    localContainerRefreshStructuralGeneration: null,\n    localContainersNeedRefresh: false,\n    lifecycleGeneration: 0,\n    lastEventCount: 0,\n    listeners: new Set(),\n    locallyAcceptedMetadataUpdateIds: new Set(),\n    logLabel,\n    metadataDocumentIdsNeedingSync: new Set(),\n    metadataSyncSignalSeqById: new Map(),\n    persistence,\n    remoteHydrationPromise: null,\n    remoteHydrationGeneration: null,\n    remoteHydrationStructuralGeneration: null,\n    remoteReconnectRefreshPending: false,\n    resolveProjectionUserKey:\n      createContainerContentsProjectionUserKeyResolver(initialRuntime),\n    rootLaneHydrated: false,\n    runtime: initialRuntime,\n    snapshot: {\n      nodes: [],\n      ready: false,\n    },\n    syncLane: null,\n    structuralGeneration: 0,\n    writeGeneration: 0,\n    writeChain: Promise.resolve<ContainerNode | null>(null),\n  };\n}\n\nfunction emitContainerContentsStore(state: ContainerContentsStoreState) {\n  for (const listener of state.listeners) {\n    listener();\n  }\n}\n\nfunction setContainerContentsSnapshot(\n  state: ContainerContentsStoreState,\n  next: ContainerContentsSnapshot,\n) {\n  if (\n    next.ready === state.snapshot.ready &&\n    areSnapshotNodesEqual(next.nodes, state.snapshot.nodes)\n  ) {\n    return;\n  }\n\n  state.snapshot = next;\n  emitContainerContentsStore(state);\n}\n\nexport function updateContainerContentsSnapshot(\n  state: ContainerContentsStoreState,\n) {\n  setContainerContentsSnapshot(state, {\n    nodes: getSnapshotNodes(state.containersById),\n    ready: true,\n  });\n}\n\nfunction resetContainerContentsStore(state: ContainerContentsStoreState) {\n  state.lifecycleGeneration += 1;\n  state.containersById = new ContainerStateMap();\n  state.containerParentIdsNeedingHydration = new Set();\n  state.documentStoresNeedPriming = true;\n  state.initialized = false;\n  state.localContainersNeedRefresh = false;\n  // Runtime events are snapshots, not a destructive queue. A replacement\n  // executor or persistence adapter has not observed any of them, even when\n  // their effects were already applied to the previous database. Replay the\n  // snapshot after replacement initialization rebuilds metadata identities.\n  state.lastEventCount = 0;\n  // Accepted-echo suppression state must not survive a reset: after a\n  // database loss the tree rehydrates from remote, and a retained id would\n  // suppress the next matching remote update signal. Mirrors\n  // clearDocumentStoreState in the document store lane.\n  state.locallyAcceptedMetadataUpdateIds = new Set();\n  state.metadataDocumentIdsNeedingSync = new Set();\n  state.metadataSyncSignalSeqById = new Map();\n  state.rootLaneHydrated = false;\n  state.writeChain = Promise.resolve<ContainerNode | null>(null);\n  setContainerContentsSnapshot(state, {\n    nodes: [],\n    ready: false,\n  });\n}\n\nexport function subscribeToContainerContentsStore(\n  state: ContainerContentsStoreState,\n  listener: () => void,\n) {\n  state.listeners.add(listener);\n  return () => state.listeners.delete(listener);\n}\n\nexport function updateContainerContentsStoreRuntime(\n  state: ContainerContentsStoreState,\n  nextRuntime: ContainerContentsStoreRuntime,\n  syncAgent: ContainerContentsStoreSyncAgent,\n) {\n  const previousRuntime = state.runtime;\n  const runtimeReplaced = didStructuralRuntimeChange(\n    previousRuntime,\n    nextRuntime,\n  );\n  if (didContainerWriteRuntimeChange(previousRuntime, nextRuntime)) {\n    state.writeGeneration += 1;\n  }\n  const executorReplaced =\n    previousRuntime.infra.execSql !== nextRuntime.infra.execSql;\n  const serverEventsConnectionChanged =\n    previousRuntime.state.serverEventsConnectionGeneration !==\n    nextRuntime.state.serverEventsConnectionGeneration;\n  if (runtimeReplaced) {\n    state.structuralGeneration += 1;\n    state.localContainersNeedRefresh = true;\n  }\n  const contextChanged =\n    previousRuntime.auth.organizationId !== nextRuntime.auth.organizationId ||\n    previousRuntime.state.containerId !== nextRuntime.state.containerId;\n  if (\n    didContainerContentsProjectionKeyRuntimeChange(previousRuntime, nextRuntime)\n  ) {\n    state.resolveProjectionUserKey =\n      createContainerContentsProjectionUserKeyResolver(nextRuntime);\n  }\n  state.runtime = nextRuntime;\n  if (serverEventsConnectionChanged) {\n    state.remoteReconnectRefreshPending = true;\n  }\n\n  if (nextRuntime.infra.dbStatus !== \"ready\") {\n    if (state.snapshot.ready || state.initialized || state.initializePromise) {\n      resetContainerContentsStore(state);\n    }\n    return;\n  }\n\n  if (executorReplaced) {\n    // The in-memory tree and lane markers belong to the previous executor.\n    // Rebuild them from the replacement database before any remote sync can\n    // observe or persist the old database's state.\n    resetContainerContentsStore(state);\n    syncAgent.ensureInitialized();\n    syncAgent.handleRemoteEvents();\n    return;\n  }\n\n  // Gaining authentication within a domain scope does not change identity\n  // (the scope is keyed on the signing fingerprint), so the locally-loaded\n  // tree stays valid. Reconcile it in place instead of resetting — resetting\n  // here is what blanked Explorer and forced a re-read on first open after\n  // register. Identity/storage changes are handled by scope rotation and the\n  // dbStatus-loss branch above.\n  if (\n    state.snapshot.ready &&\n    (contextChanged || didRegainSyncPrerequisites(previousRuntime, nextRuntime))\n  ) {\n    state.localContainersNeedRefresh = true;\n    state.documentStoresNeedPriming = true;\n    void syncAgent.refreshLocalContainers();\n    // The refresh alone does not run the sync lane; schedule it so newly\n    // eligible documents (e.g. this organization's orphans) prime now.\n    syncAgent.scheduleSync();\n  }\n\n  syncAgent.ensureInitialized();\n\n  syncAgent.handleRemoteEvents();\n\n  if (runtimeReplaced) {\n    void syncAgent.refreshLocalContainers();\n    syncAgent.scheduleSync();\n  }\n\n  consumePendingContainerContentsReconnectRefresh(state, syncAgent.refresh);\n\n  if (\n    state.snapshot.ready &&\n    didRegainSyncPrerequisites(previousRuntime, nextRuntime)\n  ) {\n    // A pass blocked by missing prerequisites consumes its lane request before\n    // returning early. Re-arm it directly when they return even if hydration\n    // finds no remote delta; this also primes unopened document stores.\n    syncAgent.scheduleSync();\n    syncAgent.scheduleRemoteHydration();\n  }\n}\n\nexport function consumePendingContainerContentsReconnectRefresh(\n  state: {\n    remoteReconnectRefreshPending: boolean;\n    snapshot: { ready: boolean };\n  },\n  refresh: () => Promise<boolean>,\n): void {\n  if (!state.snapshot.ready || !state.remoteReconnectRefreshPending) return;\n  state.remoteReconnectRefreshPending = false;\n  void refresh().then(\n    (refreshed) => {\n      if (!refreshed) state.remoteReconnectRefreshPending = true;\n    },\n    () => {\n      state.remoteReconnectRefreshPending = true;\n    },\n  );\n}\n\nexport function updateContainerContentsStorePersistence(\n  state: ContainerContentsStoreState,\n  nextPersistence: ContainerContentsPersistence,\n  syncAgent: ContainerContentsStoreSyncAgent,\n): void {\n  if (state.persistence === nextPersistence) {\n    return;\n  }\n  state.persistence = nextPersistence;\n  state.structuralGeneration += 1;\n  state.writeGeneration += 1;\n  // Persistence replacement changes the authoritative local data source even\n  // when the SQLite executor itself is stable. Clear storage-backed state and\n  // let initialization load the replacement before scheduling remote work.\n  resetContainerContentsStore(state);\n  syncAgent.ensureInitialized();\n}\n"]}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["state.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gDAAgD,EAChD,8CAA8C,GAC/C,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAUhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,SAAS,kBAAkB,CACzB,IAAgC,EAChC,KAAiC;IAEjC,OAAO,CACL,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QAClC,IAAI,CAAC,sBAAsB,KAAK,KAAK,CAAC,sBAAsB;QAC5D,IAAI,CAAC,sBAAsB,KAAK,KAAK,CAAC,sBAAsB;QAC5D,IAAI,CAAC,kBAAkB,KAAK,KAAK,CAAC,kBAAkB;QACpD,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAC7B,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAkC,EAClC,KAAmC;IAEnC,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QACpC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,CACL,SAAS,KAAK,SAAS;YACvB,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS;YAC1C,QAAQ,CAAC,oBAAoB,KAAK,SAAS,CAAC,oBAAoB;YAChE,QAAQ,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE;YAC5B,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;YAChC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;YAChC,QAAQ,CAAC,kBAAkB,KAAK,SAAS,CAAC,kBAAkB;YAC5D,QAAQ,CAAC,aAAa,KAAK,SAAS,CAAC,aAAa;YAClD,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;YAChC,QAAQ,CAAC,cAAc,KAAK,SAAS,CAAC,cAAc;YACpD,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ;YACxC,kBAAkB,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC;YAC3D,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,UAAU;YAC5C,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS,CAC3C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B,CACjC,eAA8C,EAC9C,WAA0C;IAE1C,yEAAyE;IACzE,gEAAgE;IAChE,OAAO,CACL,8BAA8B,CAAC,eAAe,EAAE,WAAW,CAAC;QAC5D,eAAe,CAAC,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,KAAK,CAAC,MAAM;QACzD,eAAe,CAAC,KAAK,CAAC,SAAS,KAAK,WAAW,CAAC,KAAK,CAAC,SAAS;QAC/D,eAAe,CAAC,KAAK,CAAC,gCAAgC;YACpD,WAAW,CAAC,KAAK,CAAC,gCAAgC;QACpD,eAAe,CAAC,IAAI,CAAC,mBAAmB;YACtC,WAAW,CAAC,IAAI,CAAC,mBAAmB,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,cAA6C,EAC7C,WAAyC,EACzC,QAA6B;IAE7B,OAAO;QACL,cAAc,EAAE,IAAI,iBAAiB,EAAE;QACvC,kCAAkC,EAAE,IAAI,GAAG,EAAE;QAC7C,yBAAyB,EAAE,IAAI;QAC/B,oBAAoB,EAAE,IAAI;QAC1B,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,KAAK;QAClB,4BAA4B,EAAE,IAAI;QAClC,+BAA+B,EAAE,IAAI;QACrC,yCAAyC,EAAE,IAAI;QAC/C,0BAA0B,EAAE,KAAK;QACjC,mBAAmB,EAAE,CAAC;QACtB,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE,IAAI,GAAG,EAAE;QACpB,gCAAgC,EAAE,IAAI,GAAG,EAAE;QAC3C,QAAQ;QACR,8BAA8B,EAAE,IAAI,GAAG,EAAE;QACzC,yBAAyB,EAAE,IAAI,GAAG,EAAE;QACpC,WAAW;QACX,sBAAsB,EAAE,IAAI;QAC5B,yBAAyB,EAAE,IAAI;QAC/B,mCAAmC,EAAE,IAAI;QACzC,6BAA6B,EAAE,KAAK;QACpC,wBAAwB,EACtB,gDAAgD,CAAC,cAAc,CAAC;QAClE,gBAAgB,EAAE,KAAK;QACvB,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE;YACR,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,KAAK;SACb;QACD,QAAQ,EAAE,IAAI;QACd,oBAAoB,EAAE,CAAC;QACvB,eAAe,EAAE,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC,OAAO,CAAuB,IAAI,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAkC;IACpE,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,QAAQ,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B,CACnC,KAAkC,EAClC,IAA+B;IAE/B,IACE,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,QAAQ,CAAC,KAAK;QACnC,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EACvD,CAAC;QACD,OAAO;IACT,CAAC;IAED,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IACtB,0BAA0B,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAkC;IAElC,4BAA4B,CAAC,KAAK,EAAE;QAClC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,cAAc,CAAC;QAC7C,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;AACL,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAkC;IACrE,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC;IAC/B,KAAK,CAAC,cAAc,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC/C,KAAK,CAAC,kCAAkC,GAAG,IAAI,GAAG,EAAE,CAAC;IACrD,KAAK,CAAC,yBAAyB,GAAG,IAAI,CAAC;IACvC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC;IAC1B,KAAK,CAAC,0BAA0B,GAAG,KAAK,CAAC;IACzC,uEAAuE;IACvE,0EAA0E;IAC1E,0EAA0E;IAC1E,0EAA0E;IAC1E,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC;IACzB,oEAAoE;IACpE,yEAAyE;IACzE,2DAA2D;IAC3D,sDAAsD;IACtD,KAAK,CAAC,gCAAgC,GAAG,IAAI,GAAG,EAAE,CAAC;IACnD,KAAK,CAAC,8BAA8B,GAAG,IAAI,GAAG,EAAE,CAAC;IACjD,KAAK,CAAC,yBAAyB,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5C,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC;IAC/B,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,CAAuB,IAAI,CAAC,CAAC;IAC/D,4BAA4B,CAAC,KAAK,EAAE;QAClC,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,KAAkC,EAClC,QAAoB;IAEpB,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,KAAkC,EAClC,WAA0C,EAC1C,SAA0C;IAE1C,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC;IACtC,MAAM,eAAe,GAAG,0BAA0B,CAChD,eAAe,EACf,WAAW,CACZ,CAAC;IACF,IAAI,8BAA8B,CAAC,eAAe,EAAE,WAAW,CAAC,EAAE,CAAC;QACjE,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,gBAAgB,GACpB,eAAe,CAAC,KAAK,CAAC,OAAO,KAAK,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC;IAC9D,MAAM,6BAA6B,GACjC,eAAe,CAAC,KAAK,CAAC,gCAAgC;QACtD,WAAW,CAAC,KAAK,CAAC,gCAAgC,CAAC;IACrD,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,CAAC,oBAAoB,IAAI,CAAC,CAAC;QAChC,KAAK,CAAC,0BAA0B,GAAG,IAAI,CAAC;IAC1C,CAAC;IACD,MAAM,cAAc,GAClB,eAAe,CAAC,IAAI,CAAC,cAAc,KAAK,WAAW,CAAC,IAAI,CAAC,cAAc;QACvE,eAAe,CAAC,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC;IACtE,IACE,8CAA8C,CAAC,eAAe,EAAE,WAAW,CAAC,EAC5E,CAAC;QACD,KAAK,CAAC,wBAAwB;YAC5B,gDAAgD,CAAC,WAAW,CAAC,CAAC;IAClE,CAAC;IACD,KAAK,CAAC,OAAO,GAAG,WAAW,CAAC;IAC5B,IAAI,6BAA6B,EAAE,CAAC;QAClC,KAAK,CAAC,6BAA6B,GAAG,IAAI,CAAC;IAC7C,CAAC;IAED,IAAI,WAAW,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YACzE,2BAA2B,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,gBAAgB,EAAE,CAAC;QACrB,uEAAuE;QACvE,wEAAwE;QACxE,+CAA+C;QAC/C,2BAA2B,CAAC,KAAK,CAAC,CAAC;QACnC,SAAS,CAAC,iBAAiB,EAAE,CAAC;QAC9B,SAAS,CAAC,kBAAkB,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,wEAAwE;IACxE,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,8BAA8B;IAC9B,IACE,KAAK,CAAC,QAAQ,CAAC,KAAK;QACpB,CAAC,cAAc,IAAI,0BAA0B,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,EAC5E,CAAC;QACD,KAAK,CAAC,0BAA0B,GAAG,IAAI,CAAC;QACxC,KAAK,CAAC,yBAAyB,GAAG,IAAI,CAAC;QACvC,KAAK,SAAS,CAAC,sBAAsB,EAAE,CAAC;QACxC,qEAAqE;QACrE,mEAAmE;QACnE,SAAS,CAAC,YAAY,EAAE,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,iBAAiB,EAAE,CAAC;IAE9B,SAAS,CAAC,kBAAkB,EAAE,CAAC;IAE/B,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,SAAS,CAAC,sBAAsB,EAAE,CAAC;QACxC,SAAS,CAAC,YAAY,EAAE,CAAC;IAC3B,CAAC;IAED,+CAA+C,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAE1E,IACE,KAAK,CAAC,QAAQ,CAAC,KAAK;QACpB,0BAA0B,CAAC,eAAe,EAAE,WAAW,CAAC,EACxD,CAAC;QACD,2EAA2E;QAC3E,yEAAyE;QACzE,oEAAoE;QACpE,SAAS,CAAC,YAAY,EAAE,CAAC;QACzB,SAAS,CAAC,uBAAuB,EAAE,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,+CAA+C,CAC7D,KAGC,EACD,OAA+B;IAE/B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,6BAA6B;QAAE,OAAO;IAC1E,KAAK,CAAC,6BAA6B,GAAG,KAAK,CAAC;IAC5C,KAAK,OAAO,EAAE,CAAC,IAAI,CACjB,CAAC,SAAS,EAAE,EAAE;QACZ,IAAI,CAAC,SAAS;YAAE,KAAK,CAAC,6BAA6B,GAAG,IAAI,CAAC;IAC7D,CAAC,EACD,GAAG,EAAE;QACH,KAAK,CAAC,6BAA6B,GAAG,IAAI,CAAC;IAC7C,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,KAAkC,EAClC,eAA6C,EAC7C,SAA0C;IAE1C,IAAI,KAAK,CAAC,WAAW,KAAK,eAAe,EAAE,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,KAAK,CAAC,WAAW,GAAG,eAAe,CAAC;IACpC,KAAK,CAAC,oBAAoB,IAAI,CAAC,CAAC;IAChC,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC;IAC3B,2EAA2E;IAC3E,4EAA4E;IAC5E,yEAAyE;IACzE,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACnC,SAAS,CAAC,iBAAiB,EAAE,CAAC;AAChC,CAAC","sourcesContent":["import type { ContainerContentsPersistence } from \"../../workflows/container-contents/containerPersistence\";\nimport {\n  createContainerContentsProjectionUserKeyResolver,\n  didContainerContentsProjectionKeyRuntimeChange,\n} from \"../../workflows/container-contents/projectionKeys\";\nimport { didRegainSyncPrerequisites } from \"../../workflows/container-contents/syncLane\";\nimport { ContainerStateMap } from \"./containerState/containerStateMap\";\nimport { didContainerWriteRuntimeChange } from \"./remoteWrites/writeGeneration\";\nimport type {\n  ContainerContentsStoreRuntime,\n  ContainerContentsStoreSyncAgent,\n} from \"./syncAgent/syncAgentTypes\";\nimport type {\n  ContainerContentsSnapshot,\n  ContainerContentsStoreState,\n  ContainerNode,\n} from \"./types\";\nimport { getSnapshotNodes } from \"./utils\";\n\nfunction areSyncStatesEqual(\n  left: ContainerNode[\"syncState\"],\n  right: ContainerNode[\"syncState\"],\n): boolean {\n  return (\n    left.lastError === right.lastError &&\n    left.pendingAttachmentBytes === right.pendingAttachmentBytes &&\n    left.pendingAttachmentCount === right.pendingAttachmentCount &&\n    left.pendingUpdateCount === right.pendingUpdateCount &&\n    left.status === right.status\n  );\n}\n\nfunction areSnapshotNodesEqual(\n  left: ReadonlyArray<ContainerNode>,\n  right: ReadonlyArray<ContainerNode>,\n): boolean {\n  if (left.length !== right.length) {\n    return false;\n  }\n\n  return left.every((leftNode, index) => {\n    const rightNode = right[index];\n    return (\n      rightNode !== undefined &&\n      leftNode.createdAt === rightNode.createdAt &&\n      leftNode.effectiveAccessLevel === rightNode.effectiveAccessLevel &&\n      leftNode.id === rightNode.id &&\n      leftNode.icon === rightNode.icon &&\n      leftNode.kind === rightNode.kind &&\n      leftNode.metadataDocumentId === rightNode.metadataDocumentId &&\n      leftNode.metadataReady === rightNode.metadataReady &&\n      leftNode.name === rightNode.name &&\n      leftNode.organizationId === rightNode.organizationId &&\n      leftNode.parentId === rightNode.parentId &&\n      areSyncStatesEqual(leftNode.syncState, rightNode.syncState) &&\n      leftNode.systemSlot === rightNode.systemSlot &&\n      leftNode.updatedAt === rightNode.updatedAt\n    );\n  });\n}\n\nfunction didStructuralRuntimeChange(\n  previousRuntime: ContainerContentsStoreRuntime,\n  nextRuntime: ContainerContentsStoreRuntime,\n): boolean {\n  // Structural sync also depends on connectivity and event delivery. Local\n  // writes use only the identity and storage checks shared below.\n  return (\n    didContainerWriteRuntimeChange(previousRuntime, nextRuntime) ||\n    previousRuntime.state.online !== nextRuntime.state.online ||\n    previousRuntime.state.peerScope !== nextRuntime.state.peerScope ||\n    previousRuntime.state.serverEventsConnectionGeneration !==\n      nextRuntime.state.serverEventsConnectionGeneration ||\n    previousRuntime.util.isRemoteSyncBlocked !==\n      nextRuntime.util.isRemoteSyncBlocked\n  );\n}\n\nexport function createContainerContentsStoreState(\n  initialRuntime: ContainerContentsStoreRuntime,\n  persistence: ContainerContentsPersistence,\n  logLabel?: string | undefined,\n): ContainerContentsStoreState {\n  return {\n    containersById: new ContainerStateMap(),\n    containerParentIdsNeedingHydration: new Set(),\n    documentStoresNeedPriming: true,\n    initializeGeneration: null,\n    initializePromise: null,\n    initialized: false,\n    localContainerRefreshPromise: null,\n    localContainerRefreshGeneration: null,\n    localContainerRefreshStructuralGeneration: null,\n    localContainersNeedRefresh: false,\n    lifecycleGeneration: 0,\n    lastEventCount: 0,\n    listeners: new Set(),\n    locallyAcceptedMetadataUpdateIds: new Set(),\n    logLabel,\n    metadataDocumentIdsNeedingSync: new Set(),\n    metadataSyncSignalSeqById: new Map(),\n    persistence,\n    remoteHydrationPromise: null,\n    remoteHydrationGeneration: null,\n    remoteHydrationStructuralGeneration: null,\n    remoteReconnectRefreshPending: false,\n    resolveProjectionUserKey:\n      createContainerContentsProjectionUserKeyResolver(initialRuntime),\n    rootLaneHydrated: false,\n    runtime: initialRuntime,\n    snapshot: {\n      nodes: [],\n      ready: false,\n    },\n    syncLane: null,\n    structuralGeneration: 0,\n    writeGeneration: 0,\n    writeChain: Promise.resolve<ContainerNode | null>(null),\n  };\n}\n\nfunction emitContainerContentsStore(state: ContainerContentsStoreState) {\n  for (const listener of state.listeners) {\n    listener();\n  }\n}\n\nfunction setContainerContentsSnapshot(\n  state: ContainerContentsStoreState,\n  next: ContainerContentsSnapshot,\n) {\n  if (\n    next.ready === state.snapshot.ready &&\n    areSnapshotNodesEqual(next.nodes, state.snapshot.nodes)\n  ) {\n    return;\n  }\n\n  state.snapshot = next;\n  emitContainerContentsStore(state);\n}\n\nexport function updateContainerContentsSnapshot(\n  state: ContainerContentsStoreState,\n) {\n  setContainerContentsSnapshot(state, {\n    nodes: getSnapshotNodes(state.containersById),\n    ready: true,\n  });\n}\n\nfunction resetContainerContentsStore(state: ContainerContentsStoreState) {\n  state.lifecycleGeneration += 1;\n  state.containersById = new ContainerStateMap();\n  state.containerParentIdsNeedingHydration = new Set();\n  state.documentStoresNeedPriming = true;\n  state.initialized = false;\n  state.localContainersNeedRefresh = false;\n  // Runtime events are snapshots, not a destructive queue. A replacement\n  // executor or persistence adapter has not observed any of them, even when\n  // their effects were already applied to the previous database. Replay the\n  // snapshot after replacement initialization rebuilds metadata identities.\n  state.lastEventCount = 0;\n  // Accepted-echo suppression state must not survive a reset: after a\n  // database loss the tree rehydrates from remote, and a retained id would\n  // suppress the next matching remote update signal. Mirrors\n  // clearDocumentStoreState in the document store lane.\n  state.locallyAcceptedMetadataUpdateIds = new Set();\n  state.metadataDocumentIdsNeedingSync = new Set();\n  state.metadataSyncSignalSeqById = new Map();\n  state.rootLaneHydrated = false;\n  state.writeChain = Promise.resolve<ContainerNode | null>(null);\n  setContainerContentsSnapshot(state, {\n    nodes: [],\n    ready: false,\n  });\n}\n\nexport function subscribeToContainerContentsStore(\n  state: ContainerContentsStoreState,\n  listener: () => void,\n) {\n  state.listeners.add(listener);\n  return () => state.listeners.delete(listener);\n}\n\nexport function updateContainerContentsStoreRuntime(\n  state: ContainerContentsStoreState,\n  nextRuntime: ContainerContentsStoreRuntime,\n  syncAgent: ContainerContentsStoreSyncAgent,\n) {\n  const previousRuntime = state.runtime;\n  const runtimeReplaced = didStructuralRuntimeChange(\n    previousRuntime,\n    nextRuntime,\n  );\n  if (didContainerWriteRuntimeChange(previousRuntime, nextRuntime)) {\n    state.writeGeneration += 1;\n  }\n  const executorReplaced =\n    previousRuntime.infra.execSql !== nextRuntime.infra.execSql;\n  const serverEventsConnectionChanged =\n    previousRuntime.state.serverEventsConnectionGeneration !==\n    nextRuntime.state.serverEventsConnectionGeneration;\n  if (runtimeReplaced) {\n    state.structuralGeneration += 1;\n    state.localContainersNeedRefresh = true;\n  }\n  const contextChanged =\n    previousRuntime.auth.organizationId !== nextRuntime.auth.organizationId ||\n    previousRuntime.state.containerId !== nextRuntime.state.containerId;\n  if (\n    didContainerContentsProjectionKeyRuntimeChange(previousRuntime, nextRuntime)\n  ) {\n    state.resolveProjectionUserKey =\n      createContainerContentsProjectionUserKeyResolver(nextRuntime);\n  }\n  state.runtime = nextRuntime;\n  if (serverEventsConnectionChanged) {\n    state.remoteReconnectRefreshPending = true;\n  }\n\n  if (nextRuntime.infra.dbStatus !== \"ready\") {\n    if (state.snapshot.ready || state.initialized || state.initializePromise) {\n      resetContainerContentsStore(state);\n    }\n    return;\n  }\n\n  if (executorReplaced) {\n    // The in-memory tree and lane markers belong to the previous executor.\n    // Rebuild them from the replacement database before any remote sync can\n    // observe or persist the old database's state.\n    resetContainerContentsStore(state);\n    syncAgent.ensureInitialized();\n    syncAgent.handleRemoteEvents();\n    return;\n  }\n\n  // Gaining authentication within a domain scope does not change identity\n  // (the scope is keyed on the signing fingerprint), so the locally-loaded\n  // tree stays valid. Reconcile it in place instead of resetting — resetting\n  // here is what blanked Explorer and forced a re-read on first open after\n  // register. Identity/storage changes are handled by scope rotation and the\n  // dbStatus-loss branch above.\n  if (\n    state.snapshot.ready &&\n    (contextChanged || didRegainSyncPrerequisites(previousRuntime, nextRuntime))\n  ) {\n    state.localContainersNeedRefresh = true;\n    state.documentStoresNeedPriming = true;\n    void syncAgent.refreshLocalContainers();\n    // The refresh alone does not run the sync lane; schedule it so newly\n    // eligible documents (e.g. this organization's orphans) prime now.\n    syncAgent.scheduleSync();\n  }\n\n  syncAgent.ensureInitialized();\n\n  syncAgent.handleRemoteEvents();\n\n  if (runtimeReplaced) {\n    void syncAgent.refreshLocalContainers();\n    syncAgent.scheduleSync();\n  }\n\n  consumePendingContainerContentsReconnectRefresh(state, syncAgent.refresh);\n\n  if (\n    state.snapshot.ready &&\n    didRegainSyncPrerequisites(previousRuntime, nextRuntime)\n  ) {\n    // A pass blocked by missing prerequisites consumes its lane request before\n    // returning early. Re-arm it directly when they return even if hydration\n    // finds no remote delta; this also primes unopened document stores.\n    syncAgent.scheduleSync();\n    syncAgent.scheduleRemoteHydration();\n  }\n}\n\nexport function consumePendingContainerContentsReconnectRefresh(\n  state: {\n    remoteReconnectRefreshPending: boolean;\n    snapshot: { ready: boolean };\n  },\n  refresh: () => Promise<boolean>,\n): void {\n  if (!state.snapshot.ready || !state.remoteReconnectRefreshPending) return;\n  state.remoteReconnectRefreshPending = false;\n  void refresh().then(\n    (refreshed) => {\n      if (!refreshed) state.remoteReconnectRefreshPending = true;\n    },\n    () => {\n      state.remoteReconnectRefreshPending = true;\n    },\n  );\n}\n\nexport function updateContainerContentsStorePersistence(\n  state: ContainerContentsStoreState,\n  nextPersistence: ContainerContentsPersistence,\n  syncAgent: ContainerContentsStoreSyncAgent,\n): void {\n  if (state.persistence === nextPersistence) {\n    return;\n  }\n  state.persistence = nextPersistence;\n  state.structuralGeneration += 1;\n  state.writeGeneration += 1;\n  // Persistence replacement changes the authoritative local data source even\n  // when the SQLite executor itself is stable. Clear storage-backed state and\n  // let initialization load the replacement before scheduling remote work.\n  resetContainerContentsStore(state);\n  syncAgent.ensureInitialized();\n}\n"]}

package/stores/container-contents/syncAgent/index.d.ts

@@ -0,0 +1,8 @@
+import type { RemoteContainerHydrationHost } from "../../../workflows/container-contents/remoteHydration/index.js";
+import type { ContainerContentsStoreSyncAgent, ContainerContentsStoreSyncState } from "./syncAgentTypes.js";
+export type { ContainerState } from "../../../workflows/container-contents/remoteHydration/index.js";
+export type { ContainerContentsStoreRuntime, ContainerContentsStoreSyncAgent, ContainerContentsStoreSyncState, RefreshRootLaneOptions, } from "./syncAgentTypes.js";
+export declare function createContainerContentsStoreSyncAgent(input: {
+    host: RemoteContainerHydrationHost;
+    state: ContainerContentsStoreSyncState;
+}): ContainerContentsStoreSyncAgent;