@mutmutco/installer-launcher 0.1.10 → 0.1.12

package/dist/launcher.js

@@ -311,7 +311,7 @@ import { appendFileSync as appendFileSync2 } from "node:fs";
 // ../face/src/outcome.ts
 import { readFileSync, writeFileSync } from "node:fs";
 var counts = ["total", "updated", "failed"];
-var strings = ["version", "retry", "detail"];
+var strings = ["version", "retry", "detail", "logPath"];
 var flags = ["dryRun", "installed", "deferred", "operationFailed"];
 function validateInstallerOutcome(value) {
   const invalid = () => {
@@ -319,12 +319,15 @@ function validateInstallerOutcome(value) {
   };
   if (!value || typeof value !== "object" || Array.isArray(value)) return invalid();
   const facts = value;
-  const allowed = [...counts, ...strings, ...flags];
+  const allowed = [...counts, ...strings, ...flags, "rollback", "logState"];
   if (Object.keys(facts).some((key) => !allowed.includes(key))) return invalid();
   for (const key of counts) if (!Number.isSafeInteger(facts[key]) || facts[key] < 0) return invalid();
   if (facts.updated + facts.failed > facts.total) return invalid();
   for (const key of strings) if (facts[key] !== void 0 && (typeof facts[key] !== "string" || facts[key].length > 4096)) return invalid();
   for (const key of flags) if (facts[key] !== void 0 && typeof facts[key] !== "boolean") return invalid();
+  if (facts.rollback !== void 0 && !["completed", "partial", "not-needed", "unknown"].includes(facts.rollback)) return invalid();
+  if (facts.logState !== void 0 && !["unavailable", "omitted"].includes(facts.logState)) return invalid();
+  if (facts.logPath !== void 0 && (!facts.logPath.trim() || /[\x00-\x1f\x7f]/u.test(facts.logPath))) return invalid();
   return { ...facts };
 }
 function writeInstallerOutcome(path, value) {
@@ -397,7 +400,8 @@ var PHASES = {
   verify: ["Verifying the payload", "Verified the payload"],
   install: ["Installing the product", "Installed the product"],
   activate: ["Activating surfaces", "Activated surfaces"],
-  doctor: ["Checking health", "Checked health"]
+  doctor: ["Checking health", "Checked health"],
+  rollback: ["Restoring the previous version", "Restored the previous version"]
 };
 function createInstallerRun(value, options = {}) {
   const declaration = validateInstallerProduct(value);
@@ -408,11 +412,18 @@ function createInstallerRun(value, options = {}) {
     product: declaration.product,
     columns: options.columns,
     env,
-    color: tty && options.color !== false && env.NO_COLOR === void 0
+    color: tty && options.color !== false && env.NO_COLOR === void 0 && env.TERM !== "dumb"
   });
-  const write = options.write ?? ((text, channel) => {
+  const errors = [];
+  const write = options.write ? (text, channel) => {
+    try {
+      options.write(text, channel);
+    } catch (error) {
+      errors.push(`installer output observer: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  } : (text, channel) => {
     (channel === "stdout" ? process.stdout : process.stderr).write(text);
-  });
+  };
   const emit = (text, channel = "stdout", recorded = text) => {
     if (!text) return;
     write(text, channel);
@@ -437,9 +448,13 @@ function createInstallerRun(value, options = {}) {
   const start = () => {
     if (started || finished) return;
     started = true;
+    if (options.quiet) return;
     const welcome = face.welcome();
     if (tty) lines(welcome);
-    else if (welcome.length) lines([`${face.identity.name} \u2014 Mutatis Mutandis`, options.operation === "install" ? face.identity.installWarm : face.identity.warm]);
+    else if (welcome.length) {
+      const warm = options.operation === "install" ? face.identity.installWarm : face.identity.warm;
+      lines([`${face.identity.name} - Mutatis Mutandis`, warm.replaceAll("\u2014", "-").replaceAll("\u2026", "...")]);
+    }
   };
   const durable = (title, measure, kind) => {
     spinner.stop();
@@ -447,6 +462,9 @@ function createInstallerRun(value, options = {}) {
     if (rendered) lines([tty ? rendered : `${kind === "fail" ? "Failed: " : ""}${title}${measure === null ? "" : ` (${typeof measure === "number" ? `${Math.max(0, Math.round(measure))}s` : measure})`}`]);
   };
   const run2 = {
+    get errors() {
+      return [...errors];
+    },
     start,
     phase(id, facts = {}) {
       if (finished) throw new Error("installer run already finished");
@@ -466,12 +484,13 @@ function createInstallerRun(value, options = {}) {
       const surface = declaration.surfaces.find((surface2) => surface2.id === facts.id);
       if (!surface) throw new Error("installer run: undeclared surface");
       start();
-      const versions = facts.to ? facts.from && facts.from !== facts.to ? ` ${facts.from} \u2192 ${facts.to}` : ` ${facts.to}` : "";
+      const versions = facts.to ? facts.from && facts.from !== facts.to ? ` ${facts.from} ${tty ? "\u2192" : "->"} ${facts.to}` : ` ${facts.to}` : "";
       const status = { updated: options.dryRun ? "would update" : "updated", current: "already current", failed: "failed", skipped: "skipped", retry: "retrying", pending: "pending", kept: "kept" }[facts.state];
       if (!status) throw new Error("installer run: unknown surface state");
-      const activation = facts.state === "updated" && surface.activation ? ` \xB7 ${surface.activation}` : "";
+      const separator = tty ? "\xB7" : "-";
+      const activation = facts.state === "updated" && surface.activation ? ` ${separator} ${surface.activation}` : "";
       const completed = ["updated", "current", "kept", "skipped"].includes(facts.state);
-      durable(`${facts.id}${versions} \xB7 ${status}${activation}`, completed ? facts.seconds ?? null : null, facts.state === "failed" ? "fail" : facts.state === "updated" ? "ok" : "note");
+      durable(`${facts.id}${versions} ${separator} ${status}${activation}`, completed ? facts.seconds ?? null : null, facts.state === "failed" ? "fail" : facts.state === "updated" ? "ok" : "note");
       if (facts.detail) run2.relay(facts.detail);
     },
     milestone({ step, state, ms }) {
@@ -498,6 +517,20 @@ function createInstallerRun(value, options = {}) {
 `);
       }
     },
+    cancel() {
+      if (finished) return;
+      if (env.MM_INSTALLER_OUTCOME_FILE) writeInstallerOutcome(
+        env.MM_INSTALLER_OUTCOME_FILE,
+        { total: 0, updated: 0, failed: 0, deferred: true, detail: "Operation cancelled." }
+      );
+      start();
+      spinner.stop();
+      finished = true;
+      if (!face.nested || !env.MM_INSTALLER_OUTCOME_FILE) {
+        lines(tty ? face.receipt(["Operation cancelled."], { ready: false }) : ["Operation cancelled."]);
+      }
+      if (tty) lines([face.signOff()]);
+    },
     finish(facts) {
       if (finished) return;
       validateInstallerOutcome(facts);
@@ -505,6 +538,7 @@ function createInstallerRun(value, options = {}) {
       start();
       spinner.stop();
       finished = true;
+      if (options.quiet && facts.updated === 0 && facts.failed === 0 && !facts.operationFailed) return;
       const changed = !facts.version ? "No release target is available." : facts.dryRun ? `Would update ${facts.updated} of ${facts.total} surfaces to ${facts.version}.` : facts.installed ? `Installed ${facts.version} across ${facts.total} surfaces.` : `Updated ${facts.updated} of ${facts.total} surfaces to ${facts.version}.`;
       const ready = facts.failed === 0 && !facts.dryRun && !facts.deferred && !facts.operationFailed && Boolean(facts.version);
       const body = [
@@ -512,7 +546,9 @@ function createInstallerRun(value, options = {}) {
         changed,
         ...facts.failed ? [`Failed ${facts.failed} of ${facts.total} surfaces.`] : [],
         ...facts.detail ? [facts.detail] : [],
-        facts.retry && facts.failed ? `Retry:  ${facts.retry}` : `Check health any time:  ${declaration.doctor}`
+        ...facts.rollback ? [`Rollback: ${facts.rollback}`] : [],
+        ...facts.logPath ? [`Log: ${facts.logPath}`] : facts.logState ? [`Log: ${facts.logState}`] : [],
+        facts.retry && (facts.failed > 0 || facts.operationFailed) ? `Retry:  ${facts.retry}` : `Check health any time:  ${declaration.doctor}`
       ];
       if (!face.nested || !env.MM_INSTALLER_OUTCOME_FILE && (facts.failed > 0 || facts.operationFailed)) {
         lines(tty ? face.receipt(body, { ready }) : body.map((row) => row.replace(/^[✔✖●]  /u, "")));
@@ -1253,7 +1289,7 @@ function wipeProductDir(dir) {
 }
 
 // src/index.ts
-var LAUNCHER_VERSION = true ? "0.1.10" : readVersionFromPackage();
+var LAUNCHER_VERSION = true ? "0.1.12" : readVersionFromPackage();
 function defaultPrint(message) {
   process.stdout.write(`${message}
 `);
@@ -1538,10 +1574,7 @@ async function installOrUpdate(config, dir, options, print, update) {
     operation: update ? "update" : "install",
     tty: options.tty,
     animate: !options.print && Boolean(process.stderr.isTTY),
-    write: (text, channel) => {
-      if (options.print) print(text.replace(/\n$/, ""));
-      else (channel === "stdout" ? process.stdout : process.stderr).write(text);
-    }
+    ...options.print ? { write: (text) => print(text.replace(/\n$/, "")) } : {}
   });
   const fetchImpl = options.fetchImpl ?? fetch;
   let version = readState(dir)?.version ?? "unknown";

package/dist/launcher.sea.cjs

@@ -342,7 +342,7 @@ var import_node_fs4 = require("node:fs");
 // ../face/src/outcome.ts
 var import_node_fs3 = require("node:fs");
 var counts = ["total", "updated", "failed"];
-var strings = ["version", "retry", "detail"];
+var strings = ["version", "retry", "detail", "logPath"];
 var flags = ["dryRun", "installed", "deferred", "operationFailed"];
 function validateInstallerOutcome(value) {
   const invalid = () => {
@@ -350,12 +350,15 @@ function validateInstallerOutcome(value) {
   };
   if (!value || typeof value !== "object" || Array.isArray(value)) return invalid();
   const facts = value;
-  const allowed = [...counts, ...strings, ...flags];
+  const allowed = [...counts, ...strings, ...flags, "rollback", "logState"];
   if (Object.keys(facts).some((key) => !allowed.includes(key))) return invalid();
   for (const key of counts) if (!Number.isSafeInteger(facts[key]) || facts[key] < 0) return invalid();
   if (facts.updated + facts.failed > facts.total) return invalid();
   for (const key of strings) if (facts[key] !== void 0 && (typeof facts[key] !== "string" || facts[key].length > 4096)) return invalid();
   for (const key of flags) if (facts[key] !== void 0 && typeof facts[key] !== "boolean") return invalid();
+  if (facts.rollback !== void 0 && !["completed", "partial", "not-needed", "unknown"].includes(facts.rollback)) return invalid();
+  if (facts.logState !== void 0 && !["unavailable", "omitted"].includes(facts.logState)) return invalid();
+  if (facts.logPath !== void 0 && (!facts.logPath.trim() || /[\x00-\x1f\x7f]/u.test(facts.logPath))) return invalid();
   return { ...facts };
 }
 function writeInstallerOutcome(path, value) {
@@ -428,7 +431,8 @@ var PHASES = {
   verify: ["Verifying the payload", "Verified the payload"],
   install: ["Installing the product", "Installed the product"],
   activate: ["Activating surfaces", "Activated surfaces"],
-  doctor: ["Checking health", "Checked health"]
+  doctor: ["Checking health", "Checked health"],
+  rollback: ["Restoring the previous version", "Restored the previous version"]
 };
 function createInstallerRun(value, options = {}) {
   const declaration = validateInstallerProduct(value);
@@ -439,11 +443,18 @@ function createInstallerRun(value, options = {}) {
     product: declaration.product,
     columns: options.columns,
     env,
-    color: tty && options.color !== false && env.NO_COLOR === void 0
+    color: tty && options.color !== false && env.NO_COLOR === void 0 && env.TERM !== "dumb"
   });
-  const write = options.write ?? ((text, channel) => {
+  const errors = [];
+  const write = options.write ? (text, channel) => {
+    try {
+      options.write(text, channel);
+    } catch (error) {
+      errors.push(`installer output observer: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  } : (text, channel) => {
     (channel === "stdout" ? process.stdout : process.stderr).write(text);
-  });
+  };
   const emit = (text, channel = "stdout", recorded = text) => {
     if (!text) return;
     write(text, channel);
@@ -468,9 +479,13 @@ function createInstallerRun(value, options = {}) {
   const start = () => {
     if (started || finished) return;
     started = true;
+    if (options.quiet) return;
     const welcome = face.welcome();
     if (tty) lines(welcome);
-    else if (welcome.length) lines([`${face.identity.name} \u2014 Mutatis Mutandis`, options.operation === "install" ? face.identity.installWarm : face.identity.warm]);
+    else if (welcome.length) {
+      const warm = options.operation === "install" ? face.identity.installWarm : face.identity.warm;
+      lines([`${face.identity.name} - Mutatis Mutandis`, warm.replaceAll("\u2014", "-").replaceAll("\u2026", "...")]);
+    }
   };
   const durable = (title, measure, kind) => {
     spinner.stop();
@@ -478,6 +493,9 @@ function createInstallerRun(value, options = {}) {
     if (rendered) lines([tty ? rendered : `${kind === "fail" ? "Failed: " : ""}${title}${measure === null ? "" : ` (${typeof measure === "number" ? `${Math.max(0, Math.round(measure))}s` : measure})`}`]);
   };
   const run2 = {
+    get errors() {
+      return [...errors];
+    },
     start,
     phase(id, facts = {}) {
       if (finished) throw new Error("installer run already finished");
@@ -497,12 +515,13 @@ function createInstallerRun(value, options = {}) {
       const surface = declaration.surfaces.find((surface2) => surface2.id === facts.id);
       if (!surface) throw new Error("installer run: undeclared surface");
       start();
-      const versions = facts.to ? facts.from && facts.from !== facts.to ? ` ${facts.from} \u2192 ${facts.to}` : ` ${facts.to}` : "";
+      const versions = facts.to ? facts.from && facts.from !== facts.to ? ` ${facts.from} ${tty ? "\u2192" : "->"} ${facts.to}` : ` ${facts.to}` : "";
       const status = { updated: options.dryRun ? "would update" : "updated", current: "already current", failed: "failed", skipped: "skipped", retry: "retrying", pending: "pending", kept: "kept" }[facts.state];
       if (!status) throw new Error("installer run: unknown surface state");
-      const activation = facts.state === "updated" && surface.activation ? ` \xB7 ${surface.activation}` : "";
+      const separator = tty ? "\xB7" : "-";
+      const activation = facts.state === "updated" && surface.activation ? ` ${separator} ${surface.activation}` : "";
       const completed = ["updated", "current", "kept", "skipped"].includes(facts.state);
-      durable(`${facts.id}${versions} \xB7 ${status}${activation}`, completed ? facts.seconds ?? null : null, facts.state === "failed" ? "fail" : facts.state === "updated" ? "ok" : "note");
+      durable(`${facts.id}${versions} ${separator} ${status}${activation}`, completed ? facts.seconds ?? null : null, facts.state === "failed" ? "fail" : facts.state === "updated" ? "ok" : "note");
       if (facts.detail) run2.relay(facts.detail);
     },
     milestone({ step, state, ms }) {
@@ -529,6 +548,20 @@ function createInstallerRun(value, options = {}) {
 `);
       }
     },
+    cancel() {
+      if (finished) return;
+      if (env.MM_INSTALLER_OUTCOME_FILE) writeInstallerOutcome(
+        env.MM_INSTALLER_OUTCOME_FILE,
+        { total: 0, updated: 0, failed: 0, deferred: true, detail: "Operation cancelled." }
+      );
+      start();
+      spinner.stop();
+      finished = true;
+      if (!face.nested || !env.MM_INSTALLER_OUTCOME_FILE) {
+        lines(tty ? face.receipt(["Operation cancelled."], { ready: false }) : ["Operation cancelled."]);
+      }
+      if (tty) lines([face.signOff()]);
+    },
     finish(facts) {
       if (finished) return;
       validateInstallerOutcome(facts);
@@ -536,6 +569,7 @@ function createInstallerRun(value, options = {}) {
       start();
       spinner.stop();
       finished = true;
+      if (options.quiet && facts.updated === 0 && facts.failed === 0 && !facts.operationFailed) return;
       const changed = !facts.version ? "No release target is available." : facts.dryRun ? `Would update ${facts.updated} of ${facts.total} surfaces to ${facts.version}.` : facts.installed ? `Installed ${facts.version} across ${facts.total} surfaces.` : `Updated ${facts.updated} of ${facts.total} surfaces to ${facts.version}.`;
       const ready = facts.failed === 0 && !facts.dryRun && !facts.deferred && !facts.operationFailed && Boolean(facts.version);
       const body = [
@@ -543,7 +577,9 @@ function createInstallerRun(value, options = {}) {
         changed,
         ...facts.failed ? [`Failed ${facts.failed} of ${facts.total} surfaces.`] : [],
         ...facts.detail ? [facts.detail] : [],
-        facts.retry && facts.failed ? `Retry:  ${facts.retry}` : `Check health any time:  ${declaration.doctor}`
+        ...facts.rollback ? [`Rollback: ${facts.rollback}`] : [],
+        ...facts.logPath ? [`Log: ${facts.logPath}`] : facts.logState ? [`Log: ${facts.logState}`] : [],
+        facts.retry && (facts.failed > 0 || facts.operationFailed) ? `Retry:  ${facts.retry}` : `Check health any time:  ${declaration.doctor}`
       ];
       if (!face.nested || !env.MM_INSTALLER_OUTCOME_FILE && (facts.failed > 0 || facts.operationFailed)) {
         lines(tty ? face.receipt(body, { ready }) : body.map((row) => row.replace(/^[✔✖●]  /u, "")));
@@ -1285,7 +1321,7 @@ function wipeProductDir(dir) {
 }
 
 // src/index.ts
-var LAUNCHER_VERSION = true ? "0.1.10" : readVersionFromPackage();
+var LAUNCHER_VERSION = true ? "0.1.12" : readVersionFromPackage();
 function defaultPrint(message) {
   process.stdout.write(`${message}
 `);
@@ -1570,10 +1606,7 @@ async function installOrUpdate(config, dir, options, print, update) {
     operation: update ? "update" : "install",
     tty: options.tty,
     animate: !options.print && Boolean(process.stderr.isTTY),
-    write: (text, channel) => {
-      if (options.print) print(text.replace(/\n$/, ""));
-      else (channel === "stdout" ? process.stdout : process.stderr).write(text);
-    }
+    ...options.print ? { write: (text) => print(text.replace(/\n$/, "")) } : {}
   });
   const fetchImpl = options.fetchImpl ?? fetch;
   let version = readState(dir)?.version ?? "unknown";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/installer-launcher",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Single-executable (SEA) launcher: sign-in, gated payload fetch, self-update. One copy ships per product.",
   "type": "module",
   "license": "UNLICENSED",
@@ -24,7 +24,7 @@
   },
   "scripts": {
     "build": "node build.mjs",
-    "test": "vitest run",
+    "test": "vitest run --no-file-parallelism",
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {