@flight-framework/core 0.3.2 → 0.5.0

package/dist/chunk-77MJZCYD.js

@@ -0,0 +1,354 @@
+// src/adapters/handler.ts
+function createUniversalHandler(options = {}) {
+  const {
+    manifest,
+    routeRules = {},
+    basePath = "",
+    onError = defaultErrorHandler,
+    onNotFound = defaultNotFoundHandler,
+    hooks = {}
+  } = options;
+  return {
+    /**
+     * Handle incoming request
+     */
+    async fetch(request, env, ctx) {
+      try {
+        if (hooks.beforeHandle) {
+          const modifiedRequest = await hooks.beforeHandle(request);
+          if (modifiedRequest) request = modifiedRequest;
+        }
+        const url = new URL(request.url);
+        let pathname = url.pathname;
+        if (basePath && pathname.startsWith(basePath)) {
+          pathname = pathname.slice(basePath.length) || "/";
+        }
+        const rules = matchRouteRules(pathname, routeRules);
+        if (rules?.redirect) {
+          return handleRedirect(rules.redirect);
+        }
+        if (rules?.proxy) {
+          return handleProxy(request, rules.proxy);
+        }
+        if (request.method === "OPTIONS" && rules?.cors) {
+          return handleCorsPreFlight(rules.cors);
+        }
+        const route = manifest?.routes?.find((r) => matchPath(pathname, r.path));
+        if (!route) {
+          return await onNotFound(request);
+        }
+        const context = {
+          url,
+          params: extractParams(pathname, route.path),
+          headers: request.headers,
+          method: request.method
+        };
+        if (hooks.beforeRender) {
+          await hooks.beforeRender(context);
+        }
+        let response;
+        switch (route.mode) {
+          case "ssr":
+          case "isr":
+            response = await handleSSR(context, options);
+            break;
+          case "ssg":
+            response = await handleSSG(context, options);
+            break;
+          case "csr":
+            response = handleCSR(options);
+            break;
+          default:
+            response = await handleSSR(context, options);
+        }
+        if (rules?.cache) {
+          response = applyCacheHeaders(response, rules.cache);
+        }
+        if (rules?.cors) {
+          response = applyCorsHeaders(response, rules.cors, request);
+        }
+        if (rules?.headers) {
+          response = applyCustomHeaders(response, rules.headers);
+        }
+        if (hooks.afterHandle) {
+          const modifiedResponse = await hooks.afterHandle(request, response);
+          if (modifiedResponse) response = modifiedResponse;
+        }
+        return response;
+      } catch (error) {
+        return onError(error, request);
+      }
+    },
+    /**
+     * Check if this handler can handle the request
+     */
+    canHandle(request) {
+      const url = new URL(request.url);
+      let pathname = url.pathname;
+      if (basePath && pathname.startsWith(basePath)) {
+        pathname = pathname.slice(basePath.length) || "/";
+      }
+      if (manifest?.routes) {
+        return manifest.routes.some((r) => matchPath(pathname, r.path));
+      }
+      return Object.keys(routeRules).some(
+        (pattern) => matchPath(pathname, pattern)
+      );
+    }
+  };
+}
+function defaultErrorHandler(error, _request) {
+  console.error("[Flight] Request error:", error);
+  return new Response(
+    JSON.stringify({
+      error: "Internal Server Error",
+      message: process.env.NODE_ENV === "development" ? error.message : void 0
+    }),
+    {
+      status: 500,
+      headers: { "Content-Type": "application/json" }
+    }
+  );
+}
+function defaultNotFoundHandler(_request) {
+  return new Response("Not Found", { status: 404 });
+}
+function matchRouteRules(pathname, rules) {
+  for (const [pattern, config] of Object.entries(rules)) {
+    if (matchPath(pathname, pattern)) {
+      return config;
+    }
+  }
+  return null;
+}
+function matchPath(pathname, pattern) {
+  if (pattern === pathname) return true;
+  if (pattern.endsWith("/**")) {
+    const prefix = pattern.slice(0, -3);
+    return pathname.startsWith(prefix);
+  }
+  if (pattern.endsWith("/*")) {
+    const prefix = pattern.slice(0, -2);
+    const rest = pathname.slice(prefix.length);
+    return pathname.startsWith(prefix) && !rest.includes("/");
+  }
+  const patternParts = pattern.split("/");
+  const pathParts = pathname.split("/");
+  if (patternParts.length !== pathParts.length) return false;
+  return patternParts.every((part, i) => {
+    if (part.startsWith("[") && part.endsWith("]")) return true;
+    if (part.startsWith(":")) return true;
+    return part === pathParts[i];
+  });
+}
+function extractParams(pathname, pattern) {
+  const params = {};
+  const patternParts = pattern.split("/");
+  const pathParts = pathname.split("/");
+  patternParts.forEach((part, i) => {
+    if (part.startsWith("[") && part.endsWith("]")) {
+      const key = part.slice(1, -1).replace("...", "");
+      params[key] = pathParts[i] ?? "";
+    } else if (part.startsWith(":")) {
+      params[part.slice(1)] = pathParts[i] ?? "";
+    }
+  });
+  return params;
+}
+function handleRedirect(redirect) {
+  const to = typeof redirect === "string" ? redirect : redirect.to;
+  const status = typeof redirect === "string" ? 302 : redirect.statusCode ?? 302;
+  return new Response(null, {
+    status,
+    headers: { Location: to }
+  });
+}
+async function handleProxy(request, target) {
+  const url = new URL(request.url);
+  const targetUrl = new URL(target);
+  targetUrl.pathname = url.pathname;
+  targetUrl.search = url.search;
+  const proxyRequest = new Request(targetUrl.toString(), {
+    method: request.method,
+    headers: request.headers,
+    body: request.body
+  });
+  return fetch(proxyRequest);
+}
+function handleCorsPreFlight(cors) {
+  const options = cors === true ? {} : cors || {};
+  return new Response(null, {
+    status: 204,
+    headers: {
+      "Access-Control-Allow-Origin": resolveOrigin(options.origin),
+      "Access-Control-Allow-Methods": (options.methods ?? ["GET", "POST", "PUT", "DELETE", "PATCH"]).join(", "),
+      "Access-Control-Allow-Headers": (options.allowedHeaders ?? ["Content-Type", "Authorization"]).join(", "),
+      "Access-Control-Max-Age": String(options.maxAge ?? 86400),
+      ...options.credentials && { "Access-Control-Allow-Credentials": "true" }
+    }
+  });
+}
+function resolveOrigin(origin) {
+  if (origin === true || origin === void 0) return "*";
+  if (origin === false) return "*";
+  if (Array.isArray(origin)) return origin[0] ?? "*";
+  return origin;
+}
+function applyCacheHeaders(response, cache) {
+  const headers = new Headers(response.headers);
+  let cacheControl = `public, max-age=${cache.maxAge ?? 0}`;
+  if (cache.swr) {
+    cacheControl += `, stale-while-revalidate=${cache.swr}`;
+  }
+  headers.set("Cache-Control", cacheControl);
+  return new Response(response.body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers
+  });
+}
+function applyCorsHeaders(response, cors, _request) {
+  const options = cors === true ? {} : cors || {};
+  const headers = new Headers(response.headers);
+  headers.set("Access-Control-Allow-Origin", resolveOrigin(options.origin));
+  if (options.credentials) {
+    headers.set("Access-Control-Allow-Credentials", "true");
+  }
+  if (options.exposedHeaders) {
+    headers.set("Access-Control-Expose-Headers", options.exposedHeaders.join(", "));
+  }
+  return new Response(response.body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers
+  });
+}
+function applyCustomHeaders(response, customHeaders) {
+  const headers = new Headers(response.headers);
+  for (const [key, value] of Object.entries(customHeaders)) {
+    headers.set(key, value);
+  }
+  return new Response(response.body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers
+  });
+}
+async function handleSSR(context, options) {
+  const { framework, hooks } = options;
+  if (!framework) {
+    return new Response(createPlaceholderHTML(context.url.pathname), {
+      headers: { "Content-Type": "text/html; charset=utf-8" }
+    });
+  }
+  let result = await framework.renderToString({}, context);
+  if (hooks?.afterRender) {
+    const modifiedResult = await hooks.afterRender(result);
+    if (modifiedResult) result = modifiedResult;
+  }
+  return new Response(result.html, {
+    status: result.status,
+    headers: result.headers
+  });
+}
+async function handleSSG(context, options) {
+  return handleSSR(context, options);
+}
+function handleCSR(options) {
+  const html = `<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Flight App</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/assets/client.js"></script>
+  </body>
+</html>`;
+  return new Response(html, {
+    headers: { "Content-Type": "text/html; charset=utf-8" }
+  });
+}
+function createPlaceholderHTML(pathname) {
+  return `<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Flight</title>
+    <style>
+      body { font-family: system-ui, sans-serif; display: flex; align-items: center; justify-content: center; min-height: 100vh; margin: 0; background: #0a0a0a; color: #fafafa; }
+      .container { text-align: center; }
+      h1 { font-size: 3rem; margin-bottom: 0.5rem; }
+      p { color: #888; }
+      code { background: #1a1a1a; padding: 0.25rem 0.5rem; border-radius: 4px; font-size: 0.875rem; }
+    </style>
+  </head>
+  <body>
+    <div class="container">
+      <h1>Flight</h1>
+      <p>Path: <code>${pathname}</code></p>
+      <p>Configure a UI framework adapter to enable SSR.</p>
+    </div>
+  </body>
+</html>`;
+}
+
+// src/adapters/validation.ts
+function createValidatedAdapter(name, schema, factory) {
+  return (rawOptions = {}) => {
+    const parseResult = schema.safeParse(rawOptions);
+    if (!parseResult.success) {
+      const errorMessage = formatValidationError(name, parseResult.error);
+      throw new Error(errorMessage);
+    }
+    const validatedOptions = parseResult.data;
+    const adapterConfig = factory(validatedOptions);
+    return {
+      name,
+      adapt: adapterConfig.adapt,
+      emulate: adapterConfig.emulate,
+      supports: adapterConfig.supports
+    };
+  };
+}
+function validateAdapterOptions(schema, options) {
+  const result = schema.safeParse(options);
+  return result.success ? result.data : null;
+}
+function assertValidOptions(name, schema, options) {
+  const result = schema.safeParse(options);
+  if (!result.success) {
+    throw new Error(formatValidationError(name, result.error));
+  }
+  return result.data;
+}
+function formatValidationError(adapterName, error) {
+  const prefix = `[${adapterName}] Invalid adapter options`;
+  if (error && typeof error === "object" && "issues" in error) {
+    const zodError = error;
+    const issues = zodError.issues.map((issue) => `  - ${issue.path.join(".")}: ${issue.message}`).join("\n");
+    return `${prefix}:
+${issues}`;
+  }
+  if (error instanceof Error) {
+    return `${prefix}: ${error.message}`;
+  }
+  return `${prefix}: Unknown validation error`;
+}
+
+// src/adapters/index.ts
+function createAdapter(options) {
+  return {
+    name: options.name,
+    adapt: options.adapt,
+    emulate: options.emulate,
+    supports: options.supports
+  };
+}
+
+export { assertValidOptions, createAdapter, createUniversalHandler, createValidatedAdapter, validateAdapterOptions };
+//# sourceMappingURL=chunk-77MJZCYD.js.map
+//# sourceMappingURL=chunk-77MJZCYD.js.map

package/dist/chunk-77MJZCYD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/handler.ts","../src/adapters/validation.ts","../src/adapters/index.ts"],"names":[],"mappings":"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","file":"chunk-77MJZCYD.js","sourcesContent":["/**\r\n * Flight Universal Handler - Platform-agnostic request handler\r\n * \r\n * This is the core abstraction that allows Flight applications to run anywhere.\r\n * Adapters can use this handler, or implement their own - zero lock-in.\r\n * \r\n * @module @flight-framework/core/adapters/handler\r\n */\r\n\r\nimport type { RenderContext, RenderResult, UIFrameworkAdapter } from '../render/index.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Route rules for per-path configuration\r\n * Similar to Nitro's routeRules - completely optional to use\r\n */\r\nexport interface RouteRules {\r\n    [pattern: string]: RouteRuleConfig;\r\n}\r\n\r\nexport interface RouteRuleConfig {\r\n    /** Cache configuration */\r\n    cache?: {\r\n        /** Max age in seconds */\r\n        maxAge?: number;\r\n        /** Stale-while-revalidate in seconds */\r\n        swr?: number;\r\n        /** Vary headers */\r\n        vary?: string[];\r\n    };\r\n\r\n    /** CORS configuration */\r\n    cors?: boolean | CorsOptions;\r\n\r\n    /** Headers to add to response */\r\n    headers?: Record<string, string>;\r\n\r\n    /** Redirect configuration */\r\n    redirect?: string | {\r\n        to: string;\r\n        statusCode?: 301 | 302 | 303 | 307 | 308;\r\n    };\r\n\r\n    /** Proxy to another URL */\r\n    proxy?: string;\r\n\r\n    /** Render mode override */\r\n    render?: 'ssr' | 'ssg' | 'csr' | 'isr';\r\n\r\n    /** ISR revalidation time in seconds */\r\n    isr?: number;\r\n\r\n    /** Prerender at build time */\r\n    prerender?: boolean;\r\n}\r\n\r\nexport interface CorsOptions {\r\n    origin?: string | string[] | boolean;\r\n    methods?: string[];\r\n    allowedHeaders?: string[];\r\n    exposedHeaders?: string[];\r\n    credentials?: boolean;\r\n    maxAge?: number;\r\n}\r\n\r\n/**\r\n * Handler options - all optional, user configures what they need\r\n */\r\nexport interface UniversalHandlerOptions {\r\n    /** Route manifest from build */\r\n    manifest?: RouteManifest;\r\n\r\n    /** UI framework adapter (optional - for SSR) */\r\n    framework?: UIFrameworkAdapter;\r\n\r\n    /** Route rules (optional) */\r\n    routeRules?: RouteRules;\r\n\r\n    /** Static files directory (optional) */\r\n    staticDir?: string;\r\n\r\n    /** Base path (optional) */\r\n    basePath?: string;\r\n\r\n    /** Custom error handler (optional) */\r\n    onError?: (error: Error, request: Request) => Response | Promise<Response>;\r\n\r\n    /** Custom not found handler (optional) */\r\n    onNotFound?: (request: Request) => Response | Promise<Response>;\r\n\r\n    /** Hooks for extensibility (optional) */\r\n    hooks?: HandlerHooks;\r\n}\r\n\r\n/**\r\n * Handler hooks for extensibility - all optional\r\n */\r\nexport interface HandlerHooks {\r\n    /** Before handling request */\r\n    beforeHandle?: (request: Request) => Request | Promise<Request> | void;\r\n\r\n    /** After getting response, before sending */\r\n    afterHandle?: (request: Request, response: Response) => Response | Promise<Response> | void;\r\n\r\n    /** Before SSR render */\r\n    beforeRender?: (context: RenderContext) => void | Promise<void>;\r\n\r\n    /** After SSR render */\r\n    afterRender?: (result: RenderResult) => RenderResult | Promise<RenderResult>;\r\n}\r\n\r\n/**\r\n * Route manifest from build\r\n */\r\nexport interface RouteManifest {\r\n    routes: Array<{\r\n        path: string;\r\n        component: string;\r\n        mode: 'ssr' | 'ssg' | 'csr' | 'isr';\r\n        handler?: string;\r\n    }>;\r\n    staticFiles?: string[];\r\n}\r\n\r\n/**\r\n * Universal handler interface\r\n */\r\nexport interface UniversalHandler {\r\n    /** Handle a fetch request */\r\n    fetch(request: Request, env?: unknown, ctx?: unknown): Promise<Response>;\r\n\r\n    /** Check if this handler can handle the request */\r\n    canHandle(request: Request): boolean;\r\n}\r\n\r\n// ============================================================================\r\n// Handler Factory\r\n// ============================================================================\r\n\r\n/**\r\n * Create a universal request handler\r\n * \r\n * This is the main abstraction for handling requests.\r\n * Adapters can use this, extend it, or ignore it completely.\r\n * \r\n * @example\r\n * ```typescript\r\n * // Using the handler (optional)\r\n * import { createUniversalHandler } from '@flight-framework/core/adapters';\r\n * \r\n * const handler = createUniversalHandler({\r\n *   manifest: await import('./manifest.json'),\r\n *   routeRules: {\r\n *     '/api/**': { cors: true },\r\n *     '/blog/**': { cache: { maxAge: 3600 } },\r\n *   },\r\n * });\r\n * \r\n * // In your adapter\r\n * export default {\r\n *   fetch: handler.fetch,\r\n * };\r\n * ```\r\n */\r\nexport function createUniversalHandler(options: UniversalHandlerOptions = {}): UniversalHandler {\r\n    const {\r\n        manifest,\r\n        routeRules = {},\r\n        basePath = '',\r\n        onError = defaultErrorHandler,\r\n        onNotFound = defaultNotFoundHandler,\r\n        hooks = {},\r\n    } = options;\r\n\r\n    return {\r\n        /**\r\n         * Handle incoming request\r\n         */\r\n        async fetch(request: Request, env?: unknown, ctx?: unknown): Promise<Response> {\r\n            try {\r\n                // Run beforeHandle hook\r\n                if (hooks.beforeHandle) {\r\n                    const modifiedRequest = await hooks.beforeHandle(request);\r\n                    if (modifiedRequest) request = modifiedRequest;\r\n                }\r\n\r\n                const url = new URL(request.url);\r\n                let pathname = url.pathname;\r\n\r\n                // Strip base path if present\r\n                if (basePath && pathname.startsWith(basePath)) {\r\n                    pathname = pathname.slice(basePath.length) || '/';\r\n                }\r\n\r\n                // Apply route rules\r\n                const rules = matchRouteRules(pathname, routeRules);\r\n\r\n                // Handle redirect rules\r\n                if (rules?.redirect) {\r\n                    return handleRedirect(rules.redirect);\r\n                }\r\n\r\n                // Handle proxy rules\r\n                if (rules?.proxy) {\r\n                    return handleProxy(request, rules.proxy);\r\n                }\r\n\r\n                // Handle CORS preflight\r\n                if (request.method === 'OPTIONS' && rules?.cors) {\r\n                    return handleCorsPreFlight(rules.cors);\r\n                }\r\n\r\n                // Find matching route from manifest\r\n                const route = manifest?.routes?.find(r => matchPath(pathname, r.path));\r\n\r\n                // No matching route - try static or return 404\r\n                if (!route) {\r\n                    return await onNotFound(request);\r\n                }\r\n\r\n                // Build render context\r\n                const context: RenderContext = {\r\n                    url,\r\n                    params: extractParams(pathname, route.path),\r\n                    headers: request.headers,\r\n                    method: request.method,\r\n                };\r\n\r\n                // Run beforeRender hook\r\n                if (hooks.beforeRender) {\r\n                    await hooks.beforeRender(context);\r\n                }\r\n\r\n                // Generate response based on route mode\r\n                let response: Response;\r\n\r\n                switch (route.mode) {\r\n                    case 'ssr':\r\n                    case 'isr':\r\n                        response = await handleSSR(context, options);\r\n                        break;\r\n                    case 'ssg':\r\n                        response = await handleSSG(context, options);\r\n                        break;\r\n                    case 'csr':\r\n                        response = handleCSR(options);\r\n                        break;\r\n                    default:\r\n                        response = await handleSSR(context, options);\r\n                }\r\n\r\n                // Apply cache headers from route rules\r\n                if (rules?.cache) {\r\n                    response = applyCacheHeaders(response, rules.cache);\r\n                }\r\n\r\n                // Apply CORS headers\r\n                if (rules?.cors) {\r\n                    response = applyCorsHeaders(response, rules.cors, request);\r\n                }\r\n\r\n                // Apply custom headers\r\n                if (rules?.headers) {\r\n                    response = applyCustomHeaders(response, rules.headers);\r\n                }\r\n\r\n                // Run afterHandle hook\r\n                if (hooks.afterHandle) {\r\n                    const modifiedResponse = await hooks.afterHandle(request, response);\r\n                    if (modifiedResponse) response = modifiedResponse;\r\n                }\r\n\r\n                return response;\r\n\r\n            } catch (error) {\r\n                return onError(error as Error, request);\r\n            }\r\n        },\r\n\r\n        /**\r\n         * Check if this handler can handle the request\r\n         */\r\n        canHandle(request: Request): boolean {\r\n            const url = new URL(request.url);\r\n            let pathname = url.pathname;\r\n\r\n            if (basePath && pathname.startsWith(basePath)) {\r\n                pathname = pathname.slice(basePath.length) || '/';\r\n            }\r\n\r\n            // Check manifest routes\r\n            if (manifest?.routes) {\r\n                return manifest.routes.some(r => matchPath(pathname, r.path));\r\n            }\r\n\r\n            // Check route rules\r\n            return Object.keys(routeRules).some(pattern =>\r\n                matchPath(pathname, pattern)\r\n            );\r\n        },\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Internal Helpers\r\n// ============================================================================\r\n\r\nfunction defaultErrorHandler(error: Error, _request: Request): Response {\r\n    console.error('[Flight] Request error:', error);\r\n\r\n    return new Response(\r\n        JSON.stringify({\r\n            error: 'Internal Server Error',\r\n            message: process.env.NODE_ENV === 'development' ? error.message : undefined,\r\n        }),\r\n        {\r\n            status: 500,\r\n            headers: { 'Content-Type': 'application/json' },\r\n        }\r\n    );\r\n}\r\n\r\nfunction defaultNotFoundHandler(_request: Request): Response {\r\n    return new Response('Not Found', { status: 404 });\r\n}\r\n\r\nfunction matchRouteRules(pathname: string, rules: RouteRules): RouteRuleConfig | null {\r\n    for (const [pattern, config] of Object.entries(rules)) {\r\n        if (matchPath(pathname, pattern)) {\r\n            return config;\r\n        }\r\n    }\r\n    return null;\r\n}\r\n\r\nfunction matchPath(pathname: string, pattern: string): boolean {\r\n    // Handle exact match\r\n    if (pattern === pathname) return true;\r\n\r\n    // Handle wildcard patterns\r\n    if (pattern.endsWith('/**')) {\r\n        const prefix = pattern.slice(0, -3);\r\n        return pathname.startsWith(prefix);\r\n    }\r\n\r\n    if (pattern.endsWith('/*')) {\r\n        const prefix = pattern.slice(0, -2);\r\n        const rest = pathname.slice(prefix.length);\r\n        return pathname.startsWith(prefix) && !rest.includes('/');\r\n    }\r\n\r\n    // Handle dynamic params\r\n    const patternParts = pattern.split('/');\r\n    const pathParts = pathname.split('/');\r\n\r\n    if (patternParts.length !== pathParts.length) return false;\r\n\r\n    return patternParts.every((part, i) => {\r\n        if (part.startsWith('[') && part.endsWith(']')) return true;\r\n        if (part.startsWith(':')) return true;\r\n        return part === pathParts[i];\r\n    });\r\n}\r\n\r\nfunction extractParams(pathname: string, pattern: string): Record<string, string> {\r\n    const params: Record<string, string> = {};\r\n    const patternParts = pattern.split('/');\r\n    const pathParts = pathname.split('/');\r\n\r\n    patternParts.forEach((part, i) => {\r\n        if (part.startsWith('[') && part.endsWith(']')) {\r\n            const key = part.slice(1, -1).replace('...', '');\r\n            params[key] = pathParts[i] ?? '';\r\n        } else if (part.startsWith(':')) {\r\n            params[part.slice(1)] = pathParts[i] ?? '';\r\n        }\r\n    });\r\n\r\n    return params;\r\n}\r\n\r\nfunction handleRedirect(redirect: string | { to: string; statusCode?: number }): Response {\r\n    const to = typeof redirect === 'string' ? redirect : redirect.to;\r\n    const status = typeof redirect === 'string' ? 302 : (redirect.statusCode ?? 302);\r\n\r\n    return new Response(null, {\r\n        status,\r\n        headers: { Location: to },\r\n    });\r\n}\r\n\r\nasync function handleProxy(request: Request, target: string): Promise<Response> {\r\n    const url = new URL(request.url);\r\n    const targetUrl = new URL(target);\r\n    targetUrl.pathname = url.pathname;\r\n    targetUrl.search = url.search;\r\n\r\n    const proxyRequest = new Request(targetUrl.toString(), {\r\n        method: request.method,\r\n        headers: request.headers,\r\n        body: request.body,\r\n    });\r\n\r\n    return fetch(proxyRequest);\r\n}\r\n\r\nfunction handleCorsPreFlight(cors: boolean | CorsOptions): Response {\r\n    // Normalize CORS options - true means default options, object means custom\r\n    const options: CorsOptions = cors === true ? {} : (cors || {});\r\n\r\n    return new Response(null, {\r\n        status: 204,\r\n        headers: {\r\n            'Access-Control-Allow-Origin': resolveOrigin(options.origin),\r\n            'Access-Control-Allow-Methods': (options.methods ?? ['GET', 'POST', 'PUT', 'DELETE', 'PATCH']).join(', '),\r\n            'Access-Control-Allow-Headers': (options.allowedHeaders ?? ['Content-Type', 'Authorization']).join(', '),\r\n            'Access-Control-Max-Age': String(options.maxAge ?? 86400),\r\n            ...(options.credentials && { 'Access-Control-Allow-Credentials': 'true' }),\r\n        },\r\n    });\r\n}\r\n\r\nfunction resolveOrigin(origin?: string | string[] | boolean): string {\r\n    if (origin === true || origin === undefined) return '*';\r\n    if (origin === false) return '*';\r\n    if (Array.isArray(origin)) return origin[0] ?? '*';\r\n    return origin;\r\n}\r\n\r\nfunction applyCacheHeaders(response: Response, cache: { maxAge?: number; swr?: number }): Response {\r\n    const headers = new Headers(response.headers);\r\n\r\n    let cacheControl = `public, max-age=${cache.maxAge ?? 0}`;\r\n    if (cache.swr) {\r\n        cacheControl += `, stale-while-revalidate=${cache.swr}`;\r\n    }\r\n\r\n    headers.set('Cache-Control', cacheControl);\r\n\r\n    return new Response(response.body, {\r\n        status: response.status,\r\n        statusText: response.statusText,\r\n        headers,\r\n    });\r\n}\r\n\r\nfunction applyCorsHeaders(response: Response, cors: boolean | CorsOptions, _request: Request): Response {\r\n    // Normalize CORS options\r\n    const options: CorsOptions = cors === true ? {} : (cors || {});\r\n    const headers = new Headers(response.headers);\r\n\r\n    headers.set('Access-Control-Allow-Origin', resolveOrigin(options.origin));\r\n\r\n    if (options.credentials) {\r\n        headers.set('Access-Control-Allow-Credentials', 'true');\r\n    }\r\n\r\n    if (options.exposedHeaders) {\r\n        headers.set('Access-Control-Expose-Headers', options.exposedHeaders.join(', '));\r\n    }\r\n\r\n    return new Response(response.body, {\r\n        status: response.status,\r\n        statusText: response.statusText,\r\n        headers,\r\n    });\r\n}\r\n\r\nfunction applyCustomHeaders(response: Response, customHeaders: Record<string, string>): Response {\r\n    const headers = new Headers(response.headers);\r\n\r\n    for (const [key, value] of Object.entries(customHeaders)) {\r\n        headers.set(key, value);\r\n    }\r\n\r\n    return new Response(response.body, {\r\n        status: response.status,\r\n        statusText: response.statusText,\r\n        headers,\r\n    });\r\n}\r\n\r\nasync function handleSSR(context: RenderContext, options: UniversalHandlerOptions): Promise<Response> {\r\n    const { framework, hooks } = options;\r\n\r\n    // If no framework adapter, return placeholder\r\n    if (!framework) {\r\n        return new Response(createPlaceholderHTML(context.url.pathname), {\r\n            headers: { 'Content-Type': 'text/html; charset=utf-8' },\r\n        });\r\n    }\r\n\r\n    // Render with framework adapter\r\n    let result = await framework.renderToString({} as never, context);\r\n\r\n    // Run afterRender hook\r\n    if (hooks?.afterRender) {\r\n        const modifiedResult = await hooks.afterRender(result);\r\n        if (modifiedResult) result = modifiedResult;\r\n    }\r\n\r\n    return new Response(result.html, {\r\n        status: result.status,\r\n        headers: result.headers,\r\n    });\r\n}\r\n\r\nasync function handleSSG(context: RenderContext, options: UniversalHandlerOptions): Promise<Response> {\r\n    // For SSG, typically serve pre-rendered HTML\r\n    // Fall back to SSR if not found\r\n    return handleSSR(context, options);\r\n}\r\n\r\nfunction handleCSR(options: UniversalHandlerOptions): Response {\r\n    const html = `<!DOCTYPE html>\r\n<html>\r\n  <head>\r\n    <meta charset=\"UTF-8\">\r\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\r\n    <title>Flight App</title>\r\n  </head>\r\n  <body>\r\n    <div id=\"app\"></div>\r\n    <script type=\"module\" src=\"/assets/client.js\"></script>\r\n  </body>\r\n</html>`;\r\n\r\n    return new Response(html, {\r\n        headers: { 'Content-Type': 'text/html; charset=utf-8' },\r\n    });\r\n}\r\n\r\nfunction createPlaceholderHTML(pathname: string): string {\r\n    return `<!DOCTYPE html>\r\n<html>\r\n  <head>\r\n    <meta charset=\"UTF-8\">\r\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\r\n    <title>Flight</title>\r\n    <style>\r\n      body { font-family: system-ui, sans-serif; display: flex; align-items: center; justify-content: center; min-height: 100vh; margin: 0; background: #0a0a0a; color: #fafafa; }\r\n      .container { text-align: center; }\r\n      h1 { font-size: 3rem; margin-bottom: 0.5rem; }\r\n      p { color: #888; }\r\n      code { background: #1a1a1a; padding: 0.25rem 0.5rem; border-radius: 4px; font-size: 0.875rem; }\r\n    </style>\r\n  </head>\r\n  <body>\r\n    <div class=\"container\">\r\n      <h1>Flight</h1>\r\n      <p>Path: <code>${pathname}</code></p>\r\n      <p>Configure a UI framework adapter to enable SSR.</p>\r\n    </div>\r\n  </body>\r\n</html>`;\r\n}\r\n\r\n// Note: All exports are at the point of definition (export interface, export function)\r\n","/**\r\n * Flight Adapters - Optional Validation Helpers\r\n * \r\n * This module provides optional validation utilities for adapter options.\r\n * Zod is NOT required - these are only used if the developer chooses to\r\n * add runtime validation to their adapter.\r\n * \r\n * @example Without validation (default - no Zod needed)\r\n * ```typescript\r\n * import { createAdapter } from '@flight-framework/core/adapters';\r\n * \r\n * export default function myAdapter(options = {}) {\r\n *     return createAdapter({\r\n *         name: 'my-adapter',\r\n *         adapt: async (builder) => { ... }\r\n *     });\r\n * }\r\n * ```\r\n * \r\n * @example With optional Zod validation (if developer wants it)\r\n * ```typescript\r\n * import { createValidatedAdapter } from '@flight-framework/core/adapters';\r\n * import { z } from 'zod';\r\n * \r\n * const optionsSchema = z.object({\r\n *     port: z.number().default(3000),\r\n *     healthCheck: z.boolean().default(true),\r\n * });\r\n * \r\n * export default createValidatedAdapter(\r\n *     'my-adapter',\r\n *     optionsSchema,\r\n *     (options) => ({\r\n *         adapt: async (builder) => { ... }\r\n *     })\r\n * );\r\n * ```\r\n * \r\n * @module @flight-framework/core/adapters/validation\r\n */\r\n\r\nimport type { FlightAdapter, AdapterBuilder } from './index.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Minimal Zod-like schema interface\r\n * This allows the validation helper to work with Zod or any compatible library\r\n * without requiring Zod as a direct dependency\r\n */\r\nexport interface ZodLikeSchema<T = unknown> {\r\n    parse(data: unknown): T;\r\n    safeParse(data: unknown): { success: true; data: T } | { success: false; error: unknown };\r\n}\r\n\r\n/**\r\n * Options for validated adapter factory\r\n */\r\nexport interface ValidatedAdapterOptions<T> {\r\n    /** Parsed and validated options */\r\n    adapt: (builder: AdapterBuilder) => Promise<void>;\r\n    /** Optional emulate function */\r\n    emulate?: FlightAdapter['emulate'];\r\n    /** Optional supports declaration */\r\n    supports?: FlightAdapter['supports'];\r\n}\r\n\r\n// ============================================================================\r\n// Validation Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Create a validated adapter factory\r\n * \r\n * This helper validates adapter options at runtime using a Zod-like schema.\r\n * The developer chooses whether to use this - it's completely optional.\r\n * \r\n * @param name - Adapter name\r\n * @param schema - Zod-like schema for options validation\r\n * @param factory - Factory function that receives validated options\r\n * @returns Adapter factory function\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createValidatedAdapter } from '@flight-framework/core/adapters';\r\n * import { z } from 'zod';\r\n * \r\n * const schema = z.object({\r\n *     port: z.number().default(3000),\r\n *     region: z.string().optional(),\r\n * });\r\n * \r\n * export default createValidatedAdapter('my-adapter', schema, (options) => ({\r\n *     adapt: async (builder) => {\r\n *         // options is fully typed: { port: number; region?: string }\r\n *         console.log(`Using port ${options.port}`);\r\n *     }\r\n * }));\r\n * ```\r\n */\r\nexport function createValidatedAdapter<TSchema extends ZodLikeSchema>(\r\n    name: string,\r\n    schema: TSchema,\r\n    factory: (options: ReturnType<TSchema['parse']>) => ValidatedAdapterOptions<ReturnType<TSchema['parse']>>\r\n): (options?: unknown) => FlightAdapter {\r\n    return (rawOptions: unknown = {}): FlightAdapter => {\r\n        // Validate options using the provided schema\r\n        const parseResult = schema.safeParse(rawOptions);\r\n\r\n        if (!parseResult.success) {\r\n            const errorMessage = formatValidationError(name, parseResult.error);\r\n            throw new Error(errorMessage);\r\n        }\r\n\r\n        const validatedOptions = parseResult.data as ReturnType<TSchema['parse']>;\r\n        const adapterConfig = factory(validatedOptions);\r\n\r\n        return {\r\n            name,\r\n            adapt: adapterConfig.adapt,\r\n            emulate: adapterConfig.emulate,\r\n            supports: adapterConfig.supports,\r\n        };\r\n    };\r\n}\r\n\r\n/**\r\n * Validate adapter options without throwing\r\n * Returns null if validation fails, useful for optional validation\r\n * \r\n * @param schema - Zod-like schema\r\n * @param options - Options to validate\r\n * @returns Validated options or null\r\n */\r\nexport function validateAdapterOptions<TSchema extends ZodLikeSchema>(\r\n    schema: TSchema,\r\n    options: unknown\r\n): ReturnType<TSchema['parse']> | null {\r\n    const result = schema.safeParse(options);\r\n    return result.success ? (result.data as ReturnType<TSchema['parse']>) : null;\r\n}\r\n\r\n/**\r\n * Assert adapter options are valid, throwing detailed error if not\r\n * \r\n * @param name - Adapter name for error messages\r\n * @param schema - Zod-like schema\r\n * @param options - Options to validate\r\n * @returns Validated options\r\n * @throws Error with detailed message if validation fails\r\n */\r\nexport function assertValidOptions<TSchema extends ZodLikeSchema>(\r\n    name: string,\r\n    schema: TSchema,\r\n    options: unknown\r\n): ReturnType<TSchema['parse']> {\r\n    const result = schema.safeParse(options);\r\n\r\n    if (!result.success) {\r\n        throw new Error(formatValidationError(name, result.error));\r\n    }\r\n\r\n    return result.data as ReturnType<TSchema['parse']>;\r\n}\r\n\r\n// ============================================================================\r\n// Error Formatting\r\n// ============================================================================\r\n\r\n/**\r\n * Format a validation error into a readable message\r\n */\r\nfunction formatValidationError(adapterName: string, error: unknown): string {\r\n    const prefix = `[${adapterName}] Invalid adapter options`;\r\n\r\n    // Handle Zod errors\r\n    if (error && typeof error === 'object' && 'issues' in error) {\r\n        const zodError = error as { issues: Array<{ path: (string | number)[]; message: string }> };\r\n        const issues = zodError.issues\r\n            .map(issue => `  - ${issue.path.join('.')}: ${issue.message}`)\r\n            .join('\\n');\r\n        return `${prefix}:\\n${issues}`;\r\n    }\r\n\r\n    // Fallback for other error types\r\n    if (error instanceof Error) {\r\n        return `${prefix}: ${error.message}`;\r\n    }\r\n\r\n    return `${prefix}: Unknown validation error`;\r\n}\r\n\r\n// ============================================================================\r\n// Type Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Extract the inferred type from a Zod-like schema\r\n * Useful for typing adapter options in TypeScript\r\n */\r\nexport type InferSchema<T extends ZodLikeSchema> = ReturnType<T['parse']>;\r\n","/**\r\n * Flight Adapters - Universal deployment adapters\r\n * \r\n * Adapters transform Flight's output for different deployment targets.\r\n * The user chooses where to deploy - Flight provides the adapters.\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/** Build manifest containing all generated assets */\r\nexport interface BuildManifest {\r\n    /** Entry points by name */\r\n    entries: Record<string, string>;\r\n    /** All generated files */\r\n    files: string[];\r\n    /** Route information */\r\n    routes: RouteManifestEntry[];\r\n    /** Server entry point (if applicable) */\r\n    serverEntry?: string;\r\n    /** Client entry point */\r\n    clientEntry?: string;\r\n}\r\n\r\n/** Route information in manifest */\r\nexport interface RouteManifestEntry {\r\n    /** Route path pattern */\r\n    path: string;\r\n    /** Render mode for this route */\r\n    mode: 'ssr' | 'ssg' | 'csr' | 'isr';\r\n    /** Component/handler file path */\r\n    component: string;\r\n    /** Pre-rendered paths (for SSG/ISR) */\r\n    prerendered?: string[];\r\n}\r\n\r\n/** Builder utilities passed to adapters */\r\nexport interface AdapterBuilder {\r\n    /** Build manifest */\r\n    manifest: BuildManifest;\r\n    /** Project root directory */\r\n    root: string;\r\n    /** Build output directory */\r\n    outDir: string;\r\n\r\n    /** Read a file from the build output */\r\n    readFile(path: string): Promise<string>;\r\n    /** Write a file to the adapter output */\r\n    writeFile(path: string, content: string): Promise<void>;\r\n    /** Copy files from build to adapter output */\r\n    copy(from: string, to: string): Promise<void>;\r\n    /** Get all files matching a pattern */\r\n    glob(pattern: string): Promise<string[]>;\r\n    /** Compress files for production */\r\n    compress?(files: string[]): Promise<void>;\r\n\r\n    /** Log info message */\r\n    log: {\r\n        info(message: string): void;\r\n        warn(message: string): void;\r\n        error(message: string): void;\r\n    };\r\n}\r\n\r\n/** Flight adapter interface */\r\nexport interface FlightAdapter {\r\n    /** Adapter name */\r\n    name: string;\r\n\r\n    /** \r\n     * Transform the build output for the target platform\r\n     * This is called after Flight's build process completes\r\n     */\r\n    adapt(builder: AdapterBuilder): Promise<void>;\r\n\r\n    /**\r\n     * Optional: Start listening for requests (for Node.js/Bun adapters)\r\n     */\r\n    listen?(server: unknown, port: number): Promise<void>;\r\n\r\n    /**\r\n     * Optional: Emulate the platform during development\r\n     * Useful for testing platform-specific behavior locally\r\n     */\r\n    emulate?(): {\r\n        /** Platform-specific env vars */\r\n        env?: Record<string, string>;\r\n        /** Custom middleware for dev server */\r\n        middleware?: unknown[];\r\n    };\r\n\r\n    /**\r\n     * Optional: Declare what this adapter supports\r\n     * Flight uses this to warn about incompatible features\r\n     */\r\n    supports?: {\r\n        /** Can read files at runtime (for dynamic content) */\r\n        read?: () => boolean;\r\n        /** Supports streaming responses */\r\n        streaming?: () => boolean;\r\n        /** Supports WebSockets */\r\n        websockets?: () => boolean;\r\n        /** Supports edge runtime */\r\n        edge?: () => boolean;\r\n        /** Supports Node.js runtime */\r\n        node?: () => boolean;\r\n    };\r\n}\r\n\r\n\r\n// ============================================================================\r\n// Adapter Factory Helper\r\n// ============================================================================\r\n\r\nexport interface AdapterOptions {\r\n    name: string;\r\n    adapt: (builder: AdapterBuilder) => Promise<void>;\r\n    emulate?: FlightAdapter['emulate'];\r\n    supports?: FlightAdapter['supports'];\r\n}\r\n\r\n/**\r\n * Create a Flight adapter\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createAdapter } from '@flight-framework/core/adapters';\r\n * \r\n * export default function myAdapter(options = {}) {\r\n *   return createAdapter({\r\n *     name: 'my-adapter',\r\n *     async adapt(builder) {\r\n *       // Transform build output for your platform\r\n *     },\r\n *   });\r\n * }\r\n * ```\r\n */\r\nexport function createAdapter(options: AdapterOptions): FlightAdapter {\r\n    return {\r\n        name: options.name,\r\n        adapt: options.adapt,\r\n        emulate: options.emulate,\r\n        supports: options.supports,\r\n    };\r\n}\r\n\r\n// Re-export universal handler for adapters to use (optional)\r\nexport * from './handler.js';\r\n\r\n// Re-export optional validation helpers (Zod not required)\r\nexport * from './validation.js';\r\n\r\n// ============================================================================\r\n// Agnostic Service Adapters (Interfaces)\r\n// ============================================================================\r\n\r\n/**\r\n * Storage Adapter Interface\r\n * \r\n * Implement this to use any storage provider:\r\n * S3, Supabase Storage, Cloudflare R2, local filesystem, etc.\r\n */\r\nexport interface StorageAdapter {\r\n    name: string;\r\n\r\n    /** Upload a file */\r\n    upload(path: string, data: Buffer | Uint8Array | string, options?: {\r\n        contentType?: string;\r\n        metadata?: Record<string, string>;\r\n    }): Promise<{ url: string; path: string }>;\r\n\r\n    /** Download a file */\r\n    download(path: string): Promise<Buffer>;\r\n\r\n    /** Delete a file */\r\n    delete(path: string): Promise<void>;\r\n\r\n    /** List files with optional prefix */\r\n    list(prefix?: string): Promise<string[]>;\r\n\r\n    /** Get a signed URL for direct access */\r\n    getSignedUrl?(path: string, options?: {\r\n        expiresIn?: number;\r\n        operation?: 'read' | 'write';\r\n    }): Promise<string>;\r\n}\r\n\r\n/**\r\n * Auth Adapter Interface\r\n * \r\n * Implement this to use any auth provider:\r\n * Better Auth, Supabase Auth, Lucia, Auth.js, etc.\r\n */\r\nexport interface AuthAdapter {\r\n    name: string;\r\n\r\n    /** Get the current user from a request */\r\n    getUser(request: Request): Promise<AuthUser | null>;\r\n\r\n    /** Verify a session token */\r\n    verifySession(token: string): Promise<AuthSession | null>;\r\n\r\n    /** Optional middleware for handling auth-specific routes (e.g., /api/auth/*) */\r\n    middleware?: (req: Request) => Promise<Response | null>;\r\n}\r\n\r\nexport interface AuthUser {\r\n    id: string;\r\n    email?: string;\r\n    name?: string;\r\n    avatar?: string;\r\n    metadata?: Record<string, unknown>;\r\n}\r\n\r\nexport interface AuthSession {\r\n    user: AuthUser;\r\n    expiresAt: Date;\r\n    token: string;\r\n}\r\n\r\n/**\r\n * Email Adapter Interface\r\n * \r\n * Implement this to use any email provider:\r\n * Resend, SendGrid, Postmark, SMTP, etc.\r\n */\r\nexport interface EmailAdapter {\r\n    name: string;\r\n\r\n    /** Send an email */\r\n    send(options: {\r\n        to: string | string[];\r\n        subject: string;\r\n        html?: string;\r\n        text?: string;\r\n        from?: string;\r\n        replyTo?: string;\r\n        attachments?: Array<{\r\n            filename: string;\r\n            content: Buffer | string;\r\n            contentType?: string;\r\n        }>;\r\n    }): Promise<{ id: string; success: boolean }>;\r\n}\r\n\r\n/**\r\n * Queue/Jobs Adapter Interface\r\n * \r\n * Implement this to use any job queue:\r\n * BullMQ, Quirrel, Inngest, custom, etc.\r\n */\r\nexport interface JobsAdapter {\r\n    name: string;\r\n\r\n    /** Add a job to the queue */\r\n    enqueue<T>(jobName: string, data: T, options?: {\r\n        delay?: number;\r\n        priority?: number;\r\n        retries?: number;\r\n    }): Promise<{ id: string }>;\r\n\r\n    /** Schedule a recurring job */\r\n    schedule?(jobName: string, cron: string, data?: unknown): Promise<{ id: string }>;\r\n\r\n    /** Cancel a job */\r\n    cancel?(jobId: string): Promise<void>;\r\n}\r\n\r\n/**\r\n * Database Adapter Interface\r\n * \r\n * Note: This is intentionally minimal. \r\n * For databases, use your preferred ORM/query builder directly.\r\n * This interface is for Flight's internal use (sessions, cache, etc.)\r\n */\r\nexport interface DatabaseAdapter {\r\n    name: string;\r\n\r\n    /** Raw query execution */\r\n    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\r\n\r\n    /** Execute a mutation */\r\n    execute(sql: string, params?: unknown[]): Promise<{ rowsAffected: number }>;\r\n\r\n    /** Transaction support */\r\n    transaction?<T>(fn: (tx: DatabaseAdapter) => Promise<T>): Promise<T>;\r\n}\r\n"]}

package/dist/{chunk-KDEA64UX.js → chunk-EGB7C73X.js}

@@ -1,6 +1,6 @@
-import { createMiddlewareChain, createContextFromRequest, createResponseFromContext } from './chunk-R7MEVVA4.js';
-import { resolveConfig } from './chunk-EHVUAFNH.js';
-import { createRouter } from './chunk-ARBKF6VI.js';
+import { createMiddlewareChain, createContextFromRequest, createResponseFromContext } from './chunk-OYF2OAKS.js';
+import { resolveConfig } from './chunk-IXMD5QH2.js';
+import { createRouter } from './chunk-GCQZ4FHI.js';
 
 // src/server/index.ts
 function detectRuntime() {
@@ -219,5 +219,5 @@ function getRuntime() {
 }
 
 export { createServer, getRuntime, isFlightServer };
-//# sourceMappingURL=chunk-KDEA64UX.js.map
-//# sourceMappingURL=chunk-KDEA64UX.js.map
+//# sourceMappingURL=chunk-EGB7C73X.js.map
+//# sourceMappingURL=chunk-EGB7C73X.js.map

package/dist/chunk-EGB7C73X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/index.ts"],"names":[],"mappings":"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","file":"chunk-EGB7C73X.js","sourcesContent":["/**\r\n * Flight Server - Main server factory\r\n * \r\n * Creates a Flight server instance that handles routing, middleware, and rendering.\r\n * This is the primary entry point for Flight applications.\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createServer } from '@flight-framework/core';\r\n * \r\n * const server = createServer();\r\n * \r\n * server.get('/api/health', () => Response.json({ status: 'ok' }));\r\n * \r\n * // Just works! Auto-detects Node.js, Bun, or Deno\r\n * server.listen(3000);\r\n * ```\r\n */\r\n\r\nimport { createRouter, type Router } from '../router/index.js';\r\nimport {\r\n    createMiddlewareChain,\r\n    createContextFromRequest,\r\n    createResponseFromContext,\r\n    type MiddlewareChain,\r\n    type Middleware,\r\n} from '../middleware/index.js';\r\nimport { type FlightConfig, type FlightUserConfig, resolveConfig } from '../config/index.js';\r\nimport type { FlightAdapter } from '../adapters/index.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/** Route handler function signature */\r\nexport type RouteHandler = (context: RouteHandlerContext) => Promise<Response> | Response;\r\n\r\n/** Context passed to route handlers */\r\nexport interface RouteHandlerContext {\r\n    /** The incoming request */\r\n    request: Request;\r\n    /** URL parameters from routing */\r\n    params: Record<string, string | string[]>;\r\n    /** Query parameters */\r\n    query: URLSearchParams;\r\n    /** Parsed URL */\r\n    url: URL;\r\n    /** Local data from middleware */\r\n    locals: Record<string, unknown>;\r\n    /** Database instance (if configured) */\r\n    db?: unknown;\r\n    /** Auth instance (if configured) */\r\n    auth?: unknown;\r\n    /** Email instance (if configured) */\r\n    email?: unknown;\r\n}\r\n\r\n/** Server options */\r\nexport interface ServerOptions {\r\n    /** Server configuration */\r\n    config?: FlightUserConfig;\r\n    /** Deployment adapter */\r\n    adapter?: FlightAdapter;\r\n    /** Database instance */\r\n    db?: unknown;\r\n    /** Auth instance */\r\n    auth?: unknown;\r\n    /** Email instance */\r\n    email?: unknown;\r\n}\r\n\r\n/** Route definition for the server */\r\nexport interface ServerRoute {\r\n    /** HTTP method (GET, POST, etc.) */\r\n    method: string | string[];\r\n    /** Route path pattern */\r\n    path: string;\r\n    /** Route handler */\r\n    handler: RouteHandler;\r\n}\r\n\r\n/** Listen options */\r\nexport interface ListenOptions {\r\n    /** Port to listen on (default: 3000) */\r\n    port?: number;\r\n    /** Hostname to bind to (default: 'localhost') */\r\n    hostname?: string;\r\n    /** Callback when server starts */\r\n    onListen?: (info: { port: number; hostname: string }) => void;\r\n}\r\n\r\n/** Flight Server instance */\r\nexport interface FlightServer {\r\n    /** Add a route */\r\n    route(method: string | string[], path: string, handler: RouteHandler): FlightServer;\r\n\r\n    /** Convenience methods for common HTTP methods */\r\n    get(path: string, handler: RouteHandler): FlightServer;\r\n    post(path: string, handler: RouteHandler): FlightServer;\r\n    put(path: string, handler: RouteHandler): FlightServer;\r\n    delete(path: string, handler: RouteHandler): FlightServer;\r\n    patch(path: string, handler: RouteHandler): FlightServer;\r\n\r\n    /** Add middleware */\r\n    use(middleware: Middleware): FlightServer;\r\n    use(path: string, middleware: Middleware): FlightServer;\r\n\r\n    /** Handle incoming request (Web standard Request/Response) */\r\n    handle(request: Request): Promise<Response>;\r\n\r\n    /** \r\n     * Start the HTTP server\r\n     * Auto-detects runtime: Node.js, Bun, or Deno\r\n     */\r\n    listen(port?: number | ListenOptions): Promise<void>;\r\n\r\n    /** Fetch handler for Bun.serve() and Deno.serve() */\r\n    fetch(request: Request): Promise<Response>;\r\n\r\n    /** Get the resolved configuration */\r\n    readonly config: FlightConfig;\r\n\r\n    /** Get the router instance */\r\n    readonly router: Router<RouteHandler>;\r\n\r\n    /** Get the middleware chain */\r\n    readonly middleware: MiddlewareChain;\r\n}\r\n\r\n// ============================================================================\r\n// Runtime Detection\r\n// ============================================================================\r\n\r\ntype Runtime = 'node' | 'bun' | 'deno' | 'unknown';\r\n\r\nfunction detectRuntime(): Runtime {\r\n    // @ts-expect-error - Bun global\r\n    if (typeof Bun !== 'undefined') return 'bun';\r\n    // @ts-expect-error - Deno global  \r\n    if (typeof Deno !== 'undefined') return 'deno';\r\n    if (typeof process !== 'undefined' && process.versions?.node) return 'node';\r\n    return 'unknown';\r\n}\r\n\r\n// ============================================================================\r\n// Server Implementation\r\n// ============================================================================\r\n\r\ninterface RouteEntry {\r\n    methods: Set<string>;\r\n    handler: RouteHandler;\r\n}\r\n\r\n/**\r\n * Create a new Flight server instance\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createServer } from '@flight-framework/core';\r\n * \r\n * const server = createServer();\r\n * \r\n * server.get('/api/users', async ({ db }) => {\r\n *   const users = await db.query('SELECT * FROM users');\r\n *   return Response.json(users);\r\n * });\r\n * \r\n * // Works on Node.js, Bun, and Deno!\r\n * server.listen(3000);\r\n * ```\r\n */\r\nexport function createServer(options: ServerOptions = {}): FlightServer {\r\n    const config = resolveConfig(options.config ?? {});\r\n    const router = createRouter<RouteEntry>();\r\n    const middlewareChain = createMiddlewareChain();\r\n\r\n    // Store dependencies\r\n    const deps = {\r\n        db: options.db,\r\n        auth: options.auth,\r\n        email: options.email,\r\n    };\r\n\r\n    function addRoute(method: string | string[], path: string, handler: RouteHandler): FlightServer {\r\n        const methods = Array.isArray(method) ? method : [method];\r\n        const methodSet = new Set(methods.map(m => m.toUpperCase()));\r\n\r\n        // Check if route already exists\r\n        const existingMatch = router.match(path);\r\n        if (existingMatch && existingMatch.route.path === path) {\r\n            // Merge methods\r\n            for (const m of methodSet) {\r\n                existingMatch.route.handler.methods.add(m);\r\n            }\r\n            existingMatch.route.handler.handler = handler;\r\n        } else {\r\n            router.add({\r\n                path,\r\n                handler: { methods: methodSet, handler },\r\n            });\r\n        }\r\n\r\n        return server;\r\n    }\r\n\r\n    function useMiddleware(\r\n        pathOrMiddleware: string | Middleware,\r\n        maybeMiddleware?: Middleware\r\n    ): FlightServer {\r\n        if (typeof pathOrMiddleware === 'string' && maybeMiddleware) {\r\n            middlewareChain.use(pathOrMiddleware, maybeMiddleware);\r\n        } else if (typeof pathOrMiddleware === 'function') {\r\n            middlewareChain.use(pathOrMiddleware);\r\n        }\r\n        return server;\r\n    }\r\n\r\n    async function handle(request: Request): Promise<Response> {\r\n        const url = new URL(request.url);\r\n        const method = request.method.toUpperCase();\r\n\r\n        // Run middleware\r\n        const ctx = createContextFromRequest(request);\r\n        await middlewareChain.execute(ctx);\r\n\r\n        // If middleware already set a response, return it\r\n        if (ctx.responseBody !== undefined) {\r\n            return createResponseFromContext(ctx);\r\n        }\r\n\r\n        // Match route\r\n        const match = router.match(url.pathname);\r\n        if (!match) {\r\n            return new Response('Not Found', { status: 404 });\r\n        }\r\n\r\n        // Check method\r\n        if (!match.route.handler.methods.has(method) && !match.route.handler.methods.has('*')) {\r\n            return new Response('Method Not Allowed', { status: 405 });\r\n        }\r\n\r\n        // Build handler context\r\n        const handlerContext: RouteHandlerContext = {\r\n            request,\r\n            params: match.params,\r\n            query: url.searchParams,\r\n            url,\r\n            locals: ctx.locals,\r\n            ...deps,\r\n        };\r\n\r\n        try {\r\n            return await match.route.handler.handler(handlerContext);\r\n        } catch (error) {\r\n            console.error('Route handler error:', error);\r\n            return new Response('Internal Server Error', { status: 500 });\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Start the HTTP server\r\n     * Auto-detects the runtime and uses the appropriate server\r\n     */\r\n    async function listen(portOrOptions?: number | ListenOptions): Promise<void> {\r\n        const opts: ListenOptions = typeof portOrOptions === 'number'\r\n            ? { port: portOrOptions }\r\n            : portOrOptions ?? {};\r\n\r\n        const port = opts.port ?? config.dev.port ?? 3000;\r\n        const hostname = opts.hostname ?? 'localhost';\r\n\r\n        // Check for custom adapter first\r\n        const adapter = options.adapter ?? config.adapter;\r\n        if (adapter?.listen) {\r\n            await adapter.listen(server, port);\r\n            return;\r\n        }\r\n\r\n        const runtime = detectRuntime();\r\n\r\n        switch (runtime) {\r\n            case 'bun':\r\n                await startBunServer(port, hostname, opts.onListen);\r\n                break;\r\n            case 'deno':\r\n                await startDenoServer(port, hostname, opts.onListen);\r\n                break;\r\n            case 'node':\r\n            default:\r\n                await startNodeServer(port, hostname, opts.onListen);\r\n                break;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Start Node.js HTTP server\r\n     */\r\n    async function startNodeServer(port: number, hostname: string, onListen?: ListenOptions['onListen']): Promise<void> {\r\n        const { createServer: createHttpServer } = await import('node:http');\r\n\r\n        const httpServer = createHttpServer(async (req, res) => {\r\n            const url = new URL(req.url || '/', `http://${hostname}:${port}`);\r\n\r\n            // Build headers\r\n            const headers = new Headers();\r\n            for (const [key, value] of Object.entries(req.headers)) {\r\n                if (value) {\r\n                    const headerValue = Array.isArray(value) ? value[0] : value;\r\n                    if (headerValue) headers.set(key, headerValue);\r\n                }\r\n            }\r\n\r\n            // Read body for POST/PUT/PATCH\r\n            let body: string | undefined;\r\n            if (['POST', 'PUT', 'PATCH'].includes(req.method || '')) {\r\n                body = await new Promise<string>((resolve) => {\r\n                    let data = '';\r\n                    req.on('data', chunk => data += chunk);\r\n                    req.on('end', () => resolve(data));\r\n                });\r\n            }\r\n\r\n            const request = new Request(url.toString(), {\r\n                method: req.method,\r\n                headers,\r\n                body: body || undefined,\r\n            });\r\n\r\n            try {\r\n                const response = await handle(request);\r\n\r\n                res.statusCode = response.status;\r\n                response.headers.forEach((value, key) => {\r\n                    res.setHeader(key, value);\r\n                });\r\n\r\n                const responseBody = await response.text();\r\n                res.end(responseBody);\r\n            } catch (error) {\r\n                console.error('Server error:', error);\r\n                res.statusCode = 500;\r\n                res.setHeader('Content-Type', 'application/json');\r\n                res.end(JSON.stringify({ error: 'Internal Server Error' }));\r\n            }\r\n        });\r\n\r\n        return new Promise((resolve) => {\r\n            httpServer.listen(port, hostname, () => {\r\n                const info = { port, hostname };\r\n                if (onListen) {\r\n                    onListen(info);\r\n                } else {\r\n                    console.log(`\r\n╔═══════════════════════════════════════════════════════════╗\r\n║              Flight Server (Node.js)                      ║\r\n╠═══════════════════════════════════════════════════════════╣\r\n║  Server: http://${hostname}:${port.toString().padEnd(37)}║\r\n╚═══════════════════════════════════════════════════════════╝\r\n`);\r\n                }\r\n                resolve();\r\n            });\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Start Bun server\r\n     */\r\n    async function startBunServer(port: number, hostname: string, onListen?: ListenOptions['onListen']): Promise<void> {\r\n        // @ts-expect-error - Bun types\r\n        Bun.serve({\r\n            port,\r\n            hostname,\r\n            fetch: handle,\r\n        });\r\n\r\n        const info = { port, hostname };\r\n        if (onListen) {\r\n            onListen(info);\r\n        } else {\r\n            console.log(`\r\n╔═══════════════════════════════════════════════════════════╗\r\n║              Flight Server (Bun)                          ║\r\n╠═══════════════════════════════════════════════════════════╣\r\n║  Server: http://${hostname}:${port.toString().padEnd(37)}║\r\n╚═══════════════════════════════════════════════════════════╝\r\n`);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Start Deno server\r\n     */\r\n    async function startDenoServer(port: number, hostname: string, onListen?: ListenOptions['onListen']): Promise<void> {\r\n        // @ts-expect-error - Deno types\r\n        Deno.serve({ port, hostname }, handle);\r\n\r\n        const info = { port, hostname };\r\n        if (onListen) {\r\n            onListen(info);\r\n        } else {\r\n            console.log(`\r\n╔═══════════════════════════════════════════════════════════╗\r\n║              Flight Server (Deno)                         ║\r\n╠═══════════════════════════════════════════════════════════╣\r\n║  Server: http://${hostname}:${port.toString().padEnd(37)}║\r\n╚═══════════════════════════════════════════════════════════╝\r\n`);\r\n        }\r\n    }\r\n\r\n    const server: FlightServer = {\r\n        route: addRoute,\r\n        get: (path, handler) => addRoute('GET', path, handler),\r\n        post: (path, handler) => addRoute('POST', path, handler),\r\n        put: (path, handler) => addRoute('PUT', path, handler),\r\n        delete: (path, handler) => addRoute('DELETE', path, handler),\r\n        patch: (path, handler) => addRoute('PATCH', path, handler),\r\n        use: useMiddleware as FlightServer['use'],\r\n        handle,\r\n        listen,\r\n        fetch: handle, // Alias for Bun/Deno compatibility\r\n        get config() { return config; },\r\n        get router() { return router as unknown as Router<RouteHandler>; },\r\n        get middleware() { return middlewareChain; },\r\n    };\r\n\r\n    return server;\r\n}\r\n\r\n// ============================================================================\r\n// Helper Exports\r\n// ============================================================================\r\n\r\n/** Type guard to check if an object is a FlightServer */\r\nexport function isFlightServer(obj: unknown): obj is FlightServer {\r\n    return (\r\n        typeof obj === 'object' &&\r\n        obj !== null &&\r\n        'handle' in obj &&\r\n        'route' in obj &&\r\n        typeof (obj as FlightServer).handle === 'function'\r\n    );\r\n}\r\n\r\n/** Get current runtime */\r\nexport function getRuntime(): Runtime {\r\n    return detectRuntime();\r\n}\r\n\r\n"]}

package/dist/{chunk-2JVEH76V.js → chunk-FSJNOPYE.js}

@@ -1,4 +1,4 @@
-import { isProduction, isDevelopment } from './chunk-OZBPR27I.js';
+import { isProduction, isDevelopment } from './chunk-YHEVHRLH.js';
 
 // src/errors/index.ts
 var FlightError = class extends Error {
@@ -193,5 +193,5 @@ function wrapWithDigest(error) {
 }
 
 export { BadRequestError, FlightError, ForbiddenError, InternalError, NotFoundError, UnauthorizedError, clearError, createError, createErrorResponse, forbidden, getError, getErrorStatusCode, isFlightError, isForbiddenError, isNotFoundError, isUnauthorizedError, notFound, showError, unauthorized, wrapWithDigest };
-//# sourceMappingURL=chunk-2JVEH76V.js.map
-//# sourceMappingURL=chunk-2JVEH76V.js.map
+//# sourceMappingURL=chunk-FSJNOPYE.js.map
+//# sourceMappingURL=chunk-FSJNOPYE.js.map

package/dist/chunk-FSJNOPYE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/index.ts"],"names":[],"mappings":"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","file":"chunk-FSJNOPYE.js","sourcesContent":["/**\r\n * @flight-framework/core - Error Handling\r\n * \r\n * Comprehensive error handling utilities for Flight applications.\r\n * All utilities are OPTIONAL - developers can use their own error handling.\r\n * \r\n * Philosophy: Flight OFFERS these utilities, but never IMPOSES them.\r\n * Using throw new Error() works perfectly fine - this is your choice.\r\n */\r\n\r\nimport { isProduction, isDevelopment } from '../utils/env.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Options for creating a Flight error\r\n */\r\nexport interface FlightErrorOptions {\r\n    /** HTTP status code */\r\n    statusCode: number;\r\n    /** Short status message (e.g., \"Not Found\") */\r\n    statusMessage?: string;\r\n    /** Detailed error message */\r\n    message?: string;\r\n    /** Additional data to include with the error */\r\n    data?: Record<string, unknown>;\r\n    /** If true, shows full-screen error page instead of error boundary */\r\n    fatal?: boolean;\r\n    /** Original error that caused this error */\r\n    cause?: Error;\r\n}\r\n\r\n/**\r\n * Extended error props with digest for production error correlation\r\n */\r\nexport interface FlightErrorProps {\r\n    /** The error object */\r\n    error: Error & { digest?: string };\r\n    /** Function to attempt recovery by re-rendering */\r\n    reset: () => void;\r\n}\r\n\r\n/**\r\n * Reset details provided to onReset callback\r\n */\r\nexport interface ResetDetails {\r\n    /** Reason for the reset */\r\n    reason: 'imperative-api' | 'keys';\r\n    /** Arguments passed to resetErrorBoundary (if imperative) */\r\n    args?: unknown[];\r\n    /** Previous resetKeys values (if keys changed) */\r\n    prev?: unknown[];\r\n    /** New resetKeys values (if keys changed) */\r\n    next?: unknown[];\r\n}\r\n\r\n/**\r\n * Options for error boundary behavior\r\n */\r\nexport interface ErrorBoundaryOptions {\r\n    /** Keys that trigger automatic reset when changed */\r\n    resetKeys?: unknown[];\r\n    /** Callback when error boundary resets */\r\n    onReset?: (details: ResetDetails) => void;\r\n    /** Callback when error is caught */\r\n    onError?: (error: Error, info: { componentStack?: string }) => void;\r\n}\r\n\r\n// ============================================================================\r\n// FlightError Class\r\n// ============================================================================\r\n\r\n/**\r\n * Custom error class with status code and metadata support.\r\n * \r\n * You can use this class or regular Error - Flight handles both.\r\n * \r\n * @example\r\n * ```typescript\r\n * throw new FlightError({\r\n *     statusCode: 404,\r\n *     message: 'User not found',\r\n *     data: { userId: '123' }\r\n * });\r\n * ```\r\n */\r\nexport class FlightError extends Error {\r\n    /** HTTP status code */\r\n    readonly statusCode: number;\r\n    /** Short status message */\r\n    readonly statusMessage: string;\r\n    /** Additional error data */\r\n    readonly data?: Record<string, unknown>;\r\n    /** Whether this is a fatal error (shows full-screen) */\r\n    readonly fatal: boolean;\r\n    /** Unique digest for production error correlation */\r\n    readonly digest?: string;\r\n\r\n    constructor(options: FlightErrorOptions) {\r\n        super(options.message || options.statusMessage || 'An error occurred');\r\n\r\n        this.name = 'FlightError';\r\n        this.statusCode = options.statusCode;\r\n        this.statusMessage = options.statusMessage || getDefaultStatusMessage(options.statusCode);\r\n        this.data = options.data;\r\n        this.fatal = options.fatal ?? false;\r\n\r\n        // Generate digest in production for error correlation\r\n        // Using typeof check for SSR/browser compatibility\r\n        if (isProduction()) {\r\n            this.digest = generateDigest();\r\n        }\r\n\r\n        // Preserve original error stack if cause provided\r\n        if (options.cause) {\r\n            this.cause = options.cause;\r\n            if (options.cause.stack) {\r\n                this.stack = `${this.stack}\\nCaused by: ${options.cause.stack}`;\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Convert to plain object for serialization\r\n     */\r\n    toJSON(): Record<string, unknown> {\r\n        return {\r\n            name: this.name,\r\n            message: this.message,\r\n            statusCode: this.statusCode,\r\n            statusMessage: this.statusMessage,\r\n            data: this.data,\r\n            fatal: this.fatal,\r\n            digest: this.digest,\r\n        };\r\n    }\r\n}\r\n\r\n// ============================================================================\r\n// HTTP Error Classes (Convenience)\r\n// ============================================================================\r\n\r\n/**\r\n * 400 Bad Request error\r\n */\r\nexport class BadRequestError extends FlightError {\r\n    constructor(message?: string, data?: Record<string, unknown>) {\r\n        super({ statusCode: 400, message, data });\r\n        this.name = 'BadRequestError';\r\n    }\r\n}\r\n\r\n/**\r\n * 401 Unauthorized error\r\n */\r\nexport class UnauthorizedError extends FlightError {\r\n    constructor(message?: string, data?: Record<string, unknown>) {\r\n        super({ statusCode: 401, message: message || 'Unauthorized', data });\r\n        this.name = 'UnauthorizedError';\r\n    }\r\n}\r\n\r\n/**\r\n * 403 Forbidden error\r\n */\r\nexport class ForbiddenError extends FlightError {\r\n    constructor(message?: string, data?: Record<string, unknown>) {\r\n        super({ statusCode: 403, message: message || 'Forbidden', data });\r\n        this.name = 'ForbiddenError';\r\n    }\r\n}\r\n\r\n/**\r\n * 404 Not Found error\r\n */\r\nexport class NotFoundError extends FlightError {\r\n    constructor(message?: string, data?: Record<string, unknown>) {\r\n        super({ statusCode: 404, message: message || 'Not Found', data });\r\n        this.name = 'NotFoundError';\r\n    }\r\n}\r\n\r\n/**\r\n * 500 Internal Server Error\r\n */\r\nexport class InternalError extends FlightError {\r\n    constructor(message?: string, data?: Record<string, unknown>) {\r\n        super({ statusCode: 500, message: message || 'Internal Server Error', data });\r\n        this.name = 'InternalError';\r\n    }\r\n}\r\n\r\n// ============================================================================\r\n// Factory Functions\r\n// ============================================================================\r\n\r\n/**\r\n * Create a FlightError with the specified options.\r\n * \r\n * This is a convenience function - you can also use `new FlightError()` directly\r\n * or just `throw new Error()` - Flight handles all cases.\r\n * \r\n * @example\r\n * ```typescript\r\n * // With full options\r\n * throw createError({\r\n *     statusCode: 404,\r\n *     message: 'Product not found',\r\n *     data: { productId: 'abc123' }\r\n * });\r\n * \r\n * // Simple string shorthand (becomes 500 error)\r\n * throw createError('Something went wrong');\r\n * ```\r\n */\r\nexport function createError(options: FlightErrorOptions | string): FlightError {\r\n    if (typeof options === 'string') {\r\n        return new FlightError({ statusCode: 500, message: options });\r\n    }\r\n    return new FlightError(options);\r\n}\r\n\r\n/**\r\n * Create a 404 Not Found error.\r\n * Convenience function equivalent to `createError({ statusCode: 404, ... })`.\r\n * \r\n * @example\r\n * ```typescript\r\n * if (!user) {\r\n *     throw notFound('User not found');\r\n * }\r\n * ```\r\n */\r\nexport function notFound(message?: string, data?: Record<string, unknown>): never {\r\n    throw new NotFoundError(message, data);\r\n}\r\n\r\n/**\r\n * Create a 403 Forbidden error.\r\n * \r\n * @example\r\n * ```typescript\r\n * if (!user.isAdmin) {\r\n *     throw forbidden('Admin access required');\r\n * }\r\n * ```\r\n */\r\nexport function forbidden(message?: string, data?: Record<string, unknown>): never {\r\n    throw new ForbiddenError(message, data);\r\n}\r\n\r\n/**\r\n * Create a 401 Unauthorized error.\r\n * \r\n * @example\r\n * ```typescript\r\n * if (!session) {\r\n *     throw unauthorized('Please log in to continue');\r\n * }\r\n * ```\r\n */\r\nexport function unauthorized(message?: string, data?: Record<string, unknown>): never {\r\n    throw new UnauthorizedError(message, data);\r\n}\r\n\r\n// ============================================================================\r\n// Error State Management (Client-Side)\r\n// ============================================================================\r\n\r\n// Global error state for client-side\r\ndeclare global {\r\n    interface Window {\r\n        __FLIGHT_ERROR__?: FlightError | null;\r\n    }\r\n}\r\n\r\n/**\r\n * Programmatically show an error page.\r\n * \r\n * This triggers the nearest error boundary or navigates to the error page.\r\n * Only works on the client side.\r\n * \r\n * @example\r\n * ```typescript\r\n * // Show error with full options\r\n * showError({\r\n *     statusCode: 500,\r\n *     message: 'Connection lost'\r\n * });\r\n * \r\n * // Simple string shorthand\r\n * showError('Something went wrong');\r\n * ```\r\n */\r\nexport function showError(error: FlightErrorOptions | FlightError | string): void {\r\n    let flightError: FlightError;\r\n\r\n    if (typeof error === 'string') {\r\n        flightError = new FlightError({ statusCode: 500, message: error });\r\n    } else if (error instanceof FlightError) {\r\n        flightError = error;\r\n    } else {\r\n        flightError = new FlightError(error);\r\n    }\r\n\r\n    // Client-side: dispatch custom event for error boundaries\r\n    if (typeof window !== 'undefined') {\r\n        window.__FLIGHT_ERROR__ = flightError;\r\n        window.dispatchEvent(new CustomEvent('flight:error', {\r\n            detail: flightError,\r\n            bubbles: true\r\n        }));\r\n    }\r\n}\r\n\r\n/**\r\n * Clear the current error state and optionally redirect.\r\n * \r\n * Use this to dismiss an error and return to normal state.\r\n * \r\n * @example\r\n * ```typescript\r\n * // Just clear the error\r\n * clearError();\r\n * \r\n * // Clear and redirect to home\r\n * clearError({ redirect: '/' });\r\n * ```\r\n */\r\nexport function clearError(options?: { redirect?: string }): void {\r\n    if (typeof window !== 'undefined') {\r\n        window.__FLIGHT_ERROR__ = null;\r\n        window.dispatchEvent(new CustomEvent('flight:error-clear', { bubbles: true }));\r\n\r\n        if (options?.redirect) {\r\n            window.location.href = options.redirect;\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Get the current error from global state.\r\n * Returns null if no error is active.\r\n */\r\nexport function getError(): FlightError | null {\r\n    if (typeof window !== 'undefined') {\r\n        return window.__FLIGHT_ERROR__ ?? null;\r\n    }\r\n    return null;\r\n}\r\n\r\n// ============================================================================\r\n// Type Guards\r\n// ============================================================================\r\n\r\n/**\r\n * Check if an error is a FlightError\r\n */\r\nexport function isFlightError(error: unknown): error is FlightError {\r\n    return error instanceof FlightError;\r\n}\r\n\r\n/**\r\n * Check if an error is a NotFoundError (404)\r\n */\r\nexport function isNotFoundError(error: unknown): error is NotFoundError {\r\n    return error instanceof NotFoundError ||\r\n        (isFlightError(error) && error.statusCode === 404);\r\n}\r\n\r\n/**\r\n * Check if an error is a ForbiddenError (403)\r\n */\r\nexport function isForbiddenError(error: unknown): error is ForbiddenError {\r\n    return error instanceof ForbiddenError ||\r\n        (isFlightError(error) && error.statusCode === 403);\r\n}\r\n\r\n/**\r\n * Check if an error is an UnauthorizedError (401)\r\n */\r\nexport function isUnauthorizedError(error: unknown): error is UnauthorizedError {\r\n    return error instanceof UnauthorizedError ||\r\n        (isFlightError(error) && error.statusCode === 401);\r\n}\r\n\r\n/**\r\n * Get the status code from any error.\r\n * Returns 500 for non-FlightError errors.\r\n */\r\nexport function getErrorStatusCode(error: unknown): number {\r\n    if (isFlightError(error)) {\r\n        return error.statusCode;\r\n    }\r\n    return 500;\r\n}\r\n\r\n// ============================================================================\r\n// Response Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Create an error Response from a FlightError.\r\n * \r\n * @example\r\n * ```typescript\r\n * try {\r\n *     // ... some operation\r\n * } catch (error) {\r\n *     return createErrorResponse(error);\r\n * }\r\n * ```\r\n */\r\nexport function createErrorResponse(error: unknown): Response {\r\n    const flightError = isFlightError(error)\r\n        ? error\r\n        : new InternalError(error instanceof Error ? error.message : 'Unknown error');\r\n\r\n    return new Response(\r\n        JSON.stringify({\r\n            error: flightError.statusMessage,\r\n            message: flightError.message,\r\n            statusCode: flightError.statusCode,\r\n            digest: flightError.digest,\r\n            ...(isDevelopment() && flightError.data\r\n                ? { data: flightError.data }\r\n                : {}),\r\n        }),\r\n        {\r\n            status: flightError.statusCode,\r\n            headers: {\r\n                'Content-Type': 'application/json',\r\n            },\r\n        }\r\n    );\r\n}\r\n\r\n// ============================================================================\r\n// Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Get default status message for HTTP status code\r\n */\r\nfunction getDefaultStatusMessage(statusCode: number): string {\r\n    const messages: Record<number, string> = {\r\n        400: 'Bad Request',\r\n        401: 'Unauthorized',\r\n        403: 'Forbidden',\r\n        404: 'Not Found',\r\n        405: 'Method Not Allowed',\r\n        408: 'Request Timeout',\r\n        409: 'Conflict',\r\n        410: 'Gone',\r\n        422: 'Unprocessable Entity',\r\n        429: 'Too Many Requests',\r\n        500: 'Internal Server Error',\r\n        501: 'Not Implemented',\r\n        502: 'Bad Gateway',\r\n        503: 'Service Unavailable',\r\n        504: 'Gateway Timeout',\r\n    };\r\n    return messages[statusCode] || 'Error';\r\n}\r\n\r\n/**\r\n * Generate a short digest for error correlation.\r\n * Used in production to correlate client errors with server logs\r\n * without exposing stack traces.\r\n */\r\nfunction generateDigest(): string {\r\n    // Use crypto if available (Node.js, modern browsers)\r\n    if (typeof crypto !== 'undefined' && crypto.randomUUID) {\r\n        return crypto.randomUUID().slice(0, 8);\r\n    }\r\n    // Fallback for older environments\r\n    return Math.random().toString(36).slice(2, 10);\r\n}\r\n\r\n/**\r\n * Wrap an error with a digest if it doesn't have one.\r\n * Useful for adding correlation IDs to third-party errors.\r\n */\r\nexport function wrapWithDigest<T extends Error>(error: T): T & { digest: string } {\r\n    const wrapped = error as T & { digest: string };\r\n    if (!wrapped.digest) {\r\n        wrapped.digest = generateDigest();\r\n    }\r\n    return wrapped;\r\n}\r\n"]}

package/dist/{chunk-ARBKF6VI.js → chunk-GCQZ4FHI.js}

@@ -241,5 +241,5 @@ function sortRoutes(routes) {
 }
 
 export { createRouter2 as createRouter, filePathToRoutePath, sortRoutes };
-//# sourceMappingURL=chunk-ARBKF6VI.js.map
-//# sourceMappingURL=chunk-ARBKF6VI.js.map
+//# sourceMappingURL=chunk-GCQZ4FHI.js.map
+//# sourceMappingURL=chunk-GCQZ4FHI.js.map