@tearleads/client-sdk 0.0.0-stage → 0.1.13

package/stores/container-contents/remoteContainerIngestion.js

@@ -0,0 +1,59 @@
+import { errorMessage } from "../../data/errorMessage.js";
+import { createRemoteContainerIngestor, } from "../../workflows/container-contents/remoteHydration.js";
+import { getContainerContentsStoreLogLabel } from "./logLabel.js";
+import { resumeContainerContentsRecoveryHydration } from "./remoteHydrationRequest.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/remoteContainerIngestion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteContainerIngestion.js","sourceRoot":"","sources":["remoteContainerIngestion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,6BAA6B,GAG9B,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,wCAAwC,EAAE,MAAM,0BAA0B,CAAC;AAQpF,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/errorMessage\";\nimport {\n  createRemoteContainerIngestor,\n  type RemoteContainer,\n  type RemoteContainerHydrationHost,\n} from \"../../workflows/container-contents/remoteHydration\";\nimport { getContainerContentsStoreLogLabel } from \"./logLabel\";\nimport { resumeContainerContentsRecoveryHydration } from \"./remoteHydrationRequest\";\nimport type { ContainerContentsStoreSyncState } from \"./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/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/remoteEventProjectionInvalidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteEventProjectionInvalidation.js","sourceRoot":"","sources":["remoteEventProjectionInvalidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,oEAAoE,CAAC;AAGpH;;;;;;;;;;;;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 \"./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/remoteEventSync.js

@@ -0,0 +1,38 @@
+import { listContainerParentIdsForEventHydration, listContainerProjectionInvalidationIds, } from "../../workflows/container-contents/containerEvents.js";
+import { listContainerMetadataDocumentUpdateIds } from "../../workflows/container-contents/metadata.js";
+import { observeContainerBackgroundHydration } from "./backgroundHydration.js";
+import { bumpMetadataSyncSeq } from "./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/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,oDAAoD,CAAC;AAC5D,OAAO,EAAE,sCAAsC,EAAE,MAAM,6CAA6C,CAAC;AACrG,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAGlF,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 \"./backgroundHydration\";\nimport { bumpMetadataSyncSeq } from \"./metadataSyncSignal\";\nimport { invalidateCachedProjections } from \"./remoteEventProjectionInvalidation\";\nimport type { ContainerContentsStoreSyncState } from \"./syncAgentTypes\";\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/remoteHydrationRefresh.js

@@ -0,0 +1,113 @@
+// Resolve the parent whose child lane the provisioned-system-container poll
+// should list to pull organization-born children (Trash) into the tree.
+//
+// It must NOT trust runtime.state.containerId: after a cold-cache login of an
+// already-registered user, that value is still the pre-auth device-first LOCAL
+// root (organizationId "", no remote metadata) — login() never adopts the server
+// root id, and reconcileLocalOnlyRootContainers later deletes the local root out
+// from under it. Listing that dead local root's child lane returns nothing, so
+// the poll never pulls Trash, never satisfies its stop condition, and spins its
+// whole retry budget churning the tree (the sidebar flicker).
+//
+// Prefer instead the reconciled server root already in the tree: the top-level
+// (parentId === null) container in the viewer's own organization that carries
+// remote metadata. Fall back to runtime.state.containerId when no such root is
+// loaded yet — the null discovery lane then surfaces it and hydrateRemoteContainers
+// crawls a freshly-discovered container's child lane within the same pass.
+function resolveActiveRootChildLaneParentId(state) {
+    const organizationId = state.runtime.auth.organizationId ?? null;
+    if (organizationId !== null) {
+        for (const { container } of state.containersById.values()) {
+            if (container.parentId === null &&
+                !container.systemSlot &&
+                container.organizationId === organizationId &&
+                (container.metadataDocumentId ?? null) !== null) {
+                return container.id;
+            }
+        }
+    }
+    return state.runtime.state.containerId;
+}
+function queueAllRemoteHydrationParentIds(state) {
+    state.containerParentIdsNeedingHydration.add(null);
+    for (const containerId of state.containersById.keys()) {
+        state.containerParentIdsNeedingHydration.add(containerId);
+    }
+}
+function canRefreshRemoteHydration(state) {
+    return (state.runtime.infra.dbStatus === "ready" &&
+        state.initialized &&
+        state.runtime.auth.isAuthenticated &&
+        state.runtime.state.online);
+}
+export function refreshAllRemoteHydration(input) {
+    const { requestHydration, state } = input;
+    if (!canRefreshRemoteHydration(state)) {
+        return Promise.resolve(false);
+    }
+    if (state.remoteHydrationPromise) {
+        queueAllRemoteHydrationParentIds(state);
+    }
+    // An explicit refresh always re-lists the root discovery lane from the start.
+    // A grant that makes a new top-level container reachable does not bump that
+    // container's updatedAt, so a persisted watermark would hide it forever.
+    return requestHydration({
+        followDiscoveredParentLanes: true,
+        onFullyHydrated: input.onFullyHydrated,
+        recreateOnFullyHydratedAfterReset: input.recreateOnFullyHydratedAfterReset,
+        ...(input.resetAllLaneWatermarks ? { resetAllLaneWatermarks: true } : {}),
+        resetRootLaneWatermark: true,
+        scheduleSyncAfterHydration: input.scheduleSyncAfterHydration ?? true,
+        ...(input.scheduleSyncOnHydrationChange === false
+            ? { scheduleSyncOnHydrationChange: false }
+            : {}),
+    }).then(() => true);
+}
+export function refreshRootRemoteHydration(input) {
+    const { requestHydration, state } = input;
+    if (!canRefreshRemoteHydration(state)) {
+        return Promise.resolve(false);
+    }
+    if (input.includeActiveRootChildLane) {
+        // Provisioned-system-container poll: it fires on a ~250ms interval until the
+        // org-born slot (Trash) surfaces. List the reconciled server root's child
+        // lane directly — resolved from the tree, NOT from runtime.state.containerId,
+        // which after a cold-cache login is still the pre-auth device-first local root
+        // that Trash does not live under — so Trash is pulled instead of the poll
+        // spinning on a dead lane. Crucially do NOT reset the root-lane watermark on
+        // this path: an unwatermarked re-list every tick makes hydrateRemoteContainers
+        // count every listed container as "changed", re-running
+        // updateSnapshot()+scheduleSync() on every tick and churning settling nodes'
+        // sync badges for the whole poll window — the sidebar "You"/Trash flicker. The
+        // stored watermark still surfaces Trash (a cold cache lists in full; a later
+        // arrival advances the child lane past it).
+        const activeRootChildLaneParentId = resolveActiveRootChildLaneParentId(state);
+        return requestHydration({
+            followDiscoveredParentLanes: false,
+            parentIds: activeRootChildLaneParentId
+                ? [null, activeRootChildLaneParentId]
+                : [null],
+        }).then(() => true);
+    }
+    // Automatic catch-up and the shared_with_you discovery event only need the
+    // top-level lane, but they DO re-list it unwatermarked: a root newly shared with
+    // the viewer does not bump the viewer's persisted root-lane watermark, so a
+    // watermarked list would hide it forever. hydrateRemoteContainers then crawls a
+    // freshly discovered root's child lane within the same pass. (The all-parent
+    // traversal stays reserved for explicit user refresh in refreshAllRemoteHydration.)
+    //
+    // The resync_required handler also passes the affected containers' parent lanes.
+    // A deleted nested container's tombstone is only returned by its
+    // parent lane (rootDiscoveryVisible=false), never the root lane, so re-listing
+    // that parent lane is what applies the tombstone and drops the stale container
+    // without falling back to the full crawl. Those parent lanes keep their persisted
+    // watermark (a deletion bumps the tombstone's updatedAt, so it still surfaces);
+    // only the root lane is unwatermarked, for the newly-shared-root case above.
+    const parentLanes = Array.from(new Set([null, ...(input.parentIds ?? [])]));
+    return requestHydration({
+        followDiscoveredParentLanes: false,
+        parentIds: parentLanes,
+        resetRootLaneWatermark: true,
+    }).then(() => true);
+}
+//# sourceMappingURL=remoteHydrationRefresh.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remoteHydrationRefresh.js","sourceRoot":"","sources":["remoteHydrationRefresh.ts"],"names":[],"mappings":"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","sourcesContent":["export interface RemoteHydrationRefreshOptions {\n  followDiscoveredParentLanes?: boolean | undefined;\n  onFullyHydrated?: (() => Promise<void> | void) | undefined;\n  parentIds?: ReadonlyArray<string | null> | undefined;\n  resetAllLaneWatermarks?: boolean | undefined;\n  resetRootLaneWatermark?: boolean | undefined;\n  recreateOnFullyHydratedAfterReset?:\n    | (() => () => Promise<void> | void)\n    | undefined;\n  scheduleSyncAfterHydration?: boolean | undefined;\n  scheduleSyncOnHydrationChange?: boolean | undefined;\n}\n\nexport type RemoteHydrationRequester = (\n  options: RemoteHydrationRefreshOptions,\n) => Promise<void>;\n\ninterface RemoteHydrationRefreshState {\n  containerParentIdsNeedingHydration: Set<string | null>;\n  containersById: ReadonlyMap<string, RefreshRootContainerLike>;\n  initialized: boolean;\n  remoteHydrationPromise: Promise<void> | null;\n  runtime: {\n    auth: {\n      isAuthenticated: boolean;\n      organizationId?: string | null | undefined;\n    };\n    infra: { dbStatus: string };\n    state: { containerId?: string | null | undefined; online: boolean };\n  };\n}\n\nexport interface RefreshRootContainerLike {\n  container: {\n    id: string;\n    metadataDocumentId?: string | null | undefined;\n    organizationId: string | null;\n    parentId: string | null;\n    systemSlot?: string | null | undefined;\n  };\n}\n\n// Resolve the parent whose child lane the provisioned-system-container poll\n// should list to pull organization-born children (Trash) into the tree.\n//\n// It must NOT trust runtime.state.containerId: after a cold-cache login of an\n// already-registered user, that value is still the pre-auth device-first LOCAL\n// root (organizationId \"\", no remote metadata) — login() never adopts the server\n// root id, and reconcileLocalOnlyRootContainers later deletes the local root out\n// from under it. Listing that dead local root's child lane returns nothing, so\n// the poll never pulls Trash, never satisfies its stop condition, and spins its\n// whole retry budget churning the tree (the sidebar flicker).\n//\n// Prefer instead the reconciled server root already in the tree: the top-level\n// (parentId === null) container in the viewer's own organization that carries\n// remote metadata. Fall back to runtime.state.containerId when no such root is\n// loaded yet — the null discovery lane then surfaces it and hydrateRemoteContainers\n// crawls a freshly-discovered container's child lane within the same pass.\nfunction resolveActiveRootChildLaneParentId(\n  state: RemoteHydrationRefreshState,\n): string | null | undefined {\n  const organizationId = state.runtime.auth.organizationId ?? null;\n  if (organizationId !== null) {\n    for (const { container } of state.containersById.values()) {\n      if (\n        container.parentId === null &&\n        !container.systemSlot &&\n        container.organizationId === organizationId &&\n        (container.metadataDocumentId ?? null) !== null\n      ) {\n        return container.id;\n      }\n    }\n  }\n\n  return state.runtime.state.containerId;\n}\n\nfunction queueAllRemoteHydrationParentIds(state: RemoteHydrationRefreshState) {\n  state.containerParentIdsNeedingHydration.add(null);\n  for (const containerId of state.containersById.keys()) {\n    state.containerParentIdsNeedingHydration.add(containerId);\n  }\n}\n\nfunction canRefreshRemoteHydration(\n  state: RemoteHydrationRefreshState,\n): boolean {\n  return (\n    state.runtime.infra.dbStatus === \"ready\" &&\n    state.initialized &&\n    state.runtime.auth.isAuthenticated &&\n    state.runtime.state.online\n  );\n}\n\nexport function refreshAllRemoteHydration(input: {\n  onFullyHydrated?: (() => Promise<void> | void) | undefined;\n  recreateOnFullyHydratedAfterReset?:\n    | (() => () => Promise<void> | void)\n    | undefined;\n  requestHydration: RemoteHydrationRequester;\n  resetAllLaneWatermarks?: boolean | undefined;\n  scheduleSyncAfterHydration?: boolean | undefined;\n  scheduleSyncOnHydrationChange?: boolean | undefined;\n  state: RemoteHydrationRefreshState;\n}): Promise<boolean> {\n  const { requestHydration, state } = input;\n  if (!canRefreshRemoteHydration(state)) {\n    return Promise.resolve(false);\n  }\n\n  if (state.remoteHydrationPromise) {\n    queueAllRemoteHydrationParentIds(state);\n  }\n\n  // An explicit refresh always re-lists the root discovery lane from the start.\n  // A grant that makes a new top-level container reachable does not bump that\n  // container's updatedAt, so a persisted watermark would hide it forever.\n  return requestHydration({\n    followDiscoveredParentLanes: true,\n    onFullyHydrated: input.onFullyHydrated,\n    recreateOnFullyHydratedAfterReset: input.recreateOnFullyHydratedAfterReset,\n    ...(input.resetAllLaneWatermarks ? { resetAllLaneWatermarks: true } : {}),\n    resetRootLaneWatermark: true,\n    scheduleSyncAfterHydration: input.scheduleSyncAfterHydration ?? true,\n    ...(input.scheduleSyncOnHydrationChange === false\n      ? { scheduleSyncOnHydrationChange: false }\n      : {}),\n  }).then(() => true);\n}\n\nexport function refreshRootRemoteHydration(input: {\n  includeActiveRootChildLane?: boolean | undefined;\n  parentIds?: ReadonlyArray<string | null> | undefined;\n  requestHydration: RemoteHydrationRequester;\n  state: RemoteHydrationRefreshState;\n}): Promise<boolean> {\n  const { requestHydration, state } = input;\n  if (!canRefreshRemoteHydration(state)) {\n    return Promise.resolve(false);\n  }\n\n  if (input.includeActiveRootChildLane) {\n    // Provisioned-system-container poll: it fires on a ~250ms interval until the\n    // org-born slot (Trash) surfaces. List the reconciled server root's child\n    // lane directly — resolved from the tree, NOT from runtime.state.containerId,\n    // which after a cold-cache login is still the pre-auth device-first local root\n    // that Trash does not live under — so Trash is pulled instead of the poll\n    // spinning on a dead lane. Crucially do NOT reset the root-lane watermark on\n    // this path: an unwatermarked re-list every tick makes hydrateRemoteContainers\n    // count every listed container as \"changed\", re-running\n    // updateSnapshot()+scheduleSync() on every tick and churning settling nodes'\n    // sync badges for the whole poll window — the sidebar \"You\"/Trash flicker. The\n    // stored watermark still surfaces Trash (a cold cache lists in full; a later\n    // arrival advances the child lane past it).\n    const activeRootChildLaneParentId =\n      resolveActiveRootChildLaneParentId(state);\n    return requestHydration({\n      followDiscoveredParentLanes: false,\n      parentIds: activeRootChildLaneParentId\n        ? [null, activeRootChildLaneParentId]\n        : [null],\n    }).then(() => true);\n  }\n\n  // Automatic catch-up and the shared_with_you discovery event only need the\n  // top-level lane, but they DO re-list it unwatermarked: a root newly shared with\n  // the viewer does not bump the viewer's persisted root-lane watermark, so a\n  // watermarked list would hide it forever. hydrateRemoteContainers then crawls a\n  // freshly discovered root's child lane within the same pass. (The all-parent\n  // traversal stays reserved for explicit user refresh in refreshAllRemoteHydration.)\n  //\n  // The resync_required handler also passes the affected containers' parent lanes.\n  // A deleted nested container's tombstone is only returned by its\n  // parent lane (rootDiscoveryVisible=false), never the root lane, so re-listing\n  // that parent lane is what applies the tombstone and drops the stale container\n  // without falling back to the full crawl. Those parent lanes keep their persisted\n  // watermark (a deletion bumps the tombstone's updatedAt, so it still surfaces);\n  // only the root lane is unwatermarked, for the newly-shared-root case above.\n  const parentLanes = Array.from(\n    new Set<string | null>([null, ...(input.parentIds ?? [])]),\n  );\n  return requestHydration({\n    followDiscoveredParentLanes: false,\n    parentIds: parentLanes,\n    resetRootLaneWatermark: true,\n  }).then(() => true);\n}\n"]}

package/stores/container-contents/remoteHydrationRequest.js

@@ -0,0 +1,245 @@
+import { createGenerationGuardedHydrationHost, hydrateRemoteContainers, StaleRemoteHydrationError, } from "../../workflows/container-contents/remoteHydration.js";
+import { isDatabaseUnavailableError } from "../../workflows/container-contents/syncLane.js";
+import { refreshLocalContainerStates, } from "./localRefresh.js";
+function isRequestGenerationCurrent(input) {
+    return (input.state.lifecycleGeneration === input.lifecycleGeneration &&
+        input.state.structuralGeneration === input.structuralGeneration);
+}
+const recoveryHydrationRequestsByState = new WeakMap();
+function queueRecoveryHydrationRequest(input) {
+    const requests = recoveryHydrationRequestsByState.get(input.state);
+    if (requests) {
+        if (!requests.some((request) => request.input === input)) {
+            requests.push({
+                input,
+                lifecycleGeneration: input.state.lifecycleGeneration,
+                structuralGeneration: input.state.structuralGeneration,
+            });
+        }
+        return;
+    }
+    recoveryHydrationRequestsByState.set(input.state, [
+        {
+            input,
+            lifecycleGeneration: input.state.lifecycleGeneration,
+            structuralGeneration: input.state.structuralGeneration,
+        },
+    ]);
+}
+function hasRemoteHydrationPrerequisites(state) {
+    return (state.runtime.infra.dbStatus === "ready" &&
+        state.runtime.auth.isAuthenticated &&
+        state.runtime.state.online);
+}
+function createResetRecoveryInput(input) {
+    return {
+        ...input,
+        followDiscoveredParentLanes: true,
+        onFullyHydrated: undefined,
+        parentIds: undefined,
+        recreateOnFullyHydratedAtStart: true,
+    };
+}
+function resumeRetainedRecoveryHydration(input) {
+    queueRecoveryHydrationRequest(input);
+    return hasRemoteHydrationPrerequisites(input.state)
+        ? input.resumeRecoveryWork()
+        : Promise.resolve();
+}
+function waitForActiveRemoteHydration(input) {
+    const { state } = input;
+    const activeHydration = state.remoteHydrationPromise;
+    if (!activeHydration) {
+        return null;
+    }
+    const requestLifecycleGeneration = state.lifecycleGeneration;
+    const requestStructuralGeneration = state.structuralGeneration;
+    const needsCurrentGenerationHydration = state.remoteHydrationGeneration !== state.lifecycleGeneration ||
+        state.remoteHydrationStructuralGeneration !== state.structuralGeneration;
+    const requestQueuedHydration = () => {
+        if (!isRequestGenerationCurrent({
+            lifecycleGeneration: requestLifecycleGeneration,
+            state,
+            structuralGeneration: requestStructuralGeneration,
+        })) {
+            return retryRemoteHydrationAfterReset(input);
+        }
+        return needsCurrentGenerationHydration ||
+            state.containerParentIdsNeedingHydration.size > 0
+            ? requestContainerContentsRemoteHydration(input)
+            : undefined;
+    };
+    return activeHydration.then(requestQueuedHydration, (error) => requestQueuedHydration() ?? Promise.reject(error));
+}
+function waitForActiveInitialization(input) {
+    const { state } = input;
+    const activeInitialization = state.initializePromise;
+    if (!activeInitialization) {
+        return null;
+    }
+    const requestLifecycleGeneration = state.lifecycleGeneration;
+    const requestStructuralGeneration = state.structuralGeneration;
+    return activeInitialization.then(() => {
+        const recoveryInput = isRequestGenerationCurrent({
+            lifecycleGeneration: requestLifecycleGeneration,
+            state,
+            structuralGeneration: requestStructuralGeneration,
+        })
+            ? input
+            : createResetRecoveryInput(input);
+        return resumeRetainedRecoveryHydration(recoveryInput);
+    });
+}
+function retryRemoteHydrationAfterReset(input) {
+    return resumeRetainedRecoveryHydration(createResetRecoveryInput(input));
+}
+function retainResetRecoveryHydration(input) {
+    queueRecoveryHydrationRequest(createResetRecoveryInput(input));
+}
+export function resumeContainerContentsRecoveryHydration(state) {
+    const requests = recoveryHydrationRequestsByState.get(state);
+    if (!requests) {
+        return null;
+    }
+    recoveryHydrationRequestsByState.delete(state);
+    const inputs = requests.map((request) => isRequestGenerationCurrent({
+        lifecycleGeneration: request.lifecycleGeneration,
+        state,
+        structuralGeneration: request.structuralGeneration,
+    })
+        ? request.input
+        : createResetRecoveryInput(request.input));
+    return Promise.all(inputs.map(requestContainerContentsRemoteHydration))
+        .then(() => undefined)
+        .catch((error) => {
+        for (const input of inputs) {
+            queueRecoveryHydrationRequest(input);
+        }
+        throw error;
+    });
+}
+function queueRequestedParentIds(input) {
+    if (!input.parentIds) {
+        return;
+    }
+    for (const parentId of input.parentIds) {
+        input.state.containerParentIdsNeedingHydration.add(parentId);
+    }
+}
+function waitForRemoteHydrationReadiness(input) {
+    const activeHydration = waitForActiveRemoteHydration(input);
+    if (activeHydration) {
+        return activeHydration;
+    }
+    const activeInitialization = waitForActiveInitialization(input);
+    if (activeInitialization) {
+        return activeInitialization;
+    }
+    if (!hasRemoteHydrationPrerequisites(input.state)) {
+        queueRecoveryHydrationRequest(input);
+        return Promise.resolve();
+    }
+    return null;
+}
+function consumeQueuedHydrationScope(state, followDiscoveredParentLanesOption) {
+    const queuedParentIds = Array.from(state.containerParentIdsNeedingHydration);
+    const followDiscoveredParentLanes = followDiscoveredParentLanesOption ?? queuedParentIds.length === 0;
+    state.containerParentIdsNeedingHydration.clear();
+    return {
+        followDiscoveredParentLanes,
+        parentIds: followDiscoveredParentLanes || queuedParentIds.length === 0
+            ? undefined
+            : queuedParentIds,
+    };
+}
+export function requestContainerContentsRemoteHydration(input) {
+    const { host, scheduleSync, state } = input;
+    queueRequestedParentIds(input);
+    const readinessBarrier = waitForRemoteHydrationReadiness(input);
+    if (readinessBarrier) {
+        return readinessBarrier;
+    }
+    const { followDiscoveredParentLanes, parentIds } = consumeQueuedHydrationScope(state, input.followDiscoveredParentLanes);
+    let appliedRemoteContainerChange = false;
+    let retainInterruptedHydration = false;
+    const lifecycleGeneration = state.lifecycleGeneration;
+    const structuralGeneration = state.structuralGeneration;
+    const isCurrent = () => isRequestGenerationCurrent({
+        lifecycleGeneration,
+        state,
+        structuralGeneration,
+    });
+    const onFullyHydrated = input.recreateOnFullyHydratedAtStart
+        ? input.recreateOnFullyHydratedAfterReset?.()
+        : input.onFullyHydrated;
+    const hydrationHost = createGenerationGuardedHydrationHost({
+        host,
+        isCurrent,
+    });
+    const rootLaneHydratedBeforeRequest = state.rootLaneHydrated;
+    state.remoteHydrationGeneration = lifecycleGeneration;
+    state.remoteHydrationStructuralGeneration = structuralGeneration;
+    const hydrationPromise = refreshLocalContainerStates({
+        host: hydrationHost,
+        state,
+    })
+        .then(() => {
+        if (!isCurrent()) {
+            return 0;
+        }
+        return hydrateRemoteContainers({
+            followDiscoveredParentLanes,
+            host: hydrationHost,
+            isCurrent,
+            onFullyHydrated,
+            parentIds,
+            resetAllLaneWatermarks: input.resetAllLaneWatermarks,
+            resetRootLaneWatermark: input.resetRootLaneWatermark,
+            state,
+        });
+    })
+        .then((changedCount) => {
+        appliedRemoteContainerChange = changedCount > 0;
+        if (isCurrent() && !hasRemoteHydrationPrerequisites(state)) {
+            retainInterruptedHydration = true;
+        }
+    })
+        .catch((error) => {
+        if (isCurrent() && isDatabaseUnavailableError(error)) {
+            retainInterruptedHydration = true;
+            return;
+        }
+        if (!isCurrent() || error instanceof StaleRemoteHydrationError) {
+            return;
+        }
+        throw error;
+    })
+        .finally(() => {
+        const shouldRetryAfterReset = !isCurrent();
+        if (state.remoteHydrationPromise === hydrationPromise) {
+            state.remoteHydrationPromise = null;
+            state.remoteHydrationGeneration = null;
+            state.remoteHydrationStructuralGeneration = null;
+        }
+        if (isCurrent() &&
+            (((input.scheduleSyncOnHydrationChange ?? true) &&
+                (appliedRemoteContainerChange ||
+                    (!rootLaneHydratedBeforeRequest && state.rootLaneHydrated))) ||
+                input.scheduleSyncAfterHydration) &&
+            state.snapshot.ready &&
+            state.runtime.auth.isAuthenticated &&
+            state.runtime.state.online) {
+            scheduleSync();
+        }
+        if (shouldRetryAfterReset) {
+            return retryRemoteHydrationAfterReset(input);
+        }
+        if (retainInterruptedHydration) {
+            retainResetRecoveryHydration(input);
+        }
+        return undefined;
+    });
+    state.remoteHydrationPromise = hydrationPromise;
+    return hydrationPromise;
+}
+//# sourceMappingURL=remoteHydrationRequest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remoteHydrationRequest.js","sourceRoot":"","sources":["remoteHydrationRequest.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createGenerationGuardedHydrationHost,\n  hydrateRemoteContainers,\n  type RemoteContainerHydrationHost,\n  StaleRemoteHydrationError,\n} from \"../../workflows/container-contents/remoteHydration\";\nimport type { RemoteContainerHydrationState } from \"../../workflows/container-contents/remoteHydration/types\";\nimport { isDatabaseUnavailableError } from \"../../workflows/container-contents/syncLane\";\nimport {\n  type LocalContainerRefreshState,\n  refreshLocalContainerStates,\n} from \"./localRefresh\";\n\ntype RemoteHydrationRequestState = RemoteContainerHydrationState &\n  LocalContainerRefreshState & {\n    containerParentIdsNeedingHydration: Set<string | null>;\n    initializePromise: Promise<void> | null;\n    lifecycleGeneration: number;\n    remoteHydrationGeneration: number | null;\n    remoteHydrationPromise: Promise<void> | null;\n    remoteHydrationStructuralGeneration: number | null;\n    rootLaneHydrated: boolean;\n    snapshot: {\n      ready: boolean;\n    };\n    structuralGeneration: number;\n  };\n\ninterface RemoteHydrationRequestInput {\n  followDiscoveredParentLanes?: boolean | undefined;\n  host: RemoteContainerHydrationHost;\n  onFullyHydrated?: (() => Promise<void> | void) | undefined;\n  parentIds?: ReadonlyArray<string | null> | undefined;\n  resetAllLaneWatermarks?: boolean | undefined;\n  resetRootLaneWatermark?: boolean | undefined;\n  recreateOnFullyHydratedAfterReset?:\n    | (() => () => Promise<void> | void)\n    | undefined;\n  recreateOnFullyHydratedAtStart?: boolean | undefined;\n  resumeRecoveryWork: () => Promise<void>;\n  scheduleSyncAfterHydration?: boolean | undefined;\n  scheduleSyncOnHydrationChange?: boolean | undefined;\n  scheduleSync: () => void;\n  state: RemoteHydrationRequestState;\n}\n\ninterface RecoveryHydrationRequest {\n  input: RemoteHydrationRequestInput;\n  lifecycleGeneration: number;\n  structuralGeneration: number;\n}\n\nfunction isRequestGenerationCurrent(input: {\n  lifecycleGeneration: number;\n  state: RemoteHydrationRequestState;\n  structuralGeneration: number;\n}): boolean {\n  return (\n    input.state.lifecycleGeneration === input.lifecycleGeneration &&\n    input.state.structuralGeneration === input.structuralGeneration\n  );\n}\n\nconst recoveryHydrationRequestsByState = new WeakMap<\n  RemoteHydrationRequestState,\n  RecoveryHydrationRequest[]\n>();\nfunction queueRecoveryHydrationRequest(\n  input: RemoteHydrationRequestInput,\n): void {\n  const requests = recoveryHydrationRequestsByState.get(input.state);\n  if (requests) {\n    if (!requests.some((request) => request.input === input)) {\n      requests.push({\n        input,\n        lifecycleGeneration: input.state.lifecycleGeneration,\n        structuralGeneration: input.state.structuralGeneration,\n      });\n    }\n    return;\n  }\n  recoveryHydrationRequestsByState.set(input.state, [\n    {\n      input,\n      lifecycleGeneration: input.state.lifecycleGeneration,\n      structuralGeneration: input.state.structuralGeneration,\n    },\n  ]);\n}\n\nfunction hasRemoteHydrationPrerequisites(\n  state: RemoteHydrationRequestState,\n): boolean {\n  return (\n    state.runtime.infra.dbStatus === \"ready\" &&\n    state.runtime.auth.isAuthenticated &&\n    state.runtime.state.online\n  );\n}\n\nfunction createResetRecoveryInput(\n  input: RemoteHydrationRequestInput,\n): RemoteHydrationRequestInput {\n  return {\n    ...input,\n    followDiscoveredParentLanes: true,\n    onFullyHydrated: undefined,\n    parentIds: undefined,\n    recreateOnFullyHydratedAtStart: true,\n  };\n}\n\nfunction resumeRetainedRecoveryHydration(\n  input: RemoteHydrationRequestInput,\n): Promise<void> {\n  queueRecoveryHydrationRequest(input);\n  return hasRemoteHydrationPrerequisites(input.state)\n    ? input.resumeRecoveryWork()\n    : Promise.resolve();\n}\n\nfunction waitForActiveRemoteHydration(\n  input: RemoteHydrationRequestInput,\n): Promise<void> | null {\n  const { state } = input;\n  const activeHydration = state.remoteHydrationPromise;\n  if (!activeHydration) {\n    return null;\n  }\n  const requestLifecycleGeneration = state.lifecycleGeneration;\n  const requestStructuralGeneration = state.structuralGeneration;\n  const needsCurrentGenerationHydration =\n    state.remoteHydrationGeneration !== state.lifecycleGeneration ||\n    state.remoteHydrationStructuralGeneration !== state.structuralGeneration;\n  const requestQueuedHydration = () => {\n    if (\n      !isRequestGenerationCurrent({\n        lifecycleGeneration: requestLifecycleGeneration,\n        state,\n        structuralGeneration: requestStructuralGeneration,\n      })\n    ) {\n      return retryRemoteHydrationAfterReset(input);\n    }\n    return needsCurrentGenerationHydration ||\n      state.containerParentIdsNeedingHydration.size > 0\n      ? requestContainerContentsRemoteHydration(input)\n      : undefined;\n  };\n  return activeHydration.then(\n    requestQueuedHydration,\n    (error: unknown) => requestQueuedHydration() ?? Promise.reject(error),\n  );\n}\n\nfunction waitForActiveInitialization(\n  input: RemoteHydrationRequestInput,\n): Promise<void> | null {\n  const { state } = input;\n  const activeInitialization = state.initializePromise;\n  if (!activeInitialization) {\n    return null;\n  }\n  const requestLifecycleGeneration = state.lifecycleGeneration;\n  const requestStructuralGeneration = state.structuralGeneration;\n  return activeInitialization.then(() => {\n    const recoveryInput = isRequestGenerationCurrent({\n      lifecycleGeneration: requestLifecycleGeneration,\n      state,\n      structuralGeneration: requestStructuralGeneration,\n    })\n      ? input\n      : createResetRecoveryInput(input);\n    return resumeRetainedRecoveryHydration(recoveryInput);\n  });\n}\n\nfunction retryRemoteHydrationAfterReset(\n  input: RemoteHydrationRequestInput,\n): Promise<void> {\n  return resumeRetainedRecoveryHydration(createResetRecoveryInput(input));\n}\n\nfunction retainResetRecoveryHydration(\n  input: RemoteHydrationRequestInput,\n): void {\n  queueRecoveryHydrationRequest(createResetRecoveryInput(input));\n}\n\nexport function resumeContainerContentsRecoveryHydration(\n  state: RemoteHydrationRequestState,\n): Promise<void> | null {\n  const requests = recoveryHydrationRequestsByState.get(state);\n  if (!requests) {\n    return null;\n  }\n  recoveryHydrationRequestsByState.delete(state);\n  const inputs = requests.map((request) =>\n    isRequestGenerationCurrent({\n      lifecycleGeneration: request.lifecycleGeneration,\n      state,\n      structuralGeneration: request.structuralGeneration,\n    })\n      ? request.input\n      : createResetRecoveryInput(request.input),\n  );\n  return Promise.all(inputs.map(requestContainerContentsRemoteHydration))\n    .then(() => undefined)\n    .catch((error: unknown) => {\n      for (const input of inputs) {\n        queueRecoveryHydrationRequest(input);\n      }\n      throw error;\n    });\n}\n\nfunction queueRequestedParentIds(input: RemoteHydrationRequestInput): void {\n  if (!input.parentIds) {\n    return;\n  }\n  for (const parentId of input.parentIds) {\n    input.state.containerParentIdsNeedingHydration.add(parentId);\n  }\n}\n\nfunction waitForRemoteHydrationReadiness(\n  input: RemoteHydrationRequestInput,\n): Promise<void> | null {\n  const activeHydration = waitForActiveRemoteHydration(input);\n  if (activeHydration) {\n    return activeHydration;\n  }\n  const activeInitialization = waitForActiveInitialization(input);\n  if (activeInitialization) {\n    return activeInitialization;\n  }\n  if (!hasRemoteHydrationPrerequisites(input.state)) {\n    queueRecoveryHydrationRequest(input);\n    return Promise.resolve();\n  }\n  return null;\n}\n\nfunction consumeQueuedHydrationScope(\n  state: RemoteHydrationRequestState,\n  followDiscoveredParentLanesOption: boolean | undefined,\n): {\n  followDiscoveredParentLanes: boolean;\n  parentIds: ReadonlyArray<string | null> | undefined;\n} {\n  const queuedParentIds = Array.from(state.containerParentIdsNeedingHydration);\n  const followDiscoveredParentLanes =\n    followDiscoveredParentLanesOption ?? queuedParentIds.length === 0;\n  state.containerParentIdsNeedingHydration.clear();\n  return {\n    followDiscoveredParentLanes,\n    parentIds:\n      followDiscoveredParentLanes || queuedParentIds.length === 0\n        ? undefined\n        : queuedParentIds,\n  };\n}\n\nexport function requestContainerContentsRemoteHydration(\n  input: RemoteHydrationRequestInput,\n): Promise<void> {\n  const { host, scheduleSync, state } = input;\n  queueRequestedParentIds(input);\n  const readinessBarrier = waitForRemoteHydrationReadiness(input);\n  if (readinessBarrier) {\n    return readinessBarrier;\n  }\n\n  const { followDiscoveredParentLanes, parentIds } =\n    consumeQueuedHydrationScope(state, input.followDiscoveredParentLanes);\n\n  let appliedRemoteContainerChange = false;\n  let retainInterruptedHydration = false;\n  const lifecycleGeneration = state.lifecycleGeneration;\n  const structuralGeneration = state.structuralGeneration;\n  const isCurrent = () =>\n    isRequestGenerationCurrent({\n      lifecycleGeneration,\n      state,\n      structuralGeneration,\n    });\n  const onFullyHydrated = input.recreateOnFullyHydratedAtStart\n    ? input.recreateOnFullyHydratedAfterReset?.()\n    : input.onFullyHydrated;\n  const hydrationHost = createGenerationGuardedHydrationHost({\n    host,\n    isCurrent,\n  });\n  const rootLaneHydratedBeforeRequest = state.rootLaneHydrated;\n  state.remoteHydrationGeneration = lifecycleGeneration;\n  state.remoteHydrationStructuralGeneration = structuralGeneration;\n  const hydrationPromise = refreshLocalContainerStates({\n    host: hydrationHost,\n    state,\n  })\n    .then(() => {\n      if (!isCurrent()) {\n        return 0;\n      }\n      return hydrateRemoteContainers({\n        followDiscoveredParentLanes,\n        host: hydrationHost,\n        isCurrent,\n        onFullyHydrated,\n        parentIds,\n        resetAllLaneWatermarks: input.resetAllLaneWatermarks,\n        resetRootLaneWatermark: input.resetRootLaneWatermark,\n        state,\n      });\n    })\n    .then((changedCount) => {\n      appliedRemoteContainerChange = changedCount > 0;\n      if (isCurrent() && !hasRemoteHydrationPrerequisites(state)) {\n        retainInterruptedHydration = true;\n      }\n    })\n    .catch((error: unknown) => {\n      if (isCurrent() && isDatabaseUnavailableError(error)) {\n        retainInterruptedHydration = true;\n        return;\n      }\n      if (!isCurrent() || error instanceof StaleRemoteHydrationError) {\n        return;\n      }\n\n      throw error;\n    })\n    .finally(() => {\n      const shouldRetryAfterReset = !isCurrent();\n      if (state.remoteHydrationPromise === hydrationPromise) {\n        state.remoteHydrationPromise = null;\n        state.remoteHydrationGeneration = null;\n        state.remoteHydrationStructuralGeneration = null;\n      }\n\n      if (\n        isCurrent() &&\n        (((input.scheduleSyncOnHydrationChange ?? true) &&\n          (appliedRemoteContainerChange ||\n            (!rootLaneHydratedBeforeRequest && state.rootLaneHydrated))) ||\n          input.scheduleSyncAfterHydration) &&\n        state.snapshot.ready &&\n        state.runtime.auth.isAuthenticated &&\n        state.runtime.state.online\n      ) {\n        scheduleSync();\n      }\n      if (shouldRetryAfterReset) {\n        return retryRemoteHydrationAfterReset(input);\n      }\n      if (retainInterruptedHydration) {\n        retainResetRecoveryHydration(input);\n      }\n      return undefined;\n    });\n  state.remoteHydrationPromise = hydrationPromise;\n\n  return hydrationPromise;\n}\n"]}