@endora-commerce/mod-catalog 0.100.0

package/dist/backend/services/catalog-category-read.service.js

@@ -0,0 +1,248 @@
+import { Category } from '../entities/category.entity.js';
+/**
+ * The category read model `catalog` publishes (feature 075, Phase P).
+ *
+ * Fourteen inbound sites read the `Category` entity: the inventory threshold
+ * resolver, `price_lists` walking the ancestor chain, `product_feeds` mapping
+ * the tree onto an external taxonomy, `seo` rendering a category page.
+ *
+ * `ancestorsOf` is the one method that is not a transcription of an existing
+ * call. `price_lists` walks the parent pointer with a `findOne` per level —
+ * a loop whose depth is data, in a module that does not own the table. Moving
+ * it here bounds it: the write path forbids a cycle, but a corrupt
+ * `parent_id` should degrade into a short answer rather than hang a request.
+ */
+const MAX_ANCESTOR_DEPTH = 64;
+export class CatalogCategoryReadService {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    async findById(id, options) {
+        const category = await this.emFactory().findOne(Category, {
+            id,
+            ...liveFilter(options),
+        });
+        return category ? toCatalogCategoryRecord(category) : null;
+    }
+    async findByIds(ids, options) {
+        if (ids.length === 0)
+            return [];
+        const categories = await this.emFactory().find(Category, {
+            id: { $in: [...ids] },
+            ...liveFilter(options),
+        });
+        return categories.map(toCatalogCategoryRecord);
+    }
+    async findBySlug(slug) {
+        const category = await this.emFactory().findOne(Category, { slug });
+        return category ? toCatalogCategoryRecord(category) : null;
+    }
+    async countByIds(ids) {
+        if (ids.length === 0)
+            return 0;
+        return this.emFactory().count(Category, { id: { $in: [...ids] } });
+    }
+    async listAll(options) {
+        const categories = await this.emFactory().find(Category, liveFilter(options), { orderBy: { sortOrder: 'asc', slug: 'asc' } });
+        return categories.map(toCatalogCategoryRecord);
+    }
+    async listWithInventoryThresholds() {
+        const categories = await this.emFactory().find(Category, {
+            $or: [
+                { inventoryThresholdHigh: { $ne: null } },
+                { inventoryThresholdMedium: { $ne: null } },
+                { inventoryThresholdLow: { $ne: null } },
+            ],
+        });
+        return categories.map(toCatalogCategoryRecord);
+    }
+    async ancestorsOf(categoryId) {
+        const em = this.emFactory();
+        const chain = [];
+        const seen = new Set();
+        let cursorId = categoryId;
+        while (cursorId !== null && chain.length < MAX_ANCESTOR_DEPTH && !seen.has(cursorId)) {
+            seen.add(cursorId);
+            const cursor = await em.findOne(Category, { id: cursorId });
+            if (!cursor)
+                break;
+            chain.push(toCatalogCategoryRecord(cursor));
+            cursorId = cursor.parentCategoryId ?? null;
+        }
+        return chain;
+    }
+    /**
+     * Feature 075 / D-87 — the `product_categories` bridge, which has no entity
+     * class and was therefore joined in raw SQL by whoever needed it. `search`
+     * ran this statement three times from inside its indexer.
+     *
+     * `em.execute` rather than `getConnection().execute`: the two are the same
+     * outside a transaction and only the first joins one when the caller has it
+     * open (issue #200).
+     */
+    async listAssignmentsForProducts(productIds, options) {
+        if (productIds.length === 0)
+            return [];
+        const placeholders = productIds.map(() => '?').join(',');
+        const activeFilter = options?.activeOnly === true ? ' and c.is_active = true' : '';
+        const rows = await this.emFactory().execute(`select pc.product_id, pc.category_id, c.slug
+         from product_categories pc
+         join categories c on c.id = pc.category_id
+        where pc.product_id in (${placeholders})${activeFilter}`, [...productIds]);
+        return rows.map((row) => ({
+            productId: row.product_id,
+            categoryId: row.category_id,
+            slug: row.slug,
+        }));
+    }
+    /**
+     * One recursive query rather than a query per level: a subtree re-projection
+     * runs on every category write, and the depth of the tree is data.
+     *
+     * No `is_active` / `deleted_at` filter anywhere in the walk — see the port's
+     * contract. The caller re-projects *because* a category changed, and a
+     * deactivation is the change that matters most.
+     */
+    async listProductIdsInSubtree(categoryId) {
+        const rows = await this.emFactory().execute(`with recursive subtree as (
+           select id from categories where id = ?
+            union all
+           select c.id from categories c join subtree s on c.parent_category_id = s.id
+         )
+         select distinct pc.product_id
+           from product_categories pc
+           join subtree s on s.id = pc.category_id`, [categoryId]);
+        return rows.map((row) => row.product_id);
+    }
+    /**
+     * The selection walk — see the port's contract for why it is not a batched
+     * {@link listProductIdsInSubtree}. It skips soft-deleted categories and it
+     * tolerates a cycle; the structural read above does neither, deliberately.
+     *
+     * It was `CatalogQueryService.expandCategoryProductIds` until
+     * `specs/110-instance-repository/` T118c, reached by both composition roots
+     * over the unpublished `catalogQueryPort` name and by nothing else. It is a
+     * category read, so it belongs to the category read model; there is one copy.
+     */
+    async expandCategoryProductIds(categoryIds) {
+        const result = new Map();
+        if (categoryIds.length === 0)
+            return result;
+        const em = this.emFactory();
+        const requested = [...new Set(categoryIds)];
+        // Descendant ids per requested root (BFS, one query per level for the
+        // whole batch — the tree is shallow and this keeps the round trips flat).
+        const descendants = new Map();
+        for (const id of requested)
+            descendants.set(id, [id]);
+        // Visited set per root. Re-parenting is guarded against cycles
+        // (`category-admin.service.ts`), but that guard itself is written to
+        // tolerate *pre-existing* cycles in the data, so a corrupted
+        // `parent_category_id` chain is reachable here. Without this the loop
+        // never terminates: it would re-query the same level forever and grow
+        // `descendants` without bound.
+        const seen = new Map(requested.map((id) => [id, new Set([id])]));
+        let frontier = new Map(requested.map((id) => [id, [id]]));
+        while (frontier.size > 0) {
+            const parentIds = [...new Set([...frontier.values()].flat())];
+            const children = await em.find(Category, {
+                parentCategoryId: { $in: parentIds },
+                deletedAt: null,
+            });
+            if (children.length === 0)
+                break;
+            const childrenByParent = new Map();
+            for (const child of children) {
+                const parent = String(child.parentCategoryId);
+                childrenByParent.set(parent, [...(childrenByParent.get(parent) ?? []), child.id]);
+            }
+            const next = new Map();
+            for (const [root, level] of frontier) {
+                const visited = seen.get(root) ?? new Set();
+                const nextLevel = level
+                    .flatMap((id) => childrenByParent.get(id) ?? [])
+                    .filter((id) => !visited.has(id));
+                if (nextLevel.length === 0)
+                    continue;
+                for (const id of nextLevel)
+                    visited.add(id);
+                seen.set(root, visited);
+                descendants.set(root, [...(descendants.get(root) ?? []), ...nextLevel]);
+                next.set(root, nextLevel);
+            }
+            frontier = next;
+        }
+        const allIds = [...new Set([...descendants.values()].flat())];
+        const rows = await em.execute(`select category_id, product_id from product_categories
+        where category_id in (${allIds.map(() => '?').join(',')})`, allIds);
+        const productsByCategory = new Map();
+        for (const row of rows) {
+            productsByCategory.set(row.category_id, [
+                ...(productsByCategory.get(row.category_id) ?? []),
+                row.product_id,
+            ]);
+        }
+        for (const id of requested) {
+            const set = new Set();
+            for (const categoryId of descendants.get(id) ?? []) {
+                for (const productId of productsByCategory.get(categoryId) ?? [])
+                    set.add(productId);
+            }
+            result.set(id, set);
+        }
+        return result;
+    }
+    /**
+     * The one category, not its subtree — see the port's contract for why the two
+     * are separate methods. `pim_ergonode` wrote this statement itself before the
+     * port had it, to detach the products of a category the source tree dropped.
+     */
+    async listProductIdsInCategory(categoryId) {
+        const rows = await this.emFactory().execute('select distinct pc.product_id from product_categories pc where pc.category_id = ?', [categoryId]);
+        return rows.map((row) => row.product_id);
+    }
+    /**
+     * One grouped query rather than a count per id: the caller renders a source
+     * hierarchy of a few hundred bound categories on one screen, so a count per
+     * row would be a few hundred round trips every time it loads.
+     */
+    async countLiveProductsByCategory(categoryIds) {
+        if (categoryIds.length === 0)
+            return [];
+        const placeholders = categoryIds.map(() => '?').join(',');
+        const rows = await this.emFactory().execute(`select pc.category_id, count(*)::int as product_count
+         from product_categories pc
+         join products p on p.id = pc.product_id and p.deleted_at is null
+        where pc.category_id in (${placeholders})
+        group by pc.category_id`, [...categoryIds]);
+        return rows.map((row) => ({
+            categoryId: row.category_id,
+            productCount: Number(row.product_count),
+        }));
+    }
+}
+function liveFilter(options) {
+    return options?.liveOnly ? { deletedAt: null } : {};
+}
+export function toCatalogCategoryRecord(category) {
+    return {
+        id: category.id,
+        parentCategoryId: category.parentCategoryId ?? null,
+        name: category.name,
+        slug: category.slug,
+        sortOrder: category.sortOrder,
+        metaTitleOverride: category.metaTitleOverride ?? null,
+        metaDescriptionOverride: category.metaDescriptionOverride ?? null,
+        customFieldValues: category.customFieldValues ?? {},
+        isActive: category.isActive,
+        inventoryThresholdHigh: category.inventoryThresholdHigh ?? null,
+        inventoryThresholdMedium: category.inventoryThresholdMedium ?? null,
+        inventoryThresholdLow: category.inventoryThresholdLow ?? null,
+        mainImageAssetId: category.mainImageAssetId ?? null,
+        createdAt: category.createdAt,
+        updatedAt: category.updatedAt,
+        deletedAt: category.deletedAt ?? null,
+    };
+}
+//# sourceMappingURL=catalog-category-read.service.js.map

package/dist/backend/services/catalog-category-read.service.js.map

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

package/dist/backend/services/catalog-org-price-decorator.d.ts

@@ -0,0 +1,90 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CatalogBulkPriceLine, OrgLinePricePort, OrganizationDetailsPort, ProductAvailability, ProductDetail, ProductSummary } from '@endora-commerce/contracts';
+import type { SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
+/**
+ * Feature 062 (research §R7) — pricing/availability decoration for the
+ * external catalog namespace (`/api/v1/external/catalog/*`).
+ *
+ * Thin decoration ONLY: query logic stays in `CatalogQueryService`, price
+ * resolution stays in `PricingService` (the exact resolver cart pricing
+ * uses — SC-001 parity by construction). This service:
+ *
+ *  - for BOUND keys, replaces the summary/detail `price` with the bound
+ *    Organization's effective unit price at quantity 1, sets the
+ *    `priceUnavailable` marker, and (detail only) derives the org's
+ *    quantity-bracket `priceTiers` ladder by probing the resolver at each
+ *    bracket start quantity;
+ *  - for ANY key, attaches the channel-public `availability` indication via
+ *    the injected inventory port;
+ *  - answers the bound-only bulk `(sku, quantity)` pricing request with
+ *    per-line results (misses are data, not errors).
+ */
+/** The request's resolved sales channel — only `id` + `defaultCurrency` are read. */
+export interface ExternalPricingChannel {
+    id: string;
+    defaultCurrency: string;
+}
+export type ResolveAvailabilityPort = (productIds: string[], salesChannelId: string) => Promise<Map<string, ProductAvailability>>;
+export interface CatalogOrgPriceDecoratorDeps {
+    emFactory: () => EntityManager;
+    /**
+     * Feature 075 — the published line-pricing port, where
+     * `price_lists`' `PricingServiceContract` used to be. This decorator calls
+     * two of its methods. `OrgLinePricePort` — `LinePricePort` plus the bracket
+     * ladder — was published in this cut, because `PricingServiceContract` is
+     * deliberately not in `@endora-commerce/contracts` (it is the overlay decoration's
+     * contract gate) and was `listBracketMinQuantities`' only declaration.
+     */
+    pricingService: OrgLinePricePort;
+    /**
+     * Feature 075 — the buying organisation, read through `organizations`' port
+     * instead of `em.findOne(Organization, …)` against its table. The engine
+     * reads two fields off it (the id, and the customer group a rule keys on),
+     * and `OrganizationRecord` carries both.
+     */
+    organizations: OrganizationDetailsPort;
+    /** Optional inventory port — when absent, `availability` is omitted. */
+    resolveAvailability?: ResolveAvailabilityPort;
+    /**
+     * Issue #185 — the kernel's channel-membership accessor. The published
+     * assortment check below asked `sales_channel_products` directly, which is
+     * the bridge Constitution XII reserves to this service and a cross-module
+     * read no import specifier could reveal.
+     */
+    channelMembership: SalesChannelMembershipPort;
+}
+export declare class CatalogOrgPriceDecorator {
+    #private;
+    private readonly deps;
+    constructor(deps: CatalogOrgPriceDecoratorDeps);
+    /**
+     * Decorates list summaries in place-order: availability for every caller,
+     * org-effective qty-1 price + `priceUnavailable` for bound callers.
+     */
+    decorateSummaries(summaries: ProductSummary[], context: {
+        organizationId: string | null;
+        salesChannel: ExternalPricingChannel;
+    }): Promise<ProductSummary[]>;
+    /**
+     * Detail decoration = summary decoration + (bound only) the org's resolved
+     * bracket ladder.
+     */
+    decorateDetail(detail: ProductDetail, context: {
+        organizationId: string | null;
+        salesChannel: ExternalPricingChannel;
+    }): Promise<ProductDetail>;
+    /**
+     * Bound-only bulk pricing: per-line, order-preserving. A SKU outside the
+     * bound channel's published assortment (or unknown / inactive / deleted)
+     * is indistinguishable from non-existence (`sku_not_in_assortment`); an
+     * in-assortment SKU with no resolvable bracket is `price_unavailable`.
+     */
+    resolveBulkPrices(lines: Array<{
+        sku: string;
+        quantity: number;
+    }>, context: {
+        organizationId: string;
+        salesChannel: ExternalPricingChannel;
+    }): Promise<CatalogBulkPriceLine[]>;
+}
+//# sourceMappingURL=catalog-org-price-decorator.d.ts.map

package/dist/backend/services/catalog-org-price-decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-org-price-decorator.d.ts","sourceRoot":"","sources":["../../../src/backend/services/catalog-org-price-decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EAEvB,mBAAmB,EACnB,aAAa,EAEb,cAAc,EACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAInF;;;;;;;;;;;;;;;;;GAiBG;AAEH,qFAAqF;AACrF,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,UAAU,EAAE,MAAM,EAAE,EACpB,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAE/C,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B;;;;;;;OAOG;IACH,cAAc,EAAE,gBAAgB,CAAC;IACjC;;;;;OAKG;IACH,aAAa,EAAE,uBAAuB,CAAC;IACvC,wEAAwE;IACxE,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;IAC9C;;;;;OAKG;IACH,iBAAiB,EAAE,0BAA0B,CAAC;CAC/C;AAED,qBAAa,wBAAwB;;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,4BAA4B;IAE/D;;;OAGG;IACG,iBAAiB,CACrB,SAAS,EAAE,cAAc,EAAE,EAC3B,OAAO,EAAE;QAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,YAAY,EAAE,sBAAsB,CAAA;KAAE,GAC/E,OAAO,CAAC,cAAc,EAAE,CAAC;IA4C5B;;;OAGG;IACG,cAAc,CAClB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE;QAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,YAAY,EAAE,sBAAsB,CAAA;KAAE,GAC/E,OAAO,CAAC,aAAa,CAAC;IAazB;;;;;OAKG;IACG,iBAAiB,CACrB,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EAC/C,OAAO,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,sBAAsB,CAAA;KAAE,GACxE,OAAO,CAAC,oBAAoB,EAAE,CAAC;CA8InC"}

package/dist/backend/services/catalog-org-price-decorator.js

@@ -0,0 +1,184 @@
+import { Product } from '../entities/product.entity.js';
+export class CatalogOrgPriceDecorator {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Decorates list summaries in place-order: availability for every caller,
+     * org-effective qty-1 price + `priceUnavailable` for bound callers.
+     */
+    async decorateSummaries(summaries, context) {
+        if (summaries.length === 0)
+            return summaries;
+        const availabilityByProduct = await this.#resolveAvailability(summaries.map((s) => s.id), context.salesChannel.id);
+        if (context.organizationId === null) {
+            return summaries.map((summary) => this.#withAvailability(summary, availabilityByProduct));
+        }
+        const em = this.deps.emFactory();
+        const organization = await this.deps.organizations.findById(context.organizationId);
+        const products = await em.find(Product, { id: { $in: summaries.map((s) => s.id) } });
+        const productById = new Map(products.map((p) => [p.id, p]));
+        const out = [];
+        for (const summary of summaries) {
+            const decorated = this.#withAvailability(summary, availabilityByProduct);
+            const product = productById.get(summary.id);
+            if (!product) {
+                out.push({ ...decorated, price: null, priceUnavailable: true });
+                continue;
+            }
+            const resolved = await this.deps.pricingService.resolveLinePrice({
+                product,
+                context: {
+                    quantity: 1,
+                    organization,
+                    salesChannel: context.salesChannel,
+                },
+            });
+            out.push(resolved
+                ? {
+                    ...decorated,
+                    price: { amount: Number(resolved.amount), currency: resolved.currency },
+                }
+                : { ...decorated, price: null, priceUnavailable: true });
+        }
+        return out;
+    }
+    /**
+     * Detail decoration = summary decoration + (bound only) the org's resolved
+     * bracket ladder.
+     */
+    async decorateDetail(detail, context) {
+        const [decorated] = await this.decorateSummaries([detail], context);
+        const merged = { ...detail, ...decorated };
+        if (context.organizationId === null)
+            return merged;
+        const em = this.deps.emFactory();
+        const organization = await this.deps.organizations.findById(context.organizationId);
+        const product = await em.findOne(Product, { id: detail.id });
+        if (!product)
+            return merged;
+        const priceTiers = await this.#resolvePriceTiers(product, organization, context.salesChannel);
+        return { ...merged, priceTiers };
+    }
+    /**
+     * Bound-only bulk pricing: per-line, order-preserving. A SKU outside the
+     * bound channel's published assortment (or unknown / inactive / deleted)
+     * is indistinguishable from non-existence (`sku_not_in_assortment`); an
+     * in-assortment SKU with no resolvable bracket is `price_unavailable`.
+     */
+    async resolveBulkPrices(lines, context) {
+        const em = this.deps.emFactory();
+        const organization = await this.deps.organizations.findById(context.organizationId);
+        const skus = Array.from(new Set(lines.map((l) => l.sku)));
+        const products = await em.find(Product, {
+            sku: { $in: skus },
+            deletedAt: null,
+            status: 'active',
+        });
+        const productBySku = new Map(products.map((p) => [p.sku, p]));
+        const assortment = await this.#filterByChannel(products.map((p) => p.id), context.salesChannel.id);
+        const out = [];
+        for (const line of lines) {
+            const product = productBySku.get(line.sku);
+            if (!product || !assortment.has(product.id)) {
+                out.push({
+                    sku: line.sku,
+                    quantity: line.quantity,
+                    price: null,
+                    reason: 'sku_not_in_assortment',
+                });
+                continue;
+            }
+            const resolved = await this.deps.pricingService.resolveLinePrice({
+                product,
+                context: {
+                    quantity: line.quantity,
+                    organization,
+                    salesChannel: context.salesChannel,
+                },
+            });
+            if (!resolved) {
+                out.push({
+                    sku: line.sku,
+                    quantity: line.quantity,
+                    price: null,
+                    reason: 'price_unavailable',
+                });
+                continue;
+            }
+            out.push({
+                sku: line.sku,
+                quantity: line.quantity,
+                price: {
+                    amount: resolved.amount,
+                    currency: resolved.currency,
+                    isSale: resolved.isSale,
+                    bracketStartQuantity: resolved.bracketStartQuantity,
+                    priceListId: resolved.priceListId,
+                },
+            });
+        }
+        return out;
+    }
+    /**
+     * The org's effective ladder: probe the resolver at every bracket start
+     * quantity known for the (product, currency) across active lists, then
+     * drop consecutive rungs that resolve identically (a non-matching list's
+     * boundary changes nothing for this org — no cross-org leak).
+     */
+    async #resolvePriceTiers(product, organization, salesChannel) {
+        const currencyCode = salesChannel.defaultCurrency.toUpperCase();
+        const minQuantities = await this.deps.pricingService.listBracketMinQuantities(product.id, currencyCode);
+        const probeQuantities = Array.from(new Set([1, ...minQuantities])).sort((a, b) => a - b);
+        const tiers = [];
+        for (const quantity of probeQuantities) {
+            const resolved = await this.deps.pricingService.resolveLinePrice({
+                product,
+                context: { quantity, organization, salesChannel },
+            });
+            if (!resolved)
+                continue;
+            const tier = {
+                minQuantity: quantity,
+                amount: Number(resolved.amount),
+                currency: resolved.currency,
+                isSale: resolved.isSale,
+            };
+            const previous = tiers[tiers.length - 1];
+            if (previous && previous.amount === tier.amount && previous.isSale === tier.isSale) {
+                continue;
+            }
+            tiers.push(tier);
+        }
+        return tiers;
+    }
+    async #resolveAvailability(productIds, salesChannelId) {
+        // D-61 — no `catch` here. `inventory` being absent is *decided* by the
+        // contribution, in front of the gate, and arrives as the empty map this
+        // method already returns when nothing is wired; the manifest declares that
+        // degrade as `degrades-without`. What a `catch` would add is the ability to
+        // turn a genuine inventory failure into a silently unpriced band.
+        if (!this.deps.resolveAvailability)
+            return new Map();
+        return this.deps.resolveAvailability(productIds, salesChannelId);
+    }
+    #withAvailability(summary, availabilityByProduct) {
+        const availability = availabilityByProduct.get(summary.id);
+        return availability ? { ...summary, availability } : summary;
+    }
+    /**
+     * Published-assortment check — the same question
+     * `CatalogQueryService.filterByChannel` asks, through the same accessor since
+     * issue #185. This was a hand-written `select product_id from
+     * sales_channel_products`, which is precisely the read Principle XII reserves
+     * to the channel-membership service; it fails closed to the empty set either
+     * way.
+     */
+    async #filterByChannel(productIds, salesChannelId) {
+        if (productIds.length === 0)
+            return new Set();
+        return new Set(await this.deps.channelMembership.filterEntityIdsInChannel(salesChannelId, 'product', productIds));
+    }
+}
+//# sourceMappingURL=catalog-org-price-decorator.js.map

package/dist/backend/services/catalog-org-price-decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-org-price-decorator.js","sourceRoot":"","sources":["../../../src/backend/services/catalog-org-price-decorator.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AA8DxD,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,IAAkC;QAAlC,SAAI,GAAJ,IAAI,CAA8B;IAAG,CAAC;IAEnE;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CACrB,SAA2B,EAC3B,OAAgF;QAEhF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC7C,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAC3D,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAC1B,OAAO,CAAC,YAAY,CAAC,EAAE,CACxB,CAAC;QAEF,IAAI,OAAO,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACpC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC;QAC5F,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACpF,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACrF,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;QAE5D,MAAM,GAAG,GAAqB,EAAE,CAAC;QACjC,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;YACzE,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChE,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC;gBAC/D,OAAO;gBACP,OAAO,EAAE;oBACP,QAAQ,EAAE,CAAC;oBACX,YAAY;oBACZ,YAAY,EAAE,OAAO,CAAC,YAAY;iBACnC;aACF,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CACN,QAAQ;gBACN,CAAC,CAAC;oBACE,GAAG,SAAS;oBACZ,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;iBACxE;gBACH,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAClB,MAAqB,EACrB,OAAgF;QAEhF,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,EAAmB,CAAC;QAC5D,IAAI,OAAO,CAAC,cAAc,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAEnD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACpF,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC;QAC5B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAC9F,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CACrB,KAA+C,EAC/C,OAAyE;QAEzE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAEpF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE;YACtC,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;YAClB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC5C,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACzB,OAAO,CAAC,YAAY,CAAC,EAAE,CACxB,CAAC;QAEF,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5C,GAAG,CAAC,IAAI,CAAC;oBACP,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,KAAK,EAAE,IAAI;oBACX,MAAM,EAAE,uBAAuB;iBAChC,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC;gBAC/D,OAAO;gBACP,OAAO,EAAE;oBACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,YAAY;oBACZ,YAAY,EAAE,OAAO,CAAC,YAAY;iBACnC;aACF,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,GAAG,CAAC,IAAI,CAAC;oBACP,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,KAAK,EAAE,IAAI;oBACX,MAAM,EAAE,mBAAmB;iBAC5B,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,GAAG,CAAC,IAAI,CAAC;gBACP,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE;oBACL,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;oBACnD,WAAW,EAAE,QAAQ,CAAC,WAAW;iBAClC;aACF,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,kBAAkB,CACtB,OAAgB,EAChB,YAAuC,EACvC,YAAoC;QAEpC,MAAM,YAAY,GAAG,YAAY,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;QAChE,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,wBAAwB,CAC3E,OAAO,CAAC,EAAE,EACV,YAAY,CACb,CAAC;QACF,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEzF,MAAM,KAAK,GAAuB,EAAE,CAAC;QACrC,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC;gBAC/D,OAAO;gBACP,OAAO,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE;aAClD,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,MAAM,IAAI,GAAqB;gBAC7B,WAAW,EAAE,QAAQ;gBACrB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC/B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAC;YACF,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACzC,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;gBACnF,SAAS;YACX,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,UAAoB,EACpB,cAAsB;QAEtB,uEAAuE;QACvE,wEAAwE;QACxE,2EAA2E;QAC3E,4EAA4E;QAC5E,kEAAkE;QAClE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACnE,CAAC;IAED,iBAAiB,CACf,OAAuB,EACvB,qBAAuD;QAEvD,MAAM,YAAY,GAAG,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC3D,OAAO,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,gBAAgB,CACpB,UAAoB,EACpB,cAAsB;QAEtB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QAC9C,OAAO,IAAI,GAAG,CACZ,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,wBAAwB,CACxD,cAAc,EACd,SAAS,EACT,UAAU,CACX,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/backend/services/catalog-product-filter.service.d.ts

@@ -0,0 +1,82 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CatalogProductFilter, CatalogProductFilterPort, CatalogProductRecord, CatalogSellableProductQuery } from '@endora-commerce/contracts';
+/**
+ * The sellable-product filter `catalog` publishes (feature 075).
+ *
+ * `product_feeds` compiles an operator's selection rule into a predicate and
+ * walks the catalogue with it. Until this port existed it did that by holding
+ * `Product` and handing MikroORM a `where` object of its own construction —
+ * the one demand Phase P declined to guess at, because a query object is the
+ * ORM rather than a contract.
+ *
+ * Three things move across the boundary with the translation, and each of them
+ * is why the port is worth more than the import it replaces:
+ *
+ *  1. **The floor is applied here.** Feature 067's FR-026 says an operator's
+ *     rule may only ever narrow "active, visible to the feed's reader, not
+ *     archived, not soft-deleted, in the feed's channel". On the caller's side
+ *     that was a conjunction a future edit could spread into one object and
+ *     lose; here it is one `$and` clause the caller cannot reach. Who "the
+ *     feed's reader" is has one answer and it is not this file's to invent —
+ *     see {@link ANONYMOUS_AUDIENCE_CLAUSE}.
+ *  2. **The cursor is applied here.** A keyset walk and the floor both
+ *     constrain `id`, and so does a category criterion. Composing all three
+ *     was the caller's problem and is now nobody's.
+ *  3. **Rows leave as records.** The caller reads six fields off each row and
+ *     yields ids; it never needed a managed entity, and holding one made the
+ *     identity map grow with the catalogue rather than with the page.
+ *
+ * ## What the translation may and may not do
+ *
+ * The filter grammar is deliberately narrower than MikroORM: six columns, the
+ * JSONB attribute bag, twelve operators, `and` / `or`, and the two constants.
+ * There is no node this function could translate into a join, a relation walk
+ * or a raw fragment, which is what stops the port becoming the general query
+ * surface publishing the DSL would have made it.
+ *
+ * `contains` and `startsWith` build their own patterns, so the caller never
+ * writes `LIKE` syntax and the escaping rule has exactly one home — this file.
+ * See {@link escapeLikeLiteral} for what that rule is and why the value has to
+ * go through it.
+ */
+/**
+ * The one place a `contains` / `startsWith` value becomes part of a pattern.
+ *
+ * Both operators name a **literal**: `contains "50%"` means the three
+ * characters `5`, `0`, `%`. `LIKE` reads `%` as "anything", `_` as "any one
+ * character" and — in PostgreSQL, absent an explicit `ESCAPE` clause — `\` as
+ * the escape character, so a value carrying any of the three used to mean
+ * something other than what the operator promises. Issue #181: an unescaped
+ * `contains "50%"` selected every product with "50" followed by anything.
+ *
+ * `\` is the escape character used here rather than an explicit `ESCAPE`
+ * clause, because there is nowhere to put one: MikroORM renders `$ilike` as
+ * `column ilike ?` with the pattern bound as a parameter, and reaching for a
+ * raw fragment to append `ESCAPE` would put SQL text back into a translation
+ * whose whole point is that it has no node for one. PostgreSQL's default escape
+ * character already *is* `\`, so escaping with it needs no clause — and it has
+ * to be escaped first in its own right, or a value ending in a backslash would
+ * escape the wildcard this function's callers append.
+ *
+ * Note the failure was not only over-matching: PostgreSQL degrades an escape
+ * sequence it does not recognise to the plain character, so the unescaped
+ * pattern for `C\D` also *missed* the row that actually holds the backslash.
+ */
+export declare function escapeLikeLiteral(value: string): string;
+export declare class CatalogProductFilterService implements CatalogProductFilterPort {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    listSellable(query: CatalogSellableProductQuery): Promise<CatalogProductRecord[]>;
+    countSellable(query: Omit<CatalogSellableProductQuery, 'afterId' | 'limit'>): Promise<number>;
+    /**
+     * Floor AND filter AND cursor, as an explicit `$and`.
+     *
+     * Never an object spread: all three constrain `id`, and spreading them keeps
+     * only the last one — which for a category criterion would drop the channel
+     * scoping altogether.
+     */
+    private where;
+}
+/** `null` when the node constrains nothing, so the caller can omit the clause. */
+export declare function translateFilter(filter: CatalogProductFilter): Record<string, unknown> | null;
+//# sourceMappingURL=catalog-product-filter.service.d.ts.map

package/dist/backend/services/catalog-product-filter.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-product-filter.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/catalog-product-filter.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EACV,oBAAoB,EAEpB,wBAAwB,EACxB,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,4BAA4B,CAAC;AAIpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAkBD,qBAAa,2BAA4B,YAAW,wBAAwB;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,YAAY,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAejF,aAAa,CACjB,KAAK,EAAE,IAAI,CAAC,2BAA2B,EAAE,SAAS,GAAG,OAAO,CAAC,GAC5D,OAAO,CAAC,MAAM,CAAC;IAQlB;;;;;;OAMG;IACH,OAAO,CAAC,KAAK;CAOd;AA2FD,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAS5F"}