titanpl-sdk 1.0.9 → 1.5.0

package/README.md

@@ -24,6 +24,8 @@ It provides the necessary **Type Definitions** to make your IDE understand the g
 
 > **Note:** The actual implementation of `t.log`, `t.fetch`, and other APIs are embedded directly into the [Titan Planet Binary](https://github.com/ezet-galaxy/titanpl). This SDK simply provides the "blueprints" (types) and a "sandbox" (test runner).
 
+**Important Note:** Currently, Titan Planet and its entire package ecosystem are only for Windows. The Linux version is in development (dev only) for the new architecture and will be launched later.
+
 ---
 
 ## ✨ Features

package/bin/run.js

@@ -198,24 +198,24 @@ await import("${name}");
 // Extension test harness for: ${name}
 const ext = t["${name}"];
 
-console.log("---------------------------------------------------");
-console.log("Testing Extension: ${name}");
-console.log("---------------------------------------------------");
+t.log("---------------------------------------------------");
+t.log("Testing Extension: ${name}");
+t.log("---------------------------------------------------");
 
 if (!ext) {
     console.log("ERROR: Extension '${name}' not found in global 't'.");
 } else {
-    console.log("✓ Extension loaded successfully!");
-    console.log("✓ Available methods:", Object.keys(ext).join(", "));
+    t.log("✓ Extension loaded successfully!");
+    t.log("✓ Available methods:", Object.keys(ext).join(", "));
     
     // Try 'hello' if it exists
     if (typeof ext.hello === 'function') {
         console.log("\\nTesting ext.hello('Titan')...");
         try {
            const res = ext.hello("Titan");
-           console.log("✓ Result:", res);
+           t.log("✓ Result:", res);
         } catch(e) {
-           console.log("✗ Error:", e.message);
+           t.log("✗ Error:", e.message);
         }
     }
 
@@ -224,25 +224,25 @@ if (!ext) {
         console.log("\\nTesting ext.calc(10, 20)...");
         try {
             const res = ext.calc(10, 20);
-            console.log("✓ Result:", res);
+            t.log("✓ Result:", res);
         } catch(e) {
-            console.log("✗ Error:", e.message);
+            t.log("✗ Error:", e.message);
         }
     }
 }
 
-console.log("---------------------------------------------------");
-console.log("✓ Test complete!");
-console.log("\\n📍 Routes:");
-console.log("  GET  http://localhost:3000/      → Test harness info");
-console.log("  GET  http://localhost:3000/test  → Extension test results (JSON)");
-console.log("---------------------------------------------------\\n");
+t.log("---------------------------------------------------");
+t.log("✓ Test complete!");
+t.log("\\n📍 Routes:");
+t.log("  GET  http://localhost:3000/      → Test harness info");
+t.log("  GET  http://localhost:3000/test  → Extension test results (JSON)");
+t.log("---------------------------------------------------\\n");
 
 // Create routes
 t.get("/test").action("test");
 t.get("/").reply("🚀 Extension Test Harness for ${name}\\n\\nVisit /test to see extension test results");
 
-await t.start(3000, "Titan Extension Test Running!");
+await t.start(3000, "Titan Extension Test Running!", 10, 16);
 `;
         fs.writeFileSync(appJsPath, testScript);
     }

package/package.json

@@ -1,36 +1,40 @@
 {
-    "name": "titanpl-sdk",
-    "version": "1.0.9",
-    "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",
-    "dependencies": {
-        "@titanpl/core": "latest"
-    }
+  "name": "titanpl-sdk",
+  "version": "1.5.0",
+  "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",
+  "dependencies": {
+    "@titanpl/core": "1.4.0",
+    "@titanpl/node": "1.4.0"
+  },
+  "devDependencies": {
+    "@tgrv/microgravity": "latest"
+  }
 }

package/templates/app/app.js

@@ -1,7 +1,4 @@
-import t from "../titan/titan.js";
-
-
-
+import t from "@titanpl/route";
 
 t.post("/hello").action("hello") // pass a json payload { "name": "titan" }
 

package/templates/server/Cargo.toml

@@ -1,4 +1,3 @@
-
 [package]
 name = "titan-server"
 version = "0.1.0"
@@ -11,7 +10,7 @@ reqwest = { version = "0.12.24", features = ["json", "rustls-tls", "gzip", "brot
 serde = { version = "1.0.228", features = ["derive"] }
 serde_json = "1.0.145"
 thiserror = "2.0.17"
-tokio = { version = "1.48.0", features = ["rt-multi-thread", "macros", "process"] }
+tokio = { version = "1.48.0", features = ["rt-multi-thread", "macros", "process", "fs"] }
 tower-http = { version = "0.6.7", features = ["cors"] }
 tracing = "0.1.43"
 tracing-subscriber = "0.3.22"
@@ -30,3 +29,24 @@ dashmap = "6.1.0"
 bytes = "1.11.0"
 smallvec = "1.15.1"
 num_cpus = "1.17.0"
+deadpool-postgres = "0.12"
+tokio-postgres = "0.7"
+
+# Performance: Global Allocator
+mimalloc = { version = "0.1", default-features = false }
+
+# Static Analysis: OXC (Zero runtime cost, used at startup)
+oxc = { version = "0.108", features = ["semantic"] }
+
+# Release Profile
+[profile.release]
+opt-level = 3
+lto = "fat"
+codegen-units = 1
+panic = "abort"
+strip = true
+
+# Dev Profile
+[profile.dev]
+opt-level = 0
+debug = 1

package/templates/server/src/action_management.rs

@@ -1,3 +1,8 @@
+//! Action Management and Dynamic Routing
+//!
+//! Handles resolution of action directories, scanning for available actions,
+//! and matching dynamic routes (e.g. `/users/:id`).
+
 use std::collections::HashMap;
 use std::env;
 use std::path::{Path, PathBuf};
@@ -8,6 +13,7 @@ use serde_json::Value;
 #[derive(Debug, Deserialize, Clone)]
 pub struct RouteVal {
     pub r#type: String,
+    #[serde(alias = "target")]
     pub value: Value,
 }
 
@@ -18,10 +24,7 @@ pub struct DynamicRoute {
     pub action: String,
 }
 
-// -------------------------
-// ACTION DIRECTORY RESOLUTION
-// -------------------------
-
+/// Resolve the directory path where actions are stored.
 pub fn resolve_actions_dir() -> PathBuf {
     // Respect explicit override first
     if let Ok(override_dir) = env::var("TITAN_ACTIONS_DIR") {
@@ -33,30 +36,36 @@ pub fn resolve_actions_dir() -> PathBuf {
         return PathBuf::from("/app/actions");
     }
 
-    // Try to walk up from the executing binary to discover `<...>/server/actions`
+    // Try to walk up from the executing binary to discover `<...>/server/src/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");
+                    let candidate = server_dir.join("src").join("actions");
                     if candidate.exists() {
                         return candidate;
                     }
+                    let candidate2 = server_dir.join("actions");
+                    if candidate2.exists() {
+                        return candidate2;
+                    }
                 }
             }
         }
     }
 
-    // Fall back to local ./actions
-    PathBuf::from("./actions")
+    // Fall back to local ./src/actions
+    PathBuf::from("./src/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("src").join("actions"),
+        project_root.join("server").join("actions"),
         project_root.join("app").join("actions"),
         project_root.join("actions"),
-        project_root.join("server").join("actions"),
+
         project_root.join("..").join("server").join("actions"),
         PathBuf::from("/app").join("actions"),
         PathBuf::from("actions"),
@@ -71,8 +80,7 @@ pub fn find_actions_dir(project_root: &PathBuf) -> Option<PathBuf> {
     None
 }
 
-// Dynamic Matcher (Core Logic)
-
+/// Match a dynamic route against the current request path.
 pub fn match_dynamic_route(
     method: &str,
     path: &str,
@@ -131,24 +139,20 @@ pub fn match_dynamic_route(
     None
 }
 
-// -------------------------
-// ACTION SCANNING
-// -------------------------
-
+/// Scan the resolved actions directory and return a map of action names to file paths.
 pub fn scan_actions(root: &PathBuf) -> HashMap<String, PathBuf> {
     let mut map = HashMap::new();
     
-    // Locate actions dir
-    let actions_dir = resolve_actions_dir();
-    let dir = if actions_dir.exists() {
-        actions_dir
-    } else {
-        match find_actions_dir(root) {
-            Some(d) => d,
-            None => return map, 
+    // Locate actions dir - Priority: project root relative paths
+    let dir = match find_actions_dir(root) {
+        Some(d) => d,
+        None => {
+            let ad = resolve_actions_dir();
+            if ad.exists() { ad } else { return map; }
         }
     };
 
+    // Scanning actions
     if let Ok(entries) = std::fs::read_dir(dir) {
         for entry in entries.flatten() {
             let path = entry.path();
@@ -162,9 +166,10 @@ pub fn scan_actions(root: &PathBuf) -> HashMap<String, PathBuf> {
             let file_stem = path.file_stem().and_then(|s| s.to_str()).unwrap_or("");
             if file_stem.is_empty() { continue; }
             
+            // Found action
             map.insert(file_stem.to_string(), path);
         }
     }
     
     map
-}
+}

package/templates/server/src/errors.rs

@@ -1,6 +1,8 @@
+//! Error handling utilities.
+
 use v8::JsError;
 
-// A helper to Format v8 Errors
+/// A helper to Format v8 Errors
 pub fn format_js_error(err: JsError, action: &str) -> String {
     format!(
         "Action: {}\n{}",