@ezetgalaxy/titan 26.3.3 → 26.4.1

package/README.md

@@ -11,7 +11,7 @@
 # Notice
 
 💙 **Enjoy development mode `titan dev`**
-💟 **Titan Planet docs: https://titan-docs-ez.vercel.app/docs**
+💟 **Titan Planet docs:** https://titan-docs-ez.vercel.app/docs
 🚀 **CLI: `titan` is now the canonical command. `tit` remains supported as an alias.**
 
 ---

package/index.js

@@ -175,106 +175,29 @@ Next steps:
 `);
 }
 
-
-/* -------------------------------------------------------
- * BUNDLER
- * ----------------------------------------------------- */
-function runBundler(root) {
-    const bundler = path.join(root, "titan", "bundle.js");
-
-    if (!fs.existsSync(bundler)) {
-        console.log(red("ERROR: titan/bundle.js missing."));
-        process.exit(1);
-    }
-
-    execSync(`node "${bundler}"`, { stdio: "inherit" });
-}
-
 /* -------------------------------------------------------
  * DEV SERVER
  * ----------------------------------------------------- */
 async function devServer() {
     const root = process.cwd();
-    console.log(cyan("Titan Dev Mode — Hot Reload Enabled"));
-
-    let rustProcess = null;
-
-    function launchRust(done) {
-        const processHandle = spawn("cargo", ["run"], {
-            cwd: path.join(root, "server"),
-            stdio: "inherit",
-            shell: true,
-        });
-
-        processHandle.on("spawn", () => setTimeout(done, 200));
-        processHandle.on("close", (code) =>
-            console.log(`[Titan] Rust server exited: ${code}`)
-        );
-
-        return processHandle;
-    }
-
-    function startRust() {
-        return new Promise((resolve) => {
-            if (rustProcess) {
-                console.log("[Titan] Restarting Rust server...");
-
-                if (process.platform === "win32") {
-                    const killer = spawn("taskkill", ["/PID", rustProcess.pid, "/T", "/F"], {
-                        stdio: "ignore",
-                        shell: true,
-                    });
-
-                    killer.on("exit", () => {
-                        rustProcess = launchRust(resolve);
-                    });
-                } else {
-                    rustProcess.kill();
-                    rustProcess.on("close", () => {
-                        rustProcess = launchRust(resolve);
-                    });
-                }
-            } else {
-                rustProcess = launchRust(resolve);
-            }
-        });
-    }
-
-    /* Build logic */
-    function rebuild() {
-        execSync(`node "${path.join(root, "app", "app.js")}"`, {
-            stdio: "inherit",
-        });
-
-        runBundler(root);
-    }
+    const devScript = path.join(root, "titan", "dev.js");
 
-    try {
-        rebuild();
-        startRust();
-    } catch (e) {
-        console.log(red("Initial build failed:"));
-        console.log(e.message);
-        // Do not die even on initial fail, user might fix it.
+    if (!fs.existsSync(devScript)) {
+        console.log(red("Error: titan/dev.js not found."));
+        console.log("Try running `titan update` to fix missing files.");
+        return;
     }
 
-    const chokidar = (await import("chokidar")).default;
-    const watcher = chokidar.watch("app", { ignoreInitial: true });
-
-    let timer = null;
-
-    watcher.on("all", (event, file) => {
-        if (timer) clearTimeout(timer);
+    const child = spawn("node", [devScript], {
+        stdio: "inherit",
+        cwd: root
+    });
 
-        timer = setTimeout(() => {
-            console.log(yellow(`Change → ${file}`));
-            try {
-                rebuild();
-                startRust();
-            } catch (err) {
-                console.log(red("Build failed — waiting for changes..."));
-            }
-        }, 250);
+    child.on("close", (code) => {
+        // Exit strictly if the dev script failed
+        if (code !== 0) {
+            process.exit(code);
+        }
     });
 }
 
@@ -413,7 +336,7 @@ function updateTitan() {
     console.log(green("✔ Updated server/src/"));
 
     // Root-level config files
-    [".gitignore", ".dockerignore", "Dockerfile"].forEach((file) => {
+    [".gitignore", ".dockerignore", "Dockerfile", "jsconfig.json"].forEach((file) => {
         const src = path.join(templatesRoot, file);
         const dest = path.join(root, file);
 
@@ -425,7 +348,7 @@ function updateTitan() {
 
     // app/titan.d.ts (JS typing contract)
     const appDir = path.join(root, "app");
-    const srcDts = path.join(templatesRoot, "titan.d.ts");
+    const srcDts = path.join(templateServer, "../app/titan.d.ts"); // templates/app/titan.d.ts
     const destDts = path.join(appDir, "titan.d.ts");
 
     if (fs.existsSync(srcDts)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ezetgalaxy/titan",
-  "version": "26.3.3",
+  "version": "26.4.1",
   "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/Dockerfile

@@ -44,8 +44,7 @@ COPY --from=builder /app/server/action_map.json ./action_map.json
 RUN mkdir -p /app/actions
 COPY --from=builder /app/server/actions /app/actions
 
-# Copy static assets for t.read
-COPY app/db /app/assets/db
+COPY --from=builder /app/db /app/assets
 
 # Expose Titan port
 EXPOSE 3000

package/templates/app/actions/hello.js

@@ -1,5 +1,5 @@
-export function hello(req) {
-    return {
-        message: `Hello from Titan ${req.name}`,
+export const hello = (req) => {
+   return {
+        message: `Hello from Titan ${req.body.name}`,
     };
 }

package/templates/app/titan.d.ts

@@ -1,96 +1,87 @@
 /**
- * Titan Runtime Global Object
+ * TITAN TYPE DEFINITIONS
+ * ----------------------
+ * These types are globally available in your Titan project.
  */
-declare global {
-    /**
-     * Titan Request Object passed to actions
-     */
-    interface TitanRequest {
-        body: any;
-        method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
-        path: string;
-        headers: Record<string, string>;
-        params: Record<string, string>;
-        query: Record<string, string>;
-    }
 
-    interface DbConnection {
-        /**
-         * Execute a SQL query.
-         * @param sql The SQL query string.
-         * @param params (Optional) Parameters for the query ($1, $2, etc).
-         */
-        query(sql: string, params?: any[]): any[];
-    }
+/**
+ * The Titan Request Object passed to actions.
+ */
+interface TitanRequest {
+    body: any;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    path: string;
+    headers: {
+        host?: string;
+        "content-type"?: string;
+        "user-agent"?: string;
+        authorization?: string;
+        [key: string]: string | undefined;
+    };
+    params: Record<string, string>;
+    query: Record<string, string>;
+}
 
+interface DbConnection {
     /**
-     * Titan Runtime Utilities
+     * Execute a SQL query.
+     * @param sql The SQL query string.
+     * @param params (Optional) Parameters for the query ($1, $2, etc).
      */
-    const t: {
-        /**
-         * Log messages to the server console with Titan formatting.
-         */
-        log(...args: any[]): void;
+    query(sql: string, params?: any[]): any[];
+}
 
-        /**
-         * Read a file contents as string.
-         * @param path Relative path to the file from project root.
-         */
-        read(path: string): string;
+/**
+ * Define a Titan Action with type inference.
+ * @example
+ * export const hello = defineAction((req) => {
+ *   return req.headers;
+ * });
+ */
+declare function defineAction<T>(actionFn: (req: TitanRequest) => T): (req: TitanRequest) => T;
 
-        fetch(url: string, options?: {
-            method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
-            headers?: Record<string, string>;
-            body?: string | object;
-        }): {
-            ok: boolean;
-            status?: number;
-            body?: string;
-            error?: string;
-        };
+/**
+ * Titan Runtime Utilities
+ */
+declare const t: {
+    /**
+     * Log messages to the server console with Titan formatting.
+     */
+    log(...args: any[]): void;
 
-        jwt: {
-            /**
-             * Sign a JWT token.
-             * @param payload The data to include in the token.
-             * @param secret The secret key to sign with.
-             * @param options Configuration options.
-             */
-            sign(
-                payload: object,
-                secret: string,
-                options?: { expiresIn?: string | number }
-            ): string;
+    /**
+     * Read a file contents as string.
+     * @param path Relative path to the file from project root.
+     */
+    read(path: string): string;
 
-            /**
-             * Verify a JWT token.
-             * @param token The JWT string to verify.
-             * @param secret The secret key used for signing.
-             * @throws Error if invalid or expired.
-             */
-            verify(token: string, secret: string): any;
-        };
+    fetch(url: string, options?: {
+        method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+        headers?: Record<string, string>;
+        body?: string | object;
+    }): {
+        ok: boolean;
+        status?: number;
+        body?: string;
+        error?: string;
+    };
 
-        password: {
-            /**
-             * Hash a password securely using bcrypt.
-             */
-            hash(password: string): string;
+    jwt: {
+        sign(
+            payload: object,
+            secret: string,
+            options?: { expiresIn?: string | number }
+        ): string;
+        verify(token: string, secret: string): any;
+    };
 
-            /**
-             * Verify a password against a bcrypt hash.
-             */
-            verify(password: string, hash: string): boolean;
-        };
+    password: {
+        hash(password: string): string;
+        verify(password: string, hash: string): boolean;
+    };
 
-        db: {
-            /**
-             * Connect to a PostgreSQL database.
-             * @param url Connection string (e.g. postgres://user:pass@localhost:5432/db)
-             */
-            connect(url: string): DbConnection;
-        };
+    db: {
+        connect(url: string): DbConnection;
     };
-}
+};
 
-export { };

package/templates/jsconfig.json

@@ -0,0 +1,19 @@
+{
+    "compilerOptions": {
+        "module": "esnext",
+        "target": "esnext",
+        "checkJs": false,
+        "noImplicitAny": false,
+        "allowJs": true,
+        "moduleResolution": "node",
+        "baseUrl": ".",
+        "paths": {
+            "*": [
+                "./app/*"
+            ]
+        }
+    },
+    "include": [
+        "app/**/*"
+    ]
+}