@adhd/apigen-core-client 0.1.2 → 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/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';

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@adhd/apigen-core-client",
-  "version": "0.1.2",
+  "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.3"
+    "@adhd/apigen-base-logical": "^0.0.4"
   },
   "main": "./index.js",
   "module": "./index.mjs",