@tearleads/client-sdk 0.1.63 → 0.1.64

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

@@ -1 +1 @@
-{"version":3,"file":"containerContentsStore.js","sourceRoot":"","sources":["containerContentsStore.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DomainScope } from \"../../data/shared/domainScope\";\nimport { getCachedContainerWriterProjection } from \"../../workflows/container-contents/container-state/projectionCache\";\nimport {\n  type ContainerContentsPersistence,\n  defaultContainerContentsPersistence,\n} from \"../../workflows/container-contents/containerPersistence\";\nimport { persistContainerState } from \"./containerStatePersistence\";\nimport { emptyTrash } from \"./emptyTrashOperation\";\nimport {\n  prepareContainerGroupRewrap,\n  verifyContainerGroupRewrapCurrent,\n} from \"./groupRewrapOperation\";\nimport {\n  createChildContainer,\n  deleteContainer,\n  ensureSystemContainer,\n  moveContainer,\n  renameContainer,\n} from \"./operations\";\nimport { purgeContainer } from \"./purgeContainerOperation\";\nimport { invalidateRemoteContainerWrites } from \"./remoteWriteGuards\";\nimport { chainRemoteContainerTask } from \"./remoteWriteQueue\";\nimport { setContainerIcon } from \"./setContainerIconOperation\";\nimport {\n  shareContainerWithGroup,\n  shareContainerWithUser,\n} from \"./shareOperations\";\nimport {\n  createContainerContentsStoreState,\n  subscribeToContainerContentsStore,\n  updateContainerContentsSnapshot,\n  updateContainerContentsStorePersistence,\n  updateContainerContentsStoreRuntime,\n} from \"./state\";\nimport {\n  type ContainerContentsStoreRuntime,\n  type ContainerContentsStoreSyncAgent,\n  createContainerContentsStoreSyncAgent,\n} from \"./syncAgent\";\nimport { findRootContainerState } from \"./systemContainerLookup\";\nimport type {\n  ContainerContentsStore,\n  ContainerContentsStoreOptions,\n  ContainerContentsStoreState,\n} from \"./types\";\nimport { captureContainerWriteGeneration } from \"./writeGeneration\";\n\nconst containerContentsStoresByScope = new WeakMap<\n  DomainScope,\n  ContainerContentsStoreEntry\n>();\n\ninterface ContainerContentsStoreEntry {\n  requestDocumentPriming: () => void;\n  store: ContainerContentsStore;\n  updateOptions: (options: ContainerContentsStoreOptions) => void;\n}\n\nfunction applyContainerContentsStoreOptions(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n  options: ContainerContentsStoreOptions,\n): void {\n  if (\"logLabel\" in options) {\n    state.logLabel = options.logLabel;\n  }\n\n  if (\"persistence\" in options) {\n    updateContainerContentsStorePersistence(\n      state,\n      options.persistence ?? defaultContainerContentsPersistence,\n      syncAgent,\n    );\n  }\n}\n\nfunction getCachedContainerWriterProjectionForStore(\n  state: ContainerContentsStoreState,\n  containerId: string,\n) {\n  const containerState = state.containersById.get(containerId);\n  return containerState\n    ? getCachedContainerWriterProjection(containerState)\n    : null;\n}\n\nfunction createContainerContentsStoreSyncHost(\n  state: ContainerContentsStoreState,\n): Parameters<typeof createContainerContentsStoreSyncAgent>[0][\"host\"] {\n  return {\n    persistContainerState: (\n      containerState,\n      patch,\n      updateView,\n      saveOptions,\n      mutationOptions,\n    ) =>\n      persistContainerState(state, containerState, {\n        patch,\n        updateView,\n        saveOptions,\n        ...mutationOptions,\n      }),\n    requestDocumentPriming: () => {\n      state.documentStoresNeedPriming = true;\n    },\n    updateSnapshot: () => updateContainerContentsSnapshot(state),\n  };\n}\n\n// null marks an unknown mutation scope; [] delegates invalidation to actual writes.\nfunction chainContainerWrite(\n  state: ContainerContentsStoreState,\n  work: (isCurrent: () => boolean) => ContainerContentsStoreState[\"writeChain\"],\n  changedIds: readonly string[] | null = null,\n  movedId?: string,\n): ContainerContentsStoreState[\"writeChain\"] {\n  const isCurrent = captureContainerWriteGeneration(state);\n  invalidateRemoteContainerWrites(state, changedIds, movedId);\n  state.writeChain = state.writeChain\n    .catch(() => null)\n    .then(() => {\n      if (!isCurrent()) return null;\n      invalidateRemoteContainerWrites(state, changedIds, movedId);\n      return work(isCurrent);\n    })\n    .then((node) => (isCurrent() ? node : null));\n  return state.writeChain;\n}\n\ntype ContainerWriteMethods = Pick<\n  ContainerContentsStore,\n  | \"createChild\"\n  | \"deleteContainer\"\n  | \"emptyTrash\"\n  | \"ensureSystemContainer\"\n  | \"moveContainer\"\n  | \"prepareGroupRewrap\"\n  | \"purgeContainer\"\n  | \"renameContainer\"\n  | \"setContainerIcon\"\n  | \"shareWithGroup\"\n  | \"shareWithUser\"\n>;\n\n// The group-rewrap builder verifies any required existing grant before capturing\n// the container KEK, then returns a check/rewrap pair. A verified non-match is\n// distinct from an unavailable preparation so security-critical callers can\n// no-op unrelated groups without failing open for a real grant.\nfunction createPrepareGroupRewrapMethod(\n  state: ContainerContentsStoreState,\n  syncAgent: ReturnType<typeof createContainerContentsStoreSyncAgent>,\n): ContainerContentsStore[\"prepareGroupRewrap\"] {\n  return async (containerId, groupId, accessLevel, options) => {\n    const preparation = await chainRemoteContainerTask(\n      state,\n      syncAgent,\n      null,\n      (isCurrent) =>\n        prepareContainerGroupRewrap(\n          state,\n          containerId,\n          groupId,\n          accessLevel,\n          options,\n          isCurrent,\n        ),\n      containerId,\n    );\n    return preparation?.status === \"prepared\"\n      ? {\n          isCurrent: (\n            expectedGroupHead,\n            expectedContainerId,\n            expectedOrganizationId,\n          ) =>\n            chainRemoteContainerTask(\n              state,\n              syncAgent,\n              false,\n              (isCurrent) =>\n                verifyContainerGroupRewrapCurrent(\n                  state,\n                  containerId,\n                  groupId,\n                  accessLevel,\n                  expectedGroupHead,\n                  expectedContainerId,\n                  expectedOrganizationId,\n                  isCurrent,\n                ),\n              containerId,\n            ),\n          rewrap: () =>\n            chainRemoteContainerTask(\n              state,\n              syncAgent,\n              false,\n              (isCurrent) =>\n                shareContainerWithGroup(\n                  state,\n                  syncAgent,\n                  containerId,\n                  groupId,\n                  accessLevel,\n                  {\n                    ...options,\n                    knownContainerKeks: preparation.knownContainerKeks,\n                    // A prepared re-wrap is grant-preserving by definition, so\n                    // it never mints a grant and never needs the chosen name.\n                    requireExistingGrant: true,\n                  },\n                  isCurrent,\n                ),\n              containerId,\n              { preserveResultOnLocalWrite: true },\n            ),\n          status: \"prepared\" as const,\n        }\n      : (preparation ?? null);\n  };\n}\n\nfunction createContainerSharingMethods(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n): Pick<ContainerWriteMethods, \"shareWithUser\" | \"shareWithGroup\"> {\n  return {\n    shareWithUser: (containerId, userId) =>\n      chainRemoteContainerTask(\n        state,\n        syncAgent,\n        false,\n        (isCurrent) =>\n          shareContainerWithUser(\n            state,\n            syncAgent,\n            containerId,\n            userId,\n            isCurrent,\n          ),\n        containerId,\n        { preserveResultOnLocalWrite: true },\n      ),\n    shareWithGroup: (containerId, groupId, accessLevel, options) =>\n      chainRemoteContainerTask(\n        state,\n        syncAgent,\n        false,\n        (isCurrent) =>\n          shareContainerWithGroup(\n            state,\n            syncAgent,\n            containerId,\n            groupId,\n            accessLevel,\n            options,\n            isCurrent,\n          ),\n        containerId,\n        { preserveResultOnLocalWrite: true },\n      ),\n  };\n}\n\nfunction createDeleteContainerMethod(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n): ContainerContentsStore[\"deleteContainer\"] {\n  return (containerId) => {\n    const current = captureContainerWriteGeneration(state);\n    const remoteDelete = () =>\n      chainRemoteContainerTask(\n        state,\n        syncAgent,\n        null,\n        (isCurrent) =>\n          deleteContainer(state, syncAgent, containerId, isCurrent),\n        containerId,\n      ).then((node) => node !== null);\n    if (state.containersById.get(containerId)?.record.documentId)\n      return remoteDelete();\n    let promoted = false;\n    return chainContainerWrite(\n      state,\n      (isCurrent) => {\n        // Promotion can win while this local operation was queued. Hand it to\n        // the remote queue after releasing the local chain, before any HTTP I/O.\n        promoted = Boolean(\n          state.containersById.get(containerId)?.record.documentId,\n        );\n        return promoted\n          ? Promise.resolve(null)\n          : deleteContainer(state, syncAgent, containerId, isCurrent);\n      },\n      [containerId],\n    ).then((node) => (promoted && current() ? remoteDelete() : node !== null));\n  };\n}\n\nfunction createEnsureSystemContainerMethod(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n): ContainerContentsStore[\"ensureSystemContainer\"] {\n  return (systemSlot, name, options) => {\n    const work = (isCurrent: () => boolean) =>\n      ensureSystemContainer(\n        state,\n        syncAgent,\n        systemSlot,\n        name,\n        options,\n        isCurrent,\n      );\n    const rootId = findRootContainerState(state)?.container.id;\n    return options?.deferRemoteBootstrap\n      ? chainContainerWrite(state, work, [])\n      : chainRemoteContainerTask(\n          state,\n          syncAgent,\n          null,\n          work,\n          rootId ? { rootId, systemSlot } : undefined,\n        );\n  };\n}\n\nexport function createContainerWriteMethods(\n  state: ContainerContentsStoreState,\n  syncAgent: ReturnType<typeof createContainerContentsStoreSyncAgent>,\n): ContainerWriteMethods {\n  return {\n    ...createContainerSharingMethods(state, syncAgent),\n    createChild: (parentId, name) =>\n      chainContainerWrite(\n        state,\n        (isCurrent) =>\n          createChildContainer(state, syncAgent, parentId, name, isCurrent),\n        [parentId],\n      ),\n    deleteContainer: createDeleteContainerMethod(state, syncAgent),\n    purgeContainer: (containerId, options) =>\n      chainRemoteContainerTask(\n        state,\n        syncAgent,\n        false,\n        (isCurrent) =>\n          purgeContainer(state, syncAgent, containerId, options, isCurrent),\n        containerId,\n      ),\n    emptyTrash: (trashContainerId, options) =>\n      chainRemoteContainerTask(\n        state,\n        syncAgent,\n        false,\n        (isCurrent) =>\n          emptyTrash(state, syncAgent, trashContainerId, options, isCurrent),\n        trashContainerId,\n      ),\n    ensureSystemContainer: createEnsureSystemContainerMethod(state, syncAgent),\n    moveContainer: (containerId, parentId) =>\n      chainContainerWrite(\n        state,\n        (isCurrent) =>\n          moveContainer(state, syncAgent, containerId, parentId, isCurrent),\n        [containerId, parentId],\n        containerId,\n      ),\n    prepareGroupRewrap: createPrepareGroupRewrapMethod(state, syncAgent),\n    renameContainer: (containerId, name) =>\n      chainContainerWrite(\n        state,\n        (isCurrent) =>\n          renameContainer(state, syncAgent, containerId, name, isCurrent),\n        [containerId],\n      ),\n    setContainerIcon: (containerId, icon) =>\n      chainContainerWrite(\n        state,\n        (isCurrent) =>\n          setContainerIcon(state, syncAgent, containerId, icon, isCurrent),\n        [containerId],\n      ),\n  };\n}\n\nfunction createContainerContentsStoreEntry(\n  initialRuntime: ContainerContentsStoreRuntime,\n  persistence: ContainerContentsPersistence = defaultContainerContentsPersistence,\n  options: ContainerContentsStoreOptions = {},\n): ContainerContentsStoreEntry {\n  const state = createContainerContentsStoreState(\n    initialRuntime,\n    options.persistence ?? persistence,\n    options.logLabel,\n  );\n  const syncAgent = createContainerContentsStoreSyncAgent({\n    host: createContainerContentsStoreSyncHost(state),\n    state,\n  });\n  const writeMethods = createContainerWriteMethods(state, syncAgent);\n\n  return {\n    requestDocumentPriming: () => {\n      state.documentStoresNeedPriming = true;\n      syncAgent.scheduleSync();\n    },\n    store: {\n      ...writeMethods,\n      refresh: () => syncAgent.refresh({ resetAllLaneWatermarks: true }),\n      refreshRootLane: (options) => syncAgent.refreshRootLane(options),\n      // Force an on-demand local SQLite re-read (see the interface doc): arm the\n      // gate refreshLocalContainerStates otherwise requires, which the runtime\n      // auto-arms only on a context transition an on-demand caller cannot rely on.\n      refreshLocalContainers: () => {\n        state.localContainersNeedRefresh = true;\n        return syncAgent.refreshLocalContainers();\n      },\n      requestSync: () => syncAgent.scheduleSync(),\n      getCachedContainerWriterProjection: (containerId) =>\n        getCachedContainerWriterProjectionForStore(state, containerId),\n      getSnapshot: () => state.snapshot,\n      subscribe: (listener) =>\n        subscribeToContainerContentsStore(state, listener),\n      updateRuntime: (runtime) =>\n        updateContainerContentsStoreRuntime(state, runtime, syncAgent),\n    },\n    updateOptions: (nextOptions) =>\n      applyContainerContentsStoreOptions(state, syncAgent, nextOptions),\n  };\n}\n\nexport function createContainerContentsStore(\n  initialRuntime: ContainerContentsStoreRuntime,\n  persistence: ContainerContentsPersistence = defaultContainerContentsPersistence,\n  options: ContainerContentsStoreOptions = {},\n): ContainerContentsStore {\n  return createContainerContentsStoreEntry(initialRuntime, persistence, options)\n    .store;\n}\n\nexport function getOrCreateContainerContentsStore(\n  domainScope: DomainScope,\n  runtime: ContainerContentsStoreRuntime,\n  options: ContainerContentsStoreOptions = {},\n): ContainerContentsStore {\n  const existingEntry = containerContentsStoresByScope.get(domainScope);\n  if (existingEntry) {\n    existingEntry.updateOptions(options);\n    return existingEntry.store;\n  }\n\n  const nextEntry = createContainerContentsStoreEntry(\n    runtime,\n    defaultContainerContentsPersistence,\n    options,\n  );\n  containerContentsStoresByScope.set(domainScope, nextEntry);\n  return nextEntry.store;\n}\n\n/**\n * Arm the next structural pass's document-priming scan for a domain scope.\n * Priming normally re-arms only on store creation and topology changes, so a\n * caller that just tore down a document's local state uses this to have the\n * still-listed server document re-created without waiting for an app\n * restart. Returns false when the scope has no container-contents store yet;\n * the startup priming pass covers that case.\n */\nexport function requestContainerContentsDocumentPriming(\n  domainScope: DomainScope,\n): boolean {\n  const entry = containerContentsStoresByScope.get(domainScope);\n  if (!entry) {\n    return false;\n  }\n\n  entry.requestDocumentPriming();\n  return true;\n}\n"]}
+{"version":3,"file":"containerContentsStore.js","sourceRoot":"","sources":["containerContentsStore.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DomainScope } from \"../../data/shared/domainScope\";\nimport { getCachedContainerWriterProjection } from \"../../workflows/container-contents/container-state/projectionCache\";\nimport {\n  type ContainerContentsPersistence,\n  defaultContainerContentsPersistence,\n} from \"../../workflows/container-contents/containerPersistence\";\nimport { persistContainerState } from \"./containerState/containerStatePersistence\";\nimport {\n  createChildContainer,\n  deleteContainer,\n  ensureSystemContainer,\n  moveContainer,\n  renameContainer,\n} from \"./operations\";\nimport { emptyTrash } from \"./operations/emptyTrashOperation\";\nimport {\n  prepareContainerGroupRewrap,\n  verifyContainerGroupRewrapCurrent,\n} from \"./operations/groupRewrapOperation\";\nimport { purgeContainer } from \"./operations/purgeContainerOperation\";\nimport { setContainerIcon } from \"./operations/setContainerIconOperation\";\nimport {\n  shareContainerWithGroup,\n  shareContainerWithUser,\n} from \"./operations/shareOperations\";\nimport { invalidateRemoteContainerWrites } from \"./remoteWrites/remoteWriteGuards\";\nimport { chainRemoteContainerTask } from \"./remoteWrites/remoteWriteQueue\";\nimport { captureContainerWriteGeneration } from \"./remoteWrites/writeGeneration\";\nimport {\n  createContainerContentsStoreState,\n  subscribeToContainerContentsStore,\n  updateContainerContentsSnapshot,\n  updateContainerContentsStorePersistence,\n  updateContainerContentsStoreRuntime,\n} from \"./state\";\nimport {\n  type ContainerContentsStoreRuntime,\n  type ContainerContentsStoreSyncAgent,\n  createContainerContentsStoreSyncAgent,\n} from \"./syncAgent\";\nimport { findRootContainerState } from \"./systemContainers/systemContainerLookup\";\nimport type {\n  ContainerContentsStore,\n  ContainerContentsStoreOptions,\n  ContainerContentsStoreState,\n} from \"./types\";\n\nconst containerContentsStoresByScope = new WeakMap<\n  DomainScope,\n  ContainerContentsStoreEntry\n>();\n\ninterface ContainerContentsStoreEntry {\n  requestDocumentPriming: () => void;\n  store: ContainerContentsStore;\n  updateOptions: (options: ContainerContentsStoreOptions) => void;\n}\n\nfunction applyContainerContentsStoreOptions(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n  options: ContainerContentsStoreOptions,\n): void {\n  if (\"logLabel\" in options) {\n    state.logLabel = options.logLabel;\n  }\n\n  if (\"persistence\" in options) {\n    updateContainerContentsStorePersistence(\n      state,\n      options.persistence ?? defaultContainerContentsPersistence,\n      syncAgent,\n    );\n  }\n}\n\nfunction getCachedContainerWriterProjectionForStore(\n  state: ContainerContentsStoreState,\n  containerId: string,\n) {\n  const containerState = state.containersById.get(containerId);\n  return containerState\n    ? getCachedContainerWriterProjection(containerState)\n    : null;\n}\n\nfunction createContainerContentsStoreSyncHost(\n  state: ContainerContentsStoreState,\n): Parameters<typeof createContainerContentsStoreSyncAgent>[0][\"host\"] {\n  return {\n    persistContainerState: (\n      containerState,\n      patch,\n      updateView,\n      saveOptions,\n      mutationOptions,\n    ) =>\n      persistContainerState(state, containerState, {\n        patch,\n        updateView,\n        saveOptions,\n        ...mutationOptions,\n      }),\n    requestDocumentPriming: () => {\n      state.documentStoresNeedPriming = true;\n    },\n    updateSnapshot: () => updateContainerContentsSnapshot(state),\n  };\n}\n\n// null marks an unknown mutation scope; [] delegates invalidation to actual writes.\nfunction chainContainerWrite(\n  state: ContainerContentsStoreState,\n  work: (isCurrent: () => boolean) => ContainerContentsStoreState[\"writeChain\"],\n  changedIds: readonly string[] | null = null,\n  movedId?: string,\n): ContainerContentsStoreState[\"writeChain\"] {\n  const isCurrent = captureContainerWriteGeneration(state);\n  invalidateRemoteContainerWrites(state, changedIds, movedId);\n  state.writeChain = state.writeChain\n    .catch(() => null)\n    .then(() => {\n      if (!isCurrent()) return null;\n      invalidateRemoteContainerWrites(state, changedIds, movedId);\n      return work(isCurrent);\n    })\n    .then((node) => (isCurrent() ? node : null));\n  return state.writeChain;\n}\n\ntype ContainerWriteMethods = Pick<\n  ContainerContentsStore,\n  | \"createChild\"\n  | \"deleteContainer\"\n  | \"emptyTrash\"\n  | \"ensureSystemContainer\"\n  | \"moveContainer\"\n  | \"prepareGroupRewrap\"\n  | \"purgeContainer\"\n  | \"renameContainer\"\n  | \"setContainerIcon\"\n  | \"shareWithGroup\"\n  | \"shareWithUser\"\n>;\n\n// The group-rewrap builder verifies any required existing grant before capturing\n// the container KEK, then returns a check/rewrap pair. A verified non-match is\n// distinct from an unavailable preparation so security-critical callers can\n// no-op unrelated groups without failing open for a real grant.\nfunction createPrepareGroupRewrapMethod(\n  state: ContainerContentsStoreState,\n  syncAgent: ReturnType<typeof createContainerContentsStoreSyncAgent>,\n): ContainerContentsStore[\"prepareGroupRewrap\"] {\n  return async (containerId, groupId, accessLevel, options) => {\n    const preparation = await chainRemoteContainerTask(\n      state,\n      syncAgent,\n      null,\n      (isCurrent) =>\n        prepareContainerGroupRewrap(\n          state,\n          containerId,\n          groupId,\n          accessLevel,\n          options,\n          isCurrent,\n        ),\n      containerId,\n    );\n    return preparation?.status === \"prepared\"\n      ? {\n          isCurrent: (\n            expectedGroupHead,\n            expectedContainerId,\n            expectedOrganizationId,\n          ) =>\n            chainRemoteContainerTask(\n              state,\n              syncAgent,\n              false,\n              (isCurrent) =>\n                verifyContainerGroupRewrapCurrent(\n                  state,\n                  containerId,\n                  groupId,\n                  accessLevel,\n                  expectedGroupHead,\n                  expectedContainerId,\n                  expectedOrganizationId,\n                  isCurrent,\n                ),\n              containerId,\n            ),\n          rewrap: () =>\n            chainRemoteContainerTask(\n              state,\n              syncAgent,\n              false,\n              (isCurrent) =>\n                shareContainerWithGroup(\n                  state,\n                  syncAgent,\n                  containerId,\n                  groupId,\n                  accessLevel,\n                  {\n                    ...options,\n                    knownContainerKeks: preparation.knownContainerKeks,\n                    // A prepared re-wrap is grant-preserving by definition, so\n                    // it never mints a grant and never needs the chosen name.\n                    requireExistingGrant: true,\n                  },\n                  isCurrent,\n                ),\n              containerId,\n              { preserveResultOnLocalWrite: true },\n            ),\n          status: \"prepared\" as const,\n        }\n      : (preparation ?? null);\n  };\n}\n\nfunction createContainerSharingMethods(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n): Pick<ContainerWriteMethods, \"shareWithUser\" | \"shareWithGroup\"> {\n  return {\n    shareWithUser: (containerId, userId) =>\n      chainRemoteContainerTask(\n        state,\n        syncAgent,\n        false,\n        (isCurrent) =>\n          shareContainerWithUser(\n            state,\n            syncAgent,\n            containerId,\n            userId,\n            isCurrent,\n          ),\n        containerId,\n        { preserveResultOnLocalWrite: true },\n      ),\n    shareWithGroup: (containerId, groupId, accessLevel, options) =>\n      chainRemoteContainerTask(\n        state,\n        syncAgent,\n        false,\n        (isCurrent) =>\n          shareContainerWithGroup(\n            state,\n            syncAgent,\n            containerId,\n            groupId,\n            accessLevel,\n            options,\n            isCurrent,\n          ),\n        containerId,\n        { preserveResultOnLocalWrite: true },\n      ),\n  };\n}\n\nfunction createDeleteContainerMethod(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n): ContainerContentsStore[\"deleteContainer\"] {\n  return (containerId) => {\n    const current = captureContainerWriteGeneration(state);\n    const remoteDelete = () =>\n      chainRemoteContainerTask(\n        state,\n        syncAgent,\n        null,\n        (isCurrent) =>\n          deleteContainer(state, syncAgent, containerId, isCurrent),\n        containerId,\n      ).then((node) => node !== null);\n    if (state.containersById.get(containerId)?.record.documentId)\n      return remoteDelete();\n    let promoted = false;\n    return chainContainerWrite(\n      state,\n      (isCurrent) => {\n        // Promotion can win while this local operation was queued. Hand it to\n        // the remote queue after releasing the local chain, before any HTTP I/O.\n        promoted = Boolean(\n          state.containersById.get(containerId)?.record.documentId,\n        );\n        return promoted\n          ? Promise.resolve(null)\n          : deleteContainer(state, syncAgent, containerId, isCurrent);\n      },\n      [containerId],\n    ).then((node) => (promoted && current() ? remoteDelete() : node !== null));\n  };\n}\n\nfunction createEnsureSystemContainerMethod(\n  state: ContainerContentsStoreState,\n  syncAgent: ContainerContentsStoreSyncAgent,\n): ContainerContentsStore[\"ensureSystemContainer\"] {\n  return (systemSlot, name, options) => {\n    const work = (isCurrent: () => boolean) =>\n      ensureSystemContainer(\n        state,\n        syncAgent,\n        systemSlot,\n        name,\n        options,\n        isCurrent,\n      );\n    const rootId = findRootContainerState(state)?.container.id;\n    return options?.deferRemoteBootstrap\n      ? chainContainerWrite(state, work, [])\n      : chainRemoteContainerTask(\n          state,\n          syncAgent,\n          null,\n          work,\n          rootId ? { rootId, systemSlot } : undefined,\n        );\n  };\n}\n\nexport function createContainerWriteMethods(\n  state: ContainerContentsStoreState,\n  syncAgent: ReturnType<typeof createContainerContentsStoreSyncAgent>,\n): ContainerWriteMethods {\n  return {\n    ...createContainerSharingMethods(state, syncAgent),\n    createChild: (parentId, name) =>\n      chainContainerWrite(\n        state,\n        (isCurrent) =>\n          createChildContainer(state, syncAgent, parentId, name, isCurrent),\n        [parentId],\n      ),\n    deleteContainer: createDeleteContainerMethod(state, syncAgent),\n    purgeContainer: (containerId, options) =>\n      chainRemoteContainerTask(\n        state,\n        syncAgent,\n        false,\n        (isCurrent) =>\n          purgeContainer(state, syncAgent, containerId, options, isCurrent),\n        containerId,\n      ),\n    emptyTrash: (trashContainerId, options) =>\n      chainRemoteContainerTask(\n        state,\n        syncAgent,\n        false,\n        (isCurrent) =>\n          emptyTrash(state, syncAgent, trashContainerId, options, isCurrent),\n        trashContainerId,\n      ),\n    ensureSystemContainer: createEnsureSystemContainerMethod(state, syncAgent),\n    moveContainer: (containerId, parentId) =>\n      chainContainerWrite(\n        state,\n        (isCurrent) =>\n          moveContainer(state, syncAgent, containerId, parentId, isCurrent),\n        [containerId, parentId],\n        containerId,\n      ),\n    prepareGroupRewrap: createPrepareGroupRewrapMethod(state, syncAgent),\n    renameContainer: (containerId, name) =>\n      chainContainerWrite(\n        state,\n        (isCurrent) =>\n          renameContainer(state, syncAgent, containerId, name, isCurrent),\n        [containerId],\n      ),\n    setContainerIcon: (containerId, icon) =>\n      chainContainerWrite(\n        state,\n        (isCurrent) =>\n          setContainerIcon(state, syncAgent, containerId, icon, isCurrent),\n        [containerId],\n      ),\n  };\n}\n\nfunction createContainerContentsStoreEntry(\n  initialRuntime: ContainerContentsStoreRuntime,\n  persistence: ContainerContentsPersistence = defaultContainerContentsPersistence,\n  options: ContainerContentsStoreOptions = {},\n): ContainerContentsStoreEntry {\n  const state = createContainerContentsStoreState(\n    initialRuntime,\n    options.persistence ?? persistence,\n    options.logLabel,\n  );\n  const syncAgent = createContainerContentsStoreSyncAgent({\n    host: createContainerContentsStoreSyncHost(state),\n    state,\n  });\n  const writeMethods = createContainerWriteMethods(state, syncAgent);\n\n  return {\n    requestDocumentPriming: () => {\n      state.documentStoresNeedPriming = true;\n      syncAgent.scheduleSync();\n    },\n    store: {\n      ...writeMethods,\n      refresh: () => syncAgent.refresh({ resetAllLaneWatermarks: true }),\n      refreshRootLane: (options) => syncAgent.refreshRootLane(options),\n      // Force an on-demand local SQLite re-read (see the interface doc): arm the\n      // gate refreshLocalContainerStates otherwise requires, which the runtime\n      // auto-arms only on a context transition an on-demand caller cannot rely on.\n      refreshLocalContainers: () => {\n        state.localContainersNeedRefresh = true;\n        return syncAgent.refreshLocalContainers();\n      },\n      requestSync: () => syncAgent.scheduleSync(),\n      getCachedContainerWriterProjection: (containerId) =>\n        getCachedContainerWriterProjectionForStore(state, containerId),\n      getSnapshot: () => state.snapshot,\n      subscribe: (listener) =>\n        subscribeToContainerContentsStore(state, listener),\n      updateRuntime: (runtime) =>\n        updateContainerContentsStoreRuntime(state, runtime, syncAgent),\n    },\n    updateOptions: (nextOptions) =>\n      applyContainerContentsStoreOptions(state, syncAgent, nextOptions),\n  };\n}\n\nexport function createContainerContentsStore(\n  initialRuntime: ContainerContentsStoreRuntime,\n  persistence: ContainerContentsPersistence = defaultContainerContentsPersistence,\n  options: ContainerContentsStoreOptions = {},\n): ContainerContentsStore {\n  return createContainerContentsStoreEntry(initialRuntime, persistence, options)\n    .store;\n}\n\nexport function getOrCreateContainerContentsStore(\n  domainScope: DomainScope,\n  runtime: ContainerContentsStoreRuntime,\n  options: ContainerContentsStoreOptions = {},\n): ContainerContentsStore {\n  const existingEntry = containerContentsStoresByScope.get(domainScope);\n  if (existingEntry) {\n    existingEntry.updateOptions(options);\n    return existingEntry.store;\n  }\n\n  const nextEntry = createContainerContentsStoreEntry(\n    runtime,\n    defaultContainerContentsPersistence,\n    options,\n  );\n  containerContentsStoresByScope.set(domainScope, nextEntry);\n  return nextEntry.store;\n}\n\n/**\n * Arm the next structural pass's document-priming scan for a domain scope.\n * Priming normally re-arms only on store creation and topology changes, so a\n * caller that just tore down a document's local state uses this to have the\n * still-listed server document re-created without waiting for an app\n * restart. Returns false when the scope has no container-contents store yet;\n * the startup priming pass covers that case.\n */\nexport function requestContainerContentsDocumentPriming(\n  domainScope: DomainScope,\n): boolean {\n  const entry = containerContentsStoresByScope.get(domainScope);\n  if (!entry) {\n    return false;\n  }\n\n  entry.requestDocumentPriming();\n  return true;\n}\n"]}

package/stores/container-contents/containerState/containerStateMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerStateMap.js","sourceRoot":"","sources":["containerStateMap.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAkB,SAAQ,GAA2B;IACvD,uBAAuB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7D,uBAAuB,GAAG,CAAC,CAAC;IAE5B,YAAY,OAA6C;QACvD,KAAK,EAAE,CAAC;QACR,KAAK,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;YACjD,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAEQ,KAAK;QACZ,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAEQ,MAAM,CAAC,WAAmB;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC1C,sEAAsE;QACtE,0EAA0E;QAC1E,sEAAsE;QACtE,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IAEQ,GAAG,CAAC,WAAmB,EAAE,KAAqB;QACrD,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,0BAA0B;QACxB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC/C,CAAC;IAED,gBAAgB,CACd,WAAmB,EACnB,QAAqC;QAErC,OAAO,CACL,CAAC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACpD,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CACjC,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,WAAmB;QACxC,IAAI,CAAC,uBAAuB,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC9E,CAAC;CACF;AAED,MAAM,UAAU,wCAAwC,CACtD,MAAmC;IAEnC,OAAO,MAAM,YAAY,iBAAiB;QACxC,CAAC,CAAC,MAAM,CAAC,0BAA0B,EAAE;QACrC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAmC,EACnC,WAAmB,EACnB,QAAqC;IAErC,OAAO,CACL,MAAM,YAAY,iBAAiB;QACnC,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAC/C,CAAC;AACJ,CAAC","sourcesContent":["import type { ContainerState } from \"../../../workflows/container-contents/remoteHydration\";\n\nexport class ContainerStateMap extends Map<string, ContainerState> {\n  readonly #mutationGenerationById = new Map<string, number>();\n  #nextMutationGeneration = 0;\n\n  constructor(entries?: ReadonlyMap<string, ContainerState>) {\n    super();\n    for (const [containerId, state] of entries ?? []) {\n      super.set(containerId, state);\n    }\n  }\n\n  override clear(): void {\n    for (const containerId of this.keys()) {\n      this.recordMutation(containerId);\n    }\n    super.clear();\n  }\n\n  override delete(containerId: string): boolean {\n    const deleted = super.delete(containerId);\n    // An absent delete is still an authoritative tombstone observation. A\n    // local-refresh query that started before it must not install a stale row\n    // merely because no in-memory value existed for Map.delete to remove.\n    this.recordMutation(containerId);\n    return deleted;\n  }\n\n  override set(containerId: string, state: ContainerState): this {\n    this.recordMutation(containerId);\n    return super.set(containerId, state);\n  }\n\n  captureMutationGenerations(): ReadonlyMap<string, number> {\n    return new Map(this.#mutationGenerationById);\n  }\n\n  hasMutationAfter(\n    containerId: string,\n    baseline: ReadonlyMap<string, number>,\n  ): boolean {\n    return (\n      (this.#mutationGenerationById.get(containerId) ?? 0) !==\n      (baseline.get(containerId) ?? 0)\n    );\n  }\n\n  private recordMutation(containerId: string): void {\n    this.#nextMutationGeneration += 1;\n    this.#mutationGenerationById.set(containerId, this.#nextMutationGeneration);\n  }\n}\n\nexport function captureContainerStateMutationGenerations(\n  states: Map<string, ContainerState>,\n): ReadonlyMap<string, number> {\n  return states instanceof ContainerStateMap\n    ? states.captureMutationGenerations()\n    : new Map();\n}\n\nexport function containerStateMutatedAfter(\n  states: Map<string, ContainerState>,\n  containerId: string,\n  baseline: ReadonlyMap<string, number>,\n): boolean {\n  return (\n    states instanceof ContainerStateMap &&\n    states.hasMutationAfter(containerId, baseline)\n  );\n}\n"]}

package/stores/container-contents/{containerStatePersistence.js → containerState/containerStatePersistence.js}

@@ -1,6 +1,6 @@
-import { installContainerMetadataRecord, persistContainerMetadataStateFromRuntime, } from "../../workflows/container-contents/metadata/index.js";
+import { installContainerMetadataRecord, persistContainerMetadataStateFromRuntime, } from "../../../workflows/container-contents/metadata/index.js";
+import { updateContainerContentsSnapshot } from "../state.js";
 import { removeMissingContainerState } from "./missingContainerState.js";
-import { updateContainerContentsSnapshot } from "./state.js";
 export async function persistContainerState(state, containerState, options = {}) {
     const { expectedStateWhenMissing, isCurrent, updateView = true } = options;
     const persisted = await persistContainerMetadataStateFromRuntime({

package/stores/container-contents/containerState/containerStatePersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerStatePersistence.js","sourceRoot":"","sources":["containerStatePersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,wCAAwC,GACzC,MAAM,gDAAgD,CAAC;AAExD,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAG3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAsBtE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAkC,EAClC,cAA8B,EAC9B,UAAwC,EAAE;IAE1C,MAAM,EAAE,wBAAwB,EAAE,SAAS,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC3E,MAAM,SAAS,GAAG,MAAM,wCAAwC,CAAC;QAC/D,aAAa,EAAE,cAAc;QAC7B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;QACtD,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,mCAAmC,EACjC,OAAO,CAAC,mCAAmC;QAC7C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,SAAS;KACxB,CAAC,CAAC;IACH,IAAI,SAAS,EAAE,EAAE,KAAK,KAAK,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,2BAA2B,CACzB,KAAK,EACL,wBAAwB,IAAI,cAAc,CAC3C,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IACD,cAAc,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;IAC/C,8BAA8B,CAAC,cAAc,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACjE,IAAI,SAAS,CAAC,kBAAkB,IAAI,SAAS,CAAC,sBAAsB,EAAE,CAAC;QACrE,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC1E,IAAI,WAAW,IAAI,WAAW,KAAK,cAAc,EAAE,CAAC;YAClD,WAAW,CAAC,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC;YACjD,WAAW,CAAC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC;YACrC,WAAW,CAAC,wBAAwB;gBAClC,cAAc,CAAC,wBAAwB,CAAC;YAC1C,8BAA8B,CAAC,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAChE,CAAC;QACD,sEAAsE;QACtE,2EAA2E;QAC3E,2EAA2E;QAC3E,+BAA+B,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,+BAA+B,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,MAAM,EAAE,WAAW;QACnB,GAAG,CAAC,SAAS,CAAC,mBAAmB;YAC/B,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAa,EAAE;YACxC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,SAAS,CAAC,iBAAiB;YAC7B,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAa,EAAE;YACtC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC","sourcesContent":["import {\n  installContainerMetadataRecord,\n  persistContainerMetadataStateFromRuntime,\n} from \"../../../workflows/container-contents/metadata\";\nimport type { PersistContainerStateResult } from \"../../../workflows/container-contents/remoteHydration\";\nimport { updateContainerContentsSnapshot } from \"../state\";\nimport type { ContainerState } from \"../syncAgent\";\nimport type { ContainerContentsStoreState } from \"../types\";\nimport { removeMissingContainerState } from \"./missingContainerState\";\n\ntype MetadataPersistenceInput = Parameters<\n  typeof persistContainerMetadataStateFromRuntime\n>[0];\n\ninterface PersistContainerStateOptions\n  extends Pick<\n    MetadataPersistenceInput,\n    | \"patch\"\n    | \"saveOptions\"\n    | \"localMetadataPatch\"\n    | \"localUpdate\"\n    | \"createIntentSettlement\"\n    | \"moveIntentSettlement\"\n    | \"preserveDurableStructureWhenPending\"\n  > {\n  expectedStateWhenMissing?: ContainerState | undefined;\n  isCurrent?: (() => boolean) | undefined;\n  updateView?: boolean | undefined;\n}\n\nexport async function persistContainerState(\n  state: ContainerContentsStoreState,\n  containerState: ContainerState,\n  options: PersistContainerStateOptions = {},\n): Promise<PersistContainerStateResult> {\n  const { expectedStateWhenMissing, isCurrent, updateView = true } = options;\n  const persisted = await persistContainerMetadataStateFromRuntime({\n    metadataState: containerState,\n    localMetadataPatch: options.localMetadataPatch,\n    localUpdate: options.localUpdate,\n    patch: options.patch ?? {},\n    persistence: state.persistence,\n    createIntentSettlement: options.createIntentSettlement,\n    moveIntentSettlement: options.moveIntentSettlement,\n    preserveDurableStructureWhenPending:\n      options.preserveDurableStructureWhenPending,\n    runtime: state.runtime,\n    saveOptions: options.saveOptions,\n    stillCurrent: isCurrent,\n  });\n  if (isCurrent?.() === false) {\n    return { status: \"stale-generation\" };\n  }\n  if (!persisted) {\n    removeMissingContainerState(\n      state,\n      expectedStateWhenMissing ?? containerState,\n    );\n    return { status: \"missing\" };\n  }\n  containerState.container = persisted.container;\n  installContainerMetadataRecord(containerState, persisted.record);\n  if (persisted.mutationSuperseded || persisted.syncIdentitySuperseded) {\n    const cachedState = state.containersById.get(containerState.container.id);\n    if (cachedState && cachedState !== containerState) {\n      cachedState.container = containerState.container;\n      cachedState.doc = containerState.doc;\n      cachedState.metadataWriterProjection =\n        containerState.metadataWriterProjection;\n      installContainerMetadataRecord(cachedState, persisted.record);\n    }\n    // The requested structural mutation was not applied. Refresh from the\n    // authoritative state installed above, but make the caller fail explicitly\n    // so it cannot schedule sync or report the dropped mutation as successful.\n    updateContainerContentsSnapshot(state);\n    return { record: persisted.record, status: \"identity-superseded\" };\n  }\n  if (updateView) {\n    updateContainerContentsSnapshot(state);\n  }\n  return {\n    record: persisted.record,\n    status: \"persisted\",\n    ...(persisted.createIntentSettled\n      ? { createIntentSettled: true as const }\n      : {}),\n    ...(persisted.moveIntentSettled\n      ? { moveIntentSettled: true as const }\n      : {}),\n  };\n}\n"]}

package/stores/container-contents/{missingContainerState.js → containerState/missingContainerState.js}

@@ -1,4 +1,4 @@
-import { updateContainerContentsSnapshot } from "./state.js";
+import { updateContainerContentsSnapshot } from "../state.js";
 export function removeMissingContainerState(state, expectedState) {
     const containerId = expectedState.container.id;
     if (state.containersById.get(containerId) !== expectedState) {

package/stores/container-contents/containerState/missingContainerState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missingContainerState.js","sourceRoot":"","sources":["missingContainerState.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAG3D,MAAM,UAAU,2BAA2B,CACzC,KAAkC,EAClC,aAA6B;IAE7B,MAAM,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;IAC/C,IAAI,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,aAAa,EAAE,CAAC;QAC5D,OAAO;IACT,CAAC;IACD,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACzC,+BAA+B,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC","sourcesContent":["import type { ContainerState } from \"../../../workflows/container-contents/remoteHydration\";\nimport { updateContainerContentsSnapshot } from \"../state\";\nimport type { ContainerContentsStoreState } from \"../types\";\n\nexport function removeMissingContainerState(\n  state: ContainerContentsStoreState,\n  expectedState: ContainerState,\n): void {\n  const containerId = expectedState.container.id;\n  if (state.containersById.get(containerId) !== expectedState) {\n    return;\n  }\n  state.containersById.delete(containerId);\n  updateContainerContentsSnapshot(state);\n}\n"]}

package/stores/container-contents/containerState/missingSyncedContainerState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missingSyncedContainerState.js","sourceRoot":"","sources":["missingSyncedContainerState.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,iCAAiC,CAC/C,KAAsC,EACtC,aAA6B,EAC7B,cAA0B;IAE1B,MAAM,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;IAC/C,IAAI,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,aAAa,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACzC,cAAc,EAAE,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import type { ContainerState } from \"../../../workflows/container-contents/remoteHydration\";\nimport type { ContainerContentsStoreSyncState } from \"../syncAgent/syncAgentTypes\";\n\nexport function removeMissingSyncedContainerState(\n  state: ContainerContentsStoreSyncState,\n  expectedState: ContainerState,\n  updateSnapshot: () => void,\n): boolean {\n  const containerId = expectedState.container.id;\n  if (state.containersById.get(containerId) !== expectedState) {\n    return false;\n  }\n\n  state.containersById.delete(containerId);\n  updateSnapshot();\n  return true;\n}\n"]}

package/stores/container-contents/{reconcilableContainer.d.ts → containerState/reconcilableContainer.d.ts}

@@ -1,4 +1,4 @@
-import type { ContainerNode } from "./types.js";
+import type { ContainerNode } from "../types.js";
 /**
  * Whether a container is a system container — one tagged with a deterministic
  * `systemSlot` for a built-in role such as Contacts, Trash, organization

package/stores/container-contents/containerState/reconcilableContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcilableContainer.js","sourceRoot":"","sources":["reconcilableContainer.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAuC;IAEvC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;AAC3B,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,2BAA2B,CACzC,IAA+C;IAE/C,OAAO,CACL,OAAO,IAAI,CAAC,kBAAkB,KAAK,QAAQ;QAC3C,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CACnC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAMC,EACD,kBAAiC;IAEjC,wEAAwE;IACxE,uEAAuE;IACvE,2EAA2E;IAC3E,uEAAuE;IACvE,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,kBAAkB,KAAK,IAAI;QAC3B,CAAC,IAAI,CAAC,cAAc,KAAK,kBAAkB;YACzC,4BAA4B,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mCAAmC,CACjD,IAMC,EACD,kBAAiC;IAEjC,OAAO,CACL,2BAA2B,CAAC,IAAI,CAAC;QACjC,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC;YAC3B,4BAA4B,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAGC,EACD,kBAAiC;IAEjC,OAAO,CACL,qBAAqB,CAAC,IAAI,CAAC;QAC3B,kBAAkB,KAAK,IAAI;QAC3B,CAAC,CAAC,IAAI,CAAC,cAAc;QACrB,IAAI,CAAC,cAAc,KAAK,kBAAkB;QAC1C,CAAC,IAAI,CAAC,oBAAoB,KAAK,MAAM;YACnC,IAAI,CAAC,oBAAoB,KAAK,OAAO,CAAC,CACzC,CAAC;AACJ,CAAC","sourcesContent":["import type { ContainerNode } from \"../types\";\n\n/**\n * Whether a container is a system container — one tagged with a deterministic\n * `systemSlot` for a built-in role such as Contacts, Trash, organization\n * metadata, or the per-organization roster.\n */\nexport function isSystemContainerNode(\n  node: Pick<ContainerNode, \"systemSlot\">,\n): boolean {\n  return !!node.systemSlot;\n}\n\n/** Whether a container has completed enough remote creation to be listed. */\nexport function isRemoteBackedContainerNode(\n  node: Pick<ContainerNode, \"metadataDocumentId\">,\n): boolean {\n  return (\n    typeof node.metadataDocumentId === \"string\" &&\n    node.metadataDocumentId.length > 0\n  );\n}\n\n/**\n * Whether generic document reconciliation may safely list this container.\n *\n * Every container joins generic reconciliation only after remote creation has\n * given it a metadata document id. This keeps local-first roots and children\n * out of an HTTP lane that cannot exist yet, while still letting another device\n * rematerialize Contacts, Trash, and other system data.\n */\nexport function isReconcilableContainerNode(\n  node: Pick<\n    ContainerNode,\n    | \"effectiveAccessLevel\"\n    | \"metadataDocumentId\"\n    | \"organizationId\"\n    | \"systemSlot\"\n  >,\n  homeOrganizationId: string | null,\n): boolean {\n  // Document discovery is an HTTP read against the remote container id. A\n  // local-first container has no such lane until its metadata create has\n  // committed; attempting to list it can only produce a 404. This applies to\n  // the pre-auth local root just as much as to a local system container.\n  if (!isRemoteBackedContainerNode(node)) {\n    return false;\n  }\n\n  if (!isSystemContainerNode(node)) {\n    return true;\n  }\n\n  return (\n    homeOrganizationId !== null &&\n    (node.organizationId === homeOrganizationId ||\n      isForeignSystemContainerNode(node, homeOrganizationId))\n  );\n}\n\n/**\n * Whether a root-lane discovery hint should re-list this container's documents.\n *\n * The server's root discovery lane can return directly granted non-root\n * containers, so every remote-backed regular container remains eligible\n * regardless of its parent. Membership-visible foreign system containers\n * remain eligible for catch-up. Own system children are excluded here because\n * cold/auth backfill and explicit full refresh already reconcile them; sweeping\n * them on every Explorer-open or shared-root hint creates redundant work.\n */\nexport function isAutomaticRootCatchupContainerNode(\n  node: Pick<\n    ContainerNode,\n    | \"effectiveAccessLevel\"\n    | \"metadataDocumentId\"\n    | \"organizationId\"\n    | \"systemSlot\"\n  >,\n  homeOrganizationId: string | null,\n): boolean {\n  return (\n    isRemoteBackedContainerNode(node) &&\n    (!isSystemContainerNode(node) ||\n      isForeignSystemContainerNode(node, homeOrganizationId))\n  );\n}\n\n/**\n * Whether a system container belongs to a foreign organization whose contents\n * are visible through membership-level access.\n *\n * Event routing uses this classification for foreign system content whose\n * already-known document updates must still force discovery. It is not the\n * generic sweep predicate: remote-backed own system containers also reconcile\n * via {@link isReconcilableContainerNode}. A foreign system container is one\n * that is:\n *\n *  - a different org's (`organizationId !== homeOrganizationId`). Own system\n *    containers are outside this foreign-system classification, while a\n *    container mid-creation has an empty organization id that matches nothing\n *    (as does a null/unhydrated home org).\n *  - granted at a *membership* level — `read` (Members group) or `admin`\n *    (Admins group). A plain `write` share of a folder does not make the sharee\n *    a member, so it does not opt that folder into automatic root catch-up.\n */\nexport function isForeignSystemContainerNode(\n  node: Pick<\n    ContainerNode,\n    \"systemSlot\" | \"organizationId\" | \"effectiveAccessLevel\"\n  >,\n  homeOrganizationId: string | null,\n): boolean {\n  return (\n    isSystemContainerNode(node) &&\n    homeOrganizationId !== null &&\n    !!node.organizationId &&\n    node.organizationId !== homeOrganizationId &&\n    (node.effectiveAccessLevel === \"read\" ||\n      node.effectiveAccessLevel === \"admin\")\n  );\n}\n"]}

package/stores/container-contents/{documentRecovery.js → documentWork/documentRecovery.js}

@@ -1,9 +1,9 @@
-import { primeDocumentsForContainerSubtree, primeDocumentsForLoadedRoots, } from "../../workflows/container-contents/documentPriming/index.js";
-import { recoverStaleSessionRoot } from "../../workflows/container-contents/recovery/staleRootRecovery.js";
-import { createContainerContentsDocumentsRuntime, } from "../../workflows/container-contents/runtime.js";
-import { isDatabaseUnavailableError } from "../../workflows/container-contents/syncLane.js";
-import { openDocumentStore } from "../documents/index.js";
-import { getContainerContentsStoreLogLabel } from "./logLabel.js";
+import { primeDocumentsForContainerSubtree, primeDocumentsForLoadedRoots, } from "../../../workflows/container-contents/documentPriming/index.js";
+import { recoverStaleSessionRoot } from "../../../workflows/container-contents/recovery/staleRootRecovery.js";
+import { createContainerContentsDocumentsRuntime, } from "../../../workflows/container-contents/runtime.js";
+import { isDatabaseUnavailableError } from "../../../workflows/container-contents/syncLane.js";
+import { openDocumentStore } from "../../documents/index.js";
+import { getContainerContentsStoreLogLabel } from "../logLabel.js";
 const staleRootRecoveryLogState = new WeakMap();
 const rejectedAdoptionRuntime = new WeakMap();
 function createPrimeHost(runtime) {

package/stores/container-contents/documentWork/documentRecovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentRecovery.js","sourceRoot":"","sources":["documentRecovery.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContainerContentsPersistence } from \"../../../workflows/container-contents/containerPersistence\";\nimport {\n  primeDocumentsForContainerSubtree,\n  primeDocumentsForLoadedRoots,\n} from \"../../../workflows/container-contents/documentPriming\";\nimport type {\n  ContainerDocumentPrimeHost,\n  ContainerDocumentPrimeStore,\n} from \"../../../workflows/container-contents/documentQueries/types\";\nimport type { StaleRootRecoveryStatus } from \"../../../workflows/container-contents/recovery/staleRootRecovery\";\nimport { recoverStaleSessionRoot } from \"../../../workflows/container-contents/recovery/staleRootRecovery\";\nimport type { ContainerState } from \"../../../workflows/container-contents/remoteHydration\";\nimport {\n  type ContainerContentsStoreWorkflowRuntime,\n  createContainerContentsDocumentsRuntime,\n} from \"../../../workflows/container-contents/runtime\";\nimport { isDatabaseUnavailableError } from \"../../../workflows/container-contents/syncLane\";\nimport { openDocumentStore } from \"../../documents\";\nimport { getContainerContentsStoreLogLabel } from \"../logLabel\";\n\ntype PrimeDocumentRuntime = ReturnType<\n  typeof createContainerContentsDocumentsRuntime\n>;\n\ninterface DocumentRecoveryStoreState {\n  readonly containersById: Map<string, ContainerState>;\n  documentStoresNeedPriming: boolean;\n  readonly logLabel?: string | undefined;\n  readonly persistence: ContainerContentsPersistence;\n  readonly rootLaneHydrated: boolean;\n  readonly runtime: ContainerContentsStoreWorkflowRuntime;\n}\n\ninterface StaleRootRecoveryLogState {\n  readonly message: string;\n  readonly occurrenceCount: number;\n}\n\nconst staleRootRecoveryLogState = new WeakMap<\n  DocumentRecoveryStoreState,\n  StaleRootRecoveryLogState\n>();\nconst rejectedAdoptionRuntime = new WeakMap<\n  DocumentRecoveryStoreState,\n  ContainerContentsStoreWorkflowRuntime\n>();\n\nfunction createPrimeHost(\n  runtime: ContainerContentsStoreWorkflowRuntime,\n): ContainerDocumentPrimeHost<PrimeDocumentRuntime> {\n  return {\n    documentWorkflowRuntime: (containerId) =>\n      createContainerContentsDocumentsRuntime(runtime, containerId),\n    openDocumentStore: ({\n      documentId,\n      localId,\n      runtime,\n    }): ContainerDocumentPrimeStore =>\n      openDocumentStore(\n        runtime.state.domainScope,\n        localId,\n        runtime,\n        documentId,\n      ),\n  };\n}\n\nexport async function primeStoreDocumentSubtree(\n  state: DocumentRecoveryStoreState,\n  rootContainerId: string,\n  isCurrent: () => boolean = () => true,\n): Promise<void> {\n  if (!isCurrent()) return;\n  const runtime = state.runtime;\n  await primeDocumentsForContainerSubtree({\n    containersById: state.containersById,\n    host: createPrimeHost(runtime),\n    isCurrent,\n    rootContainerId,\n    runtime,\n  });\n}\n\nexport async function primeStoreDocuments(\n  state: DocumentRecoveryStoreState,\n  isCurrent: () => boolean = () => true,\n): Promise<void> {\n  if (!isCurrent()) return;\n  const runtime = state.runtime;\n  // Consume the current signal before scanning. A topology/root reconciliation\n  // that lands during an awaited query can then re-arm the next pass without\n  // this pass erasing that newer signal when it completes.\n  state.documentStoresNeedPriming = false;\n  try {\n    const result = await primeDocumentsForLoadedRoots({\n      containersById: state.containersById,\n      host: createPrimeHost(runtime),\n      isCurrent,\n      organizationId: runtime.auth?.organizationId ?? null,\n      runtime,\n    });\n    if (!isCurrent()) {\n      state.documentStoresNeedPriming = true;\n      return;\n    }\n    runtime.util.log(\n      `${getContainerContentsStoreLogLabel(state)}: document priming candidates=${result.candidateCount} roots=${result.rootCount} primed=${result.primedCount} orphaned=${result.orphanPrimedCount} unroutable=${result.unroutableCount}`,\n    );\n  } catch (error) {\n    if (!isCurrent()) {\n      state.documentStoresNeedPriming = true;\n      return;\n    }\n    state.documentStoresNeedPriming = true;\n    throw error;\n  }\n}\n\nexport async function recoverStoreStaleRoot(\n  state: DocumentRecoveryStoreState,\n  isCurrent: () => boolean = () => true,\n): Promise<StaleRootRecoveryStatus> {\n  if (!isCurrent()) {\n    return \"context-changed\";\n  }\n  const runtime = state.runtime;\n  if (rejectedAdoptionRuntime.get(state) === runtime) {\n    return \"not-needed\";\n  }\n\n  let result: Awaited<ReturnType<typeof recoverStaleSessionRoot>>;\n  try {\n    result = await recoverStaleSessionRoot({ ...state, runtime }, isCurrent);\n  } catch (error) {\n    if (!isCurrent()) {\n      return \"context-changed\";\n    }\n    if (isDatabaseUnavailableError(error)) {\n      throw error;\n    }\n    const message = `${getContainerContentsStoreLogLabel(state)}: stale root recovery failed`;\n    if (state.runtime.util.logError) {\n      state.runtime.util.logError(message, error);\n    } else {\n      state.runtime.util.log(message);\n    }\n    return \"not-needed\";\n  }\n  if (!isCurrent()) {\n    return \"context-changed\";\n  }\n  const message = `${getContainerContentsStoreLogLabel(state)}: stale root recovery status=${result.status} candidates=${result.candidateCount}`;\n  const previousLogState = staleRootRecoveryLogState.get(state);\n  const occurrenceCount =\n    previousLogState?.message === message\n      ? previousLogState.occurrenceCount + 1\n      : 1;\n  staleRootRecoveryLogState.set(state, { message, occurrenceCount });\n  if (result.status !== \"not-needed\") {\n    if (occurrenceCount === 1) {\n      runtime.util.log(message);\n    } else if ((occurrenceCount & (occurrenceCount - 1)) === 0) {\n      runtime.util.log(`${message} occurrences=${occurrenceCount}`);\n    }\n  }\n  if (result.status === \"context-changed\") {\n    rejectedAdoptionRuntime.set(state, runtime);\n  } else {\n    rejectedAdoptionRuntime.delete(state);\n  }\n  if (result.reassigned) {\n    state.documentStoresNeedPriming = true;\n  }\n  return result.status;\n}\n"]}

package/stores/container-contents/{documentRotation.js → documentWork/documentRotation.js}

@@ -1,5 +1,5 @@
-import { createContainerContentsDocumentsRuntime, } from "../../workflows/container-contents/runtime.js";
-import { openDocumentStore } from "../documents/index.js";
+import { createContainerContentsDocumentsRuntime, } from "../../../workflows/container-contents/runtime.js";
+import { openDocumentStore } from "../../documents/index.js";
 export async function prepareContainerDocumentRotationSnapshot(runtime, document) {
     if (!document.documentId || !document.containerId) {
         return null;

package/stores/container-contents/documentWork/documentRotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentRotation.js","sourceRoot":"","sources":["documentRotation.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,uCAAuC,GACxC,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAC5D,OAAyC,EACzC,QAAyB;IAEzB,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,iBAAiB,CAC7B,OAAO,CAAC,KAAK,CAAC,WAAW,EACzB,QAAQ,CAAC,EAAE,EACX,uCAAuC,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,EACtE,QAAQ,CAAC,UAAU,CACpB,CAAC;IACF,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,yBAAyB,EAAE,CAAC;AAC3C,CAAC","sourcesContent":["import type { DocumentSummary } from \"../../../data/documents/documentSummary\";\nimport {\n  type ContainerContentsWorkflowRuntime,\n  createContainerContentsDocumentsRuntime,\n} from \"../../../workflows/container-contents/runtime\";\nimport { openDocumentStore } from \"../../documents\";\n\nexport async function prepareContainerDocumentRotationSnapshot(\n  runtime: ContainerContentsWorkflowRuntime,\n  document: DocumentSummary,\n): Promise<Uint8Array | null> {\n  if (!document.documentId || !document.containerId) {\n    return null;\n  }\n  const store = openDocumentStore(\n    runtime.state.domainScope,\n    document.id,\n    createContainerContentsDocumentsRuntime(runtime, document.containerId),\n    document.documentId,\n  );\n  if (!(await store.ensureInitialized())) {\n    return null;\n  }\n  return store.assertCanRotateContentKey();\n}\n"]}

package/stores/container-contents/{documentWork.js → documentWork/index.js}

@@ -26,4 +26,4 @@ export async function runContainerDocumentWork(input) {
     }
     return "completed";
 }
-//# sourceMappingURL=documentWork.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAYA,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAiC;IAEjC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,KAAK,CAAC,gBAAgB,EAAE,CAAC;IACtD,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,cAAc,KAAK,iBAAiB,EAAE,CAAC;QACzC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACzB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,kBAAkB,GAAG,MAAM,KAAK,CAAC,wBAAwB,EAAE,CAAC;IAClE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,gBAAgB,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,KAAK,CAAC,oBAAoB,EAAE,EAAE,CAAC;QACjC,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;YACvB,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC","sourcesContent":["import type { StaleRootRecoveryStatus } from \"../../../workflows/container-contents/recovery/staleRootRecovery\";\n\ninterface ContainerDocumentWorkInput {\n  readonly isCurrent: () => boolean;\n  readonly onContextChanged: () => void;\n  readonly onDocumentsMoved: () => void;\n  readonly primeDocuments: () => Promise<void>;\n  readonly recoverStaleRoot: () => Promise<StaleRootRecoveryStatus>;\n  readonly shouldPrimeDocuments: () => boolean;\n  readonly syncPendingDocumentMoves: () => Promise<number>;\n}\n\n/** Runs root repair before any work that consumes its rewritten projections. */\nexport async function runContainerDocumentWork(\n  input: ContainerDocumentWorkInput,\n): Promise<\"abandoned\" | \"completed\" | \"context-changed\"> {\n  if (!input.isCurrent()) {\n    return \"abandoned\";\n  }\n  const recoveryStatus = await input.recoverStaleRoot();\n  if (!input.isCurrent()) {\n    return \"abandoned\";\n  }\n  if (recoveryStatus === \"context-changed\") {\n    input.onContextChanged();\n    return \"context-changed\";\n  }\n\n  const movedDocumentCount = await input.syncPendingDocumentMoves();\n  if (!input.isCurrent()) {\n    return \"abandoned\";\n  }\n  if (movedDocumentCount > 0) {\n    input.onDocumentsMoved();\n  }\n  if (input.shouldPrimeDocuments()) {\n    await input.primeDocuments();\n    if (!input.isCurrent()) {\n      return \"abandoned\";\n    }\n  }\n  return \"completed\";\n}\n"]}

package/stores/container-contents/{backgroundHydration.js → hydration/backgroundHydration.js}

@@ -1,6 +1,6 @@
-import { reportKeyingVerificationErrorInCauseChain } from "../../data/keyingProjectionVerification/error.js";
-import { errorMessage } from "../../data/shared/errorMessage.js";
-import { isDatabaseUnavailableError } from "../../workflows/container-contents/syncLane.js";
+import { reportKeyingVerificationErrorInCauseChain } from "../../../data/keyingProjectionVerification/error.js";
+import { errorMessage } from "../../../data/shared/errorMessage.js";
+import { isDatabaseUnavailableError } from "../../../workflows/container-contents/syncLane.js";
 /** Observe a background refresh without changing the caller's rejection. */
 export function observeContainerBackgroundHydration(state, hydration) {
     const generation = state.lifecycleGeneration;

package/stores/container-contents/hydration/backgroundHydration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundHydration.js","sourceRoot":"","sources":["backgroundHydration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yCAAyC,EAAE,MAAM,kDAAkD,CAAC;AAC7G,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAG5F,4EAA4E;AAC5E,MAAM,UAAU,mCAAmC,CACjD,KAAsC,EACtC,SAAwB;IAExB,MAAM,UAAU,GAAG,KAAK,CAAC,mBAAmB,CAAC;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;QAC5C,IACE,KAAK,CAAC,mBAAmB,KAAK,UAAU;YACxC,0BAA0B,CAAC,KAAK,CAAC;YAEjC,OAAO;QAET,MAAM,yCAAyC,CAC7C,KAAK,EACL,OAAO,CAAC,IAAI,CAAC,sBAAsB,EACnC;YACE,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,WAAW;YACvB,SAAS,EAAE,gCAAgC;YAC3C,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc;SAC5C,CACF,CAAC;QACF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,uCAAuC,CAAC;YACxD,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC1B,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;QAC1E,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { reportKeyingVerificationErrorInCauseChain } from \"../../../data/keyingProjectionVerification/error\";\nimport { errorMessage } from \"../../../data/shared/errorMessage\";\nimport { isDatabaseUnavailableError } from \"../../../workflows/container-contents/syncLane\";\nimport type { ContainerContentsStoreSyncState } from \"../syncAgent/syncAgentTypes\";\n\n/** Observe a background refresh without changing the caller's rejection. */\nexport function observeContainerBackgroundHydration(\n  state: ContainerContentsStoreSyncState,\n  hydration: Promise<void>,\n): void {\n  const generation = state.lifecycleGeneration;\n  const runtime = state.runtime;\n  void hydration.catch(async (error: unknown) => {\n    if (\n      state.lifecycleGeneration !== generation ||\n      isDatabaseUnavailableError(error)\n    )\n      return;\n\n    await reportKeyingVerificationErrorInCauseChain(\n      error,\n      runtime.util.reportSecurityIncident,\n      {\n        objectId: null,\n        objectKind: \"container\",\n        operation: \"container.hydration.background\",\n        organizationId: runtime.auth.organizationId,\n      },\n    );\n    try {\n      const message = \"Container background hydration failed\";\n      if (runtime.util.logError) {\n        await runtime.util.logError(message, error);\n      } else {\n        await runtime.util.log(`${message}: ${errorMessage(error)}`);\n      }\n    } catch {\n      // A host logger must not turn an observed refusal into a new rejection.\n    }\n  });\n}\n"]}

package/stores/container-contents/{remoteHydrationRequest.js → hydration/remoteHydrationRequest.js}

@@ -1,6 +1,6 @@
-import { createGenerationGuardedHydrationHost, hydrateRemoteContainers, StaleRemoteHydrationError, } from "../../workflows/container-contents/remoteHydration/index.js";
-import { isDatabaseUnavailableError } from "../../workflows/container-contents/syncLane.js";
-import { refreshLocalContainerStates, } from "./localRefresh.js";
+import { createGenerationGuardedHydrationHost, hydrateRemoteContainers, StaleRemoteHydrationError, } from "../../../workflows/container-contents/remoteHydration/index.js";
+import { isDatabaseUnavailableError } from "../../../workflows/container-contents/syncLane.js";
+import { refreshLocalContainerStates, } from "../localRefresh.js";
 function isRequestGenerationCurrent(input) {
     return (input.state.lifecycleGeneration === input.lifecycleGeneration &&
         input.state.structuralGeneration === input.structuralGeneration);

package/stores/container-contents/hydration/remoteHydrationRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteHydrationRequest.js","sourceRoot":"","sources":["remoteHydrationRequest.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createGenerationGuardedHydrationHost,\n  hydrateRemoteContainers,\n  type RemoteContainerHydrationHost,\n  StaleRemoteHydrationError,\n} from \"../../../workflows/container-contents/remoteHydration\";\nimport type { RemoteContainerHydrationState } from \"../../../workflows/container-contents/remoteHydration/types\";\nimport { isDatabaseUnavailableError } from \"../../../workflows/container-contents/syncLane\";\nimport {\n  type LocalContainerRefreshState,\n  refreshLocalContainerStates,\n} from \"../localRefresh\";\n\ntype RemoteHydrationRequestState = RemoteContainerHydrationState &\n  LocalContainerRefreshState & {\n    containerParentIdsNeedingHydration: Set<string | null>;\n    initializePromise: Promise<void> | null;\n    lifecycleGeneration: number;\n    remoteHydrationGeneration: number | null;\n    remoteHydrationPromise: Promise<void> | null;\n    remoteHydrationStructuralGeneration: number | null;\n    rootLaneHydrated: boolean;\n    snapshot: {\n      ready: boolean;\n    };\n    structuralGeneration: number;\n  };\n\ninterface RemoteHydrationRequestInput {\n  followDiscoveredParentLanes?: boolean | undefined;\n  host: RemoteContainerHydrationHost;\n  onFullyHydrated?: (() => Promise<void> | void) | undefined;\n  parentIds?: ReadonlyArray<string | null> | undefined;\n  resetAllLaneWatermarks?: boolean | undefined;\n  resetRootLaneWatermark?: boolean | undefined;\n  recreateOnFullyHydratedAfterReset?:\n    | (() => () => Promise<void> | void)\n    | undefined;\n  recreateOnFullyHydratedAtStart?: boolean | undefined;\n  resumeRecoveryWork: () => Promise<void>;\n  scheduleSyncAfterHydration?: boolean | undefined;\n  scheduleSyncOnHydrationChange?: boolean | undefined;\n  scheduleSync: () => void;\n  state: RemoteHydrationRequestState;\n}\n\ninterface RecoveryHydrationRequest {\n  input: RemoteHydrationRequestInput;\n  lifecycleGeneration: number;\n  structuralGeneration: number;\n}\n\nfunction isRequestGenerationCurrent(input: {\n  lifecycleGeneration: number;\n  state: RemoteHydrationRequestState;\n  structuralGeneration: number;\n}): boolean {\n  return (\n    input.state.lifecycleGeneration === input.lifecycleGeneration &&\n    input.state.structuralGeneration === input.structuralGeneration\n  );\n}\n\nconst recoveryHydrationRequestsByState = new WeakMap<\n  RemoteHydrationRequestState,\n  RecoveryHydrationRequest[]\n>();\nfunction queueRecoveryHydrationRequest(\n  input: RemoteHydrationRequestInput,\n): void {\n  const requests = recoveryHydrationRequestsByState.get(input.state);\n  if (requests) {\n    if (!requests.some((request) => request.input === input)) {\n      requests.push({\n        input,\n        lifecycleGeneration: input.state.lifecycleGeneration,\n        structuralGeneration: input.state.structuralGeneration,\n      });\n    }\n    return;\n  }\n  recoveryHydrationRequestsByState.set(input.state, [\n    {\n      input,\n      lifecycleGeneration: input.state.lifecycleGeneration,\n      structuralGeneration: input.state.structuralGeneration,\n    },\n  ]);\n}\n\nfunction hasRemoteHydrationPrerequisites(\n  state: RemoteHydrationRequestState,\n): boolean {\n  return (\n    state.runtime.infra.dbStatus === \"ready\" &&\n    state.runtime.auth.isAuthenticated &&\n    state.runtime.state.online\n  );\n}\n\nfunction createResetRecoveryInput(\n  input: RemoteHydrationRequestInput,\n): RemoteHydrationRequestInput {\n  return {\n    ...input,\n    followDiscoveredParentLanes: true,\n    onFullyHydrated: undefined,\n    parentIds: undefined,\n    recreateOnFullyHydratedAtStart: true,\n  };\n}\n\nfunction resumeRetainedRecoveryHydration(\n  input: RemoteHydrationRequestInput,\n): Promise<void> {\n  queueRecoveryHydrationRequest(input);\n  return hasRemoteHydrationPrerequisites(input.state)\n    ? input.resumeRecoveryWork()\n    : Promise.resolve();\n}\n\nfunction waitForActiveRemoteHydration(\n  input: RemoteHydrationRequestInput,\n): Promise<void> | null {\n  const { state } = input;\n  const activeHydration = state.remoteHydrationPromise;\n  if (!activeHydration) {\n    return null;\n  }\n  const requestLifecycleGeneration = state.lifecycleGeneration;\n  const requestStructuralGeneration = state.structuralGeneration;\n  const needsCurrentGenerationHydration =\n    state.remoteHydrationGeneration !== state.lifecycleGeneration ||\n    state.remoteHydrationStructuralGeneration !== state.structuralGeneration;\n  const requestQueuedHydration = () => {\n    if (\n      !isRequestGenerationCurrent({\n        lifecycleGeneration: requestLifecycleGeneration,\n        state,\n        structuralGeneration: requestStructuralGeneration,\n      })\n    ) {\n      return retryRemoteHydrationAfterReset(input);\n    }\n    return needsCurrentGenerationHydration ||\n      state.containerParentIdsNeedingHydration.size > 0\n      ? requestContainerContentsRemoteHydration(input)\n      : undefined;\n  };\n  return activeHydration.then(\n    requestQueuedHydration,\n    (error: unknown) => requestQueuedHydration() ?? Promise.reject(error),\n  );\n}\n\nfunction waitForActiveInitialization(\n  input: RemoteHydrationRequestInput,\n): Promise<void> | null {\n  const { state } = input;\n  const activeInitialization = state.initializePromise;\n  if (!activeInitialization) {\n    return null;\n  }\n  const requestLifecycleGeneration = state.lifecycleGeneration;\n  const requestStructuralGeneration = state.structuralGeneration;\n  return activeInitialization.then(() => {\n    const recoveryInput = isRequestGenerationCurrent({\n      lifecycleGeneration: requestLifecycleGeneration,\n      state,\n      structuralGeneration: requestStructuralGeneration,\n    })\n      ? input\n      : createResetRecoveryInput(input);\n    return resumeRetainedRecoveryHydration(recoveryInput);\n  });\n}\n\nfunction retryRemoteHydrationAfterReset(\n  input: RemoteHydrationRequestInput,\n): Promise<void> {\n  return resumeRetainedRecoveryHydration(createResetRecoveryInput(input));\n}\n\nfunction retainResetRecoveryHydration(\n  input: RemoteHydrationRequestInput,\n): void {\n  queueRecoveryHydrationRequest(createResetRecoveryInput(input));\n}\n\nexport function resumeContainerContentsRecoveryHydration(\n  state: RemoteHydrationRequestState,\n): Promise<void> | null {\n  const requests = recoveryHydrationRequestsByState.get(state);\n  if (!requests) {\n    return null;\n  }\n  recoveryHydrationRequestsByState.delete(state);\n  const inputs = requests.map((request) =>\n    isRequestGenerationCurrent({\n      lifecycleGeneration: request.lifecycleGeneration,\n      state,\n      structuralGeneration: request.structuralGeneration,\n    })\n      ? request.input\n      : createResetRecoveryInput(request.input),\n  );\n  return Promise.all(inputs.map(requestContainerContentsRemoteHydration))\n    .then(() => undefined)\n    .catch((error: unknown) => {\n      for (const input of inputs) {\n        queueRecoveryHydrationRequest(input);\n      }\n      throw error;\n    });\n}\n\nfunction queueRequestedParentIds(input: RemoteHydrationRequestInput): void {\n  if (!input.parentIds) {\n    return;\n  }\n  for (const parentId of input.parentIds) {\n    input.state.containerParentIdsNeedingHydration.add(parentId);\n  }\n}\n\nfunction waitForRemoteHydrationReadiness(\n  input: RemoteHydrationRequestInput,\n): Promise<void> | null {\n  const activeHydration = waitForActiveRemoteHydration(input);\n  if (activeHydration) {\n    return activeHydration;\n  }\n  const activeInitialization = waitForActiveInitialization(input);\n  if (activeInitialization) {\n    return activeInitialization;\n  }\n  if (!hasRemoteHydrationPrerequisites(input.state)) {\n    queueRecoveryHydrationRequest(input);\n    return Promise.resolve();\n  }\n  return null;\n}\n\nfunction consumeQueuedHydrationScope(\n  state: RemoteHydrationRequestState,\n  followDiscoveredParentLanesOption: boolean | undefined,\n): {\n  followDiscoveredParentLanes: boolean;\n  parentIds: ReadonlyArray<string | null> | undefined;\n} {\n  const queuedParentIds = Array.from(state.containerParentIdsNeedingHydration);\n  const followDiscoveredParentLanes =\n    followDiscoveredParentLanesOption ?? queuedParentIds.length === 0;\n  state.containerParentIdsNeedingHydration.clear();\n  return {\n    followDiscoveredParentLanes,\n    parentIds:\n      followDiscoveredParentLanes || queuedParentIds.length === 0\n        ? undefined\n        : queuedParentIds,\n  };\n}\n\nexport function requestContainerContentsRemoteHydration(\n  input: RemoteHydrationRequestInput,\n): Promise<void> {\n  const { host, scheduleSync, state } = input;\n  queueRequestedParentIds(input);\n  const readinessBarrier = waitForRemoteHydrationReadiness(input);\n  if (readinessBarrier) {\n    return readinessBarrier;\n  }\n\n  const { followDiscoveredParentLanes, parentIds } =\n    consumeQueuedHydrationScope(state, input.followDiscoveredParentLanes);\n\n  let appliedRemoteContainerChange = false;\n  let retainInterruptedHydration = false;\n  const lifecycleGeneration = state.lifecycleGeneration;\n  const structuralGeneration = state.structuralGeneration;\n  const isCurrent = () =>\n    isRequestGenerationCurrent({\n      lifecycleGeneration,\n      state,\n      structuralGeneration,\n    });\n  const onFullyHydrated = input.recreateOnFullyHydratedAtStart\n    ? input.recreateOnFullyHydratedAfterReset?.()\n    : input.onFullyHydrated;\n  const hydrationHost = createGenerationGuardedHydrationHost({\n    host,\n    isCurrent,\n  });\n  const rootLaneHydratedBeforeRequest = state.rootLaneHydrated;\n  state.remoteHydrationGeneration = lifecycleGeneration;\n  state.remoteHydrationStructuralGeneration = structuralGeneration;\n  const hydrationPromise = refreshLocalContainerStates({\n    host: hydrationHost,\n    state,\n  })\n    .then(() => {\n      if (!isCurrent()) {\n        return 0;\n      }\n      return hydrateRemoteContainers({\n        followDiscoveredParentLanes,\n        host: hydrationHost,\n        isCurrent,\n        onFullyHydrated,\n        parentIds,\n        resetAllLaneWatermarks: input.resetAllLaneWatermarks,\n        resetRootLaneWatermark: input.resetRootLaneWatermark,\n        state,\n      });\n    })\n    .then((changedCount) => {\n      appliedRemoteContainerChange = changedCount > 0;\n      if (isCurrent() && !hasRemoteHydrationPrerequisites(state)) {\n        retainInterruptedHydration = true;\n      }\n    })\n    .catch((error: unknown) => {\n      if (isCurrent() && isDatabaseUnavailableError(error)) {\n        retainInterruptedHydration = true;\n        return;\n      }\n      if (!isCurrent() || error instanceof StaleRemoteHydrationError) {\n        return;\n      }\n\n      throw error;\n    })\n    .finally(() => {\n      const shouldRetryAfterReset = !isCurrent();\n      if (state.remoteHydrationPromise === hydrationPromise) {\n        state.remoteHydrationPromise = null;\n        state.remoteHydrationGeneration = null;\n        state.remoteHydrationStructuralGeneration = null;\n      }\n\n      if (\n        isCurrent() &&\n        (((input.scheduleSyncOnHydrationChange ?? true) &&\n          (appliedRemoteContainerChange ||\n            (!rootLaneHydratedBeforeRequest && state.rootLaneHydrated))) ||\n          input.scheduleSyncAfterHydration) &&\n        state.snapshot.ready &&\n        state.runtime.auth.isAuthenticated &&\n        state.runtime.state.online\n      ) {\n        scheduleSync();\n      }\n      if (shouldRetryAfterReset) {\n        return retryRemoteHydrationAfterReset(input);\n      }\n      if (retainInterruptedHydration) {\n        retainResetRecoveryHydration(input);\n      }\n      return undefined;\n    });\n  state.remoteHydrationPromise = hydrationPromise;\n\n  return hydrationPromise;\n}\n"]}

package/stores/container-contents/{startupHydration.js → hydration/startupHydration.js}

@@ -1,6 +1,6 @@
-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";
+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);

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/{containerPurgeCore.js → operations/containerPurgeCore.js}

@@ -1,7 +1,7 @@
-import { purgeContainerTree } from "../../workflows/container-contents/container-state/purgeTree.js";
-import { prepareContainerDocumentRotationSnapshot } from "./documentRotation.js";
-import { getContainerContentsStoreLogLabel } from "./logLabel.js";
-import { updateContainerContentsSnapshot } from "./state.js";
+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();

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"]}