@classytic/loyalty 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -3,6 +3,39 @@
 Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 adhering to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.3] — 2026-05-08
+
+### Fixed
+
+- **§P8 dispatch — `outbox.save` failures now propagate.** [src/events/dispatch.ts](src/events/dispatch.ts)
+  previously caught `outbox.save` errors and swallowed them silently. Per
+  PACKAGE_RULES §P8 the outbox row is the durability anchor for the
+  transactional-outbox pattern: if the save fails, the caller's transaction
+  MUST roll back so the business doc and the event row land atomically.
+  Swallowing the failure meant a parent doc could commit while the event
+  vanished, with no relay row to recover from. Fix re-throws after logging.
+  `events.publish` failures continue to be swallowed (correctly, per §P8 —
+  the host's outbox relay re-publishes from the durable row), but now log
+  before swallowing so failures are observable.
+- **`DispatchDeps.logger` field added.** Optional. Both arms of the
+  dispatch helper log through it when set, surfacing failures in the host's
+  observability stack without coupling the package to a specific logger.
+
+### Changed
+
+- **Peer-dep ranges tightened** — `@classytic/mongokit` `>=3.13.3`
+  (was `>=3.13.0`) and `@classytic/repo-core` `>=0.4.2` (was `>=0.4.0`).
+  3.13.3 preserves `errorLabels` on `MongoServerError` so concurrent
+  transactional writes (the `claim()`-based redemption + tier-eval paths)
+  retry correctly under contention; 0.4.2 adds the typed `FindAllOptions`
+  shape with `limit?` for callers that need a bounded non-paginated read.
+
+### Internal
+
+- Replaced 4 `arr.find()!` non-null assertions in [src/index.ts](src/index.ts)
+  + scenario tests with explicit narrowing — TS now proves what the runtime
+  shape already guaranteed.
+
 ## [0.2.0]
 
 Structural rewrite on top of the 0.1.0 shape. The public API is now a

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-DoZPGBfW.d.mts → config-96Sl6oNJ.d.mts}

@@ -2,7 +2,7 @@ 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 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-C4jFHS7m.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-DArT4zkB.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/{index-ClPKmtxh.d.mts → index-Cl-WGBFJ.d.mts}

@@ -1,12 +1,13 @@
 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-BOWqBSWx.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-DWarXsmw.mjs";
 import { t as NotificationAdapter } from "./notification.port-CJ9nXj0k.mjs";
-import { c as ResolvedTenant, o as RepositoryPlugins, s as ResolvedConfig } from "./config-DoZPGBfW.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";
 import { PluginType, Repository } from "@classytic/mongokit";
 import { OutboxStore } from "@classytic/primitives/outbox";
+import { ApprovalChain } from "@classytic/primitives/approval";
 
 //#region src/domain/ports/unit-of-work.port.d.ts
 interface UnitOfWork {
@@ -134,7 +135,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: {
@@ -187,6 +193,18 @@ interface Redemption {
    */
   initialBalance?: number;
   remainingBalance?: number;
+  /**
+   * Optional multi-step approval chain (P7 canonical — same shape as
+   * `@classytic/purchase` / `@classytic/order`). High-value redemptions
+   * (gift cards above threshold, large discount vouchers) gate on
+   * `isApproved(approvals)` before `confirm()` flips the FSM. Single-tier
+   * flows skip the chain entirely.
+   */
+  approvals?: ApprovalChain | null;
+  /** Snapshot of the matrix policy id that produced this chain (host-managed). */
+  approvalPolicyId?: string | null;
+  /** Version of the matrix policy at submit time — frozen for audit. */
+  approvalPolicyVersion?: number | null;
   createdAt: Date;
   updatedAt: Date;
 }

package/dist/{index-C4jFHS7m.d.mts → index-DArT4zkB.d.mts}

@@ -1,4 +1,4 @@
-import { o as LoyaltyContext } from "./index-BOWqBSWx.mjs";
+import { o as LoyaltyContext } from "./index-DWarXsmw.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";
 

package/dist/{index-BOWqBSWx.d.mts → index-DWarXsmw.d.mts}

@@ -1,5 +1,6 @@
 import { a as RuleStatus, n as MemberStatus, o as RuleType, s as TransactionType } from "./index-DMK8a98J.mjs";
 import { OperationContext } from "@classytic/primitives/context";
+import { ApprovalChain } from "@classytic/primitives/approval";
 
 //#region src/domain/entities/earning-rule.d.ts
 interface EarningConditions {
@@ -124,6 +125,19 @@ interface PointTransaction {
   expiredAt?: Date;
   metadata?: Record<string, unknown>;
   actorId: string;
+  /**
+   * Optional multi-step approval chain (P7 canonical — same shape as
+   * `@classytic/purchase` / `@classytic/order`). Manual `adjustment` /
+   * `bonus` transactions above a host-defined threshold gate on
+   * `isApproved(approvals)` before the journal entry is committed.
+   * Automatic transactions (earn from purchase, expiry sweeps) skip the
+   * chain entirely — single-tier flows leave this null.
+   */
+  approvals?: ApprovalChain | null;
+  /** Snapshot of the matrix policy id that produced this chain (host-managed). */
+  approvalPolicyId?: string | null;
+  /** Version of the matrix policy at submit time — frozen for audit. */
+  approvalPolicyVersion?: number | null;
   createdAt: Date;
 }
 //#endregion
@@ -245,6 +259,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.d.mts

@@ -1,9 +1,9 @@
-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-BOWqBSWx.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-DWarXsmw.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-DoZPGBfW.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-C4jFHS7m.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-DArT4zkB.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-ClPKmtxh.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-Cl-WGBFJ.mjs";
 import { DomainEvent, EventHandler, EventTransport, EventTransport as EventTransport$1 } from "@classytic/primitives/events";
 
 //#region src/index.d.ts

package/dist/index.mjs

@@ -1,7 +1,7 @@
 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-DBSxe9st.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-BMwidCp-.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 createModels } from "./models-0_OQIqBy.mjs";
 import { n as createEvent, t as LoyaltyEvents } from "./loyalty-events-Cyt9TwX6.mjs";
 //#region src/index.ts
 function resolveConfig(config) {
@@ -62,11 +62,13 @@ var MongoUnitOfWork = class {
 	async withTransaction(cb) {
 		const session = await this.connection.startSession();
 		try {
-			let result;
+			const slot = { assigned: false };
 			await session.withTransaction(async () => {
-				result = await cb(session);
+				slot.value = await cb(session);
+				slot.assigned = true;
 			});
-			return result;
+			if (!slot.assigned) throw new Error("withTransaction: callback did not assign a result");
+			return slot.value;
 		} finally {
 			await session.endSession();
 		}

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-DoZPGBfW.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";
 
@@ -243,6 +243,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     earningRuleId?: _$mongoose.Types.ObjectId | null | undefined;
     expiresAt?: NativeDate | null | undefined;
     expiredAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     createdAt: NativeDate;
   }, {}, {}, {
     id: string;
@@ -261,6 +264,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     earningRuleId?: _$mongoose.Types.ObjectId | null | undefined;
     expiresAt?: NativeDate | null | undefined;
     expiredAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     createdAt: NativeDate;
   }, {
     id: string;
@@ -284,6 +290,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     earningRuleId?: _$mongoose.Types.ObjectId | null | undefined;
     expiresAt?: NativeDate | null | undefined;
     expiredAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     createdAt: NativeDate;
   } & {
     _id: _$mongoose.Types.ObjectId;
@@ -311,6 +320,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     earningRuleId?: _$mongoose.Types.ObjectId | null | undefined;
     expiresAt?: NativeDate | null | undefined;
     expiredAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     createdAt: NativeDate;
   }, _$mongoose.Document<unknown, {}, {
     programId: string;
@@ -327,6 +339,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     earningRuleId?: _$mongoose.Types.ObjectId | null | undefined;
     expiresAt?: NativeDate | null | undefined;
     expiredAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     createdAt: NativeDate;
   }, {
     id: string;
@@ -350,6 +365,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     earningRuleId?: _$mongoose.Types.ObjectId | null | undefined;
     expiresAt?: NativeDate | null | undefined;
     expiredAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     createdAt: NativeDate;
   } & {
     _id: _$mongoose.Types.ObjectId;
@@ -372,6 +390,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     earningRuleId?: _$mongoose.Types.ObjectId | null | undefined;
     expiresAt?: NativeDate | null | undefined;
     expiredAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     createdAt: NativeDate;
   } & {
     _id: _$mongoose.Types.ObjectId;
@@ -392,6 +413,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     earningRuleId?: _$mongoose.Types.ObjectId | null | undefined;
     expiresAt?: NativeDate | null | undefined;
     expiredAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     createdAt: NativeDate;
   } & {
     _id: _$mongoose.Types.ObjectId;
@@ -883,6 +907,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     ownerType: string;
     ownerId: string;
     expiresAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     confirmedAt?: NativeDate | null | undefined;
     releasedAt?: NativeDate | null | undefined;
     reversedAt?: NativeDate | null | undefined;
@@ -904,6 +931,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     ownerType: string;
     ownerId: string;
     expiresAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     confirmedAt?: NativeDate | null | undefined;
     releasedAt?: NativeDate | null | undefined;
     reversedAt?: NativeDate | null | undefined;
@@ -927,6 +957,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     ownerType: string;
     ownerId: string;
     expiresAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     confirmedAt?: NativeDate | null | undefined;
     releasedAt?: NativeDate | null | undefined;
     reversedAt?: NativeDate | null | undefined;
@@ -954,6 +987,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     ownerType: string;
     ownerId: string;
     expiresAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     confirmedAt?: NativeDate | null | undefined;
     releasedAt?: NativeDate | null | undefined;
     reversedAt?: NativeDate | null | undefined;
@@ -973,6 +1009,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     ownerType: string;
     ownerId: string;
     expiresAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     confirmedAt?: NativeDate | null | undefined;
     releasedAt?: NativeDate | null | undefined;
     reversedAt?: NativeDate | null | undefined;
@@ -996,6 +1035,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     ownerType: string;
     ownerId: string;
     expiresAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     confirmedAt?: NativeDate | null | undefined;
     releasedAt?: NativeDate | null | undefined;
     reversedAt?: NativeDate | null | undefined;
@@ -1021,6 +1063,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     ownerType: string;
     ownerId: string;
     expiresAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     confirmedAt?: NativeDate | null | undefined;
     releasedAt?: NativeDate | null | undefined;
     reversedAt?: NativeDate | null | undefined;
@@ -1046,6 +1091,9 @@ declare function createModels(connection: Connection, tenant: ResolvedTenant, in
     ownerType: string;
     ownerId: string;
     expiresAt?: NativeDate | null | undefined;
+    approvals?: any;
+    approvalPolicyId?: string | null | undefined;
+    approvalPolicyVersion?: number | null | undefined;
     confirmedAt?: NativeDate | null | undefined;
     releasedAt?: NativeDate | null | undefined;
     reversedAt?: NativeDate | null | undefined;

package/dist/models/index.mjs

@@ -1,2 +1,2 @@
-import { n as createModels, t as LoyaltyModelCollisionError } from "../models-uhh9c-7k.mjs";
+import { n as createModels, t as LoyaltyModelCollisionError } from "../models-0_OQIqBy.mjs";
 export { LoyaltyModelCollisionError, createModels };

package/dist/{models-uhh9c-7k.mjs → models-0_OQIqBy.mjs}

@@ -232,6 +232,18 @@ function createPointTransactionSchema() {
 		actorId: {
 			type: String,
 			required: true
+		},
+		approvals: {
+			type: mongoose.Schema.Types.Mixed,
+			default: null
+		},
+		approvalPolicyId: {
+			type: String,
+			default: null
+		},
+		approvalPolicyVersion: {
+			type: Number,
+			default: null
 		}
 	}, { timestamps: {
 		createdAt: true,
@@ -297,7 +309,19 @@ function createRedemptionSchema() {
 		reversalTransactionId: { type: mongoose.Schema.Types.ObjectId },
 		transactionId: { type: mongoose.Schema.Types.ObjectId },
 		initialBalance: { type: Number },
-		remainingBalance: { type: Number }
+		remainingBalance: { type: Number },
+		approvals: {
+			type: mongoose.Schema.Types.Mixed,
+			default: null
+		},
+		approvalPolicyId: {
+			type: String,
+			default: null
+		},
+		approvalPolicyVersion: {
+			type: Number,
+			default: null
+		}
 	}, { timestamps: true });
 	schema.index({
 		ownerType: 1,

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-ClPKmtxh.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-Cl-WGBFJ.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-DBSxe9st.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-BMwidCp-.mjs";
 export { EarningRuleRepository, MemberRepository, PointTransactionRepository, RedemptionRepository, ReferralRepository, TierDefinitionRepository, createRepositories };

package/dist/{repositories-DBSxe9st.mjs → repositories-BMwidCp-.mjs}

@@ -193,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) {
@@ -346,10 +354,15 @@ 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) {}
+	} catch (err) {
+		deps.logger?.error(`[loyalty] outbox.save failed for ${event.type}:`, err);
+		throw err;
+	}
 	if (deps.events) try {
 		await deps.events.publish(event);
-	} catch (_err) {}
+	} catch (err) {
+		deps.logger?.error(`[loyalty] events.publish failed for ${event.type}:`, 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-BOWqBSWx.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-DoZPGBfW.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-DWarXsmw.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.1",
+  "version": "0.2.3",
   "description": "Loyalty points, tiers, earning rules, referrals, and redemption engine for MongoDB",
   "author": "Classytic",
   "homepage": "https://www.npmjs.com/package/@classytic/loyalty",
@@ -78,18 +78,18 @@
     "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.3",
+    "@classytic/primitives": ">=0.5.0",
+    "@classytic/repo-core": ">=0.4.2",
     "mongoose": ">=9.4.1",
     "zod": ">=4.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.9",
     "@classytic/dev-tools": "^0.2.0",
-    "@classytic/mongokit": ">=3.11.0",
-    "@classytic/primitives": ">=0.1.0",
-    "@classytic/repo-core": ">=0.2.0",
+    "@classytic/mongokit": "^3.13.3",
+    "@classytic/primitives": ">=0.5.0",
+    "@classytic/repo-core": "^0.4.2",
     "@types/node": "^25.5.0",
     "@vitest/coverage-v8": "^3.2.4",
     "knip": "^6.3.0",