@cogenta/commerce 0.2.0

package/dist/cart/store.js

@@ -0,0 +1,342 @@
+import { CogentaError, identifier, newId, sql } from '@cogenta/core';
+import { assertCurrency } from '../money.js';
+import { toInt, toNullableText, toText } from '../rows.js';
+import { TABLES } from '../tables.js';
+import { computeTotals } from './totals.js';
+export const CART_STATUSES = ['open', 'ordered', 'abandoned'];
+/** Thirty days. Long enough to be a real "saved basket", short enough that the
+ * table does not become a graveyard nobody ever prunes. */
+export const CART_TTL_MS = 30 * 24 * 60 * 60 * 1000;
+export function createCartStore(db, dependencies, now = Date.now) {
+    const d = db.dialect;
+    const carts = identifier(TABLES.carts, d);
+    const cartLines = identifier(TABLES.cartLines, d);
+    const stamp = () => new Date(now()).toISOString();
+    async function linesOf(cartId) {
+        const result = await db.query(sql `select * from ${cartLines} where cart_id = ${cartId} order by created_at asc, id asc`);
+        return result.rows.map((row) => ({
+            id: toText(row.id, 'cart_line.id'),
+            variantId: toText(row.variant_id, 'cart_line.variant_id'),
+            quantity: toInt(row.quantity, 'cart_line.quantity'),
+            unitPriceMinor: toInt(row.unit_price_minor, 'cart_line.unit_price_minor'),
+        }));
+    }
+    async function decode(row) {
+        const id = toText(row.id, 'cart.id');
+        return {
+            id,
+            customerId: toNullableText(row.customer_id),
+            sessionKey: toNullableText(row.session_key),
+            currency: toText(row.currency, 'cart.currency'),
+            couponCode: toNullableText(row.coupon_code),
+            shippingCountry: toNullableText(row.shipping_country),
+            shippingRegion: toNullableText(row.shipping_region),
+            shippingMethodId: toNullableText(row.shipping_method_id),
+            status: toText(row.status, 'cart.status'),
+            orderId: toNullableText(row.order_id),
+            lines: await linesOf(id),
+            createdAt: toText(row.created_at, 'cart.created_at'),
+            updatedAt: toText(row.updated_at, 'cart.updated_at'),
+            expiresAt: toText(row.expires_at, 'cart.expires_at'),
+        };
+    }
+    async function read(id) {
+        const result = await db.query(sql `select * from ${carts} where id = ${id}`);
+        const row = result.rows[0];
+        return row === undefined ? null : decode(row);
+    }
+    /** An open cart, or a refusal that says which of the two things went wrong. */
+    async function openCart(id) {
+        const cart = await read(id);
+        if (cart === null) {
+            throw new CogentaError({
+                code: 'COMMERCE_CART_NOT_FOUND',
+                message: 'This basket no longer exists.',
+                hint: 'Start a new basket. A basket is kept for thirty days.',
+            });
+        }
+        if (cart.status !== 'open') {
+            throw new CogentaError({
+                code: 'COMMERCE_CART_CLOSED',
+                message: cart.status === 'ordered'
+                    ? 'This basket has already been ordered.'
+                    : 'This basket was abandoned.',
+                hint: cart.status === 'ordered'
+                    ? 'Look at the order rather than the basket it came from.'
+                    : 'Start a new basket.',
+                details: { cartId: cart.id, status: cart.status },
+            });
+        }
+        return cart;
+    }
+    async function touch(id) {
+        await db.query(sql `update ${carts} set updated_at = ${stamp()} where id = ${id}`);
+        const cart = await read(id);
+        if (cart === null) {
+            throw new CogentaError({
+                code: 'COMMERCE_CART_NOT_FOUND',
+                message: 'This basket no longer exists.',
+                hint: 'Start a new basket.',
+            });
+        }
+        return cart;
+    }
+    function assertQuantity(quantity) {
+        if (!Number.isInteger(quantity) || quantity <= 0 || quantity > 10_000) {
+            throw new CogentaError({
+                code: 'COMMERCE_QUANTITY_INVALID',
+                message: `A basket quantity must be a whole number between 1 and 10000, got ${String(quantity)}.`,
+                hint: 'To remove a line, remove it. A quantity of zero is not a line.',
+            });
+        }
+        return quantity;
+    }
+    return {
+        open: async (input) => {
+            const id = newId(now);
+            const at = stamp();
+            const expires = new Date(now() + (input.ttlMs ?? CART_TTL_MS)).toISOString();
+            await db.query(sql `
+        insert into ${carts} (id, customer_id, session_key, currency, coupon_code,
+                              shipping_country, shipping_region, shipping_method_id,
+                              status, order_id, created_at, updated_at, expires_at)
+        values (${id}, ${input.customerId ?? null}, ${input.sessionKey ?? null},
+                ${assertCurrency(input.currency)}, ${null}, ${null}, ${null}, ${null},
+                ${'open'}, ${null}, ${at}, ${at}, ${expires})`);
+            return touch(id);
+        },
+        read,
+        find: async (owner) => {
+            const at = stamp();
+            const result = owner.customerId !== undefined
+                ? await db.query(sql `
+              select * from ${carts}
+              where customer_id = ${owner.customerId} and status = ${'open'} and expires_at > ${at}
+              order by updated_at desc`)
+                : await db.query(sql `
+              select * from ${carts}
+              where session_key = ${owner.sessionKey ?? ''} and status = ${'open'} and expires_at > ${at}
+              order by updated_at desc`);
+            const row = result.rows[0];
+            return row === undefined ? null : decode(row);
+        },
+        addLine: async (cartId, variantId, quantity) => {
+            const cart = await openCart(cartId);
+            assertQuantity(quantity);
+            const variant = await dependencies.catalog.readVariant(variantId);
+            if (variant === null) {
+                throw new CogentaError({
+                    code: 'COMMERCE_VARIANT_NOT_FOUND',
+                    message: 'This product variant does not exist.',
+                    hint: 'It may have been withdrawn from sale.',
+                });
+            }
+            if (variant.currency !== cart.currency) {
+                throw new CogentaError({
+                    code: 'COMMERCE_CURRENCY_MISMATCH',
+                    message: `"${variant.title}" is priced in ${variant.currency}, and this basket is in ${cart.currency}.`,
+                    hint: 'A basket holds one currency. Start a new basket for another one.',
+                });
+            }
+            const existing = cart.lines.find((line) => line.variantId === variantId);
+            if (existing !== undefined) {
+                // Adding the same thing twice adds to the line rather than making a
+                // second one. Two lines for one variant is the shape that lets a
+                // per-line stock check oversell.
+                assertQuantity(existing.quantity + quantity);
+                await db.query(sql `
+          update ${cartLines} set quantity = ${existing.quantity + quantity}, updated_at = ${stamp()}
+          where id = ${existing.id}`);
+            }
+            else {
+                const at = stamp();
+                await db.query(sql `
+          insert into ${cartLines} (id, cart_id, variant_id, quantity, unit_price_minor, created_at, updated_at)
+          values (${newId(now)}, ${cartId}, ${variantId}, ${quantity}, ${variant.priceMinor}, ${at}, ${at})`);
+            }
+            return touch(cartId);
+        },
+        setLineQuantity: async (cartId, variantId, quantity) => {
+            await openCart(cartId);
+            assertQuantity(quantity);
+            await db.query(sql `
+        update ${cartLines} set quantity = ${quantity}, updated_at = ${stamp()}
+        where cart_id = ${cartId} and variant_id = ${variantId}`);
+            return touch(cartId);
+        },
+        removeLine: async (cartId, variantId) => {
+            await openCart(cartId);
+            await db.query(sql `delete from ${cartLines} where cart_id = ${cartId} and variant_id = ${variantId}`);
+            return touch(cartId);
+        },
+        setAddress: async (cartId, zone) => {
+            await openCart(cartId);
+            await db.query(sql `
+        update ${carts}
+        set shipping_country = ${zone?.country.toUpperCase() ?? null},
+            shipping_region = ${zone?.region ?? null},
+            updated_at = ${stamp()}
+        where id = ${cartId}`);
+            return touch(cartId);
+        },
+        setShippingMethod: async (cartId, methodId) => {
+            await openCart(cartId);
+            await db.query(sql `update ${carts} set shipping_method_id = ${methodId}, updated_at = ${stamp()} where id = ${cartId}`);
+            return touch(cartId);
+        },
+        applyCoupon: async (cartId, code) => {
+            const cart = await openCart(cartId);
+            if (code === null) {
+                await db.query(sql `update ${carts} set coupon_code = ${null}, updated_at = ${stamp()} where id = ${cartId}`);
+                return touch(cartId);
+            }
+            // Checked here, and checked again when the order is placed. The first
+            // check is for the shopper (a clear message now, not at payment); the
+            // second is the one that is authoritative, because a coupon can expire
+            // or run out between the two.
+            const priced = await priceOf(cart);
+            const check = await dependencies.coupons.check(code, priced.totals.subtotalMinor, cart.currency);
+            if (check.kind !== 'ok') {
+                throw couponRefusal(check);
+            }
+            await db.query(sql `update ${carts} set coupon_code = ${check.coupon.code}, updated_at = ${stamp()} where id = ${cartId}`);
+            return touch(cartId);
+        },
+        claim: async (cartId, customerId) => {
+            await openCart(cartId);
+            await db.query(sql `update ${carts} set customer_id = ${customerId}, updated_at = ${stamp()} where id = ${cartId}`);
+            return touch(cartId);
+        },
+        price: async (cartId) => {
+            const cart = await read(cartId);
+            if (cart === null) {
+                throw new CogentaError({
+                    code: 'COMMERCE_CART_NOT_FOUND',
+                    message: 'This basket no longer exists.',
+                    hint: 'Start a new basket.',
+                });
+            }
+            return priceOf(cart);
+        },
+        abandon: async (cartId) => {
+            await db.query(sql `update ${carts} set status = ${'abandoned'}, updated_at = ${stamp()} where id = ${cartId} and status = ${'open'}`);
+        },
+    };
+    /** Prices a cart against the *live* catalogue, tax rules and coupon. */
+    async function priceOf(cart) {
+        const zone = cart.shippingCountry === null
+            ? null
+            : { country: cart.shippingCountry, region: cart.shippingRegion };
+        const lines = [];
+        const priceChanges = [];
+        const missingVariantIds = [];
+        const categories = new Set();
+        for (const line of cart.lines) {
+            const variant = await dependencies.catalog.readVariant(line.variantId);
+            if (variant === null) {
+                missingVariantIds.push(line.variantId);
+                continue;
+            }
+            if (variant.priceMinor !== line.unitPriceMinor) {
+                priceChanges.push({
+                    variantId: line.variantId,
+                    wasMinor: line.unitPriceMinor,
+                    nowMinor: variant.priceMinor,
+                });
+            }
+            categories.add(variant.taxCategory);
+            lines.push({
+                variantId: variant.id,
+                sku: variant.sku,
+                title: variant.title,
+                quantity: line.quantity,
+                // The live price wins, and the change is reported. A cart that quietly
+                // charges a stale price is a bug the shop only finds in its margins.
+                unitPriceMinor: variant.priceMinor,
+                taxCategory: variant.taxCategory,
+                weightGrams: variant.weightGrams,
+            });
+        }
+        categories.add('shipping');
+        const taxRules = new Map();
+        for (const category of categories) {
+            taxRules.set(category, await dependencies.tax.resolve(zone, category));
+        }
+        const subtotalMinor = lines.reduce((sum, line) => sum + line.unitPriceMinor * line.quantity, 0);
+        const weightGrams = lines.reduce((sum, line) => sum + line.weightGrams * line.quantity, 0);
+        let shippingMinor = 0;
+        if (cart.shippingMethodId !== null && lines.length > 0) {
+            const quote = await dependencies.shipping.quote(cart.shippingMethodId, zone, {
+                weightGrams,
+                subtotalMinor,
+                currency: cart.currency,
+            });
+            shippingMinor = quote.amountMinor;
+        }
+        // Re-checked, never trusted from the row: a coupon stored on the cart may
+        // have expired, been exhausted or been deactivated since it was applied.
+        let coupon = null;
+        if (cart.couponCode !== null) {
+            const check = await dependencies.coupons.check(cart.couponCode, subtotalMinor, cart.currency);
+            if (check.kind === 'ok')
+                coupon = check.coupon;
+        }
+        const totals = computeTotals({
+            currency: cart.currency,
+            lines,
+            taxRules,
+            coupon,
+            shippingMinor,
+            shippingTaxCategory: 'shipping',
+        });
+        return { cart, totals, priceChanges, missingVariantIds };
+    }
+}
+/** Turns a coupon check into the message a shopper should actually read. */
+export function couponRefusal(check) {
+    switch (check.kind) {
+        case 'unknown':
+            return new CogentaError({
+                code: 'COMMERCE_COUPON_NOT_FOUND',
+                message: 'This discount code does not exist.',
+                hint: 'Check the spelling. Codes are not case sensitive.',
+            });
+        case 'inactive':
+            return new CogentaError({
+                code: 'COMMERCE_COUPON_INVALID',
+                message: 'This discount code is no longer active.',
+                hint: 'The shop has withdrawn it.',
+            });
+        case 'not_yet':
+            return new CogentaError({
+                code: 'COMMERCE_COUPON_INVALID',
+                message: 'This discount code is not valid yet.',
+                hint: `It can be used from ${check.startsAt}.`,
+            });
+        case 'expired':
+            return new CogentaError({
+                code: 'COMMERCE_COUPON_INVALID',
+                message: 'This discount code has expired.',
+                hint: `It ended on ${check.endsAt}.`,
+            });
+        case 'exhausted':
+            return new CogentaError({
+                code: 'COMMERCE_COUPON_EXHAUSTED',
+                message: 'This discount code has been fully used.',
+                hint: 'It had a limited number of uses and they are all taken.',
+            });
+        case 'below_minimum':
+            return new CogentaError({
+                code: 'COMMERCE_COUPON_INVALID',
+                message: 'The basket is below the minimum for this discount code.',
+                hint: `It applies from a subtotal of ${String(check.minSubtotalMinor)} minor units.`,
+            });
+        case 'wrong_currency':
+            return new CogentaError({
+                code: 'COMMERCE_CURRENCY_MISMATCH',
+                message: `This discount code only applies to baskets in ${check.currency}.`,
+                hint: 'Use a code issued for this currency.',
+            });
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/cart/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/cart/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AAGzF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAE1D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAU,CAAA;AAuGtE;2DAC2D;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAEnD,MAAM,UAAU,eAAe,CAC7B,EAAkB,EAClB,YAAmC,EACnC,GAAG,GAAiB,IAAI,CAAC,GAAG;IAE5B,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAA;IACpB,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IACjD,MAAM,KAAK,GAAG,GAAW,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IAEzD,KAAK,UAAU,OAAO,CAAC,MAAc;QACnC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAC3B,GAAG,CAAA,iBAAiB,SAAS,oBAAoB,MAAM,kCAAkC,CAC1F,CAAA;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC/B,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,cAAc,CAAC;YAClC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,sBAAsB,CAAC;YACzD,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,oBAAoB,CAAC;YACnD,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE,4BAA4B,CAAC;SAC1E,CAAC,CAAC,CAAA;IACL,CAAC;IAED,KAAK,UAAU,MAAM,CAAC,GAAY;QAChC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAA;QACpC,OAAO;YACL,EAAE;YACF,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC;YAC3C,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC;YAC3C,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC;YAC/C,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC;YAC3C,eAAe,EAAE,cAAc,CAAC,GAAG,CAAC,gBAAgB,CAAC;YACrD,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,eAAe,CAAC;YACnD,gBAAgB,EAAE,cAAc,CAAC,GAAG,CAAC,kBAAkB,CAAC;YACxD,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAe;YACvD,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC;YACrC,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE,CAAC;YACxB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,iBAAiB,CAAC;YACpD,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,iBAAiB,CAAC;YACpD,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,iBAAiB,CAAC;SACrD,CAAA;IACH,CAAC;IAED,KAAK,UAAU,IAAI,CAAC,EAAU;QAC5B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAU,GAAG,CAAA,iBAAiB,KAAK,eAAe,EAAE,EAAE,CAAC,CAAA;QACpF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC1B,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC/C,CAAC;IAED,+EAA+E;IAC/E,KAAK,UAAU,QAAQ,CAAC,EAAU;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,CAAA;QAC3B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,+BAA+B;gBACxC,IAAI,EAAE,uDAAuD;aAC9D,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,sBAAsB;gBAC5B,OAAO,EACL,IAAI,CAAC,MAAM,KAAK,SAAS;oBACvB,CAAC,CAAC,uCAAuC;oBACzC,CAAC,CAAC,4BAA4B;gBAClC,IAAI,EACF,IAAI,CAAC,MAAM,KAAK,SAAS;oBACvB,CAAC,CAAC,wDAAwD;oBAC1D,CAAC,CAAC,qBAAqB;gBAC3B,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;aAClD,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,UAAU,KAAK,CAAC,EAAU;QAC7B,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA,UAAU,KAAK,qBAAqB,KAAK,EAAE,eAAe,EAAE,EAAE,CAAC,CAAA;QACjF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,CAAA;QAC3B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,+BAA+B;gBACxC,IAAI,EAAE,qBAAqB;aAC5B,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS,cAAc,CAAC,QAAgB;QACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,IAAI,QAAQ,GAAG,MAAM,EAAE,CAAC;YACtE,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,2BAA2B;gBACjC,OAAO,EAAE,qEAAqE,MAAM,CAAC,QAAQ,CAAC,GAAG;gBACjG,IAAI,EAAE,gEAAgE;aACvE,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACpB,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;YACrB,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;YAClB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;YAE5E,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;sBACF,KAAK;;;kBAGT,EAAE,KAAK,KAAK,CAAC,UAAU,IAAI,IAAI,KAAK,KAAK,CAAC,UAAU,IAAI,IAAI;kBAC5D,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI;kBAClE,MAAM,KAAK,IAAI,KAAK,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,CAAC,CAAA;YAEzD,OAAO,KAAK,CAAC,EAAE,CAAC,CAAA;QAClB,CAAC;QAED,IAAI;QAEJ,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACpB,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;YAClB,MAAM,MAAM,GACV,KAAK,CAAC,UAAU,KAAK,SAAS;gBAC5B,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAU,GAAG,CAAA;8BACT,KAAK;oCACC,KAAK,CAAC,UAAU,iBAAiB,MAAM,qBAAqB,EAAE;uCAC3D,CAAC;gBAC9B,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAU,GAAG,CAAA;8BACT,KAAK;oCACC,KAAK,CAAC,UAAU,IAAI,EAAE,iBAAiB,MAAM,qBAAqB,EAAE;uCACjE,CAAC,CAAA;YAElC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC1B,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC/C,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC7C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;YACnC,cAAc,CAAC,QAAQ,CAAC,CAAA;YAExB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;YACjE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,4BAA4B;oBAClC,OAAO,EAAE,sCAAsC;oBAC/C,IAAI,EAAE,uCAAuC;iBAC9C,CAAC,CAAA;YACJ,CAAC;YACD,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACvC,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,4BAA4B;oBAClC,OAAO,EAAE,IAAI,OAAO,CAAC,KAAK,kBAAkB,OAAO,CAAC,QAAQ,2BAA2B,IAAI,CAAC,QAAQ,GAAG;oBACvG,IAAI,EAAE,kEAAkE;iBACzE,CAAC,CAAA;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAA;YACxE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,oEAAoE;gBACpE,iEAAiE;gBACjE,iCAAiC;gBACjC,cAAc,CAAC,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAA;gBAC5C,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;mBACP,SAAS,mBAAmB,QAAQ,CAAC,QAAQ,GAAG,QAAQ,kBAAkB,KAAK,EAAE;uBAC7E,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAA;YAC/B,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,GAAG,KAAK,EAAE,CAAA;gBAClB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;wBACF,SAAS;oBACb,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,KAAK,SAAS,KAAK,QAAQ,KAAK,OAAO,CAAC,UAAU,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;YACvG,CAAC;YAED,OAAO,KAAK,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;QAED,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;YACrD,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;YACtB,cAAc,CAAC,QAAQ,CAAC,CAAA;YACxB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iBACP,SAAS,mBAAmB,QAAQ,kBAAkB,KAAK,EAAE;0BACpD,MAAM,qBAAqB,SAAS,EAAE,CAAC,CAAA;YAC3D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;QAED,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE;YACtC,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;YACtB,MAAM,EAAE,CAAC,KAAK,CACZ,GAAG,CAAA,eAAe,SAAS,oBAAoB,MAAM,qBAAqB,SAAS,EAAE,CACtF,CAAA;YACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;QAED,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YACjC,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;YACtB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAA;iBACP,KAAK;iCACW,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,IAAI;gCACpC,IAAI,EAAE,MAAM,IAAI,IAAI;2BACzB,KAAK,EAAE;qBACb,MAAM,EAAE,CAAC,CAAA;YACxB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;QAED,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;YAC5C,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;YACtB,MAAM,EAAE,CAAC,KAAK,CACZ,GAAG,CAAA,UAAU,KAAK,6BAA6B,QAAQ,kBAAkB,KAAK,EAAE,eAAe,MAAM,EAAE,CACxG,CAAA;YACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;QAED,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAClC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;YACnC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,MAAM,EAAE,CAAC,KAAK,CACZ,GAAG,CAAA,UAAU,KAAK,sBAAsB,IAAI,kBAAkB,KAAK,EAAE,eAAe,MAAM,EAAE,CAC7F,CAAA;gBACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAA;YACtB,CAAC;YAED,sEAAsE;YACtE,sEAAsE;YACtE,uEAAuE;YACvE,8BAA8B;YAC9B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;YAClC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAC5C,IAAI,EACJ,MAAM,CAAC,MAAM,CAAC,aAAa,EAC3B,IAAI,CAAC,QAAQ,CACd,CAAA;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACxB,MAAM,aAAa,CAAC,KAAK,CAAC,CAAA;YAC5B,CAAC;YAED,MAAM,EAAE,CAAC,KAAK,CACZ,GAAG,CAAA,UAAU,KAAK,sBAAsB,KAAK,CAAC,MAAM,CAAC,IAAI,kBAAkB,KAAK,EAAE,eAAe,MAAM,EAAE,CAC1G,CAAA;YACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;QAED,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE;YAClC,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;YACtB,MAAM,EAAE,CAAC,KAAK,CACZ,GAAG,CAAA,UAAU,KAAK,sBAAsB,UAAU,kBAAkB,KAAK,EAAE,eAAe,MAAM,EAAE,CACnG,CAAA;YACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;QAED,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAA;YAC/B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,yBAAyB;oBAC/B,OAAO,EAAE,+BAA+B;oBACxC,IAAI,EAAE,qBAAqB;iBAC5B,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;QACtB,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,MAAM,EAAE,CAAC,KAAK,CACZ,GAAG,CAAA,UAAU,KAAK,iBAAiB,WAAW,kBAAkB,KAAK,EAAE,eAAe,MAAM,iBAAiB,MAAM,EAAE,CACtH,CAAA;QACH,CAAC;KACF,CAAA;IAED,wEAAwE;IACxE,KAAK,UAAU,OAAO,CAAC,IAAU;QAC/B,MAAM,IAAI,GACR,IAAI,CAAC,eAAe,KAAK,IAAI;YAC3B,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,CAAA;QAEpE,MAAM,KAAK,GAAsB,EAAE,CAAA;QACnC,MAAM,YAAY,GAAgE,EAAE,CAAA;QACpF,MAAM,iBAAiB,GAAa,EAAE,CAAA;QACtC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAA;QAEpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACtE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBACtC,SAAQ;YACV,CAAC;YACD,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC/C,YAAY,CAAC,IAAI,CAAC;oBAChB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,QAAQ,EAAE,IAAI,CAAC,cAAc;oBAC7B,QAAQ,EAAE,OAAO,CAAC,UAAU;iBAC7B,CAAC,CAAA;YACJ,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;YACnC,KAAK,CAAC,IAAI,CAAC;gBACT,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,uEAAuE;gBACvE,qEAAqE;gBACrE,cAAc,EAAE,OAAO,CAAC,UAAU;gBAClC,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAA;QACJ,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAE1B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAA;QAClD,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAA;QACxE,CAAC;QAED,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;QAC/F,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;QAE1F,IAAI,aAAa,GAAG,CAAC,CAAA;QACrB,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE;gBAC3E,WAAW;gBACX,aAAa;gBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAA;YACF,aAAa,GAAG,KAAK,CAAC,WAAW,CAAA;QACnC,CAAC;QAED,0EAA0E;QAC1E,yEAAyE;QACzE,IAAI,MAAM,GAAG,IAAI,CAAA;QACjB,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC7F,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;gBAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;QAChD,CAAC;QAED,MAAM,MAAM,GAAG,aAAa,CAAC;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK;YACL,QAAQ;YACR,MAAM;YACN,aAAa;YACb,mBAAmB,EAAE,UAAU;SAChC,CAAC,CAAA;QAEF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAA;IAC1D,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAC3B,KAAyE;IAEzE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,IAAI,YAAY,CAAC;gBACtB,IAAI,EAAE,2BAA2B;gBACjC,OAAO,EAAE,oCAAoC;gBAC7C,IAAI,EAAE,mDAAmD;aAC1D,CAAC,CAAA;QACJ,KAAK,UAAU;YACb,OAAO,IAAI,YAAY,CAAC;gBACtB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,yCAAyC;gBAClD,IAAI,EAAE,4BAA4B;aACnC,CAAC,CAAA;QACJ,KAAK,SAAS;YACZ,OAAO,IAAI,YAAY,CAAC;gBACtB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,sCAAsC;gBAC/C,IAAI,EAAE,uBAAuB,KAAK,CAAC,QAAQ,GAAG;aAC/C,CAAC,CAAA;QACJ,KAAK,SAAS;YACZ,OAAO,IAAI,YAAY,CAAC;gBACtB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,iCAAiC;gBAC1C,IAAI,EAAE,eAAe,KAAK,CAAC,MAAM,GAAG;aACrC,CAAC,CAAA;QACJ,KAAK,WAAW;YACd,OAAO,IAAI,YAAY,CAAC;gBACtB,IAAI,EAAE,2BAA2B;gBACjC,OAAO,EAAE,yCAAyC;gBAClD,IAAI,EAAE,yDAAyD;aAChE,CAAC,CAAA;QACJ,KAAK,eAAe;YAClB,OAAO,IAAI,YAAY,CAAC;gBACtB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,yDAAyD;gBAClE,IAAI,EAAE,iCAAiC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,eAAe;aACrF,CAAC,CAAA;QACJ,KAAK,gBAAgB;YACnB,OAAO,IAAI,YAAY,CAAC;gBACtB,IAAI,EAAE,4BAA4B;gBAClC,OAAO,EAAE,iDAAiD,KAAK,CAAC,QAAQ,GAAG;gBAC3E,IAAI,EAAE,sCAAsC;aAC7C,CAAC,CAAA;IACN,CAAC;AACH,CAAC"}

package/dist/cart/totals.d.ts

@@ -0,0 +1,73 @@
+import type { Coupon } from '../coupon/store.js';
+import type { TaxRule } from '../tax/store.js';
+/**
+ * The one place an order total is computed.
+ *
+ * Deliberately a pure function over plain values, with no database handle and
+ * no store: the totals a cart shows and the totals an order is placed with
+ * must be produced by the same code, or the number on the confirmation page
+ * and the number charged to the card drift apart. Everything that varies —
+ * prices, rules, coupon — is passed in.
+ *
+ * The order of operations is the part worth being explicit about, because
+ * every ordering is defensible and only one is conventional:
+ *
+ *   1. line subtotal = unit price × quantity
+ *   2. the order discount is spread across lines in proportion to subtotal
+ *   3. tax is computed **per line, after discount** — a discount reduces the
+ *      tax owed, and a per-line rate is needed because two lines can sit in
+ *      different tax categories
+ *   4. shipping is added, and taxed under its own category
+ *   5. total = subtotal − discount + shipping + tax added (tax *included* is
+ *      already inside the subtotal and is never added again)
+ *
+ * Step 3 after step 2 is what an invoice has to show. Taxing before the
+ * discount overstates the tax and is, in most of Europe, simply wrong.
+ */
+export interface TotalsLineInput {
+    readonly variantId: string;
+    readonly sku: string;
+    readonly title: string;
+    readonly quantity: number;
+    readonly unitPriceMinor: number;
+    readonly taxCategory: string;
+    readonly weightGrams: number;
+}
+export interface TotalsLine {
+    readonly variantId: string;
+    readonly sku: string;
+    readonly title: string;
+    readonly quantity: number;
+    readonly unitPriceMinor: number;
+    readonly subtotalMinor: number;
+    readonly discountMinor: number;
+    readonly taxMinor: number;
+    readonly taxRateBp: number;
+    /** What this line contributes to the order total. */
+    readonly totalMinor: number;
+}
+export interface TotalsInput {
+    readonly currency: string;
+    readonly lines: readonly TotalsLineInput[];
+    /** Resolved tax rule per tax category. A missing category means no tax. */
+    readonly taxRules: ReadonlyMap<string, TaxRule | null>;
+    readonly coupon?: Coupon | null;
+    readonly shippingMinor?: number;
+    /** The category the shipping line is taxed under. */
+    readonly shippingTaxCategory?: string;
+}
+export interface Totals {
+    readonly currency: string;
+    readonly lines: readonly TotalsLine[];
+    readonly subtotalMinor: number;
+    readonly discountMinor: number;
+    readonly shippingMinor: number;
+    /** Tax **added** on top. Tax already included in prices is not counted here. */
+    readonly taxMinor: number;
+    /** Tax already contained in the prices shown. Reported, never added. */
+    readonly taxIncludedMinor: number;
+    readonly totalMinor: number;
+    readonly weightGrams: number;
+}
+export declare function computeTotals(input: TotalsInput): Totals;
+//# sourceMappingURL=totals.d.ts.map

package/dist/cart/totals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"totals.d.ts","sourceRoot":"","sources":["../../src/cart/totals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAGhD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAG9C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAA;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC,CAAA;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CACtC;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAA;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAqExD"}

package/dist/cart/totals.js

@@ -0,0 +1,65 @@
+import { discountFor } from '../coupon/store.js';
+import { assertSameCurrency, distribute } from '../money.js';
+import { taxFor } from '../tax/store.js';
+export function computeTotals(input) {
+    const currency = assertSameCurrency(input.currency, input.currency);
+    const subtotals = input.lines.map((line) => line.unitPriceMinor * line.quantity);
+    const subtotalMinor = subtotals.reduce((sum, value) => sum + value, 0);
+    const weightGrams = input.lines.reduce((sum, line) => sum + line.weightGrams * line.quantity, 0);
+    const couponOutcome = input.coupon == null
+        ? { discountMinor: 0, freeShipping: false }
+        : discountFor(input.coupon, subtotalMinor);
+    const discountMinor = couponOutcome.discountMinor;
+    const shippingMinor = couponOutcome.freeShipping ? 0 : (input.shippingMinor ?? 0);
+    // The order-level discount attributed to lines, exactly — `distribute`
+    // hands out the remainder so the parts sum to the whole. Rounding each
+    // line independently would lose or invent up to one minor unit per line,
+    // and an invoice whose lines do not add up to its total is not an invoice.
+    const lineDiscounts = distribute(discountMinor, subtotals);
+    let taxMinor = 0;
+    let taxIncludedMinor = 0;
+    const lines = input.lines.map((line, index) => {
+        const lineSubtotal = subtotals[index] ?? 0;
+        const lineDiscount = lineDiscounts[index] ?? 0;
+        const taxable = lineSubtotal - lineDiscount;
+        const rule = input.taxRules.get(line.taxCategory) ?? null;
+        const outcome = taxFor(taxable, rule);
+        if (outcome.includedInPrice)
+            taxIncludedMinor += outcome.taxMinor;
+        else
+            taxMinor += outcome.taxMinor;
+        return {
+            variantId: line.variantId,
+            sku: line.sku,
+            title: line.title,
+            quantity: line.quantity,
+            unitPriceMinor: line.unitPriceMinor,
+            subtotalMinor: lineSubtotal,
+            discountMinor: lineDiscount,
+            taxMinor: outcome.taxMinor,
+            taxRateBp: outcome.rateBp,
+            totalMinor: taxable + (outcome.includedInPrice ? 0 : outcome.taxMinor),
+        };
+    });
+    if (shippingMinor > 0) {
+        const shippingRule = input.taxRules.get(input.shippingTaxCategory ?? 'shipping') ?? null;
+        const shippingTax = taxFor(shippingMinor, shippingRule);
+        if (shippingTax.includedInPrice)
+            taxIncludedMinor += shippingTax.taxMinor;
+        else
+            taxMinor += shippingTax.taxMinor;
+    }
+    const totalMinor = subtotalMinor - discountMinor + shippingMinor + taxMinor;
+    return {
+        currency,
+        lines,
+        subtotalMinor,
+        discountMinor,
+        shippingMinor,
+        taxMinor,
+        taxIncludedMinor,
+        totalMinor,
+        weightGrams,
+    };
+}
+//# sourceMappingURL=totals.js.map

package/dist/cart/totals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"totals.js","sourceRoot":"","sources":["../../src/cart/totals.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE5D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AA4ExC,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;IAEnE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;IAChF,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAA;IACtE,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IAEhG,MAAM,aAAa,GACjB,KAAK,CAAC,MAAM,IAAI,IAAI;QAClB,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE;QAC3C,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAE9C,MAAM,aAAa,GAAG,aAAa,CAAC,aAAa,CAAA;IACjD,MAAM,aAAa,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC,CAAA;IAEjF,uEAAuE;IACvE,uEAAuE;IACvE,yEAAyE;IACzE,2EAA2E;IAC3E,MAAM,aAAa,GAAG,UAAU,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;IAE1D,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,IAAI,gBAAgB,GAAG,CAAC,CAAA;IAExB,MAAM,KAAK,GAAiB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC1D,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1C,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC9C,MAAM,OAAO,GAAG,YAAY,GAAG,YAAY,CAAA;QAE3C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAA;QACzD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAErC,IAAI,OAAO,CAAC,eAAe;YAAE,gBAAgB,IAAI,OAAO,CAAC,QAAQ,CAAA;;YAC5D,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAA;QAEjC,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,aAAa,EAAE,YAAY;YAC3B,aAAa,EAAE,YAAY;YAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,MAAM;YACzB,UAAU,EAAE,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;SACvE,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,IAAI,UAAU,CAAC,IAAI,IAAI,CAAA;QACxF,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;QACvD,IAAI,WAAW,CAAC,eAAe;YAAE,gBAAgB,IAAI,WAAW,CAAC,QAAQ,CAAA;;YACpE,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAA;IACvC,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,aAAa,GAAG,QAAQ,CAAA;IAE3E,OAAO;QACL,QAAQ;QACR,KAAK;QACL,aAAa;QACb,aAAa;QACb,aAAa;QACb,QAAQ;QACR,gBAAgB;QAChB,UAAU;QACV,WAAW;KACZ,CAAA;AACH,CAAC"}

package/dist/catalog/store.d.ts

@@ -0,0 +1,53 @@
+import { type DatabaseHandle, type SqlExecutor } from '@cogenta/core';
+import type { CreateProductInput, CreateVariantInput, Product, ProductStatus, StockRequest, StockShortfall, UpdateProductInput, UpdateVariantInput, Variant } from './types.js';
+export interface ProductListOptions {
+    readonly status?: ProductStatus;
+    /** Case-insensitive substring of handle or title. */
+    readonly search?: string;
+    readonly limit?: number;
+    readonly offset?: number;
+}
+/**
+ * The outcome of taking stock. Never a boolean and never a throw for the
+ * ordinary case: "the last one just went" is a normal thing to happen in a
+ * shop, and the caller needs to know *which* line was short and by how much.
+ */
+export type StockOutcome = {
+    readonly kind: 'taken';
+} | {
+    readonly kind: 'short';
+    readonly shortfalls: readonly StockShortfall[];
+};
+export interface CatalogStore {
+    createProduct(input: CreateProductInput): Promise<Product>;
+    readProduct(id: string): Promise<Product | null>;
+    readProductByHandle(handle: string): Promise<Product | null>;
+    updateProduct(id: string, input: UpdateProductInput): Promise<Product>;
+    /** Archives. A product that has ever been ordered is never deleted: an order
+     * line copies what it needs, but the admin still wants the trail. */
+    archiveProduct(id: string): Promise<Product>;
+    deleteProduct(id: string): Promise<void>;
+    listProducts(options?: ProductListOptions): Promise<readonly Product[]>;
+    createVariant(input: CreateVariantInput): Promise<Variant>;
+    readVariant(id: string): Promise<Variant | null>;
+    readVariantBySku(sku: string): Promise<Variant | null>;
+    updateVariant(id: string, input: UpdateVariantInput): Promise<Variant>;
+    deleteVariant(id: string): Promise<void>;
+    listVariants(productId: string): Promise<readonly Variant[]>;
+    /** Sets absolute stock. For a stock take, never for a sale. */
+    setStock(variantId: string, onHand: number): Promise<Variant>;
+    /** Adds to stock. For a delivery, and for putting a cancelled order back. */
+    restock(requests: readonly StockRequest[], tx?: SqlExecutor): Promise<void>;
+    /**
+     * Takes stock for a sale, atomically, all lines or none.
+     *
+     * The only correct way to lower stock in this package. Runs in one immediate
+     * transaction and lowers each line with `update … set on_hand = on_hand - :n
+     * where id = :id and on_hand >= :n`, reading `rowsAffected`. Two shoppers
+     * racing for the last unit both pass the read, and exactly one passes the
+     * UPDATE — which is the difference between a shop and an oversold shop.
+     */
+    takeStock(requests: readonly StockRequest[], tx?: SqlExecutor): Promise<StockOutcome>;
+}
+export declare function createCatalogStore(db: DatabaseHandle, now?: () => number): CatalogStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/catalog/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/catalog/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAInB,KAAK,WAAW,EAGjB,MAAM,eAAe,CAAA;AAItB,OAAO,KAAK,EAEV,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACR,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,CAAA;AAE9E,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAChD,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAC5D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtE;yEACqE;IACrE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5C,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,YAAY,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IAEvE,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAChD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACtD,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IAE5D,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7D,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3E;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CACtF;AA+GD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,GAAE,MAAM,MAAiB,GAAG,YAAY,CAqUjG"}