@cosmneo/onion-lasagna 0.2.0 → 0.3.0

package/dist/events/server/index.d.ts

@@ -0,0 +1,281 @@
+import { E as EventHandlerDefinition, c as EventRouterConfig, f as EventRouterKeys, e as EventRouterDefinition, G as GetEventHandler } from '../../event-router-definition.type-D8CG-kjZ.js';
+import { E as EventResult } from '../../types-cke61juH.js';
+export { U as UseCasePort } from '../../types-B6Q1iCgf.js';
+import '../../http/schema/types.js';
+import '../../router-definition.type-DxG8ncJZ.js';
+
+/**
+ * @fileoverview Server types for the event handler system.
+ *
+ * @module events/server/types
+ */
+
+/**
+ * Event metadata provided by the messaging system.
+ */
+interface EventMetadata {
+    /** Unique event identifier for idempotency checks. */
+    readonly eventId: string;
+    /** ISO 8601 timestamp of when the event occurred. */
+    readonly timestamp: string;
+    /** Correlation ID for distributed tracing. */
+    readonly correlationId?: string;
+    /** Source system or bounded context that emitted the event. */
+    readonly source?: string;
+    /** Number of delivery attempts (1-based). */
+    readonly attemptCount?: number;
+    /** Additional metadata from the messaging system. */
+    readonly [key: string]: unknown;
+}
+/**
+ * Raw event from the messaging system.
+ * This is the input to event handlers before validation.
+ */
+interface RawEvent {
+    /** Event type string for routing. */
+    readonly type: string;
+    /** Event payload (unvalidated). */
+    readonly payload: unknown;
+    /** Event metadata from the messaging system. */
+    readonly metadata: EventMetadata;
+}
+/**
+ * A validated event with typed payload.
+ * This is what handlers receive after validation passes.
+ */
+interface ValidatedEvent<THandler extends EventHandlerDefinition> {
+    /** Validated event payload. */
+    readonly payload: THandler['_types']['payload'];
+    /** Raw event object for advanced use cases. */
+    readonly raw: RawEvent;
+}
+/**
+ * Typed event context based on handler definition.
+ * If the handler defines a context schema, this will be the validated type.
+ * Otherwise, it falls back to the generic EventMetadata.
+ */
+type TypedEventContext<THandler extends EventHandlerDefinition> = THandler['_types']['context'] extends undefined ? EventMetadata : THandler['_types']['context'];
+/**
+ * Handler configuration using the use case pattern.
+ *
+ * @typeParam THandler - The event handler definition type
+ * @typeParam TInput - Use case input type
+ * @typeParam TOutput - Use case output type
+ */
+interface EventHandlerConfig<THandler extends EventHandlerDefinition, TInput = void, TOutput = void> {
+    /**
+     * Maps the validated event payload to use case input.
+     * Both `event` and `ctx` are fully typed based on handler schemas.
+     */
+    readonly payloadMapper: (event: ValidatedEvent<THandler>, ctx: TypedEventContext<THandler>) => TInput;
+    /** The use case to execute. */
+    readonly useCase: {
+        execute(input?: TInput): Promise<TOutput>;
+    };
+    /**
+     * Maps the use case output to an EventResult.
+     * If omitted, defaults to `{ outcome: 'ack' }`.
+     */
+    readonly resultMapper?: (output: TOutput) => EventResult;
+    /** Middleware to run before the handler. */
+    readonly middleware?: readonly EventMiddlewareFunction[];
+}
+/**
+ * Simple handler function that directly returns an EventResult.
+ */
+type SimpleEventHandlerFn<THandler extends EventHandlerDefinition> = (event: ValidatedEvent<THandler>, ctx: TypedEventContext<THandler>) => Promise<EventResult> | EventResult;
+/**
+ * Configuration for a simple handler (no use case).
+ */
+interface SimpleEventHandlerConfig<THandler extends EventHandlerDefinition> {
+    readonly handler: SimpleEventHandlerFn<THandler>;
+    readonly middleware?: readonly EventMiddlewareFunction[];
+}
+/**
+ * Union of all event handler config types.
+ * Used internally to store handlers in the builder.
+ */
+type AnyEventHandlerConfig<THandler extends EventHandlerDefinition, TInput = unknown, TOutput = unknown> = EventHandlerConfig<THandler, TInput, TOutput> | SimpleEventHandlerConfig<THandler>;
+/**
+ * Type guard to check if config is a simple event handler.
+ */
+declare function isSimpleEventHandlerConfig(config: AnyEventHandlerConfig<EventHandlerDefinition, unknown, unknown>): config is SimpleEventHandlerConfig<EventHandlerDefinition>;
+/**
+ * Event middleware function type.
+ */
+type EventMiddlewareFunction = (event: RawEvent, next: () => Promise<EventResult>) => Promise<EventResult>;
+/**
+ * Configuration mapping handler keys to handler configs.
+ */
+type EventRoutesConfig<T extends EventRouterConfig> = Record<EventRouterKeys<T>, EventHandlerConfig<any, any, any>>;
+/**
+ * Options for creating event routes.
+ */
+interface CreateEventRoutesOptions {
+    /** Global middleware to run before all handlers. */
+    readonly middleware?: readonly EventMiddlewareFunction[];
+    /**
+     * Whether to validate incoming event payloads against handler schemas.
+     * When enabled, invalid payloads result in a `dlq` outcome.
+     * @default true
+     */
+    readonly validatePayload?: boolean;
+    /**
+     * Custom error mapper to override default error-to-EventResult mapping.
+     * If not provided, uses the built-in `mapErrorToEventResult`.
+     */
+    readonly errorMapper?: (error: unknown) => EventResult;
+    /**
+     * Allow partial handler configuration (not all handlers need to be wired).
+     * @default false
+     * @internal Used by builder pattern's buildPartial()
+     */
+    readonly allowPartial?: boolean;
+}
+/**
+ * Event input compatible with messaging adapters.
+ * This is the output of eventRoutes().build().
+ */
+interface UnifiedEventInput {
+    /** Event type string for routing. */
+    readonly eventType: string;
+    /** Handler function. */
+    readonly handler: (rawEvent: RawEvent) => Promise<EventResult>;
+    /** Handler metadata for documentation. */
+    readonly metadata: {
+        readonly handlerId?: string;
+        readonly summary?: string;
+        readonly description?: string;
+        readonly tags?: readonly string[];
+        readonly deprecated?: boolean;
+    };
+}
+
+/**
+ * @fileoverview Builder pattern for creating type-safe event routes.
+ *
+ * The `eventRoutes` function returns a builder that provides 100% type inference
+ * for all handler parameters — no manual type annotations required.
+ *
+ * @module events/server/event-routes-builder
+ */
+
+/**
+ * Error type displayed when attempting to build() with missing handlers.
+ * The `___missingHandlers` property shows which handlers are missing.
+ */
+interface MissingHandlersError<TMissing extends string> {
+    /**
+     * This error indicates that not all event handlers have been wired.
+     * Use buildPartial() to build with only the defined handlers,
+     * or add handlers for the missing events.
+     */
+    (options?: never): never;
+    /** Event handlers that are missing. */
+    readonly ___missingHandlers: TMissing;
+}
+/**
+ * Handler configuration for the builder pattern.
+ */
+interface BuilderEventHandlerConfig<THandler extends EventHandlerDefinition, TInput, TOutput> {
+    /**
+     * Maps the validated event payload to use case input.
+     * Both `event` and `ctx` are fully typed based on handler schemas.
+     */
+    readonly payloadMapper: (event: ValidatedEvent<THandler>, ctx: TypedEventContext<THandler>) => TInput;
+    /** The use case to execute. */
+    readonly useCase: {
+        execute(input?: TInput): Promise<TOutput>;
+    };
+    /**
+     * Maps the use case output to an EventResult.
+     * If omitted, defaults to `{ outcome: 'ack' }`.
+     */
+    readonly resultMapper?: (output: TOutput) => EventResult;
+    /** Middleware to run before the handler. */
+    readonly middleware?: readonly EventMiddlewareFunction[];
+}
+/**
+ * Builder interface for creating type-safe event routes.
+ *
+ * Each `.handle()` call captures the specific handler type and provides
+ * full type inference for payloadMapper and useCase.
+ *
+ * @typeParam T - The event router configuration type
+ * @typeParam THandled - Union of handler keys that have been wired (accumulates)
+ *
+ * @example
+ * ```typescript
+ * const routes = eventRoutes(ticketEvents)
+ *   .handleWithUseCase('created', {
+ *     payloadMapper: (event, ctx) => ({
+ *       ticketId: event.payload.ticketId,  // Fully typed!
+ *       correlationId: ctx.correlationId,  // Fully typed!
+ *     }),
+ *     useCase: sendNotificationUseCase,
+ *   })
+ *   .handle('assigned', async (event) => {
+ *     await notifyAssignee(event.payload);
+ *     return { outcome: 'ack' as const };
+ *   })
+ *   .build();
+ * ```
+ */
+interface EventRoutesBuilder<T extends EventRouterConfig, THandled extends string = never> {
+    /**
+     * Register a simple handler for an event.
+     * The handler receives validated event and context, returns EventResult directly.
+     */
+    handle<K extends Exclude<EventRouterKeys<T>, THandled>>(key: K, handlerOrConfig: SimpleEventHandlerFn<GetEventHandler<T, K>> | SimpleEventHandlerConfig<GetEventHandler<T, K>>): EventRoutesBuilder<T, THandled | K>;
+    /**
+     * Register a handler using the use case pattern.
+     * Follows: payloadMapper → useCase.execute() → resultMapper (or ack)
+     */
+    handleWithUseCase<K extends Exclude<EventRouterKeys<T>, THandled>, TInput, TOutput>(key: K, config: BuilderEventHandlerConfig<GetEventHandler<T, K>, TInput, TOutput>): EventRoutesBuilder<T, THandled | K>;
+    /**
+     * Build the event routes array for messaging adapter registration.
+     *
+     * This method is only available when ALL handlers have been wired.
+     * If some handlers are missing, use `buildPartial()` instead.
+     */
+    build: [Exclude<EventRouterKeys<T>, THandled>] extends [never] ? (options?: CreateEventRoutesOptions) => UnifiedEventInput[] : MissingHandlersError<Exclude<EventRouterKeys<T>, THandled>>;
+    /**
+     * Build event routes for only the defined handlers.
+     * No compile-time enforcement of completeness.
+     */
+    buildPartial(options?: CreateEventRoutesOptions): UnifiedEventInput[];
+}
+/**
+ * Creates a type-safe event routes builder for an event router.
+ *
+ * The builder pattern provides 100% type inference for all handler parameters:
+ * - `event.payload` is typed from the handler's payload schema
+ * - `ctx` is typed from the handler's context schema (or EventMetadata)
+ * - `output` in resultMapper is typed from the use case
+ *
+ * @param router - Event router definition or event router config
+ * @returns Builder for registering handlers
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { eventRoutes } from '@cosmneo/onion-lasagna/events/server';
+ * import { ticketEvents } from './router';
+ *
+ * const routes = eventRoutes(ticketEvents)
+ *   .handleWithUseCase('created', {
+ *     payloadMapper: (event, ctx) => ({
+ *       ticketId: event.payload.ticketId,
+ *       correlationId: ctx.correlationId,
+ *     }),
+ *     useCase: sendNotificationUseCase,
+ *   })
+ *   .handle('assigned', async (event) => {
+ *     await notifyAssignee(event.payload);
+ *     return { outcome: 'ack' as const };
+ *   })
+ *   .build();
+ * ```
+ */
+declare function eventRoutes<T extends EventRouterConfig>(router: T | EventRouterDefinition<T>): EventRoutesBuilder<T, never>;
+
+export { type AnyEventHandlerConfig, type BuilderEventHandlerConfig, type CreateEventRoutesOptions, type EventHandlerConfig, type EventMetadata, type EventMiddlewareFunction, type EventRoutesBuilder, type EventRoutesConfig, type MissingHandlersError, type RawEvent, type SimpleEventHandlerConfig, type SimpleEventHandlerFn, type TypedEventContext, type UnifiedEventInput, type ValidatedEvent, eventRoutes, isSimpleEventHandlerConfig };

package/dist/events/server/index.js

@@ -0,0 +1,16 @@
+import {
+  eventRoutes,
+  isSimpleEventHandlerConfig
+} from "../../chunk-XWKHOLIP.js";
+import "../../chunk-4BVOLXDJ.js";
+import "../../chunk-CBTICRSM.js";
+import "../../chunk-H5TNDC5U.js";
+import "../../chunk-2BVCU32G.js";
+import "../../chunk-T7S574XQ.js";
+import "../../chunk-3BY5RBF2.js";
+import "../../chunk-A4JUAZK4.js";
+export {
+  eventRoutes,
+  isSimpleEventHandlerConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/events/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/events/shared/index.cjs

@@ -0,0 +1,85 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/presentation/events/shared/index.ts
+var shared_exports = {};
+__export(shared_exports, {
+  mapErrorToEventResult: () => mapErrorToEventResult
+});
+module.exports = __toCommonJS(shared_exports);
+
+// src/presentation/http/shared/error-mapping.ts
+function isErrorType(error, typeName) {
+  if (!error || typeof error !== "object") return false;
+  const constructor = Object.prototype.hasOwnProperty.call(error, "constructor") ? error.constructor : Object.getPrototypeOf(error)?.constructor;
+  if (!constructor) return false;
+  const name = constructor.name;
+  return name === typeName || name === `_${typeName}`;
+}
+
+// src/presentation/events/shared/error-mapping.ts
+var DLQ_ERROR_TYPES = [
+  "ObjectValidationError",
+  "InvalidRequestError",
+  "UseCaseError",
+  "DomainError",
+  "UnprocessableError",
+  "AccessDeniedError",
+  "ForbiddenError",
+  "UnauthorizedError",
+  "InvariantViolationError"
+];
+var RETRY_ERROR_TYPES = [
+  "NotFoundError",
+  "ConflictError",
+  "InfraError",
+  "DbError",
+  "NetworkError",
+  "TimeoutError",
+  "ExternalServiceError",
+  "PersistenceError"
+];
+function mapErrorToEventResult(error) {
+  for (const typeName of DLQ_ERROR_TYPES) {
+    if (isErrorType(error, typeName)) {
+      return {
+        outcome: "dlq",
+        reason: error.message
+      };
+    }
+  }
+  for (const typeName of RETRY_ERROR_TYPES) {
+    if (isErrorType(error, typeName)) {
+      return {
+        outcome: "retry",
+        reason: error.message
+      };
+    }
+  }
+  const message = error instanceof Error ? error.message : "Unknown error occurred during event processing";
+  return {
+    outcome: "retry",
+    reason: message
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  mapErrorToEventResult
+});
+//# sourceMappingURL=index.cjs.map

package/dist/events/shared/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/presentation/events/shared/index.ts","../../../src/presentation/http/shared/error-mapping.ts","../../../src/presentation/events/shared/error-mapping.ts"],"sourcesContent":["export type { EventResult } from './types';\nexport { mapErrorToEventResult } from './error-mapping';\n","/**\n * @fileoverview Centralized error mapping for HTTP frameworks.\n *\n * Provides a single source of truth for mapping onion-lasagna errors\n * to HTTP status codes and response bodies.\n *\n * @module http/shared/error-mapping\n */\n\nimport { CodedError } from '../../../global/exceptions/coded-error.error';\nimport { ObjectValidationError } from '../../../global/exceptions/object-validation.error';\nimport { DomainError } from '../../../domain/exceptions/domain.error';\nimport { UseCaseError } from '../../../app/exceptions/use-case.error';\nimport { NotFoundError } from '../../../app/exceptions/not-found.error';\nimport { ConflictError } from '../../../app/exceptions/conflict.error';\nimport { UnprocessableError } from '../../../app/exceptions/unprocessable.error';\nimport { ForbiddenError } from '../../../app/exceptions/forbidden.error';\nimport { UnauthorizedError } from '../../../app/exceptions/unauthorized.error';\nimport { InfraError } from '../../../infra/exceptions/infra.error';\nimport { ControllerError } from '../../exceptions/controller.error';\nimport { AccessDeniedError } from '../../exceptions/access-denied.error';\nimport { InvalidRequestError } from '../../exceptions/invalid-request.error';\nimport type { ErrorResponseBody, MappedErrorResponse } from './types';\n\n// ============================================================================\n// Constants and Interfaces\n// ============================================================================\n\n/**\n * Default masked error response for internal errors.\n */\nconst MASKED_ERROR_BODY: ErrorResponseBody = {\n  message: 'An unexpected error occurred',\n  errorCode: 'INTERNAL_ERROR',\n};\n\n/**\n * Known internal error type names that should be masked.\n */\nconst INTERNAL_ERROR_TYPES = [\n  'DomainError',\n  'InfraError',\n  'ControllerError',\n  'NetworkError',\n  'PersistenceError',\n  'ExternalServiceError',\n  'InvariantViolationError',\n];\n\n/**\n * Validation error item structure.\n */\ninterface ValidationErrorInput {\n  field: string;\n  message: string;\n}\n\n/**\n * Validation error structure for string-based checking.\n */\ninterface ValidationErrorItem {\n  field: string;\n  message: string;\n}\n\n/**\n * Interface for errors with validation items.\n */\ninterface ErrorWithValidation {\n  message: string;\n  code: string;\n  validationErrors: ValidationErrorItem[];\n}\n\n/**\n * Interface for coded errors.\n */\ninterface CodedErrorLike {\n  message: string;\n  code: string;\n}\n\n// ============================================================================\n// String-based type checking helpers (for bundled code compatibility)\n// ============================================================================\n\n/**\n * Checks if error matches a specific error type by checking its constructor name.\n * This approach avoids issues with multiple class instances in bundled code.\n * Handles both original names and tsup's mangled names (prefixed with _).\n *\n * @param error - The error to check\n * @param typeName - The error type name to match\n * @returns True if error matches the type name\n */\nexport function isErrorType(error: unknown, typeName: string): error is CodedErrorLike {\n  if (!error || typeof error !== 'object') return false;\n  // Guard against objects without constructor (e.g., Object.create(null))\n  const constructor = Object.prototype.hasOwnProperty.call(error, 'constructor')\n    ? (error as { constructor?: { name?: string } }).constructor\n    : Object.getPrototypeOf(error)?.constructor;\n  if (!constructor) return false;\n  const name = constructor.name;\n  // Check both the original name and the mangled name (tsup prefixes with _)\n  return name === typeName || name === `_${typeName}`;\n}\n\n/**\n * Checks if error has validation errors array.\n *\n * @param error - The error to check\n * @returns True if error has validationErrors property\n */\nexport function hasValidationErrors(error: unknown): error is ErrorWithValidation {\n  if (!error || typeof error !== 'object') return false;\n  return (\n    'validationErrors' in error && Array.isArray((error as ErrorWithValidation).validationErrors)\n  );\n}\n\n// ============================================================================\n// Response body builders\n// ============================================================================\n\n/**\n * Builds a validation error response body from error details.\n *\n * @param message - The error message\n * @param code - The error code\n * @param validationErrors - Array of field validation errors\n * @returns Error response body with errorItems\n */\nfunction buildValidationErrorBody(\n  message: string,\n  code: string,\n  validationErrors: readonly ValidationErrorInput[],\n): ErrorResponseBody {\n  return {\n    message,\n    errorCode: code,\n    errorItems: validationErrors.map((e) => ({\n      item: e.field,\n      message: e.message,\n    })),\n  };\n}\n\n/**\n * Builds a simple error response body from error details.\n *\n * @param message - The error message\n * @param code - The error code\n * @returns Error response body\n */\nfunction buildSimpleErrorBody(message: string, code: string): ErrorResponseBody {\n  return {\n    message,\n    errorCode: code,\n  };\n}\n\n// ============================================================================\n// Primary error mapping functions (with bundled code fallback)\n// ============================================================================\n\n/**\n * Maps an error to the appropriate HTTP status code.\n * Uses instanceof first, then falls back to name-based checking for bundled code.\n *\n * @param error - The error to map\n * @returns HTTP status code\n */\nexport function getHttpStatusCode(error: unknown): number {\n  // Try instanceof first (faster)\n  if (error instanceof ObjectValidationError) return 400;\n  if (error instanceof InvalidRequestError) return 400;\n  if (error instanceof UnauthorizedError) return 401;\n  if (error instanceof ForbiddenError) return 403;\n  if (error instanceof AccessDeniedError) return 403;\n  if (error instanceof NotFoundError) return 404;\n  if (error instanceof ConflictError) return 409;\n  if (error instanceof UnprocessableError) return 422;\n  if (error instanceof UseCaseError) return 400;\n\n  // Fall back to name-based checking for bundled code (e.g., _NotFoundError)\n  if (isErrorType(error, 'ObjectValidationError')) return 400;\n  if (isErrorType(error, 'InvalidRequestError')) return 400;\n  if (isErrorType(error, 'UnauthorizedError')) return 401;\n  if (isErrorType(error, 'ForbiddenError')) return 403;\n  if (isErrorType(error, 'AccessDeniedError')) return 403;\n  if (isErrorType(error, 'NotFoundError')) return 404;\n  if (isErrorType(error, 'ConflictError')) return 409;\n  if (isErrorType(error, 'UnprocessableError')) return 422;\n  if (isErrorType(error, 'UseCaseError')) return 400;\n\n  return 500;\n}\n\n/**\n * Checks if an error should have its details masked in the response.\n *\n * Security-sensitive errors (domain, infrastructure, controller) are masked\n * to prevent leaking implementation details.\n * Uses instanceof first, then falls back to name-based checking for bundled code.\n *\n * @param error - The error to check\n * @returns True if error details should be hidden\n */\nexport function shouldMaskError(error: unknown): boolean {\n  // Try instanceof first (faster)\n  if (\n    error instanceof DomainError ||\n    error instanceof InfraError ||\n    error instanceof ControllerError\n  ) {\n    return true;\n  }\n\n  // Fall back to name-based checking for bundled code\n  for (const errorType of INTERNAL_ERROR_TYPES) {\n    if (isErrorType(error, errorType)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Creates the response body for an error.\n * Uses instanceof first, then falls back to name-based checking for bundled code.\n *\n * @param error - The error to create body for\n * @returns Error response body\n */\nexport function createErrorResponseBody(error: unknown): ErrorResponseBody {\n  // Masked errors - hide internal details\n  if (shouldMaskError(error)) {\n    return MASKED_ERROR_BODY;\n  }\n\n  // Validation errors - include field details (try instanceof first)\n  if (error instanceof ObjectValidationError) {\n    return buildValidationErrorBody(error.message, error.code, error.validationErrors);\n  }\n  if (error instanceof InvalidRequestError) {\n    return buildValidationErrorBody(error.message, error.code, error.validationErrors);\n  }\n\n  // Validation errors - fall back to name-based checking for bundled code\n  if (isErrorType(error, 'ObjectValidationError') && hasValidationErrors(error)) {\n    return buildValidationErrorBody(error.message, error.code, error.validationErrors);\n  }\n  if (isErrorType(error, 'InvalidRequestError') && hasValidationErrors(error)) {\n    return buildValidationErrorBody(error.message, error.code, error.validationErrors);\n  }\n\n  // Other coded errors - expose message and code (try instanceof first)\n  if (error instanceof CodedError) {\n    return buildSimpleErrorBody(error.message, error.code);\n  }\n\n  // Other coded errors - fall back to name-based checking\n  if (isErrorType(error, 'CodedError')) {\n    return buildSimpleErrorBody(error.message, error.code);\n  }\n\n  // Check for any error with message and code properties\n  if (\n    error &&\n    typeof error === 'object' &&\n    'message' in error &&\n    'code' in error &&\n    typeof (error as CodedErrorLike).message === 'string' &&\n    typeof (error as CodedErrorLike).code === 'string'\n  ) {\n    return buildSimpleErrorBody((error as CodedErrorLike).message, (error as CodedErrorLike).code);\n  }\n\n  // Unknown errors - mask\n  return MASKED_ERROR_BODY;\n}\n\n/**\n * Maps an error to a complete HTTP response structure.\n *\n * Mapping strategy (checked in order):\n * 1. `ObjectValidationError` / `InvalidRequestError` → 400 Bad Request (with field errors)\n * 2. `UseCaseError` → 400 Bad Request\n * 3. `UnauthorizedError` → 401 Unauthorized\n * 4. `ForbiddenError` / `AccessDeniedError` → 403 Forbidden\n * 5. `NotFoundError` → 404 Not Found\n * 6. `ConflictError` → 409 Conflict\n * 7. `UnprocessableError` → 422 Unprocessable Entity\n * 8. `DomainError` / `InfraError` / `ControllerError` → 500 Internal Server Error (masked)\n * 9. Unknown → 500 Internal Server Error (masked)\n *\n * @param error - The error to map\n * @returns Mapped error response with status and body\n */\nexport function mapErrorToHttpResponse(error: unknown): MappedErrorResponse {\n  return {\n    status: getHttpStatusCode(error),\n    body: createErrorResponseBody(error),\n  };\n}\n","/**\n * @fileoverview Error-to-EventResult mapping for event handlers.\n *\n * Maps caught errors to event processing outcomes (ack/retry/dlq).\n * Uses the same name-based type checking as the HTTP error mapper\n * for compatibility with bundled/minified code.\n *\n * @module events/shared/error-mapping\n */\n\nimport { isErrorType } from '../../http/shared/error-mapping';\nimport type { EventResult } from './types';\n\n// ============================================================================\n// Error Type Classifications\n// ============================================================================\n\n/**\n * Error types that indicate permanent failures (send to DLQ).\n * These errors will not resolve on retry.\n */\nconst DLQ_ERROR_TYPES = [\n  'ObjectValidationError',\n  'InvalidRequestError',\n  'UseCaseError',\n  'DomainError',\n  'UnprocessableError',\n  'AccessDeniedError',\n  'ForbiddenError',\n  'UnauthorizedError',\n  'InvariantViolationError',\n];\n\n/**\n * Error types that indicate transient failures (retry).\n * These errors may resolve on subsequent attempts.\n */\nconst RETRY_ERROR_TYPES = [\n  'NotFoundError',\n  'ConflictError',\n  'InfraError',\n  'DbError',\n  'NetworkError',\n  'TimeoutError',\n  'ExternalServiceError',\n  'PersistenceError',\n];\n\n// ============================================================================\n// Mapping Function\n// ============================================================================\n\n/**\n * Maps a caught error to an EventResult.\n *\n * Default mapping strategy:\n *\n * | Error Type                                     | Outcome | Rationale                              |\n * |------------------------------------------------|---------|----------------------------------------|\n * | ObjectValidationError, InvalidRequestError      | dlq     | Bad payload — retrying won't help      |\n * | UseCaseError                                    | dlq     | Business rule rejection — permanent    |\n * | DomainError, InvariantViolationError            | dlq     | Domain invariant — permanent           |\n * | UnprocessableError                              | dlq     | Valid but not processable — permanent  |\n * | AccessDeniedError, ForbiddenError, Unauthorized | dlq     | Permission — permanent                 |\n * | NotFoundError                                   | retry   | Entity might not exist yet             |\n * | ConflictError                                   | retry   | Concurrent write — may resolve         |\n * | InfraError, DbError, NetworkError, TimeoutError | retry   | Infrastructure/transient               |\n * | Unknown                                         | retry   | Conservative — don't lose messages     |\n *\n * @param error - The caught error\n * @returns An EventResult indicating how the message should be handled\n */\nexport function mapErrorToEventResult(error: unknown): EventResult {\n  // Check DLQ errors first (permanent failures)\n  for (const typeName of DLQ_ERROR_TYPES) {\n    if (isErrorType(error, typeName)) {\n      return {\n        outcome: 'dlq',\n        reason: (error as { message: string }).message,\n      };\n    }\n  }\n\n  // Check retry errors (transient failures)\n  for (const typeName of RETRY_ERROR_TYPES) {\n    if (isErrorType(error, typeName)) {\n      return {\n        outcome: 'retry',\n        reason: (error as { message: string }).message,\n      };\n    }\n  }\n\n  // Unknown errors — retry conservatively to avoid losing messages\n  const message =\n    error instanceof Error ? error.message : 'Unknown error occurred during event processing';\n\n  return {\n    outcome: 'retry',\n    reason: message,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC+FO,SAAS,YAAY,OAAgB,UAA2C;AACrF,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAEhD,QAAM,cAAc,OAAO,UAAU,eAAe,KAAK,OAAO,aAAa,IACxE,MAA8C,cAC/C,OAAO,eAAe,KAAK,GAAG;AAClC,MAAI,CAAC,YAAa,QAAO;AACzB,QAAM,OAAO,YAAY;AAEzB,SAAO,SAAS,YAAY,SAAS,IAAI,QAAQ;AACnD;;;ACpFA,IAAM,kBAAkB;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAMA,IAAM,oBAAoB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AA0BO,SAAS,sBAAsB,OAA6B;AAEjE,aAAW,YAAY,iBAAiB;AACtC,QAAI,YAAY,OAAO,QAAQ,GAAG;AAChC,aAAO;AAAA,QACL,SAAS;AAAA,QACT,QAAS,MAA8B;AAAA,MACzC;AAAA,IACF;AAAA,EACF;AAGA,aAAW,YAAY,mBAAmB;AACxC,QAAI,YAAY,OAAO,QAAQ,GAAG;AAChC,aAAO;AAAA,QACL,SAAS;AAAA,QACT,QAAS,MAA8B;AAAA,MACzC;AAAA,IACF;AAAA,EACF;AAGA,QAAM,UACJ,iBAAiB,QAAQ,MAAM,UAAU;AAE3C,SAAO;AAAA,IACL,SAAS;AAAA,IACT,QAAQ;AAAA,EACV;AACF;","names":[]}

package/dist/events/shared/index.d.cts

@@ -0,0 +1,35 @@
+import { E as EventResult } from '../../types-cke61juH.cjs';
+
+/**
+ * @fileoverview Error-to-EventResult mapping for event handlers.
+ *
+ * Maps caught errors to event processing outcomes (ack/retry/dlq).
+ * Uses the same name-based type checking as the HTTP error mapper
+ * for compatibility with bundled/minified code.
+ *
+ * @module events/shared/error-mapping
+ */
+
+/**
+ * Maps a caught error to an EventResult.
+ *
+ * Default mapping strategy:
+ *
+ * | Error Type                                     | Outcome | Rationale                              |
+ * |------------------------------------------------|---------|----------------------------------------|
+ * | ObjectValidationError, InvalidRequestError      | dlq     | Bad payload — retrying won't help      |
+ * | UseCaseError                                    | dlq     | Business rule rejection — permanent    |
+ * | DomainError, InvariantViolationError            | dlq     | Domain invariant — permanent           |
+ * | UnprocessableError                              | dlq     | Valid but not processable — permanent  |
+ * | AccessDeniedError, ForbiddenError, Unauthorized | dlq     | Permission — permanent                 |
+ * | NotFoundError                                   | retry   | Entity might not exist yet             |
+ * | ConflictError                                   | retry   | Concurrent write — may resolve         |
+ * | InfraError, DbError, NetworkError, TimeoutError | retry   | Infrastructure/transient               |
+ * | Unknown                                         | retry   | Conservative — don't lose messages     |
+ *
+ * @param error - The caught error
+ * @returns An EventResult indicating how the message should be handled
+ */
+declare function mapErrorToEventResult(error: unknown): EventResult;
+
+export { EventResult, mapErrorToEventResult };

package/dist/events/shared/index.d.ts

@@ -0,0 +1,35 @@
+import { E as EventResult } from '../../types-cke61juH.js';
+
+/**
+ * @fileoverview Error-to-EventResult mapping for event handlers.
+ *
+ * Maps caught errors to event processing outcomes (ack/retry/dlq).
+ * Uses the same name-based type checking as the HTTP error mapper
+ * for compatibility with bundled/minified code.
+ *
+ * @module events/shared/error-mapping
+ */
+
+/**
+ * Maps a caught error to an EventResult.
+ *
+ * Default mapping strategy:
+ *
+ * | Error Type                                     | Outcome | Rationale                              |
+ * |------------------------------------------------|---------|----------------------------------------|
+ * | ObjectValidationError, InvalidRequestError      | dlq     | Bad payload — retrying won't help      |
+ * | UseCaseError                                    | dlq     | Business rule rejection — permanent    |
+ * | DomainError, InvariantViolationError            | dlq     | Domain invariant — permanent           |
+ * | UnprocessableError                              | dlq     | Valid but not processable — permanent  |
+ * | AccessDeniedError, ForbiddenError, Unauthorized | dlq     | Permission — permanent                 |
+ * | NotFoundError                                   | retry   | Entity might not exist yet             |
+ * | ConflictError                                   | retry   | Concurrent write — may resolve         |
+ * | InfraError, DbError, NetworkError, TimeoutError | retry   | Infrastructure/transient               |
+ * | Unknown                                         | retry   | Conservative — don't lose messages     |
+ *
+ * @param error - The caught error
+ * @returns An EventResult indicating how the message should be handled
+ */
+declare function mapErrorToEventResult(error: unknown): EventResult;
+
+export { EventResult, mapErrorToEventResult };

package/dist/events/shared/index.js

@@ -0,0 +1,13 @@
+import "../../chunk-RVSBIYY4.js";
+import {
+  mapErrorToEventResult
+} from "../../chunk-4BVOLXDJ.js";
+import "../../chunk-H5TNDC5U.js";
+import "../../chunk-2BVCU32G.js";
+import "../../chunk-T7S574XQ.js";
+import "../../chunk-3BY5RBF2.js";
+import "../../chunk-A4JUAZK4.js";
+export {
+  mapErrorToEventResult
+};
+//# sourceMappingURL=index.js.map

package/dist/events/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/global.js

@@ -1,15 +1,15 @@
 import {
   fieldChanged
 } from "./chunk-3QKQCJSP.js";
-import {
-  ObjectValidationError
-} from "./chunk-3BY5RBF2.js";
 import {
   wrapError,
   wrapErrorAsync,
   wrapErrorUnless,
   wrapErrorUnlessAsync
 } from "./chunk-ZG26OQFN.js";
+import {
+  ObjectValidationError
+} from "./chunk-3BY5RBF2.js";
 import {
   CodedError,
   ErrorCodes