@c9up/eon 0.2.8 → 0.2.10

package/dist/EonProvider.d.ts

@@ -34,6 +34,16 @@ export interface EonAppContext {
     config: {
         get<T = unknown>(key: string): T | undefined;
     };
+    /**
+     * Optional reader — present on ream's real application.
+     *
+     * `'warmup'` means the application was assembled to be INSPECTED rather than
+     * run: a route listing, a codegen pass, a config dump. Providers register,
+     * boot and start on that path too, so anything that opens a socket or
+     * creates a database has to ask first. A host that does not implement it is
+     * treated as running.
+     */
+    getMode?(): string;
 }
 /**
  * The transport-independent compiler service registered under `eon.compiler`.

package/dist/EonProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EonProvider.d.ts","sourceRoot":"","sources":["../src/EonProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAa,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,EACN,KAAK,iBAAiB,EAEtB,KAAK,UAAU,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE;QACV,SAAS,CACR,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,EAC5D,OAAO,EAAE,MAAM,OAAO,GACpB,IAAI,CAAC;QACR;;;;WAIG;QACH,OAAO,CAAC,CACP,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,GAC1D,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAC9B,CAAC;IACF,MAAM,EAAE;QAAE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,iBAAiB,CAAC;CAC/D;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAC1B,MAAM,EAAE,mBAAmB,KACvB,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,qBAAa,WAAW;;gBAQX,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,YAA2B;IAKpE,QAAQ,IAAI,IAAI;IAEV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmIrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAgF/B;AAID,eAAe,WAAW,CAAC"}
+{"version":3,"file":"EonProvider.d.ts","sourceRoot":"","sources":["../src/EonProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAa,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,EACN,KAAK,iBAAiB,EAEtB,KAAK,UAAU,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE;QACV,SAAS,CACR,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,EAC5D,OAAO,EAAE,MAAM,OAAO,GACpB,IAAI,CAAC;QACR;;;;WAIG;QACH,OAAO,CAAC,CACP,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,GAC1D,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAC9B,CAAC;IACF,MAAM,EAAE;QAAE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;IACzD;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,iBAAiB,CAAC;CAC/D;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAC1B,MAAM,EAAE,mBAAmB,KACvB,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,qBAAa,WAAW;;gBAUX,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,YAA2B;IAKpE,QAAQ,IAAI,IAAI;IAgFV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuNrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAkF/B;AAID,eAAe,WAAW,CAAC"}

package/dist/EonProvider.js

@@ -22,20 +22,90 @@ export class EonProvider {
     #connections = new Map();
     /** Set once a full boot opened connections — guards against a leaking re-boot. */
     #booted = false;
+    /** What the `eon` / `eon.connection` tokens resolve to, once boot opened it. */
+    #defaultConnection;
     constructor(app, connect = connectWsEon) {
         this.#app = app;
         this.#connect = connect;
     }
-    register() { }
-    async boot() {
-        if (this.#booted) {
-            throw new Error("EonProvider: boot() has already opened connections; a second boot would overwrite and leak them. Call shutdown() first, or construct a new provider.");
-        }
-        // The compiler is transport-independent — register it unconditionally.
+    register() {
+        // Bindings belong here, not in boot(). Upstream registers in `register`
+        // precisely so another provider can count on them during its own boot;
+        // bound in boot, the container had a different surface depending on
+        // which provider ran first, and `eon.compiler` was simply unavailable to
+        // anything booting earlier.
+        //
+        // It is also pure — a compile is a call into the native compiler, no
+        // socket, no database — so there is nothing here an inspection must
+        // avoid.
         const service = {
             compile: (spec, dialect) => compileStatementNative(spec, dialect),
         };
         this.#app.container.singleton("eon.compiler", () => service);
+        // The connection tokens are registered here too, so the surface does not
+        // change between warmup and run. What they RESOLVE to still depends on
+        // boot having opened something — a lazy factory cannot await — so
+        // reading one too early says what to do instead of answering undefined.
+        this.#app.container.singleton("eon", () => this.#requireDefault("eon"));
+        this.#app.container.singleton("eon.connection", () => this.#requireDefault("eon.connection"));
+        // The NAMED tokens too. Their names come from the config, which is
+        // readable here — nothing about `eon:primary` needs a socket to exist.
+        // Bound in boot they appeared only on the run path, so the container had
+        // a different surface in an inspection, and a boot that failed late left
+        // factories behind pointing at connections it had just closed.
+        const config = this.#app.config.get("timeseries") ??
+            this.#app.config.get("eon");
+        if (!config)
+            return;
+        for (const name of Object.keys(this.#resolveConnections(config).connections)) {
+            this.#app.container.singleton(`eon:${name}`, () => this.#requireNamed(name));
+        }
+    }
+    /**
+     * A named connection, or a message saying what is missing.
+     *
+     * Same reasoning as {@link #requireDefault}: resolving to `undefined` sent
+     * the caller into a TypeError several frames from the cause.
+     */
+    #requireNamed(name) {
+        const connection = this.#connections.get(name);
+        if (connection === undefined) {
+            throw new Error(`EonProvider: connection '${name}' was resolved before it was opened. Connections open in boot(); check that config.timeseries.connections defines '${name}' and that EonProvider is listed before whatever resolved this.`);
+        }
+        return connection;
+    }
+    /**
+     * The default connection, or a message naming what is missing.
+     *
+     * Resolving to `undefined` sent the caller into a `TypeError` several
+     * frames away from the cause — a provider that resolved eon during its own
+     * boot, or an application with no `config/timeseries.ts` at all.
+     */
+    #requireDefault(token) {
+        const connection = this.#defaultConnection;
+        if (connection === undefined) {
+            throw new Error(`EonProvider: '${token}' was resolved before any connection was opened. Connections open in boot(); check that config.timeseries defines one and that EonProvider is listed before whatever resolved this.`);
+        }
+        return connection;
+    }
+    /** True when the application was assembled to be inspected rather than run. */
+    #isInspecting() {
+        return this.#app.getMode?.() === "warmup";
+    }
+    async boot() {
+        // An inspection opens no WebSocket and creates no database. `warmUp()`
+        // runs boot, so a route listing reached TDengine — and could CREATE a
+        // database there — while `shutdown()` never fires on that path, leaving
+        // the sockets open. The compiler binding below is pure and stays.
+        if (this.#booted) {
+            throw new Error("EonProvider: boot() has already opened connections; a second boot would overwrite and leak them. Call shutdown() first, or construct a new provider.");
+        }
+        // Everything here opens a socket or creates a database, so an
+        // inspection stops at the compiler. `warmUp()` runs boot, so a route
+        // listing reached TDengine — and could CREATE a database there — while
+        // `shutdown()` never fires on that path, leaving the sockets open.
+        if (this.#isInspecting())
+            return;
         const config = this.#app.config.get("timeseries") ??
             this.#app.config.get("eon");
         if (!config)
@@ -83,22 +153,63 @@ export class EonProvider {
             this.#connections.clear();
             throw new Error(`EonProvider: default connection '${defaultName}' is not defined in config.timeseries.connections`);
         }
-        // Register the container singletons only AFTER validation succeeds. The
-        // throw path above registers none, so a failed boot never leaves an
-        // `eon:<name>` factory resolving to a now-closed connection.
-        for (const { name, conn } of successes) {
-            this.#app.container.singleton(`eon:${name}`, () => conn);
-        }
-        this.#app.container.singleton("eon", () => defaultConn);
-        this.#app.container.singleton("eon.connection", () => defaultConn);
-        // Populate the `@c9up/eon/services/connection` singleton so apps can
-        // `import connection from '@c9up/eon/services/connection'` anywhere. Lazy
-        // import so a type-only discovery scan does not pull the module at
-        // construction time.
-        const { setConnection } = await import("./services/connection.js");
-        setConnection(defaultConn);
-        await this.#registerMigrationSource(defaultConn, config);
-        this.#booted = true;
+        // Everything past this point runs with the sockets ALREADY OPEN, and any
+        // of it can fail: importing the services module, registering the
+        // migration source. Without this the failure left the connections open,
+        // possibly the module singleton published, and `#booted` false — so the
+        // next attempt opened another set on top of the ones nobody could reach.
+        try {
+            // The tokens were all bound in `register()`; this is what they
+            // resolve to. Filling the map is what makes them answer.
+            this.#defaultConnection = defaultConn;
+            // Populate the `@c9up/eon/services/connection` singleton so apps can
+            // `import connection from '@c9up/eon/services/connection'` anywhere.
+            // Lazy import so a type-only discovery scan does not pull the module
+            // at construction time.
+            const { setConnection } = await import("./services/connection.js");
+            setConnection(defaultConn);
+            await this.#registerMigrationSource(defaultConn, config);
+            this.#booted = true;
+        }
+        catch (error) {
+            await this.#rollbackBoot(defaultConn);
+            throw error;
+        }
+    }
+    /**
+     * Undo a boot that opened its connections and then failed.
+     *
+     * Everything this releases was created by THIS attempt, so a retry starts
+     * from nothing rather than from a half-assembled state. The module
+     * singleton is released only while it is still the one we published — two
+     * applications can share a process, and the survivor's connection must
+     * stay.
+     */
+    async #rollbackBoot(published) {
+        await this.#releaseMigrationSource();
+        // The connector keeps PROCESS-GLOBAL handles, so closing the individual
+        // connections is not enough to let Node exit — shutdown() says so and
+        // destroys them; a failed boot left them behind and the process hung.
+        const hadWebsocket = [...this.#connections.values()].some((conn) => conn.transport === "websocket");
+        try {
+            const { clearConnection } = await import("./services/connection.js");
+            clearConnection(published);
+        }
+        catch {
+            // The module could not be loaded, so nothing was published from it.
+        }
+        this.#defaultConnection = undefined;
+        await Promise.allSettled([...this.#connections.values()].map((conn) => conn.close()));
+        this.#connections.clear();
+        if (hadWebsocket) {
+            try {
+                const { destroyEonConnector } = await import("./connection/websocket.js");
+                await destroyEonConnector();
+            }
+            catch {
+                // A fake-only boot never pulled the connector in.
+            }
+        }
     }
     /**
      * Hand eon's migration runner to the framework's `migrations` registry, so
@@ -128,20 +239,52 @@ export class EonProvider {
         }
         const { EonMigrationRunner } = await import("./schema/EonMigrationRunner.js");
         const migrationsDir = config.migrationsDir ?? "database/eon-migrations";
-        registry.register({
+        const source = {
             name: "eon",
             directory: migrationsDir,
             runner: new EonMigrationRunner(conn, { migrationsDir }),
-        });
+        };
+        registry.register(source);
+        // Kept so shutdown can hand the name back. Registering refuses a
+        // duplicate, so a provider that stops without releasing its name leaves
+        // a second boot in the same process failing on "already registered" —
+        // and the CLI driving a runner that holds a closed connection.
+        this.#migrationSource = source;
+    }
+    /** What this provider registered with the host's migration registry. */
+    #migrationSource;
+    /** Give the migration name back, while it is still ours. */
+    async #releaseMigrationSource() {
+        const source = this.#migrationSource;
+        if (source === undefined)
+            return;
+        this.#migrationSource = undefined;
+        const resolve = this.#app.container.resolve;
+        if (typeof resolve !== "function")
+            return;
+        try {
+            const registry = await resolve.call(this.#app.container, "migrations");
+            if (typeof registry === "object" &&
+                registry !== null &&
+                typeof Reflect.get(registry, "unregister") === "function") {
+                registry.unregister("eon", source);
+            }
+        }
+        catch {
+            // No registry, or an older host without `unregister`: nothing to give
+            // back, and a shutdown must not fail over it.
+        }
     }
     async shutdown() {
         // Close every connection in parallel. `allSettled` (fail-open) so a single
         // stuck close doesn't block the rest, but failures are aggregated and
         // rethrown so supervisors see a non-zero shutdown signal. The map + module
         // singleton are cleared unconditionally (never hand out closed handles).
+        await this.#releaseMigrationSource();
         const named = [...this.#connections.entries()];
         const results = await Promise.allSettled(named.map(([, c]) => c.close()));
         this.#connections.clear();
+        this.#defaultConnection = undefined;
         this.#booted = false; // allow a fresh boot() after a clean shutdown
         const { clearConnection } = await import("./services/connection.js");
         for (const [, conn] of named)

package/dist/EonProvider.js.map

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

package/dist/query/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/query/native.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH,sEAAsE;AACtE,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,CAAC;CAClB;AA6HD;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,UAAuB,GAC9B,iBAAiB,CAKnB;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/query/native.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,sEAAsE;AACtE,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,CAAC;CAClB;AA0HD;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,UAAuB,GAC9B,iBAAiB,CAKnB;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/query/native.js

@@ -7,19 +7,7 @@
  * throws a descriptive error naming the attempted path — never a silent `null`.
  */
 import { randomUUID } from "node:crypto";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-import { arch, platform } from "node:process";
-import { fileURLToPath } from "node:url";
-const require2 = createRequire(import.meta.url);
-const here = dirname(fileURLToPath(import.meta.url));
-const platformMap = {
-    "linux-x64": "linux-x64-gnu",
-    "linux-arm64": "linux-arm64-gnu",
-    "darwin-x64": "darwin-x64",
-    "darwin-arm64": "darwin-arm64",
-    "win32-x64": "win32-x64-msvc",
-};
+import { loadNativeBinary, muslHint, supportedTargets, } from "../vendor/nativeBinary.js";
 let native;
 /**
  * Resolve and cache the NAPI binding. Throws a descriptive error on an
@@ -30,21 +18,17 @@ let native;
 function loadNative() {
     if (native)
         return native;
-    const key = `${platform}-${arch}`;
-    const suffix = platformMap[key];
-    if (!suffix) {
-        throw new Error(`[E_EON_NAPI_UNSUPPORTED] no eon-query native binary for platform '${key}'. Supported: ${Object.keys(platformMap).join(", ")}.`);
-    }
-    const binaryPath = join(here, `../../index.${suffix}.node`);
-    let binding;
-    try {
-        binding = require2(binaryPath);
-    }
-    catch (cause) {
-        throw new Error(`[E_EON_NAPI_NOT_FOUND] eon-query native binary not found at '${binaryPath}'. Build it with: pnpm --filter @c9up/eon build:napi`, cause !== undefined ? { cause } : undefined);
+    // The resolution is shared; the refusal is not. Both codes below are eon's,
+    // and a caller branches on them.
+    const attempt = loadNativeBinary();
+    if (!attempt.loaded) {
+        if (attempt.suffix === undefined) {
+            throw new Error(`[E_EON_NAPI_UNSUPPORTED] no eon-query native binary for this platform. Supported: ${supportedTargets().join(", ")}.`);
+        }
+        throw new Error(`[E_EON_NAPI_NOT_FOUND] eon-query native binary 'index.${attempt.suffix}.node' not found or unloadable.${muslHint()} Build it with: pnpm --filter @c9up/eon build:napi`, attempt.cause !== undefined ? { cause: attempt.cause } : undefined);
     }
-    native = binding;
-    return binding;
+    native = attempt.binary;
+    return attempt.binary;
 }
 /**
  * i64 / nanosecond-timestamp precision guard for the JSON compile boundary.

package/dist/query/native.js.map

@@ -1 +1 @@
-{"version":3,"file":"native.js","sourceRoot":"","sources":["../../src/query/native.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../src/query/native.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/eon",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "Eon — time-series data layer for the Ream framework (TDengine-backed)",
   "license": "MIT",
   "type": "module",
@@ -59,6 +59,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.4.10",
     "@types/node": "^22",
+    "@vitest/coverage-v8": "^4.1.2",
     "tsx": "^4.19.0",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
@@ -93,7 +94,7 @@
     "build:napi-types": "node scripts/build-napi-types.mjs",
     "test": "vitest run",
     "test:rust": "cargo test -p eon-query",
-    "lint": "biome check src/",
+    "lint": "biome check src/ tests/",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit"
   }

package/src/EonProvider.ts

@@ -45,6 +45,16 @@ export interface EonAppContext {
 		): unknown | Promise<unknown>;
 	};
 	config: { get<T = unknown>(key: string): T | undefined };
+	/**
+	 * Optional reader — present on ream's real application.
+	 *
+	 * `'warmup'` means the application was assembled to be INSPECTED rather than
+	 * run: a route listing, a codegen pass, a config dump. Providers register,
+	 * boot and start on that path too, so anything that opens a socket or
+	 * creates a database has to ask first. A host that does not implement it is
+	 * treated as running.
+	 */
+	getMode?(): string;
 }
 
 /**
@@ -70,25 +80,109 @@ export class EonProvider {
 	readonly #connections = new Map<string, EonConnection>();
 	/** Set once a full boot opened connections — guards against a leaking re-boot. */
 	#booted = false;
+	/** What the `eon` / `eon.connection` tokens resolve to, once boot opened it. */
+	#defaultConnection?: EonConnection;
 
 	constructor(app: EonAppContext, connect: EonConnector = connectWsEon) {
 		this.#app = app;
 		this.#connect = connect;
 	}
 
-	register(): void {}
+	register(): void {
+		// Bindings belong here, not in boot(). Upstream registers in `register`
+		// precisely so another provider can count on them during its own boot;
+		// bound in boot, the container had a different surface depending on
+		// which provider ran first, and `eon.compiler` was simply unavailable to
+		// anything booting earlier.
+		//
+		// It is also pure — a compile is a call into the native compiler, no
+		// socket, no database — so there is nothing here an inspection must
+		// avoid.
+		const service: EonService = {
+			compile: (spec, dialect) => compileStatementNative(spec, dialect),
+		};
+		this.#app.container.singleton("eon.compiler", () => service);
+
+		// The connection tokens are registered here too, so the surface does not
+		// change between warmup and run. What they RESOLVE to still depends on
+		// boot having opened something — a lazy factory cannot await — so
+		// reading one too early says what to do instead of answering undefined.
+		this.#app.container.singleton("eon", () => this.#requireDefault("eon"));
+		this.#app.container.singleton("eon.connection", () =>
+			this.#requireDefault("eon.connection"),
+		);
+
+		// The NAMED tokens too. Their names come from the config, which is
+		// readable here — nothing about `eon:primary` needs a socket to exist.
+		// Bound in boot they appeared only on the run path, so the container had
+		// a different surface in an inspection, and a boot that failed late left
+		// factories behind pointing at connections it had just closed.
+		const config =
+			this.#app.config.get<EonConfig>("timeseries") ??
+			this.#app.config.get<EonConfig>("eon");
+		if (!config) return;
+		for (const name of Object.keys(
+			this.#resolveConnections(config).connections,
+		)) {
+			this.#app.container.singleton(`eon:${name}`, () =>
+				this.#requireNamed(name),
+			);
+		}
+	}
+
+	/**
+	 * A named connection, or a message saying what is missing.
+	 *
+	 * Same reasoning as {@link #requireDefault}: resolving to `undefined` sent
+	 * the caller into a TypeError several frames from the cause.
+	 */
+	#requireNamed(name: string): EonConnection {
+		const connection = this.#connections.get(name);
+		if (connection === undefined) {
+			throw new Error(
+				`EonProvider: connection '${name}' was resolved before it was opened. Connections open in boot(); check that config.timeseries.connections defines '${name}' and that EonProvider is listed before whatever resolved this.`,
+			);
+		}
+		return connection;
+	}
+
+	/**
+	 * The default connection, or a message naming what is missing.
+	 *
+	 * Resolving to `undefined` sent the caller into a `TypeError` several
+	 * frames away from the cause — a provider that resolved eon during its own
+	 * boot, or an application with no `config/timeseries.ts` at all.
+	 */
+	#requireDefault(token: string): EonConnection {
+		const connection = this.#defaultConnection;
+		if (connection === undefined) {
+			throw new Error(
+				`EonProvider: '${token}' was resolved before any connection was opened. Connections open in boot(); check that config.timeseries defines one and that EonProvider is listed before whatever resolved this.`,
+			);
+		}
+		return connection;
+	}
+
+	/** True when the application was assembled to be inspected rather than run. */
+	#isInspecting(): boolean {
+		return this.#app.getMode?.() === "warmup";
+	}
 
 	async boot(): Promise<void> {
+		// An inspection opens no WebSocket and creates no database. `warmUp()`
+		// runs boot, so a route listing reached TDengine — and could CREATE a
+		// database there — while `shutdown()` never fires on that path, leaving
+		// the sockets open. The compiler binding below is pure and stays.
 		if (this.#booted) {
 			throw new Error(
 				"EonProvider: boot() has already opened connections; a second boot would overwrite and leak them. Call shutdown() first, or construct a new provider.",
 			);
 		}
-		// The compiler is transport-independent — register it unconditionally.
-		const service: EonService = {
-			compile: (spec, dialect) => compileStatementNative(spec, dialect),
-		};
-		this.#app.container.singleton("eon.compiler", () => service);
+		// Everything here opens a socket or creates a database, so an
+		// inspection stops at the compiler. `warmUp()` runs boot, so a route
+		// listing reached TDengine — and could CREATE a database there — while
+		// `shutdown()` never fires on that path, leaving the sockets open.
+		if (this.#isInspecting()) return;
 
 		const config =
 			this.#app.config.get<EonConfig>("timeseries") ??
@@ -147,24 +241,69 @@ export class EonProvider {
 				`EonProvider: default connection '${defaultName}' is not defined in config.timeseries.connections`,
 			);
 		}
-		// Register the container singletons only AFTER validation succeeds. The
-		// throw path above registers none, so a failed boot never leaves an
-		// `eon:<name>` factory resolving to a now-closed connection.
-		for (const { name, conn } of successes) {
-			this.#app.container.singleton(`eon:${name}`, () => conn);
+		// Everything past this point runs with the sockets ALREADY OPEN, and any
+		// of it can fail: importing the services module, registering the
+		// migration source. Without this the failure left the connections open,
+		// possibly the module singleton published, and `#booted` false — so the
+		// next attempt opened another set on top of the ones nobody could reach.
+		try {
+			// The tokens were all bound in `register()`; this is what they
+			// resolve to. Filling the map is what makes them answer.
+			this.#defaultConnection = defaultConn;
+
+			// Populate the `@c9up/eon/services/connection` singleton so apps can
+			// `import connection from '@c9up/eon/services/connection'` anywhere.
+			// Lazy import so a type-only discovery scan does not pull the module
+			// at construction time.
+			const { setConnection } = await import("./services/connection.js");
+			setConnection(defaultConn);
+
+			await this.#registerMigrationSource(defaultConn, config);
+			this.#booted = true;
+		} catch (error) {
+			await this.#rollbackBoot(defaultConn);
+			throw error;
+		}
+	}
+
+	/**
+	 * Undo a boot that opened its connections and then failed.
+	 *
+	 * Everything this releases was created by THIS attempt, so a retry starts
+	 * from nothing rather than from a half-assembled state. The module
+	 * singleton is released only while it is still the one we published — two
+	 * applications can share a process, and the survivor's connection must
+	 * stay.
+	 */
+	async #rollbackBoot(published: EonConnection): Promise<void> {
+		await this.#releaseMigrationSource();
+		// The connector keeps PROCESS-GLOBAL handles, so closing the individual
+		// connections is not enough to let Node exit — shutdown() says so and
+		// destroys them; a failed boot left them behind and the process hung.
+		const hadWebsocket = [...this.#connections.values()].some(
+			(conn) => conn.transport === "websocket",
+		);
+		try {
+			const { clearConnection } = await import("./services/connection.js");
+			clearConnection(published);
+		} catch {
+			// The module could not be loaded, so nothing was published from it.
+		}
+		this.#defaultConnection = undefined;
+		await Promise.allSettled(
+			[...this.#connections.values()].map((conn) => conn.close()),
+		);
+		this.#connections.clear();
+		if (hadWebsocket) {
+			try {
+				const { destroyEonConnector } = await import(
+					"./connection/websocket.js"
+				);
+				await destroyEonConnector();
+			} catch {
+				// A fake-only boot never pulled the connector in.
+			}
 		}
-		this.#app.container.singleton("eon", () => defaultConn);
-		this.#app.container.singleton("eon.connection", () => defaultConn);
-
-		// Populate the `@c9up/eon/services/connection` singleton so apps can
-		// `import connection from '@c9up/eon/services/connection'` anywhere. Lazy
-		// import so a type-only discovery scan does not pull the module at
-		// construction time.
-		const { setConnection } = await import("./services/connection.js");
-		setConnection(defaultConn);
-
-		await this.#registerMigrationSource(defaultConn, config);
-		this.#booted = true;
 	}
 
 	/**
@@ -202,11 +341,46 @@ export class EonProvider {
 			"./schema/EonMigrationRunner.js"
 		);
 		const migrationsDir = config.migrationsDir ?? "database/eon-migrations";
-		(registry.register as (source: unknown) => unknown)({
+		const source = {
 			name: "eon",
 			directory: migrationsDir,
 			runner: new EonMigrationRunner(conn, { migrationsDir }),
-		});
+		};
+		(registry.register as (source: unknown) => unknown)(source);
+		// Kept so shutdown can hand the name back. Registering refuses a
+		// duplicate, so a provider that stops without releasing its name leaves
+		// a second boot in the same process failing on "already registered" —
+		// and the CLI driving a runner that holds a closed connection.
+		this.#migrationSource = source;
+	}
+
+	/** What this provider registered with the host's migration registry. */
+	#migrationSource?: object;
+
+	/** Give the migration name back, while it is still ours. */
+	async #releaseMigrationSource(): Promise<void> {
+		const source = this.#migrationSource;
+		if (source === undefined) return;
+		this.#migrationSource = undefined;
+		const resolve = this.#app.container.resolve;
+		if (typeof resolve !== "function") return;
+		try {
+			const registry = await resolve.call(this.#app.container, "migrations");
+			if (
+				typeof registry === "object" &&
+				registry !== null &&
+				typeof Reflect.get(registry, "unregister") === "function"
+			) {
+				(
+					registry as {
+						unregister: (name: string, source?: unknown) => unknown;
+					}
+				).unregister("eon", source);
+			}
+		} catch {
+			// No registry, or an older host without `unregister`: nothing to give
+			// back, and a shutdown must not fail over it.
+		}
 	}
 
 	async shutdown(): Promise<void> {
@@ -214,9 +388,11 @@ export class EonProvider {
 		// stuck close doesn't block the rest, but failures are aggregated and
 		// rethrown so supervisors see a non-zero shutdown signal. The map + module
 		// singleton are cleared unconditionally (never hand out closed handles).
+		await this.#releaseMigrationSource();
 		const named = [...this.#connections.entries()];
 		const results = await Promise.allSettled(named.map(([, c]) => c.close()));
 		this.#connections.clear();
+		this.#defaultConnection = undefined;
 		this.#booted = false; // allow a fresh boot() after a clean shutdown
 
 		const { clearConnection } = await import("./services/connection.js");

package/src/query/native.ts

@@ -8,21 +8,11 @@
  */
 
 import { randomUUID } from "node:crypto";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-import { arch, platform } from "node:process";
-import { fileURLToPath } from "node:url";
-
-const require2 = createRequire(import.meta.url);
-const here = dirname(fileURLToPath(import.meta.url));
-
-const platformMap: 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 {
+	loadNativeBinary,
+	muslHint,
+	supportedTargets,
+} from "../vendor/nativeBinary.js";
 
 /**
  * The compiler's surface, as the Rust declares it.
@@ -51,25 +41,22 @@ let native: NativeBinding | undefined;
  */
 function loadNative(): NativeBinding {
 	if (native) return native;
-	const key = `${platform}-${arch}`;
-	const suffix = platformMap[key];
-	if (!suffix) {
-		throw new Error(
-			`[E_EON_NAPI_UNSUPPORTED] no eon-query native binary for platform '${key}'. Supported: ${Object.keys(platformMap).join(", ")}.`,
-		);
-	}
-	const binaryPath = join(here, `../../index.${suffix}.node`);
-	let binding: NativeBinding;
-	try {
-		binding = require2(binaryPath);
-	} catch (cause) {
+	// The resolution is shared; the refusal is not. Both codes below are eon's,
+	// and a caller branches on them.
+	const attempt = loadNativeBinary<NativeBinding>();
+	if (!attempt.loaded) {
+		if (attempt.suffix === undefined) {
+			throw new Error(
+				`[E_EON_NAPI_UNSUPPORTED] no eon-query native binary for this platform. Supported: ${supportedTargets().join(", ")}.`,
+			);
+		}
 		throw new Error(
-			`[E_EON_NAPI_NOT_FOUND] eon-query native binary not found at '${binaryPath}'. Build it with: pnpm --filter @c9up/eon build:napi`,
-			cause !== undefined ? { cause } : undefined,
+			`[E_EON_NAPI_NOT_FOUND] eon-query native binary 'index.${attempt.suffix}.node' not found or unloadable.${muslHint()} Build it with: pnpm --filter @c9up/eon build:napi`,
+			attempt.cause !== undefined ? { cause: attempt.cause } : undefined,
 		);
 	}
-	native = binding;
-	return binding;
+	native = attempt.binary;
+	return attempt.binary;
 }
 
 /**

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 };
+	}
+}