titan-sdk 0.0.4 → 0.0.5

package/bin/run.js

@@ -13,6 +13,19 @@ 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) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const file of fs.readdirSync(src)) {
+        const srcPath = path.join(src, file);
+        const destPath = path.join(dest, file);
+        if (fs.lstatSync(srcPath).isDirectory()) {
+            copyDir(srcPath, destPath);
+        } else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+
 function run() {
     console.log(cyan("Titan SDK: Test Runner"));
 
@@ -56,19 +69,24 @@ function run() {
     fs.mkdirSync(actionsDir);
 
     // Copy titan/ and server/ from templates
-    const repoRoot = path.resolve(__dirname, "..", "..");
-    const templatesDir = path.join(repoRoot, "templates");
+    const templatesDir = path.join(__dirname, "..", "templates");
 
     const titanSrc = path.join(templatesDir, "titan");
     const titanDest = path.join(runDir, "titan");
     if (fs.existsSync(titanSrc)) {
-        fs.cpSync(titanSrc, titanDest, { recursive: true });
+        copyDir(titanSrc, titanDest);
+    } 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)) {
-        fs.cpSync(serverSrc, serverDest, { recursive: true });
+        copyDir(serverSrc, serverDest);
+    } else {
+        console.log(red(`Error: Server templates not found at ${serverSrc}`));
+        process.exit(1);
     }
 
     // Create package.json for the test harness
@@ -89,7 +107,7 @@ function run() {
     } catch (e) {
         // Fallback to copy if link fails
         console.log(yellow("Linking failed, copying extension files..."));
-        fs.cpSync(cwd, extDest, { recursive: true });
+        copyDir(cwd, extDest);
     }
 
     // Create a test action in app/actions/test.js
@@ -138,7 +156,6 @@ console.log("---------------------------------------------------");
 
 if (!ext) {
     console.log("ERROR: Extension '${name}' not found in global 't'.");
-    console.log("Make sure your extension's package.json has 'type': 'commonjs'");
 } else {
     console.log("✓ Extension loaded successfully!");
     console.log("✓ Available methods:", Object.keys(ext).join(", "));
@@ -177,7 +194,7 @@ console.log("---------------------------------------------------\\n");
 t.get("/test").action("test");
 t.get("/").reply("🚀 Extension Test Harness for ${name}\\n\\nVisit /test to see extension test results");
 
-t.start(3000, "Titan Extension Test Running!");
+await t.start(3000, "Titan Extension Test Running!");
 `;
 
     fs.writeFileSync(path.join(appDir, "app.js"), testScript);
@@ -188,11 +205,10 @@ t.start(3000, "Titan Extension Test Running!");
         execSync("node app/app.js --build", { cwd: runDir, stdio: "inherit" });
     } catch (e) {
         console.log(red("Failed to build test app."));
-        console.log(yellow("This is expected if your extension has errors."));
     }
 
     // 4. Run Titan Server using cargo run (like dev mode)
-    console.log(cyan("Starting Titan Runtime..."));
+    console.log(green("\x1b[1m\n>>> STARTING EXTENSION TEST >>>\n\x1b[0m"));
 
     const serverDir = path.join(runDir, "server");
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "titan-sdk",
-    "version": "0.0.4",
+    "version": "0.0.5",
     "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",
@@ -8,6 +8,14 @@
     "bin": {
         "titan-sdk": "./bin/run.js"
     },
+    "files": [
+        "bin/",
+        "templates/",
+        "titan",
+        "index.js",
+        "index.d.ts",
+        "README.md"
+    ],
     "keywords": [
         "titan",
         "titan-planet",

package/templates/.dockerignore

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

package/templates/Dockerfile

@@ -0,0 +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"]

package/templates/app/actions/hello.js

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

package/templates/app/app.js

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

package/templates/app/titan.d.ts

@@ -0,0 +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;
+    };
+};
+

package/templates/jsconfig.json

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