@withwiz/coupon 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,755 @@
+/**
+ * Domain-level constants for @withwiz/coupon.
+ * No env vars, no side effects. Pure values.
+ */
+declare const COUPON_STATUS: {
+    readonly DRAFT: "DRAFT";
+    readonly ACTIVE: "ACTIVE";
+    readonly PAUSED: "PAUSED";
+    readonly EXPIRED: "EXPIRED";
+    readonly EXHAUSTED: "EXHAUSTED";
+    readonly ARCHIVED: "ARCHIVED";
+};
+type CouponStatus = (typeof COUPON_STATUS)[keyof typeof COUPON_STATUS];
+declare const CAMPAIGN_STATUS: {
+    readonly ACTIVE: "ACTIVE";
+    readonly CLOSED: "CLOSED";
+};
+type CampaignStatus = (typeof CAMPAIGN_STATUS)[keyof typeof CAMPAIGN_STATUS];
+/**
+ * Closed union of validate() reject reasons.
+ * Exactly 13 literals as frozen by sprint_contract.md §7.4.
+ */
+declare const COUPON_REJECT_REASON: {
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly NOT_STARTED: "NOT_STARTED";
+    readonly EXPIRED: "EXPIRED";
+    readonly EXHAUSTED: "EXHAUSTED";
+    readonly PER_USER_LIMIT: "PER_USER_LIMIT";
+    readonly MIN_ORDER_NOT_MET: "MIN_ORDER_NOT_MET";
+    readonly INELIGIBLE_USER: "INELIGIBLE_USER";
+    readonly INELIGIBLE_PLAN: "INELIGIBLE_PLAN";
+    readonly INELIGIBLE_PRODUCT: "INELIGIBLE_PRODUCT";
+    readonly INELIGIBLE_CATEGORY: "INELIGIBLE_CATEGORY";
+    readonly PAUSED: "PAUSED";
+    readonly ARCHIVED: "ARCHIVED";
+    readonly TENANT_MISMATCH: "TENANT_MISMATCH";
+};
+type CouponRejectReason = (typeof COUPON_REJECT_REASON)[keyof typeof COUPON_REJECT_REASON];
+/**
+ * Sanitization and resource limits.
+ * - [A] code length cap / allowed charset
+ * - [C] tenantId format
+ * - [I] bulk count cap
+ * - [J] maxAttempts cap
+ * - [K] cursor pagination limits
+ */
+declare const LIMITS: {
+    readonly CODE_MAX_LENGTH: 64;
+    readonly CODE_MIN_LENGTH: 1;
+    /**
+     * Default character set for generated codes (confusing chars removed).
+     * Excludes `0/O`, `1/I/L` and lower-case to avoid user transcription errors.
+     */
+    readonly CODE_DEFAULT_ALPHABET: "ABCDEFGHJKMNPQRSTUVWXYZ23456789";
+    readonly CODE_DEFAULT_LENGTH: 8;
+    /**
+     * [A] whitelist for accepted coupon codes (after NFKC normalization + upper-case).
+     * Only uppercase ASCII letters, digits, underscore, hyphen are allowed.
+     * SQL meta characters / quotes / spaces / CJK / emoji are all rejected.
+     */
+    readonly CODE_ALLOWED_REGEX: RegExp;
+    readonly TENANT_ID_MAX_LENGTH: 64;
+    readonly TENANT_ID_REGEX: RegExp;
+    readonly BULK_MAX_COUNT: 10000;
+    readonly BULK_MAX_ATTEMPTS: 5;
+    readonly BULK_DEFAULT_MAX_ATTEMPTS: 3;
+    readonly PAGINATION_DEFAULT_LIMIT: 50;
+    readonly PAGINATION_MAX_LIMIT: 200;
+    readonly NAME_MAX_LENGTH: 200;
+    readonly CURRENCY_LENGTH: 3;
+};
+/**
+ * Audit log action strings (stable identifiers).
+ */
+declare const AUDIT_ACTION: {
+    readonly COUPON_CREATED: "coupon.created";
+    readonly COUPON_PAUSED: "coupon.paused";
+    readonly COUPON_RESUMED: "coupon.resumed";
+    readonly COUPON_ARCHIVED: "coupon.archived";
+    readonly COUPON_ISSUED: "coupon.issued";
+    readonly COUPON_ISSUED_BULK: "coupon.issued.bulk";
+    readonly COUPON_REDEEMED: "coupon.redeemed";
+    readonly COUPON_REDEEM_REJECTED: "coupon.redeem.rejected";
+    readonly CAMPAIGN_CREATED: "campaign.created";
+    readonly CAMPAIGN_CLOSED: "campaign.closed";
+};
+type AuditAction = (typeof AUDIT_ACTION)[keyof typeof AUDIT_ACTION];
+
+/**
+ * Public DTO & domain types for @withwiz/coupon.
+ * No Prisma generated types imported here (see contract §10 PrismaLike rule).
+ */
+
+type DiscountPolicy = {
+    kind: "PERCENT";
+    percent: number;
+    maxDiscount?: number;
+    minOrder?: number;
+    currency?: string;
+} | {
+    kind: "FIXED";
+    amount: number;
+    currency: string;
+    minOrder?: number;
+};
+type EligibilityRules = {
+    allowedUserIds?: string[];
+    allowedPlans?: string[];
+    allowedProductIds?: string[];
+    allowedCategories?: string[];
+};
+type Coupon = {
+    id: string;
+    tenantId: string;
+    campaignId: string | null;
+    code: string;
+    status: CouponStatus;
+    discount: DiscountPolicy;
+    startsAt: Date | null;
+    endsAt: Date | null;
+    maxRedemptions: number | null;
+    redeemedCount: number;
+    maxRedemptionsPerUser: number | null;
+    eligibility: EligibilityRules;
+    metadata: Record<string, unknown> | null;
+    createdAt: Date;
+    updatedAt: Date;
+};
+type Campaign = {
+    id: string;
+    tenantId: string;
+    name: string;
+    status: CampaignStatus;
+    discount: DiscountPolicy;
+    eligibility: EligibilityRules;
+    startsAt: Date | null;
+    endsAt: Date | null;
+    maxCoupons: number | null;
+    issuedCount: number;
+    metadata: Record<string, unknown> | null;
+    createdAt: Date;
+    updatedAt: Date;
+};
+type Issuance = {
+    id: string;
+    tenantId: string;
+    couponId: string;
+    issuedToUserId: string | null;
+    issuedBy: string | null;
+    issuedAt: Date;
+    metadata: Record<string, unknown> | null;
+};
+type Redemption = {
+    id: string;
+    tenantId: string;
+    couponId: string;
+    redeemedByUserId: string | null;
+    orderRef: string | null;
+    discountAmount: number;
+    currency: string;
+    redeemedAt: Date;
+    metadata: Record<string, unknown> | null;
+};
+type AuditLog = {
+    id: string;
+    tenantId: string;
+    action: string;
+    resourceId: string | null;
+    resourceType: string | null;
+    actorId: string | null;
+    details: Record<string, unknown> | null;
+    createdAt: Date;
+};
+type CreateCouponInput = {
+    tenantId?: string;
+    code?: string;
+    codeLength?: number;
+    campaignId?: string;
+    discount: DiscountPolicy;
+    startsAt?: Date | null;
+    endsAt?: Date | null;
+    maxRedemptions?: number | null;
+    maxRedemptionsPerUser?: number | null;
+    eligibility?: EligibilityRules;
+    metadata?: Record<string, unknown> | null;
+    status?: CouponStatus;
+    actorId?: string;
+};
+type IssueCouponInput = {
+    tenantId?: string;
+    couponId: string;
+    issuedToUserId?: string | null;
+    issuedBy?: string | null;
+    metadata?: Record<string, unknown> | null;
+};
+type IssueBulkInput = {
+    tenantId?: string;
+    count: number;
+    codeLength?: number;
+    campaignId?: string;
+    discount: DiscountPolicy;
+    startsAt?: Date | null;
+    endsAt?: Date | null;
+    maxRedemptions?: number | null;
+    maxRedemptionsPerUser?: number | null;
+    eligibility?: EligibilityRules;
+    metadata?: Record<string, unknown> | null;
+    maxAttempts?: number;
+    actorId?: string;
+};
+type BulkIssuanceResult = {
+    created: Coupon[];
+    skipped: number;
+    codes: string[];
+    attempts: number;
+};
+type ListCouponsArgs = {
+    tenantId?: string;
+    campaignId?: string;
+    status?: CouponStatus;
+    cursor?: string;
+    limit?: number;
+};
+type ListCampaignsArgs = {
+    tenantId?: string;
+    status?: CampaignStatus;
+    cursor?: string;
+    limit?: number;
+};
+type ListIssuancesArgs = {
+    tenantId?: string;
+    couponId?: string;
+    issuedToUserId?: string;
+    cursor?: string;
+    limit?: number;
+};
+type ListRedemptionsArgs = {
+    tenantId?: string;
+    couponId?: string;
+    redeemedByUserId?: string;
+    cursor?: string;
+    limit?: number;
+};
+type ListAuditLogsArgs = {
+    tenantId?: string;
+    action?: string;
+    resourceId?: string;
+    resourceType?: string;
+    cursor?: string;
+    limit?: number;
+};
+type Paged<T> = {
+    items: T[];
+    nextCursor: string | null;
+};
+type ValidateContext = {
+    plan?: string;
+    productId?: string;
+    categoryId?: string;
+};
+type ValidateInput = {
+    tenantId?: string;
+    code: string;
+    userId?: string | null;
+    subtotal?: number;
+    currency?: string;
+    context?: ValidateContext;
+};
+type ValidationResult = {
+    ok: true;
+    coupon: Coupon;
+    discountPreview: DiscountBreakdown | null;
+} | {
+    ok: false;
+    reason: CouponRejectReason;
+};
+type DiscountInput = {
+    subtotal: number;
+    currency: string;
+    policy: DiscountPolicy;
+};
+type DiscountBreakdown = {
+    subtotal: number;
+    discountAmount: number;
+    total: number;
+    appliedPolicy: DiscountPolicy;
+    trace: string[];
+    currency: string;
+};
+type RedeemInput = {
+    tenantId?: string;
+    code: string;
+    userId?: string | null;
+    orderRef?: string | null;
+    subtotal: number;
+    currency: string;
+    context?: ValidateContext;
+    metadata?: Record<string, unknown> | null;
+    /**
+     * Consumer's Prisma transaction client. When provided, redeem() "piggybacks"
+     * on this transaction instead of opening a new one.
+     */
+    tx?: PrismaTxLike;
+};
+type RedemptionResult = {
+    redemption: Redemption;
+    coupon: Coupon;
+    discount: DiscountBreakdown;
+};
+type CreateCampaignInput = {
+    tenantId?: string;
+    name: string;
+    discount: DiscountPolicy;
+    eligibility?: EligibilityRules;
+    startsAt?: Date | null;
+    endsAt?: Date | null;
+    maxCoupons?: number | null;
+    metadata?: Record<string, unknown> | null;
+    actorId?: string;
+};
+type CampaignIssueArgs = {
+    tenantId?: string;
+    campaignId: string;
+    count: number;
+    codeLength?: number;
+    maxAttempts?: number;
+    actorId?: string;
+};
+type CampaignSummary = {
+    id: string;
+    tenantId: string;
+    name: string;
+    status: CampaignStatus;
+    issuedCount: number;
+    redeemedCount: number;
+    remaining: number | null;
+    totalDiscount: number;
+    uniqueUsers: number;
+    lastRedeemedAt: Date | null;
+};
+type CouponEvent = {
+    type: "coupon.created";
+    at: Date;
+    tenantId: string;
+    coupon: Coupon;
+} | {
+    type: "coupon.issued";
+    at: Date;
+    tenantId: string;
+    issuance: Issuance;
+} | {
+    type: "coupon.issued.bulk";
+    at: Date;
+    tenantId: string;
+    campaignId?: string;
+    count: number;
+} | {
+    type: "coupon.redeemed";
+    at: Date;
+    tenantId: string;
+    redemption: Redemption;
+} | {
+    type: "coupon.redeem.rejected";
+    at: Date;
+    tenantId: string;
+    code: string;
+    reason: CouponRejectReason;
+    userId?: string | null;
+    orderRef?: string | null;
+} | {
+    type: "coupon.paused";
+    at: Date;
+    tenantId: string;
+    couponId: string;
+} | {
+    type: "coupon.resumed";
+    at: Date;
+    tenantId: string;
+    couponId: string;
+} | {
+    type: "coupon.archived";
+    at: Date;
+    tenantId: string;
+    couponId: string;
+} | {
+    type: "campaign.created";
+    at: Date;
+    tenantId: string;
+    campaign: Campaign;
+} | {
+    type: "campaign.closed";
+    at: Date;
+    tenantId: string;
+    campaignId: string;
+};
+interface CouponEventHandler {
+    onEvent(event: CouponEvent): void | Promise<void>;
+}
+interface CouponLogger {
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Minimal structural interface for the subset of PrismaClient methods we use.
+ * Consumers pass their own PrismaClient which will structurally match this.
+ *
+ * We deliberately AVOID importing any type from @prisma/client.
+ */
+type WhereInput = Record<string, unknown>;
+type OrderByInput = Record<string, unknown> | Record<string, unknown>[];
+interface FindFirstArgs {
+    where?: WhereInput;
+    orderBy?: OrderByInput;
+    select?: Record<string, unknown>;
+    include?: Record<string, unknown>;
+}
+interface FindUniqueArgs {
+    where: WhereInput;
+    select?: Record<string, unknown>;
+    include?: Record<string, unknown>;
+}
+interface FindManyArgs {
+    where?: WhereInput;
+    orderBy?: OrderByInput;
+    take?: number;
+    skip?: number;
+    cursor?: WhereInput;
+    select?: Record<string, unknown>;
+    include?: Record<string, unknown>;
+}
+interface CreateArgs {
+    data: Record<string, unknown>;
+    select?: Record<string, unknown>;
+}
+interface CreateManyArgs {
+    data: Record<string, unknown>[];
+    skipDuplicates?: boolean;
+}
+interface UpdateArgs {
+    where: WhereInput;
+    data: Record<string, unknown>;
+    select?: Record<string, unknown>;
+}
+interface UpdateManyArgs {
+    where: WhereInput;
+    data: Record<string, unknown>;
+}
+interface CountArgs {
+    where?: WhereInput;
+}
+interface AggregateArgs {
+    where?: WhereInput;
+    _sum?: Record<string, true>;
+    _count?: Record<string, true> | true;
+    _max?: Record<string, true>;
+}
+interface DelegateLike<TRow = Record<string, unknown>> {
+    findFirst(args?: FindFirstArgs): Promise<TRow | null>;
+    findUnique(args: FindUniqueArgs): Promise<TRow | null>;
+    findMany(args?: FindManyArgs): Promise<TRow[]>;
+    create(args: CreateArgs): Promise<TRow>;
+    createMany(args: CreateManyArgs): Promise<{
+        count: number;
+    }>;
+    update(args: UpdateArgs): Promise<TRow>;
+    updateMany(args: UpdateManyArgs): Promise<{
+        count: number;
+    }>;
+    count(args?: CountArgs): Promise<number>;
+    aggregate?(args: AggregateArgs): Promise<Record<string, unknown>>;
+}
+interface PrismaTxLike {
+    /**
+     * Delegates produced by the unmodified schema fragment.
+     *
+     * They are optional on purpose: a consumer who renamed the models to avoid
+     * a collision (and declared the mapping through `config.models`) still
+     * satisfies this interface. Delegates are never read off this type
+     * directly — `createDelegateResolver` looks them up by their configured
+     * name at call time and raises `InvalidModelNameError` when one is absent.
+     */
+    coupon?: DelegateLike;
+    campaign?: DelegateLike;
+    couponIssuance?: DelegateLike;
+    couponRedemption?: DelegateLike;
+    couponAuditLog?: DelegateLike;
+    /**
+     * Parameterized raw query — used only for `SELECT ... FOR UPDATE` row locks
+     * in the redeem() concurrency path. Tagged-template style.
+     */
+    $queryRaw<T = unknown>(strings: TemplateStringsArray, ...values: unknown[]): Promise<T>;
+}
+interface PrismaLike extends PrismaTxLike {
+    $transaction<T>(fn: (tx: PrismaTxLike) => Promise<T>, options?: {
+        maxWait?: number;
+        timeout?: number;
+        isolationLevel?: string;
+    }): Promise<T>;
+}
+
+/**
+ * Prisma delegate / physical table resolution.
+ *
+ * The schema fragment ships five models (`Coupon`, `Campaign`,
+ * `CouponIssuance`, `CouponRedemption`, `CouponAuditLog`). A consumer whose
+ * own schema already owns one of those names — `Campaign` is the common
+ * collision — can rename them and declare the mapping through
+ * `createCouponClient({ models, tables })`.
+ *
+ * Every delegate access and every raw-SQL table reference in this package is
+ * routed through the resolver built here, so no model name is hardcoded
+ * anywhere else in `src/`.
+ */
+
+/** The five logical models this package owns. */
+type CouponModelKey = "coupon" | "campaign" | "couponIssuance" | "couponRedemption" | "couponAuditLog";
+/** Prisma delegate property names, keyed by logical model. */
+type ModelNameMap = Record<CouponModelKey, string>;
+/** Physical table names (as they appear in SQL), keyed by logical model. */
+type TableNameMap = Record<CouponModelKey, string>;
+/** Delegate names produced by the unmodified schema fragment. */
+declare const DEFAULT_MODEL_NAMES: ModelNameMap;
+
+/**
+ * createCouponClient — factory for the coupon domain client.
+ *
+ * Implements spec.md §4 public API, concurrency algorithm (§9.3),
+ * multi-tenant guards, audit logging, and pluggable event emission.
+ */
+
+type CouponClientConfig = {
+    prisma: PrismaLike;
+    defaultTenantId?: string;
+    idGenerator?: () => string;
+    codeGenerator?: (opts: {
+        length: number;
+        alphabet?: string;
+    }) => string;
+    events?: CouponEventHandler;
+    now?: () => Date;
+    logger?: CouponLogger;
+    /**
+     * Prisma delegate names, when the schema fragment's models were renamed to
+     * avoid a collision with the consumer's own schema. Defaults to
+     * `{ coupon, campaign, couponIssuance, couponRedemption, couponAuditLog }`.
+     *
+     * @example { campaign: "couponCampaign" }
+     */
+    models?: Partial<ModelNameMap>;
+    /**
+     * Physical table names, used by the `SELECT ... FOR UPDATE` row lock in
+     * `redeem()`. Defaults to each delegate name capitalized, which is Prisma's
+     * own convention; pass this only when the schema uses `@@map`.
+     *
+     * @example { coupon: "coupons" }
+     */
+    tables?: Partial<TableNameMap>;
+};
+interface CouponClient {
+    coupons: {
+        create(input: CreateCouponInput): Promise<Coupon>;
+        issue(input: IssueCouponInput): Promise<Issuance>;
+        issueBulk(input: IssueBulkInput): Promise<BulkIssuanceResult>;
+        findByCode(args: {
+            tenantId?: string;
+            code: string;
+        }): Promise<Coupon | null>;
+        get(args: {
+            tenantId?: string;
+            id: string;
+        }): Promise<Coupon | null>;
+        list(args: ListCouponsArgs): Promise<Paged<Coupon>>;
+        pause(args: {
+            tenantId?: string;
+            id: string;
+            actorId?: string;
+        }): Promise<Coupon>;
+        resume(args: {
+            tenantId?: string;
+            id: string;
+            actorId?: string;
+        }): Promise<Coupon>;
+        archive(args: {
+            tenantId?: string;
+            id: string;
+            actorId?: string;
+        }): Promise<Coupon>;
+    };
+    validate(input: ValidateInput): Promise<ValidationResult>;
+    redeem(input: RedeemInput): Promise<RedemptionResult>;
+    discount: {
+        calculate(input: DiscountInput): DiscountBreakdown;
+    };
+    campaigns: {
+        create(input: CreateCampaignInput): Promise<Campaign>;
+        get(args: {
+            tenantId?: string;
+            id: string;
+        }): Promise<Campaign | null>;
+        list(args: ListCampaignsArgs): Promise<Paged<Campaign>>;
+        issue(args: CampaignIssueArgs): Promise<BulkIssuanceResult>;
+        summary(args: {
+            tenantId?: string;
+            id: string;
+        }): Promise<CampaignSummary>;
+        close(args: {
+            tenantId?: string;
+            id: string;
+            actorId?: string;
+        }): Promise<Campaign>;
+    };
+    audit: {
+        listIssuances(args: ListIssuancesArgs): Promise<Paged<Issuance>>;
+        listRedemptions(args: ListRedemptionsArgs): Promise<Paged<Redemption>>;
+        listLogs(args: ListAuditLogsArgs): Promise<Paged<AuditLog>>;
+    };
+}
+declare function createCouponClient(config: CouponClientConfig): CouponClient;
+
+/**
+ * Pure discount calculation engine.
+ *
+ * [N] NO side effects, NO I/O, NO time dependency.
+ * The only exceptions it throws are validation-level CouponError subclasses
+ * that correspond to the input itself (not to coupon state).
+ */
+
+/**
+ * Validates the shape of a DiscountPolicy. Throws InvalidDiscountPolicyError
+ * on any violation. Public so it can be re-used by validators.
+ */
+declare function validateDiscountPolicy(policy: DiscountPolicy): void;
+/**
+ * Pure discount calculation. Returns a DiscountBreakdown with total >= 0.
+ * Throws CurrencyMismatchError if input.currency != policy.currency (when policy carries one).
+ * Throws MinimumOrderNotMetError if subtotal < policy.minOrder.
+ */
+declare function calculate(input: DiscountInput): DiscountBreakdown;
+
+/**
+ * Error taxonomy for @withwiz/coupon.
+ *
+ * All errors extend CouponError. Each concrete subclass exposes a static
+ * `code` string that matches the corresponding CouponRejectReason value
+ * (where applicable — see sprint_contract.md §7.4).
+ *
+ * All messages are in English. i18n is a consumer concern.
+ */
+interface CouponErrorContext {
+    tenantId?: string;
+    couponId?: string;
+    couponCode?: string;
+    cause?: unknown;
+}
+declare abstract class CouponError extends Error {
+    readonly name: string;
+    readonly code: string;
+    readonly tenantId?: string;
+    readonly couponId?: string;
+    readonly couponCode?: string;
+    readonly cause?: unknown;
+    protected constructor(message: string, code: string, ctx?: CouponErrorContext);
+}
+declare class ValidationError extends CouponError {
+    static readonly code = "VALIDATION_ERROR";
+    readonly details?: unknown;
+    constructor(message: string, details?: unknown, ctx?: CouponErrorContext);
+}
+declare class InvalidDiscountPolicyError extends CouponError {
+    static readonly code = "INVALID_DISCOUNT_POLICY";
+    constructor(message: string, ctx?: CouponErrorContext);
+}
+declare class InvalidDateRangeError extends CouponError {
+    static readonly code = "INVALID_DATE_RANGE";
+    constructor(message: string, ctx?: CouponErrorContext);
+}
+declare class CurrencyMismatchError extends CouponError {
+    static readonly code = "CURRENCY_MISMATCH";
+    constructor(message: string, ctx?: CouponErrorContext);
+}
+/**
+ * Raised when `config.models` / `config.tables` name something the client
+ * cannot resolve, or when a name is not a plain SQL identifier. This is a
+ * wiring mistake, not an end-user input error: a malformed name is rejected
+ * while the client is being created, and a name that resolves to no delegate
+ * is rejected on the first call that touches it.
+ */
+declare class InvalidModelNameError extends CouponError {
+    static readonly code = "INVALID_MODEL_NAME";
+    constructor(message: string, ctx?: CouponErrorContext);
+}
+declare class CouponNotFoundError extends CouponError {
+    static readonly code = "NOT_FOUND";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class CouponArchivedError extends CouponError {
+    static readonly code = "ARCHIVED";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class CouponInactiveError extends CouponError {
+    static readonly code = "PAUSED";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class CouponExpiredError extends CouponError {
+    static readonly code = "EXPIRED";
+    constructor(message?: string, ctx?: CouponErrorContext, codeOverride?: "EXPIRED" | "NOT_STARTED");
+}
+declare class CouponExhaustedError extends CouponError {
+    static readonly code = "EXHAUSTED";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class CouponAlreadyRedeemedError extends CouponError {
+    static readonly code = "ALREADY_REDEEMED";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class PerUserLimitExceededError extends CouponError {
+    static readonly code = "PER_USER_LIMIT";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class IneligibleUserError extends CouponError {
+    static readonly code = "INELIGIBLE_USER";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class IneligiblePlanError extends CouponError {
+    static readonly code = "INELIGIBLE_PLAN";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class IneligibleProductError extends CouponError {
+    static readonly code = "INELIGIBLE_PRODUCT";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class IneligibleCategoryError extends CouponError {
+    static readonly code = "INELIGIBLE_CATEGORY";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class MinimumOrderNotMetError extends CouponError {
+    static readonly code = "MIN_ORDER_NOT_MET";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class CampaignClosedError extends CouponError {
+    static readonly code = "CAMPAIGN_CLOSED";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class CampaignCapacityExceededError extends CouponError {
+    static readonly code = "CAMPAIGN_CAPACITY_EXCEEDED";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+declare class TenantMismatchError extends CouponError {
+    static readonly code = "TENANT_MISMATCH";
+    constructor(message?: string, ctx?: CouponErrorContext);
+}
+
+export { AUDIT_ACTION, type AuditAction, type AuditLog, type BulkIssuanceResult, CAMPAIGN_STATUS, COUPON_REJECT_REASON, COUPON_STATUS, type Campaign, CampaignCapacityExceededError, CampaignClosedError, type CampaignIssueArgs, type CampaignStatus, type CampaignSummary, type Coupon, CouponAlreadyRedeemedError, CouponArchivedError, type CouponClient, type CouponClientConfig, CouponError, type CouponEvent, type CouponEventHandler, CouponExhaustedError, CouponExpiredError, CouponInactiveError, type CouponLogger, type CouponModelKey, CouponNotFoundError, type CouponRejectReason, type CouponStatus, type CreateCampaignInput, type CreateCouponInput, CurrencyMismatchError, DEFAULT_MODEL_NAMES, type DiscountBreakdown, type DiscountInput, type DiscountPolicy, type EligibilityRules, IneligibleCategoryError, IneligiblePlanError, IneligibleProductError, IneligibleUserError, InvalidDateRangeError, InvalidDiscountPolicyError, InvalidModelNameError, type Issuance, type IssueBulkInput, type IssueCouponInput, LIMITS, type ListAuditLogsArgs, type ListCampaignsArgs, type ListCouponsArgs, type ListIssuancesArgs, type ListRedemptionsArgs, MinimumOrderNotMetError, type ModelNameMap, type Paged, PerUserLimitExceededError, type PrismaLike, type PrismaTxLike, type RedeemInput, type Redemption, type RedemptionResult, type TableNameMap, TenantMismatchError, type ValidateContext, type ValidateInput, ValidationError, type ValidationResult, calculate as calculateDiscount, createCouponClient, validateDiscountPolicy };