@endora-commerce/mod-promotions 0.100.0

package/dist/backend/routes.js

@@ -0,0 +1,256 @@
+import { bulkCouponActiveRequestSchema, cartSnapshotSchema, generateCouponsRequestSchema, upsertPromotionRequestSchema, upsertPromotionRuleRequestSchema, } from '@endora-commerce/contracts';
+import { promotionStatsGroupBySchema } from '@endora-commerce/contracts';
+import { PROMOTION_PERMISSIONS } from '../manifest.js';
+export async function registerPromotionRoutes(app, deps) {
+    const { promotionService, couponService, ruleStore, statsService, requireAdmin, catalogPromoAttributes, ruleTargets, } = deps;
+    const parseStatsQuery = (q) => {
+        const out = {};
+        if (typeof q['from'] === 'string')
+            out.from = q['from'];
+        if (typeof q['to'] === 'string')
+            out.to = q['to'];
+        const gb = promotionStatsGroupBySchema.safeParse(q['groupBy']);
+        if (gb.success)
+            out.groupBy = gb.data;
+        return out;
+    };
+    const readGate = requireAdmin(PROMOTION_PERMISSIONS.READ);
+    const writeGate = requireAdmin(PROMOTION_PERMISSIONS.WRITE);
+    const deleteGate = requireAdmin(PROMOTION_PERMISSIONS.DELETE);
+    app.get('/api/v1/admin/promotions', { preHandler: readGate }, async () => {
+        const rows = await promotionService.list();
+        return { data: rows.map(serialize) };
+    });
+    app.get('/api/v1/admin/promotions/:id', { preHandler: readGate }, async (request) => {
+        const row = await promotionService.getById(request.params.id);
+        return { data: serialize(row) };
+    });
+    // Feature 045 — action catalogue introspection for the admin action picker.
+    app.get('/api/v1/admin/promotions/action-types', { preHandler: readGate }, async () => {
+        return { data: { items: promotionService.listActionTypes() } };
+    });
+    // Feature 045 (US6) — standalone named rules.
+    app.get('/api/v1/admin/promotion-rules', { preHandler: readGate }, async () => {
+        const rows = await ruleStore.list();
+        return { data: rows.map(serializeRule) };
+    });
+    app.get('/api/v1/admin/promotion-rules/:id', { preHandler: readGate }, async (request) => {
+        const row = await ruleStore.getById(request.params.id);
+        const usedBy = await ruleStore.usedBy(request.params.id);
+        return { data: serializeRule(row), usedBy };
+    });
+    app.post('/api/v1/admin/promotion-rules', { preHandler: writeGate, schema: { body: upsertPromotionRuleRequestSchema } }, async (request, reply) => {
+        const body = upsertPromotionRuleRequestSchema.parse(request.body);
+        const row = await ruleStore.create({
+            name: body.name,
+            ...(body.description !== undefined ? { description: body.description } : {}),
+            definition: body.definition,
+        });
+        reply.status(201);
+        return { data: serializeRule(row) };
+    });
+    app.put('/api/v1/admin/promotion-rules/:id', { preHandler: writeGate, schema: { body: upsertPromotionRuleRequestSchema } }, async (request) => {
+        const body = upsertPromotionRuleRequestSchema.parse(request.body);
+        const row = await ruleStore.update(request.params.id, {
+            name: body.name,
+            ...(body.description !== undefined ? { description: body.description } : {}),
+            definition: body.definition,
+        });
+        return { data: serializeRule(row) };
+    });
+    app.delete('/api/v1/admin/promotion-rules/:id', { preHandler: deleteGate }, async (request, reply) => {
+        await ruleStore.remove(request.params.id);
+        return reply.status(204).send();
+    });
+    app.post('/api/v1/admin/promotions', { preHandler: writeGate, schema: { body: upsertPromotionRequestSchema } }, async (request, reply) => {
+        const body = upsertPromotionRequestSchema.parse(request.body);
+        const row = await promotionService.upsert(toUpsertInput(body));
+        reply.status(201);
+        return { data: serialize(row) };
+    });
+    app.put('/api/v1/admin/promotions/:id', { preHandler: writeGate, schema: { body: upsertPromotionRequestSchema } }, async (request) => {
+        const body = upsertPromotionRequestSchema.parse(request.body);
+        const row = await promotionService.updateById(request.params.id, toUpsertInput(body));
+        return { data: serialize(row) };
+    });
+    // Feature 012 / US8 — picker payload for the Promotion Rule editor.
+    app.get('/api/v1/admin/promotions/rule-targets/attributes', { preHandler: readGate }, async () => {
+        const keys = await catalogPromoAttributes.promoRuleAttributeKeys();
+        const items = [];
+        for (const k of keys) {
+            const meta = await catalogPromoAttributes.getAttributeWithOptions(k);
+            if (!meta)
+                continue;
+            const isSelectStyle = meta.valueType === 'select' ||
+                meta.valueType === 'enum' ||
+                meta.valueType === 'multiselect';
+            items.push({
+                id: meta.id,
+                key: meta.key,
+                label: meta.label,
+                labelDefault: meta.labelDefault,
+                valueType: meta.valueType,
+                ...(isSelectStyle ? { options: meta.options } : {}),
+            });
+        }
+        return { data: { items } };
+    });
+    // Feature 045 (US3) — single coupon management for a promotion.
+    app.get('/api/v1/admin/promotions/:id/coupons', { preHandler: readGate }, async (request) => {
+        const coupons = await couponService.listForPromotion(request.params.id);
+        return { data: coupons.map(serializeCoupon) };
+    });
+    app.post('/api/v1/admin/promotions/:id/coupons', { preHandler: writeGate }, async (request, reply) => {
+        const code = typeof request.body?.code === 'string' ? request.body.code.trim() : '';
+        if (!code) {
+            reply.status(400);
+            return { error: { code: 'validation_failed', message: 'code is required' } };
+        }
+        const coupon = await couponService.createSingle(request.params.id, code);
+        reply.status(201);
+        return { data: serializeCoupon(coupon) };
+    });
+    // Bulk activate/deactivate selected coupons of a promotion.
+    app.post('/api/v1/admin/promotions/:id/coupons/bulk-active', { preHandler: writeGate, schema: { body: bulkCouponActiveRequestSchema } }, async (request) => {
+        const body = bulkCouponActiveRequestSchema.parse(request.body);
+        const updated = await couponService.setActiveBulk(request.params.id, body.couponIds, body.isActive);
+        return { data: { updated } };
+    });
+    // Feature 045 (US4) — bulk coupon generator.
+    app.post('/api/v1/admin/promotions/:id/coupon-batches', { preHandler: writeGate, schema: { body: generateCouponsRequestSchema } }, async (request, reply) => {
+        const body = generateCouponsRequestSchema.parse(request.body);
+        const result = await couponService.generateBatch(request.params.id, body);
+        reply.status(201);
+        return { data: { batch: { id: result.batch.id }, generated: result.generated } };
+    });
+    app.get('/api/v1/admin/promotions/:id/coupon-batches/:batchId/export', { preHandler: readGate, config: { streamingResponse: true } }, async (request, reply) => {
+        const codes = await couponService.listBatchCodes(request.params.batchId);
+        reply.header('content-type', 'text/csv; charset=utf-8');
+        reply.header('content-disposition', `attachment; filename="coupons-${request.params.batchId}.csv"`);
+        return reply.send(`code\n${codes.join('\n')}\n`);
+    });
+    // Feature 045 (T033) — rule-target pickers feeding the Rule Builder.
+    app.get('/api/v1/admin/promotions/rule-targets/sales-channels', { preHandler: readGate }, async () => ({
+        data: { items: (await ruleTargets.salesChannels?.()) ?? [] },
+    }));
+    app.get('/api/v1/admin/promotions/rule-targets/customer-groups', { preHandler: readGate }, async () => ({
+        data: { items: (await ruleTargets.customerGroups?.()) ?? [] },
+    }));
+    app.get('/api/v1/admin/promotions/rule-targets/organizations', { preHandler: readGate }, async () => ({
+        data: { items: (await ruleTargets.organizations?.()) ?? [] },
+    }));
+    app.get('/api/v1/admin/promotions/rule-targets/categories', { preHandler: readGate }, async () => ({
+        data: { items: (await ruleTargets.categories?.()) ?? [] },
+    }));
+    app.get('/api/v1/admin/promotions/rule-targets/payment-methods', { preHandler: readGate }, async () => ({
+        data: { items: (await ruleTargets.paymentMethods?.()) ?? [] },
+    }));
+    app.get('/api/v1/admin/promotions/rule-targets/delivery-methods', { preHandler: readGate }, async () => ({
+        data: { items: (await ruleTargets.deliveryMethods?.()) ?? [] },
+    }));
+    app.delete('/api/v1/admin/promotions/:id', { preHandler: deleteGate }, async (request, reply) => {
+        await promotionService.remove(request.params.id);
+        return reply.status(204).send();
+    });
+    // Feature 045 (US7) — usage statistics.
+    app.get('/api/v1/admin/promotions/:id/stats', { preHandler: readGate }, async (request) => {
+        const data = await statsService.forPromotion(request.params.id, parseStatsQuery(request.query ?? {}));
+        return { data };
+    });
+    app.get('/api/v1/admin/promotions/coupons/:couponId/stats', { preHandler: readGate }, async (request) => {
+        const data = await statsService.forCoupon(request.params.couponId, parseStatsQuery(request.query ?? {}));
+        return { data };
+    });
+    app.post('/api/v1/admin/promotions/preview', { preHandler: readGate, schema: { body: cartSnapshotSchema } }, async (request) => {
+        const snapshot = cartSnapshotSchema.parse(request.body);
+        const result = await promotionService.applyToCart(snapshot);
+        return { data: result };
+    });
+}
+/** Pass through validated request fields into the service input. */
+function toUpsertInput(body) {
+    return {
+        name: body.name,
+        ...(body.code !== undefined ? { code: body.code } : {}),
+        ...(body.kind !== undefined ? { kind: body.kind } : {}),
+        ...(body.value !== undefined ? { value: body.value } : {}),
+        ...(body.currency !== undefined ? { currency: body.currency } : {}),
+        ...(body.minCartSubtotal !== undefined ? { minCartSubtotal: body.minCartSubtotal } : {}),
+        ...(body.validFrom !== undefined ? { validFrom: body.validFrom } : {}),
+        ...(body.validUntil !== undefined ? { validUntil: body.validUntil } : {}),
+        ...(body.organizationId !== undefined ? { organizationId: body.organizationId } : {}),
+        ...(body.customerGroupId !== undefined ? { customerGroupId: body.customerGroupId } : {}),
+        ...(body.categoryId !== undefined ? { categoryId: body.categoryId } : {}),
+        ...(body.productId !== undefined ? { productId: body.productId } : {}),
+        ...(body.criteria !== undefined ? { criteria: body.criteria } : {}),
+        ...(body.isActive !== undefined ? { isActive: body.isActive } : {}),
+        ...(body.description !== undefined ? { description: body.description } : {}),
+        ...(body.priority !== undefined ? { priority: body.priority } : {}),
+        ...(body.stopFurther !== undefined ? { stopFurther: body.stopFurther } : {}),
+        ...(body.action !== undefined ? { action: body.action } : {}),
+        ...(body.ruleId !== undefined ? { ruleId: body.ruleId } : {}),
+        ...(body.rule !== undefined ? { rule: body.rule } : {}),
+        ...(body.usageLimitGlobal !== undefined ? { usageLimitGlobal: body.usageLimitGlobal } : {}),
+        ...(body.usageLimitPerOrganization !== undefined
+            ? { usageLimitPerOrganization: body.usageLimitPerOrganization }
+            : {}),
+        ...(body.usageLimitPerCustomer !== undefined
+            ? { usageLimitPerCustomer: body.usageLimitPerCustomer }
+            : {}),
+    };
+}
+function serializeRule(r) {
+    return {
+        id: r.id,
+        name: r.name,
+        description: r.description ?? null,
+        definition: r.definition,
+        createdAt: r.createdAt.toISOString(),
+        updatedAt: r.updatedAt.toISOString(),
+    };
+}
+function serializeCoupon(c) {
+    return {
+        id: c.id,
+        promotionId: c.promotionId,
+        batchId: c.batchId ?? null,
+        code: c.code,
+        limitScope: c.limitScope,
+        isActive: c.isActive,
+        createdAt: c.createdAt.toISOString(),
+    };
+}
+function serialize(row) {
+    const action = row.actionType
+        ? { type: row.actionType, ...row.actionConfig }
+        : null;
+    return {
+        id: row.id,
+        code: row.code ?? null,
+        name: row.name,
+        kind: row.kind ?? null,
+        value: row.value != null ? Number(row.value) : null,
+        currency: row.currency ?? null,
+        minCartSubtotal: row.minCartSubtotal != null ? Number(row.minCartSubtotal) : null,
+        validFrom: row.validFrom?.toISOString() ?? null,
+        validUntil: row.validUntil?.toISOString() ?? null,
+        organizationId: row.organizationId ?? null,
+        customerGroupId: row.customerGroupId ?? null,
+        categoryId: row.categoryId ?? null,
+        productId: row.productId ?? null,
+        criteria: row.criteria ?? [],
+        isActive: row.isActive,
+        description: row.description ?? null,
+        priority: row.priority,
+        stopFurther: row.stopFurther,
+        action,
+        ruleId: row.ruleId ?? null,
+        rule: row.ruleDefinition ?? null,
+        usageLimitGlobal: row.usageLimitGlobal ?? null,
+        usageLimitPerOrganization: row.usageLimitPerOrganization ?? null,
+        usageLimitPerCustomer: row.usageLimitPerCustomer ?? null,
+        createdAt: row.createdAt.toISOString(),
+        updatedAt: row.updatedAt.toISOString(),
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/backend/routes.js.map

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

package/dist/backend/services/coupon-service.d.ts

@@ -0,0 +1,40 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type GenerateCouponsRequest } from '@endora-commerce/contracts';
+import { PromotionCoupon } from '../entities/promotion-coupon.entity.js';
+import { CouponBatch } from '../entities/coupon-batch.entity.js';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+/** Hard cap on a single generated batch (avoids a speculative queue, Principle X). */
+export declare const COUPON_BATCH_MAX = 50000;
+export declare function buildCouponCode(req: GenerateCouponsRequest): string;
+/**
+ * Feature 045 (US3/US4) — coupon management. Single specified coupons land
+ * here with a globally-unique `code`; the generator (US4) bulk-inserts into
+ * the same table. The engine and the cart coupon flow resolve a presented
+ * code to its promotion through `findByCode`.
+ */
+export declare class CouponService {
+    #private;
+    private readonly emFactory;
+    private readonly auditLog?;
+    constructor(emFactory: () => EntityManager, auditLog?: AuditPort | undefined);
+    listForPromotion(promotionId: string): Promise<PromotionCoupon[]>;
+    findByCode(code: string): Promise<PromotionCoupon | null>;
+    /**
+     * Bulk activate/deactivate coupons by id, scoped to a promotion so an id from
+     * another promotion can never be flipped. Returns the number of rows updated.
+     */
+    setActiveBulk(promotionId: string, couponIds: string[], isActive: boolean): Promise<number>;
+    /** Create a single specified coupon for a promotion. Rejects duplicates. */
+    createSingle(promotionId: string, code: string): Promise<PromotionCoupon>;
+    /**
+     * Generate a batch of unique coupon codes (US4). Uniqueness is guaranteed
+     * in-batch via a Set and cross-batch via a DB existence check + regenerate;
+     * the `code` UNIQUE constraint is the final backstop.
+     */
+    generateBatch(promotionId: string, req: GenerateCouponsRequest): Promise<{
+        batch: CouponBatch;
+        generated: number;
+    }>;
+    listBatchCodes(batchId: string): Promise<string[]>;
+}
+//# sourceMappingURL=coupon-service.d.ts.map

package/dist/backend/services/coupon-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coupon-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/coupon-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAe,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGtF,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAsBvC,wBAAgB,eAAe,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAGnE;AAED;;;;;GAKG;AACH,qBAAa,aAAa;;IAEtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBADT,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,CAAC,EAAE,SAAS,YAAA;IAoBjC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAQjE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI/D;;;OAGG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC;IAalB,4EAA4E;IACtE,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAuB/E;;;;OAIG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IA4E/C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAQzD"}

package/dist/backend/services/coupon-service.js

@@ -0,0 +1,178 @@
+import { randomInt } from 'node:crypto';
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { Promotion } from '../entities/promotion.entity.js';
+import { PromotionCoupon } from '../entities/promotion-coupon.entity.js';
+import { CouponBatch } from '../entities/coupon-batch.entity.js';
+import { recordAuditFromContext } from '@endora-commerce/platform/commands';
+/** Hard cap on a single generated batch (avoids a speculative queue, Principle X). */
+export const COUPON_BATCH_MAX = 50_000;
+const ALPHABETS = {
+    // Crockford-ish alphabet — no ambiguous I/O/0/1.
+    alnum: 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789',
+    digits: '0123456789',
+    letters: 'ABCDEFGHJKLMNPQRSTUVWXYZ',
+};
+function randomBody(length, alphabet) {
+    let out = '';
+    for (let i = 0; i < length; i += 1)
+        out += alphabet[randomInt(alphabet.length)];
+    return out;
+}
+function insertDashes(body, every) {
+    if (!every || every <= 0)
+        return body;
+    const parts = [];
+    for (let i = 0; i < body.length; i += every)
+        parts.push(body.slice(i, i + every));
+    return parts.join('-');
+}
+export function buildCouponCode(req) {
+    const body = insertDashes(randomBody(req.length, ALPHABETS[req.format]), req.dashEvery ?? 0);
+    return `${req.prefix ?? ''}${body}${req.suffix ?? ''}`;
+}
+/**
+ * Feature 045 (US3/US4) — coupon management. Single specified coupons land
+ * here with a globally-unique `code`; the generator (US4) bulk-inserts into
+ * the same table. The engine and the cart coupon flow resolve a presented
+ * code to its promotion through `findByCode`.
+ */
+export class CouponService {
+    emFactory;
+    auditLog;
+    constructor(emFactory, auditLog) {
+        this.emFactory = emFactory;
+        this.auditLog = auditLog;
+    }
+    #audit(em, action, objectId, stateAfter) {
+        if (this.auditLog) {
+            recordAuditFromContext(this.auditLog, em, {
+                action,
+                objectType: 'promotion',
+                objectId,
+                stateBefore: null,
+                stateAfter,
+            });
+        }
+    }
+    async listForPromotion(promotionId) {
+        return this.emFactory().find(PromotionCoupon, { promotionId }, { orderBy: { createdAt: 'asc' } });
+    }
+    async findByCode(code) {
+        return this.emFactory().findOne(PromotionCoupon, { code, isActive: true });
+    }
+    /**
+     * Bulk activate/deactivate coupons by id, scoped to a promotion so an id from
+     * another promotion can never be flipped. Returns the number of rows updated.
+     */
+    async setActiveBulk(promotionId, couponIds, isActive) {
+        if (couponIds.length === 0)
+            return 0;
+        const em = this.emFactory();
+        const coupons = await em.find(PromotionCoupon, {
+            id: { $in: couponIds },
+            promotionId,
+        });
+        for (const c of coupons)
+            c.isActive = isActive;
+        this.#audit(em, 'coupon.set_active_bulk', promotionId, { isActive, count: coupons.length });
+        await em.flush();
+        return coupons.length;
+    }
+    /** Create a single specified coupon for a promotion. Rejects duplicates. */
+    async createSingle(promotionId, code) {
+        const em = this.emFactory();
+        const promotion = await em.findOne(Promotion, { id: promotionId });
+        if (!promotion) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Promotion ${promotionId} not found.`);
+        }
+        const existing = await em.findOne(PromotionCoupon, { code });
+        if (existing) {
+            throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, `coupon_code_taken: ${code}`);
+        }
+        const coupon = em.create(PromotionCoupon, {
+            promotionId,
+            batchId: null,
+            code,
+            limitScope: 'per_coupon',
+            isActive: true,
+        });
+        em.persist(coupon);
+        this.#audit(em, 'coupon.create_single', promotionId, { code });
+        await em.flush();
+        return coupon;
+    }
+    /**
+     * Generate a batch of unique coupon codes (US4). Uniqueness is guaranteed
+     * in-batch via a Set and cross-batch via a DB existence check + regenerate;
+     * the `code` UNIQUE constraint is the final backstop.
+     */
+    async generateBatch(promotionId, req) {
+        if (req.count > COUPON_BATCH_MAX) {
+            throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, `batch_too_large: max ${COUPON_BATCH_MAX} per batch`);
+        }
+        const em = this.emFactory();
+        const promotion = await em.findOne(Promotion, { id: promotionId });
+        if (!promotion) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Promotion ${promotionId} not found.`);
+        }
+        // Generate unique-within-batch codes.
+        const codes = new Set();
+        let guard = 0;
+        const maxAttempts = req.count * 20 + 100;
+        while (codes.size < req.count && guard < maxAttempts) {
+            codes.add(buildCouponCode(req));
+            guard += 1;
+        }
+        if (codes.size < req.count) {
+            throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, 'coupon_space_exhausted: increase length or widen the format');
+        }
+        // Drop any that already exist in the DB, then regenerate replacements.
+        let candidates = [...codes];
+        const existing = await em.find(PromotionCoupon, { code: { $in: candidates } });
+        if (existing.length > 0) {
+            const taken = new Set(existing.map((c) => c.code));
+            const fresh = new Set(candidates.filter((c) => !taken.has(c)));
+            while (fresh.size < req.count && guard < maxAttempts) {
+                const c = buildCouponCode(req);
+                if (!taken.has(c))
+                    fresh.add(c);
+                guard += 1;
+            }
+            candidates = [...fresh];
+        }
+        const batch = em.create(CouponBatch, {
+            promotionId,
+            count: req.count,
+            length: req.length,
+            format: req.format,
+            prefix: req.prefix ?? null,
+            suffix: req.suffix ?? null,
+            dashEvery: req.dashEvery ?? 0,
+            limitScope: req.limitScope,
+        });
+        // Flush the batch first so the coupons' batch_id FK is satisfied (the
+        // coupon entity has no ORM relation, so insert order isn't inferred).
+        await em.persistAndFlush(batch);
+        for (const code of candidates) {
+            em.persist(em.create(PromotionCoupon, {
+                promotionId,
+                batchId: batch.id,
+                code,
+                limitScope: req.limitScope,
+                isActive: true,
+            }));
+        }
+        this.#audit(em, 'coupon.generate_batch', promotionId, {
+            batchId: batch.id,
+            generated: candidates.length,
+        });
+        await em.flush();
+        return { batch, generated: candidates.length };
+    }
+    async listBatchCodes(batchId) {
+        const rows = await this.emFactory().find(PromotionCoupon, { batchId }, { orderBy: { createdAt: 'asc' } });
+        return rows.map((r) => r.code);
+    }
+}
+//# sourceMappingURL=coupon-service.js.map

package/dist/backend/services/coupon-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coupon-service.js","sourceRoot":"","sources":["../../../src/backend/services/coupon-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,WAAW,EAA+B,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,sFAAsF;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,MAAM,SAAS,GAAqD;IAClE,iDAAiD;IACjD,KAAK,EAAE,kCAAkC;IACzC,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,0BAA0B;CACpC,CAAC;AAEF,SAAS,UAAU,CAAC,MAAc,EAAE,QAAgB;IAClD,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC;QAAE,GAAG,IAAI,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,KAAa;IAC/C,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAA2B;IACzD,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;IAC7F,OAAO,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAEL;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,UAA0C;QAE1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE;gBACxC,MAAM;gBACN,UAAU,EAAE,WAAW;gBACvB,QAAQ;gBACR,WAAW,EAAE,IAAI;gBACjB,UAAU;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,WAAmB;QACxC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAC1B,eAAe,EACf,EAAE,WAAW,EAAE,EACf,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAClC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CACjB,WAAmB,EACnB,SAAmB,EACnB,QAAiB;QAEjB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE;YAC7C,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE;YACtB,WAAW;SACZ,CAAC,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,wBAAwB,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5F,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,YAAY,CAAC,WAAmB,EAAE,IAAY;QAClD,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,EAAE,aAAa,WAAW,aAAa,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,iBAAiB,EAAE,sBAAsB,IAAI,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE;YACxC,WAAW;YACX,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,UAAU,EAAE,YAAY;YACxB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,sBAAsB,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CACjB,WAAmB,EACnB,GAA2B;QAE3B,IAAI,GAAG,CAAC,KAAK,GAAG,gBAAgB,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,iBAAiB,EAC7B,wBAAwB,gBAAgB,YAAY,CACrD,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,EAAE,aAAa,WAAW,aAAa,CAAC,CAAC;QACzF,CAAC;QAED,sCAAsC;QACtC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,GAAG,EAAE,GAAG,GAAG,CAAC;QACzC,OAAO,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,IAAI,KAAK,GAAG,WAAW,EAAE,CAAC;YACrD,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;YAChC,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,iBAAiB,EAC7B,6DAA6D,CAC9D,CAAC;QACJ,CAAC;QAED,uEAAuE;QACvE,IAAI,UAAU,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAC/E,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/D,OAAO,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,IAAI,KAAK,GAAG,WAAW,EAAE,CAAC;gBACrD,MAAM,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;gBAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAChC,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;YACD,UAAU,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;YACnC,WAAW;YACX,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI;YAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI;YAC1B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,CAAC;YAC7B,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC,CAAC;QACH,sEAAsE;QACtE,sEAAsE;QACtE,MAAM,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,EAAE,CAAC,OAAO,CACR,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE;gBACzB,WAAW;gBACX,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,IAAI;gBACJ,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,QAAQ,EAAE,IAAI;aACf,CAAC,CACH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,uBAAuB,EAAE,WAAW,EAAE;YACpD,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,SAAS,EAAE,UAAU,CAAC,MAAM;SAC7B,CAAC,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CACtC,eAAe,EACf,EAAE,OAAO,EAAE,EACX,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAClC,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/backend/services/promotion-action-registry.d.ts

@@ -0,0 +1,20 @@
+import type { PromotionAction } from '@endora-commerce/contracts';
+import type { CartApplyContext, DiscountResult, PromotionActionDefinition } from '../actions/types.js';
+/**
+ * Registry of promotion actions (FR-012). The 10 built-ins register at
+ * construction; other modules contribute additional action types via
+ * `register(...)` during composition — the same extension-point shape used
+ * by the payment / shipping adapter registries.
+ */
+export declare class PromotionActionRegistry {
+    private readonly defs;
+    register<C extends PromotionAction>(def: PromotionActionDefinition<C>): void;
+    get(type: string): PromotionActionDefinition | null;
+    list(): PromotionActionDefinition[];
+    has(type: string): boolean;
+    /** Apply a configured action against a cart context. Throws on unknown type. */
+    apply(action: PromotionAction, ctx: CartApplyContext): DiscountResult;
+}
+/** Build a registry pre-loaded with all built-in actions. */
+export declare function createPromotionActionRegistry(): PromotionActionRegistry;
+//# sourceMappingURL=promotion-action-registry.d.ts.map

package/dist/backend/services/promotion-action-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-action-registry.d.ts","sourceRoot":"","sources":["../../../src/backend/services/promotion-action-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAYvG;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgD;IAErE,QAAQ,CAAC,CAAC,SAAS,eAAe,EAAE,GAAG,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,IAAI;IAO5E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI;IAInD,IAAI,IAAI,yBAAyB,EAAE;IAInC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,gFAAgF;IAChF,KAAK,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,GAAG,cAAc;CAKtE;AAED,6DAA6D;AAC7D,wBAAgB,6BAA6B,IAAI,uBAAuB,CAavE"}

package/dist/backend/services/promotion-action-registry.js

@@ -0,0 +1,57 @@
+import { freeDeliveryAction } from '../actions/free-delivery.js';
+import { percentageOffCartAction } from '../actions/percentage-off-cart.js';
+import { amountOffCartAction } from '../actions/amount-off-cart.js';
+import { buyXGetYFreeAction } from '../actions/buy-x-get-y-free.js';
+import { spendXPercentOffAction } from '../actions/spend-x-percent-off.js';
+import { spendXAmountOffAction } from '../actions/spend-x-amount-off.js';
+import { everyNthProductPercentOffAction } from '../actions/every-nth-product-percent-off.js';
+import { buyXUnitsYFreeAction } from '../actions/buy-x-units-y-free.js';
+import { buyXUnitsPercentOffAction } from '../actions/buy-x-units-percent-off.js';
+import { buyXUnitsAmountOffAction } from '../actions/buy-x-units-amount-off.js';
+/**
+ * Registry of promotion actions (FR-012). The 10 built-ins register at
+ * construction; other modules contribute additional action types via
+ * `register(...)` during composition — the same extension-point shape used
+ * by the payment / shipping adapter registries.
+ */
+export class PromotionActionRegistry {
+    defs = new Map();
+    register(def) {
+        // Definitions are keyed by their action `type`. The cast widens the
+        // per-variant config back to the union so heterogeneous definitions can
+        // live in one map; `apply` is only ever invoked with the matching variant.
+        this.defs.set(def.type, def);
+    }
+    get(type) {
+        return this.defs.get(type) ?? null;
+    }
+    list() {
+        return [...this.defs.values()];
+    }
+    has(type) {
+        return this.defs.has(type);
+    }
+    /** Apply a configured action against a cart context. Throws on unknown type. */
+    apply(action, ctx) {
+        const def = this.defs.get(action.type);
+        if (!def)
+            throw new Error(`unknown_promotion_action: ${action.type}`);
+        return def.apply(action, ctx);
+    }
+}
+/** Build a registry pre-loaded with all built-in actions. */
+export function createPromotionActionRegistry() {
+    const registry = new PromotionActionRegistry();
+    registry.register(freeDeliveryAction);
+    registry.register(percentageOffCartAction);
+    registry.register(amountOffCartAction);
+    registry.register(buyXGetYFreeAction);
+    registry.register(spendXPercentOffAction);
+    registry.register(spendXAmountOffAction);
+    registry.register(everyNthProductPercentOffAction);
+    registry.register(buyXUnitsYFreeAction);
+    registry.register(buyXUnitsPercentOffAction);
+    registry.register(buyXUnitsAmountOffAction);
+    return registry;
+}
+//# sourceMappingURL=promotion-action-registry.js.map

package/dist/backend/services/promotion-action-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-action-registry.js","sourceRoot":"","sources":["../../../src/backend/services/promotion-action-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,+BAA+B,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,OAAO,uBAAuB;IACjB,IAAI,GAAG,IAAI,GAAG,EAAqC,CAAC;IAErE,QAAQ,CAA4B,GAAiC;QACnE,oEAAoE;QACpE,wEAAwE;QACxE,2EAA2E;QAC3E,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAA2C,CAAC,CAAC;IACvE,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,MAAuB,EAAE,GAAqB;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,UAAU,6BAA6B;IAC3C,MAAM,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/backend/services/promotion-code-port.d.ts

@@ -0,0 +1,24 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { PromotionCodePort, ResolvedPromotionCode } from '@endora-commerce/contracts';
+/**
+ * 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 declare class PromotionCodeService implements PromotionCodePort {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    resolveByCode(code: string): Promise<ResolvedPromotionCode | null>;
+}
+//# sourceMappingURL=promotion-code-port.d.ts.map

package/dist/backend/services/promotion-code-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-code-port.d.ts","sourceRoot":"","sources":["../../../src/backend/services/promotion-code-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAI3F;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAqB,YAAW,iBAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;CAiBzE"}