@dokebi/template-inertia 0.4.2 → 0.4.4

package/options.schema.json

@@ -5,7 +5,8 @@
   "properties": {
     "version": {
       "type": "string",
-      "description": "Asset version sent with every page; a client with another one reloads (409). Unset: development (and a warning)."
+      "pattern": "^(?:[\\x21-\\x7e](?:[\\x20-\\x7e]{0,126}[\\x21-\\x7e])?)?$",
+      "description": "Asset version sent with every page; a client with another one reloads (409). Unset: development (and a warning). Up to 128 printable ASCII characters without leading or trailing spaces: the client sends it back in the X-Inertia-Version header."
     },
     "rootId": {
       "type": "string",
@@ -82,6 +83,13 @@
           "minLength": 1,
           "pattern": "^(?!.*\\.\\.)",
           "description": "Development (D-0045): source module of the bundle rendered through Vite, e.g. src/apps/admin/views/ssr.js. Default: ssr.js beside vite.entry"
+        },
+        "timeoutMs": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 600000,
+          "default": 5000,
+          "description": "How long one render(page) may take in ms; past it the render fails with SSR_TIMEOUT, handled as failure says (fallback: the client-rendered page). Size it above your slowest page render (D-0107)"
         }
       },
       "required": [
@@ -89,6 +97,24 @@
       ],
       "description": "Render the first HTML of each page on the server (D-0039) with the SSR build output, imported once at start. A missing bundle stops the start."
     },
+    "devHosts": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "maxLength": 254,
+        "pattern": "^\\.?[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)*$"
+      },
+      "maxItems": 256,
+      "default": [],
+      "description": "Development (DOKEBI_VITE_DEV=1): host names besides loopback names, IP addresses and @dokebi/app domains that may load the Vite dev routes, such as a tunnel host; .example.com also allows its subdomains (D-0107)"
+    },
+    "devDepsRepairIntervalMs": {
+      "type": "integer",
+      "minimum": 1000,
+      "maximum": 3600000,
+      "default": 10000,
+      "description": "Development (dokebi dev): the Vite dev host re-optimizes the pre-bundled dependencies (node_modules/.vite/deps) when they changed on disk under it, at most once per this many ms; a cache that keeps changing faster is reported with INERTIA_VITE_DEPS_CHANGING (D-0128). Read by the host when dokebi dev starts."
+    },
     "encryptHistory": {
       "anyOf": [
         {
@@ -101,10 +127,110 @@
       "default": "sealed",
       "description": "Inertia history encryption (D-0062): true, false, or sealed (default) = on for requests of seal hosts"
     },
+    "viteManifestMaxBytes": {
+      "type": "integer",
+      "minimum": 1024,
+      "maximum": 67108864,
+      "default": 4194304,
+      "description": "Largest Vite build manifest read at start; a larger one stops the start with VITE_MANIFEST_INVALID (D-0114). An app with thousands of chunks may need more."
+    },
+    "assetCacheMaxBytes": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 67108864,
+      "default": 4194304,
+      "description": "Built files up to this size are kept in memory after their first request; larger ones are streamed from disk on every request (D-0114). 0 streams every file. Memory is at most the sum of the built files at or below it."
+    },
+    "logRepeatWindowMs": {
+      "type": "integer",
+      "minimum": 1000,
+      "maximum": 3600000,
+      "default": 10000,
+      "description": "Window of the repeated per-request failure logs (an SSR render that failed, a shared-data or flash hook that threw) in ms: the first is logged in full, the rest of the window are counted (D-0114)."
+    },
+    "bootFallback": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Show the text in the root of the first HTML (false: an empty root, as before)"
+        },
+        "timeoutMs": {
+          "type": "integer",
+          "minimum": 1000,
+          "maximum": 120000,
+          "default": 10000,
+          "description": "How long \"loading\" shows before \"could not load — reload\" (ms)"
+        },
+        "messages": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "loading": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              },
+              "failed": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              },
+              "reload": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              }
+            }
+          },
+          "description": "Texts by language tag of <html lang> (ko, en, pt-BR) over the built-in Korean and English ones"
+        },
+        "stylesheet": {
+          "type": "string",
+          "maxLength": 2048,
+          "pattern": "^\\/[^/]",
+          "description": "A local stylesheet (/assets/boot.css) linked right after the built-in style: the app's own look of the box ([data-dokebi-boot] selectors), shown before any script of the app runs, also under dokebi dev"
+        },
+        "logo": {
+          "type": "string",
+          "maxLength": 2048,
+          "pattern": "^\\/[^/]",
+          "description": "A local image (/assets/logo.svg) above the spinner and the could-not-load text of the box, decorative (alt is empty)"
+        }
+      },
+      "default": {
+        "enabled": true,
+        "timeoutMs": 10000
+      },
+      "description": "The first HTML while the app loads (Studio v2): a centered spinner (\"loading\" for screen readers), then \"could not load\" with a reload button after timeoutMs (by CSS, also under a CSP without inline scripts) or at once when the entry script fails to load; stylesheet restyles it. Not on a server-rendered page."
+    },
     "errorPage": {
       "type": "string",
       "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*(?:\\/[A-Za-z0-9][A-Za-z0-9_-]*)*$",
       "description": "Page component (for example Error) rendered with { status, error, message, hint } for error answers of Inertia visits and full page loads (D-0074). Unset: JSON for visits, a small HTML page for page loads."
+    },
+    "routeIds": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "assets": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$",
+          "x-dokebi-secret": false,
+          "description": "Id of the GET routes of the built files of vite.manifest (one per file); default template-inertia.assets"
+        },
+        "viteDev": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$",
+          "x-dokebi-secret": false,
+          "description": "Id of the GET <vite base>* routes of the Vite dev server (dokebi dev, one per base); default template-inertia.viteDev"
+        }
+      },
+      "description": "Ids of the routes dokebi-template-inertia adds (D-0142), by route key: assets (default template-inertia.assets), viteDev (default template-inertia.viteDev). An id is 1-64 letters, digits, '.', '_' or '-' starting with a letter; an id another route of the same app has fails the start (DUPLICATE_ROUTE_ID)"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dokebi/template-inertia",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Inertia v3 server adapter for Dokebi: page JSON, Vite manifest assets and optional server-side rendering.",
   "keywords": [
     "dokebi",
@@ -21,7 +21,19 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./vite-host": "./dist/vite-host.js"
+    "./vite": {
+      "types": "./dist/vite-plugin.d.ts",
+      "import": "./dist/vite-plugin.js"
+    },
+    "./vite-host": "./dist/vite-host.js",
+    "./prune": {
+      "types": "./dist/prune.d.ts",
+      "import": "./dist/prune.js"
+    },
+    "./i18n": {
+      "types": "./dist/i18n.d.ts",
+      "import": "./dist/i18n.js"
+    }
   },
   "files": [
     "dist",
@@ -35,23 +47,29 @@
     "node": ">=24.0.0"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json && node -e \"import('./dist/options.js').then(async (m) => { const { renderOptionsSchema } = await import('@dokebi/core'); process.stdout.write(renderOptionsSchema(m.options)); })\" > options.schema.json",
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.i18n.json && node -e \"import('./dist/options.js').then(async (m) => { const { renderOptionsSchema } = await import('@dokebi/core'); process.stdout.write(renderOptionsSchema(m.options)); })\" > options.schema.json",
     "typecheck": "tsc -p tsconfig.test.json --noEmit",
     "test": "node -e \"require('node:fs').rmSync('.tmp/tests',{recursive:true,force:true})\" && tsc -p tsconfig.test.json && node --test .tmp/tests/tests/*.test.js"
   },
   "peerDependencies": {
-    "@dokebi/core": "^0.4.0",
-    "@dokebi/web": "^0.4.2",
-    "fastify": "^5.12.7"
+    "@dokebi/core": "^0.4.2",
+    "@dokebi/web": "^0.4.3",
+    "fastify": "^5.12.7",
+    "vue": "^3.5.0"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    }
   },
   "dokebi": {
     "schemaVersion": 2,
     "id": "dokebi-template-inertia",
-    "core": "^0.4.0",
+    "core": "^0.4.2",
     "dependencies": [
       {
         "name": "dokebi-web",
-        "version": "^0.4.2"
+        "version": "^0.4.3"
       },
       {
         "name": "dokebi-session",
@@ -62,6 +80,9 @@
     "contributes": [
       "dokebi-web:view-engine"
     ],
+    "collects": [
+      "dokebi-web:view-data"
+    ],
     "install": {
       "entry": {
         "source": "templates/shared.ts",
@@ -109,12 +130,18 @@
       "Vue and Vite are not server dependencies (they are dev dependencies of the app)"
     ],
     "recipes": [
-      "blog"
+      "blog",
+      "site"
     ]
   },
   "devDependencies": {
-    "@dokebi/session": "0.4.1",
-    "@dokebi/web": "0.4.2"
+    "@dokebi/i18n": "0.2.0",
+    "@dokebi/session": "0.4.4",
+    "@dokebi/web": "0.4.3",
+    "@dokebi/websocket": "0.4.2",
+    "@dokebi/websocket-hub": "0.4.2",
+    "@inertiajs/vue3": "3.9.1",
+    "vue": "3.5.44"
   },
   "publishConfig": {
     "access": "public",