@classytic/loyalty 0.1.0 → 0.2.0

package/dist/types/index.d.mts

@@ -1,3 +1,3 @@
-import { a as RepositoryPlugins, c as TenantConfig, i as PluginType, n as LoyaltyConfig, o as ResolvedConfig, r as ModelName, s as ResolvedTenant, t as IndexDefinition } from "../config-aNigy4ec.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-DqzTjeEB.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-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";
 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.1.0",
+  "version": "0.2.0",
   "description": "Loyalty points, tiers, earning rules, referrals, and redemption engine for MongoDB",
   "author": "Classytic",
   "homepage": "https://www.npmjs.com/package/@classytic/loyalty",
@@ -24,10 +24,6 @@
       "types": "./dist/index.d.mts",
       "default": "./dist/index.mjs"
     },
-    "./domain": {
-      "types": "./dist/domain/index.d.mts",
-      "default": "./dist/domain/index.mjs"
-    },
     "./domain/enums": {
       "types": "./dist/domain/enums/index.d.mts",
       "default": "./dist/domain/enums/index.mjs"
@@ -40,10 +36,6 @@
       "types": "./dist/repositories/index.d.mts",
       "default": "./dist/repositories/index.mjs"
     },
-    "./services": {
-      "types": "./dist/services/index.d.mts",
-      "default": "./dist/services/index.mjs"
-    },
     "./events": {
       "types": "./dist/events/index.d.mts",
       "default": "./dist/events/index.mjs"
@@ -68,8 +60,12 @@
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
+    "test": "vitest run --project unit --project integration",
+    "test:unit": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "test:scenarios": "vitest run --project scenarios",
+    "test:all": "vitest run",
+    "test:watch": "vitest --project unit --project integration",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
     "lint": "biome check src/ tests/",
@@ -80,20 +76,26 @@
     "release": "npm run build && npm run typecheck && npm publish --access public"
   },
   "peerDependencies": {
-    "@classytic/mongokit": ">=3.5.3",
-    "mongoose": ">=9.0.0"
+    "@classytic/mongokit": ">=3.11.0",
+    "@classytic/primitives": ">=0.1.0",
+    "@classytic/repo-core": ">=0.2.0",
+    "mongoose": ">=9.4.1",
+    "zod": ">=4.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.9",
-    "@classytic/mongokit": ">=3.5.3",
+    "@classytic/mongokit": ">=3.11.0",
+    "@classytic/primitives": ">=0.1.0",
+    "@classytic/repo-core": ">=0.2.0",
     "@types/node": "^25.5.0",
     "@vitest/coverage-v8": "^3.2.4",
     "knip": "^6.3.0",
     "mongodb-memory-server": "^10.2.3",
-    "mongoose": "^9.3.3",
+    "mongoose": "^9.4.1",
     "tsdown": "^0.21.5",
     "typescript": "^5.7.0",
-    "vitest": "^3.0.0"
+    "vitest": "^3.0.0",
+    "zod": "^4.3.6"
   },
   "keywords": [
     "loyalty",

package/dist/config-aNigy4ec.d.mts

@@ -1,90 +0,0 @@
-import { t as EventEmitterPort } from "./event-emitter.port-CLYPoMni.mjs";
-import { t as NotificationAdapter } from "./notification.port-BzUsH0It.mjs";
-import { Connection } from "mongoose";
-
-//#region src/types/config.d.ts
-interface TenantEnabled {
-  field?: string;
-  ref?: string;
-  type?: 'ObjectId' | 'string';
-  contextKey?: string;
-}
-type TenantConfig = false | TenantEnabled;
-interface IndexDefinition {
-  fields: Record<string, 1 | -1>;
-  options?: Record<string, unknown>;
-}
-type ModelName = 'member' | 'pointTransaction' | 'earningRule' | 'tierDefinition' | 'redemption' | 'referral';
-type PluginType = unknown;
-interface RepositoryPlugins {
-  member?: PluginType[];
-  pointTransaction?: PluginType[];
-  earningRule?: PluginType[];
-  tierDefinition?: PluginType[];
-  redemption?: PluginType[];
-  referral?: PluginType[];
-}
-interface LoyaltyConfig {
-  mongoose: Connection;
-  tenant?: TenantConfig;
-  program?: {
-    id?: 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;
-  };
-  expiry?: {
-    enabled?: boolean;
-    defaultDays?: number;
-  };
-  indexes?: Partial<Record<ModelName, IndexDefinition[]>>;
-  events?: {
-    adapter?: EventEmitterPort;
-  };
-  notifications?: NotificationAdapter;
-  plugins?: RepositoryPlugins;
-}
-interface ResolvedTenant {
-  enabled: boolean;
-  field: string;
-  ref?: string;
-  type: 'ObjectId' | 'string';
-  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;
-  };
-  expiry: {
-    enabled: boolean;
-    defaultDays?: number;
-  };
-  tenant: ResolvedTenant;
-}
-//#endregion
-export { RepositoryPlugins as a, TenantConfig as c, PluginType as i, LoyaltyConfig as n, ResolvedConfig as o, ModelName as r, ResolvedTenant as s, IndexDefinition as t };

package/dist/domain/index.d.mts

@@ -1,90 +0,0 @@
-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 PointTransaction, c as EarningConditions, i as TierQualification, l as EarningReward, n as TierDefinition, o as Member, r as TierDowngrade, s as MemberBalance, t as TierBenefits, u as EarningRule } from "../tier-definition-Djf72UPa.mjs";
-import { a as MemberPort, c as UnitOfWork, i as PointTransactionPort, l as Referral, n as ReferralPort, o as EarningRulePort, r as RedemptionPort, s as TransactionSession, t as TierDefinitionPort, u as Redemption } from "../tier-definition.port-BzrHYBRo.mjs";
-import { t as EventEmitterPort } from "../event-emitter.port-CLYPoMni.mjs";
-import { t as NotificationAdapter } from "../notification.port-BzUsH0It.mjs";
-
-//#region src/domain/errors/base.d.ts
-declare abstract class LoyaltyError extends Error {
-  abstract readonly code: string;
-  abstract readonly httpStatus: number;
-  constructor(message: string);
-  toJSON(): {
-    code: string;
-    message: string;
-    name: string;
-  };
-}
-//#endregion
-//#region src/domain/errors/domain-errors.d.ts
-declare class InsufficientPointsError extends LoyaltyError {
-  readonly code = "INSUFFICIENT_POINTS";
-  readonly httpStatus = 400;
-  constructor(available: number, requested: number);
-}
-declare class MemberNotFoundError extends LoyaltyError {
-  readonly code = "MEMBER_NOT_FOUND";
-  readonly httpStatus = 404;
-  constructor(id: string);
-}
-declare class MemberAlreadyEnrolledError extends LoyaltyError {
-  readonly code = "MEMBER_ALREADY_ENROLLED";
-  readonly httpStatus = 409;
-  constructor(externalId: string);
-}
-declare class MemberInactiveError extends LoyaltyError {
-  readonly code = "MEMBER_INACTIVE";
-  readonly httpStatus = 422;
-  constructor(id: string);
-}
-declare class RuleNotFoundError extends LoyaltyError {
-  readonly code = "RULE_NOT_FOUND";
-  readonly httpStatus = 404;
-  constructor(id: string);
-}
-declare class TierNotFoundError extends LoyaltyError {
-  readonly code = "TIER_NOT_FOUND";
-  readonly httpStatus = 404;
-  constructor(id: string);
-}
-declare class RedemptionNotFoundError extends LoyaltyError {
-  readonly code = "REDEMPTION_NOT_FOUND";
-  readonly httpStatus = 404;
-  constructor(id: string);
-}
-declare class RedemptionExpiredError extends LoyaltyError {
-  readonly code = "REDEMPTION_EXPIRED";
-  readonly httpStatus = 410;
-  constructor(id: string);
-}
-declare class ReferralNotFoundError extends LoyaltyError {
-  readonly code = "REFERRAL_NOT_FOUND";
-  readonly httpStatus = 404;
-  constructor(id: string);
-}
-declare class DuplicateReferralError extends LoyaltyError {
-  readonly code = "DUPLICATE_REFERRAL";
-  readonly httpStatus = 409;
-  constructor(refereeId: string);
-}
-declare class ReferralLimitExceededError extends LoyaltyError {
-  readonly code = "REFERRAL_LIMIT_EXCEEDED";
-  readonly httpStatus = 429;
-  constructor(limit: number, periodDays: number);
-}
-declare class SelfReferralError extends LoyaltyError {
-  readonly code = "SELF_REFERRAL";
-  readonly httpStatus = 422;
-  constructor();
-}
-declare class ValidationError extends LoyaltyError {
-  readonly code = "VALIDATION_ERROR";
-  readonly httpStatus = 400;
-}
-declare class TenantIsolationError extends LoyaltyError {
-  readonly code = "TENANT_ISOLATION";
-  readonly httpStatus = 403;
-  constructor();
-}
-//#endregion
-export { DuplicateReferralError, EARNING_ACTIONS, EarningAction, EarningConditions, EarningReward, EarningRule, EarningRulePort, EventEmitterPort, InsufficientPointsError, LoyaltyError, MEMBER_STATUSES, Member, MemberAlreadyEnrolledError, MemberBalance, MemberInactiveError, MemberNotFoundError, MemberPort, MemberStatus, NotificationAdapter, PointTransaction, PointTransactionPort, REDEMPTION_STATUSES, REFERRAL_STATUSES, RULE_STATUSES, RULE_TYPES, Redemption, RedemptionExpiredError, RedemptionNotFoundError, RedemptionPort, RedemptionStatus, Referral, ReferralLimitExceededError, ReferralNotFoundError, ReferralPort, ReferralStatus, RuleNotFoundError, RuleStatus, RuleType, SelfReferralError, TRANSACTION_TYPES, TenantIsolationError, TierBenefits, TierDefinition, TierDefinitionPort, TierDowngrade, TierNotFoundError, TierQualification, TransactionSession, TransactionType, UnitOfWork, ValidationError };

package/dist/domain/index.mjs

@@ -1,4 +0,0 @@
-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 MemberInactiveError, c as RedemptionNotFoundError, d as RuleNotFoundError, f as SelfReferralError, g as LoyaltyError, h as ValidationError, i as MemberAlreadyEnrolledError, l as ReferralLimitExceededError, m as TierNotFoundError, n as DuplicateReferralError, o as MemberNotFoundError, p as TenantIsolationError, r as InsufficientPointsError, s as RedemptionExpiredError, u as ReferralNotFoundError } from "../domain-errors-D7q-2LYD.mjs";
-import "./enums/index.mjs";
-export { DuplicateReferralError, EARNING_ACTIONS, InsufficientPointsError, LoyaltyError, MEMBER_STATUSES, MemberAlreadyEnrolledError, MemberInactiveError, MemberNotFoundError, REDEMPTION_STATUSES, REFERRAL_STATUSES, RULE_STATUSES, RULE_TYPES, RedemptionExpiredError, RedemptionNotFoundError, ReferralLimitExceededError, ReferralNotFoundError, RuleNotFoundError, SelfReferralError, TRANSACTION_TYPES, TenantIsolationError, TierNotFoundError, ValidationError };

package/dist/domain-errors-D7q-2LYD.mjs

@@ -1,120 +0,0 @@
-//#region src/domain/errors/base.ts
-var LoyaltyError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = this.constructor.name;
-	}
-	toJSON() {
-		return {
-			code: this.code,
-			message: this.message,
-			name: this.name
-		};
-	}
-};
-//#endregion
-//#region src/domain/errors/domain-errors.ts
-var InsufficientPointsError = class extends LoyaltyError {
-	code = "INSUFFICIENT_POINTS";
-	httpStatus = 400;
-	constructor(available, requested) {
-		super(`Insufficient points. Available: ${available}, requested: ${requested}`);
-	}
-};
-var MemberNotFoundError = class extends LoyaltyError {
-	code = "MEMBER_NOT_FOUND";
-	httpStatus = 404;
-	constructor(id) {
-		super(`Member not found: ${id}`);
-	}
-};
-var MemberAlreadyEnrolledError = class extends LoyaltyError {
-	code = "MEMBER_ALREADY_ENROLLED";
-	httpStatus = 409;
-	constructor(externalId) {
-		super(`Member already enrolled: ${externalId}`);
-	}
-};
-var MemberInactiveError = class extends LoyaltyError {
-	code = "MEMBER_INACTIVE";
-	httpStatus = 422;
-	constructor(id) {
-		super(`Member is not active: ${id}`);
-	}
-};
-var RuleNotFoundError = class extends LoyaltyError {
-	code = "RULE_NOT_FOUND";
-	httpStatus = 404;
-	constructor(id) {
-		super(`Earning rule not found: ${id}`);
-	}
-};
-var TierNotFoundError = class extends LoyaltyError {
-	code = "TIER_NOT_FOUND";
-	httpStatus = 404;
-	constructor(id) {
-		super(`Tier not found: ${id}`);
-	}
-};
-var RedemptionNotFoundError = class extends LoyaltyError {
-	code = "REDEMPTION_NOT_FOUND";
-	httpStatus = 404;
-	constructor(id) {
-		super(`Redemption not found: ${id}`);
-	}
-};
-var RedemptionExpiredError = class extends LoyaltyError {
-	code = "REDEMPTION_EXPIRED";
-	httpStatus = 410;
-	constructor(id) {
-		super(`Redemption expired: ${id}`);
-	}
-};
-var ReferralNotFoundError = class extends LoyaltyError {
-	code = "REFERRAL_NOT_FOUND";
-	httpStatus = 404;
-	constructor(id) {
-		super(`Referral not found: ${id}`);
-	}
-};
-var DuplicateReferralError = class extends LoyaltyError {
-	code = "DUPLICATE_REFERRAL";
-	httpStatus = 409;
-	constructor(refereeId) {
-		super(`Referee already has a referral: ${refereeId}`);
-	}
-};
-var ReferralLimitExceededError = class extends LoyaltyError {
-	code = "REFERRAL_LIMIT_EXCEEDED";
-	httpStatus = 429;
-	constructor(limit, periodDays) {
-		super(`Referral limit of ${limit} per ${periodDays} days exceeded`);
-	}
-};
-var SelfReferralError = class extends LoyaltyError {
-	code = "SELF_REFERRAL";
-	httpStatus = 422;
-	constructor() {
-		super("Cannot refer yourself");
-	}
-};
-var CircularReferralError = class extends LoyaltyError {
-	code = "CIRCULAR_REFERRAL";
-	httpStatus = 422;
-	constructor() {
-		super("Circular referral detected");
-	}
-};
-var ValidationError = class extends LoyaltyError {
-	code = "VALIDATION_ERROR";
-	httpStatus = 400;
-};
-var TenantIsolationError = class extends LoyaltyError {
-	code = "TENANT_ISOLATION";
-	httpStatus = 403;
-	constructor() {
-		super("Tenant context is required but not provided");
-	}
-};
-//#endregion
-export { MemberInactiveError as a, RedemptionNotFoundError as c, RuleNotFoundError as d, SelfReferralError as f, LoyaltyError as g, ValidationError as h, MemberAlreadyEnrolledError as i, ReferralLimitExceededError as l, TierNotFoundError as m, DuplicateReferralError as n, MemberNotFoundError as o, TenantIsolationError as p, InsufficientPointsError as r, RedemptionExpiredError as s, CircularReferralError as t, ReferralNotFoundError as u };

package/dist/event-emitter.port-CLYPoMni.d.mts

@@ -1,8 +0,0 @@
-//#region src/domain/ports/event-emitter.port.d.ts
-interface EventEmitterPort {
-  emit(event: string, payload: unknown): void;
-  on(event: string, handler: (payload: unknown) => void | Promise<void>): void;
-  off(event: string, handler: (payload: unknown) => void | Promise<void>): void;
-}
-//#endregion
-export { EventEmitterPort as t };

package/dist/event-types-xQBtYBbX.mjs

@@ -1,24 +0,0 @@
-//#region src/events/event-types.ts
-const LoyaltyEvents = {
-	MEMBER_ENROLLED: "loyalty.member.enrolled",
-	MEMBER_DEACTIVATED: "loyalty.member.deactivated",
-	MEMBER_REACTIVATED: "loyalty.member.reactivated",
-	MEMBER_SUSPENDED: "loyalty.member.suspended",
-	POINTS_EARNED: "loyalty.points.earned",
-	POINTS_REDEEMED: "loyalty.points.redeemed",
-	POINTS_ADJUSTED: "loyalty.points.adjusted",
-	POINTS_EXPIRED: "loyalty.points.expired",
-	POINTS_EXPIRING_SOON: "loyalty.points.expiring_soon",
-	TIER_UPGRADED: "loyalty.tier.upgraded",
-	TIER_DOWNGRADED: "loyalty.tier.downgraded",
-	TIER_GRACE_STARTED: "loyalty.tier.grace_started",
-	REDEMPTION_RESERVED: "loyalty.redemption.reserved",
-	REDEMPTION_CONFIRMED: "loyalty.redemption.confirmed",
-	REDEMPTION_RELEASED: "loyalty.redemption.released",
-	REFERRAL_RECORDED: "loyalty.referral.recorded",
-	REFERRAL_APPROVED: "loyalty.referral.approved",
-	REFERRAL_REJECTED: "loyalty.referral.rejected",
-	REFERRAL_REWARDED: "loyalty.referral.rewarded"
-};
-//#endregion
-export { LoyaltyEvents as t };

package/dist/events-CprEWlN7.mjs

@@ -1,25 +0,0 @@
-//#region src/events/event-bus.ts
-var InProcessEventBus = class {
-	handlers = /* @__PURE__ */ new Map();
-	emit(event, payload) {
-		const set = this.handlers.get(event);
-		if (!set) return;
-		for (const handler of set) try {
-			const result = handler(payload);
-			if (result && typeof result.catch === "function") result.catch(() => {});
-		} catch {}
-	}
-	on(event, handler) {
-		let set = this.handlers.get(event);
-		if (!set) {
-			set = /* @__PURE__ */ new Set();
-			this.handlers.set(event, set);
-		}
-		set.add(handler);
-	}
-	off(event, handler) {
-		this.handlers.get(event)?.delete(handler);
-	}
-};
-//#endregion
-export { InProcessEventBus as t };