@endora-commerce/mod-promotions 0.100.0

package/dist/backend/entities/coupon-batch.entity.js

@@ -0,0 +1,78 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * Feature 045 — generator config for a batch of coupon codes (US4).
+ */
+let CouponBatch = class CouponBatch {
+    [OptionalProps];
+    id = randomUUID();
+    promotionId;
+    count;
+    length;
+    /** `alnum` | `digits` | `letters`. */
+    format;
+    prefix;
+    suffix;
+    /** Insert a dash every N characters; 0 = none. */
+    dashEvery = 0;
+    /** `per_coupon` | `shared_batch`. */
+    limitScope;
+    createdAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], CouponBatch.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    Index(),
+    __metadata("design:type", String)
+], CouponBatch.prototype, "promotionId", void 0);
+__decorate([
+    Property({ type: 'integer' }),
+    __metadata("design:type", Number)
+], CouponBatch.prototype, "count", void 0);
+__decorate([
+    Property({ type: 'integer' }),
+    __metadata("design:type", Number)
+], CouponBatch.prototype, "length", void 0);
+__decorate([
+    Property({ type: 'string', length: 16 }),
+    __metadata("design:type", String)
+], CouponBatch.prototype, "format", void 0);
+__decorate([
+    Property({ type: 'string', length: 32, nullable: true }),
+    __metadata("design:type", Object)
+], CouponBatch.prototype, "prefix", void 0);
+__decorate([
+    Property({ type: 'string', length: 32, nullable: true }),
+    __metadata("design:type", Object)
+], CouponBatch.prototype, "suffix", void 0);
+__decorate([
+    Property({ type: 'integer', default: 0 }),
+    __metadata("design:type", Number)
+], CouponBatch.prototype, "dashEvery", void 0);
+__decorate([
+    Property({ type: 'string', length: 16 }),
+    __metadata("design:type", String)
+], CouponBatch.prototype, "limitScope", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], CouponBatch.prototype, "createdAt", void 0);
+CouponBatch = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'coupon_batches' })
+], CouponBatch);
+export { CouponBatch };
+//# sourceMappingURL=coupon-batch.entity.js.map

package/dist/backend/entities/coupon-batch.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coupon-batch.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/coupon-batch.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;GAEG;AAGI,IAAM,WAAW,GAAjB,MAAM,WAAW;IACtB,CAAC,aAAa,CAAC,CAA0D;IAGzE,EAAE,GAAW,UAAU,EAAE,CAAC;IAI1B,WAAW,CAAU;IAGrB,KAAK,CAAU;IAGf,MAAM,CAAU;IAEhB,sCAAsC;IAEtC,MAAM,CAAkC;IAGxC,MAAM,CAAiB;IAGvB,MAAM,CAAiB;IAEvB,kDAAkD;IAElD,SAAS,GAAW,CAAC,CAAC;IAEtB,qCAAqC;IAErC,UAAU,CAAiC;IAG3C,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AAhCC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;uCACH;AAI1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE;;gDACa;AAGrB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;0CACf;AAGf;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;2CACd;AAIhB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;2CACD;AAGxC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2CAClC;AAGvB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;2CAClC;AAIvB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;8CACpB;AAItB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;+CACE;AAG3C;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;8CAAc;AAnClB,WAAW;IAFvB,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;GAC3B,WAAW,CAoCvB"}

package/dist/backend/entities/promotion-coupon.entity.d.ts

@@ -0,0 +1,17 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * Feature 045 — an individual coupon code gating a promotion. Either a
+ * single specified code (`batchId` null) or one of a generated batch.
+ */
+export declare class PromotionCoupon {
+    [OptionalProps]?: 'id' | 'createdAt' | 'batchId' | 'isActive';
+    id: string;
+    promotionId: string;
+    batchId?: string | null;
+    code: string;
+    /** `per_coupon` | `shared_batch` — denormalized from the batch. */
+    limitScope: 'per_coupon' | 'shared_batch';
+    isActive: boolean;
+    createdAt: Date;
+}
+//# sourceMappingURL=promotion-coupon.entity.d.ts.map

package/dist/backend/entities/promotion-coupon.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-coupon.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/promotion-coupon.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAI7F;;;GAGG;AACH,qBAEa,eAAe;IAC1B,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IAG9D,EAAE,EAAE,MAAM,CAAgB;IAI1B,WAAW,EAAG,MAAM,CAAC;IAIrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAIxB,IAAI,EAAG,MAAM,CAAC;IAEd,mEAAmE;IAEnE,UAAU,EAAG,YAAY,GAAG,cAAc,CAAC;IAG3C,QAAQ,EAAE,OAAO,CAAQ;IAGzB,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/promotion-coupon.entity.js

@@ -0,0 +1,64 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property, Unique } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * Feature 045 — an individual coupon code gating a promotion. Either a
+ * single specified code (`batchId` null) or one of a generated batch.
+ */
+let PromotionCoupon = class PromotionCoupon {
+    [OptionalProps];
+    id = randomUUID();
+    promotionId;
+    batchId;
+    code;
+    /** `per_coupon` | `shared_batch` — denormalized from the batch. */
+    limitScope;
+    isActive = true;
+    createdAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], PromotionCoupon.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    Index(),
+    __metadata("design:type", String)
+], PromotionCoupon.prototype, "promotionId", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], PromotionCoupon.prototype, "batchId", void 0);
+__decorate([
+    Property({ type: 'string', length: 80 }),
+    Unique(),
+    __metadata("design:type", String)
+], PromotionCoupon.prototype, "code", void 0);
+__decorate([
+    Property({ type: 'string', length: 16 }),
+    __metadata("design:type", String)
+], PromotionCoupon.prototype, "limitScope", void 0);
+__decorate([
+    Property({ type: 'boolean', default: true }),
+    __metadata("design:type", Boolean)
+], PromotionCoupon.prototype, "isActive", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], PromotionCoupon.prototype, "createdAt", void 0);
+PromotionCoupon = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'promotion_coupons' })
+], PromotionCoupon);
+export { PromotionCoupon };
+//# sourceMappingURL=promotion-coupon.entity.js.map

package/dist/backend/entities/promotion-coupon.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-coupon.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/promotion-coupon.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;GAGG;AAGI,IAAM,eAAe,GAArB,MAAM,eAAe;IAC1B,CAAC,aAAa,CAAC,CAA+C;IAG9D,EAAE,GAAW,UAAU,EAAE,CAAC;IAI1B,WAAW,CAAU;IAIrB,OAAO,CAAiB;IAIxB,IAAI,CAAU;IAEd,mEAAmE;IAEnE,UAAU,CAAiC;IAG3C,QAAQ,GAAY,IAAI,CAAC;IAGzB,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AAvBC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;2CACH;AAI1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE;;oDACa;AAIrB;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1C,KAAK,EAAE;;gDACgB;AAIxB;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxC,MAAM,EAAE;;6CACK;AAId;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;mDACE;AAG3C;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;iDACpB;AAGzB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;kDAAc;AA1BlB,eAAe;IAF3B,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;GAC9B,eAAe,CA2B3B"}

package/dist/backend/entities/promotion-rule.entity.d.ts

@@ -0,0 +1,16 @@
+import { OptionalProps } from '@mikro-orm/core';
+import type { PromotionRule } from '@endora-commerce/contracts';
+/**
+ * Feature 045 — a standalone, named promotion rule reusable across
+ * promotions. Referenced by `promotions.rule_id`.
+ */
+export declare class PromotionRuleEntity {
+    [OptionalProps]?: 'id' | 'createdAt' | 'updatedAt' | 'description';
+    id: string;
+    name: string;
+    description?: string | null;
+    definition: PromotionRule;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=promotion-rule.entity.d.ts.map

package/dist/backend/entities/promotion-rule.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-rule.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/promotion-rule.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAG7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;GAGG;AACH,qBAEa,mBAAmB;IAC9B,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;IAGnE,EAAE,EAAE,MAAM,CAAgB;IAI1B,IAAI,EAAG,MAAM,CAAC;IAGd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG5B,UAAU,EAAG,aAAa,CAAC;IAI3B,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/promotion-rule.entity.js

@@ -0,0 +1,57 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property, Unique } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * Feature 045 — a standalone, named promotion rule reusable across
+ * promotions. Referenced by `promotions.rule_id`.
+ */
+let PromotionRuleEntity = class PromotionRuleEntity {
+    [OptionalProps];
+    id = randomUUID();
+    name;
+    description;
+    definition;
+    createdAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], PromotionRuleEntity.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'string', length: 160 }),
+    Unique(),
+    __metadata("design:type", String)
+], PromotionRuleEntity.prototype, "name", void 0);
+__decorate([
+    Property({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], PromotionRuleEntity.prototype, "description", void 0);
+__decorate([
+    Property({ type: 'json', columnType: 'jsonb' }),
+    __metadata("design:type", Object)
+], PromotionRuleEntity.prototype, "definition", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    Index(),
+    __metadata("design:type", Date)
+], PromotionRuleEntity.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], PromotionRuleEntity.prototype, "updatedAt", void 0);
+PromotionRuleEntity = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'promotion_rules' })
+], PromotionRuleEntity);
+export { PromotionRuleEntity };
+//# sourceMappingURL=promotion-rule.entity.js.map

package/dist/backend/entities/promotion-rule.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-rule.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/promotion-rule.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC;;;GAGG;AAGI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B,CAAC,aAAa,CAAC,CAAoD;IAGnE,EAAE,GAAW,UAAU,EAAE,CAAC;IAI1B,IAAI,CAAU;IAGd,WAAW,CAAiB;IAG5B,UAAU,CAAiB;IAI3B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;IAG7B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AAlBC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;+CACH;AAI1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACzC,MAAM,EAAE;;iDACK;AAGd;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wDACf;AAG5B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;;uDACrB;AAI3B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;IAC1D,KAAK,EAAE;8BACG,IAAI;sDAAc;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;sDAAc;AArBlB,mBAAmB;IAF/B,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;GAC5B,mBAAmB,CAsB/B"}

package/dist/backend/entities/promotion-usage-counter.entity.d.ts

@@ -0,0 +1,15 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * Feature 045 — authoritative per-scope usage counter for atomic cap
+ * enforcement (US5). Incremented inside the order-placement transaction via
+ * `UPDATE ... WHERE count < limit` so the last available use is race-safe.
+ */
+export declare class PromotionUsageCounter {
+    [OptionalProps]?: 'id' | 'count';
+    id: string;
+    /** `global` | `organization` | `customer` | `coupon` | `batch`. */
+    scopeType: 'global' | 'organization' | 'customer' | 'coupon' | 'batch';
+    scopeKey: string;
+    count: number;
+}
+//# sourceMappingURL=promotion-usage-counter.entity.d.ts.map

package/dist/backend/entities/promotion-usage-counter.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-usage-counter.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/promotion-usage-counter.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAItF;;;;GAIG;AACH,qBAGa,qBAAqB;IAChC,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;IAGjC,EAAE,EAAE,MAAM,CAAgB;IAE1B,mEAAmE;IAEnE,SAAS,EAAG,QAAQ,GAAG,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IAGxE,QAAQ,EAAG,MAAM,CAAC;IAGlB,KAAK,EAAE,MAAM,CAAK;CACnB"}

package/dist/backend/entities/promotion-usage-counter.entity.js

@@ -0,0 +1,48 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, OptionalProps, PrimaryKey, Property, Unique } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * Feature 045 — authoritative per-scope usage counter for atomic cap
+ * enforcement (US5). Incremented inside the order-placement transaction via
+ * `UPDATE ... WHERE count < limit` so the last available use is race-safe.
+ */
+let PromotionUsageCounter = class PromotionUsageCounter {
+    [OptionalProps];
+    id = randomUUID();
+    /** `global` | `organization` | `customer` | `coupon` | `batch`. */
+    scopeType;
+    scopeKey;
+    count = 0;
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], PromotionUsageCounter.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'string', length: 16 }),
+    __metadata("design:type", String)
+], PromotionUsageCounter.prototype, "scopeType", void 0);
+__decorate([
+    Property({ type: 'string', length: 128 }),
+    __metadata("design:type", String)
+], PromotionUsageCounter.prototype, "scopeKey", void 0);
+__decorate([
+    Property({ type: 'integer', default: 0 }),
+    __metadata("design:type", Number)
+], PromotionUsageCounter.prototype, "count", void 0);
+PromotionUsageCounter = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'promotion_usage_counters' }),
+    Unique({ properties: ['scopeType', 'scopeKey'] })
+], PromotionUsageCounter);
+export { PromotionUsageCounter };
+//# sourceMappingURL=promotion-usage-counter.entity.js.map

package/dist/backend/entities/promotion-usage-counter.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-usage-counter.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/promotion-usage-counter.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;GAIG;AAII,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,CAAC,aAAa,CAAC,CAAkB;IAGjC,EAAE,GAAW,UAAU,EAAE,CAAC;IAE1B,mEAAmE;IAEnE,SAAS,CAA+D;IAGxE,QAAQ,CAAU;IAGlB,KAAK,GAAW,CAAC,CAAC;CACnB,CAAA;AAXC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;iDACH;AAI1B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;wDAC+B;AAGxE;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;uDACxB;AAGlB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;oDACxB;AAdP,qBAAqB;IAHjC,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,0BAA0B,EAAE,CAAC;IACjD,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC;GACrC,qBAAqB,CAejC"}

package/dist/backend/entities/promotion-usage.entity.d.ts

@@ -0,0 +1,21 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * Feature 045 — a finalized redemption of a promotion/coupon, written on
+ * order placement (US5). Denormalized dimensions feed the statistics
+ * aggregates (US7).
+ */
+export declare class PromotionUsage {
+    [OptionalProps]?: 'id' | 'createdAt' | 'couponId' | 'customerAccountId' | 'organizationId' | 'customerGroupId';
+    id: string;
+    promotionId: string;
+    couponId?: string | null;
+    orderId: string;
+    customerAccountId?: string | null;
+    organizationId?: string | null;
+    customerGroupId?: string | null;
+    salesChannelId: string;
+    discountAmount: string;
+    currency: string;
+    createdAt: Date;
+}
+//# sourceMappingURL=promotion-usage.entity.d.ts.map

package/dist/backend/entities/promotion-usage.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-usage.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/promotion-usage.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAI7F;;;;GAIG;AACH,qBAGa,cAAc;IACzB,CAAC,aAAa,CAAC,CAAC,EACZ,IAAI,GACJ,WAAW,GACX,UAAU,GACV,mBAAmB,GACnB,gBAAgB,GAChB,iBAAiB,CAAC;IAGtB,EAAE,EAAE,MAAM,CAAgB;IAI1B,WAAW,EAAG,MAAM,CAAC;IAIrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGzB,OAAO,EAAG,MAAM,CAAC;IAIjB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAIlC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAI/B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAIhC,cAAc,EAAG,MAAM,CAAC;IAGxB,cAAc,EAAG,MAAM,CAAC;IAGxB,QAAQ,EAAG,MAAM,CAAC;IAIlB,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/promotion-usage.entity.js

@@ -0,0 +1,89 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property, Unique } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * Feature 045 — a finalized redemption of a promotion/coupon, written on
+ * order placement (US5). Denormalized dimensions feed the statistics
+ * aggregates (US7).
+ */
+let PromotionUsage = class PromotionUsage {
+    [OptionalProps];
+    id = randomUUID();
+    promotionId;
+    couponId;
+    orderId;
+    customerAccountId;
+    organizationId;
+    customerGroupId;
+    salesChannelId;
+    discountAmount;
+    currency;
+    createdAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], PromotionUsage.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    Index(),
+    __metadata("design:type", String)
+], PromotionUsage.prototype, "promotionId", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], PromotionUsage.prototype, "couponId", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    __metadata("design:type", String)
+], PromotionUsage.prototype, "orderId", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], PromotionUsage.prototype, "customerAccountId", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], PromotionUsage.prototype, "organizationId", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], PromotionUsage.prototype, "customerGroupId", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    Index(),
+    __metadata("design:type", String)
+], PromotionUsage.prototype, "salesChannelId", void 0);
+__decorate([
+    Property({ type: 'decimal', precision: 14, scale: 2 }),
+    __metadata("design:type", String)
+], PromotionUsage.prototype, "discountAmount", void 0);
+__decorate([
+    Property({ type: 'string', length: 3 }),
+    __metadata("design:type", String)
+], PromotionUsage.prototype, "currency", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    Index(),
+    __metadata("design:type", Date)
+], PromotionUsage.prototype, "createdAt", void 0);
+PromotionUsage = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'promotion_usages' }),
+    Unique({ properties: ['orderId', 'promotionId'] })
+], PromotionUsage);
+export { PromotionUsage };
+//# sourceMappingURL=promotion-usage.entity.js.map

package/dist/backend/entities/promotion-usage.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-usage.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/promotion-usage.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;GAIG;AAII,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB,CAAC,aAAa,CAAC,CAMO;IAGtB,EAAE,GAAW,UAAU,EAAE,CAAC;IAI1B,WAAW,CAAU;IAIrB,QAAQ,CAAiB;IAGzB,OAAO,CAAU;IAIjB,iBAAiB,CAAiB;IAIlC,cAAc,CAAiB;IAI/B,eAAe,CAAiB;IAIhC,cAAc,CAAU;IAGxB,cAAc,CAAU;IAGxB,QAAQ,CAAU;IAIlB,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AAtCC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;0CACH;AAI1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE;;mDACa;AAIrB;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1C,KAAK,EAAE;;gDACiB;AAGzB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;+CACV;AAIjB;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1C,KAAK,EAAE;;yDAC0B;AAIlC;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1C,KAAK,EAAE;;sDACuB;AAI/B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1C,KAAK,EAAE;;uDACwB;AAIhC;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE;;sDACgB;AAGxB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;;sDAC/B;AAGxB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;;gDACtB;AAIlB;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;IAC1D,KAAK,EAAE;8BACG,IAAI;iDAAc;AA/ClB,cAAc;IAH1B,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IACzC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,CAAC;GACtC,cAAc,CAgD1B"}

package/dist/backend/entities/promotion.entity.d.ts

@@ -0,0 +1,63 @@
+import { OptionalProps } from '@mikro-orm/core';
+import type { PromotionAction, PromotionCriterion, PromotionRule } from '@endora-commerce/contracts';
+/**
+ * Promotion — a discount rule applied to a Cart snapshot (T129 / FR-052).
+ *
+ * Three kinds of effect:
+ *   - `percentage_off`  — `value` 0..100, applied to either the cart subtotal
+ *                          or the lines matching the optional category/product
+ *                          scope.
+ *   - `amount_off`      — `value` is money in `currency`.
+ *   - `free_delivery`   — zero out the cart's delivery cost.
+ *
+ * Eligibility filters: `code`, `minCartSubtotal`, `validFrom`/`validUntil`,
+ * `organizationId` / `customerGroupId`, `categoryId` / `productId`.
+ *
+ * Inactive (`isActive=false`) promotions are skipped without being deleted —
+ * useful for re-enabling seasonally.
+ */
+export declare class Promotion {
+    [OptionalProps]?: 'id' | 'createdAt' | 'updatedAt' | 'code' | 'currency' | 'minCartSubtotal' | 'validFrom' | 'validUntil' | 'organizationId' | 'customerGroupId' | 'categoryId' | 'productId' | 'criteria' | 'isActive' | 'description' | 'priority' | 'stopFurther' | 'actionType' | 'actionConfig' | 'ruleId' | 'ruleDefinition' | 'usageLimitGlobal' | 'usageLimitPerOrganization' | 'usageLimitPerCustomer';
+    id: string;
+    code?: string | null;
+    name: string;
+    /** Legacy effect kind — nullable on feature-045 action-based promotions. */
+    kind?: 'percentage_off' | 'amount_off' | 'free_delivery' | null;
+    /** Legacy effect value — nullable on feature-045 action-based promotions. */
+    value?: string | null;
+    currency?: string | null;
+    minCartSubtotal?: string | null;
+    validFrom?: Date | null;
+    validUntil?: Date | null;
+    organizationId?: string | null;
+    customerGroupId?: string | null;
+    categoryId?: string | null;
+    productId?: string | null;
+    /**
+     * Feature 012 / US8 — line-level discriminated criteria. ANDed with
+     * the flat `categoryId` / `productId` scope. JSONB column with default
+     * `'[]'::jsonb` so existing rows behave exactly as before until the
+     * operator authors a criterion.
+     */
+    criteria: PromotionCriterion[];
+    isActive: boolean;
+    description?: string | null;
+    /** Application order across a cart's matching promotions (DESC). */
+    priority: number;
+    /** When true, no lower-priority promotion applies once this one does. */
+    stopFurther: boolean;
+    /** Registered action key (null on legacy kind/value promotions). */
+    actionType?: PromotionAction['type'] | null;
+    /** Action parameters, validated against the registered action's schema. */
+    actionConfig: Record<string, unknown>;
+    /** Named-rule reference (mutually exclusive with `ruleDefinition`). */
+    ruleId?: string | null;
+    /** Inline rule AST (mutually exclusive with `ruleId`). */
+    ruleDefinition?: PromotionRule | null;
+    usageLimitGlobal?: number | null;
+    usageLimitPerOrganization?: number | null;
+    usageLimitPerCustomer?: number | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=promotion.entity.d.ts.map

package/dist/backend/entities/promotion.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/promotion.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAG7F,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAErG;;;;;;;;;;;;;;;GAeG;AACH,qBAEa,SAAS;IACpB,CAAC,aAAa,CAAC,CAAC,EACZ,IAAI,GACJ,WAAW,GACX,WAAW,GACX,MAAM,GACN,UAAU,GACV,iBAAiB,GACjB,WAAW,GACX,YAAY,GACZ,gBAAgB,GAChB,iBAAiB,GACjB,YAAY,GACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,aAAa,GACb,UAAU,GACV,aAAa,GACb,YAAY,GACZ,cAAc,GACd,QAAQ,GACR,gBAAgB,GAChB,kBAAkB,GAClB,2BAA2B,GAC3B,uBAAuB,CAAC;IAG5B,EAAE,EAAE,MAAM,CAAgB;IAI1B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,IAAI,EAAG,MAAM,CAAC;IAEd,4EAA4E;IAG5E,IAAI,CAAC,EAAE,gBAAgB,GAAG,YAAY,GAAG,eAAe,GAAG,IAAI,CAAC;IAEhE,6EAA6E;IAE7E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGzB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGhC,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAGxB,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAIzB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAI/B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGhC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;;OAKG;IAEH,QAAQ,EAAE,kBAAkB,EAAE,CAAM;IAIpC,QAAQ,EAAE,OAAO,CAAQ;IAKzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,oEAAoE;IAGpE,QAAQ,EAAE,MAAM,CAAK;IAErB,yEAAyE;IAEzE,WAAW,EAAE,OAAO,CAAS;IAE7B,oEAAoE;IAEpE,UAAU,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAE5C,2EAA2E;IAE3E,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAE3C,uEAAuE;IAGvE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,0DAA0D;IAE1D,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAGtC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGjC,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG1C,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGtC,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}