create-asaje-go-vue 0.3.1 → 0.3.3

package/README.md

@@ -82,6 +82,15 @@ npx -p create-asaje-go-vue@latest asaje setup-railway ./my-app --dry-run
 npx -p create-asaje-go-vue@latest asaje update-railway ./my-app --yes
 ```
 
+By default this manages four Railway app services:
+
+- `api`
+- `worker`
+- `realtime-gateway`
+- `admin`
+
+The default `worker` service reuses `api/Dockerfile` and starts with `API_COMMAND=worker`.
+
 ### Sync Railway app variables
 
 ```bash
@@ -127,6 +136,7 @@ npx -p create-asaje-go-vue@latest asaje diff-railway-config ./my-app --file ./sn
 
 ```bash
 npx -p create-asaje-go-vue@latest asaje deploy-railway ./my-app
+npx -p create-asaje-go-vue@latest asaje deploy-railway ./my-app --service worker
 npx -p create-asaje-go-vue@latest asaje deploy-railway ./my-app --service api
 npx -p create-asaje-go-vue@latest asaje deploy-railway ./my-app --services api,admin --dry-run
 ```
@@ -195,9 +205,9 @@ npx -p create-asaje-go-vue@latest asaje destroy-railway ./my-app --scope project
 - reads the linked Railway project context
 - provisions PostgreSQL, RabbitMQ, and S3-compatible object storage on Railway
 - creates missing Railway app services for the configured app service list
-- defaults to `api`, `realtime-gateway`, and `admin` when no custom Railway service config is present
+- defaults to `api`, `worker`, `realtime-gateway`, and `admin` when no custom Railway service config is present
 - applies Railway variables from `asaje.config.json` when configured
-- keeps the legacy automatic variable wiring for `api`, `realtime-gateway`, and `admin` unless `railway.variablesMode` is set to `replace`
+- keeps the legacy automatic variable wiring for `api`, `worker`, `realtime-gateway`, and `admin` unless `railway.variablesMode` is set to `replace`
 - triggers the first Railway deployment for each app service using the service-local `Dockerfile` and `railway.json`
 - generates missing app secrets such as `JWT_SECRET` and `SWAGGER_PASSWORD`, while reusing existing Railway values when present
 - supports `--dry-run` to preview provisioning and variable changes without applying them
@@ -218,7 +228,7 @@ npx -p create-asaje-go-vue@latest asaje destroy-railway ./my-app --scope project
 - reads the linked Railway project context
 - discovers existing Railway app and infra services
 - syncs configured Railway variables without provisioning infra resources
-- keeps the legacy automatic variable wiring for `api`, `realtime-gateway`, and `admin` unless `railway.variablesMode` is set to `replace`
+- keeps the legacy automatic variable wiring for `api`, `worker`, `realtime-gateway`, and `admin` unless `railway.variablesMode` is set to `replace`
 - supports `--diff` to show what would be added or changed compared with the current Railway variables
 - supports `--dry-run` to preview variable changes without applying them
 
@@ -263,7 +273,7 @@ npx -p create-asaje-go-vue@latest asaje destroy-railway ./my-app --scope project
 - reads the linked Railway project context
 - discovers the existing Railway app services from the linked project or `asaje.railway.json`
 - triggers fresh Railway builds/deployments for the configured app service list from the current local source tree
-- defaults to `api`, `realtime-gateway`, and `admin` when no custom Railway service config is present
+- defaults to `api`, `worker`, `realtime-gateway`, and `admin` when no custom Railway service config is present
 - supports `--service` and `--services` to redeploy only selected app services
 - supports `--dry-run` to preview which services would be redeployed
 
@@ -285,6 +295,13 @@ If the `railway` block is omitted, the CLI keeps the default built-in services a
         "directory": "api",
         "dockerfile": "api/Dockerfile"
       },
+      {
+        "key": "worker",
+        "directory": "api",
+        "baseName": "worker",
+        "aliases": ["worker", "api-worker"],
+        "dockerfile": "api/Dockerfile"
+      },
       {
         "key": "admin",
         "directory": "admin",
@@ -297,12 +314,6 @@ If the `railway` block is omitted, the CLI keeps the default built-in services a
         "aliases": ["realtime-gateway"],
         "dockerfile": "realtime-gateway/Dockerfile"
       },
-      {
-        "key": "worker",
-        "directory": "worker-api",
-        "baseName": "worker",
-        "dockerfile": "worker-api/Dockerfile"
-      },
       {
         "key": "marketing",
         "directory": "marketing",
@@ -403,7 +414,8 @@ Notes:
 - the service directory should contain the `Dockerfile` Railway will build from
 - custom services are provisioned and deployed by `setup-railway` and `deploy-railway`
 - `sync-railway-env` can now apply declarative variables to any managed service key, including custom services
-- with `variablesMode: "merge"`, the core services `api`, `realtime-gateway`, and `admin` still receive the legacy generated defaults unless you override them
+- with `variablesMode: "merge"`, the core services `api`, `worker`, `realtime-gateway`, and `admin` still receive the legacy generated defaults unless you override them
+- the default `worker` service reuses the `api` image and starts with `API_COMMAND=worker`
 - with `variablesMode: "replace"`, only the variables declared in `asaje.config.json` are applied
 - after changing the Railway config, run `asaje update-railway ./my-app --yes` to reconcile the linked Railway project with the new configuration
 - you can target a custom service with `asaje deploy-railway ./my-app --service worker`

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

@@ -34,6 +34,12 @@ const DEFAULT_RAILWAY_APP_SERVICE_SPECS = [
     directory: "api",
     key: "api",
   },
+  {
+    aliases: ["worker", "api-worker"],
+    baseName: "worker",
+    directory: "api",
+    key: "worker",
+  },
   {
     aliases: ["admin", "frontend", "web"],
     baseName: "admin",
@@ -1258,10 +1264,11 @@ async function runSetupRailway(argv) {
   const projectConfig = await loadProjectConfig(projectDir);
   const projectSlug = resolveProjectSlug(projectDir, projectConfig);
   const appServiceSpecs = resolveRailwayAppServiceSpecs(projectConfig);
+  const selectedSpecs = resolveDeployRailwaySpecs(answers.services, appServiceSpecs);
   const requestedRailwayEnvironment = resolveRequestedRailwayEnvironmentRef(projectConfig, answers.environment);
 
   await ensureProjectStructure(projectDir);
-  await ensureRailwayAppServiceTargets(projectDir, appServiceSpecs);
+  await ensureRailwayAppServiceTargets(projectDir, selectedSpecs);
   await ensureRailwayCliInstalled();
   await ensureRailwayAuthenticated(projectDir, requestedRailwayEnvironment);
   await ensureRailwayEnvironmentLinked(projectDir, requestedRailwayEnvironment);
@@ -1337,7 +1344,7 @@ async function runSetupRailway(argv) {
 
   console.log(pc.bold("\nApplication services"));
   manifest.appServices ||= {};
-  for (const spec of appServiceSpecs) {
+  for (const spec of selectedSpecs) {
     const serviceName = resolveRailwayServiceName(spec, projectSlug);
     const serviceResult = await ensureRailwayAppService({
       aliases: spec.aliases,
@@ -1382,7 +1389,7 @@ async function runSetupRailway(argv) {
     projectDir,
     projectSlug,
     railwayContext,
-    selectedSpecs: appServiceSpecs,
+    selectedSpecs,
     services: servicesAfterProvision,
   });
   deploySummary.push(...deploymentResults);
@@ -1752,10 +1759,12 @@ function parseDirectoryArgs(argv) {
 function parseSetupRailwayArgs(argv) {
   const options = {
     bucket: DEFAULT_RAILWAY_BUCKET,
+    bucketProvided: false,
     directory: ".",
     diff: false,
     dryRun: false,
     environment: undefined,
+    services: [],
     yes: false,
   };
   const positionals = [];
@@ -1780,12 +1789,14 @@ function parseSetupRailwayArgs(argv) {
 
     if (arg === "--bucket") {
       options.bucket = argv[index + 1] || options.bucket;
+      options.bucketProvided = true;
       index += 1;
       continue;
     }
 
     if (arg.startsWith("--bucket=")) {
       options.bucket = arg.split("=")[1] || options.bucket;
+      options.bucketProvided = true;
       continue;
     }
 
@@ -1800,10 +1811,33 @@ function parseSetupRailwayArgs(argv) {
       continue;
     }
 
+    if (arg === "--service") {
+      options.services.push(argv[index + 1] || "");
+      index += 1;
+      continue;
+    }
+
+    if (arg.startsWith("--service=")) {
+      options.services.push(arg.split("=")[1] || "");
+      continue;
+    }
+
+    if (arg === "--services") {
+      options.services.push(...splitCsv(argv[index + 1] || ""));
+      index += 1;
+      continue;
+    }
+
+    if (arg.startsWith("--services=")) {
+      options.services.push(...splitCsv(arg.split("=")[1] || ""));
+      continue;
+    }
+
     positionals.push(arg);
   }
 
   options.directory = positionals[0] || options.directory;
+  options.services = [...new Set(options.services.map((service) => service.trim()).filter(Boolean))];
   return options;
 }
 
@@ -2194,19 +2228,23 @@ function parseDestroyRailwayArgs(argv) {
 }
 
 async function collectSetupRailwayAnswers(args) {
+  const directory = args.directory;
+  const bucketState = await resolveSetupRailwayBucketState(args, directory);
+
   if (args.yes) {
     return {
-      bucket: args.bucket,
-      directory: args.directory,
+      bucket: bucketState.bucket,
+      directory,
       diff: args.diff,
       dryRun: args.dryRun,
       environment: args.environment,
+      services: args.services,
     };
   }
 
-  const directory = await prompt(
+  const selectedDirectory = await prompt(
     text({
-      defaultValue: args.directory,
+      defaultValue: directory,
       message: "Project directory to configure on Railway?",
       placeholder: ".",
       validate(value) {
@@ -2215,18 +2253,23 @@ async function collectSetupRailwayAnswers(args) {
     }),
   );
 
-  const bucket = await prompt(
-    text({
-      defaultValue: args.bucket,
-      message: "Object storage bucket name?",
-      placeholder: DEFAULT_RAILWAY_BUCKET,
-      validate(value) {
-        return /^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$/.test(value)
-          ? undefined
-          : "Use 3-63 lowercase letters, numbers, dots, or hyphens";
-      },
-    }),
-  );
+  const selectedBucketState = await resolveSetupRailwayBucketState(args, selectedDirectory);
+  let bucket = selectedBucketState.bucket;
+
+  if (!args.bucketProvided && !selectedBucketState.hasStoredBucket) {
+    bucket = await prompt(
+      text({
+        defaultValue: selectedBucketState.bucket,
+        message: "Object storage bucket name?",
+        placeholder: DEFAULT_RAILWAY_BUCKET,
+        validate(value) {
+          return /^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$/.test(value)
+            ? undefined
+            : "Use 3-63 lowercase letters, numbers, dots, or hyphens";
+        },
+      }),
+    );
+  }
 
   let environment = args.environment;
   if (!environment) {
@@ -2241,10 +2284,28 @@ async function collectSetupRailwayAnswers(args) {
 
   return {
     bucket,
-    directory,
+    directory: selectedDirectory,
     diff: args.diff,
     dryRun: args.dryRun,
     environment: environment?.trim() || undefined,
+    services: args.services,
+  };
+}
+
+async function resolveSetupRailwayBucketState(args, directory) {
+  if (args.bucketProvided) {
+    return {
+      bucket: args.bucket,
+      hasStoredBucket: true,
+    };
+  }
+
+  const projectDir = path.resolve(process.cwd(), directory || ".");
+  const manifest = await readRailwayManifest(projectDir);
+  const existingBucket = typeof manifest.bucket === "string" ? manifest.bucket.trim() : "";
+  return {
+    bucket: existingBucket || DEFAULT_RAILWAY_BUCKET,
+    hasStoredBucket: Boolean(existingBucket),
   };
 }
 
@@ -3070,6 +3131,7 @@ async function resolveRailwayVariablePlan(config) {
     admin: findRailwayServiceByKey(config.services, config.appServiceSpecs, config.manifest, "admin"),
     api: findRailwayServiceByKey(config.services, config.appServiceSpecs, config.manifest, "api"),
     realtime: findRailwayServiceByKey(config.services, config.appServiceSpecs, config.manifest, "realtime"),
+    worker: findRailwayServiceByKey(config.services, config.appServiceSpecs, config.manifest, "worker"),
   };
 
   const serviceRegistry = {
@@ -3079,6 +3141,7 @@ async function resolveRailwayVariablePlan(config) {
     postgres: infra.postgres ? { name: infra.postgres.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,
   };
 
   for (const spec of config.appServiceSpecs) {
@@ -3109,6 +3172,9 @@ async function resolveRailwayVariablePlan(config) {
   if (!appServices.admin) {
     notices.push("admin service not found, skipping admin variable wiring");
   }
+  if (!appServices.worker) {
+    notices.push("worker service not found, skipping worker variable wiring");
+  }
   if (!infra.postgres) {
     notices.push("postgres resource not found, DATABASE_URL wiring will be skipped");
   }
@@ -3170,6 +3236,26 @@ async function resolveRailwayVariablePlan(config) {
     mergeRailwayServiceVariables(serviceRegistry.admin, variables);
   }
 
+  if (variablesMode !== "replace" && appServices.worker) {
+    const existingApiVariables = appServices.api?.name
+      ? await loadRailwayServiceVariables(config.projectDir, config.railwayContext.environmentRef, appServices.api.name)
+      : {};
+    const variables = {};
+    const sharedSecrets = buildRailwaySharedSecrets(localEnv, existingApiVariables);
+    Object.assign(variables, sharedSecrets.api);
+    variables.API_COMMAND = "worker";
+    if (infra.postgres?.name) {
+      variables.DATABASE_URL = railwayReference(infra.postgres.name, "DATABASE_URL");
+    }
+    if (infra.rabbitmq?.name) {
+      variables.RABBITMQ_URL = buildRabbitMqUrlReference(infra.rabbitmq.name);
+    }
+    if (infra.objectStorage?.name) {
+      Object.assign(variables, buildObjectStorageVariables(infra.objectStorage.name));
+    }
+    mergeRailwayServiceVariables(serviceRegistry.worker, variables);
+  }
+
   if (declaredVariables.hasDeclaredVariables) {
     if (Object.keys(declaredVariables.sharedVariables).length > 0) {
       for (const entry of Object.values(serviceRegistry)) {
@@ -3909,6 +3995,7 @@ function printRailwaySetupSummary(config) {
   if (config.railwayContext.environmentName || config.railwayContext.environmentId) {
     console.log(`- Environment: ${pc.bold(config.railwayContext.environmentName || config.railwayContext.environmentId)}`);
   }
+  console.log(`- Managed services: ${pc.bold("api, worker, realtime-gateway, admin")}`);
   console.log(`- Bucket: ${pc.bold(config.bucket)}`);
 
   console.log(pc.bold("\nResources"));
@@ -3969,6 +4056,7 @@ function printRailwayDeploySummary(config) {
   if (config.railwayContext.environmentName || config.railwayContext.environmentId) {
     console.log(`- Environment: ${pc.bold(config.railwayContext.environmentName || config.railwayContext.environmentId)}`);
   }
+  console.log(`- Default managed services: ${pc.bold("api, worker, realtime-gateway, admin")}`);
   console.log(`- Services: ${pc.bold(config.selectedServices.join(", "))}`);
 
   console.log(pc.bold("\nDeployments"));
@@ -4244,17 +4332,38 @@ async function scanProjectForManagedRailwayServices(projectDir) {
   const dockerfiles = [];
   await collectDockerfiles(projectDir, "", dockerfiles);
 
-  const serviceSpecs = dockerfiles
+  const scannedSpecs = dockerfiles
     .map((dockerfilePath) => buildScannedRailwayServiceSpec(projectDir, dockerfilePath))
     .filter(Boolean)
     .sort((left, right) => left.directory.localeCompare(right.directory));
 
+  const serviceSpecs = synthesizeDerivedRailwayServices(scannedSpecs);
+
   return {
     dockerfiles,
     serviceSpecs,
   };
 }
 
+function synthesizeDerivedRailwayServices(serviceSpecs) {
+  const nextSpecs = [...serviceSpecs];
+  const hasAPI = serviceSpecs.some((spec) => spec.key === "api" && spec.directory === "api");
+  const hasWorker = serviceSpecs.some((spec) => spec.key === "worker");
+  if (hasAPI && !hasWorker) {
+    nextSpecs.push({
+      aliases: ["worker", "api-worker"],
+      baseName: "worker",
+      directory: "api",
+      dockerfile: "api/Dockerfile",
+      key: "worker",
+      seedImage: "alpine:3.22",
+      serviceName: null,
+    });
+  }
+
+  return nextSpecs.sort((left, right) => `${left.directory}:${left.key}`.localeCompare(`${right.directory}:${right.key}`));
+}
+
 async function collectDockerfiles(projectDir, relativeDir, results) {
   const absoluteDir = path.join(projectDir, relativeDir);
   const entries = await fs.readdir(absoluteDir, { withFileTypes: true });

package/package.json

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