titanpl 2.0.3 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "titanpl",
-  "version": "2.0.3",
+  "version": "3.0.0",
   "description": "Titan Planet is a JavaScript-first backend framework that embeds JS actions into a Rust + Axum server and ships as a single native binary. Routes are compiled to static metadata; only actions run in the embedded JS runtime. No Node.js. No event loop in production.",
   "license": "ISC",
   "author": "ezetgalaxy",

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titanpl/cli",
-  "version": "2.0.3",
+  "version": "3.0.0",
   "description": "The unified CLI for Titan Planet. Use it to create, manage, build, and deploy high-performance backend projects.",
   "keywords": [
     "titanpl",
@@ -17,16 +17,16 @@
   },
   "bin": {
     "titan": "./index.js",
-    "titanpl": "./index.js",
+    "t8n": "./index.js",
     "tit": "./index.js"
   },
   "optionalDependencies": {
-    "@titanpl/engine-win32-x64": "2.0.3",
-    "@titanpl/engine-linux-x64": "2.0.3",
-    "@titanpl/engine-darwin-arm64": "2.0.3"
+    "@titanpl/engine-win32-x64": "2.0.4",
+    "@titanpl/engine-linux-x64": "2.0.4",
+    "@titanpl/engine-darwin-arm64": "2.0.4"
   },
   "dependencies": {
-    "@titanpl/packet": "2.0.3",
+    "@titanpl/packet": "2.0.4",
     "prompts": "^2.4.2",
     "commander": "^11.0.0",
     "chalk": "^4.1.2"

package/packages/cli/src/commands/init.js

@@ -99,8 +99,27 @@ export async function initCommand(projectName, templateName) {
     let templateDir = path.resolve(__dirname, '..', '..', '..', '..', 'templates', selectedTemplate);
     let commonDir = path.resolve(__dirname, '..', '..', '..', '..', 'templates', 'common');
 
+    const tryPaths = [
+        // 1. Monorepo root / titanpl package root
+        { t: path.resolve(__dirname, '..', '..', '..', '..', 'templates', selectedTemplate), c: path.resolve(__dirname, '..', '..', '..', '..', 'templates', 'common') },
+        // 2. Published CLI package (global install / npm package)
+        { t: path.resolve(__dirname, '..', '..', 'templates', selectedTemplate), c: path.resolve(__dirname, '..', '..', 'templates', 'common') },
+        // 3. Fallback: one dir up? Just in case
+        { t: path.resolve(__dirname, '..', '..', '..', 'templates', selectedTemplate), c: path.resolve(__dirname, '..', '..', '..', 'templates', 'common') }
+    ];
+
+    let found = false;
+    for (const paths of tryPaths) {
+        if (fs.existsSync(paths.t) && fs.existsSync(paths.c)) {
+            templateDir = paths.t;
+            commonDir = paths.c;
+            found = true;
+            break;
+        }
+    }
+
     // Robust monorepo/fallback template search: look upwards from cwd
-    if (!fs.existsSync(templateDir) || !fs.existsSync(commonDir)) {
+    if (!found) {
         let searchDir = process.cwd();
         while (searchDir !== path.parse(searchDir).root) {
             const potentialTemplateDir = path.join(searchDir, 'templates', selectedTemplate);
@@ -108,6 +127,7 @@ export async function initCommand(projectName, templateName) {
             if (fs.existsSync(potentialTemplateDir) && fs.existsSync(potentialCommonDir)) {
                 templateDir = potentialTemplateDir;
                 commonDir = potentialCommonDir;
+                found = true;
                 break;
             }
             const sdkPotentialTemplateDir = path.join(searchDir, 'titanpl-sdk', 'templates', selectedTemplate);
@@ -115,13 +135,14 @@ export async function initCommand(projectName, templateName) {
             if (fs.existsSync(sdkPotentialTemplateDir) && fs.existsSync(sdkPotentialCommonDir)) {
                 templateDir = sdkPotentialTemplateDir;
                 commonDir = sdkPotentialCommonDir;
+                found = true;
                 break;
             }
             searchDir = path.dirname(searchDir);
         }
     }
 
-    if (!fs.existsSync(templateDir) || !fs.existsSync(commonDir)) {
+    if (!found) {
         console.log(chalk.red(`✖ Error finding template paths. Are you in a valid Titan monorepo?`));
         process.exit(1);
     }

package/packages/engine-darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titanpl/engine-darwin-arm64",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "os": [
     "darwin"
   ],

package/packages/engine-linux-x64/package.json

@@ -1,10 +1,16 @@
 {
   "name": "@titanpl/engine-linux-x64",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "os": [
     "linux"
   ],
   "cpu": [
     "x64"
-  ]
+  ],
+  "files": [
+    "bin"
+  ],
+  "bin": {
+    "titan-server": "./bin/titan-server"
+  }
 }

package/packages/engine-win32-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titanpl/engine-win32-x64",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "os": [
     "win32"
   ],

package/packages/native/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titanpl/native",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "Titan native utilities package",
   "type": "module",
   "keywords": [

package/packages/packet/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titanpl/packet",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "The bundler for TitanPl servers.",
   "keywords": [
     "bundler",

package/packages/route/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titanpl/route",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "Titan routing DSL",
   "type": "module",
   "main": "index.js",

package/templates/common/Dockerfile

@@ -1,45 +1,68 @@
 # ================================================================
-# STAGE 1 — Build TitanPl
+# STAGE 1 — Builder
 # ================================================================
-FROM node:20.20.0-slim AS builder
+FROM node:20-slim AS builder
 
 WORKDIR /app
 
-# Install native dependencies in case of native modules or hybrids
+# build-essential is required for native Titan extensions (C++ or Rust based)
 RUN apt-get update && apt-get install -y --no-install-recommends \
-    curl ca-certificates build-essential pkg-config libssl-dev git bash \
+    build-essential pkg-config git ca-certificates \
     && rm -rf /var/lib/apt/lists/*
 
 ENV NODE_ENV=production
 
-# ---------- Node Dependencies ----------
 COPY package.json package-lock.json* ./
-RUN npm install
 
-# ---------- Copy Project ----------
+# Install with optional dependencies so it grabs the correct engine for the Linux builder
+RUN npm install --include=optional
+
+# ------------------------------------------------
+# Extract Titan Extensions (packages with titan.json)
+# ------------------------------------------------
+RUN mkdir -p /app/.ext && \
+    find node_modules -mindepth 2 -maxdepth 3 -type f -name "titan.json" | while read file; do \
+    pkg_dir=$(dirname "$file"); \
+    pkg_name=$(basename "$pkg_dir"); \
+    echo "Extracting Titan extension: $pkg_name"; \
+    cp -a "$pkg_dir" "/app/.ext/$pkg_name"; \
+    rm -rf "/app/.ext/$pkg_name/node_modules"; \
+    done
+
+# ------------------------------------------------
+# Copy ANY installed Titan Engine (Architecture agnostic)
+# ------------------------------------------------
+RUN mkdir -p /app/.ext/@titanpl && \
+    cp -r node_modules/@titanpl/engine-linux-* /app/.ext/@titanpl/
+
 COPY . .
 
-# Run the Titan build command (compiles dist/)
+# Run the Titan build step
 RUN npx titan build
 
+
 # ================================================================
-# STAGE 2 — Gravity Engine (Production Ready)
+# STAGE 2 — Runtime (Optimized Pure Engine)
 # ================================================================
-FROM node:20.20.0-slim
+FROM ubuntu:24.04
+
+# Use an unprivileged user for security
+RUN groupadd -r titan && useradd -r -g titan titan
 
 WORKDIR /app
 
-# Ensure we have required OS-level certs if doing network fetching
-RUN apt-get update && \
-    apt-get install -y --no-install-recommends ca-certificates curl && \
-    rm -rf /var/lib/apt/lists/*
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# copy dist contents into /app/dist
+COPY --from=builder /app/dist/ ./dist/
 
-# ---- Copy Production package.json and install ONLY dependencies ----
-COPY package.json package-lock.json* ./
-RUN npm ci --omit=dev
+# titan extensions + engine
+COPY --from=builder /app/.ext ./.ext
 
-# ---- Copy Dist Build from Builder ----
-COPY --from=builder /app/dist ./dist
+# runtime assets
+COPY --from=builder /app/package.json ./package.json
 
 # ---------------- OPTIONAL APP FOLDERS ----------------
 # Static assets
@@ -51,16 +74,25 @@ COPY --from=builder /app/dist ./dist
 # DB
 # COPY --from=builder /app/app/db ./db
 
-# ---- Create User After Copy ----
-RUN useradd -m titan && chown -R titan:titan /app
-USER titan
+# CRITICAL SYSTEM SETUP:
+# 1. Mandatory .env file (Engine requires it for config parsing)
+# 2. Node modules symlink for extension JS dependency resolution
+RUN echo "TITAN_DEV=0" > .env && \
+    ln -s /app/.ext /app/node_modules && \
+    chown -R titan:titan /app
 
-# ---- Platform Defaults ----
+# Standard environment variables
 ENV HOST=0.0.0.0
 ENV PORT=5100
 ENV TITAN_DEV=0
 
+USER titan
 EXPOSE 5100
 
-# ---- Force Foreground Process via Titan CLI ----
-CMD ["npx", "titan", "start"]
+# Health check to ensure the server is alive
+HEALTHCHECK --interval=30s --timeout=5s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:5100/ || exit 1
+
+# DYNAMIC ENTRYPOINT: Finds the correct architecture binary and starts it
+# This allows the SAME image to work on x64 vs ARM64 servers.
+CMD ["/bin/sh", "-c", "exec $(find .ext/@titanpl/engine-linux-* -name titan-server -type f | head -n 1) run dist"]

package/templates/extension/package.json

@@ -1,6 +1,6 @@
 {
   "name": "{{name}}",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "A Titan Planet extension",
   "main": "index.js",
   "types": "index.d.ts",
@@ -18,7 +18,7 @@
     "@titanpl/core": "latest",
     "chokidar": "^5.0.0",
     "esbuild": "^0.27.2",
-    "titanpl-sdk": "2.0.3"
+    "titanpl-sdk": "2.0.4"
   },
   "devDependencies": {
     "@tgrv/microgravity": "latest"

package/templates/js/package.json

@@ -6,12 +6,12 @@
     "template": "js"
   },
   "dependencies": {
-    "@titanpl/cli": "2.0.3",
-    "@titanpl/route": "2.0.3",
-    "@titanpl/native": "2.0.3",
+    "@titanpl/cli": "2.0.4",
+    "@titanpl/route": "2.0.4",
+    "@titanpl/native": "2.0.4",
     "@titanpl/core": "latest",
     "@titanpl/node": "latest",
-    "@titanpl/packet": "2.0.3"
+    "@titanpl/packet": "2.0.4"
   },
   "scripts": {
     "build": "titan build",
@@ -24,5 +24,5 @@
     "eslint": "^9.39.2",
     "eslint-plugin-titanpl": "latest"
   },
-  "version": "2.0.3"
+  "version": "2.0.4"
 }

package/templates/rust-js/package.json

@@ -1,15 +1,15 @@
 {
   "name": "titanpl",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "A Titan Planet server",
   "type": "module",
   "titan": {
     "template": "rust-js"
   },
   "dependencies": {
-    "@titanpl/cli": "2.0.3",
-    "@titanpl/route": "2.0.3",
-    "@titanpl/native": "2.0.3",
+    "@titanpl/cli": "2.0.4",
+    "@titanpl/route": "2.0.4",
+    "@titanpl/native": "2.0.4",
     "@titanpl/core": "latest",
     "@titanpl/node": "latest"
   },

package/templates/rust-ts/package.json

@@ -1,15 +1,15 @@
 {
   "name": "titanpl",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "A Titan Planet server (Rust + TypeScript)",
   "type": "module",
   "titan": {
     "template": "rust-ts"
   },
   "dependencies": {
-    "@titanpl/cli": "2.0.3",
-    "@titanpl/route": "2.0.3",
-    "@titanpl/native": "2.0.3",
+    "@titanpl/cli": "2.0.4",
+    "@titanpl/route": "2.0.4",
+    "@titanpl/native": "2.0.4",
     "@titanpl/core": "latest",
     "@titanpl/node": "latest",
     "typescript": "^5.0.0"

package/templates/ts/package.json

@@ -6,12 +6,12 @@
     "template": "ts"
   },
   "dependencies": {
-    "@titanpl/cli": "2.0.3",
-    "@titanpl/route": "2.0.3",
-    "@titanpl/native": "2.0.3",
+    "@titanpl/cli": "2.0.4",
+    "@titanpl/route": "2.0.4",
+    "@titanpl/native": "2.0.4",
     "@titanpl/core": "latest",
     "@titanpl/node": "latest",
-    "@titanpl/packet": "2.0.3",
+    "@titanpl/packet": "2.0.4",
     "typescript": "^5.0.0"
   },
   "scripts": {
@@ -26,5 +26,5 @@
     "eslint-plugin-titanpl": "latest",
     "@typescript-eslint/parser": "^8.54.0"
   },
-  "version": "2.0.3"
+  "version": "2.0.4"
 }

package/titanpl-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "titanpl-sdk",
-  "version": "2.0.3",
+  "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",