@tearleads/client-sdk 0.1.63 → 0.1.65

package/stores/container-contents/shareOperations.js

@@ -1,90 +0,0 @@
-import { runWithSecurityIncidentReporting } from "../../data/keyingProjectionVerification/error.js";
-import { shareContainerState, shareContainerStateWithGroup, } from "../../workflows/container-contents/container-state/share.js";
-import { installContainerMetadataRecord } from "../../workflows/container-contents/metadata/index.js";
-import { getContainerContentsStoreLogLabel } from "./logLabel.js";
-import { removeMissingContainerState } from "./missingContainerState.js";
-import { reportContainerShareFailure } from "./reportShareFailure.js";
-import { updateContainerContentsSnapshot } from "./state.js";
-export async function shareContainerUsing(state, syncAgent, containerId, share, logMessage, isCurrent = () => true) {
-    if (state.runtime.infra.dbStatus !== "ready" ||
-        !state.snapshot.ready ||
-        !state.runtime.auth.isAuthenticated ||
-        !state.runtime.state.online ||
-        !isCurrent()) {
-        return false;
-    }
-    const existingState = state.containersById.get(containerId);
-    const expectedAccessStateHash = existingState?.record.accessStateHash;
-    if (!existingState?.record.documentId ||
-        typeof expectedAccessStateHash !== "string" ||
-        expectedAccessStateHash.length === 0) {
-        return false;
-    }
-    let shared;
-    try {
-        shared = await share(existingState);
-    }
-    catch (error) {
-        reportContainerShareFailure(state, "share", error);
-        throw error;
-    }
-    if (!shared || !isCurrent() || shared.status === "confirmed") {
-        if (!isCurrent() || shared?.status === "confirmed") {
-            state.localContainersNeedRefresh = true;
-            state.containerParentIdsNeedingHydration.add(existingState.container.parentId);
-            void syncAgent.refreshLocalContainers();
-            syncAgent.scheduleRemoteHydration();
-        }
-        return shared?.status === "confirmed" || shared?.status === "persisted";
-    }
-    if (shared.status === "missing") {
-        removeMissingContainerState(state, existingState);
-        return false;
-    }
-    existingState.container = shared.container;
-    installContainerMetadataRecord(existingState, shared.record);
-    updateContainerContentsSnapshot(state);
-    if (shared.status === "identity-superseded")
-        return false;
-    await syncAgent.primeDocumentsForSharedSubtree(containerId, isCurrent);
-    if (!isCurrent())
-        return true;
-    syncAgent.scheduleSync();
-    state.runtime.util.log(`${getContainerContentsStoreLogLabel(state)}: ${logMessage}`);
-    return true;
-}
-export async function shareContainerWithUser(state, syncAgent, containerId, userId, isCurrent = () => true) {
-    return shareContainerUsing(state, syncAgent, containerId, (containerState) => shareContainerState({
-        accessLevel: "write",
-        containerState,
-        persistence: state.persistence,
-        recipientUserId: userId,
-        resolveProjectionUserKey: state.resolveProjectionUserKey,
-        runtime: state.runtime,
-        stillCurrent: isCurrent,
-    }), `shared container ${containerId} with ${userId}`, isCurrent);
-}
-export async function shareContainerWithGroup(state, syncAgent, containerId, groupId, accessLevel, options = {}, isCurrent = () => true) {
-    return shareContainerUsing(state, syncAgent, containerId, (containerState) => 
-    // A group share is where a relabeled directory row would misdirect a
-    // key wrap, so its verification failures (the signed-name mismatch
-    // above all) are recorded as security incidents, not just surfaced.
-    runWithSecurityIncidentReporting(state.runtime.util.reportSecurityIncident, {
-        objectId: containerId,
-        objectKind: "container",
-        operation: "container.share.group",
-        organizationId: containerState.container.organizationId,
-    }, () => shareContainerStateWithGroup({
-        accessLevel,
-        containerState,
-        expectedGroupName: options.expectedGroupName,
-        knownContainerKeks: options.knownContainerKeks,
-        persistence: state.persistence,
-        recipientGroupId: groupId,
-        requireExistingGrant: options.requireExistingGrant,
-        resolveProjectionUserKey: state.resolveProjectionUserKey,
-        runtime: state.runtime,
-        stillCurrent: isCurrent,
-    })), `shared container ${containerId} with group ${groupId}`, isCurrent);
-}
-//# sourceMappingURL=shareOperations.js.map

package/stores/container-contents/shareOperations.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"shareOperations.js","sourceRoot":"","sources":["shareOperations.ts"],"names":[],"mappings":"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","sourcesContent":["import { runWithSecurityIncidentReporting } from \"../../data/keyingProjectionVerification/error\";\nimport {\n  shareContainerState,\n  shareContainerStateWithGroup,\n} from \"../../workflows/container-contents/container-state/share\";\nimport type { SharedContainerStateResult } from \"../../workflows/container-contents/container-state/types\";\nimport { installContainerMetadataRecord } from \"../../workflows/container-contents/metadata\";\nimport { getContainerContentsStoreLogLabel } from \"./logLabel\";\nimport { removeMissingContainerState } from \"./missingContainerState\";\nimport { reportContainerShareFailure } from \"./reportShareFailure\";\nimport { updateContainerContentsSnapshot } from \"./state\";\nimport type {\n  ContainerContentsStoreSyncAgent,\n  ContainerState,\n} from \"./syncAgent\";\nimport type {\n  ContainerContentsShareAccessLevel,\n  ContainerContentsStoreState,\n} from \"./types\";\nimport type { ContainerWriteGuard } from \"./writeGeneration\";\n\nexport async function shareContainerUsing(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n  containerId: string,\n  share: (\n    containerState: ContainerState,\n  ) => Promise<SharedContainerStateResult | null>,\n  logMessage: string,\n  isCurrent: ContainerWriteGuard = () => true,\n) {\n  if (\n    state.runtime.infra.dbStatus !== \"ready\" ||\n    !state.snapshot.ready ||\n    !state.runtime.auth.isAuthenticated ||\n    !state.runtime.state.online ||\n    !isCurrent()\n  ) {\n    return false;\n  }\n\n  const existingState = state.containersById.get(containerId);\n  const expectedAccessStateHash = existingState?.record.accessStateHash;\n  if (\n    !existingState?.record.documentId ||\n    typeof expectedAccessStateHash !== \"string\" ||\n    expectedAccessStateHash.length === 0\n  ) {\n    return false;\n  }\n\n  let shared: SharedContainerStateResult | null;\n  try {\n    shared = await share(existingState);\n  } catch (error) {\n    reportContainerShareFailure(state, \"share\", error);\n    throw error;\n  }\n  if (!shared || !isCurrent() || shared.status === \"confirmed\") {\n    if (!isCurrent() || shared?.status === \"confirmed\") {\n      state.localContainersNeedRefresh = true;\n      state.containerParentIdsNeedingHydration.add(\n        existingState.container.parentId,\n      );\n      void syncAgent.refreshLocalContainers();\n      syncAgent.scheduleRemoteHydration();\n    }\n    return shared?.status === \"confirmed\" || shared?.status === \"persisted\";\n  }\n  if (shared.status === \"missing\") {\n    removeMissingContainerState(state, existingState);\n    return false;\n  }\n\n  existingState.container = shared.container;\n  installContainerMetadataRecord(existingState, shared.record);\n  updateContainerContentsSnapshot(state);\n  if (shared.status === \"identity-superseded\") return false;\n\n  await syncAgent.primeDocumentsForSharedSubtree(containerId, isCurrent);\n  if (!isCurrent()) return true;\n  syncAgent.scheduleSync();\n  state.runtime.util.log(\n    `${getContainerContentsStoreLogLabel(state)}: ${logMessage}`,\n  );\n  return true;\n}\n\nexport async function shareContainerWithUser(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n  containerId: string,\n  userId: string,\n  isCurrent: ContainerWriteGuard = () => true,\n) {\n  return shareContainerUsing(\n    state,\n    syncAgent,\n    containerId,\n    (containerState) =>\n      shareContainerState({\n        accessLevel: \"write\",\n        containerState,\n        persistence: state.persistence,\n        recipientUserId: userId,\n        resolveProjectionUserKey: state.resolveProjectionUserKey,\n        runtime: state.runtime,\n        stillCurrent: isCurrent,\n      }),\n    `shared container ${containerId} with ${userId}`,\n    isCurrent,\n  );\n}\n\nexport async function shareContainerWithGroup(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n  containerId: string,\n  groupId: string,\n  accessLevel: ContainerContentsShareAccessLevel,\n  options: {\n    expectedGroupName?: string | undefined;\n    knownContainerKeks?: ReadonlyMap<string, Uint8Array> | undefined;\n    requireExistingGrant?: boolean | undefined;\n  } = {},\n  isCurrent: ContainerWriteGuard = () => true,\n) {\n  return shareContainerUsing(\n    state,\n    syncAgent,\n    containerId,\n    (containerState) =>\n      // A group share is where a relabeled directory row would misdirect a\n      // key wrap, so its verification failures (the signed-name mismatch\n      // above all) are recorded as security incidents, not just surfaced.\n      runWithSecurityIncidentReporting(\n        state.runtime.util.reportSecurityIncident,\n        {\n          objectId: containerId,\n          objectKind: \"container\",\n          operation: \"container.share.group\",\n          organizationId: containerState.container.organizationId,\n        },\n        () =>\n          shareContainerStateWithGroup({\n            accessLevel,\n            containerState,\n            expectedGroupName: options.expectedGroupName,\n            knownContainerKeks: options.knownContainerKeks,\n            persistence: state.persistence,\n            recipientGroupId: groupId,\n            requireExistingGrant: options.requireExistingGrant,\n            resolveProjectionUserKey: state.resolveProjectionUserKey,\n            runtime: state.runtime,\n            stillCurrent: isCurrent,\n          }),\n      ),\n    `shared container ${containerId} with group ${groupId}`,\n    isCurrent,\n  );\n}\n"]}

package/stores/container-contents/startupHydration.js

@@ -1,110 +0,0 @@
-import { createContainerParentSyncLane, loadContainerSyncLaneCheckRecords, } from "../../workflows/container-contents/containerPersistence.js";
-import { hasStartupDocumentSyncWork } from "../../workflows/container-contents/documentPriming/index.js";
-import { isDatabaseUnavailableError } from "../../workflows/container-contents/syncLane.js";
-const STARTUP_REMOTE_HYDRATION_FRESH_MS = 15 * 60_000;
-function isFreshStartupRemoteHydrationCheck(checkedAt, nowMs) {
-    const checkedAtMs = Date.parse(checkedAt);
-    return (Number.isFinite(checkedAtMs) &&
-        nowMs - checkedAtMs <= STARTUP_REMOTE_HYDRATION_FRESH_MS);
-}
-function shouldHydrateUnmarkedStartupRoot(state) {
-    // An empty authenticated cache needs one root probe to discover the remote
-    // tree. Existing local-only roots are deliberately left cache-first; explicit
-    // refresh and remote events can reconcile them without polling every startup.
-    return state.containersById.size === 0;
-}
-async function getStaleStartupRemoteHydrationParentIds(state, isCurrent) {
-    const parentIds = [null, ...state.containersById.keys()];
-    const syncLanes = parentIds.map((parentId) => createContainerParentSyncLane(parentId));
-    const checkRecords = await loadContainerSyncLaneCheckRecords(state.runtime.infra.execSql, syncLanes);
-    if (isCurrent?.() === false) {
-        return null;
-    }
-    const nowMs = Date.now();
-    const rootCheckRecord = checkRecords[0];
-    state.rootLaneHydrated = rootCheckRecord
-        ? isFreshStartupRemoteHydrationCheck(rootCheckRecord.checkedAt, nowMs)
-        : false;
-    const hydrateUnmarkedRoot = shouldHydrateUnmarkedStartupRoot(state);
-    return parentIds.filter((_, index) => {
-        const checkRecord = checkRecords[index];
-        if (!checkRecord) {
-            return hydrateUnmarkedRoot && index === 0;
-        }
-        return !isFreshStartupRemoteHydrationCheck(checkRecord.checkedAt, nowMs);
-    });
-}
-function reportStartupHydrationError(message, error) {
-    if (isDatabaseUnavailableError(error)) {
-        return;
-    }
-    console.error(message, error);
-}
-export async function scheduleStaleStartupRemoteHydration(input) {
-    const { requestHydration, state } = input;
-    if (!state.runtime.auth.isAuthenticated || !state.runtime.state.online) {
-        return false;
-    }
-    let parentIds;
-    try {
-        parentIds = await getStaleStartupRemoteHydrationParentIds(state, input.isCurrent);
-    }
-    catch (error) {
-        if (input.isCurrent?.() === false) {
-            return false;
-        }
-        reportStartupHydrationError("Failed to inspect startup container contents hydration:", error);
-        return false;
-    }
-    if (!parentIds || input.isCurrent?.() === false) {
-        return false;
-    }
-    const activeContainerId = state.runtime.state.containerId;
-    const shouldScheduleStaleRootRecovery = state.rootLaneHydrated &&
-        activeContainerId !== null &&
-        !state.containersById.has(activeContainerId);
-    if (parentIds.length === 0) {
-        return shouldScheduleStaleRootRecovery;
-    }
-    for (const parentId of parentIds) {
-        state.containerParentIdsNeedingHydration.add(parentId);
-    }
-    // Startup stays cache-first: only the local freshness-marker read is awaited.
-    // Missing markers on an existing remote cache do not force a first-open poll;
-    // stale checked lanes and empty caches hydrate behind the cached tree.
-    // WebSocket events and explicit refresh bypass this.
-    void requestHydration().catch((error) => {
-        reportStartupHydrationError("Failed to schedule startup container contents hydration:", error);
-    });
-    return shouldScheduleStaleRootRecovery;
-}
-export async function hasStartupContainerSyncWork(state) {
-    const execSql = state.runtime.infra.execSql;
-    const [createIntents, moveIntents] = await Promise.all([
-        state.persistence.listPendingCreateIntents(execSql),
-        state.persistence.listUnsyncedMoveIntents(execSql),
-    ]);
-    if (createIntents.length > 0 || moveIntents.length > 0) {
-        return true;
-    }
-    // Durable document-level work (pending creates, queued Loro updates or
-    // attachments, pending document move intents) is drained by lane passes too:
-    // the pass primes the owning document stores, which register and request
-    // their own sync lanes. Without this probe, a relaunch whose only pending
-    // work is document-level never schedules any lane and the write queue sits
-    // unattempted forever.
-    if (await hasStartupDocumentSyncWork(execSql)) {
-        return true;
-    }
-    const containerIds = Array.from(state.containersById.keys());
-    if (containerIds.length === 0) {
-        return false;
-    }
-    const [containersWithPendingMetadata, containersWithPullContinuations] = await Promise.all([
-        state.persistence.listContainerIdsWithPendingUpdates(execSql, containerIds),
-        state.persistence.listContainerIdsWithPullContinuations(execSql, containerIds),
-    ]);
-    return (containersWithPendingMetadata.length > 0 ||
-        containersWithPullContinuations.length > 0);
-}
-//# sourceMappingURL=startupHydration.js.map

package/stores/container-contents/startupHydration.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"startupHydration.js","sourceRoot":"","sources":["startupHydration.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type ContainerContentsPersistence,\n  createContainerParentSyncLane,\n  loadContainerSyncLaneCheckRecords,\n} from \"../../workflows/container-contents/containerPersistence\";\nimport { hasStartupDocumentSyncWork } from \"../../workflows/container-contents/documentPriming\";\nimport { isDatabaseUnavailableError } from \"../../workflows/container-contents/syncLane\";\n\nconst STARTUP_REMOTE_HYDRATION_FRESH_MS = 15 * 60_000;\ntype StartupHydrationExecSql = Parameters<\n  typeof loadContainerSyncLaneCheckRecords\n>[0];\n\ninterface StartupHydrationState {\n  containerParentIdsNeedingHydration: Set<string | null>;\n  containersById: ReadonlyMap<\n    string,\n    {\n      container: {\n        metadataDocumentId?: string | null | undefined;\n        parentId: string | null;\n      };\n    }\n  >;\n  rootLaneHydrated: boolean;\n  runtime: {\n    auth: { isAuthenticated: boolean; organizationId?: string | null };\n    infra: { execSql: StartupHydrationExecSql };\n    state: { containerId: string | null; online: boolean };\n  };\n}\n\nfunction isFreshStartupRemoteHydrationCheck(\n  checkedAt: string,\n  nowMs: number,\n): boolean {\n  const checkedAtMs = Date.parse(checkedAt);\n  return (\n    Number.isFinite(checkedAtMs) &&\n    nowMs - checkedAtMs <= STARTUP_REMOTE_HYDRATION_FRESH_MS\n  );\n}\n\nfunction shouldHydrateUnmarkedStartupRoot(\n  state: StartupHydrationState,\n): boolean {\n  // An empty authenticated cache needs one root probe to discover the remote\n  // tree. Existing local-only roots are deliberately left cache-first; explicit\n  // refresh and remote events can reconcile them without polling every startup.\n  return state.containersById.size === 0;\n}\n\nasync function getStaleStartupRemoteHydrationParentIds(\n  state: StartupHydrationState,\n  isCurrent?: (() => boolean) | undefined,\n): Promise<Array<string | null> | null> {\n  const parentIds = [null, ...state.containersById.keys()];\n  const syncLanes = parentIds.map((parentId) =>\n    createContainerParentSyncLane(parentId),\n  );\n  const checkRecords = await loadContainerSyncLaneCheckRecords(\n    state.runtime.infra.execSql,\n    syncLanes,\n  );\n  if (isCurrent?.() === false) {\n    return null;\n  }\n  const nowMs = Date.now();\n  const rootCheckRecord = checkRecords[0];\n  state.rootLaneHydrated = rootCheckRecord\n    ? isFreshStartupRemoteHydrationCheck(rootCheckRecord.checkedAt, nowMs)\n    : false;\n  const hydrateUnmarkedRoot = shouldHydrateUnmarkedStartupRoot(state);\n\n  return parentIds.filter((_, index) => {\n    const checkRecord = checkRecords[index];\n    if (!checkRecord) {\n      return hydrateUnmarkedRoot && index === 0;\n    }\n\n    return !isFreshStartupRemoteHydrationCheck(checkRecord.checkedAt, nowMs);\n  });\n}\n\nfunction reportStartupHydrationError(message: string, error: unknown) {\n  if (isDatabaseUnavailableError(error)) {\n    return;\n  }\n\n  console.error(message, error);\n}\n\nexport async function scheduleStaleStartupRemoteHydration(input: {\n  isCurrent?: (() => boolean) | undefined;\n  requestHydration: () => Promise<void>;\n  state: StartupHydrationState;\n}): Promise<boolean> {\n  const { requestHydration, state } = input;\n  if (!state.runtime.auth.isAuthenticated || !state.runtime.state.online) {\n    return false;\n  }\n\n  let parentIds: Array<string | null> | null;\n  try {\n    parentIds = await getStaleStartupRemoteHydrationParentIds(\n      state,\n      input.isCurrent,\n    );\n  } catch (error: unknown) {\n    if (input.isCurrent?.() === false) {\n      return false;\n    }\n    reportStartupHydrationError(\n      \"Failed to inspect startup container contents hydration:\",\n      error,\n    );\n    return false;\n  }\n  if (!parentIds || input.isCurrent?.() === false) {\n    return false;\n  }\n  const activeContainerId = state.runtime.state.containerId;\n  const shouldScheduleStaleRootRecovery =\n    state.rootLaneHydrated &&\n    activeContainerId !== null &&\n    !state.containersById.has(activeContainerId);\n  if (parentIds.length === 0) {\n    return shouldScheduleStaleRootRecovery;\n  }\n\n  for (const parentId of parentIds) {\n    state.containerParentIdsNeedingHydration.add(parentId);\n  }\n  // Startup stays cache-first: only the local freshness-marker read is awaited.\n  // Missing markers on an existing remote cache do not force a first-open poll;\n  // stale checked lanes and empty caches hydrate behind the cached tree.\n  // WebSocket events and explicit refresh bypass this.\n  void requestHydration().catch((error: unknown) => {\n    reportStartupHydrationError(\n      \"Failed to schedule startup container contents hydration:\",\n      error,\n    );\n  });\n  return shouldScheduleStaleRootRecovery;\n}\n\nexport async function hasStartupContainerSyncWork(state: {\n  containersById: ReadonlyMap<string, unknown>;\n  persistence: ContainerContentsPersistence;\n  runtime: { infra: { execSql: StartupHydrationExecSql } };\n}): Promise<boolean> {\n  const execSql = state.runtime.infra.execSql;\n  const [createIntents, moveIntents] = await Promise.all([\n    state.persistence.listPendingCreateIntents(execSql),\n    state.persistence.listUnsyncedMoveIntents(execSql),\n  ]);\n  if (createIntents.length > 0 || moveIntents.length > 0) {\n    return true;\n  }\n\n  // Durable document-level work (pending creates, queued Loro updates or\n  // attachments, pending document move intents) is drained by lane passes too:\n  // the pass primes the owning document stores, which register and request\n  // their own sync lanes. Without this probe, a relaunch whose only pending\n  // work is document-level never schedules any lane and the write queue sits\n  // unattempted forever.\n  if (await hasStartupDocumentSyncWork(execSql)) {\n    return true;\n  }\n\n  const containerIds = Array.from(state.containersById.keys());\n  if (containerIds.length === 0) {\n    return false;\n  }\n  const [containersWithPendingMetadata, containersWithPullContinuations] =\n    await Promise.all([\n      state.persistence.listContainerIdsWithPendingUpdates(\n        execSql,\n        containerIds,\n      ),\n      state.persistence.listContainerIdsWithPullContinuations(\n        execSql,\n        containerIds,\n      ),\n    ]);\n  return (\n    containersWithPendingMetadata.length > 0 ||\n    containersWithPullContinuations.length > 0\n  );\n}\n"]}

package/stores/container-contents/syncAgent.d.ts

@@ -1,8 +0,0 @@
-import type { RemoteContainerHydrationHost } from "../../workflows/container-contents/remoteHydration/index.js";
-import type { ContainerContentsStoreSyncAgent, ContainerContentsStoreSyncState } from "./syncAgentTypes.js";
-export type { ContainerState } from "../../workflows/container-contents/remoteHydration/index.js";
-export type { ContainerContentsStoreRuntime, ContainerContentsStoreSyncAgent, ContainerContentsStoreSyncState, RefreshRootLaneOptions, } from "./syncAgentTypes.js";
-export declare function createContainerContentsStoreSyncAgent(input: {
-    host: RemoteContainerHydrationHost;
-    state: ContainerContentsStoreSyncState;
-}): ContainerContentsStoreSyncAgent;

package/stores/container-contents/syncAgent.js

@@ -1,241 +0,0 @@
-import { loadLocalContainerStates } from "../../workflows/container-contents/localState.js";
-import { isDatabaseUnavailableError, registerContainerContentsSyncLane, } from "../../workflows/container-contents/syncLane.js";
-import { createRestoredAccessReconciler } from "./accessRestorationSweep.js";
-import { observeContainerBackgroundHydration } from "./backgroundHydration.js";
-import { primeStoreDocumentSubtree } from "./documentRecovery.js";
-import { refreshLocalContainerStates } from "./localRefresh.js";
-import { getContainerContentsStoreLogLabel } from "./logLabel.js";
-import { createRemoteContainerIngestionController } from "./remoteContainerIngestion.js";
-import { handleContainerContentsRemoteEvents } from "./remoteEventSync.js";
-import { refreshAllRemoteHydration, refreshRootRemoteHydration, } from "./remoteHydrationRefresh.js";
-import { requestContainerContentsRemoteHydration } from "./remoteHydrationRequest.js";
-import { hasStartupContainerSyncWork, scheduleStaleStartupRemoteHydration, } from "./startupHydration.js";
-import { consumePendingContainerContentsReconnectRefresh } from "./state.js";
-import { runContainerContentsStoreSyncIteration } from "./syncLaneIteration.js";
-function requestContainerContentsStoreSync(state) {
-    state.syncLane?.requestSync();
-}
-async function initializeContainerContentsStore(input) {
-    const { handleRemoteEvents, host, isCurrent, resumeRecoveryWork, scheduleSync, state, } = input;
-    const persistence = state.persistence;
-    const loadRuntime = state.runtime;
-    if (loadRuntime.infra.dbStatus !== "ready") {
-        return;
-    }
-    const localContainerStates = await loadLocalContainerStates({
-        persistence,
-        runtime: loadRuntime,
-    });
-    if (!isCurrent()) {
-        return;
-    }
-    for (const containerState of localContainerStates) {
-        state.containersById.set(containerState.container.id, containerState);
-    }
-    state.initialized = true;
-    const shouldScheduleStaleRootRecovery = await scheduleStaleStartupRemoteHydration({
-        isCurrent,
-        requestHydration: () => requestContainerContentsRemoteHydration({
-            host,
-            resumeRecoveryWork,
-            scheduleSync,
-            state,
-        }),
-        state,
-    });
-    if (!isCurrent()) {
-        return;
-    }
-    const runtime = state.runtime;
-    const hasPendingRestorationSweep = typeof runtime.auth.userId === "string" &&
-        (await persistence.listDormantMetadataSweepRequests(loadRuntime.infra.execSql, runtime.auth.userId)).length > 0;
-    if (!isCurrent()) {
-        return;
-    }
-    host.updateSnapshot();
-    handleRemoteEvents();
-    runtime.util.log(`${getContainerContentsStoreLogLabel(state)}: loaded ${state.containersById.size} container(s)`);
-    const currentRuntime = state.runtime;
-    if (currentRuntime.auth.isAuthenticated && currentRuntime.state.online) {
-        const hasStartupWork = shouldScheduleStaleRootRecovery ||
-            hasPendingRestorationSweep ||
-            (await hasStartupContainerSyncWork(state));
-        if (!isCurrent() || !hasStartupWork) {
-            return;
-        }
-        currentRuntime.util.log(shouldScheduleStaleRootRecovery
-            ? `${getContainerContentsStoreLogLabel(state)}: startup detected stale root recovery; scheduling lane pass`
-            : `${getContainerContentsStoreLogLabel(state)}: startup detected durable sync work; scheduling lane pass`);
-        scheduleSync();
-    }
-}
-function waitForStaleLocalRefreshBeforeInitialization(input) {
-    const { state } = input;
-    const activeRefresh = state.localContainerRefreshPromise;
-    if (!activeRefresh ||
-        (state.localContainerRefreshGeneration === state.lifecycleGeneration &&
-            state.localContainerRefreshStructuralGeneration ===
-                state.structuralGeneration)) {
-        return false;
-    }
-    const lifecycleGeneration = state.lifecycleGeneration;
-    state.initializeGeneration = lifecycleGeneration;
-    const releaseInitializationBarrier = () => {
-        if (state.initializePromise !== initializationBarrier) {
-            return;
-        }
-        state.initializePromise = null;
-        state.initializeGeneration = null;
-        if (state.runtime.infra.dbStatus === "ready") {
-            ensureContainerContentsStoreInitialized(input);
-        }
-    };
-    const initializationBarrier = activeRefresh.then(releaseInitializationBarrier, releaseInitializationBarrier);
-    state.initializePromise = initializationBarrier;
-    return true;
-}
-function ensureContainerContentsStoreInitialized(input) {
-    const { handleRemoteEvents, host, resumeRecoveryWork, scheduleSync, state } = input;
-    if (state.initialized || state.runtime.infra.dbStatus !== "ready") {
-        return;
-    }
-    if (state.initializePromise) {
-        return;
-    }
-    if (waitForStaleLocalRefreshBeforeInitialization(input)) {
-        return;
-    }
-    const lifecycleGeneration = state.lifecycleGeneration;
-    const persistence = state.persistence;
-    const execSql = state.runtime.infra.execSql;
-    const isCurrent = () => state.lifecycleGeneration === lifecycleGeneration &&
-        state.persistence === persistence &&
-        state.runtime.infra.execSql === execSql;
-    state.initializeGeneration = lifecycleGeneration;
-    const initializePromise = initializeContainerContentsStore({
-        handleRemoteEvents,
-        host,
-        isCurrent,
-        resumeRecoveryWork,
-        scheduleSync,
-        state,
-    })
-        .catch((error) => {
-        if (!isCurrent() || isDatabaseUnavailableError(error)) {
-            return;
-        }
-        throw error;
-    })
-        .finally(() => {
-        if (state.initializePromise !== initializePromise) {
-            return;
-        }
-        state.initializePromise = null;
-        state.initializeGeneration = null;
-        if (isCurrent()) {
-            consumePendingContainerContentsReconnectRefresh(state, input.refreshAfterReconnect);
-        }
-        else if (state.runtime.infra.dbStatus === "ready") {
-            ensureContainerContentsStoreInitialized(input);
-        }
-    });
-    state.initializePromise = initializePromise;
-}
-// Read the runtime lazily: updateRuntime replaces state.runtime, so a
-// reference captured at lane registration would report into a dead identity's
-// host. Returns the host's result: both callbacks are declared `=> void` but
-// may be async, and the lane reporter only catches a rejection it is handed.
-function logSyncLaneFailure(state, message, error) {
-    const { log, logError } = state.runtime.util;
-    return logError ? logError(message, error) : log(message);
-}
-function createHydrationRequester(input) {
-    return (options = {}) => requestContainerContentsRemoteHydration({
-        ...input,
-        followDiscoveredParentLanes: options.followDiscoveredParentLanes,
-        parentIds: options.parentIds,
-        resetAllLaneWatermarks: options.resetAllLaneWatermarks,
-    });
-}
-export function createContainerContentsStoreSyncAgent(input) {
-    const { host, state } = input;
-    const scheduleSync = () => requestContainerContentsStoreSync(state);
-    const remoteContainerIngestion = createRemoteContainerIngestionController({
-        host,
-        scheduleSync,
-        state,
-    });
-    const resumeRecoveryWork = remoteContainerIngestion.resumeInterruptedWork;
-    const requestHydration = createHydrationRequester({
-        host,
-        resumeRecoveryWork,
-        scheduleSync,
-        state,
-    });
-    const requestRefreshHydration = (options) => requestContainerContentsRemoteHydration({
-        ...options,
-        host,
-        resumeRecoveryWork,
-        scheduleSync,
-        state,
-    });
-    const scheduleHydration = (options) => observeContainerBackgroundHydration(state, requestHydration(options));
-    const refresh = (options) => refreshAllRemoteHydration({
-        // Explicit user refresh must rediscover children hidden by unsigned hints.
-        resetAllLaneWatermarks: options?.resetAllLaneWatermarks,
-        requestHydration: requestRefreshHydration,
-        state,
-    });
-    const handleRemoteEvents = () => handleContainerContentsRemoteEvents({
-        requestHydration,
-        scheduleSync,
-        state,
-    });
-    const reconcileRestoredAccess = createRestoredAccessReconciler({
-        requestHydration: requestRefreshHydration,
-        state,
-    });
-    state.syncLane = registerContainerContentsSyncLane({
-        domainScope: state.runtime.state.domainScope,
-        logError: (message, error) => logSyncLaneFailure(state, message, error),
-        run: () => runContainerContentsStoreSyncIteration({
-            host,
-            reconcileRestoredAccess,
-            requestRemoteReconciliation: (parentContainerId) => {
-                scheduleHydration({
-                    followDiscoveredParentLanes: false,
-                    parentIds: [parentContainerId],
-                });
-            },
-            state,
-        }),
-    });
-    return {
-        ensureInitialized: () => {
-            ensureContainerContentsStoreInitialized({
-                handleRemoteEvents,
-                host,
-                refreshAfterReconnect: refresh,
-                resumeRecoveryWork,
-                scheduleSync,
-                state,
-            });
-            void resumeRecoveryWork();
-        },
-        handleRemoteEvents,
-        ingestRemoteContainer: remoteContainerIngestion.ingest,
-        primeDocumentsForSharedSubtree: (rootContainerId, isCurrent) => primeStoreDocumentSubtree(state, rootContainerId, isCurrent),
-        refreshLocalContainers: () => refreshLocalContainerStates({ host, state }),
-        refresh,
-        refreshRootLane: (options) => refreshRootRemoteHydration({
-            includeActiveRootChildLane: options?.includeActiveRootChildLane,
-            parentIds: options?.parentIds,
-            requestHydration: requestRefreshHydration,
-            state,
-        }),
-        requestRemoteHydration: requestHydration,
-        scheduleRemoteHydration: scheduleHydration,
-        scheduleSync,
-    };
-}
-//# sourceMappingURL=syncAgent.js.map

package/stores/container-contents/syncAgent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"syncAgent.js","sourceRoot":"","sources":["syncAgent.ts"],"names":[],"mappings":"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","sourcesContent":["import { loadLocalContainerStates } from \"../../workflows/container-contents/localState\";\nimport type { RemoteContainerHydrationHost } from \"../../workflows/container-contents/remoteHydration\";\nimport {\n  isDatabaseUnavailableError,\n  registerContainerContentsSyncLane,\n} from \"../../workflows/container-contents/syncLane\";\nimport { createRestoredAccessReconciler } from \"./accessRestorationSweep\";\nimport { observeContainerBackgroundHydration } from \"./backgroundHydration\";\nimport { primeStoreDocumentSubtree } from \"./documentRecovery\";\nimport { refreshLocalContainerStates } from \"./localRefresh\";\nimport { getContainerContentsStoreLogLabel } from \"./logLabel\";\nimport { createRemoteContainerIngestionController } from \"./remoteContainerIngestion\";\nimport { handleContainerContentsRemoteEvents } from \"./remoteEventSync\";\nimport {\n  type RemoteHydrationRefreshOptions,\n  refreshAllRemoteHydration,\n  refreshRootRemoteHydration,\n} from \"./remoteHydrationRefresh\";\nimport { requestContainerContentsRemoteHydration } from \"./remoteHydrationRequest\";\nimport {\n  hasStartupContainerSyncWork,\n  scheduleStaleStartupRemoteHydration,\n} from \"./startupHydration\";\nimport { consumePendingContainerContentsReconnectRefresh } from \"./state\";\nimport type {\n  ContainerContentsStoreSyncAgent,\n  ContainerContentsStoreSyncState,\n} from \"./syncAgentTypes\";\nimport { runContainerContentsStoreSyncIteration } from \"./syncLaneIteration\";\n\nexport type { ContainerState } from \"../../workflows/container-contents/remoteHydration\";\nexport type {\n  ContainerContentsStoreRuntime,\n  ContainerContentsStoreSyncAgent,\n  ContainerContentsStoreSyncState,\n  RefreshRootLaneOptions,\n} from \"./syncAgentTypes\";\n\nfunction requestContainerContentsStoreSync(\n  state: ContainerContentsStoreSyncState,\n) {\n  state.syncLane?.requestSync();\n}\n\nasync function initializeContainerContentsStore(input: {\n  handleRemoteEvents: () => void;\n  host: RemoteContainerHydrationHost;\n  isCurrent: () => boolean;\n  resumeRecoveryWork: () => Promise<void>;\n  scheduleSync: () => void;\n  state: ContainerContentsStoreSyncState;\n}) {\n  const {\n    handleRemoteEvents,\n    host,\n    isCurrent,\n    resumeRecoveryWork,\n    scheduleSync,\n    state,\n  } = input;\n  const persistence = state.persistence;\n  const loadRuntime = state.runtime;\n  if (loadRuntime.infra.dbStatus !== \"ready\") {\n    return;\n  }\n\n  const localContainerStates = await loadLocalContainerStates({\n    persistence,\n    runtime: loadRuntime,\n  });\n  if (!isCurrent()) {\n    return;\n  }\n\n  for (const containerState of localContainerStates) {\n    state.containersById.set(containerState.container.id, containerState);\n  }\n\n  state.initialized = true;\n\n  const shouldScheduleStaleRootRecovery =\n    await scheduleStaleStartupRemoteHydration({\n      isCurrent,\n      requestHydration: () =>\n        requestContainerContentsRemoteHydration({\n          host,\n          resumeRecoveryWork,\n          scheduleSync,\n          state,\n        }),\n      state,\n    });\n  if (!isCurrent()) {\n    return;\n  }\n  const runtime = state.runtime;\n  const hasPendingRestorationSweep =\n    typeof runtime.auth.userId === \"string\" &&\n    (\n      await persistence.listDormantMetadataSweepRequests(\n        loadRuntime.infra.execSql,\n        runtime.auth.userId,\n      )\n    ).length > 0;\n  if (!isCurrent()) {\n    return;\n  }\n\n  host.updateSnapshot();\n  handleRemoteEvents();\n\n  runtime.util.log(\n    `${getContainerContentsStoreLogLabel(state)}: loaded ${state.containersById.size} container(s)`,\n  );\n\n  const currentRuntime = state.runtime;\n  if (currentRuntime.auth.isAuthenticated && currentRuntime.state.online) {\n    const hasStartupWork =\n      shouldScheduleStaleRootRecovery ||\n      hasPendingRestorationSweep ||\n      (await hasStartupContainerSyncWork(state));\n    if (!isCurrent() || !hasStartupWork) {\n      return;\n    }\n    currentRuntime.util.log(\n      shouldScheduleStaleRootRecovery\n        ? `${getContainerContentsStoreLogLabel(state)}: startup detected stale root recovery; scheduling lane pass`\n        : `${getContainerContentsStoreLogLabel(state)}: startup detected durable sync work; scheduling lane pass`,\n    );\n    scheduleSync();\n  }\n}\n\nfunction waitForStaleLocalRefreshBeforeInitialization(input: {\n  handleRemoteEvents: () => void;\n  host: RemoteContainerHydrationHost;\n  refreshAfterReconnect: () => Promise<boolean>;\n  resumeRecoveryWork: () => Promise<void>;\n  scheduleSync: () => void;\n  state: ContainerContentsStoreSyncState;\n}): boolean {\n  const { state } = input;\n  const activeRefresh = state.localContainerRefreshPromise;\n  if (\n    !activeRefresh ||\n    (state.localContainerRefreshGeneration === state.lifecycleGeneration &&\n      state.localContainerRefreshStructuralGeneration ===\n        state.structuralGeneration)\n  ) {\n    return false;\n  }\n\n  const lifecycleGeneration = state.lifecycleGeneration;\n  state.initializeGeneration = lifecycleGeneration;\n  const releaseInitializationBarrier = () => {\n    if (state.initializePromise !== initializationBarrier) {\n      return;\n    }\n    state.initializePromise = null;\n    state.initializeGeneration = null;\n    if (state.runtime.infra.dbStatus === \"ready\") {\n      ensureContainerContentsStoreInitialized(input);\n    }\n  };\n  const initializationBarrier = activeRefresh.then(\n    releaseInitializationBarrier,\n    releaseInitializationBarrier,\n  );\n  state.initializePromise = initializationBarrier;\n  return true;\n}\n\nfunction ensureContainerContentsStoreInitialized(input: {\n  handleRemoteEvents: () => void;\n  host: RemoteContainerHydrationHost;\n  refreshAfterReconnect: () => Promise<boolean>;\n  resumeRecoveryWork: () => Promise<void>;\n  scheduleSync: () => void;\n  state: ContainerContentsStoreSyncState;\n}) {\n  const { handleRemoteEvents, host, resumeRecoveryWork, scheduleSync, state } =\n    input;\n  if (state.initialized || state.runtime.infra.dbStatus !== \"ready\") {\n    return;\n  }\n  if (state.initializePromise) {\n    return;\n  }\n  if (waitForStaleLocalRefreshBeforeInitialization(input)) {\n    return;\n  }\n\n  const lifecycleGeneration = state.lifecycleGeneration;\n  const persistence = state.persistence;\n  const execSql = state.runtime.infra.execSql;\n  const isCurrent = () =>\n    state.lifecycleGeneration === lifecycleGeneration &&\n    state.persistence === persistence &&\n    state.runtime.infra.execSql === execSql;\n  state.initializeGeneration = lifecycleGeneration;\n  const initializePromise = initializeContainerContentsStore({\n    handleRemoteEvents,\n    host,\n    isCurrent,\n    resumeRecoveryWork,\n    scheduleSync,\n    state,\n  })\n    .catch((error: unknown) => {\n      if (!isCurrent() || isDatabaseUnavailableError(error)) {\n        return;\n      }\n\n      throw error;\n    })\n    .finally(() => {\n      if (state.initializePromise !== initializePromise) {\n        return;\n      }\n      state.initializePromise = null;\n      state.initializeGeneration = null;\n      if (isCurrent()) {\n        consumePendingContainerContentsReconnectRefresh(\n          state,\n          input.refreshAfterReconnect,\n        );\n      } else if (state.runtime.infra.dbStatus === \"ready\") {\n        ensureContainerContentsStoreInitialized(input);\n      }\n    });\n  state.initializePromise = initializePromise;\n}\n\n// Read the runtime lazily: updateRuntime replaces state.runtime, so a\n// reference captured at lane registration would report into a dead identity's\n// host. Returns the host's result: both callbacks are declared `=> void` but\n// may be async, and the lane reporter only catches a rejection it is handed.\nfunction logSyncLaneFailure(\n  state: ContainerContentsStoreSyncState,\n  message: string,\n  error: unknown,\n): unknown {\n  const { log, logError } = state.runtime.util;\n  return logError ? logError(message, error) : log(message);\n}\n\nfunction createHydrationRequester(input: {\n  host: RemoteContainerHydrationHost;\n  resumeRecoveryWork: () => Promise<void>;\n  scheduleSync: () => void;\n  state: ContainerContentsStoreSyncState;\n}): ContainerContentsStoreSyncAgent[\"requestRemoteHydration\"] {\n  return (options = {}) =>\n    requestContainerContentsRemoteHydration({\n      ...input,\n      followDiscoveredParentLanes: options.followDiscoveredParentLanes,\n      parentIds: options.parentIds,\n      resetAllLaneWatermarks: options.resetAllLaneWatermarks,\n    });\n}\n\nexport function createContainerContentsStoreSyncAgent(input: {\n  host: RemoteContainerHydrationHost;\n  state: ContainerContentsStoreSyncState;\n}): ContainerContentsStoreSyncAgent {\n  const { host, state } = input;\n  const scheduleSync = () => requestContainerContentsStoreSync(state);\n  const remoteContainerIngestion = createRemoteContainerIngestionController({\n    host,\n    scheduleSync,\n    state,\n  });\n  const resumeRecoveryWork = remoteContainerIngestion.resumeInterruptedWork;\n\n  const requestHydration = createHydrationRequester({\n    host,\n    resumeRecoveryWork,\n    scheduleSync,\n    state,\n  });\n  const requestRefreshHydration = (options: RemoteHydrationRefreshOptions) =>\n    requestContainerContentsRemoteHydration({\n      ...options,\n      host,\n      resumeRecoveryWork,\n      scheduleSync,\n      state,\n    });\n  const scheduleHydration = (\n    options?: Parameters<typeof requestHydration>[0],\n  ) => observeContainerBackgroundHydration(state, requestHydration(options));\n  const refresh: ContainerContentsStoreSyncAgent[\"refresh\"] = (options) =>\n    refreshAllRemoteHydration({\n      // Explicit user refresh must rediscover children hidden by unsigned hints.\n      resetAllLaneWatermarks: options?.resetAllLaneWatermarks,\n      requestHydration: requestRefreshHydration,\n      state,\n    });\n  const handleRemoteEvents = () =>\n    handleContainerContentsRemoteEvents({\n      requestHydration,\n      scheduleSync,\n      state,\n    });\n  const reconcileRestoredAccess = createRestoredAccessReconciler({\n    requestHydration: requestRefreshHydration,\n    state,\n  });\n\n  state.syncLane = registerContainerContentsSyncLane({\n    domainScope: state.runtime.state.domainScope,\n    logError: (message, error) => logSyncLaneFailure(state, message, error),\n    run: () =>\n      runContainerContentsStoreSyncIteration({\n        host,\n        reconcileRestoredAccess,\n        requestRemoteReconciliation: (parentContainerId) => {\n          scheduleHydration({\n            followDiscoveredParentLanes: false,\n            parentIds: [parentContainerId],\n          });\n        },\n        state,\n      }),\n  });\n\n  return {\n    ensureInitialized: () => {\n      ensureContainerContentsStoreInitialized({\n        handleRemoteEvents,\n        host,\n        refreshAfterReconnect: refresh,\n        resumeRecoveryWork,\n        scheduleSync,\n        state,\n      });\n      void resumeRecoveryWork();\n    },\n    handleRemoteEvents,\n    ingestRemoteContainer: remoteContainerIngestion.ingest,\n    primeDocumentsForSharedSubtree: (rootContainerId, isCurrent) =>\n      primeStoreDocumentSubtree(state, rootContainerId, isCurrent),\n    refreshLocalContainers: () => refreshLocalContainerStates({ host, state }),\n    refresh,\n    refreshRootLane: (options) =>\n      refreshRootRemoteHydration({\n        includeActiveRootChildLane: options?.includeActiveRootChildLane,\n        parentIds: options?.parentIds,\n        requestHydration: requestRefreshHydration,\n        state,\n      }),\n    requestRemoteHydration: requestHydration,\n    scheduleRemoteHydration: scheduleHydration,\n    scheduleSync,\n  };\n}\n"]}

package/stores/container-contents/syncAgentTypes.d.ts

@@ -1,81 +0,0 @@
-import type { ContainerContentsPersistence } from "../../workflows/container-contents/containerPersistence.js";
-import type { ContainerContentsProjectionUserKeyResolver } from "../../workflows/container-contents/projectionKeys.js";
-import type { ContainerState, RemoteContainer } from "../../workflows/container-contents/remoteHydration/index.js";
-import type { ContainerContentsStoreWorkflowRuntime } from "../../workflows/container-contents/runtime.js";
-import type { ContainerContentsSyncLane } from "../../workflows/container-contents/syncLane.js";
-export type ContainerContentsStoreRuntime = ContainerContentsStoreWorkflowRuntime;
-export interface RefreshRootLaneOptions {
-    readonly includeActiveRootChildLane?: boolean | undefined;
-    readonly parentIds?: ReadonlyArray<string | null> | undefined;
-}
-export interface ContainerContentsStoreSyncAgent {
-    ensureInitialized: () => void;
-    handleRemoteEvents: () => void;
-    ingestRemoteContainer: (remoteContainer: RemoteContainer) => Promise<void>;
-    primeDocumentsForSharedSubtree: (rootContainerId: string, isCurrent?: (() => boolean) | undefined) => Promise<void>;
-    refreshLocalContainers: () => Promise<void>;
-    refresh: (options?: {
-        resetAllLaneWatermarks?: boolean;
-    }) => Promise<boolean>;
-    refreshRootLane: (options?: RefreshRootLaneOptions) => Promise<boolean>;
-    requestRemoteHydration: (options?: {
-        followDiscoveredParentLanes?: boolean | undefined;
-        parentIds?: ReadonlyArray<string | null> | undefined;
-        resetAllLaneWatermarks?: boolean | undefined;
-    }) => Promise<void>;
-    scheduleRemoteHydration: () => void;
-    scheduleSync: () => void;
-}
-export interface ContainerContentsStoreSyncState {
-    containersById: Map<string, ContainerState>;
-    documentStoresNeedPriming: boolean;
-    initializeGeneration: number | null;
-    initializePromise: Promise<void> | null;
-    initialized: boolean;
-    localContainerRefreshPromise: Promise<void> | null;
-    localContainerRefreshGeneration: number | null;
-    localContainerRefreshStructuralGeneration: number | null;
-    localContainersNeedRefresh: boolean;
-    /** Invalidates asynchronous hydration work when this store is reset. */
-    lifecycleGeneration: number;
-    /** Invalidates structural work when its runtime or persistence is replaced. */
-    structuralGeneration: number;
-    /** Invalidates writes across write-relevant runtime ABA transitions. */
-    writeGeneration: number;
-    lastEventCount: number;
-    /**
-     * Update ids this client sent for container metadata documents, registered
-     * before the network await of each metadata sync pass. The author's own
-     * `document_update_created` echo consumes its ids here instead of arming a
-     * redundant forced read-sync; a genuine peer update always carries unknown
-     * ids and still forces one. Shared across all metadata docs in the store —
-     * update ids are globally unique.
-     */
-    locallyAcceptedMetadataUpdateIds: Set<string>;
-    logLabel?: string | undefined;
-    metadataDocumentIdsNeedingSync: Set<string>;
-    /**
-     * Per-metadata-document enqueue sequence. Bumped for a specific id whenever a
-     * remote event re-queues it in {@link metadataDocumentIdsNeedingSync}. A sync
-     * pass snapshots the id's sequence before its GET and only clears the id if it
-     * is unchanged at pass end, so a mid-pass re-queue of THIS container is not
-     * erased. Keyed per id (not a single global counter) so a remote event for an
-     * unrelated container does not force a redundant re-sync of this one. See
-     * `clearMetadataSyncQueueIfUnchanged`.
-     */
-    metadataSyncSignalSeqById: Map<string, number>;
-    containerParentIdsNeedingHydration: Set<string | null>;
-    persistence: ContainerContentsPersistence;
-    remoteHydrationPromise: Promise<void> | null;
-    remoteHydrationGeneration: number | null;
-    remoteHydrationStructuralGeneration: number | null;
-    remoteReconnectRefreshPending: boolean;
-    resolveProjectionUserKey: ContainerContentsProjectionUserKeyResolver;
-    /** True after this store has fully applied an authoritative root lane. */
-    rootLaneHydrated: boolean;
-    runtime: ContainerContentsStoreRuntime;
-    snapshot: {
-        ready: boolean;
-    };
-    syncLane: ContainerContentsSyncLane | null;
-}

package/stores/container-contents/syncAgentTypes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"syncAgentTypes.js","sourceRoot":"","sources":["syncAgentTypes.ts"],"names":[],"mappings":"","sourcesContent":["import type { ContainerContentsPersistence } from \"../../workflows/container-contents/containerPersistence\";\nimport type { ContainerContentsProjectionUserKeyResolver } from \"../../workflows/container-contents/projectionKeys\";\nimport type {\n  ContainerState,\n  RemoteContainer,\n} from \"../../workflows/container-contents/remoteHydration\";\nimport type { ContainerContentsStoreWorkflowRuntime } from \"../../workflows/container-contents/runtime\";\nimport type { ContainerContentsSyncLane } from \"../../workflows/container-contents/syncLane\";\n\nexport type ContainerContentsStoreRuntime =\n  ContainerContentsStoreWorkflowRuntime;\n\nexport interface RefreshRootLaneOptions {\n  readonly includeActiveRootChildLane?: boolean | undefined;\n  // Extra parent lanes to re-list alongside the root lane. Used by the\n  // resync_required handler to re-list affected containers' parent lanes so a\n  // tombstone only visible there is still applied without the full crawl.\n  readonly parentIds?: ReadonlyArray<string | null> | undefined;\n}\n\nexport interface ContainerContentsStoreSyncAgent {\n  ensureInitialized: () => void;\n  handleRemoteEvents: () => void;\n  ingestRemoteContainer: (remoteContainer: RemoteContainer) => Promise<void>;\n  primeDocumentsForSharedSubtree: (\n    rootContainerId: string,\n    isCurrent?: (() => boolean) | undefined,\n  ) => Promise<void>;\n  refreshLocalContainers: () => Promise<void>;\n  refresh: (options?: { resetAllLaneWatermarks?: boolean }) => Promise<boolean>;\n  refreshRootLane: (options?: RefreshRootLaneOptions) => Promise<boolean>;\n  requestRemoteHydration: (options?: {\n    followDiscoveredParentLanes?: boolean | undefined;\n    parentIds?: ReadonlyArray<string | null> | undefined;\n    resetAllLaneWatermarks?: boolean | undefined;\n  }) => Promise<void>;\n  scheduleRemoteHydration: () => void;\n  scheduleSync: () => void;\n}\n\nexport interface ContainerContentsStoreSyncState {\n  containersById: Map<string, ContainerState>;\n  documentStoresNeedPriming: boolean;\n  initializeGeneration: number | null;\n  initializePromise: Promise<void> | null;\n  initialized: boolean;\n  localContainerRefreshPromise: Promise<void> | null;\n  localContainerRefreshGeneration: number | null;\n  localContainerRefreshStructuralGeneration: number | null;\n  localContainersNeedRefresh: boolean;\n  /** Invalidates asynchronous hydration work when this store is reset. */\n  lifecycleGeneration: number;\n  /** Invalidates structural work when its runtime or persistence is replaced. */\n  structuralGeneration: number;\n  /** Invalidates writes across write-relevant runtime ABA transitions. */\n  writeGeneration: number;\n  lastEventCount: number;\n  /**\n   * Update ids this client sent for container metadata documents, registered\n   * before the network await of each metadata sync pass. The author's own\n   * `document_update_created` echo consumes its ids here instead of arming a\n   * redundant forced read-sync; a genuine peer update always carries unknown\n   * ids and still forces one. Shared across all metadata docs in the store —\n   * update ids are globally unique.\n   */\n  locallyAcceptedMetadataUpdateIds: Set<string>;\n  logLabel?: string | undefined;\n  metadataDocumentIdsNeedingSync: Set<string>;\n  /**\n   * Per-metadata-document enqueue sequence. Bumped for a specific id whenever a\n   * remote event re-queues it in {@link metadataDocumentIdsNeedingSync}. A sync\n   * pass snapshots the id's sequence before its GET and only clears the id if it\n   * is unchanged at pass end, so a mid-pass re-queue of THIS container is not\n   * erased. Keyed per id (not a single global counter) so a remote event for an\n   * unrelated container does not force a redundant re-sync of this one. See\n   * `clearMetadataSyncQueueIfUnchanged`.\n   */\n  metadataSyncSignalSeqById: Map<string, number>;\n  containerParentIdsNeedingHydration: Set<string | null>;\n  persistence: ContainerContentsPersistence;\n  remoteHydrationPromise: Promise<void> | null;\n  remoteHydrationGeneration: number | null;\n  remoteHydrationStructuralGeneration: number | null;\n  remoteReconnectRefreshPending: boolean;\n  resolveProjectionUserKey: ContainerContentsProjectionUserKeyResolver;\n  /** True after this store has fully applied an authoritative root lane. */\n  rootLaneHydrated: boolean;\n  runtime: ContainerContentsStoreRuntime;\n  snapshot: { ready: boolean };\n  syncLane: ContainerContentsSyncLane | null;\n}\n"]}