@platformatic/next 3.31.0 → 3.32.0-alpha.1

package/config.d.ts

@@ -293,6 +293,18 @@ export interface PlatformaticNextJsConfig {
           maxSize?: number;
           maxEntrySize?: number;
           maxCount?: number;
+          /**
+           * Whitelist of origins to cache. Supports exact strings and regex patterns (e.g., "/https:\\/\\/.*\\.example\\.com/").
+           */
+          origins?: string[];
+          /**
+           * Default cache duration in seconds for responses without explicit expiration headers.
+           */
+          cacheByDefault?: number;
+          /**
+           * Cache type. "shared" caches may be shared between users, "private" caches are user-specific.
+           */
+          type?: "shared" | "private";
           [k: string]: unknown;
         };
     watch?: boolean | string;

package/lib/capability.js

@@ -13,6 +13,7 @@ import { ChildProcess } from 'node:child_process'
 import { once } from 'node:events'
 import { existsSync } from 'node:fs'
 import { glob, readFile, writeFile } from 'node:fs/promises'
+import { createRequire } from 'node:module'
 import { dirname, resolve as resolvePath, sep } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { parse, satisfies } from 'semver'
@@ -32,6 +33,7 @@ export class NextCapability extends BaseCapability {
   #child
   #server
   #configModified
+  #isStandalone
 
   constructor (root, config, context) {
     super('next', version, root, config, context)
@@ -42,6 +44,20 @@ export class NextCapability extends BaseCapability {
   async init () {
     await super.init()
 
+    if (this.isProduction) {
+      try {
+        const buildInfo = JSON.parse(await readFile(resolvePath(this.root, '.platformatic-build.json'), 'utf-8'))
+
+        if (buildInfo.standalone) {
+          this.#isStandalone = true
+          this.#nextVersion = parse(buildInfo.version)
+        }
+        return
+      } catch (error) {
+        // No-op
+      }
+    }
+
     // This is needed to avoid Next.js to throw an error when the lockfile is not correct
     // and the user is using npm but has pnpm in its $PATH.
     //
@@ -253,11 +269,10 @@ export class NextCapability extends BaseCapability {
       this.#getChildManagerScripts()
     )
 
-    this.verifyOutputDirectory(resolvePath(this.root, '.next'))
-
-    if (existsSync(resolvePath(this.root, '.next/standalone'))) {
+    if (this.#isStandalone) {
       return this.#startProductionStandaloneNext()
     } else {
+      this.verifyOutputDirectory(resolvePath(this.root, '.next'))
       return this.#startProductionNext()
     }
   }
@@ -300,19 +315,17 @@ export class NextCapability extends BaseCapability {
   }
 
   async #startProductionStandaloneNext () {
-    const rootDir = resolvePath(this.root, '.next', 'standalone')
-
     // If built in standalone mode, the generated standalone directory is not on the root of the project but somewhere
     // inside .next/standalone due to turbopack limitations in determining the root of the project.
     // In that case we search a server.js next to a .next folder inside the .next /standalone folder.
     const serverEntrypoints = await Array.fromAsync(
-      glob(['**/server.js'], { cwd: rootDir, ignore: ['node_modules', '**/node_modules/**'] })
+      glob(['**/server.js'], { cwd: this.root, ignore: ['node_modules', '**/node_modules/**'] })
     )
 
     let serverEntrypoint
     for (const entrypoint of serverEntrypoints) {
-      if (existsSync(resolvePath(rootDir, dirname(entrypoint), '.next'))) {
-        serverEntrypoint = resolvePath(rootDir, entrypoint)
+      if (existsSync(resolvePath(this.root, dirname(entrypoint), '.next'))) {
+        serverEntrypoint = resolvePath(this.root, entrypoint)
         break
       }
     }
@@ -370,7 +383,9 @@ export class NextCapability extends BaseCapability {
 
       // This is needed by Next.js standalone server to pick up the correct configuration
       process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
-      const { startServer } = await importFile(resolvePath(this.#next, './dist/server/lib/start-server.js'))
+      const require = createRequire(serverEntrypoint)
+      const serverModule = require('next/dist/server/lib/start-server.js')
+      const { startServer } = serverModule.default ?? serverModule
 
       await startServer({
         dir: dirname(serverEntrypoint),
@@ -450,6 +465,16 @@ export class NextCapability extends BaseCapability {
         await writeFile(requiredServerFilesPath, JSON.stringify(requiredServerFiles, null, 2))
       }
     }
+
+    // This is needed to allow to have a standalone server working correctly
+    if (existsSync(resolvePath(distDir, 'standalone'))) {
+      await writeFile(
+        resolvePath(distDir, 'standalone/.platformatic-build.json'),
+        JSON.stringify({ standalone: true, version: this.#nextVersion.version }),
+        'utf-8'
+      )
+    }
+
     return distDir
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/next",
-  "version": "3.31.0",
+  "version": "3.32.0-alpha.1",
   "description": "Platformatic Next.js Capability",
   "main": "index.js",
   "type": "module",
@@ -23,8 +23,8 @@
     "iovalkey": "^0.3.0",
     "msgpackr": "^1.11.2",
     "semver": "^7.6.3",
-    "@platformatic/basic": "3.31.0",
-    "@platformatic/foundation": "3.31.0"
+    "@platformatic/basic": "3.32.0-alpha.1",
+    "@platformatic/foundation": "3.32.0-alpha.1"
   },
   "devDependencies": {
     "@fastify/reply-from": "^12.0.0",
@@ -40,8 +40,8 @@
     "next": "^16.0.0",
     "typescript": "^5.5.4",
     "ws": "^8.18.0",
-    "@platformatic/gateway": "3.31.0",
-    "@platformatic/service": "3.31.0"
+    "@platformatic/gateway": "3.32.0-alpha.1",
+    "@platformatic/service": "3.32.0-alpha.1"
   },
   "engines": {
     "node": ">=22.19.0"

package/schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://schemas.platformatic.dev/@platformatic/next/3.31.0.json",
+  "$id": "https://schemas.platformatic.dev/@platformatic/next/3.32.0-alpha.1.json",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "Platformatic Next.js Config",
   "type": "object",
@@ -1363,6 +1363,26 @@
                 },
                 "maxCount": {
                   "type": "integer"
+                },
+                "origins": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Whitelist of origins to cache. Supports exact strings and regex patterns (e.g., \"/https:\\\\/\\\\/.*\\\\.example\\\\.com/\")."
+                },
+                "cacheByDefault": {
+                  "type": "integer",
+                  "description": "Default cache duration in seconds for responses without explicit expiration headers."
+                },
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "shared",
+                    "private"
+                  ],
+                  "default": "shared",
+                  "description": "Cache type. \"shared\" caches may be shared between users, \"private\" caches are user-specific."
                 }
               }
             }