@classytic/loyalty 0.1.0 → 0.2.0

package/dist/index-2izQQext.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-BmqGuj38.d.mts

@@ -0,0 +1,400 @@
+import { o as LoyaltyContext } from "./index-2izQQext.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/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/helpers.d.ts
+declare function createEvent$1<T>(type: string, payload: T, ctx?: LoyaltyContext, meta?: Partial<DomainEvent['meta']>): DomainEvent<T>;
+//#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
+//#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
+export { TierUpgraded as A, PointsEarnedPayload as B, ReferralRecorded as C, TierGraceStarted as D, TierDowngraded as E, LoyaltyEventPayload as F, TierChangedPayload as G, RedemptionPayload as H, LoyaltyEvents as I, InProcessLoyaltyBus as J, TierOverrideLifecyclePayload as K, MemberLifecyclePayload as L, CampaignAwardedPayload as M, LoyaltyEventMap as N, TierOverrideCleared as O, LoyaltyEventName as P, MultiTierReferralAwardedPayload as R, ReferralApproved as S, ReferralRewarded as T, RedemptionReversedPayload as U, PointsExpiredPayload as V, ReferralPayload as W, InProcessLoyaltyBusOptions as Y, PointsRedeemed as _, LoyaltyEventDefinition as a, RedemptionReserved as b, MemberDeactivated as c, MemberSuspended as d, MultiTierReferralAwarded as f, PointsExpiringSoon as g, PointsExpired as h, CampaignAwarded as i, loyaltyEventDefinitions as j, TierOverrideExpired as k, MemberEnrolled as l, PointsEarned as m, EventHandler$1 as n, LoyaltyEventPayloadOf as o, PointsAdjusted as p, createEvent$1 as q, EventTransport$1 as r, LoyaltyEventSchema as s, DomainEvent$1 as t, MemberReactivated as u, RedemptionConfirmed as v, ReferralRejected as w, RedemptionReversed as x, RedemptionReleased as y, PointsAdjustedPayload as z };

package/dist/{index-CaH4GhSF.d.mts → index-DMK8a98J.d.mts}

@@ -4,7 +4,7 @@ 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"];
+declare const REDEMPTION_STATUSES: readonly ["reserved", "confirmed", "released", "expired", "reversed"];
 declare const EARNING_ACTIONS: readonly ["signup", "referral", "birthday", "review", "profile_complete"];
 //#endregion
 //#region src/domain/enums/index.d.ts