@pasosdejesus/m 0.15.0

package/dist/test-utils/radix-mocks.js

@@ -0,0 +1,175 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Radix UI mocks for testing
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import React from 'react';
+import { vi } from 'vitest';
+// Mock ResizeObserver globally
+if (typeof global !== 'undefined' && !global.ResizeObserver) {
+    global.ResizeObserver = vi.fn().mockImplementation(() => ({
+        observe: vi.fn(),
+        unobserve: vi.fn(),
+        disconnect: vi.fn(),
+    }));
+}
+/**
+ * Mock for @radix-ui/react-portal
+ * Renders children directly instead of in a portal
+ */
+export const portalMock = {
+    Portal: ({ children }) => children,
+    Root: ({ children }) => children,
+};
+/**
+ * Mock for @radix-ui/react-menubar
+ * Provides simplified components that render without complex context
+ */
+export const menubarMock = {
+    Root: React.forwardRef(function Root({ className, ...props }, ref) {
+        return React.createElement('div', { ref, 'data-testid': 'menubar-root', className, ...props });
+    }),
+    Menu: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "menubar-menu", className: className, ...props }))),
+    Trigger: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "menubar-trigger", className: className, ...props, children: props.children }))),
+    Content: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "menubar-content", className: className, ...props }))),
+    Item: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "menubar-item", className: className, ...props, children: props.children }))),
+    Separator: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "menubar-separator", className: className, ...props }))),
+    Label: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "menubar-label", className: className, ...props, children: props.children }))),
+    CheckboxItem: React.forwardRef(({ className, checked, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "menubar-checkbox-item", "data-checked": checked, className: className, ...props, children: props.children }))),
+    RadioGroup: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "menubar-radio-group", className: className, ...props }))),
+    RadioItem: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "menubar-radio-item", className: className, ...props, children: props.children }))),
+    Group: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "menubar-group", className: className, ...props }))),
+    ItemIndicator: React.forwardRef(({ className, ...props }, ref) => (_jsx("span", { ref: ref, "data-testid": "menubar-item-indicator", className: className, ...props }))),
+    Sub: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "menubar-sub", className: className, ...props }))),
+    SubTrigger: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "menubar-sub-trigger", className: className, ...props, children: props.children }))),
+    SubContent: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "menubar-sub-content", className: className, ...props }))),
+    Shortcut: ({ className, ...props }) => (_jsx("span", { "data-testid": "menubar-shortcut", className: className, ...props })),
+    Portal: portalMock.Portal,
+};
+/**
+ * Mock for @radix-ui/react-popover
+ */
+export const popoverMock = {
+    Root: React.forwardRef(({ className, defaultOpen = false, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "popover-root", "data-state": defaultOpen ? 'open' : 'closed', className: className, ...props }))),
+    Trigger: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "popover-trigger", className: className, ...props, children: props.children }))),
+    Content: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "popover-content", className: className, ...props }))),
+    Portal: portalMock.Portal,
+};
+/**
+ * Mock for @radix-ui/react-dropdown-menu
+ */
+export const dropdownMenuMock = {
+    Root: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dropdown-menu-root", className: className, ...props }))),
+    Trigger: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "dropdown-menu-trigger", className: className, ...props, children: props.children }))),
+    Content: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dropdown-menu-content", className: className, ...props }))),
+    Item: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "dropdown-menu-item", className: className, ...props, children: props.children }))),
+    Separator: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dropdown-menu-separator", className: className, ...props }))),
+    Label: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dropdown-menu-label", className: className, ...props, children: props.children }))),
+    CheckboxItem: React.forwardRef(({ className, checked, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "dropdown-menu-checkbox-item", "data-checked": checked, className: className, ...props, children: props.children }))),
+    RadioGroup: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dropdown-menu-radio-group", className: className, ...props }))),
+    RadioItem: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "dropdown-menu-radio-item", className: className, ...props, children: props.children }))),
+    Sub: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dropdown-menu-sub", className: className, ...props }))),
+    SubTrigger: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "dropdown-menu-sub-trigger", className: className, ...props, children: props.children }))),
+    SubContent: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dropdown-menu-sub-content", className: className, ...props }))),
+    Shortcut: ({ className, ...props }) => (_jsx("span", { "data-testid": "dropdown-menu-shortcut", className: className, ...props })),
+};
+/**
+ * Mock for @radix-ui/react-dialog (used by sheet, alert-dialog)
+ */
+export const dialogMock = {
+    Root: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dialog-root", className: className, ...props }))),
+    Trigger: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "dialog-trigger", className: className, ...props, children: props.children }))),
+    Content: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dialog-content", className: className, ...props }))),
+    Overlay: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dialog-overlay", className: className, ...props }))),
+    Title: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dialog-title", className: className, ...props, children: props.children }))),
+    Description: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "dialog-description", className: className, ...props, children: props.children }))),
+    Close: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "dialog-close", className: className, ...props, children: props.children }))),
+};
+/**
+ * Mock for @radix-ui/react-toast
+ */
+export const toastMock = {
+    Provider: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "toast-provider", className: className, ...props }))),
+    Root: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "toast-root", className: className, ...props }))),
+    Title: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "toast-title", className: className, ...props, children: props.children }))),
+    Description: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "toast-description", className: className, ...props, children: props.children }))),
+    Action: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "toast-action", className: className, ...props, children: props.children }))),
+    Close: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "toast-close", className: className, ...props, children: props.children }))),
+    Viewport: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "toast-viewport", className: className, ...props }))),
+};
+/**
+ * Mock for @radix-ui/react-tooltip
+ */
+export const tooltipMock = {
+    Provider: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "tooltip-provider", className: className, ...props }))),
+    Root: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "tooltip-root", className: className, ...props }))),
+    Trigger: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "tooltip-trigger", className: className, ...props, children: props.children }))),
+    Content: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "tooltip-content", className: className, ...props }))),
+    Arrow: ({ className, ...props }) => (_jsx("div", { "data-testid": "tooltip-arrow", className: className, ...props })),
+};
+/**
+ * Common Radix UI component mocks
+ */
+export const commonRadixMocks = {
+    Slot: ({ children, ...props }) => React.cloneElement(React.Children.only(children), props),
+    Label: React.forwardRef(({ className, ...props }, ref) => (_jsx("label", { ref: ref, "data-testid": "radix-label", className: className, ...props }))),
+    Separator: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "radix-separator", className: className, ...props }))),
+};
+export const scrollAreaMock = {
+    Root: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-root", className: className, ...props }))),
+    Viewport: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-viewport", className: className, ...props }))),
+    Scrollbar: React.forwardRef(({ className, orientation = 'vertical', ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-scrollbar", "data-orientation": orientation, className: className, ...props }))),
+    Thumb: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-thumb", className: className, ...props }))),
+    ScrollAreaScrollbar: React.forwardRef(({ className, orientation = 'vertical', ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-scrollbar", "data-orientation": orientation, className: className, ...props }))),
+    Corner: ({ className, ...props }) => (_jsx("div", { "data-testid": "scroll-area-corner", className: className, ...props })),
+    ScrollAreaThumb: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-thumb", className: className, ...props }))),
+    ScrollAreaViewport: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-viewport", className: className, ...props }))),
+    ScrollAreaCorner: ({ className, ...props }) => (_jsx("div", { "data-testid": "scroll-area-corner", className: className, ...props })),
+    ScrollAreaRoot: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-root", className: className, ...props }))),
+};
+export const tabsMock = {
+    Root: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "tabs-root", className: className, ...props }))),
+    List: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "tabs-list", className: className, ...props }))),
+    Trigger: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "tabs-trigger", className: className, ...props, children: props.children }))),
+    Content: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "tabs-content", className: className, ...props }))),
+};
+// Radix UI mocks configuration
+export function setupRadixMocks() {
+    console.warn('setupRadixMocks called');
+    vi.mock('@radix-ui/react-portal', () => portalMock);
+    vi.mock('@radix-ui/react-menubar', () => menubarMock);
+    vi.mock('@radix-ui/react-popover', () => popoverMock);
+    vi.mock('@radix-ui/react-dropdown-menu', () => dropdownMenuMock);
+    vi.mock('@radix-ui/react-dialog', () => dialogMock);
+    vi.mock('@radix-ui/react-toast', () => toastMock);
+    vi.mock('@radix-ui/react-tooltip', () => tooltipMock);
+    vi.mock('@radix-ui/react-slot', () => ({ Slot: commonRadixMocks.Slot }));
+    vi.mock('@radix-ui/react-label', () => ({ Root: commonRadixMocks.Label }));
+    vi.mock('@radix-ui/react-separator', () => ({ Root: commonRadixMocks.Separator }));
+    // Additional common Radix UI packages
+    vi.mock('@radix-ui/react-accordion', () => ({
+        Root: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "accordion-root", className: className, ...props }))),
+        Item: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "accordion-item", className: className, ...props }))),
+        Trigger: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "accordion-trigger", className: className, ...props, children: props.children }))),
+        Content: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "accordion-content", className: className, ...props }))),
+    }));
+    vi.mock('@radix-ui/react-scroll-area', () => ({
+        Root: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-root", className: className, ...props }))),
+        Viewport: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-viewport", className: className, ...props }))),
+        Scrollbar: React.forwardRef(({ className, orientation = 'vertical', ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-scrollbar", "data-orientation": orientation, className: className, ...props }))),
+        Thumb: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-thumb", className: className, ...props }))),
+        ScrollAreaScrollbar: React.forwardRef(({ className, orientation = 'vertical', ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-scrollbar", "data-orientation": orientation, className: className, ...props }))),
+        Corner: ({ className, ...props }) => (_jsx("div", { "data-testid": "scroll-area-corner", className: className, ...props })),
+        ScrollAreaThumb: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-thumb", className: className, ...props }))),
+        ScrollAreaViewport: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-viewport", className: className, ...props }))),
+        ScrollAreaCorner: ({ className, ...props }) => (_jsx("div", { "data-testid": "scroll-area-corner", className: className, ...props })),
+        ScrollAreaRoot: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "scroll-area-root", className: className, ...props }))),
+    }));
+    vi.mock('@radix-ui/react-tabs', () => ({
+        Root: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "tabs-root", className: className, ...props }))),
+        List: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "tabs-list", className: className, ...props }))),
+        Trigger: React.forwardRef(({ className, ...props }, ref) => (_jsx("button", { ref: ref, "data-testid": "tabs-trigger", className: className, ...props, children: props.children }))),
+        Content: React.forwardRef(({ className, ...props }, ref) => (_jsx("div", { ref: ref, "data-testid": "tabs-content", className: className, ...props }))),
+    }));
+}

package/dist/test-utils/rainbowkit-mocks.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Authentication mocking utilities for tests
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+/**
+ * Mock configurations for authentication
+ */
+export interface AuthMockConfig {
+    address?: string;
+    isConnected?: boolean;
+    sessionData?: any;
+    csrfToken?: string;
+    siweVerificationSuccess?: boolean;
+    /** Chain ID for wallet connection (default: 1) */
+    chainId?: number;
+    /** Whether to mock axios module (default: true) */
+    mockAxios?: boolean;
+    /** Axios mock configuration - can provide custom mock implementations */
+    axiosMock?: {
+        get?: (...args: any[]) => any;
+        post?: (...args: any[]) => any;
+        put?: (...args: any[]) => any;
+        delete?: (...args: any[]) => any;
+        [key: string]: any;
+    };
+    /** Whether to mock wagmi module (default: true) */
+    mockWagmi?: boolean;
+    /** Whether to mock siwe module (default: true) */
+    mockSiwe?: boolean;
+    /** Whether to mock next-auth/react module (default: true) */
+    mockNextAuth?: boolean;
+}
+/**
+ * Creates authentication mocks with configurable behavior
+ *
+ * @param config Configuration for mock behavior
+ * @returns Object containing mocked authentication functions and setup helpers
+ */
+export declare function createAuthMocks(config?: AuthMockConfig): {
+    mocks: {
+        mockSiweMessage: import("vitest").Mock<(...args: any[]) => any>;
+        mockGetCsrfToken: import("vitest").Mock<(...args: any[]) => any>;
+        mockUseSession: import("vitest").Mock<(...args: any[]) => any>;
+        mockUseAccount: import("vitest").Mock<(...args: any[]) => any>;
+        mockAxiosGet: import("vitest").Mock<(...args: any[]) => any>;
+        mockAxiosPost: import("vitest").Mock<(...args: any[]) => any>;
+        mockAxiosPut: import("vitest").Mock<(...args: any[]) => any>;
+        mockAxiosDelete: import("vitest").Mock<(...args: any[]) => any>;
+        mockAxiosRequest: import("vitest").Mock<(...args: any[]) => any>;
+    };
+    setupMocks: () => void;
+    setupDefaultImplementations: () => void;
+    resetMocks: () => void;
+    updateConfig: (newConfig: Partial<AuthMockConfig>) => void;
+};
+/**
+ * Pre-configured authentication mocks for API route tests
+ */
+export declare const apiAuthMocks: {
+    mocks: {
+        mockSiweMessage: import("vitest").Mock<(...args: any[]) => any>;
+        mockGetCsrfToken: import("vitest").Mock<(...args: any[]) => any>;
+        mockUseSession: import("vitest").Mock<(...args: any[]) => any>;
+        mockUseAccount: import("vitest").Mock<(...args: any[]) => any>;
+        mockAxiosGet: import("vitest").Mock<(...args: any[]) => any>;
+        mockAxiosPost: import("vitest").Mock<(...args: any[]) => any>;
+        mockAxiosPut: import("vitest").Mock<(...args: any[]) => any>;
+        mockAxiosDelete: import("vitest").Mock<(...args: any[]) => any>;
+        mockAxiosRequest: import("vitest").Mock<(...args: any[]) => any>;
+    };
+    setupMocks: () => void;
+    setupDefaultImplementations: () => void;
+    resetMocks: () => void;
+    updateConfig: (newConfig: Partial<AuthMockConfig>) => void;
+};
+/**
+ * Pre-configured authentication mocks for hook tests
+ */
+//# sourceMappingURL=rainbowkit-mocks.d.ts.map

package/dist/test-utils/rainbowkit-mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rainbowkit-mocks.d.ts","sourceRoot":"","sources":["../../src/test-utils/rainbowkit-mocks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,GAAG,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,yEAAyE;IACzE,SAAS,CAAC,EAAE;QACV,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;QAC7B,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;QAC9B,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;QAC7B,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;QAChC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KACnB,CAAA;IACD,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,cAAmB;;;;;;;;;;;;;;;8BAmLxB,OAAO,CAAC,cAAc,CAAC;EA4EzD;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;8BAjFU,OAAO,CAAC,cAAc,CAAC;CAiFb,CAAA;AAE7C;;GAEG"}

package/dist/test-utils/rainbowkit-mocks.js

@@ -0,0 +1,247 @@
+/**
+ * Authentication mocking utilities for tests
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import { vi } from 'vitest';
+/**
+ * Creates authentication mocks with configurable behavior
+ *
+ * @param config Configuration for mock behavior
+ * @returns Object containing mocked authentication functions and setup helpers
+ */
+export function createAuthMocks(config = {}) {
+    const { address = '0x1234567890123456789012345678901234567890', isConnected = true, sessionData = { user: { name: 'Test User' } }, csrfToken = 'mock-csrf-token', siweVerificationSuccess = true, chainId = 1, mockAxios = true, axiosMock = {}, mockWagmi = true, mockSiwe = true, mockNextAuth = true, } = config;
+    // Capture axiosMock for use in hoisted functions
+    const capturedAxiosMock = axiosMock;
+    // Hoisted mocks to avoid initialization issues
+    const mocks = vi.hoisted(() => {
+        const mockSiweMessage = vi.fn();
+        const mockGetCsrfToken = vi.fn();
+        const mockUseSession = vi.fn();
+        const mockUseAccount = vi.fn();
+        const mockAxiosGet = vi.fn();
+        const mockAxiosPost = vi.fn();
+        const mockAxiosPut = vi.fn();
+        const mockAxiosDelete = vi.fn();
+        const mockAxiosRequest = vi.fn();
+        return {
+            mockSiweMessage,
+            mockGetCsrfToken,
+            mockUseSession,
+            mockUseAccount,
+            mockAxiosGet,
+            mockAxiosPost,
+            mockAxiosPut,
+            mockAxiosDelete,
+            mockAxiosRequest,
+        };
+    });
+    /**
+     * Setup vi.mock calls for authentication modules
+     * Call this in your test file's setup
+     */
+    function setupMocks() {
+        // Mock siwe (Sign-In With Ethereum) if enabled
+        if (mockSiwe) {
+            vi.mock('siwe', () => ({
+                SiweMessage: mocks.mockSiweMessage,
+            }));
+        }
+        // Mock next-auth/react if enabled
+        if (mockNextAuth) {
+            vi.mock('next-auth/react', () => ({
+                useSession: () => mocks.mockUseSession(),
+                getCsrfToken: () => mocks.mockGetCsrfToken(),
+            }));
+        }
+        // Mock wagmi if enabled
+        if (mockWagmi) {
+            vi.mock('wagmi', async () => {
+                const actual = await vi.importActual('wagmi');
+                return {
+                    ...actual,
+                    useConfig: () => ({}),
+                    useAccount: () => mocks.mockUseAccount(),
+                };
+            });
+        }
+        // Mock axios for API calls if enabled
+        if (mockAxios) {
+            vi.mock('axios', () => ({
+                default: {
+                    get: (...args) => mocks.mockAxiosGet(...args),
+                    post: (...args) => mocks.mockAxiosPost(...args),
+                    put: (...args) => mocks.mockAxiosPut(...args),
+                    delete: (...args) => mocks.mockAxiosDelete(...args),
+                    request: (...args) => mocks.mockAxiosRequest(...args),
+                },
+            }));
+        }
+    }
+    /**
+     * Set up default mock implementations based on config
+     */
+    function setupDefaultImplementations() {
+        // SiweMessage mock
+        mocks.mockSiweMessage.mockImplementation(() => ({
+            address,
+            verify: vi.fn().mockResolvedValue({
+                success: siweVerificationSuccess,
+                data: { nonce: 'mock-nonce', chainId },
+            }),
+        }));
+        // NextAuth mocks
+        mocks.mockUseSession.mockReturnValue({
+            data: {
+                ...sessionData,
+                address,
+            },
+            status: 'authenticated',
+            expires: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
+        });
+        mocks.mockGetCsrfToken.mockResolvedValue(csrfToken);
+        // Wagmi mock
+        mocks.mockUseAccount.mockReturnValue({
+            address,
+            isConnected,
+            chainId,
+        });
+        // Axios mocks - default success responses for all methods
+        // Only set defaults if custom implementation not provided
+        if (!capturedAxiosMock.get) {
+            mocks.mockAxiosGet.mockResolvedValue({
+                data: {},
+                status: 200,
+            });
+        }
+        else {
+            mocks.mockAxiosGet.mockImplementation(capturedAxiosMock.get);
+        }
+        if (!capturedAxiosMock.post) {
+            mocks.mockAxiosPost.mockResolvedValue({
+                data: {},
+                status: 200,
+            });
+        }
+        else {
+            mocks.mockAxiosPost.mockImplementation(capturedAxiosMock.post);
+        }
+        if (!capturedAxiosMock.put) {
+            mocks.mockAxiosPut.mockResolvedValue({
+                data: {},
+                status: 200,
+            });
+        }
+        else {
+            mocks.mockAxiosPut.mockImplementation(capturedAxiosMock.put);
+        }
+        if (!capturedAxiosMock.delete) {
+            mocks.mockAxiosDelete.mockResolvedValue({
+                data: {},
+                status: 200,
+            });
+        }
+        else {
+            mocks.mockAxiosDelete.mockImplementation(capturedAxiosMock.delete);
+        }
+        if (!capturedAxiosMock.request) {
+            mocks.mockAxiosRequest.mockResolvedValue({
+                data: {},
+                status: 200,
+            });
+        }
+        else {
+            mocks.mockAxiosRequest.mockImplementation(capturedAxiosMock.request);
+        }
+    }
+    /**
+     * Reset all mock implementations
+     */
+    function resetMocks() {
+        Object.values(mocks).forEach(mock => {
+            if (typeof mock.mockReset === 'function') {
+                mock.mockReset();
+            }
+        });
+    }
+    /**
+     * Update mock configurations dynamically
+     */
+    function updateConfig(newConfig) {
+        if (newConfig.address !== undefined) {
+            mocks.mockUseAccount.mockReturnValue({
+                address: newConfig.address,
+                isConnected: newConfig.isConnected ?? isConnected,
+                chainId: newConfig.chainId ?? chainId,
+            });
+            mocks.mockUseSession.mockReturnValue({
+                data: {
+                    ...sessionData,
+                    address: newConfig.address,
+                },
+                status: 'authenticated',
+                expires: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
+            });
+        }
+        if (newConfig.isConnected !== undefined) {
+            mocks.mockUseAccount.mockReturnValue({
+                address,
+                isConnected: newConfig.isConnected,
+                chainId: newConfig.chainId ?? chainId,
+            });
+        }
+        if (newConfig.sessionData !== undefined) {
+            mocks.mockUseSession.mockReturnValue({
+                data: {
+                    ...newConfig.sessionData,
+                    address,
+                },
+                status: 'authenticated',
+                expires: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
+            });
+        }
+        if (newConfig.csrfToken !== undefined) {
+            mocks.mockGetCsrfToken.mockResolvedValue(newConfig.csrfToken);
+        }
+        if (newConfig.chainId !== undefined) {
+            // Update chainId in account mock
+            mocks.mockUseAccount.mockReturnValue({
+                address,
+                isConnected,
+                chainId: newConfig.chainId,
+            });
+            // Update chainId in SIWE mock
+            mocks.mockSiweMessage.mockImplementation(() => ({
+                address,
+                verify: vi.fn().mockResolvedValue({
+                    success: siweVerificationSuccess,
+                    data: { nonce: 'mock-nonce', chainId: newConfig.chainId },
+                }),
+            }));
+        }
+        if (newConfig.siweVerificationSuccess !== undefined) {
+            mocks.mockSiweMessage.mockImplementation(() => ({
+                address,
+                verify: vi.fn().mockResolvedValue({
+                    success: newConfig.siweVerificationSuccess,
+                    data: { nonce: 'mock-nonce', chainId: newConfig.chainId ?? chainId },
+                }),
+            }));
+        }
+    }
+    return {
+        mocks,
+        setupMocks,
+        setupDefaultImplementations,
+        resetMocks,
+        updateConfig,
+    };
+}
+/**
+ * Pre-configured authentication mocks for API route tests
+ */
+export const apiAuthMocks = createAuthMocks();
+/**
+ * Pre-configured authentication mocks for hook tests
+ */

package/dist/test-utils/viem-mocks.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Viem mocking utilities for tests
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+declare const viemMocks: {
+    createPublicClient: import("vitest").Mock<() => {
+        getTransactionReceipt: import("vitest").Mock<(...args: any[]) => any>;
+        getBlock: import("vitest").Mock<(...args: any[]) => any>;
+    }>;
+    createWalletClient: import("vitest").Mock<() => {
+        sendTransaction: import("vitest").Mock<(...args: any[]) => any>;
+    }>;
+    getContract: import("vitest").Mock<() => {
+        address: string;
+        read: {
+            vaults: import("vitest").Mock<(...args: any[]) => any>;
+            studentCanSubmit: import("vitest").Mock<(...args: any[]) => any>;
+            getStudentGuideStatus: import("vitest").Mock<(...args: any[]) => any>;
+        };
+        write: {
+            submitGuideResult: import("vitest").Mock<(...args: any[]) => any>;
+        };
+    }>;
+    encodeFunctionData: import("vitest").Mock<() => string>;
+    decodeFunctionData: import("vitest").Mock<() => {
+        functionName: string;
+        args: never[];
+    }>;
+    parseUnits: import("vitest").Mock<(value: string) => bigint>;
+    http: import("vitest").Mock<() => {}>;
+    privateKeyToAccount: import("vitest").Mock<() => {
+        address: string;
+    }>;
+    formatUnits: import("vitest").Mock<(value: any, decimals: any) => string>;
+    Address: any;
+    Hex: any;
+};
+declare const viemChainsMocks: {
+    celo: {
+        id: number;
+        name: string;
+    };
+    celoSepolia: {
+        id: number;
+        name: string;
+    };
+};
+export { viemMocks, viemChainsMocks };
+/**
+ * Mock for viem module
+ */
+export declare function mockViem(): {
+    createPublicClient: import("vitest").Mock<() => {
+        getTransactionReceipt: import("vitest").Mock<(...args: any[]) => any>;
+        getBlock: import("vitest").Mock<(...args: any[]) => any>;
+    }>;
+    createWalletClient: import("vitest").Mock<() => {
+        sendTransaction: import("vitest").Mock<(...args: any[]) => any>;
+    }>;
+    getContract: import("vitest").Mock<() => {
+        address: string;
+        read: {
+            vaults: import("vitest").Mock<(...args: any[]) => any>;
+            studentCanSubmit: import("vitest").Mock<(...args: any[]) => any>;
+            getStudentGuideStatus: import("vitest").Mock<(...args: any[]) => any>;
+        };
+        write: {
+            submitGuideResult: import("vitest").Mock<(...args: any[]) => any>;
+        };
+    }>;
+    encodeFunctionData: import("vitest").Mock<() => string>;
+    decodeFunctionData: import("vitest").Mock<() => {
+        functionName: string;
+        args: never[];
+    }>;
+    parseUnits: import("vitest").Mock<(value: string) => bigint>;
+    http: import("vitest").Mock<() => {}>;
+    privateKeyToAccount: import("vitest").Mock<() => {
+        address: string;
+    }>;
+    formatUnits: import("vitest").Mock<(value: any, decimals: any) => string>;
+    Address: any;
+    Hex: any;
+};
+//# sourceMappingURL=viem-mocks.d.ts.map

package/dist/test-utils/viem-mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem-mocks.d.ts","sourceRoot":"","sources":["../../src/test-utils/viem-mocks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;8CAqBa,MAAM;;;;;+CAKL,GAAG,YAAY,GAAG;aAM5B,GAAG;SACP,GAAG;CACf,CAAA;AAEH,QAAA,MAAM,eAAe;;;;;;;;;CAGlB,CAAA;AAEH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAA;AAErC;;GAEG;AACH,wBAAgB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;8CAzBI,MAAM;;;;;+CAKL,GAAG,YAAY,GAAG;aAM5B,GAAG;SACP,GAAG;EAejB"}

package/dist/test-utils/viem-mocks.js

@@ -0,0 +1,54 @@
+/**
+ * Viem mocking utilities for tests
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import { vi } from 'vitest';
+// Mock objects defined with vi.hoisted for proper hoisting
+const viemMocks = vi.hoisted(() => ({
+    createPublicClient: vi.fn(() => ({
+        getTransactionReceipt: vi.fn().mockResolvedValue({ status: 'success', blockNumber: 12345n }),
+        getBlock: vi.fn().mockResolvedValue({ number: 12347n }),
+    })),
+    createWalletClient: vi.fn(() => ({
+        sendTransaction: vi.fn().mockResolvedValue('0xmocktxhash'),
+    })),
+    getContract: vi.fn(() => ({
+        address: '0xmockContractAddress',
+        read: {
+            vaults: vi.fn().mockResolvedValue([0n, 0n, 0n, 0n, 0n, 1n]),
+            studentCanSubmit: vi.fn().mockResolvedValue(true),
+            getStudentGuideStatus: vi.fn().mockResolvedValue([0n, true]),
+        },
+        write: {
+            submitGuideResult: vi.fn().mockResolvedValue('0xmocktxhash'),
+        },
+    })),
+    encodeFunctionData: vi.fn(() => '0xmockEncodedData'),
+    decodeFunctionData: vi.fn(() => ({ functionName: 'deposit', args: [] })),
+    parseUnits: vi.fn((value) => BigInt(value)),
+    http: vi.fn(() => ({})),
+    privateKeyToAccount: vi.fn(() => ({
+        address: '0xmockAccount',
+    })),
+    formatUnits: vi.fn((value, decimals) => {
+        const str = value.toString();
+        const intLen = str.length;
+        if (intLen <= decimals)
+            return '0.' + '0'.repeat(decimals - intLen) + str;
+        return str.slice(0, intLen - decimals) + '.' + str.slice(intLen - decimals);
+    }),
+    Address: '0x',
+    Hex: '0x',
+}));
+const viemChainsMocks = vi.hoisted(() => ({
+    celo: { id: 42220, name: 'Celo' },
+    celoSepolia: { id: 44787, name: 'Celo Sepolia' },
+}));
+export { viemMocks, viemChainsMocks };
+/**
+ * Mock for viem module
+ */
+export function mockViem() {
+    return viemMocks;
+}