@irtio/cli 0.5.2 → 0.6.0

package/dist/api.d.ts

@@ -0,0 +1,52 @@
+/**
+ * A thin typed `fetch` wrapper around `@irtio/control`'s `/v1` API (contract.ts). Two things
+ * earn this its own module rather than inlined `fetch` calls in every command:
+ *
+ * 1. **`ApiError` becomes a real thrown error.** The control plane's error bodies (`code`,
+ *    `message`, and — on `E_BREAKING_SCHEMA` — `changes`/`hint`) are exactly what `irtio deploy`
+ *    needs to print verbatim; `ApiClientError` carries them through instead of a generic
+ *    "request failed" the command layer would have to re-parse.
+ * 2. **401 is a command, not an error.** Every command that hits the control plane wants the same
+ *    "run: irtio login" line and exit code 1, so it lives here once.
+ */
+declare class ApiClientError extends Error {
+    readonly name = "ApiClientError";
+    readonly status: number;
+    readonly code: string;
+    readonly changes: readonly unknown[] | undefined;
+    readonly hint: string | undefined;
+    constructor(status: number, body: {
+        code: string;
+        message: string;
+        changes?: readonly unknown[];
+        hint?: string;
+    });
+}
+/** Thrown by `requireApiClient`/callers when there is no stored token: the login nudge. */
+declare class NotLoggedInError extends Error {
+    readonly controlUrl: string;
+    readonly name = "NotLoggedInError";
+    constructor(controlUrl: string);
+}
+interface ApiClient {
+    readonly controlUrl: string;
+    get<T>(path: string, query?: Record<string, string | undefined>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    patch<T>(path: string, body?: unknown): Promise<T>;
+    /**
+     * `DELETE`, with the same query-string handling as `get`. The one route that needs it today is
+     * `DELETE /v1/projects/:id/origins`, which names the origin to remove in the query rather than
+     * the body, so a client without this method cannot remove an origin at all.
+     */
+    del<T>(path: string, query?: Record<string, string | undefined>): Promise<T>;
+    /** Uploads raw bytes (a bundle) rather than JSON. */
+    postBytes<T>(path: string, bytes: Uint8Array): Promise<T>;
+}
+/** Builds a client bound to one control URL, using whatever token `irtio login` last stored. */
+declare function createApiClient(controlUrl: string): Promise<ApiClient>;
+/** Same as `createApiClient`, but with an explicit token — what tests use. */
+declare function createApiClientWithToken(controlUrl: string, token: string): ApiClient;
+/** True when `err` is the "please log in" case — the shape every command checks for. */
+declare function isLoginRequired(err: unknown): boolean;
+
+export { type ApiClient, ApiClientError, NotLoggedInError, createApiClient, createApiClientWithToken, isLoginRequired };

package/dist/api.js

@@ -0,0 +1,15 @@
+import {
+  ApiClientError,
+  NotLoggedInError,
+  createApiClient,
+  createApiClientWithToken,
+  isLoginRequired
+} from "./chunk-RNAH5T4W.js";
+import "./chunk-UPHQM6NZ.js";
+export {
+  ApiClientError,
+  NotLoggedInError,
+  createApiClient,
+  createApiClientWithToken,
+  isLoginRequired
+};

package/dist/bundle.js

@@ -3,7 +3,7 @@ import {
   BundleError,
   EXTERNAL_IMPORTS,
   bundleRoom
-} from "./chunk-KRQUAEN2.js";
+} from "./chunk-OTSFRVJN.js";
 export {
   ALLOWED_IMPORTS,
   BundleError,

package/dist/{chunk-GBNHBWES.js → chunk-3HQMVCYA.js}

@@ -1,19 +1,23 @@
 import {
   STATIC_LIMITS,
   staticPathProblem
-} from "./chunk-BPE452KF.js";
+} from "./chunk-RQSJZWQC.js";
 import {
   ensureProject,
   readProjectConfig
-} from "./chunk-32QTPKVT.js";
+} from "./chunk-DKWG7MGO.js";
 import {
   HelpRequested,
-  createApiClient,
   helpFor,
-  helpRequested,
-  isLoginRequired,
+  helpRequested
+} from "./chunk-ZD4ND6X6.js";
+import {
+  createApiClient,
+  isLoginRequired
+} from "./chunk-RNAH5T4W.js";
+import {
   resolveControlUrlForUser
-} from "./chunk-TV66QHFP.js";
+} from "./chunk-UPHQM6NZ.js";
 
 // src/static-deploy.ts
 import { existsSync } from "fs";

package/dist/{chunk-32QTPKVT.js → chunk-DKWG7MGO.js}

@@ -1,6 +1,6 @@
 import {
   ApiClientError
-} from "./chunk-TV66QHFP.js";
+} from "./chunk-RNAH5T4W.js";
 
 // src/project-file.ts
 import { existsSync } from "fs";

package/dist/{chunk-KRQUAEN2.js → chunk-OTSFRVJN.js}

@@ -5,8 +5,14 @@ import * as path from "path";
 import { pathToFileURL } from "url";
 import { Worker } from "worker_threads";
 import * as esbuild from "esbuild";
-var ALLOWED_IMPORTS = ["@irtio/server", "@irtio/schema", "@dimforge/rapier3d-compat"];
-var EXTERNAL_IMPORTS = ["@dimforge/rapier3d-compat"];
+var ALLOWED_IMPORTS = [
+  "@irtio/server",
+  "@irtio/schema",
+  "@dimforge/rapier3d-compat",
+  // D45: the second blessed engine. Exactly one import added, as the decision says.
+  "matter-js"
+];
+var EXTERNAL_IMPORTS = ["@dimforge/rapier3d-compat", "matter-js"];
 var BundleError = class extends Error {
   name = "BundleError";
 };
@@ -85,8 +91,8 @@ async function bundleRoom(options) {
   const out = result.outputFiles[0];
   if (!out) throw new BundleError("esbuild produced no output");
   const warnings = result.warnings.map((w) => w.text);
-  const importsRapier = Object.values(result.metafile?.outputs ?? {}).some(
-    (o) => o.imports.some((i) => i.path === "@dimforge/rapier3d-compat")
+  const importsEngine = Object.values(result.metafile?.outputs ?? {}).some(
+    (o) => o.imports.some((i) => i.path === "@dimforge/rapier3d-compat" || i.path === "matter-js")
   );
   const hash = createHash("sha256").update(out.contents).digest("hex");
   const file = path.join(options.outDir, `room.${hash.slice(0, 16)}.mjs`);
@@ -108,9 +114,9 @@ async function bundleRoom(options) {
   }
   if (options.verify === false) return { file, hash, warnings };
   const verified = await verifyBundle(file);
-  if (importsRapier && !verified.physics) {
+  if (importsEngine && !verified.physics) {
     throw new BundleError(
-      "irtio: this room imports @dimforge/rapier3d-compat but declares no physics. Add\n  physics: { engine: 'rapier3d', gravity: { x: 0, y: -9.81, z: 0 }, bodies: { ... } }\nto defineRoom(...), and mark the body-backed fields with the schema's physics option. Without it the runtime never creates a world, and nothing you build with the engine steps."
+      "irtio: this room imports a physics engine but declares no physics. Add\n  physics: { engine: 'rapier3d', gravity: { x: 0, y: -9.81, z: 0 }, bodies: { ... } }\nor, for the 2D engine,\n  physics: { engine: 'matter2d', gravity: { x: 0, y: 1 }, bodies: { ... } }\nto defineRoom(...), and mark the body-backed fields with the schema's physics option. Without it the runtime never creates a world, and nothing you build with the engine steps."
     );
   }
   const fullHash = createHash("sha256").update(out.contents).update(verified.canonical).digest("hex");

package/dist/chunk-RNAH5T4W.js

@@ -0,0 +1,96 @@
+import {
+  readCredential
+} from "./chunk-UPHQM6NZ.js";
+
+// src/api-client.ts
+var ApiClientError = class extends Error {
+  name = "ApiClientError";
+  status;
+  code;
+  changes;
+  hint;
+  constructor(status, body) {
+    super(body.message);
+    this.status = status;
+    this.code = body.code;
+    this.changes = body.changes;
+    this.hint = body.hint;
+  }
+};
+var NotLoggedInError = class extends Error {
+  constructor(controlUrl) {
+    super(`not logged in to ${controlUrl} \u2014 run: irtio login`);
+    this.controlUrl = controlUrl;
+  }
+  controlUrl;
+  name = "NotLoggedInError";
+};
+async function createApiClient(controlUrl) {
+  const credential = await readCredential(controlUrl);
+  if (!credential) throw new NotLoggedInError(controlUrl);
+  return createApiClientWithToken(controlUrl, credential.token);
+}
+function createApiClientWithToken(controlUrl, token) {
+  async function request(method, path, init = {}) {
+    const headers = {
+      Authorization: `Bearer ${token}`,
+      Accept: "application/json"
+    };
+    let requestBody;
+    if (init.bytes !== void 0) {
+      headers["content-type"] = "application/octet-stream";
+      requestBody = init.bytes;
+    } else if (init.body !== void 0) {
+      headers["content-type"] = "application/json";
+      requestBody = JSON.stringify(init.body);
+    }
+    const response = await fetch(`${controlUrl}${path}`, {
+      method,
+      headers,
+      ...requestBody !== void 0 ? { body: requestBody } : {}
+    });
+    const text = await response.text();
+    const parsed = text.length > 0 ? JSON.parse(text) : void 0;
+    if (!response.ok) {
+      const body = parsed !== void 0 && typeof parsed === "object" && parsed !== null && "code" in parsed && "message" in parsed ? parsed : {
+        code: "E_UNKNOWN",
+        message: text || `${method} ${path} failed with ${response.status}`
+      };
+      throw new ApiClientError(response.status, body);
+    }
+    return parsed;
+  }
+  function withQuery(path, query) {
+    const qs = query ? Object.entries(query).filter((e) => e[1] !== void 0).map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join("&") : "";
+    return qs ? `${path}?${qs}` : path;
+  }
+  return {
+    controlUrl,
+    get(path, query) {
+      return request("GET", withQuery(path, query));
+    },
+    del(path, query) {
+      return request("DELETE", withQuery(path, query));
+    },
+    post(path, body) {
+      return request("POST", path, { body });
+    },
+    patch(path, body) {
+      return request("PATCH", path, { body });
+    },
+    postBytes(path, bytes) {
+      return request("POST", path, { bytes });
+    }
+  };
+}
+function isLoginRequired(err) {
+  return err instanceof NotLoggedInError || err instanceof ApiClientError && err.status === 401;
+}
+
+export {
+  ApiClientError,
+  NotLoggedInError,
+  createApiClient,
+  createApiClientWithToken,
+  isLoginRequired
+};