@flight-framework/core 0.3.2 → 0.5.0
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.
- package/LICENSE +21 -21
- package/README.md +541 -541
- package/dist/actions/index.js +1 -1
- package/dist/adapters/index.d.ts +260 -1
- package/dist/adapters/index.js +1 -1
- package/dist/cache/index.js +1 -1
- package/dist/{chunk-3UQJE3XZ.js → chunk-2F2QU6RC.js} +2 -2
- package/dist/chunk-2F2QU6RC.js.map +1 -0
- package/dist/{chunk-4U7CJVNQ.js → chunk-3KRBRSRJ.js} +2 -2
- package/dist/chunk-3KRBRSRJ.js.map +1 -0
- package/dist/{chunk-OZ3EXPLE.js → chunk-3QP3E7HS.js} +2 -2
- package/dist/chunk-3QP3E7HS.js.map +1 -0
- package/dist/{chunk-CKJHJPKQ.js → chunk-62C7LX2E.js} +2 -2
- package/dist/chunk-62C7LX2E.js.map +1 -0
- package/dist/{chunk-YNTMYL36.js → chunk-6BDCTUQY.js} +3 -3
- package/dist/chunk-6BDCTUQY.js.map +1 -0
- package/dist/chunk-77MJZCYD.js +354 -0
- package/dist/chunk-77MJZCYD.js.map +1 -0
- package/dist/{chunk-KDEA64UX.js → chunk-EGB7C73X.js} +5 -5
- package/dist/chunk-EGB7C73X.js.map +1 -0
- package/dist/{chunk-2JVEH76V.js → chunk-FSJNOPYE.js} +3 -3
- package/dist/chunk-FSJNOPYE.js.map +1 -0
- package/dist/{chunk-ARBKF6VI.js → chunk-GCQZ4FHI.js} +2 -2
- package/dist/{chunk-ARBKF6VI.js.map → chunk-GCQZ4FHI.js.map} +1 -1
- package/dist/{chunk-EHVUAFNH.js → chunk-IXMD5QH2.js} +2 -2
- package/dist/chunk-IXMD5QH2.js.map +1 -0
- package/dist/{chunk-6GI6HFSQ.js → chunk-K2CQZPCG.js} +2 -2
- package/dist/chunk-K2CQZPCG.js.map +1 -0
- package/dist/{chunk-6IG6XIXU.js → chunk-LNV47HGV.js} +2 -2
- package/dist/chunk-LNV47HGV.js.map +1 -0
- package/dist/{chunk-65JYF3DJ.js → chunk-MDQNNIHH.js} +2 -2
- package/dist/chunk-MDQNNIHH.js.map +1 -0
- package/dist/{chunk-GNS2FGPC.js → chunk-MQQLYWZZ.js} +2 -2
- package/dist/chunk-MQQLYWZZ.js.map +1 -0
- package/dist/{chunk-LAKHYTHL.js → chunk-NWMJYTMB.js} +3 -3
- package/dist/chunk-NWMJYTMB.js.map +1 -0
- package/dist/{chunk-R7MEVVA4.js → chunk-OYF2OAKS.js} +2 -2
- package/dist/chunk-OYF2OAKS.js.map +1 -0
- package/dist/{chunk-FRAH5QNY.js → chunk-P6WSBVDT.js} +4 -4
- package/dist/chunk-P6WSBVDT.js.map +1 -0
- package/dist/{chunk-5XHOLZBJ.js → chunk-PDW5WCMW.js} +2 -2
- package/dist/chunk-PDW5WCMW.js.map +1 -0
- package/dist/{chunk-A2QRUBVE.js → chunk-PVUMB632.js} +2 -2
- package/dist/chunk-PVUMB632.js.map +1 -0
- package/dist/{chunk-LKOPJ3GS.js → chunk-R7SQAREQ.js} +2 -2
- package/dist/chunk-R7SQAREQ.js.map +1 -0
- package/dist/{chunk-CNY3ZUVG.js → chunk-RSVA2EYO.js} +2 -2
- package/dist/chunk-RSVA2EYO.js.map +1 -0
- package/dist/{chunk-PAVI5W6M.js → chunk-T4Z4HM4W.js} +3 -3
- package/dist/chunk-T4Z4HM4W.js.map +1 -0
- package/dist/{chunk-HNPO6LFW.js → chunk-TASAT7KB.js} +2 -2
- package/dist/chunk-TASAT7KB.js.map +1 -0
- package/dist/{chunk-3N5ZBVZJ.js → chunk-VPFMHGEV.js} +2 -2
- package/dist/chunk-VPFMHGEV.js.map +1 -0
- package/dist/{chunk-A4TKWQBU.js → chunk-W6D62JCI.js} +2 -2
- package/dist/chunk-W6D62JCI.js.map +1 -0
- package/dist/{chunk-UFWGOJL7.js → chunk-WFAWAHJH.js} +2 -2
- package/dist/chunk-WFAWAHJH.js.map +1 -0
- package/dist/{chunk-NZS2YJ43.js → chunk-WOEIJWGJ.js} +2 -2
- package/dist/chunk-WOEIJWGJ.js.map +1 -0
- package/dist/{chunk-VNO2YUVD.js → chunk-XOIYNY4I.js} +2 -2
- package/dist/chunk-XOIYNY4I.js.map +1 -0
- package/dist/{chunk-PO7IHPFF.js → chunk-XSY5AAXT.js} +2 -2
- package/dist/chunk-XSY5AAXT.js.map +1 -0
- package/dist/{chunk-OZBPR27I.js → chunk-YHEVHRLH.js} +2 -2
- package/dist/chunk-YHEVHRLH.js.map +1 -0
- package/dist/{chunk-XU6MRYG2.js → chunk-ZIE56LCA.js} +3 -3
- package/dist/chunk-ZIE56LCA.js.map +1 -0
- package/dist/{chunk-B2LPSCES.js → chunk-ZVC3ZWLM.js} +2 -2
- package/dist/chunk-ZVC3ZWLM.js.map +1 -0
- package/dist/client.js +8 -8
- package/dist/client.js.map +1 -1
- package/dist/config/index.js +1 -1
- package/dist/errors/index.js +2 -2
- package/dist/file-router/index.js +1 -1
- package/dist/file-router/streaming-hints.js +1 -1
- package/dist/handlers/index.js +1 -1
- package/dist/index.js +30 -30
- package/dist/index.js.map +1 -1
- package/dist/islands/index.js +1 -1
- package/dist/middleware/index.js +1 -1
- package/dist/react/index.js +2 -2
- package/dist/react/index.js.map +1 -1
- package/dist/render/index.js +1 -1
- package/dist/router/index.js +1 -1
- package/dist/rsc/adapters/index.js +4 -4
- package/dist/rsc/adapters/preact.js +1 -1
- package/dist/rsc/adapters/react.js +1 -1
- package/dist/rsc/adapters/solid.js +1 -1
- package/dist/rsc/adapters/vue.js +1 -1
- package/dist/rsc/boundaries.js +1 -1
- package/dist/rsc/context.js +1 -1
- package/dist/rsc/index.js +11 -11
- package/dist/rsc/legacy.js +1 -1
- package/dist/rsc/payload.js +1 -1
- package/dist/rsc/plugins/esbuild.js +2 -2
- package/dist/rsc/plugins/index.js +4 -4
- package/dist/rsc/plugins/rollup.js +2 -2
- package/dist/rsc/renderer.js +3 -3
- package/dist/rsc/stream.js +1 -1
- package/dist/rsc/vite-plugin.js +2 -2
- package/dist/server/index.js +4 -4
- package/dist/streaming/adapters/index.js +1 -1
- package/dist/streaming/conditional.js +1 -1
- package/dist/streaming/index.js +1 -1
- package/dist/streaming/observability.js +2 -2
- package/dist/streaming/priority.js +1 -1
- package/dist/utils/index.js +1 -1
- package/package.json +1 -1
- package/dist/chunk-2JVEH76V.js.map +0 -1
- package/dist/chunk-3N5ZBVZJ.js.map +0 -1
- package/dist/chunk-3UQJE3XZ.js.map +0 -1
- package/dist/chunk-4U7CJVNQ.js.map +0 -1
- package/dist/chunk-5XHOLZBJ.js.map +0 -1
- package/dist/chunk-65JYF3DJ.js.map +0 -1
- package/dist/chunk-6GI6HFSQ.js.map +0 -1
- package/dist/chunk-6IG6XIXU.js.map +0 -1
- package/dist/chunk-A2QRUBVE.js.map +0 -1
- package/dist/chunk-A4TKWQBU.js.map +0 -1
- package/dist/chunk-B2LPSCES.js.map +0 -1
- package/dist/chunk-CKJHJPKQ.js.map +0 -1
- package/dist/chunk-CNY3ZUVG.js.map +0 -1
- package/dist/chunk-EHVUAFNH.js.map +0 -1
- package/dist/chunk-FRAH5QNY.js.map +0 -1
- package/dist/chunk-GNS2FGPC.js.map +0 -1
- package/dist/chunk-HNPO6LFW.js.map +0 -1
- package/dist/chunk-KDEA64UX.js.map +0 -1
- package/dist/chunk-LAKHYTHL.js.map +0 -1
- package/dist/chunk-LKOPJ3GS.js.map +0 -1
- package/dist/chunk-NZS2YJ43.js.map +0 -1
- package/dist/chunk-OZ3EXPLE.js.map +0 -1
- package/dist/chunk-OZBPR27I.js.map +0 -1
- package/dist/chunk-PAVI5W6M.js.map +0 -1
- package/dist/chunk-PO7IHPFF.js.map +0 -1
- package/dist/chunk-QK6UEQ75.js +0 -13
- package/dist/chunk-QK6UEQ75.js.map +0 -1
- package/dist/chunk-R7MEVVA4.js.map +0 -1
- package/dist/chunk-UFWGOJL7.js.map +0 -1
- package/dist/chunk-VNO2YUVD.js.map +0 -1
- package/dist/chunk-XU6MRYG2.js.map +0 -1
- package/dist/chunk-YNTMYL36.js.map +0 -1
package/dist/chunk-QK6UEQ75.js
DELETED
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
// src/adapters/index.ts
|
|
2
|
-
function createAdapter(options) {
|
|
3
|
-
return {
|
|
4
|
-
name: options.name,
|
|
5
|
-
adapt: options.adapt,
|
|
6
|
-
emulate: options.emulate,
|
|
7
|
-
supports: options.supports
|
|
8
|
-
};
|
|
9
|
-
}
|
|
10
|
-
|
|
11
|
-
export { createAdapter };
|
|
12
|
-
//# sourceMappingURL=chunk-QK6UEQ75.js.map
|
|
13
|
-
//# sourceMappingURL=chunk-QK6UEQ75.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/adapters/index.ts"],"names":[],"mappings":";AA2IO,SAAS,cAAc,OAAA,EAAwC;AAClE,EAAA,OAAO;AAAA,IACH,MAAM,OAAA,CAAQ,IAAA;AAAA,IACd,OAAO,OAAA,CAAQ,KAAA;AAAA,IACf,SAAS,OAAA,CAAQ,OAAA;AAAA,IACjB,UAAU,OAAA,CAAQ;AAAA,GACtB;AACJ","file":"chunk-QK6UEQ75.js","sourcesContent":["/**\n * Flight Adapters - Universal deployment adapters\n * \n * Adapters transform Flight's output for different deployment targets.\n * The user chooses where to deploy - Flight provides the adapters.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/** Build manifest containing all generated assets */\nexport interface BuildManifest {\n /** Entry points by name */\n entries: Record<string, string>;\n /** All generated files */\n files: string[];\n /** Route information */\n routes: RouteManifestEntry[];\n /** Server entry point (if applicable) */\n serverEntry?: string;\n /** Client entry point */\n clientEntry?: string;\n}\n\n/** Route information in manifest */\nexport interface RouteManifestEntry {\n /** Route path pattern */\n path: string;\n /** Render mode for this route */\n mode: 'ssr' | 'ssg' | 'csr' | 'isr';\n /** Component/handler file path */\n component: string;\n /** Pre-rendered paths (for SSG/ISR) */\n prerendered?: string[];\n}\n\n/** Builder utilities passed to adapters */\nexport interface AdapterBuilder {\n /** Build manifest */\n manifest: BuildManifest;\n /** Project root directory */\n root: string;\n /** Build output directory */\n outDir: string;\n\n /** Read a file from the build output */\n readFile(path: string): Promise<string>;\n /** Write a file to the adapter output */\n writeFile(path: string, content: string): Promise<void>;\n /** Copy files from build to adapter output */\n copy(from: string, to: string): Promise<void>;\n /** Get all files matching a pattern */\n glob(pattern: string): Promise<string[]>;\n /** Compress files for production */\n compress?(files: string[]): Promise<void>;\n\n /** Log info message */\n log: {\n info(message: string): void;\n warn(message: string): void;\n error(message: string): void;\n };\n}\n\n/** Flight adapter interface */\nexport interface FlightAdapter {\n /** Adapter name */\n name: string;\n\n /** \n * Transform the build output for the target platform\n * This is called after Flight's build process completes\n */\n adapt(builder: AdapterBuilder): Promise<void>;\n\n /**\n * Optional: Start listening for requests (for Node.js/Bun adapters)\n */\n listen?(server: unknown, port: number): Promise<void>;\n\n /**\n * Optional: Emulate the platform during development\n * Useful for testing platform-specific behavior locally\n */\n emulate?(): {\n /** Platform-specific env vars */\n env?: Record<string, string>;\n /** Custom middleware for dev server */\n middleware?: unknown[];\n };\n\n /**\n * Optional: Declare what this adapter supports\n * Flight uses this to warn about incompatible features\n */\n supports?: {\n /** Can read files at runtime (for dynamic content) */\n read?: () => boolean;\n /** Supports streaming responses */\n streaming?: () => boolean;\n /** Supports WebSockets */\n websockets?: () => boolean;\n /** Supports edge runtime */\n edge?: () => boolean;\n /** Supports Node.js runtime */\n node?: () => boolean;\n };\n}\n\n\n// ============================================================================\n// Adapter Factory Helper\n// ============================================================================\n\nexport interface AdapterOptions {\n name: string;\n adapt: (builder: AdapterBuilder) => Promise<void>;\n emulate?: FlightAdapter['emulate'];\n supports?: FlightAdapter['supports'];\n}\n\n/**\n * Create a Flight adapter\n * \n * @example\n * ```typescript\n * import { createAdapter } from '@flight-framework/core/adapters';\n * \n * export default function myAdapter(options = {}) {\n * return createAdapter({\n * name: 'my-adapter',\n * async adapt(builder) {\n * // Transform build output for your platform\n * },\n * });\n * }\n * ```\n */\nexport function createAdapter(options: AdapterOptions): FlightAdapter {\n return {\n name: options.name,\n adapt: options.adapt,\n emulate: options.emulate,\n supports: options.supports,\n };\n}\n\n// ============================================================================\n// Agnostic Service Adapters (Interfaces)\n// ============================================================================\n\n/**\n * Storage Adapter Interface\n * \n * Implement this to use any storage provider:\n * S3, Supabase Storage, Cloudflare R2, local filesystem, etc.\n */\nexport interface StorageAdapter {\n name: string;\n\n /** Upload a file */\n upload(path: string, data: Buffer | Uint8Array | string, options?: {\n contentType?: string;\n metadata?: Record<string, string>;\n }): Promise<{ url: string; path: string }>;\n\n /** Download a file */\n download(path: string): Promise<Buffer>;\n\n /** Delete a file */\n delete(path: string): Promise<void>;\n\n /** List files with optional prefix */\n list(prefix?: string): Promise<string[]>;\n\n /** Get a signed URL for direct access */\n getSignedUrl?(path: string, options?: {\n expiresIn?: number;\n operation?: 'read' | 'write';\n }): Promise<string>;\n}\n\n/**\n * Auth Adapter Interface\n * \n * Implement this to use any auth provider:\n * Better Auth, Supabase Auth, Lucia, Auth.js, etc.\n */\nexport interface AuthAdapter {\n name: string;\n\n /** Get the current user from a request */\n getUser(request: Request): Promise<AuthUser | null>;\n\n /** Verify a session token */\n verifySession(token: string): Promise<AuthSession | null>;\n\n /** Optional middleware for handling auth-specific routes (e.g., /api/auth/*) */\n middleware?: (req: Request) => Promise<Response | null>;\n}\n\nexport interface AuthUser {\n id: string;\n email?: string;\n name?: string;\n avatar?: string;\n metadata?: Record<string, unknown>;\n}\n\nexport interface AuthSession {\n user: AuthUser;\n expiresAt: Date;\n token: string;\n}\n\n/**\n * Email Adapter Interface\n * \n * Implement this to use any email provider:\n * Resend, SendGrid, Postmark, SMTP, etc.\n */\nexport interface EmailAdapter {\n name: string;\n\n /** Send an email */\n send(options: {\n to: string | string[];\n subject: string;\n html?: string;\n text?: string;\n from?: string;\n replyTo?: string;\n attachments?: Array<{\n filename: string;\n content: Buffer | string;\n contentType?: string;\n }>;\n }): Promise<{ id: string; success: boolean }>;\n}\n\n/**\n * Queue/Jobs Adapter Interface\n * \n * Implement this to use any job queue:\n * BullMQ, Quirrel, Inngest, custom, etc.\n */\nexport interface JobsAdapter {\n name: string;\n\n /** Add a job to the queue */\n enqueue<T>(jobName: string, data: T, options?: {\n delay?: number;\n priority?: number;\n retries?: number;\n }): Promise<{ id: string }>;\n\n /** Schedule a recurring job */\n schedule?(jobName: string, cron: string, data?: unknown): Promise<{ id: string }>;\n\n /** Cancel a job */\n cancel?(jobId: string): Promise<void>;\n}\n\n/**\n * Database Adapter Interface\n * \n * Note: This is intentionally minimal. \n * For databases, use your preferred ORM/query builder directly.\n * This interface is for Flight's internal use (sessions, cache, etc.)\n */\nexport interface DatabaseAdapter {\n name: string;\n\n /** Raw query execution */\n query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\n\n /** Execute a mutation */\n execute(sql: string, params?: unknown[]): Promise<{ rowsAffected: number }>;\n\n /** Transaction support */\n transaction?<T>(fn: (tx: DatabaseAdapter) => Promise<T>): Promise<T>;\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/middleware/index.ts"],"names":[],"mappings":"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","file":"chunk-R7MEVVA4.js","sourcesContent":["/**\n * Flight Middleware - Composable request/response handlers\n * \n * Framework-agnostic middleware system inspired by Koa/Hono.\n * Provides primitives for building your own middleware solutions.\n * \n * @example\n * ```typescript\n * // Type-safe middleware with custom variables (Hono pattern)\n * interface MyLocals {\n * user: { id: string; role: string };\n * requestId: string;\n * }\n * \n * const authMiddleware: Middleware<MyLocals> = async (ctx, next) => {\n * ctx.locals.user = { id: '123', role: 'admin' };\n * await next();\n * };\n * ```\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Request context passed through middleware chain.\n * \n * Supports generic type parameter for type-safe locals (like Hono Variables).\n * \n * @typeParam TLocals - Type of the locals object for type-safe middleware data sharing\n * \n * @example\n * ```typescript\n * interface AppLocals {\n * user: User;\n * db: DatabaseClient;\n * }\n * \n * const ctx: MiddlewareContext<AppLocals> = createContextFromRequest(request);\n * ctx.locals.user = currentUser; // Type-safe!\n * ```\n */\nexport interface MiddlewareContext<TLocals extends Record<string, unknown> = Record<string, unknown>> {\n /** Request URL */\n url: URL;\n /** Request method */\n method: string;\n /** Request headers */\n headers: Headers;\n /** URL parameters from routing */\n params: Record<string, string | string[]>;\n /** Query parameters */\n query: URLSearchParams;\n /** Parsed request body (if any) */\n body?: unknown;\n /** Local data shared between middleware - type-safe with generics */\n locals: TLocals;\n /** Original request (platform-specific) */\n request?: Request;\n\n // Response building\n /** Response status code */\n status: number;\n /** Response headers */\n responseHeaders: Headers;\n /** Response body */\n responseBody?: BodyInit | null;\n}\n\n/** Next function to call the next middleware */\nexport type MiddlewareNext = () => Promise<void>;\n\n/**\n * Middleware function signature with optional typed locals.\n * \n * @typeParam TLocals - Type of the locals object for type-safe data sharing\n */\nexport type Middleware<TLocals extends Record<string, unknown> = Record<string, unknown>> = (\n ctx: MiddlewareContext<TLocals>,\n next: MiddlewareNext\n) => Promise<void> | void;\n\n/** Middleware with optional path matching */\nexport interface MiddlewareDefinition {\n /** Path pattern to match (undefined = match all) */\n path?: string | RegExp;\n /** HTTP methods to match (undefined = match all) */\n methods?: string[];\n /** The middleware function */\n handler: Middleware;\n}\n\n// ============================================================================\n// Middleware Chain\n// ============================================================================\n\nexport interface MiddlewareChain {\n /** Add middleware to the chain */\n use(middleware: Middleware): MiddlewareChain;\n use(path: string, middleware: Middleware): MiddlewareChain;\n use(definition: MiddlewareDefinition): MiddlewareChain;\n\n /** Execute the middleware chain */\n execute(ctx: MiddlewareContext): Promise<void>;\n\n /** Get all middleware definitions */\n middlewares(): MiddlewareDefinition[];\n}\n\n/**\n * Create a new middleware chain\n */\nexport function createMiddlewareChain(): MiddlewareChain {\n const stack: MiddlewareDefinition[] = [];\n\n function use(\n pathOrMiddleware: string | Middleware | MiddlewareDefinition,\n maybeMiddleware?: Middleware\n ): MiddlewareChain {\n if (typeof pathOrMiddleware === 'function') {\n // use(middleware)\n stack.push({ handler: pathOrMiddleware });\n } else if (typeof pathOrMiddleware === 'string' && maybeMiddleware) {\n // use(path, middleware)\n stack.push({ path: pathOrMiddleware, handler: maybeMiddleware });\n } else if (typeof pathOrMiddleware === 'object') {\n // use(definition)\n stack.push(pathOrMiddleware);\n }\n return chain;\n }\n\n async function execute(ctx: MiddlewareContext): Promise<void> {\n let index = -1;\n\n async function dispatch(i: number): Promise<void> {\n if (i <= index) {\n throw new Error('next() called multiple times');\n }\n index = i;\n\n if (i >= stack.length) {\n return;\n }\n\n const definition = stack[i];\n if (!definition) {\n return dispatch(i + 1);\n }\n\n // Check if middleware should run\n if (!shouldRun(definition, ctx)) {\n return dispatch(i + 1);\n }\n\n await definition.handler(ctx, () => dispatch(i + 1));\n }\n\n await dispatch(0);\n }\n\n const chain: MiddlewareChain = {\n use: use as MiddlewareChain['use'],\n execute,\n middlewares: () => [...stack],\n };\n\n return chain;\n}\n\n/**\n * Check if a middleware should run for the given context\n */\nfunction shouldRun(def: MiddlewareDefinition, ctx: MiddlewareContext): boolean {\n // Check method\n if (def.methods && !def.methods.includes(ctx.method.toUpperCase())) {\n return false;\n }\n\n // Check path\n if (def.path) {\n const path = ctx.url.pathname;\n\n if (typeof def.path === 'string') {\n // Simple path matching (supports wildcards)\n if (def.path.endsWith('*')) {\n const prefix = def.path.slice(0, -1);\n if (!path.startsWith(prefix)) {\n return false;\n }\n } else if (def.path !== path) {\n return false;\n }\n } else if (def.path instanceof RegExp) {\n if (!def.path.test(path)) {\n return false;\n }\n }\n }\n\n return true;\n}\n\n// ============================================================================\n// Built-in Middleware Factories\n// ============================================================================\n\n/**\n * CORS middleware factory\n */\n/**\n * CORS options for configuring cross-origin requests.\n */\nexport interface CorsOptions {\n /** \n * Allowed origins. Can be:\n * - '*' for any origin\n * - A specific origin string\n * - An array of allowed origins\n * - A function that returns true if origin is allowed\n * - An async function for dynamic origin validation\n */\n origin?: string | string[] | ((origin: string) => boolean | Promise<boolean>);\n /** Allowed HTTP methods */\n methods?: string[];\n /** Allowed headers */\n headers?: string[];\n /** Whether to include credentials */\n credentials?: boolean;\n /** Preflight cache duration in seconds */\n maxAge?: number;\n /** Exposed headers that can be accessed from the response */\n exposeHeaders?: string[];\n}\n\n/**\n * CORS middleware factory.\n * \n * Handles cross-origin resource sharing with best practices:\n * - Adds Vary: Origin for dynamic origins (CDN compatibility)\n * - Supports async origin validation\n * - Proper preflight handling\n * \n * @example\n * ```typescript\n * // Allow specific origins\n * chain.use(cors({ origin: ['https://app.example.com'] }));\n * \n * // Dynamic validation\n * chain.use(cors({\n * origin: async (origin) => {\n * return await db.allowedOrigins.exists(origin);\n * }\n * }));\n * ```\n */\nexport function cors(options: CorsOptions = {}): Middleware {\n const {\n origin = '*',\n methods = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS'],\n headers = ['Content-Type', 'Authorization'],\n credentials = false,\n maxAge = 86400,\n exposeHeaders = [],\n } = options;\n\n // Track if origin is dynamic (requires Vary header)\n const isDynamicOrigin = typeof origin === 'function' || Array.isArray(origin);\n\n return async (ctx, next) => {\n const requestOrigin = ctx.headers.get('Origin') || '';\n\n // Add Vary: Origin for dynamic origins (CDN/cache compatibility)\n if (isDynamicOrigin) {\n const existingVary = ctx.responseHeaders.get('Vary');\n if (existingVary) {\n if (!existingVary.includes('Origin')) {\n ctx.responseHeaders.set('Vary', `${existingVary}, Origin`);\n }\n } else {\n ctx.responseHeaders.set('Vary', 'Origin');\n }\n }\n\n // Determine allowed origin\n let allowedOrigin: string | null = null;\n if (origin === '*') {\n allowedOrigin = '*';\n } else if (typeof origin === 'string') {\n allowedOrigin = origin;\n } else if (Array.isArray(origin)) {\n if (origin.includes(requestOrigin)) {\n allowedOrigin = requestOrigin;\n }\n } else if (typeof origin === 'function') {\n const isAllowed = await origin(requestOrigin);\n if (isAllowed) {\n allowedOrigin = requestOrigin;\n }\n }\n\n if (allowedOrigin) {\n ctx.responseHeaders.set('Access-Control-Allow-Origin', allowedOrigin);\n ctx.responseHeaders.set('Access-Control-Allow-Methods', methods.join(', '));\n ctx.responseHeaders.set('Access-Control-Allow-Headers', headers.join(', '));\n\n if (credentials) {\n ctx.responseHeaders.set('Access-Control-Allow-Credentials', 'true');\n }\n\n if (maxAge) {\n ctx.responseHeaders.set('Access-Control-Max-Age', String(maxAge));\n }\n\n if (exposeHeaders.length > 0) {\n ctx.responseHeaders.set('Access-Control-Expose-Headers', exposeHeaders.join(', '));\n }\n }\n\n // Handle preflight\n if (ctx.method === 'OPTIONS') {\n ctx.status = 204;\n ctx.responseBody = null;\n return;\n }\n\n await next();\n };\n}\n// ============================================================================\n// Logger Types and Constants\n// ============================================================================\n\n/** Log levels in order of verbosity */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';\n\n/** Log format types */\nexport type LogFormat = 'pretty' | 'json' | 'combined' | 'common' | 'short' | 'tiny';\n\n/** Log entry structure for JSON format */\nexport interface LogEntry {\n timestamp: string;\n level: LogLevel;\n method: string;\n path: string;\n status: number;\n duration: number;\n userAgent?: string;\n ip?: string;\n [key: string]: unknown;\n}\n\n/** Custom log writer function */\nexport type LogWriter = (entry: LogEntry, formatted: string) => void;\n\n/** Logger options */\nexport interface LoggerOptions {\n /** Minimum log level (default: 'info') */\n level?: LogLevel;\n /** Output format (default: 'pretty') */\n format?: LogFormat;\n /** Skip logging for certain requests */\n skip?: (ctx: MiddlewareContext) => boolean;\n /** Custom log writer (replaces console output) */\n writer?: LogWriter;\n /** Include request headers in logs */\n includeHeaders?: boolean;\n /** Colorize output (only for 'pretty' format, default: true) */\n colorize?: boolean;\n}\n\nconst LOG_LEVEL_PRIORITY: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n silent: 4,\n};\n\nconst LOG_LEVEL_COLORS: Record<LogLevel, string> = {\n debug: '\\x1b[36m', // Cyan\n info: '\\x1b[32m', // Green\n warn: '\\x1b[33m', // Yellow\n error: '\\x1b[31m', // Red\n silent: '',\n};\n\nconst STATUS_COLORS: Record<string, string> = {\n '2': '\\x1b[32m', // Green for 2xx\n '3': '\\x1b[36m', // Cyan for 3xx\n '4': '\\x1b[33m', // Yellow for 4xx\n '5': '\\x1b[31m', // Red for 5xx\n};\n\nconst RESET = '\\x1b[0m';\nconst DIM = '\\x1b[2m';\n\n/**\n * Professional logger middleware with configurable levels\n * \n * @example\n * ```typescript\n * // Basic usage\n * server.use(logger());\n * \n * // With level control\n * server.use(logger({ level: 'warn' })); // Only warn and error\n * \n * // JSON format for production/observability\n * server.use(logger({ format: 'json', level: 'info' }));\n * \n * // Custom writer (e.g., for external logging service)\n * server.use(logger({\n * writer: (entry) => myLoggingService.log(entry)\n * }));\n * \n * // Silent in production\n * server.use(logger({ level: process.env.NODE_ENV === 'production' ? 'error' : 'debug' }));\n * ```\n */\nexport function logger(options: LoggerOptions = {}): Middleware {\n const {\n level = 'info',\n format = 'pretty',\n skip,\n writer,\n includeHeaders = false,\n colorize = true,\n } = options;\n\n // Helper to format and output log\n const outputLog = (\n ctx: MiddlewareContext,\n logLevel: LogLevel,\n startTime: string,\n duration: number,\n error?: Error\n ): void => {\n const status = error ? 500 : ctx.status;\n const userAgent = ctx.headers.get('user-agent');\n const forwardedFor = ctx.headers.get('x-forwarded-for');\n const ip = forwardedFor || 'unknown';\n\n // Build log entry\n const entry: LogEntry = {\n timestamp: startTime,\n level: logLevel,\n method: ctx.method,\n path: ctx.url.pathname,\n status,\n duration,\n };\n\n if (userAgent) entry.userAgent = userAgent;\n entry.ip = ip;\n\n if (error) {\n entry.error = error.message;\n entry.stack = error.stack;\n }\n\n if (includeHeaders) {\n const headers: Record<string, string> = {};\n ctx.headers.forEach((value, key) => {\n if (!key.toLowerCase().includes('authorization')) {\n headers[key] = value;\n }\n });\n entry.headers = headers;\n }\n\n // Format the log line\n let formatted: string;\n\n switch (format) {\n case 'json':\n formatted = JSON.stringify(entry);\n break;\n\n case 'combined':\n formatted = `${ip} - - [${startTime}] \"${ctx.method} ${ctx.url.pathname}\" ${status} - \"${userAgent || '-'}\"`;\n break;\n\n case 'common':\n formatted = `${ip} - - [${startTime}] \"${ctx.method} ${ctx.url.pathname}\" ${status}`;\n break;\n\n case 'short':\n formatted = `${ctx.method} ${ctx.url.pathname} ${status} ${duration}ms`;\n break;\n\n case 'tiny':\n formatted = `${ctx.method} ${ctx.url.pathname} ${status}`;\n break;\n\n case 'pretty':\n default:\n if (colorize) {\n const statusFirstChar = String(status).charAt(0) || '2';\n const statusColor = STATUS_COLORS[statusFirstChar] ?? '';\n const levelColor = LOG_LEVEL_COLORS[logLevel];\n const errorSuffix = error ? ` ${LOG_LEVEL_COLORS.error}[${error.message}]${RESET}` : '';\n formatted = `${DIM}${startTime}${RESET} ${levelColor}${logLevel.toUpperCase().padEnd(5)}${RESET} ${ctx.method.padEnd(7)} ${ctx.url.pathname} ${statusColor}${status}${RESET} ${DIM}${duration}ms${RESET}${errorSuffix}`;\n } else {\n const errorSuffix = error ? ` [${error.message}]` : '';\n formatted = `${startTime} ${logLevel.toUpperCase().padEnd(5)} ${ctx.method.padEnd(7)} ${ctx.url.pathname} ${status} ${duration}ms${errorSuffix}`;\n }\n break;\n }\n\n // Output\n if (writer) {\n writer(entry, formatted);\n } else {\n switch (logLevel) {\n case 'error':\n console.error(formatted);\n break;\n case 'warn':\n console.warn(formatted);\n break;\n case 'debug':\n console.debug(formatted);\n break;\n default:\n console.log(formatted);\n }\n }\n };\n\n return async (ctx, next) => {\n // Skip if configured\n if (skip?.(ctx)) {\n return next();\n }\n\n const start = Date.now();\n const startTime = new Date().toISOString();\n\n try {\n await next();\n\n const duration = Date.now() - start;\n const status = ctx.status;\n\n // Determine log level based on status\n let logLevel: LogLevel = 'info';\n if (status >= 500) {\n logLevel = 'error';\n } else if (status >= 400) {\n logLevel = 'warn';\n } else if (status >= 300) {\n logLevel = 'info';\n } else {\n logLevel = 'debug';\n }\n\n // Check if we should log based on level\n if (LOG_LEVEL_PRIORITY[logLevel] >= LOG_LEVEL_PRIORITY[level]) {\n outputLog(ctx, logLevel, startTime, duration);\n }\n } catch (error) {\n // Always log errors, then re-throw\n const duration = Date.now() - start;\n if (LOG_LEVEL_PRIORITY.error >= LOG_LEVEL_PRIORITY[level]) {\n outputLog(ctx, 'error', startTime, duration, error as Error);\n }\n throw error;\n }\n };\n}\n\n/**\n * Security headers middleware\n */\nexport function securityHeaders(options: {\n contentSecurityPolicy?: string | false;\n xFrameOptions?: 'DENY' | 'SAMEORIGIN' | false;\n xContentTypeOptions?: boolean;\n referrerPolicy?: string;\n permissionsPolicy?: string;\n} = {}): Middleware {\n const {\n contentSecurityPolicy = \"default-src 'self'\",\n xFrameOptions = 'DENY',\n xContentTypeOptions = true,\n referrerPolicy = 'strict-origin-when-cross-origin',\n permissionsPolicy,\n } = options;\n\n return async (ctx, next) => {\n if (contentSecurityPolicy) {\n ctx.responseHeaders.set('Content-Security-Policy', contentSecurityPolicy);\n }\n if (xFrameOptions) {\n ctx.responseHeaders.set('X-Frame-Options', xFrameOptions);\n }\n if (xContentTypeOptions) {\n ctx.responseHeaders.set('X-Content-Type-Options', 'nosniff');\n }\n if (referrerPolicy) {\n ctx.responseHeaders.set('Referrer-Policy', referrerPolicy);\n }\n if (permissionsPolicy) {\n ctx.responseHeaders.set('Permissions-Policy', permissionsPolicy);\n }\n\n await next();\n };\n}\n\n/**\n * Compression middleware (requires implementation in adapter)\n */\nexport function compress(): Middleware {\n return async (ctx, next) => {\n // Mark that compression is desired\n ctx.locals['flight:compress'] = true;\n await next();\n };\n}\n\n// ============================================================================\n// Error Handler Middleware\n// ============================================================================\n\n/**\n * Error information passed to error handlers.\n */\nexport interface ErrorInfo {\n /** The original error */\n error: Error;\n /** HTTP status code (derived from error or default 500) */\n status: number;\n /** Error code for categorization */\n code?: string;\n /** Request context */\n ctx: MiddlewareContext;\n /** Request timestamp */\n timestamp: string;\n}\n\n/**\n * Error handler options.\n */\nexport interface ErrorHandlerOptions {\n /**\n * Custom error handler function.\n * Called when an error is caught. Can modify ctx to set response.\n * If not provided, a default JSON response is sent.\n */\n onError?: (info: ErrorInfo) => void | Promise<void>;\n\n /**\n * Whether to expose error details in response.\n * Set to false in production to hide internal error messages.\n * @default false\n */\n expose?: boolean;\n\n /**\n * Default status code for errors without a status property.\n * @default 500\n */\n defaultStatus?: number;\n\n /**\n * Emit error events for centralized logging (Koa pattern).\n * Provide a function to receive error events.\n */\n emit?: (error: Error, ctx: MiddlewareContext) => void;\n}\n\n/**\n * Error handler middleware factory.\n * \n * Provides centralized error handling following Koa best practices:\n * - Catches all downstream errors\n * - Sets appropriate status codes\n * - Supports custom error handlers\n * - Supports error event emission for logging\n * \n * Place this as one of the FIRST middleware in your chain.\n * \n * @example\n * ```typescript\n * // Basic usage - default JSON error response\n * chain.use(errorHandler());\n * \n * // With custom handler\n * chain.use(errorHandler({\n * onError: ({ error, status, ctx }) => {\n * ctx.status = status;\n * ctx.responseBody = JSON.stringify({\n * error: error.message,\n * code: 'SERVER_ERROR'\n * });\n * },\n * emit: (error, ctx) => {\n * logger.error('Request error:', error);\n * errorTracker.capture(error);\n * }\n * }));\n * \n * // Production-safe (hide error details)\n * chain.use(errorHandler({ expose: false }));\n * ```\n */\nexport function errorHandler(options: ErrorHandlerOptions = {}): Middleware {\n const {\n onError,\n expose = false,\n defaultStatus = 500,\n emit,\n } = options;\n\n return async (ctx, next) => {\n try {\n await next();\n } catch (err) {\n const error = err instanceof Error ? err : new Error(String(err));\n\n // Extract status from error if available\n const status = (error as Error & { status?: number; statusCode?: number }).status\n ?? (error as Error & { status?: number; statusCode?: number }).statusCode\n ?? defaultStatus;\n\n // Extract error code if available\n const code = (error as Error & { code?: string }).code;\n\n const timestamp = new Date().toISOString();\n\n const errorInfo: ErrorInfo = {\n error,\n status,\n code,\n ctx,\n timestamp,\n };\n\n // Emit error event for centralized logging (Koa pattern)\n if (emit) {\n try {\n emit(error, ctx);\n } catch {\n // Ignore emission errors to prevent infinite loops\n }\n }\n\n // Call custom error handler if provided\n if (onError) {\n await onError(errorInfo);\n } else {\n // Default error response\n ctx.status = status;\n ctx.responseHeaders.set('Content-Type', 'application/json');\n\n const body = expose\n ? {\n error: error.message,\n code,\n status,\n timestamp,\n stack: error.stack,\n }\n : {\n error: status >= 500 ? 'Internal Server Error' : error.message,\n code,\n status,\n timestamp,\n };\n\n ctx.responseBody = JSON.stringify(body);\n }\n }\n };\n}\n\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Create a middleware context from a Web Request\n */\nexport function createContextFromRequest(\n request: Request,\n params: Record<string, string | string[]> = {}\n): MiddlewareContext {\n const url = new URL(request.url);\n\n return {\n url,\n method: request.method,\n headers: request.headers,\n params,\n query: url.searchParams,\n locals: {},\n request,\n status: 200,\n responseHeaders: new Headers(),\n };\n}\n\n/**\n * Create a Web Response from middleware context\n */\nexport function createResponseFromContext(ctx: MiddlewareContext): Response {\n return new Response(ctx.responseBody, {\n status: ctx.status,\n headers: ctx.responseHeaders,\n });\n}\n\n/**\n * Compose multiple middleware into one\n */\nexport function compose(...middlewares: Middleware[]): Middleware {\n return async (ctx, next) => {\n let index = -1;\n\n async function dispatch(i: number): Promise<void> {\n if (i <= index) {\n throw new Error('next() called multiple times');\n }\n index = i;\n\n const fn = i === middlewares.length ? next : middlewares[i];\n\n if (fn) {\n await fn(ctx, () => dispatch(i + 1));\n }\n }\n\n await dispatch(0);\n };\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/islands/index.ts"],"names":[],"mappings":"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","file":"chunk-UFWGOJL7.js","sourcesContent":["/**\n * @flight-framework/core - Islands Architecture\n * \n * Selective hydration with fine-grained control over when and how\n * components become interactive. Framework-agnostic islands primitives.\n * \n * Best Practices 2026:\n * - Minimal JavaScript: Only hydrate what needs interactivity\n * - Lazy hydration: Load JS when actually needed\n * - Progressive enhancement: Works without JS\n * - Performance: Reduce main thread work\n * \n * @example\n * ```typescript\n * import { defineIsland, renderIsland, hydrateIslands } from '@flight-framework/core/islands';\n * \n * // Server: Define an interactive island\n * const Counter = defineIsland({\n * id: 'counter',\n * component: CounterComponent,\n * hydrate: 'visible', // Only hydrate when scrolled into view\n * });\n * \n * // Server: Render to HTML with island markers\n * const html = await renderIsland(Counter, { initial: 0 });\n * \n * // Client: Hydrate all islands on the page\n * hydrateIslands();\n * ```\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * When to hydrate the island\n */\nexport type HydrationTrigger =\n | 'load' // Immediate: hydrate as soon as JS loads\n | 'idle' // When browser is idle (requestIdleCallback)\n | 'visible' // When island enters viewport (IntersectionObserver)\n | 'interaction' // On first user interaction (click, focus, hover)\n | 'media' // When media query matches\n | 'never' // Never hydrate (static HTML only)\n | CustomHydrationTrigger;\n\n/**\n * Custom hydration trigger function\n */\nexport interface CustomHydrationTrigger {\n type: 'custom';\n /** Name for debugging */\n name: string;\n /** Function that returns a promise resolving when hydration should occur */\n when: (element: HTMLElement) => Promise<void>;\n}\n\n/**\n * Island configuration\n */\nexport interface IslandConfig<P = Record<string, unknown>> {\n /** Unique identifier for this island type */\n id: string;\n /** The component to render (framework-specific) */\n component: unknown;\n /** When to hydrate on client */\n hydrate: HydrationTrigger;\n /** Default props */\n defaultProps?: P;\n /** Media query for 'media' trigger */\n mediaQuery?: string;\n /** Path to client-side component bundle */\n clientEntry?: string;\n /** Fallback HTML while not hydrated (optional override) */\n fallback?: string;\n /** Loading priority hint */\n priority?: 'high' | 'low';\n}\n\n/**\n * Island instance with props\n */\nexport interface Island<P = Record<string, unknown>> {\n /** Island configuration */\n config: IslandConfig<P>;\n /** Instance props */\n props: P;\n /** Unique instance ID (for multiple instances of same island type) */\n instanceId: string;\n}\n\n/**\n * Rendered island HTML with metadata\n */\nexport interface RenderedIsland {\n /** The HTML string */\n html: string;\n /** Island ID */\n id: string;\n /** Instance ID */\n instanceId: string;\n /** Serialized props for hydration */\n propsScript: string;\n /** CSS if any */\n css?: string;\n}\n\n/**\n * Island registry for client-side hydration\n */\nexport interface IslandRegistry {\n /** Register a component for an island ID */\n register(id: string, loader: () => Promise<unknown>): void;\n /** Get registered loader */\n get(id: string): (() => Promise<unknown>) | undefined;\n /** Check if island is registered */\n has(id: string): boolean;\n}\n\n/**\n * Client-side hydration options\n */\nexport interface HydrateOptions {\n /** Root element to scan for islands */\n root?: HTMLElement;\n /** Custom island registry */\n registry?: IslandRegistry;\n /** Callback when an island is hydrated */\n onHydrate?: (id: string, instanceId: string, duration: number) => void;\n /** Callback on hydration error */\n onError?: (id: string, error: Error) => void;\n}\n\n// ============================================================================\n// Server-Side: Island Definition\n// ============================================================================\n\nlet instanceCounter = 0;\n\n/**\n * Generate a unique instance ID\n */\nfunction generateInstanceId(islandId: string): string {\n return `${islandId}:${++instanceCounter}:${Math.random().toString(36).slice(2, 7)}`;\n}\n\n/**\n * Define an island component\n */\nexport function defineIsland<P = Record<string, unknown>>(\n config: IslandConfig<P>\n): (props?: P) => Island<P> {\n return (props?: P) => ({\n config,\n props: { ...config.defaultProps, ...props } as P,\n instanceId: generateInstanceId(config.id),\n });\n}\n\n/**\n * Serialize props for client-side hydration\n */\nfunction serializeProps(props: Record<string, unknown>): string {\n try {\n return JSON.stringify(props);\n } catch {\n console.warn('[Flight Islands] Props are not serializable, using empty object');\n return '{}';\n }\n}\n\n/**\n * Get hydration trigger attribute value\n */\nfunction getHydrateAttr(trigger: HydrationTrigger): string {\n if (typeof trigger === 'object' && trigger.type === 'custom') {\n return `custom:${trigger.name}`;\n }\n return trigger as string;\n}\n\n// ============================================================================\n// Server-Side: Island Rendering\n// ============================================================================\n\n/**\n * UI framework adapter for island rendering\n */\nexport interface IslandRenderAdapter {\n /** Framework name */\n name: string;\n /** Render component to HTML */\n renderToString(component: unknown, props: Record<string, unknown>): Promise<string>;\n /** Get CSS if any */\n getCSS?(component: unknown): string;\n}\n\nlet globalAdapter: IslandRenderAdapter | null = null;\n\n/**\n * Set the global island render adapter\n */\nexport function setIslandAdapter(adapter: IslandRenderAdapter): void {\n globalAdapter = adapter;\n}\n\n/**\n * Render an island to HTML with hydration markers\n */\nexport async function renderIsland<P extends Record<string, unknown>>(\n island: Island<P>,\n adapter?: IslandRenderAdapter\n): Promise<RenderedIsland> {\n const renderAdapter = adapter || globalAdapter;\n\n if (!renderAdapter) {\n throw new Error(\n '[Flight Islands] No render adapter set. Call setIslandAdapter() or pass adapter to renderIsland().'\n );\n }\n\n const { config, props, instanceId } = island;\n\n // Render component to HTML\n const componentHtml = await renderAdapter.renderToString(config.component, props);\n const css = renderAdapter.getCSS?.(config.component);\n\n // Build island wrapper with data attributes\n const hydrateAttr = getHydrateAttr(config.hydrate);\n const propsJson = serializeProps(props);\n\n const html = `\n<flight-island \n data-island=\"${config.id}\"\n data-instance=\"${instanceId}\"\n data-hydrate=\"${hydrateAttr}\"\n ${config.mediaQuery ? `data-media=\"${config.mediaQuery}\"` : ''}\n ${config.clientEntry ? `data-entry=\"${config.clientEntry}\"` : ''}\n ${config.priority ? `data-priority=\"${config.priority}\"` : ''}\n>\n ${componentHtml}\n</flight-island>`;\n\n // Props script (inline for hydration)\n const propsScript = `<script type=\"application/json\" data-island-props=\"${instanceId}\">${propsJson}</script>`;\n\n return {\n html,\n id: config.id,\n instanceId,\n propsScript,\n css,\n };\n}\n\n/**\n * Render multiple islands and collect their outputs\n */\nexport async function renderIslands<P extends Record<string, unknown>>(\n islands: Island<P>[],\n adapter?: IslandRenderAdapter\n): Promise<{\n html: string;\n propsScripts: string;\n css: string;\n}> {\n const rendered = await Promise.all(\n islands.map(island => renderIsland(island, adapter))\n );\n\n return {\n html: rendered.map(r => r.html).join('\\n'),\n propsScripts: rendered.map(r => r.propsScript).join('\\n'),\n css: rendered.filter(r => r.css).map(r => r.css).join('\\n'),\n };\n}\n\n// ============================================================================\n// Client-Side: Island Hydration\n// ============================================================================\n\n/**\n * Create an island registry for client-side hydration\n */\nexport function createIslandRegistry(): IslandRegistry {\n const loaders = new Map<string, () => Promise<unknown>>();\n\n return {\n register(id: string, loader: () => Promise<unknown>) {\n loaders.set(id, loader);\n },\n get(id: string) {\n return loaders.get(id);\n },\n has(id: string) {\n return loaders.has(id);\n },\n };\n}\n\n// Global registry for convenience\nconst globalRegistry = createIslandRegistry();\n\n/**\n * Register an island component for client-side hydration\n */\nexport function registerIsland(id: string, loader: () => Promise<unknown>): void {\n globalRegistry.register(id, loader);\n}\n\n/**\n * Client-side hydration bootstrapper\n * Call this in your client entry point\n */\nexport function hydrateIslands(options?: HydrateOptions): void {\n const {\n root = typeof document !== 'undefined' ? document.body : null,\n registry = globalRegistry,\n onHydrate,\n onError,\n } = options || {};\n\n if (!root || typeof document === 'undefined') {\n console.warn('[Flight Islands] hydrateIslands called in non-browser environment');\n return;\n }\n\n // Find all island elements\n const islands = root.querySelectorAll<HTMLElement>('flight-island[data-island]');\n\n islands.forEach((element) => {\n const islandId = element.dataset.island!;\n const instanceId = element.dataset.instance!;\n const hydrateTrigger = element.dataset.hydrate as string;\n const mediaQuery = element.dataset.media;\n\n // Check if component is registered\n if (!registry.has(islandId)) {\n console.warn(`[Flight Islands] No component registered for island: ${islandId}`);\n return;\n }\n\n // Setup hydration based on trigger\n setupHydration(\n element,\n islandId,\n instanceId,\n hydrateTrigger,\n mediaQuery,\n registry,\n onHydrate,\n onError\n );\n });\n}\n\n/**\n * Setup hydration trigger for an island element\n */\nfunction setupHydration(\n element: HTMLElement,\n islandId: string,\n instanceId: string,\n trigger: string,\n mediaQuery: string | undefined,\n registry: IslandRegistry,\n onHydrate?: (id: string, instanceId: string, duration: number) => void,\n onError?: (id: string, error: Error) => void\n): void {\n const hydrate = async () => {\n const startTime = performance.now();\n\n try {\n // Load component\n const loader = registry.get(islandId)!;\n const module = await loader() as { default?: unknown };\n const Component = module.default || module;\n\n // Get props\n const propsScript = document.querySelector(`[data-island-props=\"${instanceId}\"]`);\n const props = propsScript ? JSON.parse(propsScript.textContent || '{}') : {};\n\n // Hydrate (framework-specific, emit event for now)\n element.dispatchEvent(new CustomEvent('flight:hydrate', {\n detail: { Component, props, islandId, instanceId },\n bubbles: true,\n }));\n\n // Mark as hydrated\n element.setAttribute('data-hydrated', 'true');\n\n const duration = performance.now() - startTime;\n onHydrate?.(islandId, instanceId, duration);\n\n } catch (error) {\n console.error(`[Flight Islands] Failed to hydrate ${islandId}:`, error);\n element.setAttribute('data-hydrate-error', 'true');\n onError?.(islandId, error as Error);\n }\n };\n\n // Skip if already hydrated\n if (element.hasAttribute('data-hydrated')) return;\n\n switch (trigger) {\n case 'load':\n // Immediate hydration\n hydrate();\n break;\n\n case 'idle':\n // When browser is idle\n if ('requestIdleCallback' in window) {\n (window as unknown as { requestIdleCallback: (cb: () => void, opts?: { timeout: number }) => void })\n .requestIdleCallback(() => hydrate(), { timeout: 2000 });\n } else {\n setTimeout(hydrate, 200);\n }\n break;\n\n case 'visible': {\n // When element enters viewport\n const observer = new IntersectionObserver(\n (entries) => {\n entries.forEach((entry) => {\n if (entry.isIntersecting) {\n observer.disconnect();\n hydrate();\n }\n });\n },\n { rootMargin: '50px' }\n );\n observer.observe(element);\n break;\n }\n\n case 'interaction': {\n // On first user interaction\n const events = ['click', 'focus', 'touchstart', 'mouseenter'];\n const onInteraction = () => {\n events.forEach(e => element.removeEventListener(e, onInteraction));\n hydrate();\n };\n events.forEach(e => element.addEventListener(e, onInteraction, { once: true, passive: true }));\n break;\n }\n\n case 'media':\n // When media query matches\n if (mediaQuery) {\n const mql = window.matchMedia(mediaQuery);\n const check = () => {\n if (mql.matches) {\n mql.removeEventListener('change', check);\n hydrate();\n }\n };\n if (mql.matches) {\n hydrate();\n } else {\n mql.addEventListener('change', check);\n }\n }\n break;\n\n case 'never':\n // Never hydrate\n break;\n\n default:\n // Custom trigger\n if (trigger.startsWith('custom:')) {\n // Custom triggers need manual setup\n element.dispatchEvent(new CustomEvent('flight:custom-hydrate', {\n detail: { hydrate, trigger: trigger.replace('custom:', '') },\n bubbles: true,\n }));\n }\n }\n}\n\n// ============================================================================\n// Utility: Framework-Specific Adapter Factories\n// These return adapters that users configure with their own framework imports\n// ============================================================================\n\n/**\n * Create a React island render adapter\n * \n * @example\n * ```typescript\n * import { renderToString } from 'react-dom/server';\n * import { createElement } from 'react';\n * \n * const reactAdapter = createReactIslandAdapter({\n * renderToString,\n * createElement,\n * });\n * ```\n */\nexport function createReactIslandAdapter(deps: {\n renderToString: (element: unknown) => string;\n createElement: (type: unknown, props?: unknown) => unknown;\n}): IslandRenderAdapter {\n return {\n name: 'react',\n async renderToString(component, props) {\n const element = deps.createElement(component, props);\n return deps.renderToString(element);\n },\n };\n}\n\n/**\n * Create a Preact island render adapter\n * \n * @example\n * ```typescript\n * import { renderToString } from 'preact-render-to-string';\n * import { h } from 'preact';\n * \n * const preactAdapter = createPreactIslandAdapter({\n * renderToString,\n * h,\n * });\n * ```\n */\nexport function createPreactIslandAdapter(deps: {\n renderToString: (element: unknown) => string;\n h: (type: unknown, props?: unknown) => unknown;\n}): IslandRenderAdapter {\n return {\n name: 'preact',\n async renderToString(component, props) {\n const element = deps.h(component, props);\n return deps.renderToString(element);\n },\n };\n}\n\n/**\n * Create a Vue island render adapter\n * \n * @example\n * ```typescript\n * import { renderToString, createSSRApp } from 'vue/server-renderer';\n * \n * const vueAdapter = createVueIslandAdapter({\n * renderToString,\n * createSSRApp,\n * });\n * ```\n */\nexport function createVueIslandAdapter(deps: {\n renderToString: (app: unknown) => Promise<string>;\n createSSRApp: (component: unknown, props?: unknown) => unknown;\n}): IslandRenderAdapter {\n return {\n name: 'vue',\n async renderToString(component, props) {\n const app = deps.createSSRApp(component, props);\n return deps.renderToString(app);\n },\n };\n}\n\n/**\n * Create a Solid island render adapter\n * \n * @example\n * ```typescript\n * import { renderToString } from 'solid-js/web';\n * \n * const solidAdapter = createSolidIslandAdapter({\n * renderToString,\n * });\n * ```\n */\nexport function createSolidIslandAdapter(deps: {\n renderToString: (fn: () => unknown) => string;\n}): IslandRenderAdapter {\n return {\n name: 'solid',\n async renderToString(component, props) {\n // Solid uses a function component pattern\n return deps.renderToString(() => (component as (p: unknown) => unknown)(props));\n },\n };\n}\n\n// ============================================================================\n// Custom Element Registration (optional)\n// ============================================================================\n\n/**\n * Register the flight-island custom element\n * This provides additional functionality like slot support\n */\nexport function registerFlightIslandElement(): void {\n if (typeof customElements === 'undefined') return;\n if (customElements.get('flight-island')) return;\n\n class FlightIsland extends HTMLElement {\n static get observedAttributes() {\n return ['data-hydrated', 'data-hydrate-error'];\n }\n\n connectedCallback() {\n // Could add loading indicator logic here\n }\n\n attributeChangedCallback(name: string, _oldValue: string, newValue: string) {\n if (name === 'data-hydrated' && newValue === 'true') {\n this.classList.add('hydrated');\n }\n if (name === 'data-hydrate-error' && newValue === 'true') {\n this.classList.add('hydrate-error');\n }\n }\n }\n\n customElements.define('flight-island', FlightIsland);\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/streaming/conditional.ts"],"names":["result"],"mappings":"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","file":"chunk-VNO2YUVD.js","sourcesContent":["/**\n * @flight-framework/core - Conditional Streaming\n * \n * Smart streaming decisions based on request context.\n * Bots get full HTML, users get streaming - YOU control the logic.\n * \n * Best Practices 2026:\n * - SEO-friendly: Crawlers receive complete HTML\n * - Performance: Users get progressive streaming\n * - Flexibility: Custom conditions for any use case\n * \n * @example\n * ```typescript\n * import { streamIf } from '@flight-framework/core/streaming';\n * \n * const response = await streamIf({\n * request,\n * condition: (req) => !isBot(req), // YOUR logic\n * stream: () => createStreamingSSR({ ... }),\n * static: () => renderToString(<App />),\n * });\n * ```\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Condition function to determine if streaming should be used\n */\nexport type StreamingCondition = (request: Request) => boolean | Promise<boolean>;\n\n/**\n * Built-in condition types\n */\nexport type BuiltInCondition =\n | 'always-stream' // Always use streaming\n | 'never-stream' // Always use static\n | 'no-bots' // Stream for users, static for bots\n | 'fast-network' // Stream only on fast connections\n | 'modern-browser'; // Stream only on modern browsers\n\n/**\n * Configuration for conditional streaming\n */\nexport interface StreamIfConfig<T = Response> {\n /** The incoming request */\n request: Request;\n /** Condition to check (function or built-in) */\n condition: StreamingCondition | BuiltInCondition;\n /** Factory for streaming response */\n stream: () => Promise<T> | T;\n /** Factory for static response */\n static: () => Promise<T> | T;\n /** Optional: Custom bot patterns */\n botPatterns?: RegExp[];\n /** Optional: Force streaming via query param (for testing) */\n forceStreamParam?: string;\n /** Optional: Force static via query param (for testing) */\n forceStaticParam?: string;\n}\n\n/**\n * Result of condition evaluation\n */\nexport interface StreamingDecision {\n /** Whether streaming was used */\n streaming: boolean;\n /** Reason for the decision */\n reason: string;\n /** The response */\n response: Response;\n}\n\n// ============================================================================\n// Bot Detection\n// ============================================================================\n\n/**\n * Default bot patterns for detection\n */\nexport const DEFAULT_BOT_PATTERNS: RegExp[] = [\n /googlebot/i,\n /bingbot/i,\n /slurp/i, // Yahoo\n /duckduckbot/i,\n /baiduspider/i,\n /yandexbot/i,\n /sogou/i,\n /facebot/i, // Facebook\n /twitterbot/i,\n /linkedinbot/i,\n /whatsapp/i,\n /telegrambot/i,\n /discordbot/i,\n /slackbot/i,\n /applebot/i,\n /crawler/i,\n /spider/i,\n /bot\\//i,\n /bot;/i,\n /headless/i, // Headless browsers\n /lighthouse/i, // Google Lighthouse\n /pagespeed/i,\n /gtmetrix/i,\n /pingdom/i,\n /uptimerobot/i,\n];\n\n/**\n * Check if a request is from a bot/crawler\n */\nexport function isBot(request: Request, customPatterns?: RegExp[]): boolean {\n const userAgent = request.headers.get('user-agent') || '';\n const patterns = customPatterns || DEFAULT_BOT_PATTERNS;\n return patterns.some(pattern => pattern.test(userAgent));\n}\n\n/**\n * Check if request explicitly asks for no streaming\n */\nexport function prefersNoStream(request: Request): boolean {\n // Check for custom header\n if (request.headers.get('x-no-stream') === 'true') return true;\n if (request.headers.get('x-prefer-static') === 'true') return true;\n\n // Check Accept header for preference\n const accept = request.headers.get('accept') || '';\n if (accept.includes('text/html; streaming=false')) return true;\n\n return false;\n}\n\n/**\n * Check if a connection is likely slow (based on headers)\n */\nexport function isSlowConnection(request: Request): boolean {\n // ECT (Effective Connection Type) header\n const ect = request.headers.get('ect');\n if (ect && ['slow-2g', '2g'].includes(ect)) return true;\n\n // Save-Data header\n if (request.headers.get('save-data') === 'on') return true;\n\n // Downlink header (Mbps)\n const downlink = request.headers.get('downlink');\n if (downlink && parseFloat(downlink) < 1) return true;\n\n return false;\n}\n\n/**\n * Check if browser supports streaming well\n */\nexport function supportsStreaming(request: Request): boolean {\n const userAgent = request.headers.get('user-agent') || '';\n\n // IE doesn't support streaming well\n if (/MSIE|Trident/i.test(userAgent)) return false;\n\n // Very old browsers\n if (/Opera Mini/i.test(userAgent)) return false;\n\n // Check for modern browser features via client hints\n const secChUa = request.headers.get('sec-ch-ua');\n if (secChUa) {\n // Has client hints = modern browser\n return true;\n }\n\n return true; // Default to supporting streaming\n}\n\n// ============================================================================\n// Built-in Conditions\n// ============================================================================\n\nfunction getBuiltInCondition(\n condition: BuiltInCondition,\n botPatterns?: RegExp[]\n): StreamingCondition {\n switch (condition) {\n case 'always-stream':\n return () => true;\n case 'never-stream':\n return () => false;\n case 'no-bots':\n return (req) => !isBot(req, botPatterns) && !prefersNoStream(req);\n case 'fast-network':\n return (req) => !isSlowConnection(req) && !isBot(req, botPatterns);\n case 'modern-browser':\n return (req) => supportsStreaming(req) && !isBot(req, botPatterns);\n }\n}\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\n/**\n * Conditionally use streaming or static rendering based on request context\n */\nexport async function streamIf<T = Response>(\n config: StreamIfConfig<T>\n): Promise<{ result: T; streaming: boolean; reason: string }> {\n const {\n request,\n condition,\n stream,\n static: staticFn,\n botPatterns,\n forceStreamParam = '__stream',\n forceStaticParam = '__static',\n } = config;\n\n // Check for forced mode via query params (useful for testing)\n const url = new URL(request.url);\n if (url.searchParams.has(forceStreamParam)) {\n const result = await stream();\n return { result, streaming: true, reason: 'forced via query param' };\n }\n if (url.searchParams.has(forceStaticParam)) {\n const result = await staticFn();\n return { result, streaming: false, reason: 'forced via query param' };\n }\n\n // Resolve condition\n const conditionFn = typeof condition === 'function'\n ? condition\n : getBuiltInCondition(condition, botPatterns);\n\n // Evaluate condition\n let shouldStream: boolean;\n let reason: string;\n\n try {\n shouldStream = await conditionFn(request);\n reason = shouldStream ? 'condition passed' : 'condition failed';\n } catch (error) {\n // On error, default to static (safer for SEO)\n shouldStream = false;\n reason = `condition error: ${error instanceof Error ? error.message : 'unknown'}`;\n }\n\n // Add specific reason for built-in conditions\n if (typeof condition === 'string') {\n if (!shouldStream && condition === 'no-bots') {\n reason = isBot(request, botPatterns)\n ? 'bot detected'\n : 'user prefers no streaming';\n } else if (!shouldStream && condition === 'fast-network') {\n reason = isSlowConnection(request)\n ? 'slow connection detected'\n : 'bot detected';\n }\n }\n\n // Execute appropriate renderer\n const result = shouldStream ? await stream() : await staticFn();\n return { result, streaming: shouldStream, reason };\n}\n\n/**\n * Create a middleware-style conditional streamer\n */\nexport function createConditionalStreamer<T = Response>(\n defaultCondition: StreamingCondition | BuiltInCondition,\n options?: {\n botPatterns?: RegExp[];\n forceStreamParam?: string;\n forceStaticParam?: string;\n }\n) {\n return async (config: {\n request: Request;\n stream: () => Promise<T> | T;\n static: () => Promise<T> | T;\n condition?: StreamingCondition | BuiltInCondition;\n }) => {\n return streamIf({\n request: config.request,\n condition: config.condition || defaultCondition,\n stream: config.stream,\n static: config.static,\n ...options,\n });\n };\n}\n\n// ============================================================================\n// Response Helpers\n// ============================================================================\n\n/**\n * Add streaming decision headers to response (for debugging)\n */\nexport function addStreamingHeaders(\n response: Response,\n decision: { streaming: boolean; reason: string }\n): Response {\n const headers = new Headers(response.headers);\n headers.set('X-Flight-Streaming', decision.streaming ? 'true' : 'false');\n headers.set('X-Flight-Streaming-Reason', decision.reason);\n\n return new Response(response.body, {\n status: response.status,\n statusText: response.statusText,\n headers,\n });\n}\n\n/**\n * Create a streaming-aware Response with appropriate headers\n */\nexport function createStreamingResponse(\n stream: ReadableStream<Uint8Array>,\n options?: {\n status?: number;\n headers?: Record<string, string>;\n isStreaming?: boolean;\n }\n): Response {\n const { status = 200, headers = {}, isStreaming = true } = options || {};\n\n return new Response(stream, {\n status,\n headers: {\n 'Content-Type': 'text/html; charset=utf-8',\n 'Transfer-Encoding': isStreaming ? 'chunked' : undefined,\n 'X-Content-Type-Options': 'nosniff',\n 'X-Flight-Streaming': isStreaming ? 'true' : 'false',\n ...headers,\n } as HeadersInit,\n });\n}\n\n/**\n * Create a static HTML Response\n */\nexport function createStaticResponse(\n html: string,\n options?: {\n status?: number;\n headers?: Record<string, string>;\n }\n): Response {\n const { status = 200, headers = {} } = options || {};\n\n return new Response(html, {\n status,\n headers: {\n 'Content-Type': 'text/html; charset=utf-8',\n 'X-Flight-Streaming': 'false',\n ...headers,\n },\n });\n}\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/rsc/vite-plugin.ts"],"names":["exports"],"mappings":"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","file":"chunk-XU6MRYG2.js","sourcesContent":["/**\n * @flight-framework/vite-plugin-rsc\n * \n * Vite plugin for Flight Server Components.\n * Transforms 'use client' and 'use server' directives at build time.\n * \n * Philosophy:\n * - Zero config for common cases\n * - Full control when needed\n * - Works with any Vite project\n * - No Next.js dependencies\n * \n * @module @flight-framework/vite-plugin-rsc\n */\n\nimport type { Plugin, ResolvedConfig } from 'vite';\nimport {\n analyzeModule,\n hasUseClientDirective,\n hasUseServerDirective,\n detectInlineServerActions,\n} from './boundaries.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Plugin configuration\n */\nexport interface FlightRSCPluginOptions {\n /** Include patterns (glob) */\n include?: string[];\n\n /** Exclude patterns (glob) */\n exclude?: string[];\n\n /** Server actions endpoint */\n actionsEndpoint?: string;\n\n /** Client manifest output path */\n clientManifest?: string;\n\n /** Server manifest output path */\n serverManifest?: string;\n\n /** Enable dev mode features */\n dev?: boolean;\n\n /** Custom transforms */\n transforms?: {\n /** Transform client components */\n client?: (code: string, id: string) => string | null;\n /** Transform server actions */\n server?: (code: string, id: string) => string | null;\n };\n}\n\n/**\n * Client manifest entry\n */\nexport interface ClientManifestEntry {\n id: string;\n file: string;\n exports: string[];\n chunks?: string[];\n}\n\n/**\n * Server manifest entry\n */\nexport interface ServerManifestEntry {\n id: string;\n file: string;\n actions: string[];\n}\n\n// ============================================================================\n// Plugin Implementation\n// ============================================================================\n\n/**\n * Flight RSC Vite Plugin\n * \n * @example\n * ```typescript\n * // vite.config.ts\n * import { flightRSC } from '@flight-framework/core/rsc/vite-plugin';\n * \n * export default defineConfig({\n * plugins: [\n * flightRSC({\n * actionsEndpoint: '/_flight/action',\n * }),\n * ],\n * });\n * ```\n */\nexport function flightRSC(options: FlightRSCPluginOptions = {}): Plugin[] {\n const {\n include = ['**/*.tsx', '**/*.ts', '**/*.jsx', '**/*.js'],\n exclude = ['**/node_modules/**', '**/.git/**'],\n actionsEndpoint = '/_flight/action',\n clientManifest = '.flight/client-manifest.json',\n serverManifest = '.flight/server-manifest.json',\n // dev flag reserved for future use\n } = options;\n\n // State\n const clientModules = new Map<string, ClientManifestEntry>();\n const serverActions = new Map<string, ServerManifestEntry>();\n let config: ResolvedConfig;\n let isSSR = false;\n\n return [\n // ================================================================\n // 1. Analyze modules and track boundaries\n // ================================================================\n {\n name: 'flight-rsc:analyze',\n enforce: 'pre',\n\n configResolved(resolvedConfig) {\n config = resolvedConfig;\n },\n\n transform(code, id) {\n // Skip excluded files\n if (!shouldProcess(id, include, exclude)) {\n return null;\n }\n\n // Analyze module\n const analysis = analyzeModule(code, id);\n\n // Track client modules\n if (analysis.fileDirective === 'client') {\n clientModules.set(id, {\n id: createModuleId(id, config),\n file: id,\n exports: analysis.clientComponents,\n });\n }\n\n // Track server actions\n if (analysis.fileDirective === 'server' || analysis.serverActions.length > 0) {\n serverActions.set(id, {\n id: createModuleId(id, config),\n file: id,\n actions: analysis.serverActions,\n });\n }\n\n return null;\n },\n },\n\n // ================================================================\n // 2. Transform client components to references (server bundle)\n // ================================================================\n {\n name: 'flight-rsc:client-transform',\n\n transform(code, id, opts) {\n isSSR = opts?.ssr ?? false;\n\n if (!isSSR) return null;\n if (!hasUseClientDirective(code)) return null;\n if (!shouldProcess(id, include, exclude)) return null;\n\n // Custom transform\n if (options.transforms?.client) {\n const result = options.transforms.client(code, id);\n if (result) return result;\n }\n\n // Replace client component with reference proxy\n const moduleId = createModuleId(id, config);\n const exports = extractExportNames(code);\n\n let transformed = `\n// Flight RSC: Client Component Reference\n// Original: ${id}\n\nconst __flight_client_module_id = ${JSON.stringify(moduleId)};\n\n`;\n\n // Create proxy for each export\n for (const exportName of exports) {\n if (exportName === 'default') {\n transformed += `\nconst __flight_default_proxy = Object.assign(\n function() {\n throw new Error('Client Component cannot be called on the server. Module: ' + __flight_client_module_id);\n },\n {\n $$typeof: Symbol.for('flight.client.reference'),\n $$id: __flight_client_module_id + '#default',\n $$async: false,\n __flight_client: true,\n __flight_module: __flight_client_module_id,\n __flight_export: 'default',\n }\n);\n\nexport default __flight_default_proxy;\n`;\n } else {\n transformed += `\nexport const ${exportName} = Object.assign(\n function() {\n throw new Error('Client Component cannot be called on the server. Module: ' + __flight_client_module_id);\n },\n {\n $$typeof: Symbol.for('flight.client.reference'),\n $$id: __flight_client_module_id + '#${exportName}',\n $$async: false,\n __flight_client: true,\n __flight_module: __flight_client_module_id,\n __flight_export: '${exportName}',\n }\n);\n`;\n }\n }\n\n return {\n code: transformed,\n map: null,\n };\n },\n },\n\n // ================================================================\n // 3. Transform server actions to RPC calls (client bundle)\n // ================================================================\n {\n name: 'flight-rsc:server-transform',\n\n transform(code, id, opts) {\n isSSR = opts?.ssr ?? false;\n\n if (isSSR) return null; // Only transform for client\n if (!shouldProcess(id, include, exclude)) return null;\n\n // Check for file-level 'use server'\n if (hasUseServerDirective(code)) {\n // Custom transform\n if (options.transforms?.server) {\n const result = options.transforms.server(code, id);\n if (result) return result;\n }\n\n // Replace all exports with RPC calls\n const moduleId = createModuleId(id, config);\n const exports = extractExportNames(code);\n\n let transformed = `\n// Flight RSC: Server Actions (RPC Proxies)\n// Original: ${id}\n\nconst __flight_actions_endpoint = ${JSON.stringify(actionsEndpoint)};\nconst __flight_module_id = ${JSON.stringify(moduleId)};\n\nasync function __flight_call_action(actionId, args) {\n const response = await fetch(__flight_actions_endpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'X-Flight-Action': actionId,\n },\n body: JSON.stringify({ actionId, args }),\n });\n \n if (!response.ok) {\n const error = await response.json().catch(() => ({ message: 'Server action failed' }));\n throw new Error(error.message || 'Server action failed');\n }\n \n return response.json();\n}\n\n`;\n\n for (const exportName of exports) {\n const actionId = `${moduleId}#${exportName}`;\n if (exportName === 'default') {\n transformed += `\nexport default async function(...args) {\n return __flight_call_action(${JSON.stringify(actionId)}, args);\n}\n`;\n } else {\n transformed += `\nexport async function ${exportName}(...args) {\n return __flight_call_action(${JSON.stringify(actionId)}, args);\n}\n`;\n }\n }\n\n return {\n code: transformed,\n map: null,\n };\n }\n\n // Check for inline 'use server' in functions\n const inlineActions = detectInlineServerActions(code);\n if (inlineActions.length > 0) {\n // Transform specific functions to RPC calls\n let transformed = code;\n const moduleId = createModuleId(id, config);\n\n for (const actionName of inlineActions) {\n const actionId = `${moduleId}#${actionName}`;\n\n // Replace function with RPC call\n // This is a simplified transform - a real implementation would use AST\n const asyncFnPattern = new RegExp(\n `(async\\\\s+function\\\\s+${actionName}\\\\s*\\\\([^)]*\\\\)\\\\s*\\\\{[^}]*['\"]use server['\"][^}]*\\\\})`,\n 'g'\n );\n\n transformed = transformed.replace(asyncFnPattern, `\nasync function ${actionName}(...args) {\n const response = await fetch(${JSON.stringify(actionsEndpoint)}, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'X-Flight-Action': ${JSON.stringify(actionId)},\n },\n body: JSON.stringify({ actionId: ${JSON.stringify(actionId)}, args }),\n });\n if (!response.ok) throw new Error('Server action failed');\n return response.json();\n}`\n );\n }\n\n if (transformed !== code) {\n return {\n code: transformed,\n map: null,\n };\n }\n }\n\n return null;\n },\n },\n\n // ================================================================\n // 4. Generate manifests\n // ================================================================\n {\n name: 'flight-rsc:manifest',\n\n generateBundle() {\n // Client manifest\n if (clientModules.size > 0) {\n const manifest = Object.fromEntries(clientModules);\n this.emitFile({\n type: 'asset',\n fileName: clientManifest,\n source: JSON.stringify(manifest, null, 2),\n });\n }\n\n // Server manifest\n if (serverActions.size > 0) {\n const manifest = Object.fromEntries(serverActions);\n this.emitFile({\n type: 'asset',\n fileName: serverManifest,\n source: JSON.stringify(manifest, null, 2),\n });\n }\n },\n },\n\n // ================================================================\n // 5. Dev server middleware for server actions\n // ================================================================\n {\n name: 'flight-rsc:dev-server',\n apply: 'serve',\n\n configureServer(server) {\n server.middlewares.use(async (req, res, next) => {\n if (req.url?.startsWith(actionsEndpoint) && req.method === 'POST') {\n try {\n // Parse request body\n const chunks: Buffer[] = [];\n for await (const chunk of req) {\n chunks.push(chunk as Buffer);\n }\n const body = JSON.parse(Buffer.concat(chunks).toString());\n\n const { actionId, args } = body;\n\n // Find and execute action\n const [moduleId, actionName] = actionId.split('#');\n const entry = [...serverActions.values()].find(e => e.id === moduleId);\n\n if (!entry) {\n res.statusCode = 404;\n res.end(JSON.stringify({ error: 'Action not found' }));\n return;\n }\n\n // Load module and execute action\n const mod = await server.ssrLoadModule(entry.file);\n const action = mod[actionName] || mod.default;\n\n if (typeof action !== 'function') {\n res.statusCode = 404;\n res.end(JSON.stringify({ error: 'Action not found' }));\n return;\n }\n\n const result = await action(...args);\n\n res.setHeader('Content-Type', 'application/json');\n res.end(JSON.stringify(result));\n\n } catch (error) {\n console.error('[Flight RSC] Action error:', error);\n res.statusCode = 500;\n res.end(JSON.stringify({\n error: (error as Error).message\n }));\n }\n return;\n }\n\n next();\n });\n },\n },\n ];\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Check if file should be processed\n */\nfunction shouldProcess(id: string, include: string[], exclude: string[]): boolean {\n // Simple glob matching (for production, use picomatch)\n const isIncluded = include.some(pattern => {\n const regex = globToRegex(pattern);\n return regex.test(id);\n });\n\n const isExcluded = exclude.some(pattern => {\n const regex = globToRegex(pattern);\n return regex.test(id);\n });\n\n return isIncluded && !isExcluded;\n}\n\n/**\n * Convert glob pattern to regex (simplified)\n */\nfunction globToRegex(pattern: string): RegExp {\n const escaped = pattern\n .replace(/[.+^${}()|[\\]\\\\]/g, '\\\\$&')\n .replace(/\\*\\*/g, '{{GLOBSTAR}}')\n .replace(/\\*/g, '[^/]*')\n .replace(/{{GLOBSTAR}}/g, '.*');\n\n return new RegExp(escaped);\n}\n\n/**\n * Create a stable module ID from file path\n */\nfunction createModuleId(id: string, config: ResolvedConfig): string {\n // Remove root prefix\n let moduleId = id;\n if (config?.root && id.startsWith(config.root)) {\n moduleId = id.slice(config.root.length);\n }\n\n // Normalize path\n moduleId = moduleId.replace(/\\\\/g, '/');\n if (!moduleId.startsWith('/')) {\n moduleId = '/' + moduleId;\n }\n\n return moduleId;\n}\n\n/**\n * Extract export names from source code\n */\nfunction extractExportNames(code: string): string[] {\n const exports: string[] = [];\n\n // export default\n if (/export\\s+default\\s+/.test(code)) {\n exports.push('default');\n }\n\n // export function/const/let/class Name\n const namedPattern = /export\\s+(?:async\\s+)?(?:function|const|let|var|class)\\s+(\\w+)/g;\n let match;\n while ((match = namedPattern.exec(code)) !== null) {\n if (match[1] && match[1] !== 'default') {\n exports.push(match[1]);\n }\n }\n\n // export { a, b, c }\n const bracketPattern = /export\\s*\\{\\s*([^}]+)\\s*\\}/g;\n while ((match = bracketPattern.exec(code)) !== null) {\n if (match[1]) {\n const names = match[1].split(',').map(n => {\n const parts = n.trim().split(/\\s+as\\s+/);\n return parts[parts.length - 1]!.trim();\n });\n exports.push(...names.filter(n => n && n !== 'default'));\n }\n }\n\n return [...new Set(exports)];\n}\n\nexport default flightRSC;\n"]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/streaming/observability.ts"],"names":[],"mappings":"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","file":"chunk-YNTMYL36.js","sourcesContent":["/**\n * @flight-framework/core - Streaming Observability\n * \n * Zero-telemetry metrics and instrumentation for streaming SSR.\n * All data stays on YOUR infrastructure - never sent anywhere.\n * \n * Best Practices 2026:\n * - Comprehensive timing metrics for each boundary\n * - Hook-based observability for custom integrations\n * - Performance insights without vendor lock-in\n * \n * @example\n * ```typescript\n * import { createInstrumentedStream } from '@flight-framework/core/streaming';\n * \n * const { stream, metrics } = await createInstrumentedStream({\n * shell: '<html>...',\n * boundaries: [...],\n * onMetrics: (m) => myAnalytics.track(m), // YOUR system\n * });\n * ```\n */\n\nimport type { StreamingRenderOptions, SuspenseBoundaryConfig } from './index.js';\nimport { createStreamingSSR } from './index.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Timing information for a single boundary\n */\nexport interface BoundaryTiming {\n /** Boundary identifier */\n id: string;\n /** When the boundary started resolving (ms since stream start) */\n startTime: number;\n /** When the boundary finished resolving */\n endTime: number;\n /** Total duration in milliseconds */\n duration: number;\n /** Whether it resolved successfully */\n success: boolean;\n /** Size of content in bytes (if successful) */\n contentSize?: number;\n /** Error message if failed */\n error?: string;\n}\n\n/**\n * Overall streaming metrics\n */\nexport interface StreamingMetrics {\n /** Unique ID for this stream session */\n streamId: string;\n /** When streaming started */\n startTime: number;\n /** Time to shell ready (TTFB improvement) */\n shellTime: number;\n /** Time until all boundaries resolved */\n totalStreamTime: number;\n /** Individual boundary timings */\n boundaries: BoundaryTiming[];\n /** Number of boundaries that resolved successfully */\n successCount: number;\n /** Number of boundaries that failed */\n errorCount: number;\n /** Total bytes streamed */\n totalBytes: number;\n /** Strategy used (if priority streaming) */\n strategy?: string;\n /** Custom metadata you can add */\n meta?: Record<string, unknown>;\n}\n\n/**\n * Observability hooks for streaming events\n */\nexport interface StreamingObserver {\n /** Called when streaming starts */\n onStreamStart?: (streamId: string) => void;\n /** Called when shell is sent */\n onShellReady?: (timing: { streamId: string; duration: number }) => void;\n /** Called when a boundary starts resolving */\n onBoundaryStart?: (info: { streamId: string; boundaryId: string; startTime: number }) => void;\n /** Called when a boundary finishes */\n onBoundaryEnd?: (timing: BoundaryTiming & { streamId: string }) => void;\n /** Called when streaming completes */\n onStreamEnd?: (metrics: StreamingMetrics) => void;\n /** Called on any error */\n onError?: (error: { streamId: string; boundaryId?: string; error: Error }) => void;\n}\n\n/**\n * Configuration for instrumented streaming\n */\nexport interface InstrumentedStreamConfig {\n /** Initial HTML shell */\n shell: string;\n /** Closing HTML */\n shellEnd: string;\n /** Suspense boundaries */\n suspenseBoundaries: SuspenseBoundaryConfig[];\n /** Streaming options */\n options?: StreamingRenderOptions;\n /** Observer hooks */\n observer?: StreamingObserver;\n /** Callback when all metrics are ready */\n onMetrics?: (metrics: StreamingMetrics) => void;\n /** Custom metadata to include in metrics */\n meta?: Record<string, unknown>;\n}\n\n/**\n * Result of instrumented streaming\n */\nexport interface InstrumentedStreamResult {\n /** The readable stream */\n stream: ReadableStream<Uint8Array>;\n /** Abort the stream */\n abort: () => void;\n /** Shell ready promise */\n shellReady: Promise<void>;\n /** All content ready promise */\n allReady: Promise<void>;\n /** Final metrics (resolves when stream completes) */\n metrics: Promise<StreamingMetrics>;\n /** Stream ID for correlation */\n streamId: string;\n}\n\n// ============================================================================\n// Implementation\n// ============================================================================\n\n/**\n * Generate a unique stream ID\n */\nfunction generateStreamId(): string {\n return `stream_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;\n}\n\n/**\n * Create an instrumented streaming SSR response with full observability\n */\nexport async function createInstrumentedStream(\n config: InstrumentedStreamConfig\n): Promise<InstrumentedStreamResult> {\n const {\n shell,\n shellEnd,\n suspenseBoundaries,\n options = {},\n observer,\n onMetrics,\n meta,\n } = config;\n\n const streamId = generateStreamId();\n const startTime = Date.now();\n const boundaryTimings: BoundaryTiming[] = [];\n const boundaryStarts = new Map<string, number>();\n let shellTime = 0;\n let totalBytes = 0;\n\n // Metrics promise\n let resolveMetrics: (m: StreamingMetrics) => void;\n const metricsPromise = new Promise<StreamingMetrics>((r) => { resolveMetrics = r; });\n\n // Notify stream start\n observer?.onStreamStart?.(streamId);\n\n // Wrap boundaries with instrumentation\n const instrumentedBoundaries: SuspenseBoundaryConfig[] = suspenseBoundaries.map(boundary => {\n const boundaryStart = Date.now();\n boundaryStarts.set(boundary.id, boundaryStart);\n\n observer?.onBoundaryStart?.({\n streamId,\n boundaryId: boundary.id,\n startTime: boundaryStart - startTime,\n });\n\n return {\n ...boundary,\n contentPromise: boundary.contentPromise.then(\n (content) => {\n const endTime = Date.now();\n const timing: BoundaryTiming = {\n id: boundary.id,\n startTime: boundaryStarts.get(boundary.id)! - startTime,\n endTime: endTime - startTime,\n duration: endTime - boundaryStarts.get(boundary.id)!,\n success: true,\n contentSize: new TextEncoder().encode(content).length,\n };\n boundaryTimings.push(timing);\n observer?.onBoundaryEnd?.({ ...timing, streamId });\n return content;\n },\n (error) => {\n const endTime = Date.now();\n const timing: BoundaryTiming = {\n id: boundary.id,\n startTime: boundaryStarts.get(boundary.id)! - startTime,\n endTime: endTime - startTime,\n duration: endTime - boundaryStarts.get(boundary.id)!,\n success: false,\n error: error instanceof Error ? error.message : String(error),\n };\n boundaryTimings.push(timing);\n observer?.onBoundaryEnd?.({ ...timing, streamId });\n observer?.onError?.({ streamId, boundaryId: boundary.id, error: error as Error });\n throw error;\n }\n ),\n };\n });\n\n // Create the underlying stream with instrumented callbacks\n const result = await createStreamingSSR({\n shell,\n shellEnd,\n suspenseBoundaries: instrumentedBoundaries,\n options: {\n ...options,\n onShellReady: () => {\n shellTime = Date.now() - startTime;\n observer?.onShellReady?.({ streamId, duration: shellTime });\n options.onShellReady?.();\n },\n onAllReady: () => {\n const totalStreamTime = Date.now() - startTime;\n\n const metrics: StreamingMetrics = {\n streamId,\n startTime,\n shellTime,\n totalStreamTime,\n boundaries: boundaryTimings,\n successCount: boundaryTimings.filter(b => b.success).length,\n errorCount: boundaryTimings.filter(b => !b.success).length,\n totalBytes,\n meta,\n };\n\n observer?.onStreamEnd?.(metrics);\n onMetrics?.(metrics);\n resolveMetrics!(metrics);\n options.onAllReady?.();\n },\n onError: (error) => {\n observer?.onError?.({ streamId, error });\n options.onError?.(error);\n },\n },\n });\n\n // Wrap stream to count bytes\n const countingStream = result.stream.pipeThrough(\n new TransformStream<Uint8Array, Uint8Array>({\n transform(chunk, controller) {\n totalBytes += chunk.length;\n controller.enqueue(chunk);\n },\n })\n );\n\n return {\n stream: countingStream,\n abort: result.abort,\n shellReady: result.shellReady,\n allReady: result.allReady,\n metrics: metricsPromise,\n streamId,\n };\n}\n\n// ============================================================================\n// Utility: Metrics Aggregator\n// ============================================================================\n\n/**\n * Aggregate metrics from multiple streams for analysis\n */\nexport class MetricsAggregator {\n private metrics: StreamingMetrics[] = [];\n private maxSamples: number;\n\n constructor(maxSamples = 1000) {\n this.maxSamples = maxSamples;\n }\n\n /**\n * Add metrics from a stream\n */\n add(metrics: StreamingMetrics): void {\n this.metrics.push(metrics);\n if (this.metrics.length > this.maxSamples) {\n this.metrics.shift();\n }\n }\n\n /**\n * Get average shell time\n */\n getAverageShellTime(): number {\n if (this.metrics.length === 0) return 0;\n return this.metrics.reduce((sum, m) => sum + m.shellTime, 0) / this.metrics.length;\n }\n\n /**\n * Get average total stream time\n */\n getAverageTotalTime(): number {\n if (this.metrics.length === 0) return 0;\n return this.metrics.reduce((sum, m) => sum + m.totalStreamTime, 0) / this.metrics.length;\n }\n\n /**\n * Get slowest boundaries (by average duration)\n */\n getSlowestBoundaries(limit = 5): { id: string; avgDuration: number; errorRate: number }[] {\n const boundaryStats = new Map<string, { totalDuration: number; count: number; errors: number }>();\n\n for (const m of this.metrics) {\n for (const b of m.boundaries) {\n const stats = boundaryStats.get(b.id) || { totalDuration: 0, count: 0, errors: 0 };\n stats.totalDuration += b.duration;\n stats.count++;\n if (!b.success) stats.errors++;\n boundaryStats.set(b.id, stats);\n }\n }\n\n return [...boundaryStats.entries()]\n .map(([id, stats]) => ({\n id,\n avgDuration: stats.totalDuration / stats.count,\n errorRate: stats.errors / stats.count,\n }))\n .sort((a, b) => b.avgDuration - a.avgDuration)\n .slice(0, limit);\n }\n\n /**\n * Get overall error rate\n */\n getErrorRate(): number {\n const total = this.metrics.reduce((sum, m) => sum + m.boundaries.length, 0);\n const errors = this.metrics.reduce((sum, m) => sum + m.errorCount, 0);\n return total > 0 ? errors / total : 0;\n }\n\n /**\n * Get percentiles for shell time\n */\n getShellTimePercentiles(): { p50: number; p90: number; p99: number } {\n const sorted = [...this.metrics].map(m => m.shellTime).sort((a, b) => a - b);\n const len = sorted.length;\n if (len === 0) return { p50: 0, p90: 0, p99: 0 };\n\n return {\n p50: sorted[Math.floor(len * 0.5)] ?? 0,\n p90: sorted[Math.floor(len * 0.9)] ?? 0,\n p99: sorted[Math.floor(len * 0.99)] ?? 0,\n };\n }\n\n /**\n * Export all metrics for external analysis\n */\n export(): StreamingMetrics[] {\n return [...this.metrics];\n }\n\n /**\n * Clear all metrics\n */\n clear(): void {\n this.metrics = [];\n }\n}\n\n// ============================================================================\n// Utility: Create Observer from Logger\n// ============================================================================\n\n/**\n * Create a streaming observer from a simple logger function\n */\nexport function createLoggerObserver(\n log: (message: string, data?: Record<string, unknown>) => void\n): StreamingObserver {\n return {\n onStreamStart: (streamId) => {\n log('[Flight] Stream started', { streamId });\n },\n onShellReady: ({ streamId, duration }) => {\n log('[Flight] Shell ready', { streamId, duration: `${duration}ms` });\n },\n onBoundaryStart: ({ streamId, boundaryId, startTime }) => {\n log('[Flight] Boundary started', { streamId, boundaryId, startTime: `${startTime}ms` });\n },\n onBoundaryEnd: (timing) => {\n log('[Flight] Boundary completed', {\n streamId: (timing as any).streamId,\n boundaryId: timing.id,\n duration: `${timing.duration}ms`,\n success: timing.success,\n size: timing.contentSize ? `${timing.contentSize}b` : undefined,\n });\n },\n onStreamEnd: (metrics) => {\n log('[Flight] Stream completed', {\n streamId: metrics.streamId,\n totalTime: `${metrics.totalStreamTime}ms`,\n shellTime: `${metrics.shellTime}ms`,\n boundaries: metrics.boundaries.length,\n errors: metrics.errorCount,\n });\n },\n onError: ({ streamId, boundaryId, error }) => {\n log('[Flight] Stream error', { streamId, boundaryId, error: error.message });\n },\n };\n}\n\n/**\n * Create observer that sends metrics to a custom endpoint (YOUR infrastructure)\n */\nexport function createHttpObserver(endpoint: string, options?: {\n headers?: Record<string, string>;\n batchSize?: number;\n flushInterval?: number;\n}): StreamingObserver {\n const { headers = {}, batchSize = 10, flushInterval = 5000 } = options || {};\n const buffer: StreamingMetrics[] = [];\n let flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n const flush = async () => {\n if (buffer.length === 0) return;\n const batch = buffer.splice(0, buffer.length);\n\n try {\n await fetch(endpoint, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n ...headers,\n },\n body: JSON.stringify({ metrics: batch, timestamp: Date.now() }),\n });\n } catch (error) {\n console.error('[Flight] Failed to send metrics:', error);\n // Re-add to buffer for retry\n buffer.unshift(...batch);\n }\n };\n\n const scheduleFlush = () => {\n if (flushTimer) return;\n flushTimer = setTimeout(() => {\n flushTimer = null;\n flush();\n }, flushInterval);\n };\n\n return {\n onStreamEnd: (metrics) => {\n buffer.push(metrics);\n if (buffer.length >= batchSize) {\n flush();\n } else {\n scheduleFlush();\n }\n },\n };\n}\n"]}
|