@zudojs/errors 1.3.1 → 1.4.0

package/dist/infrastructure/network/index.js

@@ -15,4 +15,3 @@ export * from "./httpServerLifecycle.error.js";
 export * from "./httpStream.error.js";
 export * from "./httpResponse.error.js";
 export * from "./routePattern.error.js";
-//# sourceMappingURL=index.js.map

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

@@ -4,4 +4,3 @@
 export { NetworkError, createNetworkError, isNetworkError, } from "./networkError.base.js";
 export type { NetworkErrorOptions } from "./networkError.base.js";
 export { connectionFailedError, networkTimeoutError, networkServiceUnavailableError, } from "./networkError.factory.js";
-//# sourceMappingURL=network.error.d.ts.map

package/dist/infrastructure/network/network.error.js

@@ -3,4 +3,3 @@
  */
 export { NetworkError, createNetworkError, isNetworkError, } from "./networkError.base.js";
 export { connectionFailedError, networkTimeoutError, networkServiceUnavailableError, } from "./networkError.factory.js";
-//# sourceMappingURL=network.error.js.map

package/dist/infrastructure/network/networkError.base.d.ts

@@ -42,4 +42,3 @@ export declare class NetworkError extends BaseError {
 export declare function createNetworkError(message?: string, options?: NetworkErrorOptions): NetworkError;
 /** Determines whether an unknown value is a NetworkError. */
 export declare function isNetworkError(value: unknown): value is NetworkError;
-//# sourceMappingURL=networkError.base.d.ts.map

package/dist/infrastructure/network/networkError.base.js

@@ -59,4 +59,3 @@ export function createNetworkError(message = "A network operation failed.", opti
 export function isNetworkError(value) {
     return value instanceof NetworkError;
 }
-//# sourceMappingURL=networkError.base.js.map

package/dist/infrastructure/network/networkError.factory.d.ts

@@ -15,4 +15,3 @@ export declare function networkTimeoutError(service?: string, options?: Omit<Net
  * the name `networkServiceUnavailableError`.
  */
 export declare function networkServiceUnavailableError(service?: string, options?: Omit<NetworkErrorOptions, "service">): NetworkError;
-//# sourceMappingURL=networkError.factory.d.ts.map

package/dist/infrastructure/network/networkError.factory.js

@@ -41,4 +41,3 @@ export function networkServiceUnavailableError(service, options = {}) {
         service,
     });
 }
-//# sourceMappingURL=networkError.factory.js.map

package/dist/infrastructure/network/routePattern.error.d.ts

@@ -42,4 +42,3 @@ export declare function createRoutePatternError(message: string, options?: Route
  * Determines whether an unknown value is a RoutePatternError.
  */
 export declare function isRoutePatternError(value: unknown): value is RoutePatternError;
-//# sourceMappingURL=routePattern.error.d.ts.map

package/dist/infrastructure/network/routePattern.error.js

@@ -68,4 +68,3 @@ export function createRoutePatternError(message, options = {}) {
 export function isRoutePatternError(value) {
     return value instanceof RoutePatternError;
 }
-//# sourceMappingURL=routePattern.error.js.map

package/dist/infrastructure/network/timeout.error.d.ts

@@ -4,4 +4,3 @@
 export { TimeoutError, createTimeoutError, isTimeoutError, TimeoutOperation, } from "./timeoutError.base.js";
 export type { TimeoutErrorOptions } from "./timeoutError.base.js";
 export { requestTimeoutError, databaseTimeoutError, serviceTimeoutError, lockTimeoutError, } from "./timeoutError.factory.js";
-//# sourceMappingURL=timeout.error.d.ts.map

package/dist/infrastructure/network/timeout.error.js

@@ -3,4 +3,3 @@
  */
 export { TimeoutError, createTimeoutError, isTimeoutError, TimeoutOperation, } from "./timeoutError.base.js";
 export { requestTimeoutError, databaseTimeoutError, serviceTimeoutError, lockTimeoutError, } from "./timeoutError.factory.js";
-//# sourceMappingURL=timeout.error.js.map

package/dist/infrastructure/network/timeoutError.base.d.ts

@@ -58,4 +58,3 @@ export declare function isTimeoutError(value: unknown): value is TimeoutError;
  * resources and stay internal.
  */
 export declare function isPublicTimeoutOperation(operation: TimeoutOperation | undefined): boolean;
-//# sourceMappingURL=timeoutError.base.d.ts.map

package/dist/infrastructure/network/timeoutError.base.js

@@ -85,4 +85,3 @@ function validateTimeout(timeoutMs) {
         throw new RangeError("timeoutMs must be a finite non-negative number.");
     }
 }
-//# sourceMappingURL=timeoutError.base.js.map

package/dist/infrastructure/network/timeoutError.factory.d.ts

@@ -24,4 +24,3 @@ export declare function serviceTimeoutError(target?: string, timeoutMs?: number)
 /** Creates a lock acquisition timeout error. */
 export declare function lockTimeoutError(options?: TimeoutFactoryOptions): TimeoutError;
 export declare function lockTimeoutError(target?: string, timeoutMs?: number): TimeoutError;
-//# sourceMappingURL=timeoutError.factory.d.ts.map

package/dist/infrastructure/network/timeoutError.factory.js

@@ -58,4 +58,3 @@ export function lockTimeoutError(first, second) {
         statusCode: 409,
     });
 }
-//# sourceMappingURL=timeoutError.factory.js.map

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

@@ -4,4 +4,3 @@
 export { ExternalServiceError, createExternalServiceError, isExternalServiceError, } from "./externalServiceError.base.js";
 export type { ExternalServiceErrorOptions } from "./externalServiceError.base.js";
 export { externalServiceTimeoutError, externalServiceUnavailable, externalServiceUnavailableError, } from "./externalServiceError.factory.js";
-//# sourceMappingURL=externalService.error.d.ts.map

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

@@ -3,4 +3,3 @@
  */
 export { ExternalServiceError, createExternalServiceError, isExternalServiceError, } from "./externalServiceError.base.js";
 export { externalServiceTimeoutError, externalServiceUnavailable, externalServiceUnavailableError, } from "./externalServiceError.factory.js";
-//# sourceMappingURL=externalService.error.js.map

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

@@ -13,13 +13,20 @@ export interface ExternalServiceErrorOptions extends Omit<BaseErrorOptions, "cat
     readonly responseStatus?: number;
     readonly serviceCode?: string | number;
 }
-/** Error raised when an external dependency fails. */
+/**
+ * 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 declare class ExternalServiceError extends BaseError {
     readonly service: string;
     readonly operation?: string;
     readonly responseStatus?: number;
     readonly serviceCode?: string | number;
-    constructor(message: string | undefined, options: ExternalServiceErrorOptions);
+    constructor(message?: string, options?: ExternalServiceErrorOptions);
     toJSON(): {
         name: string;
         message: string;
@@ -50,4 +57,3 @@ export declare function isExternalServiceError(value: unknown): value is Externa
  * can back off. Pass an explicit `statusCode` option to override.
  */
 export declare function mapResponseStatus(responseStatus: number | undefined): number;
-//# sourceMappingURL=externalServiceError.base.d.ts.map

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