@endora-commerce/mod-search 0.100.0

package/dist/manifest.d.ts

@@ -0,0 +1,263 @@
+import { type ModuleCliCommand } from '@endora-commerce/contracts';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+/**
+ * Built-in settings manifest for the search module — feature 006.
+ *
+ * Reserves the `search` group and registers the search knobs
+ * (`data-model.md §2`; embedder credentials via feature 058):
+ *
+ *   1. search.popup.suggestion_count       (number 0..50)
+ *   2. search.popup.minimum_query_length   (number 1..32)
+ *   3. search.llm.enabled                  (boolean)
+ *   4. search.llm.embedder_credentials     (credential_ref → `llm`: Base URL +
+ *                                           API key + model; the single embedder
+ *                                           credential source)
+ *   5. search.reindex_interval_minutes     (number)
+ *   6. search.index_task_timeout_seconds   (number)
+ *
+ * The Settings module's value-type registry only recognises a handful of
+ * primitives (`string`, `number`, `boolean`, `json`, `string_list`) — range
+ * bounds are enforced by the Search module's own LlmToggleService and the
+ * suggest endpoint's parser, not by the manifest.
+ */
+export declare const SEARCH_SETTING_CODES: {
+    readonly POPUP_SUGGESTION_COUNT: "search.popup.suggestion_count";
+    readonly POPUP_MINIMUM_QUERY_LENGTH: "search.popup.minimum_query_length";
+    readonly LLM_ENABLED: "search.llm.enabled";
+    readonly LLM_EMBEDDER_CREDENTIALS: "search.llm.embedder_credentials";
+    readonly REINDEX_INTERVAL_MINUTES: "search.reindex_interval_minutes";
+    readonly INDEX_TASK_TIMEOUT_SECONDS: "search.index_task_timeout_seconds";
+};
+export declare const DEFAULT_POPUP_SUGGESTION_COUNT = 8;
+export declare const DEFAULT_POPUP_MINIMUM_QUERY_LENGTH = 3;
+export declare const DEFAULT_REINDEX_INTERVAL_MINUTES = 10;
+/**
+ * How long the indexer keeps waiting for one Meilisearch task before it gives
+ * up and says so — the default of {@link SEARCH_SETTING_CODES.INDEX_TASK_TIMEOUT_SECONDS}.
+ *
+ * The number this replaces was the `meilisearch` client's own default of 5000
+ * ms, taken by omission at nine of the indexer's twelve waits. It is the wrong
+ * order of magnitude for the thing being waited on, and the reason is that a
+ * task wait is not a measurement of the task: it is
+ * `queue ahead of this task` + `this task's own work`, and Meilisearch's task
+ * queue is global to the instance. Measured on a developer machine, a
+ * one-document write into an empty index expired the 5000 ms wait after 5006 ms
+ * with twelve document batches enqueued ahead of it, and then settled
+ * `succeeded` 10540 ms later. Nothing about that task was slow.
+ *
+ * 120 s is therefore sized for the queue rather than for the corpus, and the
+ * cost of sizing it generously is close to nil: an expired wait does **not**
+ * cancel the Meilisearch task, and a task that genuinely dies comes back
+ * `failed` immediately rather than by timing out. So the only thing a short
+ * value buys is noticing a task that is stuck forever, and the only thing it
+ * costs is aborting a reindex that was going to succeed — in
+ * `reindexChannel`'s case between the wipe and the document push, which leaves
+ * the channel index empty.
+ *
+ * An operator whose catalogue or Meilisearch host makes even this too short
+ * raises the setting; nothing in this repository can know their corpus size or
+ * their index throughput, which is why the number is a Setting and not only
+ * this constant.
+ */
+export declare const DEFAULT_INDEX_TASK_TIMEOUT_SECONDS = 120;
+/** Module-lifecycle manifest (feature 018). */
+export declare const manifest: {
+    id: string;
+    name: string;
+    version: string;
+    dependencies: string[];
+    description?: string | undefined;
+    acknowledgedDependencies?: {
+        moduleId: string;
+        port: string;
+        reason: string;
+    }[] | undefined;
+    nonBindingDependencies?: {
+        moduleId: string;
+        name: string;
+        kind: "contributes-to" | "degrades-without" | "refuses-without";
+        reason: string;
+        whenAbsent?: string | undefined;
+    }[] | undefined;
+    activation?: {
+        settingCode: string;
+        default: boolean;
+    } | {
+        nonDeactivatable: true;
+        reason: string;
+    } | undefined;
+    settings?: {
+        moduleCode: string;
+        groups: {
+            code: string;
+            name: string;
+            salesChannelCodes?: string[] | undefined;
+            isSystemProtected?: boolean | undefined;
+        }[];
+        settings: {
+            code: string;
+            name: string;
+            valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+            defaultValue: unknown;
+            description?: string | undefined;
+            groupCode?: string | undefined;
+            previousDefaultValues?: unknown[] | undefined;
+            salesChannelCodes?: string[] | undefined;
+            enumOptions?: string[] | undefined;
+            configurationType?: string | undefined;
+            hidden?: boolean | undefined;
+        }[];
+    } | undefined;
+    i18n?: {
+        bundlesDir: string;
+    } | undefined;
+    docs?: false | {
+        dir: string;
+    } | undefined;
+    demo?: false | {
+        summary: string;
+        seed: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoSeedResult>;
+        reset: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoResetResult>;
+        after?: readonly string[] | undefined;
+        package?: string | undefined;
+    } | undefined;
+    actions?: {
+        id: string;
+        labelKey: string;
+        icon: "Search" | "Plus" | "Sparkles" | "Settings" | "Boxes" | "Layers" | "Menu" | "PlusCircle" | "PlusSquare" | "FilePlus" | "FolderPlus" | "Upload" | "FileUp" | "CloudUpload" | "Download" | "FileDown" | "FileText" | "BookOpen" | "Rss" | "Package" | "Tag" | "ShoppingCart" | "Receipt" | "CreditCard" | "Users" | "UserPlus" | "Inbox" | "ListChecks" | "ClipboardList" | "Image" | "Video" | "LayoutDashboard" | "PanelLeft" | "KeyRound" | "ShieldCheck" | "Edit" | "Archive" | "Box" | "Truck" | "CircleDollarSign" | "Activity" | "LineChart" | "Smartphone" | "Webhook" | "Scale" | "PlugZap" | "PercentDiamond" | "Newspaper" | "Languages" | "Eraser" | "Warehouse" | "TrendingDown" | "Bell" | "PackageOpen" | "Building2" | "Store" | "ClipboardCheck";
+        targetRoute: string;
+        keywords: string[];
+        weight: number;
+        descriptionKey?: string | undefined;
+        requiredPermission?: string | undefined;
+    }[] | undefined;
+    permissions?: {
+        code: string;
+        label: string;
+        module?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+    }[] | undefined;
+    transactionalEmails?: {
+        code: string;
+        name: string;
+        variables: {
+            key: string;
+            label: string;
+            sampleValue?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    capabilities?: string[] | undefined;
+    exclusiveCapabilities?: {
+        key: string;
+        errorCode: string;
+    }[] | undefined;
+    errorCodes?: {
+        code: string;
+        tokens?: string[] | undefined;
+    }[] | undefined;
+    blocks?: {
+        name: string;
+        labelKey: string;
+        category: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        fields: Record<string, {
+            type: "number" | "object" | "uuid" | "select" | "array" | "external" | "text" | "textarea" | "radio" | "richtext";
+            label?: string | undefined;
+            required?: boolean | undefined;
+            options?: {
+                label: string;
+                value: string | number;
+            }[] | undefined;
+            refKind?: string | undefined;
+        }>;
+        descriptionKey?: string | undefined;
+        defaultProps?: Record<string, unknown> | undefined;
+        responsiveFields?: string[] | undefined;
+        previewIcon?: string | undefined;
+        weight?: number | undefined;
+    }[] | undefined;
+    blockCategories?: {
+        key: string;
+        titleKey: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        weight?: number | undefined;
+        visible?: boolean | undefined;
+    }[] | undefined;
+    env?: {
+        name: string;
+        describes: {
+            en: string;
+            pl: string;
+        };
+        requirement: {
+            kind: "required";
+        } | {
+            kind: "requiredWhen";
+            input: string;
+            equals: string;
+        } | {
+            kind: "optional";
+            without: {
+                en: string;
+                pl: string;
+            };
+        };
+        secret: boolean;
+        generable: boolean;
+        owner: {
+            kind: "platform";
+        } | {
+            kind: "application";
+            application: "admin" | "backend" | "storefront";
+        } | {
+            kind: "module";
+            moduleId: string;
+        };
+        consumers: ("admin" | "backend" | "storefront")[];
+        addressOf: "admin" | "backend" | "storefront" | null;
+    }[] | undefined;
+};
+/** Legacy export retained for backward compatibility. */
+export declare const searchManifest: {
+    moduleCode: string;
+    groups: {
+        code: string;
+        name: string;
+        salesChannelCodes?: string[] | undefined;
+        isSystemProtected?: boolean | undefined;
+    }[];
+    settings: {
+        code: string;
+        name: string;
+        valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+        defaultValue: unknown;
+        description?: string | undefined;
+        groupCode?: string | undefined;
+        previousDefaultValues?: unknown[] | undefined;
+        salesChannelCodes?: string[] | undefined;
+        enumOptions?: string[] | undefined;
+        configurationType?: string | undefined;
+        hidden?: boolean | undefined;
+    }[];
+};
+/**
+ * The operator command this module declares — feature 080, T042b / D-160.9.
+ *
+ * It was `scripts/reindex.ts`, which hand-built a second `SearchIndexer` out of
+ * five services owned by `catalog` and `custom_fields`. The body is
+ * `await import()`ed because this file is imported by the generated manifest
+ * index, and through it by every static check script and by
+ * `src/db/configured-migrations.ts`; a static import of the indexer would pull a
+ * Meilisearch client into all of them.
+ *
+ * `search` is switchable (`search.enabled` above), so this is also the command
+ * that shows what the host does with a switched-off module's declaration: the
+ * runner asks `requireModuleEnabled('search')` before it builds a context, and
+ * the command does not run.
+ */
+export declare const cliCommands: ReadonlyArray<ModuleCliCommand<ModuleContext>>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB;;;;;;;CAUvB,CAAC;AAEX,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,kCAAkC,IAAI,CAAC;AACpD,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,kCAAkC,MAAM,CAAC;AA+EtD,+CAA+C;AAC/C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6InB,CAAC;AAEH,yDAAyD;AACzD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;CAAW,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAMtE,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,300 @@
+import { defineModuleManifest, defineModuleSettingsManifest, } from '@endora-commerce/contracts';
+/**
+ * Built-in settings manifest for the search module — feature 006.
+ *
+ * Reserves the `search` group and registers the search knobs
+ * (`data-model.md §2`; embedder credentials via feature 058):
+ *
+ *   1. search.popup.suggestion_count       (number 0..50)
+ *   2. search.popup.minimum_query_length   (number 1..32)
+ *   3. search.llm.enabled                  (boolean)
+ *   4. search.llm.embedder_credentials     (credential_ref → `llm`: Base URL +
+ *                                           API key + model; the single embedder
+ *                                           credential source)
+ *   5. search.reindex_interval_minutes     (number)
+ *   6. search.index_task_timeout_seconds   (number)
+ *
+ * The Settings module's value-type registry only recognises a handful of
+ * primitives (`string`, `number`, `boolean`, `json`, `string_list`) — range
+ * bounds are enforced by the Search module's own LlmToggleService and the
+ * suggest endpoint's parser, not by the manifest.
+ */
+export const SEARCH_SETTING_CODES = {
+    POPUP_SUGGESTION_COUNT: 'search.popup.suggestion_count',
+    POPUP_MINIMUM_QUERY_LENGTH: 'search.popup.minimum_query_length',
+    LLM_ENABLED: 'search.llm.enabled',
+    // Feature 058 — the single embedder credential source: a reusable `llm`
+    // credential configuration supplying the embedder URL (Base URL), API key and
+    // model.
+    LLM_EMBEDDER_CREDENTIALS: 'search.llm.embedder_credentials',
+    REINDEX_INTERVAL_MINUTES: 'search.reindex_interval_minutes',
+    INDEX_TASK_TIMEOUT_SECONDS: 'search.index_task_timeout_seconds',
+};
+export const DEFAULT_POPUP_SUGGESTION_COUNT = 8;
+export const DEFAULT_POPUP_MINIMUM_QUERY_LENGTH = 3;
+export const DEFAULT_REINDEX_INTERVAL_MINUTES = 10;
+/**
+ * How long the indexer keeps waiting for one Meilisearch task before it gives
+ * up and says so — the default of {@link SEARCH_SETTING_CODES.INDEX_TASK_TIMEOUT_SECONDS}.
+ *
+ * The number this replaces was the `meilisearch` client's own default of 5000
+ * ms, taken by omission at nine of the indexer's twelve waits. It is the wrong
+ * order of magnitude for the thing being waited on, and the reason is that a
+ * task wait is not a measurement of the task: it is
+ * `queue ahead of this task` + `this task's own work`, and Meilisearch's task
+ * queue is global to the instance. Measured on a developer machine, a
+ * one-document write into an empty index expired the 5000 ms wait after 5006 ms
+ * with twelve document batches enqueued ahead of it, and then settled
+ * `succeeded` 10540 ms later. Nothing about that task was slow.
+ *
+ * 120 s is therefore sized for the queue rather than for the corpus, and the
+ * cost of sizing it generously is close to nil: an expired wait does **not**
+ * cancel the Meilisearch task, and a task that genuinely dies comes back
+ * `failed` immediately rather than by timing out. So the only thing a short
+ * value buys is noticing a task that is stuck forever, and the only thing it
+ * costs is aborting a reindex that was going to succeed — in
+ * `reindexChannel`'s case between the wipe and the document push, which leaves
+ * the channel index empty.
+ *
+ * An operator whose catalogue or Meilisearch host makes even this too short
+ * raises the setting; nothing in this repository can know their corpus size or
+ * their index throughput, which is why the number is a Setting and not only
+ * this constant.
+ */
+export const DEFAULT_INDEX_TASK_TIMEOUT_SECONDS = 120;
+const settings = defineModuleSettingsManifest({
+    moduleCode: 'search',
+    groups: [
+        {
+            code: 'search',
+            name: 'Search',
+        },
+    ],
+    settings: [
+        {
+            // Feature 073 — the operator's activation control. Platform-wide.
+            code: 'search.enabled',
+            name: 'Search enabled',
+            description: 'Switches product search on or off: the storefront typeahead popup and result feed, the search-phrase analytics ingest, the admin LLM and reindex screens, and the catalogue indexer that keeps Meilisearch in step with product changes. Nothing is dropped — the indexes, the recorded phrases and the LLM configuration stay, and a reindex after switching back restores what changed while it was off.',
+            groupCode: 'search',
+            valueType: 'boolean',
+            defaultValue: true,
+        },
+        {
+            code: SEARCH_SETTING_CODES.POPUP_SUGGESTION_COUNT,
+            name: 'Suggestion popup — result count',
+            description: 'How many products the storefront shows in the typeahead popup. Set to 0 to suppress the popup; the explicit "Search" action still works.',
+            groupCode: 'search',
+            valueType: 'number',
+            defaultValue: DEFAULT_POPUP_SUGGESTION_COUNT,
+        },
+        {
+            code: SEARCH_SETTING_CODES.POPUP_MINIMUM_QUERY_LENGTH,
+            name: 'Suggestion popup — minimum query length',
+            description: 'How many characters the customer must type before the typeahead popup is requested. Below the threshold the storefront fires no request and the analytics-record endpoint silently no-ops.',
+            groupCode: 'search',
+            valueType: 'number',
+            defaultValue: DEFAULT_POPUP_MINIMUM_QUERY_LENGTH,
+        },
+        {
+            code: SEARCH_SETTING_CODES.LLM_ENABLED,
+            name: 'LLM-augmented search — enabled',
+            description: 'When on, Meilisearch runs hybrid lexical + semantic search using the configured embedder. Enabling this requires the three embedder.* values below to be non-empty.',
+            groupCode: 'search',
+            valueType: 'boolean',
+            defaultValue: false,
+        },
+        {
+            code: SEARCH_SETTING_CODES.LLM_EMBEDDER_CREDENTIALS,
+            name: 'LLM-augmented search — embedder credentials',
+            description: 'Reference a reusable LLM credential configuration (Credentials screen). Its Base URL, API Key and Model provide the embedder endpoint, credential and model. Required to enable LLM-augmented search.',
+            groupCode: 'search',
+            valueType: 'credential_ref',
+            configurationType: 'llm',
+            defaultValue: '',
+        },
+        {
+            code: SEARCH_SETTING_CODES.REINDEX_INTERVAL_MINUTES,
+            name: 'Product reindex interval (minutes)',
+            description: 'How often the background worker rebuilds every sales-channel Meilisearch index so the catalogue stays in sync. Set to 0 to disable the periodic sweep — manual reindexing from the admin remains available.',
+            groupCode: 'search',
+            valueType: 'number',
+            defaultValue: DEFAULT_REINDEX_INTERVAL_MINUTES,
+        },
+        {
+            code: SEARCH_SETTING_CODES.INDEX_TASK_TIMEOUT_SECONDS,
+            name: 'Index task timeout (seconds)',
+            description: 'How long to wait for one Meilisearch indexing task before reporting that it is still running. Raise it if reindexing a large catalogue, or a Meilisearch instance shared with other work, reports that a task is still running: the wait covers the instance-wide task queue as well as the work itself, and giving up early does not cancel the task. Lower it only to be told sooner that indexing has stopped moving.',
+            groupCode: 'search',
+            valueType: 'number',
+            defaultValue: DEFAULT_INDEX_TASK_TIMEOUT_SECONDS,
+        },
+    ],
+});
+/** Module-lifecycle manifest (feature 018). */
+export const manifest = defineModuleManifest({
+    id: 'search',
+    name: 'Search',
+    description: 'Per-channel Meilisearch indexes, suggest popup, and optional LLM-augmented search.',
+    version: '1.0.0',
+    /**
+     * What this module needs from the environment (`specs/117-instance-bring-up/`
+     * FR-002). Only what it **owns**: its reads of platform-owned names are
+     * satisfied by `packages/platform/src/env/index.ts`.
+     *
+     * Why each of these is not a Setting is its entry in
+     * `backend/scripts/ledgers/module-environment-inputs/search.ts`.
+     *
+     * `MEILISEARCH_URL` is **not** here, and its absence is the rule working
+     * rather than an omission. D-229 moved the liveness probe into the platform,
+     * and the probe reads that address — so the platform declares it, and
+     * `module-declares-a-platform-input` refuses a second description of one
+     * variable (D-100). This module still reads it; a read resolves against the
+     * platform's declaration as well as its own.
+     */
+    env: [
+        {
+            name: 'MEILISEARCH_API_KEY',
+            describes: {
+                en: 'The key this instance presents to Meilisearch.',
+                pl: 'Klucz, którym ta instancja uwierzytelnia się w Meilisearch.',
+            },
+            requirement: {
+                kind: 'optional',
+                without: {
+                    en: 'Meilisearch is addressed with no key, which works only against a server that has none — and such a server can be read and rewritten by anything that can reach it.',
+                    pl: 'Meilisearch jest odpytywany bez klucza, co działa tylko wobec serwera, który go nie ma — a taki serwer może odczytać i nadpisać wszystko, co zdoła się z nim połączyć.',
+                },
+            },
+            secret: true,
+            generable: false,
+            owner: { kind: 'module', moduleId: 'search' },
+            consumers: ['backend'],
+            addressOf: null,
+        },
+    ],
+    // Feature 075, Phase C — `organizations` joins the five that were already
+    // here. The typeahead's price resolution needs the buyer's organisation, and
+    // this module used to read that row with `em.findOne(Organization, …)`; it
+    // now resolves `organizationDetailsPort`, and an undeclared port edge is a
+    // build failure rather than a silent one.
+    dependencies: [
+        'catalog',
+        'credentials',
+        'organizations',
+        'price_lists',
+        'sales_channels',
+        'settings',
+    ],
+    settings,
+    activation: { settingCode: 'search.enabled', default: true },
+    /**
+     * Feature 090, Phase 3 — the error codes this module owns.
+     *
+     * The list is the incumbent prefix chain's *answer* for `search`, copied from
+     * the frozen capture at `backend/test/fixtures/error-code-routing/chain-answers.ts`
+     * (`grep -oE "^  [A-Z0-9_]+: 'search'," …`). It is a transcription, not a
+     * judgement: the migration is answer-preserving over all 289 codes and
+     * re-routing is out of scope (`specs/090-module-owned-error-codes/` §6.2, §6.5).
+     *
+     * **Trap T1 does not bite here, and that was measured rather than assumed.**
+     * The chain answers `search` from three prefixes — `QUERY_`, `SEARCH_`,
+     * `PHRASE_` — plus a three-member `SEARCH_MISC_ERROR_CODES` set. Every code in
+     * the enumeration carrying one of those prefixes routes here (five of them),
+     * no earlier rule shadows any of them, and all three misc members survive to
+     * this rule. So reading the chain's source would have given the same eight as
+     * reading its answer. `inventory` and `assets_library` are where it does bite;
+     * this module is the case where the two agree, which is worth recording so the
+     * next reader knows the question was asked.
+     *
+     * **Six of the eight are codes a reader would attribute to `core`.**
+     * `LIMIT_OUT_OF_RANGE`, `PHRASE_REQUIRED`, `PHRASE_TOO_LONG`, `QUERY_TOO_LONG`,
+     * `QUERY_TOO_SHORT` and `RESULT_COUNT_INVALID` carry no `SEARCH_` prefix and
+     * read as generic request-validation refusals; only `SEARCH_BACKEND_UNAVAILABLE`
+     * and `LLM_CONFIG_INCOMPLETE` name this module's domain. They belong here
+     * because `routes.public.ts` hand-parses `?q=&limit=` precisely to avoid the
+     * generic `VALIDATION_FAILED` — its own comment says so — and nothing else in
+     * `packages`, `backend/src`, `admin/src` or `storefront/src` names any of the
+     * six. Do not read the plain names as a routing accident; they are this
+     * module's refusals wearing generic clothes.
+     *
+     * **The inverse is the larger half: this package raises three codes it does
+     * not own, and one of the three is recorded nowhere else.** `routes.public.ts`
+     * raises `sales_channels`' `MISSING_SALES_CHANNEL_CONTEXT` (which
+     * `sales_channels` recorded in !1128), `llm-toggle.service.ts` raises
+     * `settings`' `SETTING_OUT_OF_SCOPE_FOR_CHANNEL` (which `settings` recorded in
+     * !1133), and `search-query.service.ts` raises `catalog`'s
+     * `FILTER_NOT_ALLOWED` when a requested facet is not a filterable attribute —
+     * `catalog` declared that code in !1117 and named no thrower, so this is the
+     * first record of it. All three are the D-95.2 rule seen from the thrower's
+     * side: routing follows the domain noun, and a channel, a setting scope and an
+     * attribute's filterability are not search nouns. None is declared here.
+     *
+     * **No code is raised by nothing.** All eight have a live raise site. This
+     * package throws `HttpError` ten times; seven of the ten raise one of these
+     * eight (six in `routes.public.ts`, one in `llm-toggle.service.ts`) and the
+     * other three are the foreign codes above — so it contributes nothing to the
+     * register entry that splits unraised codes by kind, in any of its five. Three
+     * of the eight reach the `throw` through a computed local rather than at the
+     * call: `routes.public.ts` picks `PHRASE_TOO_LONG` / `RESULT_COUNT_INVALID` /
+     * `PHRASE_REQUIRED` into a `const code` from the first Zod issue and throws
+     * that, and all three branches are reachable under
+     * `RecordPhraseRequestSchema`. The route carrying them is mounted
+     * unconditionally by `plugin.ts`, so the reachability question the register's
+     * fifth kind asks — is there an HTTP door — answers yes for every one.
+     *
+     * Both spellings were searched, which trap T12 asks for: `ERROR_CODES.<CODE>`
+     * and the bare quoted literal, over `packages`, `backend/src`, `admin/src` and
+     * `storefront/src`. Outside the enumeration in `@endora-commerce/contracts`,
+     * the chain's own `SEARCH_MISC_ERROR_CODES` set and this declaration, every
+     * occurrence is one of those seven raise sites.
+     *
+     * No `tokens`, derived rather than assumed. `refusalToken`
+     * (`packages/platform/src/http/error-envelope.ts`) reads `details.code` and
+     * nothing else; all seven raise sites were read, and the six that pass a
+     * fourth argument all pass the Zod-style `Array<{ path, issue }>`, which
+     * `refusalToken` returns `null` for by construction. The runbook's §5
+     * raise-site scan attributes the tree's ten token-carrying codes over 41 sites
+     * to `core`, `invoices` and `carts` and names none of these, and in the other
+     * direction the module's own bundles hold eight `errors.<CODE>` sentences and
+     * no `errors.<CODE>.<token>` key.
+     */
+    errorCodes: [
+        { code: 'LIMIT_OUT_OF_RANGE' },
+        { code: 'LLM_CONFIG_INCOMPLETE' },
+        { code: 'PHRASE_REQUIRED' },
+        { code: 'PHRASE_TOO_LONG' },
+        { code: 'QUERY_TOO_LONG' },
+        { code: 'QUERY_TOO_SHORT' },
+        { code: 'RESULT_COUNT_INVALID' },
+        { code: 'SEARCH_BACKEND_UNAVAILABLE' },
+    ],
+    i18n: { bundlesDir: 'i18n' },
+    docs: { dir: 'docs' },
+    permissions: [{ code: 'search:write', label: 'Configure search (LLM / indexing)' }],
+});
+/** Legacy export retained for backward compatibility. */
+export const searchManifest = settings;
+/**
+ * The operator command this module declares — feature 080, T042b / D-160.9.
+ *
+ * It was `scripts/reindex.ts`, which hand-built a second `SearchIndexer` out of
+ * five services owned by `catalog` and `custom_fields`. The body is
+ * `await import()`ed because this file is imported by the generated manifest
+ * index, and through it by every static check script and by
+ * `src/db/configured-migrations.ts`; a static import of the indexer would pull a
+ * Meilisearch client into all of them.
+ *
+ * `search` is switchable (`search.enabled` above), so this is also the command
+ * that shows what the host does with a switched-off module's declaration: the
+ * runner asks `requireModuleEnabled('search')` before it builds a context, and
+ * the command does not run.
+ */
+export const cliCommands = [
+    {
+        name: 'reindex',
+        summary: "Rebuild every sales channel's Meilisearch index from PostgreSQL.",
+        run: async (context) => (await import('./backend/cli/reindex.js')).reindex(context),
+    },
+];
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/migrations/20260501T123145_search_phrase_records_init.d.ts

@@ -0,0 +1,13 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Search phrase records — feature 006 / T034 / data-model.md §1.1.
+ *
+ * Single-table migration owned by the search module. The table is
+ * append-only; analytics aggregations slice it by sales_channel +
+ * normalized phrase + time window.
+ */
+export declare class Migration20260501T123145SearchPhraseRecordsInit extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260501T123145_search_phrase_records_init.d.ts.map

package/dist/migrations/20260501T123145_search_phrase_records_init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260501T123145_search_phrase_records_init.d.ts","sourceRoot":"","sources":["../../src/migrations/20260501T123145_search_phrase_records_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;GAMG;AACH,qBAAa,+CAAgD,SAAQ,SAAS;IAC7D,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/dist/migrations/20260501T123145_search_phrase_records_init.js

@@ -0,0 +1,40 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Search phrase records — feature 006 / T034 / data-model.md §1.1.
+ *
+ * Single-table migration owned by the search module. The table is
+ * append-only; analytics aggregations slice it by sales_channel +
+ * normalized phrase + time window.
+ */
+export class Migration20260501T123145SearchPhraseRecordsInit extends Migration {
+    async up() {
+        this.addSql(`
+      create table "search_phrase_records" (
+        "id" uuid not null,
+        "phrase" varchar(512) not null,
+        "phrase_normalized" varchar(512) not null,
+        "sales_channel_id" uuid not null,
+        "result_count" integer not null,
+        "recorded_at" timestamptz not null default now(),
+        constraint "search_phrase_records_pkey" primary key ("id"),
+        constraint "search_phrase_records_sales_channel_fk"
+          foreign key ("sales_channel_id") references "sales_channels" ("id")
+          on delete restrict
+      );
+    `);
+        // Aggregation query: phrases by channel and frequency over a window.
+        this.addSql(`
+      create index "idx_search_phrase_records_aggr"
+        on "search_phrase_records" ("sales_channel_id", "phrase_normalized", "recorded_at" desc);
+    `);
+        // Ops dashboards / "most-recent searches".
+        this.addSql(`
+      create index "idx_search_phrase_records_recent"
+        on "search_phrase_records" ("recorded_at" desc);
+    `);
+    }
+    async down() {
+        this.addSql('drop table if exists "search_phrase_records" cascade;');
+    }
+}
+//# sourceMappingURL=20260501T123145_search_phrase_records_init.js.map

package/dist/migrations/20260501T123145_search_phrase_records_init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260501T123145_search_phrase_records_init.js","sourceRoot":"","sources":["../../src/migrations/20260501T123145_search_phrase_records_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,OAAO,+CAAgD,SAAQ,SAAS;IACnE,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;KAaX,CAAC,CAAC;QAEH,qEAAqE;QACrE,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,2CAA2C;QAC3C,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,uDAAuD,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which is the order of this module's own
+ * migrations and of nothing else (feature 081): a manifest `dependencies` array
+ * is the only thing ordering this block against another module's.
+ *
+ * The **named** exports stay beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports each class by name
+ * from this specifier, and a migration class name is contract in a way an entity
+ * class name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created.
+ */
+import { Migration20260501T123145SearchPhraseRecordsInit } from './20260501T123145_search_phrase_records_init.js';
+export declare const migrations: (typeof Migration20260501T123145SearchPhraseRecordsInit)[];
+export { Migration20260501T123145SearchPhraseRecordsInit, };
+//# sourceMappingURL=index.d.ts.map