@veloxts/client 0.4.2 → 0.4.4

package/dist/react/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Type definitions for React hooks integration
+ *
+ * Provides type utilities for building type-safe React Query hooks
+ * that work with VeloxTS procedure definitions.
+ *
+ * @module @veloxts/client/react/types
+ */
+import type { UseMutationOptions, UseQueryOptions } from '@tanstack/react-query';
+import type { ClientConfig, ClientFromRouter, InferProcedureInput, InferProcedureOutput, ProcedureCollection } from '../types.js';
+/**
+ * Extracts a specific procedure from the router type
+ *
+ * Enables type inference for procedure input/output in hooks.
+ *
+ * @template TRouter - The router type (collection of procedure collections)
+ * @template TNamespace - The namespace key (e.g., 'users', 'posts')
+ * @template TProcedureName - The procedure name (e.g., 'getUser', 'listUsers')
+ */
+export type GetProcedure<TRouter, TNamespace extends keyof TRouter, TProcedureName extends keyof GetProceduresFromCollection<TRouter[TNamespace]>> = TRouter[TNamespace] extends ProcedureCollection<infer TProcedures> ? TProcedureName extends keyof TProcedures ? TProcedures[TProcedureName] : never : never;
+/**
+ * Extracts the procedures record from a collection
+ *
+ * @template TCollection - The procedure collection type
+ */
+export type GetProceduresFromCollection<TCollection> = TCollection extends ProcedureCollection ? TCollection['procedures'] : never;
+/**
+ * Options for useQuery hook
+ *
+ * Omits queryKey and queryFn since those are provided automatically
+ * based on the procedure namespace, name, and input.
+ *
+ * @template TData - The expected response data type
+ * @template TError - The error type (defaults to Error)
+ */
+export type VeloxUseQueryOptions<TData, TError = Error> = Omit<UseQueryOptions<TData, TError>, 'queryKey' | 'queryFn'>;
+/**
+ * Options for useMutation hook
+ *
+ * Omits mutationFn since that's provided automatically
+ * based on the procedure namespace and name.
+ *
+ * @template TData - The expected response data type
+ * @template TInput - The mutation input type
+ * @template TError - The error type (defaults to Error)
+ * @template TContext - The mutation context type
+ */
+export type VeloxUseMutationOptions<TData, TInput, TError = Error, TContext = unknown> = Omit<UseMutationOptions<TData, TError, TInput, TContext>, 'mutationFn'>;
+/**
+ * Query key structure for VeloxTS
+ *
+ * Format: [namespace, procedureName, input?]
+ *
+ * This structure enables:
+ * - Invalidating all queries for a namespace: `['users']`
+ * - Invalidating a specific procedure: `['users', 'getUser']`
+ * - Invalidating a specific query: `['users', 'getUser', { id: '123' }]`
+ */
+export type VeloxQueryKey = readonly [string, string] | readonly [string, string, Record<string, unknown>];
+/**
+ * Context value provided by VeloxProvider
+ *
+ * @template TRouter - The router type for type-safe client access
+ */
+export interface VeloxContextValue<TRouter> {
+    /** The typed client instance */
+    readonly client: ClientFromRouter<TRouter>;
+}
+/**
+ * Props for VeloxProvider component
+ *
+ * @template _TRouter - The router type for type-safe client configuration (used for generic inference)
+ */
+export interface VeloxProviderProps<_TRouter> {
+    /** React children to render within the provider */
+    readonly children: React.ReactNode;
+    /** Client configuration (baseUrl, headers, etc.) */
+    readonly config: ClientConfig;
+    /** Optional pre-configured QueryClient instance */
+    readonly queryClient?: import('@tanstack/react-query').QueryClient;
+}
+export type { InferProcedureInput, InferProcedureOutput, ProcedureCollection, ClientConfig, ClientFromRouter, };
+//# sourceMappingURL=types.d.ts.map

package/dist/react/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAMrB;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,CACtB,OAAO,EACP,UAAU,SAAS,MAAM,OAAO,EAChC,cAAc,SAAS,MAAM,2BAA2B,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAC3E,OAAO,CAAC,UAAU,CAAC,SAAS,mBAAmB,CAAC,MAAM,WAAW,CAAC,GAClE,cAAc,SAAS,MAAM,WAAW,GACtC,WAAW,CAAC,cAAc,CAAC,GAC3B,KAAK,GACP,KAAK,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,CAAC,WAAW,IAAI,WAAW,SAAS,mBAAmB,GAC1F,WAAW,CAAC,YAAY,CAAC,GACzB,KAAK,CAAC;AAMV;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAC5D,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,EAC9B,UAAU,GAAG,SAAS,CACvB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,QAAQ,GAAG,OAAO,IAAI,IAAI,CAC3F,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EACnD,YAAY,CACb,CAAC;AAMF;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAMvD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO;IACxC,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAC5C;AAED;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB,CAAC,QAAQ;IAC1C,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,uBAAuB,EAAE,WAAW,CAAC;CACpE;AAMD,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,GACjB,CAAC"}

package/dist/react/types.js

@@ -0,0 +1,10 @@
+/**
+ * Type definitions for React hooks integration
+ *
+ * Provides type utilities for building type-safe React Query hooks
+ * that work with VeloxTS procedure definitions.
+ *
+ * @module @veloxts/client/react/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/react/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/react/utils.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Utility functions for React Query integration
+ *
+ * Provides query key builders and cache invalidation helpers
+ * for consistent and predictable caching behavior.
+ *
+ * @module @veloxts/client/react/utils
+ */
+import type { QueryClient } from '@tanstack/react-query';
+import type { VeloxQueryKey } from './types.js';
+/**
+ * Builds a stable query key for React Query
+ *
+ * Query keys are structured as: [namespace, procedureName, input?]
+ * This enables efficient cache invalidation by namespace or procedure.
+ *
+ * The key structure follows React Query best practices:
+ * - Keys are arrays for hierarchical invalidation
+ * - Input is serialized for stable identity
+ *
+ * @param namespace - The procedure namespace (e.g., 'users')
+ * @param procedureName - The procedure name (e.g., 'getUser')
+ * @param input - Optional input parameters
+ * @returns A stable query key array
+ *
+ * @example
+ * ```typescript
+ * // Query with no input
+ * buildQueryKey('health', 'check');
+ * // => ['health', 'check']
+ *
+ * // Query with object input
+ * buildQueryKey('users', 'getUser', { id: '123' });
+ * // => ['users', 'getUser', { id: '123' }]
+ *
+ * // Query with primitive input (wrapped)
+ * buildQueryKey('users', 'getCount', 10);
+ * // => ['users', 'getCount', { value: 10 }]
+ * ```
+ */
+export declare function buildQueryKey(namespace: string, procedureName: string, input?: unknown): VeloxQueryKey;
+/**
+ * Invalidates all queries for a namespace
+ *
+ * This is useful after mutations that may affect multiple resources
+ * within the same namespace.
+ *
+ * @param queryClient - The React Query client instance
+ * @param namespace - The namespace to invalidate (e.g., 'users')
+ *
+ * @example
+ * ```typescript
+ * const queryClient = useQueryClient();
+ *
+ * // After deleting a user, invalidate all user queries
+ * await invalidateNamespace(queryClient, 'users');
+ * ```
+ */
+export declare function invalidateNamespace(queryClient: QueryClient, namespace: string): Promise<void>;
+/**
+ * Invalidates all queries for a specific procedure
+ *
+ * This is useful when you want to refetch all instances of a specific
+ * query without affecting other queries in the same namespace.
+ *
+ * @param queryClient - The React Query client instance
+ * @param namespace - The procedure namespace (e.g., 'users')
+ * @param procedureName - The procedure name (e.g., 'getUser')
+ *
+ * @example
+ * ```typescript
+ * const queryClient = useQueryClient();
+ *
+ * // After updating a user, invalidate all getUser queries
+ * await invalidateProcedure(queryClient, 'users', 'getUser');
+ * ```
+ */
+export declare function invalidateProcedure(queryClient: QueryClient, namespace: string, procedureName: string): Promise<void>;
+/**
+ * Invalidates a specific query by its exact key
+ *
+ * This is useful when you know the exact input and want to invalidate
+ * only that specific cached query.
+ *
+ * @param queryClient - The React Query client instance
+ * @param namespace - The procedure namespace (e.g., 'users')
+ * @param procedureName - The procedure name (e.g., 'getUser')
+ * @param input - The exact input used in the query
+ *
+ * @example
+ * ```typescript
+ * const queryClient = useQueryClient();
+ *
+ * // After updating user 123, invalidate only that specific query
+ * await invalidateQuery(queryClient, 'users', 'getUser', { id: '123' });
+ * ```
+ */
+export declare function invalidateQuery(queryClient: QueryClient, namespace: string, procedureName: string, input?: unknown): Promise<void>;
+/**
+ * Gets cached data for a specific query
+ *
+ * Useful for optimistic updates where you need the current cached value.
+ *
+ * @param queryClient - The React Query client instance
+ * @param namespace - The procedure namespace
+ * @param procedureName - The procedure name
+ * @param input - The query input
+ * @returns The cached data or undefined if not cached
+ *
+ * @example
+ * ```typescript
+ * const queryClient = useQueryClient();
+ *
+ * // Get current cached user before optimistic update
+ * const previousUser = getQueryData<User>(
+ *   queryClient,
+ *   'users',
+ *   'getUser',
+ *   { id: '123' }
+ * );
+ * ```
+ */
+export declare function getQueryData<TData>(queryClient: QueryClient, namespace: string, procedureName: string, input?: unknown): TData | undefined;
+/**
+ * Sets cached data for a specific query
+ *
+ * Useful for optimistic updates where you want to update the cache
+ * immediately before the mutation completes.
+ *
+ * @param queryClient - The React Query client instance
+ * @param namespace - The procedure namespace
+ * @param procedureName - The procedure name
+ * @param input - The query input
+ * @param data - The data to cache
+ *
+ * @example
+ * ```typescript
+ * const queryClient = useQueryClient();
+ *
+ * // Optimistically update user in cache
+ * setQueryData<User>(
+ *   queryClient,
+ *   'users',
+ *   'getUser',
+ *   { id: '123' },
+ *   { ...previousUser, name: 'New Name' }
+ * );
+ * ```
+ */
+export declare function setQueryData<TData>(queryClient: QueryClient, namespace: string, procedureName: string, input: unknown, data: TData): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/react/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/react/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,OAAO,GACd,aAAa,CAYf;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAGf;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAChC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,OAAO,GACd,KAAK,GAAG,SAAS,CAGnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAChC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,KAAK,GACV,IAAI,CAGN"}

package/dist/react/utils.js

@@ -0,0 +1,181 @@
+/**
+ * Utility functions for React Query integration
+ *
+ * Provides query key builders and cache invalidation helpers
+ * for consistent and predictable caching behavior.
+ *
+ * @module @veloxts/client/react/utils
+ */
+// ============================================================================
+// Query Key Builders
+// ============================================================================
+/**
+ * Builds a stable query key for React Query
+ *
+ * Query keys are structured as: [namespace, procedureName, input?]
+ * This enables efficient cache invalidation by namespace or procedure.
+ *
+ * The key structure follows React Query best practices:
+ * - Keys are arrays for hierarchical invalidation
+ * - Input is serialized for stable identity
+ *
+ * @param namespace - The procedure namespace (e.g., 'users')
+ * @param procedureName - The procedure name (e.g., 'getUser')
+ * @param input - Optional input parameters
+ * @returns A stable query key array
+ *
+ * @example
+ * ```typescript
+ * // Query with no input
+ * buildQueryKey('health', 'check');
+ * // => ['health', 'check']
+ *
+ * // Query with object input
+ * buildQueryKey('users', 'getUser', { id: '123' });
+ * // => ['users', 'getUser', { id: '123' }]
+ *
+ * // Query with primitive input (wrapped)
+ * buildQueryKey('users', 'getCount', 10);
+ * // => ['users', 'getCount', { value: 10 }]
+ * ```
+ */
+export function buildQueryKey(namespace, procedureName, input) {
+    if (input === undefined || input === null) {
+        return [namespace, procedureName];
+    }
+    // For objects, include directly in key for proper caching
+    if (typeof input === 'object') {
+        return [namespace, procedureName, input];
+    }
+    // For primitives, wrap in object to maintain consistent key structure
+    return [namespace, procedureName, { value: input }];
+}
+// ============================================================================
+// Cache Invalidation Helpers
+// ============================================================================
+/**
+ * Invalidates all queries for a namespace
+ *
+ * This is useful after mutations that may affect multiple resources
+ * within the same namespace.
+ *
+ * @param queryClient - The React Query client instance
+ * @param namespace - The namespace to invalidate (e.g., 'users')
+ *
+ * @example
+ * ```typescript
+ * const queryClient = useQueryClient();
+ *
+ * // After deleting a user, invalidate all user queries
+ * await invalidateNamespace(queryClient, 'users');
+ * ```
+ */
+export async function invalidateNamespace(queryClient, namespace) {
+    await queryClient.invalidateQueries({ queryKey: [namespace] });
+}
+/**
+ * Invalidates all queries for a specific procedure
+ *
+ * This is useful when you want to refetch all instances of a specific
+ * query without affecting other queries in the same namespace.
+ *
+ * @param queryClient - The React Query client instance
+ * @param namespace - The procedure namespace (e.g., 'users')
+ * @param procedureName - The procedure name (e.g., 'getUser')
+ *
+ * @example
+ * ```typescript
+ * const queryClient = useQueryClient();
+ *
+ * // After updating a user, invalidate all getUser queries
+ * await invalidateProcedure(queryClient, 'users', 'getUser');
+ * ```
+ */
+export async function invalidateProcedure(queryClient, namespace, procedureName) {
+    await queryClient.invalidateQueries({ queryKey: [namespace, procedureName] });
+}
+/**
+ * Invalidates a specific query by its exact key
+ *
+ * This is useful when you know the exact input and want to invalidate
+ * only that specific cached query.
+ *
+ * @param queryClient - The React Query client instance
+ * @param namespace - The procedure namespace (e.g., 'users')
+ * @param procedureName - The procedure name (e.g., 'getUser')
+ * @param input - The exact input used in the query
+ *
+ * @example
+ * ```typescript
+ * const queryClient = useQueryClient();
+ *
+ * // After updating user 123, invalidate only that specific query
+ * await invalidateQuery(queryClient, 'users', 'getUser', { id: '123' });
+ * ```
+ */
+export async function invalidateQuery(queryClient, namespace, procedureName, input) {
+    const queryKey = buildQueryKey(namespace, procedureName, input);
+    await queryClient.invalidateQueries({ queryKey });
+}
+// ============================================================================
+// Cache Data Accessors
+// ============================================================================
+/**
+ * Gets cached data for a specific query
+ *
+ * Useful for optimistic updates where you need the current cached value.
+ *
+ * @param queryClient - The React Query client instance
+ * @param namespace - The procedure namespace
+ * @param procedureName - The procedure name
+ * @param input - The query input
+ * @returns The cached data or undefined if not cached
+ *
+ * @example
+ * ```typescript
+ * const queryClient = useQueryClient();
+ *
+ * // Get current cached user before optimistic update
+ * const previousUser = getQueryData<User>(
+ *   queryClient,
+ *   'users',
+ *   'getUser',
+ *   { id: '123' }
+ * );
+ * ```
+ */
+export function getQueryData(queryClient, namespace, procedureName, input) {
+    const queryKey = buildQueryKey(namespace, procedureName, input);
+    return queryClient.getQueryData(queryKey);
+}
+/**
+ * Sets cached data for a specific query
+ *
+ * Useful for optimistic updates where you want to update the cache
+ * immediately before the mutation completes.
+ *
+ * @param queryClient - The React Query client instance
+ * @param namespace - The procedure namespace
+ * @param procedureName - The procedure name
+ * @param input - The query input
+ * @param data - The data to cache
+ *
+ * @example
+ * ```typescript
+ * const queryClient = useQueryClient();
+ *
+ * // Optimistically update user in cache
+ * setQueryData<User>(
+ *   queryClient,
+ *   'users',
+ *   'getUser',
+ *   { id: '123' },
+ *   { ...previousUser, name: 'New Name' }
+ * );
+ * ```
+ */
+export function setQueryData(queryClient, namespace, procedureName, input, data) {
+    const queryKey = buildQueryKey(namespace, procedureName, input);
+    queryClient.setQueryData(queryKey, data);
+}
+//# sourceMappingURL=utils.js.map

package/dist/react/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/react/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,aAAqB,EACrB,KAAe;IAEf,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,CAAC,SAAS,EAAE,aAAa,CAAU,CAAC;IAC7C,CAAC;IAED,0DAA0D;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,SAAS,EAAE,aAAa,EAAE,KAAgC,CAAU,CAAC;IAC/E,CAAC;IAED,sEAAsE;IACtE,OAAO,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAU,CAAC;AAC/D,CAAC;AAED,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAwB,EACxB,SAAiB;IAEjB,MAAM,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAwB,EACxB,SAAiB,EACjB,aAAqB;IAErB,MAAM,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAwB,EACxB,SAAiB,EACjB,aAAqB,EACrB,KAAe;IAEf,MAAM,QAAQ,GAAG,aAAa,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;IAChE,MAAM,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,YAAY,CAC1B,WAAwB,EACxB,SAAiB,EACjB,aAAqB,EACrB,KAAe;IAEf,MAAM,QAAQ,GAAG,aAAa,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;IAChE,OAAO,WAAW,CAAC,YAAY,CAAQ,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,YAAY,CAC1B,WAAwB,EACxB,SAAiB,EACjB,aAAqB,EACrB,KAAc,EACd,IAAW;IAEX,MAAM,QAAQ,GAAG,aAAa,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;IAChE,WAAW,CAAC,YAAY,CAAQ,QAAQ,EAAE,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/dist/test-setup.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Test setup file for Vitest
+ *
+ * Sets up jest-dom matchers for React Testing Library
+ */
+import '@testing-library/jest-dom/vitest';
+//# sourceMappingURL=test-setup.d.ts.map

package/dist/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,kCAAkC,CAAC"}

package/dist/test-setup.js

@@ -0,0 +1,7 @@
+/**
+ * Test setup file for Vitest
+ *
+ * Sets up jest-dom matchers for React Testing Library
+ */
+import '@testing-library/jest-dom/vitest';
+//# sourceMappingURL=test-setup.js.map

package/dist/test-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.js","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,kCAAkC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/client",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Type-safe frontend API client for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -9,15 +9,46 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
     }
   },
   "files": [
     "dist",
     "README.md"
   ],
-  "dependencies": {},
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-query": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@tanstack/react-query": "5.62.11",
+    "@testing-library/jest-dom": "6.9.1",
+    "@testing-library/react": "16.3.0",
+    "@types/react": "18.3.18",
     "@vitest/coverage-v8": "4.0.15",
+    "jsdom": "26.1.0",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
     "typescript": "5.9.3",
     "vitest": "4.0.15"
   },
@@ -26,7 +57,9 @@
     "client",
     "api",
     "fetch",
-    "typescript"
+    "typescript",
+    "react",
+    "react-query"
   ],
   "license": "MIT",
   "repository": {
@@ -39,14 +72,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "type-check": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "clean": "rm -rf dist tsconfig.tsbuildinfo"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 VeloxTS Framework Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.