@vef-framework-react/core 2.1.0

package/dist/es/http/helpers.js

@@ -0,0 +1,9 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import "./errors.js";
+import { HttpClient as e } from "./client.js";
+//#region src/http/helpers.ts
+function t(t) {
+	return Object.freeze(new e(t));
+}
+//#endregion
+export { t as createHttpClient };

package/dist/es/http/index.js

@@ -0,0 +1,5 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import "./constants.js";
+import "./errors.js";
+import "./client.js";
+import "./helpers.js";

package/dist/es/immer/index.js

@@ -0,0 +1,6 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { applyPatches as e, current as t, enableMapSet as n, enablePatches as r, original as i, produce as a, produceWithPatches as o, setAutoFreeze as s } from "immer";
+import { useImmer as c, useImmerReducer as l } from "use-immer";
+n(), r(), s(!1);
+//#endregion
+export { e as applyPatches, t as currentState, i as originalState, a as produce, o as produceWithPatches, c as useImmer, l as useImmerReducer };

package/dist/es/index.js

@@ -0,0 +1,27 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { DefaultChatTransport as e, TextStreamChatTransport as t, getToolName as n, getToolOrDynamicToolName as r, isDataUIPart as i, isDeepEqualData as a, isFileUIPart as o, isReasoningUIPart as s, isTextUIPart as c, isToolOrDynamicToolUIPart as l, isToolUIPart as u, parsePartialJson as d } from "./ai/index.js";
+import { SKIP_AUTH_HEADER as f, SKIP_AUTH_VALUE as p } from "./http/constants.js";
+import { keepPreviousData as m } from "./query/helpers.js";
+import { matchMutation as h, matchQuery as g, skipQueryToken as _, useInfiniteQuery as v, useIsFetching as y, useIsMutating as b, useMutation as x, useMutationState as S, useQueries as C, useQuery as w, useQueryErrorResetBoundary as T } from "./query/hooks.js";
+import { HTTP_CLIENT as E, QUERY_CLIENT as D } from "./api/constants.js";
+import { ApiClient as O } from "./api/client.js";
+import { createApiClient as k } from "./api/helpers.js";
+import { checkPermission as A } from "./auth/helpers.js";
+import { ApiClientProvider as j, useApiClient as M } from "./context/api-client.js";
+import { AppContextProvider as N, useAppContext as P } from "./context/app.js";
+import { createContextWithSelector as F } from "./context/context-selector.js";
+import { DisabledProvider as I, useDisabled as L } from "./context/disabled.js";
+import { AxisModifier as R, DragDropContext as z, DragDropProvider as B, DragOverlay as V, Draggable as H, Droppable as U, KeyboardSensor as W, PointerSensor as G, RestrictToElement as K, RestrictToHorizontalAxis as q, RestrictToVerticalAxis as J, RestrictToWindow as Y, SnapModifier as X, moveArrayItem as Z, moveDragItem as Q, restrictShapeToBoundingRectangle as $, swapArrayItem as ee, swapDragItem as te, useDragDropMonitor as ne, useDraggable as re, useDroppable as ie, useSortable as ae } from "./dnd/index.js";
+import { applyPatches as oe, currentState as se, originalState as ce, produce as le, produceWithPatches as ue, useImmer as de, useImmerReducer as fe } from "./immer/index.js";
+import pe from "./motion/motion-provider.js";
+import { AnimatePresence as me, LayoutGroup as he, Reorder as ge, motion as _e, useDragControls as ve, useInView as ye } from "./motion/index.js";
+import { SseClient as be } from "./sse/client.js";
+import { createSseClient as xe } from "./sse/helpers.js";
+import { AtomStoreProvider as Se, atom as Ce, createAtomStore as we, getDefaultAtomStore as Te, useAtom as Ee, useAtomStore as De, useAtomValue as Oe, useSetAtom as ke } from "./state/index.js";
+import { Actor as Ae, createActor as je, createMachine as Me, updateContext as Ne, useActor as Pe, useActorRef as Fe } from "./state-machine/index.js";
+import { createPersistedStore as Ie, createStore as Le } from "./store/bound.js";
+import { createComponentStore as Re } from "./store/unbound.js";
+import { useDeep as ze } from "./store/use-deep.js";
+import { useShallow as Be } from "./store/index.js";
+import { clsx as Ve } from "clsx";
+export { Ae as Actor, me as AnimatePresence, O as ApiClient, j as ApiClientProvider, N as AppContextProvider, Se as AtomStoreProvider, R as AxisModifier, e as DefaultChatTransport, I as DisabledProvider, z as DragDropContext, B as DragDropProvider, V as DragOverlay, H as Draggable, U as Droppable, E as HTTP_CLIENT, W as KeyboardSensor, he as LayoutGroup, pe as MotionProvider, G as PointerSensor, D as QUERY_CLIENT, ge as Reorder, K as RestrictToElement, q as RestrictToHorizontalAxis, J as RestrictToVerticalAxis, Y as RestrictToWindow, X as SnapModifier, be as SseClient, t as TextStreamChatTransport, oe as applyPatches, Ce as atom, A as checkPermission, Ve as clsx, je as createActor, k as createApiClient, we as createAtomStore, Re as createComponentStore, F as createContextWithSelector, Me as createMachine, Ie as createPersistedStore, xe as createSseClient, Le as createStore, se as currentState, Te as getDefaultAtomStore, n as getToolName, r as getToolOrDynamicToolName, i as isDataUIPart, a as isDeepEqualData, o as isFileUIPart, s as isReasoningUIPart, c as isTextUIPart, l as isToolOrDynamicToolUIPart, u as isToolUIPart, m as keepPreviousData, h as matchMutation, g as matchQuery, _e as motion, Z as moveArrayItem, Q as moveDragItem, ce as originalState, d as parsePartialJson, le as produce, ue as produceWithPatches, $ as restrictShapeToBoundingRectangle, f as skipAuthenticationHeader, p as skipAuthenticationValue, _ as skipQueryToken, ee as swapArrayItem, te as swapDragItem, Ne as updateContext, Pe as useActor, Fe as useActorRef, M as useApiClient, P as useAppContext, Ee as useAtom, De as useAtomStore, Oe as useAtomValue, ze as useDeep, L as useDisabled, ve as useDragControls, ne as useDragDropMonitor, re as useDraggable, ie as useDroppable, de as useImmer, fe as useImmerReducer, ye as useInView, v as useInfiniteQuery, y as useIsFetching, b as useIsMutating, x as useMutation, S as useMutationState, C as useQueries, w as useQuery, T as useQueryErrorResetBoundary, ke as useSetAtom, Be as useShallow, ae as useSortable };

package/dist/es/motion/features.js

@@ -0,0 +1,3 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { domMax as e } from "motion/react";
+export { e as default };

package/dist/es/motion/index.js

@@ -0,0 +1,5 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import "./motion-provider.js";
+import { AnimatePresence as e, LayoutGroup as t, Reorder as n, useDragControls as r, useInView as i } from "motion/react";
+import * as a from "motion/react-m";
+export { e as AnimatePresence, t as LayoutGroup, n as Reorder, a as motion, r as useDragControls, i as useInView };

package/dist/es/motion/motion-provider.js

@@ -0,0 +1,24 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { generateId as e } from "@vef-framework-react/shared";
+import { useState as t } from "react";
+import { jsx as n } from "@emotion/react/jsx-runtime";
+import { LazyMotion as r, MotionConfig as i } from "motion/react";
+//#region src/motion/motion-provider.tsx
+var a = () => import("./features.js").then((e) => e.default), o = {
+	duration: .2,
+	ease: "easeInOut"
+};
+function s({ children: s }) {
+	let [c] = t(e);
+	return /* @__PURE__ */ n(r, {
+		features: a,
+		children: /* @__PURE__ */ n(i, {
+			nonce: c,
+			reducedMotion: "user",
+			transition: o,
+			children: s
+		})
+	});
+}
+//#endregion
+export { s as default };

package/dist/es/query/constants.js

@@ -0,0 +1,5 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+//#region src/query/constants.ts
+var e = "__vef_query_client_key";
+//#endregion
+export { e as QUERY_CLIENT_KEY };

package/dist/es/query/helpers.js

@@ -0,0 +1,41 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { hashKey as e, isPlainObject as t } from "@vef-framework-react/shared";
+import { MutationCache as n, QueryClient as r, keepPreviousData as i, matchQuery as a } from "@tanstack/react-query";
+//#region src/query/helpers.ts
+function o(i) {
+	let { staleTime: o = 5e3, gcTime: s = 3e5, showSuccessMessage: c } = i ?? {}, l = new r({
+		mutationCache: new n({ onSuccess: async (e, n, r, i) => {
+			let { invalidates: o, shouldShowSuccessFeedback: s = !0 } = i.meta ?? {};
+			o && await l.invalidateQueries({
+				stale: !1,
+				type: "all",
+				predicate: (e) => o.some((t) => a({ queryKey: t }, e))
+			}), s && t(e) && Object.hasOwn(e, "message") && c?.(e.message);
+		} }),
+		defaultOptions: {
+			queries: {
+				staleTime: o,
+				gcTime: s,
+				networkMode: "online",
+				retry: !1,
+				structuralSharing: !0,
+				throwOnError: !1,
+				refetchOnMount: !0,
+				refetchOnReconnect: !0,
+				refetchOnWindowFocus: !0,
+				retryOnMount: !0,
+				queryKeyHashFn: e,
+				experimental_prefetchInRender: !0
+			},
+			mutations: {
+				gcTime: s,
+				networkMode: "online",
+				retry: !1,
+				throwOnError: !1
+			}
+		}
+	});
+	return l;
+}
+//#endregion
+export { o as createQueryClient, i as keepPreviousData };

package/dist/es/query/hooks.js

@@ -0,0 +1,26 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { matchMutation as e, matchQuery as t, skipToken as n, useInfiniteQuery as r, useIsFetching as i, useIsMutating as a, useMutation as o, useMutationState as s, useQueries as c, useQuery as l, useQueryErrorResetBoundary as u } from "@tanstack/react-query";
+//#region src/query/hooks.ts
+function d(e) {
+	return l(e);
+}
+function f(e) {
+	return r(e);
+}
+function p(e) {
+	return c(e);
+}
+function m(e) {
+	return o(e);
+}
+function h(e) {
+	return s(e);
+}
+function g(e) {
+	return i(e);
+}
+function _(e) {
+	return a(e);
+}
+//#endregion
+export { e as matchMutation, t as matchQuery, n as skipQueryToken, f as useInfiniteQuery, g as useIsFetching, _ as useIsMutating, m as useMutation, h as useMutationState, p as useQueries, d as useQuery, u as useQueryErrorResetBoundary };

package/dist/es/query/index.js

@@ -0,0 +1,4 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import "./constants.js";
+import "./helpers.js";
+import "./hooks.js";

package/dist/es/sse/client.js

@@ -0,0 +1,121 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { isString as e } from "@vef-framework-react/shared";
+import { fetchEventSource as t } from "@microsoft/fetch-event-source";
+//#region src/sse/client.ts
+var n = class extends Error {
+	constructor() {
+		super("Token expired"), this.name = "TokenExpiredError";
+	}
+};
+function r(e, t) {
+	let n = t.toLowerCase();
+	return Object.keys(e).some((e) => e.toLowerCase() === n);
+}
+function i(t, n) {
+	if (t !== void 0) return e(t) ? t : (r(n, "content-type") || (n["Content-Type"] = "application/json"), JSON.stringify(t));
+}
+var a = class {
+	#e;
+	#t = /* @__PURE__ */ new Set();
+	constructor(e = {}) {
+		this.#e = {
+			enableRetry: !0,
+			maxRetries: 3,
+			...e
+		};
+	}
+	stream(e, t) {
+		return this.#n(e, t, !1);
+	}
+	abort() {
+		for (let e of this.#t) e.abort();
+		this.#t.clear();
+	}
+	async #n(e, r, a) {
+		let o = new AbortController();
+		this.#t.add(o);
+		let s = this.#r(e.signal, o), c = await this.#i(e.headers), l = i(e.body, c), u = 0, d = !1, f = () => {
+			d || (d = !0, s?.(), this.#t.delete(o));
+		};
+		try {
+			await t(e.url, {
+				method: e.method ?? "POST",
+				headers: c,
+				body: l,
+				signal: o.signal,
+				onopen: async (e) => {
+					if (e.status === 401) throw new n();
+					if (!e.ok) throw Error(`HTTP ${e.status}: ${e.statusText}`);
+					let t = e.headers.get("content-type");
+					if (t && !t.includes("text/event-stream")) throw Error(`Expected content-type to be text/event-stream, got ${t}`);
+					u = 0, await r.onOpen?.(e);
+				},
+				onmessage: (e) => {
+					r.onMessage({
+						id: e.id,
+						event: e.event,
+						data: e.data
+					});
+				},
+				onerror: (e) => {
+					if (o.signal.aborted) return;
+					if (e instanceof n) throw e;
+					if (this.#e.enableRetry && u < this.#e.maxRetries) {
+						u++, console.warn(`SSE connection error, retrying (${u}/${this.#e.maxRetries})...`);
+						return;
+					}
+					let t = e;
+					throw r.onError?.(t), this.#e.showErrorMessage?.(t.message), e;
+				},
+				onclose: () => {
+					r.onClose?.();
+				}
+			});
+		} catch (t) {
+			if (!await this.#a(t, e, r, a, f)) throw t;
+		} finally {
+			f();
+		}
+	}
+	#r(e, t) {
+		if (!e) return;
+		let n = () => {
+			t.abort(e.reason);
+		};
+		if (e.aborted) {
+			n();
+			return;
+		}
+		return e.addEventListener("abort", n, { once: !0 }), () => e.removeEventListener("abort", n);
+	}
+	async #i(e) {
+		let t = { ...e };
+		try {
+			let e = await this.#e.getAuthTokens?.();
+			e?.accessToken && !r(t, "authorization") && (t.Authorization = `Bearer ${e.accessToken}`);
+		} catch (e) {
+			console.error("Failed to get auth tokens:", e);
+		}
+		return t;
+	}
+	async #a(e, t, r, i, a) {
+		if (e instanceof Error && e.name === "AbortError") return !0;
+		if (e instanceof n && !i) {
+			if (await this.#o()) return a(), await this.#n(t, r, !0), !0;
+			let e = /* @__PURE__ */ Error("Authentication failed: token expired");
+			return r.onError?.(e), this.#e.showErrorMessage?.(e.message), !0;
+		}
+		return !1;
+	}
+	async #o() {
+		let { onTokenExpired: e } = this.#e;
+		if (!e) return !1;
+		try {
+			return await e();
+		} catch (e) {
+			return console.error("Failed to refresh token:", e), !1;
+		}
+	}
+};
+//#endregion
+export { a as SseClient };

package/dist/es/sse/helpers.js

@@ -0,0 +1,8 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { SseClient as e } from "./client.js";
+//#region src/sse/helpers.ts
+function t(t) {
+	return new e(t);
+}
+//#endregion
+export { t as createSseClient };

package/dist/es/sse/index.js

@@ -0,0 +1,3 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import "./client.js";
+import "./helpers.js";

package/dist/es/state/index.js

@@ -0,0 +1,3 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { Provider as e, atom as t, createStore as n, getDefaultStore as r, useAtom as i, useAtomValue as a, useSetAtom as o, useStore as s } from "jotai";
+export { e as AtomStoreProvider, t as atom, n as createAtomStore, r as getDefaultAtomStore, i as useAtom, s as useAtomStore, a as useAtomValue, o as useSetAtom };

package/dist/es/state-machine/index.js

@@ -0,0 +1,14 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { useActorRef as e, useActorRef as t, useSelector as n } from "@xstate/react";
+import { Actor as r, assign as i, createActor as a, createMachine as o } from "xstate";
+//#region src/state-machine/index.ts
+function s(t, r, ...[i]) {
+	let a = e(t, i);
+	return [
+		n(a, r, Object.is),
+		a.send,
+		a
+	];
+}
+//#endregion
+export { r as Actor, a as createActor, o as createMachine, i as updateContext, s as useActor, t as useActorRef };

package/dist/es/store/bound.js

@@ -0,0 +1,20 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { constantCase as e, identity as t } from "@vef-framework-react/shared";
+import { create as n } from "zustand";
+import { createJSONStorage as r, persist as i, subscribeWithSelector as a } from "zustand/middleware";
+import { immer as o } from "zustand/middleware/immer";
+//#region src/store/bound.ts
+function s(e) {
+	return n()(a(o(e)));
+}
+function c(s, c) {
+	let { name: l, storage: u, selector: d } = c, f = `__VEF_STORE__${e(l)}__`, p = u === "local" ? localStorage : sessionStorage;
+	return n()(a(i(o(s), {
+		name: f,
+		version: 1,
+		storage: r(() => p),
+		partialize: d ?? t
+	})));
+}
+//#endregion
+export { c as createPersistedStore, s as createStore };

package/dist/es/store/index.js

@@ -0,0 +1,6 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import "./bound.js";
+import "./unbound.js";
+import "./use-deep.js";
+import { useShallow as e } from "zustand/shallow";
+export { e as useShallow };

package/dist/es/store/unbound.js

@@ -0,0 +1,44 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { isPlainObject as e, mergeWith as t } from "@vef-framework-react/shared";
+import { createContext as n, use as r, useRef as i } from "react";
+import { jsx as a } from "@emotion/react/jsx-runtime";
+import { useIsomorphicLayoutEffect as o } from "motion/react";
+import { createStore as s, useStore as c } from "zustand";
+import { subscribeWithSelector as l } from "zustand/middleware";
+import { immer as u } from "zustand/middleware/immer";
+//#region src/store/unbound.tsx
+var d = /* @__PURE__ */ new Map();
+function f(f, p) {
+	let m = `${f}StoreContext`, h = d.get(m);
+	h || (h = n(null), h.displayName = m, d.set(m, h));
+	let g = h;
+	function _({ children: n, initialState: r }) {
+		let c = i(null), d = i(!1), f = i(r);
+		return f.current = r, (!c.current || !d.current) && (c.current = s()(l(u(p))), d.current = !0), o(() => {
+			!e(f.current) || !c.current || c.current.setState((e) => {
+				t(e, f.current, !0);
+			});
+		}, []), /* @__PURE__ */ a(g, {
+			value: c.current,
+			children: n
+		});
+	}
+	function v() {
+		let e = r(g);
+		if (!e) {
+			let e = `${f}Store is not found in the React context. Ensure the component is wrapped in ${f}StoreProvider.`;
+			throw Error(e + "");
+		}
+		return e;
+	}
+	function y(e) {
+		return c(v(), e);
+	}
+	return {
+		StoreProvider: _,
+		useStoreApi: v,
+		useStore: y
+	};
+}
+//#endregion
+export { f as createComponentStore };

package/dist/es/store/use-deep.js

@@ -0,0 +1,13 @@
+/*! @vef-framework-react/core v2.1.0 made by Venus | 2026-03-27T08:01:41.111Z */
+import { isDeepEqual as e } from "@vef-framework-react/shared";
+import { useRef as t } from "react";
+//#region src/store/use-deep.ts
+function n(n) {
+	let r = t(null);
+	return (t) => {
+		let i = n(t);
+		return e(r.current, i) ? r.current : (r.current = i, i);
+	};
+}
+//#endregion
+export { n as useDeep };

package/dist/types/src/ai/index.d.ts

@@ -0,0 +1,6 @@
+export { DefaultChatTransport, TextStreamChatTransport, type ChatTransport } from 'ai';
+export type { DataUIPart, DynamicToolUIPart, FileUIPart, ReasoningUIPart, SourceDocumentUIPart, SourceUrlUIPart, StepStartUIPart, TextUIPart, ToolUIPart, UIMessage, UIMessageChunk, UIMessagePart } from 'ai';
+export type { UIToolInvocation, UITools } from 'ai';
+export { getToolName, getToolOrDynamicToolName } from 'ai';
+export { isDataUIPart, isFileUIPart, isReasoningUIPart, isTextUIPart, isToolOrDynamicToolUIPart, isToolUIPart } from 'ai';
+export { isDeepEqualData, parsePartialJson } from 'ai';

package/dist/types/src/api/client.d.ts

@@ -0,0 +1,55 @@
+import { FetchQueryOptions, MutationOptions, QueryClient, QueryMeta } from '@tanstack/react-query';
+import { Awaitable, Except, If, IsNever, IsOptional } from '@vef-framework-react/shared';
+import { HttpClient } from '../http';
+import { ApiClientOptions, MutationFunction, QueryFunction, QueryKey } from './types';
+import { HTTP_CLIENT, QUERY_CLIENT } from './constants';
+/**
+ * API client that combines HttpClient and QueryClient for data fetching.
+ */
+export declare class ApiClient {
+    #private;
+    /**
+     * Access the underlying QueryClient.
+     */
+    get [QUERY_CLIENT](): QueryClient;
+    /**
+     * Access the underlying HttpClient.
+     */
+    get [HTTP_CLIENT](): Readonly<HttpClient>;
+    constructor(options: ApiClientOptions);
+    /**
+     * Create a proxied HttpClient that injects the current abort signal.
+     */
+    private createProxiedHttpClient;
+    /**
+     * Create a query function with automatic signal injection.
+     */
+    createQueryFn<TResult = unknown, TParams = never, TPageParam = never>(key: string, factory: (http: Readonly<HttpClient>) => (queryParams: TParams, pageParam: TPageParam, meta?: QueryMeta) => Awaitable<TResult>): QueryFunction<TResult, TParams, TPageParam>;
+    /**
+     * Create a mutation function.
+     */
+    createMutationFn<TResult = unknown, TParams = never>(key: string, factory: (http: Readonly<HttpClient>) => (params: TParams) => Awaitable<TResult>): MutationFunction<TResult, TParams>;
+    /**
+     * Fetch a query and return the result.
+     */
+    fetchQuery<TQueryFnData = unknown, TData = TQueryFnData, TParams = unknown, TPageParam = never>(options: Except<FetchQueryOptions<TQueryFnData, Error, TData, QueryKey<TParams>, TPageParam>, "queryHash" | "queryKeyHashFn">): Promise<TData>;
+    /**
+     * Prefetch a query and store the result in cache.
+     */
+    prefetchQuery<TQueryFnData = unknown, TData = TQueryFnData, TParams = unknown, TPageParam = never>(options: Except<FetchQueryOptions<TQueryFnData, Error, TData, QueryKey<TParams>, TPageParam>, "queryHash" | "queryKeyHashFn">): Promise<void>;
+    /**
+     * Execute a mutation imperatively outside of React components.
+     *
+     * Useful for scenarios like login flows, event handlers, or any code outside React components.
+     * Lifecycle callbacks (onMutate, onSuccess, etc.) still fire.
+     */
+    executeMutation<TData = unknown, TParams = unknown, TOnMutateResult = unknown>({ mutationFn, params, ...options }: Except<MutationOptions<TData, Error, TParams, TOnMutateResult>, "mutationKey" | "mutationFn"> & {
+        mutationFn: MutationFunction<TData, TParams>;
+    } & If<IsNever<TParams>, {
+        params?: never;
+    }, If<IsOptional<TParams>, {
+        params?: TParams;
+    }, {
+        params: TParams;
+    }>>): Promise<TData>;
+}

package/dist/types/src/api/constants.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HTTP methods that should have the abort signal injected.
+ */
+export declare const PROXIED_METHODS: Set<string>;
+/**
+ * Symbol for accessing the query client.
+ */
+export declare const QUERY_CLIENT: unique symbol;
+/**
+ * Symbol for accessing the HTTP client.
+ */
+export declare const HTTP_CLIENT: unique symbol;

package/dist/types/src/api/helpers.d.ts

@@ -0,0 +1,9 @@
+import { ApiClientOptions } from './types';
+import { ApiClient } from './client';
+/**
+ * Creates a new API client.
+ *
+ * @param options - The options for the API client.
+ * @returns The API client.
+ */
+export declare function createApiClient(options: ApiClientOptions): ApiClient;

package/dist/types/src/api/index.d.ts

@@ -0,0 +1,4 @@
+export { ApiClient } from './client';
+export { HTTP_CLIENT, QUERY_CLIENT } from './constants';
+export { createApiClient } from './helpers';
+export type * from './types';

package/dist/types/src/api/types.d.ts

@@ -0,0 +1,48 @@
+import { MutationFunction as MutationFunctionInternal, QueryFunction as QueryFunctionInternal } from '@tanstack/react-query';
+import { If, IsNever, Key } from '@vef-framework-react/shared';
+import { HttpClientOptions } from '../http';
+import { QueryClientOptions } from '../query';
+/**
+ * The options for the API client.
+ */
+export interface ApiClientOptions {
+    /**
+     * The options for the HTTP client.
+     */
+    http: HttpClientOptions;
+    /**
+     * The options for the query client.
+     */
+    query?: QueryClientOptions;
+}
+/**
+ * The key of the query.
+ *
+ * @param TParams - The parameters of the query.
+ */
+export type QueryKey<TParams = never> = readonly [Key, ...If<IsNever<TParams>, [], [TParams]>];
+/**
+ * The query function.
+ *
+ * @param TResult - The result of the query.
+ * @param TParams - The parameters of the query.
+ * @param TPageParam - The page parameter of the query.
+ */
+export interface QueryFunction<TData = unknown, TParams = never, TPageParam = never> extends QueryFunctionInternal<TData, QueryKey<TParams>, TPageParam> {
+    /**
+     * The API identifier.
+     */
+    key: Key;
+}
+/**
+ * The mutation function.
+ *
+ * @param TResult - The result of the mutation.
+ * @param TParams - The parameters of the mutation.
+ */
+export interface MutationFunction<TData = unknown, TParams = never> extends MutationFunctionInternal<TData, TParams> {
+    /**
+     * The API identifier.
+     */
+    key: Key;
+}

package/dist/types/src/auth/helpers.d.ts

@@ -0,0 +1,11 @@
+import { MaybeArray } from '@vef-framework-react/shared';
+import { PermissionCheckMode } from './types.js';
+/**
+ * Check if the user is authorized to access the resource identified by the permission token.
+ *
+ * @param hasPermission - Function to check if the user has a specific permission token.
+ * @param permTokens - Single token or array of tokens to check. If nullish, returns true (no permission required).
+ * @param checkMode - "any" requires at least one token match, "all" requires all tokens to match.
+ * @returns True if the user has the required permission(s), false otherwise.
+ */
+export declare function checkPermission(hasPermission: (token: string) => boolean, permTokens?: MaybeArray<string>, checkMode?: PermissionCheckMode): boolean;

package/dist/types/src/auth/index.d.ts

@@ -0,0 +1,2 @@
+export { checkPermission } from './helpers.js';
+export type * from './types.js';

package/dist/types/src/auth/types.d.ts

@@ -0,0 +1 @@
+export type PermissionCheckMode = "any" | "all";

package/dist/types/src/common/index.d.ts

@@ -0,0 +1 @@
+export type * from './types.js';