titanpl-sdk 2.0.2 → 2.0.4

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/package.json

@@ -1,36 +1,40 @@
 {
-    "name": "titanpl-sdk",
-    "version": "2.0.2",
-    "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": "2.0.4",
+  "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",
+    "@titanpl/node": "latest"
+  },
+  "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};
@@ -19,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") {
@@ -78,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,
@@ -138,10 +139,7 @@ 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();
     

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{}",