@endora-commerce/mod-taxes 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
+
+# @endora-commerce/mod-taxes
+
+Tax rate configuration and order tax computation.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `taxes` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-taxes` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-taxes/admin` | the Admin UI contribution: the screens, navigation and palette actions it adds |
+| `@endora-commerce/mod-taxes/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-taxes/migrations` | the module’s own schema migrations, in the order the platform runs them |
+| `@endora-commerce/mod-taxes/tailwind.css` | the Tailwind source declaration for the admin code above |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/admin-kit` — *optional*
+- `@endora-commerce/contracts`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+- `lucide-react` ^1 — *optional*
+- `react` ^19 — *optional*
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `i18n/` — the translation bundles this package ships (`en`, `pl`), loaded by the platform
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+- `tailwind.css` — the Tailwind source declaration
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-taxes
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/admin/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `taxes`' admin surface — one route and one sidebar entry, declared by the
+ * module that owns them (feature 091, Phase 4, batch 8;
+ * `specs/091-module-owned-admin-surfaces/contracts/admin-contribution.md`).
+ *
+ * **Its one drain was `dictionaries`' country picker**, which the screen renders
+ * to choose the country a tax rule applies to.
+ * `backend/scripts/ledgers/cross-module-imports/taxes.ts` recorded it with the
+ * retiring condition this batch satisfies — the picker is generic, so it moved
+ * into `@endora-commerce/admin-kit` and the shard is deleted rather than
+ * edited.
+ *
+ * **This module declares `activation.nonDeactivatable`**, so its off-state proof
+ * is `plan.md`'s Ruling 2 shape: the platform refuses to have an absent state,
+ * which is a fact about the module and is asserted as one rather than skipped.
+ * The permission axis is real and `useSurfaceVisibility` gates it identically,
+ * so the test drives positive control, permission withheld and restored, and
+ * reads the lock off the manifest so an unlock fails there.
+ *
+ * **This entry exports data and nothing else** (R2), like every `./admin`
+ * layer; the component is a dynamic-import factory (R6).
+ */
+import type { AdminContributions } from '@endora-commerce/admin-kit/contributions';
+export declare const contributions: AdminContributions;
+//# sourceMappingURL=index.d.ts.map

package/dist/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAKnF,eAAO,MAAM,aAAa,EAAE,kBA8B3B,CAAC"}

package/dist/admin/index.js

@@ -0,0 +1,34 @@
+/** The module's only route: the tax-rule table. */
+const ROUTE_PATH = '/taxes';
+export const contributions = {
+    routes: [
+        {
+            path: ROUTE_PATH,
+            component: () => import('./pages/TaxesPage.js'),
+            // `requireAdmin('taxes:read')` on `GET /api/v1/admin/taxes`, which the
+            // screen calls on mount. The write code gates the mutations the same
+            // screen offers, so a read-only operator opens it and is refused field by
+            // field — the treatment issue #232 says a landing surface must have.
+            requiredPermission: 'taxes:read',
+            index: true,
+        },
+    ],
+    nav: [
+        {
+            to: ROUTE_PATH,
+            // Module-relative (R8), out of `packages/modules/taxes/i18n/`. It was
+            // `appShell.nav.taxes` in the shared `_i18n` bundle.
+            labelKey: 'nav.taxes.label',
+            icon: 'Receipt',
+            section: 'pricing',
+            // Second of three in the hand-written *Pricing* table, after
+            // `/price-lists` and before `/delivery-methods`. Both of those are still
+            // the host's — `price_lists` is batch 9's — so a registry entry appends
+            // after them whatever it declares; the weight is what restores the pair's
+            // order against `delivery_methods`' 300 once the section converts.
+            weight: 200,
+            requiredPermission: 'taxes:read',
+        },
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAwBA,mDAAmD;AACnD,MAAM,UAAU,GAAG,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,MAAM,EAAE;QACN;YACE,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;YAC/C,uEAAuE;YACvE,qEAAqE;YACrE,0EAA0E;YAC1E,qEAAqE;YACrE,kBAAkB,EAAE,YAAY;YAChC,KAAK,EAAE,IAAI;SACZ;KACF;IACD,GAAG,EAAE;QACH;YACE,EAAE,EAAE,UAAU;YACd,sEAAsE;YACtE,qDAAqD;YACrD,QAAQ,EAAE,iBAAiB;YAC3B,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,SAAS;YAClB,6DAA6D;YAC7D,yEAAyE;YACzE,wEAAwE;YACxE,0EAA0E;YAC1E,mEAAmE;YACnE,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,YAAY;SACjC;KACF;CACF,CAAC"}

package/dist/admin/pages/TaxesPage.d.ts

@@ -0,0 +1,4 @@
+import { type ReactNode } from 'react';
+export declare function TaxesPage(): ReactNode;
+export default TaxesPage;
+//# sourceMappingURL=TaxesPage.d.ts.map

package/dist/admin/pages/TaxesPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaxesPage.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/TaxesPage.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAsBzF,wBAAgB,SAAS,IAAI,SAAS,CAiMrC;AAwHD,eAAe,SAAS,CAAC"}

package/dist/admin/pages/TaxesPage.js

@@ -0,0 +1,135 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from 'react';
+import { Trash2 } from 'lucide-react';
+import { ApiError, apiClient, useSurfaceVisibility } from '@endora-commerce/admin-kit/lib';
+import { Alert, AlertDescription, Badge, Button, Card, CardContent, CardHeader, CardTitle, Checkbox, Input, Label, PageHeader, Select, Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@endora-commerce/admin-kit/ui';
+import { CountryPicker } from '@endora-commerce/admin-kit/components';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+const PRODUCT_TYPES = ['simple', 'variant', 'grouped', 'virtual'];
+const VAT_STATUSES = ['vat_payer', 'vat_exempt', 'reverse_charge'];
+export function TaxesPage() {
+    const t = useTranslation('core');
+    /**
+     * The screen's own gate (2026-08-28), on the codes its routes now enforce.
+     *
+     * `taxes` used to borrow `catalog:write` — on all four routes, the two reads
+     * included — so this page had no permission of its own to check and the
+     * sidebar entry beside it carried the catalogue's write code. Both moved
+     * together; hiding the screen rather than letting it 403 is the treatment the
+     * sidebar, the palette and the dashboard already apply to a denied
+     * destination, and `AppShell.tsx`'s `PALETTE_ITEMS` comment argues it at
+     * length. The module half is asked too, because the admin router carries no
+     * guard of its own: a module the platform is not running must contribute no
+     * surface at all (Constitution XVII item 5), and a permission gate alone
+     * leaves this screen rendering and answering 503.
+     *
+     * `useSurfaceVisibility` is the predicate the sidebar, the palette and the
+     * dashboard already share, so the two axes are one expression rather than two
+     * that can drift.
+     */
+    const isVisible = useSurfaceVisibility();
+    const canRead = isVisible({ module: 'taxes', requiredPermission: 'taxes:read' });
+    /**
+     * The write half, which is new rather than moved: until this change there was
+     * no read-only role to have, because reading the table required the code that
+     * rewrites it. Now there is, so the upsert form and the per-row delete are
+     * hidden from it — hidden and not disabled, for the reason the screen itself
+     * is, and hidden rather than left to 403 on submit.
+     */
+    const canWrite = isVisible({ module: 'taxes', requiredPermission: 'taxes:write' });
+    const [rows, setRows] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [info, setInfo] = useState(null);
+    const refresh = useCallback(async () => {
+        // A page that renders nothing has no reason to ask the API a question it
+        // will be refused.
+        if (!canRead) {
+            setLoading(false);
+            return;
+        }
+        setLoading(true);
+        setError(null);
+        try {
+            const res = await apiClient.get('/api/v1/admin/taxes');
+            setRows(res.data);
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : t('taxes.error.load'));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [canRead, t]);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    const handleUpsert = useCallback(async (input) => {
+        try {
+            await apiClient.put(`/api/v1/admin/taxes/${encodeURIComponent(input.code)}`, {
+                code: input.code,
+                name: input.name,
+                rate: input.rate,
+                country: input.country,
+                productType: input.productType,
+                appliesToVatStatuses: input.appliesToVatStatuses,
+                isDefault: input.isDefault,
+                priority: input.priority,
+            });
+            setInfo(t('taxes.success.save', { code: input.code }));
+            await refresh();
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : t('taxes.error.save'));
+        }
+    }, [refresh, t]);
+    const handleDelete = useCallback(async (id) => {
+        if (!confirm(t('taxes.deleteConfirm')))
+            return;
+        try {
+            await apiClient.delete(`/api/v1/admin/taxes/${id}`);
+            await refresh();
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : t('taxes.error.delete'));
+        }
+    }, [refresh, t]);
+    if (!canRead) {
+        return (_jsx(Alert, { children: _jsx(AlertDescription, { children: t('taxes.noPermission') }) }));
+    }
+    return (_jsxs(_Fragment, { children: [_jsx(PageHeader, { title: t('taxes.page.title'), description: t('taxes.page.description') }), error ? (_jsx(Alert, { variant: "destructive", className: "mb-4", children: _jsx(AlertDescription, { children: error }) })) : null, info ? (_jsx(Alert, { variant: "success", className: "mb-4", children: _jsx(AlertDescription, { children: info }) })) : null, canWrite ? (_jsxs(Card, { className: "mb-4", children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: t('taxes.upsert.title') }) }), _jsx(CardContent, { children: _jsx(UpsertForm, { onSubmit: handleUpsert }) })] })) : null, _jsx(Card, { children: _jsx(CardContent, { className: "pt-6", children: loading ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('taxes.loading') })) : rows.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('taxes.empty') })) : (_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: t('taxes.column.code') }), _jsx(TableHead, { children: t('taxes.column.name') }), _jsx(TableHead, { children: t('taxes.column.rate') }), _jsx(TableHead, { children: t('taxes.column.country') }), _jsx(TableHead, { children: t('taxes.column.productType') }), _jsx(TableHead, { children: t('taxes.column.vatStatuses') }), _jsx(TableHead, { children: t('taxes.column.default') }), _jsx(TableHead, { children: t('taxes.column.priority') }), _jsx(TableHead, {})] }) }), _jsx(TableBody, { children: rows.map((r) => (_jsxs(TableRow, { children: [_jsx(TableCell, { children: _jsx("code", { className: "font-mono text-xs", children: r.code }) }), _jsx(TableCell, { className: "font-medium", children: r.name }), _jsxs(TableCell, { className: "tabular-nums", children: [(r.rate * 100).toFixed(1), "%"] }), _jsx(TableCell, { children: r.country ?? '—' }), _jsx(TableCell, { children: r.productType ?? '—' }), _jsx(TableCell, { className: "text-xs text-muted-foreground", children: r.appliesToVatStatuses.join(', ') || '—' }), _jsx(TableCell, { children: r.isDefault ? _jsx(Badge, { variant: "default", children: t('taxes.badge.default') }) : null }), _jsx(TableCell, { children: r.priority }), _jsx(TableCell, { children: canWrite ? (_jsxs(Button, { variant: "destructive", size: "sm", type: "button", onClick: () => void handleDelete(r.id), children: [_jsx(Trash2, {}), t('taxes.action.delete')] })) : null })] }, r.id))) })] })) }) })] }));
+}
+function UpsertForm({ onSubmit }) {
+    const t = useTranslation('core');
+    const [code, setCode] = useState('');
+    const [name, setName] = useState('');
+    const [rate, setRate] = useState('0.23');
+    const [country, setCountry] = useState('');
+    const [productType, setProductType] = useState('');
+    const [vatStatuses, setVatStatuses] = useState(new Set());
+    const [isDefault, setIsDefault] = useState(false);
+    const [priority, setPriority] = useState('0');
+    return (_jsxs("form", { className: "space-y-4", onSubmit: (e) => {
+            e.preventDefault();
+            void onSubmit({
+                id: '',
+                code,
+                name,
+                rate: Number(rate),
+                country: country || null,
+                productType: productType || null,
+                appliesToVatStatuses: Array.from(vatStatuses),
+                isDefault,
+                priority: Number(priority),
+            });
+        }, children: [_jsxs("div", { className: "grid gap-4 md:grid-cols-2", children: [_jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "tcode", children: t('taxes.field.code') }), _jsx(Input, { id: "tcode", value: code, onChange: (e) => setCode(e.target.value), required: true })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "tname", children: t('taxes.field.name') }), _jsx(Input, { id: "tname", value: name, onChange: (e) => setName(e.target.value), required: true })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "trate", children: t('taxes.field.rate') }), _jsx(Input, { id: "trate", type: "number", step: "0.001", min: "0", value: rate, onChange: (e) => setRate(e.target.value) })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "tctry", children: t('taxes.field.country') }), _jsx(CountryPicker, { id: "tctry", value: country, onChange: (e) => setCountry(e.target.value), includeBlank: true, blankLabel: t('taxes.option.any') })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "tptype", children: t('taxes.field.productType') }), _jsxs(Select, { id: "tptype", value: productType, onChange: (e) => setProductType(e.target.value), children: [_jsx("option", { value: "", children: t('taxes.option.any') }), PRODUCT_TYPES.map((pt) => (_jsx("option", { value: pt, children: pt }, pt)))] })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "tprio", children: t('taxes.field.priority') }), _jsx(Input, { id: "tprio", type: "number", value: priority, onChange: (e) => setPriority(e.target.value) })] })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { children: t('taxes.field.vatStatuses') }), _jsx("div", { className: "flex flex-wrap gap-3", children: VAT_STATUSES.map((v) => (_jsxs("label", { className: "inline-flex items-center gap-2 text-sm", children: [_jsx(Checkbox, { checked: vatStatuses.has(v), onChange: (e) => setVatStatuses((prev) => {
+                                        const next = new Set(prev);
+                                        if (e.target.checked)
+                                            next.add(v);
+                                        else
+                                            next.delete(v);
+                                        return next;
+                                    }) }), v] }, v))) })] }), _jsxs("label", { className: "inline-flex items-center gap-2 text-sm", children: [_jsx(Checkbox, { checked: isDefault, onChange: (e) => setIsDefault(e.target.checked) }), t('taxes.field.isDefault')] }), _jsx("div", { children: _jsx(Button, { type: "submit", children: t('taxes.action.save') }) })] }));
+}
+export default TaxesPage;
+//# sourceMappingURL=TaxesPage.js.map

package/dist/admin/pages/TaxesPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaxesPage.js","sourceRoot":"","sources":["../../../src/admin/pages/TaxesPage.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAkC,MAAM,OAAO,CAAC;AACzF,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3F,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC5O,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAcjE,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAC3E,MAAM,YAAY,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,CAAU,CAAC;AAE5E,MAAM,UAAU,SAAS;IACvB,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACjC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,CAAC;IACjF;;;;;;OAMG;IACH,MAAM,QAAQ,GAAG,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC,CAAC;IACnF,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAa,EAAE,CAAC,CAAC;IACjD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAEtD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAmB,EAAE;QACpD,yEAAyE;QACzE,mBAAmB;QACnB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,CAAuB,qBAAqB,CAAC,CAAC;YAC7E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACzF,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAEjB,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,OAAO,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,YAAY,GAAG,WAAW,CAC9B,KAAK,EAAE,KAAe,EAAiB,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,GAAG,CACjB,uBAAuB,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EACvD;gBACE,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;gBAChD,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CACF,CAAC;YACF,OAAO,CAAC,CAAC,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACvD,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACzF,CAAC;IACH,CAAC,EACD,CAAC,OAAO,EAAE,CAAC,CAAC,CACb,CAAC;IAEF,MAAM,YAAY,GAAG,WAAW,CAC9B,KAAK,EAAE,EAAU,EAAiB,EAAE;QAClC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;YAAE,OAAO;QAC/C,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,MAAM,CAAO,uBAAuB,EAAE,EAAE,CAAC,CAAC;YAC1D,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC,EACD,CAAC,OAAO,EAAE,CAAC,CAAC,CACb,CAAC;IAEF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CACL,KAAC,KAAK,cACJ,KAAC,gBAAgB,cAAE,CAAC,CAAC,oBAAoB,CAAC,GAAoB,GACxD,CACT,CAAC;IACJ,CAAC;IAED,OAAO,CACL,8BACE,KAAC,UAAU,IACT,KAAK,EAAE,CAAC,CAAC,kBAAkB,CAAC,EAC5B,WAAW,EAAE,CAAC,CAAC,wBAAwB,CAAC,GACxC,EAED,KAAK,CAAC,CAAC,CAAC,CACP,KAAC,KAAK,IAAC,OAAO,EAAC,aAAa,EAAC,SAAS,EAAC,MAAM,YAC3C,KAAC,gBAAgB,cAAE,KAAK,GAAoB,GACtC,CACT,CAAC,CAAC,CAAC,IAAI,EACP,IAAI,CAAC,CAAC,CAAC,CACN,KAAC,KAAK,IAAC,OAAO,EAAC,SAAS,EAAC,SAAS,EAAC,MAAM,YACvC,KAAC,gBAAgB,cAAE,IAAI,GAAoB,GACrC,CACT,CAAC,CAAC,CAAC,IAAI,EAEP,QAAQ,CAAC,CAAC,CAAC,CACV,MAAC,IAAI,IAAC,SAAS,EAAC,MAAM,aACpB,KAAC,UAAU,cACT,KAAC,SAAS,cAAE,CAAC,CAAC,oBAAoB,CAAC,GAAa,GACrC,EACb,KAAC,WAAW,cACV,KAAC,UAAU,IAAC,QAAQ,EAAE,YAAY,GAAI,GAC1B,IACT,CACR,CAAC,CAAC,CAAC,IAAI,EAER,KAAC,IAAI,cACH,KAAC,WAAW,IAAC,SAAS,EAAC,MAAM,YAC1B,OAAO,CAAC,CAAC,CAAC,CACT,YAAG,SAAS,EAAC,+BAA+B,YAAE,CAAC,CAAC,eAAe,CAAC,GAAK,CACtE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CACtB,YAAG,SAAS,EAAC,+BAA+B,YAAE,CAAC,CAAC,aAAa,CAAC,GAAK,CACpE,CAAC,CAAC,CAAC,CACF,MAAC,KAAK,eACJ,KAAC,WAAW,cACV,MAAC,QAAQ,eACP,KAAC,SAAS,cAAE,CAAC,CAAC,mBAAmB,CAAC,GAAa,EAC/C,KAAC,SAAS,cAAE,CAAC,CAAC,mBAAmB,CAAC,GAAa,EAC/C,KAAC,SAAS,cAAE,CAAC,CAAC,mBAAmB,CAAC,GAAa,EAC/C,KAAC,SAAS,cAAE,CAAC,CAAC,sBAAsB,CAAC,GAAa,EAClD,KAAC,SAAS,cAAE,CAAC,CAAC,0BAA0B,CAAC,GAAa,EACtD,KAAC,SAAS,cAAE,CAAC,CAAC,0BAA0B,CAAC,GAAa,EACtD,KAAC,SAAS,cAAE,CAAC,CAAC,sBAAsB,CAAC,GAAa,EAClD,KAAC,SAAS,cAAE,CAAC,CAAC,uBAAuB,CAAC,GAAa,EACnD,KAAC,SAAS,KAAG,IACJ,GACC,EACd,KAAC,SAAS,cACP,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACf,MAAC,QAAQ,eACP,KAAC,SAAS,cACR,eAAM,SAAS,EAAC,mBAAmB,YAAE,CAAC,CAAC,IAAI,GAAQ,GACzC,EACZ,KAAC,SAAS,IAAC,SAAS,EAAC,aAAa,YAAE,CAAC,CAAC,IAAI,GAAa,EACvD,MAAC,SAAS,IAAC,SAAS,EAAC,cAAc,aAAE,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAc,EAC5E,KAAC,SAAS,cAAE,CAAC,CAAC,OAAO,IAAI,GAAG,GAAa,EACzC,KAAC,SAAS,cAAE,CAAC,CAAC,WAAW,IAAI,GAAG,GAAa,EAC7C,KAAC,SAAS,IAAC,SAAS,EAAC,+BAA+B,YACjD,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,GAC/B,EACZ,KAAC,SAAS,cACP,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAC,KAAK,IAAC,OAAO,EAAC,SAAS,YAAE,CAAC,CAAC,qBAAqB,CAAC,GAAS,CAAC,CAAC,CAAC,IAAI,GACvE,EACZ,KAAC,SAAS,cAAE,CAAC,CAAC,QAAQ,GAAa,EACnC,KAAC,SAAS,cACP,QAAQ,CAAC,CAAC,CAAC,CACV,MAAC,MAAM,IACL,OAAO,EAAC,aAAa,EACrB,IAAI,EAAC,IAAI,EACT,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAS,EAAE,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,aAE5C,KAAC,MAAM,KAAG,EACT,CAAC,CAAC,qBAAqB,CAAC,IAClB,CACV,CAAC,CAAC,CAAC,IAAI,GACE,KA3BC,CAAC,CAAC,EAAE,CA4BR,CACZ,CAAC,GACQ,IACN,CACT,GACW,GACT,IACN,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,EAAE,QAAQ,EAAoD;IAChF,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAS,EAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAc,IAAI,GAAG,EAAE,CAAC,CAAC;IACvE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAE9C,OAAO,CACL,gBACE,SAAS,EAAC,WAAW,EACrB,QAAQ,EAAE,CAAC,CAAY,EAAQ,EAAE;YAC/B,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,KAAK,QAAQ,CAAC;gBACZ,EAAE,EAAE,EAAE;gBACN,IAAI;gBACJ,IAAI;gBACJ,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;gBAClB,OAAO,EAAE,OAAO,IAAI,IAAI;gBACxB,WAAW,EAAE,WAAW,IAAI,IAAI;gBAChC,oBAAoB,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;gBAC7C,SAAS;gBACT,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;aAC3B,CAAC,CAAC;QACL,CAAC,aAED,eAAK,SAAS,EAAC,2BAA2B,aACxC,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,OAAO,EAAC,OAAO,YAAE,CAAC,CAAC,kBAAkB,CAAC,GAAS,EACtD,KAAC,KAAK,IAAC,EAAE,EAAC,OAAO,EAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,SAAG,IACtF,EACN,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,OAAO,EAAC,OAAO,YAAE,CAAC,CAAC,kBAAkB,CAAC,GAAS,EACtD,KAAC,KAAK,IAAC,EAAE,EAAC,OAAO,EAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,SAAG,IACtF,EACN,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,OAAO,EAAC,OAAO,YAAE,CAAC,CAAC,kBAAkB,CAAC,GAAS,EACtD,KAAC,KAAK,IACJ,EAAE,EAAC,OAAO,EACV,IAAI,EAAC,QAAQ,EACb,IAAI,EAAC,OAAO,EACZ,GAAG,EAAC,GAAG,EACP,KAAK,EAAE,IAAI,EACX,QAAQ,EAAE,CAAC,CAAC,EAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAC9C,IACE,EACN,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,OAAO,EAAC,OAAO,YAAE,CAAC,CAAC,qBAAqB,CAAC,GAAS,EACzD,KAAC,aAAa,IACZ,EAAE,EAAC,OAAO,EACV,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,CAAC,EAAQ,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACjD,YAAY,QACZ,UAAU,EAAE,CAAC,CAAC,kBAAkB,CAAC,GACjC,IACE,EACN,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,OAAO,EAAC,QAAQ,YAAE,CAAC,CAAC,yBAAyB,CAAC,GAAS,EAC9D,MAAC,MAAM,IACL,EAAE,EAAC,QAAQ,EACX,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,CAAC,CAAC,EAAQ,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,aAErD,iBAAQ,KAAK,EAAC,EAAE,YAAE,CAAC,CAAC,kBAAkB,CAAC,GAAU,EAChD,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CACzB,iBAAiB,KAAK,EAAE,EAAE,YACvB,EAAE,IADQ,EAAE,CAEN,CACV,CAAC,IACK,IACL,EACN,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,IAAC,OAAO,EAAC,OAAO,YAAE,CAAC,CAAC,sBAAsB,CAAC,GAAS,EAC1D,KAAC,KAAK,IACJ,EAAE,EAAC,OAAO,EACV,IAAI,EAAC,QAAQ,EACb,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,CAAC,CAAC,EAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAClD,IACE,IACF,EACN,eAAK,SAAS,EAAC,WAAW,aACxB,KAAC,KAAK,cAAE,CAAC,CAAC,yBAAyB,CAAC,GAAS,EAC7C,cAAK,SAAS,EAAC,sBAAsB,YAClC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACvB,iBAAe,SAAS,EAAC,wCAAwC,aAC/D,KAAC,QAAQ,IACP,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAC3B,QAAQ,EAAE,CAAC,CAAC,EAAQ,EAAE,CACpB,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE;wCACtB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;wCAC3B,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO;4CAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;;4CAC7B,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;wCACpB,OAAO,IAAI,CAAC;oCACd,CAAC,CAAC,GAEJ,EACD,CAAC,KAZQ,CAAC,CAaL,CACT,CAAC,GACE,IACF,EACN,iBAAO,SAAS,EAAC,wCAAwC,aACvD,KAAC,QAAQ,IACP,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,CAAC,CAAC,EAAQ,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GACrD,EACD,CAAC,CAAC,uBAAuB,CAAC,IACrB,EACR,wBACE,KAAC,MAAM,IAAC,IAAI,EAAC,QAAQ,YAAE,CAAC,CAAC,mBAAmB,CAAC,GAAU,GACnD,IACD,CACR,CAAC;AACJ,CAAC;AACD,eAAe,SAAS,CAAC"}

package/dist/backend/demo/reset.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Withdraw `taxes`' demo data (feature 113, T220 — contract §2.5).
+ *
+ * By the fixed codes `seed` assigns, never by a predicate over the table: an
+ * operator's own rule is indistinguishable from a demo one by every other
+ * column, and a `delete from taxes` would take theirs with it. This is the
+ * withdrawal that replaces `taxes`' line in the host's 29-table
+ * `truncate … cascade`, which could not tell the two apart at all.
+ */
+import type { DemoResetResult, ModuleDemoContext } from '@endora-commerce/contracts';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+export declare function resetDemo(context: ModuleDemoContext<ModuleContext>): Promise<DemoResetResult>;
+//# sourceMappingURL=reset.d.ts.map

package/dist/backend/demo/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../../src/backend/demo/reset.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAStE,wBAAsB,SAAS,CAC7B,OAAO,EAAE,iBAAiB,CAAC,aAAa,CAAC,GACxC,OAAO,CAAC,eAAe,CAAC,CAO1B"}

package/dist/backend/demo/reset.js

@@ -0,0 +1,11 @@
+import { Tax } from '../entities/tax.entity.js';
+import { DEMO_TAX_CODES } from './rows.js';
+export async function resetDemo(context) {
+    // command-coverage-ignore: the withdrawal half of the demo data above. Same
+    // entry point, same `mustBeNonProduction()` guard, same absence of an
+    // operator to attribute the write to (contract §2.7).
+    const em = context.ctx.cradle().emFactory();
+    const removed = await em.nativeDelete(Tax, { code: { $in: [...DEMO_TAX_CODES] } });
+    return { removed: [{ entity: 'Tax', count: removed }] };
+}
+//# sourceMappingURL=reset.js.map

package/dist/backend/demo/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.js","sourceRoot":"","sources":["../../../src/backend/demo/reset.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAM3C,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAyC;IAEzC,4EAA4E;IAC5E,sEAAsE;IACtE,sDAAsD;IACtD,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAmB,CAAC,SAAS,EAAE,CAAC;IAC7D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;IACnF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AAC1D,CAAC"}

package/dist/backend/demo/rows.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The tax rules this module's demo data creates (feature 113, T220).
+ *
+ * One place holding the data, imported by both bodies: `seed.ts` creates these
+ * rows and `reset.ts` withdraws exactly them, by the `code` they are keyed on
+ * (contract §2.5 — a predicate over the table would take an operator's own rule
+ * with it).
+ *
+ * The values are the host seed's verbatim, moved rather than rewritten. The
+ * frozen copy the parity comparison read them against is deleted with that
+ * comparison (T226); what holds them now is
+ * `test/integration/demo/demo-shop.test.ts`' recorded delta.
+ */
+/** One demo tax rule, in `Tax`'s own field names. */
+export interface DemoTaxRow {
+    readonly code: string;
+    readonly name: string;
+    readonly rate: string;
+    readonly country: string;
+    readonly isDefault: boolean;
+}
+/**
+ * The Polish standard VAT rate.
+ *
+ * `name` is a plain column on `Tax` rather than a per-language map, so contract
+ * §2.6's per-language shape has nowhere to go here; the value is a rule label
+ * built out of a country code and a percentage, and it reads the same in both
+ * shipped languages.
+ */
+export declare const DEMO_TAX_ROWS: readonly DemoTaxRow[];
+/** The codes `reset` withdraws — derived from the rows, never a second list. */
+export declare const DEMO_TAX_CODES: readonly string[];
+//# sourceMappingURL=rows.d.ts.map

package/dist/backend/demo/rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../../src/backend/demo/rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,UAAU,EAE9C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAyC,CAAC"}

package/dist/backend/demo/rows.js

@@ -0,0 +1,27 @@
+/**
+ * The tax rules this module's demo data creates (feature 113, T220).
+ *
+ * One place holding the data, imported by both bodies: `seed.ts` creates these
+ * rows and `reset.ts` withdraws exactly them, by the `code` they are keyed on
+ * (contract §2.5 — a predicate over the table would take an operator's own rule
+ * with it).
+ *
+ * The values are the host seed's verbatim, moved rather than rewritten. The
+ * frozen copy the parity comparison read them against is deleted with that
+ * comparison (T226); what holds them now is
+ * `test/integration/demo/demo-shop.test.ts`' recorded delta.
+ */
+/**
+ * The Polish standard VAT rate.
+ *
+ * `name` is a plain column on `Tax` rather than a per-language map, so contract
+ * §2.6's per-language shape has nowhere to go here; the value is a rule label
+ * built out of a country code and a percentage, and it reads the same in both
+ * shipped languages.
+ */
+export const DEMO_TAX_ROWS = [
+    { code: 'pl_vat_23', name: 'PL VAT 23%', rate: '0.23', country: 'PL', isDefault: true },
+];
+/** The codes `reset` withdraws — derived from the rows, never a second list. */
+export const DEMO_TAX_CODES = DEMO_TAX_ROWS.map((row) => row.code);
+//# sourceMappingURL=rows.js.map

package/dist/backend/demo/rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.js","sourceRoot":"","sources":["../../../src/backend/demo/rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;CACxF,CAAC;AAEF,gFAAgF;AAChF,MAAM,CAAC,MAAM,cAAc,GAAsB,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC"}

package/dist/backend/demo/seed.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `taxes`' demo data (feature 113, T220 — contract §2).
+ *
+ * The block that used to sit at the bottom of the host seed's 887-line
+ * `main()`, in the module that owns the table. It writes `taxes` and nothing
+ * else (§2.1), reads no other module's table and resolves no port (§2.2), so
+ * declaring it added no entry to this module's manifest `dependencies` (§2.3).
+ *
+ * Idempotent by an existence probe on the natural key (§2.4): a second run
+ * creates nothing and reports the same count, which is what makes SC-007
+ * assertable from the report rather than from a database diff.
+ */
+import type { DemoSeedResult, ModuleDemoContext } from '@endora-commerce/contracts';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+export declare function seedDemo(context: ModuleDemoContext<ModuleContext>): Promise<DemoSeedResult>;
+//# sourceMappingURL=seed.d.ts.map

package/dist/backend/demo/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../src/backend/demo/seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAUtE,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,iBAAiB,CAAC,aAAa,CAAC,GACxC,OAAO,CAAC,cAAc,CAAC,CA4BzB"}

package/dist/backend/demo/seed.js

@@ -0,0 +1,31 @@
+import { Tax } from '../entities/tax.entity.js';
+import { DEMO_TAX_ROWS } from './rows.js';
+export async function seedDemo(context) {
+    // command-coverage-ignore: demo data, reached only by `endora demo seed`,
+    // whose entry point calls `mustBeNonProduction()` as its first statement and
+    // outside every `try` (contract §2.7, §3.3). The guard is the enforcement:
+    // this write has no operator, no tenant and no audit reader, and the command
+    // refuses to run against a production database at all.
+    const em = context.ctx.cradle().emFactory();
+    for (const row of DEMO_TAX_ROWS) {
+        const existing = await em.findOne(Tax, { code: row.code });
+        // Present already: left exactly as it is. An operator may have edited the
+        // demo rule, and overwriting it here would be this body deciding that its
+        // own literal outranks their change — which is `reset`'s question, not
+        // `seed`'s.
+        if (existing)
+            continue;
+        em.create(Tax, {
+            code: row.code,
+            name: row.name,
+            rate: row.rate,
+            country: row.country,
+            isDefault: row.isDefault,
+        });
+    }
+    await em.flush();
+    // The count is what the demo *holds* after the run, not what this call
+    // inserted: seeding twice must report the same counts (`DemoEntityCount`).
+    return { created: [{ entity: 'Tax', count: DEMO_TAX_ROWS.length }] };
+}
+//# sourceMappingURL=seed.js.map

package/dist/backend/demo/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../../src/backend/demo/seed.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAO1C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAyC;IAEzC,0EAA0E;IAC1E,6EAA6E;IAC7E,2EAA2E;IAC3E,6EAA6E;IAC7E,uDAAuD;IACvD,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAmB,CAAC,SAAS,EAAE,CAAC;IAE7D,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,0EAA0E;QAC1E,0EAA0E;QAC1E,uEAAuE;QACvE,YAAY;QACZ,IAAI,QAAQ;YAAE,SAAS;QACvB,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE;YACb,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;IAEjB,uEAAuE;IACvE,2EAA2E;IAC3E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/backend/entities/tax.entity.d.ts

@@ -0,0 +1,21 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * Tax — a single rule. Resolution narrows by `country`, `productType`, and
+ * `appliesToVatStatuses` (T128 / FR-051). At most one row may carry
+ * `isDefault=true`; that row wins when no narrower rule matches.
+ */
+export declare class Tax {
+    [OptionalProps]?: 'id' | 'createdAt' | 'updatedAt' | 'country' | 'productType' | 'appliesToVatStatuses' | 'isDefault' | 'priority';
+    id: string;
+    code: string;
+    name: string;
+    rate: string;
+    country?: string | null;
+    productType?: 'simple' | 'configurable' | 'grouped' | 'bundle' | 'virtual' | null;
+    appliesToVatStatuses: Array<'vat_payer' | 'vat_exempt' | 'reverse_charge'>;
+    isDefault: boolean;
+    priority: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=tax.entity.d.ts.map

package/dist/backend/entities/tax.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tax.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/tax.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAI7F;;;;GAIG;AACH,qBAEa,GAAG;IACd,CAAC,aAAa,CAAC,CAAC,EACZ,IAAI,GACJ,WAAW,GACX,WAAW,GACX,SAAS,GACT,aAAa,GACb,sBAAsB,GACtB,WAAW,GACX,UAAU,CAAC;IAGf,EAAE,EAAE,MAAM,CAAgB;IAI1B,IAAI,EAAG,MAAM,CAAC;IAGd,IAAI,EAAG,MAAM,CAAC;IAGd,IAAI,EAAG,MAAM,CAAC;IAId,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGxB,WAAW,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;IAGlF,oBAAoB,EAAE,KAAK,CAAC,WAAW,GAAG,YAAY,GAAG,gBAAgB,CAAC,CAAM;IAGhF,SAAS,EAAE,OAAO,CAAS;IAG3B,QAAQ,EAAE,MAAM,CAAK;IAGrB,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/tax.entity.js

@@ -0,0 +1,83 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property, Unique } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * Tax — a single rule. Resolution narrows by `country`, `productType`, and
+ * `appliesToVatStatuses` (T128 / FR-051). At most one row may carry
+ * `isDefault=true`; that row wins when no narrower rule matches.
+ */
+let Tax = class Tax {
+    [OptionalProps];
+    id = randomUUID();
+    code;
+    name;
+    rate;
+    country;
+    productType;
+    appliesToVatStatuses = [];
+    isDefault = false;
+    priority = 0;
+    createdAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], Tax.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'string', length: 64 }),
+    Unique(),
+    __metadata("design:type", String)
+], Tax.prototype, "code", void 0);
+__decorate([
+    Property({ type: 'string', length: 160 }),
+    __metadata("design:type", String)
+], Tax.prototype, "name", void 0);
+__decorate([
+    Property({ type: 'decimal', precision: 6, scale: 4 }),
+    __metadata("design:type", String)
+], Tax.prototype, "rate", void 0);
+__decorate([
+    Property({ type: 'string', length: 2, nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], Tax.prototype, "country", void 0);
+__decorate([
+    Property({ type: 'string', length: 16, nullable: true }),
+    __metadata("design:type", Object)
+], Tax.prototype, "productType", void 0);
+__decorate([
+    Property({ type: 'json' }),
+    __metadata("design:type", Array)
+], Tax.prototype, "appliesToVatStatuses", void 0);
+__decorate([
+    Property({ type: 'boolean' }),
+    __metadata("design:type", Boolean)
+], Tax.prototype, "isDefault", void 0);
+__decorate([
+    Property({ type: 'integer' }),
+    __metadata("design:type", Number)
+], Tax.prototype, "priority", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], Tax.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], Tax.prototype, "updatedAt", void 0);
+Tax = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'taxes' })
+], Tax);
+export { Tax };
+//# sourceMappingURL=tax.entity.js.map

package/dist/backend/entities/tax.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tax.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/tax.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;GAIG;AAGI,IAAM,GAAG,GAAT,MAAM,GAAG;IACd,CAAC,aAAa,CAAC,CAQA;IAGf,EAAE,GAAW,UAAU,EAAE,CAAC;IAI1B,IAAI,CAAU;IAGd,IAAI,CAAU;IAGd,IAAI,CAAU;IAId,OAAO,CAAiB;IAGxB,WAAW,CAAuE;IAGlF,oBAAoB,GAAyD,EAAE,CAAC;IAGhF,SAAS,GAAY,KAAK,CAAC;IAG3B,QAAQ,GAAW,CAAC,CAAC;IAGrB,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;IAG7B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AAjCC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;+BACH;AAI1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxC,MAAM,EAAE;;iCACK;AAGd;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;iCAC5B;AAGd;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;;iCACxC;AAId;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvD,KAAK,EAAE;;oCACgB;AAGxB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wCACyB;AAGlF;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;8BACL,KAAK;iDAAqD;AAGhF;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;sCACH;AAG3B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;qCACT;AAGrB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;sCAAc;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;sCAAc;AA5ClB,GAAG;IAFf,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;GAClB,GAAG,CA6Cf"}