@endora-commerce/mod-search 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
+
+# @endora-commerce/mod-search
+
+Per-channel Meilisearch indexes, suggest popup, and optional LLM-augmented search.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `search` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-search` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-search/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-search/migrations` | the module’s own schema migrations, in the order the platform runs them |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/contracts`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+- `meilisearch` ^0
+- `zod` ^4
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `i18n/` — the translation bundles this package ships (`en`, `pl`), loaded by the platform
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-search
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/backend/cli/reindex.d.ts

@@ -0,0 +1,4 @@
+import type { ModuleCliCommandContext } from '@endora-commerce/contracts';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+export declare function reindex({ ctx, out, }: ModuleCliCommandContext<ModuleContext>): Promise<number>;
+//# sourceMappingURL=reindex.d.ts.map

package/dist/backend/cli/reindex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reindex.d.ts","sourceRoot":"","sources":["../../../src/backend/cli/reindex.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAStE,wBAAsB,OAAO,CAAC,EAC5B,GAAG,EACH,GAAG,GACJ,EAAE,uBAAuB,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAgC1D"}

package/dist/backend/cli/reindex.js

@@ -0,0 +1,32 @@
+export async function reindex({ ctx, out, }) {
+    // A cradle read and **not** `lazyPort<SearchModuleHandle>(ctx, 'searchHandle')`,
+    // which compiles and then fails at runtime with
+    // `handle.indexer.reindexAllChannels is not a function`. `lazyPort` returns a
+    // proxy that answers *every* property with a function so it can forward a
+    // method call — the same property that makes optional methods impossible
+    // through a port (D-97.3) — so a nested reach like `handle.indexer` gets a
+    // function rather than the indexer. `searchHandle` is this module's own name,
+    // so a cradle read crosses no boundary and hides no edge from
+    // `check:port-dependencies`; presence for this module was decided by the host
+    // before this body ran.
+    //
+    // `reindexAllChannels` rather than `searchReindexPort.reindexAll` because the
+    // per-channel breakdown below is what an operator runs this for, and the port
+    // returns one total. Both run over the same indexer.
+    const cradle = ctx.cradle();
+    const results = await cradle.searchHandle.indexer.reindexAllChannels(cradle.emFactory());
+    out('');
+    out('=== Search reindex complete ===');
+    if (results.length === 0) {
+        out('No Sales Channels found — run seed:dev first.');
+    }
+    else {
+        for (const r of results) {
+            out(`  ${r.channelCode.padEnd(16)} → ${r.indexUid.padEnd(28)} ` +
+                `(${r.documentCount} document${r.documentCount === 1 ? '' : 's'})`);
+        }
+    }
+    out('');
+    return 0;
+}
+//# sourceMappingURL=reindex.js.map

package/dist/backend/cli/reindex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reindex.js","sourceRoot":"","sources":["../../../src/backend/cli/reindex.ts"],"names":[],"mappings":"AA6CA,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAC5B,GAAG,EACH,GAAG,GACoC;IACvC,iFAAiF;IACjF,gDAAgD;IAChD,8EAA8E;IAC9E,0EAA0E;IAC1E,yEAAyE;IACzE,2EAA2E;IAC3E,8EAA8E;IAC9E,8DAA8D;IAC9D,8EAA8E;IAC9E,wBAAwB;IACxB,EAAE;IACF,8EAA8E;IAC9E,8EAA8E;IAC9E,qDAAqD;IACrD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAuB,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAEzF,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,GAAG,CAAC,iCAAiC,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,+CAA+C,CAAC,CAAC;IACvD,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,GAAG,CACD,KAAK,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG;gBACzD,IAAI,CAAC,CAAC,aAAa,YAAY,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CACrE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/backend/entities/search-phrase-record.entity.d.ts

@@ -0,0 +1,40 @@
+import { OptionalProps } from '@mikro-orm/core';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+/**
+ * SearchPhraseRecord — feature 006 / US3 / data-model.md §1.1.
+ *
+ * One row per committed search (Enter / "Search" action). Append-only
+ * dataset consumed by the future Analytics module to surface popular
+ * phrases, dead-end phrases, and frequency trends.
+ *
+ * Storage rules:
+ *   - `phrase` is verbatim — no typo correction or LLM expansion (FR-013).
+ *   - `phrase_normalized` is `lower(trim(phrase))`, maintained at insert
+ *     time; supports case-insensitive aggregation without rewriting the
+ *     verbatim phrase.
+ *   - `result_count` reflects the size of the result set the customer
+ *     actually saw; `0` is recorded for dead-end phrases (FR-014).
+ *   - FK to `sales_channels.id` is RESTRICT, not CASCADE: removing a
+ *     sales channel must surface as a manual decision, not silently
+ *     delete history.
+ *
+ * Threshold no-op: callers (the `/api/v1/search/record` route + the
+ * SearchPhraseRecorder service) refuse to insert when the trimmed
+ * phrase length is below the channel's `search.popup.minimum_query_length`
+ * setting. The threshold check is the recorder's job, not the entity's.
+ */
+export declare class SearchPhraseRecord {
+    [OptionalProps]?: 'id' | 'recordedAt';
+    id: string;
+    phrase: string;
+    /**
+     * `lower(trim(phrase))` — populated by the recorder service before
+     * persistAndFlush. Indexed by `(sales_channel_id, phrase_normalized,
+     * recorded_at DESC)` for the analytics aggregation query.
+     */
+    phraseNormalized: string;
+    salesChannel: SalesChannel;
+    resultCount: number;
+    recordedAt: Date;
+}
+//# sourceMappingURL=search-phrase-record.entity.d.ts.map

package/dist/backend/entities/search-phrase-record.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-phrase-record.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/search-phrase-record.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,aAAa,EAGd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAEa,kBAAkB;IAC7B,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,YAAY,CAAC;IAGtC,EAAE,EAAE,MAAM,CAAgB;IAG1B,MAAM,EAAG,MAAM,CAAC;IAEhB;;;;OAIG;IAEH,gBAAgB,EAAG,MAAM,CAAC;IAI1B,YAAY,EAAG,YAAY,CAAC;IAG5B,WAAW,EAAG,MAAM,CAAC;IAOrB,UAAU,EAAE,IAAI,CAAc;CAC/B"}

package/dist/backend/entities/search-phrase-record.entity.js

@@ -0,0 +1,85 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, ManyToOne, OptionalProps, PrimaryKey, Property, } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+/**
+ * SearchPhraseRecord — feature 006 / US3 / data-model.md §1.1.
+ *
+ * One row per committed search (Enter / "Search" action). Append-only
+ * dataset consumed by the future Analytics module to surface popular
+ * phrases, dead-end phrases, and frequency trends.
+ *
+ * Storage rules:
+ *   - `phrase` is verbatim — no typo correction or LLM expansion (FR-013).
+ *   - `phrase_normalized` is `lower(trim(phrase))`, maintained at insert
+ *     time; supports case-insensitive aggregation without rewriting the
+ *     verbatim phrase.
+ *   - `result_count` reflects the size of the result set the customer
+ *     actually saw; `0` is recorded for dead-end phrases (FR-014).
+ *   - FK to `sales_channels.id` is RESTRICT, not CASCADE: removing a
+ *     sales channel must surface as a manual decision, not silently
+ *     delete history.
+ *
+ * Threshold no-op: callers (the `/api/v1/search/record` route + the
+ * SearchPhraseRecorder service) refuse to insert when the trimmed
+ * phrase length is below the channel's `search.popup.minimum_query_length`
+ * setting. The threshold check is the recorder's job, not the entity's.
+ */
+let SearchPhraseRecord = class SearchPhraseRecord {
+    [OptionalProps];
+    id = randomUUID();
+    phrase;
+    /**
+     * `lower(trim(phrase))` — populated by the recorder service before
+     * persistAndFlush. Indexed by `(sales_channel_id, phrase_normalized,
+     * recorded_at DESC)` for the analytics aggregation query.
+     */
+    phraseNormalized;
+    salesChannel;
+    resultCount;
+    recordedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], SearchPhraseRecord.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'string', length: 512 }),
+    __metadata("design:type", String)
+], SearchPhraseRecord.prototype, "phrase", void 0);
+__decorate([
+    Property({ type: 'string', length: 512, fieldName: 'phrase_normalized' }),
+    __metadata("design:type", String)
+], SearchPhraseRecord.prototype, "phraseNormalized", void 0);
+__decorate([
+    ManyToOne(() => SalesChannel, { fieldName: 'sales_channel_id' }),
+    Index(),
+    __metadata("design:type", SalesChannel)
+], SearchPhraseRecord.prototype, "salesChannel", void 0);
+__decorate([
+    Property({ type: 'integer', fieldName: 'result_count' }),
+    __metadata("design:type", Number)
+], SearchPhraseRecord.prototype, "resultCount", void 0);
+__decorate([
+    Property({
+        type: 'datetime',
+        onCreate: () => new Date(),
+        fieldName: 'recorded_at',
+    }),
+    __metadata("design:type", Date)
+], SearchPhraseRecord.prototype, "recordedAt", void 0);
+SearchPhraseRecord = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'search_phrase_records' })
+], SearchPhraseRecord);
+export { SearchPhraseRecord };
+//# sourceMappingURL=search-phrase-record.entity.js.map

package/dist/backend/entities/search-phrase-record.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-phrase-record.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/search-phrase-record.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EACL,MAAM,EACN,KAAK,EACL,SAAS,EACT,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,CAAC,aAAa,CAAC,CAAuB;IAGtC,EAAE,GAAW,UAAU,EAAE,CAAC;IAG1B,MAAM,CAAU;IAEhB;;;;OAIG;IAEH,gBAAgB,CAAU;IAI1B,YAAY,CAAgB;IAG5B,WAAW,CAAU;IAOrB,UAAU,GAAS,IAAI,IAAI,EAAE,CAAC;CAC/B,CAAA;AA1BC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;8CACH;AAG1B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;kDAC1B;AAQhB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;;4DAChD;AAI1B;IAFC,SAAS,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChE,KAAK,EAAE;8BACO,YAAY;wDAAC;AAG5B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;;uDACpC;AAOrB;IALC,QAAQ,CAAC;QACR,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;QAC1B,SAAS,EAAE,aAAa;KACzB,CAAC;8BACU,IAAI;sDAAc;AA7BnB,kBAAkB;IAF9B,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,uBAAuB,EAAE,CAAC;GAClC,kBAAkB,CA8B9B"}

package/dist/backend/index.d.ts

@@ -0,0 +1,87 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import type { SuggestionPriceResolverPort } from './services/suggestion-pricing-enricher.js';
+import { type SearchModuleOptions, type SearchModuleResult } from './plugin.js';
+import { SearchPhraseRecord } from './entities/search-phrase-record.entity.js';
+/**
+ * `search` — six optional options that were never actually optional (feature
+ * 072, wave 2, T123).
+ *
+ * `settingsService`, `settingsAdminService`, `requireAdmin`, `credentials`,
+ * `resolveAdminAuditContext` and `enrichSuggestionPricing` were all declared
+ * optional, and both composition roots passed all six. Their absence did not
+ * fail — it silently produced a lesser module: manifest-default suggestion
+ * limits, no `settings.value_changed` → embedder reactor, no admin routes at
+ * all, and a typeahead popup showing list prices to a customer on a price list.
+ * The comment on `settingsService` said it was for "foundation tests that
+ * predate Settings"; no such caller existed. They are required now.
+ *
+ * `resolveReindexIntervalMinutes` is deleted rather than converted. It read
+ * `search.reindex_interval_minutes` — this module's own setting — and fell back
+ * to this module's own manifest default, in a root, so the module "isn't
+ * coupled to the settings read API". It resolves a settings port already; the
+ * indirection bought nothing and put a module's configuration in a composition.
+ *
+ * `enableReindexScheduler` stays root-supplied, and that is the opposite call
+ * for a reason that has now bitten three conversions: the harness genuinely has
+ * no worker role, and deriving it from `BACKEND_ROLE` here would start a
+ * periodic Meilisearch sweep in every one of ~225 test files. Which process
+ * runs consumers is a deployment decision (Principle X); which setting drives
+ * their cadence is the module's.
+ *
+ * **`searchReindexPort` came home in T143a cluster 6.** `catalog` runs a full
+ * reindex as a `search_reindex` bulk operation when an attribute's `searchable`
+ * flag flips, and production built a **second** `SearchIndexer` inside a root
+ * closure to do it — while `searchModule` was building its own two lines away.
+ * That is the `inventory` finding of cluster 2 in a second module: two
+ * instances of one service, neither required to agree with the other, and the
+ * root's one ungated, so it kept reindexing with `search` switched off.
+ */
+/** What `search` resolves from the container, and the names it owns. */
+export interface SearchCradle {
+    readonly emFactory: () => EntityManager;
+    readonly requireAdmin: RequireAdminFactory;
+    readonly settingsReadPort: SearchModuleOptions['settingsService'];
+    readonly settingsAdminService: SearchModuleOptions['settingsAdminService'];
+    readonly credentialsService: SearchModuleOptions['credentials'];
+    readonly adminAuditActorResolver: SearchModuleOptions['resolveAdminAuditContext'];
+    readonly catalogAttributeReadPort: SearchModuleOptions['catalogAttributeRead'];
+    /** `price_lists`' resolver, narrowed to what a suggestion needs. */
+    readonly pricingService: SuggestionPriceResolverPort;
+    /**
+     * Whether this composition runs the periodic reindex sweep (Principle X).
+     * Root-supplied rather than env-derived: the test harness runs no sweep, and
+     * a module should not have to know which of its callers is a test.
+     */
+    readonly searchRunWorkers: boolean;
+    readonly search: SearchModuleResult;
+    readonly searchHandle: SearchModuleResult['handle'];
+    /**
+     * A full reindex of every sales-channel index, as the `search:reindex` CLI
+     * and the admin "Reindex products" button run it (T143a).
+     *
+     * The document count is the whole answer a caller needs — `catalog` reports
+     * it on the bulk operation — so the port hands back that rather than the
+     * per-channel summaries, and no consumer has to know an index uid exists.
+     */
+    readonly searchReindexPort: {
+        reindexAll(): Promise<{
+            documentCount: number;
+        }>;
+    };
+}
+export declare function registerModule(ctx: ModuleContext): void;
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export declare const entities: (typeof SearchPhraseRecord)[];
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAS3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAI5E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,EAAgB,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IAClE,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,sBAAsB,CAAC,CAAC;IAC3E,QAAQ,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAChE,QAAQ,CAAC,uBAAuB,EAAE,mBAAmB,CAAC,0BAA0B,CAAC,CAAC;IAClF,QAAQ,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,sBAAsB,CAAC,CAAC;IAC/E,oEAAoE;IACpE,QAAQ,CAAC,cAAc,EAAE,2BAA2B,CAAC;IACrD;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACpD;;;;;;;OAOG;IACH,QAAQ,CAAC,iBAAiB,EAAE;QAAE,UAAU,IAAI,OAAO,CAAC;YAAE,aAAa,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAClF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAuKvD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,+BAEpB,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,153 @@
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { createSearchQueryPort } from './services/search-query-port.js';
+import { createSuggestionPricingEnricher } from './services/suggestion-pricing-enricher.js';
+import { searchModule } from './plugin.js';
+import { SearchPhraseRecord } from './entities/search-phrase-record.entity.js';
+export function registerModule(ctx) {
+    ctx.di.register({
+        search: ctx
+            .asFunction(({ emFactory, searchRunWorkers }) => searchModule({
+            emFactory,
+            enableReindexScheduler: searchRunWorkers,
+            catalogAttributeRead: lazyPort(ctx, 'catalogAttributeReadPort'),
+            // Feature 075, Phase C — the indexer's product rows. It read them
+            // with `em.find(Product, …)` against `catalog`'s table, which no gate
+            // can see; over the port the read answers 503 when `catalog` is off,
+            // which is the binding dependency this manifest already declares.
+            catalogProducts: lazyPort(ctx, 'catalogProductReadPort'),
+            // Feature 075 / D-87 — the last two boundary crossings the indexer
+            // made in raw SQL: `catalog`'s `product_categories` / `categories`
+            // join, and the `sales_channel_products` bridge Principle XII
+            // reserves for the membership accessor. A statement names no import
+            // specifier, so neither was visible to Phase C.
+            catalogCategories: lazyPort(ctx, 'catalogCategoryReadPort'),
+            salesChannelMembership: lazyPort(ctx, 'salesChannelMembershipPort'),
+            settingsService: lazyPort(ctx, 'settingsReadPort'),
+            settingsAdminService: lazyPort(ctx, 'settingsAdminService'),
+            credentials: lazyPort(ctx, 'credentialsService'),
+            requireAdmin: (permission) => async (req, reply) => ctx.cradle().requireAdmin(permission)(req, reply),
+            resolveAdminAuditContext: (req) => ctx.cradle().adminAuditActorResolver(req),
+            // Built here rather than in a root: the enricher is this module's own
+            // code, and the only foreign part is the price resolver it wraps.
+            enrichSuggestionPricing: createSuggestionPricingEnricher({
+                catalogProducts: lazyPort(ctx, 'catalogProductReadPort'),
+                organizations: lazyPort(ctx, 'organizationDetailsPort'),
+                pricingService: lazyPort(ctx, 'pricingService'),
+            }),
+            // Issue #132 — the result list prices through the same port the
+            // popup already used.
+            listingPrices: lazyPort(ctx, 'pricingService'),
+            // ...and, now, the same organisation read the popup already used, so
+            // both halves of the search box quote one figure to one buyer.
+            organizations: lazyPort(ctx, 'organizationDetailsPort'),
+        }))
+            .singleton(),
+    });
+    /**
+     * Feature 075, Phase P — the storefront product query.
+     *
+     * `catalog`'s public listing hands the query over when
+     * `CATALOG_SEARCH_BACKEND=meilisearch` and serves it from Postgres
+     * otherwise — and today it does so by constructing its **own**
+     * `SearchQueryService` in its plugin body, so a composition holds two
+     * clients and two attribute-read wirings. This port is the instance
+     * `searchModule` already built.
+     *
+     * The Postgres fallback is a declared `nonBindingDependencies` degrade, not
+     * a `catch`: catching there would swallow `ModuleDisabledError` and make a
+     * switched-off `search` look like a slow one. Which is why the *other*
+     * degrade — an index that refuses or times out — is converted here rather
+     * than at the call site: `createSearchQueryPort` turns this module's own
+     * `SearchBackendUnavailable` into the `index-unavailable` arm of
+     * `SearchListOutcome`, so the consumer reads a field instead of writing the
+     * conditional re-throw `check:port-catches` refuses.
+     */
+    ctx.di.providePort('searchQueryPort', ctx
+        .asFunction(({ search }) => createSearchQueryPort(search.handle.searchQueryService))
+        .singleton());
+    ctx.di.providePort('searchHandle', ctx.asFunction(({ search }) => search.handle).singleton());
+    /**
+     * A **port**, not a contribution point (D-39): a reindex computes, talks to
+     * Meilisearch and rewrites every channel index, so a caller reaching for it
+     * while an operator has switched `search` off gets the 503 `MODULE_DISABLED`
+     * envelope rather than a sweep nobody asked for.
+     *
+     * It runs over `search.handle.indexer` — the instance `searchModule` already
+     * built — so a composition holds exactly one indexer and one Meilisearch
+     * client, whichever entry point triggers the reindex.
+     */
+    ctx.di.providePort('searchReindexPort', ctx
+        .asFunction(({ search, emFactory }) => ({
+        async reindexAll() {
+            const results = await search.handle.indexer.reindexAllChannels(emFactory());
+            return { documentCount: results.reduce((sum, r) => sum + r.documentCount, 0) };
+        },
+    }))
+        .singleton());
+    /**
+     * The seven index-maintenance subscriptions (issue #107).
+     *
+     * They were seven bare `eventBus.on` calls inside `SearchEventSubscriber`, so
+     * the Meilisearch documents kept being rewritten on every catalog write with
+     * `search` switched off — the module's routes refused, its indexer did not.
+     * `ctx.subscribe` wraps each in `subscribeForModule`, so the effective state
+     * decides whether the handler runs at all.
+     *
+     * The subscriber is reached through the cradle inside each closure rather than
+     * captured: registration resolves nothing, and reading the name per event is
+     * what lets a decoration or a rebuilt module reach the live instance.
+     */
+    const subscriber = () => ctx.cradle().search.handle.subscriber;
+    ctx.subscribe('product.created.v1', async (payload) => {
+        const { productId } = payload;
+        await subscriber().onProductUpserted(productId, 'product.created.v1');
+    });
+    ctx.subscribe('product.updated.v1', async (payload) => {
+        const { productId } = payload;
+        await subscriber().onProductUpserted(productId, 'product.updated.v1');
+    });
+    ctx.subscribe('product.archived.v1', async (payload) => {
+        const { productId } = payload;
+        await subscriber().onProductRemoved(productId, 'product.archived.v1');
+    });
+    ctx.subscribe('product.deleted.v1', async (payload) => {
+        const { productId } = payload;
+        await subscriber().onProductRemoved(productId, 'product.deleted.v1');
+    });
+    ctx.subscribe('category.updated.v1', async (payload) => {
+        const { categoryId } = payload;
+        await subscriber().onCategoryUpdated(categoryId);
+    });
+    ctx.subscribe('attribute.updated.v1', async () => {
+        await subscriber().onAttributeUpdated();
+    });
+    /**
+     * The LLM reactor (feature 006 / T027).
+     *
+     * It re-reads `search.llm.enabled` through the settings service, and gets the
+     * value that was just written: the settings write seam drops the cache and
+     * awaits the drop before it emits (issue #45). Until then this rested on the
+     * kernel's invalidator being registered ahead of this handler.
+     */
+    ctx.subscribe('settings.value_changed', async (payload) => {
+        await subscriber().onSettingChanged(payload);
+    });
+    ctx.routes(async (app) => {
+        await ctx.cradle().search.plugin(app);
+    });
+}
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export const entities = [
+    SearchPhraseRecord,
+];
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAG5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAE5F,OAAO,EAAE,YAAY,EAAqD,MAAM,aAAa,CAAC;AAE9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAmE/E,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC;QACd,MAAM,EAAE,GAAG;aACR,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAgB,EAAsB,EAAE,CAChF,YAAY,CAAC;YACX,SAAS;YACT,sBAAsB,EAAE,gBAAgB;YACxC,oBAAoB,EAAE,QAAQ,CAC5B,GAAG,EACH,0BAA0B,CAC3B;YACD,kEAAkE;YAClE,sEAAsE;YACtE,qEAAqE;YACrE,kEAAkE;YAClE,eAAe,EAAE,QAAQ,CAAyB,GAAG,EAAE,wBAAwB,CAAC;YAChF,mEAAmE;YACnE,mEAAmE;YACnE,8DAA8D;YAC9D,oEAAoE;YACpE,gDAAgD;YAChD,iBAAiB,EAAE,QAAQ,CAA0B,GAAG,EAAE,yBAAyB,CAAC;YACpF,sBAAsB,EAAE,QAAQ,CAC9B,GAAG,EACH,4BAA4B,CAC7B;YACD,eAAe,EAAE,QAAQ,CACvB,GAAG,EACH,kBAAkB,CACnB;YACD,oBAAoB,EAAE,QAAQ,CAC5B,GAAG,EACH,sBAAsB,CACvB;YACD,WAAW,EAAE,QAAQ,CAAqC,GAAG,EAAE,oBAAoB,CAAC;YACpF,YAAY,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,CACjD,GAAG,CAAC,MAAM,EAAgB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC;YACjE,wBAAwB,EAAE,CAAC,GAAG,EAAE,EAAE,CAChC,GAAG,CAAC,MAAM,EAAgB,CAAC,uBAAuB,CAAC,GAAG,CAAC;YACzD,sEAAsE;YACtE,kEAAkE;YAClE,uBAAuB,EAAE,+BAA+B,CAAC;gBACvD,eAAe,EAAE,QAAQ,CAAyB,GAAG,EAAE,wBAAwB,CAAC;gBAChF,aAAa,EAAE,QAAQ,CAA0B,GAAG,EAAE,yBAAyB,CAAC;gBAChF,cAAc,EAAE,QAAQ,CAA8B,GAAG,EAAE,gBAAgB,CAAC;aAC7E,CAAC;YACF,gEAAgE;YAChE,sBAAsB;YACtB,aAAa,EAAE,QAAQ,CAAmB,GAAG,EAAE,gBAAgB,CAAC;YAChE,qEAAqE;YACrE,+DAA+D;YAC/D,aAAa,EAAE,QAAQ,CAA0B,GAAG,EAAE,yBAAyB,CAAC;SACjF,CAAC,CACH;aACA,SAAS,EAAE;KACf,CAAC,CAAC;IAEH;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,EAAE,CAAC,WAAW,CAChB,iBAAiB,EACjB,GAAG;SACA,UAAU,CAAC,CAAC,EAAE,MAAM,EAAgB,EAAE,EAAE,CACvC,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CACxD;SACA,SAAS,EAAE,CACf,CAAC;IAEF,GAAG,CAAC,EAAE,CAAC,WAAW,CAChB,cAAc,EACd,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,EAAgB,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CACxE,CAAC;IAEF;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,CAAC,WAAW,CAChB,mBAAmB,EACnB,GAAG;SACA,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAgB,EAAqB,EAAE,CAAC,CAAC;QACvE,KAAK,CAAC,UAAU;YACd,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,CAAC,CAAC;YAC5E,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC;QACjF,CAAC;KACF,CAAC,CAAC;SACF,SAAS,EAAE,CACf,CAAC;IAEF;;;;;;;;;;;;OAYG;IACH,MAAM,UAAU,GAAG,GAA+C,EAAE,CAClE,GAAG,CAAC,MAAM,EAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;IAEtD,GAAG,CAAC,SAAS,CAAC,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpD,MAAM,EAAE,SAAS,EAAE,GAAG,OAAgC,CAAC;QACvD,MAAM,UAAU,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,SAAS,CAAC,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpD,MAAM,EAAE,SAAS,EAAE,GAAG,OAAgC,CAAC;QACvD,MAAM,UAAU,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,SAAS,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACrD,MAAM,EAAE,SAAS,EAAE,GAAG,OAAgC,CAAC;QACvD,MAAM,UAAU,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,SAAS,CAAC,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpD,MAAM,EAAE,SAAS,EAAE,GAAG,OAAgC,CAAC;QACvD,MAAM,UAAU,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,SAAS,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACrD,MAAM,EAAE,UAAU,EAAE,GAAG,OAAiC,CAAC;QACzD,MAAM,UAAU,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,SAAS,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,UAAU,EAAE,CAAC,kBAAkB,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH;;;;;;;OAOG;IACH,GAAG,CAAC,SAAS,CAAC,wBAAwB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACxD,MAAM,UAAU,EAAE,CAAC,gBAAgB,CAAC,OAAgC,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,GAAG,CAAC,MAAM,EAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,kBAAkB;CACnB,CAAC"}

package/dist/backend/plugin.d.ts

@@ -0,0 +1,133 @@
+import type { FastifyInstance, FastifyRequest } from 'fastify';
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CatalogAttributeReadPort, CatalogCategoryReadPort, CatalogProductReadPort, ListingPricePort, OrganizationDetailsPort, SettingsAdminAuditContext, SettingsAdminPort } from '@endora-commerce/contracts';
+import type { SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
+import { SearchIndexer } from './services/search-indexer.js';
+import { SearchEventSubscriber } from './services/search-event-subscriber.js';
+import { SearchQueryService } from './services/search-query.service.js';
+import { SearchSuggestService } from './services/search-suggest.service.js';
+import { LlmToggleService } from './services/llm-toggle.service.js';
+import type { CredentialResolvePort } from './services/embedder-config-resolver.js';
+import { SearchReindexWorker } from './services/search-reindex-worker.js';
+import { SearchPhraseRecorder } from './services/search-phrase-recorder.service.js';
+import { type SuggestionPricingEnricher } from './routes.public.js';
+import type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+/**
+ * Composition root for the search module — feature 006.
+ *
+ * Owns lifecycle for:
+ *   - {@link SearchIndexer} — per-channel Meilisearch indexer (foundation 001).
+ *   - {@link SearchEventSubscriber} — bridges catalog events + the
+ *     `settings.value_changed` reactor (US2) so the per-channel Meilisearch
+ *     indexes track Postgres mutations + LLM-mode flips automatically.
+ *   - {@link SearchSuggestService} — typeahead popup adapter on top of
+ *     {@link SearchQueryService}; reads its per-channel limit and
+ *     threshold from Settings when wired (US2).
+ *   - {@link LlmToggleService} — cross-setting validating wrapper around
+ *     `search.llm.enabled` (US2).
+ *
+ * Module isolation (Constitution I): catalog publishes
+ * `product.*`/`attribute.*` events. Settings publishes
+ * `settings.value_changed`. Search subscribes here. Removing this module
+ * leaves catalog and settings working — there are no dangling references.
+ */
+export interface SearchModuleOptions {
+    emFactory: () => EntityManager;
+    /**
+     * Feature 061 — the catalog's composed attribute read model (Principle I).
+     * Backs the indexer's searchable/filterable settings + option-label
+     * aggregation and the query service's filterable validation.
+     */
+    catalogAttributeRead: CatalogAttributeReadPort;
+    /**
+     * Feature 075, Phase C — the product rows the indexer turns into Meilisearch
+     * documents, read over `catalog`'s published port instead of out of its
+     * table. The edge is the binding `catalog` dependency the manifest declares:
+     * with `catalog` off there is nothing to index and the call answers 503.
+     */
+    catalogProducts: CatalogProductReadPort;
+    /**
+     * Feature 075 / D-87 — the category assignments and the category subtree the
+     * indexer projects, read over `catalog`'s published port instead of out of
+     * its `product_categories` / `categories` tables. Same binding `catalog`
+     * dependency as `catalogProducts`, and the same answer when it is off.
+     */
+    catalogCategories: CatalogCategoryReadPort;
+    /**
+     * The `sales_channel_products` bridge, through the sanctioned accessor
+     * (Constitution XII). Kernel-composed, so it is present for as long as the
+     * platform is.
+     */
+    salesChannelMembership: SalesChannelMembershipPort;
+    /**
+     * Universal-getter for Settings. Backs the suggest service's per-channel
+     * popup-count + minimum-query-length, the `settings.value_changed` →
+     * embedder reactor, and the reindex interval.
+     *
+     * Required since feature 072 (T123). It was optional for "foundation tests
+     * that predate Settings", and no such caller was left: both composition
+     * roots passed it, and absence silently downgraded the module to manifest
+     * defaults with no LLM reactor — a state nothing asked for and nothing
+     * detected.
+     */
+    settingsService: SettingsReadPort;
+    /**
+     * Feature 058 — resolves the `search.llm.embedder_credentials` reference into
+     * the embedder config, falling back per field to the legacy embedder settings.
+     * Injected as a narrow port (Principle I).
+     */
+    credentials: CredentialResolvePort;
+    /** Admin Settings write port — drives the `LlmToggleService.toggle` path. */
+    settingsAdminService: SettingsAdminPort;
+    /** Admin routes mount under `/api/v1/admin/search/*`. */
+    requireAdmin: RequireAdminFactory;
+    resolveAdminAuditContext: (req: FastifyRequest) => SettingsAdminAuditContext;
+    /**
+     * Typeahead suggestions carry the per-customer price-list resolution (SKU +
+     * image already ride on the summary), so the popup shows the price the
+     * searching user would actually pay.
+     */
+    enrichSuggestionPricing: SuggestionPricingEnricher;
+    /**
+     * Issue #132 — the pricing engine behind the *result list* (the enricher
+     * above covers the typeahead popup). A search hit is a listing and prices
+     * through the same chain as the catalogue grid.
+     */
+    listingPrices: ListingPricePort;
+    /**
+     * `organizations`' read model — the customer group the pricing engine keys a
+     * group-targeted list on. The enricher above already resolves it for the
+     * popup; the result list needs the same row, so a buyer who stops at the
+     * suggestions and one who presses Enter are quoted the same figure.
+     */
+    organizations: OrganizationDetailsPort;
+    /**
+     * When `true`, the module starts the periodic full-reindex sweep. The
+     * composition passes its deployment-role gate (`runWorkers`) here so the
+     * sweep only runs in worker/all processes, never in a dedicated
+     * `BACKEND_ROLE=api` process — and never in a test harness.
+     */
+    enableReindexScheduler: boolean;
+}
+export interface SearchModuleHandle {
+    indexer: SearchIndexer;
+    subscriber: SearchEventSubscriber;
+    searchQueryService: SearchQueryService;
+    suggestService: SearchSuggestService;
+    llmToggleService: LlmToggleService;
+    reindexWorker: SearchReindexWorker;
+    phraseRecorder: SearchPhraseRecorder;
+    /**
+     * The cadence the reindex timer reschedules itself on. Exposed because the
+     * property worth pinning is "the configured interval is the one used", and a
+     * self-rescheduling timer is not a thing a test can ask that of.
+     */
+    resolveReindexIntervalMinutes: () => Promise<number>;
+}
+export interface SearchModuleResult {
+    plugin: (app: FastifyInstance) => Promise<void>;
+    handle: SearchModuleHandle;
+}
+export declare function searchModule(options: SearchModuleOptions): SearchModuleResult;
+//# sourceMappingURL=plugin.d.ts.map