@adhd/apigen-core-client 0.1.1 → 0.1.3

package/lib/compose-schemas.d.ts

@@ -1,9 +1,34 @@
+import { Plugin } from './plugin';
 import { GeneratedSchemas, ComposedSchemas } from './types';
 
 interface SlimMiddleware {
     id: string;
     envelope?: Record<string, unknown>;
 }
+/**
+ * DEBT-APIGEN-ENVELOPE-CAPABILITY-UNWIRED-001: reduce a set of loaded `--use`
+ * plugins' envelope-contributing capabilities into the `SlimMiddleware[]`
+ * shape {@link composeSchemas} consumes (SPEC §9.1).
+ *
+ * Two capabilities contribute request-side envelope fields, and a plugin may
+ * declare either or both:
+ *   - `capabilities.envelope.request` — the dedicated `EnvelopeCapability`
+ *     (declares fields without wrapping the operation in a Layer).
+ *   - `capabilities.layer.envelopeFields` — a `LayerCapability`'s own "extra
+ *     fields I need on the request side" declaration (its doc comment: "merged
+ *     into the effective descriptor's envelope schema before serving begins").
+ *
+ * Both merge into ONE envelope map per plugin, keyed by the plugin's own `id`
+ * — the same `id` `composeSchemas()` stamps as the `x-apigen-envelope`
+ * pluginId, so `envelopeKey`/`envelopeCliFlag`/`envelopeEnvVar`
+ * (`@adhd/apigen-engine-naming`) bind to `x-<id>-<field>` /
+ * `--<id>-<field>` / `APIGEN_<ID>_<FIELD>` for the field's OWN plugin, not a
+ * hardcoded default.
+ *
+ * Plugins contributing neither capability are omitted (composeSchemas treats
+ * `envelope: undefined` as "no contribution", same as `false`-suppressed).
+ */
+export declare function pluginsToEnvelopeMiddlewares(plugins: readonly Plugin[]): SlimMiddleware[];
 /**
  * Merges domain schemas with middleware envelope fields.
  *

package/lib/descriptor.d.ts

@@ -71,7 +71,7 @@ export interface ApigenSchemaHints {
  *
  * Identity is carried by the tokenized `words`; the original `raw` spelling is
  * preserved so a same-host plugin can reproduce it, but every transport derives
- * its own casing from `words` via `@adhd/apigen-naming` (kebab for HTTP/CLI,
+ * its own casing from `words` via `@adhd/apigen-engine-naming` (kebab for HTTP/CLI,
  * `_`-joined for MCP, Pascal for gRPC). Casing is therefore per-plugin, never
  * baked into the descriptor.
  */

package/lib/types.d.ts

@@ -18,6 +18,7 @@ export type ComposedSchemas = Record<string, {
     output: Record<string, unknown>;
     hasCtx?: boolean;
     'x-apigen-safe'?: boolean;
+    'x-apigen-envelope'?: Record<string, string>;
 }>;
 export type ExportMode = {
     type: 'named';
@@ -44,6 +45,19 @@ export interface PluginInput {
      * a default stderr logger when this is absent.
      */
     logger?: Logger;
+    /**
+     * DEBT-APIGEN-PLUGIN-MCP-GENERATE-OPERATIONS-001: the full merged
+     * `Operation[]` descriptor (the same set `buildDescriptor()` produces),
+     * threaded through so `generate()` can call the real `project(op)` for
+     * every operation instead of falling back to a best-effort synthesized
+     * `Operation` (exact only for the single-source-file case; wrong for
+     * multi-file namespaces / npm-specifier importPath / default-object
+     * exports). Lifted from `RunInput` (BUG-APIGEN-024) onto the base
+     * `PluginInput` so both `generate()` and `run()` get real ops from the
+     * same field. Optional: absent for non-TS-extraction paths (e.g.
+     * py-flask) where nothing was extracted to describe.
+     */
+    operations?: Operation[];
 }
 export interface PluginOutput {
     files: Array<{
@@ -54,15 +68,6 @@ export interface PluginOutput {
 }
 export interface RunInput extends PluginInput {
     signal?: AbortSignal;
-    /**
-     * BUG-APIGEN-024: the full merged `Operation[]` descriptor (the same set
-     * `buildDescriptor()` produces), threaded through so a `--use` mount plugin
-     * (e.g. `apigen-plugin-openapi`) can build its real `Descriptor` instead of
-     * the empty-`operations` stub `collectMountRoutes()` used to synthesize.
-     * Absent for non-TS-extraction run paths (e.g. py-flask), where mount
-     * plugins have nothing extracted to describe.
-     */
-    operations?: Operation[];
 }
 /** Source-language tags understood by apigen's routing layer. */
 export type PluginLanguage = 'ts' | 'py' | 'rust' | 'go' | 'java';

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@adhd/apigen-core-client",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "dependencies": {
     "ts-morph": "^23.0.0",
     "ts-json-schema-generator": "^2.3.0",
     "pino": "10.3.1",
     "typescript": "^6.0.3",
-    "@adhd/apigen-base-logical": "^0.0.2"
+    "@adhd/apigen-base-logical": "^0.0.4"
   },
   "main": "./index.js",
   "module": "./index.mjs",