@tearleads/client-sdk 0.1.61 → 0.1.63

package/workflows/container-contents/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 "./metadataPersistence.js";
-import { projectionGeneration } from "./projectionGeneration.js";
-import { moveIndexedContainerChild, removeIndexedContainerChild, } from "./remoteHydration/childIndex.js";
-import { rebindReHomedContainer } from "./remoteHydration/heldContainerRebind.js";
-import { insertRemoteContainerState } from "./remoteHydration/insertRemoteContainer.js";
-import { reconcileLocalOnlyRootContainers, reconcileLocalOnlySystemContainers, } from "./remoteHydration/reconciliation.js";
-import { applyRemoteContainerTimestamps, remoteContainerHydrationSaveOptions, resolveRemoteContainerHydrationLocalUpdatedAt, } from "./remoteHydration/remoteContainerTimestamps.js";
-import { verifyRemoteContainerDestination } from "./remoteHydration/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/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 \"./metadataPersistence\";\nimport { projectionGeneration } from \"./projectionGeneration\";\nimport {\n  moveIndexedContainerChild,\n  removeIndexedContainerChild,\n} from \"./remoteHydration/childIndex\";\nimport type { PrefetchedDestinationProjection } from \"./remoteHydration/destinationPrefetch\";\nimport { rebindReHomedContainer } from \"./remoteHydration/heldContainerRebind\";\nimport { insertRemoteContainerState } from \"./remoteHydration/insertRemoteContainer\";\nimport {\n  reconcileLocalOnlyRootContainers,\n  reconcileLocalOnlySystemContainers,\n} from \"./remoteHydration/reconciliation\";\nimport {\n  applyRemoteContainerTimestamps,\n  remoteContainerHydrationSaveOptions,\n  resolveRemoteContainerHydrationLocalUpdatedAt,\n} from \"./remoteHydration/remoteContainerTimestamps\";\nimport type {\n  ContainerChildIndex,\n  ContainerState,\n  RemoteContainer,\n  RemoteContainerHydrationHost,\n  RemoteContainerHydrationState,\n} from \"./remoteHydration/types\";\nimport { verifyRemoteContainerDestination } from \"./remoteHydration/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.d.ts

@@ -1,28 +0,0 @@
-import type { RemoteContainer, RemoteContainerHydrationHost, RemoteContainerHydrationState } from "./remoteHydration/types.js";
-export type { ContainerState, PersistContainerStateResult, RemoteContainer, RemoteContainerHydrationHost, } from "./remoteHydration/types.js";
-export declare class StaleRemoteHydrationError extends Error {
-}
-export declare function createGenerationGuardedHydrationHost(input: {
-    host: RemoteContainerHydrationHost;
-    isCurrent: () => boolean;
-}): RemoteContainerHydrationHost;
-interface RemoteContainerIngestor {
-    (remoteContainer: RemoteContainer): Promise<void>;
-    hasPending: () => boolean;
-    resume: () => Promise<void>;
-}
-export declare function createRemoteContainerIngestor(input: {
-    getSerializationBarrier?: (() => Promise<void> | null) | undefined;
-    host: RemoteContainerHydrationHost;
-    state: RemoteContainerHydrationState;
-}): RemoteContainerIngestor;
-export declare function hydrateRemoteContainers(input: {
-    followDiscoveredParentLanes?: boolean | undefined;
-    host: RemoteContainerHydrationHost;
-    isCurrent?: (() => boolean) | undefined;
-    onFullyHydrated?: (() => Promise<void> | void) | undefined;
-    parentIds?: ReadonlyArray<string | null> | undefined;
-    resetAllLaneWatermarks?: boolean | undefined;
-    resetRootLaneWatermark?: boolean | undefined;
-    state: RemoteContainerHydrationState;
-}): Promise<number>;

package/workflows/container-contents/remoteHydration.js

@@ -1,302 +0,0 @@
-import { createRuntimePrincipalPolicyWarmer } from "../principals/runtimePolicyWarmer.js";
-import { canHydrateRemoteContainers, hydrateContainerParentLanes, } from "./remoteContainerPageHydration.js";
-import { listRemoteContainerIdsWithPendingMetadataUpdates, listRemoteContainerIdsWithPendingStructuralIntents, upsertIsolatedRemoteContainerState, } from "./remoteContainerState.js";
-import { createContainerChildIndex } from "./remoteHydration/childIndex.js";
-import { finishRemoteHydration } from "./remoteHydration/completeHydration.js";
-import { createContainerParentHydrationQueue } from "./remoteHydration/parentLaneQueue.js";
-import { cacheRemoteContainerPrincipalPolicies } from "./remoteHydration/principalPolicyCache.js";
-export class StaleRemoteHydrationError extends Error {
-}
-export function createGenerationGuardedHydrationHost(input) {
-    const assertCurrent = () => {
-        if (!input.isCurrent()) {
-            throw new StaleRemoteHydrationError();
-        }
-    };
-    return {
-        persistContainerState: async (containerState, patch, updateView, saveOptions, mutationOptions) => {
-            const callerIsCurrent = mutationOptions?.isCurrent;
-            const isCurrent = callerIsCurrent
-                ? () => input.isCurrent() && callerIsCurrent()
-                : input.isCurrent;
-            assertCurrent();
-            const record = await input.host.persistContainerState(containerState, patch, updateView, saveOptions, { ...mutationOptions, isCurrent });
-            assertCurrent();
-            return record;
-        },
-        ...(input.host.requestDocumentPriming
-            ? {
-                requestDocumentPriming: () => {
-                    if (input.isCurrent()) {
-                        input.host.requestDocumentPriming?.();
-                    }
-                },
-            }
-            : {}),
-        updateSnapshot: () => {
-            if (input.isCurrent()) {
-                input.host.updateSnapshot();
-            }
-        },
-    };
-}
-function remoteContainerIngestGeneration(state) {
-    return {
-        lifecycle: state.lifecycleGeneration,
-        structural: state.structuralGeneration,
-    };
-}
-function remoteContainerIngestGenerationsMatch(left, right) {
-    return (left !== undefined &&
-        left.lifecycle === right.lifecycle &&
-        left.structural === right.structural);
-}
-function isCurrentQueuedRemoteContainer(generation, generationByContainerId, queue, remoteContainer) {
-    return (queue.get(remoteContainer.id) === remoteContainer &&
-        remoteContainerIngestGenerationsMatch(generationByContainerId.get(remoteContainer.id), generation));
-}
-async function upsertQueuedRemoteContainer(input) {
-    const { containerIdsWithPendingMetadataUpdates, containerIdsWithPendingStructuralIntents, generation, generationByContainerId, host, queue, queuedRemoteContainer, state, } = input;
-    if (!input.isCurrent() ||
-        !isCurrentQueuedRemoteContainer(generation, generationByContainerId, queue, queuedRemoteContainer)) {
-        return false;
-    }
-    const tombstones = await state.persistence.loadContainerHydrationTombstones(state.runtime.infra.execSql);
-    // A refused folder is reported and acknowledged; the batch continues.
-    const upserted = await upsertIsolatedRemoteContainerState({
-        expectedHydrationTombstone: tombstones.find((row) => row.containerId === queuedRemoteContainer.id) ??
-            null,
-        containerIdsWithPendingMetadataUpdates,
-        containerIdsWithPendingStructuralIntents,
-        host,
-        isCurrent: input.isCurrent,
-        remoteContainer: queuedRemoteContainer,
-        state,
-    });
-    if (!upserted) {
-        return false;
-    }
-    return true;
-}
-function acknowledgeRemoteContainerIngestBatch(input) {
-    if (!input.isCurrent()) {
-        return;
-    }
-    for (const queuedRemoteContainer of input.queuedRemoteContainers) {
-        if (isCurrentQueuedRemoteContainer(input.generation, input.generationByContainerId, input.queue, queuedRemoteContainer)) {
-            input.queue.delete(queuedRemoteContainer.id);
-            input.generationByContainerId.delete(queuedRemoteContainer.id);
-        }
-    }
-}
-async function drainRemoteContainerIngestQueue(input) {
-    const { generation, generationByContainerId, host, queue, state } = input;
-    let shouldUpdateSnapshot = false;
-    try {
-        while (input.isCurrent()) {
-            const queuedRemoteContainers = Array.from(queue.values()).filter((remoteContainer) => remoteContainerIngestGenerationsMatch(generationByContainerId.get(remoteContainer.id), generation));
-            if (queuedRemoteContainers.length === 0) {
-                return;
-            }
-            await cacheRemoteContainerPrincipalPolicies({
-                cacheReferencedPrincipalPolicies: createRuntimePrincipalPolicyWarmer(state.runtime),
-                remoteContainers: queuedRemoteContainers,
-                stillCurrent: input.isCurrent,
-            });
-            if (!input.isCurrent()) {
-                return;
-            }
-            const [containerIdsWithPendingMetadataUpdates, containerIdsWithPendingStructuralIntents,] = await Promise.all([
-                listRemoteContainerIdsWithPendingMetadataUpdates({
-                    remoteContainers: queuedRemoteContainers,
-                    state,
-                }),
-                listRemoteContainerIdsWithPendingStructuralIntents({
-                    remoteContainers: queuedRemoteContainers,
-                    state,
-                }),
-            ]);
-            if (!input.isCurrent()) {
-                return;
-            }
-            for (const queuedRemoteContainer of queuedRemoteContainers) {
-                shouldUpdateSnapshot =
-                    (await upsertQueuedRemoteContainer({
-                        containerIdsWithPendingMetadataUpdates,
-                        containerIdsWithPendingStructuralIntents,
-                        generation,
-                        generationByContainerId,
-                        host,
-                        isCurrent: input.isCurrent,
-                        queue,
-                        queuedRemoteContainer,
-                        state,
-                    })) || shouldUpdateSnapshot;
-            }
-            acknowledgeRemoteContainerIngestBatch({
-                generation,
-                generationByContainerId,
-                isCurrent: input.isCurrent,
-                queue,
-                queuedRemoteContainers,
-            });
-            if (shouldUpdateSnapshot) {
-                host.updateSnapshot();
-                shouldUpdateSnapshot = false;
-            }
-        }
-    }
-    catch (error) {
-        if (shouldUpdateSnapshot) {
-            host.updateSnapshot();
-        }
-        throw error;
-    }
-}
-function isRemoteContainerIngestGenerationCurrent(state, generation) {
-    return remoteContainerIngestGenerationsMatch(remoteContainerIngestGeneration(state), generation);
-}
-function settleStaleRemoteContainerIngestGeneration(input) {
-    const currentGeneration = remoteContainerIngestGeneration(input.state);
-    const shouldReplay = currentGeneration.lifecycle !== input.generation.lifecycle &&
-        currentGeneration.structural === input.generation.structural;
-    for (const [containerId, generation] of input.generationByContainerId) {
-        if (!remoteContainerIngestGenerationsMatch(generation, input.generation)) {
-            continue;
-        }
-        if (shouldReplay) {
-            input.generationByContainerId.set(containerId, currentGeneration);
-        }
-        else {
-            input.generationByContainerId.delete(containerId);
-            input.queue.delete(containerId);
-        }
-    }
-}
-export function createRemoteContainerIngestor(input) {
-    const { host, state } = input;
-    const pendingRemoteContainersById = new Map();
-    const generationByContainerId = new Map();
-    let ingestRemoteContainersPromise = null;
-    const runNextGeneration = () => {
-        if (ingestRemoteContainersPromise) {
-            return ingestRemoteContainersPromise.then(runNextGeneration, runNextGeneration);
-        }
-        if (state.runtime.infra.dbStatus !== undefined &&
-            state.runtime.infra.dbStatus !== "ready") {
-            return Promise.resolve();
-        }
-        const serializationBarrier = input.getSerializationBarrier?.();
-        if (serializationBarrier) {
-            return serializationBarrier.then(runNextGeneration);
-        }
-        const nextContainerId = pendingRemoteContainersById.keys().next().value;
-        if (typeof nextContainerId !== "string") {
-            return Promise.resolve();
-        }
-        const generation = generationByContainerId.get(nextContainerId);
-        if (!generation) {
-            pendingRemoteContainersById.delete(nextContainerId);
-            return runNextGeneration();
-        }
-        const isCurrent = () => isRemoteContainerIngestGenerationCurrent(state, generation);
-        const guardedHost = createGenerationGuardedHydrationHost({
-            host,
-            isCurrent,
-        });
-        const nextPromise = Promise.resolve()
-            .then(() => drainRemoteContainerIngestQueue({
-            generation,
-            generationByContainerId,
-            host: guardedHost,
-            isCurrent,
-            queue: pendingRemoteContainersById,
-            state,
-        }))
-            .then(() => {
-            if (!isCurrent()) {
-                settleStaleRemoteContainerIngestGeneration({
-                    generation,
-                    generationByContainerId,
-                    queue: pendingRemoteContainersById,
-                    state,
-                });
-            }
-        })
-            .catch((error) => {
-            if (!isCurrent() || error instanceof StaleRemoteHydrationError) {
-                settleStaleRemoteContainerIngestGeneration({
-                    generation,
-                    generationByContainerId,
-                    queue: pendingRemoteContainersById,
-                    state,
-                });
-                return;
-            }
-            throw error;
-        })
-            .finally(() => {
-            if (ingestRemoteContainersPromise === nextPromise) {
-                ingestRemoteContainersPromise = null;
-            }
-        });
-        ingestRemoteContainersPromise = nextPromise;
-        return nextPromise.then(() => pendingRemoteContainersById.size > 0 ? runNextGeneration() : undefined);
-    };
-    const ingestRemoteContainer = (remoteContainer) => {
-        pendingRemoteContainersById.set(remoteContainer.id, remoteContainer);
-        generationByContainerId.set(remoteContainer.id, remoteContainerIngestGeneration(state));
-        return runNextGeneration();
-    };
-    ingestRemoteContainer.hasPending = () => pendingRemoteContainersById.size > 0;
-    ingestRemoteContainer.resume = runNextGeneration;
-    return ingestRemoteContainer;
-}
-export async function hydrateRemoteContainers(input) {
-    const { host, state } = input;
-    if (!canHydrateRemoteContainers(state) || input.isCurrent?.() === false) {
-        return 0;
-    }
-    const seenContainerIds = new Set();
-    const containerIdsBeforeHydration = new Set(state.containersById.keys());
-    const childIdsByParentId = createContainerChildIndex(state.containersById);
-    const { lanes, queueParentLane } = createContainerParentHydrationQueue({
-        containerIds: state.containersById.keys(),
-        parentIds: input.parentIds,
-        resetAllLaneWatermarks: input.resetAllLaneWatermarks,
-        resetRootLaneWatermark: input.resetRootLaneWatermark,
-    });
-    // Follow child lanes during an explicit recursive crawl or for containers first
-    // discovered in this pass. The latter lets a newly authorized root populate its
-    // descendants immediately, while routine ticks keep known subtrees cache-first.
-    const queueDiscoveredParentLane = (containerId) => {
-        if (input.followDiscoveredParentLanes ||
-            (containerId !== null && !containerIdsBeforeHydration.has(containerId))) {
-            queueParentLane(containerId);
-        }
-    };
-    const result = await hydrateContainerParentLanes({
-        childIdsByParentId,
-        host,
-        isCurrent: input.isCurrent,
-        lanes,
-        queueParentLane: queueDiscoveredParentLane,
-        seenContainerIds,
-        state,
-    });
-    const { changedCount } = result;
-    await finishRemoteHydration({
-        changedCount,
-        complete: result.complete &&
-            canHydrateRemoteContainers(state) &&
-            input.isCurrent?.() !== false,
-        containerIdsBeforeHydration,
-        host,
-        isCurrent: input.isCurrent,
-        onFullyHydrated: input.onFullyHydrated,
-        seenContainerIds,
-        state,
-    });
-    return changedCount;
-}
-//# sourceMappingURL=remoteHydration.js.map