@flight-framework/core 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Flight Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/{chunk-5KF3QQWZ.js → chunk-3AY23FZP.js}

@@ -1,17 +1,4 @@
-// src/rsc/index.ts
-function hasUseClientDirective(source) {
-  const firstLine = source.trim().split("\n")[0] ?? "";
-  return /^['"]use client['"];?/.test(firstLine);
-}
-function hasUseServerDirective(source) {
-  const firstLine = source.trim().split("\n")[0] ?? "";
-  return /^['"]use server['"];?/.test(firstLine);
-}
-function detectComponentType(source) {
-  if (hasUseClientDirective(source)) return "client";
-  if (hasUseServerDirective(source)) return "server";
-  return "hybrid";
-}
+// src/rsc/legacy.ts
 async function executeServerComponent(component, props, context) {
   try {
     const result = await component(props, context);
@@ -39,7 +26,7 @@ function createRenderContext(request, params = {}) {
 }
 var fetchCache = /* @__PURE__ */ new Map();
 async function serverFetch(url, options = {}) {
-  const { revalidate = 60, tags = [], ...fetchOptions } = options;
+  const { revalidate = 60, tags: _tags = [], ...fetchOptions } = options;
   const cacheKey = `${url}:${JSON.stringify(fetchOptions)}`;
   const cached = fetchCache.get(cacheKey);
   if (cached) {
@@ -129,7 +116,6 @@ function createClientBoundary(componentId, props, fallback) {
     const props = JSON.parse('${serializedProps.replace(/'/g, "\\'")}');
     const container = document.querySelector('[data-flight-component="${componentId}"]');
     if (container && component.default) {
-        // Hydrate with the framework's hydration method
         if (typeof component.hydrate === 'function') {
             component.hydrate(container, props);
         }
@@ -183,6 +169,6 @@ function isRedirectError(error) {
   return null;
 }
 
-export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, detectComponentType, executeServerComponent, hasUseClientDirective, hasUseServerDirective, isNotFoundError, isRedirectError, notFound, redirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withErrorBoundary };
-//# sourceMappingURL=chunk-5KF3QQWZ.js.map
-//# sourceMappingURL=chunk-5KF3QQWZ.js.map
+export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError, isRedirectError, notFound, redirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withErrorBoundary };
+//# sourceMappingURL=chunk-3AY23FZP.js.map
+//# sourceMappingURL=chunk-3AY23FZP.js.map

package/dist/chunk-3AY23FZP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rsc/legacy.ts"],"names":[],"mappings":"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","file":"chunk-3AY23FZP.js","sourcesContent":["/**\r\n * @flight-framework/core - Legacy RSC Support\r\n * \r\n * Backward compatibility module for the original RSC implementation.\r\n * Use the new API from './index.js' for new features.\r\n * \r\n * @deprecated Use the new RSC API instead\r\n * @module @flight-framework/core/rsc/legacy\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Component rendering context\r\n * @deprecated Use ServerContext from './context.js' instead\r\n */\r\nexport interface RenderContext {\r\n    /** Current request */\r\n    request: Request;\r\n    /** Route params */\r\n    params: Record<string, string>;\r\n    /** Search params */\r\n    searchParams: URLSearchParams;\r\n    /** Request headers */\r\n    headers: Headers;\r\n    /** Cookies */\r\n    cookies: Map<string, string>;\r\n}\r\n\r\n/**\r\n * Server component definition\r\n * @deprecated Use ServerComponentFn from './index.js' instead\r\n */\r\nexport interface ServerComponent<P = unknown> {\r\n    (props: P, context: RenderContext): Promise<string> | string;\r\n    /** Mark as server component */\r\n    __flight_server?: true;\r\n    /** Dependencies for hydration */\r\n    __flight_deps?: string[];\r\n}\r\n\r\n/**\r\n * Client component definition\r\n * @deprecated Use ClientReference from './boundaries.js' instead\r\n */\r\nexport interface ClientComponent<P = unknown> {\r\n    (props: P): unknown;\r\n    /** Mark as client component */\r\n    __flight_client?: true;\r\n    /** Client bundle path */\r\n    __flight_bundle?: string;\r\n}\r\n\r\n/**\r\n * Component type detection\r\n */\r\nexport type ComponentType = 'server' | 'client' | 'hybrid';\r\n\r\n// ============================================================================\r\n// Server Component Execution\r\n// ============================================================================\r\n\r\n/**\r\n * Execute an async server component\r\n * @deprecated Use the new rendering pipeline instead\r\n */\r\nexport async function executeServerComponent<P>(\r\n    component: ServerComponent<P>,\r\n    props: P,\r\n    context: RenderContext\r\n): Promise<string> {\r\n    try {\r\n        const result = await component(props, context);\r\n        return result;\r\n    } catch (error) {\r\n        console.error('[Flight] Server component error:', error);\r\n        throw error;\r\n    }\r\n}\r\n\r\n/**\r\n * Create a render context from a Request\r\n * @deprecated Use createServerContext from './context.js' instead\r\n */\r\nexport function createRenderContext(request: Request, params: Record<string, string> = {}): RenderContext {\r\n    const url = new URL(request.url);\r\n\r\n    // Parse cookies\r\n    const cookies = new Map<string, string>();\r\n    const cookieHeader = request.headers.get('cookie') || '';\r\n    cookieHeader.split(';').forEach(cookie => {\r\n        const [key, value] = cookie.trim().split('=');\r\n        if (key && value) cookies.set(key, value);\r\n    });\r\n\r\n    return {\r\n        request,\r\n        params,\r\n        searchParams: url.searchParams,\r\n        headers: request.headers,\r\n        cookies,\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Data Fetching Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Cache for server-side fetch requests\r\n */\r\nconst fetchCache = new Map<string, { data: unknown; timestamp: number }>();\r\n\r\n/**\r\n * Server-side fetch with automatic caching\r\n */\r\nexport async function serverFetch<T>(\r\n    url: string,\r\n    options: RequestInit & {\r\n        revalidate?: number | false;\r\n        tags?: string[];\r\n    } = {}\r\n): Promise<T> {\r\n    const { revalidate = 60, tags: _tags = [], ...fetchOptions } = options;\r\n    const cacheKey = `${url}:${JSON.stringify(fetchOptions)}`;\r\n\r\n    // Check cache\r\n    const cached = fetchCache.get(cacheKey);\r\n    if (cached) {\r\n        const age = Date.now() - cached.timestamp;\r\n        if (revalidate === false || age < (revalidate * 1000)) {\r\n            return cached.data as T;\r\n        }\r\n    }\r\n\r\n    // Fetch fresh data\r\n    const response = await fetch(url, fetchOptions);\r\n\r\n    if (!response.ok) {\r\n        throw new Error(`Fetch failed: ${response.status} ${response.statusText}`);\r\n    }\r\n\r\n    const data = await response.json();\r\n\r\n    // Cache the result\r\n    if (revalidate !== false) {\r\n        fetchCache.set(cacheKey, {\r\n            data,\r\n            timestamp: Date.now(),\r\n        });\r\n    }\r\n\r\n    return data as T;\r\n}\r\n\r\n/**\r\n * Invalidate cache by tag\r\n */\r\nexport function revalidateTag(tag: string): void {\r\n    console.log(`[Flight] Revalidating tag: ${tag}`);\r\n}\r\n\r\n/**\r\n * Invalidate cache by path\r\n */\r\nexport function revalidatePath(path: string): void {\r\n    console.log(`[Flight] Revalidating path: ${path}`);\r\n}\r\n\r\n// ============================================================================\r\n// Component Serialization\r\n// ============================================================================\r\n\r\n/**\r\n * Serialize props for transmission to client\r\n * @deprecated Use serialize from './payload.js' instead\r\n */\r\nexport function serializeProps(props: unknown): string {\r\n    function preProcess(value: unknown): unknown {\r\n        if (value instanceof Date) {\r\n            return { __type: 'Date', value: value.toISOString() };\r\n        }\r\n        if (value instanceof Map) {\r\n            return { __type: 'Map', value: Array.from(value.entries()).map(([k, v]) => [preProcess(k), preProcess(v)]) };\r\n        }\r\n        if (value instanceof Set) {\r\n            return { __type: 'Set', value: Array.from(value).map(preProcess) };\r\n        }\r\n        if (typeof value === 'bigint') {\r\n            return { __type: 'BigInt', value: value.toString() };\r\n        }\r\n        if (typeof value === 'function') {\r\n            return undefined;\r\n        }\r\n        if (Array.isArray(value)) {\r\n            return value.map(preProcess);\r\n        }\r\n        if (value && typeof value === 'object') {\r\n            const result: Record<string, unknown> = {};\r\n            for (const [k, v] of Object.entries(value)) {\r\n                result[k] = preProcess(v);\r\n            }\r\n            return result;\r\n        }\r\n        return value;\r\n    }\r\n\r\n    return JSON.stringify(preProcess(props));\r\n}\r\n\r\n/**\r\n * Deserialize props on client\r\n * @deprecated Use deserialize from './payload.js' instead\r\n */\r\nexport function deserializeProps<T>(serialized: string): T {\r\n    return JSON.parse(serialized, (_key, value) => {\r\n        if (value && typeof value === 'object' && '__type' in value) {\r\n            switch (value.__type) {\r\n                case 'Date':\r\n                    return new Date(value.value);\r\n                case 'Map':\r\n                    return new Map(value.value);\r\n                case 'Set':\r\n                    return new Set(value.value);\r\n                case 'BigInt':\r\n                    return BigInt(value.value);\r\n            }\r\n        }\r\n        return value;\r\n    });\r\n}\r\n\r\n// ============================================================================\r\n// Client Component Boundary\r\n// ============================================================================\r\n\r\n/**\r\n * Create a client boundary placeholder\r\n * @deprecated Use clientRef from './payload.js' instead\r\n */\r\nexport function createClientBoundary(\r\n    componentId: string,\r\n    props: unknown,\r\n    fallback?: string\r\n): string {\r\n    const serializedProps = serializeProps(props);\r\n\r\n    return `\r\n<!--flight-client:${componentId}-->\r\n<div data-flight-component=\"${componentId}\" data-flight-props='${serializedProps.replace(/'/g, \"&#39;\")}'>\r\n    ${fallback || '<div>Loading...</div>'}\r\n</div>\r\n<!--/flight-client-->\r\n<script type=\"module\">\r\n(async function() {\r\n    const component = await import('/_flight/components/${componentId}.js');\r\n    const props = JSON.parse('${serializedProps.replace(/'/g, \"\\\\'\")}');\r\n    const container = document.querySelector('[data-flight-component=\"${componentId}\"]');\r\n    if (container && component.default) {\r\n        if (typeof component.hydrate === 'function') {\r\n            component.hydrate(container, props);\r\n        }\r\n    }\r\n})();\r\n</script>`;\r\n}\r\n\r\n// ============================================================================\r\n// Async Component Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Helper to create an async server component\r\n * @deprecated Use async Server Components directly\r\n */\r\nexport function createAsyncComponent<P, T>(\r\n    fetcher: (props: P, context: RenderContext) => Promise<T>,\r\n    renderer: (data: T, props: P) => string\r\n): ServerComponent<P> {\r\n    const component: ServerComponent<P> = async (props, context) => {\r\n        const data = await fetcher(props, context);\r\n        return renderer(data, props);\r\n    };\r\n    component.__flight_server = true;\r\n    return component;\r\n}\r\n\r\n/**\r\n * Compose multiple server components\r\n * @deprecated Use Promise.all with async components\r\n */\r\nexport function composeComponents(\r\n    ...components: Array<() => Promise<string> | string>\r\n): () => Promise<string> {\r\n    return async () => {\r\n        const results = await Promise.all(\r\n            components.map(async (comp) => await comp())\r\n        );\r\n        return results.join('');\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Error Boundary for Server Components\r\n// ============================================================================\r\n\r\n/**\r\n * Wrap a server component with error handling\r\n * @deprecated Use try/catch in async components\r\n */\r\nexport function withErrorBoundary<P>(\r\n    component: ServerComponent<P>,\r\n    errorFallback: (error: Error) => string\r\n): ServerComponent<P> {\r\n    return async (props: P, context: RenderContext) => {\r\n        try {\r\n            return await component(props, context);\r\n        } catch (error) {\r\n            console.error('[Flight] Server component error:', error);\r\n            return errorFallback(error as Error);\r\n        }\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Not Found / Redirect Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Throw a not found error\r\n * @deprecated Use notFound from './context.js' instead\r\n */\r\nexport function notFound(): never {\r\n    const error = new Error('Not Found');\r\n    (error as Error & { __flight_not_found: boolean }).__flight_not_found = true;\r\n    throw error;\r\n}\r\n\r\n/**\r\n * Check if error is not found\r\n * @deprecated Use isNotFoundError from './context.js' instead\r\n */\r\nexport function isNotFoundError(error: unknown): boolean {\r\n    return error instanceof Error && (error as Error & { __flight_not_found?: boolean }).__flight_not_found === true;\r\n}\r\n\r\n/**\r\n * Server-side redirect\r\n * @deprecated Use redirect from './context.js' instead\r\n */\r\nexport function redirect(url: string, type: 'replace' | 'push' = 'replace'): never {\r\n    const error = new Error(`Redirect: ${url}`);\r\n    (error as Error & { __flight_redirect: { url: string; type: string } }).__flight_redirect = { url, type };\r\n    throw error;\r\n}\r\n\r\n/**\r\n * Check if error is redirect\r\n * @deprecated Use isRedirectError from './context.js' instead\r\n */\r\nexport function isRedirectError(error: unknown): { url: string; type: string } | null {\r\n    if (error instanceof Error && (error as Error & { __flight_redirect?: unknown }).__flight_redirect) {\r\n        return (error as Error & { __flight_redirect: { url: string; type: string } }).__flight_redirect;\r\n    }\r\n    return null;\r\n}\r\n"]}

package/dist/chunk-4F77J5TY.js

@@ -0,0 +1,324 @@
+import { createServerChunk, createErrorChunk, toFlightElement, serialize, generateChunkId, createClientChunk } from './chunk-K2CQZPCG.js';
+import { isClientReference } from './chunk-CLZSB5QD.js';
+
+// src/rsc/renderer.ts
+var FlightRenderer = class {
+  constructor(adapter, options = {}) {
+    this.adapter = adapter;
+    this.options = options;
+  }
+  chunks = [];
+  clientRefs = [];
+  pendingPromises = /* @__PURE__ */ new Map();
+  depth = 0;
+  /**
+   * Render a component tree to Flight chunks
+   */
+  async render(element, ctx) {
+    const startTime = Date.now();
+    this.chunks = [];
+    this.clientRefs = [];
+    this.pendingPromises.clear();
+    this.depth = 0;
+    try {
+      const rootTree = await this.renderElement(element, ctx);
+      const root = createServerChunk("root", rootTree);
+      this.chunks.unshift(root);
+      await this.resolvePendingChunks(ctx);
+      const endTime = Date.now();
+      return {
+        chunks: this.chunks,
+        root,
+        clientRefs: this.clientRefs,
+        timing: {
+          startTime,
+          endTime,
+          duration: endTime - startTime
+        }
+      };
+    } catch (error) {
+      const errChunk = createErrorChunk("root", error, this.options.dev);
+      this.chunks.push(errChunk);
+      throw error;
+    }
+  }
+  /**
+   * Render as async generator (for streaming)
+   */
+  async *renderStreaming(element, ctx) {
+    this.chunks = [];
+    this.clientRefs = [];
+    this.pendingPromises.clear();
+    this.depth = 0;
+    try {
+      const rootTree = await this.renderElement(element, ctx);
+      const root = createServerChunk("root", rootTree);
+      yield root;
+      while (this.pendingPromises.size > 0) {
+        const entries = [...this.pendingPromises.entries()];
+        const promises = entries.map(async ([id, promise]) => {
+          const tree = await promise;
+          this.pendingPromises.delete(id);
+          return createServerChunk(id, tree);
+        });
+        const chunk = await Promise.race(promises);
+        yield chunk;
+      }
+      for (const clientRef of this.clientRefs) {
+        yield clientRef;
+      }
+    } catch (error) {
+      yield createErrorChunk("root", error, this.options.dev);
+    }
+  }
+  /**
+   * Render an element to FlightElement
+   */
+  async renderElement(element, ctx) {
+    this.depth++;
+    if (this.depth > (this.options.maxDepth ?? 100)) {
+      throw new Error("Maximum render depth exceeded. Check for infinite component loops.");
+    }
+    try {
+      if (element === null || element === void 0 || typeof element === "boolean") {
+        return { $$type: "null" };
+      }
+      if (typeof element === "string") {
+        return { $$type: "text", value: element };
+      }
+      if (typeof element === "number") {
+        return { $$type: "text", value: String(element) };
+      }
+      if (Array.isArray(element)) {
+        const children = await Promise.all(
+          element.map((child) => this.renderElement(child, ctx))
+        );
+        return { $$type: "fragment", children };
+      }
+      if (isClientReference(element)) {
+        return this.renderClientReference(element, ctx);
+      }
+      if (this.adapter.isElement(element)) {
+        return this.renderFrameworkElement(element, ctx);
+      }
+      return toFlightElement(element);
+    } finally {
+      this.depth--;
+    }
+  }
+  /**
+   * Render a framework-specific element
+   */
+  async renderFrameworkElement(element, ctx) {
+    const typeInfo = this.adapter.getElementType(element);
+    const props = this.adapter.getProps(element);
+    const key = this.adapter.getKey(element);
+    switch (typeInfo.kind) {
+      case "host":
+        return this.renderHostElement(typeInfo.tag, props, key, ctx);
+      case "component":
+        return this.renderComponent(typeInfo.fn, typeInfo.name, props, ctx);
+      case "fragment": {
+        const children = this.adapter.getChildren(element);
+        const renderedChildren = await Promise.all(
+          children.map((child) => this.renderElement(child, ctx))
+        );
+        return { $$type: "fragment", children: renderedChildren };
+      }
+      case "suspense": {
+        return this.renderSuspense(element, typeInfo.fallback, ctx);
+      }
+      case "text":
+        return { $$type: "text", value: typeInfo.value };
+      case "null":
+        return { $$type: "null" };
+      default:
+        return { $$type: "null" };
+    }
+  }
+  /**
+   * Render a host element (div, span, etc.)
+   */
+  async renderHostElement(tag, props, key, ctx) {
+    const { children: childrenProp, ...restProps } = props;
+    const serializedProps = {};
+    for (const [propKey, value] of Object.entries(restProps)) {
+      if (typeof value !== "function") {
+        serializedProps[propKey] = serialize(value);
+      }
+    }
+    const rawChildren = childrenProp ? Array.isArray(childrenProp) ? childrenProp : [childrenProp] : [];
+    const children = await Promise.all(
+      rawChildren.map((child) => this.renderElement(child, ctx))
+    );
+    return {
+      $$type: "host",
+      tag,
+      key,
+      props: serializedProps,
+      children
+    };
+  }
+  /**
+   * Render a component (server or client)
+   */
+  async renderComponent(component, name, props, ctx) {
+    if (this.adapter.isClientBoundary(component)) {
+      return this.renderClientBoundary(component, name, props, ctx);
+    }
+    try {
+      const result = await component(props, ctx);
+      return this.renderElement(result, ctx);
+    } catch (error) {
+      if (error instanceof Promise) {
+        return this.renderAsyncBoundary(error, name, props, ctx);
+      }
+      this.options.onError?.(error, name);
+      throw error;
+    }
+  }
+  /**
+   * Render a client boundary
+   */
+  async renderClientBoundary(component, name, props, ctx) {
+    const chunkId = generateChunkId("c");
+    const moduleId = component.__flight_module ?? name;
+    const exportName = component.__flight_export ?? "default";
+    let fallback;
+    if (this.options.includeSSRFallbacks && this.adapter.renderToString) {
+      try {
+        fallback = await this.adapter.renderToString(props);
+      } catch {
+      }
+    }
+    const clientChunk = createClientChunk(chunkId, moduleId, exportName, props, fallback);
+    this.clientRefs.push(clientChunk);
+    this.chunks.push(clientChunk);
+    return {
+      $$type: "client",
+      ref: chunkId,
+      ssr: fallback
+    };
+  }
+  /**
+   * Render a Suspense boundary
+   */
+  async renderSuspense(element, fallbackElement, ctx) {
+    const boundaryId = generateChunkId("s");
+    const children = this.adapter.getChildren(element);
+    const fallback = fallbackElement ? await this.renderElement(fallbackElement, ctx) : { $$type: "null" };
+    const renderedChildren = [];
+    for (const child of children) {
+      try {
+        const rendered = await this.renderElement(child, ctx);
+        renderedChildren.push(rendered);
+      } catch (error) {
+        if (error instanceof Promise) {
+          this.pendingPromises.set(boundaryId, error.then(async () => {
+            const children2 = this.adapter.getChildren(element);
+            const rendered = await Promise.all(
+              children2.map((c) => this.renderElement(c, ctx))
+            );
+            return { $$type: "fragment", children: rendered };
+          }));
+          return {
+            $$type: "suspense",
+            id: boundaryId,
+            fallback,
+            children: [{ $$type: "lazy", id: boundaryId, fallback }]
+          };
+        }
+        throw error;
+      }
+    }
+    return {
+      $$type: "suspense",
+      id: boundaryId,
+      fallback,
+      children: renderedChildren
+    };
+  }
+  /**
+   * Render an async boundary (promise thrown from component)
+   */
+  renderAsyncBoundary(promise, name, props, ctx) {
+    const boundaryId = generateChunkId("a");
+    this.pendingPromises.set(
+      boundaryId,
+      promise.then(async () => {
+        const component = props.component;
+        if (component) {
+          const result = await component(props, ctx);
+          return this.renderElement(result, ctx);
+        }
+        return { $$type: "null" };
+      })
+    );
+    return {
+      $$type: "lazy",
+      id: boundaryId,
+      fallback: { $$type: "text", value: `Loading ${name}...` }
+    };
+  }
+  /**
+   * Render a Client Reference directly
+   */
+  async renderClientReference(ref, ctx) {
+    const chunkId = generateChunkId("c");
+    const clientChunk = createClientChunk(
+      chunkId,
+      ref.__flight_module,
+      ref.__flight_export,
+      {}
+      // Props are embedded in the reference
+    );
+    this.clientRefs.push(clientChunk);
+    this.chunks.push(clientChunk);
+    return {
+      $$type: "client",
+      ref: chunkId
+    };
+  }
+  /**
+   * Resolve all pending async chunks
+   */
+  async resolvePendingChunks(ctx) {
+    while (this.pendingPromises.size > 0) {
+      const entries = [...this.pendingPromises.entries()];
+      for (const [id, promise] of entries) {
+        try {
+          const tree = await promise;
+          this.chunks.push(createServerChunk(id, tree));
+        } catch (error) {
+          this.chunks.push(createErrorChunk(id, error, this.options.dev));
+        }
+        this.pendingPromises.delete(id);
+      }
+    }
+  }
+};
+function createRenderer(adapter, options) {
+  return new FlightRenderer(adapter, options);
+}
+async function renderServerComponent(component, props, ctx, adapter, options) {
+  const renderer = createRenderer(adapter, options);
+  const element = {
+    type: component,
+    props,
+    $$typeof: /* @__PURE__ */ Symbol.for("react.element")
+  };
+  return renderer.render(element, ctx);
+}
+async function* renderServerComponentStreaming(component, props, ctx, adapter, options) {
+  const renderer = createRenderer(adapter, options);
+  const element = {
+    type: component,
+    props,
+    $$typeof: /* @__PURE__ */ Symbol.for("react.element")
+  };
+  yield* renderer.renderStreaming(element, ctx);
+}
+
+export { FlightRenderer, createRenderer, renderServerComponent, renderServerComponentStreaming };
+//# sourceMappingURL=chunk-4F77J5TY.js.map
+//# sourceMappingURL=chunk-4F77J5TY.js.map

package/dist/chunk-4F77J5TY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rsc/renderer.ts"],"names":["children"],"mappings":"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","file":"chunk-4F77J5TY.js","sourcesContent":["/**\r\n * @flight-framework/core - Server Component Renderer\r\n * \r\n * Renders Server Components to FlightChunks.\r\n * Framework-agnostic rendering engine that works with adapters.\r\n * \r\n * @module @flight-framework/core/rsc/renderer\r\n */\r\n\r\nimport type {\r\n    FlightChunk,\r\n    FlightElement,\r\n    ServerComponentChunk,\r\n    ClientReferenceChunk,\r\n} from './payload.js';\r\nimport {\r\n    generateChunkId,\r\n    createServerChunk,\r\n    createClientChunk,\r\n    createErrorChunk,\r\n    toFlightElement,\r\n    h,\r\n    text as textElement,\r\n    suspense as suspenseElement,\r\n    serialize,\r\n} from './payload.js';\r\nimport {\r\n    isClientReference,\r\n    isServerReference,\r\n    type ClientReference,\r\n    type ServerReference,\r\n} from './boundaries.js';\r\nimport type { ServerContext } from './context.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * UI Framework adapter for rendering\r\n */\r\nexport interface UIAdapter {\r\n    /** Adapter name */\r\n    name: string;\r\n\r\n    /** Check if value is a framework element */\r\n    isElement(value: unknown): boolean;\r\n\r\n    /** Get element type info */\r\n    getElementType(element: unknown): ElementTypeInfo;\r\n\r\n    /** Get element props */\r\n    getProps(element: unknown): Record<string, unknown>;\r\n\r\n    /** Get element children */\r\n    getChildren(element: unknown): unknown[];\r\n\r\n    /** Get element key */\r\n    getKey(element: unknown): string | number | undefined;\r\n\r\n    /** Check if component is a client boundary */\r\n    isClientBoundary(component: unknown): boolean;\r\n\r\n    /** Render element to HTML string (for SSR fallback) */\r\n    renderToString?(element: unknown): Promise<string>;\r\n}\r\n\r\nexport type ElementTypeInfo =\r\n    | { kind: 'host'; tag: string }\r\n    | { kind: 'component'; fn: ComponentFn; name: string }\r\n    | { kind: 'fragment' }\r\n    | { kind: 'suspense'; fallback?: unknown }\r\n    | { kind: 'provider'; value?: unknown }\r\n    | { kind: 'context' }\r\n    | { kind: 'text'; value: string }\r\n    | { kind: 'null' };\r\n\r\n/**\r\n * Component function type\r\n */\r\nexport type ComponentFn = (\r\n    props: Record<string, unknown>,\r\n    ctx?: ServerContext\r\n) => unknown | Promise<unknown>;\r\n\r\n/**\r\n * Render options\r\n */\r\nexport interface RenderOptions {\r\n    /** Include SSR fallbacks for client components */\r\n    includeSSRFallbacks?: boolean;\r\n\r\n    /** Error handler */\r\n    onError?: (error: Error, componentName?: string) => void;\r\n\r\n    /** Dev mode (include extra debug info) */\r\n    dev?: boolean;\r\n\r\n    /** Max render depth to prevent infinite loops */\r\n    maxDepth?: number;\r\n}\r\n\r\n/**\r\n * Render result with metadata\r\n */\r\nexport interface RenderResult {\r\n    /** All chunks generated */\r\n    chunks: FlightChunk[];\r\n\r\n    /** Root chunk */\r\n    root: ServerComponentChunk;\r\n\r\n    /** Client references found */\r\n    clientRefs: ClientReferenceChunk[];\r\n\r\n    /** Timing info */\r\n    timing: {\r\n        startTime: number;\r\n        endTime: number;\r\n        duration: number;\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Renderer Implementation\r\n// ============================================================================\r\n\r\n/**\r\n * Flight Server Component Renderer\r\n */\r\nexport class FlightRenderer {\r\n    private chunks: FlightChunk[] = [];\r\n    private clientRefs: ClientReferenceChunk[] = [];\r\n    private pendingPromises = new Map<string, Promise<FlightElement>>();\r\n    private depth = 0;\r\n\r\n    constructor(\r\n        private adapter: UIAdapter,\r\n        private options: RenderOptions = {}\r\n    ) { }\r\n\r\n    /**\r\n     * Render a component tree to Flight chunks\r\n     */\r\n    async render(\r\n        element: unknown,\r\n        ctx: ServerContext\r\n    ): Promise<RenderResult> {\r\n        const startTime = Date.now();\r\n\r\n        this.chunks = [];\r\n        this.clientRefs = [];\r\n        this.pendingPromises.clear();\r\n        this.depth = 0;\r\n\r\n        try {\r\n            // Render the root element\r\n            const rootTree = await this.renderElement(element, ctx);\r\n            const root = createServerChunk('root', rootTree);\r\n            this.chunks.unshift(root);\r\n\r\n            // Wait for any pending async boundaries\r\n            await this.resolvePendingChunks(ctx);\r\n\r\n            const endTime = Date.now();\r\n\r\n            return {\r\n                chunks: this.chunks,\r\n                root,\r\n                clientRefs: this.clientRefs,\r\n                timing: {\r\n                    startTime,\r\n                    endTime,\r\n                    duration: endTime - startTime,\r\n                },\r\n            };\r\n        } catch (error) {\r\n            const errChunk = createErrorChunk('root', error as Error, this.options.dev);\r\n            this.chunks.push(errChunk);\r\n\r\n            throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render as async generator (for streaming)\r\n     */\r\n    async *renderStreaming(\r\n        element: unknown,\r\n        ctx: ServerContext\r\n    ): AsyncGenerator<FlightChunk> {\r\n        const startTime = Date.now();\r\n\r\n        this.chunks = [];\r\n        this.clientRefs = [];\r\n        this.pendingPromises.clear();\r\n        this.depth = 0;\r\n\r\n        try {\r\n            // Render root synchronously\r\n            const rootTree = await this.renderElement(element, ctx);\r\n            const root = createServerChunk('root', rootTree);\r\n            yield root;\r\n\r\n            // Yield pending chunks as they resolve\r\n            while (this.pendingPromises.size > 0) {\r\n                const entries = [...this.pendingPromises.entries()];\r\n\r\n                // Race all pending promises\r\n                const promises = entries.map(async ([id, promise]) => {\r\n                    const tree = await promise;\r\n                    this.pendingPromises.delete(id);\r\n                    return createServerChunk(id, tree);\r\n                });\r\n\r\n                // Yield first to complete\r\n                const chunk = await Promise.race(promises);\r\n                yield chunk;\r\n            }\r\n\r\n            // Yield all client refs\r\n            for (const clientRef of this.clientRefs) {\r\n                yield clientRef;\r\n            }\r\n\r\n        } catch (error) {\r\n            yield createErrorChunk('root', error as Error, this.options.dev);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render an element to FlightElement\r\n     */\r\n    private async renderElement(\r\n        element: unknown,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        // Check depth limit\r\n        this.depth++;\r\n        if (this.depth > (this.options.maxDepth ?? 100)) {\r\n            throw new Error('Maximum render depth exceeded. Check for infinite component loops.');\r\n        }\r\n\r\n        try {\r\n            // Handle null/undefined/boolean\r\n            if (element === null || element === undefined || typeof element === 'boolean') {\r\n                return { $$type: 'null' };\r\n            }\r\n\r\n            // Handle primitives\r\n            if (typeof element === 'string') {\r\n                return { $$type: 'text', value: element };\r\n            }\r\n            if (typeof element === 'number') {\r\n                return { $$type: 'text', value: String(element) };\r\n            }\r\n\r\n            // Handle arrays (fragments)\r\n            if (Array.isArray(element)) {\r\n                const children = await Promise.all(\r\n                    element.map(child => this.renderElement(child, ctx))\r\n                );\r\n                return { $$type: 'fragment', children };\r\n            }\r\n\r\n            // Handle Client References\r\n            if (isClientReference(element)) {\r\n                return this.renderClientReference(element, ctx);\r\n            }\r\n\r\n            // Handle framework elements\r\n            if (this.adapter.isElement(element)) {\r\n                return this.renderFrameworkElement(element, ctx);\r\n            }\r\n\r\n            // Unknown - try to convert\r\n            return toFlightElement(element);\r\n\r\n        } finally {\r\n            this.depth--;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render a framework-specific element\r\n     */\r\n    private async renderFrameworkElement(\r\n        element: unknown,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        const typeInfo = this.adapter.getElementType(element);\r\n        const props = this.adapter.getProps(element);\r\n        const key = this.adapter.getKey(element);\r\n\r\n        switch (typeInfo.kind) {\r\n            case 'host':\r\n                return this.renderHostElement(typeInfo.tag, props, key, ctx);\r\n\r\n            case 'component':\r\n                return this.renderComponent(typeInfo.fn, typeInfo.name, props, ctx);\r\n\r\n            case 'fragment': {\r\n                const children = this.adapter.getChildren(element);\r\n                const renderedChildren = await Promise.all(\r\n                    children.map(child => this.renderElement(child, ctx))\r\n                );\r\n                return { $$type: 'fragment', children: renderedChildren };\r\n            }\r\n\r\n            case 'suspense': {\r\n                return this.renderSuspense(element, typeInfo.fallback, ctx);\r\n            }\r\n\r\n            case 'text':\r\n                return { $$type: 'text', value: typeInfo.value };\r\n\r\n            case 'null':\r\n                return { $$type: 'null' };\r\n\r\n            default:\r\n                return { $$type: 'null' };\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render a host element (div, span, etc.)\r\n     */\r\n    private async renderHostElement(\r\n        tag: string,\r\n        props: Record<string, unknown>,\r\n        key: string | number | undefined,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        // Extract children\r\n        const { children: childrenProp, ...restProps } = props;\r\n\r\n        // Serialize props (excluding functions and children)\r\n        const serializedProps: Record<string, unknown> = {};\r\n        for (const [propKey, value] of Object.entries(restProps)) {\r\n            if (typeof value !== 'function') {\r\n                serializedProps[propKey] = serialize(value);\r\n            }\r\n        }\r\n\r\n        // Render children\r\n        const rawChildren = childrenProp ?\r\n            (Array.isArray(childrenProp) ? childrenProp : [childrenProp]) :\r\n            [];\r\n\r\n        const children = await Promise.all(\r\n            rawChildren.map(child => this.renderElement(child, ctx))\r\n        );\r\n\r\n        return {\r\n            $$type: 'host',\r\n            tag,\r\n            key,\r\n            props: serializedProps as Record<string, import('./payload.js').SerializedValue>,\r\n            children,\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Render a component (server or client)\r\n     */\r\n    private async renderComponent(\r\n        component: ComponentFn,\r\n        name: string,\r\n        props: Record<string, unknown>,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        // Check if this is a client component\r\n        if (this.adapter.isClientBoundary(component)) {\r\n            return this.renderClientBoundary(component, name, props, ctx);\r\n        }\r\n\r\n        // Execute server component\r\n        try {\r\n            const result = await component(props, ctx);\r\n            return this.renderElement(result, ctx);\r\n        } catch (error) {\r\n            // Check for Suspense promise\r\n            if (error instanceof Promise) {\r\n                return this.renderAsyncBoundary(error, name, props, ctx);\r\n            }\r\n\r\n            this.options.onError?.(error as Error, name);\r\n            throw error;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Render a client boundary\r\n     */\r\n    private async renderClientBoundary(\r\n        component: ComponentFn,\r\n        name: string,\r\n        props: Record<string, unknown>,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        const chunkId = generateChunkId('c');\r\n\r\n        // Get module info from component\r\n        const moduleId = (component as unknown as { __flight_module?: string }).__flight_module ?? name;\r\n        const exportName = (component as unknown as { __flight_export?: string }).__flight_export ?? 'default';\r\n\r\n        // Generate SSR fallback if enabled\r\n        let fallback: string | undefined;\r\n        if (this.options.includeSSRFallbacks && this.adapter.renderToString) {\r\n            try {\r\n                // Create element with props for SSR\r\n                fallback = await this.adapter.renderToString(props);\r\n            } catch {\r\n                // SSR failed, continue without fallback\r\n            }\r\n        }\r\n\r\n        // Create client reference chunk\r\n        const clientChunk = createClientChunk(chunkId, moduleId, exportName, props, fallback);\r\n        this.clientRefs.push(clientChunk);\r\n        this.chunks.push(clientChunk);\r\n\r\n        return {\r\n            $$type: 'client',\r\n            ref: chunkId,\r\n            ssr: fallback,\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Render a Suspense boundary\r\n     */\r\n    private async renderSuspense(\r\n        element: unknown,\r\n        fallbackElement: unknown,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        const boundaryId = generateChunkId('s');\r\n        const children = this.adapter.getChildren(element);\r\n\r\n        // Render fallback\r\n        const fallback = fallbackElement ?\r\n            await this.renderElement(fallbackElement, ctx) :\r\n            { $$type: 'null' as const };\r\n\r\n        // Render children\r\n        const renderedChildren: FlightElement[] = [];\r\n        for (const child of children) {\r\n            try {\r\n                const rendered = await this.renderElement(child, ctx);\r\n                renderedChildren.push(rendered);\r\n            } catch (error) {\r\n                if (error instanceof Promise) {\r\n                    // This is a suspended promise\r\n                    this.pendingPromises.set(boundaryId, error.then(async () => {\r\n                        const children = this.adapter.getChildren(element);\r\n                        const rendered = await Promise.all(\r\n                            children.map(c => this.renderElement(c, ctx))\r\n                        );\r\n                        return { $$type: 'fragment' as const, children: rendered };\r\n                    }));\r\n\r\n                    // Return suspense with fallback for now\r\n                    return {\r\n                        $$type: 'suspense',\r\n                        id: boundaryId,\r\n                        fallback,\r\n                        children: [{ $$type: 'lazy', id: boundaryId, fallback }],\r\n                    };\r\n                }\r\n                throw error;\r\n            }\r\n        }\r\n\r\n        return {\r\n            $$type: 'suspense',\r\n            id: boundaryId,\r\n            fallback,\r\n            children: renderedChildren,\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Render an async boundary (promise thrown from component)\r\n     */\r\n    private renderAsyncBoundary(\r\n        promise: Promise<unknown>,\r\n        name: string,\r\n        props: Record<string, unknown>,\r\n        ctx: ServerContext\r\n    ): FlightElement {\r\n        const boundaryId = generateChunkId('a');\r\n\r\n        // Track this promise\r\n        this.pendingPromises.set(boundaryId,\r\n            promise.then(async () => {\r\n                // Re-render the component after promise resolves\r\n                const component = (props as unknown as { component: ComponentFn }).component;\r\n                if (component) {\r\n                    const result = await component(props, ctx);\r\n                    return this.renderElement(result, ctx);\r\n                }\r\n                return { $$type: 'null' as const };\r\n            })\r\n        );\r\n\r\n        return {\r\n            $$type: 'lazy',\r\n            id: boundaryId,\r\n            fallback: { $$type: 'text', value: `Loading ${name}...` },\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Render a Client Reference directly\r\n     */\r\n    private async renderClientReference(\r\n        ref: ClientReference,\r\n        ctx: ServerContext\r\n    ): Promise<FlightElement> {\r\n        const chunkId = generateChunkId('c');\r\n\r\n        const clientChunk = createClientChunk(\r\n            chunkId,\r\n            ref.__flight_module,\r\n            ref.__flight_export,\r\n            {} // Props are embedded in the reference\r\n        );\r\n\r\n        this.clientRefs.push(clientChunk);\r\n        this.chunks.push(clientChunk);\r\n\r\n        return {\r\n            $$type: 'client',\r\n            ref: chunkId,\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Resolve all pending async chunks\r\n     */\r\n    private async resolvePendingChunks(ctx: ServerContext): Promise<void> {\r\n        while (this.pendingPromises.size > 0) {\r\n            const entries = [...this.pendingPromises.entries()];\r\n\r\n            for (const [id, promise] of entries) {\r\n                try {\r\n                    const tree = await promise;\r\n                    this.chunks.push(createServerChunk(id, tree));\r\n                } catch (error) {\r\n                    this.chunks.push(createErrorChunk(id, error as Error, this.options.dev));\r\n                }\r\n                this.pendingPromises.delete(id);\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\n// ============================================================================\r\n// Helper Functions\r\n// ============================================================================\r\n\r\n/**\r\n * Create a renderer with adapter\r\n */\r\nexport function createRenderer(\r\n    adapter: UIAdapter,\r\n    options?: RenderOptions\r\n): FlightRenderer {\r\n    return new FlightRenderer(adapter, options);\r\n}\r\n\r\n/**\r\n * Render a server component tree\r\n */\r\nexport async function renderServerComponent<P>(\r\n    component: ComponentFn,\r\n    props: P,\r\n    ctx: ServerContext,\r\n    adapter: UIAdapter,\r\n    options?: RenderOptions\r\n): Promise<RenderResult> {\r\n    const renderer = createRenderer(adapter, options);\r\n\r\n    // Create root element\r\n    const element = {\r\n        type: component,\r\n        props: props as Record<string, unknown>,\r\n        $$typeof: Symbol.for('react.element')\r\n    };\r\n\r\n    return renderer.render(element, ctx);\r\n}\r\n\r\n/**\r\n * Render server component as streaming chunks\r\n */\r\nexport async function* renderServerComponentStreaming<P>(\r\n    component: ComponentFn,\r\n    props: P,\r\n    ctx: ServerContext,\r\n    adapter: UIAdapter,\r\n    options?: RenderOptions\r\n): AsyncGenerator<FlightChunk> {\r\n    const renderer = createRenderer(adapter, options);\r\n\r\n    const element = {\r\n        type: component,\r\n        props: props as Record<string, unknown>,\r\n        $$typeof: Symbol.for('react.element')\r\n    };\r\n\r\n    yield* renderer.renderStreaming(element, ctx);\r\n}\r\n"]}