@ezetgalaxy/titan 26.15.1 → 26.15.3

package/README.md

@@ -1,56 +1,84 @@
+<p align="center">
+  <a href="https://titan-docs-ez.vercel.app/" target="_blank">
+    <img src="https://i.ibb.co/VpBsTg6m/tpl-Logo.png" width="120" alt="TitanPl Logo" />
+  </a>
+</p>
 
-```
-████████╗██╗████████╗ █████╗ ███╗   ██╗   ██████╗  ██████╗ ██████╗  ██████╗
-╚══██╔══╝██║╚══██╔══╝██╔══██╗████╗  ██║   ╚════██╗██╔═████╗╚════██╗██╔════╝
-   ██║   ██║   ██║   ███████║██╔██╗ ██║    █████╔╝██║██╔██║ █████╔╝███████╗
-   ██║   ██║   ██║   ██╔══██║██║╚██╗██║   ██╔═══╝ ████╔╝██║██╔═══╝ ██═══██║
-   ██║   ██║   ██║   ██║  ██║██║ ╚████║   ███████╗╚██████╔╝███████╗███████║
-   ╚═╝   ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═══╝   ╚══════╝ ╚═════╝ ╚══════╝╚══════╝
-```
+<p align="center">
+   You write zero Rust. TitanPl handles routing, bundling, runtime execution, hot reload, and deployment — <br> all powered by <a href="https://rust-lang.org/">Rust</a> under the hood.
+</p>
 
-# Notice
+<p align="center">
+  <a href="https://www.npmjs.com/package/@ezetgalaxy/titan">
+    <img src="https://img.shields.io/npm/v/@ezetgalaxy/titan?style=for-the-badge&logo=npm&logoColor=white" />
+  </a>
 
-💙 **Enjoy development mode `titan dev`**
-💟 **Titan Planet docs:** https://titan-docs-ez.vercel.app/docs
-🚀 **CLI: `titan` is now the canonical command. `tit` remains supported as an alias.**
-🛡️ **Strict Mode:** Titan now enforces zero type errors before running.
-✅ **For text response from a action file use t.response.text("Hii TitanPl")
+  <img src="https://img.shields.io/badge/Runtime-Gravity(V8)%20%26%20Rust%20Tokio-1f2937?style=for-the-badge" />
 
----
+  <img src="https://img.shields.io/badge/Powered%20By%20Rust%20Axum-DEA584?style=for-the-badge&logo=rust&logoColor=black" />
 
-# TITAN PLANET 🚀
+  <a href="https://discord.gg/mPDaTRtP">
+    <img src="https://img.shields.io/badge/Join-5865F2?style=for-the-badge&logo=discord&logoColor=white" />
+  </a>
 
-[![npm version](https://img.shields.io/npm/v/@ezetgalaxy/titan.svg?style=flat-square)](https://www.npmjs.com/package/@ezetgalaxy/titan)
+  <a href="https://x.com/TitanPl">
+    <img src="https://img.shields.io/badge/Follow-000000?style=for-the-badge&logo=x&logoColor=white" />
+  </a>
 
+</p>
 
-**TypeScript Precision. JavaScript Simplicity. Native Rust Power. Zero Configuration.**
-
-Titan Planet is a **JavaScript/TypeScript-first Backend Framework** that compiles your application into a single, high-performance native binary. It embeds a V8 JavaScript runtime directly into a specialized Rust + Axum server.
 
-**Start with pure TypeScript/JavaScript.**
-**Need raw power? Add Rust actions seamlessly.**
-Titan handles the compilation, bundling, and routing automatically for both.
 
-Titan = **TS/JS productivity × Rust performance × Zero DevOps**
 
----
+<h1> Description
+</h1>
 
-# 🌌 Why Titan?
+Titan Planet is a JavaScript/TypeScript-first Backend Framework that compiles your application into a single, high-performance native binary. It embeds it's own Gravity (V8) JavaScript runtime directly into a specialized Rust + Axum server.
 
-| Feature                              | Titan | Express/Nest | FastAPI | Bun       |
-| ------------------------------------ | ----- | ------------ | ------- | --------- |
-| Native binary output                 | ✅ Yes | ❌ No         | ❌ No    | ❌ No      |
-| Hybrid Rust + JS/TS Actions          | ✅ Yes | ❌ No         | ❌ No    | ❌ No      |
-| Strict TypeScript Enforcement        | ✅ Yes | ❌ Setup Req. | ❌ No    | ❌ Partial |
-| Zero-config Docker deploy            | ✅ Yes | ❌ No         | ❌ No    | ❌ No      |
-| Action-based architecture            | ✅ Yes | ❌ No         | ❌ No    | ❌ No      |
-| Hot reload dev server                | ✅ Yes | ❌ No         | ❌ No    | ❌ No      |
-| Modular, Isolated Templates          | ✅ Yes | ❌ No         | ❌ No    | ❌ No      |
+**TypeScript Precision. JavaScript Simplicity. Native Rust Power. Zero Configuration.**
 
----
+<p>
+   
+  <img src="https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white" />
+  <img src="https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black" />
+  <img src="https://img.shields.io/badge/Rust-DEA584?style=for-the-badge&logo=rust&logoColor=black" />
+</p>
+
+  
+## Why Titan?
+
+Titan Planet compiles your JavaScript or TypeScript application into a **single native Rust binary**.
+
+It embeds a V8 runtime inside a Rust + Axum server — giving you:
+
+- ⚡ Native-level performance
+- 📦 Single binary deployment
+- 🧠 Strict TypeScript enforcement
+- 🛡 Zero type errors before runtime
+- 🚀 No DevOps configuration required
+
+Start with pure TypeScript.
+Drop into Rust when you need extreme performance.
+Titan handles the integration automatically.
+
+<p>
+  <a href="https://titan-docs-ez.vercel.app/docs" target="_blank">
+    <img src="https://i.ibb.co/VpBsTg6m/tpl-Logo.png" width="28" style="vertical-align:middle;" />
+    <strong style="vertical-align:middle;"> Documentation</strong>
+</p>
+<p>
+<a href="https://titan-docs-ez.vercel.app/docs/runtime-architecture" target="_blank">
+    <strong style="vertical-align:middle;">Gravity Runtime</strong>
+  </a>
+</p>
+  
+ <p>
+     <a href="https://titan-docs-ez.vercel.app/docs/14-drift" target="_blank">
+    <strong style="vertical-align:middle;">Drift</strong>
+  </a>
+ </p>
 
 # 🚀 Quick Start
-
 ### 1. Prerequisites
 * **Rust** (latest stable): [Install Rust](https://rust-lang.org/tools/install/)
 * **Node.js** (v18+): Required for CLI and JS tooling.
@@ -100,7 +128,6 @@ You'll see the Titan Dev Server spin up:
   • Your app is now orbiting Titan Planet
 ```
 
----
 
 # ⚡ Hybrid Action System
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ezetgalaxy/titan",
-  "version": "26.15.1",
+  "version": "26.15.3",
   "description": "Titan Planet is a JavaScript-first backend framework that embeds JS actions into a Rust + Axum server and ships as a single native binary. Routes are compiled to static metadata; only actions run in the embedded JS runtime. No Node.js. No event loop in production.",
   "license": "ISC",
   "author": "ezetgalaxy",

package/templates/js/server/src/extensions/mod.rs

@@ -470,16 +470,15 @@ pub fn execute_action_optimized(
     let p_val = v8_str(scope, req_path);
     req_obj.set(scope, p_key.into(), p_val.into());
 
-    // rawBody — zero-copy via ArrayBuffer backing store
+    // body — attach raw bytes as ArrayBuffer under "rawBody" key
+    let rb_key = v8::Local::new(scope, &gk_raw_body);
     let body_val: v8::Local<v8::Value> = if let Some(bytes) = req_body {
-        let vec = bytes.to_vec();
-        let store = v8::ArrayBuffer::new_backing_store_from_boxed_slice(vec.into_boxed_slice());
-        let ab = v8::ArrayBuffer::with_backing_store(scope, &store.make_shared());
+        let backing = v8::ArrayBuffer::new_backing_store_from_vec(bytes.to_vec());
+        let ab = v8::ArrayBuffer::with_backing_store(scope, &backing.make_shared());
         ab.into()
     } else {
         v8::null(scope).into()
     };
-    let rb_key = v8::Local::new(scope, &gk_raw_body);
     req_obj.set(scope, rb_key.into(), body_val);
 
     // headers
@@ -577,4 +576,4 @@ pub fn throw(scope: &mut v8::HandleScope, msg: &str) {
     let message = v8_str(scope, msg);
     let exception = v8::Exception::error(scope, message);
     scope.throw_exception(exception);
-}
+}

package/templates/js/server/src/extensions/titan_core.js

@@ -15,6 +15,32 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
         const wrapped = function (req) {
             const requestId = req.__titan_request_id;
 
+            if (req.rawBody && req.rawBody.byteLength !== undefined) {
+                try {
+                    const decoder = new TextDecoder();
+                    const text = decoder.decode(req.rawBody);
+
+                    const contentType =
+                        (req.headers && req.headers["content-type"]) ||
+                        (req.headers && req.headers["Content-Type"]) ||
+                        "";
+
+                    if (contentType.includes("application/json")) {
+                        req.body = text ? JSON.parse(text) : {};
+                    } else if (contentType.includes("application/x-www-form-urlencoded")) {
+                        req.body = Object.fromEntries(new URLSearchParams(text));
+                    } else {
+                        req.body = text;
+                    }
+                } catch (e) {
+                    req.body = {};
+                }
+            } else {
+                req.body = {};
+            }
+
+            // ===============================
+
             const isSuspend = (err) => {
                 const msg = err && (err.message || String(err));
                 return msg && (msg.includes("__SUSPEND__") || msg.includes("SUSPEND"));
@@ -25,9 +51,7 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
 
                 if (result && typeof result.then === 'function') {
                     result.then(
-                        (data) => {
-                            t._finish_request(requestId, data);
-                        },
+                        (data) => t._finish_request(requestId, data),
                         (err) => {
                             if (isSuspend(err)) return;
                             t._finish_request(requestId, { error: err.message || String(err) });
@@ -54,10 +78,8 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
         }
     };
 
-    // process.env
-    globalThis.process = {
-        env: t.loadEnv ? t.loadEnv() : {}
-    };
+    // Titan Environment API
+    t.env = t.loadEnv ? t.loadEnv() : {};
 
     // Async Proxy Creator
     function createAsyncOp(op) {
@@ -73,8 +95,7 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
                 }
 
                 throw new Error(
-                    `[Titan Error] Accessed '${String(prop)}' without drift(). ` +
-                    `Fix: const res = drift(t.fetch(...));`
+                    `[Titan Error] Accessed '${String(prop)}' without drift(). `
                 );
             }
         });

package/templates/ts/server/src/extensions/mod.rs

@@ -470,16 +470,15 @@ pub fn execute_action_optimized(
     let p_val = v8_str(scope, req_path);
     req_obj.set(scope, p_key.into(), p_val.into());
 
-    // rawBody — zero-copy via ArrayBuffer backing store
+    // body — attach raw bytes as ArrayBuffer under "rawBody" key
+    let rb_key = v8::Local::new(scope, &gk_raw_body);
     let body_val: v8::Local<v8::Value> = if let Some(bytes) = req_body {
-        let vec = bytes.to_vec();
-        let store = v8::ArrayBuffer::new_backing_store_from_boxed_slice(vec.into_boxed_slice());
-        let ab = v8::ArrayBuffer::with_backing_store(scope, &store.make_shared());
+        let backing = v8::ArrayBuffer::new_backing_store_from_vec(bytes.to_vec());
+        let ab = v8::ArrayBuffer::with_backing_store(scope, &backing.make_shared());
         ab.into()
     } else {
         v8::null(scope).into()
     };
-    let rb_key = v8::Local::new(scope, &gk_raw_body);
     req_obj.set(scope, rb_key.into(), body_val);
 
     // headers
@@ -577,4 +576,4 @@ pub fn throw(scope: &mut v8::HandleScope, msg: &str) {
     let message = v8_str(scope, msg);
     let exception = v8::Exception::error(scope, message);
     scope.throw_exception(exception);
-}
+}

package/templates/ts/server/src/extensions/titan_core.js

@@ -15,6 +15,32 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
         const wrapped = function (req) {
             const requestId = req.__titan_request_id;
 
+            if (req.rawBody && req.rawBody.byteLength !== undefined) {
+                try {
+                    const decoder = new TextDecoder();
+                    const text = decoder.decode(req.rawBody);
+
+                    const contentType =
+                        (req.headers && req.headers["content-type"]) ||
+                        (req.headers && req.headers["Content-Type"]) ||
+                        "";
+
+                    if (contentType.includes("application/json")) {
+                        req.body = text ? JSON.parse(text) : {};
+                    } else if (contentType.includes("application/x-www-form-urlencoded")) {
+                        req.body = Object.fromEntries(new URLSearchParams(text));
+                    } else {
+                        req.body = text;
+                    }
+                } catch (e) {
+                    req.body = {};
+                }
+            } else {
+                req.body = {};
+            }
+
+            // ===============================
+
             const isSuspend = (err) => {
                 const msg = err && (err.message || String(err));
                 return msg && (msg.includes("__SUSPEND__") || msg.includes("SUSPEND"));
@@ -25,9 +51,7 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
 
                 if (result && typeof result.then === 'function') {
                     result.then(
-                        (data) => {
-                            t._finish_request(requestId, data);
-                        },
+                        (data) => t._finish_request(requestId, data),
                         (err) => {
                             if (isSuspend(err)) return;
                             t._finish_request(requestId, { error: err.message || String(err) });
@@ -54,10 +78,8 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
         }
     };
 
-    // process.env
-    globalThis.process = {
-        env: t.loadEnv ? t.loadEnv() : {}
-    };
+    // Titan Environment API
+    t.env = t.loadEnv ? t.loadEnv() : {};
 
     // Async Proxy Creator
     function createAsyncOp(op) {
@@ -73,8 +95,7 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
                 }
 
                 throw new Error(
-                    `[Titan Error] Accessed '${String(prop)}' without drift(). ` +
-                    `Fix: const res = drift(t.fetch(...));`
+                    `[Titan Error] Accessed '${String(prop)}' without drift(). `
                 );
             }
         });

package/titanpl-sdk/package.json

@@ -1,6 +1,6 @@
 {
     "name": "titanpl-sdk",
-    "version": "3.0.0",
+    "version": "3.0.1",
     "description": "Development SDK for Titan Planet. Provides TypeScript type definitions for the global 't' runtime object and a 'lite' test-harness runtime for building and verifying extensions.",
     "main": "index.js",
     "type": "module",

package/titanpl-sdk/templates/server/src/extensions/mod.rs

@@ -470,16 +470,15 @@ pub fn execute_action_optimized(
     let p_val = v8_str(scope, req_path);
     req_obj.set(scope, p_key.into(), p_val.into());
 
-    // rawBody — zero-copy via ArrayBuffer backing store
+    // body — attach raw bytes as ArrayBuffer under "rawBody" key
+    let rb_key = v8::Local::new(scope, &gk_raw_body);
     let body_val: v8::Local<v8::Value> = if let Some(bytes) = req_body {
-        let vec = bytes.to_vec();
-        let store = v8::ArrayBuffer::new_backing_store_from_boxed_slice(vec.into_boxed_slice());
-        let ab = v8::ArrayBuffer::with_backing_store(scope, &store.make_shared());
+        let backing = v8::ArrayBuffer::new_backing_store_from_vec(bytes.to_vec());
+        let ab = v8::ArrayBuffer::with_backing_store(scope, &backing.make_shared());
         ab.into()
     } else {
         v8::null(scope).into()
     };
-    let rb_key = v8::Local::new(scope, &gk_raw_body);
     req_obj.set(scope, rb_key.into(), body_val);
 
     // headers
@@ -577,4 +576,4 @@ pub fn throw(scope: &mut v8::HandleScope, msg: &str) {
     let message = v8_str(scope, msg);
     let exception = v8::Exception::error(scope, message);
     scope.throw_exception(exception);
-}
+}

package/titanpl-sdk/templates/server/src/extensions/titan_core.js

@@ -15,6 +15,32 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
         const wrapped = function (req) {
             const requestId = req.__titan_request_id;
 
+            if (req.rawBody && req.rawBody.byteLength !== undefined) {
+                try {
+                    const decoder = new TextDecoder();
+                    const text = decoder.decode(req.rawBody);
+
+                    const contentType =
+                        (req.headers && req.headers["content-type"]) ||
+                        (req.headers && req.headers["Content-Type"]) ||
+                        "";
+
+                    if (contentType.includes("application/json")) {
+                        req.body = text ? JSON.parse(text) : {};
+                    } else if (contentType.includes("application/x-www-form-urlencoded")) {
+                        req.body = Object.fromEntries(new URLSearchParams(text));
+                    } else {
+                        req.body = text;
+                    }
+                } catch (e) {
+                    req.body = {};
+                }
+            } else {
+                req.body = {};
+            }
+
+            // ===============================
+
             const isSuspend = (err) => {
                 const msg = err && (err.message || String(err));
                 return msg && (msg.includes("__SUSPEND__") || msg.includes("SUSPEND"));
@@ -25,9 +51,7 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
 
                 if (result && typeof result.then === 'function') {
                     result.then(
-                        (data) => {
-                            t._finish_request(requestId, data);
-                        },
+                        (data) => t._finish_request(requestId, data),
                         (err) => {
                             if (isSuspend(err)) return;
                             t._finish_request(requestId, { error: err.message || String(err) });
@@ -54,10 +78,8 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
         }
     };
 
-    // process.env
-    globalThis.process = {
-        env: t.loadEnv ? t.loadEnv() : {}
-    };
+    // Titan Environment API
+    t.env = t.loadEnv ? t.loadEnv() : {};
 
     // Async Proxy Creator
     function createAsyncOp(op) {
@@ -73,8 +95,7 @@ if (!globalThis.__TITAN_CORE_LOADED__) {
                 }
 
                 throw new Error(
-                    `[Titan Error] Accessed '${String(prop)}' without drift(). ` +
-                    `Fix: const res = drift(t.fetch(...));`
+                    `[Titan Error] Accessed '${String(prop)}' without drift(). `
                 );
             }
         });