@endora-commerce/mod-carts 0.100.0

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

@@ -0,0 +1,556 @@
+import { createHash } from 'node:crypto';
+import { ANONYMOUS_PRODUCT_AUDIENCE, ERROR_CODES, isProductVisibleTo, } 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 { SalesChannel } from '@endora-commerce/platform/kernel';
+import { outOfRequestChannel } from '@endora-commerce/platform/kernel';
+/**
+ * Cart-line hard cap (feature 027 FR-001 / spec edge case "Cart contents
+ * cap"). The 201st distinct line is refused with HTTP 422.
+ */
+export const CART_MAX_LINES = 200;
+export class CartService {
+    emFactory;
+    pricingService;
+    catalogProducts;
+    organizations;
+    channelMembership;
+    approvalService;
+    auditService;
+    recomputeCache;
+    /**
+     * `pricingService` is **required** since issue #124. It used to be optional
+     * "for test rigs", and the cart then read the legacy
+     * `attributeValues['defaultPrice']` whenever it was missing — so a rig, a
+     * wiring slip and `price_lists` switched off all produced the same thing: a
+     * cart line priced from a catalogue attribute that no price list supports.
+     * Absence is now a `lazyPort` gate that throws `MODULE_DISABLED` at the call,
+     * which nothing downstream can mistake for a price.
+     *
+     * Cart entities don't currently track which sales channel they were
+     * created on (multi-channel cart attribution is a separate
+     * follow-up), so the resolver runs against the system-default
+     * channel — matching the behaviour the foundation cart already had.
+     * Lists with a `salesChannel` criterion targeting other channels
+     * therefore won't apply on the cart line until cart-side channel
+     * tracking lands.
+     */
+    /**
+     * `approvalService` and `auditService` are optional — when wired
+     * (production composition), any buyer-driven mutation on an
+     * `approved` cart re-arms approval to `pending` and a typed audit
+     * row is landed (line_added / line_qty_changed / line_removed).
+     * Foundation tests and legacy test rigs that don't wire either still
+     * construct the service without them; both hooks no-op when absent.
+     */
+    constructor(emFactory, 
+    /** `price_lists`' line-resolution slice (feature 075, Phase C). */
+    pricingService, 
+    /** `catalog`'s product read model — products, variants, packaging units. */
+    catalogProducts, 
+    /** `organizations`' read model — the buying org the price resolves against. */
+    organizations, 
+    /**
+     * The sanctioned bridge accessor (Constitution XII), for the assortment
+     * gate `addItem` owes (issue #259). Required, like `catalogProducts`: an
+     * optional one would make "this rig did not wire it" and "this channel
+     * publishes the product" the same answer, which is the fail-open shape the
+     * whole issue is about.
+     */
+    channelMembership, approvalService, auditService, recomputeCache) {
+        this.emFactory = emFactory;
+        this.pricingService = pricingService;
+        this.catalogProducts = catalogProducts;
+        this.organizations = organizations;
+        this.channelMembership = channelMembership;
+        this.approvalService = approvalService;
+        this.auditService = auditService;
+        this.recomputeCache = recomputeCache;
+    }
+    /** Invalidate the per-cart price-recompute cache on every cart-side write. */
+    async #invalidateRecomputeCache(cartId) {
+        if (!this.recomputeCache)
+            return;
+        try {
+            await this.recomputeCache.invalidate(cartId);
+        }
+        catch {
+            // Cache invalidation is best-effort — never block a write.
+        }
+    }
+    async getOrCreateForCustomer(ctx) {
+        const em = this.emFactory();
+        return this.#getOrCreateForCustomerOn(em, ctx);
+    }
+    async #getOrCreateForCustomerOn(em, ctx) {
+        let cart = await em.findOne(Cart, {
+            customerAccountId: ctx.customerAccountId,
+            status: 'active',
+        });
+        if (!cart) {
+            cart = em.create(Cart, {
+                customerAccountId: ctx.customerAccountId,
+                organizationId: ctx.organizationId,
+                status: 'active',
+                salesChannelId: await this.#defaultSalesChannelId(em),
+            });
+            await em.persistAndFlush(cart);
+        }
+        return cart;
+    }
+    async getOrCreateForAnon(em, token) {
+        let cart = await em.findOne(Cart, { anonymousCartToken: token, status: 'active' });
+        if (!cart) {
+            cart = em.create(Cart, {
+                anonymousCartToken: token,
+                status: 'active',
+                salesChannelId: await this.#defaultSalesChannelId(em),
+            });
+            await em.persistAndFlush(cart);
+        }
+        return cart;
+    }
+    /**
+     * Feature 052 — a cart MUST carry a resolved sales channel so promotion and
+     * pricing evaluation is channel-scoped (the promotion channel gate fails closed
+     * on a null-channel cart, FR-005). Until request-driven channel resolution is
+     * unified (spec 03), a new cart defaults to the system-default channel. Returns
+     * `null` only if no system-default channel exists (a misconfigured store).
+     */
+    async #defaultSalesChannelId(em) {
+        const channel = await em.findOne(SalesChannel, { systemDefault: true }, { fields: ['id'] });
+        return channel?.id ?? null;
+    }
+    async getItems(cartId) {
+        const em = this.emFactory();
+        return em.find(CartItem, { cartId });
+    }
+    async addItem(actor, input) {
+        const em = this.emFactory();
+        const cart = actor.customer
+            ? await this.#getOrCreateForCustomerOn(em, actor.customer)
+            : actor.anonymousToken
+                ? await this.getOrCreateForAnon(em, actor.anonymousToken)
+                : (() => {
+                    throw new HttpError(401, ERROR_CODES.UNAUTHORIZED, 'Cart requires either a customer session or an anonymous cart token.');
+                })();
+        if (input.quantity <= 0) {
+            throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'Quantity must be > 0.');
+        }
+        const product = await this.catalogProducts.findById(input.productId);
+        // Issue #227 — a product this shopper may not see is a product they may not
+        // put in a cart. The read port is the row-level one and applies no policy of
+        // its own, deliberately: an order line has to resolve its product long after
+        // the operator restricted it. That makes enforcement the caller's, and this
+        // caller is holding a `productId` the buyer chose.
+        //
+        // 404 and not 403, matching the product detail: a caller who may not see the
+        // row may not learn it exists, and the two answers are indistinguishable to
+        // an honest client because they are the same answer.
+        if (!product || !isProductVisibleTo(product, cartAudience(actor))) {
+            throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
+        }
+        // Issue #259 — the second filter the predicate above says it is not. The
+        // channel is a property of the request, so it is read off the request scope
+        // and never re-resolved here; outside a request there is no channel to be
+        // out of and `outOfRequestChannel` answers `false`.
+        //
+        // The same 404 as the two lines above, deliberately: "sold on another
+        // channel", "restricted to another organisation" and "does not exist" have
+        // to be one answer, or the pair of them is an enumeration oracle over an
+        // operator's private assortment — the defect issue #174 found in the
+        // type-ahead next door.
+        if (await outOfRequestChannel(this.channelMembership, product.id)) {
+            throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, 'Product not found.');
+        }
+        // Feature 043 — ordering by a packaging unit (e.g. a pallet): the line is
+        // measured in base pieces (`baseQuantity × units`) and snapshots the unit
+        // name so the cart/order/RFQ can append it to the product name.
+        //
+        // `findPackagingUnitInProduct` is the two-argument form of the same read:
+        // the "does this unit belong to this product?" test was the second half of
+        // the `where` clause and stays inside one query.
+        let packagingUnit = null;
+        if (input.packagingUnitId) {
+            packagingUnit = await this.catalogProducts.findPackagingUnitInProduct(product.id, input.packagingUnitId);
+            if (!packagingUnit) {
+                throw new HttpError(404, ERROR_CODES.PACKAGING_UNIT_NOT_FOUND, 'Packaging unit not found for this product.');
+            }
+        }
+        const effectiveQuantity = packagingUnit
+            ? packagingUnit.baseQuantity * input.quantity
+            : input.quantity;
+        // If the same product+variant+packaging-unit is already in the cart, bump
+        // quantity. A packaging-unit line and a single-piece line of the same
+        // product stay distinct (different `packagingUnitId`).
+        const existing = await em.findOne(CartItem, {
+            cartId: cart.id,
+            productId: product.id,
+            variantId: input.variantId ?? null,
+            packagingUnitId: input.packagingUnitId ?? null,
+        });
+        if (existing) {
+            existing.quantity += effectiveQuantity;
+            cart.lastActivityAt = new Date();
+            await em.flush();
+        }
+        else {
+            // Feature 027 FR-001: enforce the 200-line cap on the 201st distinct
+            // (productId, variantId) pair. Foundation duplicate-summation above
+            // does not trigger the cap.
+            const currentLineCount = await em.count(CartItem, { cartId: cart.id });
+            if (currentLineCount >= CART_MAX_LINES) {
+                throw new HttpError(422, ERROR_CODES.CART_LINE_CAP_EXCEEDED, 'cart_line_cap_exceeded');
+            }
+            const resolved = await this.#resolveLineUnitPrice(em, {
+                product,
+                organizationId: actor.customer?.organizationId ?? null,
+                quantity: effectiveQuantity,
+                variantId: input.variantId ?? null,
+            });
+            // T084 — defence-in-depth: refuse the line when the resolver says
+            // this product is quote-only for the (org, channel) tuple.
+            if (resolved && resolved.displayMode === 'none') {
+                throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, 'product_quote_only');
+            }
+            const item = em.create(CartItem, {
+                cartId: cart.id,
+                productId: product.id,
+                ...(input.variantId ? { variantId: input.variantId } : {}),
+                ...(packagingUnit
+                    ? {
+                        packagingUnitId: packagingUnit.id,
+                        packagingUnitName: packagingUnit.name,
+                        packagingUnitBaseQuantity: packagingUnit.baseQuantity,
+                    }
+                    : {}),
+                quantity: effectiveQuantity,
+                // `resolved === null` is `price_lists` answering "no list applies to
+                // this line"; the catalogue attribute is the legacy stand-in for that
+                // case and is reported as remaining debt (issue #124). What can no
+                // longer land here is an *absent* `price_lists`: resolving the port
+                // throws `MODULE_DISABLED` before this expression runs.
+                unitPrice: resolved
+                    ? Number(resolved.amount).toFixed(2)
+                    : (Number(product.attributeValues['defaultPrice'] ??
+                        product.attributeValues['price'] ??
+                        0)).toFixed(2),
+                currency: resolved?.currency ?? 'PLN',
+            });
+            em.persist(item);
+            cart.lastActivityAt = new Date();
+            await em.flush();
+        }
+        if (this.approvalService && actor.customer) {
+            await this.approvalService.maybeReArm(cart, {
+                customerAccountId: actor.customer.customerAccountId,
+            });
+        }
+        if (this.auditService) {
+            await this.auditService.record({
+                cartId: cart.id,
+                actorType: actor.customer ? 'customer' : 'system',
+                ...(actor.customer ? { actorId: actor.customer.customerAccountId } : {}),
+                action: 'line_added',
+                metadata: {
+                    productId: input.productId,
+                    ...(input.variantId ? { variantId: input.variantId } : {}),
+                    quantity: input.quantity,
+                },
+            });
+        }
+        await this.#invalidateRecomputeCache(cart.id);
+        const items = await em.find(CartItem, { cartId: cart.id });
+        return { cart, items };
+    }
+    /**
+     * Look up the line's unit price via the resolver.
+     *
+     * `null` means "the price-list engine answered, and nothing applies" —
+     * `resolveLinePrice`'s own documented answer — so there is no `catch` here
+     * (issue #84). There used to be one, and it made the two answers
+     * indistinguishable: a `price_lists` switched off, or a resolver bug, both
+     * came back as "this line has no price", and the cart quietly re-priced from
+     * the catalogue default. An absent `price_lists` now throws through this
+     * method to the route (issue #124).
+     */
+    async #resolveLineUnitPrice(em, input) {
+        const channel = await em.findOne(SalesChannel, { systemDefault: true });
+        if (!channel)
+            return null;
+        const organization = input.organizationId
+            ? await this.organizations.findById(input.organizationId)
+            : null;
+        const resolved = await this.pricingService.resolveLinePrice({
+            product: input.product,
+            variantId: input.variantId,
+            context: {
+                quantity: input.quantity,
+                ...(organization ? { organization } : {}),
+                salesChannel: channel,
+            },
+        });
+        if (!resolved)
+            return null;
+        return {
+            amount: resolved.amount,
+            currency: resolved.currency,
+            priceListId: resolved.priceListId,
+            displayMode: resolved.displayMode,
+        };
+    }
+    async updateItem(actor, itemId, quantity) {
+        const em = this.emFactory();
+        const item = await em.findOne(CartItem, { id: itemId });
+        if (!item)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Cart item not found.');
+        const cart = await em.findOne(Cart, { id: item.cartId });
+        if (!cart)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Cart not found.');
+        this.#assertOwnership(cart, actor);
+        const oldQuantity = item.quantity;
+        if (quantity <= 0) {
+            em.remove(item);
+        }
+        else {
+            item.quantity = quantity;
+        }
+        cart.lastActivityAt = new Date();
+        await em.flush();
+        if (this.approvalService && actor.customer) {
+            await this.approvalService.maybeReArm(cart, {
+                customerAccountId: actor.customer.customerAccountId,
+            });
+        }
+        if (this.auditService) {
+            await this.auditService.record({
+                cartId: cart.id,
+                actorType: actor.customer ? 'customer' : 'system',
+                ...(actor.customer ? { actorId: actor.customer.customerAccountId } : {}),
+                action: quantity <= 0 ? 'line_removed' : 'line_qty_changed',
+                metadata: {
+                    productId: item.productId,
+                    ...(item.variantId ? { variantId: item.variantId } : {}),
+                    oldQuantity,
+                    newQuantity: quantity,
+                },
+            });
+        }
+        await this.#invalidateRecomputeCache(cart.id);
+        const items = await em.find(CartItem, { cartId: cart.id });
+        return { cart, items };
+    }
+    async removeItem(actor, itemId) {
+        const em = this.emFactory();
+        const item = await em.findOne(CartItem, { id: itemId });
+        if (!item)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Cart item not found.');
+        const cart = await em.findOne(Cart, { id: item.cartId });
+        if (!cart)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Cart not found.');
+        this.#assertOwnership(cart, actor);
+        const removedProductId = item.productId;
+        const removedVariantId = item.variantId ?? null;
+        const removedQuantity = item.quantity;
+        em.remove(item);
+        cart.lastActivityAt = new Date();
+        await em.flush();
+        if (this.approvalService && actor.customer) {
+            await this.approvalService.maybeReArm(cart, {
+                customerAccountId: actor.customer.customerAccountId,
+            });
+        }
+        if (this.auditService) {
+            await this.auditService.record({
+                cartId: cart.id,
+                actorType: actor.customer ? 'customer' : 'system',
+                ...(actor.customer ? { actorId: actor.customer.customerAccountId } : {}),
+                action: 'line_removed',
+                metadata: {
+                    productId: removedProductId,
+                    ...(removedVariantId ? { variantId: removedVariantId } : {}),
+                    quantity: removedQuantity,
+                },
+            });
+        }
+        await this.#invalidateRecomputeCache(cart.id);
+        const items = await em.find(CartItem, { cartId: cart.id });
+        return { cart, items };
+    }
+    /**
+     * Explicit "this buyer just opened the cart page" ping (feature 027 §R4 /
+     * FR-032). Bumps `last_activity_at` and, if the cart had transitioned to
+     * `abandoned`, brings it back to `active` and clears
+     * `abandonment_notified_at` so the next abandonment cycle can notify
+     * again. No-op on a missing cart.
+     */
+    async touch(actor) {
+        // command-coverage-ignore: bumps the ephemeral cart's lastActivityAt for the
+        // abandonment sweep — transient bookkeeping, not an audited domain mutation.
+        const em = this.emFactory();
+        let cart = null;
+        if (actor.customer) {
+            cart = await em.findOne(Cart, {
+                customerAccountId: actor.customer.customerAccountId,
+                status: { $in: ['active', 'abandoned'] },
+            });
+        }
+        else if (actor.anonymousToken) {
+            cart = await em.findOne(Cart, {
+                anonymousCartToken: actor.anonymousToken,
+                status: { $in: ['active', 'abandoned'] },
+            });
+        }
+        if (!cart)
+            return null;
+        cart.lastActivityAt = new Date();
+        if (cart.status === 'abandoned') {
+            cart.status = 'active';
+            cart.abandonmentNotifiedAt = null;
+        }
+        await em.flush();
+        return cart;
+    }
+    /**
+     * Merge an anonymous cart's items into the customer's cart at login
+     * time (feature 037-cart-merge-on-login).
+     *
+     * Returns a `CartMergeOutcome` diagnostic the caller (the login route
+     * via the `onLogin` hook) uses to surface the result to the storefront
+     * and to decide whether to clear the stale `b2b_cart_anon` cookie.
+     * See specs/037-cart-merge-on-login/contracts/cart-merge.md § 3.
+     *
+     * State matrix:
+     *   - `adopted`        — the customer had no active cart; the anon
+     *     cart's lines were placed onto a freshly-created destination.
+     *   - `merged`         — the customer already had an active cart and
+     *     ≥ 1 anon line was moved or summed into it.
+     *   - `noop_empty`     — the anon cart was found but carried no items;
+     *     the source row is still flipped to `completed` + detokenised
+     *     (cleanup), no audit row is written.
+     *   - `noop_no_anon`   — no cart for the supplied token; no DB change.
+     *
+     * Coupons on the source cart are NOT carried to the destination
+     * (R-05 / FR-010 — the destination's existing `appliedPromotionCode`
+     * is preserved verbatim).
+     */
+    async mergeAnonymousIntoCustomer(anonymousToken, ctx) {
+        const em = this.emFactory();
+        // Look up the source first so the noop_no_anon branch can skip the
+        // destination-cart creation. Per the spec, the diagnostic still
+        // includes a destinationCartId so the storefront has a stable id to
+        // re-read its cart from on next render.
+        const anon = await em.findOne(Cart, { anonymousCartToken: anonymousToken, status: 'active' });
+        if (!anon) {
+            const destForNoop = await this.#getOrCreateForCustomerOn(em, ctx);
+            return {
+                outcome: 'noop_no_anon',
+                movedLineCount: 0,
+                summedLineCount: 0,
+                destinationCartId: destForNoop.id,
+            };
+        }
+        // Detect "the customer's destination cart was newly created right now":
+        // peek for an existing active cart row BEFORE calling the get-or-create
+        // helper. If absent and the source has items, we will return `adopted`.
+        const preExistingDest = await em.findOne(Cart, {
+            customerAccountId: ctx.customerAccountId,
+            status: 'active',
+        });
+        const customerCart = preExistingDest ?? (await this.#getOrCreateForCustomerOn(em, ctx));
+        let movedLineCount = 0;
+        let summedLineCount = 0;
+        const anonItems = await em.find(CartItem, { cartId: anon.id });
+        for (const item of anonItems) {
+            const existing = await em.findOne(CartItem, {
+                cartId: customerCart.id,
+                productId: item.productId,
+                variantId: item.variantId ?? null,
+            });
+            if (existing) {
+                existing.quantity += item.quantity;
+                summedLineCount += 1;
+            }
+            else {
+                item.cartId = customerCart.id;
+                movedLineCount += 1;
+            }
+        }
+        // Merge complete — mark the source anonymous cart as `completed` even
+        // when the merge was a noop_empty (it never produced anything down-
+        // stream, but leaving it `active` would let the abandonment sweep
+        // pick it up later, and leaving the token live would let a second
+        // login try to re-merge an already-consumed source). Treating it as
+        // `abandoned` would falsely flag it for the abandonment-notification
+        // sweep. See feature 027 §R10.
+        anon.status = 'completed';
+        anon.anonymousCartToken = null;
+        const isNoopEmpty = movedLineCount + summedLineCount === 0;
+        const outcome = isNoopEmpty
+            ? 'noop_empty'
+            : preExistingDest
+                ? 'merged'
+                : 'adopted';
+        // Audit only on observable state-changes on the destination cart
+        // (R-08). noop_empty and noop_no_anon are not destination-state
+        // changes and are observable in the application log instead.
+        if ((outcome === 'adopted' || outcome === 'merged') && this.auditService) {
+            const sourceAnonTokenHash = createHash('sha256').update(anonymousToken).digest('hex');
+            await this.auditService.record({
+                cartId: customerCart.id,
+                actorType: 'system',
+                action: 'cart_merged_from_anon',
+                metadata: {
+                    sourceAnonTokenHash,
+                    outcome,
+                    movedLineCount,
+                    summedLineCount,
+                },
+            });
+        }
+        await em.flush();
+        return {
+            outcome,
+            movedLineCount,
+            summedLineCount,
+            destinationCartId: customerCart.id,
+        };
+    }
+    async clearForCustomer(ctx) {
+        // command-coverage-ignore: empties the ephemeral cart — transient pre-order
+        // working state; the resulting order captures the audited final state.
+        const em = this.emFactory();
+        const cart = await em.findOne(Cart, {
+            customerAccountId: ctx.customerAccountId,
+            status: 'active',
+        });
+        if (!cart)
+            return;
+        await em.nativeDelete(CartItem, { cartId: cart.id });
+        cart.status = 'completed';
+        await em.flush();
+    }
+    #assertOwnership(cart, actor) {
+        if (actor.customer && cart.customerAccountId === actor.customer.customerAccountId)
+            return;
+        if (actor.anonymousToken && cart.anonymousCartToken === actor.anonymousToken)
+            return;
+        throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Cart not found.');
+    }
+}
+/**
+ * The {@link ProductAudience} a cart operation speaks for (issue #227).
+ *
+ * An anonymous cart is the anonymous audience — the token in the cookie
+ * identifies a basket, not a buyer, and it is minted by asking for one. A
+ * signed-in shopper carries their Organization, `null` included: the guest-style
+ * accounts of feature 026 have none, and they are exactly the caller
+ * `logged_in_only` distinguishes from the public.
+ */
+function cartAudience(actor) {
+    if (!actor.customer)
+        return ANONYMOUS_PRODUCT_AUDIENCE;
+    return { organizationId: actor.customer.organizationId, authenticated: true };
+}
+//# sourceMappingURL=cart-service.js.map

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

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

package/dist/backend/services/cart-state-machine.d.ts

@@ -0,0 +1,51 @@
+import type { CartStatus, CartApprovalStatus } from '../entities/cart.entity.js';
+/**
+ * Pure state-machine helpers for the carts module (feature 027 US4).
+ *
+ * The cart has two orthogonal axes:
+ *   - main `status`:           active | abandoned | completed | rejected
+ *   - `approval_status`:       not_required | pending | approved
+ *                              | rejected_by_org_admin
+ *
+ * Production transitions are implemented by `CartService`,
+ * `CartApprovalService`, and the abandonment worker — all DB-coupled.
+ * This module exposes the same invariants as pure functions so the
+ * matrix can be unit-tested (feature 027 T084 / T085) and so callers
+ * (route handlers, audit-row builders) can reach decisions without
+ * duplicating the inline branching.
+ */
+export type ApprovalEvent = 'submit' | 'approve' | 'reject' | 'buyer_mutation' | 'policy_off' | 'policy_on';
+export type ApprovalTransitionFailure = 'already_terminal' | 'already_initiated' | 'not_pending' | 'not_applicable';
+export type ApprovalTransitionResult = {
+    ok: true;
+    next: CartApprovalStatus;
+} | {
+    ok: false;
+    reason: ApprovalTransitionFailure;
+};
+/**
+ * Returns the post-event approval state for a cart whose current
+ * approval state is `from`. Pre-flight checks (policy on, cart not
+ * empty, buyer-not-org-admin, etc.) live in the service layer; this
+ * function captures only the FSM legality of (state, event) pairs.
+ */
+export declare function nextApprovalState(from: CartApprovalStatus, event: ApprovalEvent): ApprovalTransitionResult;
+/**
+ * Primary CTA the storefront should render. Pure function over the
+ * cart's two-axis state. The route handler caches this on every cart
+ * read; see `routes.ts.serializeCart`.
+ */
+export type PrimaryCta = 'checkout' | 'submit_for_approval' | 'awaiting_approval' | 'blocked_by_organization';
+export declare function derivePrimaryCta(input: {
+    status: CartStatus;
+    approvalStatus: CartApprovalStatus;
+    requiresApproval?: boolean;
+}): PrimaryCta;
+/**
+ * `true` when an `approved` cart should be silently re-armed to
+ * `pending` because the buyer just mutated it. Lives here so the
+ * various write paths (add / update / remove / coupon apply / coupon
+ * clear) all agree on the same rule.
+ */
+export declare function shouldReArmOnBuyerMutation(approvalStatus: CartApprovalStatus): boolean;
+//# sourceMappingURL=cart-state-machine.d.ts.map

package/dist/backend/services/cart-state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-state-machine.d.ts","sourceRoot":"","sources":["../../../src/backend/services/cart-state-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEjF;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,gBAAgB,GAChB,YAAY,GACZ,WAAW,CAAC;AAEhB,MAAM,MAAM,yBAAyB,GACjC,kBAAkB,GAClB,mBAAmB,GACnB,aAAa,GACb,gBAAgB,CAAC;AAErB,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,aAAa,GACnB,wBAAwB,CA0C1B;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,qBAAqB,GACrB,mBAAmB,GACnB,yBAAyB,CAAC;AAE9B,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,kBAAkB,CAAC;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GAAG,UAAU,CAeb;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,kBAAkB,GACjC,OAAO,CAET"}