@tearleads/client-sdk 0.0.0-stage → 0.1.13

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

@@ -0,0 +1,149 @@
+import { isCanonicalSignedAt } from "../../../internal/validators/util/index.js";
+import { removeIndexedContainerChild } from "./childIndex.js";
+import { containerStateMatchesFingerprint } from "./containerStateFingerprint.js";
+import { collectRemovedContainers } from "./tombstoneReasons.js";
+function latestContainerItemsById(items) {
+    const latestItems = new Map();
+    for (const item of items) {
+        const current = latestItems.get(item.id);
+        if (!current || current.updatedAt < item.updatedAt) {
+            latestItems.set(item.id, item);
+        }
+    }
+    return latestItems;
+}
+function latestContainerTombstonesById(tombstones) {
+    const latestTombstones = new Map();
+    for (const tombstone of tombstones) {
+        if (!isCanonicalSignedAt(tombstone.updatedAt))
+            throw new Error("Container tombstone timestamp is not canonical");
+        const current = latestTombstones.get(tombstone.containerId);
+        if (!current ||
+            current.updatedAt < tombstone.updatedAt ||
+            (current.updatedAt === tombstone.updatedAt &&
+                current.reason === "access_revoked" &&
+                tombstone.reason === "deleted")) {
+            latestTombstones.set(tombstone.containerId, tombstone);
+        }
+    }
+    return latestTombstones;
+}
+function getApplicableContainerTombstones(response) {
+    const latestItems = latestContainerItemsById(response.items);
+    return Array.from(latestContainerTombstonesById(response.tombstones).values()).filter((tombstone) => {
+        const item = latestItems.get(tombstone.containerId);
+        return (!item ||
+            item.updatedAt < tombstone.updatedAt ||
+            (item.updatedAt === tombstone.updatedAt && tombstone.reason === "deleted"));
+    });
+}
+export function getApplicableRemoteContainerItems(response) {
+    const latestTombstones = latestContainerTombstonesById(response.tombstones);
+    return response.items.filter((item) => {
+        const tombstone = latestTombstones.get(item.id);
+        return (!tombstone ||
+            tombstone.updatedAt < item.updatedAt ||
+            (tombstone.updatedAt === item.updatedAt &&
+                tombstone.reason === "access_revoked"));
+    });
+}
+async function applyContainerTombstoneCascade(input) {
+    const { childIdsByParentId, expectedContainerStates, preservedContainerIds, state, tombstone, } = input;
+    const { fenceOnlyContainerIds, absentDeletedContainerIds, removalByContainerId, removedContainerIds, } = collectRemovedContainers({
+        childIdsByParentId,
+        containersById: state.containersById,
+        preservedContainerIds,
+        tombstones: [tombstone],
+    });
+    const affectedContainerIds = new Set([
+        ...removedContainerIds,
+        ...absentDeletedContainerIds,
+        ...fenceOnlyContainerIds,
+    ]);
+    for (const containerId of affectedContainerIds) {
+        if (!containerStateMatchesFingerprint({
+            currentState: state.containersById.get(containerId),
+            expectedFingerprint: expectedContainerStates.get(containerId)?.fingerprint,
+        })) {
+            return { current: true, removedCount: 0, settled: false };
+        }
+    }
+    const deletedContainerIds = await state.persistence.deleteContainers(state.runtime.infra.execSql, [
+        ...removedContainerIds,
+        ...absentDeletedContainerIds,
+        ...fenceOnlyContainerIds,
+    ].flatMap((containerId) => {
+        const removal = removalByContainerId.get(containerId);
+        return removal ? [{ containerId, ...removal }] : [];
+    }), {
+        discoveryOnly: true,
+        expectedContainers: Array.from(affectedContainerIds, (containerId) => ({
+            containerId,
+            expectedContainer: expectedContainerStates.get(containerId)?.container ?? null,
+        })),
+        stillCurrent: input.isCurrent,
+    });
+    if (deletedContainerIds.length !== affectedContainerIds.size) {
+        return { current: true, removedCount: 0, settled: false };
+    }
+    if (input.isCurrent?.() === false) {
+        return { current: false, removedCount: 0, settled: false };
+    }
+    for (const containerId of removedContainerIds) {
+        const parentId = state.containersById.get(containerId)?.container.parentId ?? null;
+        removeIndexedContainerChild(childIdsByParentId, containerId, parentId);
+        childIdsByParentId.delete(containerId);
+        state.containersById.delete(containerId);
+    }
+    return {
+        current: true,
+        removedCount: removedContainerIds.length,
+        settled: true,
+    };
+}
+export async function applyContainerTombstones(input) {
+    const tombstones = getApplicableContainerTombstones(input.response);
+    if (tombstones.length === 0 || input.isCurrent?.() === false) {
+        return {
+            changedCount: 0,
+            completed: true,
+            current: input.isCurrent?.() !== false,
+        };
+    }
+    const tombstoneRootIds = new Set(tombstones.map((tombstone) => tombstone.containerId));
+    const liveContainerIds = input.remoteContainerItems.map((item) => item.id);
+    let changedCount = 0;
+    let completed = true;
+    for (const tombstone of tombstones) {
+        if (input.isCurrent?.() === false) {
+            return { changedCount, completed: false, current: false };
+        }
+        // Apply each root as its own CAS-protected cascade. Other explicit roots
+        // stay out of this cascade so their own reason wins and one stale root
+        // cannot block independent tombstones or live items on the page.
+        const preservedContainerIds = new Set([
+            ...liveContainerIds,
+            ...tombstoneRootIds,
+            ...Array.from(input.state.containersById, ([id, state]) => state.container.metadataDocumentId === null ? id : null).filter((id) => id !== null),
+        ]);
+        if (input.state.containersById.get(tombstone.containerId)?.container
+            .metadataDocumentId !== null) {
+            preservedContainerIds.delete(tombstone.containerId);
+        }
+        const result = await applyContainerTombstoneCascade({
+            childIdsByParentId: input.childIdsByParentId,
+            expectedContainerStates: input.expectedContainerStates,
+            isCurrent: input.isCurrent,
+            preservedContainerIds,
+            state: input.state,
+            tombstone,
+        });
+        changedCount += result.removedCount;
+        completed = completed && result.settled;
+        if (!result.current) {
+            return { changedCount, completed: false, current: false };
+        }
+    }
+    return { changedCount, completed, current: true };
+}
+//# sourceMappingURL=tombstoneApplication.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tombstoneApplication.js","sourceRoot":"","sources":["tombstoneApplication.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ContainerSyncTombstone,\n  ListContainersResponse,\n} from \"@tearleads/validators/response\";\nimport { isCanonicalSignedAt } from \"@tearleads/validators/util\";\nimport { removeIndexedContainerChild } from \"./childIndex\";\nimport { containerStateMatchesFingerprint } from \"./containerStateFingerprint\";\nimport { collectRemovedContainers } from \"./tombstoneReasons\";\nimport type {\n  ContainerChildIndex,\n  ExpectedContainerState,\n  ListedRemoteContainerPageItem,\n  RemoteContainerHydrationState,\n} from \"./types\";\n\nfunction latestContainerItemsById(\n  items: ReadonlyArray<ListedRemoteContainerPageItem>,\n): Map<string, ListedRemoteContainerPageItem> {\n  const latestItems = new Map<string, ListedRemoteContainerPageItem>();\n  for (const item of items) {\n    const current = latestItems.get(item.id);\n    if (!current || current.updatedAt < item.updatedAt) {\n      latestItems.set(item.id, item);\n    }\n  }\n\n  return latestItems;\n}\n\nfunction latestContainerTombstonesById(\n  tombstones: ReadonlyArray<ContainerSyncTombstone>,\n): Map<string, ContainerSyncTombstone> {\n  const latestTombstones = new Map<string, ContainerSyncTombstone>();\n  for (const tombstone of tombstones) {\n    if (!isCanonicalSignedAt(tombstone.updatedAt))\n      throw new Error(\"Container tombstone timestamp is not canonical\");\n    const current = latestTombstones.get(tombstone.containerId);\n    if (\n      !current ||\n      current.updatedAt < tombstone.updatedAt ||\n      (current.updatedAt === tombstone.updatedAt &&\n        current.reason === \"access_revoked\" &&\n        tombstone.reason === \"deleted\")\n    ) {\n      latestTombstones.set(tombstone.containerId, tombstone);\n    }\n  }\n\n  return latestTombstones;\n}\n\nfunction getApplicableContainerTombstones(\n  response: ListContainersResponse,\n): ContainerSyncTombstone[] {\n  const latestItems = latestContainerItemsById(response.items);\n  return Array.from(\n    latestContainerTombstonesById(response.tombstones).values(),\n  ).filter((tombstone) => {\n    const item = latestItems.get(tombstone.containerId);\n    return (\n      !item ||\n      item.updatedAt < tombstone.updatedAt ||\n      (item.updatedAt === tombstone.updatedAt && tombstone.reason === \"deleted\")\n    );\n  });\n}\n\nexport function getApplicableRemoteContainerItems(\n  response: ListContainersResponse,\n): ListedRemoteContainerPageItem[] {\n  const latestTombstones = latestContainerTombstonesById(response.tombstones);\n  return response.items.filter((item) => {\n    const tombstone = latestTombstones.get(item.id);\n    return (\n      !tombstone ||\n      tombstone.updatedAt < item.updatedAt ||\n      (tombstone.updatedAt === item.updatedAt &&\n        tombstone.reason === \"access_revoked\")\n    );\n  });\n}\n\nasync function applyContainerTombstoneCascade(input: {\n  childIdsByParentId: ContainerChildIndex;\n  expectedContainerStates: ReadonlyMap<string, ExpectedContainerState>;\n  isCurrent?: (() => boolean) | undefined;\n  preservedContainerIds: ReadonlySet<string>;\n  state: RemoteContainerHydrationState;\n  tombstone: ContainerSyncTombstone;\n}): Promise<{ current: boolean; removedCount: number; settled: boolean }> {\n  const {\n    childIdsByParentId,\n    expectedContainerStates,\n    preservedContainerIds,\n    state,\n    tombstone,\n  } = input;\n  const {\n    fenceOnlyContainerIds,\n    absentDeletedContainerIds,\n    removalByContainerId,\n    removedContainerIds,\n  } = collectRemovedContainers({\n    childIdsByParentId,\n    containersById: state.containersById,\n    preservedContainerIds,\n    tombstones: [tombstone],\n  });\n  const affectedContainerIds = new Set([\n    ...removedContainerIds,\n    ...absentDeletedContainerIds,\n    ...fenceOnlyContainerIds,\n  ]);\n  for (const containerId of affectedContainerIds) {\n    if (\n      !containerStateMatchesFingerprint({\n        currentState: state.containersById.get(containerId),\n        expectedFingerprint:\n          expectedContainerStates.get(containerId)?.fingerprint,\n      })\n    ) {\n      return { current: true, removedCount: 0, settled: false };\n    }\n  }\n\n  const deletedContainerIds = await state.persistence.deleteContainers(\n    state.runtime.infra.execSql,\n    [\n      ...removedContainerIds,\n      ...absentDeletedContainerIds,\n      ...fenceOnlyContainerIds,\n    ].flatMap((containerId) => {\n      const removal = removalByContainerId.get(containerId);\n      return removal ? [{ containerId, ...removal }] : [];\n    }),\n    {\n      discoveryOnly: true,\n      expectedContainers: Array.from(affectedContainerIds, (containerId) => ({\n        containerId,\n        expectedContainer:\n          expectedContainerStates.get(containerId)?.container ?? null,\n      })),\n      stillCurrent: input.isCurrent,\n    },\n  );\n  if (deletedContainerIds.length !== affectedContainerIds.size) {\n    return { current: true, removedCount: 0, settled: false };\n  }\n  if (input.isCurrent?.() === false) {\n    return { current: false, removedCount: 0, settled: false };\n  }\n  for (const containerId of removedContainerIds) {\n    const parentId =\n      state.containersById.get(containerId)?.container.parentId ?? null;\n    removeIndexedContainerChild(childIdsByParentId, containerId, parentId);\n    childIdsByParentId.delete(containerId);\n    state.containersById.delete(containerId);\n  }\n\n  return {\n    current: true,\n    removedCount: removedContainerIds.length,\n    settled: true,\n  };\n}\n\nexport async function applyContainerTombstones(input: {\n  childIdsByParentId: ContainerChildIndex;\n  expectedContainerStates: ReadonlyMap<string, ExpectedContainerState>;\n  isCurrent?: (() => boolean) | undefined;\n  remoteContainerItems: ReadonlyArray<ListedRemoteContainerPageItem>;\n  response: ListContainersResponse;\n  state: RemoteContainerHydrationState;\n}): Promise<{ changedCount: number; completed: boolean; current: boolean }> {\n  const tombstones = getApplicableContainerTombstones(input.response);\n  if (tombstones.length === 0 || input.isCurrent?.() === false) {\n    return {\n      changedCount: 0,\n      completed: true,\n      current: input.isCurrent?.() !== false,\n    };\n  }\n\n  const tombstoneRootIds = new Set(\n    tombstones.map((tombstone) => tombstone.containerId),\n  );\n  const liveContainerIds = input.remoteContainerItems.map((item) => item.id);\n  let changedCount = 0;\n  let completed = true;\n  for (const tombstone of tombstones) {\n    if (input.isCurrent?.() === false) {\n      return { changedCount, completed: false, current: false };\n    }\n    // Apply each root as its own CAS-protected cascade. Other explicit roots\n    // stay out of this cascade so their own reason wins and one stale root\n    // cannot block independent tombstones or live items on the page.\n    const preservedContainerIds = new Set([\n      ...liveContainerIds,\n      ...tombstoneRootIds,\n      ...Array.from(input.state.containersById, ([id, state]) =>\n        state.container.metadataDocumentId === null ? id : null,\n      ).filter((id): id is string => id !== null),\n    ]);\n    if (\n      input.state.containersById.get(tombstone.containerId)?.container\n        .metadataDocumentId !== null\n    ) {\n      preservedContainerIds.delete(tombstone.containerId);\n    }\n    const result = await applyContainerTombstoneCascade({\n      childIdsByParentId: input.childIdsByParentId,\n      expectedContainerStates: input.expectedContainerStates,\n      isCurrent: input.isCurrent,\n      preservedContainerIds,\n      state: input.state,\n      tombstone,\n    });\n    changedCount += result.removedCount;\n    completed = completed && result.settled;\n    if (!result.current) {\n      return { changedCount, completed: false, current: false };\n    }\n  }\n\n  return { changedCount, completed, current: true };\n}\n"]}

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

@@ -0,0 +1,108 @@
+function shouldReplaceInheritedRemoval(current, next) {
+    return (!current ||
+        (current.reason === "access_revoked" && next.reason === "deleted") ||
+        (current.reason === next.reason && current.updatedAt < next.updatedAt));
+}
+function assignContainerRemoval(input) {
+    if (!input.isOwn && input.ownReasonContainerIds.has(input.containerId)) {
+        return false;
+    }
+    const current = input.removalByContainerId.get(input.containerId);
+    if (input.isOwn) {
+        input.ownReasonContainerIds.add(input.containerId);
+        const changed = current?.reason !== input.removal.reason ||
+            current.updatedAt !== input.removal.updatedAt;
+        input.removalByContainerId.set(input.containerId, input.removal);
+        return changed;
+    }
+    if (!shouldReplaceInheritedRemoval(current, input.removal))
+        return false;
+    input.removalByContainerId.set(input.containerId, input.removal);
+    return true;
+}
+function collectCascadedContainerIds(input) {
+    const removedContainerIds = new Set();
+    while (input.pendingContainerIds.length > 0) {
+        const containerId = input.pendingContainerIds.pop();
+        if (!containerId || removedContainerIds.has(containerId))
+            continue;
+        removedContainerIds.add(containerId);
+        const inheritedRemoval = input.removalByContainerId.get(containerId);
+        if (!inheritedRemoval)
+            continue;
+        for (const childId of input.childIdsByParentId.get(containerId) ?? []) {
+            if (input.preservedContainerIds.has(childId))
+                continue;
+            // A second root can upgrade an already-visited child to deleted; requeue
+            // it so its descendants inherit the stronger removal too.
+            const upgraded = assignContainerRemoval({
+                containerId: childId,
+                isOwn: false,
+                ownReasonContainerIds: input.ownReasonContainerIds,
+                removal: inheritedRemoval,
+                removalByContainerId: input.removalByContainerId,
+            });
+            if (!removedContainerIds.has(childId)) {
+                input.pendingContainerIds.push(childId);
+            }
+            else if (upgraded) {
+                removedContainerIds.delete(childId);
+                input.pendingContainerIds.push(childId);
+            }
+        }
+    }
+    return removedContainerIds;
+}
+/**
+ * Collect the containers a tombstone page removes — each applicable tombstone
+ * root plus its local descendants — and the tombstone reason governing each.
+ * A container's own tombstone reason wins over an inherited one, and
+ * "deleted" wins over "access_revoked" when two roots reach the same
+ * container. These reasons describe discovery hints, never authority to purge
+ * metadata or infer a terminal deletion of descendants.
+ */
+export function collectRemovedContainers(input) {
+    const { childIdsByParentId, containersById, preservedContainerIds, tombstones, } = input;
+    const removalByContainerId = new Map();
+    const ownReasonContainerIds = new Set();
+    const pendingContainerIds = [];
+    for (const tombstone of tombstones) {
+        assignContainerRemoval({
+            containerId: tombstone.containerId,
+            isOwn: true,
+            ownReasonContainerIds,
+            removal: { reason: tombstone.reason, updatedAt: tombstone.updatedAt },
+            removalByContainerId,
+        });
+        if (!preservedContainerIds.has(tombstone.containerId)) {
+            pendingContainerIds.push(tombstone.containerId);
+        }
+    }
+    const removedContainerIds = collectCascadedContainerIds({
+        childIdsByParentId,
+        ownReasonContainerIds,
+        pendingContainerIds,
+        preservedContainerIds,
+        removalByContainerId,
+    });
+    const reasonByContainerId = new Map(Array.from(removalByContainerId, ([containerId, removal]) => [
+        containerId,
+        removal.reason,
+    ]));
+    return {
+        fenceOnlyContainerIds: Array.from(reasonByContainerId.entries())
+            .filter(([containerId, reason]) => reason === "access_revoked" &&
+            !containersById.has(containerId) &&
+            !preservedContainerIds.has(containerId))
+            .map(([containerId]) => containerId),
+        absentDeletedContainerIds: Array.from(reasonByContainerId.entries())
+            .filter(([containerId, reason]) => reason === "deleted" &&
+            !containersById.has(containerId) &&
+            !preservedContainerIds.has(containerId))
+            .map(([containerId]) => containerId),
+        removalByContainerId,
+        reasonByContainerId,
+        removedContainerIds: Array.from(removedContainerIds).filter((containerId) => containersById.has(containerId)),
+    };
+}
+//# sourceMappingURL=tombstoneReasons.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tombstoneReasons.js","sourceRoot":"","sources":["tombstoneReasons.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContainerSyncTombstone } from \"@tearleads/validators/response\";\nimport type { ContainerChildIndex } from \"./types\";\n\ninterface RemovedContainerCollection {\n  /** Absent revoked roots that still need a durable anti-resurrection fence. */\n  fenceOnlyContainerIds: string[];\n  /** Deleted hints for already-absent containers still need an observation fence. */\n  absentDeletedContainerIds: string[];\n  removalByContainerId: ReadonlyMap<\n    string,\n    Pick<ContainerSyncTombstone, \"reason\" | \"updatedAt\">\n  >;\n  reasonByContainerId: ReadonlyMap<string, ContainerSyncTombstone[\"reason\"]>;\n  removedContainerIds: string[];\n}\n\ntype ContainerRemoval = Pick<ContainerSyncTombstone, \"reason\" | \"updatedAt\">;\n\nfunction shouldReplaceInheritedRemoval(\n  current: ContainerRemoval | undefined,\n  next: ContainerRemoval,\n): boolean {\n  return (\n    !current ||\n    (current.reason === \"access_revoked\" && next.reason === \"deleted\") ||\n    (current.reason === next.reason && current.updatedAt < next.updatedAt)\n  );\n}\n\nfunction assignContainerRemoval(input: {\n  containerId: string;\n  isOwn: boolean;\n  ownReasonContainerIds: Set<string>;\n  removal: ContainerRemoval;\n  removalByContainerId: Map<string, ContainerRemoval>;\n}): boolean {\n  if (!input.isOwn && input.ownReasonContainerIds.has(input.containerId)) {\n    return false;\n  }\n  const current = input.removalByContainerId.get(input.containerId);\n  if (input.isOwn) {\n    input.ownReasonContainerIds.add(input.containerId);\n    const changed =\n      current?.reason !== input.removal.reason ||\n      current.updatedAt !== input.removal.updatedAt;\n    input.removalByContainerId.set(input.containerId, input.removal);\n    return changed;\n  }\n  if (!shouldReplaceInheritedRemoval(current, input.removal)) return false;\n  input.removalByContainerId.set(input.containerId, input.removal);\n  return true;\n}\n\nfunction collectCascadedContainerIds(input: {\n  childIdsByParentId: ContainerChildIndex;\n  ownReasonContainerIds: Set<string>;\n  pendingContainerIds: string[];\n  preservedContainerIds: ReadonlySet<string>;\n  removalByContainerId: Map<string, ContainerRemoval>;\n}): Set<string> {\n  const removedContainerIds = new Set<string>();\n  while (input.pendingContainerIds.length > 0) {\n    const containerId = input.pendingContainerIds.pop();\n    if (!containerId || removedContainerIds.has(containerId)) continue;\n\n    removedContainerIds.add(containerId);\n    const inheritedRemoval = input.removalByContainerId.get(containerId);\n    if (!inheritedRemoval) continue;\n    for (const childId of input.childIdsByParentId.get(containerId) ?? []) {\n      if (input.preservedContainerIds.has(childId)) continue;\n      // A second root can upgrade an already-visited child to deleted; requeue\n      // it so its descendants inherit the stronger removal too.\n      const upgraded = assignContainerRemoval({\n        containerId: childId,\n        isOwn: false,\n        ownReasonContainerIds: input.ownReasonContainerIds,\n        removal: inheritedRemoval,\n        removalByContainerId: input.removalByContainerId,\n      });\n      if (!removedContainerIds.has(childId)) {\n        input.pendingContainerIds.push(childId);\n      } else if (upgraded) {\n        removedContainerIds.delete(childId);\n        input.pendingContainerIds.push(childId);\n      }\n    }\n  }\n  return removedContainerIds;\n}\n\n/**\n * Collect the containers a tombstone page removes — each applicable tombstone\n * root plus its local descendants — and the tombstone reason governing each.\n * A container's own tombstone reason wins over an inherited one, and\n * \"deleted\" wins over \"access_revoked\" when two roots reach the same\n * container. These reasons describe discovery hints, never authority to purge\n * metadata or infer a terminal deletion of descendants.\n */\nexport function collectRemovedContainers(input: {\n  childIdsByParentId: ContainerChildIndex;\n  containersById: ReadonlyMap<string, unknown>;\n  preservedContainerIds: ReadonlySet<string>;\n  tombstones: ReadonlyArray<ContainerSyncTombstone>;\n}): RemovedContainerCollection {\n  const {\n    childIdsByParentId,\n    containersById,\n    preservedContainerIds,\n    tombstones,\n  } = input;\n  const removalByContainerId = new Map<string, ContainerRemoval>();\n  const ownReasonContainerIds = new Set<string>();\n  const pendingContainerIds: string[] = [];\n\n  for (const tombstone of tombstones) {\n    assignContainerRemoval({\n      containerId: tombstone.containerId,\n      isOwn: true,\n      ownReasonContainerIds,\n      removal: { reason: tombstone.reason, updatedAt: tombstone.updatedAt },\n      removalByContainerId,\n    });\n    if (!preservedContainerIds.has(tombstone.containerId)) {\n      pendingContainerIds.push(tombstone.containerId);\n    }\n  }\n\n  const removedContainerIds = collectCascadedContainerIds({\n    childIdsByParentId,\n    ownReasonContainerIds,\n    pendingContainerIds,\n    preservedContainerIds,\n    removalByContainerId,\n  });\n\n  const reasonByContainerId = new Map(\n    Array.from(removalByContainerId, ([containerId, removal]) => [\n      containerId,\n      removal.reason,\n    ]),\n  );\n  return {\n    fenceOnlyContainerIds: Array.from(reasonByContainerId.entries())\n      .filter(\n        ([containerId, reason]) =>\n          reason === \"access_revoked\" &&\n          !containersById.has(containerId) &&\n          !preservedContainerIds.has(containerId),\n      )\n      .map(([containerId]) => containerId),\n    absentDeletedContainerIds: Array.from(reasonByContainerId.entries())\n      .filter(\n        ([containerId, reason]) =>\n          reason === \"deleted\" &&\n          !containersById.has(containerId) &&\n          !preservedContainerIds.has(containerId),\n      )\n      .map(([containerId]) => containerId),\n    removalByContainerId,\n    reasonByContainerId,\n    removedContainerIds: Array.from(removedContainerIds).filter((containerId) =>\n      containersById.has(containerId),\n    ),\n  };\n}\n"]}

package/workflows/container-contents/remoteHydration/types.d.ts

@@ -0,0 +1,90 @@
+import type { RequestResult } from "../../../internal/api-client/index.js";
+import type { ContainerReplacementAuthorizationsResponse } from "../../../internal/validators/operation/index.js";
+import type { ListContainerParentLanesRequest } from "../../../internal/validators/request/index.js";
+import type { ContainerSummary, ContainerWriterProjectionResponse, DocumentWriterProjectionResponse, ListContainerParentLanesResponse, ListContainersResponse, PrincipalPolicyBundleResponse, ReferencedPrincipalStateResponse } from "../../../internal/validators/response/index.js";
+import type { createContainerMetadataDocument } from "../../../data/containers/containerMetadataDocument.js";
+import type { ContainerContentsPersistence, ContainerDocumentRecord, ContainerHydrationTombstone, ContainerRecord, createContainerParentSyncLane } from "../containerPersistence.js";
+import type { ContainerMetadataPatch } from "../metadata.js";
+import type { ContainerContentsWorkflowRuntime } from "../runtime.js";
+export type ListedRemoteContainerPageItem = ListContainersResponse["items"][number];
+export type ContainerChildIndex = Map<string, Set<string>>;
+export type QueueContainerParentLane = (parentId: string | null) => void;
+export type RemoteContainerIngestQueue = Map<string, RemoteContainer>;
+export type SaveContainerOptions = Parameters<ContainerContentsPersistence["saveContainer"]>[3];
+export type ContainerMetadataDocumentState = Awaited<ReturnType<typeof createContainerMetadataDocument>>;
+export type RemoteContainer = Pick<ContainerSummary, "createdAt" | "effectiveAccessLevel" | "systemSlot" | "id" | "metadataAccessEpoch" | "metadataAccessStateHash" | "metadataDocumentId" | "metadataReferencedPrincipals" | "organizationId" | "parentId" | "updatedAt">;
+export interface ContainerState {
+    containerWriterProjection?: ContainerWriterProjectionResponse | null | undefined;
+    /**
+     * Bumped whenever a realtime hint drops this container's cached writer
+     * projections (container and metadata document alike); an operation that
+     * fetched or carried a projection installs it only if this is unchanged
+     * since it started, so a pre-hint answer never lands after the hint.
+     */
+    writerProjectionGeneration?: number | undefined;
+    metadataReferencedPrincipals?: readonly ReferencedPrincipalStateResponse[] | undefined;
+    container: ContainerRecord;
+    doc: ContainerMetadataDocumentState;
+    metadataWriterProjection?: DocumentWriterProjectionResponse | null | undefined;
+    /** Durable pull progress mirrored from the metadata document record. */
+    pullContinuation?: ContainerDocumentRecord["pullContinuation"] | undefined;
+    record: ContainerDocumentRecord;
+}
+interface RemoteContainerHydrationApi {
+    getContainerReplacementAuthorizationsResult(containerId: string, replacesOrganizationId: string): Promise<RequestResult<ContainerReplacementAuthorizationsResponse>>;
+    evictContainerWriterProjection(containerId: string): void;
+    getContainerWriterProjection(containerId: string): Promise<ContainerWriterProjectionResponse | null>;
+    getCurrentPrincipalPolicy(principalType: "group" | "organization", principalId: string): Promise<PrincipalPolicyBundleResponse | null>;
+    listContainerParentLanes(input: ListContainerParentLanesRequest): Promise<ListContainerParentLanesResponse | null>;
+}
+interface RemoteContainerHydrationRuntime extends Pick<ContainerContentsWorkflowRuntime, "auth" | "adoptRootContainer" | "crypto" | "infra" | "resolveTrustedUserIdentity" | "state" | "util"> {
+    apiClient: RemoteContainerHydrationApi;
+}
+export interface RemoteContainerHydrationState {
+    containersById: Map<string, ContainerState>;
+    lifecycleGeneration?: number | undefined;
+    persistence: ContainerContentsPersistence;
+    rootLaneHydrated?: boolean | undefined;
+    runtime: RemoteContainerHydrationRuntime;
+    structuralGeneration?: number | undefined;
+}
+export type PersistContainerStateResult = {
+    status: "identity-superseded";
+    record: ContainerDocumentRecord;
+} | {
+    status: "missing";
+} | {
+    status: "persisted";
+    record: ContainerDocumentRecord;
+    createIntentSettled?: true | undefined;
+    moveIntentSettled?: true | undefined;
+} | {
+    status: "stale-generation";
+};
+export interface RemoteContainerHydrationHost {
+    persistContainerState: (containerState: ContainerState, patch?: Partial<ContainerMetadataPatch>, updateView?: boolean, saveOptions?: SaveContainerOptions, mutationOptions?: {
+        expectedStateWhenMissing?: ContainerState | undefined;
+        isCurrent?: (() => boolean) | undefined;
+        createIntentSettlement?: Parameters<ContainerContentsPersistence["commitMetadataMutation"]>[1]["createIntentSettlement"];
+        moveIntentSettlement?: Parameters<ContainerContentsPersistence["commitMetadataMutation"]>[1]["moveIntentSettlement"];
+        preserveDurableStructureWhenPending?: boolean | undefined;
+    }) => Promise<PersistContainerStateResult>;
+    requestDocumentPriming?: (() => void) | undefined;
+    updateSnapshot: () => void;
+}
+export interface ContainerParentHydrationLane {
+    parentId: string | null;
+    watermark?: ListContainersResponse["nextWatermark"];
+}
+export interface ExpectedContainerState {
+    container: ContainerRecord;
+    fingerprint: string;
+}
+export interface FetchedContainerParentLanePage {
+    expectedContainerStates: ReadonlyMap<string, ExpectedContainerState>;
+    expectedHydrationTombstones: ReadonlyMap<string, ContainerHydrationTombstone>;
+    lane: ContainerParentHydrationLane;
+    response: ListContainersResponse;
+    syncLane: ReturnType<typeof createContainerParentSyncLane>;
+}
+export {};

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"","sourcesContent":["import type { RequestResult } from \"@tearleads/api-client\";\nimport type { ContainerReplacementAuthorizationsResponse } from \"@tearleads/validators/operation\";\nimport type { ListContainerParentLanesRequest } from \"@tearleads/validators/request\";\nimport type {\n  ContainerSummary,\n  ContainerWriterProjectionResponse,\n  DocumentWriterProjectionResponse,\n  ListContainerParentLanesResponse,\n  ListContainersResponse,\n  PrincipalPolicyBundleResponse,\n  ReferencedPrincipalStateResponse,\n} from \"@tearleads/validators/response\";\nimport type { createContainerMetadataDocument } from \"../../../data/containers/containerMetadataDocument\";\nimport type {\n  ContainerContentsPersistence,\n  ContainerDocumentRecord,\n  ContainerHydrationTombstone,\n  ContainerRecord,\n  createContainerParentSyncLane,\n} from \"../containerPersistence\";\nimport type { ContainerMetadataPatch } from \"../metadata\";\nimport type { ContainerContentsWorkflowRuntime } from \"../runtime\";\n\nexport type ListedRemoteContainerPageItem =\n  ListContainersResponse[\"items\"][number];\nexport type ContainerChildIndex = Map<string, Set<string>>;\nexport type QueueContainerParentLane = (parentId: string | null) => void;\nexport type RemoteContainerIngestQueue = Map<string, RemoteContainer>;\nexport type SaveContainerOptions = Parameters<\n  ContainerContentsPersistence[\"saveContainer\"]\n>[3];\n\nexport type ContainerMetadataDocumentState = Awaited<\n  ReturnType<typeof createContainerMetadataDocument>\n>;\nexport type RemoteContainer = Pick<\n  ContainerSummary,\n  | \"createdAt\"\n  | \"effectiveAccessLevel\"\n  | \"systemSlot\"\n  | \"id\"\n  | \"metadataAccessEpoch\"\n  | \"metadataAccessStateHash\"\n  | \"metadataDocumentId\"\n  | \"metadataReferencedPrincipals\"\n  | \"organizationId\"\n  | \"parentId\"\n  | \"updatedAt\"\n>;\n\nexport interface ContainerState {\n  containerWriterProjection?:\n    | ContainerWriterProjectionResponse\n    | null\n    | undefined;\n  /**\n   * Bumped whenever a realtime hint drops this container's cached writer\n   * projections (container and metadata document alike); an operation that\n   * fetched or carried a projection installs it only if this is unchanged\n   * since it started, so a pre-hint answer never lands after the hint.\n   */\n  writerProjectionGeneration?: number | undefined;\n  metadataReferencedPrincipals?:\n    | readonly ReferencedPrincipalStateResponse[]\n    | undefined;\n  container: ContainerRecord;\n  doc: ContainerMetadataDocumentState;\n  metadataWriterProjection?:\n    | DocumentWriterProjectionResponse\n    | null\n    | undefined;\n  /** Durable pull progress mirrored from the metadata document record. */\n  pullContinuation?: ContainerDocumentRecord[\"pullContinuation\"] | undefined;\n  record: ContainerDocumentRecord;\n}\n\ninterface RemoteContainerHydrationApi {\n  getContainerReplacementAuthorizationsResult(\n    containerId: string,\n    replacesOrganizationId: string,\n  ): Promise<RequestResult<ContainerReplacementAuthorizationsResponse>>;\n  evictContainerWriterProjection(containerId: string): void;\n  getContainerWriterProjection(\n    containerId: string,\n  ): Promise<ContainerWriterProjectionResponse | null>;\n  getCurrentPrincipalPolicy(\n    principalType: \"group\" | \"organization\",\n    principalId: string,\n  ): Promise<PrincipalPolicyBundleResponse | null>;\n  listContainerParentLanes(\n    input: ListContainerParentLanesRequest,\n  ): Promise<ListContainerParentLanesResponse | null>;\n}\n\ninterface RemoteContainerHydrationRuntime\n  extends Pick<\n    ContainerContentsWorkflowRuntime,\n    | \"auth\"\n    | \"adoptRootContainer\"\n    | \"crypto\"\n    | \"infra\"\n    | \"resolveTrustedUserIdentity\"\n    | \"state\"\n    | \"util\"\n  > {\n  apiClient: RemoteContainerHydrationApi;\n}\n\nexport interface RemoteContainerHydrationState {\n  containersById: Map<string, ContainerState>;\n  lifecycleGeneration?: number | undefined;\n  persistence: ContainerContentsPersistence;\n  rootLaneHydrated?: boolean | undefined;\n  runtime: RemoteContainerHydrationRuntime;\n  structuralGeneration?: number | undefined;\n}\n\nexport type PersistContainerStateResult =\n  | { status: \"identity-superseded\"; record: ContainerDocumentRecord }\n  | { status: \"missing\" }\n  | {\n      status: \"persisted\";\n      record: ContainerDocumentRecord;\n      createIntentSettled?: true | undefined;\n      moveIntentSettled?: true | undefined;\n    }\n  | { status: \"stale-generation\" };\n\nexport interface RemoteContainerHydrationHost {\n  persistContainerState: (\n    containerState: ContainerState,\n    patch?: Partial<ContainerMetadataPatch>,\n    updateView?: boolean,\n    saveOptions?: SaveContainerOptions,\n    mutationOptions?: {\n      expectedStateWhenMissing?: ContainerState | undefined;\n      isCurrent?: (() => boolean) | undefined;\n      createIntentSettlement?: Parameters<\n        ContainerContentsPersistence[\"commitMetadataMutation\"]\n      >[1][\"createIntentSettlement\"];\n      moveIntentSettlement?: Parameters<\n        ContainerContentsPersistence[\"commitMetadataMutation\"]\n      >[1][\"moveIntentSettlement\"];\n      preserveDurableStructureWhenPending?: boolean | undefined;\n    },\n  ) => Promise<PersistContainerStateResult>;\n  requestDocumentPriming?: (() => void) | undefined;\n  updateSnapshot: () => void;\n}\n\nexport interface ContainerParentHydrationLane {\n  parentId: string | null;\n  watermark?: ListContainersResponse[\"nextWatermark\"];\n}\n\nexport interface ExpectedContainerState {\n  container: ContainerRecord;\n  fingerprint: string;\n}\n\nexport interface FetchedContainerParentLanePage {\n  expectedContainerStates: ReadonlyMap<string, ExpectedContainerState>;\n  expectedHydrationTombstones: ReadonlyMap<string, ContainerHydrationTombstone>;\n  lane: ContainerParentHydrationLane;\n  response: ListContainersResponse;\n  syncLane: ReturnType<typeof createContainerParentSyncLane>;\n}\n"]}