@classytic/loyalty 0.2.0 → 0.2.2

package/README.md

@@ -139,6 +139,13 @@ import type {
 } from '@classytic/loyalty';
 ```
 
+## Migration Notes
+
+Earning rates now live in earning rules, not host membership config fields such
+as `PlatformConfig.membership.pointsPerAmount` or `amountPerPoint`. See
+[docs/config-engine-migration.md](docs/config-engine-migration.md) for the
+`LoyaltyConfig` to engine boundary and migration checklist.
+
 ## Events
 
 ```typescript

package/dist/{config-JYTMP1F7.d.mts → config-96Sl6oNJ.d.mts}

@@ -1,8 +1,8 @@
-import { t as NotificationAdapter } from "./notification.port-9B5xlzxQ.mjs";
+import { t as NotificationAdapter } from "./notification.port-CJ9nXj0k.mjs";
 import { EventTransport } from "@classytic/primitives/events";
 import { Connection } from "mongoose";
 import { OutboxStore } from "@classytic/primitives/outbox";
-import { TenantConfig, TenantFieldType } from "@classytic/primitives/tenant";
+import { TenantConfig, TenantFieldType } from "@classytic/repo-core/tenant";
 
 //#region src/types/config.d.ts
 type LoyaltyModelName = 'Member' | 'PointTransaction' | 'EarningRule' | 'TierDefinition' | 'Redemption' | 'Referral';

package/dist/events/index.d.mts

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

package/dist/events/index.mjs

@@ -1,3 +1,3 @@
-import { C as TierOverrideExpired, E as InProcessLoyaltyBus, S as TierOverrideCleared, T as loyaltyEventDefinitions, _ as ReferralRecorded, a as MemberSuspended, b as TierDowngraded, c as PointsEarned, d as PointsRedeemed, f as RedemptionConfirmed, g as ReferralApproved, h as RedemptionReversed, i as MemberReactivated, l as PointsExpired, m as RedemptionReserved, n as MemberDeactivated, o as MultiTierReferralAwarded, p as RedemptionReleased, r as MemberEnrolled, s as PointsAdjusted, t as CampaignAwarded, u as PointsExpiringSoon, v as ReferralRejected, w as TierUpgraded, x as TierGraceStarted, y as ReferralRewarded } from "../events-BjzHSLBn.mjs";
+import { C as TierOverrideExpired, E as InProcessLoyaltyBus, S as TierOverrideCleared, T as loyaltyEventDefinitions, _ as ReferralRecorded, a as MemberSuspended, b as TierDowngraded, c as PointsEarned, d as PointsRedeemed, f as RedemptionConfirmed, g as ReferralApproved, h as RedemptionReversed, i as MemberReactivated, l as PointsExpired, m as RedemptionReserved, n as MemberDeactivated, o as MultiTierReferralAwarded, p as RedemptionReleased, r as MemberEnrolled, s as PointsAdjusted, t as CampaignAwarded, u as PointsExpiringSoon, v as ReferralRejected, w as TierUpgraded, x as TierGraceStarted, y as ReferralRewarded } from "../events-BtZOdiPw.mjs";
 import { n as createEvent, t as LoyaltyEvents } from "../loyalty-events-Cyt9TwX6.mjs";
 export { CampaignAwarded, InProcessLoyaltyBus, LoyaltyEvents, MemberDeactivated, MemberEnrolled, MemberReactivated, MemberSuspended, MultiTierReferralAwarded, PointsAdjusted, PointsEarned, PointsExpired, PointsExpiringSoon, PointsRedeemed, RedemptionConfirmed, RedemptionReleased, RedemptionReserved, RedemptionReversed, ReferralApproved, ReferralRecorded, ReferralRejected, ReferralRewarded, TierDowngraded, TierGraceStarted, TierOverrideCleared, TierOverrideExpired, TierUpgraded, createEvent, loyaltyEventDefinitions };

package/dist/{events-BjzHSLBn.mjs → events-BtZOdiPw.mjs}

@@ -34,39 +34,6 @@ var InProcessLoyaltyBus = class {
 };
 //#endregion
 //#region src/events/loyalty-event-catalog.ts
-/**
-* Loyalty event catalog — Zod-source-of-truth definitions for every
-* `loyalty.*` event.
-*
-* Each definition exposes:
-*   - `.zodSchema`   — source of truth, used by host code's `.safeParse()`
-*   - `.schema`      — JSON Schema derived via `z.toJSONSchema()`, consumed
-*                     by Arc's EventRegistry + OpenAPI plugin
-*   - `.create(...)` — DomainEvent envelope builder, structurally compatible
-*                     with `@classytic/arc`'s `EventDefinitionOutput`
-*
-* Structurally compatible with Arc 2.10's `EventRegistry` — hosts register
-* `loyaltyEventDefinitions` directly, no adapter code. Loyalty does NOT
-* import from `@classytic/arc` (PACKAGE_RULES §11); compatibility is
-* purely structural.
-*
-* Payload schemas mirror the typed interfaces in
-* [loyalty-events.ts](./loyalty-events.ts). See PACKAGE_RULES §18.5 for
-* the pattern.
-*
-* @example Wiring into an Arc app
-* ```ts
-* import { createEventRegistry } from '@classytic/arc/events';
-* import { loyaltyEventDefinitions } from '@classytic/loyalty/events';
-*
-* const registry = createEventRegistry();
-* for (const def of loyaltyEventDefinitions) registry.register(def);
-*
-* const app = await createApp({
-*   arcPlugins: { events: { registry, validateMode: 'reject' } },
-* });
-* ```
-*/
 function defineLoyaltyEvent(input) {
 	const { name, version = 1, description, zodSchema } = input;
 	const def = {

package/dist/{index-2izQQext.d.mts → index-Bo5YQ_fu.d.mts}

@@ -245,6 +245,14 @@ interface CreateEarningRuleInput {
   reward: EarningReward;
   startsAt?: Date | string;
   endsAt?: Date | string;
+  /**
+   * Loyalty program this rule belongs to.
+   *
+   * Optional for repository-created rules: `EarningRuleRepository.create(...)`
+   * and `createMany(...)` fill this from `LoyaltyConfig.program.id`, matching
+   * the default used by `MemberRepository.enroll(...)`. Pass explicitly only
+   * when creating a rule for a different program.
+   */
   programId?: string;
   metadata?: Record<string, unknown>;
 }

package/dist/{index-qI1WvtNg.d.mts → index-CMSNfGos.d.mts}

@@ -1,7 +1,7 @@
 import { i as ReferralStatus, r as RedemptionStatus } from "./index-DMK8a98J.mjs";
-import { S as EarningRule, _ as TierEvaluationBatch, d as EarningResult, f as ExpirationResult, g as TierEvaluation, h as RedemptionValidation, o as LoyaltyContext, v as PointTransaction, x as TierDefinition, y as Member } from "./index-2izQQext.mjs";
-import { t as NotificationAdapter } from "./notification.port-9B5xlzxQ.mjs";
-import { c as ResolvedTenant, o as RepositoryPlugins, s as ResolvedConfig } from "./config-JYTMP1F7.mjs";
+import { S as EarningRule, _ as TierEvaluationBatch, d as EarningResult, f as ExpirationResult, g as TierEvaluation, h as RedemptionValidation, o as LoyaltyContext, v as PointTransaction, x as TierDefinition, y as Member } from "./index-Bo5YQ_fu.mjs";
+import { t as NotificationAdapter } from "./notification.port-CJ9nXj0k.mjs";
+import { c as ResolvedTenant, o as RepositoryPlugins, s as ResolvedConfig } from "./config-96Sl6oNJ.mjs";
 import { LoyaltyModels } from "./models/index.mjs";
 import { EventTransport } from "@classytic/primitives/events";
 import { ClientSession, Model } from "mongoose";
@@ -134,7 +134,12 @@ declare class EarningRuleRepository extends Repository<EarningRule> {
   txRepo: PointTransactionRepository;
   config: ResolvedConfig;
   constructor(model: Model<EarningRule>, plugins?: PluginType[]);
-  /** Auto-inject tenant id from options into doc payload. See MemberRepository. */
+  private applyCreateDefaults;
+  /**
+   * Auto-injects `programId` from `LoyaltyConfig.program.id` and the tenant id
+   * from repo options when omitted. This keeps custom-program engines aligned
+   * with `MemberRepository.enroll(...)`, which uses the same config default.
+   */
   create(data: Parameters<Repository<EarningRule>['create']>[0], options?: Parameters<Repository<EarningRule>['create']>[1]): Promise<EarningRule>;
   createMany(docs: Parameters<Repository<EarningRule>['createMany']>[0], options?: Parameters<Repository<EarningRule>['createMany']>[1]): Promise<EarningRule[]>;
   evaluateOrder(input: {

package/dist/{index-BmqGuj38.d.mts → index-xLLJ7jLy.d.mts}

@@ -1,7 +1,10 @@
-import { o as LoyaltyContext } from "./index-2izQQext.mjs";
+import { o as LoyaltyContext } from "./index-Bo5YQ_fu.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). */
@@ -19,169 +22,6 @@ declare class InProcessLoyaltyBus implements EventTransport {
   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';
@@ -397,4 +237,164 @@ declare const MultiTierReferralAwarded: LoyaltyEventDefinition<z.ZodObject<{
  */
 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 };
+//#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 };

package/dist/index.d.mts

@@ -1,9 +1,9 @@
-import { A as TierUpgraded, B as PointsEarnedPayload, C as ReferralRecorded, D as TierGraceStarted, E as TierDowngraded, F as LoyaltyEventPayload, G as TierChangedPayload, H as RedemptionPayload, I as LoyaltyEvents, J as InProcessLoyaltyBus, L as MemberLifecyclePayload, N as LoyaltyEventMap, P as LoyaltyEventName, S as ReferralApproved, T as ReferralRewarded, V as PointsExpiredPayload, W as ReferralPayload, Y as InProcessLoyaltyBusOptions, _ as PointsRedeemed, a as LoyaltyEventDefinition, b as RedemptionReserved, c as MemberDeactivated, d as MemberSuspended, g as PointsExpiringSoon, h as PointsExpired, j as loyaltyEventDefinitions, l as MemberEnrolled, m as PointsEarned, o as LoyaltyEventPayloadOf, p as PointsAdjusted, q as createEvent, s as LoyaltyEventSchema, u as MemberReactivated, v as RedemptionConfirmed, w as ReferralRejected, y as RedemptionReleased, z as PointsAdjustedPayload } from "./index-BmqGuj38.mjs";
-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-2izQQext.mjs";
-import { t as NotificationAdapter } from "./notification.port-9B5xlzxQ.mjs";
-import { c as ResolvedTenant, n as LoyaltyConfig, r as LoyaltyModelName, s as ResolvedConfig } from "./config-JYTMP1F7.mjs";
+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-Bo5YQ_fu.mjs";
+import { t as NotificationAdapter } from "./notification.port-CJ9nXj0k.mjs";
+import { c as ResolvedTenant, n as LoyaltyConfig, r as LoyaltyModelName, s as ResolvedConfig } from "./config-96Sl6oNJ.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-xLLJ7jLy.mjs";
 import { LoyaltyModels } from "./models/index.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-qI1WvtNg.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-CMSNfGos.mjs";
 import { DomainEvent, EventHandler, EventTransport, EventTransport as EventTransport$1 } from "@classytic/primitives/events";
 
 //#region src/index.d.ts

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { n as DEFAULT_TENANT_FIELD, r as DEFAULT_TENANT_TYPE } from "./constants-DkQYkOK1.mjs";
-import { a as PointTransactionRepository, c as ValidationError, i as RedemptionRepository, n as TierDefinitionRepository, o as MemberRepository, r as ReferralRepository, s as EarningRuleRepository, t as createRepositories } from "./repositories-ObGUgcSH.mjs";
-import { E as InProcessLoyaltyBus, T as loyaltyEventDefinitions, _ as ReferralRecorded, a as MemberSuspended, b as TierDowngraded, c as PointsEarned, d as PointsRedeemed, f as RedemptionConfirmed, g as ReferralApproved, i as MemberReactivated, l as PointsExpired, m as RedemptionReserved, n as MemberDeactivated, p as RedemptionReleased, r as MemberEnrolled, s as PointsAdjusted, u as PointsExpiringSoon, v as ReferralRejected, w as TierUpgraded, x as TierGraceStarted, y as ReferralRewarded } from "./events-BjzHSLBn.mjs";
+import { a as PointTransactionRepository, c as ValidationError, i as RedemptionRepository, n as TierDefinitionRepository, o as MemberRepository, r as ReferralRepository, s as EarningRuleRepository, t as createRepositories } from "./repositories-CZlhTYVp.mjs";
+import { E as InProcessLoyaltyBus, T as loyaltyEventDefinitions, _ as ReferralRecorded, a as MemberSuspended, b as TierDowngraded, c as PointsEarned, d as PointsRedeemed, f as RedemptionConfirmed, g as ReferralApproved, i as MemberReactivated, l as PointsExpired, m as RedemptionReserved, n as MemberDeactivated, p as RedemptionReleased, r as MemberEnrolled, s as PointsAdjusted, u as PointsExpiringSoon, v as ReferralRejected, w as TierUpgraded, x as TierGraceStarted, y as ReferralRewarded } from "./events-BtZOdiPw.mjs";
 import { n as createModels } from "./models-uhh9c-7k.mjs";
 import { n as createEvent, t as LoyaltyEvents } from "./loyalty-events-Cyt9TwX6.mjs";
 //#region src/index.ts

package/dist/models/index.d.mts

@@ -1,4 +1,4 @@
-import { c as ResolvedTenant, i as ModelName, r as LoyaltyModelName, t as IndexDefinition } from "../config-JYTMP1F7.mjs";
+import { c as ResolvedTenant, i as ModelName, r as LoyaltyModelName, t as IndexDefinition } from "../config-96Sl6oNJ.mjs";
 import * as _$mongoose from "mongoose";
 import { Connection, Model } from "mongoose";
 

package/dist/notifications/index.d.mts

@@ -1,4 +1,4 @@
-import { t as NotificationAdapter } from "../notification.port-9B5xlzxQ.mjs";
+import { t as NotificationAdapter } from "../notification.port-CJ9nXj0k.mjs";
 
 //#region src/notifications/index.d.ts
 interface NotificationsAdapterConfig {

package/dist/repositories/index.d.mts

@@ -1,2 +1,2 @@
-import { a as ReferralRepository, d as MemberRepository, i as TierDefinitionRepository, l as EarningRuleRepository, n as LoyaltyRepositories, r as createRepositories, s as RedemptionRepository, t as CreateRepositoriesInput, u as PointTransactionRepository } from "../index-qI1WvtNg.mjs";
+import { a as ReferralRepository, d as MemberRepository, i as TierDefinitionRepository, l as EarningRuleRepository, n as LoyaltyRepositories, r as createRepositories, s as RedemptionRepository, t as CreateRepositoriesInput, u as PointTransactionRepository } from "../index-CMSNfGos.mjs";
 export { CreateRepositoriesInput, EarningRuleRepository, LoyaltyRepositories, MemberRepository, PointTransactionRepository, RedemptionRepository, ReferralRepository, TierDefinitionRepository, createRepositories };

package/dist/repositories/index.mjs

@@ -1,2 +1,2 @@
-import { a as PointTransactionRepository, i as RedemptionRepository, n as TierDefinitionRepository, o as MemberRepository, r as ReferralRepository, s as EarningRuleRepository, t as createRepositories } from "../repositories-ObGUgcSH.mjs";
+import { a as PointTransactionRepository, i as RedemptionRepository, n as TierDefinitionRepository, o as MemberRepository, r as ReferralRepository, s as EarningRuleRepository, t as createRepositories } from "../repositories-CZlhTYVp.mjs";
 export { EarningRuleRepository, MemberRepository, PointTransactionRepository, RedemptionRepository, ReferralRepository, TierDefinitionRepository, createRepositories };

package/dist/{repositories-ObGUgcSH.mjs → repositories-CZlhTYVp.mjs}

@@ -153,16 +153,22 @@ function tenantCtx(tenant, tenantId) {
 * Copy the tenant id from the repo options into the write payload.
 *
 * Called from repository `create` / `createMany` overrides so the document
-* persists with the correct `organizationId` even when the host has opted
-* OUT of the auto-wired `multiTenantPlugin`. When the payload already has
-* the field (e.g. arc's `BaseController.create` pre-writes it), this is a
-* no-op.
+* persists with the correct tenant id even when the host has opted OUT
+* of the auto-wired `multiTenantPlugin`. The options object is populated
+* by `tenantCtx()` which writes under `tenant.contextKey`, so the read
+* here MUST use `contextKey` — not `tenantField`. They coincide in the
+* default config (`organizationId === organizationId`) which masked the
+* mismatch; with a divergent contextKey the copy silently never fired
+* and writes landed without a tenant on the doc.
+*
+* When the payload already has the field (e.g. arc's `BaseController.create`
+* pre-writes it under `tenantField`), this is a no-op.
 */
 function injectTenantIntoData(data, options, tenant) {
 	const field = tenant.tenantField;
 	if (!field) return;
 	if (data[field] != null) return;
-	const value = options?.[field];
+	const value = options?.[tenant.contextKey] ?? options?.[field];
 	if (value != null) data[field] = value;
 }
 //#endregion
@@ -187,14 +193,22 @@ var EarningRuleRepository = class extends Repository {
 	constructor(model, plugins = []) {
 		super(model, plugins);
 	}
-	/** Auto-inject tenant id from options into doc payload. See MemberRepository. */
-	async create(data, options) {
+	applyCreateDefaults(data, options) {
+		data.programId ??= this.config.programId;
 		injectTenantIntoData(data, options, this.config.tenant);
+	}
+	/**
+	* Auto-injects `programId` from `LoyaltyConfig.program.id` and the tenant id
+	* from repo options when omitted. This keeps custom-program engines aligned
+	* with `MemberRepository.enroll(...)`, which uses the same config default.
+	*/
+	async create(data, options) {
+		this.applyCreateDefaults(data, options);
 		return super.create(data, options);
 	}
 	async createMany(docs, options) {
 		const opts = options;
-		for (const doc of docs) injectTenantIntoData(doc, opts, this.config.tenant);
+		for (const doc of docs) this.applyCreateDefaults(doc, opts);
 		return super.createMany(docs, options);
 	}
 	async evaluateOrder(input, ctx) {
@@ -340,14 +354,10 @@ async function dispatchLoyaltyEvent(deps, event, ctx) {
 		const saveOptions = {};
 		if (ctx.session !== void 0) saveOptions.session = ctx.session;
 		await deps.outbox.save(event, saveOptions);
-	} catch (err) {
-		console.error(`[loyalty] outbox.save failed for ${event.type}:`, err);
-	}
+	} catch (_err) {}
 	if (deps.events) try {
 		await deps.events.publish(event);
-	} catch (err) {
-		console.error(`[loyalty] events.publish failed for ${event.type}:`, err);
-	}
+	} catch (_err) {}
 }
 //#endregion
 //#region src/utils/code-generator.ts

package/dist/types/index.d.mts

@@ -1,3 +1,3 @@
-import { _ as TierEvaluationBatch, a as EnrollInput, c as UpdateTierInput, d as EarningResult, f as ExpirationResult, g as TierEvaluation, h as RedemptionValidation, i as EarnPointsInput, l as BalanceSummary, m as PaginatedResult, n as CreateEarningRuleInput, o as LoyaltyContext, p as ListQuery, r as CreateTierInput, s as UpdateEarningRuleInput, t as AdjustPointsInput, u as EarningBreakdown } from "../index-2izQQext.mjs";
-import { a as PluginType, c as ResolvedTenant, i as ModelName, l as TenantConfig, n as LoyaltyConfig, o as RepositoryPlugins, s as ResolvedConfig, t as IndexDefinition } from "../config-JYTMP1F7.mjs";
+import { _ as TierEvaluationBatch, a as EnrollInput, c as UpdateTierInput, d as EarningResult, f as ExpirationResult, g as TierEvaluation, h as RedemptionValidation, i as EarnPointsInput, l as BalanceSummary, m as PaginatedResult, n as CreateEarningRuleInput, o as LoyaltyContext, p as ListQuery, r as CreateTierInput, s as UpdateEarningRuleInput, t as AdjustPointsInput, u as EarningBreakdown } from "../index-Bo5YQ_fu.mjs";
+import { a as PluginType, c as ResolvedTenant, i as ModelName, l as TenantConfig, n as LoyaltyConfig, o as RepositoryPlugins, s as ResolvedConfig, t as IndexDefinition } from "../config-96Sl6oNJ.mjs";
 export { AdjustPointsInput, BalanceSummary, CreateEarningRuleInput, CreateTierInput, EarnPointsInput, EarningBreakdown, EarningResult, EnrollInput, ExpirationResult, IndexDefinition, ListQuery, LoyaltyConfig, LoyaltyContext, ModelName, PaginatedResult, PluginType, RedemptionValidation, RepositoryPlugins, ResolvedConfig, ResolvedTenant, TenantConfig, TierEvaluation, TierEvaluationBatch, UpdateEarningRuleInput, UpdateTierInput };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/loyalty",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Loyalty points, tiers, earning rules, referrals, and redemption engine for MongoDB",
   "author": "Classytic",
   "homepage": "https://www.npmjs.com/package/@classytic/loyalty",
@@ -73,20 +73,23 @@
     "format": "biome format --write src/ tests/",
     "check": "biome check --write --unsafe src/ tests/",
     "prepublishOnly": "npm run lint && npm run typecheck && npm run test && npm run build",
-    "release": "npm run build && npm run typecheck && npm publish --access public"
+    "push": "classytic-push",
+    "release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
+    "release": "npm run push -- main && npm run release:tag && npm publish"
   },
   "peerDependencies": {
-    "@classytic/mongokit": ">=3.11.0",
-    "@classytic/primitives": ">=0.1.0",
-    "@classytic/repo-core": ">=0.2.0",
+    "@classytic/mongokit": ">=3.13.0",
+    "@classytic/primitives": ">=0.5.0",
+    "@classytic/repo-core": ">=0.4.0",
     "mongoose": ">=9.4.1",
     "zod": ">=4.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.9",
-    "@classytic/mongokit": ">=3.11.0",
-    "@classytic/primitives": ">=0.1.0",
-    "@classytic/repo-core": ">=0.2.0",
+    "@classytic/dev-tools": "^0.2.0",
+    "@classytic/mongokit": ">=3.13.0",
+    "@classytic/primitives": ">=0.5.0",
+    "@classytic/repo-core": ">=0.4.0",
     "@types/node": "^25.5.0",
     "@vitest/coverage-v8": "^3.2.4",
     "knip": "^6.3.0",