react-native-cloud-sync 0.3.0 → 0.4.0

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.
@@ -120,6 +120,246 @@ export function useCloudItem(store, key, options = {}) {
120
120
  refresh: read
121
121
  };
122
122
  }
123
+ /**
124
+ * Binds a list of keys to component state with one batched `multiGet`.
125
+ *
126
+ * The multi-key sibling of `useCloudItem` - a screen with many cloud-backed
127
+ * records (a list, one key per item) otherwise ends up calling `useCloudItem`
128
+ * once per row: one `getItem` and one `onRemoteChange` subscription each,
129
+ * instead of a single batched read.
130
+ *
131
+ * Only ever fetches keys it does not already hold an answer for. Mount,
132
+ * `refresh()`, and a matching remote-change event all fetch normally, but a
133
+ * key merely joining the tracked list - because a caller like
134
+ * `useCloudCollection` just added it after a local write - is never
135
+ * re-fetched on that account alone, so a slow fetch elsewhere in the list
136
+ * can't land a stale value on top of a write that already resolved locally.
137
+ *
138
+ * ```tsx
139
+ * const { values, setValue } = useCloudItems<Note>(store, noteIds)
140
+ * ```
141
+ */
142
+ export function useCloudItems(store, keys, options = {}) {
143
+ const {
144
+ parse = JSON.parse,
145
+ serialize = JSON.stringify,
146
+ watch = true
147
+ } = options;
148
+ const [values, setValuesState] = useState({});
149
+ const [loading, setLoading] = useState(true);
150
+ const [error, setError] = useState(null);
151
+ const mounted = useRef(true);
152
+ useEffect(() => {
153
+ mounted.current = true;
154
+ return () => {
155
+ mounted.current = false;
156
+ };
157
+ }, []);
158
+ const parseRef = useRef(parse);
159
+ parseRef.current = parse;
160
+ const keysRef = useRef(keys);
161
+ keysRef.current = keys;
162
+ const keysSignature = JSON.stringify(keys);
163
+
164
+ // Latest values alongside the state, so effects can read "do we already
165
+ // have this key" without taking `values` itself as a dependency.
166
+ const valuesRef = useRef(values);
167
+ const setValues = useCallback(updater => {
168
+ setValuesState(prev => {
169
+ const next = updater(prev);
170
+ valuesRef.current = next;
171
+ return next;
172
+ });
173
+ }, []);
174
+
175
+ // Per-key ticket, not one shared counter: two fetches for disjoint keys
176
+ // run concurrently (an initial load still in flight plus a remote event for
177
+ // a key that just appeared), and a shared ticket would let the second
178
+ // invalidate the first's unrelated result.
179
+ const keyTicket = useRef(new Map());
180
+ const bump = key => {
181
+ const next = (keyTicket.current.get(key) ?? 0) + 1;
182
+ keyTicket.current.set(key, next);
183
+ return next;
184
+ };
185
+ const fetchKeys = useCallback(async toFetch => {
186
+ if (toFetch.length === 0) return;
187
+ const mine = new Map(toFetch.map(k => [k, bump(k)]));
188
+ try {
189
+ const pairs = await store.multiGet(toFetch);
190
+ if (!mounted.current) return;
191
+ setValues(prev => {
192
+ const next = {
193
+ ...prev
194
+ };
195
+ for (const [k, raw] of pairs) {
196
+ // A write or a newer fetch already claimed this key - this answer
197
+ // is no longer the current one.
198
+ if (keyTicket.current.get(k) !== mine.get(k)) continue;
199
+ next[k] = raw == null ? null : parseRef.current(raw);
200
+ }
201
+ return next;
202
+ });
203
+ setError(null);
204
+ } catch (e) {
205
+ if (!mounted.current) return;
206
+ // Only surface the failure if at least one of these keys is still
207
+ // uncontested - a fetch overtaken by a write or another fetch failing
208
+ // is not new information.
209
+ const stillCurrent = toFetch.some(k => keyTicket.current.get(k) === mine.get(k));
210
+ if (stillCurrent) setError(normalizeError(e));
211
+ }
212
+ }, [store, setValues]);
213
+
214
+ // Fetches keys new to the tracked list and drops values for keys no longer
215
+ // in it. Doubles as the initial load: on mount every key is "missing".
216
+ const hasLoadedOnce = useRef(false);
217
+ useEffect(() => {
218
+ const current = keysRef.current;
219
+ const missing = current.filter(k => !(k in valuesRef.current));
220
+ const keep = new Set(current);
221
+ setValues(prev => {
222
+ let changed = false;
223
+ const next = {};
224
+ for (const k of Object.keys(prev)) if (keep.has(k)) next[k] = prev[k];else changed = true;
225
+ return changed ? next : prev;
226
+ });
227
+ if (!hasLoadedOnce.current) {
228
+ hasLoadedOnce.current = true;
229
+ setLoading(true);
230
+ void fetchKeys(missing).finally(() => {
231
+ if (mounted.current) setLoading(false);
232
+ });
233
+ } else if (missing.length > 0) {
234
+ void fetchKeys(missing);
235
+ }
236
+ }, [keysSignature, fetchKeys, setValues]);
237
+ useEffect(() => {
238
+ if (!watch) return;
239
+ return store.onRemoteChange(e => {
240
+ if (e.keys.length === 0) {
241
+ void fetchKeys(keysRef.current);
242
+ return;
243
+ }
244
+ const intersecting = e.keys.filter(k => keysRef.current.includes(k));
245
+ if (intersecting.length > 0) void fetchKeys(intersecting);
246
+ });
247
+ }, [store, watch, fetchKeys]);
248
+ const setValue = useCallback(async (key, next) => {
249
+ bump(key);
250
+ setValues(prev => ({
251
+ ...prev,
252
+ [key]: next
253
+ }));
254
+ try {
255
+ await store.setItem(key, serialize(next));
256
+ if (mounted.current) setError(null);
257
+ } catch (e) {
258
+ if (mounted.current) setError(normalizeError(e));
259
+ throw e;
260
+ }
261
+ }, [store, serialize, setValues]);
262
+ const remove = useCallback(async key => {
263
+ bump(key);
264
+ setValues(prev => ({
265
+ ...prev,
266
+ [key]: null
267
+ }));
268
+ try {
269
+ await store.removeItem(key);
270
+ if (mounted.current) setError(null);
271
+ } catch (e) {
272
+ if (mounted.current) setError(normalizeError(e));
273
+ throw e;
274
+ }
275
+ }, [store, setValues]);
276
+ const refresh = useCallback(async () => {
277
+ setLoading(true);
278
+ try {
279
+ await fetchKeys(keysRef.current);
280
+ } finally {
281
+ if (mounted.current) setLoading(false);
282
+ }
283
+ }, [fetchKeys]);
284
+ return {
285
+ values,
286
+ loading,
287
+ error,
288
+ setValue,
289
+ remove,
290
+ refresh
291
+ };
292
+ }
293
+ /**
294
+ * Live-binds every key starting with `prefix` to component state.
295
+ *
296
+ * Adds the membership index `useCloudItems` needs but does not derive
297
+ * itself: `getAllKeys()` filtered by prefix on mount and after any remote
298
+ * change that could plausibly have added or removed a member, then
299
+ * `useCloudItems` for the values.
300
+ *
301
+ * A `setValue` for a key not seen before joins the collection immediately -
302
+ * a newly created record should appear in its own list without waiting on a
303
+ * round trip to confirm it.
304
+ *
305
+ * ```tsx
306
+ * const { keys, values, setValue, remove } = useCloudCollection<Note>(store, 'note:')
307
+ * ```
308
+ */
309
+ export function useCloudCollection(store, prefix, options = {}) {
310
+ const {
311
+ watch = true
312
+ } = options;
313
+ const [keys, setKeys] = useState([]);
314
+ const mounted = useRef(true);
315
+ useEffect(() => {
316
+ mounted.current = true;
317
+ return () => {
318
+ mounted.current = false;
319
+ };
320
+ }, []);
321
+ const listKeys = useCallback(async () => {
322
+ const all = await store.getAllKeys();
323
+ if (!mounted.current) return;
324
+ setKeys(all.filter(k => k.startsWith(prefix)));
325
+ }, [store, prefix]);
326
+ useEffect(() => {
327
+ void listKeys();
328
+ }, [listKeys]);
329
+ useEffect(() => {
330
+ if (!watch) return;
331
+ return store.onRemoteChange(e => {
332
+ // A prefix collection can gain or lose members on another device, not
333
+ // just change the value of one already in it - re-list on an opaque
334
+ // event too, not only one that names a key under this prefix.
335
+ if (e.keys.length > 0 && !e.keys.some(k => k.startsWith(prefix))) return;
336
+ void listKeys();
337
+ });
338
+ }, [store, prefix, watch, listKeys]);
339
+ const items = useCloudItems(store, keys, options);
340
+ const setValue = useCallback(async (key, next) => {
341
+ if (key.startsWith(prefix)) setKeys(prev => prev.includes(key) ? prev : [...prev, key]);
342
+ await items.setValue(key, next);
343
+ }, [items, prefix]);
344
+ const remove = useCallback(async key => {
345
+ await items.remove(key);
346
+ setKeys(prev => prev.includes(key) ? prev.filter(k => k !== key) : prev);
347
+ }, [items]);
348
+ const refresh = useCallback(async () => {
349
+ // Concurrent, not sequential: a key that only `listKeys` turns up gets
350
+ // its value shortly after anyway, through the same membership-diff
351
+ // effect that handles a live remote event, so there is nothing to gain
352
+ // from waiting for the listing before starting `items.refresh()`.
353
+ await Promise.all([listKeys(), items.refresh()]);
354
+ }, [listKeys, items]);
355
+ return {
356
+ ...items,
357
+ setValue,
358
+ remove,
359
+ refresh,
360
+ keys
361
+ };
362
+ }
123
363
  /**
124
364
  * Tracks a provider's account state, including the identity-switch event.
125
365
  *
@@ -1 +1 @@
1
- {"version":3,"names":["useCallback","useEffect","useMemo","useRef","useState","normalizeError","useCloudItem","store","key","options","initialValue","parse","JSON","serialize","stringify","watch","value","setLocalValue","loading","setLoading","error","setError","mounted","current","ticket","parseRef","read","mine","raw","getItem","e","onRemoteChange","keys","length","includes","setValue","next","setItem","remove","removeItem","refresh","useAccountStatus","provider","status","setStatus","identityChanged","setIdentityChanged","getAccountStatus","onAccountChange","usePendingWrites","pollIntervalMs","pending","setPending","pendingWrites","sync","timer","setInterval","clearInterval","flush","flushOutbox","discard","filter","discardPendingWrites","useRemoteChange","listener","ref","useQuota","quota","setQuota","getQuota"],"sourceRoot":"../../src","sources":["hooks.ts"],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"names":["useCallback","useEffect","useMemo","useRef","useState","normalizeError","useCloudItem","store","key","options","initialValue","parse","JSON","serialize","stringify","watch","value","setLocalValue","loading","setLoading","error","setError","mounted","current","ticket","parseRef","read","mine","raw","getItem","e","onRemoteChange","keys","length","includes","setValue","next","setItem","remove","removeItem","refresh","useCloudItems","values","setValuesState","keysRef","keysSignature","valuesRef","setValues","updater","prev","keyTicket","Map","bump","get","set","fetchKeys","toFetch","map","k","pairs","multiGet","stillCurrent","some","hasLoadedOnce","missing","filter","keep","Set","changed","Object","has","finally","intersecting","useCloudCollection","prefix","setKeys","listKeys","all","getAllKeys","startsWith","items","Promise","useAccountStatus","provider","status","setStatus","identityChanged","setIdentityChanged","getAccountStatus","onAccountChange","usePendingWrites","pollIntervalMs","pending","setPending","pendingWrites","sync","timer","setInterval","clearInterval","flush","flushOutbox","discard","discardPendingWrites","useRemoteChange","listener","ref","useQuota","quota","setQuota","getQuota"],"sourceRoot":"../../src","sources":["hooks.ts"],"mappings":"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","ignoreList":[]}
@@ -3,8 +3,8 @@
3
3
  /**
4
4
  * react-native-cloud-sync
5
5
  *
6
- * iCloud key-value store, CloudKit and Google Drive behind one API, on iOS,
7
- * Android and the web, on both React Native architectures.
6
+ * iCloud key-value store, CloudKit, iCloud Drive and Google Drive behind one API,
7
+ * on iOS, Android and the web, on both React Native architectures.
8
8
  */
9
9
 
10
10
  // Providers, each usable directly.
@@ -52,6 +52,74 @@ export interface UseCloudItemOptions<T> {
52
52
  * ```
53
53
  */
54
54
  export declare function useCloudItem<T = unknown>(store: CloudStore, key: string, options?: UseCloudItemOptions<T>): UseCloudItemResult<T>;
55
+ export interface UseCloudItemsResult<T> {
56
+ /**
57
+ * Parsed value per key. A key mapped to `null` was fetched and does not
58
+ * exist; a key absent from this object has not been fetched yet.
59
+ */
60
+ values: Record<string, T | null>;
61
+ /** True only during the initial fetch of `keys`, and during an explicit `refresh()`. */
62
+ loading: boolean;
63
+ /** The last read or write failure, or null. Cleared by the next success. */
64
+ error: CloudSyncError | null;
65
+ /** Writes through to the store and updates local state optimistically. */
66
+ setValue: (key: string, next: T) => Promise<void>;
67
+ remove: (key: string) => Promise<void>;
68
+ /** Re-fetches every key currently tracked. */
69
+ refresh: () => Promise<void>;
70
+ }
71
+ export interface UseCloudItemsOptions<T> {
72
+ parse?: (raw: string) => T;
73
+ serialize?: (value: T) => string;
74
+ /**
75
+ * Re-fetch a key when another device changes it. Default true.
76
+ *
77
+ * An event naming no keys (an account or quota event) re-fetches every
78
+ * tracked key, same as `useCloudItem`.
79
+ */
80
+ watch?: boolean;
81
+ }
82
+ /**
83
+ * Binds a list of keys to component state with one batched `multiGet`.
84
+ *
85
+ * The multi-key sibling of `useCloudItem` - a screen with many cloud-backed
86
+ * records (a list, one key per item) otherwise ends up calling `useCloudItem`
87
+ * once per row: one `getItem` and one `onRemoteChange` subscription each,
88
+ * instead of a single batched read.
89
+ *
90
+ * Only ever fetches keys it does not already hold an answer for. Mount,
91
+ * `refresh()`, and a matching remote-change event all fetch normally, but a
92
+ * key merely joining the tracked list - because a caller like
93
+ * `useCloudCollection` just added it after a local write - is never
94
+ * re-fetched on that account alone, so a slow fetch elsewhere in the list
95
+ * can't land a stale value on top of a write that already resolved locally.
96
+ *
97
+ * ```tsx
98
+ * const { values, setValue } = useCloudItems<Note>(store, noteIds)
99
+ * ```
100
+ */
101
+ export declare function useCloudItems<T = unknown>(store: CloudStore, keys: string[], options?: UseCloudItemsOptions<T>): UseCloudItemsResult<T>;
102
+ export interface UseCloudCollectionResult<T> extends UseCloudItemsResult<T> {
103
+ /** Keys currently in the collection. */
104
+ keys: string[];
105
+ }
106
+ /**
107
+ * Live-binds every key starting with `prefix` to component state.
108
+ *
109
+ * Adds the membership index `useCloudItems` needs but does not derive
110
+ * itself: `getAllKeys()` filtered by prefix on mount and after any remote
111
+ * change that could plausibly have added or removed a member, then
112
+ * `useCloudItems` for the values.
113
+ *
114
+ * A `setValue` for a key not seen before joins the collection immediately -
115
+ * a newly created record should appear in its own list without waiting on a
116
+ * round trip to confirm it.
117
+ *
118
+ * ```tsx
119
+ * const { keys, values, setValue, remove } = useCloudCollection<Note>(store, 'note:')
120
+ * ```
121
+ */
122
+ export declare function useCloudCollection<T = unknown>(store: CloudStore, prefix: string, options?: UseCloudItemsOptions<T>): UseCloudCollectionResult<T>;
55
123
  export interface UseAccountStatusResult {
56
124
  status: AccountStatus | null;
57
125
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9D,OAAO,KAAK,EAEV,aAAa,EACb,aAAa,EACb,WAAW,EACX,iBAAiB,EAClB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IACf,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAA;IAChB,4EAA4E;IAC5E,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IAC5B,0EAA0E;IAC1E,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,GAAG,IAAI,CAAA;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAA;IAC1B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAA;IAChC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EACtC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAmB,CAAC,CAAC,CAAM,GACnC,kBAAkB,CAAC,CAAC,CAAC,CAsGvB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAA;IACxB,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,sBAAsB,CAsChF;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,uDAAuD;IACvD,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,KAAK,IAAI,CAAA;CACxD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,cAAc,SAAO,GACpB,sBAAsB,CA+BxB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,GACvC,IAAI,CAKN;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG;IAC3C,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IAClD,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B,CAyBA"}
1
+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"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"}
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * react-native-cloud-sync
3
3
  *
4
- * iCloud key-value store, CloudKit and Google Drive behind one API, on iOS,
5
- * Android and the web, on both React Native architectures.
4
+ * iCloud key-value store, CloudKit, iCloud Drive and Google Drive behind one API,
5
+ * on iOS, Android and the web, on both React Native architectures.
6
6
  */
7
7
  export { icloudKV, getAllItems as icloudKVGetAllItems, sync as icloudKVSync } from './providers/icloudKV';
8
8
  export { cloudKit, createCloudKitProvider, zones as cloudKitZones, assets as cloudKitAssets } from './providers/cloudKit';
@@ -52,6 +52,74 @@ export interface UseCloudItemOptions<T> {
52
52
  * ```
53
53
  */
54
54
  export declare function useCloudItem<T = unknown>(store: CloudStore, key: string, options?: UseCloudItemOptions<T>): UseCloudItemResult<T>;
55
+ export interface UseCloudItemsResult<T> {
56
+ /**
57
+ * Parsed value per key. A key mapped to `null` was fetched and does not
58
+ * exist; a key absent from this object has not been fetched yet.
59
+ */
60
+ values: Record<string, T | null>;
61
+ /** True only during the initial fetch of `keys`, and during an explicit `refresh()`. */
62
+ loading: boolean;
63
+ /** The last read or write failure, or null. Cleared by the next success. */
64
+ error: CloudSyncError | null;
65
+ /** Writes through to the store and updates local state optimistically. */
66
+ setValue: (key: string, next: T) => Promise<void>;
67
+ remove: (key: string) => Promise<void>;
68
+ /** Re-fetches every key currently tracked. */
69
+ refresh: () => Promise<void>;
70
+ }
71
+ export interface UseCloudItemsOptions<T> {
72
+ parse?: (raw: string) => T;
73
+ serialize?: (value: T) => string;
74
+ /**
75
+ * Re-fetch a key when another device changes it. Default true.
76
+ *
77
+ * An event naming no keys (an account or quota event) re-fetches every
78
+ * tracked key, same as `useCloudItem`.
79
+ */
80
+ watch?: boolean;
81
+ }
82
+ /**
83
+ * Binds a list of keys to component state with one batched `multiGet`.
84
+ *
85
+ * The multi-key sibling of `useCloudItem` - a screen with many cloud-backed
86
+ * records (a list, one key per item) otherwise ends up calling `useCloudItem`
87
+ * once per row: one `getItem` and one `onRemoteChange` subscription each,
88
+ * instead of a single batched read.
89
+ *
90
+ * Only ever fetches keys it does not already hold an answer for. Mount,
91
+ * `refresh()`, and a matching remote-change event all fetch normally, but a
92
+ * key merely joining the tracked list - because a caller like
93
+ * `useCloudCollection` just added it after a local write - is never
94
+ * re-fetched on that account alone, so a slow fetch elsewhere in the list
95
+ * can't land a stale value on top of a write that already resolved locally.
96
+ *
97
+ * ```tsx
98
+ * const { values, setValue } = useCloudItems<Note>(store, noteIds)
99
+ * ```
100
+ */
101
+ export declare function useCloudItems<T = unknown>(store: CloudStore, keys: string[], options?: UseCloudItemsOptions<T>): UseCloudItemsResult<T>;
102
+ export interface UseCloudCollectionResult<T> extends UseCloudItemsResult<T> {
103
+ /** Keys currently in the collection. */
104
+ keys: string[];
105
+ }
106
+ /**
107
+ * Live-binds every key starting with `prefix` to component state.
108
+ *
109
+ * Adds the membership index `useCloudItems` needs but does not derive
110
+ * itself: `getAllKeys()` filtered by prefix on mount and after any remote
111
+ * change that could plausibly have added or removed a member, then
112
+ * `useCloudItems` for the values.
113
+ *
114
+ * A `setValue` for a key not seen before joins the collection immediately -
115
+ * a newly created record should appear in its own list without waiting on a
116
+ * round trip to confirm it.
117
+ *
118
+ * ```tsx
119
+ * const { keys, values, setValue, remove } = useCloudCollection<Note>(store, 'note:')
120
+ * ```
121
+ */
122
+ export declare function useCloudCollection<T = unknown>(store: CloudStore, prefix: string, options?: UseCloudItemsOptions<T>): UseCloudCollectionResult<T>;
55
123
  export interface UseAccountStatusResult {
56
124
  status: AccountStatus | null;
57
125
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAS,CAAA;AACzC,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,aAAU,CAAA;AAC9D,OAAO,KAAK,EAEV,aAAa,EACb,aAAa,EACb,WAAW,EACX,iBAAiB,EAClB,MAAM,YAAS,CAAA;AAEhB;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IACf,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAA;IAChB,4EAA4E;IAC5E,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IAC5B,0EAA0E;IAC1E,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,GAAG,IAAI,CAAA;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAA;IAC1B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAA;IAChC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EACtC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAmB,CAAC,CAAC,CAAM,GACnC,kBAAkB,CAAC,CAAC,CAAC,CAsGvB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAA;IACxB,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,sBAAsB,CAsChF;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,uDAAuD;IACvD,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,KAAK,IAAI,CAAA;CACxD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,cAAc,SAAO,GACpB,sBAAsB,CA+BxB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,GACvC,IAAI,CAKN;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG;IAC3C,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IAClD,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B,CAyBA"}
1
+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"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"}
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * react-native-cloud-sync
3
3
  *
4
- * iCloud key-value store, CloudKit and Google Drive behind one API, on iOS,
5
- * Android and the web, on both React Native architectures.
4
+ * iCloud key-value store, CloudKit, iCloud Drive and Google Drive behind one API,
5
+ * on iOS, Android and the web, on both React Native architectures.
6
6
  */
7
7
  export { icloudKV, getAllItems as icloudKVGetAllItems, sync as icloudKVSync } from './providers/icloudKV';
8
8
  export { cloudKit, createCloudKitProvider, zones as cloudKitZones, assets as cloudKitAssets } from './providers/cloudKit.js';
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "react-native-cloud-sync",
3
- "version": "0.3.0",
4
- "description": "Sync React Native app data across iCloud, CloudKit and Google Drive behind one API - offline-first with automatic retry, real-time updates and optional end-to-end encryption. iOS, Android, Web, old and new architecture",
3
+ "version": "0.4.0",
4
+ "description": "Sync React Native app data across iCloud key-value store, CloudKit, iCloud Drive and Google Drive behind one API - offline-first with automatic retry, real-time updates and optional end-to-end encryption. iOS, Android, Web, old and new architecture",
5
5
  "workspaces": [
6
6
  "example"
7
7
  ],
@@ -142,9 +142,11 @@
142
142
  "@react-native/jest-preset": "^0.86.2",
143
143
  "@react-native/metro-config": "^0.86.2",
144
144
  "@stylistic/eslint-plugin": "^5.10.0",
145
+ "@testing-library/react-native": "^13.3.3",
145
146
  "@types/jest": "^29.5.14",
146
147
  "@types/node": "^26.2.0",
147
148
  "@types/react": "^19.2.18",
149
+ "@types/react-test-renderer": "^19",
148
150
  "babel-jest": "^29.7.0",
149
151
  "del-cli": "^7.0.0",
150
152
  "eslint": "^10.8.0",
@@ -155,6 +157,7 @@
155
157
  "react": "19.2.3",
156
158
  "react-native": "0.86.2",
157
159
  "react-native-builder-bob": "^0.43.0",
160
+ "react-test-renderer": "19.2.3",
158
161
  "typescript": "^6.0.3",
159
162
  "typescript-eslint": "^8.66.0"
160
163
  },