kizunajs 2.0.0-beta.25 → 2.0.0-beta.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  A spec-driven framework for building fully typed REST APIs in TypeScript, where your route declarations produce the validation, the documentation, the clients, and the AI tools.
6
6
 
7
- [![npm](https://img.shields.io/npm/v/kizunajs/beta?color=blue&label=npm)](https://www.npmjs.com/package/kizunajs/v/2.0.0-beta.25)
7
+ [![npm](https://img.shields.io/npm/v/kizunajs/beta?color=blue&label=npm)](https://www.npmjs.com/package/kizunajs/v/2.0.0-beta.27)
8
8
  ![license](https://img.shields.io/badge/license-MIT-blue)
9
9
 
10
10
  [Documentation](https://kizunajs.com)
@@ -673,11 +673,21 @@ type ApplyErrorEnvelope<Input, Status> = IsErrorStatus<Status> extends true ? (I
673
673
  type HandlerBody<S, Status> = S extends z.ZodType ? ApplyErrorEnvelope<z.input<S>, Status> : S extends StreamResponseDefinition ? IsErrorStatus<Status> extends true ? never : StreamBodyOf<S> : S extends {
674
674
  body: z.ZodType;
675
675
  } ? ApplyErrorEnvelope<z.input<S['body']>, Status> : never;
676
- type ResponseReturn<R extends Pick<RouteDefinition, 'responses'>, Status extends keyof R['responses']> = {
676
+ /**
677
+ * A response that carries no body, like a `204: z.void()`, may leave `body` out. A body
678
+ * that resolves to `never` stays required, so a status that cannot be returned still
679
+ * fails to compile.
680
+ */
681
+ type ResponseReturn<R extends Pick<RouteDefinition, 'responses'>, Status extends keyof R['responses']> = IsBodiless<HandlerBody<R['responses'][Status], Status>> extends true ? {
682
+ status: Status extends number ? Status : never;
683
+ body?: HandlerBody<R['responses'][Status], Status>;
684
+ headers?: ResponseHeaders;
685
+ } : {
677
686
  status: Status extends number ? Status : never;
678
687
  body: HandlerBody<R['responses'][Status], Status>;
679
688
  headers?: ResponseHeaders;
680
689
  };
690
+ type IsBodiless<Body> = [Body] extends [never] ? false : [Body] extends [undefined | void] ? true : false;
681
691
  /**
682
692
  * Constrained to `responses` alone so a job, which has no method or path, reuses it.
683
693
  */
@@ -673,11 +673,21 @@ type ApplyErrorEnvelope<Input, Status> = IsErrorStatus<Status> extends true ? (I
673
673
  type HandlerBody<S, Status> = S extends z.ZodType ? ApplyErrorEnvelope<z.input<S>, Status> : S extends StreamResponseDefinition ? IsErrorStatus<Status> extends true ? never : StreamBodyOf<S> : S extends {
674
674
  body: z.ZodType;
675
675
  } ? ApplyErrorEnvelope<z.input<S['body']>, Status> : never;
676
- type ResponseReturn<R extends Pick<RouteDefinition, 'responses'>, Status extends keyof R['responses']> = {
676
+ /**
677
+ * A response that carries no body, like a `204: z.void()`, may leave `body` out. A body
678
+ * that resolves to `never` stays required, so a status that cannot be returned still
679
+ * fails to compile.
680
+ */
681
+ type ResponseReturn<R extends Pick<RouteDefinition, 'responses'>, Status extends keyof R['responses']> = IsBodiless<HandlerBody<R['responses'][Status], Status>> extends true ? {
682
+ status: Status extends number ? Status : never;
683
+ body?: HandlerBody<R['responses'][Status], Status>;
684
+ headers?: ResponseHeaders;
685
+ } : {
677
686
  status: Status extends number ? Status : never;
678
687
  body: HandlerBody<R['responses'][Status], Status>;
679
688
  headers?: ResponseHeaders;
680
689
  };
690
+ type IsBodiless<Body> = [Body] extends [never] ? false : [Body] extends [undefined | void] ? true : false;
681
691
  /**
682
692
  * Constrained to `responses` alone so a job, which has no method or path, reuses it.
683
693
  */
@@ -1,3 +1,3 @@
1
1
  import { A as AutoResponsesBrand, B as ROUTES_GROUP, D as AUTO_RESPONSES_BRAND, I as HANDLER_CONTEXT_BRAND, K as RouteDefinition, L as HandlerContextBrand, T as AUTO_GUARD_BRAND, W as ResponseHeaders, Y as RoutePath, Z as Routes, at as ProblemDetails, c as authenticationChallenge, f as resolveSecurityRequirements, st as problemDetails, z as Method } from "./error-response-YbkRMKno.cjs";
2
- import { $ as jobRoutes, A as RenderedResult, B as bearerChallenge, Bi as toolOptionsOf, Bn as JobHandler, C as JOBS_META, Ci as isRouteDefinition, D as REQUEST_CONTEXT_META, Da as withPermissions, E as MountedOf, Ea as requiresDenial, F as RouteMatcher, Fi as buildToolInputSchema, G as dispatchRoute, Gr as isRawResponse, Gt as PluginExportsOf, H as contractOf, Ht as PluginDeclaration, I as SCHEMES_META, Ii as describeTool, In as FlattenedJob, It as ApiPlugins, J as getHeaderValue, Ji as buildPath, K as entriesToObject, Ki as PathSegment, Kr as rawResponse, L as ServerOptions, Li as selectToolRoutes, M as RequestContextRun, Mi as ToolDefinition, N as RequestPipeline, Ni as ToolInputSchema, O as ROUTER_META, P as ResponseValidationError, Pi as buildToolDefinitions, Pn as CompiledJob, Q as jobRouter, Qn as isCompiledJob, Qr as sortFlattenedRoutes, R as adapterContextOf, Ri as toolInputJsonSchema, S as HandlerContextOf, Si as formatValidationError, T as MountArgsOf, Ta as insufficientScope, U as defineAdapter, Un as JobHandlers, Ur as isGroupSet, Ut as PluginDefinition, V as boundJobKeys, Vi as toolRefusal, Vt as PluginArgs, W as dispatchHandler, Wr as RawResponse, Wt as PluginExportValues, X as headersToObject, Xr as RouteMatch, Xt as PluginRoutesOf, Y as guardDenyFor, Yi as parsePath, Yr as MatchResult, Yt as PluginRoutes, Z as isGuardDenial, Zi as EncodeStreamOptions, Zn as flattenJobs, Zr as matchRoute, _ as GuardDeny, a as AdapterRequest, an as pluginRouteTree, at as runHandler, b as HANDLER_ARG_KEYS, bi as allowedMethodsForPath, br as ScheduledJob, c as ApiBrand, cr as JobRunner, ct as ApiRouter, d as DISPATCH_ROUTE_KEY, di as RawInputs, dr as jobFnAt, dt as createApiReference, ei as BrandedHandlerContext, en as ResolvedPlugin, er as jobAt, et as jobRunnerFrom, f as ErrorFormatter, fi as RequestContextValues, fr as JobDescriptor, ft as pluginExportsOf, g as GuardDenialBody, gi as RoutesWithHandlerContext, h as GuardDenial, hi as Router, hr as JobTransport, ht as resolvePlugins, i as AdapterDefinition, ii as GuardParams, in as definePlugin, ir as JobInputError, it as routerFromRoutes, j as RequestContextMap, k as RUN_ROUTE_KEY, l as ApiParts, lr as JobRunnerOptions, lt as ResponseError, m as GUARD_SCHEMA_META, mi as RouteHandler, mr as JobMessage, mt as pluginRoutesOf, n as API_META, na as StreamContext, ni as FlattenedRoute, nt as parseFetchBody, o as AdapterResult, ot as runRoute, p as GUARDS_META, pr as JobDispatchError, pt as pluginRouterOf, q as extractCredential, qn as Jobs, r as Adapter, rr as JobFnByKey, rt as renderJsonResult, s as AnyAdapter, sa as encodeStreamBody, si as GuardedParamNames, st as warnUnsupportedJobOptions, t as ADAPTER_CONTEXT, ti as ContextFromAuth, tr as JobErrorHandler, tt as parseBodyText, u as ApiWithRouter, ui as HandlersFromRoutes, ur as createJobRunner, ut as groupRoutes, v as GuardMap, vi as ValidationFailure, vr as JobWorker, vt as isStreamResponse, w as JobsMeta, wa as AccessCheckInput, wi as validateRequest, x as HandleArgs, xi as flattenRoutes, xr as defineJobTransport, y as GuardRun, yi as ValidationStage, yr as JobWorkerContext, z as assembleApi, zi as toolJsonSchema } from "./adapter-D9E9bjxo.cjs";
2
+ import { $ as jobRoutes, A as RenderedResult, B as bearerChallenge, Bi as toolOptionsOf, Bn as JobHandler, C as JOBS_META, Ci as isRouteDefinition, D as REQUEST_CONTEXT_META, Da as withPermissions, E as MountedOf, Ea as requiresDenial, F as RouteMatcher, Fi as buildToolInputSchema, G as dispatchRoute, Gr as isRawResponse, Gt as PluginExportsOf, H as contractOf, Ht as PluginDeclaration, I as SCHEMES_META, Ii as describeTool, In as FlattenedJob, It as ApiPlugins, J as getHeaderValue, Ji as buildPath, K as entriesToObject, Ki as PathSegment, Kr as rawResponse, L as ServerOptions, Li as selectToolRoutes, M as RequestContextRun, Mi as ToolDefinition, N as RequestPipeline, Ni as ToolInputSchema, O as ROUTER_META, P as ResponseValidationError, Pi as buildToolDefinitions, Pn as CompiledJob, Q as jobRouter, Qn as isCompiledJob, Qr as sortFlattenedRoutes, R as adapterContextOf, Ri as toolInputJsonSchema, S as HandlerContextOf, Si as formatValidationError, T as MountArgsOf, Ta as insufficientScope, U as defineAdapter, Un as JobHandlers, Ur as isGroupSet, Ut as PluginDefinition, V as boundJobKeys, Vi as toolRefusal, Vt as PluginArgs, W as dispatchHandler, Wr as RawResponse, Wt as PluginExportValues, X as headersToObject, Xr as RouteMatch, Xt as PluginRoutesOf, Y as guardDenyFor, Yi as parsePath, Yr as MatchResult, Yt as PluginRoutes, Z as isGuardDenial, Zi as EncodeStreamOptions, Zn as flattenJobs, Zr as matchRoute, _ as GuardDeny, a as AdapterRequest, an as pluginRouteTree, at as runHandler, b as HANDLER_ARG_KEYS, bi as allowedMethodsForPath, br as ScheduledJob, c as ApiBrand, cr as JobRunner, ct as ApiRouter, d as DISPATCH_ROUTE_KEY, di as RawInputs, dr as jobFnAt, dt as createApiReference, ei as BrandedHandlerContext, en as ResolvedPlugin, er as jobAt, et as jobRunnerFrom, f as ErrorFormatter, fi as RequestContextValues, fr as JobDescriptor, ft as pluginExportsOf, g as GuardDenialBody, gi as RoutesWithHandlerContext, h as GuardDenial, hi as Router, hr as JobTransport, ht as resolvePlugins, i as AdapterDefinition, ii as GuardParams, in as definePlugin, ir as JobInputError, it as routerFromRoutes, j as RequestContextMap, k as RUN_ROUTE_KEY, l as ApiParts, lr as JobRunnerOptions, lt as ResponseError, m as GUARD_SCHEMA_META, mi as RouteHandler, mr as JobMessage, mt as pluginRoutesOf, n as API_META, na as StreamContext, ni as FlattenedRoute, nt as parseFetchBody, o as AdapterResult, ot as runRoute, p as GUARDS_META, pr as JobDispatchError, pt as pluginRouterOf, q as extractCredential, qn as Jobs, r as Adapter, rr as JobFnByKey, rt as renderJsonResult, s as AnyAdapter, sa as encodeStreamBody, si as GuardedParamNames, st as warnUnsupportedJobOptions, t as ADAPTER_CONTEXT, ti as ContextFromAuth, tr as JobErrorHandler, tt as parseBodyText, u as ApiWithRouter, ui as HandlersFromRoutes, ur as createJobRunner, ut as groupRoutes, v as GuardMap, vi as ValidationFailure, vr as JobWorker, vt as isStreamResponse, w as JobsMeta, wa as AccessCheckInput, wi as validateRequest, x as HandleArgs, xi as flattenRoutes, xr as defineJobTransport, y as GuardRun, yi as ValidationStage, yr as JobWorkerContext, z as assembleApi, zi as toolJsonSchema } from "./adapter-DSw79pNT.cjs";
3
3
  export { ADAPTER_CONTEXT, API_META, AUTO_GUARD_BRAND, AUTO_RESPONSES_BRAND, AccessCheckInput, Adapter, AdapterDefinition, AdapterRequest, AdapterResult, AnyAdapter, ApiBrand, ApiParts, ApiPlugins, ApiRouter, ApiWithRouter, AutoResponsesBrand, BrandedHandlerContext, CompiledJob, ContextFromAuth, DISPATCH_ROUTE_KEY, EncodeStreamOptions, ErrorFormatter, FlattenedJob, FlattenedRoute, GUARDS_META, GUARD_SCHEMA_META, GuardDenial, GuardDenialBody, GuardDeny, GuardMap, GuardParams, GuardRun, GuardedParamNames, HANDLER_ARG_KEYS, HANDLER_CONTEXT_BRAND, HandleArgs, HandlerContextBrand, HandlerContextOf, HandlersFromRoutes, JOBS_META, JobDescriptor, JobDispatchError, JobErrorHandler, JobFnByKey, JobHandler, JobHandlers, JobInputError, JobMessage, JobRunner, JobRunnerOptions, JobTransport, JobWorker, JobWorkerContext, Jobs, JobsMeta, MatchResult, Method, MountArgsOf, MountedOf, PathSegment, PluginArgs, PluginDeclaration, PluginDefinition, PluginExportValues, PluginExportsOf, PluginRoutes, PluginRoutesOf, ProblemDetails, REQUEST_CONTEXT_META, ROUTER_META, ROUTES_GROUP, RUN_ROUTE_KEY, RawInputs, RawResponse, RenderedResult, RequestContextMap, RequestContextRun, RequestContextValues, RequestPipeline, ResolvedPlugin, ResponseError, ResponseHeaders, ResponseValidationError, RouteDefinition, RouteHandler, RouteMatch, RouteMatcher, RoutePath, Router, Routes, RoutesWithHandlerContext, SCHEMES_META, ScheduledJob, ServerOptions, StreamContext, ToolDefinition, ToolInputSchema, ValidationFailure, ValidationStage, adapterContextOf, allowedMethodsForPath, assembleApi, authenticationChallenge, bearerChallenge, boundJobKeys, buildPath, buildToolDefinitions, buildToolInputSchema, contractOf, createApiReference, createJobRunner, defineAdapter, defineJobTransport, definePlugin, describeTool, dispatchHandler, dispatchRoute, encodeStreamBody, entriesToObject, extractCredential, flattenJobs, flattenRoutes, formatValidationError, getHeaderValue, groupRoutes, guardDenyFor, headersToObject, insufficientScope, isCompiledJob, isGroupSet, isGuardDenial, isRawResponse, isRouteDefinition, isStreamResponse, jobAt, jobFnAt, jobRouter, jobRoutes, jobRunnerFrom, matchRoute, parseBodyText, parseFetchBody, parsePath, pluginExportsOf, pluginRouteTree, pluginRouterOf, pluginRoutesOf, problemDetails, rawResponse, renderJsonResult, requiresDenial, resolvePlugins, resolveSecurityRequirements, routerFromRoutes, runHandler, runRoute, selectToolRoutes, sortFlattenedRoutes, toolInputJsonSchema, toolJsonSchema, toolOptionsOf, toolRefusal, validateRequest, warnUnsupportedJobOptions, withPermissions };
@@ -1,3 +1,3 @@
1
1
  import { A as AutoResponsesBrand, B as ROUTES_GROUP, D as AUTO_RESPONSES_BRAND, I as HANDLER_CONTEXT_BRAND, K as RouteDefinition, L as HandlerContextBrand, T as AUTO_GUARD_BRAND, W as ResponseHeaders, Y as RoutePath, Z as Routes, at as ProblemDetails, c as authenticationChallenge, f as resolveSecurityRequirements, st as problemDetails, z as Method } from "./error-response-NoOGdh8H.mjs";
2
- import { $ as jobRoutes, A as RenderedResult, B as bearerChallenge, Bi as toolOptionsOf, Bn as JobHandler, C as JOBS_META, Ci as isRouteDefinition, D as REQUEST_CONTEXT_META, Da as withPermissions, E as MountedOf, Ea as requiresDenial, F as RouteMatcher, Fi as buildToolInputSchema, G as dispatchRoute, Gr as isRawResponse, Gt as PluginExportsOf, H as contractOf, Ht as PluginDeclaration, I as SCHEMES_META, Ii as describeTool, In as FlattenedJob, It as ApiPlugins, J as getHeaderValue, Ji as buildPath, K as entriesToObject, Ki as PathSegment, Kr as rawResponse, L as ServerOptions, Li as selectToolRoutes, M as RequestContextRun, Mi as ToolDefinition, N as RequestPipeline, Ni as ToolInputSchema, O as ROUTER_META, P as ResponseValidationError, Pi as buildToolDefinitions, Pn as CompiledJob, Q as jobRouter, Qn as isCompiledJob, Qr as sortFlattenedRoutes, R as adapterContextOf, Ri as toolInputJsonSchema, S as HandlerContextOf, Si as formatValidationError, T as MountArgsOf, Ta as insufficientScope, U as defineAdapter, Un as JobHandlers, Ur as isGroupSet, Ut as PluginDefinition, V as boundJobKeys, Vi as toolRefusal, Vt as PluginArgs, W as dispatchHandler, Wr as RawResponse, Wt as PluginExportValues, X as headersToObject, Xr as RouteMatch, Xt as PluginRoutesOf, Y as guardDenyFor, Yi as parsePath, Yr as MatchResult, Yt as PluginRoutes, Z as isGuardDenial, Zi as EncodeStreamOptions, Zn as flattenJobs, Zr as matchRoute, _ as GuardDeny, a as AdapterRequest, an as pluginRouteTree, at as runHandler, b as HANDLER_ARG_KEYS, bi as allowedMethodsForPath, br as ScheduledJob, c as ApiBrand, cr as JobRunner, ct as ApiRouter, d as DISPATCH_ROUTE_KEY, di as RawInputs, dr as jobFnAt, dt as createApiReference, ei as BrandedHandlerContext, en as ResolvedPlugin, er as jobAt, et as jobRunnerFrom, f as ErrorFormatter, fi as RequestContextValues, fr as JobDescriptor, ft as pluginExportsOf, g as GuardDenialBody, gi as RoutesWithHandlerContext, h as GuardDenial, hi as Router, hr as JobTransport, ht as resolvePlugins, i as AdapterDefinition, ii as GuardParams, in as definePlugin, ir as JobInputError, it as routerFromRoutes, j as RequestContextMap, k as RUN_ROUTE_KEY, l as ApiParts, lr as JobRunnerOptions, lt as ResponseError, m as GUARD_SCHEMA_META, mi as RouteHandler, mr as JobMessage, mt as pluginRoutesOf, n as API_META, na as StreamContext, ni as FlattenedRoute, nt as parseFetchBody, o as AdapterResult, ot as runRoute, p as GUARDS_META, pr as JobDispatchError, pt as pluginRouterOf, q as extractCredential, qn as Jobs, r as Adapter, rr as JobFnByKey, rt as renderJsonResult, s as AnyAdapter, sa as encodeStreamBody, si as GuardedParamNames, st as warnUnsupportedJobOptions, t as ADAPTER_CONTEXT, ti as ContextFromAuth, tr as JobErrorHandler, tt as parseBodyText, u as ApiWithRouter, ui as HandlersFromRoutes, ur as createJobRunner, ut as groupRoutes, v as GuardMap, vi as ValidationFailure, vr as JobWorker, vt as isStreamResponse, w as JobsMeta, wa as AccessCheckInput, wi as validateRequest, x as HandleArgs, xi as flattenRoutes, xr as defineJobTransport, y as GuardRun, yi as ValidationStage, yr as JobWorkerContext, z as assembleApi, zi as toolJsonSchema } from "./adapter-Pi82GO4c.mjs";
2
+ import { $ as jobRoutes, A as RenderedResult, B as bearerChallenge, Bi as toolOptionsOf, Bn as JobHandler, C as JOBS_META, Ci as isRouteDefinition, D as REQUEST_CONTEXT_META, Da as withPermissions, E as MountedOf, Ea as requiresDenial, F as RouteMatcher, Fi as buildToolInputSchema, G as dispatchRoute, Gr as isRawResponse, Gt as PluginExportsOf, H as contractOf, Ht as PluginDeclaration, I as SCHEMES_META, Ii as describeTool, In as FlattenedJob, It as ApiPlugins, J as getHeaderValue, Ji as buildPath, K as entriesToObject, Ki as PathSegment, Kr as rawResponse, L as ServerOptions, Li as selectToolRoutes, M as RequestContextRun, Mi as ToolDefinition, N as RequestPipeline, Ni as ToolInputSchema, O as ROUTER_META, P as ResponseValidationError, Pi as buildToolDefinitions, Pn as CompiledJob, Q as jobRouter, Qn as isCompiledJob, Qr as sortFlattenedRoutes, R as adapterContextOf, Ri as toolInputJsonSchema, S as HandlerContextOf, Si as formatValidationError, T as MountArgsOf, Ta as insufficientScope, U as defineAdapter, Un as JobHandlers, Ur as isGroupSet, Ut as PluginDefinition, V as boundJobKeys, Vi as toolRefusal, Vt as PluginArgs, W as dispatchHandler, Wr as RawResponse, Wt as PluginExportValues, X as headersToObject, Xr as RouteMatch, Xt as PluginRoutesOf, Y as guardDenyFor, Yi as parsePath, Yr as MatchResult, Yt as PluginRoutes, Z as isGuardDenial, Zi as EncodeStreamOptions, Zn as flattenJobs, Zr as matchRoute, _ as GuardDeny, a as AdapterRequest, an as pluginRouteTree, at as runHandler, b as HANDLER_ARG_KEYS, bi as allowedMethodsForPath, br as ScheduledJob, c as ApiBrand, cr as JobRunner, ct as ApiRouter, d as DISPATCH_ROUTE_KEY, di as RawInputs, dr as jobFnAt, dt as createApiReference, ei as BrandedHandlerContext, en as ResolvedPlugin, er as jobAt, et as jobRunnerFrom, f as ErrorFormatter, fi as RequestContextValues, fr as JobDescriptor, ft as pluginExportsOf, g as GuardDenialBody, gi as RoutesWithHandlerContext, h as GuardDenial, hi as Router, hr as JobTransport, ht as resolvePlugins, i as AdapterDefinition, ii as GuardParams, in as definePlugin, ir as JobInputError, it as routerFromRoutes, j as RequestContextMap, k as RUN_ROUTE_KEY, l as ApiParts, lr as JobRunnerOptions, lt as ResponseError, m as GUARD_SCHEMA_META, mi as RouteHandler, mr as JobMessage, mt as pluginRoutesOf, n as API_META, na as StreamContext, ni as FlattenedRoute, nt as parseFetchBody, o as AdapterResult, ot as runRoute, p as GUARDS_META, pr as JobDispatchError, pt as pluginRouterOf, q as extractCredential, qn as Jobs, r as Adapter, rr as JobFnByKey, rt as renderJsonResult, s as AnyAdapter, sa as encodeStreamBody, si as GuardedParamNames, st as warnUnsupportedJobOptions, t as ADAPTER_CONTEXT, ti as ContextFromAuth, tr as JobErrorHandler, tt as parseBodyText, u as ApiWithRouter, ui as HandlersFromRoutes, ur as createJobRunner, ut as groupRoutes, v as GuardMap, vi as ValidationFailure, vr as JobWorker, vt as isStreamResponse, w as JobsMeta, wa as AccessCheckInput, wi as validateRequest, x as HandleArgs, xi as flattenRoutes, xr as defineJobTransport, y as GuardRun, yi as ValidationStage, yr as JobWorkerContext, z as assembleApi, zi as toolJsonSchema } from "./adapter-DxFLPtzt.mjs";
3
3
  export { ADAPTER_CONTEXT, API_META, AUTO_GUARD_BRAND, AUTO_RESPONSES_BRAND, AccessCheckInput, Adapter, AdapterDefinition, AdapterRequest, AdapterResult, AnyAdapter, ApiBrand, ApiParts, ApiPlugins, ApiRouter, ApiWithRouter, AutoResponsesBrand, BrandedHandlerContext, CompiledJob, ContextFromAuth, DISPATCH_ROUTE_KEY, EncodeStreamOptions, ErrorFormatter, FlattenedJob, FlattenedRoute, GUARDS_META, GUARD_SCHEMA_META, GuardDenial, GuardDenialBody, GuardDeny, GuardMap, GuardParams, GuardRun, GuardedParamNames, HANDLER_ARG_KEYS, HANDLER_CONTEXT_BRAND, HandleArgs, HandlerContextBrand, HandlerContextOf, HandlersFromRoutes, JOBS_META, JobDescriptor, JobDispatchError, JobErrorHandler, JobFnByKey, JobHandler, JobHandlers, JobInputError, JobMessage, JobRunner, JobRunnerOptions, JobTransport, JobWorker, JobWorkerContext, Jobs, JobsMeta, MatchResult, Method, MountArgsOf, MountedOf, PathSegment, PluginArgs, PluginDeclaration, PluginDefinition, PluginExportValues, PluginExportsOf, PluginRoutes, PluginRoutesOf, ProblemDetails, REQUEST_CONTEXT_META, ROUTER_META, ROUTES_GROUP, RUN_ROUTE_KEY, RawInputs, RawResponse, RenderedResult, RequestContextMap, RequestContextRun, RequestContextValues, RequestPipeline, ResolvedPlugin, ResponseError, ResponseHeaders, ResponseValidationError, RouteDefinition, RouteHandler, RouteMatch, RouteMatcher, RoutePath, Router, Routes, RoutesWithHandlerContext, SCHEMES_META, ScheduledJob, ServerOptions, StreamContext, ToolDefinition, ToolInputSchema, ValidationFailure, ValidationStage, adapterContextOf, allowedMethodsForPath, assembleApi, authenticationChallenge, bearerChallenge, boundJobKeys, buildPath, buildToolDefinitions, buildToolInputSchema, contractOf, createApiReference, createJobRunner, defineAdapter, defineJobTransport, definePlugin, describeTool, dispatchHandler, dispatchRoute, encodeStreamBody, entriesToObject, extractCredential, flattenJobs, flattenRoutes, formatValidationError, getHeaderValue, groupRoutes, guardDenyFor, headersToObject, insufficientScope, isCompiledJob, isGroupSet, isGuardDenial, isRawResponse, isRouteDefinition, isStreamResponse, jobAt, jobFnAt, jobRouter, jobRoutes, jobRunnerFrom, matchRoute, parseBodyText, parseFetchBody, parsePath, pluginExportsOf, pluginRouteTree, pluginRouterOf, pluginRoutesOf, problemDetails, rawResponse, renderJsonResult, requiresDenial, resolvePlugins, resolveSecurityRequirements, routerFromRoutes, runHandler, runRoute, selectToolRoutes, sortFlattenedRoutes, toolInputJsonSchema, toolJsonSchema, toolOptionsOf, toolRefusal, validateRequest, warnUnsupportedJobOptions, withPermissions };
@@ -1,5 +1,5 @@
1
1
  import { K as RouteDefinition, W as ResponseHeaders, Z as Routes, j as CachePolicy } from "./error-response-YbkRMKno.cjs";
2
- import { At as sanitizeIdentifier, Cn as GeneratedFile, Ct as resolveResponseBody, Dt as resolveResponseHeaders, Et as resolveResponseEtag, In as FlattenedJob, Mt as statusToCamelCase, Nt as toCamelCase, Ot as resolveResponseStream, Pn as CompiledJob, Pt as toPascalCase, Qn as isCompiledJob, St as mergeHeaderFields, Tn as ApiDefinition, Tt as resolveResponseContentType, Xi as EVENT_STREAM_MEDIA_TYPE, Yi as parsePath, Zn as flattenJobs, _t as isJsonMediaType, aa as StreamMode, bt as isZodSchema, ca as isNamedStream, da as streamContentType, er as jobAt, fa as streamMode, gt as isHintPrefix, jt as shortTypeName, kt as sanitizeFieldName, la as routeStreams, ma as streamStatuses, pa as streamSchemas, qn as Jobs, ua as soleStreamResponse, vt as isStreamResponse, wt as resolveResponseCache, xt as localTypeName, yt as isSuccessStatus } from "./adapter-D9E9bjxo.cjs";
2
+ import { At as sanitizeIdentifier, Cn as GeneratedFile, Ct as resolveResponseBody, Dt as resolveResponseHeaders, Et as resolveResponseEtag, In as FlattenedJob, Mt as statusToCamelCase, Nt as toCamelCase, Ot as resolveResponseStream, Pn as CompiledJob, Pt as toPascalCase, Qn as isCompiledJob, St as mergeHeaderFields, Tn as ApiDefinition, Tt as resolveResponseContentType, Xi as EVENT_STREAM_MEDIA_TYPE, Yi as parsePath, Zn as flattenJobs, _t as isJsonMediaType, aa as StreamMode, bt as isZodSchema, ca as isNamedStream, da as streamContentType, er as jobAt, fa as streamMode, gt as isHintPrefix, jt as shortTypeName, kt as sanitizeFieldName, la as routeStreams, ma as streamStatuses, pa as streamSchemas, qn as Jobs, ua as soleStreamResponse, vt as isStreamResponse, wt as resolveResponseCache, xt as localTypeName, yt as isSuccessStatus } from "./adapter-DSw79pNT.cjs";
3
3
  import { z } from "zod";
4
4
 
5
5
  //#region src/zod-internals.d.ts
@@ -1,5 +1,5 @@
1
1
  import { K as RouteDefinition, W as ResponseHeaders, Z as Routes, j as CachePolicy } from "./error-response-NoOGdh8H.mjs";
2
- import { At as sanitizeIdentifier, Cn as GeneratedFile, Ct as resolveResponseBody, Dt as resolveResponseHeaders, Et as resolveResponseEtag, In as FlattenedJob, Mt as statusToCamelCase, Nt as toCamelCase, Ot as resolveResponseStream, Pn as CompiledJob, Pt as toPascalCase, Qn as isCompiledJob, St as mergeHeaderFields, Tn as ApiDefinition, Tt as resolveResponseContentType, Xi as EVENT_STREAM_MEDIA_TYPE, Yi as parsePath, Zn as flattenJobs, _t as isJsonMediaType, aa as StreamMode, bt as isZodSchema, ca as isNamedStream, da as streamContentType, er as jobAt, fa as streamMode, gt as isHintPrefix, jt as shortTypeName, kt as sanitizeFieldName, la as routeStreams, ma as streamStatuses, pa as streamSchemas, qn as Jobs, ua as soleStreamResponse, vt as isStreamResponse, wt as resolveResponseCache, xt as localTypeName, yt as isSuccessStatus } from "./adapter-Pi82GO4c.mjs";
2
+ import { At as sanitizeIdentifier, Cn as GeneratedFile, Ct as resolveResponseBody, Dt as resolveResponseHeaders, Et as resolveResponseEtag, In as FlattenedJob, Mt as statusToCamelCase, Nt as toCamelCase, Ot as resolveResponseStream, Pn as CompiledJob, Pt as toPascalCase, Qn as isCompiledJob, St as mergeHeaderFields, Tn as ApiDefinition, Tt as resolveResponseContentType, Xi as EVENT_STREAM_MEDIA_TYPE, Yi as parsePath, Zn as flattenJobs, _t as isJsonMediaType, aa as StreamMode, bt as isZodSchema, ca as isNamedStream, da as streamContentType, er as jobAt, fa as streamMode, gt as isHintPrefix, jt as shortTypeName, kt as sanitizeFieldName, la as routeStreams, ma as streamStatuses, pa as streamSchemas, qn as Jobs, ua as soleStreamResponse, vt as isStreamResponse, wt as resolveResponseCache, xt as localTypeName, yt as isSuccessStatus } from "./adapter-DxFLPtzt.mjs";
3
3
  import { z } from "zod";
4
4
 
5
5
  //#region src/zod-internals.d.ts
package/dist/index.d.cts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { $ as SecurityRequirement, A as AutoResponsesBrand, B as ROUTES_GROUP, C as isPermissions, D as AUTO_RESPONSES_BRAND, E as AUTO_GUARD_WRITTEN_BRAND, F as HANDLER, G as RouteAuth, H as ResponseContentType, I as HANDLER_CONTEXT_BRAND, J as RouteHiddenToolCheck, K as RouteDefinition, L as HandlerContextBrand, M as DECLARATION, N as DeclarationKind, O as AuthoredRouteDefinition, P as GuardStatus, Q as SchemeNameOf, R as METHODS, S as createRoles, T as AUTO_GUARD_BRAND, U as ResponseDefinition, V as RequiredPermissions, X as RouteToolOptions, Y as RoutePath, Z as Routes, _ as PermissionSet, a as OAuthFlows, at as ProblemDetails, b as RoleNamesOf, ct as problemFromBody, d as isSecurityScheme, et as StreamDefinition, g as PermissionName, h as PermissionCatalog, i as OAuthFlow, it as GuardSchemaCheck, j as CachePolicy, k as AuthoredRoutes, l as authorizationServerIssuer, lt as STATUS_TITLES, m as GrantNamesOf, n as isProblemDetails, nt as GuardBody, o as OpenApiSecuritySchemeObject, ot as StripProblemEnvelope, p as CatalogOf, q as RouteHandlerFunction, r as ContextOf, rt as GuardOutput, s as SecurityScheme, st as problemDetails, tt as StreamResponseDefinition, u as declaredScopes, ut as getStatusText, v as Permissions, w as isRoles, x as Roles, y as RoleDefinition, z as Method } from "./error-response-YbkRMKno.cjs";
2
- import { $i as StreamBodyOf, $n as isJobDefinition, $r as AuthContextOf, $t as PluginsBySlug, Aa as BasicConfig, Ai as ToolRunOptions, An as RoutesOf, Ar as parseCron, Ba as IdentityParamsOf, Bn as JobHandler, Br as GroupSet, Bt as PluginApi, Ca as toolEvents, Ci as isRouteDefinition, Cn as GeneratedFile, Cr as ParsedCron, Di as ToolAnswer, Dn as GuardSchemaOf, Dr as firesBetween, E as MountedOf, Ei as StreamTools, En as ApiPluginsOf, Er as dueSchedules, Fa as CredentialOf, Fn as CompiledJobs, Fr as RequestContextHeaderValues, Ft as AnyPlugin, Ga as RoleOf, Gi as PathParamsCheck, Gn as JobRunnerConfig, Gt as PluginExportsOf, Ha as NoCredential, Hi as ExtractPathParams, Hn as JobHandlerReturn, Hr as createGroups, Ht as PluginDeclaration, Ia as CustomConfig, In as FlattenedJob, Ir as RequestContextSchema, It as ApiPlugins, J as getHeaderValue, Ji as buildPath, Jn as JobsArg, Jr as RouteWithHandler, Ka as RolesOf, Kn as JobVoidReturn, Kt as PluginFactory, La as GrantsOf, Ln as HttpJobsConfig, Lr as GroupOptions, Ma as BearerConfig, Mi as ToolDefinition, Mn as AuthoredJobDefinition, Mr as scheduleTimezone, Na as BearerCredential, Nn as AuthoredJobs, Nr as RequestContextConfig, Oa as ApiKeyConfig, Oi as ToolEventYield, On as JobsOf, Or as nextRun, Pa as Credential, Pn as CompiledJob, Pr as RequestContextHeaderInputs, Qi as StreamBody, Qn as isCompiledJob, Qt as PluginSetupContext, Ra as GuardHoldings, Rn as InProcessJobsConfig, Rr as GroupPaths, Sa as expandStreamTools, Sn as DiffSettings, Sr as JobSchedule, T as MountArgsOf, Ti as ModelToolCall, Tn as ApiDefinition, Tr as cron, Ua as OAuth2Config, Ui as HasPathParams, Un as JobHandlers, Ut as PluginDefinition, Va as IdentityRole, Vn as JobHandlerArgs, Vr as ResolvedGroup, Vt as PluginArgs, Wa as OpenIdConnectConfig, Wi as PathParamName, Wn as JobResponses, Wt as PluginExportValues, Xi as EVENT_STREAM_MEDIA_TYPE, Xn as NoJobs, Xt as PluginRoutesOf, Yi as parsePath, Yn as JobsConfig, Yt as PluginRoutes, Zn as flattenJobs, Zt as PluginSetup, _ as GuardDeny, _a as ToolCall, _i as ThrowableReturn, _n as ConfiguredRequestContextSchemas, _r as JobTransportSupports, aa as StreamMode, ai as GuardReturn, ar as JobQueueArgs, ba as ToolKeys, bn as KizunaConfigShape, br as ScheduledJob, bt as isZodSchema, ca as isNamedStream, ci as HandlerArgs, cn as ConfiguredAdapterContext, cr as JobRunner, da as streamContentType, dn as ConfiguredGroups, dr as jobFnAt, ea as StreamChunk, ei as BrandedHandlerContext, er as jobAt, fa as streamMode, fn as ConfiguredGuardSchema, fr as JobDescriptor, ga as ToolAt, gi as RoutesWithHandlerContext, gn as ConfiguredRequestContext, gr as JobTransportDefinition, h as GuardDenial, ha as StreamWithTools, hn as ConfiguredPlugins, hr as JobTransport, ia as StreamMessageOf, in as definePlugin, ir as JobInputError, ja as BasicCredential, ji as ToolRunResult, jn as SchemesOf, jr as scheduleExpression, ka as ApiKeyCredential, ki as ToolRunCall, kn as RequestContextOf, kr as nextRuns, la as routeStreams, li as HandlerReturn, ln as ConfiguredAdapterValue, lr as JobRunnerOptions, lt as ResponseError, ma as streamStatuses, mn as ConfiguredJobs, mr as JobMessage, na as StreamContext, nr as JobFn, oa as StreamYield, oi as GuardSuccess, or as JobQueueOptions, pi as RouteGuardBrandOf, pn as ConfiguredIdentities, pr as JobDispatchError, qi as RoutePathParamsCheck, qn as Jobs, qr as RouteBuilder, qt as PluginList, ra as StreamMessage, ri as GuardAnswer, rr as JobFnByKey, s as AnyAdapter, sr as JobRunArgs, ta as StreamComment, ti as ContextFromAuth, tr as JobErrorHandler, u as ApiWithRouter, ua as soleStreamResponse, un as ConfiguredCodes, ur as createJobRunner, va as ToolError, vn as JobFnOf, vr as JobWorker, vt as isStreamResponse, wn as apiEntries, wr as assertValidSchedule, xa as ToolResult, xn as ApiEntry, xr as defineJobTransport, ya as ToolEvents, yn as JobsOfTree, yr as JobWorkerContext, za as Identity, zn as JobDefinition, zr as GroupPathsOf } from "./adapter-D9E9bjxo.cjs";
2
+ import { $i as StreamBodyOf, $n as isJobDefinition, $r as AuthContextOf, $t as PluginsBySlug, Aa as BasicConfig, Ai as ToolRunOptions, An as RoutesOf, Ar as parseCron, Ba as IdentityParamsOf, Bn as JobHandler, Br as GroupSet, Bt as PluginApi, Ca as toolEvents, Ci as isRouteDefinition, Cn as GeneratedFile, Cr as ParsedCron, Di as ToolAnswer, Dn as GuardSchemaOf, Dr as firesBetween, E as MountedOf, Ei as StreamTools, En as ApiPluginsOf, Er as dueSchedules, Fa as CredentialOf, Fn as CompiledJobs, Fr as RequestContextHeaderValues, Ft as AnyPlugin, Ga as RoleOf, Gi as PathParamsCheck, Gn as JobRunnerConfig, Gt as PluginExportsOf, Ha as NoCredential, Hi as ExtractPathParams, Hn as JobHandlerReturn, Hr as createGroups, Ht as PluginDeclaration, Ia as CustomConfig, In as FlattenedJob, Ir as RequestContextSchema, It as ApiPlugins, J as getHeaderValue, Ji as buildPath, Jn as JobsArg, Jr as RouteWithHandler, Ka as RolesOf, Kn as JobVoidReturn, Kt as PluginFactory, La as GrantsOf, Ln as HttpJobsConfig, Lr as GroupOptions, Ma as BearerConfig, Mi as ToolDefinition, Mn as AuthoredJobDefinition, Mr as scheduleTimezone, Na as BearerCredential, Nn as AuthoredJobs, Nr as RequestContextConfig, Oa as ApiKeyConfig, Oi as ToolEventYield, On as JobsOf, Or as nextRun, Pa as Credential, Pn as CompiledJob, Pr as RequestContextHeaderInputs, Qi as StreamBody, Qn as isCompiledJob, Qt as PluginSetupContext, Ra as GuardHoldings, Rn as InProcessJobsConfig, Rr as GroupPaths, Sa as expandStreamTools, Sn as DiffSettings, Sr as JobSchedule, T as MountArgsOf, Ti as ModelToolCall, Tn as ApiDefinition, Tr as cron, Ua as OAuth2Config, Ui as HasPathParams, Un as JobHandlers, Ut as PluginDefinition, Va as IdentityRole, Vn as JobHandlerArgs, Vr as ResolvedGroup, Vt as PluginArgs, Wa as OpenIdConnectConfig, Wi as PathParamName, Wn as JobResponses, Wt as PluginExportValues, Xi as EVENT_STREAM_MEDIA_TYPE, Xn as NoJobs, Xt as PluginRoutesOf, Yi as parsePath, Yn as JobsConfig, Yt as PluginRoutes, Zn as flattenJobs, Zt as PluginSetup, _ as GuardDeny, _a as ToolCall, _i as ThrowableReturn, _n as ConfiguredRequestContextSchemas, _r as JobTransportSupports, aa as StreamMode, ai as GuardReturn, ar as JobQueueArgs, ba as ToolKeys, bn as KizunaConfigShape, br as ScheduledJob, bt as isZodSchema, ca as isNamedStream, ci as HandlerArgs, cn as ConfiguredAdapterContext, cr as JobRunner, da as streamContentType, dn as ConfiguredGroups, dr as jobFnAt, ea as StreamChunk, ei as BrandedHandlerContext, er as jobAt, fa as streamMode, fn as ConfiguredGuardSchema, fr as JobDescriptor, ga as ToolAt, gi as RoutesWithHandlerContext, gn as ConfiguredRequestContext, gr as JobTransportDefinition, h as GuardDenial, ha as StreamWithTools, hn as ConfiguredPlugins, hr as JobTransport, ia as StreamMessageOf, in as definePlugin, ir as JobInputError, ja as BasicCredential, ji as ToolRunResult, jn as SchemesOf, jr as scheduleExpression, ka as ApiKeyCredential, ki as ToolRunCall, kn as RequestContextOf, kr as nextRuns, la as routeStreams, li as HandlerReturn, ln as ConfiguredAdapterValue, lr as JobRunnerOptions, lt as ResponseError, ma as streamStatuses, mn as ConfiguredJobs, mr as JobMessage, na as StreamContext, nr as JobFn, oa as StreamYield, oi as GuardSuccess, or as JobQueueOptions, pi as RouteGuardBrandOf, pn as ConfiguredIdentities, pr as JobDispatchError, qi as RoutePathParamsCheck, qn as Jobs, qr as RouteBuilder, qt as PluginList, ra as StreamMessage, ri as GuardAnswer, rr as JobFnByKey, s as AnyAdapter, sr as JobRunArgs, ta as StreamComment, ti as ContextFromAuth, tr as JobErrorHandler, u as ApiWithRouter, ua as soleStreamResponse, un as ConfiguredCodes, ur as createJobRunner, va as ToolError, vn as JobFnOf, vr as JobWorker, vt as isStreamResponse, wn as apiEntries, wr as assertValidSchedule, xa as ToolResult, xn as ApiEntry, xr as defineJobTransport, ya as ToolEvents, yn as JobsOfTree, yr as JobWorkerContext, za as Identity, zn as JobDefinition, zr as GroupPathsOf } from "./adapter-DSw79pNT.cjs";
3
3
  import { a as buildProtectedResourceMetadata, c as ValidationErrorFor, d as isValidationError, i as assertCanonicalResourceUri, n as ProtectedResourceMetadata, o as BuiltinIssueCode, s as ValidationError, t as ProtectedResourceConfig, u as ValidationIssueCode } from "./protected-resource-metadata-B9hMFQ9N.cjs";
4
4
  import { z } from "zod";
5
5
  import { $input, $output } from "zod/v4/core";
package/dist/index.d.mts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { $ as SecurityRequirement, A as AutoResponsesBrand, B as ROUTES_GROUP, C as isPermissions, D as AUTO_RESPONSES_BRAND, E as AUTO_GUARD_WRITTEN_BRAND, F as HANDLER, G as RouteAuth, H as ResponseContentType, I as HANDLER_CONTEXT_BRAND, J as RouteHiddenToolCheck, K as RouteDefinition, L as HandlerContextBrand, M as DECLARATION, N as DeclarationKind, O as AuthoredRouteDefinition, P as GuardStatus, Q as SchemeNameOf, R as METHODS, S as createRoles, T as AUTO_GUARD_BRAND, U as ResponseDefinition, V as RequiredPermissions, X as RouteToolOptions, Y as RoutePath, Z as Routes, _ as PermissionSet, a as OAuthFlows, at as ProblemDetails, b as RoleNamesOf, ct as problemFromBody, d as isSecurityScheme, et as StreamDefinition, g as PermissionName, h as PermissionCatalog, i as OAuthFlow, it as GuardSchemaCheck, j as CachePolicy, k as AuthoredRoutes, l as authorizationServerIssuer, lt as STATUS_TITLES, m as GrantNamesOf, n as isProblemDetails, nt as GuardBody, o as OpenApiSecuritySchemeObject, ot as StripProblemEnvelope, p as CatalogOf, q as RouteHandlerFunction, r as ContextOf, rt as GuardOutput, s as SecurityScheme, st as problemDetails, tt as StreamResponseDefinition, u as declaredScopes, ut as getStatusText, v as Permissions, w as isRoles, x as Roles, y as RoleDefinition, z as Method } from "./error-response-NoOGdh8H.mjs";
2
- import { $i as StreamBodyOf, $n as isJobDefinition, $r as AuthContextOf, $t as PluginsBySlug, Aa as BasicConfig, Ai as ToolRunOptions, An as RoutesOf, Ar as parseCron, Ba as IdentityParamsOf, Bn as JobHandler, Br as GroupSet, Bt as PluginApi, Ca as toolEvents, Ci as isRouteDefinition, Cn as GeneratedFile, Cr as ParsedCron, Di as ToolAnswer, Dn as GuardSchemaOf, Dr as firesBetween, E as MountedOf, Ei as StreamTools, En as ApiPluginsOf, Er as dueSchedules, Fa as CredentialOf, Fn as CompiledJobs, Fr as RequestContextHeaderValues, Ft as AnyPlugin, Ga as RoleOf, Gi as PathParamsCheck, Gn as JobRunnerConfig, Gt as PluginExportsOf, Ha as NoCredential, Hi as ExtractPathParams, Hn as JobHandlerReturn, Hr as createGroups, Ht as PluginDeclaration, Ia as CustomConfig, In as FlattenedJob, Ir as RequestContextSchema, It as ApiPlugins, J as getHeaderValue, Ji as buildPath, Jn as JobsArg, Jr as RouteWithHandler, Ka as RolesOf, Kn as JobVoidReturn, Kt as PluginFactory, La as GrantsOf, Ln as HttpJobsConfig, Lr as GroupOptions, Ma as BearerConfig, Mi as ToolDefinition, Mn as AuthoredJobDefinition, Mr as scheduleTimezone, Na as BearerCredential, Nn as AuthoredJobs, Nr as RequestContextConfig, Oa as ApiKeyConfig, Oi as ToolEventYield, On as JobsOf, Or as nextRun, Pa as Credential, Pn as CompiledJob, Pr as RequestContextHeaderInputs, Qi as StreamBody, Qn as isCompiledJob, Qt as PluginSetupContext, Ra as GuardHoldings, Rn as InProcessJobsConfig, Rr as GroupPaths, Sa as expandStreamTools, Sn as DiffSettings, Sr as JobSchedule, T as MountArgsOf, Ti as ModelToolCall, Tn as ApiDefinition, Tr as cron, Ua as OAuth2Config, Ui as HasPathParams, Un as JobHandlers, Ut as PluginDefinition, Va as IdentityRole, Vn as JobHandlerArgs, Vr as ResolvedGroup, Vt as PluginArgs, Wa as OpenIdConnectConfig, Wi as PathParamName, Wn as JobResponses, Wt as PluginExportValues, Xi as EVENT_STREAM_MEDIA_TYPE, Xn as NoJobs, Xt as PluginRoutesOf, Yi as parsePath, Yn as JobsConfig, Yt as PluginRoutes, Zn as flattenJobs, Zt as PluginSetup, _ as GuardDeny, _a as ToolCall, _i as ThrowableReturn, _n as ConfiguredRequestContextSchemas, _r as JobTransportSupports, aa as StreamMode, ai as GuardReturn, ar as JobQueueArgs, ba as ToolKeys, bn as KizunaConfigShape, br as ScheduledJob, bt as isZodSchema, ca as isNamedStream, ci as HandlerArgs, cn as ConfiguredAdapterContext, cr as JobRunner, da as streamContentType, dn as ConfiguredGroups, dr as jobFnAt, ea as StreamChunk, ei as BrandedHandlerContext, er as jobAt, fa as streamMode, fn as ConfiguredGuardSchema, fr as JobDescriptor, ga as ToolAt, gi as RoutesWithHandlerContext, gn as ConfiguredRequestContext, gr as JobTransportDefinition, h as GuardDenial, ha as StreamWithTools, hn as ConfiguredPlugins, hr as JobTransport, ia as StreamMessageOf, in as definePlugin, ir as JobInputError, ja as BasicCredential, ji as ToolRunResult, jn as SchemesOf, jr as scheduleExpression, ka as ApiKeyCredential, ki as ToolRunCall, kn as RequestContextOf, kr as nextRuns, la as routeStreams, li as HandlerReturn, ln as ConfiguredAdapterValue, lr as JobRunnerOptions, lt as ResponseError, ma as streamStatuses, mn as ConfiguredJobs, mr as JobMessage, na as StreamContext, nr as JobFn, oa as StreamYield, oi as GuardSuccess, or as JobQueueOptions, pi as RouteGuardBrandOf, pn as ConfiguredIdentities, pr as JobDispatchError, qi as RoutePathParamsCheck, qn as Jobs, qr as RouteBuilder, qt as PluginList, ra as StreamMessage, ri as GuardAnswer, rr as JobFnByKey, s as AnyAdapter, sr as JobRunArgs, ta as StreamComment, ti as ContextFromAuth, tr as JobErrorHandler, u as ApiWithRouter, ua as soleStreamResponse, un as ConfiguredCodes, ur as createJobRunner, va as ToolError, vn as JobFnOf, vr as JobWorker, vt as isStreamResponse, wn as apiEntries, wr as assertValidSchedule, xa as ToolResult, xn as ApiEntry, xr as defineJobTransport, ya as ToolEvents, yn as JobsOfTree, yr as JobWorkerContext, za as Identity, zn as JobDefinition, zr as GroupPathsOf } from "./adapter-Pi82GO4c.mjs";
2
+ import { $i as StreamBodyOf, $n as isJobDefinition, $r as AuthContextOf, $t as PluginsBySlug, Aa as BasicConfig, Ai as ToolRunOptions, An as RoutesOf, Ar as parseCron, Ba as IdentityParamsOf, Bn as JobHandler, Br as GroupSet, Bt as PluginApi, Ca as toolEvents, Ci as isRouteDefinition, Cn as GeneratedFile, Cr as ParsedCron, Di as ToolAnswer, Dn as GuardSchemaOf, Dr as firesBetween, E as MountedOf, Ei as StreamTools, En as ApiPluginsOf, Er as dueSchedules, Fa as CredentialOf, Fn as CompiledJobs, Fr as RequestContextHeaderValues, Ft as AnyPlugin, Ga as RoleOf, Gi as PathParamsCheck, Gn as JobRunnerConfig, Gt as PluginExportsOf, Ha as NoCredential, Hi as ExtractPathParams, Hn as JobHandlerReturn, Hr as createGroups, Ht as PluginDeclaration, Ia as CustomConfig, In as FlattenedJob, Ir as RequestContextSchema, It as ApiPlugins, J as getHeaderValue, Ji as buildPath, Jn as JobsArg, Jr as RouteWithHandler, Ka as RolesOf, Kn as JobVoidReturn, Kt as PluginFactory, La as GrantsOf, Ln as HttpJobsConfig, Lr as GroupOptions, Ma as BearerConfig, Mi as ToolDefinition, Mn as AuthoredJobDefinition, Mr as scheduleTimezone, Na as BearerCredential, Nn as AuthoredJobs, Nr as RequestContextConfig, Oa as ApiKeyConfig, Oi as ToolEventYield, On as JobsOf, Or as nextRun, Pa as Credential, Pn as CompiledJob, Pr as RequestContextHeaderInputs, Qi as StreamBody, Qn as isCompiledJob, Qt as PluginSetupContext, Ra as GuardHoldings, Rn as InProcessJobsConfig, Rr as GroupPaths, Sa as expandStreamTools, Sn as DiffSettings, Sr as JobSchedule, T as MountArgsOf, Ti as ModelToolCall, Tn as ApiDefinition, Tr as cron, Ua as OAuth2Config, Ui as HasPathParams, Un as JobHandlers, Ut as PluginDefinition, Va as IdentityRole, Vn as JobHandlerArgs, Vr as ResolvedGroup, Vt as PluginArgs, Wa as OpenIdConnectConfig, Wi as PathParamName, Wn as JobResponses, Wt as PluginExportValues, Xi as EVENT_STREAM_MEDIA_TYPE, Xn as NoJobs, Xt as PluginRoutesOf, Yi as parsePath, Yn as JobsConfig, Yt as PluginRoutes, Zn as flattenJobs, Zt as PluginSetup, _ as GuardDeny, _a as ToolCall, _i as ThrowableReturn, _n as ConfiguredRequestContextSchemas, _r as JobTransportSupports, aa as StreamMode, ai as GuardReturn, ar as JobQueueArgs, ba as ToolKeys, bn as KizunaConfigShape, br as ScheduledJob, bt as isZodSchema, ca as isNamedStream, ci as HandlerArgs, cn as ConfiguredAdapterContext, cr as JobRunner, da as streamContentType, dn as ConfiguredGroups, dr as jobFnAt, ea as StreamChunk, ei as BrandedHandlerContext, er as jobAt, fa as streamMode, fn as ConfiguredGuardSchema, fr as JobDescriptor, ga as ToolAt, gi as RoutesWithHandlerContext, gn as ConfiguredRequestContext, gr as JobTransportDefinition, h as GuardDenial, ha as StreamWithTools, hn as ConfiguredPlugins, hr as JobTransport, ia as StreamMessageOf, in as definePlugin, ir as JobInputError, ja as BasicCredential, ji as ToolRunResult, jn as SchemesOf, jr as scheduleExpression, ka as ApiKeyCredential, ki as ToolRunCall, kn as RequestContextOf, kr as nextRuns, la as routeStreams, li as HandlerReturn, ln as ConfiguredAdapterValue, lr as JobRunnerOptions, lt as ResponseError, ma as streamStatuses, mn as ConfiguredJobs, mr as JobMessage, na as StreamContext, nr as JobFn, oa as StreamYield, oi as GuardSuccess, or as JobQueueOptions, pi as RouteGuardBrandOf, pn as ConfiguredIdentities, pr as JobDispatchError, qi as RoutePathParamsCheck, qn as Jobs, qr as RouteBuilder, qt as PluginList, ra as StreamMessage, ri as GuardAnswer, rr as JobFnByKey, s as AnyAdapter, sr as JobRunArgs, ta as StreamComment, ti as ContextFromAuth, tr as JobErrorHandler, u as ApiWithRouter, ua as soleStreamResponse, un as ConfiguredCodes, ur as createJobRunner, va as ToolError, vn as JobFnOf, vr as JobWorker, vt as isStreamResponse, wn as apiEntries, wr as assertValidSchedule, xa as ToolResult, xn as ApiEntry, xr as defineJobTransport, ya as ToolEvents, yn as JobsOfTree, yr as JobWorkerContext, za as Identity, zn as JobDefinition, zr as GroupPathsOf } from "./adapter-DxFLPtzt.mjs";
3
3
  import { a as buildProtectedResourceMetadata, c as ValidationErrorFor, d as isValidationError, i as assertCanonicalResourceUri, n as ProtectedResourceMetadata, o as BuiltinIssueCode, s as ValidationError, t as ProtectedResourceConfig, u as ValidationIssueCode } from "./protected-resource-metadata-CfBVsqIk.mjs";
4
4
  import { z } from "zod";
5
5
  import { $input, $output } from "zod/v4/core";
@@ -1,4 +1,4 @@
1
- import { Tn as ApiDefinition, vr as JobWorker } from "./adapter-D9E9bjxo.cjs";
1
+ import { Tn as ApiDefinition, vr as JobWorker } from "./adapter-DSw79pNT.cjs";
2
2
 
3
3
  //#region src/start-jobs.d.ts
4
4
  interface StartJobsOptions {
@@ -1,4 +1,4 @@
1
- import { Tn as ApiDefinition, vr as JobWorker } from "./adapter-Pi82GO4c.mjs";
1
+ import { Tn as ApiDefinition, vr as JobWorker } from "./adapter-DxFLPtzt.mjs";
2
2
 
3
3
  //#region src/start-jobs.d.ts
4
4
  interface StartJobsOptions {
package/dist/plugin.d.cts CHANGED
@@ -1,3 +1,3 @@
1
1
  import { Y as RoutePath } from "./error-response-YbkRMKno.cjs";
2
- import { $t as PluginsBySlug, Bt as PluginApi, Ft as AnyPlugin, Gt as PluginExportsOf, Ht as PluginDeclaration, It as ApiPlugins, Jt as PluginRouteBuilder, Kt as PluginFactory, Lt as InstallOptions, Qt as PluginSetupContext, Rt as PLUGIN_ROUTES_META_KEY, Ut as PluginDefinition, Vt as PluginArgs, Wt as PluginExportValues, Xt as PluginRoutesOf, Yt as PluginRoutes, Zt as PluginSetup, an as pluginRouteTree, en as ResolvedPlugin, in as definePlugin, nn as RoutePathSchema, on as route, qt as PluginList, rn as SlugOption, sn as ApiContext, tn as RouteAuthSchema, zt as PLUGIN_SERVERS_META_KEY } from "./adapter-D9E9bjxo.cjs";
2
+ import { $t as PluginsBySlug, Bt as PluginApi, Ft as AnyPlugin, Gt as PluginExportsOf, Ht as PluginDeclaration, It as ApiPlugins, Jt as PluginRouteBuilder, Kt as PluginFactory, Lt as InstallOptions, Qt as PluginSetupContext, Rt as PLUGIN_ROUTES_META_KEY, Ut as PluginDefinition, Vt as PluginArgs, Wt as PluginExportValues, Xt as PluginRoutesOf, Yt as PluginRoutes, Zt as PluginSetup, an as pluginRouteTree, en as ResolvedPlugin, in as definePlugin, nn as RoutePathSchema, on as route, qt as PluginList, rn as SlugOption, sn as ApiContext, tn as RouteAuthSchema, zt as PLUGIN_SERVERS_META_KEY } from "./adapter-DSw79pNT.cjs";
3
3
  export { AnyPlugin, ApiContext, ApiPlugins, InstallOptions, PLUGIN_ROUTES_META_KEY, PLUGIN_SERVERS_META_KEY, PluginApi, PluginArgs, PluginDeclaration, PluginDefinition, PluginExportValues, PluginExportsOf, PluginFactory, PluginList, PluginRouteBuilder, PluginRoutes, PluginRoutesOf, PluginSetup, PluginSetupContext, PluginsBySlug, ResolvedPlugin, RouteAuthSchema, RoutePath, RoutePathSchema, SlugOption, definePlugin, pluginRouteTree, route };
package/dist/plugin.d.mts CHANGED
@@ -1,3 +1,3 @@
1
1
  import { Y as RoutePath } from "./error-response-NoOGdh8H.mjs";
2
- import { $t as PluginsBySlug, Bt as PluginApi, Ft as AnyPlugin, Gt as PluginExportsOf, Ht as PluginDeclaration, It as ApiPlugins, Jt as PluginRouteBuilder, Kt as PluginFactory, Lt as InstallOptions, Qt as PluginSetupContext, Rt as PLUGIN_ROUTES_META_KEY, Ut as PluginDefinition, Vt as PluginArgs, Wt as PluginExportValues, Xt as PluginRoutesOf, Yt as PluginRoutes, Zt as PluginSetup, an as pluginRouteTree, en as ResolvedPlugin, in as definePlugin, nn as RoutePathSchema, on as route, qt as PluginList, rn as SlugOption, sn as ApiContext, tn as RouteAuthSchema, zt as PLUGIN_SERVERS_META_KEY } from "./adapter-Pi82GO4c.mjs";
2
+ import { $t as PluginsBySlug, Bt as PluginApi, Ft as AnyPlugin, Gt as PluginExportsOf, Ht as PluginDeclaration, It as ApiPlugins, Jt as PluginRouteBuilder, Kt as PluginFactory, Lt as InstallOptions, Qt as PluginSetupContext, Rt as PLUGIN_ROUTES_META_KEY, Ut as PluginDefinition, Vt as PluginArgs, Wt as PluginExportValues, Xt as PluginRoutesOf, Yt as PluginRoutes, Zt as PluginSetup, an as pluginRouteTree, en as ResolvedPlugin, in as definePlugin, nn as RoutePathSchema, on as route, qt as PluginList, rn as SlugOption, sn as ApiContext, tn as RouteAuthSchema, zt as PLUGIN_SERVERS_META_KEY } from "./adapter-DxFLPtzt.mjs";
3
3
  export { AnyPlugin, ApiContext, ApiPlugins, InstallOptions, PLUGIN_ROUTES_META_KEY, PLUGIN_SERVERS_META_KEY, PluginApi, PluginArgs, PluginDeclaration, PluginDefinition, PluginExportValues, PluginExportsOf, PluginFactory, PluginList, PluginRouteBuilder, PluginRoutes, PluginRoutesOf, PluginSetup, PluginSetupContext, PluginsBySlug, ResolvedPlugin, RouteAuthSchema, RoutePath, RoutePathSchema, SlugOption, definePlugin, pluginRouteTree, route };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "kizunajs",
3
- "version": "2.0.0-beta.25",
3
+ "version": "2.0.0-beta.27",
4
4
  "description": "Route declaration, validation, and the adapter API for Kizuna.js",
5
5
  "keywords": [
6
6
  "kizunajs",
@@ -46,11 +46,25 @@ type HandlerBody<S, Status> = S extends z.ZodType
46
46
  ? ApplyErrorEnvelope<z.input<S['body']>, Status>
47
47
  : never;
48
48
 
49
- type ResponseReturn<R extends Pick<RouteDefinition, 'responses'>, Status extends keyof R['responses']> = {
50
- status: Status extends number ? Status : never;
51
- body: HandlerBody<R['responses'][Status], Status>;
52
- headers?: ResponseHeaders;
53
- };
49
+ /**
50
+ * A response that carries no body, like a `204: z.void()`, may leave `body` out. A body
51
+ * that resolves to `never` stays required, so a status that cannot be returned still
52
+ * fails to compile.
53
+ */
54
+ type ResponseReturn<R extends Pick<RouteDefinition, 'responses'>, Status extends keyof R['responses']> =
55
+ IsBodiless<HandlerBody<R['responses'][Status], Status>> extends true
56
+ ? {
57
+ status: Status extends number ? Status : never;
58
+ body?: HandlerBody<R['responses'][Status], Status>;
59
+ headers?: ResponseHeaders;
60
+ }
61
+ : {
62
+ status: Status extends number ? Status : never;
63
+ body: HandlerBody<R['responses'][Status], Status>;
64
+ headers?: ResponseHeaders;
65
+ };
66
+
67
+ type IsBodiless<Body> = [Body] extends [never] ? false : [Body] extends [undefined | void] ? true : false;
54
68
 
55
69
  /**
56
70
  * Constrained to `responses` alone so a job, which has no method or path, reuses it.