@marktiderman/genesis-core 2.12.0 → 2.13.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.
Files changed (97) hide show
  1. package/dist/{chunk-PSFKIG27.js → chunk-2K4747KX.js} +7 -4
  2. package/dist/chunk-2K4747KX.js.map +1 -0
  3. package/dist/{chunk-ZYJUEJ4Z.js → chunk-4PTQYT5J.js} +11 -5
  4. package/dist/chunk-4PTQYT5J.js.map +1 -0
  5. package/dist/{chunk-HBAPYA5K.js → chunk-5ASUMG6K.js} +3 -3
  6. package/dist/{chunk-HBAPYA5K.js.map → chunk-5ASUMG6K.js.map} +1 -1
  7. package/dist/{chunk-C62CMLWG.js → chunk-AHFIS42U.js} +6 -6
  8. package/dist/{chunk-C62CMLWG.js.map → chunk-AHFIS42U.js.map} +1 -1
  9. package/dist/{chunk-VJGU6E4U.js → chunk-DFABPMEQ.js} +13 -9
  10. package/dist/chunk-DFABPMEQ.js.map +1 -0
  11. package/dist/{chunk-POMTRNAL.js → chunk-G6GQPXQS.js} +4 -4
  12. package/dist/{chunk-POMTRNAL.js.map → chunk-G6GQPXQS.js.map} +1 -1
  13. package/dist/{chunk-ZHC3MDCS.js → chunk-JN47G4UE.js} +25 -16
  14. package/dist/chunk-JN47G4UE.js.map +1 -0
  15. package/dist/{chunk-2VJQVAJD.js → chunk-KA3BUJ4H.js} +3 -3
  16. package/dist/{chunk-2VJQVAJD.js.map → chunk-KA3BUJ4H.js.map} +1 -1
  17. package/dist/{chunk-2WS4LGYU.js → chunk-LKRJB632.js} +3 -3
  18. package/dist/{chunk-2WS4LGYU.js.map → chunk-LKRJB632.js.map} +1 -1
  19. package/dist/{chunk-LOJGHR5O.js → chunk-NE2D74BP.js} +4 -4
  20. package/dist/{chunk-LOJGHR5O.js.map → chunk-NE2D74BP.js.map} +1 -1
  21. package/dist/{chunk-VFT6QKZW.js → chunk-NOPS5EIH.js} +3 -3
  22. package/dist/{chunk-VFT6QKZW.js.map → chunk-NOPS5EIH.js.map} +1 -1
  23. package/dist/{chunk-52T2EYXH.js → chunk-NQFIAULD.js} +3 -3
  24. package/dist/{chunk-52T2EYXH.js.map → chunk-NQFIAULD.js.map} +1 -1
  25. package/dist/{chunk-3B5O36DU.js → chunk-OYDJGPDY.js} +7 -7
  26. package/dist/{chunk-3B5O36DU.js.map → chunk-OYDJGPDY.js.map} +1 -1
  27. package/dist/{chunk-OC4OGB2K.js → chunk-P3FHXRS2.js} +9 -6
  28. package/dist/chunk-P3FHXRS2.js.map +1 -0
  29. package/dist/{chunk-YNXLPOAB.js → chunk-RFHUOXZC.js} +4 -4
  30. package/dist/{chunk-YNXLPOAB.js.map → chunk-RFHUOXZC.js.map} +1 -1
  31. package/dist/{chunk-XVRIWP7B.js → chunk-S2VYJWB4.js} +3 -3
  32. package/dist/{chunk-XVRIWP7B.js.map → chunk-S2VYJWB4.js.map} +1 -1
  33. package/dist/{chunk-HYYTAJBG.js → chunk-SDAJSJNN.js} +3 -3
  34. package/dist/chunk-SDAJSJNN.js.map +1 -0
  35. package/dist/{chunk-42QPCDQF.js → chunk-WDPM5TBO.js} +3 -3
  36. package/dist/{chunk-42QPCDQF.js.map → chunk-WDPM5TBO.js.map} +1 -1
  37. package/dist/{chunk-LG6TUBVM.js → chunk-WLDSIQJ2.js} +4 -3
  38. package/dist/chunk-WLDSIQJ2.js.map +1 -0
  39. package/dist/{chunk-YQBWXG2G.js → chunk-YZV3Z6ZA.js} +3 -3
  40. package/dist/{chunk-YQBWXG2G.js.map → chunk-YZV3Z6ZA.js.map} +1 -1
  41. package/dist/conversation/index.d.ts +13 -2
  42. package/dist/conversation/index.js +7 -2
  43. package/dist/conversation/index.js.map +1 -1
  44. package/dist/csv.d.ts +1 -1
  45. package/dist/errors.js +2 -2
  46. package/dist/form-types.d.ts +1 -1
  47. package/dist/hooks/draft-controller.js +2 -2
  48. package/dist/hooks/index.d.ts +1 -1
  49. package/dist/hooks/index.js +19 -19
  50. package/dist/hooks/mutation-mode.d.ts +1 -1
  51. package/dist/hooks/mutation-mode.js +6 -6
  52. package/dist/hooks/related-keys.d.ts +1 -1
  53. package/dist/hooks/use-capabilities.d.ts +1 -1
  54. package/dist/hooks/use-capabilities.js +3 -3
  55. package/dist/hooks/use-draft.js +3 -3
  56. package/dist/hooks/use-infinite-resource.d.ts +1 -1
  57. package/dist/hooks/use-infinite-resource.js +4 -4
  58. package/dist/hooks/use-link-options.d.ts +2 -1
  59. package/dist/hooks/use-link-options.js +6 -6
  60. package/dist/hooks/use-live.d.ts +1 -1
  61. package/dist/hooks/use-live.js +3 -3
  62. package/dist/hooks/use-one.d.ts +1 -1
  63. package/dist/hooks/use-one.js +4 -4
  64. package/dist/hooks/use-persisted-ui-state.js +3 -3
  65. package/dist/hooks/use-relation-label.d.ts +1 -1
  66. package/dist/hooks/use-relation-label.js +3 -3
  67. package/dist/hooks/use-resource-form.d.ts +1 -1
  68. package/dist/hooks/use-resource-form.js +10 -10
  69. package/dist/hooks/use-resource.d.ts +1 -1
  70. package/dist/hooks/use-resource.js +8 -8
  71. package/dist/hooks/use-write.d.ts +1 -1
  72. package/dist/hooks/use-write.js +2 -2
  73. package/dist/index.d.ts +3 -3
  74. package/dist/index.js +20 -20
  75. package/dist/navigation.d.ts +18 -1
  76. package/dist/navigation.js +7 -1
  77. package/dist/navigation.js.map +1 -1
  78. package/dist/provider/index.d.ts +4 -4
  79. package/dist/provider/index.js +5 -5
  80. package/dist/resource-view/index.d.ts +9 -2
  81. package/dist/resource-view/index.js +13 -4
  82. package/dist/resource-view/index.js.map +1 -1
  83. package/dist/schema/index.d.ts +3 -3
  84. package/dist/schema/index.js +2 -2
  85. package/dist/storage/index.js +1 -1
  86. package/dist/testing/index.d.ts +2 -2
  87. package/dist/testing/index.js +1 -1
  88. package/dist/{types-BzLv8yOm.d.ts → types-CtJxwoyv.d.ts} +6 -0
  89. package/dist/{write-outcome-DC5hORz-.d.ts → write-outcome-Goy1v39G.d.ts} +4 -2
  90. package/package.json +1 -1
  91. package/dist/chunk-HYYTAJBG.js.map +0 -1
  92. package/dist/chunk-LG6TUBVM.js.map +0 -1
  93. package/dist/chunk-OC4OGB2K.js.map +0 -1
  94. package/dist/chunk-PSFKIG27.js.map +0 -1
  95. package/dist/chunk-VJGU6E4U.js.map +0 -1
  96. package/dist/chunk-ZHC3MDCS.js.map +0 -1
  97. package/dist/chunk-ZYJUEJ4Z.js.map +0 -1
@@ -1,6 +1,6 @@
1
- import { x as ResourceContract, b as Identifier, h as DataRow } from '../types-BzLv8yOm.js';
2
- export { c as AuditEntry, k as FieldPermissions, l as FieldReference, F as FieldSchema, n as FilterOperator, t as ProviderCapabilities, u as RecordComment, v as ResourceAccess, z as ResourceRelation, E as ResourceSchema, J as ResourceSummary, K as RowAction, O as RowOf, U as StorageType, Z as VersionField, m as WidgetHint, _ as defineResource } from '../types-BzLv8yOm.js';
3
- export { D as DataWriteError, a as DataWriteErrorOptions, W as WriteOutcome, i as isDataWriteError } from '../write-outcome-DC5hORz-.js';
1
+ import { x as ResourceContract, b as Identifier, h as DataRow } from '../types-CtJxwoyv.js';
2
+ export { c as AuditEntry, k as FieldPermissions, l as FieldReference, F as FieldSchema, n as FilterOperator, t as ProviderCapabilities, u as RecordComment, v as ResourceAccess, z as ResourceRelation, E as ResourceSchema, J as ResourceSummary, K as RowAction, O as RowOf, U as StorageType, Z as VersionField, m as WidgetHint, _ as defineResource } from '../types-CtJxwoyv.js';
3
+ export { D as DataWriteError, a as DataWriteErrorOptions, N as NO_ROWS_MATCHED, W as WriteOutcome, i as isDataWriteError } from '../write-outcome-Goy1v39G.js';
4
4
  export { W as WriteConflict, a as WriteConflictOptions, b as WriteState, w as writeConflict } from '../write-state-DVC4Yq9T.js';
5
5
  export { D as DataReadError, a as DataReadErrorOptions, R as ReadOutcome, i as isDataReadError, r as readFailureMessage } from '../read-outcome-BnboMYOV.js';
6
6
 
@@ -1,7 +1,7 @@
1
1
  export { defineResource } from '../chunk-YDMKMNDS.js';
2
2
  export { decodeRecordKey, encodeRecordKey, keyFields } from '../chunk-KV2HW4G4.js';
3
- export { writeConflict } from '../chunk-2WS4LGYU.js';
3
+ export { writeConflict } from '../chunk-LKRJB632.js';
4
4
  export { DataReadError, isDataReadError, readFailureMessage } from '../chunk-HUNGCTRA.js';
5
- export { DataWriteError, isDataWriteError } from '../chunk-LG6TUBVM.js';
5
+ export { DataWriteError, NO_ROWS_MATCHED, isDataWriteError } from '../chunk-WLDSIQJ2.js';
6
6
  //# sourceMappingURL=index.js.map
7
7
  //# sourceMappingURL=index.js.map
@@ -1,4 +1,4 @@
1
1
  import '../chunk-XCX2TRBL.js';
2
- export { createLocalStorageAdapter, createMemoryStorageAdapter, createNoopStorageAdapter } from '../chunk-ZYJUEJ4Z.js';
2
+ export { createLocalStorageAdapter, createMemoryStorageAdapter, createNoopStorageAdapter } from '../chunk-4PTQYT5J.js';
3
3
  //# sourceMappingURL=index.js.map
4
4
  //# sourceMappingURL=index.js.map
@@ -1,5 +1,5 @@
1
- import { D as DataProvider, b as Identifier } from '../types-BzLv8yOm.js';
2
- import { D as DataWriteError } from '../write-outcome-DC5hORz-.js';
1
+ import { D as DataProvider, b as Identifier } from '../types-CtJxwoyv.js';
2
+ import { D as DataWriteError } from '../write-outcome-Goy1v39G.js';
3
3
 
4
4
  /** The shared fixture logins, the same ids `genesis_testing.user_id()` uses. */
5
5
  declare const FIXTURE_USERS: {
@@ -1,5 +1,5 @@
1
1
  import { isDataReadError } from '../chunk-HUNGCTRA.js';
2
- import { isDataWriteError } from '../chunk-LG6TUBVM.js';
2
+ import { isDataWriteError } from '../chunk-WLDSIQJ2.js';
3
3
 
4
4
  // src/testing/index.ts
5
5
  var FIXTURE_USERS = {
@@ -82,6 +82,7 @@ interface ResourceFormFieldDef {
82
82
  orderBy?: {
83
83
  field: string;
84
84
  direction?: "asc" | "desc";
85
+ nulls?: "first" | "last";
85
86
  };
86
87
  /**
87
88
  * Filters every list request carries (the linked view's scope and default filter), fixed or
@@ -481,6 +482,11 @@ interface PaginationParam {
481
482
  interface SortParam {
482
483
  field: string;
483
484
  order: "asc" | "desc";
485
+ /**
486
+ * Where rows with no value go. Unset, the store decides: Postgres puts them last ascending and
487
+ * first descending, so a "highest first" list opens with its empty rows. Say `"last"` for those.
488
+ */
489
+ nulls?: "first" | "last";
484
490
  }
485
491
  /**
486
492
  * Filter expressions — discriminated union by operator.
@@ -1,4 +1,4 @@
1
- import { h as DataRow } from './types-BzLv8yOm.js';
1
+ import { h as DataRow } from './types-CtJxwoyv.js';
2
2
 
3
3
  /**
4
4
  * - `conflict`: someone else changed the row since it was read. `current`
@@ -18,6 +18,8 @@ import { h as DataRow } from './types-BzLv8yOm.js';
18
18
  * - `unauthenticated`: no signed-in user, or the session expired.
19
19
  * - `error`: anything else. The edit did not commit.
20
20
  */
21
+ /** `DataWriteError.code` when a write came back with no row: `useResource`'s `update` sets it. */
22
+ declare const NO_ROWS_MATCHED = "GENESIS_NO_ROWS";
21
23
  type WriteOutcome = "conflict" | "gone" | "forbidden" | "duplicate" | "invalid" | "audit_failed" | "unauthenticated" | "error";
22
24
  interface DataWriteErrorOptions {
23
25
  /** The row as it is now, for a `conflict`. Only fields the user may read. */
@@ -59,4 +61,4 @@ declare class DataWriteError extends Error {
59
61
  */
60
62
  declare function isDataWriteError(error: unknown): error is DataWriteError;
61
63
 
62
- export { DataWriteError as D, type WriteOutcome as W, type DataWriteErrorOptions as a, isDataWriteError as i };
64
+ export { DataWriteError as D, NO_ROWS_MATCHED as N, type WriteOutcome as W, type DataWriteErrorOptions as a, isDataWriteError as i };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@marktiderman/genesis-core",
3
- "version": "2.12.0",
3
+ "version": "2.13.0",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/hooks/use-persisted-ui-state.ts"],"names":["set"],"mappings":"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","file":"chunk-HYYTAJBG.js","sourcesContent":["\"use client\";\n/**\n * usePersistedUiState: a piece of UI state that outlives the page (a collapsed sidebar, a table's\n * column widths, a dock's size), kept in the app's storage adapter (`useStorage()`: localStorage\n * on the web, MMKV or AsyncStorage on a phone).\n *\n * - SSR-safe: the server renders `initial`, and the client hydrates against it before reading\n * storage (useSyncExternalStore), so there's no hydration mismatch. A client-only render reads\n * storage directly, with no flash.\n * - In step: every hook on the same key, in this tab or another, sees a write.\n * - Never writes `initial`: a default stays a default, so changing it later reaches everyone who\n * hasn't chosen. `set(undefined)` clears the stored value back to the default.\n * - Forgiving: a stored value `parse` refuses falls back to `initial`, and a write storage won't\n * keep (quota, private mode, a no-op adapter) still applies for this hook's lifetime.\n * - Optional: a `null` key is plain state that isn't stored, for a component whose persistence\n * the caller turns on with a key prop.\n *\n * @stability Beta\n */\nimport { useCallback, useMemo, useRef, useState, useSyncExternalStore } from \"react\";\nimport { useStorage } from \"../provider/context\";\n\nexport interface PersistedUiStateOptions<T> {\n /**\n * Turns the stored string into a value; return `undefined` for one you don't accept, and the\n * hook falls back to `initial`. Default: `JSON.parse`, any value.\n */\n parse?: (raw: string) => T | undefined;\n /** Turns a value into the string stored. Default: `JSON.stringify`. */\n serialize?: (value: T) => string;\n}\n\n/** Same-tab subscribers by key: one hook's write reaches every other hook on that key. */\nconst listeners = new Map<string, Set<() => void>>();\n\nfunction notify(key: string): void {\n for (const listener of listeners.get(key) ?? []) listener();\n}\n\nconst jsonParse = <T,>(raw: string): T | undefined => {\n try {\n return JSON.parse(raw) as T;\n } catch {\n return undefined;\n }\n};\n\n/** The server has nothing stored: it renders, and the client hydrates against, `initial`. */\nconst serverSnapshot = (): null => null;\n\nexport function usePersistedUiState<T>(\n key: string | null,\n initial: T,\n options: PersistedUiStateOptions<T> = {},\n): [T, (next: T | undefined | ((current: T) => T | undefined)) => void] {\n const storage = useStorage();\n const { parse = jsonParse as (raw: string) => T | undefined, serialize = JSON.stringify as (value: T) => string } = options;\n\n const subscribe = useCallback(\n (onChange: () => void) => {\n if (key === null) return () => undefined;\n let set = listeners.get(key);\n if (!set) listeners.set(key, (set = new Set()));\n set.add(onChange);\n const onStorage = (event: StorageEvent) => {\n if (event.key === null || event.key === key) onChange();\n };\n if (typeof window !== \"undefined\") window.addEventListener(\"storage\", onStorage);\n return () => {\n set.delete(onChange);\n if (set.size === 0) listeners.delete(key);\n if (typeof window !== \"undefined\") window.removeEventListener(\"storage\", onStorage);\n };\n },\n [key],\n );\n const getSnapshot = useCallback(() => {\n if (key === null) return null;\n try {\n return storage.getItem(key);\n } catch {\n return null;\n }\n }, [storage, key]);\n const raw = useSyncExternalStore(subscribe, getSnapshot, serverSnapshot);\n\n // The parsed value changes only when the stored string does, so a consumer's effects on it\n // don't run on every render.\n const stored = useMemo(() => (raw === null ? undefined : parse(raw)), [raw, parse]);\n\n // A write storage didn't keep, held for this hook's lifetime and only for the key it was made\n // under: a new key reads its own stored value. `value: undefined` is \"cleared\".\n const [unsavedState, setUnsavedState] = useState<{ key: string | null; value: T | undefined } | undefined>(undefined);\n const unsaved = unsavedState && unsavedState.key === key ? unsavedState : undefined;\n const value = unsaved === undefined ? (stored === undefined ? initial : stored) : unsaved.value === undefined ? initial : unsaved.value;\n // The latest value, for a function update: two updates in one tick (before a re-render) each\n // build on the one before, as useState's do.\n const latest = useRef(value);\n latest.current = value;\n\n const set = useCallback(\n (next: T | undefined | ((current: T) => T | undefined)) => {\n const resolved = typeof next === \"function\" ? (next as (current: T) => T | undefined)(latest.current) : next;\n latest.current = resolved === undefined ? initial : resolved;\n let kept = false;\n if (key === null) {\n setUnsavedState({ key, value: resolved });\n return;\n }\n try {\n if (resolved === undefined) {\n storage.removeItem(key);\n kept = storage.getItem(key) === null;\n } else {\n const text = serialize(resolved);\n storage.setItem(key, text);\n kept = storage.getItem(key) === text;\n }\n } catch {\n kept = false;\n }\n setUnsavedState(kept ? undefined : { key, value: resolved });\n notify(key);\n },\n // `initial` only matters when a write clears the value; read through a ref, it would be\n // stale after a re-render with a new default, so it's a dependency like the rest.\n [storage, key, serialize, initial],\n );\n\n return [value, set];\n}\n"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/schema/write-outcome.ts"],"names":[],"mappings":";AA2DO,IAAM,cAAA,GAAN,cAA6B,KAAA,CAAM;AAAA,EAC/B,OAAA;AAAA,EACA,OAAA;AAAA,EACA,cAAA;AAAA;AAAA,EAEA,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAA;AAAA,EAET,WAAA,CAAY,OAAA,EAAuB,OAAA,EAAiB,OAAA,GAAiC,EAAC,EAAG;AACvF,IAAA,KAAA,CAAM,OAAA,EAAS,QAAQ,KAAA,KAAU,MAAA,GAAY,SAAY,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAO,CAAA;AACjF,IAAA,IAAA,CAAK,IAAA,GAAO,gBAAA;AACZ,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AACf,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,OAAA;AACvB,IAAA,IAAA,CAAK,iBAAiB,OAAA,CAAQ,cAAA;AAC9B,IAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,MAAA,EAAW,IAAA,CAAK,OAAO,OAAA,CAAQ,IAAA;AACpD,IAAA,IAAI,OAAA,CAAQ,UAAU,MAAA,CAAO,IAAA,CAAK,QAAQ,MAAM,CAAA,CAAE,SAAS,CAAA,EAAG;AAC5D,MAAA,IAAA,CAAK,SAAS,MAAA,CAAO,MAAA,CAAO,EAAE,GAAG,OAAA,CAAQ,QAAQ,CAAA;AAAA,IACnD;AAAA,EACF;AACF;AAMO,SAAS,iBAAiB,KAAA,EAAyC;AACxE,EAAA,OACE,iBAAiB,KAAA,IACjB,KAAA,CAAM,SAAS,gBAAA,IACf,OAAQ,MAAgC,OAAA,KAAY,QAAA;AAExD","file":"chunk-LG6TUBVM.js","sourcesContent":["// ---------------------------------------------------------------------------\n// Why a write did not save (DATA-STUDIO.md \"Write safety\")\n//\n// A write that changes nothing is never reported as \"permission denied\" by\n// assumption. The provider re-reads the row and says what actually happened.\n// ---------------------------------------------------------------------------\n\nimport type { DataRow } from \"./types\";\n\n/**\n * - `conflict`: someone else changed the row since it was read. `current`\n * carries the row as it is now.\n * - `gone`: the row was deleted, or is no longer visible to this user. The\n * two cannot be told apart without a privileged look at the table, which\n * would show this user a fact about a row they cannot see.\n * - `forbidden`: the row is visible and unchanged, but the app or the\n * database does not let this user make this change. Only reported when\n * that is proven, never assumed from \"zero rows changed\".\n * - `duplicate`: a row with the same unique key already exists (`23505`).\n * A caller keeping \"one live row per key\" (a draft, a natural-key upsert)\n * adopts the existing row instead; `fields` still names the clashing field.\n * - `invalid`: the store rejected the value (type, constraint, not-null).\n * - `audit_failed`: the audit entry could not be written, so the edit was\n * rolled back with it.\n * - `unauthenticated`: no signed-in user, or the session expired.\n * - `error`: anything else. The edit did not commit.\n */\nexport type WriteOutcome =\n | \"conflict\"\n | \"gone\"\n | \"forbidden\"\n | \"duplicate\"\n | \"invalid\"\n | \"audit_failed\"\n | \"unauthenticated\"\n | \"error\";\n\nexport interface DataWriteErrorOptions {\n /** The row as it is now, for a `conflict`. Only fields the user may read. */\n current?: DataRow;\n /** The row's current version token, for a `conflict`. */\n currentVersion?: string | null;\n /**\n * The store's own error code, when it gave one (a Postgres SQLSTATE such as\n * `23505`, or a PostgREST code such as `PGRST301`).\n */\n code?: string;\n /**\n * Per-field messages, keyed by field (column) name, for a write the store\n * rejected because of particular values. Each message is safe to show next\n * to its input: plain words, never the store's raw text or the value.\n * `useResourceForm` puts each one on its field.\n */\n fields?: Record<string, string>;\n /** The underlying error, kept for logging. */\n cause?: unknown;\n}\n\n/** Thrown by a provider when a write did not commit. */\nexport class DataWriteError extends Error {\n readonly outcome: WriteOutcome;\n readonly current?: DataRow;\n readonly currentVersion?: string | null;\n /** The store's own error code, when it gave one. */\n readonly code?: string;\n /**\n * Per-field messages (field name → safe message), when the store said which\n * values it rejected. See `DataWriteErrorOptions.fields`.\n */\n readonly fields?: Readonly<Record<string, string>>;\n\n constructor(outcome: WriteOutcome, message: string, options: DataWriteErrorOptions = {}) {\n super(message, options.cause === undefined ? undefined : { cause: options.cause });\n this.name = \"DataWriteError\";\n this.outcome = outcome;\n this.current = options.current;\n this.currentVersion = options.currentVersion;\n if (options.code !== undefined) this.code = options.code;\n if (options.fields && Object.keys(options.fields).length > 0) {\n this.fields = Object.freeze({ ...options.fields });\n }\n }\n}\n\n/**\n * `instanceof` fails when two copies of this package are installed, so check\n * the shape instead.\n */\nexport function isDataWriteError(error: unknown): error is DataWriteError {\n return (\n error instanceof Error &&\n error.name === \"DataWriteError\" &&\n typeof (error as { outcome?: unknown }).outcome === \"string\"\n );\n}\n"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/hooks/use-resource.ts"],"names":["keepPreviousData","keepPreviousPlaceholder","options"],"mappings":"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","file":"chunk-OC4OGB2K.js","sourcesContent":["import { useState, useCallback, useMemo } from \"react\";\nimport {\n keepPreviousData as keepPreviousPlaceholder,\n useQuery,\n useMutation,\n useQueryClient,\n type UseQueryResult,\n type UseMutationResult,\n} from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type {\n BaseRecord,\n Identifier,\n SortParam,\n FilterParam,\n ListParams,\n ListResult,\n InvalidationKey,\n WriteEvent,\n} from \"../provider/types\";\nimport { relatedKeys } from \"./related-keys\";\nimport {\n cachedRecord,\n executeWrite,\n invalidateResource,\n type MutationModeOptions,\n} from \"./mutation-mode\";\nimport { useLiveInvalidation, type LiveOptions } from \"./use-live\";\nimport { resourceKeys } from \"../query-keys\";\nimport { isDataWriteError } from \"../schema/write-outcome\";\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface UseResourceOptions<T> extends MutationModeOptions {\n defaultSort?: SortParam;\n /**\n * Re-synced whenever its value changes (deep-equal, order-independent),\n * not just its identity — safe to pass a scope/audience-derived array that\n * changes across renders. This only covers CHANGES on an already-mounted\n * hook, though: if this starts `undefined` while the real value resolves\n * asynchronously, gate `enabled` on that same readiness signal too — the\n * hook cannot tell \"no defaultFilters intended\" apart from \"not resolved\n * yet,\" so an ungated hook's very first fetch can still run unscoped.\n */\n defaultFilters?: FilterParam[];\n defaultPerPage?: number;\n /** The page to start on (from 1), e.g. restored from the URL. Default 1. */\n defaultPage?: number;\n /** The search to start with, e.g. restored from the URL. Default \"\". */\n defaultSearch?: string;\n /** Supabase select/join syntax, e.g. \"*, author:profiles(name)\". */\n select?: string;\n /** Fields to search across when setSearch is called. Required for server-side search. */\n searchFields?: string[];\n /** Disable auto-fetching. */\n enabled?: boolean;\n /**\n * Other query keys to invalidate after a create, update or delete, on top\n * of `[resource]` and the provider's own `invalidates` (e.g. `[[\"me\"]]`\n * when a write changes the signed-in user's roles).\n */\n invalidates?: InvalidationKey[];\n /**\n * While the next page / sort / search is loading, keep returning the\n * previous result (`list.isPlaceholderData` is true meanwhile) instead of\n * dropping to `undefined`. A paged list then stays on screen between pages\n * rather than flashing a skeleton. Default false.\n */\n keepPreviousData?: boolean;\n /**\n * Keep the list current while mounted: subscribe to the provider's change\n * events (`DataProvider.subscribe`) and refetch this resource's cached\n * reads (lists and records) when it reports one, once per burst of\n * events. Events are hints: rows always come from the provider's normal\n * read. Pending optimistic and undoable writes stay applied over the\n * refetch. Needs a provider that serves `subscribe` for the resource\n * (`capabilities(resource).realtime`); otherwise it does nothing. Off by\n * default.\n */\n live?: boolean | LiveOptions;\n /**\n * After the write commits, with the provider's row. In `optimistic` and\n * `undoable` modes that is after `create` / `update` / `remove` have\n * already resolved.\n */\n onCreateSuccess?: (data: T) => void;\n onUpdateSuccess?: (data: T) => void;\n onDeleteSuccess?: () => void;\n /**\n * A write failed. In `optimistic` and `undoable` modes this is the only\n * place a failure is reported (the cache has already been put back), so\n * show it to the user here.\n */\n onError?: (error: Error) => void;\n}\n\n/** What `update` can take beside the change. */\nexport interface UpdateOptions {\n /**\n * Check the write against this version instead of the cached row's: \"keep mine\" after a\n * conflict, at the version the conflict reported (`WriteConflict.currentVersion`). A version\n * already chained for the row wins over it: a write sent while an earlier write of the same row\n * is still in flight is checked against the version that one commits (as\n * `ExecuteWriteArgs.expectedVersion`). The write\n * still goes through the resource's write path (queued behind any other write of the row, its\n * committed version recorded), so a move made right after it is checked against it.\n */\n expectedVersion?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Return type\n// ---------------------------------------------------------------------------\n\nexport interface UseResourceReturn<T> {\n /** TanStack Query result for the list query. */\n list: UseQueryResult<ListResult<T>>;\n /** Current list params (pagination, sort, filters, search). */\n params: ListParams;\n setSort: (sort: SortParam | undefined) => void;\n setFilters: (filters: FilterParam[]) => void;\n setPage: (page: number) => void;\n setPerPage: (perPage: number) => void;\n setSearch: (query: string) => void;\n /**\n * Create a new record. Returns the created item. In `optimistic` and\n * `undoable` modes it resolves at once with the values given (no `id` yet;\n * `onCreateSuccess` gets the stored row).\n */\n create: (data: Partial<T>) => Promise<T>;\n /**\n * Update an existing record by id. Returns the updated item. In\n * `optimistic` and `undoable` modes it resolves at once with the cached\n * row merged with `data`.\n */\n update: (id: Identifier, data: Partial<T>, options?: UpdateOptions) => Promise<T>;\n /** Delete a record by id. Resolves at once in `optimistic` / `undoable` modes. */\n remove: (id: Identifier) => Promise<void>;\n /** True when any mutation is in-flight. */\n isMutating: boolean;\n createMutation: UseMutationResult<T, Error, Partial<T>>;\n updateMutation: UseMutationResult<T, Error, { id: Identifier; data: Partial<T>; options?: UpdateOptions }>;\n deleteMutation: UseMutationResult<void, Error, Identifier>;\n}\n\n// ---------------------------------------------------------------------------\n// Filter identity — a deep-equality key independent of object-key order, so\n// a caller that rebuilds the same logical filters via a differently-ordered\n// spread (e.g. `{...base, operator: \"eq\"}` vs `{operator: \"eq\", ...base}`)\n// doesn't trip a spurious resync + pagination reset on an unrelated rerender.\n// ---------------------------------------------------------------------------\n\nfunction stableFilterKey(filters: FilterParam[] | undefined): string | undefined {\n if (!filters) return undefined;\n return JSON.stringify(\n filters.map((f) => {\n const sorted: Record<string, unknown> = {};\n for (const key of Object.keys(f).sort()) {\n sorted[key] = (f as unknown as Record<string, unknown>)[key];\n }\n return sorted;\n }),\n );\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useResource<T extends BaseRecord = BaseRecord>(\n resource: string,\n options: UseResourceOptions<T> = {},\n): UseResourceReturn<T> {\n const {\n defaultSort,\n defaultFilters,\n defaultPerPage = 25,\n defaultPage = 1,\n defaultSearch = \"\",\n select,\n searchFields: searchFieldsOption,\n enabled = true,\n invalidates,\n keepPreviousData = false,\n live,\n onCreateSuccess,\n onUpdateSuccess,\n onDeleteSuccess,\n onError,\n mutationMode = \"pessimistic\",\n undoDelayMs,\n onUndoable,\n } = options;\n\n const provider = useDataProvider();\n const queryClient = useQueryClient();\n\n // -------------------------------------------------------------------------\n // State\n // -------------------------------------------------------------------------\n\n const [sort, setSortRaw] = useState<SortParam | undefined>(defaultSort);\n const [filters, setFiltersRaw] = useState<FilterParam[]>(defaultFilters ?? []);\n const [page, setPage] = useState(Math.max(1, Math.floor(defaultPage)));\n const [perPage, setPerPageRaw] = useState(defaultPerPage);\n const [searchQuery, setSearchQuery] = useState(defaultSearch);\n\n // `defaultFilters` often resolves asynchronously — a caller's scope/audience\n // (team, project, ...) can still be loading on first render, so the array\n // it passes in changes value (not just identity) after mount, and may later\n // clear back to undefined (e.g. the scope itself is cleared). Re-syncing\n // here, during render rather than in an effect, means `filters` is already\n // correct by the time `params`/`list` below compute for this pass — no\n // stray unscoped fetch on the frame before an effect would have caught up.\n //\n // This only closes the gap for `defaultFilters` CHANGING across renders on\n // an already-mounted, already-enabled hook (e.g. a scope switch). It cannot\n // help the very first render: `filters` still seeds from whatever\n // `defaultFilters` is on mount, and `undefined` here is genuinely ambiguous\n // between \"this caller never uses defaultFilters\" (in which case forcing a\n // fetch to wait would break it forever) and \"the real value hasn't resolved\n // yet.\" A caller in the second case MUST also gate `enabled` on that same\n // readiness signal for its very first fetch to be correctly scoped — this\n // hook has no way to tell the two cases apart on its own.\n const defaultFiltersKey = stableFilterKey(defaultFilters);\n const [syncedFiltersKey, setSyncedFiltersKey] = useState(defaultFiltersKey);\n if (defaultFiltersKey !== syncedFiltersKey) {\n setSyncedFiltersKey(defaultFiltersKey);\n setFiltersRaw(defaultFilters ?? []);\n setPage(1);\n }\n\n const setSort = useCallback((s: SortParam | undefined) => {\n setSortRaw(s);\n setPage(1);\n }, []);\n\n const setFilters = useCallback((f: FilterParam[]) => {\n setFiltersRaw(f);\n setPage(1);\n }, []);\n\n const setPerPage = useCallback((value: number) => {\n setPerPageRaw(value);\n setPage(1);\n }, []);\n\n const setSearch = useCallback((query: string) => {\n setSearchQuery(query);\n setPage(1);\n }, []);\n\n // -------------------------------------------------------------------------\n // Params\n // -------------------------------------------------------------------------\n\n const params = useMemo<ListParams>(() => {\n const p: ListParams = {\n pagination: { page, perPage },\n sort,\n filters: filters.length > 0 ? filters : undefined,\n select,\n };\n if (searchQuery && searchFieldsOption && searchFieldsOption.length > 0) {\n p.search = { query: searchQuery, fields: searchFieldsOption };\n }\n return p;\n }, [page, perPage, sort, filters, select, searchQuery, searchFieldsOption]);\n\n // -------------------------------------------------------------------------\n // List query\n // -------------------------------------------------------------------------\n\n const listQueryKey = useMemo(\n () => resourceKeys(resource).list(params),\n [resource, params],\n );\n\n const list = useQuery<ListResult<T>>({\n queryKey: listQueryKey,\n queryFn: () => provider.getList<T>(resource, params),\n enabled,\n placeholderData: keepPreviousData ? keepPreviousPlaceholder : undefined,\n });\n\n // Every cached read of the resource: its lists, and the records a peek or\n // detail page shows from it.\n useLiveInvalidation(resource, live, enabled, { filters: params.filters }, [resource]);\n\n // -------------------------------------------------------------------------\n // Mutations\n // -------------------------------------------------------------------------\n\n const invalidateAfter = useCallback(\n (event: WriteEvent) => {\n // Pending optimistic/undoable patches are re-applied to the refetch.\n void invalidateResource(queryClient, resource);\n for (const queryKey of relatedKeys(provider, event, invalidates)) {\n void queryClient.invalidateQueries({ queryKey: [...queryKey] });\n }\n },\n [queryClient, resource, provider, invalidates],\n );\n\n const defaultOnError = useCallback(\n (error: Error) => {\n // A conflict is an outcome the caller shows (a conflict sheet), not a failure to log.\n if (isDataWriteError(error) && error.outcome === \"conflict\" && error.current) return;\n console.error(`[useResource] ${resource} mutation failed:`, error.message);\n },\n [resource],\n );\n const reportError = onError ?? defaultOnError;\n\n const modeArgs = {\n queryClient,\n provider,\n resource,\n mode: mutationMode,\n undoDelayMs,\n onUndoable,\n failedLater: reportError,\n };\n\n const createMutation = useMutation<T, Error, Partial<T>>({\n mutationFn: async (data) => {\n const outcome = await executeWrite<T>({\n ...modeArgs,\n kind: \"create\",\n data: data as Record<string, unknown>,\n send: async ({ keepalive }) => {\n const result = await provider.create<T>(resource, { data, ...(keepalive ? { keepalive } : {}) });\n return { record: result.data, audit: result.audit };\n },\n committed: (record) => {\n invalidateAfter({ resource, kind: \"create\", id: record.id, record });\n onCreateSuccess?.(record);\n },\n });\n return outcome.status === \"committed\" ? outcome.record : (data as T);\n },\n onError: reportError,\n });\n\n const updateMutation = useMutation<\n T,\n Error,\n { id: Identifier; data: Partial<T>; options?: UpdateOptions }\n >({\n mutationFn: async ({ id, data, options }) => {\n const before = cachedRecord(queryClient, resource, id);\n const outcome = await executeWrite<T>({\n ...modeArgs,\n kind: \"update\",\n id,\n data: data as Record<string, unknown>,\n ...(options?.expectedVersion !== undefined ? { expectedVersion: options.expectedVersion } : {}),\n send: async (ctx) => {\n const result = await provider.update<T>(resource, {\n id,\n data: (ctx.data ?? data) as Partial<T>,\n ...(ctx.keepalive ? { keepalive: true } : {}),\n ...(ctx.expectedVersion !== undefined ? { expectedVersion: ctx.expectedVersion } : {}),\n });\n return { record: result.data, audit: result.audit };\n },\n committed: (record) => {\n invalidateAfter({ resource, kind: \"update\", id, record });\n onUpdateSuccess?.(record);\n },\n });\n return outcome.status === \"committed\"\n ? outcome.record\n : ({ ...(before ?? {}), ...data, id: before?.id ?? id } as T);\n },\n onError: reportError,\n });\n\n const deleteMutation = useMutation<void, Error, Identifier>({\n mutationFn: async (id) => {\n await executeWrite<void>({\n ...modeArgs,\n kind: \"delete\",\n id,\n send: async ({ keepalive, expectedVersion }) => {\n const result = await provider.deleteOne(resource, {\n id,\n ...(keepalive ? { keepalive } : {}),\n ...(expectedVersion !== undefined ? { expectedVersion } : {}),\n });\n return { record: undefined, audit: result?.audit };\n },\n committed: () => {\n invalidateAfter({ resource, kind: \"delete\", id });\n onDeleteSuccess?.();\n },\n });\n },\n onError: reportError,\n });\n\n // -------------------------------------------------------------------------\n // Convenience wrappers\n // -------------------------------------------------------------------------\n\n const create = useCallback(\n (data: Partial<T>) => createMutation.mutateAsync(data),\n [createMutation],\n );\n\n const update = useCallback(\n (id: Identifier, data: Partial<T>, options?: UpdateOptions) =>\n updateMutation.mutateAsync(options ? { id, data, options } : { id, data }),\n [updateMutation],\n );\n\n const remove = useCallback(\n (id: Identifier) => deleteMutation.mutateAsync(id),\n [deleteMutation],\n );\n\n const isMutating =\n createMutation.isPending ||\n updateMutation.isPending ||\n deleteMutation.isPending;\n\n return {\n list,\n params,\n setSort,\n setFilters,\n setPage,\n setPerPage,\n setSearch,\n create,\n update,\n remove,\n isMutating,\n createMutation,\n updateMutation,\n deleteMutation,\n };\n}\n"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/provider/mock-provider.ts","../src/provider/context.tsx"],"names":[],"mappings":";;;;;;AAiBO,SAAS,kBAAA,CACd,QAAA,EACA,OAAA,GAA+B,EAAC,EAClB;AACd,EAAA,MAAM,EAAE,KAAA,GAAQ,CAAA,EAAE,GAAI,OAAA;AAGtB,EAAA,MAAM,QAA+B,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAC,CAAA;AAGxE,EAAA,IAAI,MAAA,GAAS,CAAA;AAMb,EAAA,SAAS,SAAS,QAAA,EAAyB;AACzC,IAAA,IAAI,CAAC,KAAA,CAAM,QAAQ,CAAA,EAAG;AACpB,MAAA,KAAA,CAAM,QAAQ,IAAI,EAAC;AAAA,IACrB;AACA,IAAA,OAAO,MAAM,QAAQ,CAAA;AAAA,EACvB;AAEA,EAAA,eAAe,UAAa,KAAA,EAAsB;AAChD,IAAA,IAAI,QAAQ,CAAA,EAAG;AACb,MAAA,MAAM,IAAI,OAAA,CAAQ,CAAC,MAAM,UAAA,CAAW,CAAA,EAAG,KAAK,CAAC,CAAA;AAAA,IAC/C;AACA,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,SAAS,aAAA,CAAc,KAAU,MAAA,EAA8B;AAC7D,IAAA,MAAM,GAAA,GAAM,GAAA,CAAI,MAAA,CAAO,KAAK,CAAA;AAE5B,IAAA,QAAQ,OAAO,QAAA;AAAU,MACvB,KAAK,IAAA;AACH,QAAA,OAAO,QAAQ,MAAA,CAAO,KAAA;AAAA,MACxB,KAAK,KAAA;AACH,QAAA,OAAO,QAAQ,MAAA,CAAO,KAAA;AAAA,MACxB,KAAK,IAAA;AACH,QAAA,OAAQ,MAAkB,MAAA,CAAO,KAAA;AAAA,MACnC,KAAK,IAAA;AACH,QAAA,OAAQ,MAAkB,MAAA,CAAO,KAAA;AAAA,MACnC,KAAK,KAAA;AACH,QAAA,OAAQ,OAAmB,MAAA,CAAO,KAAA;AAAA,MACpC,KAAK,KAAA;AACH,QAAA,OAAQ,OAAmB,MAAA,CAAO,KAAA;AAAA,MACpC,KAAK,UAAA;AACH,QAAA,OAAO,OAAO,GAAA,KAAQ,QAAA,IACpB,GAAA,CAAI,WAAA,EAAY,CAAE,QAAA,CAAS,MAAA,CAAO,MAAA,CAAO,KAAK,CAAA,CAAE,WAAA,EAAa,CAAA;AAAA,MACjE,KAAK,IAAA;AACH,QAAA,OAAO,MAAA,CAAO,KAAA,CAAM,QAAA,CAAS,GAAgC,CAAA;AAAA,MAC/D,KAAK,SAAA;AACH,QAAA,OAAO,GAAA,KAAQ,QAAQ,GAAA,KAAQ,MAAA;AAAA,MACjC,KAAK,aAAA;AACH,QAAA,OAAO,GAAA,KAAQ,QAAQ,GAAA,KAAQ,MAAA;AAAA,MACjC,KAAK,SAAA,EAAW;AACd,QAAA,MAAM,CAAC,EAAA,EAAI,EAAE,CAAA,GAAI,MAAA,CAAO,KAAA;AACxB,QAAA,OAAQ,GAAA,IAAmB,MAAkB,GAAA,IAAmB,EAAA;AAAA,MAClE;AAAA;AACF,EACF;AAEA,EAAA,SAAS,aAAA,CACP,KACA,MAAA,EACS;AACT,IAAA,MAAM,CAAA,GAAI,MAAA,CAAO,KAAA,CAAM,WAAA,EAAY;AACnC,IAAA,OAAO,MAAA,CAAO,MAAA,CAAO,IAAA,CAAK,CAAC,KAAA,KAAU;AACnC,MAAA,MAAM,GAAA,GAAM,IAAI,KAAK,CAAA;AACrB,MAAA,OAAO,OAAO,GAAA,KAAQ,QAAA,IAAY,IAAI,WAAA,EAAY,CAAE,SAAS,CAAC,CAAA;AAAA,IAChE,CAAC,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,aAAA,CAAc,GAAY,CAAA,EAAoB;AACrD,IAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,OAAO,MAAM,QAAA,EAAU;AAClD,MAAA,OAAO,EAAE,aAAA,CAAc,CAAA,EAAG,QAAW,EAAE,OAAA,EAAS,MAAM,CAAA;AAAA,IACxD;AACA,IAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,OAAO,MAAM,QAAA,EAAU;AAClD,MAAA,OAAO,CAAA,GAAI,CAAA;AAAA,IACb;AAEA,IAAA,OAAO,MAAA,CAAO,KAAK,EAAE,CAAA,CAAE,cAAc,MAAA,CAAO,CAAA,IAAK,EAAE,CAAA,EAAG,MAAA,EAAW;AAAA,MAC/D,OAAA,EAAS;AAAA,KACV,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,eAAA,CAAgB,OAAc,MAAA,EAAoD;AACzF,IAAA,IAAI,IAAA,GAAO,CAAC,GAAG,KAAK,CAAA;AAGpB,IAAA,IAAI,OAAO,OAAA,EAAS;AAClB,MAAA,KAAA,MAAW,CAAA,IAAK,OAAO,OAAA,EAAS;AAC9B,QAAA,IAAA,GAAO,KAAK,MAAA,CAAO,CAAC,MAAM,aAAA,CAAc,CAAA,EAAG,CAAC,CAAC,CAAA;AAAA,MAC/C;AAAA,IACF;AAGA,IAAA,IAAI,MAAA,CAAO,MAAA,IAAU,MAAA,CAAO,MAAA,CAAO,KAAA,EAAO;AACxC,MAAA,IAAA,GAAO,IAAA,CAAK,OAAO,CAAC,CAAA,KAAM,cAAc,CAAA,EAAG,MAAA,CAAO,MAAO,CAAC,CAAA;AAAA,IAC5D;AAEA,IAAA,MAAM,QAAQ,IAAA,CAAK,MAAA;AAInB,IAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,IAAS,MAAA,CAAO,MAAM,MAAA,GAAS,CAAA,GAAI,MAAA,CAAO,KAAA,GAAQ,OAAO,IAAA,GAAO,CAAC,MAAA,CAAO,IAAI,IAAI,EAAC;AACtG,IAAA,IAAI,KAAA,CAAM,SAAS,CAAA,EAAG;AACpB,MAAA,IAAA,CAAK,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM;AAClB,QAAA,KAAA,MAAW,EAAE,KAAA,EAAO,KAAA,EAAM,IAAK,KAAA,EAAO;AACpC,UAAA,MAAM,MAAM,aAAA,CAAc,CAAA,CAAE,KAAK,CAAA,EAAG,CAAA,CAAE,KAAK,CAAC,CAAA;AAC5C,UAAA,IAAI,QAAQ,CAAA,EAAG,OAAO,KAAA,KAAU,MAAA,GAAS,CAAC,GAAA,GAAM,GAAA;AAAA,QAClD;AACA,QAAA,OAAO,CAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AAGA,IAAA,IAAI,OAAO,UAAA,EAAY;AACrB,MAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAQ,GAAI,MAAA,CAAO,UAAA;AACjC,MAAA,MAAM,KAAA,GAAA,CAAS,OAAO,CAAA,IAAK,OAAA;AAC3B,MAAA,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,KAAA,EAAO,KAAA,GAAQ,OAAO,CAAA;AAAA,IAC1C;AAEA,IAAA,OAAO,EAAE,IAAA,EAAM,IAAA,EAAM,KAAA,EAAM;AAAA,EAC7B;AAMA,EAAA,MAAM,QAAA,GAAyB;AAAA,IAC7B,MAAM,OAAA,CAAQ,SAAA,EAAW,MAAA,EAAQ;AAC/B,MAAA,MAAM,KAAA,GAAQ,SAAS,SAAS,CAAA;AAChC,MAAA,MAAM,MAAA,GAAS,eAAA,CAAgB,KAAA,EAAO,MAAM,CAAA;AAC5C,MAAA,OAAO,UAAU,MAAM,CAAA;AAAA,IACzB,CAAA;AAAA,IAEA,MAAM,MAAA,CAAO,SAAA,EAAW,MAAA,EAAQ;AAC9B,MAAA,MAAM,KAAA,GAAQ,SAAS,SAAS,CAAA;AAChC,MAAA,MAAM,GAAA,GAAM,KAAA,CAAM,IAAA,CAAK,CAAC,CAAA,KAAM,MAAA,CAAO,CAAA,CAAE,EAAE,CAAA,KAAM,MAAA,CAAO,MAAA,CAAO,EAAE,CAAC,CAAA;AAChE,MAAA,IAAI,CAAC,GAAA,EAAK;AACR,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAA,iCAAA,EAAoC,SAAS,CAAA,CAAA,EAAI,MAAA,CAAO,EAAE,CAAA;AAAA,SAC5D;AAAA,MACF;AACA,MAAA,OAAO,SAAA,CAAU,EAAE,IAAA,EAAM,IAAA,CAAK,KAAA,CAAM,KAAK,SAAA,CAAU,GAAG,CAAC,CAAA,EAAG,CAAA;AAAA,IAC5D,CAAA;AAAA,IAEA,MAAM,OAAA,CAAQ,SAAA,EAAW,MAAA,EAAQ;AAC/B,MAAA,MAAM,KAAA,GAAQ,SAAS,SAAS,CAAA;AAChC,MAAA,MAAM,QAAQ,IAAI,GAAA,CAAI,OAAO,GAAA,CAAI,GAAA,CAAI,MAAM,CAAC,CAAA;AAC5C,MAAA,MAAM,IAAA,GAAO,KAAA,CAAM,MAAA,CAAO,CAAC,CAAA,KAAM,KAAA,CAAM,GAAA,CAAI,MAAA,CAAO,CAAA,CAAE,EAAE,CAAC,CAAC,CAAA;AACxD,MAAA,OAAO,SAAA,CAAU,EAAE,IAAA,EAAM,IAAA,CAAK,KAAA,CAAM,KAAK,SAAA,CAAU,IAAI,CAAC,CAAA,EAAG,CAAA;AAAA,IAC7D,CAAA;AAAA,IAEA,MAAM,MAAA,CAAO,SAAA,EAAW,MAAA,EAAQ;AAC9B,MAAA,MAAM,KAAA,GAAQ,SAAS,SAAS,CAAA;AAChC,MAAA,MAAM,EAAA,GAAK,OAAO,MAAA,EAAQ,CAAA;AAC1B,MAAA,MAAM,GAAA,GAAM,EAAE,EAAA,EAAI,GAAG,OAAO,IAAA,EAAK;AACjC,MAAA,KAAA,CAAM,KAAK,GAAG,CAAA;AACd,MAAA,OAAO,SAAA,CAAU,EAAE,IAAA,EAAM,IAAA,CAAK,KAAA,CAAM,KAAK,SAAA,CAAU,GAAG,CAAC,CAAA,EAAG,CAAA;AAAA,IAC5D,CAAA;AAAA,IAEA,MAAM,MAAA,CAAO,SAAA,EAAW,MAAA,EAAQ;AAC9B,MAAA,MAAM,KAAA,GAAQ,SAAS,SAAS,CAAA;AAChC,MAAA,MAAM,GAAA,GAAM,KAAA,CAAM,SAAA,CAAU,CAAC,CAAA,KAAM,MAAA,CAAO,CAAA,CAAE,EAAE,CAAA,KAAM,MAAA,CAAO,MAAA,CAAO,EAAE,CAAC,CAAA;AACrE,MAAA,IAAI,QAAQ,EAAA,EAAI;AACd,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAA,iCAAA,EAAoC,SAAS,CAAA,CAAA,EAAI,MAAA,CAAO,EAAE,CAAA;AAAA,SAC5D;AAAA,MACF;AACA,MAAA,KAAA,CAAM,GAAG,IAAI,EAAE,GAAG,MAAM,GAAG,CAAA,EAAG,GAAG,MAAA,CAAO,IAAA,EAAK;AAC7C,MAAA,OAAO,SAAA,CAAU,EAAE,IAAA,EAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM,GAAG,CAAC,CAAC,CAAA,EAAG,CAAA;AAAA,IACnE,CAAA;AAAA,IAEA,MAAM,SAAA,CAAU,SAAA,EAAW,MAAA,EAAQ;AACjC,MAAA,MAAM,KAAA,GAAQ,SAAS,SAAS,CAAA;AAChC,MAAA,MAAM,GAAA,GAAM,KAAA,CAAM,SAAA,CAAU,CAAC,CAAA,KAAM,MAAA,CAAO,CAAA,CAAE,EAAE,CAAA,KAAM,MAAA,CAAO,MAAA,CAAO,EAAE,CAAC,CAAA;AACrE,MAAA,IAAI,QAAQ,EAAA,EAAI;AACd,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAA,iCAAA,EAAoC,SAAS,CAAA,CAAA,EAAI,MAAA,CAAO,EAAE,CAAA;AAAA,SAC5D;AAAA,MACF;AACA,MAAA,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AACnB,MAAA,OAAO,SAAA,CAAU,EAAE,IAAA,EAAM,EAAE,IAAI,MAAA,CAAO,EAAA,IAAM,CAAA;AAAA,IAC9C;AAAA,GACF;AAEA,EAAA,OAAO,QAAA;AACT;AC1LA,IAAM,mBAAA,GAAsB,cAAmC,IAAI,CAAA;AACnE,IAAM,cAAA,GAAiB,aAAA,CAA8B,yBAAA,EAA2B,CAAA;AAkBzE,SAAS,gBAAA,CAAiB,EAAE,QAAA,EAAU,QAAA,EAAS,EAA0B;AAC9E,EAAA,2BACG,mBAAA,CAAoB,QAAA,EAApB,EAA6B,KAAA,EAAO,UAClC,QAAA,EACH,CAAA;AAEJ;AAMO,SAAS,eAAA,GAAgC;AAC9C,EAAA,MAAM,GAAA,GAAM,WAAW,mBAAmB,CAAA;AAC1C,EAAA,IAAI,CAAC,GAAA,EAAK;AACR,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,GAAA;AACT;AAEO,SAAS,UAAA,GAA6B;AAC3C,EAAA,OAAO,WAAW,cAAc,CAAA;AAClC;AAgEA,IAAM,iBAAiB,yBAAA,EAA0B;AAQ1C,SAAS,eAAA,CAAgB;AAAA,EAC9B,QAAA;AAAA,EACA,QAAA;AAAA,EACA,IAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA,EAAa,eAAA;AAAA,EACb,OAAA;AAAA,EACA;AACF,CAAA,EAAyB;AACvB,EAAA,IAAI,YAAY,IAAA,EAAM;AACpB,IAAA,IAAI,OAAA,CAAQ,GAAA,CAAI,QAAA,KAAa,YAAA,EAAc;AACzC,MAAA,OAAA,CAAQ,KAAK,kHAAkH,CAAA;AAAA,IACjI;AAAA,EACF;AAGA,EAAA,MAAM,gBAAA,GAAmB,QAAQ,MAAM;AACrC,IAAA,IAAI,UAAU,OAAO,QAAA;AACrB,IAAA,IAAI,MAAM,OAAO,kBAAA,CAAmB,IAAA,CAAK,QAAA,EAAU,KAAK,OAAO,CAAA;AAC/D,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF,CAAA,EAAG,CAAC,QAAA,EAAU,IAAI,CAAC,CAAA;AAGnB,EAAA,MAAM,WAAA,GAAc,OAAA;AAAA,IAClB,MACE,eAAA,IACA,IAAI,WAAA,CAAY;AAAA,MACd,cAAA,EAAgB;AAAA,QACd,OAAA,EAAS;AAAA,UACP,SAAA,EAAW,IAAI,EAAA,GAAK;AAAA;AAAA;AACtB;AACF,KACD,CAAA;AAAA,IACH,CAAC,eAAe;AAAA,GAClB;AAEA,EAAA,MAAM,kBAAkB,OAAA,IAAW,cAAA;AACnC,EAAA,MAAM,QAAA,GAAW,gBAAA,CAAiB,WAAA,EAAa,OAAA,EAAS,YAAY,CAAA;AAEpE,EAAA,uBACE,GAAA,CAAC,mBAAA,EAAA,EAAoB,MAAA,EAAQ,WAAA,EAC3B,8BAAC,cAAA,CAAe,QAAA,EAAf,EAAwB,KAAA,EAAO,eAAA,EAC9B,QAAA,kBAAA,GAAA,CAAC,gBAAA,EAAA,EAAiB,QAAA,EAAU,kBAC1B,QAAA,kBAAA,GAAA,CAAC,sBAAA,CAAuB,QAAA,EAAvB,EAAgC,KAAA,EAAO,OAAA,IAAW,OAAO,YAAA,KAAiB,WAAW,MAAA,CAAO,YAAY,CAAA,GAAI,MAAA,EAC1G,QAAA,EAAA,QAAA,GAAW,QAAA,GAAW,IAAA,EACzB,CAAA,EACF,GACF,CAAA,EACF,CAAA;AAEJ;AAGA,IAAM,eAAA,GAAkB,GAAA;AAGxB,IAAM,MAAA,GAAS,CAAC,KAAA,KAAmB,KAAA,CAAM,WAAW,IAAI,CAAA,GAAI,MAAM,KAAA,CAAM,CAAA,EAAG,MAAM,OAAA,CAAQ,GAAG,IAAI,CAAA,GAAI,MAAA,GAAY,MAAM,OAAA,CAAQ,GAAG,CAAC,CAAA,GAAI,KAAA;AAQtI,SAAS,gBAAA,CACP,WAAA,EACA,OAAA,EACA,KAAA,EACS;AAGT,EAAA,MAAM,UAAA,GAAa,OAAO,OAAO,CAAA;AACjC,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,MAAO,UAAA,CAAW,OAAA,GAAU,UAAA,CAAW,OAAA,CAAQ,WAAW,CAAA,GAAI,IAAA,EAAO,CAAC,WAAW,CAAC,CAAA;AAC9G,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,QAAA,CAAS,CAAC,WAAA,IAAe,CAAC,KAAA,IAAS,OAAO,MAAA,KAAW,WAAW,CAAA;AAE1F,EAAA,MAAM,MAAA,GAAS,OAAsB,IAAI,CAAA;AACzC,EAAA,MAAM,QAAA,GAAW,MAAA,CAAsB,OAAA,CAAQ,OAAA,EAAS,CAAA;AAKxD,EAAA,MAAM,QAAA,GAAW,OAAkC,MAAS,CAAA;AAC5D,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,OAAO,QAAA,CAAS,OAAA;AACtB,IAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AACnB,IAAA,IAAI,CAAC,WAAA,IAAe,KAAA,KAAU,MAAA,EAAW;AAEvC,MAAA,QAAA,CAAS,IAAI,CAAA;AACb,MAAA;AAAA,IACF;AACA,IAAA,IAAI,UAAU,IAAA,EAAM;AAElB,MAAA,MAAA,CAAO,OAAA,GAAU,IAAA;AACjB,MAAA,QAAA,CAAS,UAAU,WAAA,CAAY,OAAA,CAAQ,EAAE,CAAA,CAAE,KAAA,CAAM,MAAM,MAAS,CAAA;AAChE,MAAA,QAAA,CAAS,IAAI,CAAA;AACb,MAAA;AAAA,IACF;AACA,IAAA,MAAM,IAAA,GAAO,OAAO,KAAK,CAAA;AACzB,IAAA,IAAI,MAAA,CAAO,OAAA,KAAY,IAAA,IAAQ,MAAA,CAAO,YAAY,IAAA,EAAM;AACtD,MAAA,QAAA,CAAS,UAAU,WAAA,CAAY,KAAA,EAAM,CAAE,KAAA,CAAM,MAAM,MAAS,CAAA;AAAA,IAC9D;AACA,IAAA,MAAA,CAAO,OAAA,GAAU,IAAA;AACjB,IAAA,MAAM,KAAA,GAAQ,IAAI,eAAA,EAAgB;AAGlC,IAAA,MAAM,IAAA,GAAO,YAAY,SAAA,CAAU,KAAA,EAAO,EAAE,OAAA,EAAS,IAAA,KAAS,QAAW,CAAA;AACzE,IAAA,MAAM,OAAO,MAAM;AACjB,MAAA,IAAI,CAAC,KAAA,CAAM,MAAA,CAAO,OAAA,WAAkB,IAAI,CAAA;AAAA,IAC1C,CAAA;AACA,IAAA,MAAM,IAAA,GAAO,UAAA,CAAW,IAAA,EAAM,eAAe,CAAA;AAC7C,IAAA,KAAK,QAAA,CAAS,QACX,IAAA,CAAK,MAAO,MAAM,MAAA,CAAO,OAAA,GAAU,SAAY,WAAA,CAAY,OAAA,CAAQ,OAAO,KAAA,CAAM,MAAM,CAAE,CAAA,CACxF,KAAA,CAAM,MAAM,MAAS,CAAA,CACrB,QAAQ,MAAM;AACb,MAAA,YAAA,CAAa,IAAI,CAAA;AACjB,MAAA,IAAA,EAAK;AAAA,IACP,CAAC,CAAA;AACH,IAAA,OAAO,MAAM;AACX,MAAA,KAAA,CAAM,KAAA,EAAM;AACZ,MAAA,YAAA,CAAa,IAAI,CAAA;AACjB,MAAA,IAAA,EAAK;AAAA,IACP,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,WAAA,EAAa,KAAK,CAAC,CAAA;AACvB,EAAA,OAAO,KAAA;AACT;AAMO,IAAM,sBAAA,GAAyB,cAAkC,MAAS","file":"chunk-PSFKIG27.js","sourcesContent":["import type {\n DataProvider,\n ListParams,\n FilterParam,\n} from \"./types\";\n\n// ---------------------------------------------------------------------------\n// Mock DataProvider — operates on in-memory arrays, deep-cloned on creation\n// ---------------------------------------------------------------------------\n\nexport interface MockProviderOptions {\n /** Simulated latency in ms (default 0). */\n delay?: number;\n}\n\ntype Row = Record<string, unknown>;\n\nexport function createMockProvider(\n datasets: Record<string, Row[]>,\n options: MockProviderOptions = {},\n): DataProvider {\n const { delay = 0 } = options;\n\n // Deep clone so mutations don't affect the original data.\n const store: Record<string, Row[]> = JSON.parse(JSON.stringify(datasets));\n\n // Instance-scoped ID counter (NOT module-level).\n let nextId = 1;\n\n // ---------------------------------------------------------------------------\n // Helpers\n // ---------------------------------------------------------------------------\n\n function getTable(resource: string): Row[] {\n if (!store[resource]) {\n store[resource] = [];\n }\n return store[resource];\n }\n\n async function withDelay<T>(value: T): Promise<T> {\n if (delay > 0) {\n await new Promise((r) => setTimeout(r, delay));\n }\n return value;\n }\n\n function matchesFilter(row: Row, filter: FilterParam): boolean {\n const val = row[filter.field];\n\n switch (filter.operator) {\n case \"eq\":\n return val === filter.value;\n case \"neq\":\n return val !== filter.value;\n case \"gt\":\n return (val as number) > (filter.value as number);\n case \"lt\":\n return (val as number) < (filter.value as number);\n case \"gte\":\n return (val as number) >= (filter.value as number);\n case \"lte\":\n return (val as number) <= (filter.value as number);\n case \"contains\":\n return typeof val === \"string\" &&\n val.toLowerCase().includes(String(filter.value).toLowerCase());\n case \"in\":\n return filter.value.includes(val as string | number | boolean);\n case \"is_null\":\n return val === null || val === undefined;\n case \"is_not_null\":\n return val !== null && val !== undefined;\n case \"between\": {\n const [lo, hi] = filter.value;\n return (val as number) >= (lo as number) && (val as number) <= (hi as number);\n }\n }\n }\n\n function matchesSearch(\n row: Row,\n search: { query: string; fields: string[] },\n ): boolean {\n const q = search.query.toLowerCase();\n return search.fields.some((field) => {\n const val = row[field];\n return typeof val === \"string\" && val.toLowerCase().includes(q);\n });\n }\n\n function compareValues(a: unknown, b: unknown): number {\n if (typeof a === \"string\" && typeof b === \"string\") {\n return a.localeCompare(b, undefined, { numeric: true });\n }\n if (typeof a === \"number\" && typeof b === \"number\") {\n return a - b;\n }\n // Fallback: coerce to string.\n return String(a ?? \"\").localeCompare(String(b ?? \"\"), undefined, {\n numeric: true,\n });\n }\n\n function applyListParams(table: Row[], params: ListParams): { data: Row[]; total: number } {\n let rows = [...table];\n\n // Filters (AND).\n if (params.filters) {\n for (const f of params.filters) {\n rows = rows.filter((r) => matchesFilter(r, f));\n }\n }\n\n // Search (OR across fields, AND with filters).\n if (params.search && params.search.query) {\n rows = rows.filter((r) => matchesSearch(r, params.search!));\n }\n\n const total = rows.length;\n\n // Sort.\n // By each sort field in turn (`sorts`, else `sort`).\n const sorts = params.sorts && params.sorts.length > 0 ? params.sorts : params.sort ? [params.sort] : [];\n if (sorts.length > 0) {\n rows.sort((a, b) => {\n for (const { field, order } of sorts) {\n const cmp = compareValues(a[field], b[field]);\n if (cmp !== 0) return order === \"desc\" ? -cmp : cmp;\n }\n return 0;\n });\n }\n\n // Pagination (offset-based).\n if (params.pagination) {\n const { page, perPage } = params.pagination;\n const start = (page - 1) * perPage;\n rows = rows.slice(start, start + perPage);\n }\n\n return { data: rows, total };\n }\n\n // ---------------------------------------------------------------------------\n // DataProvider implementation\n // ---------------------------------------------------------------------------\n\n const provider: DataProvider = {\n async getList(_resource, params) {\n const table = getTable(_resource);\n const result = applyListParams(table, params);\n return withDelay(result) as never;\n },\n\n async getOne(_resource, params) {\n const table = getTable(_resource);\n const row = table.find((r) => String(r.id) === String(params.id));\n if (!row) {\n throw new Error(\n `[MockProvider] Record not found: ${_resource}#${params.id}`,\n );\n }\n return withDelay({ data: JSON.parse(JSON.stringify(row)) }) as never;\n },\n\n async getMany(_resource, params) {\n const table = getTable(_resource);\n const idSet = new Set(params.ids.map(String));\n const rows = table.filter((r) => idSet.has(String(r.id)));\n return withDelay({ data: JSON.parse(JSON.stringify(rows)) }) as never;\n },\n\n async create(_resource, params) {\n const table = getTable(_resource);\n const id = String(nextId++);\n const row = { id, ...params.data } as Row;\n table.push(row);\n return withDelay({ data: JSON.parse(JSON.stringify(row)) }) as never;\n },\n\n async update(_resource, params) {\n const table = getTable(_resource);\n const idx = table.findIndex((r) => String(r.id) === String(params.id));\n if (idx === -1) {\n throw new Error(\n `[MockProvider] Record not found: ${_resource}#${params.id}`,\n );\n }\n table[idx] = { ...table[idx], ...params.data };\n return withDelay({ data: JSON.parse(JSON.stringify(table[idx])) }) as never;\n },\n\n async deleteOne(_resource, params) {\n const table = getTable(_resource);\n const idx = table.findIndex((r) => String(r.id) === String(params.id));\n if (idx === -1) {\n throw new Error(\n `[MockProvider] Record not found: ${_resource}#${params.id}`,\n );\n }\n table.splice(idx, 1);\n return withDelay({ data: { id: params.id } });\n },\n };\n\n return provider;\n}\n","import {\n createContext,\n useContext,\n useEffect,\n useMemo,\n useRef,\n useState,\n type ReactNode,\n} from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport type { DataProvider } from \"./types\";\nimport { createMockProvider, type MockProviderOptions } from \"./mock-provider\";\nimport type { StorageAdapter } from \"../storage/types\";\nimport { createLocalStorageAdapter } from \"../storage/adapters\";\nimport type { QueryPersistence } from \"../offline/types\";\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\nconst DataProviderContext = createContext<DataProvider | null>(null);\nconst StorageContext = createContext<StorageAdapter>(createLocalStorageAdapter());\n\n// ---------------------------------------------------------------------------\n// DataProviderRoot — thin context wrapper\n// ---------------------------------------------------------------------------\n\n/**\n * Puts a `DataProvider` in context, and nothing else. Mount it inside your\n * app's own `QueryClientProvider` and the Genesis hooks share that cache:\n * the same query keys (`[resource, \"list\", params]`,\n * `[resource, \"detail\", id, select]`), so invalidating `[resource]` from app\n * code refreshes Genesis lists too, and vice versa.\n */\nexport interface DataProviderRootProps {\n provider: DataProvider;\n children: ReactNode;\n}\n\nexport function DataProviderRoot({ provider, children }: DataProviderRootProps) {\n return (\n <DataProviderContext.Provider value={provider}>\n {children}\n </DataProviderContext.Provider>\n );\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useDataProvider(): DataProvider {\n const ctx = useContext(DataProviderContext);\n if (!ctx) {\n throw new Error(\n \"useDataProvider must be used inside <DataProviderRoot> or <GenesisProvider>. \" +\n \"Wrap your app (or the relevant subtree) in one of these providers.\",\n );\n }\n return ctx;\n}\n\nexport function useStorage(): StorageAdapter {\n return useContext(StorageContext);\n}\n\n// ---------------------------------------------------------------------------\n// GenesisProvider — convenience wrapper\n// ---------------------------------------------------------------------------\n\ntype Row = Record<string, unknown>;\n\nexport type GenesisProviderProps =\n | {\n children: ReactNode;\n /** Pass a ready-made DataProvider. Mutually exclusive with `mock`. */\n provider: DataProvider;\n mock?: never;\n /** Platform-specific storage adapter. Defaults to localStorage (SSR-safe). */\n storage?: StorageAdapter;\n /**\n * Keep reads on the device and restore them on the next start, so lists and records open at\n * once: `persistOffline({ cache: indexedDbLocalCache(), resources, buster })` from\n * `@marktiderman/genesis-core/offline`. Needs `persistScope`. Give it from the first render:\n * the provider keeps the first one it's given.\n */\n persist?: (client: QueryClient) => QueryPersistence;\n /**\n * Whose cache this is: `cacheScope(user.id, workspaceKey)` once someone is signed in,\n * `null` once nobody is, and `undefined` while that isn't known yet (the session loading).\n * A device is one person's: restoring someone deletes everyone else's kept reads, and\n * `null` deletes them all, so a session that ended outside the app (it expired, or was\n * signed out elsewhere) leaves nothing on the device. Undefined does nothing. A change of\n * scope restores the new one's reads. Clear the QueryClient yourself when the person\n * changes, as a sign-out already does; a `ViewerScope` inside keeps the restored reads for\n * this person. Restoring is client-only: in a server-rendered app, give it after hydration\n * (undefined on the server and the first client render), and the screens restore in the\n * background. Change it only once the provider's session has: a scope must never name a\n * person before the data provider's requests are made as them.\n */\n persistScope?: string | null;\n /**\n * The TanStack Query client to use. Without it, GenesisProvider creates\n * its OWN client — a second cache beside any the app already has, so app\n * queries and Genesis queries would not see each other's invalidations.\n * An app with a `QueryClientProvider` should pass its client here, or\n * use `DataProviderRoot` inside that provider instead.\n */\n queryClient?: QueryClient;\n }\n | {\n children: ReactNode;\n provider?: never;\n /** Pass mock datasets. Mutually exclusive with `provider`. */\n mock: {\n datasets: Record<string, Row[]>;\n options?: MockProviderOptions;\n };\n /** Platform-specific storage adapter. Defaults to localStorage (SSR-safe). */\n storage?: StorageAdapter;\n /** See the `provider` variant. */\n queryClient?: QueryClient;\n /** See the `provider` variant. */\n persist?: (client: QueryClient) => QueryPersistence;\n /** See the `provider` variant. */\n persistScope?: string | null;\n };\n\nconst defaultStorage = createLocalStorageAdapter();\n\n/**\n * Convenience root: a `QueryClientProvider`, storage, and a data provider\n * (yours, or a mock built from datasets). It creates its own `QueryClient`\n * unless you pass `queryClient`; an app that already has one should pass it,\n * or mount `DataProviderRoot` inside its existing `QueryClientProvider`.\n */\nexport function GenesisProvider({\n children,\n provider,\n mock,\n storage,\n queryClient: queryClientProp,\n persist,\n persistScope,\n}: GenesisProviderProps) {\n if (provider && mock) {\n if (process.env.NODE_ENV !== \"production\") {\n console.warn(\"[GenesisProvider] Both `provider` and `mock` were passed. `provider` takes precedence. This is likely a mistake.\");\n }\n }\n\n // Build provider from mock datasets when no explicit provider is given.\n const resolvedProvider = useMemo(() => {\n if (provider) return provider;\n if (mock) return createMockProvider(mock.datasets, mock.options);\n throw new Error(\n \"<GenesisProvider> requires either a `provider` or `mock` prop.\",\n );\n }, [provider, mock]);\n\n // The caller's QueryClient, or an internal one with sensible defaults.\n const queryClient = useMemo(\n () =>\n queryClientProp ??\n new QueryClient({\n defaultOptions: {\n queries: {\n staleTime: 5 * 60 * 1000, // 5 minutes\n },\n },\n }),\n [queryClientProp],\n );\n\n const resolvedStorage = storage ?? defaultStorage;\n const restored = useRestoredReads(queryClient, persist, persistScope);\n\n return (\n <QueryClientProvider client={queryClient}>\n <StorageContext.Provider value={resolvedStorage}>\n <DataProviderRoot provider={resolvedProvider}>\n <PersistedViewerContext.Provider value={persist && typeof persistScope === \"string\" ? userOf(persistScope) : undefined}>\n {restored ? children : null}\n </PersistedViewerContext.Provider>\n </DataProviderRoot>\n </StorageContext.Provider>\n </QueryClientProvider>\n );\n}\n\n/** How long the first render waits for the device's reads before it goes on without them. */\nconst RESTORE_WAIT_MS = 400;\n\n/** The person a scope belongs to (`u:<user>|<workspace>`, or a bare user id). */\nconst userOf = (scope: string) => (scope.startsWith(\"u:\") ? scope.slice(2, scope.indexOf(\"|\") < 0 ? undefined : scope.indexOf(\"|\")) : scope);\n\n/**\n * Restores `scope`'s kept reads before the screens first render (so they open from the device),\n * waiting at most RESTORE_WAIT_MS, then saves new reads. Only the first render waits, and never on\n * the server; a later scope change restores in the background. When the person changes or signs\n * out, their reads are deleted from the device before anything of the next scope is restored.\n */\nfunction useRestoredReads(\n queryClient: QueryClient,\n persist: ((client: QueryClient) => QueryPersistence) | undefined,\n scope: string | null | undefined,\n): boolean {\n // The first `persist` given is kept (one given only later is ignored), so a screen that writes\n // it inline doesn't restart the restore on every render.\n const persistRef = useRef(persist);\n const persistence = useMemo(() => (persistRef.current ? persistRef.current(queryClient) : null), [queryClient]);\n const [ready, setReady] = useState(!persistence || !scope || typeof window === \"undefined\");\n // Whose reads this provider last restored or saved, and the clear of them still running.\n const person = useRef<string | null>(null);\n const clearing = useRef<Promise<void>>(Promise.resolve());\n // The scope the last run of the effect saw (\"not known yet\" at mount). A scope that arrives from\n // there is saved only from reads fetched once it's known: whatever the client already holds or\n // is reading may be another session's (the session was loading, or the client outlived this\n // provider and someone else's session), so it's fetched again (`refresh`), never adopted.\n const previous = useRef<string | null | undefined>(undefined);\n useEffect(() => {\n const from = previous.current;\n previous.current = scope;\n if (!persistence || scope === undefined) {\n // Not known yet who's signed in: nothing is restored, saved or deleted.\n setReady(true);\n return;\n }\n if (scope === null) {\n // Nobody signed in: nothing of anyone's stays on the device.\n person.current = null;\n clearing.current = persistence.restore(\"\").catch(() => undefined);\n setReady(true);\n return;\n }\n const next = userOf(scope);\n if (person.current !== null && person.current !== next) {\n clearing.current = persistence.clear().catch(() => undefined);\n }\n person.current = next;\n const abort = new AbortController();\n // Saving starts with the scope. A read made before it is saved only when the scope before was\n // \"not known yet\" (the same session, loading); from another person or workspace, never.\n const stop = persistence.subscribe(scope, { refresh: from === undefined });\n const open = () => {\n if (!abort.signal.aborted) setReady(true);\n };\n const wait = setTimeout(open, RESTORE_WAIT_MS);\n void clearing.current\n .then(() => (abort.signal.aborted ? undefined : persistence.restore(scope, abort.signal)))\n .catch(() => undefined)\n .finally(() => {\n clearTimeout(wait);\n open();\n });\n return () => {\n abort.abort();\n clearTimeout(wait);\n stop();\n };\n }, [persistence, scope]);\n return ready;\n}\n\n/**\n * The person whose kept reads `GenesisProvider` restored (`persistScope`'s user), so a\n * `ViewerScope` inside keeps them for that viewer instead of emptying the cache.\n */\nexport const PersistedViewerContext = createContext<string | undefined>(undefined);\n\n"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/hooks/use-link-options.ts"],"names":[],"mappings":"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","file":"chunk-VJGU6E4U.js","sourcesContent":["// The rows a link's picker offers (docs/RESOURCE-VIEW.md, \"Links in forms\"): the linked resource\n// listed through the data provider, so row-level security decides what the viewer can pick, with\n// the picker's filters (the linked view's scope and default filter), searched and paged on the\n// server, a page at a time. Web's RelationField and native's link picker both draw it.\n\nimport { useEffect, useMemo, useState } from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type { BaseRecord, FilterParam, SortParam } from \"../provider/types\";\nimport { useInfiniteResource } from \"./use-infinite-resource\";\nimport { relationNamingField } from \"./use-relation-label\";\n\n// Field names only go into `select` and `sort`, so nothing else rides along in the request.\nconst IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\nconst NAMING = /^(name|title|label|full_name|display_name)$/;\n\nexport interface LinkTarget {\n /** The linked resource. */\n resource: string;\n /** The linked field the link stores. Default `id`. */\n field?: string | undefined;\n /** The linked field that names a row. Default: the provider's `describe`, else a name-like field. */\n labelField?: string | undefined;\n /** The linked fields a search matches. Default: the naming field. */\n searchFields?: readonly string[] | undefined;\n /**\n * The order rows are listed in (a `position`), then the key. Default: by the naming field, then\n * the key. A view's link passes its `orderBy` (`link.orderBy`, or the linked view's for `\"view\"`).\n */\n orderBy?: { readonly field: string; readonly direction?: \"asc\" | \"desc\" | undefined } | undefined;\n}\n\nexport interface UseLinkOptionsOptions {\n /** Filters every request carries: the linked view's scope and default filter, the link's own. */\n filters?: FilterParam[] | undefined;\n /** What the person typed. Sent to the server (`search`), never matched against loaded rows. */\n search?: string | undefined;\n /** Rows per page. Default 25. */\n perPage?: number | undefined;\n /** Default true. A picker passes false until it opens, so a closed form asks for nothing. */\n enabled?: boolean | undefined;\n /**\n * The words for a row whose naming field is empty: a picker passes its catalogue's\n * (`common.untitled`). Default \"Untitled\". Never the row's raw key.\n */\n untitled?: string | undefined;\n}\n\n/** One row a picker offers: the key it stores and the words it shows. */\nexport interface LinkOption {\n /** The linked row's key, as the row holds it (text or a number). */\n value: string | number;\n label: string;\n}\n\nexport interface UseLinkOptionsReturn {\n options: LinkOption[];\n /** The naming field used, once known. */\n labelField: string | undefined;\n /** Whether a search can be sent: false when nothing names the rows. */\n searchable: boolean;\n /** The first page is loading. */\n isLoading: boolean;\n isError: boolean;\n /** More rows than are loaded match. */\n hasMore: boolean;\n /** Loads the next page. Does nothing while one loads or none is left. */\n loadMore: () => void;\n isLoadingMore: boolean;\n}\n\nfunction words(value: unknown): string | null {\n if (typeof value === \"number\" && Number.isFinite(value)) return String(value);\n if (typeof value !== \"string\") return null;\n return value.trim() || null;\n}\n\n/**\n * The rows a link can point at, for a picker: listed through the data provider with `filters`,\n * searched on the server with `search` across `searchFields` (else the naming field), sorted by\n * `orderBy` (else the naming field) then the key, `perPage` at a time (`loadMore` for the next). A large table is\n * never loaded whole. Each option is the row's key and its words; a row with no words shows\n * `untitled`, never its key.\n */\nexport function useLinkOptions(target: LinkTarget, options: UseLinkOptionsOptions = {}): UseLinkOptionsReturn {\n const { filters, search = \"\", perPage = 25, enabled = true, untitled = \"Untitled\" } = options;\n const provider = useDataProvider();\n const field = target.field ?? \"id\";\n\n // The naming field: the target's, else `describe`'s (shared with a link's words).\n const named = useQuery({\n queryKey: [target.resource, \"naming-field\"],\n enabled: enabled && !target.labelField,\n staleTime: Infinity,\n retry: false,\n queryFn: async () => (await relationNamingField(provider, target.resource)) ?? null,\n });\n const labelField = target.labelField ?? named.data ?? undefined;\n const settled = Boolean(target.labelField) || named.isFetched;\n const naming = labelField && IDENTIFIER.test(labelField) ? labelField : undefined;\n const searchFields = useMemo(\n () => (target.searchFields?.length ? [...target.searchFields] : naming ? [naming] : []).filter((f) => IDENTIFIER.test(f)),\n // By value: a caller's inline list is one list.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [JSON.stringify(target.searchFields ?? null), naming],\n );\n\n // The naming field the list is sorted by: known at once when the target names it, else set\n // below once `describe` answers, before the first request goes.\n // Then by the key: rows that share a name keep one order across pages, so offset paging never\n // skips or repeats one (a provider without `multiSort` sorts by the name only).\n // A caller's own order (a `position`) wins over the name: known at once, so it never waits on\n // `describe` to sort.\n const ordered = target.orderBy && IDENTIFIER.test(target.orderBy.field) ? target.orderBy : undefined;\n const orderField = ordered?.field;\n const orderDirection = ordered?.direction === \"desc\" ? \"desc\" : \"asc\";\n const sortsFor = (by: string, order: \"asc\" | \"desc\" = \"asc\"): SortParam[] =>\n by === field || !IDENTIFIER.test(field) ? [{ field: by, order }] : [{ field: by, order }, { field, order: \"asc\" }];\n const sortBy = orderField ?? naming;\n const sortKey = sortBy ? `${sortBy}:${orderField ? orderDirection : \"asc\"}` : undefined;\n const sorts = sortBy ? sortsFor(sortBy, orderField ? orderDirection : \"asc\") : undefined;\n const [sortedBy, setSortedBy] = useState<string | undefined>(sortKey);\n const list = useInfiniteResource<BaseRecord>(target.resource, {\n ...(filters ? { defaultFilters: filters } : {}),\n perPage,\n ...(naming && IDENTIFIER.test(field) ? { select: `${field},${naming}` } : {}),\n ...(sorts ? { defaultSorts: sorts } : {}),\n searchFields,\n // Not before the naming field is known, so the first request is already sorted and narrowed.\n enabled: enabled && settled && (!sortKey || sortedBy === sortKey),\n });\n\n // The sort and the search follow the order (the caller's, else the naming field) and what the\n // person typed.\n const { setSorts, setSearch } = list;\n useEffect(() => {\n if (!sortBy) return;\n setSorts(sortsFor(sortBy, orderField ? orderDirection : \"asc\"));\n setSortedBy(sortKey);\n // sortsFor reads only `field`; sortKey follows sortBy and the direction.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [sortKey, field, setSorts]);\n useEffect(() => {\n setSearch(searchFields.length ? search.trim() : \"\");\n }, [search, searchFields.length, setSearch]);\n\n const rows = list.rows;\n const linkOptions = useMemo(() => {\n const seen = new Set<string>();\n const out: LinkOption[] = [];\n for (const row of rows as Record<string, unknown>[]) {\n const key = row[field];\n if (typeof key !== \"string\" && !(typeof key === \"number\" && Number.isFinite(key))) continue;\n if (seen.has(String(key))) continue;\n seen.add(String(key));\n const name = naming ? row[naming] : row[Object.keys(row).find((k) => NAMING.test(k)) ?? \"\"];\n // A row with no words shows `untitled`, never its raw key.\n out.push({ value: key, label: words(name) ?? untitled });\n }\n return out;\n }, [rows, field, naming, untitled]);\n\n return {\n options: linkOptions,\n labelField: naming,\n searchable: searchFields.length > 0,\n isLoading: enabled && (!settled || list.query.isPending),\n isError: list.query.isError,\n hasMore: list.hasNextPage,\n loadMore: list.fetchNextPage,\n isLoadingMore: list.isFetchingNextPage,\n };\n}\n"]}