@classytic/loyalty 0.7.0 → 0.10.0

package/dist/types/index.d.mts

@@ -1,3 +1,2 @@
-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-Cp_sXNpG.mjs";
-import { a as ModelName, c as ResolvedConfig, i as LoyaltyShape, l as ResolvedTenant, o as PluginType, r as LoyaltyRuntime, s as RepositoryPlugins, t as IndexDefinition, u as TenantConfig } from "../config-CtkGj3xZ.mjs";
-export { AdjustPointsInput, type BalanceSummary, CreateEarningRuleInput, CreateTierInput, EarnPointsInput, type EarningBreakdown, type EarningResult, EnrollInput, type ExpirationResult, type IndexDefinition, type ListQuery, LoyaltyContext, type LoyaltyRuntime, type LoyaltyShape, type ModelName, type PaginatedResult, type PluginType, type RedemptionValidation, type RepositoryPlugins, type ResolvedConfig, type ResolvedTenant, type TenantConfig, type TierEvaluation, type TierEvaluationBatch, UpdateEarningRuleInput, UpdateTierInput };
+import { A as RepositoryPlugins, C as IndexDefinition, D as LoyaltyShape, E as LoyaltyRuntime, M as ResolvedTenant, N as TenantConfig, O as ModelName, _ as RedemptionValidation, a as EnrollInput, c as UpdateTierInput, d as EarningBreakdown, f as EarningResult, g as PaginatedResult, i as EarnPointsInput, j as ResolvedConfig, k as PluginType, l as BalanceSummary, m as ListQuery, n as CreateEarningRuleInput, o as LoyaltyContext, p as ExpirationResult, r as CreateTierInput, s as UpdateEarningRuleInput, t as AdjustPointsInput, u as EarnReversalResult, v as TierEvaluation, y as TierEvaluationBatch } from "../index-DRrEhE0r.mjs";
+export { AdjustPointsInput, type BalanceSummary, CreateEarningRuleInput, CreateTierInput, EarnPointsInput, type EarnReversalResult, type EarningBreakdown, type EarningResult, EnrollInput, type ExpirationResult, type IndexDefinition, type ListQuery, LoyaltyContext, type LoyaltyRuntime, type LoyaltyShape, type ModelName, type PaginatedResult, type PluginType, type RedemptionValidation, type RepositoryPlugins, type ResolvedConfig, type ResolvedTenant, type TenantConfig, type TierEvaluation, type TierEvaluationBatch, UpdateEarningRuleInput, UpdateTierInput };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/loyalty",
-  "version": "0.7.0",
+  "version": "0.10.0",
   "description": "Loyalty points, tiers, earning rules, referrals, and redemption engine for MongoDB",
   "author": "Classytic",
   "homepage": "https://www.npmjs.com/package/@classytic/loyalty",
@@ -21,30 +21,47 @@
   },
   "exports": {
     ".": {
+      "@classytic/source": "./src/index.ts",
       "types": "./dist/index.d.mts",
       "default": "./dist/index.mjs"
     },
     "./domain/enums": {
+      "@classytic/source": "./src/domain/enums/index.ts",
       "types": "./dist/domain/enums/index.d.mts",
       "default": "./dist/domain/enums/index.mjs"
     },
+    "./domain/rule-schedule": {
+      "@classytic/source": "./src/domain/rule-schedule.ts",
+      "types": "./dist/domain/rule-schedule.d.mts",
+      "default": "./dist/domain/rule-schedule.mjs"
+    },
+    "./domain/earn-base": {
+      "@classytic/source": "./src/domain/earn-base.ts",
+      "types": "./dist/domain/earn-base.d.mts",
+      "default": "./dist/domain/earn-base.mjs"
+    },
     "./models": {
+      "@classytic/source": "./src/models/index.ts",
       "types": "./dist/models/index.d.mts",
       "default": "./dist/models/index.mjs"
     },
     "./repositories": {
+      "@classytic/source": "./src/repositories/index.ts",
       "types": "./dist/repositories/index.d.mts",
       "default": "./dist/repositories/index.mjs"
     },
     "./events": {
+      "@classytic/source": "./src/events/index.ts",
       "types": "./dist/events/index.d.mts",
       "default": "./dist/events/index.mjs"
     },
     "./types": {
+      "@classytic/source": "./src/types/index.ts",
       "types": "./dist/types/index.d.mts",
       "default": "./dist/types/index.mjs"
     },
     "./notifications": {
+      "@classytic/source": "./src/notifications/index.ts",
       "types": "./dist/notifications/index.d.mts",
       "default": "./dist/notifications/index.mjs"
     }
@@ -78,30 +95,30 @@
     "release": "npm run push -- main && npm run release:tag && npm publish"
   },
   "peerDependencies": {
-    "@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",
+    "@classytic/mongokit": ">=3.41.0",
+    "@classytic/primitives": ">=0.32.0",
+    "@classytic/repo-core": ">=0.31.0",
+    "@classytic/validation": ">=0.6.0",
+    "mongoose": ">=9.11.0",
     "zod": ">=4.0.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.9",
-    "@classytic/dev-tools": "^0.2.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",
-    "mongodb-memory-server": "^10.2.3",
-    "mongoose": "^9.4.1",
-    "publint": "^0.3.23",
-    "tsdown": "^0.22.14",
-    "typescript": "^5.7.0",
-    "vitest": "^3.0.0",
-    "zod": "^4.3.6"
+    "@biomejs/biome": "^2.5.15",
+    "@classytic/dev-tools": "^0.2.1",
+    "@classytic/mongokit": "^3.43.0",
+    "@classytic/primitives": "^0.34.0",
+    "@classytic/repo-core": "^0.31.1",
+    "@classytic/validation": "^0.6.0",
+    "@types/node": "^26.6.5",
+    "@vitest/coverage-v8": "^5.0.5",
+    "knip": "^6.41.0",
+    "mongodb-memory-server": "^11.3.0",
+    "mongoose": "^9.11.2",
+    "publint": "^0.3.25",
+    "tsdown": "^0.23.1",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5",
+    "zod": "^4.6.7"
   },
   "keywords": [
     "loyalty",

package/dist/config-CtkGj3xZ.d.mts

@@ -1,178 +0,0 @@
-import { t as NotificationAdapter } from "./notification.port-wY4IKimz.mjs";
-import { ResolvedTenantConfig, TenantConfig } from "@classytic/repo-core/tenant";
-import { EventTransport } from "@classytic/primitives/events";
-import { OutboxStore } from "@classytic/primitives/outbox";
-//#region src/types/config.d.ts
-type LoyaltyModelName = 'Member' | 'PointTransaction' | 'EarningRule' | 'TierDefinition' | 'Redemption' | 'Referral';
-type TenantConfig$1 = TenantConfig | boolean;
-/** @deprecated Use `ResolvedTenantConfig` from `@classytic/repo-core/tenant`. */
-type ResolvedTenant = ResolvedTenantConfig;
-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 LoyaltyShape {
-  tenant?: TenantConfig$1 | undefined;
-  /**
-   * IANA timezone name (e.g. `'Asia/Dhaka'`, `'America/New_York'`) used to
-   * evaluate wall-clock rule conditions — currently `EarningConditions.dayOfWeek`
-   * ("2× points on Fridays"). Resolved DST-exact per instant via
-   * `@classytic/primitives/timezone`. Validated at boot: an unknown zone throws
-   * `ValidationError`, never a silent mis-evaluation.
-   *
-   * Omitted → **UTC** (the day boundary is the UTC calendar day). Either way the
-   * result NEVER depends on the deploy machine's `TZ` env. PACKAGE_RULES P12.
-   */
-  timezone?: string | undefined;
-  program?: {
-    id?: string | undefined;
-    /**
-     * RATE: integer minor units ONE point redeems for (≥ 1) in the host's
-     * ambient currency. `pointValueMinor: 10` = 1 point → 10 paisa
-     * (৳0.10, i.e. the old `conversionRate: 10` "10 points per ৳1").
-     * Replaces `conversionRate` (0.5.x), whose implicit per-1-MAJOR-unit
-     * basis was ambiguous.
-     */
-    pointValueMinor?: number | undefined;
-  } | undefined;
-  redemption?: {
-    minPoints?: number | undefined;
-    /**
-     * Minimum order total eligible for redemption — **integer minor
-     * units** (paisa for BDT). Compared against `validate()`'s
-     * `orderTotal` (also minor units).
-     */
-    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 mongokit's `ModelCollisionError`.
-   * Hosts that need two loyalty engines should use two Mongoose connections
-   * (`mongoose.createConnection(...)`). See PACKAGE_RULES.md §21.
-   */
-  forceRecreate?: boolean | undefined;
-}
-interface LoyaltyRuntime {
-  /**
-   * Arc-compatible event transport. When omitted, the engine creates (and
-   * OWNS, so `close()` closes) an `InProcessLoyaltyBus` — a ~60-line structural
-   * match of arc's `MemoryEventTransport`. A host-supplied transport is the
-   * host's to close. 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;
-  /**
-   * Skip the boot-time capability gate that asserts the backend supports
-   * multi-document `transactions`. Loyalty's point-mutation verbs (earn,
-   * adjust, reserve, confirm, release, reverse, processExpirations) run inside
-   * `withTransaction`; without a replica set those writes are NOT atomic.
-   * Leave `false` (default) in production — set `true` only for local-dev on
-   * standalone Mongo, accepting partial-write risk. See PACKAGE_RULES
-   * "Runtime capabilities".
-   */
-  allowNonTransactional?: boolean | undefined;
-  /**
-   * Where the engine's boot warnings go — today, the `allowNonTransactional`
-   * downgrade notice. Defaults to `console`. A downgrade that carries
-   * partial-write risk on stored value must be VISIBLE, and a host that routes
-   * logs elsewhere would otherwise never see it.
-   */
-  logger?: {
-    warn?(message: string, ...args: unknown[]): void;
-    error?(message: string, ...args: unknown[]): void;
-  } | undefined;
-}
-interface ResolvedConfig {
-  programId: string;
-  /** Integer minor units one point redeems for (≥ 1). See `LoyaltyShape.program.pointValueMinor`. */
-  pointValueMinor: number;
-  redemption: {
-    minPoints: number;
-    /** Integer minor units. */
-    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;
-  };
-  /** Resolved IANA zone for wall-clock rule evaluation; `undefined` = UTC. */
-  timezone?: string;
-  tenant: ResolvedTenantConfig;
-}
-//#endregion
-export { ModelName as a, ResolvedConfig as c, LoyaltyShape as i, ResolvedTenant as l, LoyaltyModelName as n, PluginType as o, LoyaltyRuntime as r, RepositoryPlugins as s, IndexDefinition as t, TenantConfig$1 as u };

package/dist/constants-DOPBh6kt.mjs

@@ -1,48 +0,0 @@
-//#region src/constants.ts
-const DEFAULT_PROGRAM_ID = "default";
-const TRANSACTION_TYPES = Object.freeze([
-	"earn",
-	"redeem",
-	"adjust",
-	"expire",
-	"transfer",
-	"referral_bonus"
-]);
-const MEMBER_STATUSES = Object.freeze([
-	"active",
-	"inactive",
-	"suspended"
-]);
-const RULE_TYPES = Object.freeze([
-	"order",
-	"action",
-	"category",
-	"tier_bonus"
-]);
-const RULE_STATUSES = Object.freeze([
-	"active",
-	"paused",
-	"expired"
-]);
-const REFERRAL_STATUSES = Object.freeze([
-	"pending",
-	"approved",
-	"rejected",
-	"expired"
-]);
-const REDEMPTION_STATUSES = Object.freeze([
-	"reserved",
-	"confirmed",
-	"released",
-	"expired",
-	"reversed"
-]);
-const EARNING_ACTIONS = Object.freeze([
-	"signup",
-	"referral",
-	"birthday",
-	"review",
-	"profile_complete"
-]);
-//#endregion
-export { REFERRAL_STATUSES as a, TRANSACTION_TYPES as c, REDEMPTION_STATUSES as i, EARNING_ACTIONS as n, RULE_STATUSES as o, MEMBER_STATUSES as r, RULE_TYPES as s, DEFAULT_PROGRAM_ID as t };