@tearleads/client-sdk 0.1.61 → 0.1.63

package/workflows/container-contents/pendingWrites.js

@@ -1,116 +0,0 @@
-import { CONTAINER_METADATA_APP_KIND } from "../../data/persistence/container-contents/containerContentsPersistence.js";
-import { sqlDocumentMoveIntentPersistence } from "../../data/persistence/container-contents/documentMoveIntentPersistence.js";
-import { sqlDocumentsPersistence } from "../../data/persistence/documents/documentsPersistence.js";
-import { DOCUMENTS_APP_KIND } from "../../data/persistence/documents/internal/constants.js";
-import { clearDocumentSyncFailure, resetDocumentPendingUpdateRekeyBudget, } from "../../data/sqlite/documentPersistence.js";
-import { documentPlacementIntentTables, documentTables, LOCAL_INTENT_LANES, } from "../../data/sqlite/schema.js";
-import { ensureSqlTables } from "../../data/sqlite/sqlSchema.js";
-import { defaultContainerContentsPersistence } from "./containerPersistence.js";
-import { groupPendingWriteCandidates } from "./pendingWrites/aggregation.js";
-import { hasDeferredTailScopeWork, listDeferredPendingWriteCandidates, } from "./pendingWrites/deferredTails.js";
-import { listPersistedPendingWriteCandidates } from "./pendingWrites/sources.js";
-/**
- * List identity-wide local state that still requires a remote write. The
- * returned diagnostic contains only navigation/display metadata and aggregate
- * counts; serialized updates, local storage keys, and upload crypto stay below
- * the workflow boundary.
- */
-export async function listPendingWrites(execSql) {
-    await defaultContainerContentsPersistence.ensureSchema(execSql);
-    await sqlDocumentsPersistence.ensureSchema(execSql);
-    await sqlDocumentMoveIntentPersistence.ensureSchema(execSql);
-    const [persisted, deferred] = await Promise.all([
-        listPersistedPendingWriteCandidates(execSql),
-        listDeferredPendingWriteCandidates(execSql),
-    ]);
-    return groupPendingWriteCandidates([...persisted, ...deferred]);
-}
-/**
- * Explicit manual retry for one write-queue item: reset the durable re-key
- * budget for the item's ACTUAL pending-update scope (container metadata and
- * unknown document namespaces re-key through the same recovery path as
- * ordinary documents) and clear the recorded terminal failure — the next
- * pass re-records both if they still hold. The cap protects against a
- * server driving a network-speed re-key loop; a deliberate user retry is
- * the rate-limited signal that conditions have changed (e.g. an outage that
- * burned the budget has healed). The caller re-arms the sync lanes.
- */
-export async function resetPendingWriteRetryState(execSql, input) {
-    const appKind = input.objectKind === "container"
-        ? CONTAINER_METADATA_APP_KIND
-        : (input.namespace ??
-            (input.objectKind === "document" ? DOCUMENTS_APP_KIND : null));
-    if (appKind === null) {
-        // An unknown object kind with no namespace: there is no scope to reset,
-        // and guessing one could clear an unrelated scope sharing the localId.
-        return;
-    }
-    const scope = { appKind, localId: input.localId };
-    await resetDocumentPendingUpdateRekeyBudget(execSql, scope);
-    if (appKind === DOCUMENTS_APP_KIND) {
-        // A deliberate retry is the rate-limited signal that conditions changed:
-        // a parked permission-denied move (row 7) replays once, like row 11's
-        // re-key budget reset.
-        await sqlDocumentMoveIntentPersistence.resetDeniedMoveIntents(execSql, {
-            localId: input.localId,
-        });
-    }
-    // Clearing the failure row is part of the re-key budget reset (edge-case
-    // row 11) and only makes sense alongside queued work. A failure-only item
-    // (a refused revalidation, row 13) has no queued work: its row is the
-    // priming ticket that re-drives the store, so it must survive the retry
-    // and clear on the next clean pass instead of vanishing with no request.
-    if (await hasQueuedScopeWork(execSql, scope)) {
-        await clearDocumentSyncFailure(execSql, scope);
-    }
-}
-/**
- * Whether ANY durable outbound work exists for the scope — CRDT updates,
- * staged attachment uploads, move intents, a never-created local document, or
- * a deferred write whose only durable content is the history tail ahead of
- * its covered frontier. Mirrors the queue's own document candidate sources,
- * so "failure-only" here agrees with the item the panel rendered.
- */
-async function hasQueuedScopeWork(execSql, scope) {
-    await ensureSqlTables(execSql, [
-        ...documentTables,
-        ...documentPlacementIntentTables,
-    ]);
-    const rows = await execSql(`SELECT 1 AS present
-     WHERE EXISTS (
-         SELECT 1 FROM document_history_updates pending
-         WHERE pending.app_kind = ? AND pending.local_id = ?
-           AND pending.update_id IS NOT NULL
-       )
-       OR EXISTS (
-         SELECT 1 FROM document_pending_attachments attachment
-         WHERE attachment.local_id = ?
-       )
-       OR EXISTS (
-         SELECT 1 FROM local_intents intent
-         WHERE intent.lane = '${LOCAL_INTENT_LANES.documentPlacement}'
-           AND intent.local_id = ?
-           AND intent.intent_type IN ('document.move', 'document.link')
-       )
-       OR EXISTS (
-         SELECT 1 FROM documents stored
-         WHERE stored.app_kind = ? AND stored.local_id = ?
-           AND stored.document_id IS NULL
-       )
-     LIMIT 1`, [
-        scope.appKind,
-        scope.localId,
-        scope.localId,
-        scope.localId,
-        scope.appKind,
-        scope.localId,
-    ]);
-    if (rows.length > 0) {
-        return true;
-    }
-    // The queue's deferred-update source has no queued rows to probe: the
-    // write lives in the durable history tail, detectable only by the
-    // version-vector coverage check.
-    return hasDeferredTailScopeWork(execSql, scope);
-}
-//# sourceMappingURL=pendingWrites.js.map

package/workflows/container-contents/pendingWrites.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pendingWrites.js","sourceRoot":"","sources":["pendingWrites.ts"],"names":[],"mappings":"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","sourcesContent":["import { CONTAINER_METADATA_APP_KIND } from \"../../data/persistence/container-contents/containerContentsPersistence\";\nimport { sqlDocumentMoveIntentPersistence } from \"../../data/persistence/container-contents/documentMoveIntentPersistence\";\nimport { sqlDocumentsPersistence } from \"../../data/persistence/documents/documentsPersistence\";\nimport { DOCUMENTS_APP_KIND } from \"../../data/persistence/documents/internal/constants\";\nimport {\n  clearDocumentSyncFailure,\n  resetDocumentPendingUpdateRekeyBudget,\n} from \"../../data/sqlite/documentPersistence\";\nimport {\n  documentPlacementIntentTables,\n  documentTables,\n  LOCAL_INTENT_LANES,\n} from \"../../data/sqlite/schema\";\nimport type { ExecSql } from \"../../data/sqlite/sqlSchema\";\nimport { ensureSqlTables } from \"../../data/sqlite/sqlSchema\";\nimport { defaultContainerContentsPersistence } from \"./containerPersistence\";\nimport { groupPendingWriteCandidates } from \"./pendingWrites/aggregation\";\nimport {\n  hasDeferredTailScopeWork,\n  listDeferredPendingWriteCandidates,\n} from \"./pendingWrites/deferredTails\";\nimport { listPersistedPendingWriteCandidates } from \"./pendingWrites/sources\";\nimport type { PendingWriteQueueItem } from \"./pendingWritesTypes\";\n\nexport type {\n  PendingWriteQueueItem,\n  PendingWriteQueueItemStatus,\n  PendingWriteQueueObjectKind,\n  PendingWriteQueueOperation,\n  PendingWriteQueueOperationKind,\n  PendingWriteQueueOperationStatus,\n} from \"./pendingWritesTypes\";\n\n/**\n * List identity-wide local state that still requires a remote write. The\n * returned diagnostic contains only navigation/display metadata and aggregate\n * counts; serialized updates, local storage keys, and upload crypto stay below\n * the workflow boundary.\n */\nexport async function listPendingWrites(\n  execSql: ExecSql,\n): Promise<ReadonlyArray<PendingWriteQueueItem>> {\n  await defaultContainerContentsPersistence.ensureSchema(execSql);\n  await sqlDocumentsPersistence.ensureSchema(execSql);\n  await sqlDocumentMoveIntentPersistence.ensureSchema(execSql);\n\n  const [persisted, deferred] = await Promise.all([\n    listPersistedPendingWriteCandidates(execSql),\n    listDeferredPendingWriteCandidates(execSql),\n  ]);\n  return groupPendingWriteCandidates([...persisted, ...deferred]);\n}\n\n/**\n * Explicit manual retry for one write-queue item: reset the durable re-key\n * budget for the item's ACTUAL pending-update scope (container metadata and\n * unknown document namespaces re-key through the same recovery path as\n * ordinary documents) and clear the recorded terminal failure — the next\n * pass re-records both if they still hold. The cap protects against a\n * server driving a network-speed re-key loop; a deliberate user retry is\n * the rate-limited signal that conditions have changed (e.g. an outage that\n * burned the budget has healed). The caller re-arms the sync lanes.\n */\nexport async function resetPendingWriteRetryState(\n  execSql: ExecSql,\n  input: {\n    localId: string;\n    /** The item's `namespace` — the unrecognized documents.app_kind, if any. */\n    namespace: string | null;\n    objectKind: PendingWriteQueueItem[\"objectKind\"];\n  },\n): Promise<void> {\n  const appKind =\n    input.objectKind === \"container\"\n      ? CONTAINER_METADATA_APP_KIND\n      : (input.namespace ??\n        (input.objectKind === \"document\" ? DOCUMENTS_APP_KIND : null));\n  if (appKind === null) {\n    // An unknown object kind with no namespace: there is no scope to reset,\n    // and guessing one could clear an unrelated scope sharing the localId.\n    return;\n  }\n  const scope = { appKind, localId: input.localId };\n  await resetDocumentPendingUpdateRekeyBudget(execSql, scope);\n  if (appKind === DOCUMENTS_APP_KIND) {\n    // A deliberate retry is the rate-limited signal that conditions changed:\n    // a parked permission-denied move (row 7) replays once, like row 11's\n    // re-key budget reset.\n    await sqlDocumentMoveIntentPersistence.resetDeniedMoveIntents(execSql, {\n      localId: input.localId,\n    });\n  }\n  // Clearing the failure row is part of the re-key budget reset (edge-case\n  // row 11) and only makes sense alongside queued work. A failure-only item\n  // (a refused revalidation, row 13) has no queued work: its row is the\n  // priming ticket that re-drives the store, so it must survive the retry\n  // and clear on the next clean pass instead of vanishing with no request.\n  if (await hasQueuedScopeWork(execSql, scope)) {\n    await clearDocumentSyncFailure(execSql, scope);\n  }\n}\n\n/**\n * Whether ANY durable outbound work exists for the scope — CRDT updates,\n * staged attachment uploads, move intents, a never-created local document, or\n * a deferred write whose only durable content is the history tail ahead of\n * its covered frontier. Mirrors the queue's own document candidate sources,\n * so \"failure-only\" here agrees with the item the panel rendered.\n */\nasync function hasQueuedScopeWork(\n  execSql: ExecSql,\n  scope: { appKind: string; localId: string },\n): Promise<boolean> {\n  await ensureSqlTables(execSql, [\n    ...documentTables,\n    ...documentPlacementIntentTables,\n  ]);\n  const rows = await execSql(\n    `SELECT 1 AS present\n     WHERE EXISTS (\n         SELECT 1 FROM document_history_updates pending\n         WHERE pending.app_kind = ? AND pending.local_id = ?\n           AND pending.update_id IS NOT NULL\n       )\n       OR EXISTS (\n         SELECT 1 FROM document_pending_attachments attachment\n         WHERE attachment.local_id = ?\n       )\n       OR EXISTS (\n         SELECT 1 FROM local_intents intent\n         WHERE intent.lane = '${LOCAL_INTENT_LANES.documentPlacement}'\n           AND intent.local_id = ?\n           AND intent.intent_type IN ('document.move', 'document.link')\n       )\n       OR EXISTS (\n         SELECT 1 FROM documents stored\n         WHERE stored.app_kind = ? AND stored.local_id = ?\n           AND stored.document_id IS NULL\n       )\n     LIMIT 1`,\n    [\n      scope.appKind,\n      scope.localId,\n      scope.localId,\n      scope.localId,\n      scope.appKind,\n      scope.localId,\n    ],\n  );\n  if (rows.length > 0) {\n    return true;\n  }\n  // The queue's deferred-update source has no queued rows to probe: the\n  // write lives in the durable history tail, detectable only by the\n  // version-vector coverage check.\n  return hasDeferredTailScopeWork(execSql, scope);\n}\n"]}

package/workflows/container-contents/remoteContainerPageHydration.js

@@ -1,244 +0,0 @@
-import { createRuntimePrincipalPolicyWarmer } from "../principals/runtimePolicyWarmer.js";
-import { listRemoteContainerIdsWithPendingMetadataUpdates, listRemoteContainerIdsWithPendingStructuralIntents, upsertIsolatedRemoteContainerState, } from "./remoteContainerState.js";
-import { containerStateMatchesFingerprint } from "./remoteHydration/containerStateFingerprint.js";
-import { prefetchDestinationProjections } from "./remoteHydration/destinationPrefetch.js";
-import { cachedDestinationRole } from "./remoteHydration/destinationRoleCache.js";
-import { markContainerParentLaneFetched } from "./remoteHydration/laneFetchMarkers.js";
-import { fetchContainerParentLaneBatch } from "./remoteHydration/parentLaneFetch.js";
-import { cacheRemoteContainerPrincipalPolicies } from "./remoteHydration/principalPolicyCache.js";
-import { applyContainerTombstones, getApplicableRemoteContainerItems, } from "./remoteHydration/tombstoneApplication.js";
-const CONTAINER_PARENT_HYDRATION_CONCURRENCY = 4;
-async function applyRemoteContainerPage(input) {
-    const { childIdsByParentId, expectedContainerStates, expectedHydrationTombstones, host, items, queueParentLane, seenContainerIds, state, } = input;
-    let hydratedCount = 0;
-    let pageCompleted = true;
-    await cacheRemoteContainerPrincipalPolicies({
-        cacheReferencedPrincipalPolicies: createRuntimePrincipalPolicyWarmer(state.runtime),
-        remoteContainers: items,
-        stillCurrent: input.isCurrent,
-    });
-    if (input.isCurrent?.() === false) {
-        return { changedCount: 0, completed: false };
-    }
-    const [containerIdsWithPendingMetadataUpdates, containerIdsWithPendingStructuralIntents,] = await Promise.all([
-        listRemoteContainerIdsWithPendingMetadataUpdates({
-            remoteContainers: items,
-            state,
-        }),
-        listRemoteContainerIdsWithPendingStructuralIntents({
-            remoteContainers: items,
-            state,
-        }),
-    ]);
-    if (input.isCurrent?.() === false) {
-        return { changedCount: 0, completed: false };
-    }
-    const prefetchedProjections = await prefetchDestinationProjections({
-        containerIds: items.flatMap((item) => seenContainerIds.has(item.id) ||
-            state.containersById.has(item.id) ||
-            expectedHydrationTombstones.get(item.id) ||
-            cachedDestinationRole(state.runtime.infra.execSql, item)
-            ? []
-            : [item.id]),
-        isCurrent: input.isCurrent,
-        runtime: state.runtime,
-    });
-    for (const container of items) {
-        if (input.isCurrent?.() === false) {
-            return { changedCount: hydratedCount, completed: false };
-        }
-        if (!seenContainerIds.has(container.id)) {
-            if (!containerStateMatchesFingerprint({
-                currentState: state.containersById.get(container.id),
-                expectedFingerprint: expectedContainerStates.get(container.id)
-                    ?.fingerprint,
-            })) {
-                pageCompleted = false;
-                continue;
-            }
-            const upserted = await upsertIsolatedRemoteContainerState({
-                childIdsByParentId,
-                containerIdsWithPendingMetadataUpdates,
-                containerIdsWithPendingStructuralIntents,
-                host,
-                isCurrent: input.isCurrent,
-                expectedHydrationTombstone: expectedHydrationTombstones.get(container.id) ?? null,
-                prefetchedProjection: prefetchedProjections.get(container.id),
-                remoteContainer: container,
-                state,
-            });
-            if (!upserted) {
-                pageCompleted = false;
-                continue;
-            }
-            seenContainerIds.add(container.id);
-            hydratedCount += 1;
-            if (input.isCurrent?.() === false) {
-                return { changedCount: hydratedCount, completed: false };
-            }
-        }
-        queueParentLane(container.id);
-    }
-    return { changedCount: hydratedCount, completed: pageCompleted };
-}
-export function canHydrateRemoteContainers(state) {
-    return (state.runtime.auth.isAuthenticated &&
-        state.runtime.state.online &&
-        state.runtime.infra.dbStatus === "ready");
-}
-async function applyContainerParentLanePage(input) {
-    const { childIdsByParentId, fetchedPage, host, queueContinuationLane, queueParentLane, seenContainerIds, state, } = input;
-    const { expectedContainerStates, expectedHydrationTombstones, lane, response, syncLane, } = fetchedPage;
-    let changedCount = 0;
-    if (input.isCurrent?.() === false) {
-        return { changedCount, complete: false, shouldStop: true };
-    }
-    const remoteContainerItems = getApplicableRemoteContainerItems(response);
-    const tombstoneResult = await applyContainerTombstones({
-        childIdsByParentId,
-        expectedContainerStates,
-        isCurrent: input.isCurrent,
-        remoteContainerItems,
-        response,
-        state,
-    });
-    if (!tombstoneResult.current) {
-        return { changedCount, complete: false, shouldStop: true };
-    }
-    changedCount += tombstoneResult.changedCount;
-    if (input.isCurrent?.() === false) {
-        return { changedCount, complete: false, shouldStop: true };
-    }
-    if (tombstoneResult.changedCount > 0) {
-        // A live tombstone cascade may have orphaned documents (row 3); re-arm
-        // document priming so their null-scoped passes run now rather than on
-        // the next startup.
-        host.requestDocumentPriming?.();
-    }
-    const appliedPage = await applyRemoteContainerPage({
-        childIdsByParentId,
-        expectedContainerStates,
-        expectedHydrationTombstones,
-        host,
-        isCurrent: input.isCurrent,
-        items: remoteContainerItems,
-        queueParentLane,
-        seenContainerIds,
-        state,
-    });
-    changedCount += appliedPage.changedCount;
-    if (!tombstoneResult.completed || !appliedPage.completed) {
-        // Keep this page retryable without discarding independent lanes, including
-        // children of roots first discovered here. Otherwise the root becomes known
-        // but its children are never fetched by subsequent root-only refreshes.
-        return { changedCount, complete: false, shouldStop: false };
-    }
-    if (input.isCurrent?.() === false) {
-        return { changedCount, complete: false, shouldStop: true };
-    }
-    const didMarkFetched = await markContainerParentLaneFetched({
-        isCurrent: input.isCurrent,
-        response,
-        state,
-        syncLane,
-    });
-    if (!didMarkFetched) {
-        return { changedCount, complete: false, shouldStop: true };
-    }
-    if (!response.hasMore) {
-        return { changedCount, complete: true, shouldStop: false };
-    }
-    if (!response.nextWatermark) {
-        return { changedCount, complete: false, shouldStop: true };
-    }
-    queueContinuationLane({
-        parentId: lane.parentId,
-        watermark: response.nextWatermark,
-    });
-    return { changedCount, complete: true, shouldStop: false };
-}
-function takeContainerParentLaneBatch(input) {
-    const { lanes, state } = input;
-    const batch = [];
-    while (lanes.length > 0 &&
-        batch.length < CONTAINER_PARENT_HYDRATION_CONCURRENCY) {
-        const lane = lanes.shift();
-        if (lane &&
-            (lane.parentId === null || state.containersById.has(lane.parentId))) {
-            batch.push(lane);
-        }
-    }
-    return batch;
-}
-async function applyContainerParentLaneBatch(input) {
-    const { childIdsByParentId, fetchedPages, host, lanes, queueParentLane, seenContainerIds, state, } = input;
-    let changedCount = 0;
-    let complete = true;
-    for (const fetchedPage of fetchedPages) {
-        if (!canHydrateRemoteContainers(state) || input.isCurrent?.() === false) {
-            return { changedCount, complete: false, shouldStop: true };
-        }
-        if (fetchedPage.lane.parentId !== null &&
-            !state.containersById.has(fetchedPage.lane.parentId)) {
-            continue;
-        }
-        const result = await applyContainerParentLanePage({
-            childIdsByParentId,
-            fetchedPage,
-            host,
-            isCurrent: input.isCurrent,
-            queueContinuationLane: (lane) => lanes.push(lane),
-            queueParentLane,
-            seenContainerIds,
-            state,
-        });
-        changedCount += result.changedCount;
-        complete &&= result.complete;
-        if (result.shouldStop) {
-            return { changedCount, complete: false, shouldStop: true };
-        }
-    }
-    return { changedCount, complete, shouldStop: false };
-}
-export async function hydrateContainerParentLanes(input) {
-    const { childIdsByParentId, host, lanes, queueParentLane, seenContainerIds, state, } = input;
-    let changedCount = 0;
-    let complete = true;
-    while (lanes.length > 0) {
-        if (!canHydrateRemoteContainers(state) || input.isCurrent?.() === false) {
-            return { changedCount, complete: false, shouldStop: true };
-        }
-        const batch = takeContainerParentLaneBatch({ lanes, state });
-        if (batch.length === 0) {
-            continue;
-        }
-        const fetchedPages = await fetchContainerParentLaneBatch({
-            batch,
-            isCurrent: input.isCurrent,
-            state,
-        });
-        if (!fetchedPages) {
-            return { changedCount, complete: false, shouldStop: true };
-        }
-        if (input.isCurrent?.() === false) {
-            return { changedCount, complete: false, shouldStop: true };
-        }
-        const result = await applyContainerParentLaneBatch({
-            childIdsByParentId,
-            fetchedPages,
-            host,
-            isCurrent: input.isCurrent,
-            lanes,
-            queueParentLane,
-            seenContainerIds,
-            state,
-        });
-        changedCount += result.changedCount;
-        complete &&= result.complete;
-        if (result.shouldStop) {
-            return { changedCount, complete: false, shouldStop: true };
-        }
-    }
-    return { changedCount, complete, shouldStop: false };
-}
-//# sourceMappingURL=remoteContainerPageHydration.js.map

package/workflows/container-contents/remoteContainerPageHydration.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"remoteContainerPageHydration.js","sourceRoot":"","sources":["remoteContainerPageHydration.ts"],"names":[],"mappings":"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","sourcesContent":["import { createRuntimePrincipalPolicyWarmer } from \"../principals/runtimePolicyWarmer\";\nimport {\n  listRemoteContainerIdsWithPendingMetadataUpdates,\n  listRemoteContainerIdsWithPendingStructuralIntents,\n  upsertIsolatedRemoteContainerState,\n} from \"./remoteContainerState\";\nimport { containerStateMatchesFingerprint } from \"./remoteHydration/containerStateFingerprint\";\nimport { prefetchDestinationProjections } from \"./remoteHydration/destinationPrefetch\";\nimport { cachedDestinationRole } from \"./remoteHydration/destinationRoleCache\";\nimport { markContainerParentLaneFetched } from \"./remoteHydration/laneFetchMarkers\";\nimport { fetchContainerParentLaneBatch } from \"./remoteHydration/parentLaneFetch\";\nimport { cacheRemoteContainerPrincipalPolicies } from \"./remoteHydration/principalPolicyCache\";\nimport {\n  applyContainerTombstones,\n  getApplicableRemoteContainerItems,\n} from \"./remoteHydration/tombstoneApplication\";\nimport type {\n  ContainerChildIndex,\n  ContainerParentHydrationLane,\n  ExpectedContainerState,\n  FetchedContainerParentLanePage,\n  ListedRemoteContainerPageItem,\n  QueueContainerParentLane,\n  RemoteContainerHydrationHost,\n  RemoteContainerHydrationState,\n} from \"./remoteHydration/types\";\n\nconst CONTAINER_PARENT_HYDRATION_CONCURRENCY = 4;\n\ninterface HydrationProgress {\n  changedCount: number;\n  complete: boolean;\n  shouldStop: boolean;\n}\nasync function applyRemoteContainerPage(input: {\n  childIdsByParentId: ContainerChildIndex;\n  expectedContainerStates: ReadonlyMap<string, ExpectedContainerState>;\n  expectedHydrationTombstones: FetchedContainerParentLanePage[\"expectedHydrationTombstones\"];\n  host: RemoteContainerHydrationHost;\n  isCurrent?: (() => boolean) | undefined;\n  items: ReadonlyArray<ListedRemoteContainerPageItem>;\n  queueParentLane: QueueContainerParentLane;\n  seenContainerIds: Set<string>;\n  state: RemoteContainerHydrationState;\n}): Promise<{ changedCount: number; completed: boolean }> {\n  const {\n    childIdsByParentId,\n    expectedContainerStates,\n    expectedHydrationTombstones,\n    host,\n    items,\n    queueParentLane,\n    seenContainerIds,\n    state,\n  } = input;\n  let hydratedCount = 0;\n  let pageCompleted = true;\n  await cacheRemoteContainerPrincipalPolicies({\n    cacheReferencedPrincipalPolicies: createRuntimePrincipalPolicyWarmer(\n      state.runtime,\n    ),\n    remoteContainers: items,\n    stillCurrent: input.isCurrent,\n  });\n  if (input.isCurrent?.() === false) {\n    return { changedCount: 0, completed: false };\n  }\n  const [\n    containerIdsWithPendingMetadataUpdates,\n    containerIdsWithPendingStructuralIntents,\n  ] = await Promise.all([\n    listRemoteContainerIdsWithPendingMetadataUpdates({\n      remoteContainers: items,\n      state,\n    }),\n    listRemoteContainerIdsWithPendingStructuralIntents({\n      remoteContainers: items,\n      state,\n    }),\n  ]);\n  if (input.isCurrent?.() === false) {\n    return { changedCount: 0, completed: false };\n  }\n  const prefetchedProjections = await prefetchDestinationProjections({\n    containerIds: items.flatMap((item) =>\n      seenContainerIds.has(item.id) ||\n      state.containersById.has(item.id) ||\n      expectedHydrationTombstones.get(item.id) ||\n      cachedDestinationRole(state.runtime.infra.execSql, item)\n        ? []\n        : [item.id],\n    ),\n    isCurrent: input.isCurrent,\n    runtime: state.runtime,\n  });\n  for (const container of items) {\n    if (input.isCurrent?.() === false) {\n      return { changedCount: hydratedCount, completed: false };\n    }\n    if (!seenContainerIds.has(container.id)) {\n      if (\n        !containerStateMatchesFingerprint({\n          currentState: state.containersById.get(container.id),\n          expectedFingerprint: expectedContainerStates.get(container.id)\n            ?.fingerprint,\n        })\n      ) {\n        pageCompleted = false;\n        continue;\n      }\n      const upserted = await upsertIsolatedRemoteContainerState({\n        childIdsByParentId,\n        containerIdsWithPendingMetadataUpdates,\n        containerIdsWithPendingStructuralIntents,\n        host,\n        isCurrent: input.isCurrent,\n        expectedHydrationTombstone:\n          expectedHydrationTombstones.get(container.id) ?? null,\n        prefetchedProjection: prefetchedProjections.get(container.id),\n        remoteContainer: container,\n        state,\n      });\n      if (!upserted) {\n        pageCompleted = false;\n        continue;\n      }\n      seenContainerIds.add(container.id);\n      hydratedCount += 1;\n      if (input.isCurrent?.() === false) {\n        return { changedCount: hydratedCount, completed: false };\n      }\n    }\n    queueParentLane(container.id);\n  }\n\n  return { changedCount: hydratedCount, completed: pageCompleted };\n}\n\nexport function canHydrateRemoteContainers(\n  state: RemoteContainerHydrationState,\n): boolean {\n  return (\n    state.runtime.auth.isAuthenticated &&\n    state.runtime.state.online &&\n    state.runtime.infra.dbStatus === \"ready\"\n  );\n}\n\nasync function applyContainerParentLanePage(input: {\n  childIdsByParentId: ContainerChildIndex;\n  fetchedPage: FetchedContainerParentLanePage;\n  host: RemoteContainerHydrationHost;\n  isCurrent?: (() => boolean) | undefined;\n  queueContinuationLane: (lane: ContainerParentHydrationLane) => void;\n  queueParentLane: QueueContainerParentLane;\n  seenContainerIds: Set<string>;\n  state: RemoteContainerHydrationState;\n}): Promise<HydrationProgress> {\n  const {\n    childIdsByParentId,\n    fetchedPage,\n    host,\n    queueContinuationLane,\n    queueParentLane,\n    seenContainerIds,\n    state,\n  } = input;\n  const {\n    expectedContainerStates,\n    expectedHydrationTombstones,\n    lane,\n    response,\n    syncLane,\n  } = fetchedPage;\n  let changedCount = 0;\n  if (input.isCurrent?.() === false) {\n    return { changedCount, complete: false, shouldStop: true };\n  }\n\n  const remoteContainerItems = getApplicableRemoteContainerItems(response);\n  const tombstoneResult = await applyContainerTombstones({\n    childIdsByParentId,\n    expectedContainerStates,\n    isCurrent: input.isCurrent,\n    remoteContainerItems,\n    response,\n    state,\n  });\n  if (!tombstoneResult.current) {\n    return { changedCount, complete: false, shouldStop: true };\n  }\n  changedCount += tombstoneResult.changedCount;\n  if (input.isCurrent?.() === false) {\n    return { changedCount, complete: false, shouldStop: true };\n  }\n  if (tombstoneResult.changedCount > 0) {\n    // A live tombstone cascade may have orphaned documents (row 3); re-arm\n    // document priming so their null-scoped passes run now rather than on\n    // the next startup.\n    host.requestDocumentPriming?.();\n  }\n\n  const appliedPage = await applyRemoteContainerPage({\n    childIdsByParentId,\n    expectedContainerStates,\n    expectedHydrationTombstones,\n    host,\n    isCurrent: input.isCurrent,\n    items: remoteContainerItems,\n    queueParentLane,\n    seenContainerIds,\n    state,\n  });\n  changedCount += appliedPage.changedCount;\n  if (!tombstoneResult.completed || !appliedPage.completed) {\n    // Keep this page retryable without discarding independent lanes, including\n    // children of roots first discovered here. Otherwise the root becomes known\n    // but its children are never fetched by subsequent root-only refreshes.\n    return { changedCount, complete: false, shouldStop: false };\n  }\n  if (input.isCurrent?.() === false) {\n    return { changedCount, complete: false, shouldStop: true };\n  }\n\n  const didMarkFetched = await markContainerParentLaneFetched({\n    isCurrent: input.isCurrent,\n    response,\n    state,\n    syncLane,\n  });\n  if (!didMarkFetched) {\n    return { changedCount, complete: false, shouldStop: true };\n  }\n\n  if (!response.hasMore) {\n    return { changedCount, complete: true, shouldStop: false };\n  }\n  if (!response.nextWatermark) {\n    return { changedCount, complete: false, shouldStop: true };\n  }\n\n  queueContinuationLane({\n    parentId: lane.parentId,\n    watermark: response.nextWatermark,\n  });\n  return { changedCount, complete: true, shouldStop: false };\n}\n\nfunction takeContainerParentLaneBatch(input: {\n  lanes: ContainerParentHydrationLane[];\n  state: RemoteContainerHydrationState;\n}): ContainerParentHydrationLane[] {\n  const { lanes, state } = input;\n  const batch: ContainerParentHydrationLane[] = [];\n\n  while (\n    lanes.length > 0 &&\n    batch.length < CONTAINER_PARENT_HYDRATION_CONCURRENCY\n  ) {\n    const lane = lanes.shift();\n    if (\n      lane &&\n      (lane.parentId === null || state.containersById.has(lane.parentId))\n    ) {\n      batch.push(lane);\n    }\n  }\n\n  return batch;\n}\n\nasync function applyContainerParentLaneBatch(input: {\n  childIdsByParentId: ContainerChildIndex;\n  fetchedPages: ReadonlyArray<FetchedContainerParentLanePage>;\n  host: RemoteContainerHydrationHost;\n  isCurrent?: (() => boolean) | undefined;\n  lanes: ContainerParentHydrationLane[];\n  queueParentLane: QueueContainerParentLane;\n  seenContainerIds: Set<string>;\n  state: RemoteContainerHydrationState;\n}): Promise<HydrationProgress> {\n  const {\n    childIdsByParentId,\n    fetchedPages,\n    host,\n    lanes,\n    queueParentLane,\n    seenContainerIds,\n    state,\n  } = input;\n  let changedCount = 0;\n  let complete = true;\n\n  for (const fetchedPage of fetchedPages) {\n    if (!canHydrateRemoteContainers(state) || input.isCurrent?.() === false) {\n      return { changedCount, complete: false, shouldStop: true };\n    }\n    if (\n      fetchedPage.lane.parentId !== null &&\n      !state.containersById.has(fetchedPage.lane.parentId)\n    ) {\n      continue;\n    }\n\n    const result = await applyContainerParentLanePage({\n      childIdsByParentId,\n      fetchedPage,\n      host,\n      isCurrent: input.isCurrent,\n      queueContinuationLane: (lane) => lanes.push(lane),\n      queueParentLane,\n      seenContainerIds,\n      state,\n    });\n    changedCount += result.changedCount;\n    complete &&= result.complete;\n\n    if (result.shouldStop) {\n      return { changedCount, complete: false, shouldStop: true };\n    }\n  }\n\n  return { changedCount, complete, shouldStop: false };\n}\n\nexport async function hydrateContainerParentLanes(input: {\n  childIdsByParentId: ContainerChildIndex;\n  host: RemoteContainerHydrationHost;\n  isCurrent?: (() => boolean) | undefined;\n  lanes: ContainerParentHydrationLane[];\n  queueParentLane: QueueContainerParentLane;\n  seenContainerIds: Set<string>;\n  state: RemoteContainerHydrationState;\n}): Promise<HydrationProgress> {\n  const {\n    childIdsByParentId,\n    host,\n    lanes,\n    queueParentLane,\n    seenContainerIds,\n    state,\n  } = input;\n  let changedCount = 0;\n  let complete = true;\n\n  while (lanes.length > 0) {\n    if (!canHydrateRemoteContainers(state) || input.isCurrent?.() === false) {\n      return { changedCount, complete: false, shouldStop: true };\n    }\n\n    const batch = takeContainerParentLaneBatch({ lanes, state });\n    if (batch.length === 0) {\n      continue;\n    }\n\n    const fetchedPages = await fetchContainerParentLaneBatch({\n      batch,\n      isCurrent: input.isCurrent,\n      state,\n    });\n    if (!fetchedPages) {\n      return { changedCount, complete: false, shouldStop: true };\n    }\n    if (input.isCurrent?.() === false) {\n      return { changedCount, complete: false, shouldStop: true };\n    }\n\n    const result = await applyContainerParentLaneBatch({\n      childIdsByParentId,\n      fetchedPages,\n      host,\n      isCurrent: input.isCurrent,\n      lanes,\n      queueParentLane,\n      seenContainerIds,\n      state,\n    });\n    changedCount += result.changedCount;\n    complete &&= result.complete;\n\n    if (result.shouldStop) {\n      return { changedCount, complete: false, shouldStop: true };\n    }\n  }\n\n  return { changedCount, complete, shouldStop: false };\n}\n"]}