@spfn/core 0.2.0-beta.11 → 0.2.0-beta.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  import { Router, RouteDef } from '@spfn/core/route';
2
- import { R as RequestInterceptor, a as ResponseInterceptor, I as InferRouteInput, b as InferRouteOutput, A as ApiConfig } from '../types-BOPTApC2.js';
3
- export { C as CallOptions, e as CookieOptions, c as RouterInput, d as RouterOutput, f as SetCookie, S as StructuredInput } from '../types-BOPTApC2.js';
2
+ import { R as RequestInterceptor, a as ResponseInterceptor, I as InferRouteInput, b as InferRouteOutput, A as ApiConfig } from '../types-DP8nzQcY.js';
3
+ export { C as CallOptions, e as CookieOptions, c as RouterInput, d as RouterOutput, f as SetCookie, S as StructuredInput } from '../types-DP8nzQcY.js';
4
4
  import '@sinclair/typebox';
5
5
  import '@spfn/core/errors';
6
6
 
@@ -1,7 +1,7 @@
1
1
  import { NextRequest, NextResponse } from 'next/server';
2
2
  import { Router, HttpMethod } from '@spfn/core/route';
3
3
  import { InterceptorRule as InterceptorRule$1 } from '@spfn/core/nextjs/server';
4
- import { f as SetCookie } from '../types-BOPTApC2.js';
4
+ import { f as SetCookie } from '../types-DP8nzQcY.js';
5
5
  import '@sinclair/typebox';
6
6
  import '@spfn/core/errors';
7
7
 
@@ -332,6 +332,10 @@ interface ResponseInterceptorContext {
332
332
  headers: Headers;
333
333
  body: any;
334
334
  };
335
+ /**
336
+ * Cookies from original request (read-only)
337
+ */
338
+ cookies: Map<string, string>;
335
339
  /**
336
340
  * Cookies to set in response
337
341
  *
@@ -305,7 +305,7 @@ function buildRequestContext(path, method, headers, body, searchParams, cookiesM
305
305
  metadata: {}
306
306
  };
307
307
  }
308
- function buildResponseContext(path, method, requestHeaders, requestBody, response, responseBody, requestMetadata) {
308
+ function buildResponseContext(path, method, requestHeaders, requestBody, response, responseBody, requestMetadata, cookies) {
309
309
  return {
310
310
  path: `/${path}`,
311
311
  method,
@@ -320,6 +320,7 @@ function buildResponseContext(path, method, requestHeaders, requestBody, respons
320
320
  headers: response.headers,
321
321
  body: responseBody
322
322
  },
323
+ cookies,
323
324
  setCookies: [],
324
325
  metadata: requestMetadata
325
326
  };
@@ -555,7 +556,8 @@ function createRpcProxy(config) {
555
556
  inputBody,
556
557
  response,
557
558
  body,
558
- requestCtx.metadata
559
+ requestCtx.metadata,
560
+ requestCtx.cookies
559
561
  );
560
562
  const responseInterceptorsToRun = matchingInterceptors.map((r) => r.response).filter((i) => !!i);
561
563
  if (responseInterceptorsToRun.length > 0) {
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/nextjs/shared.ts","../../src/nextjs/proxy/interceptors/helpers.ts","../../src/nextjs/proxy/interceptors/registry.ts","../../src/nextjs/proxy/helpers.ts","../../src/nextjs/proxy/rpc.ts"],"names":["headersToForward"],"mappings":"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","file":"server.js","sourcesContent":["/**\n * Shared utilities for Next.js client and proxy modules\n *\n * Contains common functions used by both client and proxy to avoid code duplication.\n */\n\n/**\n * Build URL with path parameters replaced\n *\n * @example\n * buildUrlWithParams('/users/:id/posts/:postId', { id: '123', postId: '456' })\n * // Returns: '/users/123/posts/456'\n */\nexport function buildUrlWithParams(path: string, params: Record<string, any>): string\n{\n let url = path;\n for (const [key, value] of Object.entries(params))\n {\n url = url.replace(`:${key}`, encodeURIComponent(String(value)));\n }\n\n return url;\n}\n\n/**\n * Build query string from object\n *\n * @example\n * buildQueryString({ page: '1', limit: '10', tags: ['foo', 'bar'] })\n * // Returns: '?page=1&limit=10&tags=foo&tags=bar'\n */\nexport function buildQueryString(query: Record<string, any>): string\n{\n if (Object.keys(query).length === 0)\n {\n return '';\n }\n\n const searchParams = new URLSearchParams();\n for (const [key, value] of Object.entries(query))\n {\n if (Array.isArray(value))\n {\n value.forEach((v) => searchParams.append(key, String(v)));\n }\n else\n {\n searchParams.append(key, String(value));\n }\n }\n\n return `?${searchParams.toString()}`;\n}\n\n/**\n * Build Cookie header string from cookies object\n *\n * @example\n * buildCookieHeader({ session: 'abc123', theme: 'dark' })\n * // Returns: 'session=abc123; theme=dark'\n */\nexport function buildCookieHeader(cookies: Record<string, string>): string\n{\n return Object.entries(cookies)\n .map(([key, value]) => `${key}=${value}`)\n .join('; ');\n}\n\n/**\n * Parse response body based on content type\n *\n * Handles:\n * - 204 No Content: returns null (no body expected)\n * - application/json: parses JSON body\n * - Other content types: returns raw text\n */\nexport async function parseResponseBody(response: Response): Promise<any>\n{\n // 204 No Content has no body\n if (response.status === 204)\n {\n return null;\n }\n\n const contentType = response.headers.get('content-type');\n\n if (contentType?.includes('application/json'))\n {\n const text = await response.text();\n return text ? JSON.parse(text) : null;\n }\n else\n {\n return await response.text();\n }\n}","/**\n * SPFN Next.js Proxy Interceptor Execution Engine\n */\n\nimport type {\n InterceptorRule,\n RequestInterceptor,\n ResponseInterceptor,\n RequestInterceptorContext,\n ResponseInterceptorContext,\n} from './types';\n\n/**\n * Check if path matches pattern\n *\n * Supports:\n * - Wildcards: '/_auth/*' matches '/_auth/login'\n * - Path params: '/users/:id' matches '/users/123'\n * - RegExp: /^\\/_auth\\/.+$/ matches '/_auth/login'\n * - Exact match: '/_auth/login' matches '/_auth/login'\n * - All: '*' matches any path\n *\n * @param path - Request path to test\n * @param pattern - Pattern to match against\n * @returns True if path matches pattern\n */\nexport function matchPath(path: string, pattern: string | RegExp): boolean\n{\n // Match all\n if (pattern === '*')\n {\n return true;\n }\n\n // RegExp pattern\n if (pattern instanceof RegExp)\n {\n return pattern.test(path);\n }\n\n // String pattern\n // Convert wildcard pattern to RegExp\n // '/_auth/*' -> /^\\/_auth\\/.*/\n // '/users/:id' -> /^\\/users\\/[^/]+$/\n const regexPattern = pattern\n .replace(/\\*/g, '.*')\n .replace(/:[^/]+/g, '[^/]+')\n .replace(/\\//g, '\\\\/');\n\n const regex = new RegExp(`^${regexPattern}$`);\n return regex.test(path);\n}\n\n/**\n * Check if method matches pattern\n *\n * @param method - Request method (e.g., 'POST')\n * @param pattern - Method pattern (e.g., 'POST' or ['POST', 'PUT'])\n * @returns True if method matches pattern\n */\nexport function matchMethod(\n method: string,\n pattern?: string | string[]\n): boolean\n{\n // No method filter = match all\n if (!pattern)\n {\n return true;\n }\n\n // Single method\n if (typeof pattern === 'string')\n {\n return method.toUpperCase() === pattern.toUpperCase();\n }\n\n // Multiple methods\n return pattern.some((m) => m.toUpperCase() === method.toUpperCase());\n}\n\n/**\n * Filter interceptors that match the request\n *\n * @param rules - All interceptor rules\n * @param path - Request path\n * @param method - Request method\n * @returns Matched interceptors\n */\nexport function filterMatchingInterceptors(\n rules: InterceptorRule[],\n path: string,\n method: string\n): InterceptorRule[]\n{\n return rules.filter((rule) => {\n return matchPath(path, rule.pathPattern) && matchMethod(method, rule.method);\n });\n}\n\n/**\n * Execute request interceptors in chain\n *\n * Interceptors are executed in order:\n * 1. First registered interceptor\n * 2. Second registered interceptor\n * 3. ... and so on\n *\n * Each interceptor must call next() to continue the chain.\n * If next() is not called, the chain stops and remaining interceptors are skipped.\n *\n * @param context - Request interceptor context\n * @param interceptors - Interceptors to execute\n */\nexport async function executeRequestInterceptors(\n context: RequestInterceptorContext,\n interceptors: RequestInterceptor[]\n): Promise<void>\n{\n let index = 0;\n\n const next = async (): Promise<void> => {\n if (index >= interceptors.length)\n {\n return;\n }\n\n const interceptor = interceptors[index];\n index++;\n\n await interceptor(context, next);\n };\n\n await next();\n}\n\n/**\n * Execute response interceptors in chain\n *\n * Interceptors are executed in order:\n * 1. First registered interceptor\n * 2. Second registered interceptor\n * 3. ... and so on\n *\n * Each interceptor must call next() to continue the chain.\n * If next() is not called, the chain stops and remaining interceptors are skipped.\n *\n * @param context - Response interceptor context\n * @param interceptors - Interceptors to execute\n */\nexport async function executeResponseInterceptors(\n context: ResponseInterceptorContext,\n interceptors: ResponseInterceptor[]\n): Promise<void>\n{\n let index = 0;\n\n const next = async (): Promise<void> => {\n if (index >= interceptors.length)\n {\n return;\n }\n\n const interceptor = interceptors[index];\n index++;\n\n await interceptor(context, next);\n };\n\n await next();\n}","/**\n * Global Interceptor Registry\n *\n * Allows packages to automatically register their interceptors\n * for Next.js proxy without manual configuration.\n *\n * Uses globalThis for persistence across module reloads (HMR).\n */\nimport type { InterceptorRule } from './types';\n\n// ============================================================================\n// Global Type Declarations\n// ============================================================================\n\n/**\n * Extend globalThis with interceptor registry\n *\n * Using globalThis allows the registry to persist across module reloads (HMR).\n * preventing duplicate registrations during development with HMR.\n */\ndeclare global\n{\n var __SPFN_INTERCEPTOR_REGISTRY__: InterceptorRegistry | undefined;\n}\n\n/**\n * Global interceptor registry\n *\n * Packages register their interceptors on import,\n * and proxy automatically discovers and applies them.\n */\nexport class InterceptorRegistry\n{\n private interceptors = new Map<string, InterceptorRule[]>();\n\n /**\n * Register interceptors for a package\n *\n * @param packageName - Unique package identifier (e.g., 'auth', 'storage')\n * @param interceptors - Array of interceptor rules\n *\n * @example\n * ```typescript\n * registerInterceptors('auth', [\n * {\n * pathPattern: '/_auth/*',\n * request: async (ctx, next) => { ... }\n * }\n * ]);\n * ```\n */\n register(packageName: string, interceptors: InterceptorRule[]): void\n {\n if (!this.interceptors.has(packageName))\n {\n this.interceptors.set(packageName, interceptors);\n }\n }\n\n /**\n * Get all registered interceptors\n *\n * @param exclude - Package names to exclude\n * @returns Flat array of all interceptor rules\n */\n getAll(exclude: string[] = []): InterceptorRule[]\n {\n const all: InterceptorRule[] = [];\n\n for (const [packageName, interceptors] of this.interceptors.entries())\n {\n if (!exclude.includes(packageName))\n {\n all.push(...interceptors);\n }\n }\n\n return all;\n }\n\n /**\n * Get interceptors for specific package\n *\n * @param packageName - Package identifier\n * @returns Interceptor rules or undefined\n */\n get(packageName: string): InterceptorRule[] | undefined\n {\n return this.interceptors.get(packageName);\n }\n\n /**\n * Get list of registered package names\n */\n getPackageNames(): string[]\n {\n return Array.from(this.interceptors.keys());\n }\n\n /**\n * Check if package has registered interceptors\n */\n has(packageName: string): boolean\n {\n return this.interceptors.has(packageName);\n }\n\n /**\n * Unregister interceptors for a package\n *\n * @param packageName - Package identifier\n */\n unregister(packageName: string): void\n {\n this.interceptors.delete(packageName);\n }\n\n /**\n * Clear all registered interceptors\n *\n * Useful for testing\n */\n clear(): void\n {\n this.interceptors.clear();\n }\n\n /**\n * Get total count of registered interceptors\n */\n count(): number\n {\n let total = 0;\n for (const interceptors of this.interceptors.values())\n {\n total += interceptors.length;\n }\n return total;\n }\n}\n\n/**\n * Global singleton registry instance\n *\n * Uses globalThis to persist across module reloads (HMR).\n * This prevents duplicate registrations during development.\n */\nexport const interceptorRegistry = (() =>\n{\n if (!globalThis.__SPFN_INTERCEPTOR_REGISTRY__)\n {\n globalThis.__SPFN_INTERCEPTOR_REGISTRY__ = new InterceptorRegistry();\n }\n\n return globalThis.__SPFN_INTERCEPTOR_REGISTRY__;\n})();\n\n/**\n * Register interceptors for a package\n *\n * This should be called during package initialization (on import).\n * The interceptors will be automatically applied by the Next.js proxy.\n *\n * @param packageName - Unique package identifier (e.g., 'auth', 'storage')\n * @param interceptors - Array of interceptor rules\n *\n * @example\n * ```typescript\n * // packages/auth/src/adapters/nextjs/interceptors/index.ts\n * import { registerInterceptors } from '@spfn/core/nextjs';\n *\n * const authInterceptors = [\n * {\n * pathPattern: '/_auth/*',\n * request: async (ctx, next) => {\n * // Add JWT token\n * ctx.headers['Authorization'] = 'Bearer token';\n * await next();\n * }\n * }\n * ];\n *\n * // Auto-register on import\n * registerInterceptors('auth', authInterceptors);\n * ```\n */\nexport function registerInterceptors(\n packageName: string,\n interceptors: InterceptorRule[]\n): void\n{\n interceptorRegistry.register(packageName, interceptors);\n}","/**\n * Helper functions for proxy handler\n * Separates utility logic from main proxy handler for better maintainability\n */\nimport { NextRequest } from 'next/server';\nimport type { CookieOptions, SetCookie } from \"../client\";\nimport type { InterceptorRule, RequestInterceptorContext, ResponseInterceptorContext } from './interceptors/types';\nimport type { InterceptorRegistry } from './interceptors';\n\n// Re-export from shared\nexport { parseResponseBody } from '../shared';\n\n/**\n * Build request headers for proxying\n * Forwards important headers from source and adds default headers\n *\n * @param sourceHeaders - Source headers (can be Headers object or Record)\n * @param defaultHeaders - Default headers to add\n */\nexport function buildProxyHeaders(\n sourceHeaders: Headers | Record<string, string>,\n defaultHeaders: Record<string, string>\n): Headers\n{\n const headers = new Headers();\n\n // Forward important headers from source\n const headersToForward = [\n 'content-type',\n 'authorization',\n 'cookie',\n 'user-agent',\n 'accept',\n 'accept-language',\n ];\n\n for (const header of headersToForward)\n {\n const value = sourceHeaders instanceof Headers\n ? sourceHeaders.get(header)\n : sourceHeaders[header];\n\n if (value)\n {\n headers.set(header, value);\n }\n }\n\n // Add default headers\n for (const [key, value] of Object.entries(defaultHeaders))\n {\n headers.set(key, value);\n }\n\n return headers;\n}\n\n/**\n * Parse cookies from Cookie header string\n *\n * @param cookieHeader - Cookie header string (e.g., \"session=abc; theme=dark\")\n * @returns Map of cookie name-value pairs\n */\nexport function parseCookies(cookieHeader: string | null | undefined): Map<string, string>\n{\n const cookiesMap = new Map<string, string>();\n\n if (!cookieHeader)\n {\n return cookiesMap;\n }\n\n const cookiePairs = cookieHeader.split(';').map(c => c.trim());\n for (const pair of cookiePairs)\n {\n const [name, ...valueParts] = pair.split('=');\n if (name && valueParts.length > 0)\n {\n const value = valueParts.join('='); // Handle = in cookie value\n cookiesMap.set(name.trim(), value.trim());\n }\n }\n\n return cookiesMap;\n}\n\n/**\n * Parse cookies from NextRequest (Next.js specific helper)\n * Combines cookies from both NextRequest.cookies and Cookie header\n */\nexport function parseCookiesFromNextRequest(request: NextRequest): Map<string, string>\n{\n const cookiesMap = new Map<string, string>();\n\n // Add cookies from NextRequest (browser cookies)\n for (const cookie of request.cookies.getAll())\n {\n cookiesMap.set(cookie.name, cookie.value);\n }\n\n // Add cookies from Cookie header (server-side forwarded cookies)\n const cookieHeader = request.headers.get('cookie');\n if (cookieHeader)\n {\n const parsed = parseCookies(cookieHeader);\n for (const [name, value] of parsed.entries())\n {\n cookiesMap.set(name, value);\n }\n }\n\n return cookiesMap;\n}\n\n// Mapping of option names to Set-Cookie attribute formats\nconst optionMappings: Array<{\n key: keyof CookieOptions;\n format: (value: any) => string | null;\n}> = [\n { key: 'httpOnly', format: (v) => v ? 'HttpOnly' : null },\n { key: 'secure', format: (v) => v ? 'Secure' : null },\n { key: 'sameSite', format: (v) => v ? `SameSite=${v}` : null },\n { key: 'maxAge', format: (v) => v !== undefined ? `Max-Age=${v}` : null },\n { key: 'path', format: (v) => v ? `Path=${v}` : null },\n { key: 'domain', format: (v) => v ? `Domain=${v}` : null },\n];\n\n/**\n * Build Set-Cookie header string from cookie options\n */\nexport function buildSetCookieHeader(cookie: SetCookie): string\n{\n const parts = [`${cookie.name}=${cookie.value}`];\n const options = cookie.options || {};\n\n for (const { key, format } of optionMappings)\n {\n const value = options[key];\n if (value !== undefined && value !== false)\n {\n const formatted = format(value);\n if (formatted)\n {\n parts.push(formatted);\n }\n }\n }\n\n return parts.join('; ');\n}\n\n/**\n * Build error response JSON\n */\nexport function buildErrorResponse(\n errorType: string,\n message: string,\n debug: boolean,\n error?: Error\n): any\n{\n return {\n error: errorType,\n message,\n ...(debug && error?.stack && { stack: error.stack }),\n };\n}\n\nconst headersToForward = [\n 'content-type',\n 'cache-control',\n 'set-cookie',\n 'etag',\n 'last-modified',\n];\n\n/**\n * Forward response headers back to client\n */\nexport function forwardResponseHeaders(\n sourceHeaders: Headers,\n targetHeaders: Headers\n): void\n{\n for (const header of headersToForward)\n {\n const value = sourceHeaders.get(header);\n if (value)\n {\n targetHeaders.set(header, value);\n }\n }\n}\n\n/**\n * Collect all interceptors (auto-discovered + config)\n */\nexport function collectInterceptors(\n autoDiscoverInterceptors: boolean,\n disableAutoInterceptors: string[] | undefined,\n configInterceptors: InterceptorRule[] | undefined,\n registry: InterceptorRegistry\n): InterceptorRule[]\n{\n const allInterceptors: InterceptorRule[] = [];\n\n // Auto-discover from registry\n if (autoDiscoverInterceptors)\n {\n const registeredInterceptors = registry.getAll(disableAutoInterceptors || []);\n allInterceptors.push(...registeredInterceptors);\n }\n\n // Add config interceptors\n if (configInterceptors)\n {\n allInterceptors.push(...configInterceptors);\n }\n\n return allInterceptors;\n}\n\n/**\n * Build RequestInterceptorContext\n */\nexport function buildRequestContext(\n path: string,\n method: string,\n headers: Headers,\n body: any,\n searchParams: URLSearchParams,\n cookiesMap: Map<string, string>,\n request: NextRequest\n): RequestInterceptorContext\n{\n return {\n path: `/${path}`,\n method,\n headers: Object.fromEntries(headers.entries()),\n body,\n query: Object.fromEntries(searchParams.entries()),\n cookies: cookiesMap,\n request,\n metadata: {},\n };\n}\n\n/**\n * Build ResponseInterceptorContext\n */\nexport function buildResponseContext(\n path: string,\n method: string,\n requestHeaders: Headers,\n requestBody: any,\n response: Response,\n responseBody: any,\n requestMetadata: Record<string, any>\n): ResponseInterceptorContext\n{\n return {\n path: `/${path}`,\n method,\n request: {\n headers: Object.fromEntries(requestHeaders.entries()),\n body: requestBody,\n },\n response: {\n ok: response.ok,\n status: response.status,\n statusText: response.statusText,\n headers: response.headers,\n body: responseBody,\n },\n setCookies: [],\n metadata: requestMetadata,\n };\n}","/**\n * RPC-Style Proxy for define-route System\n *\n * Next.js API Route handler that resolves routeName to method/path\n * and forwards requests to SPFN backend.\n *\n * @example Using routeMap (recommended - no server code loaded)\n * ```typescript\n * // app/api/rpc/[routeName]/route.ts\n * import { routeMap } from '@/generated/route-map';\n * import { createRpcProxy } from '@spfn/core/nextjs/proxy';\n *\n * export const { GET, POST } = createRpcProxy({ routeMap });\n * ```\n *\n * @example Using router (legacy - loads full server code)\n * ```typescript\n * // app/api/rpc/[routeName]/route.ts\n * import { appRouter } from '@/server/router';\n * import { createRpcProxy } from '@spfn/core/nextjs/proxy';\n *\n * export const { GET, POST } = createRpcProxy({ router: appRouter });\n * ```\n */\nimport { NextRequest, NextResponse } from 'next/server';\n\nimport { env } from '@spfn/core/config';\nimport { logger } from '@spfn/core/logger';\nimport type { Router, RouteDef, HttpMethod } from '@spfn/core/route';\n\nimport { buildUrlWithParams, buildQueryString } from '../shared';\nimport { interceptorRegistry } from './interceptors';\nimport { executeRequestInterceptors, executeResponseInterceptors, filterMatchingInterceptors } from './interceptors';\nimport {\n buildProxyHeaders,\n parseCookiesFromNextRequest,\n buildSetCookieHeader,\n buildErrorResponse,\n forwardResponseHeaders,\n parseResponseBody,\n collectInterceptors,\n buildRequestContext,\n buildResponseContext,\n} from './helpers';\nimport type { TypedProxyConfig } from \"./types\";\n\nconst rpcLogger = logger.child('@spfn/core:rpc-proxy');\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Route info from generated route map\n */\nexport interface RouteMapEntry\n{\n method: HttpMethod;\n path: string;\n}\n\n/**\n * Generated route map type\n */\nexport type RouteMap = Record<string, RouteMapEntry>;\n\n/**\n * Base config for RPC proxy\n */\ninterface RpcProxyBaseConfig extends Omit<TypedProxyConfig, 'onRequest' | 'onResponse'> {}\n\n/**\n * Config using routeMap (recommended)\n *\n * Uses generated route map file - no server code loaded in Next.js process.\n */\nexport interface RpcProxyRouteMapConfig extends RpcProxyBaseConfig\n{\n /**\n * Generated route map containing routeName → {method, path} mappings\n *\n * @example\n * ```typescript\n * import { routeMap } from '@/generated/route-map';\n *\n * export const { GET, POST } = createRpcProxy({ routeMap });\n * ```\n */\n routeMap: RouteMap;\n router?: never;\n}\n\n/**\n * Config using router (legacy)\n *\n * @deprecated Use routeMap instead to avoid loading server code in Next.js process\n */\nexport interface RpcProxyRouterConfig<TRouter extends Router<any>> extends RpcProxyBaseConfig\n{\n /**\n * The router containing all route definitions\n *\n * @deprecated Use routeMap instead - router imports all server code\n *\n * @example\n * ```typescript\n * export const { GET, POST } = createRpcProxy({\n * router: appRouter,\n * });\n * ```\n */\n router: TRouter;\n routeMap?: never;\n}\n\n/**\n * Combined config type\n */\nexport type RpcProxyConfig<TRouter extends Router<any> = Router<any>> =\n | RpcProxyRouteMapConfig\n | RpcProxyRouterConfig<TRouter>;\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Type guard to check if value is a RouteDef\n */\nfunction isRouteDef(value: unknown): value is RouteDef<any>\n{\n return value !== null &&\n typeof value === 'object' &&\n 'handler' in value &&\n 'method' in value &&\n 'path' in value;\n}\n\n/**\n * Type guard to check if value is a Router\n */\nfunction isRouter(value: unknown): value is Router<any>\n{\n return value !== null &&\n typeof value === 'object' &&\n 'routes' in value &&\n '_routes' in value;\n}\n\n/**\n * Get route definition from router by dotted path\n *\n * @example\n * getRouteByPath(router, 'users.getUser') → RouteDef\n * getRouteByPath(router, 'getUser') → RouteDef\n */\nfunction getRouteByPath(router: Router<any>, routePath: string): RouteDef<any> | null\n{\n const parts = routePath.split('.');\n let current: any = router.routes;\n\n for (const part of parts)\n {\n if (!current || typeof current !== 'object')\n {\n return null;\n }\n\n const next = current[part];\n\n if (isRouter(next))\n {\n current = next.routes;\n }\n else if (isRouteDef(next))\n {\n return next;\n }\n else\n {\n current = next;\n }\n }\n\n if (isRouteDef(current))\n {\n return current;\n }\n\n return null;\n}\n\n// ============================================================================\n// RPC Proxy Handler\n// ============================================================================\n\n/**\n * Create RPC proxy handler for Next.js API Route\n *\n * Handles requests in the format:\n * - GET /api/rpc/{routeName}?input={...}\n * - POST /api/rpc/{routeName} with body\n *\n * Resolves routeName to actual HTTP method and path from the router or routeMap,\n * then forwards to SPFN backend.\n */\nexport function createRpcProxy<TRouter extends Router<any>>(config: RpcProxyConfig<TRouter>)\n{\n const {\n apiUrl = env.SPFN_API_URL || 'http://localhost:8790',\n debug = env.NODE_ENV === 'development',\n timeout = 30000,\n headers: defaultHeaders = {},\n interceptors,\n autoDiscoverInterceptors = true,\n disableAutoInterceptors,\n } = config;\n\n // Determine if using routeMap or router\n const useRouteMap = 'routeMap' in config && config.routeMap !== undefined;\n const routeMap = useRouteMap ? config.routeMap : null;\n const router = !useRouteMap && 'router' in config ? config.router : null;\n\n // Get package routers (only when using router mode)\n const packageRouters = router?._packageRouters || [];\n\n /**\n * Resolve route info from routeMap or router\n */\n function resolveRoute(routeName: string): { method: string; path: string } | null\n {\n // Try routeMap first (recommended)\n if (routeMap)\n {\n const entry = routeMap[routeName];\n if (entry)\n {\n return { method: entry.method, path: entry.path };\n }\n return null;\n }\n\n // Fall back to router (legacy)\n if (router)\n {\n let routeDef = getRouteByPath(router, routeName);\n\n // If not found in main router, search in package routers\n if (!routeDef && packageRouters.length > 0)\n {\n for (const pkgRouter of packageRouters)\n {\n routeDef = getRouteByPath(pkgRouter, routeName);\n if (routeDef)\n {\n if (debug)\n {\n rpcLogger.debug(`Route \"${routeName}\" found in package router`);\n }\n break;\n }\n }\n }\n\n if (routeDef && routeDef.method && routeDef.path)\n {\n return { method: routeDef.method, path: routeDef.path };\n }\n }\n\n return null;\n }\n\n /**\n * Handle RPC request\n */\n async function handleRpc(\n request: NextRequest,\n context: { params: Promise<{ routeName?: string }> }\n ): Promise<NextResponse>\n {\n const startTime = Date.now();\n const params = await context.params;\n\n try\n {\n const routeName = params.routeName;\n\n if (!routeName)\n {\n return NextResponse.json(\n buildErrorResponse('Bad Request', 'Missing routeName parameter', debug),\n { status: 400 }\n );\n }\n\n // Parse input from query string (GET) or body (POST)\n let input: {\n params?: Record<string, any>;\n query?: Record<string, any>;\n body?: Record<string, any>;\n formData?: Record<string, any>;\n headers?: Record<string, any>;\n cookies?: Record<string, any>;\n } = {};\n let rawFormData: FormData | null = null;\n\n if (request.method === 'GET')\n {\n const inputParam = request.nextUrl.searchParams.get('input');\n if (inputParam)\n {\n try\n {\n input = JSON.parse(decodeURIComponent(inputParam));\n }\n catch\n {\n return NextResponse.json(\n buildErrorResponse('Bad Request', 'Invalid input parameter', debug),\n { status: 400 }\n );\n }\n }\n }\n else\n {\n // POST - check Content-Type for formData vs JSON\n const contentType = request.headers.get('content-type') || '';\n\n if (contentType.includes('multipart/form-data'))\n {\n // Parse multipart/form-data\n try\n {\n rawFormData = await request.formData();\n\n // Extract __metadata if present (contains params, query, etc.)\n const metadataStr = rawFormData.get('__metadata');\n if (metadataStr && typeof metadataStr === 'string')\n {\n const metadata = JSON.parse(metadataStr);\n input.params = metadata.params;\n input.query = metadata.query;\n input.headers = metadata.headers;\n input.cookies = metadata.cookies;\n }\n\n // Collect formData fields (excluding __metadata)\n input.formData = {};\n rawFormData.forEach((value, key) =>\n {\n if (key === '__metadata') return;\n\n const existing = input.formData![key];\n if (existing !== undefined)\n {\n // Multiple values with same key\n if (Array.isArray(existing))\n {\n existing.push(value);\n }\n else\n {\n input.formData![key] = [existing, value];\n }\n }\n else\n {\n input.formData![key] = value;\n }\n });\n }\n catch (error)\n {\n return NextResponse.json(\n buildErrorResponse('Bad Request', 'Invalid form data', debug),\n { status: 400 }\n );\n }\n }\n else\n {\n // Parse JSON body\n try\n {\n input = await request.json();\n }\n catch\n {\n return NextResponse.json(\n buildErrorResponse('Bad Request', 'Invalid JSON body', debug),\n { status: 400 }\n );\n }\n }\n }\n\n // Resolve route info from routeMap or router\n const routeInfo = resolveRoute(routeName);\n\n if (!routeInfo)\n {\n rpcLogger.warn(`Route not found: ${routeName}`);\n return NextResponse.json(\n buildErrorResponse('Not Found', `Route \"${routeName}\" not found`, debug),\n { status: 404 }\n );\n }\n\n const { method: targetMethod, path: targetPath } = routeInfo;\n\n // Build target URL with params and query\n const inputParams = input.params || {};\n const inputQuery = input.query || {};\n const inputBody = input.body;\n const inputFormData = input.formData;\n const hasFormData = rawFormData !== null && inputFormData && Object.keys(inputFormData).length > 0;\n\n const resolvedPath = buildUrlWithParams(targetPath, inputParams);\n const queryString = buildQueryString(inputQuery);\n const targetUrl = `${apiUrl}${resolvedPath}${queryString}`;\n\n if (debug)\n {\n rpcLogger.debug('→ RPC request', {\n routeName,\n targetMethod,\n targetPath: resolvedPath,\n targetUrl,\n hasBody: !!inputBody,\n hasFormData,\n });\n }\n\n // Build headers\n const headers = buildProxyHeaders(request.headers, defaultHeaders);\n\n // Remove Content-Type for formData (let fetch set it with boundary)\n if (hasFormData)\n {\n headers.delete('content-type');\n }\n\n // Build fetch options\n const fetchOptions: RequestInit = {\n method: targetMethod,\n headers,\n };\n\n // Add body for POST/PUT/PATCH\n if (['POST', 'PUT', 'PATCH'].includes(targetMethod))\n {\n if (hasFormData && rawFormData)\n {\n // Forward formData to backend (rebuild without __metadata)\n const forwardFormData = new FormData();\n rawFormData.forEach((value, key) =>\n {\n if (key !== '__metadata')\n {\n forwardFormData.append(key, value);\n }\n });\n fetchOptions.body = forwardFormData;\n }\n else if (inputBody)\n {\n fetchOptions.body = JSON.stringify(inputBody);\n }\n }\n\n // ============================================================\n // Advanced Interceptors - BEFORE FETCH\n // ============================================================\n\n // Collect and filter interceptors\n const allInterceptors = collectInterceptors(autoDiscoverInterceptors, disableAutoInterceptors, interceptors, interceptorRegistry);\n const matchingInterceptors = filterMatchingInterceptors(allInterceptors, resolvedPath, targetMethod);\n\n if (debug && matchingInterceptors.length > 0)\n {\n rpcLogger.debug(`🎯 Found ${matchingInterceptors.length} matching interceptors for ${targetMethod} ${resolvedPath}`);\n }\n\n // Create RequestInterceptorContext\n const cookiesMap = parseCookiesFromNextRequest(request);\n const requestCtx = buildRequestContext(\n resolvedPath.slice(1), // Remove leading slash\n targetMethod,\n headers,\n inputBody,\n new URLSearchParams(queryString.slice(1)), // Remove leading ?\n cookiesMap,\n request\n );\n\n // Execute request interceptors\n const requestInterceptorsToRun = matchingInterceptors.map(r => r.request).filter((i): i is NonNullable<typeof i> => !!i);\n if (requestInterceptorsToRun.length > 0)\n {\n await executeRequestInterceptors(requestCtx, requestInterceptorsToRun);\n\n // Apply modified headers\n for (const [key, value] of Object.entries(requestCtx.headers))\n {\n headers.set(key, value);\n }\n\n // Apply modified body\n if (requestCtx.body)\n {\n fetchOptions.body = JSON.stringify(requestCtx.body);\n }\n }\n\n // Execute fetch with timeout\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n try\n {\n const response = await fetch(targetUrl, {\n ...fetchOptions,\n signal: controller.signal,\n });\n\n clearTimeout(timeoutId);\n\n // Parse response\n let body = await parseResponseBody(response);\n\n // ============================================================\n // Advanced Interceptors - AFTER FETCH\n // ============================================================\n\n // Create ResponseInterceptorContext\n const responseCtx = buildResponseContext(\n resolvedPath.slice(1),\n targetMethod,\n headers,\n inputBody,\n response,\n body,\n requestCtx.metadata\n );\n\n // Execute response interceptors\n const responseInterceptorsToRun = matchingInterceptors.map(r => r.response).filter((i): i is NonNullable<typeof i> => !!i);\n if (responseInterceptorsToRun.length > 0)\n {\n await executeResponseInterceptors(responseCtx, responseInterceptorsToRun);\n body = responseCtx.response.body;\n }\n\n const duration = Date.now() - startTime;\n\n if (debug)\n {\n rpcLogger.debug('← RPC response', {\n routeName,\n status: responseCtx.response.status,\n duration: `${duration}ms`,\n });\n }\n\n // Build Next.js response\n // 204 No Content should use NextResponse directly, not NextResponse.json()\n const nextResponse = responseCtx.response.status === 204\n ? new NextResponse(null, {\n status: 204,\n statusText: responseCtx.response.statusText,\n })\n : NextResponse.json(body, {\n status: responseCtx.response.status,\n statusText: responseCtx.response.statusText,\n });\n\n // Forward response headers\n forwardResponseHeaders(response.headers, nextResponse.headers);\n\n // Apply setCookies from interceptors\n for (const cookie of responseCtx.setCookies)\n {\n const setCookieHeader = buildSetCookieHeader(cookie);\n nextResponse.headers.append('Set-Cookie', setCookieHeader);\n\n if (debug)\n {\n rpcLogger.debug('🍪 Set-Cookie header added', {\n name: cookie.name,\n });\n }\n }\n\n return nextResponse;\n }\n catch (error)\n {\n clearTimeout(timeoutId);\n\n // Handle timeout\n if (error instanceof Error && error.name === 'AbortError')\n {\n rpcLogger.error('Request timeout', {\n routeName,\n targetUrl,\n timeout,\n });\n\n return NextResponse.json(\n buildErrorResponse('Gateway Timeout', `Request timed out after ${timeout}ms`, debug, error),\n { status: 504 }\n );\n }\n\n // Handle other fetch errors\n const fetchErr = error as Error;\n rpcLogger.error('Fetch error', {\n routeName,\n targetUrl,\n error: fetchErr.message,\n });\n\n return NextResponse.json(\n buildErrorResponse('Bad Gateway', fetchErr.message || 'Failed to connect to backend', debug, fetchErr),\n { status: 502 }\n );\n }\n }\n catch (error)\n {\n const duration = Date.now() - startTime;\n const err = error as Error;\n\n rpcLogger.error('RPC proxy error', {\n error: err.message,\n stack: err.stack,\n duration: `${duration}ms`,\n });\n\n return NextResponse.json(\n buildErrorResponse('Internal Server Error', err.message || 'Unknown error', debug, err),\n { status: 500 }\n );\n }\n }\n\n // Return route handlers\n return {\n GET: (req: NextRequest, context: { params: Promise<{ routeName?: string }> }) =>\n handleRpc(req, context),\n POST: (req: NextRequest, context: { params: Promise<{ routeName?: string }> }) =>\n handleRpc(req, context),\n };\n}"]}
1
+ {"version":3,"sources":["../../src/nextjs/shared.ts","../../src/nextjs/proxy/interceptors/helpers.ts","../../src/nextjs/proxy/interceptors/registry.ts","../../src/nextjs/proxy/helpers.ts","../../src/nextjs/proxy/rpc.ts"],"names":["headersToForward"],"mappings":"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","file":"server.js","sourcesContent":["/**\n * Shared utilities for Next.js client and proxy modules\n *\n * Contains common functions used by both client and proxy to avoid code duplication.\n */\n\n/**\n * Build URL with path parameters replaced\n *\n * @example\n * buildUrlWithParams('/users/:id/posts/:postId', { id: '123', postId: '456' })\n * // Returns: '/users/123/posts/456'\n */\nexport function buildUrlWithParams(path: string, params: Record<string, any>): string\n{\n let url = path;\n for (const [key, value] of Object.entries(params))\n {\n url = url.replace(`:${key}`, encodeURIComponent(String(value)));\n }\n\n return url;\n}\n\n/**\n * Build query string from object\n *\n * @example\n * buildQueryString({ page: '1', limit: '10', tags: ['foo', 'bar'] })\n * // Returns: '?page=1&limit=10&tags=foo&tags=bar'\n */\nexport function buildQueryString(query: Record<string, any>): string\n{\n if (Object.keys(query).length === 0)\n {\n return '';\n }\n\n const searchParams = new URLSearchParams();\n for (const [key, value] of Object.entries(query))\n {\n if (Array.isArray(value))\n {\n value.forEach((v) => searchParams.append(key, String(v)));\n }\n else\n {\n searchParams.append(key, String(value));\n }\n }\n\n return `?${searchParams.toString()}`;\n}\n\n/**\n * Build Cookie header string from cookies object\n *\n * @example\n * buildCookieHeader({ session: 'abc123', theme: 'dark' })\n * // Returns: 'session=abc123; theme=dark'\n */\nexport function buildCookieHeader(cookies: Record<string, string>): string\n{\n return Object.entries(cookies)\n .map(([key, value]) => `${key}=${value}`)\n .join('; ');\n}\n\n/**\n * Parse response body based on content type\n *\n * Handles:\n * - 204 No Content: returns null (no body expected)\n * - application/json: parses JSON body\n * - Other content types: returns raw text\n */\nexport async function parseResponseBody(response: Response): Promise<any>\n{\n // 204 No Content has no body\n if (response.status === 204)\n {\n return null;\n }\n\n const contentType = response.headers.get('content-type');\n\n if (contentType?.includes('application/json'))\n {\n const text = await response.text();\n return text ? JSON.parse(text) : null;\n }\n else\n {\n return await response.text();\n }\n}","/**\n * SPFN Next.js Proxy Interceptor Execution Engine\n */\n\nimport type {\n InterceptorRule,\n RequestInterceptor,\n ResponseInterceptor,\n RequestInterceptorContext,\n ResponseInterceptorContext,\n} from './types';\n\n/**\n * Check if path matches pattern\n *\n * Supports:\n * - Wildcards: '/_auth/*' matches '/_auth/login'\n * - Path params: '/users/:id' matches '/users/123'\n * - RegExp: /^\\/_auth\\/.+$/ matches '/_auth/login'\n * - Exact match: '/_auth/login' matches '/_auth/login'\n * - All: '*' matches any path\n *\n * @param path - Request path to test\n * @param pattern - Pattern to match against\n * @returns True if path matches pattern\n */\nexport function matchPath(path: string, pattern: string | RegExp): boolean\n{\n // Match all\n if (pattern === '*')\n {\n return true;\n }\n\n // RegExp pattern\n if (pattern instanceof RegExp)\n {\n return pattern.test(path);\n }\n\n // String pattern\n // Convert wildcard pattern to RegExp\n // '/_auth/*' -> /^\\/_auth\\/.*/\n // '/users/:id' -> /^\\/users\\/[^/]+$/\n const regexPattern = pattern\n .replace(/\\*/g, '.*')\n .replace(/:[^/]+/g, '[^/]+')\n .replace(/\\//g, '\\\\/');\n\n const regex = new RegExp(`^${regexPattern}$`);\n return regex.test(path);\n}\n\n/**\n * Check if method matches pattern\n *\n * @param method - Request method (e.g., 'POST')\n * @param pattern - Method pattern (e.g., 'POST' or ['POST', 'PUT'])\n * @returns True if method matches pattern\n */\nexport function matchMethod(\n method: string,\n pattern?: string | string[]\n): boolean\n{\n // No method filter = match all\n if (!pattern)\n {\n return true;\n }\n\n // Single method\n if (typeof pattern === 'string')\n {\n return method.toUpperCase() === pattern.toUpperCase();\n }\n\n // Multiple methods\n return pattern.some((m) => m.toUpperCase() === method.toUpperCase());\n}\n\n/**\n * Filter interceptors that match the request\n *\n * @param rules - All interceptor rules\n * @param path - Request path\n * @param method - Request method\n * @returns Matched interceptors\n */\nexport function filterMatchingInterceptors(\n rules: InterceptorRule[],\n path: string,\n method: string\n): InterceptorRule[]\n{\n return rules.filter((rule) => {\n return matchPath(path, rule.pathPattern) && matchMethod(method, rule.method);\n });\n}\n\n/**\n * Execute request interceptors in chain\n *\n * Interceptors are executed in order:\n * 1. First registered interceptor\n * 2. Second registered interceptor\n * 3. ... and so on\n *\n * Each interceptor must call next() to continue the chain.\n * If next() is not called, the chain stops and remaining interceptors are skipped.\n *\n * @param context - Request interceptor context\n * @param interceptors - Interceptors to execute\n */\nexport async function executeRequestInterceptors(\n context: RequestInterceptorContext,\n interceptors: RequestInterceptor[]\n): Promise<void>\n{\n let index = 0;\n\n const next = async (): Promise<void> => {\n if (index >= interceptors.length)\n {\n return;\n }\n\n const interceptor = interceptors[index];\n index++;\n\n await interceptor(context, next);\n };\n\n await next();\n}\n\n/**\n * Execute response interceptors in chain\n *\n * Interceptors are executed in order:\n * 1. First registered interceptor\n * 2. Second registered interceptor\n * 3. ... and so on\n *\n * Each interceptor must call next() to continue the chain.\n * If next() is not called, the chain stops and remaining interceptors are skipped.\n *\n * @param context - Response interceptor context\n * @param interceptors - Interceptors to execute\n */\nexport async function executeResponseInterceptors(\n context: ResponseInterceptorContext,\n interceptors: ResponseInterceptor[]\n): Promise<void>\n{\n let index = 0;\n\n const next = async (): Promise<void> => {\n if (index >= interceptors.length)\n {\n return;\n }\n\n const interceptor = interceptors[index];\n index++;\n\n await interceptor(context, next);\n };\n\n await next();\n}","/**\n * Global Interceptor Registry\n *\n * Allows packages to automatically register their interceptors\n * for Next.js proxy without manual configuration.\n *\n * Uses globalThis for persistence across module reloads (HMR).\n */\nimport type { InterceptorRule } from './types';\n\n// ============================================================================\n// Global Type Declarations\n// ============================================================================\n\n/**\n * Extend globalThis with interceptor registry\n *\n * Using globalThis allows the registry to persist across module reloads (HMR).\n * preventing duplicate registrations during development with HMR.\n */\ndeclare global\n{\n var __SPFN_INTERCEPTOR_REGISTRY__: InterceptorRegistry | undefined;\n}\n\n/**\n * Global interceptor registry\n *\n * Packages register their interceptors on import,\n * and proxy automatically discovers and applies them.\n */\nexport class InterceptorRegistry\n{\n private interceptors = new Map<string, InterceptorRule[]>();\n\n /**\n * Register interceptors for a package\n *\n * @param packageName - Unique package identifier (e.g., 'auth', 'storage')\n * @param interceptors - Array of interceptor rules\n *\n * @example\n * ```typescript\n * registerInterceptors('auth', [\n * {\n * pathPattern: '/_auth/*',\n * request: async (ctx, next) => { ... }\n * }\n * ]);\n * ```\n */\n register(packageName: string, interceptors: InterceptorRule[]): void\n {\n if (!this.interceptors.has(packageName))\n {\n this.interceptors.set(packageName, interceptors);\n }\n }\n\n /**\n * Get all registered interceptors\n *\n * @param exclude - Package names to exclude\n * @returns Flat array of all interceptor rules\n */\n getAll(exclude: string[] = []): InterceptorRule[]\n {\n const all: InterceptorRule[] = [];\n\n for (const [packageName, interceptors] of this.interceptors.entries())\n {\n if (!exclude.includes(packageName))\n {\n all.push(...interceptors);\n }\n }\n\n return all;\n }\n\n /**\n * Get interceptors for specific package\n *\n * @param packageName - Package identifier\n * @returns Interceptor rules or undefined\n */\n get(packageName: string): InterceptorRule[] | undefined\n {\n return this.interceptors.get(packageName);\n }\n\n /**\n * Get list of registered package names\n */\n getPackageNames(): string[]\n {\n return Array.from(this.interceptors.keys());\n }\n\n /**\n * Check if package has registered interceptors\n */\n has(packageName: string): boolean\n {\n return this.interceptors.has(packageName);\n }\n\n /**\n * Unregister interceptors for a package\n *\n * @param packageName - Package identifier\n */\n unregister(packageName: string): void\n {\n this.interceptors.delete(packageName);\n }\n\n /**\n * Clear all registered interceptors\n *\n * Useful for testing\n */\n clear(): void\n {\n this.interceptors.clear();\n }\n\n /**\n * Get total count of registered interceptors\n */\n count(): number\n {\n let total = 0;\n for (const interceptors of this.interceptors.values())\n {\n total += interceptors.length;\n }\n return total;\n }\n}\n\n/**\n * Global singleton registry instance\n *\n * Uses globalThis to persist across module reloads (HMR).\n * This prevents duplicate registrations during development.\n */\nexport const interceptorRegistry = (() =>\n{\n if (!globalThis.__SPFN_INTERCEPTOR_REGISTRY__)\n {\n globalThis.__SPFN_INTERCEPTOR_REGISTRY__ = new InterceptorRegistry();\n }\n\n return globalThis.__SPFN_INTERCEPTOR_REGISTRY__;\n})();\n\n/**\n * Register interceptors for a package\n *\n * This should be called during package initialization (on import).\n * The interceptors will be automatically applied by the Next.js proxy.\n *\n * @param packageName - Unique package identifier (e.g., 'auth', 'storage')\n * @param interceptors - Array of interceptor rules\n *\n * @example\n * ```typescript\n * // packages/auth/src/adapters/nextjs/interceptors/index.ts\n * import { registerInterceptors } from '@spfn/core/nextjs';\n *\n * const authInterceptors = [\n * {\n * pathPattern: '/_auth/*',\n * request: async (ctx, next) => {\n * // Add JWT token\n * ctx.headers['Authorization'] = 'Bearer token';\n * await next();\n * }\n * }\n * ];\n *\n * // Auto-register on import\n * registerInterceptors('auth', authInterceptors);\n * ```\n */\nexport function registerInterceptors(\n packageName: string,\n interceptors: InterceptorRule[]\n): void\n{\n interceptorRegistry.register(packageName, interceptors);\n}","/**\n * Helper functions for proxy handler\n * Separates utility logic from main proxy handler for better maintainability\n */\nimport { NextRequest } from 'next/server';\nimport type { CookieOptions, SetCookie } from \"../client\";\nimport type { InterceptorRule, RequestInterceptorContext, ResponseInterceptorContext } from './interceptors/types';\nimport type { InterceptorRegistry } from './interceptors';\n\n// Re-export from shared\nexport { parseResponseBody } from '../shared';\n\n/**\n * Build request headers for proxying\n * Forwards important headers from source and adds default headers\n *\n * @param sourceHeaders - Source headers (can be Headers object or Record)\n * @param defaultHeaders - Default headers to add\n */\nexport function buildProxyHeaders(\n sourceHeaders: Headers | Record<string, string>,\n defaultHeaders: Record<string, string>\n): Headers\n{\n const headers = new Headers();\n\n // Forward important headers from source\n const headersToForward = [\n 'content-type',\n 'authorization',\n 'cookie',\n 'user-agent',\n 'accept',\n 'accept-language',\n ];\n\n for (const header of headersToForward)\n {\n const value = sourceHeaders instanceof Headers\n ? sourceHeaders.get(header)\n : sourceHeaders[header];\n\n if (value)\n {\n headers.set(header, value);\n }\n }\n\n // Add default headers\n for (const [key, value] of Object.entries(defaultHeaders))\n {\n headers.set(key, value);\n }\n\n return headers;\n}\n\n/**\n * Parse cookies from Cookie header string\n *\n * @param cookieHeader - Cookie header string (e.g., \"session=abc; theme=dark\")\n * @returns Map of cookie name-value pairs\n */\nexport function parseCookies(cookieHeader: string | null | undefined): Map<string, string>\n{\n const cookiesMap = new Map<string, string>();\n\n if (!cookieHeader)\n {\n return cookiesMap;\n }\n\n const cookiePairs = cookieHeader.split(';').map(c => c.trim());\n for (const pair of cookiePairs)\n {\n const [name, ...valueParts] = pair.split('=');\n if (name && valueParts.length > 0)\n {\n const value = valueParts.join('='); // Handle = in cookie value\n cookiesMap.set(name.trim(), value.trim());\n }\n }\n\n return cookiesMap;\n}\n\n/**\n * Parse cookies from NextRequest (Next.js specific helper)\n * Combines cookies from both NextRequest.cookies and Cookie header\n */\nexport function parseCookiesFromNextRequest(request: NextRequest): Map<string, string>\n{\n const cookiesMap = new Map<string, string>();\n\n // Add cookies from NextRequest (browser cookies)\n for (const cookie of request.cookies.getAll())\n {\n cookiesMap.set(cookie.name, cookie.value);\n }\n\n // Add cookies from Cookie header (server-side forwarded cookies)\n const cookieHeader = request.headers.get('cookie');\n if (cookieHeader)\n {\n const parsed = parseCookies(cookieHeader);\n for (const [name, value] of parsed.entries())\n {\n cookiesMap.set(name, value);\n }\n }\n\n return cookiesMap;\n}\n\n// Mapping of option names to Set-Cookie attribute formats\nconst optionMappings: Array<{\n key: keyof CookieOptions;\n format: (value: any) => string | null;\n}> = [\n { key: 'httpOnly', format: (v) => v ? 'HttpOnly' : null },\n { key: 'secure', format: (v) => v ? 'Secure' : null },\n { key: 'sameSite', format: (v) => v ? `SameSite=${v}` : null },\n { key: 'maxAge', format: (v) => v !== undefined ? `Max-Age=${v}` : null },\n { key: 'path', format: (v) => v ? `Path=${v}` : null },\n { key: 'domain', format: (v) => v ? `Domain=${v}` : null },\n];\n\n/**\n * Build Set-Cookie header string from cookie options\n */\nexport function buildSetCookieHeader(cookie: SetCookie): string\n{\n const parts = [`${cookie.name}=${cookie.value}`];\n const options = cookie.options || {};\n\n for (const { key, format } of optionMappings)\n {\n const value = options[key];\n if (value !== undefined && value !== false)\n {\n const formatted = format(value);\n if (formatted)\n {\n parts.push(formatted);\n }\n }\n }\n\n return parts.join('; ');\n}\n\n/**\n * Build error response JSON\n */\nexport function buildErrorResponse(\n errorType: string,\n message: string,\n debug: boolean,\n error?: Error\n): any\n{\n return {\n error: errorType,\n message,\n ...(debug && error?.stack && { stack: error.stack }),\n };\n}\n\nconst headersToForward = [\n 'content-type',\n 'cache-control',\n 'set-cookie',\n 'etag',\n 'last-modified',\n];\n\n/**\n * Forward response headers back to client\n */\nexport function forwardResponseHeaders(\n sourceHeaders: Headers,\n targetHeaders: Headers\n): void\n{\n for (const header of headersToForward)\n {\n const value = sourceHeaders.get(header);\n if (value)\n {\n targetHeaders.set(header, value);\n }\n }\n}\n\n/**\n * Collect all interceptors (auto-discovered + config)\n */\nexport function collectInterceptors(\n autoDiscoverInterceptors: boolean,\n disableAutoInterceptors: string[] | undefined,\n configInterceptors: InterceptorRule[] | undefined,\n registry: InterceptorRegistry\n): InterceptorRule[]\n{\n const allInterceptors: InterceptorRule[] = [];\n\n // Auto-discover from registry\n if (autoDiscoverInterceptors)\n {\n const registeredInterceptors = registry.getAll(disableAutoInterceptors || []);\n allInterceptors.push(...registeredInterceptors);\n }\n\n // Add config interceptors\n if (configInterceptors)\n {\n allInterceptors.push(...configInterceptors);\n }\n\n return allInterceptors;\n}\n\n/**\n * Build RequestInterceptorContext\n */\nexport function buildRequestContext(\n path: string,\n method: string,\n headers: Headers,\n body: any,\n searchParams: URLSearchParams,\n cookiesMap: Map<string, string>,\n request: NextRequest\n): RequestInterceptorContext\n{\n return {\n path: `/${path}`,\n method,\n headers: Object.fromEntries(headers.entries()),\n body,\n query: Object.fromEntries(searchParams.entries()),\n cookies: cookiesMap,\n request,\n metadata: {},\n };\n}\n\n/**\n * Build ResponseInterceptorContext\n */\nexport function buildResponseContext(\n path: string,\n method: string,\n requestHeaders: Headers,\n requestBody: any,\n response: Response,\n responseBody: any,\n requestMetadata: Record<string, any>,\n cookies: Map<string, string>\n): ResponseInterceptorContext\n{\n return {\n path: `/${path}`,\n method,\n request: {\n headers: Object.fromEntries(requestHeaders.entries()),\n body: requestBody,\n },\n response: {\n ok: response.ok,\n status: response.status,\n statusText: response.statusText,\n headers: response.headers,\n body: responseBody,\n },\n cookies,\n setCookies: [],\n metadata: requestMetadata,\n };\n}","/**\n * RPC-Style Proxy for define-route System\n *\n * Next.js API Route handler that resolves routeName to method/path\n * and forwards requests to SPFN backend.\n *\n * @example Using routeMap (recommended - no server code loaded)\n * ```typescript\n * // app/api/rpc/[routeName]/route.ts\n * import { routeMap } from '@/generated/route-map';\n * import { createRpcProxy } from '@spfn/core/nextjs/proxy';\n *\n * export const { GET, POST } = createRpcProxy({ routeMap });\n * ```\n *\n * @example Using router (legacy - loads full server code)\n * ```typescript\n * // app/api/rpc/[routeName]/route.ts\n * import { appRouter } from '@/server/router';\n * import { createRpcProxy } from '@spfn/core/nextjs/proxy';\n *\n * export const { GET, POST } = createRpcProxy({ router: appRouter });\n * ```\n */\nimport { NextRequest, NextResponse } from 'next/server';\n\nimport { env } from '@spfn/core/config';\nimport { logger } from '@spfn/core/logger';\nimport type { Router, RouteDef, HttpMethod } from '@spfn/core/route';\n\nimport { buildUrlWithParams, buildQueryString } from '../shared';\nimport { interceptorRegistry } from './interceptors';\nimport { executeRequestInterceptors, executeResponseInterceptors, filterMatchingInterceptors } from './interceptors';\nimport {\n buildProxyHeaders,\n parseCookiesFromNextRequest,\n buildSetCookieHeader,\n buildErrorResponse,\n forwardResponseHeaders,\n parseResponseBody,\n collectInterceptors,\n buildRequestContext,\n buildResponseContext,\n} from './helpers';\nimport type { TypedProxyConfig } from \"./types\";\n\nconst rpcLogger = logger.child('@spfn/core:rpc-proxy');\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Route info from generated route map\n */\nexport interface RouteMapEntry\n{\n method: HttpMethod;\n path: string;\n}\n\n/**\n * Generated route map type\n */\nexport type RouteMap = Record<string, RouteMapEntry>;\n\n/**\n * Base config for RPC proxy\n */\ninterface RpcProxyBaseConfig extends Omit<TypedProxyConfig, 'onRequest' | 'onResponse'> {}\n\n/**\n * Config using routeMap (recommended)\n *\n * Uses generated route map file - no server code loaded in Next.js process.\n */\nexport interface RpcProxyRouteMapConfig extends RpcProxyBaseConfig\n{\n /**\n * Generated route map containing routeName → {method, path} mappings\n *\n * @example\n * ```typescript\n * import { routeMap } from '@/generated/route-map';\n *\n * export const { GET, POST } = createRpcProxy({ routeMap });\n * ```\n */\n routeMap: RouteMap;\n router?: never;\n}\n\n/**\n * Config using router (legacy)\n *\n * @deprecated Use routeMap instead to avoid loading server code in Next.js process\n */\nexport interface RpcProxyRouterConfig<TRouter extends Router<any>> extends RpcProxyBaseConfig\n{\n /**\n * The router containing all route definitions\n *\n * @deprecated Use routeMap instead - router imports all server code\n *\n * @example\n * ```typescript\n * export const { GET, POST } = createRpcProxy({\n * router: appRouter,\n * });\n * ```\n */\n router: TRouter;\n routeMap?: never;\n}\n\n/**\n * Combined config type\n */\nexport type RpcProxyConfig<TRouter extends Router<any> = Router<any>> =\n | RpcProxyRouteMapConfig\n | RpcProxyRouterConfig<TRouter>;\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Type guard to check if value is a RouteDef\n */\nfunction isRouteDef(value: unknown): value is RouteDef<any>\n{\n return value !== null &&\n typeof value === 'object' &&\n 'handler' in value &&\n 'method' in value &&\n 'path' in value;\n}\n\n/**\n * Type guard to check if value is a Router\n */\nfunction isRouter(value: unknown): value is Router<any>\n{\n return value !== null &&\n typeof value === 'object' &&\n 'routes' in value &&\n '_routes' in value;\n}\n\n/**\n * Get route definition from router by dotted path\n *\n * @example\n * getRouteByPath(router, 'users.getUser') → RouteDef\n * getRouteByPath(router, 'getUser') → RouteDef\n */\nfunction getRouteByPath(router: Router<any>, routePath: string): RouteDef<any> | null\n{\n const parts = routePath.split('.');\n let current: any = router.routes;\n\n for (const part of parts)\n {\n if (!current || typeof current !== 'object')\n {\n return null;\n }\n\n const next = current[part];\n\n if (isRouter(next))\n {\n current = next.routes;\n }\n else if (isRouteDef(next))\n {\n return next;\n }\n else\n {\n current = next;\n }\n }\n\n if (isRouteDef(current))\n {\n return current;\n }\n\n return null;\n}\n\n// ============================================================================\n// RPC Proxy Handler\n// ============================================================================\n\n/**\n * Create RPC proxy handler for Next.js API Route\n *\n * Handles requests in the format:\n * - GET /api/rpc/{routeName}?input={...}\n * - POST /api/rpc/{routeName} with body\n *\n * Resolves routeName to actual HTTP method and path from the router or routeMap,\n * then forwards to SPFN backend.\n */\nexport function createRpcProxy<TRouter extends Router<any>>(config: RpcProxyConfig<TRouter>)\n{\n const {\n apiUrl = env.SPFN_API_URL || 'http://localhost:8790',\n debug = env.NODE_ENV === 'development',\n timeout = 30000,\n headers: defaultHeaders = {},\n interceptors,\n autoDiscoverInterceptors = true,\n disableAutoInterceptors,\n } = config;\n\n // Determine if using routeMap or router\n const useRouteMap = 'routeMap' in config && config.routeMap !== undefined;\n const routeMap = useRouteMap ? config.routeMap : null;\n const router = !useRouteMap && 'router' in config ? config.router : null;\n\n // Get package routers (only when using router mode)\n const packageRouters = router?._packageRouters || [];\n\n /**\n * Resolve route info from routeMap or router\n */\n function resolveRoute(routeName: string): { method: string; path: string } | null\n {\n // Try routeMap first (recommended)\n if (routeMap)\n {\n const entry = routeMap[routeName];\n if (entry)\n {\n return { method: entry.method, path: entry.path };\n }\n return null;\n }\n\n // Fall back to router (legacy)\n if (router)\n {\n let routeDef = getRouteByPath(router, routeName);\n\n // If not found in main router, search in package routers\n if (!routeDef && packageRouters.length > 0)\n {\n for (const pkgRouter of packageRouters)\n {\n routeDef = getRouteByPath(pkgRouter, routeName);\n if (routeDef)\n {\n if (debug)\n {\n rpcLogger.debug(`Route \"${routeName}\" found in package router`);\n }\n break;\n }\n }\n }\n\n if (routeDef && routeDef.method && routeDef.path)\n {\n return { method: routeDef.method, path: routeDef.path };\n }\n }\n\n return null;\n }\n\n /**\n * Handle RPC request\n */\n async function handleRpc(\n request: NextRequest,\n context: { params: Promise<{ routeName?: string }> }\n ): Promise<NextResponse>\n {\n const startTime = Date.now();\n const params = await context.params;\n\n try\n {\n const routeName = params.routeName;\n\n if (!routeName)\n {\n return NextResponse.json(\n buildErrorResponse('Bad Request', 'Missing routeName parameter', debug),\n { status: 400 }\n );\n }\n\n // Parse input from query string (GET) or body (POST)\n let input: {\n params?: Record<string, any>;\n query?: Record<string, any>;\n body?: Record<string, any>;\n formData?: Record<string, any>;\n headers?: Record<string, any>;\n cookies?: Record<string, any>;\n } = {};\n let rawFormData: FormData | null = null;\n\n if (request.method === 'GET')\n {\n const inputParam = request.nextUrl.searchParams.get('input');\n if (inputParam)\n {\n try\n {\n input = JSON.parse(decodeURIComponent(inputParam));\n }\n catch\n {\n return NextResponse.json(\n buildErrorResponse('Bad Request', 'Invalid input parameter', debug),\n { status: 400 }\n );\n }\n }\n }\n else\n {\n // POST - check Content-Type for formData vs JSON\n const contentType = request.headers.get('content-type') || '';\n\n if (contentType.includes('multipart/form-data'))\n {\n // Parse multipart/form-data\n try\n {\n rawFormData = await request.formData();\n\n // Extract __metadata if present (contains params, query, etc.)\n const metadataStr = rawFormData.get('__metadata');\n if (metadataStr && typeof metadataStr === 'string')\n {\n const metadata = JSON.parse(metadataStr);\n input.params = metadata.params;\n input.query = metadata.query;\n input.headers = metadata.headers;\n input.cookies = metadata.cookies;\n }\n\n // Collect formData fields (excluding __metadata)\n input.formData = {};\n rawFormData.forEach((value, key) =>\n {\n if (key === '__metadata') return;\n\n const existing = input.formData![key];\n if (existing !== undefined)\n {\n // Multiple values with same key\n if (Array.isArray(existing))\n {\n existing.push(value);\n }\n else\n {\n input.formData![key] = [existing, value];\n }\n }\n else\n {\n input.formData![key] = value;\n }\n });\n }\n catch (error)\n {\n return NextResponse.json(\n buildErrorResponse('Bad Request', 'Invalid form data', debug),\n { status: 400 }\n );\n }\n }\n else\n {\n // Parse JSON body\n try\n {\n input = await request.json();\n }\n catch\n {\n return NextResponse.json(\n buildErrorResponse('Bad Request', 'Invalid JSON body', debug),\n { status: 400 }\n );\n }\n }\n }\n\n // Resolve route info from routeMap or router\n const routeInfo = resolveRoute(routeName);\n\n if (!routeInfo)\n {\n rpcLogger.warn(`Route not found: ${routeName}`);\n return NextResponse.json(\n buildErrorResponse('Not Found', `Route \"${routeName}\" not found`, debug),\n { status: 404 }\n );\n }\n\n const { method: targetMethod, path: targetPath } = routeInfo;\n\n // Build target URL with params and query\n const inputParams = input.params || {};\n const inputQuery = input.query || {};\n const inputBody = input.body;\n const inputFormData = input.formData;\n const hasFormData = rawFormData !== null && inputFormData && Object.keys(inputFormData).length > 0;\n\n const resolvedPath = buildUrlWithParams(targetPath, inputParams);\n const queryString = buildQueryString(inputQuery);\n const targetUrl = `${apiUrl}${resolvedPath}${queryString}`;\n\n if (debug)\n {\n rpcLogger.debug('→ RPC request', {\n routeName,\n targetMethod,\n targetPath: resolvedPath,\n targetUrl,\n hasBody: !!inputBody,\n hasFormData,\n });\n }\n\n // Build headers\n const headers = buildProxyHeaders(request.headers, defaultHeaders);\n\n // Remove Content-Type for formData (let fetch set it with boundary)\n if (hasFormData)\n {\n headers.delete('content-type');\n }\n\n // Build fetch options\n const fetchOptions: RequestInit = {\n method: targetMethod,\n headers,\n };\n\n // Add body for POST/PUT/PATCH\n if (['POST', 'PUT', 'PATCH'].includes(targetMethod))\n {\n if (hasFormData && rawFormData)\n {\n // Forward formData to backend (rebuild without __metadata)\n const forwardFormData = new FormData();\n rawFormData.forEach((value, key) =>\n {\n if (key !== '__metadata')\n {\n forwardFormData.append(key, value);\n }\n });\n fetchOptions.body = forwardFormData;\n }\n else if (inputBody)\n {\n fetchOptions.body = JSON.stringify(inputBody);\n }\n }\n\n // ============================================================\n // Advanced Interceptors - BEFORE FETCH\n // ============================================================\n\n // Collect and filter interceptors\n const allInterceptors = collectInterceptors(autoDiscoverInterceptors, disableAutoInterceptors, interceptors, interceptorRegistry);\n const matchingInterceptors = filterMatchingInterceptors(allInterceptors, resolvedPath, targetMethod);\n\n if (debug && matchingInterceptors.length > 0)\n {\n rpcLogger.debug(`🎯 Found ${matchingInterceptors.length} matching interceptors for ${targetMethod} ${resolvedPath}`);\n }\n\n // Create RequestInterceptorContext\n const cookiesMap = parseCookiesFromNextRequest(request);\n const requestCtx = buildRequestContext(\n resolvedPath.slice(1), // Remove leading slash\n targetMethod,\n headers,\n inputBody,\n new URLSearchParams(queryString.slice(1)), // Remove leading ?\n cookiesMap,\n request\n );\n\n // Execute request interceptors\n const requestInterceptorsToRun = matchingInterceptors.map(r => r.request).filter((i): i is NonNullable<typeof i> => !!i);\n if (requestInterceptorsToRun.length > 0)\n {\n await executeRequestInterceptors(requestCtx, requestInterceptorsToRun);\n\n // Apply modified headers\n for (const [key, value] of Object.entries(requestCtx.headers))\n {\n headers.set(key, value);\n }\n\n // Apply modified body\n if (requestCtx.body)\n {\n fetchOptions.body = JSON.stringify(requestCtx.body);\n }\n }\n\n // Execute fetch with timeout\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n try\n {\n const response = await fetch(targetUrl, {\n ...fetchOptions,\n signal: controller.signal,\n });\n\n clearTimeout(timeoutId);\n\n // Parse response\n let body = await parseResponseBody(response);\n\n // ============================================================\n // Advanced Interceptors - AFTER FETCH\n // ============================================================\n\n // Create ResponseInterceptorContext\n const responseCtx = buildResponseContext(\n resolvedPath.slice(1),\n targetMethod,\n headers,\n inputBody,\n response,\n body,\n requestCtx.metadata,\n requestCtx.cookies\n );\n\n // Execute response interceptors\n const responseInterceptorsToRun = matchingInterceptors.map(r => r.response).filter((i): i is NonNullable<typeof i> => !!i);\n if (responseInterceptorsToRun.length > 0)\n {\n await executeResponseInterceptors(responseCtx, responseInterceptorsToRun);\n body = responseCtx.response.body;\n }\n\n const duration = Date.now() - startTime;\n\n if (debug)\n {\n rpcLogger.debug('← RPC response', {\n routeName,\n status: responseCtx.response.status,\n duration: `${duration}ms`,\n });\n }\n\n // Build Next.js response\n // 204 No Content should use NextResponse directly, not NextResponse.json()\n const nextResponse = responseCtx.response.status === 204\n ? new NextResponse(null, {\n status: 204,\n statusText: responseCtx.response.statusText,\n })\n : NextResponse.json(body, {\n status: responseCtx.response.status,\n statusText: responseCtx.response.statusText,\n });\n\n // Forward response headers\n forwardResponseHeaders(response.headers, nextResponse.headers);\n\n // Apply setCookies from interceptors\n for (const cookie of responseCtx.setCookies)\n {\n const setCookieHeader = buildSetCookieHeader(cookie);\n nextResponse.headers.append('Set-Cookie', setCookieHeader);\n\n if (debug)\n {\n rpcLogger.debug('🍪 Set-Cookie header added', {\n name: cookie.name,\n });\n }\n }\n\n return nextResponse;\n }\n catch (error)\n {\n clearTimeout(timeoutId);\n\n // Handle timeout\n if (error instanceof Error && error.name === 'AbortError')\n {\n rpcLogger.error('Request timeout', {\n routeName,\n targetUrl,\n timeout,\n });\n\n return NextResponse.json(\n buildErrorResponse('Gateway Timeout', `Request timed out after ${timeout}ms`, debug, error),\n { status: 504 }\n );\n }\n\n // Handle other fetch errors\n const fetchErr = error as Error;\n rpcLogger.error('Fetch error', {\n routeName,\n targetUrl,\n error: fetchErr.message,\n });\n\n return NextResponse.json(\n buildErrorResponse('Bad Gateway', fetchErr.message || 'Failed to connect to backend', debug, fetchErr),\n { status: 502 }\n );\n }\n }\n catch (error)\n {\n const duration = Date.now() - startTime;\n const err = error as Error;\n\n rpcLogger.error('RPC proxy error', {\n error: err.message,\n stack: err.stack,\n duration: `${duration}ms`,\n });\n\n return NextResponse.json(\n buildErrorResponse('Internal Server Error', err.message || 'Unknown error', debug, err),\n { status: 500 }\n );\n }\n }\n\n // Return route handlers\n return {\n GET: (req: NextRequest, context: { params: Promise<{ routeName?: string }> }) =>\n handleRpc(req, context),\n POST: (req: NextRequest, context: { params: Promise<{ routeName?: string }> }) =>\n handleRpc(req, context),\n };\n}"]}
@@ -202,6 +202,11 @@ interface ApiConfig {
202
202
  * Per-call options
203
203
  */
204
204
  interface CallOptions {
205
+ /**
206
+ * Request timeout in milliseconds
207
+ * Overrides the global timeout set in ApiConfig
208
+ */
209
+ timeout?: number;
205
210
  /**
206
211
  * Additional headers for this request
207
212
  */
package/docs/event.md CHANGED
@@ -1,116 +1,335 @@
1
1
  # Event
2
2
 
3
- In-process event system for decoupled communication.
3
+ Decoupled pub/sub event system with SSE support for real-time frontend updates.
4
4
 
5
5
  ## Define Events
6
6
 
7
7
  ```typescript
8
8
  // src/server/events/index.ts
9
- import { defineEvent, defineEventHandler } from '@spfn/core/event';
10
-
11
- // Define event types
12
- export const userCreated = defineEvent<{
13
- userId: string;
14
- email: string;
15
- }>('user.created');
16
-
17
- export const userUpdated = defineEvent<{
18
- userId: string;
19
- changes: Record<string, any>;
20
- }>('user.updated');
21
-
22
- export const userDeleted = defineEvent<{
23
- userId: string;
24
- }>('user.deleted');
9
+ import { defineEvent } from '@spfn/core/event';
10
+ import { Type } from '@sinclair/typebox';
11
+
12
+ // Event with typed payload
13
+ export const userCreated = defineEvent('user.created', Type.Object({
14
+ userId: Type.String(),
15
+ email: Type.String(),
16
+ }));
17
+
18
+ export const orderPlaced = defineEvent('order.placed', Type.Object({
19
+ orderId: Type.String(),
20
+ amount: Type.Number(),
21
+ }));
22
+
23
+ // Event without payload
24
+ export const serverStarted = defineEvent('server.started');
25
25
  ```
26
26
 
27
- ## Emit Events
27
+ ## Subscribe & Emit
28
28
 
29
29
  ```typescript
30
- import { emit } from '@spfn/core/event';
31
- import { userCreated } from './events';
30
+ import { userCreated, serverStarted } from './events';
32
31
 
33
- // In repository or service
34
- async function createUser(data: NewUser)
35
- {
36
- const user = await this._create(users, data);
32
+ // Subscribe to event
33
+ const unsubscribe = userCreated.subscribe((payload) => {
34
+ console.log('User created:', payload.userId);
35
+ });
37
36
 
38
- await emit(userCreated, {
39
- userId: user.id,
40
- email: user.email
41
- });
37
+ // Emit event
38
+ await userCreated.emit({ userId: '123', email: 'user@example.com' });
42
39
 
43
- return user;
44
- }
40
+ // Emit event without payload
41
+ await serverStarted.emit();
42
+
43
+ // Unsubscribe when done
44
+ unsubscribe();
45
45
  ```
46
46
 
47
- ## Handle Events
47
+ ## Multiple Subscribers
48
48
 
49
49
  ```typescript
50
- import { on } from '@spfn/core/event';
51
- import { userCreated, userDeleted } from './events';
50
+ // Multiple independent handlers
51
+ userCreated.subscribe(async (payload) => {
52
+ await sendWelcomeEmail(payload.email);
53
+ });
54
+
55
+ userCreated.subscribe(async (payload) => {
56
+ await createDefaultSettings(payload.userId);
57
+ });
52
58
 
53
- // Register handlers
54
- on(userCreated, async (payload) => {
55
- // Send welcome email
56
- await emailService.sendWelcome(payload.email);
59
+ userCreated.subscribe(async (payload) => {
60
+ await notifyAdmins(payload.userId);
57
61
  });
58
62
 
59
- on(userCreated, async (payload) => {
60
- // Create default settings
61
- await settingsRepo.createDefaults(payload.userId);
63
+ // All handlers execute when event is emitted
64
+ await userCreated.emit({ userId: '123', email: 'user@example.com' });
65
+ ```
66
+
67
+ ## Event Router for SSE
68
+
69
+ ```typescript
70
+ // src/server/events/router.ts
71
+ import { defineEventRouter } from '@spfn/core/event';
72
+ import { userCreated, orderPlaced } from './index';
73
+
74
+ export const eventRouter = defineEventRouter({
75
+ userCreated,
76
+ orderPlaced,
77
+ });
78
+
79
+ export type EventRouter = typeof eventRouter;
80
+ ```
81
+
82
+ ## Server Setup
83
+
84
+ ```typescript
85
+ // server.config.ts
86
+ import { defineServerConfig } from '@spfn/core/server';
87
+ import { eventRouter } from './events/router';
88
+
89
+ export default defineServerConfig()
90
+ .routes(appRouter)
91
+ .jobs(jobRouter)
92
+ .events(eventRouter) // → GET /events/stream
93
+ .build();
94
+
95
+ // Custom path and options
96
+ .events(eventRouter, {
97
+ path: '/sse', // Custom endpoint path
98
+ pingInterval: 30000, // Keep-alive interval (default: 30s)
99
+ })
100
+ ```
101
+
102
+ ## Browser Client
103
+
104
+ ```typescript
105
+ import { createSSEClient } from '@spfn/core/event/sse/client';
106
+ import type { EventRouter } from '@/server/events/router';
107
+
108
+ // Create client (uses defaults: NEXT_PUBLIC_SPFN_API_URL + /events/stream)
109
+ const client = createSSEClient<EventRouter>();
110
+
111
+ // Or with custom configuration
112
+ const client = createSSEClient<EventRouter>({
113
+ host: 'https://api.example.com',
114
+ pathname: '/sse',
115
+ reconnect: true,
116
+ reconnectDelay: 3000,
62
117
  });
63
118
 
64
- on(userDeleted, async (payload) => {
65
- // Cleanup related data
66
- await cleanupUserData(payload.userId);
119
+ // Subscribe to events
120
+ const unsubscribe = client.subscribe({
121
+ events: ['userCreated', 'orderPlaced'],
122
+ handlers: {
123
+ userCreated: (payload) => {
124
+ console.log('New user:', payload.userId);
125
+ },
126
+ orderPlaced: (payload) => {
127
+ console.log('New order:', payload.orderId);
128
+ },
129
+ },
130
+ onOpen: () => console.log('SSE connected'),
131
+ onError: (err) => console.error('SSE error:', err),
67
132
  });
133
+
134
+ // Cleanup
135
+ unsubscribe();
68
136
  ```
69
137
 
70
- ## Handler Registration
138
+ ## Simple Subscribe Helper
71
139
 
72
140
  ```typescript
73
- // src/server/events/handlers.ts
74
- import { on } from '@spfn/core/event';
75
- import { userCreated, userUpdated, userDeleted } from './index';
141
+ import { subscribeToEvents } from '@spfn/core/event/sse/client';
142
+ import type { EventRouter } from '@/server/events/router';
143
+
144
+ // One-liner subscription
145
+ const unsubscribe = subscribeToEvents<EventRouter>(
146
+ ['userCreated'],
147
+ {
148
+ userCreated: (payload) => console.log('User:', payload),
149
+ }
150
+ );
151
+ ```
152
+
153
+ ## Job Integration
154
+
155
+ ```typescript
156
+ import { defineEvent } from '@spfn/core/event';
157
+ import { job, defineJobRouter } from '@spfn/core/job';
158
+
159
+ // Define event
160
+ export const orderPlaced = defineEvent('order.placed', Type.Object({
161
+ orderId: Type.String(),
162
+ userId: Type.String(),
163
+ }));
164
+
165
+ // Jobs subscribe to event
166
+ export const sendOrderConfirmation = job('send-order-confirmation')
167
+ .on(orderPlaced)
168
+ .handler(async (payload) => {
169
+ await emailService.sendOrderConfirmation(payload.orderId);
170
+ });
171
+
172
+ export const updateInventory = job('update-inventory')
173
+ .on(orderPlaced)
174
+ .handler(async (payload) => {
175
+ await inventoryService.reserve(payload.orderId);
176
+ });
76
177
 
77
- // Register all handlers
78
- export function registerEventHandlers()
178
+ // Register jobs
179
+ export const jobRouter = defineJobRouter({
180
+ sendOrderConfirmation,
181
+ updateInventory,
182
+ });
183
+
184
+ // Emit event - all subscribed jobs execute
185
+ await orderPlaced.emit({ orderId: 'ord-123', userId: 'user-456' });
186
+ ```
187
+
188
+ ## Multi-Instance Support
189
+
190
+ For applications running multiple instances, use cache-based pub/sub.
191
+
192
+ ```typescript
193
+ import { defineEvent } from '@spfn/core/event';
194
+ import { getCache } from '@spfn/core/cache';
195
+
196
+ const userCreated = defineEvent('user.created', Type.Object({
197
+ userId: Type.String(),
198
+ }));
199
+
200
+ // Enable cache-based pub/sub
201
+ const cache = getCache();
202
+ if (cache)
79
203
  {
80
- on(userCreated, handleUserCreated);
81
- on(userUpdated, handleUserUpdated);
82
- on(userDeleted, handleUserDeleted);
204
+ await userCreated.useCache({
205
+ publish: async (channel, message) => {
206
+ await cache.publish(channel, JSON.stringify(message));
207
+ },
208
+ subscribe: async (channel, handler) => {
209
+ const subscriber = cache.duplicate();
210
+ await subscriber.subscribe(channel);
211
+ subscriber.on('message', (ch, msg) => {
212
+ if (ch === channel)
213
+ {
214
+ handler(JSON.parse(msg));
215
+ }
216
+ });
217
+ },
218
+ });
83
219
  }
84
220
 
85
- // Call in server startup
86
- import { registerEventHandlers } from './events/handlers';
87
- registerEventHandlers();
221
+ // Events now broadcast to all instances
222
+ await userCreated.emit({ userId: '123' });
88
223
  ```
89
224
 
90
- ## Best Practices
225
+ ## API Reference
226
+
227
+ ### defineEvent(name)
228
+
229
+ Define an event without payload.
91
230
 
92
231
  ```typescript
93
- // 1. Define events in a central location
94
- // src/server/events/index.ts
232
+ export const serverStarted = defineEvent('server.started');
233
+
234
+ serverStarted.subscribe(() => { ... });
235
+ await serverStarted.emit();
236
+ ```
95
237
 
96
- // 2. Use descriptive event names
238
+ ### defineEvent(name, schema)
239
+
240
+ Define an event with typed payload.
241
+
242
+ ```typescript
243
+ export const userCreated = defineEvent('user.created', Type.Object({
244
+ userId: Type.String(),
245
+ }));
246
+
247
+ userCreated.subscribe((payload) => { ... });
248
+ await userCreated.emit({ userId: '123' });
249
+ ```
250
+
251
+ ### EventDef Methods
252
+
253
+ | Method | Description |
254
+ |--------|-------------|
255
+ | `subscribe(handler)` | Subscribe to event. Returns unsubscribe function |
256
+ | `unsubscribeAll()` | Remove all subscribers |
257
+ | `emit(payload?)` | Emit event to all subscribers |
258
+ | `useCache(cache)` | Enable cache-based pub/sub for multi-instance |
259
+
260
+ ### SSE Client Options
261
+
262
+ | Option | Type | Default | Description |
263
+ |--------|------|---------|-------------|
264
+ | `host` | string | `NEXT_PUBLIC_SPFN_API_URL` | Backend API host URL |
265
+ | `pathname` | string | `/events/stream` | SSE endpoint pathname |
266
+ | `reconnect` | boolean | `true` | Auto reconnect on disconnect |
267
+ | `reconnectDelay` | number | `3000` | Reconnect delay (ms) |
268
+ | `maxReconnectAttempts` | number | `0` | Max attempts (0 = infinite) |
269
+ | `withCredentials` | boolean | `false` | Include cookies |
270
+
271
+ ## Event Flow Architecture
272
+
273
+ ```
274
+ userCreated.emit({ ... })
275
+
276
+ ┌───────────────────┼───────────────────┐
277
+ ▼ ▼ ▼
278
+ ┌──────────┐ ┌──────────┐ ┌──────────┐
279
+ │ Backend │ │ Job │ │ SSE │
280
+ │ Handler │ │ Queue │ │ Stream │
281
+ └──────────┘ └──────────┘ └──────────┘
282
+ .subscribe() .on(event) ↓
283
+ │ │ ┌──────────┐
284
+ ▼ ▼ │ Browser │
285
+ [Logging, [Background │ Client │
286
+ Analytics] Processing] └──────────┘
287
+ ```
288
+
289
+ ## Best Practices
290
+
291
+ ```typescript
292
+ // 1. Use descriptive event names
97
293
  defineEvent('user.created')
98
294
  defineEvent('order.completed')
99
295
  defineEvent('payment.failed')
100
296
 
101
- // 3. Keep payloads minimal
102
- defineEvent<{ userId: string }>('user.deleted') // Just ID, not full user
297
+ // 2. Keep payloads minimal - just IDs, not full objects
298
+ defineEvent('user.deleted', Type.Object({
299
+ userId: Type.String(),
300
+ }));
103
301
 
104
- // 4. Handle errors in handlers
105
- on(userCreated, async (payload) => {
106
- try {
107
- await sendEmail(payload.email);
108
- } catch (error) {
109
- logger.error('Failed to send email', { error });
110
- }
302
+ // 3. Handler errors are isolated - one failing handler doesn't affect others
303
+ userCreated.subscribe(async (payload) => {
304
+ throw new Error('This fails');
305
+ });
306
+
307
+ userCreated.subscribe(async (payload) => {
308
+ // This still executes
309
+ console.log('Handler 2 runs');
111
310
  });
112
311
 
113
- // 5. Use events for side effects, not core logic
312
+ // 4. Use events for side effects, not core logic
114
313
  // Core: await userRepo.create(data);
115
- // Side effect: emit(userCreated, { ... });
314
+ // Side effect: await userCreated.emit({ ... });
315
+
316
+ // 5. Await useCache() before emitting for multi-instance
317
+ await userCreated.useCache(cache);
318
+ await userCreated.emit({ userId: '123' });
116
319
  ```
320
+
321
+ ## Event vs Direct Job
322
+
323
+ | Aspect | Event + Job | Direct Job |
324
+ |--------|-------------|------------|
325
+ | Coupling | Loose (producer doesn't know consumers) | Tight (producer calls specific job) |
326
+ | Multiple consumers | Easy (multiple jobs subscribe) | Manual (call each job) |
327
+ | Extensibility | Add consumers without modifying producer | Modify producer for each consumer |
328
+
329
+ **Use Event when:**
330
+ - Multiple systems need to react to the same occurrence
331
+ - You want to decouple producers from consumers
332
+
333
+ **Use Direct Job when:**
334
+ - Single, known consumer
335
+ - Simpler mental model preferred
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@spfn/core",
3
- "version": "0.2.0-beta.11",
3
+ "version": "0.2.0-beta.12",
4
4
  "description": "SPFN Framework Core - File-based routing, transactions, repository pattern",
5
5
  "type": "module",
6
6
  "exports": {