@tearleads/client-sdk 0.1.63 → 0.1.65

package/stores/container-contents/containerState/reconcilableContainer.d.ts

@@ -0,0 +1,48 @@
+import type { ContainerNode } from "../types.js";
+/**
+ * Whether a container is a system container — one tagged with a deterministic
+ * `systemSlot` for a built-in role such as Contacts, Trash, organization
+ * metadata, or the per-organization roster.
+ */
+export declare function isSystemContainerNode(node: Pick<ContainerNode, "systemSlot">): boolean;
+/** Whether a container has completed enough remote creation to be listed. */
+export declare function isRemoteBackedContainerNode(node: Pick<ContainerNode, "metadataDocumentId">): boolean;
+/**
+ * Whether generic document reconciliation may safely list this container.
+ *
+ * Every container joins generic reconciliation only after remote creation has
+ * given it a metadata document id. This keeps local-first roots and children
+ * out of an HTTP lane that cannot exist yet, while still letting another device
+ * rematerialize Contacts, Trash, and other system data.
+ */
+export declare function isReconcilableContainerNode(node: Pick<ContainerNode, "effectiveAccessLevel" | "metadataDocumentId" | "organizationId" | "systemSlot">, homeOrganizationId: string | null): boolean;
+/**
+ * Whether a root-lane discovery hint should re-list this container's documents.
+ *
+ * The server's root discovery lane can return directly granted non-root
+ * containers, so every remote-backed regular container remains eligible
+ * regardless of its parent. Membership-visible foreign system containers
+ * remain eligible for catch-up. Own system children are excluded here because
+ * cold/auth backfill and explicit full refresh already reconcile them; sweeping
+ * them on every Explorer-open or shared-root hint creates redundant work.
+ */
+export declare function isAutomaticRootCatchupContainerNode(node: Pick<ContainerNode, "effectiveAccessLevel" | "metadataDocumentId" | "organizationId" | "systemSlot">, homeOrganizationId: string | null): boolean;
+/**
+ * Whether a system container belongs to a foreign organization whose contents
+ * are visible through membership-level access.
+ *
+ * Event routing uses this classification for foreign system content whose
+ * already-known document updates must still force discovery. It is not the
+ * generic sweep predicate: remote-backed own system containers also reconcile
+ * via {@link isReconcilableContainerNode}. A foreign system container is one
+ * that is:
+ *
+ *  - a different org's (`organizationId !== homeOrganizationId`). Own system
+ *    containers are outside this foreign-system classification, while a
+ *    container mid-creation has an empty organization id that matches nothing
+ *    (as does a null/unhydrated home org).
+ *  - granted at a *membership* level — `read` (Members group) or `admin`
+ *    (Admins group). A plain `write` share of a folder does not make the sharee
+ *    a member, so it does not opt that folder into automatic root catch-up.
+ */
+export declare function isForeignSystemContainerNode(node: Pick<ContainerNode, "systemSlot" | "organizationId" | "effectiveAccessLevel">, homeOrganizationId: string | null): boolean;

package/stores/container-contents/containerState/reconcilableContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcilableContainer.js","sourceRoot":"","sources":["reconcilableContainer.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAuC;IAEvC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;AAC3B,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,2BAA2B,CACzC,IAA+C;IAE/C,OAAO,CACL,OAAO,IAAI,CAAC,kBAAkB,KAAK,QAAQ;QAC3C,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CACnC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAMC,EACD,kBAAiC;IAEjC,wEAAwE;IACxE,uEAAuE;IACvE,2EAA2E;IAC3E,uEAAuE;IACvE,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,kBAAkB,KAAK,IAAI;QAC3B,CAAC,IAAI,CAAC,cAAc,KAAK,kBAAkB;YACzC,4BAA4B,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mCAAmC,CACjD,IAMC,EACD,kBAAiC;IAEjC,OAAO,CACL,2BAA2B,CAAC,IAAI,CAAC;QACjC,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC;YAC3B,4BAA4B,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAGC,EACD,kBAAiC;IAEjC,OAAO,CACL,qBAAqB,CAAC,IAAI,CAAC;QAC3B,kBAAkB,KAAK,IAAI;QAC3B,CAAC,CAAC,IAAI,CAAC,cAAc;QACrB,IAAI,CAAC,cAAc,KAAK,kBAAkB;QAC1C,CAAC,IAAI,CAAC,oBAAoB,KAAK,MAAM;YACnC,IAAI,CAAC,oBAAoB,KAAK,OAAO,CAAC,CACzC,CAAC;AACJ,CAAC","sourcesContent":["import type { ContainerNode } from \"../types\";\n\n/**\n * Whether a container is a system container — one tagged with a deterministic\n * `systemSlot` for a built-in role such as Contacts, Trash, organization\n * metadata, or the per-organization roster.\n */\nexport function isSystemContainerNode(\n  node: Pick<ContainerNode, \"systemSlot\">,\n): boolean {\n  return !!node.systemSlot;\n}\n\n/** Whether a container has completed enough remote creation to be listed. */\nexport function isRemoteBackedContainerNode(\n  node: Pick<ContainerNode, \"metadataDocumentId\">,\n): boolean {\n  return (\n    typeof node.metadataDocumentId === \"string\" &&\n    node.metadataDocumentId.length > 0\n  );\n}\n\n/**\n * Whether generic document reconciliation may safely list this container.\n *\n * Every container joins generic reconciliation only after remote creation has\n * given it a metadata document id. This keeps local-first roots and children\n * out of an HTTP lane that cannot exist yet, while still letting another device\n * rematerialize Contacts, Trash, and other system data.\n */\nexport function isReconcilableContainerNode(\n  node: Pick<\n    ContainerNode,\n    | \"effectiveAccessLevel\"\n    | \"metadataDocumentId\"\n    | \"organizationId\"\n    | \"systemSlot\"\n  >,\n  homeOrganizationId: string | null,\n): boolean {\n  // Document discovery is an HTTP read against the remote container id. A\n  // local-first container has no such lane until its metadata create has\n  // committed; attempting to list it can only produce a 404. This applies to\n  // the pre-auth local root just as much as to a local system container.\n  if (!isRemoteBackedContainerNode(node)) {\n    return false;\n  }\n\n  if (!isSystemContainerNode(node)) {\n    return true;\n  }\n\n  return (\n    homeOrganizationId !== null &&\n    (node.organizationId === homeOrganizationId ||\n      isForeignSystemContainerNode(node, homeOrganizationId))\n  );\n}\n\n/**\n * Whether a root-lane discovery hint should re-list this container's documents.\n *\n * The server's root discovery lane can return directly granted non-root\n * containers, so every remote-backed regular container remains eligible\n * regardless of its parent. Membership-visible foreign system containers\n * remain eligible for catch-up. Own system children are excluded here because\n * cold/auth backfill and explicit full refresh already reconcile them; sweeping\n * them on every Explorer-open or shared-root hint creates redundant work.\n */\nexport function isAutomaticRootCatchupContainerNode(\n  node: Pick<\n    ContainerNode,\n    | \"effectiveAccessLevel\"\n    | \"metadataDocumentId\"\n    | \"organizationId\"\n    | \"systemSlot\"\n  >,\n  homeOrganizationId: string | null,\n): boolean {\n  return (\n    isRemoteBackedContainerNode(node) &&\n    (!isSystemContainerNode(node) ||\n      isForeignSystemContainerNode(node, homeOrganizationId))\n  );\n}\n\n/**\n * Whether a system container belongs to a foreign organization whose contents\n * are visible through membership-level access.\n *\n * Event routing uses this classification for foreign system content whose\n * already-known document updates must still force discovery. It is not the\n * generic sweep predicate: remote-backed own system containers also reconcile\n * via {@link isReconcilableContainerNode}. A foreign system container is one\n * that is:\n *\n *  - a different org's (`organizationId !== homeOrganizationId`). Own system\n *    containers are outside this foreign-system classification, while a\n *    container mid-creation has an empty organization id that matches nothing\n *    (as does a null/unhydrated home org).\n *  - granted at a *membership* level — `read` (Members group) or `admin`\n *    (Admins group). A plain `write` share of a folder does not make the sharee\n *    a member, so it does not opt that folder into automatic root catch-up.\n */\nexport function isForeignSystemContainerNode(\n  node: Pick<\n    ContainerNode,\n    \"systemSlot\" | \"organizationId\" | \"effectiveAccessLevel\"\n  >,\n  homeOrganizationId: string | null,\n): boolean {\n  return (\n    isSystemContainerNode(node) &&\n    homeOrganizationId !== null &&\n    !!node.organizationId &&\n    node.organizationId !== homeOrganizationId &&\n    (node.effectiveAccessLevel === \"read\" ||\n      node.effectiveAccessLevel === \"admin\")\n  );\n}\n"]}

package/stores/container-contents/documentWork/documentRecovery.js

@@ -0,0 +1,114 @@
+import { primeDocumentsForContainerSubtree, primeDocumentsForLoadedRoots, } from "../../../workflows/container-contents/documentPriming/index.js";
+import { recoverStaleSessionRoot } from "../../../workflows/container-contents/recovery/staleRootRecovery.js";
+import { createContainerContentsDocumentsRuntime, } from "../../../workflows/container-contents/runtime.js";
+import { isDatabaseUnavailableError } from "../../../workflows/container-contents/syncLane.js";
+import { openDocumentStore } from "../../documents/index.js";
+import { getContainerContentsStoreLogLabel } from "../logLabel.js";
+const staleRootRecoveryLogState = new WeakMap();
+const rejectedAdoptionRuntime = new WeakMap();
+function createPrimeHost(runtime) {
+    return {
+        documentWorkflowRuntime: (containerId) => createContainerContentsDocumentsRuntime(runtime, containerId),
+        openDocumentStore: ({ documentId, localId, runtime, }) => openDocumentStore(runtime.state.domainScope, localId, runtime, documentId),
+    };
+}
+export async function primeStoreDocumentSubtree(state, rootContainerId, isCurrent = () => true) {
+    if (!isCurrent())
+        return;
+    const runtime = state.runtime;
+    await primeDocumentsForContainerSubtree({
+        containersById: state.containersById,
+        host: createPrimeHost(runtime),
+        isCurrent,
+        rootContainerId,
+        runtime,
+    });
+}
+export async function primeStoreDocuments(state, isCurrent = () => true) {
+    if (!isCurrent())
+        return;
+    const runtime = state.runtime;
+    // Consume the current signal before scanning. A topology/root reconciliation
+    // that lands during an awaited query can then re-arm the next pass without
+    // this pass erasing that newer signal when it completes.
+    state.documentStoresNeedPriming = false;
+    try {
+        const result = await primeDocumentsForLoadedRoots({
+            containersById: state.containersById,
+            host: createPrimeHost(runtime),
+            isCurrent,
+            organizationId: runtime.auth?.organizationId ?? null,
+            runtime,
+        });
+        if (!isCurrent()) {
+            state.documentStoresNeedPriming = true;
+            return;
+        }
+        runtime.util.log(`${getContainerContentsStoreLogLabel(state)}: document priming candidates=${result.candidateCount} roots=${result.rootCount} primed=${result.primedCount} orphaned=${result.orphanPrimedCount} unroutable=${result.unroutableCount}`);
+    }
+    catch (error) {
+        if (!isCurrent()) {
+            state.documentStoresNeedPriming = true;
+            return;
+        }
+        state.documentStoresNeedPriming = true;
+        throw error;
+    }
+}
+export async function recoverStoreStaleRoot(state, isCurrent = () => true) {
+    if (!isCurrent()) {
+        return "context-changed";
+    }
+    const runtime = state.runtime;
+    if (rejectedAdoptionRuntime.get(state) === runtime) {
+        return "not-needed";
+    }
+    let result;
+    try {
+        result = await recoverStaleSessionRoot({ ...state, runtime }, isCurrent);
+    }
+    catch (error) {
+        if (!isCurrent()) {
+            return "context-changed";
+        }
+        if (isDatabaseUnavailableError(error)) {
+            throw error;
+        }
+        const message = `${getContainerContentsStoreLogLabel(state)}: stale root recovery failed`;
+        if (state.runtime.util.logError) {
+            state.runtime.util.logError(message, error);
+        }
+        else {
+            state.runtime.util.log(message);
+        }
+        return "not-needed";
+    }
+    if (!isCurrent()) {
+        return "context-changed";
+    }
+    const message = `${getContainerContentsStoreLogLabel(state)}: stale root recovery status=${result.status} candidates=${result.candidateCount}`;
+    const previousLogState = staleRootRecoveryLogState.get(state);
+    const occurrenceCount = previousLogState?.message === message
+        ? previousLogState.occurrenceCount + 1
+        : 1;
+    staleRootRecoveryLogState.set(state, { message, occurrenceCount });
+    if (result.status !== "not-needed") {
+        if (occurrenceCount === 1) {
+            runtime.util.log(message);
+        }
+        else if ((occurrenceCount & (occurrenceCount - 1)) === 0) {
+            runtime.util.log(`${message} occurrences=${occurrenceCount}`);
+        }
+    }
+    if (result.status === "context-changed") {
+        rejectedAdoptionRuntime.set(state, runtime);
+    }
+    else {
+        rejectedAdoptionRuntime.delete(state);
+    }
+    if (result.reassigned) {
+        state.documentStoresNeedPriming = true;
+    }
+    return result.status;
+}
+//# sourceMappingURL=documentRecovery.js.map

package/stores/container-contents/documentWork/documentRecovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentRecovery.js","sourceRoot":"","sources":["documentRecovery.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContainerContentsPersistence } from \"../../../workflows/container-contents/containerPersistence\";\nimport {\n  primeDocumentsForContainerSubtree,\n  primeDocumentsForLoadedRoots,\n} from \"../../../workflows/container-contents/documentPriming\";\nimport type {\n  ContainerDocumentPrimeHost,\n  ContainerDocumentPrimeStore,\n} from \"../../../workflows/container-contents/documentQueries/types\";\nimport type { StaleRootRecoveryStatus } from \"../../../workflows/container-contents/recovery/staleRootRecovery\";\nimport { recoverStaleSessionRoot } from \"../../../workflows/container-contents/recovery/staleRootRecovery\";\nimport type { ContainerState } from \"../../../workflows/container-contents/remoteHydration\";\nimport {\n  type ContainerContentsStoreWorkflowRuntime,\n  createContainerContentsDocumentsRuntime,\n} from \"../../../workflows/container-contents/runtime\";\nimport { isDatabaseUnavailableError } from \"../../../workflows/container-contents/syncLane\";\nimport { openDocumentStore } from \"../../documents\";\nimport { getContainerContentsStoreLogLabel } from \"../logLabel\";\n\ntype PrimeDocumentRuntime = ReturnType<\n  typeof createContainerContentsDocumentsRuntime\n>;\n\ninterface DocumentRecoveryStoreState {\n  readonly containersById: Map<string, ContainerState>;\n  documentStoresNeedPriming: boolean;\n  readonly logLabel?: string | undefined;\n  readonly persistence: ContainerContentsPersistence;\n  readonly rootLaneHydrated: boolean;\n  readonly runtime: ContainerContentsStoreWorkflowRuntime;\n}\n\ninterface StaleRootRecoveryLogState {\n  readonly message: string;\n  readonly occurrenceCount: number;\n}\n\nconst staleRootRecoveryLogState = new WeakMap<\n  DocumentRecoveryStoreState,\n  StaleRootRecoveryLogState\n>();\nconst rejectedAdoptionRuntime = new WeakMap<\n  DocumentRecoveryStoreState,\n  ContainerContentsStoreWorkflowRuntime\n>();\n\nfunction createPrimeHost(\n  runtime: ContainerContentsStoreWorkflowRuntime,\n): ContainerDocumentPrimeHost<PrimeDocumentRuntime> {\n  return {\n    documentWorkflowRuntime: (containerId) =>\n      createContainerContentsDocumentsRuntime(runtime, containerId),\n    openDocumentStore: ({\n      documentId,\n      localId,\n      runtime,\n    }): ContainerDocumentPrimeStore =>\n      openDocumentStore(\n        runtime.state.domainScope,\n        localId,\n        runtime,\n        documentId,\n      ),\n  };\n}\n\nexport async function primeStoreDocumentSubtree(\n  state: DocumentRecoveryStoreState,\n  rootContainerId: string,\n  isCurrent: () => boolean = () => true,\n): Promise<void> {\n  if (!isCurrent()) return;\n  const runtime = state.runtime;\n  await primeDocumentsForContainerSubtree({\n    containersById: state.containersById,\n    host: createPrimeHost(runtime),\n    isCurrent,\n    rootContainerId,\n    runtime,\n  });\n}\n\nexport async function primeStoreDocuments(\n  state: DocumentRecoveryStoreState,\n  isCurrent: () => boolean = () => true,\n): Promise<void> {\n  if (!isCurrent()) return;\n  const runtime = state.runtime;\n  // Consume the current signal before scanning. A topology/root reconciliation\n  // that lands during an awaited query can then re-arm the next pass without\n  // this pass erasing that newer signal when it completes.\n  state.documentStoresNeedPriming = false;\n  try {\n    const result = await primeDocumentsForLoadedRoots({\n      containersById: state.containersById,\n      host: createPrimeHost(runtime),\n      isCurrent,\n      organizationId: runtime.auth?.organizationId ?? null,\n      runtime,\n    });\n    if (!isCurrent()) {\n      state.documentStoresNeedPriming = true;\n      return;\n    }\n    runtime.util.log(\n      `${getContainerContentsStoreLogLabel(state)}: document priming candidates=${result.candidateCount} roots=${result.rootCount} primed=${result.primedCount} orphaned=${result.orphanPrimedCount} unroutable=${result.unroutableCount}`,\n    );\n  } catch (error) {\n    if (!isCurrent()) {\n      state.documentStoresNeedPriming = true;\n      return;\n    }\n    state.documentStoresNeedPriming = true;\n    throw error;\n  }\n}\n\nexport async function recoverStoreStaleRoot(\n  state: DocumentRecoveryStoreState,\n  isCurrent: () => boolean = () => true,\n): Promise<StaleRootRecoveryStatus> {\n  if (!isCurrent()) {\n    return \"context-changed\";\n  }\n  const runtime = state.runtime;\n  if (rejectedAdoptionRuntime.get(state) === runtime) {\n    return \"not-needed\";\n  }\n\n  let result: Awaited<ReturnType<typeof recoverStaleSessionRoot>>;\n  try {\n    result = await recoverStaleSessionRoot({ ...state, runtime }, isCurrent);\n  } catch (error) {\n    if (!isCurrent()) {\n      return \"context-changed\";\n    }\n    if (isDatabaseUnavailableError(error)) {\n      throw error;\n    }\n    const message = `${getContainerContentsStoreLogLabel(state)}: stale root recovery failed`;\n    if (state.runtime.util.logError) {\n      state.runtime.util.logError(message, error);\n    } else {\n      state.runtime.util.log(message);\n    }\n    return \"not-needed\";\n  }\n  if (!isCurrent()) {\n    return \"context-changed\";\n  }\n  const message = `${getContainerContentsStoreLogLabel(state)}: stale root recovery status=${result.status} candidates=${result.candidateCount}`;\n  const previousLogState = staleRootRecoveryLogState.get(state);\n  const occurrenceCount =\n    previousLogState?.message === message\n      ? previousLogState.occurrenceCount + 1\n      : 1;\n  staleRootRecoveryLogState.set(state, { message, occurrenceCount });\n  if (result.status !== \"not-needed\") {\n    if (occurrenceCount === 1) {\n      runtime.util.log(message);\n    } else if ((occurrenceCount & (occurrenceCount - 1)) === 0) {\n      runtime.util.log(`${message} occurrences=${occurrenceCount}`);\n    }\n  }\n  if (result.status === \"context-changed\") {\n    rejectedAdoptionRuntime.set(state, runtime);\n  } else {\n    rejectedAdoptionRuntime.delete(state);\n  }\n  if (result.reassigned) {\n    state.documentStoresNeedPriming = true;\n  }\n  return result.status;\n}\n"]}

package/stores/container-contents/documentWork/documentRotation.js

@@ -0,0 +1,13 @@
+import { createContainerContentsDocumentsRuntime, } from "../../../workflows/container-contents/runtime.js";
+import { openDocumentStore } from "../../documents/index.js";
+export async function prepareContainerDocumentRotationSnapshot(runtime, document) {
+    if (!document.documentId || !document.containerId) {
+        return null;
+    }
+    const store = openDocumentStore(runtime.state.domainScope, document.id, createContainerContentsDocumentsRuntime(runtime, document.containerId), document.documentId);
+    if (!(await store.ensureInitialized())) {
+        return null;
+    }
+    return store.assertCanRotateContentKey();
+}
+//# sourceMappingURL=documentRotation.js.map

package/stores/container-contents/documentWork/documentRotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentRotation.js","sourceRoot":"","sources":["documentRotation.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,uCAAuC,GACxC,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAC5D,OAAyC,EACzC,QAAyB;IAEzB,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,iBAAiB,CAC7B,OAAO,CAAC,KAAK,CAAC,WAAW,EACzB,QAAQ,CAAC,EAAE,EACX,uCAAuC,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,EACtE,QAAQ,CAAC,UAAU,CACpB,CAAC;IACF,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,yBAAyB,EAAE,CAAC;AAC3C,CAAC","sourcesContent":["import type { DocumentSummary } from \"../../../data/documents/documentSummary\";\nimport {\n  type ContainerContentsWorkflowRuntime,\n  createContainerContentsDocumentsRuntime,\n} from \"../../../workflows/container-contents/runtime\";\nimport { openDocumentStore } from \"../../documents\";\n\nexport async function prepareContainerDocumentRotationSnapshot(\n  runtime: ContainerContentsWorkflowRuntime,\n  document: DocumentSummary,\n): Promise<Uint8Array | null> {\n  if (!document.documentId || !document.containerId) {\n    return null;\n  }\n  const store = openDocumentStore(\n    runtime.state.domainScope,\n    document.id,\n    createContainerContentsDocumentsRuntime(runtime, document.containerId),\n    document.documentId,\n  );\n  if (!(await store.ensureInitialized())) {\n    return null;\n  }\n  return store.assertCanRotateContentKey();\n}\n"]}

package/stores/container-contents/documentWork/index.js

@@ -0,0 +1,29 @@
+/** Runs root repair before any work that consumes its rewritten projections. */
+export async function runContainerDocumentWork(input) {
+    if (!input.isCurrent()) {
+        return "abandoned";
+    }
+    const recoveryStatus = await input.recoverStaleRoot();
+    if (!input.isCurrent()) {
+        return "abandoned";
+    }
+    if (recoveryStatus === "context-changed") {
+        input.onContextChanged();
+        return "context-changed";
+    }
+    const movedDocumentCount = await input.syncPendingDocumentMoves();
+    if (!input.isCurrent()) {
+        return "abandoned";
+    }
+    if (movedDocumentCount > 0) {
+        input.onDocumentsMoved();
+    }
+    if (input.shouldPrimeDocuments()) {
+        await input.primeDocuments();
+        if (!input.isCurrent()) {
+            return "abandoned";
+        }
+    }
+    return "completed";
+}
+//# sourceMappingURL=index.js.map

package/stores/container-contents/documentWork/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAYA,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAiC;IAEjC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,KAAK,CAAC,gBAAgB,EAAE,CAAC;IACtD,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,cAAc,KAAK,iBAAiB,EAAE,CAAC;QACzC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACzB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,kBAAkB,GAAG,MAAM,KAAK,CAAC,wBAAwB,EAAE,CAAC;IAClE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,gBAAgB,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,KAAK,CAAC,oBAAoB,EAAE,EAAE,CAAC;QACjC,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;YACvB,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC","sourcesContent":["import type { StaleRootRecoveryStatus } from \"../../../workflows/container-contents/recovery/staleRootRecovery\";\n\ninterface ContainerDocumentWorkInput {\n  readonly isCurrent: () => boolean;\n  readonly onContextChanged: () => void;\n  readonly onDocumentsMoved: () => void;\n  readonly primeDocuments: () => Promise<void>;\n  readonly recoverStaleRoot: () => Promise<StaleRootRecoveryStatus>;\n  readonly shouldPrimeDocuments: () => boolean;\n  readonly syncPendingDocumentMoves: () => Promise<number>;\n}\n\n/** Runs root repair before any work that consumes its rewritten projections. */\nexport async function runContainerDocumentWork(\n  input: ContainerDocumentWorkInput,\n): Promise<\"abandoned\" | \"completed\" | \"context-changed\"> {\n  if (!input.isCurrent()) {\n    return \"abandoned\";\n  }\n  const recoveryStatus = await input.recoverStaleRoot();\n  if (!input.isCurrent()) {\n    return \"abandoned\";\n  }\n  if (recoveryStatus === \"context-changed\") {\n    input.onContextChanged();\n    return \"context-changed\";\n  }\n\n  const movedDocumentCount = await input.syncPendingDocumentMoves();\n  if (!input.isCurrent()) {\n    return \"abandoned\";\n  }\n  if (movedDocumentCount > 0) {\n    input.onDocumentsMoved();\n  }\n  if (input.shouldPrimeDocuments()) {\n    await input.primeDocuments();\n    if (!input.isCurrent()) {\n      return \"abandoned\";\n    }\n  }\n  return \"completed\";\n}\n"]}

package/stores/container-contents/hydration/backgroundHydration.js

@@ -0,0 +1,32 @@
+import { reportKeyingVerificationErrorInCauseChain } from "../../../data/keyingProjectionVerification/error.js";
+import { errorMessage } from "../../../data/shared/errorMessage.js";
+import { isDatabaseUnavailableError } from "../../../workflows/container-contents/syncLane.js";
+/** Observe a background refresh without changing the caller's rejection. */
+export function observeContainerBackgroundHydration(state, hydration) {
+    const generation = state.lifecycleGeneration;
+    const runtime = state.runtime;
+    void hydration.catch(async (error) => {
+        if (state.lifecycleGeneration !== generation ||
+            isDatabaseUnavailableError(error))
+            return;
+        await reportKeyingVerificationErrorInCauseChain(error, runtime.util.reportSecurityIncident, {
+            objectId: null,
+            objectKind: "container",
+            operation: "container.hydration.background",
+            organizationId: runtime.auth.organizationId,
+        });
+        try {
+            const message = "Container background hydration failed";
+            if (runtime.util.logError) {
+                await runtime.util.logError(message, error);
+            }
+            else {
+                await runtime.util.log(`${message}: ${errorMessage(error)}`);
+            }
+        }
+        catch {
+            // A host logger must not turn an observed refusal into a new rejection.
+        }
+    });
+}
+//# sourceMappingURL=backgroundHydration.js.map

package/stores/container-contents/hydration/backgroundHydration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundHydration.js","sourceRoot":"","sources":["backgroundHydration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yCAAyC,EAAE,MAAM,kDAAkD,CAAC;AAC7G,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAG5F,4EAA4E;AAC5E,MAAM,UAAU,mCAAmC,CACjD,KAAsC,EACtC,SAAwB;IAExB,MAAM,UAAU,GAAG,KAAK,CAAC,mBAAmB,CAAC;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;QAC5C,IACE,KAAK,CAAC,mBAAmB,KAAK,UAAU;YACxC,0BAA0B,CAAC,KAAK,CAAC;YAEjC,OAAO;QAET,MAAM,yCAAyC,CAC7C,KAAK,EACL,OAAO,CAAC,IAAI,CAAC,sBAAsB,EACnC;YACE,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,WAAW;YACvB,SAAS,EAAE,gCAAgC;YAC3C,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc;SAC5C,CACF,CAAC;QACF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,uCAAuC,CAAC;YACxD,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC1B,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;QAC1E,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { reportKeyingVerificationErrorInCauseChain } from \"../../../data/keyingProjectionVerification/error\";\nimport { errorMessage } from \"../../../data/shared/errorMessage\";\nimport { isDatabaseUnavailableError } from \"../../../workflows/container-contents/syncLane\";\nimport type { ContainerContentsStoreSyncState } from \"../syncAgent/syncAgentTypes\";\n\n/** Observe a background refresh without changing the caller's rejection. */\nexport function observeContainerBackgroundHydration(\n  state: ContainerContentsStoreSyncState,\n  hydration: Promise<void>,\n): void {\n  const generation = state.lifecycleGeneration;\n  const runtime = state.runtime;\n  void hydration.catch(async (error: unknown) => {\n    if (\n      state.lifecycleGeneration !== generation ||\n      isDatabaseUnavailableError(error)\n    )\n      return;\n\n    await reportKeyingVerificationErrorInCauseChain(\n      error,\n      runtime.util.reportSecurityIncident,\n      {\n        objectId: null,\n        objectKind: \"container\",\n        operation: \"container.hydration.background\",\n        organizationId: runtime.auth.organizationId,\n      },\n    );\n    try {\n      const message = \"Container background hydration failed\";\n      if (runtime.util.logError) {\n        await runtime.util.logError(message, error);\n      } else {\n        await runtime.util.log(`${message}: ${errorMessage(error)}`);\n      }\n    } catch {\n      // A host logger must not turn an observed refusal into a new rejection.\n    }\n  });\n}\n"]}

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

@@ -0,0 +1,245 @@
+import { createGenerationGuardedHydrationHost, hydrateRemoteContainers, StaleRemoteHydrationError, } from "../../../workflows/container-contents/remoteHydration/index.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/hydration/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"]}