create-asaje-go-vue 0.3.9 → 0.3.10

package/README.md

@@ -124,6 +124,7 @@ npx -p create-asaje-go-vue@latest asaje print-railway-config ./my-app
 npx -p create-asaje-go-vue@latest asaje print-railway-config ./my-app --environment production
 npx -p create-asaje-go-vue@latest asaje print-railway-config ./my-app --environment production --json
 npx -p create-asaje-go-vue@latest asaje print-railway-config ./my-app --environment production --show-secrets
+npx -p create-asaje-go-vue@latest asaje print-railway-config ./my-app --write-config
 ```
 
 ### Export resolved Railway config snapshot
@@ -259,6 +260,8 @@ npx -p create-asaje-go-vue@latest asaje destroy-railway ./my-app --scope project
 - supports `--json` for machine-readable output
 - redacts secret-looking values in the printed output by default
 - supports `--show-secrets` when you explicitly want the raw values in the output
+- supports `--write-config` to write the resolved per-service variables back into `asaje.config.json` for later adjustment
+- when `--write-config` is used without `--show-secrets`, sensitive-looking variables are omitted from the file to avoid writing redacted placeholders
 
 ## What `asaje export-railway-config` does
 

package/bin/create-asaje-go-vue.js

@@ -43,6 +43,7 @@ import {
   buildCreateRailwayServices,
   buildSyncedRailwayManifest,
   findCreatedRailwayService,
+  findRailwayAppServiceSpec,
   findRailwayService,
   findRailwayServiceByKey,
   normalizeRailwayServiceName,
@@ -74,6 +75,7 @@ import {
 import { collectCreateAnswers } from "../src/create/questions.js";
 import { collectStartAnswers } from "../src/start/answers.js";
 import {
+  ENV_FILE_SPECS,
   ensureEnvFiles,
   installProjectDependencies,
   loadRuntimeConfig,
@@ -91,6 +93,7 @@ import {
   buildRailwayBrowserOrigins,
   buildRailwayVariableDiff,
   formatRailwayVariableValue,
+  isSensitiveRailwayVariableKey,
   sanitizeVariablesForOutput,
 } from "../src/railway/variables.js";
 import { resolveInvocation } from "../src/cli/invocation.js";
@@ -966,6 +969,13 @@ async function runPrintRailwayConfig(argv) {
     showSecrets: args.showSecrets,
   });
 
+  if (args.writeConfig) {
+    await writeResolvedRailwayConfigToProjectConfig(payload, {
+      quiet: args.json,
+      showSecrets: args.showSecrets,
+    });
+  }
+
   if (args.json) {
     console.log(JSON.stringify(payload, null, 2));
     return;
@@ -1238,6 +1248,7 @@ function parsePrintRailwayConfigArgs(argv) {
     environment: undefined,
     json: false,
     showSecrets: false,
+    writeConfig: false,
   };
   const positionals = [];
 
@@ -1254,6 +1265,11 @@ function parsePrintRailwayConfigArgs(argv) {
       continue;
     }
 
+    if (arg === "--write-config") {
+      options.writeConfig = true;
+      continue;
+    }
+
     if (arg === "--environment" || arg === "-e") {
       options.environment = argv[index + 1] || options.environment;
       index += 1;
@@ -1268,7 +1284,7 @@ function parsePrintRailwayConfigArgs(argv) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   return options;
 }
 
@@ -1314,7 +1330,7 @@ function parseExportRailwayConfigArgs(argv) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   return options;
 }
 
@@ -1372,7 +1388,7 @@ function parseImportRailwayConfigArgs(argv) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   if (!options.file) {
     throw new Error("import-railway-config requires --file <snapshot.json>.");
   }
@@ -1403,7 +1419,7 @@ function parseSyncProjectConfigArgs(argv) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   return options;
 }
 
@@ -1425,7 +1441,7 @@ function parseSyncGithubWorkflowArgs(argv) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   return options;
 }
 
@@ -1447,7 +1463,7 @@ function parseSyncReadmeArgs(argv) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   return options;
 }
 
@@ -1523,7 +1539,7 @@ function parseDiffRailwayConfigArgs(argv) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   if (!options.compareEnvironment && !options.compareFile) {
     throw new Error("diff-railway-config requires --compare-environment <name> or --compare-file <snapshot.json>.");
   }
@@ -2285,18 +2301,29 @@ async function resolveRailwayVariablePlan(config) {
     realtime: findRailwayServiceByKey(config.services, config.appServiceSpecs, config.manifest, "realtime"),
     worker: findRailwayServiceByKey(config.services, config.appServiceSpecs, config.manifest, "worker"),
   };
+  const managedAppServices = config.includeUnresolvedServices
+    ? {
+        admin: resolveManagedServiceReference(config.services, config.appServiceSpecs, config.manifest, "admin"),
+        api: resolveManagedServiceReference(config.services, config.appServiceSpecs, config.manifest, "api"),
+        landing: resolveManagedServiceReference(config.services, config.appServiceSpecs, config.manifest, "landing"),
+        pwa: resolveManagedServiceReference(config.services, config.appServiceSpecs, config.manifest, "pwa"),
+        realtime: resolveManagedServiceReference(config.services, config.appServiceSpecs, config.manifest, "realtime"),
+        worker: resolveManagedServiceReference(config.services, config.appServiceSpecs, config.manifest, "worker"),
+      }
+    : appServices;
 
   const serviceRegistry = {
-    admin: appServices.admin ? { name: appServices.admin.name, variables: {} } : null,
-    api: appServices.api ? { name: appServices.api.name, variables: {} } : null,
-    landing: appServices.landing ? { name: appServices.landing.name, variables: {} } : null,
+    admin: managedAppServices.admin ? { name: managedAppServices.admin.name, variables: {} } : null,
+    api: managedAppServices.api ? { name: managedAppServices.api.name, variables: {} } : null,
+    landing: managedAppServices.landing ? { name: managedAppServices.landing.name, variables: {} } : null,
     objectStorage: infra.objectStorage ? { name: infra.objectStorage.name, variables: {} } : null,
     postgres: infra.postgres ? { name: infra.postgres.name, variables: {} } : null,
-    pwa: appServices.pwa ? { name: appServices.pwa.name, variables: {} } : null,
+    pwa: managedAppServices.pwa ? { name: managedAppServices.pwa.name, variables: {} } : null,
     rabbitmq: infra.rabbitmq ? { name: infra.rabbitmq.name, variables: {} } : null,
-    realtime: appServices.realtime ? { name: appServices.realtime.name, variables: {} } : null,
-    worker: appServices.worker ? { name: appServices.worker.name, variables: {} } : null,
+    realtime: managedAppServices.realtime ? { name: managedAppServices.realtime.name, variables: {} } : null,
+    worker: managedAppServices.worker ? { name: managedAppServices.worker.name, variables: {} } : null,
   };
+  const browserOrigins = buildManagedBrowserOrigins(config.services, config.appServiceSpecs, config.manifest);
 
   for (const spec of config.appServiceSpecs) {
     const service = findRailwayServiceByKey(config.services, config.appServiceSpecs, config.manifest, spec.key);
@@ -2321,22 +2348,22 @@ async function resolveRailwayVariablePlan(config) {
   }
 
   const notices = [];
-  if (!appServices.api) {
+  if (!managedAppServices.api) {
     notices.push("api service not found, skipping API variable wiring");
   }
-  if (!appServices.realtime) {
+  if (!managedAppServices.realtime) {
     notices.push("realtime-gateway service not found, skipping realtime variable wiring");
   }
-  if (!appServices.admin) {
+  if (!managedAppServices.admin) {
     notices.push("admin service not found, skipping admin variable wiring");
   }
-  if (!appServices.worker) {
+  if (!managedAppServices.worker) {
     notices.push("worker service not found, skipping worker variable wiring");
   }
-  if (!appServices.landing) {
+  if (!managedAppServices.landing) {
     notices.push("landing service not found, skipping landing variable wiring");
   }
-  if (!appServices.pwa) {
+  if (!managedAppServices.pwa) {
     notices.push("pwa service not found, skipping pwa variable wiring");
   }
   if (!infra.postgres) {
@@ -2349,11 +2376,11 @@ async function resolveRailwayVariablePlan(config) {
     notices.push("object-storage resource not found, S3 variable wiring will be skipped");
   }
 
-  if (variablesMode !== "replace" && appServices.api) {
+  if (variablesMode !== "replace" && managedAppServices.api) {
     const existingApiVariables = await loadRailwayServiceVariables(
       config.projectDir,
       config.railwayContext.environmentRef,
-      appServices.api.name,
+      managedAppServices.api.name,
     );
     const variables = {};
     const sharedSecrets = buildRailwaySharedSecrets(localEnv, existingApiVariables);
@@ -2367,45 +2394,43 @@ async function resolveRailwayVariablePlan(config) {
     if (infra.objectStorage?.name) {
       Object.assign(variables, buildObjectStorageVariables(infra.objectStorage.name));
     }
-    const browserOrigins = buildRailwayBrowserOrigins(appServices);
     if (browserOrigins) {
       variables.CORS_ALLOWED_ORIGINS = browserOrigins;
     }
-    variables.PUBLIC_API_BASE_URL = `https://${railwayReference(appServices.api.name, "RAILWAY_PUBLIC_DOMAIN")}`;
+    variables.PUBLIC_API_BASE_URL = `https://${railwayReference(managedAppServices.api.name, "RAILWAY_PUBLIC_DOMAIN")}`;
     assignManagedRailwayServiceVariables(serviceRegistry.api, variables, variablesMode);
   }
 
-  if (variablesMode !== "replace" && appServices.realtime) {
+  if (variablesMode !== "replace" && managedAppServices.realtime) {
     const variables = {};
     Object.assign(variables, buildRealtimeDefaults(localEnv));
     if (infra.rabbitmq?.name) {
       variables.RABBITMQ_URL = buildRabbitMqUrlReference(infra.rabbitmq.name);
     }
-    if (appServices.api?.name) {
-      variables.JWT_SECRET = railwayReference(appServices.api.name, "JWT_SECRET");
+    if (managedAppServices.api?.name) {
+      variables.JWT_SECRET = railwayReference(managedAppServices.api.name, "JWT_SECRET");
     }
-    const browserOrigins = buildRailwayBrowserOrigins(appServices);
     if (browserOrigins) {
       variables.CORS_ALLOWED_ORIGINS = browserOrigins;
     }
     assignManagedRailwayServiceVariables(serviceRegistry.realtime, variables, variablesMode);
   }
 
-  if (variablesMode !== "replace" && appServices.admin) {
+  if (variablesMode !== "replace" && managedAppServices.admin) {
     const variables = {};
     Object.assign(variables, buildAdminDefaults(localEnv));
-    if (appServices.api?.name) {
-      variables.VITE_API_BASE_URL = `https://${railwayReference(appServices.api.name, "RAILWAY_PUBLIC_DOMAIN")}/api/v1`;
+    if (managedAppServices.api?.name) {
+      variables.VITE_API_BASE_URL = `https://${railwayReference(managedAppServices.api.name, "RAILWAY_PUBLIC_DOMAIN")}/api/v1`;
     }
-    if (appServices.realtime?.name) {
-      variables.VITE_REALTIME_BASE_URL = `https://${railwayReference(appServices.realtime.name, "RAILWAY_PUBLIC_DOMAIN")}`;
+    if (managedAppServices.realtime?.name) {
+      variables.VITE_REALTIME_BASE_URL = `https://${railwayReference(managedAppServices.realtime.name, "RAILWAY_PUBLIC_DOMAIN")}`;
     }
     assignManagedRailwayServiceVariables(serviceRegistry.admin, variables, variablesMode);
   }
 
-  if (variablesMode !== "replace" && appServices.worker) {
-    const existingApiVariables = appServices.api?.name
-      ? await loadRailwayServiceVariables(config.projectDir, config.railwayContext.environmentRef, appServices.api.name)
+  if (variablesMode !== "replace" && managedAppServices.worker) {
+    const existingApiVariables = managedAppServices.api?.name
+      ? await loadRailwayServiceVariables(config.projectDir, config.railwayContext.environmentRef, managedAppServices.api.name)
       : {};
     const variables = {};
     const sharedSecrets = buildRailwaySharedSecrets(localEnv, existingApiVariables);
@@ -2423,26 +2448,26 @@ async function resolveRailwayVariablePlan(config) {
     assignManagedRailwayServiceVariables(serviceRegistry.worker, variables, variablesMode);
   }
 
-  if (variablesMode !== "replace" && appServices.landing) {
+  if (variablesMode !== "replace" && managedAppServices.landing) {
     const variables = {};
     Object.assign(variables, buildLandingDefaults(localEnv));
-    if (appServices.api?.name) {
-      variables.API_BASE_URL = `https://${railwayReference(appServices.api.name, "RAILWAY_PUBLIC_DOMAIN")}`;
+    if (managedAppServices.api?.name) {
+      variables.API_BASE_URL = `https://${railwayReference(managedAppServices.api.name, "RAILWAY_PUBLIC_DOMAIN")}`;
     }
-    if (appServices.pwa?.name) {
-      variables.PWA_BASE_URL = `https://${railwayReference(appServices.pwa.name, "RAILWAY_PUBLIC_DOMAIN")}`;
+    if (managedAppServices.pwa?.name) {
+      variables.PWA_BASE_URL = `https://${railwayReference(managedAppServices.pwa.name, "RAILWAY_PUBLIC_DOMAIN")}`;
     }
     assignManagedRailwayServiceVariables(serviceRegistry.landing, variables, variablesMode);
   }
 
-  if (variablesMode !== "replace" && appServices.pwa) {
+  if (variablesMode !== "replace" && managedAppServices.pwa) {
     const variables = {};
     Object.assign(variables, buildPwaDefaults(localEnv));
-    if (appServices.api?.name) {
-      variables.VITE_API_BASE_URL = `https://${railwayReference(appServices.api.name, "RAILWAY_PUBLIC_DOMAIN")}/api/v1`;
+    if (managedAppServices.api?.name) {
+      variables.VITE_API_BASE_URL = `https://${railwayReference(managedAppServices.api.name, "RAILWAY_PUBLIC_DOMAIN")}/api/v1`;
     }
-    if (appServices.realtime?.name) {
-      variables.VITE_REALTIME_BASE_URL = `https://${railwayReference(appServices.realtime.name, "RAILWAY_PUBLIC_DOMAIN")}`;
+    if (managedAppServices.realtime?.name) {
+      variables.VITE_REALTIME_BASE_URL = `https://${railwayReference(managedAppServices.realtime.name, "RAILWAY_PUBLIC_DOMAIN")}`;
     }
     assignManagedRailwayServiceVariables(serviceRegistry.pwa, variables, variablesMode);
   }
@@ -2471,7 +2496,7 @@ async function resolveRailwayVariablePlan(config) {
   }
 
   return {
-    appServices,
+    appServices: managedAppServices,
     infra,
     notices,
     serviceRegistry,
@@ -2728,6 +2753,87 @@ function printResolvedRailwayConfig(payload) {
   }
 }
 
+function resolveDirectoryArg(positionals, fallback) {
+  return positionals.at(-1) || fallback;
+}
+
+function buildManagedBrowserOrigins(services, appServiceSpecs, manifest) {
+  return buildRailwayBrowserOrigins({
+    admin: resolveManagedServiceReference(services, appServiceSpecs, manifest, "admin"),
+    landing: resolveManagedServiceReference(services, appServiceSpecs, manifest, "landing"),
+    pwa: resolveManagedServiceReference(services, appServiceSpecs, manifest, "pwa"),
+  });
+}
+
+function resolveManagedServiceReference(services, appServiceSpecs, manifest, key) {
+  const discoveredService = findRailwayServiceByKey(services, appServiceSpecs, manifest, key);
+  if (discoveredService?.name) {
+    return discoveredService;
+  }
+
+  const spec = findRailwayAppServiceSpec(appServiceSpecs, key);
+  if (!spec) {
+    return null;
+  }
+
+  const serviceName = manifest.appServices?.[key]?.serviceName || resolveRailwayServiceName(spec, manifest.projectSlug);
+  return serviceName ? { name: serviceName } : null;
+}
+
+async function writeResolvedRailwayConfigToProjectConfig(payload, options = {}) {
+  const projectConfig = (await loadProjectConfig(payload.directory)) || {};
+  const nextProjectConfig = {
+    ...projectConfig,
+    railway: {
+      ...(projectConfig.railway || {}),
+    },
+  };
+  const variablesByService = buildProjectConfigRailwayVariables(payload.services, options.showSecrets);
+
+  if (payload.environment.configKey) {
+    const previousEnvironment = nextProjectConfig.railway.environments?.[payload.environment.configKey] || {};
+    nextProjectConfig.railway.environments = {
+      ...(nextProjectConfig.railway.environments || {}),
+      [payload.environment.configKey]: {
+        ...previousEnvironment,
+        ...(payload.environment.railwayEnvironment && !previousEnvironment.railwayEnvironment
+          ? { railwayEnvironment: payload.environment.railwayEnvironment }
+          : {}),
+        variables: {
+          ...(previousEnvironment.variables || {}),
+          services: variablesByService,
+        },
+      },
+    };
+  } else {
+    nextProjectConfig.railway.variables = {
+      ...(nextProjectConfig.railway.variables || {}),
+      services: variablesByService,
+    };
+  }
+
+  await writeProjectConfigFile(payload.directory, nextProjectConfig);
+  if (options.quiet) {
+    return;
+  }
+
+  console.log(`- Wrote resolved Railway variables to ${pc.bold(path.join(payload.directory, "asaje.config.json"))}`);
+  if (!options.showSecrets) {
+    console.log(`- ${pc.yellow("Sensitive variables were omitted; rerun with --show-secrets to include them")}`);
+  }
+}
+
+function buildProjectConfigRailwayVariables(services, showSecrets) {
+  return Object.fromEntries(
+    services.map((service) => [
+      service.key,
+      Object.fromEntries(
+        Object.entries(service.variables || {}).filter(([key]) => showSecrets || !isSensitiveRailwayVariableKey(key)),
+      ),
+    ]),
+  );
+}
+
 function printRailwayConfigSnapshotDiff(diff) {
   console.log(pc.bold("\nRailway config diff"));
   console.log(`- Left: ${pc.bold(formatRailwayDiffSide(diff.left))}`);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-asaje-go-vue",
-	"version": "0.3.9",
+	"version": "0.3.10",
 	"description": "CLI to scaffold, configure, and run the Asaje Go + Vue boilerplate",
 	"type": "module",
 	"bin": {

package/src/cli/args.js

@@ -126,13 +126,13 @@ export function parseUpdateArgs(argv) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   options.include = uniquePaths(options.include);
   return options;
 }
 
 export function parseDirectoryArgs(argv) {
-  return { directory: argv[0] || "." };
+  return { directory: resolveDirectoryArg(argv, ".") };
 }
 
 export function parseSetupRailwayArgs(argv, defaults = {}) {
@@ -215,7 +215,7 @@ export function parseSetupRailwayArgs(argv, defaults = {}) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   options.services = uniqueStrings(options.services);
   return options;
 }
@@ -279,7 +279,7 @@ export function parseDeployRailwayArgs(argv) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   options.services = uniqueStrings(options.services);
   return options;
 }
@@ -344,7 +344,7 @@ export function parseDestroyRailwayArgs(argv) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   if (!["environment", "project"].includes(options.scope)) {
     throw new Error("--scope must be either 'environment' or 'project'");
   }
@@ -434,10 +434,14 @@ export function parseStartArgs(argv) {
     positionals.push(arg);
   }
 
-  options.directory = positionals[0] || options.directory;
+  options.directory = resolveDirectoryArg(positionals, options.directory);
   return options;
 }
 
+function resolveDirectoryArg(positionals, fallback) {
+  return positionals.at(-1) || fallback;
+}
+
 function splitCsv(value) {
   return value
     .split(",")

package/src/railway/variables.js

@@ -84,14 +84,18 @@ export function formatRailwayVariableValue(key, value, showSecrets = false) {
     return "<unset>";
   }
 
-  const normalizedKey = String(key || "").toUpperCase();
-  if (!showSecrets && /(SECRET|PASSWORD|TOKEN|API_KEY|ACCESS_KEY|SECRET_KEY|ERLANG_COOKIE)/.test(normalizedKey)) {
+  if (!showSecrets && isSensitiveRailwayVariableKey(key)) {
     return redactRailwayVariableValue(value);
   }
 
   return String(value);
 }
 
+export function isSensitiveRailwayVariableKey(key) {
+  const normalizedKey = String(key || "").toUpperCase();
+  return /(SECRET|PASSWORD|TOKEN|API_KEY|ACCESS_KEY|SECRET_KEY|ERLANG_COOKIE)/.test(normalizedKey);
+}
+
 export function redactRailwayVariableValue(value) {
   const textValue = String(value || "");
   if (textValue.length <= 8) {