wexts 4.0.0 → 4.1.0

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/index.ts","../src/core/config.ts","../src/core/process-manager.ts","../src/core/errors.ts","../src/config/index.ts","../src/config/loader.ts","../src/insight/index.ts","../src/insight/server.ts","../src/create-fusion/index.ts","../src/create-fusion/scaffold.ts","../src/next/index.ts","../src/next/provider.tsx","../src/next/useAuth.ts"],"sourcesContent":["// Core exports placeholder\nexport * from './config';\nexport * from './logger';\nexport * from './filesystem';\nexport * from './process-manager';\nexport * from './errors';\n","import * as fs from 'fs';\nimport * as path from 'path';\n\nexport interface FusionConfig {\n    [key: string]: any;\n}\n\nexport class ConfigLoader {\n    private config: Map<string, any> = new Map();\n    private configDir: string;\n\n    constructor(configDir: string = process.cwd()) {\n        this.configDir = configDir;\n    }\n\n    /**\n     * Load configuration from file or environment\n     */\n    load(key: string, defaultValue?: any): any {\n        if (this.config.has(key)) {\n            return this.config.get(key);\n        }\n\n        // Try to load from environment variable\n        const envKey = `FUSION_${key.toUpperCase()}`;\n        if (process.env[envKey]) {\n            const value = this.parseEnvValue(process.env[envKey]!);\n            this.config.set(key, value);\n            return value;\n        }\n\n        // Try to load from config file\n        const configPath = path.join(this.configDir, 'fusion.config.json');\n        if (fs.existsSync(configPath)) {\n            try {\n                const fileConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));\n                if (fileConfig[key] !== undefined) {\n                    this.config.set(key, fileConfig[key]);\n                    return fileConfig[key];\n                }\n            } catch (error) {\n                // Silently fail and use default\n            }\n        }\n\n        return defaultValue;\n    }\n\n    /**\n     * Set configuration value\n     */\n    set(key: string, value: any): void {\n        this.config.set(key, value);\n    }\n\n    /**\n     * Get all configuration\n     */\n    getAll(): FusionConfig {\n        return Object.fromEntries(this.config);\n    }\n\n    /**\n     * Parse environment value (handles JSON strings)\n     */\n    private parseEnvValue(value: string): any {\n        try {\n            return JSON.parse(value);\n        } catch {\n            return value;\n        }\n    }\n}\n\n// Export singleton instance\nexport const config = new ConfigLoader();\n\n// Helper function for backward compatibility\nexport function load(key: string, defaultValue?: any): any {\n    return config.load(key, defaultValue);\n}\n","export class ProcessManager {\n    /**\n     * Setup process error handlers\n     */\n    static initialize(): void {\n        process.on('uncaughtException', (error) => {\n            console.error('[Fusion] Uncaught Exception:', error);\n            process.exit(1);\n        });\n\n        process.on('unhandledRejection', (reason, promise) => {\n            console.error('[Fusion] Unhandled Rejection at:', promise, 'reason:', reason);\n        });\n\n        process.on('SIGTERM', () => {\n            console.log('[Fusion] SIGTERM received, shutting down gracefully');\n            process.exit(0);\n        });\n\n        process.on('SIGINT', () => {\n            console.log('[Fusion] SIGINT received, shutting down gracefully');\n            process.exit(0);\n        });\n    }\n\n    /**\n     * Graceful shutdown helper\n     */\n    static async shutdown(cleanup: () => Promise<void>): Promise<void> {\n        try {\n            await cleanup();\n            process.exit(0);\n        } catch (error) {\n            console.error('[Fusion] Error during shutdown:', error);\n            process.exit(1);\n        }\n    }\n}\n","export class FusionError extends Error {\n    constructor(message: string, public code?: string) {\n        super(message);\n        this.name = 'FusionError';\n    }\n}\n\nexport class ConfigError extends FusionError {\n    constructor(message: string) {\n        super(message, 'CONFIG_ERROR');\n        this.name = 'ConfigError';\n    }\n}\n\nexport class ValidationError extends FusionError {\n    constructor(message: string) {\n        super(message, 'VALIDATION_ERROR');\n        this.name = 'ValidationError';\n    }\n}\n\nexport class APIError extends FusionError {\n    constructor(message: string, public statusCode?: number) {\n        super(message, 'API_ERROR');\n        this.name = 'APIError';\n    }\n}\n","// Config exports placeholder\nexport * from './loader';\n","export const loader = {\n    load: () => ({}),\n};\n","// Insight exports placeholder\nexport * from './server';\n","export const server = {\n    start: () => console.log('Insight server started'),\n};\n","export * from './scaffold';\n","import { mkdir, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { logger } from '../core/logger';\n\nexport interface ScaffoldOptions {\n    projectName: string;\n    template: 'monorepo' | 'api' | 'web';\n    packageManager?: 'npm' | 'pnpm' | 'yarn';\n}\n\n/**\n * @deprecated Use the `wexts create` CLI and `examples/hello-rpc` canonical scaffold instead.\n */\nexport class ProjectScaffolder {\n    async scaffold(options: ScaffoldOptions): Promise<void> {\n        const { projectName, template } = options;\n        const projectPath = join(process.cwd(), projectName);\n\n        logger.info(`Creating project at: ${projectPath}`);\n\n        // Create base directory\n        await mkdir(projectPath, { recursive: true });\n\n        if (template === 'monorepo') {\n            await this.createMonorepo(projectPath, projectName);\n        } else if (template === 'api') {\n            await this.createNestJSApp(projectPath, projectName);\n        } else if (template === 'web') {\n            await this.createNextJSApp(projectPath, projectName);\n        }\n\n        logger.success(`Project ${projectName} created successfully!`);\n        logger.info(`\\nNext steps:`);\n        logger.info(`  cd ${projectName}`);\n        logger.info(`  wexts dev`);\n    }\n\n    private async createMonorepo(projectPath: string, projectName: string): Promise<void> {\n        // Create directory structure\n        await mkdir(join(projectPath, 'apps', 'api'), { recursive: true });\n        await mkdir(join(projectPath, 'apps', 'web'), { recursive: true });\n        await mkdir(join(projectPath, 'packages', 'types'), { recursive: true });\n        await mkdir(join(projectPath, 'packages', 'api-client'), { recursive: true });\n\n        // Create root package.json\n        const packageJson = {\n            name: projectName,\n            version: '0.0.1',\n            private: true,\n            workspaces: ['apps/*', 'packages/*'],\n            scripts: {\n                dev: 'wexts dev',\n                build: 'wexts build',\n            },\n            devDependencies: {\n                'wexts': '^3.0.3',\n            },\n        };\n\n        await writeFile(\n            join(projectPath, 'package.json'),\n            JSON.stringify(packageJson, null, 2)\n        );\n\n        // Create README\n        const readme = `# ${projectName}\\n\\nCreated with the deprecated ProjectScaffolder compatibility API.\\n\\nUse examples/hello-rpc as the canonical Wexts reference.\\n\\n## Getting Started\\n\\n\\`\\`\\`bash\\nwexts dev\\n\\`\\`\\`\\n`;\n        await writeFile(join(projectPath, 'README.md'), readme);\n    }\n\n    private async createNestJSApp(projectPath: string, projectName: string): Promise<void> {\n        await writeFile(\n            join(projectPath, 'README.md'),\n            `# ${projectName}\\n\\nStandalone API scaffolding through ProjectScaffolder is deprecated. Use examples/hello-rpc or wexts create for the canonical path.\\n`\n        );\n    }\n\n    private async createNextJSApp(projectPath: string, projectName: string): Promise<void> {\n        await writeFile(\n            join(projectPath, 'README.md'),\n            `# ${projectName}\\n\\nStandalone web scaffolding through ProjectScaffolder is deprecated. Use examples/hello-rpc or wexts create for the canonical path.\\n`\n        );\n    }\n}\n","export * from './provider';\nexport * from './useAuth';\n","'use client';\n\nimport React, { createContext, useContext, ReactNode } from 'react';\nimport { createWextsRpcClient, FusionFetcher, WextsRpcClient } from '../client/fetcher';\n\ninterface FusionContextType {\n    client: FusionFetcher;\n    wexts: WextsRpcClient;\n}\n\nconst FusionContext = createContext<FusionContextType | null>(null);\n\nexport interface FusionProviderProps {\n    children: ReactNode;\n    baseUrl?: string;\n    rpcBaseUrl?: string;\n    rpcClient?: object;\n}\n\n/**\n * FusionProvider - Provides API client to React components\n * Usage:\n * ```tsx\n * <FusionProvider baseUrl=\"/api\">\n *   <App />\n * </FusionProvider>\n * ```\n */\nexport function FusionProvider({ children, baseUrl = '/api', rpcBaseUrl = '/rpc', rpcClient }: FusionProviderProps) {\n    const client = React.useMemo(() => new FusionFetcher(baseUrl), [baseUrl]);\n    const wexts = React.useMemo(\n        () => (rpcClient as WextsRpcClient | undefined) ?? createWextsRpcClient(undefined, { baseUrl: rpcBaseUrl }),\n        [rpcBaseUrl, rpcClient]\n    );\n\n    return (\n        <FusionContext.Provider value={{ client, wexts }}>\n            {children}\n        </FusionContext.Provider>\n    );\n}\n\n/**\n * useFusion hook - Access API client in components\n * Usage:\n * ```tsx\n * const { client } = useFusion();\n * const data = await client.get('/users');\n * ```\n */\nexport function useFusion(): FusionContextType {\n    const context = useContext(FusionContext);\n    if (!context) {\n        throw new Error('useFusion must be used within FusionProvider');\n    }\n    return context;\n}\n\nexport function useWexts<TClient = WextsRpcClient>(): TClient {\n    const context = useFusion();\n    return context.wexts as TClient;\n}\n","'use client';\n\nimport { useState, useEffect } from 'react';\nimport { useFusion } from './provider';\n\nexport interface AuthUser {\n    id: string;\n    email: string;\n    name?: string;\n}\n\nexport interface UseAuthReturn {\n    user: AuthUser | null;\n    loading: boolean;\n    login: (email: string, password: string) => Promise<void>;\n    logout: () => Promise<void>;\n    isAuthenticated: boolean;\n}\n\n/**\n * useAuth hook - Authentication state management\n * Usage:\n * ```tsx\n * const { user, login, logout, isAuthenticated } = useAuth();\n * ```\n */\nexport function useAuth(): UseAuthReturn {\n    const { client } = useFusion();\n    const [user, setUser] = useState<AuthUser | null>(null);\n    const [loading, setLoading] = useState(true);\n\n    useEffect(() => {\n        // Check for existing session\n        const token = localStorage.getItem('fusion_token');\n        if (token) {\n            // Validate token and load user\n            loadUser();\n        } else {\n            setLoading(false);\n        }\n    }, []);\n\n    const loadUser = async () => {\n        try {\n            const userData = await client.get<AuthUser>('/auth/me');\n            setUser(userData);\n        } catch (error) {\n            localStorage.removeItem('fusion_token');\n        } finally {\n            setLoading(false);\n        }\n    };\n\n    const login = async (email: string, password: string) => {\n        const response = await client.post<{ token: string; user: AuthUser }>('/auth/login', {\n            email,\n            password,\n        });\n        localStorage.setItem('fusion_token', response.token);\n        setUser(response.user);\n    };\n\n    const logout = async () => {\n        localStorage.removeItem('fusion_token');\n        setUser(null);\n    };\n\n    return {\n        user,\n        loading,\n        login,\n        logout,\n        isAuthenticated: !!user,\n    };\n}\n"],"mappings":"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","names":["fs","path","ConfigLoader","config","Map","configDir","process","cwd","load","key","defaultValue","has","get","envKey","toUpperCase","env","value","parseEnvValue","set","configPath","join","existsSync","fileConfig","JSON","parse","readFileSync","undefined","error","getAll","Object","fromEntries","ProcessManager","initialize","process","on","error","console","exit","reason","promise","log","shutdown","cleanup","FusionError","Error","message","code","name","ConfigError","ValidationError","APIError","statusCode","loader","load","server","start","console","log","mkdir","writeFile","join","ProjectScaffolder","scaffold","options","projectName","template","projectPath","join","process","cwd","logger","info","mkdir","recursive","createMonorepo","createNestJSApp","createNextJSApp","success","packageJson","name","version","private","workspaces","scripts","dev","build","devDependencies","writeFile","JSON","stringify","readme","React","createContext","useContext","FusionContext","createContext","FusionProvider","children","baseUrl","rpcBaseUrl","rpcClient","client","React","useMemo","FusionFetcher","wexts","createWextsRpcClient","undefined","Provider","value","useFusion","context","useContext","Error","useWexts","useState","useEffect","useAuth","client","useFusion","user","setUser","useState","loading","setLoading","useEffect","token","localStorage","getItem","loadUser","userData","get","error","removeItem","login","email","password","response","post","setItem","logout","isAuthenticated"]}
+{"version":3,"sources":["../src/core/index.ts","../src/core/config.ts","../src/core/process-manager.ts","../src/core/errors.ts","../src/config/index.ts","../src/config/loader.ts","../src/insight/index.ts","../src/insight/server.ts","../src/create-fusion/index.ts","../src/create-fusion/scaffold.ts","../src/next/index.ts","../src/next/provider.tsx","../src/next/useAuth.ts"],"sourcesContent":["// Core exports placeholder\nexport * from './config';\nexport * from './logger';\nexport * from './filesystem';\nexport * from './process-manager';\nexport * from './errors';\n","import * as fs from 'fs';\nimport * as path from 'path';\n\nexport interface FusionConfig {\n    [key: string]: any;\n}\n\nexport class ConfigLoader {\n    private config: Map<string, any> = new Map();\n    private configDir: string;\n\n    constructor(configDir: string = process.cwd()) {\n        this.configDir = configDir;\n    }\n\n    /**\n     * Load configuration from file or environment\n     */\n    load(key: string, defaultValue?: any): any {\n        if (this.config.has(key)) {\n            return this.config.get(key);\n        }\n\n        // Try to load from environment variable\n        const envKey = `FUSION_${key.toUpperCase()}`;\n        if (process.env[envKey]) {\n            const value = this.parseEnvValue(process.env[envKey]!);\n            this.config.set(key, value);\n            return value;\n        }\n\n        // Try to load from config file\n        const configPath = path.join(this.configDir, 'fusion.config.json');\n        if (fs.existsSync(configPath)) {\n            try {\n                const fileConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));\n                if (fileConfig[key] !== undefined) {\n                    this.config.set(key, fileConfig[key]);\n                    return fileConfig[key];\n                }\n            } catch (error) {\n                // Silently fail and use default\n            }\n        }\n\n        return defaultValue;\n    }\n\n    /**\n     * Set configuration value\n     */\n    set(key: string, value: any): void {\n        this.config.set(key, value);\n    }\n\n    /**\n     * Get all configuration\n     */\n    getAll(): FusionConfig {\n        return Object.fromEntries(this.config);\n    }\n\n    /**\n     * Parse environment value (handles JSON strings)\n     */\n    private parseEnvValue(value: string): any {\n        try {\n            return JSON.parse(value);\n        } catch {\n            return value;\n        }\n    }\n}\n\n// Export singleton instance\nexport const config = new ConfigLoader();\n\n// Helper function for backward compatibility\nexport function load(key: string, defaultValue?: any): any {\n    return config.load(key, defaultValue);\n}\n","export class ProcessManager {\n    /**\n     * Setup process error handlers\n     */\n    static initialize(): void {\n        process.on('uncaughtException', (error) => {\n            console.error('[Fusion] Uncaught Exception:', error);\n            process.exit(1);\n        });\n\n        process.on('unhandledRejection', (reason, promise) => {\n            console.error('[Fusion] Unhandled Rejection at:', promise, 'reason:', reason);\n        });\n\n        process.on('SIGTERM', () => {\n            console.log('[Fusion] SIGTERM received, shutting down gracefully');\n            process.exit(0);\n        });\n\n        process.on('SIGINT', () => {\n            console.log('[Fusion] SIGINT received, shutting down gracefully');\n            process.exit(0);\n        });\n    }\n\n    /**\n     * Graceful shutdown helper\n     */\n    static async shutdown(cleanup: () => Promise<void>): Promise<void> {\n        try {\n            await cleanup();\n            process.exit(0);\n        } catch (error) {\n            console.error('[Fusion] Error during shutdown:', error);\n            process.exit(1);\n        }\n    }\n}\n","export class FusionError extends Error {\n    constructor(message: string, public code?: string) {\n        super(message);\n        this.name = 'FusionError';\n    }\n}\n\nexport class ConfigError extends FusionError {\n    constructor(message: string) {\n        super(message, 'CONFIG_ERROR');\n        this.name = 'ConfigError';\n    }\n}\n\nexport class ValidationError extends FusionError {\n    constructor(message: string) {\n        super(message, 'VALIDATION_ERROR');\n        this.name = 'ValidationError';\n    }\n}\n\nexport class APIError extends FusionError {\n    constructor(message: string, public statusCode?: number) {\n        super(message, 'API_ERROR');\n        this.name = 'APIError';\n    }\n}\n","// Config exports placeholder\nexport * from './loader';\n","export const loader = {\n    load: () => ({}),\n};\n","// Insight exports placeholder\nexport * from './server';\n","export const server = {\n    start: () => console.log('Insight server started'),\n};\n","export * from './scaffold';\n","import { mkdir, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { logger } from '../core/logger';\n\nexport interface ScaffoldOptions {\n    projectName: string;\n    template: 'monorepo' | 'api' | 'web';\n    packageManager?: 'npm' | 'pnpm' | 'yarn';\n}\n\n/**\n * @deprecated Use the `wexts create` CLI and `examples/hello-rpc` canonical scaffold instead.\n */\nexport class ProjectScaffolder {\n    async scaffold(options: ScaffoldOptions): Promise<void> {\n        const { projectName, template } = options;\n        const projectPath = join(process.cwd(), projectName);\n\n        logger.info(`Creating project at: ${projectPath}`);\n\n        // Create base directory\n        await mkdir(projectPath, { recursive: true });\n\n        if (template === 'monorepo') {\n            await this.createMonorepo(projectPath, projectName);\n        } else if (template === 'api') {\n            await this.createNestJSApp(projectPath, projectName);\n        } else if (template === 'web') {\n            await this.createNextJSApp(projectPath, projectName);\n        }\n\n        logger.success(`Project ${projectName} created successfully!`);\n        logger.info(`\\nNext steps:`);\n        logger.info(`  cd ${projectName}`);\n        logger.info(`  wexts dev`);\n    }\n\n    private async createMonorepo(projectPath: string, projectName: string): Promise<void> {\n        // Create directory structure\n        await mkdir(join(projectPath, 'apps', 'api'), { recursive: true });\n        await mkdir(join(projectPath, 'apps', 'web'), { recursive: true });\n        await mkdir(join(projectPath, 'packages', 'types'), { recursive: true });\n        await mkdir(join(projectPath, 'packages', 'api-client'), { recursive: true });\n\n        // Create root package.json\n        const packageJson = {\n            name: projectName,\n            version: '0.0.1',\n            private: true,\n            workspaces: ['apps/*', 'packages/*'],\n            scripts: {\n                dev: 'wexts dev',\n                build: 'wexts build',\n            },\n            devDependencies: {\n                'wexts': '^4.0.0',\n            },\n        };\n\n        await writeFile(\n            join(projectPath, 'package.json'),\n            JSON.stringify(packageJson, null, 2)\n        );\n\n        // Create README\n        const readme = `# ${projectName}\\n\\nCreated with the deprecated ProjectScaffolder compatibility API.\\n\\nUse examples/hello-rpc as the canonical Wexts reference.\\n\\n## Getting Started\\n\\n\\`\\`\\`bash\\nwexts dev\\n\\`\\`\\`\\n`;\n        await writeFile(join(projectPath, 'README.md'), readme);\n    }\n\n    private async createNestJSApp(projectPath: string, projectName: string): Promise<void> {\n        await writeFile(\n            join(projectPath, 'README.md'),\n            `# ${projectName}\\n\\nStandalone API scaffolding through ProjectScaffolder is deprecated. Use examples/hello-rpc or wexts create for the canonical path.\\n`\n        );\n    }\n\n    private async createNextJSApp(projectPath: string, projectName: string): Promise<void> {\n        await writeFile(\n            join(projectPath, 'README.md'),\n            `# ${projectName}\\n\\nStandalone web scaffolding through ProjectScaffolder is deprecated. Use examples/hello-rpc or wexts create for the canonical path.\\n`\n        );\n    }\n}\n","export * from './provider';\nexport * from './useAuth';\n","'use client';\n\nimport React, { createContext, useContext, ReactNode } from 'react';\nimport { createWextsRpcClient, FusionFetcher, WextsRpcClient } from '../client/fetcher';\n\ninterface FusionContextType {\n    client: FusionFetcher;\n    wexts: WextsRpcClient;\n}\n\nconst FusionContext = createContext<FusionContextType | null>(null);\n\nexport interface FusionProviderProps {\n    children: ReactNode;\n    baseUrl?: string;\n    rpcBaseUrl?: string;\n    rpcClient?: object;\n}\n\n/**\n * FusionProvider - Provides API client to React components\n * Usage:\n * ```tsx\n * <FusionProvider baseUrl=\"/api\">\n *   <App />\n * </FusionProvider>\n * ```\n */\nexport function FusionProvider({ children, baseUrl = '/api', rpcBaseUrl = '/rpc', rpcClient }: FusionProviderProps) {\n    const client = React.useMemo(() => new FusionFetcher(baseUrl), [baseUrl]);\n    const wexts = React.useMemo(\n        () => (rpcClient as WextsRpcClient | undefined) ?? createWextsRpcClient(undefined, { baseUrl: rpcBaseUrl }),\n        [rpcBaseUrl, rpcClient]\n    );\n\n    return (\n        <FusionContext.Provider value={{ client, wexts }}>\n            {children}\n        </FusionContext.Provider>\n    );\n}\n\n/**\n * useFusion hook - Access API client in components\n * Usage:\n * ```tsx\n * const { client } = useFusion();\n * const data = await client.get('/users');\n * ```\n */\nexport function useFusion(): FusionContextType {\n    const context = useContext(FusionContext);\n    if (!context) {\n        throw new Error('useFusion must be used within FusionProvider');\n    }\n    return context;\n}\n\nexport function useWexts<TClient = WextsRpcClient>(): TClient {\n    const context = useFusion();\n    return context.wexts as TClient;\n}\n","'use client';\n\nimport { useState, useEffect } from 'react';\nimport { useFusion } from './provider';\n\nexport interface AuthUser {\n    id: string;\n    email: string;\n    name?: string;\n}\n\nexport interface UseAuthReturn {\n    user: AuthUser | null;\n    loading: boolean;\n    login: (email: string, password: string) => Promise<void>;\n    logout: () => Promise<void>;\n    isAuthenticated: boolean;\n}\n\n/**\n * useAuth hook - Authentication state management\n * Usage:\n * ```tsx\n * const { user, login, logout, isAuthenticated } = useAuth();\n * ```\n */\nexport function useAuth(): UseAuthReturn {\n    const { client } = useFusion();\n    const [user, setUser] = useState<AuthUser | null>(null);\n    const [loading, setLoading] = useState(true);\n\n    useEffect(() => {\n        // Check for existing session\n        const token = localStorage.getItem('fusion_token');\n        if (token) {\n            // Validate token and load user\n            loadUser();\n        } else {\n            setLoading(false);\n        }\n    }, []);\n\n    const loadUser = async () => {\n        try {\n            const userData = await client.get<AuthUser>('/auth/me');\n            setUser(userData);\n        } catch (error) {\n            localStorage.removeItem('fusion_token');\n        } finally {\n            setLoading(false);\n        }\n    };\n\n    const login = async (email: string, password: string) => {\n        const response = await client.post<{ token: string; user: AuthUser }>('/auth/login', {\n            email,\n            password,\n        });\n        localStorage.setItem('fusion_token', response.token);\n        setUser(response.user);\n    };\n\n    const logout = async () => {\n        localStorage.removeItem('fusion_token');\n        setUser(null);\n    };\n\n    return {\n        user,\n        loading,\n        login,\n        logout,\n        isAuthenticated: !!user,\n    };\n}\n"],"mappings":"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","names":["fs","path","ConfigLoader","config","Map","configDir","process","cwd","load","key","defaultValue","has","get","envKey","toUpperCase","env","value","parseEnvValue","set","configPath","join","existsSync","fileConfig","JSON","parse","readFileSync","undefined","error","getAll","Object","fromEntries","ProcessManager","initialize","process","on","error","console","exit","reason","promise","log","shutdown","cleanup","FusionError","Error","message","code","name","ConfigError","ValidationError","APIError","statusCode","loader","load","server","start","console","log","mkdir","writeFile","join","ProjectScaffolder","scaffold","options","projectName","template","projectPath","join","process","cwd","logger","info","mkdir","recursive","createMonorepo","createNestJSApp","createNextJSApp","success","packageJson","name","version","private","workspaces","scripts","dev","build","devDependencies","writeFile","JSON","stringify","readme","React","createContext","useContext","FusionContext","createContext","FusionProvider","children","baseUrl","rpcBaseUrl","rpcClient","client","React","useMemo","FusionFetcher","wexts","createWextsRpcClient","undefined","Provider","value","useFusion","context","useContext","Error","useWexts","useState","useEffect","useAuth","client","useFusion","user","setUser","useState","loading","setLoading","useEffect","token","localStorage","getItem","loadUser","userData","get","error","removeItem","login","email","password","response","post","setItem","logout","isAuthenticated"]}

package/dist/next/index.js

@@ -42,6 +42,40 @@ module.exports = __toCommonJS(next_exports);
 // src/next/provider.tsx
 var import_react = __toESM(require("react"));
 
+// src/errors.ts
+var WextsError = class extends Error {
+  static {
+    __name(this, "WextsError");
+  }
+  code;
+  suggestedFix;
+  docsSlug;
+  constructor(options) {
+    super(options.message, options.cause === void 0 ? void 0 : {
+      cause: options.cause
+    });
+    this.name = "WextsError";
+    this.code = options.code;
+    this.suggestedFix = options.suggestedFix;
+    this.docsSlug = options.docsSlug;
+  }
+  get docsUrl() {
+    return this.docsSlug ? `https://github.com/ziadmustafa1/wexts/blob/main/docs/${this.docsSlug}.md` : void 0;
+  }
+};
+var WextsRpcError = class extends WextsError {
+  static {
+    __name(this, "WextsRpcError");
+  }
+  constructor(options) {
+    super({
+      code: options.code ?? "WEXTS_RPC_ERROR",
+      ...options
+    });
+    this.name = "WextsRpcError";
+  }
+};
+
 // src/client/fetcher.ts
 var FusionFetcher = class {
   static {
@@ -65,7 +99,12 @@ var FusionFetcher = class {
       body: body ? JSON.stringify(body) : void 0
     });
     if (!response.ok) {
-      throw new Error(`Fusion API Error: ${response.status} ${response.statusText}`);
+      throw new WextsRpcError({
+        code: "WEXTS_API_REQUEST_FAILED",
+        message: `Fusion API Error: ${response.status} ${response.statusText}`,
+        suggestedFix: "Check the API route, server logs, and authentication headers.",
+        docsSlug: "troubleshooting"
+      });
     }
     if (response.status === 204) {
       return void 0;
@@ -87,6 +126,7 @@ var FusionFetcher = class {
 };
 var apiFetcher = new FusionFetcher();
 function createWextsRpcClient(manifest, options = {}) {
+  const hasManifest = Boolean(manifest);
   const services = new Set((manifest?.services ?? []).map((service) => service.name));
   const methodMap = /* @__PURE__ */ new Map();
   for (const service of manifest?.services ?? []) {
@@ -98,7 +138,12 @@ function createWextsRpcClient(manifest, options = {}) {
       if (methodName === "then") return void 0;
       const knownMethods = methodMap.get(serviceName);
       if (knownMethods && !knownMethods.has(methodName)) {
-        throw new Error(`Wexts RPC method not found: ${serviceName}.${methodName}`);
+        throw new WextsRpcError({
+          code: "WEXTS_RPC_METHOD_NOT_FOUND",
+          message: `Wexts RPC method not found: ${serviceName}.${methodName}`,
+          suggestedFix: "Run `wexts generate` and verify the method is decorated with @RpcMethod().",
+          docsSlug: "rpc"
+        });
       }
       return (...args) => invokeRpc(serviceName, methodName, args, options);
     }
@@ -107,8 +152,21 @@ function createWextsRpcClient(manifest, options = {}) {
     get(_target, serviceName) {
       if (typeof serviceName !== "string") return void 0;
       if (serviceName === "then") return void 0;
-      if (services.size > 0 && !services.has(serviceName)) {
-        throw new Error(`Wexts RPC service not found: ${serviceName}`);
+      if (!hasManifest) {
+        throw new WextsRpcError({
+          code: "WEXTS_RPC_MANIFEST_MISSING",
+          message: "Wexts RPC manifest is missing.",
+          suggestedFix: "Run `wexts generate` and import the generated client/provider instead of creating an empty client.",
+          docsSlug: "codegen"
+        });
+      }
+      if (!services.has(serviceName)) {
+        throw new WextsRpcError({
+          code: "WEXTS_RPC_SERVICE_NOT_FOUND",
+          message: `Wexts RPC service not found: ${serviceName}`,
+          suggestedFix: "Run `wexts generate` and verify the service is decorated with @RpcService().",
+          docsSlug: "rpc"
+        });
       }
       return createServiceProxy(serviceName);
     }
@@ -130,7 +188,12 @@ async function invokeRpc(serviceName, methodName, args, options) {
     })
   });
   if (!response.ok) {
-    throw new Error(`Wexts RPC Error: ${response.status} ${response.statusText}`);
+    throw new WextsRpcError({
+      code: "WEXTS_RPC_REQUEST_FAILED",
+      message: `Wexts RPC Error: ${response.status} ${response.statusText}`,
+      suggestedFix: "Check the RPC route, service policy, and server logs.",
+      docsSlug: "troubleshooting"
+    });
   }
   const payload = await response.json();
   return payload.data;

package/dist/next/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/next/index.ts","../../src/next/provider.tsx","../../src/client/fetcher.ts","../../src/next/useAuth.ts"],"sourcesContent":["export * from './provider';\nexport * from './useAuth';\n","'use client';\n\nimport React, { createContext, useContext, ReactNode } from 'react';\nimport { createWextsRpcClient, FusionFetcher, WextsRpcClient } from '../client/fetcher';\n\ninterface FusionContextType {\n    client: FusionFetcher;\n    wexts: WextsRpcClient;\n}\n\nconst FusionContext = createContext<FusionContextType | null>(null);\n\nexport interface FusionProviderProps {\n    children: ReactNode;\n    baseUrl?: string;\n    rpcBaseUrl?: string;\n    rpcClient?: object;\n}\n\n/**\n * FusionProvider - Provides API client to React components\n * Usage:\n * ```tsx\n * <FusionProvider baseUrl=\"/api\">\n *   <App />\n * </FusionProvider>\n * ```\n */\nexport function FusionProvider({ children, baseUrl = '/api', rpcBaseUrl = '/rpc', rpcClient }: FusionProviderProps) {\n    const client = React.useMemo(() => new FusionFetcher(baseUrl), [baseUrl]);\n    const wexts = React.useMemo(\n        () => (rpcClient as WextsRpcClient | undefined) ?? createWextsRpcClient(undefined, { baseUrl: rpcBaseUrl }),\n        [rpcBaseUrl, rpcClient]\n    );\n\n    return (\n        <FusionContext.Provider value={{ client, wexts }}>\n            {children}\n        </FusionContext.Provider>\n    );\n}\n\n/**\n * useFusion hook - Access API client in components\n * Usage:\n * ```tsx\n * const { client } = useFusion();\n * const data = await client.get('/users');\n * ```\n */\nexport function useFusion(): FusionContextType {\n    const context = useContext(FusionContext);\n    if (!context) {\n        throw new Error('useFusion must be used within FusionProvider');\n    }\n    return context;\n}\n\nexport function useWexts<TClient = WextsRpcClient>(): TClient {\n    const context = useFusion();\n    return context.wexts as TClient;\n}\n","import type { RpcManifest, RpcInvocationResponse } from '../rpc/types';\n\nexport class FusionFetcher {\n    private baseUrl: string;\n\n    constructor(baseUrl: string = '/api') {\n        this.baseUrl = baseUrl;\n    }\n\n    private async request<T>(method: string, path: string, body?: any): Promise<T> {\n        const headers: Record<string, string> = {\n            'Content-Type': 'application/json',\n        };\n\n        // Automatically attach Fusion Token if present\n        if (typeof window !== 'undefined') {\n            const token = localStorage.getItem('fusion_token');\n            if (token) headers['Authorization'] = `Bearer ${token}`;\n        }\n\n    const response = await fetch(`${this.baseUrl}${path}`, {\n            method,\n            headers,\n            body: body ? JSON.stringify(body) : undefined,\n        });\n\n        if (!response.ok) {\n            throw new Error(`Fusion API Error: ${response.status} ${response.statusText}`);\n        }\n\n        if (response.status === 204) {\n            return undefined as T;\n        }\n\n        return response.json();\n    }\n\n    get<T>(path: string) { return this.request<T>('GET', path); }\n    post<T>(path: string, body: any) { return this.request<T>('POST', path, body); }\n    put<T>(path: string, body: any) { return this.request<T>('PUT', path, body); }\n    delete<T>(path: string) { return this.request<T>('DELETE', path); }\n}\n\nexport const apiFetcher = new FusionFetcher();\n\nexport interface WextsRpcClientOptions {\n    baseUrl?: string;\n    fetch?: typeof fetch;\n    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;\n}\n\nexport type WextsRpcClient = Record<string, Record<string, (...args: unknown[]) => Promise<unknown>>>;\n\nexport function createWextsRpcClient(\n    manifest: Pick<RpcManifest, 'services'> | undefined,\n    options: WextsRpcClientOptions = {}\n): WextsRpcClient {\n    const services = new Set((manifest?.services ?? []).map((service) => service.name));\n    const methodMap = new Map<string, Set<string>>();\n\n    for (const service of manifest?.services ?? []) {\n        methodMap.set(service.name, new Set(service.methods.map((method) => method.name)));\n    }\n\n    const createServiceProxy = (serviceName: string) => new Proxy({}, {\n        get(_target, methodName) {\n            if (typeof methodName !== 'string') return undefined;\n            if (methodName === 'then') return undefined;\n\n            const knownMethods = methodMap.get(serviceName);\n            if (knownMethods && !knownMethods.has(methodName)) {\n                throw new Error(`Wexts RPC method not found: ${serviceName}.${methodName}`);\n            }\n\n            return (...args: unknown[]) => invokeRpc(serviceName, methodName, args, options);\n        },\n    }) as Record<string, (...args: unknown[]) => Promise<unknown>>;\n\n    return new Proxy({}, {\n        get(_target, serviceName) {\n            if (typeof serviceName !== 'string') return undefined;\n            if (serviceName === 'then') return undefined;\n            if (services.size > 0 && !services.has(serviceName)) {\n                throw new Error(`Wexts RPC service not found: ${serviceName}`);\n            }\n\n            return createServiceProxy(serviceName);\n        },\n    }) as WextsRpcClient;\n}\n\nasync function invokeRpc(\n    serviceName: string,\n    methodName: string,\n    args: unknown[],\n    options: WextsRpcClientOptions\n): Promise<unknown> {\n    const fetchImpl = options.fetch ?? fetch;\n    const baseUrl = options.baseUrl ?? '/rpc';\n    const headers = {\n        'Content-Type': 'application/json',\n        ...(await options.getHeaders?.() ?? {}),\n    };\n    const response = await fetchImpl(`${baseUrl}/${encodeURIComponent(serviceName)}/${encodeURIComponent(methodName)}`, {\n        method: 'POST',\n        headers,\n        body: JSON.stringify({ args }),\n    });\n\n    if (!response.ok) {\n        throw new Error(`Wexts RPC Error: ${response.status} ${response.statusText}`);\n    }\n\n    const payload = await response.json() as RpcInvocationResponse;\n    return payload.data;\n}\n","'use client';\n\nimport { useState, useEffect } from 'react';\nimport { useFusion } from './provider';\n\nexport interface AuthUser {\n    id: string;\n    email: string;\n    name?: string;\n}\n\nexport interface UseAuthReturn {\n    user: AuthUser | null;\n    loading: boolean;\n    login: (email: string, password: string) => Promise<void>;\n    logout: () => Promise<void>;\n    isAuthenticated: boolean;\n}\n\n/**\n * useAuth hook - Authentication state management\n * Usage:\n * ```tsx\n * const { user, login, logout, isAuthenticated } = useAuth();\n * ```\n */\nexport function useAuth(): UseAuthReturn {\n    const { client } = useFusion();\n    const [user, setUser] = useState<AuthUser | null>(null);\n    const [loading, setLoading] = useState(true);\n\n    useEffect(() => {\n        // Check for existing session\n        const token = localStorage.getItem('fusion_token');\n        if (token) {\n            // Validate token and load user\n            loadUser();\n        } else {\n            setLoading(false);\n        }\n    }, []);\n\n    const loadUser = async () => {\n        try {\n            const userData = await client.get<AuthUser>('/auth/me');\n            setUser(userData);\n        } catch (error) {\n            localStorage.removeItem('fusion_token');\n        } finally {\n            setLoading(false);\n        }\n    };\n\n    const login = async (email: string, password: string) => {\n        const response = await client.post<{ token: string; user: AuthUser }>('/auth/login', {\n            email,\n            password,\n        });\n        localStorage.setItem('fusion_token', response.token);\n        setUser(response.user);\n    };\n\n    const logout = async () => {\n        localStorage.removeItem('fusion_token');\n        setUser(null);\n    };\n\n    return {\n        user,\n        loading,\n        login,\n        logout,\n        isAuthenticated: !!user,\n    };\n}\n"],"mappings":"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","names":["FusionFetcher","baseUrl","request","method","path","body","headers","window","token","localStorage","getItem","response","fetch","JSON","stringify","undefined","ok","Error","status","statusText","json","get","post","put","delete","apiFetcher","createWextsRpcClient","manifest","options","services","Set","map","service","name","methodMap","Map","set","methods","createServiceProxy","serviceName","Proxy","_target","methodName","knownMethods","has","args","invokeRpc","size","fetchImpl","getHeaders","encodeURIComponent","payload","data","FusionContext","createContext","FusionProvider","children","baseUrl","rpcBaseUrl","rpcClient","client","React","useMemo","FusionFetcher","wexts","createWextsRpcClient","undefined","Provider","value","useFusion","context","useContext","Error","useWexts","import_react","useAuth","client","useFusion","user","setUser","useState","loading","setLoading","useEffect","token","localStorage","getItem","loadUser","userData","get","error","removeItem","login","email","password","response","post","setItem","logout","isAuthenticated"]}
+{"version":3,"sources":["../../src/next/index.ts","../../src/next/provider.tsx","../../src/errors.ts","../../src/client/fetcher.ts","../../src/next/useAuth.ts"],"sourcesContent":["export * from './provider';\nexport * from './useAuth';\n","'use client';\n\nimport React, { createContext, useContext, ReactNode } from 'react';\nimport { createWextsRpcClient, FusionFetcher, WextsRpcClient } from '../client/fetcher';\n\ninterface FusionContextType {\n    client: FusionFetcher;\n    wexts: WextsRpcClient;\n}\n\nconst FusionContext = createContext<FusionContextType | null>(null);\n\nexport interface FusionProviderProps {\n    children: ReactNode;\n    baseUrl?: string;\n    rpcBaseUrl?: string;\n    rpcClient?: object;\n}\n\n/**\n * FusionProvider - Provides API client to React components\n * Usage:\n * ```tsx\n * <FusionProvider baseUrl=\"/api\">\n *   <App />\n * </FusionProvider>\n * ```\n */\nexport function FusionProvider({ children, baseUrl = '/api', rpcBaseUrl = '/rpc', rpcClient }: FusionProviderProps) {\n    const client = React.useMemo(() => new FusionFetcher(baseUrl), [baseUrl]);\n    const wexts = React.useMemo(\n        () => (rpcClient as WextsRpcClient | undefined) ?? createWextsRpcClient(undefined, { baseUrl: rpcBaseUrl }),\n        [rpcBaseUrl, rpcClient]\n    );\n\n    return (\n        <FusionContext.Provider value={{ client, wexts }}>\n            {children}\n        </FusionContext.Provider>\n    );\n}\n\n/**\n * useFusion hook - Access API client in components\n * Usage:\n * ```tsx\n * const { client } = useFusion();\n * const data = await client.get('/users');\n * ```\n */\nexport function useFusion(): FusionContextType {\n    const context = useContext(FusionContext);\n    if (!context) {\n        throw new Error('useFusion must be used within FusionProvider');\n    }\n    return context;\n}\n\nexport function useWexts<TClient = WextsRpcClient>(): TClient {\n    const context = useFusion();\n    return context.wexts as TClient;\n}\n","export interface WextsErrorOptions {\n    code: string;\n    message: string;\n    cause?: unknown;\n    suggestedFix?: string;\n    docsSlug?: string;\n}\n\nexport class WextsError extends Error {\n    readonly code: string;\n    readonly suggestedFix?: string;\n    readonly docsSlug?: string;\n\n    constructor(options: WextsErrorOptions) {\n        super(options.message, options.cause === undefined ? undefined : { cause: options.cause });\n        this.name = 'WextsError';\n        this.code = options.code;\n        this.suggestedFix = options.suggestedFix;\n        this.docsSlug = options.docsSlug;\n    }\n\n    get docsUrl(): string | undefined {\n        return this.docsSlug ? `https://github.com/ziadmustafa1/wexts/blob/main/docs/${this.docsSlug}.md` : undefined;\n    }\n}\n\nexport class WextsRpcError extends WextsError {\n    constructor(options: Omit<WextsErrorOptions, 'code'> & { code?: string }) {\n        super({ code: options.code ?? 'WEXTS_RPC_ERROR', ...options });\n        this.name = 'WextsRpcError';\n    }\n}\n\nexport class WextsCodegenError extends WextsError {\n    constructor(options: Omit<WextsErrorOptions, 'code'> & { code?: string }) {\n        super({ code: options.code ?? 'WEXTS_CODEGEN_ERROR', ...options });\n        this.name = 'WextsCodegenError';\n    }\n}\n\nexport class WextsRuntimeError extends WextsError {\n    constructor(options: Omit<WextsErrorOptions, 'code'> & { code?: string }) {\n        super({ code: options.code ?? 'WEXTS_RUNTIME_ERROR', ...options });\n        this.name = 'WextsRuntimeError';\n    }\n}\n\nexport class WextsSecurityError extends WextsError {\n    constructor(options: Omit<WextsErrorOptions, 'code'> & { code?: string }) {\n        super({ code: options.code ?? 'WEXTS_SECURITY_ERROR', ...options });\n        this.name = 'WextsSecurityError';\n    }\n}\n\nexport function formatWextsError(error: unknown): string {\n    if (!(error instanceof WextsError)) {\n        return error instanceof Error ? error.message : String(error);\n    }\n\n    const lines = [`${error.code}: ${error.message}`];\n    if (error.suggestedFix) lines.push(`Suggested fix: ${error.suggestedFix}`);\n    if (error.docsUrl) lines.push(`Docs: ${error.docsUrl}`);\n    return lines.join('\\n');\n}\n","import type { RpcManifest, RpcInvocationResponse } from '../rpc/types';\nimport { WextsRpcError } from '../errors';\n\nexport class FusionFetcher {\n    private baseUrl: string;\n\n    constructor(baseUrl: string = '/api') {\n        this.baseUrl = baseUrl;\n    }\n\n    private async request<T>(method: string, path: string, body?: any): Promise<T> {\n        const headers: Record<string, string> = {\n            'Content-Type': 'application/json',\n        };\n\n        // Automatically attach Fusion Token if present\n        if (typeof window !== 'undefined') {\n            const token = localStorage.getItem('fusion_token');\n            if (token) headers['Authorization'] = `Bearer ${token}`;\n        }\n\n    const response = await fetch(`${this.baseUrl}${path}`, {\n            method,\n            headers,\n            body: body ? JSON.stringify(body) : undefined,\n        });\n\n        if (!response.ok) {\n            throw new WextsRpcError({\n                code: 'WEXTS_API_REQUEST_FAILED',\n                message: `Fusion API Error: ${response.status} ${response.statusText}`,\n                suggestedFix: 'Check the API route, server logs, and authentication headers.',\n                docsSlug: 'troubleshooting',\n            });\n        }\n\n        if (response.status === 204) {\n            return undefined as T;\n        }\n\n        return response.json();\n    }\n\n    get<T>(path: string) { return this.request<T>('GET', path); }\n    post<T>(path: string, body: any) { return this.request<T>('POST', path, body); }\n    put<T>(path: string, body: any) { return this.request<T>('PUT', path, body); }\n    delete<T>(path: string) { return this.request<T>('DELETE', path); }\n}\n\nexport const apiFetcher = new FusionFetcher();\n\nexport interface WextsRpcClientOptions {\n    baseUrl?: string;\n    fetch?: typeof fetch;\n    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;\n}\n\nexport type WextsRpcClient = Record<string, Record<string, (...args: unknown[]) => Promise<unknown>>>;\n\nexport function createWextsRpcClient(\n    manifest: Pick<RpcManifest, 'services'> | undefined,\n    options: WextsRpcClientOptions = {}\n): WextsRpcClient {\n    const hasManifest = Boolean(manifest);\n    const services = new Set((manifest?.services ?? []).map((service) => service.name));\n    const methodMap = new Map<string, Set<string>>();\n\n    for (const service of manifest?.services ?? []) {\n        methodMap.set(service.name, new Set(service.methods.map((method) => method.name)));\n    }\n\n    const createServiceProxy = (serviceName: string) => new Proxy({}, {\n        get(_target, methodName) {\n            if (typeof methodName !== 'string') return undefined;\n            if (methodName === 'then') return undefined;\n\n            const knownMethods = methodMap.get(serviceName);\n            if (knownMethods && !knownMethods.has(methodName)) {\n                throw new WextsRpcError({\n                    code: 'WEXTS_RPC_METHOD_NOT_FOUND',\n                    message: `Wexts RPC method not found: ${serviceName}.${methodName}`,\n                    suggestedFix: 'Run `wexts generate` and verify the method is decorated with @RpcMethod().',\n                    docsSlug: 'rpc',\n                });\n            }\n\n            return (...args: unknown[]) => invokeRpc(serviceName, methodName, args, options);\n        },\n    }) as Record<string, (...args: unknown[]) => Promise<unknown>>;\n\n    return new Proxy({}, {\n        get(_target, serviceName) {\n            if (typeof serviceName !== 'string') return undefined;\n            if (serviceName === 'then') return undefined;\n            if (!hasManifest) {\n                throw new WextsRpcError({\n                    code: 'WEXTS_RPC_MANIFEST_MISSING',\n                    message: 'Wexts RPC manifest is missing.',\n                    suggestedFix: 'Run `wexts generate` and import the generated client/provider instead of creating an empty client.',\n                    docsSlug: 'codegen',\n                });\n            }\n            if (!services.has(serviceName)) {\n                throw new WextsRpcError({\n                    code: 'WEXTS_RPC_SERVICE_NOT_FOUND',\n                    message: `Wexts RPC service not found: ${serviceName}`,\n                    suggestedFix: 'Run `wexts generate` and verify the service is decorated with @RpcService().',\n                    docsSlug: 'rpc',\n                });\n            }\n\n            return createServiceProxy(serviceName);\n        },\n    }) as WextsRpcClient;\n}\n\nasync function invokeRpc(\n    serviceName: string,\n    methodName: string,\n    args: unknown[],\n    options: WextsRpcClientOptions\n): Promise<unknown> {\n    const fetchImpl = options.fetch ?? fetch;\n    const baseUrl = options.baseUrl ?? '/rpc';\n    const headers = {\n        'Content-Type': 'application/json',\n        ...(await options.getHeaders?.() ?? {}),\n    };\n    const response = await fetchImpl(`${baseUrl}/${encodeURIComponent(serviceName)}/${encodeURIComponent(methodName)}`, {\n        method: 'POST',\n        headers,\n        body: JSON.stringify({ args }),\n    });\n\n    if (!response.ok) {\n        throw new WextsRpcError({\n            code: 'WEXTS_RPC_REQUEST_FAILED',\n            message: `Wexts RPC Error: ${response.status} ${response.statusText}`,\n            suggestedFix: 'Check the RPC route, service policy, and server logs.',\n            docsSlug: 'troubleshooting',\n        });\n    }\n\n    const payload = await response.json() as RpcInvocationResponse;\n    return payload.data;\n}\n","'use client';\n\nimport { useState, useEffect } from 'react';\nimport { useFusion } from './provider';\n\nexport interface AuthUser {\n    id: string;\n    email: string;\n    name?: string;\n}\n\nexport interface UseAuthReturn {\n    user: AuthUser | null;\n    loading: boolean;\n    login: (email: string, password: string) => Promise<void>;\n    logout: () => Promise<void>;\n    isAuthenticated: boolean;\n}\n\n/**\n * useAuth hook - Authentication state management\n * Usage:\n * ```tsx\n * const { user, login, logout, isAuthenticated } = useAuth();\n * ```\n */\nexport function useAuth(): UseAuthReturn {\n    const { client } = useFusion();\n    const [user, setUser] = useState<AuthUser | null>(null);\n    const [loading, setLoading] = useState(true);\n\n    useEffect(() => {\n        // Check for existing session\n        const token = localStorage.getItem('fusion_token');\n        if (token) {\n            // Validate token and load user\n            loadUser();\n        } else {\n            setLoading(false);\n        }\n    }, []);\n\n    const loadUser = async () => {\n        try {\n            const userData = await client.get<AuthUser>('/auth/me');\n            setUser(userData);\n        } catch (error) {\n            localStorage.removeItem('fusion_token');\n        } finally {\n            setLoading(false);\n        }\n    };\n\n    const login = async (email: string, password: string) => {\n        const response = await client.post<{ token: string; user: AuthUser }>('/auth/login', {\n            email,\n            password,\n        });\n        localStorage.setItem('fusion_token', response.token);\n        setUser(response.user);\n    };\n\n    const logout = async () => {\n        localStorage.removeItem('fusion_token');\n        setUser(null);\n    };\n\n    return {\n        user,\n        loading,\n        login,\n        logout,\n        isAuthenticated: !!user,\n    };\n}\n"],"mappings":"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","names":["WextsError","Error","code","suggestedFix","docsSlug","options","message","cause","undefined","name","docsUrl","WextsRpcError","FusionFetcher","baseUrl","request","method","path","body","headers","window","token","localStorage","getItem","response","fetch","JSON","stringify","undefined","ok","WextsRpcError","code","message","status","statusText","suggestedFix","docsSlug","json","get","post","put","delete","apiFetcher","createWextsRpcClient","manifest","options","hasManifest","Boolean","services","Set","map","service","name","methodMap","Map","set","methods","createServiceProxy","serviceName","Proxy","_target","methodName","knownMethods","has","args","invokeRpc","fetchImpl","getHeaders","encodeURIComponent","payload","data","FusionContext","createContext","FusionProvider","children","baseUrl","rpcBaseUrl","rpcClient","client","React","useMemo","FusionFetcher","wexts","createWextsRpcClient","undefined","Provider","value","useFusion","context","useContext","Error","useWexts","import_react","useAuth","client","useFusion","user","setUser","useState","loading","setLoading","useEffect","token","localStorage","getItem","loadUser","userData","get","error","removeItem","login","email","password","response","post","setItem","logout","isAuthenticated"]}

package/dist/next/index.mjs

@@ -5,6 +5,40 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 // src/next/provider.tsx
 import React, { createContext, useContext } from "react";
 
+// src/errors.ts
+var WextsError = class extends Error {
+  static {
+    __name(this, "WextsError");
+  }
+  code;
+  suggestedFix;
+  docsSlug;
+  constructor(options) {
+    super(options.message, options.cause === void 0 ? void 0 : {
+      cause: options.cause
+    });
+    this.name = "WextsError";
+    this.code = options.code;
+    this.suggestedFix = options.suggestedFix;
+    this.docsSlug = options.docsSlug;
+  }
+  get docsUrl() {
+    return this.docsSlug ? `https://github.com/ziadmustafa1/wexts/blob/main/docs/${this.docsSlug}.md` : void 0;
+  }
+};
+var WextsRpcError = class extends WextsError {
+  static {
+    __name(this, "WextsRpcError");
+  }
+  constructor(options) {
+    super({
+      code: options.code ?? "WEXTS_RPC_ERROR",
+      ...options
+    });
+    this.name = "WextsRpcError";
+  }
+};
+
 // src/client/fetcher.ts
 var FusionFetcher = class {
   static {
@@ -28,7 +62,12 @@ var FusionFetcher = class {
       body: body ? JSON.stringify(body) : void 0
     });
     if (!response.ok) {
-      throw new Error(`Fusion API Error: ${response.status} ${response.statusText}`);
+      throw new WextsRpcError({
+        code: "WEXTS_API_REQUEST_FAILED",
+        message: `Fusion API Error: ${response.status} ${response.statusText}`,
+        suggestedFix: "Check the API route, server logs, and authentication headers.",
+        docsSlug: "troubleshooting"
+      });
     }
     if (response.status === 204) {
       return void 0;
@@ -50,6 +89,7 @@ var FusionFetcher = class {
 };
 var apiFetcher = new FusionFetcher();
 function createWextsRpcClient(manifest, options = {}) {
+  const hasManifest = Boolean(manifest);
   const services = new Set((manifest?.services ?? []).map((service) => service.name));
   const methodMap = /* @__PURE__ */ new Map();
   for (const service of manifest?.services ?? []) {
@@ -61,7 +101,12 @@ function createWextsRpcClient(manifest, options = {}) {
       if (methodName === "then") return void 0;
       const knownMethods = methodMap.get(serviceName);
       if (knownMethods && !knownMethods.has(methodName)) {
-        throw new Error(`Wexts RPC method not found: ${serviceName}.${methodName}`);
+        throw new WextsRpcError({
+          code: "WEXTS_RPC_METHOD_NOT_FOUND",
+          message: `Wexts RPC method not found: ${serviceName}.${methodName}`,
+          suggestedFix: "Run `wexts generate` and verify the method is decorated with @RpcMethod().",
+          docsSlug: "rpc"
+        });
       }
       return (...args) => invokeRpc(serviceName, methodName, args, options);
     }
@@ -70,8 +115,21 @@ function createWextsRpcClient(manifest, options = {}) {
     get(_target, serviceName) {
       if (typeof serviceName !== "string") return void 0;
       if (serviceName === "then") return void 0;
-      if (services.size > 0 && !services.has(serviceName)) {
-        throw new Error(`Wexts RPC service not found: ${serviceName}`);
+      if (!hasManifest) {
+        throw new WextsRpcError({
+          code: "WEXTS_RPC_MANIFEST_MISSING",
+          message: "Wexts RPC manifest is missing.",
+          suggestedFix: "Run `wexts generate` and import the generated client/provider instead of creating an empty client.",
+          docsSlug: "codegen"
+        });
+      }
+      if (!services.has(serviceName)) {
+        throw new WextsRpcError({
+          code: "WEXTS_RPC_SERVICE_NOT_FOUND",
+          message: `Wexts RPC service not found: ${serviceName}`,
+          suggestedFix: "Run `wexts generate` and verify the service is decorated with @RpcService().",
+          docsSlug: "rpc"
+        });
       }
       return createServiceProxy(serviceName);
     }
@@ -93,7 +151,12 @@ async function invokeRpc(serviceName, methodName, args, options) {
     })
   });
   if (!response.ok) {
-    throw new Error(`Wexts RPC Error: ${response.status} ${response.statusText}`);
+    throw new WextsRpcError({
+      code: "WEXTS_RPC_REQUEST_FAILED",
+      message: `Wexts RPC Error: ${response.status} ${response.statusText}`,
+      suggestedFix: "Check the RPC route, service policy, and server logs.",
+      docsSlug: "troubleshooting"
+    });
   }
   const payload = await response.json();
   return payload.data;

package/dist/next/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/next/provider.tsx","../../src/client/fetcher.ts","../../src/next/useAuth.ts"],"sourcesContent":["'use client';\n\nimport React, { createContext, useContext, ReactNode } from 'react';\nimport { createWextsRpcClient, FusionFetcher, WextsRpcClient } from '../client/fetcher';\n\ninterface FusionContextType {\n    client: FusionFetcher;\n    wexts: WextsRpcClient;\n}\n\nconst FusionContext = createContext<FusionContextType | null>(null);\n\nexport interface FusionProviderProps {\n    children: ReactNode;\n    baseUrl?: string;\n    rpcBaseUrl?: string;\n    rpcClient?: object;\n}\n\n/**\n * FusionProvider - Provides API client to React components\n * Usage:\n * ```tsx\n * <FusionProvider baseUrl=\"/api\">\n *   <App />\n * </FusionProvider>\n * ```\n */\nexport function FusionProvider({ children, baseUrl = '/api', rpcBaseUrl = '/rpc', rpcClient }: FusionProviderProps) {\n    const client = React.useMemo(() => new FusionFetcher(baseUrl), [baseUrl]);\n    const wexts = React.useMemo(\n        () => (rpcClient as WextsRpcClient | undefined) ?? createWextsRpcClient(undefined, { baseUrl: rpcBaseUrl }),\n        [rpcBaseUrl, rpcClient]\n    );\n\n    return (\n        <FusionContext.Provider value={{ client, wexts }}>\n            {children}\n        </FusionContext.Provider>\n    );\n}\n\n/**\n * useFusion hook - Access API client in components\n * Usage:\n * ```tsx\n * const { client } = useFusion();\n * const data = await client.get('/users');\n * ```\n */\nexport function useFusion(): FusionContextType {\n    const context = useContext(FusionContext);\n    if (!context) {\n        throw new Error('useFusion must be used within FusionProvider');\n    }\n    return context;\n}\n\nexport function useWexts<TClient = WextsRpcClient>(): TClient {\n    const context = useFusion();\n    return context.wexts as TClient;\n}\n","import type { RpcManifest, RpcInvocationResponse } from '../rpc/types';\n\nexport class FusionFetcher {\n    private baseUrl: string;\n\n    constructor(baseUrl: string = '/api') {\n        this.baseUrl = baseUrl;\n    }\n\n    private async request<T>(method: string, path: string, body?: any): Promise<T> {\n        const headers: Record<string, string> = {\n            'Content-Type': 'application/json',\n        };\n\n        // Automatically attach Fusion Token if present\n        if (typeof window !== 'undefined') {\n            const token = localStorage.getItem('fusion_token');\n            if (token) headers['Authorization'] = `Bearer ${token}`;\n        }\n\n    const response = await fetch(`${this.baseUrl}${path}`, {\n            method,\n            headers,\n            body: body ? JSON.stringify(body) : undefined,\n        });\n\n        if (!response.ok) {\n            throw new Error(`Fusion API Error: ${response.status} ${response.statusText}`);\n        }\n\n        if (response.status === 204) {\n            return undefined as T;\n        }\n\n        return response.json();\n    }\n\n    get<T>(path: string) { return this.request<T>('GET', path); }\n    post<T>(path: string, body: any) { return this.request<T>('POST', path, body); }\n    put<T>(path: string, body: any) { return this.request<T>('PUT', path, body); }\n    delete<T>(path: string) { return this.request<T>('DELETE', path); }\n}\n\nexport const apiFetcher = new FusionFetcher();\n\nexport interface WextsRpcClientOptions {\n    baseUrl?: string;\n    fetch?: typeof fetch;\n    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;\n}\n\nexport type WextsRpcClient = Record<string, Record<string, (...args: unknown[]) => Promise<unknown>>>;\n\nexport function createWextsRpcClient(\n    manifest: Pick<RpcManifest, 'services'> | undefined,\n    options: WextsRpcClientOptions = {}\n): WextsRpcClient {\n    const services = new Set((manifest?.services ?? []).map((service) => service.name));\n    const methodMap = new Map<string, Set<string>>();\n\n    for (const service of manifest?.services ?? []) {\n        methodMap.set(service.name, new Set(service.methods.map((method) => method.name)));\n    }\n\n    const createServiceProxy = (serviceName: string) => new Proxy({}, {\n        get(_target, methodName) {\n            if (typeof methodName !== 'string') return undefined;\n            if (methodName === 'then') return undefined;\n\n            const knownMethods = methodMap.get(serviceName);\n            if (knownMethods && !knownMethods.has(methodName)) {\n                throw new Error(`Wexts RPC method not found: ${serviceName}.${methodName}`);\n            }\n\n            return (...args: unknown[]) => invokeRpc(serviceName, methodName, args, options);\n        },\n    }) as Record<string, (...args: unknown[]) => Promise<unknown>>;\n\n    return new Proxy({}, {\n        get(_target, serviceName) {\n            if (typeof serviceName !== 'string') return undefined;\n            if (serviceName === 'then') return undefined;\n            if (services.size > 0 && !services.has(serviceName)) {\n                throw new Error(`Wexts RPC service not found: ${serviceName}`);\n            }\n\n            return createServiceProxy(serviceName);\n        },\n    }) as WextsRpcClient;\n}\n\nasync function invokeRpc(\n    serviceName: string,\n    methodName: string,\n    args: unknown[],\n    options: WextsRpcClientOptions\n): Promise<unknown> {\n    const fetchImpl = options.fetch ?? fetch;\n    const baseUrl = options.baseUrl ?? '/rpc';\n    const headers = {\n        'Content-Type': 'application/json',\n        ...(await options.getHeaders?.() ?? {}),\n    };\n    const response = await fetchImpl(`${baseUrl}/${encodeURIComponent(serviceName)}/${encodeURIComponent(methodName)}`, {\n        method: 'POST',\n        headers,\n        body: JSON.stringify({ args }),\n    });\n\n    if (!response.ok) {\n        throw new Error(`Wexts RPC Error: ${response.status} ${response.statusText}`);\n    }\n\n    const payload = await response.json() as RpcInvocationResponse;\n    return payload.data;\n}\n","'use client';\n\nimport { useState, useEffect } from 'react';\nimport { useFusion } from './provider';\n\nexport interface AuthUser {\n    id: string;\n    email: string;\n    name?: string;\n}\n\nexport interface UseAuthReturn {\n    user: AuthUser | null;\n    loading: boolean;\n    login: (email: string, password: string) => Promise<void>;\n    logout: () => Promise<void>;\n    isAuthenticated: boolean;\n}\n\n/**\n * useAuth hook - Authentication state management\n * Usage:\n * ```tsx\n * const { user, login, logout, isAuthenticated } = useAuth();\n * ```\n */\nexport function useAuth(): UseAuthReturn {\n    const { client } = useFusion();\n    const [user, setUser] = useState<AuthUser | null>(null);\n    const [loading, setLoading] = useState(true);\n\n    useEffect(() => {\n        // Check for existing session\n        const token = localStorage.getItem('fusion_token');\n        if (token) {\n            // Validate token and load user\n            loadUser();\n        } else {\n            setLoading(false);\n        }\n    }, []);\n\n    const loadUser = async () => {\n        try {\n            const userData = await client.get<AuthUser>('/auth/me');\n            setUser(userData);\n        } catch (error) {\n            localStorage.removeItem('fusion_token');\n        } finally {\n            setLoading(false);\n        }\n    };\n\n    const login = async (email: string, password: string) => {\n        const response = await client.post<{ token: string; user: AuthUser }>('/auth/login', {\n            email,\n            password,\n        });\n        localStorage.setItem('fusion_token', response.token);\n        setUser(response.user);\n    };\n\n    const logout = async () => {\n        localStorage.removeItem('fusion_token');\n        setUser(null);\n    };\n\n    return {\n        user,\n        loading,\n        login,\n        logout,\n        isAuthenticated: !!user,\n    };\n}\n"],"mappings":"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","names":["React","createContext","useContext","FusionFetcher","baseUrl","request","method","path","body","headers","window","token","localStorage","getItem","response","fetch","JSON","stringify","undefined","ok","Error","status","statusText","json","get","post","put","delete","apiFetcher","createWextsRpcClient","manifest","options","services","Set","map","service","name","methodMap","Map","set","methods","createServiceProxy","serviceName","Proxy","_target","methodName","knownMethods","has","args","invokeRpc","size","fetchImpl","getHeaders","encodeURIComponent","payload","data","FusionContext","createContext","FusionProvider","children","baseUrl","rpcBaseUrl","rpcClient","client","React","useMemo","FusionFetcher","wexts","createWextsRpcClient","undefined","Provider","value","useFusion","context","useContext","Error","useWexts","useState","useEffect","useAuth","client","useFusion","user","setUser","useState","loading","setLoading","useEffect","token","localStorage","getItem","loadUser","userData","get","error","removeItem","login","email","password","response","post","setItem","logout","isAuthenticated"]}
+{"version":3,"sources":["../../src/next/provider.tsx","../../src/errors.ts","../../src/client/fetcher.ts","../../src/next/useAuth.ts"],"sourcesContent":["'use client';\n\nimport React, { createContext, useContext, ReactNode } from 'react';\nimport { createWextsRpcClient, FusionFetcher, WextsRpcClient } from '../client/fetcher';\n\ninterface FusionContextType {\n    client: FusionFetcher;\n    wexts: WextsRpcClient;\n}\n\nconst FusionContext = createContext<FusionContextType | null>(null);\n\nexport interface FusionProviderProps {\n    children: ReactNode;\n    baseUrl?: string;\n    rpcBaseUrl?: string;\n    rpcClient?: object;\n}\n\n/**\n * FusionProvider - Provides API client to React components\n * Usage:\n * ```tsx\n * <FusionProvider baseUrl=\"/api\">\n *   <App />\n * </FusionProvider>\n * ```\n */\nexport function FusionProvider({ children, baseUrl = '/api', rpcBaseUrl = '/rpc', rpcClient }: FusionProviderProps) {\n    const client = React.useMemo(() => new FusionFetcher(baseUrl), [baseUrl]);\n    const wexts = React.useMemo(\n        () => (rpcClient as WextsRpcClient | undefined) ?? createWextsRpcClient(undefined, { baseUrl: rpcBaseUrl }),\n        [rpcBaseUrl, rpcClient]\n    );\n\n    return (\n        <FusionContext.Provider value={{ client, wexts }}>\n            {children}\n        </FusionContext.Provider>\n    );\n}\n\n/**\n * useFusion hook - Access API client in components\n * Usage:\n * ```tsx\n * const { client } = useFusion();\n * const data = await client.get('/users');\n * ```\n */\nexport function useFusion(): FusionContextType {\n    const context = useContext(FusionContext);\n    if (!context) {\n        throw new Error('useFusion must be used within FusionProvider');\n    }\n    return context;\n}\n\nexport function useWexts<TClient = WextsRpcClient>(): TClient {\n    const context = useFusion();\n    return context.wexts as TClient;\n}\n","export interface WextsErrorOptions {\n    code: string;\n    message: string;\n    cause?: unknown;\n    suggestedFix?: string;\n    docsSlug?: string;\n}\n\nexport class WextsError extends Error {\n    readonly code: string;\n    readonly suggestedFix?: string;\n    readonly docsSlug?: string;\n\n    constructor(options: WextsErrorOptions) {\n        super(options.message, options.cause === undefined ? undefined : { cause: options.cause });\n        this.name = 'WextsError';\n        this.code = options.code;\n        this.suggestedFix = options.suggestedFix;\n        this.docsSlug = options.docsSlug;\n    }\n\n    get docsUrl(): string | undefined {\n        return this.docsSlug ? `https://github.com/ziadmustafa1/wexts/blob/main/docs/${this.docsSlug}.md` : undefined;\n    }\n}\n\nexport class WextsRpcError extends WextsError {\n    constructor(options: Omit<WextsErrorOptions, 'code'> & { code?: string }) {\n        super({ code: options.code ?? 'WEXTS_RPC_ERROR', ...options });\n        this.name = 'WextsRpcError';\n    }\n}\n\nexport class WextsCodegenError extends WextsError {\n    constructor(options: Omit<WextsErrorOptions, 'code'> & { code?: string }) {\n        super({ code: options.code ?? 'WEXTS_CODEGEN_ERROR', ...options });\n        this.name = 'WextsCodegenError';\n    }\n}\n\nexport class WextsRuntimeError extends WextsError {\n    constructor(options: Omit<WextsErrorOptions, 'code'> & { code?: string }) {\n        super({ code: options.code ?? 'WEXTS_RUNTIME_ERROR', ...options });\n        this.name = 'WextsRuntimeError';\n    }\n}\n\nexport class WextsSecurityError extends WextsError {\n    constructor(options: Omit<WextsErrorOptions, 'code'> & { code?: string }) {\n        super({ code: options.code ?? 'WEXTS_SECURITY_ERROR', ...options });\n        this.name = 'WextsSecurityError';\n    }\n}\n\nexport function formatWextsError(error: unknown): string {\n    if (!(error instanceof WextsError)) {\n        return error instanceof Error ? error.message : String(error);\n    }\n\n    const lines = [`${error.code}: ${error.message}`];\n    if (error.suggestedFix) lines.push(`Suggested fix: ${error.suggestedFix}`);\n    if (error.docsUrl) lines.push(`Docs: ${error.docsUrl}`);\n    return lines.join('\\n');\n}\n","import type { RpcManifest, RpcInvocationResponse } from '../rpc/types';\nimport { WextsRpcError } from '../errors';\n\nexport class FusionFetcher {\n    private baseUrl: string;\n\n    constructor(baseUrl: string = '/api') {\n        this.baseUrl = baseUrl;\n    }\n\n    private async request<T>(method: string, path: string, body?: any): Promise<T> {\n        const headers: Record<string, string> = {\n            'Content-Type': 'application/json',\n        };\n\n        // Automatically attach Fusion Token if present\n        if (typeof window !== 'undefined') {\n            const token = localStorage.getItem('fusion_token');\n            if (token) headers['Authorization'] = `Bearer ${token}`;\n        }\n\n    const response = await fetch(`${this.baseUrl}${path}`, {\n            method,\n            headers,\n            body: body ? JSON.stringify(body) : undefined,\n        });\n\n        if (!response.ok) {\n            throw new WextsRpcError({\n                code: 'WEXTS_API_REQUEST_FAILED',\n                message: `Fusion API Error: ${response.status} ${response.statusText}`,\n                suggestedFix: 'Check the API route, server logs, and authentication headers.',\n                docsSlug: 'troubleshooting',\n            });\n        }\n\n        if (response.status === 204) {\n            return undefined as T;\n        }\n\n        return response.json();\n    }\n\n    get<T>(path: string) { return this.request<T>('GET', path); }\n    post<T>(path: string, body: any) { return this.request<T>('POST', path, body); }\n    put<T>(path: string, body: any) { return this.request<T>('PUT', path, body); }\n    delete<T>(path: string) { return this.request<T>('DELETE', path); }\n}\n\nexport const apiFetcher = new FusionFetcher();\n\nexport interface WextsRpcClientOptions {\n    baseUrl?: string;\n    fetch?: typeof fetch;\n    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;\n}\n\nexport type WextsRpcClient = Record<string, Record<string, (...args: unknown[]) => Promise<unknown>>>;\n\nexport function createWextsRpcClient(\n    manifest: Pick<RpcManifest, 'services'> | undefined,\n    options: WextsRpcClientOptions = {}\n): WextsRpcClient {\n    const hasManifest = Boolean(manifest);\n    const services = new Set((manifest?.services ?? []).map((service) => service.name));\n    const methodMap = new Map<string, Set<string>>();\n\n    for (const service of manifest?.services ?? []) {\n        methodMap.set(service.name, new Set(service.methods.map((method) => method.name)));\n    }\n\n    const createServiceProxy = (serviceName: string) => new Proxy({}, {\n        get(_target, methodName) {\n            if (typeof methodName !== 'string') return undefined;\n            if (methodName === 'then') return undefined;\n\n            const knownMethods = methodMap.get(serviceName);\n            if (knownMethods && !knownMethods.has(methodName)) {\n                throw new WextsRpcError({\n                    code: 'WEXTS_RPC_METHOD_NOT_FOUND',\n                    message: `Wexts RPC method not found: ${serviceName}.${methodName}`,\n                    suggestedFix: 'Run `wexts generate` and verify the method is decorated with @RpcMethod().',\n                    docsSlug: 'rpc',\n                });\n            }\n\n            return (...args: unknown[]) => invokeRpc(serviceName, methodName, args, options);\n        },\n    }) as Record<string, (...args: unknown[]) => Promise<unknown>>;\n\n    return new Proxy({}, {\n        get(_target, serviceName) {\n            if (typeof serviceName !== 'string') return undefined;\n            if (serviceName === 'then') return undefined;\n            if (!hasManifest) {\n                throw new WextsRpcError({\n                    code: 'WEXTS_RPC_MANIFEST_MISSING',\n                    message: 'Wexts RPC manifest is missing.',\n                    suggestedFix: 'Run `wexts generate` and import the generated client/provider instead of creating an empty client.',\n                    docsSlug: 'codegen',\n                });\n            }\n            if (!services.has(serviceName)) {\n                throw new WextsRpcError({\n                    code: 'WEXTS_RPC_SERVICE_NOT_FOUND',\n                    message: `Wexts RPC service not found: ${serviceName}`,\n                    suggestedFix: 'Run `wexts generate` and verify the service is decorated with @RpcService().',\n                    docsSlug: 'rpc',\n                });\n            }\n\n            return createServiceProxy(serviceName);\n        },\n    }) as WextsRpcClient;\n}\n\nasync function invokeRpc(\n    serviceName: string,\n    methodName: string,\n    args: unknown[],\n    options: WextsRpcClientOptions\n): Promise<unknown> {\n    const fetchImpl = options.fetch ?? fetch;\n    const baseUrl = options.baseUrl ?? '/rpc';\n    const headers = {\n        'Content-Type': 'application/json',\n        ...(await options.getHeaders?.() ?? {}),\n    };\n    const response = await fetchImpl(`${baseUrl}/${encodeURIComponent(serviceName)}/${encodeURIComponent(methodName)}`, {\n        method: 'POST',\n        headers,\n        body: JSON.stringify({ args }),\n    });\n\n    if (!response.ok) {\n        throw new WextsRpcError({\n            code: 'WEXTS_RPC_REQUEST_FAILED',\n            message: `Wexts RPC Error: ${response.status} ${response.statusText}`,\n            suggestedFix: 'Check the RPC route, service policy, and server logs.',\n            docsSlug: 'troubleshooting',\n        });\n    }\n\n    const payload = await response.json() as RpcInvocationResponse;\n    return payload.data;\n}\n","'use client';\n\nimport { useState, useEffect } from 'react';\nimport { useFusion } from './provider';\n\nexport interface AuthUser {\n    id: string;\n    email: string;\n    name?: string;\n}\n\nexport interface UseAuthReturn {\n    user: AuthUser | null;\n    loading: boolean;\n    login: (email: string, password: string) => Promise<void>;\n    logout: () => Promise<void>;\n    isAuthenticated: boolean;\n}\n\n/**\n * useAuth hook - Authentication state management\n * Usage:\n * ```tsx\n * const { user, login, logout, isAuthenticated } = useAuth();\n * ```\n */\nexport function useAuth(): UseAuthReturn {\n    const { client } = useFusion();\n    const [user, setUser] = useState<AuthUser | null>(null);\n    const [loading, setLoading] = useState(true);\n\n    useEffect(() => {\n        // Check for existing session\n        const token = localStorage.getItem('fusion_token');\n        if (token) {\n            // Validate token and load user\n            loadUser();\n        } else {\n            setLoading(false);\n        }\n    }, []);\n\n    const loadUser = async () => {\n        try {\n            const userData = await client.get<AuthUser>('/auth/me');\n            setUser(userData);\n        } catch (error) {\n            localStorage.removeItem('fusion_token');\n        } finally {\n            setLoading(false);\n        }\n    };\n\n    const login = async (email: string, password: string) => {\n        const response = await client.post<{ token: string; user: AuthUser }>('/auth/login', {\n            email,\n            password,\n        });\n        localStorage.setItem('fusion_token', response.token);\n        setUser(response.user);\n    };\n\n    const logout = async () => {\n        localStorage.removeItem('fusion_token');\n        setUser(null);\n    };\n\n    return {\n        user,\n        loading,\n        login,\n        logout,\n        isAuthenticated: !!user,\n    };\n}\n"],"mappings":"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","names":["React","createContext","useContext","WextsError","Error","code","suggestedFix","docsSlug","options","message","cause","undefined","name","docsUrl","WextsRpcError","FusionFetcher","baseUrl","request","method","path","body","headers","window","token","localStorage","getItem","response","fetch","JSON","stringify","undefined","ok","WextsRpcError","code","message","status","statusText","suggestedFix","docsSlug","json","get","post","put","delete","apiFetcher","createWextsRpcClient","manifest","options","hasManifest","Boolean","services","Set","map","service","name","methodMap","Map","set","methods","createServiceProxy","serviceName","Proxy","_target","methodName","knownMethods","has","args","invokeRpc","fetchImpl","getHeaders","encodeURIComponent","payload","data","FusionContext","createContext","FusionProvider","children","baseUrl","rpcBaseUrl","rpcClient","client","React","useMemo","FusionFetcher","wexts","createWextsRpcClient","undefined","Provider","value","useFusion","context","useContext","Error","useWexts","useState","useEffect","useAuth","client","useFusion","user","setUser","useState","loading","setLoading","useEffect","token","localStorage","getItem","loadUser","userData","get","error","removeItem","login","email","password","response","post","setItem","logout","isAuthenticated"]}

package/dist/runtime/index.js

@@ -1,5 +1,8 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
+var _chunkAVMQJWYDjs = require('../chunk-AVMQJWYD.js');
+
+
 var _chunkXE4OXN2Wjs = require('../chunk-XE4OXN2W.js');
 
 // src/runtime/rpc-router.ts
@@ -158,7 +161,12 @@ async function mountNext(fastify, rootDir, config) {
   const nextModule = await Promise.resolve().then(() => _interopRequireWildcard(require("next")));
   const next = nextModule.default;
   if (!next) {
-    throw new Error("Next.js could not be loaded. Install next or omit nextDir.");
+    throw new (0, _chunkAVMQJWYDjs.WextsRuntimeError)({
+      code: "WEXTS_RUNTIME_NEXT_MISSING",
+      message: "Next.js could not be loaded. Install next or omit nextDir.",
+      suggestedFix: "Install `next` in the application or remove `nextDir` from wexts.runtime.js.",
+      docsSlug: "runtime"
+    });
   }
   const nextApp = next({
     dev: _nullishCoalesce(config.dev, () => ( process.env.NODE_ENV !== "production")),

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Volumes/Projects/wexts/packages/dist/runtime/index.js","../../src/runtime/rpc-router.ts","../../src/runtime/server.ts","../../src/runtime/vercel-handler.ts"],"names":["registerRpcRoutes","fastify","options","serviceMap","Map","manifest","services","map","service","name","post","request","reply","get","params","status","error","method","methods","find","candidate","requireAuth","authorized","authorize","instance","handler","handlerName","args","Array","isArray","body","data","apply","createWextsRuntimeServer","config","rootDir","resolve","process","cwd","Fastify","logger","bodyLimit","security","bodyLimitBytes","requestTimeout","requestTimeoutMs","rpcManifest","loadJson","rpcManifestPath","routePolicies","rpcPoliciesFromManifest","registerWextsShield","ok","runtime","scope","rpcServices","Boolean","headers","authorization","cookie","nestAppModule","nestAppModulePath","mountNest","nextDir","mountNext","start","listen","port","Number","env","PORT","host","close","registerShutdown","startWextsRuntime","server","flatMap","path","undefined","filePath","absolutePath","AppModule","moduleValue","default","NODE_ENV","modulePath","importModule","pathToFileUrl","res","req","createWextsHandler"],"mappings":"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","file":"/Volumes/Projects/wexts/packages/dist/runtime/index.js","sourcesContent":[null,"import type { FastifyInstance, FastifyReply, FastifyRequest } from 'fastify';\nimport type { RpcManifest, RpcServiceManifest } from '../rpc/types';\n\nexport type RpcServiceInstances = Record<string, Record<string, (...args: unknown[]) => unknown | Promise<unknown>>>;\n\nexport interface RegisterRpcRoutesOptions {\n    manifest: RpcManifest;\n    services: RpcServiceInstances;\n    authorize?: (request: FastifyRequest, service: RpcServiceManifest, methodName: string) => boolean | Promise<boolean>;\n}\n\nexport async function registerRpcRoutes(fastify: FastifyInstance, options: RegisterRpcRoutesOptions): Promise<void> {\n    const serviceMap = new Map(options.manifest.services.map((service) => [service.name, service]));\n\n    fastify.post('/rpc/:service/:method', async (request: FastifyRequest<{\n        Params: { service: string; method: string };\n        Body: { args?: unknown[] };\n    }>, reply: FastifyReply) => {\n        const service = serviceMap.get(request.params.service);\n        if (!service) {\n            reply.status(404);\n            return { error: 'WEXTS_RPC_SERVICE_NOT_FOUND' };\n        }\n\n        const method = service.methods.find((candidate) => candidate.name === request.params.method);\n        if (!method) {\n            reply.status(404);\n            return { error: 'WEXTS_RPC_METHOD_NOT_FOUND' };\n        }\n\n        if (method.requireAuth || service.requireAuth) {\n            const authorized = await options.authorize?.(request, service, method.name);\n            if (!authorized) {\n                reply.status(401);\n                return { error: 'WEXTS_RPC_AUTH_REQUIRED' };\n            }\n        }\n\n        const instance = options.services[service.name];\n        const handler = instance?.[method.handlerName];\n        if (!handler) {\n            reply.status(500);\n            return { error: 'WEXTS_RPC_HANDLER_NOT_BOUND' };\n        }\n\n        const args = Array.isArray(request.body?.args) ? request.body.args : [];\n        const data = await handler.apply(instance, args);\n        return { data };\n    });\n}\n","import * as fs from 'fs';\nimport * as path from 'path';\nimport Fastify, { FastifyInstance, FastifyServerOptions } from 'fastify';\nimport { registerWextsShield, type WextsShieldConfig, type WextsShieldRoutePolicy } from '@wexts/security';\nimport type { RpcManifest } from '../rpc/types';\nimport { registerRpcRoutes, type RpcServiceInstances } from './rpc-router';\n\nexport interface WextsRuntimeConfig {\n    rootDir?: string;\n    port?: number;\n    host?: string;\n    dev?: boolean;\n    nextDir?: string;\n    nestAppModule?: unknown;\n    nestAppModulePath?: string;\n    rpcManifest?: RpcManifest;\n    rpcManifestPath?: string;\n    rpcServices?: RpcServiceInstances;\n    security?: WextsShieldConfig;\n    logger?: FastifyServerOptions['logger'];\n}\n\nexport interface WextsRuntimeServer {\n    fastify: FastifyInstance;\n    start: () => Promise<void>;\n    close: () => Promise<void>;\n}\n\nexport async function createWextsRuntimeServer(config: WextsRuntimeConfig = {}): Promise<WextsRuntimeServer> {\n    const rootDir = path.resolve(config.rootDir ?? process.cwd());\n    const fastify = Fastify({\n        logger: config.logger ?? true,\n        bodyLimit: config.security?.bodyLimitBytes ?? 1_048_576,\n        requestTimeout: config.security?.requestTimeoutMs ?? 30_000,\n    });\n\n    const manifest = config.rpcManifest ?? loadJson<RpcManifest>(rootDir, config.rpcManifestPath);\n    const routePolicies = [\n        ...(config.security?.routePolicies ?? []),\n        ...rpcPoliciesFromManifest(manifest),\n    ];\n\n    await registerWextsShield(fastify, {\n        ...config.security,\n        routePolicies,\n    });\n\n    fastify.get('/health', async () => ({\n        ok: true,\n        runtime: 'wexts',\n    }));\n\n    fastify.get('/api/health', async () => ({\n        ok: true,\n        runtime: 'wexts',\n        scope: 'api',\n    }));\n\n    if (manifest && config.rpcServices) {\n        await registerRpcRoutes(fastify, {\n            manifest,\n            services: config.rpcServices,\n            authorize: (request) => Boolean(request.headers.authorization || request.headers.cookie),\n        });\n    }\n\n    if (config.nestAppModule || config.nestAppModulePath) {\n        await mountNest(fastify, rootDir, config);\n    }\n\n    if (config.nextDir) {\n        await mountNext(fastify, rootDir, config);\n    }\n\n    const start = async () => {\n        await fastify.listen({\n            port: config.port ?? Number(process.env.PORT ?? 3000),\n            host: config.host ?? '0.0.0.0',\n        });\n    };\n\n    const close = async () => {\n        await fastify.close();\n    };\n\n    registerShutdown(close);\n\n    return {\n        fastify,\n        start,\n        close,\n    };\n}\n\nexport async function startWextsRuntime(config: WextsRuntimeConfig = {}): Promise<WextsRuntimeServer> {\n    const server = await createWextsRuntimeServer(config);\n    await server.start();\n    return server;\n}\n\nfunction rpcPoliciesFromManifest(manifest?: RpcManifest): WextsShieldRoutePolicy[] {\n    if (!manifest) return [];\n\n    return manifest.services.flatMap((service) => service.methods.map((method) => ({\n        path: `/rpc/${service.name}/${method.name}`,\n        methods: ['POST'],\n        mode: service.requireAuth || method.requireAuth ? 'requireAuth' : 'public',\n    })));\n}\n\nfunction loadJson<T>(rootDir: string, filePath?: string): T | undefined {\n    if (!filePath) return undefined;\n\n    const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(rootDir, filePath);\n    if (!fs.existsSync(absolutePath)) return undefined;\n    return JSON.parse(fs.readFileSync(absolutePath, 'utf8')) as T;\n}\n\nasync function mountNest(fastify: FastifyInstance, rootDir: string, config: WextsRuntimeConfig): Promise<void> {\n    const [{ NestFactory }, { FastifyAdapter }] = await Promise.all([\n        import('@nestjs/core'),\n        import('@nestjs/platform-fastify'),\n    ]);\n    const AppModule = config.nestAppModule ?? await importModule(rootDir, config.nestAppModulePath!);\n    const moduleValue = (AppModule as { AppModule?: unknown }).AppModule ?? AppModule;\n    const nestApp = await NestFactory.create(moduleValue as never, new FastifyAdapter(fastify as never), {\n        logger: config.dev ? ['log', 'error', 'warn'] : ['error', 'warn'],\n    });\n    nestApp.setGlobalPrefix('api');\n    await nestApp.init();\n}\n\nasync function mountNext(fastify: FastifyInstance, rootDir: string, config: WextsRuntimeConfig): Promise<void> {\n    const nextModule = await import('next') as unknown as { default?: (options: unknown) => { prepare: () => Promise<void>; getRequestHandler: () => (req: unknown, res: unknown) => Promise<void> } };\n    const next = nextModule.default;\n    if (!next) {\n        throw new Error('Next.js could not be loaded. Install next or omit nextDir.');\n    }\n    const nextApp = next({\n        dev: config.dev ?? process.env.NODE_ENV !== 'production',\n        dir: path.isAbsolute(config.nextDir!) ? config.nextDir : path.join(rootDir, config.nextDir!),\n    });\n    await nextApp.prepare();\n    const handler = nextApp.getRequestHandler();\n\n    fastify.all('/*', async (request, reply) => {\n        await handler(request.raw, reply.raw);\n        reply.hijack();\n    });\n}\n\nasync function importModule(rootDir: string, modulePath: string): Promise<unknown> {\n    const absolutePath = path.isAbsolute(modulePath) ? modulePath : path.join(rootDir, modulePath);\n    return import(pathToFileUrl(absolutePath));\n}\n\nfunction pathToFileUrl(filePath: string): string {\n    return `file://${filePath}`;\n}\n\nfunction registerShutdown(close: () => Promise<void>): void {\n    const handler = async () => {\n        await close();\n        process.exit(0);\n    };\n\n    process.once('SIGINT', handler);\n    process.once('SIGTERM', handler);\n}\n","/**\n * Vercel / serverless handler adapter for the Wexts runtime.\n *\n * Creates a standard Node.js (req, res) handler that delegates to the\n * Fastify-backed Wexts runtime **without** calling fastify.listen().\n *\n * Usage:\n *   const handler = await createWextsHandler({ ... });\n *   export default handler;           // Vercel function entry\n */\n\nimport type { IncomingMessage, ServerResponse } from 'http';\nimport type { WextsRuntimeConfig } from './server';\nimport { createWextsRuntimeServer } from './server';\n\nexport type WextsHandler = (req: IncomingMessage, res: ServerResponse) => void;\n\n/**\n * Build a serverless-compatible handler from the Wexts runtime.\n * The returned function accepts Node http (req, res) and passes them\n * into the Fastify instance without ever calling listen().\n */\nexport async function createWextsHandler(\n    config: WextsRuntimeConfig = {},\n): Promise<WextsHandler> {\n    const server = await createWextsRuntimeServer({\n        ...config,\n        // Serverless does not use long-lived logging\n        logger: config.logger ?? false,\n    });\n\n    // Fastify exposes a raw Node handler via server.server (the http.Server)\n    // But we need to call .ready() first so all plugins are loaded.\n    await server.fastify.ready();\n\n    return (req: IncomingMessage, res: ServerResponse) => {\n        server.fastify.server.emit('request', req, res);\n    };\n}\n"]}
+{"version":3,"sources":["/Volumes/Projects/wexts/packages/dist/runtime/index.js","../../src/runtime/rpc-router.ts","../../src/runtime/server.ts","../../src/runtime/vercel-handler.ts"],"names":["registerRpcRoutes","fastify","options","serviceMap","Map","manifest","services","map","service","name","post","request","reply","get","params","status","error","method","methods","find","candidate","requireAuth","authorized","authorize","instance","handler","handlerName","args","Array","isArray","body","data","apply","createWextsRuntimeServer","config","rootDir","resolve","process","cwd","Fastify","logger","bodyLimit","security","bodyLimitBytes","requestTimeout","requestTimeoutMs","rpcManifest","loadJson","rpcManifestPath","routePolicies","rpcPoliciesFromManifest","registerWextsShield","ok","runtime","scope","rpcServices","Boolean","headers","authorization","cookie","nestAppModule","nestAppModulePath","mountNest","nextDir","mountNext","start","listen","port","Number","env","PORT","host","close","registerShutdown","startWextsRuntime","server","flatMap","path","undefined","filePath","absolutePath","AppModule","moduleValue","default","NODE_ENV","modulePath","importModule","pathToFileUrl","res","req","createWextsHandler"],"mappings":"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","file":"/Volumes/Projects/wexts/packages/dist/runtime/index.js","sourcesContent":[null,"import type { FastifyInstance, FastifyReply, FastifyRequest } from 'fastify';\nimport type { RpcManifest, RpcServiceManifest } from '../rpc/types';\n\nexport type RpcServiceInstances = Record<string, Record<string, (...args: unknown[]) => unknown | Promise<unknown>>>;\n\nexport interface RegisterRpcRoutesOptions {\n    manifest: RpcManifest;\n    services: RpcServiceInstances;\n    authorize?: (request: FastifyRequest, service: RpcServiceManifest, methodName: string) => boolean | Promise<boolean>;\n}\n\nexport async function registerRpcRoutes(fastify: FastifyInstance, options: RegisterRpcRoutesOptions): Promise<void> {\n    const serviceMap = new Map(options.manifest.services.map((service) => [service.name, service]));\n\n    fastify.post('/rpc/:service/:method', async (request: FastifyRequest<{\n        Params: { service: string; method: string };\n        Body: { args?: unknown[] };\n    }>, reply: FastifyReply) => {\n        const service = serviceMap.get(request.params.service);\n        if (!service) {\n            reply.status(404);\n            return { error: 'WEXTS_RPC_SERVICE_NOT_FOUND' };\n        }\n\n        const method = service.methods.find((candidate) => candidate.name === request.params.method);\n        if (!method) {\n            reply.status(404);\n            return { error: 'WEXTS_RPC_METHOD_NOT_FOUND' };\n        }\n\n        if (method.requireAuth || service.requireAuth) {\n            const authorized = await options.authorize?.(request, service, method.name);\n            if (!authorized) {\n                reply.status(401);\n                return { error: 'WEXTS_RPC_AUTH_REQUIRED' };\n            }\n        }\n\n        const instance = options.services[service.name];\n        const handler = instance?.[method.handlerName];\n        if (!handler) {\n            reply.status(500);\n            return { error: 'WEXTS_RPC_HANDLER_NOT_BOUND' };\n        }\n\n        const args = Array.isArray(request.body?.args) ? request.body.args : [];\n        const data = await handler.apply(instance, args);\n        return { data };\n    });\n}\n","import * as fs from 'fs';\nimport * as path from 'path';\nimport Fastify, { FastifyInstance, FastifyServerOptions } from 'fastify';\nimport { registerWextsShield, type WextsShieldConfig, type WextsShieldRoutePolicy } from '@wexts/security';\nimport type { RpcManifest } from '../rpc/types';\nimport { registerRpcRoutes, type RpcServiceInstances } from './rpc-router';\nimport { WextsRuntimeError } from '../errors';\n\nexport interface WextsRuntimeConfig {\n    rootDir?: string;\n    port?: number;\n    host?: string;\n    dev?: boolean;\n    nextDir?: string;\n    nestAppModule?: unknown;\n    nestAppModulePath?: string;\n    rpcManifest?: RpcManifest;\n    rpcManifestPath?: string;\n    rpcServices?: RpcServiceInstances;\n    security?: WextsShieldConfig;\n    logger?: FastifyServerOptions['logger'];\n}\n\nexport interface WextsRuntimeServer {\n    fastify: FastifyInstance;\n    start: () => Promise<void>;\n    close: () => Promise<void>;\n}\n\nexport async function createWextsRuntimeServer(config: WextsRuntimeConfig = {}): Promise<WextsRuntimeServer> {\n    const rootDir = path.resolve(config.rootDir ?? process.cwd());\n    const fastify = Fastify({\n        logger: config.logger ?? true,\n        bodyLimit: config.security?.bodyLimitBytes ?? 1_048_576,\n        requestTimeout: config.security?.requestTimeoutMs ?? 30_000,\n    });\n\n    const manifest = config.rpcManifest ?? loadJson<RpcManifest>(rootDir, config.rpcManifestPath);\n    const routePolicies = [\n        ...(config.security?.routePolicies ?? []),\n        ...rpcPoliciesFromManifest(manifest),\n    ];\n\n    await registerWextsShield(fastify, {\n        ...config.security,\n        routePolicies,\n    });\n\n    fastify.get('/health', async () => ({\n        ok: true,\n        runtime: 'wexts',\n    }));\n\n    fastify.get('/api/health', async () => ({\n        ok: true,\n        runtime: 'wexts',\n        scope: 'api',\n    }));\n\n    if (manifest && config.rpcServices) {\n        await registerRpcRoutes(fastify, {\n            manifest,\n            services: config.rpcServices,\n            authorize: (request) => Boolean(request.headers.authorization || request.headers.cookie),\n        });\n    }\n\n    if (config.nestAppModule || config.nestAppModulePath) {\n        await mountNest(fastify, rootDir, config);\n    }\n\n    if (config.nextDir) {\n        await mountNext(fastify, rootDir, config);\n    }\n\n    const start = async () => {\n        await fastify.listen({\n            port: config.port ?? Number(process.env.PORT ?? 3000),\n            host: config.host ?? '0.0.0.0',\n        });\n    };\n\n    const close = async () => {\n        await fastify.close();\n    };\n\n    registerShutdown(close);\n\n    return {\n        fastify,\n        start,\n        close,\n    };\n}\n\nexport async function startWextsRuntime(config: WextsRuntimeConfig = {}): Promise<WextsRuntimeServer> {\n    const server = await createWextsRuntimeServer(config);\n    await server.start();\n    return server;\n}\n\nfunction rpcPoliciesFromManifest(manifest?: RpcManifest): WextsShieldRoutePolicy[] {\n    if (!manifest) return [];\n\n    return manifest.services.flatMap((service) => service.methods.map((method) => ({\n        path: `/rpc/${service.name}/${method.name}`,\n        methods: ['POST'],\n        mode: service.requireAuth || method.requireAuth ? 'requireAuth' : 'public',\n    })));\n}\n\nfunction loadJson<T>(rootDir: string, filePath?: string): T | undefined {\n    if (!filePath) return undefined;\n\n    const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(rootDir, filePath);\n    if (!fs.existsSync(absolutePath)) return undefined;\n    return JSON.parse(fs.readFileSync(absolutePath, 'utf8')) as T;\n}\n\nasync function mountNest(fastify: FastifyInstance, rootDir: string, config: WextsRuntimeConfig): Promise<void> {\n    const [{ NestFactory }, { FastifyAdapter }] = await Promise.all([\n        import('@nestjs/core'),\n        import('@nestjs/platform-fastify'),\n    ]);\n    const AppModule = config.nestAppModule ?? await importModule(rootDir, config.nestAppModulePath!);\n    const moduleValue = (AppModule as { AppModule?: unknown }).AppModule ?? AppModule;\n    const nestApp = await NestFactory.create(moduleValue as never, new FastifyAdapter(fastify as never), {\n        logger: config.dev ? ['log', 'error', 'warn'] : ['error', 'warn'],\n    });\n    nestApp.setGlobalPrefix('api');\n    await nestApp.init();\n}\n\nasync function mountNext(fastify: FastifyInstance, rootDir: string, config: WextsRuntimeConfig): Promise<void> {\n    const nextModule = await import('next') as unknown as { default?: (options: unknown) => { prepare: () => Promise<void>; getRequestHandler: () => (req: unknown, res: unknown) => Promise<void> } };\n    const next = nextModule.default;\n    if (!next) {\n        throw new WextsRuntimeError({\n            code: 'WEXTS_RUNTIME_NEXT_MISSING',\n            message: 'Next.js could not be loaded. Install next or omit nextDir.',\n            suggestedFix: 'Install `next` in the application or remove `nextDir` from wexts.runtime.js.',\n            docsSlug: 'runtime',\n        });\n    }\n    const nextApp = next({\n        dev: config.dev ?? process.env.NODE_ENV !== 'production',\n        dir: path.isAbsolute(config.nextDir!) ? config.nextDir : path.join(rootDir, config.nextDir!),\n    });\n    await nextApp.prepare();\n    const handler = nextApp.getRequestHandler();\n\n    fastify.all('/*', async (request, reply) => {\n        await handler(request.raw, reply.raw);\n        reply.hijack();\n    });\n}\n\nasync function importModule(rootDir: string, modulePath: string): Promise<unknown> {\n    const absolutePath = path.isAbsolute(modulePath) ? modulePath : path.join(rootDir, modulePath);\n    return import(pathToFileUrl(absolutePath));\n}\n\nfunction pathToFileUrl(filePath: string): string {\n    return `file://${filePath}`;\n}\n\nfunction registerShutdown(close: () => Promise<void>): void {\n    const handler = async () => {\n        await close();\n        process.exit(0);\n    };\n\n    process.once('SIGINT', handler);\n    process.once('SIGTERM', handler);\n}\n","/**\n * Vercel / serverless handler adapter for the Wexts runtime.\n *\n * Creates a standard Node.js (req, res) handler that delegates to the\n * Fastify-backed Wexts runtime **without** calling fastify.listen().\n *\n * Usage:\n *   const handler = await createWextsHandler({ ... });\n *   export default handler;           // Vercel function entry\n */\n\nimport type { IncomingMessage, ServerResponse } from 'http';\nimport type { WextsRuntimeConfig } from './server';\nimport { createWextsRuntimeServer } from './server';\n\nexport type WextsHandler = (req: IncomingMessage, res: ServerResponse) => void;\n\n/**\n * Build a serverless-compatible handler from the Wexts runtime.\n * The returned function accepts Node http (req, res) and passes them\n * into the Fastify instance without ever calling listen().\n */\nexport async function createWextsHandler(\n    config: WextsRuntimeConfig = {},\n): Promise<WextsHandler> {\n    const server = await createWextsRuntimeServer({\n        ...config,\n        // Serverless does not use long-lived logging\n        logger: config.logger ?? false,\n    });\n\n    // Fastify exposes a raw Node handler via server.server (the http.Server)\n    // But we need to call .ready() first so all plugins are loaded.\n    await server.fastify.ready();\n\n    return (req: IncomingMessage, res: ServerResponse) => {\n        server.fastify.server.emit('request', req, res);\n    };\n}\n"]}