shutro-erp 0.3.6 → 0.3.7

package/dist/stock/returns.d.ts

@@ -0,0 +1,157 @@
+import { type Env } from './.kosh/bindings.js';
+/** Why goods come back: reported by product and partner. */
+export declare const StockReturnReason: import("../server/orm.js").Model<"stock.return.reason", {
+    readonly id: import("../server/orm.js").IdField<"stock.return.reason">;
+    readonly createdAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
+        required: true;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly updatedAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
+        required: true;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly createdBy: import("../server/orm.js").Many2oneField<'res.users', {
+        required: false;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly updatedBy: import("../server/orm.js").Many2oneField<'res.users', {
+        required: false;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly displayName: import("../server/orm.js").CharField<{
+        required: true;
+        readonly: true;
+        computed: true;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly active: import("../server/orm.js").ActiveField;
+    readonly name: import("../server/orm.js").CharField<{
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string | Readonly<Record<string, string>>>;
+    readonly sequence: import("../server/orm.js").ScalarField<"integer", number, number, {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
+    readonly code: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+}, {} & import("../server/orm.js").TransitionMethods<{
+    readonly name: import("../server/orm.js").CharField<{
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string | Readonly<Record<string, string>>>;
+    readonly sequence: import("../server/orm.js").ScalarField<"integer", number, number, {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
+    readonly code: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+}>>;
+/** The reasons a database starts with. */
+export declare const DEFAULT_RETURN_REASONS: readonly [{
+    readonly code: 'damaged';
+    readonly en: 'Damaged';
+    readonly bn: 'ক্ষতিগ্রস্ত';
+}, {
+    readonly code: 'wrong_item';
+    readonly en: 'Wrong item';
+    readonly bn: 'ভুল পণ্য';
+}, {
+    readonly code: 'not_as_ordered';
+    readonly en: 'Not as ordered';
+    readonly bn: 'অর্ডার অনুযায়ী নয়';
+}, {
+    readonly code: 'surplus';
+    readonly en: 'Surplus';
+    readonly bn: 'অতিরিক্ত';
+}, {
+    readonly code: 'quality';
+    readonly en: 'Quality';
+    readonly bn: 'মানের সমস্যা';
+}];
+export declare function installReturnReasons(env: Env): Promise<number>;
+/** What each line of a done transfer can still return. */
+export interface Returnable {
+    readonly move: number;
+    readonly product: number;
+    readonly name: string;
+    readonly done: string;
+    readonly returned: string;
+    readonly returnable: string;
+}
+/** The lines of a done delivery or receipt with what is left to return (in the product's unit). */
+export declare function returnableLines(env: Env, pickingId: number): Promise<Returnable[]>;
+/**
+ * Makes and confirms the return of `lines` (move and quantity, in the product's unit) with a reason; `location`
+ * receives it instead of where the goods came from (a damaged-goods location). Returns the new transfer.
+ */
+export declare function createReturn(env: Env, pickingId: number, input: {
+    readonly lines: readonly {
+        readonly move: number;
+        readonly quantity: string;
+    }[];
+    readonly reason: number;
+    readonly note?: string | null;
+    readonly location?: number | null;
+}): Promise<{
+    picking: number;
+    name: string;
+}>;

package/dist/stock/returns.js

@@ -0,0 +1,163 @@
+/**
+ * Returns (RFC 0030 §3.2). A done delivery or receipt can be returned, in part: each line up to what was done and
+ * not returned yet (returns in progress count), with a reason. The return is a transfer of the other way — a
+ * customer's goods back in, goods back to the vendor —, linked to the original (`returnOf`) and line by line, with
+ * the original's links carried (an order's, through `backorderValues`), and lots taken back from the original's.
+ * It is confirmed, and validated like any transfer; `stock_account` values it at the original cost.
+ */
+import { HttpProblem } from '../server/index.js';
+import { orm } from '../server/orm.js';
+import { defineModel, f } from './.kosh/bindings.js';
+const ALL = ['read', 'write', 'create', 'unlink', 'export', 'import'];
+const zero = orm.toDecimal('0');
+/** Why goods come back: reported by product and partner. */
+export const StockReturnReason = defineModel('stock.return.reason', {
+    label: 'Return reason',
+    archivable: true,
+    order: ['sequence asc', 'id asc'],
+    access: { 'stock.user': ['read'], 'stock.manager': ALL },
+    fields: {
+        name: f.char({ required: true, translate: true, label: 'Reason' }),
+        sequence: f.integer({ default: 10 }),
+        code: f.char({ index: 'unique', label: 'Code' }),
+    },
+});
+/** The reasons a database starts with. */
+export const DEFAULT_RETURN_REASONS = [
+    { code: 'damaged', en: 'Damaged', bn: 'ক্ষতিগ্রস্ত' },
+    { code: 'wrong_item', en: 'Wrong item', bn: 'ভুল পণ্য' },
+    { code: 'not_as_ordered', en: 'Not as ordered', bn: 'অর্ডার অনুযায়ী নয়' },
+    { code: 'surplus', en: 'Surplus', bn: 'অতিরিক্ত' },
+    { code: 'quality', en: 'Quality', bn: 'মানের সমস্যা' },
+];
+export async function installReturnReasons(env) {
+    let made = 0;
+    const model = env.withFlags({ activeTest: false }).model('stock.return.reason');
+    for (const [i, r] of DEFAULT_RETURN_REASONS.entries()) {
+        if ((await model.search({ where: { code: r.code } })).ids.length > 0)
+            continue;
+        await model.create([
+            { code: r.code, name: { en_US: r.en, bn_BD: r.bn }, sequence: (i + 1) * 10 },
+        ]);
+        made++;
+    }
+    return made;
+}
+const OTHER_WAY = {
+    delivery: 'receipt',
+    receipt: 'delivery',
+};
+async function loadDone(env, pickingId) {
+    const [picking] = await env
+        .model('stock.picking')
+        .browse([pickingId])
+        .load({
+        moves: { product: true, returns: { picking: true } },
+        source: true,
+        destination: true,
+    });
+    if (picking === undefined)
+        throw new HttpProblem(404, 'missing-record', 'Not found', 'No such transfer.');
+    if (picking.state !== 'done')
+        throw new HttpProblem(409, 'not-done', 'Not done', 'Only a done transfer can be returned.');
+    if (OTHER_WAY[picking.kind] === undefined)
+        throw new HttpProblem(409, 'not-returnable', 'Not returnable', 'Deliveries and receipts are returned; other transfers are moved back by hand.');
+    return picking;
+}
+/** The lines of a done delivery or receipt with what is left to return (in the product's unit). */
+export async function returnableLines(env, pickingId) {
+    const picking = await loadDone(env, pickingId);
+    return [...picking.moves].map((m) => {
+        const done = m.doneQty ?? zero;
+        const returned = [...m.returns]
+            .filter((r) => r.picking.state !== 'cancel')
+            .reduce((s, r) => s.plus(r.quantity), zero);
+        const left = done.minus(returned);
+        return {
+            move: m.id,
+            product: m.product.id,
+            name: String(m.name ?? m.product.name),
+            done: done.toString(),
+            returned: returned.toString(),
+            returnable: (left.gt(0) ? left : zero).toString(),
+        };
+    });
+}
+/**
+ * Makes and confirms the return of `lines` (move and quantity, in the product's unit) with a reason; `location`
+ * receives it instead of where the goods came from (a damaged-goods location). Returns the new transfer.
+ */
+export async function createReturn(env, pickingId, input) {
+    const picking = await loadDone(env, pickingId);
+    const left = new Map((await returnableLines(env, pickingId)).map((l) => [l.move, l]));
+    const wanted = input.lines
+        .map((l) => ({ move: l.move, quantity: orm.toDecimal(l.quantity || '0') }))
+        .filter((l) => l.quantity.gt(0));
+    if (wanted.length === 0)
+        throw new HttpProblem(400, 'invalid-body', 'Nothing to return', 'Give a quantity to return.');
+    for (const w of wanted) {
+        const l = left.get(w.move);
+        if (l === undefined)
+            throw new HttpProblem(400, 'invalid-body', 'Unknown line', 'A line of this transfer.');
+        if (w.quantity.gt(orm.toDecimal(l.returnable)))
+            throw new HttpProblem(409, 'too-much', 'More than can be returned', `${l.name}: ${l.returnable} can still be returned.`);
+    }
+    const [reason] = await env
+        .model('stock.return.reason')
+        .browse([input.reason])
+        .load(['name']);
+    if (reason === undefined)
+        throw new HttpProblem(400, 'invalid-body', 'Reason required', 'Give the reason of the return.');
+    // The original's links (an order's) carried, the way reversed.
+    const base = (await env
+        .model('stock.picking')
+        .browse([pickingId])
+        .backorderValues()).get(pickingId) ?? {};
+    const moveValues = await env
+        .model('stock.move')
+        .browse(wanted.map((w) => w.move))
+        .backorderValues();
+    const made = await env.model('stock.picking').create([
+        {
+            ...base,
+            kind: OTHER_WAY[picking.kind],
+            source: picking.destination.id,
+            destination: input.location ?? picking.source.id,
+            origin: `Return of ${picking.name}`,
+            scheduledDate: env.today(),
+            next: null,
+            returnOf: picking.id,
+            returnReason: input.reason,
+            ...(input.note == null || input.note.trim() === '' ? {} : { note: input.note.trim() }),
+            moves: {
+                create: wanted.map((w) => ({
+                    ...(moveValues.get(w.move) ?? {}),
+                    // In the product's unit: what was done is counted that way.
+                    uom: [...picking.moves].find((m) => m.id === w.move)?.product.uom?.id ?? null,
+                    quantity: w.quantity.toString(),
+                    returnOf: w.move,
+                })),
+            },
+        },
+    ]);
+    const id = made.ids[0];
+    // The lots taken back are the original's, as far as the quantities go.
+    const lots = await (await env.model('stock.lot.line').search({ where: { picking: pickingId } })).load({ product: true, lot: true });
+    const rows = [];
+    for (const w of wanted) {
+        const product = [...picking.moves].find((m) => m.id === w.move)?.product.id;
+        let rest = w.quantity;
+        for (const l of lots) {
+            if (rest.lte(0) || l.product.id !== product || l.lot === null)
+                continue;
+            const take = rest.lt(l.quantity) ? rest : l.quantity;
+            rows.push({ picking: id, product, lot: l.lot.id, quantity: take.toString() });
+            rest = rest.minus(take);
+        }
+    }
+    if (rows.length > 0)
+        await env.model('stock.lot.line').create(rows);
+    await made.confirm();
+    const [row] = await made.load(['name']);
+    return { picking: id, name: String(row?.name ?? '') };
+}

package/dist/stock/web/Ledger.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stockroom › Stock ledger (RFC 0032 §3.3): for a period and the chosen warehouses (or every one), each product's
+ * opening, what came in and went out by movement type, and its closing — as a summary or every movement —, and the
+ * stock report (on hand, reserved, available, incoming, outgoing per product and location), as the server computes
+ * them, with their XLSX and PDF files.
+ */
+import { type PageProps } from '../../ui/index.js';
+import { type ReactElement } from 'react';
+export declare function Ledger({ api }: PageProps): ReactElement;

package/dist/stock/web/Ledger.js

@@ -0,0 +1,108 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Stockroom › Stock ledger (RFC 0032 §3.3): for a period and the chosen warehouses (or every one), each product's
+ * opening, what came in and went out by movement type, and its closing — as a summary or every movement —, and the
+ * stock report (on hand, reserved, available, incoming, outgoing per product and location), as the server computes
+ * them, with their XLSX and PDF files.
+ */
+import { ApiError, Button, Input, Label, useKosh } from '../../ui/index.js';
+import { useMutation, useQuery } from '@tanstack/react-query';
+import { useId, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+const IN_TYPES = [
+    'purchase_receipt',
+    'sales_return',
+    'production_in',
+    'transfer_in',
+    'adjustment_in',
+    'other_in',
+];
+const OUT_TYPES = [
+    'sales_delivery',
+    'purchase_return',
+    'production_out',
+    'transfer_out',
+    'consumption',
+    'scrap',
+    'adjustment_out',
+    'other_out',
+];
+const TABS = ['summary', 'details', 'stock'];
+function saveFile(blob, filename) {
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = filename;
+    a.click();
+    setTimeout(() => URL.revokeObjectURL(url), 1000);
+}
+const firstOfMonth = () => {
+    const d = new Date();
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-01`;
+};
+const today = () => new Date().toISOString().slice(0, 10);
+const cell = 'px-2 py-1 whitespace-nowrap';
+const num = `${cell} text-end tabular-nums`;
+export function Ledger({ api }) {
+    const { t } = useTranslation('stock');
+    const { format } = useKosh();
+    const id = useId();
+    const [tab, setTab] = useState('summary');
+    const [from, setFrom] = useState(firstOfMonth);
+    const [to, setTo] = useState(today);
+    const [warehouses, setWarehouses] = useState([]);
+    const [categories, setCategories] = useState([]);
+    const warehouseList = useQuery({
+        queryKey: ['stock', 'ledger', 'warehouses'],
+        queryFn: async () => (await api.list('stock.warehouse', {
+            fields: ['id', 'name'],
+            order: ['name asc'],
+            limit: 200,
+        })).items,
+    });
+    const categoryList = useQuery({
+        queryKey: ['stock', 'ledger', 'categories'],
+        queryFn: async () => (await api.list('product.category', {
+            fields: ['id', 'name'],
+            order: ['name asc'],
+            limit: 500,
+        })).items,
+    });
+    const scope = `warehouses=${warehouses.join(',')}&categories=${categories.join(',')}`;
+    const path = tab === 'stock'
+        ? `/api/v1/stockroom/stock?${scope}`
+        : `/api/v1/stockroom/ledger?from=${from}&to=${to}&mode=${tab}&${scope}`;
+    const valid = /^\d{4}-\d{2}-\d{2}$/.test(from) && /^\d{4}-\d{2}-\d{2}$/.test(to) && from <= to;
+    const data = useQuery({
+        queryKey: ['stock', 'ledger', tab, from, to, warehouses, categories],
+        queryFn: () => api.call('GET', path),
+        enabled: tab === 'stock' || valid,
+    });
+    const download = useMutation({
+        mutationFn: async (kind) => {
+            const { blob, filename } = await api.download(`${path}&format=${kind}`, undefined, 'GET');
+            saveFile(blob, filename);
+        },
+    });
+    const error = data.error ?? download.error;
+    const chosen = (e) => [...e.target.selectedOptions].map((o) => Number(o.value));
+    return (_jsxs("div", { className: "grid gap-4 p-4", children: [_jsx("h1", { className: "text-xl font-semibold", children: t('ledger.title') }), _jsxs("div", { className: "flex flex-wrap items-end gap-2", children: [_jsxs("fieldset", { className: "flex flex-wrap gap-1", children: [_jsx("legend", { className: "sr-only", children: t('ledger.tab') }), TABS.map((k) => (_jsx(Button, { variant: tab === k ? 'primary' : 'secondary', "aria-pressed": tab === k, onClick: () => setTab(k), children: t(`ledger.tabs.${k}`) }, k)))] }), tab === 'stock' ? null : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "grid gap-1", children: [_jsx(Label, { htmlFor: `${id}-from`, children: t('ledger.from') }), _jsx(Input, { id: `${id}-from`, type: "date", value: from, onChange: (e) => setFrom(e.target.value) })] }), _jsxs("div", { className: "grid gap-1", children: [_jsx(Label, { htmlFor: `${id}-to`, children: t('ledger.to') }), _jsx(Input, { id: `${id}-to`, type: "date", value: to, onChange: (e) => setTo(e.target.value) })] })] })), _jsxs("div", { className: "grid gap-1", children: [_jsx(Label, { htmlFor: `${id}-warehouses`, children: t('ledger.warehouses') }), _jsx("select", { id: `${id}-warehouses`, multiple: true, className: "min-w-48 rounded-md border bg-background px-2 py-1 text-sm", value: warehouses.map(String), onChange: (e) => setWarehouses(chosen(e)), children: (warehouseList.data ?? []).map((w) => (_jsx("option", { value: w.id, children: w.name }, w.id))) })] }), _jsxs("div", { className: "grid gap-1", children: [_jsx(Label, { htmlFor: `${id}-categories`, children: t('ledger.categories') }), _jsx("select", { id: `${id}-categories`, multiple: true, className: "min-w-48 rounded-md border bg-background px-2 py-1 text-sm", value: categories.map(String), onChange: (e) => setCategories(chosen(e)), children: (categoryList.data ?? []).map((c) => (_jsx("option", { value: c.id, children: c.name }, c.id))) })] }), _jsx(Button, { variant: "secondary", disabled: download.isPending, onClick: () => download.mutate('xlsx'), children: t('ledger.xlsx') }), _jsx(Button, { variant: "secondary", disabled: download.isPending, onClick: () => download.mutate('pdf'), children: t('ledger.pdf') })] }), _jsx("p", { className: "text-sm text-muted-foreground", children: t(`ledger.hints.${tab}`) }), error === null ? null : (_jsx("p", { role: "alert", className: "text-sm text-danger", children: error instanceof ApiError ? error.message : String(error) })), data.data === undefined ? null : tab === 'stock' ? (_jsx(StockTable, { rows: data.data.rows })) : tab === 'details' ? (_jsx(Details, { data: data.data })) : (_jsx(Summary, { data: data.data }))] }));
+    function Summary({ data }) {
+        const rows = data.rows;
+        if (rows.length === 0)
+            return _jsx("p", { className: "text-sm text-muted-foreground", children: t('ledger.empty') });
+        const q = (f) => format.decimal(f.qty, 3);
+        return (_jsx("div", { className: "overflow-x-auto", children: _jsxs("table", { className: "w-full text-sm", children: [_jsx("thead", { className: "bg-muted", children: _jsxs("tr", { children: [_jsx("th", { className: `${cell} text-start`, children: t('ledger.product') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.unit') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.opening') }), IN_TYPES.map((k) => (_jsx("th", { className: `${cell} text-end`, children: t(`ledger.types.${k}`) }, k))), _jsx("th", { className: `${cell} text-end font-semibold`, children: t('ledger.totalIn') }), OUT_TYPES.map((k) => (_jsx("th", { className: `${cell} text-end`, children: t(`ledger.types.${k}`) }, k))), _jsx("th", { className: `${cell} text-end font-semibold`, children: t('ledger.totalOut') }), _jsx("th", { className: `${cell} text-end font-semibold`, children: t('ledger.closing') }), data.valued ? (_jsx("th", { className: `${cell} text-end`, children: t('ledger.closingValue') })) : null] }) }), _jsx("tbody", { children: rows.map((r) => (_jsxs("tr", { className: "border-b", children: [_jsx("td", { className: cell, children: r.product.name }), _jsx("td", { className: cell, children: r.product.uom }), _jsx("td", { className: num, children: q(r.opening) }), IN_TYPES.map((k) => (_jsx("td", { className: num, children: q(r.in[k]) }, k))), _jsx("td", { className: `${num} font-semibold`, children: q(r.totalIn) }), OUT_TYPES.map((k) => (_jsx("td", { className: num, children: q(r.out[k]) }, k))), _jsx("td", { className: `${num} font-semibold`, children: q(r.totalOut) }), _jsx("td", { className: `${num} font-semibold`, children: q(r.closing) }), data.valued ? _jsx("td", { className: num, children: format.decimal(r.closing.value, 2) }) : null] }, r.product.id))) })] }) }));
+    }
+    function Details({ data }) {
+        const rows = data.rows;
+        if (rows.length === 0)
+            return _jsx("p", { className: "text-sm text-muted-foreground", children: t('ledger.empty') });
+        return (_jsx("div", { className: "overflow-x-auto", children: _jsxs("table", { className: "w-full text-sm", children: [_jsx("thead", { className: "bg-muted", children: _jsxs("tr", { children: [_jsx("th", { className: `${cell} text-start`, children: t('ledger.date') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.reference') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.origin') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.product') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.fromPlace') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.toPlace') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.movement') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.quantity') }), data.valued ? _jsx("th", { className: `${cell} text-end`, children: t('ledger.value') }) : null] }) }), _jsx("tbody", { children: rows.map((r, i) => (_jsxs("tr", { className: "border-b", children: [_jsx("td", { className: cell, children: format.date(r.date) }), _jsx("td", { className: cell, children: r.reference }), _jsx("td", { className: cell, children: r.origin ?? '' }), _jsxs("td", { className: cell, children: [r.product.name, " ", _jsx("span", { className: "text-muted-foreground", children: r.product.uom })] }), _jsx("td", { className: cell, children: r.from }), _jsx("td", { className: cell, children: r.to }), _jsx("td", { className: cell, children: t(`ledger.types.${r.type}`) }), _jsx("td", { className: num, children: format.decimal(r.qty, 3) }), data.valued ? _jsx("td", { className: num, children: format.decimal(r.value, 2) }) : null] }, i))) })] }) }));
+    }
+    function StockTable({ rows }) {
+        if (rows.length === 0)
+            return _jsx("p", { className: "text-sm text-muted-foreground", children: t('ledger.empty') });
+        return (_jsx("div", { className: "overflow-x-auto", children: _jsxs("table", { className: "w-full text-sm", children: [_jsx("thead", { className: "bg-muted", children: _jsxs("tr", { children: [_jsx("th", { className: `${cell} text-start`, children: t('ledger.product') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.unit') }), _jsx("th", { className: `${cell} text-start`, children: t('ledger.location') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.onHand') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.reserved') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.available') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.incoming') }), _jsx("th", { className: `${cell} text-end`, children: t('ledger.outgoing') })] }) }), _jsx("tbody", { children: rows.map((r) => (_jsxs("tr", { className: "border-b", children: [_jsx("td", { className: cell, children: r.product.name }), _jsx("td", { className: cell, children: r.product.uom }), _jsx("td", { className: cell, children: r.location.name }), _jsx("td", { className: num, children: format.decimal(r.onHand, 3) }), _jsx("td", { className: num, children: format.decimal(r.reserved, 3) }), _jsx("td", { className: num, children: format.decimal(r.available, 3) }), _jsx("td", { className: num, children: format.decimal(r.incoming, 3) }), _jsx("td", { className: num, children: format.decimal(r.outgoing, 3) })] }, `${r.product.id}-${r.location.id}`))) })] }) }));
+    }
+}

package/dist/stock/web/Operations.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stockroom › My operations (RFC 0032 §3.3): a card per warehouse and kind of transfer — receipts, deliveries,
+ * internal moves — with what is ready, waiting and late. The server counts (`GET /api/v1/stockroom/operations`);
+ * each count opens the transfers it counts.
+ */
+import { type PageProps } from '../../ui/index.js';
+import type { ReactElement } from 'react';
+export declare function Operations({ api, app }: PageProps): ReactElement;

package/dist/stock/web/Operations.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Stockroom › My operations (RFC 0032 §3.3): a card per warehouse and kind of transfer — receipts, deliveries,
+ * internal moves — with what is ready, waiting and late. The server counts (`GET /api/v1/stockroom/operations`);
+ * each count opens the transfers it counts.
+ */
+import { Alert } from '../../ui/index.js';
+import { useQuery } from '@tanstack/react-query';
+import { useTranslation } from 'react-i18next';
+/** A link to an action's list filtered by `domain`, labelled in its search bar. */
+function hrefOf(app, action, domain, label) {
+    const q = JSON.stringify({ c: domain, cl: label });
+    // The router reads search values as JSON: a string is quoted.
+    return `/${app}/a/${action}?q=${encodeURIComponent(JSON.stringify(q))}`;
+}
+export function Operations({ api, app = 'stockroom' }) {
+    const { t } = useTranslation('stock');
+    const operations = useQuery({
+        queryKey: ['stock', 'operations'],
+        queryFn: () => api.call('GET', '/api/v1/stockroom/operations'),
+        refetchInterval: 60_000,
+    });
+    if (operations.isError)
+        return _jsx(Alert, { tone: "danger", children: operations.error.message });
+    const list = operations.data?.operations ?? [];
+    return (_jsxs("div", { className: "grid gap-4 p-4", children: [_jsx("h1", { className: "text-xl font-semibold", children: t('operations.title') }), _jsx("p", { className: "max-w-3xl text-sm text-muted-foreground", children: t('operations.hint') }), operations.isLoading ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('operations.loading') })) : list.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('operations.empty') })) : (_jsx("ul", { className: "grid gap-3 sm:grid-cols-2 xl:grid-cols-3", children: list.map((o) => {
+                    const title = `${o.warehouse.name}: ${t(`operations.kind.${o.kind}`)}`;
+                    const link = (count, which) => (_jsxs("a", { href: hrefOf(app, o.action, count.domain, `${title} · ${t(`operations.${which}`)}`), className: which === 'late' && count.count > 0
+                            ? 'rounded-md border border-destructive/40 px-3 py-2 text-destructive hover:bg-destructive/10'
+                            : 'rounded-md border px-3 py-2 hover:bg-accent', "aria-label": t(`operations.${which}Of`, { count: count.count, title }), children: [_jsx("span", { className: "block text-2xl font-semibold tabular-nums", children: count.count }), _jsx("span", { className: "text-xs text-muted-foreground", children: t(`operations.${which}`) })] }));
+                    return (_jsx("li", { children: _jsxs("section", { "aria-label": title, className: "space-y-3 rounded-lg border bg-card p-4 text-card-foreground", children: [_jsx("h2", { className: "font-medium", children: title }), _jsxs("div", { className: "grid grid-cols-3 gap-2", children: [link(o.ready, 'ready'), link(o.waiting, 'waiting'), link(o.late, 'late')] })] }) }, `${o.warehouse.id}-${o.kind}`));
+                }) }))] }));
+}

package/dist/stock/web/ReturnButton.d.ts

@@ -0,0 +1,7 @@
+/**
+ * "Return" on a done delivery or receipt (RFC 0030 §3.2): the lines with what can still come back, a quantity for
+ * each, the reason and a note; the server makes the linked return, confirmed, and refuses more than was done.
+ */
+import { type NodeComponentProps } from '../../ui/index.js';
+import { type ReactElement } from 'react';
+export declare function ReturnButton({ record, api, reload }: NodeComponentProps): ReactElement | null;

package/dist/stock/web/ReturnButton.js

@@ -0,0 +1,62 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * "Return" on a done delivery or receipt (RFC 0030 §3.2): the lines with what can still come back, a quantity for
+ * each, the reason and a note; the server makes the linked return, confirmed, and refuses more than was done.
+ */
+import { Alert, ApiError, Button, Dialog, Input, Label, Select, } from '../../ui/index.js';
+import { useMutation, useQuery } from '@tanstack/react-query';
+import { useId, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+export function ReturnButton({ record, api, reload }) {
+    const { t } = useTranslation('stock');
+    const id = useId();
+    const [open, setOpen] = useState(false);
+    const [quantities, setQuantities] = useState({});
+    const [reason, setReason] = useState(null);
+    const [note, setNote] = useState('');
+    const [made, setMade] = useState(null);
+    const eligible = record !== null &&
+        record['state'] === 'done' &&
+        (record['kind'] === 'delivery' || record['kind'] === 'receipt');
+    const lines = useQuery({
+        queryKey: ['stock', 'returnable', record?.id],
+        queryFn: () => api.call('GET', `/api/v1/stockroom/pickings/${record?.id}/returnable`),
+        enabled: eligible && open,
+    });
+    const reasons = useQuery({
+        queryKey: ['stock', 'return-reasons'],
+        queryFn: () => api.list('stock.return.reason', {
+            fields: ['id', 'name'],
+            order: ['sequence asc'],
+            limit: 50,
+        }),
+        enabled: eligible && open,
+    });
+    const send = useMutation({
+        mutationFn: () => api.call('POST', `/api/v1/stockroom/pickings/${record?.id}/return`, {
+            lines: Object.entries(quantities)
+                .filter(([, q]) => q !== '' && Number(q) > 0)
+                .map(([move, quantity]) => ({ move: Number(move), quantity })),
+            reason: Number(reason),
+            note,
+        }),
+        onSuccess: (r) => {
+            setOpen(false);
+            setMade(r.name);
+            reload?.();
+        },
+    });
+    if (!eligible)
+        return null;
+    const rows = lines.data?.lines ?? [];
+    const any = Object.values(quantities).some((q) => q !== '' && Number(q) > 0);
+    return (_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx(Button, { size: "sm", onClick: () => {
+                    setQuantities({});
+                    setReason(null);
+                    setNote('');
+                    setOpen(true);
+                }, children: t('returns.button') }), made === null ? null : (_jsx("span", { role: "status", className: "text-xs text-muted-foreground", children: t('returns.made', { name: made }) })), _jsx(Dialog, { open: open, onOpenChange: setOpen, title: t('returns.title'), description: t('returns.intro'), footer: _jsx(Button, { variant: "primary", disabled: !any || reason === null, busy: send.isPending, onClick: () => send.mutate(), children: t('returns.confirm') }), children: _jsxs("div", { className: "space-y-3", children: [rows.map((l) => (_jsxs("div", { className: "grid grid-cols-[1fr_8rem] items-end gap-2", children: [_jsxs(Label, { htmlFor: `${id}-q-${l.move}`, children: [l.name, _jsx("span", { className: "block text-xs text-muted-foreground", children: t('returns.left', { done: l.done, left: l.returnable }) })] }), _jsx(Input, { id: `${id}-q-${l.move}`, inputMode: "decimal", disabled: Number(l.returnable) <= 0, value: quantities[l.move] ?? '', onChange: (e) => setQuantities({ ...quantities, [l.move]: e.target.value }) })] }, l.move))), _jsx(Select, { id: `${id}-reason`, label: t('returns.reason'), value: reason, options: (reasons.data?.items ?? []).map((r) => ({
+                                value: String(r.id),
+                                label: r.name,
+                            })), onChange: setReason }), _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: `${id}-note`, children: t('returns.note') }), _jsx(Input, { id: `${id}-note`, value: note, onChange: (e) => setNote(e.target.value) })] }), send.error === null ? null : (_jsx(Alert, { children: send.error instanceof ApiError ? send.error.message : String(send.error) }))] }) })] }));
+}

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

@@ -6,7 +6,10 @@
 import { type Registry } from '../../ui/index.js';
 import type { i18n } from 'i18next';
 import { messages } from './messages.js';
+export { Ledger } from './Ledger.js';
+export { Operations } from './Operations.js';
 export { Replenishment } from './Replenishment.js';
+export { ReturnButton } from './ReturnButton.js';
 export { ScanBox } from './ScanBox.js';
 /** Registers the component and the page (and the messages in `i18n`, when given). */
 export declare function registerStockWeb(registry: Registry, i18n?: i18n): Registry;

package/dist/stock/web/index.js

@@ -4,15 +4,24 @@
  * the Replenishment page.
  */
 import { addMessages } from '../../ui/index.js';
+import { Ledger } from './Ledger.js';
 import { messages } from './messages.js';
+import { Operations } from './Operations.js';
 import { Replenishment } from './Replenishment.js';
+import { ReturnButton } from './ReturnButton.js';
 import { ScanBox } from './ScanBox.js';
+export { Ledger } from './Ledger.js';
+export { Operations } from './Operations.js';
 export { Replenishment } from './Replenishment.js';
+export { ReturnButton } from './ReturnButton.js';
 export { ScanBox } from './ScanBox.js';
 /** Registers the component and the page (and the messages in `i18n`, when given). */
 export function registerStockWeb(registry, i18n) {
     registry.registerComponent('stock.Scan', ScanBox);
+    registry.registerComponent('stock.Return', ReturnButton);
     registry.registerPage('stock.Replenishment', Replenishment);
+    registry.registerPage('stock.Operations', Operations);
+    registry.registerPage('stock.Ledger', Ledger);
     if (i18n !== undefined)
         addMessages(i18n, 'stock', messages);
     return registry;