@nexical/cli 0.11.2 → 0.11.4

package/dist/index.js

@@ -15,7 +15,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@nexical/cli",
-  version: "0.11.2",
+  version: "0.11.4",
   type: "module",
   bin: {
     nexical: "./dist/index.js"

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.ts","../package.json"],"sourcesContent":["#!/usr/bin/env node\nimport { CLI, findProjectRoot } from '@nexical/cli-core';\nimport { fileURLToPath } from 'node:url';\nimport { discoverCommandDirectories } from './src/utils/discovery.js';\nimport pkg from './package.json';\nimport path from 'node:path';\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nconst commandName = 'nexical';\nconst projectRoot = (await findProjectRoot(commandName, process.cwd())) || process.cwd();\nconst coreCommandsDir = path.resolve(__dirname, './src/commands');\nconst additionalCommands = discoverCommandDirectories(projectRoot);\n\n// Filter out duplicate core commands and source versions\nconst filteredAdditional = additionalCommands.filter((dir) => {\n  const resolvedDir = path.resolve(dir);\n  const resolvedCore = path.resolve(coreCommandsDir);\n\n  if (resolvedDir === resolvedCore) return false;\n\n  // Check if this is another instance of the core CLI commands (by checking path suffix)\n  const coreSuffix = path.join('@nexical', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixSrc = path.join('packages', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixRawSrc = path.join('packages', 'cli', 'src', 'commands');\n\n  if (\n    resolvedDir.endsWith(coreSuffix) ||\n    resolvedDir.endsWith(coreSuffixSrc) ||\n    resolvedDir.endsWith(coreSuffixRawSrc)\n  ) {\n    return false;\n  }\n\n  // Handle mismatch between dist/src and src/\n  if (resolvedCore.includes(path.join(path.sep, 'dist', 'src', 'commands'))) {\n    const srcVersion = resolvedCore.replace(\n      path.join(path.sep, 'dist', 'src', 'commands'),\n      path.join(path.sep, 'src', 'commands'),\n    );\n    if (resolvedDir === srcVersion) return false;\n  }\n\n  return true;\n});\n\nconst app = new CLI({\n  version: pkg.version,\n  commandName: commandName,\n  searchDirectories: [...new Set([coreCommandsDir, ...filteredAdditional])],\n});\napp.start();\n","{\n  \"name\": \"@nexical/cli\",\n  \"version\": \"0.11.2\",\n  \"type\": \"module\",\n  \"bin\": {\n    \"nexical\": \"./dist/index.js\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"start\": \"node dist/index.js\",\n    \"test\": \"npm run test:unit && npm run test:integration && npm run test:e2e\",\n    \"test:unit\": \"vitest run --config vitest.config.ts --coverage\",\n    \"test:integration\": \"vitest run --config vitest.integration.config.ts\",\n    \"test:e2e\": \"npm run build && vitest run --config vitest.e2e.config.ts\",\n    \"test:watch\": \"vitest\",\n    \"format\": \"prettier --write .\",\n    \"lint\": \"eslint .\",\n    \"lint:fix\": \"eslint . --fix\",\n    \"prepare\": \"husky\"\n  },\n  \"lint-staged\": {\n    \"**/*\": [\n      \"prettier --write --ignore-unknown\"\n    ],\n    \"**/*.{js,jsx,ts,tsx,astro}\": [\n      \"eslint --fix\"\n    ]\n  },\n  \"dependencies\": {\n    \"@nexical/cli-core\": \"^0.1.12\",\n    \"yaml\": \"^2.3.4\",\n    \"fast-glob\": \"^3.3.3\"\n  },\n  \"devDependencies\": {\n    \"@types/fs-extra\": \"^11.0.4\",\n    \"@types/node\": \"^20.10.0\",\n    \"@vitest/coverage-v8\": \"^4.0.15\",\n    \"execa\": \"^9.6.1\",\n    \"fs-extra\": \"^11.3.2\",\n    \"tsup\": \"^8.0.1\",\n    \"tsx\": \"^4.21.0\",\n    \"typescript\": \"^5.3.3\",\n    \"vitest\": \"^4.0.15\",\n    \"@eslint/js\": \"^9.39.2\",\n    \"eslint\": \"^9.39.2\",\n    \"eslint-config-prettier\": \"^10.1.8\",\n    \"eslint-plugin-astro\": \"^1.5.0\",\n    \"eslint-plugin-jsx-a11y\": \"^6.10.2\",\n    \"eslint-plugin-react\": \"^7.37.5\",\n    \"eslint-plugin-react-hooks\": \"^7.0.1\",\n    \"globals\": \"^17.2.0\",\n    \"husky\": \"^9.1.7\",\n    \"lint-staged\": \"^16.2.7\",\n    \"prettier\": \"^3.8.1\",\n    \"typescript-eslint\": \"^8.54.0\"\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,SAAS,KAAK,uBAAuB;AACrC,SAAS,qBAAqB;;;ACF9B;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,MAAQ;AAAA,EACR,KAAO;AAAA,IACL,SAAW;AAAA,EACb;AAAA,EACA,SAAW;AAAA,IACT,OAAS;AAAA,IACT,KAAO;AAAA,IACP,OAAS;AAAA,IACT,MAAQ;AAAA,IACR,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,QAAU;AAAA,IACV,MAAQ;AAAA,IACR,YAAY;AAAA,IACZ,SAAW;AAAA,EACb;AAAA,EACA,eAAe;AAAA,IACb,QAAQ;AAAA,MACN;AAAA,IACF;AAAA,IACA,8BAA8B;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AAAA,EACA,cAAgB;AAAA,IACd,qBAAqB;AAAA,IACrB,MAAQ;AAAA,IACR,aAAa;AAAA,EACf;AAAA,EACA,iBAAmB;AAAA,IACjB,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,uBAAuB;AAAA,IACvB,OAAS;AAAA,IACT,YAAY;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,IACP,YAAc;AAAA,IACd,QAAU;AAAA,IACV,cAAc;AAAA,IACd,QAAU;AAAA,IACV,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,6BAA6B;AAAA,IAC7B,SAAW;AAAA,IACX,OAAS;AAAA,IACT,eAAe;AAAA,IACf,UAAY;AAAA,IACZ,qBAAqB;AAAA,EACvB;AACF;;;ADpDA,OAAO,UAAU;AAEjB,IAAM,YAAY,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAE7D,IAAM,cAAc;AACpB,IAAM,cAAe,MAAM,gBAAgB,aAAa,QAAQ,IAAI,CAAC,KAAM,QAAQ,IAAI;AACvF,IAAM,kBAAkB,KAAK,QAAQ,WAAW,gBAAgB;AAChE,IAAM,qBAAqB,2BAA2B,WAAW;AAGjE,IAAM,qBAAqB,mBAAmB,OAAO,CAAC,QAAQ;AAC5D,QAAM,cAAc,KAAK,QAAQ,GAAG;AACpC,QAAM,eAAe,KAAK,QAAQ,eAAe;AAEjD,MAAI,gBAAgB,aAAc,QAAO;AAGzC,QAAM,aAAa,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AACzE,QAAM,gBAAgB,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AAC5E,QAAM,mBAAmB,KAAK,KAAK,YAAY,OAAO,OAAO,UAAU;AAEvE,MACE,YAAY,SAAS,UAAU,KAC/B,YAAY,SAAS,aAAa,KAClC,YAAY,SAAS,gBAAgB,GACrC;AACA,WAAO;AAAA,EACT;AAGA,MAAI,aAAa,SAAS,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU,CAAC,GAAG;AACzE,UAAM,aAAa,aAAa;AAAA,MAC9B,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU;AAAA,MAC7C,KAAK,KAAK,KAAK,KAAK,OAAO,UAAU;AAAA,IACvC;AACA,QAAI,gBAAgB,WAAY,QAAO;AAAA,EACzC;AAEA,SAAO;AACT,CAAC;AAED,IAAM,MAAM,IAAI,IAAI;AAAA,EAClB,SAAS,gBAAI;AAAA,EACb;AAAA,EACA,mBAAmB,CAAC,GAAG,oBAAI,IAAI,CAAC,iBAAiB,GAAG,kBAAkB,CAAC,CAAC;AAC1E,CAAC;AACD,IAAI,MAAM;","names":[]}
+{"version":3,"sources":["../index.ts","../package.json"],"sourcesContent":["#!/usr/bin/env node\nimport { CLI, findProjectRoot } from '@nexical/cli-core';\nimport { fileURLToPath } from 'node:url';\nimport { discoverCommandDirectories } from './src/utils/discovery.js';\nimport pkg from './package.json';\nimport path from 'node:path';\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nconst commandName = 'nexical';\nconst projectRoot = (await findProjectRoot(commandName, process.cwd())) || process.cwd();\nconst coreCommandsDir = path.resolve(__dirname, './src/commands');\nconst additionalCommands = discoverCommandDirectories(projectRoot);\n\n// Filter out duplicate core commands and source versions\nconst filteredAdditional = additionalCommands.filter((dir) => {\n  const resolvedDir = path.resolve(dir);\n  const resolvedCore = path.resolve(coreCommandsDir);\n\n  if (resolvedDir === resolvedCore) return false;\n\n  // Check if this is another instance of the core CLI commands (by checking path suffix)\n  const coreSuffix = path.join('@nexical', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixSrc = path.join('packages', 'cli', 'dist', 'src', 'commands');\n  const coreSuffixRawSrc = path.join('packages', 'cli', 'src', 'commands');\n\n  if (\n    resolvedDir.endsWith(coreSuffix) ||\n    resolvedDir.endsWith(coreSuffixSrc) ||\n    resolvedDir.endsWith(coreSuffixRawSrc)\n  ) {\n    return false;\n  }\n\n  // Handle mismatch between dist/src and src/\n  if (resolvedCore.includes(path.join(path.sep, 'dist', 'src', 'commands'))) {\n    const srcVersion = resolvedCore.replace(\n      path.join(path.sep, 'dist', 'src', 'commands'),\n      path.join(path.sep, 'src', 'commands'),\n    );\n    if (resolvedDir === srcVersion) return false;\n  }\n\n  return true;\n});\n\nconst app = new CLI({\n  version: pkg.version,\n  commandName: commandName,\n  searchDirectories: [...new Set([coreCommandsDir, ...filteredAdditional])],\n});\napp.start();\n","{\n  \"name\": \"@nexical/cli\",\n  \"version\": \"0.11.4\",\n  \"type\": \"module\",\n  \"bin\": {\n    \"nexical\": \"./dist/index.js\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"start\": \"node dist/index.js\",\n    \"test\": \"npm run test:unit && npm run test:integration && npm run test:e2e\",\n    \"test:unit\": \"vitest run --config vitest.config.ts --coverage\",\n    \"test:integration\": \"vitest run --config vitest.integration.config.ts\",\n    \"test:e2e\": \"npm run build && vitest run --config vitest.e2e.config.ts\",\n    \"test:watch\": \"vitest\",\n    \"format\": \"prettier --write .\",\n    \"lint\": \"eslint .\",\n    \"lint:fix\": \"eslint . --fix\",\n    \"prepare\": \"husky\"\n  },\n  \"lint-staged\": {\n    \"**/*\": [\n      \"prettier --write --ignore-unknown\"\n    ],\n    \"**/*.{js,jsx,ts,tsx,astro}\": [\n      \"eslint --fix\"\n    ]\n  },\n  \"dependencies\": {\n    \"@nexical/cli-core\": \"^0.1.12\",\n    \"yaml\": \"^2.3.4\",\n    \"fast-glob\": \"^3.3.3\"\n  },\n  \"devDependencies\": {\n    \"@types/fs-extra\": \"^11.0.4\",\n    \"@types/node\": \"^20.10.0\",\n    \"@vitest/coverage-v8\": \"^4.0.15\",\n    \"execa\": \"^9.6.1\",\n    \"fs-extra\": \"^11.3.2\",\n    \"tsup\": \"^8.0.1\",\n    \"tsx\": \"^4.21.0\",\n    \"typescript\": \"^5.3.3\",\n    \"vitest\": \"^4.0.15\",\n    \"@eslint/js\": \"^9.39.2\",\n    \"eslint\": \"^9.39.2\",\n    \"eslint-config-prettier\": \"^10.1.8\",\n    \"eslint-plugin-astro\": \"^1.5.0\",\n    \"eslint-plugin-jsx-a11y\": \"^6.10.2\",\n    \"eslint-plugin-react\": \"^7.37.5\",\n    \"eslint-plugin-react-hooks\": \"^7.0.1\",\n    \"globals\": \"^17.2.0\",\n    \"husky\": \"^9.1.7\",\n    \"lint-staged\": \"^16.2.7\",\n    \"prettier\": \"^3.8.1\",\n    \"typescript-eslint\": \"^8.54.0\"\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA;AACA,SAAS,KAAK,uBAAuB;AACrC,SAAS,qBAAqB;;;ACF9B;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,MAAQ;AAAA,EACR,KAAO;AAAA,IACL,SAAW;AAAA,EACb;AAAA,EACA,SAAW;AAAA,IACT,OAAS;AAAA,IACT,KAAO;AAAA,IACP,OAAS;AAAA,IACT,MAAQ;AAAA,IACR,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,QAAU;AAAA,IACV,MAAQ;AAAA,IACR,YAAY;AAAA,IACZ,SAAW;AAAA,EACb;AAAA,EACA,eAAe;AAAA,IACb,QAAQ;AAAA,MACN;AAAA,IACF;AAAA,IACA,8BAA8B;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AAAA,EACA,cAAgB;AAAA,IACd,qBAAqB;AAAA,IACrB,MAAQ;AAAA,IACR,aAAa;AAAA,EACf;AAAA,EACA,iBAAmB;AAAA,IACjB,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,uBAAuB;AAAA,IACvB,OAAS;AAAA,IACT,YAAY;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,IACP,YAAc;AAAA,IACd,QAAU;AAAA,IACV,cAAc;AAAA,IACd,QAAU;AAAA,IACV,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,6BAA6B;AAAA,IAC7B,SAAW;AAAA,IACX,OAAS;AAAA,IACT,eAAe;AAAA,IACf,UAAY;AAAA,IACZ,qBAAqB;AAAA,EACvB;AACF;;;ADpDA,OAAO,UAAU;AAEjB,IAAM,YAAY,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAE7D,IAAM,cAAc;AACpB,IAAM,cAAe,MAAM,gBAAgB,aAAa,QAAQ,IAAI,CAAC,KAAM,QAAQ,IAAI;AACvF,IAAM,kBAAkB,KAAK,QAAQ,WAAW,gBAAgB;AAChE,IAAM,qBAAqB,2BAA2B,WAAW;AAGjE,IAAM,qBAAqB,mBAAmB,OAAO,CAAC,QAAQ;AAC5D,QAAM,cAAc,KAAK,QAAQ,GAAG;AACpC,QAAM,eAAe,KAAK,QAAQ,eAAe;AAEjD,MAAI,gBAAgB,aAAc,QAAO;AAGzC,QAAM,aAAa,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AACzE,QAAM,gBAAgB,KAAK,KAAK,YAAY,OAAO,QAAQ,OAAO,UAAU;AAC5E,QAAM,mBAAmB,KAAK,KAAK,YAAY,OAAO,OAAO,UAAU;AAEvE,MACE,YAAY,SAAS,UAAU,KAC/B,YAAY,SAAS,aAAa,KAClC,YAAY,SAAS,gBAAgB,GACrC;AACA,WAAO;AAAA,EACT;AAGA,MAAI,aAAa,SAAS,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU,CAAC,GAAG;AACzE,UAAM,aAAa,aAAa;AAAA,MAC9B,KAAK,KAAK,KAAK,KAAK,QAAQ,OAAO,UAAU;AAAA,MAC7C,KAAK,KAAK,KAAK,KAAK,OAAO,UAAU;AAAA,IACvC;AACA,QAAI,gBAAgB,WAAY,QAAO;AAAA,EACzC;AAEA,SAAO;AACT,CAAC;AAED,IAAM,MAAM,IAAI,IAAI;AAAA,EAClB,SAAS,gBAAI;AAAA,EACb;AAAA,EACA,mBAAmB,CAAC,GAAG,oBAAI,IAAI,CAAC,iBAAiB,GAAG,kBAAkB,CAAC,CAAC;AAC1E,CAAC;AACD,IAAI,MAAM;","names":[]}

package/dist/src/commands/deploy.d.ts

@@ -0,0 +1,35 @@
+import { BaseCommand } from '@nexical/cli-core';
+
+interface DeployOptions {
+    dryRun: boolean;
+    railwayToken?: string;
+    railwayName?: string;
+    backendName: string;
+    frontendName: string;
+    cloudflareToken?: string;
+    cloudflareAccount?: string;
+}
+declare class DeployCommand extends BaseCommand {
+    static description: string;
+    static args: {
+        options: ({
+            name: string;
+            description: string;
+            default: boolean;
+        } | {
+            name: string;
+            description: string;
+            default?: undefined;
+        } | {
+            name: string;
+            description: string;
+            default: string;
+        })[];
+    };
+    run(options: DeployOptions): Promise<void>;
+    private setupRailway;
+    private setupCloudflare;
+    private setupGitHubConfig;
+}
+
+export { DeployCommand as default };

package/dist/src/commands/deploy.js

@@ -0,0 +1,196 @@
+import { createRequire } from "module"; const require = createRequire(import.meta.url);
+import {
+  init_esm_shims
+} from "../../chunk-OYFWMYPG.js";
+
+// src/commands/deploy.ts
+init_esm_shims();
+import { BaseCommand } from "@nexical/cli-core";
+import { exec } from "child_process";
+import { promisify } from "util";
+import path from "path";
+var execAsync = promisify(exec);
+var DeployCommand = class extends BaseCommand {
+  static description = `Deploy the application to Railway and Cloudflare.
+
+ENVIRONMENT SETUP & PREREQUISITES:
+1. Install Required CLIs:
+   - Railway CLI: npm i -g @railway/cli
+   - Wrangler (Cloudflare): npm i -g wrangler
+   - GitHub CLI: https://cli.github.com/
+
+2. Authentication:
+   - Railway: Run 'railway login'
+   - GitHub: Run 'gh auth login'
+   - Cloudflare: Obtain an API Token (with Pages edit permissions) and your Account ID from the dashboard.
+
+3. Configuration:
+   Run this command with --cloudflare-token and --cloudflare-account to automate the full setup.
+   Optional: Use --railway-token if you prefer not to use the interactive login.
+   Optional: Use --railway-name to specify a custom Railway project name.
+   Optional: Use --backend-name to specify the Railway service name (default: nexical-backend).
+   Optional: Use --frontend-name to specify the Cloudflare Pages project name (default: nexical-frontend).
+
+PROCESS:
+- Provisions a PostgreSQL database on Railway (if missing).
+- Creates a Cloudflare Pages project for the frontend.
+- Syncs all necessary deployment secrets and variables to GitHub for CI/CD automation.`;
+  static args = {
+    options: [
+      {
+        name: "--dry-run",
+        description: "Simulate the deployment process without making changes.",
+        default: false
+      },
+      {
+        name: "--railway-token <token>",
+        description: "Railway Project Token (optional if already logged in)."
+      },
+      {
+        name: "--railway-name <name>",
+        description: "Railway Project Name (used during initialization)."
+      },
+      {
+        name: "--backend-name <name>",
+        description: "Backend service name on Railway.",
+        default: "nexical-backend"
+      },
+      {
+        name: "--frontend-name <name>",
+        description: "Frontend project name on Cloudflare.",
+        default: "nexical-frontend"
+      },
+      {
+        name: "--cloudflare-token <token>",
+        description: "Cloudflare API Token."
+      },
+      {
+        name: "--cloudflare-account <id>",
+        description: "Cloudflare Account ID."
+      }
+    ]
+  };
+  async run(options) {
+    this.info("Starting Nexical Deployment Automation...");
+    if (options.dryRun) {
+      this.notice("DRY RUN MODE ENABLED");
+    }
+    try {
+      await this.setupRailway(options);
+      await this.setupCloudflare(options);
+      await this.setupGitHubConfig(options);
+      this.success("Deployment setup complete! Your application is being deployed.");
+    } catch (error) {
+      if (error instanceof Error) {
+        this.error(`Deployment failed: ${error.message}`);
+      } else {
+        this.error(`Deployment failed: ${String(error)}`);
+      }
+      process.exit(1);
+    }
+  }
+  async setupRailway(options) {
+    this.info("Configuring Railway...");
+    if (options.dryRun) {
+      const initCmd = options.railwayName ? `railway init --name ${options.railwayName}` : "railway init";
+      this.info(`[Dry Run] Would run: ${initCmd}`);
+      this.info("[Dry Run] Would run: railway add --database postgres");
+      return;
+    }
+    try {
+      this.info("Ensuring Railway project is linked...");
+      const backendDir = path.join(process.cwd(), "apps/backend");
+      try {
+        await execAsync("railway status", { cwd: backendDir });
+      } catch {
+        const initCmd = options.railwayName ? `railway init --name ${options.railwayName}` : "railway init";
+        this.info(`No Railway project detected in apps/backend. Initializing with: ${initCmd}`);
+        await execAsync(initCmd, { cwd: backendDir });
+      }
+      this.info(`Adding PostgreSQL service if missing for "${options.backendName}"...`);
+      const { stdout: status } = await execAsync("railway status", { cwd: backendDir });
+      if (!status.includes("postgres")) {
+        await execAsync("railway add --database postgres", { cwd: backendDir });
+      }
+    } catch (e) {
+      this.warn(
+        "Railway setup encountered an issue. Ensure you are logged in with `railway login`."
+      );
+      throw e;
+    }
+  }
+  async setupCloudflare(options) {
+    this.info("Configuring Cloudflare Pages...");
+    if (options.dryRun) {
+      this.info(`[Dry Run] Would run: wrangler pages project create ${options.frontendName}`);
+      return;
+    }
+    if (!options.cloudflareToken || !options.cloudflareAccount) {
+      this.warn("Cloudflare credentials missing. Skipping automated Cloudflare setup.");
+      this.info("You can manually set up Cloudflare Pages and add the secrets to GitHub.");
+      return;
+    }
+    try {
+      const projectName = options.frontendName;
+      this.info(`Ensuring Cloudflare Pages project "${projectName}" exists...`);
+      try {
+        await execAsync(`wrangler pages project create ${projectName} --production-branch main`, {
+          env: {
+            ...process.env,
+            CLOUDFLARE_API_TOKEN: options.cloudflareToken,
+            CLOUDFLARE_ACCOUNT_ID: options.cloudflareAccount
+          }
+        });
+      } catch {
+        this.info("Cloudflare project might already exist.");
+      }
+    } catch (e) {
+      this.warn("Cloudflare setup failed.");
+      throw e;
+    }
+  }
+  async setupGitHubConfig(options) {
+    this.info("Configuring GitHub Secrets and Variables...");
+    if (options.dryRun) {
+      this.info("[Dry Run] Would run: gh secret set RAILWAY_TOKEN");
+      this.info("[Dry Run] Would run: gh secret set CLOUDFLARE_API_TOKEN");
+      this.info("[Dry Run] Would run: gh secret set CLOUDFLARE_ACCOUNT_ID");
+      this.info(
+        `[Dry Run] Would run: gh variable set RAILWAY_SERVICE_NAME --body "${options.backendName}"`
+      );
+      this.info(
+        `[Dry Run] Would run: gh variable set CLOUDFLARE_PROJECT_NAME --body "${options.frontendName}"`
+      );
+      return;
+    }
+    try {
+      if (options.railwayToken) {
+        this.info("Setting RAILWAY_TOKEN in GitHub...");
+        await execAsync(`gh secret set RAILWAY_TOKEN --body "${options.railwayToken}"`);
+      }
+      if (options.cloudflareToken) {
+        this.info("Setting CLOUDFLARE_API_TOKEN in GitHub...");
+        await execAsync(`gh secret set CLOUDFLARE_API_TOKEN --body "${options.cloudflareToken}"`);
+      }
+      if (options.cloudflareAccount) {
+        this.info("Setting CLOUDFLARE_ACCOUNT_ID in GitHub...");
+        await execAsync(
+          `gh secret set CLOUDFLARE_ACCOUNT_ID --body "${options.cloudflareAccount}"`
+        );
+      }
+      this.info(`Setting RAILWAY_SERVICE_NAME to "${options.backendName}" in GitHub...`);
+      await execAsync(`gh variable set RAILWAY_SERVICE_NAME --body "${options.backendName}"`);
+      this.info(`Setting CLOUDFLARE_PROJECT_NAME to "${options.frontendName}" in GitHub...`);
+      await execAsync(`gh variable set CLOUDFLARE_PROJECT_NAME --body "${options.frontendName}"`);
+    } catch (e) {
+      this.warn(
+        "GitHub configuration failed. Ensure you have the GitHub CLI (gh) installed and are logged in."
+      );
+      throw e;
+    }
+  }
+};
+export {
+  DeployCommand as default
+};
+//# sourceMappingURL=deploy.js.map

package/dist/src/commands/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/deploy.ts"],"sourcesContent":["import { BaseCommand } from '@nexical/cli-core';\nimport { exec } from 'node:child_process';\nimport { promisify } from 'node:util';\nimport path from 'node:path';\n\nconst execAsync = promisify(exec);\n\ninterface DeployOptions {\n  dryRun: boolean;\n  railwayToken?: string;\n  railwayName?: string;\n  backendName: string;\n  frontendName: string;\n  cloudflareToken?: string;\n  cloudflareAccount?: string;\n}\n\nexport default class DeployCommand extends BaseCommand {\n  static description = `Deploy the application to Railway and Cloudflare.\n\nENVIRONMENT SETUP & PREREQUISITES:\n1. Install Required CLIs:\n   - Railway CLI: npm i -g @railway/cli\n   - Wrangler (Cloudflare): npm i -g wrangler\n   - GitHub CLI: https://cli.github.com/\n\n2. Authentication:\n   - Railway: Run 'railway login'\n   - GitHub: Run 'gh auth login'\n   - Cloudflare: Obtain an API Token (with Pages edit permissions) and your Account ID from the dashboard.\n\n3. Configuration:\n   Run this command with --cloudflare-token and --cloudflare-account to automate the full setup.\n   Optional: Use --railway-token if you prefer not to use the interactive login.\n   Optional: Use --railway-name to specify a custom Railway project name.\n   Optional: Use --backend-name to specify the Railway service name (default: nexical-backend).\n   Optional: Use --frontend-name to specify the Cloudflare Pages project name (default: nexical-frontend).\n\nPROCESS:\n- Provisions a PostgreSQL database on Railway (if missing).\n- Creates a Cloudflare Pages project for the frontend.\n- Syncs all necessary deployment secrets and variables to GitHub for CI/CD automation.`;\n\n  static args = {\n    options: [\n      {\n        name: '--dry-run',\n        description: 'Simulate the deployment process without making changes.',\n        default: false,\n      },\n      {\n        name: '--railway-token <token>',\n        description: 'Railway Project Token (optional if already logged in).',\n      },\n      {\n        name: '--railway-name <name>',\n        description: 'Railway Project Name (used during initialization).',\n      },\n      {\n        name: '--backend-name <name>',\n        description: 'Backend service name on Railway.',\n        default: 'nexical-backend',\n      },\n      {\n        name: '--frontend-name <name>',\n        description: 'Frontend project name on Cloudflare.',\n        default: 'nexical-frontend',\n      },\n      {\n        name: '--cloudflare-token <token>',\n        description: 'Cloudflare API Token.',\n      },\n      {\n        name: '--cloudflare-account <id>',\n        description: 'Cloudflare Account ID.',\n      },\n    ],\n  };\n\n  async run(options: DeployOptions) {\n    this.info('Starting Nexical Deployment Automation...');\n\n    if (options.dryRun) {\n      this.notice('DRY RUN MODE ENABLED');\n    }\n\n    try {\n      // 1. Railway Setup\n      await this.setupRailway(options);\n\n      // 2. Cloudflare Setup\n      await this.setupCloudflare(options);\n\n      // 3. GitHub Configuration (Secrets & Variables)\n      await this.setupGitHubConfig(options);\n\n      this.success('Deployment setup complete! Your application is being deployed.');\n    } catch (error: unknown) {\n      if (error instanceof Error) {\n        this.error(`Deployment failed: ${error.message}`);\n      } else {\n        this.error(`Deployment failed: ${String(error)}`);\n      }\n      process.exit(1);\n    }\n  }\n\n  private async setupRailway(options: DeployOptions) {\n    this.info('Configuring Railway...');\n\n    if (options.dryRun) {\n      const initCmd = options.railwayName\n        ? `railway init --name ${options.railwayName}`\n        : 'railway init';\n      this.info(`[Dry Run] Would run: ${initCmd}`);\n      this.info('[Dry Run] Would run: railway add --database postgres');\n      return;\n    }\n\n    try {\n      // Check if railway project exists or init\n      // Note: railway init might be interactive, so we might need to handle that or assume user has linked.\n      // For now, let's assume we use 'railway link' if they passed a token or have it set.\n\n      this.info('Ensuring Railway project is linked...');\n      // Note: We intentionally DO NOT set process.env.RAILWAY_TOKEN here.\n      // Management commands (init, status, add) require an interactive session (railway login).\n      // The provided --railway-token is reserved for GitHub Secrets setup (CI/CD).\n\n      const backendDir = path.join(process.cwd(), 'apps/backend');\n\n      try {\n        await execAsync('railway status', { cwd: backendDir });\n      } catch {\n        const initCmd = options.railwayName\n          ? `railway init --name ${options.railwayName}`\n          : 'railway init';\n        this.info(`No Railway project detected in apps/backend. Initializing with: ${initCmd}`);\n        await execAsync(initCmd, { cwd: backendDir });\n      }\n\n      this.info(`Adding PostgreSQL service if missing for \"${options.backendName}\"...`);\n      const { stdout: status } = await execAsync('railway status', { cwd: backendDir });\n      if (!status.includes('postgres')) {\n        await execAsync('railway add --database postgres', { cwd: backendDir });\n      }\n    } catch (e: unknown) {\n      this.warn(\n        'Railway setup encountered an issue. Ensure you are logged in with `railway login`.',\n      );\n      throw e;\n    }\n  }\n\n  private async setupCloudflare(options: DeployOptions) {\n    this.info('Configuring Cloudflare Pages...');\n\n    if (options.dryRun) {\n      this.info(`[Dry Run] Would run: wrangler pages project create ${options.frontendName}`);\n      return;\n    }\n\n    if (!options.cloudflareToken || !options.cloudflareAccount) {\n      this.warn('Cloudflare credentials missing. Skipping automated Cloudflare setup.');\n      this.info('You can manually set up Cloudflare Pages and add the secrets to GitHub.');\n      return;\n    }\n\n    try {\n      // Use wrangler to create project if it doesn't exist\n      const projectName = options.frontendName;\n      this.info(`Ensuring Cloudflare Pages project \"${projectName}\" exists...`);\n\n      try {\n        await execAsync(`wrangler pages project create ${projectName} --production-branch main`, {\n          env: {\n            ...process.env,\n            CLOUDFLARE_API_TOKEN: options.cloudflareToken,\n            CLOUDFLARE_ACCOUNT_ID: options.cloudflareAccount,\n          },\n        });\n      } catch {\n        this.info('Cloudflare project might already exist.');\n      }\n    } catch (e: unknown) {\n      this.warn('Cloudflare setup failed.');\n      throw e;\n    }\n  }\n\n  private async setupGitHubConfig(options: DeployOptions) {\n    this.info('Configuring GitHub Secrets and Variables...');\n\n    if (options.dryRun) {\n      this.info('[Dry Run] Would run: gh secret set RAILWAY_TOKEN');\n      this.info('[Dry Run] Would run: gh secret set CLOUDFLARE_API_TOKEN');\n      this.info('[Dry Run] Would run: gh secret set CLOUDFLARE_ACCOUNT_ID');\n      this.info(\n        `[Dry Run] Would run: gh variable set RAILWAY_SERVICE_NAME --body \"${options.backendName}\"`,\n      );\n      this.info(\n        `[Dry Run] Would run: gh variable set CLOUDFLARE_PROJECT_NAME --body \"${options.frontendName}\"`,\n      );\n      return;\n    }\n\n    try {\n      if (options.railwayToken) {\n        this.info('Setting RAILWAY_TOKEN in GitHub...');\n        await execAsync(`gh secret set RAILWAY_TOKEN --body \"${options.railwayToken}\"`);\n      }\n\n      if (options.cloudflareToken) {\n        this.info('Setting CLOUDFLARE_API_TOKEN in GitHub...');\n        await execAsync(`gh secret set CLOUDFLARE_API_TOKEN --body \"${options.cloudflareToken}\"`);\n      }\n\n      if (options.cloudflareAccount) {\n        this.info('Setting CLOUDFLARE_ACCOUNT_ID in GitHub...');\n        await execAsync(\n          `gh secret set CLOUDFLARE_ACCOUNT_ID --body \"${options.cloudflareAccount}\"`,\n        );\n      }\n\n      // Set variables\n      this.info(`Setting RAILWAY_SERVICE_NAME to \"${options.backendName}\" in GitHub...`);\n      await execAsync(`gh variable set RAILWAY_SERVICE_NAME --body \"${options.backendName}\"`);\n\n      this.info(`Setting CLOUDFLARE_PROJECT_NAME to \"${options.frontendName}\" in GitHub...`);\n      await execAsync(`gh variable set CLOUDFLARE_PROJECT_NAME --body \"${options.frontendName}\"`);\n    } catch (e: unknown) {\n      this.warn(\n        'GitHub configuration failed. Ensure you have the GitHub CLI (gh) installed and are logged in.',\n      );\n      throw e;\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexical/cli",
-  "version": "0.11.2",
+  "version": "0.11.4",
   "type": "module",
   "bin": {
     "nexical": "./dist/index.js"

package/src/commands/deploy.ts

@@ -0,0 +1,238 @@
+import { BaseCommand } from '@nexical/cli-core';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import path from 'node:path';
+
+const execAsync = promisify(exec);
+
+interface DeployOptions {
+  dryRun: boolean;
+  railwayToken?: string;
+  railwayName?: string;
+  backendName: string;
+  frontendName: string;
+  cloudflareToken?: string;
+  cloudflareAccount?: string;
+}
+
+export default class DeployCommand extends BaseCommand {
+  static description = `Deploy the application to Railway and Cloudflare.
+
+ENVIRONMENT SETUP & PREREQUISITES:
+1. Install Required CLIs:
+   - Railway CLI: npm i -g @railway/cli
+   - Wrangler (Cloudflare): npm i -g wrangler
+   - GitHub CLI: https://cli.github.com/
+
+2. Authentication:
+   - Railway: Run 'railway login'
+   - GitHub: Run 'gh auth login'
+   - Cloudflare: Obtain an API Token (with Pages edit permissions) and your Account ID from the dashboard.
+
+3. Configuration:
+   Run this command with --cloudflare-token and --cloudflare-account to automate the full setup.
+   Optional: Use --railway-token if you prefer not to use the interactive login.
+   Optional: Use --railway-name to specify a custom Railway project name.
+   Optional: Use --backend-name to specify the Railway service name (default: nexical-backend).
+   Optional: Use --frontend-name to specify the Cloudflare Pages project name (default: nexical-frontend).
+
+PROCESS:
+- Provisions a PostgreSQL database on Railway (if missing).
+- Creates a Cloudflare Pages project for the frontend.
+- Syncs all necessary deployment secrets and variables to GitHub for CI/CD automation.`;
+
+  static args = {
+    options: [
+      {
+        name: '--dry-run',
+        description: 'Simulate the deployment process without making changes.',
+        default: false,
+      },
+      {
+        name: '--railway-token <token>',
+        description: 'Railway Project Token (optional if already logged in).',
+      },
+      {
+        name: '--railway-name <name>',
+        description: 'Railway Project Name (used during initialization).',
+      },
+      {
+        name: '--backend-name <name>',
+        description: 'Backend service name on Railway.',
+        default: 'nexical-backend',
+      },
+      {
+        name: '--frontend-name <name>',
+        description: 'Frontend project name on Cloudflare.',
+        default: 'nexical-frontend',
+      },
+      {
+        name: '--cloudflare-token <token>',
+        description: 'Cloudflare API Token.',
+      },
+      {
+        name: '--cloudflare-account <id>',
+        description: 'Cloudflare Account ID.',
+      },
+    ],
+  };
+
+  async run(options: DeployOptions) {
+    this.info('Starting Nexical Deployment Automation...');
+
+    if (options.dryRun) {
+      this.notice('DRY RUN MODE ENABLED');
+    }
+
+    try {
+      // 1. Railway Setup
+      await this.setupRailway(options);
+
+      // 2. Cloudflare Setup
+      await this.setupCloudflare(options);
+
+      // 3. GitHub Configuration (Secrets & Variables)
+      await this.setupGitHubConfig(options);
+
+      this.success('Deployment setup complete! Your application is being deployed.');
+    } catch (error: unknown) {
+      if (error instanceof Error) {
+        this.error(`Deployment failed: ${error.message}`);
+      } else {
+        this.error(`Deployment failed: ${String(error)}`);
+      }
+      process.exit(1);
+    }
+  }
+
+  private async setupRailway(options: DeployOptions) {
+    this.info('Configuring Railway...');
+
+    if (options.dryRun) {
+      const initCmd = options.railwayName
+        ? `railway init --name ${options.railwayName}`
+        : 'railway init';
+      this.info(`[Dry Run] Would run: ${initCmd}`);
+      this.info('[Dry Run] Would run: railway add --database postgres');
+      return;
+    }
+
+    try {
+      // Check if railway project exists or init
+      // Note: railway init might be interactive, so we might need to handle that or assume user has linked.
+      // For now, let's assume we use 'railway link' if they passed a token or have it set.
+
+      this.info('Ensuring Railway project is linked...');
+      // Note: We intentionally DO NOT set process.env.RAILWAY_TOKEN here.
+      // Management commands (init, status, add) require an interactive session (railway login).
+      // The provided --railway-token is reserved for GitHub Secrets setup (CI/CD).
+
+      const backendDir = path.join(process.cwd(), 'apps/backend');
+
+      try {
+        await execAsync('railway status', { cwd: backendDir });
+      } catch {
+        const initCmd = options.railwayName
+          ? `railway init --name ${options.railwayName}`
+          : 'railway init';
+        this.info(`No Railway project detected in apps/backend. Initializing with: ${initCmd}`);
+        await execAsync(initCmd, { cwd: backendDir });
+      }
+
+      this.info(`Adding PostgreSQL service if missing for "${options.backendName}"...`);
+      const { stdout: status } = await execAsync('railway status', { cwd: backendDir });
+      if (!status.includes('postgres')) {
+        await execAsync('railway add --database postgres', { cwd: backendDir });
+      }
+    } catch (e: unknown) {
+      this.warn(
+        'Railway setup encountered an issue. Ensure you are logged in with `railway login`.',
+      );
+      throw e;
+    }
+  }
+
+  private async setupCloudflare(options: DeployOptions) {
+    this.info('Configuring Cloudflare Pages...');
+
+    if (options.dryRun) {
+      this.info(`[Dry Run] Would run: wrangler pages project create ${options.frontendName}`);
+      return;
+    }
+
+    if (!options.cloudflareToken || !options.cloudflareAccount) {
+      this.warn('Cloudflare credentials missing. Skipping automated Cloudflare setup.');
+      this.info('You can manually set up Cloudflare Pages and add the secrets to GitHub.');
+      return;
+    }
+
+    try {
+      // Use wrangler to create project if it doesn't exist
+      const projectName = options.frontendName;
+      this.info(`Ensuring Cloudflare Pages project "${projectName}" exists...`);
+
+      try {
+        await execAsync(`wrangler pages project create ${projectName} --production-branch main`, {
+          env: {
+            ...process.env,
+            CLOUDFLARE_API_TOKEN: options.cloudflareToken,
+            CLOUDFLARE_ACCOUNT_ID: options.cloudflareAccount,
+          },
+        });
+      } catch {
+        this.info('Cloudflare project might already exist.');
+      }
+    } catch (e: unknown) {
+      this.warn('Cloudflare setup failed.');
+      throw e;
+    }
+  }
+
+  private async setupGitHubConfig(options: DeployOptions) {
+    this.info('Configuring GitHub Secrets and Variables...');
+
+    if (options.dryRun) {
+      this.info('[Dry Run] Would run: gh secret set RAILWAY_TOKEN');
+      this.info('[Dry Run] Would run: gh secret set CLOUDFLARE_API_TOKEN');
+      this.info('[Dry Run] Would run: gh secret set CLOUDFLARE_ACCOUNT_ID');
+      this.info(
+        `[Dry Run] Would run: gh variable set RAILWAY_SERVICE_NAME --body "${options.backendName}"`,
+      );
+      this.info(
+        `[Dry Run] Would run: gh variable set CLOUDFLARE_PROJECT_NAME --body "${options.frontendName}"`,
+      );
+      return;
+    }
+
+    try {
+      if (options.railwayToken) {
+        this.info('Setting RAILWAY_TOKEN in GitHub...');
+        await execAsync(`gh secret set RAILWAY_TOKEN --body "${options.railwayToken}"`);
+      }
+
+      if (options.cloudflareToken) {
+        this.info('Setting CLOUDFLARE_API_TOKEN in GitHub...');
+        await execAsync(`gh secret set CLOUDFLARE_API_TOKEN --body "${options.cloudflareToken}"`);
+      }
+
+      if (options.cloudflareAccount) {
+        this.info('Setting CLOUDFLARE_ACCOUNT_ID in GitHub...');
+        await execAsync(
+          `gh secret set CLOUDFLARE_ACCOUNT_ID --body "${options.cloudflareAccount}"`,
+        );
+      }
+
+      // Set variables
+      this.info(`Setting RAILWAY_SERVICE_NAME to "${options.backendName}" in GitHub...`);
+      await execAsync(`gh variable set RAILWAY_SERVICE_NAME --body "${options.backendName}"`);
+
+      this.info(`Setting CLOUDFLARE_PROJECT_NAME to "${options.frontendName}" in GitHub...`);
+      await execAsync(`gh variable set CLOUDFLARE_PROJECT_NAME --body "${options.frontendName}"`);
+    } catch (e: unknown) {
+      this.warn(
+        'GitHub configuration failed. Ensure you have the GitHub CLI (gh) installed and are logged in.',
+      );
+      throw e;
+    }
+  }
+}