@classytic/loyalty 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+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.0]
+
+Structural rewrite on top of the 0.1.0 shape. The public API is now a
+smaller, sharper surface organized around seven subpath exports
+(`/domain/enums`, `/models`, `/repositories`, `/events`, `/types`,
+`/notifications`, plus the root engine factory). Legacy barrel + service
+layers were removed; hosts wire business flows directly against the
+repositories and the engine factory.
+
+### Changed
+
+- **Domain restructure.** Dropped the `src/domain/ports/` + `src/services/`
+  layer in favor of thin repositories that expose exactly the operations
+  hosts need — `earn`, `redeem`, `adjust`, `expire`, referral credit,
+  tier recomputation. No more `earning.service` / `redemption.service` /
+  `tier.service` / `referral.service` / `ledger.service` / `member.service`
+  / `member-guard` indirections; the equivalent logic lives on the
+  repositories where it's naturally atomic.
+- **Events subsystem simplified.** Removed `events/event-bus.ts` +
+  `events/event-types.ts` (both are internal indirection that the engine
+  didn't need). Event payloads are now colocated with the repository
+  that emits them.
+- **Repositories updated to mongokit 3.11 + repo-core 0.2 conventions.**
+  Every repo extends `Repository<T>` directly, uses the tenant plugin via
+  `injectTenant`, and atomic state changes go through CAS guards.
+- **Peer deps** unchanged in spirit, tightened in range:
+  - `@classytic/mongokit >= 3.11`
+  - `@classytic/primitives >= 0.1`
+  - `@classytic/repo-core >= 0.2`
+  - `mongoose >= 9.4`, `zod >= 4`
+- **DevDeps:** `@classytic/primitives` devDep moved from `file:` to `>=0.1.0`
+  (now that primitives ships on npm); all `@classytic/*` dev ranges
+  standardized on `>=`.
+
+### Removed
+
+- `src/services/*` — logic folded into repositories.
+- `src/domain/ports/*` barrels and per-port files — structural types
+  now live with the repositories they describe.
+- Event-bus indirection — repositories emit via the engine's configured
+  transport directly.
+
+### Added
+
+- Subpath export `/notifications` — notification port + built-in
+  lifecycle payloads (tier up/down, points expiring, referral credit).
+- Test restructure — 257 tests across unit + integration projects; the
+  deleted legacy suites were collapsed into focused scenario files that
+  exercise the new public API.
+
+### Peer compatibility
+
+Anyone on 0.1.0 wiring against the old `*.service.ts` modules will need
+to migrate to the repository methods. Signatures are similar — earn /
+redeem / adjust remain the nouns — but the call sites move from
+`services.earning.earnPoints(...)` to `repositories.pointTransaction.earn(...)`
+and similar. No behavior changes in the ledger semantics.
+
+## [0.1.0]
+
+Initial release. Loyalty points, tiers, earning rules, referrals, and
+redemption engine for MongoDB. Tenant-scoped, event-emitting, atomic
+point-ledger with CAS guards.

package/dist/config-DoZPGBfW.d.mts

@@ -0,0 +1,136 @@
+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";
+
+//#region src/types/config.d.ts
+type LoyaltyModelName = 'Member' | 'PointTransaction' | 'EarningRule' | 'TierDefinition' | 'Redemption' | 'Referral';
+type TenantConfig$1 = false | TenantConfig;
+interface IndexDefinition {
+  fields: Record<string, 1 | -1>;
+  options?: Record<string, unknown> | undefined;
+}
+type ModelName = 'member' | 'pointTransaction' | 'earningRule' | 'tierDefinition' | 'redemption' | 'referral';
+type PluginType = unknown;
+interface RepositoryPlugins {
+  member?: PluginType[] | undefined;
+  pointTransaction?: PluginType[] | undefined;
+  earningRule?: PluginType[] | undefined;
+  tierDefinition?: PluginType[] | undefined;
+  redemption?: PluginType[] | undefined;
+  referral?: PluginType[] | undefined;
+}
+interface LoyaltyConfig {
+  mongoose: Connection;
+  tenant?: TenantConfig$1 | undefined;
+  program?: {
+    id?: string | undefined;
+    conversionRate?: number | undefined;
+  } | undefined;
+  redemption?: {
+    minPoints?: number | undefined;
+    minOrderAmount?: number | undefined;
+    maxRedeemPercent?: number | undefined;
+    reservationTtlMinutes?: number | undefined;
+  } | undefined;
+  referral?: {
+    referrerRewardPoints?: number | undefined;
+    refereeRewardPoints?: number | undefined;
+    maxPerPeriod?: number | undefined;
+    periodDays?: number | undefined;
+    requireApproval?: boolean | undefined;
+    codeLength?: number | undefined;
+    /**
+     * Maximum ancestor depth for multi-tier referral rewards. When >= 2,
+     * the direct referrer gets `tierRates[0]` percent of
+     * `referrerRewardPoints`, the 2nd-tier ancestor gets `tierRates[1]`,
+     * etc. Depth 1 = direct referrer (matches single-hop legacy path).
+     * Default: 1 (single-hop, preserves prior behaviour).
+     */
+    maxDepth?: number | undefined;
+    /**
+     * Percent rates (0–100) per depth. `tierRates[0]` is the direct
+     * referrer's share. Omitted depths fall back to 0. Example:
+     * `{ maxDepth: 3, tierRates: [100, 50, 25] }` — direct gets 100%,
+     * grand-referrer 50%, great-grand 25%.
+     */
+    tierRates?: number[] | undefined;
+  } | undefined;
+  expiry?: {
+    enabled?: boolean | undefined;
+    defaultDays?: number | undefined;
+  } | undefined;
+  indexes?: Partial<Record<ModelName, IndexDefinition[]>> | undefined;
+  autoIndex?: boolean | Partial<Record<LoyaltyModelName, boolean>> | undefined;
+  /**
+   * Optional prefix prepended to every physical collection this package
+   * creates (see PACKAGE_RULES.md §20.1). Unset → default names
+   * (`loyalty_members`, `loyalty_point_transactions`, `loyalty_earning_rules`,
+   * `loyalty_tier_definitions`, `loyalty_redemptions`, `loyalty_referrals`).
+   * Model names and `ref:` populate are unaffected.
+   */
+  collectionPrefix?: string | undefined;
+  /**
+   * When true, existing Mongoose models with loyalty's names are deleted
+   * from the connection before re-registering. Hot-reload / test fixtures
+   * only. Default `false` — collision throws `LoyaltyModelCollisionError`.
+   * Hosts that need two loyalty engines should use two Mongoose connections
+   * (`mongoose.createConnection(...)`). See PACKAGE_RULES.md §21.
+   */
+  forceRecreate?: boolean | undefined;
+  /**
+   * Arc-compatible event transport. When omitted, the engine uses
+   * `InProcessLoyaltyBus` — a ~60-line structural match of arc's
+   * `MemoryEventTransport`. See PACKAGE_RULES §13.
+   */
+  eventTransport?: EventTransport | undefined;
+  /**
+   * Host-owned outbox store (PACKAGE_RULES §5.5 + P8). When present, every
+   * domain event is persisted via `outbox.save(event, { session })` **before**
+   * `eventTransport.publish(event)`. `session` is threaded from `ctx.session`
+   * so the outbox row commits atomically with the business write.
+   *
+   * Loyalty does NOT ship a store. Hosts wire arc's `repositoryAsOutboxStore(mongokitRepo)`
+   * over their own `event_outbox` collection, arc's `MemoryOutboxStore`, or any
+   * custom Postgres / Redis / Kafka implementation of the contract. When
+   * omitted, events flow through `eventTransport` only (no durable log).
+   */
+  outbox?: OutboxStore | undefined;
+  notifications?: NotificationAdapter | undefined;
+  plugins?: RepositoryPlugins | undefined;
+}
+interface ResolvedTenant {
+  enabled: boolean;
+  tenantField: string;
+  ref?: string;
+  fieldType: TenantFieldType;
+  contextKey: string;
+}
+interface ResolvedConfig {
+  programId: string;
+  conversionRate: number;
+  redemption: {
+    minPoints: number;
+    minOrderAmount: number;
+    maxRedeemPercent: number;
+    reservationTtlMinutes: number;
+  };
+  referral: {
+    referrerRewardPoints: number;
+    refereeRewardPoints: number;
+    maxPerPeriod: number;
+    periodDays: number;
+    requireApproval: boolean;
+    codeLength: number;
+    maxDepth: number;
+    tierRates: number[];
+  };
+  expiry: {
+    enabled: boolean;
+    defaultDays?: number;
+  };
+  tenant: ResolvedTenant;
+}
+//#endregion
+export { PluginType as a, ResolvedTenant as c, ModelName as i, TenantConfig$1 as l, LoyaltyConfig as n, RepositoryPlugins as o, LoyaltyModelName as r, ResolvedConfig as s, IndexDefinition as t };

package/dist/{constants-C75GvizO.mjs → constants-DkQYkOK1.mjs}

@@ -1,6 +1,6 @@
 //#region src/constants.ts
 const DEFAULT_TENANT_FIELD = "organizationId";
-const DEFAULT_TENANT_TYPE = "ObjectId";
+const DEFAULT_TENANT_TYPE = "objectId";
 const DEFAULT_PROGRAM_ID = "default";
 const TRANSACTION_TYPES = Object.freeze([
 	"earn",
@@ -36,7 +36,8 @@ const REDEMPTION_STATUSES = Object.freeze([
 	"reserved",
 	"confirmed",
 	"released",
-	"expired"
+	"expired",
+	"reversed"
 ]);
 const EARNING_ACTIONS = Object.freeze([
 	"signup",

package/dist/domain/enums/index.d.mts

@@ -1,2 +1,2 @@
-import { a as RuleStatus, c as EARNING_ACTIONS, d as REFERRAL_STATUSES, f as RULE_STATUSES, i as ReferralStatus, l as MEMBER_STATUSES, m as TRANSACTION_TYPES, n as MemberStatus, o as RuleType, p as RULE_TYPES, r as RedemptionStatus, s as TransactionType, t as EarningAction, u as REDEMPTION_STATUSES } from "../../index-CaH4GhSF.mjs";
+import { a as RuleStatus, c as EARNING_ACTIONS, d as REFERRAL_STATUSES, f as RULE_STATUSES, i as ReferralStatus, l as MEMBER_STATUSES, m as TRANSACTION_TYPES, n as MemberStatus, o as RuleType, p as RULE_TYPES, r as RedemptionStatus, s as TransactionType, t as EarningAction, u as REDEMPTION_STATUSES } from "../../index-DMK8a98J.mjs";
 export { EARNING_ACTIONS, EarningAction, MEMBER_STATUSES, MemberStatus, REDEMPTION_STATUSES, REFERRAL_STATUSES, RULE_STATUSES, RULE_TYPES, RedemptionStatus, ReferralStatus, RuleStatus, RuleType, TRANSACTION_TYPES, TransactionType };

package/dist/domain/enums/index.mjs

@@ -1,2 +1,2 @@
-import { a as MEMBER_STATUSES, c as RULE_STATUSES, i as EARNING_ACTIONS, l as RULE_TYPES, o as REDEMPTION_STATUSES, s as REFERRAL_STATUSES, u as TRANSACTION_TYPES } from "../../constants-C75GvizO.mjs";
+import { a as MEMBER_STATUSES, c as RULE_STATUSES, i as EARNING_ACTIONS, l as RULE_TYPES, o as REDEMPTION_STATUSES, s as REFERRAL_STATUSES, u as TRANSACTION_TYPES } from "../../constants-DkQYkOK1.mjs";
 export { EARNING_ACTIONS, MEMBER_STATUSES, REDEMPTION_STATUSES, REFERRAL_STATUSES, RULE_STATUSES, RULE_TYPES, TRANSACTION_TYPES };

package/dist/events/index.d.mts

@@ -1,2 +1,2 @@
-import { a as PointsEarnedPayload, c as TierChangedPayload, i as PointsAdjustedPayload, l as InProcessEventBus, n as LoyaltyEvents, o as RedemptionPayload, r as MemberLifecyclePayload, s as ReferralPayload, t as LoyaltyEvent } from "../index-O7TL4R2P.mjs";
-export { InProcessEventBus, LoyaltyEvent, LoyaltyEvents, MemberLifecyclePayload, PointsAdjustedPayload, PointsEarnedPayload, RedemptionPayload, ReferralPayload, TierChangedPayload };
+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";
+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 { t as InProcessEventBus } from "../events-CprEWlN7.mjs";
-import { t as LoyaltyEvents } from "../event-types-xQBtYBbX.mjs";
-export { InProcessEventBus, LoyaltyEvents };
+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-BtZOdiPw.mjs

@@ -0,0 +1,311 @@
+import { t as LoyaltyEvents } from "./loyalty-events-Cyt9TwX6.mjs";
+import { createEvent, matchEventPattern } from "@classytic/primitives/events";
+import { z } from "zod";
+//#region src/events/in-process-bus.ts
+var InProcessLoyaltyBus = class {
+	name = "in-process-loyalty";
+	handlers = /* @__PURE__ */ new Map();
+	logger;
+	constructor(options) {
+		this.logger = options?.logger ?? console;
+	}
+	async publish(event) {
+		const matched = /* @__PURE__ */ new Set();
+		for (const [pattern, set] of this.handlers.entries()) if (matchEventPattern(pattern, event.type)) for (const h of set) matched.add(h);
+		for (const handler of matched) try {
+			await handler(event);
+		} catch (err) {
+			this.logger.error(`[InProcessLoyaltyBus] Handler error for ${event.type}:`, err);
+		}
+	}
+	async subscribe(pattern, handler) {
+		if (!this.handlers.has(pattern)) this.handlers.set(pattern, /* @__PURE__ */ new Set());
+		this.handlers.get(pattern)?.add(handler);
+		return () => {
+			const set = this.handlers.get(pattern);
+			if (!set) return;
+			set.delete(handler);
+			if (set.size === 0) this.handlers.delete(pattern);
+		};
+	}
+	async close() {
+		this.handlers.clear();
+	}
+};
+//#endregion
+//#region src/events/loyalty-event-catalog.ts
+function defineLoyaltyEvent(input) {
+	const { name, version = 1, description, zodSchema } = input;
+	const def = {
+		name,
+		version,
+		schema: z.toJSONSchema(zodSchema),
+		zodSchema,
+		create(payload, meta) {
+			return createEvent(name, payload, {
+				source: "loyalty",
+				...meta
+			});
+		}
+	};
+	if (description !== void 0) def.description = description;
+	return def;
+}
+/** Mirrors `MemberLifecyclePayload`. */
+const memberLifecycleSchema = z.object({
+	memberId: z.string(),
+	externalId: z.string(),
+	externalType: z.string(),
+	status: z.string()
+});
+/** Mirrors `PointsEarnedPayload`. */
+const pointsEarnedSchema = z.object({
+	memberId: z.string(),
+	externalId: z.string(),
+	externalType: z.string(),
+	points: z.number(),
+	balanceAfter: z.number(),
+	transactionId: z.string(),
+	earningRuleName: z.string().optional(),
+	referenceType: z.string().optional(),
+	referenceId: z.string().optional()
+});
+/** Mirrors `PointsAdjustedPayload` — reused by REDEEMED + ADJUSTED. */
+const pointsAdjustedSchema = z.object({
+	memberId: z.string(),
+	externalId: z.string(),
+	points: z.number(),
+	balanceAfter: z.number(),
+	transactionId: z.string(),
+	description: z.string()
+});
+/** Mirrors `PointsExpiredPayload` — reused by EXPIRED + EXPIRING_SOON. */
+const pointsExpiredSchema = z.object({
+	membersAffected: z.number().int().nonnegative(),
+	pointsExpired: z.number().int().nonnegative(),
+	transactionCount: z.number().int().nonnegative()
+});
+/** Mirrors `TierChangedPayload` — reused by UPGRADED + DOWNGRADED + GRACE_STARTED. */
+const tierChangedSchema = z.object({
+	memberId: z.string(),
+	externalId: z.string(),
+	previousTier: z.string().nullable(),
+	newTier: z.string().nullable(),
+	lifetimePoints: z.number()
+});
+/** Mirrors `RedemptionPayload` — reused by RESERVED + CONFIRMED + RELEASED. */
+const redemptionSchema = z.object({
+	memberId: z.string(),
+	externalId: z.string(),
+	redemptionId: z.string(),
+	points: z.number(),
+	discountAmount: z.number(),
+	ownerType: z.string(),
+	ownerId: z.string()
+});
+/** Mirrors `ReferralPayload` — reused across the referral lifecycle. */
+const referralSchema = z.object({
+	referralId: z.string(),
+	referrerId: z.string(),
+	refereeId: z.string(),
+	referralCode: z.string(),
+	status: z.string(),
+	referrerRewardPoints: z.number().optional(),
+	refereeRewardPoints: z.number().optional()
+});
+/**
+* Mirrors `TierOverrideLifecyclePayload`. `expiredAt` is serialised as ISO
+* string at transport time (Dates aren't JSON-Schema representable —
+* see zod/v4's `Date cannot be represented in JSON Schema` rule).
+*/
+const tierOverrideLifecycleSchema = z.object({
+	memberId: z.string(),
+	externalId: z.string(),
+	tier: z.string(),
+	reason: z.string().optional(),
+	expiredAt: z.string().optional()
+});
+/** Mirrors `RedemptionReversedPayload`. */
+const redemptionReversedSchema = z.object({
+	memberId: z.string(),
+	externalId: z.string(),
+	redemptionId: z.string(),
+	pointsCredited: z.number(),
+	originalPoints: z.number(),
+	proportional: z.boolean(),
+	reason: z.string().optional(),
+	transactionId: z.string()
+});
+/** Mirrors `CampaignAwardedPayload`. */
+const campaignAwardedSchema = z.object({
+	campaignId: z.string(),
+	memberCount: z.number().int().nonnegative(),
+	awarded: z.number().int().nonnegative(),
+	skipped: z.number().int().nonnegative(),
+	totalPoints: z.number().int().nonnegative()
+});
+/** Mirrors `MultiTierReferralAwardedPayload`. */
+const multiTierReferralAwardedSchema = z.object({
+	referralId: z.string(),
+	refereeId: z.string(),
+	awards: z.array(z.object({
+		memberId: z.string(),
+		depth: z.number().int().positive(),
+		points: z.number().int().nonnegative(),
+		transactionId: z.string()
+	}))
+});
+const MemberEnrolled = defineLoyaltyEvent({
+	name: LoyaltyEvents.MEMBER_ENROLLED,
+	description: "A new loyalty member was enrolled in a program.",
+	zodSchema: memberLifecycleSchema
+});
+const MemberDeactivated = defineLoyaltyEvent({
+	name: LoyaltyEvents.MEMBER_DEACTIVATED,
+	description: "A loyalty member was deactivated.",
+	zodSchema: memberLifecycleSchema
+});
+const MemberReactivated = defineLoyaltyEvent({
+	name: LoyaltyEvents.MEMBER_REACTIVATED,
+	description: "A deactivated loyalty member was reactivated.",
+	zodSchema: memberLifecycleSchema
+});
+const MemberSuspended = defineLoyaltyEvent({
+	name: LoyaltyEvents.MEMBER_SUSPENDED,
+	description: "A loyalty member was suspended.",
+	zodSchema: memberLifecycleSchema
+});
+const PointsEarned = defineLoyaltyEvent({
+	name: LoyaltyEvents.POINTS_EARNED,
+	description: "Points were earned by a member through an earning rule.",
+	zodSchema: pointsEarnedSchema
+});
+const PointsRedeemed = defineLoyaltyEvent({
+	name: LoyaltyEvents.POINTS_REDEEMED,
+	description: "Points were redeemed against a discount / reward.",
+	zodSchema: pointsAdjustedSchema
+});
+const PointsAdjusted = defineLoyaltyEvent({
+	name: LoyaltyEvents.POINTS_ADJUSTED,
+	description: "Points were manually adjusted (admin correction / override).",
+	zodSchema: pointsAdjustedSchema
+});
+const PointsExpired = defineLoyaltyEvent({
+	name: LoyaltyEvents.POINTS_EXPIRED,
+	description: "A batch of points expired across one or more members.",
+	zodSchema: pointsExpiredSchema
+});
+const PointsExpiringSoon = defineLoyaltyEvent({
+	name: LoyaltyEvents.POINTS_EXPIRING_SOON,
+	description: "Points are approaching their expiry window — host can notify members.",
+	zodSchema: pointsExpiredSchema
+});
+const TierUpgraded = defineLoyaltyEvent({
+	name: LoyaltyEvents.TIER_UPGRADED,
+	description: "A member qualified for a higher tier.",
+	zodSchema: tierChangedSchema
+});
+const TierDowngraded = defineLoyaltyEvent({
+	name: LoyaltyEvents.TIER_DOWNGRADED,
+	description: "A member dropped to a lower tier after grace expiry.",
+	zodSchema: tierChangedSchema
+});
+const TierGraceStarted = defineLoyaltyEvent({
+	name: LoyaltyEvents.TIER_GRACE_STARTED,
+	description: "A tier grace period was started on a member before potential downgrade.",
+	zodSchema: tierChangedSchema
+});
+const TierOverrideCleared = defineLoyaltyEvent({
+	name: LoyaltyEvents.TIER_OVERRIDE_CLEARED,
+	description: "A manual tier override was explicitly cleared (admin action).",
+	zodSchema: tierOverrideLifecycleSchema
+});
+const TierOverrideExpired = defineLoyaltyEvent({
+	name: LoyaltyEvents.TIER_OVERRIDE_EXPIRED,
+	description: "A tier override with a TTL expired and was swept by cron.",
+	zodSchema: tierOverrideLifecycleSchema
+});
+const RedemptionReserved = defineLoyaltyEvent({
+	name: LoyaltyEvents.REDEMPTION_RESERVED,
+	description: "Points were reserved against a pending redemption.",
+	zodSchema: redemptionSchema
+});
+const RedemptionConfirmed = defineLoyaltyEvent({
+	name: LoyaltyEvents.REDEMPTION_CONFIRMED,
+	description: "A reserved redemption was confirmed — points debited from balance.",
+	zodSchema: redemptionSchema
+});
+const RedemptionReleased = defineLoyaltyEvent({
+	name: LoyaltyEvents.REDEMPTION_RELEASED,
+	description: "A reserved redemption was released — points returned to balance.",
+	zodSchema: redemptionSchema
+});
+const RedemptionReversed = defineLoyaltyEvent({
+	name: LoyaltyEvents.REDEMPTION_REVERSED,
+	description: "A confirmed redemption was reversed — points (fully or partially) credited back.",
+	zodSchema: redemptionReversedSchema
+});
+const CampaignAwarded = defineLoyaltyEvent({
+	name: LoyaltyEvents.CAMPAIGN_AWARDED,
+	description: "A bulk-earn campaign awarded points to a batch of members.",
+	zodSchema: campaignAwardedSchema
+});
+const ReferralRecorded = defineLoyaltyEvent({
+	name: LoyaltyEvents.REFERRAL_RECORDED,
+	description: "A referral was recorded (pending approval when required).",
+	zodSchema: referralSchema
+});
+const ReferralApproved = defineLoyaltyEvent({
+	name: LoyaltyEvents.REFERRAL_APPROVED,
+	description: "A pending referral was approved.",
+	zodSchema: referralSchema
+});
+const ReferralRejected = defineLoyaltyEvent({
+	name: LoyaltyEvents.REFERRAL_REJECTED,
+	description: "A pending referral was rejected.",
+	zodSchema: referralSchema
+});
+const ReferralRewarded = defineLoyaltyEvent({
+	name: LoyaltyEvents.REFERRAL_REWARDED,
+	description: "Referrer and / or referee rewards were awarded for an approved referral.",
+	zodSchema: referralSchema
+});
+const MultiTierReferralAwarded = defineLoyaltyEvent({
+	name: LoyaltyEvents.MULTI_TIER_REFERRAL_AWARDED,
+	description: "Ancestor referrers were awarded points via a multi-tier referral chain.",
+	zodSchema: multiTierReferralAwardedSchema
+});
+/**
+* Every loyalty event defined in the package — pass to Arc's
+* `EventRegistry`. Hosts wire ONE array; the whole `loyalty.*` namespace
+* becomes introspectable via OpenAPI and auto-validated at publish time
+* when `eventPlugin({ validateMode: 'reject' })` is set.
+*/
+const loyaltyEventDefinitions = [
+	MemberEnrolled,
+	MemberDeactivated,
+	MemberReactivated,
+	MemberSuspended,
+	PointsEarned,
+	PointsRedeemed,
+	PointsAdjusted,
+	PointsExpired,
+	PointsExpiringSoon,
+	TierUpgraded,
+	TierDowngraded,
+	TierGraceStarted,
+	TierOverrideCleared,
+	TierOverrideExpired,
+	RedemptionReserved,
+	RedemptionConfirmed,
+	RedemptionReleased,
+	RedemptionReversed,
+	CampaignAwarded,
+	ReferralRecorded,
+	ReferralApproved,
+	ReferralRejected,
+	ReferralRewarded,
+	MultiTierReferralAwarded
+];
+//#endregion
+export { TierOverrideExpired as C, InProcessLoyaltyBus as E, TierOverrideCleared as S, loyaltyEventDefinitions as T, ReferralRecorded as _, MemberSuspended as a, TierDowngraded as b, PointsEarned as c, PointsRedeemed as d, RedemptionConfirmed as f, ReferralApproved as g, RedemptionReversed as h, MemberReactivated as i, PointsExpired as l, RedemptionReserved as m, MemberDeactivated as n, MultiTierReferralAwarded as o, RedemptionReleased as p, MemberEnrolled as r, PointsAdjusted as s, CampaignAwarded as t, PointsExpiringSoon as u, ReferralRejected as v, TierUpgraded as w, TierGraceStarted as x, ReferralRewarded as y };