@adhd/apigen-runtime 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# @adhd/apigen-runtime
+
+The apigen **dispatch runtime** — the single canonical call path every plugin and every
+generated server uses to turn an inbound request into a function call. Pure TypeScript,
+**platform: shared**.
+
+Part of [apigen](../README.md). For end-to-end usage see [`../cli`](../cli).
+
+## Public API
+
+```ts
+import {
+  dispatch, buildFnTable, describeParams,
+  needsEnvelopeField, dataParamNames,
+  createLogger, defineMiddleware, createApiPackage,
+  EventBus, wireObservers, buildContext,
+} from '@adhd/apigen-runtime'
+import type { Logger, LogFormat, CreateLoggerOptions, ParamInfo, AnyFn } from '@adhd/apigen-runtime'
+```
+
+- **`dispatch(fns, ctx, schema, fnName, envelope, data)`** — the one dispatch path. No plugin
+  inlines this; all import it here.
+- **`buildFnTable(mod)`** — normalize an imported module into a callable table, recursively
+  unwrapping `default` / CommonJS `module.exports` layers and keying functions by their
+  `.name` so default- and CJS-wrapped exports resolve (closes ledger finding F28).
+- **`describeParams(schema)` → `ParamInfo[]`** — extract the parameter list for route/tool
+  logging and CLI flag generation.
+- **`needsEnvelopeField` / `dataParamNames`** — envelope + param helpers (single source).
+- **`createLogger({ level, format, destination })`** — pino-based logger; defaults to
+  **stderr** so MCP stdio stdout stays protocol-clean. `format: 'json' | 'pretty'`.
+- **`defineMiddleware` / `createApiPackage` / `EventBus` / `wireObservers` / `buildContext`**
+  — middleware + observer wiring.
+
+## Request envelope
+
+Inbound payloads are wrapped: `{ "data": { ...params }, ...envelope }`. `dispatch` validates
+the envelope fields a function requires (e.g. a `session` added by middleware) and passes
+`data` to the function.
+
+## Develop
+
+```bash
+npx nx build apigen-runtime
+npx nx test  apigen-runtime
+```

package/index.d.ts

@@ -0,0 +1,19 @@
+export { createInvoker } from './lib/invoke';
+export type { Layer, LayerResult, Next, Call, LayerContext, InvokeOptions, InvokeFn, } from './lib/invoke';
+export { defineMiddleware } from './lib/define-middleware';
+export { EventBus, wireObservers } from './lib/event-bus';
+export { buildContext } from './lib/build-context';
+export { assertNoSelfSubscription, createApiPackage } from './lib/api-package';
+export type { MiddlewareDef, MiddlewareEvent, ApiPackageOptions, ApiPackageResult, ConfigurationError, GeneratedSchemas, ComposedSchemas, } from './lib/types';
+export { needsEnvelopeField, dataParamNames, dispatch } from './lib/dispatch';
+export { createLogger } from './lib/logger';
+export type { Logger, LogFormat, CreateLoggerOptions } from './lib/logger';
+export { describeParams } from './lib/describe-params';
+export type { ParamInfo } from './lib/describe-params';
+export { buildFnTable } from './lib/fn-table';
+export type { AnyFn } from './lib/fn-table';
+export { validateLayer, makeValidateLayer, ValidateSchemasToken } from './lib/validate-layer';
+export { InstanceRegistry } from './lib/instance-registry';
+export type { InstanceRegistryOptions, CreateResult, AnyConstructor } from './lib/instance-registry';
+export { createStream, drainStream, collectWithPhase, isApiStream } from './lib/stream';
+export type { ApiStream, CreateStreamOptions, CollectResult } from './lib/stream';