@thatopen/services 0.4.0 → 0.5.0

package/dist/cli/commands/rhino.d.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+
+/**
+ * `thatopen rhino ...` — installs the That Open Rhino plug-in.
+ *
+ * Deliberately much smaller than the Revit group. The Rhino plug-in's whole job in the
+ * interoperability layer is to PUBLISH what Rhino has; it applies nothing, so there is nothing to
+ * drive from here. Everything that turns a Rhino model into a change in somebody else's model lives
+ * in the platform, not in a plug-in.
+ */
+export declare const rhinoCommand: Command;

package/dist/cli/lib/plugin-install.d.ts

@@ -0,0 +1,24 @@
+import { EngineServicesClient } from '../../core/client';
+
+/**
+ * Downloads a private plug-in package and hands back the folder it unpacked into.
+ *
+ * npm does the work on purpose. It resolves what "latest" means, it authenticates against the
+ * restricted scope, and it verifies the tarball's integrity — three things this would otherwise
+ * hand-roll over HTTP and get subtly wrong. The only thing we add is the platform token, which
+ * `setupNpmrc` trades for registry credentials exactly as the `--beta` flows do. No npm account is
+ * involved and no npm token is ever asked for.
+ */
+export declare function fetchPluginPackage(client: EngineServicesClient, pkg: string, version?: string): Promise<{
+    dir: string;
+    cleanup: () => void;
+}>;
+/**
+ * Refuses to install while the host application is running.
+ *
+ * This is not caution, it is the difference between a failed install and a broken one. Both Revit
+ * and Rhino hold their plug-in assemblies open for the whole session, so a copy over a running host
+ * fails on the first locked file — AFTER copying the ones it reached. The result is a folder holding
+ * some new DLLs and some old, which loads, misbehaves, and looks like a bug in the product.
+ */
+export declare function assertHostClosed(processName: string, friendly: string): void;

package/dist/cli.js

@@ -11686,6 +11686,60 @@ const swapCommand = new Command2("swap").description("Toggle between stable publ
     console.error("Failed to install dependencies. Run `npm install` manually.");
   }
 });
+async function fetchPluginPackage(client, pkg2, version = "latest") {
+  const work = require$$3.mkdtempSync(require$$2.join(node_os.tmpdir(), "thatopen-plugin-"));
+  const cleanup = () => {
+    try {
+      require$$3.rmSync(work, { recursive: true, force: true });
+    } catch {
+    }
+  };
+  try {
+    const creds = await setupNpmrc(client, work);
+    if (creds.status === "forbidden") {
+      throw new Error(
+        "Your account does not have access to the private plug-in packages. They need Founding access, the same as the beta engine libraries."
+      );
+    }
+    if (creds.status === "error") {
+      throw new Error(`Could not get registry credentials: ${creds.message}`);
+    }
+    require$$1.execFileSync("npm", ["pack", `${pkg2}@${version}`, "--silent"], {
+      cwd: work,
+      stdio: ["ignore", "ignore", "inherit"],
+      shell: process.platform === "win32"
+    });
+    const tgz = require$$3.readdirSync(work).find((f) => f.endsWith(".tgz"));
+    if (!tgz) throw new Error(`npm pack produced no tarball for ${pkg2}@${version}.`);
+    require$$1.execFileSync("tar", ["-xzf", tgz], { cwd: work, stdio: "inherit" });
+    const dir = require$$2.join(work, "package");
+    if (!require$$3.existsSync(dir)) throw new Error(`${tgz} did not unpack into a package/ folder.`);
+    return { dir, cleanup };
+  } catch (err) {
+    cleanup();
+    throw err;
+  }
+}
+function assertHostClosed(processName, friendly) {
+  let running = false;
+  try {
+    const out = require$$1.execFileSync(
+      "powershell",
+      ["-NoProfile", "-Command", `if (Get-Process -Name ${processName} -ErrorAction SilentlyContinue) { 'yes' }`],
+      { encoding: "utf-8" }
+    );
+    running = out.trim() === "yes";
+  } catch {
+    return;
+  }
+  if (running) {
+    throw new Error(
+      `${friendly} is running. Close it and run this again.
+
+Its plug-in files are locked while it is open, so installing now would replace some of them and not others.`
+    );
+  }
+}
 function discoveryFile() {
   const appData = process.env.APPDATA || require$$2.join(node_os.homedir(), "AppData", "Roaming");
   return require$$2.join(appData, "ThatOpen", "revit-addin.json");
@@ -11746,6 +11800,7 @@ async function configureAddin(apiUrl, accessToken) {
     key: accessToken
   });
 }
+const REVIT_ADDIN_PACKAGE = "@thatopen-platform/flow-revit";
 const revitCommand = new Command2("revit").description(
   "Revit collaboration — drive the That Open Revit add-in from the CLI"
 );
@@ -11829,6 +11884,70 @@ revitCommand.command("untake").description("Release a workset you own so teammat
   const r = await callAddin("untake", { workset: opts.workset });
   console.log(`Released workset "${r.released}".`);
 });
+revitCommand.command("install").alias("update").description("Install or update the That Open Revit add-in (Revit must be closed)").option("--version <version>", "A specific version instead of the latest", "latest").action(async (opts) => {
+  const cfg = requireResolvedConfig();
+  assertHostClosed("Revit", "Revit");
+  const client = new EngineServicesClient(cfg.accessToken, cfg.apiUrl);
+  console.log(`Fetching ${REVIT_ADDIN_PACKAGE}@${opts.version}...`);
+  const { dir, cleanup } = await fetchPluginPackage(
+    client,
+    REVIT_ADDIN_PACKAGE,
+    opts.version
+  );
+  try {
+    const installer = require$$2.join(dir, "install.ps1");
+    if (!require$$3.existsSync(installer)) {
+      throw new Error(`The package has no install.ps1. Got: ${require$$3.readdirSync(dir).join(", ")}`);
+    }
+    require$$1.execFileSync("powershell", ["-ExecutionPolicy", "Bypass", "-File", installer], {
+      stdio: "inherit"
+    });
+    console.log("\nStart Revit. The That Open tab will be there.");
+  } finally {
+    cleanup();
+  }
+});
+const RHINO_PLUGIN_PACKAGE = "@thatopen-platform/flow-rhino";
+const rhinoCommand = new Command2("rhino").description(
+  "Rhino interoperability — install the That Open Rhino plug-in"
+);
+rhinoCommand.command("install").alias("update").description("Install or update the That Open Rhino plug-in (Rhino must be closed)").option("--version <version>", "A specific version instead of the latest", "latest").action(async (opts) => {
+  const cfg = requireResolvedConfig();
+  assertHostClosed("Rhino", "Rhino");
+  const yak = findYak();
+  if (!yak) {
+    throw new Error(
+      "Could not find Yak.exe. It ships with Rhino, at C:\\Program Files\\Rhino 8\\System\\Yak.exe. Is Rhino 8 installed?"
+    );
+  }
+  const client = new EngineServicesClient(cfg.accessToken, cfg.apiUrl);
+  console.log(`Fetching ${RHINO_PLUGIN_PACKAGE}@${opts.version}...`);
+  const { dir, cleanup } = await fetchPluginPackage(client, RHINO_PLUGIN_PACKAGE, opts.version);
+  try {
+    const pkgDir = require$$2.join(dir, "pkg");
+    const yakFile = require$$3.existsSync(pkgDir) ? require$$3.readdirSync(pkgDir).find((f) => f.endsWith(".yak")) : void 0;
+    if (!yakFile) {
+      throw new Error(`The package has no .yak under pkg/. Got: ${require$$3.readdirSync(dir).join(", ")}`);
+    }
+    require$$1.execFileSync(yak, ["install", "--source", ".", "rhino-flow"], {
+      cwd: pkgDir,
+      stdio: "inherit"
+    });
+    console.log(`
+Installed ${yakFile}.`);
+    console.log("Start Rhino. The plug-in loads at startup, so its local server comes up with it.");
+  } finally {
+    cleanup();
+  }
+});
+function findYak() {
+  const candidates = [
+    "C:\\Program Files\\Rhino 8\\System\\Yak.exe",
+    "C:\\Program Files\\Rhino 9\\System\\Yak.exe",
+    "C:\\Program Files\\Rhino 8 WIP\\System\\Yak.exe"
+  ];
+  return candidates.find((p) => require$$3.existsSync(p));
+}
 const pkg = JSON.parse(
   require$$3.readFileSync(require$$2.join(__dirname, "..", "package.json"), "utf-8")
 );
@@ -11857,4 +11976,5 @@ program.addCommand(runCommand);
 program.addCommand(localServerCommand);
 program.addCommand(swapCommand);
 program.addCommand(revitCommand);
+program.addCommand(rhinoCommand);
 program.parse(process.argv);

package/package.json

@@ -15,7 +15,7 @@
     "access": "public"
   },
   "private": false,
-  "version": "0.4.0",
+  "version": "0.5.0",
   "main": "dist/index.cjs.js",
   "module": "dist/index.es.js",
   "types": "dist/index.d.ts",