@nwire/endpoint 0.9.1 → 0.10.0

package/dist/endpoint.js

@@ -34,8 +34,11 @@
  * write the same K8s-readiness code on every project. It works alone —
  * install only this package and wrap any Node server.
  */
+import { createServer as createHttpServer } from "node:http";
 import { hook } from "@nwire/hooks";
+import { ConsoleLogger } from "@nwire/logger";
 import { attachLifecycle, } from "./lifecycle.js";
+import { isAdapter } from "./adapter.js";
 // ─── Builder API ──────────────────────────────────────────────────────────
 /**
  * Build an endpoint. The returned builder is chainable: `.serve()` adds
@@ -60,13 +63,24 @@ import { attachLifecycle, } from "./lifecycle.js";
 export function endpoint(name, config = {}) {
     return new EndpointBuilder(name, config);
 }
+function isInterfaceShape(x) {
+    return (typeof x === "object" &&
+        x !== null &&
+        x.$kind === "interface" &&
+        Array.isArray(x.wires));
+}
+function isAppWithInterface(x) {
+    return isAppServable(x) && isInterfaceShape(x.interface);
+}
 /** Internal builder; users get one via {@link endpoint}. */
 export class EndpointBuilder {
     name;
     config;
     apps = [];
-    nwireServables = [];
     foreignServables = [];
+    // ─── New-shape state (.use / .mount) ─────────────────────────────────
+    adapters = [];
+    mounted;
     /**
      * Per-phase lifecycle hooks. Created lazily at builder-construction so
      * they appear in `listHooks()` (and `.nwire/hooks.json` after scan)
@@ -100,22 +114,53 @@ export class EndpointBuilder {
         }, { name: "shutdown" });
     }
     /**
-     * Add something to serve. Multiple calls compose. Apps are booted first
-     * (any order between them is OK — boot order matters within an app, not
-     * across them), then Nwire interfaces and foreign apps are attached.
+     * Add something to serve. Multiple calls compose — an App boots its
+     * container/plugins; a framework app (Express/Fastify/Nest) attaches
+     * as a foreign listener so its routing system runs side by side. For
+     * Nwire wire-collections, use `.use(adopter).mount(app)`.
      */
     serve(target) {
         if (isAppServable(target)) {
             this.apps.push(target);
         }
-        else if (isNwireServable(target)) {
-            this.nwireServables.push(target);
-        }
         else if (isForeignServable(target)) {
             this.foreignServables.push(target);
         }
         else {
-            throw new Error(`endpoint("${this.name}").serve(): target is not a Nwire app, Nwire interface, or framework app.`);
+            throw new Error(`endpoint("${this.name}").serve(): target is not a Nwire app or a framework app.`);
+        }
+        return this;
+    }
+    /**
+     * Install a transport adopter — an `Adapter` value produced by an
+     * adopter package (`httpKoa()`, `queueBullmq()`, `mcp()`, …). Multiple
+     * `.use()` calls compose; the endpoint hands each adopter its slice of
+     * wires from the mounted source at `.run()` time.
+     */
+    use(adopter) {
+        if (!isAdapter(adopter)) {
+            throw new Error(`endpoint("${this.name}").use(): expected an Adapter, got ${typeof adopter}.`);
+        }
+        this.adapters.push(adopter);
+        return this;
+    }
+    /**
+     * Mount the source whose wires the adopters consume. One source per
+     * endpoint — App or standalone Interface. For multi-app topologies,
+     * compose via `appCompose(...)` from `@nwire/app` and mount the result.
+     */
+    mount(source) {
+        if (this.mounted) {
+            throw new Error(`endpoint("${this.name}").mount(): a source is already mounted ("${"appName" in this.mounted ? this.mounted.appName : "interface"}"). ` +
+                `One source per endpoint — use appCompose(...) from "@nwire/app" to compose multiple apps.`);
+        }
+        if (!isAppWithInterface(source) && !isInterfaceShape(source)) {
+            throw new Error(`endpoint("${this.name}").mount(): expected an App with .interface, or a standalone Interface.`);
+        }
+        this.mounted = source;
+        // If mounting an App, also boot it via the existing apps array.
+        if (isAppWithInterface(source) && !this.apps.includes(source)) {
+            this.apps.push(source);
         }
         return this;
     }
@@ -157,101 +202,69 @@ export class EndpointBuilder {
         for (const app of this.apps) {
             await app.boot();
         }
-        // Helper to dispatch a lifecycle event on every served app's bus.
-        // Apps that don't expose `dispatchFrameworkEvent` are silently
-        // skipped (L2 standalone case has no apps; observers register on
-        // the app's bus so there's nothing to dispatch to).
-        const fireLifecycle = async (eventName, payload) => {
-            let allowed = true;
-            for (const app of this.apps) {
-                if (app.dispatchFrameworkEvent) {
-                    const ok = await app.dispatchFrameworkEvent(eventName, payload);
-                    if (!ok)
-                        allowed = false;
-                }
-            }
-            return allowed;
-        };
-        // The container the host hands to interfaces. If multiple apps were
-        // served, we use the first app's container as primary — interfaces
-        // can reach into others via `ctx.resolve` if those bindings exist.
-        // Most apps have one container; this case-edge is for BFFs.
-        //
-        // L2 path: no app served (`.serve(api)` on a bare httpInterface). The
-        // interface already has a container set via `.provide(...)`; we must
-        // NOT clobber it. Pass `undefined` so the interface's attach() can
-        // preserve its own provision.
+        // The container the host hands to each adopter — the first served
+        // app's. Multi-app composites carry per-wire app references that
+        // `containerOf(wire)` resolves to per dispatch.
         const container = this.apps[0]?.container;
-        // 2. Start the operating-system listener. For HTTP-class endpoints we
-        //    spin a single Node http.Server that hosts all NwireServables +
-        //    any ForeignServable. Workers-only endpoints skip the listener
-        //    entirely; the probes server is still available.
+        // 2. Start the foreign-framework listener when one was served, then
+        //    boot every adopter. Workers-only endpoints with no foreign app
+        //    skip the listener entirely; the probes server is still available.
         //
         // Fire the per-endpoint `serve` hook before any transport attaches —
         // tap observers see "serve phase starting" with the endpoint context.
-        // The existing `nwire.wire.mounting` / `mounted` framework events
-        // still fire below; the hook is an additive observation surface.
-        //
-        // Each `s.attach(...)` is wrapped with WireMounting (interceptable)
-        // and WireMounted (observable) so dev logger + Studio Live show
-        // every wire as it comes up.
         await this.serveHook.run({
             endpointName: this.name,
             phase: "serve",
             startedAt: new Date().toISOString(),
         });
         let server;
-        if (this.config.port !== undefined &&
-            (this.nwireServables.length || this.foreignServables.length)) {
-            // Pre-attach hook: fire WireMounting for each interface BEFORE
-            // startListener does the actual attach.
-            for (const s of this.nwireServables) {
-                const ok = await fireLifecycle("nwire.wire.mounting", {
-                    appName: this.apps[0]?.appName ?? this.name,
-                    transport: s.transport,
-                    manifest: undefined,
-                });
-                if (!ok) {
-                    throw new Error(`endpoint("${this.name}").serve(): wire "${s.transport}" mount prevented by a WireMounting subscriber.`);
-                }
-            }
+        if (this.config.port !== undefined && this.foreignServables.length) {
             server = await startListener({
                 port: this.config.port,
                 host: this.config.host,
-                nwireServables: this.nwireServables,
                 foreignServables: this.foreignServables,
+                container,
             });
-            // Post-attach: every wire is now attached. Fire WireMounted.
-            for (const s of this.nwireServables) {
-                await fireLifecycle("nwire.wire.mounted", {
-                    appName: this.apps[0]?.appName ?? this.name,
-                    transport: s.transport,
-                    manifest: undefined,
-                });
-            }
         }
-        else {
-            // Workers / queue / cron — attach NwireServables to a non-HTTP host.
-            for (const s of this.nwireServables) {
-                const ok = await fireLifecycle("nwire.wire.mounting", {
-                    appName: this.apps[0]?.appName ?? this.name,
-                    transport: s.transport,
-                    manifest: undefined,
-                });
-                if (!ok) {
-                    throw new Error(`endpoint("${this.name}").serve(): wire "${s.transport}" mount prevented by a WireMounting subscriber.`);
-                }
-                await s.attach({ addCheck: () => undefined });
-                await fireLifecycle("nwire.wire.mounted", {
-                    appName: this.apps[0]?.appName ?? this.name,
-                    transport: s.transport,
-                    manifest: undefined,
-                });
-            }
+        // ─── New-shape adopter boot ────────────────────────────────────────
+        // For each registered adopter, hand it its slice of wires + a
+        // containerOf resolver that maps each wire back to its source app's
+        // container (falling back to the endpoint's primary container).
+        const accumulatedChecks = [];
+        const adapterLogger = new ConsoleLogger();
+        const mountedSource = this.mounted;
+        if (this.adapters.length > 0 && !mountedSource) {
+            throw new Error(`endpoint("${this.name}"): .use(adopter) was called but no source is mounted. ` +
+                `Call .mount(app) before .run().`);
+        }
+        const sourceInterface = mountedSource === undefined
+            ? undefined
+            : isInterfaceShape(mountedSource)
+                ? mountedSource
+                : mountedSource.interface;
+        const containerOf = (_w) => {
+            // For 0.10 first pass, route every wire to the mounted source's
+            // container (if it's an App). Multi-app composites carry per-wire
+            // app references on the wire (.app); future work uses that for
+            // per-wire container routing.
+            const sourceApp = mountedSource && !isInterfaceShape(mountedSource) ? mountedSource : undefined;
+            const wireApp = _w.app;
+            return wireApp?.container ?? sourceApp?.container;
+        };
+        for (const adopter of this.adapters) {
+            const wires = sourceInterface?.forAdapter(adopter.kind) ?? [];
+            await adopter.boot({
+                wires,
+                containerOf,
+                logger: adapterLogger,
+                addCheck: (c) => accumulatedChecks.push(c),
+                port: this.config.port,
+                host: this.config.host,
+            });
         }
         // 3. Wrap the server (if any) with graceful shutdown + probes.
         const lifecycle = await attachLifecycle({
-            server: server ?? makeProbeOnlyServer(),
+            server: server ?? (await makeProbeOnlyServer()),
             shutdown: {
                 ...this.config.shutdown,
                 onShutdown: async () => {
@@ -270,26 +283,17 @@ export class EndpointBuilder {
                     catch {
                         /* swallow — shutdown must proceed */
                     }
-                    // Fire WireUnmounted for each interface BEFORE its shutdown
-                    // runs, so observers can record "wire stopping" with full
-                    // context. Errors during dispatch are swallowed — shutdown
-                    // must complete regardless.
-                    for (let i = this.nwireServables.length - 1; i >= 0; i--) {
-                        const s = this.nwireServables[i];
+                    // Adopter shutdowns in reverse use() order — each adopter
+                    // drains its in-flight work.
+                    for (let i = this.adapters.length - 1; i >= 0; i--) {
                         try {
-                            await fireLifecycle("nwire.wire.unmounted", {
-                                appName: this.apps[0]?.appName ?? this.name,
-                                transport: s.transport,
-                            });
+                            await this.adapters[i].shutdown();
                         }
-                        catch {
-                            /* swallow — shutdown must proceed */
+                        catch (err) {
+                            // eslint-disable-next-line no-console
+                            console.error(`[endpoint:${this.name}] adopter shutdown failed:`, err);
                         }
                     }
-                    // Interface shutdowns — let them disconnect cleanly.
-                    for (let i = this.nwireServables.length - 1; i >= 0; i--) {
-                        await this.nwireServables[i].shutdown?.();
-                    }
                     // Apps shutdown in reverse boot order.
                     for (let i = this.apps.length - 1; i >= 0; i--) {
                         await this.apps[i].shutdown();
@@ -300,19 +304,10 @@ export class EndpointBuilder {
             },
             health: {
                 ...this.config.probes,
-                checks: [
-                    ...(this.config.probes?.checks ?? []),
-                    ...this.nwireServables.flatMap((s) => s.checks ?? []),
-                ],
+                checks: this.config.probes?.checks ?? [],
             },
             exitOnShutdown: this.config.exitOnShutdown,
         });
-        // 4. Register interface checks dynamically too — they may have been
-        //    discovered during attach (e.g., queue probes once connected).
-        for (const s of this.nwireServables) {
-            for (const c of s.checks ?? [])
-                lifecycle.addCheck(c);
-        }
         // 5. Flip readiness and print the banner. AppReady fires AFTER
         // lightship marks /ready 200 — that's the moment the wire actually
         // accepts traffic.
@@ -326,13 +321,18 @@ export class EndpointBuilder {
             }
         }
         if (this.config.banner !== false) {
-            // Only advertise probes if lightship actually bound. The bind
-            // can be skipped (probes disabled) or fail silently on
-            // EADDRINUSE (handled in attachLifecycle).
+            // Read the actual bound port from each adopter that exposes one —
+            // covers ephemeral binds (`port: 0`) and any case where the adopter
+            // chose its own port. Falls back to the endpoint-declared port.
+            const adopterPorts = this.adapters
+                .map((a) => a.port?.())
+                .filter((p) => typeof p === "number");
+            const dataPort = adopterPorts[0] ?? this.config.port;
             const probesBound = lifecycle.lightship !== undefined;
             printBanner({
                 name: this.name,
-                port: this.config.port,
+                host: this.config.host ?? "0.0.0.0",
+                port: dataPort,
                 probePort: probesBound ? (this.config.probes?.port ?? 9_400) : undefined,
             });
         }
@@ -345,12 +345,6 @@ export class EndpointBuilder {
     }
 }
 // ─── Type guards ──────────────────────────────────────────────────────────
-/** True when the target is a Nwire interface (http/queue/etc) compiled for endpoint mount. */
-export function isNwireServable(x) {
-    return (typeof x === "object" &&
-        x !== null &&
-        x.$nwireServable === true);
-}
 /** True when the target is a Nwire app (container + lifecycle). */
 export function isAppServable(x) {
     return typeof x === "object" && x !== null && x.$nwireApp === true;
@@ -360,8 +354,7 @@ export function isAppServable(x) {
  *
  * Some hosts (Express, Connect) return a callable function as their app
  * value; others return an object (Fastify, Koa). We accept both — a
- * function with a `.listen` method counts. NwireServables are excluded
- * by the `$nwireServable` check at the call site.
+ * function with a `.listen` method counts.
  */
 export function isForeignServable(x) {
     return (x !== null &&
@@ -370,69 +363,33 @@ export function isForeignServable(x) {
 }
 // ─── Internal helpers ─────────────────────────────────────────────────────
 /**
- * Start the operating-system listener. When multiple NwireServables share
- * a port, this composes them onto a single http.Server. ForeignServables
- * use their own `.listen()` and the resulting Server is what gets wrapped
- * with lifecycle — meaning today only ONE ForeignServable per endpoint is
- * supported (more would require an internal multiplexer). The 99% case
- * is fine; multi-foreign on one port is exotic and you'd build it yourself.
+ * Start the operating-system listener for a foreign framework app. The
+ * foreign app owns its own server; the endpoint just kicks `.listen()`
+ * and wraps the resulting Server with lifecycle. Only one ForeignServable
+ * per endpoint is supported — multi-foreign on one port is exotic and
+ * the caller can compose inside the framework first.
  */
 async function startListener(opts) {
     if (opts.foreignServables.length > 1) {
         throw new Error(`endpoint: more than one foreign-framework target on one port is not supported; ` +
             `mount them separately or compose them inside the framework first.`);
     }
-    // Case A — foreign app owns the server. Nwire interfaces attach onto it
-    // via to* adapters (toExpress, toKoa) the user calls themselves before
-    // serving the framework. The endpoint just wraps the resulting Server.
-    if (opts.foreignServables.length === 1) {
-        const foreign = opts.foreignServables[0];
-        const server = await new Promise((resolve) => {
-            const s = foreign.listen(opts.port, opts.host ?? "0.0.0.0", () => resolve(s));
-        });
-        // NwireServables attached to a foreign endpoint must register
-        // themselves separately — there's no way for us to mount them onto
-        // the foreign framework's router automatically without knowing the
-        // framework. Future: detect Express/Fastify/Koa and auto-mount.
-        for (const s of opts.nwireServables) {
-            await s.attach({ addCheck: () => undefined });
-        }
-        return server;
-    }
-    // Case B — Nwire interfaces only. Build a host that they attach to.
-    // For now we delegate to the first servable's transport-specific host
-    // builder. Multi-transport on one port (REST + GraphQL + WS) requires
-    // a more elaborate host; that's @nwire/http's job.
-    if (opts.nwireServables.length === 0) {
-        throw new Error("endpoint: nothing to listen on (no Nwire interfaces, no foreign app)");
-    }
-    // Lean fallback: assume the first servable carries an internal listener
-    // factory. The richer multi-transport host lives in @nwire/http.
-    const primary = opts.nwireServables[0];
-    const buildHost = primary._buildHost;
-    const hostFactory = buildHost ? buildHost.bind(primary) : undefined;
-    if (!hostFactory) {
-        throw new Error(`endpoint: interface "${primary.transport}" does not expose _buildHost(); ` +
-            `it cannot be the primary listener. Install a transport package that supports it.`);
-    }
-    const built = hostFactory();
-    for (const s of opts.nwireServables) {
-        await s.attach({ addCheck: built.addCheck });
-    }
-    return await built.listen(opts.port, opts.host ?? "0.0.0.0");
+    const foreign = opts.foreignServables[0];
+    return await new Promise((resolve) => {
+        const s = foreign.listen(opts.port, opts.host ?? "0.0.0.0", () => resolve(s));
+    });
 }
 /** Probe-only server for workers/cron — nothing on the data port. */
-function makeProbeOnlyServer() {
-    // Lazy import keeps the cold-path module load out of the hot start.
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const http = require("node:http");
-    const srv = http.createServer((_req, res) => {
+async function makeProbeOnlyServer() {
+    const srv = createHttpServer((_req, res) => {
         res.statusCode = 404;
         res.end();
     });
-    // We don't actually .listen() this; attachLifecycle uses it only as
-    // the http-terminator target. Workers have no data port to drain;
-    // the probe port (lightship) is separate.
+    // Bind ephemerally so http-terminator has something to drain at
+    // shutdown — without a live listener, terminator throws "Server is
+    // not running" and onShutdown never fires. The 127.0.0.1:0 bind is
+    // ignored functionally; we just need an active socket.
+    await new Promise((resolve) => srv.listen(0, "127.0.0.1", resolve));
     return srv;
 }
 // `emptyContainer()` was previously used when no app was served — but
@@ -444,17 +401,16 @@ function printBanner(opts) {
     const lines = [
         `nwire endpoint "${opts.name}" listening`,
         opts.port !== undefined
-            ? `   data:   http://0.0.0.0:${opts.port}`
+            ? `   data:   http://${opts.host}:${opts.port}`
             : `   data:   (no HTTP listener)`,
     ];
     if (opts.probePort !== undefined) {
         // lightship's actual paths — not /readyz + /healthz (which was a
         // historical misnaming in our docs).
-        lines.push(`   probes: http://0.0.0.0:${opts.probePort}/live · /ready`);
+        lines.push(`   probes: http://${opts.host}:${opts.probePort}/live · /ready`);
     }
     else {
         lines.push(`   probes: (disabled — port already in use or probes disabled)`);
     }
     console.log(lines.join("\n"));
 }
-//# sourceMappingURL=endpoint.js.map

package/dist/lifecycle.d.ts

@@ -133,4 +133,3 @@ export declare function attachLifecycle(opts: {
     /** Test seam — set to false to skip process.exit() at the end. */
     readonly exitOnShutdown?: boolean;
 }): Promise<LifecycleManager>;
-//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.js

@@ -227,4 +227,3 @@ export async function attachLifecycle(opts) {
         },
     };
 }
-//# sourceMappingURL=lifecycle.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nwire/endpoint",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "Nwire — production process lifecycle. Wraps any Node server (Express, Fastify, Koa, Nest, Nwire interfaces) with K8s-grade graceful shutdown, http-terminator drain, and lightship readiness/liveness probes. Standalone — no framework dependency beyond @nwire/container.",
   "keywords": [
     "endpoint",
@@ -32,9 +32,10 @@
   "dependencies": {
     "http-terminator": "^3.2.0",
     "lightship": "^9.0.4",
-    "@nwire/hooks": "0.9.1",
-    "@nwire/container": "0.9.1",
-    "@nwire/interface": "0.9.1"
+    "@nwire/container": "0.10.0",
+    "@nwire/hooks": "0.10.0",
+    "@nwire/wires": "0.10.0",
+    "@nwire/logger": "0.10.0"
   },
   "devDependencies": {
     "@types/node": "^22.19.9",

package/dist/__tests__/endpoint.test.d.ts

@@ -1,14 +0,0 @@
-/**
- * Smoke tests for the endpoint builder. Exercises:
- *
- *   - Type guards on the three Servable shapes (Nwire interface / app / foreign)
- *   - Builder accepts each shape via .serve()
- *   - .serve() with an unknown shape throws a clear error
- *
- * Full lifecycle integration (boot → listen → SIGTERM → drain → exit) is
- * covered by the docker-compose integration suite, not this unit file.
- * That suite lives at `examples/integration-tests/` and runs against
- * real K8s probes + http-terminator timing.
- */
-export {};
-//# sourceMappingURL=endpoint.test.d.ts.map

package/dist/__tests__/endpoint.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"endpoint.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/endpoint.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/__tests__/endpoint.test.js

@@ -1,96 +0,0 @@
-/**
- * Smoke tests for the endpoint builder. Exercises:
- *
- *   - Type guards on the three Servable shapes (Nwire interface / app / foreign)
- *   - Builder accepts each shape via .serve()
- *   - .serve() with an unknown shape throws a clear error
- *
- * Full lifecycle integration (boot → listen → SIGTERM → drain → exit) is
- * covered by the docker-compose integration suite, not this unit file.
- * That suite lives at `examples/integration-tests/` and runs against
- * real K8s probes + http-terminator timing.
- */
-import { describe, it, expect } from "vitest";
-import { createContainer } from "@nwire/container";
-import { endpoint, isAppServable, isForeignServable, isNwireServable, } from "../endpoint.js";
-describe("endpoint() — type guards", () => {
-    it("identifies a NwireServable by the $nwireServable marker", () => {
-        const ns = {
-            $nwireServable: true,
-            transport: "http",
-            attach: () => undefined,
-        };
-        expect(isNwireServable(ns)).toBe(true);
-        expect(isAppServable(ns)).toBe(false);
-        expect(isForeignServable(ns)).toBe(false);
-    });
-    it("identifies an AppServable by the $nwireApp marker", () => {
-        const app = {
-            $nwireApp: true,
-            container: createContainer(),
-            boot: async () => undefined,
-            shutdown: async () => undefined,
-        };
-        expect(isAppServable(app)).toBe(true);
-        expect(isNwireServable(app)).toBe(false);
-    });
-    it("identifies a ForeignServable by .listen()", () => {
-        /**
-         * Anything with `.listen(port, host?, cb?): Server` is treated as a
-         * foreign framework. The endpoint will wrap the resulting Server
-         * with attachLifecycle().
-         */
-        const foreign = {
-            listen: () => ({}),
-        };
-        expect(isForeignServable(foreign)).toBe(true);
-        expect(isNwireServable(foreign)).toBe(false);
-        expect(isAppServable(foreign)).toBe(false);
-    });
-    it("rejects plain objects that satisfy none of the contracts", () => {
-        const garbage = { foo: 1, bar: () => undefined };
-        expect(isNwireServable(garbage)).toBe(false);
-        expect(isAppServable(garbage)).toBe(false);
-        expect(isForeignServable(garbage)).toBe(false);
-    });
-    it("accepts a CALLABLE app value with .listen — Express 5's app is a function", () => {
-        // Regression: Express 5 returns a callable (typeof === "function") with
-        // a .listen property. A previous typeof === "object" check rejected it.
-        const expressLikeApp = Object.assign(() => undefined, { listen: () => ({}) });
-        expect(isForeignServable(expressLikeApp)).toBe(true);
-    });
-    it("rejects null + arrow fns without .listen", () => {
-        expect(isForeignServable(null)).toBe(false);
-        expect(isForeignServable(() => undefined)).toBe(false);
-    });
-});
-describe("endpoint() — builder", () => {
-    it("accepts each Servable shape via .serve() in any order", () => {
-        /**
-         * The builder doesn't run anything until .run() is called, so we can
-         * verify ordering / acceptance without spinning up a server.
-         */
-        const app = {
-            $nwireApp: true,
-            container: createContainer(),
-            boot: async () => undefined,
-            shutdown: async () => undefined,
-        };
-        const iface = {
-            $nwireServable: true,
-            transport: "queue",
-            attach: () => undefined,
-        };
-        expect(() => endpoint("api").serve(app).serve(iface)).not.toThrow();
-        expect(() => endpoint("api").serve(iface).serve(app)).not.toThrow();
-    });
-    it("throws a clear error when .serve() gets an unknown shape", () => {
-        /**
-         * Catching the bad-input case at .serve() time (not .run() time) means
-         * the developer sees the error at the call site, not buried in a
-         * runtime stack trace from inside the boot sequence.
-         */
-        expect(() => endpoint("api").serve({ random: 42 })).toThrow(/not a Nwire app, Nwire interface, or framework app/);
-    });
-});
-//# sourceMappingURL=endpoint.test.js.map

package/dist/__tests__/endpoint.test.js.map

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

package/dist/__tests__/lifecycle.test.d.ts

@@ -1,13 +0,0 @@
-/**
- * Direct tests for `attachLifecycle()` — the graceful-shutdown wrapper
- * that sits between any Node http.Server and http-terminator + lightship.
- *
- * Specifically covers the edge cases that previously broke real boot
- * paths but were only surfaced by interop examples:
- *
- *   - shutdown completes promptly when probes are disabled (no LB to wait for)
- *   - shutdown waits drainDelay when probes are enabled (LB needs time)
- *   - shutdown is idempotent
- */
-export {};
-//# sourceMappingURL=lifecycle.test.d.ts.map

package/dist/__tests__/lifecycle.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lifecycle.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/lifecycle.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}