@marktiderman/genesis-core 1.11.0 → 1.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.
- package/README.md +34 -0
- package/dist/chunk-3B4IFDMK.js +117 -0
- package/dist/chunk-3B4IFDMK.js.map +1 -0
- package/dist/chunk-7FVTGKTX.js +8 -0
- package/dist/chunk-7FVTGKTX.js.map +1 -0
- package/dist/chunk-AUVKRXRC.js +81 -0
- package/dist/chunk-AUVKRXRC.js.map +1 -0
- package/dist/chunk-FARKPY6R.js +66 -0
- package/dist/chunk-FARKPY6R.js.map +1 -0
- package/dist/{chunk-OSPLIKSH.js → chunk-GEF5W2LO.js} +19 -9
- package/dist/chunk-GEF5W2LO.js.map +1 -0
- package/dist/{chunk-NMFABW4Y.js → chunk-JKZ2FVWK.js} +5 -5
- package/dist/{chunk-NMFABW4Y.js.map → chunk-JKZ2FVWK.js.map} +1 -1
- package/dist/{chunk-RCAP3Q4T.js → chunk-OYIUIW7C.js} +3 -2
- package/dist/chunk-OYIUIW7C.js.map +1 -0
- package/dist/{chunk-S2ZXUNXB.js → chunk-REYTMXAA.js} +3 -3
- package/dist/{chunk-S2ZXUNXB.js.map → chunk-REYTMXAA.js.map} +1 -1
- package/dist/{chunk-BGTXN2E6.js → chunk-RF6YVWHX.js} +4 -4
- package/dist/{chunk-BGTXN2E6.js.map → chunk-RF6YVWHX.js.map} +1 -1
- package/dist/{chunk-ALOP5MZM.js → chunk-TCL27Q5W.js} +171 -59
- package/dist/chunk-TCL27Q5W.js.map +1 -0
- package/dist/{chunk-NZPJI7FC.js → chunk-UGGMJUFQ.js} +45 -13
- package/dist/chunk-UGGMJUFQ.js.map +1 -0
- package/dist/{chunk-KXVHDK3Q.js → chunk-UV3ROHQA.js} +27 -5
- package/dist/chunk-UV3ROHQA.js.map +1 -0
- package/dist/chunk-YDDPFSQ6.js +35 -0
- package/dist/chunk-YDDPFSQ6.js.map +1 -0
- package/dist/csv.d.ts +41 -0
- package/dist/csv.js +77 -0
- package/dist/csv.js.map +1 -0
- package/dist/dates.js +1 -115
- package/dist/dates.js.map +1 -1
- package/dist/hooks/index.d.ts +7 -43
- package/dist/hooks/index.js +14 -12
- package/dist/hooks/live-cache.d.ts +15 -0
- package/dist/hooks/live-cache.js +3 -0
- package/dist/hooks/live-cache.js.map +1 -0
- package/dist/hooks/mutation-mode.d.ts +2 -2
- package/dist/hooks/mutation-mode.js +2 -2
- package/dist/hooks/related-keys.d.ts +2 -2
- package/dist/hooks/use-capabilities.d.ts +1 -1
- package/dist/hooks/use-infinite-resource.d.ts +18 -2
- package/dist/hooks/use-infinite-resource.js +4 -3
- package/dist/hooks/use-live.d.ts +15 -3
- package/dist/hooks/use-live.js +2 -1
- package/dist/hooks/use-one.d.ts +2 -2
- package/dist/hooks/use-one.js +4 -3
- package/dist/hooks/use-resource-form.d.ts +9 -2
- package/dist/hooks/use-resource-form.js +7 -6
- package/dist/hooks/use-resource.d.ts +2 -2
- package/dist/hooks/use-resource.js +5 -4
- package/dist/hooks/use-write.d.ts +2 -2
- package/dist/index.d.ts +13 -6
- package/dist/index.js +19 -15
- package/dist/provider/index.d.ts +17 -6
- package/dist/provider/index.js +2 -2
- package/dist/resource/index.d.ts +86 -0
- package/dist/resource/index.js +85 -0
- package/dist/resource/index.js.map +1 -0
- package/dist/resource-view/index.d.ts +285 -0
- package/dist/resource-view/index.js +320 -0
- package/dist/resource-view/index.js.map +1 -0
- package/dist/schema/index.d.ts +4 -4
- package/dist/schema/index.js +1 -0
- package/dist/testing/index.d.ts +3 -3
- package/dist/{types-B9DDfvWa.d.ts → types-CXhqXPN1.d.ts} +21 -4
- package/dist/{types-C7FJtFXV.d.ts → types-o8j7g6O6.d.ts} +38 -1
- package/dist/urls.d.ts +18 -0
- package/dist/urls.js +3 -0
- package/dist/urls.js.map +1 -0
- package/dist/viewer-scope-0dR-_o0f.d.ts +76 -0
- package/dist/{write-outcome-B2fE29yZ.d.ts → write-outcome-CFnpciUI.d.ts} +1 -1
- package/package.json +17 -1
- package/dist/chunk-5ORRAXIV.js +0 -30
- package/dist/chunk-5ORRAXIV.js.map +0 -1
- package/dist/chunk-ALOP5MZM.js.map +0 -1
- package/dist/chunk-KXVHDK3Q.js.map +0 -1
- package/dist/chunk-NZPJI7FC.js.map +0 -1
- package/dist/chunk-OSPLIKSH.js.map +0 -1
- package/dist/chunk-RCAP3Q4T.js.map +0 -1
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
1
|
+
import { useLiveInvalidation } from './chunk-UV3ROHQA.js';
|
|
2
|
+
import { resourceKeys } from './chunk-OYIUIW7C.js';
|
|
3
3
|
import { useDataProvider } from './chunk-GGSXSI6Z.js';
|
|
4
|
-
import { useState, useCallback, useMemo } from 'react';
|
|
5
|
-
import { useInfiniteQuery } from '@tanstack/react-query';
|
|
4
|
+
import { useState, useCallback, useMemo, useRef } from 'react';
|
|
5
|
+
import { useInfiniteQuery, keepPreviousData } from '@tanstack/react-query';
|
|
6
6
|
|
|
7
7
|
function filterKey(filters) {
|
|
8
8
|
return JSON.stringify(
|
|
@@ -20,7 +20,8 @@ function useInfiniteResource(resource, options = {}) {
|
|
|
20
20
|
select,
|
|
21
21
|
searchFields,
|
|
22
22
|
enabled = true,
|
|
23
|
-
live
|
|
23
|
+
live,
|
|
24
|
+
keepPreviousData: keepPreviousData$1 = false
|
|
24
25
|
} = options;
|
|
25
26
|
const provider = useDataProvider();
|
|
26
27
|
const [sort, setSort] = useState(defaultSort);
|
|
@@ -45,6 +46,7 @@ function useInfiniteResource(resource, options = {}) {
|
|
|
45
46
|
}
|
|
46
47
|
return p;
|
|
47
48
|
}, [perPage, sort, filters, select, search, searchFields]);
|
|
49
|
+
const cursorMode = useRef(false);
|
|
48
50
|
const query = useInfiniteQuery({
|
|
49
51
|
queryKey: resourceKeys(resource).infinite(params),
|
|
50
52
|
initialPageParam: { page: 1, cursor: null },
|
|
@@ -60,11 +62,20 @@ function useInfiniteResource(resource, options = {}) {
|
|
|
60
62
|
return last.nextCursor ? { page: lastParam.page + 1, cursor: last.nextCursor } : void 0;
|
|
61
63
|
}
|
|
62
64
|
const loaded = pages.reduce((n, p) => n + p.data.length, 0);
|
|
63
|
-
const
|
|
64
|
-
|
|
65
|
+
const first2 = pages[0];
|
|
66
|
+
const exact = !!first2 && first2.total >= 0 && !first2.totalIsEstimate;
|
|
67
|
+
if (last.data.length < params.perPage || exact && loaded >= first2.total) return void 0;
|
|
65
68
|
return { page: lastParam.page + 1, cursor: null };
|
|
66
69
|
},
|
|
67
|
-
|
|
70
|
+
getPreviousPageParam: (first2, _pages, firstParam) => (
|
|
71
|
+
// Cursor mode only: offset pages aren't dropped from the front.
|
|
72
|
+
first2.prevCursor ? { page: firstParam.page - 1, cursor: first2.prevCursor } : void 0
|
|
73
|
+
),
|
|
74
|
+
// Only once the provider is known to page by cursor: TanStack drops pages whenever maxPages is
|
|
75
|
+
// set, and offset pages can't be loaded back, so they would be lost.
|
|
76
|
+
...options.maxPages !== void 0 && options.maxPages > 0 && cursorMode.current ? { maxPages: options.maxPages } : {},
|
|
77
|
+
enabled,
|
|
78
|
+
...keepPreviousData$1 ? { placeholderData: keepPreviousData } : {}
|
|
68
79
|
});
|
|
69
80
|
useLiveInvalidation(resource, live, enabled, { filters: params.filters }, [resource]);
|
|
70
81
|
const rows = useMemo(() => {
|
|
@@ -83,19 +94,40 @@ function useInfiniteResource(resource, options = {}) {
|
|
|
83
94
|
}
|
|
84
95
|
return out;
|
|
85
96
|
}, [query.data]);
|
|
86
|
-
const
|
|
87
|
-
|
|
88
|
-
const
|
|
97
|
+
const first = query.data?.pages[0];
|
|
98
|
+
if (first && first.nextCursor !== void 0) cursorMode.current = true;
|
|
99
|
+
const paramsKey = JSON.stringify(params);
|
|
100
|
+
const lastCount = useRef(null);
|
|
101
|
+
if (first && first.total >= 0 && !query.isPlaceholderData) {
|
|
102
|
+
lastCount.current = { key: paramsKey, total: first.total, estimate: !!first.totalIsEstimate };
|
|
103
|
+
}
|
|
104
|
+
const count = lastCount.current?.key === paramsKey ? lastCount.current : null;
|
|
105
|
+
const total = count?.total;
|
|
106
|
+
const {
|
|
107
|
+
fetchNextPage: fetchNext,
|
|
108
|
+
hasNextPage,
|
|
109
|
+
isFetchingNextPage,
|
|
110
|
+
fetchPreviousPage: fetchPrevious,
|
|
111
|
+
hasPreviousPage,
|
|
112
|
+
isFetchingPreviousPage
|
|
113
|
+
} = query;
|
|
89
114
|
const fetchNextPage = useCallback(() => {
|
|
90
115
|
if (!hasNextPage || isFetchingNextPage) return;
|
|
91
116
|
void fetchNext();
|
|
92
117
|
}, [fetchNext, hasNextPage, isFetchingNextPage]);
|
|
118
|
+
const fetchPreviousPage = useCallback(() => {
|
|
119
|
+
if (!hasPreviousPage || isFetchingPreviousPage) return;
|
|
120
|
+
void fetchPrevious();
|
|
121
|
+
}, [fetchPrevious, hasPreviousPage, isFetchingPreviousPage]);
|
|
93
122
|
return {
|
|
94
123
|
query,
|
|
95
124
|
rows,
|
|
96
125
|
total,
|
|
126
|
+
totalIsEstimate: !!count?.estimate,
|
|
97
127
|
fetchNextPage,
|
|
98
128
|
hasNextPage: !!hasNextPage,
|
|
129
|
+
fetchPreviousPage,
|
|
130
|
+
hasPreviousPage: !!hasPreviousPage,
|
|
99
131
|
isFetchingNextPage,
|
|
100
132
|
params,
|
|
101
133
|
setSort,
|
|
@@ -105,5 +137,5 @@ function useInfiniteResource(resource, options = {}) {
|
|
|
105
137
|
}
|
|
106
138
|
|
|
107
139
|
export { useInfiniteResource };
|
|
108
|
-
//# sourceMappingURL=chunk-
|
|
109
|
-
//# sourceMappingURL=chunk-
|
|
140
|
+
//# sourceMappingURL=chunk-UGGMJUFQ.js.map
|
|
141
|
+
//# sourceMappingURL=chunk-UGGMJUFQ.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/hooks/use-infinite-resource.ts"],"names":["keepPreviousData","first","keepPrevious"],"mappings":"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","file":"chunk-UGGMJUFQ.js","sourcesContent":["import { useCallback, useMemo, useRef, useState } from \"react\";\nimport {\n keepPreviousData as keepPrevious,\n useInfiniteQuery,\n type InfiniteData,\n type UseInfiniteQueryResult,\n} from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type {\n BaseRecord,\n FilterParam,\n ListParams,\n ListResult,\n SortParam,\n} from \"../provider/types\";\nimport { useLiveInvalidation, type LiveOptions } from \"./use-live\";\nimport { resourceKeys } from \"../query-keys\";\n\n// ---------------------------------------------------------------------------\n// useInfiniteResource — a list that grows with \"Load more\", by cursor.\n//\n// Asks for the first page with `cursor: null`. A provider that serves cursor\n// paging answers with `nextCursor` and is paged by keyset from then on; one\n// that doesn't answers without it and is paged by `page` (offset) until\n// `total` rows are loaded. Pages live under `[resource, \"infinite\", params]`,\n// so writes on the resource (which invalidate `[resource]`) refetch them,\n// and pending optimistic and undoable writes are patched into every page.\n// ---------------------------------------------------------------------------\n\nexport interface UseInfiniteResourceOptions {\n defaultSort?: SortParam;\n /** Re-synced when its value changes, like `useResource`'s. */\n defaultFilters?: FilterParam[];\n /** Rows per page. Default 25. */\n perPage?: number;\n /** The search to start with. Default \"\". */\n defaultSearch?: string;\n /** Supabase select/join syntax. Must include the sort and key columns. */\n select?: string;\n /** Fields to search across when `setSearch` is called. */\n searchFields?: string[];\n /** Disable fetching. */\n enabled?: boolean;\n /** Refetch the loaded pages when the provider reports a change. See `UseResourceOptions.live`. */\n live?: boolean | LiveOptions;\n /**\n * Keep at most this many pages loaded (TanStack Query's `maxPages`): scrolling far drops pages\n * from the front, and scrolling back loads them again, so a long feed and a live refetch stay\n * cheap. Needs a provider that pages by cursor both ways (`prevCursor`); offset paging ignores it.\n */\n maxPages?: number;\n /**\n * Keep the current rows on screen while a new search, sort or filter loads, instead of a\n * loading state for each change. Default false.\n */\n keepPreviousData?: boolean;\n}\n\n/** Where one page starts: its offset page, and its cursor (`null` for the first). */\nexport interface InfinitePageParam {\n page: number;\n cursor: string | null;\n}\n\nexport interface UseInfiniteResourceReturn<T> {\n /** The TanStack infinite query. */\n query: UseInfiniteQueryResult<InfiniteData<ListResult<T>, InfinitePageParam>>;\n /** Every loaded row, in order. */\n rows: T[];\n /** Rows matching the filters and search, from the first page's count. */\n total: number | undefined;\n /** True when `total` is the database's estimate, so a screen says \"about\". */\n totalIsEstimate: boolean;\n /** Loads the next page. Does nothing while one is loading or none is left. */\n fetchNextPage: () => void;\n hasNextPage: boolean;\n /** Load the page before the first loaded one (after `maxPages` dropped it). No-op when there is none. */\n fetchPreviousPage: () => void;\n hasPreviousPage: boolean;\n isFetchingNextPage: boolean;\n /** The params every page is asked with (without its page and cursor). */\n params: Omit<ListParams, \"pagination\"> & { perPage: number };\n setSort: (sort: SortParam | undefined) => void;\n setFilters: (filters: FilterParam[]) => void;\n setSearch: (query: string) => void;\n}\n\nfunction filterKey(filters: FilterParam[] | undefined): string {\n return JSON.stringify(\n (filters ?? []).map((f) =>\n Object.fromEntries(Object.entries(f).sort(([a], [b]) => a.localeCompare(b))),\n ),\n );\n}\n\nexport function useInfiniteResource<T extends BaseRecord = BaseRecord>(\n resource: string,\n options: UseInfiniteResourceOptions = {},\n): UseInfiniteResourceReturn<T> {\n const {\n defaultSort,\n defaultFilters,\n perPage = 25,\n defaultSearch = \"\",\n select,\n searchFields,\n enabled = true,\n live,\n keepPreviousData = false,\n } = options;\n const provider = useDataProvider();\n\n const [sort, setSort] = useState<SortParam | undefined>(defaultSort);\n const [filters, setFiltersRaw] = useState<FilterParam[]>(defaultFilters ?? []);\n const [search, setSearch] = useState(defaultSearch);\n\n // Follow `defaultFilters` by value, during render (see useResource).\n const defaultKey = filterKey(defaultFilters);\n const [syncedKey, setSyncedKey] = useState(defaultKey);\n if (defaultKey !== syncedKey) {\n setSyncedKey(defaultKey);\n setFiltersRaw(defaultFilters ?? []);\n }\n\n const setFilters = useCallback((next: FilterParam[]) => setFiltersRaw(next), []);\n\n const params = useMemo(() => {\n const p: Omit<ListParams, \"pagination\"> & { perPage: number } = {\n perPage,\n sort,\n filters: filters.length > 0 ? filters : undefined,\n select,\n };\n if (search && searchFields && searchFields.length > 0) {\n p.search = { query: search, fields: searchFields };\n }\n return p;\n }, [perPage, sort, filters, select, search, searchFields]);\n\n // Whether the provider pages by cursor (it sends `nextCursor`), learnt from the first page.\n const cursorMode = useRef(false);\n const query = useInfiniteQuery<\n ListResult<T>,\n Error,\n InfiniteData<ListResult<T>, InfinitePageParam>,\n readonly unknown[],\n InfinitePageParam\n >({\n queryKey: resourceKeys(resource).infinite(params),\n initialPageParam: { page: 1, cursor: null },\n queryFn: ({ pageParam }) => {\n const { perPage: size, ...rest } = params;\n return provider.getList<T>(resource, {\n ...rest,\n pagination: { page: pageParam.page, perPage: size, cursor: pageParam.cursor },\n });\n },\n getNextPageParam: (last, pages, lastParam) => {\n if (last.nextCursor !== undefined) {\n // Cursor mode: the provider says whether there is more.\n return last.nextCursor ? { page: lastParam.page + 1, cursor: last.nextCursor } : undefined;\n }\n // Offset mode: more while the last page was full and, when the total is\n // an exact count, fewer than `total` rows are loaded. An uncounted\n // (`count: \"none\"`, total -1) or estimated total (RLS makes the planner\n // guess low) never stops the list early: only a short page does.\n const loaded = pages.reduce((n, p) => n + p.data.length, 0);\n const first = pages[0];\n const exact = !!first && first.total >= 0 && !first.totalIsEstimate;\n if (last.data.length < params.perPage || (exact && loaded >= first.total)) return undefined;\n return { page: lastParam.page + 1, cursor: null };\n },\n getPreviousPageParam: (first, _pages, firstParam) =>\n // Cursor mode only: offset pages aren't dropped from the front.\n first.prevCursor ? { page: firstParam.page - 1, cursor: first.prevCursor } : undefined,\n // Only once the provider is known to page by cursor: TanStack drops pages whenever maxPages is\n // set, and offset pages can't be loaded back, so they would be lost.\n ...(options.maxPages !== undefined && options.maxPages > 0 && cursorMode.current ? { maxPages: options.maxPages } : {}),\n enabled,\n ...(keepPreviousData ? { placeholderData: keepPrevious } : {}),\n });\n\n useLiveInvalidation(resource, live, enabled, { filters: params.filters }, [resource]);\n\n // A row can move between pages while the user scrolls (its sort value\n // changed, or rows before it were added): show it once, where it first appears.\n const rows = useMemo(() => {\n const seen = new Set<string>();\n const out: T[] = [];\n for (const page of query.data?.pages ?? []) {\n for (const row of page.data) {\n const id = row?.id;\n if (id != null) {\n const key = String(id);\n if (seen.has(key)) continue;\n seen.add(key);\n }\n out.push(row);\n }\n }\n return out;\n }, [query.data]);\n const first = query.data?.pages[0];\n if (first && first.nextCursor !== undefined) cursorMode.current = true;\n // The count comes with the list's first page only. Once maxPages drops that page (or a refetch\n // starts from a back cursor) the loaded first page has no count, so keep the last one seen for\n // these params.\n const paramsKey = JSON.stringify(params);\n const lastCount = useRef<{ key: string; total: number; estimate: boolean } | null>(null);\n // Not from placeholder pages (keepPreviousData): they're the old params' rows and count.\n if (first && first.total >= 0 && !query.isPlaceholderData) {\n lastCount.current = { key: paramsKey, total: first.total, estimate: !!first.totalIsEstimate };\n }\n const count = lastCount.current?.key === paramsKey ? lastCount.current : null;\n const total = count?.total;\n\n const {\n fetchNextPage: fetchNext,\n hasNextPage,\n isFetchingNextPage,\n fetchPreviousPage: fetchPrevious,\n hasPreviousPage,\n isFetchingPreviousPage,\n } = query;\n const fetchNextPage = useCallback(() => {\n if (!hasNextPage || isFetchingNextPage) return;\n void fetchNext();\n }, [fetchNext, hasNextPage, isFetchingNextPage]);\n const fetchPreviousPage = useCallback(() => {\n if (!hasPreviousPage || isFetchingPreviousPage) return;\n void fetchPrevious();\n }, [fetchPrevious, hasPreviousPage, isFetchingPreviousPage]);\n\n return {\n query,\n rows,\n total,\n totalIsEstimate: !!count?.estimate,\n fetchNextPage,\n hasNextPage: !!hasNextPage,\n fetchPreviousPage,\n hasPreviousPage: !!hasPreviousPage,\n isFetchingNextPage,\n params,\n setSort,\n setFilters,\n setSearch,\n };\n}\n"]}
|
|
@@ -1,8 +1,10 @@
|
|
|
1
|
+
import { patchCachedRow, listCouldChange } from './chunk-AUVKRXRC.js';
|
|
1
2
|
import { useDataProvider } from './chunk-GGSXSI6Z.js';
|
|
2
3
|
import { useRef, useEffect } from 'react';
|
|
3
4
|
import { useQueryClient } from '@tanstack/react-query';
|
|
4
5
|
|
|
5
6
|
var DEFAULT_LIVE_DEBOUNCE_MS = 250;
|
|
7
|
+
var DEFAULT_LIVE_RESYNC_MS = 6e4;
|
|
6
8
|
var warnedNoSubscribe = /* @__PURE__ */ new WeakSet();
|
|
7
9
|
function useLiveInvalidation(resource, live, enabled, params, queryKey, accept) {
|
|
8
10
|
const provider = useDataProvider();
|
|
@@ -12,6 +14,10 @@ function useLiveInvalidation(resource, live, enabled, params, queryKey, accept)
|
|
|
12
14
|
0,
|
|
13
15
|
(typeof live === "object" ? live.debounceMs : void 0) ?? DEFAULT_LIVE_DEBOUNCE_MS
|
|
14
16
|
);
|
|
17
|
+
const resyncMs = Math.max(
|
|
18
|
+
0,
|
|
19
|
+
(typeof live === "object" ? live.resyncMs : void 0) ?? DEFAULT_LIVE_RESYNC_MS
|
|
20
|
+
);
|
|
15
21
|
const paramsKey = JSON.stringify(params);
|
|
16
22
|
const keyKey = JSON.stringify(queryKey);
|
|
17
23
|
const latest = useRef({ queryKey, accept, params });
|
|
@@ -29,15 +35,19 @@ function useLiveInvalidation(resource, live, enabled, params, queryKey, accept)
|
|
|
29
35
|
}
|
|
30
36
|
let timer;
|
|
31
37
|
let burstStart = 0;
|
|
38
|
+
let burst = [];
|
|
32
39
|
let active = true;
|
|
33
40
|
const maxWaitMs = debounceMs * 4;
|
|
34
41
|
const fire = () => {
|
|
35
42
|
timer = void 0;
|
|
36
43
|
if (!active) return;
|
|
37
44
|
const hidden = typeof document !== "undefined" && document.visibilityState === "hidden";
|
|
45
|
+
const rows = burst;
|
|
46
|
+
burst = [];
|
|
38
47
|
void queryClient.invalidateQueries({
|
|
39
48
|
queryKey: [...latest.current.queryKey],
|
|
40
|
-
refetchType: hidden ? "none" : "active"
|
|
49
|
+
refetchType: hidden ? "none" : "active",
|
|
50
|
+
...rows && rows.length ? { predicate: (query) => listCouldChange(query, rows) } : {}
|
|
41
51
|
});
|
|
42
52
|
};
|
|
43
53
|
let unsubscribe;
|
|
@@ -46,6 +56,12 @@ function useLiveInvalidation(resource, live, enabled, params, queryKey, accept)
|
|
|
46
56
|
if (!active) return;
|
|
47
57
|
const test = latest.current.accept;
|
|
48
58
|
if (test && event.type !== "changed" && !test(event)) return;
|
|
59
|
+
if (event.type === "updated" && event.record) {
|
|
60
|
+
patchCachedRow(queryClient, resource, event.record);
|
|
61
|
+
burst?.push(event.record);
|
|
62
|
+
} else {
|
|
63
|
+
burst = null;
|
|
64
|
+
}
|
|
49
65
|
const now = Date.now();
|
|
50
66
|
if (timer === void 0) burstStart = now;
|
|
51
67
|
else clearTimeout(timer);
|
|
@@ -54,8 +70,14 @@ function useLiveInvalidation(resource, live, enabled, params, queryKey, accept)
|
|
|
54
70
|
} catch (error) {
|
|
55
71
|
console.error(`[genesis] subscribing to "${resource}" failed:`, error);
|
|
56
72
|
}
|
|
73
|
+
const resync = resyncMs > 0 ? setInterval(() => {
|
|
74
|
+
if (!active) return;
|
|
75
|
+
if (typeof document !== "undefined" && document.visibilityState === "hidden") return;
|
|
76
|
+
void queryClient.invalidateQueries({ queryKey: [...latest.current.queryKey], refetchType: "active" });
|
|
77
|
+
}, resyncMs) : void 0;
|
|
57
78
|
return () => {
|
|
58
79
|
active = false;
|
|
80
|
+
if (resync !== void 0) clearInterval(resync);
|
|
59
81
|
if (timer !== void 0) clearTimeout(timer);
|
|
60
82
|
try {
|
|
61
83
|
unsubscribe?.();
|
|
@@ -63,9 +85,9 @@ function useLiveInvalidation(resource, live, enabled, params, queryKey, accept)
|
|
|
63
85
|
console.error(`[genesis] unsubscribing from "${resource}" failed:`, error);
|
|
64
86
|
}
|
|
65
87
|
};
|
|
66
|
-
}, [on, provider, queryClient, resource, debounceMs, paramsKey, keyKey]);
|
|
88
|
+
}, [on, provider, queryClient, resource, debounceMs, resyncMs, paramsKey, keyKey]);
|
|
67
89
|
}
|
|
68
90
|
|
|
69
|
-
export { DEFAULT_LIVE_DEBOUNCE_MS, useLiveInvalidation };
|
|
70
|
-
//# sourceMappingURL=chunk-
|
|
71
|
-
//# sourceMappingURL=chunk-
|
|
91
|
+
export { DEFAULT_LIVE_DEBOUNCE_MS, DEFAULT_LIVE_RESYNC_MS, useLiveInvalidation };
|
|
92
|
+
//# sourceMappingURL=chunk-UV3ROHQA.js.map
|
|
93
|
+
//# sourceMappingURL=chunk-UV3ROHQA.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/hooks/use-live.ts"],"names":[],"mappings":"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","file":"chunk-UV3ROHQA.js","sourcesContent":["// ---------------------------------------------------------------------------\n// Live reads — refetch a resource's cached reads when the provider reports a\n// change (`DataProvider.subscribe`).\n//\n// Events are invalidation hints. When an update carries the row (the provider\n// sends one only for a resource read from its own table, under realtime's RLS),\n// the fields cached rows already have are patched at once; the refetch that\n// follows still goes through the provider's normal read, so what a user ends\n// up seeing is what that read (and its RLS) returns. Lists the change can't\n// have touched (its row matches none of their filters and isn't in them) are\n// left alone.\n//\n// Pending optimistic and undoable writes are safe: their patches are\n// re-applied to whatever a refetch brings (see mutation-mode.ts), so a row\n// deleted with undo stays hidden and an edit stays shown until the write\n// settles. The provider drops the echo of this client's own writes, which\n// already refresh through the write path.\n// ---------------------------------------------------------------------------\n\nimport { useEffect, useRef } from \"react\";\nimport { useQueryClient, type QueryKey } from \"@tanstack/react-query\";\nimport { useDataProvider } from \"../provider/context\";\nimport type { ResourceChangeEvent, SubscribeParams } from \"../provider/types\";\nimport { listCouldChange, patchCachedRow } from \"./live-cache\";\n\n/** How long a burst of change events is gathered into one refetch. */\nexport const DEFAULT_LIVE_DEBOUNCE_MS = 250;\n\n/**\n * How often a live read refetches anyway while the page is visible. Realtime checks each change\n * against the row's new state, so a row the viewer stops being allowed to see (binned, made a\n * draft, moved to another practice) sends them nothing and would stay on screen.\n */\nexport const DEFAULT_LIVE_RESYNC_MS = 60_000;\n\n/** `live` as an object, to tune it. `live: true` takes the defaults. */\nexport interface LiveOptions {\n /**\n * Events arriving within this many milliseconds of each other cause one\n * refetch, not one each. Default {@link DEFAULT_LIVE_DEBOUNCE_MS}. A\n * steady stream still refetches at least every `4 × debounceMs`.\n */\n debounceMs?: number;\n /**\n * Refetch at least this often while the page is visible, for the changes realtime can't\n * deliver (a row the viewer may no longer read). Default {@link DEFAULT_LIVE_RESYNC_MS}; 0 turns\n * it off.\n */\n resyncMs?: number;\n}\n\nconst warnedNoSubscribe = new WeakSet<object>();\n\n/**\n * Subscribes while mounted and `enabled`, and invalidates `queryKey` (a\n * prefix) once per burst of events that `accept` lets through. While the\n * page is hidden the queries are only marked stale; they refetch when it is\n * shown again (TanStack Query's `refetchOnWindowFocus`) or next used.\n *\n * @internal Used by `useResource` and `useOne`'s `live` option.\n */\nexport function useLiveInvalidation(\n resource: string,\n live: boolean | LiveOptions | undefined,\n enabled: boolean,\n params: SubscribeParams,\n queryKey: QueryKey,\n accept?: (event: ResourceChangeEvent) => boolean,\n): void {\n const provider = useDataProvider();\n const queryClient = useQueryClient();\n const on = !!live && enabled;\n const debounceMs = Math.max(\n 0,\n (typeof live === \"object\" ? live.debounceMs : undefined) ?? DEFAULT_LIVE_DEBOUNCE_MS,\n );\n const resyncMs = Math.max(\n 0,\n (typeof live === \"object\" ? live.resyncMs : undefined) ?? DEFAULT_LIVE_RESYNC_MS,\n );\n const paramsKey = JSON.stringify(params);\n const keyKey = JSON.stringify(queryKey);\n\n // The latest values, read when an event arrives, so a new array or\n // callback each render doesn't resubscribe.\n const latest = useRef({ queryKey, accept, params });\n latest.current = { queryKey, accept, params };\n\n useEffect(() => {\n if (!on) return;\n if (typeof provider.subscribe !== \"function\") {\n if (process.env.NODE_ENV !== \"production\" && !warnedNoSubscribe.has(provider)) {\n warnedNoSubscribe.add(provider);\n console.warn(\n `[genesis] \"${resource}\" asked for live updates, but the data provider has no subscribe(); the list will only refresh on its own reads.`,\n );\n }\n return;\n }\n let timer: ReturnType<typeof setTimeout> | undefined;\n let burstStart = 0;\n // The rows of this burst's updates; null once an event without one (a delete, an insert,\n // `changed`) means every read must refetch.\n let burst: Record<string, unknown>[] | null = [];\n let active = true;\n // A busy table must not postpone the refetch forever.\n const maxWaitMs = debounceMs * 4;\n const fire = () => {\n timer = undefined;\n if (!active) return;\n const hidden = typeof document !== \"undefined\" && document.visibilityState === \"hidden\";\n const rows = burst;\n burst = [];\n void queryClient.invalidateQueries({\n queryKey: [...latest.current.queryKey],\n refetchType: hidden ? \"none\" : \"active\",\n ...(rows && rows.length ? { predicate: (query) => listCouldChange(query, rows) } : {}),\n });\n };\n let unsubscribe: (() => void) | undefined;\n try {\n unsubscribe = provider.subscribe(resource, latest.current.params, (event) => {\n if (!active) return;\n const test = latest.current.accept;\n if (test && event.type !== \"changed\" && !test(event)) return;\n if (event.type === \"updated\" && event.record) {\n patchCachedRow(queryClient, resource, event.record);\n burst?.push(event.record);\n } else {\n burst = null;\n }\n // Coalesce: one refetch per burst, after it goes quiet (or has\n // lasted `maxWaitMs`).\n const now = Date.now();\n if (timer === undefined) burstStart = now;\n else clearTimeout(timer);\n timer = setTimeout(fire, Math.min(debounceMs, Math.max(0, burstStart + maxWaitMs - now)));\n });\n } catch (error) {\n console.error(`[genesis] subscribing to \"${resource}\" failed:`, error);\n }\n // The safety net for changes realtime can't deliver; skipped while the page is hidden (a\n // hidden page refetches when it's shown again).\n const resync =\n resyncMs > 0\n ? setInterval(() => {\n if (!active) return;\n if (typeof document !== \"undefined\" && document.visibilityState === \"hidden\") return;\n void queryClient.invalidateQueries({ queryKey: [...latest.current.queryKey], refetchType: \"active\" });\n }, resyncMs)\n : undefined;\n return () => {\n active = false;\n if (resync !== undefined) clearInterval(resync);\n if (timer !== undefined) clearTimeout(timer);\n try {\n unsubscribe?.();\n } catch (error) {\n console.error(`[genesis] unsubscribing from \"${resource}\" failed:`, error);\n }\n };\n // `paramsKey` / `keyKey` stand for `params` / `queryKey` by value.\n }, [on, provider, queryClient, resource, debounceMs, resyncMs, paramsKey, keyKey]);\n}\n"]}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
// src/urls.ts
|
|
2
|
+
var SAFE_PROTOCOLS = /* @__PURE__ */ new Set(["http:", "https:", "mailto:", "tel:"]);
|
|
3
|
+
function isSafeUrl(url) {
|
|
4
|
+
if (typeof url !== "string") return false;
|
|
5
|
+
const value = url.trim();
|
|
6
|
+
if (value === "" || value.length > 2048) return false;
|
|
7
|
+
if (/[\u0000- \u007f-\u009f]/.test(value)) return false;
|
|
8
|
+
if (value.startsWith("#")) return true;
|
|
9
|
+
if (value.startsWith("/")) return !value.startsWith("//") && !value.startsWith("/\\");
|
|
10
|
+
let parsed;
|
|
11
|
+
try {
|
|
12
|
+
parsed = new URL(value);
|
|
13
|
+
} catch {
|
|
14
|
+
return false;
|
|
15
|
+
}
|
|
16
|
+
return SAFE_PROTOCOLS.has(parsed.protocol);
|
|
17
|
+
}
|
|
18
|
+
function normalizeLinkUrl(input) {
|
|
19
|
+
const value = input.trim();
|
|
20
|
+
if (value === "") return null;
|
|
21
|
+
if (isSafeUrl(value)) return value;
|
|
22
|
+
if (/^[^\s@/:]+@[^\s@/]+\.[^\s@/]+$/.test(value)) {
|
|
23
|
+
const mail = `mailto:${value}`;
|
|
24
|
+
return isSafeUrl(mail) ? mail : null;
|
|
25
|
+
}
|
|
26
|
+
if (!/^[a-z][a-z0-9+.-]*:/i.test(value) && /^[^\s/]+\.[^\s/]+/.test(value)) {
|
|
27
|
+
const withScheme = `https://${value}`;
|
|
28
|
+
return isSafeUrl(withScheme) ? withScheme : null;
|
|
29
|
+
}
|
|
30
|
+
return null;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export { isSafeUrl, normalizeLinkUrl };
|
|
34
|
+
//# sourceMappingURL=chunk-YDDPFSQ6.js.map
|
|
35
|
+
//# sourceMappingURL=chunk-YDDPFSQ6.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/urls.ts"],"names":[],"mappings":";AAGA,IAAM,cAAA,uBAAqB,GAAA,CAAI,CAAC,SAAS,QAAA,EAAU,SAAA,EAAW,MAAM,CAAC,CAAA;AAW9D,SAAS,UAAU,GAAA,EAA6B;AACrD,EAAA,IAAI,OAAO,GAAA,KAAQ,QAAA,EAAU,OAAO,KAAA;AACpC,EAAA,MAAM,KAAA,GAAQ,IAAI,IAAA,EAAK;AACvB,EAAA,IAAI,KAAA,KAAU,EAAA,IAAM,KAAA,CAAM,MAAA,GAAS,MAAM,OAAO,KAAA;AAEhD,EAAA,IAAI,yBAAA,CAA0B,IAAA,CAAK,KAAK,CAAA,EAAG,OAAO,KAAA;AAClD,EAAA,IAAI,KAAA,CAAM,UAAA,CAAW,GAAG,CAAA,EAAG,OAAO,IAAA;AAClC,EAAA,IAAI,KAAA,CAAM,UAAA,CAAW,GAAG,CAAA,EAAG,OAAO,CAAC,KAAA,CAAM,UAAA,CAAW,IAAI,CAAA,IAAK,CAAC,KAAA,CAAM,WAAW,KAAK,CAAA;AACpF,EAAA,IAAI,MAAA;AACJ,EAAA,IAAI;AACF,IAAA,MAAA,GAAS,IAAI,IAAI,KAAK,CAAA;AAAA,EACxB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,cAAA,CAAe,GAAA,CAAI,MAAA,CAAO,QAAQ,CAAA;AAC3C;AAOO,SAAS,iBAAiB,KAAA,EAA8B;AAC7D,EAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,EAAK;AACzB,EAAA,IAAI,KAAA,KAAU,IAAI,OAAO,IAAA;AACzB,EAAA,IAAI,SAAA,CAAU,KAAK,CAAA,EAAG,OAAO,KAAA;AAC7B,EAAA,IAAI,gCAAA,CAAiC,IAAA,CAAK,KAAK,CAAA,EAAG;AAChD,IAAA,MAAM,IAAA,GAAO,UAAU,KAAK,CAAA,CAAA;AAC5B,IAAA,OAAO,SAAA,CAAU,IAAI,CAAA,GAAI,IAAA,GAAO,IAAA;AAAA,EAClC;AAEA,EAAA,IAAI,CAAC,uBAAuB,IAAA,CAAK,KAAK,KAAK,mBAAA,CAAoB,IAAA,CAAK,KAAK,CAAA,EAAG;AAC1E,IAAA,MAAM,UAAA,GAAa,WAAW,KAAK,CAAA,CAAA;AACnC,IAAA,OAAO,SAAA,CAAU,UAAU,CAAA,GAAI,UAAA,GAAa,IAAA;AAAA,EAC9C;AACA,EAAA,OAAO,IAAA;AACT","file":"chunk-YDDPFSQ6.js","sourcesContent":["// Links a person or a row supplies, checked before they reach an `href` or `src`. Pure: web,\n// native and the extension use the same check (docs/RESOURCE-VIEW.md, \"URLs are checked\").\n\nconst SAFE_PROTOCOLS = new Set([\"http:\", \"https:\", \"mailto:\", \"tel:\"]);\n\n/**\n * True when `url` is safe to put in an `href`: an absolute http(s), mailto or\n * tel URL, a root-relative path (`/lessons/1`) or a fragment (`#notes`).\n *\n * Rejects `javascript:`, `data:`, `vbscript:` and every other scheme, as well\n * as protocol-relative `//host` URLs and anything containing whitespace or\n * control characters (browsers strip those, which is how `java\\tscript:`\n * slips past naive checks).\n */\nexport function isSafeUrl(url: unknown): url is string {\n if (typeof url !== \"string\") return false;\n const value = url.trim();\n if (value === \"\" || value.length > 2048) return false;\n // eslint-disable-next-line no-control-regex\n if (/[\\u0000- \\u007f-\\u009f]/.test(value)) return false;\n if (value.startsWith(\"#\")) return true;\n if (value.startsWith(\"/\")) return !value.startsWith(\"//\") && !value.startsWith(\"/\\\\\");\n let parsed: URL;\n try {\n parsed = new URL(value);\n } catch {\n return false;\n }\n return SAFE_PROTOCOLS.has(parsed.protocol);\n}\n\n/**\n * Turn what a person typed into the link field into a safe href, or `null`.\n * `example.com/page` becomes `https://example.com/page`; an email address\n * becomes a `mailto:` link.\n */\nexport function normalizeLinkUrl(input: string): string | null {\n const value = input.trim();\n if (value === \"\") return null;\n if (isSafeUrl(value)) return value;\n if (/^[^\\s@/:]+@[^\\s@/]+\\.[^\\s@/]+$/.test(value)) {\n const mail = `mailto:${value}`;\n return isSafeUrl(mail) ? mail : null;\n }\n // No scheme but looks like a host: assume https.\n if (!/^[a-z][a-z0-9+.-]*:/i.test(value) && /^[^\\s/]+\\.[^\\s/]+/.test(value)) {\n const withScheme = `https://${value}`;\n return isSafeUrl(withScheme) ? withScheme : null;\n }\n return null;\n}\n"]}
|
package/dist/csv.d.ts
ADDED
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { D as DataProvider, S as SortParam, F as FilterParam } from './types-CXhqXPN1.js';
|
|
2
|
+
import { F as FieldSchema } from './types-o8j7g6O6.js';
|
|
3
|
+
import './form-types.js';
|
|
4
|
+
|
|
5
|
+
/** RFC 4180 field: quoted when it holds a comma, quote or line break. */
|
|
6
|
+
declare function csvField(value: unknown): string;
|
|
7
|
+
declare function toCsv(fields: readonly FieldSchema[], rows: readonly Record<string, unknown>[]): string;
|
|
8
|
+
interface ExportOptions {
|
|
9
|
+
provider: DataProvider;
|
|
10
|
+
resource: string;
|
|
11
|
+
fields: readonly FieldSchema[];
|
|
12
|
+
sorts: SortParam[];
|
|
13
|
+
filters: FilterParam[];
|
|
14
|
+
search?: string;
|
|
15
|
+
/** Columns the search matches. Without them a provider may skip the search, so pass the list's. */
|
|
16
|
+
searchFields?: string[];
|
|
17
|
+
/**
|
|
18
|
+
* What to read, in the provider's select syntax. Pass only the exported columns so nothing else
|
|
19
|
+
* leaves the database for the file. Default: the provider's own select for the resource.
|
|
20
|
+
*/
|
|
21
|
+
select?: string;
|
|
22
|
+
/** Stop after this many rows. Default 10 000. */
|
|
23
|
+
maxRows?: number;
|
|
24
|
+
onProgress?: (rows: number) => void;
|
|
25
|
+
}
|
|
26
|
+
declare function exportCsv(options: ExportOptions): Promise<{
|
|
27
|
+
csv: string;
|
|
28
|
+
rows: number;
|
|
29
|
+
truncated: boolean;
|
|
30
|
+
}>;
|
|
31
|
+
/**
|
|
32
|
+
* Parse CSV text (RFC 4180: quoted fields, doubled quotes, CRLF or LF) into
|
|
33
|
+
* a header and rows. A cell is always text: nothing is guessed or coerced,
|
|
34
|
+
* so the database decides whether "1,5" is a number.
|
|
35
|
+
*/
|
|
36
|
+
declare function parseCsv(text: string): {
|
|
37
|
+
header: string[];
|
|
38
|
+
rows: string[][];
|
|
39
|
+
};
|
|
40
|
+
|
|
41
|
+
export { type ExportOptions, csvField, exportCsv, parseCsv, toCsv };
|
package/dist/csv.js
ADDED
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
// src/csv.ts
|
|
2
|
+
function csvField(value) {
|
|
3
|
+
if (value === null || value === void 0) return "";
|
|
4
|
+
const text = typeof value === "object" ? JSON.stringify(value) : String(value);
|
|
5
|
+
const plainNumber = /^-?\d+(\.\d+)?([eE][+-]?\d+)?$/.test(text);
|
|
6
|
+
const safe = !plainNumber && /^\s*[=+\-@]|^[\t\r]/.test(text) ? `'${text}` : text;
|
|
7
|
+
return /[",\r\n]/.test(safe) ? `"${safe.replace(/"/g, '""')}"` : safe;
|
|
8
|
+
}
|
|
9
|
+
function toCsv(fields, rows) {
|
|
10
|
+
const lines = [fields.map((f) => csvField(f.name)).join(",")];
|
|
11
|
+
for (const row of rows) lines.push(fields.map((f) => csvField(row[f.name])).join(","));
|
|
12
|
+
return `${lines.join("\r\n")}\r
|
|
13
|
+
`;
|
|
14
|
+
}
|
|
15
|
+
async function exportCsv(options) {
|
|
16
|
+
const perPage = 200;
|
|
17
|
+
const max = options.maxRows ?? 1e4;
|
|
18
|
+
const rows = [];
|
|
19
|
+
let truncated = false;
|
|
20
|
+
for (let page = 1; ; page++) {
|
|
21
|
+
const result = await options.provider.getList(options.resource, {
|
|
22
|
+
pagination: { page, perPage },
|
|
23
|
+
sort: options.sorts[0],
|
|
24
|
+
sorts: options.sorts,
|
|
25
|
+
filters: options.filters,
|
|
26
|
+
...options.select ? { select: options.select } : {},
|
|
27
|
+
...options.search ? { search: { query: options.search, fields: options.searchFields ?? [] } } : {}
|
|
28
|
+
});
|
|
29
|
+
rows.push(...result.data);
|
|
30
|
+
options.onProgress?.(rows.length);
|
|
31
|
+
if (rows.length >= max) {
|
|
32
|
+
truncated = rows.length > max || result.total > max;
|
|
33
|
+
rows.length = Math.min(rows.length, max);
|
|
34
|
+
break;
|
|
35
|
+
}
|
|
36
|
+
if (result.data.length < perPage || rows.length >= result.total) break;
|
|
37
|
+
}
|
|
38
|
+
return { csv: toCsv(options.fields, rows), rows: rows.length, truncated };
|
|
39
|
+
}
|
|
40
|
+
function parseCsv(text) {
|
|
41
|
+
const records = [];
|
|
42
|
+
let record = [];
|
|
43
|
+
let field = "";
|
|
44
|
+
let quoted = false;
|
|
45
|
+
const input = text.replace(/^\uFEFF/, "");
|
|
46
|
+
for (let i = 0; i < input.length; i++) {
|
|
47
|
+
const ch = input[i];
|
|
48
|
+
if (quoted) {
|
|
49
|
+
if (ch === '"' && input[i + 1] === '"') {
|
|
50
|
+
field += '"';
|
|
51
|
+
i++;
|
|
52
|
+
} else if (ch === '"') quoted = false;
|
|
53
|
+
else field += ch;
|
|
54
|
+
} else if (ch === '"' && field === "") quoted = true;
|
|
55
|
+
else if (ch === ",") {
|
|
56
|
+
record.push(field);
|
|
57
|
+
field = "";
|
|
58
|
+
} else if (ch === "\n" || ch === "\r") {
|
|
59
|
+
if (ch === "\r" && input[i + 1] === "\n") i++;
|
|
60
|
+
record.push(field);
|
|
61
|
+
records.push(record);
|
|
62
|
+
record = [];
|
|
63
|
+
field = "";
|
|
64
|
+
} else field += ch;
|
|
65
|
+
}
|
|
66
|
+
if (field !== "" || record.length) {
|
|
67
|
+
record.push(field);
|
|
68
|
+
records.push(record);
|
|
69
|
+
}
|
|
70
|
+
const nonEmpty = records.filter((r) => r.some((v) => v !== ""));
|
|
71
|
+
const [header = [], ...rows] = nonEmpty;
|
|
72
|
+
return { header: header.map((h) => h.trim()), rows };
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export { csvField, exportCsv, parseCsv, toCsv };
|
|
76
|
+
//# sourceMappingURL=csv.js.map
|
|
77
|
+
//# sourceMappingURL=csv.js.map
|
package/dist/csv.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/csv.ts"],"names":[],"mappings":"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","file":"csv.js","sourcesContent":["// CSV of every row a filtered list matches (not one page): paged through the\n// provider, so it works with any DataProvider and never asks for an\n// unbounded query.\n\nimport type { DataProvider, FilterParam, SortParam } from \"./provider\";\nimport type { FieldSchema } from \"./schema/types\";\n\n/** RFC 4180 field: quoted when it holds a comma, quote or line break. */\nexport function csvField(value: unknown): string {\n if (value === null || value === undefined) return \"\";\n const text = typeof value === \"object\" ? JSON.stringify(value) : String(value);\n // A leading =, +, - or @ turns into a formula in a spreadsheet, even after spaces (some apps\n // trim them on import); neutralise\n // it. A plain number (-5, -1.5e3) stays a number: it computes nothing, and a\n // prefix would turn it into text nobody can sum. Postgres numerics arrive\n // as strings, so the check is on the text, not the type.\n const plainNumber = /^-?\\d+(\\.\\d+)?([eE][+-]?\\d+)?$/.test(text);\n const safe = !plainNumber && /^\\s*[=+\\-@]|^[\\t\\r]/.test(text) ? `'${text}` : text;\n return /[\",\\r\\n]/.test(safe) ? `\"${safe.replace(/\"/g, '\"\"')}\"` : safe;\n}\n\nexport function toCsv(fields: readonly FieldSchema[], rows: readonly Record<string, unknown>[]): string {\n const lines = [fields.map((f) => csvField(f.name)).join(\",\")];\n for (const row of rows) lines.push(fields.map((f) => csvField(row[f.name])).join(\",\"));\n return `${lines.join(\"\\r\\n\")}\\r\\n`;\n}\n\nexport interface ExportOptions {\n provider: DataProvider;\n resource: string;\n fields: readonly FieldSchema[];\n sorts: SortParam[];\n filters: FilterParam[];\n search?: string;\n /** Columns the search matches. Without them a provider may skip the search, so pass the list's. */\n searchFields?: string[];\n /**\n * What to read, in the provider's select syntax. Pass only the exported columns so nothing else\n * leaves the database for the file. Default: the provider's own select for the resource.\n */\n select?: string;\n /** Stop after this many rows. Default 10 000. */\n maxRows?: number;\n onProgress?: (rows: number) => void;\n}\n\nexport async function exportCsv(options: ExportOptions): Promise<{ csv: string; rows: number; truncated: boolean }> {\n const perPage = 200;\n const max = options.maxRows ?? 10_000;\n const rows: Record<string, unknown>[] = [];\n let truncated = false;\n for (let page = 1; ; page++) {\n const result = await options.provider.getList(options.resource, {\n pagination: { page, perPage },\n sort: options.sorts[0],\n sorts: options.sorts,\n filters: options.filters,\n ...(options.select ? { select: options.select } : {}),\n ...(options.search ? { search: { query: options.search, fields: options.searchFields ?? [] } } : {}),\n });\n rows.push(...(result.data as Record<string, unknown>[]));\n options.onProgress?.(rows.length);\n if (rows.length >= max) {\n truncated = rows.length > max || result.total > max;\n rows.length = Math.min(rows.length, max);\n break;\n }\n if (result.data.length < perPage || rows.length >= result.total) break;\n }\n return { csv: toCsv(options.fields, rows), rows: rows.length, truncated };\n}\n\n/**\n * Parse CSV text (RFC 4180: quoted fields, doubled quotes, CRLF or LF) into\n * a header and rows. A cell is always text: nothing is guessed or coerced,\n * so the database decides whether \"1,5\" is a number.\n */\nexport function parseCsv(text: string): { header: string[]; rows: string[][] } {\n const records: string[][] = [];\n let record: string[] = [];\n let field = \"\";\n let quoted = false;\n const input = text.replace(/^\\uFEFF/, \"\");\n for (let i = 0; i < input.length; i++) {\n const ch = input[i]!;\n if (quoted) {\n if (ch === '\"' && input[i + 1] === '\"') {\n field += '\"';\n i++;\n } else if (ch === '\"') quoted = false;\n else field += ch;\n } else if (ch === '\"' && field === \"\") quoted = true;\n else if (ch === \",\") {\n record.push(field);\n field = \"\";\n } else if (ch === \"\\n\" || ch === \"\\r\") {\n if (ch === \"\\r\" && input[i + 1] === \"\\n\") i++;\n record.push(field);\n records.push(record);\n record = [];\n field = \"\";\n } else field += ch;\n }\n if (field !== \"\" || record.length) {\n record.push(field);\n records.push(record);\n }\n const nonEmpty = records.filter((r) => r.some((v) => v !== \"\"));\n const [header = [], ...rows] = nonEmpty;\n return { header: header.map((h) => h.trim()), rows };\n}\n"]}
|
package/dist/dates.js
CHANGED
|
@@ -1,117 +1,3 @@
|
|
|
1
|
-
|
|
2
|
-
var DAY = /^(\d{4})-(\d{2})-(\d{2})$/;
|
|
3
|
-
function isDay(value) {
|
|
4
|
-
if (typeof value !== "string") return false;
|
|
5
|
-
const m = DAY.exec(value);
|
|
6
|
-
if (!m) return false;
|
|
7
|
-
const d = new Date(Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3])));
|
|
8
|
-
return d.getUTCFullYear() === Number(m[1]) && d.getUTCMonth() === Number(m[2]) - 1 && d.getUTCDate() === Number(m[3]);
|
|
9
|
-
}
|
|
10
|
-
function assertDay(day, where) {
|
|
11
|
-
if (!isDay(day)) throw new RangeError(`${where}: "${String(day)}" is not a YYYY-MM-DD day`);
|
|
12
|
-
const m = DAY.exec(day);
|
|
13
|
-
return [Number(m[1]), Number(m[2]), Number(m[3])];
|
|
14
|
-
}
|
|
15
|
-
var formatters = /* @__PURE__ */ new Map();
|
|
16
|
-
function isTimeZone(zone) {
|
|
17
|
-
if (typeof zone !== "string" || !zone) return false;
|
|
18
|
-
if (formatters.has(zone)) return true;
|
|
19
|
-
try {
|
|
20
|
-
new Intl.DateTimeFormat("en-US", { timeZone: zone });
|
|
21
|
-
return true;
|
|
22
|
-
} catch {
|
|
23
|
-
return false;
|
|
24
|
-
}
|
|
25
|
-
}
|
|
26
|
-
function deviceTimeZone() {
|
|
27
|
-
try {
|
|
28
|
-
return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
|
|
29
|
-
} catch {
|
|
30
|
-
return "UTC";
|
|
31
|
-
}
|
|
32
|
-
}
|
|
33
|
-
function partsFormatter(zone) {
|
|
34
|
-
let f = formatters.get(zone);
|
|
35
|
-
if (!f) {
|
|
36
|
-
f = new Intl.DateTimeFormat("en-US", {
|
|
37
|
-
timeZone: zone,
|
|
38
|
-
hourCycle: "h23",
|
|
39
|
-
year: "numeric",
|
|
40
|
-
month: "2-digit",
|
|
41
|
-
day: "2-digit",
|
|
42
|
-
hour: "2-digit",
|
|
43
|
-
minute: "2-digit",
|
|
44
|
-
second: "2-digit",
|
|
45
|
-
weekday: "short"
|
|
46
|
-
});
|
|
47
|
-
formatters.set(zone, f);
|
|
48
|
-
}
|
|
49
|
-
return f;
|
|
50
|
-
}
|
|
51
|
-
var WEEKDAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
|
|
52
|
-
function wallClock(zone, at = /* @__PURE__ */ new Date()) {
|
|
53
|
-
if (!isTimeZone(zone)) throw new RangeError(`wallClock: unknown time zone "${zone}"`);
|
|
54
|
-
const parts = {};
|
|
55
|
-
for (const p of partsFormatter(zone).formatToParts(at)) parts[p.type] = p.value;
|
|
56
|
-
return {
|
|
57
|
-
year: Number(parts["year"]),
|
|
58
|
-
month: Number(parts["month"]),
|
|
59
|
-
day: Number(parts["day"]),
|
|
60
|
-
hour: Number(parts["hour"]),
|
|
61
|
-
minute: Number(parts["minute"]),
|
|
62
|
-
second: Number(parts["second"]),
|
|
63
|
-
weekday: WEEKDAYS.indexOf(parts["weekday"] ?? "")
|
|
64
|
-
};
|
|
65
|
-
}
|
|
66
|
-
var pad = (n, width = 2) => String(n).padStart(width, "0");
|
|
67
|
-
var dayOf = (y, m, d) => `${pad(y, 4)}-${pad(m)}-${pad(d)}`;
|
|
68
|
-
function dayIn(zone, at = /* @__PURE__ */ new Date()) {
|
|
69
|
-
const c = wallClock(zone, at);
|
|
70
|
-
return dayOf(c.year, c.month, c.day);
|
|
71
|
-
}
|
|
72
|
-
function personTimeZone(person) {
|
|
73
|
-
const saved = person?.timeZone;
|
|
74
|
-
return saved && isTimeZone(saved) ? saved : deviceTimeZone();
|
|
75
|
-
}
|
|
76
|
-
function personDay(person, at = /* @__PURE__ */ new Date()) {
|
|
77
|
-
return dayIn(personTimeZone(person), at);
|
|
78
|
-
}
|
|
79
|
-
function addDays(day, days) {
|
|
80
|
-
const [y, m, d] = assertDay(day, "addDays");
|
|
81
|
-
if (!Number.isInteger(days)) throw new RangeError(`addDays: ${days} is not a whole number of days`);
|
|
82
|
-
const t = new Date(Date.UTC(y, m - 1, d + days));
|
|
83
|
-
return dayOf(t.getUTCFullYear(), t.getUTCMonth() + 1, t.getUTCDate());
|
|
84
|
-
}
|
|
85
|
-
function daysBetween(from, to) {
|
|
86
|
-
const [y1, m1, d1] = assertDay(from, "daysBetween");
|
|
87
|
-
const [y2, m2, d2] = assertDay(to, "daysBetween");
|
|
88
|
-
return Math.round((Date.UTC(y2, m2 - 1, d2) - Date.UTC(y1, m1 - 1, d1)) / 864e5);
|
|
89
|
-
}
|
|
90
|
-
function weekdayOf(day) {
|
|
91
|
-
const [y, m, d] = assertDay(day, "weekdayOf");
|
|
92
|
-
return new Date(Date.UTC(y, m - 1, d)).getUTCDay();
|
|
93
|
-
}
|
|
94
|
-
function startOfWeek(day, weekStartsOn = 1) {
|
|
95
|
-
if (!Number.isInteger(weekStartsOn) || weekStartsOn < 0 || weekStartsOn > 6) throw new RangeError("startOfWeek: weekStartsOn is 0 to 6");
|
|
96
|
-
return addDays(day, -((weekdayOf(day) - weekStartsOn + 7) % 7));
|
|
97
|
-
}
|
|
98
|
-
function startOfDayIn(day, zone) {
|
|
99
|
-
const [y, m, d] = assertDay(day, "startOfDayIn");
|
|
100
|
-
const target = Date.UTC(y, m - 1, d);
|
|
101
|
-
let at = target;
|
|
102
|
-
for (let i = 0; i < 2; i++) {
|
|
103
|
-
const c = wallClock(zone, new Date(at));
|
|
104
|
-
const shown = Date.UTC(c.year, c.month - 1, c.day, c.hour, c.minute, c.second);
|
|
105
|
-
at -= shown - target;
|
|
106
|
-
}
|
|
107
|
-
while (dayIn(zone, new Date(at)) < day) at += 15 * 6e4;
|
|
108
|
-
while (dayIn(zone, new Date(at - 1)) === day) at -= 15 * 6e4;
|
|
109
|
-
return new Date(at);
|
|
110
|
-
}
|
|
111
|
-
function dayRangeIn(day, zone) {
|
|
112
|
-
return { start: startOfDayIn(day, zone), end: startOfDayIn(addDays(day, 1), zone) };
|
|
113
|
-
}
|
|
114
|
-
|
|
115
|
-
export { addDays, dayIn, dayRangeIn, daysBetween, deviceTimeZone, isDay, isTimeZone, personDay, personTimeZone, startOfDayIn, startOfWeek, wallClock, weekdayOf };
|
|
1
|
+
export { addDays, dayIn, dayRangeIn, daysBetween, deviceTimeZone, isDay, isTimeZone, personDay, personTimeZone, startOfDayIn, startOfWeek, wallClock, weekdayOf } from './chunk-3B4IFDMK.js';
|
|
116
2
|
//# sourceMappingURL=dates.js.map
|
|
117
3
|
//# sourceMappingURL=dates.js.map
|
package/dist/dates.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/dates.ts"],"names":[],"mappings":"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","file":"dates.js","sourcesContent":["/**\n * `@marktiderman/genesis-core/dates`: calendar days on a person's clock.\n *\n * A \"day\" here is a `YYYY-MM-DD` string: the date on some time zone's wall\n * clock. Which zone is the whole question. `new Date().toISOString().slice(0, 10)`\n * is the day in UTC, which is tomorrow for an evening in the Americas and\n * yesterday for a morning in Asia. The browser's zone is the device's, not\n * necessarily the person's, and a server's is usually UTC. So every function\n * here takes the zone, and `personDay` picks it in one order everywhere: the\n * person's saved zone, then the device's, then UTC.\n *\n * No dependencies: `Intl.DateTimeFormat` does the zone arithmetic, so daylight\n * saving is right wherever the runtime's time zone data is.\n *\n * @packageDocumentation\n */\n\n/** `YYYY-MM-DD`. */\nexport type Day = string;\n\nconst DAY = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\n\n/** Whether `value` is a real `YYYY-MM-DD` day (not `2026-02-30`). @stability Beta */\nexport function isDay(value: unknown): value is Day {\n if (typeof value !== \"string\") return false;\n const m = DAY.exec(value);\n if (!m) return false;\n const d = new Date(Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3])));\n return d.getUTCFullYear() === Number(m[1]) && d.getUTCMonth() === Number(m[2]) - 1 && d.getUTCDate() === Number(m[3]);\n}\n\nfunction assertDay(day: Day, where: string): [number, number, number] {\n if (!isDay(day)) throw new RangeError(`${where}: \"${String(day)}\" is not a YYYY-MM-DD day`);\n const m = DAY.exec(day)!;\n return [Number(m[1]), Number(m[2]), Number(m[3])];\n}\n\n// One formatter per zone, made once: building an Intl.DateTimeFormat is the slow part.\nconst formatters = new Map<string, Intl.DateTimeFormat>();\n\n/** Whether the runtime knows `zone` (`\"America/Denver\"`). @stability Beta */\nexport function isTimeZone(zone: unknown): zone is string {\n if (typeof zone !== \"string\" || !zone) return false;\n if (formatters.has(zone)) return true;\n try {\n new Intl.DateTimeFormat(\"en-US\", { timeZone: zone });\n return true;\n } catch {\n return false;\n }\n}\n\n/** The device's (or server's) zone, `\"UTC\"` when the runtime can't say. @stability Beta */\nexport function deviceTimeZone(): string {\n try {\n return Intl.DateTimeFormat().resolvedOptions().timeZone || \"UTC\";\n } catch {\n return \"UTC\";\n }\n}\n\nfunction partsFormatter(zone: string): Intl.DateTimeFormat {\n let f = formatters.get(zone);\n if (!f) {\n f = new Intl.DateTimeFormat(\"en-US\", {\n timeZone: zone,\n hourCycle: \"h23\",\n year: \"numeric\",\n month: \"2-digit\",\n day: \"2-digit\",\n hour: \"2-digit\",\n minute: \"2-digit\",\n second: \"2-digit\",\n weekday: \"short\",\n });\n formatters.set(zone, f);\n }\n return f;\n}\n\nconst WEEKDAYS = [\"Sun\", \"Mon\", \"Tue\", \"Wed\", \"Thu\", \"Fri\", \"Sat\"];\n\n/** The wall clock in a zone at one instant. `weekday` is 0 for Sunday. @stability Beta */\nexport interface WallClock {\n year: number;\n month: number;\n day: number;\n hour: number;\n minute: number;\n second: number;\n weekday: number;\n}\n\n/** What the clock on the wall in `zone` says at `at`. @stability Beta */\nexport function wallClock(zone: string, at: Date = new Date()): WallClock {\n if (!isTimeZone(zone)) throw new RangeError(`wallClock: unknown time zone \"${zone}\"`);\n const parts: Record<string, string> = {};\n for (const p of partsFormatter(zone).formatToParts(at)) parts[p.type] = p.value;\n return {\n year: Number(parts[\"year\"]),\n month: Number(parts[\"month\"]),\n day: Number(parts[\"day\"]),\n hour: Number(parts[\"hour\"]),\n minute: Number(parts[\"minute\"]),\n second: Number(parts[\"second\"]),\n weekday: WEEKDAYS.indexOf(parts[\"weekday\"] ?? \"\"),\n };\n}\n\nconst pad = (n: number, width = 2) => String(n).padStart(width, \"0\");\nconst dayOf = (y: number, m: number, d: number): Day => `${pad(y, 4)}-${pad(m)}-${pad(d)}`;\n\n/** The day on `zone`'s clock at `at` (default now). @stability Beta */\nexport function dayIn(zone: string, at: Date = new Date()): Day {\n const c = wallClock(zone, at);\n return dayOf(c.year, c.month, c.day);\n}\n\n/** Someone whose days are counted: their saved zone, when they have one. */\nexport interface PersonClock {\n timeZone?: string | null | undefined;\n}\n\n/**\n * The zone a person's days are counted in: their saved zone if the runtime\n * knows it, else the device's, else UTC. On a server, pass the person's zone:\n * the server's own is rarely theirs.\n *\n * @stability Beta\n */\nexport function personTimeZone(person?: PersonClock | null): string {\n const saved = person?.timeZone;\n return saved && isTimeZone(saved) ? saved : deviceTimeZone();\n}\n\n/**\n * Today (or the day at `at`) for this person: `dayIn(personTimeZone(person), at)`.\n *\n * ```ts\n * const today = personDay(profile); // \"2026-10-26\" on their clock\n * const dueToday = tasks.filter((t) => t.due_on === today);\n * ```\n *\n * @stability Beta\n */\nexport function personDay(person?: PersonClock | null, at: Date = new Date()): Day {\n return dayIn(personTimeZone(person), at);\n}\n\n/** `day` moved by `days` (negative goes back). Calendar arithmetic: no zone, no daylight saving. @stability Beta */\nexport function addDays(day: Day, days: number): Day {\n const [y, m, d] = assertDay(day, \"addDays\");\n if (!Number.isInteger(days)) throw new RangeError(`addDays: ${days} is not a whole number of days`);\n const t = new Date(Date.UTC(y, m - 1, d + days));\n return dayOf(t.getUTCFullYear(), t.getUTCMonth() + 1, t.getUTCDate());\n}\n\n/** Whole days from `from` to `to` (`to` − `from`; negative when `to` is earlier). @stability Beta */\nexport function daysBetween(from: Day, to: Day): number {\n const [y1, m1, d1] = assertDay(from, \"daysBetween\");\n const [y2, m2, d2] = assertDay(to, \"daysBetween\");\n return Math.round((Date.UTC(y2, m2 - 1, d2) - Date.UTC(y1, m1 - 1, d1)) / 86_400_000);\n}\n\n/** The weekday of a day, 0 for Sunday. @stability Beta */\nexport function weekdayOf(day: Day): number {\n const [y, m, d] = assertDay(day, \"weekdayOf\");\n return new Date(Date.UTC(y, m - 1, d)).getUTCDay();\n}\n\n/** The first day of `day`'s week, with weeks starting on `weekStartsOn` (0 Sunday … 6 Saturday; default 1, Monday). @stability Beta */\nexport function startOfWeek(day: Day, weekStartsOn = 1): Day {\n if (!Number.isInteger(weekStartsOn) || weekStartsOn < 0 || weekStartsOn > 6) throw new RangeError(\"startOfWeek: weekStartsOn is 0 to 6\");\n return addDays(day, -((weekdayOf(day) - weekStartsOn + 7) % 7));\n}\n\n/**\n * The instant `day` starts on `zone`'s clock: what to compare `created_at`\n * with for \"since midnight\". Where midnight doesn't exist (a daylight-saving\n * jump at 00:00), it's the first instant of the day that does.\n *\n * @stability Beta\n */\nexport function startOfDayIn(day: Day, zone: string): Date {\n const [y, m, d] = assertDay(day, \"startOfDayIn\");\n const target = Date.UTC(y, m - 1, d);\n // Guess the instant as if the zone were UTC, then correct by the zone's offset there, twice\n // (the second pass settles a guess that landed across a transition).\n let at = target;\n for (let i = 0; i < 2; i++) {\n const c = wallClock(zone, new Date(at));\n const shown = Date.UTC(c.year, c.month - 1, c.day, c.hour, c.minute, c.second);\n at -= shown - target;\n }\n // Midnight skipped by a transition: step forward to the first instant on that day.\n while (dayIn(zone, new Date(at)) < day) at += 15 * 60_000;\n while (dayIn(zone, new Date(at - 1)) === day) at -= 15 * 60_000;\n return new Date(at);\n}\n\n/** The `[start, end)` instants of `day` on `zone`'s clock (23 or 25 hours on daylight-saving days). @stability Beta */\nexport function dayRangeIn(day: Day, zone: string): { start: Date; end: Date } {\n return { start: startOfDayIn(day, zone), end: startOfDayIn(addDays(day, 1), zone) };\n}\n"]}
|
|
1
|
+
{"version":3,"sources":[],"names":[],"mappings":"","file":"dates.js"}
|