@tearleads/client-sdk 0.1.36 → 0.1.37

package/sync/reconciliation/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["service.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  getOrCreateDomainSyncCoordinator,\n  type SyncLane,\n} from \"../../data/sync/syncCoordinator\";\nimport {\n  acknowledgeContainerForce,\n  activateContainer,\n  enqueueKnownContainersForIdleBackfill,\n  type IdleBackfillState,\n  markContainerForced,\n} from \"./idleBackfill\";\nimport { createInitialDocumentProbe } from \"./initialDocumentProbe\";\nimport {\n  clearPendingDiscoveryRetries,\n  isCurrentReconciliationLifecycle,\n  reconcileMarkedContainer,\n  sweepKnownContainers,\n} from \"./knownContainerSweep\";\nimport { rearmFailedContainer } from \"./laneFailure\";\nimport { clearOriginatedDocuments } from \"./originatedDocuments\";\nimport { createReconcileQueue, type ReconcilePriority } from \"./queue\";\nimport type {\n  ReconciliationHost,\n  ReconciliationRuntimeStatus,\n  ReconciliationService,\n} from \"./serviceTypes\";\n\nfunction canReconcile(status: ReconciliationRuntimeStatus): boolean {\n  return status.dbStatus === \"ready\" && status.isAuthenticated && status.online;\n}\n\ntype RefreshScope = \"root\" | \"full\";\n\ninterface ReconciliationState extends IdleBackfillState {\n  active: boolean;\n  lane: SyncLane | null;\n  lifecycleGeneration: number;\n  probeContinuationCancel: (() => void) | null;\n  pendingRefresh: {\n    readonly promise: Promise<void>;\n    readonly scope: RefreshScope;\n  } | null;\n}\n\nasync function runReconcileLane(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): Promise<void> {\n  if (!state.active || !canReconcile(host.getRuntimeStatus())) {\n    return;\n  }\n  const lifecycleGeneration = state.lifecycleGeneration;\n\n  const containerId = state.queue.dequeue();\n  if (!containerId) {\n    await state.initialDocumentProbe.run();\n    scheduleProbeContinuation(host, state);\n    return;\n  }\n  // Double-check at run time: a container may have been discovered (by an\n  // explicit refresh or an earlier lane pass) after it was queued. Mark it\n  // discovered up front to collapse concurrent re-enqueues into one fetch, but\n  // roll the mark back on failure so a transient error can be retried later.\n  const forceGeneration = state.forcedContainerGenerations.get(containerId);\n  const shouldForce = forceGeneration !== undefined;\n  if (shouldForce || !state.discoveredContainerIds.has(containerId)) {\n    state.discoveredContainerIds.add(containerId);\n    try {\n      const reconciled = await reconcileMarkedContainer(\n        host,\n        state,\n        containerId,\n        shouldForce,\n      );\n      if (reconciled) {\n        acknowledgeContainerForce(state, containerId, forceGeneration);\n      }\n    } catch (error) {\n      rearmFailedContainer(\n        state,\n        containerId,\n        forceGeneration,\n        lifecycleGeneration,\n      );\n      throw error;\n    }\n  }\n\n  // Keep draining: schedule another pass while the queue holds work.\n  if (state.queue.size > 0) {\n    state.lane?.requestSync();\n  } else {\n    scheduleProbeContinuation(host, state);\n  }\n}\n\nfunction scheduleProbeContinuation(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): void {\n  state.probeContinuationCancel?.();\n  const canContinue = () =>\n    state.active &&\n    state.queue.size === 0 &&\n    canReconcile(host.getRuntimeStatus()) &&\n    state.initialDocumentProbe.hasPendingWork();\n  if (!canContinue()) {\n    state.probeContinuationCancel = null;\n    return;\n  }\n  const timeout = setTimeout(() => {\n    if (canContinue()) {\n      state.probeContinuationCancel = null;\n      state.lane?.requestSync();\n    }\n  }, state.initialDocumentProbe.continuationDelayMs());\n  state.probeContinuationCancel = () => clearTimeout(timeout);\n}\n\nfunction forgetIneligibleDiscoveredContainers(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): void {\n  for (const containerId of state.discoveredContainerIds) {\n    if (!host.canDiscoverContainerDocuments(containerId)) {\n      state.discoveredContainerIds.delete(containerId);\n    }\n  }\n}\n\nasync function refreshAndReconcileContainers(input: {\n  forceAllDocumentContentPulls: boolean;\n  host: ReconciliationHost;\n  listContainerIds: () => ReadonlyArray<string>;\n  refreshTree: () => Promise<void>;\n  state: ReconciliationState;\n}): Promise<void> {\n  const { host, listContainerIds, refreshTree, state } = input;\n  if (!canReconcile(host.getRuntimeStatus())) {\n    return;\n  }\n  const lifecycleGeneration = state.lifecycleGeneration;\n\n  if (input.forceAllDocumentContentPulls) {\n    state.queue.clear();\n  }\n  try {\n    // A resync_required structural refresh runs independently of this service.\n    // If it already removed a container after the forced document lane won its\n    // race against the old tree, forget the stale discovered bit before this\n    // refresh can re-add the same id.\n    forgetIneligibleDiscoveredContainers(host, state);\n    await refreshTree();\n    if (!isCurrentReconciliationLifecycle(state, lifecycleGeneration)) {\n      return;\n    }\n    // Structural hydration can revoke and remove a container after a targeted\n    // force already reconciled it against the old tree. Forget every id that\n    // is no longer remotely listable so a later share of the same container id\n    // is treated as newly surfaced instead of being suppressed for the rest of\n    // the session.\n    forgetIneligibleDiscoveredContainers(host, state);\n    await sweepKnownContainers({\n      forceAllDocumentContentPulls: input.forceAllDocumentContentPulls,\n      host,\n      knownIds: listContainerIds(),\n      lifecycleGeneration,\n      state,\n    });\n    if (!isCurrentReconciliationLifecycle(state, lifecycleGeneration)) {\n      return;\n    }\n  } catch (error) {\n    if (!isCurrentReconciliationLifecycle(state, lifecycleGeneration)) {\n      return;\n    }\n    if (!host.isIgnorableError(error)) {\n      throw error;\n    }\n  }\n}\n\n// Sweeps share the queue and discovered set, so they must run serially.\n// Root requests join either kind of sweep; a full request after a root sweep\n// must wait for it and then refresh the whole tree.\nfunction requestContainerRefresh(input: {\n  host: ReconciliationHost;\n  state: ReconciliationState;\n  refreshTree: () => Promise<void>;\n  listContainerIds: () => ReadonlyArray<string>;\n  scope: RefreshScope;\n}): Promise<void> {\n  const { state, scope } = input;\n  const pending = state.pendingRefresh;\n  if (pending && (scope === \"root\" || pending.scope === \"full\")) {\n    return pending.promise;\n  }\n\n  const promise = (pending?.promise ?? Promise.resolve())\n    // A failed root sweep must not prevent the queued full refresh.\n    .catch(() => undefined)\n    .then(() =>\n      refreshAndReconcileContainers({\n        forceAllDocumentContentPulls: scope === \"full\",\n        host: input.host,\n        listContainerIds: input.listContainerIds,\n        refreshTree: input.refreshTree,\n        state,\n      }),\n    )\n    .finally(() => {\n      if (state.pendingRefresh?.promise === promise) {\n        state.pendingRefresh = null;\n      }\n    });\n  state.pendingRefresh = { promise, scope };\n  return promise;\n}\n\nfunction listFullRefreshContainerIds(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): ReadonlyArray<string> {\n  const knownIds = host.listKnownContainerIds();\n  const activeContainerId = state.activeContainerId;\n  if (\n    !activeContainerId ||\n    knownIds.includes(activeContainerId) ||\n    !host.canDiscoverContainerDocuments(activeContainerId)\n  ) {\n    return knownIds;\n  }\n  // Explicit refresh also retries an open foreign system container that the\n  // background discovery list excludes.\n  return [...knownIds, activeContainerId];\n}\n\nfunction startReconciliationLane(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): void {\n  if (state.active) {\n    return;\n  }\n  state.lifecycleGeneration += 1;\n  state.active = true;\n  state.lane = getOrCreateDomainSyncCoordinator(host.domainScope).registerLane(\n    \"reconciliation:documents\",\n    {\n      label: \"Device-first document reconciliation\",\n      // Document discovery runs in the document phase, after structural\n      // container hydration/metadata sync settles for the scope.\n      phase: \"document\",\n      priority: () => (state.activeContainerId ? -1 : 0),\n      onUnexpectedError: (error) => {\n        console.error(\"Device-first reconciliation failed:\", error);\n      },\n      // Fixed literal: no container or document id may reach a report. The\n      // mapped stack identifies which lane body threw. Returning the host's\n      // result hands a rejection to the lane reporter's wrapper; discarding it\n      // would surface as an unhandled rejection instead.\n      reportUnexpectedError: (error) =>\n        host.logError?.(\"Reconciliation: sync lane failed\", error),\n      run: () => runReconcileLane(host, state),\n      shouldIgnoreError: host.isIgnorableError,\n    },\n  );\n}\n\nfunction createReconciliationState(\n  host: ReconciliationHost,\n): ReconciliationState {\n  return {\n    active: false,\n    activeContainerId: null,\n    automaticRetryGenerations: new Map(),\n    discoveredContainerIds: new Set(),\n    forcedContainerGenerations: new Map(),\n    forcedDocumentIds: new Map(),\n    initialDocumentProbe: createInitialDocumentProbe(host),\n    lane: null,\n    lifecycleGeneration: 0,\n    nextForceGeneration: 0,\n    probeContinuationCancel: null,\n    queue: createReconcileQueue(),\n    pendingRefresh: null,\n  };\n}\n\nfunction stopReconciliationService(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): void {\n  clearPendingDiscoveryRetries(state);\n  state.active = false;\n  state.probeContinuationCancel?.();\n  state.probeContinuationCancel = null;\n  state.queue.clear();\n  state.automaticRetryGenerations.clear();\n  state.forcedContainerGenerations.clear();\n  state.forcedDocumentIds.clear();\n  state.pendingRefresh = null;\n  state.initialDocumentProbe.resetPending();\n  // Drop the per-session discovered suppression cache too: a stopped\n  // reconciler is being torn down (scope/identity change) or paused across\n  // a prerequisite loss, after which every container must be re-validated.\n  state.discoveredContainerIds.clear();\n  // Drop pending self-echo originations too — they are session-scoped and a\n  // teardown invalidates them.\n  clearOriginatedDocuments(host.domainScope);\n}\n\nexport function createReconciliationService(\n  host: ReconciliationHost,\n): ReconciliationService {\n  const state = createReconciliationState(host);\n\n  const scheduleDrain = () => {\n    if (\n      !state.active ||\n      (state.queue.size === 0 && !state.initialDocumentProbe.canRun())\n    ) {\n      return;\n    }\n    if (!canReconcile(host.getRuntimeStatus())) {\n      return;\n    }\n    state.probeContinuationCancel?.();\n    state.probeContinuationCancel = null;\n    state.lane?.requestSync();\n  };\n\n  const enqueueContainer = (\n    containerId: string,\n    priority: ReconcilePriority,\n    force = false,\n    documentId?: string,\n  ) => {\n    if (!containerId) {\n      return;\n    }\n    // Skip containers already reconciled this session unless forced. Events\n    // force re-discovery; passive active/backfill scheduling does not, so\n    // opening Explorer does not re-fetch every container on each navigation.\n    if (\n      !force &&\n      !state.forcedContainerGenerations.has(containerId) &&\n      state.discoveredContainerIds.has(containerId)\n    ) {\n      return;\n    }\n    if (force) {\n      markContainerForced(state, containerId, documentId);\n    }\n    state.queue.enqueue(containerId, priority);\n    scheduleDrain();\n  };\n\n  const enqueueIdleBackfill = () => {\n    enqueueKnownContainersForIdleBackfill({\n      host,\n      scheduleDrain,\n      state,\n    });\n  };\n\n  return {\n    start: () => {\n      startReconciliationLane(host, state);\n      scheduleDrain();\n    },\n    // Reconcile the active container first; siblings remain lazy until visited.\n    setActiveContainer: (containerId) =>\n      activateContainer(state, containerId, (activeId) =>\n        enqueueContainer(activeId, \"active\"),\n      ),\n    enqueueContainer,\n    enqueueIdleBackfill,\n    resetDiscovered: () => {\n      state.discoveredContainerIds.clear();\n      state.initialDocumentProbe.resetSkippedListings();\n    },\n    reconcileRootContainersNow: () =>\n      requestContainerRefresh({\n        host,\n        state,\n        refreshTree: host.refreshRootTree,\n        listContainerIds: host.listAutomaticRootCatchupContainerIds,\n        scope: \"root\",\n      }),\n    reconcileNow: () =>\n      requestContainerRefresh({\n        host,\n        state,\n        refreshTree: host.refreshTree,\n        listContainerIds: () => listFullRefreshContainerIds(host, state),\n        scope: \"full\",\n      }),\n    stop: () => stopReconciliationService(host, state),\n  };\n}\n"]}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["service.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  getOrCreateDomainSyncCoordinator,\n  type SyncLane,\n} from \"../../data/sync/syncCoordinator\";\nimport {\n  acknowledgeContainerForce,\n  activateContainer,\n  enqueueKnownContainersForIdleBackfill,\n  type IdleBackfillState,\n  markContainerForced,\n} from \"./idleBackfill\";\nimport { createInitialDocumentProbe } from \"./initialDocumentProbe\";\nimport {\n  clearPendingDiscoveryRetries,\n  isCurrentReconciliationLifecycle,\n  reconcileMarkedContainer,\n  sweepKnownContainers,\n} from \"./knownContainerSweep\";\nimport { rearmFailedContainer } from \"./laneFailure\";\nimport { clearOriginatedDocuments } from \"./originatedDocuments\";\nimport { createReconcileQueue, type ReconcilePriority } from \"./queue\";\nimport type {\n  ReconciliationHost,\n  ReconciliationRuntimeStatus,\n  ReconciliationService,\n} from \"./serviceTypes\";\n\nfunction canReconcile(status: ReconciliationRuntimeStatus): boolean {\n  return status.dbStatus === \"ready\" && status.isAuthenticated && status.online;\n}\n\ntype RefreshScope = \"root\" | \"full\";\n\ninterface ReconciliationState extends IdleBackfillState {\n  active: boolean;\n  lane: SyncLane | null;\n  lifecycleGeneration: number;\n  probeContinuationCancel: (() => void) | null;\n  pendingRefresh: {\n    readonly promise: Promise<void>;\n    readonly scope: RefreshScope;\n    readonly started: { value: boolean };\n  } | null;\n}\n\nasync function runReconcileLane(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): Promise<void> {\n  if (!state.active || !canReconcile(host.getRuntimeStatus())) {\n    return;\n  }\n  const lifecycleGeneration = state.lifecycleGeneration;\n\n  const containerId = state.queue.dequeue();\n  if (!containerId) {\n    await state.initialDocumentProbe.run();\n    scheduleProbeContinuation(host, state);\n    return;\n  }\n  // Double-check at run time: a container may have been discovered (by an\n  // explicit refresh or an earlier lane pass) after it was queued. Mark it\n  // discovered up front to collapse concurrent re-enqueues into one fetch, but\n  // roll the mark back on failure so a transient error can be retried later.\n  const forceGeneration = state.forcedContainerGenerations.get(containerId);\n  const shouldForce = forceGeneration !== undefined;\n  if (shouldForce || !state.discoveredContainerIds.has(containerId)) {\n    state.discoveredContainerIds.add(containerId);\n    try {\n      const reconciled = await reconcileMarkedContainer(\n        host,\n        state,\n        containerId,\n        shouldForce,\n      );\n      if (reconciled) {\n        acknowledgeContainerForce(state, containerId, forceGeneration);\n      }\n    } catch (error) {\n      rearmFailedContainer(\n        state,\n        containerId,\n        forceGeneration,\n        lifecycleGeneration,\n      );\n      throw error;\n    }\n  }\n\n  // Keep draining: schedule another pass while the queue holds work.\n  if (state.queue.size > 0) {\n    state.lane?.requestSync();\n  } else {\n    scheduleProbeContinuation(host, state);\n  }\n}\n\nfunction scheduleProbeContinuation(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): void {\n  state.probeContinuationCancel?.();\n  const canContinue = () =>\n    state.active &&\n    state.queue.size === 0 &&\n    canReconcile(host.getRuntimeStatus()) &&\n    state.initialDocumentProbe.hasPendingWork();\n  if (!canContinue()) {\n    state.probeContinuationCancel = null;\n    return;\n  }\n  const timeout = setTimeout(() => {\n    if (canContinue()) {\n      state.probeContinuationCancel = null;\n      state.lane?.requestSync();\n    }\n  }, state.initialDocumentProbe.continuationDelayMs());\n  state.probeContinuationCancel = () => clearTimeout(timeout);\n}\n\nfunction forgetIneligibleDiscoveredContainers(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): void {\n  for (const containerId of state.discoveredContainerIds) {\n    if (!host.canDiscoverContainerDocuments(containerId)) {\n      state.discoveredContainerIds.delete(containerId);\n    }\n  }\n}\n\nasync function refreshAndReconcileContainers(input: {\n  forceAllDocumentContentPulls: boolean;\n  host: ReconciliationHost;\n  listContainerIds: () => ReadonlyArray<string>;\n  refreshTree: () => Promise<void>;\n  state: ReconciliationState;\n}): Promise<void> {\n  const { host, listContainerIds, refreshTree, state } = input;\n  if (!canReconcile(host.getRuntimeStatus())) {\n    return;\n  }\n  const lifecycleGeneration = state.lifecycleGeneration;\n\n  if (input.forceAllDocumentContentPulls) {\n    state.queue.clear();\n  }\n  try {\n    // A resync_required structural refresh runs independently of this service.\n    // If it already removed a container after the forced document lane won its\n    // race against the old tree, forget the stale discovered bit before this\n    // refresh can re-add the same id.\n    forgetIneligibleDiscoveredContainers(host, state);\n    await refreshTree();\n    if (!isCurrentReconciliationLifecycle(state, lifecycleGeneration)) {\n      return;\n    }\n    // Structural hydration can revoke and remove a container after a targeted\n    // force already reconciled it against the old tree. Forget every id that\n    // is no longer remotely listable so a later share of the same container id\n    // is treated as newly surfaced instead of being suppressed for the rest of\n    // the session.\n    forgetIneligibleDiscoveredContainers(host, state);\n    await sweepKnownContainers({\n      forceAllDocumentContentPulls: input.forceAllDocumentContentPulls,\n      host,\n      knownIds: listContainerIds(),\n      lifecycleGeneration,\n      state,\n    });\n    if (!isCurrentReconciliationLifecycle(state, lifecycleGeneration)) {\n      return;\n    }\n  } catch (error) {\n    if (!isCurrentReconciliationLifecycle(state, lifecycleGeneration)) {\n      return;\n    }\n    if (!host.isIgnorableError(error)) {\n      throw error;\n    }\n  }\n}\n\n// Sweeps share the queue and discovered set, so they must run serially.\n// Root requests join either kind of sweep; a full request after a root sweep\n// must wait for it and then refresh the whole tree. A fresh-listing request\n// joins only a sweep that has not started: one already running may have listed\n// before the event behind the request, so it queues a trailing sweep instead.\nfunction requestContainerRefresh(input: {\n  freshListing: boolean;\n  host: ReconciliationHost;\n  state: ReconciliationState;\n  refreshTree: () => Promise<void>;\n  listContainerIds: () => ReadonlyArray<string>;\n  scope: RefreshScope;\n}): Promise<void> {\n  const { state, scope } = input;\n  const pending = state.pendingRefresh;\n  if (\n    pending &&\n    (scope === \"root\" || pending.scope === \"full\") &&\n    !(input.freshListing && pending.started.value)\n  ) {\n    return pending.promise;\n  }\n\n  const started = { value: false };\n  const promise = (pending?.promise ?? Promise.resolve())\n    // A failed earlier sweep must not prevent the queued refresh.\n    .catch(() => undefined)\n    .then(() => {\n      started.value = true;\n      return refreshAndReconcileContainers({\n        forceAllDocumentContentPulls: scope === \"full\",\n        host: input.host,\n        listContainerIds: input.listContainerIds,\n        refreshTree: input.refreshTree,\n        state,\n      });\n    })\n    .finally(() => {\n      if (state.pendingRefresh?.promise === promise) {\n        state.pendingRefresh = null;\n      }\n    });\n  state.pendingRefresh = { promise, scope, started };\n  return promise;\n}\n\nfunction listFullRefreshContainerIds(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): ReadonlyArray<string> {\n  const knownIds = host.listKnownContainerIds();\n  const activeContainerId = state.activeContainerId;\n  if (\n    !activeContainerId ||\n    knownIds.includes(activeContainerId) ||\n    !host.canDiscoverContainerDocuments(activeContainerId)\n  ) {\n    return knownIds;\n  }\n  // Explicit refresh also retries an open foreign system container that the\n  // background discovery list excludes.\n  return [...knownIds, activeContainerId];\n}\n\nfunction startReconciliationLane(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): void {\n  if (state.active) {\n    return;\n  }\n  state.lifecycleGeneration += 1;\n  state.active = true;\n  state.lane = getOrCreateDomainSyncCoordinator(host.domainScope).registerLane(\n    \"reconciliation:documents\",\n    {\n      label: \"Device-first document reconciliation\",\n      // Document discovery runs in the document phase, after structural\n      // container hydration/metadata sync settles for the scope.\n      phase: \"document\",\n      priority: () => (state.activeContainerId ? -1 : 0),\n      onUnexpectedError: (error) => {\n        console.error(\"Device-first reconciliation failed:\", error);\n      },\n      // Fixed literal: no container or document id may reach a report. The\n      // mapped stack identifies which lane body threw. Returning the host's\n      // result hands a rejection to the lane reporter's wrapper; discarding it\n      // would surface as an unhandled rejection instead.\n      reportUnexpectedError: (error) =>\n        host.logError?.(\"Reconciliation: sync lane failed\", error),\n      run: () => runReconcileLane(host, state),\n      shouldIgnoreError: host.isIgnorableError,\n    },\n  );\n}\n\nfunction createReconciliationState(\n  host: ReconciliationHost,\n): ReconciliationState {\n  return {\n    active: false,\n    activeContainerId: null,\n    automaticRetryGenerations: new Map(),\n    discoveredContainerIds: new Set(),\n    forcedContainerGenerations: new Map(),\n    forcedDocumentIds: new Map(),\n    initialDocumentProbe: createInitialDocumentProbe(host),\n    lane: null,\n    lifecycleGeneration: 0,\n    nextForceGeneration: 0,\n    probeContinuationCancel: null,\n    queue: createReconcileQueue(),\n    pendingRefresh: null,\n  };\n}\n\nfunction stopReconciliationService(\n  host: ReconciliationHost,\n  state: ReconciliationState,\n): void {\n  clearPendingDiscoveryRetries(state);\n  state.active = false;\n  state.probeContinuationCancel?.();\n  state.probeContinuationCancel = null;\n  state.queue.clear();\n  state.automaticRetryGenerations.clear();\n  state.forcedContainerGenerations.clear();\n  state.forcedDocumentIds.clear();\n  state.pendingRefresh = null;\n  state.initialDocumentProbe.resetPending();\n  // Drop the per-session discovered suppression cache too: a stopped\n  // reconciler is being torn down (scope/identity change) or paused across\n  // a prerequisite loss, after which every container must be re-validated.\n  state.discoveredContainerIds.clear();\n  // Drop pending self-echo originations too — they are session-scoped and a\n  // teardown invalidates them.\n  clearOriginatedDocuments(host.domainScope);\n}\n\nexport function createReconciliationService(\n  host: ReconciliationHost,\n): ReconciliationService {\n  const state = createReconciliationState(host);\n\n  const scheduleDrain = () => {\n    if (\n      !state.active ||\n      (state.queue.size === 0 && !state.initialDocumentProbe.canRun())\n    ) {\n      return;\n    }\n    if (!canReconcile(host.getRuntimeStatus())) {\n      return;\n    }\n    state.probeContinuationCancel?.();\n    state.probeContinuationCancel = null;\n    state.lane?.requestSync();\n  };\n\n  const enqueueContainer = (\n    containerId: string,\n    priority: ReconcilePriority,\n    force = false,\n    documentId?: string,\n  ) => {\n    if (!containerId) {\n      return;\n    }\n    // Skip containers already reconciled this session unless forced. Events\n    // force re-discovery; passive active/backfill scheduling does not, so\n    // opening Explorer does not re-fetch every container on each navigation.\n    if (\n      !force &&\n      !state.forcedContainerGenerations.has(containerId) &&\n      state.discoveredContainerIds.has(containerId)\n    ) {\n      return;\n    }\n    if (force) {\n      markContainerForced(state, containerId, documentId);\n    }\n    state.queue.enqueue(containerId, priority);\n    scheduleDrain();\n  };\n\n  const enqueueIdleBackfill = () => {\n    enqueueKnownContainersForIdleBackfill({\n      host,\n      scheduleDrain,\n      state,\n    });\n  };\n\n  return {\n    start: () => {\n      startReconciliationLane(host, state);\n      scheduleDrain();\n    },\n    // Reconcile the active container first; siblings remain lazy until visited.\n    setActiveContainer: (containerId) =>\n      activateContainer(state, containerId, (activeId) =>\n        enqueueContainer(activeId, \"active\"),\n      ),\n    enqueueContainer,\n    enqueueIdleBackfill,\n    resetDiscovered: () => {\n      state.discoveredContainerIds.clear();\n      state.initialDocumentProbe.resetSkippedListings();\n    },\n    reconcileRootContainersNow: (options) =>\n      requestContainerRefresh({\n        freshListing: options?.freshListing === true,\n        host,\n        state,\n        refreshTree: host.refreshRootTree,\n        listContainerIds: host.listAutomaticRootCatchupContainerIds,\n        scope: \"root\",\n      }),\n    reconcileNow: () =>\n      requestContainerRefresh({\n        freshListing: false,\n        host,\n        state,\n        refreshTree: host.refreshTree,\n        listContainerIds: () => listFullRefreshContainerIds(host, state),\n        scope: \"full\",\n      }),\n    stop: () => stopReconciliationService(host, state),\n  };\n}\n"]}

package/sync/reconciliation/serviceTypes.d.ts

@@ -62,7 +62,16 @@ export interface ReconciliationService {
      * retries need a fresh opportunity once the server is reachable again.
      */
     resetDiscovered: () => void;
-    reconcileRootContainersNow: () => Promise<void>;
+    /**
+     * Re-list root containers and reconcile the root catch-up set. By default a
+     * request joins a sweep already in flight. With `freshListing`, the returned
+     * sweep starts after this call: a discovery event (a root shared with or
+     * created for this user) must not be satisfied by a sweep that may have
+     * listed roots before the event committed.
+     */
+    reconcileRootContainersNow: (options?: {
+        readonly freshListing?: boolean;
+    }) => Promise<void>;
     reconcileNow: () => Promise<void>;
     stop: () => void;
 }

package/sync/reconciliation/serviceTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"serviceTypes.js","sourceRoot":"","sources":["serviceTypes.ts"],"names":[],"mappings":"","sourcesContent":["import type { DocumentSummary } from \"../../data/documents/documentSummary\";\nimport type { DomainScope } from \"../../data/domainScope\";\nimport type { LocalProjectionReconciledDelta } from \"../../stores/local-projection\";\nimport type { InitialDocumentProbeHost } from \"./initialDocumentProbe\";\nimport type { ReconcilePriority } from \"./queue\";\n\nexport interface ReconciliationRuntimeStatus {\n  dbStatus: string;\n  isAuthenticated: boolean;\n  online: boolean;\n}\n\n/**\n * Host contract injected by the device-first facade. Keeps the reconciler\n * React-free and decoupled from runtime/persistence construction — it only\n * orchestrates *when* these run and routes their results into Layer A.\n */\nexport interface ReconciliationHost extends InitialDocumentProbeHost {\n  domainScope: DomainScope;\n  getRuntimeStatus: () => ReconciliationRuntimeStatus;\n  /** True when this container has enough remote state to list documents. */\n  canDiscoverContainerDocuments: (containerId: string) => boolean;\n  /** Known container ids eligible for idle document reconciliation. */\n  listKnownContainerIds: () => ReadonlyArray<string>;\n  /** Known ids eligible after an automatic root-lane discovery hint. */\n  listAutomaticRootCatchupContainerIds: () => ReadonlyArray<string>;\n  /** Discover + persist documents; `null` means the lane was not fully listed. */\n  discoverContainerDocuments: (\n    containerId: string,\n    onFullListing?: ((documentIds: ReadonlyArray<string>) => void) | undefined,\n    onPendingDiscovery?: ((delayMs: number) => void) | undefined,\n  ) => Promise<ReadonlyArray<DocumentSummary> | null>;\n  /** Read a container's freshly-persisted summaries+links from SQLite. */\n  loadContainerDelta: (\n    containerId: string,\n  ) => Promise<LocalProjectionReconciledDelta>;\n  /** Push a reconciled delta into the local projection store. */\n  applyReconciled: (delta: LocalProjectionReconciledDelta) => void;\n  /**\n   * Sync document bodies for a reconciled container. `force` (an explicit\n   * refresh) revalidates registered ordinary documents and retries system\n   * documents; otherwise only unopened system documents are synced, so a\n   * background pass can materialize projection-owned content without eagerly\n   * opening every ordinary document. A documentIds set limits forced pulls to\n   * hint-named documents while still discovering new system content.\n   */\n  requestDocumentContentPull: (\n    containerId: string,\n    documents: ReadonlyArray<DocumentSummary>,\n    force: boolean,\n    documentIds?: ReadonlySet<string>,\n  ) => void;\n  /** Refresh the container tree from the server (explicit refresh). */\n  refreshTree: () => Promise<void>;\n  /** Refresh only the top-level root lane from the server. */\n  refreshRootTree: () => Promise<void>;\n  /** True if the destroyed-db error should be swallowed rather than surfaced. */\n  isIgnorableError: (error: unknown) => boolean;\n  /** Host diagnostics sink; bare runtimes do not structure errors. */\n  logError?: ((message: string, error: unknown) => void) | undefined;\n}\n\nexport interface ReconciliationService {\n  start: () => void;\n  setActiveContainer: (containerId: string | null) => void;\n  /** Force a listing; documentId limits content revalidation to that hint. */\n  enqueueContainer: (\n    containerId: string,\n    priority: ReconcilePriority,\n    force?: boolean,\n    documentId?: string,\n  ) => void;\n  /** Queue known containers at idle priority. */\n  enqueueIdleBackfill: () => void;\n  /**\n   * Forget which containers were reconciled this session so the next enqueue of\n   * each re-validates against the server exactly once. Call on the\n   * cannot-reconcile → can-reconcile edge (relogin/reconnect): the discovered\n   * set is a per-session suppression cache, a previously-visited container may\n   * have changed remotely, and initial-probe listings that exhausted their\n   * retries need a fresh opportunity once the server is reachable again.\n   */\n  resetDiscovered: () => void;\n  reconcileRootContainersNow: () => Promise<void>;\n  reconcileNow: () => Promise<void>;\n  stop: () => void;\n}\n"]}
+{"version":3,"file":"serviceTypes.js","sourceRoot":"","sources":["serviceTypes.ts"],"names":[],"mappings":"","sourcesContent":["import type { DocumentSummary } from \"../../data/documents/documentSummary\";\nimport type { DomainScope } from \"../../data/domainScope\";\nimport type { LocalProjectionReconciledDelta } from \"../../stores/local-projection\";\nimport type { InitialDocumentProbeHost } from \"./initialDocumentProbe\";\nimport type { ReconcilePriority } from \"./queue\";\n\nexport interface ReconciliationRuntimeStatus {\n  dbStatus: string;\n  isAuthenticated: boolean;\n  online: boolean;\n}\n\n/**\n * Host contract injected by the device-first facade. Keeps the reconciler\n * React-free and decoupled from runtime/persistence construction — it only\n * orchestrates *when* these run and routes their results into Layer A.\n */\nexport interface ReconciliationHost extends InitialDocumentProbeHost {\n  domainScope: DomainScope;\n  getRuntimeStatus: () => ReconciliationRuntimeStatus;\n  /** True when this container has enough remote state to list documents. */\n  canDiscoverContainerDocuments: (containerId: string) => boolean;\n  /** Known container ids eligible for idle document reconciliation. */\n  listKnownContainerIds: () => ReadonlyArray<string>;\n  /** Known ids eligible after an automatic root-lane discovery hint. */\n  listAutomaticRootCatchupContainerIds: () => ReadonlyArray<string>;\n  /** Discover + persist documents; `null` means the lane was not fully listed. */\n  discoverContainerDocuments: (\n    containerId: string,\n    onFullListing?: ((documentIds: ReadonlyArray<string>) => void) | undefined,\n    onPendingDiscovery?: ((delayMs: number) => void) | undefined,\n  ) => Promise<ReadonlyArray<DocumentSummary> | null>;\n  /** Read a container's freshly-persisted summaries+links from SQLite. */\n  loadContainerDelta: (\n    containerId: string,\n  ) => Promise<LocalProjectionReconciledDelta>;\n  /** Push a reconciled delta into the local projection store. */\n  applyReconciled: (delta: LocalProjectionReconciledDelta) => void;\n  /**\n   * Sync document bodies for a reconciled container. `force` (an explicit\n   * refresh) revalidates registered ordinary documents and retries system\n   * documents; otherwise only unopened system documents are synced, so a\n   * background pass can materialize projection-owned content without eagerly\n   * opening every ordinary document. A documentIds set limits forced pulls to\n   * hint-named documents while still discovering new system content.\n   */\n  requestDocumentContentPull: (\n    containerId: string,\n    documents: ReadonlyArray<DocumentSummary>,\n    force: boolean,\n    documentIds?: ReadonlySet<string>,\n  ) => void;\n  /** Refresh the container tree from the server (explicit refresh). */\n  refreshTree: () => Promise<void>;\n  /** Refresh only the top-level root lane from the server. */\n  refreshRootTree: () => Promise<void>;\n  /** True if the destroyed-db error should be swallowed rather than surfaced. */\n  isIgnorableError: (error: unknown) => boolean;\n  /** Host diagnostics sink; bare runtimes do not structure errors. */\n  logError?: ((message: string, error: unknown) => void) | undefined;\n}\n\nexport interface ReconciliationService {\n  start: () => void;\n  setActiveContainer: (containerId: string | null) => void;\n  /** Force a listing; documentId limits content revalidation to that hint. */\n  enqueueContainer: (\n    containerId: string,\n    priority: ReconcilePriority,\n    force?: boolean,\n    documentId?: string,\n  ) => void;\n  /** Queue known containers at idle priority. */\n  enqueueIdleBackfill: () => void;\n  /**\n   * Forget which containers were reconciled this session so the next enqueue of\n   * each re-validates against the server exactly once. Call on the\n   * cannot-reconcile → can-reconcile edge (relogin/reconnect): the discovered\n   * set is a per-session suppression cache, a previously-visited container may\n   * have changed remotely, and initial-probe listings that exhausted their\n   * retries need a fresh opportunity once the server is reachable again.\n   */\n  resetDiscovered: () => void;\n  /**\n   * Re-list root containers and reconcile the root catch-up set. By default a\n   * request joins a sweep already in flight. With `freshListing`, the returned\n   * sweep starts after this call: a discovery event (a root shared with or\n   * created for this user) must not be satisfied by a sweep that may have\n   * listed roots before the event committed.\n   */\n  reconcileRootContainersNow: (options?: {\n    readonly freshListing?: boolean;\n  }) => Promise<void>;\n  reconcileNow: () => Promise<void>;\n  stop: () => void;\n}\n"]}

package/workflows/runtimeInput.d.ts

@@ -27,9 +27,10 @@ export interface WorkflowRuntimeStateInput {
     readonly events: ReadonlyArray<unknown>;
     readonly online: boolean;
     /**
-     * Increments after each restored server-events interest baseline. Unlike a
-     * boolean connection edge, this survives coalesced runtime notifications and
-     * document stores retained while their host provider is unmounted.
+     * Increments after each acknowledged server-events interest declaration.
+     * Unlike a boolean connection edge, this survives coalesced runtime
+     * notifications and document stores retained while their host provider is
+     * unmounted.
      */
     readonly serverEventsConnectionGeneration?: number | undefined;
     /**

package/workflows/runtimeInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeInput.js","sourceRoot":"","sources":["runtimeInput.ts"],"names":[],"mappings":"","sourcesContent":["import type { EncapsulationKeyPair, SigningKeyPair } from \"@tearleads/crypto\";\nimport type { BlobStore } from \"../data/blobContracts\";\nimport type { DocumentProjectorRegistry } from \"../data/documents/documentKinds\";\nimport type { DomainScope } from \"../data/domainScope\";\nimport type { SecurityIncidentReporter } from \"../data/securityIncidents\";\nimport type { ExecSql } from \"../data/sqlite/sqlSchema\";\n\nexport type WorkflowRuntimeDatabaseStatus =\n  | \"idle\"\n  | \"ready\"\n  | \"error\"\n  | \"terminated\";\n\nexport interface WorkflowRuntimeAuthInput {\n  /** Server-backed personal organization; independent of organizationId. */\n  readonly defaultOrganizationId?: string | null;\n  /** Session root identity, independent of a document/pane target. */\n  readonly rootContainerId?: string | null | undefined;\n  readonly isAuthenticated: boolean;\n  /** Platform-operator flag from the server; the API enforces root access. */\n  readonly isRoot?: boolean | undefined;\n  readonly organizationId: string | null;\n  readonly userId: string | null;\n}\n\nexport interface WorkflowRuntimeCryptoInput {\n  readonly encapsulationKeyPair: EncapsulationKeyPair | null;\n  readonly signingFingerprint: string | null;\n  readonly signingKeyPair: SigningKeyPair | null;\n}\n\nexport interface WorkflowRuntimeStateInput {\n  readonly containerId: string | null;\n  readonly domainScope: DomainScope;\n  readonly events: ReadonlyArray<unknown>;\n  readonly online: boolean;\n  /**\n   * Increments after each restored server-events interest baseline. Unlike a\n   * boolean connection edge, this survives coalesced runtime notifications and\n   * document stores retained while their host provider is unmounted.\n   */\n  readonly serverEventsConnectionGeneration?: number | undefined;\n  /**\n   * Per-pane CRDT peer-seed discriminator (e.g. the pane's local identity\n   * namespace). Documents in distinct panes must derive distinct Loro peer ids;\n   * absent/`null` means single-pane (bare scope). The document runtime factory\n   * always populates it; other runtimes and test fixtures may omit it.\n   */\n  readonly peerScope?: string | null;\n}\n\nexport interface WorkflowRuntimeInfraInput {\n  readonly blobStore: BlobStore;\n  readonly dbStatus: WorkflowRuntimeDatabaseStatus;\n  readonly documentProjectors: DocumentProjectorRegistry;\n  readonly execSql: ExecSql;\n}\n\nexport interface WorkflowRuntimeUtilInput {\n  readonly isRemoteSyncBlocked?:\n    | ((organizationId: string) => boolean)\n    | undefined;\n  readonly log: (message: string) => void;\n  readonly logError: (message: string | Error, cause?: unknown) => void;\n  readonly reportSecurityIncident: SecurityIncidentReporter;\n}\n\nexport interface WorkflowRuntimeGroups {\n  readonly auth: WorkflowRuntimeAuthInput;\n  readonly crypto: WorkflowRuntimeCryptoInput;\n  readonly infra: WorkflowRuntimeInfraInput;\n  readonly state: WorkflowRuntimeStateInput;\n  readonly util: WorkflowRuntimeUtilInput;\n}\n"]}
+{"version":3,"file":"runtimeInput.js","sourceRoot":"","sources":["runtimeInput.ts"],"names":[],"mappings":"","sourcesContent":["import type { EncapsulationKeyPair, SigningKeyPair } from \"@tearleads/crypto\";\nimport type { BlobStore } from \"../data/blobContracts\";\nimport type { DocumentProjectorRegistry } from \"../data/documents/documentKinds\";\nimport type { DomainScope } from \"../data/domainScope\";\nimport type { SecurityIncidentReporter } from \"../data/securityIncidents\";\nimport type { ExecSql } from \"../data/sqlite/sqlSchema\";\n\nexport type WorkflowRuntimeDatabaseStatus =\n  | \"idle\"\n  | \"ready\"\n  | \"error\"\n  | \"terminated\";\n\nexport interface WorkflowRuntimeAuthInput {\n  /** Server-backed personal organization; independent of organizationId. */\n  readonly defaultOrganizationId?: string | null;\n  /** Session root identity, independent of a document/pane target. */\n  readonly rootContainerId?: string | null | undefined;\n  readonly isAuthenticated: boolean;\n  /** Platform-operator flag from the server; the API enforces root access. */\n  readonly isRoot?: boolean | undefined;\n  readonly organizationId: string | null;\n  readonly userId: string | null;\n}\n\nexport interface WorkflowRuntimeCryptoInput {\n  readonly encapsulationKeyPair: EncapsulationKeyPair | null;\n  readonly signingFingerprint: string | null;\n  readonly signingKeyPair: SigningKeyPair | null;\n}\n\nexport interface WorkflowRuntimeStateInput {\n  readonly containerId: string | null;\n  readonly domainScope: DomainScope;\n  readonly events: ReadonlyArray<unknown>;\n  readonly online: boolean;\n  /**\n   * Increments after each acknowledged server-events interest declaration.\n   * Unlike a boolean connection edge, this survives coalesced runtime\n   * notifications and document stores retained while their host provider is\n   * unmounted.\n   */\n  readonly serverEventsConnectionGeneration?: number | undefined;\n  /**\n   * Per-pane CRDT peer-seed discriminator (e.g. the pane's local identity\n   * namespace). Documents in distinct panes must derive distinct Loro peer ids;\n   * absent/`null` means single-pane (bare scope). The document runtime factory\n   * always populates it; other runtimes and test fixtures may omit it.\n   */\n  readonly peerScope?: string | null;\n}\n\nexport interface WorkflowRuntimeInfraInput {\n  readonly blobStore: BlobStore;\n  readonly dbStatus: WorkflowRuntimeDatabaseStatus;\n  readonly documentProjectors: DocumentProjectorRegistry;\n  readonly execSql: ExecSql;\n}\n\nexport interface WorkflowRuntimeUtilInput {\n  readonly isRemoteSyncBlocked?:\n    | ((organizationId: string) => boolean)\n    | undefined;\n  readonly log: (message: string) => void;\n  readonly logError: (message: string | Error, cause?: unknown) => void;\n  readonly reportSecurityIncident: SecurityIncidentReporter;\n}\n\nexport interface WorkflowRuntimeGroups {\n  readonly auth: WorkflowRuntimeAuthInput;\n  readonly crypto: WorkflowRuntimeCryptoInput;\n  readonly infra: WorkflowRuntimeInfraInput;\n  readonly state: WorkflowRuntimeStateInput;\n  readonly util: WorkflowRuntimeUtilInput;\n}\n"]}