tsdf 17.0.4 → 17.0.5

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 (251) hide show
  1. package/dist/async-storage.d.ts +1 -1
  2. package/dist/async-storage.js +1 -1
  3. package/dist/{asyncStorageAdapter-CMohMeKm.d.ts → asyncStorageAdapter-DgsuE-T8.d.ts} +1 -1
  4. package/dist/{asyncStorageAdapter-BuGjbXYA.js → asyncStorageAdapter-URS9eulL.js} +165 -25
  5. package/dist/{asyncStorageAdapters-ClUvxNQA.js → asyncStorageAdapters-Bxrrj_Mt.js} +2 -2
  6. package/dist/indexed-db-storage.d.ts +1 -1
  7. package/dist/indexed-db-storage.js +1 -1
  8. package/dist/{indexedDbPersistentStorage-BSlgLveB.js → indexedDbPersistentStorage-BameJ4st.js} +11 -1
  9. package/dist/main.d.ts +34 -30
  10. package/dist/main.js +856 -257
  11. package/dist/opfs-storage.d.ts +1 -1
  12. package/dist/opfs-storage.js +1 -1
  13. package/dist/{opfsPersistentStorage-Ci0JcCo5.d.ts → opfsPersistentStorage-BngS1m0X.d.ts} +1 -1
  14. package/dist/{opfsPersistentStorage-D_k77Srq.js → opfsPersistentStorage-JsSCNBTr.js} +1 -1
  15. package/dist/{types-D0ttVGmj.d.ts → types-BlyGC_PO.d.ts} +3 -3
  16. package/package.json +1 -1
  17. package/dist/src/async-storage.d.ts +0 -1
  18. package/dist/src/cacheLimits/lruCacheRuntime.d.ts +0 -9
  19. package/dist/src/cacheLimits/scheduleIdleThrottled.d.ts +0 -1
  20. package/dist/src/cacheLimits/useRegisterActiveKeys.d.ts +0 -1
  21. package/dist/src/collectionStore/collectionCacheLimits.d.ts +0 -1
  22. package/dist/src/collectionStore/collectionStore.d.ts +0 -385
  23. package/dist/src/collectionStore/executeBatchFetch.d.ts +0 -6
  24. package/dist/src/collectionStore/useItem.d.ts +0 -15
  25. package/dist/src/collectionStore/useMultipleItems.d.ts +0 -35
  26. package/dist/src/debug.d.ts +0 -30
  27. package/dist/src/documentStore.d.ts +0 -290
  28. package/dist/src/hooks/useListItem.d.ts +0 -22
  29. package/dist/src/hooks/useListItemIsDeleted.d.ts +0 -13
  30. package/dist/src/hooks/useListItemIsLoading.d.ts +0 -16
  31. package/dist/src/indexed-db-storage.d.ts +0 -1
  32. package/dist/src/internal/offlineTestInstrumentation.d.ts +0 -12
  33. package/dist/src/internal/testTimelineTypes.d.ts +0 -1
  34. package/dist/src/invalidationUtils.d.ts +0 -8
  35. package/dist/src/isOffScreenContext.d.ts +0 -16
  36. package/dist/src/listQueryStore/createFetchApi.d.ts +0 -1
  37. package/dist/src/listQueryStore/createMutationApi.d.ts +0 -1
  38. package/dist/src/listQueryStore/executeItemBatchFetch.d.ts +0 -20
  39. package/dist/src/listQueryStore/executeQueryFetch.d.ts +0 -7
  40. package/dist/src/listQueryStore/itemFieldUtils.d.ts +0 -77
  41. package/dist/src/listQueryStore/listQueryCacheLimits.d.ts +0 -1
  42. package/dist/src/listQueryStore/listQueryStore.d.ts +0 -538
  43. package/dist/src/listQueryStore/types.d.ts +0 -347
  44. package/dist/src/listQueryStore/useFindItem.d.ts +0 -7
  45. package/dist/src/listQueryStore/useItem.d.ts +0 -29
  46. package/dist/src/listQueryStore/useListQuery.d.ts +0 -29
  47. package/dist/src/listQueryStore/useMultipleItems.d.ts +0 -44
  48. package/dist/src/listQueryStore/useMultipleListQueries.d.ts +0 -46
  49. package/dist/src/listQueryStore/usePendingOfflineItems.d.ts +0 -19
  50. package/dist/src/main.d.ts +0 -23
  51. package/dist/src/opfs-storage.d.ts +0 -1
  52. package/dist/src/persistentStorage/asyncStorageAdapter.d.ts +0 -95
  53. package/dist/src/persistentStorage/asyncStorageAdapters.d.ts +0 -2
  54. package/dist/src/persistentStorage/asyncStorageShared.d.ts +0 -23
  55. package/dist/src/persistentStorage/collectionStorePersistence.d.ts +0 -26
  56. package/dist/src/persistentStorage/compactListQueryLocalStorageEntry.d.ts +0 -11
  57. package/dist/src/persistentStorage/compactLocalStorageEntry.d.ts +0 -8
  58. package/dist/src/persistentStorage/documentEntryKey.d.ts +0 -1
  59. package/dist/src/persistentStorage/documentStorePersistence.d.ts +0 -17
  60. package/dist/src/persistentStorage/indexedDbAsyncStorageAdapter.d.ts +0 -165
  61. package/dist/src/persistentStorage/indexedDbPersistentStorage.d.ts +0 -6
  62. package/dist/src/persistentStorage/listQueryStorePersistence.d.ts +0 -37
  63. package/dist/src/persistentStorage/localStorageMetadata.d.ts +0 -126
  64. package/dist/src/persistentStorage/navigatorLocks.d.ts +0 -3
  65. package/dist/src/persistentStorage/offline/entityMetadata.d.ts +0 -12
  66. package/dist/src/persistentStorage/offline/fetchRuntime.d.ts +0 -35
  67. package/dist/src/persistentStorage/offline/mutationRuntime.d.ts +0 -31
  68. package/dist/src/persistentStorage/offline/offlineResolution.typeGuards.d.ts +0 -1
  69. package/dist/src/persistentStorage/offline/overlayStoreLifecycle.d.ts +0 -13
  70. package/dist/src/persistentStorage/offline/sessionCoordinator.d.ts +0 -94
  71. package/dist/src/persistentStorage/offline/sessionProtectionRegistry.d.ts +0 -11
  72. package/dist/src/persistentStorage/offline/storeController.d.ts +0 -86
  73. package/dist/src/persistentStorage/offline/types.d.ts +0 -1255
  74. package/dist/src/persistentStorage/offlineUploadRegistry.d.ts +0 -11
  75. package/dist/src/persistentStorage/offlineUploadTypes.d.ts +0 -97
  76. package/dist/src/persistentStorage/offlineUploadsShared.d.ts +0 -4
  77. package/dist/src/persistentStorage/opfsAsyncStorageAdapter.d.ts +0 -24
  78. package/dist/src/persistentStorage/opfsFileNaming.d.ts +0 -23
  79. package/dist/src/persistentStorage/opfsHelpers.d.ts +0 -3
  80. package/dist/src/persistentStorage/opfsOfflineUploadAdapter.d.ts +0 -2
  81. package/dist/src/persistentStorage/opfsPersistentStorage.d.ts +0 -2
  82. package/dist/src/persistentStorage/parsePersistedData.d.ts +0 -45
  83. package/dist/src/persistentStorage/persistenceUtils.d.ts +0 -52
  84. package/dist/src/persistentStorage/persistentStorageDefaults.d.ts +0 -4
  85. package/dist/src/persistentStorage/persistentStorageManager.d.ts +0 -197
  86. package/dist/src/persistentStorage/quotaDebug.d.ts +0 -16
  87. package/dist/src/persistentStorage/scheduleIdleCleanup.d.ts +0 -28
  88. package/dist/src/persistentStorage/storageAdapter.d.ts +0 -41
  89. package/dist/src/persistentStorage/storageEntryPrefixes.d.ts +0 -16
  90. package/dist/src/persistentStorage/types.d.ts +0 -412
  91. package/dist/src/persistentStorage/validateWithSchema.d.ts +0 -12
  92. package/dist/src/requestScheduler.d.ts +0 -81
  93. package/dist/src/storeManager.d.ts +0 -160
  94. package/dist/src/utils/automaticFetchPolicy.d.ts +0 -29
  95. package/dist/src/utils/browserTabsPriority.d.ts +0 -43
  96. package/dist/src/utils/browserTabsSync.d.ts +0 -33
  97. package/dist/src/utils/optimisticMutationTracker.d.ts +0 -20
  98. package/dist/src/utils/optimisticRollback.d.ts +0 -11
  99. package/dist/src/utils/payloadDebounce.d.ts +0 -5
  100. package/dist/src/utils/performMutation.d.ts +0 -19
  101. package/dist/src/utils/reusePrevIfEqual.d.ts +0 -1
  102. package/dist/src/utils/storeFocusLifecycle.d.ts +0 -1
  103. package/dist/src/utils/storeShared.d.ts +0 -126
  104. package/dist/src/utils/useEnsureIsLoaded.d.ts +0 -6
  105. package/dist/src/utils/useRequireFreshData.d.ts +0 -6
  106. package/dist/tests/basic-functionality/collection-store.test.d.ts +0 -1
  107. package/dist/tests/basic-functionality/document-store.test.d.ts +0 -1
  108. package/dist/tests/basic-functionality/list-query-state-manipulation.test.d.ts +0 -1
  109. package/dist/tests/basic-functionality/list-query-store.test.d.ts +0 -1
  110. package/dist/tests/browser-tabs/browser-tabs-background-rtu-batch.test.d.ts +0 -1
  111. package/dist/tests/browser-tabs/browser-tabs-background-rtu.test.d.ts +0 -1
  112. package/dist/tests/browser-tabs/browser-tabs-background-scheduling.test.d.ts +0 -1
  113. package/dist/tests/browser-tabs/browser-tabs-list-query-pagination.test.d.ts +0 -1
  114. package/dist/tests/browser-tabs/browser-tabs-non-cancelable-fetches.test.d.ts +0 -1
  115. package/dist/tests/browser-tabs/browser-tabs-optimistic-sync.test.d.ts +0 -1
  116. package/dist/tests/browser-tabs/browser-tabs-partial-resources.test.d.ts +0 -1
  117. package/dist/tests/browser-tabs/browser-tabs-priority.test.d.ts +0 -1
  118. package/dist/tests/browser-tabs/browser-tabs-snapshot-consistency.test.d.ts +0 -1
  119. package/dist/tests/browser-tabs/browser-tabs-state-methods.test.d.ts +0 -1
  120. package/dist/tests/browser-tabs/browser-tabs-sync-coordinator.test.d.ts +0 -1
  121. package/dist/tests/browser-tabs/browser-tabs-test-helpers.d.ts +0 -69
  122. package/dist/tests/browser-tabs/focus-coordinator.test.d.ts +0 -1
  123. package/dist/tests/hooks/collection-hooks-2.test.d.ts +0 -1
  124. package/dist/tests/hooks/collection-hooks.test.d.ts +0 -1
  125. package/dist/tests/hooks/collection-useListItem.test.d.ts +0 -1
  126. package/dist/tests/hooks/debounce-payload-hooks.test.d.ts +0 -1
  127. package/dist/tests/hooks/disable-refetches.test.d.ts +0 -1
  128. package/dist/tests/hooks/document-hooks-2.test.d.ts +0 -1
  129. package/dist/tests/hooks/document-hooks.test.d.ts +0 -1
  130. package/dist/tests/hooks/document-useListItem.test.d.ts +0 -1
  131. package/dist/tests/hooks/fetch-error-recovery.test.d.ts +0 -1
  132. package/dist/tests/hooks/hook-memoization.test.d.ts +0 -1
  133. package/dist/tests/hooks/list-query-hooks-2.test.d.ts +0 -1
  134. package/dist/tests/hooks/list-query-hooks-3.test.d.ts +0 -1
  135. package/dist/tests/hooks/list-query-hooks-mutations.test.d.ts +0 -1
  136. package/dist/tests/hooks/list-query-hooks.test.d.ts +0 -1
  137. package/dist/tests/hooks/list-query-pending-offline-items.test.d.ts +0 -1
  138. package/dist/tests/hooks/off-screen-context.test.d.ts +0 -1
  139. package/dist/tests/list-query-features/list-query-derived-queries.test.d.ts +0 -1
  140. package/dist/tests/list-query-features/list-query-offset-pagination.test.d.ts +0 -1
  141. package/dist/tests/list-query-features/list-query-optimistic-filters.test.d.ts +0 -1
  142. package/dist/tests/list-query-features/list-query-partial-resources-2.test.d.ts +0 -1
  143. package/dist/tests/list-query-features/list-query-partial-resources-3.test.d.ts +0 -1
  144. package/dist/tests/list-query-features/list-query-partial-resources-regressions.test.d.ts +0 -1
  145. package/dist/tests/list-query-features/list-query-partial-resources-show-partial-status.test.d.ts +0 -1
  146. package/dist/tests/list-query-features/list-query-partial-resources.test.d.ts +0 -1
  147. package/dist/tests/list-query-features/list-query-size-coalescing-partial-resources.test.d.ts +0 -1
  148. package/dist/tests/mocks/browserTabsTestUtils.d.ts +0 -17
  149. package/dist/tests/mocks/collectionStoreTestEnv.d.ts +0 -265
  150. package/dist/tests/mocks/documentStoreTestEnv.d.ts +0 -140
  151. package/dist/tests/mocks/duplicateStoreGuard.test.d.ts +0 -1
  152. package/dist/tests/mocks/listQueryStoreTestEnv.d.ts +0 -295
  153. package/dist/tests/mocks/mockBrowserOpfs.d.ts +0 -70
  154. package/dist/tests/mocks/mockBrowserOpfs.test.d.ts +0 -1
  155. package/dist/tests/mocks/mockLocalStorageStore.d.ts +0 -61
  156. package/dist/tests/mocks/seedScenarioPersistentStorage.d.ts +0 -51
  157. package/dist/tests/mocks/serverMock.d.ts +0 -56
  158. package/dist/tests/mocks/serverTableMock.d.ts +0 -174
  159. package/dist/tests/mocks/testEnvUtils.d.ts +0 -120
  160. package/dist/tests/mocks/testScenarioPersistentStorage.test.d.ts +0 -1
  161. package/dist/tests/offline/offline-fetching-scenarios.test.d.ts +0 -1
  162. package/dist/tests/offline/offline-mixed-adapter-storage.test.d.ts +0 -1
  163. package/dist/tests/offline/offline-mutation-fallback.test.d.ts +0 -1
  164. package/dist/tests/offline/offline-network-recovery.test.d.ts +0 -1
  165. package/dist/tests/offline/offline-outage.test.d.ts +0 -1
  166. package/dist/tests/offline/offline-overlays.test.d.ts +0 -1
  167. package/dist/tests/offline/offline-query-replay.test.d.ts +0 -1
  168. package/dist/tests/offline/offline-reads.test.d.ts +0 -1
  169. package/dist/tests/offline/offline-replay-conflicts.test.d.ts +0 -1
  170. package/dist/tests/offline/offline-replay-queueing.test.d.ts +0 -1
  171. package/dist/tests/offline/offline-resolution-dependencies.test.d.ts +0 -1
  172. package/dist/tests/offline/offline-runtime-controls.test.d.ts +0 -1
  173. package/dist/tests/offline/offline-session-and-global-state.test.d.ts +0 -1
  174. package/dist/tests/offline/offline-storage.test.d.ts +0 -1
  175. package/dist/tests/offline/offline-uploads.test.d.ts +0 -1
  176. package/dist/tests/offline/offlineReplayTestShared.d.ts +0 -292
  177. package/dist/tests/offline/offlineTestShared.d.ts +0 -156
  178. package/dist/tests/perform-mutation/mutation-error-rollback.test.d.ts +0 -1
  179. package/dist/tests/perform-mutation/perform-mutation-block-window-close.test.d.ts +0 -1
  180. package/dist/tests/perform-mutation/perform-mutation-debounce.test.d.ts +0 -1
  181. package/dist/tests/perform-mutation/store-events.test.d.ts +0 -1
  182. package/dist/tests/persistent-storage/async-storage-efficiency/collection.test.d.ts +0 -1
  183. package/dist/tests/persistent-storage/async-storage-efficiency/document.test.d.ts +0 -1
  184. package/dist/tests/persistent-storage/async-storage-efficiency/list-query.test.d.ts +0 -1
  185. package/dist/tests/persistent-storage/async-storage-efficiency/maintenance.test.d.ts +0 -1
  186. package/dist/tests/persistent-storage/async-storage-efficiency/shared.d.ts +0 -804
  187. package/dist/tests/persistent-storage/async-storage-shared.test.d.ts +0 -1
  188. package/dist/tests/persistent-storage/collection-store-persistence.converted.opfs.test.d.ts +0 -1
  189. package/dist/tests/persistent-storage/collection-store-persistence.converted.test.d.ts +0 -1
  190. package/dist/tests/persistent-storage/collection-store-persistence.opfs.test.d.ts +0 -1
  191. package/dist/tests/persistent-storage/collection-store-persistence.test.d.ts +0 -1
  192. package/dist/tests/persistent-storage/document-store-persistence.converted.opfs.test.d.ts +0 -1
  193. package/dist/tests/persistent-storage/document-store-persistence.converted.test.d.ts +0 -1
  194. package/dist/tests/persistent-storage/document-store-persistence.opfs.test.d.ts +0 -1
  195. package/dist/tests/persistent-storage/document-store-persistence.test.d.ts +0 -1
  196. package/dist/tests/persistent-storage/expiration-scan.test.d.ts +0 -1
  197. package/dist/tests/persistent-storage/indexeddb-async-storage-efficiency/collection.test.d.ts +0 -1
  198. package/dist/tests/persistent-storage/indexeddb-async-storage-efficiency/document.test.d.ts +0 -1
  199. package/dist/tests/persistent-storage/indexeddb-async-storage-efficiency/list-query.test.d.ts +0 -1
  200. package/dist/tests/persistent-storage/indexeddb-async-storage-efficiency/maintenance.test.d.ts +0 -1
  201. package/dist/tests/persistent-storage/indexeddb-async-storage-efficiency/shared.d.ts +0 -780
  202. package/dist/tests/persistent-storage/indexeddb-storage-adapter.test.d.ts +0 -1
  203. package/dist/tests/persistent-storage/list-query-store-persistence.converted.opfs.test.d.ts +0 -1
  204. package/dist/tests/persistent-storage/list-query-store-persistence.converted.test.d.ts +0 -1
  205. package/dist/tests/persistent-storage/list-query-store-persistence.opfs.test.d.ts +0 -1
  206. package/dist/tests/persistent-storage/list-query-store-persistence.test.d.ts +0 -1
  207. package/dist/tests/persistent-storage/persistence-with-tabs-sync.test.d.ts +0 -1
  208. package/dist/tests/persistent-storage/persistentStorageByteBudgetTestUtils.d.ts +0 -18
  209. package/dist/tests/persistent-storage/quota-exceeded-recovery-no-locks.test.d.ts +0 -1
  210. package/dist/tests/persistent-storage/quota-exceeded-recovery.test.d.ts +0 -1
  211. package/dist/tests/persistent-storage/quotaRecoveryTestUtils.d.ts +0 -228
  212. package/dist/tests/persistent-storage/storage-adapter.test.d.ts +0 -1
  213. package/dist/tests/persistent-storage/sync-storage-efficiency/collection.test.d.ts +0 -1
  214. package/dist/tests/persistent-storage/sync-storage-efficiency/document.test.d.ts +0 -1
  215. package/dist/tests/persistent-storage/sync-storage-efficiency/list-query.test.d.ts +0 -1
  216. package/dist/tests/persistent-storage/sync-storage-efficiency/maintenance.test.d.ts +0 -1
  217. package/dist/tests/persistent-storage/sync-storage-efficiency/shared.d.ts +0 -784
  218. package/dist/tests/playwright/browser-tabs.spec.d.ts +0 -1
  219. package/dist/tests/playwright/persistent-storage.spec.d.ts +0 -1
  220. package/dist/tests/request-schedulling/batch-medium-priority.test.d.ts +0 -1
  221. package/dist/tests/request-schedulling/batch-realtime-updates.test.d.ts +0 -1
  222. package/dist/tests/request-schedulling/collection-batch-coalescing.test.d.ts +0 -1
  223. package/dist/tests/request-schedulling/collection-batch-key-grouping.test.d.ts +0 -1
  224. package/dist/tests/request-schedulling/collection-fetch-orchestration.test.d.ts +0 -1
  225. package/dist/tests/request-schedulling/document-await-fetch.test.d.ts +0 -1
  226. package/dist/tests/request-schedulling/document-base-coalescing.test.d.ts +0 -1
  227. package/dist/tests/request-schedulling/document-fetch-orchestration.test.d.ts +0 -1
  228. package/dist/tests/request-schedulling/document-medium-priority-fetch.test.d.ts +0 -1
  229. package/dist/tests/request-schedulling/document-realtime-updates.test.d.ts +0 -1
  230. package/dist/tests/request-schedulling/list-query-item-batch-coalescing.test.d.ts +0 -1
  231. package/dist/tests/request-schedulling/list-query-item-batch-key-grouping.test.d.ts +0 -1
  232. package/dist/tests/request-schedulling/list-query-size-coalescing.test.d.ts +0 -1
  233. package/dist/tests/request-schedulling/medium-vs-realtime.test.d.ts +0 -1
  234. package/dist/tests/request-schedulling/request-scheduler-cross-tab-sync.test.d.ts +0 -1
  235. package/dist/tests/request-schedulling/window-focus.test.d.ts +0 -1
  236. package/dist/tests/store-manager.test.d.ts +0 -1
  237. package/dist/tests/user-facing-api/collection-offline-usage.test.d.ts +0 -1
  238. package/dist/tests/user-facing-api/document-offline-usage.test.d.ts +0 -1
  239. package/dist/tests/user-facing-api/list-query-offline-usage.test.d.ts +0 -1
  240. package/dist/tests/user-facing-api/result-returning-callbacks.test.d.ts +0 -1
  241. package/dist/tests/utils/genericTestUtils.d.ts +0 -6
  242. package/dist/tests/utils/indexedDbPersistentStorageOptimizationTestUtils.d.ts +0 -79
  243. package/dist/tests/utils/indexedDbPersistentStorageTestStore.d.ts +0 -181
  244. package/dist/tests/utils/listQueryHooksTestUtils.d.ts +0 -8
  245. package/dist/tests/utils/networkMock.d.ts +0 -11
  246. package/dist/tests/utils/opfsPersistentStorageTestStore.d.ts +0 -220
  247. package/dist/tests/utils/persistentStorageOptimizationTestUtils.d.ts +0 -54
  248. package/dist/tests/utils/persistentStorageOptimizationTestUtils.test.d.ts +0 -1
  249. package/dist/tests/utils/persistentStorageTestStore.d.ts +0 -66
  250. package/dist/tests/utils/resetSessionForTests.d.ts +0 -3
  251. package/dist/tests/utils/withSuppressedActError.d.ts +0 -4
package/dist/main.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { $ as OfflineResolutionRecord, $t as StoreError, A as DefineListQueryOfflineOperations, At as DerivedQuerySource, B as OfflineEntityMutationKind, Bt as OptimisticListUpdate, C as PersistentStorageSchema, Ct as OfflineUploadAdapter, D as CollectionOfflineOperationDefinition, Dt as OfflineUploadTransportContext, E as CollectionOfflineEntityRef, Et as OfflineUploadState, F as ListQueryOfflineEntityRef, Ft as ListQueryUseMultipleItemsQuery, G as OfflineMutationQueueingPolicy, Gt as TSFDListQuery, H as OfflineMutationInput, Ht as QueryFetchPayload, I as ListQueryOfflineOperationDefinition, It as ListQueryUseMultipleListQueriesQuery, J as OfflineReplayRetryConfig, Jt as TSFDUseListQueryReturn, K as OfflineOperationKind, Kt as TSFDListQueryState, L as OfflineAccumulationConfig, Lt as OffsetPaginationConfig, M as DocumentOfflineOperationDefinition, Mt as FetchListFnReturnItem, N as GlobalOfflineEntity, Nt as FieldsInput, O as DefineCollectionOfflineOperations, Ot as DerivedQueriesConfig, P as GlobalOfflineStatus, Pt as FieldsOption, Q as OfflineResolutionConflictParseErrorCode, Qt as PayloadDebounce, R as OfflineAccumulationMergeContext, Rt as OnListQueryInvalidate, S as PersistentStoragePreloadResult, St as OfflineUpload, T as AnyOfflineOperationDefinition, Tt as OfflineUploadSource, U as OfflineMutationQueueingCause, Ut as QueryStatus, V as OfflineMutationDescriptor, Vt as PartialResourcesConfig, W as OfflineMutationQueueingConfig, Wt as TSDFItemQuery, X as OfflineResolutionActionForOperation, Xt as MaybeTSDFResult, Y as OfflineResolutionAction, Yt as TSFDUsePendingOfflineItemsReturn, Z as OfflineResolutionConflictParseError, Zt as MutationSkipped, _ as ListQueryOfflineOperationsConfig, _n as TSDFDebugLogger, _t as defaultOfflineRuntimeConfig, a as AsyncStorageMetadataOrder, an as ValidPayload, at as OfflineSession, b as PersistentStorageDataSchema, bt as OfflineSessionUploadsConfig, c as AsyncStorageNamespaceCommitUpsert, cn as mutationSkipped, ct as OfflineSyncState, d as AsyncStorageNamespaceKind, dn as RequestSchedulerEvents, dt as OfflineTempEntityConfig, en as StoreFetchError, et as OfflineResolutionRecordForOperation, f as AsyncStorageNamespaceScope, fn as ScheduleFetchOptions, ft as OfflineTempEntityPendingEntry, g as DocumentPersistentStorageConfig, gn as TSDFDebugLogLevel, gt as ParsedOfflineResolutionConflictResultForStore, h as ConvertedPersistentStorageDataSchema, hn as TSDFDebugLogEntry, ht as ParsedOfflineResolutionConflictResultForOperation, i as AsyncStorageDriverSetEntry, in as UnwrapTSDFResult, it as OfflineRuntimeConfigUpdate, j as DefineOfflineOperation, jt as FetchListFnReturn, k as DefineDocumentOfflineOperations, kt as DerivedQueryContext, l as AsyncStorageNamespaceGetResult, ln as FetchType, lt as OfflineTempEntitiesConfig, m as CollectionPersistentStorageConfig, mn as TSDFDebugLogArea, mt as OperationResult, n as AsyncStorageDiscoveredScope, nn as StoreMutationErrorOptions, nt as OfflineRetryExhaustedResolutionAction, o as AsyncStorageNamespaceCommitArgs, on as ValidStoreState, ot as OfflineSessionConfig, p as AsyncStorageReadOptions, pn as ScheduleFetchResults, pt as OperationConflict, q as OfflineQueueEntry, qt as TSFDUseListItemReturn, r as AsyncStorageDriver, rn as TSDFStatus, rt as OfflineRuntimeConfig, s as AsyncStorageNamespaceCommitTouch, sn as fetchTypePriority, st as OfflineSupersedeConfig, t as AsyncStorageAdapter, tn as StoreMutationError, tt as OfflineResolutionRecordForStore, u as AsyncStorageNamespaceHandle, un as RequestSchedulerEventData, ut as OfflineTempEntitiesReconciliation, v as ListQueryPersistentStorageConfig, vn as TSDFFocusDebugOperation, vt as OfflineMutationUploadsInput, w as StorageAdapter, wt as OfflineUploadProgress, x as PersistentStorageErrorHandler, xt as OfflineStoredUploadRecord, y as PersistentStorageBaseConfig, yn as TSDFLoggerOptions, yt as OfflineOperationUploadsContext, z as OfflineConflictResolutionAction, zt as OnListQueryItemInvalidate } from "./types-D0ttVGmj.js";
1
+ import { $ as OfflineResolutionRecord, $t as StoreError, A as DefineListQueryOfflineOperations, At as DerivedQuerySource, B as OfflineEntityMutationKind, Bt as OptimisticListUpdate, C as PersistentStorageSchema, Ct as OfflineUploadAdapter, D as CollectionOfflineOperationDefinition, Dt as OfflineUploadTransportContext, E as CollectionOfflineEntityRef, Et as OfflineUploadState, F as ListQueryOfflineEntityRef, Ft as ListQueryUseMultipleItemsQuery, G as OfflineMutationQueueingPolicy, Gt as TSFDListQuery, H as OfflineMutationInput, Ht as QueryFetchPayload, I as ListQueryOfflineOperationDefinition, It as ListQueryUseMultipleListQueriesQuery, J as OfflineReplayRetryConfig, Jt as TSFDUseListQueryReturn, K as OfflineOperationKind, Kt as TSFDListQueryState, L as OfflineAccumulationConfig, Lt as OffsetPaginationConfig, M as DocumentOfflineOperationDefinition, Mt as FetchListFnReturnItem, N as GlobalOfflineEntity, Nt as FieldsInput, O as DefineCollectionOfflineOperations, Ot as DerivedQueriesConfig, P as GlobalOfflineStatus, Pt as FieldsOption, Q as OfflineResolutionConflictParseErrorCode, Qt as PayloadDebounce, R as OfflineAccumulationMergeContext, Rt as OnListQueryInvalidate, S as PersistentStoragePreloadResult, St as OfflineUpload, T as AnyOfflineOperationDefinition, Tt as OfflineUploadSource, U as OfflineMutationQueueingCause, Ut as QueryStatus, V as OfflineMutationDescriptor, Vt as PartialResourcesConfig, W as OfflineMutationQueueingConfig, Wt as TSDFItemQuery, X as OfflineResolutionActionForOperation, Xt as MaybeTSDFResult, Y as OfflineResolutionAction, Yt as TSFDUsePendingOfflineItemsReturn, Z as OfflineResolutionConflictParseError, Zt as MutationSkipped, _ as ListQueryOfflineOperationsConfig, _n as TSDFDebugLogger, _t as defaultOfflineRuntimeConfig, a as AsyncStorageMetadataOrder, an as ValidPayload, at as OfflineSession, b as PersistentStorageDataSchema, bt as OfflineSessionUploadsConfig, c as AsyncStorageNamespaceCommitUpsert, cn as mutationSkipped, ct as OfflineSyncState, d as AsyncStorageNamespaceKind, dn as RequestSchedulerEvents, dt as OfflineTempEntityConfig, en as StoreFetchError, et as OfflineResolutionRecordForOperation, f as AsyncStorageNamespaceScope, fn as ScheduleFetchOptions, ft as OfflineTempEntityPendingEntry, g as DocumentPersistentStorageConfig, gn as TSDFDebugLogLevel, gt as ParsedOfflineResolutionConflictResultForStore, h as ConvertedPersistentStorageDataSchema, hn as TSDFDebugLogEntry, ht as ParsedOfflineResolutionConflictResultForOperation, i as AsyncStorageDriverSetEntry, in as UnwrapTSDFResult, it as OfflineRuntimeConfigUpdate, j as DefineOfflineOperation, jt as FetchListFnReturn, k as DefineDocumentOfflineOperations, kt as DerivedQueryContext, l as AsyncStorageNamespaceGetResult, ln as FetchType, lt as OfflineTempEntitiesConfig, m as CollectionPersistentStorageConfig, mn as TSDFDebugLogArea, mt as OperationResult, n as AsyncStorageDiscoveredScope, nn as StoreMutationErrorOptions, nt as OfflineRetryExhaustedResolutionAction, o as AsyncStorageNamespaceCommitArgs, on as ValidStoreState, ot as OfflineSessionConfig, p as AsyncStorageReadOptions, pn as ScheduleFetchResults, pt as OperationConflict, q as OfflineQueueEntry, qt as TSFDUseListItemReturn, r as AsyncStorageDriver, rn as TSDFStatus, rt as OfflineRuntimeConfig, s as AsyncStorageNamespaceCommitTouch, sn as fetchTypePriority, st as OfflineSupersedeConfig, t as AsyncStorageAdapter, tn as StoreMutationError, tt as OfflineResolutionRecordForStore, u as AsyncStorageNamespaceHandle, un as RequestSchedulerEventData, ut as OfflineTempEntitiesReconciliation, v as ListQueryPersistentStorageConfig, vn as TSDFFocusDebugOperation, vt as OfflineMutationUploadsInput, w as StorageAdapter, wt as OfflineUploadProgress, x as PersistentStorageErrorHandler, xt as OfflineStoredUploadRecord, y as PersistentStorageBaseConfig, yn as TSDFLoggerOptions, yt as OfflineOperationUploadsContext, z as OfflineConflictResolutionAction, zt as OnListQueryItemInvalidate } from "./types-BlyGC_PO.js";
2
2
  import { __LEGIT_ANY__ } from "@ls-stack/utils/saferTyping";
3
3
  import { Emitter } from "evtmitter";
4
4
  import { Context } from "react";
@@ -141,11 +141,12 @@ type UseMultipleItemsOptions$1<ItemState extends ValidStoreState, Selected> = {
141
141
  //#region src/collectionStore/useItem.d.ts
142
142
  type UseItemOptions$1<ItemState extends ValidStoreState, Selected> = UseMultipleItemsOptions$1<ItemState, Selected> & {
143
143
  /**
144
- * Forces a high-priority fetch on mount and keeps the hook in `loading`
145
- * until the current payload finishes loading. Cannot be combined with
146
- * `debouncePayload`.
144
+ * Unconditionally schedules a high-priority fetch on mount and reports
145
+ * `loading` until that refresh succeeds or fails, even when cached data
146
+ * exists. Use sparingly because each mount can cause an extra request.
147
+ * Cannot be combined with `debouncePayload`.
147
148
  */
148
- ensureIsLoaded?: boolean;
149
+ requireFreshData?: boolean;
149
150
  };
150
151
  //#endregion
151
152
  //#region src/collectionStore/collectionStore.d.ts
@@ -168,7 +169,7 @@ type TSFDUseCollectionItemReturn<Selected, ItemPayload, QueryMetadata extends un
168
169
  status: CollectionItemStatus | 'idle' | 'deleted'; /** Item payload for this result, unless omitted or unavailable. */
169
170
  payload: ItemPayload | undefined; /** Last item fetch error, if any. */
170
171
  error: StoreError | null; /** Stable store key for the current item payload. */
171
- itemStateKey: string; /** Convenience flag for `loading` or `refetching` states. */
172
+ itemStateKey: string; /** Shorthand for `status === 'loading'`. Stays `false` while loaded data is `refetching`. */
172
173
  isLoading: boolean; /** Whether this result has local offline changes that still need to sync to the server. */
173
174
  pendingSync: boolean; /** Caller-provided metadata copied from the query descriptor. */
174
175
  queryMetadata: QueryMetadata;
@@ -372,21 +373,21 @@ type CollectionStore<ItemState extends ValidStoreState, ItemPayload extends Vali
372
373
  useListItemIsLoading: (payload: ItemPayload, args: {
373
374
  /** Unique identifier of the sub-item within the collection item. */itemId: string; /** Extracts the sub-item from the collection item data. */
374
375
  selector: (data: ItemState | null) => unknown; /** Called if the sub-item is still missing and no refetch is in progress. */
375
- loadItemFallback?: () => void; /** Forces a high-priority fetch and keeps the hook loading until data is loaded. */
376
- ensureIsLoaded?: boolean;
376
+ loadItemFallback?: () => void; /** Requires a mount refresh before reporting ready. May cause an extra request. */
377
+ requireFreshData?: boolean;
377
378
  }) => boolean; /** React hook that tracks whether a nested list item has been deleted. */
378
379
  useListItemIsDeleted: (payload: ItemPayload, args: {
379
380
  /** Unique identifier of the sub-item within the collection item. */itemId: string; /** Extracts the sub-item from the collection item data. */
380
381
  selector: (data: ItemState | null) => unknown; /** Called once when deletion is detected. */
381
- onDelete?: () => void; /** Forces a high-priority fetch and keeps the hook loading until data is loaded. */
382
- ensureIsLoaded?: boolean;
382
+ onDelete?: () => void; /** Requires a mount refresh before reporting ready. May cause an extra request. */
383
+ requireFreshData?: boolean;
383
384
  }) => boolean; /** React hook for selecting one nested list item plus loading/deleted flags. */
384
385
  useListItem: <Selected>(payload: ItemPayload, args: {
385
386
  /** Unique identifier of the sub-item within the collection item. */itemId: string; /** Extracts and maps the sub-item from the collection item data. */
386
387
  selector: (data: ItemState | null) => Selected; /** Called if the sub-item is still missing and no refetch is in progress. */
387
388
  loadItemFallback?: () => void; /** Called once when deletion is detected. */
388
- onDelete?: () => void; /** Forces a high-priority fetch and keeps the hook loading until data is loaded. */
389
- ensureIsLoaded?: boolean;
389
+ onDelete?: () => void; /** Requires a mount refresh before reporting ready. May cause an extra request. */
390
+ requireFreshData?: boolean;
390
391
  }) => {
391
392
  isLoading: boolean;
392
393
  isDeleted: boolean;
@@ -431,7 +432,7 @@ type DocumentStatus = 'idle' | TSDFStatus;
431
432
  type TSDFUseDocumentReturn<Selected> = {
432
433
  /** Hook-visible document status. */status: DocumentStatus; /** Selected document data. Defaults to the full document or `null`. */
433
434
  data: Selected; /** Last document fetch error, if any. */
434
- error: StoreError | null; /** Convenience flag for `loading` or `refetching` states. */
435
+ error: StoreError | null; /** Shorthand for `status === 'loading'`. Stays `false` while loaded data is `refetching`. */
435
436
  isLoading: boolean; /** Whether this result has local offline changes that still need to sync to the server. */
436
437
  pendingSync: boolean;
437
438
  };
@@ -598,30 +599,31 @@ type DocumentStore<State extends ValidStoreState, TOfflineOperations extends Doc
598
599
  disableRefetchOnMount?: boolean; /** Returns `idle` instead of `loading` while the document has not been fetched. */
599
600
  returnIdleStatus?: boolean;
600
601
  /**
601
- * Forces a high-priority fetch on mount and keeps the hook in `loading`
602
- * until the document finishes loading.
602
+ * Unconditionally schedules a high-priority fetch on mount and reports
603
+ * `loading` until that refresh succeeds or fails, even when cached data
604
+ * exists. Use sparingly because each mount can cause an extra request.
603
605
  */
604
- ensureIsLoaded?: boolean; /** Returns `refetching` instead of keeping `loaded` status during refetches. */
606
+ requireFreshData?: boolean; /** Returns `refetching` instead of keeping `loaded` status during refetches. */
605
607
  returnRefetchingStatus?: boolean;
606
608
  }) => TSDFUseDocumentReturn<Selected>; /** React hook that tracks whether a nested list item is still loading. */
607
609
  useListItemIsLoading: (args: {
608
610
  /** Unique identifier of the item within the document. */itemId: string; /** Extracts the item from the document data. */
609
611
  selector: (data: State | null) => unknown; /** Called if the item is still missing and no refetch is in progress. */
610
- loadItemFallback?: () => void; /** Forces a high-priority fetch and keeps the hook loading until data is loaded. */
611
- ensureIsLoaded?: boolean;
612
+ loadItemFallback?: () => void; /** Requires a mount refresh before reporting ready. May cause an extra request. */
613
+ requireFreshData?: boolean;
612
614
  }) => boolean; /** React hook that tracks whether a nested list item has been deleted. */
613
615
  useListItemIsDeleted: (args: {
614
616
  /** Unique identifier of the item within the document. */itemId: string; /** Extracts the item from the document data. */
615
617
  selector: (data: State | null) => unknown; /** Called once when deletion is detected. */
616
- onDelete?: () => void; /** Forces a high-priority fetch and keeps the hook loading until data is loaded. */
617
- ensureIsLoaded?: boolean;
618
+ onDelete?: () => void; /** Requires a mount refresh before reporting ready. May cause an extra request. */
619
+ requireFreshData?: boolean;
618
620
  }) => boolean; /** React hook for selecting one nested list item plus loading/deleted flags. */
619
621
  useListItem: <Selected>(args: {
620
622
  /** Unique identifier of the item within the document. */itemId: string; /** Extracts and maps the item from the document data. */
621
623
  selector: (data: State | null) => Selected; /** Called if the item is still missing and no refetch is in progress. */
622
624
  loadItemFallback?: () => void; /** Called once when deletion is detected. */
623
- onDelete?: () => void; /** Forces a high-priority fetch and keeps the hook loading until data is loaded. */
624
- ensureIsLoaded?: boolean;
625
+ onDelete?: () => void; /** Requires a mount refresh before reporting ready. May cause an extra request. */
626
+ requireFreshData?: boolean;
625
627
  }) => {
626
628
  isLoading: boolean;
627
629
  isDeleted: boolean;
@@ -665,11 +667,12 @@ type UseMultipleItemsOptions<ItemState extends ValidStoreState, Selected> = {
665
667
  //#region src/listQueryStore/useItem.d.ts
666
668
  type UseItemOptions<ItemState extends ValidStoreState, Selected> = UseMultipleItemsOptions<ItemState, Selected> & {
667
669
  /**
668
- * Forces a high-priority fetch on mount and keeps the hook in `loading`
669
- * until the current payload finishes loading. Cannot be combined with
670
- * `debouncePayload`.
670
+ * Unconditionally schedules a high-priority fetch on mount and reports
671
+ * `loading` until that refresh succeeds or fails, even when cached data
672
+ * exists. Use sparingly because each mount can cause an extra request.
673
+ * Cannot be combined with `debouncePayload`.
671
674
  */
672
- ensureIsLoaded?: boolean;
675
+ requireFreshData?: boolean;
673
676
  /**
674
677
  * Partial-resource fields to request for this item.
675
678
  *
@@ -714,11 +717,12 @@ type UseMultipleListQueriesOptions<ItemState extends ValidStoreState, ItemPayloa
714
717
  //#region src/listQueryStore/useListQuery.d.ts
715
718
  type UseListQueryOptions<ItemState extends ValidStoreState, ItemPayload extends ValidPayload, SelectedItem> = UseMultipleListQueriesOptions<ItemState, ItemPayload, SelectedItem> & {
716
719
  /**
717
- * Forces a high-priority fetch on mount and keeps the hook in `loading`
718
- * until the current payload finishes loading. Cannot be combined with
719
- * `debouncePayload`.
720
+ * Unconditionally schedules a high-priority fetch on mount and reports
721
+ * `loading` until that refresh succeeds or fails, even when cached data
722
+ * exists. Use sparingly because each mount can cause an extra request.
723
+ * Cannot be combined with `debouncePayload`.
720
724
  */
721
- ensureIsLoaded?: boolean;
725
+ requireFreshData?: boolean;
722
726
  /**
723
727
  * Partial-resource fields to request for each item in this query.
724
728
  *