@zudojs/errors 1.3.2 → 1.4.0

package/dist/infrastructure/service/externalServiceError.base.js

@@ -5,13 +5,23 @@ import { BaseError } from "../../base/core/baseError.core.js";
 import { ErrorCategory } from "../../base/types/errorCategory.type.js";
 import { ErrorCode } from "../../base/types/errorCode.type.js";
 import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
-/** Error raised when an external dependency fails. */
+/** Service name recorded when a caller supplies none. */
+const UNKNOWN_SERVICE = "unknown";
+/**
+ * Error raised when an external dependency fails.
+ *
+ * `options.service` is required by the type. A JavaScript caller (or a
+ * `catch` block re-throwing with only a message) that omits the options
+ * object gets `service: "unknown"` rather than a `TypeError` thrown from
+ * inside the error constructor, which hid the failure it was reporting.
+ */
 export class ExternalServiceError extends BaseError {
     service;
     operation;
     responseStatus;
     serviceCode;
-    constructor(message = "An external service operation failed.", options) {
+    constructor(message = "An external service operation failed.", options = { service: UNKNOWN_SERVICE }) {
+        options = withService(options);
         super(message, {
             ...options,
             code: options.code ?? ErrorCode.EXTERNAL_SERVICE,
@@ -53,6 +63,14 @@ export class ExternalServiceError extends BaseError {
         };
     }
 }
+/** Fills in the service name when the caller left the options incomplete. */
+function withService(options) {
+    const partial = (options ?? {});
+    const service = typeof partial.service === "string" && partial.service.length > 0
+        ? partial.service
+        : UNKNOWN_SERVICE;
+    return { ...partial, service };
+}
 /** Creates an external service error. */
 export function createExternalServiceError(service, message = "An external service operation failed.", options = {}) {
     return new ExternalServiceError(message, { ...options, service });
@@ -74,4 +92,3 @@ export function mapResponseStatus(responseStatus) {
     }
     return 502;
 }
-//# sourceMappingURL=externalServiceError.base.js.map

package/dist/infrastructure/service/externalServiceError.factory.d.ts

@@ -8,4 +8,3 @@ export declare function externalServiceTimeoutError(service: string, operation?:
 export declare function externalServiceUnavailableError(service: string, operation?: string): ExternalServiceError;
 /** @deprecated Use `externalServiceUnavailableError`. */
 export declare const externalServiceUnavailable: typeof externalServiceUnavailableError;
-//# sourceMappingURL=externalServiceError.factory.d.ts.map

package/dist/infrastructure/service/externalServiceError.factory.js

@@ -31,4 +31,3 @@ export function externalServiceUnavailableError(service, operation) {
 }
 /** @deprecated Use `externalServiceUnavailableError`. */
 export const externalServiceUnavailable = externalServiceUnavailableError;
-//# sourceMappingURL=externalServiceError.factory.js.map

package/dist/infrastructure/service/index.d.ts

@@ -5,4 +5,3 @@
  */
 export * from "./service.error.js";
 export * from "./externalService.error.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/service/index.js

@@ -5,4 +5,3 @@
  */
 export * from "./service.error.js";
 export * from "./externalService.error.js";
-//# sourceMappingURL=index.js.map

package/dist/infrastructure/service/service.error.d.ts

@@ -4,4 +4,3 @@
 export { ServiceError, createServiceError, isServiceError, } from "./serviceError.base.js";
 export type { ServiceErrorOptions } from "./serviceError.base.js";
 export { serviceUnavailableError, serviceInitializationError, serviceOperationError, } from "./serviceError.factory.js";
-//# sourceMappingURL=service.error.d.ts.map

package/dist/infrastructure/service/service.error.js

@@ -3,4 +3,3 @@
  */
 export { ServiceError, createServiceError, isServiceError, } from "./serviceError.base.js";
 export { serviceUnavailableError, serviceInitializationError, serviceOperationError, } from "./serviceError.factory.js";
-//# sourceMappingURL=service.error.js.map

package/dist/infrastructure/service/serviceError.base.d.ts

@@ -36,4 +36,3 @@ export declare class ServiceError extends BaseError {
 export declare function createServiceError(message?: string, options?: ServiceErrorOptions): ServiceError;
 /** Determines whether an unknown value is a ServiceError. */
 export declare function isServiceError(value: unknown): value is ServiceError;
-//# sourceMappingURL=serviceError.base.d.ts.map

package/dist/infrastructure/service/serviceError.base.js

@@ -45,4 +45,3 @@ export function createServiceError(message = "A service operation failed.", opti
 export function isServiceError(value) {
     return value instanceof ServiceError;
 }
-//# sourceMappingURL=serviceError.base.js.map

package/dist/infrastructure/service/serviceError.factory.d.ts

@@ -8,4 +8,3 @@ export declare function serviceUnavailableError(service?: string): ServiceError;
 export declare function serviceInitializationError(service?: string, cause?: unknown): ServiceError;
 /** Creates a service operation failure. */
 export declare function serviceOperationError(operation: string, service?: string): ServiceError;
-//# sourceMappingURL=serviceError.factory.d.ts.map

package/dist/infrastructure/service/serviceError.factory.js

@@ -40,4 +40,3 @@ export function serviceOperationError(operation, service) {
         statusCode: 500,
     });
 }
-//# sourceMappingURL=serviceError.factory.js.map

package/dist/infrastructure/storage/database.error.d.ts

@@ -4,4 +4,3 @@
 export { DatabaseError, createDatabaseError, isDatabaseError, DatabaseOperation, } from "./databaseError.base.js";
 export type { DatabaseErrorOptions } from "./databaseError.base.js";
 export { databaseConnectionError, databaseQueryError, databaseTransactionError, databaseMigrationError, } from "./databaseError.factory.js";
-//# sourceMappingURL=database.error.d.ts.map

package/dist/infrastructure/storage/database.error.js

@@ -3,4 +3,3 @@
  */
 export { DatabaseError, createDatabaseError, isDatabaseError, DatabaseOperation, } from "./databaseError.base.js";
 export { databaseConnectionError, databaseQueryError, databaseTransactionError, databaseMigrationError, } from "./databaseError.factory.js";
-//# sourceMappingURL=database.error.js.map

package/dist/infrastructure/storage/databaseError.base.d.ts

@@ -51,4 +51,3 @@ export declare class DatabaseError extends BaseError {
 export declare function createDatabaseError(message?: string, options?: DatabaseErrorOptions): DatabaseError;
 /** Determines whether an unknown value is a DatabaseError. */
 export declare function isDatabaseError(value: unknown): value is DatabaseError;
-//# sourceMappingURL=databaseError.base.d.ts.map

package/dist/infrastructure/storage/databaseError.base.js

@@ -66,4 +66,3 @@ export function createDatabaseError(message = "A database operation failed.", op
 export function isDatabaseError(value) {
     return value instanceof DatabaseError;
 }
-//# sourceMappingURL=databaseError.base.js.map

package/dist/infrastructure/storage/databaseError.factory.d.ts

@@ -10,4 +10,3 @@ export declare function databaseQueryError(message?: string, options?: Omit<Data
 export declare function databaseTransactionError(message?: string, options?: Omit<DatabaseErrorOptions, "operation">): DatabaseError;
 /** Creates a database migration error. */
 export declare function databaseMigrationError(message?: string, options?: Omit<DatabaseErrorOptions, "operation">): DatabaseError;
-//# sourceMappingURL=databaseError.factory.d.ts.map

package/dist/infrastructure/storage/databaseError.factory.js

@@ -35,4 +35,3 @@ export function databaseMigrationError(message = "The database migration failed.
         operation: DatabaseOperation.MIGRATION,
     });
 }
-//# sourceMappingURL=databaseError.factory.js.map

package/dist/infrastructure/storage/index.d.ts

@@ -5,4 +5,3 @@
  */
 export * from "./database.error.js";
 export * from "./storage.error.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/storage/index.js

@@ -5,4 +5,3 @@
  */
 export * from "./database.error.js";
 export * from "./storage.error.js";
-//# sourceMappingURL=index.js.map

package/dist/infrastructure/storage/storage.error.d.ts

@@ -4,4 +4,3 @@
 export { StorageError, createStorageError, isStorageError, StorageOperation, } from "./storageError.base.js";
 export type { StorageErrorOptions } from "./storageError.base.js";
 export { storageReadError, storageWriteError, storageUploadError, storageDownloadError, storageDeleteError, storageNotFoundError, } from "./storageError.factory.js";
-//# sourceMappingURL=storage.error.d.ts.map

package/dist/infrastructure/storage/storage.error.js

@@ -3,4 +3,3 @@
  */
 export { StorageError, createStorageError, isStorageError, StorageOperation, } from "./storageError.base.js";
 export { storageReadError, storageWriteError, storageUploadError, storageDownloadError, storageDeleteError, storageNotFoundError, } from "./storageError.factory.js";
-//# sourceMappingURL=storage.error.js.map

package/dist/infrastructure/storage/storageError.base.d.ts

@@ -52,4 +52,3 @@ export declare class StorageError extends BaseError {
 export declare function createStorageError(message?: string, options?: StorageErrorOptions): StorageError;
 /** Determines whether an unknown value is a StorageError. */
 export declare function isStorageError(value: unknown): value is StorageError;
-//# sourceMappingURL=storageError.base.d.ts.map

package/dist/infrastructure/storage/storageError.base.js

@@ -67,4 +67,3 @@ export function createStorageError(message = "A storage operation failed.", opti
 export function isStorageError(value) {
     return value instanceof StorageError;
 }
-//# sourceMappingURL=storageError.base.js.map

package/dist/infrastructure/storage/storageError.factory.d.ts

@@ -14,4 +14,3 @@ export declare function storageDownloadError(resource: string, provider?: string
 export declare function storageDeleteError(resource: string, provider?: string, cause?: unknown): StorageError;
 /** Creates a storage not found error. */
 export declare function storageNotFoundError(resource: string, provider?: string): StorageError;
-//# sourceMappingURL=storageError.factory.d.ts.map

package/dist/infrastructure/storage/storageError.factory.js

@@ -64,4 +64,3 @@ export function storageNotFoundError(resource, provider) {
         expose: true,
     });
 }
-//# sourceMappingURL=storageError.factory.js.map

package/dist/system/crypto.error.d.ts

@@ -4,4 +4,3 @@
 export { CryptoError, createCryptoError, isCryptoError, CryptoOperation, } from "./cryptoError.base.js";
 export type { CryptoErrorOptions } from "./cryptoError.base.js";
 export { cryptoHashError, cryptoCipherError, cryptoSignatureError, cryptoKeyDerivationError, cryptoKeyError, } from "./cryptoError.factory.js";
-//# sourceMappingURL=crypto.error.d.ts.map

package/dist/system/crypto.error.js

@@ -3,4 +3,3 @@
  */
 export { CryptoError, createCryptoError, isCryptoError, CryptoOperation, } from "./cryptoError.base.js";
 export { cryptoHashError, cryptoCipherError, cryptoSignatureError, cryptoKeyDerivationError, cryptoKeyError, } from "./cryptoError.factory.js";
-//# sourceMappingURL=crypto.error.js.map

package/dist/system/cryptoError.base.d.ts

@@ -53,4 +53,3 @@ export declare class CryptoError extends BaseError {
 export declare function createCryptoError(message?: string, options?: CryptoErrorOptions): CryptoError;
 /** Determines whether an unknown value is a CryptoError. */
 export declare function isCryptoError(value: unknown): value is CryptoError;
-//# sourceMappingURL=cryptoError.base.d.ts.map

package/dist/system/cryptoError.base.js

@@ -65,4 +65,3 @@ export function createCryptoError(message = "A cryptographic operation failed.",
 export function isCryptoError(value) {
     return value instanceof CryptoError;
 }
-//# sourceMappingURL=cryptoError.base.js.map

package/dist/system/cryptoError.factory.d.ts

@@ -12,4 +12,3 @@ export declare function cryptoSignatureError(message?: string, operation?: Crypt
 export declare function cryptoKeyDerivationError(message?: string, algorithm?: string): CryptoError;
 /** Creates a cryptographic key error. */
 export declare function cryptoKeyError(message?: string, operation?: CryptoOperation.KEY_GENERATION | CryptoOperation.KEY_IMPORT | CryptoOperation.KEY_EXPORT, algorithm?: string): CryptoError;
-//# sourceMappingURL=cryptoError.factory.d.ts.map

package/dist/system/cryptoError.factory.js

@@ -46,4 +46,3 @@ export function cryptoKeyError(message = "Cryptographic key operation failed.",
         algorithm,
     });
 }
-//# sourceMappingURL=cryptoError.factory.js.map

package/dist/system/index.d.ts

@@ -8,4 +8,3 @@ export * from "./system.error.js";
 export * from "./runtime.error.js";
 export * from "./logging/index.js";
 export * from "./observability/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/system/index.js

@@ -8,4 +8,3 @@ export * from "./system.error.js";
 export * from "./runtime.error.js";
 export * from "./logging/index.js";
 export * from "./observability/index.js";
-//# sourceMappingURL=index.js.map

package/dist/system/logging/index.d.ts

@@ -4,4 +4,3 @@
  * Logging subsystem error types.
  */
 export * from "./logging.error.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/system/logging/index.js

@@ -4,4 +4,3 @@
  * Logging subsystem error types.
  */
 export * from "./logging.error.js";
-//# sourceMappingURL=index.js.map

package/dist/system/logging/logging.error.d.ts

@@ -21,4 +21,3 @@ export declare function createLoggingError(message: string, options?: LoggingErr
  * Determines whether an unknown value is a LoggingError.
  */
 export declare function isLoggingError(value: unknown): value is LoggingError;
-//# sourceMappingURL=logging.error.d.ts.map

package/dist/system/logging/logging.error.js

@@ -30,4 +30,3 @@ export function createLoggingError(message, options = {}) {
 export function isLoggingError(value) {
     return value instanceof LoggingError;
 }
-//# sourceMappingURL=logging.error.js.map

package/dist/system/observability/index.d.ts

@@ -4,4 +4,3 @@
  * Telemetry (metrics, tracing, exporter) errors.
  */
 export * from "./observabilityError.base.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/system/observability/index.js

@@ -4,4 +4,3 @@
  * Telemetry (metrics, tracing, exporter) errors.
  */
 export * from "./observabilityError.base.js";
-//# sourceMappingURL=index.js.map

package/dist/system/observability/observabilityError.base.d.ts

@@ -13,4 +13,3 @@ export interface ObservabilityErrorOptions {
 export declare class ObservabilityError extends BaseError {
     constructor(message: string, options?: ObservabilityErrorOptions);
 }
-//# sourceMappingURL=observabilityError.base.d.ts.map

package/dist/system/observability/observabilityError.base.js

@@ -20,4 +20,3 @@ export class ObservabilityError extends BaseError {
         this.name = "ObservabilityError";
     }
 }
-//# sourceMappingURL=observabilityError.base.js.map

package/dist/system/runtime.error.d.ts

@@ -3,4 +3,3 @@
  */
 export * from "./runtimeError.base.js";
 export * from "./runtimeError.types.js";
-//# sourceMappingURL=runtime.error.d.ts.map

package/dist/system/runtime.error.js

@@ -3,4 +3,3 @@
  */
 export * from "./runtimeError.base.js";
 export * from "./runtimeError.types.js";
-//# sourceMappingURL=runtime.error.js.map

package/dist/system/runtimeError.base.d.ts

@@ -37,4 +37,3 @@ export declare class RuntimeError extends BaseError {
 export declare function createRuntimeError(message: string, options?: RuntimeErrorOptions): RuntimeError;
 /** Determines whether an unknown value is a RuntimeError. */
 export declare function isRuntimeError(value: unknown): value is RuntimeError;
-//# sourceMappingURL=runtimeError.base.d.ts.map

package/dist/system/runtimeError.base.js

@@ -37,4 +37,3 @@ export function createRuntimeError(message, options = {}) {
 export function isRuntimeError(value) {
     return value instanceof RuntimeError;
 }
-//# sourceMappingURL=runtimeError.base.js.map

package/dist/system/runtimeError.types.d.ts

@@ -29,4 +29,3 @@ export declare class RuntimeEnvironmentError extends RuntimeError {
 export declare class RuntimeManagerError extends RuntimeError {
     constructor(message: string, cause?: unknown);
 }
-//# sourceMappingURL=runtimeError.types.d.ts.map

package/dist/system/runtimeError.types.js

@@ -65,4 +65,3 @@ export class RuntimeManagerError extends RuntimeError {
         });
     }
 }
-//# sourceMappingURL=runtimeError.types.js.map

package/dist/system/system.error.d.ts

@@ -4,4 +4,3 @@
 export { SystemError, createSystemError, isSystemError, SystemOperation, } from "./systemError.base.js";
 export type { SystemErrorOptions } from "./systemError.base.js";
 export { systemInitializationError, systemStartupError, systemShutdownError, internalSystemError, } from "./systemError.factory.js";
-//# sourceMappingURL=system.error.d.ts.map

package/dist/system/system.error.js

@@ -3,4 +3,3 @@
  */
 export { SystemError, createSystemError, isSystemError, SystemOperation, } from "./systemError.base.js";
 export { systemInitializationError, systemStartupError, systemShutdownError, internalSystemError, } from "./systemError.factory.js";
-//# sourceMappingURL=system.error.js.map

package/dist/system/systemError.base.d.ts

@@ -42,4 +42,3 @@ export declare class SystemError extends BaseError {
 export declare function createSystemError(message?: string, options?: SystemErrorOptions): SystemError;
 /** Determines whether an unknown value is a SystemError. */
 export declare function isSystemError(value: unknown): value is SystemError;
-//# sourceMappingURL=systemError.base.d.ts.map

package/dist/system/systemError.base.js

@@ -51,4 +51,3 @@ export function createSystemError(message = "A system operation failed.", option
 export function isSystemError(value) {
     return value instanceof SystemError;
 }
-//# sourceMappingURL=systemError.base.js.map

package/dist/system/systemError.factory.d.ts

@@ -10,4 +10,3 @@ export declare function systemStartupError(message: string, cause?: unknown): Sy
 export declare function systemShutdownError(message: string, cause?: unknown): SystemError;
 /** Creates an internal system error. */
 export declare function internalSystemError(message: string, cause?: unknown): SystemError;
-//# sourceMappingURL=systemError.factory.d.ts.map

package/dist/system/systemError.factory.js

@@ -39,4 +39,3 @@ export function internalSystemError(message, cause) {
         isOperational: false,
     });
 }
-//# sourceMappingURL=systemError.factory.js.map

package/dist/utils/errorHandler.core.d.ts

@@ -13,6 +13,7 @@ export declare class ErrorHandler {
     private readonly defaultMessage;
     private readonly includeStack;
     private readonly publicMetadataKeys;
+    private readonly exposeMetadata;
     private readonly sensitiveKeyPattern;
     constructor(options?: ErrorHandlerOptions);
     /** Converts an unknown thrown value into a BaseError. */
@@ -61,4 +62,3 @@ export declare class ErrorHandler {
     /** Removes obviously sensitive fields from metadata (recursively). */
     private redact;
 }
-//# sourceMappingURL=errorHandler.core.d.ts.map

package/dist/utils/errorHandler.core.js

@@ -1,9 +1,10 @@
 /**
  * Centralized error normalization, serialization, and reporting service.
  */
-import { pickErrorMetadata, redactErrorMetadata, serializeErrorMetadata, } from "../base/core/errorMetadata.core.js";
+import { redactErrorMetadata, serializeErrorMetadata, } from "../base/core/errorMetadata.core.js";
 import { isBaseError, normalizeUnknownToBaseError, } from "../base/utils/baseError.utils.js";
 import { ErrorSerializer } from "./errorSerializer.core.js";
+import { selectPublicIssues, selectPublicMetadata, } from "./errorSerializer.public.js";
 export { createErrorHandler, normalizeError, isHandledError, } from "./errorHandler.factory.js";
 /** Centralized error normalization, serialization, and reporting service. */
 export class ErrorHandler {
@@ -13,6 +14,7 @@ export class ErrorHandler {
     defaultMessage;
     includeStack;
     publicMetadataKeys;
+    exposeMetadata;
     sensitiveKeyPattern;
     constructor(options = {}) {
         this.reporter = options.reporter;
@@ -22,6 +24,7 @@ export class ErrorHandler {
             options.defaultMessage ?? "An unexpected error occurred.";
         this.includeStack = options.includeStack ?? false;
         this.publicMetadataKeys = options.publicMetadataKeys;
+        this.exposeMetadata = options.exposeMetadata ?? false;
         this.sensitiveKeyPattern = options.sensitiveKeyPattern;
     }
     /** Converts an unknown thrown value into a BaseError. */
@@ -88,13 +91,12 @@ export class ErrorHandler {
      * fields and non-exposed metadata are never revealed.
      */
     toPublicResult(error, context) {
-        let details;
-        if (this.publicMetadataKeys !== undefined) {
-            details = this.redact(pickErrorMetadata(error.metadata, this.publicMetadataKeys));
-        }
-        else if (error.expose) {
-            details = this.redact(error.metadata);
-        }
+        const details = selectPublicMetadata(error, {
+            publicMetadataKeys: this.publicMetadataKeys,
+            exposeMetadata: this.exposeMetadata,
+            sensitiveKeyPattern: this.sensitiveKeyPattern,
+        });
+        const issues = selectPublicIssues(error);
         return {
             code: error.code,
             message: error.expose ? error.message : this.defaultMessage,
@@ -103,9 +105,8 @@ export class ErrorHandler {
             ...(context?.correlationId
                 ? { correlationId: context.correlationId }
                 : {}),
-            ...(details !== undefined && Object.keys(details).length > 0
-                ? { details }
-                : {}),
+            ...(details !== undefined ? { details } : {}),
+            ...(issues !== undefined ? { issues } : {}),
         };
     }
     /** Reports an error without producing a response. */
@@ -174,4 +175,3 @@ export class ErrorHandler {
         });
     }
 }
-//# sourceMappingURL=errorHandler.core.js.map

package/dist/utils/errorHandler.factory.d.ts

@@ -10,4 +10,3 @@ export declare function createErrorHandler(options?: ErrorHandlerOptions): Error
 export declare function normalizeError(value: unknown): BaseError;
 /** Determines whether an unknown value is a supported BaseError. */
 export declare function isHandledError(value: unknown): value is BaseError;
-//# sourceMappingURL=errorHandler.factory.d.ts.map

package/dist/utils/errorHandler.factory.js

@@ -15,4 +15,3 @@ export function normalizeError(value) {
 export function isHandledError(value) {
     return isBaseError(value);
 }
-//# sourceMappingURL=errorHandler.factory.js.map

package/dist/utils/errorHandler.types.d.ts

@@ -46,6 +46,8 @@ export interface PublicErrorHandlerResult {
     readonly correlationId?: string;
     /** Allow-listed, redacted metadata (see `ErrorHandlerOptions.publicMetadataKeys`). */
     readonly details?: Readonly<Record<string, unknown>>;
+    /** Issues of an exposable validation or schema error, values redacted. */
+    readonly issues?: readonly unknown[];
 }
 /** Callback used to report errors to an external logger or monitoring system. */
 export type ErrorReporter = (error: BaseError, context?: ErrorHandlerContext) => void | Promise<void>;
@@ -68,12 +70,17 @@ export interface ErrorHandlerOptions {
      */
     readonly includeStack?: boolean;
     /**
-     * Metadata keys copied into `PublicErrorHandlerResult.details`. When omitted,
-     * exposed errors contribute their (redacted) metadata and non-exposed errors
-     * contribute nothing.
+     * Metadata keys copied into `PublicErrorHandlerResult.details`, for exposed
+     * and non-exposed errors alike. When omitted, no metadata is published
+     * unless `exposeMetadata` is set.
      */
     readonly publicMetadataKeys?: readonly string[];
+    /**
+     * Copy the whole (redacted) metadata of errors with `expose: true` into
+     * `details`. Defaults to false; see `ErrorSerializerOptions.exposeMetadata`
+     * for why this is opt-in. Ignored when `publicMetadataKeys` is set.
+     */
+    readonly exposeMetadata?: boolean;
     /** Pattern used to detect sensitive metadata keys. */
     readonly sensitiveKeyPattern?: RegExp;
 }
-//# sourceMappingURL=errorHandler.types.d.ts.map

package/dist/utils/errorHandler.types.js

@@ -4,4 +4,3 @@
 import { BaseError } from "../base/core/baseError.core.js";
 import { ErrorCategory } from "../base/types/errorCategory.type.js";
 import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
-//# sourceMappingURL=errorHandler.types.js.map

package/dist/utils/errorMapper.core.d.ts

@@ -4,4 +4,3 @@
 export type { ErrorMapperContext, ErrorMapping, ErrorMapperPredicate, ErrorMapper, ErrorMappingRule, } from "./errorMapper.types.js";
 export { ErrorMapperRegistry, createErrorMapperRegistry, } from "./errorMapper.registry.js";
 export { mapNativeError, mapError, mapErrorType, createErrorMappingRule, applyErrorMapping, type ErrorConstructor, } from "./errorMapper.mappers.js";
-//# sourceMappingURL=errorMapper.core.d.ts.map

package/dist/utils/errorMapper.core.js

@@ -3,4 +3,3 @@
  */
 export { ErrorMapperRegistry, createErrorMapperRegistry, } from "./errorMapper.registry.js";
 export { mapNativeError, mapError, mapErrorType, createErrorMappingRule, applyErrorMapping, } from "./errorMapper.mappers.js";
-//# sourceMappingURL=errorMapper.core.js.map

package/dist/utils/errorMapper.mappers.d.ts

@@ -33,4 +33,3 @@ export declare function mapErrorType<T extends Error>(name: string, errorType: E
 export declare function createErrorMappingRule(name: string, predicate: ErrorMapperPredicate, mapper: ErrorMapper | ErrorMapping, priority?: number): ErrorMappingRule;
 /** Builds a BaseError from a declarative `ErrorMapping`. */
 export declare function applyErrorMapping(error: unknown, mapping: ErrorMapping, context?: ErrorMapperContext): BaseError;
-//# sourceMappingURL=errorMapper.mappers.d.ts.map

package/dist/utils/errorMapper.mappers.js

@@ -89,4 +89,3 @@ export function applyErrorMapping(error, mapping, context) {
         },
     });
 }
-//# sourceMappingURL=errorMapper.mappers.js.map

package/dist/utils/errorMapper.registry.d.ts

@@ -23,4 +23,3 @@ export declare class ErrorMapperRegistry {
 }
 /** Creates an error mapper registry. */
 export declare function createErrorMapperRegistry(): ErrorMapperRegistry;
-//# sourceMappingURL=errorMapper.registry.d.ts.map

package/dist/utils/errorMapper.registry.js

@@ -55,4 +55,3 @@ export class ErrorMapperRegistry {
 export function createErrorMapperRegistry() {
     return new ErrorMapperRegistry();
 }
-//# sourceMappingURL=errorMapper.registry.js.map

package/dist/utils/errorMapper.types.d.ts

@@ -33,4 +33,3 @@ export interface ErrorMappingRule {
     readonly mapper: ErrorMapper;
     readonly priority?: number;
 }
-//# sourceMappingURL=errorMapper.types.d.ts.map

package/dist/utils/errorMapper.types.js

@@ -4,4 +4,3 @@
 import { BaseError } from "../base/core/baseError.core.js";
 import { ErrorCategory } from "../base/types/errorCategory.type.js";
 import { ErrorSeverity } from "../base/types/errorSeverity.type.js";
-//# sourceMappingURL=errorMapper.types.js.map

package/dist/utils/errorSerializer.core.d.ts

@@ -14,6 +14,7 @@ export declare class ErrorSerializer {
     private readonly redactSensitiveData;
     private readonly sensitiveKeyPattern;
     private readonly publicMetadataKeys;
+    private readonly exposeMetadata;
     constructor(options?: ErrorSerializerOptions);
     /**
      * Serializes an error for internal logging or monitoring.
@@ -26,9 +27,11 @@ export declare class ErrorSerializer {
     /**
      * Serializes an error for an untrusted API client.
      *
-     * Never includes a stack or cause. Metadata is only included when the error
-     * is exposable (or when `publicMetadataKeys` allow-lists specific keys) and
-     * is always redacted.
+     * Never includes a stack or cause. Metadata is included only for keys
+     * allow-listed by `publicMetadataKeys`, or, with `exposeMetadata`, for
+     * errors with `expose: true`; either way it is redacted. The `issues` of an
+     * exposable validation or schema error are included with submitted values
+     * replaced by type descriptions.
      */
     serializePublic(error: BaseError): PublicErrorResponse;
     /** Serializes an unknown thrown value. */
@@ -51,4 +54,3 @@ export declare class ErrorSerializer {
     /** Removes commonly sensitive metadata fields (recursively). */
     private redactMetadata;
 }
-//# sourceMappingURL=errorSerializer.core.d.ts.map