@rineex/ddd 0.0.0

package/dist/index.js

@@ -0,0 +1,447 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AggregateId: () => AggregateId,
+  ApplicationError: () => ApplicationError,
+  DomainError: () => DomainError,
+  EntityValidationError: () => EntityValidationError,
+  HttpStatus: () => HttpStatus,
+  HttpStatusMessage: () => HttpStatusMessage,
+  InvalidValueObjectError: () => InvalidValueObjectError,
+  ValueObject: () => ValueObject,
+  deepFreeze: () => deepFreeze,
+  ensureObject: () => ensureObject,
+  unwrapValueObject: () => unwrapValueObject
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/domain/base/domain.error.ts
+var getCauseInfo = (cause) => {
+  if (cause instanceof Error) {
+    return {
+      cause: {
+        message: cause.message,
+        stack: cause.stack,
+        name: cause.name
+      }
+    };
+  }
+  if (cause) {
+    return { cause };
+  }
+  return {};
+};
+var DomainError = class extends Error {
+  /**
+   * @param message - Human-readable error message
+   * @param code - Stable error code
+   * @param metadata - Domain-specific structured data; optional `cause` can be included
+   */
+  constructor(message, code, metadata = {}) {
+    super(message, __spreadValues({}, getCauseInfo(metadata.cause)));
+    Object.setPrototypeOf(this, new.target.prototype);
+    this.name = new.target.name;
+    this.code = code;
+    this.metadata = Object.freeze(__spreadValues({}, metadata));
+  }
+};
+
+// src/domain/base/vo.ts
+var import_es6 = __toESM(require("fast-deep-equal/es6"));
+
+// src/utils/deep-freeze.util.ts
+function deepFreeze(obj, seen = /* @__PURE__ */ new WeakSet()) {
+  if (obj == null || typeof obj !== "object" && !Array.isArray(obj)) {
+    return obj;
+  }
+  if (Object.isFrozen(obj)) {
+    return obj;
+  }
+  if (seen.has(obj)) {
+    return obj;
+  }
+  seen.add(obj);
+  if (Array.isArray(obj)) {
+    obj.forEach((item) => deepFreeze(item, seen));
+  } else {
+    for (const key in obj) {
+      if (Object.hasOwn(obj, key)) {
+        deepFreeze(obj[key], seen);
+      }
+    }
+  }
+  return Object.freeze(obj);
+}
+
+// src/domain/base/vo.ts
+var ValueObject = class _ValueObject {
+  get value() {
+    return this.props;
+  }
+  constructor(props) {
+    this.validate(props);
+    this.props = deepFreeze(props);
+  }
+  /**
+   * Type guard to check if an unknown object is an instance of ValueObject.
+   * This is useful for runtime type checking.
+   *
+   * @param vo The object to check.
+   * @returns True if the object is a ValueObject instance, false otherwise.
+   */
+  static is(vo) {
+    return vo instanceof _ValueObject;
+  }
+  /**
+   * Deep equality comparison of ValueObjects
+   */
+  equals(other) {
+    if (!other || !(other instanceof this.constructor)) {
+      return false;
+    }
+    return (0, import_es6.default)(this.props, other.props);
+  }
+};
+
+// src/domain/errors/entity-validation.error.ts
+var EntityValidationError = class extends DomainError {
+  constructor(message, cause) {
+    super(message, "ENTITY_VALIDATION_ERROR", { cause });
+  }
+};
+
+// src/domain/errors/invalid-vo.error.ts
+var InvalidValueObjectError = class extends DomainError {
+  constructor(message) {
+    super(message, "INVALID_VALUE_OBJECT");
+  }
+};
+
+// src/domain/value-objects/aggregate-id.vo.ts
+var import_uuid = require("uuid");
+var import_zod = __toESM(require("zod"));
+var _AggregateId = class _AggregateId extends ValueObject {
+  /**
+   * Get the UUID of the AggregateId
+   * @returns The UUID of the AggregateId
+   */
+  get uuid() {
+    return this.value;
+  }
+  /**
+   * Create a new AggregateId
+   * @param value The value to create the AggregateId from
+   * @returns The new AggregateId
+   */
+  static create(value) {
+    return new _AggregateId(value);
+  }
+  /**
+   * Create a new AggregateId with a random UUID v4
+   */
+  static generate() {
+    return new _AggregateId((0, import_uuid.v4)());
+  }
+  /**
+   * Check if the AggregateId is empty
+   * @returns True if the AggregateId is empty, false otherwise
+   */
+  isEmpty() {
+    return !this.value;
+  }
+  /**
+   * Convert the AggregateId to a string
+   * @returns The string representation of the AggregateId
+   */
+  toString() {
+    return this.value;
+  }
+  /**
+   * Validate the AggregateId
+   * @param value The value to validate
+   * @throws InvalidValueObjectException if the value is invalid
+   */
+  validate(value) {
+    const result = _AggregateId.schema.safeParse(value);
+    if (!result.success) {
+      throw new InvalidValueObjectError(
+        `Invalid AggregateId: ${result.error.message}`
+      );
+    }
+  }
+};
+/**
+ * The schema for the AggregateId
+ */
+_AggregateId.schema = import_zod.default.uuid();
+var AggregateId = _AggregateId;
+
+// src/gateway/constants/http-code.ts
+var HttpStatus = Object.freeze({
+  REQUEST_HEADER_FIELDS_TOO_LARGE: 431,
+  NETWORK_AUTHENTICATION_REQUIRED: 511,
+  NON_AUTHORITATIVE_INFORMATION: 203,
+  PROXY_AUTHENTICATION_REQUIRED: 407,
+  UNAVAILABLE_FOR_LEGAL_REASONS: 451,
+  HTTP_VERSION_NOT_SUPPORTED: 505,
+  BANDWIDTH_LIMIT_EXCEEDED: 509,
+  VARIANT_ALSO_NEGOTIATES: 506,
+  UNSUPPORTED_MEDIA_TYPE: 415,
+  RANGE_NOT_SATISFIABLE: 416,
+  PRECONDITION_REQUIRED: 428,
+  INTERNAL_SERVER_ERROR: 500,
+  UNPROCESSABLE_ENTITY: 422,
+  INSUFFICIENT_STORAGE: 507,
+  SWITCHING_PROTOCOLS: 101,
+  PRECONDITION_FAILED: 412,
+  MISDIRECTED_REQUEST: 421,
+  SERVICE_UNAVAILABLE: 503,
+  TEMPORARY_REDIRECT: 307,
+  PERMANENT_REDIRECT: 308,
+  METHOD_NOT_ALLOWED: 405,
+  EXPECTATION_FAILED: 417,
+  MOVED_PERMANENTLY: 301,
+  PAYLOAD_TOO_LARGE: 413,
+  FAILED_DEPENDENCY: 424,
+  TOO_MANY_REQUESTS: 429,
+  ALREADY_REPORTED: 208,
+  MULTIPLE_CHOICES: 300,
+  PAYMENT_REQUIRED: 402,
+  UPGRADE_REQUIRED: 426,
+  PARTIAL_CONTENT: 206,
+  REQUEST_TIMEOUT: 408,
+  LENGTH_REQUIRED: 411,
+  NOT_IMPLEMENTED: 501,
+  GATEWAY_TIMEOUT: 504,
+  NOT_ACCEPTABLE: 406,
+  RESET_CONTENT: 205,
+  LOOP_DETECTED: 508,
+  MULTI_STATUS: 207,
+  NOT_MODIFIED: 304,
+  UNAUTHORIZED: 401,
+  URI_TOO_LONG: 414,
+  NOT_EXTENDED: 510,
+  EARLY_HINTS: 103,
+  BAD_REQUEST: 400,
+  IM_A_TEAPOT: 418,
+  BAD_GATEWAY: 502,
+  PROCESSING: 102,
+  NO_CONTENT: 204,
+  SEE_OTHER: 303,
+  USE_PROXY: 305,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  TOO_EARLY: 425,
+  CONTINUE: 100,
+  ACCEPTED: 202,
+  CONFLICT: 409,
+  CREATED: 201,
+  IM_USED: 226,
+  LOCKED: 423,
+  FOUND: 302,
+  GONE: 410,
+  OK: 200
+});
+var HttpStatusMessage = {
+  431: "Request Header Fields Too Large",
+  511: "Network Authentication Required",
+  203: "Non-Authoritative Information",
+  407: "Proxy Authentication Required",
+  451: "Unavailable For Legal Reasons",
+  505: "HTTP Version Not Supported",
+  509: "Bandwidth Limit Exceeded",
+  506: "Variant Also Negotiates",
+  415: "Unsupported Media Type",
+  416: "Range Not Satisfiable",
+  428: "Precondition Required",
+  500: "Internal Server Error",
+  422: "Unprocessable Entity",
+  507: "Insufficient Storage",
+  101: "Switching Protocols",
+  412: "Precondition Failed",
+  421: "Misdirected Request",
+  503: "Service Unavailable",
+  307: "Temporary Redirect",
+  308: "Permanent Redirect",
+  405: "Method Not Allowed",
+  417: "Expectation Failed",
+  301: "Moved Permanently",
+  413: "Payload Too Large",
+  424: "Failed Dependency",
+  429: "Too Many Requests",
+  208: "Already Reported",
+  300: "Multiple Choices",
+  402: "Payment Required",
+  426: "Upgrade Required",
+  206: "Partial Content",
+  408: "Request Timeout",
+  411: "Length Required",
+  501: "Not Implemented",
+  504: "Gateway Timeout",
+  406: "Not Acceptable",
+  205: "Reset Content",
+  508: "Loop Detected",
+  207: "Multi-Status",
+  304: "Not Modified",
+  401: "Unauthorized",
+  414: "URI Too Long",
+  418: "I'm a Teapot",
+  510: "Not Extended",
+  103: "Early Hints",
+  400: "Bad Request",
+  502: "Bad Gateway",
+  102: "Processing",
+  204: "No Content",
+  303: "See Other",
+  305: "Use Proxy",
+  403: "Forbidden",
+  404: "Not Found",
+  425: "Too Early",
+  100: "Continue",
+  202: "Accepted",
+  226: "I'm Used",
+  409: "Conflict",
+  201: "Created",
+  423: "Locked",
+  302: "Found",
+  410: "Gone",
+  200: "OK"
+};
+
+// src/utils/errors/application.error.ts
+var ApplicationError = class extends Error {
+  constructor({
+    code = HttpStatusMessage["500"],
+    isOperational = false,
+    status = 500,
+    metadata,
+    message,
+    cause
+  }) {
+    super(message);
+    this.name = new.target.name;
+    this.code = code;
+    this.status = status;
+    this.isOperational = isOperational;
+    this.metadata = metadata;
+    this.cause = cause;
+    Error.captureStackTrace(this, new.target);
+  }
+};
+
+// src/utils/unwrap-vo.util.ts
+function unwrapValueObject(input, seen = /* @__PURE__ */ new WeakSet()) {
+  if (input === null || input === void 0) {
+    return input;
+  }
+  if (typeof input !== "object") {
+    return input;
+  }
+  if (seen.has(input)) {
+    throw new Error("Circular reference detected in ValueObject unwrap");
+  }
+  seen.add(input);
+  if (Array.isArray(input)) {
+    const result2 = input.map((item) => unwrapValueObject(item, seen));
+    seen.delete(input);
+    return result2;
+  }
+  if (input instanceof ValueObject) {
+    const result2 = unwrapValueObject(input.value, seen);
+    seen.delete(input);
+    return result2;
+  }
+  if (input instanceof Date) {
+    seen.delete(input);
+    return input.toISOString();
+  }
+  if (input instanceof Map) {
+    const result2 = /* @__PURE__ */ new Map();
+    input.forEach((value, key) => {
+      result2.set(key, unwrapValueObject(value, seen));
+    });
+    seen.delete(input);
+    return result2;
+  }
+  if (input instanceof Set) {
+    const result2 = new Set(
+      Array.from(input.values()).map((v) => unwrapValueObject(v, seen))
+    );
+    seen.delete(input);
+    return result2;
+  }
+  const result = {};
+  for (const key in input) {
+    if (Object.hasOwn(input, key)) {
+      result[key] = unwrapValueObject(input[key], seen);
+    }
+  }
+  seen.delete(input);
+  return result;
+}
+function ensureObject(input) {
+  if (input === null || input === void 0) {
+    return {};
+  }
+  if (typeof input === "object") {
+    return input;
+  }
+  return { value: input };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AggregateId,
+  ApplicationError,
+  DomainError,
+  EntityValidationError,
+  HttpStatus,
+  HttpStatusMessage,
+  InvalidValueObjectError,
+  ValueObject,
+  deepFreeze,
+  ensureObject,
+  unwrapValueObject
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/domain/base/domain.error.ts","../src/domain/base/vo.ts","../src/utils/deep-freeze.util.ts","../src/domain/errors/entity-validation.error.ts","../src/domain/errors/invalid-vo.error.ts","../src/domain/value-objects/aggregate-id.vo.ts","../src/gateway/constants/http-code.ts","../src/utils/errors/application.error.ts","../src/utils/unwrap-vo.util.ts"],"sourcesContent":["export * from './application';\nexport * from './domain/base/domain.error';\nexport * from './domain/base/vo';\nexport * from './domain/errors/entity-validation.error';\nexport * from './domain/errors/invalid-vo.error';\nexport * from './domain/value-objects/aggregate-id.vo';\nexport * from './gateway/constants/http-code';\nexport * from './utils';\n","export interface DomainErrorMetadata {\n  cause?: { name: string; message: string; stack?: string };\n  [key: string]: unknown;\n}\n\nconst getCauseInfo = (cause: Error | undefined) => {\n  // 1. Handle Error objects specifically\n  if (cause instanceof Error) {\n    return {\n      cause: {\n        message: cause.message,\n        stack: cause.stack,\n        name: cause.name,\n      },\n    };\n  }\n\n  // 2. Handle other existing values\n  if (cause) {\n    return { cause };\n  }\n\n  // 3. Default to empty\n  return {};\n};\n\n/**\n * Base class for all Domain Errors in the application.\n *\n * This class ensures:\n * 1. Serializable and structured for logs or API responses.\n * 2. Identifiable via stable error codes (not just class names).\n * 3. Contextual with optional structured metadata.\n * 4. Supports error chaining (cause) and stack trace preservation.\n *\n * @example\n * export class InsufficientFundsError extends DomainError {\n *   constructor(accountId: string, currentBalance: number) {\n *     super(\n *       `Account ${accountId} has insufficient funds.`,\n *       'INSUFFICIENT_FUNDS',\n *       { accountId, currentBalance }\n *     );\n *   }\n * }\n */\nexport abstract class DomainError extends Error {\n  /** Stable, machine-readable error code */\n  public readonly code: string;\n  /** Structured, immutable domain metadata */\n  public readonly metadata: Readonly<DomainErrorMetadata>;\n\n  /**\n   * @param message - Human-readable error message\n   * @param code - Stable error code\n   * @param metadata - Domain-specific structured data; optional `cause` can be included\n   */\n  protected constructor(\n    message: string,\n    code: string,\n    metadata: DomainErrorMetadata = {},\n  ) {\n    super(message, { ...getCauseInfo(metadata.cause) });\n\n    // Restore prototype chain for proper `instanceof` checks\n    Object.setPrototypeOf(this, new.target.prototype);\n\n    this.name = new.target.name;\n    this.code = code;\n    this.metadata = Object.freeze({ ...metadata });\n  }\n}\n","import deepEqual from 'fast-deep-equal/es6';\n\nimport { deepFreeze } from '@/utils/deep-freeze.util';\n\nexport abstract class ValueObject<T> {\n  get value(): T {\n    return this.props;\n  }\n\n  protected readonly props: Readonly<T>;\n\n  protected constructor(props: T) {\n    this.validate(props);\n    this.props = deepFreeze(props);\n  }\n\n  /**\n   * Type guard to check if an unknown object is an instance of ValueObject.\n   * This is useful for runtime type checking.\n   *\n   * @param vo The object to check.\n   * @returns True if the object is a ValueObject instance, false otherwise.\n   */\n  public static is(vo: unknown): vo is ValueObject<unknown> {\n    return vo instanceof ValueObject;\n  }\n\n  /**\n   * Deep equality comparison of ValueObjects\n   */\n  public equals(other?: ValueObject<T>): boolean {\n    if (\n      !other ||\n      !(other instanceof (this.constructor as typeof ValueObject))\n    ) {\n      return false;\n    }\n\n    return deepEqual(this.props, other.props);\n  }\n\n  /**\n   * Validates the value object props\n   * @throws InvalidValueObjectError if validation fails\n   */\n  protected abstract validate(props: T): void;\n}\n","/**\n * Utility to deeply freeze objects to ensure immutability\n */\nexport function deepFreeze<T>(\n  obj: T,\n  seen = new WeakSet<object>(),\n): Readonly<T> {\n  // Handle null, undefined, or non-object types\n  if (obj == null || (typeof obj !== 'object' && !Array.isArray(obj))) {\n    return obj;\n  }\n\n  // Skip if already frozen\n  if (Object.isFrozen(obj)) {\n    return obj as Readonly<T>;\n  }\n\n  // Handle circular references\n  if (seen.has(obj as object)) {\n    return obj as Readonly<T>;\n  }\n\n  seen.add(obj as object);\n\n  // Handle arrays explicitly\n  if (Array.isArray(obj)) {\n    obj.forEach(item => deepFreeze(item, seen));\n  } else {\n    // Handle plain objects\n    for (const key in obj) {\n      if (Object.hasOwn(obj, key)) {\n        deepFreeze((obj as any)[key], seen); // Use 'any' here as T[key] might not be assignable to T for deepFreeze's input\n      }\n    }\n  }\n\n  return Object.freeze(obj) as Readonly<T>;\n}\n","import { DomainError } from '../base/domain.error';\n\n/**\n * Custom error class for entity validation failures.\n */\nexport class EntityValidationError extends DomainError {\n  constructor(message: string, cause?: Error) {\n    super(message, 'ENTITY_VALIDATION_ERROR', { cause });\n  }\n}\n","import { DomainError } from '../base/domain.error';\n\nexport class InvalidValueObjectError extends DomainError {\n  constructor(message: string) {\n    super(message, 'INVALID_VALUE_OBJECT');\n  }\n}\n","import { v4 } from 'uuid';\nimport z from 'zod';\n\nimport { InvalidValueObjectError } from '../errors/invalid-vo.error';\nimport { ValueObject } from '../base/vo';\n\n/**\n * AggregateId is a ValueObject that represents a unique identifier for an aggregate.\n */\nexport class AggregateId extends ValueObject<string> {\n  /**\n   * The schema for the AggregateId\n   */\n  private static readonly schema = z.uuid();\n\n  /**\n   * Get the UUID of the AggregateId\n   * @returns The UUID of the AggregateId\n   */\n  public get uuid(): string {\n    return this.value;\n  }\n\n  /**\n   * Create a new AggregateId\n   * @param value The value to create the AggregateId from\n   * @returns The new AggregateId\n   */\n  public static create(value: string): AggregateId {\n    return new AggregateId(value);\n  }\n\n  /**\n   * Create a new AggregateId with a random UUID v4\n   */\n  public static generate(): AggregateId {\n    return new AggregateId(v4());\n  }\n\n  /**\n   * Check if the AggregateId is empty\n   * @returns True if the AggregateId is empty, false otherwise\n   */\n  public isEmpty(): boolean {\n    return !this.value;\n  }\n\n  /**\n   * Convert the AggregateId to a string\n   * @returns The string representation of the AggregateId\n   */\n  public toString(): string {\n    return this.value;\n  }\n\n  /**\n   * Validate the AggregateId\n   * @param value The value to validate\n   * @throws InvalidValueObjectException if the value is invalid\n   */\n  protected validate(value: string): void {\n    const result = AggregateId.schema.safeParse(value);\n\n    if (!result.success) {\n      throw new InvalidValueObjectError(\n        `Invalid AggregateId: ${result.error.message}`,\n      );\n    }\n  }\n}\n","/**\n * HTTP status code catalog.\n *\n * This object provides a typed, immutable map of standard HTTP status names\n * to their numeric codes. Designed for server-side frameworks such as Fastify.\n *\n * - All identifiers use clear, canonical semantic names.\n * - Values are numeric status codes.\n * - Frozen to prevent runtime mutation.\n * - Exporting `HttpStatus` ensures type-safe usage across the codebase.\n */\nexport const HttpStatus = Object.freeze({\n  REQUEST_HEADER_FIELDS_TOO_LARGE: 431,\n  NETWORK_AUTHENTICATION_REQUIRED: 511,\n  NON_AUTHORITATIVE_INFORMATION: 203,\n  PROXY_AUTHENTICATION_REQUIRED: 407,\n\n  UNAVAILABLE_FOR_LEGAL_REASONS: 451,\n  HTTP_VERSION_NOT_SUPPORTED: 505,\n  BANDWIDTH_LIMIT_EXCEEDED: 509,\n  VARIANT_ALSO_NEGOTIATES: 506,\n  UNSUPPORTED_MEDIA_TYPE: 415,\n  RANGE_NOT_SATISFIABLE: 416,\n  PRECONDITION_REQUIRED: 428,\n  INTERNAL_SERVER_ERROR: 500,\n  UNPROCESSABLE_ENTITY: 422,\n  INSUFFICIENT_STORAGE: 507,\n\n  SWITCHING_PROTOCOLS: 101,\n  PRECONDITION_FAILED: 412,\n  MISDIRECTED_REQUEST: 421,\n  SERVICE_UNAVAILABLE: 503,\n  TEMPORARY_REDIRECT: 307,\n  PERMANENT_REDIRECT: 308,\n  METHOD_NOT_ALLOWED: 405,\n  EXPECTATION_FAILED: 417,\n\n  MOVED_PERMANENTLY: 301,\n  PAYLOAD_TOO_LARGE: 413,\n  FAILED_DEPENDENCY: 424,\n  TOO_MANY_REQUESTS: 429,\n  ALREADY_REPORTED: 208,\n  MULTIPLE_CHOICES: 300,\n  PAYMENT_REQUIRED: 402,\n  UPGRADE_REQUIRED: 426,\n  PARTIAL_CONTENT: 206,\n  REQUEST_TIMEOUT: 408,\n  LENGTH_REQUIRED: 411,\n  NOT_IMPLEMENTED: 501,\n  GATEWAY_TIMEOUT: 504,\n  NOT_ACCEPTABLE: 406,\n  RESET_CONTENT: 205,\n  LOOP_DETECTED: 508,\n  MULTI_STATUS: 207,\n  NOT_MODIFIED: 304,\n  UNAUTHORIZED: 401,\n  URI_TOO_LONG: 414,\n  NOT_EXTENDED: 510,\n  EARLY_HINTS: 103,\n  BAD_REQUEST: 400,\n  IM_A_TEAPOT: 418,\n  BAD_GATEWAY: 502,\n  PROCESSING: 102,\n  NO_CONTENT: 204,\n  SEE_OTHER: 303,\n  USE_PROXY: 305,\n\n  FORBIDDEN: 403,\n  NOT_FOUND: 404,\n  TOO_EARLY: 425,\n  CONTINUE: 100,\n  ACCEPTED: 202,\n  CONFLICT: 409,\n  CREATED: 201,\n  IM_USED: 226,\n  LOCKED: 423,\n  FOUND: 302,\n  GONE: 410,\n  OK: 200,\n} as const);\n\n/**\n * HTTP status messages mapped by numeric code.\n * Use for sending descriptive text in responses or logging.\n */\nexport const HttpStatusMessage = {\n  431: 'Request Header Fields Too Large',\n  511: 'Network Authentication Required',\n  203: 'Non-Authoritative Information',\n  407: 'Proxy Authentication Required',\n  451: 'Unavailable For Legal Reasons',\n  505: 'HTTP Version Not Supported',\n  509: 'Bandwidth Limit Exceeded',\n  506: 'Variant Also Negotiates',\n  415: 'Unsupported Media Type',\n  416: 'Range Not Satisfiable',\n  428: 'Precondition Required',\n  500: 'Internal Server Error',\n  422: 'Unprocessable Entity',\n  507: 'Insufficient Storage',\n  101: 'Switching Protocols',\n  412: 'Precondition Failed',\n  421: 'Misdirected Request',\n  503: 'Service Unavailable',\n  307: 'Temporary Redirect',\n  308: 'Permanent Redirect',\n  405: 'Method Not Allowed',\n  417: 'Expectation Failed',\n  301: 'Moved Permanently',\n  413: 'Payload Too Large',\n  424: 'Failed Dependency',\n  429: 'Too Many Requests',\n  208: 'Already Reported',\n  300: 'Multiple Choices',\n  402: 'Payment Required',\n  426: 'Upgrade Required',\n  206: 'Partial Content',\n  408: 'Request Timeout',\n  411: 'Length Required',\n  501: 'Not Implemented',\n  504: 'Gateway Timeout',\n  406: 'Not Acceptable',\n  205: 'Reset Content',\n  508: 'Loop Detected',\n  207: 'Multi-Status',\n  304: 'Not Modified',\n  401: 'Unauthorized',\n  414: 'URI Too Long',\n  418: \"I'm a Teapot\",\n  510: 'Not Extended',\n  103: 'Early Hints',\n  400: 'Bad Request',\n  502: 'Bad Gateway',\n  102: 'Processing',\n  204: 'No Content',\n  303: 'See Other',\n  305: 'Use Proxy',\n  403: 'Forbidden',\n  404: 'Not Found',\n  425: 'Too Early',\n  100: 'Continue',\n  202: 'Accepted',\n  226: \"I'm Used\",\n  409: 'Conflict',\n  201: 'Created',\n  423: 'Locked',\n  302: 'Found',\n  410: 'Gone',\n  200: 'OK',\n} as const;\n\nexport type HttpStatusCode = keyof typeof HttpStatusMessage;\n\nexport type HttpStatusMessage =\n  (typeof HttpStatusMessage)[keyof typeof HttpStatusMessage];\n","import {\n  HttpStatusCode,\n  HttpStatusMessage,\n} from '@/gateway/constants/http-code';\n\ninterface ErrorParams {\n  message: string;\n  code: HttpStatusMessage;\n  status?: HttpStatusCode;\n  metadata?: Record<string, unknown> | undefined;\n  isOperational?: boolean;\n  cause?: Error | undefined;\n}\n\n/**\n * Abstract base class for application-level errors with structured error handling.\n *\n * Extends the native Error class to provide machine-readable error codes, HTTP status codes,\n * operational error classification, and optional metadata for better error tracking and client communication.\n *\n * @abstract\n * @extends {Error}\n *\n * @example\n * ```typescript\n * class UserNotFoundError extends ApplicationError {\n *   constructor(userId: string) {\n *     super({\n *       code: HttpStatusMessage['404'],\n *       status: 404,\n *       isOperational: true,\n *       message: `User with id ${userId} not found`,\n *       metadata: { userId }\n *     });\n *   }\n * }\n * ```\n */\nexport abstract class ApplicationError extends Error {\n  /** Optional cause (linked error) */\n  public readonly cause?: Error | undefined;\n  /** Machine-readable error code (e.g. `OTP_LOCKED`, `USER_NOT_FOUND`) */\n  public readonly code: HttpStatusMessage;\n  /** Operational vs programmer error flag */\n  public readonly isOperational: boolean;\n  /** Optional structured metadata for debugging or clients */\n  public readonly metadata?: Record<string, unknown> | undefined;\n  /** HTTP status code intended for response layer */\n  public readonly status: HttpStatusCode;\n\n  constructor({\n    code = HttpStatusMessage['500'],\n    isOperational = false,\n    status = 500,\n    metadata,\n    message,\n    cause,\n  }: ErrorParams) {\n    super(message);\n\n    this.name = new.target.name;\n    this.code = code;\n    this.status = status;\n    this.isOperational = isOperational;\n    this.metadata = metadata;\n    this.cause = cause;\n\n    Error.captureStackTrace(this, new.target);\n  }\n}\n","import { ValueObject } from '@/domain/base/vo';\n\nexport type UnwrapValueObject<T> =\n  T extends ValueObject<infer V>\n    ? UnwrapValueObject<V>\n    : T extends (infer U)[]\n      ? UnwrapValueObject<U>[]\n      : T extends Map<infer K, infer V>\n        ? Map<K, UnwrapValueObject<V>>\n        : T extends Set<infer V>\n          ? Set<UnwrapValueObject<V>>\n          : T extends Date\n            ? string\n            : T extends object\n              ? { [K in keyof T]: UnwrapValueObject<T[K]> }\n              : T;\n\nexport function unwrapValueObject<T>(\n  input: T,\n  seen = new WeakSet(),\n): UnwrapValueObject<T> {\n  if (input === null || input === undefined) {\n    return input as UnwrapValueObject<T>;\n  }\n\n  if (typeof input !== 'object') {\n    return input as UnwrapValueObject<T>;\n  }\n\n  if (seen.has(input)) {\n    // Prevent circular reference infinite recursion, just return input or throw\n    throw new Error('Circular reference detected in ValueObject unwrap');\n  }\n\n  seen.add(input);\n\n  if (Array.isArray(input)) {\n    const result = input.map(item => unwrapValueObject(item, seen));\n    seen.delete(input);\n    return result as UnwrapValueObject<T>;\n  }\n\n  if (input instanceof ValueObject) {\n    const result = unwrapValueObject(input.value, seen);\n    seen.delete(input);\n    return result as UnwrapValueObject<T>;\n  }\n\n  if (input instanceof Date) {\n    seen.delete(input);\n    return input.toISOString() as UnwrapValueObject<T>;\n  }\n\n  if (input instanceof Map) {\n    const result = new Map();\n    input.forEach((value, key) => {\n      result.set(key, unwrapValueObject(value, seen));\n    });\n    seen.delete(input);\n    return result as UnwrapValueObject<T>;\n  }\n\n  if (input instanceof Set) {\n    const result = new Set(\n      Array.from(input.values()).map(v => unwrapValueObject(v, seen)),\n    );\n    seen.delete(input);\n    return result as UnwrapValueObject<T>;\n  }\n\n  // generic object\n  const result: Record<string, unknown> = {};\n\n  for (const key in input) {\n    if (Object.hasOwn(input, key)) {\n      result[key] = unwrapValueObject((input as any)[key], seen);\n    }\n  }\n\n  seen.delete(input);\n  return result as UnwrapValueObject<T>;\n}\n\nexport function ensureObject<T>(input: UnwrapValueObject<T>): object {\n  if (input === null || input === undefined) {\n    return {};\n  }\n  if (typeof input === 'object') {\n    return input;\n  }\n\n  // for primitives, wrap inside object with default key (or throw)\n  return { value: input };\n}\n"],"mappings":"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","names":["deepEqual","z","result"]}