@endora-commerce/mod-comparisons 0.0.0-stage → 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

@@ -1,3 +1,62 @@
-# Temporary Holding Version
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @endora-commerce/mod-comparisons
+
+Customer-facing product comparison feature with shareable links and PDF export.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `comparisons` — 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-comparisons` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-comparisons/admin` | the Admin UI contribution: the screens, navigation and palette actions it adds |
+| `@endora-commerce/mod-comparisons/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-comparisons/migrations` | the module’s own schema migrations, in the order the platform runs them |
+| `@endora-commerce/mod-comparisons/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**
+
+- `@fastify/cookie` ^11
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `@types/pdfmake` ^0
+- `fastify` ^5
+- `lucide-react` ^1 — *optional*
+- `pdfmake` ^0
+- `react` ^19 — *optional*
+- `react-router-dom` ^7 — *optional*
+- `zod` ^4
+
+## 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-comparisons
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/admin/api/comparisons-client.d.ts

@@ -0,0 +1,24 @@
+import type { ComparisonAdminDetail, ComparisonAdminListItem, ComparisonAdminListQuery, ScopeNoticeCode } from '@endora-commerce/contracts';
+/**
+ * Admin client helpers for the Comparisons overview (feature 007 / US5
+ * / T066). Maps query filters to the backend's GET surface and unwraps
+ * the standard `{ data, meta }` envelope.
+ */
+export interface ListResult {
+    data: ComparisonAdminListItem[];
+    meta: {
+        limit: number;
+        nextCursor: string | null;
+        /**
+         * Present only when the server refused every row for want of an
+         * organization on the record (feature 087). Read it with `scopeNoticeOf`
+         * rather than by hand — the shape is the contract's, not this screen's.
+         */
+        scopeNotice?: ScopeNoticeCode;
+    };
+}
+export declare function listComparisons(filters: Partial<ComparisonAdminListQuery>): Promise<ListResult>;
+export declare function getComparisonDetail(id: string): Promise<{
+    data: ComparisonAdminDetail;
+}>;
+//# sourceMappingURL=comparisons-client.d.ts.map

package/dist/admin/api/comparisons-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparisons-client.d.ts","sourceRoot":"","sources":["../../../src/admin/api/comparisons-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AAEpC;;;;GAIG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,uBAAuB,EAAE,CAAC;IAChC,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B;;;;WAIG;QACH,WAAW,CAAC,EAAE,eAAe,CAAC;KAC/B,CAAC;CACH;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACzC,OAAO,CAAC,UAAU,CAAC,CAUrB;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,IAAI,EAAE,qBAAqB,CAAA;CAAE,CAAC,CAI1C"}

package/dist/admin/api/comparisons-client.js

@@ -0,0 +1,15 @@
+import { apiClient } from '@endora-commerce/admin-kit/lib';
+export async function listComparisons(filters) {
+    const params = new URLSearchParams();
+    for (const [k, v] of Object.entries(filters)) {
+        if (v === undefined || v === null || v === '')
+            continue;
+        params.set(k, String(v));
+    }
+    const qs = params.toString();
+    return apiClient.get(`/api/v1/admin/comparisons${qs ? `?${qs}` : ''}`);
+}
+export async function getComparisonDetail(id) {
+    return apiClient.get(`/api/v1/admin/comparisons/${encodeURIComponent(id)}`);
+}
+//# sourceMappingURL=comparisons-client.js.map

package/dist/admin/api/comparisons-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparisons-client.js","sourceRoot":"","sources":["../../../src/admin/api/comparisons-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AA4B3D,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA0C;IAE1C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE;YAAE,SAAS;QACxD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,OAAO,SAAS,CAAC,GAAG,CAClB,4BAA4B,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACjD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAU;IAEV,OAAO,SAAS,CAAC,GAAG,CAClB,6BAA6B,kBAAkB,CAAC,EAAE,CAAC,EAAE,CACtD,CAAC;AACJ,CAAC"}

package/dist/admin/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `comparisons`' admin surface — two routes and one sidebar entry, declared by
+ * the module that owns them (feature 091, Phase 4, the plan's batch 6;
+ * `specs/091-module-owned-admin-surfaces/contracts/admin-contribution.md`).
+ *
+ * **The batch this module belongs to was unblocked by P2 rather than chosen by
+ * size.** `plan.md`'s sequence table records this module's drain as **1**, and
+ * that one key was `ComparisonsListPage.tsx`'s reach into
+ * `admin/src/components/sales-channel-picker` — a Group A entry in
+ * `backend/scripts/ledgers/admin-surface.ts`, retired when the picker became
+ * `@endora-commerce/admin-kit/components`'. The screen names the published
+ * component now, so this batch pays no reach of its own.
+ *
+ * **The detail route has no sidebar row and never will** — a nav entry is a
+ * landing surface. `registryCrumbs` matches anything beneath a contributed
+ * entry's `to`, so `/comparisons/:id` keeps a derived trail rather than falling
+ * onto the humanised-segment fallback; it is two crumbs where the hand-written
+ * `CRUMB_DICT` rule built three, which is the visible consequence this
+ * conversion records rather than hides.
+ *
+ * **Both routes take the read code, and that is the whole of what this surface
+ * enforces.** The admin side of this module is read-only —
+ * `routes.admin.ts` mounts one list and one detail handler, each behind
+ * `requireAdmin('comparisons:read')`, and there is no write route to gate.
+ *
+ * **This entry exports data and nothing else** (R2), like every `./admin`
+ * layer: `check:module-boundary`'s D-171 rule designates a subpath as contract
+ * surface when it emits no runtime binding, and `./admin` deliberately does not
+ * qualify, so a consumer reaching into another module's `./admin` stays a
+ * counted boundary reach.
+ *
+ * **Each component is a dynamic-import factory** (R6), so Vite has a split
+ * point whether or not anybody remembers to ask for one.
+ */
+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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAcnF,eAAO,MAAM,aAAa,EAAE,kBAqC3B,CAAC"}

package/dist/admin/index.js

@@ -0,0 +1,49 @@
+/** The module's landing route: the comparison overview. */
+const ROUTE_PATH = '/comparisons';
+/**
+ * The code both routes of this module's admin API enforce —
+ * `requireAdmin('comparisons:read')` on `GET /api/v1/admin/comparisons` and on
+ * `GET /api/v1/admin/comparisons/:id`. It is the same code the module's
+ * `open-comparisons` palette action declares, which
+ * `check:action-route-permissions` holds to the landing route.
+ */
+const PERMISSION = 'comparisons:read';
+export const contributions = {
+    routes: [
+        {
+            path: ROUTE_PATH,
+            component: () => import('./pages/ComparisonsListPage.js'),
+            requiredPermission: PERMISSION,
+            index: true,
+        },
+        {
+            path: `${ROUTE_PATH}/:id`,
+            component: () => import('./pages/ComparisonDetailPage.js'),
+            requiredPermission: PERMISSION,
+        },
+    ],
+    nav: [
+        {
+            to: ROUTE_PATH,
+            // Module-relative (R8), resolved in this module's own namespace out of
+            // `packages/modules/comparisons/i18n/`. It was `appShell.nav.comparisons`
+            // in the shared `_i18n` bundle, one of the four shared files a module
+            // author had to edit.
+            labelKey: 'nav.comparisons.label',
+            // The glyph `AppShell.tsx` rendered by hand. A nav entry names its icon,
+            // so `Scale` joins `KnownIconNameSchema` and the kit's `icon-map.ts` in
+            // this merge request rather than the sidebar quietly changing to a name
+            // that happened to be on the allowlist.
+            icon: 'Scale',
+            section: 'customers',
+            // The hand-written position in *Customers* times a hundred, which is
+            // batch four's convention: `/comparisons` was the sixth and last row of
+            // that section. Every other row there is still host-declared, so
+            // `composeNav` appends this one after all of them — which is the position
+            // it already had.
+            weight: 600,
+            requiredPermission: PERMISSION,
+        },
+    ],
+};
+//# 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":"AAoCA,2DAA2D;AAC3D,MAAM,UAAU,GAAG,cAAc,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,MAAM,EAAE;QACN;YACE,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,gCAAgC,CAAC;YACzD,kBAAkB,EAAE,UAAU;YAC9B,KAAK,EAAE,IAAI;SACZ;QACD;YACE,IAAI,EAAE,GAAG,UAAU,MAAM;YACzB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,iCAAiC,CAAC;YAC1D,kBAAkB,EAAE,UAAU;SAC/B;KACF;IACD,GAAG,EAAE;QACH;YACE,EAAE,EAAE,UAAU;YACd,uEAAuE;YACvE,0EAA0E;YAC1E,sEAAsE;YACtE,sBAAsB;YACtB,QAAQ,EAAE,uBAAuB;YACjC,yEAAyE;YACzE,wEAAwE;YACxE,wEAAwE;YACxE,wCAAwC;YACxC,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,WAAW;YACpB,qEAAqE;YACrE,wEAAwE;YACxE,iEAAiE;YACjE,0EAA0E;YAC1E,kBAAkB;YAClB,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,UAAU;SAC/B;KACF;CACF,CAAC"}

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

@@ -0,0 +1,19 @@
+import { type ReactNode } from 'react';
+/**
+ * `<ComparisonDetailPage>` — feature 007 / US5 / T068.
+ *
+ * Read-only detail of a single Comparison. Renders the products and the
+ * comparable-attribute projection in the comparison's RECORDED sales-channel
+ * context (the creator's, not the admin's). No mutation controls.
+ *
+ * **The figures are the channel's, not the customer's.** Since the comparison
+ * became viewer-priced, the customer sees their own organisation's prices and
+ * an administrator — who has no buying organisation — sees the channel's. The
+ * screen says so rather than letting the reader assume the two agree, which is
+ * the same reason the storefront's shared view says whose prices it is showing.
+ * Every product is listed, including ones restricted to organizations other
+ * than the reader's: this is the audit view, and its question is what the
+ * customer put in the comparison.
+ */
+export default function ComparisonDetailPage(): ReactNode;
+//# sourceMappingURL=ComparisonDetailPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComparisonDetailPage.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/ComparisonDetailPage.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAsB5D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,IAAI,SAAS,CA2IxD"}

package/dist/admin/pages/ComparisonDetailPage.js

@@ -0,0 +1,62 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { Link, useParams } from 'react-router-dom';
+import { ApiError } from '@endora-commerce/admin-kit/lib';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+import { Alert, AlertDescription, Badge, Button, Card, CardContent, PageHeader, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, } from '@endora-commerce/admin-kit/ui';
+import { getComparisonDetail } from '../api/comparisons-client.js';
+/**
+ * `<ComparisonDetailPage>` — feature 007 / US5 / T068.
+ *
+ * Read-only detail of a single Comparison. Renders the products and the
+ * comparable-attribute projection in the comparison's RECORDED sales-channel
+ * context (the creator's, not the admin's). No mutation controls.
+ *
+ * **The figures are the channel's, not the customer's.** Since the comparison
+ * became viewer-priced, the customer sees their own organisation's prices and
+ * an administrator — who has no buying organisation — sees the channel's. The
+ * screen says so rather than letting the reader assume the two agree, which is
+ * the same reason the storefront's shared view says whose prices it is showing.
+ * Every product is listed, including ones restricted to organizations other
+ * than the reader's: this is the audit view, and its question is what the
+ * customer put in the comparison.
+ */
+export default function ComparisonDetailPage() {
+    const t = useTranslation('comparisons');
+    const { id } = useParams();
+    const [detail, setDetail] = useState(null);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        if (!id)
+            return;
+        let cancelled = false;
+        void (async () => {
+            try {
+                const res = await getComparisonDetail(id);
+                if (!cancelled)
+                    setDetail(res.data);
+            }
+            catch (err) {
+                if (!cancelled) {
+                    setError(err instanceof ApiError ? err.envelope.error.message : t('error.load'));
+                }
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [id]);
+    if (error) {
+        return (_jsxs(_Fragment, { children: [_jsx(PageHeader, { title: t('detail.page.title') }), _jsx(Alert, { variant: "destructive", children: _jsx(AlertDescription, { children: error }) }), _jsx("div", { className: "mt-4", children: _jsx(Button, { asChild: true, variant: "outline", children: _jsx(Link, { to: "/comparisons", children: t('detail.backToList') }) }) })] }));
+    }
+    if (!detail) {
+        return (_jsxs(_Fragment, { children: [_jsx(PageHeader, { title: t('detail.page.title') }), _jsx("p", { className: "text-sm text-muted-foreground", children: t('common.loading') })] }));
+    }
+    return (_jsxs(_Fragment, { children: [_jsx(PageHeader, { title: t('detail.page.title'), description: t('detail.page.description') }), _jsx(Alert, { className: "mb-4", children: _jsx(AlertDescription, { children: t('detail.pricesNote') }) }), _jsx(Card, { className: "mb-4", children: _jsxs(CardContent, { className: "pt-6 space-y-2", children: [_jsxs("div", { children: [_jsxs("strong", { children: [t('detail.owner'), ":"] }), ' ', detail.owner.kind === 'customer'
+                                    ? detail.owner.email ?? t('owner.noEmail')
+                                    : t('owner.anonymousWithToken', { token: detail.owner.anonymousToken ?? '—' })] }), _jsxs("div", { children: [_jsxs("strong", { children: [t('detail.salesChannel'), ":"] }), ' ', _jsx("code", { className: "font-mono text-xs", children: detail.salesChannel.code })] }), _jsxs("div", { children: [_jsxs("strong", { children: [t('detail.displayMode'), ":"] }), ' ', _jsx(Badge, { variant: "default", children: t(`displayMode.${detail.displayMode}`) })] }), _jsxs("div", { children: [_jsxs("strong", { children: [t('detail.shareToken'), ":"] }), ' ', _jsx("code", { className: "font-mono text-xs", children: detail.shareToken })] }), _jsxs("div", { className: "text-muted-foreground", children: [t('detail.created'), " ", new Date(detail.createdAt).toLocaleString(), " \u00B7 ", t('detail.updated'), ' ', new Date(detail.updatedAt).toLocaleString()] })] }) }), _jsx(Card, { children: _jsx(CardContent, { className: "pt-6", children: _jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: t('detail.attribute') }), detail.products.map((p) => (_jsxs(TableHead, { children: [_jsx("div", { children: localised(p.name) }), _jsx("div", { className: "text-xs text-muted-foreground", children: p.price ? `${p.price.amount} ${p.price.currency}` : '—' })] }, p.id)))] }) }), _jsx(TableBody, { children: detail.comparableAttributes.length === 0 ? (_jsx(TableRow, { children: _jsx(TableCell, { colSpan: detail.products.length + 1, className: "text-muted-foreground", children: t('detail.noComparableAttributes') }) })) : (detail.comparableAttributes.map((row) => (_jsxs(TableRow, { children: [_jsxs(TableCell, { children: [_jsx("strong", { children: localised(row.label) }), ' ', _jsx(Badge, { variant: row.rowClass === 'common' ? 'success' : 'warning', className: "ml-2", children: row.rowClass })] }), row.values.map((v, idx) => (_jsx(TableCell, { children: v ?? '—' }, `${row.key}-${idx}`)))] }, row.key)))) })] }) }) }), _jsx("div", { className: "mt-4", children: _jsx(Button, { asChild: true, variant: "outline", children: _jsx(Link, { to: "/comparisons", children: t('detail.backToList') }) }) })] }));
+}
+function localised(value) {
+    return value['en-US'] ?? value['en'] ?? Object.values(value)[0] ?? '';
+}
+//# sourceMappingURL=ComparisonDetailPage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComparisonDetailPage.js","sourceRoot":"","sources":["../../../src/admin/pages/ComparisonDetailPage.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,10 @@
+import { type ReactNode } from 'react';
+/**
+ * `<ComparisonsListPage>` — feature 007 / US5 / T067.
+ *
+ * Read-only listing of every Comparison the storefront has generated.
+ * Filters: sales channel id, owner type (customer / anonymous), time
+ * range. Cursor pagination. Click a row to open the detail page.
+ */
+export default function ComparisonsListPage(): ReactNode;
+//# sourceMappingURL=ComparisonsListPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComparisonsListPage.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/ComparisonsListPage.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AA2BzE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,IAAI,SAAS,CAoLvD"}

package/dist/admin/pages/ComparisonsListPage.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from 'react';
+import { Link } from 'react-router-dom';
+import { ArrowRight } from 'lucide-react';
+import { scopeNoticeOf } from '@endora-commerce/contracts';
+import { ApiError } from '@endora-commerce/admin-kit/lib';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+import { Alert, AlertDescription, Badge, Button, Card, CardContent, Input, Label, PageHeader, Select, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, } from '@endora-commerce/admin-kit/ui';
+import { SalesChannelPicker, ScopeNotice } from '@endora-commerce/admin-kit/components';
+import { listComparisons } from '../api/comparisons-client.js';
+/**
+ * `<ComparisonsListPage>` — feature 007 / US5 / T067.
+ *
+ * Read-only listing of every Comparison the storefront has generated.
+ * Filters: sales channel id, owner type (customer / anonymous), time
+ * range. Cursor pagination. Click a row to open the detail page.
+ */
+export default function ComparisonsListPage() {
+    const t = useTranslation('comparisons');
+    const [rows, setRows] = useState([]);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [nextCursor, setNextCursor] = useState(null);
+    // Why the list is empty, when it is (feature 087). The server is the only
+    // party that can tell "none of these is yours" from "there are none", so the
+    // screen carries the answer rather than guessing at it.
+    const [scopeNotice, setScopeNotice] = useState(null);
+    const [salesChannelId, setSalesChannelId] = useState('');
+    const [ownerType, setOwnerType] = useState('');
+    const [createdAfter, setCreatedAfter] = useState('');
+    const [createdBefore, setCreatedBefore] = useState('');
+    const refresh = useCallback(async (cursor) => {
+        setLoading(true);
+        setError(null);
+        try {
+            const filters = {};
+            if (salesChannelId)
+                filters['salesChannelId'] = salesChannelId;
+            if (ownerType)
+                filters['ownerType'] = ownerType;
+            if (createdAfter)
+                filters['createdAfter'] = new Date(createdAfter).toISOString();
+            if (createdBefore)
+                filters['createdBefore'] = new Date(createdBefore).toISOString();
+            if (cursor)
+                filters['cursor'] = cursor;
+            const res = await listComparisons(filters);
+            if (cursor) {
+                setRows((prev) => [...prev, ...res.data]);
+            }
+            else {
+                setRows(res.data);
+            }
+            setNextCursor(res.meta.nextCursor);
+            setScopeNotice(scopeNoticeOf(res));
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : t('error.load'));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [salesChannelId, ownerType, createdAfter, createdBefore]);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    return (_jsxs(_Fragment, { children: [_jsx(PageHeader, { title: t('list.page.title'), description: t('list.page.description') }), error ? (_jsx(Alert, { variant: "destructive", className: "mb-4", children: _jsx(AlertDescription, { children: error }) })) : null, _jsx(Card, { className: "mb-4", children: _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "grid gap-4 md:grid-cols-4", children: [_jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "sales-channel-id", children: t('list.filter.salesChannelId') }), _jsx(SalesChannelPicker, { id: "sales-channel-id", value: salesChannelId || null, onChange: (v) => setSalesChannelId(v ?? '') })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "owner-type", children: t('list.filter.owner') }), _jsxs(Select, { id: "owner-type", value: ownerType, onChange: (e) => setOwnerType(e.target.value), children: [_jsx("option", { value: "", children: t('owner.any') }), _jsx("option", { value: "customer", children: t('owner.customer') }), _jsx("option", { value: "anonymous", children: t('owner.anonymous') })] })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "created-after", children: t('list.filter.createdAfter') }), _jsx(Input, { id: "created-after", type: "datetime-local", value: createdAfter, onChange: (e) => setCreatedAfter(e.target.value) })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "created-before", children: t('list.filter.createdBefore') }), _jsx(Input, { id: "created-before", type: "datetime-local", value: createdBefore, onChange: (e) => setCreatedBefore(e.target.value) })] })] }) }) }), _jsx(Card, { children: _jsx(CardContent, { className: "pt-6", children: loading && rows.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('common.loading') })) : rows.length === 0 ? (scopeNotice ? (_jsx(ScopeNotice, { notice: scopeNotice })) : (_jsx("p", { className: "text-sm text-muted-foreground", children: t('list.empty') }))) : (_jsxs(_Fragment, { children: [_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: t('list.column.owner') }), _jsx(TableHead, { children: t('list.column.salesChannel') }), _jsx(TableHead, { children: t('list.column.mode') }), _jsx(TableHead, { children: t('list.column.products') }), _jsx(TableHead, { children: t('list.column.created') }), _jsx(TableHead, { className: "text-right", children: t('list.column.open') })] }) }), _jsx(TableBody, { children: rows.map((c) => (_jsxs(TableRow, { children: [_jsx(TableCell, { children: c.owner.kind === 'customer' ? (_jsx("span", { children: c.owner.email ?? t('owner.noEmailOnFile') })) : (_jsx(Badge, { variant: "secondary", children: t('owner.anonymous') })) }), _jsx(TableCell, { children: _jsx("code", { className: "font-mono text-xs", children: c.salesChannel.code }) }), _jsx(TableCell, { children: _jsx(Badge, { variant: "default", children: t(`displayMode.${c.displayMode}`) }) }), _jsx(TableCell, { children: c.productCount }), _jsx(TableCell, { className: "text-muted-foreground", children: new Date(c.createdAt).toLocaleString() }), _jsx(TableCell, { className: "text-right", children: _jsx(Button, { asChild: true, variant: "ghost", size: "sm", children: _jsx(Link, { to: `/comparisons/${c.id}`, children: _jsx(ArrowRight, { className: "size-4" }) }) }) })] }, c.id))) })] }), nextCursor ? (_jsx("div", { className: "mt-4 text-center", children: _jsx(Button, { variant: "outline", disabled: loading, onClick: () => {
+                                        void refresh(nextCursor);
+                                    }, children: loading ? t('common.loading') : t('list.loadMore') }) })) : null] })) }) })] }));
+}
+//# sourceMappingURL=ComparisonsListPage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComparisonsListPage.js","sourceRoot":"","sources":["../../../src/admin/pages/ComparisonsListPage.tsx"],"names":[],"mappings":"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"}

package/dist/backend/entities/comparison-product.entity.d.ts

@@ -0,0 +1,22 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * ComparisonProduct — feature 007 / T012 / data-model.md §1.2.
+ *
+ * Ordered bridge between a Comparison and the Products it holds.
+ * Composite PK on (comparisonId, productId) — a given product appears at
+ * most once per comparison. `position` defines column order on the
+ * comparison page and PDF; gaps are tolerated when a product is removed
+ * mid-session.
+ *
+ * Both FKs cascade: removing a Product removes it from every Comparison
+ * that referenced it (no dangling rows, no orphaned columns); removing a
+ * Comparison removes its bridge rows.
+ */
+export declare class ComparisonProduct {
+    [OptionalProps]?: 'addedAt';
+    comparisonId: string;
+    productId: string;
+    position: number;
+    addedAt: Date;
+}
+//# sourceMappingURL=comparison-product.entity.d.ts.map

package/dist/backend/entities/comparison-product.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison-product.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/comparison-product.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAGrF;;;;;;;;;;;;GAYG;AACH,qBAEa,iBAAiB;IAC5B,CAAC,aAAa,CAAC,CAAC,EAAE,SAAS,CAAC;IAG5B,YAAY,EAAG,MAAM,CAAC;IAItB,SAAS,EAAG,MAAM,CAAC;IAGnB,QAAQ,EAAG,MAAM,CAAC;IAGlB,OAAO,EAAE,IAAI,CAAc;CAC5B"}

package/dist/backend/entities/comparison-product.entity.js

@@ -0,0 +1,54 @@
+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 } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+/**
+ * ComparisonProduct — feature 007 / T012 / data-model.md §1.2.
+ *
+ * Ordered bridge between a Comparison and the Products it holds.
+ * Composite PK on (comparisonId, productId) — a given product appears at
+ * most once per comparison. `position` defines column order on the
+ * comparison page and PDF; gaps are tolerated when a product is removed
+ * mid-session.
+ *
+ * Both FKs cascade: removing a Product removes it from every Comparison
+ * that referenced it (no dangling rows, no orphaned columns); removing a
+ * Comparison removes its bridge rows.
+ */
+let ComparisonProduct = class ComparisonProduct {
+    [OptionalProps];
+    comparisonId;
+    productId;
+    position;
+    addedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], ComparisonProduct.prototype, "comparisonId", void 0);
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    Index(),
+    __metadata("design:type", String)
+], ComparisonProduct.prototype, "productId", void 0);
+__decorate([
+    Property({ type: 'smallint' }),
+    __metadata("design:type", Number)
+], ComparisonProduct.prototype, "position", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], ComparisonProduct.prototype, "addedAt", void 0);
+ComparisonProduct = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'comparison_products' })
+], ComparisonProduct);
+export { ComparisonProduct };
+//# sourceMappingURL=comparison-product.entity.js.map

package/dist/backend/entities/comparison-product.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison-product.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/comparison-product.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE;;;;;;;;;;;;GAYG;AAGI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,CAAC,aAAa,CAAC,CAAa;IAG5B,YAAY,CAAU;IAItB,SAAS,CAAU;IAGnB,QAAQ,CAAU;IAGlB,OAAO,GAAS,IAAI,IAAI,EAAE,CAAC;CAC5B,CAAA;AAXC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;uDACP;AAItB;IAFC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC5B,KAAK,EAAE;;oDACW;AAGnB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;;mDACb;AAGlB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAClD,IAAI;kDAAc;AAdhB,iBAAiB;IAF7B,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC;GAChC,iBAAiB,CAe7B"}

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

@@ -0,0 +1,61 @@
+import { OptionalProps } from '@mikro-orm/core';
+export type ComparisonDisplayMode = 'all' | 'common' | 'differences';
+/**
+ * Comparison — feature 007 / T011 / data-model.md §1.1.
+ *
+ * A customer-owned set of product references with a chosen display mode,
+ * an owner (customer account or anonymous browser session), an associated
+ * sales channel, and a stable shareable URL token. Owner is *exclusively*
+ * one of the two — the DB CHECK constraint
+ * `comparisons_owner_xor_chk` enforces it; the service layer also
+ * validates before insert.
+ *
+ * `displayMode` persists across re-opens so the customer's chosen mode is
+ * remembered. The default `'all'` matches spec FR-008.
+ *
+ * State transitions: live → deleted (hard delete; `comparison_products`
+ * cascades). No soft-delete: spec FR-014 requires the share-token endpoint
+ * to resolve to a clear "no longer exists" state, which a missing row
+ * already satisfies.
+ */
+export declare class Comparison {
+    [OptionalProps]?: 'id' | 'createdAt' | 'updatedAt' | 'displayMode' | 'customerAccountId' | 'organizationId' | 'anonymousToken';
+    id: string;
+    shareToken: string;
+    /**
+     * Set when the owner is authenticated. Mutually exclusive with
+     * `anonymousToken` (DB CHECK + service-side guard).
+     */
+    customerAccountId?: string | null;
+    /**
+     * The organisation that owns this comparison — feature 087 Group B, ruling
+     * D-187.
+     *
+     * Derived from {@link customerAccountId}'s account and stamped at the write,
+     * never resolved on read: `customerOrganizationColumn` asks the ORM's own
+     * metadata whether this property exists, so its presence is what makes
+     * `customerFilterCond`'s `allowed-set` arm **grant** on this table rather
+     * than refuse it whole. A sales representative assigned to the buyer's
+     * organisation sees this row because this column is here.
+     *
+     * Nullable, and the constraint is an implication rather than an equivalence:
+     * `comparisons_organization_attribution_chk` requires an organisation of a
+     * row that names an account, and says nothing about a row that names none.
+     * An **anonymous** comparison is a representable state (FR-011) — this table
+     * enforces the owner XOR, so half of it is anonymous by construction — and
+     * who such a row belongs to is R-6's open question, which a constraint must
+     * not answer.
+     */
+    organizationId?: string | null;
+    /**
+     * Set when the owner is an anonymous browser session. Same encoding as
+     * `shareToken` (16 random bytes, base64url) but a separate value so a
+     * leaked anonymous-cookie token does not double as a public share link.
+     */
+    anonymousToken?: string | null;
+    salesChannelId: string;
+    displayMode: ComparisonDisplayMode;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=comparison.entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comparison.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/comparison.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAgC,MAAM,iBAAiB,CAAC;AAI7F,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,QAAQ,GAAG,aAAa,CAAC;AAErE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAEa,UAAU;IACrB,CAAC,aAAa,CAAC,CAAC,EACZ,IAAI,GACJ,WAAW,GACX,WAAW,GACX,aAAa,GACb,mBAAmB,GACnB,gBAAgB,GAChB,gBAAgB,CAAC;IAGrB,EAAE,EAAE,MAAM,CAAgB;IAI1B,UAAU,EAAG,MAAM,CAAC;IAEpB;;;OAGG;IAEH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;;;;;;;;;;;;;;;;;OAkBG;IAGH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;;;OAIG;IAEH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAI/B,cAAc,EAAG,MAAM,CAAC;IAGxB,WAAW,EAAE,qBAAqB,CAAS;IAG3C,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}