@dokebi/template-inertia 0.2.0 → 0.4.1

package/options.schema.json

@@ -4,34 +4,37 @@
   "additionalProperties": false,
   "properties": {
     "version": {
-      "type": "string"
+      "type": "string",
+      "description": "Asset version sent with every page; a client with another one reloads (409). Unset: development (and a warning)."
     },
     "rootId": {
       "type": "string",
-      "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
+      "pattern": "^[A-Za-z][A-Za-z0-9_-]*$",
+      "description": "Id of the element the client app mounts on (default app)."
     },
     "title": {
-      "type": "string"
+      "type": "string",
+      "description": "Document title of the first HTML."
     },
     "scripts": {
       "type": "array",
       "items": {
         "type": "string",
-        "pattern": "^/[^/]"
-      }
+        "pattern": "^\\/[^/]"
+      },
+      "description": "Module scripts of the first HTML."
     },
     "styles": {
       "type": "array",
       "items": {
         "type": "string",
-        "pattern": "^/[^/]"
-      }
+        "pattern": "^\\/[^/]"
+      },
+      "description": "Stylesheets of the first HTML."
     },
     "vite": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["manifest", "entry"],
-      "description": "Read scripts, styles and version from a Vite build manifest at startup. Replaces version, scripts and styles.",
       "properties": {
         "manifest": {
           "type": "string",
@@ -45,16 +48,20 @@
         },
         "base": {
           "type": "string",
-          "pattern": "^/(?:[^/\\\\\\s]+/)*$",
+          "pattern": "^\\/(?:[^/\\\\\\s]+\\/)*$",
+          "default": "/",
           "description": "URL prefix of the built files (default /)"
         }
-      }
+      },
+      "required": [
+        "manifest",
+        "entry"
+      ],
+      "description": "Read scripts, styles and version from a Vite build manifest at startup. Replaces version, scripts and styles."
     },
     "ssr": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["bundle"],
-      "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.",
       "properties": {
         "bundle": {
           "type": "string",
@@ -62,14 +69,28 @@
           "description": "SSR build output that exports render(page), relative to the working directory, e.g. dist/ssr/<app>/ssr.js"
         },
         "failure": {
-          "enum": ["fallback", "error"],
+          "type": "string",
+          "enum": [
+            "fallback",
+            "error"
+          ],
+          "default": "fallback",
           "description": "When render throws: answer the client-rendered page and log (fallback, default) or fail the request (error)"
+        },
+        "entry": {
+          "type": "string",
+          "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"
         }
-      }
+      },
+      "required": [
+        "bundle"
+      ],
+      "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."
     },
     "encryptHistory": {
-      "default": "sealed",
-      "oneOf": [
+      "anyOf": [
         {
           "type": "boolean"
         },
@@ -77,7 +98,13 @@
           "const": "sealed"
         }
       ],
+      "default": "sealed",
       "description": "Inertia history encryption (D-0062): true, false, or sealed (default) = on for requests of seal hosts"
+    },
+    "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."
     }
   }
 }

package/package.json

@@ -1,6 +1,16 @@
 {
   "name": "@dokebi/template-inertia",
-  "version": "0.2.0",
+  "version": "0.4.1",
+  "description": "Inertia v3 server adapter for Dokebi: page JSON, Vite manifest assets and optional server-side rendering.",
+  "keywords": [
+    "dokebi",
+    "dokebi-plugin",
+    "web",
+    "views",
+    "inertia",
+    "vue",
+    "ssr"
+  ],
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -10,7 +20,8 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    }
+    },
+    "./vite-host": "./dist/vite-host.js"
   },
   "files": [
     "dist",
@@ -24,30 +35,33 @@
     "node": ">=24.0.0"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "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",
     "typecheck": "tsc -p tsconfig.test.json --noEmit",
-    "test": "tsc -p tsconfig.test.json && node --test .tmp/tests/tests/*.test.js"
+    "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.2.0",
-    "@dokebi/web": "^0.2.0",
+    "@dokebi/core": "^0.4.0",
+    "@dokebi/web": "^0.4.1",
     "fastify": "^5.12.7"
   },
   "dokebi": {
     "schemaVersion": 2,
     "id": "dokebi-template-inertia",
-    "core": "^0.2.0",
+    "core": "^0.4.0",
     "dependencies": [
       {
         "name": "dokebi-web",
-        "version": "^0.2.0"
+        "version": "^0.4.1"
       },
       {
         "name": "dokebi-session",
-        "version": "^0.1.0 || ^0.2.0",
+        "version": "^0.4.0",
         "optional": true
       }
     ],
+    "contributes": [
+      "dokebi-web:view-engine"
+    ],
     "install": {
       "entry": {
         "source": "templates/shared.ts",
@@ -57,9 +71,50 @@
     "optionsSchema": "options.schema.json",
     "documentation": "AI.md"
   },
+  "dokebiCatalog": {
+    "kind": "plugin",
+    "summary": "Inertia (v3) server adapter: Vue 3 views, Vite build files and optional server-side rendering (SSR)",
+    "maturity": "preview",
+    "provides": [],
+    "variants": [
+      {
+        "name": "vue",
+        "capability": "view.inertia-vue",
+        "alsoInstalls": [
+          "vite",
+          "vue",
+          "@inertiajs/vue3",
+          "@vitejs/plugin-vue"
+        ],
+        "needs": [
+          "vite-build"
+        ]
+      },
+      {
+        "name": "vue-ssr",
+        "capability": "view.inertia-vue-ssr",
+        "alsoInstalls": [
+          "vite",
+          "vue",
+          "@inertiajs/vue3",
+          "@vitejs/plugin-vue"
+        ],
+        "needs": [
+          "vite-build"
+        ]
+      }
+    ],
+    "doesNot": [
+      "No React skeleton",
+      "Vue and Vite are not server dependencies (they are dev dependencies of the app)"
+    ],
+    "recipes": [
+      "blog"
+    ]
+  },
   "devDependencies": {
-    "@dokebi/session": "0.2.0",
-    "@dokebi/web": "0.2.0"
+    "@dokebi/session": "0.4.0",
+    "@dokebi/web": "0.4.1"
   },
   "publishConfig": {
     "access": "public",

package/dist/repeats.d.ts

@@ -1,18 +0,0 @@
-/**
- * The full text of a caught value for the `error` log field (D-0047): name, whole message and
- * stack, then each `cause` the same way. Only credentials in URLs (`//user:password@`) are
- * removed; a text over 16 KB is cut and marked.
- */
-export declare function errorText(error: unknown): string;
-/** How often a repeating error of the same kind is logged; repeats in between are counted. */
-export declare const REPEAT_INTERVAL_MS = 10000;
-/**
- * Counts repeats of the same error key so a per-request path logs it once per interval (D-0047).
- * The first occurrence is logged; later ones inside the interval are only counted and reported
- * with the next logged occurrence of that key.
- */
-export declare class Repeats {
-    #private;
-    /** The repeats to report with this occurrence, or undefined when it is only counted. */
-    take(key: string, now?: number): number | undefined;
-}

package/dist/repeats.js

@@ -1,52 +0,0 @@
-/**
- * The full text of a caught value for the `error` log field (D-0047): name, whole message and
- * stack, then each `cause` the same way. Only credentials in URLs (`//user:password@`) are
- * removed; a text over 16 KB is cut and marked.
- */
-export function errorText(error) {
-    const parts = [];
-    let current = error;
-    for (let depth = 0; current !== undefined && depth < 5; depth++) {
-        let text;
-        if (current instanceof Error)
-            text = current.stack ?? `${current.name}: ${current.message}`;
-        else if (typeof current === 'string')
-            text = current;
-        else {
-            try {
-                text = `NonError: ${JSON.stringify(current)}`;
-            }
-            catch {
-                text = `NonError: ${String(current)}`; // not serialisable (cycle, BigInt): its string form
-            }
-        }
-        parts.push(depth ? `Caused by: ${text}` : text);
-        current = current instanceof Error ? current.cause : undefined;
-    }
-    const text = parts.join('\n').replace(/\/\/[^\s/@]*@/g, '//***@');
-    return text.length > 16_384
-        ? `${text.slice(0, 16_384)}… [truncated ${text.length - 16_384} characters]`
-        : text;
-}
-/** How often a repeating error of the same kind is logged; repeats in between are counted. */
-export const REPEAT_INTERVAL_MS = 10_000;
-/**
- * Counts repeats of the same error key so a per-request path logs it once per interval (D-0047).
- * The first occurrence is logged; later ones inside the interval are only counted and reported
- * with the next logged occurrence of that key.
- */
-export class Repeats {
-    #keys = new Map();
-    /** The repeats to report with this occurrence, or undefined when it is only counted. */
-    take(key, now = Date.now()) {
-        const entry = this.#keys.get(key);
-        if (entry && now < entry.until) {
-            entry.repeated++;
-            return undefined;
-        }
-        if (!entry && this.#keys.size >= 256)
-            this.#keys.clear();
-        this.#keys.set(key, { until: now + REPEAT_INTERVAL_MS, repeated: 0 });
-        return entry?.repeated ?? 0;
-    }
-}