@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.
Files changed (141) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +541 -541
  3. package/dist/actions/index.js +1 -1
  4. package/dist/adapters/index.d.ts +260 -1
  5. package/dist/adapters/index.js +1 -1
  6. package/dist/cache/index.js +1 -1
  7. package/dist/{chunk-3UQJE3XZ.js → chunk-2F2QU6RC.js} +2 -2
  8. package/dist/chunk-2F2QU6RC.js.map +1 -0
  9. package/dist/{chunk-4U7CJVNQ.js → chunk-3KRBRSRJ.js} +2 -2
  10. package/dist/chunk-3KRBRSRJ.js.map +1 -0
  11. package/dist/{chunk-OZ3EXPLE.js → chunk-3QP3E7HS.js} +2 -2
  12. package/dist/chunk-3QP3E7HS.js.map +1 -0
  13. package/dist/{chunk-CKJHJPKQ.js → chunk-62C7LX2E.js} +2 -2
  14. package/dist/chunk-62C7LX2E.js.map +1 -0
  15. package/dist/{chunk-YNTMYL36.js → chunk-6BDCTUQY.js} +3 -3
  16. package/dist/chunk-6BDCTUQY.js.map +1 -0
  17. package/dist/chunk-77MJZCYD.js +354 -0
  18. package/dist/chunk-77MJZCYD.js.map +1 -0
  19. package/dist/{chunk-KDEA64UX.js → chunk-EGB7C73X.js} +5 -5
  20. package/dist/chunk-EGB7C73X.js.map +1 -0
  21. package/dist/{chunk-2JVEH76V.js → chunk-FSJNOPYE.js} +3 -3
  22. package/dist/chunk-FSJNOPYE.js.map +1 -0
  23. package/dist/{chunk-ARBKF6VI.js → chunk-GCQZ4FHI.js} +2 -2
  24. package/dist/{chunk-ARBKF6VI.js.map → chunk-GCQZ4FHI.js.map} +1 -1
  25. package/dist/{chunk-EHVUAFNH.js → chunk-IXMD5QH2.js} +2 -2
  26. package/dist/chunk-IXMD5QH2.js.map +1 -0
  27. package/dist/{chunk-6GI6HFSQ.js → chunk-K2CQZPCG.js} +2 -2
  28. package/dist/chunk-K2CQZPCG.js.map +1 -0
  29. package/dist/{chunk-6IG6XIXU.js → chunk-LNV47HGV.js} +2 -2
  30. package/dist/chunk-LNV47HGV.js.map +1 -0
  31. package/dist/{chunk-65JYF3DJ.js → chunk-MDQNNIHH.js} +2 -2
  32. package/dist/chunk-MDQNNIHH.js.map +1 -0
  33. package/dist/{chunk-GNS2FGPC.js → chunk-MQQLYWZZ.js} +2 -2
  34. package/dist/chunk-MQQLYWZZ.js.map +1 -0
  35. package/dist/{chunk-LAKHYTHL.js → chunk-NWMJYTMB.js} +3 -3
  36. package/dist/chunk-NWMJYTMB.js.map +1 -0
  37. package/dist/{chunk-R7MEVVA4.js → chunk-OYF2OAKS.js} +2 -2
  38. package/dist/chunk-OYF2OAKS.js.map +1 -0
  39. package/dist/{chunk-FRAH5QNY.js → chunk-P6WSBVDT.js} +4 -4
  40. package/dist/chunk-P6WSBVDT.js.map +1 -0
  41. package/dist/{chunk-5XHOLZBJ.js → chunk-PDW5WCMW.js} +2 -2
  42. package/dist/chunk-PDW5WCMW.js.map +1 -0
  43. package/dist/{chunk-A2QRUBVE.js → chunk-PVUMB632.js} +2 -2
  44. package/dist/chunk-PVUMB632.js.map +1 -0
  45. package/dist/{chunk-LKOPJ3GS.js → chunk-R7SQAREQ.js} +2 -2
  46. package/dist/chunk-R7SQAREQ.js.map +1 -0
  47. package/dist/{chunk-CNY3ZUVG.js → chunk-RSVA2EYO.js} +2 -2
  48. package/dist/chunk-RSVA2EYO.js.map +1 -0
  49. package/dist/{chunk-PAVI5W6M.js → chunk-T4Z4HM4W.js} +3 -3
  50. package/dist/chunk-T4Z4HM4W.js.map +1 -0
  51. package/dist/{chunk-HNPO6LFW.js → chunk-TASAT7KB.js} +2 -2
  52. package/dist/chunk-TASAT7KB.js.map +1 -0
  53. package/dist/{chunk-3N5ZBVZJ.js → chunk-VPFMHGEV.js} +2 -2
  54. package/dist/chunk-VPFMHGEV.js.map +1 -0
  55. package/dist/{chunk-A4TKWQBU.js → chunk-W6D62JCI.js} +2 -2
  56. package/dist/chunk-W6D62JCI.js.map +1 -0
  57. package/dist/{chunk-UFWGOJL7.js → chunk-WFAWAHJH.js} +2 -2
  58. package/dist/chunk-WFAWAHJH.js.map +1 -0
  59. package/dist/{chunk-NZS2YJ43.js → chunk-WOEIJWGJ.js} +2 -2
  60. package/dist/chunk-WOEIJWGJ.js.map +1 -0
  61. package/dist/{chunk-VNO2YUVD.js → chunk-XOIYNY4I.js} +2 -2
  62. package/dist/chunk-XOIYNY4I.js.map +1 -0
  63. package/dist/{chunk-PO7IHPFF.js → chunk-XSY5AAXT.js} +2 -2
  64. package/dist/chunk-XSY5AAXT.js.map +1 -0
  65. package/dist/{chunk-OZBPR27I.js → chunk-YHEVHRLH.js} +2 -2
  66. package/dist/chunk-YHEVHRLH.js.map +1 -0
  67. package/dist/{chunk-XU6MRYG2.js → chunk-ZIE56LCA.js} +3 -3
  68. package/dist/chunk-ZIE56LCA.js.map +1 -0
  69. package/dist/{chunk-B2LPSCES.js → chunk-ZVC3ZWLM.js} +2 -2
  70. package/dist/chunk-ZVC3ZWLM.js.map +1 -0
  71. package/dist/client.js +8 -8
  72. package/dist/client.js.map +1 -1
  73. package/dist/config/index.js +1 -1
  74. package/dist/errors/index.js +2 -2
  75. package/dist/file-router/index.js +1 -1
  76. package/dist/file-router/streaming-hints.js +1 -1
  77. package/dist/handlers/index.js +1 -1
  78. package/dist/index.js +30 -30
  79. package/dist/index.js.map +1 -1
  80. package/dist/islands/index.js +1 -1
  81. package/dist/middleware/index.js +1 -1
  82. package/dist/react/index.js +2 -2
  83. package/dist/react/index.js.map +1 -1
  84. package/dist/render/index.js +1 -1
  85. package/dist/router/index.js +1 -1
  86. package/dist/rsc/adapters/index.js +4 -4
  87. package/dist/rsc/adapters/preact.js +1 -1
  88. package/dist/rsc/adapters/react.js +1 -1
  89. package/dist/rsc/adapters/solid.js +1 -1
  90. package/dist/rsc/adapters/vue.js +1 -1
  91. package/dist/rsc/boundaries.js +1 -1
  92. package/dist/rsc/context.js +1 -1
  93. package/dist/rsc/index.js +11 -11
  94. package/dist/rsc/legacy.js +1 -1
  95. package/dist/rsc/payload.js +1 -1
  96. package/dist/rsc/plugins/esbuild.js +2 -2
  97. package/dist/rsc/plugins/index.js +4 -4
  98. package/dist/rsc/plugins/rollup.js +2 -2
  99. package/dist/rsc/renderer.js +3 -3
  100. package/dist/rsc/stream.js +1 -1
  101. package/dist/rsc/vite-plugin.js +2 -2
  102. package/dist/server/index.js +4 -4
  103. package/dist/streaming/adapters/index.js +1 -1
  104. package/dist/streaming/conditional.js +1 -1
  105. package/dist/streaming/index.js +1 -1
  106. package/dist/streaming/observability.js +2 -2
  107. package/dist/streaming/priority.js +1 -1
  108. package/dist/utils/index.js +1 -1
  109. package/package.json +1 -1
  110. package/dist/chunk-2JVEH76V.js.map +0 -1
  111. package/dist/chunk-3N5ZBVZJ.js.map +0 -1
  112. package/dist/chunk-3UQJE3XZ.js.map +0 -1
  113. package/dist/chunk-4U7CJVNQ.js.map +0 -1
  114. package/dist/chunk-5XHOLZBJ.js.map +0 -1
  115. package/dist/chunk-65JYF3DJ.js.map +0 -1
  116. package/dist/chunk-6GI6HFSQ.js.map +0 -1
  117. package/dist/chunk-6IG6XIXU.js.map +0 -1
  118. package/dist/chunk-A2QRUBVE.js.map +0 -1
  119. package/dist/chunk-A4TKWQBU.js.map +0 -1
  120. package/dist/chunk-B2LPSCES.js.map +0 -1
  121. package/dist/chunk-CKJHJPKQ.js.map +0 -1
  122. package/dist/chunk-CNY3ZUVG.js.map +0 -1
  123. package/dist/chunk-EHVUAFNH.js.map +0 -1
  124. package/dist/chunk-FRAH5QNY.js.map +0 -1
  125. package/dist/chunk-GNS2FGPC.js.map +0 -1
  126. package/dist/chunk-HNPO6LFW.js.map +0 -1
  127. package/dist/chunk-KDEA64UX.js.map +0 -1
  128. package/dist/chunk-LAKHYTHL.js.map +0 -1
  129. package/dist/chunk-LKOPJ3GS.js.map +0 -1
  130. package/dist/chunk-NZS2YJ43.js.map +0 -1
  131. package/dist/chunk-OZ3EXPLE.js.map +0 -1
  132. package/dist/chunk-OZBPR27I.js.map +0 -1
  133. package/dist/chunk-PAVI5W6M.js.map +0 -1
  134. package/dist/chunk-PO7IHPFF.js.map +0 -1
  135. package/dist/chunk-QK6UEQ75.js +0 -13
  136. package/dist/chunk-QK6UEQ75.js.map +0 -1
  137. package/dist/chunk-R7MEVVA4.js.map +0 -1
  138. package/dist/chunk-UFWGOJL7.js.map +0 -1
  139. package/dist/chunk-VNO2YUVD.js.map +0 -1
  140. package/dist/chunk-XU6MRYG2.js.map +0 -1
  141. package/dist/chunk-YNTMYL36.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/actions/middleware.ts","../src/actions/streaming.ts","../src/actions/queue.ts","../src/actions/index.ts"],"names":[],"mappings":"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","file":"chunk-3QP3E7HS.js","sourcesContent":["/**\r\n * @flight-framework/core - Action Middleware\r\n * \r\n * Agnostic middleware system for Server Actions.\r\n * Flight provides the PRIMITIVES, you build YOUR solution.\r\n * \r\n * @example\r\n * ```typescript\r\n * // Create your own auth middleware (Flight doesn't impose any auth provider)\r\n * const withAuth = createActionMiddleware(async (ctx, next) => {\r\n * const session = await yourAuthProvider.getSession(ctx.headers);\r\n * if (!session) {\r\n * return { success: false, error: 'UNAUTHORIZED' };\r\n * }\r\n * ctx.set('session', session);\r\n * return next();\r\n * });\r\n * \r\n * // Create your own rate limiter (Flight doesn't impose any rate limit provider)\r\n * const withRateLimit = createActionMiddleware(async (ctx, next) => {\r\n * const allowed = await yourRateLimiter.check(ctx.get('session').userId);\r\n * if (!allowed) {\r\n * return { success: false, error: 'RATE_LIMITED' };\r\n * }\r\n * return next();\r\n * });\r\n * \r\n * // Compose them\r\n * const protectedAction = pipeline(withAuth, withRateLimit)(myAction);\r\n * ```\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Action context - holds request data and middleware-set values\r\n */\r\nexport interface ActionContext {\r\n /** Original request (if available) */\r\n readonly request?: Request;\r\n /** Request headers */\r\n readonly headers: Headers;\r\n /** Action ID being executed */\r\n readonly actionId: string;\r\n /** Action arguments */\r\n readonly args: unknown[];\r\n /** Abort signal for cancellation */\r\n readonly signal?: AbortSignal;\r\n\r\n /** Get a value set by previous middleware */\r\n get<T = unknown>(key: string): T | undefined;\r\n /** Set a value for subsequent middleware/action */\r\n set<T = unknown>(key: string, value: T): void;\r\n}\r\n\r\n/**\r\n * Action result following Flight conventions\r\n */\r\nexport interface ActionResult<T = unknown> {\r\n success: boolean;\r\n data?: T;\r\n error?: string;\r\n code?: string;\r\n}\r\n\r\n/**\r\n * Next function to call the next middleware or action\r\n */\r\nexport type ActionNext<T = unknown> = () => Promise<ActionResult<T>>;\r\n\r\n/**\r\n * Middleware handler function\r\n */\r\nexport type ActionMiddlewareHandler<TContext extends ActionContext = ActionContext> = (\r\n ctx: TContext,\r\n next: ActionNext\r\n) => Promise<ActionResult> | ActionResult;\r\n\r\n/**\r\n * A middleware instance\r\n */\r\nexport interface ActionMiddleware {\r\n /** Unique name for debugging */\r\n readonly name: string;\r\n /** The handler function */\r\n readonly handler: ActionMiddlewareHandler;\r\n}\r\n\r\n/**\r\n * An action function\r\n */\r\nexport type Action<TInput = unknown, TOutput = unknown> = (\r\n ...args: TInput extends unknown[] ? TInput : [TInput]\r\n) => Promise<ActionResult<TOutput>>;\r\n\r\n/**\r\n * Options for creating middleware\r\n */\r\nexport interface CreateMiddlewareOptions {\r\n /** Name for debugging/logging */\r\n name?: string;\r\n}\r\n\r\n// ============================================================================\r\n// Action Context Implementation\r\n// ============================================================================\r\n\r\n/**\r\n * Create an action context from request or minimal data\r\n */\r\nexport function createActionContext(options: {\r\n request?: Request;\r\n headers?: Headers;\r\n actionId: string;\r\n args: unknown[];\r\n signal?: AbortSignal;\r\n}): ActionContext {\r\n const store = new Map<string, unknown>();\r\n\r\n return {\r\n request: options.request,\r\n headers: options.headers ?? options.request?.headers ?? new Headers(),\r\n actionId: options.actionId,\r\n args: options.args,\r\n signal: options.signal,\r\n\r\n get<T = unknown>(key: string): T | undefined {\r\n return store.get(key) as T | undefined;\r\n },\r\n\r\n set<T = unknown>(key: string, value: T): void {\r\n store.set(key, value);\r\n },\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// Middleware Creation\r\n// ============================================================================\r\n\r\nlet middlewareCounter = 0;\r\n\r\n/**\r\n * Create a reusable action middleware.\r\n * \r\n * Flight provides this PRIMITIVE - you define WHAT the middleware does.\r\n * \r\n * @example\r\n * ```typescript\r\n * // Authentication middleware (you choose the auth provider)\r\n * const withAuth = createActionMiddleware(async (ctx, next) => {\r\n * const token = ctx.headers.get('Authorization');\r\n * const user = await myAuthLib.verify(token); // YOUR auth library\r\n * \r\n * if (!user) {\r\n * return { success: false, error: 'Unauthorized', code: 'AUTH_ERROR' };\r\n * }\r\n * \r\n * ctx.set('user', user);\r\n * return next();\r\n * });\r\n * \r\n * // Validation middleware (you choose the validator)\r\n * const withValidation = (schema: ZodSchema) => createActionMiddleware(\r\n * async (ctx, next) => {\r\n * const result = schema.safeParse(ctx.args[0]);\r\n * if (!result.success) {\r\n * return { success: false, error: 'Validation failed', code: 'VALIDATION_ERROR' };\r\n * }\r\n * return next();\r\n * },\r\n * { name: 'validation' }\r\n * );\r\n * ```\r\n */\r\nexport function createActionMiddleware(\r\n handler: ActionMiddlewareHandler,\r\n options: CreateMiddlewareOptions = {}\r\n): ActionMiddleware {\r\n const name = options.name ?? `middleware_${++middlewareCounter}`;\r\n\r\n return {\r\n name,\r\n handler,\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// Pipeline Composition\r\n// ============================================================================\r\n\r\n/**\r\n * Compose multiple middleware into a pipeline that wraps an action.\r\n * \r\n * Middleware executes in order: first middleware runs first.\r\n * Each middleware can:\r\n * - Short-circuit by returning a result without calling next()\r\n * - Transform context for subsequent middleware\r\n * - Wrap the next() call for timing/logging\r\n * \r\n * @example\r\n * ```typescript\r\n * const protectedAction = pipeline(\r\n * withAuth,\r\n * withRateLimit,\r\n * withValidation(UserSchema),\r\n * )(createUserAction);\r\n * \r\n * // Now protectedAction has auth, rate-limit, and validation\r\n * const result = await protectedAction(userData);\r\n * ```\r\n */\r\nexport function pipeline<TInput, TOutput>(\r\n ...middlewares: ActionMiddleware[]\r\n): (action: Action<TInput, TOutput>) => Action<TInput, TOutput> {\r\n return (action: Action<TInput, TOutput>): Action<TInput, TOutput> => {\r\n return async (...args: TInput extends unknown[] ? TInput : [TInput]): Promise<ActionResult<TOutput>> => {\r\n // Create context for this execution\r\n const ctx = createActionContext({\r\n actionId: action.name || 'anonymous',\r\n args: args as unknown[],\r\n });\r\n\r\n // Build the middleware chain\r\n let index = -1;\r\n\r\n const dispatch = async (i: number): Promise<ActionResult<TOutput>> => {\r\n if (i <= index) {\r\n throw new Error('next() called multiple times');\r\n }\r\n index = i;\r\n\r\n if (i < middlewares.length) {\r\n // Execute middleware\r\n const middleware = middlewares[i]!;\r\n return middleware.handler(ctx, () => dispatch(i + 1)) as Promise<ActionResult<TOutput>>;\r\n } else {\r\n // Execute the actual action\r\n return action(...args);\r\n }\r\n };\r\n\r\n return dispatch(0);\r\n };\r\n };\r\n}\r\n\r\n/**\r\n * Execute an action with middleware, providing custom context.\r\n * \r\n * Use this when you need to provide request context (headers, etc.)\r\n * \r\n * @example\r\n * ```typescript\r\n * const result = await executeWithMiddleware(\r\n * myAction,\r\n * [arg1, arg2],\r\n * [withAuth, withRateLimit],\r\n * { request: incomingRequest }\r\n * );\r\n * ```\r\n */\r\nexport async function executeWithMiddleware<TInput extends unknown[], TOutput>(\r\n action: (...args: TInput) => Promise<ActionResult<TOutput>>,\r\n args: TInput,\r\n middlewares: ActionMiddleware[],\r\n options: {\r\n request?: Request;\r\n headers?: Headers;\r\n signal?: AbortSignal;\r\n } = {}\r\n): Promise<ActionResult<TOutput>> {\r\n // Create context with request info\r\n const ctx = createActionContext({\r\n request: options.request,\r\n headers: options.headers,\r\n actionId: action.name || 'anonymous',\r\n args: args as unknown[],\r\n signal: options.signal,\r\n });\r\n\r\n // Build the middleware chain\r\n let index = -1;\r\n\r\n const dispatch = async (i: number): Promise<ActionResult<TOutput>> => {\r\n // Check for abort\r\n if (options.signal?.aborted) {\r\n return { success: false, error: 'Aborted', code: 'ABORTED' };\r\n }\r\n\r\n if (i <= index) {\r\n throw new Error('next() called multiple times');\r\n }\r\n index = i;\r\n\r\n if (i < middlewares.length) {\r\n const middleware = middlewares[i]!;\r\n return middleware.handler(ctx, () => dispatch(i + 1)) as Promise<ActionResult<TOutput>>;\r\n } else {\r\n return action(...args);\r\n }\r\n };\r\n\r\n return dispatch(0);\r\n}\r\n\r\n// ============================================================================\r\n// Utility Middleware Factories\r\n// ============================================================================\r\n\r\n/**\r\n * Create a timing middleware for observability.\r\n * \r\n * You provide the reporter - Flight doesn't impose any observability provider.\r\n * \r\n * @example\r\n * ```typescript\r\n * const withTiming = createTimingMiddleware((actionId, durationMs) => {\r\n * myMetricsService.histogram('action.duration', durationMs, { actionId });\r\n * });\r\n * ```\r\n */\r\nexport function createTimingMiddleware(\r\n reporter: (actionId: string, durationMs: number, result: ActionResult) => void\r\n): ActionMiddleware {\r\n return createActionMiddleware(\r\n async (ctx, next) => {\r\n const start = performance.now();\r\n const result = await next();\r\n const duration = performance.now() - start;\r\n reporter(ctx.actionId, duration, result);\r\n return result;\r\n },\r\n { name: 'timing' }\r\n );\r\n}\r\n\r\n/**\r\n * Create a logging middleware.\r\n * \r\n * You provide the logger - Flight doesn't impose any logging library.\r\n * \r\n * @example\r\n * ```typescript\r\n * const withLogging = createLoggingMiddleware({\r\n * onStart: (ctx) => console.log(`[${ctx.actionId}] Starting...`),\r\n * onComplete: (ctx, result, ms) => console.log(`[${ctx.actionId}] ${result.success ? 'OK' : 'FAIL'} in ${ms}ms`),\r\n * });\r\n * ```\r\n */\r\nexport function createLoggingMiddleware(options: {\r\n onStart?: (ctx: ActionContext) => void;\r\n onComplete?: (ctx: ActionContext, result: ActionResult, durationMs: number) => void;\r\n onError?: (ctx: ActionContext, error: Error) => void;\r\n}): ActionMiddleware {\r\n return createActionMiddleware(\r\n async (ctx, next) => {\r\n options.onStart?.(ctx);\r\n const start = performance.now();\r\n\r\n try {\r\n const result = await next();\r\n const duration = performance.now() - start;\r\n options.onComplete?.(ctx, result, duration);\r\n return result;\r\n } catch (error) {\r\n options.onError?.(ctx, error as Error);\r\n throw error;\r\n }\r\n },\r\n { name: 'logging' }\r\n );\r\n}\r\n\r\n/**\r\n * Create a retry middleware.\r\n * \r\n * @example\r\n * ```typescript\r\n * const withRetry = createRetryMiddleware({\r\n * maxAttempts: 3,\r\n * delay: (attempt) => Math.pow(2, attempt) * 100, // Exponential backoff\r\n * shouldRetry: (result) => result.code === 'TEMPORARY_ERROR',\r\n * });\r\n * ```\r\n */\r\nexport function createRetryMiddleware(options: {\r\n maxAttempts: number;\r\n delay?: (attempt: number) => number;\r\n shouldRetry?: (result: ActionResult) => boolean;\r\n}): ActionMiddleware {\r\n const {\r\n maxAttempts,\r\n delay = () => 0,\r\n shouldRetry = (result) => !result.success,\r\n } = options;\r\n\r\n return createActionMiddleware(\r\n async (ctx, next) => {\r\n let lastResult: ActionResult = { success: false, error: 'No attempts made' };\r\n\r\n for (let attempt = 0; attempt < maxAttempts; attempt++) {\r\n if (attempt > 0) {\r\n const delayMs = delay(attempt);\r\n if (delayMs > 0) {\r\n await new Promise(resolve => setTimeout(resolve, delayMs));\r\n }\r\n }\r\n\r\n lastResult = await next();\r\n\r\n if (!shouldRetry(lastResult)) {\r\n return lastResult;\r\n }\r\n }\r\n\r\n return lastResult;\r\n },\r\n { name: 'retry' }\r\n );\r\n}\r\n","/**\r\n * @flight-framework/core - Action Streaming\r\n * \r\n * Streamable actions using async generators.\r\n * Flight provides the PRIMITIVES, you choose the transport.\r\n * \r\n * @example\r\n * ```typescript\r\n * // Create a streamable action for long-running operations\r\n * const generateReport = createStreamableAction(async function* (params: ReportParams) {\r\n * yield { type: 'progress', message: 'Fetching data...', progress: 0 };\r\n * const data = await fetchData(params);\r\n * \r\n * yield { type: 'progress', message: 'Processing...', progress: 33 };\r\n * const processed = await processData(data);\r\n * \r\n * yield { type: 'progress', message: 'Generating PDF...', progress: 66 };\r\n * const pdf = await generatePDF(processed);\r\n * \r\n * yield { type: 'progress', message: 'Complete!', progress: 100 };\r\n * return { success: true, data: pdf };\r\n * });\r\n * \r\n * // Client consumption\r\n * for await (const update of generateReport(params)) {\r\n * if (update.type === 'progress') {\r\n * setProgress(update.progress);\r\n * } else if (update.type === 'result') {\r\n * handleResult(update.data);\r\n * }\r\n * }\r\n * ```\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Progress update yielded during streaming\r\n */\r\nexport interface StreamProgress<TYield = unknown> {\r\n type: 'progress';\r\n data: TYield;\r\n}\r\n\r\n/**\r\n * Final result of a streaming action\r\n */\r\nexport interface StreamResult<TReturn = unknown> {\r\n type: 'result';\r\n success: boolean;\r\n data?: TReturn;\r\n error?: string;\r\n}\r\n\r\n/**\r\n * Union type for stream items\r\n */\r\nexport type StreamItem<TYield, TReturn> = StreamProgress<TYield> | StreamResult<TReturn>;\r\n\r\n/**\r\n * Streamable action generator function\r\n */\r\nexport type StreamableGenerator<TInput, TYield, TReturn> = (\r\n input: TInput,\r\n signal?: AbortSignal\r\n) => AsyncGenerator<TYield, TReturn>;\r\n\r\n/**\r\n * Options for creating a streamable action\r\n */\r\nexport interface StreamableActionOptions {\r\n /** Name for debugging */\r\n name?: string;\r\n /** Timeout in milliseconds */\r\n timeout?: number;\r\n}\r\n\r\n/**\r\n * Controller for a running stream\r\n */\r\nexport interface StreamController<TYield, TReturn> {\r\n /** Async iterator for consuming the stream */\r\n [Symbol.asyncIterator](): AsyncIterator<StreamItem<TYield, TReturn>>;\r\n /** Abort the stream */\r\n abort(): void;\r\n /** Promise that resolves when stream completes */\r\n done: Promise<StreamResult<TReturn>>;\r\n}\r\n\r\n/**\r\n * A streamable action function\r\n */\r\nexport type StreamableAction<TInput, TYield, TReturn> = (\r\n input: TInput\r\n) => StreamController<TYield, TReturn>;\r\n\r\n// ============================================================================\r\n// Streamable Action Creation\r\n// ============================================================================\r\n\r\n/**\r\n * Create a streamable action from an async generator.\r\n * \r\n * Flight provides this PRIMITIVE - you define the generator logic\r\n * and choose how to transport the stream (HTTP, WebSocket, etc.)\r\n * \r\n * @example\r\n * ```typescript\r\n * // AI streaming response\r\n * const streamChat = createStreamableAction(async function* (message: string) {\r\n * const stream = await openai.chat.completions.create({\r\n * model: 'gpt-4',\r\n * messages: [{ role: 'user', content: message }],\r\n * stream: true,\r\n * });\r\n * \r\n * let fullResponse = '';\r\n * for await (const chunk of stream) {\r\n * const text = chunk.choices[0]?.delta?.content || '';\r\n * fullResponse += text;\r\n * yield { text, partial: true };\r\n * }\r\n * \r\n * return { text: fullResponse, partial: false };\r\n * });\r\n * ```\r\n */\r\nexport function createStreamableAction<TInput, TYield, TReturn>(\r\n generator: StreamableGenerator<TInput, TYield, TReturn>,\r\n options: StreamableActionOptions = {}\r\n): StreamableAction<TInput, TYield, TReturn> {\r\n const actionName = options.name ?? generator.name ?? 'streamable_action';\r\n\r\n return (input: TInput): StreamController<TYield, TReturn> => {\r\n const abortController = new AbortController();\r\n let completed = false;\r\n let finalResult: StreamResult<TReturn> | null = null;\r\n\r\n // Create done promise\r\n let resolveDone: (result: StreamResult<TReturn>) => void;\r\n const done = new Promise<StreamResult<TReturn>>((resolve) => {\r\n resolveDone = resolve;\r\n });\r\n\r\n // Setup timeout if specified\r\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\r\n if (options.timeout) {\r\n timeoutId = setTimeout(() => {\r\n abortController.abort();\r\n }, options.timeout);\r\n }\r\n\r\n // Create the async iterator\r\n async function* iterate(): AsyncGenerator<StreamItem<TYield, TReturn>> {\r\n try {\r\n const gen = generator(input, abortController.signal);\r\n\r\n while (true) {\r\n if (abortController.signal.aborted) {\r\n const abortResult: StreamResult<TReturn> = {\r\n type: 'result',\r\n success: false,\r\n error: 'Stream aborted',\r\n };\r\n finalResult = abortResult;\r\n resolveDone!(abortResult);\r\n yield abortResult;\r\n return;\r\n }\r\n\r\n const next = await gen.next();\r\n\r\n if (next.done) {\r\n // Generator returned - this is the final value\r\n const successResult: StreamResult<TReturn> = {\r\n type: 'result',\r\n success: true,\r\n data: next.value,\r\n };\r\n finalResult = successResult;\r\n completed = true;\r\n resolveDone!(successResult);\r\n yield successResult;\r\n return;\r\n } else {\r\n // Generator yielded - this is a progress update\r\n yield {\r\n type: 'progress',\r\n data: next.value,\r\n };\r\n }\r\n }\r\n } catch (error) {\r\n const errorResult: StreamResult<TReturn> = {\r\n type: 'result',\r\n success: false,\r\n error: error instanceof Error ? error.message : 'Unknown error',\r\n };\r\n finalResult = errorResult;\r\n resolveDone!(errorResult);\r\n yield errorResult;\r\n } finally {\r\n if (timeoutId) {\r\n clearTimeout(timeoutId);\r\n }\r\n }\r\n }\r\n\r\n const iterator = iterate();\r\n\r\n return {\r\n [Symbol.asyncIterator]() {\r\n return iterator;\r\n },\r\n abort() {\r\n abortController.abort();\r\n },\r\n done,\r\n };\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// HTTP Transport Adapter\r\n// ============================================================================\r\n\r\n/**\r\n * Convert a streamable action result to an HTTP streaming response.\r\n * \r\n * This is ONE transport option - you can create others (WebSocket, SSE, etc.)\r\n * \r\n * @example\r\n * ```typescript\r\n * // In your API route\r\n * export async function POST(request: Request) {\r\n * const body = await request.json();\r\n * const stream = generateReport(body);\r\n * return streamToResponse(stream);\r\n * }\r\n * ```\r\n */\r\nexport function streamToResponse<TYield, TReturn>(\r\n controller: StreamController<TYield, TReturn>,\r\n options: {\r\n headers?: Record<string, string>;\r\n } = {}\r\n): Response {\r\n const encoder = new TextEncoder();\r\n\r\n const stream = new ReadableStream({\r\n async start(streamController) {\r\n try {\r\n for await (const item of controller) {\r\n const chunk = JSON.stringify(item) + '\\n';\r\n streamController.enqueue(encoder.encode(chunk));\r\n\r\n if (item.type === 'result') {\r\n break;\r\n }\r\n }\r\n } catch (error) {\r\n const errorChunk = JSON.stringify({\r\n type: 'result',\r\n success: false,\r\n error: error instanceof Error ? error.message : 'Stream error',\r\n }) + '\\n';\r\n streamController.enqueue(encoder.encode(errorChunk));\r\n } finally {\r\n streamController.close();\r\n }\r\n },\r\n cancel() {\r\n controller.abort();\r\n },\r\n });\r\n\r\n return new Response(stream, {\r\n status: 200,\r\n headers: {\r\n 'Content-Type': 'application/x-ndjson',\r\n 'Transfer-Encoding': 'chunked',\r\n 'Cache-Control': 'no-cache',\r\n 'Connection': 'keep-alive',\r\n ...options.headers,\r\n },\r\n });\r\n}\r\n\r\n/**\r\n * Parse an HTTP streaming response back to a stream controller (client-side).\r\n * \r\n * @example\r\n * ```typescript\r\n * // Client-side consumption\r\n * const response = await fetch('/api/generate-report', {\r\n * method: 'POST',\r\n * body: JSON.stringify(params),\r\n * });\r\n * \r\n * const stream = responseToStream<Progress, Report>(response);\r\n * \r\n * for await (const item of stream) {\r\n * if (item.type === 'progress') {\r\n * setProgress(item.data);\r\n * } else {\r\n * setReport(item.data);\r\n * }\r\n * }\r\n * ```\r\n */\r\nexport function responseToStream<TYield, TReturn>(\r\n response: Response\r\n): AsyncGenerator<StreamItem<TYield, TReturn>> {\r\n const reader = response.body?.getReader();\r\n const decoder = new TextDecoder();\r\n\r\n if (!reader) {\r\n throw new Error('Response body is not readable');\r\n }\r\n\r\n return (async function* () {\r\n let buffer = '';\r\n\r\n try {\r\n while (true) {\r\n const { done, value } = await reader.read();\r\n\r\n if (done) {\r\n break;\r\n }\r\n\r\n buffer += decoder.decode(value, { stream: true });\r\n\r\n // Process complete lines\r\n const lines = buffer.split('\\n');\r\n buffer = lines.pop() || ''; // Keep incomplete line in buffer\r\n\r\n for (const line of lines) {\r\n if (line.trim()) {\r\n try {\r\n const item = JSON.parse(line) as StreamItem<TYield, TReturn>;\r\n yield item;\r\n } catch {\r\n // Skip malformed JSON\r\n }\r\n }\r\n }\r\n }\r\n\r\n // Process remaining buffer\r\n if (buffer.trim()) {\r\n try {\r\n const item = JSON.parse(buffer) as StreamItem<TYield, TReturn>;\r\n yield item;\r\n } catch {\r\n // Skip malformed JSON\r\n }\r\n }\r\n } finally {\r\n reader.releaseLock();\r\n }\r\n })();\r\n}\r\n\r\n// ============================================================================\r\n// Utility Functions\r\n// ============================================================================\r\n\r\n/**\r\n * Collect all items from a stream into an array.\r\n * \r\n * Useful for testing or when you want to wait for completion.\r\n */\r\nexport async function collectStream<TYield, TReturn>(\r\n controller: StreamController<TYield, TReturn>\r\n): Promise<{ items: StreamItem<TYield, TReturn>[]; result: StreamResult<TReturn> }> {\r\n const items: StreamItem<TYield, TReturn>[] = [];\r\n let result: StreamResult<TReturn> | null = null;\r\n\r\n for await (const item of controller) {\r\n items.push(item);\r\n if (item.type === 'result') {\r\n result = item;\r\n }\r\n }\r\n\r\n if (!result) {\r\n result = { type: 'result', success: false, error: 'No result received' };\r\n }\r\n\r\n return { items, result };\r\n}\r\n\r\n/**\r\n * Create a simple progress reporter for streams.\r\n * \r\n * @example\r\n * ```typescript\r\n * const onProgress = createProgressReporter<MyProgress>((data) => {\r\n * console.log(`Progress: ${data.percent}%`);\r\n * });\r\n * \r\n * for await (const item of myStream) {\r\n * onProgress(item);\r\n * }\r\n * ```\r\n */\r\nexport function createProgressReporter<TYield, TReturn = unknown>(\r\n onProgress: (data: TYield) => void,\r\n onComplete?: (result: StreamResult<TReturn>) => void\r\n): (item: StreamItem<TYield, TReturn>) => void {\r\n return (item: StreamItem<TYield, TReturn>) => {\r\n if (item.type === 'progress') {\r\n onProgress(item.data);\r\n } else {\r\n onComplete?.(item);\r\n }\r\n };\r\n}\r\n","/**\r\n * @flight-framework/core - Action Queue\r\n * \r\n * Offline-first action queuing with pluggable storage.\r\n * Flight provides the PRIMITIVES and INTERFACE, you choose the storage.\r\n * \r\n * @example\r\n * ```typescript\r\n * // 1. Use a storage adapter (install separately or create your own)\r\n * import { indexedDBAdapter } from '@flight-framework/queue-indexeddb';\r\n * // OR create your own:\r\n * const myAdapter: QueueStorageAdapter = { ... };\r\n * \r\n * // 2. Create a queued action\r\n * const saveNote = createQueuedAction(\r\n * async (note: Note) => {\r\n * await api.saveNote(note);\r\n * return { success: true };\r\n * },\r\n * {\r\n * storage: indexedDBAdapter({ dbName: 'myapp' }),\r\n * retryStrategy: exponentialBackoff({ maxAttempts: 5 }),\r\n * onStatusChange: (status) => console.log('Queue status:', status),\r\n * }\r\n * );\r\n * \r\n * // 3. Use it - works offline!\r\n * await saveNote({ title: 'My Note', content: '...' });\r\n * // If offline: queued and synced later\r\n * // If online: executed immediately\r\n * ```\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * A queued action entry\r\n */\r\nexport interface QueuedActionEntry<TInput = unknown> {\r\n /** Unique ID for this entry */\r\n id: string;\r\n /** Action identifier */\r\n actionId: string;\r\n /** Action arguments */\r\n input: TInput;\r\n /** When the action was queued */\r\n queuedAt: number;\r\n /** Number of execution attempts */\r\n attempts: number;\r\n /** Last error message if failed */\r\n lastError?: string;\r\n /** Status */\r\n status: 'pending' | 'processing' | 'failed';\r\n /** Optional metadata */\r\n meta?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Queue storage adapter interface.\r\n * \r\n * Flight does NOT provide storage implementations - you choose:\r\n * - @flight-framework/queue-indexeddb (browser)\r\n * - @flight-framework/queue-sqlite (mobile/desktop)\r\n * - @flight-framework/queue-memory (testing)\r\n * - Your own implementation\r\n */\r\nexport interface QueueStorageAdapter {\r\n /** Add an action to the queue */\r\n enqueue<TInput>(entry: QueuedActionEntry<TInput>): Promise<void>;\r\n\r\n /** Get and remove the next pending action */\r\n dequeue(): Promise<QueuedActionEntry | null>;\r\n\r\n /** Get all pending actions without removing */\r\n peek(): Promise<QueuedActionEntry[]>;\r\n\r\n /** Update an existing entry */\r\n update(id: string, updates: Partial<QueuedActionEntry>): Promise<void>;\r\n\r\n /** Remove an entry by ID */\r\n remove(id: string): Promise<void>;\r\n\r\n /** Clear all entries */\r\n clear(): Promise<void>;\r\n\r\n /** Get queue length */\r\n length(): Promise<number>;\r\n}\r\n\r\n/**\r\n * Retry strategy function\r\n */\r\nexport type RetryStrategy = (\r\n entry: QueuedActionEntry,\r\n error: Error\r\n) => { shouldRetry: boolean; delayMs: number };\r\n\r\n/**\r\n * Queue status for observability\r\n */\r\nexport interface QueueStatus {\r\n /** Whether the queue processor is running */\r\n isProcessing: boolean;\r\n /** Number of pending actions */\r\n pendingCount: number;\r\n /** Number of failed actions */\r\n failedCount: number;\r\n /** Whether online */\r\n isOnline: boolean;\r\n}\r\n\r\n/**\r\n * Options for creating a queued action\r\n */\r\nexport interface QueuedActionOptions {\r\n /** Storage adapter (required - Flight doesn't provide default) */\r\n storage: QueueStorageAdapter;\r\n /** Custom action ID */\r\n actionId?: string;\r\n /** Retry strategy */\r\n retryStrategy?: RetryStrategy;\r\n /** Check if online (default: navigator.onLine on browser) */\r\n isOnline?: () => boolean | Promise<boolean>;\r\n /** Called when queue status changes */\r\n onStatusChange?: (status: QueueStatus) => void;\r\n /** Called when an action is successfully processed */\r\n onSuccess?: (entry: QueuedActionEntry, result: unknown) => void;\r\n /** Called when an action fails permanently */\r\n onFailure?: (entry: QueuedActionEntry, error: Error) => void;\r\n}\r\n\r\n/**\r\n * Action result for queued actions\r\n */\r\nexport interface QueuedActionResult<TOutput = unknown> {\r\n /** Whether immediately executed or queued */\r\n queued: boolean;\r\n /** Queue entry ID if queued */\r\n entryId?: string;\r\n /** Result if immediately executed */\r\n result?: { success: boolean; data?: TOutput; error?: string };\r\n}\r\n\r\n/**\r\n * A queued action function\r\n */\r\nexport type QueuedAction<TInput, TOutput> = (\r\n input: TInput\r\n) => Promise<QueuedActionResult<TOutput>>;\r\n\r\n// ============================================================================\r\n// Queue Creation\r\n// ============================================================================\r\n\r\nlet entryCounter = 0;\r\n\r\nfunction generateEntryId(): string {\r\n return `${Date.now()}_${++entryCounter}_${Math.random().toString(36).substring(2, 9)}`;\r\n}\r\n\r\n/**\r\n * Create an offline-capable queued action.\r\n * \r\n * Flight provides this PRIMITIVE - you provide the storage adapter.\r\n * \r\n * @example\r\n * ```typescript\r\n * // Create with your storage adapter\r\n * const syncData = createQueuedAction(\r\n * async (data: MyData) => {\r\n * await api.sync(data);\r\n * return { success: true };\r\n * },\r\n * {\r\n * storage: myStorageAdapter,\r\n * retryStrategy: exponentialBackoff(),\r\n * }\r\n * );\r\n * \r\n * // Use it - works offline automatically\r\n * const result = await syncData({ items: [...] });\r\n * \r\n * if (result.queued) {\r\n * console.log('Queued for later sync:', result.entryId);\r\n * } else {\r\n * console.log('Synced immediately:', result.result);\r\n * }\r\n * ```\r\n */\r\nexport function createQueuedAction<TInput, TOutput>(\r\n action: (input: TInput) => Promise<{ success: boolean; data?: TOutput; error?: string }>,\r\n options: QueuedActionOptions\r\n): QueuedAction<TInput, TOutput> {\r\n const {\r\n storage,\r\n actionId = action.name || `action_${Date.now()}`,\r\n retryStrategy = defaultRetryStrategy,\r\n isOnline = defaultIsOnline,\r\n onStatusChange,\r\n onSuccess,\r\n onFailure,\r\n } = options;\r\n\r\n // Queue processor state\r\n let isProcessing = false;\r\n let processorRunning = false;\r\n\r\n // Start background processor\r\n startProcessor();\r\n\r\n async function startProcessor() {\r\n if (processorRunning) return;\r\n processorRunning = true;\r\n\r\n // Process queue periodically\r\n while (processorRunning) {\r\n await processQueue();\r\n await sleep(1000); // Check every second\r\n }\r\n }\r\n\r\n async function processQueue() {\r\n // Check if online\r\n const online = await isOnline();\r\n if (!online) {\r\n return;\r\n }\r\n\r\n // Get next entry\r\n const entry = await storage.dequeue();\r\n if (!entry) {\r\n if (isProcessing) {\r\n isProcessing = false;\r\n await notifyStatus();\r\n }\r\n return;\r\n }\r\n\r\n isProcessing = true;\r\n await notifyStatus();\r\n\r\n // Update status to processing\r\n await storage.update(entry.id, { status: 'processing' });\r\n\r\n try {\r\n // Execute the action\r\n const result = await action(entry.input as TInput);\r\n\r\n // Success - remove from queue\r\n await storage.remove(entry.id);\r\n onSuccess?.(entry, result);\r\n } catch (error) {\r\n const err = error instanceof Error ? error : new Error(String(error));\r\n\r\n // Check retry strategy\r\n const { shouldRetry, delayMs } = retryStrategy(entry, err);\r\n\r\n if (shouldRetry) {\r\n // Re-queue with updated attempts\r\n await storage.update(entry.id, {\r\n status: 'pending',\r\n attempts: entry.attempts + 1,\r\n lastError: err.message,\r\n });\r\n\r\n // Wait before next attempt\r\n if (delayMs > 0) {\r\n await sleep(delayMs);\r\n }\r\n } else {\r\n // Mark as failed\r\n await storage.update(entry.id, {\r\n status: 'failed',\r\n lastError: err.message,\r\n });\r\n onFailure?.(entry, err);\r\n }\r\n }\r\n }\r\n\r\n async function notifyStatus() {\r\n if (!onStatusChange) return;\r\n\r\n const entries = await storage.peek();\r\n const status: QueueStatus = {\r\n isProcessing,\r\n pendingCount: entries.filter(e => e.status === 'pending').length,\r\n failedCount: entries.filter(e => e.status === 'failed').length,\r\n isOnline: await isOnline(),\r\n };\r\n onStatusChange(status);\r\n }\r\n\r\n // Return the queued action function\r\n return async (input: TInput): Promise<QueuedActionResult<TOutput>> => {\r\n const online = await isOnline();\r\n\r\n if (online) {\r\n // Try to execute immediately\r\n try {\r\n const result = await action(input);\r\n return { queued: false, result };\r\n } catch {\r\n // Fall through to queue\r\n }\r\n }\r\n\r\n // Queue for later\r\n const entry: QueuedActionEntry<TInput> = {\r\n id: generateEntryId(),\r\n actionId,\r\n input,\r\n queuedAt: Date.now(),\r\n attempts: 0,\r\n status: 'pending',\r\n };\r\n\r\n await storage.enqueue(entry);\r\n await notifyStatus();\r\n\r\n return { queued: true, entryId: entry.id };\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// Built-in Retry Strategies\r\n// ============================================================================\r\n\r\n/**\r\n * Default retry strategy: 3 attempts with 1 second delay\r\n */\r\nexport const defaultRetryStrategy: RetryStrategy = (entry) => ({\r\n shouldRetry: entry.attempts < 3,\r\n delayMs: 1000,\r\n});\r\n\r\n/**\r\n * Create an exponential backoff retry strategy.\r\n * \r\n * @example\r\n * ```typescript\r\n * const retry = exponentialBackoff({\r\n * maxAttempts: 5,\r\n * baseDelayMs: 1000,\r\n * maxDelayMs: 30000,\r\n * });\r\n * ```\r\n */\r\nexport function exponentialBackoff(options: {\r\n maxAttempts?: number;\r\n baseDelayMs?: number;\r\n maxDelayMs?: number;\r\n} = {}): RetryStrategy {\r\n const {\r\n maxAttempts = 5,\r\n baseDelayMs = 1000,\r\n maxDelayMs = 30000,\r\n } = options;\r\n\r\n return (entry) => {\r\n const shouldRetry = entry.attempts < maxAttempts;\r\n const delayMs = Math.min(\r\n baseDelayMs * Math.pow(2, entry.attempts),\r\n maxDelayMs\r\n );\r\n\r\n return { shouldRetry, delayMs };\r\n };\r\n}\r\n\r\n/**\r\n * Create a fixed delay retry strategy.\r\n */\r\nexport function fixedDelay(options: {\r\n maxAttempts?: number;\r\n delayMs?: number;\r\n} = {}): RetryStrategy {\r\n const { maxAttempts = 3, delayMs = 1000 } = options;\r\n\r\n return (entry) => ({\r\n shouldRetry: entry.attempts < maxAttempts,\r\n delayMs,\r\n });\r\n}\r\n\r\n// ============================================================================\r\n// In-Memory Storage Adapter (for testing only)\r\n// ============================================================================\r\n\r\n/**\r\n * In-memory queue storage adapter.\r\n * \r\n * ⚠️ FOR TESTING ONLY - data is lost on page refresh.\r\n * \r\n * For production, use:\r\n * - @flight-framework/queue-indexeddb (browser)\r\n * - @flight-framework/queue-sqlite (native apps)\r\n * - Your own implementation\r\n */\r\nexport function createMemoryAdapter(): QueueStorageAdapter {\r\n const store = new Map<string, QueuedActionEntry>();\r\n\r\n return {\r\n async enqueue(entry) {\r\n store.set(entry.id, entry);\r\n },\r\n\r\n async dequeue() {\r\n for (const [id, entry] of store.entries()) {\r\n if (entry.status === 'pending') {\r\n store.delete(id);\r\n return entry;\r\n }\r\n }\r\n return null;\r\n },\r\n\r\n async peek() {\r\n return Array.from(store.values());\r\n },\r\n\r\n async update(id, updates) {\r\n const entry = store.get(id);\r\n if (entry) {\r\n store.set(id, { ...entry, ...updates });\r\n }\r\n },\r\n\r\n async remove(id) {\r\n store.delete(id);\r\n },\r\n\r\n async clear() {\r\n store.clear();\r\n },\r\n\r\n async length() {\r\n return store.size;\r\n },\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// Utility Functions\r\n// ============================================================================\r\n\r\nfunction sleep(ms: number): Promise<void> {\r\n return new Promise(resolve => setTimeout(resolve, ms));\r\n}\r\n\r\nfunction defaultIsOnline(): boolean {\r\n if (typeof navigator !== 'undefined' && 'onLine' in navigator) {\r\n return navigator.onLine;\r\n }\r\n // Assume online in non-browser environments\r\n return true;\r\n}\r\n\r\n/**\r\n * Create a queue manager to control multiple queued actions.\r\n * \r\n * @example\r\n * ```typescript\r\n * const queueManager = createQueueManager({\r\n * storage: myStorageAdapter,\r\n * });\r\n * \r\n * // Pause all processing\r\n * queueManager.pause();\r\n * \r\n * // Resume\r\n * queueManager.resume();\r\n * \r\n * // Get status\r\n * const status = await queueManager.getStatus();\r\n * ```\r\n */\r\nexport function createQueueManager(options: {\r\n storage: QueueStorageAdapter;\r\n}): {\r\n pause: () => void;\r\n resume: () => void;\r\n getStatus: () => Promise<QueueStatus>;\r\n clearFailed: () => Promise<void>;\r\n retryFailed: () => Promise<void>;\r\n} {\r\n let paused = false;\r\n\r\n return {\r\n pause() {\r\n paused = true;\r\n },\r\n\r\n resume() {\r\n paused = false;\r\n },\r\n\r\n async getStatus() {\r\n const entries = await options.storage.peek();\r\n return {\r\n isProcessing: !paused,\r\n pendingCount: entries.filter(e => e.status === 'pending').length,\r\n failedCount: entries.filter(e => e.status === 'failed').length,\r\n isOnline: defaultIsOnline(),\r\n };\r\n },\r\n\r\n async clearFailed() {\r\n const entries = await options.storage.peek();\r\n for (const entry of entries) {\r\n if (entry.status === 'failed') {\r\n await options.storage.remove(entry.id);\r\n }\r\n }\r\n },\r\n\r\n async retryFailed() {\r\n const entries = await options.storage.peek();\r\n for (const entry of entries) {\r\n if (entry.status === 'failed') {\r\n await options.storage.update(entry.id, {\r\n status: 'pending',\r\n attempts: 0,\r\n lastError: undefined,\r\n });\r\n }\r\n }\r\n },\r\n };\r\n}\r\n","/**\r\n * @flight-framework/core - Server Actions\r\n * \r\n * Implementation of React 19 style Server Actions.\r\n * Functions marked with 'use server' run on the server.\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Server action metadata\r\n */\r\nexport interface ServerAction {\r\n /** Unique action ID */\r\n id: string;\r\n /** Original function name */\r\n name: string;\r\n /** File path where action is defined */\r\n filePath: string;\r\n /** The actual action function */\r\n fn: (...args: unknown[]) => Promise<unknown>;\r\n}\r\n\r\n/**\r\n * Server action result\r\n */\r\nexport interface ActionResult<T = unknown> {\r\n success: boolean;\r\n data?: T;\r\n error?: string;\r\n}\r\n\r\n/**\r\n * Form action data\r\n */\r\nexport interface FormActionData {\r\n actionId: string;\r\n formData: FormData;\r\n}\r\n\r\n// ============================================================================\r\n// Action Registry\r\n// ============================================================================\r\n\r\nconst actionRegistry = new Map<string, ServerAction>();\r\n\r\n/**\r\n * Register a server action\r\n */\r\nexport function registerAction(action: ServerAction): void {\r\n actionRegistry.set(action.id, action);\r\n}\r\n\r\n/**\r\n * Get a registered action by ID\r\n */\r\nexport function getAction(id: string): ServerAction | undefined {\r\n return actionRegistry.get(id);\r\n}\r\n\r\n/**\r\n * Get all registered actions\r\n */\r\nexport function getAllActions(): ServerAction[] {\r\n return Array.from(actionRegistry.values());\r\n}\r\n\r\n/**\r\n * Clear all registered actions (useful for testing)\r\n */\r\nexport function clearActions(): void {\r\n actionRegistry.clear();\r\n}\r\n\r\n// ============================================================================\r\n// Action Execution\r\n// ============================================================================\r\n\r\n/**\r\n * Execute a server action\r\n */\r\nexport async function executeAction<T = unknown>(\r\n actionId: string,\r\n args: unknown[]\r\n): Promise<ActionResult<T>> {\r\n const action = getAction(actionId);\r\n\r\n if (!action) {\r\n return {\r\n success: false,\r\n error: `Action not found: ${actionId}`,\r\n };\r\n }\r\n\r\n try {\r\n const result = await action.fn(...args);\r\n return {\r\n success: true,\r\n data: result as T,\r\n };\r\n } catch (error) {\r\n // Re-throw RedirectError so handleActionRequest can return 303\r\n if (isRedirectError(error)) {\r\n throw error;\r\n }\r\n console.error(`[Flight] Action error (${actionId}):`, error);\r\n return {\r\n success: false,\r\n error: error instanceof Error ? error.message : 'Unknown error',\r\n };\r\n }\r\n}\r\n\r\n/**\r\n * Execute a form action\r\n */\r\nexport async function executeFormAction<T = unknown>(\r\n actionId: string,\r\n formData: FormData\r\n): Promise<ActionResult<T>> {\r\n return executeAction<T>(actionId, [formData]);\r\n}\r\n\r\n// ============================================================================\r\n// Action ID Generation\r\n// ============================================================================\r\n\r\nlet actionCounter = 0;\r\n\r\n/**\r\n * Generate a unique action ID\r\n */\r\nexport function generateActionId(name: string, filePath: string): string {\r\n const hash = simpleHash(`${filePath}:${name}`);\r\n return `action_${hash}_${actionCounter++}`;\r\n}\r\n\r\n/**\r\n * Simple hash function for action IDs\r\n */\r\nfunction simpleHash(str: string): string {\r\n let hash = 0;\r\n for (let i = 0; i < str.length; i++) {\r\n const char = str.charCodeAt(i);\r\n hash = ((hash << 5) - hash) + char;\r\n hash = hash & hash; // Convert to 32bit integer\r\n }\r\n return Math.abs(hash).toString(36);\r\n}\r\n\r\n// ============================================================================\r\n// Action Helpers (for use inside actions)\r\n// ============================================================================\r\n\r\n/**\r\n * Get cookies in server action context\r\n */\r\nexport function cookies(): {\r\n get: (name: string) => string | undefined;\r\n set: (name: string, value: string, options?: CookieOptions) => void;\r\n delete: (name: string) => void;\r\n} {\r\n // This will be populated by the runtime\r\n const cookieStore = (globalThis as any).__flightCookies;\r\n\r\n if (!cookieStore) {\r\n console.warn('[Flight] Cookies not available outside of action context');\r\n return {\r\n get: () => undefined,\r\n set: () => { },\r\n delete: () => { },\r\n };\r\n }\r\n\r\n return cookieStore;\r\n}\r\n\r\nexport interface CookieOptions {\r\n maxAge?: number;\r\n expires?: Date;\r\n path?: string;\r\n domain?: string;\r\n secure?: boolean;\r\n httpOnly?: boolean;\r\n sameSite?: 'strict' | 'lax' | 'none';\r\n}\r\n\r\n/**\r\n * Redirect in server action context\r\n */\r\nexport function redirect(url: string): never {\r\n throw new RedirectError(url);\r\n}\r\n\r\n/**\r\n * Special error for redirects\r\n */\r\nexport class RedirectError extends Error {\r\n public readonly url: string;\r\n\r\n constructor(url: string) {\r\n super(`Redirect to ${url}`);\r\n this.name = 'RedirectError';\r\n this.url = url;\r\n }\r\n}\r\n\r\n/**\r\n * Check if error is a redirect\r\n */\r\nexport function isRedirectError(error: unknown): error is RedirectError {\r\n return error instanceof RedirectError;\r\n}\r\n\r\n// ============================================================================\r\n// Form Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Parse form data to typed object\r\n */\r\nexport function parseFormData<T extends Record<string, string>>(\r\n formData: FormData\r\n): T {\r\n const result: Record<string, string> = {};\r\n\r\n formData.forEach((value, key) => {\r\n result[key] = String(value);\r\n });\r\n\r\n return result as T;\r\n}\r\n\r\n/**\r\n * Create action reference for form action attribute\r\n */\r\nexport function createActionReference(actionId: string): string {\r\n return `/__flight_action/${actionId}`;\r\n}\r\n\r\n// ============================================================================\r\n// Action Handler (for HTTP endpoint)\r\n// ============================================================================\r\n\r\n/**\r\n * Handle action request from client\r\n */\r\nexport async function handleActionRequest(\r\n request: Request\r\n): Promise<Response> {\r\n const url = new URL(request.url);\r\n const actionPath = url.pathname;\r\n\r\n // Extract action ID from path: /__flight_action/{actionId}\r\n const match = actionPath.match(/^\\/__flight_action\\/(.+)$/);\r\n\r\n if (!match) {\r\n return new Response(JSON.stringify({ error: 'Invalid action path' }), {\r\n status: 400,\r\n headers: { 'Content-Type': 'application/json' },\r\n });\r\n }\r\n\r\n const actionId = match[1];\r\n\r\n if (!actionId) {\r\n return new Response(JSON.stringify({ error: 'Missing action ID' }), {\r\n status: 400,\r\n headers: { 'Content-Type': 'application/json' },\r\n });\r\n }\r\n\r\n try {\r\n let result: ActionResult;\r\n\r\n // Check content type for form vs JSON\r\n const contentType = request.headers.get('content-type') || '';\r\n\r\n if (contentType.includes('application/x-www-form-urlencoded') ||\r\n contentType.includes('multipart/form-data')) {\r\n const formData = await request.formData();\r\n result = await executeFormAction(actionId, formData);\r\n } else {\r\n const args = await request.json();\r\n result = await executeAction(actionId, Array.isArray(args) ? args : [args]);\r\n }\r\n\r\n return new Response(JSON.stringify(result), {\r\n status: result.success ? 200 : 400,\r\n headers: { 'Content-Type': 'application/json' },\r\n });\r\n } catch (error) {\r\n if (isRedirectError(error)) {\r\n return new Response(null, {\r\n status: 303,\r\n headers: { Location: error.url },\r\n });\r\n }\r\n\r\n return new Response(JSON.stringify({\r\n success: false,\r\n error: error instanceof Error ? error.message : 'Unknown error',\r\n }), {\r\n status: 500,\r\n headers: { 'Content-Type': 'application/json' },\r\n });\r\n }\r\n}\r\n\r\n// ============================================================================\r\n// Re-export New Modules\r\n// ============================================================================\r\n\r\n// Action Middleware - composable middleware for actions\r\nexport * from './middleware.js';\r\n\r\n// Action Streaming - async generator-based streaming actions\r\nexport * from './streaming.js';\r\n\r\n// Action Queue - offline-first action queuing\r\nexport * from './queue.js';\r\n\r\n"]}
@@ -201,5 +201,5 @@ function getRedirectInfo(error) {
201
201
  }
202
202
 
203
203
  export { acceptsJson, createServerContext, deleteCookie, getHeader, getHeaders, getPreferredLanguage, getRedirectInfo, isAjaxRequest, isBotRequest, isMutationRequest, isNotFoundError, isRedirectError, notFound, redirect, setCacheControl, setCookie, supportsStreaming };
204
- //# sourceMappingURL=chunk-CKJHJPKQ.js.map
205
- //# sourceMappingURL=chunk-CKJHJPKQ.js.map
204
+ //# sourceMappingURL=chunk-62C7LX2E.js.map
205
+ //# sourceMappingURL=chunk-62C7LX2E.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/rsc/context.ts"],"names":[],"mappings":"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","file":"chunk-62C7LX2E.js","sourcesContent":["/**\r\n * @flight-framework/core - Server Context\r\n * \r\n * API de contexto para Server Components.\r\n * Provee acceso a datos del request de forma explícita y type-safe.\r\n * \r\n * Filosofía Flight:\r\n * - Contexto EXPLÍCITO (no magia con AsyncLocalStorage)\r\n * - Pasado como argumento (testeable, predecible)\r\n * - Extensible con adapters custom\r\n * - Inmutable por defecto\r\n * \r\n * @module @flight-framework/core/rsc/context\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Contexto del servidor disponible en Server Components\r\n */\r\nexport interface ServerContext {\r\n /** Request actual (Web API Request) */\r\n readonly request: Request;\r\n\r\n /** Parámetros de ruta */\r\n readonly params: Readonly<Record<string, string>>;\r\n\r\n /** Search params de la URL */\r\n readonly searchParams: URLSearchParams;\r\n\r\n /** Headers del request */\r\n readonly headers: Headers;\r\n\r\n /** Accessor de cookies */\r\n readonly cookies: CookieAccessor;\r\n\r\n /** Headers de respuesta (mutables) */\r\n readonly responseHeaders: Headers;\r\n\r\n /** Signal para cancelación */\r\n readonly signal: AbortSignal;\r\n\r\n /** URL parseada */\r\n readonly url: URL;\r\n\r\n /** Método HTTP */\r\n readonly method: string;\r\n\r\n /** Context extensions (para adapters) */\r\n readonly extensions: ContextExtensions;\r\n}\r\n\r\n/**\r\n * Accessor para cookies con lazy parsing\r\n */\r\nexport interface CookieAccessor {\r\n /** Obtiene el valor de una cookie */\r\n get(name: string): string | undefined;\r\n\r\n /** Obtiene todas las cookies */\r\n getAll(): Readonly<Record<string, string>>;\r\n\r\n /** Verifica si existe una cookie */\r\n has(name: string): boolean;\r\n}\r\n\r\n/**\r\n * Extensiones del contexto para adapters\r\n */\r\nexport interface ContextExtensions {\r\n /** Obtiene una extensión */\r\n get<T>(key: string): T | undefined;\r\n\r\n /** Verifica si existe una extensión */\r\n has(key: string): boolean;\r\n}\r\n\r\n/**\r\n * Opciones para crear ServerContext\r\n */\r\nexport interface ServerContextOptions {\r\n /** Parámetros de ruta */\r\n params?: Record<string, string>;\r\n\r\n /** Extensiones custom */\r\n extensions?: Record<string, unknown>;\r\n\r\n /** Headers de respuesta iniciales */\r\n responseHeaders?: HeadersInit;\r\n}\r\n\r\n// ============================================================================\r\n// Implementation\r\n// ============================================================================\r\n\r\n/**\r\n * Crea un ServerContext a partir de un Request\r\n * \r\n * @example\r\n * ```typescript\r\n * const ctx = createServerContext(request, { \r\n * params: { id: '123' } \r\n * });\r\n * \r\n * // En un Server Component\r\n * async function UserPage(props, ctx: ServerContext) {\r\n * const userId = ctx.params.id;\r\n * const user = await db.users.get(userId);\r\n * return <UserProfile user={user} />;\r\n * }\r\n * ```\r\n */\r\nexport function createServerContext(\r\n request: Request,\r\n options: ServerContextOptions = {}\r\n): ServerContext {\r\n const { params = {}, extensions = {}, responseHeaders: initHeaders } = options;\r\n\r\n // Parse URL\r\n const url = new URL(request.url);\r\n\r\n // Lazy cookie parsing\r\n let parsedCookies: Record<string, string> | null = null;\r\n\r\n const parseCookies = (): Record<string, string> => {\r\n if (parsedCookies !== null) return parsedCookies;\r\n\r\n parsedCookies = {};\r\n const cookieHeader = request.headers.get('cookie');\r\n\r\n if (cookieHeader) {\r\n for (const cookie of cookieHeader.split(';')) {\r\n const trimmed = cookie.trim();\r\n const eqIndex = trimmed.indexOf('=');\r\n\r\n if (eqIndex > 0) {\r\n const key = trimmed.slice(0, eqIndex).trim();\r\n const value = trimmed.slice(eqIndex + 1).trim();\r\n\r\n // Decode URL-encoded values\r\n try {\r\n parsedCookies[key] = decodeURIComponent(value);\r\n } catch {\r\n parsedCookies[key] = value;\r\n }\r\n }\r\n }\r\n }\r\n\r\n return parsedCookies;\r\n };\r\n\r\n // Cookie accessor\r\n const cookies: CookieAccessor = {\r\n get(name: string): string | undefined {\r\n return parseCookies()[name];\r\n },\r\n getAll(): Readonly<Record<string, string>> {\r\n return Object.freeze({ ...parseCookies() });\r\n },\r\n has(name: string): boolean {\r\n return name in parseCookies();\r\n },\r\n };\r\n\r\n // Extensions accessor\r\n const contextExtensions: ContextExtensions = {\r\n get<T>(key: string): T | undefined {\r\n return extensions[key] as T | undefined;\r\n },\r\n has(key: string): boolean {\r\n return key in extensions;\r\n },\r\n };\r\n\r\n // Response headers (mutable)\r\n const responseHeaders = new Headers(initHeaders);\r\n\r\n return Object.freeze({\r\n request,\r\n params: Object.freeze({ ...params }),\r\n searchParams: url.searchParams,\r\n headers: request.headers,\r\n cookies,\r\n responseHeaders,\r\n signal: request.signal,\r\n url,\r\n method: request.method,\r\n extensions: contextExtensions,\r\n });\r\n}\r\n\r\n// ============================================================================\r\n// Context Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Obtiene un header del request\r\n */\r\nexport function getHeader(ctx: ServerContext, name: string): string | null {\r\n return ctx.headers.get(name);\r\n}\r\n\r\n/**\r\n * Obtiene todos los headers como objeto\r\n */\r\nexport function getHeaders(ctx: ServerContext): Record<string, string> {\r\n const headers: Record<string, string> = {};\r\n ctx.headers.forEach((value, key) => {\r\n headers[key] = value;\r\n });\r\n return headers;\r\n}\r\n\r\n/**\r\n * Verifica si el request es un POST/PUT/PATCH/DELETE (mutation request)\r\n */\r\nexport function isMutationRequest(ctx: ServerContext): boolean {\r\n return ['POST', 'PUT', 'PATCH', 'DELETE'].includes(ctx.method);\r\n}\r\n\r\n/**\r\n * Verifica si el request acepta JSON\r\n */\r\nexport function acceptsJson(ctx: ServerContext): boolean {\r\n const accept = ctx.headers.get('accept') || '';\r\n return accept.includes('application/json') || accept.includes('*/*');\r\n}\r\n\r\n/**\r\n * Verifica si el request es AJAX/fetch\r\n */\r\nexport function isAjaxRequest(ctx: ServerContext): boolean {\r\n return ctx.headers.get('x-requested-with')?.toLowerCase() === 'xmlhttprequest' ||\r\n ctx.headers.has('x-flight-action');\r\n}\r\n\r\n/**\r\n * Verifica si el request viene de un bot\r\n */\r\nexport function isBotRequest(ctx: ServerContext): boolean {\r\n const ua = ctx.headers.get('user-agent')?.toLowerCase() || '';\r\n const botPatterns = [\r\n 'bot', 'crawler', 'spider', 'scraper',\r\n 'googlebot', 'bingbot', 'yandexbot', 'duckduckbot',\r\n 'slurp', 'baiduspider', 'facebookexternalhit',\r\n 'twitterbot', 'linkedinbot', 'embedly', 'quora',\r\n 'outbrain', 'pinterest', 'slack', 'vkshare',\r\n 'w3c_validator', 'lighthouse', 'pagespeed',\r\n ];\r\n return botPatterns.some(pattern => ua.includes(pattern));\r\n}\r\n\r\n/**\r\n * Verifica si el cliente soporta streaming\r\n */\r\nexport function supportsStreaming(ctx: ServerContext): boolean {\r\n // Check for no-stream preference\r\n const noStream = ctx.searchParams.get('_nostream');\r\n if (noStream === '1' || noStream === 'true') return false;\r\n\r\n // Bots typically don't support streaming well\r\n if (isBotRequest(ctx)) return false;\r\n\r\n // Check for slow connection hints\r\n const connection = ctx.headers.get('downlink') || ctx.headers.get('ect');\r\n if (connection === 'slow-2g' || connection === '2g') return false;\r\n\r\n return true;\r\n}\r\n\r\n/**\r\n * Obtiene el idioma preferido del cliente\r\n */\r\nexport function getPreferredLanguage(ctx: ServerContext, available: string[]): string | undefined {\r\n const acceptLang = ctx.headers.get('accept-language');\r\n if (!acceptLang) return available[0];\r\n\r\n // Parse Accept-Language header\r\n const languages = acceptLang\r\n .split(',')\r\n .map(lang => {\r\n const [code, q = 'q=1'] = lang.trim().split(';');\r\n const quality = parseFloat(q.replace('q=', '')) || 1;\r\n return { code: code!.trim().toLowerCase(), quality };\r\n })\r\n .sort((a, b) => b.quality - a.quality);\r\n\r\n // Find best match\r\n for (const { code } of languages) {\r\n // Exact match\r\n const exact = available.find(a => a.toLowerCase() === code);\r\n if (exact) return exact;\r\n\r\n // Language-only match (e.g., 'es' matches 'es-AR')\r\n const baseCode = code.split('-')[0];\r\n const partial = available.find(a => a.toLowerCase().startsWith(baseCode!));\r\n if (partial) return partial;\r\n }\r\n\r\n return available[0];\r\n}\r\n\r\n// ============================================================================\r\n// Response Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Sets a cookie in the response\r\n */\r\nexport function setCookie(\r\n ctx: ServerContext,\r\n name: string,\r\n value: string,\r\n options: CookieOptions = {}\r\n): void {\r\n const parts = [`${encodeURIComponent(name)}=${encodeURIComponent(value)}`];\r\n\r\n if (options.maxAge !== undefined) {\r\n parts.push(`Max-Age=${options.maxAge}`);\r\n }\r\n if (options.expires) {\r\n parts.push(`Expires=${options.expires.toUTCString()}`);\r\n }\r\n if (options.path) {\r\n parts.push(`Path=${options.path}`);\r\n }\r\n if (options.domain) {\r\n parts.push(`Domain=${options.domain}`);\r\n }\r\n if (options.secure) {\r\n parts.push('Secure');\r\n }\r\n if (options.httpOnly) {\r\n parts.push('HttpOnly');\r\n }\r\n if (options.sameSite) {\r\n parts.push(`SameSite=${options.sameSite}`);\r\n }\r\n\r\n ctx.responseHeaders.append('Set-Cookie', parts.join('; '));\r\n}\r\n\r\n/**\r\n * Deletes a cookie\r\n */\r\nexport function deleteCookie(ctx: ServerContext, name: string, options: Pick<CookieOptions, 'path' | 'domain'> = {}): void {\r\n setCookie(ctx, name, '', {\r\n ...options,\r\n maxAge: 0,\r\n expires: new Date(0),\r\n });\r\n}\r\n\r\n/**\r\n * Cookie options\r\n */\r\nexport interface CookieOptions {\r\n /** Max age in seconds */\r\n maxAge?: number;\r\n /** Expiration date */\r\n expires?: Date;\r\n /** Cookie path */\r\n path?: string;\r\n /** Cookie domain */\r\n domain?: string;\r\n /** HTTPS only */\r\n secure?: boolean;\r\n /** Not accessible via JavaScript */\r\n httpOnly?: boolean;\r\n /** SameSite attribute */\r\n sameSite?: 'Strict' | 'Lax' | 'None';\r\n}\r\n\r\n/**\r\n * Sets cache control headers\r\n */\r\nexport function setCacheControl(ctx: ServerContext, options: CacheControlOptions): void {\r\n const parts: string[] = [];\r\n\r\n if (options.public) parts.push('public');\r\n if (options.private) parts.push('private');\r\n if (options.noCache) parts.push('no-cache');\r\n if (options.noStore) parts.push('no-store');\r\n if (options.maxAge !== undefined) parts.push(`max-age=${options.maxAge}`);\r\n if (options.sMaxAge !== undefined) parts.push(`s-maxage=${options.sMaxAge}`);\r\n if (options.staleWhileRevalidate !== undefined) {\r\n parts.push(`stale-while-revalidate=${options.staleWhileRevalidate}`);\r\n }\r\n if (options.staleIfError !== undefined) {\r\n parts.push(`stale-if-error=${options.staleIfError}`);\r\n }\r\n if (options.mustRevalidate) parts.push('must-revalidate');\r\n if (options.immutable) parts.push('immutable');\r\n\r\n ctx.responseHeaders.set('Cache-Control', parts.join(', '));\r\n}\r\n\r\n/**\r\n * Cache control options\r\n */\r\nexport interface CacheControlOptions {\r\n public?: boolean;\r\n private?: boolean;\r\n noCache?: boolean;\r\n noStore?: boolean;\r\n maxAge?: number;\r\n sMaxAge?: number;\r\n staleWhileRevalidate?: number;\r\n staleIfError?: number;\r\n mustRevalidate?: boolean;\r\n immutable?: boolean;\r\n}\r\n\r\n// ============================================================================\r\n// Error Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Not found error - triggers 404 handling\r\n */\r\nexport function notFound(message = 'Not Found'): never {\r\n const error = new Error(message) as Error & { __flight_not_found: true };\r\n error.__flight_not_found = true;\r\n throw error;\r\n}\r\n\r\n/**\r\n * Check if error is a not found error\r\n */\r\nexport function isNotFoundError(error: unknown): boolean {\r\n return error instanceof Error && '__flight_not_found' in error;\r\n}\r\n\r\n/**\r\n * Redirect error - triggers redirect handling\r\n */\r\nexport function redirect(url: string, status: 301 | 302 | 303 | 307 | 308 = 307): never {\r\n const error = new Error(`Redirect: ${url}`) as Error & {\r\n __flight_redirect: { url: string; status: number }\r\n };\r\n error.__flight_redirect = { url, status };\r\n throw error;\r\n}\r\n\r\n/**\r\n * Check if error is a redirect error\r\n */\r\nexport function isRedirectError(error: unknown): error is Error & {\r\n __flight_redirect: { url: string; status: number }\r\n} {\r\n return error instanceof Error && '__flight_redirect' in error;\r\n}\r\n\r\n/**\r\n * Get redirect info from error\r\n */\r\nexport function getRedirectInfo(error: Error & { __flight_redirect: { url: string; status: number } }): { url: string; status: number } {\r\n return error.__flight_redirect;\r\n}\r\n"]}
@@ -1,4 +1,4 @@
1
- import { createStreamingSSR } from './chunk-CNY3ZUVG.js';
1
+ import { createStreamingSSR } from './chunk-RSVA2EYO.js';
2
2
 
3
3
  // src/streaming/observability.ts
4
4
  function generateStreamId() {
@@ -278,5 +278,5 @@ function createHttpObserver(endpoint, options) {
278
278
  }
279
279
 
280
280
  export { MetricsAggregator, createHttpObserver, createInstrumentedStream, createLoggerObserver };
281
- //# sourceMappingURL=chunk-YNTMYL36.js.map
282
- //# sourceMappingURL=chunk-YNTMYL36.js.map
281
+ //# sourceMappingURL=chunk-6BDCTUQY.js.map
282
+ //# sourceMappingURL=chunk-6BDCTUQY.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/streaming/observability.ts"],"names":[],"mappings":"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","file":"chunk-6BDCTUQY.js","sourcesContent":["/**\r\n * @flight-framework/core - Streaming Observability\r\n * \r\n * Zero-telemetry metrics and instrumentation for streaming SSR.\r\n * All data stays on YOUR infrastructure - never sent anywhere.\r\n * \r\n * Best Practices 2026:\r\n * - Comprehensive timing metrics for each boundary\r\n * - Hook-based observability for custom integrations\r\n * - Performance insights without vendor lock-in\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createInstrumentedStream } from '@flight-framework/core/streaming';\r\n * \r\n * const { stream, metrics } = await createInstrumentedStream({\r\n * shell: '<html>...',\r\n * boundaries: [...],\r\n * onMetrics: (m) => myAnalytics.track(m), // YOUR system\r\n * });\r\n * ```\r\n */\r\n\r\nimport type { StreamingRenderOptions, SuspenseBoundaryConfig } from './index.js';\r\nimport { createStreamingSSR } from './index.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Timing information for a single boundary\r\n */\r\nexport interface BoundaryTiming {\r\n /** Boundary identifier */\r\n id: string;\r\n /** When the boundary started resolving (ms since stream start) */\r\n startTime: number;\r\n /** When the boundary finished resolving */\r\n endTime: number;\r\n /** Total duration in milliseconds */\r\n duration: number;\r\n /** Whether it resolved successfully */\r\n success: boolean;\r\n /** Size of content in bytes (if successful) */\r\n contentSize?: number;\r\n /** Error message if failed */\r\n error?: string;\r\n}\r\n\r\n/**\r\n * Overall streaming metrics\r\n */\r\nexport interface StreamingMetrics {\r\n /** Unique ID for this stream session */\r\n streamId: string;\r\n /** When streaming started */\r\n startTime: number;\r\n /** Time to shell ready (TTFB improvement) */\r\n shellTime: number;\r\n /** Time until all boundaries resolved */\r\n totalStreamTime: number;\r\n /** Individual boundary timings */\r\n boundaries: BoundaryTiming[];\r\n /** Number of boundaries that resolved successfully */\r\n successCount: number;\r\n /** Number of boundaries that failed */\r\n errorCount: number;\r\n /** Total bytes streamed */\r\n totalBytes: number;\r\n /** Strategy used (if priority streaming) */\r\n strategy?: string;\r\n /** Custom metadata you can add */\r\n meta?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Observability hooks for streaming events\r\n */\r\nexport interface StreamingObserver {\r\n /** Called when streaming starts */\r\n onStreamStart?: (streamId: string) => void;\r\n /** Called when shell is sent */\r\n onShellReady?: (timing: { streamId: string; duration: number }) => void;\r\n /** Called when a boundary starts resolving */\r\n onBoundaryStart?: (info: { streamId: string; boundaryId: string; startTime: number }) => void;\r\n /** Called when a boundary finishes */\r\n onBoundaryEnd?: (timing: BoundaryTiming & { streamId: string }) => void;\r\n /** Called when streaming completes */\r\n onStreamEnd?: (metrics: StreamingMetrics) => void;\r\n /** Called on any error */\r\n onError?: (error: { streamId: string; boundaryId?: string; error: Error }) => void;\r\n}\r\n\r\n/**\r\n * Configuration for instrumented streaming\r\n */\r\nexport interface InstrumentedStreamConfig {\r\n /** Initial HTML shell */\r\n shell: string;\r\n /** Closing HTML */\r\n shellEnd: string;\r\n /** Suspense boundaries */\r\n suspenseBoundaries: SuspenseBoundaryConfig[];\r\n /** Streaming options */\r\n options?: StreamingRenderOptions;\r\n /** Observer hooks */\r\n observer?: StreamingObserver;\r\n /** Callback when all metrics are ready */\r\n onMetrics?: (metrics: StreamingMetrics) => void;\r\n /** Custom metadata to include in metrics */\r\n meta?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Result of instrumented streaming\r\n */\r\nexport interface InstrumentedStreamResult {\r\n /** The readable stream */\r\n stream: ReadableStream<Uint8Array>;\r\n /** Abort the stream */\r\n abort: () => void;\r\n /** Shell ready promise */\r\n shellReady: Promise<void>;\r\n /** All content ready promise */\r\n allReady: Promise<void>;\r\n /** Final metrics (resolves when stream completes) */\r\n metrics: Promise<StreamingMetrics>;\r\n /** Stream ID for correlation */\r\n streamId: string;\r\n}\r\n\r\n// ============================================================================\r\n// Implementation\r\n// ============================================================================\r\n\r\n/**\r\n * Generate a unique stream ID\r\n */\r\nfunction generateStreamId(): string {\r\n return `stream_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;\r\n}\r\n\r\n/**\r\n * Create an instrumented streaming SSR response with full observability\r\n */\r\nexport async function createInstrumentedStream(\r\n config: InstrumentedStreamConfig\r\n): Promise<InstrumentedStreamResult> {\r\n const {\r\n shell,\r\n shellEnd,\r\n suspenseBoundaries,\r\n options = {},\r\n observer,\r\n onMetrics,\r\n meta,\r\n } = config;\r\n\r\n const streamId = generateStreamId();\r\n const startTime = Date.now();\r\n const boundaryTimings: BoundaryTiming[] = [];\r\n const boundaryStarts = new Map<string, number>();\r\n let shellTime = 0;\r\n let totalBytes = 0;\r\n\r\n // Metrics promise\r\n let resolveMetrics: (m: StreamingMetrics) => void;\r\n const metricsPromise = new Promise<StreamingMetrics>((r) => { resolveMetrics = r; });\r\n\r\n // Notify stream start\r\n observer?.onStreamStart?.(streamId);\r\n\r\n // Wrap boundaries with instrumentation\r\n const instrumentedBoundaries: SuspenseBoundaryConfig[] = suspenseBoundaries.map(boundary => {\r\n const boundaryStart = Date.now();\r\n boundaryStarts.set(boundary.id, boundaryStart);\r\n\r\n observer?.onBoundaryStart?.({\r\n streamId,\r\n boundaryId: boundary.id,\r\n startTime: boundaryStart - startTime,\r\n });\r\n\r\n return {\r\n ...boundary,\r\n contentPromise: boundary.contentPromise.then(\r\n (content) => {\r\n const endTime = Date.now();\r\n const timing: BoundaryTiming = {\r\n id: boundary.id,\r\n startTime: boundaryStarts.get(boundary.id)! - startTime,\r\n endTime: endTime - startTime,\r\n duration: endTime - boundaryStarts.get(boundary.id)!,\r\n success: true,\r\n contentSize: new TextEncoder().encode(content).length,\r\n };\r\n boundaryTimings.push(timing);\r\n observer?.onBoundaryEnd?.({ ...timing, streamId });\r\n return content;\r\n },\r\n (error) => {\r\n const endTime = Date.now();\r\n const timing: BoundaryTiming = {\r\n id: boundary.id,\r\n startTime: boundaryStarts.get(boundary.id)! - startTime,\r\n endTime: endTime - startTime,\r\n duration: endTime - boundaryStarts.get(boundary.id)!,\r\n success: false,\r\n error: error instanceof Error ? error.message : String(error),\r\n };\r\n boundaryTimings.push(timing);\r\n observer?.onBoundaryEnd?.({ ...timing, streamId });\r\n observer?.onError?.({ streamId, boundaryId: boundary.id, error: error as Error });\r\n throw error;\r\n }\r\n ),\r\n };\r\n });\r\n\r\n // Create the underlying stream with instrumented callbacks\r\n const result = await createStreamingSSR({\r\n shell,\r\n shellEnd,\r\n suspenseBoundaries: instrumentedBoundaries,\r\n options: {\r\n ...options,\r\n onShellReady: () => {\r\n shellTime = Date.now() - startTime;\r\n observer?.onShellReady?.({ streamId, duration: shellTime });\r\n options.onShellReady?.();\r\n },\r\n onAllReady: () => {\r\n const totalStreamTime = Date.now() - startTime;\r\n\r\n const metrics: StreamingMetrics = {\r\n streamId,\r\n startTime,\r\n shellTime,\r\n totalStreamTime,\r\n boundaries: boundaryTimings,\r\n successCount: boundaryTimings.filter(b => b.success).length,\r\n errorCount: boundaryTimings.filter(b => !b.success).length,\r\n totalBytes,\r\n meta,\r\n };\r\n\r\n observer?.onStreamEnd?.(metrics);\r\n onMetrics?.(metrics);\r\n resolveMetrics!(metrics);\r\n options.onAllReady?.();\r\n },\r\n onError: (error) => {\r\n observer?.onError?.({ streamId, error });\r\n options.onError?.(error);\r\n },\r\n },\r\n });\r\n\r\n // Wrap stream to count bytes\r\n const countingStream = result.stream.pipeThrough(\r\n new TransformStream<Uint8Array, Uint8Array>({\r\n transform(chunk, controller) {\r\n totalBytes += chunk.length;\r\n controller.enqueue(chunk);\r\n },\r\n })\r\n );\r\n\r\n return {\r\n stream: countingStream,\r\n abort: result.abort,\r\n shellReady: result.shellReady,\r\n allReady: result.allReady,\r\n metrics: metricsPromise,\r\n streamId,\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// Utility: Metrics Aggregator\r\n// ============================================================================\r\n\r\n/**\r\n * Aggregate metrics from multiple streams for analysis\r\n */\r\nexport class MetricsAggregator {\r\n private metrics: StreamingMetrics[] = [];\r\n private maxSamples: number;\r\n\r\n constructor(maxSamples = 1000) {\r\n this.maxSamples = maxSamples;\r\n }\r\n\r\n /**\r\n * Add metrics from a stream\r\n */\r\n add(metrics: StreamingMetrics): void {\r\n this.metrics.push(metrics);\r\n if (this.metrics.length > this.maxSamples) {\r\n this.metrics.shift();\r\n }\r\n }\r\n\r\n /**\r\n * Get average shell time\r\n */\r\n getAverageShellTime(): number {\r\n if (this.metrics.length === 0) return 0;\r\n return this.metrics.reduce((sum, m) => sum + m.shellTime, 0) / this.metrics.length;\r\n }\r\n\r\n /**\r\n * Get average total stream time\r\n */\r\n getAverageTotalTime(): number {\r\n if (this.metrics.length === 0) return 0;\r\n return this.metrics.reduce((sum, m) => sum + m.totalStreamTime, 0) / this.metrics.length;\r\n }\r\n\r\n /**\r\n * Get slowest boundaries (by average duration)\r\n */\r\n getSlowestBoundaries(limit = 5): { id: string; avgDuration: number; errorRate: number }[] {\r\n const boundaryStats = new Map<string, { totalDuration: number; count: number; errors: number }>();\r\n\r\n for (const m of this.metrics) {\r\n for (const b of m.boundaries) {\r\n const stats = boundaryStats.get(b.id) || { totalDuration: 0, count: 0, errors: 0 };\r\n stats.totalDuration += b.duration;\r\n stats.count++;\r\n if (!b.success) stats.errors++;\r\n boundaryStats.set(b.id, stats);\r\n }\r\n }\r\n\r\n return [...boundaryStats.entries()]\r\n .map(([id, stats]) => ({\r\n id,\r\n avgDuration: stats.totalDuration / stats.count,\r\n errorRate: stats.errors / stats.count,\r\n }))\r\n .sort((a, b) => b.avgDuration - a.avgDuration)\r\n .slice(0, limit);\r\n }\r\n\r\n /**\r\n * Get overall error rate\r\n */\r\n getErrorRate(): number {\r\n const total = this.metrics.reduce((sum, m) => sum + m.boundaries.length, 0);\r\n const errors = this.metrics.reduce((sum, m) => sum + m.errorCount, 0);\r\n return total > 0 ? errors / total : 0;\r\n }\r\n\r\n /**\r\n * Get percentiles for shell time\r\n */\r\n getShellTimePercentiles(): { p50: number; p90: number; p99: number } {\r\n const sorted = [...this.metrics].map(m => m.shellTime).sort((a, b) => a - b);\r\n const len = sorted.length;\r\n if (len === 0) return { p50: 0, p90: 0, p99: 0 };\r\n\r\n return {\r\n p50: sorted[Math.floor(len * 0.5)] ?? 0,\r\n p90: sorted[Math.floor(len * 0.9)] ?? 0,\r\n p99: sorted[Math.floor(len * 0.99)] ?? 0,\r\n };\r\n }\r\n\r\n /**\r\n * Export all metrics for external analysis\r\n */\r\n export(): StreamingMetrics[] {\r\n return [...this.metrics];\r\n }\r\n\r\n /**\r\n * Clear all metrics\r\n */\r\n clear(): void {\r\n this.metrics = [];\r\n }\r\n}\r\n\r\n// ============================================================================\r\n// Utility: Create Observer from Logger\r\n// ============================================================================\r\n\r\n/**\r\n * Create a streaming observer from a simple logger function\r\n */\r\nexport function createLoggerObserver(\r\n log: (message: string, data?: Record<string, unknown>) => void\r\n): StreamingObserver {\r\n return {\r\n onStreamStart: (streamId) => {\r\n log('[Flight] Stream started', { streamId });\r\n },\r\n onShellReady: ({ streamId, duration }) => {\r\n log('[Flight] Shell ready', { streamId, duration: `${duration}ms` });\r\n },\r\n onBoundaryStart: ({ streamId, boundaryId, startTime }) => {\r\n log('[Flight] Boundary started', { streamId, boundaryId, startTime: `${startTime}ms` });\r\n },\r\n onBoundaryEnd: (timing) => {\r\n log('[Flight] Boundary completed', {\r\n streamId: (timing as any).streamId,\r\n boundaryId: timing.id,\r\n duration: `${timing.duration}ms`,\r\n success: timing.success,\r\n size: timing.contentSize ? `${timing.contentSize}b` : undefined,\r\n });\r\n },\r\n onStreamEnd: (metrics) => {\r\n log('[Flight] Stream completed', {\r\n streamId: metrics.streamId,\r\n totalTime: `${metrics.totalStreamTime}ms`,\r\n shellTime: `${metrics.shellTime}ms`,\r\n boundaries: metrics.boundaries.length,\r\n errors: metrics.errorCount,\r\n });\r\n },\r\n onError: ({ streamId, boundaryId, error }) => {\r\n log('[Flight] Stream error', { streamId, boundaryId, error: error.message });\r\n },\r\n };\r\n}\r\n\r\n/**\r\n * Create observer that sends metrics to a custom endpoint (YOUR infrastructure)\r\n */\r\nexport function createHttpObserver(endpoint: string, options?: {\r\n headers?: Record<string, string>;\r\n batchSize?: number;\r\n flushInterval?: number;\r\n}): StreamingObserver {\r\n const { headers = {}, batchSize = 10, flushInterval = 5000 } = options || {};\r\n const buffer: StreamingMetrics[] = [];\r\n let flushTimer: ReturnType<typeof setTimeout> | null = null;\r\n\r\n const flush = async () => {\r\n if (buffer.length === 0) return;\r\n const batch = buffer.splice(0, buffer.length);\r\n\r\n try {\r\n await fetch(endpoint, {\r\n method: 'POST',\r\n headers: {\r\n 'Content-Type': 'application/json',\r\n ...headers,\r\n },\r\n body: JSON.stringify({ metrics: batch, timestamp: Date.now() }),\r\n });\r\n } catch (error) {\r\n console.error('[Flight] Failed to send metrics:', error);\r\n // Re-add to buffer for retry\r\n buffer.unshift(...batch);\r\n }\r\n };\r\n\r\n const scheduleFlush = () => {\r\n if (flushTimer) return;\r\n flushTimer = setTimeout(() => {\r\n flushTimer = null;\r\n flush();\r\n }, flushInterval);\r\n };\r\n\r\n return {\r\n onStreamEnd: (metrics) => {\r\n buffer.push(metrics);\r\n if (buffer.length >= batchSize) {\r\n flush();\r\n } else {\r\n scheduleFlush();\r\n }\r\n },\r\n };\r\n}\r\n"]}