@endora-commerce/mod-search 0.100.0

package/dist/backend/services/search-query.service.js

@@ -0,0 +1,346 @@
+import { Meilisearch, MeilisearchApiError } from 'meilisearch';
+import { ERROR_CODES, isProductVisibleTo, listingPriceMoney, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { encodeCursor, decodeCursor } from '@endora-commerce/platform/http';
+import { indexUidFor, } from './search-indexer.js';
+export class SearchQueryService {
+    products;
+    attributeRead;
+    listingPrices;
+    organizations;
+    client;
+    constructor(
+    /**
+     * Issue #153 — `catalog`'s product rows, over the port, where an
+     * `EntityManager` and `em.find(Product, …)` used to be.
+     *
+     * The `EntityManager` could not leave while `catalog/plugin.ts` built this
+     * class itself: a second module's composition decided what this
+     * constructor took. It resolves `searchQueryPort` now, so the hydration
+     * below asks `catalog` for its rows and answers 503 `MODULE_DISABLED` when
+     * `catalog` is off — which is right, because `search`'s manifest declares
+     * `catalog` and an index over a catalogue that is gone has nothing to
+     * hydrate against.
+     */
+    products, 
+    /**
+     * Feature 061 — the catalog's composed attribute read model (Principle I:
+     * filterable validation reads the view, not the catalog entity). Feature
+     * 075, Phase C — typed as the published port; `catalog`'s own service
+     * satisfies it structurally, so its construction of this class is unchanged.
+     */
+    attributeRead, options = {}, 
+    /**
+     * Issue #132 — the pricing engine, through the `pricingService` port. The
+     * hydration below exists so that Postgres, not the index, decides what a
+     * hit shows; the price it hydrates now comes from the engine for the same
+     * reason.
+     */
+    listingPrices, 
+    /**
+     * `organizations`' read model, for the customer group a group-targeted
+     * price list is selected by. The module already resolves this port for the
+     * typeahead popup, which has priced per buyer since feature 075 — the
+     * result feed under the popup did not, so one search box quoted two
+     * different figures for one product depending on whether the buyer stopped
+     * at the suggestions or pressed Enter.
+     *
+     * Optional only in the signature, and never reached by an anonymous query.
+     */
+    organizations) {
+        this.products = products;
+        this.attributeRead = attributeRead;
+        this.listingPrices = listingPrices;
+        this.organizations = organizations;
+        const host = options.meilisearchHost ??
+            process.env['MEILISEARCH_URL'] ??
+            'http://localhost:7700';
+        const apiKey = options.meilisearchApiKey ??
+            process.env['MEILISEARCH_API_KEY'] ??
+            undefined;
+        this.client = new Meilisearch(apiKey ? { host, apiKey } : { host });
+    }
+    async listProducts(params, ctx) {
+        const channel = ctx.resolvedChannel;
+        // Validate filter keys against the live composed attribute views so that an
+        // unfilterable attribute returns the same 400 the Postgres path returns
+        // (FR-005, T043). The Meilisearch index only enforces shape, not policy.
+        if (params.attributeFilters) {
+            const keys = Object.keys(params.attributeFilters);
+            if (keys.length > 0) {
+                if (!this.attributeRead) {
+                    throw new Error('SearchQueryService: the catalog attribute read port is not wired — attribute-filter validation is unavailable.');
+                }
+                const attrs = await this.attributeRead.listAll();
+                const byKey = new Map(attrs.map((a) => [a.key, a]));
+                for (const k of keys) {
+                    const a = byKey.get(k);
+                    if (!a || !a.isFilterable) {
+                        throw new HttpError(400, ERROR_CODES.FILTER_NOT_ALLOWED, `Attribute "${k}" is not filterable.`, [{ path: `filter[attr.${k}]`, issue: 'attribute is not filterable' }]);
+                    }
+                }
+            }
+        }
+        const indexUid = indexUidFor(channel);
+        const index = this.client.index(indexUid);
+        const offset = decodeOffsetCursor(params.cursor) ?? 0;
+        const filter = buildFilterExpression(params);
+        const sort = buildSort(params.sort);
+        let response;
+        try {
+            response = await index.search(params.q ?? '', {
+                offset,
+                // Over-fetch by one to detect hasMore.
+                limit: params.limit + 1,
+                ...(filter.length > 0 ? { filter } : {}),
+                ...(sort.length > 0 ? { sort } : {}),
+                attributesToRetrieve: [
+                    'id',
+                    'sku',
+                    'name',
+                    'slug',
+                    'type',
+                    'categorySlugs',
+                    'primaryAssetUrl',
+                ],
+            });
+        }
+        catch (err) {
+            // Reserved-fallback (R-08): `searchQueryPort` converts this into the
+            // `index-unavailable` arm and `catalog`'s listing re-runs the request
+            // through the Postgres path. Re-throw so the owner's port can decide.
+            //
+            // Issue #287 — but say *which* failure it was. Every failure of this
+            // call used to be wrapped as "unavailable", so a healthy engine
+            // refusing the query (`invalid_search_sort`, because the index carried
+            // no sortable attributes; `index_not_found`; a bad API key) was filed
+            // under the one heading an operator reads as transient. The degrade is
+            // still a degrade — a public catalogue must not 503 because search is
+            // unhappy — but a refusal is a defect on this side of the wire, so it
+            // names the engine's own error code and gets reported by this module
+            // rather than only by whoever happened to call it.
+            throw searchBackendFailure(err, indexUid);
+        }
+        const hits = response.hits.slice(0, params.limit);
+        const hasMore = response.hits.length > params.limit;
+        const nextCursor = hasMore ? encodeOffsetCursor(offset + params.limit) : null;
+        if (hits.length === 0) {
+            return {
+                data: [],
+                pagination: { cursor: nextCursor, hasMore, limit: params.limit },
+            };
+        }
+        // Hydrate the channel-aware price + multilingual name override from
+        // Postgres. This protects against stale index data and keeps R-18
+        // (hide price on non-public channels) authoritative on Postgres.
+        //
+        // Issue #227 — and the audience answer, for the same reason and in the
+        // same place. It is **not** pushed into the Meilisearch filter expression:
+        // the index carries `visibility` but has never carried
+        // `allowed_organization_ids`, so a filter there could cover one of the two
+        // columns and would still need this pass to be correct — while reading, to
+        // the next author, as though the question were settled upstream. The cost
+        // is the one this path already pays for a stale index: a page can come
+        // back shorter than `limit`.
+        const products = (await this.products.findByIds(hits.map((h) => h.id))).filter((p) => isProductVisibleTo(p, ctx.audience));
+        const productById = new Map(products.map((p) => [p.id, p]));
+        // A channel that withholds prices is not asked for them (R-18), so the
+        // resolution never runs and every hit reports `null`.
+        // The price is the *viewer's*, while the document stays everybody's. A
+        // Meilisearch document has never carried a price and does not start now:
+        // one index per sales channel, one document per product, and per-buyer
+        // pricing would otherwise multiply the corpus by the customer base. This
+        // pass already re-reads every hit from Postgres so a stale index cannot
+        // decide what a buyer sees; resolving the price for the caller here costs
+        // the page four statements (measured, `listing-price-viewer-cost.bench.ts`)
+        // and leaves the index shared.
+        const priceable = channel.isPublic && products.length > 0;
+        const viewerOrganization = priceable
+            ? await this.#viewerOrganization(ctx.audience)
+            : null;
+        const resolvedPrices = priceable
+            ? await this.#requireListingPrices().resolveListingPrices({
+                products,
+                context: {
+                    salesChannel: { id: channel.id, defaultCurrency: channel.defaultCurrency },
+                    organization: viewerOrganization,
+                },
+            })
+            : new Map();
+        const summaries = [];
+        for (const hit of hits) {
+            const product = productById.get(hit.id);
+            // Index pointed at a deleted row, or at one this audience may not see.
+            if (!product)
+                continue;
+            summaries.push(searchHitSummary(product, hit, channel, ctx.preferredLanguage, resolvedPrices.get(product.id)));
+        }
+        return {
+            data: summaries,
+            pagination: { cursor: nextCursor, hasMore, limit: params.limit },
+        };
+    }
+    #requireListingPrices() {
+        if (!this.listingPrices) {
+            throw new Error('SearchQueryService: the pricing port is not wired — a search hit cannot be priced.');
+        }
+        return this.listingPrices;
+    }
+    #requireOrganizations() {
+        if (!this.organizations) {
+            throw new Error('SearchQueryService: the organization read port is not wired — a signed-in buyer cannot be priced.');
+        }
+        return this.organizations;
+    }
+    /**
+     * The buying organisation a hit should be priced against — `null` for the
+     * anonymous visitor, for a signed-in buyer with no Organization, and for one
+     * whose Organization row is gone. The same three-way answer `catalog`'s
+     * listing gives, deliberately: the two backends serve the same route.
+     */
+    async #viewerOrganization(audience) {
+        if (audience.organizationId === null)
+            return null;
+        const record = await this.#requireOrganizations().findById(audience.organizationId);
+        if (!record)
+            return null;
+        return { id: record.id, customerGroupId: record.customerGroupId };
+    }
+}
+export class SearchBackendUnavailable extends Error {
+    kind;
+    code;
+    constructor(message, 
+    /** Which of the two facts this is. */
+    kind = 'unreachable', 
+    /** Meilisearch's own error code for a refusal; `null` when unreachable. */
+    code = null) {
+        super(message);
+        this.kind = kind;
+        this.code = code;
+        this.name = 'SearchBackendUnavailable';
+    }
+}
+/**
+ * Conditions this module has already reported. Module scope and never reset —
+ * the same shape `plugin.ts` uses for an out-of-scope setting (D-43), and for
+ * the same reason: an index setting is a deployment fact, and a public listing
+ * would otherwise report it on every request of every page.
+ */
+const reportedSearchRefusals = new Set();
+/**
+ * Classify a failed Meilisearch call, and report a refusal once per code.
+ *
+ * The report is `console.error` rather than a request logger because the
+ * failure belongs to the module, not to the request that happened to hit it —
+ * the same call fails identically for the reindex sweep and the typeahead —
+ * and because the consumer's own line (`meilisearch unavailable; falling back
+ * to postgres`, at `warn`) is the line this exists to contradict.
+ */
+function searchBackendFailure(err, indexUid) {
+    const message = err instanceof Error ? err.message : String(err);
+    const status = err instanceof MeilisearchApiError ? err.response.status : null;
+    // A 4xx is the engine declining the request. 429 is not: it is the engine
+    // saying "not now", which is an availability answer.
+    const refused = status !== null && status >= 400 && status < 500 && status !== 429;
+    if (!refused)
+        return new SearchBackendUnavailable(`Meilisearch unavailable: ${message}`);
+    const code = (err instanceof MeilisearchApiError ? err.cause?.code : undefined) ?? `http_${status}`;
+    if (!reportedSearchRefusals.has(code)) {
+        reportedSearchRefusals.add(code);
+        console.error(`search: Meilisearch refused a query on "${indexUid}" with "${code}" — this is a ` +
+            `configuration defect, not an outage, and every affected listing is silently ` +
+            `falling back to Postgres until it is fixed. ${message}`);
+    }
+    return new SearchBackendUnavailable(`Meilisearch refused the query (${code}): ${message}`, 'refused', code);
+}
+export function buildFilterExpression(params) {
+    const out = [];
+    if (params.categorySlug) {
+        out.push(`categorySlugs = "${escapeFilterValue(params.categorySlug)}"`);
+    }
+    if (params.attributeFilters) {
+        for (const [key, values] of Object.entries(params.attributeFilters)) {
+            if (values.length === 0)
+                continue;
+            const orParts = values.map((v) => `attributes.${key} = "${escapeFilterValue(v)}"`);
+            out.push(`(${orParts.join(' OR ')})`);
+        }
+    }
+    return out;
+}
+export function buildSort(sort) {
+    // `relevance` and the absent sort both leave the ordering to the engine's
+    // ranking rules, which need no sortable attribute.
+    if (sort === undefined || sort === 'relevance')
+        return [];
+    if (sort === '-createdAt')
+        return ['createdAt:desc'];
+    if (sort === 'name')
+        return ['name:asc'];
+    if (sort === '-name')
+        return ['name:desc'];
+    return [];
+}
+function escapeFilterValue(value) {
+    return value.replace(/"/g, '\\"');
+}
+function encodeOffsetCursor(offset) {
+    return encodeCursor(JSON.stringify({ offset }));
+}
+function decodeOffsetCursor(cursor) {
+    if (!cursor)
+        return null;
+    const raw = decodeCursor(cursor);
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.offset !== 'number' || !Number.isFinite(parsed.offset)) {
+            return null;
+        }
+        return Math.max(0, parsed.offset);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Project one hydrated hit into a `ProductSummary` (issue #132).
+ *
+ * `resolvedPrice` is the chain's answer for this product, or `undefined` when
+ * the channel withheld the resolution — both render `null`, which is the one
+ * spelling `ProductSummary.price` has for "no price". Exported so the
+ * projection can be asserted without a Meilisearch round trip.
+ */
+export function searchHitSummary(product, hit, channel, preferredLanguage, resolvedPrice) {
+    const price = resolvedPrice === undefined ? null : listingPriceMoney(resolvedPrice);
+    return {
+        id: product.id,
+        sku: product.sku,
+        type: product.type,
+        name: pickLang(product.name, preferredLanguage, channel) || hit.name,
+        slug: product.slug,
+        categorySlugs: hit.categorySlugs,
+        primaryAssetUrl: hit.primaryAssetUrl ?? null,
+        price,
+        stockIndicator: null,
+        stockLevel: null,
+    };
+}
+function pickLang(blob, preferred, channel) {
+    const candidates = [
+        preferred,
+        channel?.defaultLanguage,
+        'en-US',
+        'en',
+    ].filter((v) => typeof v === 'string');
+    for (const lang of candidates) {
+        const hit = blob[lang];
+        if (hit)
+            return hit;
+    }
+    const anyKey = Object.keys(blob)[0];
+    return anyKey ? (blob[anyKey] ?? '') : '';
+}
+//# sourceMappingURL=search-query.service.js.map

package/dist/backend/services/search-query.service.js.map

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

package/dist/backend/services/search-reindex-worker.d.ts

@@ -0,0 +1,27 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { SearchIndexer } from './search-indexer.js';
+/**
+ * SearchReindexWorker — periodic full Meilisearch reindex.
+ *
+ * Wraps {@link SearchIndexer.reindexAllChannels} so the catalogue stays in
+ * sync even when an incremental event was missed (e.g. a bulk import that
+ * bypassed the catalog event bus, or a Meilisearch restart). The sweep runs
+ * every `search.reindex_interval_minutes` minutes (Settings, default 10); the
+ * same `reindex()` entry point also backs the admin "Reindex now" button.
+ *
+ * Public `reindex()` is a plain async function so tests can drive it directly
+ * without Redis/BullMQ and so the admin route can call it synchronously.
+ */
+export interface SearchReindexWorkerDeps {
+    emFactory: () => EntityManager;
+    indexer: SearchIndexer;
+}
+export declare class SearchReindexWorker {
+    private readonly deps;
+    constructor(deps: SearchReindexWorkerDeps);
+    reindex(): Promise<{
+        channelsReindexed: number;
+        documentCount: number;
+    }>;
+}
+//# sourceMappingURL=search-reindex-worker.d.ts.map

package/dist/backend/services/search-reindex-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-reindex-worker.d.ts","sourceRoot":"","sources":["../../../src/backend/services/search-reindex-worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,uBAAuB;IAEpD,OAAO,IAAI,OAAO,CAAC;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CAM/E"}

package/dist/backend/services/search-reindex-worker.js

@@ -0,0 +1,13 @@
+export class SearchReindexWorker {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async reindex() {
+        const em = this.deps.emFactory();
+        const results = await this.deps.indexer.reindexAllChannels(em);
+        const documentCount = results.reduce((sum, r) => sum + r.documentCount, 0);
+        return { channelsReindexed: results.length, documentCount };
+    }
+}
+//# sourceMappingURL=search-reindex-worker.js.map

package/dist/backend/services/search-reindex-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-reindex-worker.js","sourceRoot":"","sources":["../../../src/backend/services/search-reindex-worker.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,IAA6B;QAA7B,SAAI,GAAJ,IAAI,CAAyB;IAAG,CAAC;IAE9D,KAAK,CAAC,OAAO;QACX,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAC/D,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAC3E,OAAO,EAAE,iBAAiB,EAAE,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IAC9D,CAAC;CACF"}

package/dist/backend/services/search-suggest.service.d.ts

@@ -0,0 +1,53 @@
+import type { ProductSummary } from '@endora-commerce/contracts';
+import { SearchBackendUnavailable, type SearchQueryService, type SearchQueryContext } from './search-query.service.js';
+/**
+ * SearchSuggestService — feature 006 / US1 / T012.
+ *
+ * Narrow typeahead-popup adapter on top of {@link SearchQueryService}.
+ * The full results page reuses `/api/v1/catalog/products?q=…`; this service
+ * exists so the popup can:
+ *
+ *   1. Cap the response to a small slice (no FilterPanel, no facet
+ *      metadata, no pagination) — payload bounded by `limit`.
+ *   2. Enforce the same minimum-query-length contract the storefront
+ *      enforces client-side, server-side too (the popup can never bypass
+ *      it via curl).
+ *   3. Echo the resolved threshold back to the client so the storefront
+ *      component can self-correct without a separate settings round-trip.
+ *
+ * Per-channel defaults for `limit` and `minimumQueryLength` will move to
+ * the Settings module in US2 (T024 wires the settings-aware provider);
+ * for US1 they fall back to the foundation-time defaults declared in the
+ * data model.
+ */
+export declare const DEFAULT_SUGGESTION_COUNT = 8;
+export declare const DEFAULT_MINIMUM_QUERY_LENGTH = 3;
+export interface SuggestionCountConfig {
+    defaultLimit: number;
+    minimumQueryLength: number;
+}
+export interface SearchSuggestParams {
+    q: string;
+    limit?: number | undefined;
+}
+export interface SearchSuggestResult {
+    data: ProductSummary[];
+    meta: {
+        limit: number;
+        minimumQueryLength: number;
+        queryEcho: string;
+    };
+}
+/** Sentinel thrown when the trimmed query is shorter than the resolved minimum. */
+export declare class QueryTooShort extends Error {
+    readonly minimumQueryLength: number;
+    constructor(minimumQueryLength: number);
+}
+export declare class SearchSuggestService {
+    private readonly searchQueryService;
+    private readonly resolveConfig;
+    constructor(searchQueryService: SearchQueryService, resolveConfig?: (ctx: SearchQueryContext) => Promise<SuggestionCountConfig> | SuggestionCountConfig);
+    suggest(params: SearchSuggestParams, ctx: SearchQueryContext): Promise<SearchSuggestResult>;
+}
+export { SearchBackendUnavailable };
+//# sourceMappingURL=search-suggest.service.d.ts.map

package/dist/backend/services/search-suggest.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-suggest.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/search-suggest.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EACL,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,kBAAkB,EAAE,MAAM,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,mFAAmF;AACnF,qBAAa,aAAc,SAAQ,KAAK;aACV,kBAAkB,EAAE,MAAM;gBAA1B,kBAAkB,EAAE,MAAM;CAIvD;AAED,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,kBAAkB,EAAE,kBAAkB,EACtC,aAAa,GAAE,CAC9B,GAAG,EAAE,kBAAkB,KACpB,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAGpC;IAGE,OAAO,CACX,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,mBAAmB,CAAC;CAsBhC;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/backend/services/search-suggest.service.js

@@ -0,0 +1,64 @@
+import { SearchBackendUnavailable, } from './search-query.service.js';
+/**
+ * SearchSuggestService — feature 006 / US1 / T012.
+ *
+ * Narrow typeahead-popup adapter on top of {@link SearchQueryService}.
+ * The full results page reuses `/api/v1/catalog/products?q=…`; this service
+ * exists so the popup can:
+ *
+ *   1. Cap the response to a small slice (no FilterPanel, no facet
+ *      metadata, no pagination) — payload bounded by `limit`.
+ *   2. Enforce the same minimum-query-length contract the storefront
+ *      enforces client-side, server-side too (the popup can never bypass
+ *      it via curl).
+ *   3. Echo the resolved threshold back to the client so the storefront
+ *      component can self-correct without a separate settings round-trip.
+ *
+ * Per-channel defaults for `limit` and `minimumQueryLength` will move to
+ * the Settings module in US2 (T024 wires the settings-aware provider);
+ * for US1 they fall back to the foundation-time defaults declared in the
+ * data model.
+ */
+export const DEFAULT_SUGGESTION_COUNT = 8;
+export const DEFAULT_MINIMUM_QUERY_LENGTH = 3;
+/** Sentinel thrown when the trimmed query is shorter than the resolved minimum. */
+export class QueryTooShort extends Error {
+    minimumQueryLength;
+    constructor(minimumQueryLength) {
+        super(`query is shorter than the minimum length of ${minimumQueryLength}`);
+        this.minimumQueryLength = minimumQueryLength;
+        this.name = 'QueryTooShort';
+    }
+}
+export class SearchSuggestService {
+    searchQueryService;
+    resolveConfig;
+    constructor(searchQueryService, resolveConfig = () => ({
+        defaultLimit: DEFAULT_SUGGESTION_COUNT,
+        minimumQueryLength: DEFAULT_MINIMUM_QUERY_LENGTH,
+    })) {
+        this.searchQueryService = searchQueryService;
+        this.resolveConfig = resolveConfig;
+    }
+    async suggest(params, ctx) {
+        const cfg = await this.resolveConfig(ctx);
+        const trimmed = params.q.trim();
+        if (trimmed.length < cfg.minimumQueryLength) {
+            throw new QueryTooShort(cfg.minimumQueryLength);
+        }
+        const limit = params.limit ?? cfg.defaultLimit;
+        // SearchQueryService throws SearchBackendUnavailable on Meilisearch
+        // outage; the route wrapper translates it into a 503.
+        const result = await this.searchQueryService.listProducts({ q: trimmed, limit, sort: 'relevance' }, ctx);
+        return {
+            data: result.data,
+            meta: {
+                limit,
+                minimumQueryLength: cfg.minimumQueryLength,
+                queryEcho: trimmed,
+            },
+        };
+    }
+}
+export { SearchBackendUnavailable };
+//# sourceMappingURL=search-suggest.service.js.map

package/dist/backend/services/search-suggest.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-suggest.service.js","sourceRoot":"","sources":["../../../src/backend/services/search-suggest.service.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,GAGzB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAqB9C,mFAAmF;AACnF,MAAM,OAAO,aAAc,SAAQ,KAAK;IACV;IAA5B,YAA4B,kBAA0B;QACpD,KAAK,CAAC,+CAA+C,kBAAkB,EAAE,CAAC,CAAC;QADjD,uBAAkB,GAAlB,kBAAkB,CAAQ;QAEpD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,oBAAoB;IAEZ;IACA;IAFnB,YACmB,kBAAsC,EACtC,gBAE6C,GAAG,EAAE,CAAC,CAAC;QACnE,YAAY,EAAE,wBAAwB;QACtC,kBAAkB,EAAE,4BAA4B;KACjD,CAAC;QANe,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,kBAAa,GAAb,aAAa,CAK5B;IACD,CAAC;IAEJ,KAAK,CAAC,OAAO,CACX,MAA2B,EAC3B,GAAuB;QAEvB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,kBAAkB,EAAE,CAAC;YAC5C,MAAM,IAAI,aAAa,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC,YAAY,CAAC;QAC/C,oEAAoE;QACpE,sDAAsD;QACtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,YAAY,CACvD,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EACxC,GAAG,CACJ,CAAC;QACF,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE;gBACJ,KAAK;gBACL,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;gBAC1C,SAAS,EAAE,OAAO;aACnB;SACF,CAAC;IACJ,CAAC;CACF;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/backend/services/suggestion-pricing-enricher.d.ts

@@ -0,0 +1,62 @@
+import type { CatalogProductReadPort, CatalogProductRecord, DisplayMode, OrganizationDetailsPort, OrganizationRecord } from '@endora-commerce/contracts';
+import type { SuggestionPricingEnricher } from '../routes.public.js';
+/**
+ * Builds the {@link SuggestionPricingEnricher} the suggest route uses to
+ * attach the per-customer price-list resolution to each typeahead hit.
+ *
+ * The search module stays isolated from the price-lists module's concrete
+ * service: it depends only on the narrow {@link SuggestionPriceResolverPort}
+ * structural port below, which the container's `pricingService` satisfies with
+ * the price-lists `PricingService`. (Constitution I — modules talk through
+ * ports.) Its two row parameters are the published contract records, so the
+ * declaration names no file in `catalog`'s or `organizations`' directory.
+ *
+ * Pricing is resolved per hit in parallel, capped by the suggest `limit`
+ * (default 8), and the resolver caches per-tuple for 60s, so the popup adds
+ * at most one bounded fan-out. A resolver *refusal* degrades that hit to the
+ * plain summary — the popup never fails over a pricing hiccup — but the
+ * module-presence answer is not a hiccup and is re-thrown (issue #84): a
+ * suggest popup with every price missing reads to a buyer as a catalogue
+ * without prices, not as `price_lists` being switched off.
+ */
+export interface SuggestionPriceResolverPort {
+    resolveEngine(input: {
+        product: CatalogProductRecord;
+        variantId?: string | null;
+        context: {
+            quantity: number;
+            organization?: OrganizationRecord | null;
+            salesChannel: {
+                id: string;
+                defaultCurrency: string;
+            };
+            currencyCode?: string;
+        };
+    }): Promise<{
+        base: {
+            bracket: {
+                amount: string;
+            } | null;
+        };
+        sale: {
+            bracket: {
+                amount: string;
+            };
+        } | null;
+        displayMode: DisplayMode;
+        currencyCode: string;
+    }>;
+}
+export declare function createSuggestionPricingEnricher(deps: {
+    /**
+     * Feature 075, Phase C — the two rows a priced suggestion needs, each read
+     * from the module that owns it instead of out of its table. `em.find(Product,
+     * …)` and `em.findOne(Organization, …)` from inside this module went on
+     * answering after an operator had switched either owner off, because
+     * deactivation drops no tables; the ports fail closed instead.
+     */
+    catalogProducts: CatalogProductReadPort;
+    organizations: OrganizationDetailsPort;
+    pricingService: SuggestionPriceResolverPort;
+}): SuggestionPricingEnricher;
+//# sourceMappingURL=suggestion-pricing-enricher.d.ts.map

package/dist/backend/services/suggestion-pricing-enricher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion-pricing-enricher.d.ts","sourceRoot":"","sources":["../../../src/backend/services/suggestion-pricing-enricher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,EACX,uBAAuB,EACvB,kBAAkB,EAGnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAErE;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,2BAA2B;IAC1C,aAAa,CAAC,KAAK,EAAE;QACnB,OAAO,EAAE,oBAAoB,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,OAAO,EAAE;YACP,QAAQ,EAAE,MAAM,CAAC;YACjB,YAAY,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;YACzC,YAAY,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,eAAe,EAAE,MAAM,CAAA;aAAE,CAAC;YACtD,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,CAAC;KACH,GAAG,OAAO,CAAC;QACV,IAAI,EAAE;YAAE,OAAO,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAA;SAAE,CAAC;QAC7C,IAAI,EAAE;YAAE,OAAO,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,GAAG,IAAI,CAAC;QAC7C,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD;;;;;;OAMG;IACH,eAAe,EAAE,sBAAsB,CAAC;IACxC,aAAa,EAAE,uBAAuB,CAAC;IACvC,cAAc,EAAE,2BAA2B,CAAC;CAC7C,GAAG,yBAAyB,CA0C5B"}

package/dist/backend/services/suggestion-pricing-enricher.js

@@ -0,0 +1,41 @@
+import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
+export function createSuggestionPricingEnricher(deps) {
+    const { catalogProducts, organizations, pricingService } = deps;
+    return async (items, ctx) => {
+        if (items.length === 0)
+            return [];
+        // Feature 053 / FR-002: the channel is resolved once upstream and handed in.
+        const channel = ctx.resolvedChannel;
+        const organization = ctx.organizationId
+            ? await organizations.findById(ctx.organizationId)
+            : null;
+        const products = await catalogProducts.findByIds(items.map((i) => i.id));
+        const byId = new Map(products.map((p) => [p.id, p]));
+        return Promise.all(items.map(async (item) => {
+            const product = byId.get(item.id);
+            if (!product)
+                return { ...item };
+            try {
+                const out = await pricingService.resolveEngine({
+                    product,
+                    context: { quantity: 1, organization, salesChannel: channel },
+                });
+                return {
+                    ...item,
+                    basePrice: out.base.bracket
+                        ? { amount: out.base.bracket.amount, currency: out.currencyCode }
+                        : null,
+                    salePrice: out.sale
+                        ? { amount: out.sale.bracket.amount, currency: out.currencyCode }
+                        : null,
+                    priceDisplayMode: out.displayMode,
+                };
+            }
+            catch (error) {
+                rethrowIfModuleDisabled(error);
+                return { ...item };
+            }
+        }));
+    };
+}
+//# sourceMappingURL=suggestion-pricing-enricher.js.map

package/dist/backend/services/suggestion-pricing-enricher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion-pricing-enricher.js","sourceRoot":"","sources":["../../../src/backend/services/suggestion-pricing-enricher.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAyC3E,MAAM,UAAU,+BAA+B,CAAC,IAW/C;IACC,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAEhE,OAAO,KAAK,EAAE,KAAuB,EAAE,GAAG,EAAgC,EAAE;QAC1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAElC,6EAA6E;QAC7E,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC;QAEpC,MAAM,YAAY,GAAG,GAAG,CAAC,cAAc;YACrC,CAAC,CAAC,MAAM,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC;YAClD,CAAC,CAAC,IAAI,CAAC;QAET,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAErD,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAA8B,EAAE;YACnD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,CAAC,OAAO;gBAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,aAAa,CAAC;oBAC7C,OAAO;oBACP,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE;iBAC9D,CAAC,CAAC;gBACH,OAAO;oBACL,GAAG,IAAI;oBACP,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO;wBACzB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE;wBACjE,CAAC,CAAC,IAAI;oBACR,SAAS,EAAE,GAAG,CAAC,IAAI;wBACjB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE;wBACjE,CAAC,CAAC,IAAI;oBACR,gBAAgB,EAAE,GAAG,CAAC,WAAW;iBAClC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,uBAAuB,CAAC,KAAK,CAAC,CAAC;gBAC/B,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}