@nexical/cli 0.11.5 → 0.11.7

package/dist/index.js

@@ -15,7 +15,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@nexical/cli",
-  version: "0.11.5",
+  version: "0.11.7",
   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.5\",\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    \"dotenv\": \"^17.3.1\",\n    \"fast-glob\": \"^3.3.3\",\n    \"jiti\": \"^2.6.1\",\n    \"yaml\": \"^2.3.4\"\n  },\n  \"devDependencies\": {\n    \"@eslint/js\": \"^9.39.2\",\n    \"@types/fs-extra\": \"^11.0.4\",\n    \"@types/node\": \"^20.10.0\",\n    \"@vitest/coverage-v8\": \"^4.0.15\",\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    \"execa\": \"^9.6.1\",\n    \"fs-extra\": \"^11.3.2\",\n    \"globals\": \"^17.2.0\",\n    \"husky\": \"^9.1.7\",\n    \"lint-staged\": \"^16.2.7\",\n    \"prettier\": \"^3.8.1\",\n    \"tsup\": \"^8.0.1\",\n    \"tsx\": \"^4.21.0\",\n    \"typescript\": \"^5.3.3\",\n    \"typescript-eslint\": \"^8.54.0\",\n    \"vitest\": \"^4.0.15\"\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,QAAU;AAAA,IACV,aAAa;AAAA,IACb,MAAQ;AAAA,IACR,MAAQ;AAAA,EACV;AAAA,EACA,iBAAmB;AAAA,IACjB,cAAc;AAAA,IACd,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,uBAAuB;AAAA,IACvB,QAAU;AAAA,IACV,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,6BAA6B;AAAA,IAC7B,OAAS;AAAA,IACT,YAAY;AAAA,IACZ,SAAW;AAAA,IACX,OAAS;AAAA,IACT,eAAe;AAAA,IACf,UAAY;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,IACP,YAAc;AAAA,IACd,qBAAqB;AAAA,IACrB,QAAU;AAAA,EACZ;AACF;;;ADtDA,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.7\",\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    \"dotenv\": \"^17.3.1\",\n    \"fast-glob\": \"^3.3.3\",\n    \"jiti\": \"^2.6.1\",\n    \"yaml\": \"^2.3.4\"\n  },\n  \"devDependencies\": {\n    \"@eslint/js\": \"^9.39.2\",\n    \"@types/fs-extra\": \"^11.0.4\",\n    \"@types/node\": \"^20.10.0\",\n    \"@vitest/coverage-v8\": \"^4.0.15\",\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    \"execa\": \"^9.6.1\",\n    \"fs-extra\": \"^11.3.2\",\n    \"globals\": \"^17.2.0\",\n    \"husky\": \"^9.1.7\",\n    \"lint-staged\": \"^16.2.7\",\n    \"prettier\": \"^3.8.1\",\n    \"tsup\": \"^8.0.1\",\n    \"tsx\": \"^4.21.0\",\n    \"typescript\": \"^5.3.3\",\n    \"typescript-eslint\": \"^8.54.0\",\n    \"vitest\": \"^4.0.15\"\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,QAAU;AAAA,IACV,aAAa;AAAA,IACb,MAAQ;AAAA,IACR,MAAQ;AAAA,EACV;AAAA,EACA,iBAAmB;AAAA,IACjB,cAAc;AAAA,IACd,mBAAmB;AAAA,IACnB,eAAe;AAAA,IACf,uBAAuB;AAAA,IACvB,QAAU;AAAA,IACV,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,0BAA0B;AAAA,IAC1B,uBAAuB;AAAA,IACvB,6BAA6B;AAAA,IAC7B,OAAS;AAAA,IACT,YAAY;AAAA,IACZ,SAAW;AAAA,IACX,OAAS;AAAA,IACT,eAAe;AAAA,IACf,UAAY;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,IACP,YAAc;AAAA,IACd,qBAAqB;AAAA,IACrB,QAAU;AAAA,EACZ;AACF;;;ADtDA,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

@@ -7,6 +7,10 @@ declare class DeployCommand extends BaseCommand {
             name: string;
             description: string;
             default?: undefined;
+        } | {
+            name: string;
+            description: string;
+            default: string;
         } | {
             name: string;
             description: string;

package/dist/src/commands/deploy.js

@@ -51,6 +51,11 @@ PROCESS:
         name: "--repo <provider>",
         description: "Override repositroy provider"
       },
+      {
+        name: "--env <environment>",
+        description: "Deployment environment (e.g. production, staging)",
+        default: "production"
+      },
       {
         name: "--dry-run",
         description: "Simulate the deployment process",

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/deploy.ts"],"sourcesContent":["import path from 'node:path';\nimport dotenv from 'dotenv';\nimport { BaseCommand } from '@nexical/cli-core';\nimport { ConfigManager } from '../deploy/config-manager';\nimport { ProviderRegistry } from '../deploy/registry';\nimport { DeploymentContext } from '../deploy/types';\n\nexport default class DeployCommand extends BaseCommand {\n  static description = `Deploy the application based on nexical.yaml configuration.\n\nThis command orchestrates the deployment of your frontend and backend applications \nby interacting with the providers specified in your configuration file.\n\nCONFIGURATION:\n- Requires a 'nexical.yaml' file in the project root.\n- If the file or specific sections are missing, the CLI will prompt you to run an interactive setup \n  and save the configuration for future uses.\n- Supports loading environment variables from a .env file in the project root.\n\nPROVIDERS:\n- Backend: Railway, etc.\n- Frontend: Cloudflare Pages, etc.\n- Repository: GitHub, GitLab, etc.\n\nPROCESS:\n1. Loads environment variables from '.env'.\n2. Loads configuration from 'nexical.yaml'.\n3. Provisions resources via the selected providers.\n4. Configures the repository (secrets/variables) for CI/CD.\n5. Generates CI/CD workflow files.`;\n\n  static args = {\n    options: [\n      {\n        name: '--backend <provider>',\n        description: 'Override backend provider',\n      },\n      {\n        name: '--frontend <provider>',\n        description: 'Override frontend provider',\n      },\n      {\n        name: '--repo <provider>',\n        description: 'Override repositroy provider',\n      },\n      {\n        name: '--dry-run',\n        description: 'Simulate the deployment process',\n        default: false,\n      },\n    ],\n  };\n\n  async run(options: Record<string, unknown>) {\n    this.info('Starting Nexical Deployment...');\n\n    // Load environment variables from .env\n    dotenv.config({ path: path.join(process.cwd(), '.env') });\n\n    const configManager = new ConfigManager(process.cwd());\n    const config = await configManager.load();\n    const registry = new ProviderRegistry();\n\n    // Register core and local providers\n    await registry.loadCoreProviders();\n    await registry.loadLocalProviders(process.cwd());\n\n    // Resolve providers (CLI flags > Config > Error)\n    const backendProviderName =\n      (options.backend as string | undefined) || config.deploy?.backend?.provider;\n    if (!backendProviderName) {\n      this.error(\n        \"Backend provider not specified. Use --backend flag or configure 'deploy.backend.provider' in nexical.yaml.\",\n      );\n    }\n\n    const frontendProviderName =\n      (options.frontend as string | undefined) || config.deploy?.frontend?.provider;\n    if (!frontendProviderName) {\n      this.error(\n        \"Frontend provider not specified. Use --frontend flag or configure 'deploy.frontend.provider' in nexical.yaml.\",\n      );\n    }\n\n    const repoProviderName =\n      (options.repo as string | undefined) || config.deploy?.repository?.provider;\n    if (!repoProviderName) {\n      this.error(\n        \"Repository provider not specified. Use --repo flag or configure 'deploy.repository.provider' in nexical.yaml.\",\n      );\n    }\n\n    const backendProvider = registry.getDeploymentProvider(backendProviderName!);\n    const frontendProvider = registry.getDeploymentProvider(frontendProviderName!);\n    const repoProvider = registry.getRepositoryProvider(repoProviderName!);\n\n    if (!backendProvider) throw new Error(`Backend provider '${backendProviderName}' not found.`);\n    if (!frontendProvider)\n      throw new Error(`Frontend provider '${frontendProviderName}' not found.`);\n    if (!repoProvider) throw new Error(`Repository provider '${repoProviderName}' not found.`);\n\n    const context: DeploymentContext = {\n      cwd: process.cwd(),\n      config,\n      options,\n    };\n\n    // Provision\n    this.info(`Provisioning Backend with ${backendProvider.name}...`);\n    await backendProvider.provision(context);\n\n    this.info(`Provisioning Frontend with ${frontendProvider.name}...`);\n    await frontendProvider.provision(context);\n\n    // Configure Repo\n    this.info(`Configuring Repository with ${repoProvider.name}...`);\n\n    const secrets: Record<string, string> = {};\n\n    // Collect secrets from Backend Provider\n    this.info(`Resolving secrets from ${backendProvider.name}...`);\n    try {\n      const backendSecrets = await backendProvider.getSecrets(context);\n      Object.assign(secrets, backendSecrets);\n    } catch (e: unknown) {\n      const message = e instanceof Error ? e.message : String(e);\n      this.error(`Failed to resolve secrets for ${backendProvider.name}: ${message}`);\n    }\n\n    // Collect secrets from Frontend Provider\n    this.info(`Resolving secrets from ${frontendProvider.name}...`);\n    try {\n      const frontendSecrets = await frontendProvider.getSecrets(context);\n      Object.assign(secrets, frontendSecrets);\n    } catch (e: unknown) {\n      const message = e instanceof Error ? e.message : String(e);\n      this.error(`Failed to resolve secrets for ${frontendProvider.name}: ${message}`);\n    }\n\n    await repoProvider.configureSecrets(context, secrets);\n\n    const variables: Record<string, string> = {};\n\n    // Collect variables from Backend Provider\n    try {\n      const backendVars = await backendProvider.getVariables(context);\n      Object.assign(variables, backendVars);\n    } catch (e: unknown) {\n      const message = e instanceof Error ? e.message : String(e);\n      this.error(`Failed to resolve variables for ${backendProvider.name}: ${message}`);\n    }\n\n    // Collect variables from Frontend Provider\n    try {\n      const frontendVars = await frontendProvider.getVariables(context);\n      Object.assign(variables, frontendVars);\n    } catch (e: unknown) {\n      const message = e instanceof Error ? e.message : String(e);\n      this.error(`Failed to resolve variables for ${frontendProvider.name}: ${message}`);\n    }\n\n    await repoProvider.configureVariables(context, variables);\n\n    // Generate Workflows\n    this.info('Generating CI/CD Workflows...');\n    await repoProvider.generateWorkflow(context, [backendProvider, frontendProvider]);\n\n    this.success('Deployment configuration complete!');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/commands/deploy.ts"],"sourcesContent":["import path from 'node:path';\nimport dotenv from 'dotenv';\nimport { BaseCommand } from '@nexical/cli-core';\nimport { ConfigManager } from '../deploy/config-manager';\nimport { ProviderRegistry } from '../deploy/registry';\nimport { DeploymentContext } from '../deploy/types';\n\nexport default class DeployCommand extends BaseCommand {\n  static description = `Deploy the application based on nexical.yaml configuration.\n\nThis command orchestrates the deployment of your frontend and backend applications \nby interacting with the providers specified in your configuration file.\n\nCONFIGURATION:\n- Requires a 'nexical.yaml' file in the project root.\n- If the file or specific sections are missing, the CLI will prompt you to run an interactive setup \n  and save the configuration for future uses.\n- Supports loading environment variables from a .env file in the project root.\n\nPROVIDERS:\n- Backend: Railway, etc.\n- Frontend: Cloudflare Pages, etc.\n- Repository: GitHub, GitLab, etc.\n\nPROCESS:\n1. Loads environment variables from '.env'.\n2. Loads configuration from 'nexical.yaml'.\n3. Provisions resources via the selected providers.\n4. Configures the repository (secrets/variables) for CI/CD.\n5. Generates CI/CD workflow files.`;\n\n  static args = {\n    options: [\n      {\n        name: '--backend <provider>',\n        description: 'Override backend provider',\n      },\n      {\n        name: '--frontend <provider>',\n        description: 'Override frontend provider',\n      },\n      {\n        name: '--repo <provider>',\n        description: 'Override repositroy provider',\n      },\n      {\n        name: '--env <environment>',\n        description: 'Deployment environment (e.g. production, staging)',\n        default: 'production',\n      },\n      {\n        name: '--dry-run',\n        description: 'Simulate the deployment process',\n        default: false,\n      },\n    ],\n  };\n\n  async run(options: Record<string, unknown>) {\n    this.info('Starting Nexical Deployment...');\n\n    // Load environment variables from .env\n    dotenv.config({ path: path.join(process.cwd(), '.env') });\n\n    const configManager = new ConfigManager(process.cwd());\n    const config = await configManager.load();\n    const registry = new ProviderRegistry();\n\n    // Register core and local providers\n    await registry.loadCoreProviders();\n    await registry.loadLocalProviders(process.cwd());\n\n    // Resolve providers (CLI flags > Config > Error)\n    const backendProviderName =\n      (options.backend as string | undefined) || config.deploy?.backend?.provider;\n    if (!backendProviderName) {\n      this.error(\n        \"Backend provider not specified. Use --backend flag or configure 'deploy.backend.provider' in nexical.yaml.\",\n      );\n    }\n\n    const frontendProviderName =\n      (options.frontend as string | undefined) || config.deploy?.frontend?.provider;\n    if (!frontendProviderName) {\n      this.error(\n        \"Frontend provider not specified. Use --frontend flag or configure 'deploy.frontend.provider' in nexical.yaml.\",\n      );\n    }\n\n    const repoProviderName =\n      (options.repo as string | undefined) || config.deploy?.repository?.provider;\n    if (!repoProviderName) {\n      this.error(\n        \"Repository provider not specified. Use --repo flag or configure 'deploy.repository.provider' in nexical.yaml.\",\n      );\n    }\n\n    const backendProvider = registry.getDeploymentProvider(backendProviderName!);\n    const frontendProvider = registry.getDeploymentProvider(frontendProviderName!);\n    const repoProvider = registry.getRepositoryProvider(repoProviderName!);\n\n    if (!backendProvider) throw new Error(`Backend provider '${backendProviderName}' not found.`);\n    if (!frontendProvider)\n      throw new Error(`Frontend provider '${frontendProviderName}' not found.`);\n    if (!repoProvider) throw new Error(`Repository provider '${repoProviderName}' not found.`);\n\n    const context: DeploymentContext = {\n      cwd: process.cwd(),\n      config,\n      options,\n    };\n\n    // Provision\n    this.info(`Provisioning Backend with ${backendProvider.name}...`);\n    await backendProvider.provision(context);\n\n    this.info(`Provisioning Frontend with ${frontendProvider.name}...`);\n    await frontendProvider.provision(context);\n\n    // Configure Repo\n    this.info(`Configuring Repository with ${repoProvider.name}...`);\n\n    const secrets: Record<string, string> = {};\n\n    // Collect secrets from Backend Provider\n    this.info(`Resolving secrets from ${backendProvider.name}...`);\n    try {\n      const backendSecrets = await backendProvider.getSecrets(context);\n      Object.assign(secrets, backendSecrets);\n    } catch (e: unknown) {\n      const message = e instanceof Error ? e.message : String(e);\n      this.error(`Failed to resolve secrets for ${backendProvider.name}: ${message}`);\n    }\n\n    // Collect secrets from Frontend Provider\n    this.info(`Resolving secrets from ${frontendProvider.name}...`);\n    try {\n      const frontendSecrets = await frontendProvider.getSecrets(context);\n      Object.assign(secrets, frontendSecrets);\n    } catch (e: unknown) {\n      const message = e instanceof Error ? e.message : String(e);\n      this.error(`Failed to resolve secrets for ${frontendProvider.name}: ${message}`);\n    }\n\n    await repoProvider.configureSecrets(context, secrets);\n\n    const variables: Record<string, string> = {};\n\n    // Collect variables from Backend Provider\n    try {\n      const backendVars = await backendProvider.getVariables(context);\n      Object.assign(variables, backendVars);\n    } catch (e: unknown) {\n      const message = e instanceof Error ? e.message : String(e);\n      this.error(`Failed to resolve variables for ${backendProvider.name}: ${message}`);\n    }\n\n    // Collect variables from Frontend Provider\n    try {\n      const frontendVars = await frontendProvider.getVariables(context);\n      Object.assign(variables, frontendVars);\n    } catch (e: unknown) {\n      const message = e instanceof Error ? e.message : String(e);\n      this.error(`Failed to resolve variables for ${frontendProvider.name}: ${message}`);\n    }\n\n    await repoProvider.configureVariables(context, variables);\n\n    // Generate Workflows\n    this.info('Generating CI/CD Workflows...');\n    await repoProvider.generateWorkflow(context, [backendProvider, frontendProvider]);\n\n    this.success('Deployment configuration complete!');\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAAA;AAAA,OAAO,UAAU;AACjB,OAAO,YAAY;AACnB,SAAS,mBAAmB;AAK5B,IAAqB,gBAArB,cAA2C,YAAY;AAAA,EACrD,OAAO,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBrB,OAAO,OAAO;AAAA,IACZ,SAAS;AAAA,MACP;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,QACb,SAAS;AAAA,MACX;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,QACb,SAAS;AAAA,MACX;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,IAAI,SAAkC;AAC1C,SAAK,KAAK,gCAAgC;AAG1C,WAAO,OAAO,EAAE,MAAM,KAAK,KAAK,QAAQ,IAAI,GAAG,MAAM,EAAE,CAAC;AAExD,UAAM,gBAAgB,IAAI,cAAc,QAAQ,IAAI,CAAC;AACrD,UAAM,SAAS,MAAM,cAAc,KAAK;AACxC,UAAM,WAAW,IAAI,iBAAiB;AAGtC,UAAM,SAAS,kBAAkB;AACjC,UAAM,SAAS,mBAAmB,QAAQ,IAAI,CAAC;AAG/C,UAAM,sBACH,QAAQ,WAAkC,OAAO,QAAQ,SAAS;AACrE,QAAI,CAAC,qBAAqB;AACxB,WAAK;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAEA,UAAM,uBACH,QAAQ,YAAmC,OAAO,QAAQ,UAAU;AACvE,QAAI,CAAC,sBAAsB;AACzB,WAAK;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAEA,UAAM,mBACH,QAAQ,QAA+B,OAAO,QAAQ,YAAY;AACrE,QAAI,CAAC,kBAAkB;AACrB,WAAK;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAEA,UAAM,kBAAkB,SAAS,sBAAsB,mBAAoB;AAC3E,UAAM,mBAAmB,SAAS,sBAAsB,oBAAqB;AAC7E,UAAM,eAAe,SAAS,sBAAsB,gBAAiB;AAErE,QAAI,CAAC,gBAAiB,OAAM,IAAI,MAAM,qBAAqB,mBAAmB,cAAc;AAC5F,QAAI,CAAC;AACH,YAAM,IAAI,MAAM,sBAAsB,oBAAoB,cAAc;AAC1E,QAAI,CAAC,aAAc,OAAM,IAAI,MAAM,wBAAwB,gBAAgB,cAAc;AAEzF,UAAM,UAA6B;AAAA,MACjC,KAAK,QAAQ,IAAI;AAAA,MACjB;AAAA,MACA;AAAA,IACF;AAGA,SAAK,KAAK,6BAA6B,gBAAgB,IAAI,KAAK;AAChE,UAAM,gBAAgB,UAAU,OAAO;AAEvC,SAAK,KAAK,8BAA8B,iBAAiB,IAAI,KAAK;AAClE,UAAM,iBAAiB,UAAU,OAAO;AAGxC,SAAK,KAAK,+BAA+B,aAAa,IAAI,KAAK;AAE/D,UAAM,UAAkC,CAAC;AAGzC,SAAK,KAAK,0BAA0B,gBAAgB,IAAI,KAAK;AAC7D,QAAI;AACF,YAAM,iBAAiB,MAAM,gBAAgB,WAAW,OAAO;AAC/D,aAAO,OAAO,SAAS,cAAc;AAAA,IACvC,SAAS,GAAY;AACnB,YAAM,UAAU,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;AACzD,WAAK,MAAM,iCAAiC,gBAAgB,IAAI,KAAK,OAAO,EAAE;AAAA,IAChF;AAGA,SAAK,KAAK,0BAA0B,iBAAiB,IAAI,KAAK;AAC9D,QAAI;AACF,YAAM,kBAAkB,MAAM,iBAAiB,WAAW,OAAO;AACjE,aAAO,OAAO,SAAS,eAAe;AAAA,IACxC,SAAS,GAAY;AACnB,YAAM,UAAU,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;AACzD,WAAK,MAAM,iCAAiC,iBAAiB,IAAI,KAAK,OAAO,EAAE;AAAA,IACjF;AAEA,UAAM,aAAa,iBAAiB,SAAS,OAAO;AAEpD,UAAM,YAAoC,CAAC;AAG3C,QAAI;AACF,YAAM,cAAc,MAAM,gBAAgB,aAAa,OAAO;AAC9D,aAAO,OAAO,WAAW,WAAW;AAAA,IACtC,SAAS,GAAY;AACnB,YAAM,UAAU,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;AACzD,WAAK,MAAM,mCAAmC,gBAAgB,IAAI,KAAK,OAAO,EAAE;AAAA,IAClF;AAGA,QAAI;AACF,YAAM,eAAe,MAAM,iBAAiB,aAAa,OAAO;AAChE,aAAO,OAAO,WAAW,YAAY;AAAA,IACvC,SAAS,GAAY;AACnB,YAAM,UAAU,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;AACzD,WAAK,MAAM,mCAAmC,iBAAiB,IAAI,KAAK,OAAO,EAAE;AAAA,IACnF;AAEA,UAAM,aAAa,mBAAmB,SAAS,SAAS;AAGxD,SAAK,KAAK,+BAA+B;AACzC,UAAM,aAAa,iBAAiB,SAAS,CAAC,iBAAiB,gBAAgB,CAAC;AAEhF,SAAK,QAAQ,oCAAoC;AAAA,EACnD;AACF;","names":[]}

package/dist/src/deploy/providers/cloudflare.js

@@ -13,12 +13,14 @@ var CloudflareProvider = class {
   name = "cloudflare";
   type = "frontend";
   async provision(context) {
-    const projectName = context.config.deploy?.frontend?.projectName;
-    if (!projectName) {
+    const env = context.options.env || "production";
+    const baseProjectName = context.config.deploy?.frontend?.projectName;
+    if (!baseProjectName) {
       throw new Error(
         "Cloudflare project name not found in nexical.yaml. Please configure 'deploy.frontend.projectName'."
       );
     }
+    const projectName = env === "production" ? baseProjectName : `${baseProjectName}-${env}`;
     const options = context.config.deploy?.frontend?.options || {};
     const apiTokenEnvVar = typeof options.apiTokenEnvVar === "string" ? options.apiTokenEnvVar : void 0;
     const apiToken = (typeof context.options.cloudflareToken === "string" ? context.options.cloudflareToken : void 0) || (apiTokenEnvVar ? process.env[apiTokenEnvVar] : void 0) || process.env.CLOUDFLARE_API_TOKEN;
@@ -26,7 +28,9 @@ var CloudflareProvider = class {
     const accountId = (typeof context.options.cloudflareAccount === "string" ? context.options.cloudflareAccount : void 0) || (accountIdEnvVar ? process.env[accountIdEnvVar] : void 0) || process.env.CLOUDFLARE_ACCOUNT_ID;
     logger.info("Configuring Cloudflare Pages...");
     if (context.options.dryRun) {
-      logger.info("[Dry Run] Would check Cloudflare Pages project and create if missing.");
+      logger.info(
+        `[Dry Run] Would check Cloudflare Pages project "${projectName}" and create if missing.`
+      );
       return;
     }
     if (!apiToken || !accountId) {
@@ -78,12 +82,14 @@ var CloudflareProvider = class {
     return secrets;
   }
   async getVariables(context) {
-    const projectName = context.config.deploy?.frontend?.projectName;
-    if (!projectName) {
+    const env = context.options.env || "production";
+    const baseProjectName = context.config.deploy?.frontend?.projectName;
+    if (!baseProjectName) {
       throw new Error(
         "Cloudflare project name not found in nexical.yaml. Please configure 'deploy.frontend.projectName'."
       );
     }
+    const projectName = env === "production" ? baseProjectName : `${baseProjectName}-${env}`;
     return {
       CLOUDFLARE_PROJECT_NAME: projectName
     };

package/dist/src/deploy/providers/cloudflare.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/deploy/providers/cloudflare.ts"],"sourcesContent":["import { logger } from '@nexical/cli-core';\nimport { DeploymentProvider, DeploymentContext, CIConfig } from '../types';\nimport { execAsync } from '../utils';\n\nexport class CloudflareProvider implements DeploymentProvider {\n  name = 'cloudflare';\n  type = 'frontend' as const;\n\n  async provision(context: DeploymentContext): Promise<void> {\n    const projectName = context.config.deploy?.frontend?.projectName;\n\n    if (!projectName) {\n      throw new Error(\n        \"Cloudflare project name not found in nexical.yaml. Please configure 'deploy.frontend.projectName'.\",\n      );\n    }\n\n    const options = context.config.deploy?.frontend?.options || {};\n\n    // Resolve credentials:\n    // 1. CLI flag (options)\n    // 2. Env var defined in config (options.apiTokenEnvVar)\n    // 3. Default env var (CLOUDFLARE_API_TOKEN)\n    const apiTokenEnvVar =\n      typeof options.apiTokenEnvVar === 'string' ? options.apiTokenEnvVar : undefined;\n    const apiToken =\n      (typeof context.options.cloudflareToken === 'string'\n        ? context.options.cloudflareToken\n        : undefined) ||\n      (apiTokenEnvVar ? process.env[apiTokenEnvVar] : undefined) ||\n      process.env.CLOUDFLARE_API_TOKEN;\n\n    const accountIdEnvVar =\n      typeof options.accountIdEnvVar === 'string' ? options.accountIdEnvVar : undefined;\n    const accountId =\n      (typeof context.options.cloudflareAccount === 'string'\n        ? context.options.cloudflareAccount\n        : undefined) ||\n      (accountIdEnvVar ? process.env[accountIdEnvVar] : undefined) ||\n      process.env.CLOUDFLARE_ACCOUNT_ID;\n\n    logger.info('Configuring Cloudflare Pages...');\n\n    if (context.options.dryRun) {\n      logger.info('[Dry Run] Would check Cloudflare Pages project and create if missing.');\n      return;\n    }\n\n    if (!apiToken || !accountId) {\n      logger.warn('Cloudflare credentials missing. Skipping automated Cloudflare setup.');\n      logger.info('You can manually set up Cloudflare Pages and add the secrets to GitHub.');\n      return;\n    }\n\n    try {\n      logger.info(`Ensuring Cloudflare Pages project \"${projectName}\" exists...`);\n      try {\n        await execAsync(`wrangler pages project create ${projectName} --production-branch main`, {\n          env: {\n            ...process.env,\n            CLOUDFLARE_API_TOKEN: apiToken,\n            CLOUDFLARE_ACCOUNT_ID: accountId,\n          },\n        });\n      } catch {\n        logger.info('Cloudflare project might already exist.');\n      }\n    } catch (e: unknown) {\n      logger.warn('Cloudflare setup failed.');\n      throw e;\n    }\n  }\n\n  async getSecrets(context: DeploymentContext): Promise<Record<string, string>> {\n    const options = context.config.deploy?.frontend?.options || {};\n    const secrets: Record<string, string> = {};\n\n    // Resolve API Token\n    const apiTokenEnvVar =\n      typeof options.apiTokenEnvVar === 'string' ? options.apiTokenEnvVar : undefined;\n    const apiToken =\n      (apiTokenEnvVar ? process.env[apiTokenEnvVar] : undefined) ||\n      process.env.CLOUDFLARE_API_TOKEN;\n\n    if (!apiToken) {\n      throw new Error(\n        `Cloudflare API Token not found. Please provide it via:\\n` +\n          `1. Configuring 'deploy.frontend.options.apiTokenEnvVar' in nexical.yaml and setting that env var in .env\\n` +\n          `2. Setting CLOUDFLARE_API_TOKEN in .env`,\n      );\n    }\n    secrets['CLOUDFLARE_API_TOKEN'] = apiToken;\n\n    // Resolve Account ID\n    const accountIdEnvVar =\n      typeof options.accountIdEnvVar === 'string' ? options.accountIdEnvVar : undefined;\n    const accountId =\n      (accountIdEnvVar ? process.env[accountIdEnvVar] : undefined) ||\n      process.env.CLOUDFLARE_ACCOUNT_ID;\n\n    if (!accountId) {\n      throw new Error(\n        `Cloudflare Account ID not found. Please provide it via:\\n` +\n          `1. Configuring 'deploy.frontend.options.accountIdEnvVar' in nexical.yaml and setting that env var in .env\\n` +\n          `2. Setting CLOUDFLARE_ACCOUNT_ID in .env`,\n      );\n    }\n    secrets['CLOUDFLARE_ACCOUNT_ID'] = accountId;\n\n    return secrets;\n  }\n\n  async getVariables(context: DeploymentContext): Promise<Record<string, string>> {\n    const projectName = context.config.deploy?.frontend?.projectName;\n\n    if (!projectName) {\n      throw new Error(\n        \"Cloudflare project name not found in nexical.yaml. Please configure 'deploy.frontend.projectName'.\",\n      );\n    }\n    return {\n      CLOUDFLARE_PROJECT_NAME: projectName,\n    };\n  }\n\n  getCIConfig(): CIConfig {\n    return {\n      secrets: ['CLOUDFLARE_API_TOKEN', 'CLOUDFLARE_ACCOUNT_ID'],\n      variables: ['CLOUDFLARE_PROJECT_NAME'],\n      deploySteps: [], // Handled by action\n      githubActionStep: {\n        name: 'Deploy to Cloudflare Pages',\n        uses: 'cloudflare/wrangler-action@v3',\n        with: {\n          apiToken: '${{ secrets.CLOUDFLARE_API_TOKEN }}',\n          accountId: '${{ secrets.CLOUDFLARE_ACCOUNT_ID }}',\n          command: 'pages deploy dist --project-name=${{ vars.CLOUDFLARE_PROJECT_NAME }}',\n          workingDirectory: 'apps/frontend',\n        },\n      },\n    };\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/deploy/providers/cloudflare.ts"],"sourcesContent":["import { logger } from '@nexical/cli-core';\nimport { DeploymentProvider, DeploymentContext, CIConfig } from '../types';\nimport { execAsync } from '../utils';\n\nexport class CloudflareProvider implements DeploymentProvider {\n  name = 'cloudflare';\n  type = 'frontend' as const;\n\n  async provision(context: DeploymentContext): Promise<void> {\n    const env = (context.options.env as string) || 'production';\n    const baseProjectName = context.config.deploy?.frontend?.projectName;\n\n    if (!baseProjectName) {\n      throw new Error(\n        \"Cloudflare project name not found in nexical.yaml. Please configure 'deploy.frontend.projectName'.\",\n      );\n    }\n\n    const projectName = env === 'production' ? baseProjectName : `${baseProjectName}-${env}`;\n\n    const options = context.config.deploy?.frontend?.options || {};\n\n    // Resolve credentials:\n    // 1. CLI flag (options)\n    // 2. Env var defined in config (options.apiTokenEnvVar)\n    // 3. Default env var (CLOUDFLARE_API_TOKEN)\n    const apiTokenEnvVar =\n      typeof options.apiTokenEnvVar === 'string' ? options.apiTokenEnvVar : undefined;\n    const apiToken =\n      (typeof context.options.cloudflareToken === 'string'\n        ? context.options.cloudflareToken\n        : undefined) ||\n      (apiTokenEnvVar ? process.env[apiTokenEnvVar] : undefined) ||\n      process.env.CLOUDFLARE_API_TOKEN;\n\n    const accountIdEnvVar =\n      typeof options.accountIdEnvVar === 'string' ? options.accountIdEnvVar : undefined;\n    const accountId =\n      (typeof context.options.cloudflareAccount === 'string'\n        ? context.options.cloudflareAccount\n        : undefined) ||\n      (accountIdEnvVar ? process.env[accountIdEnvVar] : undefined) ||\n      process.env.CLOUDFLARE_ACCOUNT_ID;\n\n    logger.info('Configuring Cloudflare Pages...');\n\n    if (context.options.dryRun) {\n      logger.info(\n        `[Dry Run] Would check Cloudflare Pages project \"${projectName}\" and create if missing.`,\n      );\n      return;\n    }\n\n    if (!apiToken || !accountId) {\n      logger.warn('Cloudflare credentials missing. Skipping automated Cloudflare setup.');\n      logger.info('You can manually set up Cloudflare Pages and add the secrets to GitHub.');\n      return;\n    }\n\n    try {\n      logger.info(`Ensuring Cloudflare Pages project \"${projectName}\" exists...`);\n      try {\n        await execAsync(`wrangler pages project create ${projectName} --production-branch main`, {\n          env: {\n            ...process.env,\n            CLOUDFLARE_API_TOKEN: apiToken,\n            CLOUDFLARE_ACCOUNT_ID: accountId,\n          },\n        });\n      } catch {\n        logger.info('Cloudflare project might already exist.');\n      }\n    } catch (e: unknown) {\n      logger.warn('Cloudflare setup failed.');\n      throw e;\n    }\n  }\n\n  async getSecrets(context: DeploymentContext): Promise<Record<string, string>> {\n    const options = context.config.deploy?.frontend?.options || {};\n    const secrets: Record<string, string> = {};\n\n    // Resolve API Token\n    const apiTokenEnvVar =\n      typeof options.apiTokenEnvVar === 'string' ? options.apiTokenEnvVar : undefined;\n    const apiToken =\n      (apiTokenEnvVar ? process.env[apiTokenEnvVar] : undefined) ||\n      process.env.CLOUDFLARE_API_TOKEN;\n\n    if (!apiToken) {\n      throw new Error(\n        `Cloudflare API Token not found. Please provide it via:\\n` +\n          `1. Configuring 'deploy.frontend.options.apiTokenEnvVar' in nexical.yaml and setting that env var in .env\\n` +\n          `2. Setting CLOUDFLARE_API_TOKEN in .env`,\n      );\n    }\n    secrets['CLOUDFLARE_API_TOKEN'] = apiToken;\n\n    // Resolve Account ID\n    const accountIdEnvVar =\n      typeof options.accountIdEnvVar === 'string' ? options.accountIdEnvVar : undefined;\n    const accountId =\n      (accountIdEnvVar ? process.env[accountIdEnvVar] : undefined) ||\n      process.env.CLOUDFLARE_ACCOUNT_ID;\n\n    if (!accountId) {\n      throw new Error(\n        `Cloudflare Account ID not found. Please provide it via:\\n` +\n          `1. Configuring 'deploy.frontend.options.accountIdEnvVar' in nexical.yaml and setting that env var in .env\\n` +\n          `2. Setting CLOUDFLARE_ACCOUNT_ID in .env`,\n      );\n    }\n    secrets['CLOUDFLARE_ACCOUNT_ID'] = accountId;\n\n    return secrets;\n  }\n\n  async getVariables(context: DeploymentContext): Promise<Record<string, string>> {\n    const env = (context.options.env as string) || 'production';\n    const baseProjectName = context.config.deploy?.frontend?.projectName;\n\n    if (!baseProjectName) {\n      throw new Error(\n        \"Cloudflare project name not found in nexical.yaml. Please configure 'deploy.frontend.projectName'.\",\n      );\n    }\n\n    const projectName = env === 'production' ? baseProjectName : `${baseProjectName}-${env}`;\n    return {\n      CLOUDFLARE_PROJECT_NAME: projectName,\n    };\n  }\n\n  getCIConfig(): CIConfig {\n    return {\n      secrets: ['CLOUDFLARE_API_TOKEN', 'CLOUDFLARE_ACCOUNT_ID'],\n      variables: ['CLOUDFLARE_PROJECT_NAME'],\n      deploySteps: [], // Handled by action\n      githubActionStep: {\n        name: 'Deploy to Cloudflare Pages',\n        uses: 'cloudflare/wrangler-action@v3',\n        with: {\n          apiToken: '${{ secrets.CLOUDFLARE_API_TOKEN }}',\n          accountId: '${{ secrets.CLOUDFLARE_ACCOUNT_ID }}',\n          command: 'pages deploy dist --project-name=${{ vars.CLOUDFLARE_PROJECT_NAME }}',\n          workingDirectory: 'apps/frontend',\n        },\n      },\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/src/deploy/providers/railway.d.ts

@@ -4,6 +4,7 @@ declare class RailwayProvider implements DeploymentProvider {
     name: string;
     type: "backend";
     provision(context: DeploymentContext): Promise<void>;
+    private resolveToken;
     getSecrets(context: DeploymentContext): Promise<Record<string, string>>;
     getVariables(context: DeploymentContext): Promise<Record<string, string>>;
     getCIConfig(): CIConfig;

package/dist/src/deploy/providers/railway.js

@@ -15,71 +15,98 @@ var RailwayProvider = class {
   type = "backend";
   async provision(context) {
     const backendDir = path.join(context.cwd, "apps/backend");
-    const railwayName = context.config.deploy?.backend?.projectName;
-    if (!railwayName) {
+    const env = context.options.env || "production";
+    const baseProjectName = context.config.deploy?.backend?.projectName;
+    if (!baseProjectName) {
       throw new Error(
         "Railway project name not found in nexical.yaml. Please configure 'deploy.backend.projectName'."
       );
     }
-    const serviceName = railwayName || "nexical-backend";
+    const railwayName = env === "production" ? baseProjectName : `${baseProjectName}-${env}`;
     logger.info("Configuring Railway...");
     if (context.options.dryRun) {
-      logger.info("[Dry Run] Would check Railway status and init project.");
+      logger.info(`[Dry Run] Would check Railway status and init project "${railwayName}".`);
       return;
     }
     try {
+      const env2 = { ...process.env };
+      delete env2.RAILWAY_API_TOKEN;
+      delete env2.RAILWAY_TOKEN;
+      logger.info("Using local Railway CLI credentials (environment variables stripped).");
       try {
-        await execAsync("railway status", { cwd: backendDir });
-      } catch {
-        const initCmd = railwayName ? `railway init --name ${railwayName}` : "railway init";
-        logger.info(`No Railway project detected in apps/backend. Initializing with: ${initCmd}`);
-        await execAsync(initCmd, { cwd: backendDir });
+        await execAsync("railway status", { cwd: backendDir, env: env2 });
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : String(error);
+        const stderr = error.stderr || "";
+        const stdout = error.stdout || "";
+        const fullError = `${errMsg} ${stderr} ${stdout}`;
+        if (fullError.includes("Project not found") || fullError.includes("No project") || fullError.includes("Project is deleted")) {
+          if (fullError.includes("Project is deleted")) {
+            logger.info("[Railway] Project is deleted. Unlinking...");
+            await execAsync("railway unlink", { cwd: backendDir }).catch(() => {
+            });
+          }
+          const initCmd = `railway init --name ${railwayName}`;
+          logger.info(`No active Railway project linked. Initializing with: ${initCmd}`);
+          await execAsync(initCmd, { cwd: backendDir, env: env2 });
+        } else if (fullError.includes("Invalid RAILWAY_API_TOKEN") || fullError.includes("Unauthorized")) {
+          throw new Error("Railway authentication failed during status check.");
+        } else {
+          logger.warn(`Railway status check failed: ${errMsg}. Proceeding.`);
+        }
       }
-      logger.info(`Adding PostgreSQL service if missing for "${serviceName}"...`);
-      const { stdout: status } = await execAsync("railway status", { cwd: backendDir });
+      logger.info(`Adding PostgreSQL service if missing for "${railwayName}"...`);
+      const { stdout: status } = await execAsync("railway status", { cwd: backendDir, env: env2 }).catch(
+        () => ({ stdout: "" })
+      );
       if (!status.includes("postgres")) {
-        await execAsync("railway add --database postgres", { cwd: backendDir });
+        try {
+          await execAsync("railway add --database postgres", { cwd: backendDir, env: env2 });
+        } catch {
+          logger.warn("Failed to auto-add PostgreSQL.");
+        }
       }
     } catch (e) {
+      const errMsg = e instanceof Error ? e.message : String(e);
+      const stderr = e.stderr || "";
+      const stdout = e.stdout || "";
+      if (errMsg.includes("Railway authentication failed")) throw e;
+      logger.error(`Railway setup failed with error: ${errMsg}`);
+      if (stderr) logger.error(`[Railway stderr]: ${stderr}`);
+      if (stdout) logger.info(`[Railway stdout]: ${stdout}`);
       logger.warn(
-        "Railway setup encountered an issue. Ensure you are logged in with `railway login`."
+        "Railway setup encountered an issue. Ensure you are logged in or have a valid token."
       );
-      throw e;
     }
   }
-  async getSecrets(context) {
+  resolveToken(context) {
     const options = context.config.deploy?.backend?.options || {};
-    const secrets = {};
     const tokenEnvVar = typeof options.tokenEnvVar === "string" ? options.tokenEnvVar : void 0;
-    const token = (tokenEnvVar ? process.env[tokenEnvVar] : void 0) || process.env.RAILWAY_TOKEN;
+    return process.env.RAILWAY_API_TOKEN?.trim() || (tokenEnvVar ? process.env[tokenEnvVar]?.trim() : void 0) || process.env.RAILWAY_TOKEN?.trim();
+  }
+  async getSecrets(context) {
+    const token = this.resolveToken(context);
+    const secrets = {};
     if (!token) {
       throw new Error(
         `Railway Token not found. Please provide it via:
-1. Configuring 'deploy.backend.options.tokenEnvVar' in nexical.yaml and setting that env var in .env
-2. Setting RAILWAY_TOKEN in .env`
+1. Setting RAILWAY_API_TOKEN in .env (Recommended)
+2. Configuring 'deploy.backend.options.tokenEnvVar' in nexical.yaml
+3. Setting RAILWAY_TOKEN in .env`
       );
     }
-    secrets["RAILWAY_TOKEN"] = token;
+    secrets["RAILWAY_API_TOKEN"] = token;
     return secrets;
   }
   async getVariables(context) {
-    const railwayName = context.config.deploy?.backend?.projectName;
-    if (!railwayName) {
-      throw new Error(
-        "Railway project name not found in nexical.yaml. Please configure 'deploy.backend.projectName'."
-      );
-    }
-    const serviceName = railwayName || "nexical-backend";
-    return {
-      RAILWAY_SERVICE_NAME: serviceName
-    };
+    return {};
   }
   getCIConfig() {
     return {
-      secrets: ["RAILWAY_TOKEN"],
-      variables: ["RAILWAY_SERVICE_NAME"],
+      secrets: ["RAILWAY_API_TOKEN"],
+      variables: [],
       installSteps: ["npm install -g @railway/cli"],
-      deploySteps: ["railway up --service ${{ vars.RAILWAY_SERVICE_NAME }} --detach"]
+      deploySteps: ["railway up --detach"]
     };
   }
 };

package/dist/src/deploy/providers/railway.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/deploy/providers/railway.ts"],"sourcesContent":["import path from 'node:path';\nimport { logger } from '@nexical/cli-core';\nimport { DeploymentProvider, DeploymentContext, CIConfig } from '../types';\nimport { execAsync } from '../utils';\n\nexport class RailwayProvider implements DeploymentProvider {\n  name = 'railway';\n  type = 'backend' as const;\n\n  async provision(context: DeploymentContext): Promise<void> {\n    const backendDir = path.join(context.cwd, 'apps/backend');\n    // Resolve project name/token\n    const railwayName = context.config.deploy?.backend?.projectName;\n\n    if (!railwayName) {\n      throw new Error(\n        \"Railway project name not found in nexical.yaml. Please configure 'deploy.backend.projectName'.\",\n      );\n    }\n\n    // Service name defaults to project name for the primary backend\n    const serviceName = railwayName || 'nexical-backend';\n    // Note: Token is usually handled by `railway login` for CLI, but for CI we need it.\n    // The provider might not need to know the token for `provision` if we rely on CLI auth.\n    // However, we might need to export it for GitHub secrets.\n\n    logger.info('Configuring Railway...');\n\n    if (context.options.dryRun) {\n      logger.info('[Dry Run] Would check Railway status and init project.');\n      return;\n    }\n\n    try {\n      try {\n        await execAsync('railway status', { cwd: backendDir });\n      } catch {\n        const initCmd = railwayName ? `railway init --name ${railwayName}` : 'railway init';\n        logger.info(`No Railway project detected in apps/backend. Initializing with: ${initCmd}`);\n        await execAsync(initCmd, { cwd: backendDir });\n      }\n\n      logger.info(`Adding PostgreSQL service if missing for \"${serviceName}\"...`);\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      logger.warn(\n        'Railway setup encountered an issue. Ensure you are logged in with `railway login`.',\n      );\n      throw e;\n    }\n  }\n\n  async getSecrets(context: DeploymentContext): Promise<Record<string, string>> {\n    const options = context.config.deploy?.backend?.options || {};\n    const secrets: Record<string, string> = {};\n\n    // Resolve Railway Token\n    // Priority: Configured Env Var > Default Env Var\n    const tokenEnvVar = typeof options.tokenEnvVar === 'string' ? options.tokenEnvVar : undefined;\n    const token = (tokenEnvVar ? process.env[tokenEnvVar] : undefined) || process.env.RAILWAY_TOKEN;\n\n    if (!token) {\n      // Strict check: Error if token is missing\n      throw new Error(\n        `Railway Token not found. Please provide it via:\\n` +\n          `1. Configuring 'deploy.backend.options.tokenEnvVar' in nexical.yaml and setting that env var in .env\\n` +\n          `2. Setting RAILWAY_TOKEN in .env`,\n      );\n    }\n\n    secrets['RAILWAY_TOKEN'] = token;\n    return secrets;\n  }\n\n  async getVariables(context: DeploymentContext): Promise<Record<string, string>> {\n    const railwayName = context.config.deploy?.backend?.projectName;\n\n    if (!railwayName) {\n      throw new Error(\n        \"Railway project name not found in nexical.yaml. Please configure 'deploy.backend.projectName'.\",\n      );\n    }\n\n    // Service name defaults to project name\n    const serviceName = railwayName || 'nexical-backend';\n\n    return {\n      RAILWAY_SERVICE_NAME: serviceName,\n    };\n  }\n\n  getCIConfig(): CIConfig {\n    return {\n      secrets: ['RAILWAY_TOKEN'],\n      variables: ['RAILWAY_SERVICE_NAME'],\n      installSteps: ['npm install -g @railway/cli'],\n      deploySteps: ['railway up --service ${{ vars.RAILWAY_SERVICE_NAME }} --detach'],\n    };\n  }\n}\n"],"mappings":";;;;;;;;;AAAA;AAAA,OAAO,UAAU;AACjB,SAAS,cAAc;AAIhB,IAAM,kBAAN,MAAoD;AAAA,EACzD,OAAO;AAAA,EACP,OAAO;AAAA,EAEP,MAAM,UAAU,SAA2C;AACzD,UAAM,aAAa,KAAK,KAAK,QAAQ,KAAK,cAAc;AAExD,UAAM,cAAc,QAAQ,OAAO,QAAQ,SAAS;AAEpD,QAAI,CAAC,aAAa;AAChB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAGA,UAAM,cAAc,eAAe;AAKnC,WAAO,KAAK,wBAAwB;AAEpC,QAAI,QAAQ,QAAQ,QAAQ;AAC1B,aAAO,KAAK,wDAAwD;AACpE;AAAA,IACF;AAEA,QAAI;AACF,UAAI;AACF,cAAM,UAAU,kBAAkB,EAAE,KAAK,WAAW,CAAC;AAAA,MACvD,QAAQ;AACN,cAAM,UAAU,cAAc,uBAAuB,WAAW,KAAK;AACrE,eAAO,KAAK,mEAAmE,OAAO,EAAE;AACxF,cAAM,UAAU,SAAS,EAAE,KAAK,WAAW,CAAC;AAAA,MAC9C;AAEA,aAAO,KAAK,6CAA6C,WAAW,MAAM;AAC1E,YAAM,EAAE,QAAQ,OAAO,IAAI,MAAM,UAAU,kBAAkB,EAAE,KAAK,WAAW,CAAC;AAChF,UAAI,CAAC,OAAO,SAAS,UAAU,GAAG;AAChC,cAAM,UAAU,mCAAmC,EAAE,KAAK,WAAW,CAAC;AAAA,MACxE;AAAA,IACF,SAAS,GAAY;AACnB,aAAO;AAAA,QACL;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAM,WAAW,SAA6D;AAC5E,UAAM,UAAU,QAAQ,OAAO,QAAQ,SAAS,WAAW,CAAC;AAC5D,UAAM,UAAkC,CAAC;AAIzC,UAAM,cAAc,OAAO,QAAQ,gBAAgB,WAAW,QAAQ,cAAc;AACpF,UAAM,SAAS,cAAc,QAAQ,IAAI,WAAW,IAAI,WAAc,QAAQ,IAAI;AAElF,QAAI,CAAC,OAAO;AAEV,YAAM,IAAI;AAAA,QACR;AAAA;AAAA;AAAA,MAGF;AAAA,IACF;AAEA,YAAQ,eAAe,IAAI;AAC3B,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,aAAa,SAA6D;AAC9E,UAAM,cAAc,QAAQ,OAAO,QAAQ,SAAS;AAEpD,QAAI,CAAC,aAAa;AAChB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAGA,UAAM,cAAc,eAAe;AAEnC,WAAO;AAAA,MACL,sBAAsB;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,cAAwB;AACtB,WAAO;AAAA,MACL,SAAS,CAAC,eAAe;AAAA,MACzB,WAAW,CAAC,sBAAsB;AAAA,MAClC,cAAc,CAAC,6BAA6B;AAAA,MAC5C,aAAa,CAAC,gEAAgE;AAAA,IAChF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/deploy/providers/railway.ts"],"sourcesContent":["import path from 'node:path';\nimport { logger } from '@nexical/cli-core';\nimport { DeploymentProvider, DeploymentContext, CIConfig } from '../types';\nimport { execAsync } from '../utils';\n\nexport class RailwayProvider implements DeploymentProvider {\n  name = 'railway';\n  type = 'backend' as const;\n\n  async provision(context: DeploymentContext): Promise<void> {\n    const backendDir = path.join(context.cwd, 'apps/backend');\n    const env = (context.options.env as string) || 'production';\n    const baseProjectName = context.config.deploy?.backend?.projectName;\n\n    if (!baseProjectName) {\n      throw new Error(\n        \"Railway project name not found in nexical.yaml. Please configure 'deploy.backend.projectName'.\",\n      );\n    }\n\n    const railwayName = env === 'production' ? baseProjectName : `${baseProjectName}-${env}`;\n\n    logger.info('Configuring Railway...');\n\n    if (context.options.dryRun) {\n      logger.info(`[Dry Run] Would check Railway status and init project \"${railwayName}\".`);\n      return;\n    }\n\n    try {\n      // We consciously DO NOT pass any RAILWAY_API_TOKEN to the subprocess.\n      // The user may have an invalid token in their .env file (which process.env inherits).\n      // We want to force the Railway CLI to use the locally logged-in user's credentials.\n      const env = { ...process.env };\n      delete env.RAILWAY_API_TOKEN;\n      delete env.RAILWAY_TOKEN;\n\n      logger.info('Using local Railway CLI credentials (environment variables stripped).');\n\n      // Check status to see if we are linked to a project\n      try {\n        await execAsync('railway status', { cwd: backendDir, env });\n      } catch (error: unknown) {\n        const errMsg = error instanceof Error ? error.message : String(error);\n        const stderr = (error as { stderr?: string }).stderr || '';\n        const stdout = (error as { stdout?: string }).stdout || '';\n        const fullError = `${errMsg} ${stderr} ${stdout}`;\n\n        // If status fails, likely project doesn't exist locally or we aren't linked.\n        if (\n          fullError.includes('Project not found') ||\n          fullError.includes('No project') ||\n          fullError.includes('Project is deleted')\n        ) {\n          if (fullError.includes('Project is deleted')) {\n            logger.info('[Railway] Project is deleted. Unlinking...');\n            // If it's deleted, we might need to unlink first to clean up local config\n            await execAsync('railway unlink', { cwd: backendDir }).catch(() => {});\n          }\n          const initCmd = `railway init --name ${railwayName}`;\n          logger.info(`No active Railway project linked. Initializing with: ${initCmd}`);\n          await execAsync(initCmd, { cwd: backendDir, env });\n        } else if (\n          fullError.includes('Invalid RAILWAY_API_TOKEN') ||\n          fullError.includes('Unauthorized')\n        ) {\n          throw new Error('Railway authentication failed during status check.');\n        } else {\n          // Some other error (e.g. timeout), warn and try to proceed\n          logger.warn(`Railway status check failed: ${errMsg}. Proceeding.`);\n        }\n      }\n\n      logger.info(`Adding PostgreSQL service if missing for \"${railwayName}\"...`);\n      const { stdout: status } = await execAsync('railway status', { cwd: backendDir, env }).catch(\n        () => ({ stdout: '' }),\n      );\n      if (!status.includes('postgres')) {\n        try {\n          await execAsync('railway add --database postgres', { cwd: backendDir, env });\n        } catch {\n          logger.warn('Failed to auto-add PostgreSQL.');\n        }\n      }\n    } catch (e: unknown) {\n      // Rethrow explicit auth errors, otherwise warn\n      const errMsg = e instanceof Error ? e.message : String(e);\n\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const stderr = (e as any).stderr || '';\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const stdout = (e as any).stdout || '';\n\n      if (errMsg.includes('Railway authentication failed')) throw e;\n\n      logger.error(`Railway setup failed with error: ${errMsg}`);\n      if (stderr) logger.error(`[Railway stderr]: ${stderr}`);\n      if (stdout) logger.info(`[Railway stdout]: ${stdout}`);\n\n      logger.warn(\n        'Railway setup encountered an issue. Ensure you are logged in or have a valid token.',\n      );\n    }\n  }\n\n  private resolveToken(context: DeploymentContext): string | undefined {\n    const options = context.config.deploy?.backend?.options || {};\n    const tokenEnvVar = typeof options.tokenEnvVar === 'string' ? options.tokenEnvVar : undefined;\n    return (\n      process.env.RAILWAY_API_TOKEN?.trim() ||\n      (tokenEnvVar ? process.env[tokenEnvVar]?.trim() : undefined) ||\n      process.env.RAILWAY_TOKEN?.trim()\n    );\n  }\n\n  async getSecrets(context: DeploymentContext): Promise<Record<string, string>> {\n    const token = this.resolveToken(context);\n    const secrets: Record<string, string> = {};\n\n    if (!token) {\n      // Strict check: Error if token is missing\n      throw new Error(\n        `Railway Token not found. Please provide it via:\\n` +\n          `1. Setting RAILWAY_API_TOKEN in .env (Recommended)\\n` +\n          `2. Configuring 'deploy.backend.options.tokenEnvVar' in nexical.yaml\\n` +\n          `3. Setting RAILWAY_TOKEN in .env`,\n      );\n    }\n\n    secrets['RAILWAY_API_TOKEN'] = token;\n    return secrets;\n  }\n\n  async getVariables(context: DeploymentContext): Promise<Record<string, string>> {\n    return {};\n  }\n\n  getCIConfig(): CIConfig {\n    return {\n      secrets: ['RAILWAY_API_TOKEN'],\n      variables: [],\n      installSteps: ['npm install -g @railway/cli'],\n      deploySteps: ['railway up --detach'],\n    };\n  }\n}\n"],"mappings":"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","names":["env"]}

package/package.json

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

package/src/commands/deploy.ts

@@ -43,6 +43,11 @@ PROCESS:
         name: '--repo <provider>',
         description: 'Override repositroy provider',
       },
+      {
+        name: '--env <environment>',
+        description: 'Deployment environment (e.g. production, staging)',
+        default: 'production',
+      },
       {
         name: '--dry-run',
         description: 'Simulate the deployment process',

package/src/deploy/providers/cloudflare.ts

@@ -7,14 +7,17 @@ export class CloudflareProvider implements DeploymentProvider {
   type = 'frontend' as const;
 
   async provision(context: DeploymentContext): Promise<void> {
-    const projectName = context.config.deploy?.frontend?.projectName;
+    const env = (context.options.env as string) || 'production';
+    const baseProjectName = context.config.deploy?.frontend?.projectName;
 
-    if (!projectName) {
+    if (!baseProjectName) {
       throw new Error(
         "Cloudflare project name not found in nexical.yaml. Please configure 'deploy.frontend.projectName'.",
       );
     }
 
+    const projectName = env === 'production' ? baseProjectName : `${baseProjectName}-${env}`;
+
     const options = context.config.deploy?.frontend?.options || {};
 
     // Resolve credentials:
@@ -42,7 +45,9 @@ export class CloudflareProvider implements DeploymentProvider {
     logger.info('Configuring Cloudflare Pages...');
 
     if (context.options.dryRun) {
-      logger.info('[Dry Run] Would check Cloudflare Pages project and create if missing.');
+      logger.info(
+        `[Dry Run] Would check Cloudflare Pages project "${projectName}" and create if missing.`,
+      );
       return;
     }
 
@@ -111,13 +116,16 @@ export class CloudflareProvider implements DeploymentProvider {
   }
 
   async getVariables(context: DeploymentContext): Promise<Record<string, string>> {
-    const projectName = context.config.deploy?.frontend?.projectName;
+    const env = (context.options.env as string) || 'production';
+    const baseProjectName = context.config.deploy?.frontend?.projectName;
 
-    if (!projectName) {
+    if (!baseProjectName) {
       throw new Error(
         "Cloudflare project name not found in nexical.yaml. Please configure 'deploy.frontend.projectName'.",
       );
     }
+
+    const projectName = env === 'production' ? baseProjectName : `${baseProjectName}-${env}`;
     return {
       CLOUDFLARE_PROJECT_NAME: projectName,
     };

package/src/deploy/providers/railway.ts

@@ -9,95 +9,138 @@ export class RailwayProvider implements DeploymentProvider {
 
   async provision(context: DeploymentContext): Promise<void> {
     const backendDir = path.join(context.cwd, 'apps/backend');
-    // Resolve project name/token
-    const railwayName = context.config.deploy?.backend?.projectName;
+    const env = (context.options.env as string) || 'production';
+    const baseProjectName = context.config.deploy?.backend?.projectName;
 
-    if (!railwayName) {
+    if (!baseProjectName) {
       throw new Error(
         "Railway project name not found in nexical.yaml. Please configure 'deploy.backend.projectName'.",
       );
     }
 
-    // Service name defaults to project name for the primary backend
-    const serviceName = railwayName || 'nexical-backend';
-    // Note: Token is usually handled by `railway login` for CLI, but for CI we need it.
-    // The provider might not need to know the token for `provision` if we rely on CLI auth.
-    // However, we might need to export it for GitHub secrets.
+    const railwayName = env === 'production' ? baseProjectName : `${baseProjectName}-${env}`;
 
     logger.info('Configuring Railway...');
 
     if (context.options.dryRun) {
-      logger.info('[Dry Run] Would check Railway status and init project.');
+      logger.info(`[Dry Run] Would check Railway status and init project "${railwayName}".`);
       return;
     }
 
     try {
+      // We consciously DO NOT pass any RAILWAY_API_TOKEN to the subprocess.
+      // The user may have an invalid token in their .env file (which process.env inherits).
+      // We want to force the Railway CLI to use the locally logged-in user's credentials.
+      const env = { ...process.env };
+      delete env.RAILWAY_API_TOKEN;
+      delete env.RAILWAY_TOKEN;
+
+      logger.info('Using local Railway CLI credentials (environment variables stripped).');
+
+      // Check status to see if we are linked to a project
       try {
-        await execAsync('railway status', { cwd: backendDir });
-      } catch {
-        const initCmd = railwayName ? `railway init --name ${railwayName}` : 'railway init';
-        logger.info(`No Railway project detected in apps/backend. Initializing with: ${initCmd}`);
-        await execAsync(initCmd, { cwd: backendDir });
+        await execAsync('railway status', { cwd: backendDir, env });
+      } catch (error: unknown) {
+        const errMsg = error instanceof Error ? error.message : String(error);
+        const stderr = (error as { stderr?: string }).stderr || '';
+        const stdout = (error as { stdout?: string }).stdout || '';
+        const fullError = `${errMsg} ${stderr} ${stdout}`;
+
+        // If status fails, likely project doesn't exist locally or we aren't linked.
+        if (
+          fullError.includes('Project not found') ||
+          fullError.includes('No project') ||
+          fullError.includes('Project is deleted')
+        ) {
+          if (fullError.includes('Project is deleted')) {
+            logger.info('[Railway] Project is deleted. Unlinking...');
+            // If it's deleted, we might need to unlink first to clean up local config
+            await execAsync('railway unlink', { cwd: backendDir }).catch(() => {});
+          }
+          const initCmd = `railway init --name ${railwayName}`;
+          logger.info(`No active Railway project linked. Initializing with: ${initCmd}`);
+          await execAsync(initCmd, { cwd: backendDir, env });
+        } else if (
+          fullError.includes('Invalid RAILWAY_API_TOKEN') ||
+          fullError.includes('Unauthorized')
+        ) {
+          throw new Error('Railway authentication failed during status check.');
+        } else {
+          // Some other error (e.g. timeout), warn and try to proceed
+          logger.warn(`Railway status check failed: ${errMsg}. Proceeding.`);
+        }
       }
 
-      logger.info(`Adding PostgreSQL service if missing for "${serviceName}"...`);
-      const { stdout: status } = await execAsync('railway status', { cwd: backendDir });
+      logger.info(`Adding PostgreSQL service if missing for "${railwayName}"...`);
+      const { stdout: status } = await execAsync('railway status', { cwd: backendDir, env }).catch(
+        () => ({ stdout: '' }),
+      );
       if (!status.includes('postgres')) {
-        await execAsync('railway add --database postgres', { cwd: backendDir });
+        try {
+          await execAsync('railway add --database postgres', { cwd: backendDir, env });
+        } catch {
+          logger.warn('Failed to auto-add PostgreSQL.');
+        }
       }
     } catch (e: unknown) {
+      // Rethrow explicit auth errors, otherwise warn
+      const errMsg = e instanceof Error ? e.message : String(e);
+
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const stderr = (e as any).stderr || '';
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const stdout = (e as any).stdout || '';
+
+      if (errMsg.includes('Railway authentication failed')) throw e;
+
+      logger.error(`Railway setup failed with error: ${errMsg}`);
+      if (stderr) logger.error(`[Railway stderr]: ${stderr}`);
+      if (stdout) logger.info(`[Railway stdout]: ${stdout}`);
+
       logger.warn(
-        'Railway setup encountered an issue. Ensure you are logged in with `railway login`.',
+        'Railway setup encountered an issue. Ensure you are logged in or have a valid token.',
       );
-      throw e;
     }
   }
 
-  async getSecrets(context: DeploymentContext): Promise<Record<string, string>> {
+  private resolveToken(context: DeploymentContext): string | undefined {
     const options = context.config.deploy?.backend?.options || {};
-    const secrets: Record<string, string> = {};
-
-    // Resolve Railway Token
-    // Priority: Configured Env Var > Default Env Var
     const tokenEnvVar = typeof options.tokenEnvVar === 'string' ? options.tokenEnvVar : undefined;
-    const token = (tokenEnvVar ? process.env[tokenEnvVar] : undefined) || process.env.RAILWAY_TOKEN;
+    return (
+      process.env.RAILWAY_API_TOKEN?.trim() ||
+      (tokenEnvVar ? process.env[tokenEnvVar]?.trim() : undefined) ||
+      process.env.RAILWAY_TOKEN?.trim()
+    );
+  }
+
+  async getSecrets(context: DeploymentContext): Promise<Record<string, string>> {
+    const token = this.resolveToken(context);
+    const secrets: Record<string, string> = {};
 
     if (!token) {
       // Strict check: Error if token is missing
       throw new Error(
         `Railway Token not found. Please provide it via:\n` +
-          `1. Configuring 'deploy.backend.options.tokenEnvVar' in nexical.yaml and setting that env var in .env\n` +
-          `2. Setting RAILWAY_TOKEN in .env`,
+          `1. Setting RAILWAY_API_TOKEN in .env (Recommended)\n` +
+          `2. Configuring 'deploy.backend.options.tokenEnvVar' in nexical.yaml\n` +
+          `3. Setting RAILWAY_TOKEN in .env`,
       );
     }
 
-    secrets['RAILWAY_TOKEN'] = token;
+    secrets['RAILWAY_API_TOKEN'] = token;
     return secrets;
   }
 
   async getVariables(context: DeploymentContext): Promise<Record<string, string>> {
-    const railwayName = context.config.deploy?.backend?.projectName;
-
-    if (!railwayName) {
-      throw new Error(
-        "Railway project name not found in nexical.yaml. Please configure 'deploy.backend.projectName'.",
-      );
-    }
-
-    // Service name defaults to project name
-    const serviceName = railwayName || 'nexical-backend';
-
-    return {
-      RAILWAY_SERVICE_NAME: serviceName,
-    };
+    return {};
   }
 
   getCIConfig(): CIConfig {
     return {
-      secrets: ['RAILWAY_TOKEN'],
-      variables: ['RAILWAY_SERVICE_NAME'],
+      secrets: ['RAILWAY_API_TOKEN'],
+      variables: [],
       installSteps: ['npm install -g @railway/cli'],
-      deploySteps: ['railway up --service ${{ vars.RAILWAY_SERVICE_NAME }} --detach'],
+      deploySteps: ['railway up --detach'],
     };
   }
 }