Discounts

npm install @86d-store/discounts

import discounts from "@86d-store/discounts";
import { createModuleClient } from "@86d-store/core";

const client = createModuleClient([discounts()]);

{
  code: string;
  subtotal: number;         // cart subtotal in cents
  productIds?: string[];    // for product-scoped discounts
  categoryIds?: string[];   // for category-scoped discounts
}

{
  valid: boolean;
  discountAmount: number;   // in cents; 0 for free_shipping type
  freeShipping: boolean;
  error?: string;           // present when valid is false
}

<DiscountCodeInput />

<DiscountCodeInput
  subtotal={cartSubtotal}
  compact={true}
  onApplied={(result) => console.log(result)}
/>

<CartDiscounts />

<DiscountBanner />

<AutoAppliedSavings />

type DiscountType = "percentage" | "fixed_amount" | "free_shipping";

type DiscountAppliesTo =
  | "all"
  | "specific_products"
  | "specific_categories";

interface Discount {
  id: string;
  name: string;
  description?: string;
  type: DiscountType;
  value: number;                // percentage 0 to 100, cents, or 0 for free_shipping
  minimumAmount?: number;       // minimum cart subtotal in cents
  maximumUses?: number;         // null = unlimited
  usedCount: number;
  isActive: boolean;
  startsAt?: Date;
  endsAt?: Date;
  appliesTo: DiscountAppliesTo;
  appliesToIds: string[];       // product or category IDs when scoped
  stackable: boolean;
  metadata?: Record<string, unknown>;
  createdAt: Date;
  updatedAt: Date;
}

interface DiscountCode {
  id: string;
  discountId: string;
  code: string;                 // stored uppercase
  usedCount: number;
  maximumUses?: number;         // null = unlimited
  isActive: boolean;
  createdAt: Date;
  updatedAt: Date;
}

interface ApplyResult {
  valid: boolean;
  discountAmount: number;       // in cents; 0 for free_shipping type
  freeShipping: boolean;
  discount?: Discount;
  code?: DiscountCode;
  error?: string;               // reason when valid is false
}