@tearleads/client-sdk 0.1.63 → 0.1.65

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

@@ -0,0 +1,110 @@
+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/hydration/startupHydration.js.map

@@ -0,0 +1 @@
+{"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/index.d.ts

@@ -1,6 +1,6 @@
-export type { PurgeOptions, PurgeProgress, } from "../../workflows/container-contents/container-state/purgeProgress.js";
+export type { PurgeOptions, PurgeProgress, } from "../../workflows/container-contents/container-state/purge/purgeProgress.js";
 export * from "./containerContentsStore.js";
-export { isAutomaticRootCatchupContainerNode, isForeignSystemContainerNode, isReconcilableContainerNode, isRemoteBackedContainerNode, isSystemContainerNode, } from "./reconcilableContainer.js";
+export { isAutomaticRootCatchupContainerNode, isForeignSystemContainerNode, isReconcilableContainerNode, isRemoteBackedContainerNode, isSystemContainerNode, } from "./containerState/reconcilableContainer.js";
 export * from "./state.js";
-export * from "./syncAgent.js";
+export * from "./syncAgent/index.js";
 export * from "./types.js";

package/stores/container-contents/index.js

@@ -1,6 +1,6 @@
 export * from "./containerContentsStore.js";
-export { isAutomaticRootCatchupContainerNode, isForeignSystemContainerNode, isReconcilableContainerNode, isRemoteBackedContainerNode, isSystemContainerNode, } from "./reconcilableContainer.js";
+export { isAutomaticRootCatchupContainerNode, isForeignSystemContainerNode, isReconcilableContainerNode, isRemoteBackedContainerNode, isSystemContainerNode, } from "./containerState/reconcilableContainer.js";
 export * from "./state.js";
-export * from "./syncAgent.js";
+export * from "./syncAgent/index.js";
 export * from "./types.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAIA,cAAc,0BAA0B,CAAC;AACzC,OAAO,EACL,mCAAmC,EACnC,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC","sourcesContent":["export type {\n  PurgeOptions,\n  PurgeProgress,\n} from \"../../workflows/container-contents/container-state/purgeProgress\";\nexport * from \"./containerContentsStore\";\nexport {\n  isAutomaticRootCatchupContainerNode,\n  isForeignSystemContainerNode,\n  isReconcilableContainerNode,\n  isRemoteBackedContainerNode,\n  isSystemContainerNode,\n} from \"./reconcilableContainer\";\nexport * from \"./state\";\nexport * from \"./syncAgent\";\nexport * from \"./types\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAIA,cAAc,0BAA0B,CAAC;AACzC,OAAO,EACL,mCAAmC,EACnC,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,wCAAwC,CAAC;AAChD,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC","sourcesContent":["export type {\n  PurgeOptions,\n  PurgeProgress,\n} from \"../../workflows/container-contents/container-state/purge/purgeProgress\";\nexport * from \"./containerContentsStore\";\nexport {\n  isAutomaticRootCatchupContainerNode,\n  isForeignSystemContainerNode,\n  isReconcilableContainerNode,\n  isRemoteBackedContainerNode,\n  isSystemContainerNode,\n} from \"./containerState/reconcilableContainer\";\nexport * from \"./state\";\nexport * from \"./syncAgent\";\nexport * from \"./types\";\n"]}

package/stores/container-contents/localRefresh.js

@@ -5,8 +5,8 @@ import { installContainerMetadataRecord } from "../../workflows/container-conten
 import { currentMetadataPullContinuation } from "../../workflows/container-contents/metadata/metadataPersistence.js";
 import { reconcileLocalOnlyRootContainers } from "../../workflows/container-contents/remoteHydration/reconciliation.js";
 import { isDatabaseUnavailableError } from "../../workflows/container-contents/syncLane.js";
-import { captureContainerStateMutationGenerations, containerStateMutatedAfter, } from "./containerStateMap.js";
-import { isRemoteBackedContainerState } from "./remoteBackedContainerState.js";
+import { captureContainerStateMutationGenerations, containerStateMutatedAfter, } from "./containerState/containerStateMap.js";
+import { isRemoteBackedContainerState } from "./remoteEvents/remoteBackedContainerState.js";
 function readMetadataDocVersion(state) {
     try {
         return encodeVersionVector(state.doc);

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

@@ -1 +1 @@
-{"version":3,"file":"localRefresh.js","sourceRoot":"","sources":["localRefresh.ts"],"names":[],"mappings":"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","sourcesContent":["import { encodeVersionVector } from \"@tearleads/loro\";\nimport { errorMessage } from \"../../data/shared/errorMessage\";\nimport type { ContainerContentsPersistence } from \"../../workflows/container-contents/containerPersistence\";\nimport { loadLocalContainerStates } from \"../../workflows/container-contents/localState\";\nimport { installContainerMetadataRecord } from \"../../workflows/container-contents/metadata\";\nimport { currentMetadataPullContinuation } from \"../../workflows/container-contents/metadata/metadataPersistence\";\nimport type { ContainerState } from \"../../workflows/container-contents/remoteHydration\";\nimport { reconcileLocalOnlyRootContainers } from \"../../workflows/container-contents/remoteHydration/reconciliation\";\nimport type { ContainerContentsWorkflowRuntime } from \"../../workflows/container-contents/runtime\";\nimport { isDatabaseUnavailableError } from \"../../workflows/container-contents/syncLane\";\nimport {\n  captureContainerStateMutationGenerations,\n  containerStateMutatedAfter,\n} from \"./containerStateMap\";\nimport { isRemoteBackedContainerState } from \"./remoteBackedContainerState\";\n\ninterface LocalContainerRefreshHost {\n  updateSnapshot: () => void;\n}\n\nexport interface LocalContainerRefreshState {\n  containersById: Map<string, ContainerState>;\n  documentStoresNeedPriming: boolean;\n  initialized: boolean;\n  lifecycleGeneration: number;\n  localContainerRefreshGeneration: number | null;\n  localContainerRefreshPromise: Promise<void> | null;\n  localContainerRefreshStructuralGeneration: number | null;\n  localContainersNeedRefresh: boolean;\n  persistence: ContainerContentsPersistence;\n  runtime: ContainerContentsWorkflowRuntime;\n  structuralGeneration: number;\n}\n\ninterface LocalContainerRefreshBaseline {\n  container: ContainerState[\"container\"];\n  docVersion: string | null;\n  pullContinuation: ReturnType<typeof currentMetadataPullContinuation>;\n  record: ContainerState[\"record\"];\n}\n\nfunction readMetadataDocVersion(state: ContainerState): string | null {\n  try {\n    return encodeVersionVector(state.doc);\n  } catch {\n    return null;\n  }\n}\n\nfunction captureLocalContainerRefreshBaselines(\n  states: ReadonlyMap<string, ContainerState>,\n): ReadonlyMap<string, LocalContainerRefreshBaseline> {\n  return new Map(\n    Array.from(states, ([containerId, state]) => [\n      containerId,\n      {\n        container: state.container,\n        docVersion: readMetadataDocVersion(state),\n        pullContinuation: currentMetadataPullContinuation(state),\n        record: state.record,\n      },\n    ]),\n  );\n}\n\nfunction liveContainerStateChangedAfterRefreshStarted(\n  state: ContainerState,\n  baseline: LocalContainerRefreshBaseline | undefined,\n): boolean {\n  // No baseline means this live state was inserted after the refresh began.\n  // The loaded snapshot cannot authoritatively replace a state that did not\n  // exist when its query started.\n  return (\n    baseline === undefined ||\n    state.container !== baseline.container ||\n    state.record !== baseline.record ||\n    currentMetadataPullContinuation(state) !== baseline.pullContinuation ||\n    readMetadataDocVersion(state) !== baseline.docVersion\n  );\n}\n\nfunction mergeLocalContainerStates(input: {\n  containerMutationGenerations: ReadonlyMap<string, number>;\n  liveStateBaselines: ReadonlyMap<string, LocalContainerRefreshBaseline>;\n  localContainerStates: ReadonlyArray<ContainerState>;\n  remoteContainerIdsAtLoadStart: ReadonlySet<string>;\n  state: LocalContainerRefreshState;\n}): void {\n  for (const localContainerState of input.localContainerStates) {\n    const containerId = localContainerState.container.id;\n    if (\n      containerStateMutatedAfter(\n        input.state.containersById,\n        containerId,\n        input.containerMutationGenerations,\n      )\n    ) {\n      continue;\n    }\n    const existingState = input.state.containersById.get(containerId);\n    if (existingState) {\n      if (\n        liveContainerStateChangedAfterRefreshStarted(\n          existingState,\n          input.liveStateBaselines.get(containerId),\n        )\n      ) {\n        continue;\n      }\n      // The load can start before a remote create and finish after it. Its\n      // local-only snapshot must not erase the remote identity that the create\n      // persisted in the meantime, or the pending create intent is re-queued.\n      if (\n        !input.remoteContainerIdsAtLoadStart.has(containerId) &&\n        existingState.record.documentId &&\n        !localContainerState.record.documentId\n      ) {\n        continue;\n      }\n      existingState.container = localContainerState.container;\n      existingState.doc = localContainerState.doc;\n      installContainerMetadataRecord(existingState, localContainerState.record);\n    } else if (!input.liveStateBaselines.has(containerId)) {\n      // A baseline without a live entry means the state was removed while the\n      // load was pending. Do not resurrect that stale snapshot.\n      input.state.containersById.set(containerId, localContainerState);\n    }\n  }\n}\n\nfunction isRemoteBackedRootState(containerState: ContainerState): boolean {\n  return (\n    containerState.container.parentId === null &&\n    isRemoteBackedContainerState(containerState)\n  );\n}\n\nasync function reconcileLocalsLoadedAfterRemoteState(\n  state: LocalContainerRefreshState,\n  isCurrent: () => boolean,\n): Promise<void> {\n  const remoteRootStates = Array.from(state.containersById.values()).filter(\n    isRemoteBackedRootState,\n  );\n  for (const remoteRootState of remoteRootStates) {\n    if (!isCurrent()) {\n      return;\n    }\n    await reconcileLocalOnlyRootContainers({\n      isCurrent,\n      remoteRootState,\n      state,\n    });\n  }\n}\n\n/**\n * Hand the tree-rebuild failure to host diagnostics as a real `Error`: the\n * unguarded metadata import inside `loadLocalContainerStates` lands corrupt\n * persisted state here, which the string-only log line cannot carry. That line\n * is the fallback for a host without `logError`, so there is no second copy.\n */\nfunction reportLocalContainerRefreshFailure(\n  util: ContainerContentsWorkflowRuntime[\"util\"],\n  error: unknown,\n): void {\n  // Losing the database mid-flight is the teardown outcome the re-armed refresh\n  // already covers, not a defect.\n  if (!util.logError || isDatabaseUnavailableError(error)) return;\n  try {\n    // Callers run `void refreshLocalContainers()`, so a host logger that throws\n    // or rejects must not escape as an unhandled rejection carrying app frames.\n    void Promise.resolve(\n      util.logError(\n        \"Container contents: local container refresh failed\",\n        error,\n      ),\n    ).catch(() => undefined);\n  } catch {\n    // Hosts may throw synchronously or return a rejected promise.\n  }\n}\n\nexport function refreshLocalContainerStates(input: {\n  host: LocalContainerRefreshHost;\n  state: LocalContainerRefreshState;\n}): Promise<void> {\n  const { host, state } = input;\n  if (state.localContainerRefreshPromise) {\n    const activeRefresh = state.localContainerRefreshPromise;\n    if (\n      state.localContainerRefreshGeneration === state.lifecycleGeneration &&\n      state.localContainerRefreshStructuralGeneration ===\n        state.structuralGeneration\n    ) {\n      return activeRefresh;\n    }\n    // A stale refresh owns its replacement retry in `finally`, so callers can\n    // share that promise without scheduling a second replacement load.\n    return activeRefresh;\n  }\n\n  if (\n    !state.localContainersNeedRefresh ||\n    !state.initialized ||\n    state.runtime.infra.dbStatus !== \"ready\"\n  ) {\n    return Promise.resolve();\n  }\n\n  const lifecycleGeneration = state.lifecycleGeneration;\n  const structuralGeneration = state.structuralGeneration;\n  const isCurrent = () =>\n    state.lifecycleGeneration === lifecycleGeneration &&\n    state.structuralGeneration === structuralGeneration;\n  state.localContainersNeedRefresh = false;\n  const liveStateBaselines = captureLocalContainerRefreshBaselines(\n    state.containersById,\n  );\n  const containerMutationGenerations = captureContainerStateMutationGenerations(\n    state.containersById,\n  );\n  const remoteContainerIdsAtLoadStart = new Set<string>();\n  for (const containerState of state.containersById.values()) {\n    if (containerState.record.documentId) {\n      remoteContainerIdsAtLoadStart.add(containerState.container.id);\n    }\n  }\n  state.localContainerRefreshGeneration = lifecycleGeneration;\n  state.localContainerRefreshStructuralGeneration = structuralGeneration;\n  const refreshPromise = loadLocalContainerStates({\n    persistence: state.persistence,\n    runtime: state.runtime,\n  })\n    .then(async (localContainerStates) => {\n      if (!isCurrent()) {\n        return;\n      }\n      mergeLocalContainerStates({\n        containerMutationGenerations,\n        liveStateBaselines,\n        localContainerStates,\n        remoteContainerIdsAtLoadStart,\n        state,\n      });\n      // Remote hydration can win the startup race and ingest the server root\n      // before this local read returns. Re-run root/system convergence after\n      // merging so that the late local bootstrap rows cannot reintroduce a\n      // stale root and same-slot system children into the live tree.\n      await reconcileLocalsLoadedAfterRemoteState(state, isCurrent);\n      if (!isCurrent()) {\n        return;\n      }\n      state.documentStoresNeedPriming = true;\n      host.updateSnapshot();\n    })\n    .catch((error: unknown) => {\n      if (!isCurrent()) {\n        return;\n      }\n      state.localContainersNeedRefresh = true;\n      state.runtime.util.log(\n        `Failed to refresh local container states: ${errorMessage(error)}`,\n      );\n      reportLocalContainerRefreshFailure(state.runtime.util, error);\n    })\n    .finally(() => {\n      const shouldRetryAfterReplacement = !isCurrent();\n      if (state.localContainerRefreshPromise === refreshPromise) {\n        state.localContainerRefreshPromise = null;\n        state.localContainerRefreshGeneration = null;\n        state.localContainerRefreshStructuralGeneration = null;\n      }\n      if (shouldRetryAfterReplacement) {\n        state.localContainersNeedRefresh = true;\n        return refreshLocalContainerStates(input);\n      }\n      return undefined;\n    });\n  state.localContainerRefreshPromise = refreshPromise;\n\n  return refreshPromise;\n}\n"]}
+{"version":3,"file":"localRefresh.js","sourceRoot":"","sources":["localRefresh.ts"],"names":[],"mappings":"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","sourcesContent":["import { encodeVersionVector } from \"@tearleads/loro\";\nimport { errorMessage } from \"../../data/shared/errorMessage\";\nimport type { ContainerContentsPersistence } from \"../../workflows/container-contents/containerPersistence\";\nimport { loadLocalContainerStates } from \"../../workflows/container-contents/localState\";\nimport { installContainerMetadataRecord } from \"../../workflows/container-contents/metadata\";\nimport { currentMetadataPullContinuation } from \"../../workflows/container-contents/metadata/metadataPersistence\";\nimport type { ContainerState } from \"../../workflows/container-contents/remoteHydration\";\nimport { reconcileLocalOnlyRootContainers } from \"../../workflows/container-contents/remoteHydration/reconciliation\";\nimport type { ContainerContentsWorkflowRuntime } from \"../../workflows/container-contents/runtime\";\nimport { isDatabaseUnavailableError } from \"../../workflows/container-contents/syncLane\";\nimport {\n  captureContainerStateMutationGenerations,\n  containerStateMutatedAfter,\n} from \"./containerState/containerStateMap\";\nimport { isRemoteBackedContainerState } from \"./remoteEvents/remoteBackedContainerState\";\n\ninterface LocalContainerRefreshHost {\n  updateSnapshot: () => void;\n}\n\nexport interface LocalContainerRefreshState {\n  containersById: Map<string, ContainerState>;\n  documentStoresNeedPriming: boolean;\n  initialized: boolean;\n  lifecycleGeneration: number;\n  localContainerRefreshGeneration: number | null;\n  localContainerRefreshPromise: Promise<void> | null;\n  localContainerRefreshStructuralGeneration: number | null;\n  localContainersNeedRefresh: boolean;\n  persistence: ContainerContentsPersistence;\n  runtime: ContainerContentsWorkflowRuntime;\n  structuralGeneration: number;\n}\n\ninterface LocalContainerRefreshBaseline {\n  container: ContainerState[\"container\"];\n  docVersion: string | null;\n  pullContinuation: ReturnType<typeof currentMetadataPullContinuation>;\n  record: ContainerState[\"record\"];\n}\n\nfunction readMetadataDocVersion(state: ContainerState): string | null {\n  try {\n    return encodeVersionVector(state.doc);\n  } catch {\n    return null;\n  }\n}\n\nfunction captureLocalContainerRefreshBaselines(\n  states: ReadonlyMap<string, ContainerState>,\n): ReadonlyMap<string, LocalContainerRefreshBaseline> {\n  return new Map(\n    Array.from(states, ([containerId, state]) => [\n      containerId,\n      {\n        container: state.container,\n        docVersion: readMetadataDocVersion(state),\n        pullContinuation: currentMetadataPullContinuation(state),\n        record: state.record,\n      },\n    ]),\n  );\n}\n\nfunction liveContainerStateChangedAfterRefreshStarted(\n  state: ContainerState,\n  baseline: LocalContainerRefreshBaseline | undefined,\n): boolean {\n  // No baseline means this live state was inserted after the refresh began.\n  // The loaded snapshot cannot authoritatively replace a state that did not\n  // exist when its query started.\n  return (\n    baseline === undefined ||\n    state.container !== baseline.container ||\n    state.record !== baseline.record ||\n    currentMetadataPullContinuation(state) !== baseline.pullContinuation ||\n    readMetadataDocVersion(state) !== baseline.docVersion\n  );\n}\n\nfunction mergeLocalContainerStates(input: {\n  containerMutationGenerations: ReadonlyMap<string, number>;\n  liveStateBaselines: ReadonlyMap<string, LocalContainerRefreshBaseline>;\n  localContainerStates: ReadonlyArray<ContainerState>;\n  remoteContainerIdsAtLoadStart: ReadonlySet<string>;\n  state: LocalContainerRefreshState;\n}): void {\n  for (const localContainerState of input.localContainerStates) {\n    const containerId = localContainerState.container.id;\n    if (\n      containerStateMutatedAfter(\n        input.state.containersById,\n        containerId,\n        input.containerMutationGenerations,\n      )\n    ) {\n      continue;\n    }\n    const existingState = input.state.containersById.get(containerId);\n    if (existingState) {\n      if (\n        liveContainerStateChangedAfterRefreshStarted(\n          existingState,\n          input.liveStateBaselines.get(containerId),\n        )\n      ) {\n        continue;\n      }\n      // The load can start before a remote create and finish after it. Its\n      // local-only snapshot must not erase the remote identity that the create\n      // persisted in the meantime, or the pending create intent is re-queued.\n      if (\n        !input.remoteContainerIdsAtLoadStart.has(containerId) &&\n        existingState.record.documentId &&\n        !localContainerState.record.documentId\n      ) {\n        continue;\n      }\n      existingState.container = localContainerState.container;\n      existingState.doc = localContainerState.doc;\n      installContainerMetadataRecord(existingState, localContainerState.record);\n    } else if (!input.liveStateBaselines.has(containerId)) {\n      // A baseline without a live entry means the state was removed while the\n      // load was pending. Do not resurrect that stale snapshot.\n      input.state.containersById.set(containerId, localContainerState);\n    }\n  }\n}\n\nfunction isRemoteBackedRootState(containerState: ContainerState): boolean {\n  return (\n    containerState.container.parentId === null &&\n    isRemoteBackedContainerState(containerState)\n  );\n}\n\nasync function reconcileLocalsLoadedAfterRemoteState(\n  state: LocalContainerRefreshState,\n  isCurrent: () => boolean,\n): Promise<void> {\n  const remoteRootStates = Array.from(state.containersById.values()).filter(\n    isRemoteBackedRootState,\n  );\n  for (const remoteRootState of remoteRootStates) {\n    if (!isCurrent()) {\n      return;\n    }\n    await reconcileLocalOnlyRootContainers({\n      isCurrent,\n      remoteRootState,\n      state,\n    });\n  }\n}\n\n/**\n * Hand the tree-rebuild failure to host diagnostics as a real `Error`: the\n * unguarded metadata import inside `loadLocalContainerStates` lands corrupt\n * persisted state here, which the string-only log line cannot carry. That line\n * is the fallback for a host without `logError`, so there is no second copy.\n */\nfunction reportLocalContainerRefreshFailure(\n  util: ContainerContentsWorkflowRuntime[\"util\"],\n  error: unknown,\n): void {\n  // Losing the database mid-flight is the teardown outcome the re-armed refresh\n  // already covers, not a defect.\n  if (!util.logError || isDatabaseUnavailableError(error)) return;\n  try {\n    // Callers run `void refreshLocalContainers()`, so a host logger that throws\n    // or rejects must not escape as an unhandled rejection carrying app frames.\n    void Promise.resolve(\n      util.logError(\n        \"Container contents: local container refresh failed\",\n        error,\n      ),\n    ).catch(() => undefined);\n  } catch {\n    // Hosts may throw synchronously or return a rejected promise.\n  }\n}\n\nexport function refreshLocalContainerStates(input: {\n  host: LocalContainerRefreshHost;\n  state: LocalContainerRefreshState;\n}): Promise<void> {\n  const { host, state } = input;\n  if (state.localContainerRefreshPromise) {\n    const activeRefresh = state.localContainerRefreshPromise;\n    if (\n      state.localContainerRefreshGeneration === state.lifecycleGeneration &&\n      state.localContainerRefreshStructuralGeneration ===\n        state.structuralGeneration\n    ) {\n      return activeRefresh;\n    }\n    // A stale refresh owns its replacement retry in `finally`, so callers can\n    // share that promise without scheduling a second replacement load.\n    return activeRefresh;\n  }\n\n  if (\n    !state.localContainersNeedRefresh ||\n    !state.initialized ||\n    state.runtime.infra.dbStatus !== \"ready\"\n  ) {\n    return Promise.resolve();\n  }\n\n  const lifecycleGeneration = state.lifecycleGeneration;\n  const structuralGeneration = state.structuralGeneration;\n  const isCurrent = () =>\n    state.lifecycleGeneration === lifecycleGeneration &&\n    state.structuralGeneration === structuralGeneration;\n  state.localContainersNeedRefresh = false;\n  const liveStateBaselines = captureLocalContainerRefreshBaselines(\n    state.containersById,\n  );\n  const containerMutationGenerations = captureContainerStateMutationGenerations(\n    state.containersById,\n  );\n  const remoteContainerIdsAtLoadStart = new Set<string>();\n  for (const containerState of state.containersById.values()) {\n    if (containerState.record.documentId) {\n      remoteContainerIdsAtLoadStart.add(containerState.container.id);\n    }\n  }\n  state.localContainerRefreshGeneration = lifecycleGeneration;\n  state.localContainerRefreshStructuralGeneration = structuralGeneration;\n  const refreshPromise = loadLocalContainerStates({\n    persistence: state.persistence,\n    runtime: state.runtime,\n  })\n    .then(async (localContainerStates) => {\n      if (!isCurrent()) {\n        return;\n      }\n      mergeLocalContainerStates({\n        containerMutationGenerations,\n        liveStateBaselines,\n        localContainerStates,\n        remoteContainerIdsAtLoadStart,\n        state,\n      });\n      // Remote hydration can win the startup race and ingest the server root\n      // before this local read returns. Re-run root/system convergence after\n      // merging so that the late local bootstrap rows cannot reintroduce a\n      // stale root and same-slot system children into the live tree.\n      await reconcileLocalsLoadedAfterRemoteState(state, isCurrent);\n      if (!isCurrent()) {\n        return;\n      }\n      state.documentStoresNeedPriming = true;\n      host.updateSnapshot();\n    })\n    .catch((error: unknown) => {\n      if (!isCurrent()) {\n        return;\n      }\n      state.localContainersNeedRefresh = true;\n      state.runtime.util.log(\n        `Failed to refresh local container states: ${errorMessage(error)}`,\n      );\n      reportLocalContainerRefreshFailure(state.runtime.util, error);\n    })\n    .finally(() => {\n      const shouldRetryAfterReplacement = !isCurrent();\n      if (state.localContainerRefreshPromise === refreshPromise) {\n        state.localContainerRefreshPromise = null;\n        state.localContainerRefreshGeneration = null;\n        state.localContainerRefreshStructuralGeneration = null;\n      }\n      if (shouldRetryAfterReplacement) {\n        state.localContainersNeedRefresh = true;\n        return refreshLocalContainerStates(input);\n      }\n      return undefined;\n    });\n  state.localContainerRefreshPromise = refreshPromise;\n\n  return refreshPromise;\n}\n"]}

package/stores/container-contents/operations/containerPurgeCore.js

@@ -0,0 +1,98 @@
+import { purgeContainerTree } from "../../../workflows/container-contents/container-state/purge/purgeTree.js";
+import { prepareContainerDocumentRotationSnapshot } from "../documentWork/documentRotation.js";
+import { getContainerContentsStoreLogLabel } from "../logLabel.js";
+import { updateContainerContentsSnapshot } from "../state.js";
+/** @internal Reconciles any completed destructive prefix after expiry. */
+export async function refreshAfterStalePurge(input) {
+    const remoteParentIds = new Set();
+    for (const remoteDeletedContainerId of input.remoteDeletedContainerIds) {
+        const purgedState = input.containerStatesAtStart.get(remoteDeletedContainerId);
+        if (purgedState?.record.documentId) {
+            remoteParentIds.add(purgedState.container.parentId);
+        }
+    }
+    input.state.localContainersNeedRefresh = true;
+    await input.syncAgent.refreshLocalContainers();
+    let removedState = false;
+    for (const purgedContainerId of input.purgedContainerIds) {
+        const deletedState = input.containerStatesAtStart.get(purgedContainerId);
+        if (deletedState &&
+            input.state.containersById.get(purgedContainerId) === deletedState) {
+            input.state.containersById.delete(purgedContainerId);
+            removedState = true;
+        }
+    }
+    input.state.documentStoresNeedPriming = true;
+    if (removedState && input.state.initialized) {
+        updateContainerContentsSnapshot(input.state);
+    }
+    if (remoteParentIds.size > 0) {
+        await input.syncAgent.requestRemoteHydration({
+            followDiscoveredParentLanes: false,
+            parentIds: [...remoteParentIds],
+            resetAllLaneWatermarks: true,
+        });
+    }
+}
+// Shared core of the two recursive purge operations (purgeContainer and
+// emptyTrash): guard readiness and the remote-authority gate, run the
+// recursive purge engine, drop the purged containers from the tree, and log
+// the outcome. The operations differ only in target validation, whether the
+// root container itself survives, and how the result is described/judged.
+export async function runContainerPurge(state, syncAgent, containerId, options, isCurrent, operation) {
+    if (state.runtime.infra.dbStatus !== "ready" || !state.snapshot.ready) {
+        return false;
+    }
+    const targetState = state.containersById.get(containerId);
+    if (!targetState || !operation.validateTarget(targetState)) {
+        return false;
+    }
+    // Any remote container or document in the subtree needs the server, so require
+    // auth + online when the target itself is remote (a local-only subtree can be
+    // torn down offline, matching deleteContainer's gate).
+    const isRemoteContainer = Boolean(targetState.record.documentId);
+    if (isRemoteContainer &&
+        (!state.runtime.auth.isAuthenticated || !state.runtime.state.online)) {
+        return false;
+    }
+    const containerStatesAtStart = new Map(state.containersById);
+    const result = await purgeContainerTree({
+        containersById: state.containersById,
+        keepRootContainer: operation.keepRootContainer ?? false,
+        onProgress: options?.onProgress,
+        persistence: state.persistence,
+        prepareDocumentRotationSnapshot: (document) => prepareContainerDocumentRotationSnapshot(state.runtime, document),
+        resolveProjectionUserKey: state.resolveProjectionUserKey,
+        rootContainerId: containerId,
+        runtime: state.runtime,
+        signal: options?.signal,
+        stillCurrent: isCurrent,
+    });
+    if (!result) {
+        return false;
+    }
+    const purgedContainerIds = new Set(result.purgedContainerIds);
+    const hasUnsettledRemoteDelete = result.remoteDeletedContainerIds.some((containerId) => !purgedContainerIds.has(containerId));
+    if (!isCurrent() || hasUnsettledRemoteDelete) {
+        await refreshAfterStalePurge({
+            completedCount: result.completedCount,
+            containerStatesAtStart,
+            purgedContainerIds: result.purgedContainerIds,
+            remoteDeletedContainerIds: result.remoteDeletedContainerIds,
+            state,
+            syncAgent,
+        });
+        return false;
+    }
+    for (const purgedContainerId of result.purgedContainerIds) {
+        state.containersById.delete(purgedContainerId);
+    }
+    // Only re-render when something actually left the tree; a fully-failed or
+    // immediately-cancelled run changed nothing.
+    if (result.purgedContainerIds.length > 0) {
+        updateContainerContentsSnapshot(state);
+    }
+    state.runtime.util.log(`${getContainerContentsStoreLogLabel(state)}: ${operation.describeResult(targetState, result)}`);
+    return operation.didSucceed(result);
+}
+//# sourceMappingURL=containerPurgeCore.js.map

package/stores/container-contents/operations/containerPurgeCore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerPurgeCore.js","sourceRoot":"","sources":["containerPurgeCore.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PurgeOptions } from \"../../../workflows/container-contents/container-state/purge/purgeProgress\";\nimport { purgeContainerTree } from \"../../../workflows/container-contents/container-state/purge/purgeTree\";\nimport { prepareContainerDocumentRotationSnapshot } from \"../documentWork/documentRotation\";\nimport { getContainerContentsStoreLogLabel } from \"../logLabel\";\nimport type { ContainerWriteGuard } from \"../remoteWrites/writeGeneration\";\nimport { updateContainerContentsSnapshot } from \"../state\";\nimport type {\n  ContainerContentsStoreSyncAgent,\n  ContainerState,\n} from \"../syncAgent\";\nimport type { ContainerContentsStoreState } from \"../types\";\n\ntype ContainerPurgeResult = NonNullable<\n  Awaited<ReturnType<typeof purgeContainerTree>>\n>;\n\n/** @internal Reconciles any completed destructive prefix after expiry. */\nexport async function refreshAfterStalePurge(input: {\n  completedCount: number;\n  containerStatesAtStart: ReadonlyMap<string, ContainerState>;\n  purgedContainerIds: readonly string[];\n  remoteDeletedContainerIds: readonly string[];\n  state: ContainerContentsStoreState;\n  syncAgent: ContainerContentsStoreSyncAgent;\n}): Promise<void> {\n  const remoteParentIds = new Set<string | null>();\n  for (const remoteDeletedContainerId of input.remoteDeletedContainerIds) {\n    const purgedState = input.containerStatesAtStart.get(\n      remoteDeletedContainerId,\n    );\n    if (purgedState?.record.documentId) {\n      remoteParentIds.add(purgedState.container.parentId);\n    }\n  }\n\n  input.state.localContainersNeedRefresh = true;\n  await input.syncAgent.refreshLocalContainers();\n  let removedState = false;\n  for (const purgedContainerId of input.purgedContainerIds) {\n    const deletedState = input.containerStatesAtStart.get(purgedContainerId);\n    if (\n      deletedState &&\n      input.state.containersById.get(purgedContainerId) === deletedState\n    ) {\n      input.state.containersById.delete(purgedContainerId);\n      removedState = true;\n    }\n  }\n  input.state.documentStoresNeedPriming = true;\n  if (removedState && input.state.initialized) {\n    updateContainerContentsSnapshot(input.state);\n  }\n  if (remoteParentIds.size > 0) {\n    await input.syncAgent.requestRemoteHydration({\n      followDiscoveredParentLanes: false,\n      parentIds: [...remoteParentIds],\n      resetAllLaneWatermarks: true,\n    });\n  }\n}\n\n// Shared core of the two recursive purge operations (purgeContainer and\n// emptyTrash): guard readiness and the remote-authority gate, run the\n// recursive purge engine, drop the purged containers from the tree, and log\n// the outcome. The operations differ only in target validation, whether the\n// root container itself survives, and how the result is described/judged.\nexport async function runContainerPurge(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n  containerId: string,\n  options: PurgeOptions | undefined,\n  isCurrent: ContainerWriteGuard,\n  operation: {\n    describeResult: (\n      target: ContainerState,\n      result: ContainerPurgeResult,\n    ) => string;\n    didSucceed: (result: ContainerPurgeResult) => boolean;\n    keepRootContainer?: boolean | undefined;\n    validateTarget: (target: ContainerState) => boolean;\n  },\n): Promise<boolean> {\n  if (state.runtime.infra.dbStatus !== \"ready\" || !state.snapshot.ready) {\n    return false;\n  }\n\n  const targetState = state.containersById.get(containerId);\n  if (!targetState || !operation.validateTarget(targetState)) {\n    return false;\n  }\n\n  // Any remote container or document in the subtree needs the server, so require\n  // auth + online when the target itself is remote (a local-only subtree can be\n  // torn down offline, matching deleteContainer's gate).\n  const isRemoteContainer = Boolean(targetState.record.documentId);\n  if (\n    isRemoteContainer &&\n    (!state.runtime.auth.isAuthenticated || !state.runtime.state.online)\n  ) {\n    return false;\n  }\n  const containerStatesAtStart = new Map(state.containersById);\n\n  const result = await purgeContainerTree({\n    containersById: state.containersById,\n    keepRootContainer: operation.keepRootContainer ?? false,\n    onProgress: options?.onProgress,\n    persistence: state.persistence,\n    prepareDocumentRotationSnapshot: (document) =>\n      prepareContainerDocumentRotationSnapshot(state.runtime, document),\n    resolveProjectionUserKey: state.resolveProjectionUserKey,\n    rootContainerId: containerId,\n    runtime: state.runtime,\n    signal: options?.signal,\n    stillCurrent: isCurrent,\n  });\n  if (!result) {\n    return false;\n  }\n  const purgedContainerIds = new Set(result.purgedContainerIds);\n  const hasUnsettledRemoteDelete = result.remoteDeletedContainerIds.some(\n    (containerId) => !purgedContainerIds.has(containerId),\n  );\n  if (!isCurrent() || hasUnsettledRemoteDelete) {\n    await refreshAfterStalePurge({\n      completedCount: result.completedCount,\n      containerStatesAtStart,\n      purgedContainerIds: result.purgedContainerIds,\n      remoteDeletedContainerIds: result.remoteDeletedContainerIds,\n      state,\n      syncAgent,\n    });\n    return false;\n  }\n\n  for (const purgedContainerId of result.purgedContainerIds) {\n    state.containersById.delete(purgedContainerId);\n  }\n  // Only re-render when something actually left the tree; a fully-failed or\n  // immediately-cancelled run changed nothing.\n  if (result.purgedContainerIds.length > 0) {\n    updateContainerContentsSnapshot(state);\n  }\n  state.runtime.util.log(\n    `${getContainerContentsStoreLogLabel(state)}: ${operation.describeResult(targetState, result)}`,\n  );\n  return operation.didSucceed(result);\n}\n"]}

package/stores/container-contents/operations/emptyTrashOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emptyTrashOperation.js","sourceRoot":"","sources":["emptyTrashOperation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,kFAAkF;AAClF,iFAAiF;AACjF,gFAAgF;AAChF,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAkC,EAClC,SAA0C,EAC1C,gBAAwB,EACxB,OAAsB,EACtB,YAAiC,GAAG,EAAE,CAAC,IAAI;IAE3C,OAAO,iBAAiB,CACtB,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT;QACE,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAClC,kBAAkB,MAAM,CAAC,kBAAkB,CAAC,MAAM,0BAA0B,MAAM,CAAC,WAAW,UAAU;QAC1G,0DAA0D;QAC1D,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,WAAW,KAAK,CAAC;QACnE,iBAAiB,EAAE,IAAI;QACvB,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CACzB,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,IAAI;KACjD,CACF,CAAC;AACJ,CAAC","sourcesContent":["import type { PurgeOptions } from \"../../../workflows/container-contents/container-state/purge/purgeProgress\";\nimport type { ContainerWriteGuard } from \"../remoteWrites/writeGeneration\";\nimport type { ContainerContentsStoreSyncAgent } from \"../syncAgent\";\nimport type { ContainerContentsStoreState } from \"../types\";\nimport { runContainerPurge } from \"./containerPurgeCore\";\n\n// Permanently destroy EVERYTHING under the Trash bin — every trashed folder's\n// whole subtree and every document deleted straight into Trash — while leaving\n// the Trash system container itself in place. This is \"Empty Trash\": it reuses\n// the recursive purge engine with keepRootContainer so the bin survives, and it\n// inherits that engine's semantics — documents also linked outside Trash are\n// unlinked (not destroyed), containers are torn down leaf-first, a failed item is\n// skipped rather than aborting the sweep, and an optional signal cancels between\n// items. The target must be a real system container (the Trash bin); like every\n// purge it is online-only when any of its contents are remote.\nexport async function emptyTrash(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n  trashContainerId: string,\n  options?: PurgeOptions,\n  isCurrent: ContainerWriteGuard = () => true,\n): Promise<boolean> {\n  return runContainerPurge(\n    state,\n    syncAgent,\n    trashContainerId,\n    options,\n    isCurrent,\n    {\n      describeResult: (_target, result) =>\n        `emptied trash (${result.purgedContainerIds.length} container(s) removed, ${result.failedCount} failed)`,\n      // A clean empty: nothing failed and it ran to completion.\n      didSucceed: (result) => !result.aborted && result.failedCount === 0,\n      keepRootContainer: true,\n      validateTarget: (target) =>\n        (target.container.systemSlot ?? null) !== null,\n    },\n  );\n}\n"]}

package/stores/container-contents/operations/groupRewrapOperation.js

@@ -0,0 +1,52 @@
+import { prepareContainerStateGroupRewrap } from "../../../workflows/container-contents/container-state/share/index.js";
+import { containerStateHasCurrentGroupGrant } from "../../../workflows/container-contents/container-state/share/groupGrantVerification.js";
+export async function prepareContainerGroupRewrap(state, containerId, groupId, accessLevel, options, isCurrent = () => true) {
+    if (state.runtime.infra.dbStatus !== "ready" ||
+        !state.snapshot.ready ||
+        !state.runtime.auth.isAuthenticated ||
+        !state.runtime.state.online) {
+        return null;
+    }
+    const containerState = state.containersById.get(containerId);
+    if (!containerState) {
+        return null;
+    }
+    const preparation = await prepareContainerStateGroupRewrap({
+        accessLevel,
+        containerState,
+        groupId,
+        requireExistingGrant: options?.requireExistingGrant,
+        resolveProjectionUserKey: state.resolveProjectionUserKey,
+        runtime: state.runtime,
+        stillCurrent: isCurrent,
+    });
+    return isCurrent() ? preparation : null;
+}
+export async function verifyContainerGroupRewrapCurrent(state, containerId, groupId, accessLevel, expectedGroupHead, expectedContainerId, expectedOrganizationId, isCurrent = () => true) {
+    if (state.runtime.infra.dbStatus !== "ready" ||
+        !state.snapshot.ready ||
+        !state.runtime.auth.isAuthenticated ||
+        !state.runtime.state.online) {
+        return false;
+    }
+    if (containerId !== expectedContainerId) {
+        return false;
+    }
+    const containerState = state.containersById.get(expectedContainerId);
+    if (!containerState) {
+        return false;
+    }
+    const current = await containerStateHasCurrentGroupGrant({
+        accessLevel,
+        containerState,
+        expectedContainerId,
+        expectedGroupHead,
+        expectedOrganizationId,
+        groupId,
+        resolveProjectionUserKey: state.resolveProjectionUserKey,
+        runtime: state.runtime,
+        stillCurrent: isCurrent,
+    });
+    return isCurrent() && current;
+}
+//# sourceMappingURL=groupRewrapOperation.js.map

package/stores/container-contents/operations/groupRewrapOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupRewrapOperation.js","sourceRoot":"","sources":["groupRewrapOperation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gCAAgC,EAAE,MAAM,6DAA6D,CAAC;AAC/G,OAAO,EAAE,kCAAkC,EAAE,MAAM,oFAAoF,CAAC;AAOxI,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,KAAkC,EAClC,WAAmB,EACnB,OAAe,EACf,WAA8C,EAC9C,OAAwD,EACxD,YAAiC,GAAG,EAAE,CAAC,IAAI;IAE3C,IACE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO;QACxC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK;QACrB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe;QACnC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAC3B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,gCAAgC,CAAC;QACzD,WAAW;QACX,cAAc;QACd,OAAO;QACP,oBAAoB,EAAE,OAAO,EAAE,oBAAoB;QACnD,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;QACxD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,SAAS;KACxB,CAAC,CAAC;IACH,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,KAAkC,EAClC,WAAmB,EACnB,OAAe,EACf,WAA8C,EAC9C,iBAA0C,EAC1C,mBAA2B,EAC3B,sBAA8B,EAC9B,YAAiC,GAAG,EAAE,CAAC,IAAI;IAE3C,IACE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO;QACxC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK;QACrB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe;QACnC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,WAAW,KAAK,mBAAmB,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACrE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,kCAAkC,CAAC;QACvD,WAAW;QACX,cAAc;QACd,mBAAmB;QACnB,iBAAiB;QACjB,sBAAsB;QACtB,OAAO;QACP,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;QACxD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,SAAS;KACxB,CAAC,CAAC;IACH,OAAO,SAAS,EAAE,IAAI,OAAO,CAAC;AAChC,CAAC","sourcesContent":["import type { ReferencedPrincipalHead } from \"@tearleads/crypto\";\nimport { prepareContainerStateGroupRewrap } from \"../../../workflows/container-contents/container-state/share\";\nimport { containerStateHasCurrentGroupGrant } from \"../../../workflows/container-contents/container-state/share/groupGrantVerification\";\nimport type { ContainerWriteGuard } from \"../remoteWrites/writeGeneration\";\nimport type {\n  ContainerContentsShareAccessLevel,\n  ContainerContentsStoreState,\n} from \"../types\";\n\nexport async function prepareContainerGroupRewrap(\n  state: ContainerContentsStoreState,\n  containerId: string,\n  groupId: string,\n  accessLevel: ContainerContentsShareAccessLevel,\n  options?: { requireExistingGrant?: boolean } | undefined,\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  ) {\n    return null;\n  }\n  const containerState = state.containersById.get(containerId);\n  if (!containerState) {\n    return null;\n  }\n\n  const preparation = await prepareContainerStateGroupRewrap({\n    accessLevel,\n    containerState,\n    groupId,\n    requireExistingGrant: options?.requireExistingGrant,\n    resolveProjectionUserKey: state.resolveProjectionUserKey,\n    runtime: state.runtime,\n    stillCurrent: isCurrent,\n  });\n  return isCurrent() ? preparation : null;\n}\n\nexport async function verifyContainerGroupRewrapCurrent(\n  state: ContainerContentsStoreState,\n  containerId: string,\n  groupId: string,\n  accessLevel: ContainerContentsShareAccessLevel,\n  expectedGroupHead: ReferencedPrincipalHead,\n  expectedContainerId: string,\n  expectedOrganizationId: string,\n  isCurrent: ContainerWriteGuard = () => true,\n): Promise<boolean> {\n  if (\n    state.runtime.infra.dbStatus !== \"ready\" ||\n    !state.snapshot.ready ||\n    !state.runtime.auth.isAuthenticated ||\n    !state.runtime.state.online\n  ) {\n    return false;\n  }\n  if (containerId !== expectedContainerId) {\n    return false;\n  }\n  const containerState = state.containersById.get(expectedContainerId);\n  if (!containerState) {\n    return false;\n  }\n\n  const current = await containerStateHasCurrentGroupGrant({\n    accessLevel,\n    containerState,\n    expectedContainerId,\n    expectedGroupHead,\n    expectedOrganizationId,\n    groupId,\n    resolveProjectionUserKey: state.resolveProjectionUserKey,\n    runtime: state.runtime,\n    stillCurrent: isCurrent,\n  });\n  return isCurrent() && current;\n}\n"]}