@memberjunction/search-engine 5.33.0 → 5.34.1

package/dist/providers/ElasticsearchSearchProvider.js

@@ -0,0 +1,200 @@
+/**
+ * @fileoverview Elasticsearch search provider for the SearchEngine (P5.1).
+ *
+ * Translates a query plus a SearchScope's `ExternalIndexes` constraint into an
+ * Elasticsearch search request. Each `MJ: Search Scope External Indexes` row
+ * with `IndexType='Elasticsearch'` and a non-empty `ExternalIndexName` becomes
+ * a target index in the request. The scope's rendered `MetadataFilter` (a JSON
+ * object the scope author authored as ES filter DSL) is composed into the
+ * top-level `bool.filter` so permission predicates and tenant-scoping push down
+ * to the engine — no post-fusion filtering.
+ *
+ * **Connection.** Reads from `SearchProviderConfig.ProviderConfig`:
+ *   - `node` — Elasticsearch node URL (e.g. `https://es.example.internal:9200`)
+ *   - `apiKey` — base64-encoded API key (preferred)
+ *   - `username` + `password` — basic auth fallback
+ *   - `cloudId` — Elastic Cloud deployment ID, when used in place of `node`
+ *   - `defaultField` — field to match against when the scope/provider doesn't
+ *     specify one (default: `content`)
+ *
+ * **Optional peer dep.** `@elastic/elasticsearch` is in `optionalDependencies`
+ * and loaded via dynamic import per CLAUDE.md rule #8 case 2 — consumers who
+ * don't use Elasticsearch don't pay the bundle cost.
+ *
+ * @module @memberjunction/search-engine
+ */
+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;
+};
+import { LogError } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { BaseSearchProvider } from '../generic/ISearchProvider.js';
+/**
+ * Lazy-loader for the Elasticsearch SDK. Memoized so the dynamic import cost is
+ * paid once per process even when many SearchProvider records reference the
+ * same driver.
+ */
+let clientCtorPromise = null;
+async function loadElasticsearchClient() {
+    if (!clientCtorPromise) {
+        clientCtorPromise = (async () => {
+            try {
+                const mod = await import('@elastic/elasticsearch');
+                return mod.Client;
+            }
+            catch (err) {
+                throw new Error(`ElasticsearchSearchProvider: '@elastic/elasticsearch' is not installed. Add it to your project's dependencies if you intend to use this provider. Underlying error: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        })();
+    }
+    return clientCtorPromise;
+}
+let ElasticsearchSearchProvider = class ElasticsearchSearchProvider extends BaseSearchProvider {
+    constructor() {
+        super(...arguments);
+        this.SourceType = 'fulltext';
+        this.client = null;
+        this.available = false;
+        this.parsedConfig = null;
+    }
+    async Initialize(config, contextUser) {
+        await super.Initialize(config, contextUser);
+        this.parsedConfig = config.ProviderConfig ?? null;
+        if (!this.parsedConfig) {
+            LogError('ElasticsearchSearchProvider: ProviderConfig is empty — set node + apiKey/username+password in the SearchProvider record.');
+            return;
+        }
+        try {
+            const Client = await loadElasticsearchClient();
+            const opts = {};
+            if (this.parsedConfig.cloudId) {
+                opts.cloud = { id: this.parsedConfig.cloudId };
+            }
+            else if (this.parsedConfig.node) {
+                opts.node = this.parsedConfig.node;
+            }
+            if (this.parsedConfig.apiKey) {
+                opts.auth = { apiKey: this.parsedConfig.apiKey };
+            }
+            else if (this.parsedConfig.username && this.parsedConfig.password) {
+                opts.auth = { username: this.parsedConfig.username, password: this.parsedConfig.password };
+            }
+            this.client = new Client(opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`ElasticsearchSearchProvider: Initialize failed — ${msg}`);
+            this.client = null;
+        }
+    }
+    async CheckAvailability(_contextUser) {
+        if (!this.client) {
+            this.available = false;
+            return;
+        }
+        try {
+            await this.client.ping();
+            this.available = true;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`ElasticsearchSearchProvider: ping failed — ${msg}`);
+            this.available = false;
+        }
+    }
+    IsAvailable() {
+        return this.available;
+    }
+    async Search(query, topK, _filters, _contextUser, scopeConstraints) {
+        if (!this.client || !this.parsedConfig)
+            return [];
+        // Determine target indexes: prefer scope-supplied, else providerConfig.defaultIndex
+        const scopedIndexes = scopeConstraints?.ExternalIndexes
+            ?.filter(r => r.IndexType === 'Elasticsearch' && r.ExternalIndexName)
+            .map(r => r.ExternalIndexName) ?? [];
+        const target = scopedIndexes.length > 0
+            ? scopedIndexes
+            : (this.parsedConfig.defaultIndex ? [this.parsedConfig.defaultIndex] : []);
+        if (target.length === 0) {
+            // No index to query — fail closed (silently empty), matching VectorSearchProvider's pattern.
+            return [];
+        }
+        // Honor per-provider query rewrite from the scope.
+        const effectiveQuery = scopeConstraints?.QueryTransforms?.[this.SourceType] ?? query;
+        const defaultField = this.parsedConfig.defaultField ?? 'content';
+        // Build the query: a multi_match across name + content by default. Scope's
+        // MetadataFilter (already-rendered ES filter DSL) is composed into bool.filter
+        // for permission / tenant push-down.
+        const filterClauses = [];
+        for (const idx of scopeConstraints?.ExternalIndexes ?? []) {
+            if (idx.IndexType !== 'Elasticsearch')
+                continue;
+            if (idx.MetadataFilter && typeof idx.MetadataFilter === 'object') {
+                filterClauses.push(idx.MetadataFilter);
+            }
+        }
+        const queryBody = {
+            bool: {
+                must: [
+                    { match: { [defaultField]: effectiveQuery } },
+                ],
+                ...(filterClauses.length > 0 ? { filter: filterClauses } : {}),
+            },
+        };
+        try {
+            const response = await this.client.search({
+                index: target,
+                size: topK,
+                query: queryBody,
+            });
+            // Normalize ES _score to [0, 1] with a soft cap so RRF fusion sees comparable
+            // values across providers. The cap is `topResultScore || 1` — preserves rank
+            // order and gives fusion a roughly-comparable distribution.
+            const hits = response.hits.hits;
+            const topScore = Math.max(1, hits[0]?._score ?? 1);
+            return hits.map((hit, idx) => {
+                const src = hit._source ?? {};
+                const title = src['title'] ?? src[defaultField] ?? hit._id;
+                const snippet = src[defaultField] ?? '';
+                return {
+                    ID: `es-${hit._index}-${hit._id}`,
+                    EntityName: hit._index,
+                    RecordID: hit._id,
+                    SourceType: this.SourceType,
+                    ResultType: 'entity-record',
+                    Title: title.slice(0, 200),
+                    Snippet: snippet.slice(0, 500),
+                    Score: hit._score / topScore,
+                    ScoreBreakdown: { FullText: hit._score / topScore },
+                    Tags: [],
+                    MatchedAt: new Date(),
+                    EntityIcon: 'fa-solid fa-database',
+                    RecordName: title.slice(0, 200),
+                    RawMetadata: JSON.stringify({ _index: hit._index, _id: hit._id, _rank: idx, _rawScore: hit._score }),
+                };
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`ElasticsearchSearchProvider.Search failed: ${msg}`);
+            return [];
+        }
+    }
+};
+ElasticsearchSearchProvider = __decorate([
+    RegisterClass(BaseSearchProvider, 'ElasticsearchSearchProvider')
+], ElasticsearchSearchProvider);
+export { ElasticsearchSearchProvider };
+/** Tree-shake prevention helper. */
+export function LoadElasticsearchSearchProvider() {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const _ref = ElasticsearchSearchProvider;
+}
+/** Test-only: clear the memoized SDK loader so each test installs its own mock. */
+export function __resetElasticsearchClientLoaderForTests() {
+    clientCtorPromise = null;
+}
+//# sourceMappingURL=ElasticsearchSearchProvider.js.map

package/dist/providers/ElasticsearchSearchProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElasticsearchSearchProvider.js","sourceRoot":"","sources":["../../src/providers/ElasticsearchSearchProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;;;;;AAEH,OAAO,EAAE,QAAQ,EAAuB,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAwB,MAAM,4BAA4B,CAAC;AAmCtF;;;;GAIG;AACH,IAAI,iBAAiB,GAA4C,IAAI,CAAC;AACtE,KAAK,UAAU,uBAAuB;IAClC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACrB,iBAAiB,GAAG,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC;gBACD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,wBAAkC,CAAwC,CAAC;gBACpG,OAAO,GAAG,CAAC,MAAM,CAAC;YACtB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CACX,uKAAuK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC5N,CAAC;YACN,CAAC;QACL,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC7B,CAAC;AAcM,IAAM,2BAA2B,GAAjC,MAAM,2BAA4B,SAAQ,kBAAkB;IAA5D;;QACa,eAAU,GAAiB,UAAU,CAAC;QAE9C,WAAM,GAAmC,IAAI,CAAC;QAC9C,cAAS,GAAG,KAAK,CAAC;QAClB,iBAAY,GAAuC,IAAI,CAAC;IAyIpE,CAAC;IAvImB,KAAK,CAAC,UAAU,CAAC,MAA4B,EAAE,WAAqB;QAChF,MAAM,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAI,MAAM,CAAC,cAAqD,IAAI,IAAI,CAAC;QAC1F,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrB,QAAQ,CAAC,0HAA0H,CAAC,CAAC;YACrI,OAAO;QACX,CAAC;QAED,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,uBAAuB,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAsD,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YACnD,CAAC;iBAAM,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;gBAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YACvC,CAAC;YACD,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,IAAI,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;YACrD,CAAC;iBAAM,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;gBAClE,IAAI,CAAC,IAAI,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC/F,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,QAAQ,CAAC,oDAAoD,GAAG,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACvB,CAAC;IACL,CAAC;IAEe,KAAK,CAAC,iBAAiB,CAAC,YAAsB;QAC1D,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,OAAO;QACX,CAAC;QACD,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,QAAQ,CAAC,8CAA8C,GAAG,EAAE,CAAC,CAAC;YAC9D,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAC3B,CAAC;IACL,CAAC;IAEe,WAAW;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,MAAM,CACf,KAAa,EACb,IAAY,EACZ,QAAmC,EACnC,YAAsB,EACtB,gBAAmC;QAEnC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,CAAC;QAElD,oFAAoF;QACpF,MAAM,aAAa,GAAG,gBAAgB,EAAE,eAAe;YACnD,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,eAAe,IAAI,CAAC,CAAC,iBAAiB,CAAC;aACpE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAA2B,CAAC,IAAI,EAAE,CAAC;QAEnD,MAAM,MAAM,GAAa,aAAa,CAAC,MAAM,GAAG,CAAC;YAC7C,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAE/E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,6FAA6F;YAC7F,OAAO,EAAE,CAAC;QACd,CAAC;QAED,mDAAmD;QACnD,MAAM,cAAc,GAAG,gBAAgB,EAAE,eAAe,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;QACrF,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,IAAI,SAAS,CAAC;QAEjE,2EAA2E;QAC3E,+EAA+E;QAC/E,qCAAqC;QACrC,MAAM,aAAa,GAAc,EAAE,CAAC;QACpC,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,eAAe,IAAI,EAAE,EAAE,CAAC;YACxD,IAAI,GAAG,CAAC,SAAS,KAAK,eAAe;gBAAE,SAAS;YAChD,IAAI,GAAG,CAAC,cAAc,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;gBAC/D,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC3C,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAA4B;YACvC,IAAI,EAAE;gBACF,IAAI,EAAE;oBACF,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,cAAc,EAAE,EAAE;iBAChD;gBACD,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjE;SACJ,CAAC;QAEF,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;gBACtC,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,SAAS;aACnB,CAAC,CAAC;YAEH,8EAA8E;YAC9E,6EAA6E;YAC7E,4DAA4D;YAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;YAEnD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBACzB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC9B,MAAM,KAAK,GAAI,GAAG,CAAC,OAAO,CAAwB,IAAK,GAAG,CAAC,YAAY,CAAwB,IAAI,GAAG,CAAC,GAAG,CAAC;gBAC3G,MAAM,OAAO,GAAI,GAAG,CAAC,YAAY,CAAwB,IAAI,EAAE,CAAC;gBAChE,OAAO;oBACH,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE;oBACjC,UAAU,EAAE,GAAG,CAAC,MAAM;oBACtB,QAAQ,EAAE,GAAG,CAAC,GAAG;oBACjB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,UAAU,EAAE,eAAe;oBAC3B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBAC1B,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,GAAG,QAAQ;oBAC5B,cAAc,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,GAAG,QAAQ,EAAE;oBACnD,IAAI,EAAE,EAAE;oBACR,SAAS,EAAE,IAAI,IAAI,EAAE;oBACrB,UAAU,EAAE,sBAAsB;oBAClC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBAC/B,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;iBACvG,CAAC;YACN,CAAC,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,QAAQ,CAAC,8CAA8C,GAAG,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC;CACJ,CAAA;AA9IY,2BAA2B;IADvC,aAAa,CAAC,kBAAkB,EAAE,6BAA6B,CAAC;GACpD,2BAA2B,CA8IvC;;AAED,oCAAoC;AACpC,MAAM,UAAU,+BAA+B;IAC3C,6DAA6D;IAC7D,MAAM,IAAI,GAAG,2BAA2B,CAAC;AAC7C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,wCAAwC;IACpD,iBAAiB,GAAG,IAAI,CAAC;AAC7B,CAAC"}

package/dist/providers/OpenSearchSearchProvider.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview OpenSearch search provider for the SearchEngine (P5.4).
+ *
+ * Calls OpenSearch's _search REST endpoint via fetch. OpenSearch's query DSL
+ * is largely identical to Elasticsearch 7.x — bool/must/filter trees compose
+ * the same way — so the provider mirrors {@link ElasticsearchSearchProvider}'s
+ * shape. Distinct class so admins can register and configure each cluster
+ * independently and so future divergence (knn vector search, neural search,
+ * pipeline aggregations) can land here without touching the ES path.
+ *
+ * **Connection options** (from `SearchProviderConfig.ProviderConfig`):
+ *   - `node` — OpenSearch node URL (e.g. `https://os.example:9200`)
+ *   - `username` + `password` — basic auth
+ *   - `awsAuthHeader` — pre-signed AWS SigV4 Authorization header for
+ *     Amazon OpenSearch Service deployments (caller responsible for
+ *     refreshing before expiry)
+ *   - `defaultIndex`, `defaultField` — fallbacks when scope is silent
+ *
+ * @module @memberjunction/search-engine
+ */
+import { UserInfo } from '@memberjunction/core';
+import { BaseSearchProvider, SearchProviderConfig } from '../generic/ISearchProvider.js';
+import { SearchSource, SearchFilters, SearchResultItem, ScopeConstraints } from '../generic/search.types.js';
+export declare class OpenSearchSearchProvider extends BaseSearchProvider {
+    readonly SourceType: SearchSource;
+    private parsedConfig;
+    private available;
+    Initialize(config: SearchProviderConfig, contextUser: UserInfo): Promise<void>;
+    CheckAvailability(_contextUser: UserInfo): Promise<void>;
+    IsAvailable(): boolean;
+    Search(query: string, topK: number, _filters: SearchFilters | undefined, _contextUser: UserInfo, scopeConstraints?: ScopeConstraints): Promise<SearchResultItem[]>;
+    private buildAuthHeaders;
+}
+/** Tree-shake prevention helper. */
+export declare function LoadOpenSearchSearchProvider(): void;
+//# sourceMappingURL=OpenSearchSearchProvider.d.ts.map

package/dist/providers/OpenSearchSearchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenSearchSearchProvider.d.ts","sourceRoot":"","sources":["../../src/providers/OpenSearchSearchProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAY,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EACH,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,yBAAyB,CAAC;AAqBjC,qBACa,wBAAyB,SAAQ,kBAAkB;IAC5D,SAAgB,UAAU,EAAE,YAAY,CAAc;IAEtD,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,SAAS,CAAS;IAEJ,UAAU,CAAC,MAAM,EAAE,oBAAoB,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9E,iBAAiB,CAAC,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9D,WAAW,IAAI,OAAO;IAIzB,MAAM,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,YAAY,EAAE,QAAQ,EACtB,gBAAgB,CAAC,EAAE,gBAAgB,GACpC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA6E9B,OAAO,CAAC,gBAAgB;CAc3B;AAED,oCAAoC;AACpC,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD"}

package/dist/providers/OpenSearchSearchProvider.js

@@ -0,0 +1,167 @@
+/**
+ * @fileoverview OpenSearch search provider for the SearchEngine (P5.4).
+ *
+ * Calls OpenSearch's _search REST endpoint via fetch. OpenSearch's query DSL
+ * is largely identical to Elasticsearch 7.x — bool/must/filter trees compose
+ * the same way — so the provider mirrors {@link ElasticsearchSearchProvider}'s
+ * shape. Distinct class so admins can register and configure each cluster
+ * independently and so future divergence (knn vector search, neural search,
+ * pipeline aggregations) can land here without touching the ES path.
+ *
+ * **Connection options** (from `SearchProviderConfig.ProviderConfig`):
+ *   - `node` — OpenSearch node URL (e.g. `https://os.example:9200`)
+ *   - `username` + `password` — basic auth
+ *   - `awsAuthHeader` — pre-signed AWS SigV4 Authorization header for
+ *     Amazon OpenSearch Service deployments (caller responsible for
+ *     refreshing before expiry)
+ *   - `defaultIndex`, `defaultField` — fallbacks when scope is silent
+ *
+ * @module @memberjunction/search-engine
+ */
+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;
+};
+import { LogError } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { BaseSearchProvider } from '../generic/ISearchProvider.js';
+let OpenSearchSearchProvider = class OpenSearchSearchProvider extends BaseSearchProvider {
+    constructor() {
+        super(...arguments);
+        this.SourceType = 'fulltext';
+        this.parsedConfig = null;
+        this.available = false;
+    }
+    async Initialize(config, contextUser) {
+        await super.Initialize(config, contextUser);
+        this.parsedConfig = config.ProviderConfig ?? null;
+        if (!this.parsedConfig?.node) {
+            LogError('OpenSearchSearchProvider: ProviderConfig must include a node URL.');
+            return;
+        }
+    }
+    async CheckAvailability(_contextUser) {
+        if (!this.parsedConfig?.node) {
+            this.available = false;
+            return;
+        }
+        try {
+            const response = await fetch(`${this.parsedConfig.node.replace(/\/$/, '')}/`, {
+                headers: this.buildAuthHeaders(),
+            });
+            // OpenSearch returns 200 + cluster info on the root endpoint when reachable.
+            // 401 means host is up but auth is wrong — operationally available.
+            this.available = response.ok || response.status === 401;
+            if (!this.available)
+                LogError(`OpenSearchSearchProvider: probe returned ${response.status}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`OpenSearchSearchProvider: probe failed — ${msg}`);
+            this.available = false;
+        }
+    }
+    IsAvailable() {
+        return this.available;
+    }
+    async Search(query, topK, _filters, _contextUser, scopeConstraints) {
+        if (!this.parsedConfig?.node)
+            return [];
+        const effectiveQuery = scopeConstraints?.QueryTransforms?.[this.SourceType] ?? query;
+        const defaultField = this.parsedConfig.defaultField ?? 'content';
+        const node = this.parsedConfig.node.replace(/\/$/, '');
+        const scopedRows = scopeConstraints?.ExternalIndexes
+            ?.filter(r => r.IndexType === 'OpenSearch' && r.ExternalIndexName) ?? [];
+        const indexNames = scopedRows.length > 0
+            ? scopedRows.map(r => r.ExternalIndexName)
+            : (this.parsedConfig.defaultIndex ? [this.parsedConfig.defaultIndex] : []);
+        if (indexNames.length === 0)
+            return [];
+        const filterClauses = [];
+        for (const idx of scopedRows) {
+            if (idx.MetadataFilter && typeof idx.MetadataFilter === 'object') {
+                filterClauses.push(idx.MetadataFilter);
+            }
+        }
+        const url = `${node}/${indexNames.map(encodeURIComponent).join(',')}/_search`;
+        const body = {
+            size: topK,
+            query: {
+                bool: {
+                    must: [{ match: { [defaultField]: effectiveQuery } }],
+                    ...(filterClauses.length > 0 ? { filter: filterClauses } : {}),
+                },
+            },
+        };
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { ...this.buildAuthHeaders(), 'Content-Type': 'application/json' },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                const text = await response.text().catch(() => '');
+                LogError(`OpenSearchSearchProvider: ${indexNames.join(',')} returned ${response.status}: ${text || response.statusText}`);
+                return [];
+            }
+            const json = await response.json();
+            const hits = json.hits?.hits ?? [];
+            if (hits.length === 0)
+                return [];
+            const topScore = Math.max(1, hits[0]._score);
+            return hits.slice(0, topK).map((hit, idx) => {
+                const src = hit._source ?? {};
+                const title = String(src['title'] ?? src[defaultField] ?? hit._id);
+                const snippet = String(src[defaultField] ?? '');
+                const normalized = hit._score / topScore;
+                return {
+                    ID: `os-${hit._index}-${hit._id}`,
+                    EntityName: hit._index,
+                    RecordID: hit._id,
+                    SourceType: this.SourceType,
+                    ResultType: 'entity-record',
+                    Title: title.slice(0, 200),
+                    Snippet: snippet.slice(0, 500),
+                    Score: normalized,
+                    ScoreBreakdown: { FullText: normalized },
+                    Tags: [],
+                    MatchedAt: new Date(),
+                    EntityIcon: 'fa-solid fa-database',
+                    RecordName: title.slice(0, 200),
+                    RawMetadata: JSON.stringify({ _index: hit._index, _id: hit._id, _rank: idx, _rawScore: hit._score }),
+                };
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`OpenSearchSearchProvider.Search failed: ${msg}`);
+            return [];
+        }
+    }
+    buildAuthHeaders() {
+        const headers = { Accept: 'application/json' };
+        if (this.parsedConfig?.awsAuthHeader) {
+            headers['Authorization'] = this.parsedConfig.awsAuthHeader;
+            return headers;
+        }
+        if (this.parsedConfig?.username && this.parsedConfig.password) {
+            const encoded = Buffer
+                .from(`${this.parsedConfig.username}:${this.parsedConfig.password}`)
+                .toString('base64');
+            headers['Authorization'] = `Basic ${encoded}`;
+        }
+        return headers;
+    }
+};
+OpenSearchSearchProvider = __decorate([
+    RegisterClass(BaseSearchProvider, 'OpenSearchSearchProvider')
+], OpenSearchSearchProvider);
+export { OpenSearchSearchProvider };
+/** Tree-shake prevention helper. */
+export function LoadOpenSearchSearchProvider() {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const _ref = OpenSearchSearchProvider;
+}
+//# sourceMappingURL=OpenSearchSearchProvider.js.map

package/dist/providers/OpenSearchSearchProvider.js.map

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

package/dist/providers/TypesenseSearchProvider.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Typesense search provider for the SearchEngine (P5.2).
+ *
+ * Calls Typesense's REST API directly via fetch — Typesense's surface is small
+ * enough that adding the `typesense` SDK as another optional peer would be
+ * overhead. Per-collection requests are run concurrently when a scope lists
+ * multiple ExternalIndexes; results are merged and returned in score order.
+ *
+ * **Connection options** (from `SearchProviderConfig.ProviderConfig`):
+ *   - `nodeUrl` — Single Typesense node URL (e.g. `https://ts.example:8108`)
+ *   - `apiKey` — Typesense API key (sent via `X-TYPESENSE-API-KEY`)
+ *   - `defaultCollection` — Fallback when scope doesn't list ExternalIndexes
+ *   - `defaultQueryBy` — Comma-separated fields, default `'content,title'`
+ *
+ * **Scope constraints.** `ExternalIndexes` rows with `IndexType='Typesense'`
+ * supply per-collection `ExternalIndexName` and an optional `MetadataFilter`
+ * (a Typesense `filter_by` string — already-rendered with SearchContext
+ * values via the scope's Nunjucks step).
+ *
+ * @module @memberjunction/search-engine
+ */
+import { UserInfo } from '@memberjunction/core';
+import { BaseSearchProvider, SearchProviderConfig } from '../generic/ISearchProvider.js';
+import { SearchSource, SearchFilters, SearchResultItem, ScopeConstraints } from '../generic/search.types.js';
+export declare class TypesenseSearchProvider extends BaseSearchProvider {
+    readonly SourceType: SearchSource;
+    private parsedConfig;
+    private available;
+    Initialize(config: SearchProviderConfig, contextUser: UserInfo): Promise<void>;
+    CheckAvailability(_contextUser: UserInfo): Promise<void>;
+    IsAvailable(): boolean;
+    Search(query: string, topK: number, _filters: SearchFilters | undefined, _contextUser: UserInfo, scopeConstraints?: ScopeConstraints): Promise<SearchResultItem[]>;
+}
+/** Tree-shake prevention helper. */
+export declare function LoadTypesenseSearchProvider(): void;
+//# sourceMappingURL=TypesenseSearchProvider.d.ts.map

package/dist/providers/TypesenseSearchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypesenseSearchProvider.d.ts","sourceRoot":"","sources":["../../src/providers/TypesenseSearchProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAY,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EACH,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,yBAAyB,CAAC;AAmBjC,qBACa,uBAAwB,SAAQ,kBAAkB;IAC3D,SAAgB,UAAU,EAAE,YAAY,CAAc;IAEtD,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,SAAS,CAAS;IAEJ,UAAU,CAAC,MAAM,EAAE,oBAAoB,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9E,iBAAiB,CAAC,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9D,WAAW,IAAI,OAAO;IAIzB,MAAM,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,YAAY,EAAE,QAAQ,EACtB,gBAAgB,CAAC,EAAE,gBAAgB,GACpC,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA0FjC;AAED,oCAAoC;AACpC,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD"}

package/dist/providers/TypesenseSearchProvider.js

@@ -0,0 +1,161 @@
+/**
+ * @fileoverview Typesense search provider for the SearchEngine (P5.2).
+ *
+ * Calls Typesense's REST API directly via fetch — Typesense's surface is small
+ * enough that adding the `typesense` SDK as another optional peer would be
+ * overhead. Per-collection requests are run concurrently when a scope lists
+ * multiple ExternalIndexes; results are merged and returned in score order.
+ *
+ * **Connection options** (from `SearchProviderConfig.ProviderConfig`):
+ *   - `nodeUrl` — Single Typesense node URL (e.g. `https://ts.example:8108`)
+ *   - `apiKey` — Typesense API key (sent via `X-TYPESENSE-API-KEY`)
+ *   - `defaultCollection` — Fallback when scope doesn't list ExternalIndexes
+ *   - `defaultQueryBy` — Comma-separated fields, default `'content,title'`
+ *
+ * **Scope constraints.** `ExternalIndexes` rows with `IndexType='Typesense'`
+ * supply per-collection `ExternalIndexName` and an optional `MetadataFilter`
+ * (a Typesense `filter_by` string — already-rendered with SearchContext
+ * values via the scope's Nunjucks step).
+ *
+ * @module @memberjunction/search-engine
+ */
+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;
+};
+import { LogError } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { BaseSearchProvider } from '../generic/ISearchProvider.js';
+let TypesenseSearchProvider = class TypesenseSearchProvider extends BaseSearchProvider {
+    constructor() {
+        super(...arguments);
+        this.SourceType = 'fulltext';
+        this.parsedConfig = null;
+        this.available = false;
+    }
+    async Initialize(config, contextUser) {
+        await super.Initialize(config, contextUser);
+        this.parsedConfig = config.ProviderConfig ?? null;
+        if (!this.parsedConfig?.nodeUrl || !this.parsedConfig.apiKey) {
+            LogError('TypesenseSearchProvider: ProviderConfig must include nodeUrl and apiKey.');
+            return;
+        }
+    }
+    async CheckAvailability(_contextUser) {
+        if (!this.parsedConfig?.nodeUrl || !this.parsedConfig.apiKey) {
+            this.available = false;
+            return;
+        }
+        try {
+            const response = await fetch(`${this.parsedConfig.nodeUrl.replace(/\/$/, '')}/health`, {
+                headers: { 'X-TYPESENSE-API-KEY': this.parsedConfig.apiKey },
+            });
+            this.available = response.ok;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`TypesenseSearchProvider: health check failed — ${msg}`);
+            this.available = false;
+        }
+    }
+    IsAvailable() {
+        return this.available;
+    }
+    async Search(query, topK, _filters, _contextUser, scopeConstraints) {
+        if (!this.parsedConfig?.nodeUrl || !this.parsedConfig.apiKey)
+            return [];
+        const effectiveQuery = scopeConstraints?.QueryTransforms?.[this.SourceType] ?? query;
+        const queryBy = this.parsedConfig.defaultQueryBy ?? 'content,title';
+        const node = this.parsedConfig.nodeUrl.replace(/\/$/, '');
+        // Resolve target collections from scope ExternalIndexes; fall back to defaultCollection.
+        const scopedTypesenseRows = scopeConstraints?.ExternalIndexes
+            ?.filter(r => r.IndexType === 'Typesense' && r.ExternalIndexName) ?? [];
+        const targets = scopedTypesenseRows.length > 0
+            ? scopedTypesenseRows
+            : (this.parsedConfig.defaultCollection
+                ? [{
+                        IndexType: 'Typesense',
+                        ExternalIndexName: this.parsedConfig.defaultCollection,
+                        MetadataFilter: undefined,
+                    }]
+                : []);
+        if (targets.length === 0)
+            return [];
+        // Run all configured collection searches in parallel and merge by text_match score.
+        const requests = targets.map(async (idx) => {
+            const params = new URLSearchParams({
+                q: effectiveQuery,
+                query_by: queryBy,
+                per_page: String(topK),
+            });
+            if (idx.MetadataFilter && typeof idx.MetadataFilter === 'string') {
+                params.set('filter_by', idx.MetadataFilter);
+            }
+            const url = `${node}/collections/${encodeURIComponent(idx.ExternalIndexName)}/documents/search?${params.toString()}`;
+            try {
+                const response = await fetch(url, {
+                    headers: { 'X-TYPESENSE-API-KEY': this.parsedConfig.apiKey },
+                });
+                if (!response.ok) {
+                    const body = await response.text().catch(() => '');
+                    LogError(`TypesenseSearchProvider: ${idx.ExternalIndexName} returned ${response.status}: ${body || response.statusText}`);
+                    return { collection: idx.ExternalIndexName, hits: [] };
+                }
+                const json = await response.json();
+                return { collection: idx.ExternalIndexName, hits: json.hits ?? [] };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                LogError(`TypesenseSearchProvider: ${idx.ExternalIndexName} fetch failed — ${msg}`);
+                return { collection: idx.ExternalIndexName, hits: [] };
+            }
+        });
+        const results = await Promise.all(requests);
+        const merged = results.flatMap(r => r.hits.map(h => ({ collection: r.collection, hit: h })));
+        if (merged.length === 0)
+            return [];
+        // Normalize text_match to [0, 1] across the merged set so RRF fusion sees
+        // comparable scores. text_match is a 64-bit Typesense match score — divide
+        // by the top to keep rank order while bounding range.
+        const topMatch = Math.max(1, ...merged.map(m => m.hit.text_match));
+        return merged
+            .sort((a, b) => b.hit.text_match - a.hit.text_match)
+            .slice(0, topK)
+            .map((m, idx) => {
+            const doc = m.hit.document;
+            const id = String(doc['id'] ?? `${m.collection}-${idx}`);
+            const title = String(doc['title'] ?? doc['name'] ?? id);
+            const snippetField = (this.parsedConfig?.defaultQueryBy ?? 'content,title').split(',')[0].trim();
+            const snippet = String(doc[snippetField] ?? '');
+            const normalized = m.hit.text_match / topMatch;
+            return {
+                ID: `ts-${m.collection}-${id}`,
+                EntityName: m.collection,
+                RecordID: id,
+                SourceType: this.SourceType,
+                ResultType: 'entity-record',
+                Title: title.slice(0, 200),
+                Snippet: snippet.slice(0, 500),
+                Score: normalized,
+                ScoreBreakdown: { FullText: normalized },
+                Tags: [],
+                MatchedAt: new Date(),
+                EntityIcon: 'fa-solid fa-database',
+                RecordName: title.slice(0, 200),
+                RawMetadata: JSON.stringify({ collection: m.collection, id, _rawMatch: m.hit.text_match }),
+            };
+        });
+    }
+};
+TypesenseSearchProvider = __decorate([
+    RegisterClass(BaseSearchProvider, 'TypesenseSearchProvider')
+], TypesenseSearchProvider);
+export { TypesenseSearchProvider };
+/** Tree-shake prevention helper. */
+export function LoadTypesenseSearchProvider() {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const _ref = TypesenseSearchProvider;
+}
+//# sourceMappingURL=TypesenseSearchProvider.js.map

package/dist/providers/TypesenseSearchProvider.js.map

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