@adhd/apigen-engine-runtime 0.3.1 → 0.3.3

package/lib/bind-host.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Listen-host policy shared by every apigen TypeScript host (fastify, express,
+ * mcp). Defaults to IPv4 loopback; binding anything else is a deliberate
+ * override (`--opt host=…` / `options.host`) and logs a warning. Node's
+ * `listen(port)` with no host — or with an empty string — binds ALL
+ * interfaces, so the empty/whitespace case is treated as unset.
+ *
+ * Pure (no sockets), so the default is unit-testable without binding a port.
+ */
+/** Default listen address for every apigen host: IPv4 loopback. */
+export declare const DEFAULT_LISTEN_HOST = "127.0.0.1";
+/** True for `localhost`, `127.0.0.0/8`, `::1` and IPv4-mapped loopback. */
+export declare function isLoopbackListenHost(host: string): boolean;
+/**
+ * Resolve the effective listen host from the plugin `host` option. Non-string,
+ * empty and whitespace-only values fall back to {@link DEFAULT_LISTEN_HOST}.
+ */
+export declare function resolveListenHost(raw: unknown): string;
+/**
+ * Emit a warning when `host` is not loopback (unauthenticated-by-default
+ * hosts become network-reachable). Returns whether it warned.
+ */
+export declare function warnIfNonLoopbackListen(host: string, label: string, logger?: {
+    warn: (obj: Record<string, unknown>, msg: string) => void;
+}): boolean;

package/lib/dispatch-for-plan.d.ts

@@ -6,4 +6,4 @@ import { Call as RuntimeCall, InvokeFn, InvokeOptions, LayerResult } from './inv
  * (`InvokeFn`, e.g. from `createPackageInvoker`) and a partial runtime `Call`
  * (minus `operation`/`ctx`, per the `TransportAdapter` contract).
  */
-export declare function dispatchForPlan(plan: OpPlan, invoke: InvokeFn, call: Omit<RuntimeCall, 'operation' | 'ctx'>, opts: InvokeOptions): Promise<LayerResult>;
+export declare function dispatchForPlan(plan: OpPlan, invoke: InvokeFn, call: Omit<RuntimeCall, 'operation' | 'ctx' | 'transport'>, opts: InvokeOptions): Promise<LayerResult>;

package/lib/invoke.d.ts

@@ -1,5 +1,5 @@
 import { ComposedSchemas } from './types';
-import { Operation } from '@adhd/apigen-core-client';
+import { Operation, Transport } from '@adhd/apigen-core-client';
 
 /**
  * A symbol-keyed or constructor-keyed typed extension map.  Each value is
@@ -37,6 +37,13 @@ export interface Call {
     domainArgs: Record<string, unknown>;
     /** Cancellation signal (AbortSignal) — §11. */
     signal?: AbortSignal;
+    /**
+     * The canonical transport this call arrived on.  Stamped by `dispatchForPlan`
+     * from `plan.transport` (F3), so it is guaranteed present on every call a
+     * Layer observes — never optional, never a silent `undefined`.  A Layer that
+     * needs the transport reads it here; it never hunts for it elsewhere.
+     */
+    transport: Transport;
 }
 /**
  * The primitive result a Layer or dispatch can return.

package/lib/transport-adapter.d.ts

@@ -7,12 +7,12 @@ export interface TransportAdapter<Raw = unknown> {
      * transport's underlying server/CLI/router, wiring inbound requests to
      * `dispatch`. Called ONCE per `OpPlan`, at server/CLI wiring time.
      */
-    registerRoute(plan: OpPlan, dispatch: (call: Omit<Call, 'operation' | 'ctx'>) => Promise<LayerResult>): void;
+    registerRoute(plan: OpPlan, dispatch: (call: Omit<Call, 'operation' | 'ctx' | 'transport'>) => Promise<LayerResult>): void;
     /**
      * Marshal the transport-native inbound request `raw` into the runtime
      * `Call` shape (minus `operation`/`ctx`, filled in by the dispatch path).
      */
-    readCall(raw: Raw, plan: OpPlan): Omit<Call, 'operation' | 'ctx'> | Promise<Omit<Call, 'operation' | 'ctx'>>;
+    readCall(raw: Raw, plan: OpPlan): Omit<Call, 'operation' | 'ctx' | 'transport'> | Promise<Omit<Call, 'operation' | 'ctx' | 'transport'>>;
     /**
      * Marshal a resolved `LayerResult` (the value `dispatch`'s returned
      * Promise resolved to — F1) back onto the transport-native outbound

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@adhd/apigen-engine-runtime",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "dependencies": {
     "ajv": "^8.20.0",
     "ajv-formats": "2.1.1",
     "pino": "10.3.1",
-    "@adhd/apigen-core-client": "^0.3.3",
+    "@adhd/apigen-core-client": "^0.3.4",
     "@adhd/apigen-base-logical": "^0.1.4",
     "@adhd/apigen-base-errors": "^0.2.3",
     "@adhd/apigen-engine-naming": "^0.2.5",