@jeffusion/bungee-core 5.17.0 → 5.19.0

package/dist/config-storage/gateway-target-validation.d.ts

@@ -0,0 +1,5 @@
+import type { LogicalConfigurationV2 } from '@jeffusion/bungee-types';
+import type { PluginSchemaCatalog } from './plugin-schema';
+import type { ValidationContext } from './validation';
+/** Only schema-declared references participate. Client JSON and headers never supply targets. */
+export declare function validateGatewayTargets(config: LogicalConfigurationV2, schemas: PluginSchemaCatalog | undefined, context: ValidationContext): void;

package/dist/gateway/contracts.d.ts

@@ -1,5 +1,5 @@
 /** Typed extension stages shared by built-in and project plugins. */
-import type { AppConfig, RouteConfig, CorsConfig } from '@jeffusion/bungee-types';
+import type { AppConfig, RouteConfig, CorsConfig, LLMProtocol } from '@jeffusion/bungee-types';
 import type { ExpressionContext } from '../expression-engine';
 import type { EffectiveRouteConfig, RuntimeUpstream, RequestSnapshot } from '../worker/types';
 import type { HandleRequestRuntimeContext } from './request-plugin';
@@ -24,6 +24,33 @@ export type GatewayBodyRuleArguments = [body: Record<string, any>, rules: Modifi
 export type GatewayHeaderRuleArguments = [headers: Headers, rules: ModificationRules['headers'], context: ExpressionContext];
 export type GatewayCorsArguments = [response: Response, cors: CorsConfig | undefined, request: Request];
 export type GatewayQueryRuleArguments = [params: URLSearchParams, rules: ModificationRules['query'], context: ExpressionContext, requestLog: any];
+export interface GatewayDispatchTarget {
+    readonly type: 'route' | 'service';
+    readonly id: string;
+}
+export interface DispatchRequestInput {
+    readonly context: import('../hooks').MutableRequestContext;
+    readonly targets: readonly (GatewayDispatchTarget & {
+        readonly protocol?: LLMProtocol;
+    })[];
+    readonly principal?: import('../plugin-extensions').DataPrincipal;
+    readonly signal: AbortSignal;
+    readonly servingRevision?: number;
+}
+export interface DispatchRequestDecision {
+    readonly target: GatewayDispatchTarget;
+}
+export interface GatewayDispatchInput extends Omit<DispatchRequestInput, 'targets'> {
+    readonly config: AppConfig;
+    readonly entry: RouteConfig;
+}
+export interface GatewayDispatchDecision {
+    readonly route: RouteConfig;
+    readonly effective: EffectiveRouteConfig;
+    readonly context: import('../hooks').MutableRequestContext;
+    readonly entryRouteId?: string;
+    readonly target?: GatewayDispatchTarget;
+}
 export interface GatewayRouteInput {
     readonly request: Request;
     readonly config: AppConfig;
@@ -107,4 +134,4 @@ export interface GatewayLogResult {
     readonly logger?: RequestLogger;
 }
 /** Provider stages are fixed, required, and registered exactly once at startup. */
-export declare const GATEWAY_PROVIDER_STAGES: readonly ["onGatewayWebSocket", "onGatewayBody", "onGatewayRequest", "onGatewayRoute", "onGatewayAdmission", "onGatewayAdmissionSession", "onGatewayAdmissionPrepare", "onGatewaySelect", "onGatewayFailover", "onGatewayRetry", "onGatewayForward", "onGatewayHeaderRules", "onGatewayCors", "onGatewayBodyRules", "onGatewayQueryRules", "onGatewayResponseRules", "onGatewayLog"];
+export declare const GATEWAY_PROVIDER_STAGES: readonly ["onGatewayWebSocket", "onGatewayBody", "onGatewayRequest", "onGatewayRoute", "onGatewayDispatch", "onGatewayAdmission", "onGatewayAdmissionSession", "onGatewayAdmissionPrepare", "onGatewaySelect", "onGatewayFailover", "onGatewayRetry", "onGatewayForward", "onGatewayHeaderRules", "onGatewayCors", "onGatewayBodyRules", "onGatewayQueryRules", "onGatewayResponseRules", "onGatewayLog"];

package/dist/gateway/dispatch-plugin.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin, PluginHooks } from './plugin';
+export declare class DispatchPlugin implements Plugin {
+    bodyRequirements(): {
+        request: "none";
+    };
+    register(hooks: PluginHooks): void;
+}

package/dist/gateway/dispatch-targets.d.ts

@@ -0,0 +1,4 @@
+import type { PluginConfigField } from '../plugin.types';
+import type { GatewayDispatchTarget } from './contracts';
+/** Extract references only from the trusted schema, never from arbitrary request JSON. */
+export declare function declaredDispatchTargets(options: Record<string, unknown>, fields: readonly PluginConfigField[]): GatewayDispatchTarget[];

package/dist/gateway/plugin.js

@@ -325,6 +325,8 @@ function createPluginHooks() {
     onGatewayBody: new SyncBailHook("onGatewayBody"),
     onGatewayRequest: new AsyncSeriesBailHook("onGatewayRequest"),
     onGatewayRoute: new AsyncSeriesBailHook("onGatewayRoute"),
+    onGatewayDispatch: new AsyncSeriesBailHook("onGatewayDispatch"),
+    onDispatchRequest: new AsyncSeriesBailHook("onDispatchRequest"),
     onGatewayAdmission: new AsyncSeriesBailHook("onGatewayAdmission"),
     onGatewayAdmissionSession: new AsyncSeriesBailHook("onGatewayAdmissionSession"),
     onGatewayAdmissionPrepare: new AsyncSeriesBailHook("onGatewayAdmissionPrepare"),

package/dist/gateway/routing-plugin.d.ts

@@ -1,5 +1,7 @@
-import type { CorsConfig } from '@jeffusion/bungee-types';
+import type { AppConfig, RouteConfig, CorsConfig } from '@jeffusion/bungee-types';
+import type { EffectiveRouteConfig } from '../worker/types';
 import type { Plugin, PluginHooks } from '@jeffusion/bungee-core/plugin';
+export declare function resolveEffectiveRoute(config: AppConfig, route: RouteConfig): EffectiveRouteConfig;
 export declare function applyCorsHeaders(response: Response, cors: CorsConfig | undefined, request: Request): Response;
 export declare class RoutingPlugin implements Plugin {
     bodyRequirements(): {

package/dist/hooks/plugin-hooks.d.ts

@@ -11,7 +11,7 @@ import type { PluginServices } from '../plugin-services';
 import type { PluginStorage, SSEEnvelope } from '../plugin.types';
 import type { InterceptResult, PluginPhase } from '@jeffusion/bungee-types';
 import type { RawResponseResult } from '../plugin-control/contracts';
-import type { GatewayBodyArguments, GatewayRequestArguments, GatewayForwardArguments, GatewayResponseRuleArguments, GatewayBodyRuleArguments, GatewayQueryRuleArguments, GatewayHeaderRuleArguments, GatewayCorsArguments, GatewayRouteInput, GatewayRouteDecision, GatewayAdmissionInput, GatewayAdmissionDecision, GatewayAdmissionSessionInput, GatewayAdmissionPrepareInput, GatewaySelectInput, GatewaySelectDecision, GatewayFailoverInput, GatewayRetryInput, GatewayLogInput, GatewayLogResult } from '../gateway/contracts';
+import type { GatewayBodyArguments, GatewayRequestArguments, GatewayForwardArguments, GatewayResponseRuleArguments, GatewayBodyRuleArguments, GatewayQueryRuleArguments, GatewayHeaderRuleArguments, GatewayCorsArguments, GatewayRouteInput, GatewayRouteDecision, GatewayDispatchInput, GatewayDispatchDecision, DispatchRequestInput, DispatchRequestDecision, GatewayAdmissionInput, GatewayAdmissionDecision, GatewayAdmissionSessionInput, GatewayAdmissionPrepareInput, GatewaySelectInput, GatewaySelectDecision, GatewayFailoverInput, GatewayRetryInput, GatewayLogInput, GatewayLogResult } from '../gateway/contracts';
 import type { WorkerRequestAdmission, PreparedAdmissionAttempt } from '../data-admission/worker';
 import type { FailoverCoordinator } from '../worker/upstream/failover-coordinator';
 import type { ProxyRequestResult } from '../gateway/forward-plugin';
@@ -233,6 +233,8 @@ export interface PluginHooks {
     onGatewayCors: AsyncSeriesBailHook<GatewayCorsArguments, Response>;
     onGatewayRequest: AsyncSeriesBailHook<GatewayRequestArguments, Response>;
     onGatewayRoute: AsyncSeriesBailHook<[GatewayRouteInput], GatewayRouteDecision>;
+    onGatewayDispatch: AsyncSeriesBailHook<[GatewayDispatchInput], GatewayDispatchDecision>;
+    onDispatchRequest: AsyncSeriesBailHook<[DispatchRequestInput], DispatchRequestDecision>;
     onGatewayAdmission: AsyncSeriesBailHook<[GatewayAdmissionInput], GatewayAdmissionDecision>;
     onGatewayAdmissionSession: AsyncSeriesBailHook<[GatewayAdmissionSessionInput], WorkerRequestAdmission>;
     onGatewayAdmissionPrepare: AsyncSeriesBailHook<[GatewayAdmissionPrepareInput], PreparedAdmissionAttempt[]>;