b23-lib 1.7.4 → 1.7.6

package/dist/{chunk-T6IVHYQQ.mjs.map → chunk-FL244D6L.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/Classes/ShoppingContainer.ts"],"names":["BaseShoppingContainerModel","BaseModel","data","date","item","LineItemModel","AddressModel","coupon","CouponModel","PriceModel","sum","minCartValueReq","maxCartDiscountCap","couponCategory","discountMethod","potentialDiscount","targetValue","flatAmount","finalDiscount","totalDiscount","discount","shippingCouponDiscount","c","nonShippingCouponDiscount","grossTotal","details"],"mappings":"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","file":"chunk-T6IVHYQQ.mjs","sourcesContent":["import BaseModel, { BaseAttributes, BaseData } from \"./Base\";\r\nimport AddressModel, { AddressData } from \"./Address\";\r\nimport LineItemModel, { LineItemData } from \"./LineItem\";\r\nimport { CountryCode, CurrencyCode, LocaleCode, ShippingDetails } from \"./Common\";\r\nimport PriceModel from \"./Price\";\r\nimport CouponModel, { CouponCategory, CouponData, CouponDiscountMethod } from \"./Coupon\";\r\n\r\nexport type BaseShoppingContainerAttributes = BaseAttributes & {\r\n  id: string;\r\n  customerId?: string;\r\n  customerEmail?: string;\r\n  anonymousId?: string;\r\n  lineItems: LineItemData[];\r\n  shippingDetails: ShippingDetails | null;\r\n  shippingAddress?: AddressData | null;\r\n  billingAddress?: AddressData | null;\r\n  coupons?: CouponData[];\r\n  total?: {\r\n    shipping?: number;\r\n    effectiveShipping?: number;\r\n    subtotal?: number;\r\n    mrpTotal?: number;\r\n    couponTotal?: { [key: string]: number };\r\n    grandTotal?: number;\r\n  };\r\n  country: CountryCode;\r\n  currency: CurrencyCode;\r\n  locale: LocaleCode;\r\n};\r\n\r\nexport type BaseShoppingContainerData = Omit<BaseShoppingContainerAttributes, 'coupons' | 'total'>\r\n& BaseData\r\n& {\r\n    coupons: CouponData[],\r\n    total: {\r\n      shipping: number,\r\n      effectiveShipping: number,\r\n      subtotal: number,\r\n      mrpTotal: number,\r\n      couponTotal: { [key: string]: number },\r\n      grandTotal: number\r\n    };\r\n  };\r\n\r\n\r\n/**\r\n * Abstract base class for shopping-related containers like carts and orders.\r\n * Manages common elements such as line items, addresses, coupons, and totals.\r\n */\r\nexport default abstract class BaseShoppingContainerModel extends BaseModel {\r\n  protected id: string;\r\n  protected customerId?: string;\r\n  protected customerEmail?: string;\r\n  protected anonymousId?: string;\r\n  protected lineItems: LineItemModel[];\r\n  protected shippingDetails: ShippingDetails | null;\r\n  protected shippingAddress: AddressModel | null;\r\n  protected billingAddress: AddressModel | null;\r\n\r\n    // CouponsCodes\r\n  protected coupons: CouponModel[];\r\n\r\n  // Cart Totals\r\n  protected total: {\r\n    shipping: number;\r\n    effectiveShipping: number;\r\n    subtotal: number;\r\n    mrpTotal: number;\r\n    couponTotal: { [key: string]: number; };\r\n    grandTotal: number;\r\n  };\r\n\r\n  protected country: CountryCode;\r\n  protected currency: CurrencyCode;\r\n  protected locale: LocaleCode;\r\n\r\n  /**\r\n   * Creates an instance of BaseShoppingContainerModel.\r\n   * Initializes common properties and calculates initial base totals.\r\n   * @param data - The initial attributes for the shopping container.\r\n   * @param date - Optional date object for setting creation/modification times (defaults to now).\r\n   */\r\n  constructor(data: BaseShoppingContainerAttributes, date: Date = new Date()) {\r\n    super(data, date);\r\n    this.id = data.id;\r\n    this.customerId = data.customerId;\r\n    this.customerEmail = data.customerEmail;\r\n    this.anonymousId = data.anonymousId;\r\n    this.country = data.country;\r\n    this.currency = data.currency;\r\n    this.locale = data.locale;\r\n    this.lineItems = (data.lineItems ?? []).map(item => new LineItemModel(item));\r\n    this.billingAddress = data.billingAddress ? new AddressModel(data.billingAddress, date) : null;\r\n    this.shippingAddress = data.shippingAddress ? new AddressModel(data.shippingAddress, date) : null;\r\n    this.coupons = (data.coupons || []).map(coupon => new CouponModel(coupon));\r\n\r\n    this.shippingDetails = data.shippingDetails ? { ...data.shippingDetails } : null;\r\n\r\n    this.total = {\r\n      shipping: data.total?.shipping || 0,\r\n      effectiveShipping: data.total?.effectiveShipping || data.total?.shipping || 0,\r\n      subtotal: 0, // Will be calculated\r\n      mrpTotal: 0, // Will be calculated\r\n      couponTotal: data.total?.couponTotal || {},\r\n      grandTotal: data.total?.grandTotal || 0, // Will be recalculated\r\n    };\r\n\r\n    this.recalculateBaseTotals();\r\n  }\r\n\r\n  /**\r\n   * Recalculates the subtotal and mrpTotal based on the current line items.\r\n   * Uses PriceModel for rounding based on the country.\r\n   */\r\n  protected recalculateBaseTotals(): void {\r\n    this.total.subtotal = PriceModel.getRoundedPrice(this.lineItems.reduce((sum, item) => sum + item.getPriceTotals().subtotal, 0), this.country);\r\n    this.total.mrpTotal = PriceModel.getRoundedPrice(this.lineItems.reduce((sum, item) => sum + item.getPriceTotals().mrpTotal, 0), this.country);\r\n  }\r\n\r\n  /**\r\n   * Gets the unique identifier for this shopping container (cart ID or order ID).\r\n   * @returns The ID string.\r\n   */\r\n  public getId(): string {\r\n    return this.id;\r\n  }\r\n\r\n  /**\r\n   * Gets the customer ID associated with this container, if available.\r\n   * @returns The customer ID string, or undefined.\r\n   */\r\n  public getCustomerId(): string | undefined {\r\n    return this.customerId;\r\n  }\r\n\r\n  /**\r\n   * Gets the customer email associated with this container, if available.\r\n   * @returns The customer email string, or undefined.\r\n   */\r\n  public getCustomerEmail(): string | undefined {\r\n    return this.customerEmail;\r\n  }\r\n\r\n  /**\r\n   * Gets the anonymous user ID associated with this container, if available.\r\n   * @returns The anonymous ID string, or undefined.\r\n   */\r\n  public getAnonymousId(): string | undefined {\r\n    return this.anonymousId;\r\n  }\r\n\r\n  /**\r\n   * Gets a defensive copy of the line items in the container.\r\n   * Each item is a new LineItemModel instance created from the original's details.\r\n   * @returns An array of LineItemModel instances.\r\n   */\r\n  public getLineItems(): LineItemModel[] {\r\n    // Return new instances to prevent modification of internal state\r\n    return this.lineItems.map(item => new LineItemModel(item.getDetails()));\r\n  }\r\n\r\n  /**\r\n   * Gets a copy of the shipping details associated with the container.\r\n   * @returns A ShippingDetails object, or null if none are set.\r\n   */\r\n  public getShippingDetails(): ShippingDetails | null {\r\n    // Return a shallow copy if details exist\r\n    return this.shippingDetails ? { ...this.shippingDetails } : null;\r\n  }\r\n\r\n  /**\r\n   * Gets a defensive copy of the shipping address associated with the container.\r\n   * Returns a new AddressModel instance created from the original's details.\r\n   * @returns An AddressModel instance, or null if no shipping address is set.\r\n   */\r\n  public getShippingAddress(): AddressModel | null {\r\n    return this.shippingAddress ? new AddressModel(this.shippingAddress.getDetails()) : null;\r\n  }\r\n\r\n  /**\r\n   * Gets a defensive copy of the billing address associated with the container.\r\n   * Returns a new AddressModel instance created from the original's details.\r\n   * @returns An AddressModel instance, or null if no billing address is set.\r\n   */\r\n  public getBillingAddress(): AddressModel | null {\r\n    return this.billingAddress ? new AddressModel(this.billingAddress.getDetails()) : null;\r\n  }\r\n\r\n  /**\r\n   * Gets a defensive copy of the coupons applied to the container.\r\n   * Each item is a new CouponModel instance created from the original's details.\r\n   * @returns An array of CouponModel instances.\r\n   */\r\n  public getCoupons(): CouponModel[] {\r\n    return this.coupons.map(coupon => new CouponModel(coupon.getDetails()));\r\n  }\r\n\r\n  /**\r\n   * Gets the country code associated with this container.\r\n   * @returns The CountryCode enum value.\r\n   */\r\n  public getCountry(): CountryCode {\r\n    return this.country;\r\n  }\r\n\r\n  /**\r\n   * Gets the currency code associated with this container.\r\n   * @returns The CurrencyCode enum value.\r\n   */\r\n  public getCurrency(): CurrencyCode {\r\n    return this.currency;\r\n  }\r\n\r\n  /**\r\n   * Gets the locale code associated with this container.\r\n   * @returns The LocaleCode enum value.\r\n   */\r\n  public getLocale(): LocaleCode {\r\n    return this.locale;\r\n  }\r\n\r\n  /**\r\n   * Gets a defensive copy of the calculated totals for the container.\r\n   * @returns An object containing shipping, subtotal, coupon, and grand totals.\r\n   */\r\n  public getTotal() {\r\n    return  { ...this.total, couponTotal: { ...this.total.couponTotal } };\r\n  }\r\n\r\n  /**\r\n   * Calculates the discount value for a given coupon based on the current container state.\r\n   * Returns 0 if the coupon is invalid, expired, or not applicable based on cart value or target category.\r\n   * @param coupon - The CouponModel instance to evaluate.\r\n   * @returns The calculated discount amount (rounded according to country rules).\r\n   */\r\n  public calculateApplicableCouponDiscount(coupon: CouponModel): number {\r\n    // 1. Basic validation (active)\r\n    if (!coupon.isActive()) {\r\n      return 0;\r\n    }\r\n\r\n    // 2. Check regional requirements (min cart value, max discount)\r\n    const minCartValueReq = coupon.getMinCartValue(this.country);\r\n    const maxCartDiscountCap = coupon.getMaxCartDiscount(this.country);\r\n\r\n    // Ensure minCartValueReq exists and subtotal meets the requirement\r\n    if (!minCartValueReq || this.total.subtotal < minCartValueReq.price) {\r\n      return 0;\r\n    }\r\n\r\n    // Ensure maxCartDiscountCap exists and is non-negative\r\n    if (!maxCartDiscountCap || maxCartDiscountCap.price < 0) {\r\n      return 0;\r\n    }\r\n\r\n    // 3. Calculate potential discount based on method and category\r\n    const couponCategory = coupon.getCategory();\r\n    const discountMethod = coupon.getDiscountMethod();\r\n    let potentialDiscount = 0;\r\n    // Determine the value the coupon applies to (shipping cost or subtotal)\r\n    const targetValue = couponCategory === CouponCategory.SHIPPING ? this.total.shipping : this.total.subtotal;\r\n\r\n    // No discount if the target value is zero or less\r\n    if (targetValue <= 0) return 0;\r\n\r\n    switch (discountMethod) {\r\n      case CouponDiscountMethod.FLAT:\r\n        // Flat discount is capped by the target value itself and the max discount cap\r\n        const flatAmount = maxCartDiscountCap?.price ?? 0; // Use cap as the flat amount source? Or coupon.value? Needs clarification. Assuming cap IS the flat amount here.\r\n        potentialDiscount = Math.min(targetValue, flatAmount);\r\n        break;\r\n      case CouponDiscountMethod.PERCENTAGE:\r\n        // Calculate percentage discount based on the target value\r\n        potentialDiscount = targetValue * (coupon.getPercentageValue() / 100);\r\n        break;\r\n      default:\r\n        // Unknown discount method\r\n        return 0;\r\n    }\r\n\r\n    // 4. Apply maximum discount cap to the calculated potential discount\r\n    const finalDiscount = Math.min(potentialDiscount, maxCartDiscountCap.price);\r\n\r\n    // 5. Round the final discount, ensuring it's not negative\r\n    return PriceModel.getRoundedPrice(Math.max(0, finalDiscount), this.country);\r\n  }\r\n\r\n  /**\r\n   * Recalculates the `couponTotal` map based on currently applied coupons.\r\n   * Iterates through coupons, calculates their applicable discount, and stores it.\r\n   * @returns The total discount amount from all valid and applicable coupons (rounded).\r\n   */\r\n  public recalculateCouponTotals(): number {\r\n    this.total.couponTotal = {}; // Reset the map\r\n    let totalDiscount = 0;\r\n\r\n    this.coupons.forEach(coupon => {\r\n      const discount = this.calculateApplicableCouponDiscount(coupon);\r\n      if (discount > 0) {\r\n        this.total.couponTotal[coupon.getCode()] = discount; // Store per-coupon discount\r\n        totalDiscount += discount; // Accumulate total discount\r\n      }\r\n    });\r\n    // Return the rounded total discount\r\n    return PriceModel.getRoundedPrice(totalDiscount, this.country);\r\n  }\r\n\r\n  /**\r\n  * Recalculates all container totals (subtotal, mrpTotal, coupons, shipping, grandTotal).\r\n  * Should be called whenever line items, coupons, or base shipping cost change.\r\n  */\r\n  public updateCartTotals(): void {\r\n    // 1. Calculate line item totals (subtotal, mrpTotal)\r\n    this.total.subtotal = PriceModel.getRoundedPrice(this.lineItems.reduce((sum, item) => sum + item.getPriceTotals().subtotal, 0), this.country);\r\n    this.total.mrpTotal = PriceModel.getRoundedPrice(this.lineItems.reduce((sum, item) => sum + item.getPriceTotals().mrpTotal, 0), this.country);\r\n\r\n    // 2. Calculate total coupon discount and update the per-coupon discount map\r\n    this.recalculateCouponTotals(); // This updates this.total.couponTotal\r\n\r\n    // 3. Calculate effective shipping cost after applying shipping-specific coupons\r\n    const shippingCouponDiscount = this.coupons\r\n      .filter(c => c.getCategory() === CouponCategory.SHIPPING)\r\n      .reduce((sum, c) => sum + (this.total.couponTotal[c.getCode()] ?? 0), 0);\r\n    this.total.effectiveShipping = PriceModel.getRoundedPrice(Math.max(0, this.total.shipping - shippingCouponDiscount), this.country);\r\n\r\n    // 4. Calculate total discount from non-shipping coupons\r\n    const nonShippingCouponDiscount = this.coupons\r\n      .filter(c => c.getCategory() !== CouponCategory.SHIPPING)\r\n      .reduce((sum, c) => sum + (this.total.couponTotal[c.getCode()] ?? 0), 0);\r\n\r\n    // 5. Calculate final grand total: (subtotal + effective shipping) - non-shipping discounts\r\n    const grossTotal = this.total.subtotal + this.total.effectiveShipping;\r\n    this.total.grandTotal = PriceModel.getRoundedPrice(Math.max(0, grossTotal - nonShippingCouponDiscount), this.country);\r\n  }\r\n\r\n  /**\r\n  * Updates the shipping details (including estimated cost) for the container and recalculates totals.\r\n  * @param details - The new ShippingDetails object, or null to clear shipping details and cost.\r\n  */\r\n  public setShippingDetails(details: ShippingDetails | null): void {\r\n    // Store a copy of the details or null\r\n    this.shippingDetails = details ? { ...details } : null;\r\n\r\n    // Update the base shipping cost based on the new details\r\n    this.total.shipping = PriceModel.getRoundedPrice(this.shippingDetails?.estimatedCost ?? 0, this.country);\r\n    // Recalculate all totals as shipping cost affects effective shipping and grand total\r\n    this.updateCartTotals();\r\n  }\r\n\r\n\r\n  /**\r\n   * Gets a plain data object representing the shopping container's current state.\r\n   * Includes details from the base model and specific container properties.\r\n   * @returns BaseShoppingContainerData object suitable for serialization or API responses.\r\n   */\r\n  getDetails(): BaseShoppingContainerData {\r\n     return {\r\n       ...super.getDetails(),\r\n       id: this.getId(),\r\n       customerId: this.getCustomerId(),\r\n       customerEmail: this.getCustomerEmail(),\r\n       anonymousId: this.getAnonymousId(),\r\n       lineItems: this.getLineItems().map(item => item.getDetails()),\r\n       shippingDetails: this.getShippingDetails(),\r\n       shippingAddress: this.getShippingAddress()?.getDetails() || null,\r\n       billingAddress: this.getBillingAddress()?.getDetails() || null,\r\n       coupons: this.getCoupons().map(coupon => coupon.getDetails()),\r\n       total: this.getTotal(),\r\n       country: this.getCountry(),\r\n       currency: this.getCurrency(),\r\n       locale: this.getLocale(),\r\n     }\r\n   };\r\n}\r\n"]}
+{"version":3,"sources":["../src/Classes/ShoppingContainer.ts"],"names":["BaseShoppingContainerModel","BaseModel","data","date","item","LineItemModel","AddressModel","coupon","CouponModel","PriceModel","sum","minCartValueReq","maxCartDiscountCap","couponCategory","discountMethod","potentialDiscount","targetValue","flatAmount","finalDiscount","totalDiscount","discount","shippingCouponDiscount","c","nonShippingCouponDiscount","grossTotal","details"],"mappings":"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","file":"chunk-FL244D6L.mjs","sourcesContent":["import BaseModel, { BaseAttributes, BaseData } from \"./Base\";\r\nimport AddressModel, { AddressData } from \"./Address\";\r\nimport LineItemModel, { LineItemData } from \"./LineItem\";\r\nimport { CountryCode, CurrencyCode, LocaleCode, ShippingDetails } from \"./Common\";\r\nimport PriceModel from \"./Price\";\r\nimport CouponModel, { CouponCategory, CouponData, CouponDiscountMethod } from \"./Coupon\";\r\n\r\nexport type BaseShoppingContainerAttributes = BaseAttributes & {\r\n  id: string;\r\n  customerId?: string;\r\n  customerEmail?: string;\r\n  anonymousId?: string;\r\n  lineItems: LineItemData[];\r\n  shippingDetails: ShippingDetails | null;\r\n  shippingAddress?: AddressData | null;\r\n  billingAddress?: AddressData | null;\r\n  coupons?: CouponData[];\r\n  total?: {\r\n    shipping?: number;\r\n    effectiveShipping?: number;\r\n    subtotal?: number;\r\n    mrpTotal?: number;\r\n    couponTotal?: { [key: string]: number };\r\n    grandTotal?: number;\r\n  };\r\n  country: CountryCode;\r\n  currency: CurrencyCode;\r\n  locale: LocaleCode;\r\n};\r\n\r\nexport type BaseShoppingContainerData = Omit<BaseShoppingContainerAttributes, 'coupons' | 'total'>\r\n& BaseData\r\n& {\r\n    coupons: CouponData[],\r\n    total: {\r\n      shipping: number,\r\n      effectiveShipping: number,\r\n      subtotal: number,\r\n      mrpTotal: number,\r\n      couponTotal: { [key: string]: number },\r\n      grandTotal: number\r\n    };\r\n  };\r\n\r\n\r\n/**\r\n * Abstract base class for shopping-related containers like carts and orders.\r\n * Manages common elements such as line items, addresses, coupons, and totals.\r\n */\r\nexport default abstract class BaseShoppingContainerModel extends BaseModel {\r\n  protected id: string;\r\n  protected customerId?: string;\r\n  protected customerEmail?: string;\r\n  protected anonymousId?: string;\r\n  protected lineItems: LineItemModel[];\r\n  protected shippingDetails: ShippingDetails | null;\r\n  protected shippingAddress: AddressModel | null;\r\n  protected billingAddress: AddressModel | null;\r\n\r\n    // CouponsCodes\r\n  protected coupons: CouponModel[];\r\n\r\n  // Cart Totals\r\n  protected total: {\r\n    shipping: number;\r\n    effectiveShipping: number;\r\n    subtotal: number;\r\n    mrpTotal: number;\r\n    couponTotal: { [key: string]: number; };\r\n    grandTotal: number;\r\n  };\r\n\r\n  protected country: CountryCode;\r\n  protected currency: CurrencyCode;\r\n  protected locale: LocaleCode;\r\n\r\n  /**\r\n   * Creates an instance of BaseShoppingContainerModel.\r\n   * Initializes common properties and calculates initial base totals.\r\n   * @param data - The initial attributes for the shopping container.\r\n   * @param date - Optional date object for setting creation/modification times (defaults to now).\r\n   */\r\n  constructor(data: BaseShoppingContainerAttributes, date: Date = new Date()) {\r\n    super(data, date);\r\n    this.id = data.id;\r\n    this.customerId = data.customerId;\r\n    this.customerEmail = data.customerEmail;\r\n    this.anonymousId = data.anonymousId;\r\n    this.country = data.country;\r\n    this.currency = data.currency;\r\n    this.locale = data.locale;\r\n    this.lineItems = (data.lineItems ?? []).map(item => new LineItemModel(item));\r\n    this.billingAddress = data.billingAddress ? new AddressModel(data.billingAddress, date) : null;\r\n    this.shippingAddress = data.shippingAddress ? new AddressModel(data.shippingAddress, date) : null;\r\n    this.coupons = (data.coupons || []).map(coupon => new CouponModel(coupon));\r\n\r\n    this.shippingDetails = data.shippingDetails ? { ...data.shippingDetails } : null;\r\n\r\n    this.total = {\r\n      shipping: data.total?.shipping || 0,\r\n      effectiveShipping: data.total?.effectiveShipping || data.total?.shipping || 0,\r\n      subtotal: 0, // Will be calculated\r\n      mrpTotal: 0, // Will be calculated\r\n      couponTotal: data.total?.couponTotal || {},\r\n      grandTotal: data.total?.grandTotal || 0, // Will be recalculated\r\n    };\r\n\r\n    this.recalculateBaseTotals();\r\n  }\r\n\r\n  /**\r\n   * Recalculates the subtotal and mrpTotal based on the current line items.\r\n   * Uses PriceModel for rounding based on the country.\r\n   */\r\n  protected recalculateBaseTotals(): void {\r\n    this.total.subtotal = PriceModel.getRoundedPrice(this.lineItems.reduce((sum, item) => sum + item.getPriceTotals().subtotal, 0), this.country);\r\n    this.total.mrpTotal = PriceModel.getRoundedPrice(this.lineItems.reduce((sum, item) => sum + item.getPriceTotals().mrpTotal, 0), this.country);\r\n  }\r\n\r\n  /**\r\n   * Gets the unique identifier for this shopping container (cart ID or order ID).\r\n   * @returns The ID string.\r\n   */\r\n  public getId(): string {\r\n    return this.id;\r\n  }\r\n\r\n  /**\r\n   * Gets the customer ID associated with this container, if available.\r\n   * @returns The customer ID string, or undefined.\r\n   */\r\n  public getCustomerId(): string | undefined {\r\n    return this.customerId;\r\n  }\r\n\r\n  /**\r\n   * Gets the customer email associated with this container, if available.\r\n   * @returns The customer email string, or undefined.\r\n   */\r\n  public getCustomerEmail(): string | undefined {\r\n    return this.customerEmail;\r\n  }\r\n\r\n  /**\r\n   * Gets the anonymous user ID associated with this container, if available.\r\n   * @returns The anonymous ID string, or undefined.\r\n   */\r\n  public getAnonymousId(): string | undefined {\r\n    return this.anonymousId;\r\n  }\r\n\r\n  /**\r\n   * Gets a defensive copy of the line items in the container.\r\n   * Each item is a new LineItemModel instance created from the original's details.\r\n   * @returns An array of LineItemModel instances.\r\n   */\r\n  public getLineItems(): LineItemModel[] {\r\n    // Return new instances to prevent modification of internal state\r\n    return this.lineItems.map(item => new LineItemModel(item.getDetails()));\r\n  }\r\n\r\n  /**\r\n   * Gets a copy of the shipping details associated with the container.\r\n   * @returns A ShippingDetails object, or null if none are set.\r\n   */\r\n  public getShippingDetails(): ShippingDetails | null {\r\n    // Return a shallow copy if details exist\r\n    return this.shippingDetails ? { ...this.shippingDetails } : null;\r\n  }\r\n\r\n  /**\r\n   * Gets a defensive copy of the shipping address associated with the container.\r\n   * Returns a new AddressModel instance created from the original's details.\r\n   * @returns An AddressModel instance, or null if no shipping address is set.\r\n   */\r\n  public getShippingAddress(): AddressModel | null {\r\n    return this.shippingAddress ? new AddressModel(this.shippingAddress.getDetails()) : null;\r\n  }\r\n\r\n  /**\r\n   * Gets a defensive copy of the billing address associated with the container.\r\n   * Returns a new AddressModel instance created from the original's details.\r\n   * @returns An AddressModel instance, or null if no billing address is set.\r\n   */\r\n  public getBillingAddress(): AddressModel | null {\r\n    return this.billingAddress ? new AddressModel(this.billingAddress.getDetails()) : null;\r\n  }\r\n\r\n  /**\r\n   * Gets a defensive copy of the coupons applied to the container.\r\n   * Each item is a new CouponModel instance created from the original's details.\r\n   * @returns An array of CouponModel instances.\r\n   */\r\n  public getCoupons(): CouponModel[] {\r\n    return this.coupons.map(coupon => new CouponModel(coupon.getDetails()));\r\n  }\r\n\r\n  /**\r\n   * Gets the country code associated with this container.\r\n   * @returns The CountryCode enum value.\r\n   */\r\n  public getCountry(): CountryCode {\r\n    return this.country;\r\n  }\r\n\r\n  /**\r\n   * Gets the currency code associated with this container.\r\n   * @returns The CurrencyCode enum value.\r\n   */\r\n  public getCurrency(): CurrencyCode {\r\n    return this.currency;\r\n  }\r\n\r\n  /**\r\n   * Gets the locale code associated with this container.\r\n   * @returns The LocaleCode enum value.\r\n   */\r\n  public getLocale(): LocaleCode {\r\n    return this.locale;\r\n  }\r\n\r\n  /**\r\n   * Gets a defensive copy of the calculated totals for the container.\r\n   * @returns An object containing shipping, subtotal, coupon, and grand totals.\r\n   */\r\n  public getTotal() {\r\n    return  { ...this.total, couponTotal: { ...this.total.couponTotal } };\r\n  }\r\n\r\n  /**\r\n   * Calculates the discount value for a given coupon based on the current container state.\r\n   * Returns 0 if the coupon is invalid, expired, or not applicable based on cart value or target category.\r\n   * @param coupon - The CouponModel instance to evaluate.\r\n   * @returns The calculated discount amount (rounded according to country rules).\r\n   */\r\n  public calculateApplicableCouponDiscount(coupon: CouponModel): number {\r\n    // 1. Basic validation (active)\r\n    if (!coupon.isActive()) {\r\n      return 0;\r\n    }\r\n\r\n    // 2. Check regional requirements (min cart value, max discount)\r\n    const minCartValueReq = coupon.getMinCartValue(this.country);\r\n    const maxCartDiscountCap = coupon.getMaxCartDiscount(this.country);\r\n\r\n    // Ensure minCartValueReq exists and subtotal meets the requirement\r\n    if (!minCartValueReq || this.total.subtotal < minCartValueReq.price) {\r\n      return 0;\r\n    }\r\n\r\n    // Ensure maxCartDiscountCap exists and is non-negative\r\n    if (!maxCartDiscountCap || maxCartDiscountCap.price < 0) {\r\n      return 0;\r\n    }\r\n\r\n    // 3. Calculate potential discount based on method and category\r\n    const couponCategory = coupon.getCategory();\r\n    const discountMethod = coupon.getDiscountMethod();\r\n    let potentialDiscount = 0;\r\n    // Determine the value the coupon applies to (shipping cost or subtotal)\r\n    const targetValue = couponCategory === CouponCategory.SHIPPING ? this.total.shipping : this.total.subtotal;\r\n\r\n    // No discount if the target value is zero or less\r\n    if (targetValue <= 0) return 0;\r\n\r\n    switch (discountMethod) {\r\n      case CouponDiscountMethod.FLAT:\r\n        // Flat discount is capped by the target value itself and the max discount cap\r\n        const flatAmount = maxCartDiscountCap?.price ?? 0; // Use cap as the flat amount source? Or coupon.value? Needs clarification. Assuming cap IS the flat amount here.\r\n        potentialDiscount = Math.min(targetValue, flatAmount);\r\n        break;\r\n      case CouponDiscountMethod.PERCENTAGE:\r\n        // Calculate percentage discount based on the target value\r\n        potentialDiscount = targetValue * (coupon.getPercentageValue() / 100);\r\n        break;\r\n      default:\r\n        // Unknown discount method\r\n        return 0;\r\n    }\r\n\r\n    // 4. Apply maximum discount cap to the calculated potential discount\r\n    const finalDiscount = Math.min(potentialDiscount, maxCartDiscountCap.price);\r\n\r\n    // 5. Round the final discount, ensuring it's not negative\r\n    return PriceModel.getRoundedPrice(Math.max(0, finalDiscount), this.country);\r\n  }\r\n\r\n  /**\r\n   * Recalculates the `couponTotal` map based on currently applied coupons.\r\n   * Iterates through coupons, calculates their applicable discount, and stores it.\r\n   * @returns The total discount amount from all valid and applicable coupons (rounded).\r\n   */\r\n  public recalculateCouponTotals(): number {\r\n    this.total.couponTotal = {}; // Reset the map\r\n    let totalDiscount = 0;\r\n\r\n    this.coupons.forEach(coupon => {\r\n      const discount = this.calculateApplicableCouponDiscount(coupon);\r\n      if (discount > 0) {\r\n        this.total.couponTotal[coupon.getCode()] = discount; // Store per-coupon discount\r\n        totalDiscount += discount; // Accumulate total discount\r\n      }\r\n    });\r\n    // Return the rounded total discount\r\n    return PriceModel.getRoundedPrice(totalDiscount, this.country);\r\n  }\r\n\r\n  /**\r\n  * Recalculates all container totals (subtotal, mrpTotal, coupons, shipping, grandTotal).\r\n  * Should be called whenever line items, coupons, or base shipping cost change.\r\n  */\r\n  public updateCartTotals(): void {\r\n    // 1. Calculate line item totals (subtotal, mrpTotal)\r\n    this.total.subtotal = PriceModel.getRoundedPrice(this.lineItems.reduce((sum, item) => sum + item.getPriceTotals().subtotal, 0), this.country);\r\n    this.total.mrpTotal = PriceModel.getRoundedPrice(this.lineItems.reduce((sum, item) => sum + item.getPriceTotals().mrpTotal, 0), this.country);\r\n\r\n    // 2. Calculate total coupon discount and update the per-coupon discount map\r\n    this.recalculateCouponTotals(); // This updates this.total.couponTotal\r\n\r\n    // 3. Calculate effective shipping cost after applying shipping-specific coupons\r\n    const shippingCouponDiscount = this.coupons\r\n      .filter(c => c.getCategory() === CouponCategory.SHIPPING)\r\n      .reduce((sum, c) => sum + (this.total.couponTotal[c.getCode()] ?? 0), 0);\r\n    this.total.effectiveShipping = PriceModel.getRoundedPrice(Math.max(0, this.total.shipping - shippingCouponDiscount), this.country);\r\n\r\n    // 4. Calculate total discount from non-shipping coupons\r\n    const nonShippingCouponDiscount = this.coupons\r\n      .filter(c => c.getCategory() !== CouponCategory.SHIPPING)\r\n      .reduce((sum, c) => sum + (this.total.couponTotal[c.getCode()] ?? 0), 0);\r\n\r\n    // 5. Calculate final grand total: (subtotal + effective shipping) - non-shipping discounts\r\n    const grossTotal = this.total.subtotal + this.total.effectiveShipping;\r\n    this.total.grandTotal = PriceModel.getRoundedPrice(Math.max(0, grossTotal - nonShippingCouponDiscount), this.country);\r\n  }\r\n\r\n  /**\r\n  * Updates the shipping details (including estimated cost) for the container and recalculates totals.\r\n  * @param details - The new ShippingDetails object, or null to clear shipping details and cost.\r\n  */\r\n  public setShippingDetails(details: ShippingDetails | null): void {\r\n    // Store a copy of the details or null\r\n    this.shippingDetails = details ? { ...details } : null;\r\n\r\n    // Update the base shipping cost based on the new details\r\n    this.total.shipping = PriceModel.getRoundedPrice(this.shippingDetails?.estimatedCost ?? 0, this.country);\r\n    // Recalculate all totals as shipping cost affects effective shipping and grand total\r\n    this.updateCartTotals();\r\n  }\r\n\r\n\r\n  /**\r\n   * Gets a plain data object representing the shopping container's current state.\r\n   * Includes details from the base model and specific container properties.\r\n   * @returns BaseShoppingContainerData object suitable for serialization or API responses.\r\n   */\r\n  getDetails(): BaseShoppingContainerData {\r\n     return {\r\n       ...super.getDetails(),\r\n       id: this.getId(),\r\n       customerId: this.getCustomerId(),\r\n       customerEmail: this.getCustomerEmail(),\r\n       anonymousId: this.getAnonymousId(),\r\n       lineItems: this.getLineItems().map(item => item.getDetails()),\r\n       shippingDetails: this.getShippingDetails(),\r\n       shippingAddress: this.getShippingAddress()?.getDetails() || null,\r\n       billingAddress: this.getBillingAddress()?.getDetails() || null,\r\n       coupons: this.getCoupons().map(coupon => coupon.getDetails()),\r\n       total: this.getTotal(),\r\n       country: this.getCountry(),\r\n       currency: this.getCurrency(),\r\n       locale: this.getLocale(),\r\n     }\r\n   };\r\n}\r\n"]}

package/dist/{chunk-CWKGR4AF.mjs → chunk-XZG7Y2WO.mjs}

@@ -1,2 +1,2 @@
-import {a}from'./chunk-SPLTJRHG.mjs';var n=(e=>(e.BILLING="billing",e.SHIPPING="shipping",e.BILLING_AND_SHIPPING="billing&shipping",e.NONE="none",e))(n||{}),t=class extends a{id;firstName;lastName;phone;email;addressLine1;addressLine2;city;postalCode;state;country;isBillingAddress;isShippingAddress;constructor(s,r=new Date){super(s,r),this.id=s.id,this.firstName=s.firstName,this.lastName=s.lastName,this.phone=s.phone,this.email=s.email,this.addressLine1=s.addressLine1,this.addressLine2=s.addressLine2||"",this.city=s.city,this.postalCode=s.postalCode,this.state=s.state,this.country=s.country,this.isBillingAddress=s.isBillingAddress,this.isShippingAddress=s.isShippingAddress;}getDetails(){return {...super.getDetails(),id:this.getId(),firstName:this.getFirstName(),lastName:this.getLastName(),phone:this.getPhone(),email:this.getEmail(),addressLine1:this.getAddressLine1(),addressLine2:this.getAddressLine2(),city:this.getCity(),postalCode:this.getPostalCode(),state:this.getState(),country:this.getCountry(),isBillingAddress:this.getIsBillingAddress(),isShippingAddress:this.getIsShippingAddress()}}getId(){return this.id}getFirstName(){return this.firstName}getLastName(){return this.lastName}getPhone(){return this.phone}getEmail(){return this.email}getAddressLine1(){return this.addressLine1}getAddressLine2(){return this.addressLine2}getCity(){return this.city}getPostalCode(){return this.postalCode}getState(){return this.state}getCountry(){return this.country}getIsBillingAddress(){return this.isBillingAddress}getIsShippingAddress(){return this.isShippingAddress}getAddressType(){return this.isBillingAddress&&this.isShippingAddress?"billing&shipping":this.isBillingAddress?"billing":this.isShippingAddress?"shipping":"none"}static checkIfShippingAddress(s){return s==="shipping"||s==="billing&shipping"}static checkIfBillingAddress(s){return s==="billing"||s==="billing&shipping"}};export{n as a,t as b};//# sourceMappingURL=chunk-CWKGR4AF.mjs.map
-//# sourceMappingURL=chunk-CWKGR4AF.mjs.map
+import {a}from'./chunk-ATUUYYQT.mjs';var n=(e=>(e.BILLING="billing",e.SHIPPING="shipping",e.BILLING_AND_SHIPPING="billing&shipping",e.NONE="none",e))(n||{}),t=class extends a{id;firstName;lastName;phone;email;addressLine1;addressLine2;city;postalCode;state;country;isBillingAddress;isShippingAddress;constructor(s,r=new Date){super(s,r),this.id=s.id,this.firstName=s.firstName,this.lastName=s.lastName,this.phone=s.phone,this.email=s.email,this.addressLine1=s.addressLine1,this.addressLine2=s.addressLine2||"",this.city=s.city,this.postalCode=s.postalCode,this.state=s.state,this.country=s.country,this.isBillingAddress=s.isBillingAddress,this.isShippingAddress=s.isShippingAddress;}getDetails(){return {...super.getDetails(),id:this.getId(),firstName:this.getFirstName(),lastName:this.getLastName(),phone:this.getPhone(),email:this.getEmail(),addressLine1:this.getAddressLine1(),addressLine2:this.getAddressLine2(),city:this.getCity(),postalCode:this.getPostalCode(),state:this.getState(),country:this.getCountry(),isBillingAddress:this.getIsBillingAddress(),isShippingAddress:this.getIsShippingAddress()}}getId(){return this.id}getFirstName(){return this.firstName}getLastName(){return this.lastName}getPhone(){return this.phone}getEmail(){return this.email}getAddressLine1(){return this.addressLine1}getAddressLine2(){return this.addressLine2}getCity(){return this.city}getPostalCode(){return this.postalCode}getState(){return this.state}getCountry(){return this.country}getIsBillingAddress(){return this.isBillingAddress}getIsShippingAddress(){return this.isShippingAddress}getAddressType(){return this.isBillingAddress&&this.isShippingAddress?"billing&shipping":this.isBillingAddress?"billing":this.isShippingAddress?"shipping":"none"}static checkIfShippingAddress(s){return s==="shipping"||s==="billing&shipping"}static checkIfBillingAddress(s){return s==="billing"||s==="billing&shipping"}};export{n as a,t as b};//# sourceMappingURL=chunk-XZG7Y2WO.mjs.map
+//# sourceMappingURL=chunk-XZG7Y2WO.mjs.map

package/dist/{chunk-CWKGR4AF.mjs.map → chunk-XZG7Y2WO.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/Classes/Address.ts"],"names":["AddressType","AddressModel","BaseModel","data","date","addressType"],"mappings":"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","file":"chunk-CWKGR4AF.mjs","sourcesContent":["import BaseModel, { BaseAttributes } from \"./Base\";\r\n\r\nexport enum AddressType {\r\n  BILLING = \"billing\",\r\n  SHIPPING = \"shipping\",\r\n  BILLING_AND_SHIPPING = \"billing&shipping\",\r\n  NONE = \"none\",\r\n}\r\n\r\nexport type AddressAttributes = BaseAttributes & {\r\n  id: string;\r\n  firstName: string;\r\n  lastName: string;\r\n  phone: string;\r\n  email: string;\r\n  addressLine1: string;\r\n  addressLine2?: string;\r\n  city: string;\r\n  postalCode: string\r\n  state: string;\r\n  country: string;\r\n  isBillingAddress: boolean;\r\n  isShippingAddress: boolean;\r\n};\r\n\r\nexport type AddressData = Required<AddressAttributes>;\r\n\r\n/**\r\n * Represents a physical address associated with a customer or order.\r\n * Handles both billing and shipping address types.\r\n */\r\nexport default class AddressModel extends BaseModel {\r\n  protected id: string;\r\n  protected firstName: string;\r\n  protected lastName: string;\r\n  protected phone: string;\r\n  protected email: string;\r\n  protected addressLine1: string;\r\n  protected addressLine2: string;\r\n  protected city: string;\r\n  protected postalCode: string\r\n  protected state: string;\r\n  protected country: string;\r\n  protected isBillingAddress: boolean;\r\n  protected isShippingAddress: boolean;\r\n\r\n  /**\r\n   * Creates an instance of AddressModel.\r\n   * @param data - The initial address attributes.\r\n   * @param date - Optional date for setting creation/modification times (defaults to now).\r\n   */\r\n  constructor(data: AddressAttributes, date: Date = new Date()) {\r\n    super(data, date);\r\n    this.id = data.id;\r\n    this.firstName = data.firstName;\r\n    this.lastName = data.lastName;\r\n    this.phone = data.phone;\r\n    this.email = data.email;\r\n    this.addressLine1 = data.addressLine1;\r\n    this.addressLine2 = data.addressLine2 || '';\r\n    this.city = data.city;\r\n    this.postalCode = data.postalCode;\r\n    this.state = data.state;\r\n    this.country = data.country;\r\n    this.isBillingAddress = data.isBillingAddress;\r\n    this.isShippingAddress = data.isShippingAddress;\r\n  }\r\n\r\n  /**\r\n   * Gets a plain data object representing the address's current state.\r\n   * Includes all address fields and base model fields.\r\n   * @returns AddressData object suitable for serialization or API responses.\r\n   */\r\n  getDetails(): AddressData {\r\n    return {\r\n      ...super.getDetails(),\r\n      id: this.getId(),\r\n      firstName: this.getFirstName(),\r\n      lastName: this.getLastName(),\r\n      phone: this.getPhone(),\r\n      email: this.getEmail(),\r\n      addressLine1: this.getAddressLine1(),\r\n      addressLine2: this.getAddressLine2(),\r\n      city: this.getCity(),\r\n      postalCode: this.getPostalCode(),\r\n      state: this.getState(),\r\n      country: this.getCountry(),\r\n      isBillingAddress: this.getIsBillingAddress(),\r\n      isShippingAddress: this.getIsShippingAddress(),\r\n    }\r\n  }\r\n\r\n  /**\r\n  * Gets the unique identifier for the address.\r\n  * @returns The address ID.\r\n  */\r\n  getId(): string {\r\n    return this.id;\r\n  }\r\n\r\n  /**\r\n   * Gets the first name associated with the address.\r\n   * @returns The first name.\r\n   */\r\n  getFirstName(): string {\r\n    return this.firstName;\r\n  }\r\n\r\n  /**\r\n   * Gets the last name associated with the address.\r\n   * @returns The last name.\r\n   */\r\n  getLastName(): string {\r\n    return this.lastName;\r\n  }\r\n\r\n  /**\r\n   * Gets the phone number associated with the address.\r\n   * @returns The phone number.\r\n   */\r\n  getPhone(): string {\r\n    return this.phone;\r\n  }\r\n\r\n  /**\r\n   * Gets the email address associated with the address.\r\n   * @returns The email address.\r\n   */\r\n  getEmail(): string {\r\n    return this.email;\r\n  }\r\n\r\n  /**\r\n   * Gets the primary address line (e.g., street address).\r\n   * @returns The first address line.\r\n   */\r\n  getAddressLine1(): string {\r\n    return this.addressLine1;\r\n  }\r\n\r\n  /**\r\n   * Gets the secondary address line (e.g., apartment, suite).\r\n   * Returns an empty string if not provided.\r\n   * @returns The second address line or an empty string.\r\n   */\r\n  getAddressLine2(): string {\r\n    return this.addressLine2;\r\n  }\r\n\r\n  /**\r\n   * Gets the city name.\r\n   * @returns The city.\r\n   */\r\n  getCity(): string {\r\n    return this.city;\r\n  }\r\n\r\n  /**\r\n   * Gets the postal code (e.g., ZIP code).\r\n   * @returns The postal code.\r\n   */\r\n  getPostalCode(): string {\r\n    return this.postalCode;\r\n  }\r\n\r\n  /**\r\n   * Gets the state, province, or region.\r\n   * @returns The state.\r\n   */\r\n  getState(): string {\r\n    return this.state;\r\n  }\r\n\r\n  /**\r\n   * Gets the country name or code.\r\n   * @returns The country.\r\n   */\r\n  getCountry(): string {\r\n    return this.country;\r\n  }\r\n\r\n  /**\r\n   * Checks if this address is designated as a billing address.\r\n   * @returns True if it's a billing address, false otherwise.\r\n   */\r\n  getIsBillingAddress(): boolean {\r\n    return this.isBillingAddress;\r\n  }\r\n\r\n  /**\r\n   * Checks if this address is designated as a shipping address.\r\n   * @returns True if it's a shipping address, false otherwise.\r\n   */\r\n  getIsShippingAddress(): boolean {\r\n    return this.isShippingAddress;\r\n  }\r\n\r\n  /**\r\n   * Determines the type of the address based on its billing and shipping flags.\r\n   * @returns The AddressType enum value representing the address's role.\r\n   */\r\n  getAddressType(): AddressType {\r\n    if (this.isBillingAddress && this.isShippingAddress) {\r\n      return AddressType.BILLING_AND_SHIPPING;\r\n    } else if (this.isBillingAddress) {\r\n      return AddressType.BILLING;\r\n    } else if (this.isShippingAddress) {\r\n      return AddressType.SHIPPING;\r\n    } else {\r\n      return AddressType.NONE;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Static method to check if a given AddressType includes shipping.\r\n   * @param addressType - The address type to check.\r\n   * @returns True if the type is SHIPPING or BILLING_AND_SHIPPING.\r\n   */\r\n  static checkIfShippingAddress(addressType: AddressType): boolean {\r\n    return addressType === AddressType.SHIPPING || addressType === AddressType.BILLING_AND_SHIPPING;\r\n  }\r\n\r\n  /**\r\n   * Static method to check if a given AddressType includes billing.\r\n   * @param addressType - The address type to check.\r\n   * @returns True if the type is BILLING or BILLING_AND_SHIPPING.\r\n   */\r\n  static checkIfBillingAddress(addressType: AddressType): boolean {\r\n    return addressType === AddressType.BILLING || addressType === AddressType.BILLING_AND_SHIPPING;\r\n  }\r\n}"]}
+{"version":3,"sources":["../src/Classes/Address.ts"],"names":["AddressType","AddressModel","BaseModel","data","date","addressType"],"mappings":"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","file":"chunk-XZG7Y2WO.mjs","sourcesContent":["import BaseModel, { BaseAttributes } from \"./Base\";\r\n\r\nexport enum AddressType {\r\n  BILLING = \"billing\",\r\n  SHIPPING = \"shipping\",\r\n  BILLING_AND_SHIPPING = \"billing&shipping\",\r\n  NONE = \"none\",\r\n}\r\n\r\nexport type AddressAttributes = BaseAttributes & {\r\n  id: string;\r\n  firstName: string;\r\n  lastName: string;\r\n  phone: string;\r\n  email: string;\r\n  addressLine1: string;\r\n  addressLine2?: string;\r\n  city: string;\r\n  postalCode: string\r\n  state: string;\r\n  country: string;\r\n  isBillingAddress: boolean;\r\n  isShippingAddress: boolean;\r\n};\r\n\r\nexport type AddressData = Required<AddressAttributes>;\r\n\r\n/**\r\n * Represents a physical address associated with a customer or order.\r\n * Handles both billing and shipping address types.\r\n */\r\nexport default class AddressModel extends BaseModel {\r\n  protected id: string;\r\n  protected firstName: string;\r\n  protected lastName: string;\r\n  protected phone: string;\r\n  protected email: string;\r\n  protected addressLine1: string;\r\n  protected addressLine2: string;\r\n  protected city: string;\r\n  protected postalCode: string\r\n  protected state: string;\r\n  protected country: string;\r\n  protected isBillingAddress: boolean;\r\n  protected isShippingAddress: boolean;\r\n\r\n  /**\r\n   * Creates an instance of AddressModel.\r\n   * @param data - The initial address attributes.\r\n   * @param date - Optional date for setting creation/modification times (defaults to now).\r\n   */\r\n  constructor(data: AddressAttributes, date: Date = new Date()) {\r\n    super(data, date);\r\n    this.id = data.id;\r\n    this.firstName = data.firstName;\r\n    this.lastName = data.lastName;\r\n    this.phone = data.phone;\r\n    this.email = data.email;\r\n    this.addressLine1 = data.addressLine1;\r\n    this.addressLine2 = data.addressLine2 || '';\r\n    this.city = data.city;\r\n    this.postalCode = data.postalCode;\r\n    this.state = data.state;\r\n    this.country = data.country;\r\n    this.isBillingAddress = data.isBillingAddress;\r\n    this.isShippingAddress = data.isShippingAddress;\r\n  }\r\n\r\n  /**\r\n   * Gets a plain data object representing the address's current state.\r\n   * Includes all address fields and base model fields.\r\n   * @returns AddressData object suitable for serialization or API responses.\r\n   */\r\n  getDetails(): AddressData {\r\n    return {\r\n      ...super.getDetails(),\r\n      id: this.getId(),\r\n      firstName: this.getFirstName(),\r\n      lastName: this.getLastName(),\r\n      phone: this.getPhone(),\r\n      email: this.getEmail(),\r\n      addressLine1: this.getAddressLine1(),\r\n      addressLine2: this.getAddressLine2(),\r\n      city: this.getCity(),\r\n      postalCode: this.getPostalCode(),\r\n      state: this.getState(),\r\n      country: this.getCountry(),\r\n      isBillingAddress: this.getIsBillingAddress(),\r\n      isShippingAddress: this.getIsShippingAddress(),\r\n    }\r\n  }\r\n\r\n  /**\r\n  * Gets the unique identifier for the address.\r\n  * @returns The address ID.\r\n  */\r\n  getId(): string {\r\n    return this.id;\r\n  }\r\n\r\n  /**\r\n   * Gets the first name associated with the address.\r\n   * @returns The first name.\r\n   */\r\n  getFirstName(): string {\r\n    return this.firstName;\r\n  }\r\n\r\n  /**\r\n   * Gets the last name associated with the address.\r\n   * @returns The last name.\r\n   */\r\n  getLastName(): string {\r\n    return this.lastName;\r\n  }\r\n\r\n  /**\r\n   * Gets the phone number associated with the address.\r\n   * @returns The phone number.\r\n   */\r\n  getPhone(): string {\r\n    return this.phone;\r\n  }\r\n\r\n  /**\r\n   * Gets the email address associated with the address.\r\n   * @returns The email address.\r\n   */\r\n  getEmail(): string {\r\n    return this.email;\r\n  }\r\n\r\n  /**\r\n   * Gets the primary address line (e.g., street address).\r\n   * @returns The first address line.\r\n   */\r\n  getAddressLine1(): string {\r\n    return this.addressLine1;\r\n  }\r\n\r\n  /**\r\n   * Gets the secondary address line (e.g., apartment, suite).\r\n   * Returns an empty string if not provided.\r\n   * @returns The second address line or an empty string.\r\n   */\r\n  getAddressLine2(): string {\r\n    return this.addressLine2;\r\n  }\r\n\r\n  /**\r\n   * Gets the city name.\r\n   * @returns The city.\r\n   */\r\n  getCity(): string {\r\n    return this.city;\r\n  }\r\n\r\n  /**\r\n   * Gets the postal code (e.g., ZIP code).\r\n   * @returns The postal code.\r\n   */\r\n  getPostalCode(): string {\r\n    return this.postalCode;\r\n  }\r\n\r\n  /**\r\n   * Gets the state, province, or region.\r\n   * @returns The state.\r\n   */\r\n  getState(): string {\r\n    return this.state;\r\n  }\r\n\r\n  /**\r\n   * Gets the country name or code.\r\n   * @returns The country.\r\n   */\r\n  getCountry(): string {\r\n    return this.country;\r\n  }\r\n\r\n  /**\r\n   * Checks if this address is designated as a billing address.\r\n   * @returns True if it's a billing address, false otherwise.\r\n   */\r\n  getIsBillingAddress(): boolean {\r\n    return this.isBillingAddress;\r\n  }\r\n\r\n  /**\r\n   * Checks if this address is designated as a shipping address.\r\n   * @returns True if it's a shipping address, false otherwise.\r\n   */\r\n  getIsShippingAddress(): boolean {\r\n    return this.isShippingAddress;\r\n  }\r\n\r\n  /**\r\n   * Determines the type of the address based on its billing and shipping flags.\r\n   * @returns The AddressType enum value representing the address's role.\r\n   */\r\n  getAddressType(): AddressType {\r\n    if (this.isBillingAddress && this.isShippingAddress) {\r\n      return AddressType.BILLING_AND_SHIPPING;\r\n    } else if (this.isBillingAddress) {\r\n      return AddressType.BILLING;\r\n    } else if (this.isShippingAddress) {\r\n      return AddressType.SHIPPING;\r\n    } else {\r\n      return AddressType.NONE;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Static method to check if a given AddressType includes shipping.\r\n   * @param addressType - The address type to check.\r\n   * @returns True if the type is SHIPPING or BILLING_AND_SHIPPING.\r\n   */\r\n  static checkIfShippingAddress(addressType: AddressType): boolean {\r\n    return addressType === AddressType.SHIPPING || addressType === AddressType.BILLING_AND_SHIPPING;\r\n  }\r\n\r\n  /**\r\n   * Static method to check if a given AddressType includes billing.\r\n   * @param addressType - The address type to check.\r\n   * @returns True if the type is BILLING or BILLING_AND_SHIPPING.\r\n   */\r\n  static checkIfBillingAddress(addressType: AddressType): boolean {\r\n    return addressType === AddressType.BILLING || addressType === AddressType.BILLING_AND_SHIPPING;\r\n  }\r\n}"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "b23-lib",
-  "version": "1.7.4",
+  "version": "1.7.6",
   "description": "This repo hold common classes, type and util functiona",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/dist/chunk-SPLTJRHG.mjs

@@ -1,2 +0,0 @@
-var i=class{customFields;version;createdAt;modifiedAt;modifiedBy;constructor(e,t=new Date){this.customFields={...e.customFields},this.version=e.version??1,this.createdAt=e.createdAt&&!isNaN(Date.parse(e.createdAt))?new Date(e.createdAt).toISOString():t.toISOString(),this.modifiedAt=e.modifiedAt&&!isNaN(Date.parse(e.modifiedAt))?new Date(e.modifiedAt).toISOString():t.toISOString(),this.modifiedBy=e.modifiedBy??"";}getDetails(){return {customFields:this.getAllCustomFields(),version:this.getVersion(),createdAt:this.getCreatedAt(),modifiedAt:this.getModifiedAt(),modifiedBy:this.getModifiedBy()}}getVersion(){return this.version}getCreatedAt(){return this.createdAt}getCreatedAtTime(){return new Date(this.createdAt).getTime()}getModifiedAt(){return this.modifiedAt}getModifiedAtTime(){return new Date(this.modifiedAt).getTime()}getModifiedBy(){return this.modifiedBy}setModifiedBy(e){this.modifiedBy=e;}getCustomField(e){return this.customFields[e]??null}setCustomField(e,t){this.customFields[e]=t;}getAllCustomFields(){return {...this.customFields}}};export{i as a};//# sourceMappingURL=chunk-SPLTJRHG.mjs.map
-//# sourceMappingURL=chunk-SPLTJRHG.mjs.map

package/dist/chunk-SPLTJRHG.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/Classes/Base.ts"],"names":["BaseModel","data","date","modifiedBy","fieldName","value"],"mappings":"AA0BA,IAAqBA,EAArB,KAA+B,CACnB,aACA,OACA,CAAA,SAAA,CACA,WACA,UAQV,CAAA,WAAA,CAAYC,EAAsBC,CAAa,CAAA,IAAI,KAAQ,CACzD,IAAA,CAAK,aAAe,CAAE,GAAGD,EAAK,YAAa,CAAA,CAC3C,IAAK,CAAA,OAAA,CAAUA,EAAK,OAAW,EAAA,CAAA,CAC/B,KAAK,SAAYA,CAAAA,CAAAA,CAAK,WAAa,CAAC,KAAA,CAAM,KAAK,KAAMA,CAAAA,CAAAA,CAAK,SAAS,CAAC,CAAA,CAElE,IAAI,IAAKA,CAAAA,CAAAA,CAAK,SAAS,CAAE,CAAA,WAAA,EAEzBC,CAAAA,CAAAA,CAAK,aACP,CAAA,IAAA,CAAK,WAAaD,CAAK,CAAA,UAAA,EAAc,CAAC,KAAM,CAAA,IAAA,CAAK,MAAMA,CAAK,CAAA,UAAU,CAAC,CACnE,CAAA,IAAI,KAAKA,CAAK,CAAA,UAAU,EAAE,WAAY,EAAA,CACtCC,EAAK,WAAY,EAAA,CAErB,KAAK,UAAaD,CAAAA,CAAAA,CAAK,YAAc,GACvC,CAMA,YAAuB,CACrB,OAAO,CACL,YAAc,CAAA,IAAA,CAAK,oBACnB,CAAA,OAAA,CAAS,KAAK,UAAW,EAAA,CACzB,UAAW,IAAK,CAAA,YAAA,EAChB,CAAA,UAAA,CAAY,KAAK,aAAc,EAAA,CAC/B,WAAY,IAAK,CAAA,aAAA,EACnB,CACF,CAMA,YAAqB,CACnB,OAAO,KAAK,OACd,CAMA,cAAuB,CACrB,OAAO,KAAK,SACd,CAMA,kBAA2B,CACzB,OAAO,IAAI,IAAK,CAAA,IAAA,CAAK,SAAS,CAAE,CAAA,OAAA,EAClC,CAOA,aAAA,EAAwB,CACtB,OAAO,IAAA,CAAK,UACd,CAMA,iBAAA,EAA4B,CAC1B,OAAO,IAAI,KAAK,IAAK,CAAA,UAAU,CAAE,CAAA,OAAA,EACnC,CAMA,aAAA,EAAwB,CACtB,OAAO,IAAA,CAAK,UACd,CAMA,aAAA,CAAcE,EAA0B,CACtC,IAAA,CAAK,WAAaA,EACpB,CAOA,eAAeC,CAAwB,CAAA,CACrC,OAAO,IAAK,CAAA,YAAA,CAAaA,CAAS,CAAK,EAAA,IACzC,CAQA,cAAeA,CAAAA,CAAAA,CAAmBC,EAAkB,CAClD,IAAA,CAAK,aAAaD,CAAS,CAAA,CAAIC,EACjC,CAMA,kBAAA,EAAmC,CACjC,OAAO,CAAE,GAAG,IAAK,CAAA,YAAa,CAChC,CACF","file":"chunk-SPLTJRHG.mjs","sourcesContent":["import { ISODateTime } from \"./Common\";\r\n\r\nexport interface CustomFields {\r\n  [key: string]: any;\r\n}\r\n\r\nexport type BaseAttributes = {\r\n  customFields?: CustomFields;\r\n  version?: number;\r\n  createdAt?: ISODateTime;\r\n  modifiedAt?: ISODateTime;\r\n  modifiedBy?: string;\r\n};\r\n\r\nexport type BaseData = {\r\n  customFields: CustomFields;\r\n  version: number;\r\n  createdAt: ISODateTime;\r\n  modifiedAt: ISODateTime;\r\n  modifiedBy: string;\r\n};\r\n\r\n/**\r\n * Provides common foundational properties and methods for other data models.\r\n * Handles tracking of custom fields, versioning, and timestamps.\r\n */\r\nexport default class BaseModel {\r\n  protected customFields: CustomFields;\r\n  protected version: number;\r\n  protected createdAt: ISODateTime;\r\n  protected modifiedAt: ISODateTime;\r\n  protected modifiedBy: string;\r\n\r\n  /**\r\n   * Creates an instance of BaseModel.\r\n   * Initializes common properties like timestamps, version, and custom fields.\r\n   * @param data - Optional initial attributes for the base model.\r\n   * @param date - Optional date object to use for default timestamps (defaults to current time).\r\n   */\r\n  constructor(data: BaseAttributes, date: Date = new Date()) {\r\n    this.customFields = { ...data.customFields };\r\n    this.version = data.version ?? 1;\r\n    this.createdAt = data.createdAt && !isNaN(Date.parse(data.createdAt))\r\n      ?\r\n      new Date(data.createdAt).toISOString()\r\n      :\r\n      date.toISOString();\r\n    this.modifiedAt = data.modifiedAt && !isNaN(Date.parse(data.modifiedAt))\r\n      ? new Date(data.modifiedAt).toISOString()\r\n      : date.toISOString();\r\n\r\n    this.modifiedBy = data.modifiedBy ?? '';\r\n  }\r\n\r\n  /**\r\n   * Gets a plain data object representing the base model's current state.\r\n   * @returns BaseData object containing common properties.\r\n   */\r\n  getDetails(): BaseData {\r\n    return {\r\n      customFields: this.getAllCustomFields(), // Use getter to return a copy\r\n      version: this.getVersion(),\r\n      createdAt: this.getCreatedAt(),\r\n      modifiedAt: this.getModifiedAt(),\r\n      modifiedBy: this.getModifiedBy(),\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Gets the current version number of the model instance.\r\n   * @returns The version number.\r\n   */\r\n  getVersion(): number {\r\n    return this.version;\r\n  }\r\n\r\n  /**\r\n   * Gets the creation timestamp as an ISO 8601 string.\r\n   * @returns The creation timestamp string.\r\n   */\r\n  getCreatedAt(): string {\r\n    return this.createdAt;\r\n  }\r\n\r\n  /**\r\n   * Gets the creation timestamp as a Unix epoch time (milliseconds).\r\n   * @returns The creation time in milliseconds since the epoch.\r\n   */\r\n  getCreatedAtTime(): number {\r\n    return new Date(this.createdAt).getTime();\r\n  }\r\n\r\n\r\n  /**\r\n   * Gets the last modification timestamp as an ISO 8601 string.\r\n   * @returns The last modification timestamp string.\r\n   */\r\n  getModifiedAt(): string {\r\n    return this.modifiedAt;\r\n  }\r\n\r\n  /**\r\n   * Gets the last modification timestamp as a Unix epoch time (milliseconds).\r\n   * @returns The last modification time in milliseconds since the epoch.\r\n   */\r\n  getModifiedAtTime(): number {\r\n    return new Date(this.modifiedAt).getTime();\r\n  }\r\n\r\n  /**\r\n   * Gets the identifier of the user or process that last modified the instance.\r\n   * @returns The modifier identifier string.\r\n   */\r\n  getModifiedBy(): string {\r\n    return this.modifiedBy;\r\n  }\r\n\r\n  /**\r\n   * Sets the identifier of the user or process that last modified the instance.\r\n   * @param modifiedBy - The identifier string.\r\n   */\r\n  setModifiedBy(modifiedBy: string): void {\r\n    this.modifiedBy = modifiedBy;\r\n  }\r\n\r\n  /**\r\n   * Retrieves the value of a specific custom field.\r\n   * @param fieldName - The name (key) of the custom field to retrieve.\r\n   * @returns The value of the custom field, or null if the field does not exist.\r\n   */\r\n  getCustomField(fieldName: string): any {\r\n    return this.customFields[fieldName] ?? null;\r\n  }\r\n\r\n  /**\r\n   * Sets the value of a specific custom field.\r\n   * Also updates the modification timestamp and increments the version.\r\n   * @param fieldName - The name (key) of the custom field to set.\r\n   * @param value - The value to assign to the custom field.\r\n   */\r\n  setCustomField(fieldName: string, value: any): void {\r\n    this.customFields[fieldName] = value;\r\n  }\r\n\r\n  /**\r\n   * Retrieves a shallow copy of all custom fields associated with the instance.\r\n   * @returns An object containing all custom fields.\r\n   */\r\n  getAllCustomFields(): CustomFields {\r\n    return { ...this.customFields };\r\n  }\r\n}\r\n"]}