@endora-commerce/mod-comparisons 0.0.0-stage → 0.100.0

package/dist/backend/services/comparable-attribute-projection.js

@@ -0,0 +1,136 @@
+/**
+ * Pure projection from "products + comparable-attribute definitions" to
+ * the body rows of the comparison page (and PDF). Implements research.md
+ * R-6 algorithm.
+ *
+ * Inputs:
+ *   - `products` — the column-ordered list of products in the comparison.
+ *     Each product carries its `attributeValues` JSONB record (catalog
+ *     stores values keyed by attribute key).
+ *   - `attributeDefinitions` — every catalog attribute flagged
+ *     `is_comparable=true`, in display order. Order is preserved in the
+ *     output so the client / PDF both render rows top-to-bottom in the
+ *     same sequence.
+ *
+ * Output: one `ComparisonAttributeRow` per definition, with one entry
+ * per product (in column order) and the row's classification (`common`
+ * vs `different`). Pre-formatted strings ride on the wire so the
+ * storefront table doesn't have to re-format multi-value attributes.
+ *
+ * Equality semantics (R-6):
+ *   - `multiselect`           — set equality (full overlap), order-insensitive.
+ *   - `enum` / `string`       — `===` after `String(v).trim()`.
+ *   - `number` / `price`      — `===` after `Number(v)` (no tolerance).
+ *   - `boolean`               — `===`.
+ *   - `date`                  — `===` after ISO-8601 normalisation (parse → toISOString).
+ *   - missing value on either side — classified as `different`; cell is `null`.
+ *
+ * Pure: no DB, no HTTP, no I/O. Unit-testable in isolation.
+ */
+export class ComparableAttributeProjection {
+    projectRows(products, attributeDefinitions) {
+        return attributeDefinitions.map((def) => {
+            const rawValues = products.map((p) => p.attributeValues?.[def.key]);
+            const formatted = rawValues.map((v) => formatForDisplay(def.valueType, v));
+            const rowClass = classifyRow(def.valueType, rawValues);
+            return {
+                key: def.key,
+                label: def.label,
+                valueType: def.valueType,
+                values: formatted,
+                rowClass,
+            };
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers (file-private — exported for testing only).
+// ---------------------------------------------------------------------------
+/** Returns true when v should be treated as "no value". */
+function isMissing(v) {
+    if (v === null || v === undefined)
+        return true;
+    if (Array.isArray(v) && v.length === 0)
+        return true;
+    if (typeof v === 'string' && v.trim() === '')
+        return true;
+    return false;
+}
+/**
+ * Pre-format a raw `attributeValues[key]` for display. Returns null when
+ * the value is missing — the storefront / PDF render `—` for null cells.
+ */
+export function formatForDisplay(valueType, v) {
+    if (isMissing(v))
+        return null;
+    switch (valueType) {
+        case 'multiselect':
+            // Sorted for stable visual presentation across re-renders.
+            return Array.isArray(v) ? [...v].map(String).sort().join(', ') : String(v);
+        case 'date':
+            // Best-effort ISO normalisation; if the catalog value is already a
+            // valid date string, this is idempotent.
+            return normaliseDate(v);
+        case 'boolean':
+            return v ? 'true' : 'false';
+        case 'number':
+        case 'price':
+            return String(Number(v));
+        case 'enum':
+        case 'string':
+        default:
+            return String(v).trim();
+    }
+}
+/**
+ * Returns 'common' iff every product carries an equivalent value for the
+ * attribute (per R-6 equality semantics) AND no product is missing. Any
+ * other case is 'different'.
+ */
+export function classifyRow(valueType, rawValues) {
+    if (rawValues.length < 2) {
+        // 0 or 1 product: trivially "common" — no disagreement possible.
+        return 'common';
+    }
+    if (rawValues.some(isMissing))
+        return 'different';
+    const [head, ...rest] = rawValues;
+    for (const v of rest) {
+        if (!equalsForType(valueType, head, v))
+            return 'different';
+    }
+    return 'common';
+}
+function equalsForType(valueType, a, b) {
+    switch (valueType) {
+        case 'multiselect': {
+            const sa = Array.isArray(a) ? new Set(a.map(String)) : new Set([String(a)]);
+            const sb = Array.isArray(b) ? new Set(b.map(String)) : new Set([String(b)]);
+            if (sa.size !== sb.size)
+                return false;
+            for (const v of sa) {
+                if (!sb.has(v))
+                    return false;
+            }
+            return true;
+        }
+        case 'number':
+        case 'price':
+            return Number(a) === Number(b);
+        case 'boolean':
+            return Boolean(a) === Boolean(b);
+        case 'date':
+            return normaliseDate(a) === normaliseDate(b);
+        case 'enum':
+        case 'string':
+        default:
+            return String(a).trim() === String(b).trim();
+    }
+}
+function normaliseDate(v) {
+    if (v instanceof Date)
+        return v.toISOString();
+    const parsed = new Date(String(v));
+    return Number.isNaN(parsed.getTime()) ? String(v) : parsed.toISOString();
+}
+//# sourceMappingURL=comparable-attribute-projection.js.map

package/dist/backend/services/comparable-attribute-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparable-attribute-projection.js","sourceRoot":"","sources":["../../../src/backend/services/comparable-attribute-projection.ts"],"names":[],"mappings":"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"}

package/dist/backend/services/comparison-admin.service.d.ts

@@ -0,0 +1,31 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { ComparisonAdminDetail, ComparisonAdminListItem, ComparisonAdminListQuery, CustomerAccountReadPort } from '@endora-commerce/contracts';
+import { type ComparisonService } from './comparison-service.js';
+/**
+ * Read-only admin service for the comparisons module — feature 007 /
+ * US5 / T063. Reuses the storefront `ComparisonService.buildOwnerView`
+ * for the per-comparison projection, but joins owner/channel metadata
+ * the storefront does not need.
+ *
+ * No mutation methods (spec FR-022). When operational tooling demands
+ * a force-delete in the future, that is a separate spec.
+ *
+ * The owner column shows a customer's e-mail address, which is
+ * `customer_accounts`' row and not this module's. Feature 075 (Phase C)
+ * replaced the `em.find(CustomerAccount, …)` that used to fetch it with that
+ * module's read port, so an admin screen cannot report identities out of a
+ * module the operator has switched off.
+ */
+export declare class ComparisonAdminService {
+    private readonly emFactory;
+    private readonly comparisonService;
+    private readonly customerAccounts;
+    constructor(emFactory: () => EntityManager, comparisonService: ComparisonService, customerAccounts: CustomerAccountReadPort);
+    list(filters: ComparisonAdminListQuery): Promise<{
+        data: ComparisonAdminListItem[];
+        nextCursor: string | null;
+        limit: number;
+    }>;
+    detail(id: string): Promise<ComparisonAdminDetail>;
+}
+//# sourceMappingURL=comparison-admin.service.d.ts.map

package/dist/backend/services/comparison-admin.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison-admin.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/comparison-admin.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EAExB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAFhB,SAAS,EAAE,MAAM,aAAa,EAC9B,iBAAiB,EAAE,iBAAiB,EACpC,gBAAgB,EAAE,uBAAuB;IAOtD,IAAI,CACR,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC;QAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA2GnF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAgDzD"}

package/dist/backend/services/comparison-admin.service.js

@@ -0,0 +1,184 @@
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+import { Comparison } from '../entities/comparison.entity.js';
+import { ComparisonNotFoundError, } from './comparison-service.js';
+/**
+ * Read-only admin service for the comparisons module — feature 007 /
+ * US5 / T063. Reuses the storefront `ComparisonService.buildOwnerView`
+ * for the per-comparison projection, but joins owner/channel metadata
+ * the storefront does not need.
+ *
+ * No mutation methods (spec FR-022). When operational tooling demands
+ * a force-delete in the future, that is a separate spec.
+ *
+ * The owner column shows a customer's e-mail address, which is
+ * `customer_accounts`' row and not this module's. Feature 075 (Phase C)
+ * replaced the `em.find(CustomerAccount, …)` that used to fetch it with that
+ * module's read port, so an admin screen cannot report identities out of a
+ * module the operator has switched off.
+ */
+export class ComparisonAdminService {
+    emFactory;
+    comparisonService;
+    customerAccounts;
+    constructor(emFactory, comparisonService, customerAccounts) {
+        this.emFactory = emFactory;
+        this.comparisonService = comparisonService;
+        this.customerAccounts = customerAccounts;
+    }
+    // ------------------------------------------------------------------
+    // List
+    // ------------------------------------------------------------------
+    async list(filters) {
+        const em = this.emFactory();
+        const limit = Math.max(1, Math.min(100, filters.limit ?? 25));
+        const where = {};
+        if (filters.salesChannelId)
+            where['salesChannelId'] = filters.salesChannelId;
+        if (filters.customerAccountId)
+            where['customerAccountId'] = filters.customerAccountId;
+        if (filters.ownerType === 'customer') {
+            where['customerAccountId'] = { $ne: null };
+        }
+        else if (filters.ownerType === 'anonymous') {
+            where['anonymousToken'] = { $ne: null };
+        }
+        if (filters.createdAfter) {
+            where['createdAt'] = { $gte: new Date(filters.createdAfter) };
+        }
+        if (filters.createdBefore) {
+            where['createdAt'] = {
+                ...where['createdAt'],
+                $lt: new Date(filters.createdBefore),
+            };
+        }
+        // Cursor is a base64-encoded createdAt timestamp; rows BEFORE the
+        // cursor are returned in createdAt-desc order.
+        if (filters.cursor) {
+            try {
+                const cursorDate = new Date(Buffer.from(filters.cursor, 'base64url').toString('utf8'));
+                if (!Number.isNaN(cursorDate.getTime())) {
+                    where['createdAt'] = {
+                        ...where['createdAt'],
+                        $lt: cursorDate,
+                    };
+                }
+            }
+            catch {
+                // Malformed cursor — silently start from the top, same as omitting it.
+            }
+        }
+        // Fetch limit+1 to detect whether more pages remain.
+        const rows = await em.find(Comparison, where, {
+            orderBy: { createdAt: 'desc' },
+            limit: limit + 1,
+        });
+        const hasMore = rows.length > limit;
+        const page = rows.slice(0, limit);
+        // Resolve sales-channel + customer-email metadata for the page.
+        const channelIds = unique(page.map((c) => c.salesChannelId));
+        const customerIds = unique(page.map((c) => c.customerAccountId).filter((id) => Boolean(id)));
+        const [channels, customers] = await Promise.all([
+            channelIds.length > 0
+                ? em.find(SalesChannel, { id: { $in: channelIds } })
+                : Promise.resolve([]),
+            customerIds.length > 0
+                ? this.customerAccounts.findByIds(customerIds)
+                : Promise.resolve([]),
+        ]);
+        const channelById = new Map(channels.map((c) => [c.id, c]));
+        const customerById = new Map(customers.map((c) => [c.id, c]));
+        // Bridge product counts for the page in one query.
+        const counts = await em.getConnection().execute(page.length > 0
+            ? `select comparison_id, count(*)::int as n
+             from comparison_products
+             where comparison_id in (${page.map(() => '?').join(',')})
+             group by comparison_id`
+            : `select null as comparison_id, 0 as n where false`, page.map((c) => c.id));
+        const countById = new Map(counts.map((r) => [r.comparison_id, Number(r.n)]));
+        const data = page.map((c) => ({
+            id: c.id,
+            shareToken: c.shareToken,
+            owner: ownerMetadata(c, customerById),
+            salesChannel: {
+                id: c.salesChannelId,
+                code: channelById.get(c.salesChannelId)?.code ?? '(unknown)',
+            },
+            displayMode: c.displayMode,
+            productCount: countById.get(c.id) ?? 0,
+            createdAt: c.createdAt.toISOString(),
+            updatedAt: c.updatedAt.toISOString(),
+        }));
+        const nextCursor = hasMore
+            ? Buffer.from(page[page.length - 1].createdAt.toISOString(), 'utf8').toString('base64url')
+            : null;
+        return { data, nextCursor, limit };
+    }
+    // ------------------------------------------------------------------
+    // Detail
+    // ------------------------------------------------------------------
+    async detail(id) {
+        const em = this.emFactory();
+        const comparison = await em.findOne(Comparison, { id });
+        if (!comparison)
+            throw new ComparisonNotFoundError();
+        // The detail view renders prices in the comparison's recorded
+        // channel (the creator's), not the admin's preferred channel.
+        //
+        // And in that channel's **public** prices, not the owner's negotiated
+        // ones: the viewer decides the figures, the viewer here is an
+        // administrator, and an administrator has no buying organisation to
+        // resolve against. Handing this screen the owner's price lists would be a
+        // disclosure decision of its own rather than a consequence of this one, so
+        // the screen says which prices it is showing instead of assuming
+        // (`detail.pricesNote`).
+        //
+        // The `administrator` viewer is also what keeps every *row* on this screen.
+        // A storefront reader is filtered by `isProductVisibleTo`, and an admin
+        // given any audience would be filtered too — dropping exactly the
+        // organisation-restricted products this audit view exists to show.
+        const view = await this.comparisonService.buildOwnerView(comparison, comparison.salesChannelId, { kind: 'administrator' });
+        const channel = await em.findOne(SalesChannel, { id: comparison.salesChannelId });
+        const customer = comparison.customerAccountId
+            ? await this.customerAccounts.findById(comparison.customerAccountId)
+            : null;
+        const customerById = new Map(customer ? [[customer.id, customer]] : []);
+        return {
+            id: view.id,
+            shareToken: view.shareToken,
+            owner: ownerMetadata(comparison, customerById),
+            salesChannel: {
+                id: comparison.salesChannelId,
+                code: channel?.code ?? '(unknown)',
+            },
+            displayMode: view.displayMode,
+            products: view.products,
+            comparableAttributes: view.comparableAttributes,
+            createdAt: view.createdAt,
+            updatedAt: view.updatedAt,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// helpers
+// ---------------------------------------------------------------------------
+function unique(arr) {
+    return Array.from(new Set(arr));
+}
+function ownerMetadata(c, customerById) {
+    if (c.customerAccountId) {
+        const customer = customerById.get(c.customerAccountId);
+        return {
+            kind: 'customer',
+            customerAccountId: c.customerAccountId,
+            email: customer?.email ?? null,
+            anonymousToken: null,
+        };
+    }
+    return {
+        kind: 'anonymous',
+        customerAccountId: null,
+        email: null,
+        anonymousToken: c.anonymousToken ?? null,
+    };
+}
+//# sourceMappingURL=comparison-admin.service.js.map

package/dist/backend/services/comparison-admin.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison-admin.service.js","sourceRoot":"","sources":["../../../src/backend/services/comparison-admin.service.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EACL,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,sBAAsB;IAEd;IACA;IACA;IAHnB,YACmB,SAA8B,EAC9B,iBAAoC,EACpC,gBAAyC;QAFzC,cAAS,GAAT,SAAS,CAAqB;QAC9B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,qBAAgB,GAAhB,gBAAgB,CAAyB;IACzD,CAAC;IAEJ,qEAAqE;IACrE,OAAO;IACP,qEAAqE;IAErE,KAAK,CAAC,IAAI,CACR,OAAiC;QAEjC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QAE9D,MAAM,KAAK,GAA4B,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,cAAc;YAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7E,IAAI,OAAO,CAAC,iBAAiB;YAC3B,KAAK,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;QACzD,IAAI,OAAO,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YACrC,KAAK,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QAC7C,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC;YAC7C,KAAK,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAChE,CAAC;QACD,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,KAAK,CAAC,WAAW,CAAC,GAAG;gBACnB,GAAI,KAAK,CAAC,WAAW,CAAyC;gBAC9D,GAAG,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;aACrC,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,+CAA+C;QAC/C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,IAAI,CACzB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC1D,CAAC;gBACF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;oBACxC,KAAK,CAAC,WAAW,CAAC,GAAG;wBACnB,GAAI,KAAK,CAAC,WAAW,CAAyC;wBAC9D,GAAG,EAAE,UAAU;qBAChB,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,uEAAuE;YACzE,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE;YAC5C,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;YAC9B,KAAK,EAAE,KAAK,GAAG,CAAC;SACjB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAElC,gEAAgE;QAChE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;QAC7D,MAAM,WAAW,GAAG,MAAM,CACxB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAC/E,CAAC;QACF,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC9C,UAAU,CAAC,MAAM,GAAG,CAAC;gBACnB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC;gBACpD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,WAAW,CAAC,MAAM,GAAG,CAAC;gBACpB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,WAAW,CAAC;gBAC9C,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;SACxB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9D,mDAAmD;QACnD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,aAAa,EAAE,CAAC,OAAO,CAI7C,IAAI,CAAC,MAAM,GAAG,CAAC;YACb,CAAC,CAAC;;uCAE6B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;oCAChC;YAC5B,CAAC,CAAC,kDAAkD,EACtD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACtB,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAClD,CAAC;QAEF,MAAM,IAAI,GAA8B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvD,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,YAAY,CAAC;YACrC,YAAY,EAAE;gBACZ,EAAE,EAAE,CAAC,CAAC,cAAc;gBACpB,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,IAAI,WAAW;aAC7D;YACD,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,YAAY,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC;YACtC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;YACpC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;SACrC,CAAC,CAAC,CAAC;QAEJ,MAAM,UAAU,GAAG,OAAO;YACxB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC3F,CAAC,CAAC,IAAI,CAAC;QAET,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;IAED,qEAAqE;IACrE,SAAS;IACT,qEAAqE;IAErE,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,uBAAuB,EAAE,CAAC;QACrD,8DAA8D;QAC9D,8DAA8D;QAC9D,EAAE;QACF,sEAAsE;QACtE,8DAA8D;QAC9D,oEAAoE;QACpE,0EAA0E;QAC1E,2EAA2E;QAC3E,iEAAiE;QACjE,yBAAyB;QACzB,EAAE;QACF,4EAA4E;QAC5E,wEAAwE;QACxE,kEAAkE;QAClE,mEAAmE;QACnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,cAAc,CACtD,UAAU,EACV,UAAU,CAAC,cAAc,EACzB,EAAE,IAAI,EAAE,eAAe,EAAE,CAC1B,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,UAAU,CAAC,iBAAiB;YAC3C,CAAC,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,iBAAiB,CAAC;YACpE,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAC1C,CAAC;QAEF,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,KAAK,EAAE,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC;YAC9C,YAAY,EAAE;gBACZ,EAAE,EAAE,UAAU,CAAC,cAAc;gBAC7B,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,WAAW;aACnC;YACD,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,MAAM,CAAI,GAAQ;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,aAAa,CACpB,CAAa,EACb,YAAgD;IAEhD,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACvD,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;YACtC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,IAAI;YAC9B,cAAc,EAAE,IAAI;SACrB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,iBAAiB,EAAE,IAAI;QACvB,KAAK,EAAE,IAAI;QACX,cAAc,EAAE,CAAC,CAAC,cAAc,IAAI,IAAI;KACzC,CAAC;AACJ,CAAC"}

package/dist/backend/services/comparison-pdf-renderer.d.ts

@@ -0,0 +1,57 @@
+import type { TDocumentDefinitions } from 'pdfmake/interfaces.js';
+import type { ComparisonOwnerView, ComparisonAttributeRow, ComparisonDisplayMode } from '@endora-commerce/contracts';
+import { AssetByteFetcher } from './asset-byte-fetcher.js';
+/**
+ * `ComparisonPdfRenderer` — feature 007 / US4 / T055.
+ *
+ * Builds a `pdfmake` document definition from a `ComparisonOwnerView`
+ * and streams the resulting PDF into an in-memory Buffer that the
+ * route handler ships back to the customer.
+ *
+ * Layout invariants (per `contracts/public-comparisons-pdf.md` and
+ * spec FR-017–FR-020):
+ *
+ *   - Page 1 header: comparison title + active display-mode caption.
+ *   - Always-on row (table header): one cell per product, each with
+ *     base image (≤ 150×150), name, and price.
+ *   - Body rows: rows filtered by the active display mode, with the
+ *     `rowClass` styling propagated as a left-border colour.
+ *   - Page orientation: landscape when product count ≥ 3, portrait
+ *     otherwise (covers spec edge case "PDF on very wide
+ *     comparisons"). The `pickOrientation` export is unit-tested in
+ *     isolation.
+ *   - Image fallback: an unavailable base image is replaced with a
+ *     1×1 transparent placeholder bytes constant rather than failing
+ *     the export.
+ *
+ * The class wraps pdfmake behind a single seam so swapping the engine
+ * later (constitution amendment, etc.) touches one file.
+ */
+export declare class ComparisonPdfRenderer {
+    /**
+     * pdfmake's singleton is process-global, so we just register fonts on
+     * it once the first time a renderer is constructed and reuse the
+     * registered set on every subsequent render.
+     */
+    private static fontsRegistered;
+    constructor();
+    /**
+     * Render the supplied view to a PDF Buffer. Uses a fresh
+     * {@link AssetByteFetcher} per call so per-request caches do not
+     * leak across exports.
+     */
+    render(view: ComparisonOwnerView, opts?: {
+        fetcher?: AssetByteFetcher;
+    }): Promise<Buffer>;
+    /**
+     * Public for tests: returns the assembled document definition object
+     * (no PDF stream produced). Tests assert the right column count, row
+     * count, and orientation without binding to pdfmake's byte output.
+     */
+    buildDocumentDefinition(view: ComparisonOwnerView, fetcher: AssetByteFetcher): Promise<TDocumentDefinitions>;
+    private bufferiseDocument;
+}
+/** Spec edge case "PDF on very wide comparisons": ≥3 products → landscape. */
+export declare function pickOrientation(productCount: number): 'landscape' | 'portrait';
+export declare function filterRowsByMode(rows: ComparisonAttributeRow[], mode: ComparisonDisplayMode): ComparisonAttributeRow[];
+//# sourceMappingURL=comparison-pdf-renderer.d.ts.map

package/dist/backend/services/comparison-pdf-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison-pdf-renderer.d.ts","sourceRoot":"","sources":["../../../src/backend/services/comparison-pdf-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EAMrB,MAAM,uBAAuB,CAAC;AAkB/B,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EAEtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,qBAAqB;IAChC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe,CAAS;;IAevC;;;;OAIG;IACG,MAAM,CACV,IAAI,EAAE,mBAAmB,EACzB,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,gBAAgB,CAAA;KAAO,GACxC,OAAO,CAAC,MAAM,CAAC;IAMlB;;;;OAIG;IACG,uBAAuB,CAC3B,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,oBAAoB,CAAC;YA6DlB,iBAAiB;CAGhC;AAYD,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAE9E;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,sBAAsB,EAAE,EAC9B,IAAI,EAAE,qBAAqB,GAC1B,sBAAsB,EAAE,CAI1B"}

package/dist/backend/services/comparison-pdf-renderer.js

@@ -0,0 +1,211 @@
+import path from 'node:path';
+import { createRequire } from 'node:module';
+const requireFromHere = createRequire(import.meta.url);
+const pdfMake = requireFromHere('pdfmake');
+import { AssetByteFetcher } from './asset-byte-fetcher.js';
+/**
+ * `ComparisonPdfRenderer` — feature 007 / US4 / T055.
+ *
+ * Builds a `pdfmake` document definition from a `ComparisonOwnerView`
+ * and streams the resulting PDF into an in-memory Buffer that the
+ * route handler ships back to the customer.
+ *
+ * Layout invariants (per `contracts/public-comparisons-pdf.md` and
+ * spec FR-017–FR-020):
+ *
+ *   - Page 1 header: comparison title + active display-mode caption.
+ *   - Always-on row (table header): one cell per product, each with
+ *     base image (≤ 150×150), name, and price.
+ *   - Body rows: rows filtered by the active display mode, with the
+ *     `rowClass` styling propagated as a left-border colour.
+ *   - Page orientation: landscape when product count ≥ 3, portrait
+ *     otherwise (covers spec edge case "PDF on very wide
+ *     comparisons"). The `pickOrientation` export is unit-tested in
+ *     isolation.
+ *   - Image fallback: an unavailable base image is replaced with a
+ *     1×1 transparent placeholder bytes constant rather than failing
+ *     the export.
+ *
+ * The class wraps pdfmake behind a single seam so swapping the engine
+ * later (constitution amendment, etc.) touches one file.
+ */
+export class ComparisonPdfRenderer {
+    /**
+     * pdfmake's singleton is process-global, so we just register fonts on
+     * it once the first time a renderer is constructed and reuse the
+     * registered set on every subsequent render.
+     */
+    static fontsRegistered = false;
+    constructor() {
+        if (!ComparisonPdfRenderer.fontsRegistered) {
+            pdfMake.setFonts(buildFontDictionary());
+            // Refuse every URL pdfmake might want to fetch directly. Image
+            // bytes are pre-fetched by `AssetByteFetcher` and embedded as
+            // data URIs, so there is never a legitimate need for pdfmake to
+            // open a network socket — a strict deny-all also silences the
+            // package's "No URL access policy defined" startup warning.
+            pdfMake.setUrlAccessPolicy(() => false);
+            ComparisonPdfRenderer.fontsRegistered = true;
+        }
+    }
+    /**
+     * Render the supplied view to a PDF Buffer. Uses a fresh
+     * {@link AssetByteFetcher} per call so per-request caches do not
+     * leak across exports.
+     */
+    async render(view, opts = {}) {
+        const fetcher = opts.fetcher ?? new AssetByteFetcher();
+        const def = await this.buildDocumentDefinition(view, fetcher);
+        return this.bufferiseDocument(def);
+    }
+    /**
+     * Public for tests: returns the assembled document definition object
+     * (no PDF stream produced). Tests assert the right column count, row
+     * count, and orientation without binding to pdfmake's byte output.
+     */
+    async buildDocumentDefinition(view, fetcher) {
+        const visibleRows = filterRowsByMode(view.comparableAttributes, view.displayMode);
+        const productImages = await Promise.all(view.products.map(async (p) => {
+            if (!p.primaryAssetUrl)
+                return null;
+            const bytes = await fetcher.fetch(p.primaryAssetUrl);
+            return imageDataUri(bytes);
+        }));
+        const headerRow = buildHeaderRow(view.products, productImages);
+        const bodyRows = visibleRows.map((row) => buildBodyRow(row));
+        const tableBody = [headerRow, ...bodyRows];
+        const columnWidths = ['*', ...view.products.map(() => '*')];
+        const orientation = pickOrientation(view.products.length);
+        const info = {
+            title: 'Product comparison',
+            creator: 'B2B Platform',
+            producer: 'pdfmake',
+        };
+        return {
+            info,
+            pageSize: 'A4',
+            pageOrientation: orientation,
+            pageMargins: [32, 40, 32, 40],
+            defaultStyle: { fontSize: 10, font: 'Roboto' },
+            content: [
+                {
+                    text: 'Product comparison',
+                    style: 'h1',
+                },
+                {
+                    text: `Mode: ${MODE_LABELS[view.displayMode]}`,
+                    style: 'caption',
+                    margin: [0, 0, 0, 12],
+                },
+                {
+                    table: {
+                        headerRows: 1,
+                        widths: columnWidths,
+                        body: tableBody,
+                    },
+                    layout: COMPARE_TABLE_LAYOUT,
+                },
+            ],
+            styles: {
+                h1: { fontSize: 16, bold: true, margin: [0, 0, 0, 4] },
+                caption: { fontSize: 10, italics: true, color: '#555' },
+                productName: { fontSize: 11, bold: true },
+                productPrice: { fontSize: 10, color: '#333' },
+                attrLabel: { fontSize: 10, bold: true },
+                attrValue: { fontSize: 10 },
+                common: { color: '#155724' },
+                different: { color: '#721c24' },
+            },
+        };
+    }
+    async bufferiseDocument(def) {
+        return pdfMake.createPdf(def).getBuffer();
+    }
+}
+// ---------------------------------------------------------------------------
+// Pure helpers — exported for unit testing.
+// ---------------------------------------------------------------------------
+const MODE_LABELS = {
+    all: 'All attributes',
+    common: 'Common attributes only',
+    differences: 'Differences only',
+};
+/** Spec edge case "PDF on very wide comparisons": ≥3 products → landscape. */
+export function pickOrientation(productCount) {
+    return productCount >= 3 ? 'landscape' : 'portrait';
+}
+export function filterRowsByMode(rows, mode) {
+    if (mode === 'all')
+        return rows;
+    if (mode === 'common')
+        return rows.filter((r) => r.rowClass === 'common');
+    return rows.filter((r) => r.rowClass === 'different');
+}
+function buildHeaderRow(products, images) {
+    const head = { text: '', style: 'attrLabel' };
+    const cells = products.map((p, idx) => {
+        const stack = [];
+        const dataUri = images[idx];
+        if (dataUri) {
+            stack.push({ image: dataUri, fit: [120, 120], alignment: 'center' });
+        }
+        stack.push({ text: localised(p.name), style: 'productName', alignment: 'center' });
+        stack.push({
+            text: p.price ? `${p.price.amount} ${p.price.currency}` : '—',
+            style: 'productPrice',
+            alignment: 'center',
+        });
+        return { stack };
+    });
+    return [head, ...cells];
+}
+function buildBodyRow(row) {
+    const labelCell = {
+        text: localised(row.label),
+        style: ['attrLabel', row.rowClass],
+    };
+    const cells = row.values.map((v) => ({
+        text: v ?? '—',
+        style: ['attrValue', row.rowClass],
+    }));
+    return [labelCell, ...cells];
+}
+function localised(value) {
+    return value['en-US'] ?? value['en'] ?? Object.values(value)[0] ?? '';
+}
+function imageDataUri(bytes) {
+    // pdfmake recognises PNG and JPEG bytes by header. We pass it as a data
+    // URI so it is treated as inline image regardless of source URL.
+    return `data:image/png;base64,${bytes.toString('base64')}`;
+}
+/**
+ * Resolves the bundled Roboto font set that ships with `pdfmake` so we
+ * do not depend on a separate font-asset pipeline for the renderer.
+ */
+function buildFontDictionary() {
+    // pdfmake/.../fonts/Roboto/* — the path is stable across the package's
+    // releases. Use `requireFromHere` (createRequire-wrapped) because the
+    // backend runs as an ES module and bare `require` is not defined in
+    // that scope.
+    const fontsDir = requireFromHere.resolve('pdfmake/package.json').replace(/package\.json$/, `fonts${path.sep}Roboto${path.sep}`);
+    return {
+        Roboto: {
+            normal: `${fontsDir}Roboto-Regular.ttf`,
+            bold: `${fontsDir}Roboto-Medium.ttf`,
+            italics: `${fontsDir}Roboto-Italic.ttf`,
+            bolditalics: `${fontsDir}Roboto-MediumItalic.ttf`,
+        },
+    };
+}
+/** Subtle row-separator borders + soft fill on common rows. */
+const COMPARE_TABLE_LAYOUT = {
+    hLineWidth: (i) => (i === 0 || i === 1 ? 1 : 0.5),
+    vLineWidth: () => 0.5,
+    hLineColor: () => '#ccc',
+    vLineColor: () => '#ccc',
+    paddingTop: () => 6,
+    paddingBottom: () => 6,
+    paddingLeft: () => 8,
+    paddingRight: () => 8,
+};
+//# sourceMappingURL=comparison-pdf-renderer.js.map