tempest-react-sdk 0.22.0 → 0.23.0

package/dist/query/use-cursor-query.js

@@ -0,0 +1,28 @@
+import { useInfiniteQuery as c } from "@tanstack/react-query";
+function P(s) {
+  const { queryKey: n, queryFn: g, limit: t = 20, orderBy: a, ascending: i = !1, ...u } = s, e = c({
+    ...u,
+    queryKey: [...n, { limit: t, orderBy: a, ascending: i }],
+    initialPageParam: null,
+    queryFn: ({ pageParam: r }) => g({ cursor: r, limit: t, order_by: a, ascending: i }),
+    getNextPageParam: (r) => r.has_more ? r.next_cursor : void 0
+  }), o = e.data?.pages ?? [];
+  return {
+    items: o.flatMap((r) => r.items),
+    pages: o,
+    hasNextPage: e.hasNextPage,
+    isLoading: e.isLoading,
+    isFetchingNextPage: e.isFetchingNextPage,
+    error: e.error,
+    fetchNextPage: () => {
+      e.fetchNextPage();
+    },
+    refetch: () => {
+      e.refetch();
+    }
+  };
+}
+export {
+  P as useCursorQuery
+};
+//# sourceMappingURL=use-cursor-query.js.map

package/dist/query/use-cursor-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cursor-query.js","sources":["../../src/query/use-cursor-query.ts"],"sourcesContent":["import { useInfiniteQuery } from \"@tanstack/react-query\";\nimport type { InfiniteData, QueryKey, UseInfiniteQueryOptions } from \"@tanstack/react-query\";\n\nimport type { CursorPage, CursorParams } from \"./pagination\";\n\nexport interface UseCursorQueryOptions<T> extends Omit<\n    UseInfiniteQueryOptions<\n        CursorPage<T>,\n        Error,\n        InfiniteData<CursorPage<T>, string | null>,\n        QueryKey,\n        string | null\n    >,\n    \"queryKey\" | \"queryFn\" | \"initialPageParam\" | \"getNextPageParam\"\n> {\n    /** Base query key — `limit`/sort is appended for cache isolation. */\n    queryKey: QueryKey;\n    /** Fetcher receiving the cursor params; return the backend envelope. */\n    queryFn: (params: CursorParams) => Promise<CursorPage<T>> | CursorPage<T>;\n    /** Batch size sent as `limit`. Default: 20. */\n    limit?: number;\n    /** Initial `order_by`. */\n    orderBy?: string;\n    /** Initial `ascending`. Default: false. */\n    ascending?: boolean;\n}\n\nexport interface UseCursorQueryResult<T> {\n    /** All rows fetched so far, flattened across batches. */\n    items: T[];\n    /** The raw batches, in fetch order. */\n    pages: CursorPage<T>[];\n    hasNextPage: boolean;\n    isLoading: boolean;\n    isFetchingNextPage: boolean;\n    error: Error | null;\n    /** Fetch the next batch (no-op when exhausted). */\n    fetchNextPage: () => void;\n    /** Refetch from the first batch. */\n    refetch: () => void;\n}\n\n/**\n * Cursor-pagination hook over TanStack Query's `useInfiniteQuery` for the\n * Tempest `CursorPaginationSchema` envelope\n * (`{ items, next_cursor, has_more, limit }`).\n *\n * The opaque `next_cursor` is fed straight back as the next page param; the\n * loop stops when `has_more` is false (or `next_cursor` is null).\n *\n * @example\n * const feed = useCursorQuery<Post>({\n *     queryKey: [\"feed\"],\n *     limit: 30,\n *     queryFn: (params) => postsService.listPosts(params),\n * });\n * // feed.items, feed.fetchNextPage(), feed.hasNextPage\n */\nexport function useCursorQuery<T>(options: UseCursorQueryOptions<T>): UseCursorQueryResult<T> {\n    const { queryKey, queryFn, limit = 20, orderBy, ascending = false, ...queryOptions } = options;\n\n    const query = useInfiniteQuery<\n        CursorPage<T>,\n        Error,\n        InfiniteData<CursorPage<T>, string | null>,\n        QueryKey,\n        string | null\n    >({\n        ...queryOptions,\n        queryKey: [...queryKey, { limit, orderBy, ascending }],\n        initialPageParam: null,\n        queryFn: ({ pageParam }) =>\n            queryFn({ cursor: pageParam, limit, order_by: orderBy, ascending }),\n        getNextPageParam: (last) => (last.has_more ? last.next_cursor : undefined),\n    });\n\n    const pages = query.data?.pages ?? [];\n\n    return {\n        items: pages.flatMap((p) => p.items),\n        pages,\n        hasNextPage: query.hasNextPage,\n        isLoading: query.isLoading,\n        isFetchingNextPage: query.isFetchingNextPage,\n        error: query.error,\n        fetchNextPage: () => void query.fetchNextPage(),\n        refetch: () => void query.refetch(),\n    };\n}\n"],"names":["useCursorQuery","options","queryKey","queryFn","limit","orderBy","ascending","queryOptions","query","useInfiniteQuery","pageParam","last","pages","p"],"mappings":";AA0DO,SAASA,EAAkBC,GAA4D;AAC1F,QAAM,EAAE,UAAAC,GAAU,SAAAC,GAAS,OAAAC,IAAQ,IAAI,SAAAC,GAAS,WAAAC,IAAY,IAAO,GAAGC,EAAA,IAAiBN,GAEjFO,IAAQC,EAMZ;AAAA,IACE,GAAGF;AAAA,IACH,UAAU,CAAC,GAAGL,GAAU,EAAE,OAAAE,GAAO,SAAAC,GAAS,WAAAC,GAAW;AAAA,IACrD,kBAAkB;AAAA,IAClB,SAAS,CAAC,EAAE,WAAAI,EAAA,MACRP,EAAQ,EAAE,QAAQO,GAAW,OAAAN,GAAO,UAAUC,GAAS,WAAAC,GAAW;AAAA,IACtE,kBAAkB,CAACK,MAAUA,EAAK,WAAWA,EAAK,cAAc;AAAA,EAAA,CACnE,GAEKC,IAAQJ,EAAM,MAAM,SAAS,CAAA;AAEnC,SAAO;AAAA,IACH,OAAOI,EAAM,QAAQ,CAACC,MAAMA,EAAE,KAAK;AAAA,IACnC,OAAAD;AAAA,IACA,aAAaJ,EAAM;AAAA,IACnB,WAAWA,EAAM;AAAA,IACjB,oBAAoBA,EAAM;AAAA,IAC1B,OAAOA,EAAM;AAAA,IACb,eAAe,MAAA;AAAM,MAAKA,EAAM,cAAA;AAAA;AAAA,IAChC,SAAS,MAAA;AAAM,MAAKA,EAAM,QAAA;AAAA;AAAA,EAAQ;AAE1C;"}

package/dist/query/use-offline-mutation.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("@tanstack/react-query");function d(c){const{sync:n,toEntry:l,queryKey:e,applyOptimistic:o,flush:a=!0,invalidate:f=!1}=c,i=s.useQueryClient();return s.useMutation({mutationFn:async u=>{const t=l(u),r=await n.enqueue(t.op,t.recordId,t.payload);if(a!==!1){const y=a===!0?"after-mutation":a;n.flush(y)}return r},onMutate:async u=>{if(!e||!o)return{previous:void 0};await i.cancelQueries({queryKey:e});const t=i.getQueryData(e);return i.setQueryData(e,r=>o(r,u)),{previous:t}},onError:(u,t,r)=>{e&&r&&i.setQueryData(e,r.previous)},onSettled:()=>{f&&e&&i.invalidateQueries({queryKey:e})}})}exports.useOfflineMutation=d;
+//# sourceMappingURL=use-offline-mutation.cjs.map

package/dist/query/use-offline-mutation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-offline-mutation.cjs","sources":["../../src/query/use-offline-mutation.ts"],"sourcesContent":["import { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type { QueryKey, UseMutationResult } from \"@tanstack/react-query\";\nimport type { OfflineSync, OutboxOp, SyncTrigger } from \"../offline\";\n\n/** The outbox entry a mutation's variables map to. */\nexport interface OutboxDraft<TPayload> {\n    /** The mutation kind. */\n    op: OutboxOp;\n    /** Primary key of the affected record. */\n    recordId: string;\n    /** Record snapshot for `create`/`update` (omit for `delete`). */\n    payload?: TPayload;\n}\n\n/**\n * Configuration for {@link useOfflineMutation}.\n *\n * @typeParam TVariables - The `mutate(variables)` input shape.\n * @typeParam TData - The cached query data optimistically patched.\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n */\nexport interface UseOfflineMutationOptions<TVariables, TData, TPayload> {\n    /** The engine the mutation enqueues into. */\n    sync: OfflineSync<TPayload>;\n    /** Map `mutate` variables into an outbox entry. */\n    toEntry: (variables: TVariables) => OutboxDraft<TPayload>;\n    /**\n     * Query key to optimistically patch and (optionally) invalidate. Omit to\n     * only enqueue without touching the React Query cache.\n     */\n    queryKey?: QueryKey;\n    /**\n     * Produce the next cached value from the current one and the variables.\n     * Runs in `onMutate`; the previous value is restored automatically if the\n     * enqueue throws. Requires `queryKey`.\n     */\n    applyOptimistic?: (current: TData | undefined, variables: TVariables) => TData;\n    /**\n     * Trigger a flush after enqueueing. `true` (default) uses\n     * `\"after-mutation\"`; pass a custom {@link SyncTrigger} string, or `false`\n     * to leave flushing to the caller / auto-flush hooks.\n     */\n    flush?: boolean | SyncTrigger;\n    /** Invalidate `queryKey` in `onSettled` so a later read refetches. Default `false`. */\n    invalidate?: boolean;\n}\n\ninterface MutationContext<TData> {\n    previous: TData | undefined;\n}\n\n/**\n * Optimistic mutation that writes to an {@link OfflineSync} outbox instead of\n * hitting the network directly, bridging the sync engine and TanStack Query.\n *\n * On `mutate` it enqueues the entry, optimistically patches the given query\n * cache key and kicks a flush; if the enqueue itself throws, the cache is\n * rolled back to its previous value. Server delivery happens later inside the\n * engine's flush loop, so the UI updates instantly and survives reloads and\n * offline periods.\n *\n * @typeParam TVariables - The `mutate(variables)` input shape.\n * @typeParam TData - The cached query data optimistically patched.\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n * @param options - Engine, variables→entry mapping and cache wiring.\n * @returns The TanStack {@link UseMutationResult}; the mutation resolves to the\n *   generated outbox entry id.\n *\n * @example\n * const addNote = useOfflineMutation({\n *     sync: notesSync,\n *     queryKey: [\"notes\"],\n *     toEntry: (note: Note) => ({ op: \"create\", recordId: note.id, payload: note }),\n *     applyOptimistic: (current: Note[] = [], note) => [...current, note],\n * });\n * addNote.mutate(newNote);\n */\nexport function useOfflineMutation<TVariables, TData = unknown, TPayload = unknown>(\n    options: UseOfflineMutationOptions<TVariables, TData, TPayload>,\n): UseMutationResult<string, Error, TVariables, MutationContext<TData>> {\n    const { sync, toEntry, queryKey, applyOptimistic, flush = true, invalidate = false } = options;\n    const client = useQueryClient();\n\n    return useMutation<string, Error, TVariables, MutationContext<TData>>({\n        mutationFn: async (variables) => {\n            const draft = toEntry(variables);\n            const id = await sync.enqueue(draft.op, draft.recordId, draft.payload);\n            if (flush !== false) {\n                const trigger: SyncTrigger = flush === true ? \"after-mutation\" : flush;\n                void sync.flush(trigger);\n            }\n            return id;\n        },\n        onMutate: async (variables) => {\n            if (!queryKey || !applyOptimistic) return { previous: undefined };\n            await client.cancelQueries({ queryKey });\n            const previous = client.getQueryData<TData>(queryKey);\n            client.setQueryData<TData>(queryKey, (current) => applyOptimistic(current, variables));\n            return { previous };\n        },\n        onError: (_error, _variables, context) => {\n            if (queryKey && context) client.setQueryData(queryKey, context.previous);\n        },\n        onSettled: () => {\n            if (invalidate && queryKey) void client.invalidateQueries({ queryKey });\n        },\n    });\n}\n"],"names":["useOfflineMutation","options","sync","toEntry","queryKey","applyOptimistic","flush","invalidate","client","useQueryClient","useMutation","variables","draft","id","trigger","previous","current","_error","_variables","context"],"mappings":"yHA6EO,SAASA,EACZC,EACoE,CACpE,KAAM,CAAE,KAAAC,EAAM,QAAAC,EAAS,SAAAC,EAAU,gBAAAC,EAAiB,MAAAC,EAAQ,GAAM,WAAAC,EAAa,EAAA,EAAUN,EACjFO,EAASC,EAAAA,eAAA,EAEf,OAAOC,cAA+D,CAClE,WAAY,MAAOC,GAAc,CAC7B,MAAMC,EAAQT,EAAQQ,CAAS,EACzBE,EAAK,MAAMX,EAAK,QAAQU,EAAM,GAAIA,EAAM,SAAUA,EAAM,OAAO,EACrE,GAAIN,IAAU,GAAO,CACjB,MAAMQ,EAAuBR,IAAU,GAAO,iBAAmBA,EAC5DJ,EAAK,MAAMY,CAAO,CAC3B,CACA,OAAOD,CACX,EACA,SAAU,MAAOF,GAAc,CAC3B,GAAI,CAACP,GAAY,CAACC,EAAiB,MAAO,CAAE,SAAU,MAAA,EACtD,MAAMG,EAAO,cAAc,CAAE,SAAAJ,EAAU,EACvC,MAAMW,EAAWP,EAAO,aAAoBJ,CAAQ,EACpD,OAAAI,EAAO,aAAoBJ,EAAWY,GAAYX,EAAgBW,EAASL,CAAS,CAAC,EAC9E,CAAE,SAAAI,CAAA,CACb,EACA,QAAS,CAACE,EAAQC,EAAYC,IAAY,CAClCf,GAAYe,GAASX,EAAO,aAAaJ,EAAUe,EAAQ,QAAQ,CAC3E,EACA,UAAW,IAAM,CACTZ,GAAcH,GAAeI,EAAO,kBAAkB,CAAE,SAAAJ,EAAU,CAC1E,CAAA,CACH,CACL"}

package/dist/query/use-offline-mutation.js

@@ -0,0 +1,30 @@
+import { useQueryClient as y, useMutation as d } from "@tanstack/react-query";
+function v(s) {
+  const { sync: u, toEntry: c, queryKey: e, applyOptimistic: o, flush: n = !0, invalidate: f = !1 } = s, i = y();
+  return d({
+    mutationFn: async (a) => {
+      const t = c(a), r = await u.enqueue(t.op, t.recordId, t.payload);
+      if (n !== !1) {
+        const l = n === !0 ? "after-mutation" : n;
+        u.flush(l);
+      }
+      return r;
+    },
+    onMutate: async (a) => {
+      if (!e || !o) return { previous: void 0 };
+      await i.cancelQueries({ queryKey: e });
+      const t = i.getQueryData(e);
+      return i.setQueryData(e, (r) => o(r, a)), { previous: t };
+    },
+    onError: (a, t, r) => {
+      e && r && i.setQueryData(e, r.previous);
+    },
+    onSettled: () => {
+      f && e && i.invalidateQueries({ queryKey: e });
+    }
+  });
+}
+export {
+  v as useOfflineMutation
+};
+//# sourceMappingURL=use-offline-mutation.js.map

package/dist/query/use-offline-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-offline-mutation.js","sources":["../../src/query/use-offline-mutation.ts"],"sourcesContent":["import { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport type { QueryKey, UseMutationResult } from \"@tanstack/react-query\";\nimport type { OfflineSync, OutboxOp, SyncTrigger } from \"../offline\";\n\n/** The outbox entry a mutation's variables map to. */\nexport interface OutboxDraft<TPayload> {\n    /** The mutation kind. */\n    op: OutboxOp;\n    /** Primary key of the affected record. */\n    recordId: string;\n    /** Record snapshot for `create`/`update` (omit for `delete`). */\n    payload?: TPayload;\n}\n\n/**\n * Configuration for {@link useOfflineMutation}.\n *\n * @typeParam TVariables - The `mutate(variables)` input shape.\n * @typeParam TData - The cached query data optimistically patched.\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n */\nexport interface UseOfflineMutationOptions<TVariables, TData, TPayload> {\n    /** The engine the mutation enqueues into. */\n    sync: OfflineSync<TPayload>;\n    /** Map `mutate` variables into an outbox entry. */\n    toEntry: (variables: TVariables) => OutboxDraft<TPayload>;\n    /**\n     * Query key to optimistically patch and (optionally) invalidate. Omit to\n     * only enqueue without touching the React Query cache.\n     */\n    queryKey?: QueryKey;\n    /**\n     * Produce the next cached value from the current one and the variables.\n     * Runs in `onMutate`; the previous value is restored automatically if the\n     * enqueue throws. Requires `queryKey`.\n     */\n    applyOptimistic?: (current: TData | undefined, variables: TVariables) => TData;\n    /**\n     * Trigger a flush after enqueueing. `true` (default) uses\n     * `\"after-mutation\"`; pass a custom {@link SyncTrigger} string, or `false`\n     * to leave flushing to the caller / auto-flush hooks.\n     */\n    flush?: boolean | SyncTrigger;\n    /** Invalidate `queryKey` in `onSettled` so a later read refetches. Default `false`. */\n    invalidate?: boolean;\n}\n\ninterface MutationContext<TData> {\n    previous: TData | undefined;\n}\n\n/**\n * Optimistic mutation that writes to an {@link OfflineSync} outbox instead of\n * hitting the network directly, bridging the sync engine and TanStack Query.\n *\n * On `mutate` it enqueues the entry, optimistically patches the given query\n * cache key and kicks a flush; if the enqueue itself throws, the cache is\n * rolled back to its previous value. Server delivery happens later inside the\n * engine's flush loop, so the UI updates instantly and survives reloads and\n * offline periods.\n *\n * @typeParam TVariables - The `mutate(variables)` input shape.\n * @typeParam TData - The cached query data optimistically patched.\n * @typeParam TPayload - Record snapshot carried by outbox entries.\n * @param options - Engine, variables→entry mapping and cache wiring.\n * @returns The TanStack {@link UseMutationResult}; the mutation resolves to the\n *   generated outbox entry id.\n *\n * @example\n * const addNote = useOfflineMutation({\n *     sync: notesSync,\n *     queryKey: [\"notes\"],\n *     toEntry: (note: Note) => ({ op: \"create\", recordId: note.id, payload: note }),\n *     applyOptimistic: (current: Note[] = [], note) => [...current, note],\n * });\n * addNote.mutate(newNote);\n */\nexport function useOfflineMutation<TVariables, TData = unknown, TPayload = unknown>(\n    options: UseOfflineMutationOptions<TVariables, TData, TPayload>,\n): UseMutationResult<string, Error, TVariables, MutationContext<TData>> {\n    const { sync, toEntry, queryKey, applyOptimistic, flush = true, invalidate = false } = options;\n    const client = useQueryClient();\n\n    return useMutation<string, Error, TVariables, MutationContext<TData>>({\n        mutationFn: async (variables) => {\n            const draft = toEntry(variables);\n            const id = await sync.enqueue(draft.op, draft.recordId, draft.payload);\n            if (flush !== false) {\n                const trigger: SyncTrigger = flush === true ? \"after-mutation\" : flush;\n                void sync.flush(trigger);\n            }\n            return id;\n        },\n        onMutate: async (variables) => {\n            if (!queryKey || !applyOptimistic) return { previous: undefined };\n            await client.cancelQueries({ queryKey });\n            const previous = client.getQueryData<TData>(queryKey);\n            client.setQueryData<TData>(queryKey, (current) => applyOptimistic(current, variables));\n            return { previous };\n        },\n        onError: (_error, _variables, context) => {\n            if (queryKey && context) client.setQueryData(queryKey, context.previous);\n        },\n        onSettled: () => {\n            if (invalidate && queryKey) void client.invalidateQueries({ queryKey });\n        },\n    });\n}\n"],"names":["useOfflineMutation","options","sync","toEntry","queryKey","applyOptimistic","flush","invalidate","client","useQueryClient","useMutation","variables","draft","id","trigger","previous","current","_error","_variables","context"],"mappings":";AA6EO,SAASA,EACZC,GACoE;AACpE,QAAM,EAAE,MAAAC,GAAM,SAAAC,GAAS,UAAAC,GAAU,iBAAAC,GAAiB,OAAAC,IAAQ,IAAM,YAAAC,IAAa,GAAA,IAAUN,GACjFO,IAASC,EAAA;AAEf,SAAOC,EAA+D;AAAA,IAClE,YAAY,OAAOC,MAAc;AAC7B,YAAMC,IAAQT,EAAQQ,CAAS,GACzBE,IAAK,MAAMX,EAAK,QAAQU,EAAM,IAAIA,EAAM,UAAUA,EAAM,OAAO;AACrE,UAAIN,MAAU,IAAO;AACjB,cAAMQ,IAAuBR,MAAU,KAAO,mBAAmBA;AACjE,QAAKJ,EAAK,MAAMY,CAAO;AAAA,MAC3B;AACA,aAAOD;AAAA,IACX;AAAA,IACA,UAAU,OAAOF,MAAc;AAC3B,UAAI,CAACP,KAAY,CAACC,EAAiB,QAAO,EAAE,UAAU,OAAA;AACtD,YAAMG,EAAO,cAAc,EAAE,UAAAJ,GAAU;AACvC,YAAMW,IAAWP,EAAO,aAAoBJ,CAAQ;AACpD,aAAAI,EAAO,aAAoBJ,GAAU,CAACY,MAAYX,EAAgBW,GAASL,CAAS,CAAC,GAC9E,EAAE,UAAAI,EAAA;AAAA,IACb;AAAA,IACA,SAAS,CAACE,GAAQC,GAAYC,MAAY;AACtC,MAAIf,KAAYe,KAASX,EAAO,aAAaJ,GAAUe,EAAQ,QAAQ;AAAA,IAC3E;AAAA,IACA,WAAW,MAAM;AACb,MAAIZ,KAAcH,KAAeI,EAAO,kBAAkB,EAAE,UAAAJ,GAAU;AAAA,IAC1E;AAAA,EAAA,CACH;AACL;"}

package/dist/query/use-paginated-query.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react"),y=require("@tanstack/react-query");function k(l){const{queryKey:d,queryFn:p,initialPage:P=1,pageSize:u=20,sizeParam:c="size",orderBy:o,ascending:g=!1,...b}=l,[t,i]=n.useState(P),a=y.useQuery({...b,queryKey:[...d,{page:t,pageSize:u,sizeParam:c,orderBy:o,ascending:g}],queryFn:()=>{const e={page:t,[c]:u};return o&&(e.order_by=o,e.ascending=g),p(e)},placeholderData:y.keepPreviousData}),r=a.data,s=r?.pages??0,h=t<s,m=t>1,q=n.useCallback(e=>i(Math.max(1,e)),[]),f=n.useCallback(()=>i(e=>e<s?e+1:e),[s]),v=n.useCallback(()=>i(e=>e>1?e-1:e),[]);return{page:r,items:r?.items??[],pageNumber:t,pageCount:s,total:r?.total??0,hasNext:h,hasPrev:m,isLoading:a.isLoading,isFetching:a.isFetching,error:a.error,setPage:q,next:f,prev:v,refetch:()=>{a.refetch()}}}exports.usePaginatedQuery=k;
+//# sourceMappingURL=use-paginated-query.cjs.map

package/dist/query/use-paginated-query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-paginated-query.cjs","sources":["../../src/query/use-paginated-query.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport { keepPreviousData, useQuery } from \"@tanstack/react-query\";\nimport type { QueryKey, UseQueryOptions } from \"@tanstack/react-query\";\n\nimport type { OffsetPage, OffsetParams } from \"./pagination\";\n\nexport interface UsePaginatedQueryOptions<T> extends Omit<\n    UseQueryOptions<OffsetPage<T>, Error, OffsetPage<T>, QueryKey>,\n    \"queryKey\" | \"queryFn\"\n> {\n    /** Base query key — the current page/sort is appended for cache isolation. */\n    queryKey: QueryKey;\n    /** Fetcher receiving the offset params; return the backend envelope. */\n    queryFn: (params: OffsetParams) => Promise<OffsetPage<T>> | OffsetPage<T>;\n    /** Initial 1-based page. Default: 1. */\n    initialPage?: number;\n    /** Page size. Default: 20. */\n    pageSize?: number;\n    /**\n     * Query-param name for the page size. fastapi-pagination uses `\"size\"`\n     * (default); SDK `BasePaginationFilterSchema` configs may use `\"page_size\"`.\n     */\n    sizeParam?: \"size\" | \"page_size\";\n    /** Initial `order_by` (only sent when set). */\n    orderBy?: string;\n    /** Initial `ascending` (only sent when `orderBy` is set). Default: false. */\n    ascending?: boolean;\n}\n\nexport interface UsePaginatedQueryResult<T> {\n    /** The current page envelope, or undefined while the first load is pending. */\n    page: OffsetPage<T> | undefined;\n    /** The rows of the current page (empty array while pending). */\n    items: T[];\n    /** Current 1-based page number (controlled by the hook). */\n    pageNumber: number;\n    /** Total page count from the last successful response. */\n    pageCount: number;\n    /** Total row count from the last successful response. */\n    total: number;\n    hasNext: boolean;\n    hasPrev: boolean;\n    isLoading: boolean;\n    isFetching: boolean;\n    error: Error | null;\n    /** Jump to a specific 1-based page (clamped to >= 1). */\n    setPage: (page: number) => void;\n    /** Go to the next page when available. */\n    next: () => void;\n    /** Go to the previous page when available. */\n    prev: () => void;\n    /** Refetch the current page. */\n    refetch: () => void;\n}\n\n/**\n * Offset-pagination hook over TanStack Query for the fastapi-pagination /\n * Tempest envelope (`{ items, total, page, size, pages }`).\n *\n * It owns the page state, sends `page` + the size param (`size` by default,\n * or `page_size` via `sizeParam`) plus optional `order_by`/`ascending` to your\n * fetcher, keeps the previous page visible while the next loads, and derives\n * `hasNext`/`hasPrev`/`pageCount`.\n *\n * @example\n * const users = usePaginatedQuery<User>({\n *     queryKey: [\"users\"],\n *     pageSize: 25,\n *     queryFn: (params) => usersService.listUsers(params),\n * });\n * // users.items, users.next(), users.hasNext, users.pageCount\n */\nexport function usePaginatedQuery<T>(\n    options: UsePaginatedQueryOptions<T>,\n): UsePaginatedQueryResult<T> {\n    const {\n        queryKey,\n        queryFn,\n        initialPage = 1,\n        pageSize = 20,\n        sizeParam = \"size\",\n        orderBy,\n        ascending = false,\n        ...queryOptions\n    } = options;\n\n    const [pageNumber, setPageNumber] = useState(initialPage);\n\n    const query = useQuery<OffsetPage<T>, Error>({\n        ...queryOptions,\n        queryKey: [...queryKey, { page: pageNumber, pageSize, sizeParam, orderBy, ascending }],\n        queryFn: () => {\n            const params: OffsetParams = { page: pageNumber, [sizeParam]: pageSize };\n            if (orderBy) {\n                params.order_by = orderBy;\n                params.ascending = ascending;\n            }\n            return queryFn(params);\n        },\n        placeholderData: keepPreviousData,\n    });\n\n    const page = query.data;\n    const pageCount = page?.pages ?? 0;\n    const hasNext = pageNumber < pageCount;\n    const hasPrev = pageNumber > 1;\n\n    const setPage = useCallback((next: number) => setPageNumber(Math.max(1, next)), []);\n    const next = useCallback(() => setPageNumber((p) => (p < pageCount ? p + 1 : p)), [pageCount]);\n    const prev = useCallback(() => setPageNumber((p) => (p > 1 ? p - 1 : p)), []);\n\n    return {\n        page,\n        items: page?.items ?? [],\n        pageNumber,\n        pageCount,\n        total: page?.total ?? 0,\n        hasNext,\n        hasPrev,\n        isLoading: query.isLoading,\n        isFetching: query.isFetching,\n        error: query.error,\n        setPage,\n        next,\n        prev,\n        refetch: () => void query.refetch(),\n    };\n}\n"],"names":["usePaginatedQuery","options","queryKey","queryFn","initialPage","pageSize","sizeParam","orderBy","ascending","queryOptions","pageNumber","setPageNumber","useState","query","useQuery","params","keepPreviousData","page","pageCount","hasNext","hasPrev","setPage","useCallback","next","p","prev"],"mappings":"4IAwEO,SAASA,EACZC,EAC0B,CAC1B,KAAM,CACF,SAAAC,EACA,QAAAC,EACA,YAAAC,EAAc,EACd,SAAAC,EAAW,GACX,UAAAC,EAAY,OACZ,QAAAC,EACA,UAAAC,EAAY,GACZ,GAAGC,CAAA,EACHR,EAEE,CAACS,EAAYC,CAAa,EAAIC,EAAAA,SAASR,CAAW,EAElDS,EAAQC,EAAAA,SAA+B,CACzC,GAAGL,EACH,SAAU,CAAC,GAAGP,EAAU,CAAE,KAAMQ,EAAY,SAAAL,EAAU,UAAAC,EAAW,QAAAC,EAAS,UAAAC,EAAW,EACrF,QAAS,IAAM,CACX,MAAMO,EAAuB,CAAE,KAAML,EAAY,CAACJ,CAAS,EAAGD,CAAA,EAC9D,OAAIE,IACAQ,EAAO,SAAWR,EAClBQ,EAAO,UAAYP,GAEhBL,EAAQY,CAAM,CACzB,EACA,gBAAiBC,EAAAA,gBAAA,CACpB,EAEKC,EAAOJ,EAAM,KACbK,EAAYD,GAAM,OAAS,EAC3BE,EAAUT,EAAaQ,EACvBE,EAAUV,EAAa,EAEvBW,EAAUC,EAAAA,YAAaC,GAAiBZ,EAAc,KAAK,IAAI,EAAGY,CAAI,CAAC,EAAG,CAAA,CAAE,EAC5EA,EAAOD,EAAAA,YAAY,IAAMX,EAAea,GAAOA,EAAIN,EAAYM,EAAI,EAAIA,CAAE,EAAG,CAACN,CAAS,CAAC,EACvFO,EAAOH,EAAAA,YAAY,IAAMX,EAAea,GAAOA,EAAI,EAAIA,EAAI,EAAIA,CAAE,EAAG,CAAA,CAAE,EAE5E,MAAO,CACH,KAAAP,EACA,MAAOA,GAAM,OAAS,CAAA,EACtB,WAAAP,EACA,UAAAQ,EACA,MAAOD,GAAM,OAAS,EACtB,QAAAE,EACA,QAAAC,EACA,UAAWP,EAAM,UACjB,WAAYA,EAAM,WAClB,MAAOA,EAAM,MACb,QAAAQ,EACA,KAAAE,EACA,KAAAE,EACA,QAAS,IAAA,CAAWZ,EAAM,QAAA,EAAQ,CAE1C"}

package/dist/query/use-paginated-query.js

@@ -0,0 +1,44 @@
+import { useState as v, useCallback as i } from "react";
+import { useQuery as x, keepPreviousData as F } from "@tanstack/react-query";
+function k(y) {
+  const {
+    queryKey: m,
+    queryFn: p,
+    initialPage: d = 1,
+    pageSize: c = 20,
+    sizeParam: u = "size",
+    orderBy: n,
+    ascending: g = !1,
+    ...h
+  } = y, [t, o] = v(d), a = x({
+    ...h,
+    queryKey: [...m, { page: t, pageSize: c, sizeParam: u, orderBy: n, ascending: g }],
+    queryFn: () => {
+      const e = { page: t, [u]: c };
+      return n && (e.order_by = n, e.ascending = g), p(e);
+    },
+    placeholderData: F
+  }), r = a.data, s = r?.pages ?? 0, l = t < s, f = t > 1, P = i((e) => o(Math.max(1, e)), []), q = i(() => o((e) => e < s ? e + 1 : e), [s]), b = i(() => o((e) => e > 1 ? e - 1 : e), []);
+  return {
+    page: r,
+    items: r?.items ?? [],
+    pageNumber: t,
+    pageCount: s,
+    total: r?.total ?? 0,
+    hasNext: l,
+    hasPrev: f,
+    isLoading: a.isLoading,
+    isFetching: a.isFetching,
+    error: a.error,
+    setPage: P,
+    next: q,
+    prev: b,
+    refetch: () => {
+      a.refetch();
+    }
+  };
+}
+export {
+  k as usePaginatedQuery
+};
+//# sourceMappingURL=use-paginated-query.js.map

package/dist/query/use-paginated-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-paginated-query.js","sources":["../../src/query/use-paginated-query.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport { keepPreviousData, useQuery } from \"@tanstack/react-query\";\nimport type { QueryKey, UseQueryOptions } from \"@tanstack/react-query\";\n\nimport type { OffsetPage, OffsetParams } from \"./pagination\";\n\nexport interface UsePaginatedQueryOptions<T> extends Omit<\n    UseQueryOptions<OffsetPage<T>, Error, OffsetPage<T>, QueryKey>,\n    \"queryKey\" | \"queryFn\"\n> {\n    /** Base query key — the current page/sort is appended for cache isolation. */\n    queryKey: QueryKey;\n    /** Fetcher receiving the offset params; return the backend envelope. */\n    queryFn: (params: OffsetParams) => Promise<OffsetPage<T>> | OffsetPage<T>;\n    /** Initial 1-based page. Default: 1. */\n    initialPage?: number;\n    /** Page size. Default: 20. */\n    pageSize?: number;\n    /**\n     * Query-param name for the page size. fastapi-pagination uses `\"size\"`\n     * (default); SDK `BasePaginationFilterSchema` configs may use `\"page_size\"`.\n     */\n    sizeParam?: \"size\" | \"page_size\";\n    /** Initial `order_by` (only sent when set). */\n    orderBy?: string;\n    /** Initial `ascending` (only sent when `orderBy` is set). Default: false. */\n    ascending?: boolean;\n}\n\nexport interface UsePaginatedQueryResult<T> {\n    /** The current page envelope, or undefined while the first load is pending. */\n    page: OffsetPage<T> | undefined;\n    /** The rows of the current page (empty array while pending). */\n    items: T[];\n    /** Current 1-based page number (controlled by the hook). */\n    pageNumber: number;\n    /** Total page count from the last successful response. */\n    pageCount: number;\n    /** Total row count from the last successful response. */\n    total: number;\n    hasNext: boolean;\n    hasPrev: boolean;\n    isLoading: boolean;\n    isFetching: boolean;\n    error: Error | null;\n    /** Jump to a specific 1-based page (clamped to >= 1). */\n    setPage: (page: number) => void;\n    /** Go to the next page when available. */\n    next: () => void;\n    /** Go to the previous page when available. */\n    prev: () => void;\n    /** Refetch the current page. */\n    refetch: () => void;\n}\n\n/**\n * Offset-pagination hook over TanStack Query for the fastapi-pagination /\n * Tempest envelope (`{ items, total, page, size, pages }`).\n *\n * It owns the page state, sends `page` + the size param (`size` by default,\n * or `page_size` via `sizeParam`) plus optional `order_by`/`ascending` to your\n * fetcher, keeps the previous page visible while the next loads, and derives\n * `hasNext`/`hasPrev`/`pageCount`.\n *\n * @example\n * const users = usePaginatedQuery<User>({\n *     queryKey: [\"users\"],\n *     pageSize: 25,\n *     queryFn: (params) => usersService.listUsers(params),\n * });\n * // users.items, users.next(), users.hasNext, users.pageCount\n */\nexport function usePaginatedQuery<T>(\n    options: UsePaginatedQueryOptions<T>,\n): UsePaginatedQueryResult<T> {\n    const {\n        queryKey,\n        queryFn,\n        initialPage = 1,\n        pageSize = 20,\n        sizeParam = \"size\",\n        orderBy,\n        ascending = false,\n        ...queryOptions\n    } = options;\n\n    const [pageNumber, setPageNumber] = useState(initialPage);\n\n    const query = useQuery<OffsetPage<T>, Error>({\n        ...queryOptions,\n        queryKey: [...queryKey, { page: pageNumber, pageSize, sizeParam, orderBy, ascending }],\n        queryFn: () => {\n            const params: OffsetParams = { page: pageNumber, [sizeParam]: pageSize };\n            if (orderBy) {\n                params.order_by = orderBy;\n                params.ascending = ascending;\n            }\n            return queryFn(params);\n        },\n        placeholderData: keepPreviousData,\n    });\n\n    const page = query.data;\n    const pageCount = page?.pages ?? 0;\n    const hasNext = pageNumber < pageCount;\n    const hasPrev = pageNumber > 1;\n\n    const setPage = useCallback((next: number) => setPageNumber(Math.max(1, next)), []);\n    const next = useCallback(() => setPageNumber((p) => (p < pageCount ? p + 1 : p)), [pageCount]);\n    const prev = useCallback(() => setPageNumber((p) => (p > 1 ? p - 1 : p)), []);\n\n    return {\n        page,\n        items: page?.items ?? [],\n        pageNumber,\n        pageCount,\n        total: page?.total ?? 0,\n        hasNext,\n        hasPrev,\n        isLoading: query.isLoading,\n        isFetching: query.isFetching,\n        error: query.error,\n        setPage,\n        next,\n        prev,\n        refetch: () => void query.refetch(),\n    };\n}\n"],"names":["usePaginatedQuery","options","queryKey","queryFn","initialPage","pageSize","sizeParam","orderBy","ascending","queryOptions","pageNumber","setPageNumber","useState","query","useQuery","params","keepPreviousData","page","pageCount","hasNext","hasPrev","setPage","useCallback","next","p","prev"],"mappings":";;AAwEO,SAASA,EACZC,GAC0B;AAC1B,QAAM;AAAA,IACF,UAAAC;AAAA,IACA,SAAAC;AAAA,IACA,aAAAC,IAAc;AAAA,IACd,UAAAC,IAAW;AAAA,IACX,WAAAC,IAAY;AAAA,IACZ,SAAAC;AAAA,IACA,WAAAC,IAAY;AAAA,IACZ,GAAGC;AAAA,EAAA,IACHR,GAEE,CAACS,GAAYC,CAAa,IAAIC,EAASR,CAAW,GAElDS,IAAQC,EAA+B;AAAA,IACzC,GAAGL;AAAA,IACH,UAAU,CAAC,GAAGP,GAAU,EAAE,MAAMQ,GAAY,UAAAL,GAAU,WAAAC,GAAW,SAAAC,GAAS,WAAAC,GAAW;AAAA,IACrF,SAAS,MAAM;AACX,YAAMO,IAAuB,EAAE,MAAML,GAAY,CAACJ,CAAS,GAAGD,EAAA;AAC9D,aAAIE,MACAQ,EAAO,WAAWR,GAClBQ,EAAO,YAAYP,IAEhBL,EAAQY,CAAM;AAAA,IACzB;AAAA,IACA,iBAAiBC;AAAA,EAAA,CACpB,GAEKC,IAAOJ,EAAM,MACbK,IAAYD,GAAM,SAAS,GAC3BE,IAAUT,IAAaQ,GACvBE,IAAUV,IAAa,GAEvBW,IAAUC,EAAY,CAACC,MAAiBZ,EAAc,KAAK,IAAI,GAAGY,CAAI,CAAC,GAAG,CAAA,CAAE,GAC5EA,IAAOD,EAAY,MAAMX,EAAc,CAACa,MAAOA,IAAIN,IAAYM,IAAI,IAAIA,CAAE,GAAG,CAACN,CAAS,CAAC,GACvFO,IAAOH,EAAY,MAAMX,EAAc,CAACa,MAAOA,IAAI,IAAIA,IAAI,IAAIA,CAAE,GAAG,CAAA,CAAE;AAE5E,SAAO;AAAA,IACH,MAAAP;AAAA,IACA,OAAOA,GAAM,SAAS,CAAA;AAAA,IACtB,YAAAP;AAAA,IACA,WAAAQ;AAAA,IACA,OAAOD,GAAM,SAAS;AAAA,IACtB,SAAAE;AAAA,IACA,SAAAC;AAAA,IACA,WAAWP,EAAM;AAAA,IACjB,YAAYA,EAAM;AAAA,IAClB,OAAOA,EAAM;AAAA,IACb,SAAAQ;AAAA,IACA,MAAAE;AAAA,IACA,MAAAE;AAAA,IACA,SAAS,MAAA;AAAM,MAAKZ,EAAM,QAAA;AAAA;AAAA,EAAQ;AAE1C;"}

package/dist/router/AppRouter.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react/jsx-runtime"),c=require("react"),s=require("react-router-dom"),h=require("../auth/lazy-with-retry.cjs"),m=require("./RouteGuard.cjs");function p(t){return t}const u=new WeakMap;function y(t){let e=u.get(t);return e||(e=h.lazyWithRetry(t.lazy),u.set(t,e)),e}function f({guard:t,redirectTo:e,children:o}){const n=typeof t=="function"?t():t;return r.jsx(m.RouteGuard,{when:n,redirectTo:e,children:o})}function l(t){return t.map((e,o)=>{let n=e.element;if(e.lazy){const i=y(e);n=r.jsx(i,{})}return e.guard!==void 0&&(n=r.jsx(f,{guard:e.guard,redirectTo:e.redirectTo,children:n})),e.index?r.jsx(s.Route,{index:!0,element:n},`index-${o}`):r.jsx(s.Route,{path:e.path,element:n,caseSensitive:e.caseSensitive,children:e.children?l(e.children):null},e.path??`route-${o}`)})}const x={browser:s.BrowserRouter,hash:s.HashRouter,memory:s.MemoryRouter};function j({routes:t,router:e="browser",basename:o,initialEntries:n,fallback:i=null}){const a=c.useMemo(()=>l(t),[t]),d=x[e],R=e==="memory"?{basename:o,initialEntries:n}:{basename:o};return r.jsx(d,{...R,children:r.jsx(c.Suspense,{fallback:i,children:r.jsx(s.Routes,{children:a})})})}exports.AppRouter=j;exports.defineRoutes=p;
+//# sourceMappingURL=AppRouter.cjs.map

package/dist/router/AppRouter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppRouter.cjs","sources":["../../src/router/AppRouter.tsx"],"sourcesContent":["import { Suspense, useMemo } from \"react\";\nimport type { ComponentType, ReactNode } from \"react\";\nimport { BrowserRouter, HashRouter, MemoryRouter, Routes, Route } from \"react-router-dom\";\nimport { lazyWithRetry } from \"../auth/lazy-with-retry\";\nimport { RouteGuard } from \"./RouteGuard\";\nimport type { RouterKind, TempestRouteObject } from \"./types\";\n\n/**\n * Identity helper that types a declarative route tree. Use it so editors give\n * autocomplete and type-checking on every node; the array is returned as-is.\n *\n * @example\n * export const routes = defineRoutes([\n *     { path: \"/\", element: <Layout />, children: [\n *         { index: true, lazy: () => import(\"./pages/Home\") },\n *         { path: \"settings\", lazy: () => import(\"./pages/Settings\"),\n *           guard: () => useAuth.getState().isAuthenticated, redirectTo: \"/login\" },\n *     ] },\n * ]);\n */\nexport function defineRoutes(routes: TempestRouteObject[]): TempestRouteObject[] {\n    return routes;\n}\n\nconst lazyCache = new WeakMap<TempestRouteObject, ComponentType<unknown>>();\n\nfunction resolveLazy(route: TempestRouteObject): ComponentType<unknown> {\n    let comp = lazyCache.get(route);\n    if (!comp) {\n        comp = lazyWithRetry(route.lazy!);\n        lazyCache.set(route, comp);\n    }\n    return comp;\n}\n\nfunction GuardedElement({\n    guard,\n    redirectTo,\n    children,\n}: {\n    guard: boolean | (() => boolean);\n    redirectTo?: string;\n    children: ReactNode;\n}) {\n    const allowed = typeof guard === \"function\" ? guard() : guard;\n    return (\n        <RouteGuard when={allowed} redirectTo={redirectTo}>\n            {children}\n        </RouteGuard>\n    );\n}\n\nfunction toRouteElements(routes: TempestRouteObject[]): ReactNode {\n    return routes.map((route, i) => {\n        let element: ReactNode = route.element;\n        if (route.lazy) {\n            const LazyComponent = resolveLazy(route);\n            element = <LazyComponent />;\n        }\n        if (route.guard !== undefined) {\n            element = (\n                <GuardedElement guard={route.guard} redirectTo={route.redirectTo}>\n                    {element}\n                </GuardedElement>\n            );\n        }\n\n        if (route.index) {\n            return <Route key={`index-${i}`} index element={element} />;\n        }\n\n        return (\n            <Route\n                key={route.path ?? `route-${i}`}\n                path={route.path}\n                element={element}\n                caseSensitive={route.caseSensitive}\n            >\n                {route.children ? toRouteElements(route.children) : null}\n            </Route>\n        );\n    });\n}\n\nconst ROUTERS: Record<RouterKind, typeof BrowserRouter> = {\n    browser: BrowserRouter,\n    hash: HashRouter,\n    memory: MemoryRouter,\n};\n\nexport interface AppRouterProps {\n    /** Declarative route tree, ideally built with {@link defineRoutes}. */\n    routes: TempestRouteObject[];\n    /** History strategy (default: `\"browser\"`). */\n    router?: RouterKind;\n    /** App-wide base path forwarded to the underlying router. */\n    basename?: string;\n    /** Initial URLs for the `\"memory\"` router (tests / non-DOM hosts). */\n    initialEntries?: string[];\n    /** Suspense fallback shown while a `lazy` route chunk loads. */\n    fallback?: ReactNode;\n}\n\n/**\n * Render a full React Router (v7, declarative mode) from a {@link defineRoutes}\n * tree: picks the history strategy, wraps everything in a `<Suspense>` boundary\n * for `lazy` routes, and applies per-route `guard` redirects. This is the\n * single entry point apps mount at their root.\n *\n * @example\n * <AppRouter routes={routes} fallback={<Spinner />} />\n */\nexport function AppRouter({\n    routes,\n    router = \"browser\",\n    basename,\n    initialEntries,\n    fallback = null,\n}: AppRouterProps) {\n    const tree = useMemo(() => toRouteElements(routes), [routes]);\n    const Router = ROUTERS[router];\n    const routerProps = router === \"memory\" ? { basename, initialEntries } : { basename };\n\n    return (\n        <Router {...routerProps}>\n            <Suspense fallback={fallback}>\n                <Routes>{tree}</Routes>\n            </Suspense>\n        </Router>\n    );\n}\n"],"names":["defineRoutes","routes","lazyCache","resolveLazy","route","comp","lazyWithRetry","GuardedElement","guard","redirectTo","children","allowed","jsx","RouteGuard","toRouteElements","i","element","LazyComponent","Route","ROUTERS","BrowserRouter","HashRouter","MemoryRouter","AppRouter","router","basename","initialEntries","fallback","tree","useMemo","Router","routerProps","Suspense","Routes"],"mappings":"6OAoBO,SAASA,EAAaC,EAAoD,CAC7E,OAAOA,CACX,CAEA,MAAMC,MAAgB,QAEtB,SAASC,EAAYC,EAAmD,CACpE,IAAIC,EAAOH,EAAU,IAAIE,CAAK,EAC9B,OAAKC,IACDA,EAAOC,EAAAA,cAAcF,EAAM,IAAK,EAChCF,EAAU,IAAIE,EAAOC,CAAI,GAEtBA,CACX,CAEA,SAASE,EAAe,CACpB,MAAAC,EACA,WAAAC,EACA,SAAAC,CACJ,EAIG,CACC,MAAMC,EAAU,OAAOH,GAAU,WAAaA,IAAUA,EACxD,OACII,EAAAA,IAACC,EAAAA,WAAA,CAAW,KAAMF,EAAS,WAAAF,EACtB,SAAAC,EACL,CAER,CAEA,SAASI,EAAgBb,EAAyC,CAC9D,OAAOA,EAAO,IAAI,CAACG,EAAOW,IAAM,CAC5B,IAAIC,EAAqBZ,EAAM,QAC/B,GAAIA,EAAM,KAAM,CACZ,MAAMa,EAAgBd,EAAYC,CAAK,EACvCY,QAAWC,EAAA,EAAc,CAC7B,CASA,OARIb,EAAM,QAAU,SAChBY,EACIJ,EAAAA,IAACL,GAAe,MAAOH,EAAM,MAAO,WAAYA,EAAM,WACjD,SAAAY,CAAA,CACL,GAIJZ,EAAM,YACEc,QAAA,CAAyB,MAAK,GAAC,QAAAF,CAAA,EAApB,SAASD,CAAC,EAA4B,EAIzDH,EAAAA,IAACM,EAAAA,MAAA,CAEG,KAAMd,EAAM,KACZ,QAAAY,EACA,cAAeZ,EAAM,cAEpB,SAAAA,EAAM,SAAWU,EAAgBV,EAAM,QAAQ,EAAI,IAAA,EAL/CA,EAAM,MAAQ,SAASW,CAAC,EAAA,CAQzC,CAAC,CACL,CAEA,MAAMI,EAAoD,CACtD,QAASC,EAAAA,cACT,KAAMC,EAAAA,WACN,OAAQC,EAAAA,YACZ,EAwBO,SAASC,EAAU,CACtB,OAAAtB,EACA,OAAAuB,EAAS,UACT,SAAAC,EACA,eAAAC,EACA,SAAAC,EAAW,IACf,EAAmB,CACf,MAAMC,EAAOC,EAAAA,QAAQ,IAAMf,EAAgBb,CAAM,EAAG,CAACA,CAAM,CAAC,EACtD6B,EAASX,EAAQK,CAAM,EACvBO,EAAcP,IAAW,SAAW,CAAE,SAAAC,EAAU,eAAAC,CAAA,EAAmB,CAAE,SAAAD,CAAA,EAE3E,OACIb,EAAAA,IAACkB,EAAA,CAAQ,GAAGC,EACR,SAAAnB,EAAAA,IAACoB,WAAA,CAAS,SAAAL,EACN,SAAAf,EAAAA,IAACqB,SAAA,CAAQ,SAAAL,CAAA,CAAK,CAAA,CAClB,EACJ,CAER"}

package/dist/router/AppRouter.js

@@ -0,0 +1,60 @@
+import { jsx as t } from "react/jsx-runtime";
+import { useMemo as d, Suspense as p } from "react";
+import { MemoryRouter as u, HashRouter as f, BrowserRouter as h, Routes as R, Route as c } from "react-router-dom";
+import { lazyWithRetry as y } from "../auth/lazy-with-retry.js";
+import { RouteGuard as w } from "./RouteGuard.js";
+function G(n) {
+  return n;
+}
+const s = /* @__PURE__ */ new WeakMap();
+function z(n) {
+  let e = s.get(n);
+  return e || (e = y(n.lazy), s.set(n, e)), e;
+}
+function x({
+  guard: n,
+  redirectTo: e,
+  children: o
+}) {
+  const r = typeof n == "function" ? n() : n;
+  return /* @__PURE__ */ t(w, { when: r, redirectTo: e, children: o });
+}
+function l(n) {
+  return n.map((e, o) => {
+    let r = e.element;
+    if (e.lazy) {
+      const i = z(e);
+      r = /* @__PURE__ */ t(i, {});
+    }
+    return e.guard !== void 0 && (r = /* @__PURE__ */ t(x, { guard: e.guard, redirectTo: e.redirectTo, children: r })), e.index ? /* @__PURE__ */ t(c, { index: !0, element: r }, `index-${o}`) : /* @__PURE__ */ t(
+      c,
+      {
+        path: e.path,
+        element: r,
+        caseSensitive: e.caseSensitive,
+        children: e.children ? l(e.children) : null
+      },
+      e.path ?? `route-${o}`
+    );
+  });
+}
+const v = {
+  browser: h,
+  hash: f,
+  memory: u
+};
+function L({
+  routes: n,
+  router: e = "browser",
+  basename: o,
+  initialEntries: r,
+  fallback: i = null
+}) {
+  const m = d(() => l(n), [n]), a = v[e];
+  return /* @__PURE__ */ t(a, { ...e === "memory" ? { basename: o, initialEntries: r } : { basename: o }, children: /* @__PURE__ */ t(p, { fallback: i, children: /* @__PURE__ */ t(R, { children: m }) }) });
+}
+export {
+  L as AppRouter,
+  G as defineRoutes
+};
+//# sourceMappingURL=AppRouter.js.map

package/dist/router/AppRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppRouter.js","sources":["../../src/router/AppRouter.tsx"],"sourcesContent":["import { Suspense, useMemo } from \"react\";\nimport type { ComponentType, ReactNode } from \"react\";\nimport { BrowserRouter, HashRouter, MemoryRouter, Routes, Route } from \"react-router-dom\";\nimport { lazyWithRetry } from \"../auth/lazy-with-retry\";\nimport { RouteGuard } from \"./RouteGuard\";\nimport type { RouterKind, TempestRouteObject } from \"./types\";\n\n/**\n * Identity helper that types a declarative route tree. Use it so editors give\n * autocomplete and type-checking on every node; the array is returned as-is.\n *\n * @example\n * export const routes = defineRoutes([\n *     { path: \"/\", element: <Layout />, children: [\n *         { index: true, lazy: () => import(\"./pages/Home\") },\n *         { path: \"settings\", lazy: () => import(\"./pages/Settings\"),\n *           guard: () => useAuth.getState().isAuthenticated, redirectTo: \"/login\" },\n *     ] },\n * ]);\n */\nexport function defineRoutes(routes: TempestRouteObject[]): TempestRouteObject[] {\n    return routes;\n}\n\nconst lazyCache = new WeakMap<TempestRouteObject, ComponentType<unknown>>();\n\nfunction resolveLazy(route: TempestRouteObject): ComponentType<unknown> {\n    let comp = lazyCache.get(route);\n    if (!comp) {\n        comp = lazyWithRetry(route.lazy!);\n        lazyCache.set(route, comp);\n    }\n    return comp;\n}\n\nfunction GuardedElement({\n    guard,\n    redirectTo,\n    children,\n}: {\n    guard: boolean | (() => boolean);\n    redirectTo?: string;\n    children: ReactNode;\n}) {\n    const allowed = typeof guard === \"function\" ? guard() : guard;\n    return (\n        <RouteGuard when={allowed} redirectTo={redirectTo}>\n            {children}\n        </RouteGuard>\n    );\n}\n\nfunction toRouteElements(routes: TempestRouteObject[]): ReactNode {\n    return routes.map((route, i) => {\n        let element: ReactNode = route.element;\n        if (route.lazy) {\n            const LazyComponent = resolveLazy(route);\n            element = <LazyComponent />;\n        }\n        if (route.guard !== undefined) {\n            element = (\n                <GuardedElement guard={route.guard} redirectTo={route.redirectTo}>\n                    {element}\n                </GuardedElement>\n            );\n        }\n\n        if (route.index) {\n            return <Route key={`index-${i}`} index element={element} />;\n        }\n\n        return (\n            <Route\n                key={route.path ?? `route-${i}`}\n                path={route.path}\n                element={element}\n                caseSensitive={route.caseSensitive}\n            >\n                {route.children ? toRouteElements(route.children) : null}\n            </Route>\n        );\n    });\n}\n\nconst ROUTERS: Record<RouterKind, typeof BrowserRouter> = {\n    browser: BrowserRouter,\n    hash: HashRouter,\n    memory: MemoryRouter,\n};\n\nexport interface AppRouterProps {\n    /** Declarative route tree, ideally built with {@link defineRoutes}. */\n    routes: TempestRouteObject[];\n    /** History strategy (default: `\"browser\"`). */\n    router?: RouterKind;\n    /** App-wide base path forwarded to the underlying router. */\n    basename?: string;\n    /** Initial URLs for the `\"memory\"` router (tests / non-DOM hosts). */\n    initialEntries?: string[];\n    /** Suspense fallback shown while a `lazy` route chunk loads. */\n    fallback?: ReactNode;\n}\n\n/**\n * Render a full React Router (v7, declarative mode) from a {@link defineRoutes}\n * tree: picks the history strategy, wraps everything in a `<Suspense>` boundary\n * for `lazy` routes, and applies per-route `guard` redirects. This is the\n * single entry point apps mount at their root.\n *\n * @example\n * <AppRouter routes={routes} fallback={<Spinner />} />\n */\nexport function AppRouter({\n    routes,\n    router = \"browser\",\n    basename,\n    initialEntries,\n    fallback = null,\n}: AppRouterProps) {\n    const tree = useMemo(() => toRouteElements(routes), [routes]);\n    const Router = ROUTERS[router];\n    const routerProps = router === \"memory\" ? { basename, initialEntries } : { basename };\n\n    return (\n        <Router {...routerProps}>\n            <Suspense fallback={fallback}>\n                <Routes>{tree}</Routes>\n            </Suspense>\n        </Router>\n    );\n}\n"],"names":["defineRoutes","routes","lazyCache","resolveLazy","route","comp","lazyWithRetry","GuardedElement","guard","redirectTo","children","allowed","jsx","RouteGuard","toRouteElements","i","element","LazyComponent","Route","ROUTERS","BrowserRouter","HashRouter","MemoryRouter","AppRouter","router","basename","initialEntries","fallback","tree","useMemo","Router","Suspense","Routes"],"mappings":";;;;;AAoBO,SAASA,EAAaC,GAAoD;AAC7E,SAAOA;AACX;AAEA,MAAMC,wBAAgB,QAAA;AAEtB,SAASC,EAAYC,GAAmD;AACpE,MAAIC,IAAOH,EAAU,IAAIE,CAAK;AAC9B,SAAKC,MACDA,IAAOC,EAAcF,EAAM,IAAK,GAChCF,EAAU,IAAIE,GAAOC,CAAI,IAEtBA;AACX;AAEA,SAASE,EAAe;AAAA,EACpB,OAAAC;AAAA,EACA,YAAAC;AAAA,EACA,UAAAC;AACJ,GAIG;AACC,QAAMC,IAAU,OAAOH,KAAU,aAAaA,MAAUA;AACxD,SACI,gBAAAI,EAACC,GAAA,EAAW,MAAMF,GAAS,YAAAF,GACtB,UAAAC,GACL;AAER;AAEA,SAASI,EAAgBb,GAAyC;AAC9D,SAAOA,EAAO,IAAI,CAACG,GAAOW,MAAM;AAC5B,QAAIC,IAAqBZ,EAAM;AAC/B,QAAIA,EAAM,MAAM;AACZ,YAAMa,IAAgBd,EAAYC,CAAK;AACvC,MAAAY,sBAAWC,GAAA,EAAc;AAAA,IAC7B;AASA,WARIb,EAAM,UAAU,WAChBY,IACI,gBAAAJ,EAACL,KAAe,OAAOH,EAAM,OAAO,YAAYA,EAAM,YACjD,UAAAY,EAAA,CACL,IAIJZ,EAAM,0BACEc,GAAA,EAAyB,OAAK,IAAC,SAAAF,EAAA,GAApB,SAASD,CAAC,EAA4B,IAIzD,gBAAAH;AAAA,MAACM;AAAA,MAAA;AAAA,QAEG,MAAMd,EAAM;AAAA,QACZ,SAAAY;AAAA,QACA,eAAeZ,EAAM;AAAA,QAEpB,UAAAA,EAAM,WAAWU,EAAgBV,EAAM,QAAQ,IAAI;AAAA,MAAA;AAAA,MAL/CA,EAAM,QAAQ,SAASW,CAAC;AAAA,IAAA;AAAA,EAQzC,CAAC;AACL;AAEA,MAAMI,IAAoD;AAAA,EACtD,SAASC;AAAA,EACT,MAAMC;AAAA,EACN,QAAQC;AACZ;AAwBO,SAASC,EAAU;AAAA,EACtB,QAAAtB;AAAA,EACA,QAAAuB,IAAS;AAAA,EACT,UAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,UAAAC,IAAW;AACf,GAAmB;AACf,QAAMC,IAAOC,EAAQ,MAAMf,EAAgBb,CAAM,GAAG,CAACA,CAAM,CAAC,GACtD6B,IAASX,EAAQK,CAAM;AAG7B,SACI,gBAAAZ,EAACkB,GAAA,EAAQ,GAHON,MAAW,WAAW,EAAE,UAAAC,GAAU,gBAAAC,EAAA,IAAmB,EAAE,UAAAD,EAAA,GAInE,UAAA,gBAAAb,EAACmB,GAAA,EAAS,UAAAJ,GACN,UAAA,gBAAAf,EAACoB,GAAA,EAAQ,UAAAJ,EAAA,CAAK,EAAA,CAClB,GACJ;AAER;"}

package/dist/router/RouteGuard.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),n=require("react-router-dom");function i({when:t,redirectTo:r="/",replace:u=!0,children:o}){return e.jsx(e.Fragment,{children:t?o:e.jsx(n.Navigate,{to:r,replace:u})})}exports.RouteGuard=i;
+//# sourceMappingURL=RouteGuard.cjs.map

package/dist/router/RouteGuard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteGuard.cjs","sources":["../../src/router/RouteGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { Navigate } from \"react-router-dom\";\n\nexport interface RouteGuardProps {\n    /**\n     * Whether access is allowed. Pass a boolean or anything truthy/falsy —\n     * typically `useAuthStore((s) => s.isAuthenticated)`.\n     */\n    when: boolean;\n    /** Where to redirect when `when` is falsy (default: `\"/\"`). */\n    redirectTo?: string;\n    /** Replace history entry on redirect instead of pushing (default: true). */\n    replace?: boolean;\n    /** Protected content, usually `<Outlet />` for a guarded layout route. */\n    children: ReactNode;\n}\n\n/**\n * Declarative route guard built on React Router's `<Navigate>`. Renders its\n * children when `when` is truthy, otherwise redirects. Pairs naturally with\n * `createAuthStore` for protected areas.\n *\n * @example\n * <RouteGuard when={useAuthStore((s) => s.isAuthenticated)} redirectTo=\"/login\">\n *     <Outlet />\n * </RouteGuard>\n */\nexport function RouteGuard({ when, redirectTo = \"/\", replace = true, children }: RouteGuardProps) {\n    return <>{when ? children : <Navigate to={redirectTo} replace={replace} />}</>;\n}\n"],"names":["RouteGuard","when","redirectTo","replace","children","jsx","Fragment","Navigate"],"mappings":"mJA2BO,SAASA,EAAW,CAAE,KAAAC,EAAM,WAAAC,EAAa,IAAK,QAAAC,EAAU,GAAM,SAAAC,GAA6B,CAC9F,OAAOC,EAAAA,IAAAC,EAAAA,SAAA,CAAG,WAAOF,EAAWC,MAACE,EAAAA,UAAS,GAAIL,EAAY,QAAAC,EAAkB,CAAA,CAAG,CAC/E"}

package/dist/router/RouteGuard.js

@@ -0,0 +1,9 @@
+import { jsx as r, Fragment as m } from "react/jsx-runtime";
+import { Navigate as n } from "react-router-dom";
+function f({ when: t, redirectTo: o = "/", replace: e = !0, children: i }) {
+  return /* @__PURE__ */ r(m, { children: t ? i : /* @__PURE__ */ r(n, { to: o, replace: e }) });
+}
+export {
+  f as RouteGuard
+};
+//# sourceMappingURL=RouteGuard.js.map

package/dist/router/RouteGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteGuard.js","sources":["../../src/router/RouteGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { Navigate } from \"react-router-dom\";\n\nexport interface RouteGuardProps {\n    /**\n     * Whether access is allowed. Pass a boolean or anything truthy/falsy —\n     * typically `useAuthStore((s) => s.isAuthenticated)`.\n     */\n    when: boolean;\n    /** Where to redirect when `when` is falsy (default: `\"/\"`). */\n    redirectTo?: string;\n    /** Replace history entry on redirect instead of pushing (default: true). */\n    replace?: boolean;\n    /** Protected content, usually `<Outlet />` for a guarded layout route. */\n    children: ReactNode;\n}\n\n/**\n * Declarative route guard built on React Router's `<Navigate>`. Renders its\n * children when `when` is truthy, otherwise redirects. Pairs naturally with\n * `createAuthStore` for protected areas.\n *\n * @example\n * <RouteGuard when={useAuthStore((s) => s.isAuthenticated)} redirectTo=\"/login\">\n *     <Outlet />\n * </RouteGuard>\n */\nexport function RouteGuard({ when, redirectTo = \"/\", replace = true, children }: RouteGuardProps) {\n    return <>{when ? children : <Navigate to={redirectTo} replace={replace} />}</>;\n}\n"],"names":["RouteGuard","when","redirectTo","replace","children","jsx","Fragment","Navigate"],"mappings":";;AA2BO,SAASA,EAAW,EAAE,MAAAC,GAAM,YAAAC,IAAa,KAAK,SAAAC,IAAU,IAAM,UAAAC,KAA6B;AAC9F,SAAO,gBAAAC,EAAAC,GAAA,EAAG,cAAOF,IAAW,gBAAAC,EAACE,KAAS,IAAIL,GAAY,SAAAC,GAAkB,EAAA,CAAG;AAC/E;"}

package/dist/share/share-or-download.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("./share.cjs");async function s(t,r,c={}){const a=new File([t],r,{type:t.type}),o=await l.share({title:c.title??r,files:[a]});if(o.shared||o.cancelled)return;const n=URL.createObjectURL(t),e=document.createElement("a");e.href=n,e.download=r,document.body.appendChild(e),e.click(),e.remove(),URL.revokeObjectURL(n)}exports.shareOrDownloadBlob=s;
+//# sourceMappingURL=share-or-download.cjs.map

package/dist/share/share-or-download.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-or-download.cjs","sources":["../../src/share/share-or-download.ts"],"sourcesContent":["import { share } from \"./share\";\n\n/** Options for {@link shareOrDownloadBlob}. */\nexport interface ShareOrDownloadOptions {\n    /** Title passed to the Web Share dialog. Defaults to the file name. */\n    title?: string;\n}\n\n/**\n * Try the Web Share API with the given `Blob` as a file; fall back to a\n * download anchor when the browser cannot share files (desktop Firefox, older\n * iOS Safari, etc.).\n *\n * A companion to {@link share} for the common \"export a generated artifact\"\n * flow: on mobile it opens the native share sheet, and everywhere else it\n * triggers a plain download. Returns early when the user shares or cancels the\n * dialog; otherwise it downloads.\n *\n * @param blob - The binary payload to share or download.\n * @param fileName - The file name presented to the user.\n * @param options - Optional `title` for the share dialog.\n * @returns A promise that resolves once the share or download completes.\n *\n * @example\n * const zip = new Blob([bytes], { type: \"application/zip\" });\n * await shareOrDownloadBlob(zip, \"export.zip\");\n */\nexport async function shareOrDownloadBlob(\n    blob: Blob,\n    fileName: string,\n    options: ShareOrDownloadOptions = {},\n): Promise<void> {\n    const file = new File([blob], fileName, { type: blob.type });\n    const result = await share({ title: options.title ?? fileName, files: [file] });\n    if (result.shared || result.cancelled) return;\n\n    const url = URL.createObjectURL(blob);\n    const anchor = document.createElement(\"a\");\n    anchor.href = url;\n    anchor.download = fileName;\n    document.body.appendChild(anchor);\n    anchor.click();\n    anchor.remove();\n    URL.revokeObjectURL(url);\n}\n"],"names":["shareOrDownloadBlob","blob","fileName","options","file","result","share","url","anchor"],"mappings":"+GA2BA,eAAsBA,EAClBC,EACAC,EACAC,EAAkC,CAAA,EACrB,CACb,MAAMC,EAAO,IAAI,KAAK,CAACH,CAAI,EAAGC,EAAU,CAAE,KAAMD,EAAK,KAAM,EACrDI,EAAS,MAAMC,QAAM,CAAE,MAAOH,EAAQ,OAASD,EAAU,MAAO,CAACE,CAAI,CAAA,CAAG,EAC9E,GAAIC,EAAO,QAAUA,EAAO,UAAW,OAEvC,MAAME,EAAM,IAAI,gBAAgBN,CAAI,EAC9BO,EAAS,SAAS,cAAc,GAAG,EACzCA,EAAO,KAAOD,EACdC,EAAO,SAAWN,EAClB,SAAS,KAAK,YAAYM,CAAM,EAChCA,EAAO,MAAA,EACPA,EAAO,OAAA,EACP,IAAI,gBAAgBD,CAAG,CAC3B"}

package/dist/share/share-or-download.js

@@ -0,0 +1,11 @@
+import { share as l } from "./share.js";
+async function s(t, c, r = {}) {
+  const a = new File([t], c, { type: t.type }), n = await l({ title: r.title ?? c, files: [a] });
+  if (n.shared || n.cancelled) return;
+  const o = URL.createObjectURL(t), e = document.createElement("a");
+  e.href = o, e.download = c, document.body.appendChild(e), e.click(), e.remove(), URL.revokeObjectURL(o);
+}
+export {
+  s as shareOrDownloadBlob
+};
+//# sourceMappingURL=share-or-download.js.map

package/dist/share/share-or-download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-or-download.js","sources":["../../src/share/share-or-download.ts"],"sourcesContent":["import { share } from \"./share\";\n\n/** Options for {@link shareOrDownloadBlob}. */\nexport interface ShareOrDownloadOptions {\n    /** Title passed to the Web Share dialog. Defaults to the file name. */\n    title?: string;\n}\n\n/**\n * Try the Web Share API with the given `Blob` as a file; fall back to a\n * download anchor when the browser cannot share files (desktop Firefox, older\n * iOS Safari, etc.).\n *\n * A companion to {@link share} for the common \"export a generated artifact\"\n * flow: on mobile it opens the native share sheet, and everywhere else it\n * triggers a plain download. Returns early when the user shares or cancels the\n * dialog; otherwise it downloads.\n *\n * @param blob - The binary payload to share or download.\n * @param fileName - The file name presented to the user.\n * @param options - Optional `title` for the share dialog.\n * @returns A promise that resolves once the share or download completes.\n *\n * @example\n * const zip = new Blob([bytes], { type: \"application/zip\" });\n * await shareOrDownloadBlob(zip, \"export.zip\");\n */\nexport async function shareOrDownloadBlob(\n    blob: Blob,\n    fileName: string,\n    options: ShareOrDownloadOptions = {},\n): Promise<void> {\n    const file = new File([blob], fileName, { type: blob.type });\n    const result = await share({ title: options.title ?? fileName, files: [file] });\n    if (result.shared || result.cancelled) return;\n\n    const url = URL.createObjectURL(blob);\n    const anchor = document.createElement(\"a\");\n    anchor.href = url;\n    anchor.download = fileName;\n    document.body.appendChild(anchor);\n    anchor.click();\n    anchor.remove();\n    URL.revokeObjectURL(url);\n}\n"],"names":["shareOrDownloadBlob","blob","fileName","options","file","result","share","url","anchor"],"mappings":";AA2BA,eAAsBA,EAClBC,GACAC,GACAC,IAAkC,CAAA,GACrB;AACb,QAAMC,IAAO,IAAI,KAAK,CAACH,CAAI,GAAGC,GAAU,EAAE,MAAMD,EAAK,MAAM,GACrDI,IAAS,MAAMC,EAAM,EAAE,OAAOH,EAAQ,SAASD,GAAU,OAAO,CAACE,CAAI,EAAA,CAAG;AAC9E,MAAIC,EAAO,UAAUA,EAAO,UAAW;AAEvC,QAAME,IAAM,IAAI,gBAAgBN,CAAI,GAC9BO,IAAS,SAAS,cAAc,GAAG;AACzC,EAAAA,EAAO,OAAOD,GACdC,EAAO,WAAWN,GAClB,SAAS,KAAK,YAAYM,CAAM,GAChCA,EAAO,MAAA,GACPA,EAAO,OAAA,GACP,IAAI,gBAAgBD,CAAG;AAC3B;"}

package/dist/share/share.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});async function a(e){if(typeof navigator>"u"||!("share"in navigator))return{shared:!1,unsupported:!0,cancelled:!1};if(e.files&&!navigator.canShare?.({files:e.files}))return{shared:!1,unsupported:!0,cancelled:!1};try{return await navigator.share(e),{shared:!0,unsupported:!1,cancelled:!1}}catch(r){return r instanceof DOMException&&r.name==="AbortError"?{shared:!1,unsupported:!1,cancelled:!0}:{shared:!1,unsupported:!1,cancelled:!1,error:r}}}function n(){return typeof navigator<"u"&&"share"in navigator}exports.isShareSupported=n;exports.share=a;
+//# sourceMappingURL=share.cjs.map

package/dist/share/share.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.cjs","sources":["../../src/share/share.ts"],"sourcesContent":["export interface SharePayload {\n    title?: string;\n    text?: string;\n    url?: string;\n    /** Files to share (supported only on a subset of browsers). */\n    files?: File[];\n}\n\nexport interface ShareResult {\n    /** True when `navigator.share` resolved successfully. */\n    shared: boolean;\n    /** True when the platform did not support the requested payload. */\n    unsupported: boolean;\n    /** True when the user cancelled the share dialog. */\n    cancelled: boolean;\n    error?: unknown;\n}\n\n/**\n * Wrap the Web Share API with a uniform result object. Falls through to\n * `unsupported: true` when the browser lacks `navigator.share`, leaving the\n * caller free to render a custom fallback (copy-link, social buttons).\n */\nexport async function share(payload: SharePayload): Promise<ShareResult> {\n    if (typeof navigator === \"undefined\" || !(\"share\" in navigator)) {\n        return { shared: false, unsupported: true, cancelled: false };\n    }\n    if (payload.files && !navigator.canShare?.({ files: payload.files })) {\n        return { shared: false, unsupported: true, cancelled: false };\n    }\n    try {\n        await navigator.share(payload);\n        return { shared: true, unsupported: false, cancelled: false };\n    } catch (error) {\n        if (error instanceof DOMException && error.name === \"AbortError\") {\n            return { shared: false, unsupported: false, cancelled: true };\n        }\n        return { shared: false, unsupported: false, cancelled: false, error };\n    }\n}\n\n/** True when the Web Share API is available in this environment. */\nexport function isShareSupported(): boolean {\n    return typeof navigator !== \"undefined\" && \"share\" in navigator;\n}\n"],"names":["share","payload","error","isShareSupported"],"mappings":"gFAuBA,eAAsBA,EAAMC,EAA6C,CACrE,GAAI,OAAO,UAAc,KAAe,EAAE,UAAW,WACjD,MAAO,CAAE,OAAQ,GAAO,YAAa,GAAM,UAAW,EAAA,EAE1D,GAAIA,EAAQ,OAAS,CAAC,UAAU,WAAW,CAAE,MAAOA,EAAQ,KAAA,CAAO,EAC/D,MAAO,CAAE,OAAQ,GAAO,YAAa,GAAM,UAAW,EAAA,EAE1D,GAAI,CACA,aAAM,UAAU,MAAMA,CAAO,EACtB,CAAE,OAAQ,GAAM,YAAa,GAAO,UAAW,EAAA,CAC1D,OAASC,EAAO,CACZ,OAAIA,aAAiB,cAAgBA,EAAM,OAAS,aACzC,CAAE,OAAQ,GAAO,YAAa,GAAO,UAAW,EAAA,EAEpD,CAAE,OAAQ,GAAO,YAAa,GAAO,UAAW,GAAO,MAAAA,CAAA,CAClE,CACJ,CAGO,SAASC,GAA4B,CACxC,OAAO,OAAO,UAAc,KAAe,UAAW,SAC1D"}

package/dist/share/share.js

@@ -0,0 +1,19 @@
+async function a(e) {
+  if (typeof navigator > "u" || !("share" in navigator))
+    return { shared: !1, unsupported: !0, cancelled: !1 };
+  if (e.files && !navigator.canShare?.({ files: e.files }))
+    return { shared: !1, unsupported: !0, cancelled: !1 };
+  try {
+    return await navigator.share(e), { shared: !0, unsupported: !1, cancelled: !1 };
+  } catch (r) {
+    return r instanceof DOMException && r.name === "AbortError" ? { shared: !1, unsupported: !1, cancelled: !0 } : { shared: !1, unsupported: !1, cancelled: !1, error: r };
+  }
+}
+function n() {
+  return typeof navigator < "u" && "share" in navigator;
+}
+export {
+  n as isShareSupported,
+  a as share
+};
+//# sourceMappingURL=share.js.map

package/dist/share/share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.js","sources":["../../src/share/share.ts"],"sourcesContent":["export interface SharePayload {\n    title?: string;\n    text?: string;\n    url?: string;\n    /** Files to share (supported only on a subset of browsers). */\n    files?: File[];\n}\n\nexport interface ShareResult {\n    /** True when `navigator.share` resolved successfully. */\n    shared: boolean;\n    /** True when the platform did not support the requested payload. */\n    unsupported: boolean;\n    /** True when the user cancelled the share dialog. */\n    cancelled: boolean;\n    error?: unknown;\n}\n\n/**\n * Wrap the Web Share API with a uniform result object. Falls through to\n * `unsupported: true` when the browser lacks `navigator.share`, leaving the\n * caller free to render a custom fallback (copy-link, social buttons).\n */\nexport async function share(payload: SharePayload): Promise<ShareResult> {\n    if (typeof navigator === \"undefined\" || !(\"share\" in navigator)) {\n        return { shared: false, unsupported: true, cancelled: false };\n    }\n    if (payload.files && !navigator.canShare?.({ files: payload.files })) {\n        return { shared: false, unsupported: true, cancelled: false };\n    }\n    try {\n        await navigator.share(payload);\n        return { shared: true, unsupported: false, cancelled: false };\n    } catch (error) {\n        if (error instanceof DOMException && error.name === \"AbortError\") {\n            return { shared: false, unsupported: false, cancelled: true };\n        }\n        return { shared: false, unsupported: false, cancelled: false, error };\n    }\n}\n\n/** True when the Web Share API is available in this environment. */\nexport function isShareSupported(): boolean {\n    return typeof navigator !== \"undefined\" && \"share\" in navigator;\n}\n"],"names":["share","payload","error","isShareSupported"],"mappings":"AAuBA,eAAsBA,EAAMC,GAA6C;AACrE,MAAI,OAAO,YAAc,OAAe,EAAE,WAAW;AACjD,WAAO,EAAE,QAAQ,IAAO,aAAa,IAAM,WAAW,GAAA;AAE1D,MAAIA,EAAQ,SAAS,CAAC,UAAU,WAAW,EAAE,OAAOA,EAAQ,MAAA,CAAO;AAC/D,WAAO,EAAE,QAAQ,IAAO,aAAa,IAAM,WAAW,GAAA;AAE1D,MAAI;AACA,iBAAM,UAAU,MAAMA,CAAO,GACtB,EAAE,QAAQ,IAAM,aAAa,IAAO,WAAW,GAAA;AAAA,EAC1D,SAASC,GAAO;AACZ,WAAIA,aAAiB,gBAAgBA,EAAM,SAAS,eACzC,EAAE,QAAQ,IAAO,aAAa,IAAO,WAAW,GAAA,IAEpD,EAAE,QAAQ,IAAO,aAAa,IAAO,WAAW,IAAO,OAAAA,EAAA;AAAA,EAClE;AACJ;AAGO,SAASC,IAA4B;AACxC,SAAO,OAAO,YAAc,OAAe,WAAW;AAC1D;"}

package/dist/sse/create-event-stream.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function B(a){try{return JSON.parse(a)}catch{return a}}function C(a,d={}){const{withCredentials:m=!1,namedEvents:g=[],heartbeatEvents:u=["ping"],maxRetries:E=10,initialBackoff:v=1e3,maxBackoff:S=3e4,parser:p=B,onOpen:h,onMessage:y,onError:T,onStatusChange:b}=d;let n=null,r=null,o=0,i="idle",c=!1;function s(e){i!==e&&(i=e,b?.(e))}function f(e,t){u.includes(e)||y?.({event:e,data:p(t.data),id:t.lastEventId||void 0,raw:t})}function M(){if(c)return;if(o>=E){s("error");return}const e=Math.min(v*2**o,S);o+=1,r=setTimeout(l,e)}function l(){if(c)return;n&&n.close(),s("connecting");const e=new EventSource(a,{withCredentials:m});n=e,e.onopen=()=>{o=0,s("open"),h?.()},e.onmessage=t=>f("message",t);for(const t of g)e.addEventListener(t,w=>f(t,w));for(const t of u)e.addEventListener(t,()=>{});e.onerror=t=>{T?.(t),e.close(),n=null,s("closed"),M()}}function O(){c=!0,r&&(clearTimeout(r),r=null),o=0,n&&(n.close(),n=null),s("closed")}function k(){r&&(clearTimeout(r),r=null),o=0,c=!1,l()}return l(),{close:O,reconnect:k,get status(){return i}}}exports.createEventStream=C;
+//# sourceMappingURL=create-event-stream.cjs.map

package/dist/sse/create-event-stream.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-event-stream.cjs","sources":["../../src/sse/create-event-stream.ts"],"sourcesContent":["export type EventStreamStatus = \"idle\" | \"connecting\" | \"open\" | \"closed\" | \"error\";\n\nexport interface EventStreamMessage<T> {\n    /** Server-named event (default `\"message\"`). */\n    event: string;\n    /** Parsed payload — JSON-decoded when possible, raw string otherwise. */\n    data: T;\n    /** Server-supplied id, if any. */\n    id?: string;\n    /** Raw `MessageEvent` for advanced cases. */\n    raw: MessageEvent;\n}\n\nexport interface CreateEventStreamOptions<T> {\n    /** Send cookies with the EventSource handshake. Default: false. */\n    withCredentials?: boolean;\n    /** Subscribe to named events in addition to `message`. */\n    namedEvents?: readonly string[];\n    /** Treat these named events as heartbeat-only (no callback). Default: `[\"ping\"]`. */\n    heartbeatEvents?: readonly string[];\n    /** Max reconnect attempts. Default: 10. Pass 0 to disable reconnect. */\n    maxRetries?: number;\n    /** Initial backoff in ms; doubles per attempt, capped at `maxBackoff`. Default: 1000. */\n    initialBackoff?: number;\n    /** Maximum backoff in ms. Default: 30000. */\n    maxBackoff?: number;\n    /** Parse `event.data`. Defaults to JSON with raw-string fallback. */\n    parser?: (raw: string) => T;\n    onOpen?: () => void;\n    onMessage?: (message: EventStreamMessage<T>) => void;\n    onError?: (error: Event) => void;\n    onStatusChange?: (status: EventStreamStatus) => void;\n}\n\nexport interface EventStreamController {\n    close: () => void;\n    /** Force an immediate reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /** Current connection status. */\n    readonly status: EventStreamStatus;\n}\n\nfunction defaultParser<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\n}\n\n/**\n * Open a Server-Sent Events stream with automatic exponential-backoff reconnect.\n *\n * Heartbeat events (default `\"ping\"`) keep the socket alive without firing\n * `onMessage`. Pass `withCredentials: true` when the backend authenticates via\n * cookies. Call `close()` from the returned controller to tear down.\n *\n * @param url - Full SSE endpoint URL.\n * @param options - Stream configuration and callbacks.\n * @returns A controller exposing `close`, `reconnect` and the current `status`.\n */\nexport function createEventStream<T = unknown>(\n    url: string,\n    options: CreateEventStreamOptions<T> = {},\n): EventStreamController {\n    const {\n        withCredentials = false,\n        namedEvents = [],\n        heartbeatEvents = [\"ping\"],\n        maxRetries = 10,\n        initialBackoff = 1000,\n        maxBackoff = 30000,\n        parser = defaultParser<T>,\n        onOpen,\n        onMessage,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let source: EventSource | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let retries = 0;\n    let status: EventStreamStatus = \"idle\";\n    let closed = false;\n\n    function setStatus(next: EventStreamStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function emit(eventName: string, event: MessageEvent): void {\n        if (heartbeatEvents.includes(eventName)) return;\n        onMessage?.({\n            event: eventName,\n            data: parser(event.data),\n            id: event.lastEventId || undefined,\n            raw: event,\n        });\n    }\n\n    function scheduleReconnect(): void {\n        if (closed) return;\n        if (retries >= maxRetries) {\n            setStatus(\"error\");\n            return;\n        }\n        const delay = Math.min(initialBackoff * 2 ** retries, maxBackoff);\n        retries += 1;\n        retryTimer = setTimeout(connect, delay);\n    }\n\n    function connect(): void {\n        if (closed) return;\n        if (source) source.close();\n        setStatus(\"connecting\");\n\n        const es = new EventSource(url, { withCredentials });\n        source = es;\n\n        es.onopen = () => {\n            retries = 0;\n            setStatus(\"open\");\n            onOpen?.();\n        };\n\n        es.onmessage = (event) => emit(\"message\", event);\n        for (const name of namedEvents) {\n            es.addEventListener(name, (event) => emit(name, event as MessageEvent));\n        }\n        for (const name of heartbeatEvents) {\n            es.addEventListener(name, () => {\n                /* heartbeat — keep socket alive */\n            });\n        }\n\n        es.onerror = (event) => {\n            onError?.(event);\n            es.close();\n            source = null;\n            setStatus(\"closed\");\n            scheduleReconnect();\n        };\n    }\n\n    function close(): void {\n        closed = true;\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        retries = 0;\n        if (source) {\n            source.close();\n            source = null;\n        }\n        setStatus(\"closed\");\n    }\n\n    function reconnect(): void {\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        retries = 0;\n        closed = false;\n        connect();\n    }\n\n    connect();\n\n    return {\n        close,\n        reconnect,\n        get status() {\n            return status;\n        },\n    };\n}\n"],"names":["defaultParser","raw","createEventStream","url","options","withCredentials","namedEvents","heartbeatEvents","maxRetries","initialBackoff","maxBackoff","parser","onOpen","onMessage","onError","onStatusChange","source","retryTimer","retries","status","closed","setStatus","next","emit","eventName","event","scheduleReconnect","delay","connect","es","name","close","reconnect"],"mappings":"gFA0CA,SAASA,EAAiBC,EAAgB,CACtC,GAAI,CACA,OAAO,KAAK,MAAMA,CAAG,CACzB,MAAQ,CACJ,OAAOA,CACX,CACJ,CAaO,SAASC,EACZC,EACAC,EAAuC,GAClB,CACrB,KAAM,CACF,gBAAAC,EAAkB,GAClB,YAAAC,EAAc,CAAA,EACd,gBAAAC,EAAkB,CAAC,MAAM,EACzB,WAAAC,EAAa,GACb,eAAAC,EAAiB,IACjB,WAAAC,EAAa,IACb,OAAAC,EAASX,EACT,OAAAY,EACA,UAAAC,EACA,QAAAC,EACA,eAAAC,CAAA,EACAX,EAEJ,IAAIY,EAA6B,KAC7BC,EAAmD,KACnDC,EAAU,EACVC,EAA4B,OAC5BC,EAAS,GAEb,SAASC,EAAUC,EAA+B,CAC1CH,IAAWG,IACfH,EAASG,EACTP,IAAiBO,CAAI,EACzB,CAEA,SAASC,EAAKC,EAAmBC,EAA2B,CACpDlB,EAAgB,SAASiB,CAAS,GACtCX,IAAY,CACR,MAAOW,EACP,KAAMb,EAAOc,EAAM,IAAI,EACvB,GAAIA,EAAM,aAAe,OACzB,IAAKA,CAAA,CACR,CACL,CAEA,SAASC,GAA0B,CAC/B,GAAIN,EAAQ,OACZ,GAAIF,GAAWV,EAAY,CACvBa,EAAU,OAAO,EACjB,MACJ,CACA,MAAMM,EAAQ,KAAK,IAAIlB,EAAiB,GAAKS,EAASR,CAAU,EAChEQ,GAAW,EACXD,EAAa,WAAWW,EAASD,CAAK,CAC1C,CAEA,SAASC,GAAgB,CACrB,GAAIR,EAAQ,OACRJ,KAAe,MAAA,EACnBK,EAAU,YAAY,EAEtB,MAAMQ,EAAK,IAAI,YAAY1B,EAAK,CAAE,gBAAAE,EAAiB,EACnDW,EAASa,EAETA,EAAG,OAAS,IAAM,CACdX,EAAU,EACVG,EAAU,MAAM,EAChBT,IAAA,CACJ,EAEAiB,EAAG,UAAaJ,GAAUF,EAAK,UAAWE,CAAK,EAC/C,UAAWK,KAAQxB,EACfuB,EAAG,iBAAiBC,EAAOL,GAAUF,EAAKO,EAAML,CAAqB,CAAC,EAE1E,UAAWK,KAAQvB,EACfsB,EAAG,iBAAiBC,EAAM,IAAM,CAEhC,CAAC,EAGLD,EAAG,QAAWJ,GAAU,CACpBX,IAAUW,CAAK,EACfI,EAAG,MAAA,EACHb,EAAS,KACTK,EAAU,QAAQ,EAClBK,EAAA,CACJ,CACJ,CAEA,SAASK,GAAc,CACnBX,EAAS,GACLH,IACA,aAAaA,CAAU,EACvBA,EAAa,MAEjBC,EAAU,EACNF,IACAA,EAAO,MAAA,EACPA,EAAS,MAEbK,EAAU,QAAQ,CACtB,CAEA,SAASW,GAAkB,CACnBf,IACA,aAAaA,CAAU,EACvBA,EAAa,MAEjBC,EAAU,EACVE,EAAS,GACTQ,EAAA,CACJ,CAEA,OAAAA,EAAA,EAEO,CACH,MAAAG,EACA,UAAAC,EACA,IAAI,QAAS,CACT,OAAOb,CACX,CAAA,CAER"}

package/dist/sse/create-event-stream.js

@@ -0,0 +1,76 @@
+function M(a) {
+  try {
+    return JSON.parse(a);
+  } catch {
+    return a;
+  }
+}
+function O(a, d = {}) {
+  const {
+    withCredentials: m = !1,
+    namedEvents: E = [],
+    heartbeatEvents: u = ["ping"],
+    maxRetries: g = 10,
+    initialBackoff: p = 1e3,
+    maxBackoff: h = 3e4,
+    parser: v = M,
+    onOpen: S,
+    onMessage: T,
+    onError: y,
+    onStatusChange: k
+  } = d;
+  let t = null, r = null, o = 0, i = "idle", c = !1;
+  function s(e) {
+    i !== e && (i = e, k?.(e));
+  }
+  function f(e, n) {
+    u.includes(e) || T?.({
+      event: e,
+      data: v(n.data),
+      id: n.lastEventId || void 0,
+      raw: n
+    });
+  }
+  function w() {
+    if (c) return;
+    if (o >= g) {
+      s("error");
+      return;
+    }
+    const e = Math.min(p * 2 ** o, h);
+    o += 1, r = setTimeout(l, e);
+  }
+  function l() {
+    if (c) return;
+    t && t.close(), s("connecting");
+    const e = new EventSource(a, { withCredentials: m });
+    t = e, e.onopen = () => {
+      o = 0, s("open"), S?.();
+    }, e.onmessage = (n) => f("message", n);
+    for (const n of E)
+      e.addEventListener(n, (L) => f(n, L));
+    for (const n of u)
+      e.addEventListener(n, () => {
+      });
+    e.onerror = (n) => {
+      y?.(n), e.close(), t = null, s("closed"), w();
+    };
+  }
+  function B() {
+    c = !0, r && (clearTimeout(r), r = null), o = 0, t && (t.close(), t = null), s("closed");
+  }
+  function C() {
+    r && (clearTimeout(r), r = null), o = 0, c = !1, l();
+  }
+  return l(), {
+    close: B,
+    reconnect: C,
+    get status() {
+      return i;
+    }
+  };
+}
+export {
+  O as createEventStream
+};
+//# sourceMappingURL=create-event-stream.js.map

package/dist/sse/create-event-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-event-stream.js","sources":["../../src/sse/create-event-stream.ts"],"sourcesContent":["export type EventStreamStatus = \"idle\" | \"connecting\" | \"open\" | \"closed\" | \"error\";\n\nexport interface EventStreamMessage<T> {\n    /** Server-named event (default `\"message\"`). */\n    event: string;\n    /** Parsed payload — JSON-decoded when possible, raw string otherwise. */\n    data: T;\n    /** Server-supplied id, if any. */\n    id?: string;\n    /** Raw `MessageEvent` for advanced cases. */\n    raw: MessageEvent;\n}\n\nexport interface CreateEventStreamOptions<T> {\n    /** Send cookies with the EventSource handshake. Default: false. */\n    withCredentials?: boolean;\n    /** Subscribe to named events in addition to `message`. */\n    namedEvents?: readonly string[];\n    /** Treat these named events as heartbeat-only (no callback). Default: `[\"ping\"]`. */\n    heartbeatEvents?: readonly string[];\n    /** Max reconnect attempts. Default: 10. Pass 0 to disable reconnect. */\n    maxRetries?: number;\n    /** Initial backoff in ms; doubles per attempt, capped at `maxBackoff`. Default: 1000. */\n    initialBackoff?: number;\n    /** Maximum backoff in ms. Default: 30000. */\n    maxBackoff?: number;\n    /** Parse `event.data`. Defaults to JSON with raw-string fallback. */\n    parser?: (raw: string) => T;\n    onOpen?: () => void;\n    onMessage?: (message: EventStreamMessage<T>) => void;\n    onError?: (error: Event) => void;\n    onStatusChange?: (status: EventStreamStatus) => void;\n}\n\nexport interface EventStreamController {\n    close: () => void;\n    /** Force an immediate reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /** Current connection status. */\n    readonly status: EventStreamStatus;\n}\n\nfunction defaultParser<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\n}\n\n/**\n * Open a Server-Sent Events stream with automatic exponential-backoff reconnect.\n *\n * Heartbeat events (default `\"ping\"`) keep the socket alive without firing\n * `onMessage`. Pass `withCredentials: true` when the backend authenticates via\n * cookies. Call `close()` from the returned controller to tear down.\n *\n * @param url - Full SSE endpoint URL.\n * @param options - Stream configuration and callbacks.\n * @returns A controller exposing `close`, `reconnect` and the current `status`.\n */\nexport function createEventStream<T = unknown>(\n    url: string,\n    options: CreateEventStreamOptions<T> = {},\n): EventStreamController {\n    const {\n        withCredentials = false,\n        namedEvents = [],\n        heartbeatEvents = [\"ping\"],\n        maxRetries = 10,\n        initialBackoff = 1000,\n        maxBackoff = 30000,\n        parser = defaultParser<T>,\n        onOpen,\n        onMessage,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let source: EventSource | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let retries = 0;\n    let status: EventStreamStatus = \"idle\";\n    let closed = false;\n\n    function setStatus(next: EventStreamStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function emit(eventName: string, event: MessageEvent): void {\n        if (heartbeatEvents.includes(eventName)) return;\n        onMessage?.({\n            event: eventName,\n            data: parser(event.data),\n            id: event.lastEventId || undefined,\n            raw: event,\n        });\n    }\n\n    function scheduleReconnect(): void {\n        if (closed) return;\n        if (retries >= maxRetries) {\n            setStatus(\"error\");\n            return;\n        }\n        const delay = Math.min(initialBackoff * 2 ** retries, maxBackoff);\n        retries += 1;\n        retryTimer = setTimeout(connect, delay);\n    }\n\n    function connect(): void {\n        if (closed) return;\n        if (source) source.close();\n        setStatus(\"connecting\");\n\n        const es = new EventSource(url, { withCredentials });\n        source = es;\n\n        es.onopen = () => {\n            retries = 0;\n            setStatus(\"open\");\n            onOpen?.();\n        };\n\n        es.onmessage = (event) => emit(\"message\", event);\n        for (const name of namedEvents) {\n            es.addEventListener(name, (event) => emit(name, event as MessageEvent));\n        }\n        for (const name of heartbeatEvents) {\n            es.addEventListener(name, () => {\n                /* heartbeat — keep socket alive */\n            });\n        }\n\n        es.onerror = (event) => {\n            onError?.(event);\n            es.close();\n            source = null;\n            setStatus(\"closed\");\n            scheduleReconnect();\n        };\n    }\n\n    function close(): void {\n        closed = true;\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        retries = 0;\n        if (source) {\n            source.close();\n            source = null;\n        }\n        setStatus(\"closed\");\n    }\n\n    function reconnect(): void {\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        retries = 0;\n        closed = false;\n        connect();\n    }\n\n    connect();\n\n    return {\n        close,\n        reconnect,\n        get status() {\n            return status;\n        },\n    };\n}\n"],"names":["defaultParser","raw","createEventStream","url","options","withCredentials","namedEvents","heartbeatEvents","maxRetries","initialBackoff","maxBackoff","parser","onOpen","onMessage","onError","onStatusChange","source","retryTimer","retries","status","closed","setStatus","next","emit","eventName","event","scheduleReconnect","delay","connect","es","name","close","reconnect"],"mappings":"AA0CA,SAASA,EAAiBC,GAAgB;AACtC,MAAI;AACA,WAAO,KAAK,MAAMA,CAAG;AAAA,EACzB,QAAQ;AACJ,WAAOA;AAAA,EACX;AACJ;AAaO,SAASC,EACZC,GACAC,IAAuC,IAClB;AACrB,QAAM;AAAA,IACF,iBAAAC,IAAkB;AAAA,IAClB,aAAAC,IAAc,CAAA;AAAA,IACd,iBAAAC,IAAkB,CAAC,MAAM;AAAA,IACzB,YAAAC,IAAa;AAAA,IACb,gBAAAC,IAAiB;AAAA,IACjB,YAAAC,IAAa;AAAA,IACb,QAAAC,IAASX;AAAA,IACT,QAAAY;AAAA,IACA,WAAAC;AAAA,IACA,SAAAC;AAAA,IACA,gBAAAC;AAAA,EAAA,IACAX;AAEJ,MAAIY,IAA6B,MAC7BC,IAAmD,MACnDC,IAAU,GACVC,IAA4B,QAC5BC,IAAS;AAEb,WAASC,EAAUC,GAA+B;AAC9C,IAAIH,MAAWG,MACfH,IAASG,GACTP,IAAiBO,CAAI;AAAA,EACzB;AAEA,WAASC,EAAKC,GAAmBC,GAA2B;AACxD,IAAIlB,EAAgB,SAASiB,CAAS,KACtCX,IAAY;AAAA,MACR,OAAOW;AAAA,MACP,MAAMb,EAAOc,EAAM,IAAI;AAAA,MACvB,IAAIA,EAAM,eAAe;AAAA,MACzB,KAAKA;AAAA,IAAA,CACR;AAAA,EACL;AAEA,WAASC,IAA0B;AAC/B,QAAIN,EAAQ;AACZ,QAAIF,KAAWV,GAAY;AACvB,MAAAa,EAAU,OAAO;AACjB;AAAA,IACJ;AACA,UAAMM,IAAQ,KAAK,IAAIlB,IAAiB,KAAKS,GAASR,CAAU;AAChE,IAAAQ,KAAW,GACXD,IAAa,WAAWW,GAASD,CAAK;AAAA,EAC1C;AAEA,WAASC,IAAgB;AACrB,QAAIR,EAAQ;AACZ,IAAIJ,OAAe,MAAA,GACnBK,EAAU,YAAY;AAEtB,UAAMQ,IAAK,IAAI,YAAY1B,GAAK,EAAE,iBAAAE,GAAiB;AACnD,IAAAW,IAASa,GAETA,EAAG,SAAS,MAAM;AACd,MAAAX,IAAU,GACVG,EAAU,MAAM,GAChBT,IAAA;AAAA,IACJ,GAEAiB,EAAG,YAAY,CAACJ,MAAUF,EAAK,WAAWE,CAAK;AAC/C,eAAWK,KAAQxB;AACf,MAAAuB,EAAG,iBAAiBC,GAAM,CAACL,MAAUF,EAAKO,GAAML,CAAqB,CAAC;AAE1E,eAAWK,KAAQvB;AACf,MAAAsB,EAAG,iBAAiBC,GAAM,MAAM;AAAA,MAEhC,CAAC;AAGL,IAAAD,EAAG,UAAU,CAACJ,MAAU;AACpB,MAAAX,IAAUW,CAAK,GACfI,EAAG,MAAA,GACHb,IAAS,MACTK,EAAU,QAAQ,GAClBK,EAAA;AAAA,IACJ;AAAA,EACJ;AAEA,WAASK,IAAc;AACnB,IAAAX,IAAS,IACLH,MACA,aAAaA,CAAU,GACvBA,IAAa,OAEjBC,IAAU,GACNF,MACAA,EAAO,MAAA,GACPA,IAAS,OAEbK,EAAU,QAAQ;AAAA,EACtB;AAEA,WAASW,IAAkB;AACvB,IAAIf,MACA,aAAaA,CAAU,GACvBA,IAAa,OAEjBC,IAAU,GACVE,IAAS,IACTQ,EAAA;AAAA,EACJ;AAEA,SAAAA,EAAA,GAEO;AAAA,IACH,OAAAG;AAAA,IACA,WAAAC;AAAA,IACA,IAAI,SAAS;AACT,aAAOb;AAAA,IACX;AAAA,EAAA;AAER;"}

package/dist/sse/use-event-stream.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),M=require("./create-event-stream.cjs");function d(t,l={}){const{enabled:r=!0,onMessage:s,...S}=l,[f,c]=e.useState("idle"),[i,g]=e.useState(null),n=e.useRef(null),u=e.useRef(s);return u.current=s,e.useEffect(()=>{if(!r||!t){c("idle");return}const o=M.createEventStream(t,{...S,onStatusChange:c,onMessage:a=>{g(a),u.current?.(a)}});return n.current=o.reconnect,()=>{o.close(),n.current=null}},[t,r]),{status:f,lastMessage:i,reconnect:()=>n.current?.()}}exports.useEventStream=d;
+//# sourceMappingURL=use-event-stream.cjs.map

package/dist/sse/use-event-stream.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-stream.cjs","sources":["../../src/sse/use-event-stream.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport {\n    createEventStream,\n    type CreateEventStreamOptions,\n    type EventStreamMessage,\n    type EventStreamStatus,\n} from \"./create-event-stream\";\n\nexport interface UseEventStreamOptions<T> extends Omit<\n    CreateEventStreamOptions<T>,\n    \"onStatusChange\"\n> {\n    /** When false, the stream is not opened. Useful for \"wait for auth\". Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseEventStreamResult<T> {\n    status: EventStreamStatus;\n    /** Last message received (excluding heartbeats). */\n    lastMessage: EventStreamMessage<T> | null;\n    /** Force a reconnect. */\n    reconnect: () => void;\n}\n\n/**\n * React hook wrapper around {@link createEventStream}. Connection lifecycle is\n * tied to the component (and the `url`/`enabled` dependencies); the stream\n * closes on unmount.\n *\n * @example\n * useEventStream<Notification>(`${API}/notifications/stream`, {\n *     enabled: !!user,\n *     withCredentials: true,\n *     onMessage: ({ data }) => addNotification(data),\n * });\n */\nexport function useEventStream<T = unknown>(\n    url: string,\n    options: UseEventStreamOptions<T> = {},\n): UseEventStreamResult<T> {\n    const { enabled = true, onMessage, ...rest } = options;\n    const [status, setStatus] = useState<EventStreamStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<EventStreamMessage<T> | null>(null);\n    const reconnectRef = useRef<(() => void) | null>(null);\n\n    const onMessageRef = useRef(onMessage);\n    onMessageRef.current = onMessage;\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createEventStream<T>(url, {\n            ...rest,\n            onStatusChange: setStatus,\n            onMessage: (message) => {\n                setLastMessage(message);\n                onMessageRef.current?.(message);\n            },\n        });\n        reconnectRef.current = controller.reconnect;\n\n        return () => {\n            controller.close();\n            reconnectRef.current = null;\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [url, enabled]);\n\n    return {\n        status,\n        lastMessage,\n        reconnect: () => reconnectRef.current?.(),\n    };\n}\n"],"names":["useEventStream","url","options","enabled","onMessage","rest","status","setStatus","useState","lastMessage","setLastMessage","reconnectRef","useRef","onMessageRef","useEffect","controller","createEventStream","message"],"mappings":"gJAoCO,SAASA,EACZC,EACAC,EAAoC,GACb,CACvB,KAAM,CAAE,QAAAC,EAAU,GAAM,UAAAC,EAAW,GAAGC,GAASH,EACzC,CAACI,EAAQC,CAAS,EAAIC,EAAAA,SAA4B,MAAM,EACxD,CAACC,EAAaC,CAAc,EAAIF,EAAAA,SAAuC,IAAI,EAC3EG,EAAeC,EAAAA,OAA4B,IAAI,EAE/CC,EAAeD,EAAAA,OAAOR,CAAS,EACrC,OAAAS,EAAa,QAAUT,EAEvBU,EAAAA,UAAU,IAAM,CACZ,GAAI,CAACX,GAAW,CAACF,EAAK,CAClBM,EAAU,MAAM,EAChB,MACJ,CAEA,MAAMQ,EAAaC,EAAAA,kBAAqBf,EAAK,CACzC,GAAGI,EACH,eAAgBE,EAChB,UAAYU,GAAY,CACpBP,EAAeO,CAAO,EACtBJ,EAAa,UAAUI,CAAO,CAClC,CAAA,CACH,EACD,OAAAN,EAAa,QAAUI,EAAW,UAE3B,IAAM,CACTA,EAAW,MAAA,EACXJ,EAAa,QAAU,IAC3B,CAEJ,EAAG,CAACV,EAAKE,CAAO,CAAC,EAEV,CACH,OAAAG,EACA,YAAAG,EACA,UAAW,IAAME,EAAa,UAAA,CAAU,CAEhD"}

package/dist/sse/use-event-stream.js

@@ -0,0 +1,29 @@
+import { useState as a, useRef as l, useEffect as S } from "react";
+import { createEventStream as d } from "./create-event-stream.js";
+function R(e, f = {}) {
+  const { enabled: n = !0, onMessage: r, ...i } = f, [g, s] = a("idle"), [m, M] = a(null), t = l(null), c = l(r);
+  return c.current = r, S(() => {
+    if (!n || !e) {
+      s("idle");
+      return;
+    }
+    const o = d(e, {
+      ...i,
+      onStatusChange: s,
+      onMessage: (u) => {
+        M(u), c.current?.(u);
+      }
+    });
+    return t.current = o.reconnect, () => {
+      o.close(), t.current = null;
+    };
+  }, [e, n]), {
+    status: g,
+    lastMessage: m,
+    reconnect: () => t.current?.()
+  };
+}
+export {
+  R as useEventStream
+};
+//# sourceMappingURL=use-event-stream.js.map

package/dist/sse/use-event-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-stream.js","sources":["../../src/sse/use-event-stream.ts"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport {\n    createEventStream,\n    type CreateEventStreamOptions,\n    type EventStreamMessage,\n    type EventStreamStatus,\n} from \"./create-event-stream\";\n\nexport interface UseEventStreamOptions<T> extends Omit<\n    CreateEventStreamOptions<T>,\n    \"onStatusChange\"\n> {\n    /** When false, the stream is not opened. Useful for \"wait for auth\". Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseEventStreamResult<T> {\n    status: EventStreamStatus;\n    /** Last message received (excluding heartbeats). */\n    lastMessage: EventStreamMessage<T> | null;\n    /** Force a reconnect. */\n    reconnect: () => void;\n}\n\n/**\n * React hook wrapper around {@link createEventStream}. Connection lifecycle is\n * tied to the component (and the `url`/`enabled` dependencies); the stream\n * closes on unmount.\n *\n * @example\n * useEventStream<Notification>(`${API}/notifications/stream`, {\n *     enabled: !!user,\n *     withCredentials: true,\n *     onMessage: ({ data }) => addNotification(data),\n * });\n */\nexport function useEventStream<T = unknown>(\n    url: string,\n    options: UseEventStreamOptions<T> = {},\n): UseEventStreamResult<T> {\n    const { enabled = true, onMessage, ...rest } = options;\n    const [status, setStatus] = useState<EventStreamStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<EventStreamMessage<T> | null>(null);\n    const reconnectRef = useRef<(() => void) | null>(null);\n\n    const onMessageRef = useRef(onMessage);\n    onMessageRef.current = onMessage;\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createEventStream<T>(url, {\n            ...rest,\n            onStatusChange: setStatus,\n            onMessage: (message) => {\n                setLastMessage(message);\n                onMessageRef.current?.(message);\n            },\n        });\n        reconnectRef.current = controller.reconnect;\n\n        return () => {\n            controller.close();\n            reconnectRef.current = null;\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [url, enabled]);\n\n    return {\n        status,\n        lastMessage,\n        reconnect: () => reconnectRef.current?.(),\n    };\n}\n"],"names":["useEventStream","url","options","enabled","onMessage","rest","status","setStatus","useState","lastMessage","setLastMessage","reconnectRef","useRef","onMessageRef","useEffect","controller","createEventStream","message"],"mappings":";;AAoCO,SAASA,EACZC,GACAC,IAAoC,IACb;AACvB,QAAM,EAAE,SAAAC,IAAU,IAAM,WAAAC,GAAW,GAAGC,MAASH,GACzC,CAACI,GAAQC,CAAS,IAAIC,EAA4B,MAAM,GACxD,CAACC,GAAaC,CAAc,IAAIF,EAAuC,IAAI,GAC3EG,IAAeC,EAA4B,IAAI,GAE/CC,IAAeD,EAAOR,CAAS;AACrC,SAAAS,EAAa,UAAUT,GAEvBU,EAAU,MAAM;AACZ,QAAI,CAACX,KAAW,CAACF,GAAK;AAClB,MAAAM,EAAU,MAAM;AAChB;AAAA,IACJ;AAEA,UAAMQ,IAAaC,EAAqBf,GAAK;AAAA,MACzC,GAAGI;AAAA,MACH,gBAAgBE;AAAA,MAChB,WAAW,CAACU,MAAY;AACpB,QAAAP,EAAeO,CAAO,GACtBJ,EAAa,UAAUI,CAAO;AAAA,MAClC;AAAA,IAAA,CACH;AACD,WAAAN,EAAa,UAAUI,EAAW,WAE3B,MAAM;AACT,MAAAA,EAAW,MAAA,GACXJ,EAAa,UAAU;AAAA,IAC3B;AAAA,EAEJ,GAAG,CAACV,GAAKE,CAAO,CAAC,GAEV;AAAA,IACH,QAAAG;AAAA,IACA,aAAAG;AAAA,IACA,WAAW,MAAME,EAAa,UAAA;AAAA,EAAU;AAEhD;"}

package/dist/store/create-selectors.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function r(e){const t=e;t.use={};for(const c of Object.keys(e.getState()))t.use[c]=()=>e(o=>o[c]);return t}exports.createSelectors=r;
+//# sourceMappingURL=create-selectors.cjs.map

package/dist/store/create-selectors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-selectors.cjs","sources":["../../src/store/create-selectors.ts"],"sourcesContent":["import type { StoreApi, UseBoundStore } from \"zustand\";\n\n/**\n * A bound Zustand hook augmented with auto-generated per-field selector hooks\n * under `.use`. Reading a single field via `store.use.field()` subscribes the\n * component only to that field, avoiding re-renders when unrelated slices change.\n */\nexport type WithSelectors<S> = S extends { getState: () => infer T }\n    ? S & { use: { [K in keyof T]: () => T[K] } }\n    : never;\n\n/**\n * Attach auto-generated selector hooks to a Zustand store. Instead of writing\n * `useStore((s) => s.user)` at every call site, you get `useStore.use.user()`\n * — one memoized selector per top-level state key.\n *\n * @typeParam S - The bound store hook type returned by `create`/{@link createStore}.\n * @param store - The bound Zustand hook.\n * @returns The same hook with a `.use` namespace of field selectors.\n *\n * @example\n * const useCart = createSelectors(\n *     createStore<CartState>((set) => ({ items: [], add: (id) => ... })),\n * );\n * const items = useCart.use.items(); // subscribes only to `items`\n */\nexport function createSelectors<S extends UseBoundStore<StoreApi<object>>>(\n    store: S,\n): WithSelectors<S> {\n    const bound = store as WithSelectors<S>;\n    bound.use = {} as WithSelectors<S>[\"use\"];\n    for (const key of Object.keys(store.getState())) {\n        (bound.use as Record<string, () => unknown>)[key] = () =>\n            store((state) => (state as Record<string, unknown>)[key]);\n    }\n    return bound;\n}\n"],"names":["createSelectors","store","bound","key","state"],"mappings":"gFA0BO,SAASA,EACZC,EACgB,CAChB,MAAMC,EAAQD,EACdC,EAAM,IAAM,CAAA,EACZ,UAAWC,KAAO,OAAO,KAAKF,EAAM,SAAA,CAAU,EACzCC,EAAM,IAAsCC,CAAG,EAAI,IAChDF,EAAOG,GAAWA,EAAkCD,CAAG,CAAC,EAEhE,OAAOD,CACX"}