@clubedge/create-clubedge-app 0.43.0 → 0.43.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to `create-clubedge-app` are documented here.
 
+## 0.43.1
+
+- **`try` shows Railway's reason when Railway refuses a VM** (#144):
+  - Before, it said Railway may have changed its free VM and told you to update the CLI, which no update fixes.
+  - It now prints Railway's own explanation, then Railway's limits, the usual cause: 3 free VMs per network per day, and no anonymous VMs while Railway is busy.
+- Still on Starter `v0.27.1`.
+
 ## 0.43.0
 
 - **Upgrades keep each app's own version** (#134, by @ahmed-husssain):

package/README.md

@@ -381,7 +381,7 @@ Projects created with `--infra neon` also have `.github/workflows/preview.yml`,
 Each CLI release is tested against one specific Starter release:
 
 ```text
-create-clubedge-app v0.43.0
+create-clubedge-app v0.43.1
         |
         v
 Clubedge Starter v0.27.1
@@ -392,7 +392,7 @@ The current relationship is:
 
 | CLI release | Default Starter release | Meaning |
 | --- | --- | --- |
-| `create-clubedge-app@0.43.0` | `clubedge-starter@v0.27.1` | The CLI's required, tested default |
+| `create-clubedge-app@0.43.1` | `clubedge-starter@v0.27.1` | The CLI's required, tested default |
 
 This means the same CLI version always scaffolds the same Starter revision by default. The CLI does not silently follow Starter `main`.
 

package/dist/core/railway.js

@@ -31,11 +31,12 @@ export function hostKeyFingerprint(key) {
 }
 /**
  * Finds Railway's JSON status line in a command's stderr. Returns null when there is none, and
- * throws when there is one without the fields this CLI needs.
+ * throws when there is one without the fields this CLI needs, with Railway's reason when it
+ * refused the VM.
  */
 export function parseRailwayStatus(stderr) {
-    for (const line of stderr.split(/\r?\n/)) {
-        const trimmed = line.trim();
+    const lines = stderr.split(/\r?\n/).map((line) => line.trim());
+    for (const trimmed of lines) {
         if (!trimmed.startsWith("{"))
             continue;
         let value;
@@ -47,6 +48,8 @@ export function parseRailwayStatus(stderr) {
         }
         if (typeof value.status !== "string")
             continue;
+        if (value.status === "error")
+            throw new Error(railwayRefusal(value, lines));
         const previewUrl = value.preview_url;
         const claimUrl = value.human_claim_url;
         const expiresAt = new Date(String(value.build_expires_at));
@@ -57,6 +60,19 @@ export function parseRailwayStatus(stderr) {
     }
     return null;
 }
+/**
+ * Why Railway refused a VM, in its own words: a message in its status line, else the text it
+ * wrote around that line, else the line itself. Its limits come after, since they are the usual
+ * cause.
+ */
+function railwayRefusal(value, lines) {
+    const said = ["message", "error", "reason", "description", "detail"]
+        .map((key) => value[key])
+        .find((text) => typeof text === "string" && text.trim() !== "");
+    const around = lines.filter((line) => line && !line.startsWith("{")).join(" ");
+    const reason = (said?.trim() || around || `its answer was ${JSON.stringify(value)}`).slice(0, 500).replace(/\.$/, "");
+    return `Railway did not start a VM: ${reason}. Railway allows 3 free VMs per network per day and turns anonymous VMs off while it is busy, so try again later or from another network; see ${railwayFreeVmUrl}.`;
+}
 /** Where the CLI keeps its own SSH key for Railway, apart from the user's ~/.ssh. */
 export function railwayKeyPath(env = process.env, platform = process.platform) {
     const configHome = env.XDG_CONFIG_HOME || (platform === "win32" && env.APPDATA ? env.APPDATA : join(homedir(), ".config"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubedge/create-clubedge-app",
-  "version": "0.43.0",
+  "version": "0.43.1",
   "description": "Create React apps from Clubedge Starter with a CLI or local MCP server.",
   "type": "module",
   "packageManager": "pnpm@10.9.0",