@ezetgalaxy/titan 25.14.6 → 25.14.7

package/README.md

@@ -1,339 +1,344 @@
-
-```
-████████╗██╗████████╗ █████╗ ███╗   ██╗
-╚══██╔══╝██║╚══██╔══╝██╔══██╗████╗  ██║
-   ██║   ██║   ██║   ███████║██╔██╗ ██║
-   ██║   ██║   ██║   ██╔══██║██║╚██╗██║
-   ██║   ██║   ██║   ██║  ██║██║ ╚████║
-   ╚═╝   ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═══╝
-```
-
-# TITAN PLANET 🚀
-
-**JavaScript Simplicity. Rust Power. Zero Configuration.**
-
-Titan Planet is a JavaScript-first backend framework that compiles your JavaScript routes and actions into a **native Rust + Axum server**.
-
-You write **zero Rust**.
-Titan ships a full backend engine, dev server, bundler, router, action runtime, and Docker deploy pipeline — all powered by Rust under the hood.
-
-Titan = JavaScript productivity × Rust performance × Zero DevOps.
-
----
-
-# 🌌 Why Titan?
-
-| Feature                              | Titan | Express/Nest | FastAPI | Bun       |
-| ------------------------------------ | ----- | ------------ | ------- | --------- |
-| Native binary output                 | ✅ Yes | ❌ No         | ❌ No    | ❌ No      |
-| Rust-level performance               | ✅ Yes | ❌ No         | ❌ No    | ❌ No      |
-| Pure JavaScript developer experience | ✅ Yes | ✅ Yes        | ❌ 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      |
-
-Titan gives you:
-
-* Native speed
-* JS comfort
-* Cloud-first deployment
-* Full environment variable support
-* Built-in HTTP client (`t.fetch`)
-* Lightweight serverless-like actions
-* Instant hot reload
-* Zero configuration
-* Single deployable binary
-
----
-
-# 🚀 Quick Start
-
-
-# ⚙ Requirements
-
-Install before using Titan:
-
-### 1. Rust (latest stable)
-
-[https://rust-lang.org/tools/install/](https://rust-lang.org/tools/install/)
-
-### 2. Node.js (v18+)
-
-Required for:
-
-* Titan CLI
-* esbuild
-* JS → Rust compilation pipeline
-
-Verify:
-
-```bash
-node -v
-npm -v
-rustc -V
-```
-
----
-
-### Install Titan CLI
-
-```bash
-npm install -g @ezetgalaxy/titan
-```
-
-### Create a new project
-
-```bash
-tit init my-app
-cd my-app
-tit dev
-```
-
-Titan will:
-
-* Build routes
-* Bundle actions
-* Start Rust dev server
-* Watch file changes
-* Trigger instant reload
-
----
-
-# 📁 Project Layout
-
-```
-my-app/
-├── app/                                  # You develop ONLY this folder
-│   ├── app.js                             # Titan routes (DSL)
-│   └── actions/                           # Your custom JS actions
-│       └── hello.js                       # Example Titan action
-
-───────────────────────────────────────────────────────────────
-  Everything below is auto-generated by `tit init`
-  You never modify these folders manually
-───────────────────────────────────────────────────────────────
-
-├── titan/                                # Titan's internal JS engine
-│   ├── titan.js                           # Titan DSL runtime
-│   ├── bundle.js                          # JS → .jsbundle bundler
-│   └── dev.js                             # Hot Reload system
-│
-├── server/                               # Auto-generated Rust backend
-│   ├── Cargo.toml                         # Rust project config
-│   ├── src/                               # Rust source code
-│   ├── actions/                           # Compiled .jsbundle actions
-│   ├── titan/                             # Internal Rust runtime files
-│   ├── routes.json                        # Generated route metadata
-│   ├── action_map.json                    # Maps actions to bundles
-│   └── titan-server                       # Final production Rust binary
-│
-├── Dockerfile                             # Auto-generated production Dockerfile
-├── .dockerignore                          # Auto-generated Docker ignore rules
-├── package.json                           # JS project config (auto)
-└── .gitignore                             # Auto-generated by `tit init`
-
-```
-
----
-
-# 🛣 Example Route
-
-**app/app.js**
-
-```js
-import t from "../titan/titan.js";
-
-t.post("/hello").action("hello");
-t.get("/").reply("Welcome to Titan Planet");
-
-t.start(3000, "Ready to land on Titan 🚀");
-```
-
----
-
-# 🧩 Example Action
-
-**app/actions/hello.js**
-
-```js
-export function hello(req) {
-  return { message: "Hello from Titan!" };
-}
-
-globalThis.hello = hello;
-```
-
----
-
-# ⚡ New: Built-In HTTP Fetch (`t.fetch`)
-
-Titan now includes a built-in server-side `fetch` bridge powered by Rust.
-
-Use it to call any external API:
-
-```js
-function hello(req) {
-    const body = JSON.stringify({
-        model: "gpt-4.1-mini",
-        messages: [{ role: "user", content: "hii" }]
-    });
-
-    const r = t.fetch("https://api.openai.com/v1/chat/completions", {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            "Authorization": `Bearer ${process.env.OPENAI_API_KEY}`
-        },
-        body
-    });
-
-    const json = JSON.parse(r.body);
-
-    return {
-        ok: true,
-        message: json.choices[0].message.content
-    };
-}
-
-globalThis.hello = hello;
-```
-
-### `t.fetch` supports:
-
-* GET, POST, PUT, DELETE
-* Custom headers
-* JSON bodies
-* Authorization tokens
-* External / internal APIs
-
----
-
-# 🔥 Hot Reload Dev Server
-
-```bash
-tit dev
-```
-
-Titan’s dev engine:
-
-* Rebuilds routes
-* Rebundil actions
-* Restarts Rust server
-* Updates instantly
-
-
----
-
-# 🧱 Production Build
-
-```bash
-tit build
-```
-
-Output includes:
-
-* `titan-server` native binary
-* JS bundles
-* routing metadata
-
----
-
-# 🐳 Docker Deployment (Zero Config)
-
-Titan generates an optimized **multi-stage Dockerfile**:
-
-Works on:
-
-* Railway
-* Fly.io
-* Render
-* VPS / Dedicated servers
-* Docker Hub
-* Kubernetes
-
----
-
-# ☁ Uploading Titan to GitHub
-
-Titan projects are designed for **direct repository upload**.
-
-Include everything generated by `tit init`:
-
-```
-app/
-titan/
-server/
-Cargo.toml
-Dockerfile
-.gitignore
-package.json
-```
-
-Push to GitHub:
-
-```bash
-git init
-git add .
-git commit -m "Initial Titan project"
-git branch -M main
-git remote add origin <your_repo_url>
-git push -u origin main
-```
-
-Your repo is now fully deployable with Docker.
-
----
-
-# ☁ Zero-Config Deployment with Docker
-
-Once pushed to GitHub, you can deploy anywhere.
-
-## Deploy to Railway
-
-1. Go to Railway
-2. Create New Project → Deploy from GitHub
-3. Select your Titan repo
-4. Railway auto-detects the Dockerfile
-5. It builds + deploys automatically
-
-Railway will:
-
-* Build your Rust server
-* Copy JS bundles
-* Start the `titan-server` binary
-* Expose the correct port
-
-No configuration required.
-
----
-
-# ✨ Updating Titan
-
-```bash
-tit update
-```
-
-Updates:
-
-* Titan CLI
-* DSL
-* Bundler
-* Dev server
-* Rust runtime templates
-* Dockerfile
-
----
-
-# 📦 Version
-
-**Titan v25 — Stable**
-Optimized for production, cloud deployment, and AI workloads.
-
----
-
-# 🤝 Contributing
-
-Pull requests welcome
-https://github.com/ezet-galaxy/-ezetgalaxy-titan
-
----
+
+```
+████████╗██╗████████╗ █████╗ ███╗   ██╗
+╚══██╔══╝██║╚══██╔══╝██╔══██╗████╗  ██║
+   ██║   ██║   ██║   ███████║██╔██╗ ██║
+   ██║   ██║   ██║   ██╔══██║██║╚██╗██║
+   ██║   ██║   ██║   ██║  ██║██║ ╚████║
+   ╚═╝   ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═══╝
+```
+# Notice 
+**Production mode is under development 😞**
+ **Enjoy development mode `tit dev` 💙**
+
+# TITAN PLANET 🚀
+
+**JavaScript Simplicity. Rust Power. Zero Configuration.**
+
+Titan Planet is a JavaScript-first backend framework that compiles your JavaScript routes and actions into a **native Rust + Axum server**.
+
+You write **zero Rust**.
+Titan ships a full backend engine, dev server, bundler, router, action runtime, and Docker deploy pipeline — all powered by Rust under the hood.
+
+Titan = JavaScript productivity × Rust performance × Zero DevOps.
+
+---
+
+# 🌌 Why Titan?
+
+| Feature                              | Titan | Express/Nest | FastAPI | Bun       |
+| ------------------------------------ | ----- | ------------ | ------- | --------- |
+| Native binary output                 | ✅ Yes | ❌ No         | ❌ No    | ❌ No      |
+| Rust-level performance               | ✅ Yes | ❌ No         | ❌ No    | ❌ No      |
+| Pure JavaScript developer experience | ✅ Yes | ✅ Yes        | ❌ 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      |
+
+Titan gives you:
+
+* Native speed
+* JS comfort
+* Cloud-first deployment
+* Full environment variable support
+* Built-in HTTP client (`t.fetch`)
+* Lightweight serverless-like actions
+* Instant hot reload
+* Zero configuration
+* Single deployable binary
+
+---
+
+# 🚀 Quick Start
+
+
+# ⚙ Requirements
+
+Install before using Titan:
+
+### 1. Rust (latest stable)
+
+[https://rust-lang.org/tools/install/](https://rust-lang.org/tools/install/)
+
+### 2. Node.js (v18+)
+
+Required for:
+
+* Titan CLI
+* esbuild
+* JS → Rust compilation pipeline
+
+Verify:
+
+```bash
+node -v
+npm -v
+rustc -V
+```
+
+---
+
+### Install Titan CLI
+
+```bash
+npm install -g @ezetgalaxy/titan
+```
+
+### Create a new project
+
+```bash
+tit init my-app
+cd my-app
+tit dev
+```
+
+Titan will:
+
+* Build routes
+* Bundle actions
+* Start Rust dev server
+* Watch file changes
+* Trigger instant reload
+
+---
+
+# 📁 Project Layout
+
+```
+my-app/
+├── app/                                  # You develop ONLY this folder
+│   ├── app.js                             # Titan routes (DSL)
+│   └── actions/                           # Your custom JS actions
+│       └── hello.js                       # Example Titan action
+
+───────────────────────────────────────────────────────────────
+  Everything below is auto-generated by `tit init`
+  You never modify these folders manually
+───────────────────────────────────────────────────────────────
+
+├── titan/                                # Titan's internal JS engine
+│   ├── titan.js                           # Titan DSL runtime
+│   ├── bundle.js                          # JS → .jsbundle bundler
+│   └── dev.js                             # Hot Reload system
+│
+├── server/                               # Auto-generated Rust backend
+│   ├── Cargo.toml                         # Rust project config
+│   ├── src/                               # Rust source code
+│   ├── actions/                           # Compiled .jsbundle actions
+│   ├── titan/                             # Internal Rust runtime files
+│   ├── routes.json                        # Generated route metadata
+│   ├── action_map.json                    # Maps actions to bundles
+│   └── titan-server                       # Final production Rust binary
+│
+├── Dockerfile                             # Auto-generated production Dockerfile
+├── .dockerignore                          # Auto-generated Docker ignore rules
+├── package.json                           # JS project config (auto)
+└── .gitignore                             # Auto-generated by `tit init`
+
+```
+
+---
+
+# 🛣 Example Route
+
+**app/app.js**
+
+```js
+import t from "../titan/titan.js";
+
+t.post("/hello").action("hello");
+t.get("/").reply("Welcome to Titan Planet");
+
+t.start(3000, "Ready to land on Titan 🚀");
+```
+
+---
+
+# 🧩 Example Action
+
+**app/actions/hello.js**
+
+```js
+export function hello(req) {
+  return { message: "Hello from Titan!" };
+}
+
+globalThis.hello = hello;
+```
+
+---
+
+# ⚡ New: Built-In HTTP Fetch (`t.fetch`)
+
+Titan now includes a built-in server-side `fetch` bridge powered by Rust.
+
+Use it to call any external API:
+
+```js
+function hello(req) {
+    const API_KEY = process.env.API_KEY || __titan_env.API_KEY;
+
+    const body = JSON.stringify({
+        model: "gpt-4.1-mini",
+        messages: [{ role: "user", content: "hii" }]
+    });
+
+    const r = t.fetch("https://api.openai.com/v1/chat/completions", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${API_KEY}`
+        },
+        body
+    });
+
+    const json = JSON.parse(r.body);
+
+    return {
+        ok: true,
+        message: json.choices[0].message.content
+    };
+}
+
+globalThis.hello = hello;
+```
+
+### `t.fetch` supports:
+
+* GET, POST, PUT, DELETE
+* Custom headers
+* JSON bodies
+* Authorization tokens
+* External / internal APIs
+
+---
+
+# 🔥 Hot Reload Dev Server
+
+```bash
+tit dev
+```
+
+Titan’s dev engine:
+
+* Rebuilds routes
+* Rebundil actions
+* Restarts Rust server
+* Updates instantly
+
+
+---
+
+# 🧱 Production Build
+
+```bash
+tit build
+```
+
+Output includes:
+
+* `titan-server` native binary
+* JS bundles
+* routing metadata
+
+---
+
+# 🐳 Docker Deployment (Zero Config)
+
+Titan generates an optimized **multi-stage Dockerfile**:
+
+Works on:
+
+* Railway
+* Fly.io
+* Render
+* VPS / Dedicated servers
+* Docker Hub
+* Kubernetes
+
+---
+
+# ☁ Uploading Titan to GitHub
+
+Titan projects are designed for **direct repository upload**.
+
+Include everything generated by `tit init`:
+
+```
+app/
+titan/
+server/
+Cargo.toml
+Dockerfile
+.gitignore
+package.json
+```
+
+Push to GitHub:
+
+```bash
+git init
+git add .
+git commit -m "Initial Titan project"
+git branch -M main
+git remote add origin <your_repo_url>
+git push -u origin main
+```
+
+Your repo is now fully deployable with Docker.
+
+---
+
+# ☁ Zero-Config Deployment with Docker
+
+Once pushed to GitHub, you can deploy anywhere.
+
+## Deploy to Railway
+
+1. Go to Railway
+2. Create New Project → Deploy from GitHub
+3. Select your Titan repo
+4. Railway auto-detects the Dockerfile
+5. It builds + deploys automatically
+
+Railway will:
+
+* Build your Rust server
+* Copy JS bundles
+* Start the `titan-server` binary
+* Expose the correct port
+
+No configuration required.
+
+---
+
+# ✨ Updating Titan
+
+```bash
+tit update
+```
+
+Updates:
+
+* Titan CLI
+* DSL
+* Bundler
+* Dev server
+* Rust runtime templates
+* Dockerfile
+
+---
+
+# 📦 Version
+
+**Titan v25 — Stable**
+Optimized for production, cloud deployment, and AI workloads.
+
+---
+
+# 🤝 Contributing
+
+Pull requests welcome
+https://github.com/ezet-galaxy/-ezetgalaxy-titan
+
+---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ezetgalaxy/titan",
-  "version": "25.14.6",
+  "version": "25.14.7",
   "description": "JavaScript backend framework that compiles your JS into a Rust + Axum server.",
   "license": "ISC",
   "author": "ezetgalaxy",

package/templates/server/src/main.rs

@@ -1,21 +1,21 @@
 // server/src/main.rs
-use std::{collections::HashMap, env, fs, path::PathBuf, sync::Arc, path::Path};
+use std::{collections::HashMap, env, fs, path::Path, path::PathBuf, sync::Arc};
 
 use anyhow::Result;
 use axum::{
-    body::{to_bytes, Body},
+    Router,
+    body::{Body, to_bytes},
     extract::State,
     http::{Request, StatusCode},
     response::{IntoResponse, Json},
     routing::any,
-    Router,
 };
 
-use boa_engine::{object::ObjectInitializer, Context, JsValue, Source};
+use boa_engine::{Context, JsValue, Source, object::ObjectInitializer};
 use boa_engine::{js_string, native_function::NativeFunction, property::Attribute};
 
-use reqwest::header::{HeaderMap, HeaderName, HeaderValue};
 use reqwest::blocking::Client;
+use reqwest::header::{HeaderMap, HeaderName, HeaderValue};
 
 use serde::Deserialize;
 use serde_json::Value;
@@ -152,9 +152,10 @@ fn inject_t_fetch(ctx: &mut Context) {
             if !header_pairs.is_empty() {
                 let mut headers = HeaderMap::new();
                 for (k, v) in header_pairs.into_iter() {
-                    if let (Ok(name), Ok(val)) =
-                        (HeaderName::from_bytes(k.as_bytes()), HeaderValue::from_str(&v))
-                    {
+                    if let (Ok(name), Ok(val)) = (
+                        HeaderName::from_bytes(k.as_bytes()),
+                        HeaderValue::from_str(&v),
+                    ) {
                         headers.insert(name, val);
                     }
                 }
@@ -230,7 +231,8 @@ async fn dynamic_handler_inner(
             "action" => {
                 let action_name = route.value.as_str().unwrap_or("").trim();
                 if action_name.is_empty() {
-                    return (StatusCode::INTERNAL_SERVER_ERROR, "Invalid action name").into_response();
+                    return (StatusCode::INTERNAL_SERVER_ERROR, "Invalid action name")
+                        .into_response();
                 }
 
                 // Resolve actions directory: prefer resolve_actions_dir(), fall back to heuristic find_actions_dir
@@ -272,30 +274,56 @@ async fn dynamic_handler_inner(
                 };
 
                 // Build env object
-                let mut env_map = serde_json::Map::new();
+                let mut env_map: serde_json::Map<String, Value> = serde_json::Map::new();
                 for (k, v) in std::env::vars() {
                     env_map.insert(k, Value::String(v));
                 }
-                let env_json = Value::Object(env_map);
+                let env_json: Value = Value::Object(env_map);
+
+                // Ensure body_str is valid JS: we will embed it as a JS expression.
+                // If body_str is a JSON object string, embedding it directly is fine.
+                // But to be safe, we create a quoted JS string and parse it in JS if necessary.
+                let safe_body_literal: String =
+                    serde_json::to_string(&body_str).unwrap_or_else(|_| "null".to_string());
 
-                // Injected script: sets process.env and __titan_req and invokes action function.
-                let injected = format!(
+                // Injected script: sets process.env, __titan_env, __titan_req and invokes action function.
+                let injected: String = format!(
                     r#"
-                    globalThis.process = {{ env: {} }};
-                    const __titan_req = {};
-                    {};
-                    {}(__titan_req);
-                    "#,
-                    env_json.to_string(),
-                    body_str,
-                    js_code,
-                    action_name
+    // Runtime env injected by Titan
+    globalThis.process = {{ env: {} }};
+    globalThis.__titan_env = {};
+    // quick debug so prod logs show whether API key is present
+    try {{
+      console.log('TITAN: runtime API_KEY =', (process && process.env && process.env.API_KEY) || (typeof __titan_env !== 'undefined' && __titan_env.API_KEY) || null);
+    }} catch(e) {{ /* ignore */ }}
+
+    // Parse the incoming request body. If it's a JSON string we parse it into an object.
+    const __titan_req_body_literal = {};
+    let __titan_req;
+    try {{
+      // it's a quoted JSON string in Rust, so first unquote via JSON.parse
+      __titan_req = JSON.parse(__titan_req_body_literal);
+    }} catch (e) {{
+      // if parse fails, fall back to empty object
+      __titan_req = {{}};
+    }}
+
+    // Action code (bundled JS)
+    {};
+    // call exported action function
+    {}(__titan_req);
+    "#,
+                    env_json.to_string(), // inserted JSON object for process.env
+                    env_json.to_string(), // inserted also as __titan_env
+                    safe_body_literal,    // quoted JSON string literal of request body
+                    js_code,              // code from the .jsbundle
+                    action_name           // call function
                 );
 
-                let mut ctx = Context::default();
+                let mut ctx: Context = Context::default();
                 inject_t_fetch(&mut ctx);
 
-                let result = match ctx.eval(Source::from_bytes(&injected)) {
+                let result: JsValue = match ctx.eval(Source::from_bytes(&injected)) {
                     Ok(v) => v,
                     Err(e) => return Json(json_error(e.to_string())).into_response(),
                 };
@@ -361,7 +389,10 @@ async fn main() -> Result<()> {
     println!("   ██║   ██║   ██║   ██╔══██║██║╚██╗██║");
     println!("   ██║   ██║   ██║   ██║  ██║██║ ╚████║");
     println!("   ╚═╝   ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═══╝\x1b[0m\n");
-    println!("\x1b[38;5;39mTitan server running at:\x1b[0m http://localhost:{}", port);
+    println!(
+        "\x1b[38;5;39mTitan server running at:\x1b[0m http://localhost:{}",
+        port
+    );
 
     axum::serve(listener, app).await?;
     Ok(())