@webpieces/core-util 0.4.771 → 0.4.773

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/core-util",
-  "version": "0.4.771",
+  "version": "0.4.773",
   "description": "Utility functions for WebPieces - works in browser and Node.js",
   "type": "commonjs",
   "main": "./src/index.js",

package/src/index.d.ts

@@ -28,8 +28,8 @@ export type { ContractHttpMethod, EndpointResponseType, HttpParameterSource, Htt
 export type { EndpointKind, EndpointOptions, ExternalEndpointOptions } from './http/decorators';
 export { WpMcpTool, WpMcpToolHints, WpMcpToolMetadata, getWpMcpTools } from './mcp/McpMetadata';
 export type { WpMcpMethodDecorator, WpMcpToolOptions } from './mcp/McpMetadata';
-export { WpDto, WpDtoField, WpDtoFieldOptions, WpDtoFieldMetadata, WpResponseDto, ApiJsonSchema, DtoValidationFailure, DtoSchemaBuilder, } from './mcp/DtoSchema';
-export type { DtoClass, DtoArrayItem, DtoValue } from './mcp/DtoSchema';
+export { WpDto, WpDtoField, WpDtoFieldOptions, WpDtoMapFieldOptions, WpDtoFieldMetadata, WpResponseDto, ApiJsonSchema, DtoValidationFailure, DtoSchemaBuilder, } from './mcp/DtoSchema';
+export type { DtoClass, DtoElementType, DtoValue } from './mcp/DtoSchema';
 export { AuthMeta } from './http/auth-mode';
 export type { AuthMode, ApiKeyCredential, ApiKeyCredentials, JwtRoles, JwtRequirement, } from './http/auth-mode';
 export { Rpc, PubSub, Queue, ENDPOINT_KINDS_BY_API_KIND, getApiKind, assertApiKind, assertPubSubConventions, getQueueName, } from './http/api-kind';

package/src/index.js

@@ -9,9 +9,9 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getIpcEndpoints = exports.getIpcApiId = exports.isInternalApi = exports.WpIpcEndpoint = exports.WpInternal = exports.getHttpParameterDeclarations = exports.QueryParam = exports.PathParam = exports.METADATA_KEYS = exports.validateNoConflictingDecorators = exports.assertEveryWebhookEndpointRetainsRawBody = exports.assertEveryExternalEndpointDeclaresCaller = exports.assertEveryEndpointHasAuthMode = exports.getAuthMode = exports.getAuthMeta = exports.isApiPath = exports.isRawBody = exports.isFormPost = exports.getMaskSpec = exports.getEndpointKinds = exports.getEndpointKind = exports.getEndpointOptions = exports.getEndpoints = exports.getApiPath = exports.MaskLog = exports.WpAuthLocalOnly = exports.WpAuthApiKey = exports.WpAuthWebhook = exports.WpAuthSharedSecret = exports.WpAuthOidc = exports.MISSING_AUTH_DECORATOR_FIX = exports.rolesRequired = exports.WpAuthJwt = exports.WpAuthPublic = exports.Endpoint = exports.ApiPath = exports.GCP_LOG_BUDGET_BYTES = exports.MAX_GCP_LOG_BYTES = exports.LogChunkInfo = exports.LogChunkerImpl = exports.LogChunker = exports.LogManager = exports.ConsoleLoggerFactory = exports.ConsoleLogger = exports.DESIGN_METADATA_KEYS = exports.isDocumentDesign = exports.DocumentDesign = exports.ContextTuple = exports.ContextKey = exports.toError = void 0;
-exports.DateUtil = exports.InstantUtil = exports.NetworkRejectClassifier = exports.NO_REG_CODE = exports.WRONG_COMPANY = exports.WRONG_DOMAIN = exports.EMAIL_NOT_CONFIRMED = exports.NOT_APPROVED = exports.WRONG_LOGIN = exports.WRONG_LOGIN_TYPE = exports.ENTITY_NOT_FOUND = exports.SECRETS = exports.Secrets = exports.getEndpointCaller = exports.isExternalSystemKind = exports.ExternalCaller = exports.DEFAULT_CALLER_KIND = exports.EXTERNAL_SYSTEM_KINDS = exports.getQueueName = exports.assertPubSubConventions = exports.assertApiKind = exports.getApiKind = exports.ENDPOINT_KINDS_BY_API_KIND = exports.Queue = exports.PubSub = exports.Rpc = exports.AuthMeta = exports.DtoSchemaBuilder = exports.DtoValidationFailure = exports.ApiJsonSchema = exports.WpResponseDto = exports.WpDtoFieldMetadata = exports.WpDtoFieldOptions = exports.WpDtoField = exports.WpDto = exports.getWpMcpTools = exports.WpMcpToolMetadata = exports.WpMcpToolHints = exports.WpMcpTool = exports.HttpParameterDeclaration = exports.HttpParameterBinding = exports.HttpContractMapper = exports.BoundHttpRequest = exports.RouteMetadataFactory = exports.RouteMetadata = exports.IPC_METADATA_KEYS = exports.assertNotInternalApi = exports.assertInternalApi = exports.getIpcMaskSpec = exports.getIpcEndpointKind = void 0;
-exports.ApiUnauthorizedError = exports.ApiBadRequestError = exports.ApiEndUserError = exports.ApiRequestTimeoutError = exports.ApiForbiddenError = exports.ApiRateLimitedError = exports.ApiImplementationError = exports.ApiDependencyTimeoutError = exports.ApiUnavailableError = exports.ApiDependencyError = exports.ApiNotFoundError = exports.ApiError = exports.FilterChain = exports.Filter = exports.SerializedError = exports.SerializedMap = exports.RecordSerializer = exports.getDoNotRecordFields = exports.DoNotRecord = exports.RecordedTestCase = exports.RecordedError = exports.RecordedEndpoint = exports.RecorderKeys = exports.ApiMethodInfo = exports.LOG_API_CALL_LOGGER_NAME = exports.ApiCallLogNameImpl = exports.ApiCallLogName = exports.ApiCallInfo = exports.MaskSpec = exports.LogApiCallImpl = exports.ContextMgr = exports.DestinationTrust = exports.WebpiecesCoreHeaders = exports.templateDeriver = exports.WEBPIECES_DEFAULT_FAILURE_CLASSIFIER = exports.WebpiecesDefaultFailureClassifier = exports.KeyedFailureClassifier = exports.HttpResponseDto = exports.HttpResponseStatus = exports.HttpHeader = exports.RuntimeLocality = exports.ServiceInfo = exports.ApiCallTimeoutError = exports.CallContext = exports.CallDeadline = exports.CallRegistry = exports.ClientRegistry = exports.HeaderRegistry = exports.DateTimeUtil = exports.TimeUtil = void 0;
-exports.ApiErrorHttpStatus = exports.ApiErrorPayload = exports.ApiErrorCodec = exports.ApiEndpointNotFoundError = exports.ApiConnectionError = exports.ApiDependencyBackoffError = void 0;
+exports.InstantUtil = exports.NetworkRejectClassifier = exports.NO_REG_CODE = exports.WRONG_COMPANY = exports.WRONG_DOMAIN = exports.EMAIL_NOT_CONFIRMED = exports.NOT_APPROVED = exports.WRONG_LOGIN = exports.WRONG_LOGIN_TYPE = exports.ENTITY_NOT_FOUND = exports.SECRETS = exports.Secrets = exports.getEndpointCaller = exports.isExternalSystemKind = exports.ExternalCaller = exports.DEFAULT_CALLER_KIND = exports.EXTERNAL_SYSTEM_KINDS = exports.getQueueName = exports.assertPubSubConventions = exports.assertApiKind = exports.getApiKind = exports.ENDPOINT_KINDS_BY_API_KIND = exports.Queue = exports.PubSub = exports.Rpc = exports.AuthMeta = exports.DtoSchemaBuilder = exports.DtoValidationFailure = exports.ApiJsonSchema = exports.WpResponseDto = exports.WpDtoFieldMetadata = exports.WpDtoMapFieldOptions = exports.WpDtoFieldOptions = exports.WpDtoField = exports.WpDto = exports.getWpMcpTools = exports.WpMcpToolMetadata = exports.WpMcpToolHints = exports.WpMcpTool = exports.HttpParameterDeclaration = exports.HttpParameterBinding = exports.HttpContractMapper = exports.BoundHttpRequest = exports.RouteMetadataFactory = exports.RouteMetadata = exports.IPC_METADATA_KEYS = exports.assertNotInternalApi = exports.assertInternalApi = exports.getIpcMaskSpec = exports.getIpcEndpointKind = void 0;
+exports.ApiBadRequestError = exports.ApiEndUserError = exports.ApiRequestTimeoutError = exports.ApiForbiddenError = exports.ApiRateLimitedError = exports.ApiImplementationError = exports.ApiDependencyTimeoutError = exports.ApiUnavailableError = exports.ApiDependencyError = exports.ApiNotFoundError = exports.ApiError = exports.FilterChain = exports.Filter = exports.SerializedError = exports.SerializedMap = exports.RecordSerializer = exports.getDoNotRecordFields = exports.DoNotRecord = exports.RecordedTestCase = exports.RecordedError = exports.RecordedEndpoint = exports.RecorderKeys = exports.ApiMethodInfo = exports.LOG_API_CALL_LOGGER_NAME = exports.ApiCallLogNameImpl = exports.ApiCallLogName = exports.ApiCallInfo = exports.MaskSpec = exports.LogApiCallImpl = exports.ContextMgr = exports.DestinationTrust = exports.WebpiecesCoreHeaders = exports.templateDeriver = exports.WEBPIECES_DEFAULT_FAILURE_CLASSIFIER = exports.WebpiecesDefaultFailureClassifier = exports.KeyedFailureClassifier = exports.HttpResponseDto = exports.HttpResponseStatus = exports.HttpHeader = exports.RuntimeLocality = exports.ServiceInfo = exports.ApiCallTimeoutError = exports.CallContext = exports.CallDeadline = exports.CallRegistry = exports.ClientRegistry = exports.HeaderRegistry = exports.DateTimeUtil = exports.TimeUtil = exports.DateUtil = void 0;
+exports.ApiErrorHttpStatus = exports.ApiErrorPayload = exports.ApiErrorCodec = exports.ApiEndpointNotFoundError = exports.ApiConnectionError = exports.ApiDependencyBackoffError = exports.ApiUnauthorizedError = void 0;
 var errorUtils_1 = require("./lib/errorUtils");
 Object.defineProperty(exports, "toError", { enumerable: true, get: function () { return errorUtils_1.toError; } });
 var ContextKey_1 = require("./ContextKey");
@@ -107,6 +107,7 @@ var DtoSchema_1 = require("./mcp/DtoSchema");
 Object.defineProperty(exports, "WpDto", { enumerable: true, get: function () { return DtoSchema_1.WpDto; } });
 Object.defineProperty(exports, "WpDtoField", { enumerable: true, get: function () { return DtoSchema_1.WpDtoField; } });
 Object.defineProperty(exports, "WpDtoFieldOptions", { enumerable: true, get: function () { return DtoSchema_1.WpDtoFieldOptions; } });
+Object.defineProperty(exports, "WpDtoMapFieldOptions", { enumerable: true, get: function () { return DtoSchema_1.WpDtoMapFieldOptions; } });
 Object.defineProperty(exports, "WpDtoFieldMetadata", { enumerable: true, get: function () { return DtoSchema_1.WpDtoFieldMetadata; } });
 Object.defineProperty(exports, "WpResponseDto", { enumerable: true, get: function () { return DtoSchema_1.WpResponseDto; } });
 Object.defineProperty(exports, "ApiJsonSchema", { enumerable: true, get: function () { return DtoSchema_1.ApiJsonSchema; } });

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    WpDtoFieldMetadata,\n    WpResponseDto,\n    ApiJsonSchema,\n    DtoValidationFailure,\n    DtoSchemaBuilder,\n} from './mcp/DtoSchema';\nexport type { DtoClass, DtoArrayItem, 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 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"]}

package/src/mcp/DtoSchema.d.ts

@@ -1,6 +1,7 @@
 import 'reflect-metadata';
 export type DtoClass = abstract new (...args: any[]) => unknown;
-export type DtoArrayItem = 'string' | 'number' | 'integer' | 'boolean' | DtoClass;
+/** The element type of an array or the value type of a map; TypeScript erases both at runtime. */
+export type DtoElementType = 'string' | 'number' | 'integer' | 'boolean' | DtoClass;
 /** Runtime values accepted at the DTO validation boundary. */
 export type DtoValue = object | string | number | boolean | null;
 /** Additive field metadata; the scalar/object type itself comes from `design:type`. */
@@ -9,7 +10,7 @@ export declare class WpDtoFieldOptions {
     /** Required/optional is explicit because TypeScript erases `?` at runtime. */
     readonly required: boolean;
     /** Required for arrays because TypeScript erases their element type. */
-    readonly arrayItems?: DtoArrayItem | undefined;
+    readonly arrayItems?: DtoElementType | undefined;
     /** A reflected Number is otherwise emitted as JSON Schema `number`. */
     readonly integer: boolean;
     readonly minimum?: number | undefined;
@@ -19,14 +20,28 @@ export declare class WpDtoFieldOptions {
     /** Required/optional is explicit because TypeScript erases `?` at runtime. */
     required: boolean, 
     /** Required for arrays because TypeScript erases their element type. */
-    arrayItems?: DtoArrayItem | undefined, 
+    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);
 }
+/**
+ * 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
+ * reason `arrayItems` is: TypeScript erases it, and a `Record` reflects as plain `Object`.
+ */
+export declare class WpDtoMapFieldOptions {
+    readonly description: string;
+    /** Required/optional is explicit because TypeScript erases `?` at runtime. */
+    readonly required: boolean;
+    readonly mapValues: DtoElementType;
+    constructor(description: string, 
+    /** Required/optional is explicit because TypeScript erases `?` at runtime. */
+    required: boolean, mapValues: DtoElementType);
+}
 export declare class WpDtoFieldMetadata {
     readonly propertyKey: string;
-    readonly options: WpDtoFieldOptions;
-    constructor(propertyKey: string, options: WpDtoFieldOptions);
+    readonly options: WpDtoFieldOptions | WpDtoMapFieldOptions;
+    constructor(propertyKey: string, options: WpDtoFieldOptions | WpDtoMapFieldOptions);
 }
 /** The JSON Schema subset emitted for Webpieces API DTOs. */
 export declare class ApiJsonSchema {
@@ -34,7 +49,8 @@ export declare class ApiJsonSchema {
     description?: string;
     properties?: Record<string, ApiJsonSchema>;
     required?: string[];
-    additionalProperties?: boolean;
+    /** `false` closes an object; a schema makes it a typed map whose values all match that schema. */
+    additionalProperties?: boolean | ApiJsonSchema;
     items?: ApiJsonSchema;
     enum?: string[];
     minimum?: number;
@@ -49,13 +65,20 @@ export declare class DtoValidationFailure {
 /** Marks a request/response class as a schema-bearing DTO, including intentionally empty DTOs. */
 export declare function WpDto(): ClassDecorator;
 /** Adds documentation and runtime-only shape facts to a DTO property. */
-export declare function WpDtoField(options: WpDtoFieldOptions): PropertyDecorator;
+export declare function WpDtoField(options: WpDtoFieldOptions | WpDtoMapFieldOptions): PropertyDecorator;
 /** Declares an async API method's response DTO because reflection sees Promise, not its generic. */
 export declare function WpResponseDto(responseDto: () => DtoClass): MethodDecorator;
 /** Builds and validates the same DTO schema used for MCP input and structured output. */
 export declare class DtoSchemaBuilder {
     requestClassOf(apiClass: Function, methodName: string): DtoClass;
     responseClassOf(apiClass: Function, methodName: string): DtoClass;
+    /**
+     * The one closure gate for an object schema. Closed means no key can carry an unspecified value:
+     * either extra keys are forbidden (`additionalProperties: false`) or every extra key's value is
+     * typed (`additionalProperties: <schema>`, a typed map). A missing or `true` value is open.
+     * Use this instead of `schema.additionalProperties === false`, which rejects typed maps.
+     */
+    isClosedSchema(schema: ApiJsonSchema): boolean;
     build(dtoClass: DtoClass): ApiJsonSchema;
     validate(dtoClass: DtoClass, value: DtoValue): DtoValidationFailure | undefined;
     private buildAt;
@@ -65,6 +88,8 @@ export declare class DtoSchemaBuilder {
     private validateAt;
     private validateField;
     private validateArray;
+    private validateMap;
+    private validateElement;
     private fields;
     private requireDto;
 }

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.WpDtoFieldOptions = void 0;
+exports.DtoSchemaBuilder = exports.DtoValidationFailure = exports.ApiJsonSchema = exports.WpDtoFieldMetadata = exports.WpDtoMapFieldOptions = exports.WpDtoFieldOptions = void 0;
 exports.WpDto = WpDto;
 exports.WpDtoField = WpDtoField;
 exports.WpResponseDto = WpResponseDto;
@@ -34,6 +34,24 @@ class WpDtoFieldOptions {
     }
 }
 exports.WpDtoFieldOptions = WpDtoFieldOptions;
+/**
+ * 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
+ * reason `arrayItems` is: TypeScript erases it, and a `Record` reflects as plain `Object`.
+ */
+class WpDtoMapFieldOptions {
+    description;
+    required;
+    mapValues;
+    constructor(description, 
+    /** Required/optional is explicit because TypeScript erases `?` at runtime. */
+    required, mapValues) {
+        this.description = description;
+        this.required = required;
+        this.mapValues = mapValues;
+    }
+}
+exports.WpDtoMapFieldOptions = WpDtoMapFieldOptions;
 class WpDtoFieldMetadata {
     propertyKey;
     options;
@@ -49,6 +67,7 @@ class ApiJsonSchema {
     description;
     properties;
     required;
+    /** `false` closes an object; a schema makes it a typed map whose values all match that schema. */
     additionalProperties;
     items;
     enum;
@@ -114,6 +133,16 @@ class DtoSchemaBuilder {
         }
         return response();
     }
+    /**
+     * The one closure gate for an object schema. Closed means no key can carry an unspecified value:
+     * either extra keys are forbidden (`additionalProperties: false`) or every extra key's value is
+     * typed (`additionalProperties: <schema>`, a typed map). A missing or `true` value is open.
+     * Use this instead of `schema.additionalProperties === false`, which rejects typed maps.
+     */
+    isClosedSchema(schema) {
+        const extra = schema.additionalProperties;
+        return extra === false || (typeof extra === 'object' && extra !== null);
+    }
     build(dtoClass) {
         return this.buildAt(dtoClass, new Set());
     }
@@ -145,8 +174,14 @@ class DtoSchemaBuilder {
         const reflected = Reflect.getMetadata('design:type', dtoClass.prototype, field.propertyKey);
         if (!reflected)
             throw new Error(`No reflected type for ${dtoClass.name}.${field.propertyKey}.`);
-        const options = field.options;
         this.validateOptions(dtoClass, field, reflected);
+        const options = field.options;
+        if (options instanceof WpDtoMapFieldOptions) {
+            const mapSchema = new ApiJsonSchema('object');
+            mapSchema.description = options.description;
+            mapSchema.additionalProperties = this.itemSchema(options.mapValues, parents);
+            return mapSchema;
+        }
         let schema;
         switch (reflected.name) {
             case 'String':
@@ -180,6 +215,16 @@ class DtoSchemaBuilder {
     validateOptions(dtoClass, field, reflected) {
         const label = `${dtoClass.name}.${field.propertyKey}`;
         const options = field.options;
+        if (options instanceof WpDtoMapFieldOptions) {
+            if (reflected !== Object) {
+                throw new Error(`${label} declares mapValues but is not a map (Record<string, V>).`);
+            }
+            return;
+        }
+        if (reflected === Object) {
+            throw new Error(`${label} has type Object: an interface or Record can never be a @WpDto. ` +
+                'For a map, use WpDtoMapFieldOptions.');
+        }
         if (reflected.name !== 'Array' && options.arrayItems) {
             throw new Error(`${label} declares arrayItems but is not an array.`);
         }
@@ -227,14 +272,17 @@ class DtoSchemaBuilder {
     validateField(dtoClass, field, value, path) {
         // webpieces-disable no-any-unknown -- reflect-metadata returns an erased constructor token
         const reflected = Reflect.getMetadata('design:type', dtoClass.prototype, field.propertyKey);
+        const options = field.options;
+        if (options instanceof WpDtoMapFieldOptions)
+            return this.validateMap(options, value, path);
         const expected = reflected?.name;
         if (expected === 'Array')
-            return this.validateArray(field.options, value, path);
+            return this.validateArray(options, value, path);
         if (expected === 'String') {
             if (typeof value !== 'string')
                 return new DtoValidationFailure(`${path} must be a string`);
-            if (field.options.enumValues && !field.options.enumValues.includes(value)) {
-                return new DtoValidationFailure(`${path} must be one of: ${field.options.enumValues.join(', ')}`);
+            if (options.enumValues && !options.enumValues.includes(value)) {
+                return new DtoValidationFailure(`${path} must be one of: ${options.enumValues.join(', ')}`);
             }
             return undefined;
         }
@@ -242,14 +290,14 @@ class DtoSchemaBuilder {
             if (typeof value !== 'number' || !Number.isFinite(value)) {
                 return new DtoValidationFailure(`${path} must be a number`);
             }
-            if (field.options.integer && !Number.isInteger(value)) {
+            if (options.integer && !Number.isInteger(value)) {
                 return new DtoValidationFailure(`${path} must be an integer`);
             }
-            if (field.options.minimum !== undefined && value < field.options.minimum) {
-                return new DtoValidationFailure(`${path} must be >= ${field.options.minimum}`);
+            if (options.minimum !== undefined && value < options.minimum) {
+                return new DtoValidationFailure(`${path} must be >= ${options.minimum}`);
             }
-            if (field.options.maximum !== undefined && value > field.options.maximum) {
-                return new DtoValidationFailure(`${path} must be <= ${field.options.maximum}`);
+            if (options.maximum !== undefined && value > options.maximum) {
+                return new DtoValidationFailure(`${path} must be <= ${options.maximum}`);
             }
             return undefined;
         }
@@ -266,17 +314,34 @@ class DtoSchemaBuilder {
         if (!options.arrayItems)
             return new DtoValidationFailure(`${path} has no item type`);
         for (let index = 0; index < value.length; index += 1) {
-            const item = value[index];
-            if (typeof options.arrayItems !== 'string') {
-                const nested = this.validateAt(options.arrayItems, item, `${path}[${index}]`);
-                if (nested)
-                    return nested;
-                continue;
-            }
-            const wanted = options.arrayItems === 'integer' ? 'number' : options.arrayItems;
-            if (typeof item !== wanted || (options.arrayItems === 'integer' && !Number.isInteger(item))) {
-                return new DtoValidationFailure(`${path}[${index}] must be ${options.arrayItems}`);
-            }
+            const failure = this.validateElement(options.arrayItems, value[index], `${path}[${index}]`);
+            if (failure)
+                return failure;
+        }
+        return undefined;
+    }
+    validateMap(options, value, path) {
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            return new DtoValidationFailure(`${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`);
+        }
+        for (const key of Object.keys(value)) {
+            const entry = Object.getOwnPropertyDescriptor(value, key)?.value;
+            const failure = this.validateElement(options.mapValues, entry, `${path}.${key}`);
+            if (failure)
+                return failure;
+        }
+        return undefined;
+    }
+    validateElement(type, item, path) {
+        if (typeof type !== 'string')
+            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 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;\nexport type DtoArrayItem = '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?: DtoArrayItem,\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\nexport class WpDtoFieldMetadata {\n    constructor(\n        public readonly propertyKey: string,\n        public readonly options: WpDtoFieldOptions,\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    additionalProperties?: boolean;\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): 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    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        const options = field.options;\n        this.validateOptions(dtoClass, field, reflected);\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 (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: DtoArrayItem, 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 expected = reflected?.name;\n        if (expected === 'Array') return this.validateArray(field.options, value, path);\n        if (expected === 'String') {\n            if (typeof value !== 'string') return new DtoValidationFailure(`${path} must be a string`);\n            if (field.options.enumValues && !field.options.enumValues.includes(value)) {\n                return new DtoValidationFailure(`${path} must be one of: ${field.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 (field.options.integer && !Number.isInteger(value)) {\n                return new DtoValidationFailure(`${path} must be an integer`);\n            }\n            if (field.options.minimum !== undefined && value < field.options.minimum) {\n                return new DtoValidationFailure(`${path} must be >= ${field.options.minimum}`);\n            }\n            if (field.options.maximum !== undefined && value > field.options.maximum) {\n                return new DtoValidationFailure(`${path} must be <= ${field.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 item = value[index];\n            if (typeof options.arrayItems !== 'string') {\n                const nested = this.validateAt(options.arrayItems, item, `${path}[${index}]`);\n                if (nested) return nested;\n                continue;\n            }\n            const wanted = options.arrayItems === 'integer' ? 'number' : options.arrayItems;\n            if (typeof item !== wanted || (options.arrayItems === 'integer' && !Number.isInteger(item))) {\n                return new DtoValidationFailure(`${path}[${index}] must be ${options.arrayItems}`);\n            }\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    ) {}\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"]}

package/src/mcp/McpCompileAssertions.js

@@ -6,6 +6,13 @@ const DtoSchema_1 = require("./DtoSchema");
 const invalidEmptyEnum = new DtoSchema_1.WpDtoFieldOptions('invalid enum', true, undefined, false, undefined, undefined, 
 // @ts-expect-error enumValues must contain at least one allowed string
 []);
+// @ts-expect-error a map's value type must be a scalar name or a DtoClass
+const invalidMapValue = new DtoSchema_1.WpDtoMapFieldOptions('invalid map', true, 'date');
+// @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
+'string');
 class InvalidMcpContract {
     // @ts-expect-error read-only tools cannot also claim to be destructive
     invalid() {
@@ -62,4 +69,7 @@ tslib_1.__decorate([
 void InvalidMcpContract;
 void InvalidMcpArities;
 void invalidEmptyEnum;
+void invalidMapValue;
+void missingMapValue;
+void noEighthFieldArgument;
 //# sourceMappingURL=McpCompileAssertions.js.map

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,2CAAgD;AAEhD,MAAM,gBAAgB,GAAG,IAAI,6BAAiB,CAC1C,cAAc,EACd,IAAI,EACJ,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS;AACT,uEAAuE;AACvE,EAAE,CACL,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","sourcesContent":["import { WpMcpTool } from './McpMetadata';\nimport { WpDtoFieldOptions } 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\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;\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,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"]}