@c9up/rover 0.1.16 → 0.1.17

package/dist/RoverProvider.d.ts

@@ -6,6 +6,12 @@ import "./augmentations.js";
 interface RoverContainer {
     singleton(token: unknown, factory: () => unknown): void;
     resolve<T = unknown>(token: unknown): Promise<T>;
+    /**
+     * Optional reader — present on ream's real container. Asked before resolving
+     * an OPTIONAL peer, so "not installed" is answered by a lookup rather than
+     * inferred from whatever resolving it threw.
+     */
+    has?(token: unknown): boolean;
 }
 interface RoverConfigStore {
     get<T = unknown>(key: string): T | undefined;
@@ -15,6 +21,7 @@ export interface RoverAppContext {
     config: RoverConfigStore;
 }
 export default class RoverProvider {
+    #private;
     protected app: RoverAppContext;
     constructor(app: RoverAppContext);
     register(): void;

package/dist/RoverProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RoverProvider.d.ts","sourceRoot":"","sources":["../src/RoverProvider.ts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAM5B;;;GAGG;AACH,UAAU,cAAc;IACvB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjD;AACD,UAAU,gBAAgB;IACzB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AACD,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,OAAO,aAAa;IACrB,SAAS,CAAC,GAAG,EAAE,eAAe;gBAApB,GAAG,EAAE,eAAe;IAE1C,QAAQ;IA+BF,IAAI;IAOJ,QAAQ;CACd"}
+{"version":3,"file":"RoverProvider.d.ts","sourceRoot":"","sources":["../src/RoverProvider.ts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAM5B;;;GAGG;AACH,UAAU,cAAc;IACvB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjD;;;;OAIG;IACH,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;CAC9B;AACD,UAAU,gBAAgB;IACzB,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7C;AACD,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,OAAO,aAAa;;IAIrB,SAAS,CAAC,GAAG,EAAE,eAAe;gBAApB,GAAG,EAAE,eAAe;IAE1C,QAAQ;IA+BF,IAAI;IASJ,QAAQ;CAQd"}

package/dist/RoverProvider.js

@@ -1,8 +1,10 @@
 import "./augmentations.js";
 import { Mail } from "./Mail.js";
-import { setMail } from "./services/main.js";
+import { clearMail, getMail, setMail } from "./services/main.js";
 export default class RoverProvider {
     app;
+    /** The Mail this provider bound, so shutdown only clears its own. */
+    #mail;
     constructor(app) {
         this.app = app;
     }
@@ -37,9 +39,19 @@ export default class RoverProvider {
         // Populate the `@c9up/rover/services/main` singleton with the
         // container-resolved Mail instance so apps can
         // `import mail from '@c9up/rover/services/main'` from anywhere.
-        setMail(await this.app.container.resolve(Mail));
+        const mail = await this.app.container.resolve(Mail);
+        this.#mail = mail;
+        setMail(mail);
+    }
+    async shutdown() {
+        // Release the module-level singleton, but only while it is still ours: a
+        // stopped application left a dead Mail reachable through
+        // `services/main`, and with two applications in one process the one
+        // shutting down must not clear a binding the other has since installed.
+        if (this.#mail !== undefined && getMail() === this.#mail)
+            clearMail();
+        this.#mail = undefined;
     }
-    async shutdown() { }
 }
 /**
  * Resolve a token from the container without throwing when it's not
@@ -47,11 +59,15 @@ export default class RoverProvider {
  * are purely opt-in.
  */
 async function tryResolve(app, token) {
-    try {
-        return await app.container.resolve(token);
-    }
-    catch {
+    // ASK whether the token is bound, rather than catching whatever resolving it
+    // throws. Catching everything meant a registered binding whose factory
+    // failed — a bad queue config, a driver that cannot connect — read exactly
+    // like "bay is not installed": rover disabled the feature and said nothing,
+    // and mail queued nowhere. Absence is a `has()` answer; a factory that
+    // throws is a fault, and faults propagate.
+    if (typeof app.container.has === "function" && !app.container.has(token)) {
         return undefined;
     }
+    return await app.container.resolve(token);
 }
 //# sourceMappingURL=RoverProvider.js.map

package/dist/RoverProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"RoverProvider.js","sourceRoot":"","sources":["../src/RoverProvider.ts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAE5B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAkB7C,MAAM,CAAC,OAAO,OAAO,aAAa;IACX;IAAtB,YAAsB,GAAoB;QAApB,QAAG,GAAH,GAAG,CAAiB;IAAG,CAAC;IAE9C,QAAQ;QACP,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAa,MAAM,CAAC,CAAC;YACvD,OAAO,IAAI,IAAI,CACd,MAAM,IAAI;gBACT,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE;aACtC,EACD;gBACC,4DAA4D;gBAC5D,2DAA2D;gBAC3D,yDAAyD;gBACzD,yDAAyD;gBACzD,KAAK,EAAE,MAAM,UAAU,CAAe,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC;gBAC/D,iEAAiE;gBACjE,2CAA2C;gBAC3C,OAAO,EAAE,MAAM,UAAU,CAAc,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC;aAC3D,CACD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,sEAAsE;QACtE,qEAAqE;QACrE,yDAAyD;QACzD,uEAAuE;QACvE,oBAAoB;QACpB,MAAM,IAAI,GAAG,GAAkB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAO,IAAI,CAAC,CAAC;QACzE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,IAAI;QACT,8DAA8D;QAC9D,+CAA+C;QAC/C,gEAAgE;QAChE,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAO,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,QAAQ,KAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,KAAK,UAAU,UAAU,CACxB,GAAoB,EACpB,KAAa;IAEb,IAAI,CAAC;QACJ,OAAO,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CAAI,KAAK,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC"}
+{"version":3,"file":"RoverProvider.js","sourceRoot":"","sources":["../src/RoverProvider.ts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAE5B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAwBjE,MAAM,CAAC,OAAO,OAAO,aAAa;IAIX;IAHtB,qEAAqE;IACrE,KAAK,CAAmB;IAExB,YAAsB,GAAoB;QAApB,QAAG,GAAH,GAAG,CAAiB;IAAG,CAAC;IAE9C,QAAQ;QACP,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAa,MAAM,CAAC,CAAC;YACvD,OAAO,IAAI,IAAI,CACd,MAAM,IAAI;gBACT,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE;aACtC,EACD;gBACC,4DAA4D;gBAC5D,2DAA2D;gBAC3D,yDAAyD;gBACzD,yDAAyD;gBACzD,KAAK,EAAE,MAAM,UAAU,CAAe,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC;gBAC/D,iEAAiE;gBACjE,2CAA2C;gBAC3C,OAAO,EAAE,MAAM,UAAU,CAAc,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC;aAC3D,CACD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,sEAAsE;QACtE,qEAAqE;QACrE,yDAAyD;QACzD,uEAAuE;QACvE,oBAAoB;QACpB,MAAM,IAAI,GAAG,GAAkB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAO,IAAI,CAAC,CAAC;QACzE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,IAAI;QACT,8DAA8D;QAC9D,+CAA+C;QAC/C,gEAAgE;QAChE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAO,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,KAAK,CAAC,QAAQ;QACb,yEAAyE;QACzE,yDAAyD;QACzD,oEAAoE;QACpE,wEAAwE;QACxE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,EAAE,KAAK,IAAI,CAAC,KAAK;YAAE,SAAS,EAAE,CAAC;QACtE,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IACxB,CAAC;CACD;AAED;;;;GAIG;AACH,KAAK,UAAU,UAAU,CACxB,GAAoB,EACpB,KAAa;IAEb,6EAA6E;IAC7E,uEAAuE;IACvE,2EAA2E;IAC3E,4EAA4E;IAC5E,uEAAuE;IACvE,2CAA2C;IAC3C,IAAI,OAAO,GAAG,CAAC,SAAS,CAAC,GAAG,KAAK,UAAU,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CAAI,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/dist/services/main.d.ts

@@ -15,6 +15,15 @@ import type { Mail } from "../Mail.js";
 export declare function setMail(mail: Mail): void;
 /** @internal Get the resolved singleton (or `undefined` pre-boot). */
 export declare function getMail(): Mail | undefined;
+/**
+ * @internal Release the singleton, so a shut-down application does not leave a
+ * dead Mail reachable through `services/main`.
+ *
+ * The caller checks ownership first (`getMail() === mine`): with two
+ * applications in one process, the one shutting down must not clear a binding
+ * the other has since installed.
+ */
+export declare function clearMail(): void;
 declare const mail: Mail;
 export default mail;
 //# sourceMappingURL=main.d.ts.map

package/dist/services/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAExC;AAED,sEAAsE;AACtE,wBAAgB,OAAO,IAAI,IAAI,GAAG,SAAS,CAE1C;AAED,QAAA,MAAM,IAAI,EAAE,IAWV,CAAC;AAEH,eAAe,IAAI,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAExC;AAED,sEAAsE;AACtE,wBAAgB,OAAO,IAAI,IAAI,GAAG,SAAS,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,QAAA,MAAM,IAAI,EAAE,IAWV,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/services/main.js

@@ -19,6 +19,17 @@ export function setMail(mail) {
 export function getMail() {
     return instance;
 }
+/**
+ * @internal Release the singleton, so a shut-down application does not leave a
+ * dead Mail reachable through `services/main`.
+ *
+ * The caller checks ownership first (`getMail() === mine`): with two
+ * applications in one process, the one shutting down must not clear a binding
+ * the other has since installed.
+ */
+export function clearMail() {
+    instance = undefined;
+}
 const mail = new Proxy({}, {
     get(_target, prop) {
         if (!instance) {

package/dist/services/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,IAAI,QAA0B,CAAC;AAE/B,2EAA2E;AAC3E,MAAM,UAAU,OAAO,CAAC,IAAU;IACjC,QAAQ,GAAG,IAAI,CAAC;AACjB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,OAAO;IACtB,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,MAAM,IAAI,GAAS,IAAI,KAAK,CAAC,EAAU,EAAE;IACxC,GAAG,CAAC,OAAO,EAAE,IAAI;QAChB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,mEAAmE;gBAClE,0EAA0E,CAC3E,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,IAAI,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,IAAI,QAA0B,CAAC;AAE/B,2EAA2E;AAC3E,MAAM,UAAU,OAAO,CAAC,IAAU;IACjC,QAAQ,GAAG,IAAI,CAAC;AACjB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,OAAO;IACtB,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS;IACxB,QAAQ,GAAG,SAAS,CAAC;AACtB,CAAC;AAED,MAAM,IAAI,GAAS,IAAI,KAAK,CAAC,EAAU,EAAE;IACxC,GAAG,CAAC,OAAO,EAAE,IAAI;QAChB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,mEAAmE;gBAClE,0EAA0E,CAC3E,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/templating/loadNapi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadNapi.d.ts","sourceRoot":"","sources":["../../src/templating/loadNapi.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAyB9C,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,OAAO,wBAAwB,EAAE,OAAO,CAAC;AAErE;;;;;;;;GAQG;AACH,KAAK,aAAa,GAAG,cAAc,wBAAwB,CAAC,CAAC;AAa7D,wBAAgB,SAAS,IAAI,aAAa,CA6CzC;AA6BD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAwBpD"}
+{"version":3,"file":"loadNapi.d.ts","sourceRoot":"","sources":["../../src/templating/loadNapi.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAsB9C,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,OAAO,wBAAwB,EAAE,OAAO,CAAC;AAErE;;;;;;;;GAQG;AACH,KAAK,aAAa,GAAG,cAAc,wBAAwB,CAAC,CAAC;AAa7D,wBAAgB,SAAS,IAAI,aAAa,CA2CzC;AA6BD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAwBpD"}

package/dist/templating/loadNapi.js

@@ -7,21 +7,14 @@
 // consumers get a typed `RoverError`. Zero `as` / `any` per `feedback_no_any_types`
 // — every boundary is narrowed with a `Reflect.get` type guard.
 import { createRequire } from "node:module";
-import { arch, platform } from "node:process";
 import { fileURLToPath } from "node:url";
 import { RoverError } from "../RoverError.js";
-const SUFFIX_MAP = {
-    "linux-x64": "linux-x64-gnu",
-    "linux-arm64": "linux-arm64-gnu",
-    "darwin-x64": "darwin-x64",
-    "darwin-arm64": "darwin-arm64",
-    "win32-x64": "win32-x64-msvc",
-};
+import { muslHint, nativeBinarySuffix, supportedTargets, } from "../vendor/nativeBinary.js";
 function platformSuffix() {
-    const key = `${platform}-${arch}`;
-    const suffix = SUFFIX_MAP[key];
-    if (typeof suffix !== "string") {
-        throw new RoverError("E_MAIL_TEMPLATE_NAPI_REQUIRED", `Unsupported platform/arch '${key}' for @c9up/rover native binary. Supported: ${Object.keys(SUFFIX_MAP).join(", ")}.`, {
+    // The table is shared; the refusal is rover's, with rover's code on it.
+    const suffix = nativeBinarySuffix();
+    if (suffix === undefined) {
+        throw new RoverError("E_MAIL_TEMPLATE_NAPI_REQUIRED", `No @c9up/rover native binary for this platform. Supported: ${supportedTargets().join(", ")}.`, {
             hint: "Build the native binary on a supported platform with 'pnpm --filter @c9up/rover build:napi'.",
         });
     }
@@ -58,10 +51,8 @@ export function getNative() {
         // The prebuilt linux binaries target glibc (`-gnu`). On musl hosts (Alpine
         // containers) the `-gnu` binary fails to dlopen with a libc symbol error —
         // surface that explicitly rather than only pointing at the build step.
-        const muslHint = suffix.endsWith("-gnu")
-            ? " If you are on Alpine/musl, note the prebuilt binaries target glibc (musl is not a supported target)."
-            : "";
-        throw new RoverError("E_MAIL_TEMPLATE_NAPI_REQUIRED", `@c9up/rover native binary 'index.${suffix}.node' not found or failed to load near ${here} — run 'pnpm --filter @c9up/rover build:napi' to build it.${muslHint} Cause: ${causeMessage}`, {
+        const musl = muslHint();
+        throw new RoverError("E_MAIL_TEMPLATE_NAPI_REQUIRED", `@c9up/rover native binary 'index.${suffix}.node' not found or failed to load near ${here} — run 'pnpm --filter @c9up/rover build:napi' to build it.${musl} Cause: ${causeMessage}`, {
             hint: "Run 'pnpm --filter @c9up/rover build:napi' to compile the native template engine.",
         });
     }

package/dist/templating/loadNapi.js.map

@@ -1 +1 @@
-{"version":3,"file":"loadNapi.js","sourceRoot":"","sources":["../../src/templating/loadNapi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loadNapi.js","sourceRoot":"","sources":["../../src/templating/loadNapi.ts"],"names":[],"mappings":"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"}

package/dist/vendor/nativeBinary.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Every `platform-arch` a binary is built for.
+ *
+ * For the message a package raises when it refuses: "no binary for
+ * linux-riscv64" is only actionable next to the list of what there IS.
+ */
+export declare function supportedTargets(): readonly string[];
+/** The suffix a given `platform-arch` builds under, or `undefined`. */
+export declare function nativeTargetSuffix(target: string): string | undefined;
+/** The suffix for THIS platform, or `undefined` where no binary is built. */
+export declare function nativeBinarySuffix(): string | undefined;
+/**
+ * Why the binary is not there, phrased for whoever has to fix it.
+ *
+ * "not found" and "not built for your platform" call for different actions,
+ * and a single "unavailable" leaves the reader to guess which one they are
+ * looking at.
+ */
+export declare function unavailableReason(cause?: unknown): string;
+/**
+ * `musl` builds under a different suffix, and the failure is otherwise
+ * baffling: the file is there, and `require` still refuses it. Worth saying so
+ * in a message rather than leaving a reader to discover glibc.
+ */
+export declare function muslHint(): string;
+/** What a load attempt did, so the caller can apply its own policy. */
+export type NativeBinaryResult<T> = {
+    loaded: true;
+    binary: T;
+} | {
+    loaded: false;
+    suffix: string | undefined;
+    cause?: unknown;
+};
+/**
+ * Load `<package root>/index.<suffix>.node`.
+ *
+ * The path is fixed rather than passed: this file is generated into
+ * `<package>/src/vendor/`, so the package root is always two levels up, from
+ * `src` and from `dist` alike.
+ */
+export declare function loadNativeBinary<T>(): NativeBinaryResult<T>;
+//# sourceMappingURL=nativeBinary.d.ts.map

package/dist/vendor/nativeBinary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeBinary.d.ts","sourceRoot":"","sources":["../../src/vendor/nativeBinary.ts"],"names":[],"mappings":"AAoCA;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,MAAM,EAAE,CAEpD;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAQzD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAIjC;AAED,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC7B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GAC3B;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,KAAK,kBAAkB,CAAC,CAAC,CAAC,CAa3D"}

package/dist/vendor/nativeBinary.js

@@ -0,0 +1,99 @@
+// Generated from scripts/vendor/nativeBinary.ts — do not edit.
+//
+// This package is published and built from its own repository, so the file
+// has to exist here rather than be imported. `pnpm vendor:sync` rewrites it,
+// and `pnpm vendor:check` fails if this copy has drifted from the original.
+/**
+ * Finding the NAPI binary a package ships beside itself.
+ *
+ * Every package with a Rust engine repeats the same table: napi-rs names its
+ * artefacts `index.<platform>-<arch>-<abi>.node`, and the mapping from Node's
+ * `platform`/`arch` to that suffix is the part that must never differ between
+ * packages. Adding a target means adding it everywhere, and a package that
+ * missed the edit fails only on that platform — which is exactly the failure
+ * nobody reproduces.
+ *
+ * What is NOT here is the policy. Some packages degrade when the binary is
+ * absent and answer `undefined`; others refuse loudly with build instructions.
+ * Both are right for their package, so the loader reports what happened and
+ * the caller decides.
+ */
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { arch, platform } from "node:process";
+import { fileURLToPath } from "node:url";
+/** Node's `platform-arch` → the suffix napi-rs builds under. */
+const TARGETS = {
+    "linux-x64": "linux-x64-gnu",
+    "linux-arm64": "linux-arm64-gnu",
+    "darwin-x64": "darwin-x64",
+    "darwin-arm64": "darwin-arm64",
+    "win32-x64": "win32-x64-msvc",
+};
+/**
+ * Every `platform-arch` a binary is built for.
+ *
+ * For the message a package raises when it refuses: "no binary for
+ * linux-riscv64" is only actionable next to the list of what there IS.
+ */
+export function supportedTargets() {
+    return Object.keys(TARGETS);
+}
+/** The suffix a given `platform-arch` builds under, or `undefined`. */
+export function nativeTargetSuffix(target) {
+    return TARGETS[target];
+}
+/** The suffix for THIS platform, or `undefined` where no binary is built. */
+export function nativeBinarySuffix() {
+    return nativeTargetSuffix(`${platform}-${arch}`);
+}
+/**
+ * Why the binary is not there, phrased for whoever has to fix it.
+ *
+ * "not found" and "not built for your platform" call for different actions,
+ * and a single "unavailable" leaves the reader to guess which one they are
+ * looking at.
+ */
+export function unavailableReason(cause) {
+    if (cause !== undefined) {
+        return `failed to load (${cause instanceof Error ? cause.message : String(cause)})`;
+    }
+    const target = `${platform}-${arch}`;
+    return nativeTargetSuffix(target) !== undefined
+        ? "binary not found"
+        : `no prebuilt binary for ${target}`;
+}
+/**
+ * `musl` builds under a different suffix, and the failure is otherwise
+ * baffling: the file is there, and `require` still refuses it. Worth saying so
+ * in a message rather than leaving a reader to discover glibc.
+ */
+export function muslHint() {
+    return platform === "linux"
+        ? " On Alpine/musl, the gnu binary will not load — build the musl target."
+        : "";
+}
+/**
+ * Load `<package root>/index.<suffix>.node`.
+ *
+ * The path is fixed rather than passed: this file is generated into
+ * `<package>/src/vendor/`, so the package root is always two levels up, from
+ * `src` and from `dist` alike.
+ */
+export function loadNativeBinary() {
+    const suffix = nativeBinarySuffix();
+    if (suffix === undefined)
+        return { loaded: false, suffix };
+    const here = dirname(fileURLToPath(import.meta.url));
+    try {
+        const nodeRequire = createRequire(import.meta.url);
+        return {
+            loaded: true,
+            binary: nodeRequire(join(here, `../../index.${suffix}.node`)),
+        };
+    }
+    catch (cause) {
+        return { loaded: false, suffix, cause };
+    }
+}
+//# sourceMappingURL=nativeBinary.js.map

package/dist/vendor/nativeBinary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeBinary.js","sourceRoot":"","sources":["../../src/vendor/nativeBinary.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAE5E;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,gEAAgE;AAChE,MAAM,OAAO,GAA2B;IACvC,WAAW,EAAE,eAAe;IAC5B,aAAa,EAAE,iBAAiB;IAChC,YAAY,EAAE,YAAY;IAC1B,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,gBAAgB;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAChD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB;IACjC,OAAO,kBAAkB,CAAC,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,mBAAmB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;IACrF,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;IACrC,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,SAAS;QAC9C,CAAC,CAAC,kBAAkB;QACpB,CAAC,CAAC,0BAA0B,MAAM,EAAE,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACvB,OAAO,QAAQ,KAAK,OAAO;QAC1B,CAAC,CAAC,wEAAwE;QAC1E,CAAC,CAAC,EAAE,CAAC;AACP,CAAC;AAOD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB;IAC/B,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACpC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,IAAI,CAAC;QACJ,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,OAAO;YACN,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,MAAM,OAAO,CAAC,CAAM;SAClE,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACzC,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/rover",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Mail transport for Ream — SMTP, log, and pluggable transports",
   "type": "module",
   "main": "./dist/index.js",
@@ -68,7 +68,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.10",
-    "@c9up/bay": "^0.1.13",
+    "@c9up/bay": "^0.2.0",
     "@c9up/helix": "^0.2.0",
     "@c9up/ream": "^0.2.0",
     "@types/node": "*",

package/src/RoverProvider.ts

@@ -2,7 +2,7 @@ import "./augmentations.js";
 import type { EmitterLike, MailConfig } from "./Mail.js";
 import { Mail } from "./Mail.js";
 import type { BayQueueLike } from "./queue/MailJob.js";
-import { setMail } from "./services/main.js";
+import { clearMail, getMail, setMail } from "./services/main.js";
 
 /**
  * Duck-typed slice of the host's IoC container — rover does NOT import
@@ -11,6 +11,12 @@ import { setMail } from "./services/main.js";
 interface RoverContainer {
 	singleton(token: unknown, factory: () => unknown): void;
 	resolve<T = unknown>(token: unknown): Promise<T>;
+	/**
+	 * Optional reader — present on ream's real container. Asked before resolving
+	 * an OPTIONAL peer, so "not installed" is answered by a lookup rather than
+	 * inferred from whatever resolving it threw.
+	 */
+	has?(token: unknown): boolean;
 }
 interface RoverConfigStore {
 	get<T = unknown>(key: string): T | undefined;
@@ -21,6 +27,9 @@ export interface RoverAppContext {
 }
 
 export default class RoverProvider {
+	/** The Mail this provider bound, so shutdown only clears its own. */
+	#mail: Mail | undefined;
+
 	constructor(protected app: RoverAppContext) {}
 
 	register() {
@@ -58,10 +67,19 @@ export default class RoverProvider {
 		// Populate the `@c9up/rover/services/main` singleton with the
 		// container-resolved Mail instance so apps can
 		// `import mail from '@c9up/rover/services/main'` from anywhere.
-		setMail(await this.app.container.resolve<Mail>(Mail));
+		const mail = await this.app.container.resolve<Mail>(Mail);
+		this.#mail = mail;
+		setMail(mail);
 	}
 
-	async shutdown() {}
+	async shutdown() {
+		// Release the module-level singleton, but only while it is still ours: a
+		// stopped application left a dead Mail reachable through
+		// `services/main`, and with two applications in one process the one
+		// shutting down must not clear a binding the other has since installed.
+		if (this.#mail !== undefined && getMail() === this.#mail) clearMail();
+		this.#mail = undefined;
+	}
 }
 
 /**
@@ -73,9 +91,14 @@ async function tryResolve<T>(
 	app: RoverAppContext,
 	token: string,
 ): Promise<T | undefined> {
-	try {
-		return await app.container.resolve<T>(token);
-	} catch {
+	// ASK whether the token is bound, rather than catching whatever resolving it
+	// throws. Catching everything meant a registered binding whose factory
+	// failed — a bad queue config, a driver that cannot connect — read exactly
+	// like "bay is not installed": rover disabled the feature and said nothing,
+	// and mail queued nowhere. Absence is a `has()` answer; a factory that
+	// throws is a fault, and faults propagate.
+	if (typeof app.container.has === "function" && !app.container.has(token)) {
 		return undefined;
 	}
+	return await app.container.resolve<T>(token);
 }

package/src/services/main.ts

@@ -25,6 +25,18 @@ export function getMail(): Mail | undefined {
 	return instance;
 }
 
+/**
+ * @internal Release the singleton, so a shut-down application does not leave a
+ * dead Mail reachable through `services/main`.
+ *
+ * The caller checks ownership first (`getMail() === mine`): with two
+ * applications in one process, the one shutting down must not clear a binding
+ * the other has since installed.
+ */
+export function clearMail(): void {
+	instance = undefined;
+}
+
 const mail: Mail = new Proxy({} as Mail, {
 	get(_target, prop) {
 		if (!instance) {

package/src/templating/loadNapi.ts

@@ -8,25 +8,21 @@
 // — every boundary is narrowed with a `Reflect.get` type guard.
 
 import { createRequire } from "node:module";
-import { arch, platform } from "node:process";
 import { fileURLToPath } from "node:url";
 import { RoverError } from "../RoverError.js";
-
-const SUFFIX_MAP: Readonly<Record<string, string>> = {
-	"linux-x64": "linux-x64-gnu",
-	"linux-arm64": "linux-arm64-gnu",
-	"darwin-x64": "darwin-x64",
-	"darwin-arm64": "darwin-arm64",
-	"win32-x64": "win32-x64-msvc",
-};
+import {
+	muslHint,
+	nativeBinarySuffix,
+	supportedTargets,
+} from "../vendor/nativeBinary.js";
 
 function platformSuffix(): string {
-	const key = `${platform}-${arch}`;
-	const suffix = SUFFIX_MAP[key];
-	if (typeof suffix !== "string") {
+	// The table is shared; the refusal is rover's, with rover's code on it.
+	const suffix = nativeBinarySuffix();
+	if (suffix === undefined) {
 		throw new RoverError(
 			"E_MAIL_TEMPLATE_NAPI_REQUIRED",
-			`Unsupported platform/arch '${key}' for @c9up/rover native binary. Supported: ${Object.keys(SUFFIX_MAP).join(", ")}.`,
+			`No @c9up/rover native binary for this platform. Supported: ${supportedTargets().join(", ")}.`,
 			{
 				hint: "Build the native binary on a supported platform with 'pnpm --filter @c9up/rover build:napi'.",
 			},
@@ -83,12 +79,10 @@ export function getNative(): NativeExports {
 		// The prebuilt linux binaries target glibc (`-gnu`). On musl hosts (Alpine
 		// containers) the `-gnu` binary fails to dlopen with a libc symbol error —
 		// surface that explicitly rather than only pointing at the build step.
-		const muslHint = suffix.endsWith("-gnu")
-			? " If you are on Alpine/musl, note the prebuilt binaries target glibc (musl is not a supported target)."
-			: "";
+		const musl = muslHint();
 		throw new RoverError(
 			"E_MAIL_TEMPLATE_NAPI_REQUIRED",
-			`@c9up/rover native binary 'index.${suffix}.node' not found or failed to load near ${here} — run 'pnpm --filter @c9up/rover build:napi' to build it.${muslHint} Cause: ${causeMessage}`,
+			`@c9up/rover native binary 'index.${suffix}.node' not found or failed to load near ${here} — run 'pnpm --filter @c9up/rover build:napi' to build it.${musl} Cause: ${causeMessage}`,
 			{
 				hint: "Run 'pnpm --filter @c9up/rover build:napi' to compile the native template engine.",
 			},

package/src/vendor/nativeBinary.ts

@@ -0,0 +1,110 @@
+// Generated from scripts/vendor/nativeBinary.ts — do not edit.
+//
+// This package is published and built from its own repository, so the file
+// has to exist here rather than be imported. `pnpm vendor:sync` rewrites it,
+// and `pnpm vendor:check` fails if this copy has drifted from the original.
+
+/**
+ * Finding the NAPI binary a package ships beside itself.
+ *
+ * Every package with a Rust engine repeats the same table: napi-rs names its
+ * artefacts `index.<platform>-<arch>-<abi>.node`, and the mapping from Node's
+ * `platform`/`arch` to that suffix is the part that must never differ between
+ * packages. Adding a target means adding it everywhere, and a package that
+ * missed the edit fails only on that platform — which is exactly the failure
+ * nobody reproduces.
+ *
+ * What is NOT here is the policy. Some packages degrade when the binary is
+ * absent and answer `undefined`; others refuse loudly with build instructions.
+ * Both are right for their package, so the loader reports what happened and
+ * the caller decides.
+ */
+
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { arch, platform } from "node:process";
+import { fileURLToPath } from "node:url";
+
+/** Node's `platform-arch` → the suffix napi-rs builds under. */
+const TARGETS: Record<string, string> = {
+	"linux-x64": "linux-x64-gnu",
+	"linux-arm64": "linux-arm64-gnu",
+	"darwin-x64": "darwin-x64",
+	"darwin-arm64": "darwin-arm64",
+	"win32-x64": "win32-x64-msvc",
+};
+
+/**
+ * Every `platform-arch` a binary is built for.
+ *
+ * For the message a package raises when it refuses: "no binary for
+ * linux-riscv64" is only actionable next to the list of what there IS.
+ */
+export function supportedTargets(): readonly string[] {
+	return Object.keys(TARGETS);
+}
+
+/** The suffix a given `platform-arch` builds under, or `undefined`. */
+export function nativeTargetSuffix(target: string): string | undefined {
+	return TARGETS[target];
+}
+
+/** The suffix for THIS platform, or `undefined` where no binary is built. */
+export function nativeBinarySuffix(): string | undefined {
+	return nativeTargetSuffix(`${platform}-${arch}`);
+}
+
+/**
+ * Why the binary is not there, phrased for whoever has to fix it.
+ *
+ * "not found" and "not built for your platform" call for different actions,
+ * and a single "unavailable" leaves the reader to guess which one they are
+ * looking at.
+ */
+export function unavailableReason(cause?: unknown): string {
+	if (cause !== undefined) {
+		return `failed to load (${cause instanceof Error ? cause.message : String(cause)})`;
+	}
+	const target = `${platform}-${arch}`;
+	return nativeTargetSuffix(target) !== undefined
+		? "binary not found"
+		: `no prebuilt binary for ${target}`;
+}
+
+/**
+ * `musl` builds under a different suffix, and the failure is otherwise
+ * baffling: the file is there, and `require` still refuses it. Worth saying so
+ * in a message rather than leaving a reader to discover glibc.
+ */
+export function muslHint(): string {
+	return platform === "linux"
+		? " On Alpine/musl, the gnu binary will not load — build the musl target."
+		: "";
+}
+
+/** What a load attempt did, so the caller can apply its own policy. */
+export type NativeBinaryResult<T> =
+	| { loaded: true; binary: T }
+	| { loaded: false; suffix: string | undefined; cause?: unknown };
+
+/**
+ * Load `<package root>/index.<suffix>.node`.
+ *
+ * The path is fixed rather than passed: this file is generated into
+ * `<package>/src/vendor/`, so the package root is always two levels up, from
+ * `src` and from `dist` alike.
+ */
+export function loadNativeBinary<T>(): NativeBinaryResult<T> {
+	const suffix = nativeBinarySuffix();
+	if (suffix === undefined) return { loaded: false, suffix };
+	const here = dirname(fileURLToPath(import.meta.url));
+	try {
+		const nodeRequire = createRequire(import.meta.url);
+		return {
+			loaded: true,
+			binary: nodeRequire(join(here, `../../index.${suffix}.node`)) as T,
+		};
+	} catch (cause) {
+		return { loaded: false, suffix, cause };
+	}
+}