tsdf 17.0.3 → 17.0.4

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-URS9eulL.js → asyncStorageAdapter-BuGjbXYA.js} +25 -165
  4. package/dist/{asyncStorageAdapter-DgsuE-T8.d.ts → asyncStorageAdapter-CMohMeKm.d.ts} +1 -1
  5. package/dist/{asyncStorageAdapters-Bxrrj_Mt.js → asyncStorageAdapters-ClUvxNQA.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-BameJ4st.js → indexedDbPersistentStorage-BSlgLveB.js} +1 -11
  9. package/dist/main.d.ts +30 -34
  10. package/dist/main.js +257 -856
  11. package/dist/opfs-storage.d.ts +1 -1
  12. package/dist/opfs-storage.js +1 -1
  13. package/dist/{opfsPersistentStorage-BngS1m0X.d.ts → opfsPersistentStorage-Ci0JcCo5.d.ts} +1 -1
  14. package/dist/{opfsPersistentStorage-JsSCNBTr.js → opfsPersistentStorage-D_k77Srq.js} +1 -1
  15. package/dist/src/async-storage.d.ts +1 -0
  16. package/dist/src/cacheLimits/lruCacheRuntime.d.ts +9 -0
  17. package/dist/src/cacheLimits/scheduleIdleThrottled.d.ts +1 -0
  18. package/dist/src/cacheLimits/useRegisterActiveKeys.d.ts +1 -0
  19. package/dist/src/collectionStore/collectionCacheLimits.d.ts +1 -0
  20. package/dist/src/collectionStore/collectionStore.d.ts +385 -0
  21. package/dist/src/collectionStore/executeBatchFetch.d.ts +6 -0
  22. package/dist/src/collectionStore/useItem.d.ts +15 -0
  23. package/dist/src/collectionStore/useMultipleItems.d.ts +35 -0
  24. package/dist/src/debug.d.ts +30 -0
  25. package/dist/src/documentStore.d.ts +290 -0
  26. package/dist/src/hooks/useListItem.d.ts +22 -0
  27. package/dist/src/hooks/useListItemIsDeleted.d.ts +13 -0
  28. package/dist/src/hooks/useListItemIsLoading.d.ts +16 -0
  29. package/dist/src/indexed-db-storage.d.ts +1 -0
  30. package/dist/src/internal/offlineTestInstrumentation.d.ts +12 -0
  31. package/dist/src/internal/testTimelineTypes.d.ts +1 -0
  32. package/dist/src/invalidationUtils.d.ts +8 -0
  33. package/dist/src/isOffScreenContext.d.ts +16 -0
  34. package/dist/src/listQueryStore/createFetchApi.d.ts +1 -0
  35. package/dist/src/listQueryStore/createMutationApi.d.ts +1 -0
  36. package/dist/src/listQueryStore/executeItemBatchFetch.d.ts +20 -0
  37. package/dist/src/listQueryStore/executeQueryFetch.d.ts +7 -0
  38. package/dist/src/listQueryStore/itemFieldUtils.d.ts +77 -0
  39. package/dist/src/listQueryStore/listQueryCacheLimits.d.ts +1 -0
  40. package/dist/src/listQueryStore/listQueryStore.d.ts +538 -0
  41. package/dist/src/listQueryStore/types.d.ts +347 -0
  42. package/dist/src/listQueryStore/useFindItem.d.ts +7 -0
  43. package/dist/src/listQueryStore/useItem.d.ts +29 -0
  44. package/dist/src/listQueryStore/useListQuery.d.ts +29 -0
  45. package/dist/src/listQueryStore/useMultipleItems.d.ts +44 -0
  46. package/dist/src/listQueryStore/useMultipleListQueries.d.ts +46 -0
  47. package/dist/src/listQueryStore/usePendingOfflineItems.d.ts +19 -0
  48. package/dist/src/main.d.ts +23 -0
  49. package/dist/src/opfs-storage.d.ts +1 -0
  50. package/dist/src/persistentStorage/asyncStorageAdapter.d.ts +95 -0
  51. package/dist/src/persistentStorage/asyncStorageAdapters.d.ts +2 -0
  52. package/dist/src/persistentStorage/asyncStorageShared.d.ts +23 -0
  53. package/dist/src/persistentStorage/collectionStorePersistence.d.ts +26 -0
  54. package/dist/src/persistentStorage/compactListQueryLocalStorageEntry.d.ts +11 -0
  55. package/dist/src/persistentStorage/compactLocalStorageEntry.d.ts +8 -0
  56. package/dist/src/persistentStorage/documentEntryKey.d.ts +1 -0
  57. package/dist/src/persistentStorage/documentStorePersistence.d.ts +17 -0
  58. package/dist/src/persistentStorage/indexedDbAsyncStorageAdapter.d.ts +165 -0
  59. package/dist/src/persistentStorage/indexedDbPersistentStorage.d.ts +6 -0
  60. package/dist/src/persistentStorage/listQueryStorePersistence.d.ts +37 -0
  61. package/dist/src/persistentStorage/localStorageMetadata.d.ts +126 -0
  62. package/dist/src/persistentStorage/navigatorLocks.d.ts +3 -0
  63. package/dist/src/persistentStorage/offline/entityMetadata.d.ts +12 -0
  64. package/dist/src/persistentStorage/offline/fetchRuntime.d.ts +35 -0
  65. package/dist/src/persistentStorage/offline/mutationRuntime.d.ts +31 -0
  66. package/dist/src/persistentStorage/offline/offlineResolution.typeGuards.d.ts +1 -0
  67. package/dist/src/persistentStorage/offline/overlayStoreLifecycle.d.ts +13 -0
  68. package/dist/src/persistentStorage/offline/sessionCoordinator.d.ts +94 -0
  69. package/dist/src/persistentStorage/offline/sessionProtectionRegistry.d.ts +11 -0
  70. package/dist/src/persistentStorage/offline/storeController.d.ts +86 -0
  71. package/dist/src/persistentStorage/offline/types.d.ts +1255 -0
  72. package/dist/src/persistentStorage/offlineUploadRegistry.d.ts +11 -0
  73. package/dist/src/persistentStorage/offlineUploadTypes.d.ts +97 -0
  74. package/dist/src/persistentStorage/offlineUploadsShared.d.ts +4 -0
  75. package/dist/src/persistentStorage/opfsAsyncStorageAdapter.d.ts +24 -0
  76. package/dist/src/persistentStorage/opfsFileNaming.d.ts +23 -0
  77. package/dist/src/persistentStorage/opfsHelpers.d.ts +3 -0
  78. package/dist/src/persistentStorage/opfsOfflineUploadAdapter.d.ts +2 -0
  79. package/dist/src/persistentStorage/opfsPersistentStorage.d.ts +2 -0
  80. package/dist/src/persistentStorage/parsePersistedData.d.ts +45 -0
  81. package/dist/src/persistentStorage/persistenceUtils.d.ts +52 -0
  82. package/dist/src/persistentStorage/persistentStorageDefaults.d.ts +4 -0
  83. package/dist/src/persistentStorage/persistentStorageManager.d.ts +197 -0
  84. package/dist/src/persistentStorage/quotaDebug.d.ts +16 -0
  85. package/dist/src/persistentStorage/scheduleIdleCleanup.d.ts +28 -0
  86. package/dist/src/persistentStorage/storageAdapter.d.ts +41 -0
  87. package/dist/src/persistentStorage/storageEntryPrefixes.d.ts +16 -0
  88. package/dist/src/persistentStorage/types.d.ts +412 -0
  89. package/dist/src/persistentStorage/validateWithSchema.d.ts +12 -0
  90. package/dist/src/requestScheduler.d.ts +81 -0
  91. package/dist/src/storeManager.d.ts +160 -0
  92. package/dist/src/utils/automaticFetchPolicy.d.ts +29 -0
  93. package/dist/src/utils/browserTabsPriority.d.ts +43 -0
  94. package/dist/src/utils/browserTabsSync.d.ts +33 -0
  95. package/dist/src/utils/optimisticMutationTracker.d.ts +20 -0
  96. package/dist/src/utils/optimisticRollback.d.ts +11 -0
  97. package/dist/src/utils/payloadDebounce.d.ts +5 -0
  98. package/dist/src/utils/performMutation.d.ts +19 -0
  99. package/dist/src/utils/reusePrevIfEqual.d.ts +1 -0
  100. package/dist/src/utils/storeFocusLifecycle.d.ts +1 -0
  101. package/dist/src/utils/storeShared.d.ts +126 -0
  102. package/dist/src/utils/useEnsureIsLoaded.d.ts +6 -0
  103. package/dist/src/utils/useRequireFreshData.d.ts +6 -0
  104. package/dist/tests/basic-functionality/collection-store.test.d.ts +1 -0
  105. package/dist/tests/basic-functionality/document-store.test.d.ts +1 -0
  106. package/dist/tests/basic-functionality/list-query-state-manipulation.test.d.ts +1 -0
  107. package/dist/tests/basic-functionality/list-query-store.test.d.ts +1 -0
  108. package/dist/tests/browser-tabs/browser-tabs-background-rtu-batch.test.d.ts +1 -0
  109. package/dist/tests/browser-tabs/browser-tabs-background-rtu.test.d.ts +1 -0
  110. package/dist/tests/browser-tabs/browser-tabs-background-scheduling.test.d.ts +1 -0
  111. package/dist/tests/browser-tabs/browser-tabs-list-query-pagination.test.d.ts +1 -0
  112. package/dist/tests/browser-tabs/browser-tabs-non-cancelable-fetches.test.d.ts +1 -0
  113. package/dist/tests/browser-tabs/browser-tabs-optimistic-sync.test.d.ts +1 -0
  114. package/dist/tests/browser-tabs/browser-tabs-partial-resources.test.d.ts +1 -0
  115. package/dist/tests/browser-tabs/browser-tabs-priority.test.d.ts +1 -0
  116. package/dist/tests/browser-tabs/browser-tabs-snapshot-consistency.test.d.ts +1 -0
  117. package/dist/tests/browser-tabs/browser-tabs-state-methods.test.d.ts +1 -0
  118. package/dist/tests/browser-tabs/browser-tabs-sync-coordinator.test.d.ts +1 -0
  119. package/dist/tests/browser-tabs/browser-tabs-test-helpers.d.ts +69 -0
  120. package/dist/tests/browser-tabs/focus-coordinator.test.d.ts +1 -0
  121. package/dist/tests/hooks/collection-hooks-2.test.d.ts +1 -0
  122. package/dist/tests/hooks/collection-hooks.test.d.ts +1 -0
  123. package/dist/tests/hooks/collection-useListItem.test.d.ts +1 -0
  124. package/dist/tests/hooks/debounce-payload-hooks.test.d.ts +1 -0
  125. package/dist/tests/hooks/disable-refetches.test.d.ts +1 -0
  126. package/dist/tests/hooks/document-hooks-2.test.d.ts +1 -0
  127. package/dist/tests/hooks/document-hooks.test.d.ts +1 -0
  128. package/dist/tests/hooks/document-useListItem.test.d.ts +1 -0
  129. package/dist/tests/hooks/fetch-error-recovery.test.d.ts +1 -0
  130. package/dist/tests/hooks/hook-memoization.test.d.ts +1 -0
  131. package/dist/tests/hooks/list-query-hooks-2.test.d.ts +1 -0
  132. package/dist/tests/hooks/list-query-hooks-3.test.d.ts +1 -0
  133. package/dist/tests/hooks/list-query-hooks-mutations.test.d.ts +1 -0
  134. package/dist/tests/hooks/list-query-hooks.test.d.ts +1 -0
  135. package/dist/tests/hooks/list-query-pending-offline-items.test.d.ts +1 -0
  136. package/dist/tests/hooks/off-screen-context.test.d.ts +1 -0
  137. package/dist/tests/list-query-features/list-query-derived-queries.test.d.ts +1 -0
  138. package/dist/tests/list-query-features/list-query-offset-pagination.test.d.ts +1 -0
  139. package/dist/tests/list-query-features/list-query-optimistic-filters.test.d.ts +1 -0
  140. package/dist/tests/list-query-features/list-query-partial-resources-2.test.d.ts +1 -0
  141. package/dist/tests/list-query-features/list-query-partial-resources-3.test.d.ts +1 -0
  142. package/dist/tests/list-query-features/list-query-partial-resources-regressions.test.d.ts +1 -0
  143. package/dist/tests/list-query-features/list-query-partial-resources-show-partial-status.test.d.ts +1 -0
  144. package/dist/tests/list-query-features/list-query-partial-resources.test.d.ts +1 -0
  145. package/dist/tests/list-query-features/list-query-size-coalescing-partial-resources.test.d.ts +1 -0
  146. package/dist/tests/mocks/browserTabsTestUtils.d.ts +17 -0
  147. package/dist/tests/mocks/collectionStoreTestEnv.d.ts +265 -0
  148. package/dist/tests/mocks/documentStoreTestEnv.d.ts +140 -0
  149. package/dist/tests/mocks/duplicateStoreGuard.test.d.ts +1 -0
  150. package/dist/tests/mocks/listQueryStoreTestEnv.d.ts +295 -0
  151. package/dist/tests/mocks/mockBrowserOpfs.d.ts +70 -0
  152. package/dist/tests/mocks/mockBrowserOpfs.test.d.ts +1 -0
  153. package/dist/tests/mocks/mockLocalStorageStore.d.ts +61 -0
  154. package/dist/tests/mocks/seedScenarioPersistentStorage.d.ts +51 -0
  155. package/dist/tests/mocks/serverMock.d.ts +56 -0
  156. package/dist/tests/mocks/serverTableMock.d.ts +174 -0
  157. package/dist/tests/mocks/testEnvUtils.d.ts +120 -0
  158. package/dist/tests/mocks/testScenarioPersistentStorage.test.d.ts +1 -0
  159. package/dist/tests/offline/offline-fetching-scenarios.test.d.ts +1 -0
  160. package/dist/tests/offline/offline-mixed-adapter-storage.test.d.ts +1 -0
  161. package/dist/tests/offline/offline-mutation-fallback.test.d.ts +1 -0
  162. package/dist/tests/offline/offline-network-recovery.test.d.ts +1 -0
  163. package/dist/tests/offline/offline-outage.test.d.ts +1 -0
  164. package/dist/tests/offline/offline-overlays.test.d.ts +1 -0
  165. package/dist/tests/offline/offline-query-replay.test.d.ts +1 -0
  166. package/dist/tests/offline/offline-reads.test.d.ts +1 -0
  167. package/dist/tests/offline/offline-replay-conflicts.test.d.ts +1 -0
  168. package/dist/tests/offline/offline-replay-queueing.test.d.ts +1 -0
  169. package/dist/tests/offline/offline-resolution-dependencies.test.d.ts +1 -0
  170. package/dist/tests/offline/offline-runtime-controls.test.d.ts +1 -0
  171. package/dist/tests/offline/offline-session-and-global-state.test.d.ts +1 -0
  172. package/dist/tests/offline/offline-storage.test.d.ts +1 -0
  173. package/dist/tests/offline/offline-uploads.test.d.ts +1 -0
  174. package/dist/tests/offline/offlineReplayTestShared.d.ts +292 -0
  175. package/dist/tests/offline/offlineTestShared.d.ts +156 -0
  176. package/dist/tests/perform-mutation/mutation-error-rollback.test.d.ts +1 -0
  177. package/dist/tests/perform-mutation/perform-mutation-block-window-close.test.d.ts +1 -0
  178. package/dist/tests/perform-mutation/perform-mutation-debounce.test.d.ts +1 -0
  179. package/dist/tests/perform-mutation/store-events.test.d.ts +1 -0
  180. package/dist/tests/persistent-storage/async-storage-efficiency/collection.test.d.ts +1 -0
  181. package/dist/tests/persistent-storage/async-storage-efficiency/document.test.d.ts +1 -0
  182. package/dist/tests/persistent-storage/async-storage-efficiency/list-query.test.d.ts +1 -0
  183. package/dist/tests/persistent-storage/async-storage-efficiency/maintenance.test.d.ts +1 -0
  184. package/dist/tests/persistent-storage/async-storage-efficiency/shared.d.ts +804 -0
  185. package/dist/tests/persistent-storage/async-storage-shared.test.d.ts +1 -0
  186. package/dist/tests/persistent-storage/collection-store-persistence.converted.opfs.test.d.ts +1 -0
  187. package/dist/tests/persistent-storage/collection-store-persistence.converted.test.d.ts +1 -0
  188. package/dist/tests/persistent-storage/collection-store-persistence.opfs.test.d.ts +1 -0
  189. package/dist/tests/persistent-storage/collection-store-persistence.test.d.ts +1 -0
  190. package/dist/tests/persistent-storage/document-store-persistence.converted.opfs.test.d.ts +1 -0
  191. package/dist/tests/persistent-storage/document-store-persistence.converted.test.d.ts +1 -0
  192. package/dist/tests/persistent-storage/document-store-persistence.opfs.test.d.ts +1 -0
  193. package/dist/tests/persistent-storage/document-store-persistence.test.d.ts +1 -0
  194. package/dist/tests/persistent-storage/expiration-scan.test.d.ts +1 -0
  195. package/dist/tests/persistent-storage/indexeddb-async-storage-efficiency/collection.test.d.ts +1 -0
  196. package/dist/tests/persistent-storage/indexeddb-async-storage-efficiency/document.test.d.ts +1 -0
  197. package/dist/tests/persistent-storage/indexeddb-async-storage-efficiency/list-query.test.d.ts +1 -0
  198. package/dist/tests/persistent-storage/indexeddb-async-storage-efficiency/maintenance.test.d.ts +1 -0
  199. package/dist/tests/persistent-storage/indexeddb-async-storage-efficiency/shared.d.ts +780 -0
  200. package/dist/tests/persistent-storage/indexeddb-storage-adapter.test.d.ts +1 -0
  201. package/dist/tests/persistent-storage/list-query-store-persistence.converted.opfs.test.d.ts +1 -0
  202. package/dist/tests/persistent-storage/list-query-store-persistence.converted.test.d.ts +1 -0
  203. package/dist/tests/persistent-storage/list-query-store-persistence.opfs.test.d.ts +1 -0
  204. package/dist/tests/persistent-storage/list-query-store-persistence.test.d.ts +1 -0
  205. package/dist/tests/persistent-storage/persistence-with-tabs-sync.test.d.ts +1 -0
  206. package/dist/tests/persistent-storage/persistentStorageByteBudgetTestUtils.d.ts +18 -0
  207. package/dist/tests/persistent-storage/quota-exceeded-recovery-no-locks.test.d.ts +1 -0
  208. package/dist/tests/persistent-storage/quota-exceeded-recovery.test.d.ts +1 -0
  209. package/dist/tests/persistent-storage/quotaRecoveryTestUtils.d.ts +228 -0
  210. package/dist/tests/persistent-storage/storage-adapter.test.d.ts +1 -0
  211. package/dist/tests/persistent-storage/sync-storage-efficiency/collection.test.d.ts +1 -0
  212. package/dist/tests/persistent-storage/sync-storage-efficiency/document.test.d.ts +1 -0
  213. package/dist/tests/persistent-storage/sync-storage-efficiency/list-query.test.d.ts +1 -0
  214. package/dist/tests/persistent-storage/sync-storage-efficiency/maintenance.test.d.ts +1 -0
  215. package/dist/tests/persistent-storage/sync-storage-efficiency/shared.d.ts +784 -0
  216. package/dist/tests/playwright/browser-tabs.spec.d.ts +1 -0
  217. package/dist/tests/playwright/persistent-storage.spec.d.ts +1 -0
  218. package/dist/tests/request-schedulling/batch-medium-priority.test.d.ts +1 -0
  219. package/dist/tests/request-schedulling/batch-realtime-updates.test.d.ts +1 -0
  220. package/dist/tests/request-schedulling/collection-batch-coalescing.test.d.ts +1 -0
  221. package/dist/tests/request-schedulling/collection-batch-key-grouping.test.d.ts +1 -0
  222. package/dist/tests/request-schedulling/collection-fetch-orchestration.test.d.ts +1 -0
  223. package/dist/tests/request-schedulling/document-await-fetch.test.d.ts +1 -0
  224. package/dist/tests/request-schedulling/document-base-coalescing.test.d.ts +1 -0
  225. package/dist/tests/request-schedulling/document-fetch-orchestration.test.d.ts +1 -0
  226. package/dist/tests/request-schedulling/document-medium-priority-fetch.test.d.ts +1 -0
  227. package/dist/tests/request-schedulling/document-realtime-updates.test.d.ts +1 -0
  228. package/dist/tests/request-schedulling/list-query-item-batch-coalescing.test.d.ts +1 -0
  229. package/dist/tests/request-schedulling/list-query-item-batch-key-grouping.test.d.ts +1 -0
  230. package/dist/tests/request-schedulling/list-query-size-coalescing.test.d.ts +1 -0
  231. package/dist/tests/request-schedulling/medium-vs-realtime.test.d.ts +1 -0
  232. package/dist/tests/request-schedulling/request-scheduler-cross-tab-sync.test.d.ts +1 -0
  233. package/dist/tests/request-schedulling/window-focus.test.d.ts +1 -0
  234. package/dist/tests/store-manager.test.d.ts +1 -0
  235. package/dist/tests/user-facing-api/collection-offline-usage.test.d.ts +1 -0
  236. package/dist/tests/user-facing-api/document-offline-usage.test.d.ts +1 -0
  237. package/dist/tests/user-facing-api/list-query-offline-usage.test.d.ts +1 -0
  238. package/dist/tests/user-facing-api/result-returning-callbacks.test.d.ts +1 -0
  239. package/dist/tests/utils/genericTestUtils.d.ts +6 -0
  240. package/dist/tests/utils/indexedDbPersistentStorageOptimizationTestUtils.d.ts +79 -0
  241. package/dist/tests/utils/indexedDbPersistentStorageTestStore.d.ts +181 -0
  242. package/dist/tests/utils/listQueryHooksTestUtils.d.ts +8 -0
  243. package/dist/tests/utils/networkMock.d.ts +11 -0
  244. package/dist/tests/utils/opfsPersistentStorageTestStore.d.ts +220 -0
  245. package/dist/tests/utils/persistentStorageOptimizationTestUtils.d.ts +54 -0
  246. package/dist/tests/utils/persistentStorageOptimizationTestUtils.test.d.ts +1 -0
  247. package/dist/tests/utils/persistentStorageTestStore.d.ts +66 -0
  248. package/dist/tests/utils/resetSessionForTests.d.ts +3 -0
  249. package/dist/tests/utils/withSuppressedActError.d.ts +4 -0
  250. package/dist/{types-BlyGC_PO.d.ts → types-D0ttVGmj.d.ts} +3 -3
  251. package/package.json +2 -2
@@ -0,0 +1,804 @@
1
+ import type { TSDFDebugLogEntry } from '../../../src/debug';
2
+ import type { OffsetPaginationConfig } from '../../../src/listQueryStore/types';
3
+ import { type DocumentStoreTestScenario } from '../../mocks/documentStoreTestEnv';
4
+ import { type Row, type Tables } from '../../mocks/listQueryStoreTestEnv';
5
+ import { createOpfsPersistentStorageTestStore } from '../../utils/opfsPersistentStorageTestStore';
6
+ export declare function sumPersistedEntryBytes(...sizes: number[]): number;
7
+ export declare function getAsyncCollectionEntrySizeBytes<T>(payload: string, data: T): number;
8
+ export declare function getAsyncListItemEntrySizeBytes<T>(payload: string, data: T, options?: {
9
+ loadedFields?: string[];
10
+ }): number;
11
+ export declare function getAsyncListQueryEntrySizeBytes(payload: unknown, items: string[], options?: {
12
+ hasMore?: boolean;
13
+ }): number;
14
+ export declare const wrappedDocumentSchema: {
15
+ __rc_type: (t: {
16
+ value: {
17
+ name: string;
18
+ value: number;
19
+ };
20
+ }) => {
21
+ value: {
22
+ name: string;
23
+ value: number;
24
+ };
25
+ };
26
+ readonly withFallback: (fallback: {
27
+ value: {
28
+ name: string;
29
+ value: number;
30
+ };
31
+ } | ((invalidInput: unknown) => {
32
+ value: {
33
+ name: string;
34
+ value: number;
35
+ };
36
+ })) => import("runcheck").RcType<{
37
+ value: {
38
+ name: string;
39
+ value: number;
40
+ };
41
+ }>;
42
+ readonly where: (predicate: (input: {
43
+ value: {
44
+ name: string;
45
+ value: number;
46
+ };
47
+ }) => boolean | {
48
+ error: string;
49
+ }) => import("runcheck").RcType<{
50
+ value: {
51
+ name: string;
52
+ value: number;
53
+ };
54
+ }>;
55
+ readonly optional: () => import("runcheck").RcType<{
56
+ value: {
57
+ name: string;
58
+ value: number;
59
+ };
60
+ } | undefined>;
61
+ readonly optionalKey: () => import("runcheck").RcOptionalKeyType<{
62
+ value: {
63
+ name: string;
64
+ value: number;
65
+ };
66
+ } | undefined>;
67
+ readonly orNull: () => import("runcheck").RcType<{
68
+ value: {
69
+ name: string;
70
+ value: number;
71
+ };
72
+ } | null>;
73
+ readonly orNullish: () => import("runcheck").RcType<{
74
+ value: {
75
+ name: string;
76
+ value: number;
77
+ };
78
+ } | null | undefined>;
79
+ readonly withAutofix: (customAutofix: (input: unknown) => import("runcheck").AutoFixResult<{
80
+ value: {
81
+ name: string;
82
+ value: number;
83
+ };
84
+ }>) => import("runcheck").RcType<{
85
+ value: {
86
+ name: string;
87
+ value: number;
88
+ };
89
+ }>;
90
+ readonly default: <D extends {
91
+ value: {
92
+ name: string;
93
+ value: number;
94
+ };
95
+ }>(defaultValue: D | (() => D)) => import("runcheck").RcType<{
96
+ value: {
97
+ name: string;
98
+ value: number;
99
+ };
100
+ } | (D extends never[] ? never : D)>;
101
+ readonly nullishDefault: <D extends {
102
+ value: {
103
+ name: string;
104
+ value: number;
105
+ };
106
+ }>(defaultValue: D | (() => D)) => import("runcheck").RcType<{
107
+ value: {
108
+ name: string;
109
+ value: number;
110
+ };
111
+ } | (D extends never[] ? never : D)>;
112
+ readonly or: <O>(schema: import("runcheck").RcType<O>) => import("runcheck").RcType<O | {
113
+ value: {
114
+ name: string;
115
+ value: number;
116
+ };
117
+ }>;
118
+ readonly parse: (input: unknown, options?: {
119
+ noWarnings?: boolean | undefined;
120
+ } | undefined) => import("runcheck").RcParseResult<{
121
+ value: {
122
+ name: string;
123
+ value: number;
124
+ };
125
+ }>;
126
+ readonly parseJson: (jsonString: string, options?: {
127
+ noWarnings?: boolean | undefined;
128
+ } | undefined) => import("runcheck").RcParseResult<{
129
+ value: {
130
+ name: string;
131
+ value: number;
132
+ };
133
+ }>;
134
+ readonly _optional_key_?: false | undefined;
135
+ };
136
+ export declare function setupAsyncStorageEfficiencyTestSuite(): void;
137
+ export declare function waitForScheduledCleanup(delayMs?: number): Promise<void>;
138
+ type MockOpfsAdapter = ReturnType<typeof createOpfsPersistentStorageTestStore>;
139
+ export declare function settleStartupBackgroundScan(mockAdapter: MockOpfsAdapter): Promise<void>;
140
+ export declare function flushInvalidationPersistence(delayMs?: number): Promise<void>;
141
+ export declare function captureHookRemount<Result>(args: {
142
+ mockAdapter: MockOpfsAdapter;
143
+ render: () => Result;
144
+ settleTimeMs?: number;
145
+ }): Promise<{
146
+ secondHook: import("@testing-library/react").RenderHookResult<Result, unknown>;
147
+ firstMountOperations: string;
148
+ remountOperations: string;
149
+ }>;
150
+ type DocumentState = {
151
+ name: string;
152
+ value: number;
153
+ };
154
+ export declare function createDocumentEnv(options: {
155
+ serverData?: DocumentState;
156
+ sessionKey?: string;
157
+ storeName: string;
158
+ testScenario?: DocumentStoreTestScenario<DocumentState>;
159
+ }): {
160
+ apiStore: import("../../../src/documentStore").DocumentStore<{
161
+ value: {
162
+ name: string;
163
+ value: number;
164
+ };
165
+ }, null>;
166
+ store: import("t-state").Store<import("../../../src/documentStore").DocumentStoreState<{
167
+ value: {
168
+ name: string;
169
+ value: number;
170
+ };
171
+ }>>;
172
+ readonly uiChanges: (string | number | undefined)[];
173
+ readonly actions: {
174
+ action: string;
175
+ time: number;
176
+ uiValue: unknown;
177
+ actionValue?: unknown;
178
+ id?: string | number | undefined;
179
+ itemId?: string | undefined;
180
+ itemUiValues?: Record<string, unknown> | undefined;
181
+ }[];
182
+ trackUIChanges: (value: string | number | undefined, itemId?: string | undefined) => void;
183
+ addTimelineComments: (reference: "afterLastAction" | "beforeNextAction" | {
184
+ action: string;
185
+ id?: string | number | undefined;
186
+ }, comments: (string | {
187
+ comment: string;
188
+ deltaMs?: number | undefined;
189
+ })[]) => void;
190
+ scheduleFetch: (fetchType: import("../../../src/requestScheduler").FetchType, options?: {
191
+ mediumPriorityDelayMs?: number | undefined;
192
+ } | undefined) => import("../../../src/requestScheduler").ScheduleFetchResults;
193
+ performClientUpdateAction: (newValue: {
194
+ name: string;
195
+ value: number;
196
+ }, { withRevalidation, withOptimisticUpdate, duration, triggerRTU, addServerDataChangeAction, error, updateStateWithMutationResult, }?: {
197
+ withRevalidation?: boolean | undefined;
198
+ withOptimisticUpdate?: boolean | undefined;
199
+ duration?: number | undefined;
200
+ triggerRTU?: boolean | undefined;
201
+ addServerDataChangeAction?: boolean | undefined;
202
+ error?: string | undefined;
203
+ updateStateWithMutationResult?: boolean | undefined;
204
+ }) => Promise<import("t-result").Result<unknown, import("../../../src/main").MutationSkipped | import("../../../src/main").StoreMutationError>>;
205
+ readonly timelineString: string;
206
+ clearTimeline(): void;
207
+ serverMock: {
208
+ mutateData: (newData: {
209
+ name: string;
210
+ value: number;
211
+ }, { duration, setDataAt, triggerRTUEvent, addServerDataChangeAction, mutationId, addMutationResolvedAction, }?: {
212
+ duration?: number | undefined;
213
+ setDataAt?: number | undefined;
214
+ triggerRTUEvent?: boolean | undefined;
215
+ addServerDataChangeAction?: boolean | undefined;
216
+ addMutationResolvedAction?: boolean | undefined;
217
+ mutationId?: string | number | undefined;
218
+ }) => Promise<void>;
219
+ wsEvents: import("evtmitter").Emitter<{
220
+ data_changed: undefined;
221
+ }>;
222
+ delayedSetData(value: {
223
+ name: string;
224
+ value: number;
225
+ }, options?: {
226
+ durationMs?: number | undefined;
227
+ }): Promise<void>;
228
+ setData(value: {
229
+ name: string;
230
+ value: number;
231
+ }): void;
232
+ readonly current: {
233
+ name: string;
234
+ value: number;
235
+ };
236
+ history: {
237
+ name: string;
238
+ value: number;
239
+ }[];
240
+ fetch: (signal?: AbortSignal | undefined, duration?: number) => Promise<{
241
+ name: string;
242
+ value: number;
243
+ }>;
244
+ setFetchDurations(...durations: number[]): void;
245
+ setNextFetchError(error: string | import("../../mocks/serverMock").FetchErrorConfig): void;
246
+ readonly numOfStartedFetches: number;
247
+ readonly numOfFinishedFetches: number;
248
+ fetchHistory: {
249
+ id: string;
250
+ startTime: number;
251
+ endTime: number;
252
+ duration: number;
253
+ result: "aborted" | "error" | "success";
254
+ data?: {
255
+ name: string;
256
+ value: number;
257
+ } | undefined;
258
+ error?: Error | undefined;
259
+ }[];
260
+ clearFetchHistory(): void;
261
+ };
262
+ errorInNextFetch(error?: string | import("../../mocks/serverMock").FetchErrorConfig): void;
263
+ setNextFetchDurations(...durations: number[]): void;
264
+ emulateExternalRTU(value: {
265
+ name: string;
266
+ value: number;
267
+ }): void;
268
+ setServerData(value: {
269
+ name: string;
270
+ value: number;
271
+ }): void;
272
+ };
273
+ type CollectionItemState = {
274
+ id: string;
275
+ name: string;
276
+ };
277
+ export declare function createCollectionEnv(options: {
278
+ getSessionKey?: () => string | false;
279
+ ignoreItems?: string[] | ((payload: string) => boolean);
280
+ maxBytes?: number;
281
+ pinnedItems?: string[];
282
+ serverData?: Record<string, CollectionItemState>;
283
+ sessionKey?: string;
284
+ storeName: string;
285
+ }): {
286
+ apiStore: import("../../../src/main").CollectionStore<import("../../mocks/collectionStoreTestEnv").CollectionTestItem<{
287
+ id: string;
288
+ name: string;
289
+ }>, string, null>;
290
+ store: import("t-state").Store<import("../../../src/main").TSFDCollectionState<import("../../mocks/collectionStoreTestEnv").CollectionTestItem<{
291
+ id: string;
292
+ name: string;
293
+ }>, string>>;
294
+ serverTable: {
295
+ fetch: (itemId: string, signal?: AbortSignal | undefined, options?: {
296
+ fields?: string[] | undefined;
297
+ } | undefined) => Promise<{
298
+ id: string;
299
+ name: string;
300
+ }>;
301
+ list: (options?: {
302
+ offset?: number | undefined;
303
+ limit?: number | undefined;
304
+ itemIds?: string[] | undefined;
305
+ filters?: import("../../mocks/serverTableMock").FilterOperator[] | undefined;
306
+ tableId?: string | undefined;
307
+ fields?: string[] | undefined;
308
+ batchKey?: string | undefined;
309
+ } | undefined, signal?: AbortSignal | undefined) => Promise<{
310
+ items: {
311
+ itemId: string;
312
+ data: {
313
+ id: string;
314
+ name: string;
315
+ };
316
+ }[];
317
+ hasMore: boolean;
318
+ }>;
319
+ listSync: (options?: {
320
+ offset?: number | undefined;
321
+ limit?: number | undefined;
322
+ itemIds?: string[] | undefined;
323
+ filters?: import("../../mocks/serverTableMock").FilterOperator[] | undefined;
324
+ tableId?: string | undefined;
325
+ fields?: string[] | undefined;
326
+ batchKey?: string | undefined;
327
+ } | undefined) => {
328
+ items: {
329
+ itemId: string;
330
+ data: {
331
+ id: string;
332
+ name: string;
333
+ };
334
+ }[];
335
+ hasMore: boolean;
336
+ };
337
+ get: (itemId: string) => {
338
+ id: string;
339
+ name: string;
340
+ } | undefined;
341
+ getAll: () => Record<string, {
342
+ id: string;
343
+ name: string;
344
+ }>;
345
+ getByPrefix: (prefix: string) => {
346
+ itemId: string;
347
+ data: {
348
+ id: string;
349
+ name: string;
350
+ };
351
+ }[];
352
+ entries: () => [string, {
353
+ id: string;
354
+ name: string;
355
+ }][];
356
+ delayedSetItem(itemId: string, data: {
357
+ id: string;
358
+ name: string;
359
+ }, options?: {
360
+ durationMs?: number | undefined;
361
+ }): Promise<void>;
362
+ delayedUpdateItem(itemId: string, data: Partial<{
363
+ id: string;
364
+ name: string;
365
+ }>, options?: {
366
+ durationMs?: number | undefined;
367
+ }): Promise<void>;
368
+ delayedRemoveItem(itemId: string, options?: {
369
+ durationMs?: number | undefined;
370
+ }): Promise<void>;
371
+ setItem: (itemId: string, data: {
372
+ id: string;
373
+ name: string;
374
+ }, options?: {
375
+ triggerRTUEvent?: "for_all_items" | boolean | undefined;
376
+ prepend?: boolean | undefined;
377
+ } | undefined) => void;
378
+ removeItem: (itemId: string) => void;
379
+ updateItem: (itemId: string, data: Partial<{
380
+ id: string;
381
+ name: string;
382
+ }>) => void;
383
+ emulateClientMutation: (itemId: string, newData: {
384
+ id: string;
385
+ name: string;
386
+ }, options?: {
387
+ duration?: number | undefined;
388
+ setDataAt?: number | undefined;
389
+ triggerRTUEvent?: boolean | undefined;
390
+ addServerDataChangeAction?: boolean | undefined;
391
+ mutationId?: string | number | undefined;
392
+ }) => Promise<{
393
+ id: string;
394
+ name: string;
395
+ }>;
396
+ addItem: (itemId: string, data: {
397
+ id: string;
398
+ name: string;
399
+ }, options?: {
400
+ duration?: number | undefined;
401
+ setDataAt?: number | undefined;
402
+ triggerRTUEvent?: boolean | undefined;
403
+ addServerDataChangeAction?: boolean | undefined;
404
+ mutationId?: string | number | undefined;
405
+ }) => Promise<void>;
406
+ addItemWithAutoGeneratedKey: (tableId: string, createData: (id: number, itemId: string) => {
407
+ id: string;
408
+ name: string;
409
+ }, options?: {
410
+ duration?: number | undefined;
411
+ setDataAt?: number | undefined;
412
+ triggerRTUEvent?: boolean | undefined;
413
+ addServerDataChangeAction?: boolean | undefined;
414
+ mutationId?: string | number | undefined;
415
+ }) => Promise<{
416
+ id: number;
417
+ itemId: string;
418
+ data: {
419
+ id: string;
420
+ name: string;
421
+ };
422
+ }>;
423
+ deleteItem: (itemId: string, options?: {
424
+ duration?: number | undefined;
425
+ setDataAt?: number | undefined;
426
+ triggerRTUEvent?: boolean | undefined;
427
+ addServerDataChangeAction?: boolean | undefined;
428
+ mutationId?: string | number | undefined;
429
+ }) => Promise<void>;
430
+ wsEvents: import("evtmitter").Emitter<{
431
+ data_changed: {
432
+ itemId: string;
433
+ data: {
434
+ id: string;
435
+ name: string;
436
+ };
437
+ };
438
+ item_deleted: {
439
+ itemId: string;
440
+ };
441
+ item_added: {
442
+ itemId: string;
443
+ data: {
444
+ id: string;
445
+ name: string;
446
+ };
447
+ };
448
+ list_changed: undefined;
449
+ }>;
450
+ getItemHistory: (itemId: string) => {
451
+ id: string;
452
+ name: string;
453
+ }[];
454
+ setFetchDurations(itemId: string, ...durations: number[]): void;
455
+ setNextFetchError(itemId: string, error: string | {
456
+ message: string;
457
+ path?: string | undefined;
458
+ method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT" | undefined;
459
+ code?: number | undefined;
460
+ }): void;
461
+ addListFetchStartDelay(delayMs: number): void;
462
+ setNextListFetchError(error: string | {
463
+ message: string;
464
+ path?: string | undefined;
465
+ method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT" | undefined;
466
+ code?: number | undefined;
467
+ }): void;
468
+ getNextFetchError(itemId: string): {
469
+ message: string;
470
+ path?: string | undefined;
471
+ method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT" | undefined;
472
+ code?: number | undefined;
473
+ } | undefined;
474
+ readonly numOfStartedFetches: number;
475
+ readonly numOfFinishedFetches: number;
476
+ fetchHistory: ({
477
+ type: "fetch";
478
+ itemId: string;
479
+ fields: string[] | undefined;
480
+ result: "aborted" | "error" | {
481
+ id: string;
482
+ name: string;
483
+ };
484
+ startedAt: number;
485
+ duration: number;
486
+ } | {
487
+ type: "list";
488
+ itemIds: string[] | undefined;
489
+ offset: number;
490
+ limit: number | undefined;
491
+ fields: string[] | undefined;
492
+ filters: import("../../mocks/serverTableMock").FilterOperator[] | undefined;
493
+ batchKey: string | undefined;
494
+ startedAt: number;
495
+ duration: number;
496
+ results: "aborted" | {
497
+ itemId: string;
498
+ data: "error" | {
499
+ id: string;
500
+ name: string;
501
+ };
502
+ }[];
503
+ })[];
504
+ clearFetchHistory(): void;
505
+ getRequestHistory(fetchType?: "all" | "item" | "list", options?: {
506
+ includeTime?: boolean | undefined;
507
+ } | undefined): {
508
+ _type: "item" | "list" | undefined;
509
+ payload: unknown;
510
+ time?: string | undefined;
511
+ returned_items?: number | undefined;
512
+ }[];
513
+ };
514
+ readonly uiChanges: Record<string, unknown>[];
515
+ readonly actions: {
516
+ action: string;
517
+ time: number;
518
+ uiValue: unknown;
519
+ actionValue?: unknown;
520
+ id?: string | number | undefined;
521
+ itemId?: string | undefined;
522
+ itemUiValues?: Record<string, unknown> | undefined;
523
+ }[];
524
+ trackUIChanges: (value: Record<string, number | "error" | undefined>, itemId?: string | undefined) => void;
525
+ trackItemUI: (itemId: string, value: unknown) => unknown;
526
+ addTimelineComments: (reference: "afterLastAction" | "beforeNextAction" | {
527
+ action: string;
528
+ id?: string | number | undefined;
529
+ }, comments: (string | {
530
+ comment: string;
531
+ deltaMs?: number | undefined;
532
+ })[]) => void;
533
+ scheduleFetch: (fetchType: import("../../../src/requestScheduler").FetchType, itemId: string, options?: {
534
+ mediumPriorityDelayMs?: number | undefined;
535
+ } | undefined) => import("../../../src/requestScheduler").ScheduleFetchResults;
536
+ performClientUpdateAction: (itemId: string, newValue: {
537
+ id: string;
538
+ name: string;
539
+ }, { withRevalidation, withOptimisticUpdate, duration, triggerRTU, addServerDataChangeAction, error, }?: {
540
+ withRevalidation?: boolean | undefined;
541
+ withOptimisticUpdate?: boolean | undefined;
542
+ duration?: number | undefined;
543
+ triggerRTU?: boolean | undefined;
544
+ addServerDataChangeAction?: boolean | undefined;
545
+ error?: string | undefined;
546
+ }) => Promise<import("t-result").Result<unknown, import("../../../src/main").MutationSkipped | import("../../../src/main").StoreMutationError>>;
547
+ readonly timelineString: string;
548
+ clearTimeline(): void;
549
+ };
550
+ export declare function rawItemPayload(tableId: string, id: number): string;
551
+ export declare function storeItemKey(tableId: string, id: number): string;
552
+ export declare function createListQueryEnv(options: {
553
+ defaultQuerySize?: number;
554
+ debugEntries?: TSDFDebugLogEntry[];
555
+ ignoreItems?: string[] | ((payload: string) => boolean);
556
+ maxItemBytes?: number;
557
+ maxQueryBytes?: number;
558
+ maxQuerySize?: number;
559
+ offsetPagination?: OffsetPaginationConfig;
560
+ pinnedItems?: string[];
561
+ pinnedQueries?: Array<{
562
+ tableId: string;
563
+ }>;
564
+ serverData?: Tables<Row>;
565
+ sessionKey?: string;
566
+ storeName: string;
567
+ }): {
568
+ apiStore: import("../../../src/main").ListQueryStore<Row, import("../../mocks/listQueryStoreTestEnv").ListQueryParams, string, false, null>;
569
+ store: import("t-state").Store<import("../../../src/main").TSFDListQueryState<Row, import("../../mocks/listQueryStoreTestEnv").ListQueryParams, string>>;
570
+ serverTable: Omit<{
571
+ fetch: (itemId: string, signal?: AbortSignal | undefined, options?: {
572
+ fields?: string[] | undefined;
573
+ } | undefined) => Promise<Row>;
574
+ list: (options?: {
575
+ offset?: number | undefined;
576
+ limit?: number | undefined;
577
+ itemIds?: string[] | undefined;
578
+ filters?: import("../../mocks/serverTableMock").FilterOperator[] | undefined;
579
+ tableId?: string | undefined;
580
+ fields?: string[] | undefined;
581
+ batchKey?: string | undefined;
582
+ } | undefined, signal?: AbortSignal | undefined) => Promise<{
583
+ items: {
584
+ itemId: string;
585
+ data: Row;
586
+ }[];
587
+ hasMore: boolean;
588
+ }>;
589
+ listSync: (options?: {
590
+ offset?: number | undefined;
591
+ limit?: number | undefined;
592
+ itemIds?: string[] | undefined;
593
+ filters?: import("../../mocks/serverTableMock").FilterOperator[] | undefined;
594
+ tableId?: string | undefined;
595
+ fields?: string[] | undefined;
596
+ batchKey?: string | undefined;
597
+ } | undefined) => {
598
+ items: {
599
+ itemId: string;
600
+ data: Row;
601
+ }[];
602
+ hasMore: boolean;
603
+ };
604
+ get: (itemId: string) => Row | undefined;
605
+ getAll: () => Record<string, Row>;
606
+ getByPrefix: (prefix: string) => {
607
+ itemId: string;
608
+ data: Row;
609
+ }[];
610
+ entries: () => [string, Row][];
611
+ delayedSetItem(itemId: string, data: Row, options?: {
612
+ durationMs?: number | undefined;
613
+ }): Promise<void>;
614
+ delayedUpdateItem(itemId: string, data: Partial<Row>, options?: {
615
+ durationMs?: number | undefined;
616
+ }): Promise<void>;
617
+ delayedRemoveItem(itemId: string, options?: {
618
+ durationMs?: number | undefined;
619
+ }): Promise<void>;
620
+ setItem: (itemId: string, data: Row, options?: {
621
+ triggerRTUEvent?: "for_all_items" | boolean | undefined;
622
+ prepend?: boolean | undefined;
623
+ } | undefined) => void;
624
+ removeItem: (itemId: string) => void;
625
+ updateItem: (itemId: string, data: Partial<Row>) => void;
626
+ emulateClientMutation: (itemId: string, newData: Row, options?: {
627
+ duration?: number | undefined;
628
+ setDataAt?: number | undefined;
629
+ triggerRTUEvent?: boolean | undefined;
630
+ addServerDataChangeAction?: boolean | undefined;
631
+ mutationId?: string | number | undefined;
632
+ }) => Promise<Row>;
633
+ addItem: (itemId: string, data: Row, options?: {
634
+ duration?: number | undefined;
635
+ setDataAt?: number | undefined;
636
+ triggerRTUEvent?: boolean | undefined;
637
+ addServerDataChangeAction?: boolean | undefined;
638
+ mutationId?: string | number | undefined;
639
+ }) => Promise<void>;
640
+ addItemWithAutoGeneratedKey: (tableId: string, createData: (id: number, itemId: string) => Row, options?: {
641
+ duration?: number | undefined;
642
+ setDataAt?: number | undefined;
643
+ triggerRTUEvent?: boolean | undefined;
644
+ addServerDataChangeAction?: boolean | undefined;
645
+ mutationId?: string | number | undefined;
646
+ }) => Promise<{
647
+ id: number;
648
+ itemId: string;
649
+ data: Row;
650
+ }>;
651
+ deleteItem: (itemId: string, options?: {
652
+ duration?: number | undefined;
653
+ setDataAt?: number | undefined;
654
+ triggerRTUEvent?: boolean | undefined;
655
+ addServerDataChangeAction?: boolean | undefined;
656
+ mutationId?: string | number | undefined;
657
+ }) => Promise<void>;
658
+ wsEvents: import("evtmitter").Emitter<{
659
+ data_changed: {
660
+ itemId: string;
661
+ data: Row;
662
+ };
663
+ item_deleted: {
664
+ itemId: string;
665
+ };
666
+ item_added: {
667
+ itemId: string;
668
+ data: Row;
669
+ };
670
+ list_changed: undefined;
671
+ }>;
672
+ getItemHistory: (itemId: string) => Row[];
673
+ setFetchDurations(itemId: string, ...durations: number[]): void;
674
+ setNextFetchError(itemId: string, error: string | {
675
+ message: string;
676
+ path?: string | undefined;
677
+ method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT" | undefined;
678
+ code?: number | undefined;
679
+ }): void;
680
+ addListFetchStartDelay(delayMs: number): void;
681
+ setNextListFetchError(error: string | {
682
+ message: string;
683
+ path?: string | undefined;
684
+ method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT" | undefined;
685
+ code?: number | undefined;
686
+ }): void;
687
+ getNextFetchError(itemId: string): {
688
+ message: string;
689
+ path?: string | undefined;
690
+ method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT" | undefined;
691
+ code?: number | undefined;
692
+ } | undefined;
693
+ readonly numOfStartedFetches: number;
694
+ readonly numOfFinishedFetches: number;
695
+ fetchHistory: ({
696
+ type: "fetch";
697
+ itemId: string;
698
+ fields: string[] | undefined;
699
+ result: "aborted" | "error" | Row;
700
+ startedAt: number;
701
+ duration: number;
702
+ } | {
703
+ type: "list";
704
+ itemIds: string[] | undefined;
705
+ offset: number;
706
+ limit: number | undefined;
707
+ fields: string[] | undefined;
708
+ filters: import("../../mocks/serverTableMock").FilterOperator[] | undefined;
709
+ batchKey: string | undefined;
710
+ startedAt: number;
711
+ duration: number;
712
+ results: "aborted" | {
713
+ itemId: string;
714
+ data: "error" | Row;
715
+ }[];
716
+ })[];
717
+ clearFetchHistory(): void;
718
+ getRequestHistory(fetchType?: "all" | "item" | "list", options?: {
719
+ includeTime?: boolean | undefined;
720
+ } | undefined): {
721
+ _type: "item" | "list" | undefined;
722
+ payload: unknown;
723
+ time?: string | undefined;
724
+ returned_items?: number | undefined;
725
+ }[];
726
+ }, "wsEvents">;
727
+ readonly uiChanges: Record<string, unknown>[];
728
+ readonly actions: {
729
+ action: string;
730
+ time: number;
731
+ uiValue: unknown;
732
+ actionValue?: unknown;
733
+ id?: string | number | undefined;
734
+ itemId?: string | undefined;
735
+ itemUiValues?: Record<string, unknown> | undefined;
736
+ }[];
737
+ trackItemUI: (itemId: string, value: unknown) => unknown;
738
+ addTimelineComments: (reference: "afterLastAction" | "beforeNextAction" | {
739
+ action: string;
740
+ id?: string | number | undefined;
741
+ }, comments: (string | {
742
+ comment: string;
743
+ deltaMs?: number | undefined;
744
+ })[]) => void;
745
+ getItemKey: (tableId: string, rowId: number) => string;
746
+ getStoreItemKey: (tableId: string, rowId: number) => string;
747
+ getStoreItemKeyFromRaw: (rawKey: string) => string;
748
+ getQueryKey: (params: import("../../mocks/listQueryStoreTestEnv").ListQueryParams) => string;
749
+ getItemQueryState: (rawItemKey: string) => import("../../../src/main").TSDFItemQuery<string> | null | undefined;
750
+ scheduleFetch: (fetchType: import("../../../src/requestScheduler").FetchType, params: import("../../mocks/listQueryStoreTestEnv").ListQueryParams, size?: number | undefined, options?: {
751
+ mediumPriorityDelayMs?: number | undefined;
752
+ } | undefined) => "scheduled" | "skipped" | "started" | "triggered";
753
+ scheduleItemFetch: (fetchType: import("../../../src/requestScheduler").FetchType, itemPayload: string, options?: {
754
+ mediumPriorityDelayMs?: number | undefined;
755
+ } | undefined) => "scheduled" | "skipped" | "started" | "triggered";
756
+ forceListUpdate: (params: import("../../mocks/listQueryStoreTestEnv").ListQueryParams) => "started" | "triggered";
757
+ performClientItemUpdateAction: (itemId: string, newValue: Partial<Row>, { withRevalidation, withOptimisticUpdate, duration, triggerRTU, addServerDataChangeAction, error, }?: {
758
+ withRevalidation?: boolean | undefined;
759
+ withOptimisticUpdate?: boolean | undefined;
760
+ duration?: number | undefined;
761
+ triggerRTU?: boolean | undefined;
762
+ addServerDataChangeAction?: boolean | undefined;
763
+ error?: string | undefined;
764
+ }) => Promise<import("t-result").Result<unknown, import("../../../src/main").MutationSkipped | import("../../../src/main").StoreMutationError>>;
765
+ readonly timelineString: string;
766
+ clearTimeline(): void;
767
+ getRelativeTime: () => number;
768
+ };
769
+ export declare function syncEntriesOfflineProtectedFromSiblingTab(sessionKey: string, keys: string[]): Promise<void>;
770
+ export declare function setProtectedKeysSnapshot(sessionKey: string, keys: string[]): void;
771
+ /**
772
+ * Replaces `requestIdleCallback` with a manually driven queue so tests decide
773
+ * how much deadline budget each background maintenance slice receives.
774
+ */
775
+ export declare function stubIdleCallbacks(): {
776
+ pendingCount: () => number;
777
+ runNext: (timeRemaining: () => number, didTimeout?: boolean) => Promise<void>;
778
+ runUntilIdle: (timeRemaining: () => number) => Promise<void>;
779
+ };
780
+ /**
781
+ * Options for tests that seed several full maintenance removal batches; their
782
+ * real storage mock work can exceed the default timeout on loaded runners.
783
+ */
784
+ export declare const LARGE_MAINTENANCE_TEST_OPTIONS: {
785
+ timeout: number;
786
+ };
787
+ /**
788
+ * Deadline whose budget is spent by maintenance checking it: each check stands
789
+ * for one chunk of scan, sort, or commit work in that idle period.
790
+ */
791
+ export declare function createChunkBudgetDeadline(chunks: number): () => number;
792
+ /**
793
+ * Deadline that expires after `budgetMs` of (fake) wall-clock time, like a
794
+ * browser idle period, so awaited storage I/O spends the same budget.
795
+ */
796
+ export declare function createWallClockDeadline(budgetMs: number): () => number;
797
+ /**
798
+ * Deadline that expires once at least `deleteCount` more OPFS files were
799
+ * deleted, so a maintenance slice runs out of time right after a batch.
800
+ */
801
+ export declare function createDeadlineUntilFileDeletes(mockAdapter: MockOpfsAdapter, deleteCount: number): () => number;
802
+ /** Keys OPFS background maintenance removes per commit. */
803
+ export declare const opfsMaintenanceRemoveBatchSize: number;
804
+ export {};