@gravito/ion 4.0.1 → 4.0.3

package/README.md

@@ -7,14 +7,28 @@
 ## ✨ Key Features
 
 - **🚀 Modern Monolith Architecture**: Combine the productivity of server-side routing with the interactivity of SPA frameworks.
-- **🛠️ Zero API Development**: Pass data directly from controllers to components as typed props—no more managing endpoints or manual serialization.
-- **⚡ High-Performance Rendering**: Built-in multi-layer caching, version caching (60s TTL), and component metadata optimization.
-- **🛡️ Native Type Safety**: Full TypeScript support with generics for props, ensuring end-to-end type safety from server to client.
-- **🔗 Ecosystem Integration**: Seamlessly works with `OrbitPrism` for root templates and Gravito's session/auth modules.
-- **🔍 SEO & SSR Friendly**: Designed for modern web requirements, supporting Server-Side Rendering patterns for optimal visibility.
-- **🎨 Multi-Framework Support**: Official support for **React**, **Vue**, and **Svelte**.
+- **🌌 Galaxy-Ready Interface**: Native integration with PlanetCore for universal frontend state management across Satellites.
+- **🛠️ Zero API Development**: Pass data directly from controllers to components as typed props—no more managing endpoints.
+- **⚡ High-Performance Rendering**: Built-in multi-layer caching and versioning optimized for the Bun runtime.
+- **🛡️ Native Type Safety**: End-to-end TypeScript support with automatic generics for server-to-client propagation.
 - **✨ Inertia v2 Protocol**: Full support for deferred props, merge strategies, error bags, and CSRF protection.
 
+## 🌌 Role in Galaxy Architecture
+
+In the **Gravito Galaxy Architecture**, Ion acts as the **Neural Bridge (Monolith Interface)**.
+
+- **Unified Frontend Overlay**: Connects the `Photon` Sensing Layer directly to the UI components (React/Vue/Svelte), allowing Satellites to control the user experience without needing a complex REST/GraphQL middle layer.
+- **Context Teleporter**: Effortlessly propagates the "State of the Galaxy" (User, Auth, Permissions) from the backend IoC container directly into the frontend component tree as "Shared Props".
+- **Productivity Catalyst**: Enables rapid development of feature-rich administrative interfaces and dashboards that interact with multiple Satellites through a single "Stateful" pipeline.
+
+```mermaid
+graph LR
+    S[Satellite: Membership] -- "render('Profile', data)" --> Ion{Ion Bridge}
+    Ion -->|Teleport State| UI[Frontend: React/Vue]
+    UI -->|XHR Request| Photon[Photon Sensing Layer]
+    Photon --> S
+```
+
 ## 📦 Installation
 
 ```bash
@@ -75,6 +89,14 @@ export class DashboardController {
 }
 ```
 
+## 📚 Documentation
+
+Detailed guides and references for the Galaxy Architecture:
+
+- [🏗️ **Architecture Overview**](./README.md) — Inertia.js integration and monolith bridge.
+- [🌉 **Modern Monolith**](./doc/MODERN_MONOLITH.md) — **NEW**: Zero-API philosophy, shared props, and deferred loading.
+- [✨ **Inertia v2 Protocol**](#-inertia-v2-protocol-features) — New protocol features and migration.
+
 ## 🔧 Inertia v2 Protocol Features
 
 ### Deferred Props (Lazy Loading)

package/dist/index.cjs

@@ -1,4 +1,3 @@
-"use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -30,6 +29,9 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/InertiaService.ts
+var import_core = require("@gravito/core");
+
 // src/errors.ts
 var InertiaError = class extends Error {
   constructor(code, httpStatus = 500, details) {
@@ -102,6 +104,15 @@ var InertiaService = class {
   clearHistoryFlag = false;
   logLevel;
   onRenderCallback;
+  escapeHtml = (0, import_core.getEscapeHtml)();
+  appendVaryHeader(...values) {
+    const existing = this.context.res?.headers?.get?.("Vary") ?? "";
+    const current = existing.split(",").map((value) => value.trim()).filter(Boolean);
+    const merged = Array.from(/* @__PURE__ */ new Set([...current, ...values]));
+    if (merged.length > 0) {
+      this.context.header("Vary", merged.join(", "));
+    }
+  }
   /**
    * Creates a deferred prop that will be loaded after the initial render.
    *
@@ -194,7 +205,7 @@ var InertiaService = class {
    * @returns Safely escaped HTML attribute value.
    */
   escapeForSingleQuotedHtmlAttribute(value) {
-    return value.replace(/&/g, "&amp;").replace(/\\"/g, "\\&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/'/g, "&#039;");
+    return this.escapeHtml(value).replace(/\\"/g, "\\&quot;");
   }
   /**
    * Renders an Inertia component and returns the appropriate HTTP response.
@@ -367,7 +378,7 @@ var InertiaService = class {
           return new Response("", { status: 409 });
         }
         this.context.header("X-Inertia", "true");
-        this.context.header("Vary", "Accept");
+        this.appendVaryHeader("Accept", "X-Inertia");
         response = this.context.json(page, status);
       } else {
         const view = this.context.get("view");
@@ -553,6 +564,7 @@ var InertiaService = class {
   location(url) {
     const isInertiaRequest = Boolean(this.context.req.header("X-Inertia"));
     if (isInertiaRequest) {
+      this.appendVaryHeader("X-Inertia");
       this.context.header("X-Inertia-Location", url);
       return new Response("", { status: 409 });
     }

package/dist/index.d.cts

@@ -255,6 +255,8 @@ declare class InertiaService {
     private clearHistoryFlag;
     private readonly logLevel;
     private readonly onRenderCallback?;
+    private escapeHtml;
+    private appendVaryHeader;
     /**
      * Creates a deferred prop that will be loaded after the initial render.
      *
@@ -485,14 +487,14 @@ declare class InertiaService {
 declare class InertiaError extends Error {
     readonly code: string;
     readonly httpStatus: number;
-    readonly details?: Record<string, any> | undefined;
-    constructor(code: string, httpStatus?: number, details?: Record<string, any> | undefined);
+    readonly details?: Record<string, any>;
+    constructor(code: string, httpStatus?: number, details?: Record<string, any>);
     toJSON(): {
         name: string;
         code: string;
         httpStatus: number;
         message: string;
-        details: Record<string, any> | undefined;
+        details: Record<string, any>;
     };
 }
 /**

package/dist/index.d.ts

@@ -255,6 +255,8 @@ declare class InertiaService {
     private clearHistoryFlag;
     private readonly logLevel;
     private readonly onRenderCallback?;
+    private escapeHtml;
+    private appendVaryHeader;
     /**
      * Creates a deferred prop that will be loaded after the initial render.
      *
@@ -485,14 +487,14 @@ declare class InertiaService {
 declare class InertiaError extends Error {
     readonly code: string;
     readonly httpStatus: number;
-    readonly details?: Record<string, any> | undefined;
-    constructor(code: string, httpStatus?: number, details?: Record<string, any> | undefined);
+    readonly details?: Record<string, any>;
+    constructor(code: string, httpStatus?: number, details?: Record<string, any>);
     toJSON(): {
         name: string;
         code: string;
         httpStatus: number;
         message: string;
-        details: Record<string, any> | undefined;
+        details: Record<string, any>;
     };
 }
 /**

package/dist/index.js

@@ -1,3 +1,6 @@
+// src/InertiaService.ts
+import { getEscapeHtml } from "@gravito/core";
+
 // src/errors.ts
 var InertiaError = class extends Error {
   constructor(code, httpStatus = 500, details) {
@@ -70,6 +73,15 @@ var InertiaService = class {
   clearHistoryFlag = false;
   logLevel;
   onRenderCallback;
+  escapeHtml = getEscapeHtml();
+  appendVaryHeader(...values) {
+    const existing = this.context.res?.headers?.get?.("Vary") ?? "";
+    const current = existing.split(",").map((value) => value.trim()).filter(Boolean);
+    const merged = Array.from(/* @__PURE__ */ new Set([...current, ...values]));
+    if (merged.length > 0) {
+      this.context.header("Vary", merged.join(", "));
+    }
+  }
   /**
    * Creates a deferred prop that will be loaded after the initial render.
    *
@@ -162,7 +174,7 @@ var InertiaService = class {
    * @returns Safely escaped HTML attribute value.
    */
   escapeForSingleQuotedHtmlAttribute(value) {
-    return value.replace(/&/g, "&amp;").replace(/\\"/g, "\\&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/'/g, "&#039;");
+    return this.escapeHtml(value).replace(/\\"/g, "\\&quot;");
   }
   /**
    * Renders an Inertia component and returns the appropriate HTTP response.
@@ -335,7 +347,7 @@ var InertiaService = class {
           return new Response("", { status: 409 });
         }
         this.context.header("X-Inertia", "true");
-        this.context.header("Vary", "Accept");
+        this.appendVaryHeader("Accept", "X-Inertia");
         response = this.context.json(page, status);
       } else {
         const view = this.context.get("view");
@@ -521,6 +533,7 @@ var InertiaService = class {
   location(url) {
     const isInertiaRequest = Boolean(this.context.req.header("X-Inertia"));
     if (isInertiaRequest) {
+      this.appendVaryHeader("X-Inertia");
       this.context.header("X-Inertia-Location", url);
       return new Response("", { status: 409 });
     }

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@gravito/ion",
-  "version": "4.0.1",
+  "sideEffects": false,
+  "version": "4.0.3",
   "description": "Inertia.js v2 adapter for Gravito",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -8,6 +9,7 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "bun": "./dist/index.js",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
@@ -20,6 +22,7 @@
   ],
   "scripts": {
     "build": "bun run build.ts",
+    "build:dts": "bun run build.ts --dts-only",
     "test": "bun test --timeout=10000",
     "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck",
     "test:coverage": "bun test --timeout=10000 --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run --bun scripts/check-coverage.ts",
@@ -28,13 +31,13 @@
     "test:integration": "test $(find tests -name '*.integration.test.ts' 2>/dev/null | wc -l) -gt 0 && find tests -name '*.integration.test.ts' -print0 | xargs -0 bun test --timeout=10000 || echo 'No integration tests found'"
   },
   "peerDependencies": {
-    "@gravito/core": "^1.6.1",
-    "@gravito/photon": "^1.0.1"
+    "@gravito/core": "^2.0.0",
+    "@gravito/photon": "^1.1.0"
   },
   "devDependencies": {
     "bun-types": "latest",
-    "@gravito/core": "^1.6.1",
-    "@gravito/photon": "^1.0.1",
+    "@gravito/core": "workspace:*",
+    "@gravito/photon": "workspace:*",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },