@classytic/loyalty 0.1.0 → 0.2.1

package/dist/index-BOWqBSWx.d.mts

@@ -0,0 +1,281 @@
+import { a as RuleStatus, n as MemberStatus, o as RuleType, s as TransactionType } from "./index-DMK8a98J.mjs";
+import { OperationContext } from "@classytic/primitives/context";
+
+//#region src/domain/entities/earning-rule.d.ts
+interface EarningConditions {
+  minOrderAmount?: number;
+  categories?: string[];
+  tiers?: string[];
+  actions?: string[];
+  dayOfWeek?: number[];
+  dateRange?: {
+    start?: Date;
+    end?: Date;
+  };
+}
+interface EarningReward {
+  pointsPerAmount?: number;
+  amountPerPoint?: number;
+  fixedPoints?: number;
+  multiplier?: number;
+  roundingMode?: 'floor' | 'round' | 'ceil';
+  maxPointsPerTransaction?: number;
+}
+interface EarningRule {
+  _id: string;
+  programId: string;
+  name: string;
+  description?: string;
+  type: RuleType;
+  status: RuleStatus;
+  priority: number;
+  conditions: EarningConditions;
+  reward: EarningReward;
+  startsAt?: Date;
+  endsAt?: Date;
+  metadata?: Record<string, unknown>;
+  createdAt: Date;
+  updatedAt: Date;
+}
+//#endregion
+//#region src/domain/entities/tier-definition.d.ts
+interface TierQualification {
+  minLifetimePoints?: number;
+  minLifetimeSpend?: number;
+  evaluationPeriodDays?: number;
+}
+interface TierBenefits {
+  pointsMultiplier?: number;
+  discountPercent?: number;
+  freeShipping?: boolean;
+  customBenefits?: Record<string, unknown>;
+}
+interface TierDowngrade {
+  enabled: boolean;
+  gracePeriodDays: number;
+}
+interface TierDefinition {
+  _id: string;
+  programId: string;
+  name: string;
+  rank: number;
+  qualificationCriteria: TierQualification;
+  benefits: TierBenefits;
+  downgrade: TierDowngrade;
+  color?: string;
+  metadata?: Record<string, unknown>;
+  createdAt: Date;
+  updatedAt: Date;
+}
+//#endregion
+//#region src/domain/entities/member.d.ts
+interface MemberBalance {
+  current: number;
+  lifetime: number;
+  redeemed: number;
+  expired: number;
+}
+interface Member {
+  _id: string;
+  programId: string;
+  externalId: string;
+  externalType: string;
+  status: MemberStatus;
+  /** Public loyalty card identifier (e.g., MBR-DHK-00004821-8). Set by the integration layer. */
+  cardId?: string;
+  /** Referral code for the referral system (separate from cardId). Auto-generated on enrollment. */
+  referralCode: string;
+  tier: string | null;
+  tierOverride: string | null;
+  tierOverrideReason?: string;
+  /**
+   * Optional TTL on a manual tier override. When set, `evaluateMember`
+   * treats the override as already cleared once `tierOverrideExpiresAt <=
+   * now`, and a host-scheduled `sweepExpiredOverrides` cron clears the
+   * field + emits a `TIER_OVERRIDE_EXPIRED` audit event.
+   */
+  tierOverrideExpiresAt?: Date;
+  /** Optional upstream referrer for multi-tier referral chains. */
+  referredBy?: string;
+  tierQualifiedAt?: Date;
+  tierExpiresAt?: Date;
+  balance: MemberBalance;
+  enrolledAt: Date;
+  deactivatedAt?: Date;
+  metadata?: Record<string, unknown>;
+  createdAt: Date;
+  updatedAt: Date;
+}
+//#endregion
+//#region src/domain/entities/point-transaction.d.ts
+interface PointTransaction {
+  _id: string;
+  memberId: string;
+  programId: string;
+  type: TransactionType;
+  points: number;
+  balanceAfter: number;
+  description: string;
+  referenceType?: string;
+  referenceId?: string;
+  idempotencyKey?: string;
+  earningRuleId?: string;
+  expiresAt?: Date;
+  expiredAt?: Date;
+  metadata?: Record<string, unknown>;
+  actorId: string;
+  createdAt: Date;
+}
+//#endregion
+//#region src/types/results.d.ts
+interface BalanceSummary extends MemberBalance {
+  tier: string | null;
+  tierOverride: string | null;
+}
+interface EarningBreakdown {
+  ruleId: string;
+  ruleName: string;
+  points: number;
+}
+interface EarningResult {
+  totalPoints: number;
+  breakdown: EarningBreakdown[];
+  transactions: PointTransaction[];
+}
+interface TierEvaluation {
+  memberId: string;
+  previousTier: string | null;
+  newTier: string | null;
+  action: 'upgraded' | 'downgraded' | 'grace_period' | 'unchanged';
+  graceExpiresAt?: Date;
+}
+interface TierEvaluationBatch {
+  upgraded: number;
+  downgraded: number;
+  unchanged: number;
+}
+interface RedemptionValidation {
+  valid: boolean;
+  error?: string;
+  pointsToRedeem: number;
+  discountAmount: number;
+  maxAllowedPoints: number;
+}
+interface ExpirationResult {
+  membersAffected: number;
+  pointsExpired: number;
+  transactionCount: number;
+}
+interface PaginatedResult<T> {
+  docs: T[];
+  total: number;
+  page: number;
+  pages: number;
+  hasNext: boolean;
+  hasPrev: boolean;
+}
+interface ListQuery {
+  page?: number;
+  limit?: number;
+  sort?: Record<string, 1 | -1>;
+}
+//#endregion
+//#region src/types/index.d.ts
+/**
+ * Context passed to every loyalty operation.
+ *
+ * The tenant key is dynamic — if you configured `tenant: { field: 'companyId', contextKey: 'companyId' }`,
+ * pass `{ companyId: '...' }` in the context. The `[key: string]: unknown` index allows this.
+ *
+ * For the default config (`tenant: true` or `tenant: undefined`), pass `organizationId`.
+ * For `tenant: false`, the tenant key is ignored.
+ */
+/**
+ * Extends `@classytic/primitives`' {@link OperationContext} with loyalty-
+ * specific fields. `actorId` is narrowed to a required `string` since every
+ * loyalty mutation is attributed; other primitives fields (`correlationId`,
+ * `traceId`, `requestId`, `session`, `metadata`) flow through unchanged.
+ */
+interface LoyaltyContext extends OperationContext {
+  /** Required for loyalty: who is performing this operation. Narrowed to string. */
+  actorId: string;
+  /** Narrowed from primitives' `IdLike` to string. */
+  organizationId?: string;
+  /** Override program ID for multi-program setups. */
+  programId?: string;
+  /** Dynamic tenant key support — e.g. `{ companyId: '...' }` — when a host
+   *  configured a custom `contextKey`. */
+  [key: string]: unknown;
+}
+interface EnrollInput {
+  externalId: string;
+  externalType: string;
+  programId?: string;
+  tier?: string;
+  cardId?: string;
+  metadata?: Record<string, unknown>;
+}
+interface EarnPointsInput {
+  memberId: string;
+  points: number;
+  description: string;
+  referenceType?: string;
+  referenceId?: string;
+  earningRuleId?: string;
+  expiresAt?: Date;
+  idempotencyKey?: string;
+  metadata?: Record<string, unknown>;
+}
+interface AdjustPointsInput {
+  memberId: string;
+  points: number;
+  description: string;
+  reason: string;
+  referenceType?: string;
+  referenceId?: string;
+  idempotencyKey?: string;
+  metadata?: Record<string, unknown>;
+}
+interface CreateEarningRuleInput {
+  name: string;
+  type: 'order' | 'action' | 'category' | 'tier_bonus';
+  priority?: number;
+  description?: string;
+  conditions?: EarningConditions;
+  reward: EarningReward;
+  startsAt?: Date | string;
+  endsAt?: Date | string;
+  programId?: string;
+  metadata?: Record<string, unknown>;
+}
+interface UpdateEarningRuleInput {
+  name?: string;
+  priority?: number;
+  description?: string;
+  conditions?: EarningConditions;
+  reward?: EarningReward;
+  startsAt?: Date | string;
+  endsAt?: Date | string;
+  metadata?: Record<string, unknown>;
+}
+interface CreateTierInput {
+  name: string;
+  rank: number;
+  qualificationCriteria?: TierQualification;
+  benefits?: TierBenefits;
+  downgrade?: TierDowngrade;
+  color?: string;
+  programId?: string;
+  metadata?: Record<string, unknown>;
+}
+interface UpdateTierInput {
+  name?: string;
+  rank?: number;
+  qualificationCriteria?: TierQualification;
+  benefits?: TierBenefits;
+  downgrade?: TierDowngrade;
+  color?: string;
+  metadata?: Record<string, unknown>;
+}
+//#endregion
+export { EarningRule as S, TierEvaluationBatch as _, EnrollInput as a, MemberBalance as b, UpdateTierInput as c, EarningResult as d, ExpirationResult as f, TierEvaluation as g, RedemptionValidation as h, EarnPointsInput as i, BalanceSummary as l, PaginatedResult as m, CreateEarningRuleInput as n, LoyaltyContext as o, ListQuery as p, CreateTierInput as r, UpdateEarningRuleInput as s, AdjustPointsInput as t, EarningBreakdown as u, PointTransaction as v, TierDefinition as x, Member as y };

package/dist/index-C4jFHS7m.d.mts

@@ -0,0 +1,400 @@
+import { o as LoyaltyContext } from "./index-BOWqBSWx.mjs";
+import { DomainEvent, DomainEvent as DomainEvent$1, EventHandler, EventHandler as EventHandler$1, EventTransport, EventTransport as EventTransport$1 } from "@classytic/primitives/events";
+import { z } from "zod";
+
+//#region src/events/helpers.d.ts
+declare function createEvent$1<T>(type: string, payload: T, ctx?: LoyaltyContext, meta?: Partial<DomainEvent['meta']>): DomainEvent<T>;
+//#endregion
+//#region src/events/in-process-bus.d.ts
+interface InProcessLoyaltyBusOptions {
+  /** Logger for handler errors (default: console). */
+  logger?: {
+    error: (msg: string, ...args: unknown[]) => void;
+  };
+}
+declare class InProcessLoyaltyBus implements EventTransport {
+  readonly name = "in-process-loyalty";
+  private handlers;
+  private logger;
+  constructor(options?: InProcessLoyaltyBusOptions);
+  publish(event: DomainEvent): Promise<void>;
+  subscribe(pattern: string, handler: EventHandler): Promise<() => void>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/events/loyalty-event-catalog.d.ts
+interface LoyaltyEventSchema {
+  type: 'object';
+  properties?: Record<string, {
+    type?: string;
+    format?: string;
+    [key: string]: unknown;
+  }>;
+  required?: string[];
+  [key: string]: unknown;
+}
+interface LoyaltyEventDefinition<TSchema extends z.ZodType = z.ZodType> {
+  readonly name: string;
+  readonly version: number;
+  readonly description?: string;
+  readonly schema: LoyaltyEventSchema;
+  readonly zodSchema: TSchema;
+  create(payload: z.infer<TSchema>, meta?: Partial<DomainEvent['meta']>): DomainEvent<z.infer<TSchema>>;
+  readonly __payload?: z.infer<TSchema>;
+}
+type LoyaltyEventPayloadOf<D> = D extends LoyaltyEventDefinition<infer S> ? z.infer<S> : never;
+declare const MemberEnrolled: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  externalType: z.ZodString;
+  status: z.ZodString;
+}, z.core.$strip>>;
+declare const MemberDeactivated: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  externalType: z.ZodString;
+  status: z.ZodString;
+}, z.core.$strip>>;
+declare const MemberReactivated: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  externalType: z.ZodString;
+  status: z.ZodString;
+}, z.core.$strip>>;
+declare const MemberSuspended: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  externalType: z.ZodString;
+  status: z.ZodString;
+}, z.core.$strip>>;
+declare const PointsEarned: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  externalType: z.ZodString;
+  points: z.ZodNumber;
+  balanceAfter: z.ZodNumber;
+  transactionId: z.ZodString;
+  earningRuleName: z.ZodOptional<z.ZodString>;
+  referenceType: z.ZodOptional<z.ZodString>;
+  referenceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const PointsRedeemed: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  points: z.ZodNumber;
+  balanceAfter: z.ZodNumber;
+  transactionId: z.ZodString;
+  description: z.ZodString;
+}, z.core.$strip>>;
+declare const PointsAdjusted: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  points: z.ZodNumber;
+  balanceAfter: z.ZodNumber;
+  transactionId: z.ZodString;
+  description: 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 PointsExpiringSoon: LoyaltyEventDefinition<z.ZodObject<{
+  membersAffected: z.ZodNumber;
+  pointsExpired: z.ZodNumber;
+  transactionCount: z.ZodNumber;
+}, z.core.$strip>>;
+declare const TierUpgraded: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  previousTier: z.ZodNullable<z.ZodString>;
+  newTier: z.ZodNullable<z.ZodString>;
+  lifetimePoints: z.ZodNumber;
+}, z.core.$strip>>;
+declare const TierDowngraded: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  previousTier: z.ZodNullable<z.ZodString>;
+  newTier: z.ZodNullable<z.ZodString>;
+  lifetimePoints: z.ZodNumber;
+}, z.core.$strip>>;
+declare const TierGraceStarted: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  previousTier: z.ZodNullable<z.ZodString>;
+  newTier: z.ZodNullable<z.ZodString>;
+  lifetimePoints: z.ZodNumber;
+}, z.core.$strip>>;
+declare const TierOverrideCleared: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  tier: z.ZodString;
+  reason: z.ZodOptional<z.ZodString>;
+  expiredAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const TierOverrideExpired: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  tier: z.ZodString;
+  reason: z.ZodOptional<z.ZodString>;
+  expiredAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+declare const RedemptionReserved: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  redemptionId: z.ZodString;
+  points: z.ZodNumber;
+  discountAmount: z.ZodNumber;
+  ownerType: z.ZodString;
+  ownerId: z.ZodString;
+}, z.core.$strip>>;
+declare const RedemptionConfirmed: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  redemptionId: z.ZodString;
+  points: z.ZodNumber;
+  discountAmount: z.ZodNumber;
+  ownerType: z.ZodString;
+  ownerId: z.ZodString;
+}, z.core.$strip>>;
+declare const RedemptionReleased: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  redemptionId: z.ZodString;
+  points: z.ZodNumber;
+  discountAmount: z.ZodNumber;
+  ownerType: z.ZodString;
+  ownerId: z.ZodString;
+}, z.core.$strip>>;
+declare const RedemptionReversed: LoyaltyEventDefinition<z.ZodObject<{
+  memberId: z.ZodString;
+  externalId: z.ZodString;
+  redemptionId: z.ZodString;
+  pointsCredited: z.ZodNumber;
+  originalPoints: z.ZodNumber;
+  proportional: z.ZodBoolean;
+  reason: z.ZodOptional<z.ZodString>;
+  transactionId: z.ZodString;
+}, z.core.$strip>>;
+declare const CampaignAwarded: LoyaltyEventDefinition<z.ZodObject<{
+  campaignId: z.ZodString;
+  memberCount: z.ZodNumber;
+  awarded: z.ZodNumber;
+  skipped: z.ZodNumber;
+  totalPoints: z.ZodNumber;
+}, z.core.$strip>>;
+declare const ReferralRecorded: LoyaltyEventDefinition<z.ZodObject<{
+  referralId: z.ZodString;
+  referrerId: z.ZodString;
+  refereeId: z.ZodString;
+  referralCode: z.ZodString;
+  status: z.ZodString;
+  referrerRewardPoints: z.ZodOptional<z.ZodNumber>;
+  refereeRewardPoints: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+declare const ReferralApproved: LoyaltyEventDefinition<z.ZodObject<{
+  referralId: z.ZodString;
+  referrerId: z.ZodString;
+  refereeId: z.ZodString;
+  referralCode: z.ZodString;
+  status: z.ZodString;
+  referrerRewardPoints: z.ZodOptional<z.ZodNumber>;
+  refereeRewardPoints: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+declare const ReferralRejected: LoyaltyEventDefinition<z.ZodObject<{
+  referralId: z.ZodString;
+  referrerId: z.ZodString;
+  refereeId: z.ZodString;
+  referralCode: z.ZodString;
+  status: z.ZodString;
+  referrerRewardPoints: z.ZodOptional<z.ZodNumber>;
+  refereeRewardPoints: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+declare const ReferralRewarded: LoyaltyEventDefinition<z.ZodObject<{
+  referralId: z.ZodString;
+  referrerId: z.ZodString;
+  refereeId: z.ZodString;
+  referralCode: z.ZodString;
+  status: z.ZodString;
+  referrerRewardPoints: z.ZodOptional<z.ZodNumber>;
+  refereeRewardPoints: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+declare const MultiTierReferralAwarded: LoyaltyEventDefinition<z.ZodObject<{
+  referralId: z.ZodString;
+  refereeId: z.ZodString;
+  awards: z.ZodArray<z.ZodObject<{
+    memberId: z.ZodString;
+    depth: z.ZodNumber;
+    points: z.ZodNumber;
+    transactionId: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>>;
+/**
+ * Every loyalty event defined in the package — pass to Arc's
+ * `EventRegistry`. Hosts wire ONE array; the whole `loyalty.*` namespace
+ * becomes introspectable via OpenAPI and auto-validated at publish time
+ * when `eventPlugin({ validateMode: 'reject' })` is set.
+ */
+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";
+};
+type LoyaltyEventName = (typeof LoyaltyEvents)[keyof typeof LoyaltyEvents];
+interface MemberLifecyclePayload {
+  memberId: string;
+  externalId: string;
+  externalType: string;
+  status: string;
+}
+interface PointsEarnedPayload {
+  memberId: string;
+  externalId: string;
+  externalType: string;
+  points: number;
+  balanceAfter: number;
+  transactionId: string;
+  earningRuleName?: string;
+  referenceType?: string;
+  referenceId?: string;
+}
+interface PointsAdjustedPayload {
+  memberId: string;
+  externalId: string;
+  points: number;
+  balanceAfter: number;
+  transactionId: string;
+  description: string;
+}
+interface PointsExpiredPayload {
+  membersAffected: number;
+  pointsExpired: number;
+  transactionCount: number;
+}
+interface TierChangedPayload {
+  memberId: string;
+  externalId: string;
+  previousTier: string | null;
+  newTier: string | null;
+  lifetimePoints: number;
+}
+interface RedemptionPayload {
+  memberId: string;
+  externalId: string;
+  redemptionId: string;
+  points: number;
+  discountAmount: number;
+  ownerType: string;
+  ownerId: string;
+}
+interface ReferralPayload {
+  referralId: string;
+  referrerId: string;
+  refereeId: string;
+  referralCode: string;
+  status: string;
+  referrerRewardPoints?: number;
+  refereeRewardPoints?: number;
+}
+interface TierOverrideLifecyclePayload {
+  memberId: string;
+  externalId: string;
+  tier: string;
+  reason?: string;
+  /** ISO string — Dates can't be JSON-schema'd. Present only on TTL-sweep path. */
+  expiredAt?: string;
+}
+interface RedemptionReversedPayload {
+  memberId: string;
+  externalId: string;
+  redemptionId: string;
+  /** Points credited back to the member by the reversal. */
+  pointsCredited: number;
+  /** Original confirmed points on the redemption. */
+  originalPoints: number;
+  proportional: boolean;
+  reason?: string;
+  transactionId: string;
+}
+interface CampaignAwardedPayload {
+  campaignId: string;
+  memberCount: number;
+  awarded: number;
+  skipped: number;
+  totalPoints: number;
+}
+interface MultiTierReferralAwardedPayload {
+  referralId: string;
+  refereeId: string;
+  /** Awards keyed by ancestor depth (1 = direct referrer). */
+  awards: Array<{
+    memberId: string;
+    depth: number;
+    points: number;
+    transactionId: string;
+  }>;
+}
+interface LoyaltyEventMap {
+  [LoyaltyEvents.MEMBER_ENROLLED]: MemberLifecyclePayload;
+  [LoyaltyEvents.MEMBER_DEACTIVATED]: MemberLifecyclePayload;
+  [LoyaltyEvents.MEMBER_REACTIVATED]: MemberLifecyclePayload;
+  [LoyaltyEvents.MEMBER_SUSPENDED]: MemberLifecyclePayload;
+  [LoyaltyEvents.POINTS_EARNED]: PointsEarnedPayload;
+  [LoyaltyEvents.POINTS_REDEEMED]: PointsAdjustedPayload;
+  [LoyaltyEvents.POINTS_ADJUSTED]: PointsAdjustedPayload;
+  [LoyaltyEvents.POINTS_EXPIRED]: PointsExpiredPayload;
+  [LoyaltyEvents.POINTS_EXPIRING_SOON]: PointsExpiredPayload;
+  [LoyaltyEvents.TIER_UPGRADED]: TierChangedPayload;
+  [LoyaltyEvents.TIER_DOWNGRADED]: TierChangedPayload;
+  [LoyaltyEvents.TIER_GRACE_STARTED]: TierChangedPayload;
+  [LoyaltyEvents.TIER_OVERRIDE_CLEARED]: TierOverrideLifecyclePayload;
+  [LoyaltyEvents.TIER_OVERRIDE_EXPIRED]: TierOverrideLifecyclePayload;
+  [LoyaltyEvents.REDEMPTION_RESERVED]: RedemptionPayload;
+  [LoyaltyEvents.REDEMPTION_CONFIRMED]: RedemptionPayload;
+  [LoyaltyEvents.REDEMPTION_RELEASED]: RedemptionPayload;
+  [LoyaltyEvents.REDEMPTION_REVERSED]: RedemptionReversedPayload;
+  [LoyaltyEvents.CAMPAIGN_AWARDED]: CampaignAwardedPayload;
+  [LoyaltyEvents.REFERRAL_RECORDED]: ReferralPayload;
+  [LoyaltyEvents.REFERRAL_APPROVED]: ReferralPayload;
+  [LoyaltyEvents.REFERRAL_REJECTED]: ReferralPayload;
+  [LoyaltyEvents.REFERRAL_REWARDED]: ReferralPayload;
+  [LoyaltyEvents.MULTI_TIER_REFERRAL_AWARDED]: MultiTierReferralAwardedPayload;
+}
+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$1 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 };