@irtio/cli 0.4.0 → 0.5.1

package/dist/chunk-D7CDJRFF.js

@@ -0,0 +1,24 @@
+// src/project-file.ts
+import { existsSync } from "fs";
+import { readFile } from "fs/promises";
+import * as path from "path";
+async function readIrtioJsonName(cwd, command) {
+  const file = path.join(cwd, "irtio.json");
+  if (!existsSync(file)) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(await readFile(file, "utf8"));
+  } catch (err) {
+    throw new Error(`${command}: ${file} is not valid JSON: ${String(err)}`);
+  }
+  const name = parsed?.name;
+  if (name === void 0) return void 0;
+  if (typeof name !== "string" || name.length === 0) {
+    throw new Error(`${command}: ${file} has a "name" that is not a non-empty string`);
+  }
+  return name;
+}
+
+export {
+  readIrtioJsonName
+};

package/dist/{deploy-6OM3UYNL.js → deploy-YVCVDVMS.js}

@@ -4,6 +4,9 @@ import {
 import {
   bundleRoom
 } from "./chunk-KRQUAEN2.js";
+import {
+  readIrtioJsonName
+} from "./chunk-D7CDJRFF.js";
 import {
   ApiClientError,
   createApiClient,
@@ -39,6 +42,14 @@ function parseDeployArgs(args) {
         parsed.project = value;
         break;
       }
+      case "--name": {
+        const value = args[++i];
+        if (value === void 0 || value === "") {
+          throw new Error("irtio deploy: --name needs a value");
+        }
+        parsed.name = value;
+        break;
+      }
       case "--url": {
         const value = args[++i];
         if (value === void 0) throw new Error("irtio deploy: --url needs a value");
@@ -193,9 +204,7 @@ async function runDeploy(options = {}) {
     else throw err;
   }
   if (!projectExists) {
-    const defaultName = path.basename(cwd);
-    const answer = (await ask(`project ${projectId} does not exist yet \u2014 name it [${defaultName}]: `)).trim();
-    const name = answer.length > 0 ? answer : defaultName;
+    const name = options.name ?? await readIrtioJsonName(cwd, "irtio deploy") ?? path.basename(cwd);
     await client.post("/v1/projects", { name, id: projectId });
     log(pc.dim(`created project ${projectId} (${name})`));
   }
@@ -356,6 +365,7 @@ async function deploy(args, deps = {}) {
       allowBreaking: parsed.allowBreaking,
       log,
       ...parsed.project !== void 0 ? { project: parsed.project } : {},
+      ...parsed.name !== void 0 ? { name: parsed.name } : {},
       ...parsed.url !== void 0 ? { controlUrl: parsed.url } : {},
       ...parsed.room !== void 0 ? { room: parsed.room } : {},
       ...parsed.strategy !== void 0 ? { strategy: parsed.strategy } : {},

package/dist/index.js

@@ -8,8 +8,10 @@ usage: irtio <command>
 
 commands:
   init [dir] [--tick|--event]                     scaffold irtio/schema.ts, rpc.ts, room.ts,
-                                                  room.test.ts and irtio.json (--tick/--event
-                                                  skip the one question it otherwise asks)
+       [--name <name>]                            room.test.ts and irtio.json (--tick/--event
+                                                  skip the one question it otherwise asks;
+                                                  --name is the project name a first deploy
+                                                  registers, default the directory)
   dev [--room <file>] [--port <n>] [--no-watch]   bundle the room file and run it locally
   simulate [--bots <n>] [--seconds <n>]           drive N real clients at a running room and
           [--room <code>] [--url <ws://\u2026>]        check the built-in invariants
@@ -26,11 +28,13 @@ commands:
   deploy [--allow-breaking] [--project <id>]      bundle, classify the schema change against the
          [--url <control>] [--room <file>]        last deployment, and upload \u2014 refuses breaking
          [--strategy drain|migrate]               changes unless a migration covers them;
-                                                  migrate moves LIVE rooms onto the new version
-                                                  now (drain, the default, lets them finish)
+         [--name <name>]                          migrate moves LIVE rooms onto the new version
+                                                  now (drain, the default, lets them finish).
+                                                  A project that does not exist yet is created
+                                                  as --name, else irtio.json's "name"
   deploy --static <dir> [--project <id>]          upload a BUILT client directory to the project's
          [--label <label>] [--url <control>]      static site and print the playable link
-                                                  (<label>.irt-serve.com; no build step)
+         [--name <name>]                          (<label>.irt-serve.com; no build step)
   migrate create <name>                           scaffold irtio/migrations/<n>_<name>.ts with the
                                                   live breaking changes quoted in its header
   rollback <version> [--project <id>]             re-promote deployment <version> and bring rooms
@@ -79,16 +83,16 @@ switch (command) {
   }
   case "deploy": {
     if (args.includes("--static")) {
-      const { staticDeploy } = await import("./static-deploy-LZXTDYNY.js");
+      const { staticDeploy } = await import("./static-deploy-BP3MDXCP.js");
       await staticDeploy(args);
       break;
     }
-    const { deploy } = await import("./deploy-6OM3UYNL.js");
+    const { deploy } = await import("./deploy-YVCVDVMS.js");
     await deploy(args);
     break;
   }
   case "migrate": {
-    const { migrate } = await import("./migrate-3R6VRW4J.js");
+    const { migrate } = await import("./migrate-UD245ULI.js");
     await migrate(args);
     break;
   }

package/dist/init.d.ts

@@ -21,6 +21,8 @@ interface InitArgs {
     readonly mode?: RoomMode;
     /** `--physics`: a Rapier room with a shared world-builder and client prediction (D22). */
     readonly physics?: boolean;
+    /** `--name`: the project's display name. Defaults to the directory name. */
+    readonly name?: string;
 }
 interface RunInitOptions {
     /** Where the project lives. Defaults to `process.cwd()`. */
@@ -28,6 +30,8 @@ interface RunInitOptions {
     readonly dir?: string;
     readonly mode?: RoomMode;
     readonly physics?: boolean;
+    /** The project's display name, written to `irtio.json`. Defaults to the directory name. */
+    readonly name?: string;
     /**
      * Asks the one question. Injected so tests never touch a TTY; the default reads stdin when it
      * is a TTY and otherwise takes the default answer rather than hanging in a pipeline.
@@ -41,6 +45,8 @@ interface InitResult {
     /** Absolute path of the scaffolded project. */
     readonly dir: string;
     readonly project: string;
+    /** The name written to `irtio.json`; what the first deploy registers the project as. */
+    readonly name: string;
     readonly mode: RoomMode;
     /** Files written, relative to `dir`, in emit order. */
     readonly created: readonly string[];

package/dist/init.js

@@ -15,8 +15,17 @@ var DEFAULT_TICK_RATE = 20;
 var DEFAULT_IDLE_MS = 3e4;
 function parseInitArgs(args) {
   const parsed = {};
-  for (const arg of args) {
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
     switch (arg) {
+      case "--name": {
+        const value = args[++i];
+        if (value === void 0 || value === "") {
+          throw new Error("irtio init: --name needs a value");
+        }
+        parsed.name = value;
+        break;
+      }
       case "--physics":
         parsed.physics = true;
         break;
@@ -455,11 +464,13 @@ async function runInit(options = {}) {
   }
   const configFile = path.join(dir, "irtio.json");
   let project = options.projectId ?? generateProjectId();
+  let name = options.name ?? (path.basename(dir) || "project");
   if (existsSync(configFile)) {
     try {
       const existing = JSON.parse(await readFile(configFile, "utf8"));
       if (typeof existing.project === "string" && existing.project !== "")
         project = existing.project;
+      if (typeof existing.name === "string" && existing.name !== "") name = existing.name;
     } catch {
     }
   }
@@ -469,14 +480,14 @@ async function runInit(options = {}) {
     ["irtio/world.ts", WORLD_TEMPLATE],
     ["irtio/room.ts", physicsRoomTemplate()],
     ["irtio/room.test.ts", PHYSICS_ROOM_TEST_TEMPLATE],
-    ["irtio.json", `${JSON.stringify({ project }, null, 2)}
+    ["irtio.json", `${JSON.stringify({ project, name }, null, 2)}
 `]
   ] : [
     ["irtio/schema.ts", schemaTemplate(project)],
     ["irtio/rpc.ts", RPC_TEMPLATE],
     ["irtio/room.ts", roomTemplate(mode)],
     ["irtio/room.test.ts", ROOM_TEST_TEMPLATE],
-    ["irtio.json", `${JSON.stringify({ project }, null, 2)}
+    ["irtio.json", `${JSON.stringify({ project, name }, null, 2)}
 `]
   ];
   const created = [];
@@ -498,7 +509,7 @@ async function runInit(options = {}) {
   if (skipped.length > 0) {
     log(pc.yellow(`kept ${skipped.join(", ")} (already there \u2014 nothing was overwritten)`));
   }
-  log(pc.dim(`project ${project} \xB7 ${mode} mode${physics ? " \xB7 physics" : ""}`));
+  log(pc.dim(`project ${project} (${name}) \xB7 ${mode} mode${physics ? " \xB7 physics" : ""}`));
   const installCommand = packageJson === "absent" ? `npm i ${wantedDeps.join(" ")}` : "npm install   # the irtio packages were added to your package.json";
   for (const line of nextSteps(installCommand)) log(line);
   if (physics) {
@@ -511,7 +522,7 @@ async function runInit(options = {}) {
     log("  draw from room.render (predicted + interpolated), write intents via room.state.");
     log("");
   }
-  return { dir, project, mode, created, skipped, packageJson };
+  return { dir, project, name, mode, created, skipped, packageJson };
 }
 async function init(args) {
   try {
@@ -519,7 +530,8 @@ async function init(args) {
     await runInit({
       ...parsed.dir !== void 0 ? { dir: parsed.dir } : {},
       ...parsed.mode !== void 0 ? { mode: parsed.mode } : {},
-      ...parsed.physics !== void 0 ? { physics: parsed.physics } : {}
+      ...parsed.physics !== void 0 ? { physics: parsed.physics } : {},
+      ...parsed.name !== void 0 ? { name: parsed.name } : {}
     });
   } catch (err) {
     console.error(pc.red(err instanceof Error ? err.message : String(err)));

package/dist/{migrate-3R6VRW4J.js → migrate-UD245ULI.js}

@@ -56,7 +56,12 @@ function resolveEntry(cwd, room) {
 async function readIrtioJsonProject(cwd) {
   const file = path.join(cwd, "irtio.json");
   if (!existsSync(file)) return void 0;
-  const parsed = JSON.parse(await readFile(file, "utf8"));
+  let parsed;
+  try {
+    parsed = JSON.parse(await readFile(file, "utf8"));
+  } catch {
+    throw new Error(`irtio migrate: ${file} is not valid JSON`);
+  }
   return typeof parsed.project === "string" && parsed.project.length > 0 ? parsed.project : void 0;
 }
 async function scanDirectoryVersion(cwd) {

package/dist/{static-deploy-LZXTDYNY.js → static-deploy-BP3MDXCP.js}

@@ -1,8 +1,12 @@
+import {
+  readIrtioJsonName
+} from "./chunk-D7CDJRFF.js";
 import {
   STATIC_LIMITS,
   staticPathProblem
 } from "./chunk-BPE452KF.js";
 import {
+  ApiClientError,
   createApiClient,
   isLoginRequired
 } from "./chunk-I37DLT7K.js";
@@ -44,6 +48,14 @@ function parseStaticDeployArgs(args) {
         parsed.label = value;
         break;
       }
+      case "--name": {
+        const value = args[++i];
+        if (value === void 0 || value === "") {
+          throw new Error("irtio deploy: --name needs a value");
+        }
+        parsed.name = value;
+        break;
+      }
       default:
         throw new Error(`irtio deploy --static: unknown option ${JSON.stringify(arg)}`);
     }
@@ -94,6 +106,17 @@ async function readIrtioJsonProject(cwd) {
   }
   return typeof parsed.project === "string" && parsed.project.length > 0 ? parsed.project : void 0;
 }
+async function ensureProject(client, projectId, cwd, explicitName, log) {
+  try {
+    await client.get(`/v1/projects/${projectId}`);
+    return;
+  } catch (err) {
+    if (!(err instanceof ApiClientError && err.status === 404)) throw err;
+  }
+  const name = explicitName ?? await readIrtioJsonName(cwd, "irtio deploy") ?? path.basename(cwd);
+  await client.post("/v1/projects", { name, id: projectId });
+  log(pc.dim(`created project ${projectId} (${name})`));
+}
 async function runStaticDeploy(options) {
   const log = options.log ?? ((line) => console.log(line));
   const cwd = path.resolve(options.cwd ?? process.cwd());
@@ -132,6 +155,7 @@ async function runStaticDeploy(options) {
   }
   const controlUrl = await resolveControlUrlForUser(options.controlUrl);
   const client = options.client ?? await createApiClient(controlUrl);
+  await ensureProject(client, project, cwd, options.name, log);
   const begin = await client.post(
     `/v1/projects/${project}/static/begin`,
     options.label !== void 0 ? { label: options.label } : {}
@@ -181,6 +205,7 @@ async function staticDeploy(args, deps = {}) {
       ...parsed.project !== void 0 ? { project: parsed.project } : {},
       ...parsed.url !== void 0 ? { controlUrl: parsed.url } : {},
       ...parsed.label !== void 0 ? { label: parsed.label } : {},
+      ...parsed.name !== void 0 ? { name: parsed.name } : {},
       ...deps.client !== void 0 ? { client: deps.client } : {},
       ...deps.cwd !== void 0 ? { cwd: deps.cwd } : {}
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@irtio/cli",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "irtio CLI: local dev server, room scaffolding, bot simulation, deploy, logs and rooms",
   "license": "MIT",
   "publishConfig": {
@@ -29,12 +29,12 @@
     "esbuild": "^0.27.3",
     "picocolors": "^1.1.1",
     "ws": "^8.18.0",
-    "@irtio/bots": "0.4.0",
-    "@irtio/client": "0.4.0",
-    "@irtio/protocol": "0.4.0",
-    "@irtio/runtime": "0.4.0",
-    "@irtio/schema": "0.4.0",
-    "@irtio/server": "0.4.0"
+    "@irtio/client": "0.5.1",
+    "@irtio/protocol": "0.5.1",
+    "@irtio/bots": "0.5.1",
+    "@irtio/schema": "0.5.1",
+    "@irtio/runtime": "0.5.1",
+    "@irtio/server": "0.5.1"
   },
   "devDependencies": {
     "@dimforge/rapier3d-compat": "0.20.0",