@withwiz/coupon 0.2.0 → 0.3.0

package/README.md

@@ -54,7 +54,12 @@ const campaign = await coupon.campaigns.create({
   endsAt: new Date("2026-04-30"),
   maxCoupons: 10_000,
 });
-await coupon.campaigns.issue({ campaignId: campaign.id, count: 10_000, codeLength: 10 });
+await coupon.campaigns.issue({
+  campaignId: campaign.id,
+  count: 10_000,
+  codeLength: 10,
+  maxRedemptions: 1, // single-use codes; omit for unlimited
+});
 
 // 2) Customer applies a code at checkout (non-destructive preview)
 const preview = await coupon.validate({
@@ -142,10 +147,38 @@ const coupon = createCouponClient({
 });
 ```
 
-Both maps accept plain SQL identifiers only (`[A-Za-z_][A-Za-z0-9_]*`); a
+### Tables outside `public` with a driver adapter
+
+The row lock is raw SQL, so it does not inherit the schema from your Prisma
+datasource. With a driver adapter (Prisma 7, e.g. `@prisma/adapter-pg`) an
+unqualified table name resolves through the connection's `search_path`, which
+is usually `public`. If the coupon tables live in another schema, name it:
+
+```ts
+const coupon = createCouponClient({ prisma, schema: "billing" });
+```
+
+Without it, `redeem()` cannot see the coupon row and fails with `NOT_FOUND`.
+
+`models`, `tables` and `schema` accept plain SQL identifiers only (`[A-Za-z_][A-Za-z0-9_]*`); a
 malformed name raises `InvalidModelNameError` when the client is created, and
 a name that matches no delegate raises it on the first call that needs it.
 
+## Discount duration
+
+A policy may declare how many billing cycles it applies to:
+
+```ts
+discount: { kind: "PERCENT", percent: 20, duration: { kind: "REPEATING", months: 3 } }
+```
+
+`ONCE` (the default when `duration` is absent), `REPEATING` (1 to 36 months) or
+`FOREVER`. The package stores and validates it and returns it inside
+`coupon.discount` and `discount.appliedPolicy`; `resolveDuration(policy)` gives the
+effective value. Redemption still happens once. To discount later cycles of a
+subscription, keep the policy and call `calculateDiscount({ subtotal, currency, policy })`
+for each cycle on your side.
+
 ## Errors
 
 All errors extend `CouponError` and carry a stable string `code`.
@@ -301,6 +334,16 @@ pnpm install --frozen-lockfile
 pnpm run prisma:generate && pnpm run db:push && pnpm run test
 ```
 
+`examples/consumer-prisma7` runs the same kind of checks on Prisma 7 with
+`@prisma/adapter-pg`, a renamed `CouponCampaign` model and a non-`public` schema:
+
+```bash
+cd examples/consumer-prisma7
+export DATABASE_URL="postgresql://postgres:postgres@localhost:13011/coupon_test?schema=consumer_prisma7"
+pnpm install --frozen-lockfile
+pnpm run prisma:generate && pnpm run db:push && pnpm run test
+```
+
 CI provisions its own Postgres on the same port 13011, so the workflow sets
 `DATABASE_URL` itself and does not use `docker-compose.yml`.
 

package/dist/index.cjs

@@ -71,7 +71,9 @@ var LIMITS = {
   ELIGIBILITY_MAX_ENTRIES: 1e3,
   ELIGIBILITY_ENTRY_MAX_LENGTH: 128,
   /** [L] Length cap for `context.plan / productId / categoryId`. */
-  CONTEXT_VALUE_MAX_LENGTH: 128
+  CONTEXT_VALUE_MAX_LENGTH: 128,
+  /** Upper bound for `duration.months` on a REPEATING discount. */
+  DURATION_MAX_MONTHS: 36
 };
 var AUDIT_ACTION = {
   COUPON_CREATED: "coupon.created",
@@ -280,6 +282,7 @@ function validateDiscountPolicy(policy) {
     if (policy.currency !== void 0) {
       ensureCurrency(policy.currency);
     }
+    validateDuration(policy.duration);
     return;
   }
   if (policy.kind === "FIXED") {
@@ -297,6 +300,7 @@ function validateDiscountPolicy(policy) {
         );
       }
     }
+    validateDuration(policy.duration);
     return;
   }
   throw new InvalidDiscountPolicyError(
@@ -369,6 +373,27 @@ function extractPolicyCurrency(policy) {
   if (policy.kind === "PERCENT") return policy.currency;
   return void 0;
 }
+function validateDuration(duration) {
+  if (duration === void 0) return;
+  if (!duration || typeof duration !== "object") {
+    throw new InvalidDiscountPolicyError("duration must be an object");
+  }
+  const kind = duration.kind;
+  if (kind === "ONCE" || kind === "FOREVER") return;
+  if (kind === "REPEATING") {
+    const months = duration.months;
+    if (typeof months !== "number" || !Number.isInteger(months) || months < 1 || months > LIMITS.DURATION_MAX_MONTHS) {
+      throw new InvalidDiscountPolicyError(
+        `duration.months must be an integer in [1, ${LIMITS.DURATION_MAX_MONTHS}] (got ${String(months)})`
+      );
+    }
+    return;
+  }
+  throw new InvalidDiscountPolicyError(`unknown duration kind: ${String(kind)}`);
+}
+function resolveDuration(policy) {
+  return policy.duration ?? { kind: "ONCE" };
+}
 
 // src/eligibility.ts
 function checkEligibility(input) {
@@ -586,6 +611,15 @@ function assertIdentifier(kind, key, value) {
   }
   return value;
 }
+function resolveSchemaName(schema) {
+  if (schema === void 0) return void 0;
+  if (typeof schema !== "string" || !IDENTIFIER_RE.test(schema)) {
+    throw new InvalidModelNameError(
+      `Invalid schema name: ${JSON.stringify(schema)}. Expected a plain identifier matching ${IDENTIFIER_RE.source}.`
+    );
+  }
+  return schema;
+}
 function resolveModelNames(overrides) {
   const out = { ...DEFAULT_MODEL_NAMES };
   for (const key of MODEL_KEYS) {
@@ -612,19 +646,21 @@ function pick(db, key, name) {
   }
   return delegate;
 }
-function createDelegateResolver(models, tables) {
+function createDelegateResolver(models, tables, schema) {
   const resolver = {
     models,
-    tables
+    tables,
+    schema
   };
   for (const key of MODEL_KEYS) {
     resolver[key] = (db) => pick(db, key, models[key]);
   }
   return resolver;
 }
-function lockCouponRow(tx, table, couponId, tenantId) {
+function lockCouponRow(tx, table, couponId, tenantId, schema) {
+  const target = schema ? `"${schema}"."${table}"` : `"${table}"`;
   const parts = [
-    `SELECT * FROM "${table}" WHERE "id" = `,
+    `SELECT * FROM ${target} WHERE "id" = `,
     ` AND "tenantId" = `,
     ` FOR UPDATE`
   ];
@@ -929,19 +965,29 @@ function validateCreateCampaignInput(input) {
     }
   }
 }
+var discountDurationSchema = zod.z.discriminatedUnion("kind", [
+  zod.z.object({ kind: zod.z.literal("ONCE") }),
+  zod.z.object({
+    kind: zod.z.literal("REPEATING"),
+    months: zod.z.number().int().min(1).max(LIMITS.DURATION_MAX_MONTHS)
+  }),
+  zod.z.object({ kind: zod.z.literal("FOREVER") })
+]);
 zod.z.discriminatedUnion("kind", [
   zod.z.object({
     kind: zod.z.literal("PERCENT"),
     percent: zod.z.number().gt(0).lte(100),
     maxDiscount: zod.z.number().int().nonnegative().optional(),
     minOrder: zod.z.number().int().nonnegative().optional(),
-    currency: zod.z.string().length(3).optional()
+    currency: zod.z.string().length(3).optional(),
+    duration: discountDurationSchema.optional()
   }),
   zod.z.object({
     kind: zod.z.literal("FIXED"),
     amount: zod.z.number().int().positive(),
     currency: zod.z.string().length(3),
-    minOrder: zod.z.number().int().nonnegative().optional()
+    minOrder: zod.z.number().int().nonnegative().optional(),
+    duration: discountDurationSchema.optional()
   })
 ]);
 
@@ -984,7 +1030,8 @@ function resolveConfig(config) {
     // allow-now: default fallback when config.now is omitted
     logger: config.logger ?? NOOP_LOGGER,
     models,
-    tables: resolveTableNames(models, config.tables)
+    tables: resolveTableNames(models, config.tables),
+    schema: resolveSchemaName(config.schema)
   };
 }
 async function safeEmit(handler, logger, event) {
@@ -1062,7 +1109,7 @@ function withIdTieBreak(orderBy) {
 function createCouponClient(config) {
   const cfg = resolveConfig(config);
   const prisma = cfg.prisma;
-  const delegates = createDelegateResolver(cfg.models, cfg.tables);
+  const delegates = createDelegateResolver(cfg.models, cfg.tables, cfg.schema);
   const tid = (v) => resolveTenantId(v, cfg.defaultTenantId);
   async function paginate(delegate, where, limit, cursor, mapFn, orderBy = { createdAt: "desc" }) {
     const take = limit + 1;
@@ -1548,7 +1595,8 @@ function createCouponClient(config) {
       tx,
       delegates.tables.coupon,
       couponId,
-      tenantId
+      tenantId,
+      delegates.schema
     );
     if (!Array.isArray(locked) || locked.length === 0) {
       throw new CouponNotFoundError("Coupon not found", { tenantId, couponId });
@@ -1872,6 +1920,8 @@ function createCouponClient(config) {
         endsAt: campaign.endsAt,
         maxAttempts: args.maxAttempts,
         eligibility: campaign.eligibility,
+        maxRedemptions: args.maxRedemptions,
+        maxRedemptionsPerUser: args.maxRedemptionsPerUser,
         actorId: args.actorId
       });
     },
@@ -2060,4 +2110,5 @@ exports.TenantMismatchError = TenantMismatchError;
 exports.ValidationError = ValidationError;
 exports.calculateDiscount = calculate;
 exports.createCouponClient = createCouponClient;
+exports.resolveDuration = resolveDuration;
 exports.validateDiscountPolicy = validateDiscountPolicy;

package/dist/index.d.cts

@@ -84,6 +84,8 @@ declare const LIMITS: {
     readonly ELIGIBILITY_ENTRY_MAX_LENGTH: 128;
     /** [L] Length cap for `context.plan / productId / categoryId`. */
     readonly CONTEXT_VALUE_MAX_LENGTH: 128;
+    /** Upper bound for `duration.months` on a REPEATING discount. */
+    readonly DURATION_MAX_MONTHS: 36;
 };
 /**
  * Audit log action strings (stable identifiers).
@@ -107,17 +109,32 @@ type AuditAction = (typeof AUDIT_ACTION)[keyof typeof AUDIT_ACTION];
  * No Prisma generated types imported here (see contract §10 PrismaLike rule).
  */
 
+/**
+ * How many billing cycles a discount applies to. Absent = ONCE.
+ * The package records it; applying it to recurring charges is the consumer's job
+ * (re-run `calculateDiscount` per cycle with the stored policy).
+ */
+type DiscountDuration = {
+    kind: "ONCE";
+} | {
+    kind: "REPEATING";
+    months: number;
+} | {
+    kind: "FOREVER";
+};
 type DiscountPolicy = {
     kind: "PERCENT";
     percent: number;
     maxDiscount?: number;
     minOrder?: number;
     currency?: string;
+    duration?: DiscountDuration;
 } | {
     kind: "FIXED";
     amount: number;
     currency: string;
     minOrder?: number;
+    duration?: DiscountDuration;
 };
 type EligibilityRules = {
     allowedUserIds?: string[];
@@ -341,6 +358,13 @@ type CampaignIssueArgs = {
     codeLength?: number;
     maxAttempts?: number;
     actorId?: string;
+    /**
+     * Redemption limits stamped on each issued code. Unset = unlimited, which
+     * is rarely what a batch of unique codes wants: pass `maxRedemptions: 1`
+     * for single-use codes.
+     */
+    maxRedemptions?: number | null;
+    maxRedemptionsPerUser?: number | null;
 };
 type CampaignSummary = {
     id: string;
@@ -573,6 +597,15 @@ type CouponClientConfig = {
      * @example { coupon: "coupons" }
      */
     tables?: Partial<TableNameMap>;
+    /**
+     * Postgres schema that holds the coupon tables, used to qualify the
+     * `SELECT ... FOR UPDATE` row lock. Needed when the tables live outside
+     * `public` and the client uses a driver adapter (Prisma 7), whose raw
+     * queries resolve unqualified names through the connection's `search_path`.
+     *
+     * @example "billing"
+     */
+    schema?: string;
 };
 interface CouponClient {
     coupons: {
@@ -654,6 +687,8 @@ declare function validateDiscountPolicy(policy: DiscountPolicy): void;
  * Throws MinimumOrderNotMetError if subtotal < policy.minOrder.
  */
 declare function calculate(input: DiscountInput): DiscountBreakdown;
+/** The effective duration of a policy. Policies without one apply ONCE. */
+declare function resolveDuration(policy: DiscountPolicy): DiscountDuration;
 
 /**
  * Error taxonomy for @withwiz/coupon.
@@ -768,4 +803,4 @@ declare class TenantMismatchError extends CouponError {
     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 };
+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 DiscountDuration, 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, resolveDuration, validateDiscountPolicy };

package/dist/index.d.ts

@@ -84,6 +84,8 @@ declare const LIMITS: {
     readonly ELIGIBILITY_ENTRY_MAX_LENGTH: 128;
     /** [L] Length cap for `context.plan / productId / categoryId`. */
     readonly CONTEXT_VALUE_MAX_LENGTH: 128;
+    /** Upper bound for `duration.months` on a REPEATING discount. */
+    readonly DURATION_MAX_MONTHS: 36;
 };
 /**
  * Audit log action strings (stable identifiers).
@@ -107,17 +109,32 @@ type AuditAction = (typeof AUDIT_ACTION)[keyof typeof AUDIT_ACTION];
  * No Prisma generated types imported here (see contract §10 PrismaLike rule).
  */
 
+/**
+ * How many billing cycles a discount applies to. Absent = ONCE.
+ * The package records it; applying it to recurring charges is the consumer's job
+ * (re-run `calculateDiscount` per cycle with the stored policy).
+ */
+type DiscountDuration = {
+    kind: "ONCE";
+} | {
+    kind: "REPEATING";
+    months: number;
+} | {
+    kind: "FOREVER";
+};
 type DiscountPolicy = {
     kind: "PERCENT";
     percent: number;
     maxDiscount?: number;
     minOrder?: number;
     currency?: string;
+    duration?: DiscountDuration;
 } | {
     kind: "FIXED";
     amount: number;
     currency: string;
     minOrder?: number;
+    duration?: DiscountDuration;
 };
 type EligibilityRules = {
     allowedUserIds?: string[];
@@ -341,6 +358,13 @@ type CampaignIssueArgs = {
     codeLength?: number;
     maxAttempts?: number;
     actorId?: string;
+    /**
+     * Redemption limits stamped on each issued code. Unset = unlimited, which
+     * is rarely what a batch of unique codes wants: pass `maxRedemptions: 1`
+     * for single-use codes.
+     */
+    maxRedemptions?: number | null;
+    maxRedemptionsPerUser?: number | null;
 };
 type CampaignSummary = {
     id: string;
@@ -573,6 +597,15 @@ type CouponClientConfig = {
      * @example { coupon: "coupons" }
      */
     tables?: Partial<TableNameMap>;
+    /**
+     * Postgres schema that holds the coupon tables, used to qualify the
+     * `SELECT ... FOR UPDATE` row lock. Needed when the tables live outside
+     * `public` and the client uses a driver adapter (Prisma 7), whose raw
+     * queries resolve unqualified names through the connection's `search_path`.
+     *
+     * @example "billing"
+     */
+    schema?: string;
 };
 interface CouponClient {
     coupons: {
@@ -654,6 +687,8 @@ declare function validateDiscountPolicy(policy: DiscountPolicy): void;
  * Throws MinimumOrderNotMetError if subtotal < policy.minOrder.
  */
 declare function calculate(input: DiscountInput): DiscountBreakdown;
+/** The effective duration of a policy. Policies without one apply ONCE. */
+declare function resolveDuration(policy: DiscountPolicy): DiscountDuration;
 
 /**
  * Error taxonomy for @withwiz/coupon.
@@ -768,4 +803,4 @@ declare class TenantMismatchError extends CouponError {
     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 };
+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 DiscountDuration, 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, resolveDuration, validateDiscountPolicy };

package/dist/index.mjs

@@ -69,7 +69,9 @@ var LIMITS = {
   ELIGIBILITY_MAX_ENTRIES: 1e3,
   ELIGIBILITY_ENTRY_MAX_LENGTH: 128,
   /** [L] Length cap for `context.plan / productId / categoryId`. */
-  CONTEXT_VALUE_MAX_LENGTH: 128
+  CONTEXT_VALUE_MAX_LENGTH: 128,
+  /** Upper bound for `duration.months` on a REPEATING discount. */
+  DURATION_MAX_MONTHS: 36
 };
 var AUDIT_ACTION = {
   COUPON_CREATED: "coupon.created",
@@ -278,6 +280,7 @@ function validateDiscountPolicy(policy) {
     if (policy.currency !== void 0) {
       ensureCurrency(policy.currency);
     }
+    validateDuration(policy.duration);
     return;
   }
   if (policy.kind === "FIXED") {
@@ -295,6 +298,7 @@ function validateDiscountPolicy(policy) {
         );
       }
     }
+    validateDuration(policy.duration);
     return;
   }
   throw new InvalidDiscountPolicyError(
@@ -367,6 +371,27 @@ function extractPolicyCurrency(policy) {
   if (policy.kind === "PERCENT") return policy.currency;
   return void 0;
 }
+function validateDuration(duration) {
+  if (duration === void 0) return;
+  if (!duration || typeof duration !== "object") {
+    throw new InvalidDiscountPolicyError("duration must be an object");
+  }
+  const kind = duration.kind;
+  if (kind === "ONCE" || kind === "FOREVER") return;
+  if (kind === "REPEATING") {
+    const months = duration.months;
+    if (typeof months !== "number" || !Number.isInteger(months) || months < 1 || months > LIMITS.DURATION_MAX_MONTHS) {
+      throw new InvalidDiscountPolicyError(
+        `duration.months must be an integer in [1, ${LIMITS.DURATION_MAX_MONTHS}] (got ${String(months)})`
+      );
+    }
+    return;
+  }
+  throw new InvalidDiscountPolicyError(`unknown duration kind: ${String(kind)}`);
+}
+function resolveDuration(policy) {
+  return policy.duration ?? { kind: "ONCE" };
+}
 
 // src/eligibility.ts
 function checkEligibility(input) {
@@ -584,6 +609,15 @@ function assertIdentifier(kind, key, value) {
   }
   return value;
 }
+function resolveSchemaName(schema) {
+  if (schema === void 0) return void 0;
+  if (typeof schema !== "string" || !IDENTIFIER_RE.test(schema)) {
+    throw new InvalidModelNameError(
+      `Invalid schema name: ${JSON.stringify(schema)}. Expected a plain identifier matching ${IDENTIFIER_RE.source}.`
+    );
+  }
+  return schema;
+}
 function resolveModelNames(overrides) {
   const out = { ...DEFAULT_MODEL_NAMES };
   for (const key of MODEL_KEYS) {
@@ -610,19 +644,21 @@ function pick(db, key, name) {
   }
   return delegate;
 }
-function createDelegateResolver(models, tables) {
+function createDelegateResolver(models, tables, schema) {
   const resolver = {
     models,
-    tables
+    tables,
+    schema
   };
   for (const key of MODEL_KEYS) {
     resolver[key] = (db) => pick(db, key, models[key]);
   }
   return resolver;
 }
-function lockCouponRow(tx, table, couponId, tenantId) {
+function lockCouponRow(tx, table, couponId, tenantId, schema) {
+  const target = schema ? `"${schema}"."${table}"` : `"${table}"`;
   const parts = [
-    `SELECT * FROM "${table}" WHERE "id" = `,
+    `SELECT * FROM ${target} WHERE "id" = `,
     ` AND "tenantId" = `,
     ` FOR UPDATE`
   ];
@@ -927,19 +963,29 @@ function validateCreateCampaignInput(input) {
     }
   }
 }
+var discountDurationSchema = z.discriminatedUnion("kind", [
+  z.object({ kind: z.literal("ONCE") }),
+  z.object({
+    kind: z.literal("REPEATING"),
+    months: z.number().int().min(1).max(LIMITS.DURATION_MAX_MONTHS)
+  }),
+  z.object({ kind: z.literal("FOREVER") })
+]);
 z.discriminatedUnion("kind", [
   z.object({
     kind: z.literal("PERCENT"),
     percent: z.number().gt(0).lte(100),
     maxDiscount: z.number().int().nonnegative().optional(),
     minOrder: z.number().int().nonnegative().optional(),
-    currency: z.string().length(3).optional()
+    currency: z.string().length(3).optional(),
+    duration: discountDurationSchema.optional()
   }),
   z.object({
     kind: z.literal("FIXED"),
     amount: z.number().int().positive(),
     currency: z.string().length(3),
-    minOrder: z.number().int().nonnegative().optional()
+    minOrder: z.number().int().nonnegative().optional(),
+    duration: discountDurationSchema.optional()
   })
 ]);
 
@@ -982,7 +1028,8 @@ function resolveConfig(config) {
     // allow-now: default fallback when config.now is omitted
     logger: config.logger ?? NOOP_LOGGER,
     models,
-    tables: resolveTableNames(models, config.tables)
+    tables: resolveTableNames(models, config.tables),
+    schema: resolveSchemaName(config.schema)
   };
 }
 async function safeEmit(handler, logger, event) {
@@ -1060,7 +1107,7 @@ function withIdTieBreak(orderBy) {
 function createCouponClient(config) {
   const cfg = resolveConfig(config);
   const prisma = cfg.prisma;
-  const delegates = createDelegateResolver(cfg.models, cfg.tables);
+  const delegates = createDelegateResolver(cfg.models, cfg.tables, cfg.schema);
   const tid = (v) => resolveTenantId(v, cfg.defaultTenantId);
   async function paginate(delegate, where, limit, cursor, mapFn, orderBy = { createdAt: "desc" }) {
     const take = limit + 1;
@@ -1546,7 +1593,8 @@ function createCouponClient(config) {
       tx,
       delegates.tables.coupon,
       couponId,
-      tenantId
+      tenantId,
+      delegates.schema
     );
     if (!Array.isArray(locked) || locked.length === 0) {
       throw new CouponNotFoundError("Coupon not found", { tenantId, couponId });
@@ -1870,6 +1918,8 @@ function createCouponClient(config) {
         endsAt: campaign.endsAt,
         maxAttempts: args.maxAttempts,
         eligibility: campaign.eligibility,
+        maxRedemptions: args.maxRedemptions,
+        maxRedemptionsPerUser: args.maxRedemptionsPerUser,
         actorId: args.actorId
       });
     },
@@ -2029,4 +2079,4 @@ function createCouponClient(config) {
   };
 }
 
-export { AUDIT_ACTION, CAMPAIGN_STATUS, COUPON_REJECT_REASON, COUPON_STATUS, CampaignCapacityExceededError, CampaignClosedError, CouponAlreadyRedeemedError, CouponArchivedError, CouponError, CouponExhaustedError, CouponExpiredError, CouponInactiveError, CouponNotFoundError, CurrencyMismatchError, DEFAULT_MODEL_NAMES, IneligibleCategoryError, IneligiblePlanError, IneligibleProductError, IneligibleUserError, InvalidDateRangeError, InvalidDiscountPolicyError, InvalidModelNameError, LIMITS, MinimumOrderNotMetError, PerUserLimitExceededError, TenantMismatchError, ValidationError, calculate as calculateDiscount, createCouponClient, validateDiscountPolicy };
+export { AUDIT_ACTION, CAMPAIGN_STATUS, COUPON_REJECT_REASON, COUPON_STATUS, CampaignCapacityExceededError, CampaignClosedError, CouponAlreadyRedeemedError, CouponArchivedError, CouponError, CouponExhaustedError, CouponExpiredError, CouponInactiveError, CouponNotFoundError, CurrencyMismatchError, DEFAULT_MODEL_NAMES, IneligibleCategoryError, IneligiblePlanError, IneligibleProductError, IneligibleUserError, InvalidDateRangeError, InvalidDiscountPolicyError, InvalidModelNameError, LIMITS, MinimumOrderNotMetError, PerUserLimitExceededError, TenantMismatchError, ValidationError, calculate as calculateDiscount, createCouponClient, resolveDuration, validateDiscountPolicy };

package/package.json

@@ -1,7 +1,7 @@
 {
   "packageManager": "pnpm@11.10.0",
   "name": "@withwiz/coupon",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Multi-tenant, concurrency-safe coupon domain core for Prisma + Node.js applications",
   "license": "MIT",
   "author": "withwiz",
@@ -61,9 +61,9 @@
     "prepublishOnly": "pnpm run build"
   },
   "dependencies": {
-    "zod": "^3.23.0",
+    "@paralleldrive/cuid2": "^2.2.2",
     "nanoid": "^5.0.0",
-    "@paralleldrive/cuid2": "^2.2.2"
+    "zod": "^3.23.0"
   },
   "peerDependencies": {
     "@prisma/client": ">=5.0.0 <8.0.0",