@tearleads/client-sdk 0.1.252 → 0.1.254

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (155) hide show
  1. package/Tearleads.js +3 -3
  2. package/Tearleads.js.map +1 -1
  3. package/client/containerContents/documentDiscovery.js +0 -2
  4. package/client/containerContents/documentDiscovery.js.map +1 -1
  5. package/client/containerContents/index.d.ts +2 -0
  6. package/client/containerContents/index.js +4 -9
  7. package/client/containerContents/index.js.map +1 -1
  8. package/client/containerContents/storeRuntime.d.ts +17 -0
  9. package/client/containerContents/storeRuntime.js +31 -0
  10. package/client/containerContents/storeRuntime.js.map +1 -0
  11. package/client/deviceFirst/index.d.ts +2 -3
  12. package/client/deviceFirst/index.js +44 -22
  13. package/client/deviceFirst/index.js.map +1 -1
  14. package/client/runtime/workflowRuntime.d.ts +2 -0
  15. package/client/runtime/workflowRuntime.js +13 -6
  16. package/client/runtime/workflowRuntime.js.map +1 -1
  17. package/data/persistence/container-contents/containerContentsPersistenceTypes.d.ts +7 -10
  18. package/data/persistence/container-contents/containerContentsPersistenceTypes.js.map +1 -1
  19. package/data/persistence/container-contents/containerDeletionPersistence.js +5 -1
  20. package/data/persistence/container-contents/containerDeletionPersistence.js.map +1 -1
  21. package/data/persistence/container-contents/containerHydrationPersistence.js +1 -1
  22. package/data/persistence/container-contents/containerHydrationPersistence.js.map +1 -1
  23. package/data/persistence/container-contents/containerMetadataMutationPersistence.js +11 -4
  24. package/data/persistence/container-contents/containerMetadataMutationPersistence.js.map +1 -1
  25. package/data/persistence/container-contents/containerRemovalMetadata.js +47 -0
  26. package/data/persistence/container-contents/containerRemovalMetadata.js.map +1 -0
  27. package/data/persistence/container-contents/containerRemovalPlacements.js +22 -0
  28. package/data/persistence/container-contents/containerRemovalPlacements.js.map +1 -0
  29. package/data/persistence/container-contents/containerSyncWatermarkPersistence.d.ts +2 -1
  30. package/data/persistence/container-contents/containerSyncWatermarkPersistence.js +10 -2
  31. package/data/persistence/container-contents/containerSyncWatermarkPersistence.js.map +1 -1
  32. package/data/persistence/documents/documentDiscoveryCandidate.d.ts +1 -0
  33. package/data/persistence/documents/documentDiscoveryCandidate.js +3 -1
  34. package/data/persistence/documents/documentDiscoveryCandidate.js.map +1 -1
  35. package/data/persistence/documents/documentDiscoveryEvidencePersistence.d.ts +1 -1
  36. package/data/persistence/documents/documentDiscoveryEvidencePersistence.js +16 -4
  37. package/data/persistence/documents/documentDiscoveryEvidencePersistence.js.map +1 -1
  38. package/data/sqlite/migrations/localSchemaMigrations.js +11 -0
  39. package/data/sqlite/migrations/localSchemaMigrations.js.map +1 -1
  40. package/data/sqlite/schema/containerSyncWatermarkSchema.js +6 -3
  41. package/data/sqlite/schema/containerSyncWatermarkSchema.js.map +1 -1
  42. package/data/sqlite/schema/index.d.ts +17 -0
  43. package/data/sync/syncCoordinator.js +17 -10
  44. package/data/sync/syncCoordinator.js.map +1 -1
  45. package/internal/api-client/ApiClient.d.ts +1 -0
  46. package/internal/api-client/client/apiClientContext.d.ts +1 -0
  47. package/internal/api-client/client/containerReads.d.ts +1 -0
  48. package/internal/api-client/requestInternals.js +14 -6
  49. package/internal/api-client/requestInternals.js.map +1 -1
  50. package/internal/validators/operation/containerReads.d.ts +29 -2
  51. package/internal/validators/operation/containerReads.js +2 -1
  52. package/internal/validators/operation/containerReads.js.map +1 -1
  53. package/internal/validators/request/containerDocumentLanes.d.ts +7 -0
  54. package/internal/validators/request/containerDocumentLanes.js +6 -0
  55. package/internal/validators/request/containerDocumentLanes.js.map +1 -1
  56. package/internal/validators/response/container.d.ts +8 -0
  57. package/internal/validators/response/container.js +1 -0
  58. package/internal/validators/response/container.js.map +1 -1
  59. package/internal/validators/response/containerParentLanes.d.ts +2 -0
  60. package/package.json +1 -1
  61. package/stores/container-contents/containerContentsStore.d.ts +3 -9
  62. package/stores/container-contents/containerContentsStore.js +24 -21
  63. package/stores/container-contents/containerContentsStore.js.map +1 -1
  64. package/stores/container-contents/containerState/storeScope.js +6 -0
  65. package/stores/container-contents/containerState/storeScope.js.map +1 -0
  66. package/stores/container-contents/hydration/backgroundHydration.js +2 -1
  67. package/stores/container-contents/hydration/backgroundHydration.js.map +1 -1
  68. package/stores/container-contents/hydration/reconnectRefresh.d.ts +10 -0
  69. package/stores/container-contents/hydration/reconnectRefresh.js +68 -0
  70. package/stores/container-contents/hydration/reconnectRefresh.js.map +1 -0
  71. package/stores/container-contents/hydration/reconnectRefreshMachine.js +49 -0
  72. package/stores/container-contents/hydration/reconnectRefreshMachine.js.map +1 -0
  73. package/stores/container-contents/hydration/remoteHydrationRefresh.js +4 -1
  74. package/stores/container-contents/hydration/remoteHydrationRefresh.js.map +1 -1
  75. package/stores/container-contents/hydration/remoteHydrationRequest.js +79 -10
  76. package/stores/container-contents/hydration/remoteHydrationRequest.js.map +1 -1
  77. package/stores/container-contents/hydration/startupHydration.js +2 -9
  78. package/stores/container-contents/hydration/startupHydration.js.map +1 -1
  79. package/stores/container-contents/hydration/treeResetMachine.js +61 -0
  80. package/stores/container-contents/hydration/treeResetMachine.js.map +1 -0
  81. package/stores/container-contents/localRefresh.js +28 -12
  82. package/stores/container-contents/localRefresh.js.map +1 -1
  83. package/stores/container-contents/remoteEvents/remoteContainerIngestion.js +4 -1
  84. package/stores/container-contents/remoteEvents/remoteContainerIngestion.js.map +1 -1
  85. package/stores/container-contents/remoteWrites/writeGeneration.js +5 -2
  86. package/stores/container-contents/remoteWrites/writeGeneration.js.map +1 -1
  87. package/stores/container-contents/state.d.ts +3 -7
  88. package/stores/container-contents/state.js +27 -16
  89. package/stores/container-contents/state.js.map +1 -1
  90. package/stores/container-contents/syncAgent/index.d.ts +7 -2
  91. package/stores/container-contents/syncAgent/index.js +77 -49
  92. package/stores/container-contents/syncAgent/index.js.map +1 -1
  93. package/stores/container-contents/syncAgent/syncAgentTypes.d.ts +5 -2
  94. package/stores/container-contents/syncAgent/syncAgentTypes.js.map +1 -1
  95. package/stores/container-contents/syncAgent/syncLaneIteration.js +6 -3
  96. package/stores/container-contents/syncAgent/syncLaneIteration.js.map +1 -1
  97. package/stores/local-projection/localProjectionStore.js +24 -15
  98. package/stores/local-projection/localProjectionStore.js.map +1 -1
  99. package/stores/local-projection/registry.js +2 -2
  100. package/stores/local-projection/registry.js.map +1 -1
  101. package/workflows/container-contents/container-state/create/createChild.js +3 -15
  102. package/workflows/container-contents/container-state/create/createChild.js.map +1 -1
  103. package/workflows/container-contents/containerPersistence.d.ts +4 -8
  104. package/workflows/container-contents/containerPersistence.js +22 -12
  105. package/workflows/container-contents/containerPersistence.js.map +1 -1
  106. package/workflows/container-contents/documentDiscovery/containerDocumentListing.js +52 -4
  107. package/workflows/container-contents/documentDiscovery/containerDocumentListing.js.map +1 -1
  108. package/workflows/container-contents/documentDiscovery/documentDiscoveryApply.js +4 -2
  109. package/workflows/container-contents/documentDiscovery/documentDiscoveryApply.js.map +1 -1
  110. package/workflows/container-contents/documentDiscovery/documentDiscoveryEvidence.js +17 -12
  111. package/workflows/container-contents/documentDiscovery/documentDiscoveryEvidence.js.map +1 -1
  112. package/workflows/container-contents/documentDiscovery/documentDiscoveryTypes.js.map +1 -1
  113. package/workflows/container-contents/documentDiscovery/publicationWatermark.js +15 -0
  114. package/workflows/container-contents/documentDiscovery/publicationWatermark.js.map +1 -0
  115. package/workflows/container-contents/localState.js +3 -0
  116. package/workflows/container-contents/localState.js.map +1 -1
  117. package/workflows/container-contents/remoteHydration/hydrateRemoteContainers.d.ts +12 -0
  118. package/workflows/container-contents/remoteHydration/hydrateRemoteContainers.js +93 -0
  119. package/workflows/container-contents/remoteHydration/hydrateRemoteContainers.js.map +1 -0
  120. package/workflows/container-contents/remoteHydration/index.d.ts +3 -11
  121. package/workflows/container-contents/remoteHydration/index.js +17 -66
  122. package/workflows/container-contents/remoteHydration/index.js.map +1 -1
  123. package/workflows/container-contents/remoteHydration/lanes/parentLaneFetch.js +3 -2
  124. package/workflows/container-contents/remoteHydration/lanes/parentLaneFetch.js.map +1 -1
  125. package/workflows/container-contents/remoteHydration/lanes/restorationReceipt.js +25 -0
  126. package/workflows/container-contents/remoteHydration/lanes/restorationReceipt.js.map +1 -0
  127. package/workflows/container-contents/remoteHydration/lanes/tombstoneAccess.js +107 -0
  128. package/workflows/container-contents/remoteHydration/lanes/tombstoneAccess.js.map +1 -0
  129. package/workflows/container-contents/remoteHydration/principalPolicyCache.js +57 -5
  130. package/workflows/container-contents/remoteHydration/principalPolicyCache.js.map +1 -1
  131. package/workflows/container-contents/remoteHydration/remoteContainers/remoteContainerPageHydration.js +129 -84
  132. package/workflows/container-contents/remoteHydration/remoteContainers/remoteContainerPageHydration.js.map +1 -1
  133. package/workflows/container-contents/remoteHydration/remoteContainers/remoteContainerState.js +32 -10
  134. package/workflows/container-contents/remoteHydration/remoteContainers/remoteContainerState.js.map +1 -1
  135. package/workflows/container-contents/remoteHydration/tombstoneApplication.js +67 -24
  136. package/workflows/container-contents/remoteHydration/tombstoneApplication.js.map +1 -1
  137. package/workflows/container-contents/remoteHydration/types.d.ts +16 -1
  138. package/workflows/container-contents/remoteHydration/types.js.map +1 -1
  139. package/workflows/container-contents/remoteReset/remoteResetCursorScope.js +3 -3
  140. package/workflows/container-contents/remoteReset/remoteResetCursorScope.js.map +1 -1
  141. package/workflows/container-contents/runtime.d.ts +3 -0
  142. package/workflows/container-contents/runtime.js.map +1 -1
  143. package/workflows/container-contents/storedContainerState.js +17 -7
  144. package/workflows/container-contents/storedContainerState.js.map +1 -1
  145. package/workflows/container-contents/syncLane.d.ts +1 -0
  146. package/workflows/container-contents/syncLane.js +9 -1
  147. package/workflows/container-contents/syncLane.js.map +1 -1
  148. package/workflows/container-contents/syncPause/discoveryGuard.js +6 -2
  149. package/workflows/container-contents/syncPause/discoveryGuard.js.map +1 -1
  150. package/workflows/container-contents/tombstones/documentTombstoneGate.js +6 -3
  151. package/workflows/container-contents/tombstones/documentTombstoneGate.js.map +1 -1
  152. package/workflows/shared/runtimeInput.d.ts +2 -0
  153. package/workflows/shared/runtimeInput.js.map +1 -1
  154. package/workflows/container-contents/remoteHydration/completeHydration.js +0 -25
  155. package/workflows/container-contents/remoteHydration/completeHydration.js.map +0 -1
@@ -1,9 +1,12 @@
1
1
  import { createGenerationGuardedHydrationHost, hydrateRemoteContainers, StaleRemoteHydrationError, } from "../../../workflows/container-contents/remoteHydration/index.js";
2
2
  import { isDatabaseUnavailableError } from "../../../workflows/container-contents/syncLane.js";
3
+ import { ownsContainerStore } from "../containerState/storeScope.js";
3
4
  import { refreshLocalContainerStates, } from "../localRefresh.js";
4
5
  import { IDLE_RECOVERY_HYDRATION, transitionRecoveryHydration, } from "./recoveryHydrationMachine.js";
6
+ import { captureTreeResetOwner, claimTreeReset, queueTreeReset, } from "./treeResetMachine.js";
5
7
  function isRequestGenerationCurrent(input) {
6
- return (input.state.lifecycleGeneration === input.lifecycleGeneration &&
8
+ return (ownsContainerStore(input.state) &&
9
+ input.state.lifecycleGeneration === input.lifecycleGeneration &&
7
10
  input.state.structuralGeneration === input.structuralGeneration);
8
11
  }
9
12
  const recoveryHydrationByState = new WeakMap();
@@ -27,7 +30,8 @@ function queueRecoveryHydrationRequest(input) {
27
30
  });
28
31
  }
29
32
  function hasRemoteHydrationPrerequisites(state) {
30
- return (state.runtime.infra.dbStatus === "ready" &&
33
+ return ((state.runtime.liveHydrationStatus?.() ?? "ready") === "ready" &&
34
+ state.runtime.infra.dbStatus === "ready" &&
31
35
  state.runtime.auth.isAuthenticated &&
32
36
  state.runtime.state.online);
33
37
  }
@@ -41,11 +45,32 @@ function createResetRecoveryInput(input) {
41
45
  };
42
46
  }
43
47
  function resumeRetainedRecoveryHydration(input) {
48
+ if (!ownsHydrationRequest(input))
49
+ return Promise.resolve();
44
50
  queueRecoveryHydrationRequest(input);
45
51
  return hasRemoteHydrationPrerequisites(input.state)
46
52
  ? input.resumeRecoveryWork()
47
53
  : Promise.resolve();
48
54
  }
55
+ function prepareTreeReset(input) {
56
+ const coverReset = claimTreeReset(input.state, !!input.reconnect || !!input.resetAllLaneWatermarks);
57
+ if (!coverReset)
58
+ return input;
59
+ const onCovered = input.recreateOnFullyHydratedAtStart
60
+ ? input.recreateOnFullyHydratedAfterReset?.()
61
+ : input.onFullyHydrated;
62
+ return {
63
+ ...input,
64
+ followDiscoveredParentLanes: true,
65
+ resetAllLaneWatermarks: true,
66
+ recreateOnFullyHydratedAtStart: false,
67
+ ownsTreeReset: coverReset.isOwned,
68
+ onFullyHydrated: () => {
69
+ coverReset.cover();
70
+ return onCovered?.();
71
+ },
72
+ };
73
+ }
49
74
  function waitForActiveRemoteHydration(input) {
50
75
  const { state } = input;
51
76
  const activeHydration = state.remoteHydrationPromise;
@@ -56,6 +81,16 @@ function waitForActiveRemoteHydration(input) {
56
81
  const requestStructuralGeneration = state.structuralGeneration;
57
82
  const needsCurrentGenerationHydration = state.remoteHydrationGeneration !== state.lifecycleGeneration ||
58
83
  state.remoteHydrationStructuralGeneration !== state.structuralGeneration;
84
+ // A restoration owns its sweep callback and its sync scheduling policy.
85
+ // Let it list after prior work settles so its durable claim can complete.
86
+ const needsOwnCrawl = !!(input.onFullyHydrated || input.recreateOnFullyHydratedAfterReset) &&
87
+ !!input.resetAllLaneWatermarks &&
88
+ !!input.followDiscoveredParentLanes;
89
+ if (!needsOwnCrawl &&
90
+ input.resetAllLaneWatermarks &&
91
+ input.followDiscoveredParentLanes) {
92
+ input = { ...input, ownsTreeReset: queueTreeReset(state) };
93
+ }
59
94
  const requestQueuedHydration = () => {
60
95
  if (!isRequestGenerationCurrent({
61
96
  lifecycleGeneration: requestLifecycleGeneration,
@@ -67,7 +102,8 @@ function waitForActiveRemoteHydration(input) {
67
102
  // Another request's crawl may have taken over this request's queued
68
103
  // lanes. Settle with that crawl rather than at once, so the request never
69
104
  // resolves before the listing that covers it.
70
- return needsCurrentGenerationHydration ||
105
+ return needsOwnCrawl ||
106
+ needsCurrentGenerationHydration ||
71
107
  state.containerParentIdsNeedingHydration.size > 0
72
108
  ? requestContainerContentsRemoteHydration(input)
73
109
  : (state.remoteHydrationPromise ?? undefined);
@@ -94,6 +130,15 @@ function waitForActiveInitialization(input) {
94
130
  });
95
131
  }
96
132
  function retryRemoteHydrationAfterReset(input) {
133
+ // The reconnect state machine owns its retry across a reset.
134
+ if (input.reconnect) {
135
+ // A superseded crawl still owes the manual refresh whose reset it consumed.
136
+ // Complete that request under the live store's own generation guard.
137
+ if (!input.ownsTreeReset?.() ||
138
+ input.state.runtime.liveHydrationStatus?.() === "retired")
139
+ return Promise.resolve();
140
+ input = { ...input, reconnect: undefined };
141
+ }
97
142
  return resumeRetainedRecoveryHydration(createResetRecoveryInput(input));
98
143
  }
99
144
  function retainResetRecoveryHydration(input) {
@@ -172,23 +217,45 @@ function consumeQueuedHydrationScope(state, followDiscoveredParentLanesOption) {
172
217
  : queuedParentIds,
173
218
  };
174
219
  }
220
+ function ownsHydrationRequest(input) {
221
+ return (ownsContainerStore(input.state) &&
222
+ input.ownsTreeReset?.() !== false &&
223
+ input.reconnect?.isCurrent() !== false);
224
+ }
225
+ function captureHydrationScope(input) {
226
+ const { state } = input;
227
+ const { lifecycleGeneration, structuralGeneration } = state;
228
+ return () => ownsHydrationRequest(input) &&
229
+ isRequestGenerationCurrent({
230
+ state,
231
+ lifecycleGeneration,
232
+ structuralGeneration,
233
+ });
234
+ }
235
+ function bindManualTreeReset(input) {
236
+ if (!input.resetAllLaneWatermarks ||
237
+ input.ownsTreeReset ||
238
+ input.onFullyHydrated ||
239
+ input.recreateOnFullyHydratedAfterReset)
240
+ return input;
241
+ return { ...input, ownsTreeReset: captureTreeResetOwner(input.state) };
242
+ }
175
243
  export function requestContainerContentsRemoteHydration(input) {
176
244
  const { host, scheduleSync, state } = input;
245
+ input = bindManualTreeReset(input);
246
+ if (!ownsHydrationRequest(input))
247
+ return Promise.resolve();
177
248
  queueRequestedParentIds(input);
178
249
  const readinessBarrier = waitForRemoteHydrationReadiness(input);
179
250
  if (readinessBarrier) {
180
251
  return readinessBarrier;
181
252
  }
253
+ input = prepareTreeReset(input);
182
254
  const { followDiscoveredParentLanes, parentIds } = consumeQueuedHydrationScope(state, input.followDiscoveredParentLanes);
183
255
  let appliedRemoteContainerChange = false;
184
256
  let retainInterruptedHydration = false;
185
- const lifecycleGeneration = state.lifecycleGeneration;
186
- const structuralGeneration = state.structuralGeneration;
187
- const isCurrent = () => isRequestGenerationCurrent({
188
- lifecycleGeneration,
189
- state,
190
- structuralGeneration,
191
- });
257
+ const { lifecycleGeneration, structuralGeneration } = state;
258
+ const isCurrent = captureHydrationScope(input);
192
259
  const onFullyHydrated = input.recreateOnFullyHydratedAtStart
193
260
  ? input.recreateOnFullyHydratedAfterReset?.()
194
261
  : input.onFullyHydrated;
@@ -201,6 +268,7 @@ export function requestContainerContentsRemoteHydration(input) {
201
268
  state.remoteHydrationStructuralGeneration = structuralGeneration;
202
269
  const hydrationPromise = refreshLocalContainerStates({
203
270
  host: hydrationHost,
271
+ stillCurrent: input.reconnect?.isCurrent,
204
272
  state,
205
273
  })
206
274
  .then(() => {
@@ -212,6 +280,7 @@ export function requestContainerContentsRemoteHydration(input) {
212
280
  host: hydrationHost,
213
281
  isCurrent,
214
282
  onFullyHydrated,
283
+ reconnect: input.reconnect,
215
284
  parentIds,
216
285
  resetAllLaneWatermarks: input.resetAllLaneWatermarks,
217
286
  resetRootLaneWatermark: input.resetRootLaneWatermark,
@@ -1 +1 @@
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\";\nimport {\n IDLE_RECOVERY_HYDRATION,\n type RecoveryHydrationEvent,\n type RecoveryHydrationState,\n transitionRecoveryHydration,\n} from \"./recoveryHydrationMachine\";\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 recoveryHydrationByState = new WeakMap<\n RemoteHydrationRequestState,\n RecoveryHydrationState<RecoveryHydrationRequest>\n>();\n\nfunction dispatchRecoveryHydration(\n state: RemoteHydrationRequestState,\n event: RecoveryHydrationEvent<RecoveryHydrationRequest>,\n): void {\n const next = transitionRecoveryHydration(\n recoveryHydrationByState.get(state) ?? IDLE_RECOVERY_HYDRATION,\n event,\n );\n if (next.status === \"idle\") {\n recoveryHydrationByState.delete(state);\n } else {\n recoveryHydrationByState.set(state, next);\n }\n}\n\nfunction queueRecoveryHydrationRequest(\n input: RemoteHydrationRequestInput,\n): void {\n dispatchRecoveryHydration(input.state, {\n request: {\n input,\n lifecycleGeneration: input.state.lifecycleGeneration,\n structuralGeneration: input.state.structuralGeneration,\n },\n type: \"queued\",\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 // Another request's crawl may have taken over this request's queued\n // lanes. Settle with that crawl rather than at once, so the request never\n // resolves before the listing that covers it.\n return needsCurrentGenerationHydration ||\n state.containerParentIdsNeedingHydration.size > 0\n ? requestContainerContentsRemoteHydration(input)\n : (state.remoteHydrationPromise ?? 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 recovery =\n recoveryHydrationByState.get(state) ?? IDLE_RECOVERY_HYDRATION;\n if (recovery.status === \"idle\") return null;\n // Another caller already took this caller's queued request over.\n if (recovery.status === \"running\") return recovery.run;\n const inputs = recovery.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 let resolveRun: () => void = () => undefined;\n let rejectRun: (error: unknown) => void = () => undefined;\n const run = new Promise<void>((resolve, reject) => {\n resolveRun = resolve;\n rejectRun = reject;\n });\n // The run is current before its requests start, so a request one of them\n // queues meanwhile waits for the next resume instead of being dropped.\n dispatchRecoveryHydration(state, { run, type: \"started\" });\n const settle = () =>\n dispatchRecoveryHydration(state, { run, type: \"settled\" });\n run.then(settle, settle);\n const fail = (error: unknown) => {\n for (const input of inputs) {\n queueRecoveryHydrationRequest(input);\n }\n rejectRun(error);\n };\n try {\n Promise.all(inputs.map(requestContainerContentsRemoteHydration)).then(\n () => resolveRun(),\n fail,\n );\n } catch (error) {\n fail(error);\n }\n return run;\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"]}
1
+ {"version":3,"file":"remoteHydrationRequest.js","sourceRoot":"","sources":["remoteHydrationRequest.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n createGenerationGuardedHydrationHost,\n hydrateRemoteContainers,\n type ReconnectCrawl,\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 { ownsContainerStore } from \"../containerState/storeScope\";\nimport {\n type LocalContainerRefreshState,\n refreshLocalContainerStates,\n} from \"../localRefresh\";\nimport {\n IDLE_RECOVERY_HYDRATION,\n type RecoveryHydrationEvent,\n type RecoveryHydrationState,\n transitionRecoveryHydration,\n} from \"./recoveryHydrationMachine\";\n\nimport {\n captureTreeResetOwner,\n claimTreeReset,\n queueTreeReset,\n} from \"./treeResetMachine\";\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 writeGeneration?: number;\n };\n\ninterface RemoteHydrationRequestInput {\n ownsTreeReset?: () => boolean;\n followDiscoveredParentLanes?: boolean | undefined;\n host: RemoteContainerHydrationHost;\n reconnect?: ReconnectCrawl | undefined;\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 ownsContainerStore(input.state) &&\n input.state.lifecycleGeneration === input.lifecycleGeneration &&\n input.state.structuralGeneration === input.structuralGeneration\n );\n}\n\nconst recoveryHydrationByState = new WeakMap<\n RemoteHydrationRequestState,\n RecoveryHydrationState<RecoveryHydrationRequest>\n>();\n\nfunction dispatchRecoveryHydration(\n state: RemoteHydrationRequestState,\n event: RecoveryHydrationEvent<RecoveryHydrationRequest>,\n): void {\n const next = transitionRecoveryHydration(\n recoveryHydrationByState.get(state) ?? IDLE_RECOVERY_HYDRATION,\n event,\n );\n if (next.status === \"idle\") {\n recoveryHydrationByState.delete(state);\n } else {\n recoveryHydrationByState.set(state, next);\n }\n}\n\nfunction queueRecoveryHydrationRequest(\n input: RemoteHydrationRequestInput,\n): void {\n dispatchRecoveryHydration(input.state, {\n request: {\n input,\n lifecycleGeneration: input.state.lifecycleGeneration,\n structuralGeneration: input.state.structuralGeneration,\n },\n type: \"queued\",\n });\n}\n\nfunction hasRemoteHydrationPrerequisites(\n state: RemoteHydrationRequestState,\n): boolean {\n return (\n (state.runtime.liveHydrationStatus?.() ?? \"ready\") === \"ready\" &&\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 if (!ownsHydrationRequest(input)) return Promise.resolve();\n queueRecoveryHydrationRequest(input);\n return hasRemoteHydrationPrerequisites(input.state)\n ? input.resumeRecoveryWork()\n : Promise.resolve();\n}\n\nfunction prepareTreeReset(\n input: RemoteHydrationRequestInput,\n): RemoteHydrationRequestInput {\n const coverReset = claimTreeReset(\n input.state,\n !!input.reconnect || !!input.resetAllLaneWatermarks,\n );\n if (!coverReset) return input;\n const onCovered = input.recreateOnFullyHydratedAtStart\n ? input.recreateOnFullyHydratedAfterReset?.()\n : input.onFullyHydrated;\n return {\n ...input,\n followDiscoveredParentLanes: true,\n resetAllLaneWatermarks: true,\n recreateOnFullyHydratedAtStart: false,\n ownsTreeReset: coverReset.isOwned,\n onFullyHydrated: () => {\n coverReset.cover();\n return onCovered?.();\n },\n };\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 // A restoration owns its sweep callback and its sync scheduling policy.\n // Let it list after prior work settles so its durable claim can complete.\n const needsOwnCrawl =\n !!(input.onFullyHydrated || input.recreateOnFullyHydratedAfterReset) &&\n !!input.resetAllLaneWatermarks &&\n !!input.followDiscoveredParentLanes;\n if (\n !needsOwnCrawl &&\n input.resetAllLaneWatermarks &&\n input.followDiscoveredParentLanes\n ) {\n input = { ...input, ownsTreeReset: queueTreeReset(state) };\n }\n const requestQueuedHydration = () => {\n if (\n !isRequestGenerationCurrent({\n lifecycleGeneration: requestLifecycleGeneration,\n state,\n structuralGeneration: requestStructuralGeneration,\n })\n ) {\n return retryRemoteHydrationAfterReset(input);\n }\n // Another request's crawl may have taken over this request's queued\n // lanes. Settle with that crawl rather than at once, so the request never\n // resolves before the listing that covers it.\n return needsOwnCrawl ||\n needsCurrentGenerationHydration ||\n state.containerParentIdsNeedingHydration.size > 0\n ? requestContainerContentsRemoteHydration(input)\n : (state.remoteHydrationPromise ?? 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 // The reconnect state machine owns its retry across a reset.\n if (input.reconnect) {\n // A superseded crawl still owes the manual refresh whose reset it consumed.\n // Complete that request under the live store's own generation guard.\n if (\n !input.ownsTreeReset?.() ||\n input.state.runtime.liveHydrationStatus?.() === \"retired\"\n )\n return Promise.resolve();\n input = { ...input, reconnect: undefined };\n }\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 recovery =\n recoveryHydrationByState.get(state) ?? IDLE_RECOVERY_HYDRATION;\n if (recovery.status === \"idle\") return null;\n // Another caller already took this caller's queued request over.\n if (recovery.status === \"running\") return recovery.run;\n const inputs = recovery.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 let resolveRun: () => void = () => undefined;\n let rejectRun: (error: unknown) => void = () => undefined;\n const run = new Promise<void>((resolve, reject) => {\n resolveRun = resolve;\n rejectRun = reject;\n });\n // The run is current before its requests start, so a request one of them\n // queues meanwhile waits for the next resume instead of being dropped.\n dispatchRecoveryHydration(state, { run, type: \"started\" });\n const settle = () =>\n dispatchRecoveryHydration(state, { run, type: \"settled\" });\n run.then(settle, settle);\n const fail = (error: unknown) => {\n for (const input of inputs) {\n queueRecoveryHydrationRequest(input);\n }\n rejectRun(error);\n };\n try {\n Promise.all(inputs.map(requestContainerContentsRemoteHydration)).then(\n () => resolveRun(),\n fail,\n );\n } catch (error) {\n fail(error);\n }\n return run;\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\nfunction ownsHydrationRequest(input: RemoteHydrationRequestInput): boolean {\n return (\n ownsContainerStore(input.state) &&\n input.ownsTreeReset?.() !== false &&\n input.reconnect?.isCurrent() !== false\n );\n}\n\nfunction captureHydrationScope(\n input: RemoteHydrationRequestInput,\n): () => boolean {\n const { state } = input;\n const { lifecycleGeneration, structuralGeneration } = state;\n return () =>\n ownsHydrationRequest(input) &&\n isRequestGenerationCurrent({\n state,\n lifecycleGeneration,\n structuralGeneration,\n });\n}\n\nfunction bindManualTreeReset(\n input: RemoteHydrationRequestInput,\n): RemoteHydrationRequestInput {\n if (\n !input.resetAllLaneWatermarks ||\n input.ownsTreeReset ||\n input.onFullyHydrated ||\n input.recreateOnFullyHydratedAfterReset\n )\n return input;\n return { ...input, ownsTreeReset: captureTreeResetOwner(input.state) };\n}\n\nexport function requestContainerContentsRemoteHydration(\n input: RemoteHydrationRequestInput,\n): Promise<void> {\n const { host, scheduleSync, state } = input;\n input = bindManualTreeReset(input);\n if (!ownsHydrationRequest(input)) return Promise.resolve();\n queueRequestedParentIds(input);\n const readinessBarrier = waitForRemoteHydrationReadiness(input);\n if (readinessBarrier) {\n return readinessBarrier;\n }\n\n input = prepareTreeReset(input);\n const { followDiscoveredParentLanes, parentIds } =\n consumeQueuedHydrationScope(state, input.followDiscoveredParentLanes);\n\n let appliedRemoteContainerChange = false;\n let retainInterruptedHydration = false;\n const { lifecycleGeneration, structuralGeneration } = state;\n const isCurrent = captureHydrationScope(input);\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 stillCurrent: input.reconnect?.isCurrent,\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 reconnect: input.reconnect,\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"]}
@@ -40,8 +40,8 @@ function reportStartupHydrationError(message, error) {
40
40
  }
41
41
  console.error(message, error);
42
42
  }
43
- export async function scheduleStaleStartupRemoteHydration(input) {
44
- const { requestHydration, state } = input;
43
+ export async function inspectStartupHydration(input) {
44
+ const { state } = input;
45
45
  if (!state.runtime.auth.isAuthenticated || !state.runtime.state.online) {
46
46
  return false;
47
47
  }
@@ -69,13 +69,6 @@ export async function scheduleStaleStartupRemoteHydration(input) {
69
69
  for (const parentId of parentIds) {
70
70
  state.containerParentIdsNeedingHydration.add(parentId);
71
71
  }
72
- // Startup stays cache-first: only the local freshness-marker read is awaited.
73
- // Missing markers on an existing remote cache do not force a first-open poll;
74
- // stale checked lanes and empty caches hydrate behind the cached tree.
75
- // WebSocket events and explicit refresh bypass this.
76
- void requestHydration().catch((error) => {
77
- reportStartupHydrationError("Failed to schedule startup container contents hydration:", error);
78
- });
79
72
  return shouldScheduleStaleRootRecovery;
80
73
  }
81
74
  export async function hasStartupContainerSyncWork(state) {
@@ -1 +1 @@
1
- {"version":3,"file":"startupHydration.js","sourceRoot":"","sources":["startupHydration.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n type ContainerContentsPersistence,\n ContainerSyncWatermarkRepository,\n createContainerParentSyncLane,\n type ExecSql,\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;\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: ExecSql };\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 new ContainerSyncWatermarkRepository(\n state.runtime.infra.execSql,\n ).loadCheckRecords(syncLanes);\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: ExecSql } };\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 [\n containersWithPendingMetadata,\n containersWithPullContinuations,\n owedMetadataReads,\n ] = await Promise.all([\n state.persistence.listContainerIdsWithPendingUpdates(execSql, containerIds),\n state.persistence.listContainerIdsWithPullContinuations(\n execSql,\n containerIds,\n ),\n // A read a listing owed before the restart needs a pass even when the\n // cached tree is fresh and no connection is acknowledged.\n state.persistence.listContainerMetadataRevalidations(execSql),\n ]);\n return (\n containersWithPendingMetadata.length > 0 ||\n containersWithPullContinuations.length > 0 ||\n owedMetadataReads.length > 0\n );\n}\n"]}
1
+ {"version":3,"file":"startupHydration.js","sourceRoot":"","sources":["startupHydration.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n type ContainerContentsPersistence,\n ContainerSyncWatermarkRepository,\n createContainerParentSyncLane,\n type ExecSql,\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;\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: ExecSql };\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 new ContainerSyncWatermarkRepository(\n state.runtime.infra.execSql,\n ).loadCheckRecords(syncLanes);\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 inspectStartupHydration(input: {\n isCurrent?: (() => boolean) | undefined;\n state: StartupHydrationState;\n}): Promise<boolean> {\n const { 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 return shouldScheduleStaleRootRecovery;\n}\n\nexport async function hasStartupContainerSyncWork(state: {\n containersById: ReadonlyMap<string, unknown>;\n persistence: ContainerContentsPersistence;\n runtime: { infra: { execSql: ExecSql } };\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 [\n containersWithPendingMetadata,\n containersWithPullContinuations,\n owedMetadataReads,\n ] = await Promise.all([\n state.persistence.listContainerIdsWithPendingUpdates(execSql, containerIds),\n state.persistence.listContainerIdsWithPullContinuations(\n execSql,\n containerIds,\n ),\n // A read a listing owed before the restart needs a pass even when the\n // cached tree is fresh and no connection is acknowledged.\n state.persistence.listContainerMetadataRevalidations(execSql),\n ]);\n return (\n containersWithPendingMetadata.length > 0 ||\n containersWithPullContinuations.length > 0 ||\n owedMetadataReads.length > 0\n );\n}\n"]}
@@ -0,0 +1,61 @@
1
+ function sameOwner(left, right) {
2
+ return (left.lifecycleGeneration === right.lifecycleGeneration &&
3
+ left.writeGeneration === right.writeGeneration);
4
+ }
5
+ function transition(state, event) {
6
+ switch (event.type) {
7
+ case "requested":
8
+ return { status: "queued", owner: event.owner };
9
+ case "start":
10
+ if (state.status === "idle")
11
+ return state;
12
+ if (!sameOwner(state.owner, event.owner))
13
+ return { status: "idle" };
14
+ if (state.status === "incomplete" && !event.fullTree)
15
+ return state;
16
+ return { status: "incomplete", owner: state.owner };
17
+ case "covered":
18
+ return state === event.reset ? { status: "idle" } : state;
19
+ }
20
+ }
21
+ const resets = new WeakMap();
22
+ function dispatch(store, event) {
23
+ const next = transition(resets.get(store) ?? { status: "idle" }, event);
24
+ if (next.status === "idle")
25
+ resets.delete(store);
26
+ else
27
+ resets.set(store, next);
28
+ return next;
29
+ }
30
+ function captureOwner(store) {
31
+ return {
32
+ lifecycleGeneration: store.lifecycleGeneration,
33
+ ...(store.writeGeneration !== undefined
34
+ ? { writeGeneration: store.writeGeneration }
35
+ : {}),
36
+ };
37
+ }
38
+ export function captureTreeResetOwner(store) {
39
+ const owner = captureOwner(store);
40
+ return () => sameOwner(owner, store);
41
+ }
42
+ export function queueTreeReset(store) {
43
+ const owner = captureOwner(store);
44
+ dispatch(store, { type: "requested", owner });
45
+ return () => sameOwner(owner, store);
46
+ }
47
+ export function claimTreeReset(store, fullTree) {
48
+ const previous = resets.get(store);
49
+ if (!previous)
50
+ return;
51
+ const reset = dispatch(store, { type: "start", owner: store, fullTree });
52
+ if (reset.status !== "incomplete" || reset === previous)
53
+ return;
54
+ return {
55
+ isOwned: () => sameOwner(reset.owner, store),
56
+ cover: () => {
57
+ dispatch(store, { type: "covered", reset });
58
+ },
59
+ };
60
+ }
61
+ //# sourceMappingURL=treeResetMachine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"treeResetMachine.js","sourceRoot":"","sources":["treeResetMachine.ts"],"names":[],"mappings":"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","sourcesContent":["// A manual request can lend its watermark reset to the crawl that consumes\n// the shared lane queue. Socket acknowledgements change the crawl, while\n// identity, storage and write ownership determine who can inherit the reset.\ninterface Owner {\n lifecycleGeneration: number;\n writeGeneration?: number;\n}\ntype Reset = { status: \"queued\" | \"incomplete\"; owner: Owner };\ntype State = Reset | { status: \"idle\" };\ntype Event =\n | { type: \"requested\"; owner: Owner }\n | { type: \"start\"; owner: Owner; fullTree: boolean }\n | { type: \"covered\"; reset: Reset };\n\nfunction sameOwner(left: Owner, right: Owner): boolean {\n return (\n left.lifecycleGeneration === right.lifecycleGeneration &&\n left.writeGeneration === right.writeGeneration\n );\n}\n\nfunction transition(state: State, event: Event): State {\n switch (event.type) {\n case \"requested\":\n return { status: \"queued\", owner: event.owner };\n case \"start\":\n if (state.status === \"idle\") return state;\n if (!sameOwner(state.owner, event.owner)) return { status: \"idle\" };\n if (state.status === \"incomplete\" && !event.fullTree) return state;\n return { status: \"incomplete\", owner: state.owner };\n case \"covered\":\n return state === event.reset ? { status: \"idle\" } : state;\n }\n}\n\nconst resets = new WeakMap<Owner, State>();\n\nfunction dispatch(store: Owner, event: Event): State {\n const next = transition(resets.get(store) ?? { status: \"idle\" }, event);\n if (next.status === \"idle\") resets.delete(store);\n else resets.set(store, next);\n return next;\n}\n\nfunction captureOwner(store: Owner): Owner {\n return {\n lifecycleGeneration: store.lifecycleGeneration,\n ...(store.writeGeneration !== undefined\n ? { writeGeneration: store.writeGeneration }\n : {}),\n };\n}\n\nexport function captureTreeResetOwner(store: Owner): () => boolean {\n const owner = captureOwner(store);\n return () => sameOwner(owner, store);\n}\n\nexport function queueTreeReset(store: Owner): () => boolean {\n const owner = captureOwner(store);\n dispatch(store, { type: \"requested\", owner });\n return () => sameOwner(owner, store);\n}\n\nexport function claimTreeReset(\n store: Owner,\n fullTree: boolean,\n): { isOwned: () => boolean; cover: () => void } | undefined {\n const previous = resets.get(store);\n if (!previous) return;\n const reset = dispatch(store, { type: \"start\", owner: store, fullTree });\n if (reset.status !== \"incomplete\" || reset === previous) return;\n return {\n isOwned: () => sameOwner(reset.owner, store),\n cover: () => {\n dispatch(store, { type: \"covered\", reset });\n },\n };\n}\n"]}
@@ -6,6 +6,7 @@ import { currentMetadataPullContinuation } from "../../workflows/container-conte
6
6
  import { reconcileLocalOnlyRootContainers } from "../../workflows/container-contents/remoteHydration/reconciliation.js";
7
7
  import { isDatabaseUnavailableError } from "../../workflows/container-contents/syncLane.js";
8
8
  import { captureContainerStateMutationGenerations, containerStateMutatedAfter, } from "./containerState/containerStateMap.js";
9
+ import { ownsContainerStore, } from "./containerState/storeScope.js";
9
10
  import { isRemoteBackedContainerState } from "./remoteEvents/remoteBackedContainerState.js";
10
11
  function readMetadataDocVersion(state) {
11
12
  try {
@@ -103,19 +104,29 @@ function reportLocalContainerRefreshFailure(util, error) {
103
104
  // Hosts may throw synchronously or return a rejected promise.
104
105
  }
105
106
  }
107
+ const guardedReads = new WeakMap();
108
+ function joinLocalRead(input) {
109
+ const { state } = input;
110
+ const active = state.localContainerRefreshPromise;
111
+ if (active) {
112
+ const owner = guardedReads.get(active);
113
+ // Ordinary callers share the same promise. If a cancelled reconnect
114
+ // owned the read, the successor still needs a current local snapshot.
115
+ if (!owner)
116
+ return active;
117
+ return active.then(() => !owner() && state.localContainersNeedRefresh
118
+ ? refreshLocalContainerStates(input)
119
+ : undefined);
120
+ }
121
+ return null;
122
+ }
106
123
  export function refreshLocalContainerStates(input) {
107
124
  const { host, state } = input;
108
- if (state.localContainerRefreshPromise) {
109
- const activeRefresh = state.localContainerRefreshPromise;
110
- if (state.localContainerRefreshGeneration === state.lifecycleGeneration &&
111
- state.localContainerRefreshStructuralGeneration ===
112
- state.structuralGeneration) {
113
- return activeRefresh;
114
- }
115
- // A stale refresh owns its replacement retry in `finally`, so callers can
116
- // share that promise without scheduling a second replacement load.
117
- return activeRefresh;
118
- }
125
+ if (!ownsContainerStore(state) || input.stillCurrent?.() === false)
126
+ return Promise.resolve();
127
+ const joined = joinLocalRead(input);
128
+ if (joined)
129
+ return joined;
119
130
  if (!state.localContainersNeedRefresh ||
120
131
  !state.initialized ||
121
132
  state.runtime.infra.dbStatus !== "ready") {
@@ -123,7 +134,9 @@ export function refreshLocalContainerStates(input) {
123
134
  }
124
135
  const lifecycleGeneration = state.lifecycleGeneration;
125
136
  const structuralGeneration = state.structuralGeneration;
126
- const isCurrent = () => state.lifecycleGeneration === lifecycleGeneration &&
137
+ const isCurrent = () => ownsContainerStore(state) &&
138
+ input.stillCurrent?.() !== false &&
139
+ state.lifecycleGeneration === lifecycleGeneration &&
127
140
  state.structuralGeneration === structuralGeneration;
128
141
  state.localContainersNeedRefresh = false;
129
142
  const liveStateBaselines = captureLocalContainerRefreshBaselines(state.containersById);
@@ -137,6 +150,7 @@ export function refreshLocalContainerStates(input) {
137
150
  state.localContainerRefreshGeneration = lifecycleGeneration;
138
151
  state.localContainerRefreshStructuralGeneration = structuralGeneration;
139
152
  const refreshPromise = loadLocalContainerStates({
153
+ isCurrent,
140
154
  persistence: state.persistence,
141
155
  runtime: state.runtime,
142
156
  })
@@ -183,6 +197,8 @@ export function refreshLocalContainerStates(input) {
183
197
  }
184
198
  return undefined;
185
199
  });
200
+ if (input.stillCurrent)
201
+ guardedReads.set(refreshPromise, input.stillCurrent);
186
202
  state.localContainerRefreshPromise = refreshPromise;
187
203
  return refreshPromise;
188
204
  }
@@ -1 +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 \"./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"]}
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 \"./containerState/containerStateMap\";\nimport {\n type ContainerStoreScope,\n ownsContainerStore,\n} from \"./containerState/storeScope\";\nimport { isRemoteBackedContainerState } from \"./remoteEvents/remoteBackedContainerState\";\n\ninterface LocalContainerRefreshHost {\n updateSnapshot: () => void;\n}\n\nexport interface LocalContainerRefreshState extends ContainerStoreScope {\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 & ContainerStoreScope[\"runtime\"];\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\nconst guardedReads = new WeakMap<Promise<void>, () => boolean>();\n\ninterface LocalRefreshInput {\n host: LocalContainerRefreshHost;\n stillCurrent?: (() => boolean) | undefined;\n state: LocalContainerRefreshState;\n}\n\nfunction joinLocalRead(input: LocalRefreshInput): Promise<void> | null {\n const { state } = input;\n const active = state.localContainerRefreshPromise;\n if (active) {\n const owner = guardedReads.get(active);\n // Ordinary callers share the same promise. If a cancelled reconnect\n // owned the read, the successor still needs a current local snapshot.\n if (!owner) return active;\n return active.then(() =>\n !owner() && state.localContainersNeedRefresh\n ? refreshLocalContainerStates(input)\n : undefined,\n );\n }\n return null;\n}\n\nexport function refreshLocalContainerStates(\n input: LocalRefreshInput,\n): Promise<void> {\n const { host, state } = input;\n if (!ownsContainerStore(state) || input.stillCurrent?.() === false)\n return Promise.resolve();\n const joined = joinLocalRead(input);\n if (joined) return joined;\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 ownsContainerStore(state) &&\n input.stillCurrent?.() !== false &&\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 isCurrent,\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 if (input.stillCurrent) guardedReads.set(refreshPromise, input.stillCurrent);\n state.localContainerRefreshPromise = refreshPromise;\n\n return refreshPromise;\n}\n"]}
@@ -1,5 +1,6 @@
1
1
  import { errorMessage } from "../../../data/shared/errorMessage.js";
2
2
  import { createRemoteContainerIngestor, } from "../../../workflows/container-contents/remoteHydration/index.js";
3
+ import { ownsContainerStore } from "../containerState/storeScope.js";
3
4
  import { resumeContainerContentsRecoveryHydration } from "../hydration/remoteHydrationRequest.js";
4
5
  import { getContainerContentsStoreLogLabel } from "../logLabel.js";
5
6
  export async function resumeRemoteContainerRecoveryWork(input) {
@@ -20,12 +21,14 @@ export async function resumeRemoteContainerRecoveryWork(input) {
20
21
  export function createRemoteContainerIngestionController(input) {
21
22
  const { host, scheduleSync, state } = input;
22
23
  const remoteContainerIngestor = createRemoteContainerIngestor({
24
+ ownsScope: () => ownsContainerStore(state),
23
25
  getSerializationBarrier: () => state.initializePromise,
24
26
  host,
25
27
  state,
26
28
  });
27
29
  const scheduleAfterIngestion = () => {
28
- if (state.runtime.infra.dbStatus === "ready" &&
30
+ if (ownsContainerStore(state) &&
31
+ state.runtime.infra.dbStatus === "ready" &&
29
32
  state.documentStoresNeedPriming) {
30
33
  scheduleSync();
31
34
  }