@ezetgalaxy/titan 26.9.1 → 26.9.2

package/templates/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/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/rust-js/Dockerfile

@@ -1,66 +0,0 @@
-# ================================================================
-# STAGE 1 — Build Titan (JS → Rust)
-# ================================================================
-FROM rust:1.91.1 AS builder
-
-# Install Node for Titan CLI + bundler
-RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
-    && apt-get install -y nodejs
-
-# Install Titan CLI (latest)
-RUN npm install -g @ezetgalaxy/titan@latest
-
-WORKDIR /app
-
-# Copy project files
-COPY . .
-
-# Install JS dependencies (needed for Titan DSL + bundler)
-RUN npm install
-
-SHELL ["/bin/bash", "-c"]
-
-# Extract Titan extensions into .ext
-RUN mkdir -p /app/.ext && \
-    find /app/node_modules -maxdepth 5 -type f -name "titan.json" -print0 | \
-    while IFS= read -r -d '' file; do \
-    pkg_dir="$(dirname "$file")"; \
-    pkg_name="$(basename "$pkg_dir")"; \
-    echo "Copying Titan extension: $pkg_name from $pkg_dir"; \
-    cp -r "$pkg_dir" "/app/.ext/$pkg_name"; \
-    done && \
-    echo "Extensions in .ext:" && \
-    ls -R /app/.ext
-
-# Build Titan metadata + bundle JS actions
-RUN titan build
-
-# Build Rust binary
-RUN cd server && cargo build --release
-
-
-
-# ================================================================
-# STAGE 2 — Runtime Image (Lightweight)
-# ================================================================
-FROM debian:stable-slim
-
-WORKDIR /app
-
-# Copy Rust binary from builder stage
-COPY --from=builder /app/server/target/release/titan-server ./titan-server
-
-# Copy Titan routing metadata
-COPY --from=builder /app/server/routes.json ./routes.json
-COPY --from=builder /app/server/action_map.json ./action_map.json
-
-# Copy Titan JS bundles
-RUN mkdir -p /app/actions
-COPY --from=builder /app/server/actions /app/actions
-
-# Copy only Titan extensions
-COPY --from=builder /app/.ext ./.ext
-
-EXPOSE 3000
-
-CMD ["./titan-server"]

package/templates/rust-js/_dockerignore

@@ -1,3 +0,0 @@
-node_modules
-npm-debug.log
-.git

package/templates/rust-js/_gitignore

@@ -1,38 +0,0 @@
-# Node & Packages
-node_modules/
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-package-lock.json
-yarn.lock
-
-# Titan Runtime (Auto-generated - DO NOT COMMIT)
-titan/server-bin*
-.titan/
-.ext/
-server/routes.json
-server/action_map.json
-server/actions/
-server/titan/
-server/src/actions_rust/
-
-# Rust Build Artifacts
-server/target/
-Cargo.lock
-
-# OS Files
-.DS_Store
-Thumbs.db
-*.tmp
-*.bak
-
-# Environment & Secrets
-.env
-.env.local
-.env.*.local
-
-# IDEs
-.vscode/
-.idea/
-*.swp
-*.swo

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

@@ -1,101 +0,0 @@
-export { };
-
-declare global {
-  /**
-   * TITAN TYPE DEFINITIONS
-   * ----------------------
-   * These types are globally available in your Titan project.
-   */
-
-  /**
-   * 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[];
-  }
-
-  /**
-   * Define a Titan Action with type inference.
-   * @example
-   * export const hello = defineAction((req) => {
-   *   return req.headers;
-   * });
-   */
-  function defineAction<T>(actionFn: (req: TitanRequest) => T): (req: TitanRequest) => T;
-
-  /**
-   * Titan Runtime Utilities
-   */
-  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: typeof import("@titanpl/valid");
-  };
-
-  /**
-   * Global Request Object
-   * Available automatically in actions.
-   */
-  var req: TitanRequest;
-}

package/templates/rust-ts/Dockerfile

@@ -1,66 +0,0 @@
-# ================================================================
-# STAGE 1 — Build Titan (JS → Rust)
-# ================================================================
-FROM rust:1.91.1 AS builder
-
-# Install Node for Titan CLI + bundler
-RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
-    && apt-get install -y nodejs
-
-# Install Titan CLI (latest)
-RUN npm install -g @ezetgalaxy/titan@latest
-
-WORKDIR /app
-
-# Copy project files
-COPY . .
-
-# Install JS dependencies (needed for Titan DSL + bundler)
-RUN npm install
-
-SHELL ["/bin/bash", "-c"]
-
-# Extract Titan extensions into .ext
-RUN mkdir -p /app/.ext && \
-    find /app/node_modules -maxdepth 5 -type f -name "titan.json" -print0 | \
-    while IFS= read -r -d '' file; do \
-    pkg_dir="$(dirname "$file")"; \
-    pkg_name="$(basename "$pkg_dir")"; \
-    echo "Copying Titan extension: $pkg_name from $pkg_dir"; \
-    cp -r "$pkg_dir" "/app/.ext/$pkg_name"; \
-    done && \
-    echo "Extensions in .ext:" && \
-    ls -R /app/.ext
-
-# Build Titan metadata + bundle JS actions
-RUN titan build
-
-# Build Rust binary
-RUN cd server && cargo build --release
-
-
-
-# ================================================================
-# STAGE 2 — Runtime Image (Lightweight)
-# ================================================================
-FROM debian:stable-slim
-
-WORKDIR /app
-
-# Copy Rust binary from builder stage
-COPY --from=builder /app/server/target/release/titan-server ./titan-server
-
-# Copy Titan routing metadata
-COPY --from=builder /app/server/routes.json ./routes.json
-COPY --from=builder /app/server/action_map.json ./action_map.json
-
-# Copy Titan JS bundles
-RUN mkdir -p /app/actions
-COPY --from=builder /app/server/actions /app/actions
-
-# Copy only Titan extensions
-COPY --from=builder /app/.ext ./.ext
-
-EXPOSE 3000
-
-CMD ["./titan-server"]

package/templates/rust-ts/_dockerignore

@@ -1,3 +0,0 @@
-node_modules
-npm-debug.log
-.git

package/templates/rust-ts/_gitignore

@@ -1,38 +0,0 @@
-# Node & Packages
-node_modules/
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-package-lock.json
-yarn.lock
-
-# Titan Runtime (Auto-generated - DO NOT COMMIT)
-titan/server-bin*
-.titan/
-.ext/
-server/routes.json
-server/action_map.json
-server/actions/
-server/titan/
-server/src/actions_rust/
-
-# Rust Build Artifacts
-server/target/
-Cargo.lock
-
-# OS Files
-.DS_Store
-Thumbs.db
-*.tmp
-*.bak
-
-# Environment & Secrets
-.env
-.env.local
-.env.*.local
-
-# IDEs
-.vscode/
-.idea/
-*.swp
-*.swo

package/templates/ts/Dockerfile

@@ -1,40 +0,0 @@
-# ================================================================
-# STAGE 1 — Build
-# ================================================================
-FROM node:20-slim AS builder
-
-# Install Titan CLI (latest)
-RUN npm install -g @ezetgalaxy/titan@latest
-
-WORKDIR /app
-
-# Copy project files
-COPY . .
-
-# Install JS dependencies
-RUN npm install
-
-# Build Titan App
-RUN titan build
-
-# ================================================================
-# STAGE 2 — Runtime
-# ================================================================
-FROM node:20-slim
-
-WORKDIR /app
-
-# Copy Titan Build Artifacts
-COPY --from=builder /app/.titan ./.titan
-COPY --from=builder /app/server ./server
-COPY --from=builder /app/package.json ./package.json
-
-# Install dependencies (production only, but for now we might need all if not careful)
-# Actually, the runtime depends on `express`-like behavior?
-# No, Titan pure TS runs via `node .titan/app.js` which might need deps?
-# The user's package.json has dependencies.
-RUN npm install --omit=dev
-
-EXPOSE 3000
-
-CMD ["node", ".titan/app.js"]

package/templates/ts/_dockerignore

@@ -1,3 +0,0 @@
-node_modules
-npm-debug.log
-.git

package/templates/ts/_gitignore

@@ -1,38 +0,0 @@
-# Node & Packages
-node_modules/
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-package-lock.json
-yarn.lock
-
-# Titan Runtime (Auto-generated - DO NOT COMMIT)
-titan/server-bin*
-.titan/
-.ext/
-server/routes.json
-server/action_map.json
-server/actions/
-server/titan/
-server/src/actions_rust/
-
-# Rust Build Artifacts
-server/target/
-Cargo.lock
-
-# OS Files
-.DS_Store
-Thumbs.db
-*.tmp
-*.bak
-
-# Environment & Secrets
-.env
-.env.local
-.env.*.local
-
-# IDEs
-.vscode/
-.idea/
-*.swp
-*.swo