@ezetgalaxy/titan 25.14.6 → 25.14.8

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.8",
   "description": "JavaScript backend framework that compiles your JS into a Rust + Axum server.",
   "license": "ISC",
   "author": "ezetgalaxy",