@veloxts/client 0.4.8 → 0.4.10

package/dist/react/proxy-types.d.ts

@@ -0,0 +1,401 @@
+/**
+ * Type definitions for tRPC-style proxy hooks
+ *
+ * Provides type utilities for the new `createVeloxHooks` API that enables
+ * full IDE autocomplete through a proxy-based hook system.
+ *
+ * @module @veloxts/client/react/proxy-types
+ */
+import type { QueryClient, UseMutationOptions, UseMutationResult, UseQueryOptions, UseQueryResult, UseSuspenseQueryOptions, UseSuspenseQueryResult } from '@tanstack/react-query';
+import type { ClientFromRouter, ClientProcedure, ProcedureCollection, ProcedureRecord, ProcedureType } from '../types.js';
+import type { VeloxQueryKey } from './types.js';
+/**
+ * Extracts the procedure type ('query' or 'mutation') from a ClientProcedure
+ *
+ * @internal
+ */
+type ExtractProcedureType<T> = T extends ClientProcedure<unknown, unknown> ? T extends {
+    readonly type: infer TType;
+} ? TType extends ProcedureType ? TType : 'query' : 'query' : never;
+/**
+ * Hook methods available for query procedures
+ *
+ * Query procedures (get*, list*, find*) get these methods:
+ * - useQuery - Main hook for fetching data
+ * - useSuspenseQuery - Suspense-enabled variant
+ * - getQueryKey - Get the query key for manual cache operations
+ * - invalidate - Invalidate cached queries
+ * - prefetch - Prefetch data into cache
+ * - getData - Read from cache
+ * - setData - Write to cache
+ *
+ * @template TInput - The procedure input type
+ * @template TOutput - The procedure output type
+ */
+export interface VeloxQueryProcedure<TInput, TOutput> {
+    /**
+     * React Query hook for fetching data
+     *
+     * @param input - Procedure input (fully typed)
+     * @param options - React Query options (queryKey and queryFn auto-provided)
+     * @returns UseQueryResult with typed data
+     *
+     * @example
+     * ```tsx
+     * const { data, isLoading, error } = api.users.getUser.useQuery(
+     *   { id: userId },
+     *   { staleTime: 60_000 }
+     * );
+     * ```
+     */
+    useQuery(input: TInput, options?: Omit<UseQueryOptions<TOutput, Error>, 'queryKey' | 'queryFn'>): UseQueryResult<TOutput, Error>;
+    /**
+     * Suspense-enabled query hook
+     *
+     * Throws a promise for Suspense boundaries to catch.
+     * Data is guaranteed to be available when component renders.
+     *
+     * @example
+     * ```tsx
+     * function UserProfile({ userId }: { userId: string }) {
+     *   // Component only renders when data is available
+     *   const { data: user } = api.users.getUser.useSuspenseQuery({ id: userId });
+     *   return <h1>{user.name}</h1>;
+     * }
+     *
+     * // Usage with Suspense boundary
+     * <Suspense fallback={<Spinner />}>
+     *   <UserProfile userId="123" />
+     * </Suspense>
+     * ```
+     */
+    useSuspenseQuery(input: TInput, options?: Omit<UseSuspenseQueryOptions<TOutput, Error>, 'queryKey' | 'queryFn'>): UseSuspenseQueryResult<TOutput, Error>;
+    /**
+     * Get the query key for this procedure + input
+     *
+     * Useful for manual cache operations with QueryClient.
+     *
+     * @param input - Optional input to include in the key
+     * @returns Query key tuple: [namespace, procedureName, input?]
+     *
+     * @example
+     * ```tsx
+     * const key = api.users.getUser.getQueryKey({ id: '123' });
+     * // key = ['users', 'getUser', { id: '123' }]
+     * ```
+     */
+    getQueryKey(input?: TInput): VeloxQueryKey;
+    /**
+     * Invalidate queries for this procedure
+     *
+     * When called without input, invalidates all queries for this procedure.
+     * When called with input, invalidates only the specific query.
+     *
+     * @param input - Optional input to narrow invalidation (unique data first)
+     * @param queryClient - QueryClient instance from useQueryClient()
+     *
+     * @example
+     * ```tsx
+     * function UserProfile({ userId }: { userId: string }) {
+     *   const queryClient = useQueryClient();
+     *
+     *   const { mutate } = api.users.updateUser.useMutation({
+     *     onSuccess: () => {
+     *       api.users.getUser.invalidate({ id: userId }, queryClient);
+     *     },
+     *   });
+     *
+     *   // Invalidate all queries for this procedure
+     *   api.users.listUsers.invalidate(undefined, queryClient);
+     * }
+     * ```
+     */
+    invalidate(input: TInput | undefined, queryClient: QueryClient): Promise<void>;
+    /**
+     * Prefetch data for this procedure
+     *
+     * Fetches data and stores it in the cache without rendering.
+     * Useful for hover-to-prefetch patterns.
+     *
+     * @param input - Procedure input (unique data first)
+     * @param queryClient - QueryClient instance from useQueryClient()
+     *
+     * @example
+     * ```tsx
+     * function UserList() {
+     *   const queryClient = useQueryClient();
+     *
+     *   return (
+     *     <li onMouseEnter={() => api.users.getUser.prefetch({ id: user.id }, queryClient)}>
+     *       {user.name}
+     *     </li>
+     *   );
+     * }
+     * ```
+     */
+    prefetch(input: TInput, queryClient: QueryClient): Promise<void>;
+    /**
+     * Manually set cached data
+     *
+     * Useful for optimistic updates in mutation callbacks.
+     *
+     * @param input - Procedure input to identify the cache entry
+     * @param data - Data to store in cache (or null to clear)
+     * @param queryClient - QueryClient instance from useQueryClient()
+     *
+     * @example
+     * ```tsx
+     * function UserProfile() {
+     *   const queryClient = useQueryClient();
+     *
+     *   const { mutate } = api.users.updateUser.useMutation({
+     *     onSuccess: (updatedUser) => {
+     *       api.users.getUser.setData({ id: updatedUser.id }, updatedUser, queryClient);
+     *     },
+     *   });
+     *
+     *   // Clear cache entry
+     *   api.auth.getMe.setData({}, null, queryClient);
+     * }
+     * ```
+     */
+    setData(input: TInput, data: TOutput | null, queryClient: QueryClient): void;
+    /**
+     * Get cached data if available
+     *
+     * Returns undefined if not in cache.
+     *
+     * @param input - Procedure input to identify the cache entry
+     * @param queryClient - QueryClient instance from useQueryClient()
+     *
+     * @example
+     * ```tsx
+     * function UserProfile({ userId }: { userId: string }) {
+     *   const queryClient = useQueryClient();
+     *
+     *   const cachedUser = api.users.getUser.getData({ id: userId }, queryClient);
+     * }
+     * ```
+     */
+    getData(input: TInput, queryClient: QueryClient): TOutput | undefined;
+}
+/**
+ * Hook methods available for mutation procedures
+ *
+ * Mutation procedures (create*, update*, delete*, etc.) get this method:
+ * - useMutation - Hook for mutating data
+ *
+ * @template TInput - The procedure input type
+ * @template TOutput - The procedure output type
+ */
+export interface VeloxMutationProcedure<TInput, TOutput> {
+    /**
+     * React Query mutation hook
+     *
+     * @param options - React Query mutation options (mutationFn auto-provided)
+     * @returns UseMutationResult with typed variables and data
+     *
+     * @example
+     * ```tsx
+     * const { mutate, isPending } = api.users.createUser.useMutation({
+     *   onSuccess: (newUser) => {
+     *     api.users.listUsers.invalidate();
+     *   },
+     * });
+     *
+     * // Later
+     * mutate({ name: 'Alice', email: 'alice@example.com' });
+     * ```
+     */
+    useMutation<TContext = unknown>(options?: VeloxMutationOptions<TOutput, TInput, TContext>): UseMutationResult<TOutput, Error, TInput, TContext>;
+}
+/**
+ * Configuration for automatic cache invalidation after mutations
+ *
+ * VeloxTS automatically invalidates related queries after mutations succeed,
+ * following naming conventions:
+ *
+ * - `create*`, `add*` → invalidates `list*`, `find*` queries
+ * - `update*`, `edit*`, `patch*` → invalidates `get*` (matching ID), `list*`, `find*`
+ * - `delete*`, `remove*` → invalidates `get*` (matching ID), `list*`, `find*`
+ *
+ * This behavior is opt-out (enabled by default) and can be customized.
+ *
+ * @example
+ * ```tsx
+ * // Auto-invalidation happens by default
+ * const { mutate } = api.users.createUser.useMutation();
+ *
+ * // Disable auto-invalidation
+ * const { mutate } = api.users.createUser.useMutation({
+ *   autoInvalidate: false,
+ * });
+ *
+ * // Customize auto-invalidation
+ * const { mutate } = api.users.updateUser.useMutation({
+ *   autoInvalidate: {
+ *     additional: [['posts', 'listPosts']], // Also invalidate posts
+ *     exclude: ['findUsers'],               // Don't invalidate findUsers
+ *   },
+ * });
+ * ```
+ */
+export interface AutoInvalidationConfig {
+    /**
+     * Enable/disable auto-invalidation
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Additional queries to invalidate beyond convention-based rules
+     *
+     * Each tuple is [namespace, procedureName, input?]
+     *
+     * @example
+     * ```tsx
+     * autoInvalidate: {
+     *   additional: [
+     *     ['posts', 'listPosts'],           // Invalidate all listPosts
+     *     ['posts', 'getPost', { id: '1' }] // Invalidate specific post
+     *   ],
+     * }
+     * ```
+     */
+    additional?: Array<readonly [string, string, unknown?]>;
+    /**
+     * Procedure names to exclude from auto-invalidation
+     *
+     * @example
+     * ```tsx
+     * autoInvalidate: {
+     *   exclude: ['findUsers', 'getUserStats'],
+     * }
+     * ```
+     */
+    exclude?: string[];
+    /**
+     * Custom invalidation logic called after convention-based invalidation
+     *
+     * @example
+     * ```tsx
+     * autoInvalidate: {
+     *   custom: async ({ namespace, input, invalidate }) => {
+     *     await invalidate('getUserStats', input);
+     *   },
+     * }
+     * ```
+     */
+    custom?: (context: InvalidationContext) => void | Promise<void>;
+}
+/**
+ * Context passed to custom invalidation handlers
+ */
+export interface InvalidationContext {
+    /** The namespace of the mutation (e.g., 'users') */
+    namespace: string;
+    /** The mutation procedure name (e.g., 'createUser') */
+    procedureName: string;
+    /** The input passed to the mutation */
+    input: unknown;
+    /** The mutation result/output */
+    data: unknown;
+    /** QueryClient for manual operations */
+    queryClient: QueryClient;
+    /** Helper to invalidate a specific query in the same namespace */
+    invalidate: (procedureName: string, input?: unknown) => Promise<void>;
+}
+/**
+ * Extended mutation options with auto-invalidation support
+ *
+ * Extends React Query's UseMutationOptions with VeloxTS-specific features.
+ *
+ * @template TOutput - The mutation output type
+ * @template TInput - The mutation input type
+ * @template TContext - The mutation context type (for optimistic updates)
+ */
+export interface VeloxMutationOptions<TOutput, TInput, TContext = unknown> extends Omit<UseMutationOptions<TOutput, Error, TInput, TContext>, 'mutationFn'> {
+    /**
+     * Configure automatic cache invalidation
+     *
+     * - `true` (default): Enable convention-based invalidation
+     * - `false`: Disable auto-invalidation entirely
+     * - `AutoInvalidationConfig`: Customize invalidation behavior
+     *
+     * @default true
+     */
+    autoInvalidate?: boolean | AutoInvalidationConfig;
+}
+/**
+ * Resolves a procedure to its appropriate hook interface
+ * based on whether it's a query or mutation
+ *
+ * @internal
+ */
+type VeloxProcedureHooks<TProcedure> = TProcedure extends ClientProcedure<infer TInput, infer TOutput> ? ExtractProcedureType<TProcedure> extends 'query' ? VeloxQueryProcedure<TInput, TOutput> : ExtractProcedureType<TProcedure> extends 'mutation' ? VeloxMutationProcedure<TInput, TOutput> : never : never;
+/**
+ * Maps a procedures record to hook interfaces
+ *
+ * Each procedure becomes a VeloxQueryProcedure or VeloxMutationProcedure
+ * based on its type.
+ *
+ * @template TProcedures - The procedures record type
+ */
+export type VeloxNamespace<TProcedures extends ProcedureRecord> = {
+    [K in keyof TProcedures]: VeloxProcedureHooks<TProcedures[K]>;
+};
+/**
+ * Maps router namespaces to their namespace hook interfaces
+ *
+ * This is the top-level type returned by `createVeloxHooks`.
+ *
+ * @template TRouter - The router type (collection of procedure collections)
+ *
+ * @example
+ * ```typescript
+ * type AppRouter = {
+ *   users: typeof userProcedures;
+ *   posts: typeof postProcedures;
+ * };
+ *
+ * const api: VeloxHooks<AppRouter> = createVeloxHooks<AppRouter>();
+ * // api.users.getUser is VeloxQueryProcedure<{id: string}, User>
+ * // api.users.createUser is VeloxMutationProcedure<CreateUserInput, User>
+ * ```
+ */
+export type VeloxHooks<TRouter> = {
+    [K in keyof TRouter]: TRouter[K] extends ProcedureCollection<infer TProcedures> ? VeloxNamespace<TProcedures> : never;
+};
+/**
+ * Configuration for createVeloxHooks
+ */
+export interface VeloxHooksConfig<TRouter = unknown> {
+    /**
+     * Optional: provide client directly instead of using context
+     *
+     * This is useful for:
+     * - Server-side rendering (SSR) where context isn't available
+     * - Testing scenarios
+     * - Using hooks outside VeloxProvider
+     *
+     * @example
+     * ```typescript
+     * // For SSR
+     * const client = createClient<AppRouter>({ baseUrl: '/api' });
+     * const api = createVeloxHooks<AppRouter>({ client });
+     * ```
+     */
+    client?: ClientFromRouter<TRouter>;
+}
+/**
+ * Generic client type for internal use
+ * @internal
+ */
+export type GenericClient = Record<string, Record<string, (input: unknown) => Promise<unknown>>>;
+/**
+ * Function to get client instance
+ * Can either use context (returns undefined if not in component) or direct client
+ * @internal
+ */
+export type ClientGetter<TRouter> = () => ClientFromRouter<TRouter>;
+export {};
+//# sourceMappingURL=proxy-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-types.d.ts","sourceRoot":"","sources":["../../src/react/proxy-types.ts"],"names":[],"mappings":"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"}

package/dist/react/proxy-types.js

@@ -0,0 +1,10 @@
+/**
+ * Type definitions for tRPC-style proxy hooks
+ *
+ * Provides type utilities for the new `createVeloxHooks` API that enables
+ * full IDE autocomplete through a proxy-based hook system.
+ *
+ * @module @veloxts/client/react/proxy-types
+ */
+export {};
+//# sourceMappingURL=proxy-types.js.map

package/dist/react/proxy-types.js.map

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

package/dist/types.d.ts

@@ -182,6 +182,49 @@ export interface ClientConfig {
      * Called when a request fails or returns an error response
      */
     onError?: (error: ClientError) => void | Promise<void>;
+    /**
+     * Unauthorized handler for automatic token refresh
+     *
+     * Called when a request receives a 401 Unauthorized response.
+     * Return `true` to retry the request with fresh headers.
+     * Return `false` to propagate the original error.
+     *
+     * The headers function is called fresh for the retry, so update your
+     * token storage before returning `true`.
+     *
+     * @example
+     * ```typescript
+     * const client = createClient<AppRouter>({
+     *   baseUrl: '/api',
+     *   headers: () => {
+     *     const token = localStorage.getItem('token');
+     *     return token ? { Authorization: `Bearer ${token}` } : {};
+     *   },
+     *   onUnauthorized: async () => {
+     *     const refreshToken = localStorage.getItem('refreshToken');
+     *     if (!refreshToken) return false;
+     *
+     *     const res = await fetch('/api/auth/refresh', {
+     *       method: 'POST',
+     *       headers: { 'Content-Type': 'application/json' },
+     *       body: JSON.stringify({ refreshToken }),
+     *     });
+     *
+     *     if (!res.ok) {
+     *       localStorage.removeItem('token');
+     *       localStorage.removeItem('refreshToken');
+     *       return false;
+     *     }
+     *
+     *     const data = await res.json();
+     *     localStorage.setItem('token', data.accessToken);
+     *     localStorage.setItem('refreshToken', data.refreshToken);
+     *     return true; // Retry the original request
+     *   },
+     * });
+     * ```
+     */
+    onUnauthorized?: () => boolean | Promise<boolean>;
     /**
      * Optional custom fetch implementation
      * Defaults to global fetch

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/client",
-  "version": "0.4.8",
+  "version": "0.4.10",
   "description": "Type-safe frontend API client for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",