@marktiderman/genesis-core 2.16.0 → 2.17.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 (124) hide show
  1. package/README.md +3 -2
  2. package/dist/{aggregate-Y5IJ5aPn.d.ts → aggregate-v_r-nZbH.d.ts} +1 -1
  3. package/dist/{chunk-M5IX7C6U.js → chunk-24X4HWL5.js} +4 -4
  4. package/dist/{chunk-M5IX7C6U.js.map → chunk-24X4HWL5.js.map} +1 -1
  5. package/dist/chunk-2ORQLYVW.js +115 -0
  6. package/dist/chunk-2ORQLYVW.js.map +1 -0
  7. package/dist/{chunk-XPBS5YE4.js → chunk-4POVYF6P.js} +4 -4
  8. package/dist/{chunk-XPBS5YE4.js.map → chunk-4POVYF6P.js.map} +1 -1
  9. package/dist/{chunk-IYGVJFCV.js → chunk-5KLIFJYG.js} +3 -3
  10. package/dist/{chunk-IYGVJFCV.js.map → chunk-5KLIFJYG.js.map} +1 -1
  11. package/dist/{chunk-ALLWIK62.js → chunk-6B4CN2TC.js} +8 -6
  12. package/dist/chunk-6B4CN2TC.js.map +1 -0
  13. package/dist/chunk-6JOWGO2X.js +266 -0
  14. package/dist/chunk-6JOWGO2X.js.map +1 -0
  15. package/dist/{chunk-E3K2A3PK.js → chunk-6SHGMEA6.js} +3 -3
  16. package/dist/{chunk-E3K2A3PK.js.map → chunk-6SHGMEA6.js.map} +1 -1
  17. package/dist/chunk-6VNM6KAX.js +59 -0
  18. package/dist/chunk-6VNM6KAX.js.map +1 -0
  19. package/dist/{chunk-SOO54YYY.js → chunk-AQX5HQD6.js} +3 -3
  20. package/dist/{chunk-SOO54YYY.js.map → chunk-AQX5HQD6.js.map} +1 -1
  21. package/dist/chunk-BNKP2H7J.js +11 -0
  22. package/dist/chunk-BNKP2H7J.js.map +1 -0
  23. package/dist/{chunk-FXPODKCK.js → chunk-FBMKI22S.js} +6 -6
  24. package/dist/{chunk-FXPODKCK.js.map → chunk-FBMKI22S.js.map} +1 -1
  25. package/dist/{chunk-POUI7GAI.js → chunk-JF7FXSQB.js} +5 -5
  26. package/dist/{chunk-POUI7GAI.js.map → chunk-JF7FXSQB.js.map} +1 -1
  27. package/dist/chunk-JNWTHDGF.js +892 -0
  28. package/dist/chunk-JNWTHDGF.js.map +1 -0
  29. package/dist/chunk-K33LWVUF.js +31 -0
  30. package/dist/chunk-K33LWVUF.js.map +1 -0
  31. package/dist/chunk-KRRESUXT.js +192 -0
  32. package/dist/chunk-KRRESUXT.js.map +1 -0
  33. package/dist/{chunk-LB6FMQQM.js → chunk-KV2HW4G4.js} +3 -11
  34. package/dist/chunk-KV2HW4G4.js.map +1 -0
  35. package/dist/{chunk-42NVJJTT.js → chunk-MMMC37AP.js} +3 -3
  36. package/dist/{chunk-42NVJJTT.js.map → chunk-MMMC37AP.js.map} +1 -1
  37. package/dist/chunk-MZVFOTAE.js +96 -0
  38. package/dist/chunk-MZVFOTAE.js.map +1 -0
  39. package/dist/{chunk-R3YXYVWF.js → chunk-OIZNABG4.js} +5 -4
  40. package/dist/chunk-OIZNABG4.js.map +1 -0
  41. package/dist/{chunk-QGWQ6LK3.js → chunk-QJOKZZKY.js} +9 -6
  42. package/dist/chunk-QJOKZZKY.js.map +1 -0
  43. package/dist/chunk-TWLPC4S3.js +53 -0
  44. package/dist/chunk-TWLPC4S3.js.map +1 -0
  45. package/dist/{chunk-7EFTWOMA.js → chunk-UNEZF3ZP.js} +73 -15
  46. package/dist/chunk-UNEZF3ZP.js.map +1 -0
  47. package/dist/chunk-WNOCPV4A.js +220 -0
  48. package/dist/chunk-WNOCPV4A.js.map +1 -0
  49. package/dist/{chunk-ZYOJWU62.js → chunk-XIBQ5BTZ.js} +12 -53
  50. package/dist/chunk-XIBQ5BTZ.js.map +1 -0
  51. package/dist/chunk-YMFJLBIZ.js +159 -0
  52. package/dist/chunk-YMFJLBIZ.js.map +1 -0
  53. package/dist/{chunk-UDSTWXXZ.js → chunk-ZKLB2HB5.js} +3 -3
  54. package/dist/{chunk-UDSTWXXZ.js.map → chunk-ZKLB2HB5.js.map} +1 -1
  55. package/dist/csv.d.ts +12 -3
  56. package/dist/csv.js +4 -4
  57. package/dist/csv.js.map +1 -1
  58. package/dist/form-types.d.ts +1 -1
  59. package/dist/headless/index.d.ts +1 -1
  60. package/dist/hooks/index.d.ts +16 -6
  61. package/dist/hooks/index.js +27 -15
  62. package/dist/hooks/mutation-mode.d.ts +1 -1
  63. package/dist/hooks/mutation-mode.js +3 -3
  64. package/dist/hooks/related-keys.d.ts +1 -1
  65. package/dist/hooks/use-aggregate.d.ts +2 -2
  66. package/dist/hooks/use-aggregate.js +3 -3
  67. package/dist/hooks/use-board-columns.d.ts +79 -0
  68. package/dist/hooks/use-board-columns.js +4 -0
  69. package/dist/hooks/use-board-columns.js.map +1 -0
  70. package/dist/hooks/use-capabilities.d.ts +1 -1
  71. package/dist/hooks/use-capabilities.js +2 -2
  72. package/dist/hooks/use-infinite-resource.d.ts +1 -1
  73. package/dist/hooks/use-infinite-resource.js +3 -3
  74. package/dist/hooks/use-link-options.d.ts +1 -1
  75. package/dist/hooks/use-link-options.js +5 -5
  76. package/dist/hooks/use-list-state.d.ts +103 -0
  77. package/dist/hooks/use-list-state.js +21 -0
  78. package/dist/hooks/use-list-state.js.map +1 -0
  79. package/dist/hooks/use-live.d.ts +1 -1
  80. package/dist/hooks/use-live.js +2 -2
  81. package/dist/hooks/use-one.d.ts +7 -1
  82. package/dist/hooks/use-one.js +3 -3
  83. package/dist/hooks/use-persisted-ui-state.js +2 -2
  84. package/dist/hooks/use-relation-label.d.ts +1 -1
  85. package/dist/hooks/use-relation-label.js +2 -2
  86. package/dist/hooks/use-resource-form.d.ts +1 -1
  87. package/dist/hooks/use-resource-form.js +7 -7
  88. package/dist/hooks/use-resource.d.ts +7 -1
  89. package/dist/hooks/use-resource.js +5 -5
  90. package/dist/hooks/use-segment-counts.d.ts +23 -0
  91. package/dist/hooks/use-segment-counts.js +19 -0
  92. package/dist/hooks/use-segment-counts.js.map +1 -0
  93. package/dist/hooks/use-view-board.d.ts +120 -0
  94. package/dist/hooks/use-view-board.js +29 -0
  95. package/dist/hooks/use-view-board.js.map +1 -0
  96. package/dist/hooks/use-view-calendar-range.d.ts +91 -0
  97. package/dist/hooks/use-view-calendar-range.js +22 -0
  98. package/dist/hooks/use-view-calendar-range.js.map +1 -0
  99. package/dist/hooks/use-write.d.ts +1 -1
  100. package/dist/index.d.ts +41 -11
  101. package/dist/index.js +119 -26
  102. package/dist/index.js.map +1 -1
  103. package/dist/provider/index.d.ts +61 -8
  104. package/dist/provider/index.js +2 -2
  105. package/dist/resource-view/index.d.ts +162 -757
  106. package/dist/resource-view/index.js +31 -686
  107. package/dist/resource-view/index.js.map +1 -1
  108. package/dist/saved-views-C45lRm7i.d.ts +155 -0
  109. package/dist/schema/index.d.ts +3 -3
  110. package/dist/schema/index.js +2 -1
  111. package/dist/testing/index.d.ts +2 -2
  112. package/dist/types-BAhcze_-.d.ts +1063 -0
  113. package/dist/{types-BriIV4e_.d.ts → types-CiQY6hUy.d.ts} +11 -1
  114. package/dist/{viewer-scope-Dx0N9AYk.d.ts → viewer-oOk0ZZk9.d.ts} +36 -34
  115. package/dist/{workspaces-CxpiFu2-.d.ts → workspaces-DeaFix5Z.d.ts} +1 -1
  116. package/dist/workspaces.d.ts +2 -2
  117. package/dist/{write-outcome-CkQXgtJq.d.ts → write-outcome-DuwfsnyO.d.ts} +1 -1
  118. package/package.json +11 -1
  119. package/dist/chunk-7EFTWOMA.js.map +0 -1
  120. package/dist/chunk-ALLWIK62.js.map +0 -1
  121. package/dist/chunk-LB6FMQQM.js.map +0 -1
  122. package/dist/chunk-QGWQ6LK3.js.map +0 -1
  123. package/dist/chunk-R3YXYVWF.js.map +0 -1
  124. package/dist/chunk-ZYOJWU62.js.map +0 -1
@@ -0,0 +1,192 @@
1
+ import { boardProblems, boardChoices } from './chunk-JNWTHDGF.js';
2
+ import { warnOnce } from './chunk-YMFJLBIZ.js';
3
+ import { encodeRecordKey } from './chunk-KV2HW4G4.js';
4
+ import { useViewer } from './chunk-XIBQ5BTZ.js';
5
+ import { writeConflict } from './chunk-LKRJB632.js';
6
+ import { useResource } from './chunk-6B4CN2TC.js';
7
+ import { BOARD_NONE, useBoardColumns } from './chunk-6VNM6KAX.js';
8
+ import { useLiveInvalidation } from './chunk-6SHGMEA6.js';
9
+ import { resourceKeys } from './chunk-2IGAUXYH.js';
10
+ import { useDataProvider } from './chunk-OIZNABG4.js';
11
+ import { isDataWriteError, NO_ROWS_MATCHED } from './chunk-WLDSIQJ2.js';
12
+ import { useState, useRef, useEffect } from 'react';
13
+ import { useQueryClient } from '@tanstack/react-query';
14
+
15
+ var ENGLISH = {
16
+ notAllowed: "You can't move this card.",
17
+ noValue: "No value",
18
+ stillSaving: (name) => `${name} is still moving. Try again in a moment.`,
19
+ notChanged: (noun) => `This ${noun} was not changed.`,
20
+ moveFailed: (name) => `Couldn\u2019t move ${name}.`
21
+ };
22
+ function withoutUndefined(o) {
23
+ return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== void 0));
24
+ }
25
+ function useViewBoard(view, options = {}) {
26
+ const { filters = [], select, enabled = true, live, perPage, can, resourceOptions, onMoveError, onLostConflict } = options;
27
+ const words = { ...ENGLISH, ...options.words };
28
+ const where = `ResourceView(${view.resource})`;
29
+ const own = view.definition.board;
30
+ const screen = withoutUndefined({ field: options.field, columns: options.columns, cardFields: options.cardFields, limits: options.limits });
31
+ let block = { ...own, ...screen };
32
+ let problems = block.field ? boardProblems(view.contract.fields, block) : [];
33
+ if (problems.length && own && Object.keys(screen).length) {
34
+ warnOnce(`${where}: board ${problems.join("; ")}; showing the view's board`);
35
+ block = own;
36
+ problems = [];
37
+ }
38
+ if (!block.field) throw new Error(`${where}: mode="board" needs a board field: the view's board.field, or board={{ field }}`);
39
+ if (problems.length) throw new Error(`${where}: ${problems.join("; ")}`);
40
+ const { field: fieldName, columns: columnValues, limits } = block;
41
+ const provider = useDataProvider();
42
+ const viewer = useViewer();
43
+ const field = view.field(fieldName);
44
+ const values = columnValues ?? [...boardChoices(field), ...field.nullable ? [BOARD_NONE] : []];
45
+ const stored = (value) => value === BOARD_NONE ? null : field.type === "boolean" ? value === "true" : value;
46
+ const orderBy = view.definition.orderBy;
47
+ const keyOf = (row) => String(encodeRecordKey(view.contract, row));
48
+ const titleOf = (row) => view.summary(row).title;
49
+ const board = useBoardColumns({
50
+ provider,
51
+ resource: view.resource,
52
+ field: fieldName,
53
+ values,
54
+ filters,
55
+ ...orderBy ? { sorts: [{ field: orderBy.field, order: orderBy.direction ?? "asc", ...orderBy.nulls ? { nulls: orderBy.nulls } : {} }] } : {},
56
+ ...select !== void 0 ? { select } : {},
57
+ ...perPage !== void 0 ? { perPage } : {},
58
+ enabled,
59
+ toValue: stored,
60
+ getKey: (row) => keyOf(row)
61
+ });
62
+ useLiveInvalidation(view.resource, live, enabled, { filters: [...filters] }, [view.resource]);
63
+ const { update } = useResource(view.resource, {
64
+ enabled: false,
65
+ ...resourceOptions?.invalidates ? { invalidates: resourceOptions.invalidates } : {},
66
+ // The board reports a failed move itself (the refusal, or `onMoveError`), so a failure isn't
67
+ // logged as well; and a conflict is the sheet's, so it isn't the app's failure either.
68
+ onError: (error) => {
69
+ if (!onMoveError && writeConflict(error, {})) return;
70
+ resourceOptions?.onError?.(error);
71
+ },
72
+ ...resourceOptions?.onUpdateSuccess ? { onUpdateSuccess: resourceOptions.onUpdateSuccess } : {}
73
+ });
74
+ const [refusal, setRefusal] = useState(null);
75
+ const queryClient = useQueryClient();
76
+ const [conflict, setConflict] = useState(null);
77
+ const mounted = useRef(true);
78
+ useEffect(() => {
79
+ mounted.current = true;
80
+ return () => {
81
+ mounted.current = false;
82
+ };
83
+ }, []);
84
+ const refresh = async () => {
85
+ await Promise.all([
86
+ queryClient.invalidateQueries({ queryKey: [...resourceKeys(view.resource).all] }),
87
+ ...(resourceOptions?.invalidates ?? []).map((queryKey) => queryClient.invalidateQueries({ queryKey: [...queryKey] }))
88
+ ]);
89
+ };
90
+ const inFlight = useRef(/* @__PURE__ */ new Set());
91
+ const [saving, setSaving] = useState(() => /* @__PURE__ */ new Set());
92
+ const movable = view.writable("edit").includes(fieldName);
93
+ const canMove = (row) => {
94
+ if (!movable) return words.notAllowed;
95
+ if (can && !can("edit", row)) return words.notAllowed;
96
+ return view.can("update", row, viewer);
97
+ };
98
+ const tones = view.definition.fields?.[fieldName]?.tones;
99
+ const columns = board.columns.map((c) => {
100
+ const tone = c.value === BOARD_NONE ? void 0 : tones?.[c.value];
101
+ return {
102
+ value: c.value,
103
+ label: c.value === BOARD_NONE ? words.noValue : view.valueLabel(fieldName, c.value),
104
+ ...tone ? { tone } : {},
105
+ items: c.items,
106
+ ...c.total !== void 0 ? { total: c.total } : {},
107
+ hasMore: c.hasMore,
108
+ loading: c.loading,
109
+ ...limits?.[c.value] !== void 0 ? { limit: limits[c.value] } : {}
110
+ };
111
+ });
112
+ const move = async (row, to) => {
113
+ const key = keyOf(row);
114
+ if (inFlight.current.has(key)) throw new Error(words.stillSaving(titleOf(row)));
115
+ inFlight.current.add(key);
116
+ setRefusal(null);
117
+ const verdict = canMove(row);
118
+ setSaving(new Set(inFlight.current));
119
+ const data = { [fieldName]: stored(to) };
120
+ try {
121
+ if (verdict !== true) throw new Error(verdict);
122
+ await update(key, data);
123
+ } catch (error) {
124
+ const found = onMoveError ? null : writeConflict(error, data, { changed: [fieldName] });
125
+ if (onMoveError) onMoveError(error, row);
126
+ else if (found) {
127
+ if (mounted.current) setConflict({ conflict: found, id: key, data });
128
+ else onLostConflict?.(error);
129
+ } else if (isDataWriteError(error) && error.code === NO_ROWS_MATCHED) setRefusal(words.notChanged(view.noun));
130
+ else setRefusal(error instanceof Error && error.message ? error.message : words.moveFailed(titleOf(row)));
131
+ throw error;
132
+ } finally {
133
+ inFlight.current.delete(key);
134
+ setSaving(new Set(inFlight.current));
135
+ }
136
+ };
137
+ const keepMine = async () => {
138
+ if (!conflict) return;
139
+ const { id, data, conflict: c } = conflict;
140
+ if (inFlight.current.has(id)) return;
141
+ const verdict = canMove(c.theirs);
142
+ if (verdict !== true) {
143
+ setConflict(null);
144
+ setRefusal(verdict);
145
+ void refresh();
146
+ throw new Error(verdict);
147
+ }
148
+ inFlight.current.add(id);
149
+ setSaving(new Set(inFlight.current));
150
+ try {
151
+ await update(id, data, c.currentVersion != null ? { expectedVersion: c.currentVersion } : void 0);
152
+ setConflict(null);
153
+ } catch (error) {
154
+ const again = writeConflict(error, data, { changed: [fieldName] });
155
+ if (!again) throw error;
156
+ setConflict({ conflict: again, id, data });
157
+ void refresh();
158
+ } finally {
159
+ inFlight.current.delete(id);
160
+ setSaving(new Set(inFlight.current));
161
+ }
162
+ };
163
+ const takeTheirs = () => {
164
+ setConflict(null);
165
+ void refresh();
166
+ };
167
+ return {
168
+ block,
169
+ field: fieldName,
170
+ columns,
171
+ loadMore: board.loadMore,
172
+ loading: board.loading,
173
+ error: board.error,
174
+ ownFilterSetAside: board.ownFilterSetAside,
175
+ movable,
176
+ canMove,
177
+ move,
178
+ saving,
179
+ refusal,
180
+ clearRefusal: () => setRefusal(null),
181
+ conflict,
182
+ keepMine,
183
+ takeTheirs,
184
+ refresh,
185
+ keyOf,
186
+ titleOf
187
+ };
188
+ }
189
+
190
+ export { useViewBoard };
191
+ //# sourceMappingURL=chunk-KRRESUXT.js.map
192
+ //# sourceMappingURL=chunk-KRRESUXT.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/hooks/use-view-board.ts"],"names":[],"mappings":"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","file":"chunk-KRRESUXT.js","sourcesContent":["// useViewBoard: a board's data and its moves, from a view (ADR 0019). The columns come from the\n// view's board block (or `boardChoices` of its field), each paged on its own; a move writes the\n// field through the resource's own update, with the view's guards, a refusal's reason and the\n// conflict sheet's choices. The web's ResourceBoard, a custom view and the phone's board all draw\n// what this returns; each brings its own words (`words`).\n\nimport { useEffect, useRef, useState } from \"react\";\nimport { useQueryClient } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type { BaseRecord, FilterParam } from \"../provider/types\";\nimport { resourceKeys } from \"../query-keys\";\nimport { encodeRecordKey } from \"../schema/keys\";\nimport type { DataRow, ResourceContract } from \"../schema/types\";\nimport { isDataWriteError, NO_ROWS_MATCHED } from \"../schema/write-outcome\";\nimport { writeConflict, type WriteConflict } from \"../schema/write-state\";\nimport { boardChoices, boardProblems } from \"../resource-view/define-view\";\nimport type { ResourceView as View, ViewBoard, ViewTone } from \"../resource-view/types\";\nimport { warnOnce } from \"../resource-view/calendar\";\nimport { BOARD_NONE, useBoardColumns } from \"./use-board-columns\";\nimport { useLiveInvalidation, type LiveOptions } from \"./use-live\";\nimport { useResource, type UseResourceOptions } from \"./use-resource\";\nimport { useViewer } from \"./viewer-scope\";\n\ntype Row = Record<string, unknown>;\n\n/** @stability Beta */\nexport interface UseViewBoardOptions<T extends Row = Row> extends Partial<ViewBoard> {\n /** Server filters (the view's scope and the screen's), already as params. */\n filters?: readonly FilterParam[] | undefined;\n select?: string | undefined;\n /** False while the screen waits: nothing is fetched. Default true. */\n enabled?: boolean | undefined;\n live?: boolean | LiveOptions | undefined;\n /** Cards per column page. Default 50. */\n perPage?: number | undefined;\n /** The screen's own guard: it only narrows the view's. A card moves only when both allow `edit`. */\n can?: ((action: \"create\" | \"edit\" | \"delete\", item?: T) => boolean) | undefined;\n /** `invalidates`, `onError` and `onUpdateSuccess` apply to a move. A move is always pessimistic. */\n resourceOptions?: Pick<UseResourceOptions<T & BaseRecord>, \"invalidates\" | \"onError\" | \"onUpdateSuccess\"> | undefined;\n /** A move was refused. Without it, the reason is in `refusal` (and a conflict in `conflict`). */\n onMoveError?: ((error: unknown, row: T) => void) | undefined;\n /** The board's words, in the app's language. Default English. */\n words?: Partial<ViewBoardWords> | undefined;\n /** A conflict that came back after the board was gone (a route change mid-save): tell the person. Default nothing. */\n onLostConflict?: ((error: unknown) => void) | undefined;\n}\n\n/** What a board says, for each platform's message catalogue. @stability Beta */\nexport interface ViewBoardWords {\n /** The screen's `can` refuses the move. */\n notAllowed: string;\n /** The column for rows with no value. */\n noValue: string;\n /** A card whose last move is still saving. */\n stillSaving: (name: string) => string;\n /** The move matched no row (it changed or went away). */\n notChanged: (noun: string) => string;\n /** The move failed with no words of its own. */\n moveFailed: (name: string) => string;\n}\n\nconst ENGLISH: ViewBoardWords = {\n notAllowed: \"You can't move this card.\",\n noValue: \"No value\",\n stillSaving: (name) => `${name} is still moving. Try again in a moment.`,\n notChanged: (noun) => `This ${noun} was not changed.`,\n moveFailed: (name) => `Couldn’t move ${name}.`,\n};\n\n/** One column: its value, its words, its tone and its cards so far. @stability Beta */\nexport interface ViewBoardColumn<T extends Row = Row> {\n /** A value of the board's field, or `BOARD_NONE` for rows with none. */\n value: string;\n label: string;\n /** The field's tone for this value (`fields.<field>.tones`). */\n tone?: ViewTone;\n items: T[];\n /** Cards in the column in all, once counted. */\n total?: number;\n hasMore: boolean;\n loading: boolean;\n /** The column's work-in-progress limit (`board.limits`). */\n limit?: number;\n}\n\n/** A move that met someone else's change, for ConflictSheet. @stability Beta */\nexport interface ViewBoardConflict {\n conflict: WriteConflict;\n id: string;\n data: Record<string, unknown>;\n}\n\n/** @stability Beta */\nexport interface ViewBoardState<T extends Row = Row> {\n /** The board block in use: the screen's over the view's. */\n block: ViewBoard;\n /** The board's field. */\n field: string;\n columns: ViewBoardColumn<T>[];\n loadMore: (value: string) => void;\n /** Some column is still on its first load. */\n loading: boolean;\n error: unknown;\n /** A filter on the board's own field was set aside (each column has its own). */\n ownFilterSetAside: boolean;\n /** The view can write the field on edit, so cards can move at all. */\n movable: boolean;\n /** Whether this card may move: `true`, or the reason. */\n canMove: (row: T) => true | string;\n /** Move a card to a column's value. Rejects when refused; the card stays where it was. */\n move: (row: T, to: string) => Promise<void>;\n /** Keys of cards whose move is saving. */\n saving: ReadonlySet<string>;\n /** Why the last move was refused, in words (when there's no `onMoveError`). */\n refusal: string | null;\n clearRefusal: () => void;\n /** A move that met someone else's change, until kept or dropped. */\n conflict: ViewBoardConflict | null;\n /** Keep my move, checked against their version. */\n keepMine: () => Promise<void>;\n /** Take theirs: the card goes where their row puts it. */\n takeTheirs: () => void;\n /** Refetch every column. */\n refresh: () => Promise<void>;\n keyOf: (row: T) => string;\n titleOf: (row: T) => string;\n}\n\nfunction withoutUndefined<O extends object>(o: O): Partial<O> {\n return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined)) as Partial<O>;\n}\n\n/**\n * A view's rows as board columns, with moves:\n *\n * ```tsx\n * const board = useViewBoard(tasksView, { filters: useViewListParams({ view: tasksView }).filters });\n * board.columns.map((c) => <Lane key={c.value} title={c.label} cards={c.items} onDrop={(row) => board.move(row, c.value)} />);\n * ```\n *\n * Throws when the view has no board field and the options name none, or names one a board can't\n * use (a field without choices).\n *\n * @stability Beta\n */\nexport function useViewBoard<T extends Row = Row>(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- any contract; Row is what matters here\n view: View<ResourceContract<any>, T & DataRow>,\n options: UseViewBoardOptions<T> = {},\n): ViewBoardState<T> {\n const { filters = [], select, enabled = true, live, perPage, can, resourceOptions, onMoveError, onLostConflict } = options;\n const words: ViewBoardWords = { ...ENGLISH, ...options.words };\n const where = `ResourceView(${view.resource})`;\n const own = view.definition.board;\n const screen = withoutUndefined({ field: options.field, columns: options.columns, cardFields: options.cardFields, limits: options.limits });\n // The screen's block over the view's. A bad override (a hand-edited URL, a renamed value) warns\n // and falls back to the view's own block, which defineView already checked.\n let block: Partial<ViewBoard> = { ...own, ...screen };\n let problems = block.field ? boardProblems(view.contract.fields, block) : [];\n if (problems.length && own && Object.keys(screen).length) {\n warnOnce(`${where}: board ${problems.join(\"; \")}; showing the view's board`);\n block = own;\n problems = [];\n }\n if (!block.field) throw new Error(`${where}: mode=\"board\" needs a board field: the view's board.field, or board={{ field }}`);\n if (problems.length) throw new Error(`${where}: ${problems.join(\"; \")}`);\n const { field: fieldName, columns: columnValues, limits } = block;\n const provider = useDataProvider();\n const viewer = useViewer();\n const field = view.field(fieldName)!;\n const values = columnValues ?? [...boardChoices(field)!, ...(field.nullable ? [BOARD_NONE] : [])];\n // A column's value as the field stores it: a yes/no board's \"true\" is `true`.\n const stored = (value: string): unknown => (value === BOARD_NONE ? null : field.type === \"boolean\" ? value === \"true\" : value);\n const orderBy = view.definition.orderBy;\n const keyOf = (row: T) => String(encodeRecordKey(view.contract, row as DataRow));\n const titleOf = (row: T) => view.summary(row as T & DataRow).title;\n\n const board = useBoardColumns<T & BaseRecord>({\n provider,\n resource: view.resource,\n field: fieldName,\n values,\n filters,\n ...(orderBy ? { sorts: [{ field: orderBy.field, order: orderBy.direction ?? \"asc\", ...(orderBy.nulls ? { nulls: orderBy.nulls } : {}) }] } : {}),\n ...(select !== undefined ? { select } : {}),\n ...(perPage !== undefined ? { perPage } : {}),\n enabled,\n toValue: stored,\n getKey: (row) => keyOf(row as unknown as T),\n });\n useLiveInvalidation(view.resource, live, enabled, { filters: [...filters] }, [view.resource]);\n // The resource's own update: core's write path, so the provider's rules (and a versioned\n // resource's version check) apply. Pessimistic: a card moves once the server has it.\n const { update } = useResource<T & BaseRecord>(view.resource, {\n enabled: false,\n ...(resourceOptions?.invalidates ? { invalidates: resourceOptions.invalidates } : {}),\n // The board reports a failed move itself (the refusal, or `onMoveError`), so a failure isn't\n // logged as well; and a conflict is the sheet's, so it isn't the app's failure either.\n onError: (error) => {\n if (!onMoveError && writeConflict(error, {})) return;\n resourceOptions?.onError?.(error);\n },\n ...(resourceOptions?.onUpdateSuccess ? { onUpdateSuccess: resourceOptions.onUpdateSuccess } : {}),\n });\n const [refusal, setRefusal] = useState<string | null>(null);\n const queryClient = useQueryClient();\n const [conflict, setConflict] = useState<ViewBoardConflict | null>(null);\n // A conflict that settles after the board is gone has no sheet to open: it's toasted instead.\n const mounted = useRef(true);\n useEffect(() => {\n mounted.current = true;\n return () => {\n mounted.current = false;\n };\n }, []);\n const refresh = async () => {\n await Promise.all([\n queryClient.invalidateQueries({ queryKey: [...resourceKeys(view.resource).all] }),\n ...(resourceOptions?.invalidates ?? []).map((queryKey) => queryClient.invalidateQueries({ queryKey: [...queryKey] })),\n ]);\n };\n // Rows whose move is saving. A pessimistic move leaves the card in its old column until the\n // refetch, so a second move then would be sent from the wrong column (and, on a versioned\n // resource, refused as a conflict with the first): it is turned away until the first settles.\n // The ref is the truth, read and written synchronously, so two moves inside one render can't\n // both pass; the state mirrors it to dim the card.\n const inFlight = useRef(new Set<string>());\n const [saving, setSaving] = useState<ReadonlySet<string>>(() => new Set());\n\n const movable = view.writable(\"edit\").includes(fieldName);\n // Guards only narrow: the view's rule AND the screen's own `can`.\n // A read-only or scope field moves no card, whatever the row's guards say.\n const canMove = (row: T): true | string => {\n if (!movable) return words.notAllowed;\n if (can && !can(\"edit\", row)) return words.notAllowed;\n return view.can(\"update\", row as T & DataRow, viewer);\n };\n const tones = view.definition.fields?.[fieldName as never]?.tones as Readonly<Record<string, ViewTone>> | undefined;\n\n const columns: ViewBoardColumn<T>[] = board.columns.map((c) => {\n const tone = c.value === BOARD_NONE ? undefined : tones?.[c.value];\n return {\n value: c.value,\n label: c.value === BOARD_NONE ? words.noValue : view.valueLabel(fieldName, c.value),\n ...(tone ? { tone } : {}),\n items: c.items as T[],\n ...(c.total !== undefined ? { total: c.total } : {}),\n hasMore: c.hasMore,\n loading: c.loading,\n ...(limits?.[c.value] !== undefined ? { limit: limits[c.value] } : {}),\n };\n });\n\n const move = async (row: T, to: string) => {\n const key = keyOf(row);\n if (inFlight.current.has(key)) throw new Error(words.stillSaving(titleOf(row)));\n inFlight.current.add(key);\n setRefusal(null);\n // A custom board's own drop handler calls `move` directly: the field and the guards are\n // checked here, not only by what draws the cards.\n const verdict = canMove(row);\n setSaving(new Set(inFlight.current));\n const data = { [fieldName]: stored(to) };\n try {\n if (verdict !== true) throw new Error(verdict);\n await update(key, data as Partial<T & BaseRecord>);\n } catch (error) {\n const found = onMoveError ? null : writeConflict(error, data, { changed: [fieldName] });\n if (onMoveError) onMoveError(error, row);\n else if (found) {\n // Gone before the conflict came back (a route change mid-save): say so rather than drop it.\n if (mounted.current) setConflict({ conflict: found, id: key, data });\n else onLostConflict?.(error);\n } else if (isDataWriteError(error) && error.code === NO_ROWS_MATCHED) setRefusal(words.notChanged(view.noun));\n else setRefusal(error instanceof Error && error.message ? error.message : words.moveFailed(titleOf(row)));\n throw error;\n } finally {\n inFlight.current.delete(key);\n setSaving(new Set(inFlight.current));\n }\n };\n\n // Keep mine: the same move again, checked against the version their change left, through the\n // resource's own write path, so it's queued behind any other write of the row. A new conflict\n // replaces this one, any other failure rejects, and success clears it.\n const keepMine = async () => {\n if (!conflict) return;\n const { id, data, conflict: c } = conflict;\n if (inFlight.current.has(id)) return;\n // The retry overrides only the stale version: the field and the guards are asked again, on\n // the row as it is now (theirs), and a refusal ends the conflict with its reason.\n const verdict = canMove(c.theirs as T);\n if (verdict !== true) {\n setConflict(null);\n setRefusal(verdict);\n void refresh();\n throw new Error(verdict);\n }\n inFlight.current.add(id);\n setSaving(new Set(inFlight.current));\n try {\n await update(id, data as Partial<T & BaseRecord>, c.currentVersion != null ? { expectedVersion: c.currentVersion } : undefined);\n setConflict(null);\n } catch (error) {\n const again = writeConflict(error, data, { changed: [fieldName] });\n if (!again) throw error;\n setConflict({ conflict: again, id, data });\n void refresh();\n } finally {\n inFlight.current.delete(id);\n setSaving(new Set(inFlight.current));\n }\n };\n const takeTheirs = () => {\n setConflict(null);\n void refresh();\n };\n\n return {\n block: block as ViewBoard,\n field: fieldName,\n columns,\n loadMore: board.loadMore,\n loading: board.loading,\n error: board.error,\n ownFilterSetAside: board.ownFilterSetAside,\n movable,\n canMove,\n move,\n saving,\n refusal,\n clearRefusal: () => setRefusal(null),\n conflict,\n keepMine,\n takeTheirs,\n refresh,\n keyOf,\n titleOf,\n };\n}\n"]}
@@ -36,14 +36,6 @@ function decodeRecordKey(contract, id) {
36
36
  return out;
37
37
  }
38
38
 
39
- // src/schema/types.ts
40
- function defineResource() {
41
- return (contract) => contract;
42
- }
43
- function fieldControl(field) {
44
- return field?.control ?? field?.widget;
45
- }
46
-
47
- export { decodeRecordKey, defineResource, encodeRecordKey, fieldControl, keyFields };
48
- //# sourceMappingURL=chunk-LB6FMQQM.js.map
49
- //# sourceMappingURL=chunk-LB6FMQQM.js.map
39
+ export { decodeRecordKey, encodeRecordKey, keyFields };
40
+ //# sourceMappingURL=chunk-KV2HW4G4.js.map
41
+ //# sourceMappingURL=chunk-KV2HW4G4.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/schema/keys.ts"],"names":[],"mappings":";AAYO,SAAS,UAAU,QAAA,EAA4D;AACpF,EAAA,OAAO,OAAO,SAAS,GAAA,KAAQ,QAAA,GAAW,CAAC,QAAA,CAAS,GAAG,IAAI,QAAA,CAAS,GAAA;AACtE;AAEA,SAAS,QAAA,CAAS,KAAc,KAAA,EAAgC;AAC9D,EAAA,MAAM,KAAA,GAAQ,IAAI,KAAK,CAAA;AACvB,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,OAAO,KAAA,KAAU,UAAU,OAAO,KAAA;AACnE,EAAA,IAAI,OAAO,UAAU,QAAA,IAAY,OAAO,UAAU,SAAA,EAAW,OAAO,OAAO,KAAK,CAAA;AAChF,EAAA,MAAM,IAAI,KAAA;AAAA,IACR,qBAAqB,KAAK,CAAA,KAAA,EAAQ,UAAU,IAAA,GAAO,MAAA,GAAS,OAAO,KAAK,CAAA,2CAAA;AAAA,GAE1E;AACF;AASO,SAAS,eAAA,CACd,UACA,GAAA,EACY;AACZ,EAAA,MAAM,MAAA,GAAS,UAAU,QAAQ,CAAA;AACjC,EAAA,IAAI,OAAO,MAAA,KAAW,CAAA,EAAG,MAAM,IAAI,MAAM,4DAA4D,CAAA;AACrG,EAAA,IAAI,MAAA,CAAO,WAAW,CAAA,EAAG,OAAO,SAAS,GAAA,EAAK,MAAA,CAAO,CAAC,CAAE,CAAA;AACxD,EAAA,OAAO,IAAA,CAAK,SAAA,CAAU,MAAA,CAAO,GAAA,CAAI,CAAC,UAAU,QAAA,CAAS,GAAA,EAAK,KAAK,CAAC,CAAC,CAAA;AACnE;AAQO,SAAS,eAAA,CACd,UACA,EAAA,EACiC;AACjC,EAAA,MAAM,MAAA,GAAS,UAAU,QAAQ,CAAA;AACjC,EAAA,IAAI,OAAO,MAAA,KAAW,CAAA,EAAG,MAAM,IAAI,MAAM,4DAA4D,CAAA;AACrG,EAAA,IAAI,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG,OAAO,EAAE,CAAC,MAAA,CAAO,CAAC,CAAE,GAAG,EAAA,EAAG;AAEnD,EAAA,IAAI,MAAA;AACJ,EAAA,IAAI;AACF,IAAA,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,EAAE,CAAC,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,CAAA,EAAI,MAAA,CAAO,EAAE,CAAC,CAAA,8BAAA,EAAiC,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA,EAAA,CAAI,CAAA;AAAA,EACtF;AACA,EAAA,IACE,CAAC,MAAM,OAAA,CAAQ,MAAM,KACrB,MAAA,CAAO,MAAA,KAAW,OAAO,MAAA,IACzB,CAAC,OAAO,KAAA,CAAM,CAAC,MAAM,OAAO,CAAA,KAAM,YAAY,OAAO,CAAA,KAAM,QAAQ,CAAA,EACnE;AACA,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,CAAA,EAAI,MAAA,CAAO,EAAE,CAAC,CAAA,8BAAA,EAAiC,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA,EAAA,CAAI,CAAA;AAAA,EACtF;AACA,EAAA,MAAM,MAAuC,EAAC;AAC9C,EAAA,MAAA,CAAO,OAAA,CAAQ,CAAC,KAAA,EAAO,CAAA,KAAM;AAC3B,IAAA,GAAA,CAAI,KAAK,CAAA,GAAI,MAAA,CAAO,CAAC,CAAA;AAAA,EACvB,CAAC,CAAA;AACD,EAAA,OAAO,GAAA;AACT","file":"chunk-KV2HW4G4.js","sourcesContent":["// ---------------------------------------------------------------------------\n// Record identity for single and composite keys (DATA-STUDIO.md decision 13)\n//\n// `DataProvider` methods take one `Identifier`. A composite key travels\n// through that same slot as a canonical string, so every existing provider\n// signature stays as it is and a junction table still has one id per row.\n// ---------------------------------------------------------------------------\n\nimport type { Identifier } from \"../provider/types\";\nimport type { DataRow, ResourceContract } from \"./types\";\n\n/** The key of a contract as a list, whichever form `key` was declared in. */\nexport function keyFields(contract: Pick<ResourceContract, \"key\">): readonly string[] {\n return typeof contract.key === \"string\" ? [contract.key] : contract.key;\n}\n\nfunction keyValue(row: DataRow, field: string): string | number {\n const value = row[field];\n if (typeof value === \"string\" || typeof value === \"number\") return value;\n if (typeof value === \"bigint\" || typeof value === \"boolean\") return String(value);\n throw new Error(\n `Record key field \"${field}\" is ${value === null ? \"null\" : typeof value}; ` +\n \"a key value must be a string or a number.\",\n );\n}\n\n/**\n * One `Identifier` for a row.\n *\n * A single-field key returns the raw value, so `id`-keyed resources look\n * exactly as they always have. A composite key returns a JSON array of the\n * values in key order, e.g. `'[\"c-1\",\"u-7\"]'`.\n */\nexport function encodeRecordKey(\n contract: Pick<ResourceContract, \"key\">,\n row: DataRow,\n): Identifier {\n const fields = keyFields(contract);\n if (fields.length === 0) throw new Error(\"This resource has no key, so its rows cannot be addressed.\");\n if (fields.length === 1) return keyValue(row, fields[0]!);\n return JSON.stringify(fields.map((field) => keyValue(row, field)));\n}\n\n/**\n * The inverse of {@link encodeRecordKey}: field name → value.\n *\n * Throws on an id that does not fit the key, rather than guessing, because a\n * guessed key addresses the wrong row.\n */\nexport function decodeRecordKey(\n contract: Pick<ResourceContract, \"key\">,\n id: Identifier,\n): Record<string, string | number> {\n const fields = keyFields(contract);\n if (fields.length === 0) throw new Error(\"This resource has no key, so its rows cannot be addressed.\");\n if (fields.length === 1) return { [fields[0]!]: id };\n\n let parsed: unknown;\n try {\n parsed = JSON.parse(String(id));\n } catch {\n throw new Error(`\"${String(id)}\" is not a composite key for (${fields.join(\", \")}).`);\n }\n if (\n !Array.isArray(parsed) ||\n parsed.length !== fields.length ||\n !parsed.every((v) => typeof v === \"string\" || typeof v === \"number\")\n ) {\n throw new Error(`\"${String(id)}\" is not a composite key for (${fields.join(\", \")}).`);\n }\n const out: Record<string, string | number> = {};\n fields.forEach((field, i) => {\n out[field] = parsed[i] as string | number;\n });\n return out;\n}\n"]}
@@ -1,4 +1,4 @@
1
- import { useDataProvider } from './chunk-R3YXYVWF.js';
1
+ import { useDataProvider } from './chunk-OIZNABG4.js';
2
2
  import { useQuery } from '@tanstack/react-query';
3
3
 
4
4
  var providerIds = /* @__PURE__ */ new WeakMap();
@@ -27,5 +27,5 @@ function useCapabilities(resource, options = {}) {
27
27
  }
28
28
 
29
29
  export { capabilitiesQueryKey, useCapabilities };
30
- //# sourceMappingURL=chunk-42NVJJTT.js.map
31
- //# sourceMappingURL=chunk-42NVJJTT.js.map
30
+ //# sourceMappingURL=chunk-MMMC37AP.js.map
31
+ //# sourceMappingURL=chunk-MMMC37AP.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/hooks/use-capabilities.ts"],"names":[],"mappings":";;;AAMA,IAAM,WAAA,uBAAkB,OAAA,EAAwB;AAChD,IAAI,cAAA,GAAiB,CAAA;AAErB,SAAS,WAAW,QAAA,EAA0B;AAC5C,EAAA,IAAI,EAAA,GAAK,WAAA,CAAY,GAAA,CAAI,QAAQ,CAAA;AACjC,EAAA,IAAI,OAAO,MAAA,EAAW;AACpB,IAAA,EAAA,GAAK,cAAA,EAAA;AACL,IAAA,WAAA,CAAY,GAAA,CAAI,UAAU,EAAE,CAAA;AAAA,EAC9B;AACA,EAAA,OAAO,EAAA;AACT;AAQO,SAAS,oBAAA,CAAqB,UAAkB,QAAA,EAAkD;AACvG,EAAA,OAAO,CAAC,gBAAA,EAAkB,UAAA,CAAW,QAAQ,CAAA,EAAG,YAAY,EAAE,CAAA;AAChE;AAOO,SAAS,eAAA,CACd,QAAA,EACA,OAAA,GAAiC,EAAC,EACI;AACtC,EAAA,MAAM,WAAW,eAAA,EAAgB;AACjC,EAAA,OAAO,QAAA,CAA+B;AAAA,IACpC,QAAA,EAAU,oBAAA,CAAqB,QAAA,EAAU,QAAQ,CAAA;AAAA,IACjD,OAAA,EAAS,MAAM,QAAA,CAAS,YAAA,CAAc,QAAQ,CAAA;AAAA,IAC9C,UAAU,OAAA,CAAQ,OAAA,IAAW,IAAA,KAAS,CAAC,CAAC,QAAA,CAAS,YAAA;AAAA;AAAA;AAAA,IAGjD,SAAA,EAAW;AAAA,GACZ,CAAA;AACH","file":"chunk-42NVJJTT.js","sourcesContent":["import { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type { ProviderCapabilities } from \"../schema/types\";\n\n// A stable id per provider object, so capabilities cached for one provider\n// are never served for another that shares the same QueryClient.\nconst providerIds = new WeakMap<object, number>();\nlet nextProviderId = 1;\n\nfunction providerId(provider: object): number {\n let id = providerIds.get(provider);\n if (id === undefined) {\n id = nextProviderId++;\n providerIds.set(provider, id);\n }\n return id;\n}\n\n/**\n * The query key for `provider`'s capabilities for `resource`. It includes\n * the provider's identity: swapping the provider (another tenant, a\n * different store) asks the new one instead of reusing the old answer.\n * @internal\n */\nexport function capabilitiesQueryKey(provider: object, resource: string | undefined): readonly unknown[] {\n return [\"__capabilities\", providerId(provider), resource ?? \"\"];\n}\n\n/**\n * What the data provider can do for `resource` (`provider.capabilities`),\n * cached per provider and resource. `data` stays undefined for a provider\n * that doesn't report capabilities, so a UI keeps its defaults.\n */\nexport function useCapabilities(\n resource: string | undefined,\n options: { enabled?: boolean } = {},\n): UseQueryResult<ProviderCapabilities> {\n const provider = useDataProvider();\n return useQuery<ProviderCapabilities>({\n queryKey: capabilitiesQueryKey(provider, resource),\n queryFn: () => provider.capabilities!(resource),\n enabled: (options.enabled ?? true) && !!provider.capabilities,\n // Fresh for as long as this provider is in use; a swapped-out provider's\n // entry has no observers and is collected after the usual gcTime.\n staleTime: Infinity,\n });\n}\n"]}
1
+ {"version":3,"sources":["../src/hooks/use-capabilities.ts"],"names":[],"mappings":";;;AAMA,IAAM,WAAA,uBAAkB,OAAA,EAAwB;AAChD,IAAI,cAAA,GAAiB,CAAA;AAErB,SAAS,WAAW,QAAA,EAA0B;AAC5C,EAAA,IAAI,EAAA,GAAK,WAAA,CAAY,GAAA,CAAI,QAAQ,CAAA;AACjC,EAAA,IAAI,OAAO,MAAA,EAAW;AACpB,IAAA,EAAA,GAAK,cAAA,EAAA;AACL,IAAA,WAAA,CAAY,GAAA,CAAI,UAAU,EAAE,CAAA;AAAA,EAC9B;AACA,EAAA,OAAO,EAAA;AACT;AAQO,SAAS,oBAAA,CAAqB,UAAkB,QAAA,EAAkD;AACvG,EAAA,OAAO,CAAC,gBAAA,EAAkB,UAAA,CAAW,QAAQ,CAAA,EAAG,YAAY,EAAE,CAAA;AAChE;AAOO,SAAS,eAAA,CACd,QAAA,EACA,OAAA,GAAiC,EAAC,EACI;AACtC,EAAA,MAAM,WAAW,eAAA,EAAgB;AACjC,EAAA,OAAO,QAAA,CAA+B;AAAA,IACpC,QAAA,EAAU,oBAAA,CAAqB,QAAA,EAAU,QAAQ,CAAA;AAAA,IACjD,OAAA,EAAS,MAAM,QAAA,CAAS,YAAA,CAAc,QAAQ,CAAA;AAAA,IAC9C,UAAU,OAAA,CAAQ,OAAA,IAAW,IAAA,KAAS,CAAC,CAAC,QAAA,CAAS,YAAA;AAAA;AAAA;AAAA,IAGjD,SAAA,EAAW;AAAA,GACZ,CAAA;AACH","file":"chunk-MMMC37AP.js","sourcesContent":["import { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type { ProviderCapabilities } from \"../schema/types\";\n\n// A stable id per provider object, so capabilities cached for one provider\n// are never served for another that shares the same QueryClient.\nconst providerIds = new WeakMap<object, number>();\nlet nextProviderId = 1;\n\nfunction providerId(provider: object): number {\n let id = providerIds.get(provider);\n if (id === undefined) {\n id = nextProviderId++;\n providerIds.set(provider, id);\n }\n return id;\n}\n\n/**\n * The query key for `provider`'s capabilities for `resource`. It includes\n * the provider's identity: swapping the provider (another tenant, a\n * different store) asks the new one instead of reusing the old answer.\n * @internal\n */\nexport function capabilitiesQueryKey(provider: object, resource: string | undefined): readonly unknown[] {\n return [\"__capabilities\", providerId(provider), resource ?? \"\"];\n}\n\n/**\n * What the data provider can do for `resource` (`provider.capabilities`),\n * cached per provider and resource. `data` stays undefined for a provider\n * that doesn't report capabilities, so a UI keeps its defaults.\n */\nexport function useCapabilities(\n resource: string | undefined,\n options: { enabled?: boolean } = {},\n): UseQueryResult<ProviderCapabilities> {\n const provider = useDataProvider();\n return useQuery<ProviderCapabilities>({\n queryKey: capabilitiesQueryKey(provider, resource),\n queryFn: () => provider.capabilities!(resource),\n enabled: (options.enabled ?? true) && !!provider.capabilities,\n // Fresh for as long as this provider is in use; a swapped-out provider's\n // entry has no observers and is collected after the usual gcTime.\n staleTime: Infinity,\n });\n}\n"]}
@@ -0,0 +1,96 @@
1
+ import { filterValueFor } from './chunk-6JOWGO2X.js';
2
+
3
+ // src/resource-view/saved-views.ts
4
+ var isObject = (v) => Boolean(v) && typeof v === "object" && !Array.isArray(v);
5
+ function parse(raw, check) {
6
+ if (!raw) return void 0;
7
+ try {
8
+ const value = JSON.parse(raw);
9
+ return check(value) ? value : void 0;
10
+ } catch {
11
+ return void 0;
12
+ }
13
+ }
14
+ var isSaved = (v) => isObject(v) && typeof v.id === "string" && typeof v.name === "string" && typeof v.resource === "string" && isObject(v.state) && (v.scope === "personal" || v.scope === "team");
15
+ function defaultStorage() {
16
+ try {
17
+ const storage = globalThis.localStorage;
18
+ if (!storage) return void 0;
19
+ storage.getItem("__genesis_probe__");
20
+ return storage;
21
+ } catch {
22
+ return void 0;
23
+ }
24
+ }
25
+ function createLocalSavedViewStore(options = {}) {
26
+ return localStore(options, /* @__PURE__ */ new Map(), /* @__PURE__ */ new Map());
27
+ }
28
+ function localStore(options, memory, viewers) {
29
+ const prefix = options.prefix ?? "genesis-saved-views";
30
+ const storage = () => options.storage ?? defaultStorage() ?? { getItem: (k) => memory.get(k) ?? null, setItem: (k, v) => void memory.set(k, v), removeItem: (k) => void memory.delete(k) };
31
+ const refused = /* @__PURE__ */ new Map();
32
+ const get = (key) => refused.has(key) ? refused.get(key) : storage().getItem(key);
33
+ const put = (key, value) => {
34
+ try {
35
+ if (value === null) storage().removeItem(key);
36
+ else storage().setItem(key, value);
37
+ refused.delete(key);
38
+ } catch {
39
+ refused.set(key, value);
40
+ }
41
+ };
42
+ const read = (resource) => parse(get(`${prefix}:${resource}`), (v) => Array.isArray(v))?.filter(isSaved) ?? [];
43
+ const write = (resource, views) => put(`${prefix}:${resource}`, views.length ? JSON.stringify(views) : null);
44
+ let seq = 0;
45
+ return Object.freeze({
46
+ scopes: Object.freeze(["personal"]),
47
+ list: (resource) => read(resource),
48
+ save: (input) => {
49
+ const id = input.id ?? `view-${Date.now().toString(36)}-${(seq++).toString(36)}`;
50
+ const saved = Object.freeze({ ...input, id, scope: "personal" });
51
+ write(input.resource, [...read(input.resource).filter((v) => v.id !== id), saved]);
52
+ return saved;
53
+ },
54
+ remove: (id, resource) => write(resource, read(resource).filter((v) => v.id !== id)),
55
+ readCurrent: (key) => parse(get(`${prefix}:current:${key}`), isObject),
56
+ writeCurrent: (key, state) => put(`${prefix}:current:${key}`, JSON.stringify(state)),
57
+ forViewer: (viewer) => {
58
+ const id = `${options.prefix ?? "genesis-saved-views"}:viewer:${encodeURIComponent(viewer ?? "signed-out")}`;
59
+ let store = viewers.get(id);
60
+ if (!store) {
61
+ store = localStore({ ...options, prefix: id }, memory, viewers);
62
+ viewers.set(id, store);
63
+ }
64
+ return store;
65
+ }
66
+ });
67
+ }
68
+ function applicableListState(view, state) {
69
+ if (!state || !isObject(state)) return {};
70
+ const out = {};
71
+ if (typeof state.segment === "string" && view.segments().some((s) => s.id === state.segment)) out.segment = state.segment;
72
+ if (isObject(state.filters)) {
73
+ const declared = new Map(view.filters().map((f) => [f.field, f]));
74
+ const kept = Object.fromEntries(
75
+ Object.entries(state.filters).flatMap(([field, value]) => {
76
+ const filter = declared.get(field);
77
+ const clean = filter ? filterValueFor(filter, value) : void 0;
78
+ return clean === void 0 ? [] : [[field, clean]];
79
+ })
80
+ );
81
+ if (Object.keys(kept).length) out.filters = kept;
82
+ }
83
+ if (typeof state.search === "string" && state.search.trim()) out.search = state.search.slice(0, 200);
84
+ if (isObject(state.sort) && typeof state.sort.field === "string" && view.field(state.sort.field) && (state.sort.order === "asc" || state.sort.order === "desc")) {
85
+ out.sort = { field: state.sort.field, order: state.sort.order };
86
+ }
87
+ if (typeof state.columns === "string" && view.presets.includes(state.columns)) out.columns = state.columns;
88
+ if (typeof state.type === "string" && view.types().includes(state.type)) out.type = state.type;
89
+ if (state.groupBy === null) out.groupBy = null;
90
+ else if (typeof state.groupBy === "string" && view.field(state.groupBy)) out.groupBy = state.groupBy;
91
+ return out;
92
+ }
93
+
94
+ export { applicableListState, createLocalSavedViewStore };
95
+ //# sourceMappingURL=chunk-MZVFOTAE.js.map
96
+ //# sourceMappingURL=chunk-MZVFOTAE.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/resource-view/saved-views.ts"],"names":[],"mappings":"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","file":"chunk-MZVFOTAE.js","sourcesContent":["// Saved views (ADR 0017 §4): a person's or a team's stored list state, kept by a store the app\n// provides. Genesis ships a device store; an app supplies a server one over its own table under\n// row-level security. Genesis keeps no table for it.\n\nimport type { StorageAdapter } from \"../storage/types\";\nimport type { ResolvedFilter } from \"./types\";\nimport { filterValueFor, type ListState } from \"./list-state\";\n\n/**\n * One saved view: a name, who it's for, and the list state it restores, stamped with the view's\n * `version` when it was saved.\n *\n * @stability Beta\n */\nexport interface SavedView {\n readonly id: string;\n readonly name: string;\n /** `personal` (the person's own) or `team` (shared, as the app's store decides). */\n readonly scope: \"personal\" | \"team\";\n /** The view's resource. */\n readonly resource: string;\n /** The view's `version` when it was saved (1 when the view has none). */\n readonly version: number;\n readonly state: ListState;\n}\n\n/** A saved view to store: the store gives it its id. @stability Beta */\nexport type SavedViewInput = Omit<SavedView, \"id\"> & { readonly id?: string };\n\n/**\n * Where saved views live (ADR 0017 §4). Passed once to genesis-ui's `ResourceViewDefaultsProvider`\n * (`savedViews`). Every method may be async. `readCurrent` and `writeCurrent`, when the store has\n * them, keep each person's current choices for a list (its view type, say), so they follow the\n * person the way saved views do.\n *\n * A store returns only the views the signed-in person may see: a server store scopes its rows to\n * the viewer (row-level security on the app's table: their own personal views, and team views of\n * their team). A store kept on a device that several people sign in to has `forViewer`, and lists\n * call it with the viewer's id, so one person never sees another's views.\n *\n * @stability Beta\n */\nexport interface SavedViewStore {\n list(resource: string): readonly SavedView[] | Promise<readonly SavedView[]>;\n save(view: SavedViewInput): SavedView | Promise<SavedView>;\n remove(id: string, resource: string): void | Promise<void>;\n /** Which scopes this store can save to. Default `[\"personal\"]`. */\n readonly scopes?: readonly (\"personal\" | \"team\")[];\n /** The person's current state for a list (its key: the resource, or a screen's own key). */\n readCurrent?(key: string): ListState | null | undefined | Promise<ListState | null | undefined>;\n writeCurrent?(key: string, state: ListState): void | Promise<void>;\n /** The store for one viewer (their id, or null signed out), for a store kept on a shared device. */\n forViewer?(viewer: string | null): SavedViewStore;\n}\n\nconst isObject = (v: unknown): v is Record<string, unknown> => Boolean(v) && typeof v === \"object\" && !Array.isArray(v);\n\nfunction parse<T>(raw: string | null, check: (v: unknown) => v is T): T | undefined {\n if (!raw) return undefined;\n try {\n const value: unknown = JSON.parse(raw);\n return check(value) ? value : undefined;\n } catch {\n return undefined;\n }\n}\n\nconst isSaved = (v: unknown): v is SavedView =>\n isObject(v) && typeof v.id === \"string\" && typeof v.name === \"string\" && typeof v.resource === \"string\" && isObject(v.state) && (v.scope === \"personal\" || v.scope === \"team\");\n\nfunction defaultStorage(): StorageAdapter | undefined {\n try {\n const storage = (globalThis as { localStorage?: StorageAdapter }).localStorage;\n if (!storage) return undefined;\n // Reading can throw (a private window, storage turned off): such a store keeps nothing.\n storage.getItem(\"__genesis_probe__\");\n return storage;\n } catch {\n return undefined;\n }\n}\n\n/**\n * The default saved-view store: this device only, personal views, under `<prefix>:<resource>`\n * in the browser's localStorage (or the storage you pass, such as a phone's adapter). Without\n * storage it keeps views in memory for the page's life. Lists use `forViewer(id)`, which keeps\n * each person's views under `<prefix>:<viewer>:…`, so whoever signs in next on the device sees\n * only their own.\n *\n * ```ts\n * <ResourceViewDefaultsProvider savedViews={createLocalSavedViewStore()} />\n * ```\n *\n * @stability Beta\n */\nexport function createLocalSavedViewStore(options: { storage?: StorageAdapter; prefix?: string } = {}): SavedViewStore {\n return localStore(options, new Map(), new Map());\n}\n\nfunction localStore(options: { storage?: StorageAdapter; prefix?: string }, memory: Map<string, string>, viewers: Map<string, SavedViewStore>): SavedViewStore {\n const prefix = options.prefix ?? \"genesis-saved-views\";\n const storage = (): StorageAdapter =>\n options.storage ??\n defaultStorage() ?? { getItem: (k) => memory.get(k) ?? null, setItem: (k, v) => void memory.set(k, v), removeItem: (k) => void memory.delete(k) };\n // A write storage refused (full, or turned off) is kept here for the page's life, and read back\n // over storage's older copy until a later write of the same key is accepted.\n const refused = new Map<string, string | null>();\n const get = (key: string): string | null => (refused.has(key) ? refused.get(key)! : storage().getItem(key));\n const put = (key: string, value: string | null) => {\n try {\n if (value === null) storage().removeItem(key);\n else storage().setItem(key, value);\n refused.delete(key);\n } catch {\n refused.set(key, value);\n }\n };\n const read = (resource: string): SavedView[] =>\n parse(get(`${prefix}:${resource}`), (v): v is unknown[] => Array.isArray(v))?.filter(isSaved) ?? [];\n const write = (resource: string, views: readonly SavedView[]) => put(`${prefix}:${resource}`, views.length ? JSON.stringify(views) : null);\n let seq = 0;\n return Object.freeze({\n scopes: Object.freeze([\"personal\" as const]),\n list: (resource: string) => read(resource),\n save: (input: SavedViewInput): SavedView => {\n const id = input.id ?? `view-${Date.now().toString(36)}-${(seq++).toString(36)}`;\n const saved: SavedView = Object.freeze({ ...input, id, scope: \"personal\" as const });\n write(input.resource, [...read(input.resource).filter((v) => v.id !== id), saved]);\n return saved;\n },\n remove: (id: string, resource: string) => write(resource, read(resource).filter((v) => v.id !== id)),\n readCurrent: (key: string) => parse(get(`${prefix}:current:${key}`), isObject) as ListState | undefined,\n writeCurrent: (key: string, state: ListState) => put(`${prefix}:current:${key}`, JSON.stringify(state)),\n forViewer: (viewer: string | null): SavedViewStore => {\n // Under the store's own prefix: a viewer id can't reach another prefix's keys.\n const id = `${options.prefix ?? \"genesis-saved-views\"}:viewer:${encodeURIComponent(viewer ?? \"signed-out\")}`;\n let store = viewers.get(id);\n if (!store) {\n store = localStore({ ...options, prefix: id }, memory, viewers);\n viewers.set(id, store);\n }\n return store;\n },\n });\n}\n\n/**\n * The part of a stored list state that still applies to a view: a segment it still has, filters\n * it still declares, a column preset and view type it still offers, a field it can still group by.\n * A saved view from an older `version` is offered as far as it applies, never refused whole.\n *\n * @stability Beta\n */\nexport function applicableListState(\n view: {\n filters(): readonly ResolvedFilter[];\n segments(): readonly { id: string }[];\n presets: readonly string[];\n types(): readonly string[];\n field(name: string): unknown;\n },\n state: ListState | null | undefined,\n): ListState {\n if (!state || !isObject(state)) return {};\n const out: { -readonly [K in keyof ListState]: ListState[K] } = {};\n if (typeof state.segment === \"string\" && view.segments().some((s) => s.id === state.segment)) out.segment = state.segment;\n if (isObject(state.filters)) {\n const declared = new Map(view.filters().map((f) => [f.field, f]));\n const kept = Object.fromEntries(\n Object.entries(state.filters).flatMap(([field, value]) => {\n const filter = declared.get(field);\n const clean = filter ? filterValueFor(filter, value) : undefined;\n return clean === undefined ? [] : [[field, clean]];\n }),\n );\n if (Object.keys(kept).length) out.filters = kept as ListState[\"filters\"];\n }\n if (typeof state.search === \"string\" && state.search.trim()) out.search = state.search.slice(0, 200);\n if (isObject(state.sort) && typeof state.sort.field === \"string\" && view.field(state.sort.field) && (state.sort.order === \"asc\" || state.sort.order === \"desc\")) {\n out.sort = { field: state.sort.field, order: state.sort.order };\n }\n if (typeof state.columns === \"string\" && view.presets.includes(state.columns)) out.columns = state.columns;\n if (typeof state.type === \"string\" && view.types().includes(state.type)) out.type = state.type;\n if (state.groupBy === null) out.groupBy = null;\n else if (typeof state.groupBy === \"string\" && view.field(state.groupBy)) out.groupBy = state.groupBy;\n return out;\n}\n"]}
@@ -209,7 +209,7 @@ function GenesisProvider({
209
209
  );
210
210
  const resolvedStorage = storage ?? defaultStorage;
211
211
  const restored = useRestoredReads(queryClient, persist, persistScope);
212
- return /* @__PURE__ */ jsx(QueryClientProvider, { client: queryClient, children: /* @__PURE__ */ jsx(StorageContext.Provider, { value: resolvedStorage, children: /* @__PURE__ */ jsx(DataProviderRoot, { provider: resolvedProvider, children: /* @__PURE__ */ jsx(PersistedViewerContext.Provider, { value: persist && typeof persistScope === "string" ? userOf(persistScope) : void 0, children: restored ? children : null }) }) }) });
212
+ return /* @__PURE__ */ jsx(QueryClientProvider, { client: queryClient, children: /* @__PURE__ */ jsx(StorageContext.Provider, { value: resolvedStorage, children: /* @__PURE__ */ jsx(DataProviderRoot, { provider: resolvedProvider, children: /* @__PURE__ */ jsx(PersistedViewerContext.Provider, { value: persist && typeof persistScope === "string" ? userOf(persistScope) : void 0, children: /* @__PURE__ */ jsx(PersistedClientContext.Provider, { value: queryClient, children: restored ? children : null }) }) }) }) });
213
213
  }
214
214
  var RESTORE_WAIT_MS = 400;
215
215
  var userOf = (scope) => scope.startsWith("u:") ? scope.slice(2, scope.indexOf("|") < 0 ? void 0 : scope.indexOf("|")) : scope;
@@ -257,7 +257,8 @@ function useRestoredReads(queryClient, persist, scope) {
257
257
  return ready;
258
258
  }
259
259
  var PersistedViewerContext = createContext(void 0);
260
+ var PersistedClientContext = createContext(void 0);
260
261
 
261
- export { DataProviderRoot, GenesisProvider, PersistedViewerContext, createMockProvider, useDataProvider, useStorage };
262
- //# sourceMappingURL=chunk-R3YXYVWF.js.map
263
- //# sourceMappingURL=chunk-R3YXYVWF.js.map
262
+ export { DataProviderRoot, GenesisProvider, PersistedClientContext, PersistedViewerContext, createMockProvider, useDataProvider, useStorage };
263
+ //# sourceMappingURL=chunk-OIZNABG4.js.map
264
+ //# sourceMappingURL=chunk-OIZNABG4.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/provider/mock-provider.ts","../src/provider/context.tsx"],"names":[],"mappings":"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","file":"chunk-OIZNABG4.js","sourcesContent":["import type {\n DataProvider,\n ListParams,\n FilterParam,\n} from \"./types\";\nimport { toAggregateValues } from \"./aggregate\";\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, nulls } of sorts) {\n if (nulls && (a[field] == null) !== (b[field] == null)) {\n return (a[field] == null) === (nulls === \"first\") ? -1 : 1;\n }\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 aggregate(_resource, params) {\n const { data } = applyListParams(getTable(_resource), { filters: params.filters, search: params.search });\n return withDelay({ values: toAggregateValues(data, params.metrics) });\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 <PersistedClientContext.Provider value={queryClient}>{restored ? children : null}</PersistedClientContext.Provider>\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/**\n * The QueryClient those reads were restored into. A `ViewerScope` keeps a cache for the persisted\n * viewer only when it's this one: another client under a nested QueryClientProvider was never\n * restored for that person. Internal.\n */\nexport const PersistedClientContext = createContext<unknown>(undefined);\n\n"]}
@@ -1,11 +1,14 @@
1
- import { useLiveInvalidation } from './chunk-E3K2A3PK.js';
1
+ import { useLiveInvalidation } from './chunk-6SHGMEA6.js';
2
2
  import { resourceKeys } from './chunk-2IGAUXYH.js';
3
- import { useDataProvider } from './chunk-R3YXYVWF.js';
3
+ import { useDataProvider } from './chunk-OIZNABG4.js';
4
+ import { useMemo } from 'react';
4
5
  import { useQuery } from '@tanstack/react-query';
5
6
 
6
7
  function useOne(resource, id, options = {}) {
7
8
  const provider = useDataProvider();
8
9
  const { select, enabled, live } = options;
10
+ const scopeKey = JSON.stringify((options.scope ?? []).filter((f) => f.operator !== "contains"));
11
+ const scope = useMemo(() => JSON.parse(scopeKey), [scopeKey]);
9
12
  const isEnabled = enabled ?? !!id;
10
13
  useLiveInvalidation(
11
14
  resource,
@@ -24,10 +27,10 @@ function useOne(resource, id, options = {}) {
24
27
  // — no error, no refetch, just absent data. `useResource`'s list key has
25
28
  // always included `select` (it keys on the whole `params` object); this
26
29
  // was the one place it did not.
27
- queryKey: resourceKeys(resource).detail(id, select),
30
+ queryKey: scope?.length ? [...resourceKeys(resource).detail(id, select), { scope }] : resourceKeys(resource).detail(id, select),
28
31
  queryFn: async () => {
29
32
  if (id == null) throw new Error("Missing id");
30
- const result = await provider.getOne(resource, { id, select });
33
+ const result = await provider.getOne(resource, { id, select, ...scope?.length ? { scope } : {} });
31
34
  return result.data;
32
35
  },
33
36
  enabled: isEnabled
@@ -35,5 +38,5 @@ function useOne(resource, id, options = {}) {
35
38
  }
36
39
 
37
40
  export { useOne };
38
- //# sourceMappingURL=chunk-QGWQ6LK3.js.map
39
- //# sourceMappingURL=chunk-QGWQ6LK3.js.map
41
+ //# sourceMappingURL=chunk-QJOKZZKY.js.map
42
+ //# sourceMappingURL=chunk-QJOKZZKY.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/hooks/use-one.ts"],"names":[],"mappings":";;;;;;AAwCO,SAAS,MAAA,CACd,QAAA,EACA,EAAA,EACA,OAAA,GAAyB,EAAC,EACP;AACnB,EAAA,MAAM,WAAW,eAAA,EAAgB;AAEjC,EAAA,MAAM,EAAE,MAAA,EAAQ,OAAA,EAAS,IAAA,EAAK,GAAI,OAAA;AAIlC,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,SAAA,CAAA,CAAW,OAAA,CAAQ,KAAA,IAAS,EAAC,EAAG,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,QAAA,KAAa,UAAU,CAAC,CAAA;AAC9F,EAAA,MAAM,KAAA,GAAQ,QAAQ,MAAM,IAAA,CAAK,MAAM,QAAQ,CAAA,EAAoB,CAAC,QAAQ,CAAC,CAAA;AAC7E,EAAA,MAAM,SAAA,GAAY,OAAA,IAAW,CAAC,CAAC,EAAA;AAG/B,EAAA,mBAAA;AAAA,IACE,QAAA;AAAA,IACA,IAAA;AAAA,IACA,aAAa,EAAA,IAAM,IAAA;AAAA,IACnB,EAAA,IAAM,IAAA,GAAO,EAAE,EAAA,KAAO,EAAC;AAAA,IACvB,YAAA,CAAa,QAAQ,CAAA,CAAE,SAAA,CAAU,EAAE,CAAA;AAAA,IACnC,CAAC,KAAA,KAAU,KAAA,CAAM,IAAA,KAAS,SAAA,IAAa,EAAE,IAAA,IAAQ,KAAA,CAAA,IAAU,KAAA,CAAM,EAAA,IAAM,QAAQ,MAAA,CAAO,KAAA,CAAM,EAAE,CAAA,KAAM,OAAO,EAAE;AAAA,GAC/G;AAEA,EAAA,OAAO,QAAA,CAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASjB,QAAA,EAAU,OAAO,MAAA,GAAS,CAAC,GAAG,YAAA,CAAa,QAAQ,EAAE,MAAA,CAAO,EAAA,EAAI,MAAM,CAAA,EAAG,EAAE,OAAO,CAAA,GAAI,aAAa,QAAQ,CAAA,CAAE,MAAA,CAAO,EAAA,EAAI,MAAM,CAAA;AAAA,IAC9H,SAAS,YAAY;AACnB,MAAA,IAAI,EAAA,IAAM,IAAA,EAAM,MAAM,IAAI,MAAM,YAAY,CAAA;AAC5C,MAAA,MAAM,SAAS,MAAM,QAAA,CAAS,MAAA,CAAU,QAAA,EAAU,EAAE,EAAA,EAAI,MAAA,EAAQ,GAAI,KAAA,EAAO,SAAS,EAAE,KAAA,EAAM,GAAI,IAAK,CAAA;AACrG,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB,CAAA;AAAA,IACA,OAAA,EAAS;AAAA,GACV,CAAA;AACH","file":"chunk-QJOKZZKY.js","sourcesContent":["import { useMemo } from \"react\";\nimport { useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type { BaseRecord, FilterParam, Identifier } from \"../provider/types\";\nimport { useLiveInvalidation, type LiveOptions } from \"./use-live\";\nimport { resourceKeys } from \"../query-keys\";\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface UseOneOptions {\n /** Supabase select/join syntax, e.g. \"*, author:profiles(name)\". */\n select?: string;\n /** Defaults to `!!id` — won't fetch when id is falsy. */\n enabled?: boolean;\n /**\n * Keep the record current while mounted: refetch it when the provider\n * reports a change to it (`DataProvider.subscribe`). See\n * `UseResourceOptions.live`. Off by default.\n */\n live?: boolean | LiveOptions;\n /**\n * The list's filters, when the record is opened from a list (`GetOneParams.scope`): a resource\n * read from a function takes its scope from them. Text searches (`contains`) are left out; the\n * rest are kept, and they're part of the cache key when there are any.\n */\n scope?: FilterParam[] | undefined;\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\n/**\n * Fetch a single record by id, powered by TanStack Query.\n *\n * Returns the full `UseQueryResult<T>` with the data unwrapped from the\n * provider's `GetOneResult` wrapper.\n */\nexport function useOne<T extends BaseRecord = BaseRecord>(\n resource: string,\n id: Identifier | undefined | null,\n options: UseOneOptions = {},\n): UseQueryResult<T> {\n const provider = useDataProvider();\n\n const { select, enabled, live } = options;\n // The list's filters as a function source's `args` gets them (`filters`, `take`), less a text\n // search: `contains` narrows a list, never a scope, and keeping it would make a new record read\n // per keystroke. An `in` scope (a link filter, a multi-value segment) and ranges stay.\n const scopeKey = JSON.stringify((options.scope ?? []).filter((f) => f.operator !== \"contains\"));\n const scope = useMemo(() => JSON.parse(scopeKey) as FilterParam[], [scopeKey]);\n const isEnabled = enabled ?? !!id;\n\n // Only this record's events; `changed` (events may have been missed) too.\n useLiveInvalidation(\n resource,\n live,\n isEnabled && id != null,\n id != null ? { id } : {},\n resourceKeys(resource).detailsOf(id),\n (event) => event.type === \"changed\" || !(\"id\" in event) || event.id == null || String(event.id) === String(id),\n );\n\n return useQuery<T>({\n // `select` is part of the key because it is part of the REQUEST: two pages\n // asking for the same record with different projections get different\n // rows back, and keying only on the id makes them share one cache entry.\n // Whichever mounted first wins for the whole staleTime window, and the\n // other silently renders a record missing the joined fields it asked for\n // — no error, no refetch, just absent data. `useResource`'s list key has\n // always included `select` (it keys on the whole `params` object); this\n // was the one place it did not.\n queryKey: scope?.length ? [...resourceKeys(resource).detail(id, select), { scope }] : resourceKeys(resource).detail(id, select),\n queryFn: async () => {\n if (id == null) throw new Error(\"Missing id\");\n const result = await provider.getOne<T>(resource, { id, select, ...(scope?.length ? { scope } : {}) });\n return result.data;\n },\n enabled: isEnabled,\n });\n}\n"]}