@endora-commerce/mod-promotions 0.100.0

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

@@ -0,0 +1,194 @@
+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';
+/**
+ * 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.
+ */
+let Promotion = class Promotion {
+    [OptionalProps];
+    id = randomUUID();
+    code;
+    name;
+    /** Legacy effect kind — nullable on feature-045 action-based promotions. */
+    kind;
+    /** Legacy effect value — nullable on feature-045 action-based promotions. */
+    value;
+    currency;
+    minCartSubtotal;
+    validFrom;
+    validUntil;
+    organizationId;
+    customerGroupId;
+    categoryId;
+    productId;
+    /**
+     * 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 = [];
+    isActive = true;
+    // --- Feature 045 — engine fields -----------------------------------------
+    description;
+    /** Application order across a cart's matching promotions (DESC). */
+    priority = 0;
+    /** When true, no lower-priority promotion applies once this one does. */
+    stopFurther = false;
+    /** Registered action key (null on legacy kind/value promotions). */
+    actionType;
+    /** Action parameters, validated against the registered action's schema. */
+    actionConfig = {};
+    /** Named-rule reference (mutually exclusive with `ruleDefinition`). */
+    ruleId;
+    /** Inline rule AST (mutually exclusive with `ruleId`). */
+    ruleDefinition;
+    usageLimitGlobal;
+    usageLimitPerOrganization;
+    usageLimitPerCustomer;
+    createdAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], Promotion.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'string', length: 64, nullable: true }),
+    Unique(),
+    __metadata("design:type", Object)
+], Promotion.prototype, "code", void 0);
+__decorate([
+    Property({ type: 'string', length: 160 }),
+    __metadata("design:type", String)
+], Promotion.prototype, "name", void 0);
+__decorate([
+    Property({ type: 'string', length: 24, nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], Promotion.prototype, "kind", void 0);
+__decorate([
+    Property({ type: 'decimal', precision: 14, scale: 4, nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "value", void 0);
+__decorate([
+    Property({ type: 'string', length: 3, nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "currency", void 0);
+__decorate([
+    Property({ type: 'decimal', precision: 14, scale: 2, nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "minCartSubtotal", void 0);
+__decorate([
+    Property({ type: 'datetime', nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "validFrom", void 0);
+__decorate([
+    Property({ type: 'datetime', nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "validUntil", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], Promotion.prototype, "organizationId", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], Promotion.prototype, "customerGroupId", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "categoryId", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "productId", void 0);
+__decorate([
+    Property({ type: 'json', columnType: 'jsonb', default: "'[]'" }),
+    __metadata("design:type", Array)
+], Promotion.prototype, "criteria", void 0);
+__decorate([
+    Property({ type: 'boolean' }),
+    Index(),
+    __metadata("design:type", Boolean)
+], Promotion.prototype, "isActive", void 0);
+__decorate([
+    Property({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "description", void 0);
+__decorate([
+    Property({ type: 'integer', default: 0 }),
+    Index(),
+    __metadata("design:type", Number)
+], Promotion.prototype, "priority", void 0);
+__decorate([
+    Property({ type: 'boolean', default: false }),
+    __metadata("design:type", Boolean)
+], Promotion.prototype, "stopFurther", void 0);
+__decorate([
+    Property({ type: 'string', length: 64, nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "actionType", void 0);
+__decorate([
+    Property({ type: 'json', columnType: 'jsonb', default: "'{}'" }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "actionConfig", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], Promotion.prototype, "ruleId", void 0);
+__decorate([
+    Property({ type: 'json', columnType: 'jsonb', nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "ruleDefinition", void 0);
+__decorate([
+    Property({ type: 'integer', nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "usageLimitGlobal", void 0);
+__decorate([
+    Property({ type: 'integer', nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "usageLimitPerOrganization", void 0);
+__decorate([
+    Property({ type: 'integer', nullable: true }),
+    __metadata("design:type", Object)
+], Promotion.prototype, "usageLimitPerCustomer", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], Promotion.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], Promotion.prototype, "updatedAt", void 0);
+Promotion = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'promotions' })
+], Promotion);
+export { Promotion };
+//# sourceMappingURL=promotion.entity.js.map

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

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

package/dist/backend/index.d.ts

@@ -0,0 +1,124 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { ChannelMemberEntityType } from '@endora-commerce/contracts';
+import type { CatalogProductReadPort, CatalogPromoAttributePort, DictionaryValidator } from '@endora-commerce/contracts';
+import type { AuditPort, ModuleContext, OrganizationReadPort, RequireAdminFactory, SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
+import { PromotionService } from './services/promotion-service.js';
+import { Promotion } from './entities/promotion.entity.js';
+import { PromotionRuleEntity } from './entities/promotion-rule.entity.js';
+import { PromotionCoupon } from './entities/promotion-coupon.entity.js';
+import { CouponBatch } from './entities/coupon-batch.entity.js';
+import { PromotionUsage } from './entities/promotion-usage.entity.js';
+import { PromotionUsageCounter } from './entities/promotion-usage-counter.entity.js';
+import { CouponService } from './services/coupon-service.js';
+import { PromotionRuleStore } from './services/promotion-rule-store.js';
+import { PromotionStatsService } from './services/promotion-stats-service.js';
+import type { PromotionRuleTargetPorts } from './routes.js';
+/**
+ * `promotions` — six optional arguments, four of which were gates (feature 072,
+ * wave 2, T115; closed by issue #251).
+ *
+ * The one worth naming was `resolveOrganizationStatus`, documented as
+ * *"Defaults to 'skip' the gate when omitted (legacy composition)"*. Feature 026
+ * US5 exists so an org-targeted promotion only fires for an **active**
+ * Organization — a blocked or moderated customer should not keep receiving
+ * negotiated discounts. Omitting the resolver skipped that check entirely, so
+ * the promotion applied to every organization regardless of status.
+ *
+ * `salesChannelMembership`, `dictionaryValidator` and `auditLog` were the same
+ * story in quieter registers: without the first a new promotion bound to no
+ * channel and `applyToCart` did no channel filtering at all, without the second
+ * an unknown currency code was stored, without the third the write was
+ * unrecorded.
+ *
+ * All four are required arguments now. Both roots always passed them, so
+ * nothing was live — but `test/helpers/promotion-service.ts` passed none of
+ * them, so ten suites asserted against a service four gates quieter than the
+ * composed one. That is what an optional dependency production always supplies
+ * costs: the absent branch is untested by construction and only tests ever run
+ * it.
+ *
+ * **One bundle stays in the root**, for the reason `megamenu`'s did.
+ * `ruleTargets` reads `organizations`, `categories`, `payment_methods` and
+ * `delivery_methods` tables directly; it belongs to modules that have not
+ * converted, and pulling it in would give this module reads of storage it does
+ * not own.
+ *
+ * `catalogQueryPort` used to be the second, and this comment used to say the
+ * honest end state was for the two methods this module reached on
+ * `CatalogQueryService` to move behind a narrower port. Feature 075's Phase P
+ * did exactly that: `catalogPromoAttributePort` is those two questions, and
+ * `catalogProductReadPort` is the per-line attribute hydration that used to be
+ * an `em.find(Product, …)`. Both are resolved by contract type here.
+ */
+export interface PromotionsCradle {
+    /**
+     * Feature 120 (FR-015) — the platform's channel-bridge registry, resolved by
+     * **container name** rather than imported. The shape is the narrow one this
+     * module needs, which is what `ctx.cradle<C>()` asks an author to declare;
+     * the registry itself is the kernel's and is published on no barrel.
+     */
+    readonly salesChannelBridgeRegistry: {
+        register(bridge: {
+            entityType: ChannelMemberEntityType;
+            table: string;
+            entityIdColumn: string;
+        }): void;
+    };
+    readonly emFactory: () => EntityManager;
+    readonly auditLogService: AuditPort;
+    readonly requireAdmin: RequireAdminFactory;
+    readonly salesChannelMembershipPort: SalesChannelMembershipPort;
+    readonly dictionaryValidator: DictionaryValidator;
+    /** Owned by `catalog`: the two promo-attribute questions the Rule Builder asks. */
+    readonly catalogPromoAttributePort: CatalogPromoAttributePort;
+    /** Owned by `catalog`: the product rows a cart line's attribute values come from. */
+    readonly catalogProductReadPort: CatalogProductReadPort;
+    /**
+     * The tenancy read port — the gate that keeps a suspended org out (T138).
+     * Was `organizationStatusResolver`, a raw `select "status" from
+     * "organizations"` each root spelled by hand against another module's table.
+     */
+    readonly organizationReadPort: OrganizationReadPort;
+    /** Rule Builder picker sources; root-shaped, reads four other modules' tables. */
+    readonly promotionRuleTargets: PromotionRuleTargetPorts;
+    readonly promotionService: PromotionService;
+    readonly promotionCouponService: CouponService;
+    readonly promotionRuleStore: PromotionRuleStore;
+    readonly promotionStatsService: PromotionStatsService;
+}
+export declare function registerModule(ctx: ModuleContext): void;
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ *
+ * Six classes, and `promotion_usages` is the one that had to be shown to keep a
+ * foreign key without a named export (D-169): `promotion_usages_order_fk` runs
+ * into `orders.id`, and a constraint is between two column names — it needs the
+ * **table**, never the class. Nothing another module can legitimately do with
+ * `PromotionUsage` is lost. D-32 forbids an ORM relation into it; what `orders`
+ * actually needs is the *method* placement calls, which leaves this package as
+ * `PromotionUsageFinalizer` on the type-only `./ports` subpath.
+ */
+export declare const entities: (typeof Promotion | typeof PromotionRuleEntity | typeof PromotionCoupon | typeof CouponBatch | typeof PromotionUsage | typeof PromotionUsageCounter)[];
+/**
+ * The sales-channel membership bridge this module owns (feature 120, FR-015).
+ *
+ * Exported as well as registered because the owning module is the only honest
+ * source for it: a caller that composes no platform — the bare-database test
+ * harness, which constructs the kernel's membership service directly — declares
+ * these from here rather than from a list of nine it keeps itself, which is
+ * exactly the total map this feature deleted.
+ */
+export declare const salesChannelBridges: ReadonlyArray<{
+    readonly entityType: ChannelMemberEntityType;
+    readonly table: string;
+    readonly entityIdColumn: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EAGzB,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC3B,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAErF,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAG5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,0BAA0B,EAAE;QACnC,QAAQ,CAAC,MAAM,EAAE;YACf,UAAU,EAAE,uBAAuB,CAAC;YACpC,KAAK,EAAE,MAAM,CAAC;YACd,cAAc,EAAE,MAAM,CAAC;SACxB,GAAG,IAAI,CAAC;KACV,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,0BAA0B,EAAE,0BAA0B,CAAC;IAChE,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD,mFAAmF;IACnF,QAAQ,CAAC,yBAAyB,EAAE,yBAAyB,CAAC;IAC9D,qFAAqF;IACrF,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IACxD;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IACpD,kFAAkF;IAClF,QAAQ,CAAC,oBAAoB,EAAE,wBAAwB,CAAC;IACxD,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,sBAAsB,EAAE,aAAa,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;CACvD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA+KvD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,QAAQ,wJAOpB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,CAEA,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,182 @@
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { PromotionService } from './services/promotion-service.js';
+import { Promotion } from './entities/promotion.entity.js';
+import { PromotionRuleEntity } from './entities/promotion-rule.entity.js';
+import { PromotionCoupon } from './entities/promotion-coupon.entity.js';
+import { CouponBatch } from './entities/coupon-batch.entity.js';
+import { PromotionUsage } from './entities/promotion-usage.entity.js';
+import { PromotionUsageCounter } from './entities/promotion-usage-counter.entity.js';
+import { PromotionCodeService } from './services/promotion-code-port.js';
+import { CouponService } from './services/coupon-service.js';
+import { PromotionRuleStore } from './services/promotion-rule-store.js';
+import { PromotionStatsService } from './services/promotion-stats-service.js';
+import { registerPromotionRoutes } from './routes.js';
+import { registerPromotionCurrencyReferences } from './services/promotion-currency-reference.js';
+export function registerModule(ctx) {
+    /**
+     * Feature 120 (FR-015) — the sales-channel membership bridge this module owns.
+     *
+     * The platform used to hold a map **total** over
+     * `ChannelMemberEntityTypeSchema`, naming this module's bridge table from
+     * inside the kernel. That is D-52/D-53's prohibition expressed in a contract
+     * instead of an import, and it meant a membership call for 'promotion' on an
+     * instance that never installed this module executed SQL against a relation
+     * that is not there (D-226). The module whose migration creates the table is
+     * the one that says where it is; a member nothing registers now refuses at
+     * the call instead.
+     *
+     * A **contribution** hook and deliberately **unprobed** (D-62/D-68): a
+     * registration is an inert statement about the schema rather than a
+     * capability, the rows outlive an operator switching this module off, and
+     * probing would make a runtime activation flip require a restart. It is
+     * declared first in this module so any later hook of its own that binds a
+     * membership finds the bridge already there.
+     */
+    ctx.onBoot(() => {
+        const { salesChannelBridgeRegistry } = ctx.cradle();
+        for (const bridge of salesChannelBridges)
+            salesChannelBridgeRegistry.register(bridge);
+    });
+    ctx.di.register({
+        // Contribution point: a composition with no picker sources gets empty
+        // pickers, not a broken Rule Builder.
+        promotionRuleTargets: ctx
+            .asFunction(() => ({}))
+            .singleton(),
+        promotionCouponService: ctx
+            .asFunction(({ emFactory, auditLogService }) => new CouponService(emFactory, auditLogService))
+            .singleton(),
+        promotionRuleStore: ctx
+            .asFunction(({ emFactory, auditLogService }) => new PromotionRuleStore(emFactory, auditLogService))
+            .singleton(),
+        promotionStatsService: ctx
+            .asFunction(({ emFactory }) => new PromotionStatsService(emFactory))
+            .singleton(),
+    });
+    /**
+     * Feature 075, Phase P — the coupon-resolution port.
+     *
+     * `carts` reaches both promotion entities for one question: is this code
+     * live, and which promotion is it? The three-step lookup behind it — the
+     * legacy inline code, then the coupon table, then the promotion behind the
+     * coupon, each filtered on `isActive` — is this module's, and reproducing it
+     * in `carts` meant reproducing it correctly.
+     */
+    ctx.di.providePort('promotionCodePort', ctx
+        .asFunction(({ emFactory }) => new PromotionCodeService(emFactory))
+        .singleton());
+    /**
+     * D-94.5 — the co-transactional half of the promotion seam, as its own
+     * gated port.
+     *
+     * `orders` used to reach `finalizeUsage` through `promotionService`, typed
+     * by an interface `orders` wrote itself: `lazyPort<T>` is an unchecked cast,
+     * so with `T` on the consumer's side nothing verified that this module still
+     * satisfied it. The interface is `PromotionUsageFinalizer` and it is this
+     * module's to declare — `../ports/index.ts`, published on the type-only
+     * `./ports` subpath (R8), because the signature carries the caller's
+     * `EntityManager` and FR-034 keeps a MikroORM type out of
+     * `@endora-commerce/contracts`.
+     *
+     * It was declared beside the implementation until this module became a
+     * package, and `orders` reached it by a relative path — a `permanent: true`
+     * cross-module ledger entry naming `promotion_usages_order_fk`. D-171 retires
+     * that entry rather than the seam: a subpath the owner declared is contract
+     * surface, so the import is a package dependency and not a reach into
+     * internals. The foreign key, the transaction and the `EntityManager`
+     * parameter are all exactly where they were.
+     */
+    ctx.di.providePort('promotionUsageFinalizer', ctx
+        .asFunction(() => {
+        // Lazily, even though this module owns the name: `providePort` gates
+        // on the effective state, and a singleton that captured its own gate
+        // would answer after an operator switched this module off.
+        const service = lazyPort(ctx, 'promotionService');
+        return {
+            finalizeUsage: (em, input) => service.finalizeUsage(em, input),
+        };
+    })
+        .singleton());
+    ctx.di.providePort('promotionService', ctx
+        .asFunction(({ emFactory, auditLogService }) => new PromotionService(emFactory, 
+    // Every argument up to and including `auditLog` is required
+    // (issues #164 and #251): each is resolved for every composition,
+    // so the type no longer says otherwise. `auditLogger` and
+    // `actionRegistry` follow, and are the only two with a default —
+    // both are genuine defaults (a console sink, the built-in action
+    // catalogue), not gates an omission opens.
+    lazyPort(ctx, 'catalogPromoAttributePort'), lazyPort(ctx, 'catalogProductReadPort'), lazyPort(ctx, 'salesChannelMembershipPort'), lazyPort(ctx, 'dictionaryValidator'), async (orgId) => (await ctx
+        .cradle()
+        .organizationReadPort.loadEffectiveOrganization(orgId))?.status ?? null, auditLogService))
+        .singleton());
+    ctx.routes(async (app) => {
+        const { promotionCouponService, promotionRuleStore, promotionStatsService, requireAdmin, promotionRuleTargets, } = ctx.cradle();
+        await registerPromotionRoutes(app, {
+            // Lazily, even though the module owns this port: route *registration* runs
+            // inside `buildServer` whatever the module's effective state is, so
+            // destructuring the gate here would stop the next start instead of
+            // stopping the routes (D-40).
+            promotionService: lazyPort(ctx, 'promotionService'),
+            couponService: promotionCouponService,
+            ruleStore: promotionRuleStore,
+            statsService: promotionStatsService,
+            requireAdmin,
+            catalogPromoAttributes: lazyPort(ctx, 'catalogPromoAttributePort'),
+            ruleTargets: promotionRuleTargets,
+        });
+    });
+    /**
+     * This module's rows carry a currency code, so it answers "who still points at
+     * this currency?" about its own tables (feature 077, D-87), where the owner used
+     * to count them with SQL naming this module's tables.
+     *
+     * A **contribution** hook: it pushes an inert descriptor into `currencyReferenceRegistry`,
+     * an ungated registry, and carries no presence probe (D-62/D-68). Probing
+     * would be wrong in the dangerous direction — a switched-off module still owns
+     * the rows, so its currency must still refuse the delete, which is the
+     * enumeration policy the registry states.
+     */
+    ctx.onBoot(() => {
+        registerPromotionCurrencyReferences(lazyPort(ctx, 'currencyReferenceRegistry'), ctx.cradle().emFactory);
+    });
+}
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ *
+ * Six classes, and `promotion_usages` is the one that had to be shown to keep a
+ * foreign key without a named export (D-169): `promotion_usages_order_fk` runs
+ * into `orders.id`, and a constraint is between two column names — it needs the
+ * **table**, never the class. Nothing another module can legitimately do with
+ * `PromotionUsage` is lost. D-32 forbids an ORM relation into it; what `orders`
+ * actually needs is the *method* placement calls, which leaves this package as
+ * `PromotionUsageFinalizer` on the type-only `./ports` subpath.
+ */
+export const entities = [
+    Promotion,
+    PromotionRuleEntity,
+    PromotionCoupon,
+    CouponBatch,
+    PromotionUsage,
+    PromotionUsageCounter,
+];
+/**
+ * The sales-channel membership bridge this module owns (feature 120, FR-015).
+ *
+ * Exported as well as registered because the owning module is the only honest
+ * source for it: a caller that composes no platform — the bare-database test
+ * harness, which constructs the kernel's membership service directly — declares
+ * these from here rather than from a list of nine it keeps itself, which is
+ * exactly the total map this feature deleted.
+ */
+export const salesChannelBridges = [
+    { entityType: 'promotion', table: 'sales_channel_promotions', entityIdColumn: 'promotion_id' },
+];
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

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

package/dist/backend/routes.d.ts

@@ -0,0 +1,88 @@
+import type { FastifyInstance } from 'fastify';
+import type { PromotionService } from './services/promotion-service.js';
+import type { CouponService } from './services/coupon-service.js';
+import type { PromotionRuleStore } from './services/promotion-rule-store.js';
+import type { PromotionStatsService } from './services/promotion-stats-service.js';
+/**
+ * List ports feeding the Rule Builder pickers (feature 045, US1/T033).
+ *
+ * Declared here rather than in a module factory since feature 072 (T115): the
+ * factory is gone, and these are the routes' own option shape. Every member is
+ * optional because a composition may know how to list some target kinds and not
+ * others — an absent one yields an empty picker rather than a broken screen.
+ */
+export interface PromotionRuleTargetPorts {
+    salesChannels?: () => Promise<Array<{
+        id: string;
+        code: string;
+        name: string;
+    }>>;
+    customerGroups?: () => Promise<Array<{
+        id: string;
+        code: string;
+        name: string;
+    }>>;
+    organizations?: () => Promise<Array<{
+        id: string;
+        name: string;
+        taxId: string | null;
+    }>>;
+    categories?: () => Promise<Array<{
+        id: string;
+        slug: string;
+        name: string;
+        parentCategoryId: string | null;
+    }>>;
+    paymentMethods?: () => Promise<Array<{
+        id: string;
+        code: string;
+        name: string;
+    }>>;
+    deliveryMethods?: () => Promise<Array<{
+        id: string;
+        code: string;
+        name: string;
+    }>>;
+}
+import type { CatalogPromoAttributePort } from '@endora-commerce/contracts';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+export interface PromotionRoutesDeps {
+    promotionService: PromotionService;
+    couponService: CouponService;
+    ruleStore: PromotionRuleStore;
+    statsService: PromotionStatsService;
+    requireAdmin: RequireAdminFactory;
+    /**
+     * Feature 012 / US8 — feeds the rule-target picker endpoint. Since feature
+     * 075's Phase C this is `catalogPromoAttributePort`, the two questions this
+     * picker asks, rather than `catalog`'s 1400-line storefront query service.
+     *
+     * **Required** (issue #164), for the reason the two ports on
+     * `PromotionService` are. It was optional and the one call site there is —
+     * `backend.ts`, through `lazyPort('catalogPromoAttributePort')` — always
+     * supplied it, so the absent branch had never run; what it would have run
+     * was `503 { code: 'service_unavailable' }`, a code written nowhere else in
+     * the repository, in no `ERROR_CODES`, with no translation and no admin
+     * handler. That made it a second spelling of one absence, and the platform
+     * already spells that absence once: `lazyPort` resolves inside the forwarded
+     * call, so an owner that is not there throws `ModuleDisabledError` and the
+     * envelope answers 503 `MODULE_DISABLED` naming the module. Here even that
+     * cannot happen — `catalog` declares `activation.nonDeactivatable`, so the
+     * gate on this port has no closed state — which leaves exactly one absence
+     * this route can see, and it is the one `getAttributeWithOptions` already
+     * says in its return type: `null`, no such attribute.
+     */
+    catalogPromoAttributes: CatalogPromoAttributePort;
+    /**
+     * Feature 045 (T033) — list ports for the remaining rule-target pickers.
+     *
+     * The bundle is required and its **members** are not: the container
+     * registers `promotionRuleTargets` with a `{}` default that a composition
+     * root contributes over, so the routes always receive one, while which
+     * picker kinds it knows how to list stays the composition's business
+     * (issue #164 again — the outer `?.` guarded nothing).
+     */
+    ruleTargets: PromotionRuleTargetPorts;
+}
+export declare function registerPromotionRoutes(app: FastifyInstance, deps: PromotionRoutesDeps): Promise<void>;
+//# sourceMappingURL=routes.d.ts.map

package/dist/backend/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/backend/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAS/C,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,iCAAiC,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAc,MAAM,uCAAuC,CAAC;AAE/F;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACjF,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAClF,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;IACzF,UAAU,CAAC,EAAE,MAAM,OAAO,CACxB,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CACnF,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAClF,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACpF;AAMD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,YAAY,EAAE,qBAAqB,CAAC;IACpC,YAAY,EAAE,mBAAmB,CAAC;IAClC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,sBAAsB,EAAE,yBAAyB,CAAC;IAClD;;;;;;;;OAQG;IACH,WAAW,EAAE,wBAAwB,CAAC;CACvC;AAED,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAwQf"}