@ezetgalaxy/titan 26.9.1 → 26.9.2

package/templates/rust-ts/titan/titan.d.ts

@@ -1,117 +1,117 @@
-
-// -- Module Definitions (for imports from "titan") --
-
-export interface RouteHandler {
-    reply(value: any): void;
-    action(name: string): void;
-}
-
-export interface TitanBuilder {
-    get(route: string): RouteHandler;
-    post(route: string): RouteHandler;
-    log(module: string, msg: string): void;
-    start(port?: number, msg?: string): Promise<void>;
-}
-
-// The default export from titan.js is the Builder
-declare const builder: TitanBuilder;
-export default builder;
-
-/**
- * Define a Titan Action with type inference.
- */
-export declare function defineAction<T>(actionFn: (req: TitanRequest) => T): (req: TitanRequest) => T;
-
-
-// -- Global Definitions (Runtime Environment) --
-
-declare global {
-    /**
-     * 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 {
-        /**
-         * 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[];
-    }
-
-    /**
-     * Global defineAction (available without import in runtime, though imports are preferred in TS)
-     */
-    function defineAction<T>(actionFn: (req: TitanRequest) => T): (req: TitanRequest) => T;
-
-    /**
-     * Global Request Object
-     * Available automatically in actions.
-     */
-    var req: TitanRequest;
-
-    /**
-     * Titan Runtime Utilities
-     * (Available globally in the runtime, e.g. inside actions)
-     */
-    const t: {
-        /**
-         * Log messages to the server console with Titan formatting.
-         */
-        log(...args: any[]): void;
-
-        /**
-         * Read a file contents as string.
-         * @param path Relative path to the file from project root.
-         */
-        read(path: string): string;
-
-        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;
-        };
-
-        jwt: {
-            sign(
-                payload: object,
-                secret: string,
-                options?: { expiresIn?: string | number }
-            ): string;
-            verify(token: string, secret: string): any;
-        };
-
-        password: {
-            hash(password: string): string;
-            verify(password: string, hash: string): boolean;
-        };
-
-        db: {
-            connect(url: string): DbConnection;
-        };
-
-        /**
-         * Titan Validator (Zod-compatible)
-         */
-        valid: any;
-    };
-}
+
+// -- Module Definitions (for imports from "titan") --
+
+export interface RouteHandler {
+    reply(value: any): void;
+    action(name: string): void;
+}
+
+export interface TitanBuilder {
+    get(route: string): RouteHandler;
+    post(route: string): RouteHandler;
+    log(module: string, msg: string): void;
+    start(port?: number, msg?: string): Promise<void>;
+}
+
+// The default export from titan.js is the Builder
+declare const builder: TitanBuilder;
+export default builder;
+
+/**
+ * Define a Titan Action with type inference.
+ */
+export declare function defineAction<T>(actionFn: (req: TitanRequest) => T): (req: TitanRequest) => T;
+
+
+// -- Global Definitions (Runtime Environment) --
+
+declare global {
+    /**
+     * 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 {
+        /**
+         * 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[];
+    }
+
+    /**
+     * Global defineAction (available without import in runtime, though imports are preferred in TS)
+     */
+    function defineAction<T>(actionFn: (req: TitanRequest) => T): (req: TitanRequest) => T;
+
+    /**
+     * Global Request Object
+     * Available automatically in actions.
+     */
+    var req: TitanRequest;
+
+    /**
+     * Titan Runtime Utilities
+     * (Available globally in the runtime, e.g. inside actions)
+     */
+    const t: {
+        /**
+         * Log messages to the server console with Titan formatting.
+         */
+        log(...args: any[]): void;
+
+        /**
+         * Read a file contents as string.
+         * @param path Relative path to the file from project root.
+         */
+        read(path: string): string;
+
+        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;
+        };
+
+        jwt: {
+            sign(
+                payload: object,
+                secret: string,
+                options?: { expiresIn?: string | number }
+            ): string;
+            verify(token: string, secret: string): any;
+        };
+
+        password: {
+            hash(password: string): string;
+            verify(password: string, hash: string): boolean;
+        };
+
+        db: {
+            connect(url: string): DbConnection;
+        };
+
+        /**
+         * Titan Validator (Zod-compatible)
+         */
+        valid: any;
+    };
+}

package/templates/rust-ts/titan/titan.js

@@ -2,7 +2,7 @@ import { bundle } from "./bundle.js";
 import fs from "fs";
 import path from "path";
 
-export const defineAction = (handler) => handler;
+export * from "./runtime.js";
 
 const cyan = (t) => `\x1b[36m${t}\x1b[0m`;
 const green = (t) => `\x1b[32m${t}\x1b[0m`;

package/templates/ts/app/actions/hello.ts

@@ -2,7 +2,7 @@ interface HelloResponse {
     message: string;
 }
 
-import { defineAction } from "../../titan/titan";
+import { defineAction } from "../../titan/runtime";
 
 export const hello = defineAction((req): HelloResponse => {
     return {

package/templates/ts/titan/builder.js

@@ -1,121 +1,121 @@
-import { bundle } from "./bundle.js";
-import fs from "fs";
-import path from "path";
-
-const cyan = (t) => `\x1b[36m${t}\x1b[0m`;
-const green = (t) => `\x1b[32m${t}\x1b[0m`;
-
-const routes = {};
-const dynamicRoutes = {};
-const actionMap = {};
-
-function addRoute(method, route) {
-    const key = `${method.toUpperCase()}:${route}`;
-
-
-    return {
-        reply(value) {
-            routes[key] = {
-                type: typeof value === "object" ? "json" : "text",
-                value
-            };
-        },
-
-        action(name) {
-            if (route.includes(":")) {
-                if (!dynamicRoutes[method]) dynamicRoutes[method] = [];
-                dynamicRoutes[method].push({
-                    method: method.toUpperCase(),
-                    pattern: route,
-                    action: name
-                });
-            } else {
-                routes[key] = {
-                    type: "action",
-                    value: name
-                };
-                actionMap[key] = name;
-            }
-        }
-    };
-}
-
-/**
- * @typedef {Object} RouteHandler
- * @property {(value: any) => void} reply - Send a direct response
- * @property {(name: string) => void} action - Bind to a server-side action
- */
-
-/**
- * Titan App Builder
- */
-const t = {
-    /**
-     * Define a GET route
-     * @param {string} route 
-     * @returns {RouteHandler}
-     */
-    get(route) {
-        return addRoute("GET", route);
-    },
-
-    /**
-     * Define a POST route
-     * @param {string} route 
-     * @returns {RouteHandler}
-     */
-    post(route) {
-        return addRoute("POST", route);
-    },
-
-    log(module, msg) {
-        console.log(`[\x1b[35m${module}\x1b[0m] ${msg}`);
-    },
-
-    /**
-     * Start the Titan Server
-     * @param {number} [port=3000] 
-     * @param {string} [msg=""] 
-     */
-    async start(port = 3000, msg = "") {
-        try {
-            console.log(cyan("[Titan] Preparing runtime..."));
-            await bundle();
-
-            const base = path.join(process.cwd(), "server");
-            if (!fs.existsSync(base)) {
-                fs.mkdirSync(base, { recursive: true });
-            }
-
-            const routesPath = path.join(base, "routes.json");
-            const actionMapPath = path.join(base, "action_map.json");
-
-            fs.writeFileSync(
-                routesPath,
-                JSON.stringify(
-                    {
-                        __config: { port },
-                        routes,
-                        __dynamic_routes: Object.values(dynamicRoutes).flat()
-                    },
-                    null,
-                    2
-                )
-            );
-
-            fs.writeFileSync(
-                actionMapPath,
-                JSON.stringify(actionMap, null, 2)
-            );
-
-            console.log(green("✔ Titan metadata written successfully"));
-            if (msg) console.log(cyan(msg));
-
-        } catch (e) {
-            console.error(`\x1b[31m[Titan] Build Error: ${e.message}\x1b[0m`);
-            process.exit(1);
-        }
-    }
-};
-
-export default t;
+import { bundle } from "./bundle.js";
+import fs from "fs";
+import path from "path";
+
+const cyan = (t) => `\x1b[36m${t}\x1b[0m`;
+const green = (t) => `\x1b[32m${t}\x1b[0m`;
+
+const routes = {};
+const dynamicRoutes = {};
+const actionMap = {};
+
+function addRoute(method, route) {
+    const key = `${method.toUpperCase()}:${route}`;
+
+
+    return {
+        reply(value) {
+            routes[key] = {
+                type: typeof value === "object" ? "json" : "text",
+                value
+            };
+        },
+
+        action(name) {
+            if (route.includes(":")) {
+                if (!dynamicRoutes[method]) dynamicRoutes[method] = [];
+                dynamicRoutes[method].push({
+                    method: method.toUpperCase(),
+                    pattern: route,
+                    action: name
+                });
+            } else {
+                routes[key] = {
+                    type: "action",
+                    value: name
+                };
+                actionMap[key] = name;
+            }
+        }
+    };
+}
+
+/**
+ * @typedef {Object} RouteHandler
+ * @property {(value: any) => void} reply - Send a direct response
+ * @property {(name: string) => void} action - Bind to a server-side action
+ */
+
+/**
+ * Titan App Builder
+ */
+const t = {
+    /**
+     * Define a GET route
+     * @param {string} route 
+     * @returns {RouteHandler}
+     */
+    get(route) {
+        return addRoute("GET", route);
+    },
+
+    /**
+     * Define a POST route
+     * @param {string} route 
+     * @returns {RouteHandler}
+     */
+    post(route) {
+        return addRoute("POST", route);
+    },
+
+    log(module, msg) {
+        console.log(`[\x1b[35m${module}\x1b[0m] ${msg}`);
+    },
+
+    /**
+     * Start the Titan Server
+     * @param {number} [port=3000] 
+     * @param {string} [msg=""] 
+     */
+    async start(port = 3000, msg = "") {
+        try {
+            console.log(cyan("[Titan] Preparing runtime..."));
+            await bundle();
+
+            const base = path.join(process.cwd(), "server");
+            if (!fs.existsSync(base)) {
+                fs.mkdirSync(base, { recursive: true });
+            }
+
+            const routesPath = path.join(base, "routes.json");
+            const actionMapPath = path.join(base, "action_map.json");
+
+            fs.writeFileSync(
+                routesPath,
+                JSON.stringify(
+                    {
+                        __config: { port },
+                        routes,
+                        __dynamic_routes: Object.values(dynamicRoutes).flat()
+                    },
+                    null,
+                    2
+                )
+            );
+
+            fs.writeFileSync(
+                actionMapPath,
+                JSON.stringify(actionMap, null, 2)
+            );
+
+            console.log(green("✔ Titan metadata written successfully"));
+            if (msg) console.log(cyan(msg));
+
+        } catch (e) {
+            console.error(`\x1b[31m[Titan] Build Error: ${e.message}\x1b[0m`);
+            process.exit(1);
+        }
+    }
+};
+
+export default t;

package/templates/ts/titan/runtime.d.ts

@@ -0,0 +1 @@
+export declare function defineAction<Req = any, Res = any>(handler: (req: Req) => Res): (req: Req) => Res;

package/templates/ts/titan/runtime.js

@@ -1 +1 @@
-export const defineAction = (handler) => handler;
+export const defineAction = (handler) => handler;