@titanpl/cli 2.0.0 → 2.0.2

package/README.md

@@ -1,17 +1,17 @@
-# @titanpl/cli
-
-The command-line interface (CLI) for Titan Planet. It provides the `titan` and `tit` commands for initializing, building, and running Titan Planet servers.
-
-## What it works (What it does)
-The CLI is responsible for bridging your JavaScript codebase with the underlying Rust/Axum engine. It handles scaffolding, compiling JS actions, generating metadata, and running the server.
-
-## How it works
-You can install this package globally or use it via your package runner (e.g., `npx`). Alternatively, you can install it as a dev dependency in your project.
-
-```bash
-npx titan help
-```
-
-It parses your application source code, coordinates with `@titanpl/packet` to build the required JS endpoints, and then spins up the pre-compiled native core engine for your OS.
-
-**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.
+# @titanpl/cli
+
+The command-line interface (CLI) for Titan Planet. It provides the `titan` and `tit` commands for initializing, building, and running Titan Planet servers.
+
+## What it works (What it does)
+The CLI is responsible for bridging your JavaScript codebase with the underlying Rust/Axum engine. It handles scaffolding, compiling JS actions, generating metadata, and running the server.
+
+## How it works
+You can install this package globally or use it via your package runner (e.g., `npx`). Alternatively, you can install it as a dev dependency in your project.
+
+```bash
+npx titan help
+```
+
+It parses your application source code, coordinates with `@titanpl/packet` to build the required JS endpoints, and then spins up the pre-compiled native core engine for your OS.
+
+**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.

package/index.js

@@ -1,161 +1,161 @@
-#!/usr/bin/env node
-
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-import { buildCommand } from "./src/commands/build.js";
-import { devCommand } from "./src/commands/dev.js";
-import { startCommand } from "./src/commands/start.js";
-import { migrateCommand } from "./src/commands/migrate.js";
-import { updateCommand } from "./src/commands/update.js";
-import { initCommand } from "./src/commands/init.js";
-
-/* -------------------------------------------------------
- * Resolve __dirname (ESM safe)
- * ----------------------------------------------------- */
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/* -------------------------------------------------------
- * Colors (Old Titan Theme Style)
- * ----------------------------------------------------- */
-const cyan = (t) => `\x1b[36m${t}\x1b[0m`;
-const green = (t) => `\x1b[32m${t}\x1b[0m`;
-const yellow = (t) => `\x1b[33m${t}\x1b[0m`;
-const red = (t) => `\x1b[31m${t}\x1b[0m`;
-const bold = (t) => `\x1b[1m${t}\x1b[0m`;
-const gray = (t) => `\x1b[90m${t}\x1b[0m`;
-
-/* -------------------------------------------------------
- * Version
- * ----------------------------------------------------- */
-let VERSION = "1.0.0";
-
-try {
-  const pkg = JSON.parse(
-    fs.readFileSync(path.join(__dirname, "package.json"), "utf8")
-  );
-  VERSION = pkg.version;
-} catch { }
-
-/* -------------------------------------------------------
- * Help Output
- * ----------------------------------------------------- */
-function help() {
-  console.log(`
-${bold(cyan("╭───────────────────────────────────────────────╮"))}
-${bold(cyan("│"))}  🪐 ${bold(cyan("Titan Planet"))} CLI                     ${gray(`v${VERSION}`.padEnd(6, ' '))} ${bold(cyan("│"))}
-${bold(cyan("╰───────────────────────────────────────────────╯"))}
-
-  ${yellow("Usage:")} ${bold("titan <command> [options]")}
-
-  ${bold("Commands:")}
-    ${cyan("init")}      ${gray("Scaffold a new Titan project")}
-    ${cyan("create")}    ${gray("Create a new project or extension (e.g. 'titan create ext my-ext')")}
-    ${cyan("build")}     ${gray("Compile actions and build production dist")}
-    ${cyan("dev")}       ${gray("Start the Gravity Engine in dev/watch mode")}
-    ${cyan("start")}     ${gray("Start the production Gravity Engine")}
-    ${cyan("update")}    ${gray("Update an existing project to latest Titan version")}
-    ${cyan("migrate")}   ${gray("Migrate a legacy project to the new architecture")}
-
-  ${bold("Options:")}
-    ${cyan("-v, --version")}  ${gray("Output the current version")}
-    ${cyan("-h, --help")}     ${gray("Display this help message")}
-
-${gray("  The Titan Planet Engine runs your JS/TS server natively without Node.js. ")}
-  ${cyan("https://titan-docs-ez.vercel.app")}
-`);
-}
-
-/* -------------------------------------------------------
- * CLI Router
- * ----------------------------------------------------- */
-process.title = "TitanPL";
-const cmd = process.argv[2];
-
-(async () => {
-  try {
-    // -------------------------------------------------------
-    // Legacy Check
-    // -------------------------------------------------------
-    if (cmd !== 'migrate' && cmd !== 'init') {
-      const legacyCargo = path.join(process.cwd(), "server", "Cargo.toml");
-      if (fs.existsSync(legacyCargo)) {
-        console.log(yellow(`\n⚠️ This project uses legacy server architecture. Migration recommended.`));
-        console.log(`Please run: ${bold(cyan('titan migrate'))}\n`);
-        process.exit(1);
-      }
-    }
-
-    // -------------------------------------------------------
-    // Old tit / titan detection note
-    // -------------------------------------------------------
-    const scriptBase = path.basename(process.argv[1]);
-    if (scriptBase === 'tit') {
-      console.log(yellow(`\n⚠️ [Notice]: \`tit\` is deprecated. Please use \`titan\` instead.\n`));
-    }
-
-
-    switch (cmd) {
-      case "init": {
-        const projectName = process.argv[3];
-        let template = null;
-        const tIndex = process.argv.indexOf("-t") !== -1 ? process.argv.indexOf("-t") : process.argv.indexOf("--template");
-        if (tIndex !== -1 && process.argv[tIndex + 1]) {
-          template = process.argv[tIndex + 1];
-        }
-        await initCommand(projectName, template);
-        break;
-      }
-
-      case "create": {
-        const type = process.argv[3];
-        const name = process.argv[4];
-        if (type === "ext" || type === "extension") {
-          await initCommand(name, "extension");
-        } else {
-          // Fallback to init behavior
-          await initCommand(type, null);
-        }
-        break;
-      }
-
-      case "build":
-        console.log(cyan("→ Building Titan project..."));
-        await buildCommand();
-        console.log(green("✔ Build complete"));
-        break;
-
-      case "dev":
-        await devCommand();
-        break;
-
-      case "start":
-        console.log(cyan("→ Starting Titan Server..."));
-        startCommand();
-        break;
-
-      case "update":
-        await updateCommand();
-        break;
-
-      case "migrate":
-        await migrateCommand();
-        break;
-
-      case "--version":
-      case "-v":
-      case "version":
-        console.log(cyan(`Titan CLI v${VERSION}`));
-        break;
-
-      default:
-        help();
-    }
-  } catch (err) {
-    console.error(red("✖ Titan CLI Error"));
-    console.error(gray(err?.message || err));
-    process.exit(1);
-  }
+#!/usr/bin/env node
+
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+import { buildCommand } from "./src/commands/build.js";
+import { devCommand } from "./src/commands/dev.js";
+import { startCommand } from "./src/commands/start.js";
+import { migrateCommand } from "./src/commands/migrate.js";
+import { updateCommand } from "./src/commands/update.js";
+import { initCommand } from "./src/commands/init.js";
+
+/* -------------------------------------------------------
+ * Resolve __dirname (ESM safe)
+ * ----------------------------------------------------- */
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/* -------------------------------------------------------
+ * Colors (Old Titan Theme Style)
+ * ----------------------------------------------------- */
+const cyan = (t) => `\x1b[36m${t}\x1b[0m`;
+const green = (t) => `\x1b[32m${t}\x1b[0m`;
+const yellow = (t) => `\x1b[33m${t}\x1b[0m`;
+const red = (t) => `\x1b[31m${t}\x1b[0m`;
+const bold = (t) => `\x1b[1m${t}\x1b[0m`;
+const gray = (t) => `\x1b[90m${t}\x1b[0m`;
+
+/* -------------------------------------------------------
+ * Version
+ * ----------------------------------------------------- */
+let VERSION = "1.0.0";
+
+try {
+  const pkg = JSON.parse(
+    fs.readFileSync(path.join(__dirname, "package.json"), "utf8")
+  );
+  VERSION = pkg.version;
+} catch { }
+
+/* -------------------------------------------------------
+ * Help Output
+ * ----------------------------------------------------- */
+function help() {
+  console.log(`
+${bold(cyan("╭───────────────────────────────────────────────╮"))}
+${bold(cyan("│"))}  🪐 ${bold(cyan("Titan Planet"))} CLI                     ${gray(`v${VERSION}`.padEnd(6, ' '))} ${bold(cyan("│"))}
+${bold(cyan("╰───────────────────────────────────────────────╯"))}
+
+  ${yellow("Usage:")} ${bold("titan <command> [options]")}
+
+  ${bold("Commands:")}
+    ${cyan("init")}      ${gray("Scaffold a new Titan project")}
+    ${cyan("create")}    ${gray("Create a new project or extension (e.g. 'titan create ext my-ext')")}
+    ${cyan("build")}     ${gray("Compile actions and build production dist")}
+    ${cyan("dev")}       ${gray("Start the Gravity Engine in dev/watch mode")}
+    ${cyan("start")}     ${gray("Start the production Gravity Engine")}
+    ${cyan("update")}    ${gray("Update an existing project to latest Titan version")}
+    ${cyan("migrate")}   ${gray("Migrate a legacy project to the new architecture")}
+
+  ${bold("Options:")}
+    ${cyan("-v, --version")}  ${gray("Output the current version")}
+    ${cyan("-h, --help")}     ${gray("Display this help message")}
+
+${gray("  The Titan Planet Engine runs your JS/TS server natively without Node.js. ")}
+  ${cyan("https://titan-docs-ez.vercel.app")}
+`);
+}
+
+/* -------------------------------------------------------
+ * CLI Router
+ * ----------------------------------------------------- */
+process.title = "TitanPL";
+const cmd = process.argv[2];
+
+(async () => {
+  try {
+    // -------------------------------------------------------
+    // Legacy Check
+    // -------------------------------------------------------
+    if (cmd !== 'migrate' && cmd !== 'init') {
+      const legacyCargo = path.join(process.cwd(), "server", "Cargo.toml");
+      if (fs.existsSync(legacyCargo)) {
+        console.log(yellow(`\n⚠️ This project uses legacy server architecture. Migration recommended.`));
+        console.log(`Please run: ${bold(cyan('titan migrate'))}\n`);
+        process.exit(1);
+      }
+    }
+
+    // -------------------------------------------------------
+    // Old tit / titan detection note
+    // -------------------------------------------------------
+    const scriptBase = path.basename(process.argv[1]);
+    if (scriptBase === 'tit') {
+      console.log(yellow(`\n⚠️ [Notice]: \`tit\` is deprecated. Please use \`titan\` instead.\n`));
+    }
+
+
+    switch (cmd) {
+      case "init": {
+        const projectName = process.argv[3];
+        let template = null;
+        const tIndex = process.argv.indexOf("-t") !== -1 ? process.argv.indexOf("-t") : process.argv.indexOf("--template");
+        if (tIndex !== -1 && process.argv[tIndex + 1]) {
+          template = process.argv[tIndex + 1];
+        }
+        await initCommand(projectName, template);
+        break;
+      }
+
+      case "create": {
+        const type = process.argv[3];
+        const name = process.argv[4];
+        if (type === "ext" || type === "extension") {
+          await initCommand(name, "extension");
+        } else {
+          // Fallback to init behavior
+          await initCommand(type, null);
+        }
+        break;
+      }
+
+      case "build":
+        console.log(cyan("→ Building Titan project..."));
+        await buildCommand();
+        console.log(green("✔ Build complete"));
+        break;
+
+      case "dev":
+        await devCommand();
+        break;
+
+      case "start":
+        console.log(cyan("→ Starting Titan Server..."));
+        startCommand();
+        break;
+
+      case "update":
+        await updateCommand();
+        break;
+
+      case "migrate":
+        await migrateCommand();
+        break;
+
+      case "--version":
+      case "-v":
+      case "version":
+        console.log(cyan(`Titan CLI v${VERSION}`));
+        break;
+
+      default:
+        help();
+    }
+  } catch (err) {
+    console.error(red("✖ Titan CLI Error"));
+    console.error(gray(err?.message || err));
+    process.exit(1);
+  }
 })();

package/package.json

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

package/src/commands/build.js

@@ -1,6 +1,6 @@
-import { build } from "@titanpl/packet";
-
-export async function buildCommand() {
-  const dist = await build(process.cwd());
-  console.log("✔ Build complete →", dist);
+import { build } from "@titanpl/packet";
+
+export async function buildCommand() {
+  const dist = await build(process.cwd());
+  console.log("✔ Build complete →", dist);
 }

package/src/commands/dev.js

@@ -1,5 +1,12 @@
-import { dev } from "@titanpl/packet";
-
-export async function devCommand() {
-  await dev(process.cwd());
-}
+import { dev } from "@titanpl/packet";
+import { resolveEngineBinaryPath } from "../engine.js";
+
+export async function devCommand() {
+  // Resolve the engine binary from CLI's context (where optionalDependencies live)
+  // and inject it into the environment so packet can find it without re-resolving.
+  const enginePath = resolveEngineBinaryPath();
+  if (enginePath) {
+    process.env.TITAN_ENGINE_BINARY = enginePath;
+  }
+  await dev(process.cwd());
+}