@endora-commerce/mod-promotions 0.100.0

package/dist/backend/services/promotion-code-port.js

@@ -0,0 +1,53 @@
+import { Promotion } from '../entities/promotion.entity.js';
+import { PromotionCoupon } from '../entities/promotion-coupon.entity.js';
+/**
+ * The coupon-resolution port `promotions` publishes (feature 075, Phase P).
+ *
+ * `carts` reaches both entity classes for exactly one question — "is this code
+ * live, and which promotion is it?" — across a three-step lookup: the legacy
+ * `promotions.code` column first, then the `promotion_coupons` table, then the
+ * promotion behind the coupon, each filtered on `isActive`. That order and
+ * those filters are this module's business, and reproducing them in `carts`
+ * meant reproducing them correctly.
+ *
+ * The answer is eight fields rather than the thirty-column row, because eight
+ * is what the question needs: which promotion, and — when the buyer may not
+ * use it — why not. The four eligibility fields joined the record in feature
+ * 075's `carts` cut; without them the caller could only answer `invalid_code`
+ * where it answers `expired`, `wrong_organization` and `below_min_spend`.
+ */
+export class PromotionCodeService {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    async resolveByCode(code) {
+        const em = this.emFactory();
+        // Legacy inline code on the promotion itself.
+        const legacy = await em.findOne(Promotion, { code, isActive: true });
+        if (legacy)
+            return toResolvedCode(legacy, null);
+        const coupon = await em.findOne(PromotionCoupon, { code, isActive: true });
+        if (!coupon)
+            return null;
+        // A live coupon whose promotion is not live is not a live code. Answering
+        // the coupon alone would let a cart accept a code that discounts nothing.
+        const promotion = await em.findOne(Promotion, { id: coupon.promotionId, isActive: true });
+        if (!promotion)
+            return null;
+        return toResolvedCode(promotion, coupon.id);
+    }
+}
+function toResolvedCode(promotion, couponId) {
+    return {
+        promotionId: promotion.id,
+        couponId,
+        name: promotion.name,
+        isActive: true,
+        validFrom: promotion.validFrom ?? null,
+        validUntil: promotion.validUntil ?? null,
+        organizationId: promotion.organizationId ?? null,
+        minCartSubtotal: promotion.minCartSubtotal ?? null,
+    };
+}
+//# sourceMappingURL=promotion-code-port.js.map

package/dist/backend/services/promotion-code-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-code-port.js","sourceRoot":"","sources":["../../../src/backend/services/promotion-code-port.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,oBAAoB;IACF;IAA7B,YAA6B,SAA8B;QAA9B,cAAS,GAAT,SAAS,CAAqB;IAAG,CAAC;IAE/D,KAAK,CAAC,aAAa,CAAC,IAAY;QAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAE5B,8CAA8C;QAC9C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,IAAI,MAAM;YAAE,OAAO,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1F,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAE5B,OAAO,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;CACF;AAED,SAAS,cAAc,CAAC,SAAoB,EAAE,QAAuB;IACnE,OAAO;QACL,WAAW,EAAE,SAAS,CAAC,EAAE;QACzB,QAAQ;QACR,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,IAAI;QACtC,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,IAAI;QACxC,cAAc,EAAE,SAAS,CAAC,cAAc,IAAI,IAAI;QAChD,eAAe,EAAE,SAAS,CAAC,eAAe,IAAI,IAAI;KACnD,CAAC;AACJ,CAAC"}

package/dist/backend/services/promotion-currency-reference.d.ts

@@ -0,0 +1,13 @@
+import type { DictionaryReferenceRegistryPort } from '@endora-commerce/contracts';
+import type { EntityManager } from '@mikro-orm/postgresql';
+/**
+ * Who in `promotions` still points at a currency (feature 077, D-87).
+ *
+ * `currencies` used to ask this with `select count(*) from "promotions"` of
+ * its own — this module's table, named in a string no import-level boundary
+ * check can see. The question is answered here now, against the table this
+ * module owns, and pushed into `currencyReferenceRegistry` from the boot
+ * hook.
+ */
+export declare function registerPromotionCurrencyReferences(registry: DictionaryReferenceRegistryPort, emFactory: () => EntityManager): void;
+//# sourceMappingURL=promotion-currency-reference.d.ts.map

package/dist/backend/services/promotion-currency-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-currency-reference.d.ts","sourceRoot":"","sources":["../../../src/backend/services/promotion-currency-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,+BAA+B,EACzC,SAAS,EAAE,MAAM,aAAa,GAC7B,IAAI,CAoBN"}

package/dist/backend/services/promotion-currency-reference.js

@@ -0,0 +1,25 @@
+/**
+ * Who in `promotions` still points at a currency (feature 077, D-87).
+ *
+ * `currencies` used to ask this with `select count(*) from "promotions"` of
+ * its own — this module's table, named in a string no import-level boundary
+ * check can see. The question is answered here now, against the table this
+ * module owns, and pushed into `currencyReferenceRegistry` from the boot
+ * hook.
+ */
+export function registerPromotionCurrencyReferences(registry, emFactory) {
+    registry.register({
+        ownerModuleId: 'promotions',
+        consumer: 'promotions',
+        tableName: 'promotions',
+        columnName: 'currency',
+        blocking: true,
+        countReferences: async (code) => {
+            const rows = (await emFactory().execute(`select count(*)::int as n from "promotions" where "currency" = ?`, [code]));
+            return rows[0]?.n ?? 0;
+        },
+        usedCodes: async () => (await emFactory().execute(`select "currency" as code, count(*)::int as count
+           from "promotions" where "currency" is not null group by "currency"`)),
+    });
+}
+//# sourceMappingURL=promotion-currency-reference.js.map

package/dist/backend/services/promotion-currency-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-currency-reference.js","sourceRoot":"","sources":["../../../src/backend/services/promotion-currency-reference.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,UAAU,mCAAmC,CACjD,QAAyC,EACzC,SAA8B;IAE9B,QAAQ,CAAC,QAAQ,CAAC;QAChB,aAAa,EAAE,YAAY;QAC3B,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,YAAY;QACvB,UAAU,EAAE,UAAU;QACtB,QAAQ,EAAE,IAAI;QACd,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,EAAE,CAAC,OAAO,CACrC,kEAAkE,EAClE,CAAC,IAAI,CAAC,CACP,CAAyB,CAAC;YAC3B,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,SAAS,EAAE,KAAK,IAAI,EAAE,CACpB,CAAC,MAAM,SAAS,EAAE,CAAC,OAAO,CACxB;8EACsE,CACvE,CAA2C;KAC/C,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/services/promotion-rule-evaluator.d.ts

@@ -0,0 +1,32 @@
+import type { PromotionRule, PromotionRuleValue } from '@endora-commerce/contracts';
+/**
+ * Feature 045 — pure evaluator for the typed promotion Rule AST.
+ *
+ * `evaluatePromotionRule(rule, ctx)` returns whether a cart satisfies the
+ * rule. It is pure (no clock, no I/O): the caller assembles the
+ * `PromotionRuleContext` from the cart snapshot. Attribute conditions are
+ * evaluated against an aggregated per-key value view of the cart; a
+ * condition over an attribute that has lost its promo-eligibility flag is
+ * treated as non-matching and reported through `onSkip` (FR-039 parity).
+ */
+export interface PromotionRuleContext {
+    cartTotal: number;
+    paymentMethodCode: string | null;
+    deliveryMethodCode: string | null;
+    deliveryCountry: string | null;
+    deliveryPostalCode: string | null;
+    organizationId: string | null;
+    customerGroupId: string | null;
+    /** Union of every line's category ids. */
+    categoryIds: readonly string[];
+    /** Per-attribute-key list of values present across cart lines. */
+    attributeValues: Readonly<Record<string, readonly PromotionRuleValue[]>>;
+    /** When provided, an attribute returning `false` is skipped (treated non-matching). */
+    isPromoEligibleAttribute?: (key: string) => boolean;
+    onSkip?: (info: {
+        attributeKey: string;
+        reason: 'attribute_not_promo_eligible';
+    }) => void;
+}
+export declare function evaluatePromotionRule(rule: PromotionRule, ctx: PromotionRuleContext): boolean;
+//# sourceMappingURL=promotion-rule-evaluator.d.ts.map

package/dist/backend/services/promotion-rule-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-rule-evaluator.d.ts","sourceRoot":"","sources":["../../../src/backend/services/promotion-rule-evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAGb,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,0CAA0C;IAC1C,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,kEAAkE;IAClE,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC,CAAC,CAAC;IACzE,uFAAuF;IACvF,wBAAwB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACpD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,8BAA8B,CAAA;KAAE,KAAK,IAAI,CAAC;CAC3F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAa7F"}

package/dist/backend/services/promotion-rule-evaluator.js

@@ -0,0 +1,131 @@
+export function evaluatePromotionRule(rule, ctx) {
+    switch (rule.kind) {
+        case 'all':
+            return true;
+        case 'group':
+            return rule.op === 'AND'
+                ? rule.children.every((child) => evaluatePromotionRule(child, ctx))
+                : rule.children.some((child) => evaluatePromotionRule(child, ctx));
+        case 'condition':
+            return evaluateCondition(rule, ctx);
+        default:
+            return false;
+    }
+}
+function evaluateCondition(cond, ctx) {
+    if (cond.field.kind === 'attribute') {
+        const key = cond.field.attributeKey;
+        if (ctx.isPromoEligibleAttribute && !ctx.isPromoEligibleAttribute(key)) {
+            ctx.onSkip?.({ attributeKey: key, reason: 'attribute_not_promo_eligible' });
+            return false;
+        }
+        const present = ctx.attributeValues[key] ?? [];
+        // Set-style operators compare the whole present-value set; scalar
+        // operators match if ANY present value satisfies the condition.
+        if (cond.op === 'in')
+            return present.some((v) => cond.values.includes(v));
+        if (cond.op === 'notIn')
+            return !present.some((v) => cond.values.includes(v));
+        return present.some((v) => matchScalar(v, cond.op, cond.values));
+    }
+    switch (cond.field.key) {
+        case 'cartTotal':
+            return matchScalar(ctx.cartTotal, cond.op, cond.values);
+        case 'paymentMethod':
+            return matchScalar(ctx.paymentMethodCode, cond.op, cond.values);
+        case 'deliveryMethod':
+            return matchScalar(ctx.deliveryMethodCode, cond.op, cond.values);
+        case 'deliveryCountry':
+            return matchScalar(ctx.deliveryCountry, cond.op, cond.values);
+        case 'deliveryPostalCode':
+            return matchScalar(ctx.deliveryPostalCode, cond.op, cond.values);
+        case 'organization':
+            return matchScalar(ctx.organizationId, cond.op, cond.values);
+        case 'customerGroup':
+            return matchScalar(ctx.customerGroupId, cond.op, cond.values);
+        case 'category':
+            return matchSet(ctx.categoryIds, cond.op, cond.values);
+        default:
+            return false;
+    }
+}
+/** Set membership for multi-valued subjects (e.g. category ids). */
+function matchSet(subject, op, values) {
+    const intersects = subject.some((s) => values.includes(s));
+    switch (op) {
+        case 'in':
+        case 'eq':
+            return intersects;
+        case 'notIn':
+        case 'neq':
+            return !intersects;
+        default:
+            return false;
+    }
+}
+/** Scalar comparison for a single (possibly null) subject. */
+function matchScalar(subject, op, values) {
+    switch (op) {
+        case 'eq':
+            return values.some((v) => looseEq(subject, v));
+        case 'neq':
+            return subject != null && !values.some((v) => looseEq(subject, v));
+        case 'in':
+            return subject != null && values.some((v) => looseEq(subject, v));
+        case 'notIn':
+            return subject != null && !values.some((v) => looseEq(subject, v));
+        case 'gt':
+        case 'gte':
+        case 'lt':
+        case 'lte':
+            return compareNumeric(subject, op, values[0]);
+        case 'between': {
+            const num = toNumber(subject);
+            const lo = toNumber(values[0]);
+            const hi = toNumber(values[1]);
+            if (num == null || lo == null || hi == null)
+                return false;
+            return num >= lo && num <= hi;
+        }
+        case 'contains':
+            return subject != null && values.some((v) => String(subject).includes(String(v)));
+        case 'startsWith':
+            return subject != null && values.some((v) => String(subject).startsWith(String(v)));
+        default:
+            return false;
+    }
+}
+function compareNumeric(subject, op, value) {
+    const a = toNumber(subject);
+    const b = toNumber(value);
+    if (a == null || b == null)
+        return false;
+    switch (op) {
+        case 'gt':
+            return a > b;
+        case 'gte':
+            return a >= b;
+        case 'lt':
+            return a < b;
+        case 'lte':
+            return a <= b;
+    }
+}
+function toNumber(v) {
+    if (v == null)
+        return null;
+    const n = typeof v === 'boolean' ? (v ? 1 : 0) : Number(v);
+    return Number.isFinite(n) ? n : null;
+}
+function looseEq(a, b) {
+    if (a == null)
+        return false;
+    if (typeof a === 'number' || typeof b === 'number') {
+        const na = toNumber(a);
+        const nb = toNumber(b);
+        if (na != null && nb != null)
+            return na === nb;
+    }
+    return String(a) === String(b);
+}
+//# sourceMappingURL=promotion-rule-evaluator.js.map

package/dist/backend/services/promotion-rule-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-rule-evaluator.js","sourceRoot":"","sources":["../../../src/backend/services/promotion-rule-evaluator.ts"],"names":[],"mappings":"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"}

package/dist/backend/services/promotion-rule-service.d.ts

@@ -0,0 +1,62 @@
+import type { CartLine, PromotionCriterion } from '@endora-commerce/contracts';
+/**
+ * Feature 012 / US8 — pure rule evaluator for the promotions module.
+ *
+ * `matches(criterion, line, ctx)` returns `true` iff the cart line
+ * satisfies the criterion. Today only the `attribute` variant carries
+ * line-level meaning; the other variants are routed through the
+ * existing flat eligibility filters in `PromotionService`.
+ *
+ * The function is pure — no clock, no I/O — so identical inputs always
+ * produce identical outputs. Attribute lookups MUST be passed in via
+ * `ctx.attributeLookup` to keep the evaluator deterministic and
+ * testable. The lookup is built once per `applyToCart` call.
+ *
+ * Skip-on-toggle (FR-039): when the looked-up attribute carries
+ * `isPromoRule = false`, the criterion is treated as `false` and the
+ * decision is logged once at `info` via `ctx.onSkip`.
+ */
+export interface PromotionRuleAttributeLookup {
+    /**
+     * Returns the attribute's metadata (with options) by key, or `null`
+     * if the attribute does not exist. The lookup is expected to be
+     * pre-populated by `PromotionService.applyToCart` for every key any
+     * active promotion's criteria reference.
+     */
+    get(key: string): {
+        id: string;
+        key: string;
+        valueType: 'string' | 'number' | 'boolean' | 'date' | 'enum' | 'select' | 'multiselect' | 'price';
+        isPromoRule: boolean;
+        options: Array<{
+            value: string;
+        }>;
+    } | null;
+}
+export interface PromotionRuleEvaluationContext {
+    attributeLookup: PromotionRuleAttributeLookup;
+    /** Hook fired when a criterion is skipped due to FR-039. */
+    onSkip?: (info: {
+        promotionId: string;
+        criterionAttributeKey: string;
+        reason: 'attribute_not_promo_eligible' | 'attribute_not_found';
+    }) => void;
+    /** Identifier passed to `onSkip` so the operator can correlate. */
+    promotionId: string;
+}
+/**
+ * Per-criterion match. Returns `true` if the line satisfies the
+ * criterion. For `attribute` criteria with `attributeValues` available
+ * on the cart line, the lookup is consulted to determine the operator
+ * vocabulary; if the attribute is missing or has `isPromoRule=false`
+ * the criterion is silently skipped (treated as `false` per FR-039).
+ */
+export declare function matches(criterion: PromotionCriterion, line: CartLine, ctx: PromotionRuleEvaluationContext): boolean;
+/**
+ * `lineMatchesAllCriteria(criteria, line, ctx)` — true iff every
+ * `attribute` / `category` / `product` criterion in the array matches
+ * the line. Cart-level criteria (`customerGroup`, `organization`) are
+ * always treated as `true` here (routed at the cart level instead).
+ */
+export declare function lineMatchesAllCriteria(criteria: readonly PromotionCriterion[], line: CartLine, ctx: PromotionRuleEvaluationContext): boolean;
+//# sourceMappingURL=promotion-rule-service.d.ts.map

package/dist/backend/services/promotion-rule-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-rule-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/promotion-rule-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAE/E;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EACL,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,MAAM,GACN,QAAQ,GACR,aAAa,GACb,OAAO,CAAC;QACZ,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnC,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,4BAA4B,CAAC;IAC9C,4DAA4D;IAC5D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,MAAM,EAAE,8BAA8B,GAAG,qBAAqB,CAAC;KAChE,KAAK,IAAI,CAAC;IACX,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,SAAS,EAAE,kBAAkB,EAC7B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,8BAA8B,GAClC,OAAO,CA6DT;AA2BD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,8BAA8B,GAClC,OAAO,CAKT"}

package/dist/backend/services/promotion-rule-service.js

@@ -0,0 +1,95 @@
+/**
+ * Per-criterion match. Returns `true` if the line satisfies the
+ * criterion. For `attribute` criteria with `attributeValues` available
+ * on the cart line, the lookup is consulted to determine the operator
+ * vocabulary; if the attribute is missing or has `isPromoRule=false`
+ * the criterion is silently skipped (treated as `false` per FR-039).
+ */
+export function matches(criterion, line, ctx) {
+    if (criterion.type === 'category') {
+        return criterion.categoryIds.some((id) => line.categoryIds.includes(id));
+    }
+    if (criterion.type === 'product') {
+        return criterion.productIds.includes(line.productId);
+    }
+    if (criterion.type === 'customerGroup' || criterion.type === 'organization') {
+        // Routed at the cart level; not a line-level filter.
+        return true;
+    }
+    // criterion.type === 'attribute'
+    const meta = ctx.attributeLookup.get(criterion.attributeKey);
+    if (!meta) {
+        ctx.onSkip?.({
+            promotionId: ctx.promotionId,
+            criterionAttributeKey: criterion.attributeKey,
+            reason: 'attribute_not_found',
+        });
+        return false;
+    }
+    if (!meta.isPromoRule) {
+        ctx.onSkip?.({
+            promotionId: ctx.promotionId,
+            criterionAttributeKey: criterion.attributeKey,
+            reason: 'attribute_not_promo_eligible',
+        });
+        return false;
+    }
+    const raw = line.attributeValues?.[criterion.attributeKey];
+    if (raw == null)
+        return false;
+    switch (criterion.op) {
+        case 'equals':
+            return scalarEquals(raw, criterion.values[0], meta.valueType);
+        case 'in':
+            if (Array.isArray(raw)) {
+                // multiselect — any-of semantics
+                return raw.some((v) => criterion.values.includes(v));
+            }
+            return criterion.values.includes(raw);
+        case 'range': {
+            const [min, max] = criterion.values;
+            if (meta.valueType === 'date') {
+                const r = Date.parse(String(raw));
+                const lo = Date.parse(String(min));
+                const hi = Date.parse(String(max));
+                if (!Number.isFinite(r) || !Number.isFinite(lo) || !Number.isFinite(hi))
+                    return false;
+                return r >= lo && r <= hi;
+            }
+            const num = Number(raw);
+            const lo = Number(min);
+            const hi = Number(max);
+            if (!Number.isFinite(num) || !Number.isFinite(lo) || !Number.isFinite(hi))
+                return false;
+            return num >= lo && num <= hi;
+        }
+        default:
+            return false;
+    }
+}
+function scalarEquals(raw, expected, valueType) {
+    if (valueType === 'number' || valueType === 'price') {
+        return Number(raw) === Number(expected);
+    }
+    if (valueType === 'boolean') {
+        return Boolean(raw) === Boolean(expected);
+    }
+    if (valueType === 'multiselect' && Array.isArray(raw)) {
+        return raw.length === 1 && raw[0] === expected;
+    }
+    return String(raw) === String(expected);
+}
+/**
+ * `lineMatchesAllCriteria(criteria, line, ctx)` — true iff every
+ * `attribute` / `category` / `product` criterion in the array matches
+ * the line. Cart-level criteria (`customerGroup`, `organization`) are
+ * always treated as `true` here (routed at the cart level instead).
+ */
+export function lineMatchesAllCriteria(criteria, line, ctx) {
+    for (const c of criteria) {
+        if (!matches(c, line, ctx))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=promotion-rule-service.js.map

package/dist/backend/services/promotion-rule-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-rule-service.js","sourceRoot":"","sources":["../../../src/backend/services/promotion-rule-service.ts"],"names":[],"mappings":"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"}

package/dist/backend/services/promotion-rule-store.d.ts

@@ -0,0 +1,33 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type PromotionRule } from '@endora-commerce/contracts';
+import { PromotionRuleEntity } from '../entities/promotion-rule.entity.js';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+/**
+ * Feature 045 (US6) — CRUD for standalone, named promotion rules and the
+ * dependency lookup used to surface / block deletion of in-use rules.
+ */
+export declare class PromotionRuleStore {
+    #private;
+    private readonly emFactory;
+    private readonly auditLog?;
+    constructor(emFactory: () => EntityManager, auditLog?: AuditPort | undefined);
+    list(): Promise<PromotionRuleEntity[]>;
+    getById(id: string): Promise<PromotionRuleEntity>;
+    /** Promotions referencing a named rule, for dependency surfacing (FR-019). */
+    usedBy(id: string): Promise<Array<{
+        id: string;
+        name: string;
+    }>>;
+    create(input: {
+        name: string;
+        description?: string | null;
+        definition: PromotionRule;
+    }): Promise<PromotionRuleEntity>;
+    update(id: string, input: {
+        name: string;
+        description?: string | null;
+        definition: PromotionRule;
+    }): Promise<PromotionRuleEntity>;
+    remove(id: string): Promise<void>;
+}
+//# sourceMappingURL=promotion-rule-store.d.ts.map

package/dist/backend/services/promotion-rule-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-rule-store.d.ts","sourceRoot":"","sources":["../../../src/backend/services/promotion-rule-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAG3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE;;;GAGG;AACH,qBAAa,kBAAkB;;IAE3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBADT,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,CAAC,EAAE,SAAS,YAAA;IAqBjC,IAAI,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAItC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMvD,8EAA8E;IACxE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAKhE,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiBrH,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,aAAa,CAAA;KAAE,GAC9E,OAAO,CAAC,mBAAmB,CAAC;IAgBzB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAexC"}

package/dist/backend/services/promotion-rule-store.js

@@ -0,0 +1,88 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { PromotionRuleEntity } from '../entities/promotion-rule.entity.js';
+import { Promotion } from '../entities/promotion.entity.js';
+import { recordAuditFromContext } from '@endora-commerce/platform/commands';
+/**
+ * Feature 045 (US6) — CRUD for standalone, named promotion rules and the
+ * dependency lookup used to surface / block deletion of in-use rules.
+ */
+export class PromotionRuleStore {
+    emFactory;
+    auditLog;
+    constructor(emFactory, auditLog) {
+        this.emFactory = emFactory;
+        this.auditLog = auditLog;
+    }
+    #audit(em, action, objectId, stateBefore, stateAfter) {
+        if (this.auditLog) {
+            recordAuditFromContext(this.auditLog, em, {
+                action,
+                objectType: 'promotion_rule',
+                objectId,
+                stateBefore,
+                stateAfter,
+            });
+        }
+    }
+    async list() {
+        return this.emFactory().find(PromotionRuleEntity, {}, { orderBy: { name: 'asc' } });
+    }
+    async getById(id) {
+        const row = await this.emFactory().findOne(PromotionRuleEntity, { id });
+        if (!row)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Rule ${id} not found.`);
+        return row;
+    }
+    /** Promotions referencing a named rule, for dependency surfacing (FR-019). */
+    async usedBy(id) {
+        const rows = await this.emFactory().find(Promotion, { ruleId: id }, { fields: ['id', 'name'] });
+        return rows.map((p) => ({ id: p.id, name: p.name }));
+    }
+    async create(input) {
+        const em = this.emFactory();
+        const existing = await em.findOne(PromotionRuleEntity, { name: input.name });
+        if (existing) {
+            throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, `rule_name_taken: ${input.name}`);
+        }
+        const row = em.create(PromotionRuleEntity, {
+            name: input.name,
+            description: input.description ?? null,
+            definition: input.definition,
+        });
+        em.persist(row);
+        this.#audit(em, 'promotion_rule.create', row.id, null, { name: row.name });
+        await em.flush();
+        return row;
+    }
+    async update(id, input) {
+        const em = this.emFactory();
+        const row = await em.findOne(PromotionRuleEntity, { id });
+        if (!row)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Rule ${id} not found.`);
+        if (input.name !== row.name) {
+            const clash = await em.findOne(PromotionRuleEntity, { name: input.name });
+            if (clash)
+                throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, `rule_name_taken: ${input.name}`);
+        }
+        row.name = input.name;
+        row.description = input.description ?? null;
+        row.definition = input.definition;
+        this.#audit(em, 'promotion_rule.update', row.id, null, { name: row.name });
+        await em.flush();
+        return row;
+    }
+    async remove(id) {
+        const em = this.emFactory();
+        const row = await em.findOne(PromotionRuleEntity, { id });
+        if (!row)
+            return;
+        const inUse = await this.usedBy(id);
+        if (inUse.length > 0) {
+            throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, `rule_in_use: referenced by ${inUse.length} promotion(s)`);
+        }
+        this.#audit(em, 'promotion_rule.delete', row.id, { name: row.name }, null);
+        await em.removeAndFlush(row);
+    }
+}
+//# sourceMappingURL=promotion-rule-store.js.map

package/dist/backend/services/promotion-rule-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-rule-store.js","sourceRoot":"","sources":["../../../src/backend/services/promotion-rule-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAsB,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAG5E;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAEV;IACA;IAFnB,YACmB,SAA8B,EAC9B,QAAoB;QADpB,cAAS,GAAT,SAAS,CAAqB;QAC9B,aAAQ,GAAR,QAAQ,CAAY;IACpC,CAAC;IAEJ,MAAM,CACJ,EAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,WAA2C,EAC3C,UAA0C;QAE1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE;gBACxC,MAAM;gBACN,UAAU,EAAE,gBAAgB;gBAC5B,QAAQ;gBACR,WAAW;gBACX,UAAU;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACnF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAChG,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAA+E;QAC1F,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7E,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,iBAAiB,EAAE,oBAAoB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,EAAE;YACzC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;YACtC,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC,CAAC;QACH,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,uBAAuB,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,MAAM,CACV,EAAU,EACV,KAA+E;QAE/E,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACnF,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1E,IAAI,KAAK;gBAAE,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,iBAAiB,EAAE,oBAAoB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACvG,CAAC;QACD,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACtB,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC;QAC5C,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,uBAAuB,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,iBAAiB,EAC7B,8BAA8B,KAAK,CAAC,MAAM,eAAe,CAC1D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,uBAAuB,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3E,MAAM,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;CACF"}