@tearleads/client-sdk 0.0.0-stage → 0.1.11

package/workflows/container-contents/pendingWritesTypes.d.ts

@@ -0,0 +1,36 @@
+export type PendingWriteQueueObjectKind = "container" | "document" | "unknown";
+export type PendingWriteQueueOperationKind = "attachment" | "create" | "deferred-update" | "move" | "revalidation" | "update";
+export type PendingWriteQueueOperationStatus = "pending" | "blocked";
+export type PendingWriteQueueItemStatus = PendingWriteQueueOperationStatus | "error";
+/** Safe, payload-free description of one kind of durable outbound work. */
+export interface PendingWriteQueueOperation {
+    readonly byteLength: number;
+    readonly count: number;
+    readonly createdAt: string | null;
+    readonly kind: PendingWriteQueueOperationKind;
+    readonly lastAttemptedAt: string | null;
+    readonly lastError: string | null;
+    readonly status: PendingWriteQueueOperationStatus;
+    readonly targetContainerId: string | null;
+    readonly updatedAt: string | null;
+}
+/**
+ * Identity-wide pending work grouped by its logical container, document, or
+ * otherwise unknown document namespace. Serialized Loro updates, storage keys,
+ * encryption material, and attachment upload identities are intentionally not
+ * exposed.
+ */
+export interface PendingWriteQueueItem {
+    readonly containerId: string | null;
+    readonly createdAt: string | null;
+    readonly localId: string;
+    readonly name: string | null;
+    /** Present only for an unrecognized `documents.app_kind` namespace. */
+    readonly namespace: string | null;
+    readonly objectKind: PendingWriteQueueObjectKind;
+    readonly operations: ReadonlyArray<PendingWriteQueueOperation>;
+    readonly organizationId: string | null;
+    readonly remoteId: string | null;
+    readonly status: PendingWriteQueueItemStatus;
+    readonly updatedAt: string | null;
+}

package/workflows/container-contents/pendingWritesTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pendingWritesTypes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pendingWritesTypes.js","sourceRoot":"","sources":["pendingWritesTypes.ts"],"names":[],"mappings":"","sourcesContent":["export type PendingWriteQueueObjectKind = \"container\" | \"document\" | \"unknown\";\n\nexport type PendingWriteQueueOperationKind =\n  | \"attachment\"\n  | \"create\"\n  | \"deferred-update\"\n  | \"move\"\n  | \"revalidation\"\n  | \"update\";\n\nexport type PendingWriteQueueOperationStatus = \"pending\" | \"blocked\";\nexport type PendingWriteQueueItemStatus =\n  | PendingWriteQueueOperationStatus\n  | \"error\";\n\n/** Safe, payload-free description of one kind of durable outbound work. */\nexport interface PendingWriteQueueOperation {\n  readonly byteLength: number;\n  readonly count: number;\n  readonly createdAt: string | null;\n  readonly kind: PendingWriteQueueOperationKind;\n  readonly lastAttemptedAt: string | null;\n  readonly lastError: string | null;\n  readonly status: PendingWriteQueueOperationStatus;\n  readonly targetContainerId: string | null;\n  readonly updatedAt: string | null;\n}\n\n/**\n * Identity-wide pending work grouped by its logical container, document, or\n * otherwise unknown document namespace. Serialized Loro updates, storage keys,\n * encryption material, and attachment upload identities are intentionally not\n * exposed.\n */\nexport interface PendingWriteQueueItem {\n  readonly containerId: string | null;\n  readonly createdAt: string | null;\n  readonly localId: string;\n  readonly name: string | null;\n  /** Present only for an unrecognized `documents.app_kind` namespace. */\n  readonly namespace: string | null;\n  readonly objectKind: PendingWriteQueueObjectKind;\n  readonly operations: ReadonlyArray<PendingWriteQueueOperation>;\n  readonly organizationId: string | null;\n  readonly remoteId: string | null;\n  readonly status: PendingWriteQueueItemStatus;\n  readonly updatedAt: string | null;\n}\n"]}

package/workflows/container-contents/projectionGeneration.js

@@ -0,0 +1,10 @@
+/**
+ * The shared writer-projection generation of a container state (container and
+ * metadata-document projections move together). A leaf so hydration, metadata
+ * settlement, and the projection cache can all read it without importing one
+ * another.
+ */
+export function projectionGeneration(state) {
+    return state.writerProjectionGeneration ?? 0;
+}
+//# sourceMappingURL=projectionGeneration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectionGeneration.js","sourceRoot":"","sources":["projectionGeneration.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAiE;IAEjE,OAAO,KAAK,CAAC,0BAA0B,IAAI,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["import type { ContainerMetadataState } from \"./metadataTypes\";\n\n/**\n * The shared writer-projection generation of a container state (container and\n * metadata-document projections move together). A leaf so hydration, metadata\n * settlement, and the projection cache can all read it without importing one\n * another.\n */\nexport function projectionGeneration(\n  state: Pick<ContainerMetadataState, \"writerProjectionGeneration\">,\n): number {\n  return state.writerProjectionGeneration ?? 0;\n}\n"]}

package/workflows/container-contents/projectionKeys.d.ts

@@ -0,0 +1,15 @@
+import type { ProjectionUserKeyResolver } from "../../data/keyingProjectionVerification.js";
+import { createProjectionUserKeyResolver } from "../../data/keyingProjectionVerification/userKeyResolver.js";
+import type { WorkflowRuntimeAuthInput, WorkflowRuntimeCryptoInput, WorkflowRuntimeStateInput } from "../runtimeInput.js";
+export type ContainerContentsProjectionUserKeyResolver = ProjectionUserKeyResolver;
+type ProjectionKeyRuntime = Parameters<typeof createProjectionUserKeyResolver>[0];
+export interface ContainerContentsProjectionKeyRuntime {
+    readonly auth: Pick<WorkflowRuntimeAuthInput, "isAuthenticated" | "userId">;
+    readonly crypto: WorkflowRuntimeCryptoInput;
+    readonly resolveTrustedUserIdentity: ProjectionKeyRuntime["resolveTrustedUserIdentity"];
+    readonly state: Pick<WorkflowRuntimeStateInput, "domainScope">;
+}
+export declare function createContainerContentsProjectionUserKeyResolver(runtime: ContainerContentsProjectionKeyRuntime): ContainerContentsProjectionUserKeyResolver;
+export declare function createContainerContentsDocumentProjectionUserKeyResolver(runtime: ContainerContentsProjectionKeyRuntime): ContainerContentsProjectionUserKeyResolver;
+export declare function didContainerContentsProjectionKeyRuntimeChange(previousRuntime: ContainerContentsProjectionKeyRuntime, nextRuntime: ContainerContentsProjectionKeyRuntime): boolean;
+export {};

package/workflows/container-contents/projectionKeys.js

@@ -0,0 +1,25 @@
+import { createProjectionUserKeyResolver } from "../../data/keyingProjectionVerification/userKeyResolver.js";
+export function createContainerContentsProjectionUserKeyResolver(runtime) {
+    return createProjectionUserKeyResolver(runtime);
+}
+export function createContainerContentsDocumentProjectionUserKeyResolver(runtime) {
+    return createContainerContentsProjectionUserKeyResolver(runtime);
+}
+export function didContainerContentsProjectionKeyRuntimeChange(previousRuntime, nextRuntime) {
+    // The SDK-owned resolver is stable for the lifetime of Tearleads, but reads
+    // mutable session, identity, and database dependencies. The projection
+    // resolver adds its own per-user cache, so compare that trust context rather
+    // than relying only on the resolver function reference.
+    return (previousRuntime.resolveTrustedUserIdentity !==
+        nextRuntime.resolveTrustedUserIdentity ||
+        previousRuntime.auth.isAuthenticated !== nextRuntime.auth.isAuthenticated ||
+        previousRuntime.auth.userId !== nextRuntime.auth.userId ||
+        previousRuntime.crypto.encapsulationKeyPair !==
+            nextRuntime.crypto.encapsulationKeyPair ||
+        previousRuntime.crypto.signingFingerprint !==
+            nextRuntime.crypto.signingFingerprint ||
+        previousRuntime.crypto.signingKeyPair !==
+            nextRuntime.crypto.signingKeyPair ||
+        previousRuntime.state.domainScope !== nextRuntime.state.domainScope);
+}
+//# sourceMappingURL=projectionKeys.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectionKeys.js","sourceRoot":"","sources":["projectionKeys.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,yDAAyD,CAAC;AAoB1G,MAAM,UAAU,gDAAgD,CAC9D,OAA8C;IAE9C,OAAO,+BAA+B,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,wDAAwD,CACtE,OAA8C;IAE9C,OAAO,gDAAgD,CAAC,OAAO,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,8CAA8C,CAC5D,eAAsD,EACtD,WAAkD;IAElD,4EAA4E;IAC5E,uEAAuE;IACvE,6EAA6E;IAC7E,wDAAwD;IACxD,OAAO,CACL,eAAe,CAAC,0BAA0B;QACxC,WAAW,CAAC,0BAA0B;QACxC,eAAe,CAAC,IAAI,CAAC,eAAe,KAAK,WAAW,CAAC,IAAI,CAAC,eAAe;QACzE,eAAe,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,IAAI,CAAC,MAAM;QACvD,eAAe,CAAC,MAAM,CAAC,oBAAoB;YACzC,WAAW,CAAC,MAAM,CAAC,oBAAoB;QACzC,eAAe,CAAC,MAAM,CAAC,kBAAkB;YACvC,WAAW,CAAC,MAAM,CAAC,kBAAkB;QACvC,eAAe,CAAC,MAAM,CAAC,cAAc;YACnC,WAAW,CAAC,MAAM,CAAC,cAAc;QACnC,eAAe,CAAC,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC,KAAK,CAAC,WAAW,CACpE,CAAC;AACJ,CAAC","sourcesContent":["import type { ProjectionUserKeyResolver } from \"../../data/keyingProjectionVerification\";\nimport { createProjectionUserKeyResolver } from \"../../data/keyingProjectionVerification/userKeyResolver\";\nimport type {\n  WorkflowRuntimeAuthInput,\n  WorkflowRuntimeCryptoInput,\n  WorkflowRuntimeStateInput,\n} from \"../runtimeInput\";\n\nexport type ContainerContentsProjectionUserKeyResolver =\n  ProjectionUserKeyResolver;\ntype ProjectionKeyRuntime = Parameters<\n  typeof createProjectionUserKeyResolver\n>[0];\n\nexport interface ContainerContentsProjectionKeyRuntime {\n  readonly auth: Pick<WorkflowRuntimeAuthInput, \"isAuthenticated\" | \"userId\">;\n  readonly crypto: WorkflowRuntimeCryptoInput;\n  readonly resolveTrustedUserIdentity: ProjectionKeyRuntime[\"resolveTrustedUserIdentity\"];\n  readonly state: Pick<WorkflowRuntimeStateInput, \"domainScope\">;\n}\n\nexport function createContainerContentsProjectionUserKeyResolver(\n  runtime: ContainerContentsProjectionKeyRuntime,\n): ContainerContentsProjectionUserKeyResolver {\n  return createProjectionUserKeyResolver(runtime);\n}\n\nexport function createContainerContentsDocumentProjectionUserKeyResolver(\n  runtime: ContainerContentsProjectionKeyRuntime,\n): ContainerContentsProjectionUserKeyResolver {\n  return createContainerContentsProjectionUserKeyResolver(runtime);\n}\n\nexport function didContainerContentsProjectionKeyRuntimeChange(\n  previousRuntime: ContainerContentsProjectionKeyRuntime,\n  nextRuntime: ContainerContentsProjectionKeyRuntime,\n): boolean {\n  // The SDK-owned resolver is stable for the lifetime of Tearleads, but reads\n  // mutable session, identity, and database dependencies. The projection\n  // resolver adds its own per-user cache, so compare that trust context rather\n  // than relying only on the resolver function reference.\n  return (\n    previousRuntime.resolveTrustedUserIdentity !==\n      nextRuntime.resolveTrustedUserIdentity ||\n    previousRuntime.auth.isAuthenticated !== nextRuntime.auth.isAuthenticated ||\n    previousRuntime.auth.userId !== nextRuntime.auth.userId ||\n    previousRuntime.crypto.encapsulationKeyPair !==\n      nextRuntime.crypto.encapsulationKeyPair ||\n    previousRuntime.crypto.signingFingerprint !==\n      nextRuntime.crypto.signingFingerprint ||\n    previousRuntime.crypto.signingKeyPair !==\n      nextRuntime.crypto.signingKeyPair ||\n    previousRuntime.state.domainScope !== nextRuntime.state.domainScope\n  );\n}\n"]}

package/workflows/container-contents/projectionView.js

@@ -0,0 +1,25 @@
+import { listContainerContentsDocumentsForContainers } from "./documentSubtreeQueries.js";
+/**
+ * Device-first projection reads for the local-projection store (Layer A).
+ *
+ * These load document summaries and their container links straight from
+ * SQLite — no network — so the explorer can paint a container's contents on
+ * first open. They reuse the shared `documentSubtreeQueries` pipeline, kept in
+ * this small module so the local projection store does not import raw
+ * persistence itself.
+ */
+/**
+ * Load document summaries + container links for a flat set of container ids,
+ * directly from SQLite. Returns empty results when no containers are given.
+ */
+export async function loadLocalContainerProjectionDocumentsFromRuntime(input) {
+    const containerIds = Array.from(new Set(input.containerIds.filter((containerId) => typeof containerId === "string" && containerId.length > 0)));
+    if (containerIds.length === 0) {
+        return {
+            documentSummaries: [],
+            linkedContainerIdsByDocumentId: new Map(),
+        };
+    }
+    return listContainerContentsDocumentsForContainers(input.runtime.infra.execSql, containerIds, { sortDocumentSummaries: false });
+}
+//# sourceMappingURL=projectionView.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectionView.js","sourceRoot":"","sources":["projectionView.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,2CAA2C,EAAE,MAAM,0BAA0B,CAAC;AAEvF;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gDAAgD,CAAC,KAGtE;IACC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAC7B,IAAI,GAAG,CACL,KAAK,CAAC,YAAY,CAAC,MAAM,CACvB,CAAC,WAAW,EAAyB,EAAE,CACrC,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAC5D,CACF,CACF,CAAC;IACF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,iBAAiB,EAAE,EAAE;YACrB,8BAA8B,EAAE,IAAI,GAAG,EAAE;SAC1C,CAAC;IACJ,CAAC;IAED,OAAO,2CAA2C,CAChD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAC3B,YAAY,EACZ,EAAE,qBAAqB,EAAE,KAAK,EAAE,CACjC,CAAC;AACJ,CAAC","sourcesContent":["import type {\n  ContainerContentsSharedDocumentSummaries,\n  ContainerDocumentQueriesRuntime,\n} from \"./documentQueries/types\";\nimport { listContainerContentsDocumentsForContainers } from \"./documentSubtreeQueries\";\n\n/**\n * Device-first projection reads for the local-projection store (Layer A).\n *\n * These load document summaries and their container links straight from\n * SQLite — no network — so the explorer can paint a container's contents on\n * first open. They reuse the shared `documentSubtreeQueries` pipeline, kept in\n * this small module so the local projection store does not import raw\n * persistence itself.\n */\n\n/**\n * Load document summaries + container links for a flat set of container ids,\n * directly from SQLite. Returns empty results when no containers are given.\n */\nexport async function loadLocalContainerProjectionDocumentsFromRuntime(input: {\n  containerIds: ReadonlyArray<string>;\n  runtime: ContainerDocumentQueriesRuntime;\n}): Promise<ContainerContentsSharedDocumentSummaries> {\n  const containerIds = Array.from(\n    new Set(\n      input.containerIds.filter(\n        (containerId): containerId is string =>\n          typeof containerId === \"string\" && containerId.length > 0,\n      ),\n    ),\n  );\n  if (containerIds.length === 0) {\n    return {\n      documentSummaries: [],\n      linkedContainerIdsByDocumentId: new Map(),\n    };\n  }\n\n  return listContainerContentsDocumentsForContainers(\n    input.runtime.infra.execSql,\n    containerIds,\n    { sortDocumentSummaries: false },\n  );\n}\n"]}

package/workflows/container-contents/remoteContainerPageHydration.js

@@ -0,0 +1,244 @@
+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

@@ -0,0 +1 @@
+{"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"]}