@higher.archi/boe 1.0.29 → 1.0.31

package/dist/engines/fuzzy/fuzzy.types.js

@@ -6,10 +6,52 @@
  * and fuzzy inference. Self-contained within the fuzzy engine.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WIDTH_VALUES = exports.POSITION_VALUES = void 0;
+exports.WIDTH_VALUES = exports.POSITION_VALUES = exports.DefuzzifyPresets = exports.TransformMethods = exports.DefuzzifyMethods = exports.AggregationMethods = exports.EdgeSemantics = exports.WidthSemantics = exports.PositionSemantics = exports.MembershipShapes = void 0;
 exports.isSemanticTerm = isSemanticTerm;
 exports.isExplicitTerm = isExplicitTerm;
 exports.expandDefuzzifyPreset = expandDefuzzifyPreset;
+// ========================================
+// Membership Shape Types
+// ========================================
+/**
+ * Membership function shapes
+ * These define how membership degree (0-1) is calculated from a crisp value
+ */
+exports.MembershipShapes = {
+    triangle: 'triangle',
+    trapezoid: 'trapezoid',
+    gaussian: 'gaussian',
+    shoulder: 'shoulder',
+    block: 'block',
+};
+/**
+ * Semantic position within domain (compiles to numeric center)
+ */
+exports.PositionSemantics = {
+    veryLow: 'very-low',
+    low: 'low',
+    medium: 'medium',
+    high: 'high',
+    veryHigh: 'very-high',
+};
+/**
+ * Semantic width/spread (compiles to numeric spread as % of domain)
+ */
+exports.WidthSemantics = {
+    tight: 'tight',
+    narrow: 'narrow',
+    medium: 'medium',
+    wide: 'wide',
+    veryWide: 'very-wide',
+};
+/**
+ * Edge behavior for shoulder/block shapes
+ */
+exports.EdgeSemantics = {
+    openLeft: 'open-left',
+    openRight: 'open-right',
+    closed: 'closed',
+};
 /**
  * Type guard for semantic terms
  */
@@ -23,6 +65,52 @@ function isExplicitTerm(term) {
     return 'params' in term;
 }
 // ========================================
+// Defuzzification Pipeline Types
+// ========================================
+/**
+ * Aggregation methods - combine multiple rule activations for same output
+ */
+exports.AggregationMethods = {
+    max: 'max',
+    sum: 'sum',
+    probor: 'probor',
+    bound: 'bound',
+    min: 'min',
+};
+/**
+ * Defuzzification methods - convert fuzzy output to crisp value
+ */
+exports.DefuzzifyMethods = {
+    centroid: 'centroid',
+    bisector: 'bisector',
+    mom: 'mom',
+    som: 'som',
+    lom: 'lom',
+    wtaver: 'wtaver',
+};
+/**
+ * Transform methods - post-process the crisp output
+ */
+exports.TransformMethods = {
+    clamp: 'clamp',
+    round: 'round',
+    deadband: 'deadband',
+    scale: 'scale',
+    quantize: 'quantize',
+};
+/**
+ * Named presets that expand to full pipelines
+ */
+exports.DefuzzifyPresets = {
+    balanced: 'balanced',
+    smooth: 'smooth',
+    decisive: 'decisive',
+    cautious: 'cautious',
+    aggressive: 'aggressive',
+    discrete: 'discrete',
+    stable: 'stable',
+};
+// ========================================
 // Preset Expansions
 // ========================================
 /**

package/dist/engines/fuzzy/fuzzy.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"fuzzy.types.js","sourceRoot":"","sources":["../../../src/engines/fuzzy/fuzzy.types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA+DH,wCAEC;AAKD,wCAEC;AA8OD,sDAmBC;AA7QD;;GAEG;AACH,SAAgB,cAAc,CAAC,IAAe;IAC5C,OAAO,UAAU,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,IAAe;IAC5C,OAAO,QAAQ,IAAI,IAAI,CAAC;AAC1B,CAAC;AAuOD,2CAA2C;AAC3C,oBAAoB;AACpB,2CAA2C;AAE3C;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAuB;IAC3D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACtC,KAAK,QAAQ;YACX,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACzC,KAAK,UAAU;YACb,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxB,KAAK,UAAU;YACb,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjC,KAAK,YAAY;YACf,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjC,KAAK,UAAU;YACb,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,KAAK,QAAQ;YACX,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD;YACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;GAEG;AACU,QAAA,eAAe,GAAqC;IAC/D,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,IAAI;CAClB,CAAC;AAEF;;GAEG;AACU,QAAA,YAAY,GAAkC;IACzD,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,IAAI;CAClB,CAAC"}
+{"version":3,"file":"fuzzy.types.js","sourceRoot":"","sources":["../../../src/engines/fuzzy/fuzzy.types.ts"],"names":[],"mappings":"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"}

package/dist/engines/loyalty/compiler.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Loyalty Engine Compiler
+ *
+ * Validates loyalty rulesets and resolves defaults.
+ */
+import type { LoyaltyRuleSet, CompiledLoyaltyRuleSet } from './types';
+/**
+ * Compile and validate a loyalty ruleset.
+ */
+export declare function compileLoyaltyRuleSet(ruleSet: LoyaltyRuleSet): CompiledLoyaltyRuleSet;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/engines/loyalty/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/engines/loyalty/compiler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EAIvB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,GACtB,sBAAsB,CAmBxB"}

package/dist/engines/loyalty/compiler.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Loyalty Engine Compiler
+ *
+ * Validates loyalty rulesets and resolves defaults.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileLoyaltyRuleSet = compileLoyaltyRuleSet;
+const errors_1 = require("../../core/errors");
+/**
+ * Compile and validate a loyalty ruleset.
+ */
+function compileLoyaltyRuleSet(ruleSet) {
+    if (!ruleSet.id) {
+        throw new errors_1.CompilationError('Loyalty ruleset requires an id');
+    }
+    if (ruleSet.mode !== 'loyalty') {
+        throw new errors_1.CompilationError(`Expected mode 'loyalty', got '${ruleSet.mode}'`);
+    }
+    switch (ruleSet.strategy) {
+        case 'earning':
+            return compileEarning(ruleSet);
+        case 'redemption':
+            return compileRedemption(ruleSet);
+        case 'tier-evaluation':
+            return compileTierEvaluation(ruleSet);
+        default:
+            throw new errors_1.CompilationError(`Unknown loyalty strategy: '${ruleSet.strategy}'`);
+    }
+}
+function compileEarning(ruleSet) {
+    if (!ruleSet.earningRules || ruleSet.earningRules.length === 0) {
+        throw new errors_1.CompilationError('Earning strategy requires at least one earning rule');
+    }
+    // Validate unique rule IDs
+    const ruleIds = new Set();
+    for (const rule of ruleSet.earningRules) {
+        if (!rule.id) {
+            throw new errors_1.CompilationError('Each earning rule requires an id');
+        }
+        if (ruleIds.has(rule.id)) {
+            throw new errors_1.CompilationError(`Duplicate earning rule id: '${rule.id}'`);
+        }
+        if (rule.baseRate < 0) {
+            throw new errors_1.CompilationError(`Earning rule '${rule.id}' baseRate must be non-negative`);
+        }
+        ruleIds.add(rule.id);
+    }
+    // Validate tier IDs are unique
+    validateTierIds(ruleSet.tiers);
+    // Validate promotions
+    validatePromotions(ruleSet.promotions);
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'loyalty',
+        strategy: 'earning',
+        earningRules: ruleSet.earningRules,
+        defaultRate: ruleSet.defaultRate ?? 1,
+        tiers: ruleSet.tiers ?? [],
+        expirationPolicy: ruleSet.expirationPolicy ?? {},
+        promotions: ruleSet.promotions ?? []
+    };
+}
+function compileRedemption(ruleSet) {
+    if (!ruleSet.redemptionOptions || ruleSet.redemptionOptions.length === 0) {
+        throw new errors_1.CompilationError('Redemption strategy requires at least one redemption option');
+    }
+    // Validate unique option IDs
+    const optionIds = new Set();
+    for (const option of ruleSet.redemptionOptions) {
+        if (!option.id) {
+            throw new errors_1.CompilationError('Each redemption option requires an id');
+        }
+        if (optionIds.has(option.id)) {
+            throw new errors_1.CompilationError(`Duplicate redemption option id: '${option.id}'`);
+        }
+        if (option.pointsRequired <= 0) {
+            throw new errors_1.CompilationError(`Redemption option '${option.id}' pointsRequired must be positive`);
+        }
+        optionIds.add(option.id);
+    }
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'loyalty',
+        strategy: 'redemption',
+        redemptionOptions: ruleSet.redemptionOptions,
+        tiers: ruleSet.tiers ?? [],
+        expirationPolicy: ruleSet.expirationPolicy ?? {},
+        promotions: ruleSet.promotions ?? []
+    };
+}
+function compileTierEvaluation(ruleSet) {
+    if (!ruleSet.tiers || ruleSet.tiers.length === 0) {
+        throw new errors_1.CompilationError('Tier-evaluation strategy requires at least one tier definition');
+    }
+    // Validate tier IDs are unique
+    validateTierIds(ruleSet.tiers);
+    // Validate tiers are sorted by threshold ascending
+    for (let i = 1; i < ruleSet.tiers.length; i++) {
+        if (ruleSet.tiers[i].qualifyingThreshold < ruleSet.tiers[i - 1].qualifyingThreshold) {
+            throw new errors_1.CompilationError(`Tier '${ruleSet.tiers[i].id}' threshold (${ruleSet.tiers[i].qualifyingThreshold}) ` +
+                `is less than previous tier '${ruleSet.tiers[i - 1].id}' (${ruleSet.tiers[i - 1].qualifyingThreshold}). ` +
+                `Tiers must be ordered by ascending threshold.`);
+        }
+    }
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'loyalty',
+        strategy: 'tier-evaluation',
+        evaluationPeriod: ruleSet.evaluationPeriod ?? 'rolling-12-months',
+        tiers: ruleSet.tiers,
+        expirationPolicy: ruleSet.expirationPolicy ?? {},
+        promotions: ruleSet.promotions ?? []
+    };
+}
+function validateTierIds(tiers) {
+    if (!tiers)
+        return;
+    const tierIds = new Set();
+    for (const tier of tiers) {
+        if (tierIds.has(tier.id)) {
+            throw new errors_1.CompilationError(`Duplicate tier id: '${tier.id}'`);
+        }
+        tierIds.add(tier.id);
+    }
+}
+function validatePromotions(promotions) {
+    if (!promotions)
+        return;
+    const promoIds = new Set();
+    for (const promo of promotions) {
+        if (!promo.id) {
+            throw new errors_1.CompilationError('Each promotion requires an id');
+        }
+        if (promoIds.has(promo.id)) {
+            throw new errors_1.CompilationError(`Duplicate promotion id: '${promo.id}'`);
+        }
+        promoIds.add(promo.id);
+    }
+}
+//# sourceMappingURL=compiler.js.map

package/dist/engines/loyalty/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../../../src/engines/loyalty/compiler.ts"],"names":[],"mappings":"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"}

package/dist/engines/loyalty/engine.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Loyalty Engine
+ *
+ * Point ledger engine that manages earning rules with category multipliers,
+ * point transactions, tier-qualified balances, and promotion stacking.
+ * Unlike other BOE engines, the Loyalty engine maintains a running balance
+ * ledger across operations.
+ *
+ * @example
+ * ```typescript
+ * const engine = new LoyaltyEngine();
+ * const compiled = compileLoyaltyRuleSet({ ... });
+ *
+ * // Stream purchases as they arrive
+ * const r1 = engine.ingest({ memberId: 'M001', amount: 250, category: 'dining' }, compiled);
+ * // r1.pointsEarned: 500, r1.newBalance: 500
+ *
+ * engine.getBalance('M001'); // { currentBalance: 500, ... }
+ * ```
+ */
+import { WorkingMemory, Fact, FactInput, FactChange } from '../../core';
+import type { CompiledLoyaltyRuleSet, CompiledEarningRuleSet, LoyaltyOptions, LoyaltyResult, LoyaltyIngestResult, MemberBalance } from './types';
+export declare class LoyaltyEngine {
+    private wm;
+    private strategy;
+    private _ledger;
+    constructor(workingMemory?: WorkingMemory);
+    add<T = Record<string, any>>(input: FactInput<T>): Fact<T>;
+    remove(factId: string): Fact | undefined;
+    update<T = Record<string, any>>(input: FactInput<T>): Fact<T>;
+    get(factId: string): Fact | undefined;
+    getByType(type: string): Fact[];
+    getAll(): Fact[];
+    has(factId: string): boolean;
+    size(): number;
+    clear(): void;
+    getChanges(): FactChange[];
+    clearChanges(): void;
+    /**
+     * Execute a loyalty ruleset against all facts in working memory.
+     *
+     * @param ruleSet - Compiled loyalty ruleset
+     * @param options - Runtime options (asOf date)
+     * @returns Loyalty result (earning, redemption, or tier-evaluation)
+     */
+    execute(ruleSet: CompiledLoyaltyRuleSet, options?: LoyaltyOptions): LoyaltyResult;
+    /**
+     * Process a single purchase/activity event incrementally.
+     *
+     * Each call computes points earned, updates the internal ledger,
+     * evaluates tier status, and returns the result with the new balance.
+     * Only works with earning strategy rulesets.
+     *
+     * @param eventData - Event data with memberId, amount, and optional category
+     * @param ruleSet - Compiled earning ruleset
+     * @param asOf - Reference time (default: now)
+     * @returns Earning result with updated balance
+     */
+    ingest(eventData: Record<string, any>, ruleSet: CompiledEarningRuleSet, asOf?: Date): LoyaltyIngestResult;
+    /**
+     * Get the current balance for a member.
+     * Returns undefined if the member has no transactions.
+     */
+    getBalance(memberId: string): MemberBalance | undefined;
+    /**
+     * Get the full ledger state (all member balances).
+     */
+    getLedger(): Map<string, MemberBalance>;
+    /**
+     * Reset the ledger, clearing all member balances.
+     * Does not affect working memory.
+     */
+    resetLedger(): void;
+    getWorkingMemory(): WorkingMemory;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engines/loyalty/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engines/loyalty/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,aAAa,EACb,IAAI,EACJ,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,aAAa,EACd,MAAM,SAAS,CAAC;AAIjB,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,OAAO,CAAyC;gBAE5C,aAAa,CAAC,EAAE,aAAa;IASzC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAI1D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIxC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAI7D,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE;IAI/B,MAAM,IAAI,IAAI,EAAE;IAIhB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;IAIb,UAAU,IAAI,UAAU,EAAE;IAI1B,YAAY,IAAI,IAAI;IAQpB;;;;;;OAMG;IACH,OAAO,CACL,OAAO,EAAE,sBAAsB,EAC/B,OAAO,GAAE,cAAmB,GAC3B,aAAa;IAQhB;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,OAAO,EAAE,sBAAsB,EAC/B,IAAI,GAAE,IAAiB,GACtB,mBAAmB;IAQtB;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIvD;;OAEG;IACH,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAIvC;;;OAGG;IACH,WAAW,IAAI,IAAI;IAQnB,gBAAgB,IAAI,aAAa;CAGlC"}

package/dist/engines/loyalty/engine.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * Loyalty Engine
+ *
+ * Point ledger engine that manages earning rules with category multipliers,
+ * point transactions, tier-qualified balances, and promotion stacking.
+ * Unlike other BOE engines, the Loyalty engine maintains a running balance
+ * ledger across operations.
+ *
+ * @example
+ * ```typescript
+ * const engine = new LoyaltyEngine();
+ * const compiled = compileLoyaltyRuleSet({ ... });
+ *
+ * // Stream purchases as they arrive
+ * const r1 = engine.ingest({ memberId: 'M001', amount: 250, category: 'dining' }, compiled);
+ * // r1.pointsEarned: 500, r1.newBalance: 500
+ *
+ * engine.getBalance('M001'); // { currentBalance: 500, ... }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoyaltyEngine = void 0;
+const core_1 = require("../../core");
+const strategy_1 = require("./strategy");
+class LoyaltyEngine {
+    wm;
+    strategy;
+    _ledger = new Map();
+    constructor(workingMemory) {
+        this.wm = workingMemory ?? new core_1.WorkingMemory();
+        this.strategy = new strategy_1.LoyaltyExecutor();
+    }
+    // ========================================
+    // IWorkingMemory Implementation
+    // ========================================
+    add(input) {
+        return this.wm.add(input);
+    }
+    remove(factId) {
+        return this.wm.remove(factId);
+    }
+    update(input) {
+        return this.wm.update(input);
+    }
+    get(factId) {
+        return this.wm.get(factId);
+    }
+    getByType(type) {
+        return this.wm.getByType(type);
+    }
+    getAll() {
+        return this.wm.getAll();
+    }
+    has(factId) {
+        return this.wm.has(factId);
+    }
+    size() {
+        return this.wm.size();
+    }
+    clear() {
+        this.wm.clear();
+    }
+    getChanges() {
+        return this.wm.getChanges();
+    }
+    clearChanges() {
+        this.wm.clearChanges();
+    }
+    // ========================================
+    // Engine Execution
+    // ========================================
+    /**
+     * Execute a loyalty ruleset against all facts in working memory.
+     *
+     * @param ruleSet - Compiled loyalty ruleset
+     * @param options - Runtime options (asOf date)
+     * @returns Loyalty result (earning, redemption, or tier-evaluation)
+     */
+    execute(ruleSet, options = {}) {
+        return this.strategy.run(ruleSet, this.wm, this._ledger, options);
+    }
+    // ========================================
+    // Streaming Ingest
+    // ========================================
+    /**
+     * Process a single purchase/activity event incrementally.
+     *
+     * Each call computes points earned, updates the internal ledger,
+     * evaluates tier status, and returns the result with the new balance.
+     * Only works with earning strategy rulesets.
+     *
+     * @param eventData - Event data with memberId, amount, and optional category
+     * @param ruleSet - Compiled earning ruleset
+     * @param asOf - Reference time (default: now)
+     * @returns Earning result with updated balance
+     */
+    ingest(eventData, ruleSet, asOf = new Date()) {
+        return this.strategy.earnSingle(eventData, ruleSet, this._ledger, asOf);
+    }
+    // ========================================
+    // Ledger Operations
+    // ========================================
+    /**
+     * Get the current balance for a member.
+     * Returns undefined if the member has no transactions.
+     */
+    getBalance(memberId) {
+        return this._ledger.get(memberId);
+    }
+    /**
+     * Get the full ledger state (all member balances).
+     */
+    getLedger() {
+        return new Map(this._ledger);
+    }
+    /**
+     * Reset the ledger, clearing all member balances.
+     * Does not affect working memory.
+     */
+    resetLedger() {
+        this._ledger.clear();
+    }
+    // ========================================
+    // Utility Methods
+    // ========================================
+    getWorkingMemory() {
+        return this.wm;
+    }
+}
+exports.LoyaltyEngine = LoyaltyEngine;
+//# sourceMappingURL=engine.js.map

package/dist/engines/loyalty/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/engines/loyalty/engine.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAEH,qCAKoB;AAWpB,yCAA6C;AAE7C,MAAa,aAAa;IAChB,EAAE,CAAgB;IAClB,QAAQ,CAAkB;IAC1B,OAAO,GAA+B,IAAI,GAAG,EAAE,CAAC;IAExD,YAAY,aAA6B;QACvC,IAAI,CAAC,EAAE,GAAG,aAAa,IAAI,IAAI,oBAAa,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,0BAAe,EAAE,CAAC;IACxC,CAAC;IAED,2CAA2C;IAC3C,gCAAgC;IAChC,2CAA2C;IAE3C,GAAG,CAA0B,KAAmB;QAC9C,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAA0B,KAAmB;QACjD,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,YAAY;QACV,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC;IACzB,CAAC;IAED,2CAA2C;IAC3C,mBAAmB;IACnB,2CAA2C;IAE3C;;;;;;OAMG;IACH,OAAO,CACL,OAA+B,EAC/B,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,2CAA2C;IAC3C,mBAAmB;IACnB,2CAA2C;IAE3C;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,SAA8B,EAC9B,OAA+B,EAC/B,OAAa,IAAI,IAAI,EAAE;QAEvB,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,2CAA2C;IAC3C,oBAAoB;IACpB,2CAA2C;IAE3C;;;OAGG;IACH,UAAU,CAAC,QAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,2CAA2C;IAC3C,kBAAkB;IAClB,2CAA2C;IAE3C,gBAAgB;QACd,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF;AAtID,sCAsIC"}

package/dist/engines/loyalty/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Loyalty Engine -- Point Ledger Management
+ */
+export type { LoyaltyStrategy, PointTransactionType, TierStatus, QualifyingMetric, EvaluationPeriod, EarningRule, RedemptionOption, LoyaltyTierDefinition, PromotionRule, ExpirationPolicy, PointTransaction, MemberBalance, EarningRuleSet, RedemptionRuleSet, TierEvaluationRuleSet, LoyaltyRuleSet, CompiledEarningRuleSet, CompiledRedemptionRuleSet, CompiledTierEvaluationRuleSet, CompiledLoyaltyRuleSet, EarningResult, RedemptionResult, MemberTierResult, TierEvaluationResult, LoyaltyResult, LoyaltyOptions, LoyaltyIngestResult } from './types';
+export { LoyaltyStrategies, PointTransactionTypes, TierStatuses, QualifyingMetrics, EvaluationPeriods } from './types';
+export { compileLoyaltyRuleSet } from './compiler';
+export { LoyaltyExecutor, loyaltyStrategy } from './strategy';
+export { LoyaltyEngine } from './engine';
+//# sourceMappingURL=index.d.ts.map

package/dist/engines/loyalty/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engines/loyalty/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/engines/loyalty/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Loyalty Engine -- Point Ledger Management
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoyaltyEngine = exports.loyaltyStrategy = exports.LoyaltyExecutor = exports.compileLoyaltyRuleSet = exports.EvaluationPeriods = exports.QualifyingMetrics = exports.TierStatuses = exports.PointTransactionTypes = exports.LoyaltyStrategies = void 0;
+// Constants
+var types_1 = require("./types");
+Object.defineProperty(exports, "LoyaltyStrategies", { enumerable: true, get: function () { return types_1.LoyaltyStrategies; } });
+Object.defineProperty(exports, "PointTransactionTypes", { enumerable: true, get: function () { return types_1.PointTransactionTypes; } });
+Object.defineProperty(exports, "TierStatuses", { enumerable: true, get: function () { return types_1.TierStatuses; } });
+Object.defineProperty(exports, "QualifyingMetrics", { enumerable: true, get: function () { return types_1.QualifyingMetrics; } });
+Object.defineProperty(exports, "EvaluationPeriods", { enumerable: true, get: function () { return types_1.EvaluationPeriods; } });
+// Compiler
+var compiler_1 = require("./compiler");
+Object.defineProperty(exports, "compileLoyaltyRuleSet", { enumerable: true, get: function () { return compiler_1.compileLoyaltyRuleSet; } });
+// Strategy
+var strategy_1 = require("./strategy");
+Object.defineProperty(exports, "LoyaltyExecutor", { enumerable: true, get: function () { return strategy_1.LoyaltyExecutor; } });
+Object.defineProperty(exports, "loyaltyStrategy", { enumerable: true, get: function () { return strategy_1.loyaltyStrategy; } });
+// Engine
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "LoyaltyEngine", { enumerable: true, get: function () { return engine_1.LoyaltyEngine; } });
+//# sourceMappingURL=index.js.map

package/dist/engines/loyalty/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engines/loyalty/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAiCH,YAAY;AACZ,iCAMiB;AALf,0GAAA,iBAAiB,OAAA;AACjB,8GAAA,qBAAqB,OAAA;AACrB,qGAAA,YAAY,OAAA;AACZ,0GAAA,iBAAiB,OAAA;AACjB,0GAAA,iBAAiB,OAAA;AAGnB,WAAW;AACX,uCAAmD;AAA1C,iHAAA,qBAAqB,OAAA;AAE9B,WAAW;AACX,uCAA8D;AAArD,2GAAA,eAAe,OAAA;AAAE,2GAAA,eAAe,OAAA;AAEzC,SAAS;AACT,mCAAyC;AAAhC,uGAAA,aAAa,OAAA"}

package/dist/engines/loyalty/strategy.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Loyalty Engine Strategy
+ *
+ * Core execution logic for all loyalty strategies:
+ * - earning: compute points from purchase/activity events with category multipliers and promotion stacking
+ * - redemption: process point redemption with balance validation
+ * - tier-evaluation: evaluate members against tier thresholds with upgrade/downgrade detection
+ */
+import type { IWorkingMemory } from '../../core';
+import type { CompiledLoyaltyRuleSet, CompiledEarningRuleSet, LoyaltyOptions, EarningResult, LoyaltyResult, PointTransaction, MemberBalance } from './types';
+export declare class LoyaltyExecutor {
+    run(ruleSet: CompiledLoyaltyRuleSet, wm: IWorkingMemory, ledger: Map<string, MemberBalance>, options?: LoyaltyOptions): LoyaltyResult;
+    runEarning(ruleSet: CompiledEarningRuleSet, wm: IWorkingMemory, ledger: Map<string, MemberBalance>, options?: LoyaltyOptions): EarningResult;
+    /**
+     * Process a single earning event (for streaming ingest).
+     */
+    earnSingle(eventData: Record<string, any>, ruleSet: CompiledEarningRuleSet, ledger: Map<string, MemberBalance>, asOf?: Date): {
+        memberId: string;
+        pointsEarned: number;
+        bonusPointsEarned: number;
+        promotionsApplied: string[];
+        newBalance: number;
+        transactions: PointTransaction[];
+    };
+    private runRedemption;
+    private runTierEvaluation;
+    private findMatchingEarningRules;
+    getOrCreateBalance(ledger: Map<string, MemberBalance>, memberId: string): MemberBalance;
+    private evaluateMemberTier;
+    private getTierMultiplierBonus;
+    private resolveTierStatus;
+}
+/** Singleton instance */
+export declare const loyaltyStrategy: LoyaltyExecutor;
+//# sourceMappingURL=strategy.d.ts.map

package/dist/engines/loyalty/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/engines/loyalty/strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EAGtB,cAAc,EACd,aAAa,EAGb,aAAa,EACb,gBAAgB,EAChB,aAAa,EAMd,MAAM,SAAS,CAAC;AAyCjB,qBAAa,eAAe;IAC1B,GAAG,CACD,OAAO,EAAE,sBAAsB,EAC/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EAClC,OAAO,GAAE,cAAmB,GAC3B,aAAa;IAiBhB,UAAU,CACR,OAAO,EAAE,sBAAsB,EAC/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EAClC,OAAO,GAAE,cAAmB,GAC3B,aAAa;IAkGhB;;OAEG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EAClC,IAAI,GAAE,IAAiB,GACtB;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,gBAAgB,EAAE,CAAC;KAClC;IAkFD,OAAO,CAAC,aAAa;IAqErB,OAAO,CAAC,iBAAiB;IAyFzB,OAAO,CAAC,wBAAwB;IAShC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa;IAgBvF,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,iBAAiB;CAwB1B;AAED,yBAAyB;AACzB,eAAO,MAAM,eAAe,iBAAwB,CAAC"}