@endora-commerce/mod-search 0.100.0

package/dist/backend/services/embedder-config-resolver.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
+import { SEARCH_SETTING_CODES } from '../../manifest.js';
+const stringSchema = z.string();
+/**
+ * Resolve the Meilisearch embedder config for a channel (feature 058, T060).
+ *
+ * The `search.llm.embedder_credentials` reference (a reusable `llm` credential
+ * configuration) is the SINGLE source: its `baseUrl` → embedder URL, `apiKey` →
+ * embedder API key, `model` → embedder model. When the reference is unset or
+ * unresolvable, every field comes back empty and the caller treats LLM search as
+ * not configured (fail closed). There are no separate embedder settings.
+ *
+ * The secret `apiKey` is decrypted in-memory by `resolve`; it never leaves the
+ * process.
+ */
+export async function resolveEmbedderConfig(settings, channelId, credentials) {
+    let refCode = '';
+    try {
+        refCode = await settings.get(SEARCH_SETTING_CODES.LLM_EMBEDDER_CREDENTIALS, channelId, stringSchema);
+    }
+    catch {
+        // Not seeded / out of scope — treat as unset.
+        refCode = '';
+    }
+    if (!credentials || !refCode) {
+        return { url: '', apiKey: '', model: '' };
+    }
+    // Tolerated: an unset or unresolvable reference means LLM search is not
+    // configured, and the caller is right to serve without it. **A presence
+    // answer is not that**: `credentials` being switched off would otherwise read
+    // as "the operator never configured this", and the screen would offer to fix
+    // a setting that is already correct.
+    const resolved = await credentials.resolve(refCode).catch((error) => {
+        rethrowIfModuleDisabled(error);
+        return null;
+    });
+    if (!resolved || resolved.status !== 'ok') {
+        return { url: '', apiKey: '', model: '' };
+    }
+    return {
+        url: typeof resolved.values['baseUrl'] === 'string' ? resolved.values['baseUrl'] : '',
+        apiKey: typeof resolved.values['apiKey'] === 'string' ? resolved.values['apiKey'] : '',
+        model: typeof resolved.values['model'] === 'string' ? resolved.values['model'] : '',
+    };
+}
+//# sourceMappingURL=embedder-config-resolver.js.map

package/dist/backend/services/embedder-config-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder-config-resolver.js","sourceRoot":"","sources":["../../../src/backend/services/embedder-config-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAyB,MAAM,kCAAkC,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAazD,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;AAEhC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAA0B,EAC1B,SAAiB,EACjB,WAAmC;IAEnC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,CAC1B,oBAAoB,CAAC,wBAAwB,EAC7C,SAAS,EACT,YAAY,CACb,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;QAC9C,OAAO,GAAG,EAAE,CAAC;IACf,CAAC;IAED,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC;IAED,wEAAwE;IACxE,wEAAwE;IACxE,8EAA8E;IAC9E,6EAA6E;IAC7E,qCAAqC;IACrC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC3E,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO;QACL,GAAG,EAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE;QACrF,MAAM,EAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QACtF,KAAK,EAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;KACpF,CAAC;AACJ,CAAC"}

package/dist/backend/services/llm-toggle.service.d.ts

@@ -0,0 +1,50 @@
+import { type SettingsAdminAuditContext, type SettingsAdminPort } from '@endora-commerce/contracts';
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+import { type CredentialResolvePort } from './embedder-config-resolver.js';
+/**
+ * LlmToggleService — feature 006 / US2 / T024.
+ *
+ * Cross-setting validating wrapper around `search.llm.enabled`. The four
+ * `search.llm.*` settings (toggle + url + api_key + model) live in the
+ * Settings module's `setting_values` table; the three embedder.* fields
+ * are written through the generic Settings admin route (per-field audit
+ * trail). This wrapper only writes the `enabled` toggle, but refuses to
+ * flip it on for any channel whose embedder.* triplet is incomplete
+ * (FR-011).
+ *
+ * Disabling never refuses — turning off LLM-augmented search must always
+ * be possible regardless of the embedder fields' state.
+ */
+export interface LlmToggleParams {
+    enabled: boolean;
+    /** When omitted, applies to every channel in the setting's scope. */
+    salesChannelCodes?: string[];
+    expectedVersion: string | null;
+    actor: SettingsAdminAuditContext;
+}
+export interface LlmToggleResult {
+    enabled: boolean;
+    newVersion: string;
+    appliedChannelIds: string[];
+}
+export declare class LlmToggleService {
+    private readonly emFactory;
+    private readonly settingsService;
+    private readonly settingsAdminService;
+    /** Feature 058 — resolves `search.llm.embedder_credentials` (optional). */
+    private readonly credentials?;
+    constructor(emFactory: () => EntityManager, settingsService: SettingsReadPort, settingsAdminService: SettingsAdminPort, 
+    /** Feature 058 — resolves `search.llm.embedder_credentials` (optional). */
+    credentials?: CredentialResolvePort | undefined);
+    toggle(params: LlmToggleParams): Promise<LlmToggleResult>;
+    /**
+     * Reads the three embedder.* settings for every targeted channel and
+     * refuses with `LLM_CONFIG_INCOMPLETE` (HTTP 400) when any value is
+     * empty. The error's `details[]` lists each missing
+     * (channelCode, settingCode) pair so the admin UI can pinpoint what
+     * needs filling.
+     */
+    private assertEmbedderConfigComplete;
+}
+//# sourceMappingURL=llm-toggle.service.d.ts.map

package/dist/backend/services/llm-toggle.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-toggle.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/llm-toggle.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,yBAAyB,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAJZ,SAAS,EAAE,MAAM,aAAa,EAC9B,eAAe,EAAE,gBAAgB,EACjC,oBAAoB,EAAE,iBAAiB;IACxD,2EAA2E;IAC1D,WAAW,CAAC,EAAE,qBAAqB,YAAA;IAGhD,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IA2B/D;;;;;;OAMG;YACW,4BAA4B;CAwD3C"}

package/dist/backend/services/llm-toggle.service.js

@@ -0,0 +1,78 @@
+import { ERROR_CODES, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+import { SEARCH_SETTING_CODES } from '../../manifest.js';
+import { resolveEmbedderConfig, } from './embedder-config-resolver.js';
+export class LlmToggleService {
+    emFactory;
+    settingsService;
+    settingsAdminService;
+    credentials;
+    constructor(emFactory, settingsService, settingsAdminService, 
+    /** Feature 058 — resolves `search.llm.embedder_credentials` (optional). */
+    credentials) {
+        this.emFactory = emFactory;
+        this.settingsService = settingsService;
+        this.settingsAdminService = settingsAdminService;
+        this.credentials = credentials;
+    }
+    async toggle(params) {
+        if (params.enabled) {
+            await this.assertEmbedderConfigComplete(params.salesChannelCodes);
+        }
+        const result = params.salesChannelCodes
+            ? await this.settingsAdminService.setValueForSubset(SEARCH_SETTING_CODES.LLM_ENABLED, params.salesChannelCodes, params.enabled, params.expectedVersion, params.actor)
+            : await this.settingsAdminService.setValueForAllChannels(SEARCH_SETTING_CODES.LLM_ENABLED, params.enabled, params.expectedVersion, params.actor);
+        return {
+            enabled: params.enabled,
+            newVersion: result.newVersion,
+            appliedChannelIds: result.affectedChannelIds,
+        };
+    }
+    /**
+     * Reads the three embedder.* settings for every targeted channel and
+     * refuses with `LLM_CONFIG_INCOMPLETE` (HTTP 400) when any value is
+     * empty. The error's `details[]` lists each missing
+     * (channelCode, settingCode) pair so the admin UI can pinpoint what
+     * needs filling.
+     */
+    async assertEmbedderConfigComplete(salesChannelCodes) {
+        const em = this.emFactory();
+        const channels = salesChannelCodes
+            ? await em.find(SalesChannel, { code: { $in: salesChannelCodes } })
+            : await em.find(SalesChannel, {});
+        if (salesChannelCodes && channels.length !== salesChannelCodes.length) {
+            const found = new Set(channels.map((c) => c.code));
+            const missing = salesChannelCodes.filter((c) => !found.has(c));
+            throw new HttpError(400, ERROR_CODES.SETTING_OUT_OF_SCOPE_FOR_CHANNEL, `Unknown sales channel(s): ${missing.join(', ')}.`, missing.map((c) => ({
+                path: `salesChannelCodes.${c}`,
+                issue: 'unknown sales channel',
+            })));
+        }
+        const missing = [];
+        for (const channel of channels) {
+            // Feature 058 — the embedder config comes solely from the
+            // `search.llm.embedder_credentials` reference (Base URL + API key + model).
+            // A field is "missing" when the referenced configuration does not supply
+            // it (or no reference is set); the error points at the credential setting.
+            const cfg = await resolveEmbedderConfig(this.settingsService, channel.id, this.credentials);
+            const fields = [
+                ['url', cfg.url],
+                ['apiKey', cfg.apiKey],
+                ['model', cfg.model],
+            ];
+            for (const [field, value] of fields) {
+                if (!value || value.length === 0) {
+                    missing.push({ channelCode: channel.code, field });
+                }
+            }
+        }
+        if (missing.length > 0) {
+            throw new HttpError(400, ERROR_CODES.LLM_CONFIG_INCOMPLETE, 'LLM-augmented search cannot be enabled until the referenced embedder credential supplies a Base URL, API key and model on every targeted channel.', missing.map((m) => ({
+                path: `${m.channelCode}.${SEARCH_SETTING_CODES.LLM_EMBEDDER_CREDENTIALS}`,
+                issue: `embedder ${m.field} is not provided by the credential`,
+            })));
+        }
+    }
+}
+//# sourceMappingURL=llm-toggle.service.js.map

package/dist/backend/services/llm-toggle.service.js.map

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

package/dist/backend/services/search-event-subscriber.d.ts

@@ -0,0 +1,125 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { EventBase } from '@endora-commerce/platform/events';
+import type { SearchIndexer } from './search-indexer.js';
+import type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+import { type CredentialResolvePort } from './embedder-config-resolver.js';
+/**
+ * SearchEventSubscriber (T067 — incremental upsert path).
+ *
+ * The handlers that keep the per-channel Meilisearch indexes in sync with
+ * Postgres, so a catalog mutation costs an incremental upsert rather than an
+ * offline reindex. **The class no longer subscribes to anything** — the
+ * registrations live in this module's `backend.ts`, where `ctx.subscribe` wraps
+ * each one in `subscribeForModule` and the module's effective state decides
+ * whether the handler runs (issue #107). What used to happen here was a bare
+ * `eventBus.on`, so a deployment with `search` switched off went on rewriting
+ * Meilisearch documents on every product write.
+ *
+ * The events `backend.ts` maps onto these methods:
+ *
+ *   - `product.created.v1`  → upsertProduct
+ *   - `product.updated.v1`  → upsertProduct
+ *   - `product.archived.v1` → deleteProduct
+ *   - `product.deleted.v1`  → deleteProduct
+ *   - `attribute.updated.v1` → refreshAttributeSettings
+ *   - `category.updated.v1` → reindexCategorySubtree (feature 068: the
+ *      category's slug and activation state are projected onto every product
+ *      document under it, so a rename or a deactivation has to reach the index)
+ *
+ * Feature 006 / T027 also attaches the LLM-augmented-search reactor:
+ *
+ *   - `settings.value_changed` (settingCode = `search.llm.enabled`)
+ *      → attach or detach a Meilisearch embedder per affected channel,
+ *        depending on the new boolean value. When `enabled=true` and any
+ *        of the embedder.* config values are empty, the handler logs and
+ *        no-ops — the toggle's pre-write validator (LlmToggleService) is
+ *        the user-visible refusal path; this handler is the
+ *        belt-and-braces guard for direct generic-Settings writes.
+ *
+ * Handlers swallow their own errors so a transient Meilisearch outage
+ * doesn't break the catalog write path. The reserved-fallback in the read
+ * path (catalog/routes.public.ts) keeps search functional even with a
+ * stale index until the next offline `search:reindex`.
+ */
+interface CatalogEvents extends Record<string, EventBase> {
+    'product.created.v1': EventBase & {
+        productId: string;
+        sku: string;
+    };
+    'product.updated.v1': EventBase & {
+        productId: string;
+        changedFields: string[];
+    };
+    'product.archived.v1': EventBase & {
+        productId: string;
+    };
+    'product.deleted.v1': EventBase & {
+        productId: string;
+    };
+    'attribute.updated.v1': EventBase & {
+        key: string;
+        isSearchable: boolean;
+        isFilterable: boolean;
+    };
+    'category.updated.v1': EventBase & {
+        categoryId: string;
+    };
+    'settings.value_changed': EventBase & {
+        settingCode: string;
+        salesChannelIds: string[];
+        /**
+         * Set when the platform-wide global override (settings.global_value)
+         * changed (feature 042). Channels without a per-channel override
+         * resolve from the global; this flag tells the reactor to re-evaluate
+         * every in-scope channel, not only the codes listed in `salesChannelIds`.
+         */
+        globalValueUpdated?: boolean;
+        valueType: string;
+    };
+}
+/** The `settings.value_changed` payload this module reacts to. */
+export type SettingChangedPayload = CatalogEvents['settings.value_changed'];
+export interface SearchEventSubscriberDeps {
+    emFactory: () => EntityManager;
+    indexer: SearchIndexer;
+    /**
+     * Universal-getter for Settings — required when the LLM-toggle reactor
+     * is enabled (feature 006). When undefined, the `settings.value_changed`
+     * handler is not attached; foundation tests that don't have settings
+     * wired stay green.
+     */
+    settingsService?: SettingsReadPort;
+    /**
+     * Feature 058 — resolves `search.llm.embedder_credentials` into the embedder
+     * config, falling back per field to the legacy embedder settings. Optional.
+     */
+    credentials?: CredentialResolvePort;
+    /**
+     * Logger hook for failures. Defaults to console.warn so production logs
+     * still surface them; tests pass a vi.fn() to assert.
+     */
+    onError?: (err: unknown, eventName: string) => void;
+}
+export declare class SearchEventSubscriber {
+    private readonly deps;
+    constructor(deps: SearchEventSubscriberDeps);
+    private get log();
+    /** `product.created.v1` / `product.updated.v1`. */
+    onProductUpserted(productId: string, eventName: string): Promise<void>;
+    /** `product.archived.v1` / `product.deleted.v1`. */
+    onProductRemoved(productId: string, eventName: string): Promise<void>;
+    /**
+     * `category.updated.v1` — feature 068: a category's slug and activation state
+     * are projected onto every product document beneath it.
+     */
+    onCategoryUpdated(categoryId: string): Promise<void>;
+    /** `attribute.updated.v1`. */
+    onAttributeUpdated(): Promise<void>;
+    /**
+     * `settings.value_changed` — the LLM-augmented-search reactor (feature 006 /
+     * T027). A no-op unless a settings service was supplied.
+     */
+    onSettingChanged(payload: SettingChangedPayload): Promise<void>;
+}
+export {};
+//# sourceMappingURL=search-event-subscriber.d.ts.map

package/dist/backend/services/search-event-subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-event-subscriber.d.ts","sourceRoot":"","sources":["../../../src/backend/services/search-event-subscriber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,UAAU,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IACvD,oBAAoB,EAAE,SAAS,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,oBAAoB,EAAE,SAAS,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjF,qBAAqB,EAAE,SAAS,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,oBAAoB,EAAE,SAAS,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,sBAAsB,EAAE,SAAS,GAAG;QAClC,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,qBAAqB,EAAE,SAAS,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,wBAAwB,EAAE,SAAS,GAAG;QACpC,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B;;;;;WAKG;QACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,kEAAkE;AAClE,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,wBAAwB,CAAC,CAAC;AAE5E,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAID,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,yBAAyB;IAE5D,OAAO,KAAK,GAAG,GAEd;IAED,mDAAmD;IAC7C,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5E,oDAAoD;IAC9C,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3E;;;OAGG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D,8BAA8B;IACxB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQzC;;;OAGG;IACG,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CAuDtE"}

package/dist/backend/services/search-event-subscriber.js

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+import { SEARCH_SETTING_CODES } from '../../manifest.js';
+import { resolveEmbedderConfig, } from './embedder-config-resolver.js';
+const booleanSchema = z.boolean();
+export class SearchEventSubscriber {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get log() {
+        return this.deps.onError ?? defaultLogger;
+    }
+    /** `product.created.v1` / `product.updated.v1`. */
+    async onProductUpserted(productId, eventName) {
+        try {
+            await this.deps.indexer.upsertProduct(this.deps.emFactory(), productId);
+        }
+        catch (err) {
+            this.log(err, eventName);
+        }
+    }
+    /** `product.archived.v1` / `product.deleted.v1`. */
+    async onProductRemoved(productId, eventName) {
+        try {
+            await this.deps.indexer.deleteProduct(this.deps.emFactory(), productId);
+        }
+        catch (err) {
+            this.log(err, eventName);
+        }
+    }
+    /**
+     * `category.updated.v1` — feature 068: a category's slug and activation state
+     * are projected onto every product document beneath it.
+     */
+    async onCategoryUpdated(categoryId) {
+        try {
+            await this.deps.indexer.reindexCategorySubtree(this.deps.emFactory(), categoryId);
+        }
+        catch (err) {
+            this.log(err, 'category.updated.v1');
+        }
+    }
+    /** `attribute.updated.v1`. */
+    async onAttributeUpdated() {
+        try {
+            await this.deps.indexer.refreshAttributeSettings(this.deps.emFactory());
+        }
+        catch (err) {
+            this.log(err, 'attribute.updated.v1');
+        }
+    }
+    /**
+     * `settings.value_changed` — the LLM-augmented-search reactor (feature 006 /
+     * T027). A no-op unless a settings service was supplied.
+     */
+    async onSettingChanged(payload) {
+        const settingsService = this.deps.settingsService;
+        if (!settingsService)
+            return;
+        if (payload.settingCode !== SEARCH_SETTING_CODES.LLM_ENABLED)
+            return;
+        const { emFactory, indexer } = this.deps;
+        const log = this.log;
+        try {
+            const em = emFactory();
+            // Feature 042: a global-override change touches every channel
+            // that doesn't carry its own per-channel value — re-evaluate
+            // the lot. Per-channel writes still target only the listed ids.
+            const channels = payload.globalValueUpdated
+                ? await em.find(SalesChannel, {})
+                : await em.find(SalesChannel, {
+                    id: { $in: payload.salesChannelIds },
+                });
+            for (const channel of channels) {
+                const enabled = await settingsService.get(SEARCH_SETTING_CODES.LLM_ENABLED, channel.id, booleanSchema);
+                if (enabled) {
+                    // Feature 058 — prefer the credential reference, fall back per
+                    // field to the legacy embedder settings.
+                    const { url, apiKey, model } = await resolveEmbedderConfig(settingsService, channel.id, this.deps.credentials);
+                    if (url && apiKey && model) {
+                        await indexer.attachEmbedderForChannel(channel.code, {
+                            url,
+                            apiKey,
+                            model,
+                        });
+                    }
+                    else {
+                        // Direct generic-Settings write bypassed the toggle
+                        // validator; surface for ops, leave the index alone so
+                        // we don't poison Meilisearch with empty creds.
+                        log(new Error(`LLM enabled on channel ${channel.code} without complete embedder config; embedder NOT attached`), 'settings.value_changed');
+                    }
+                }
+                else {
+                    await indexer.detachEmbedderForChannel(channel.code);
+                }
+            }
+        }
+        catch (err) {
+            log(err, 'settings.value_changed');
+        }
+    }
+}
+function defaultLogger(err, eventName) {
+    console.warn(JSON.stringify({
+        level: 'warn',
+        msg: 'search subscriber handler failed',
+        eventName,
+        error: err instanceof Error ? err.message : String(err),
+    }));
+}
+//# sourceMappingURL=search-event-subscriber.js.map

package/dist/backend/services/search-event-subscriber.js.map

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