@veloxts/client 0.4.2 → 0.4.4

package/dist/react/__tests__/hooks.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for React hooks (useQuery, useMutation, useQueryClient)
+ */
+export {};
+//# sourceMappingURL=hooks.test.d.ts.map

package/dist/react/__tests__/hooks.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.test.d.ts","sourceRoot":"","sources":["../../../src/react/__tests__/hooks.test.tsx"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/react/__tests__/hooks.test.js

@@ -0,0 +1,230 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Unit tests for React hooks (useQuery, useMutation, useQueryClient)
+ */
+import { QueryClient } from '@tanstack/react-query';
+import { act, renderHook, waitFor } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { useMutation, useQuery, useQueryClient } from '../hooks.js';
+import { VeloxProvider } from '../provider.js';
+// Mock client
+const mockGetUser = vi.fn();
+const mockListUsers = vi.fn();
+const mockCreateUser = vi.fn();
+const mockUpdateUser = vi.fn();
+const mockClient = {
+    users: {
+        getUser: mockGetUser,
+        listUsers: mockListUsers,
+        createUser: mockCreateUser,
+        updateUser: mockUpdateUser,
+    },
+};
+// Mock createClient to return our mock client
+vi.mock('../../client.js', () => ({
+    createClient: vi.fn(() => mockClient),
+}));
+// Wrapper component for hooks
+function createWrapper() {
+    const queryClient = new QueryClient({
+        defaultOptions: {
+            queries: { retry: false },
+            mutations: { retry: false },
+        },
+    });
+    function Wrapper({ children }) {
+        return (_jsx(VeloxProvider, { config: { baseUrl: '/api' }, queryClient: queryClient, children: children }));
+    }
+    return { Wrapper, queryClient };
+}
+// ============================================================================
+// useQuery Tests
+// ============================================================================
+describe('useQuery', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it('fetches data successfully', async () => {
+        const mockUser = { id: '123', name: 'Test User', email: 'test@example.com' };
+        mockGetUser.mockResolvedValueOnce(mockUser);
+        const { Wrapper } = createWrapper();
+        const { result } = renderHook(() => useQuery('users', 'getUser', { id: '123' }), { wrapper: Wrapper });
+        // Initially loading
+        expect(result.current.isLoading).toBe(true);
+        // Wait for data
+        await waitFor(() => expect(result.current.isSuccess).toBe(true));
+        expect(result.current.data).toEqual(mockUser);
+        expect(mockGetUser).toHaveBeenCalledWith({ id: '123' });
+    });
+    it('handles errors', async () => {
+        const error = new Error('Not found');
+        mockGetUser.mockRejectedValueOnce(error);
+        const { Wrapper } = createWrapper();
+        const { result } = renderHook(() => useQuery('users', 'getUser', { id: 'invalid' }), { wrapper: Wrapper });
+        await waitFor(() => expect(result.current.isError).toBe(true));
+        expect(result.current.error).toBeDefined();
+        expect(result.current.error?.message).toBe('Not found');
+    });
+    it('respects enabled option', async () => {
+        const { Wrapper } = createWrapper();
+        const { result } = renderHook(() => useQuery('users', 'getUser', { id: '123' }, { enabled: false }), { wrapper: Wrapper });
+        // Should not be loading when disabled
+        expect(result.current.isLoading).toBe(false);
+        expect(result.current.fetchStatus).toBe('idle');
+        expect(mockGetUser).not.toHaveBeenCalled();
+    });
+    it('refetches on input change', async () => {
+        const user1 = { id: '1', name: 'User 1', email: 'user1@example.com' };
+        const user2 = { id: '2', name: 'User 2', email: 'user2@example.com' };
+        mockGetUser.mockResolvedValueOnce(user1).mockResolvedValueOnce(user2);
+        const { Wrapper } = createWrapper();
+        const { result, rerender } = renderHook(({ id }) => useQuery('users', 'getUser', { id }), { wrapper: Wrapper, initialProps: { id: '1' } });
+        await waitFor(() => expect(result.current.data).toEqual(user1));
+        // Change input
+        rerender({ id: '2' });
+        await waitFor(() => expect(result.current.data).toEqual(user2));
+        expect(mockGetUser).toHaveBeenCalledTimes(2);
+    });
+});
+// ============================================================================
+// useMutation Tests
+// ============================================================================
+describe('useMutation', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it('executes mutation successfully', async () => {
+        const newUser = { id: 'new-id', name: 'New User', email: 'new@example.com' };
+        mockCreateUser.mockResolvedValueOnce(newUser);
+        const { Wrapper } = createWrapper();
+        const { result } = renderHook(() => useMutation('users', 'createUser'), { wrapper: Wrapper });
+        expect(result.current.isPending).toBe(false);
+        // Execute mutation
+        act(() => {
+            result.current.mutate({ name: 'New User', email: 'new@example.com' });
+        });
+        await waitFor(() => expect(result.current.isSuccess).toBe(true));
+        expect(result.current.data).toEqual(newUser);
+        expect(mockCreateUser).toHaveBeenCalledWith({ name: 'New User', email: 'new@example.com' });
+    });
+    it('handles mutation errors', async () => {
+        const error = new Error('Validation failed');
+        mockCreateUser.mockRejectedValueOnce(error);
+        const { Wrapper } = createWrapper();
+        const { result } = renderHook(() => useMutation('users', 'createUser'), { wrapper: Wrapper });
+        act(() => {
+            result.current.mutate({ name: '', email: 'invalid' });
+        });
+        await waitFor(() => expect(result.current.isError).toBe(true));
+        expect(result.current.error?.message).toBe('Validation failed');
+    });
+    it('calls onSuccess callback', async () => {
+        const newUser = { id: 'new-id', name: 'New User', email: 'new@example.com' };
+        mockCreateUser.mockResolvedValueOnce(newUser);
+        const onSuccess = vi.fn();
+        const { Wrapper } = createWrapper();
+        const { result } = renderHook(() => useMutation('users', 'createUser', { onSuccess }), { wrapper: Wrapper });
+        act(() => {
+            result.current.mutate({ name: 'New User', email: 'new@example.com' });
+        });
+        await waitFor(() => expect(result.current.isSuccess).toBe(true));
+        expect(onSuccess).toHaveBeenCalledWith(newUser, { name: 'New User', email: 'new@example.com' }, undefined);
+    });
+    it('calls onError callback', async () => {
+        const error = new Error('Server error');
+        mockCreateUser.mockRejectedValueOnce(error);
+        const onError = vi.fn();
+        const { Wrapper } = createWrapper();
+        const { result } = renderHook(() => useMutation('users', 'createUser', { onError }), { wrapper: Wrapper });
+        act(() => {
+            result.current.mutate({ name: 'Test', email: 'test@example.com' });
+        });
+        await waitFor(() => expect(result.current.isError).toBe(true));
+        expect(onError).toHaveBeenCalled();
+    });
+    it('supports mutateAsync for promise-based usage', async () => {
+        const newUser = { id: 'new-id', name: 'New User', email: 'new@example.com' };
+        mockCreateUser.mockResolvedValueOnce(newUser);
+        const { Wrapper } = createWrapper();
+        const { result } = renderHook(() => useMutation('users', 'createUser'), { wrapper: Wrapper });
+        let returnedUser;
+        await act(async () => {
+            returnedUser = await result.current.mutateAsync({
+                name: 'New User',
+                email: 'new@example.com',
+            });
+        });
+        expect(returnedUser).toEqual(newUser);
+    });
+});
+// ============================================================================
+// useQueryClient Tests
+// ============================================================================
+describe('useQueryClient', () => {
+    it('returns the QueryClient instance', () => {
+        const { Wrapper, queryClient: expectedClient } = createWrapper();
+        const { result } = renderHook(() => useQueryClient(), { wrapper: Wrapper });
+        expect(result.current).toBe(expectedClient);
+    });
+    it('allows manual cache manipulation', async () => {
+        const { Wrapper, queryClient } = createWrapper();
+        const { result } = renderHook(() => useQueryClient(), { wrapper: Wrapper });
+        // Set data manually
+        act(() => {
+            result.current.setQueryData(['users', 'getUser', { id: '123' }], {
+                id: '123',
+                name: 'Cached User',
+                email: 'cached@example.com',
+            });
+        });
+        const cachedData = queryClient.getQueryData(['users', 'getUser', { id: '123' }]);
+        expect(cachedData).toEqual({
+            id: '123',
+            name: 'Cached User',
+            email: 'cached@example.com',
+        });
+    });
+});
+// ============================================================================
+// Integration Tests
+// ============================================================================
+describe('hooks integration', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('mutation onSuccess callback receives correct data', async () => {
+        const newUser = { id: '2', name: 'User 2', email: 'user2@example.com' };
+        mockCreateUser.mockResolvedValueOnce(newUser);
+        const { Wrapper } = createWrapper();
+        const onSuccessData = [];
+        const { result } = renderHook(() => useMutation('users', 'createUser', {
+            onSuccess: (data) => {
+                onSuccessData.push(data);
+            },
+        }), { wrapper: Wrapper });
+        // Execute mutation
+        act(() => {
+            result.current.mutate({ name: 'User 2', email: 'user2@example.com' });
+        });
+        await waitFor(() => expect(result.current.isSuccess).toBe(true));
+        // onSuccess should have received the created user
+        expect(onSuccessData).toHaveLength(1);
+        expect(onSuccessData[0]).toEqual(newUser);
+    });
+    it('useQueryClient returns a working query client instance', async () => {
+        const { Wrapper } = createWrapper();
+        const { result } = renderHook(() => useQueryClient(), { wrapper: Wrapper });
+        // Should be a QueryClient instance
+        expect(result.current).toBeDefined();
+        expect(typeof result.current.invalidateQueries).toBe('function');
+        expect(typeof result.current.setQueryData).toBe('function');
+        expect(typeof result.current.getQueryData).toBe('function');
+    });
+});
+//# sourceMappingURL=hooks.test.js.map

package/dist/react/__tests__/hooks.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.test.js","sourceRoot":"","sources":["../../../src/react/__tests__/hooks.test.tsx"],"names":[],"mappings":";AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAsB/C,cAAc;AACd,MAAM,WAAW,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC5B,MAAM,aAAa,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC9B,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC/B,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAE/B,MAAM,UAAU,GAAG;IACjB,KAAK,EAAE;QACL,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,aAAa;QACxB,UAAU,EAAE,cAAc;QAC1B,UAAU,EAAE,cAAc;KAC3B;CACF,CAAC;AAEF,8CAA8C;AAC9C,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;IAChC,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC;CACtC,CAAC,CAAC,CAAC;AAqBJ,8BAA8B;AAC9B,SAAS,aAAa;IACpB,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;QAClC,cAAc,EAAE;YACd,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;YACzB,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;SAC5B;KACF,CAAC,CAAC;IAEH,SAAS,OAAO,CAAC,EAAE,QAAQ,EAA2B;QACpD,OAAO,CACL,KAAC,aAAa,IAAa,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,YAC7E,QAAQ,GACK,CACjB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,QAAQ,GAAa,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;QACvF,WAAW,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAE5C,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;QAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAC3B,GAAG,EAAE,CAAC,QAAQ,CAAiC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EACjF,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;QAEF,oBAAoB;QACpB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5C,gBAAgB;QAChB,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QACrC,WAAW,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAEzC,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;QAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAC3B,GAAG,EAAE,CAAC,QAAQ,CAAiC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EACrF,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;QAEF,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;QAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAC3B,GAAG,EAAE,CACH,QAAQ,CACN,OAAO,EACP,SAAS,EACT,EAAE,EAAE,EAAE,KAAK,EAAE,EACb,EAAE,OAAO,EAAE,KAAK,EAAE,CACnB,EACH,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;QAEF,sCAAsC;QACtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,KAAK,GAAa,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAChF,MAAM,KAAK,GAAa,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAEhF,WAAW,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAEtE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;QAEpC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CACrC,CAAC,EAAE,EAAE,EAAkB,EAAE,EAAE,CACzB,QAAQ,CAAiC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,EACtE,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,CAChD,CAAC;QAEF,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAEhE,eAAe;QACf,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAEtB,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAEhE,MAAM,CAAC,WAAW,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,OAAO,GAAa,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;QACvF,cAAc,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAE9C,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;QAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAC3B,GAAG,EAAE,CAAC,WAAW,CAAoC,OAAO,EAAE,YAAY,CAAC,EAC3E,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE7C,mBAAmB;QACnB,GAAG,CAAC,GAAG,EAAE;YACP,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,cAAc,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC7C,cAAc,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAE5C,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;QAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAC3B,GAAG,EAAE,CAAC,WAAW,CAAoC,OAAO,EAAE,YAAY,CAAC,EAC3E,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;QAEF,GAAG,CAAC,GAAG,EAAE;YACP,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE/D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,OAAO,GAAa,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;QACvF,cAAc,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAE9C,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;QAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAC3B,GAAG,EAAE,CAAC,WAAW,CAAoC,OAAO,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,CAAC,EAC1F,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;QAEF,GAAG,CAAC,GAAG,EAAE;YACP,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjE,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,CACpC,OAAO,EACP,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAC9C,SAAS,CACV,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QACxC,cAAc,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACxB,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;QAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAC3B,GAAG,EAAE,CAAC,WAAW,CAAoC,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,EACxF,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;QAEF,GAAG,CAAC,GAAG,EAAE;YACP,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE/D,MAAM,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,OAAO,GAAa,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;QACvF,cAAc,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAE9C,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;QAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAC3B,GAAG,EAAE,CAAC,WAAW,CAAoC,OAAO,EAAE,YAAY,CAAC,EAC3E,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;QAEF,IAAI,YAAkC,CAAC;QACvC,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE;YACnB,YAAY,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;gBAC9C,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,iBAAiB;aACzB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE,CAAC;QAEjE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAE5E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE,CAAC;QAEjD,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAE5E,oBAAoB;QACpB,GAAG,CAAC,GAAG,EAAE;YACP,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;gBAC/D,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,oBAAoB;aAC5B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACjF,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC;YACzB,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,oBAAoB;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,OAAO,GAAa,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAClF,cAAc,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAE9C,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;QACpC,MAAM,aAAa,GAAe,EAAE,CAAC;QAErC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAC3B,GAAG,EAAE,CACH,WAAW,CAAoC,OAAO,EAAE,YAAY,EAAE;YACpE,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;gBAClB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;SACF,CAAC,EACJ,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;QAEF,mBAAmB;QACnB,GAAG,CAAC,GAAG,EAAE;YACP,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjE,kDAAkD;QAClD,MAAM,CAAC,aAAa,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;QAEpC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAE5E,mCAAmC;QACnC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjE,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/react/__tests__/provider.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for VeloxProvider component
+ */
+export {};
+//# sourceMappingURL=provider.test.d.ts.map

package/dist/react/__tests__/provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.test.d.ts","sourceRoot":"","sources":["../../../src/react/__tests__/provider.test.tsx"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/react/__tests__/provider.test.js

@@ -0,0 +1,77 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Unit tests for VeloxProvider component
+ */
+import { QueryClient } from '@tanstack/react-query';
+import { render, screen } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { useVeloxContext, VeloxProvider } from '../provider.js';
+// ============================================================================
+// Test Setup
+// ============================================================================
+// Mock the createClient function
+vi.mock('../../client.js', () => ({
+    createClient: vi.fn((config) => ({
+        _config: config,
+        users: {
+            getUser: vi.fn().mockResolvedValue({ id: '123', name: 'Test User' }),
+        },
+    })),
+}));
+// Test consumer component that uses the context
+function TestConsumer() {
+    const { client } = useVeloxContext();
+    return _jsx("div", { "data-testid": "has-client", children: client ? 'Client available' : 'No client' });
+}
+// ============================================================================
+// VeloxProvider Tests
+// ============================================================================
+describe('VeloxProvider', () => {
+    let queryClient;
+    beforeEach(() => {
+        queryClient = new QueryClient({
+            defaultOptions: {
+                queries: { retry: false },
+            },
+        });
+    });
+    afterEach(() => {
+        queryClient.clear();
+    });
+    it('renders children', () => {
+        render(_jsx(VeloxProvider, { config: { baseUrl: '/api' }, queryClient: queryClient, children: _jsx("div", { "data-testid": "child", children: "Hello" }) }));
+        expect(screen.getByTestId('child')).toHaveTextContent('Hello');
+    });
+    it('provides client context to children', () => {
+        render(_jsx(VeloxProvider, { config: { baseUrl: '/api' }, queryClient: queryClient, children: _jsx(TestConsumer, {}) }));
+        expect(screen.getByTestId('has-client')).toHaveTextContent('Client available');
+    });
+    it('accepts custom QueryClient', () => {
+        const customQueryClient = new QueryClient();
+        render(_jsx(VeloxProvider, { config: { baseUrl: '/api' }, queryClient: customQueryClient, children: _jsx(TestConsumer, {}) }));
+        expect(screen.getByTestId('has-client')).toHaveTextContent('Client available');
+    });
+    it('creates default QueryClient when not provided', () => {
+        render(_jsx(VeloxProvider, { config: { baseUrl: '/api' }, children: _jsx(TestConsumer, {}) }));
+        expect(screen.getByTestId('has-client')).toHaveTextContent('Client available');
+    });
+});
+// ============================================================================
+// useVeloxContext Tests
+// ============================================================================
+describe('useVeloxContext', () => {
+    it('throws when used outside VeloxProvider', () => {
+        // Suppress console.error for this test
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        expect(() => {
+            render(_jsx(TestConsumer, {}));
+        }).toThrow('useVeloxContext must be used within a VeloxProvider');
+        consoleSpy.mockRestore();
+    });
+    it('returns context with client when inside VeloxProvider', () => {
+        const queryClient = new QueryClient();
+        render(_jsx(VeloxProvider, { config: { baseUrl: '/api' }, queryClient: queryClient, children: _jsx(TestConsumer, {}) }));
+        expect(screen.getByTestId('has-client')).toHaveTextContent('Client available');
+    });
+});
+//# sourceMappingURL=provider.test.js.map

package/dist/react/__tests__/provider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.test.js","sourceRoot":"","sources":["../../../src/react/__tests__/provider.test.tsx"],"names":[],"mappings":"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"}

package/dist/react/hooks.d.ts

@@ -0,0 +1,182 @@
+/**
+ * React hooks for VeloxTS API calls
+ *
+ * Provides type-safe hooks for queries and mutations
+ * with full integration with React Query.
+ *
+ * @module @veloxts/client/react/hooks
+ */
+import { type QueryClient, type UseMutationResult, type UseQueryResult } from '@tanstack/react-query';
+import type { InferProcedureInput, InferProcedureOutput } from '../types.js';
+import type { GetProcedure, GetProceduresFromCollection, VeloxUseMutationOptions, VeloxUseQueryOptions } from './types.js';
+/**
+ * Type-safe query hook for VeloxTS procedures
+ *
+ * Wraps React Query's useQuery with automatic type inference from
+ * your backend procedure definitions. The hook automatically:
+ * - Builds a stable query key from namespace, procedure, and input
+ * - Provides full type safety for input and output
+ * - Integrates with React Query's caching and refetching
+ *
+ * @template TRouter - The router type (typeof imported procedures)
+ * @template TNamespace - The namespace key (e.g., 'users', 'posts')
+ * @template TProcedureName - The procedure name (e.g., 'getUser', 'listUsers')
+ *
+ * @param namespace - Resource namespace (e.g., 'users')
+ * @param procedureName - Procedure name (e.g., 'getUser')
+ * @param input - Input matching the procedure's input schema
+ * @param options - React Query options (optional)
+ *
+ * @returns UseQueryResult with typed data and error
+ *
+ * @example Basic usage
+ * ```tsx
+ * function UserProfile({ userId }: { userId: string }) {
+ *   const { data: user, isLoading, error } = useQuery(
+ *     'users',
+ *     'getUser',
+ *     { id: userId }
+ *   );
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *   if (!user) return <div>User not found</div>;
+ *
+ *   return <div>{user.name}</div>;
+ * }
+ * ```
+ *
+ * @example With options
+ * ```tsx
+ * const { data } = useQuery(
+ *   'users',
+ *   'listUsers',
+ *   { page: 1, limit: 10 },
+ *   {
+ *     staleTime: 60_000,
+ *     refetchOnWindowFocus: true,
+ *   }
+ * );
+ * ```
+ *
+ * @example Conditional query
+ * ```tsx
+ * const { data } = useQuery(
+ *   'users',
+ *   'getUser',
+ *   { id: userId },
+ *   { enabled: !!userId }
+ * );
+ * ```
+ */
+export declare function useQuery<TRouter, TNamespace extends keyof TRouter, TProcedureName extends keyof GetProceduresFromCollection<TRouter[TNamespace]>>(namespace: TNamespace, procedureName: TProcedureName, input: InferProcedureInput<GetProcedure<TRouter, TNamespace, TProcedureName>>, options?: VeloxUseQueryOptions<InferProcedureOutput<GetProcedure<TRouter, TNamespace, TProcedureName>>>): UseQueryResult<InferProcedureOutput<GetProcedure<TRouter, TNamespace, TProcedureName>>, Error>;
+/**
+ * Type-safe mutation hook for VeloxTS procedures
+ *
+ * Wraps React Query's useMutation with automatic type inference from
+ * your backend procedure definitions. The hook provides:
+ * - Full type safety for input and output
+ * - Access to mutation lifecycle callbacks (onSuccess, onError, etc.)
+ * - Optimistic update support via context
+ *
+ * @template TRouter - The router type
+ * @template TNamespace - The namespace key
+ * @template TProcedureName - The procedure name (should be a mutation)
+ *
+ * @param namespace - Resource namespace (e.g., 'users')
+ * @param procedureName - Procedure name (e.g., 'createUser')
+ * @param options - React Query mutation options (optional)
+ *
+ * @returns UseMutationResult with typed variables, data, and error
+ *
+ * @example Basic usage
+ * ```tsx
+ * function CreateUserForm() {
+ *   const { mutate: createUser, isPending, error } = useMutation(
+ *     'users',
+ *     'createUser'
+ *   );
+ *
+ *   const handleSubmit = (e: FormEvent) => {
+ *     e.preventDefault();
+ *     createUser({ name: 'Alice', email: 'alice@example.com' });
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <button type="submit" disabled={isPending}>
+ *         {isPending ? 'Creating...' : 'Create User'}
+ *       </button>
+ *       {error && <div>{error.message}</div>}
+ *     </form>
+ *   );
+ * }
+ * ```
+ *
+ * @example With cache invalidation
+ * ```tsx
+ * const queryClient = useQueryClient();
+ *
+ * const { mutate } = useMutation('users', 'createUser', {
+ *   onSuccess: () => {
+ *     queryClient.invalidateQueries({ queryKey: ['users', 'listUsers'] });
+ *   },
+ * });
+ * ```
+ *
+ * @example With optimistic update
+ * ```tsx
+ * const { mutate } = useMutation('users', 'updateUser', {
+ *   onMutate: async (newUser) => {
+ *     await queryClient.cancelQueries({ queryKey: ['users', 'getUser', { id: newUser.id }] });
+ *     const previousUser = queryClient.getQueryData(['users', 'getUser', { id: newUser.id }]);
+ *     queryClient.setQueryData(['users', 'getUser', { id: newUser.id }], newUser);
+ *     return { previousUser };
+ *   },
+ *   onError: (err, newUser, context) => {
+ *     if (context?.previousUser) {
+ *       queryClient.setQueryData(['users', 'getUser', { id: newUser.id }], context.previousUser);
+ *     }
+ *   },
+ * });
+ * ```
+ */
+export declare function useMutation<TRouter, TNamespace extends keyof TRouter, TProcedureName extends keyof GetProceduresFromCollection<TRouter[TNamespace]>, TContext = unknown>(namespace: TNamespace, procedureName: TProcedureName, options?: VeloxUseMutationOptions<InferProcedureOutput<GetProcedure<TRouter, TNamespace, TProcedureName>>, InferProcedureInput<GetProcedure<TRouter, TNamespace, TProcedureName>>, Error, TContext>): UseMutationResult<InferProcedureOutput<GetProcedure<TRouter, TNamespace, TProcedureName>>, Error, InferProcedureInput<GetProcedure<TRouter, TNamespace, TProcedureName>>, TContext>;
+/**
+ * Hook to access React Query's QueryClient for manual cache operations
+ *
+ * This is a direct re-export of React Query's useQueryClient for convenience.
+ * Use this for manual cache invalidation, prefetching, or optimistic updates.
+ *
+ * @returns The QueryClient instance
+ *
+ * @example Cache invalidation
+ * ```tsx
+ * function MyComponent() {
+ *   const queryClient = useQueryClient();
+ *   const { mutate } = useMutation('users', 'createUser', {
+ *     onSuccess: () => {
+ *       // Invalidate and refetch users list
+ *       queryClient.invalidateQueries({ queryKey: ['users', 'listUsers'] });
+ *     },
+ *   });
+ * }
+ * ```
+ *
+ * @example Prefetching
+ * ```tsx
+ * function UserListItem({ userId }: { userId: string }) {
+ *   const queryClient = useQueryClient();
+ *
+ *   const handleMouseEnter = () => {
+ *     // Prefetch user data on hover
+ *     queryClient.prefetchQuery({
+ *       queryKey: ['users', 'getUser', { id: userId }],
+ *       queryFn: () => api.users.getUser({ id: userId }),
+ *     });
+ *   };
+ * }
+ * ```
+ */
+export declare function useQueryClient(): QueryClient;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/react/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAIpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,KAAK,EACV,YAAY,EACZ,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAOpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EACP,UAAU,SAAS,MAAM,OAAO,EAChC,cAAc,SAAS,MAAM,2BAA2B,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAE7E,SAAS,EAAE,UAAU,EACrB,aAAa,EAAE,cAAc,EAC7B,KAAK,EAAE,mBAAmB,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,EAC7E,OAAO,CAAC,EAAE,oBAAoB,CAC5B,oBAAoB,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CACxE,GACA,cAAc,CAAC,oBAAoB,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,CA2BhG;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EACP,UAAU,SAAS,MAAM,OAAO,EAChC,cAAc,SAAS,MAAM,2BAA2B,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAC7E,QAAQ,GAAG,OAAO,EAElB,SAAS,EAAE,UAAU,EACrB,aAAa,EAAE,cAAc,EAC7B,OAAO,CAAC,EAAE,uBAAuB,CAC/B,oBAAoB,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,EACvE,mBAAmB,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,EACtE,KAAK,EACL,QAAQ,CACT,GACA,iBAAiB,CAClB,oBAAoB,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,EACvE,KAAK,EACL,mBAAmB,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,EACtE,QAAQ,CACT,CAwBA;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAE5C"}