create-asaje-go-vue 0.3.1 → 0.3.2

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",
@@ -3070,6 +3076,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 +3086,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 +3117,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 +3181,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 +3940,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 +4001,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 +4277,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.2",
 	"description": "CLI to scaffold, configure, and run the Asaje Go + Vue boilerplate",
 	"type": "module",
 	"bin": {