@platformatic/next 3.32.0-alpha.0 → 3.32.0-alpha.1

package/config.d.ts

@@ -8,7 +8,7 @@
 export interface PlatformaticNextJsConfig {
   $schema?: string;
   logger?: {
-    level: (
+    level?: (
       | ("fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent")
       | {
           [k: string]: unknown;
@@ -139,7 +139,7 @@ export interface PlatformaticNextJsConfig {
         };
     workersRestartDelay?: number | string;
     logger?: {
-      level: (
+      level?: (
         | ("fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent")
         | {
             [k: string]: unknown;
@@ -242,7 +242,6 @@ export interface PlatformaticNextJsConfig {
       maxHeapTotal?: number | string;
       maxYoungGeneration?: number | string;
       codeRangeSize?: number | string;
-      noHeapCheck?: boolean | string;
     };
     undici?: {
       agentOptions?: {
@@ -294,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;
@@ -523,6 +534,18 @@ export interface PlatformaticNextJsConfig {
         [k: string]: string | [string, ...string[]];
       };
     };
+    compileCache?:
+      | boolean
+      | {
+          /**
+           * Enable Node.js module compile cache for faster startup
+           */
+          enabled?: boolean;
+          /**
+           * Directory to store compile cache. Defaults to .plt/compile-cache in app root
+           */
+          directory?: string;
+        };
     application?: {
       reuseTcpPorts?: boolean;
       workers?:
@@ -546,7 +569,6 @@ export interface PlatformaticNextJsConfig {
         maxHeapTotal?: number | string;
         maxYoungGeneration?: number | string;
         codeRangeSize?: number | string;
-        noHeapCheck?: boolean | string;
       };
       arguments?: string[];
       env?: {
@@ -582,6 +604,18 @@ export interface PlatformaticNextJsConfig {
         )[];
         [k: string]: unknown;
       };
+      compileCache?:
+        | boolean
+        | {
+            /**
+             * Enable Node.js module compile cache for faster startup
+             */
+            enabled?: boolean;
+            /**
+             * Directory to store compile cache. Defaults to .plt/compile-cache in app root
+             */
+            directory?: string;
+          };
     };
   };
   next?: {

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.32.0-alpha.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.32.0-alpha.0",
-    "@platformatic/foundation": "3.32.0-alpha.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.32.0-alpha.0",
-    "@platformatic/service": "3.32.0-alpha.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.32.0-alpha.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",
@@ -12,7 +12,6 @@
       "properties": {
         "level": {
           "type": "string",
-          "default": "info",
           "oneOf": [
             {
               "enum": [
@@ -155,9 +154,6 @@
           "additionalProperties": true
         }
       },
-      "required": [
-        "level"
-      ],
       "default": {},
       "additionalProperties": true
     },
@@ -574,16 +570,6 @@
                         "type": "string"
                       }
                     ]
-                  },
-                  "noHeapCheck": {
-                    "anyOf": [
-                      {
-                        "type": "boolean"
-                      },
-                      {
-                        "type": "string"
-                      }
-                    ]
                   }
                 },
                 "additionalProperties": false
@@ -708,6 +694,28 @@
                     }
                   }
                 }
+              },
+              "compileCache": {
+                "anyOf": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "enabled": {
+                        "type": "boolean",
+                        "default": true,
+                        "description": "Enable Node.js module compile cache for faster startup"
+                      },
+                      "directory": {
+                        "type": "string",
+                        "description": "Directory to store compile cache. Defaults to .plt/compile-cache in app root"
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                ]
               }
             }
           }
@@ -787,7 +795,6 @@
           "properties": {
             "level": {
               "type": "string",
-              "default": "info",
               "oneOf": [
                 {
                   "enum": [
@@ -930,9 +937,6 @@
               "additionalProperties": true
             }
           },
-          "required": [
-            "level"
-          ],
           "default": {},
           "additionalProperties": true
         },
@@ -1228,17 +1232,6 @@
                 }
               ],
               "default": 268435456
-            },
-            "noHeapCheck": {
-              "anyOf": [
-                {
-                  "type": "boolean"
-                },
-                {
-                  "type": "string"
-                }
-              ],
-              "default": false
             }
           },
           "additionalProperties": false
@@ -1370,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."
                 }
               }
             }
@@ -1985,6 +1998,28 @@
           ],
           "additionalProperties": false
         },
+        "compileCache": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Enable Node.js module compile cache for faster startup"
+                },
+                "directory": {
+                  "type": "string",
+                  "description": "Directory to store compile cache. Defaults to .plt/compile-cache in app root"
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
         "application": {
           "type": "object",
           "properties": {
@@ -2132,16 +2167,6 @@
                       "type": "string"
                     }
                   ]
-                },
-                "noHeapCheck": {
-                  "anyOf": [
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "type": "string"
-                    }
-                  ]
                 }
               },
               "additionalProperties": false
@@ -2259,6 +2284,28 @@
                   }
                 }
               }
+            },
+            "compileCache": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean",
+                      "default": true,
+                      "description": "Enable Node.js module compile cache for faster startup"
+                    },
+                    "directory": {
+                      "type": "string",
+                      "description": "Directory to store compile cache. Defaults to .plt/compile-cache in app root"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              ]
             }
           },
           "additionalProperties": false