@zudojs/errors 0.1.0 → 1.0.0

package/dist/domain/body/bodyParser.error.js

@@ -2,6 +2,7 @@ import { BaseError } from "../../base/core/baseError.core.js";
 import { ErrorCode } from "../../base/types/errorCode.type.js";
 import { ErrorCategory } from "../../base/types/errorCategory.type.js";
 import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
+import { MAX_METADATA_FRAGMENT_LENGTH, sanitizeFragment, } from "../shared/domainError.helpers.js";
 /**
  * Base error class for body parser errors.
  */
@@ -11,49 +12,56 @@ export class BodyParserError extends BaseError {
             ...options,
             code: options.code ?? ErrorCode.HTTP_BODY_PARSER,
             category: options.category ?? ErrorCategory.INPUT,
-            severity: options.severity ?? ErrorSeverity.ERROR,
+            severity: options.severity ?? ErrorSeverity.WARNING,
             statusCode: options.statusCode ?? 400,
             expose: options.expose ?? true,
         });
-        this.name = "BodyParserError";
     }
 }
 /**
  * Error thrown when an unsupported body type is encountered.
+ *
+ * Responds with 415 Unsupported Media Type. The header value is untrusted
+ * input: it is stripped of control characters and truncated before being
+ * embedded in the message or metadata.
  */
 export class UnsupportedBodyTypeError extends BodyParserError {
     /**
-     * The unsupported content type.
+     * The unsupported content type (sanitized and truncated).
      */
     contentType;
     constructor(contentType) {
-        super(`Unsupported request content type: ${contentType}`, {
+        const safeContentType = sanitizeFragment(contentType, MAX_METADATA_FRAGMENT_LENGTH);
+        super(`Unsupported request content type: ${sanitizeFragment(contentType)}`, {
             code: ErrorCode.HTTP_UNSUPPORTED_BODY_TYPE,
+            statusCode: 415,
             metadata: {
-                contentType,
+                contentType: safeContentType,
             },
         });
-        this.name = "UnsupportedBodyTypeError";
-        this.contentType = contentType;
+        this.contentType = safeContentType;
     }
 }
 /**
  * Error thrown when the Content-Length header is invalid.
+ *
+ * The header value is untrusted input: it is stripped of control characters
+ * and truncated before being embedded in the message or metadata.
  */
 export class InvalidContentLengthError extends BodyParserError {
     /**
-     * The invalid Content-Length value.
+     * The invalid Content-Length value (sanitized and truncated).
      */
     value;
     constructor(value) {
-        super(`Invalid Content-Length header: ${value}`, {
+        const safeValue = sanitizeFragment(value, MAX_METADATA_FRAGMENT_LENGTH);
+        super(`Invalid Content-Length header: ${sanitizeFragment(value)}`, {
             code: ErrorCode.HTTP_INVALID_CONTENT_LENGTH,
             metadata: {
-                value,
+                value: safeValue,
             },
         });
-        this.name = "InvalidContentLengthError";
-        this.value = value;
+        this.value = safeValue;
     }
 }
 /**

package/dist/domain/body/httpBodyError.base.js

@@ -11,11 +11,10 @@ export class HttpBodyError extends BaseError {
             ...options,
             code: options.code ?? ErrorCode.HTTP_BODY,
             category: options.category ?? ErrorCategory.INPUT,
-            severity: options.severity ?? ErrorSeverity.ERROR,
+            severity: options.severity ?? ErrorSeverity.WARNING,
             statusCode: options.statusCode ?? 400,
             expose: options.expose ?? true,
         });
-        this.name = "HttpBodyError";
     }
 }
 /** Creates an HTTP body error. */

package/dist/domain/body/httpBodyError.types.js

@@ -11,9 +11,9 @@ export class HttpBodyLimitError extends HttpBodyError {
     constructor(limit, received) {
         super("Request body exceeds the configured size limit.", {
             code: ErrorCode.HTTP_BODY_LIMIT,
+            statusCode: 413,
             metadata: { limit, received },
         });
-        this.name = "HttpBodyLimitError";
         this.limit = limit;
         this.received = received;
     }
@@ -27,7 +27,6 @@ export class HttpBodyAbortedError extends HttpBodyError {
             code: ErrorCode.HTTP_BODY_ABORTED,
             statusCode: 408,
         });
-        this.name = "HttpBodyAbortedError";
     }
 }
 /**
@@ -39,7 +38,6 @@ export class HttpBodyParseError extends HttpBodyError {
             code: ErrorCode.HTTP_BODY_PARSE,
             cause,
         });
-        this.name = "HttpBodyParseError";
     }
 }
 //# sourceMappingURL=httpBodyError.types.js.map

package/dist/domain/body/httpFormData.error.js

@@ -11,11 +11,10 @@ export class HttpFormDataError extends BaseError {
             ...options,
             code: options.code ?? ErrorCode.HTTP_FORM_DATA,
             category: options.category ?? ErrorCategory.INPUT,
-            severity: options.severity ?? ErrorSeverity.ERROR,
+            severity: options.severity ?? ErrorSeverity.WARNING,
             statusCode: options.statusCode ?? 400,
             expose: options.expose ?? true,
         });
-        this.name = "HttpFormDataError";
     }
 }
 /**
@@ -25,8 +24,8 @@ export class HttpFormDataLimitError extends HttpFormDataError {
     constructor(message) {
         super(message, {
             code: ErrorCode.HTTP_FORM_DATA_LIMIT,
+            statusCode: 413,
         });
-        this.name = "HttpFormDataLimitError";
     }
 }
 /**
@@ -37,7 +36,6 @@ export class HttpFormDataParseError extends HttpFormDataError {
         super(message, {
             code: ErrorCode.HTTP_FORM_DATA_PARSE,
         });
-        this.name = "HttpFormDataParseError";
     }
 }
 /**

package/dist/domain/body/multipart.error.js

@@ -11,11 +11,10 @@ export class MultipartError extends BaseError {
             ...options,
             code: options.code ?? ErrorCode.HTTP_MULTIPART,
             category: options.category ?? ErrorCategory.INPUT,
-            severity: options.severity ?? ErrorSeverity.ERROR,
+            severity: options.severity ?? ErrorSeverity.WARNING,
             statusCode: options.statusCode ?? 400,
             expose: options.expose ?? true,
         });
-        this.name = "MultipartError";
     }
 }
 /**
@@ -27,7 +26,6 @@ export class MultipartParseError extends MultipartError {
             code: ErrorCode.HTTP_MULTIPART_PARSE,
             cause,
         });
-        this.name = "MultipartParseError";
     }
 }
 /**
@@ -37,8 +35,8 @@ export class MultipartLimitError extends MultipartError {
     constructor(message) {
         super(message, {
             code: ErrorCode.HTTP_MULTIPART_LIMIT,
+            statusCode: 413,
         });
-        this.name = "MultipartLimitError";
     }
 }
 /**

package/dist/domain/documentation/documentationError.base.js

@@ -9,12 +9,14 @@ import { ErrorSeverity } from "../../base/types/errorSeverity.type.js";
 export class DocumentationError extends BaseError {
     documentId;
     constructor(message, options = {}) {
+        const statusCode = options.statusCode ?? 500;
         super(message, {
             ...options,
             code: options.code ?? ErrorCode.DOCUMENTATION_ERROR,
             category: options.category ?? ErrorCategory.DOCUMENTATION,
-            severity: options.severity ?? ErrorSeverity.ERROR,
-            statusCode: options.statusCode ?? 500,
+            severity: options.severity ??
+                (statusCode < 500 ? ErrorSeverity.WARNING : ErrorSeverity.ERROR),
+            statusCode,
             expose: options.expose ?? false,
             isOperational: options.isOperational ?? true,
         });

package/dist/domain/documentation/documentationError.types.js

@@ -13,7 +13,6 @@ export class DocumentParseError extends DocumentationError {
             statusCode: 400,
             expose: true,
         });
-        this.name = "DocumentParseError";
     }
 }
 /** Error thrown when a document fails validation. */
@@ -26,7 +25,6 @@ export class DocumentValidationError extends DocumentationError {
             statusCode: 422,
             expose: true,
         });
-        this.name = "DocumentValidationError";
     }
 }
 /** Error thrown when a duplicate document ID is detected. */
@@ -39,7 +37,6 @@ export class DuplicateDocumentError extends DocumentationError {
             statusCode: 409,
             expose: true,
         });
-        this.name = "DuplicateDocumentError";
     }
 }
 /** Error thrown when a document is not found. */
@@ -52,7 +49,6 @@ export class DocumentNotFoundError extends DocumentationError {
             statusCode: 404,
             expose: true,
         });
-        this.name = "DocumentNotFoundError";
     }
 }
 /** Error thrown when a documentation link is broken. */
@@ -63,11 +59,10 @@ export class BrokenDocumentationLinkError extends DocumentationError {
             ...options,
             code: ErrorCode.DOCUMENT_LINK_BROKEN,
             documentId: source,
-            metadata: { source, target },
+            metadata: { ...options.metadata, source, target },
             statusCode: 400,
             expose: true,
         });
-        this.name = "BrokenDocumentationLinkError";
         this.target = target;
     }
 }
@@ -81,7 +76,6 @@ export class InvalidFrontmatterError extends DocumentationError {
             statusCode: 400,
             expose: true,
         });
-        this.name = "InvalidFrontmatterError";
     }
 }
 /** Error thrown when navigation is invalid. */
@@ -93,7 +87,6 @@ export class InvalidNavigationError extends DocumentationError {
             statusCode: 400,
             expose: true,
         });
-        this.name = "InvalidNavigationError";
     }
 }
 /** Error thrown when a documentation example fails validation. */
@@ -106,7 +99,6 @@ export class ExampleValidationError extends DocumentationError {
             statusCode: 422,
             expose: true,
         });
-        this.name = "ExampleValidationError";
     }
 }
 /** Error thrown when documentation generation fails. */
@@ -118,7 +110,6 @@ export class GenerationError extends DocumentationError {
             statusCode: 500,
             expose: false,
         });
-        this.name = "GenerationError";
     }
 }
 /** Error thrown when a documentation version operation fails. */
@@ -130,7 +121,6 @@ export class DocumentationVersionError extends DocumentationError {
             statusCode: 400,
             expose: true,
         });
-        this.name = "DocumentationVersionError";
     }
 }
 //# sourceMappingURL=documentationError.types.js.map

package/dist/domain/documentation/index.d.ts

@@ -3,6 +3,6 @@
  *
  * Documentation-specific error types.
  */
-export { DocumentationError, DocumentParseError, DocumentValidationError, DuplicateDocumentError, DocumentNotFoundError, BrokenDocumentationLinkError, InvalidFrontmatterError, InvalidNavigationError, ExampleValidationError, GenerationError, DocumentationVersionError, } from "./documentation.error.js";
+export { DocumentationError, DocumentParseError, DocumentValidationError, DuplicateDocumentError, DocumentNotFoundError, BrokenDocumentationLinkError, InvalidFrontmatterError, InvalidNavigationError, ExampleValidationError, GenerationError, DocumentationVersionError, createDocumentationError, isDocumentationError, } from "./documentation.error.js";
 export type { DocumentationErrorOptions } from "./documentation.error.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/domain/documentation/index.js

@@ -3,5 +3,5 @@
  *
  * Documentation-specific error types.
  */
-export { DocumentationError, DocumentParseError, DocumentValidationError, DuplicateDocumentError, DocumentNotFoundError, BrokenDocumentationLinkError, InvalidFrontmatterError, InvalidNavigationError, ExampleValidationError, GenerationError, DocumentationVersionError, } from "./documentation.error.js";
+export { DocumentationError, DocumentParseError, DocumentValidationError, DuplicateDocumentError, DocumentNotFoundError, BrokenDocumentationLinkError, InvalidFrontmatterError, InvalidNavigationError, ExampleValidationError, GenerationError, DocumentationVersionError, createDocumentationError, isDocumentationError, } from "./documentation.error.js";
 //# sourceMappingURL=index.js.map

package/dist/domain/event/event.error.d.ts

@@ -4,6 +4,6 @@
 export { EventError, createEventError, isEventError, toEventError, } from "./eventError.base.js";
 export type { EventErrorOptions } from "./eventError.base.js";
 export { EventHandlerError, createEventHandlerError, EventHandlerNotFoundError, DuplicateEventHandlerError, EventMiddlewareError, } from "./eventError.handler.js";
-export { EventPublishError, InvalidEventError, EventTypeNotFoundError, DuplicateEventDefinitionError, EventDefinitionNotFoundError, EventDispatchAbortedError, EventEmitterDisposedError, EventRegistryDisposedError, EventSubscriptionClosedError, EventTimeoutError, } from "./eventError.lifecycle.js";
+export { EventPublishError, InvalidEventError, EventTypeNotFoundError, DuplicateEventDefinitionError, EventDefinitionNotFoundError, EventDispatchAbortedError, EventEmitterDisposedError, EventRegistryDisposedError, EventSubscriptionClosedError, EventBusDisposedError, EventTimeoutError, } from "./eventError.lifecycle.js";
 export { EventSerializationError, EventDeserializationError, } from "./eventError.serialization.js";
 //# sourceMappingURL=event.error.d.ts.map

package/dist/domain/event/event.error.js

@@ -3,6 +3,6 @@
  */
 export { EventError, createEventError, isEventError, toEventError, } from "./eventError.base.js";
 export { EventHandlerError, createEventHandlerError, EventHandlerNotFoundError, DuplicateEventHandlerError, EventMiddlewareError, } from "./eventError.handler.js";
-export { EventPublishError, InvalidEventError, EventTypeNotFoundError, DuplicateEventDefinitionError, EventDefinitionNotFoundError, EventDispatchAbortedError, EventEmitterDisposedError, EventRegistryDisposedError, EventSubscriptionClosedError, EventTimeoutError, } from "./eventError.lifecycle.js";
+export { EventPublishError, InvalidEventError, EventTypeNotFoundError, DuplicateEventDefinitionError, EventDefinitionNotFoundError, EventDispatchAbortedError, EventEmitterDisposedError, EventRegistryDisposedError, EventSubscriptionClosedError, EventBusDisposedError, EventTimeoutError, } from "./eventError.lifecycle.js";
 export { EventSerializationError, EventDeserializationError, } from "./eventError.serialization.js";
 //# sourceMappingURL=event.error.js.map

package/dist/domain/event/eventError.base.d.ts

@@ -4,6 +4,7 @@
 import { BaseError } from "../../base/core/baseError.core.js";
 import type { BaseErrorOptions } from "../../base/types/baseError.type.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";
 /** Options for creating an event error. */
 export interface EventErrorOptions extends Omit<BaseErrorOptions, "category"> {
@@ -18,6 +19,7 @@ export declare class EventError extends BaseError {
     readonly eventType?: string;
     readonly eventId?: string;
     readonly handlerId?: string;
+    readonly middlewareId?: string;
     constructor(message: string, options?: EventErrorOptions);
     toJSON(): {
         name: string;
@@ -34,6 +36,7 @@ export declare class EventError extends BaseError {
         eventType?: string | undefined;
         eventId?: string | undefined;
         handlerId?: string | undefined;
+        middlewareId?: string | undefined;
     };
 }
 /** Creates an event error. */
@@ -45,6 +48,6 @@ export declare function toEventError(error: unknown, options?: {
     message?: string;
     eventType?: string;
     eventId?: string;
-    code?: string;
+    code?: ErrorCode | string;
 }): EventError;
 //# sourceMappingURL=eventError.base.d.ts.map

package/dist/domain/event/eventError.base.js

@@ -5,11 +5,13 @@ 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";
+import { safeErrorMessage } from "../shared/domainError.helpers.js";
 /** Base error for all event subsystem failures. */
 export class EventError extends BaseError {
     eventType;
     eventId;
     handlerId;
+    middlewareId;
     constructor(message, options = {}) {
         super(message, {
             ...options,
@@ -23,6 +25,7 @@ export class EventError extends BaseError {
         this.eventType = options.eventType;
         this.eventId = options.eventId;
         this.handlerId = options.handlerId;
+        this.middlewareId = options.middlewareId;
     }
     toJSON() {
         return {
@@ -30,6 +33,9 @@ export class EventError extends BaseError {
             ...(this.eventType !== undefined ? { eventType: this.eventType } : {}),
             ...(this.eventId !== undefined ? { eventId: this.eventId } : {}),
             ...(this.handlerId !== undefined ? { handlerId: this.handlerId } : {}),
+            ...(this.middlewareId !== undefined
+                ? { middlewareId: this.middlewareId }
+                : {}),
         };
     }
 }
@@ -46,15 +52,7 @@ export function toEventError(error, options = {}) {
     if (error instanceof EventError) {
         return error;
     }
-    if (error instanceof Error) {
-        return new EventError(options.message ?? error.message, {
-            code: options.code,
-            eventType: options.eventType,
-            eventId: options.eventId,
-            cause: error,
-        });
-    }
-    return new EventError(options.message ?? String(error), {
+    return new EventError(options.message ?? safeErrorMessage(error), {
         code: options.code,
         eventType: options.eventType,
         eventId: options.eventId,

package/dist/domain/event/eventError.handler.d.ts

@@ -13,17 +13,26 @@ export declare class EventHandlerError extends EventError {
 }
 /** Creates an event handler error from an unknown failure. */
 export declare function createEventHandlerError(handlerId: string, eventType: string, eventId: string, cause: unknown): EventHandlerError;
-/** Error thrown when an event handler cannot be found. */
+/**
+ * Error thrown when an event handler cannot be found.
+ *
+ * Handler registration is a server-side concern, so this is an internal
+ * (non-exposed, non-operational) failure.
+ */
 export declare class EventHandlerNotFoundError extends EventError {
     constructor(handlerId: string);
 }
-/** Error thrown when an event handler is already registered. */
+/**
+ * Error thrown when an event handler is already registered.
+ *
+ * Handler registration is a server-side concern, so this is an internal
+ * (non-exposed, non-operational) failure.
+ */
 export declare class DuplicateEventHandlerError extends EventError {
     constructor(handlerId: string);
 }
 /** Error thrown when event middleware fails. */
 export declare class EventMiddlewareError extends EventError {
-    readonly middlewareId?: string;
     constructor(message: string, options?: {
         middlewareId?: string;
         eventType?: string;

package/dist/domain/event/eventError.handler.js

@@ -19,40 +19,50 @@ export class EventHandlerError extends EventError {
 export function createEventHandlerError(handlerId, eventType, eventId, cause) {
     return new EventHandlerError(`Event handler "${handlerId}" failed while processing "${eventType}".`, { handlerId, eventType, eventId, cause });
 }
-/** Error thrown when an event handler cannot be found. */
+/**
+ * Error thrown when an event handler cannot be found.
+ *
+ * Handler registration is a server-side concern, so this is an internal
+ * (non-exposed, non-operational) failure.
+ */
 export class EventHandlerNotFoundError extends EventError {
     constructor(handlerId) {
         super(`Event handler "${handlerId}" was not found.`, {
-            code: ErrorCode.RESOURCE_NOT_FOUND,
+            code: ErrorCode.EVENT_HANDLER_NOT_FOUND,
             handlerId,
-            statusCode: 404,
-            expose: true,
+            statusCode: 500,
+            expose: false,
+            isOperational: false,
         });
     }
 }
-/** Error thrown when an event handler is already registered. */
+/**
+ * Error thrown when an event handler is already registered.
+ *
+ * Handler registration is a server-side concern, so this is an internal
+ * (non-exposed, non-operational) failure.
+ */
 export class DuplicateEventHandlerError extends EventError {
     constructor(handlerId) {
         super(`Event handler "${handlerId}" is already registered.`, {
-            code: ErrorCode.CONFLICT,
+            code: ErrorCode.EVENT_DUPLICATE_HANDLER,
             handlerId,
-            statusCode: 409,
-            expose: true,
+            statusCode: 500,
+            expose: false,
+            isOperational: false,
         });
     }
 }
 /** Error thrown when event middleware fails. */
 export class EventMiddlewareError extends EventError {
-    middlewareId;
     constructor(message, options = {}) {
         super(message, {
-            code: ErrorCode.MIDDLEWARE_EXECUTION,
+            code: ErrorCode.EVENT_MIDDLEWARE_FAILED,
             middlewareId: options.middlewareId,
             eventType: options.eventType,
             eventId: options.eventId,
             cause: options.cause,
         });
-        this.middlewareId = options.middlewareId;
     }
 }
 //# sourceMappingURL=eventError.handler.js.map

package/dist/domain/event/eventError.lifecycle.d.ts

@@ -14,15 +14,27 @@ export declare class InvalidEventError extends EventError {
         cause?: unknown;
     });
 }
-/** Error thrown when an event type is not registered. */
+/**
+ * Error thrown when an event type is not registered.
+ *
+ * Event registration is a server-side concern; reported as internal.
+ */
 export declare class EventTypeNotFoundError extends EventError {
     constructor(eventType: string);
 }
-/** Error thrown when an event definition is duplicated. */
+/**
+ * Error thrown when an event definition is duplicated.
+ *
+ * Event registration is a server-side concern; reported as internal.
+ */
 export declare class DuplicateEventDefinitionError extends EventError {
     constructor(eventType: string);
 }
-/** Error thrown when an event definition is missing. */
+/**
+ * Error thrown when an event definition is missing.
+ *
+ * Event registration is a server-side concern; reported as internal.
+ */
 export declare class EventDefinitionNotFoundError extends EventError {
     constructor(eventType: string);
 }
@@ -43,8 +55,13 @@ export declare class EventRegistryDisposedError extends EventError {
 }
 /** Error thrown when an event subscription has been closed. */
 export declare class EventSubscriptionClosedError extends EventError {
+    readonly subscriptionId: string;
     constructor(subscriptionId: string);
 }
+/** Error thrown when an operation is attempted on a disposed event bus. */
+export declare class EventBusDisposedError extends EventError {
+    constructor();
+}
 /** Error thrown when an event operation times out. */
 export declare class EventTimeoutError extends EventError {
     readonly timeoutMs: number;