@endora-commerce/mod-carts 0.100.0

package/dist/backend/services/cart-conversion-service.js

@@ -0,0 +1,175 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { Cart } from '../entities/cart.entity.js';
+import { CartItem } from '../entities/cart-item.entity.js';
+import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
+import { productIdsInRequestChannel } from '@endora-commerce/platform/kernel';
+export class CartConversionService {
+    emFactory;
+    cartService;
+    rfqService;
+    quoteRequests;
+    catalogProducts;
+    channelMembership;
+    constructor(emFactory, cartService, 
+    /** `quote_requests`' customer-facing write surface. */
+    rfqService, 
+    /** `quote_requests`' row read model — the quote and its lines. */
+    quoteRequests, 
+    /** `catalog`'s product read model — is the quoted product still there? */
+    catalogProducts, 
+    /**
+     * The sanctioned bridge accessor (Constitution XII) — and on this seam it
+     * is what keeps the *reason* honest (issue #259). `CartService.addItem`
+     * refuses an out-of-channel line by itself, but this method catches every
+     * `HttpError` from it and reports one dropped-line reason,
+     * `no_price_in_customer_list`. A line the channel does not sell has nothing
+     * to do with the buyer's price list, so it is narrowed here instead and
+     * falls into the `not_purchasable` branch — where a line whose product has
+     * gone already lands.
+     */
+    channelMembership) {
+        this.emFactory = emFactory;
+        this.cartService = cartService;
+        this.rfqService = rfqService;
+        this.quoteRequests = quoteRequests;
+        this.catalogProducts = catalogProducts;
+        this.channelMembership = channelMembership;
+    }
+    /**
+     * Cart → Quote Request. Refuses on an empty cart. Source cart flips to
+     * `completed` with `converted_to_quote_request_id` set.
+     */
+    async convertToQuoteRequest(cart, ctx, note) {
+        // command-coverage-ignore: the durable write is the RFQ (RfqService
+        // .createForCustomer, audited as quote_request.create); this only marks the
+        // ephemeral cart completed and clears its items — transient working state.
+        const em = this.emFactory();
+        const items = await em.find(CartItem, { cartId: cart.id });
+        if (items.length === 0) {
+            throw new HttpError(422, ERROR_CODES.CART_EMPTY, 'cart_empty');
+        }
+        const rfq = await this.rfqService.createForCustomer(ctx, {
+            ...(note !== undefined ? { headerNote: note } : {}),
+            items: items.map((it) => ({
+                productId: it.productId,
+                ...(it.variantId ? { variantId: it.variantId } : {}),
+                quantity: it.quantity,
+                // Feature 043 — carry the packaging-unit snapshot so the RFQ line
+                // shows "<name> (Paleta)" like the cart did.
+                ...(it.packagingUnitName ? { packagingUnitName: it.packagingUnitName } : {}),
+                ...(it.packagingUnitBaseQuantity != null
+                    ? { packagingUnitBaseQuantity: it.packagingUnitBaseQuantity }
+                    : {}),
+                // Carry the buyer's currently-snapshotted unit price as the
+                // reference price on the QR line — sales sees what the cart
+                // would have cost without negotiation.
+                desiredUnitPrice: Number(it.unitPrice),
+            })),
+        });
+        // Flip the source cart to `completed` + record the conversion
+        // lineage. Reload on this service's own EM fork before mutating —
+        // the `cart` arg was loaded by the route handler's fork and a
+        // cross-fork flush would silently no-op (same bug we hit in
+        // CartCouponService.apply). Mirror the change back onto the
+        // caller's in-memory cart so the audit / response paths see the
+        // post-conversion state.
+        const managedCart = await em.findOne(Cart, { id: cart.id });
+        if (managedCart) {
+            managedCart.status = 'completed';
+            managedCart.convertedToQuoteRequestId = rfq.id;
+            managedCart.lastActivityAt = new Date();
+        }
+        await em.nativeDelete(CartItem, { cartId: cart.id });
+        await em.flush();
+        cart.status = 'completed';
+        cart.convertedToQuoteRequestId = rfq.id;
+        cart.lastActivityAt = managedCart?.lastActivityAt ?? new Date();
+        return { quoteRequestId: rfq.id, cartId: cart.id };
+    }
+    /**
+     * Quote Request → Cart. Creates a fresh `active` cart (or returns the
+     * existing one) for the buyer, appends the QR's lines with re-resolved
+     * prices (via `CartService.addItem`, which already routes through the
+     * pricing resolver when wired), and surfaces a list of dropped lines.
+     *
+     * The QR's `desiredUnitPrice` is intentionally dropped — the cart's
+     * unit prices come from the customer's current price list.
+     */
+    async createCartFromQuoteRequest(qrId, ctx) {
+        const qr = await this.quoteRequests.findById(qrId);
+        if (!qr) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'quote_request_not_found');
+        }
+        // Anti-enumeration: only the requesting customer (or the Organization's
+        // org-admin members) may convert it. Foundation gates ownership via the
+        // RFQ-detail endpoint; we mirror the customer ownership check here.
+        if (qr.customerAccountId !== ctx.customerAccountId) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'quote_request_not_found');
+        }
+        const qrItems = await this.quoteRequests.listItems(qr.id);
+        if (qrItems.length === 0) {
+            throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'quote_request_empty');
+        }
+        const productIds = Array.from(new Set(qrItems.map((it) => it.productId)));
+        const products = await this.catalogProducts.findByIds(productIds);
+        const publishedHere = await productIdsInRequestChannel(this.channelMembership, productIds);
+        const productById = new Map(products
+            .filter((p) => publishedHere === null || publishedHere.has(p.id))
+            .map((p) => [p.id, p]));
+        const droppedLines = [];
+        let appendedLineCount = 0;
+        let targetCart = null;
+        for (const qrItem of qrItems) {
+            const product = productById.get(qrItem.productId);
+            if (!product) {
+                droppedLines.push({
+                    productId: qrItem.productId,
+                    productName: qrItem.productName ?? qrItem.productId,
+                    reason: 'not_purchasable',
+                });
+                continue;
+            }
+            try {
+                const result = await this.cartService.addItem({ customer: ctx }, {
+                    productId: qrItem.productId,
+                    ...(qrItem.variantId ? { variantId: qrItem.variantId } : {}),
+                    quantity: qrItem.quantity,
+                });
+                targetCart = result.cart;
+                appendedLineCount += 1;
+            }
+            catch (err) {
+                // The tolerance is per line and it is right: one unpriceable product
+                // must not abort a twenty-line conversion, and the buyer is told which
+                // lines were dropped and why.
+                //
+                // `rethrowIfModuleDisabled` is its first line because `addItem` reaches
+                // `catalog`'s and `price_lists`' gated ports, and `ModuleDisabledError`
+                // **is** an `HttpError` — so the `instanceof` test below would let a
+                // switched-off pricing engine through as "no price in your list" for
+                // every line, which is issue #124's defect wearing a per-line report.
+                rethrowIfModuleDisabled(err);
+                // CartService throws an HttpError when the product is quote-only
+                // (displayMode='none') or no resolver match — both translate to
+                // `no_price_in_customer_list` for the storefront banner.
+                if (err instanceof HttpError) {
+                    droppedLines.push({
+                        productId: qrItem.productId,
+                        productName: qrItem.productName ?? qrItem.productId,
+                        reason: 'no_price_in_customer_list',
+                    });
+                    continue;
+                }
+                throw err;
+            }
+        }
+        if (!targetCart) {
+            // Every line dropped — still create / fetch the customer's active
+            // cart so the caller has a destination cartId.
+            targetCart = await this.cartService.getOrCreateForCustomer(ctx);
+        }
+        return { cartId: targetCart.id, appendedLineCount, droppedLines };
+    }
+}
+//# sourceMappingURL=cart-conversion-service.js.map

package/dist/backend/services/cart-conversion-service.js.map

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

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

@@ -0,0 +1,129 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CouponDropReason, PromotionApplication } from '@endora-commerce/contracts';
+import { Cart } from '../entities/cart.entity.js';
+import { CartItem } from '../entities/cart-item.entity.js';
+import type { CustomerAccountReadPort, OrganizationDetailsPort, PromotionApplyPort, PromotionCodePort } from '@endora-commerce/contracts';
+import type { CartApprovalService } from './cart-approval-service.js';
+/**
+ * Cart-level coupon application (feature 027 US2).
+ *
+ * Plumbs the buyer's coupon code through `PromotionService.applyToCart`:
+ *   - `apply(cart, code)` writes the code on the cart and asks the
+ *     promotion engine whether the named promotion would stick. If yes,
+ *     the discount is reflected via the recomputed snapshot the caller
+ *     returns to the buyer. If no, the cart's previous code (if any) is
+ *     preserved and a typed `CouponApplyResult.dropped` is returned
+ *     identifying the precise reason from the snapshot's eligibility
+ *     filter.
+ *   - `clear(cart)` removes the active code. Idempotent.
+ *   - `reevaluateOnRead(cart, snapshot)` is called from the GET-cart
+ *     read path. If a previously-applied code is no longer eligible
+ *     (e.g. the cart fell below `min_cart_subtotal` after a line
+ *     removal), the code is silently dropped and the caller can surface
+ *     `couponDroppedThisRead` in the response.
+ *
+ * The service never mutates promotion rows — only `cart.applied_promotion_code`.
+ */
+export interface CouponApplyOk {
+    outcome: 'applied';
+    cart: Cart;
+    appliedCode: string;
+}
+export interface CouponApplyDropped {
+    outcome: 'dropped';
+    reason: CouponDropReason;
+    shortfall?: {
+        amount: number;
+        currency: string;
+    };
+}
+export type CouponApplyResult = CouponApplyOk | CouponApplyDropped;
+export interface CouponReevaluateResult {
+    /** When non-null, the read path should populate `couponDroppedThisRead`. */
+    dropped: {
+        code: string;
+        reason: CouponDropReason;
+    } | null;
+}
+export declare class CartCouponService {
+    private readonly emFactory;
+    /** `promotions`' apply surface — the discount the engine computes. */
+    private readonly promotionService;
+    /**
+     * `promotions`' code-resolution port (feature 075, Phase C). The
+     * three-step lookup it replaces — legacy `promotions.code`, then
+     * `promotion_coupons`, then the promotion behind the coupon, each filtered
+     * on `isActive` — is that module's business, and this file reproduced it.
+     */
+    private readonly promotionCodes;
+    /**
+     * Issue #177 — the two reads behind the buyer's effective customer group,
+     * which every snapshot this service builds used to pass as a literal
+     * `null`. A coupon or automatic promotion an operator restricted to a
+     * group therefore matched nobody.
+     */
+    private readonly customerAccounts;
+    private readonly organizations;
+    private readonly approvalService?;
+    /**
+     * `approvalService` is optional — when wired, applying or clearing a
+     * coupon on an `approved` cart re-arms approval to `pending`. Legacy
+     * compositions without the approval surface omit it (re-arm is a
+     * no-op when absent).
+     */
+    constructor(emFactory: () => EntityManager, 
+    /** `promotions`' apply surface — the discount the engine computes. */
+    promotionService: PromotionApplyPort, 
+    /**
+     * `promotions`' code-resolution port (feature 075, Phase C). The
+     * three-step lookup it replaces — legacy `promotions.code`, then
+     * `promotion_coupons`, then the promotion behind the coupon, each filtered
+     * on `isActive` — is that module's business, and this file reproduced it.
+     */
+    promotionCodes: PromotionCodePort, 
+    /**
+     * Issue #177 — the two reads behind the buyer's effective customer group,
+     * which every snapshot this service builds used to pass as a literal
+     * `null`. A coupon or automatic promotion an operator restricted to a
+     * group therefore matched nobody.
+     */
+    customerAccounts: CustomerAccountReadPort, organizations: OrganizationDetailsPort, approvalService?: CartApprovalService | undefined);
+    /** The buyer's effective group: their own, else their Organization's. */
+    private customerGroupIdFor;
+    /**
+     * Apply (or replace) the active coupon on the cart. Validates against
+     * the promotion engine using the current cart contents.
+     *
+     * `code === null` clears any active coupon (use the `clear` alias for
+     * readability — both are equivalent).
+     *
+     * Note: the cart passed in may have been loaded by a different
+     * EntityManager fork. We re-load it on our own fork so the
+     * `appliedPromotionCode` mutation flushes to the DB and the
+     * caller's in-memory cart is also updated.
+     */
+    apply(cart: Cart, code: string | null): Promise<CouponApplyResult>;
+    /**
+     * Feature 045 — compute the promotion application for a cart on read, so
+     * the serialized cart can show the real discount amount + per-promotion
+     * breakdown (automatic action-based promotions plus any applied coupon).
+     * Pure read — never mutates the cart.
+     */
+    computeApplication(cart: Cart, items: CartItem[]): Promise<PromotionApplication>;
+    clear(cart: Cart): Promise<void>;
+    /**
+     * Called from the GET-cart read path. If a previously-applied code is
+     * no longer eligible (e.g. the cart fell below `min_cart_subtotal`),
+     * silently drops it on the cart record and returns a typed result the
+     * caller can surface as `couponDroppedThisRead` in the response.
+     */
+    reevaluateOnRead(cart: Cart, items: CartItem[]): Promise<CouponReevaluateResult>;
+    /**
+     * Persists a coupon drop. The caller's `cart` entity may belong to a
+     * different EntityManager fork; we reload on our own fork, mutate, and
+     * also mirror the change onto the caller's in-memory cart so the
+     * read-side serializer sees the dropped coupon.
+     */
+    private persistDrop;
+}
+//# sourceMappingURL=cart-coupon-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cart-coupon-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/cart-coupon-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAgB,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvG,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,GAAG,IAAI,CAAC;CAC5D;AAED,qBAAa,iBAAiB;IAQ1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IAzBnC;;;;;OAKG;gBAEgB,SAAS,EAAE,MAAM,aAAa;IAC/C,sEAAsE;IACrD,gBAAgB,EAAE,kBAAkB;IACrD;;;;;OAKG;IACc,cAAc,EAAE,iBAAiB;IAClD;;;;;OAKG;IACc,gBAAgB,EAAE,uBAAuB,EACzC,aAAa,EAAE,uBAAuB,EACtC,eAAe,CAAC,EAAE,mBAAmB,YAAA;IAGxD,yEAAyE;IACzE,OAAO,CAAC,kBAAkB;IAU1B;;;;;;;;;;;OAWG;IACG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoGxE;;;;;OAKG;IACG,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoBhF,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtC;;;;;OAKG;IACG,gBAAgB,CACpB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,QAAQ,EAAE,GAChB,OAAO,CAAC,sBAAsB,CAAC;IAoClC;;;;;OAKG;YACW,WAAW;CAQ1B"}

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

@@ -0,0 +1,244 @@
+import { Cart } from '../entities/cart.entity.js';
+import { CartItem } from '../entities/cart-item.entity.js';
+import { resolveCartCustomerGroupId } from './customer-group-resolver.js';
+export class CartCouponService {
+    emFactory;
+    promotionService;
+    promotionCodes;
+    customerAccounts;
+    organizations;
+    approvalService;
+    /**
+     * `approvalService` is optional — when wired, applying or clearing a
+     * coupon on an `approved` cart re-arms approval to `pending`. Legacy
+     * compositions without the approval surface omit it (re-arm is a
+     * no-op when absent).
+     */
+    constructor(emFactory, 
+    /** `promotions`' apply surface — the discount the engine computes. */
+    promotionService, 
+    /**
+     * `promotions`' code-resolution port (feature 075, Phase C). The
+     * three-step lookup it replaces — legacy `promotions.code`, then
+     * `promotion_coupons`, then the promotion behind the coupon, each filtered
+     * on `isActive` — is that module's business, and this file reproduced it.
+     */
+    promotionCodes, 
+    /**
+     * Issue #177 — the two reads behind the buyer's effective customer group,
+     * which every snapshot this service builds used to pass as a literal
+     * `null`. A coupon or automatic promotion an operator restricted to a
+     * group therefore matched nobody.
+     */
+    customerAccounts, organizations, approvalService) {
+        this.emFactory = emFactory;
+        this.promotionService = promotionService;
+        this.promotionCodes = promotionCodes;
+        this.customerAccounts = customerAccounts;
+        this.organizations = organizations;
+        this.approvalService = approvalService;
+    }
+    /** The buyer's effective group: their own, else their Organization's. */
+    customerGroupIdFor(cart) {
+        return resolveCartCustomerGroupId({ customerAccounts: this.customerAccounts, organizations: this.organizations }, {
+            customerAccountId: cart.customerAccountId ?? null,
+            organizationId: cart.organizationId ?? null,
+        });
+    }
+    /**
+     * Apply (or replace) the active coupon on the cart. Validates against
+     * the promotion engine using the current cart contents.
+     *
+     * `code === null` clears any active coupon (use the `clear` alias for
+     * readability — both are equivalent).
+     *
+     * Note: the cart passed in may have been loaded by a different
+     * EntityManager fork. We re-load it on our own fork so the
+     * `appliedPromotionCode` mutation flushes to the DB and the
+     * caller's in-memory cart is also updated.
+     */
+    async apply(cart, code) {
+        // command-coverage-ignore: transient cart coupon state — the durable applied
+        // promotion is captured on the order at checkout (audited there); the cart is
+        // ephemeral pre-order working state.
+        if (code === null) {
+            await this.clear(cart);
+            return { outcome: 'applied', cart, appliedCode: '' };
+        }
+        const em = this.emFactory();
+        const managedCart = await em.findOne(Cart, { id: cart.id });
+        if (!managedCart) {
+            return { outcome: 'dropped', reason: 'invalid_code' };
+        }
+        // Resolve the promotion row by code so we can build the reason-specific
+        // drop response (the snapshot's eligibility filter inside applyToCart
+        // is opaque to callers, so we re-implement the precondition checks
+        // here for the reason mapping).
+        const promotion = await this.promotionCodes.resolveByCode(code);
+        if (!promotion) {
+            return { outcome: 'dropped', reason: 'invalid_code' };
+        }
+        const now = new Date();
+        if (promotion.validFrom && now < promotion.validFrom) {
+            return { outcome: 'dropped', reason: 'expired' };
+        }
+        if (promotion.validUntil && now > promotion.validUntil) {
+            return { outcome: 'dropped', reason: 'expired' };
+        }
+        if (promotion.organizationId && promotion.organizationId !== managedCart.organizationId) {
+            return { outcome: 'dropped', reason: 'wrong_organization' };
+        }
+        const items = await em.find(CartItem, { cartId: managedCart.id });
+        const subtotal = items.reduce((acc, it) => acc + Number(it.unitPrice) * it.quantity, 0);
+        const currency = items[0]?.currency ?? 'PLN';
+        if (promotion.minCartSubtotal != null) {
+            const min = Number(promotion.minCartSubtotal);
+            if (min > subtotal) {
+                return {
+                    outcome: 'dropped',
+                    reason: 'below_min_spend',
+                    shortfall: { amount: round2(min - subtotal), currency },
+                };
+            }
+        }
+        // Double-check via the promotion engine — this catches any criteria
+        // we don't replicate here (e.g. attribute/category rules from
+        // feature 012).
+        const snapshot = {
+            organizationId: cart.organizationId ?? null,
+            customerGroupId: await this.customerGroupIdFor(managedCart),
+            currency,
+            lines: items.map((it) => ({
+                productId: it.productId,
+                variantId: it.variantId ?? null,
+                // Feature 012 / US8 category criteria — hydrated by the engine
+                // when needed. Empty seed keeps the contract satisfied.
+                categoryIds: [],
+                quantity: it.quantity,
+                unitPrice: { amount: Number(it.unitPrice), currency: it.currency },
+            })),
+            deliveryTotal: 0,
+            promotionCode: code,
+        };
+        const application = await this.promotionService.applyToCart(snapshot);
+        const stuck = application.appliedPromotions.some((ap) => ap.promotionId === promotion.promotionId);
+        if (!stuck) {
+            // Eligible by the local pre-checks but rejected by the engine's
+            // criteria — bucket as `wrong_customer_group` since that's the
+            // most common criterion we don't pre-check here. (The promotion
+            // engine doesn't expose a typed reason, so this is the best
+            // generic mapping.)
+            return { outcome: 'dropped', reason: 'wrong_customer_group' };
+        }
+        managedCart.appliedPromotionCode = code;
+        managedCart.lastActivityAt = new Date();
+        await em.flush();
+        // Mirror the persisted mutation onto the caller's in-memory cart so
+        // serializeCart in the route handler reflects it without re-reading.
+        cart.appliedPromotionCode = code;
+        cart.lastActivityAt = managedCart.lastActivityAt;
+        if (this.approvalService && managedCart.customerAccountId) {
+            await this.approvalService.maybeReArm(managedCart, {
+                customerAccountId: managedCart.customerAccountId,
+            });
+            cart.approvalStatus = managedCart.approvalStatus;
+        }
+        return { outcome: 'applied', cart, appliedCode: code };
+    }
+    /**
+     * Feature 045 — compute the promotion application for a cart on read, so
+     * the serialized cart can show the real discount amount + per-promotion
+     * breakdown (automatic action-based promotions plus any applied coupon).
+     * Pure read — never mutates the cart.
+     */
+    async computeApplication(cart, items) {
+        const currency = items[0]?.currency ?? 'PLN';
+        const snapshot = {
+            organizationId: cart.organizationId ?? null,
+            customerGroupId: await this.customerGroupIdFor(cart),
+            currency,
+            lines: items.map((it) => ({
+                productId: it.productId,
+                variantId: it.variantId ?? null,
+                categoryIds: [],
+                quantity: it.quantity,
+                unitPrice: { amount: Number(it.unitPrice), currency: it.currency },
+            })),
+            deliveryTotal: 0,
+            promotionCode: cart.appliedPromotionCode ?? null,
+            salesChannelId: cart.salesChannelId ?? null,
+        };
+        return this.promotionService.applyToCart(snapshot);
+    }
+    async clear(cart) {
+        // command-coverage-ignore: transient cart coupon state (see apply()).
+        if (cart.appliedPromotionCode === null)
+            return;
+        const em = this.emFactory();
+        const managedCart = await em.findOne(Cart, { id: cart.id });
+        if (!managedCart)
+            return;
+        managedCart.appliedPromotionCode = null;
+        managedCart.lastActivityAt = new Date();
+        await em.flush();
+        cart.appliedPromotionCode = null;
+        cart.lastActivityAt = managedCart.lastActivityAt;
+        if (this.approvalService && managedCart.customerAccountId) {
+            await this.approvalService.maybeReArm(managedCart, {
+                customerAccountId: managedCart.customerAccountId,
+            });
+            cart.approvalStatus = managedCart.approvalStatus;
+        }
+    }
+    /**
+     * Called from the GET-cart read path. If a previously-applied code is
+     * no longer eligible (e.g. the cart fell below `min_cart_subtotal`),
+     * silently drops it on the cart record and returns a typed result the
+     * caller can surface as `couponDroppedThisRead` in the response.
+     */
+    async reevaluateOnRead(cart, items) {
+        if (!cart.appliedPromotionCode)
+            return { dropped: null };
+        const code = cart.appliedPromotionCode;
+        const em = this.emFactory();
+        const promotion = await this.promotionCodes.resolveByCode(code);
+        if (!promotion) {
+            await this.persistDrop(em, cart);
+            return { dropped: { code, reason: 'invalid_code' } };
+        }
+        const now = new Date();
+        if ((promotion.validFrom && now < promotion.validFrom) ||
+            (promotion.validUntil && now > promotion.validUntil)) {
+            await this.persistDrop(em, cart);
+            return { dropped: { code, reason: 'expired' } };
+        }
+        const subtotal = items.reduce((acc, it) => acc + Number(it.unitPrice) * it.quantity, 0);
+        if (promotion.minCartSubtotal != null) {
+            const min = Number(promotion.minCartSubtotal);
+            if (min > subtotal) {
+                await this.persistDrop(em, cart);
+                return { dropped: { code, reason: 'below_min_spend' } };
+            }
+        }
+        return { dropped: null };
+    }
+    /**
+     * Persists a coupon drop. The caller's `cart` entity may belong to a
+     * different EntityManager fork; we reload on our own fork, mutate, and
+     * also mirror the change onto the caller's in-memory cart so the
+     * read-side serializer sees the dropped coupon.
+     */
+    async persistDrop(em, cart) {
+        // command-coverage-ignore: transient cart coupon state (see apply()).
+        const managed = await em.findOne(Cart, { id: cart.id });
+        if (!managed)
+            return;
+        managed.appliedPromotionCode = null;
+        await em.flush();
+        cart.appliedPromotionCode = null;
+    }
+}
+function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+//# sourceMappingURL=cart-coupon-service.js.map

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

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

package/dist/backend/services/cart-organization-visibility-service.d.ts

@@ -0,0 +1,43 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CartStatus, CartApprovalStatus, CustomerAccountReadPort, OrgCartsListResponse } from '@endora-commerce/contracts';
+import { Cart } from '../entities/cart.entity.js';
+/**
+ * Organization-Administrator visibility surface (feature 027 US4).
+ *
+ * Lists every cart belonging to a member of the caller's Organization.
+ * The role gate is enforced at the route level; this service trusts
+ * its caller's `actor.organizationId` and refuses anti-enumeration
+ * lookups against other organizations.
+ */
+export interface OrgCartsListQuery {
+    status?: CartStatus[];
+    approvalStatus?: CartApprovalStatus[];
+    page?: number;
+    pageSize?: number;
+    sort?: 'last_activity_desc' | 'last_activity_asc' | 'total_desc' | 'total_asc' | 'created_desc';
+}
+export declare class CartOrganizationVisibilityService {
+    private readonly emFactory;
+    /**
+     * `customer_accounts`' read model (feature 075, Phase C). The org-admin
+     * cart list renders each cart's owner by e-mail, and it read the account
+     * row itself — out of a table deactivation leaves in place.
+     */
+    private readonly customerAccounts;
+    constructor(emFactory: () => EntityManager, 
+    /**
+     * `customer_accounts`' read model (feature 075, Phase C). The org-admin
+     * cart list renders each cart's owner by e-mail, and it read the account
+     * row itself — out of a table deactivation leaves in place.
+     */
+    customerAccounts: CustomerAccountReadPort);
+    list(organizationId: string, query?: OrgCartsListQuery): Promise<OrgCartsListResponse>;
+    /**
+     * Fetch a single cart in the caller's Organization. Refuses with 404
+     * when the cart belongs to a different Organization (anti-enumeration
+     * symmetry with the ordinary-member ownership check).
+     */
+    getInOrganization(cartId: string, organizationId: string): Promise<Cart>;
+    private sortClause;
+}
+//# sourceMappingURL=cart-organization-visibility-service.d.ts.map

package/dist/backend/services/cart-organization-visibility-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-organization-visibility-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/cart-organization-visibility-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAGlD;;;;;;;GAOG;AAEH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;CACjG;AAED,qBAAa,iCAAiC;IAE1C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBANhB,SAAS,EAAE,MAAM,aAAa;IAC/C;;;;OAIG;IACc,gBAAgB,EAAE,uBAAuB;IAGtD,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,GAAE,iBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA0DhG;;;;OAIG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9E,OAAO,CAAC,UAAU;CAgBnB"}