@zhin.js/middleware 1.1.4 → 1.1.6

package/lib/definition.d.ts

@@ -51,7 +51,8 @@ type AuthoringForAdapter<TInput, TConfig, TAdapter extends string | undefined> =
     readonly target: 'outbound';
     handle(context: MiddlewareContext<TInput, TConfig, TAdapter>, next: OutboundMiddlewareNext): void | Promise<void>;
 });
-type MiddlewareAuthoringDefinition<TInput, TConfig> = AuthoringForAdapter<TInput, TConfig, undefined> | {
+/** @internal Shape shared with the typed IM facade; not a separate authoring API. */
+export type MiddlewareAuthoringDefinition<TInput, TConfig> = AuthoringForAdapter<TInput, TConfig, undefined> | {
     [TAdapter in RegisteredAdapterName]: AuthoringForAdapter<TInput, TConfig, TAdapter> & {
         readonly adapter: TAdapter;
     };

package/lib/middleware-index.d.ts

@@ -1,14 +1,16 @@
 import type { CapabilitySlot, PluginId, RuntimeSnapshot } from '@zhin.js/plugin-runtime';
 import type { MiddlewareDefinition, MiddlewarePhase, MiddlewareTarget, OutboundMiddlewareNext } from './definition.js';
-/** Transmission-neutral result policy supplied by the composition layer. */
+/** @internal Transmission-neutral result policy supplied by the composition layer. */
 export interface MiddlewareResultPolicy<TResult> {
     stop(owner: PluginId): TResult;
     replace(owner: PluginId, value: unknown, downstream: TResult | undefined): TResult;
 }
+/** @internal Runtime continuation result. */
 export interface MiddlewareRunResult {
     readonly owner?: PluginId;
     readonly value?: unknown;
 }
+/** @internal Runtime inventory projection. */
 export interface MiddlewareDescriptor {
     readonly owner: PluginId;
     readonly name: string;
@@ -18,6 +20,7 @@ export interface MiddlewareDescriptor {
     readonly order: number;
     readonly adapter?: string;
 }
+/** @internal Runtime middleware executor. */
 export declare class MiddlewareIndex {
     #private;
     private readonly snapshot;
@@ -30,4 +33,5 @@ export declare class MiddlewareIndex {
     /** Unwinds one inbound operation before its caller performs any automatic reply. */
     runInbound<TInput, TResult>(input: TInput, terminal: () => Promise<TResult>, results: MiddlewareResultPolicy<TResult>, operationSnapshot?: RuntimeSnapshot): Promise<TResult>;
 }
+/** @internal Runtime projection guard. */
 export declare function isMiddlewareIndex(value: unknown): value is MiddlewareIndex;

package/lib/middleware-index.js

@@ -1,5 +1,6 @@
 import { createCapabilityContext, bindOperationInput, operationClientAdapter, readOperationClient, } from '@zhin.js/feature-kit';
 import { continuationBrand } from './continuation.js';
+/** @internal Runtime middleware executor. */
 export class MiddlewareIndex {
     snapshot;
     $projection = 'zhin.middleware-index/1';
@@ -124,6 +125,7 @@ export class MiddlewareIndex {
         return dispatch(0);
     }
 }
+/** @internal Runtime projection guard. */
 export function isMiddlewareIndex(value) {
     return !!value && typeof value === 'object'
         && value.$projection === 'zhin.middleware-index/1';

package/lib/provider.d.ts

@@ -1,5 +1,7 @@
 import { MiddlewareIndex } from './middleware-index.js';
+/** @internal Runtime Feature identity. */
 export declare const middlewareFeatureId: import("@zhin.js/plugin-runtime").FeatureId;
+/** @internal Runtime Feature provider. */
 declare const middlewareFeature: Readonly<import("@zhin.js/feature-kit").FeatureProvider<import("./definition.js").MiddlewareDefinition<unknown, unknown, string | undefined>, MiddlewareIndex>>;
 export { middlewareFeature };
 export default middlewareFeature;

package/lib/provider.js

@@ -2,7 +2,9 @@ import { featureId } from '@zhin.js/plugin-runtime';
 import { capture, captured, defineFeatureProvider, directoryModules } from '@zhin.js/feature-kit';
 import { parseMiddlewareDefinition } from './definition.js';
 import { MiddlewareIndex } from './middleware-index.js';
+/** @internal Runtime Feature identity. */
 export const middlewareFeatureId = featureId('zhin.middleware');
+/** @internal Runtime Feature provider. */
 const middlewareFeature = defineFeatureProvider({
     protocol: 1,
     id: middlewareFeatureId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/middleware",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "Convention-based Middleware Feature for Zhin Plugin Runtime",
   "type": "module",
   "main": "./lib/index.js",
@@ -8,7 +8,6 @@
   "exports": {
     ".": {
       "types": "./lib/index.d.ts",
-      "development": "./src/index.ts",
       "import": "./lib/index.js"
     }
   },
@@ -17,8 +16,8 @@
     "src"
   ],
   "dependencies": {
-    "@zhin.js/feature-kit": "1.1.3",
-    "@zhin.js/plugin-runtime": "1.1.12"
+    "@zhin.js/feature-kit": "1.1.5",
+    "@zhin.js/plugin-runtime": "1.1.14"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
@@ -32,7 +31,7 @@
     "featureApi": "1.0.0"
   },
   "engines": {
-    "node": "^20.19.0 || >=22.12.0"
+    "node": ">=22.19.0"
   },
   "repository": {
     "type": "git",

package/src/definition.ts

@@ -72,7 +72,8 @@ type AuthoringForAdapter<TInput, TConfig, TAdapter extends string | undefined> =
     | { readonly target: 'outbound'; handle(context: MiddlewareContext<TInput, TConfig, TAdapter>, next: OutboundMiddlewareNext): void | Promise<void> }
   );
 
-type MiddlewareAuthoringDefinition<TInput, TConfig> =
+/** @internal Shape shared with the typed IM facade; not a separate authoring API. */
+export type MiddlewareAuthoringDefinition<TInput, TConfig> =
   | AuthoringForAdapter<TInput, TConfig, undefined>
   | {
       [TAdapter in RegisteredAdapterName]: AuthoringForAdapter<TInput, TConfig, TAdapter> & {

package/src/middleware-index.ts

@@ -14,17 +14,19 @@ import type {
 } from './definition.js';
 import { continuationBrand, type MiddlewareContinuation } from './continuation.js';
 
-/** Transmission-neutral result policy supplied by the composition layer. */
+/** @internal Transmission-neutral result policy supplied by the composition layer. */
 export interface MiddlewareResultPolicy<TResult> {
   stop(owner: PluginId): TResult;
   replace(owner: PluginId, value: unknown, downstream: TResult | undefined): TResult;
 }
 
+/** @internal Runtime continuation result. */
 export interface MiddlewareRunResult {
   readonly owner?: PluginId;
   readonly value?: unknown;
 }
 
+/** @internal Runtime inventory projection. */
 export interface MiddlewareDescriptor {
   readonly owner: PluginId;
   readonly name: string;
@@ -39,6 +41,7 @@ interface MiddlewareRecord extends MiddlewareDescriptor {
   readonly slot: Readonly<CapabilitySlot<MiddlewareDefinition>>;
 }
 
+/** @internal Runtime middleware executor. */
 export class MiddlewareIndex {
   readonly $projection = 'zhin.middleware-index/1' as const;
   readonly #records: readonly MiddlewareRecord[];
@@ -170,6 +173,7 @@ export class MiddlewareIndex {
   }
 }
 
+/** @internal Runtime projection guard. */
 export function isMiddlewareIndex(value: unknown): value is MiddlewareIndex {
   return !!value && typeof value === 'object'
     && (value as { readonly $projection?: unknown }).$projection === 'zhin.middleware-index/1';

package/src/provider.ts

@@ -3,8 +3,10 @@ import { capture, captured, defineFeatureProvider, directoryModules } from '@zhi
 import { parseMiddlewareDefinition } from './definition.js';
 import { MiddlewareIndex } from './middleware-index.js';
 
+/** @internal Runtime Feature identity. */
 export const middlewareFeatureId = featureId('zhin.middleware');
 
+/** @internal Runtime Feature provider. */
 const middlewareFeature = defineFeatureProvider({
   protocol: 1,
   id: middlewareFeatureId,