coupons

type AppliesAt string

type CachedRepository struct {
	// contains filtered or unexported fields
}

type Coupon struct {
	Code          string            // Coupon code (e.g., "SUMMER2024")
	DiscountType  DiscountType      // "percentage" or "fixed"
	DiscountValue float64           // Percentage (0-100) or fixed amount
	Currency      string            // For fixed discounts (usd, usdc, etc.)
	Scope         Scope             // "all" or "specific"
	ProductIDs    []string          // Applicable product IDs (for scope=specific)
	PaymentMethod PaymentMethod     // Restrict to specific payment method ("stripe", "x402", or "" for any)
	AutoApply     bool              // If true, automatically apply to matching products
	AppliesAt     AppliesAt         // When to display: "catalog" (product page) or "checkout" (cart only)
	UsageLimit    *int              // nil = unlimited, N = max uses
	UsageCount    int               // Current usage count
	StartsAt      *time.Time        // When coupon becomes valid
	ExpiresAt     *time.Time        // When coupon expires
	Active        bool              // Enable/disable coupon
	Metadata      map[string]string // Custom key-value pairs
	CreatedAt     time.Time         // Creation timestamp
	UpdatedAt     time.Time         // Last update timestamp
}

type DisabledRepository struct{}

type DiscountType string

type MongoDBRepository struct {
	// contains filtered or unexported fields
}

type PaymentMethod string

type PostgresRepository struct {
	// contains filtered or unexported fields
}

type Repository interface {
	// GetCoupon retrieves a coupon by code.
	GetCoupon(ctx context.Context, code string) (Coupon, error)

	// ListCoupons returns all active coupons.
	ListCoupons(ctx context.Context) ([]Coupon, error)

	// GetAutoApplyCouponsForPayment returns auto-apply coupons that match the product ID and payment method.
	// Returns coupons where AutoApply=true, product matches, and payment method matches (or is empty).
	// paymentMethod should be "stripe", "x402", or "" for any.
	GetAutoApplyCouponsForPayment(ctx context.Context, productID string, paymentMethod PaymentMethod) ([]Coupon, error)

	// GetAllAutoApplyCouponsForPayment returns all auto-apply coupons for a specific payment method.
	// Returns a map of productID -> []Coupon for efficient batch lookup.
	GetAllAutoApplyCouponsForPayment(ctx context.Context, paymentMethod PaymentMethod) (map[string][]Coupon, error)

	// CreateCoupon creates a new coupon.
	CreateCoupon(ctx context.Context, coupon Coupon) error

	// UpdateCoupon updates an existing coupon.
	UpdateCoupon(ctx context.Context, coupon Coupon) error

	// IncrementUsage atomically increments the usage count.
	IncrementUsage(ctx context.Context, code string) error

	// DeleteCoupon soft-deletes a coupon (sets active = false).
	DeleteCoupon(ctx context.Context, code string) error

	// Close closes any open connections.
	Close() error
}

type Scope string

type YAMLRepository struct {
	// contains filtered or unexported fields
}