tempest-react-sdk 0.22.0 → 0.24.0

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

@@ -0,0 +1,43 @@
+import { useCallback as e, useState as t } from "react";
+import { keepPreviousData as n, useQuery as r } from "@tanstack/react-query";
+//#region src/query/use-paginated-query.ts
+function i(i) {
+	let { queryKey: a, queryFn: o, initialPage: s = 1, pageSize: c = 20, sizeParam: l = "size", orderBy: u, ascending: d = !1, ...f } = i, [p, m] = t(s), h = r({
+		...f,
+		queryKey: [...a, {
+			page: p,
+			pageSize: c,
+			sizeParam: l,
+			orderBy: u,
+			ascending: d
+		}],
+		queryFn: () => {
+			let e = {
+				page: p,
+				[l]: c
+			};
+			return u && (e.order_by = u, e.ascending = d), o(e);
+		},
+		placeholderData: n
+	}), g = h.data, _ = g?.pages ?? 0, v = p < _, y = p > 1, b = e((e) => m(Math.max(1, e)), []), x = e(() => m((e) => e < _ ? e + 1 : e), [_]), S = e(() => m((e) => e > 1 ? e - 1 : e), []);
+	return {
+		page: g,
+		items: g?.items ?? [],
+		pageNumber: p,
+		pageCount: _,
+		total: g?.total ?? 0,
+		hasNext: v,
+		hasPrev: y,
+		isLoading: h.isLoading,
+		isFetching: h.isFetching,
+		error: h.error,
+		setPage: b,
+		next: x,
+		prev: S,
+		refetch: () => void h.refetch()
+	};
+}
+//#endregion
+export { i 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","names":[],"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"],"mappings":";;;AAwEA,SAAgB,EACZ,GAC0B;CAC1B,IAAM,EACF,aACA,YACA,iBAAc,GACd,cAAW,IACX,eAAY,QACZ,YACA,eAAY,IACZ,GAAG,MACH,GAEE,CAAC,GAAY,KAAiB,EAAS,CAAW,GAElD,IAAQ,EAA+B;EACzC,GAAG;EACH,UAAU,CAAC,GAAG,GAAU;GAAE,MAAM;GAAY;GAAU;GAAW;GAAS;EAAU,CAAC;EACrF,eAAe;GACX,IAAM,IAAuB;IAAE,MAAM;KAAa,IAAY;GAAS;GAKvE,OAJI,MACA,EAAO,WAAW,GAClB,EAAO,YAAY,IAEhB,EAAQ,CAAM;EACzB;EACA,iBAAiB;CACrB,CAAC,GAEK,IAAO,EAAM,MACb,IAAY,GAAM,SAAS,GAC3B,IAAU,IAAa,GACvB,IAAU,IAAa,GAEvB,IAAU,GAAa,MAAiB,EAAc,KAAK,IAAI,GAAG,CAAI,CAAC,GAAG,CAAC,CAAC,GAC5E,IAAO,QAAkB,GAAe,MAAO,IAAI,IAAY,IAAI,IAAI,CAAE,GAAG,CAAC,CAAS,CAAC,GACvF,IAAO,QAAkB,GAAe,MAAO,IAAI,IAAI,IAAI,IAAI,CAAE,GAAG,CAAC,CAAC;CAE5E,OAAO;EACH;EACA,OAAO,GAAM,SAAS,CAAC;EACvB;EACA;EACA,OAAO,GAAM,SAAS;EACtB;EACA;EACA,WAAW,EAAM;EACjB,YAAY,EAAM;EAClB,OAAO,EAAM;EACb;EACA;EACA;EACA,eAAe,KAAK,EAAM,QAAQ;CACtC;AACJ"}

package/dist/router/AppRouter.cjs

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

package/dist/router/AppRouter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppRouter.cjs","names":[],"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\";\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"],"mappings":"6JAoBA,SAAgB,EAAa,EAAoD,CAC7E,OAAO,CACX,CAEA,IAAM,EAAY,IAAI,QAEtB,SAAS,EAAY,EAAmD,CACpE,IAAI,EAAO,EAAU,IAAI,CAAK,EAK9B,OAJK,IACD,EAAO,EAAA,cAAc,EAAM,IAAK,EAChC,EAAU,IAAI,EAAO,CAAI,GAEtB,CACX,CAEA,SAAS,EAAe,CACpB,QACA,aACA,YAKD,CAEC,OACI,EAAA,EAAA,IAAA,CAAC,EAAA,WAAD,CAAY,KAFA,OAAO,GAAU,WAAa,EAAM,EAAI,EAEb,aAClC,UACO,CAAA,CAEpB,CAEA,SAAS,EAAgB,EAAyC,CAC9D,OAAO,EAAO,KAAK,EAAO,IAAM,CAC5B,IAAI,EAAqB,EAAM,QAiB/B,OAhBI,EAAM,OAEN,GAAU,EAAA,EAAA,IAAA,CADY,EAAY,CACvB,EAAD,CAAgB,CAAA,GAE1B,EAAM,QAAU,IAAA,KAChB,GACI,EAAA,EAAA,IAAA,CAAC,EAAD,CAAgB,MAAO,EAAM,MAAO,WAAY,EAAM,oBACjD,CACW,CAAA,GAIpB,EAAM,OACC,EAAA,EAAA,IAAA,CAAC,EAAA,MAAD,CAA0B,MAAA,GAAe,SAAU,EAAvC,SAAS,GAA8B,GAI1D,EAAA,EAAA,IAAA,CAAC,EAAA,MAAD,CAEI,KAAM,EAAM,KACH,UACT,cAAe,EAAM,uBAEpB,EAAM,SAAW,EAAgB,EAAM,QAAQ,EAAI,IACjD,EANE,EAAM,MAAQ,SAAS,GAMzB,CAEf,CAAC,CACL,CAEA,IAAM,EAAoD,CACtD,QAAS,EAAA,cACT,KAAM,EAAA,WACN,OAAQ,EAAA,YACZ,EAwBA,SAAgB,EAAU,CACtB,SACA,SAAS,UACT,WACA,iBACA,WAAW,MACI,CACf,IAAM,GAAA,EAAA,EAAA,QAAA,KAAqB,EAAgB,CAAM,EAAG,CAAC,CAAM,CAAC,EACtD,EAAS,EAAQ,GAGvB,OACI,EAAA,EAAA,IAAA,CAAC,EAAD,CAAQ,GAHQ,IAAW,SAAW,CAAE,WAAU,gBAAe,EAAI,CAAE,UAAS,YAI5E,EAAA,EAAA,IAAA,CAAC,EAAA,SAAD,CAAoB,qBAChB,EAAA,EAAA,IAAA,CAAC,EAAA,OAAD,CAAA,SAAS,CAAa,CAAA,CAChB,CAAA,CACN,CAAA,CAEhB"}

package/dist/router/AppRouter.js

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

package/dist/router/AppRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppRouter.js","names":[],"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\";\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"],"mappings":";;;;;;AAoBA,SAAgB,EAAa,GAAoD;CAC7E,OAAO;AACX;AAEA,IAAM,oBAAY,IAAI,QAAoD;AAE1E,SAAS,EAAY,GAAmD;CACpE,IAAI,IAAO,EAAU,IAAI,CAAK;CAK9B,OAJK,MACD,IAAO,EAAc,EAAM,IAAK,GAChC,EAAU,IAAI,GAAO,CAAI,IAEtB;AACX;AAEA,SAAS,EAAe,EACpB,UACA,eACA,eAKD;CAEC,OACI,kBAAC,GAAD;EAAY,MAFA,OAAO,KAAU,aAAa,EAAM,IAAI;EAEb;EAClC;CACO,CAAA;AAEpB;AAEA,SAAS,EAAgB,GAAyC;CAC9D,OAAO,EAAO,KAAK,GAAO,MAAM;EAC5B,IAAI,IAAqB,EAAM;EAiB/B,OAhBI,EAAM,SAEN,IAAU,kBADY,EAAY,CACvB,GAAD,CAAgB,CAAA,IAE1B,EAAM,UAAU,KAAA,MAChB,IACI,kBAAC,GAAD;GAAgB,OAAO,EAAM;GAAO,YAAY,EAAM;aACjD;EACW,CAAA,IAIpB,EAAM,QACC,kBAAC,GAAD;GAA0B,OAAA;GAAe;EAAU,GAAvC,SAAS,GAA8B,IAI1D,kBAAC,GAAD;GAEI,MAAM,EAAM;GACH;GACT,eAAe,EAAM;aAEpB,EAAM,WAAW,EAAgB,EAAM,QAAQ,IAAI;EACjD,GANE,EAAM,QAAQ,SAAS,GAMzB;CAEf,CAAC;AACL;AAEA,IAAM,IAAoD;CACtD,SAAS;CACT,MAAM;CACN,QAAQ;AACZ;AAwBA,SAAgB,EAAU,EACtB,WACA,YAAS,WACT,aACA,mBACA,cAAW,QACI;CACf,IAAM,IAAO,QAAc,EAAgB,CAAM,GAAG,CAAC,CAAM,CAAC,GACtD,IAAS,EAAQ;CAGvB,OACI,kBAAC,GAAD;EAAQ,GAHQ,MAAW,WAAW;GAAE;GAAU;EAAe,IAAI,EAAE,YAAS;YAI5E,kBAAC,GAAD;GAAoB;aAChB,kBAAC,GAAD,EAAA,UAAS,EAAa,CAAA;EAChB,CAAA;CACN,CAAA;AAEhB"}

package/dist/router/RouteGuard.cjs

@@ -0,0 +1,2 @@
+let e=require("react/jsx-runtime"),t=require("react-router");function n({when:n,redirectTo:r=`/`,replace:i=!0,children:a}){return(0,e.jsx)(e.Fragment,{children:n?a:(0,e.jsx)(t.Navigate,{to:r,replace:i})})}exports.RouteGuard=n;
+//# sourceMappingURL=RouteGuard.cjs.map

package/dist/router/RouteGuard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteGuard.cjs","names":[],"sources":["../../src/router/RouteGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { Navigate } from \"react-router\";\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"],"mappings":"6DA2BA,SAAgB,EAAW,CAAE,OAAM,aAAa,IAAK,UAAU,GAAM,YAA6B,CAC9F,OAAO,EAAA,EAAA,IAAA,CAAA,EAAA,SAAA,CAAA,SAAG,EAAO,GAAW,EAAA,EAAA,IAAA,CAAC,EAAA,SAAD,CAAU,GAAI,EAAqB,SAAU,CAAA,CAAI,CAAA,CACjF"}

package/dist/router/RouteGuard.js

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

package/dist/router/RouteGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteGuard.js","names":[],"sources":["../../src/router/RouteGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { Navigate } from \"react-router\";\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"],"mappings":";;;AA2BA,SAAgB,EAAW,EAAE,SAAM,gBAAa,KAAK,aAAU,IAAM,eAA6B;CAC9F,OAAO,kBAAA,GAAA,EAAA,UAAG,IAAO,IAAW,kBAAC,GAAD;EAAU,IAAI;EAAqB;CAAU,CAAA,EAAI,CAAA;AACjF"}

package/dist/router/index.js

@@ -0,0 +1,4 @@
+import { RouteGuard as e } from "./RouteGuard.js";
+import { AppRouter as t, defineRoutes as n } from "./AppRouter.js";
+import { BrowserRouter as r, HashRouter as i, Link as a, MemoryRouter as o, NavLink as s, Navigate as c, Outlet as l, Route as u, Routes as d, redirect as f, useLocation as p, useMatch as m, useNavigate as h, useParams as g, useRouteError as _, useSearchParams as v } from "react-router";
+export { t as AppRouter, r as BrowserRouter, i as HashRouter, a as Link, o as MemoryRouter, s as NavLink, c as Navigate, l as Outlet, u as Route, e as RouteGuard, d as Routes, n as defineRoutes, f as redirect, p as useLocation, m as useMatch, h as useNavigate, g as useParams, _ as useRouteError, v as useSearchParams };

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"share-or-download.cjs","names":[],"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"],"mappings":"+BA2BA,eAAsB,EAClB,EACA,EACA,EAAkC,CAAC,EACtB,CACb,IAAM,EAAO,IAAI,KAAK,CAAC,CAAI,EAAG,EAAU,CAAE,KAAM,EAAK,IAAK,CAAC,EACrD,EAAS,MAAM,EAAA,MAAM,CAAE,MAAO,EAAQ,OAAS,EAAU,MAAO,CAAC,CAAI,CAAE,CAAC,EAC9E,GAAI,EAAO,QAAU,EAAO,UAAW,OAEvC,IAAM,EAAM,IAAI,gBAAgB,CAAI,EAC9B,EAAS,SAAS,cAAc,GAAG,EACzC,EAAO,KAAO,EACd,EAAO,SAAW,EAClB,SAAS,KAAK,YAAY,CAAM,EAChC,EAAO,MAAM,EACb,EAAO,OAAO,EACd,IAAI,gBAAgB,CAAG,CAC3B"}

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

@@ -0,0 +1,15 @@
+import { share as e } from "./share.js";
+//#region src/share/share-or-download.ts
+async function t(t, n, r = {}) {
+	let i = new File([t], n, { type: t.type }), a = await e({
+		title: r.title ?? n,
+		files: [i]
+	});
+	if (a.shared || a.cancelled) return;
+	let o = URL.createObjectURL(t), s = document.createElement("a");
+	s.href = o, s.download = n, document.body.appendChild(s), s.click(), s.remove(), URL.revokeObjectURL(o);
+}
+//#endregion
+export { t 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","names":[],"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"],"mappings":";;AA2BA,eAAsB,EAClB,GACA,GACA,IAAkC,CAAC,GACtB;CACb,IAAM,IAAO,IAAI,KAAK,CAAC,CAAI,GAAG,GAAU,EAAE,MAAM,EAAK,KAAK,CAAC,GACrD,IAAS,MAAM,EAAM;EAAE,OAAO,EAAQ,SAAS;EAAU,OAAO,CAAC,CAAI;CAAE,CAAC;CAC9E,IAAI,EAAO,UAAU,EAAO,WAAW;CAEvC,IAAM,IAAM,IAAI,gBAAgB,CAAI,GAC9B,IAAS,SAAS,cAAc,GAAG;CAMzC,AALA,EAAO,OAAO,GACd,EAAO,WAAW,GAClB,SAAS,KAAK,YAAY,CAAM,GAChC,EAAO,MAAM,GACb,EAAO,OAAO,GACd,IAAI,gBAAgB,CAAG;AAC3B"}

package/dist/share/share.cjs

@@ -0,0 +1,2 @@
+async function e(e){if(typeof navigator>`u`||!(`share`in navigator)||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(e){return e instanceof DOMException&&e.name===`AbortError`?{shared:!1,unsupported:!1,cancelled:!0}:{shared:!1,unsupported:!1,cancelled:!1,error:e}}}function t(){return typeof navigator<`u`&&`share`in navigator}exports.isShareSupported=t,exports.share=e;
+//# sourceMappingURL=share.cjs.map

package/dist/share/share.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.cjs","names":[],"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"],"mappings":"AAuBA,eAAsB,EAAM,EAA6C,CAIrE,GAHI,OAAO,UAAc,KAAe,EAAE,UAAW,YAGjD,EAAQ,OAAS,CAAC,UAAU,WAAW,CAAE,MAAO,EAAQ,KAAM,CAAC,EAC/D,MAAO,CAAE,OAAQ,GAAO,YAAa,GAAM,UAAW,EAAM,EAEhE,GAAI,CAEA,OADA,MAAM,UAAU,MAAM,CAAO,EACtB,CAAE,OAAQ,GAAM,YAAa,GAAO,UAAW,EAAM,CAChE,OAAS,EAAO,CAIZ,OAHI,aAAiB,cAAgB,EAAM,OAAS,aACzC,CAAE,OAAQ,GAAO,YAAa,GAAO,UAAW,EAAK,EAEzD,CAAE,OAAQ,GAAO,YAAa,GAAO,UAAW,GAAO,OAAM,CACxE,CACJ,CAGA,SAAgB,GAA4B,CACxC,OAAO,OAAO,UAAc,KAAe,UAAW,SAC1D"}

package/dist/share/share.js

@@ -0,0 +1,33 @@
+//#region src/share/share.ts
+async function e(e) {
+	if (typeof navigator > "u" || !("share" in navigator) || 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 (e) {
+		return e instanceof DOMException && e.name === "AbortError" ? {
+			shared: !1,
+			unsupported: !1,
+			cancelled: !0
+		} : {
+			shared: !1,
+			unsupported: !1,
+			cancelled: !1,
+			error: e
+		};
+	}
+}
+function t() {
+	return typeof navigator < "u" && "share" in navigator;
+}
+//#endregion
+export { t as isShareSupported, e as share };
+
+//# sourceMappingURL=share.js.map

package/dist/share/share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.js","names":[],"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"],"mappings":";AAuBA,eAAsB,EAAM,GAA6C;CAIrE,IAHI,OAAO,YAAc,OAAe,EAAE,WAAW,cAGjD,EAAQ,SAAS,CAAC,UAAU,WAAW,EAAE,OAAO,EAAQ,MAAM,CAAC,GAC/D,OAAO;EAAE,QAAQ;EAAO,aAAa;EAAM,WAAW;CAAM;CAEhE,IAAI;EAEA,OADA,MAAM,UAAU,MAAM,CAAO,GACtB;GAAE,QAAQ;GAAM,aAAa;GAAO,WAAW;EAAM;CAChE,SAAS,GAAO;EAIZ,OAHI,aAAiB,gBAAgB,EAAM,SAAS,eACzC;GAAE,QAAQ;GAAO,aAAa;GAAO,WAAW;EAAK,IAEzD;GAAE,QAAQ;GAAO,aAAa;GAAO,WAAW;GAAO;EAAM;CACxE;AACJ;AAGA,SAAgB,IAA4B;CACxC,OAAO,OAAO,YAAc,OAAe,WAAW;AAC1D"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-event-stream.cjs","names":[],"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"],"mappings":"AA0CA,SAAS,EAAiB,EAAgB,CACtC,GAAI,CACA,OAAO,KAAK,MAAM,CAAG,CACzB,MAAQ,CACJ,OAAO,CACX,CACJ,CAaA,SAAgB,EACZ,EACA,EAAuC,CAAC,EACnB,CACrB,GAAM,CACF,kBAAkB,GAClB,cAAc,CAAC,EACf,kBAAkB,CAAC,MAAM,EACzB,aAAa,GACb,iBAAiB,IACjB,aAAa,IACb,SAAS,EACT,SACA,YACA,UACA,kBACA,EAEA,EAA6B,KAC7B,EAAmD,KACnD,EAAU,EACV,EAA4B,OAC5B,EAAS,GAEb,SAAS,EAAU,EAA+B,CAC1C,IAAW,IACf,EAAS,EACT,IAAiB,CAAI,EACzB,CAEA,SAAS,EAAK,EAAmB,EAA2B,CACpD,EAAgB,SAAS,CAAS,GACtC,IAAY,CACR,MAAO,EACP,KAAM,EAAO,EAAM,IAAI,EACvB,GAAI,EAAM,aAAe,IAAA,GACzB,IAAK,CACT,CAAC,CACL,CAEA,SAAS,GAA0B,CAC/B,GAAI,EAAQ,OACZ,GAAI,GAAW,EAAY,CACvB,EAAU,OAAO,EACjB,MACJ,CACA,IAAM,EAAQ,KAAK,IAAI,EAAiB,GAAK,EAAS,CAAU,EAChE,GAAW,EACX,EAAa,WAAW,EAAS,CAAK,CAC1C,CAEA,SAAS,GAAgB,CACrB,GAAI,EAAQ,OACR,GAAQ,EAAO,MAAM,EACzB,EAAU,YAAY,EAEtB,IAAM,EAAK,IAAI,YAAY,EAAK,CAAE,iBAAgB,CAAC,EACnD,EAAS,EAET,EAAG,WAAe,CACd,EAAU,EACV,EAAU,MAAM,EAChB,IAAS,CACb,EAEA,EAAG,UAAa,GAAU,EAAK,UAAW,CAAK,EAC/C,IAAK,IAAM,KAAQ,EACf,EAAG,iBAAiB,EAAO,GAAU,EAAK,EAAM,CAAqB,CAAC,EAE1E,IAAK,IAAM,KAAQ,EACf,EAAG,iBAAiB,MAAY,CAEhC,CAAC,EAGL,EAAG,QAAW,GAAU,CACpB,IAAU,CAAK,EACf,EAAG,MAAM,EACT,EAAS,KACT,EAAU,QAAQ,EAClB,EAAkB,CACtB,CACJ,CAEA,SAAS,GAAc,CACnB,EAAS,GACT,AAEI,KADA,aAAa,CAAU,EACV,MAEjB,EAAU,EACV,AAEI,KADA,EAAO,MAAM,EACJ,MAEb,EAAU,QAAQ,CACtB,CAEA,SAAS,GAAkB,CACvB,AAEI,KADA,aAAa,CAAU,EACV,MAEjB,EAAU,EACV,EAAS,GACT,EAAQ,CACZ,CAIA,OAFA,EAAQ,EAED,CACH,QACA,YACA,IAAI,QAAS,CACT,OAAO,CACX,CACJ,CACJ"}

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

@@ -0,0 +1,61 @@
+//#region src/sse/create-event-stream.ts
+function e(e) {
+	try {
+		return JSON.parse(e);
+	} catch {
+		return e;
+	}
+}
+function t(t, n = {}) {
+	let { withCredentials: r = !1, namedEvents: i = [], heartbeatEvents: a = ["ping"], maxRetries: o = 10, initialBackoff: s = 1e3, maxBackoff: c = 3e4, parser: l = e, onOpen: u, onMessage: d, onError: f, onStatusChange: p } = n, m = null, h = null, g = 0, _ = "idle", v = !1;
+	function y(e) {
+		_ !== e && (_ = e, p?.(e));
+	}
+	function b(e, t) {
+		a.includes(e) || d?.({
+			event: e,
+			data: l(t.data),
+			id: t.lastEventId || void 0,
+			raw: t
+		});
+	}
+	function x() {
+		if (v) return;
+		if (g >= o) {
+			y("error");
+			return;
+		}
+		let e = Math.min(s * 2 ** g, c);
+		g += 1, h = setTimeout(S, e);
+	}
+	function S() {
+		if (v) return;
+		m && m.close(), y("connecting");
+		let e = new EventSource(t, { withCredentials: r });
+		m = e, e.onopen = () => {
+			g = 0, y("open"), u?.();
+		}, e.onmessage = (e) => b("message", e);
+		for (let t of i) e.addEventListener(t, (e) => b(t, e));
+		for (let t of a) e.addEventListener(t, () => {});
+		e.onerror = (t) => {
+			f?.(t), e.close(), m = null, y("closed"), x();
+		};
+	}
+	function C() {
+		v = !0, h &&= (clearTimeout(h), null), g = 0, m &&= (m.close(), null), y("closed");
+	}
+	function w() {
+		h &&= (clearTimeout(h), null), g = 0, v = !1, S();
+	}
+	return S(), {
+		close: C,
+		reconnect: w,
+		get status() {
+			return _;
+		}
+	};
+}
+//#endregion
+export { t 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","names":[],"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"],"mappings":";AA0CA,SAAS,EAAiB,GAAgB;CACtC,IAAI;EACA,OAAO,KAAK,MAAM,CAAG;CACzB,QAAQ;EACJ,OAAO;CACX;AACJ;AAaA,SAAgB,EACZ,GACA,IAAuC,CAAC,GACnB;CACrB,IAAM,EACF,qBAAkB,IAClB,iBAAc,CAAC,GACf,qBAAkB,CAAC,MAAM,GACzB,gBAAa,IACb,oBAAiB,KACjB,gBAAa,KACb,YAAS,GACT,WACA,cACA,YACA,sBACA,GAEA,IAA6B,MAC7B,IAAmD,MACnD,IAAU,GACV,IAA4B,QAC5B,IAAS;CAEb,SAAS,EAAU,GAA+B;EAC1C,MAAW,MACf,IAAS,GACT,IAAiB,CAAI;CACzB;CAEA,SAAS,EAAK,GAAmB,GAA2B;EACpD,EAAgB,SAAS,CAAS,KACtC,IAAY;GACR,OAAO;GACP,MAAM,EAAO,EAAM,IAAI;GACvB,IAAI,EAAM,eAAe,KAAA;GACzB,KAAK;EACT,CAAC;CACL;CAEA,SAAS,IAA0B;EAC/B,IAAI,GAAQ;EACZ,IAAI,KAAW,GAAY;GACvB,EAAU,OAAO;GACjB;EACJ;EACA,IAAM,IAAQ,KAAK,IAAI,IAAiB,KAAK,GAAS,CAAU;EAEhE,AADA,KAAW,GACX,IAAa,WAAW,GAAS,CAAK;CAC1C;CAEA,SAAS,IAAgB;EACrB,IAAI,GAAQ;EAEZ,AADI,KAAQ,EAAO,MAAM,GACzB,EAAU,YAAY;EAEtB,IAAM,IAAK,IAAI,YAAY,GAAK,EAAE,mBAAgB,CAAC;EASnD,AARA,IAAS,GAET,EAAG,eAAe;GAGd,AAFA,IAAU,GACV,EAAU,MAAM,GAChB,IAAS;EACb,GAEA,EAAG,aAAa,MAAU,EAAK,WAAW,CAAK;EAC/C,KAAK,IAAM,KAAQ,GACf,EAAG,iBAAiB,IAAO,MAAU,EAAK,GAAM,CAAqB,CAAC;EAE1E,KAAK,IAAM,KAAQ,GACf,EAAG,iBAAiB,SAAY,CAEhC,CAAC;EAGL,EAAG,WAAW,MAAU;GAKpB,AAJA,IAAU,CAAK,GACf,EAAG,MAAM,GACT,IAAS,MACT,EAAU,QAAQ,GAClB,EAAkB;EACtB;CACJ;CAEA,SAAS,IAAc;EAWnB,AAVA,IAAS,IACT,AAEI,OADA,aAAa,CAAU,GACV,OAEjB,IAAU,GACV,AAEI,OADA,EAAO,MAAM,GACJ,OAEb,EAAU,QAAQ;CACtB;CAEA,SAAS,IAAkB;EAOvB,AANA,AAEI,OADA,aAAa,CAAU,GACV,OAEjB,IAAU,GACV,IAAS,IACT,EAAQ;CACZ;CAIA,OAFA,EAAQ,GAED;EACH;EACA;EACA,IAAI,SAAS;GACT,OAAO;EACX;CACJ;AACJ"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-stream.cjs","names":[],"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"],"mappings":"oEAoCA,SAAgB,EACZ,EACA,EAAoC,CAAC,EACd,CACvB,GAAM,CAAE,UAAU,GAAM,YAAW,GAAG,GAAS,EACzC,CAAC,EAAQ,IAAA,EAAA,EAAA,SAAA,CAAyC,MAAM,EACxD,CAAC,EAAa,IAAA,EAAA,EAAA,SAAA,CAAyD,IAAI,EAC3E,GAAA,EAAA,EAAA,OAAA,CAA2C,IAAI,EAE/C,GAAA,EAAA,EAAA,OAAA,CAAsB,CAAS,EA0BrC,MAzBA,GAAa,QAAU,GAEvB,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,CAAC,GAAW,CAAC,EAAK,CAClB,EAAU,MAAM,EAChB,MACJ,CAEA,IAAM,EAAa,EAAA,kBAAqB,EAAK,CACzC,GAAG,EACH,eAAgB,EAChB,UAAY,GAAY,CACpB,EAAe,CAAO,EACtB,EAAa,UAAU,CAAO,CAClC,CACJ,CAAC,EAGD,MAFA,GAAa,QAAU,EAAW,cAErB,CACT,EAAW,MAAM,EACjB,EAAa,QAAU,IAC3B,CAEJ,EAAG,CAAC,EAAK,CAAO,CAAC,EAEV,CACH,SACA,cACA,cAAiB,EAAa,UAAU,CAC5C,CACJ"}

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

@@ -0,0 +1,30 @@
+import { createEventStream as e } from "./create-event-stream.js";
+import { useEffect as t, useRef as n, useState as r } from "react";
+//#region src/sse/use-event-stream.ts
+function i(i, a = {}) {
+	let { enabled: o = !0, onMessage: s, ...c } = a, [l, u] = r("idle"), [d, f] = r(null), p = n(null), m = n(s);
+	return m.current = s, t(() => {
+		if (!o || !i) {
+			u("idle");
+			return;
+		}
+		let t = e(i, {
+			...c,
+			onStatusChange: u,
+			onMessage: (e) => {
+				f(e), m.current?.(e);
+			}
+		});
+		return p.current = t.reconnect, () => {
+			t.close(), p.current = null;
+		};
+	}, [i, o]), {
+		status: l,
+		lastMessage: d,
+		reconnect: () => p.current?.()
+	};
+}
+//#endregion
+export { i 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","names":[],"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"],"mappings":";;;AAoCA,SAAgB,EACZ,GACA,IAAoC,CAAC,GACd;CACvB,IAAM,EAAE,aAAU,IAAM,cAAW,GAAG,MAAS,GACzC,CAAC,GAAQ,KAAa,EAA4B,MAAM,GACxD,CAAC,GAAa,KAAkB,EAAuC,IAAI,GAC3E,IAAe,EAA4B,IAAI,GAE/C,IAAe,EAAO,CAAS;CA0BrC,OAzBA,EAAa,UAAU,GAEvB,QAAgB;EACZ,IAAI,CAAC,KAAW,CAAC,GAAK;GAClB,EAAU,MAAM;GAChB;EACJ;EAEA,IAAM,IAAa,EAAqB,GAAK;GACzC,GAAG;GACH,gBAAgB;GAChB,YAAY,MAAY;IAEpB,AADA,EAAe,CAAO,GACtB,EAAa,UAAU,CAAO;GAClC;EACJ,CAAC;EAGD,OAFA,EAAa,UAAU,EAAW,iBAErB;GAET,AADA,EAAW,MAAM,GACjB,EAAa,UAAU;EAC3B;CAEJ,GAAG,CAAC,GAAK,CAAO,CAAC,GAEV;EACH;EACA;EACA,iBAAiB,EAAa,UAAU;CAC5C;AACJ"}

package/dist/store/create-selectors.cjs

@@ -0,0 +1,2 @@
+function e(e){let t=e;t.use={};for(let n of Object.keys(e.getState()))t.use[n]=()=>e(e=>e[n]);return t}exports.createSelectors=e;
+//# sourceMappingURL=create-selectors.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-selectors.cjs","names":[],"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"],"mappings":"AA0BA,SAAgB,EACZ,EACgB,CAChB,IAAM,EAAQ,EACd,EAAM,IAAM,CAAC,EACb,IAAK,IAAM,KAAO,OAAO,KAAK,EAAM,SAAS,CAAC,EAC1C,EAAO,IAAsC,OACzC,EAAO,GAAW,EAAkC,EAAI,EAEhE,OAAO,CACX"}

package/dist/store/create-selectors.js

@@ -0,0 +1,11 @@
+//#region src/store/create-selectors.ts
+function e(e) {
+	let t = e;
+	t.use = {};
+	for (let n of Object.keys(e.getState())) t.use[n] = () => e((e) => e[n]);
+	return t;
+}
+//#endregion
+export { e as createSelectors };
+
+//# sourceMappingURL=create-selectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-selectors.js","names":[],"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"],"mappings":";AA0BA,SAAgB,EACZ,GACgB;CAChB,IAAM,IAAQ;CACd,EAAM,MAAM,CAAC;CACb,KAAK,IAAM,KAAO,OAAO,KAAK,EAAM,SAAS,CAAC,GAC1C,EAAO,IAAsC,WACzC,GAAO,MAAW,EAAkC,EAAI;CAEhE,OAAO;AACX"}

package/dist/store/create-store.cjs

@@ -0,0 +1,2 @@
+let e=require("zustand"),t=require("zustand/middleware");function n(n,r={}){if(!r.persist)return(0,e.create)()(n);let{name:i,storage:a=`local`,partialize:o,version:s,migrate:c}=r.persist,l=a===`session`?()=>sessionStorage:()=>localStorage;return(0,e.create)()((0,t.persist)(n,{name:i,storage:(0,t.createJSONStorage)(l),...o?{partialize:o}:{},...s===void 0?{}:{version:s},...c?{migrate:c}:{}}))}exports.createStore=n;
+//# sourceMappingURL=create-store.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-store.cjs","names":[],"sources":["../../src/store/create-store.ts"],"sourcesContent":["import { create } from \"zustand\";\nimport type { StateCreator, StoreApi, UseBoundStore } from \"zustand\";\nimport { persist, createJSONStorage } from \"zustand/middleware\";\nimport type { PersistOptions } from \"zustand/middleware\";\n\n/**\n * Persistence options for {@link createStore}. Mirrors the subset of Zustand's\n * `persist` middleware that apps usually need, with sensible Tempest defaults.\n */\nexport interface CreateStorePersistOptions<T> {\n    /** Storage key (required to enable persistence). */\n    name: string;\n    /** Which Web Storage to use (default: `\"local\"`). */\n    storage?: \"local\" | \"session\";\n    /**\n     * Pick the slice of state to persist. Defaults to persisting the whole\n     * state. Use this to avoid writing transient/derived fields.\n     */\n    partialize?: PersistOptions<T, Partial<T>>[\"partialize\"];\n    /** Persisted schema version, forwarded to Zustand for migrations. */\n    version?: number;\n    /** Migration function forwarded to Zustand's `persist` middleware. */\n    migrate?: PersistOptions<T, Partial<T>>[\"migrate\"];\n}\n\n/**\n * Options accepted by {@link createStore}.\n */\nexport interface CreateStoreOptions<T> {\n    /** Enable `localStorage`/`sessionStorage` persistence for the store. */\n    persist?: CreateStorePersistOptions<T>;\n}\n\n/**\n * Create a typed Zustand store with optional `persist` middleware, wired with\n * Tempest defaults. This is the generic counterpart to `createAuthStore`: use\n * it for any domain slice (cart, preferences, wizard state, …) without\n * re-writing the persistence boilerplate in every app.\n *\n * @typeParam T - The store state shape (state + actions).\n * @param initializer - Standard Zustand `StateCreator` (`(set, get) => state`).\n * @param options - Optional persistence configuration.\n * @returns A bound Zustand hook (`useStore`) with the usual `getState`/`setState`/`subscribe` API.\n *\n * @example\n * interface CartState {\n *     items: string[];\n *     add: (id: string) => void;\n *     clear: () => void;\n * }\n *\n * const useCart = createStore<CartState>(\n *     (set) => ({\n *         items: [],\n *         add: (id) => set((s) => ({ items: [...s.items, id] })),\n *         clear: () => set({ items: [] }),\n *     }),\n *     { persist: { name: \"cart\", partialize: (s) => ({ items: s.items }) } },\n * );\n */\nexport function createStore<T>(\n    initializer: StateCreator<T, [], []>,\n    options: CreateStoreOptions<T> = {},\n): UseBoundStore<StoreApi<T>> {\n    if (!options.persist) {\n        return create<T>()(initializer);\n    }\n\n    const { name, storage = \"local\", partialize, version, migrate } = options.persist;\n    const storageImpl = storage === \"session\" ? () => sessionStorage : () => localStorage;\n\n    return create<T>()(\n        persist(initializer, {\n            name,\n            storage: createJSONStorage(storageImpl),\n            ...(partialize ? { partialize } : {}),\n            ...(version !== undefined ? { version } : {}),\n            ...(migrate ? { migrate } : {}),\n        }),\n    );\n}\n"],"mappings":"yDA4DA,SAAgB,EACZ,EACA,EAAiC,CAAC,EACR,CAC1B,GAAI,CAAC,EAAQ,QACT,OAAA,EAAA,EAAA,OAAA,CAAiB,CAAC,CAAC,CAAW,EAGlC,GAAM,CAAE,OAAM,UAAU,QAAS,aAAY,UAAS,WAAY,EAAQ,QACpE,EAAc,IAAY,cAAkB,mBAAuB,aAEzE,OAAA,EAAA,EAAA,OAAA,CAAiB,CAAC,EAAA,EAAA,EAAA,QAAA,CACN,EAAa,CACjB,OACA,SAAA,EAAA,EAAA,kBAAA,CAA2B,CAAW,EACtC,GAAI,EAAa,CAAE,YAAW,EAAI,CAAC,EACnC,GAAI,IAAY,IAAA,GAA0B,CAAC,EAAf,CAAE,SAAQ,EACtC,GAAI,EAAU,CAAE,SAAQ,EAAI,CAAC,CACjC,CAAC,CACL,CACJ"}

package/dist/store/create-store.js

@@ -0,0 +1,18 @@
+import { create as e } from "zustand";
+import { createJSONStorage as t, persist as n } from "zustand/middleware";
+//#region src/store/create-store.ts
+function r(r, i = {}) {
+	if (!i.persist) return e()(r);
+	let { name: a, storage: o = "local", partialize: s, version: c, migrate: l } = i.persist, u = o === "session" ? () => sessionStorage : () => localStorage;
+	return e()(n(r, {
+		name: a,
+		storage: t(u),
+		...s ? { partialize: s } : {},
+		...c === void 0 ? {} : { version: c },
+		...l ? { migrate: l } : {}
+	}));
+}
+//#endregion
+export { r as createStore };
+
+//# sourceMappingURL=create-store.js.map

package/dist/store/create-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-store.js","names":[],"sources":["../../src/store/create-store.ts"],"sourcesContent":["import { create } from \"zustand\";\nimport type { StateCreator, StoreApi, UseBoundStore } from \"zustand\";\nimport { persist, createJSONStorage } from \"zustand/middleware\";\nimport type { PersistOptions } from \"zustand/middleware\";\n\n/**\n * Persistence options for {@link createStore}. Mirrors the subset of Zustand's\n * `persist` middleware that apps usually need, with sensible Tempest defaults.\n */\nexport interface CreateStorePersistOptions<T> {\n    /** Storage key (required to enable persistence). */\n    name: string;\n    /** Which Web Storage to use (default: `\"local\"`). */\n    storage?: \"local\" | \"session\";\n    /**\n     * Pick the slice of state to persist. Defaults to persisting the whole\n     * state. Use this to avoid writing transient/derived fields.\n     */\n    partialize?: PersistOptions<T, Partial<T>>[\"partialize\"];\n    /** Persisted schema version, forwarded to Zustand for migrations. */\n    version?: number;\n    /** Migration function forwarded to Zustand's `persist` middleware. */\n    migrate?: PersistOptions<T, Partial<T>>[\"migrate\"];\n}\n\n/**\n * Options accepted by {@link createStore}.\n */\nexport interface CreateStoreOptions<T> {\n    /** Enable `localStorage`/`sessionStorage` persistence for the store. */\n    persist?: CreateStorePersistOptions<T>;\n}\n\n/**\n * Create a typed Zustand store with optional `persist` middleware, wired with\n * Tempest defaults. This is the generic counterpart to `createAuthStore`: use\n * it for any domain slice (cart, preferences, wizard state, …) without\n * re-writing the persistence boilerplate in every app.\n *\n * @typeParam T - The store state shape (state + actions).\n * @param initializer - Standard Zustand `StateCreator` (`(set, get) => state`).\n * @param options - Optional persistence configuration.\n * @returns A bound Zustand hook (`useStore`) with the usual `getState`/`setState`/`subscribe` API.\n *\n * @example\n * interface CartState {\n *     items: string[];\n *     add: (id: string) => void;\n *     clear: () => void;\n * }\n *\n * const useCart = createStore<CartState>(\n *     (set) => ({\n *         items: [],\n *         add: (id) => set((s) => ({ items: [...s.items, id] })),\n *         clear: () => set({ items: [] }),\n *     }),\n *     { persist: { name: \"cart\", partialize: (s) => ({ items: s.items }) } },\n * );\n */\nexport function createStore<T>(\n    initializer: StateCreator<T, [], []>,\n    options: CreateStoreOptions<T> = {},\n): UseBoundStore<StoreApi<T>> {\n    if (!options.persist) {\n        return create<T>()(initializer);\n    }\n\n    const { name, storage = \"local\", partialize, version, migrate } = options.persist;\n    const storageImpl = storage === \"session\" ? () => sessionStorage : () => localStorage;\n\n    return create<T>()(\n        persist(initializer, {\n            name,\n            storage: createJSONStorage(storageImpl),\n            ...(partialize ? { partialize } : {}),\n            ...(version !== undefined ? { version } : {}),\n            ...(migrate ? { migrate } : {}),\n        }),\n    );\n}\n"],"mappings":";;;AA4DA,SAAgB,EACZ,GACA,IAAiC,CAAC,GACR;CAC1B,IAAI,CAAC,EAAQ,SACT,OAAO,EAAU,CAAC,CAAC,CAAW;CAGlC,IAAM,EAAE,SAAM,aAAU,SAAS,eAAY,YAAS,eAAY,EAAQ,SACpE,IAAc,MAAY,kBAAkB,uBAAuB;CAEzE,OAAO,EAAU,CAAC,CACd,EAAQ,GAAa;EACjB;EACA,SAAS,EAAkB,CAAW;EACtC,GAAI,IAAa,EAAE,cAAW,IAAI,CAAC;EACnC,GAAI,MAAY,KAAA,IAA0B,CAAC,IAAf,EAAE,WAAQ;EACtC,GAAI,IAAU,EAAE,WAAQ,IAAI,CAAC;CACjC,CAAC,CACL;AACJ"}