@cosmneo/onion-lasagna 0.1.0

package/dist/chunk-VCHFXT5W.js

@@ -0,0 +1,425 @@
+import {
+  DomainError
+} from "./chunk-ZWLYNGO3.js";
+import {
+  ErrorCodes
+} from "./chunk-MQD5GXMT.js";
+
+// src/backend/core/onion-layers/domain/classes/base-value-object.class.ts
+var SKIP_VALUE_OBJECT_VALIDATION = "skip value object validation";
+function deepEquals(a, b) {
+  if (a === b) return true;
+  if (a === null || a === void 0 || b === null || b === void 0) {
+    return a === b;
+  }
+  if (a instanceof Date && b instanceof Date) {
+    return a.getTime() === b.getTime();
+  }
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    return a.every((item, index) => deepEquals(item, b[index]));
+  }
+  if (typeof a === "object" && typeof b === "object") {
+    const aObj = a;
+    const bObj = b;
+    const aKeys = Object.keys(aObj);
+    const bKeys = Object.keys(bObj);
+    if (aKeys.length !== bKeys.length) return false;
+    return aKeys.every((key) => deepEquals(aObj[key], bObj[key]));
+  }
+  return false;
+}
+var BaseValueObject = class {
+  _value;
+  /**
+   * Creates a new Value Object instance.
+   *
+   * @param value - The raw value to wrap
+   * @param validator - A bound validator or SKIP_VALUE_OBJECT_VALIDATION to bypass
+   * @throws {ObjectValidationError} When validation fails
+   */
+  constructor(value, validator) {
+    this._value = validator === SKIP_VALUE_OBJECT_VALIDATION ? value : validator.validate(value);
+  }
+  /**
+   * Compares this Value Object with another for equality.
+   *
+   * Uses deep equality comparison to handle nested objects, arrays, and dates.
+   * Two Value Objects are equal if their underlying values are deeply equal.
+   *
+   * @param other - The Value Object to compare with
+   * @returns `true` if the values are deeply equal, `false` otherwise
+   */
+  equals(other) {
+    if (this === other) return true;
+    return deepEquals(this.value, other.value);
+  }
+  /**
+   * The underlying immutable value.
+   *
+   * @returns The wrapped value of type T
+   */
+  get value() {
+    return this._value;
+  }
+};
+
+// src/backend/core/onion-layers/domain/exceptions/invariant-violation.error.ts
+var InvariantViolationError = class _InvariantViolationError extends DomainError {
+  /**
+   * Creates a new InvariantViolationError instance.
+   *
+   * @param options - Error configuration
+   * @param options.message - Description of the violated invariant
+   * @param options.code - Machine-readable error code (default: 'INVARIANT_VIOLATION')
+   * @param options.cause - Optional underlying error
+   */
+  constructor({
+    message,
+    code = ErrorCodes.Domain.INVARIANT_VIOLATION,
+    cause
+  }) {
+    super({ message, code, cause });
+  }
+  /**
+   * Creates an InvariantViolationError from a caught error.
+   *
+   * @param cause - The original caught error
+   * @returns A new InvariantViolationError instance with the cause attached
+   */
+  static fromError(cause) {
+    return new _InvariantViolationError({
+      message: cause instanceof Error ? cause.message : "Invariant violation",
+      cause
+    });
+  }
+};
+
+// src/backend/core/onion-layers/domain/value-objects/base-audit-by.vo.ts
+var BaseAuditByVo = class extends BaseValueObject {
+  /**
+   * Creates a new BaseAuditByVo instance.
+   *
+   * @param value - The user tracking values
+   * @param value.createdBy - User who created the entity (optional for system ops)
+   * @param value.updatedBy - User who last updated the entity (optional)
+   * @param validator - Bound validator or skip validation symbol
+   */
+  constructor(value, validator) {
+    super(value, validator);
+  }
+  /**
+   * The user ID who created the entity.
+   * Returns `undefined` for system-created entities.
+   */
+  get createdBy() {
+    return this.value.createdBy;
+  }
+  /**
+   * The user ID who last updated the entity.
+   * Returns `undefined` for system-updated entities.
+   */
+  get updatedBy() {
+    return this.value.updatedBy;
+  }
+};
+
+// src/backend/core/onion-layers/domain/value-objects/base-audit-info.vo.ts
+var BaseAuditInfoVo = class extends BaseValueObject {
+  /**
+   * Creates a new BaseAuditInfoVo instance.
+   *
+   * @param value - Composite value containing audit by and on VOs
+   * @param value.by - User tracking value object
+   * @param value.on - Timestamp tracking value object
+   * @param validator - Bound validator or skip validation symbol
+   */
+  constructor(value, validator) {
+    super(value, validator);
+  }
+  /**
+   * The user ID who created the entity.
+   * Returns `undefined` for system-created entities.
+   */
+  get createdBy() {
+    return this.value.by.createdBy;
+  }
+  /**
+   * The timestamp when the entity was created.
+   * Returns a cloned Date to prevent mutation.
+   */
+  get createdAt() {
+    return new Date(this.value.on.createdAt.getTime());
+  }
+  /**
+   * The user ID who last updated the entity.
+   * Returns `undefined` for system-updated entities.
+   */
+  get updatedBy() {
+    return this.value.by.updatedBy;
+  }
+  /**
+   * The timestamp when the entity was last updated.
+   * Returns a cloned Date to prevent mutation.
+   */
+  get updatedAt() {
+    return new Date(this.value.on.updatedAt.getTime());
+  }
+  /**
+   * Whether the entity has been modified since creation.
+   *
+   * Compares both timestamps and user IDs. Returns `true` if either:
+   * - The updatedAt timestamp differs from createdAt
+   * - The updatedBy user differs from createdBy
+   *
+   * Note: When both createdBy and updatedBy are undefined (system-created
+   * entities), this correctly returns false for the user comparison.
+   */
+  get isModified() {
+    const timestampChanged = this.updatedAt.getTime() !== this.createdAt.getTime();
+    const userChanged = this.updatedBy?.value !== this.createdBy?.value;
+    return timestampChanged || userChanged;
+  }
+  /**
+   * Alias for `updatedBy` for semantic clarity.
+   */
+  get lastModifiedBy() {
+    return this.updatedBy;
+  }
+  /**
+   * Alias for `updatedAt` for semantic clarity.
+   */
+  get lastModifiedAt() {
+    return this.updatedAt;
+  }
+};
+
+// src/backend/core/onion-layers/domain/value-objects/base-audit-on.vo.ts
+var BaseAuditOnVo = class extends BaseValueObject {
+  /**
+   * Creates a new BaseAuditOnVo instance.
+   *
+   * @param value - The timestamp values
+   * @param value.createdAt - When the entity was created
+   * @param value.updatedAt - When the entity was last updated
+   * @param validator - Bound validator or skip validation symbol
+   * @throws {InvariantViolationError} When `updatedAt < createdAt`
+   */
+  constructor(value, validator) {
+    if (value.updatedAt < value.createdAt) {
+      throw new InvariantViolationError({
+        message: "UpdatedAt cannot be earlier than createdAt",
+        code: "INVALID_AUDIT_TIMESTAMPS"
+      });
+    }
+    super(value, validator);
+  }
+  /**
+   * When the entity was created.
+   * Returns a cloned Date to prevent mutation.
+   */
+  get createdAt() {
+    return new Date(this.value.createdAt);
+  }
+  /**
+   * When the entity was last updated.
+   * Returns a cloned Date to prevent mutation.
+   */
+  get updatedAt() {
+    return new Date(this.value.updatedAt);
+  }
+};
+
+// src/backend/core/onion-layers/domain/value-objects/base-email.vo.ts
+var BaseEmailVo = class extends BaseValueObject {
+  /**
+   * Creates a new BaseEmailVo instance.
+   *
+   * @param value - The email address string
+   * @param validator - Bound validator or skip validation symbol
+   */
+  constructor(value, validator) {
+    super(value, validator);
+  }
+};
+
+// src/backend/core/onion-layers/domain/value-objects/base-long-text.vo.ts
+var BaseLongTextVo = class extends BaseValueObject {
+  /**
+   * Creates a new BaseLongTextVo instance.
+   *
+   * @param value - The long text string
+   * @param validator - Bound validator or skip validation symbol
+   */
+  constructor(value, validator) {
+    super(value, validator);
+  }
+};
+
+// src/backend/core/onion-layers/domain/value-objects/base-medium-text.vo.ts
+var BaseMediumTextVo = class extends BaseValueObject {
+  /**
+   * Creates a new BaseMediumTextVo instance.
+   *
+   * @param value - The medium text string
+   * @param validator - Bound validator or skip validation symbol
+   */
+  constructor(value, validator) {
+    super(value, validator);
+  }
+};
+
+// src/backend/core/onion-layers/domain/value-objects/base-pagination.vo.ts
+var BasePaginationVo = class extends BaseValueObject {
+  /**
+   * Creates a new BasePaginationVo instance.
+   *
+   * @param value - The pagination parameters
+   * @param value.page - The page number (typically 1-indexed)
+   * @param value.pageSize - The number of items per page
+   * @param validator - Bound validator or skip validation symbol
+   */
+  constructor(value, validator) {
+    super(value, validator);
+  }
+  /**
+   * The current page number.
+   */
+  get page() {
+    return this.value.page;
+  }
+  /**
+   * The number of items per page.
+   */
+  get pageSize() {
+    return this.value.pageSize;
+  }
+};
+
+// src/backend/core/onion-layers/domain/value-objects/base-short-text.vo.ts
+var BaseShortTextVo = class extends BaseValueObject {
+  /**
+   * Creates a new BaseShortTextVo instance.
+   *
+   * @param value - The short text string
+   * @param validator - Bound validator or skip validation symbol
+   */
+  constructor(value, validator) {
+    super(value, validator);
+  }
+};
+
+// src/backend/core/onion-layers/domain/value-objects/base-uuid-v4.vo.ts
+import { v4 } from "uuid";
+var BaseUuidV4Vo = class extends BaseValueObject {
+  /**
+   * Creates a new BaseUuidV4Vo instance.
+   *
+   * @param value - The UUID v4 string value
+   * @param validator - Bound validator or skip validation symbol
+   */
+  constructor(value, validator) {
+    super(value, validator);
+  }
+  /**
+   * Generates a new UUID v4 value object.
+   *
+   * Creates a random UUID, skipping validation since the
+   * `uuid` library guarantees format.
+   *
+   * @returns A new BaseUuidV4Vo with a freshly generated UUID
+   */
+  static generate() {
+    return new this(v4(), SKIP_VALUE_OBJECT_VALIDATION);
+  }
+  /**
+   * Creates a UUID v4 value object from an existing string.
+   *
+   * **Important:** This base implementation skips validation and accepts
+   * any string value. Subclasses should override this method with a
+   * validator to ensure UUID format correctness.
+   *
+   * @param value - The UUID v4 string value (not validated at base level)
+   * @returns A new BaseUuidV4Vo with the provided value
+   *
+   * @example Subclass with validation (recommended)
+   * ```typescript
+   * class UserId extends BaseUuidV4Vo {
+   *   static override create(value: string): UserId {
+   *     return new UserId(value, uuidV4Validator);
+   *   }
+   * }
+   * ```
+   *
+   * @see generate - For creating new UUIDs (always valid)
+   */
+  static create(value) {
+    return new this(value, SKIP_VALUE_OBJECT_VALIDATION);
+  }
+};
+
+// src/backend/core/onion-layers/domain/value-objects/base-uuid-v7.vo.ts
+import { v7 } from "uuid";
+var BaseUuidV7Vo = class extends BaseValueObject {
+  /**
+   * Creates a new BaseUuidV7Vo instance.
+   *
+   * @param value - The UUID v7 string value
+   * @param validator - Bound validator or skip validation symbol
+   */
+  constructor(value, validator) {
+    super(value, validator);
+  }
+  /**
+   * Generates a new UUID v7 value object.
+   *
+   * Creates a time-ordered UUID using the current timestamp,
+   * skipping validation since the `uuid` library guarantees format.
+   *
+   * @returns A new BaseUuidV7Vo with a freshly generated UUID
+   */
+  static generate() {
+    return new this(v7(), SKIP_VALUE_OBJECT_VALIDATION);
+  }
+  /**
+   * Creates a UUID v7 value object from an existing string.
+   *
+   * **Important:** This base implementation skips validation and accepts
+   * any string value. Subclasses should override this method with a
+   * validator to ensure UUID format correctness.
+   *
+   * @param value - The UUID v7 string value (not validated at base level)
+   * @returns A new BaseUuidV7Vo with the provided value
+   *
+   * @example Subclass with validation (recommended)
+   * ```typescript
+   * class OrderId extends BaseUuidV7Vo {
+   *   static override create(value: string): OrderId {
+   *     return new OrderId(value, uuidV7Validator);
+   *   }
+   * }
+   * ```
+   *
+   * @see generate - For creating new UUIDs (always valid)
+   */
+  static create(value) {
+    return new this(value, SKIP_VALUE_OBJECT_VALIDATION);
+  }
+};
+
+export {
+  SKIP_VALUE_OBJECT_VALIDATION,
+  BaseValueObject,
+  InvariantViolationError,
+  BaseAuditByVo,
+  BaseAuditInfoVo,
+  BaseAuditOnVo,
+  BaseEmailVo,
+  BaseLongTextVo,
+  BaseMediumTextVo,
+  BasePaginationVo,
+  BaseShortTextVo,
+  BaseUuidV4Vo,
+  BaseUuidV7Vo
+};
+//# sourceMappingURL=chunk-VCHFXT5W.js.map

package/dist/chunk-VCHFXT5W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/backend/core/onion-layers/domain/classes/base-value-object.class.ts","../src/backend/core/onion-layers/domain/exceptions/invariant-violation.error.ts","../src/backend/core/onion-layers/domain/value-objects/base-audit-by.vo.ts","../src/backend/core/onion-layers/domain/value-objects/base-audit-info.vo.ts","../src/backend/core/onion-layers/domain/value-objects/base-audit-on.vo.ts","../src/backend/core/onion-layers/domain/value-objects/base-email.vo.ts","../src/backend/core/onion-layers/domain/value-objects/base-long-text.vo.ts","../src/backend/core/onion-layers/domain/value-objects/base-medium-text.vo.ts","../src/backend/core/onion-layers/domain/value-objects/base-pagination.vo.ts","../src/backend/core/onion-layers/domain/value-objects/base-short-text.vo.ts","../src/backend/core/onion-layers/domain/value-objects/base-uuid-v4.vo.ts","../src/backend/core/onion-layers/domain/value-objects/base-uuid-v7.vo.ts"],"sourcesContent":["import type { BoundValidator } from '../../../global/interfaces/ports/object-validator.port';\n\n/**\n * Sentinel value to skip validation in Value Object constructors.\n *\n * Use this when creating a Value Object from already-validated data,\n * such as when reconstituting from a database or creating derived VOs.\n *\n * @example\n * ```typescript\n * // In a VO that wraps a validated value\n * class Email extends BaseValueObject<string> {\n *   private constructor(value: string, validator: BoundValidator<string> | SkipValueObjectValidation) {\n *     super(value, validator);\n *   }\n *\n *   // Public factory validates\n *   static create(value: string): Email {\n *     return new Email(value, emailValidator);\n *   }\n *\n *   // Internal factory skips validation (data already validated)\n *   static fromPersistence(value: string): Email {\n *     return new Email(value, SKIP_VALUE_OBJECT_VALIDATION);\n *   }\n * }\n * ```\n */\nexport const SKIP_VALUE_OBJECT_VALIDATION = 'skip value object validation' as const;\n\n/** Type for the skip validation sentinel. */\nexport type SkipValueObjectValidation = typeof SKIP_VALUE_OBJECT_VALIDATION;\n\n/**\n * Deep equality comparison for value objects.\n * Handles primitives, Dates, Arrays, and nested Objects.\n * @internal\n */\nfunction deepEquals(a: unknown, b: unknown): boolean {\n  // Same reference or both primitives with same value\n  if (a === b) return true;\n\n  // Handle null/undefined\n  if (a === null || a === undefined || b === null || b === undefined) {\n    return a === b;\n  }\n\n  // Handle Date objects\n  if (a instanceof Date && b instanceof Date) {\n    return a.getTime() === b.getTime();\n  }\n\n  // Handle Arrays\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false;\n    return a.every((item, index) => deepEquals(item, b[index]));\n  }\n\n  // Handle Objects\n  if (typeof a === 'object' && typeof b === 'object') {\n    const aObj = a as Record<string, unknown>;\n    const bObj = b as Record<string, unknown>;\n\n    const aKeys = Object.keys(aObj);\n    const bKeys = Object.keys(bObj);\n\n    if (aKeys.length !== bKeys.length) return false;\n\n    return aKeys.every((key) => deepEquals(aObj[key], bObj[key]));\n  }\n\n  // Different types or values\n  return false;\n}\n\n/**\n * Base class for Domain-Driven Design Value Objects.\n *\n * Value Objects are immutable domain primitives that are compared by value,\n * not by reference. They encapsulate validation and domain logic for\n * primitive concepts like Email, Money, Address, etc.\n *\n * Key characteristics:\n * - **Immutable**: Value cannot be changed after construction\n * - **Equality by value**: Two VOs with the same value are considered equal\n * - **Self-validating**: Validation runs at construction time\n *\n * @typeParam T - The underlying value type\n *\n * @example\n * ```typescript\n * class Email extends BaseValueObject<string> {\n *   private constructor(value: string, validator: BoundValidator<string> | SkipValueObjectValidation) {\n *     super(value, validator);\n *   }\n *\n *   static create(value: string): Email {\n *     return new Email(value, emailValidator);\n *   }\n *\n *   get domain(): string {\n *     return this.value.split('@')[1];\n *   }\n * }\n *\n * const email1 = Email.create('user@example.com');\n * const email2 = Email.create('user@example.com');\n * email1.equals(email2); // true\n * ```\n */\nexport class BaseValueObject<T> {\n  private readonly _value: T;\n\n  /**\n   * Creates a new Value Object instance.\n   *\n   * @param value - The raw value to wrap\n   * @param validator - A bound validator or SKIP_VALUE_OBJECT_VALIDATION to bypass\n   * @throws {ObjectValidationError} When validation fails\n   */\n  protected constructor(\n    value: T,\n    validator: BoundValidator<T> | typeof SKIP_VALUE_OBJECT_VALIDATION,\n  ) {\n    this._value = validator === SKIP_VALUE_OBJECT_VALIDATION ? value : validator.validate(value);\n  }\n\n  /**\n   * Compares this Value Object with another for equality.\n   *\n   * Uses deep equality comparison to handle nested objects, arrays, and dates.\n   * Two Value Objects are equal if their underlying values are deeply equal.\n   *\n   * @param other - The Value Object to compare with\n   * @returns `true` if the values are deeply equal, `false` otherwise\n   */\n  public equals(other: BaseValueObject<T>): boolean {\n    // Fast path: same reference\n    if (this === other) return true;\n\n    // Deep equality comparison\n    return deepEquals(this.value, other.value);\n  }\n\n  /**\n   * The underlying immutable value.\n   *\n   * @returns The wrapped value of type T\n   */\n  public get value(): T {\n    return this._value;\n  }\n}\n","import { ErrorCodes, type DomainErrorCode } from '../../../global/exceptions/error-codes.const';\nimport { DomainError } from './domain.error';\n\n/**\n * Error thrown when a domain invariant is violated.\n *\n * Invariants are business rules that must always be true. This error\n * indicates a programming error or corrupted state—if inputs are\n * properly validated, this should never occur in production.\n *\n * **When to throw:**\n * - Business rule violations (e.g., `updatedAt < createdAt`)\n * - Assert-style guards in domain logic\n * - Invalid state transitions\n *\n * @example\n * ```typescript\n * if (order.status === 'shipped' && order.items.length === 0) {\n *   throw new InvariantViolationError({\n *     message: 'Shipped order must have at least one item',\n *     code: 'EMPTY_SHIPPED_ORDER',\n *   });\n * }\n * ```\n *\n * @extends DomainError\n */\nexport class InvariantViolationError extends DomainError {\n  /**\n   * Creates a new InvariantViolationError instance.\n   *\n   * @param options - Error configuration\n   * @param options.message - Description of the violated invariant\n   * @param options.code - Machine-readable error code (default: 'INVARIANT_VIOLATION')\n   * @param options.cause - Optional underlying error\n   */\n  constructor({\n    message,\n    code = ErrorCodes.Domain.INVARIANT_VIOLATION,\n    cause,\n  }: {\n    message: string;\n    code?: DomainErrorCode | string;\n    cause?: unknown;\n  }) {\n    super({ message, code, cause });\n  }\n\n  /**\n   * Creates an InvariantViolationError from a caught error.\n   *\n   * @param cause - The original caught error\n   * @returns A new InvariantViolationError instance with the cause attached\n   */\n  static override fromError(cause: unknown): InvariantViolationError {\n    return new InvariantViolationError({\n      message: cause instanceof Error ? cause.message : 'Invariant violation',\n      cause,\n    });\n  }\n}\n","/**\n * Base audit user tracking value object.\n *\n * Tracks which user created and last updated an entity. User IDs are\n * optional to support system-initiated operations where no user context\n * is available.\n *\n * @example Extending for a validator-specific implementation\n * ```typescript\n * class AuditByVo extends BaseAuditByVo {\n *   static create(opts?: {\n *     createdBy?: UuidV4Vo;\n *     updatedBy?: UuidV4Vo;\n *   }): AuditByVo {\n *     return new AuditByVo({\n *       createdBy: opts?.createdBy,\n *       updatedBy: opts?.updatedBy ?? opts?.createdBy,\n *     }, SKIP_VALUE_OBJECT_VALIDATION);\n *   }\n *\n *   update(updatedBy: UuidV4Vo): AuditByVo {\n *     return new AuditByVo({\n *       createdBy: this.createdBy,\n *       updatedBy,\n *     }, SKIP_VALUE_OBJECT_VALIDATION);\n *   }\n * }\n * ```\n */\nimport type { BoundValidator } from '../../../global/interfaces/ports/object-validator.port';\nimport type { SkipValueObjectValidation } from '../classes/base-value-object.class';\nimport { BaseValueObject } from '../classes/base-value-object.class';\nimport type { BaseUuidV4Vo } from './base-uuid-v4.vo';\n\n/**\n * Abstract base class for audit user tracking value objects.\n *\n * @extends BaseValueObject\n */\nexport abstract class BaseAuditByVo extends BaseValueObject<{\n  createdBy?: BaseUuidV4Vo;\n  updatedBy?: BaseUuidV4Vo;\n}> {\n  /**\n   * Creates a new BaseAuditByVo instance.\n   *\n   * @param value - The user tracking values\n   * @param value.createdBy - User who created the entity (optional for system ops)\n   * @param value.updatedBy - User who last updated the entity (optional)\n   * @param validator - Bound validator or skip validation symbol\n   */\n  protected constructor(\n    value: { createdBy?: BaseUuidV4Vo; updatedBy?: BaseUuidV4Vo },\n    validator:\n      | BoundValidator<{ createdBy?: BaseUuidV4Vo; updatedBy?: BaseUuidV4Vo }>\n      | SkipValueObjectValidation,\n  ) {\n    super(value, validator);\n  }\n\n  /**\n   * Creates a new audit user tracking with updated user ID.\n   *\n   * @param updatedBy - The user ID performing the update\n   * @returns A new immutable audit user tracking instance\n   */\n  abstract update(updatedBy: BaseUuidV4Vo): BaseAuditByVo;\n\n  /**\n   * The user ID who created the entity.\n   * Returns `undefined` for system-created entities.\n   */\n  get createdBy(): BaseUuidV4Vo | undefined {\n    return this.value.createdBy;\n  }\n\n  /**\n   * The user ID who last updated the entity.\n   * Returns `undefined` for system-updated entities.\n   */\n  get updatedBy(): BaseUuidV4Vo | undefined {\n    return this.value.updatedBy;\n  }\n}\n","/**\n * Base audit info value object for entity tracking.\n *\n * Composite value object that combines timestamp tracking ({@link BaseAuditOnVo})\n * and user tracking ({@link BaseAuditByVo}) into a single immutable audit record.\n * Used for tracking entity creation and modification history.\n *\n * **Composition:**\n * - `on`: {@link BaseAuditOnVo} - timestamps (createdAt, updatedAt)\n * - `by`: {@link BaseAuditByVo} - user IDs (createdBy, updatedBy)\n *\n * **Immutability:**\n * Date getters return cloned Date objects to prevent external mutation.\n *\n * @example Extending for a validator-specific implementation\n * ```typescript\n * class AuditInfoVo extends BaseAuditInfoVo {\n *   static create(createdBy?: UuidV4Vo): AuditInfoVo {\n *     const now = new Date();\n *     return new AuditInfoVo({\n *       by: AuditByVo.create({ createdBy, updatedBy: createdBy }),\n *       on: AuditOnVo.create({ createdAt: now, updatedAt: now }),\n *     }, SKIP_VALUE_OBJECT_VALIDATION);\n *   }\n *\n *   update(updatedBy: UuidV4Vo): AuditInfoVo {\n *     return new AuditInfoVo({\n *       by: this.value.by.update(updatedBy),\n *       on: this.value.on.update(),\n *     }, SKIP_VALUE_OBJECT_VALIDATION);\n *   }\n * }\n * ```\n *\n * @example Using with an entity\n * ```typescript\n * class User {\n *   constructor(\n *     public readonly id: UuidV7Vo,\n *     public readonly name: string,\n *     public readonly audit: AuditInfoVo,\n *   ) {}\n *\n *   updateName(name: string, updatedBy: UuidV4Vo): User {\n *     return new User(this.id, name, this.audit.update(updatedBy));\n *   }\n * }\n * ```\n */\nimport type { BoundValidator } from '../../../global/interfaces/ports/object-validator.port';\nimport type { SkipValueObjectValidation } from '../classes/base-value-object.class';\nimport { BaseValueObject } from '../classes/base-value-object.class';\nimport type { BaseAuditByVo } from './base-audit-by.vo';\nimport type { BaseAuditOnVo } from './base-audit-on.vo';\nimport type { BaseUuidV4Vo } from './base-uuid-v4.vo';\n\n/**\n * Abstract base class for audit information value objects.\n *\n * Extend this class and implement the `update()` method with your\n * validator-specific child VOs.\n *\n * @extends BaseValueObject\n */\nexport abstract class BaseAuditInfoVo extends BaseValueObject<{\n  by: BaseAuditByVo;\n  on: BaseAuditOnVo;\n}> {\n  /**\n   * Creates a new BaseAuditInfoVo instance.\n   *\n   * @param value - Composite value containing audit by and on VOs\n   * @param value.by - User tracking value object\n   * @param value.on - Timestamp tracking value object\n   * @param validator - Bound validator or skip validation symbol\n   */\n  protected constructor(\n    value: { by: BaseAuditByVo; on: BaseAuditOnVo },\n    validator: BoundValidator<{ by: BaseAuditByVo; on: BaseAuditOnVo }> | SkipValueObjectValidation,\n  ) {\n    super(value, validator);\n  }\n\n  /**\n   * Creates a new audit info with updated timestamp and user.\n   *\n   * @param updatedBy - The user ID performing the update\n   * @returns A new immutable audit info instance\n   */\n  abstract update(updatedBy: BaseUuidV4Vo): BaseAuditInfoVo;\n\n  /**\n   * The user ID who created the entity.\n   * Returns `undefined` for system-created entities.\n   */\n  get createdBy(): BaseUuidV4Vo | undefined {\n    return this.value.by.createdBy;\n  }\n\n  /**\n   * The timestamp when the entity was created.\n   * Returns a cloned Date to prevent mutation.\n   */\n  get createdAt(): Date {\n    return new Date(this.value.on.createdAt.getTime());\n  }\n\n  /**\n   * The user ID who last updated the entity.\n   * Returns `undefined` for system-updated entities.\n   */\n  get updatedBy(): BaseUuidV4Vo | undefined {\n    return this.value.by.updatedBy;\n  }\n\n  /**\n   * The timestamp when the entity was last updated.\n   * Returns a cloned Date to prevent mutation.\n   */\n  get updatedAt(): Date {\n    return new Date(this.value.on.updatedAt.getTime());\n  }\n\n  /**\n   * Whether the entity has been modified since creation.\n   *\n   * Compares both timestamps and user IDs. Returns `true` if either:\n   * - The updatedAt timestamp differs from createdAt\n   * - The updatedBy user differs from createdBy\n   *\n   * Note: When both createdBy and updatedBy are undefined (system-created\n   * entities), this correctly returns false for the user comparison.\n   */\n  get isModified(): boolean {\n    const timestampChanged = this.updatedAt.getTime() !== this.createdAt.getTime();\n    const userChanged = this.updatedBy?.value !== this.createdBy?.value;\n    return timestampChanged || userChanged;\n  }\n\n  /**\n   * Alias for `updatedBy` for semantic clarity.\n   */\n  get lastModifiedBy(): BaseUuidV4Vo | undefined {\n    return this.updatedBy;\n  }\n\n  /**\n   * Alias for `updatedAt` for semantic clarity.\n   */\n  get lastModifiedAt(): Date {\n    return this.updatedAt;\n  }\n}\n","/**\n * Base audit timestamp value object.\n *\n * Tracks when an entity was created and last updated. Enforces the\n * domain invariant that `updatedAt` cannot be earlier than `createdAt`.\n *\n * **Domain Invariant:**\n * The constructor throws {@link InvariantViolationError} if\n * `updatedAt < createdAt`, ensuring timestamps are always valid.\n *\n * **Immutability:**\n * Date getters return cloned Date objects to prevent external mutation.\n *\n * @example Extending for a validator-specific implementation\n * ```typescript\n * class AuditOnVo extends BaseAuditOnVo {\n *   static create(opts?: { createdAt?: Date; updatedAt?: Date }): AuditOnVo {\n *     const now = new Date();\n *     return new AuditOnVo({\n *       createdAt: opts?.createdAt ?? now,\n *       updatedAt: opts?.updatedAt ?? now,\n *     }, SKIP_VALUE_OBJECT_VALIDATION);\n *   }\n *\n *   update(): AuditOnVo {\n *     return new AuditOnVo({\n *       createdAt: this.createdAt,\n *       updatedAt: new Date(),\n *     }, SKIP_VALUE_OBJECT_VALIDATION);\n *   }\n * }\n * ```\n */\nimport type { BoundValidator } from '../../../global/interfaces/ports/object-validator.port';\nimport type { SkipValueObjectValidation } from '../classes/base-value-object.class';\nimport { BaseValueObject } from '../classes/base-value-object.class';\nimport { InvariantViolationError } from '../exceptions/invariant-violation.error';\n\n/**\n * Abstract base class for audit timestamp value objects.\n *\n * @extends BaseValueObject\n * @throws {InvariantViolationError} When `updatedAt` is earlier than `createdAt`\n */\nexport abstract class BaseAuditOnVo extends BaseValueObject<{\n  createdAt: Date;\n  updatedAt: Date;\n}> {\n  /**\n   * Creates a new BaseAuditOnVo instance.\n   *\n   * @param value - The timestamp values\n   * @param value.createdAt - When the entity was created\n   * @param value.updatedAt - When the entity was last updated\n   * @param validator - Bound validator or skip validation symbol\n   * @throws {InvariantViolationError} When `updatedAt < createdAt`\n   */\n  protected constructor(\n    value: { createdAt: Date; updatedAt: Date },\n    validator: BoundValidator<{ createdAt: Date; updatedAt: Date }> | SkipValueObjectValidation,\n  ) {\n    // Domain enforces its own invariant\n    if (value.updatedAt < value.createdAt) {\n      throw new InvariantViolationError({\n        message: 'UpdatedAt cannot be earlier than createdAt',\n        code: 'INVALID_AUDIT_TIMESTAMPS',\n      });\n    }\n    super(value, validator);\n  }\n\n  /**\n   * Creates a new audit timestamp with current time as updatedAt.\n   *\n   * @returns A new immutable audit timestamp instance\n   */\n  abstract update(): BaseAuditOnVo;\n\n  /**\n   * When the entity was created.\n   * Returns a cloned Date to prevent mutation.\n   */\n  get createdAt(): Date {\n    return new Date(this.value.createdAt);\n  }\n\n  /**\n   * When the entity was last updated.\n   * Returns a cloned Date to prevent mutation.\n   */\n  get updatedAt(): Date {\n    return new Date(this.value.updatedAt);\n  }\n}\n","/**\n * Base email value object.\n *\n * Represents a validated email address. Extend this class and provide\n * a validator that enforces email format rules.\n *\n * @example Extending with Zod validation\n * ```typescript\n * import { z } from 'zod';\n * import { createZodValidator } from '@cosmneo/onion-lasagna/backend/core/validators/zod';\n *\n * const emailSchema = z.string().email();\n * const emailValidator = createZodValidator(emailSchema);\n *\n * class EmailVo extends BaseEmailVo {\n *   static create(value: string): EmailVo {\n *     return new EmailVo(value, emailValidator);\n *   }\n * }\n * ```\n *\n * @example Usage\n * ```typescript\n * const email = EmailVo.create('user@example.com');\n * console.log(email.value); // \"user@example.com\"\n * ```\n */\nimport type { BoundValidator } from '../../../global/interfaces/ports/object-validator.port';\nimport type { SKIP_VALUE_OBJECT_VALIDATION } from '../classes/base-value-object.class';\nimport { BaseValueObject } from '../classes/base-value-object.class';\n\n/**\n * Value object for email addresses.\n *\n * @extends BaseValueObject<string>\n */\nexport class BaseEmailVo extends BaseValueObject<string> {\n  /**\n   * Creates a new BaseEmailVo instance.\n   *\n   * @param value - The email address string\n   * @param validator - Bound validator or skip validation symbol\n   */\n  protected constructor(\n    value: string,\n    validator: BoundValidator<string> | typeof SKIP_VALUE_OBJECT_VALIDATION,\n  ) {\n    super(value, validator);\n  }\n}\n","/**\n * Base long text value object.\n *\n * Represents long-form text fields like articles, content bodies, or notes.\n * Typically validated with a maximum length constraint (e.g., 5000+ chars).\n *\n * **Suggested Length:** 1-5000+ characters\n *\n * **Use Cases:**\n * - Article content\n * - Blog posts\n * - Detailed notes\n * - Rich text content\n *\n * @example Extending with length validation\n * ```typescript\n * import { z } from 'zod';\n * import { createZodValidator } from '@cosmneo/onion-lasagna/backend/core/validators/zod';\n *\n * const longTextSchema = z.string().min(1).max(10000);\n * const longTextValidator = createZodValidator(longTextSchema);\n *\n * class ArticleContentVo extends BaseLongTextVo {\n *   static create(value: string): ArticleContentVo {\n *     return new ArticleContentVo(value, longTextValidator);\n *   }\n * }\n * ```\n */\nimport type { BoundValidator } from '../../../global/interfaces/ports/object-validator.port';\nimport type { SKIP_VALUE_OBJECT_VALIDATION } from '../classes/base-value-object.class';\nimport { BaseValueObject } from '../classes/base-value-object.class';\n\n/**\n * Value object for long-form text strings.\n *\n * @extends BaseValueObject<string>\n */\nexport class BaseLongTextVo extends BaseValueObject<string> {\n  /**\n   * Creates a new BaseLongTextVo instance.\n   *\n   * @param value - The long text string\n   * @param validator - Bound validator or skip validation symbol\n   */\n  protected constructor(\n    value: string,\n    validator: BoundValidator<string> | typeof SKIP_VALUE_OBJECT_VALIDATION,\n  ) {\n    super(value, validator);\n  }\n}\n","/**\n * Base medium text value object.\n *\n * Represents medium-length text fields like descriptions or summaries.\n * Typically validated with a maximum length constraint (e.g., 500 chars).\n *\n * **Suggested Length:** 1-500 characters\n *\n * **Use Cases:**\n * - Product descriptions\n * - User bios\n * - Short summaries\n * - Comments\n *\n * @example Extending with length validation\n * ```typescript\n * import { z } from 'zod';\n * import { createZodValidator } from '@cosmneo/onion-lasagna/backend/core/validators/zod';\n *\n * const mediumTextSchema = z.string().min(1).max(500);\n * const mediumTextValidator = createZodValidator(mediumTextSchema);\n *\n * class DescriptionVo extends BaseMediumTextVo {\n *   static create(value: string): DescriptionVo {\n *     return new DescriptionVo(value, mediumTextValidator);\n *   }\n * }\n * ```\n */\nimport type { BoundValidator } from '../../../global/interfaces/ports/object-validator.port';\nimport type { SKIP_VALUE_OBJECT_VALIDATION } from '../classes/base-value-object.class';\nimport { BaseValueObject } from '../classes/base-value-object.class';\n\n/**\n * Value object for medium-length text strings.\n *\n * @extends BaseValueObject<string>\n */\nexport class BaseMediumTextVo extends BaseValueObject<string> {\n  /**\n   * Creates a new BaseMediumTextVo instance.\n   *\n   * @param value - The medium text string\n   * @param validator - Bound validator or skip validation symbol\n   */\n  protected constructor(\n    value: string,\n    validator: BoundValidator<string> | typeof SKIP_VALUE_OBJECT_VALIDATION,\n  ) {\n    super(value, validator);\n  }\n}\n","/**\n * Base pagination value object.\n *\n * Represents pagination parameters for list queries. Validates that\n * page numbers and page sizes are positive integers within bounds.\n *\n * **Properties:**\n * - `page`: The current page number (typically 1-indexed)\n * - `pageSize`: Number of items per page\n *\n * @example Extending with validation\n * ```typescript\n * import { z } from 'zod';\n * import { createZodValidator } from '@cosmneo/onion-lasagna/backend/core/validators/zod';\n *\n * const paginationSchema = z.object({\n *   page: z.number().int().min(1),\n *   pageSize: z.number().int().min(1).max(100),\n * });\n * const paginationValidator = createZodValidator(paginationSchema);\n *\n * class PaginationVo extends BasePaginationVo {\n *   static create(page: number, pageSize: number): PaginationVo {\n *     return new PaginationVo({ page, pageSize }, paginationValidator);\n *   }\n * }\n * ```\n *\n * @example Usage in a use case\n * ```typescript\n * class ListUsersUseCase {\n *   async execute(pagination: PaginationVo): Promise<User[]> {\n *     const offset = (pagination.page - 1) * pagination.pageSize;\n *     return this.userRepo.findAll({\n *       offset,\n *       limit: pagination.pageSize,\n *     });\n *   }\n * }\n * ```\n */\nimport type { BoundValidator } from '../../../global/interfaces/ports/object-validator.port';\nimport type { SKIP_VALUE_OBJECT_VALIDATION } from '../classes/base-value-object.class';\nimport { BaseValueObject } from '../classes/base-value-object.class';\n\n/**\n * Value object for pagination parameters.\n *\n * @extends BaseValueObject<{ page: number; pageSize: number }>\n */\nexport class BasePaginationVo extends BaseValueObject<{ page: number; pageSize: number }> {\n  /**\n   * Creates a new BasePaginationVo instance.\n   *\n   * @param value - The pagination parameters\n   * @param value.page - The page number (typically 1-indexed)\n   * @param value.pageSize - The number of items per page\n   * @param validator - Bound validator or skip validation symbol\n   */\n  protected constructor(\n    value: { page: number; pageSize: number },\n    validator:\n      | BoundValidator<{ page: number; pageSize: number }>\n      | typeof SKIP_VALUE_OBJECT_VALIDATION,\n  ) {\n    super(value, validator);\n  }\n\n  /**\n   * The current page number.\n   */\n  get page(): number {\n    return this.value.page;\n  }\n\n  /**\n   * The number of items per page.\n   */\n  get pageSize(): number {\n    return this.value.pageSize;\n  }\n}\n","/**\n * Base short text value object.\n *\n * Represents short text fields like names, titles, or labels.\n * Typically validated with a maximum length constraint (e.g., 100 chars).\n *\n * **Suggested Length:** 1-100 characters\n *\n * **Use Cases:**\n * - User names\n * - Product titles\n * - Category names\n * - Short labels\n *\n * @example Extending with length validation\n * ```typescript\n * import { z } from 'zod';\n * import { createZodValidator } from '@cosmneo/onion-lasagna/backend/core/validators/zod';\n *\n * const shortTextSchema = z.string().min(1).max(100);\n * const shortTextValidator = createZodValidator(shortTextSchema);\n *\n * class UserNameVo extends BaseShortTextVo {\n *   static create(value: string): UserNameVo {\n *     return new UserNameVo(value, shortTextValidator);\n *   }\n * }\n * ```\n */\nimport type { BoundValidator } from '../../../global/interfaces/ports/object-validator.port';\nimport type { SKIP_VALUE_OBJECT_VALIDATION } from '../classes/base-value-object.class';\nimport { BaseValueObject } from '../classes/base-value-object.class';\n\n/**\n * Value object for short text strings.\n *\n * @extends BaseValueObject<string>\n */\nexport class BaseShortTextVo extends BaseValueObject<string> {\n  /**\n   * Creates a new BaseShortTextVo instance.\n   *\n   * @param value - The short text string\n   * @param validator - Bound validator or skip validation symbol\n   */\n  protected constructor(\n    value: string,\n    validator: BoundValidator<string> | typeof SKIP_VALUE_OBJECT_VALIDATION,\n  ) {\n    super(value, validator);\n  }\n}\n","/**\n * Base UUID v4 value object for random entity identifiers.\n *\n * UUID v4 is a randomly generated UUID, suitable for identifiers where\n * time-ordering is not required. For time-sortable IDs, use {@link BaseUuidV7Vo}.\n *\n * **Use Cases:**\n * - User IDs (for audit tracking)\n * - Session tokens\n * - Correlation IDs\n * - Any identifier where time-ordering doesn't matter\n *\n * @example Generating a new ID\n * ```typescript\n * const id = BaseUuidV4Vo.generate();\n * console.log(id.value); // e.g., \"550e8400-e29b-41d4-a716-446655440000\"\n * ```\n *\n * @example Extending for validation\n * ```typescript\n * class UserIdVo extends BaseUuidV4Vo {\n *   static create(value: string): UserIdVo {\n *     return new UserIdVo(value, uuidValidator);\n *   }\n *\n *   static generate(): UserIdVo {\n *     return new UserIdVo(v4(), SKIP_VALUE_OBJECT_VALIDATION);\n *   }\n * }\n * ```\n */\nimport type { BoundValidator } from '../../../global/interfaces/ports/object-validator.port';\nimport { BaseValueObject, SKIP_VALUE_OBJECT_VALIDATION } from '../classes/base-value-object.class';\nimport { v4 } from 'uuid';\n\n/**\n * Value object for UUID v4 identifiers.\n *\n * Provides a `generate()` factory method that creates new random UUIDs.\n *\n * @extends BaseValueObject<string>\n */\nexport class BaseUuidV4Vo extends BaseValueObject<string> {\n  /**\n   * Creates a new BaseUuidV4Vo instance.\n   *\n   * @param value - The UUID v4 string value\n   * @param validator - Bound validator or skip validation symbol\n   */\n  protected constructor(\n    value: string,\n    validator: BoundValidator<string> | typeof SKIP_VALUE_OBJECT_VALIDATION,\n  ) {\n    super(value, validator);\n  }\n\n  /**\n   * Generates a new UUID v4 value object.\n   *\n   * Creates a random UUID, skipping validation since the\n   * `uuid` library guarantees format.\n   *\n   * @returns A new BaseUuidV4Vo with a freshly generated UUID\n   */\n  static generate(): BaseUuidV4Vo {\n    return new this(v4(), SKIP_VALUE_OBJECT_VALIDATION);\n  }\n\n  /**\n   * Creates a UUID v4 value object from an existing string.\n   *\n   * **Important:** This base implementation skips validation and accepts\n   * any string value. Subclasses should override this method with a\n   * validator to ensure UUID format correctness.\n   *\n   * @param value - The UUID v4 string value (not validated at base level)\n   * @returns A new BaseUuidV4Vo with the provided value\n   *\n   * @example Subclass with validation (recommended)\n   * ```typescript\n   * class UserId extends BaseUuidV4Vo {\n   *   static override create(value: string): UserId {\n   *     return new UserId(value, uuidV4Validator);\n   *   }\n   * }\n   * ```\n   *\n   * @see generate - For creating new UUIDs (always valid)\n   */\n  static create(value: string): BaseUuidV4Vo {\n    return new this(value, SKIP_VALUE_OBJECT_VALIDATION);\n  }\n}\n","/**\n * Base UUID v7 value object for time-sortable entity identifiers.\n *\n * UUID v7 is a time-ordered UUID that combines a Unix timestamp with\n * random bits, making it ideal for database primary keys because:\n *\n * **Benefits:**\n * - **Time-sortable**: IDs created later sort after earlier ones\n * - **Database-friendly**: Sequential nature reduces B-tree fragmentation\n * - **Globally unique**: Same uniqueness guarantees as other UUID versions\n * - **Timestamp extractable**: Creation time can be derived from the ID\n *\n * @example Generating a new ID\n * ```typescript\n * const id = BaseUuidV7Vo.generate();\n * console.log(id.value); // e.g., \"018f3b1c-5e7d-7000-8000-000000000001\"\n * ```\n *\n * @example Extending for validation\n * ```typescript\n * class EntityIdVo extends BaseUuidV7Vo {\n *   static create(value: string): EntityIdVo {\n *     return new EntityIdVo(value, uuidValidator);\n *   }\n *\n *   static generate(): EntityIdVo {\n *     return new EntityIdVo(v7(), SKIP_VALUE_OBJECT_VALIDATION);\n *   }\n * }\n * ```\n *\n * @example Using as entity primary key\n * ```typescript\n * class User {\n *   constructor(\n *     public readonly id: EntityIdVo,\n *     public readonly name: string,\n *   ) {}\n *\n *   static create(name: string): User {\n *     return new User(EntityIdVo.generate(), name);\n *   }\n * }\n * ```\n */\nimport type { BoundValidator } from '../../../global/interfaces/ports/object-validator.port';\nimport { BaseValueObject, SKIP_VALUE_OBJECT_VALIDATION } from '../classes/base-value-object.class';\nimport { v7 } from 'uuid';\n\n/**\n * Value object for UUID v7 identifiers.\n *\n * Provides a `generate()` factory method that creates new time-ordered UUIDs.\n *\n * @extends BaseValueObject<string>\n */\nexport class BaseUuidV7Vo extends BaseValueObject<string> {\n  /**\n   * Creates a new BaseUuidV7Vo instance.\n   *\n   * @param value - The UUID v7 string value\n   * @param validator - Bound validator or skip validation symbol\n   */\n  protected constructor(\n    value: string,\n    validator: BoundValidator<string> | typeof SKIP_VALUE_OBJECT_VALIDATION,\n  ) {\n    super(value, validator);\n  }\n\n  /**\n   * Generates a new UUID v7 value object.\n   *\n   * Creates a time-ordered UUID using the current timestamp,\n   * skipping validation since the `uuid` library guarantees format.\n   *\n   * @returns A new BaseUuidV7Vo with a freshly generated UUID\n   */\n  static generate(): BaseUuidV7Vo {\n    return new this(v7(), SKIP_VALUE_OBJECT_VALIDATION);\n  }\n\n  /**\n   * Creates a UUID v7 value object from an existing string.\n   *\n   * **Important:** This base implementation skips validation and accepts\n   * any string value. Subclasses should override this method with a\n   * validator to ensure UUID format correctness.\n   *\n   * @param value - The UUID v7 string value (not validated at base level)\n   * @returns A new BaseUuidV7Vo with the provided value\n   *\n   * @example Subclass with validation (recommended)\n   * ```typescript\n   * class OrderId extends BaseUuidV7Vo {\n   *   static override create(value: string): OrderId {\n   *     return new OrderId(value, uuidV7Validator);\n   *   }\n   * }\n   * ```\n   *\n   * @see generate - For creating new UUIDs (always valid)\n   */\n  static create(value: string): BaseUuidV7Vo {\n    return new this(value, SKIP_VALUE_OBJECT_VALIDATION);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-ZWLYNGO3.js

@@ -0,0 +1,40 @@
+import {
+  CodedError,
+  ErrorCodes
+} from "./chunk-MQD5GXMT.js";
+
+// src/backend/core/onion-layers/domain/exceptions/domain.error.ts
+var DomainError = class _DomainError extends CodedError {
+  /**
+   * Creates a new DomainError instance.
+   *
+   * @param options - Error configuration
+   * @param options.message - Human-readable error description
+   * @param options.code - Machine-readable error code (default: 'DOMAIN_ERROR')
+   * @param options.cause - Optional underlying error
+   */
+  constructor({
+    message,
+    code = ErrorCodes.Domain.DOMAIN_ERROR,
+    cause
+  }) {
+    super({ message, code, cause });
+  }
+  /**
+   * Creates a DomainError from a caught error.
+   *
+   * @param cause - The original caught error
+   * @returns A new DomainError instance with the cause attached
+   */
+  static fromError(cause) {
+    return new _DomainError({
+      message: cause instanceof Error ? cause.message : "Domain error",
+      cause
+    });
+  }
+};
+
+export {
+  DomainError
+};
+//# sourceMappingURL=chunk-ZWLYNGO3.js.map

package/dist/chunk-ZWLYNGO3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/backend/core/onion-layers/domain/exceptions/domain.error.ts"],"sourcesContent":["import { CodedError } from '../../../global/exceptions/coded-error.error';\nimport { ErrorCodes, type DomainErrorCode } from '../../../global/exceptions/error-codes.const';\n\n/**\n * Base error class for domain layer failures.\n *\n * Domain errors represent violations of business rules, invariants,\n * or aggregate consistency. They originate from the core domain logic\n * and should be caught and handled by the application layer.\n *\n * **When to throw:**\n * - Business rule violations (e.g., \"Cannot withdraw more than balance\")\n * - Invariant violations (e.g., \"Email format invalid\")\n * - Aggregate consistency failures\n *\n * **Child classes:**\n * - {@link InvariantViolationError} - Value object or entity invariant failures\n * - {@link PartialLoadError} - Incomplete aggregate reconstitution\n *\n * @example\n * ```typescript\n * if (account.balance < amount) {\n *   throw new DomainError({\n *     message: 'Insufficient funds for withdrawal',\n *     code: 'INSUFFICIENT_FUNDS',\n *   });\n * }\n * ```\n */\nexport class DomainError extends CodedError {\n  /**\n   * Creates a new DomainError instance.\n   *\n   * @param options - Error configuration\n   * @param options.message - Human-readable error description\n   * @param options.code - Machine-readable error code (default: 'DOMAIN_ERROR')\n   * @param options.cause - Optional underlying error\n   */\n  constructor({\n    message,\n    code = ErrorCodes.Domain.DOMAIN_ERROR,\n    cause,\n  }: {\n    message: string;\n    code?: DomainErrorCode | string;\n    cause?: unknown;\n  }) {\n    super({ message, code, cause });\n  }\n\n  /**\n   * Creates a DomainError from a caught error.\n   *\n   * @param cause - The original caught error\n   * @returns A new DomainError instance with the cause attached\n   */\n  static override fromError(cause: unknown): DomainError {\n    return new DomainError({\n      message: cause instanceof Error ? cause.message : 'Domain error',\n      cause,\n    });\n  }\n}\n"],"mappings":";;;;;;AA6BO,IAAM,cAAN,MAAM,qBAAoB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS1C,YAAY;AAAA,IACV;AAAA,IACA,OAAO,WAAW,OAAO;AAAA,IACzB;AAAA,EACF,GAIG;AACD,UAAM,EAAE,SAAS,MAAM,MAAM,CAAC;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAgB,UAAU,OAA6B;AACrD,WAAO,IAAI,aAAY;AAAA,MACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,MAClD;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/http-response-BAhi8lF4.d.cts

@@ -0,0 +1,124 @@
+/**
+ * Base controller interface for the presentation layer.
+ *
+ * All controllers must implement this interface. The {@link BaseController} class
+ * provides a standard request/response pipeline implementation.
+ *
+ * @typeParam TInput - The input type the controller accepts
+ * @typeParam TOutput - The output type the controller returns
+ *
+ * @example Using BaseController (recommended)
+ * ```typescript
+ * const controller = BaseController.create({
+ *   requestMapper: (req) => CreateUserInputDto.create(req.body),
+ *   useCase: createUserUseCase,
+ *   responseMapper: (output) => ({ statusCode: 201, body: output.value }),
+ * });
+ * ```
+ *
+ * @example Custom implementation
+ * ```typescript
+ * class MyController implements Controller<MyInput, MyOutput> {
+ *   async execute(input: MyInput): Promise<MyOutput> {
+ *     // custom logic
+ *   }
+ * }
+ * ```
+ */
+interface Controller<TInput = unknown, TOutput = unknown> {
+    /**
+     * Executes the controller with the given input.
+     *
+     * @param input - The input to process
+     * @returns Promise resolving to the output
+     */
+    execute(input: TInput): Promise<TOutput>;
+}
+
+/**
+ * Basic HTTP request structure for any HTTP-based framework.
+ *
+ * This is the foundation type representing the data extracted from an HTTP request.
+ * Frameworks (AWS API Gateway, Cloudflare Workers, Express, etc.) map their native
+ * request types to this common interface.
+ *
+ * @example Complete request
+ * ```typescript
+ * const request: HttpRequest = {
+ *   body: { name: 'John', email: 'john@example.com' },
+ *   headers: { 'content-type': 'application/json', 'authorization': 'Bearer ...' },
+ *   pathParams: { id: '123' },
+ *   queryParams: { include: 'profile' },
+ * };
+ * ```
+ */
+interface HttpRequest {
+    /**
+     * Parsed request body.
+     * For JSON requests, this is the deserialized object.
+     * For form data, this contains the parsed form fields.
+     */
+    body?: unknown;
+    /**
+     * HTTP request headers (normalized to lowercase keys).
+     * Common headers include authorization, content-type, accept, etc.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Query string parameters from the URL.
+     * For `/users?page=1&limit=10`, this would be `{ page: '1', limit: '10' }`.
+     * When a key appears multiple times (e.g., `?tag=a&tag=b`), the value is an array.
+     */
+    queryParams?: Record<string, string | string[]>;
+    /**
+     * Path parameters extracted from the URL pattern.
+     * For route `/users/:id` and URL `/users/123`, this would be `{ id: '123' }`.
+     */
+    pathParams?: Record<string, string>;
+}
+
+/**
+ * Basic HTTP response structure for any HTTP-based framework.
+ *
+ * This is the foundation type representing the data to send as an HTTP response.
+ * Frameworks (AWS API Gateway, Cloudflare Workers, Express, etc.) map this common
+ * interface to their native response types.
+ *
+ * @example Success response
+ * ```typescript
+ * const response: HttpResponse = {
+ *   statusCode: 200,
+ *   body: { id: '123', name: 'John' },
+ * };
+ * ```
+ *
+ * @example Response with headers
+ * ```typescript
+ * const response: HttpResponse = {
+ *   statusCode: 201,
+ *   headers: {
+ *     'Location': '/users/123',
+ *     'X-Request-Id': 'req-abc',
+ *   },
+ *   body: { id: '123' },
+ * };
+ * ```
+ */
+interface HttpResponse {
+    /**
+     * HTTP status code (e.g., 200, 201, 400, 404, 500).
+     */
+    statusCode: number;
+    /**
+     * Optional response headers.
+     * Common headers include Content-Type, Location, Cache-Control, etc.
+     */
+    headers?: Record<string, unknown>;
+    /**
+     * Optional response body.
+     * Will be serialized to JSON by framework adapters if it's an object.
+     */
+    body?: unknown;
+}
+
+export type { Controller as C, HttpRequest as H, HttpResponse as a };