@classytic/loyalty 0.6.0 → 0.10.0

package/dist/{index-D6GvuvmF.d.mts → index-CorB0JL6.d.mts}

@@ -1,35 +1,170 @@
-import { a as ModelName, n as LoyaltyModelName, t as IndexDefinition } from "./config-CtkGj3xZ.mjs";
+import { c as StampAwardStatus, l as StampEarnUnit, u as StampProgramStatus } from "./index-tjMMmPzU.mjs";
+import { C as IndexDefinition, O as ModelName, T as LoyaltyModelName } from "./index-DRrEhE0r.mjs";
 import { ModelBlueprint } from "@classytic/mongokit";
 import { ResolvedTenantConfig } from "@classytic/repo-core/tenant";
-import mongoose, { InferSchemaType, Model } from "mongoose";
+import mongoose, { InferSchemaType, Model, Types } from "mongoose";
+//#region src/domain/entities/stamp.d.ts
+/** What earns a stamp. An absent filter means "any"; an EMPTY list is refused at write. */
+interface StampEarn {
+  unit: StampEarnUnit;
+  /** Category SLUGS (what an order line freezes as `snapshot.metadata.categoryId`). */
+  categoryIds?: string[];
+  productIds?: string[];
+  /** `spend` only (required there): one stamp per `perMinor` minor units, floored. */
+  perMinor?: number;
+  /** The order total (minor units) an order must reach to earn at all. */
+  minOrderMinor?: number;
+}
+type StampReward = {
+  kind: 'points';
+  points: number;
+} | {
+  kind: 'voucher';
+  voucherProgramId: string;
+};
+interface StampProgram {
+  _id: Types.ObjectId;
+  /** The loyalty program (as on earning rules and members) — not this stamp program's id. */
+  programId: string;
+  name: string;
+  description?: string;
+  status: StampProgramStatus;
+  earn: StampEarn;
+  stampsRequired: number;
+  /** Stamps expire this many days after the order that earned them; absent = never. */
+  stampValidityDays?: number;
+  /** Only orders placed in `[startsAt, endsAt)` earn. */
+  startsAt?: Date;
+  endsAt?: Date;
+  reward: StampReward;
+  maxRewardsPerMember?: number;
+  /** Branches whose orders earn; absent = every branch. */
+  branchIds?: string[];
+  metadata?: Record<string, unknown>;
+  createdAt: Date;
+  updatedAt: Date;
+}
+/** Stamps one order earned on one program. Idempotency is the unique index, never a lookup. */
+interface StampEntry {
+  _id: Types.ObjectId;
+  stampProgramId: Types.ObjectId;
+  memberId: Types.ObjectId;
+  orderRef: string;
+  stamps: number;
+  /** Stamps of this entry already spent on awards (oldest entries are consumed first). */
+  consumed: number;
+  earnedAt: Date;
+  expiresAt?: Date;
+  /** The business day (`YYYY-MM-DD` in the engine's timezone) the order fell on. */
+  businessDay: string;
+  /** Set on `visit` entries while live — the unique index allows one visit stamp per day. */
+  visitKey?: string;
+  branchId?: string;
+  reversedAt?: Date;
+  /** Unconsumed stamps the reversal removed. */
+  reversedStamps?: number;
+}
+interface StampAwardReward {
+  kind: 'points' | 'voucher';
+  points?: number;
+  pointTransactionId?: Types.ObjectId;
+  voucherProgramId?: string;
+  voucherId?: string;
+  code?: string;
+}
+interface StampAward {
+  _id: Types.ObjectId;
+  stampProgramId: Types.ObjectId;
+  memberId: Types.ObjectId;
+  /** 1-based per (program, member); unique, so two concurrent settles cannot both award #n. */
+  sequence: number;
+  /** `stamp:<stampProgramId>:<memberId>:<sequence>` — the reward's idempotency key. */
+  awardKey: string;
+  entries: Array<{
+    entryId: Types.ObjectId;
+    stamps: number;
+  }>;
+  stampsConsumed: number;
+  status: StampAwardStatus;
+  reward: StampAwardReward;
+  awardedAt: Date;
+  issuedAt?: Date;
+}
+/** One priced order line, integer minor units. */
+interface StampOrderLine {
+  productId?: string | undefined;
+  categoryId?: string | undefined;
+  quantity: number;
+  amountMinor: number;
+  /** The quantity increment the line sells in (`0.001` for rice by the kg). Absent = 1, a whole-unit item. */
+  quantityStep?: number | undefined;
+}
+interface StampOrderInput {
+  memberId: string;
+  /** Retry-stable order identity (the order number). */
+  orderRef: string;
+  occurredAt: Date;
+  branchId?: string | undefined;
+  orderTotalMinor: number;
+  lines: StampOrderLine[];
+}
+interface StampProgress {
+  stampProgramId: string;
+  name: string;
+  stampsRequired: number;
+  /** Unexpired, unconsumed, unreversed stamps. */
+  stamps: number;
+  /** When the soonest of those stamps expires; absent when none expire. */
+  nextExpiry?: Date;
+  rewardsEarned: number;
+  maxRewardsPerMember?: number;
+  reward: StampReward;
+}
+interface StampRecordResult {
+  stampProgramId: string;
+  /** Stamps this call added — 0 when the order (or the visit day) was already recorded. */
+  stamps: number;
+  duplicate: boolean;
+  awards: StampAward[];
+}
+interface StampReversal {
+  stampProgramId: string;
+  memberId: string;
+  entryId: string;
+  /** Unconsumed stamps removed. */
+  reversed: number;
+  /** Stamps already consumed into an award — kept, never clawed back. */
+  retainedInAwards: number;
+}
+//#endregion
 //#region src/models/schemas/earning-rule.schema.d.ts
 declare function createEarningRuleSchema(): mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
   timestamps: true;
 }, {
   programId: string;
-  type: "order" | "action" | "category" | "tier_bonus";
   name: string;
-  status: "active" | "paused" | "expired";
-  priority: number;
   description?: string | null;
+  type: "action" | "category" | "order" | "tier_bonus";
+  status: "active" | "expired" | "paused";
+  priority: number;
   conditions?: {
+    minOrderAmount?: number | null;
     categories: string[];
     tiers: string[];
     actions: string[];
     dayOfWeek: number[];
-    minOrderAmount?: number | null;
     dateRange?: {
       start?: NativeDate | null;
       end?: NativeDate | null;
     } | null;
   } | null;
   reward?: {
-    roundingMode: "floor" | "round" | "ceil";
     pointsPerAmount?: number | null;
     rateBasis?: number | null;
     amountPerPoint?: number | null;
     fixedPoints?: number | null;
     multiplier?: number | null;
+    roundingMode: "ceil" | "floor" | "round";
     maxPointsPerTransaction?: number | null;
   } | null;
   startsAt?: NativeDate | null;
@@ -37,29 +172,29 @@ declare function createEarningRuleSchema(): mongoose.Schema<any, mongoose.Model<
   metadata?: any;
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
   programId: string;
-  type: "order" | "action" | "category" | "tier_bonus";
   name: string;
-  status: "active" | "paused" | "expired";
-  priority: number;
   description?: string | null;
+  type: "action" | "category" | "order" | "tier_bonus";
+  status: "active" | "expired" | "paused";
+  priority: number;
   conditions?: {
+    minOrderAmount?: number | null;
     categories: string[];
     tiers: string[];
     actions: string[];
     dayOfWeek: number[];
-    minOrderAmount?: number | null;
     dateRange?: {
       start?: NativeDate | null;
       end?: NativeDate | null;
     } | null;
   } | null;
   reward?: {
-    roundingMode: "floor" | "round" | "ceil";
     pointsPerAmount?: number | null;
     rateBasis?: number | null;
     amountPerPoint?: number | null;
     fixedPoints?: number | null;
     multiplier?: number | null;
+    roundingMode: "ceil" | "floor" | "round";
     maxPointsPerTransaction?: number | null;
   } | null;
   startsAt?: NativeDate | null;
@@ -71,29 +206,29 @@ declare function createEarningRuleSchema(): mongoose.Schema<any, mongoose.Model<
   timestamps: true;
 }> & Omit<{
   programId: string;
-  type: "order" | "action" | "category" | "tier_bonus";
   name: string;
-  status: "active" | "paused" | "expired";
-  priority: number;
   description?: string | null;
+  type: "action" | "category" | "order" | "tier_bonus";
+  status: "active" | "expired" | "paused";
+  priority: number;
   conditions?: {
+    minOrderAmount?: number | null;
     categories: string[];
     tiers: string[];
     actions: string[];
     dayOfWeek: number[];
-    minOrderAmount?: number | null;
     dateRange?: {
       start?: NativeDate | null;
       end?: NativeDate | null;
     } | null;
   } | null;
   reward?: {
-    roundingMode: "floor" | "round" | "ceil";
     pointsPerAmount?: number | null;
     rateBasis?: number | null;
     amountPerPoint?: number | null;
     fixedPoints?: number | null;
     multiplier?: number | null;
+    roundingMode: "ceil" | "floor" | "round";
     maxPointsPerTransaction?: number | null;
   } | null;
   startsAt?: NativeDate | null;
@@ -106,37 +241,37 @@ declare function createEarningRuleSchema(): mongoose.Schema<any, mongoose.Model<
 }, "id"> & mongoose.HydratedDocumentOverrides<{
   id: string;
 }>, unknown, {
+  createdAt: NativeDate;
+  updatedAt: NativeDate;
   programId: string;
-  type: "order" | "action" | "category" | "tier_bonus";
   name: string;
-  status: "active" | "paused" | "expired";
-  priority: number;
   description?: string | null;
+  type: "action" | "category" | "order" | "tier_bonus";
+  status: "active" | "expired" | "paused";
+  priority: number;
   conditions?: {
+    minOrderAmount?: number | null;
     categories: string[];
     tiers: string[];
     actions: string[];
     dayOfWeek: number[];
-    minOrderAmount?: number | null;
     dateRange?: {
       start?: NativeDate | null;
       end?: NativeDate | null;
     } | null;
   } | null;
   reward?: {
-    roundingMode: "floor" | "round" | "ceil";
     pointsPerAmount?: number | null;
     rateBasis?: number | null;
     amountPerPoint?: number | null;
     fixedPoints?: number | null;
     multiplier?: number | null;
+    roundingMode: "ceil" | "floor" | "round";
     maxPointsPerTransaction?: number | null;
   } | null;
   startsAt?: NativeDate | null;
   endsAt?: NativeDate | null;
   metadata?: any;
-  createdAt: NativeDate;
-  updatedAt: NativeDate;
 } & {
   _id: mongoose.Types.ObjectId;
 } & {
@@ -148,11 +283,9 @@ declare function createMemberSchema(): mongoose.Schema<any, mongoose.Model<any,
   timestamps: true;
 }, {
   programId: string;
-  status: "active" | "inactive" | "suspended";
   externalId: string;
   externalType: string;
-  enrolledAt: NativeDate;
-  metadata?: any;
+  status: "active" | "inactive" | "suspended";
   cardId?: string | null;
   referralCode?: string | null;
   tier?: string | null;
@@ -163,19 +296,19 @@ declare function createMemberSchema(): mongoose.Schema<any, mongoose.Model<any,
   tierQualifiedAt?: NativeDate | null;
   tierExpiresAt?: NativeDate | null;
   balance?: {
-    expired: number;
     current: number;
     lifetime: number;
     redeemed: number;
+    expired: number;
   } | null;
+  enrolledAt: NativeDate;
   deactivatedAt?: NativeDate | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
   programId: string;
-  status: "active" | "inactive" | "suspended";
   externalId: string;
   externalType: string;
-  enrolledAt: NativeDate;
-  metadata?: any;
+  status: "active" | "inactive" | "suspended";
   cardId?: string | null;
   referralCode?: string | null;
   tier?: string | null;
@@ -186,23 +319,23 @@ declare function createMemberSchema(): mongoose.Schema<any, mongoose.Model<any,
   tierQualifiedAt?: NativeDate | null;
   tierExpiresAt?: NativeDate | null;
   balance?: {
-    expired: number;
     current: number;
     lifetime: number;
     redeemed: number;
+    expired: number;
   } | null;
+  enrolledAt: NativeDate;
   deactivatedAt?: NativeDate | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps, {
   id: string;
 }, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
   timestamps: true;
 }> & Omit<{
   programId: string;
-  status: "active" | "inactive" | "suspended";
   externalId: string;
   externalType: string;
-  enrolledAt: NativeDate;
-  metadata?: any;
+  status: "active" | "inactive" | "suspended";
   cardId?: string | null;
   referralCode?: string | null;
   tier?: string | null;
@@ -213,12 +346,14 @@ declare function createMemberSchema(): mongoose.Schema<any, mongoose.Model<any,
   tierQualifiedAt?: NativeDate | null;
   tierExpiresAt?: NativeDate | null;
   balance?: {
-    expired: number;
     current: number;
     lifetime: number;
     redeemed: number;
+    expired: number;
   } | null;
+  enrolledAt: NativeDate;
   deactivatedAt?: NativeDate | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps & {
   _id: mongoose.Types.ObjectId;
 } & {
@@ -226,12 +361,12 @@ declare function createMemberSchema(): mongoose.Schema<any, mongoose.Model<any,
 }, "id"> & mongoose.HydratedDocumentOverrides<{
   id: string;
 }>, unknown, {
+  createdAt: NativeDate;
+  updatedAt: NativeDate;
   programId: string;
-  status: "active" | "inactive" | "suspended";
   externalId: string;
   externalType: string;
-  enrolledAt: NativeDate;
-  metadata?: any;
+  status: "active" | "inactive" | "suspended";
   cardId?: string | null;
   referralCode?: string | null;
   tier?: string | null;
@@ -242,14 +377,14 @@ declare function createMemberSchema(): mongoose.Schema<any, mongoose.Model<any,
   tierQualifiedAt?: NativeDate | null;
   tierExpiresAt?: NativeDate | null;
   balance?: {
-    expired: number;
     current: number;
     lifetime: number;
     redeemed: number;
+    expired: number;
   } | null;
+  enrolledAt: NativeDate;
   deactivatedAt?: NativeDate | null;
-  createdAt: NativeDate;
-  updatedAt: NativeDate;
+  metadata?: any;
 } & {
   _id: mongoose.Types.ObjectId;
 } & {
@@ -263,42 +398,46 @@ declare function createPointTransactionSchema(): mongoose.Schema<any, mongoose.M
     updatedAt: false;
   };
 }, {
-  programId: string;
-  type: "earn" | "redeem" | "adjust" | "expire" | "transfer" | "referral_bonus";
-  description: string;
   memberId: mongoose.Types.ObjectId;
+  programId: string;
+  type: "adjust" | "earn" | "expire" | "redeem" | "referral_bonus" | "reverse" | "transfer";
   points: number;
   balanceAfter: number;
-  actorId: string;
-  metadata?: any;
-  expiresAt?: NativeDate | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
+  description: string;
+  source?: "action" | "campaign" | "order" | "referral" | null;
+  pointValueMinor?: number | null;
   referenceType?: string | null;
   referenceId?: string | null;
   idempotencyKey?: string | null;
   earningRuleId?: mongoose.Types.ObjectId | null;
+  expiresAt?: NativeDate | null;
   expiredAt?: NativeDate | null;
+  metadata?: any;
+  actorId: string;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   createdAt: NativeDate;
 }, mongoose.Document<unknown, {}, {
-  programId: string;
-  type: "earn" | "redeem" | "adjust" | "expire" | "transfer" | "referral_bonus";
-  description: string;
   memberId: mongoose.Types.ObjectId;
+  programId: string;
+  type: "adjust" | "earn" | "expire" | "redeem" | "referral_bonus" | "reverse" | "transfer";
   points: number;
   balanceAfter: number;
-  actorId: string;
-  metadata?: any;
-  expiresAt?: NativeDate | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
+  description: string;
+  source?: "action" | "campaign" | "order" | "referral" | null;
+  pointValueMinor?: number | null;
   referenceType?: string | null;
   referenceId?: string | null;
   idempotencyKey?: string | null;
   earningRuleId?: mongoose.Types.ObjectId | null;
+  expiresAt?: NativeDate | null;
   expiredAt?: NativeDate | null;
+  metadata?: any;
+  actorId: string;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   createdAt: NativeDate;
 }, {
   id: string;
@@ -308,23 +447,25 @@ declare function createPointTransactionSchema(): mongoose.Schema<any, mongoose.M
     updatedAt: false;
   };
 }> & Omit<{
-  programId: string;
-  type: "earn" | "redeem" | "adjust" | "expire" | "transfer" | "referral_bonus";
-  description: string;
   memberId: mongoose.Types.ObjectId;
+  programId: string;
+  type: "adjust" | "earn" | "expire" | "redeem" | "referral_bonus" | "reverse" | "transfer";
   points: number;
   balanceAfter: number;
-  actorId: string;
-  metadata?: any;
-  expiresAt?: NativeDate | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
+  description: string;
+  source?: "action" | "campaign" | "order" | "referral" | null;
+  pointValueMinor?: number | null;
   referenceType?: string | null;
   referenceId?: string | null;
   idempotencyKey?: string | null;
   earningRuleId?: mongoose.Types.ObjectId | null;
+  expiresAt?: NativeDate | null;
   expiredAt?: NativeDate | null;
+  metadata?: any;
+  actorId: string;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   createdAt: NativeDate;
 } & {
   _id: mongoose.Types.ObjectId;
@@ -333,23 +474,25 @@ declare function createPointTransactionSchema(): mongoose.Schema<any, mongoose.M
 }, "id"> & mongoose.HydratedDocumentOverrides<{
   id: string;
 }>, unknown, {
-  programId: string;
-  type: "earn" | "redeem" | "adjust" | "expire" | "transfer" | "referral_bonus";
-  description: string;
   memberId: mongoose.Types.ObjectId;
+  programId: string;
+  type: "adjust" | "earn" | "expire" | "redeem" | "referral_bonus" | "reverse" | "transfer";
   points: number;
   balanceAfter: number;
-  actorId: string;
-  metadata?: any;
-  expiresAt?: NativeDate | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
+  description: string;
+  source?: "action" | "campaign" | "order" | "referral" | null;
+  pointValueMinor?: number | null;
   referenceType?: string | null;
   referenceId?: string | null;
   idempotencyKey?: string | null;
   earningRuleId?: mongoose.Types.ObjectId | null;
+  expiresAt?: NativeDate | null;
   expiredAt?: NativeDate | null;
+  metadata?: any;
+  actorId: string;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   createdAt: NativeDate;
 } & {
   _id: mongoose.Types.ObjectId;
@@ -361,13 +504,13 @@ declare function createPointTransactionSchema(): mongoose.Schema<any, mongoose.M
 declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any, any>, {}, {}, {}, {}, {
   timestamps: true;
 }, {
-  programId: string;
-  status: "expired" | "reserved" | "confirmed" | "released" | "reversed";
   memberId: mongoose.Types.ObjectId;
+  programId: string;
   pointsReserved: number;
   pointsConfirmed: number;
   discountAmount: number;
   pointValueMinor: number;
+  status: "confirmed" | "expired" | "released" | "reserved" | "reversed";
   ownerType: string;
   ownerId: string;
   expiresAt?: NativeDate | null;
@@ -383,13 +526,13 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
   approvalPolicyId?: string | null;
   approvalPolicyVersion?: number | null;
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
-  programId: string;
-  status: "expired" | "reserved" | "confirmed" | "released" | "reversed";
   memberId: mongoose.Types.ObjectId;
+  programId: string;
   pointsReserved: number;
   pointsConfirmed: number;
   discountAmount: number;
   pointValueMinor: number;
+  status: "confirmed" | "expired" | "released" | "reserved" | "reversed";
   ownerType: string;
   ownerId: string;
   expiresAt?: NativeDate | null;
@@ -409,13 +552,13 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
 }, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
   timestamps: true;
 }> & Omit<{
-  programId: string;
-  status: "expired" | "reserved" | "confirmed" | "released" | "reversed";
   memberId: mongoose.Types.ObjectId;
+  programId: string;
   pointsReserved: number;
   pointsConfirmed: number;
   discountAmount: number;
   pointValueMinor: number;
+  status: "confirmed" | "expired" | "released" | "reserved" | "reversed";
   ownerType: string;
   ownerId: string;
   expiresAt?: NativeDate | null;
@@ -437,13 +580,15 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
 }, "id"> & mongoose.HydratedDocumentOverrides<{
   id: string;
 }>, unknown, {
-  programId: string;
-  status: "expired" | "reserved" | "confirmed" | "released" | "reversed";
+  createdAt: NativeDate;
+  updatedAt: NativeDate;
   memberId: mongoose.Types.ObjectId;
+  programId: string;
   pointsReserved: number;
   pointsConfirmed: number;
   discountAmount: number;
   pointValueMinor: number;
+  status: "confirmed" | "expired" | "released" | "reserved" | "reversed";
   ownerType: string;
   ownerId: string;
   expiresAt?: NativeDate | null;
@@ -458,8 +603,6 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
   approvals?: any;
   approvalPolicyId?: string | null;
   approvalPolicyVersion?: number | null;
-  createdAt: NativeDate;
-  updatedAt: NativeDate;
 } & {
   _id: mongoose.Types.ObjectId;
 } & {
@@ -471,12 +614,10 @@ declare function createReferralSchema(): mongoose.Schema<any, mongoose.Model<any
   timestamps: true;
 }, {
   programId: string;
-  status: "expired" | "pending" | "approved" | "rejected";
-  referralCode: string;
   referrerId: mongoose.Types.ObjectId;
   refereeId: mongoose.Types.ObjectId;
-  metadata?: any;
-  expiresAt?: NativeDate | null;
+  referralCode: string;
+  status: "approved" | "expired" | "pending" | "rejected";
   referrerRewardPoints?: number | null;
   refereeRewardPoints?: number | null;
   referrerTransactionId?: mongoose.Types.ObjectId | null;
@@ -484,14 +625,14 @@ declare function createReferralSchema(): mongoose.Schema<any, mongoose.Model<any
   approvedAt?: NativeDate | null;
   rejectedAt?: NativeDate | null;
   rejectionReason?: string | null;
+  expiresAt?: NativeDate | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
   programId: string;
-  status: "expired" | "pending" | "approved" | "rejected";
-  referralCode: string;
   referrerId: mongoose.Types.ObjectId;
   refereeId: mongoose.Types.ObjectId;
-  metadata?: any;
-  expiresAt?: NativeDate | null;
+  referralCode: string;
+  status: "approved" | "expired" | "pending" | "rejected";
   referrerRewardPoints?: number | null;
   refereeRewardPoints?: number | null;
   referrerTransactionId?: mongoose.Types.ObjectId | null;
@@ -499,18 +640,18 @@ declare function createReferralSchema(): mongoose.Schema<any, mongoose.Model<any
   approvedAt?: NativeDate | null;
   rejectedAt?: NativeDate | null;
   rejectionReason?: string | null;
+  expiresAt?: NativeDate | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps, {
   id: string;
 }, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
   timestamps: true;
 }> & Omit<{
   programId: string;
-  status: "expired" | "pending" | "approved" | "rejected";
-  referralCode: string;
   referrerId: mongoose.Types.ObjectId;
   refereeId: mongoose.Types.ObjectId;
-  metadata?: any;
-  expiresAt?: NativeDate | null;
+  referralCode: string;
+  status: "approved" | "expired" | "pending" | "rejected";
   referrerRewardPoints?: number | null;
   refereeRewardPoints?: number | null;
   referrerTransactionId?: mongoose.Types.ObjectId | null;
@@ -518,6 +659,8 @@ declare function createReferralSchema(): mongoose.Schema<any, mongoose.Model<any
   approvedAt?: NativeDate | null;
   rejectedAt?: NativeDate | null;
   rejectionReason?: string | null;
+  expiresAt?: NativeDate | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps & {
   _id: mongoose.Types.ObjectId;
 } & {
@@ -525,13 +668,13 @@ declare function createReferralSchema(): mongoose.Schema<any, mongoose.Model<any
 }, "id"> & mongoose.HydratedDocumentOverrides<{
   id: string;
 }>, unknown, {
+  createdAt: NativeDate;
+  updatedAt: NativeDate;
   programId: string;
-  status: "expired" | "pending" | "approved" | "rejected";
-  referralCode: string;
   referrerId: mongoose.Types.ObjectId;
   refereeId: mongoose.Types.ObjectId;
-  metadata?: any;
-  expiresAt?: NativeDate | null;
+  referralCode: string;
+  status: "approved" | "expired" | "pending" | "rejected";
   referrerRewardPoints?: number | null;
   refereeRewardPoints?: number | null;
   referrerTransactionId?: mongoose.Types.ObjectId | null;
@@ -539,8 +682,8 @@ declare function createReferralSchema(): mongoose.Schema<any, mongoose.Model<any
   approvedAt?: NativeDate | null;
   rejectedAt?: NativeDate | null;
   rejectionReason?: string | null;
-  createdAt: NativeDate;
-  updatedAt: NativeDate;
+  expiresAt?: NativeDate | null;
+  metadata?: any;
 } & {
   _id: mongoose.Types.ObjectId;
 } & {
@@ -554,7 +697,6 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
   programId: string;
   name: string;
   rank: number;
-  metadata?: any;
   qualificationCriteria?: {
     minLifetimePoints?: number | null;
     minLifetimeSpend?: number | null;
@@ -571,11 +713,11 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
     gracePeriodDays: number;
   } | null;
   color?: string | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
   programId: string;
   name: string;
   rank: number;
-  metadata?: any;
   qualificationCriteria?: {
     minLifetimePoints?: number | null;
     minLifetimeSpend?: number | null;
@@ -592,6 +734,7 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
     gracePeriodDays: number;
   } | null;
   color?: string | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps, {
   id: string;
 }, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
@@ -600,7 +743,6 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
   programId: string;
   name: string;
   rank: number;
-  metadata?: any;
   qualificationCriteria?: {
     minLifetimePoints?: number | null;
     minLifetimeSpend?: number | null;
@@ -617,6 +759,7 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
     gracePeriodDays: number;
   } | null;
   color?: string | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps & {
   _id: mongoose.Types.ObjectId;
 } & {
@@ -624,10 +767,11 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
 }, "id"> & mongoose.HydratedDocumentOverrides<{
   id: string;
 }>, unknown, {
+  createdAt: NativeDate;
+  updatedAt: NativeDate;
   programId: string;
   name: string;
   rank: number;
-  metadata?: any;
   qualificationCriteria?: {
     minLifetimePoints?: number | null;
     minLifetimeSpend?: number | null;
@@ -644,8 +788,7 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
     gracePeriodDays: number;
   } | null;
   color?: string | null;
-  createdAt: NativeDate;
-  updatedAt: NativeDate;
+  metadata?: any;
 } & {
   _id: mongoose.Types.ObjectId;
 } & {
@@ -661,6 +804,9 @@ interface LoyaltyModels {
   TierDefinition: Model<InferSchemaType<ReturnType<typeof createTierDefinitionSchema>>>;
   Redemption: Model<InferSchemaType<ReturnType<typeof createRedemptionSchema>>>;
   Referral: Model<InferSchemaType<ReturnType<typeof createReferralSchema>>>;
+  StampProgram: Model<StampProgram>;
+  StampEntry: Model<StampEntry>;
+  StampAward: Model<StampAward>;
 }
 interface DefineLoyaltyModelsConfig {
   /** Resolved tenant descriptor — injected into every schema (see `injectTenantField`). */
@@ -689,4 +835,4 @@ interface DefineLoyaltyModelsConfig {
  */
 declare function defineLoyaltyModels(config: DefineLoyaltyModelsConfig): ModelBlueprint<LoyaltyModels>;
 //#endregion
-export { LoyaltyModels as n, defineLoyaltyModels as r, DefineLoyaltyModelsConfig as t };
+export { StampAwardReward as a, StampOrderInput as c, StampProgress as d, StampRecordResult as f, StampAward as i, StampOrderLine as l, StampReward as m, LoyaltyModels as n, StampEarn as o, StampReversal as p, defineLoyaltyModels as r, StampEntry as s, DefineLoyaltyModelsConfig as t, StampProgram as u };