@classytic/loyalty 0.6.0 → 0.10.0

package/dist/{index-YUFamhDk.d.mts → index-Db5Gb7x_.d.mts}

@@ -1,4 +1,5 @@
-import { o as LoyaltyContext } from "./index-Cp_sXNpG.mjs";
+import { t as EarnSource } from "./index-tjMMmPzU.mjs";
+import { o as LoyaltyContext } from "./index-DRrEhE0r.mjs";
 import { InProcessEventBus, InProcessEventBusOptions } from "@classytic/primitives/event-infra";
 import { DomainEvent, DomainEvent as DomainEvent$1, EventHandler, EventTransport as EventTransport$1 } from "@classytic/primitives/events";
 import { z } from "zod";
@@ -61,6 +62,13 @@ declare const PointsEarned: LoyaltyEventDefinition<z.ZodObject<{
   externalId: z.ZodString;
   externalType: z.ZodString;
   points: z.ZodNumber;
+  source: z.ZodEnum<{
+    action: "action";
+    campaign: "campaign";
+    order: "order";
+    referral: "referral";
+  }>;
+  pointValueMinor: z.ZodNumber;
   balanceAfter: z.ZodNumber;
   transactionId: z.ZodString;
   earningRuleName: z.ZodOptional<z.ZodString>;
@@ -71,6 +79,7 @@ declare const PointsRedeemed: LoyaltyEventDefinition<z.ZodObject<{
   memberId: z.ZodString;
   externalId: z.ZodString;
   points: z.ZodNumber;
+  pointValueMinor: z.ZodNumber;
   balanceAfter: z.ZodNumber;
   transactionId: z.ZodString;
   description: z.ZodString;
@@ -79,15 +88,38 @@ declare const PointsAdjusted: LoyaltyEventDefinition<z.ZodObject<{
   memberId: z.ZodString;
   externalId: z.ZodString;
   points: z.ZodNumber;
+  pointValueMinor: z.ZodNumber;
   balanceAfter: z.ZodNumber;
   transactionId: z.ZodString;
   description: z.ZodString;
 }, z.core.$strip>>;
+declare const PointsReversed: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  referenceType: z.ZodString;
+  referenceId: z.ZodString;
+  claimed: z.ZodNumber;
+  collected: z.ZodNumber;
+  shortfall: z.ZodNumber;
+  pointValueMinor: z.ZodNumber;
+  balanceAfter: z.ZodNumber;
+  transactionId: z.ZodString;
+  reason: z.ZodString;
+}, z.core.$strip>>;
 declare const PointsExpired: LoyaltyEventDefinition<z.ZodObject<{
   membersAffected: z.ZodNumber;
   pointsExpired: z.ZodNumber;
   transactionCount: z.ZodNumber;
 }, z.core.$strip>>;
+declare const PointsLotExpired: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  transactionId: z.ZodString;
+  lotTransactionId: z.ZodString;
+  points: z.ZodNumber;
+  pointValueMinor: z.ZodNumber;
+  balanceAfter: z.ZodNumber;
+}, z.core.$strip>>;
 declare const PointsExpiringSoon: LoyaltyEventDefinition<z.ZodObject<{
   membersAffected: z.ZodNumber;
   pointsExpired: z.ZodNumber;
@@ -163,7 +195,8 @@ declare const RedemptionReversed: LoyaltyEventDefinition<z.ZodObject<{
   originalPoints: z.ZodNumber;
   proportional: z.ZodBoolean;
   reason: z.ZodOptional<z.ZodString>;
-  transactionId: z.ZodString;
+  pointValueMinor: z.ZodNumber;
+  transactionId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>>;
 declare const CampaignAwarded: LoyaltyEventDefinition<z.ZodObject<{
   campaignId: z.ZodString;
@@ -218,6 +251,42 @@ declare const MultiTierReferralAwarded: LoyaltyEventDefinition<z.ZodObject<{
     transactionId: z.ZodString;
   }, z.core.$strip>>;
 }, z.core.$strip>>;
+declare const StampEarned: LoyaltyEventDefinition<z.ZodObject<{
+  stampProgramId: z.ZodString;
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  entryId: z.ZodString;
+  orderRef: z.ZodString;
+  stamps: z.ZodNumber;
+  businessDay: z.ZodString;
+  expiresAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const StampReversed: LoyaltyEventDefinition<z.ZodObject<{
+  stampProgramId: z.ZodString;
+  memberId: z.ZodString;
+  entryId: z.ZodString;
+  orderRef: z.ZodString;
+  reversed: z.ZodNumber;
+  retainedInAwards: z.ZodNumber;
+}, z.core.$strip>>;
+declare const StampAwardIssued: LoyaltyEventDefinition<z.ZodObject<{
+  stampProgramId: z.ZodString;
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  awardId: z.ZodString;
+  sequence: z.ZodNumber;
+  stampsConsumed: z.ZodNumber;
+  reward: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"points">;
+    points: z.ZodNumber;
+    pointTransactionId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"voucher">;
+    voucherProgramId: z.ZodString;
+    voucherId: z.ZodString;
+    code: z.ZodString;
+  }, z.core.$strip>], "kind">;
+}, z.core.$strip>>;
 /**
  * Every loyalty event defined in the package — pass to Arc's
  * `EventRegistry`. Hosts wire ONE array; the whole `loyalty.*` namespace
@@ -227,42 +296,37 @@ declare const MultiTierReferralAwarded: LoyaltyEventDefinition<z.ZodObject<{
 declare const loyaltyEventDefinitions: ReadonlyArray<LoyaltyEventDefinition>;
 //#endregion
 //#region src/events/loyalty-events.d.ts
-/**
- * Loyalty event name + payload map.
- *
- * Minimal surface. Loyalty emits events for its own lifecycle transitions
- * only — member, points ledger, tier, redemption, and referral.
- *
- * For registration with an arc-compatible event registry, see
- * `loyalty-event-catalog.ts` in this directory — it exposes each event as
- * a `LoyaltyEventDefinition` with a Zod payload schema + JSON Schema
- * derived via `z.toJSONSchema()` (PACKAGE_RULES §18.5).
- */
 declare const LoyaltyEvents: {
-  readonly MEMBER_ENROLLED: "loyalty.member.enrolled";
-  readonly MEMBER_DEACTIVATED: "loyalty.member.deactivated";
-  readonly MEMBER_REACTIVATED: "loyalty.member.reactivated";
-  readonly MEMBER_SUSPENDED: "loyalty.member.suspended";
-  readonly POINTS_EARNED: "loyalty.points.earned";
-  readonly POINTS_REDEEMED: "loyalty.points.redeemed";
-  readonly POINTS_ADJUSTED: "loyalty.points.adjusted";
-  readonly POINTS_EXPIRED: "loyalty.points.expired";
-  readonly POINTS_EXPIRING_SOON: "loyalty.points.expiring_soon";
-  readonly TIER_UPGRADED: "loyalty.tier.upgraded";
-  readonly TIER_DOWNGRADED: "loyalty.tier.downgraded";
-  readonly TIER_GRACE_STARTED: "loyalty.tier.grace_started";
-  readonly TIER_OVERRIDE_CLEARED: "loyalty.tier.override_cleared";
-  readonly TIER_OVERRIDE_EXPIRED: "loyalty.tier.override_expired";
-  readonly REDEMPTION_RESERVED: "loyalty.redemption.reserved";
-  readonly REDEMPTION_CONFIRMED: "loyalty.redemption.confirmed";
-  readonly REDEMPTION_RELEASED: "loyalty.redemption.released";
-  readonly REDEMPTION_REVERSED: "loyalty.redemption.reversed";
-  readonly CAMPAIGN_AWARDED: "loyalty.campaign.awarded";
-  readonly REFERRAL_RECORDED: "loyalty.referral.recorded";
-  readonly REFERRAL_APPROVED: "loyalty.referral.approved";
-  readonly REFERRAL_REJECTED: "loyalty.referral.rejected";
-  readonly REFERRAL_REWARDED: "loyalty.referral.rewarded";
-  readonly MULTI_TIER_REFERRAL_AWARDED: "loyalty.referral.multi_tier_awarded";
+  readonly MEMBER_ENROLLED: 'loyalty.member.enrolled';
+  readonly MEMBER_DEACTIVATED: 'loyalty.member.deactivated';
+  readonly MEMBER_REACTIVATED: 'loyalty.member.reactivated';
+  readonly MEMBER_SUSPENDED: 'loyalty.member.suspended';
+  readonly POINTS_EARNED: 'loyalty.points.earned';
+  readonly POINTS_REDEEMED: 'loyalty.points.redeemed';
+  readonly POINTS_ADJUSTED: 'loyalty.points.adjusted';
+  readonly POINTS_REVERSED: 'loyalty.points.reversed';
+  readonly POINTS_EXPIRED: 'loyalty.points.expired';
+  /** One expired lot, dispatched atomically with its expiry — the per-fact companion of POINTS_EXPIRED. */
+  readonly POINTS_LOT_EXPIRED: 'loyalty.points.lot_expired';
+  readonly POINTS_EXPIRING_SOON: 'loyalty.points.expiring_soon';
+  readonly TIER_UPGRADED: 'loyalty.tier.upgraded';
+  readonly TIER_DOWNGRADED: 'loyalty.tier.downgraded';
+  readonly TIER_GRACE_STARTED: 'loyalty.tier.grace_started';
+  readonly TIER_OVERRIDE_CLEARED: 'loyalty.tier.override_cleared';
+  readonly TIER_OVERRIDE_EXPIRED: 'loyalty.tier.override_expired';
+  readonly REDEMPTION_RESERVED: 'loyalty.redemption.reserved';
+  readonly REDEMPTION_CONFIRMED: 'loyalty.redemption.confirmed';
+  readonly REDEMPTION_RELEASED: 'loyalty.redemption.released';
+  readonly REDEMPTION_REVERSED: 'loyalty.redemption.reversed';
+  readonly CAMPAIGN_AWARDED: 'loyalty.campaign.awarded';
+  readonly REFERRAL_RECORDED: 'loyalty.referral.recorded';
+  readonly REFERRAL_APPROVED: 'loyalty.referral.approved';
+  readonly REFERRAL_REJECTED: 'loyalty.referral.rejected';
+  readonly REFERRAL_REWARDED: 'loyalty.referral.rewarded';
+  readonly MULTI_TIER_REFERRAL_AWARDED: 'loyalty.referral.multi_tier_awarded';
+  readonly STAMP_EARNED: 'loyalty.stamp.earned';
+  readonly STAMP_REVERSED: 'loyalty.stamp.reversed';
+  readonly STAMP_AWARD_ISSUED: 'loyalty.stamp.award_issued';
 };
 type LoyaltyEventName = (typeof LoyaltyEvents)[keyof typeof LoyaltyEvents];
 interface MemberLifecyclePayload {
@@ -276,6 +340,10 @@ interface PointsEarnedPayload {
   externalId: string;
   externalType: string;
   points: number;
+  /** Why the points were granted — `order` is the only source with a sale behind it. */
+  source: EarnSource;
+  /** Minor units one point was worth at this earn. */
+  pointValueMinor: number;
   balanceAfter: number;
   transactionId: string;
   earningRuleName?: string;
@@ -286,15 +354,47 @@ interface PointsAdjustedPayload {
   memberId: string;
   externalId: string;
   points: number;
+  /** Minor units one point was worth at this adjustment. */
+  pointValueMinor: number;
   balanceAfter: number;
   transactionId: string;
   description: string;
 }
+interface PointsReversedPayload {
+  memberId: string;
+  externalId: string;
+  referenceType: string;
+  referenceId: string;
+  /** Points this reversal claimed back (the earned share now owed). */
+  claimed: number;
+  /** Points actually debited — `claimed` capped at the balance the member still held. */
+  collected: number;
+  /** `claimed - collected`: points already spent that could not be taken back. */
+  shortfall: number;
+  /** Minor units one point was worth at this reversal. */
+  pointValueMinor: number;
+  balanceAfter: number;
+  transactionId: string;
+  reason: string;
+}
 interface PointsExpiredPayload {
   membersAffected: number;
   pointsExpired: number;
   transactionCount: number;
 }
+interface PointsLotExpiredPayload {
+  memberId: string;
+  externalId: string;
+  /** The `expire` row this lot produced. */
+  transactionId: string;
+  /** The earn row whose lot expired. */
+  lotTransactionId: string;
+  /** Points removed from the balance (the lot, clamped to what the member still held). */
+  points: number;
+  /** Minor units one point was worth at expiry. */
+  pointValueMinor: number;
+  balanceAfter: number;
+}
 interface TierChangedPayload {
   memberId: string;
   externalId: string;
@@ -339,7 +439,10 @@ interface RedemptionReversedPayload {
   originalPoints: number;
   proportional: boolean;
   reason?: string;
-  transactionId: string;
+  /** Minor units per point the redemption was priced at — the rate the credited points carry back. */
+  pointValueMinor: number;
+  /** The credit row; absent when nothing was credited. */
+  transactionId?: string;
 }
 interface CampaignAwardedPayload {
   campaignId: string;
@@ -359,6 +462,46 @@ interface MultiTierReferralAwardedPayload {
     transactionId: string;
   }>;
 }
+interface StampEarnedPayload {
+  stampProgramId: string;
+  memberId: string;
+  externalId: string;
+  entryId: string;
+  orderRef: string;
+  stamps: number;
+  /** `YYYY-MM-DD` in the engine's timezone. */
+  businessDay: string;
+  /** ISO string; absent when the program's stamps never expire. */
+  expiresAt?: string;
+}
+interface StampReversedPayload {
+  stampProgramId: string;
+  memberId: string;
+  entryId: string;
+  orderRef: string;
+  /** Unconsumed stamps removed. */
+  reversed: number;
+  /** Stamps already spent on an award — kept, not clawed back. */
+  retainedInAwards: number;
+}
+interface StampAwardIssuedPayload {
+  stampProgramId: string;
+  memberId: string;
+  externalId: string;
+  awardId: string;
+  sequence: number;
+  stampsConsumed: number;
+  reward: {
+    kind: 'points';
+    points: number;
+    pointTransactionId: string;
+  } | {
+    kind: 'voucher';
+    voucherProgramId: string;
+    voucherId: string;
+    code: string;
+  };
+}
 interface LoyaltyEventMap {
   [LoyaltyEvents.MEMBER_ENROLLED]: MemberLifecyclePayload;
   [LoyaltyEvents.MEMBER_DEACTIVATED]: MemberLifecyclePayload;
@@ -367,7 +510,9 @@ interface LoyaltyEventMap {
   [LoyaltyEvents.POINTS_EARNED]: PointsEarnedPayload;
   [LoyaltyEvents.POINTS_REDEEMED]: PointsAdjustedPayload;
   [LoyaltyEvents.POINTS_ADJUSTED]: PointsAdjustedPayload;
+  [LoyaltyEvents.POINTS_REVERSED]: PointsReversedPayload;
   [LoyaltyEvents.POINTS_EXPIRED]: PointsExpiredPayload;
+  [LoyaltyEvents.POINTS_LOT_EXPIRED]: PointsLotExpiredPayload;
   [LoyaltyEvents.POINTS_EXPIRING_SOON]: PointsExpiredPayload;
   [LoyaltyEvents.TIER_UPGRADED]: TierChangedPayload;
   [LoyaltyEvents.TIER_DOWNGRADED]: TierChangedPayload;
@@ -384,7 +529,10 @@ interface LoyaltyEventMap {
   [LoyaltyEvents.REFERRAL_REJECTED]: ReferralPayload;
   [LoyaltyEvents.REFERRAL_REWARDED]: ReferralPayload;
   [LoyaltyEvents.MULTI_TIER_REFERRAL_AWARDED]: MultiTierReferralAwardedPayload;
+  [LoyaltyEvents.STAMP_EARNED]: StampEarnedPayload;
+  [LoyaltyEvents.STAMP_REVERSED]: StampReversedPayload;
+  [LoyaltyEvents.STAMP_AWARD_ISSUED]: StampAwardIssuedPayload;
 }
 type LoyaltyEventPayload<E extends LoyaltyEventName> = LoyaltyEventMap[E];
 //#endregion
-export { PointsExpired as A, ReferralRewarded as B, MemberDeactivated as C, MultiTierReferralAwarded as D, MemberSuspended as E, RedemptionReserved as F, TierUpgraded as G, TierGraceStarted as H, RedemptionReversed as I, InProcessLoyaltyBusOptions as J, loyaltyEventDefinitions as K, ReferralApproved as L, PointsRedeemed as M, RedemptionConfirmed as N, PointsAdjusted as O, RedemptionReleased as P, ReferralRecorded as R, LoyaltyEventSchema as S, MemberReactivated as T, TierOverrideCleared as U, TierDowngraded as V, TierOverrideExpired as W, createEvent$1 as Y, TierChangedPayload as _, LoyaltyEventMap as a, LoyaltyEventDefinition as b, LoyaltyEvents as c, PointsAdjustedPayload as d, PointsEarnedPayload as f, ReferralPayload as g, RedemptionReversedPayload as h, CampaignAwardedPayload as i, PointsExpiringSoon as j, PointsEarned as k, MemberLifecyclePayload as l, RedemptionPayload as m, EventHandler as n, LoyaltyEventName as o, PointsExpiredPayload as p, InProcessLoyaltyBus as q, EventTransport$1 as r, LoyaltyEventPayload as s, DomainEvent$1 as t, MultiTierReferralAwardedPayload as u, TierOverrideLifecyclePayload as v, MemberEnrolled as w, LoyaltyEventPayloadOf as x, CampaignAwarded as y, ReferralRejected as z };
+export { TierOverrideCleared as $, MemberReactivated as A, RedemptionConfirmed as B, TierOverrideLifecyclePayload as C, LoyaltyEventSchema as D, LoyaltyEventPayloadOf as E, PointsExpired as F, ReferralRecorded as G, RedemptionReserved as H, PointsExpiringSoon as I, StampAwardIssued as J, ReferralRejected as K, PointsLotExpired as L, MultiTierReferralAwarded as M, PointsAdjusted as N, MemberDeactivated as O, PointsEarned as P, TierGraceStarted as Q, PointsRedeemed as R, TierChangedPayload as S, LoyaltyEventDefinition as T, RedemptionReversed as U, RedemptionReleased as V, ReferralApproved as W, StampReversed as X, StampEarned as Y, TierDowngraded as Z, RedemptionReversedPayload as _, LoyaltyEventMap as a, createEvent$1 as at, StampEarnedPayload as b, LoyaltyEvents as c, PointsAdjustedPayload as d, TierOverrideExpired as et, PointsEarnedPayload as f, RedemptionPayload as g, PointsReversedPayload as h, CampaignAwardedPayload as i, InProcessLoyaltyBusOptions as it, MemberSuspended as j, MemberEnrolled as k, MemberLifecyclePayload as l, PointsLotExpiredPayload as m, EventHandler as n, loyaltyEventDefinitions as nt, LoyaltyEventName as o, PointsExpiredPayload as p, ReferralRewarded as q, EventTransport$1 as r, InProcessLoyaltyBus as rt, LoyaltyEventPayload as s, DomainEvent$1 as t, TierUpgraded as tt, MultiTierReferralAwardedPayload as u, ReferralPayload as v, CampaignAwarded as w, StampReversedPayload as x, StampAwardIssuedPayload as y, PointsReversed as z };

package/dist/index-tjMMmPzU.d.mts

@@ -0,0 +1,36 @@
+//#region src/constants.d.ts
+declare const TRANSACTION_TYPES: readonly ["earn", "redeem", "adjust", "expire", "transfer", "referral_bonus", "reverse"];
+/**
+ * Why points were EARNED — a closed set, required on every earn. `order` is points
+ * granted with a sale (a consumer defers part of that sale's price); every other source
+ * is a grant with no sale behind it.
+ */
+declare const EARN_SOURCES: readonly ["order", "action", "referral", "campaign"];
+declare const MEMBER_STATUSES: readonly ["active", "inactive", "suspended"];
+declare const RULE_TYPES: readonly ["order", "action", "category", "tier_bonus"];
+declare const RULE_STATUSES: readonly ["active", "paused", "expired"];
+declare const REFERRAL_STATUSES: readonly ["pending", "approved", "rejected", "expired"];
+declare const REDEMPTION_STATUSES: readonly ["reserved", "confirmed", "released", "expired", "reversed"];
+declare const EARNING_ACTIONS: readonly ["signup", "referral", "birthday", "review", "profile_complete"];
+declare const STAMP_PROGRAM_STATUSES: readonly ["active", "paused", "ended"];
+/** What one stamp counts: a qualifying order, a business day with one, an item, or `perMinor` of spend. */
+declare const STAMP_EARN_UNITS: readonly ["order", "visit", "item", "spend"];
+declare const STAMP_REWARD_KINDS: readonly ["points", "voucher"];
+/** `pending` = claimed (stamps consumed) but the external reward not yet issued; settle resumes it. */
+declare const STAMP_AWARD_STATUSES: readonly ["pending", "issued"];
+//#endregion
+//#region src/domain/enums/index.d.ts
+type StampProgramStatus = (typeof STAMP_PROGRAM_STATUSES)[number];
+type StampEarnUnit = (typeof STAMP_EARN_UNITS)[number];
+type StampRewardKind = (typeof STAMP_REWARD_KINDS)[number];
+type StampAwardStatus = (typeof STAMP_AWARD_STATUSES)[number];
+type TransactionType = (typeof TRANSACTION_TYPES)[number];
+type EarnSource = (typeof EARN_SOURCES)[number];
+type MemberStatus = (typeof MEMBER_STATUSES)[number];
+type RuleType = (typeof RULE_TYPES)[number];
+type RuleStatus = (typeof RULE_STATUSES)[number];
+type ReferralStatus = (typeof REFERRAL_STATUSES)[number];
+type RedemptionStatus = (typeof REDEMPTION_STATUSES)[number];
+type EarningAction = (typeof EARNING_ACTIONS)[number];
+//#endregion
+export { STAMP_REWARD_KINDS as C, STAMP_PROGRAM_STATUSES as S, REFERRAL_STATUSES as _, ReferralStatus as a, STAMP_AWARD_STATUSES as b, StampAwardStatus as c, StampRewardKind as d, TransactionType as f, REDEMPTION_STATUSES as g, MEMBER_STATUSES as h, RedemptionStatus as i, StampEarnUnit as l, EARN_SOURCES as m, EarningAction as n, RuleStatus as o, EARNING_ACTIONS as p, MemberStatus as r, RuleType as s, EarnSource as t, StampProgramStatus as u, RULE_STATUSES as v, TRANSACTION_TYPES as w, STAMP_EARN_UNITS as x, RULE_TYPES as y };

package/dist/index.d.mts

@@ -1,11 +1,13 @@
-import { S as EarningRule, a as EnrollInput, b as MemberBalance, c as UpdateTierInput, d as EarningResult, g as TierEvaluation, h as RedemptionValidation, i as EarnPointsInput, l as BalanceSummary, n as CreateEarningRuleInput, o as LoyaltyContext, r as CreateTierInput, s as UpdateEarningRuleInput, t as AdjustPointsInput, v as PointTransaction, x as TierDefinition, y as Member } from "./index-Cp_sXNpG.mjs";
+import { EarnBase, EarnBaseInput, EarnBaseItem, EarnBaseLine, earnBase } from "./domain/earn-base.mjs";
+import { ScheduledRuleLike, isRuleInSchedule } from "./domain/rule-schedule.mjs";
+import { D as LoyaltyShape, E as LoyaltyRuntime, F as StampVoucherRequest, I as TierDefinition, L as EarningRule, M as ResolvedTenant, P as StampRewardIssuer, S as MemberBalance, T as LoyaltyModelName, _ as RedemptionValidation, a as EnrollInput, b as PointTransaction, c as UpdateTierInput, f as EarningResult, h as LoyaltyLiabilitySnapshot, i as EarnPointsInput, j as ResolvedConfig, l as BalanceSummary, n as CreateEarningRuleInput, o as LoyaltyContext, r as CreateTierInput, s as UpdateEarningRuleInput, t as AdjustPointsInput, u as EarnReversalResult, v as TierEvaluation, w as LiveProgramSettings, x as Member } from "./index-DRrEhE0r.mjs";
 import { t as NotificationAdapter } from "./notification.port-wY4IKimz.mjs";
-import { c as ResolvedConfig, i as LoyaltyShape, l as ResolvedTenant, n as LoyaltyModelName, r as LoyaltyRuntime } from "./config-CtkGj3xZ.mjs";
-import { A as PointsExpired, B as ReferralRewarded, C as MemberDeactivated, E as MemberSuspended, F as RedemptionReserved, G as TierUpgraded, H as TierGraceStarted, J as InProcessLoyaltyBusOptions, K as loyaltyEventDefinitions, L as ReferralApproved, M as PointsRedeemed, N as RedemptionConfirmed, O as PointsAdjusted, P as RedemptionReleased, R as ReferralRecorded, S as LoyaltyEventSchema, T as MemberReactivated, V as TierDowngraded, Y as createEvent, _ as TierChangedPayload, a as LoyaltyEventMap, b as LoyaltyEventDefinition, c as LoyaltyEvents, d as PointsAdjustedPayload, f as PointsEarnedPayload, g as ReferralPayload, j as PointsExpiringSoon, k as PointsEarned, l as MemberLifecyclePayload, m as RedemptionPayload, o as LoyaltyEventName, p as PointsExpiredPayload, q as InProcessLoyaltyBus, s as LoyaltyEventPayload, w as MemberEnrolled, x as LoyaltyEventPayloadOf, z as ReferralRejected } from "./index-YUFamhDk.mjs";
-import { n as LoyaltyModels, r as defineLoyaltyModels, t as DefineLoyaltyModelsConfig } from "./index-D6GvuvmF.mjs";
-import { a as ReferralRepository, c as Redemption, d as MemberRepository, f as UnitOfWork, i as TierDefinitionRepository, l as EarningRuleRepository, n as LoyaltyRepositories, o as Referral, s as RedemptionRepository, u as PointTransactionRepository } from "./index-CR2k7jQ8.mjs";
+import { A as MemberReactivated, B as RedemptionConfirmed, D as LoyaltyEventSchema, E as LoyaltyEventPayloadOf, F as PointsExpired, G as ReferralRecorded, H as RedemptionReserved, I as PointsExpiringSoon, J as StampAwardIssued, K as ReferralRejected, N as PointsAdjusted, O as MemberDeactivated, P as PointsEarned, Q as TierGraceStarted, R as PointsRedeemed, S as TierChangedPayload, T as LoyaltyEventDefinition, V as RedemptionReleased, W as ReferralApproved, X as StampReversed, Y as StampEarned, Z as TierDowngraded, a as LoyaltyEventMap, at as createEvent, b as StampEarnedPayload, c as LoyaltyEvents, d as PointsAdjustedPayload, f as PointsEarnedPayload, g as RedemptionPayload, h as PointsReversedPayload, it as InProcessLoyaltyBusOptions, j as MemberSuspended, k as MemberEnrolled, l as MemberLifecyclePayload, nt as loyaltyEventDefinitions, o as LoyaltyEventName, p as PointsExpiredPayload, q as ReferralRewarded, rt as InProcessLoyaltyBus, s as LoyaltyEventPayload, tt as TierUpgraded, v as ReferralPayload, x as StampReversedPayload, y as StampAwardIssuedPayload, z as PointsReversed } from "./index-Db5Gb7x_.mjs";
+import { a as StampAwardReward, c as StampOrderInput, d as StampProgress, f as StampRecordResult, i as StampAward, l as StampOrderLine, m as StampReward, n as LoyaltyModels, o as StampEarn, p as StampReversal, r as defineLoyaltyModels, s as StampEntry, t as DefineLoyaltyModelsConfig, u as StampProgram } from "./index-CorB0JL6.mjs";
+import { _ as PointTransactionRepository, a as StampProgramRepository, b as UnitOfWork, c as Referral, d as LoyaltyRedemptionPort, f as LoyaltyReserveInput, g as EarningRuleRepository, h as Redemption, i as StampRepository, l as RedemptionRepository, m as RedemptionOwnerRebind, n as LoyaltyRepositories, o as StampAwardRepository, p as RedemptionOwner, s as ReferralRepository, u as LoyaltyRedemption, v as MemberRepository, y as TierDefinitionRepository } from "./index-BvyzKU7R.mjs";
 import { Connection } from "mongoose";
 import { DomainEvent, DomainEvent as DomainEvent$1, EventHandler, EventTransport, EventTransport as EventTransport$1 } from "@classytic/primitives/events";
+import { z } from "zod";
 import { OutboxStore } from "@classytic/primitives/outbox";
 import { HttpError } from "@classytic/repo-core/errors";
 //#region src/domain/errors/base.d.ts
@@ -32,76 +34,76 @@ declare abstract class LoyaltyError extends Error implements HttpError {
 }
 //#endregion
 //#region src/domain/errors/domain-errors.d.ts
-declare class InsufficientPointsError extends LoyaltyError {
+export declare class InsufficientPointsError extends LoyaltyError {
   readonly code = "loyalty.points.insufficient";
   readonly status = 400;
   constructor(available: number, requested: number);
 }
-declare class MemberNotFoundError extends LoyaltyError {
+export declare class MemberNotFoundError extends LoyaltyError {
   readonly code = "loyalty.member.not_found";
   readonly status = 404;
   constructor(id: string);
 }
-declare class MemberAlreadyEnrolledError extends LoyaltyError {
+export declare class MemberAlreadyEnrolledError extends LoyaltyError {
   readonly code = "loyalty.member.already_enrolled";
   readonly status = 409;
   constructor(externalId: string);
 }
-declare class MemberInactiveError extends LoyaltyError {
+export declare class MemberInactiveError extends LoyaltyError {
   readonly code = "loyalty.member.inactive";
   readonly status = 422;
   constructor(id: string);
 }
-declare class RuleNotFoundError extends LoyaltyError {
+export declare class RuleNotFoundError extends LoyaltyError {
   readonly code = "loyalty.earning_rule.not_found";
   readonly status = 404;
   constructor(id: string);
 }
-declare class TierNotFoundError extends LoyaltyError {
+export declare class TierNotFoundError extends LoyaltyError {
   readonly code = "loyalty.tier.not_found";
   readonly status = 404;
   constructor(id: string);
 }
-declare class RedemptionNotFoundError extends LoyaltyError {
+export declare class RedemptionNotFoundError extends LoyaltyError {
   readonly code = "loyalty.redemption.not_found";
   readonly status = 404;
   constructor(id: string);
 }
-declare class RedemptionExpiredError extends LoyaltyError {
+export declare class RedemptionExpiredError extends LoyaltyError {
   readonly code = "loyalty.redemption.expired";
   readonly status = 410;
   constructor(id: string);
 }
-declare class ReferralNotFoundError extends LoyaltyError {
+export declare class ReferralNotFoundError extends LoyaltyError {
   readonly code = "loyalty.referral.not_found";
   readonly status = 404;
   constructor(id: string);
 }
-declare class DuplicateReferralError extends LoyaltyError {
+export declare class DuplicateReferralError extends LoyaltyError {
   readonly code = "loyalty.referral.duplicate";
   readonly status = 409;
   constructor(refereeId: string);
 }
-declare class ReferralLimitExceededError extends LoyaltyError {
+export declare class ReferralLimitExceededError extends LoyaltyError {
   readonly code = "loyalty.referral.limit_exceeded";
   readonly status = 429;
   constructor(limit: number, periodDays: number);
 }
-declare class SelfReferralError extends LoyaltyError {
+export declare class SelfReferralError extends LoyaltyError {
   readonly code = "loyalty.referral.self";
   readonly status = 422;
   constructor();
 }
-declare class CircularReferralError extends LoyaltyError {
+export declare class CircularReferralError extends LoyaltyError {
   readonly code = "loyalty.referral.circular";
   readonly status = 422;
   constructor();
 }
-declare class ValidationError extends LoyaltyError {
+export declare class ValidationError extends LoyaltyError {
   readonly code = "loyalty.validation.invalid";
   readonly status = 400;
 }
-declare class TenantIsolationError extends LoyaltyError {
+export declare class TenantIsolationError extends LoyaltyError {
   readonly code = "loyalty.tenant.isolation";
   readonly status = 403;
   constructor();
@@ -117,7 +119,7 @@ declare class TenantIsolationError extends LoyaltyError {
  * `{ ...ctx, [PENDING_EVENTS]: queue }` and call `flushPendingLoyaltyEvents`
  * after your transaction commits. Both are exported from the package root.
  */
-declare class UnmanagedSessionError extends LoyaltyError {
+export declare class UnmanagedSessionError extends LoyaltyError {
   readonly code = "loyalty.transaction.unmanaged_session";
   readonly status = 400;
   constructor();
@@ -136,7 +138,7 @@ declare class UnmanagedSessionError extends LoyaltyError {
  * drift from what MongoDB actually thinks. `@classytic/access` refuses
  * exactly this at `entitlement.repository.ts` — same rule, same reason.
  */
-declare class SessionNotInTransactionError extends LoyaltyError {
+export declare class SessionNotInTransactionError extends LoyaltyError {
   readonly code = "loyalty.transaction.session_not_in_transaction";
   readonly status = 409;
   constructor();
@@ -148,7 +150,7 @@ declare class SessionNotInTransactionError extends LoyaltyError {
  * or sharded cluster. Thrown at engine creation — fail loud at boot, not with
  * a cryptic driver error on the first transactional call.
  */
-declare class LoyaltyCapabilityError extends LoyaltyError {
+export declare class LoyaltyCapabilityError extends LoyaltyError {
   readonly code = "loyalty.engine.missing_capabilities";
   readonly status = 500;
   /**
@@ -163,6 +165,95 @@ declare class LoyaltyCapabilityError extends LoyaltyError {
   });
 }
 //#endregion
+//#region src/domain/stamp-program.d.ts
+/** The create body — strict: an unknown key is a 400, never silently dropped. Dates are ISO strings. */
+export declare const stampProgramInputSchema: z.ZodObject<{
+  name: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  status: z.ZodOptional<z.ZodEnum<{
+    active: "active";
+    ended: "ended";
+    paused: "paused";
+  }>>;
+  earn: z.ZodObject<{
+    unit: z.ZodEnum<{
+      item: "item";
+      order: "order";
+      spend: "spend";
+      visit: "visit";
+    }>;
+    categoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    productIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    perMinor: z.ZodOptional<z.ZodNumber>;
+    minOrderMinor: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>;
+  stampsRequired: z.ZodNumber;
+  stampValidityDays: z.ZodOptional<z.ZodNumber>;
+  startsAt: z.ZodOptional<z.ZodISODateTime>;
+  endsAt: z.ZodOptional<z.ZodISODateTime>;
+  reward: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"points">;
+    points: z.ZodNumber;
+  }, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"voucher">;
+    voucherProgramId: z.ZodString;
+  }, z.core.$strict>], "kind">;
+  maxRewardsPerMember: z.ZodOptional<z.ZodNumber>;
+  branchIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+/** The patch body — strict, every field optional; nested `earn` / `reward` are replaced whole. */
+export declare const stampProgramPatchSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  status: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+    active: "active";
+    ended: "ended";
+    paused: "paused";
+  }>>>;
+  earn: z.ZodOptional<z.ZodObject<{
+    unit: z.ZodEnum<{
+      item: "item";
+      order: "order";
+      spend: "spend";
+      visit: "visit";
+    }>;
+    categoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    productIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    perMinor: z.ZodOptional<z.ZodNumber>;
+    minOrderMinor: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>>;
+  stampsRequired: z.ZodOptional<z.ZodNumber>;
+  stampValidityDays: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+  startsAt: z.ZodOptional<z.ZodOptional<z.ZodISODateTime>>;
+  endsAt: z.ZodOptional<z.ZodOptional<z.ZodISODateTime>>;
+  reward: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"points">;
+    points: z.ZodNumber;
+  }, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"voucher">;
+    voucherProgramId: z.ZodString;
+  }, z.core.$strict>], "kind">>;
+  maxRewardsPerMember: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+  branchIds: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+  metadata: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strict>;
+type StampProgramInput = z.input<typeof stampProgramInputSchema>;
+/**
+ * Refuse a program that could never award correctly. Runs on the WHOLE document (a patch merged
+ * over what is stored), so a partial update cannot produce an invalid program.
+ */
+export declare function assertStampProgram(doc: Record<string, unknown>, opts: {
+  rewardIssuerBound: boolean;
+}): void;
+/**
+ * Stamps one order earns on a program: `order` / `visit` → 1 when a line qualifies, `item` → the
+ * qualifying units (a line sold by measure counts once, see {@link itemStampsOf}), `spend` →
+ * floor(qualifying spend / perMinor). With no product/category filter every line qualifies and
+ * `spend` counts the order total.
+ */
+export declare function stampsForOrder(program: StampProgram, order: StampOrderInput): number;
+//#endregion
 //#region src/events/dispatch.d.ts
 /**
  * Internal key under which the post-commit event-publish queue is threaded
@@ -171,20 +262,20 @@ declare class LoyaltyCapabilityError extends LoyaltyError {
  * flushes it after commit. A `Symbol.for` so it never collides with
  * host-supplied context fields and never appears in the public type.
  */
-declare const PENDING_EVENTS: unique symbol;
+export declare const PENDING_EVENTS: unique symbol;
 /**
  * Drains a queue of deferred events (the one attached under `[PENDING_EVENTS]`)
  * through the transport, swallowing per-event errors. Called by transactional
  * verbs AFTER `withTransaction` commits, and exported so hosts that own the
  * outer transaction can flush after their own commit.
  */
-declare function flushPendingLoyaltyEvents(events: EventTransport$1 | undefined, queue: DomainEvent$1[], logger?: {
+export declare function flushPendingLoyaltyEvents(events: EventTransport$1 | undefined, queue: DomainEvent$1[], logger?: {
   error(message: string, ...args: unknown[]): void;
 } | undefined): Promise<void>;
 //#endregion
 //#region src/index.d.ts
-declare function resolveConfig(config: LoyaltyShape): ResolvedConfig;
-interface LoyaltyEngine {
+export declare function resolveConfig(config: LoyaltyShape): ResolvedConfig;
+export interface LoyaltyEngine {
   models: LoyaltyModels;
   repositories: LoyaltyRepositories;
   events: EventTransport$1;
@@ -197,7 +288,7 @@ interface LoyaltyEngine {
    */
   close(): Promise<void>;
 }
-interface LoyaltyBlueprint {
+export interface LoyaltyBlueprint {
   readonly id: 'loyalty';
   /** The model names this blueprint registers — known without a connection. */
   readonly modelNames: readonly string[];
@@ -211,6 +302,6 @@ interface LoyaltyBlueprint {
  * Describe the loyalty engine. Pure — registers no model, builds no schema,
  * performs no I/O. Config is resolved and validated here.
  */
-declare function defineLoyalty(shape?: LoyaltyShape): LoyaltyBlueprint;
+export declare function defineLoyalty(shape?: LoyaltyShape): LoyaltyBlueprint;
 //#endregion
-export { type AdjustPointsInput, type BalanceSummary, CircularReferralError, type CreateEarningRuleInput, type CreateTierInput, type DefineLoyaltyModelsConfig, type DomainEvent, DuplicateReferralError, type EarnPointsInput, type EarningResult, type EarningRule, EarningRuleRepository, type EnrollInput, type EventHandler, type EventTransport, InProcessLoyaltyBus, type InProcessLoyaltyBusOptions, InsufficientPointsError, LoyaltyBlueprint, LoyaltyCapabilityError, type LoyaltyContext, LoyaltyEngine, type LoyaltyEventDefinition, type LoyaltyEventMap, type LoyaltyEventName, type LoyaltyEventPayload, type LoyaltyEventPayloadOf, type LoyaltyEventSchema, LoyaltyEvents, type LoyaltyModelName, type LoyaltyModels, type LoyaltyRepositories, type LoyaltyRuntime, type LoyaltyShape, type Member, MemberAlreadyEnrolledError, type MemberBalance, MemberDeactivated, MemberEnrolled, MemberInactiveError, type MemberLifecyclePayload, MemberNotFoundError, MemberReactivated, MemberRepository, MemberSuspended, type NotificationAdapter, PENDING_EVENTS, type PointTransaction, PointTransactionRepository, PointsAdjusted, type PointsAdjustedPayload, PointsEarned, type PointsEarnedPayload, PointsExpired, type PointsExpiredPayload, PointsExpiringSoon, PointsRedeemed, type Redemption, RedemptionConfirmed, RedemptionExpiredError, RedemptionNotFoundError, type RedemptionPayload, RedemptionReleased, RedemptionRepository, RedemptionReserved, type RedemptionValidation, type Referral, ReferralApproved, ReferralLimitExceededError, ReferralNotFoundError, type ReferralPayload, ReferralRecorded, ReferralRejected, ReferralRepository, ReferralRewarded, type ResolvedConfig, type ResolvedTenant, RuleNotFoundError, SelfReferralError, SessionNotInTransactionError, TenantIsolationError, type TierChangedPayload, type TierDefinition, TierDefinitionRepository, TierDowngraded, type TierEvaluation, TierGraceStarted, TierNotFoundError, TierUpgraded, type UnitOfWork, UnmanagedSessionError, type UpdateEarningRuleInput, type UpdateTierInput, ValidationError, createEvent, defineLoyalty, defineLoyaltyModels, flushPendingLoyaltyEvents, loyaltyEventDefinitions, resolveConfig };
+export { type AdjustPointsInput, type BalanceSummary, type CreateEarningRuleInput, type CreateTierInput, type DefineLoyaltyModelsConfig, type DomainEvent, type EarnBase, type EarnBaseInput, type EarnBaseItem, type EarnBaseLine, type EarnPointsInput, type EarnReversalResult, type EarningResult, type EarningRule, EarningRuleRepository, type EnrollInput, type EventHandler, type EventTransport, InProcessLoyaltyBus, type InProcessLoyaltyBusOptions, type LiveProgramSettings, type LoyaltyContext, type LoyaltyEventDefinition, type LoyaltyEventMap, type LoyaltyEventName, type LoyaltyEventPayload, type LoyaltyEventPayloadOf, type LoyaltyEventSchema, LoyaltyEvents, type LoyaltyLiabilitySnapshot, type LoyaltyModelName, type LoyaltyModels, type LoyaltyRedemption, type LoyaltyRedemptionPort, type LoyaltyRepositories, type LoyaltyReserveInput, type LoyaltyRuntime, type LoyaltyShape, type Member, type MemberBalance, MemberDeactivated, MemberEnrolled, type MemberLifecyclePayload, MemberReactivated, MemberRepository, MemberSuspended, type NotificationAdapter, type PointTransaction, PointTransactionRepository, PointsAdjusted, type PointsAdjustedPayload, PointsEarned, type PointsEarnedPayload, PointsExpired, type PointsExpiredPayload, PointsExpiringSoon, PointsRedeemed, PointsReversed, type PointsReversedPayload, type Redemption, RedemptionConfirmed, type RedemptionOwner, type RedemptionOwnerRebind, type RedemptionPayload, RedemptionReleased, RedemptionRepository, RedemptionReserved, type RedemptionValidation, type Referral, ReferralApproved, type ReferralPayload, ReferralRecorded, ReferralRejected, ReferralRepository, ReferralRewarded, type ResolvedConfig, type ResolvedTenant, type ScheduledRuleLike, type StampAward, StampAwardIssued, type StampAwardIssuedPayload, StampAwardRepository, type StampAwardReward, type StampEarn, StampEarned, type StampEarnedPayload, type StampEntry, type StampOrderInput, type StampOrderLine, type StampProgram, type StampProgramInput, StampProgramRepository, type StampProgress, type StampRecordResult, StampRepository, type StampReversal, StampReversed, type StampReversedPayload, type StampReward, type StampRewardIssuer, type StampVoucherRequest, type TierChangedPayload, type TierDefinition, TierDefinitionRepository, TierDowngraded, type TierEvaluation, TierGraceStarted, TierUpgraded, type UnitOfWork, type UpdateEarningRuleInput, type UpdateTierInput, createEvent, defineLoyaltyModels, earnBase, isRuleInSchedule, loyaltyEventDefinitions };