shutro-erp 0.3.4 → 0.3.6

package/dist/pos/routes.js

@@ -0,0 +1,368 @@
+/**
+ * Counter's routes (RFC 0021): what the register needs in few calls — the shop's catalogue, the cashier's open
+ * session, a sale posted whole (lines and payments, accepted once by its client id, paid at once), a session
+ * closed with its count.
+ *
+ * - `GET  /api/v1/counter/shops`                  the shops the cashier may sell in, with their payment methods
+ * - `GET  /api/v1/counter/catalogue?shop=`         products for the register: price, taxes, barcode, picture
+ * - `GET  /api/v1/counter/session?shop=`           the cashier's open session at the shop, or null
+ * - `POST /api/v1/counter/sessions`                `{ shop, openingCash }`: a session opened
+ * - `POST /api/v1/counter/orders`                  a sale: `{ session, clientId, partner?, lines, payments, note? }`
+ * - `POST /api/v1/counter/sessions/:id/close`      `{ closingCash, differenceReason? }`: the count, then closed
+ */
+import { mailerFromEnv } from '../mail/index.js';
+import { messengerFromEnv } from '../notify/index.js';
+import { documentFields, renderDocument } from '../reporting/index.js';
+import { HttpProblem, publicApiModels } from '../server/index.js';
+import { orm } from '../server/orm.js';
+const idOf = (value, what) => {
+    const id = Number(value);
+    if (!Number.isSafeInteger(id) || id <= 0)
+        throw new HttpProblem(400, 'invalid-id', 'Invalid id', `${what} is a positive integer.`);
+    return id;
+};
+const text = (value) => (typeof value === 'string' ? value.trim() : '');
+export function registerCounterRoutes(context, options = {}) {
+    const { app } = context;
+    const mailer = 'mailer' in options ? options.mailer : mailerFromEnv();
+    const messenger = 'messenger' in options ? options.messenger : messengerFromEnv();
+    const models = publicApiModels(context.registry);
+    const fields = documentFields(models);
+    // `POST /api/v1/counter/orders/:id/receipt` `{ email?, phone? }`: the receipt sent — the document by email,
+    // a summary by text; what was sent is said back.
+    app.post('/api/v1/counter/orders/:id/receipt', async (request) => {
+        const id = idOf(request.params.id, 'id');
+        const body = (request.body ?? {});
+        const email = text(body.email);
+        const phone = text(body.phone);
+        if (email === '' && phone === '')
+            throw new HttpProblem(422, 'no-address', 'Nowhere to send', 'Give an email address or a phone number.');
+        const model = models.get('pos.order');
+        if (model === undefined)
+            throw new HttpProblem(404, 'unknown-model', 'Unknown model', 'pos.order');
+        return request.env(async (raw) => {
+            const env = raw;
+            const order = await orderOut(env, id);
+            const sent = [];
+            if (email !== '') {
+                if (mailer === undefined)
+                    throw new HttpProblem(409, 'no-mailer', 'No email set up', 'Set SMTP_URL to send receipts by email.');
+                const [template] = (await (await env.model('report.template').search({ where: { key: 'pos.receipt' }, limit: 1 })).load([])).read(['id', 'name', 'layout', 'scope']);
+                if (template === undefined)
+                    throw new HttpProblem(409, 'no-template', 'No receipt template', 'Run the apps\u2019 defaults.');
+                const rendered = await renderDocument(env, model, template, fields, { ids: [id] }, 'html');
+                await mailer.send({
+                    to: email,
+                    subject: `Receipt ${String(order['name'])}`,
+                    text: receiptText(order),
+                    html: rendered.content.toString('utf8'),
+                });
+                sent.push('email');
+            }
+            if (phone !== '') {
+                if (messenger === undefined)
+                    throw new HttpProblem(409, 'no-messenger', 'No text messaging set up', 'Set up Twilio to send receipts by text.');
+                await messenger.send({ channel: 'sms', to: phone, text: receiptText(order) });
+                sent.push('sms');
+            }
+            return { sent };
+        });
+    });
+    app.get('/api/v1/counter/shops', async (request) => request.env(async (raw) => {
+        const env = raw;
+        const shops = await (await env.model('pos.shop').search({})).load({ methods: true });
+        return {
+            shops: shops.map((s) => ({
+                id: s.id,
+                name: s.name,
+                pricesIncludeTax: s.pricesIncludeTax,
+                receiptFooter: s.receiptFooter,
+                methods: [...s.methods].map((m) => ({ id: m.id, name: m.name, kind: m.kind })),
+            })),
+        };
+    }));
+    app.get('/api/v1/counter/catalogue', async (request) => request.env(async (raw) => {
+        const env = raw;
+        const products = await (await env
+            .model('product.product')
+            .search({ where: { saleOk: true }, order: ['name asc'], limit: 2000 })).load({ taxes: true, category: true, uom: true, image: true });
+        return {
+            products: products.map((p) => ({
+                id: p.id,
+                name: p.name,
+                code: p.code,
+                barcode: p.barcode,
+                price: p.listPrice.toString(),
+                category: p.category?.name ?? null,
+                uom: p.uom?.name ?? null,
+                image: p.image?.id ?? null,
+                taxes: [...p.taxes].map((t) => ({
+                    id: t.id,
+                    name: t.name,
+                    amountType: t.amountType,
+                    rate: t.rate.toString(),
+                    fixedAmount: t.fixedAmount.toString(),
+                })),
+            })),
+        };
+    }));
+    app.get('/api/v1/counter/session', async (request) => request.env(async (raw) => {
+        const env = raw;
+        const shop = idOf(request.query.shop, 'shop');
+        const [session] = await env.model('pos.session').search({
+            where: { shop: shop, cashier: env.userId, state: 'open' },
+            limit: 1,
+        });
+        return { session: session === undefined ? null : sessionOut(session) };
+    }));
+    app.post('/api/v1/counter/sessions', async (request, reply) => {
+        const body = (request.body ?? {});
+        const shop = idOf(body.shop, 'shop');
+        const openingCash = text(body.openingCash) || '0';
+        const made = await request.env(async (raw) => {
+            const env = raw;
+            const created = await env
+                .model('pos.session')
+                .create([
+                { shop: shop, openingCash: orm.toDecimal(openingCash) },
+            ]);
+            await env.flush();
+            const [s] = await env.model('pos.session').browse(created.ids);
+            return s === undefined ? null : sessionOut(s);
+        }, { write: true });
+        return reply.status(201).send({ session: made });
+    });
+    app.post('/api/v1/counter/orders', async (request, reply) => {
+        const input = request.body;
+        if (input === null ||
+            typeof input !== 'object' ||
+            !Array.isArray(input.lines) ||
+            !Array.isArray(input.payments))
+            throw new HttpProblem(400, 'invalid-body', 'Invalid sale', 'Send the session, the lines and the payments.');
+        if (input.lines.length === 0)
+            throw new HttpProblem(422, 'empty-sale', 'Nothing to sell', 'Add at least one line.');
+        const session = idOf(input.session, 'session');
+        const clientId = text(input.clientId);
+        const outcome = await request.env(async (raw) => {
+            const env = raw;
+            // The same sale sent twice (a device back online): the first one, unchanged.
+            if (clientId !== '') {
+                const [known] = await env.model('pos.order').search({
+                    where: { session: session, clientId },
+                    limit: 1,
+                });
+                if (known !== undefined)
+                    return { order: await orderOut(env, known.id), repeated: true };
+            }
+            const [current] = await env
+                .model('pos.session')
+                .browse([session])
+                .load({ shop: true });
+            if (current === undefined)
+                throw new HttpProblem(404, 'missing-record', 'Not found', 'No such session.');
+            const products = await env
+                .model('product.product')
+                .browse(input.lines.map((l) => idOf(l.product, 'product')))
+                .load({ taxes: true });
+            const byId = new Map(products.map((p) => [p.id, p]));
+            const created = await env.model('pos.order').create([
+                {
+                    session: session,
+                    pricesIncludeTax: current.shop.pricesIncludeTax === true,
+                    ...(clientId === '' ? {} : { clientId }),
+                    ...(input.partner === undefined || input.partner === null
+                        ? {}
+                        : { partner: idOf(input.partner, 'partner') }),
+                    ...(text(input.note) === '' ? {} : { note: text(input.note) }),
+                    lines: {
+                        create: input.lines.map((l) => {
+                            const product = byId.get(idOf(l.product, 'product'));
+                            if (product === undefined)
+                                throw new HttpProblem(422, 'unknown-product', 'Unknown product', `No product ${String(l.product)}.`);
+                            return {
+                                product: product.id,
+                                name: product.name,
+                                quantity: orm.toDecimal(text(l.quantity) || '1'),
+                                priceUnit: orm.toDecimal(text(l.priceUnit) || product.listPrice.toString()),
+                                discount: orm.toDecimal(text(l.discount) || '0'),
+                                taxes: { set: [...product.taxes].map((t) => t.id) },
+                            };
+                        }),
+                    },
+                    payments: {
+                        create: input.payments.map((p) => ({
+                            method: idOf(p.method, 'method'),
+                            amount: orm.toDecimal(text(p.amount) || '0'),
+                            ...(text(p.reference) === '' ? {} : { reference: text(p.reference) }),
+                        })),
+                    },
+                },
+            ]);
+            await env.flush();
+            await env.model('pos.order').browse(created.ids).pay();
+            await env.flush();
+            return { order: await orderOut(env, created.ids[0]), repeated: false };
+        }, { write: true });
+        return reply.status(outcome.repeated ? 200 : 201).send(outcome);
+    });
+    // `POST /api/v1/counter/orders/:id/refund` `{ session, reason, lines?: [{ product, quantity }], method? }`:
+    // the sale (or part of it) taken back — a negative sale in the open session, paid back by the method given
+    // (the shop's cash by default), linked to the original. Cashiers refund the sales of their own open session;
+    // `pos.refund_any` (managers) refunds any sale.
+    app.post('/api/v1/counter/orders/:id/refund', async (request, reply) => {
+        const id = idOf(request.params.id, 'id');
+        const body = (request.body ?? {});
+        const session = idOf(body.session, 'session');
+        const reason = text(body.reason);
+        if (reason === '')
+            throw new HttpProblem(422, 'reason-missing', 'Say why', 'A refund needs its reason.');
+        const made = await request.env(async (raw) => {
+            const env = raw;
+            const [original] = await env
+                .model('pos.order')
+                .browse([id])
+                .load({ lines: { taxes: true }, payments: { method: true }, session: true });
+            if (original === undefined || original.state !== 'paid')
+                throw new HttpProblem(404, 'missing-record', 'Not found', 'No paid sale with this id.');
+            const [current] = await env
+                .model('pos.session')
+                .browse([session])
+                .load({ shop: { methods: true } });
+            if (current === undefined || current.state !== 'open')
+                throw new HttpProblem(409, 'session-closed', 'Session closed', 'Refund in an open session.');
+            const mine = original.session.id === current.id;
+            let may = mine;
+            if (!may) {
+                try {
+                    may = env.access.has('pos.refund_any');
+                }
+                catch {
+                    may = false;
+                }
+            }
+            if (!may)
+                throw new HttpProblem(403, 'refund-forbidden', 'Not yours to refund', 'Cashiers refund the sales of their own open session; a manager refunds any sale.');
+            const wanted = new Map();
+            for (const l of body.lines ?? [])
+                wanted.set(idOf(l.product, 'product'), text(l.quantity) || '0');
+            const lines = [...original.lines]
+                .map((l) => {
+                const qty = wanted.size === 0 ? l.quantity : orm.toDecimal(wanted.get(l.product.id) ?? '0');
+                return { line: l, qty };
+            })
+                .filter(({ qty }) => qty.gt(0));
+            if (lines.length === 0)
+                throw new HttpProblem(422, 'nothing-to-refund', 'Nothing to refund', 'Give the quantities taken back.');
+            for (const { line, qty } of lines)
+                if (qty.gt(line.quantity))
+                    throw new HttpProblem(422, 'too-much', 'More than sold', `${line.name}: ${qty.toString()} of ${line.quantity.toString()} sold.`);
+            const methodId = body.method === undefined
+                ? ([...current.shop.methods].find((mm) => mm.kind === 'cash') ??
+                    [...current.shop.methods][0])?.id
+                : idOf(body.method, 'method');
+            if (methodId === undefined)
+                throw new HttpProblem(409, 'no-method', 'No payment method', 'The shop has no payment method.');
+            const created = await env.model('pos.order').create([
+                {
+                    session: session,
+                    pricesIncludeTax: original.pricesIncludeTax,
+                    partner: original.partner?.id ?? null,
+                    refundOf: original.id,
+                    refundReason: reason,
+                    note: `Refund of ${original.name}: ${reason}`,
+                    lines: {
+                        create: lines.map(({ line, qty }) => ({
+                            product: line.product.id,
+                            name: line.name,
+                            quantity: qty.neg(),
+                            priceUnit: line.priceUnit,
+                            discount: line.discount,
+                            taxes: { set: [...line.taxes].map((t) => t.id) },
+                        })),
+                    },
+                },
+            ]);
+            await env.flush();
+            const [draft] = await env.model('pos.order').browse(created.ids);
+            const total = draft?.total ?? orm.toDecimal(0);
+            await env
+                .model('pos.order.payment')
+                .create([{ order: created.ids[0], method: methodId, amount: total }]);
+            await env.flush();
+            await env.model('pos.order').browse(created.ids).pay();
+            await env.flush();
+            return orderOut(env, created.ids[0]);
+        }, { write: true });
+        return reply.status(201).send({ order: made });
+    });
+    app.post('/api/v1/counter/sessions/:id/close', async (request) => {
+        const id = idOf(request.params.id, 'id');
+        const body = (request.body ?? {});
+        const closingCash = text(body.closingCash);
+        if (closingCash === '')
+            throw new HttpProblem(422, 'count-missing', 'Count the cash', 'Send the cash counted in the drawer.');
+        return request.env(async (raw) => {
+            const env = raw;
+            const set = env.model('pos.session').browse([id]);
+            await set.write({
+                closingCash: orm.toDecimal(closingCash),
+                ...(text(body.differenceReason) === ''
+                    ? {}
+                    : { differenceReason: text(body.differenceReason) }),
+            });
+            await env.flush();
+            await set.close();
+            await env.flush();
+            const [s] = await env.model('pos.session').browse([id]);
+            return { session: s === undefined ? null : sessionOut(s) };
+        }, { write: true });
+    });
+}
+const textOrNull = (v) => v === null || v === undefined ? null : String(v);
+/** The receipt in a few lines of text (a text message, an email's plain part). */
+function receiptText(order) {
+    const lines = order['lines'].map((l) => `${l.name} × ${l.quantity}: ${l.subtotal}`);
+    return [
+        `Receipt ${String(order['name'])}`,
+        ...lines,
+        `Total ${String(order['total'])} (taxes ${String(order['amountTax'])})`,
+        `Paid ${String(order['amountPaid'])}, change ${String(order['change'])}`,
+    ].join(NEWLINE);
+}
+const NEWLINE = String.fromCharCode(10);
+function sessionOut(raw) {
+    const s = raw;
+    return {
+        id: s['id'],
+        name: String(s['name'] ?? ''),
+        state: String(s['state'] ?? ''),
+        openingCash: String(s['openingCash'] ?? '0'),
+        expectedCash: textOrNull(s['expectedCash']),
+        closingCash: textOrNull(s['closingCash']),
+        closingDifference: textOrNull(s['closingDifference']),
+        orderCount: typeof s['orderCount'] === 'number' ? s['orderCount'] : 0,
+        total: String(s['total'] ?? '0'),
+    };
+}
+async function orderOut(env, id) {
+    const [o] = await env.model('pos.order').browse([id]).load({ lines: true, payments: true });
+    if (o === undefined)
+        throw new HttpProblem(404, 'missing-record', 'Not found', 'No such sale.');
+    return {
+        id: o.id,
+        name: o.name,
+        state: o.state,
+        total: o.total?.toString() ?? '0',
+        amountTax: o.amountTax?.toString() ?? '0',
+        amountPaid: o.amountPaid?.toString() ?? '0',
+        change: o.change?.toString() ?? '0',
+        lines: [...o.lines].map((l) => ({
+            product: l.product.id,
+            name: l.name,
+            quantity: l.quantity.toString(),
+            priceUnit: l.priceUnit.toString(),
+            subtotal: l.subtotal?.toString() ?? '0',
+        })),
+        payments: [...o.payments].map((p) => ({ method: p.method.id, amount: p.amount.toString() })),
+    };
+}

package/dist/pos/web/Register.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The register (RFC 0021, Counter): a page for a tablet or a phone. The shop's products as tiles with pictures,
+ * search and a barcode box (a scanner types into it; Enter adds the match), the cart, the payment screen with
+ * several methods and the change, the receipt to print, the session opened with its cash and closed with its
+ * count. Totals here are the register's own arithmetic for the cashier's eye; the server computes the sale.
+ */
+import { type PageProps } from '../../ui/index.js';
+import { type ReactElement } from 'react';
+export declare function Register({ api }: PageProps): ReactElement;

package/dist/pos/web/Register.js

@@ -0,0 +1,252 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The register (RFC 0021, Counter): a page for a tablet or a phone. The shop's products as tiles with pictures,
+ * search and a barcode box (a scanner types into it; Enter adds the match), the cart, the payment screen with
+ * several methods and the change, the receipt to print, the session opened with its cash and closed with its
+ * count. Totals here are the register's own arithmetic for the cashier's eye; the server computes the sale.
+ */
+import { Alert, Button, Dialog, Input, Label, NetworkError, Spinner, useKosh, } from '../../ui/index.js';
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+const money = (n) => n.toFixed(2);
+/** The line's amount as the customer pays it (taxes added when the shop's prices do not include them). */
+function lineAmount(line, pricesIncludeTax) {
+    const gross = Number(line.product.price) * line.quantity;
+    if (pricesIncludeTax)
+        return gross;
+    const percent = line.product.taxes
+        .filter((t) => t.amountType === 'percent')
+        .reduce((sum, t) => sum + Number(t.rate), 0);
+    const fixed = line.product.taxes
+        .filter((t) => t.amountType === 'fixed')
+        .reduce((sum, t) => sum + Number(t.fixedAmount) * line.quantity, 0);
+    return gross + (gross * percent) / 100 + fixed;
+}
+export function Register({ api }) {
+    const { t } = useTranslation('pos');
+    const { format, offline } = useKosh();
+    const queryClient = useQueryClient();
+    const [queued, setQueued] = useState(0);
+    const shops = useQuery({
+        queryKey: ['counter', 'shops'],
+        queryFn: () => api.call('GET', '/api/v1/counter/shops').then((r) => r.shops),
+    });
+    const [shopId, setShopId] = useState(null);
+    const shop = (shops.data ?? []).find((s) => s.id === shopId) ??
+        (shops.data?.length === 1 ? shops.data[0] : undefined);
+    const session = useQuery({
+        queryKey: ['counter', 'session', shop?.id],
+        queryFn: () => api
+            .call('GET', `/api/v1/counter/session?shop=${shop?.id ?? 0}`)
+            .then((r) => r.session),
+        enabled: shop !== undefined,
+    });
+    const catalogue = useQuery({
+        queryKey: ['counter', 'catalogue', shop?.id],
+        queryFn: () => api
+            .call('GET', `/api/v1/counter/catalogue?shop=${shop?.id ?? 0}`)
+            .then((r) => r.products),
+        enabled: shop !== undefined,
+    });
+    const [query, setQuery] = useState('');
+    const [cart, setCart] = useState([]);
+    const [paying, setPaying] = useState(false);
+    const [closing, setClosing] = useState(false);
+    const [opening, setOpening] = useState('0');
+    const [closingCash, setClosingCash] = useState('');
+    const [reason, setReason] = useState('');
+    const [payments, setPayments] = useState({});
+    const [lastSale, setLastSale] = useState(null);
+    const [error, setError] = useState(null);
+    const clientId = useRef(crypto.randomUUID());
+    const search = useRef(null);
+    const products = catalogue.data ?? [];
+    const shown = useMemo(() => {
+        const q = query.trim().toLowerCase();
+        if (q === '')
+            return products.slice(0, 200);
+        return products
+            .filter((p) => p.name.toLowerCase().includes(q) ||
+            (p.code ?? '').toLowerCase().includes(q) ||
+            (p.barcode ?? '').toLowerCase() === q)
+            .slice(0, 200);
+    }, [products, query]);
+    const total = cart.reduce((sum, l) => sum + lineAmount(l, shop?.pricesIncludeTax ?? true), 0);
+    const paid = Object.values(payments).reduce((sum, v) => sum + (Number(v) || 0), 0);
+    const change = Math.max(0, paid - total);
+    const add = (p) => {
+        setCart((lines) => {
+            const i = lines.findIndex((l) => l.product.id === p.id);
+            if (i < 0)
+                return [...lines, { product: p, quantity: 1 }];
+            const next = [...lines];
+            next[i] = { product: p, quantity: (next[i]?.quantity ?? 0) + 1 };
+            return next;
+        });
+    };
+    const setQuantity = (id, quantity) => setCart((lines) => lines
+        .map((l) => (l.product.id === id ? { product: l.product, quantity } : l))
+        .filter((l) => l.quantity > 0 || l.quantity === 0));
+    const removeLine = (id) => setCart((lines) => lines.filter((l) => l.product.id !== id));
+    // A scanner types the barcode and sends Enter: the exact match goes to the cart, the box clears.
+    const onSearchKey = (key) => {
+        if (key !== 'Enter')
+            return;
+        const q = query.trim().toLowerCase();
+        const hit = products.find((p) => (p.barcode ?? '').toLowerCase() === q) ??
+            (shown.length === 1 ? shown[0] : undefined);
+        if (hit !== undefined) {
+            add(hit);
+            setQuery('');
+        }
+    };
+    useEffect(() => {
+        search.current?.focus();
+    }, []);
+    const open = useMutation({
+        mutationFn: () => api.call('POST', '/api/v1/counter/sessions', {
+            shop: shop?.id,
+            openingCash: opening,
+        }),
+        onSuccess: () => void queryClient.invalidateQueries({ queryKey: ['counter', 'session'] }),
+        onError: (e) => setError(e instanceof Error ? e.message : String(e)),
+    });
+    const sell = useMutation({
+        mutationFn: async () => {
+            const body = {
+                session: session.data?.id,
+                clientId: clientId.current,
+                lines: cart.map((l) => ({ product: l.product.id, quantity: String(l.quantity) })),
+                payments: Object.entries(payments)
+                    .filter(([, amount]) => Number(amount) > 0)
+                    .map(([method, amount]) => ({ method: Number(method), amount })),
+            };
+            try {
+                const r = await api.call('POST', '/api/v1/counter/orders', body);
+                return { order: r.order, queued: false };
+            }
+            catch (error) {
+                // Offline: the sale waits on the device, sent in order when the network is back, accepted once by
+                // its device reference (offline/queue.ts).
+                if (!(error instanceof NetworkError) || offline === undefined)
+                    throw error;
+                await offline.add({
+                    kind: 'request',
+                    method: 'POST',
+                    path: '/api/v1/counter/orders',
+                    model: 'pos.order',
+                    modelLabel: t('cart'),
+                    recordId: null,
+                    title: `${t('cart')} ${format.decimal(money(total))}`,
+                    values: body,
+                    etag: null,
+                });
+                return { order: null, queued: true };
+            }
+        },
+        onSuccess: (r) => {
+            if (r.queued)
+                setQueued((n) => n + 1);
+            setLastSale(r.order);
+            setCart([]);
+            setPayments({});
+            setPaying(false);
+            setError(null);
+            clientId.current = crypto.randomUUID();
+            void queryClient.invalidateQueries({ queryKey: ['counter', 'session'] });
+            search.current?.focus();
+        },
+        onError: (e) => setError(e instanceof Error ? e.message : String(e)),
+    });
+    const close = useMutation({
+        mutationFn: () => api.call('POST', `/api/v1/counter/sessions/${session.data?.id}/close`, {
+            closingCash,
+            differenceReason: reason,
+        }),
+        onSuccess: (r) => {
+            setClosing(false);
+            setLastSale(null);
+            setError(null);
+            void queryClient.invalidateQueries({ queryKey: ['counter', 'session'] });
+            setClosedInfo(r.session);
+        },
+        onError: (e) => setError(e instanceof Error ? e.message : String(e)),
+    });
+    const [closedInfo, setClosedInfo] = useState(null);
+    const [sendTo, setSendTo] = useState('');
+    const [refundReason, setRefundReason] = useState('');
+    // The whole last sale taken back, paid back in cash, with its reason.
+    const refund = useMutation({
+        mutationFn: (id) => api.call('POST', `/api/v1/counter/orders/${id}/refund`, {
+            session: session.data?.id,
+            reason: refundReason.trim(),
+        }),
+        onSuccess: (r) => {
+            setLastSale(r.order);
+            setRefundReason('');
+            setError(null);
+            void queryClient.invalidateQueries({ queryKey: ['counter', 'session'] });
+        },
+        onError: (e) => setError(e instanceof Error ? e.message : String(e)),
+    });
+    const [sentNote, setSentNote] = useState(null);
+    // The receipt by email or text: an address with an @ is an email, anything else a phone number.
+    const sendReceipt = useMutation({
+        mutationFn: (id) => api.call('POST', `/api/v1/counter/orders/${id}/receipt`, {
+            ...(sendTo.includes('@') ? { email: sendTo.trim() } : { phone: sendTo.trim() }),
+        }),
+        onSuccess: (r) => {
+            setSentNote(t('sent', { how: r.sent.join(', ') }));
+            setSendTo('');
+        },
+        onError: (e) => setError(e instanceof Error ? e.message : String(e)),
+    });
+    const printReceipt = async (sale) => {
+        try {
+            const { templates } = await api.call('GET', '/api/v1/models/pos.order/documents');
+            const template = templates.find((tpl) => tpl.name === 'Receipt') ??
+                templates.find((tpl) => tpl.scope === 'record');
+            if (template === undefined)
+                throw new Error(t('noReceiptTemplate'));
+            const file = await api.download(`/api/v1/models/pos.order/documents/${template.id}`, {
+                ids: [sale.id],
+            });
+            const url = URL.createObjectURL(file.blob);
+            window.open(url, '_blank', 'noopener');
+            setTimeout(() => URL.revokeObjectURL(url), 60_000);
+        }
+        catch (e) {
+            setError(e instanceof Error ? e.message : String(e));
+        }
+    };
+    if (shops.isPending)
+        return _jsx(Spinner, { label: t('loading') });
+    if ((shops.data ?? []).length === 0)
+        return _jsx(Alert, { tone: "info", children: t('noShops') });
+    if (shop === undefined)
+        return (_jsxs("div", { className: "grid gap-3", children: [_jsx("h2", { className: "text-base font-semibold", children: t('chooseShop') }), _jsx("div", { className: "grid grid-cols-[repeat(auto-fill,minmax(12rem,1fr))] gap-3", children: (shops.data ?? []).map((s) => (_jsx(Button, { size: "sm", variant: "secondary", onClick: () => setShopId(s.id), children: s.name }, s.id))) })] }));
+    if (session.isPending)
+        return _jsx(Spinner, { label: t('loading') });
+    if (session.data === null || session.data === undefined)
+        return (_jsxs("div", { className: "mx-auto grid max-w-sm gap-3", children: [_jsx("h2", { className: "text-base font-semibold", children: t('openSession', { shop: shop.name }) }), closedInfo === null ? null : (_jsx(Alert, { tone: "info", children: t('closedSummary', {
+                        name: closedInfo.name,
+                        total: format.decimal(closedInfo.total),
+                        difference: format.decimal(closedInfo.closingDifference ?? '0'),
+                    }) })), _jsxs("div", { className: "grid gap-1", children: [_jsx(Label, { htmlFor: "counter-opening", children: t('openingCash') }), _jsx(Input, { id: "counter-opening", inputMode: "decimal", value: opening, onChange: (e) => setOpening(e.target.value) })] }), error === null ? null : _jsx(Alert, { children: error }), _jsx(Button, { variant: "primary", busy: open.isPending, onClick: () => open.mutate(), children: t('open') })] }));
+    const current = session.data;
+    return (_jsxs("div", { className: "grid gap-3 lg:grid-cols-[1fr_22rem]", children: [_jsxs("section", { "aria-label": t('products'), className: "grid content-start gap-3", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx(Input, { ref: search, "aria-label": t('search'), placeholder: t('searchHint'), value: query, onChange: (e) => setQuery(e.target.value), onKeyDown: (e) => onSearchKey(e.key), className: "max-w-md" }), _jsx("span", { className: "ms-auto text-xs text-muted-foreground", children: t('sessionLine', {
+                                    name: current.name,
+                                    count: current.orderCount,
+                                    total: format.decimal(current.total),
+                                }) }), _jsx(Button, { size: "sm", variant: "ghost", onClick: () => setClosing(true), children: t('closeSession') })] }), catalogue.isPending ? _jsx(Spinner, { label: t('loading') }) : null, _jsx("ul", { className: "grid grid-cols-[repeat(auto-fill,minmax(9rem,1fr))] gap-2", children: shown.map((p) => (_jsx("li", { children: _jsxs("button", { type: "button", className: "grid w-full gap-1 rounded-lg border bg-surface p-2 text-start hover:bg-muted focus-visible:ring-2 focus-visible:ring-ring", onClick: () => add(p), children: [p.image === null ? (_jsx("span", { className: "aspect-square w-full rounded bg-muted", "aria-hidden": true })) : (_jsx("img", { src: `/api/v1/attachments/${p.image}/download?inline=true&w=256`, alt: "", className: "aspect-square w-full rounded object-cover" })), _jsx("span", { className: "line-clamp-2 text-sm font-medium", children: p.name }), _jsx("span", { className: "tabular-nums text-xs text-muted-foreground", children: format.decimal(p.price) })] }) }, p.id))) })] }), _jsxs("aside", { "aria-label": t('cart'), className: "grid content-start gap-3 rounded-lg border bg-surface p-3", children: [_jsx("h2", { className: "text-sm font-semibold", children: t('cart') }), cart.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('emptyCart') })) : null, _jsx("ul", { className: "grid gap-2", children: cart.map((l) => (_jsxs("li", { className: "grid grid-cols-[1fr_auto_auto] items-center gap-2 text-sm", children: [_jsx("span", { className: "truncate", children: l.product.name }), _jsxs("span", { className: "inline-flex items-center gap-1", children: [_jsx(Button, { size: "icon", variant: "ghost", "aria-label": t('less', { name: l.product.name }), onClick: () => l.quantity <= 1
+                                                ? removeLine(l.product.id)
+                                                : setQuantity(l.product.id, l.quantity - 1), children: "\u2212" }), _jsx("input", { "aria-label": t('quantityOf', { name: l.product.name }), inputMode: "decimal", className: "w-14 rounded border bg-surface px-1 text-center tabular-nums", value: String(l.quantity), onChange: (e) => {
+                                                const q = Number(e.target.value);
+                                                if (Number.isFinite(q) && q >= 0)
+                                                    setQuantity(l.product.id, q);
+                                            } }), _jsx(Button, { size: "icon", variant: "ghost", "aria-label": t('more', { name: l.product.name }), onClick: () => setQuantity(l.product.id, l.quantity + 1), children: "+" })] }), _jsx("span", { className: "tabular-nums", children: format.decimal(money(lineAmount(l, shop.pricesIncludeTax))) })] }, l.product.id))) }), _jsxs("div", { className: "flex items-baseline justify-between border-t pt-2", children: [_jsx("span", { className: "text-sm font-semibold", children: t('total') }), _jsx("span", { className: "text-xl font-semibold tabular-nums", "aria-live": "polite", children: format.decimal(money(total)) })] }), _jsx(Button, { variant: "primary", disabled: cart.length === 0, onClick: () => setPaying(true), children: t('pay') }), queued === 0 ? null : (_jsx("p", { role: "status", className: "text-xs text-muted-foreground", children: t('queued', { count: queued }) })), lastSale === null ? null : (_jsxs("div", { role: "status", className: "grid gap-1 rounded-md border bg-muted/40 p-2 text-sm", children: [_jsx("span", { children: t('soldLine', { name: lastSale.name, total: format.decimal(lastSale.total) }) }), Number(lastSale.change) > 0 ? (_jsx("span", { className: "font-semibold", children: t('changeLine', { change: format.decimal(lastSale.change) }) })) : null, _jsx(Button, { size: "sm", variant: "secondary", onClick: () => void printReceipt(lastSale), children: t('printReceipt') }), _jsxs("div", { className: "grid grid-cols-[1fr_auto] gap-1", children: [_jsx(Input, { "aria-label": t('sendTo'), placeholder: t('sendToHint'), value: sendTo, onChange: (e) => setSendTo(e.target.value) }), _jsx(Button, { size: "sm", variant: "ghost", busy: sendReceipt.isPending, disabled: sendTo.trim() === '', onClick: () => sendReceipt.mutate(lastSale.id), children: t('send') })] }), sentNote === null ? null : (_jsx("span", { className: "text-xs text-muted-foreground", children: sentNote })), _jsxs("div", { className: "grid grid-cols-[1fr_auto] gap-1", children: [_jsx(Input, { "aria-label": t('refundReason'), placeholder: t('refundReasonHint'), value: refundReason, onChange: (e) => setRefundReason(e.target.value) }), _jsx(Button, { size: "sm", variant: "ghost", busy: refund.isPending, disabled: refundReason.trim() === '', onClick: () => refund.mutate(lastSale.id), children: t('refund') })] })] })), error === null ? null : _jsx(Alert, { children: error })] }), _jsx(Dialog, { open: paying, onOpenChange: setPaying, title: t('payTitle', { total: format.decimal(money(total)) }), children: _jsxs("div", { className: "grid gap-3", children: [shop.methods.map((m) => (_jsxs("div", { className: "grid grid-cols-[1fr_8rem] items-center gap-2", children: [_jsx(Label, { htmlFor: `pay-${m.id}`, children: m.name }), _jsx(Input, { id: `pay-${m.id}`, inputMode: "decimal", value: payments[m.id] ?? '', onFocus: () => {
+                                        if ((payments[m.id] ?? '') === '' && paid < total)
+                                            setPayments({ ...payments, [m.id]: money(total - paid) });
+                                    }, onChange: (e) => setPayments({ ...payments, [m.id]: e.target.value }) })] }, m.id))), _jsxs("div", { className: "flex justify-between text-sm", children: [_jsx("span", { children: t('paid') }), _jsx("span", { className: "tabular-nums", children: format.decimal(money(paid)) })] }), _jsxs("div", { className: "flex justify-between text-sm font-semibold", children: [_jsx("span", { children: t('change') }), _jsx("span", { className: "tabular-nums", children: format.decimal(money(change)) })] }), error === null ? null : _jsx(Alert, { children: error }), _jsx(Button, { variant: "primary", disabled: paid + 0.004 < total, busy: sell.isPending, onClick: () => sell.mutate(), children: t('confirmSale') })] }) }), _jsx(Dialog, { open: closing, onOpenChange: setClosing, title: t('closeTitle', { name: current.name }), children: _jsxs("div", { className: "grid gap-3", children: [_jsx("p", { className: "text-sm text-muted-foreground", children: t('expectedCash', { amount: format.decimal(current.expectedCash ?? '0') }) }), _jsxs("div", { className: "grid gap-1", children: [_jsx(Label, { htmlFor: "counter-closing", children: t('closingCash') }), _jsx(Input, { id: "counter-closing", inputMode: "decimal", value: closingCash, onChange: (e) => setClosingCash(e.target.value) })] }), _jsxs("div", { className: "grid gap-1", children: [_jsx(Label, { htmlFor: "counter-reason", children: t('differenceReason') }), _jsx(Input, { id: "counter-reason", value: reason, onChange: (e) => setReason(e.target.value) })] }), error === null ? null : _jsx(Alert, { children: error }), _jsx(Button, { variant: "primary", busy: close.isPending, onClick: () => close.mutate(), children: t('closeSession') })] }) })] }));
+}

package/dist/pos/web/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @packageDocumentation
+ * The web contribution of `shutro-erp/pos`: the register page.
+ */
+import { type Registry } from '../../ui/index.js';
+import type { i18n } from 'i18next';
+import { messages } from './messages.js';
+export { Register } from './Register.js';
+/** Registers the page (and the messages in `i18n`, when given). */
+export declare function registerPosWeb(registry: Registry, i18n?: i18n): Registry;
+export { messages as posMessages };