qlara 0.1.8 → 0.1.9

package/dist/aws.cjs

@@ -562,7 +562,7 @@ async function bundleEdgeHandler(config) {
   });
   return createZip(outfile, "edge-handler.js");
 }
-async function bundleRenderer(routeFile, cacheTtl = 3600) {
+async function bundleRenderer(routeFile, cacheTtl = 3600, framework) {
   (0, import_node_fs2.mkdirSync)(BUNDLE_DIR, { recursive: true });
   const outfile = (0, import_node_path2.join)(BUNDLE_DIR, "renderer.js");
   const alias = {};
@@ -584,7 +584,8 @@ async function bundleRenderer(routeFile, cacheTtl = 3600) {
     minify: true,
     alias,
     define: {
-      __QLARA_CACHE_TTL__: String(cacheTtl)
+      __QLARA_CACHE_TTL__: String(cacheTtl),
+      __QLARA_FRAMEWORK__: JSON.stringify(framework || "")
     },
     external: []
   });
@@ -964,7 +965,7 @@ function aws(awsConfig = {}) {
       const cf = new import_client_cloudfront.CloudFrontClient({ region: res.region });
       await updateCloudFrontEdgeVersion(cf, res.distributionId, newVersionArn);
       console.log("[qlara/aws] Bundling renderer...");
-      const rendererZip = await bundleRenderer(config.routeFile, cacheTtl);
+      const rendererZip = await bundleRenderer(config.routeFile, cacheTtl, config.framework);
       await (0, import_client_lambda.waitUntilFunctionUpdatedV2)(
         { client: lambda, maxWaitTime: 120 },
         { FunctionName: res.rendererFunctionArn }

package/dist/aws.d.cts

@@ -1,4 +1,4 @@
-import { P as ProviderResources, Q as QlaraProvider } from './types-gl2xFqEX.cjs';
+import { P as ProviderResources, Q as QlaraProvider } from './types--KPPgCtc.cjs';
 
 interface AwsConfig {
     stackName?: string;

package/dist/aws.d.ts

@@ -1,4 +1,4 @@
-import { P as ProviderResources, Q as QlaraProvider } from './types-gl2xFqEX.js';
+import { P as ProviderResources, Q as QlaraProvider } from './types--KPPgCtc.js';
 
 interface AwsConfig {
     stackName?: string;

package/dist/aws.js

@@ -558,7 +558,7 @@ async function bundleEdgeHandler(config) {
   });
   return createZip(outfile, "edge-handler.js");
 }
-async function bundleRenderer(routeFile, cacheTtl = 3600) {
+async function bundleRenderer(routeFile, cacheTtl = 3600, framework) {
   mkdirSync(BUNDLE_DIR, { recursive: true });
   const outfile = join2(BUNDLE_DIR, "renderer.js");
   const alias = {};
@@ -580,7 +580,8 @@ async function bundleRenderer(routeFile, cacheTtl = 3600) {
     minify: true,
     alias,
     define: {
-      __QLARA_CACHE_TTL__: String(cacheTtl)
+      __QLARA_CACHE_TTL__: String(cacheTtl),
+      __QLARA_FRAMEWORK__: JSON.stringify(framework || "")
     },
     external: []
   });
@@ -960,7 +961,7 @@ function aws(awsConfig = {}) {
       const cf = new CloudFrontClient({ region: res.region });
       await updateCloudFrontEdgeVersion(cf, res.distributionId, newVersionArn);
       console.log("[qlara/aws] Bundling renderer...");
-      const rendererZip = await bundleRenderer(config.routeFile, cacheTtl);
+      const rendererZip = await bundleRenderer(config.routeFile, cacheTtl, config.framework);
       await waitUntilFunctionUpdatedV2(
         { client: lambda, maxWaitTime: 120 },
         { FunctionName: res.rendererFunctionArn }

package/dist/cli.js

@@ -569,7 +569,7 @@ async function bundleEdgeHandler(config) {
   });
   return createZip(outfile, "edge-handler.js");
 }
-async function bundleRenderer(routeFile, cacheTtl = 3600) {
+async function bundleRenderer(routeFile, cacheTtl = 3600, framework) {
   mkdirSync(BUNDLE_DIR, { recursive: true });
   const outfile = join2(BUNDLE_DIR, "renderer.js");
   const alias = {};
@@ -591,7 +591,8 @@ async function bundleRenderer(routeFile, cacheTtl = 3600) {
     minify: true,
     alias,
     define: {
-      __QLARA_CACHE_TTL__: String(cacheTtl)
+      __QLARA_CACHE_TTL__: String(cacheTtl),
+      __QLARA_FRAMEWORK__: JSON.stringify(framework || "")
     },
     external: []
   });
@@ -968,7 +969,7 @@ function aws(awsConfig = {}) {
       const cf = new CloudFrontClient({ region: res.region });
       await updateCloudFrontEdgeVersion(cf, res.distributionId, newVersionArn);
       console.log("[qlara/aws] Bundling renderer...");
-      const rendererZip = await bundleRenderer(config.routeFile, cacheTtl);
+      const rendererZip = await bundleRenderer(config.routeFile, cacheTtl, config.framework);
       await waitUntilFunctionUpdatedV2(
         { client: lambda, maxWaitTime: 120 },
         { FunctionName: res.rendererFunctionArn }

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { a as QlaraPluginConfig, b as QlaraRoute, c as QlaraManifest, M as ManifestRoute, R as RouteMatch } from './types-gl2xFqEX.cjs';
-export { P as ProviderResources, d as QlaraAlternateLinkDescriptor, e as QlaraAlternateURLs, f as QlaraAppLinks, g as QlaraAppLinksAndroid, h as QlaraAppLinksApple, i as QlaraAppLinksWeb, j as QlaraAppLinksWindows, k as QlaraAppleImage, l as QlaraAppleImageDescriptor, m as QlaraAppleWebApp, n as QlaraAuthor, o as QlaraDeployConfig, p as QlaraFacebook, q as QlaraFormatDetection, r as QlaraIcon, s as QlaraIconDescriptor, t as QlaraIcons, u as QlaraItunesApp, v as QlaraMetaDataGenerator, w as QlaraMetadata, x as QlaraOGAudio, y as QlaraOGAudioDescriptor, z as QlaraOGImage, A as QlaraOGImageDescriptor, B as QlaraOGVideo, C as QlaraOGVideoDescriptor, D as QlaraOpenGraph, E as QlaraOpenGraphArticle, F as QlaraOpenGraphBase, G as QlaraOpenGraphBook, H as QlaraOpenGraphMusicAlbum, I as QlaraOpenGraphMusicPlaylist, J as QlaraOpenGraphMusicRadioStation, K as QlaraOpenGraphMusicSong, L as QlaraOpenGraphProfile, N as QlaraOpenGraphVideoEpisode, O as QlaraOpenGraphVideoMovie, S as QlaraOpenGraphVideoOther, T as QlaraOpenGraphVideoTVShow, U as QlaraOpenGraphWebsite, V as QlaraPinterest, Q as QlaraProvider, W as QlaraReferrer, X as QlaraRobots, Y as QlaraRobotsInfo, Z as QlaraRouteDefinition, _ as QlaraRoutes, $ as QlaraTwitter, a0 as QlaraTwitterApp, a1 as QlaraTwitterAppDescriptor, a2 as QlaraTwitterBase, a3 as QlaraTwitterImage, a4 as QlaraTwitterImageDescriptor, a5 as QlaraTwitterPlayer, a6 as QlaraTwitterPlayerDescriptor, a7 as QlaraTwitterSummary, a8 as QlaraTwitterSummaryLargeImage, a9 as QlaraVerification } from './types-gl2xFqEX.cjs';
+import { a as QlaraPluginConfig, b as QlaraRoute, c as QlaraManifest, M as ManifestRoute, R as RouteMatch } from './types--KPPgCtc.cjs';
+export { P as ProviderResources, d as QlaraAlternateLinkDescriptor, e as QlaraAlternateURLs, f as QlaraAppLinks, g as QlaraAppLinksAndroid, h as QlaraAppLinksApple, i as QlaraAppLinksWeb, j as QlaraAppLinksWindows, k as QlaraAppleImage, l as QlaraAppleImageDescriptor, m as QlaraAppleWebApp, n as QlaraAuthor, o as QlaraDeployConfig, p as QlaraFacebook, q as QlaraFormatDetection, r as QlaraIcon, s as QlaraIconDescriptor, t as QlaraIcons, u as QlaraItunesApp, v as QlaraMetaDataGenerator, w as QlaraMetadata, x as QlaraOGAudio, y as QlaraOGAudioDescriptor, z as QlaraOGImage, A as QlaraOGImageDescriptor, B as QlaraOGVideo, C as QlaraOGVideoDescriptor, D as QlaraOpenGraph, E as QlaraOpenGraphArticle, F as QlaraOpenGraphBase, G as QlaraOpenGraphBook, H as QlaraOpenGraphMusicAlbum, I as QlaraOpenGraphMusicPlaylist, J as QlaraOpenGraphMusicRadioStation, K as QlaraOpenGraphMusicSong, L as QlaraOpenGraphProfile, N as QlaraOpenGraphVideoEpisode, O as QlaraOpenGraphVideoMovie, S as QlaraOpenGraphVideoOther, T as QlaraOpenGraphVideoTVShow, U as QlaraOpenGraphWebsite, V as QlaraPinterest, Q as QlaraProvider, W as QlaraReferrer, X as QlaraRobots, Y as QlaraRobotsInfo, Z as QlaraRouteDefinition, _ as QlaraRoutes, $ as QlaraTwitter, a0 as QlaraTwitterApp, a1 as QlaraTwitterAppDescriptor, a2 as QlaraTwitterBase, a3 as QlaraTwitterImage, a4 as QlaraTwitterImageDescriptor, a5 as QlaraTwitterPlayer, a6 as QlaraTwitterPlayerDescriptor, a7 as QlaraTwitterSummary, a8 as QlaraTwitterSummaryLargeImage, a9 as QlaraVerification } from './types--KPPgCtc.cjs';
 
 declare function validateConfig(config: QlaraPluginConfig, routes: QlaraRoute[]): void;
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as QlaraPluginConfig, b as QlaraRoute, c as QlaraManifest, M as ManifestRoute, R as RouteMatch } from './types-gl2xFqEX.js';
-export { P as ProviderResources, d as QlaraAlternateLinkDescriptor, e as QlaraAlternateURLs, f as QlaraAppLinks, g as QlaraAppLinksAndroid, h as QlaraAppLinksApple, i as QlaraAppLinksWeb, j as QlaraAppLinksWindows, k as QlaraAppleImage, l as QlaraAppleImageDescriptor, m as QlaraAppleWebApp, n as QlaraAuthor, o as QlaraDeployConfig, p as QlaraFacebook, q as QlaraFormatDetection, r as QlaraIcon, s as QlaraIconDescriptor, t as QlaraIcons, u as QlaraItunesApp, v as QlaraMetaDataGenerator, w as QlaraMetadata, x as QlaraOGAudio, y as QlaraOGAudioDescriptor, z as QlaraOGImage, A as QlaraOGImageDescriptor, B as QlaraOGVideo, C as QlaraOGVideoDescriptor, D as QlaraOpenGraph, E as QlaraOpenGraphArticle, F as QlaraOpenGraphBase, G as QlaraOpenGraphBook, H as QlaraOpenGraphMusicAlbum, I as QlaraOpenGraphMusicPlaylist, J as QlaraOpenGraphMusicRadioStation, K as QlaraOpenGraphMusicSong, L as QlaraOpenGraphProfile, N as QlaraOpenGraphVideoEpisode, O as QlaraOpenGraphVideoMovie, S as QlaraOpenGraphVideoOther, T as QlaraOpenGraphVideoTVShow, U as QlaraOpenGraphWebsite, V as QlaraPinterest, Q as QlaraProvider, W as QlaraReferrer, X as QlaraRobots, Y as QlaraRobotsInfo, Z as QlaraRouteDefinition, _ as QlaraRoutes, $ as QlaraTwitter, a0 as QlaraTwitterApp, a1 as QlaraTwitterAppDescriptor, a2 as QlaraTwitterBase, a3 as QlaraTwitterImage, a4 as QlaraTwitterImageDescriptor, a5 as QlaraTwitterPlayer, a6 as QlaraTwitterPlayerDescriptor, a7 as QlaraTwitterSummary, a8 as QlaraTwitterSummaryLargeImage, a9 as QlaraVerification } from './types-gl2xFqEX.js';
+import { a as QlaraPluginConfig, b as QlaraRoute, c as QlaraManifest, M as ManifestRoute, R as RouteMatch } from './types--KPPgCtc.js';
+export { P as ProviderResources, d as QlaraAlternateLinkDescriptor, e as QlaraAlternateURLs, f as QlaraAppLinks, g as QlaraAppLinksAndroid, h as QlaraAppLinksApple, i as QlaraAppLinksWeb, j as QlaraAppLinksWindows, k as QlaraAppleImage, l as QlaraAppleImageDescriptor, m as QlaraAppleWebApp, n as QlaraAuthor, o as QlaraDeployConfig, p as QlaraFacebook, q as QlaraFormatDetection, r as QlaraIcon, s as QlaraIconDescriptor, t as QlaraIcons, u as QlaraItunesApp, v as QlaraMetaDataGenerator, w as QlaraMetadata, x as QlaraOGAudio, y as QlaraOGAudioDescriptor, z as QlaraOGImage, A as QlaraOGImageDescriptor, B as QlaraOGVideo, C as QlaraOGVideoDescriptor, D as QlaraOpenGraph, E as QlaraOpenGraphArticle, F as QlaraOpenGraphBase, G as QlaraOpenGraphBook, H as QlaraOpenGraphMusicAlbum, I as QlaraOpenGraphMusicPlaylist, J as QlaraOpenGraphMusicRadioStation, K as QlaraOpenGraphMusicSong, L as QlaraOpenGraphProfile, N as QlaraOpenGraphVideoEpisode, O as QlaraOpenGraphVideoMovie, S as QlaraOpenGraphVideoOther, T as QlaraOpenGraphVideoTVShow, U as QlaraOpenGraphWebsite, V as QlaraPinterest, Q as QlaraProvider, W as QlaraReferrer, X as QlaraRobots, Y as QlaraRobotsInfo, Z as QlaraRouteDefinition, _ as QlaraRoutes, $ as QlaraTwitter, a0 as QlaraTwitterApp, a1 as QlaraTwitterAppDescriptor, a2 as QlaraTwitterBase, a3 as QlaraTwitterImage, a4 as QlaraTwitterImageDescriptor, a5 as QlaraTwitterPlayer, a6 as QlaraTwitterPlayerDescriptor, a7 as QlaraTwitterSummary, a8 as QlaraTwitterSummaryLargeImage, a9 as QlaraVerification } from './types--KPPgCtc.js';
 
 declare function validateConfig(config: QlaraPluginConfig, routes: QlaraRoute[]): void;
 

package/dist/plugin/next.cjs

@@ -153,7 +153,8 @@ function withQlara(qlaraConfig) {
       },
       outputDir,
       routeFile: (0, import_node_path.resolve)(qlaraConfig.routeFile),
-      env
+      env,
+      framework: "next"
     };
     (0, import_node_fs.mkdirSync)(QLARA_DIR, { recursive: true });
     (0, import_node_fs.writeFileSync)(

package/dist/plugin/next.d.cts

@@ -1,5 +1,5 @@
 import { NextConfig } from 'next';
-import { a as QlaraPluginConfig } from '../types-gl2xFqEX.cjs';
+import { a as QlaraPluginConfig } from '../types--KPPgCtc.cjs';
 
 /**
  * Wrap a Next.js config with Qlara.

package/dist/plugin/next.d.ts

@@ -1,5 +1,5 @@
 import { NextConfig } from 'next';
-import { a as QlaraPluginConfig } from '../types-gl2xFqEX.js';
+import { a as QlaraPluginConfig } from '../types--KPPgCtc.js';
 
 /**
  * Wrap a Next.js config with Qlara.

package/dist/plugin/next.js

@@ -84,7 +84,8 @@ function withQlara(qlaraConfig) {
       },
       outputDir,
       routeFile: resolve(qlaraConfig.routeFile),
-      env
+      env,
+      framework: "next"
     };
     mkdirSync(QLARA_DIR, { recursive: true });
     writeFileSync(

package/dist/{types-gl2xFqEX.d.cts → types--KPPgCtc.d.cts}

@@ -368,6 +368,12 @@ interface QlaraPluginConfig {
     provider: QlaraProvider;
     /** Env var names to forward to the renderer Lambda (values read from process.env at build time) */
     env?: string[];
+    /**
+     * The framework identifier. Set automatically by framework plugins (e.g. 'next' by withQlara).
+     * Used by the renderer to enable framework-specific post-render behavior
+     * (e.g. generating .txt RSC flight data files for Next.js client-side navigation).
+     */
+    framework?: string;
 }
 interface QlaraProvider {
     name: string;
@@ -394,6 +400,11 @@ interface QlaraDeployConfig {
     routeFile: string;
     /** Environment variables for the renderer Lambda (key-value pairs resolved at build time) */
     env?: Record<string, string>;
+    /**
+     * The framework identifier (e.g. 'next'). Set by framework plugins.
+     * Passed to the renderer to enable framework-specific post-render behavior.
+     */
+    framework?: string;
 }
 interface QlaraManifest {
     version: 1;

package/dist/{types-gl2xFqEX.d.ts → types--KPPgCtc.d.ts}

@@ -368,6 +368,12 @@ interface QlaraPluginConfig {
     provider: QlaraProvider;
     /** Env var names to forward to the renderer Lambda (values read from process.env at build time) */
     env?: string[];
+    /**
+     * The framework identifier. Set automatically by framework plugins (e.g. 'next' by withQlara).
+     * Used by the renderer to enable framework-specific post-render behavior
+     * (e.g. generating .txt RSC flight data files for Next.js client-side navigation).
+     */
+    framework?: string;
 }
 interface QlaraProvider {
     name: string;
@@ -394,6 +400,11 @@ interface QlaraDeployConfig {
     routeFile: string;
     /** Environment variables for the renderer Lambda (key-value pairs resolved at build time) */
     env?: Record<string, string>;
+    /**
+     * The framework identifier (e.g. 'next'). Set by framework plugins.
+     * Passed to the renderer to enable framework-specific post-render behavior.
+     */
+    framework?: string;
 }
 interface QlaraManifest {
     version: 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlara",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Runtime ISR for static React apps — dynamic routing and SEO metadata for statically exported Next.js apps on AWS",
   "license": "MIT",
   "keywords": [

package/src/provider/aws/renderer.ts

@@ -54,6 +54,7 @@ import type {
 // At bundle time: '__qlara_routes__' → './qlara.routes.ts' (or wherever the dev put it)
 // Injected at bundle time by esbuild define
 declare const __QLARA_CACHE_TTL__: number;
+declare const __QLARA_FRAMEWORK__: string;
 
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
 // @ts-ignore — resolved at bundle time by esbuild alias
@@ -759,6 +760,34 @@ function metadataToRscEntries(metadata: QlaraMetadata): string {
   return entries.join('');
 }
 
+/**
+ * Extract RSC flight data from rendered HTML (Next.js-specific).
+ *
+ * Next.js embeds RSC data inside <script>self.__next_f.push([1,"..."])</script> blocks.
+ * The .txt file is these payloads concatenated with JSON string escapes resolved.
+ * Next.js's client-side router fetches the .txt file for client-side navigation
+ * instead of the full .html — so we must generate it for renderer-created pages.
+ *
+ * Only called when __QLARA_FRAMEWORK__ === 'next'.
+ */
+function extractRscFlightData(html: string): string | null {
+  const chunks: string[] = [];
+  const regex = /self\.__next_f\.push\(\[1,"((?:[^"\\]|\\.)*)"\]\)/g;
+  let match;
+
+  while ((match = regex.exec(html)) !== null) {
+    // Unescape the JSON string: \" → ", \\ → \, \n → newline
+    const unescaped = match[1]
+      .replace(/\\n/g, '\n')
+      .replace(/\\"/g, '"')
+      .replace(/\\\\/g, '\\');
+    chunks.push(unescaped);
+  }
+
+  if (chunks.length === 0) return null;
+  return chunks.join('');
+}
+
 export async function handler(event: RendererEvent & { warmup?: boolean }): Promise<RendererResult> {
   // Warmup invocation — just initialize the runtime and return
   if (event.warmup) {
@@ -825,7 +854,7 @@ export async function handler(event: RendererEvent & { warmup?: boolean }): Prom
       }
     }
 
-    // 5. Upload to S3
+    // 5. Upload HTML to S3
     await s3.send(
       new PutObjectCommand({
         Bucket: bucket,
@@ -836,6 +865,26 @@ export async function handler(event: RendererEvent & { warmup?: boolean }): Prom
       })
     );
 
+    // 6. Framework-specific post-render uploads
+    //    Next.js: extract RSC flight data and upload as .txt for client-side navigation.
+    //    Next.js fetches .txt instead of .html when using <Link> / client-side nav.
+    //    Without this, client-side nav falls back to a full page reload (slow).
+    if (__QLARA_FRAMEWORK__ === 'next') {
+      const rscData = extractRscFlightData(html);
+      if (rscData) {
+        const txtKey = s3Key.replace(/\.html$/, '.txt');
+        await s3.send(
+          new PutObjectCommand({
+            Bucket: bucket,
+            Key: txtKey,
+            Body: rscData,
+            ContentType: 'text/plain; charset=utf-8',
+            CacheControl: `public, max-age=0, s-maxage=${__QLARA_CACHE_TTL__}, stale-while-revalidate=60`,
+          })
+        );
+      }
+    }
+
     return {
       statusCode: 200,
       body: JSON.stringify({

package/src/types.ts

@@ -513,6 +513,12 @@ export interface QlaraPluginConfig {
   provider: QlaraProvider;
   /** Env var names to forward to the renderer Lambda (values read from process.env at build time) */
   env?: string[];
+  /**
+   * The framework identifier. Set automatically by framework plugins (e.g. 'next' by withQlara).
+   * Used by the renderer to enable framework-specific post-render behavior
+   * (e.g. generating .txt RSC flight data files for Next.js client-side navigation).
+   */
+  framework?: string;
 }
 
 export interface QlaraProvider {
@@ -542,6 +548,11 @@ export interface QlaraDeployConfig {
   routeFile: string;
   /** Environment variables for the renderer Lambda (key-value pairs resolved at build time) */
   env?: Record<string, string>;
+  /**
+   * The framework identifier (e.g. 'next'). Set by framework plugins.
+   * Passed to the renderer to enable framework-specific post-render behavior.
+   */
+  framework?: string;
 }
 
 export interface QlaraManifest {