qlara 0.1.1 → 0.1.3

package/dist/aws.cjs

@@ -464,42 +464,30 @@ var import_esbuild = require("esbuild");
 var import_node_fs2 = require("fs");
 var import_node_path2 = require("path");
 var import_node_url = require("url");
+var import_node_module = require("module");
 var import_archiver = __toESM(require("archiver"), 1);
 var import_node_stream = require("stream");
 var import_meta = {};
 var BUNDLE_DIR = (0, import_node_path2.join)(".qlara", "bundles");
-function getModuleDir() {
-  if (typeof __dirname !== "undefined") {
-    return __dirname;
-  }
-  return (0, import_node_path2.dirname)((0, import_node_url.fileURLToPath)(import_meta.url));
-}
-function findPackageRoot(startDir) {
-  let dir = startDir;
-  for (let i = 0; i < 10; i++) {
-    const pkgPath = (0, import_node_path2.join)(dir, "package.json");
-    if ((0, import_node_fs2.existsSync)(pkgPath)) {
-      try {
-        const { readFileSync: readFileSync3 } = require("fs");
-        const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
-        if (pkg.name === "qlara") return dir;
-      } catch {
-      }
-    }
-    const parent = (0, import_node_path2.dirname)(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return startDir;
-}
 function resolveEntry(name) {
-  const moduleDir = getModuleDir();
-  const sameDirTs = (0, import_node_path2.resolve)(moduleDir, `${name}.ts`);
+  const thisDir = (0, import_node_path2.dirname)((0, import_node_url.fileURLToPath)(import_meta.url));
+  const sameDirTs = (0, import_node_path2.resolve)(thisDir, `${name}.ts`);
   if ((0, import_node_fs2.existsSync)(sameDirTs)) return sameDirTs;
-  const pkgRoot = findPackageRoot(moduleDir);
-  const pkgSrcTs = (0, import_node_path2.resolve)(pkgRoot, "src", "provider", "aws", `${name}.ts`);
-  if ((0, import_node_fs2.existsSync)(pkgSrcTs)) return pkgSrcTs;
-  return (0, import_node_path2.resolve)(moduleDir, `${name}.js`);
+  try {
+    const esmRequire = (0, import_node_module.createRequire)(import_meta.url);
+    const pkgJsonPath = esmRequire.resolve("qlara/package.json");
+    const pkgRoot = (0, import_node_path2.dirname)(pkgJsonPath);
+    const srcTs = (0, import_node_path2.join)(pkgRoot, "src", "provider", "aws", `${name}.ts`);
+    if ((0, import_node_fs2.existsSync)(srcTs)) return srcTs;
+  } catch {
+  }
+  const fromDist = (0, import_node_path2.resolve)(thisDir, "..", "src", "provider", "aws", `${name}.ts`);
+  if ((0, import_node_fs2.existsSync)(fromDist)) return fromDist;
+  throw new Error(
+    `[qlara] Could not find ${name}.ts Lambda source file. Searched:
+  ${sameDirTs}
+  ${fromDist}`
+  );
 }
 async function createZip(filePath, entryName) {
   return new Promise((resolvePromise, reject) => {
@@ -532,14 +520,15 @@ async function bundleEdgeHandler(config) {
     define: {
       __QLARA_BUCKET_NAME__: JSON.stringify(config.bucketName),
       __QLARA_RENDERER_ARN__: JSON.stringify(config.rendererArn),
-      __QLARA_REGION__: JSON.stringify(config.region)
+      __QLARA_REGION__: JSON.stringify(config.region),
+      __QLARA_CACHE_TTL__: String(config.cacheTtl)
     },
     // Bundle everything — Lambda@Edge must be self-contained
     external: []
   });
   return createZip(outfile, "edge-handler.js");
 }
-async function bundleRenderer(routeFile) {
+async function bundleRenderer(routeFile, cacheTtl = 3600) {
   (0, import_node_fs2.mkdirSync)(BUNDLE_DIR, { recursive: true });
   const outfile = (0, import_node_path2.join)(BUNDLE_DIR, "renderer.js");
   const alias = {};
@@ -560,6 +549,9 @@ async function bundleRenderer(routeFile) {
     outfile,
     minify: true,
     alias,
+    define: {
+      __QLARA_CACHE_TTL__: String(cacheTtl)
+    },
     external: []
   });
   return createZip(outfile, "renderer.js");
@@ -776,6 +768,7 @@ function byoiResources(config) {
 function aws(awsConfig = {}) {
   const region = "us-east-1";
   const byoi = isByoi(awsConfig);
+  const cacheTtl = awsConfig.cacheTtl ?? 3600;
   const stackName = byoi ? "" : awsConfig.stackName || STACK_NAME_PREFIX;
   return {
     name: "aws",
@@ -857,7 +850,8 @@ function aws(awsConfig = {}) {
       const edgeZip = await bundleEdgeHandler({
         bucketName: res.bucketName,
         rendererArn: res.rendererFunctionArn,
-        region: res.region
+        region: res.region,
+        cacheTtl
       });
       const lambda = new import_client_lambda.LambdaClient({ region: res.region });
       console.log("[qlara/aws] Waiting for edge handler to be ready...");
@@ -934,7 +928,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);
+      const rendererZip = await bundleRenderer(config.routeFile, cacheTtl);
       await (0, import_client_lambda.waitUntilFunctionUpdatedV2)(
         { client: lambda, maxWaitTime: 120 },
         { FunctionName: res.rendererFunctionArn }
@@ -1009,6 +1003,21 @@ function aws(awsConfig = {}) {
           `[qlara/aws] Could not update renderer permissions: ${err.message}`
         );
       }
+      console.log("[qlara/aws] Warming up renderer...");
+      try {
+        await lambda.send(
+          new import_client_lambda.InvokeCommand({
+            FunctionName: res.rendererFunctionArn,
+            InvocationType: "RequestResponse",
+            Payload: JSON.stringify({ warmup: true })
+          })
+        );
+        console.log("[qlara/aws] Renderer warmed up");
+      } catch (err) {
+        console.warn(
+          `[qlara/aws] Renderer warm-up failed (non-critical): ${err.message}`
+        );
+      }
       console.log("[qlara/aws] Invalidating CloudFront cache...");
       await cf.send(
         new import_client_cloudfront.CreateInvalidationCommand({

package/dist/aws.d.cts

@@ -3,6 +3,16 @@ import { P as ProviderResources, Q as QlaraProvider } from './types-gl2xFqEX.cjs
 interface AwsConfig {
     stackName?: string;
     bucketName?: string;
+    /**
+     * How long (in seconds) CloudFront should cache dynamically rendered pages.
+     * This sets the `s-maxage` value on the Cache-Control header.
+     *
+     * - Browsers always revalidate with CloudFront (`max-age=0`)
+     * - CloudFront serves from edge cache for this duration
+     *
+     * @default 3600 (1 hour)
+     */
+    cacheTtl?: number;
     distributionId?: string;
     distributionDomain?: string;
     edgeFunctionArn?: string;

package/dist/aws.d.ts

@@ -3,6 +3,16 @@ import { P as ProviderResources, Q as QlaraProvider } from './types-gl2xFqEX.js'
 interface AwsConfig {
     stackName?: string;
     bucketName?: string;
+    /**
+     * How long (in seconds) CloudFront should cache dynamically rendered pages.
+     * This sets the `s-maxage` value on the Cache-Control header.
+     *
+     * - Browsers always revalidate with CloudFront (`max-age=0`)
+     * - CloudFront serves from edge cache for this duration
+     *
+     * @default 3600 (1 hour)
+     */
+    cacheTtl?: number;
     distributionId?: string;
     distributionDomain?: string;
     edgeFunctionArn?: string;

package/dist/aws.js

@@ -1,7 +1,3 @@
-import {
-  __require
-} from "./chunk-3RG5ZIWI.js";
-
 // src/provider/aws/index.ts
 import {
   CloudFormationClient,
@@ -19,6 +15,7 @@ import {
   UpdateFunctionConfigurationCommand,
   PublishVersionCommand,
   AddPermissionCommand,
+  InvokeCommand,
   waitUntilFunctionUpdatedV2
 } from "@aws-sdk/client-lambda";
 import {
@@ -464,41 +461,29 @@ import { build } from "esbuild";
 import { mkdirSync, existsSync } from "fs";
 import { resolve, join as join2, dirname } from "path";
 import { fileURLToPath } from "url";
+import { createRequire } from "module";
 import archiver from "archiver";
 import { Writable } from "stream";
 var BUNDLE_DIR = join2(".qlara", "bundles");
-function getModuleDir() {
-  if (typeof __dirname !== "undefined") {
-    return __dirname;
-  }
-  return dirname(fileURLToPath(import.meta.url));
-}
-function findPackageRoot(startDir) {
-  let dir = startDir;
-  for (let i = 0; i < 10; i++) {
-    const pkgPath = join2(dir, "package.json");
-    if (existsSync(pkgPath)) {
-      try {
-        const { readFileSync: readFileSync3 } = __require("fs");
-        const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
-        if (pkg.name === "qlara") return dir;
-      } catch {
-      }
-    }
-    const parent = dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return startDir;
-}
 function resolveEntry(name) {
-  const moduleDir = getModuleDir();
-  const sameDirTs = resolve(moduleDir, `${name}.ts`);
+  const thisDir = dirname(fileURLToPath(import.meta.url));
+  const sameDirTs = resolve(thisDir, `${name}.ts`);
   if (existsSync(sameDirTs)) return sameDirTs;
-  const pkgRoot = findPackageRoot(moduleDir);
-  const pkgSrcTs = resolve(pkgRoot, "src", "provider", "aws", `${name}.ts`);
-  if (existsSync(pkgSrcTs)) return pkgSrcTs;
-  return resolve(moduleDir, `${name}.js`);
+  try {
+    const esmRequire = createRequire(import.meta.url);
+    const pkgJsonPath = esmRequire.resolve("qlara/package.json");
+    const pkgRoot = dirname(pkgJsonPath);
+    const srcTs = join2(pkgRoot, "src", "provider", "aws", `${name}.ts`);
+    if (existsSync(srcTs)) return srcTs;
+  } catch {
+  }
+  const fromDist = resolve(thisDir, "..", "src", "provider", "aws", `${name}.ts`);
+  if (existsSync(fromDist)) return fromDist;
+  throw new Error(
+    `[qlara] Could not find ${name}.ts Lambda source file. Searched:
+  ${sameDirTs}
+  ${fromDist}`
+  );
 }
 async function createZip(filePath, entryName) {
   return new Promise((resolvePromise, reject) => {
@@ -531,14 +516,15 @@ async function bundleEdgeHandler(config) {
     define: {
       __QLARA_BUCKET_NAME__: JSON.stringify(config.bucketName),
       __QLARA_RENDERER_ARN__: JSON.stringify(config.rendererArn),
-      __QLARA_REGION__: JSON.stringify(config.region)
+      __QLARA_REGION__: JSON.stringify(config.region),
+      __QLARA_CACHE_TTL__: String(config.cacheTtl)
     },
     // Bundle everything — Lambda@Edge must be self-contained
     external: []
   });
   return createZip(outfile, "edge-handler.js");
 }
-async function bundleRenderer(routeFile) {
+async function bundleRenderer(routeFile, cacheTtl = 3600) {
   mkdirSync(BUNDLE_DIR, { recursive: true });
   const outfile = join2(BUNDLE_DIR, "renderer.js");
   const alias = {};
@@ -559,6 +545,9 @@ async function bundleRenderer(routeFile) {
     outfile,
     minify: true,
     alias,
+    define: {
+      __QLARA_CACHE_TTL__: String(cacheTtl)
+    },
     external: []
   });
   return createZip(outfile, "renderer.js");
@@ -568,7 +557,7 @@ async function bundleRenderer(routeFile) {
 var STACK_NAME_PREFIX = "qlara";
 
 // src/fallback.ts
-import { readFileSync as readFileSync2, writeFileSync, readdirSync as readdirSync2, existsSync as existsSync2 } from "fs";
+import { readFileSync as readFileSync3, writeFileSync, readdirSync as readdirSync2, existsSync as existsSync2 } from "fs";
 import { join as join3 } from "path";
 var FALLBACK_FILENAME = "_fallback.html";
 var FALLBACK_PLACEHOLDER = "__QLARA_FALLBACK__";
@@ -647,7 +636,7 @@ function generateFallbacks(buildDir, routes) {
       continue;
     }
     const templatePath = join3(routeDir, files[0]);
-    const templateHtml = readFileSync2(templatePath, "utf-8");
+    const templateHtml = readFileSync3(templatePath, "utf-8");
     const fallbackHtml = generateFallbackFromTemplate(templateHtml, route.pattern);
     const fallbackPath = join3(routeDir, FALLBACK_FILENAME);
     writeFileSync(fallbackPath, fallbackHtml);
@@ -775,6 +764,7 @@ function byoiResources(config) {
 function aws(awsConfig = {}) {
   const region = "us-east-1";
   const byoi = isByoi(awsConfig);
+  const cacheTtl = awsConfig.cacheTtl ?? 3600;
   const stackName = byoi ? "" : awsConfig.stackName || STACK_NAME_PREFIX;
   return {
     name: "aws",
@@ -856,7 +846,8 @@ function aws(awsConfig = {}) {
       const edgeZip = await bundleEdgeHandler({
         bucketName: res.bucketName,
         rendererArn: res.rendererFunctionArn,
-        region: res.region
+        region: res.region,
+        cacheTtl
       });
       const lambda = new LambdaClient({ region: res.region });
       console.log("[qlara/aws] Waiting for edge handler to be ready...");
@@ -933,7 +924,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);
+      const rendererZip = await bundleRenderer(config.routeFile, cacheTtl);
       await waitUntilFunctionUpdatedV2(
         { client: lambda, maxWaitTime: 120 },
         { FunctionName: res.rendererFunctionArn }
@@ -1008,6 +999,21 @@ function aws(awsConfig = {}) {
           `[qlara/aws] Could not update renderer permissions: ${err.message}`
         );
       }
+      console.log("[qlara/aws] Warming up renderer...");
+      try {
+        await lambda.send(
+          new InvokeCommand({
+            FunctionName: res.rendererFunctionArn,
+            InvocationType: "RequestResponse",
+            Payload: JSON.stringify({ warmup: true })
+          })
+        );
+        console.log("[qlara/aws] Renderer warmed up");
+      } catch (err) {
+        console.warn(
+          `[qlara/aws] Renderer warm-up failed (non-critical): ${err.message}`
+        );
+      }
       console.log("[qlara/aws] Invalidating CloudFront cache...");
       await cf.send(
         new CreateInvalidationCommand({

package/dist/cli.js

@@ -1,13 +1,7 @@
 #!/usr/bin/env node
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
 
 // src/cli.ts
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync2, existsSync as existsSync3, mkdirSync as mkdirSync2 } from "fs";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync2, existsSync as existsSync3, mkdirSync as mkdirSync2 } from "fs";
 import { join as join4 } from "path";
 
 // src/provider/aws/constants.ts
@@ -32,6 +26,7 @@ import {
   UpdateFunctionConfigurationCommand,
   PublishVersionCommand,
   AddPermissionCommand,
+  InvokeCommand,
   waitUntilFunctionUpdatedV2
 } from "@aws-sdk/client-lambda";
 import {
@@ -477,41 +472,29 @@ import { build } from "esbuild";
 import { mkdirSync, existsSync } from "fs";
 import { resolve, join as join2, dirname } from "path";
 import { fileURLToPath } from "url";
+import { createRequire } from "module";
 import archiver from "archiver";
 import { Writable } from "stream";
 var BUNDLE_DIR = join2(".qlara", "bundles");
-function getModuleDir() {
-  if (typeof __dirname !== "undefined") {
-    return __dirname;
-  }
-  return dirname(fileURLToPath(import.meta.url));
-}
-function findPackageRoot(startDir) {
-  let dir = startDir;
-  for (let i = 0; i < 10; i++) {
-    const pkgPath = join2(dir, "package.json");
-    if (existsSync(pkgPath)) {
-      try {
-        const { readFileSync: readFileSync4 } = __require("fs");
-        const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
-        if (pkg.name === "qlara") return dir;
-      } catch {
-      }
-    }
-    const parent = dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return startDir;
-}
 function resolveEntry(name) {
-  const moduleDir = getModuleDir();
-  const sameDirTs = resolve(moduleDir, `${name}.ts`);
+  const thisDir = dirname(fileURLToPath(import.meta.url));
+  const sameDirTs = resolve(thisDir, `${name}.ts`);
   if (existsSync(sameDirTs)) return sameDirTs;
-  const pkgRoot = findPackageRoot(moduleDir);
-  const pkgSrcTs = resolve(pkgRoot, "src", "provider", "aws", `${name}.ts`);
-  if (existsSync(pkgSrcTs)) return pkgSrcTs;
-  return resolve(moduleDir, `${name}.js`);
+  try {
+    const esmRequire = createRequire(import.meta.url);
+    const pkgJsonPath = esmRequire.resolve("qlara/package.json");
+    const pkgRoot = dirname(pkgJsonPath);
+    const srcTs = join2(pkgRoot, "src", "provider", "aws", `${name}.ts`);
+    if (existsSync(srcTs)) return srcTs;
+  } catch {
+  }
+  const fromDist = resolve(thisDir, "..", "src", "provider", "aws", `${name}.ts`);
+  if (existsSync(fromDist)) return fromDist;
+  throw new Error(
+    `[qlara] Could not find ${name}.ts Lambda source file. Searched:
+  ${sameDirTs}
+  ${fromDist}`
+  );
 }
 async function createZip(filePath, entryName) {
   return new Promise((resolvePromise, reject) => {
@@ -544,14 +527,15 @@ async function bundleEdgeHandler(config) {
     define: {
       __QLARA_BUCKET_NAME__: JSON.stringify(config.bucketName),
       __QLARA_RENDERER_ARN__: JSON.stringify(config.rendererArn),
-      __QLARA_REGION__: JSON.stringify(config.region)
+      __QLARA_REGION__: JSON.stringify(config.region),
+      __QLARA_CACHE_TTL__: String(config.cacheTtl)
     },
     // Bundle everything — Lambda@Edge must be self-contained
     external: []
   });
   return createZip(outfile, "edge-handler.js");
 }
-async function bundleRenderer(routeFile) {
+async function bundleRenderer(routeFile, cacheTtl = 3600) {
   mkdirSync(BUNDLE_DIR, { recursive: true });
   const outfile = join2(BUNDLE_DIR, "renderer.js");
   const alias = {};
@@ -572,13 +556,16 @@ async function bundleRenderer(routeFile) {
     outfile,
     minify: true,
     alias,
+    define: {
+      __QLARA_CACHE_TTL__: String(cacheTtl)
+    },
     external: []
   });
   return createZip(outfile, "renderer.js");
 }
 
 // src/fallback.ts
-import { readFileSync as readFileSync2, writeFileSync, readdirSync as readdirSync2, existsSync as existsSync2 } from "fs";
+import { readFileSync as readFileSync3, writeFileSync, readdirSync as readdirSync2, existsSync as existsSync2 } from "fs";
 import { join as join3 } from "path";
 var FALLBACK_FILENAME = "_fallback.html";
 var FALLBACK_PLACEHOLDER = "__QLARA_FALLBACK__";
@@ -657,7 +644,7 @@ function generateFallbacks(buildDir, routes) {
       continue;
     }
     const templatePath = join3(routeDir, files[0]);
-    const templateHtml = readFileSync2(templatePath, "utf-8");
+    const templateHtml = readFileSync3(templatePath, "utf-8");
     const fallbackHtml = generateFallbackFromTemplate(templateHtml, route.pattern);
     const fallbackPath = join3(routeDir, FALLBACK_FILENAME);
     writeFileSync(fallbackPath, fallbackHtml);
@@ -785,6 +772,7 @@ function byoiResources(config) {
 function aws(awsConfig = {}) {
   const region = "us-east-1";
   const byoi = isByoi(awsConfig);
+  const cacheTtl = awsConfig.cacheTtl ?? 3600;
   const stackName = byoi ? "" : awsConfig.stackName || STACK_NAME_PREFIX;
   return {
     name: "aws",
@@ -866,7 +854,8 @@ function aws(awsConfig = {}) {
       const edgeZip = await bundleEdgeHandler({
         bucketName: res.bucketName,
         rendererArn: res.rendererFunctionArn,
-        region: res.region
+        region: res.region,
+        cacheTtl
       });
       const lambda = new LambdaClient({ region: res.region });
       console.log("[qlara/aws] Waiting for edge handler to be ready...");
@@ -943,7 +932,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);
+      const rendererZip = await bundleRenderer(config.routeFile, cacheTtl);
       await waitUntilFunctionUpdatedV2(
         { client: lambda, maxWaitTime: 120 },
         { FunctionName: res.rendererFunctionArn }
@@ -1018,6 +1007,21 @@ function aws(awsConfig = {}) {
           `[qlara/aws] Could not update renderer permissions: ${err.message}`
         );
       }
+      console.log("[qlara/aws] Warming up renderer...");
+      try {
+        await lambda.send(
+          new InvokeCommand({
+            FunctionName: res.rendererFunctionArn,
+            InvocationType: "RequestResponse",
+            Payload: JSON.stringify({ warmup: true })
+          })
+        );
+        console.log("[qlara/aws] Renderer warmed up");
+      } catch (err) {
+        console.warn(
+          `[qlara/aws] Renderer warm-up failed (non-critical): ${err.message}`
+        );
+      }
       console.log("[qlara/aws] Invalidating CloudFront cache...");
       await cf.send(
         new CreateInvalidationCommand({
@@ -1101,11 +1105,11 @@ function loadConfig() {
     console.error("[qlara] Run your framework build first (e.g. `next build`)");
     process.exit(1);
   }
-  return JSON.parse(readFileSync3(CONFIG_PATH, "utf-8"));
+  return JSON.parse(readFileSync4(CONFIG_PATH, "utf-8"));
 }
 function loadResources() {
   if (!existsSync3(RESOURCES_PATH)) return null;
-  return JSON.parse(readFileSync3(RESOURCES_PATH, "utf-8"));
+  return JSON.parse(readFileSync4(RESOURCES_PATH, "utf-8"));
 }
 function saveResources(resources) {
   mkdirSync2(QLARA_DIR, { recursive: true });

package/dist/index.js

@@ -5,7 +5,6 @@ import {
   patternToRegex,
   validateConfig
 } from "./chunk-5K3GS3TV.js";
-import "./chunk-3RG5ZIWI.js";
 export {
   buildManifest,
   extractParamNames,

package/dist/plugin/next.js

@@ -2,7 +2,6 @@ import {
   buildManifest,
   validateConfig
 } from "../chunk-5K3GS3TV.js";
-import "../chunk-3RG5ZIWI.js";
 
 // src/plugin/next.ts
 import { writeFileSync, readFileSync, mkdirSync, existsSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlara",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Runtime ISR for static React apps — dynamic routing and SEO metadata for statically exported Next.js apps on AWS",
   "license": "MIT",
   "keywords": [
@@ -42,7 +42,8 @@
       "types": "./dist/aws.d.ts",
       "import": "./dist/aws.js",
       "require": "./dist/aws.cjs"
-    }
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",

package/src/provider/aws/edge-handler.ts

@@ -24,6 +24,7 @@ import { LambdaClient, InvokeCommand } from '@aws-sdk/client-lambda';
 declare const __QLARA_BUCKET_NAME__: string;
 declare const __QLARA_RENDERER_ARN__: string;
 declare const __QLARA_REGION__: string;
+declare const __QLARA_CACHE_TTL__: number;
 // ── Types (inlined to keep bundle self-contained) ────────────────
 
 interface ManifestRoute {
@@ -238,7 +239,7 @@ function buildHtmlResponse(
       { key: 'Content-Type', value: 'text/html; charset=utf-8' },
     ],
     'cache-control': [
-      { key: 'Cache-Control', value: 'public, max-age=0, must-revalidate' },
+      { key: 'Cache-Control', value: `public, max-age=0, s-maxage=${__QLARA_CACHE_TTL__}, stale-while-revalidate=60` },
     ],
   };
 

package/src/provider/aws/renderer.ts

@@ -52,6 +52,9 @@ import type {
 // The routes module is resolved by esbuild at deploy time.
 // esbuild's `alias` option maps this import to the developer's route file.
 // 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;
+
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
 // @ts-ignore — resolved at bundle time by esbuild alias
 import routes from '__qlara_routes__';
@@ -752,20 +755,30 @@ function metadataToRscEntries(metadata: QlaraMetadata): string {
   return entries.join('');
 }
 
-export async function handler(event: RendererEvent): Promise<RendererResult> {
+export async function handler(event: RendererEvent & { warmup?: boolean }): Promise<RendererResult> {
+  // Warmup invocation — just initialize the runtime and return
+  if (event.warmup) {
+    return { statusCode: 200, body: 'warm' };
+  }
+
   const { uri, bucket, routePattern, params } = event;
   const region = process.env.AWS_REGION || 'us-east-1';
 
   const s3 = new S3Client({ region });
 
   try {
-    // 0. Check if the page was already rendered (guards against duplicate concurrent requests)
+    // 0. Check if already rendered + read fallback in parallel
     const s3Key = deriveS3Key(uri);
-    try {
-      const existing = await s3.send(
-        new GetObjectCommand({ Bucket: bucket, Key: s3Key })
-      );
-      const existingHtml = await existing.Body?.transformToString('utf-8');
+    const fallbackKey = deriveFallbackKey(uri);
+
+    const [existingResult, fallbackResult] = await Promise.allSettled([
+      s3.send(new GetObjectCommand({ Bucket: bucket, Key: s3Key })),
+      s3.send(new GetObjectCommand({ Bucket: bucket, Key: fallbackKey })),
+    ]);
+
+    // If page already exists, return it (guards against duplicate concurrent requests)
+    if (existingResult.status === 'fulfilled') {
+      const existingHtml = await existingResult.value.Body?.transformToString('utf-8');
       if (existingHtml) {
         return {
           statusCode: 200,
@@ -773,26 +786,20 @@ export async function handler(event: RendererEvent): Promise<RendererResult> {
           html: existingHtml,
         };
       }
-    } catch {
-      // Page doesn't exist yet — continue with rendering
     }
 
-    // 1. Read the fallback HTML from S3
-    const fallbackKey = deriveFallbackKey(uri);
+    // Extract fallback HTML
     let fallbackHtml: string;
 
-    try {
-      const response = await s3.send(
-        new GetObjectCommand({ Bucket: bucket, Key: fallbackKey })
-      );
-      fallbackHtml = (await response.Body?.transformToString('utf-8')) || '';
+    if (fallbackResult.status === 'fulfilled') {
+      fallbackHtml = (await fallbackResult.value.Body?.transformToString('utf-8')) || '';
       if (!fallbackHtml) {
         return {
           statusCode: 500,
           body: JSON.stringify({ error: `Empty fallback at ${fallbackKey}` }),
         };
       }
-    } catch {
+    } else {
       return {
         statusCode: 500,
         body: JSON.stringify({ error: `Fallback not found: ${fallbackKey}` }),
@@ -824,8 +831,7 @@ export async function handler(event: RendererEvent): Promise<RendererResult> {
         Key: s3Key,
         Body: html,
         ContentType: 'text/html; charset=utf-8',
-        CacheControl:
-          'public, max-age=0, s-maxage=31536000, stale-while-revalidate=86400',
+        CacheControl: `public, max-age=0, s-maxage=${__QLARA_CACHE_TTL__}, stale-while-revalidate=60`,
       })
     );
 

package/dist/chunk-3RG5ZIWI.js

@@ -1,10 +0,0 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-export {
-  __require
-};