titanpl 4.0.2 → 7.0.0-beta

package/templates/common/app/t.native.js

@@ -1,39 +0,0 @@
-// titan.js - Named exports for users who prefer imports over the global `t`
-
-export const fetch = t.fetch;
-export const log = t.log;
-export const read = t.read;
-
-// Authentication & Security
-export const jwt = t.jwt;
-export const password = t.password;
-
-// Database
-export const db = t.db;
-
-// File System & Path
-export const fs = t.fs;
-export const path = t.path;
-
-// Crypto & Buffer
-export const crypto = t.crypto;
-export const buffer = t.buffer;
-
-// Storage & Sessions
-export const ls = t.ls;
-export const localStorage = t.localStorage;
-export const session = t.session;
-export const cookies = t.cookies;
-
-// System
-export const os = t.os;
-export const net = t.net;
-export const proc = t.proc;
-
-// Utilities
-export const time = t.time;
-export const url = t.url;
-export const response = t.response;
-export const valid = t.valid;
-
-export const defineAction = (handler) => handler;

package/titanpl-sdk/LICENSE

@@ -1,15 +0,0 @@
-ISC License
-
-Copyright (c) 2025, Ezet Galaxy
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/titanpl-sdk/README.md

@@ -1,111 +0,0 @@
-
-<div align="center">
-  <img src="./assets/titanpl-sdk.png" alt="Titan SDK Logo" width="120" />
-  <h1>Titan SDK</h1>
-  <p>
-    <b>The Developer Toolkit for Titan Planet. Type safety, IntelliSense, and Extension Testing.</b>
-  </p>
-</div>
-
-<div align="center">
-
-[![npm version](https://img.shields.io/npm/v/titanpl-sdk.svg?style=flat-square)](https://www.npmjs.com/package/titanpl-sdk)
-[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg?style=flat-square)](https://opensource.org/licenses/ISC)
-
-</div>
-
----
-
-## 🌌 Overview
-
-**Titan SDK** is NOT the runtime engine itself. It is a **development-only toolkit** designed to bridge the gap between your local coding environment and the native Titan Planet binary. 
-
-It provides the necessary **Type Definitions** to make your IDE understand the global `t` object and a **Lite Test Harness** to verify your extensions before they ever touch a production binary.
-
-> **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
-
-- **💎 Blueprint Types (IntelliSense)**: Provides the full TypeScript `index.d.ts` for the global `t` object so you get autocomplete in VS Code and other editors.
-- **🛡️ Static Validation**: Catch parameter mismatches and typos in `t.log`, `t.fetch`, `t.db`, etc., during development.
-- **🔌 Extension Test Harness**: A "lite" version of the Titan runtime that simulates the native environment to test extensions in isolation.
-- **🚀 Zero Production Trace**: This is a `devDependencies` package. It never ships with your binary, keeping your production footprint at literal zero.
-
----
-
-## 🚀 The Test Harness (Lite Runtime)
-
-The SDK includes a specialized **Test Runner** (`titan-sdk`). This is a "lite" version of the Titan ecosystem that acts as a bridge for developers.
-
-### How it works:
-When you run the SDK in an extension folder, it:
-1.  **Scaffolds a Virtual Project**: Creates a temporary, minimal Titan environment in `.titan_test_run`.
-2.  **Native Compilation**: Automatically builds your native Rust code (`native/`) if it exists.
-3.  **Hot-Linking**: Junctions your local extension into the virtual project's `node_modules`.
-4.  **Verification**: Generates a test suite that attempts to call your extension's methods via the real `t` object inside the sandbox.
-
-### Usage:
-
-```bash
-# Inside your extension directory
-npx titan-sdk
-```
-
----
-
-## ⌨️ Enabling IntelliSense
-
-Since the `t` object is injected globally by the Titan engine at runtime, your IDE won't recognize it by default. The SDK fixes this.
-
-1.  **Install the SDK**:
-    ```bash
-    npm install --save-dev titan-sdk
-    ```
-
-2.  **Configure Types**:
-    Create or update `jsconfig.json` (or `tsconfig.json`) in your project root:
-    ```json
-    {
-      "compilerOptions": {
-        "types": ["titan-sdk"]
-      }
-    }
-    ```
-
-Now your editor will treat `t` as a first-class citizen:
-```ts
-export const myAction = defineAction((req) => {
-  t.log("Request received", req.path); // Autocomplete works!
-  return { status: "ok" };
-});
-```
-
----
-
-## 🧱 What's Included? (Types Only)
-
-The SDK provides types for the native APIs provided by the Titan Planet engine:
-
-- **`t.log`**: Standardized logging that appears in the Titan binary console.
-- **`t.fetch`**: Types for the high-performance Rust-native network stack.
-- **`t.db`**: Interface for the native PostgreSQL driver.
-- **`t.read`**: Definitions for optimized filesystem reads.
-- **`t.jwt` / `t.password`**: Security helper types.
-
----
-
-## 🌍 Community & Documentation
-
-- **Core Framework**: [Titan Planet](https://github.com/ezet-galaxy/titanpl)
-- **Official Docs**: [Titan Planet Docs](https://titan-docs-ez.vercel.app/docs)
-- **Author**: [ezetgalaxy](https://github.com/ezet-galaxy)
-
----
-
-<p align="center">
-  Built with ❤️ for the <a href="https://titan-docs-ez.vercel.app/">Titan Planet</a> ecosystem.
-</p>

package/titanpl-sdk/bin/run.js

@@ -1,274 +0,0 @@
-#!/usr/bin/env node
-import fs from "fs";
-import path from "path";
-import { execSync } from "child_process";
-import { fileURLToPath } from "url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// Helper for colors
-const cyan = (t) => `\x1b[36m${t}\x1b[0m`;
-const green = (t) => `\x1b[32m${t}\x1b[0m`;
-const red = (t) => `\x1b[31m${t}\x1b[0m`;
-const yellow = (t) => `\x1b[33m${t}\x1b[0m`;
-
-function copyDir(src, dest, excludes = []) {
-    // console.log(`DEBUG: copyDir ${src} -> ${dest}`);
-    if (!fs.existsSync(src)) {
-        console.log(red(`Source does not exist: ${src}`));
-        return;
-    }
-
-    fs.mkdirSync(dest, { recursive: true });
-
-    const files = fs.readdirSync(src);
-    // console.log(`DEBUG: Found ${files.length} files in ${src}`);
-
-    for (const file of files) {
-        if (excludes.includes(file)) {
-            // console.log(`DEBUG: Skipping excluded ${file}`);
-            continue;
-        }
-
-        const srcPath = path.join(src, file);
-        const destPath = path.join(dest, file);
-
-        if (fs.lstatSync(srcPath).isDirectory()) {
-            copyDir(srcPath, destPath, excludes);
-        } else {
-            // console.log(`DEBUG: Copying file ${file}`);
-            try {
-                fs.copyFileSync(srcPath, destPath);
-            } catch (err) {
-                console.log(red(`ERROR: Failed to copy ${file}: ${err.message}`));
-            }
-        }
-    }
-}
-
-function run() {
-    console.log(cyan("TitanPl SDK: Test Runner"));
-
-    // 1. Validate we are in an extension directory
-    const cwd = process.cwd();
-    console.log(cyan(`Current Working Directory: ${cwd}`));
-
-    const manifestPath = path.join(cwd, "titan.json");
-    if (!fs.existsSync(manifestPath)) {
-        console.log(red("Error: titan.json not found. Run this command inside your extension folder."));
-        process.exit(1);
-    }
-
-    const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
-    const name = manifest.name;
-    console.log(green(`Extension: ${name}`));
-
-    // 2. Build Native Logic (if properly set up)
-    const nativeDir = path.join(cwd, "native");
-    if (fs.existsSync(nativeDir) && fs.existsSync(path.join(nativeDir, "Cargo.toml"))) {
-        console.log(cyan("Building native Rust module..."));
-        try {
-            execSync("cargo build --release", { cwd: nativeDir, stdio: "inherit" });
-        } catch (e) {
-            console.log(red("Failed to build native module."));
-            process.exit(1);
-        }
-    }
-
-    // 3. Setup Test Harness (Mini Titan Project)
-    // 3. Setup Test Harness (Mini Titan Project)
-    const runDir = path.join(cwd, ".titan_test_run");
-    const appDir = path.join(runDir, "app");
-    const actionsDir = path.join(appDir, "actions");
-    const nmDir = path.join(runDir, "node_modules");
-
-    const isFirstRun = !fs.existsSync(runDir);
-
-    if (isFirstRun) {
-        console.log(cyan("Initializing test environment..."));
-        fs.mkdirSync(runDir, { recursive: true });
-
-        // Create app structure
-        fs.mkdirSync(appDir);
-
-        // Create actions folder (required by Titan build)
-        fs.mkdirSync(actionsDir);
-
-        // Copy titan/ and server/ from templates
-        const templatesDir = path.join(__dirname, "..", "templates");
-        console.log(cyan(`Templates Source: ${templatesDir}`));
-
-        const titanSrc = path.join(templatesDir, "titan");
-        const titanDest = path.join(runDir, "titan");
-
-        if (fs.existsSync(titanSrc)) {
-            copyDir(titanSrc, titanDest);
-            if (!fs.existsSync(path.join(titanDest, "titan.js"))) {
-                throw new Error("Failed to copy titan.js template");
-            }
-        } else {
-            console.log(red(`Error: Titan templates not found at ${titanSrc}`));
-            process.exit(1);
-        }
-
-        const serverSrc = path.join(templatesDir, "server");
-        const serverDest = path.join(runDir, "server");
-        if (fs.existsSync(serverSrc)) {
-            copyDir(serverSrc, serverDest);
-        } else {
-            console.log(red(`Error: Server templates not found at ${serverSrc}`));
-            process.exit(1);
-        }
-
-        // Create package.json for the test harness
-        const pkgJson = {
-            "type": "module",
-            "dependencies": {
-                // We can add dependencies here if needed
-            }
-        };
-        fs.writeFileSync(path.join(runDir, "package.json"), JSON.stringify(pkgJson, null, 2));
-
-        // Create 'node_modules'
-        // const nmDir = path.join(runDir, "node_modules"); // Already defined
-        fs.mkdirSync(nmDir);
-    } else {
-        console.log(cyan("Using existing test environment..."));
-    }
-
-    // const nmDir = path.join(runDir, "node_modules"); // Already defined
-    if (!fs.existsSync(nmDir)) fs.mkdirSync(nmDir, { recursive: true });
-
-    // COPY Extension to node_modules/NAME (Force Copy to avoid Symlink Loops)
-    const extDest = path.join(nmDir, name);
-    console.log(cyan(`Copying extension to ${extDest}...`));
-
-    // Always exclude the test run folder itself + standard ignores
-    const excludes = ['.titan_test_run', 'node_modules', '.git', 'target', 'dist'];
-    copyDir(cwd, extDest, excludes);
-
-    // Create default test files ONLY if they don't exist
-    // const actionsDir = path.join(runDir, "app", "actions"); // Already defined
-    const testActionPath = path.join(actionsDir, "test.js");
-
-    if (!fs.existsSync(testActionPath)) {
-        const testAction = `export const test = (req) => {
-    const ext = t["${name}"];
-    
-    const results = {
-        extension: "${name}",
-        loaded: !!ext,
-        methods: ext ? Object.keys(ext) : [],
-        timestamp: new Date().toISOString()
-    };
-    
-    if (ext && ext.hello) {
-        try {
-            results.hello_test = ext.hello("World");
-        } catch(e) {
-            results.hello_error = String(e);
-        }
-    }
-    
-    if (ext && ext.calc) {
-        try {
-            results.calc_test = ext.calc(15, 25);
-        } catch(e) {
-            results.calc_error = String(e);
-        }
-    }
-    
-    return results;
-};
-`;
-        fs.writeFileSync(testActionPath, testAction);
-    }
-
-    const appJsPath = path.join(runDir, "app", "app.js");
-    if (!fs.existsSync(appJsPath)) {
-        const testScript = `import t from "../titan/titan.js";
-
-// 1. Expose 't' globally because extensions expect it (like in the real runtime)
-globalThis.t = t;
-
-// 2. Dynamic import ensures 't' is set BEFORE the extension loads
-await import("${name}");
-
-// Extension test harness for: ${name}
-const ext = t["${name}"];
-
-t.log("---------------------------------------------------");
-t.log("Testing Extension: ${name}");
-t.log("---------------------------------------------------");
-
-if (!ext) {
-    console.log("ERROR: Extension '${name}' not found in global 't'.");
-} else {
-    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");
-           t.log("✓ Result:", res);
-        } catch(e) {
-           t.log("✗ Error:", e.message);
-        }
-    }
-
-    // Try 'calc' if it exists
-    if (typeof ext.calc === 'function') {
-        console.log("\\nTesting ext.calc(10, 20)...");
-        try {
-            const res = ext.calc(10, 20);
-            t.log("✓ Result:", res);
-        } catch(e) {
-            t.log("✗ Error:", e.message);
-        }
-    }
-}
-
-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!", 10, 16);
-`;
-        fs.writeFileSync(appJsPath, testScript);
-    }
-
-    // Build the app (bundle actions)
-    console.log(cyan("Building test app..."));
-    try {
-        execSync("node app/app.js --build", {
-            cwd: runDir,
-            stdio: "inherit",
-            env: { ...process.env, NODE_OPTIONS: "--no-warnings" }
-        });
-    } catch (e) {
-        console.log(red("Failed to build test app. checking for runtime errors..."));
-    }
-
-    // 4. Run Titan Server using cargo run
-    console.log(green("\\x1b[1m\\n>>> STARTING EXTENSION TEST >>>\\n\\x1b[0m"));
-
-    const serverDir = path.join(runDir, "server");
-
-    try {
-        execSync("cargo run", { cwd: serverDir, stdio: "inherit" });
-    } catch (e) {
-        // console.log(red("Runtime exited."));
-    }
-}
-
-run();

package/titanpl-sdk/index.js

@@ -1,5 +0,0 @@
-// Titan SDK
-// This package is primarily for type definitions and development tools.
-// The 't' object is injected globally by the Titan runtime.
-
-export const VERSION = "0.0.1";

package/titanpl-sdk/package-lock.json

@@ -1,28 +0,0 @@
-{
-    "name": "titanpl-sdk",
-    "version": "0.1.7",
-    "lockfileVersion": 3,
-    "requires": true,
-    "packages": {
-        "": {
-            "name": "titanpl-sdk",
-            "version": "0.1.7",
-            "license": "ISC",
-            "dependencies": {
-                "@titanpl/core": "^1.0.1"
-            },
-            "bin": {
-                "titanpl-sdk": "bin/run.js"
-            }
-        },
-        "node_modules/@titanpl/core": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/@titanpl/core/-/core-1.0.1.tgz",
-            "integrity": "sha512-5zcDMNnf+oghKkQMiPBFuhLlRy2IASyWMAAMgfqa4AzoXxiw2BzzfN0B2EA76Dy9AhCeK2mY84Zm+FSE7ANVFg==",
-            "license": "ISC",
-            "engines": {
-                "node": ">=18.0.0"
-            }
-        }
-    }
-}

package/titanpl-sdk/package.json

@@ -1,40 +0,0 @@
-{
-  "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/titanpl-sdk/templates/app/actions/hello.js

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

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

@@ -1,7 +0,0 @@
-import t from "@titanpl/route";
-
-t.post("/hello").action("hello") // pass a json payload { "name": "titan" }
-
-t.get("/").reply("Ready to land on Titan Planet 🚀");
-
-t.start(5100, "Titan Running!");

package/titanpl-sdk/templates/jsconfig.json

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

package/titanpl-sdk/templates/server/Cargo.toml

@@ -1,52 +0,0 @@
-[package]
-name = "titan-server"
-version = "0.1.0"
-edition = "2024"
-
-[dependencies]
-axum = "0.8.7"
-dotenv = "0.15.0"
-reqwest = { version = "0.12.24", features = ["json", "rustls-tls", "gzip", "brotli", "blocking"] }
-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", "fs"] }
-tower-http = { version = "0.6.7", features = ["cors"] }
-tracing = "0.1.43"
-tracing-subscriber = "0.3.22"
-anyhow = "1"
-v8 = "0.106.0"
-dotenvy = "0.15"
-base64 = "0.21"
-regex = "1.10"
-bcrypt = "0.15"
-jsonwebtoken = "9"
-postgres = { version = "0.19", features = ["with-serde_json-1"] }
-libloading = "0.8"
-walkdir = "2"
-crossbeam = "0.8.4"
-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