@ezetgalaxy/titan 26.8.3 → 26.9.0

package/titanpl-sdk/package.json

@@ -1,33 +1,33 @@
-{
-    "name": "titanpl-sdk",
-    "version": "0.1.6",
-    "description": "Development SDK for Titan Planet. Provides TypeScript type definitions for the global 't' runtime object and a 'lite' test-harness runtime for building and verifying extensions.",
-    "main": "index.js",
-    "type": "module",
-    "types": "index.d.ts",
-    "bin": {
-        "titanpl-sdk": "./bin/run.js"
-    },
-    "files": [
-        "bin/",
-        "templates/",
-        "titan",
-        "assets",
-        "index.js",
-        "index.d.ts",
-        "README.md"
-    ],
-    "keywords": [
-        "titan",
-        "titan-planet",
-        "titanpl-sdk",
-        "ezetgalaxy",
-        "types",
-        "typescript",
-        "intellisense",
-        "sdk",
-        "backend-sdk",
-        "extension-development"
-    ],
-    "license": "ISC"
+{
+    "name": "titanpl-sdk",
+    "version": "0.1.6",
+    "description": "Development SDK for Titan Planet. Provides TypeScript type definitions for the global 't' runtime object and a 'lite' test-harness runtime for building and verifying extensions.",
+    "main": "index.js",
+    "type": "module",
+    "types": "index.d.ts",
+    "bin": {
+        "titanpl-sdk": "./bin/run.js"
+    },
+    "files": [
+        "bin/",
+        "templates/",
+        "titan",
+        "assets",
+        "index.js",
+        "index.d.ts",
+        "README.md"
+    ],
+    "keywords": [
+        "titan",
+        "titan-planet",
+        "titanpl-sdk",
+        "ezetgalaxy",
+        "types",
+        "typescript",
+        "intellisense",
+        "sdk",
+        "backend-sdk",
+        "extension-development"
+    ],
+    "license": "ISC"
 }

package/titanpl-sdk/templates/.dockerignore

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

package/titanpl-sdk/templates/Dockerfile

@@ -1,53 +1,53 @@
-# ================================================================
-# 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
-
-# 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/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 --from=builder /app/db /app/assets
-
-# Expose Titan port
-EXPOSE 3000
-
-# Start Titan
-CMD ["./titan-server"]
+# ================================================================
+# 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
+
+# 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/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 --from=builder /app/db /app/assets
+
+# Expose Titan port
+EXPOSE 3000
+
+# Start Titan
+CMD ["./titan-server"]

package/titanpl-sdk/templates/app/actions/hello.js

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

package/titanpl-sdk/templates/app/titan.d.ts

@@ -1,87 +1,87 @@
-/**
- * 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;
- * });
- */
-declare function defineAction<T>(actionFn: (req: TitanRequest) => T): (req: TitanRequest) => T;
-
-/**
- * Titan Runtime Utilities
- */
-declare 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 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;
+ * });
+ */
+declare function defineAction<T>(actionFn: (req: TitanRequest) => T): (req: TitanRequest) => T;
+
+/**
+ * Titan Runtime Utilities
+ */
+declare 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;
+    };
+};
+

package/titanpl-sdk/templates/jsconfig.json

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

package/titanpl-sdk/templates/server/src/action_management.rs

@@ -1,131 +1,131 @@
-use std::collections::HashMap;
-use std::env;
-use std::path::{Path, PathBuf};
-use serde::Deserialize;
-use serde_json::Value;
-
-/// Route configuration (loaded from routes.json)
-#[derive(Debug, Deserialize, Clone)]
-pub struct RouteVal {
-    pub r#type: String,
-    pub value: Value,
-}
-
-#[derive(Debug, Deserialize, Clone)]
-pub struct DynamicRoute {
-    pub method: String,
-    pub pattern: String,
-    pub action: String,
-}
-
-// -------------------------
-// ACTION DIRECTORY RESOLUTION
-// -------------------------
-
-pub fn resolve_actions_dir() -> PathBuf {
-    // Respect explicit override first
-    if let Ok(override_dir) = env::var("TITAN_ACTIONS_DIR") {
-        return PathBuf::from(override_dir);
-    }
-
-    // Production container layout
-    if Path::new("/app/actions").exists() {
-        return PathBuf::from("/app/actions");
-    }
-
-    // Try to walk up from the executing binary to discover `<...>/server/actions`
-    if let Ok(exe) = std::env::current_exe() {
-        if let Some(parent) = exe.parent() {
-            if let Some(target_dir) = parent.parent() {
-                if let Some(server_dir) = target_dir.parent() {
-                    let candidate = server_dir.join("actions");
-                    if candidate.exists() {
-                        return candidate;
-                    }
-                }
-            }
-        }
-    }
-
-    // Fall back to local ./actions
-    PathBuf::from("./actions")
-}
-
-/// Try to find the directory that contains compiled action bundles.
-pub fn find_actions_dir(project_root: &PathBuf) -> Option<PathBuf> {
-    let candidates = [
-        project_root.join("server").join("actions"),
-        project_root.join("actions"),
-        project_root.join("..").join("server").join("actions"),
-        PathBuf::from("/app").join("actions"),
-        PathBuf::from("actions"),
-    ];
-
-    for p in &candidates {
-        if p.exists() && p.is_dir() {
-            return Some(p.clone());
-        }
-    }
-
-    None
-}
-
-// Dynamic Matcher (Core Logic)
-
-pub fn match_dynamic_route(
-    method: &str,
-    path: &str,
-    routes: &[DynamicRoute],
-) -> Option<(String, HashMap<String, String>)> {
-    let path_segments: Vec<&str> =
-        path.trim_matches('/').split('/').collect();
-
-    for route in routes {
-        if route.method != method {
-            continue;
-        }
-
-        let pattern_segments: Vec<&str> =
-            route.pattern.trim_matches('/').split('/').collect();
-
-        if pattern_segments.len() != path_segments.len() {
-            continue;
-        }
-
-        let mut params = HashMap::new();
-        let mut matched = true;
-
-        for (pat, val) in pattern_segments.iter().zip(path_segments.iter()) {
-            if pat.starts_with(':') {
-                let inner = &pat[1..];
-
-                let (name, ty) = inner
-                    .split_once('<')
-                    .map(|(n, t)| (n, t.trim_end_matches('>')))
-                    .unwrap_or((inner, "string"));
-
-                let valid = match ty {
-                    "number" => val.parse::<i64>().is_ok(),
-                    "string" => true,
-                    _ => false,
-                };
-
-                if !valid {
-                    matched = false;
-                    break;
-                }
-
-                params.insert(name.to_string(), (*val).to_string());
-            } else if pat != val {
-                matched = false;
-                break;
-            }
-        }
-
-        if matched {
-            return Some((route.action.clone(), params));
-        }
-    }
-
-    None
-}
+use std::collections::HashMap;
+use std::env;
+use std::path::{Path, PathBuf};
+use serde::Deserialize;
+use serde_json::Value;
+
+/// Route configuration (loaded from routes.json)
+#[derive(Debug, Deserialize, Clone)]
+pub struct RouteVal {
+    pub r#type: String,
+    pub value: Value,
+}
+
+#[derive(Debug, Deserialize, Clone)]
+pub struct DynamicRoute {
+    pub method: String,
+    pub pattern: String,
+    pub action: String,
+}
+
+// -------------------------
+// ACTION DIRECTORY RESOLUTION
+// -------------------------
+
+pub fn resolve_actions_dir() -> PathBuf {
+    // Respect explicit override first
+    if let Ok(override_dir) = env::var("TITAN_ACTIONS_DIR") {
+        return PathBuf::from(override_dir);
+    }
+
+    // Production container layout
+    if Path::new("/app/actions").exists() {
+        return PathBuf::from("/app/actions");
+    }
+
+    // Try to walk up from the executing binary to discover `<...>/server/actions`
+    if let Ok(exe) = std::env::current_exe() {
+        if let Some(parent) = exe.parent() {
+            if let Some(target_dir) = parent.parent() {
+                if let Some(server_dir) = target_dir.parent() {
+                    let candidate = server_dir.join("actions");
+                    if candidate.exists() {
+                        return candidate;
+                    }
+                }
+            }
+        }
+    }
+
+    // Fall back to local ./actions
+    PathBuf::from("./actions")
+}
+
+/// Try to find the directory that contains compiled action bundles.
+pub fn find_actions_dir(project_root: &PathBuf) -> Option<PathBuf> {
+    let candidates = [
+        project_root.join("server").join("actions"),
+        project_root.join("actions"),
+        project_root.join("..").join("server").join("actions"),
+        PathBuf::from("/app").join("actions"),
+        PathBuf::from("actions"),
+    ];
+
+    for p in &candidates {
+        if p.exists() && p.is_dir() {
+            return Some(p.clone());
+        }
+    }
+
+    None
+}
+
+// Dynamic Matcher (Core Logic)
+
+pub fn match_dynamic_route(
+    method: &str,
+    path: &str,
+    routes: &[DynamicRoute],
+) -> Option<(String, HashMap<String, String>)> {
+    let path_segments: Vec<&str> =
+        path.trim_matches('/').split('/').collect();
+
+    for route in routes {
+        if route.method != method {
+            continue;
+        }
+
+        let pattern_segments: Vec<&str> =
+            route.pattern.trim_matches('/').split('/').collect();
+
+        if pattern_segments.len() != path_segments.len() {
+            continue;
+        }
+
+        let mut params = HashMap::new();
+        let mut matched = true;
+
+        for (pat, val) in pattern_segments.iter().zip(path_segments.iter()) {
+            if pat.starts_with(':') {
+                let inner = &pat[1..];
+
+                let (name, ty) = inner
+                    .split_once('<')
+                    .map(|(n, t)| (n, t.trim_end_matches('>')))
+                    .unwrap_or((inner, "string"));
+
+                let valid = match ty {
+                    "number" => val.parse::<i64>().is_ok(),
+                    "string" => true,
+                    _ => false,
+                };
+
+                if !valid {
+                    matched = false;
+                    break;
+                }
+
+                params.insert(name.to_string(), (*val).to_string());
+            } else if pat != val {
+                matched = false;
+                break;
+            }
+        }
+
+        if matched {
+            return Some((route.action.clone(), params));
+        }
+    }
+
+    None
+}