@classytic/loyalty 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -3,6 +3,52 @@
 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.7.0
+
+### Fixed — a `UnitOfWork` yielding a non-transactional session ran the body anyway
+
+`runLoyaltyUnit` asserted `inTransaction()` on the HOST-session branch and not on
+the `unitOfWork.withTransaction` branch, so only one of the two ways a body gets
+a session was guarded. The comment above that check already stated the rule —
+"guard before the body runs, not at the first emit: a verb can mutate before it
+dispatches" — and it was applied to one branch.
+
+It matters because the balance verbs compensate by THROWING to roll an `$inc`
+back. Without a real transaction that buys nothing: `redeem` decrements a
+member's points, sees the balance go negative, throws — and the points stay
+gone while the caller is told the redemption failed. A lying `withTransaction`
+was previously caught at the first event DISPATCH, by which time the write had
+landed.
+
+3 cases in `tests/unit/unit-of-work-transaction-guard.test.ts`, asserting the
+body did NOT run — the rejection alone would pass even if it had mutated first.
+Falsified: removing the guard fails 2 of 3.
+
+### Fixed — the transaction guard must not override `allowNonTransactional`
+
+The fix above asserted `inTransaction()` unconditionally, which also made it
+wrong: `allowNonTransactional` is an explicit host opt-in (loyalty already
+warns about it at boot) for a standalone-Mongo deployment where
+`withTransaction({ allowFallback })` runs the callback with no transaction ON
+PURPOSE. The guard turned that documented degradation into a hard failure, so
+a standalone-Mongo host lost point earn / redemption / reversal entirely — a
+general rule silently defeating a specific decision, the inverse of what the
+guard exists to catch.
+
+`UnitOfWork` now states whether it may degrade, and the consent travels on the
+internal context because the same guard also runs from `dispatchLoyaltyEvent`,
+which never sees the unit of work. Absent still means no: an implementation
+that yields a bare session without saying so is still refused, and a
+host-supplied `ctx.session` has no opt-in and always asserts. Falsified both
+ways in `unit-of-work-transaction-guard.test.ts`.
+
+### Changed — peer floors raised to current
+
+- `@classytic/mongokit` `>=3.33.0` → **`>=3.38.1`**
+- `@classytic/primitives` `>=0.23.0` → **`>=0.27.0`**
+- `@classytic/repo-core` `>=0.24.0` → **`>=0.27.1`**
+- `@classytic/validation` `>=0.2.0` → **`>=0.5.0`**
+
 ## [0.6.0] — 2026-08-17
 
 ### Added

package/dist/{index-CR2k7jQ8.d.mts → index-BIPHUsfR.d.mts}

@@ -2,7 +2,7 @@ import { i as ReferralStatus, r as RedemptionStatus } from "./index-D_Oe3aDk.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-Cp_sXNpG.mjs";
 import { t as NotificationAdapter } from "./notification.port-wY4IKimz.mjs";
 import { c as ResolvedConfig, s as RepositoryPlugins } from "./config-CtkGj3xZ.mjs";
-import { n as LoyaltyModels } from "./index-D6GvuvmF.mjs";
+import { n as LoyaltyModels } from "./index-BIhVuwIZ.mjs";
 import { PluginType, Repository } from "@classytic/mongokit";
 import { ResolvedTenantConfig } from "@classytic/repo-core/tenant";
 import { ClientSession, Model } from "mongoose";
@@ -12,6 +12,17 @@ import { ApprovalChain } from "@classytic/primitives/approval";
 //#region src/domain/ports/unit-of-work.port.d.ts
 interface UnitOfWork {
   withTransaction<T>(callback: (session: ClientSession) => Promise<T>): Promise<T>;
+  /**
+   * This unit of work MAY hand the callback a session with no live transaction.
+   *
+   * True only where the host opted into `allowNonTransactional` — a standalone
+   * mongod accepts the degradation knowingly, and loyalty logs it at boot. The
+   * guard that otherwise refuses a transaction-less session reads this, so an
+   * accepted degradation is not re-refused one layer down. Absent means NO:
+   * an implementation that yields a bare session without saying so is a defect,
+   * and stays one.
+   */
+  readonly allowsNonTransactional?: boolean;
 }
 //#endregion
 //#region src/repositories/member.repository.d.ts

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

@@ -11,6 +11,7 @@ declare function createEarningRuleSchema(): mongoose.Schema<any, mongoose.Model<
   name: string;
   status: "active" | "paused" | "expired";
   priority: number;
+  metadata?: any;
   description?: string | null;
   conditions?: {
     categories: string[];
@@ -34,13 +35,13 @@ declare function createEarningRuleSchema(): mongoose.Schema<any, mongoose.Model<
   } | null;
   startsAt?: NativeDate | null;
   endsAt?: NativeDate | null;
-  metadata?: any;
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
   programId: string;
   type: "order" | "action" | "category" | "tier_bonus";
   name: string;
   status: "active" | "paused" | "expired";
   priority: number;
+  metadata?: any;
   description?: string | null;
   conditions?: {
     categories: string[];
@@ -64,7 +65,6 @@ declare function createEarningRuleSchema(): mongoose.Schema<any, mongoose.Model<
   } | null;
   startsAt?: NativeDate | null;
   endsAt?: NativeDate | null;
-  metadata?: any;
 } & mongoose.DefaultTimestampProps, {
   id: string;
 }, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
@@ -75,6 +75,7 @@ declare function createEarningRuleSchema(): mongoose.Schema<any, mongoose.Model<
   name: string;
   status: "active" | "paused" | "expired";
   priority: number;
+  metadata?: any;
   description?: string | null;
   conditions?: {
     categories: string[];
@@ -98,7 +99,6 @@ declare function createEarningRuleSchema(): mongoose.Schema<any, mongoose.Model<
   } | null;
   startsAt?: NativeDate | null;
   endsAt?: NativeDate | null;
-  metadata?: any;
 } & mongoose.DefaultTimestampProps & {
   _id: mongoose.Types.ObjectId;
 } & {
@@ -111,6 +111,7 @@ declare function createEarningRuleSchema(): mongoose.Schema<any, mongoose.Model<
   name: string;
   status: "active" | "paused" | "expired";
   priority: number;
+  metadata?: any;
   description?: string | null;
   conditions?: {
     categories: string[];
@@ -134,7 +135,6 @@ declare function createEarningRuleSchema(): mongoose.Schema<any, mongoose.Model<
   } | null;
   startsAt?: NativeDate | null;
   endsAt?: NativeDate | null;
-  metadata?: any;
   createdAt: NativeDate;
   updatedAt: NativeDate;
 } & {
@@ -153,8 +153,8 @@ declare function createMemberSchema(): mongoose.Schema<any, mongoose.Model<any,
   externalType: string;
   enrolledAt: NativeDate;
   metadata?: any;
-  cardId?: string | null;
   referralCode?: string | null;
+  cardId?: string | null;
   tier?: string | null;
   tierOverride?: string | null;
   tierOverrideReason?: string | null;
@@ -176,8 +176,8 @@ declare function createMemberSchema(): mongoose.Schema<any, mongoose.Model<any,
   externalType: string;
   enrolledAt: NativeDate;
   metadata?: any;
-  cardId?: string | null;
   referralCode?: string | null;
+  cardId?: string | null;
   tier?: string | null;
   tierOverride?: string | null;
   tierOverrideReason?: string | null;
@@ -203,8 +203,8 @@ declare function createMemberSchema(): mongoose.Schema<any, mongoose.Model<any,
   externalType: string;
   enrolledAt: NativeDate;
   metadata?: any;
-  cardId?: string | null;
   referralCode?: string | null;
+  cardId?: string | null;
   tier?: string | null;
   tierOverride?: string | null;
   tierOverrideReason?: string | null;
@@ -232,8 +232,8 @@ declare function createMemberSchema(): mongoose.Schema<any, mongoose.Model<any,
   externalType: string;
   enrolledAt: NativeDate;
   metadata?: any;
-  cardId?: string | null;
   referralCode?: string | null;
+  cardId?: string | null;
   tier?: string | null;
   tierOverride?: string | null;
   tierOverrideReason?: string | null;
@@ -271,15 +271,15 @@ declare function createPointTransactionSchema(): mongoose.Schema<any, mongoose.M
   balanceAfter: number;
   actorId: string;
   metadata?: any;
-  expiresAt?: NativeDate | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
   referenceType?: string | null;
   referenceId?: string | null;
   idempotencyKey?: string | null;
   earningRuleId?: mongoose.Types.ObjectId | null;
+  expiresAt?: NativeDate | null;
   expiredAt?: NativeDate | null;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   createdAt: NativeDate;
 }, mongoose.Document<unknown, {}, {
   programId: string;
@@ -290,15 +290,15 @@ declare function createPointTransactionSchema(): mongoose.Schema<any, mongoose.M
   balanceAfter: number;
   actorId: string;
   metadata?: any;
-  expiresAt?: NativeDate | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
   referenceType?: string | null;
   referenceId?: string | null;
   idempotencyKey?: string | null;
   earningRuleId?: mongoose.Types.ObjectId | null;
+  expiresAt?: NativeDate | null;
   expiredAt?: NativeDate | null;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   createdAt: NativeDate;
 }, {
   id: string;
@@ -316,15 +316,15 @@ declare function createPointTransactionSchema(): mongoose.Schema<any, mongoose.M
   balanceAfter: number;
   actorId: string;
   metadata?: any;
-  expiresAt?: NativeDate | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
   referenceType?: string | null;
   referenceId?: string | null;
   idempotencyKey?: string | null;
   earningRuleId?: mongoose.Types.ObjectId | null;
+  expiresAt?: NativeDate | null;
   expiredAt?: NativeDate | null;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   createdAt: NativeDate;
 } & {
   _id: mongoose.Types.ObjectId;
@@ -341,15 +341,15 @@ declare function createPointTransactionSchema(): mongoose.Schema<any, mongoose.M
   balanceAfter: number;
   actorId: string;
   metadata?: any;
-  expiresAt?: NativeDate | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
   referenceType?: string | null;
   referenceId?: string | null;
   idempotencyKey?: string | null;
   earningRuleId?: mongoose.Types.ObjectId | null;
+  expiresAt?: NativeDate | null;
   expiredAt?: NativeDate | null;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   createdAt: NativeDate;
 } & {
   _id: mongoose.Types.ObjectId;
@@ -371,6 +371,9 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
   ownerType: string;
   ownerId: string;
   expiresAt?: NativeDate | null;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   confirmedAt?: NativeDate | null;
   releasedAt?: NativeDate | null;
   reversedAt?: NativeDate | null;
@@ -379,9 +382,6 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
   transactionId?: mongoose.Types.ObjectId | null;
   initialBalance?: number | null;
   remainingBalance?: number | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
   programId: string;
   status: "expired" | "reserved" | "confirmed" | "released" | "reversed";
@@ -393,6 +393,9 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
   ownerType: string;
   ownerId: string;
   expiresAt?: NativeDate | null;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   confirmedAt?: NativeDate | null;
   releasedAt?: NativeDate | null;
   reversedAt?: NativeDate | null;
@@ -401,9 +404,6 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
   transactionId?: mongoose.Types.ObjectId | null;
   initialBalance?: number | null;
   remainingBalance?: number | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
 } & mongoose.DefaultTimestampProps, {
   id: string;
 }, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
@@ -419,6 +419,9 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
   ownerType: string;
   ownerId: string;
   expiresAt?: NativeDate | null;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   confirmedAt?: NativeDate | null;
   releasedAt?: NativeDate | null;
   reversedAt?: NativeDate | null;
@@ -427,9 +430,6 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
   transactionId?: mongoose.Types.ObjectId | null;
   initialBalance?: number | null;
   remainingBalance?: number | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
 } & mongoose.DefaultTimestampProps & {
   _id: mongoose.Types.ObjectId;
 } & {
@@ -447,6 +447,9 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
   ownerType: string;
   ownerId: string;
   expiresAt?: NativeDate | null;
+  approvals?: any;
+  approvalPolicyId?: string | null;
+  approvalPolicyVersion?: number | null;
   confirmedAt?: NativeDate | null;
   releasedAt?: NativeDate | null;
   reversedAt?: NativeDate | null;
@@ -455,9 +458,6 @@ declare function createRedemptionSchema(): mongoose.Schema<any, mongoose.Model<a
   transactionId?: mongoose.Types.ObjectId | null;
   initialBalance?: number | null;
   remainingBalance?: number | null;
-  approvals?: any;
-  approvalPolicyId?: string | null;
-  approvalPolicyVersion?: number | null;
   createdAt: NativeDate;
   updatedAt: NativeDate;
 } & {
@@ -472,9 +472,9 @@ declare function createReferralSchema(): mongoose.Schema<any, mongoose.Model<any
 }, {
   programId: string;
   status: "expired" | "pending" | "approved" | "rejected";
-  referralCode: string;
   referrerId: mongoose.Types.ObjectId;
   refereeId: mongoose.Types.ObjectId;
+  referralCode: string;
   metadata?: any;
   expiresAt?: NativeDate | null;
   referrerRewardPoints?: number | null;
@@ -487,9 +487,9 @@ declare function createReferralSchema(): mongoose.Schema<any, mongoose.Model<any
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
   programId: string;
   status: "expired" | "pending" | "approved" | "rejected";
-  referralCode: string;
   referrerId: mongoose.Types.ObjectId;
   refereeId: mongoose.Types.ObjectId;
+  referralCode: string;
   metadata?: any;
   expiresAt?: NativeDate | null;
   referrerRewardPoints?: number | null;
@@ -506,9 +506,9 @@ declare function createReferralSchema(): mongoose.Schema<any, mongoose.Model<any
 }> & Omit<{
   programId: string;
   status: "expired" | "pending" | "approved" | "rejected";
-  referralCode: string;
   referrerId: mongoose.Types.ObjectId;
   refereeId: mongoose.Types.ObjectId;
+  referralCode: string;
   metadata?: any;
   expiresAt?: NativeDate | null;
   referrerRewardPoints?: number | null;
@@ -527,9 +527,9 @@ declare function createReferralSchema(): mongoose.Schema<any, mongoose.Model<any
 }>, unknown, {
   programId: string;
   status: "expired" | "pending" | "approved" | "rejected";
-  referralCode: string;
   referrerId: mongoose.Types.ObjectId;
   refereeId: mongoose.Types.ObjectId;
+  referralCode: string;
   metadata?: any;
   expiresAt?: NativeDate | null;
   referrerRewardPoints?: number | null;
@@ -554,7 +554,6 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
   programId: string;
   name: string;
   rank: number;
-  metadata?: any;
   qualificationCriteria?: {
     minLifetimePoints?: number | null;
     minLifetimeSpend?: number | null;
@@ -571,11 +570,11 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
     gracePeriodDays: number;
   } | null;
   color?: string | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, {
   programId: string;
   name: string;
   rank: number;
-  metadata?: any;
   qualificationCriteria?: {
     minLifetimePoints?: number | null;
     minLifetimeSpend?: number | null;
@@ -592,6 +591,7 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
     gracePeriodDays: number;
   } | null;
   color?: string | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps, {
   id: string;
 }, Omit<mongoose.DefaultSchemaOptions, "timestamps"> & {
@@ -600,7 +600,6 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
   programId: string;
   name: string;
   rank: number;
-  metadata?: any;
   qualificationCriteria?: {
     minLifetimePoints?: number | null;
     minLifetimeSpend?: number | null;
@@ -617,6 +616,7 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
     gracePeriodDays: number;
   } | null;
   color?: string | null;
+  metadata?: any;
 } & mongoose.DefaultTimestampProps & {
   _id: mongoose.Types.ObjectId;
 } & {
@@ -627,7 +627,6 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
   programId: string;
   name: string;
   rank: number;
-  metadata?: any;
   qualificationCriteria?: {
     minLifetimePoints?: number | null;
     minLifetimeSpend?: number | null;
@@ -644,6 +643,7 @@ declare function createTierDefinitionSchema(): mongoose.Schema<any, mongoose.Mod
     gracePeriodDays: number;
   } | null;
   color?: string | null;
+  metadata?: any;
   createdAt: NativeDate;
   updatedAt: NativeDate;
 } & {

package/dist/index.d.mts

@@ -2,8 +2,8 @@ import { S as EarningRule, a as EnrollInput, b as MemberBalance, c as UpdateTier
 import { t as NotificationAdapter } from "./notification.port-wY4IKimz.mjs";
 import { c as ResolvedConfig, i as LoyaltyShape, l as ResolvedTenant, n as LoyaltyModelName, r as LoyaltyRuntime } from "./config-CtkGj3xZ.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-YUFamhDk.mjs";
-import { n as LoyaltyModels, r as defineLoyaltyModels, t as DefineLoyaltyModelsConfig } from "./index-D6GvuvmF.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-CR2k7jQ8.mjs";
+import { n as LoyaltyModels, r as defineLoyaltyModels, t as DefineLoyaltyModelsConfig } from "./index-BIhVuwIZ.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-BIPHUsfR.mjs";
 import { Connection } from "mongoose";
 import { DomainEvent, DomainEvent as DomainEvent$1, EventHandler, EventTransport, EventTransport as EventTransport$1 } from "@classytic/primitives/events";
 import { OutboxStore } from "@classytic/primitives/outbox";

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import "./constants-DOPBh6kt.mjs";
-import { C as SessionNotInTransactionError, D as ValidationError, E as UnmanagedSessionError, S as SelfReferralError, T as TierNotFoundError, _ as RedemptionExpiredError, a as PointTransactionRepository, b as ReferralNotFoundError, c as flushPendingLoyaltyEvents, d as DuplicateReferralError, f as InsufficientPointsError, g as MemberNotFoundError, h as MemberInactiveError, i as RedemptionRepository, l as EarningRuleRepository, m as MemberAlreadyEnrolledError, n as TierDefinitionRepository, o as MemberRepository, p as LoyaltyCapabilityError, r as ReferralRepository, s as PENDING_EVENTS, t as createRepositories, u as CircularReferralError, v as RedemptionNotFoundError, w as TenantIsolationError, x as RuleNotFoundError, y as ReferralLimitExceededError } from "./repositories-B676z4bE.mjs";
+import { C as SessionNotInTransactionError, D as ValidationError, E as UnmanagedSessionError, S as SelfReferralError, T as TierNotFoundError, _ as RedemptionExpiredError, a as PointTransactionRepository, b as ReferralNotFoundError, c as flushPendingLoyaltyEvents, d as DuplicateReferralError, f as InsufficientPointsError, g as MemberNotFoundError, h as MemberInactiveError, i as RedemptionRepository, l as EarningRuleRepository, m as MemberAlreadyEnrolledError, n as TierDefinitionRepository, o as MemberRepository, p as LoyaltyCapabilityError, r as ReferralRepository, s as PENDING_EVENTS, t as createRepositories, u as CircularReferralError, v as RedemptionNotFoundError, w as TenantIsolationError, x as RuleNotFoundError, y as ReferralLimitExceededError } from "./repositories-DErtHQou.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-BLjg3uLA.mjs";
 import { t as defineLoyaltyModels } from "./models-weWqS5Bc.mjs";
 import { n as createEvent, t as LoyaltyEvents } from "./loyalty-events-DXirolM_.mjs";
@@ -49,6 +49,10 @@ var MongoUnitOfWork = class {
 		this.connection = connection;
 		this.allowFallback = allowFallback;
 	}
+	/** The fallback IS the transaction-less path — say so, don't make callers infer it. */
+	get allowsNonTransactional() {
+		return this.allowFallback;
+	}
 	async withTransaction(cb) {
 		return withTransaction(this.connection, cb, this.allowFallback ? { allowFallback: true } : {});
 	}

package/dist/models/index.d.mts

@@ -1,3 +1,3 @@
 import { n as LoyaltyModelName } from "../config-CtkGj3xZ.mjs";
-import { n as LoyaltyModels, r as defineLoyaltyModels, t as DefineLoyaltyModelsConfig } from "../index-D6GvuvmF.mjs";
+import { n as LoyaltyModels, r as defineLoyaltyModels, t as DefineLoyaltyModelsConfig } from "../index-BIhVuwIZ.mjs";
 export { DefineLoyaltyModelsConfig, type LoyaltyModelName, LoyaltyModels, defineLoyaltyModels };

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-CR2k7jQ8.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-BIPHUsfR.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, l as EarningRuleRepository, n as TierDefinitionRepository, o as MemberRepository, r as ReferralRepository, t as createRepositories } from "../repositories-B676z4bE.mjs";
+import { a as PointTransactionRepository, i as RedemptionRepository, l as EarningRuleRepository, n as TierDefinitionRepository, o as MemberRepository, r as ReferralRepository, t as createRepositories } from "../repositories-DErtHQou.mjs";
 export { EarningRuleRepository, MemberRepository, PointTransactionRepository, RedemptionRepository, ReferralRepository, TierDefinitionRepository, createRepositories };

package/dist/{repositories-B676z4bE.mjs → repositories-DErtHQou.mjs}

@@ -485,6 +485,16 @@ var EarningRuleRepository = class extends Repository {
 */
 const PENDING_EVENTS = Symbol.for("@classytic/loyalty:pendingEvents");
 /**
+* Set when the unit of work was PERMITTED to run without a transaction
+* (`allowNonTransactional`), so the session-in-transaction guard knows the
+* degradation was chosen rather than stumbled into.
+*
+* Carried on the context because the guard also runs from
+* `dispatchLoyaltyEvent`, which never sees the unit of work. Internal and
+* `Symbol.for`, so no host can set it by accident or on purpose.
+*/
+const NON_TRANSACTIONAL_CONSENTED = Symbol.for("@classytic/loyalty:nonTransactionalConsented");
+/**
 * A caller-supplied `ctx.session` is only evidence of a unit of work if it
 * has an ACTIVE transaction. A bare `startSession()` commits every write
 * independently, so treating it as atomic is how a balance `$inc` lands with
@@ -497,6 +507,7 @@ const PENDING_EVENTS = Symbol.for("@classytic/loyalty:pendingEvents");
 */
 function assertSessionInTransaction(ctx) {
 	if (!ctx.session) return;
+	if (ctx[NON_TRANSACTIONAL_CONSENTED]) return;
 	const session = ctx.session;
 	if (typeof session.inTransaction !== "function" || !session.inTransaction()) throw new SessionNotInTransactionError();
 }
@@ -549,11 +560,14 @@ async function runLoyaltyUnit(unitOfWork, deps, ctx, body) {
 	const pending = [];
 	const result = await unitOfWork.withTransaction(async (session) => {
 		pending.length = 0;
-		return body({
+		const innerCtx = {
 			...internalCtx,
 			session,
-			[PENDING_EVENTS]: pending
-		});
+			[PENDING_EVENTS]: pending,
+			...unitOfWork.allowsNonTransactional ? { [NON_TRANSACTIONAL_CONSENTED]: true } : {}
+		};
+		assertSessionInTransaction(innerCtx);
+		return body(innerCtx);
 	});
 	await flushPendingLoyaltyEvents(deps.events, pending, deps.logger);
 	return result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/loyalty",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Loyalty points, tiers, earning rules, referrals, and redemption engine for MongoDB",
   "author": "Classytic",
   "homepage": "https://www.npmjs.com/package/@classytic/loyalty",
@@ -78,20 +78,20 @@
     "release": "npm run push -- main && npm run release:tag && npm publish"
   },
   "peerDependencies": {
-    "@classytic/mongokit": ">=3.33.0",
-    "@classytic/primitives": ">=0.23.0",
-    "@classytic/repo-core": ">=0.24.0",
-    "@classytic/validation": ">=0.2.0",
+    "@classytic/mongokit": ">=3.38.1",
+    "@classytic/primitives": ">=0.27.0",
+    "@classytic/repo-core": ">=0.27.1",
+    "@classytic/validation": ">=0.5.0",
     "mongoose": ">=9.4.1",
     "zod": ">=4.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.9",
     "@classytic/dev-tools": "^0.2.0",
-    "@classytic/mongokit": "^3.33.0",
-    "@classytic/primitives": ">=0.23.0",
-    "@classytic/repo-core": ">=0.24.0",
-    "@classytic/validation": ">=0.4.0",
+    "@classytic/mongokit": "^3.38.1",
+    "@classytic/primitives": ">=0.27.0",
+    "@classytic/repo-core": ">=0.27.1",
+    "@classytic/validation": ">=0.5.0",
     "@types/node": "^25.5.0",
     "@vitest/coverage-v8": "^3.2.4",
     "knip": "^6.3.0",