@webpieces/core-util 0.4.773 → 0.4.774

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/core/core-util/src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @webpieces/core-util\n *\n * Utility functions for WebPieces applications.\n * This package works in both browser and Node.js environments.\n *\n * @packageDocumentation\n */\n\nexport { toError } from './lib/errorUtils';\nexport { ContextKey } from './ContextKey';\nexport type {\n    AnyContextKey,\n    AnyTrustedContextKey,\n    AnyUntrustedContextKey,\n    Trust,\n} from './ContextKey';\nexport { ContextTuple } from './ContextTuple';\n\n// @DocumentDesign — DI-design-root marker. Applies to ANY project kind (server\n// controllers AND library impl classes), so it lives here (browser + Node) rather\n// than in a server-only routing package.\nexport { DocumentDesign, isDocumentDesign, DESIGN_METADATA_KEYS } from './DocumentDesign';\n\n// Logging (merged from former @webpieces/wp-logging).\n// Pluggable logging interface + a browser-safe console default; apps plug in\n// bunyan/winston/pino/etc. via LogManager.setFactory(...). Browser + Node.\nexport type { Logger, LogLevel } from './logging/Logger';\nexport type { LoggerFactory } from './logging/LoggerFactory';\nexport { ConsoleLogger } from './logging/ConsoleLogger';\nexport { ConsoleLoggerFactory } from './logging/ConsoleLoggerFactory';\nexport { LogManager } from './logging/LogManager';\nexport {\n    LogChunker,\n    LogChunkerImpl,\n    LogChunkInfo,\n    MAX_GCP_LOG_BYTES,\n    GCP_LOG_BUDGET_BYTES,\n} from './logging/LogChunker';\n\n// HTTP API contract (merged from former @webpieces/http-api).\n// Shared HTTP API definition consumed by both client and server: REST\n// decorators, the API error taxonomy, datetime DTOs, platform-header\n// registry/readers, ValidateImplementation, and the test-case recorder\n// contract. Pure definitions — express-free, browser + Node safe.\n\n// API definition decorators\nexport {\n    ApiPath,\n    Endpoint,\n    // Auth mode decorators (clean service-to-service + user JWT model)\n    WpAuthPublic,\n    WpAuthJwt,\n    rolesRequired,\n    MISSING_AUTH_DECORATOR_FIX,\n    WpAuthOidc,\n    WpAuthSharedSecret,\n    WpAuthWebhook,\n    WpAuthApiKey,\n    WpAuthLocalOnly,\n    MaskLog,\n    getApiPath,\n    getEndpoints,\n    getEndpointOptions,\n    getEndpointKind,\n    getEndpointKinds,\n    getMaskSpec,\n    isFormPost,\n    isRawBody,\n    isApiPath,\n    getAuthMeta,\n    getAuthMode,\n    assertEveryEndpointHasAuthMode,\n    assertEveryExternalEndpointDeclaresCaller,\n    assertEveryWebhookEndpointRetainsRawBody,\n    validateNoConflictingDecorators,\n    METADATA_KEYS,\n} from './http/decorators';\nexport {\n    PathParam,\n    QueryParam,\n    getHttpParameterDeclarations,\n} from './http/http-parameter-decorators';\nexport {\n    WpInternal,\n    WpIpcEndpoint,\n    isInternalApi,\n    getIpcApiId,\n    getIpcEndpoints,\n    getIpcEndpointKind,\n    getIpcMaskSpec,\n    assertInternalApi,\n    assertNotInternalApi,\n    IPC_METADATA_KEYS,\n} from './ipc/IpcDecorators';\nexport type { IpcApiType, IpcEndpointKind, IpcEndpointOptions } from './ipc/IpcDecorators';\n// The runtime representation of ONE route (split out of decorators.ts for file size only).\nexport { RouteMetadata } from './http/RouteMetadata';\nexport { RouteMetadataFactory } from './http/RouteMetadataFactory';\nexport {\n    BoundHttpRequest,\n    HttpContractMapper,\n    HttpParameterBinding,\n    HttpParameterDeclaration,\n} from './http/HttpContract';\nexport type {\n    ContractHttpMethod,\n    EndpointResponseType,\n    HttpParameterSource,\n    HttpParameterValueType,\n} from './http/HttpContract';\nexport type { EndpointKind, EndpointOptions, ExternalEndpointOptions } from './http/decorators';\nexport { WpMcpTool, WpMcpToolHints, WpMcpToolMetadata, getWpMcpTools } from './mcp/McpMetadata';\nexport type { WpMcpMethodDecorator, WpMcpToolOptions } from './mcp/McpMetadata';\nexport {\n    WpDto,\n    WpDtoField,\n    WpDtoFieldOptions,\n    WpDtoMapFieldOptions,\n    WpDtoFieldMetadata,\n    WpResponseDto,\n    ApiJsonSchema,\n    DtoValidationFailure,\n    DtoSchemaBuilder,\n} from './mcp/DtoSchema';\nexport type { DtoClass, DtoElementType, DtoValue } from './mcp/DtoSchema';\n// The TYPE layer of the auth surface — likewise split out of decorators.ts for file size only.\nexport { AuthMeta } from './http/auth-mode';\nexport type {\n    AuthMode,\n    ApiKeyCredential,\n    ApiKeyCredentials,\n    JwtRoles,\n    JwtRequirement,\n} from './http/auth-mode';\n// API kind (RPC vs PubSub/Cloud Tasks) + queue naming. Split out of decorators.ts for file size only;\n// one-way dependency api-kind -> decorators, and the barrel keeps the surface identical.\nexport {\n    Rpc,\n    PubSub,\n    Queue,\n    ENDPOINT_KINDS_BY_API_KIND,\n    getApiKind,\n    assertApiKind,\n    assertPubSubConventions,\n    getQueueName,\n} from './http/api-kind';\nexport type { ApiKind } from './http/api-kind';\n// WHO calls an `external` endpoint — the caller declaration @Endpoint(..., 'external', {calledBy})\n// requires, and the reader for it.\nexport {\n    EXTERNAL_SYSTEM_KINDS,\n    DEFAULT_CALLER_KIND,\n    ExternalCaller,\n    isExternalSystemKind,\n    getEndpointCaller,\n} from './http/external-caller';\nexport type { ExternalSystemKind } from './http/external-caller';\n// Client-side shared-secret store (the value THIS service sends per @WpAuthSharedSecret key).\nexport { Secrets, SECRETS } from './http/Secrets';\n\n// Type validators\nexport { ValidateImplementation } from './http/validators';\n\n// Authentication subtype constants.\nexport {\n    ENTITY_NOT_FOUND,\n    WRONG_LOGIN_TYPE,\n    WRONG_LOGIN,\n    NOT_APPROVED,\n    EMAIL_NOT_CONFIRMED,\n    WRONG_DOMAIN,\n    WRONG_COMPANY,\n    NO_REG_CODE,\n} from './errors';\n\nexport { NetworkRejectClassifier } from './http/networkReject';\n\n// Date/Time DTOs and Utilities (inspired by Java Time / JSR-310)\nexport {\n    InstantDto,\n    DateDto,\n    TimeDto,\n    DateTimeDto,\n    InstantUtil,\n    DateUtil,\n    TimeUtil,\n    DateTimeUtil,\n} from './http/datetime';\n\n// Context keys + registry (the global magic-context header system)\nexport { HeaderRegistry } from './http/HeaderRegistry';\nexport { ClientRegistry } from './http/ClientRegistry';\nexport { CallRegistry } from './http/CallRegistry';\nexport { CallDeadline } from './http/CallDeadline';\nexport { CallContext } from './http/CallStrategy';\nexport type { Attempt, CallStrategy } from './http/CallStrategy';\nexport { ApiCallTimeoutError } from './http/ApiCallTimeoutError';\nexport type { ServiceUrlDeriver } from './http/ClientRegistry';\n\n// \"What service am I\" — set once at startup, read by the logging backends and by\n// RequestContextHeaders (to stamp requestIdSource on ids this service mints).\nexport { ServiceInfo } from './http/ServiceInfo';\n// \"Where am I running\" — declared once at startup (setupRuntime, from RuntimeSetupOptions.locality).\n// The ONE input to @WpAuthLocalOnly enforcement. Undeclared reads as DEPLOYED (fail safe).\nexport { RuntimeLocality } from './http/RuntimeLocality';\nexport type { Locality } from './http/RuntimeLocality';\n// The ENTIRE HTTP response as pure data — the ONE form both transports (express, fetch) are\n// normalised into, so an ErrorTranslators implementation is written once and serves both.\nexport { HttpHeader, HttpResponseStatus, HttpResponseDto } from './http/HttpResponseDto';\n// Pluggable, bidirectional error translation (app exception <-> the WHOLE response). Set on\n// ClientRegistry at startup; consulted before the built-in webpieces mapping on BOTH sides.\nexport type { ErrorTranslators } from './http/ErrorTranslators';\n// Pluggable per-client failure classification (is a thrown API-call error a real failure or an\n// expected non-failure?). Registered on ClientRegistry at startup; consulted by LogApiCall.\nexport type { FailureClassifier } from './http/FailureClassifier';\nexport { KeyedFailureClassifier } from './http/FailureClassifier';\nexport {\n    WebpiecesDefaultFailureClassifier,\n    WEBPIECES_DEFAULT_FAILURE_CLASSIFIER,\n} from './http/WebpiecesDefaultFailureClassifier';\nexport { templateDeriver } from './http/templateDeriver';\nexport { WebpiecesCoreHeaders } from './http/WebpiecesCoreHeaders';\nexport { ContextReader } from './http/ContextReader';\n\n// The OUTBOUND half of the trust model: whether a TRUSTED context key may ride to the endpoint being\n// called. Built ONLY from the destination endpoint's AuthMode — see the class doc.\nexport { DestinationTrust } from './http/DestinationTrust';\n\n// BROWSER-ONLY outbound-header propagation (app-held store + registry -> outbound HTTP headers).\n// Only @webpieces/http-client-browser may name it; the server reads RequestContext directly via\n// RequestContextHeaders in the Node-only @webpieces/core-context.\nexport { ContextMgr } from './http/ContextMgr';\n\n// API-call logging helper (uses LogManager above). NOT a singleton: construct one per environment\n// with that environment's ApiCallContext — `new LogApiCallImpl(new RequestContextApiCallContext())`\n// on node, `new LogApiCallImpl(new BrowserApiCallContext())` in a browser.\nexport { LogApiCallImpl } from './http/LogApiCall';\n\n// Opt-in field masking for the LogApiCall log path — declare per-api sensitive fields so secrets\n// (OAuth refresh tokens, id-token JWTs) are masked in the logs while the real value stays on the wire.\nexport { MaskSpec } from './http/LogFieldMask';\nexport type { MaskMode } from './http/LogFieldMask';\n\n// The structured `api` tag + the context-writer seam LogApiCall stamps through. The Node\n// RequestContext-backed impl lives in @webpieces/core-context, the browser one in\n// @webpieces/http-client-browser; each is CONSTRUCTED by its package, never installed globally.\nexport { ApiCallInfo } from './http/ApiCallInfo';\nexport type { ApiType, ApiResult } from './http/ApiCallInfo';\n// Console-render bridge: turns LogApiCall's [LogApiCall] bracket into [API.{side}.{phase}] locally.\nexport {\n    ApiCallLogName,\n    ApiCallLogNameImpl,\n    LOG_API_CALL_LOGGER_NAME,\n} from './http/ApiCallLogName';\nexport { ApiMethodInfo } from './http/ApiMethodInfo';\nexport type { ApiSide } from './http/ApiMethodInfo';\nexport type { ApiCallContext } from './http/ApiCallContext';\n\n// Test-case recording contract (impl lives in http-server; hooks in http-client)\nexport { TestCaseRecorder, RecorderKeys } from './http/recorder/TestCaseRecorder';\nexport {\n    RecordedEndpoint,\n    RecordedError,\n    RecordedTestCase,\n} from './http/recorder/RecordedEndpoint';\nexport { DoNotRecord, getDoNotRecordFields } from './http/recorder/DoNotRecord';\nexport { RecordSerializer, SerializedMap, SerializedError } from './http/recorder/RecordSerializer';\n\n// ---------------------------------------------------------------------------------------------\n// Filter-chain primitives, shared by BOTH chains: the inbound server chain\n// (`Filter<MethodMeta, WpResponse<unknown>>`, @webpieces/http-routing) and the outbound client\n// chain (`Filter<ClientRequest, Response>`, @webpieces/http-client-core). Declared once, here, in\n// the package both depend on — see the class doc for why a second pair would be a shim.\nexport { Filter } from './filters/Filter';\nexport type { Service } from './filters/Filter';\nexport { FilterChain } from './filters/FilterChain';\n\nexport {\n    ApiError,\n    ApiNotFoundError,\n    ApiDependencyError,\n    ApiUnavailableError,\n    ApiDependencyTimeoutError,\n    ApiImplementationError,\n    ApiRateLimitedError,\n    ApiForbiddenError,\n    ApiRequestTimeoutError,\n    ApiEndUserError,\n    ApiBadRequestError,\n    ApiUnauthorizedError,\n    ApiDependencyBackoffError,\n    ApiConnectionError,\n    ApiEndpointNotFoundError,\n    ApiErrorCodec,\n    ApiErrorPayload,\n} from './errors';\nexport type { ApiErrorKind } from './errors';\nexport { ApiErrorHttpStatus } from './http/ApiErrorHttpStatus';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/core/core-util/src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @webpieces/core-util\n *\n * Utility functions for WebPieces applications.\n * This package works in both browser and Node.js environments.\n *\n * @packageDocumentation\n */\n\nexport { toError } from './lib/errorUtils';\nexport { ContextKey } from './ContextKey';\nexport type {\n    AnyContextKey,\n    AnyTrustedContextKey,\n    AnyUntrustedContextKey,\n    Trust,\n} from './ContextKey';\nexport { ContextTuple } from './ContextTuple';\n\n// @DocumentDesign — DI-design-root marker. Applies to ANY project kind (server\n// controllers AND library impl classes), so it lives here (browser + Node) rather\n// than in a server-only routing package.\nexport { DocumentDesign, isDocumentDesign, DESIGN_METADATA_KEYS } from './DocumentDesign';\n\n// Logging (merged from former @webpieces/wp-logging).\n// Pluggable logging interface + a browser-safe console default; apps plug in\n// bunyan/winston/pino/etc. via LogManager.setFactory(...). Browser + Node.\nexport type { Logger, LogLevel } from './logging/Logger';\nexport type { LoggerFactory } from './logging/LoggerFactory';\nexport { ConsoleLogger } from './logging/ConsoleLogger';\nexport { ConsoleLoggerFactory } from './logging/ConsoleLoggerFactory';\nexport { LogManager } from './logging/LogManager';\nexport {\n    LogChunker,\n    LogChunkerImpl,\n    LogChunkInfo,\n    MAX_GCP_LOG_BYTES,\n    GCP_LOG_BUDGET_BYTES,\n} from './logging/LogChunker';\n\n// HTTP API contract (merged from former @webpieces/http-api).\n// Shared HTTP API definition consumed by both client and server: REST\n// decorators, the API error taxonomy, datetime DTOs, platform-header\n// registry/readers, ValidateImplementation, and the test-case recorder\n// contract. Pure definitions — express-free, browser + Node safe.\n\n// API definition decorators\nexport {\n    ApiPath,\n    Endpoint,\n    // Auth mode decorators (clean service-to-service + user JWT model)\n    WpAuthPublic,\n    WpAuthJwt,\n    rolesRequired,\n    MISSING_AUTH_DECORATOR_FIX,\n    WpAuthOidc,\n    WpAuthSharedSecret,\n    WpAuthWebhook,\n    WpAuthApiKey,\n    WpAuthLocalOnly,\n    MaskLog,\n    getApiPath,\n    getEndpoints,\n    getEndpointOptions,\n    getEndpointKind,\n    getEndpointKinds,\n    getMaskSpec,\n    isFormPost,\n    isRawBody,\n    isApiPath,\n    getAuthMeta,\n    getAuthMode,\n    assertEveryEndpointHasAuthMode,\n    assertEveryExternalEndpointDeclaresCaller,\n    assertEveryWebhookEndpointRetainsRawBody,\n    validateNoConflictingDecorators,\n    METADATA_KEYS,\n} from './http/decorators';\nexport {\n    PathParam,\n    QueryParam,\n    getHttpParameterDeclarations,\n} from './http/http-parameter-decorators';\nexport {\n    WpInternal,\n    WpIpcEndpoint,\n    isInternalApi,\n    getIpcApiId,\n    getIpcEndpoints,\n    getIpcEndpointKind,\n    getIpcMaskSpec,\n    assertInternalApi,\n    assertNotInternalApi,\n    IPC_METADATA_KEYS,\n} from './ipc/IpcDecorators';\nexport type { IpcApiType, IpcEndpointKind, IpcEndpointOptions } from './ipc/IpcDecorators';\n// The runtime representation of ONE route (split out of decorators.ts for file size only).\nexport { RouteMetadata } from './http/RouteMetadata';\nexport { RouteMetadataFactory } from './http/RouteMetadataFactory';\nexport {\n    BoundHttpRequest,\n    HttpContractMapper,\n    HttpParameterBinding,\n    HttpParameterDeclaration,\n} from './http/HttpContract';\nexport {\n    StreamCorrelation,\n    StreamEnvelope,\n    StreamingEndpointMetadata,\n    StreamEventValidator,\n    StreamTransportError,\n    StreamWriter,\n    WpStream,\n    getStreamingEndpoint,\n} from './http/StreamingContract';\nexport type {\n    RequestStream,\n    ResponseStream,\n    StreamEnvelopeKind,\n    StreamFailureOptions,\n} from './http/StreamingContract';\nexport type {\n    ContractHttpMethod,\n    EndpointResponseType,\n    HttpParameterSource,\n    HttpParameterValueType,\n} from './http/HttpContract';\nexport type { EndpointKind, EndpointOptions, ExternalEndpointOptions } from './http/decorators';\nexport { WpMcpTool, WpMcpToolHints, WpMcpToolMetadata, getWpMcpTools } from './mcp/McpMetadata';\nexport type { WpMcpMethodDecorator, WpMcpToolOptions } from './mcp/McpMetadata';\nexport { WpMcpAuthJwt, WpMcpJwtAuthMetadata, getWpMcpAuthJwt } from './mcp/McpAuthMetadata';\nexport {\n    WpDto,\n    WpDtoField,\n    WpDtoFieldOptions,\n    WpMcpHeader,\n    WpDtoMapFieldOptions,\n    WpDtoFieldMetadata,\n    WpResponseDto,\n    ApiJsonSchema,\n    DtoValidationFailure,\n    DtoSchemaBuilder,\n} from './mcp/DtoSchema';\nexport type { DtoClass, DtoElementType, DtoValue } from './mcp/DtoSchema';\n// The TYPE layer of the auth surface — likewise split out of decorators.ts for file size only.\nexport { AuthMeta } from './http/auth-mode';\nexport type {\n    AuthMode,\n    ApiKeyCredential,\n    ApiKeyCredentials,\n    JwtRoles,\n    JwtRequirement,\n} from './http/auth-mode';\n// API kind (RPC vs PubSub/Cloud Tasks) + queue naming. Split out of decorators.ts for file size only;\n// one-way dependency api-kind -> decorators, and the barrel keeps the surface identical.\nexport {\n    Rpc,\n    PubSub,\n    Queue,\n    ENDPOINT_KINDS_BY_API_KIND,\n    getApiKind,\n    assertApiKind,\n    assertPubSubConventions,\n    getQueueName,\n} from './http/api-kind';\nexport type { ApiKind } from './http/api-kind';\n// WHO calls an `external` endpoint — the caller declaration @Endpoint(..., 'external', {calledBy})\n// requires, and the reader for it.\nexport {\n    EXTERNAL_SYSTEM_KINDS,\n    DEFAULT_CALLER_KIND,\n    ExternalCaller,\n    isExternalSystemKind,\n    getEndpointCaller,\n} from './http/external-caller';\nexport type { ExternalSystemKind } from './http/external-caller';\n// Client-side shared-secret store (the value THIS service sends per @WpAuthSharedSecret key).\nexport { Secrets, SECRETS } from './http/Secrets';\n\n// Type validators\nexport { ValidateImplementation } from './http/validators';\n\n// Authentication subtype constants.\nexport {\n    ENTITY_NOT_FOUND,\n    WRONG_LOGIN_TYPE,\n    WRONG_LOGIN,\n    NOT_APPROVED,\n    EMAIL_NOT_CONFIRMED,\n    WRONG_DOMAIN,\n    WRONG_COMPANY,\n    NO_REG_CODE,\n} from './errors';\n\nexport { NetworkRejectClassifier } from './http/networkReject';\n\n// Date/Time DTOs and Utilities (inspired by Java Time / JSR-310)\nexport {\n    InstantDto,\n    DateDto,\n    TimeDto,\n    DateTimeDto,\n    InstantUtil,\n    DateUtil,\n    TimeUtil,\n    DateTimeUtil,\n} from './http/datetime';\n\n// Context keys + registry (the global magic-context header system)\nexport { HeaderRegistry } from './http/HeaderRegistry';\nexport { ClientRegistry } from './http/ClientRegistry';\nexport { CallRegistry } from './http/CallRegistry';\nexport { CallDeadline } from './http/CallDeadline';\nexport { CallContext } from './http/CallStrategy';\nexport type { Attempt, CallStrategy } from './http/CallStrategy';\nexport { ApiCallTimeoutError } from './http/ApiCallTimeoutError';\nexport type { ServiceUrlDeriver } from './http/ClientRegistry';\n\n// \"What service am I\" — set once at startup, read by the logging backends and by\n// RequestContextHeaders (to stamp requestIdSource on ids this service mints).\nexport { ServiceInfo } from './http/ServiceInfo';\n// \"Where am I running\" — declared once at startup (setupRuntime, from RuntimeSetupOptions.locality).\n// The ONE input to @WpAuthLocalOnly enforcement. Undeclared reads as DEPLOYED (fail safe).\nexport { RuntimeLocality } from './http/RuntimeLocality';\nexport type { Locality } from './http/RuntimeLocality';\n// The ENTIRE HTTP response as pure data — the ONE form both transports (express, fetch) are\n// normalised into, so an ErrorTranslators implementation is written once and serves both.\nexport { HttpHeader, HttpResponseStatus, HttpResponseDto } from './http/HttpResponseDto';\n// Pluggable, bidirectional error translation (app exception <-> the WHOLE response). Set on\n// ClientRegistry at startup; consulted before the built-in webpieces mapping on BOTH sides.\nexport type { ErrorTranslators } from './http/ErrorTranslators';\n// Pluggable per-client failure classification (is a thrown API-call error a real failure or an\n// expected non-failure?). Registered on ClientRegistry at startup; consulted by LogApiCall.\nexport type { FailureClassifier } from './http/FailureClassifier';\nexport { KeyedFailureClassifier } from './http/FailureClassifier';\nexport {\n    WebpiecesDefaultFailureClassifier,\n    WEBPIECES_DEFAULT_FAILURE_CLASSIFIER,\n} from './http/WebpiecesDefaultFailureClassifier';\nexport { templateDeriver } from './http/templateDeriver';\nexport { WebpiecesCoreHeaders } from './http/WebpiecesCoreHeaders';\nexport { ContextReader } from './http/ContextReader';\n\n// The OUTBOUND half of the trust model: whether a TRUSTED context key may ride to the endpoint being\n// called. Built ONLY from the destination endpoint's AuthMode — see the class doc.\nexport { DestinationTrust } from './http/DestinationTrust';\n\n// BROWSER-ONLY outbound-header propagation (app-held store + registry -> outbound HTTP headers).\n// Only @webpieces/http-client-browser may name it; the server reads RequestContext directly via\n// RequestContextHeaders in the Node-only @webpieces/core-context.\nexport { ContextMgr } from './http/ContextMgr';\n\n// API-call logging helper (uses LogManager above). NOT a singleton: construct one per environment\n// with that environment's ApiCallContext — `new LogApiCallImpl(new RequestContextApiCallContext())`\n// on node, `new LogApiCallImpl(new BrowserApiCallContext())` in a browser.\nexport { LogApiCallImpl } from './http/LogApiCall';\n\n// Opt-in field masking for the LogApiCall log path — declare per-api sensitive fields so secrets\n// (OAuth refresh tokens, id-token JWTs) are masked in the logs while the real value stays on the wire.\nexport { MaskSpec } from './http/LogFieldMask';\nexport type { MaskMode } from './http/LogFieldMask';\n\n// The structured `api` tag + the context-writer seam LogApiCall stamps through. The Node\n// RequestContext-backed impl lives in @webpieces/core-context, the browser one in\n// @webpieces/http-client-browser; each is CONSTRUCTED by its package, never installed globally.\nexport { ApiCallInfo } from './http/ApiCallInfo';\nexport type { ApiType, ApiResult } from './http/ApiCallInfo';\n// Console-render bridge: turns LogApiCall's [LogApiCall] bracket into [API.{side}.{phase}] locally.\nexport {\n    ApiCallLogName,\n    ApiCallLogNameImpl,\n    LOG_API_CALL_LOGGER_NAME,\n} from './http/ApiCallLogName';\nexport { ApiMethodInfo } from './http/ApiMethodInfo';\nexport type { ApiSide } from './http/ApiMethodInfo';\nexport type { ApiCallContext } from './http/ApiCallContext';\n\n// Test-case recording contract (impl lives in http-server; hooks in http-client)\nexport { TestCaseRecorder, RecorderKeys } from './http/recorder/TestCaseRecorder';\nexport {\n    RecordedEndpoint,\n    RecordedError,\n    RecordedTestCase,\n} from './http/recorder/RecordedEndpoint';\nexport { DoNotRecord, getDoNotRecordFields } from './http/recorder/DoNotRecord';\nexport { RecordSerializer, SerializedMap, SerializedError } from './http/recorder/RecordSerializer';\n\n// ---------------------------------------------------------------------------------------------\n// Filter-chain primitives, shared by BOTH chains: the inbound server chain\n// (`Filter<MethodMeta, WpResponse<unknown>>`, @webpieces/http-routing) and the outbound client\n// chain (`Filter<ClientRequest, Response>`, @webpieces/http-client-core). Declared once, here, in\n// the package both depend on — see the class doc for why a second pair would be a shim.\nexport { Filter } from './filters/Filter';\nexport type { Service } from './filters/Filter';\nexport { FilterChain } from './filters/FilterChain';\n\nexport {\n    ApiError,\n    ApiNotFoundError,\n    ApiDependencyError,\n    ApiUnavailableError,\n    ApiDependencyTimeoutError,\n    ApiImplementationError,\n    ApiRateLimitedError,\n    ApiForbiddenError,\n    ApiRequestTimeoutError,\n    ApiEndUserError,\n    ApiBadRequestError,\n    ApiUnauthorizedError,\n    ApiDependencyBackoffError,\n    ApiConnectionError,\n    ApiEndpointNotFoundError,\n    ApiErrorCodec,\n    ApiErrorPayload,\n    ApiErrorBoundary,\n} from './errors';\nexport type { ApiErrorKind } from './errors';\nexport { ApiErrorHttpStatus } from './http/ApiErrorHttpStatus';\n"]}

package/src/mcp/DtoSchema.d.ts

@@ -16,13 +16,26 @@ export declare class WpDtoFieldOptions {
     readonly minimum?: number | undefined;
     readonly maximum?: number | undefined;
     readonly enumValues?: readonly [string, ...string[]] | undefined;
+    /** MCP 2026 SEP-2243 header mirrored as `Mcp-Param-{name}`. */
+    readonly mcpHeader?: WpMcpHeader | undefined;
     constructor(description: string, 
     /** Required/optional is explicit because TypeScript erases `?` at runtime. */
     required: boolean, 
     /** Required for arrays because TypeScript erases their element type. */
     arrayItems?: DtoElementType | undefined, 
     /** A reflected Number is otherwise emitted as JSON Schema `number`. */
-    integer?: boolean, minimum?: number | undefined, maximum?: number | undefined, enumValues?: readonly [string, ...string[]] | undefined);
+    integer?: boolean, minimum?: number | undefined, maximum?: number | undefined, enumValues?: readonly [string, ...string[]] | undefined, 
+    /** MCP 2026 SEP-2243 header mirrored as `Mcp-Param-{name}`. */
+    mcpHeader?: WpMcpHeader | undefined);
+}
+/**
+ * Names the `x-mcp-header` a primitive tool parameter is mirrored into (`Mcp-Param-{name}`). A class,
+ * not a bare string, so the 8th `WpDtoFieldOptions` argument can never be mistaken for a map value
+ * type (maps use `WpDtoMapFieldOptions`).
+ */
+export declare class WpMcpHeader {
+    readonly name: string;
+    constructor(name: string);
 }
 /**
  * Field metadata for a typed map such as `Record<string, string>` or `Record<string, SomeDto>`.
@@ -55,12 +68,18 @@ export declare class ApiJsonSchema {
     enum?: string[];
     minimum?: number;
     maximum?: number;
+    /** MCP 2026 SEP-2243 schema extension consumed by the official SDK. */
+    'x-mcp-header'?: string;
     constructor(type?: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array');
 }
 /** A validation result safe to show to an API caller/model. */
 export declare class DtoValidationFailure {
+    /** JSON path of the offending value, e.g. `$.address.city`. */
+    readonly field: string;
     readonly message: string;
-    constructor(message: string);
+    constructor(
+    /** JSON path of the offending value, e.g. `$.address.city`. */
+    field: string, message: string);
 }
 /** Marks a request/response class as a schema-bearing DTO, including intentionally empty DTOs. */
 export declare function WpDto(): ClassDecorator;
@@ -85,6 +104,7 @@ export declare class DtoSchemaBuilder {
     private fieldSchema;
     private validateOptions;
     private itemSchema;
+    private validateMcpHeaders;
     private validateAt;
     private validateField;
     private validateArray;

package/src/mcp/DtoSchema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DtoSchemaBuilder = exports.DtoValidationFailure = exports.ApiJsonSchema = exports.WpDtoFieldMetadata = exports.WpDtoMapFieldOptions = exports.WpDtoFieldOptions = void 0;
+exports.DtoSchemaBuilder = exports.DtoValidationFailure = exports.ApiJsonSchema = exports.WpDtoFieldMetadata = exports.WpDtoMapFieldOptions = exports.WpMcpHeader = exports.WpDtoFieldOptions = void 0;
 exports.WpDto = WpDto;
 exports.WpDtoField = WpDtoField;
 exports.WpResponseDto = WpResponseDto;
@@ -17,13 +17,16 @@ class WpDtoFieldOptions {
     minimum;
     maximum;
     enumValues;
+    mcpHeader;
     constructor(description, 
     /** Required/optional is explicit because TypeScript erases `?` at runtime. */
     required, 
     /** Required for arrays because TypeScript erases their element type. */
     arrayItems, 
     /** A reflected Number is otherwise emitted as JSON Schema `number`. */
-    integer = false, minimum, maximum, enumValues) {
+    integer = false, minimum, maximum, enumValues, 
+    /** MCP 2026 SEP-2243 header mirrored as `Mcp-Param-{name}`. */
+    mcpHeader) {
         this.description = description;
         this.required = required;
         this.arrayItems = arrayItems;
@@ -31,9 +34,22 @@ class WpDtoFieldOptions {
         this.minimum = minimum;
         this.maximum = maximum;
         this.enumValues = enumValues;
+        this.mcpHeader = mcpHeader;
     }
 }
 exports.WpDtoFieldOptions = WpDtoFieldOptions;
+/**
+ * Names the `x-mcp-header` a primitive tool parameter is mirrored into (`Mcp-Param-{name}`). A class,
+ * not a bare string, so the 8th `WpDtoFieldOptions` argument can never be mistaken for a map value
+ * type (maps use `WpDtoMapFieldOptions`).
+ */
+class WpMcpHeader {
+    name;
+    constructor(name) {
+        this.name = name;
+    }
+}
+exports.WpMcpHeader = WpMcpHeader;
 /**
  * Field metadata for a typed map such as `Record<string, string>` or `Record<string, SomeDto>`.
  * Keys are open strings; every VALUE must match `mapValues`. The value type is explicit for the same
@@ -80,8 +96,12 @@ class ApiJsonSchema {
 exports.ApiJsonSchema = ApiJsonSchema;
 /** A validation result safe to show to an API caller/model. */
 class DtoValidationFailure {
+    field;
     message;
-    constructor(message) {
+    constructor(
+    /** JSON path of the offending value, e.g. `$.address.city`. */
+    field, message) {
+        this.field = field;
         this.message = message;
     }
 }
@@ -144,7 +164,9 @@ class DtoSchemaBuilder {
         return extra === false || (typeof extra === 'object' && extra !== null);
     }
     build(dtoClass) {
-        return this.buildAt(dtoClass, new Set());
+        const schema = this.buildAt(dtoClass, new Set());
+        this.validateMcpHeaders(schema, new Map());
+        return schema;
     }
     validate(dtoClass, value) {
         return this.validateAt(dtoClass, value, '$');
@@ -210,6 +232,8 @@ class DtoSchemaBuilder {
             schema.maximum = options.maximum;
         if (options.enumValues)
             schema.enum = [...options.enumValues];
+        if (options.mcpHeader)
+            schema['x-mcp-header'] = options.mcpHeader.name;
         return schema;
     }
     validateOptions(dtoClass, field, reflected) {
@@ -232,34 +256,61 @@ class DtoSchemaBuilder {
             (options.integer || options.minimum !== undefined || options.maximum !== undefined)) {
             throw new Error(`${label} declares numeric constraints but is not a number.`);
         }
-        if (options.minimum !== undefined && options.maximum !== undefined && options.minimum > options.maximum) {
+        if (options.minimum !== undefined &&
+            options.maximum !== undefined &&
+            options.minimum > options.maximum) {
             throw new Error(`${label} minimum cannot exceed maximum.`);
         }
         if (options.enumValues && reflected.name !== 'String') {
             throw new Error(`${label} enumValues require a string field.`);
         }
+        if (options.mcpHeader !== undefined) {
+            if (!/^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/.test(options.mcpHeader.name)) {
+                throw new Error(`${label} mcpHeader must be an RFC 9110 token.`);
+            }
+            if (!['String', 'Number', 'Boolean'].includes(reflected.name)) {
+                throw new Error(`${label} mcpHeader requires a primitive field.`);
+            }
+            if (reflected.name === 'Number' && !options.integer) {
+                throw new Error(`${label} mcpHeader cannot mirror a non-integer number (MCP 2026-07-28).`);
+            }
+        }
     }
     itemSchema(item, parents) {
         if (typeof item !== 'string')
             return this.buildAt(item, parents);
         return new ApiJsonSchema(item === 'integer' ? 'integer' : item);
     }
+    validateMcpHeaders(schema, seen) {
+        const header = schema['x-mcp-header'];
+        if (header) {
+            const key = header.toLowerCase();
+            const prior = seen.get(key);
+            if (prior) {
+                throw new Error(`mcpHeader '${header}' duplicates '${prior}' case-insensitively.`);
+            }
+            seen.set(key, header);
+        }
+        for (const child of Object.values(schema.properties ?? {})) {
+            this.validateMcpHeaders(child, seen);
+        }
+    }
     validateAt(dtoClass, value, path) {
         this.requireDto(dtoClass);
         if (typeof value !== 'object' || value === null || Array.isArray(value)) {
-            return new DtoValidationFailure(`${path} must be an object`);
+            return new DtoValidationFailure(path, `${path} must be an object`);
         }
         const fields = this.fields(dtoClass);
         const known = new Set(fields.map((field) => field.propertyKey));
         for (const key of Object.keys(value)) {
             if (!known.has(key))
-                return new DtoValidationFailure(`${path}.${key} is not allowed`);
+                return new DtoValidationFailure(`${path}.${key}`, `${path}.${key} is not allowed`);
         }
         for (const field of fields) {
             const fieldValue = Object.getOwnPropertyDescriptor(value, field.propertyKey)?.value;
             if (fieldValue === undefined) {
                 if (field.options.required) {
-                    return new DtoValidationFailure(`${path}.${field.propertyKey} is required`);
+                    return new DtoValidationFailure(`${path}.${field.propertyKey}`, `${path}.${field.propertyKey} is required`);
                 }
                 continue;
             }
@@ -280,39 +331,39 @@ class DtoSchemaBuilder {
             return this.validateArray(options, value, path);
         if (expected === 'String') {
             if (typeof value !== 'string')
-                return new DtoValidationFailure(`${path} must be a string`);
+                return new DtoValidationFailure(path, `${path} must be a string`);
             if (options.enumValues && !options.enumValues.includes(value)) {
-                return new DtoValidationFailure(`${path} must be one of: ${options.enumValues.join(', ')}`);
+                return new DtoValidationFailure(path, `${path} must be one of: ${options.enumValues.join(', ')}`);
             }
             return undefined;
         }
         if (expected === 'Number') {
             if (typeof value !== 'number' || !Number.isFinite(value)) {
-                return new DtoValidationFailure(`${path} must be a number`);
+                return new DtoValidationFailure(path, `${path} must be a number`);
             }
             if (options.integer && !Number.isInteger(value)) {
-                return new DtoValidationFailure(`${path} must be an integer`);
+                return new DtoValidationFailure(path, `${path} must be an integer`);
             }
             if (options.minimum !== undefined && value < options.minimum) {
-                return new DtoValidationFailure(`${path} must be >= ${options.minimum}`);
+                return new DtoValidationFailure(path, `${path} must be >= ${options.minimum}`);
             }
             if (options.maximum !== undefined && value > options.maximum) {
-                return new DtoValidationFailure(`${path} must be <= ${options.maximum}`);
+                return new DtoValidationFailure(path, `${path} must be <= ${options.maximum}`);
             }
             return undefined;
         }
         if (expected === 'Boolean') {
             return typeof value === 'boolean'
                 ? undefined
-                : new DtoValidationFailure(`${path} must be a boolean`);
+                : new DtoValidationFailure(path, `${path} must be a boolean`);
         }
         return this.validateAt(reflected, value, path);
     }
     validateArray(options, value, path) {
         if (!Array.isArray(value))
-            return new DtoValidationFailure(`${path} must be an array`);
+            return new DtoValidationFailure(path, `${path} must be an array`);
         if (!options.arrayItems)
-            return new DtoValidationFailure(`${path} has no item type`);
+            return new DtoValidationFailure(path, `${path} has no item type`);
         for (let index = 0; index < value.length; index += 1) {
             const failure = this.validateElement(options.arrayItems, value[index], `${path}[${index}]`);
             if (failure)
@@ -322,11 +373,11 @@ class DtoSchemaBuilder {
     }
     validateMap(options, value, path) {
         if (typeof value !== 'object' || value === null || Array.isArray(value)) {
-            return new DtoValidationFailure(`${path} must be an object map`);
+            return new DtoValidationFailure(path, `${path} must be an object map`);
         }
         const prototype = Object.getPrototypeOf(value);
         if (prototype !== Object.prototype && prototype !== null) {
-            return new DtoValidationFailure(`${path} must be a plain object map`);
+            return new DtoValidationFailure(path, `${path} must be a plain object map`);
         }
         for (const key of Object.keys(value)) {
             const entry = Object.getOwnPropertyDescriptor(value, key)?.value;
@@ -341,7 +392,7 @@ class DtoSchemaBuilder {
             return this.validateAt(type, item, path);
         const wanted = type === 'integer' ? 'number' : type;
         if (typeof item !== wanted || (type === 'integer' && !Number.isInteger(item))) {
-            return new DtoValidationFailure(`${path} must be ${type}`);
+            return new DtoValidationFailure(path, `${path} must be ${type}`);
         }
         return undefined;
     }

package/src/mcp/DtoSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"DtoSchema.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/DtoSchema.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\n\nconst DTO_MARKER = 'webpieces:dto-schema';\nconst DTO_FIELDS = 'webpieces:dto-fields';\nconst RESPONSE_DTOS = 'webpieces:response-dtos';\n\n// webpieces-disable no-any-unknown -- abstract class tokens necessarily erase constructor parameters\nexport type DtoClass = abstract new (...args: any[]) => unknown;\n/** The element type of an array or the value type of a map; TypeScript erases both at runtime. */\nexport type DtoElementType = 'string' | 'number' | 'integer' | 'boolean' | DtoClass;\n/** Runtime values accepted at the DTO validation boundary. */\nexport type DtoValue = object | string | number | boolean | null;\n\n/** Additive field metadata; the scalar/object type itself comes from `design:type`. */\nexport class WpDtoFieldOptions {\n    constructor(\n        public readonly description: string,\n        /** Required/optional is explicit because TypeScript erases `?` at runtime. */\n        public readonly required: boolean,\n        /** Required for arrays because TypeScript erases their element type. */\n        public readonly arrayItems?: DtoElementType,\n        /** A reflected Number is otherwise emitted as JSON Schema `number`. */\n        public readonly integer: boolean = false,\n        public readonly minimum?: number,\n        public readonly maximum?: number,\n        public readonly enumValues?: readonly [string, ...string[]],\n    ) {}\n}\n\n/**\n * Field metadata for a typed map such as `Record<string, string>` or `Record<string, SomeDto>`.\n * Keys are open strings; every VALUE must match `mapValues`. The value type is explicit for the same\n * reason `arrayItems` is: TypeScript erases it, and a `Record` reflects as plain `Object`.\n */\nexport class WpDtoMapFieldOptions {\n    constructor(\n        public readonly description: string,\n        /** Required/optional is explicit because TypeScript erases `?` at runtime. */\n        public readonly required: boolean,\n        public readonly mapValues: DtoElementType,\n    ) {}\n}\n\nexport class WpDtoFieldMetadata {\n    constructor(\n        public readonly propertyKey: string,\n        public readonly options: WpDtoFieldOptions | WpDtoMapFieldOptions,\n    ) {}\n}\n\n/** The JSON Schema subset emitted for Webpieces API DTOs. */\nexport class ApiJsonSchema {\n    type?: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array';\n    description?: string;\n    properties?: Record<string, ApiJsonSchema>;\n    required?: string[];\n    /** `false` closes an object; a schema makes it a typed map whose values all match that schema. */\n    additionalProperties?: boolean | ApiJsonSchema;\n    items?: ApiJsonSchema;\n    enum?: string[];\n    minimum?: number;\n    maximum?: number;\n\n    constructor(type?: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array') {\n        this.type = type;\n    }\n}\n\n/** A validation result safe to show to an API caller/model. */\nexport class DtoValidationFailure {\n    constructor(public readonly message: string) {}\n}\n\n/** Marks a request/response class as a schema-bearing DTO, including intentionally empty DTOs. */\n// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope\nexport function WpDto(): ClassDecorator {\n    return (target: Function): void => Reflect.defineMetadata(DTO_MARKER, true, target);\n}\n\n/** Adds documentation and runtime-only shape facts to a DTO property. */\n// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope\nexport function WpDtoField(options: WpDtoFieldOptions | WpDtoMapFieldOptions): PropertyDecorator {\n    if (options.description.trim() === '') {\n        throw new Error('@WpDtoField requires non-empty field documentation.');\n    }\n    return (target: object, propertyKey: string | symbol): void => {\n        const dtoClass = target.constructor;\n        const fields: Record<string, WpDtoFieldMetadata> =\n            Reflect.getMetadata(DTO_FIELDS, dtoClass) ?? {};\n        const name = String(propertyKey);\n        fields[name] = new WpDtoFieldMetadata(name, options);\n        Reflect.defineMetadata(DTO_FIELDS, fields, dtoClass);\n    };\n}\n\n/** Declares an async API method's response DTO because reflection sees Promise, not its generic. */\n// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope\nexport function WpResponseDto(responseDto: () => DtoClass): MethodDecorator {\n    return (target: object, propertyKey: string | symbol): void => {\n        const apiClass = target.constructor;\n        const responses: Record<string, () => DtoClass> =\n            Reflect.getMetadata(RESPONSE_DTOS, apiClass) ?? {};\n        responses[String(propertyKey)] = responseDto;\n        Reflect.defineMetadata(RESPONSE_DTOS, responses, apiClass);\n    };\n}\n\n/** Builds and validates the same DTO schema used for MCP input and structured output. */\nexport class DtoSchemaBuilder {\n    requestClassOf(apiClass: Function, methodName: string): DtoClass {\n        // webpieces-disable no-any-unknown -- reflect-metadata returns erased runtime constructor tokens\n        const params = Reflect.getMetadata('design:paramtypes', apiClass.prototype, methodName) as\n            | DtoClass[]\n            | undefined;\n        if (!params || params.length !== 1) {\n            throw new Error(\n                `${apiClass.name}.${methodName} must take exactly one @WpDto request class to be an MCP tool.`,\n            );\n        }\n        return params[0];\n    }\n\n    responseClassOf(apiClass: Function, methodName: string): DtoClass {\n        const responses: Record<string, () => DtoClass> =\n            Reflect.getMetadata(RESPONSE_DTOS, apiClass) ?? {};\n        const response = responses[methodName];\n        if (!response) {\n            throw new Error(\n                `${apiClass.name}.${methodName} must declare @WpResponseDto(() => ResponseClass) before MCP exposure.`,\n            );\n        }\n        return response();\n    }\n\n    /**\n     * The one closure gate for an object schema. Closed means no key can carry an unspecified value:\n     * either extra keys are forbidden (`additionalProperties: false`) or every extra key's value is\n     * typed (`additionalProperties: <schema>`, a typed map). A missing or `true` value is open.\n     * Use this instead of `schema.additionalProperties === false`, which rejects typed maps.\n     */\n    isClosedSchema(schema: ApiJsonSchema): boolean {\n        const extra = schema.additionalProperties;\n        return extra === false || (typeof extra === 'object' && extra !== null);\n    }\n\n    build(dtoClass: DtoClass): ApiJsonSchema {\n        return this.buildAt(dtoClass, new Set<DtoClass>());\n    }\n\n    validate(dtoClass: DtoClass, value: DtoValue): DtoValidationFailure | undefined {\n        return this.validateAt(dtoClass, value, '$');\n    }\n\n    private buildAt(dtoClass: DtoClass, parents: Set<DtoClass>): ApiJsonSchema {\n        this.requireDto(dtoClass);\n        if (parents.has(dtoClass)) {\n            throw new Error(`Recursive DTO ${dtoClass.name} cannot use an inline MCP schema.`);\n        }\n        const nextParents = new Set(parents);\n        nextParents.add(dtoClass);\n        const schema = new ApiJsonSchema('object');\n        schema.properties = {};\n        schema.additionalProperties = false;\n        const required: string[] = [];\n        for (const field of this.fields(dtoClass)) {\n            schema.properties[field.propertyKey] = this.fieldSchema(dtoClass, field, nextParents);\n            if (field.options.required) required.push(field.propertyKey);\n        }\n        if (required.length > 0) schema.required = required;\n        return schema;\n    }\n\n    private fieldSchema(\n        dtoClass: DtoClass,\n        field: WpDtoFieldMetadata,\n        parents: Set<DtoClass>,\n    ): ApiJsonSchema {\n        // webpieces-disable no-any-unknown -- reflect-metadata returns an erased constructor token\n        const reflected = Reflect.getMetadata(\n            'design:type',\n            dtoClass.prototype,\n            field.propertyKey,\n        ) as DtoClass | undefined;\n        if (!reflected) throw new Error(`No reflected type for ${dtoClass.name}.${field.propertyKey}.`);\n        this.validateOptions(dtoClass, field, reflected);\n        const options = field.options;\n        if (options instanceof WpDtoMapFieldOptions) {\n            const mapSchema = new ApiJsonSchema('object');\n            mapSchema.description = options.description;\n            mapSchema.additionalProperties = this.itemSchema(options.mapValues, parents);\n            return mapSchema;\n        }\n        let schema: ApiJsonSchema;\n        switch (reflected.name) {\n            case 'String':\n                schema = new ApiJsonSchema('string');\n                break;\n            case 'Number':\n                schema = new ApiJsonSchema(options.integer ? 'integer' : 'number');\n                break;\n            case 'Boolean':\n                schema = new ApiJsonSchema('boolean');\n                break;\n            case 'Array':\n                if (!options.arrayItems) {\n                    throw new Error(`${dtoClass.name}.${field.propertyKey} must declare arrayItems.`);\n                }\n                schema = new ApiJsonSchema('array');\n                schema.items = this.itemSchema(options.arrayItems, parents);\n                break;\n            default:\n                schema = this.buildAt(reflected, parents);\n        }\n        schema.description = options.description;\n        if (options.minimum !== undefined) schema.minimum = options.minimum;\n        if (options.maximum !== undefined) schema.maximum = options.maximum;\n        if (options.enumValues) schema.enum = [...options.enumValues];\n        return schema;\n    }\n\n    private validateOptions(\n        dtoClass: DtoClass,\n        field: WpDtoFieldMetadata,\n        reflected: DtoClass,\n    ): void {\n        const label = `${dtoClass.name}.${field.propertyKey}`;\n        const options = field.options;\n        if (options instanceof WpDtoMapFieldOptions) {\n            if (reflected !== Object) {\n                throw new Error(`${label} declares mapValues but is not a map (Record<string, V>).`);\n            }\n            return;\n        }\n        if (reflected === Object) {\n            throw new Error(\n                `${label} has type Object: an interface or Record can never be a @WpDto. ` +\n                    'For a map, use WpDtoMapFieldOptions.',\n            );\n        }\n        if (reflected.name !== 'Array' && options.arrayItems) {\n            throw new Error(`${label} declares arrayItems but is not an array.`);\n        }\n        if (\n            reflected.name !== 'Number' &&\n            (options.integer || options.minimum !== undefined || options.maximum !== undefined)\n        ) {\n            throw new Error(`${label} declares numeric constraints but is not a number.`);\n        }\n        if (options.minimum !== undefined && options.maximum !== undefined && options.minimum > options.maximum) {\n            throw new Error(`${label} minimum cannot exceed maximum.`);\n        }\n        if (options.enumValues && reflected.name !== 'String') {\n            throw new Error(`${label} enumValues require a string field.`);\n        }\n    }\n\n    private itemSchema(item: DtoElementType, parents: Set<DtoClass>): ApiJsonSchema {\n        if (typeof item !== 'string') return this.buildAt(item, parents);\n        return new ApiJsonSchema(item === 'integer' ? 'integer' : item);\n    }\n\n    private validateAt(\n        dtoClass: DtoClass,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        this.requireDto(dtoClass);\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            return new DtoValidationFailure(`${path} must be an object`);\n        }\n        const fields = this.fields(dtoClass);\n        const known = new Set(fields.map((field: WpDtoFieldMetadata) => field.propertyKey));\n        for (const key of Object.keys(value)) {\n            if (!known.has(key)) return new DtoValidationFailure(`${path}.${key} is not allowed`);\n        }\n        for (const field of fields) {\n            const fieldValue = Object.getOwnPropertyDescriptor(value, field.propertyKey)?.value;\n            if (fieldValue === undefined) {\n                if (field.options.required) {\n                    return new DtoValidationFailure(`${path}.${field.propertyKey} is required`);\n                }\n                continue;\n            }\n            const failure = this.validateField(dtoClass, field, fieldValue, `${path}.${field.propertyKey}`);\n            if (failure) return failure;\n        }\n        return undefined;\n    }\n\n    private validateField(\n        dtoClass: DtoClass,\n        field: WpDtoFieldMetadata,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        // webpieces-disable no-any-unknown -- reflect-metadata returns an erased constructor token\n        const reflected = Reflect.getMetadata(\n            'design:type',\n            dtoClass.prototype,\n            field.propertyKey,\n        ) as DtoClass;\n        const options = field.options;\n        if (options instanceof WpDtoMapFieldOptions) return this.validateMap(options, value, path);\n        const expected = reflected?.name;\n        if (expected === 'Array') return this.validateArray(options, value, path);\n        if (expected === 'String') {\n            if (typeof value !== 'string') return new DtoValidationFailure(`${path} must be a string`);\n            if (options.enumValues && !options.enumValues.includes(value)) {\n                return new DtoValidationFailure(`${path} must be one of: ${options.enumValues.join(', ')}`);\n            }\n            return undefined;\n        }\n        if (expected === 'Number') {\n            if (typeof value !== 'number' || !Number.isFinite(value)) {\n                return new DtoValidationFailure(`${path} must be a number`);\n            }\n            if (options.integer && !Number.isInteger(value)) {\n                return new DtoValidationFailure(`${path} must be an integer`);\n            }\n            if (options.minimum !== undefined && value < options.minimum) {\n                return new DtoValidationFailure(`${path} must be >= ${options.minimum}`);\n            }\n            if (options.maximum !== undefined && value > options.maximum) {\n                return new DtoValidationFailure(`${path} must be <= ${options.maximum}`);\n            }\n            return undefined;\n        }\n        if (expected === 'Boolean') {\n            return typeof value === 'boolean'\n                ? undefined\n                : new DtoValidationFailure(`${path} must be a boolean`);\n        }\n        return this.validateAt(reflected, value, path);\n    }\n\n    private validateArray(\n        options: WpDtoFieldOptions,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (!Array.isArray(value)) return new DtoValidationFailure(`${path} must be an array`);\n        if (!options.arrayItems) return new DtoValidationFailure(`${path} has no item type`);\n        for (let index = 0; index < value.length; index += 1) {\n            const failure = this.validateElement(options.arrayItems, value[index], `${path}[${index}]`);\n            if (failure) return failure;\n        }\n        return undefined;\n    }\n\n    private validateMap(\n        options: WpDtoMapFieldOptions,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            return new DtoValidationFailure(`${path} must be an object map`);\n        }\n        const prototype: object | null = Object.getPrototypeOf(value);\n        if (prototype !== Object.prototype && prototype !== null) {\n            return new DtoValidationFailure(`${path} must be a plain object map`);\n        }\n        for (const key of Object.keys(value)) {\n            const entry: DtoValue = Object.getOwnPropertyDescriptor(value, key)?.value;\n            const failure = this.validateElement(options.mapValues, entry, `${path}.${key}`);\n            if (failure) return failure;\n        }\n        return undefined;\n    }\n\n    private validateElement(\n        type: DtoElementType,\n        item: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (typeof type !== 'string') return this.validateAt(type, item, path);\n        const wanted = type === 'integer' ? 'number' : type;\n        if (typeof item !== wanted || (type === 'integer' && !Number.isInteger(item))) {\n            return new DtoValidationFailure(`${path} must be ${type}`);\n        }\n        return undefined;\n    }\n\n    private fields(dtoClass: DtoClass): WpDtoFieldMetadata[] {\n        const fields: Record<string, WpDtoFieldMetadata> =\n            Reflect.getMetadata(DTO_FIELDS, dtoClass) ?? {};\n        return Object.values(fields);\n    }\n\n    private requireDto(dtoClass: DtoClass): void {\n        if (!Reflect.getMetadata(DTO_MARKER, dtoClass)) {\n            throw new Error(`${dtoClass.name} must be decorated with @WpDto() for schema generation.`);\n        }\n    }\n}\n"]}
+{"version":3,"file":"DtoSchema.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/DtoSchema.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\n\nconst DTO_MARKER = 'webpieces:dto-schema';\nconst DTO_FIELDS = 'webpieces:dto-fields';\nconst RESPONSE_DTOS = 'webpieces:response-dtos';\n\n// webpieces-disable no-any-unknown -- abstract class tokens necessarily erase constructor parameters\nexport type DtoClass = abstract new (...args: any[]) => unknown;\n/** The element type of an array or the value type of a map; TypeScript erases both at runtime. */\nexport type DtoElementType = 'string' | 'number' | 'integer' | 'boolean' | DtoClass;\n/** Runtime values accepted at the DTO validation boundary. */\nexport type DtoValue = object | string | number | boolean | null;\n\n/** Additive field metadata; the scalar/object type itself comes from `design:type`. */\nexport class WpDtoFieldOptions {\n    constructor(\n        public readonly description: string,\n        /** Required/optional is explicit because TypeScript erases `?` at runtime. */\n        public readonly required: boolean,\n        /** Required for arrays because TypeScript erases their element type. */\n        public readonly arrayItems?: DtoElementType,\n        /** A reflected Number is otherwise emitted as JSON Schema `number`. */\n        public readonly integer: boolean = false,\n        public readonly minimum?: number,\n        public readonly maximum?: number,\n        public readonly enumValues?: readonly [string, ...string[]],\n        /** MCP 2026 SEP-2243 header mirrored as `Mcp-Param-{name}`. */\n        public readonly mcpHeader?: WpMcpHeader,\n    ) {}\n}\n\n/**\n * Names the `x-mcp-header` a primitive tool parameter is mirrored into (`Mcp-Param-{name}`). A class,\n * not a bare string, so the 8th `WpDtoFieldOptions` argument can never be mistaken for a map value\n * type (maps use `WpDtoMapFieldOptions`).\n */\nexport class WpMcpHeader {\n    constructor(public readonly name: string) {}\n}\n\n/**\n * Field metadata for a typed map such as `Record<string, string>` or `Record<string, SomeDto>`.\n * Keys are open strings; every VALUE must match `mapValues`. The value type is explicit for the same\n * reason `arrayItems` is: TypeScript erases it, and a `Record` reflects as plain `Object`.\n */\nexport class WpDtoMapFieldOptions {\n    constructor(\n        public readonly description: string,\n        /** Required/optional is explicit because TypeScript erases `?` at runtime. */\n        public readonly required: boolean,\n        public readonly mapValues: DtoElementType,\n    ) {}\n}\n\nexport class WpDtoFieldMetadata {\n    constructor(\n        public readonly propertyKey: string,\n        public readonly options: WpDtoFieldOptions | WpDtoMapFieldOptions,\n    ) {}\n}\n\n/** The JSON Schema subset emitted for Webpieces API DTOs. */\nexport class ApiJsonSchema {\n    type?: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array';\n    description?: string;\n    properties?: Record<string, ApiJsonSchema>;\n    required?: string[];\n    /** `false` closes an object; a schema makes it a typed map whose values all match that schema. */\n    additionalProperties?: boolean | ApiJsonSchema;\n    items?: ApiJsonSchema;\n    enum?: string[];\n    minimum?: number;\n    maximum?: number;\n    /** MCP 2026 SEP-2243 schema extension consumed by the official SDK. */\n    declare 'x-mcp-header'?: string;\n\n    constructor(type?: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array') {\n        this.type = type;\n    }\n}\n\n/** A validation result safe to show to an API caller/model. */\nexport class DtoValidationFailure {\n    constructor(\n        /** JSON path of the offending value, e.g. `$.address.city`. */\n        public readonly field: string,\n        public readonly message: string,\n    ) {}\n}\n\n/** Marks a request/response class as a schema-bearing DTO, including intentionally empty DTOs. */\n// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope\nexport function WpDto(): ClassDecorator {\n    return (target: Function): void => Reflect.defineMetadata(DTO_MARKER, true, target);\n}\n\n/** Adds documentation and runtime-only shape facts to a DTO property. */\n// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope\nexport function WpDtoField(options: WpDtoFieldOptions | WpDtoMapFieldOptions): PropertyDecorator {\n    if (options.description.trim() === '') {\n        throw new Error('@WpDtoField requires non-empty field documentation.');\n    }\n    return (target: object, propertyKey: string | symbol): void => {\n        const dtoClass = target.constructor;\n        const fields: Record<string, WpDtoFieldMetadata> =\n            Reflect.getMetadata(DTO_FIELDS, dtoClass) ?? {};\n        const name = String(propertyKey);\n        fields[name] = new WpDtoFieldMetadata(name, options);\n        Reflect.defineMetadata(DTO_FIELDS, fields, dtoClass);\n    };\n}\n\n/** Declares an async API method's response DTO because reflection sees Promise, not its generic. */\n// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope\nexport function WpResponseDto(responseDto: () => DtoClass): MethodDecorator {\n    return (target: object, propertyKey: string | symbol): void => {\n        const apiClass = target.constructor;\n        const responses: Record<string, () => DtoClass> =\n            Reflect.getMetadata(RESPONSE_DTOS, apiClass) ?? {};\n        responses[String(propertyKey)] = responseDto;\n        Reflect.defineMetadata(RESPONSE_DTOS, responses, apiClass);\n    };\n}\n\n/** Builds and validates the same DTO schema used for MCP input and structured output. */\nexport class DtoSchemaBuilder {\n    requestClassOf(apiClass: Function, methodName: string): DtoClass {\n        // webpieces-disable no-any-unknown -- reflect-metadata returns erased runtime constructor tokens\n        const params = Reflect.getMetadata('design:paramtypes', apiClass.prototype, methodName) as\n            | DtoClass[]\n            | undefined;\n        if (!params || params.length !== 1) {\n            throw new Error(\n                `${apiClass.name}.${methodName} must take exactly one @WpDto request class to be an MCP tool.`,\n            );\n        }\n        return params[0];\n    }\n\n    responseClassOf(apiClass: Function, methodName: string): DtoClass {\n        const responses: Record<string, () => DtoClass> =\n            Reflect.getMetadata(RESPONSE_DTOS, apiClass) ?? {};\n        const response = responses[methodName];\n        if (!response) {\n            throw new Error(\n                `${apiClass.name}.${methodName} must declare @WpResponseDto(() => ResponseClass) before MCP exposure.`,\n            );\n        }\n        return response();\n    }\n\n    /**\n     * The one closure gate for an object schema. Closed means no key can carry an unspecified value:\n     * either extra keys are forbidden (`additionalProperties: false`) or every extra key's value is\n     * typed (`additionalProperties: <schema>`, a typed map). A missing or `true` value is open.\n     * Use this instead of `schema.additionalProperties === false`, which rejects typed maps.\n     */\n    isClosedSchema(schema: ApiJsonSchema): boolean {\n        const extra = schema.additionalProperties;\n        return extra === false || (typeof extra === 'object' && extra !== null);\n    }\n\n    build(dtoClass: DtoClass): ApiJsonSchema {\n        const schema = this.buildAt(dtoClass, new Set<DtoClass>());\n        this.validateMcpHeaders(schema, new Map<string, string>());\n        return schema;\n    }\n\n    validate(dtoClass: DtoClass, value: DtoValue): DtoValidationFailure | undefined {\n        return this.validateAt(dtoClass, value, '$');\n    }\n\n    private buildAt(dtoClass: DtoClass, parents: Set<DtoClass>): ApiJsonSchema {\n        this.requireDto(dtoClass);\n        if (parents.has(dtoClass)) {\n            throw new Error(`Recursive DTO ${dtoClass.name} cannot use an inline MCP schema.`);\n        }\n        const nextParents = new Set(parents);\n        nextParents.add(dtoClass);\n        const schema = new ApiJsonSchema('object');\n        schema.properties = {};\n        schema.additionalProperties = false;\n        const required: string[] = [];\n        for (const field of this.fields(dtoClass)) {\n            schema.properties[field.propertyKey] = this.fieldSchema(dtoClass, field, nextParents);\n            if (field.options.required) required.push(field.propertyKey);\n        }\n        if (required.length > 0) schema.required = required;\n        return schema;\n    }\n\n    private fieldSchema(\n        dtoClass: DtoClass,\n        field: WpDtoFieldMetadata,\n        parents: Set<DtoClass>,\n    ): ApiJsonSchema {\n        // webpieces-disable no-any-unknown -- reflect-metadata returns an erased constructor token\n        const reflected = Reflect.getMetadata(\n            'design:type',\n            dtoClass.prototype,\n            field.propertyKey,\n        ) as DtoClass | undefined;\n        if (!reflected)\n            throw new Error(`No reflected type for ${dtoClass.name}.${field.propertyKey}.`);\n        this.validateOptions(dtoClass, field, reflected);\n        const options = field.options;\n        if (options instanceof WpDtoMapFieldOptions) {\n            const mapSchema = new ApiJsonSchema('object');\n            mapSchema.description = options.description;\n            mapSchema.additionalProperties = this.itemSchema(options.mapValues, parents);\n            return mapSchema;\n        }\n        let schema: ApiJsonSchema;\n        switch (reflected.name) {\n            case 'String':\n                schema = new ApiJsonSchema('string');\n                break;\n            case 'Number':\n                schema = new ApiJsonSchema(options.integer ? 'integer' : 'number');\n                break;\n            case 'Boolean':\n                schema = new ApiJsonSchema('boolean');\n                break;\n            case 'Array':\n                if (!options.arrayItems) {\n                    throw new Error(\n                        `${dtoClass.name}.${field.propertyKey} must declare arrayItems.`,\n                    );\n                }\n                schema = new ApiJsonSchema('array');\n                schema.items = this.itemSchema(options.arrayItems, parents);\n                break;\n            default:\n                schema = this.buildAt(reflected, parents);\n        }\n        schema.description = options.description;\n        if (options.minimum !== undefined) schema.minimum = options.minimum;\n        if (options.maximum !== undefined) schema.maximum = options.maximum;\n        if (options.enumValues) schema.enum = [...options.enumValues];\n        if (options.mcpHeader) schema['x-mcp-header'] = options.mcpHeader.name;\n        return schema;\n    }\n\n    private validateOptions(\n        dtoClass: DtoClass,\n        field: WpDtoFieldMetadata,\n        reflected: DtoClass,\n    ): void {\n        const label = `${dtoClass.name}.${field.propertyKey}`;\n        const options = field.options;\n        if (options instanceof WpDtoMapFieldOptions) {\n            if (reflected !== Object) {\n                throw new Error(\n                    `${label} declares mapValues but is not a map (Record<string, V>).`,\n                );\n            }\n            return;\n        }\n        if (reflected === Object) {\n            throw new Error(\n                `${label} has type Object: an interface or Record can never be a @WpDto. ` +\n                    'For a map, use WpDtoMapFieldOptions.',\n            );\n        }\n        if (reflected.name !== 'Array' && options.arrayItems) {\n            throw new Error(`${label} declares arrayItems but is not an array.`);\n        }\n        if (\n            reflected.name !== 'Number' &&\n            (options.integer || options.minimum !== undefined || options.maximum !== undefined)\n        ) {\n            throw new Error(`${label} declares numeric constraints but is not a number.`);\n        }\n        if (\n            options.minimum !== undefined &&\n            options.maximum !== undefined &&\n            options.minimum > options.maximum\n        ) {\n            throw new Error(`${label} minimum cannot exceed maximum.`);\n        }\n        if (options.enumValues && reflected.name !== 'String') {\n            throw new Error(`${label} enumValues require a string field.`);\n        }\n        if (options.mcpHeader !== undefined) {\n            if (!/^[!#$%&'*+\\-.^_`|~0-9A-Za-z]+$/.test(options.mcpHeader.name)) {\n                throw new Error(`${label} mcpHeader must be an RFC 9110 token.`);\n            }\n            if (!['String', 'Number', 'Boolean'].includes(reflected.name)) {\n                throw new Error(`${label} mcpHeader requires a primitive field.`);\n            }\n            if (reflected.name === 'Number' && !options.integer) {\n                throw new Error(\n                    `${label} mcpHeader cannot mirror a non-integer number (MCP 2026-07-28).`,\n                );\n            }\n        }\n    }\n\n    private itemSchema(item: DtoElementType, parents: Set<DtoClass>): ApiJsonSchema {\n        if (typeof item !== 'string') return this.buildAt(item, parents);\n        return new ApiJsonSchema(item === 'integer' ? 'integer' : item);\n    }\n\n    private validateMcpHeaders(schema: ApiJsonSchema, seen: Map<string, string>): void {\n        const header = schema['x-mcp-header'];\n        if (header) {\n            const key = header.toLowerCase();\n            const prior = seen.get(key);\n            if (prior) {\n                throw new Error(`mcpHeader '${header}' duplicates '${prior}' case-insensitively.`);\n            }\n            seen.set(key, header);\n        }\n        for (const child of Object.values(schema.properties ?? {})) {\n            this.validateMcpHeaders(child, seen);\n        }\n    }\n\n    private validateAt(\n        dtoClass: DtoClass,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        this.requireDto(dtoClass);\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            return new DtoValidationFailure(path, `${path} must be an object`);\n        }\n        const fields = this.fields(dtoClass);\n        const known = new Set(fields.map((field: WpDtoFieldMetadata) => field.propertyKey));\n        for (const key of Object.keys(value)) {\n            if (!known.has(key))\n                return new DtoValidationFailure(`${path}.${key}`, `${path}.${key} is not allowed`);\n        }\n        for (const field of fields) {\n            const fieldValue = Object.getOwnPropertyDescriptor(value, field.propertyKey)?.value;\n            if (fieldValue === undefined) {\n                if (field.options.required) {\n                    return new DtoValidationFailure(\n                        `${path}.${field.propertyKey}`,\n                        `${path}.${field.propertyKey} is required`,\n                    );\n                }\n                continue;\n            }\n            const failure = this.validateField(\n                dtoClass,\n                field,\n                fieldValue,\n                `${path}.${field.propertyKey}`,\n            );\n            if (failure) return failure;\n        }\n        return undefined;\n    }\n\n    private validateField(\n        dtoClass: DtoClass,\n        field: WpDtoFieldMetadata,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        // webpieces-disable no-any-unknown -- reflect-metadata returns an erased constructor token\n        const reflected = Reflect.getMetadata(\n            'design:type',\n            dtoClass.prototype,\n            field.propertyKey,\n        ) as DtoClass;\n        const options = field.options;\n        if (options instanceof WpDtoMapFieldOptions) return this.validateMap(options, value, path);\n        const expected = reflected?.name;\n        if (expected === 'Array') return this.validateArray(options, value, path);\n        if (expected === 'String') {\n            if (typeof value !== 'string')\n                return new DtoValidationFailure(path, `${path} must be a string`);\n            if (options.enumValues && !options.enumValues.includes(value)) {\n                return new DtoValidationFailure(\n                    path,\n                    `${path} must be one of: ${options.enumValues.join(', ')}`,\n                );\n            }\n            return undefined;\n        }\n        if (expected === 'Number') {\n            if (typeof value !== 'number' || !Number.isFinite(value)) {\n                return new DtoValidationFailure(path, `${path} must be a number`);\n            }\n            if (options.integer && !Number.isInteger(value)) {\n                return new DtoValidationFailure(path, `${path} must be an integer`);\n            }\n            if (options.minimum !== undefined && value < options.minimum) {\n                return new DtoValidationFailure(path, `${path} must be >= ${options.minimum}`);\n            }\n            if (options.maximum !== undefined && value > options.maximum) {\n                return new DtoValidationFailure(path, `${path} must be <= ${options.maximum}`);\n            }\n            return undefined;\n        }\n        if (expected === 'Boolean') {\n            return typeof value === 'boolean'\n                ? undefined\n                : new DtoValidationFailure(path, `${path} must be a boolean`);\n        }\n        return this.validateAt(reflected, value, path);\n    }\n\n    private validateArray(\n        options: WpDtoFieldOptions,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (!Array.isArray(value))\n            return new DtoValidationFailure(path, `${path} must be an array`);\n        if (!options.arrayItems) return new DtoValidationFailure(path, `${path} has no item type`);\n        for (let index = 0; index < value.length; index += 1) {\n            const failure = this.validateElement(\n                options.arrayItems,\n                value[index],\n                `${path}[${index}]`,\n            );\n            if (failure) return failure;\n        }\n        return undefined;\n    }\n\n    private validateMap(\n        options: WpDtoMapFieldOptions,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            return new DtoValidationFailure(path, `${path} must be an object map`);\n        }\n        const prototype: object | null = Object.getPrototypeOf(value);\n        if (prototype !== Object.prototype && prototype !== null) {\n            return new DtoValidationFailure(path, `${path} must be a plain object map`);\n        }\n        for (const key of Object.keys(value)) {\n            const entry: DtoValue = Object.getOwnPropertyDescriptor(value, key)?.value;\n            const failure = this.validateElement(options.mapValues, entry, `${path}.${key}`);\n            if (failure) return failure;\n        }\n        return undefined;\n    }\n\n    private validateElement(\n        type: DtoElementType,\n        item: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (typeof type !== 'string') return this.validateAt(type, item, path);\n        const wanted = type === 'integer' ? 'number' : type;\n        if (typeof item !== wanted || (type === 'integer' && !Number.isInteger(item))) {\n            return new DtoValidationFailure(path, `${path} must be ${type}`);\n        }\n        return undefined;\n    }\n\n    private fields(dtoClass: DtoClass): WpDtoFieldMetadata[] {\n        const fields: Record<string, WpDtoFieldMetadata> =\n            Reflect.getMetadata(DTO_FIELDS, dtoClass) ?? {};\n        return Object.values(fields);\n    }\n\n    private requireDto(dtoClass: DtoClass): void {\n        if (!Reflect.getMetadata(DTO_MARKER, dtoClass)) {\n            throw new Error(\n                `${dtoClass.name} must be decorated with @WpDto() for schema generation.`,\n            );\n        }\n    }\n}\n"]}

package/src/mcp/McpAuthMetadata.d.ts

@@ -0,0 +1,9 @@
+import 'reflect-metadata';
+import { JwtRequirement } from '../http/auth-mode';
+/** Authorization policy for the verified MCP user principal, independent of HTTP hop auth. */
+export declare class WpMcpJwtAuthMetadata {
+    readonly requirement: JwtRequirement;
+    constructor(requirement: JwtRequirement);
+}
+export declare function WpMcpAuthJwt(requirement: JwtRequirement): MethodDecorator;
+export declare function getWpMcpAuthJwt(apiClass: Function, methodName: string): WpMcpJwtAuthMetadata | undefined;

package/src/mcp/McpAuthMetadata.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WpMcpJwtAuthMetadata = void 0;
+exports.WpMcpAuthJwt = WpMcpAuthJwt;
+exports.getWpMcpAuthJwt = getWpMcpAuthJwt;
+require("reflect-metadata");
+const decorators_1 = require("../http/decorators");
+/** Authorization policy for the verified MCP user principal, independent of HTTP hop auth. */
+class WpMcpJwtAuthMetadata {
+    requirement;
+    constructor(requirement) {
+        this.requirement = requirement;
+    }
+}
+exports.WpMcpJwtAuthMetadata = WpMcpJwtAuthMetadata;
+// webpieces-disable no-function-outside-class -- authorization decorator factory
+function WpMcpAuthJwt(requirement) {
+    return (target, propertyKey) => {
+        const apiClass = target.constructor;
+        const methodName = String(propertyKey);
+        if (Reflect.hasMetadata(decorators_1.METADATA_KEYS.MCP_AUTH_JWT, apiClass, methodName)) {
+            throw new Error(`Only one @WpMcpAuthJwt may decorate ${apiClass.name}.${methodName}.`);
+        }
+        Reflect.defineMetadata(decorators_1.METADATA_KEYS.MCP_AUTH_JWT, new WpMcpJwtAuthMetadata(requirement), apiClass, methodName);
+    };
+}
+// webpieces-disable no-function-outside-class -- metadata reader paired with WpMcpAuthJwt
+function getWpMcpAuthJwt(apiClass, methodName) {
+    return Reflect.getMetadata(decorators_1.METADATA_KEYS.MCP_AUTH_JWT, apiClass, methodName);
+}
+//# sourceMappingURL=McpAuthMetadata.js.map

package/src/mcp/McpAuthMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpAuthMetadata.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/McpAuthMetadata.ts"],"names":[],"mappings":";;;AAUA,oCAcC;AAGD,0CAOC;AAlCD,4BAA0B;AAE1B,mDAAmD;AAEnD,8FAA8F;AAC9F,MAAa,oBAAoB;IACD;IAA5B,YAA4B,WAA2B;QAA3B,gBAAW,GAAX,WAAW,CAAgB;IAAG,CAAC;CAC9D;AAFD,oDAEC;AAED,iFAAiF;AACjF,SAAgB,YAAY,CAAC,WAA2B;IACpD,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAQ,EAAE;QAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC;QACpC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACvC,IAAI,OAAO,CAAC,WAAW,CAAC,0BAAa,CAAC,YAAY,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,uCAAuC,QAAQ,CAAC,IAAI,IAAI,UAAU,GAAG,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,CAAC,cAAc,CAClB,0BAAa,CAAC,YAAY,EAC1B,IAAI,oBAAoB,CAAC,WAAW,CAAC,EACrC,QAAQ,EACR,UAAU,CACb,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAED,0FAA0F;AAC1F,SAAgB,eAAe,CAC3B,QAAkB,EAClB,UAAkB;IAElB,OAAO,OAAO,CAAC,WAAW,CAAC,0BAAa,CAAC,YAAY,EAAE,QAAQ,EAAE,UAAU,CAE5D,CAAC;AACpB,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { JwtRequirement } from '../http/auth-mode';\nimport { METADATA_KEYS } from '../http/decorators';\n\n/** Authorization policy for the verified MCP user principal, independent of HTTP hop auth. */\nexport class WpMcpJwtAuthMetadata {\n    constructor(public readonly requirement: JwtRequirement) {}\n}\n\n// webpieces-disable no-function-outside-class -- authorization decorator factory\nexport function WpMcpAuthJwt(requirement: JwtRequirement): MethodDecorator {\n    return (target: object, propertyKey: string | symbol): void => {\n        const apiClass = target.constructor;\n        const methodName = String(propertyKey);\n        if (Reflect.hasMetadata(METADATA_KEYS.MCP_AUTH_JWT, apiClass, methodName)) {\n            throw new Error(`Only one @WpMcpAuthJwt may decorate ${apiClass.name}.${methodName}.`);\n        }\n        Reflect.defineMetadata(\n            METADATA_KEYS.MCP_AUTH_JWT,\n            new WpMcpJwtAuthMetadata(requirement),\n            apiClass,\n            methodName,\n        );\n    };\n}\n\n// webpieces-disable no-function-outside-class -- metadata reader paired with WpMcpAuthJwt\nexport function getWpMcpAuthJwt(\n    apiClass: Function,\n    methodName: string,\n): WpMcpJwtAuthMetadata | undefined {\n    return Reflect.getMetadata(METADATA_KEYS.MCP_AUTH_JWT, apiClass, methodName) as\n        | WpMcpJwtAuthMetadata\n        | undefined;\n}\n"]}

package/src/mcp/McpCompileAssertions.js

@@ -11,7 +11,7 @@ const invalidMapValue = new DtoSchema_1.WpDtoMapFieldOptions('invalid map', true
 // @ts-expect-error a map value type is mandatory: it is the whole point of WpDtoMapFieldOptions
 const missingMapValue = new DtoSchema_1.WpDtoMapFieldOptions('invalid map', true);
 const noEighthFieldArgument = new DtoSchema_1.WpDtoFieldOptions('maps are not a WpDtoFieldOptions argument', false, undefined, false, undefined, undefined, undefined, 
-// @ts-expect-error maps use WpDtoMapFieldOptions, never an 8th positional argument
+// @ts-expect-error maps use WpDtoMapFieldOptions; the 8th argument is only a WpMcpHeader
 'string');
 class InvalidMcpContract {
     // @ts-expect-error read-only tools cannot also claim to be destructive

package/src/mcp/McpCompileAssertions.js.map

@@ -1 +1 @@
-{"version":3,"file":"McpCompileAssertions.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/McpCompileAssertions.ts"],"names":[],"mappings":";;;AAAA,+CAA0C;AAC1C,2CAAsE;AAEtE,MAAM,gBAAgB,GAAG,IAAI,6BAAiB,CAC1C,cAAc,EACd,IAAI,EACJ,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS;AACT,uEAAuE;AACvE,EAAE,CACL,CAAC;AAEF,0EAA0E;AAC1E,MAAM,eAAe,GAAG,IAAI,gCAAoB,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAE9E,gGAAgG;AAChG,MAAM,eAAe,GAAG,IAAI,gCAAoB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AAEtE,MAAM,qBAAqB,GAAG,IAAI,6BAAiB,CAC/C,2CAA2C,EAC3C,KAAK,EACL,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS,EACT,SAAS;AACT,mFAAmF;AACnF,QAAQ,CACX,CAAC;AAEF,MAAe,kBAAkB;IAC7B,uEAAuE;IASvE,OAAO;QACH,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;CACJ;AAHG;IARC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;;;;iDAGD;AAGL,MAAe,iBAAiB;IAC5B,6DAA6D;IAQ7D,IAAI;QACA,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;IAED,6DAA6D;IAQ7D,KAAK,CAAC,MAAc,EAAE,OAAe;QACjC,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;CACJ;AAfG;IAPC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;;;;6CAGD;AAUD;IAPC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;;;;8CAGD;AAGL,KAAK,kBAAkB,CAAC;AACxB,KAAK,iBAAiB,CAAC;AACvB,KAAK,gBAAgB,CAAC;AACtB,KAAK,eAAe,CAAC;AACrB,KAAK,eAAe,CAAC;AACrB,KAAK,qBAAqB,CAAC","sourcesContent":["import { WpMcpTool } from './McpMetadata';\nimport { WpDtoFieldOptions, WpDtoMapFieldOptions } from './DtoSchema';\n\nconst invalidEmptyEnum = new WpDtoFieldOptions(\n    'invalid enum',\n    true,\n    undefined,\n    false,\n    undefined,\n    undefined,\n    // @ts-expect-error enumValues must contain at least one allowed string\n    [],\n);\n\n// @ts-expect-error a map's value type must be a scalar name or a DtoClass\nconst invalidMapValue = new WpDtoMapFieldOptions('invalid map', true, 'date');\n\n// @ts-expect-error a map value type is mandatory: it is the whole point of WpDtoMapFieldOptions\nconst missingMapValue = new WpDtoMapFieldOptions('invalid map', true);\n\nconst noEighthFieldArgument = new WpDtoFieldOptions(\n    'maps are not a WpDtoFieldOptions argument',\n    false,\n    undefined,\n    false,\n    undefined,\n    undefined,\n    undefined,\n    // @ts-expect-error maps use WpDtoMapFieldOptions, never an 8th positional argument\n    'string',\n);\n\nabstract class InvalidMcpContract {\n    // @ts-expect-error read-only tools cannot also claim to be destructive\n    @WpMcpTool({\n        name: 'invalid',\n        description: 'This declaration must never compile.',\n        readOnlyHint: true,\n        destructiveHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n    })\n    invalid(): Promise<void> {\n        throw new Error('contract only');\n    }\n}\n\nabstract class InvalidMcpArities {\n    // @ts-expect-error MCP tools require exactly one request DTO\n    @WpMcpTool({\n        name: 'zero-arity',\n        description: 'This declaration must never compile.',\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n    })\n    zero(): Promise<object> {\n        throw new Error('contract only');\n    }\n\n    // @ts-expect-error MCP tools require exactly one request DTO\n    @WpMcpTool({\n        name: 'multi-arity',\n        description: 'This declaration must never compile.',\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n    })\n    multi(_first: object, _second: object): Promise<object> {\n        throw new Error('contract only');\n    }\n}\n\nvoid InvalidMcpContract;\nvoid InvalidMcpArities;\nvoid invalidEmptyEnum;\nvoid invalidMapValue;\nvoid missingMapValue;\nvoid noEighthFieldArgument;\n"]}
+{"version":3,"file":"McpCompileAssertions.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/McpCompileAssertions.ts"],"names":[],"mappings":";;;AAAA,+CAA0C;AAC1C,2CAAsE;AAEtE,MAAM,gBAAgB,GAAG,IAAI,6BAAiB,CAC1C,cAAc,EACd,IAAI,EACJ,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS;AACT,uEAAuE;AACvE,EAAE,CACL,CAAC;AAEF,0EAA0E;AAC1E,MAAM,eAAe,GAAG,IAAI,gCAAoB,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAE9E,gGAAgG;AAChG,MAAM,eAAe,GAAG,IAAI,gCAAoB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AAEtE,MAAM,qBAAqB,GAAG,IAAI,6BAAiB,CAC/C,2CAA2C,EAC3C,KAAK,EACL,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS,EACT,SAAS;AACT,yFAAyF;AACzF,QAAQ,CACX,CAAC;AAEF,MAAe,kBAAkB;IAC7B,uEAAuE;IASvE,OAAO;QACH,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;CACJ;AAHG;IARC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;;;;iDAGD;AAGL,MAAe,iBAAiB;IAC5B,6DAA6D;IAQ7D,IAAI;QACA,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;IAED,6DAA6D;IAQ7D,KAAK,CAAC,MAAc,EAAE,OAAe;QACjC,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;CACJ;AAfG;IAPC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;;;;6CAGD;AAUD;IAPC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;;;;8CAGD;AAGL,KAAK,kBAAkB,CAAC;AACxB,KAAK,iBAAiB,CAAC;AACvB,KAAK,gBAAgB,CAAC;AACtB,KAAK,eAAe,CAAC;AACrB,KAAK,eAAe,CAAC;AACrB,KAAK,qBAAqB,CAAC","sourcesContent":["import { WpMcpTool } from './McpMetadata';\nimport { WpDtoFieldOptions, WpDtoMapFieldOptions } from './DtoSchema';\n\nconst invalidEmptyEnum = new WpDtoFieldOptions(\n    'invalid enum',\n    true,\n    undefined,\n    false,\n    undefined,\n    undefined,\n    // @ts-expect-error enumValues must contain at least one allowed string\n    [],\n);\n\n// @ts-expect-error a map's value type must be a scalar name or a DtoClass\nconst invalidMapValue = new WpDtoMapFieldOptions('invalid map', true, 'date');\n\n// @ts-expect-error a map value type is mandatory: it is the whole point of WpDtoMapFieldOptions\nconst missingMapValue = new WpDtoMapFieldOptions('invalid map', true);\n\nconst noEighthFieldArgument = new WpDtoFieldOptions(\n    'maps are not a WpDtoFieldOptions argument',\n    false,\n    undefined,\n    false,\n    undefined,\n    undefined,\n    undefined,\n    // @ts-expect-error maps use WpDtoMapFieldOptions; the 8th argument is only a WpMcpHeader\n    'string',\n);\n\nabstract class InvalidMcpContract {\n    // @ts-expect-error read-only tools cannot also claim to be destructive\n    @WpMcpTool({\n        name: 'invalid',\n        description: 'This declaration must never compile.',\n        readOnlyHint: true,\n        destructiveHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n    })\n    invalid(): Promise<void> {\n        throw new Error('contract only');\n    }\n}\n\nabstract class InvalidMcpArities {\n    // @ts-expect-error MCP tools require exactly one request DTO\n    @WpMcpTool({\n        name: 'zero-arity',\n        description: 'This declaration must never compile.',\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n    })\n    zero(): Promise<object> {\n        throw new Error('contract only');\n    }\n\n    // @ts-expect-error MCP tools require exactly one request DTO\n    @WpMcpTool({\n        name: 'multi-arity',\n        description: 'This declaration must never compile.',\n        readOnlyHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n    })\n    multi(_first: object, _second: object): Promise<object> {\n        throw new Error('contract only');\n    }\n}\n\nvoid InvalidMcpContract;\nvoid InvalidMcpArities;\nvoid invalidEmptyEnum;\nvoid invalidMapValue;\nvoid missingMapValue;\nvoid noEighthFieldArgument;\n"]}