@memberjunction/search-engine 0.0.1 → 5.25.0

package/dist/generic/VectorSearchProvider.js

@@ -0,0 +1,347 @@
+/**
+ * @fileoverview Vector similarity search provider for the SearchEngine.
+ *
+ * Searches ALL configured vector indexes by grouping them by embedding model,
+ * embedding the query once per model, then querying all indexes for that model
+ * in parallel. Gracefully returns empty results when no vector indexes are
+ * configured.
+ *
+ * @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;
+};
+var VectorSearchProvider_1;
+import { LogError, LogStatus, Metadata, RunView, CompositeKey } from '@memberjunction/core';
+import { AIEngine } from '@memberjunction/aiengine';
+import { BaseEmbeddings, GetAIAPIKey } from '@memberjunction/ai';
+import { VectorDBBase } from '@memberjunction/ai-vectordb';
+import { MJGlobal, RegisterClass, UUIDsEqual } from '@memberjunction/global';
+import { BaseSearchProvider } from './ISearchProvider.js';
+let VectorSearchProvider = class VectorSearchProvider extends BaseSearchProvider {
+    constructor() {
+        super(...arguments);
+        this.SourceType = 'vector';
+        this.available = false;
+    }
+    static { VectorSearchProvider_1 = this; }
+    /** LRU cache for query embeddings. Key = `${modelDriverClass}::${query}`, Value = embedding vector */
+    static { this.EmbeddingCache = new Map(); }
+    static { this.CACHE_MAX_SIZE = 200; }
+    static { this.CACHE_TTL_MS = 5 * 60 * 1000; } // 5 minutes
+    /**
+     * Check and cache availability. Requires at least one vector index to be
+     * configured. Called by SearchEngine during Config().
+     */
+    async CheckAvailability(contextUser) {
+        try {
+            const rv = new RunView();
+            const result = await rv.RunView({
+                EntityName: 'MJ: Vector Indexes',
+                Fields: ['ID'],
+                MaxRows: 1,
+                ResultType: 'simple'
+            }, contextUser);
+            this.available = result.Success && result.Results.length > 0;
+        }
+        catch {
+            this.available = false;
+        }
+    }
+    IsAvailable() {
+        return this.available;
+    }
+    /**
+     * Search all vector indexes. Groups indexes by embedding model, embeds the
+     * query once per model, then queries all indexes for that model in parallel.
+     */
+    async Search(query, topK, filters, contextUser) {
+        try {
+            await AIEngine.Instance.Config(false, contextUser);
+            const rv = new RunView();
+            const indexResult = await rv.RunView({
+                EntityName: 'MJ: Vector Indexes',
+                ResultType: 'entity_object'
+            }, contextUser);
+            if (!indexResult.Success || indexResult.Results.length === 0) {
+                LogStatus('VectorSearchProvider: No vector indexes configured');
+                return [];
+            }
+            const indexesByModel = this.groupIndexesByModel(indexResult.Results);
+            const metadataFilter = this.buildMetadataFilter(filters);
+            // For each model group: embed + query all indexes in parallel
+            const modelGroupPromises = Array.from(indexesByModel.entries()).map(([embeddingModelID, indexes]) => this.embedAndQueryGroup(query, embeddingModelID, indexes, topK, metadataFilter, contextUser));
+            const groupResults = await Promise.all(modelGroupPromises);
+            return groupResults.flat();
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`VectorSearchProvider: Search failed: ${msg}`);
+            return [];
+        }
+    }
+    // ────────────────────────────────────────────────────────────────
+    // Embedding cache helpers
+    // ────────────────────────────────────────────────────────────────
+    /** Retrieve a cached embedding if present and not expired, promoting it for LRU */
+    getCachedEmbedding(key) {
+        const entry = VectorSearchProvider_1.EmbeddingCache.get(key);
+        if (entry && (Date.now() - entry.timestamp) < VectorSearchProvider_1.CACHE_TTL_MS) {
+            // Promote to most-recently-used by re-inserting
+            VectorSearchProvider_1.EmbeddingCache.delete(key);
+            VectorSearchProvider_1.EmbeddingCache.set(key, entry);
+            return entry.vector;
+        }
+        // Expired or not found — clean up stale entry if present
+        if (entry)
+            VectorSearchProvider_1.EmbeddingCache.delete(key);
+        return null;
+    }
+    /** Store an embedding in the cache, evicting the oldest entry if at capacity */
+    setCachedEmbedding(key, vector) {
+        // Evict least-recently-used (first key in insertion order) if at capacity
+        if (VectorSearchProvider_1.EmbeddingCache.size >= VectorSearchProvider_1.CACHE_MAX_SIZE) {
+            const oldestKey = VectorSearchProvider_1.EmbeddingCache.keys().next().value;
+            if (oldestKey !== undefined)
+                VectorSearchProvider_1.EmbeddingCache.delete(oldestKey);
+        }
+        VectorSearchProvider_1.EmbeddingCache.set(key, { vector, timestamp: Date.now() });
+    }
+    // ────────────────────────────────────────────────────────────────
+    // Private helpers
+    // ────────────────────────────────────────────────────────────────
+    /** Group vector indexes by their EmbeddingModelID */
+    groupIndexesByModel(indexes) {
+        const groups = new Map();
+        for (const index of indexes) {
+            const modelId = index.EmbeddingModelID;
+            const existing = groups.get(modelId);
+            if (existing) {
+                existing.push(index);
+            }
+            else {
+                groups.set(modelId, [index]);
+            }
+        }
+        return groups;
+    }
+    /**
+     * Embed query with one model, then query all indexes for that model in parallel.
+     */
+    async embedAndQueryGroup(query, embeddingModelID, indexes, topK, filter, contextUser) {
+        try {
+            const model = AIEngine.Instance.Models.find(m => UUIDsEqual(m.ID, embeddingModelID));
+            if (!model) {
+                LogError(`VectorSearchProvider: Embedding model ${embeddingModelID} not found`);
+                return [];
+            }
+            const apiKey = GetAIAPIKey(model.DriverClass);
+            // Check embedding cache before calling the model
+            const cacheKey = `${model.DriverClass}::${query}`;
+            let queryVector = this.getCachedEmbedding(cacheKey);
+            if (queryVector) {
+                LogStatus(`VectorSearchProvider: Embedding cache hit for model ${model.Name}`);
+            }
+            else {
+                const embeddingInstance = MJGlobal.Instance.ClassFactory.CreateInstance(BaseEmbeddings, model.DriverClass, apiKey);
+                if (!embeddingInstance) {
+                    LogError(`VectorSearchProvider: Failed to create embedding for ${model.DriverClass}`);
+                    return [];
+                }
+                const embedResult = await embeddingInstance.EmbedText({ text: query, model: '' });
+                if (!embedResult?.vector?.length) {
+                    LogError(`VectorSearchProvider: Failed to embed with ${model.Name}`);
+                    return [];
+                }
+                queryVector = embedResult.vector;
+                this.setCachedEmbedding(cacheKey, queryVector);
+            }
+            const indexPromises = indexes.map(vectorIndex => this.queryOneIndex(vectorIndex, queryVector, topK, filter, contextUser)
+                .catch(error => {
+                LogError(`VectorSearchProvider: Error querying index "${vectorIndex.Name}": ${error}`);
+                return [];
+            }));
+            const indexResults = await Promise.all(indexPromises);
+            return indexResults.flat();
+        }
+        catch (error) {
+            LogError(`VectorSearchProvider: Error in embedding group ${embeddingModelID}: ${error}`);
+            return [];
+        }
+    }
+    /**
+     * Query a single vector index.
+     */
+    async queryOneIndex(vectorIndex, queryVector, topK, filter, contextUser) {
+        const rv = new RunView();
+        const dbResult = await rv.RunView({
+            EntityName: 'MJ: Vector Databases',
+            ExtraFilter: `ID='${vectorIndex.VectorDatabaseID}'`,
+            ResultType: 'entity_object'
+        }, contextUser);
+        if (!dbResult.Success || dbResult.Results.length === 0) {
+            LogError(`VectorSearchProvider: VectorDatabase not found for index "${vectorIndex.Name}"`);
+            return [];
+        }
+        const vectorDB = dbResult.Results[0];
+        const apiKey = GetAIAPIKey(vectorDB.ClassKey);
+        const vectorDBInstance = MJGlobal.Instance.ClassFactory.CreateInstance(VectorDBBase, vectorDB.ClassKey, apiKey);
+        if (!vectorDBInstance) {
+            LogError(`VectorSearchProvider: Failed to create VectorDB instance for "${vectorDB.ClassKey}"`);
+            return [];
+        }
+        const response = await vectorDBInstance.QueryIndex({
+            id: vectorIndex.Name,
+            vector: queryVector,
+            topK,
+            includeMetadata: true,
+            filter,
+        });
+        if (!response.success || !response.data?.matches) {
+            return [];
+        }
+        return this.convertMatches(response.data.matches, vectorIndex.Name);
+    }
+    /** Convert vector DB matches to SearchResultItem[] */
+    convertMatches(matches, indexName) {
+        return matches.map(match => {
+            const meta = match.metadata ?? {};
+            const entityName = meta['Entity'] ?? 'Unknown';
+            // Vector metadata stores RecordID in CompositeKey URL format: "FieldName|Value" or "F1|V1||F2|V2"
+            // Use CompositeKey to properly parse it, then extract just the values for consistent
+            // matching with entity search results (which use plain record IDs)
+            const rawRecordID = meta['RecordID'] ?? match.id;
+            const recordID = this.extractRecordIDFromCompositeKey(rawRecordID);
+            const title = this.extractDisplayTitle(meta, entityName);
+            const snippet = this.extractDisplaySnippet(meta, indexName, match.score);
+            const entityIcon = meta['EntityIcon'] || undefined;
+            const updatedAt = meta['__mj_UpdatedAt'] ? new Date(meta['__mj_UpdatedAt']) : new Date();
+            const metaTags = Array.isArray(meta['Tags']) ? meta['Tags'] : [];
+            const rawScore = match.score ?? 0;
+            return {
+                ID: recordID,
+                EntityName: entityName,
+                RecordID: recordID,
+                SourceType: 'vector',
+                ResultType: 'entity-record',
+                Title: title,
+                Snippet: snippet,
+                Score: rawScore,
+                ScoreBreakdown: { Vector: rawScore },
+                Tags: metaTags,
+                EntityIcon: entityIcon,
+                RecordName: title,
+                MatchedAt: updatedAt,
+                RawMetadata: JSON.stringify(meta),
+            };
+        });
+    }
+    /**
+     * Extract best display title from vector metadata using entity field metadata.
+     * Combines all IsNameField fields in Sequence order.
+     */
+    extractDisplayTitle(meta, fallbackEntity) {
+        const entityName = meta['Entity'];
+        if (entityName) {
+            const md = new Metadata();
+            const entityInfo = md.Entities.find(e => e.Name === entityName);
+            if (entityInfo) {
+                const nameFields = entityInfo.Fields
+                    .filter(f => f.IsNameField)
+                    .sort((a, b) => (a.Sequence ?? 9999) - (b.Sequence ?? 9999));
+                if (nameFields.length > 0) {
+                    const parts = nameFields
+                        .map(f => meta[f.Name])
+                        .filter(v => v != null && String(v).trim() !== '')
+                        .map(v => String(v));
+                    if (parts.length > 0)
+                        return parts.join(' ');
+                }
+                if (entityInfo.NameField && meta[entityInfo.NameField.Name]) {
+                    return String(meta[entityInfo.NameField.Name]);
+                }
+            }
+        }
+        const heuristicFields = ['Name', 'Title', 'Subject', 'Label', 'DisplayName'];
+        for (const field of heuristicFields) {
+            if (meta[field] && typeof meta[field] === 'string') {
+                return meta[field];
+            }
+        }
+        return `${fallbackEntity} Record`;
+    }
+    /** Extract best display snippet from vector metadata */
+    extractDisplaySnippet(meta, indexName, score) {
+        const descFields = ['Description', 'Summary', 'Body', 'Content', 'Text', 'Notes'];
+        for (const field of descFields) {
+            if (meta[field] && typeof meta[field] === 'string') {
+                const val = meta[field];
+                return val.length > 200 ? val.substring(0, 200) + '...' : val;
+            }
+        }
+        const skipFields = new Set(['RecordID', 'Entity', 'TemplateID', 'EntityIcon', '__mj_UpdatedAt']);
+        const parts = [];
+        for (const [key, val] of Object.entries(meta)) {
+            if (skipFields.has(key) || val == null)
+                continue;
+            const strVal = String(val);
+            if (strVal.length > 0 && strVal.length < 100) {
+                parts.push(`${key}: ${strVal}`);
+            }
+            if (parts.length >= 3)
+                break;
+        }
+        if (parts.length > 0)
+            return parts.join(' · ');
+        return `Matched from index "${indexName}" with score ${(score ?? 0).toFixed(4)}`;
+    }
+    /** Build metadata filter from SearchFilters for vector DB queries */
+    buildMetadataFilter(filters) {
+        if (!filters)
+            return undefined;
+        const conditions = [];
+        if (filters.EntityNames?.length) {
+            conditions.push({ Entity: { $in: filters.EntityNames } });
+        }
+        if (filters.SourceTypes?.length) {
+            conditions.push({ SourceType: { $in: filters.SourceTypes } });
+        }
+        if (filters.Tags?.length) {
+            conditions.push({ Tags: { $in: filters.Tags } });
+        }
+        if (conditions.length === 0)
+            return undefined;
+        if (conditions.length === 1)
+            return conditions[0];
+        return { $and: conditions };
+    }
+    /**
+     * Extract a plain record ID from a CompositeKey URL segment string.
+     * Vector metadata stores RecordID in format "FieldName|Value" or "F1|V1||F2|V2".
+     * For deduplication with entity search results, we need just the value(s).
+     * Uses CompositeKey.SimpleLoadFromURLSegment for proper multi-field parsing.
+     */
+    extractRecordIDFromCompositeKey(raw) {
+        if (!raw.includes('|')) {
+            return raw; // Already a plain ID (no composite key format)
+        }
+        const ck = new CompositeKey();
+        ck.SimpleLoadFromURLSegment(raw);
+        if (ck.KeyValuePairs.length === 0) {
+            return raw; // Parsing failed, return as-is
+        }
+        if (ck.KeyValuePairs.length === 1) {
+            return ck.KeyValuePairs[0].Value; // Single-key: just the UUID
+        }
+        // Multi-key: join values with || for consistent dedup key
+        return ck.KeyValuePairs.map(kv => kv.Value).join('||');
+    }
+};
+VectorSearchProvider = VectorSearchProvider_1 = __decorate([
+    RegisterClass(BaseSearchProvider, 'VectorSearchProvider')
+], VectorSearchProvider);
+export { VectorSearchProvider };
+//# sourceMappingURL=VectorSearchProvider.js.map

package/dist/generic/VectorSearchProvider.js.map

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

package/dist/generic/search.types.d.ts

@@ -0,0 +1,151 @@
+/**
+ * @fileoverview Core type definitions for the SearchEngine package.
+ *
+ * Defines request/response types, filters, and result structures used
+ * throughout the search engine for vector, full-text, and entity search
+ * with Reciprocal Rank Fusion.
+ *
+ * @module @memberjunction/search-engine
+ */
+/**
+ * Source types that can contribute to search results.
+ */
+export type SearchSource = 'vector' | 'fulltext' | 'entity' | 'storage';
+/**
+ * Discriminator for how a search result should be rendered in the UI.
+ * - 'entity-record': A record from an MJ entity (navigable via EntityRecord viewer)
+ * - 'storage-file': A file from a file storage provider (open externally)
+ * - 'content-item': A content item (articles, web pages, etc.)
+ */
+export type SearchResultType = 'entity-record' | 'storage-file' | 'content-item';
+/**
+ * Search modes that control the level of enrichment applied to results.
+ * - 'full': Apply all enrichment (icons, record names, tags)
+ * - 'preview': Skip enrichment for faster results (e.g., autocomplete)
+ */
+export type SearchMode = 'full' | 'preview';
+/**
+ * Per-source score breakdown for a search result.
+ */
+export interface SearchScoreBreakdown {
+    /** Score from vector similarity search */
+    Vector?: number;
+    /** Score from full-text search */
+    FullText?: number;
+    /** Score from entity LIKE-based search */
+    Entity?: number;
+    /** Score from file storage search */
+    Storage?: number;
+}
+/**
+ * Filters that can be applied to narrow search results.
+ */
+export interface SearchFilters {
+    /** Restrict to specific entity names */
+    EntityNames?: string[];
+    /** Restrict to specific source types (vector metadata filter) */
+    SourceTypes?: string[];
+    /** Require specific tags */
+    Tags?: string[];
+}
+/**
+ * Parameters for executing a search.
+ */
+export interface SearchParams {
+    /** The search query text */
+    Query: string;
+    /** Maximum number of results to return (default: 20) */
+    MaxResults?: number;
+    /** Optional filters to narrow results */
+    Filters?: SearchFilters;
+    /** Minimum score threshold (0-1). Results below this are excluded after RRF fusion. */
+    MinScore?: number;
+    /** Search mode: 'full' applies enrichment, 'preview' skips it for speed */
+    Mode?: SearchMode;
+}
+/**
+ * A single search result with provenance and scoring information.
+ */
+export interface SearchResultItem {
+    /** Primary key of the source record (same as RecordID) */
+    ID: string;
+    /** The entity this result came from */
+    EntityName: string;
+    /** The source record ID */
+    RecordID: string;
+    /** How the content was sourced: 'vector', 'fulltext', 'entity', or 'fused' */
+    SourceType: string;
+    /** Display title for the result */
+    Title: string;
+    /** Text snippet showing the relevant content */
+    Snippet: string;
+    /** Fused relevance score (higher is more relevant) */
+    Score: number;
+    /** Per-source score breakdown */
+    ScoreBreakdown: SearchScoreBreakdown;
+    /** Tags associated with this result */
+    Tags: string[];
+    /** Font Awesome icon class for the entity */
+    EntityIcon?: string;
+    /** Resolved display name for the record */
+    RecordName?: string;
+    /** When this result was matched */
+    MatchedAt: Date;
+    /** Raw vector metadata as JSON string (contains all entity fields stored in vector DB) */
+    RawMetadata?: string;
+    /** Discriminator for UI rendering: entity-record, storage-file, or content-item */
+    ResultType: SearchResultType;
+    /** ID of the SearchProvider metadata record that produced this result */
+    ProviderId?: string;
+    /** Display label from the SearchProvider metadata (e.g., "Database", "Semantic Search") */
+    ProviderLabel?: string;
+    /** Font Awesome icon class from the SearchProvider metadata (e.g., "fa-solid fa-brain") */
+    ProviderIcon?: string;
+}
+/**
+ * Aggregate result from the search engine.
+ */
+export interface SearchResult {
+    /** Whether the search completed successfully */
+    Success: boolean;
+    /** The ranked search results */
+    Results: SearchResultItem[];
+    /** Total number of results returned */
+    TotalCount: number;
+    /** Total search execution time in milliseconds */
+    ElapsedMs: number;
+    /** Count of results contributed by each source before fusion */
+    SourceCounts: {
+        Vector: number;
+        FullText: number;
+        Entity: number;
+        Storage: number;
+    };
+    /** Metadata for all active search providers (for UI filter facets and labels) */
+    Providers: SearchProviderInfo[];
+    /** Error message if Success is false */
+    ErrorMessage?: string;
+}
+/**
+ * Metadata about an active search provider, sent to the client for UI rendering.
+ */
+export interface SearchProviderInfo {
+    /** SearchProvider record ID */
+    ID: string;
+    /** Provider name from metadata */
+    Name: string;
+    /** UI display label (falls back to Name if null) */
+    DisplayName: string;
+    /** Font Awesome icon class */
+    Icon: string;
+    /** The SourceType key this provider uses */
+    SourceType: string;
+    /** Priority (lower = higher) */
+    Priority: number;
+}
+/**
+ * A scored candidate used for RRF fusion input/output.
+ * Re-exported from @memberjunction/core for convenience.
+ */
+export type { ScoredCandidate } from '@memberjunction/core';
+//# sourceMappingURL=search.types.d.ts.map

package/dist/generic/search.types.d.ts.map

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

package/dist/generic/search.types.js

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Core type definitions for the SearchEngine package.
+ *
+ * Defines request/response types, filters, and result structures used
+ * throughout the search engine for vector, full-text, and entity search
+ * with Reciprocal Rank Fusion.
+ *
+ * @module @memberjunction/search-engine
+ */
+export {};
+//# sourceMappingURL=search.types.js.map

package/dist/generic/search.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.types.js","sourceRoot":"","sources":["../../src/generic/search.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './generic/search.types.js';
+export * from './generic/ISearchProvider.js';
+export * from './generic/SearchFusion.js';
+export * from './generic/SearchEnricher.js';
+export * from './generic/EntitySearchProvider.js';
+export * from './generic/VectorSearchProvider.js';
+export * from './generic/FullTextSearchProvider.js';
+export * from './generic/StorageSearchProvider.js';
+export * from './generic/SearchEngine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from './generic/search.types.js';
+export * from './generic/ISearchProvider.js';
+export * from './generic/SearchFusion.js';
+export * from './generic/SearchEnricher.js';
+export * from './generic/EntitySearchProvider.js';
+export * from './generic/VectorSearchProvider.js';
+export * from './generic/FullTextSearchProvider.js';
+export * from './generic/StorageSearchProvider.js';
+export * from './generic/SearchEngine.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC"}

package/package.json

@@ -1,10 +1,35 @@
 {
   "name": "@memberjunction/search-engine",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/search-engine",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "type": "module",
+  "version": "5.25.0",
+  "description": "MemberJunction: Reusable server-side search engine - vector + full-text + entity search with RRF fusion",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "dependencies": {
+    "@memberjunction/ai": "5.25.0",
+    "@memberjunction/ai-vectordb": "5.25.0",
+    "@memberjunction/aiengine": "5.25.0",
+    "@memberjunction/core": "5.25.0",
+    "@memberjunction/core-entities": "5.25.0",
+    "@memberjunction/global": "5.25.0",
+    "@memberjunction/storage": "5.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.11",
+    "typescript": "^5.9.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  }
 }