@or3/cloud 0.1.12 → 0.1.15

package/dist/cli.mjs

@@ -23,7 +23,7 @@ import { promisify } from "node:util";
 import { dirname, basename, isAbsolute, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 var execFile = promisify(execFileCallback);
-var PACKAGE_VERSION = "0.1.12";
+var PACKAGE_VERSION = "0.1.15";
 var IMAGE_REPOSITORY = "ghcr.io/saluana/or3-chat";
 var ASSET_ROOT = resolve(fileURLToPath(new URL("../assets/", import.meta.url)));
 var STATE_SCHEMA_VERSION = 1;
@@ -132,6 +132,23 @@ function parseFlags(argv) {
   }
   return { positionals, flags };
 }
+var COMMAND_FLAGS = {
+  init: ["local", "public", "domain", "admin-email", "admin-password", "admin-password-file", "port"],
+  update: ["to"],
+  backup: [],
+  restore: ["yes"],
+  rollback: ["yes"],
+  doctor: [],
+  recover: [],
+  adopt: ["from"]
+};
+function assertCommandFlags(command, flags) {
+  const allowed = new Set(["help", ...COMMAND_FLAGS[command] ?? []]);
+  const unknown = Object.keys(flags).filter((flag) => !allowed.has(flag));
+  if (unknown.length > 0) {
+    throw new Error(`Unknown option${unknown.length === 1 ? "" : "s"} for ${command}: ${unknown.map((flag) => `--${flag}`).join(", ")}. Run npx @or3/cloud ${command} --help.`);
+  }
+}
 function stringFlag(flags, key) {
   const value = flags[key];
   return typeof value === "string" ? value : undefined;
@@ -418,11 +435,18 @@ Diagnostics: ${diagnostics(directory, mode)}`);
   }
 }
 async function pullImage(image) {
-  if (process.env.OR3_CLOUD_SKIP_PULL !== "true") {
+  const local = await run("docker", ["image", "inspect", image]);
+  if (!local.ok && process.env.OR3_CLOUD_SKIP_PULL !== "true") {
     const result = await run("docker", ["pull", image]);
-    if (!result.ok)
-      throw new Error(`${result.command}
-${result.stderr}`);
+    if (!result.ok) {
+      const detail = result.stderr.trim();
+      if (/(not found|manifest unknown|pull access denied)/i.test(detail)) {
+        throw new Error(`The matching OR3 container image is not published yet: ${image}. This is a release issue, not a problem with your computer. Try again after the image release completes. ${detail}`);
+      }
+      throw new Error(`Could not download ${image}. Check your internet connection and Docker registry access, then retry. ${detail}`);
+    }
+  } else if (!local.ok) {
+    throw new Error(`${image} is not available locally and OR3_CLOUD_SKIP_PULL=true prevents downloading it.`);
   }
   return imageDigest(image);
 }
@@ -1121,7 +1145,7 @@ async function updateCommand(directory, flags) {
   await waitForDeepHealth(loaded.directory, state.mode, secretValues(env));
   const targetVersion = stringFlag(flags, "to")?.trim() ?? PACKAGE_VERSION;
   if (!isVersion(targetVersion))
-    throw new Error("--to must be a complete semantic version such as 0.1.12.");
+    throw new Error("--to must be a complete semantic version such as 0.1.15.");
   if (targetVersion === state.appVersion)
     throw new Error(`The deployment is already on OR3 ${targetVersion}.`);
   const targetImage = imageFor(targetVersion);
@@ -1646,6 +1670,9 @@ async function main(argv = process.argv.slice(2)) {
     return console.log(PACKAGE_VERSION);
   const parsed = parseFlags(rest);
   try {
+    if (parsed.flags.help)
+      return help();
+    assertCommandFlags(command, parsed.flags);
     if (command === "init")
       return await initCommand(parsed.positionals, parsed.flags);
     if (command === "update")
@@ -1684,6 +1711,7 @@ export {
   buildEnv,
   assertSupportedSourceCompose,
   assertSupportedSource,
+  assertCommandFlags,
   assertBackupMatchesDeployment,
   PACKAGE_VERSION,
   IMAGE_REPOSITORY

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@or3/cloud",
-  "version": "0.1.12",
+  "version": "0.1.15",
   "description": "Install and operate the OR3 Cloud container distribution",
   "type": "module",
   "license": "GPL-3.0",
@@ -10,7 +10,7 @@
     "directory": "packages/or3-cloud"
   },
   "engines": {
-    "node": ">=24"
+    "node": ">=20"
   },
   "bin": {
     "or3": "./dist/cli.mjs"