@tearleads/client-sdk 0.1.62 → 0.1.64

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

@@ -1,244 +0,0 @@
-import { createRuntimePrincipalPolicyWarmer } from "../../principals/runtimePolicyWarmer.js";
-import { containerStateMatchesFingerprint } from "./containerStateFingerprint.js";
-import { prefetchDestinationProjections } from "./destinationPrefetch.js";
-import { cachedDestinationRole } from "./destinationRoleCache.js";
-import { markContainerParentLaneFetched } from "./laneFetchMarkers.js";
-import { fetchContainerParentLaneBatch } from "./parentLaneFetch.js";
-import { cacheRemoteContainerPrincipalPolicies } from "./principalPolicyCache.js";
-import { listRemoteContainerIdsWithPendingMetadataUpdates, listRemoteContainerIdsWithPendingStructuralIntents, upsertIsolatedRemoteContainerState, } from "./remoteContainerState.js";
-import { applyContainerTombstones, getApplicableRemoteContainerItems, } from "./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/remoteHydration/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 { containerStateMatchesFingerprint } from \"./containerStateFingerprint\";\nimport { prefetchDestinationProjections } from \"./destinationPrefetch\";\nimport { cachedDestinationRole } from \"./destinationRoleCache\";\nimport { markContainerParentLaneFetched } from \"./laneFetchMarkers\";\nimport { fetchContainerParentLaneBatch } from \"./parentLaneFetch\";\nimport { cacheRemoteContainerPrincipalPolicies } from \"./principalPolicyCache\";\nimport {\n  listRemoteContainerIdsWithPendingMetadataUpdates,\n  listRemoteContainerIdsWithPendingStructuralIntents,\n  upsertIsolatedRemoteContainerState,\n} from \"./remoteContainerState\";\nimport {\n  applyContainerTombstones,\n  getApplicableRemoteContainerItems,\n} from \"./tombstoneApplication\";\nimport type {\n  ContainerChildIndex,\n  ContainerParentHydrationLane,\n  ExpectedContainerState,\n  FetchedContainerParentLanePage,\n  ListedRemoteContainerPageItem,\n  QueueContainerParentLane,\n  RemoteContainerHydrationHost,\n  RemoteContainerHydrationState,\n} from \"./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"]}

package/workflows/container-contents/remoteHydration/remoteContainerState.js

@@ -1,263 +0,0 @@
-import { heldContainerBinding, listingRepeatsHeldOrdinaryBinding, } from "../../../data/containers/containerBinding.js";
-import { isKeyingVerificationError, runWithSecurityIncidentReporting, } from "../../../data/keyingProjectionVerification/error.js";
-import { isProjectionVerificationCancelledError } from "../../../data/keyingProjectionVerification/types.js";
-import { installContainerMetadataRecord } from "../metadata/metadataPersistence.js";
-import { projectionGeneration } from "../projectionGeneration.js";
-import { moveIndexedContainerChild, removeIndexedContainerChild, } from "./childIndex.js";
-import { rebindReHomedContainer } from "./heldContainerRebind.js";
-import { insertRemoteContainerState } from "./insertRemoteContainer.js";
-import { reconcileLocalOnlyRootContainers, reconcileLocalOnlySystemContainers, } from "./reconciliation.js";
-import { applyRemoteContainerTimestamps, remoteContainerHydrationSaveOptions, resolveRemoteContainerHydrationLocalUpdatedAt, } from "./remoteContainerTimestamps.js";
-import { verifyRemoteContainerDestination } from "./verifiedDestination.js";
-// Container ids (restricted to the inbound page) that carry an unsynced local
-// create or move intent. Such a container's parent and local-edit timestamp are
-// owned by its structural-intent lane until that lane reconciles, so inbound
-// hydration must not revert parentId to the server value nor collapse
-// localUpdatedAt — doing so silently undoes a queued move and falsely reads
-// "synced". Move intents are read via listUnsyncedMoveIntents so a blocked
-// move — one whose destination parent has not synced yet, the common boot-time
-// case — is protected too. Pending *metadata*
-// updates are handled separately (listRemoteContainerIdsWithPendingMetadataUpdates);
-// structural intents live in the local outbox's container lanes, which that
-// query does not cover.
-export async function listRemoteContainerIdsWithPendingStructuralIntents(input) {
-    if (input.remoteContainers.length === 0) {
-        return new Set();
-    }
-    const remoteContainerIds = new Set(input.remoteContainers.map((remoteContainer) => remoteContainer.id));
-    const execSql = input.state.runtime.infra.execSql;
-    const [pendingCreateIntents, unsyncedMoveIntents] = await Promise.all([
-        input.state.persistence.listPendingCreateIntents(execSql),
-        input.state.persistence.listUnsyncedMoveIntents(execSql),
-    ]);
-    const containerIdsWithPendingStructuralIntents = new Set();
-    for (const intent of pendingCreateIntents) {
-        if (remoteContainerIds.has(intent.containerId)) {
-            containerIdsWithPendingStructuralIntents.add(intent.containerId);
-        }
-    }
-    for (const intent of unsyncedMoveIntents) {
-        if (remoteContainerIds.has(intent.containerId)) {
-            containerIdsWithPendingStructuralIntents.add(intent.containerId);
-        }
-    }
-    return containerIdsWithPendingStructuralIntents;
-}
-export async function listRemoteContainerIdsWithPendingMetadataUpdates(input) {
-    const containerIds = input.remoteContainers.flatMap((remoteContainer) => {
-        const previousLocalUpdatedAt = input.state.containersById.get(remoteContainer.id)?.container.localUpdatedAt;
-        return previousLocalUpdatedAt &&
-            previousLocalUpdatedAt.localeCompare(remoteContainer.updatedAt) > 0
-            ? [remoteContainer.id]
-            : [];
-    });
-    if (containerIds.length === 0) {
-        return new Set();
-    }
-    const execSql = input.state.runtime.infra.execSql;
-    return new Set(await input.state.persistence.listContainerIdsWithPendingUpdates(execSql, containerIds));
-}
-function removeMissingHydratedContainer(input) {
-    const { existingState, remoteContainer, state } = input;
-    if (state.containersById.get(remoteContainer.id) !== existingState) {
-        return;
-    }
-    state.containersById.delete(remoteContainer.id);
-    if (input.childIdsByParentId) {
-        removeIndexedContainerChild(input.childIdsByParentId, remoteContainer.id, input.previousParentId);
-        input.childIdsByParentId.delete(remoteContainer.id);
-    }
-    input.host.updateSnapshot();
-}
-function createUpdatedRemoteContainerState(existingState, remoteContainer) {
-    return {
-        ...existingState,
-        container: applyRemoteContainerTimestamps(existingState.container, remoteContainer),
-        containerWriterProjection: null,
-        metadataReferencedPrincipals: remoteContainer.metadataReferencedPrincipals,
-    };
-}
-function installUpdatedRemoteContainerState(existingState, nextState, host) {
-    const wasLocalOnly = existingState.container.serverCreatedAt == null;
-    existingState.container = nextState.container;
-    existingState.containerWriterProjection = nextState.containerWriterProjection;
-    existingState.metadataReferencedPrincipals =
-        nextState.metadataReferencedPrincipals;
-    // The snapshot copied the live generation when it was taken; a hint that
-    // landed during the persist leaves the live metadata projection dropped.
-    if (projectionGeneration(existingState) === projectionGeneration(nextState))
-        existingState.metadataWriterProjection = nextState.metadataWriterProjection;
-    installContainerMetadataRecord(existingState, nextState.record);
-    // A document pass may have deferred while this root was awaiting proof.
-    // The first durable remote acknowledgement makes its pending creates runnable.
-    if (wasLocalOnly && existingState.container.serverCreatedAt != null)
-        host.requestDocumentPriming?.();
-}
-async function updateExistingRemoteContainerState(input) {
-    const { childIdsByParentId, existingState, host, remoteContainer, state } = input;
-    const previousParentId = existingState.container.parentId;
-    const previousLocalUpdatedAt = existingState.container.localUpdatedAt;
-    // A queued, not-yet-synced local move/create owns this container's parent
-    // until its intent lane reconciles. Omit the remote parent when the page scan
-    // saw one; persistence also rechecks the intent transactionally so a move
-    // created after that scan wins. Both paths preserve the durable local clock.
-    const hasPendingStructuralIntent = input.containerIdsWithPendingStructuralIntents.has(remoteContainer.id);
-    const nextParentId = hasPendingStructuralIntent
-        ? undefined
-        : remoteContainer.parentId;
-    const localUpdatedAt = resolveRemoteContainerHydrationLocalUpdatedAt({
-        containerIdsWithPendingMetadataUpdates: input.containerIdsWithPendingMetadataUpdates,
-        hasPendingStructuralIntent,
-        previousLocalUpdatedAt,
-        remoteContainer,
-    });
-    const nextState = createUpdatedRemoteContainerState(existingState, remoteContainer);
-    const persistenceResult = await host.persistContainerState(nextState, {
-        accessEpoch: remoteContainer.metadataAccessEpoch,
-        accessStateHash: remoteContainer.metadataAccessStateHash,
-        documentId: remoteContainer.metadataDocumentId,
-        effectiveAccessLevel: remoteContainer.effectiveAccessLevel,
-        metadataDocumentId: remoteContainer.metadataDocumentId,
-        systemSlot: remoteContainer.systemSlot ?? null,
-        organizationId: remoteContainer.organizationId,
-        ...(nextParentId !== undefined ? { parentId: nextParentId } : {}),
-    }, false, remoteContainerHydrationSaveOptions({
-        localUpdatedAt,
-        remoteContainer,
-    }), {
-        preserveDurableStructureWhenPending: true,
-    });
-    if (persistenceResult.status === "missing") {
-        // Hydration persists a detached candidate so an in-flight response cannot
-        // mutate mapped state before its guards settle. Retire the exact state this
-        // hydration read because store-level reference cleanup cannot see the clone.
-        removeMissingHydratedContainer({
-            childIdsByParentId,
-            existingState,
-            host,
-            previousParentId,
-            remoteContainer,
-            state,
-        });
-        return null;
-    }
-    if (persistenceResult.status !== "persisted")
-        return null;
-    const { record: nextRecord } = persistenceResult;
-    installContainerMetadataRecord(nextState, nextRecord);
-    if (input.isCurrent?.() === false) {
-        return existingState;
-    }
-    nextState.container = {
-        ...nextState.container,
-        metadataDocumentId: remoteContainer.metadataDocumentId,
-        organizationId: remoteContainer.organizationId,
-        parentId: nextState.container.parentId,
-    };
-    installUpdatedRemoteContainerState(existingState, nextState, host);
-    moveIndexedContainerChild(childIdsByParentId, remoteContainer.id, previousParentId, existingState.container.parentId);
-    await reconcileLocalOnlyRootContainers({
-        childIdsByParentId,
-        isCurrent: input.isCurrent,
-        remoteRootState: existingState,
-        requestDocumentPriming: host.requestDocumentPriming,
-        state,
-    });
-    return existingState;
-}
-export async function upsertRemoteContainerState(input) {
-    let expectedPlacementCheckpoint;
-    const heldState = input.state.containersById.get(input.remoteContainer.id);
-    const heldBinding = heldState
-        ? heldContainerBinding(heldState)
-        : await input.state.persistence.loadHeldContainerBinding(input.state.runtime.infra.execSql, input.remoteContainer.id);
-    const listed = input.remoteContainer;
-    // A folder re-homed away from the listed organization never returns there,
-    // whatever binding (possibly none, after a reset) the device holds now.
-    const supersededListing = !listingRepeatsHeldOrdinaryBinding(heldBinding, listed) &&
-        (await input.state.persistence.isSupersededContainerBinding(input.state.runtime.infra.execSql, { containerId: listed.id, organizationId: listed.organizationId }));
-    if (input.isCurrent?.() === false)
-        return null;
-    const verified = await verifyRemoteContainerDestination({
-        ...input,
-        heldBinding,
-        supersededListing,
-        refresh: !!input.expectedHydrationTombstone,
-        onVerifiedCheckpoint: (checkpoint) => {
-            expectedPlacementCheckpoint = checkpoint;
-        },
-    });
-    if (!verified || input.isCurrent?.() === false)
-        return null;
-    input = { ...input, remoteContainer: verified };
-    const existingState = input.state.containersById.get(input.remoteContainer.id);
-    const remoteState = await runWithSecurityIncidentReporting(input.state.runtime.util.reportSecurityIncident, {
-        objectId: verified.id,
-        objectKind: "container",
-        operation: "container.binding.persist",
-        organizationId: verified.organizationId,
-    }, async () => (await rebindReHomedContainer({
-        existingState,
-        heldBinding,
-        isCurrent: input.isCurrent,
-        state: input.state,
-        verified,
-    }))
-        ? persistVerifiedRemoteContainer({
-            ...input,
-            existingState,
-            expectedPlacementCheckpoint,
-        })
-        : null);
-    if (!remoteState) {
-        return null;
-    }
-    await reconcileLocalOnlySystemContainers({
-        childIdsByParentId: input.childIdsByParentId,
-        isCurrent: input.isCurrent,
-        requestDocumentPriming: input.host.requestDocumentPriming,
-        remoteSystemState: remoteState,
-        state: input.state,
-    });
-    return remoteState;
-}
-/**
- * Upsert one listed folder, isolating a rejected proof or binding. The refusal
- * was already reported; returning no state leaves the item unapplied without
- * blocking independent folders.
- */
-export async function upsertIsolatedRemoteContainerState(input) {
-    try {
-        return await upsertRemoteContainerState(input);
-    }
-    catch (error) {
-        if (!isKeyingVerificationError(error) &&
-            !isProjectionVerificationCancelledError(error))
-            throw error;
-        return null;
-    }
-}
-function persistVerifiedRemoteContainer(input) {
-    const { existingState, expectedPlacementCheckpoint } = input;
-    return existingState
-        ? updateExistingRemoteContainerState({
-            childIdsByParentId: input.childIdsByParentId,
-            containerIdsWithPendingMetadataUpdates: input.containerIdsWithPendingMetadataUpdates,
-            containerIdsWithPendingStructuralIntents: input.containerIdsWithPendingStructuralIntents,
-            existingState,
-            host: input.host,
-            isCurrent: input.isCurrent,
-            remoteContainer: input.remoteContainer,
-            state: input.state,
-        })
-        : insertRemoteContainerState({
-            childIdsByParentId: input.childIdsByParentId,
-            host: input.host,
-            expectedHydrationTombstone: input.expectedHydrationTombstone ?? null,
-            expectedPlacementCheckpoint,
-            isCurrent: input.isCurrent,
-            remoteContainer: input.remoteContainer,
-            state: input.state,
-        });
-}
-//# sourceMappingURL=remoteContainerState.js.map

package/workflows/container-contents/remoteHydration/remoteContainerState.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"remoteContainerState.js","sourceRoot":"","sources":["remoteContainerState.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AccessManifestCheckpoint } from \"@tearleads/crypto\";\nimport {\n  heldContainerBinding,\n  listingRepeatsHeldOrdinaryBinding,\n} from \"../../../data/containers/containerBinding\";\nimport {\n  isKeyingVerificationError,\n  runWithSecurityIncidentReporting,\n} from \"../../../data/keyingProjectionVerification/error\";\nimport { isProjectionVerificationCancelledError } from \"../../../data/keyingProjectionVerification/types\";\nimport type { ContainerHydrationTombstone } from \"../containerPersistence\";\nimport { installContainerMetadataRecord } from \"../metadata/metadataPersistence\";\nimport { projectionGeneration } from \"../projectionGeneration\";\nimport {\n  moveIndexedContainerChild,\n  removeIndexedContainerChild,\n} from \"./childIndex\";\nimport type { PrefetchedDestinationProjection } from \"./destinationPrefetch\";\nimport { rebindReHomedContainer } from \"./heldContainerRebind\";\nimport { insertRemoteContainerState } from \"./insertRemoteContainer\";\nimport {\n  reconcileLocalOnlyRootContainers,\n  reconcileLocalOnlySystemContainers,\n} from \"./reconciliation\";\nimport {\n  applyRemoteContainerTimestamps,\n  remoteContainerHydrationSaveOptions,\n  resolveRemoteContainerHydrationLocalUpdatedAt,\n} from \"./remoteContainerTimestamps\";\nimport type {\n  ContainerChildIndex,\n  ContainerState,\n  RemoteContainer,\n  RemoteContainerHydrationHost,\n  RemoteContainerHydrationState,\n} from \"./types\";\nimport { verifyRemoteContainerDestination } from \"./verifiedDestination\";\n\n// Container ids (restricted to the inbound page) that carry an unsynced local\n// create or move intent. Such a container's parent and local-edit timestamp are\n// owned by its structural-intent lane until that lane reconciles, so inbound\n// hydration must not revert parentId to the server value nor collapse\n// localUpdatedAt — doing so silently undoes a queued move and falsely reads\n// \"synced\". Move intents are read via listUnsyncedMoveIntents so a blocked\n// move — one whose destination parent has not synced yet, the common boot-time\n// case — is protected too. Pending *metadata*\n// updates are handled separately (listRemoteContainerIdsWithPendingMetadataUpdates);\n// structural intents live in the local outbox's container lanes, which that\n// query does not cover.\nexport async function listRemoteContainerIdsWithPendingStructuralIntents(input: {\n  remoteContainers: ReadonlyArray<RemoteContainer>;\n  state: RemoteContainerHydrationState;\n}): Promise<Set<string>> {\n  if (input.remoteContainers.length === 0) {\n    return new Set();\n  }\n  const remoteContainerIds = new Set(\n    input.remoteContainers.map((remoteContainer) => remoteContainer.id),\n  );\n\n  const execSql = input.state.runtime.infra.execSql;\n  const [pendingCreateIntents, unsyncedMoveIntents] = await Promise.all([\n    input.state.persistence.listPendingCreateIntents(execSql),\n    input.state.persistence.listUnsyncedMoveIntents(execSql),\n  ]);\n  const containerIdsWithPendingStructuralIntents = new Set<string>();\n  for (const intent of pendingCreateIntents) {\n    if (remoteContainerIds.has(intent.containerId)) {\n      containerIdsWithPendingStructuralIntents.add(intent.containerId);\n    }\n  }\n  for (const intent of unsyncedMoveIntents) {\n    if (remoteContainerIds.has(intent.containerId)) {\n      containerIdsWithPendingStructuralIntents.add(intent.containerId);\n    }\n  }\n  return containerIdsWithPendingStructuralIntents;\n}\n\nexport async function listRemoteContainerIdsWithPendingMetadataUpdates(input: {\n  remoteContainers: ReadonlyArray<RemoteContainer>;\n  state: RemoteContainerHydrationState;\n}): Promise<Set<string>> {\n  const containerIds = input.remoteContainers.flatMap((remoteContainer) => {\n    const previousLocalUpdatedAt = input.state.containersById.get(\n      remoteContainer.id,\n    )?.container.localUpdatedAt;\n\n    return previousLocalUpdatedAt &&\n      previousLocalUpdatedAt.localeCompare(remoteContainer.updatedAt) > 0\n      ? [remoteContainer.id]\n      : [];\n  });\n  if (containerIds.length === 0) {\n    return new Set();\n  }\n\n  const execSql = input.state.runtime.infra.execSql;\n  return new Set(\n    await input.state.persistence.listContainerIdsWithPendingUpdates(\n      execSql,\n      containerIds,\n    ),\n  );\n}\n\nfunction removeMissingHydratedContainer(input: {\n  childIdsByParentId?: ContainerChildIndex | undefined;\n  existingState: ContainerState;\n  host: RemoteContainerHydrationHost;\n  previousParentId: string | null;\n  remoteContainer: RemoteContainer;\n  state: RemoteContainerHydrationState;\n}): void {\n  const { existingState, remoteContainer, state } = input;\n  if (state.containersById.get(remoteContainer.id) !== existingState) {\n    return;\n  }\n\n  state.containersById.delete(remoteContainer.id);\n  if (input.childIdsByParentId) {\n    removeIndexedContainerChild(\n      input.childIdsByParentId,\n      remoteContainer.id,\n      input.previousParentId,\n    );\n    input.childIdsByParentId.delete(remoteContainer.id);\n  }\n  input.host.updateSnapshot();\n}\n\nfunction createUpdatedRemoteContainerState(\n  existingState: ContainerState,\n  remoteContainer: RemoteContainer,\n): ContainerState {\n  return {\n    ...existingState,\n    container: applyRemoteContainerTimestamps(\n      existingState.container,\n      remoteContainer,\n    ),\n    containerWriterProjection: null,\n    metadataReferencedPrincipals: remoteContainer.metadataReferencedPrincipals,\n  };\n}\n\nfunction installUpdatedRemoteContainerState(\n  existingState: ContainerState,\n  nextState: ContainerState,\n  host: RemoteContainerHydrationHost,\n): void {\n  const wasLocalOnly = existingState.container.serverCreatedAt == null;\n  existingState.container = nextState.container;\n  existingState.containerWriterProjection = nextState.containerWriterProjection;\n  existingState.metadataReferencedPrincipals =\n    nextState.metadataReferencedPrincipals;\n  // The snapshot copied the live generation when it was taken; a hint that\n  // landed during the persist leaves the live metadata projection dropped.\n  if (projectionGeneration(existingState) === projectionGeneration(nextState))\n    existingState.metadataWriterProjection = nextState.metadataWriterProjection;\n  installContainerMetadataRecord(existingState, nextState.record);\n  // A document pass may have deferred while this root was awaiting proof.\n  // The first durable remote acknowledgement makes its pending creates runnable.\n  if (wasLocalOnly && existingState.container.serverCreatedAt != null)\n    host.requestDocumentPriming?.();\n}\n\nasync function updateExistingRemoteContainerState(input: {\n  childIdsByParentId?: ContainerChildIndex | undefined;\n  containerIdsWithPendingMetadataUpdates: ReadonlySet<string>;\n  containerIdsWithPendingStructuralIntents: ReadonlySet<string>;\n  host: RemoteContainerHydrationHost;\n  isCurrent?: (() => boolean) | undefined;\n  existingState: ContainerState;\n  remoteContainer: RemoteContainer;\n  state: RemoteContainerHydrationState;\n}): Promise<ContainerState | null> {\n  const { childIdsByParentId, existingState, host, remoteContainer, state } =\n    input;\n  const previousParentId = existingState.container.parentId;\n  const previousLocalUpdatedAt = existingState.container.localUpdatedAt;\n  // A queued, not-yet-synced local move/create owns this container's parent\n  // until its intent lane reconciles. Omit the remote parent when the page scan\n  // saw one; persistence also rechecks the intent transactionally so a move\n  // created after that scan wins. Both paths preserve the durable local clock.\n  const hasPendingStructuralIntent =\n    input.containerIdsWithPendingStructuralIntents.has(remoteContainer.id);\n  const nextParentId = hasPendingStructuralIntent\n    ? undefined\n    : remoteContainer.parentId;\n  const localUpdatedAt = resolveRemoteContainerHydrationLocalUpdatedAt({\n    containerIdsWithPendingMetadataUpdates:\n      input.containerIdsWithPendingMetadataUpdates,\n    hasPendingStructuralIntent,\n    previousLocalUpdatedAt,\n    remoteContainer,\n  });\n  const nextState = createUpdatedRemoteContainerState(\n    existingState,\n    remoteContainer,\n  );\n  const persistenceResult = await host.persistContainerState(\n    nextState,\n    {\n      accessEpoch: remoteContainer.metadataAccessEpoch,\n      accessStateHash: remoteContainer.metadataAccessStateHash,\n      documentId: remoteContainer.metadataDocumentId,\n      effectiveAccessLevel: remoteContainer.effectiveAccessLevel,\n      metadataDocumentId: remoteContainer.metadataDocumentId,\n      systemSlot: remoteContainer.systemSlot ?? null,\n      organizationId: remoteContainer.organizationId,\n      ...(nextParentId !== undefined ? { parentId: nextParentId } : {}),\n    },\n    false,\n    remoteContainerHydrationSaveOptions({\n      localUpdatedAt,\n      remoteContainer,\n    }),\n    {\n      preserveDurableStructureWhenPending: true,\n    },\n  );\n  if (persistenceResult.status === \"missing\") {\n    // Hydration persists a detached candidate so an in-flight response cannot\n    // mutate mapped state before its guards settle. Retire the exact state this\n    // hydration read because store-level reference cleanup cannot see the clone.\n    removeMissingHydratedContainer({\n      childIdsByParentId,\n      existingState,\n      host,\n      previousParentId,\n      remoteContainer,\n      state,\n    });\n    return null;\n  }\n  if (persistenceResult.status !== \"persisted\") return null;\n  const { record: nextRecord } = persistenceResult;\n  installContainerMetadataRecord(nextState, nextRecord);\n  if (input.isCurrent?.() === false) {\n    return existingState;\n  }\n  nextState.container = {\n    ...nextState.container,\n    metadataDocumentId: remoteContainer.metadataDocumentId,\n    organizationId: remoteContainer.organizationId,\n    parentId: nextState.container.parentId,\n  };\n\n  installUpdatedRemoteContainerState(existingState, nextState, host);\n  moveIndexedContainerChild(\n    childIdsByParentId,\n    remoteContainer.id,\n    previousParentId,\n    existingState.container.parentId,\n  );\n  await reconcileLocalOnlyRootContainers({\n    childIdsByParentId,\n    isCurrent: input.isCurrent,\n    remoteRootState: existingState,\n    requestDocumentPriming: host.requestDocumentPriming,\n    state,\n  });\n  return existingState;\n}\n\ninterface UpsertRemoteContainerStateInput {\n  childIdsByParentId?: ContainerChildIndex | undefined;\n  containerIdsWithPendingMetadataUpdates: ReadonlySet<string>;\n  containerIdsWithPendingStructuralIntents: ReadonlySet<string>;\n  host: RemoteContainerHydrationHost;\n  expectedHydrationTombstone?: ContainerHydrationTombstone | null | undefined;\n  isCurrent?: (() => boolean) | undefined;\n  prefetchedProjection?: PrefetchedDestinationProjection | undefined;\n  remoteContainer: RemoteContainer;\n  state: RemoteContainerHydrationState;\n}\n\nexport async function upsertRemoteContainerState(\n  input: UpsertRemoteContainerStateInput,\n): Promise<ContainerState | null> {\n  let expectedPlacementCheckpoint: AccessManifestCheckpoint | undefined;\n  const heldState = input.state.containersById.get(input.remoteContainer.id);\n  const heldBinding = heldState\n    ? heldContainerBinding(heldState)\n    : await input.state.persistence.loadHeldContainerBinding(\n        input.state.runtime.infra.execSql,\n        input.remoteContainer.id,\n      );\n  const listed = input.remoteContainer;\n  // A folder re-homed away from the listed organization never returns there,\n  // whatever binding (possibly none, after a reset) the device holds now.\n  const supersededListing =\n    !listingRepeatsHeldOrdinaryBinding(heldBinding, listed) &&\n    (await input.state.persistence.isSupersededContainerBinding(\n      input.state.runtime.infra.execSql,\n      { containerId: listed.id, organizationId: listed.organizationId },\n    ));\n  if (input.isCurrent?.() === false) return null;\n  const verified = await verifyRemoteContainerDestination({\n    ...input,\n    heldBinding,\n    supersededListing,\n    refresh: !!input.expectedHydrationTombstone,\n    onVerifiedCheckpoint: (checkpoint) => {\n      expectedPlacementCheckpoint = checkpoint;\n    },\n  });\n  if (!verified || input.isCurrent?.() === false) return null;\n  input = { ...input, remoteContainer: verified };\n  const existingState = input.state.containersById.get(\n    input.remoteContainer.id,\n  );\n  const remoteState = await runWithSecurityIncidentReporting(\n    input.state.runtime.util.reportSecurityIncident,\n    {\n      objectId: verified.id,\n      objectKind: \"container\",\n      operation: \"container.binding.persist\",\n      organizationId: verified.organizationId,\n    },\n    async () =>\n      (await rebindReHomedContainer({\n        existingState,\n        heldBinding,\n        isCurrent: input.isCurrent,\n        state: input.state,\n        verified,\n      }))\n        ? persistVerifiedRemoteContainer({\n            ...input,\n            existingState,\n            expectedPlacementCheckpoint,\n          })\n        : null,\n  );\n  if (!remoteState) {\n    return null;\n  }\n  await reconcileLocalOnlySystemContainers({\n    childIdsByParentId: input.childIdsByParentId,\n    isCurrent: input.isCurrent,\n    requestDocumentPriming: input.host.requestDocumentPriming,\n    remoteSystemState: remoteState,\n    state: input.state,\n  });\n  return remoteState;\n}\n\n/**\n * Upsert one listed folder, isolating a rejected proof or binding. The refusal\n * was already reported; returning no state leaves the item unapplied without\n * blocking independent folders.\n */\nexport async function upsertIsolatedRemoteContainerState(\n  input: UpsertRemoteContainerStateInput,\n): Promise<ContainerState | null> {\n  try {\n    return await upsertRemoteContainerState(input);\n  } catch (error) {\n    if (\n      !isKeyingVerificationError(error) &&\n      !isProjectionVerificationCancelledError(error)\n    )\n      throw error;\n    return null;\n  }\n}\n\nfunction persistVerifiedRemoteContainer(\n  input: UpsertRemoteContainerStateInput & {\n    existingState: ContainerState | undefined;\n    expectedPlacementCheckpoint: AccessManifestCheckpoint | undefined;\n  },\n): Promise<ContainerState | null> {\n  const { existingState, expectedPlacementCheckpoint } = input;\n  return existingState\n    ? updateExistingRemoteContainerState({\n        childIdsByParentId: input.childIdsByParentId,\n        containerIdsWithPendingMetadataUpdates:\n          input.containerIdsWithPendingMetadataUpdates,\n        containerIdsWithPendingStructuralIntents:\n          input.containerIdsWithPendingStructuralIntents,\n        existingState,\n        host: input.host,\n        isCurrent: input.isCurrent,\n        remoteContainer: input.remoteContainer,\n        state: input.state,\n      })\n    : insertRemoteContainerState({\n        childIdsByParentId: input.childIdsByParentId,\n        host: input.host,\n        expectedHydrationTombstone: input.expectedHydrationTombstone ?? null,\n        expectedPlacementCheckpoint,\n        isCurrent: input.isCurrent,\n        remoteContainer: input.remoteContainer,\n        state: input.state,\n      });\n}\n"]}

package/workflows/container-contents/remoteHydration/remoteContainerTimestamps.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"remoteContainerTimestamps.js","sourceRoot":"","sources":["remoteContainerTimestamps.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,8BAA8B,CAC5C,SAA0B,EAC1B,eAAgC;IAEhC,OAAO;QACL,GAAG,SAAS;QACZ,SAAS,EAAE,eAAe,CAAC,SAAS;QACpC,oBAAoB,EAAE,eAAe,CAAC,oBAAoB;QAC1D,eAAe,EAAE,eAAe,CAAC,SAAS;QAC1C,eAAe,EAAE,eAAe,CAAC,SAAS;QAC1C,SAAS,EAAE,eAAe,CAAC,SAAS;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,KAGnD;IACC,OAAO;QACL,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,eAAe,CAAC,SAAS;QACvE,gBAAgB,EAAE;YAChB,SAAS,EAAE,KAAK,CAAC,eAAe,CAAC,SAAS;YAC1C,SAAS,EAAE,KAAK,CAAC,eAAe,CAAC,SAAS;SAC3C;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6CAA6C,CAAC,KAK7D;IACC,MAAM,EACJ,sCAAsC,EACtC,0BAA0B,EAC1B,sBAAsB,EACtB,eAAe,GAChB,GAAG,KAAK,CAAC;IACV,IACE,CAAC,sBAAsB;QACvB,sBAAsB,CAAC,aAAa,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,EACpE,CAAC;QACD,OAAO,eAAe,CAAC,SAAS,CAAC;IACnC,CAAC;IAED,OAAO,sCAAsC,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACnE,0BAA0B;QAC1B,CAAC,CAAC,sBAAsB;QACxB,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC;AAChC,CAAC","sourcesContent":["import type { ContainerRecord } from \"../containerPersistence\";\nimport type { RemoteContainer, SaveContainerOptions } from \"./types\";\n\nexport function applyRemoteContainerTimestamps(\n  container: ContainerRecord,\n  remoteContainer: RemoteContainer,\n): ContainerRecord {\n  return {\n    ...container,\n    createdAt: remoteContainer.createdAt,\n    effectiveAccessLevel: remoteContainer.effectiveAccessLevel,\n    serverCreatedAt: remoteContainer.createdAt,\n    serverUpdatedAt: remoteContainer.updatedAt,\n    updatedAt: remoteContainer.updatedAt,\n  };\n}\n\nexport function remoteContainerHydrationSaveOptions(input: {\n  localUpdatedAt?: string | null | undefined;\n  remoteContainer: RemoteContainer;\n}): NonNullable<SaveContainerOptions> {\n  return {\n    localUpdatedAt: input.localUpdatedAt ?? input.remoteContainer.updatedAt,\n    serverTimestamps: {\n      createdAt: input.remoteContainer.createdAt,\n      updatedAt: input.remoteContainer.updatedAt,\n    },\n  };\n}\n\nexport function resolveRemoteContainerHydrationLocalUpdatedAt(input: {\n  containerIdsWithPendingMetadataUpdates: ReadonlySet<string>;\n  hasPendingStructuralIntent: boolean;\n  previousLocalUpdatedAt: string | null | undefined;\n  remoteContainer: RemoteContainer;\n}): string {\n  const {\n    containerIdsWithPendingMetadataUpdates,\n    hasPendingStructuralIntent,\n    previousLocalUpdatedAt,\n    remoteContainer,\n  } = input;\n  if (\n    !previousLocalUpdatedAt ||\n    previousLocalUpdatedAt.localeCompare(remoteContainer.updatedAt) <= 0\n  ) {\n    return remoteContainer.updatedAt;\n  }\n\n  return containerIdsWithPendingMetadataUpdates.has(remoteContainer.id) ||\n    hasPendingStructuralIntent\n    ? previousLocalUpdatedAt\n    : remoteContainer.updatedAt;\n}\n"]}