@ruvyxa/adapter-netlify 1.0.18 → 1.0.19

package/dist/index.d.ts

@@ -7,12 +7,24 @@ export interface NetlifyAdapterOptions {
     functionsDir?: string;
     /**
      * Also emit a `netlify.toml` at the project root pointing Netlify at the
-     * generated publish directory and functions, so a fresh site deploys
-     * without dashboard configuration. An existing project `netlify.toml` is
-     * never overwritten.
-     * @default true
+     * generated publish directory and functions. An existing project
+     * `netlify.toml` is never overwritten.
+     *
+     * Off by default: the adapter already emits the serverless function and
+     * cache headers through Netlify's Frameworks API (`.netlify/v1/`, a
+     * gitignored build artifact), so the only remaining setup is the publish
+     * directory — set once in the Netlify dashboard, or opt into this file.
+     * @default false
      */
     projectConfig?: boolean;
+    /**
+     * Emit the Netlify Frameworks API directory (`.netlify/v1/`) at the project
+     * root during `ruvyxa build`: the SSR/API function and the immutable cache
+     * headers for hashed client bundles. Netlify picks the directory up
+     * automatically on the next deploy — no config file at the project root.
+     * @default true
+     */
+    frameworksApi?: boolean;
 }
 /**
  * Create a Netlify deployment adapter for Ruvyxa.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAgD,MAAM,cAAc,CAAA;AAGzF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAgED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAyE3E;eAEc,cAAc"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAgD,MAAM,cAAc,CAAA;AAGzF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AA6ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAmH3E;eAEc,cAAc"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { clientBuildOutput, validateBuildContext } from '@ruvyxa/core';
+import { clientBuildOutput, projectRelativeOutDir, validateBuildContext } from '@ruvyxa/core';
 /**
  * Netlify Functions v2 handler source code.
  *
@@ -10,11 +10,22 @@ function netlifyHandlerSource() {
     return `import { createHandler, prerenderRelativePath } from './serverless-handler.mjs';
 import { loadRouteModule } from './route-modules.mjs';
 import { readFileSync, writeFileSync, mkdirSync, statSync } from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 
 const manifestPath = path.join(import.meta.dirname, 'manifest.json');
 const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
 const prerenderDir = path.join(import.meta.dirname, 'prerender');
+// The function bundle directory is read-only at runtime; only the platform
+// tmp directory accepts writes. ISR revalidations land there and are read
+// back before the bundled deploy-time prerender output.
+const isrCacheDir = path.join(os.tmpdir(), 'ruvyxa-isr-cache');
+
+const readEntry = (htmlPath, revalidate) => {
+  const html = readFileSync(htmlPath, 'utf8');
+  const stale = Date.now() - statSync(htmlPath).mtimeMs >= revalidate * 1000;
+  return { html, stale };
+};
 
 const handler = createHandler({
   routes: manifest.routes,
@@ -22,14 +33,16 @@ const handler = createHandler({
   importApi: loadRouteModule,
   readPrerendered: (pathname, revalidate = 60) => {
     // prerenderRelativePath rejects any request path that cannot be mapped to a
-    // location inside prerenderDir, so the cache read can never escape it.
+    // location inside the cache directories, so reads can never escape them.
     const relative = prerenderRelativePath(pathname);
     if (relative === null) return null;
     try {
-      const htmlPath = path.join(prerenderDir, relative);
-      const html = readFileSync(htmlPath, 'utf8');
-      const stale = Date.now() - statSync(htmlPath).mtimeMs >= revalidate * 1000;
-      return { html, stale };
+      return readEntry(path.join(isrCacheDir, relative), revalidate);
+    } catch {
+      // fall through to the bundled prerender output
+    }
+    try {
+      return readEntry(path.join(prerenderDir, relative), revalidate);
     } catch {
       return null;
     }
@@ -37,7 +50,7 @@ const handler = createHandler({
   writePrerendered: (pathname, html, revalidate) => {
     const relative = prerenderRelativePath(pathname);
     if (relative === null) return;
-    const htmlPath = path.join(prerenderDir, relative);
+    const htmlPath = path.join(isrCacheDir, relative);
     try {
       mkdirSync(path.dirname(htmlPath), { recursive: true });
       writeFileSync(htmlPath, html, 'utf8');
@@ -91,17 +104,30 @@ export function netlifyAdapter(options = {}) {
         build(ctx) {
             validateBuildContext(ctx, 'netlifyAdapter');
             const functionsDir = options.functionsDir ?? `${ctx.outDir}/netlify/functions`;
-            // Netlify.toml for the deploy directory
-            const netlifyToml = '[build]\n  publish = "publish"\n  functions = "functions"\n\n' +
-                '[[headers]]\n  for = "/client/*"\n  [headers.values]\n' +
+            // Config files are committed or read on other machines; never embed the
+            // absolute build-machine outDir in them.
+            const relativeOutDir = projectRelativeOutDir(ctx);
+            // Hashed client bundles are served under /__ruvyxa/client/ (see the
+            // chunk manifest src fields); the immutable header must match that URL.
+            const immutableHeaderToml = '[[headers]]\n  for = "/__ruvyxa/client/*"\n  [headers.values]\n' +
                 '    Cache-Control = "public, max-age=31536000, immutable"\n';
-            // Project-root netlify.toml pointing at the build output
+            // Netlify.toml for the deploy directory
+            const netlifyToml = '[build]\n  publish = "publish"\n  functions = "functions"\n\n' + immutableHeaderToml;
+            // Project-root netlify.toml pointing at the build output (opt-in)
             const projectNetlifyToml = '[build]\n' +
                 '  command = "npx --no-install ruvyxa build"\n' +
-                `  publish = "${ctx.outDir}/deploy/netlify/publish"\n` +
-                `  functions = "${ctx.outDir}/deploy/netlify/functions"\n\n` +
-                '[[headers]]\n  for = "/client/*"\n  [headers.values]\n' +
-                '    Cache-Control = "public, max-age=31536000, immutable"\n';
+                `  publish = "${relativeOutDir}/deploy/netlify/publish"\n` +
+                `  functions = "${relativeOutDir}/deploy/netlify/functions"\n\n` +
+                immutableHeaderToml;
+            // Frameworks API deploy configuration (.netlify/v1/config.json)
+            const frameworksApiConfig = JSON.stringify({
+                headers: [
+                    {
+                        for: '/__ruvyxa/client/*',
+                        values: { 'Cache-Control': 'public, max-age=31536000, immutable' },
+                    },
+                ],
+            }, null, 2);
             return {
                 name: 'netlify',
                 target: 'serverless',
@@ -112,8 +138,11 @@ export function netlifyAdapter(options = {}) {
                 functionsDir,
                 configFiles: ['netlify.toml'],
                 artifacts: [
-                    // Static assets (pre-rendered pages + client bundles)
-                    { kind: 'static-site', path: 'deploy/netlify/publish' },
+                    // Static assets (pre-rendered pages + client bundles). `optional`:
+                    // an API-only or all-SSR app has no prerendered pages; the function
+                    // still serves every route, so the missing prerender directory must
+                    // not fail the build.
+                    { kind: 'static-site', path: 'deploy/netlify/publish', optional: true },
                     // Serverless function bundle
                     {
                         kind: 'function',
@@ -126,9 +155,27 @@ export function netlifyAdapter(options = {}) {
                         path: 'deploy/netlify/netlify.toml',
                         contents: netlifyToml,
                     },
-                    ...(options.projectConfig === false
+                    // Frameworks API artifacts: Netlify discovers .netlify/v1/ at the
+                    // project root automatically, so a fresh site needs only the publish
+                    // directory set once in the dashboard — no committed config file.
+                    ...(options.frameworksApi === false
                         ? []
                         : [
+                            {
+                                kind: 'function',
+                                path: '.netlify/v1/functions/ruvyxa-handler',
+                                scope: 'project',
+                                handlerSource: netlifyHandlerSource(),
+                            },
+                            {
+                                kind: 'file',
+                                path: '.netlify/v1/config.json',
+                                scope: 'project',
+                                contents: frameworksApiConfig + '\n',
+                            },
+                        ]),
+                    ...(options.projectConfig === true
+                        ? [
                             {
                                 kind: 'file',
                                 path: 'netlify.toml',
@@ -136,7 +183,8 @@ export function netlifyAdapter(options = {}) {
                                 skipIfExists: true,
                                 contents: projectNetlifyToml,
                             },
-                        ]),
+                        ]
+                        : []),
                 ],
             };
         },

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAkBtE;;;;;;GAMG;AACH,SAAS,oBAAoB;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDR,CAAA;AACD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAA0B,EAAE;IAChE,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CACb,kEAAkE,OAAO,OAAO,CAAC,YAAY,EAAE,CAChG,CAAA;IACH,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7E,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAA;IACzF,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;QACpD,KAAK,CAAC,GAAiB;YACrB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAA;YAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,GAAG,GAAG,CAAC,MAAM,oBAAoB,CAAA;YAE9E,wCAAwC;YACxC,MAAM,WAAW,GACf,+DAA+D;gBAC/D,wDAAwD;gBACxD,6DAA6D,CAAA;YAE/D,yDAAyD;YACzD,MAAM,kBAAkB,GACtB,WAAW;gBACX,+CAA+C;gBAC/C,gBAAgB,GAAG,CAAC,MAAM,4BAA4B;gBACtD,kBAAkB,GAAG,CAAC,MAAM,gCAAgC;gBAC5D,wDAAwD;gBACxD,6DAA6D,CAAA;YAE/D,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,YAAY;gBACpB,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,aAAa;gBACjC,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,SAAS;gBACjC,GAAG,iBAAiB,CAAC,GAAG,CAAC;gBACzB,YAAY;gBACZ,WAAW,EAAE,CAAC,cAAc,CAAC;gBAC7B,SAAS,EAAE;oBACT,sDAAsD;oBACtD,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,wBAAwB,EAAE;oBACvD,6BAA6B;oBAC7B;wBACE,IAAI,EAAE,UAAU;wBAChB,IAAI,EAAE,yCAAyC;wBAC/C,aAAa,EAAE,oBAAoB,EAAE;qBACtC;oBACD,0CAA0C;oBAC1C;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,6BAA6B;wBACnC,QAAQ,EAAE,WAAW;qBACtB;oBACD,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,KAAK;wBACjC,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC;4BACE;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,cAAc;gCACpB,KAAK,EAAE,SAAS;gCAChB,YAAY,EAAE,IAAI;gCAClB,QAAQ,EAAE,kBAAkB;6BACH;yBAC5B,CAAC;iBACP;aACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,eAAe,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruvyxa/adapter-netlify",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "description": "Shape Ruvyxa builds for Netlify functions and assets with a small typed adapter contract.",
   "license": "Apache-2.0",
   "type": "module",
@@ -38,7 +38,7 @@
     }
   },
   "dependencies": {
-    "@ruvyxa/core": "^1.0.18"
+    "@ruvyxa/core": "^1.0.19"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",