@memberjunction/search-engine 0.0.1 → 5.25.0

package/dist/generic/SearchEnricher.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview Enrichment logic for search results.
+ *
+ * Adds entity icons, record names, and tags to search results.
+ * Skippable for preview mode where speed is more important than enrichment.
+ *
+ * @module @memberjunction/search-engine
+ */
+import { UserInfo } from '@memberjunction/core';
+import { SearchResultItem } from './search.types.js';
+/**
+ * Enriches search results with entity icons, record names, and tags.
+ * Also handles filtering of redundant Content Item results that originate
+ * from entity-type content sources.
+ */
+export declare class SearchEnricher {
+    /**
+     * Apply full enrichment to search results: entity icons, record names, and tags.
+     *
+     * @param results - The search results to enrich (mutated in place)
+     * @param contextUser - The user performing the search
+     */
+    Enrich(results: SearchResultItem[], contextUser: UserInfo): Promise<void>;
+    /**
+     * Enrich results with tags from both TaggedItems and ContentItemTags entities.
+     *
+     * @param results - The search results to enrich (mutated in place)
+     * @param contextUser - The user performing the search
+     */
+    EnrichWithTags(results: SearchResultItem[], contextUser: UserInfo): Promise<void>;
+    /**
+     * Filter results to only include those with at least one tag matching the specified list.
+     * Uses case-insensitive comparison.
+     */
+    FilterByTags(results: SearchResultItem[], requiredTags: string[]): SearchResultItem[];
+    /**
+     * Remove Content Item results that originated from Entity-type content sources.
+     * These are redundant because the underlying entity records are already
+     * vectorized and searchable directly.
+     *
+     * @param results - All search results
+     * @param contextUser - The user performing the search
+     * @returns Filtered results without redundant Content Item entries
+     */
+    ExcludeEntitySourcedContentItems(results: SearchResultItem[], contextUser: UserInfo): Promise<SearchResultItem[]>;
+    /**
+     * Add entity icons for results that don't already have them from vector metadata.
+     */
+    private addEntityIcons;
+    /**
+     * Resolve record names for results that don't already have them.
+     * Vector results from enriched metadata should already have names;
+     * this handles FTS and entity results.
+     */
+    private resolveRecordNames;
+    /**
+     * Build EntityRecordNameInput entries for batch name resolution.
+     */
+    private buildNameInputs;
+    /**
+     * Load tags from the TaggedItems entity for non-Content-Item results.
+     */
+    private loadTaggedItemTags;
+    /**
+     * Load tags from the ContentItemTag entity for Content Item results.
+     */
+    private loadContentItemTags;
+}
+//# sourceMappingURL=SearchEnricher.d.ts.map

package/dist/generic/SearchEnricher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchEnricher.d.ts","sourceRoot":"","sources":["../../src/generic/SearchEnricher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIH,QAAQ,EAGX,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;GAIG;AACH,qBAAa,cAAc;IACvB;;;;;OAKG;IACU,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtF;;;;;OAKG;IACU,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9F;;;OAGG;IACI,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE;IAO5F;;;;;;;;OAQG;IACU,gCAAgC,CACzC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAmC9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;YACW,kBAAkB;IAgChC;;OAEG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;YACW,kBAAkB;IAoDhC;;OAEG;YACW,mBAAmB;CA4BpC"}

package/dist/generic/SearchEnricher.js

@@ -0,0 +1,241 @@
+/**
+ * @fileoverview Enrichment logic for search results.
+ *
+ * Adds entity icons, record names, and tags to search results.
+ * Skippable for preview mode where speed is more important than enrichment.
+ *
+ * @module @memberjunction/search-engine
+ */
+import { LogError, Metadata, RunView, EntityRecordNameInput, CompositeKey } from '@memberjunction/core';
+import { UUIDsEqual } from '@memberjunction/global';
+import { KnowledgeHubMetadataEngine } from '@memberjunction/core-entities';
+/**
+ * Enriches search results with entity icons, record names, and tags.
+ * Also handles filtering of redundant Content Item results that originate
+ * from entity-type content sources.
+ */
+export class SearchEnricher {
+    /**
+     * Apply full enrichment to search results: entity icons, record names, and tags.
+     *
+     * @param results - The search results to enrich (mutated in place)
+     * @param contextUser - The user performing the search
+     */
+    async Enrich(results, contextUser) {
+        if (results.length === 0)
+            return;
+        const md = new Metadata();
+        this.addEntityIcons(results, md);
+        await this.resolveRecordNames(results, md, contextUser);
+    }
+    /**
+     * Enrich results with tags from both TaggedItems and ContentItemTags entities.
+     *
+     * @param results - The search results to enrich (mutated in place)
+     * @param contextUser - The user performing the search
+     */
+    async EnrichWithTags(results, contextUser) {
+        if (results.length === 0)
+            return;
+        try {
+            const contentItemResults = results.filter(r => r.EntityName === 'MJ: Content Items');
+            const generalResults = results.filter(r => r.EntityName !== 'MJ: Content Items');
+            await Promise.all([
+                this.loadTaggedItemTags(generalResults, contextUser),
+                this.loadContentItemTags(contentItemResults, contextUser)
+            ]);
+        }
+        catch (error) {
+            LogError(`SearchEnricher: Error enriching results with tags: ${error}`);
+            // Non-fatal - results still usable without tags
+        }
+    }
+    /**
+     * Filter results to only include those with at least one tag matching the specified list.
+     * Uses case-insensitive comparison.
+     */
+    FilterByTags(results, requiredTags) {
+        const lowerTags = new Set(requiredTags.map(t => t.toLowerCase()));
+        return results.filter(r => r.Tags.some(t => lowerTags.has(t.toLowerCase())));
+    }
+    /**
+     * Remove Content Item results that originated from Entity-type content sources.
+     * These are redundant because the underlying entity records are already
+     * vectorized and searchable directly.
+     *
+     * @param results - All search results
+     * @param contextUser - The user performing the search
+     * @returns Filtered results without redundant Content Item entries
+     */
+    async ExcludeEntitySourcedContentItems(results, contextUser) {
+        const contentItemResults = results.filter(r => r.EntityName === 'MJ: Content Items');
+        if (contentItemResults.length === 0)
+            return results;
+        await KnowledgeHubMetadataEngine.Instance.Config(false, contextUser);
+        const engine = KnowledgeHubMetadataEngine.Instance;
+        const entitySourceType = engine.ContentSourceTypes.find(st => st.Name === 'Entity');
+        if (!entitySourceType)
+            return results;
+        const entitySourceIDs = new Set(engine.ContentSources
+            .filter(cs => UUIDsEqual(cs.ContentSourceTypeID, entitySourceType.ID))
+            .map(cs => cs.ID.toLowerCase()));
+        if (entitySourceIDs.size === 0)
+            return results;
+        return results.filter(r => {
+            if (r.EntityName !== 'MJ: Content Items')
+                return true;
+            if (!r.RawMetadata)
+                return true;
+            try {
+                const meta = JSON.parse(r.RawMetadata);
+                const sourceID = meta.ContentSourceID;
+                if (!sourceID)
+                    return true;
+                return !entitySourceIDs.has(sourceID.toLowerCase());
+            }
+            catch {
+                return true;
+            }
+        });
+    }
+    // ────────────────────────────────────────────────────────────────
+    // Private helpers
+    // ────────────────────────────────────────────────────────────────
+    /**
+     * Add entity icons for results that don't already have them from vector metadata.
+     */
+    addEntityIcons(results, md) {
+        for (const result of results) {
+            if (!result.EntityIcon) {
+                const entity = md.Entities.find(e => e.Name === result.EntityName);
+                if (entity?.Icon) {
+                    result.EntityIcon = entity.Icon;
+                }
+            }
+        }
+    }
+    /**
+     * Resolve record names for results that don't already have them.
+     * Vector results from enriched metadata should already have names;
+     * this handles FTS and entity results.
+     */
+    async resolveRecordNames(results, md, contextUser) {
+        const needsName = results.filter(r => !r.RecordName || r.RecordName === `${r.EntityName} Record`);
+        if (needsName.length === 0)
+            return;
+        try {
+            const indexedInputs = this.buildNameInputs(needsName, results, md);
+            if (indexedInputs.length === 0)
+                return;
+            const names = await md.GetEntityRecordNames(indexedInputs.map(ir => ir.Input), contextUser);
+            for (let i = 0; i < names.length; i++) {
+                if (names[i].RecordName) {
+                    const resultIndex = indexedInputs[i].ResultIndex;
+                    results[resultIndex].RecordName = names[i].RecordName;
+                    results[resultIndex].Title = names[i].RecordName;
+                }
+            }
+        }
+        catch (error) {
+            LogError(`SearchEnricher: Error resolving record names: ${error}`);
+            // Non-fatal - results still usable without names
+        }
+    }
+    /**
+     * Build EntityRecordNameInput entries for batch name resolution.
+     */
+    buildNameInputs(needsName, allResults, md) {
+        const indexed = [];
+        for (const r of needsName) {
+            const resultIndex = allResults.indexOf(r);
+            const entity = md.Entities.find(e => e.Name === r.EntityName);
+            if (!entity)
+                continue;
+            const key = new CompositeKey();
+            key.LoadFromURLSegment(entity, r.RecordID);
+            const input = new EntityRecordNameInput();
+            input.EntityName = r.EntityName;
+            input.CompositeKey = key;
+            indexed.push({ ResultIndex: resultIndex, Input: input });
+        }
+        return indexed;
+    }
+    /**
+     * Load tags from the TaggedItems entity for non-Content-Item results.
+     */
+    async loadTaggedItemTags(results, contextUser) {
+        if (results.length === 0)
+            return;
+        const md = new Metadata();
+        const entityIdMap = new Map();
+        for (const r of results) {
+            if (!entityIdMap.has(r.EntityName)) {
+                const entityInfo = md.Entities.find(e => e.Name === r.EntityName);
+                if (entityInfo) {
+                    entityIdMap.set(r.EntityName, entityInfo.ID);
+                }
+            }
+        }
+        if (entityIdMap.size === 0)
+            return;
+        const conditions = [];
+        for (const r of results) {
+            const entityID = entityIdMap.get(r.EntityName);
+            if (!entityID)
+                continue;
+            conditions.push(`(EntityID='${entityID}' AND RecordID='${r.RecordID}')`);
+        }
+        if (conditions.length === 0)
+            return;
+        const rv = new RunView();
+        const tagResult = await rv.RunView({
+            EntityName: 'MJ: Tagged Items',
+            ExtraFilter: conditions.join(' OR '),
+            Fields: ['EntityID', 'RecordID', 'Tag'],
+            ResultType: 'simple'
+        }, contextUser);
+        if (!tagResult.Success)
+            return;
+        const tagMap = new Map();
+        for (const ti of tagResult.Results) {
+            const key = `${ti.EntityID}::${ti.RecordID}`;
+            const tags = tagMap.get(key) ?? [];
+            tags.push(ti.Tag);
+            tagMap.set(key, tags);
+        }
+        for (const r of results) {
+            const entityID = entityIdMap.get(r.EntityName);
+            if (!entityID)
+                continue;
+            const key = `${entityID}::${r.RecordID}`;
+            r.Tags = tagMap.get(key) ?? [];
+        }
+    }
+    /**
+     * Load tags from the ContentItemTag entity for Content Item results.
+     */
+    async loadContentItemTags(results, contextUser) {
+        if (results.length === 0)
+            return;
+        const recordIDs = results.map(r => `'${r.RecordID}'`);
+        const rv = new RunView();
+        const tagResult = await rv.RunView({
+            EntityName: 'MJ: Content Item Tags',
+            ExtraFilter: `ItemID IN (${recordIDs.join(',')})`,
+            Fields: ['ItemID', 'Tag'],
+            ResultType: 'simple'
+        }, contextUser);
+        if (!tagResult.Success)
+            return;
+        const tagMap = new Map();
+        for (const ti of tagResult.Results) {
+            const tags = tagMap.get(ti.ItemID) ?? [];
+            tags.push(ti.Tag);
+            tagMap.set(ti.ItemID, tags);
+        }
+        for (const r of results) {
+            r.Tags = tagMap.get(r.RecordID) ?? tagMap.get(r.RecordID.toLowerCase()) ?? [];
+        }
+    }
+}
+//# sourceMappingURL=SearchEnricher.js.map

package/dist/generic/SearchEnricher.js.map

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

package/dist/generic/SearchFusion.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Search result fusion using Reciprocal Rank Fusion (RRF).
+ *
+ * Takes ranked lists from vector, full-text, and entity search providers,
+ * applies RRF to produce a unified ranking, deduplicates by EntityName+RecordID,
+ * and normalizes scores when only a single source has results.
+ *
+ * @module @memberjunction/search-engine
+ */
+import { SearchResultItem, SearchSource } from './search.types.js';
+/**
+ * A labeled list of search results from a single source.
+ */
+export interface LabeledResultList {
+    /** Which search source produced these results */
+    Source: SearchSource;
+    /** The results, sorted by descending relevance */
+    Results: SearchResultItem[];
+}
+/**
+ * Handles fusion and deduplication of multi-source search results
+ * using Reciprocal Rank Fusion.
+ */
+export declare class SearchFusion {
+    /**
+     * Fuse multiple ranked result lists using RRF, deduplicate, and return
+     * the top results up to maxResults.
+     *
+     * When only one source has results, scores are normalized relative to
+     * the top result so the best match appears at ~95% rather than raw
+     * cosine similarity (~40-50%).
+     *
+     * @param lists - Labeled result lists from each search source
+     * @param maxResults - Maximum number of results to return
+     * @returns Fused, deduplicated, and ranked results
+     */
+    Fuse(lists: LabeledResultList[], maxResults: number): SearchResultItem[];
+    /**
+     * Deduplicate results by EntityName+RecordID.
+     * When the same record appears from multiple sources (e.g., vector + entity),
+     * prefer entity results (they have richer metadata like snippets and field data)
+     * and merge the score breakdowns. The final score is the maximum across sources.
+     */
+    Deduplicate(results: SearchResultItem[]): SearchResultItem[];
+    /**
+     * Apply RRF across multiple result lists.
+     * Maps results to ScoredCandidate[], runs ComputeRRF, then maps back.
+     */
+    private applyRRF;
+    /**
+     * Normalize scores when only one search source returned results.
+     * Scales scores relative to the top result so the best match shows
+     * ~95% instead of raw cosine similarity (~40-50%).
+     */
+    private normalizeScores;
+    /**
+     * Create a fallback SearchResultItem for a fused candidate that has
+     * no matching full result item (defensive).
+     */
+    private createFallbackItem;
+}
+//# sourceMappingURL=SearchFusion.d.ts.map

package/dist/generic/SearchFusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchFusion.d.ts","sourceRoot":"","sources":["../../src/generic/SearchFusion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAwB,MAAM,gBAAgB,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,iDAAiD;IACjD,MAAM,EAAE,YAAY,CAAC;IACrB,kDAAkD;IAClD,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,YAAY;IACrB;;;;;;;;;;;OAWG;IACI,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAc/E;;;;;OAKG;IACI,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE;IAkCnE;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAkChB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAavB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAe7B"}

package/dist/generic/SearchFusion.js

@@ -0,0 +1,147 @@
+/**
+ * @fileoverview Search result fusion using Reciprocal Rank Fusion (RRF).
+ *
+ * Takes ranked lists from vector, full-text, and entity search providers,
+ * applies RRF to produce a unified ranking, deduplicates by EntityName+RecordID,
+ * and normalizes scores when only a single source has results.
+ *
+ * @module @memberjunction/search-engine
+ */
+import { ComputeRRF } from '@memberjunction/core';
+/**
+ * Handles fusion and deduplication of multi-source search results
+ * using Reciprocal Rank Fusion.
+ */
+export class SearchFusion {
+    /**
+     * Fuse multiple ranked result lists using RRF, deduplicate, and return
+     * the top results up to maxResults.
+     *
+     * When only one source has results, scores are normalized relative to
+     * the top result so the best match appears at ~95% rather than raw
+     * cosine similarity (~40-50%).
+     *
+     * @param lists - Labeled result lists from each search source
+     * @param maxResults - Maximum number of results to return
+     * @returns Fused, deduplicated, and ranked results
+     */
+    Fuse(lists, maxResults) {
+        // Collect only lists that have results
+        const nonEmpty = lists.filter(l => l.Results.length > 0);
+        if (nonEmpty.length === 0)
+            return [];
+        // Single source: return as-is (no normalization needed, scores are native to that source)
+        if (nonEmpty.length === 1) {
+            return nonEmpty[0].Results.slice(0, maxResults);
+        }
+        // Multiple sources: apply RRF
+        return this.applyRRF(nonEmpty, maxResults);
+    }
+    /**
+     * Deduplicate results by EntityName+RecordID.
+     * When the same record appears from multiple sources (e.g., vector + entity),
+     * prefer entity results (they have richer metadata like snippets and field data)
+     * and merge the score breakdowns. The final score is the maximum across sources.
+     */
+    Deduplicate(results) {
+        const seen = new Map();
+        for (const result of results) {
+            const key = `${result.EntityName}::${result.RecordID}`;
+            const existing = seen.get(key);
+            if (!existing) {
+                seen.set(key, result);
+            }
+            else {
+                // Merge: keep the better result, combine score breakdowns
+                const mergedBreakdown = { ...existing.ScoreBreakdown, ...result.ScoreBreakdown };
+                const maxScore = Math.max(existing.Score, result.Score);
+                // Prefer 'entity' source type (richer data) over 'vector'
+                const preferred = existing.SourceType === 'entity' ? existing :
+                    result.SourceType === 'entity' ? result :
+                        result.Score > existing.Score ? result : existing;
+                seen.set(key, {
+                    ...preferred,
+                    Score: maxScore,
+                    ScoreBreakdown: mergedBreakdown
+                });
+            }
+        }
+        // Ensure Score is the max of all ScoreBreakdown values (handles cases
+        // where dedup didn't merge but breakdown was set from a single source)
+        const deduplicated = Array.from(seen.values()).map(r => {
+            const breakdownValues = Object.values(r.ScoreBreakdown).filter((v) => typeof v === 'number' && v > 0);
+            const breakdownMax = breakdownValues.length > 0 ? Math.max(...breakdownValues) : 0;
+            return breakdownMax > r.Score ? { ...r, Score: breakdownMax } : r;
+        });
+        return deduplicated.sort((a, b) => b.Score - a.Score);
+    }
+    /**
+     * Apply RRF across multiple result lists.
+     * Maps results to ScoredCandidate[], runs ComputeRRF, then maps back.
+     */
+    applyRRF(lists, maxResults) {
+        // Build ScoredCandidate arrays for each source
+        const rankedLists = lists.map(list => list.Results.map((r, i) => ({
+            ID: r.RecordID,
+            Score: r.Score,
+            Rank: i + 1
+        })));
+        // Run RRF fusion
+        const fused = ComputeRRF(rankedLists);
+        // Build a lookup from RecordID to full result item (prefer first occurrence)
+        const resultMap = new Map();
+        for (const list of lists) {
+            for (const r of list.Results) {
+                if (!resultMap.has(r.RecordID)) {
+                    resultMap.set(r.RecordID, r);
+                }
+            }
+        }
+        // Map fused candidates back to full result items
+        return fused.slice(0, maxResults).map(candidate => {
+            const item = resultMap.get(candidate.ID);
+            if (item) {
+                return { ...item, Score: candidate.Score };
+            }
+            // Fallback (shouldn't happen in practice)
+            return this.createFallbackItem(candidate);
+        });
+    }
+    /**
+     * Normalize scores when only one search source returned results.
+     * Scales scores relative to the top result so the best match shows
+     * ~95% instead of raw cosine similarity (~40-50%).
+     */
+    normalizeScores(results) {
+        if (results.length === 0)
+            return results;
+        const maxScore = results[0].Score; // Results are already sorted desc
+        if (maxScore <= 0)
+            return results;
+        const scaleFactor = 0.95 / maxScore;
+        return results.map(r => ({
+            ...r,
+            Score: Math.min(0.99, r.Score * scaleFactor)
+        }));
+    }
+    /**
+     * Create a fallback SearchResultItem for a fused candidate that has
+     * no matching full result item (defensive).
+     */
+    createFallbackItem(candidate) {
+        return {
+            ID: candidate.ID,
+            EntityName: 'Unknown',
+            RecordID: candidate.ID,
+            SourceType: 'fused',
+            ResultType: 'entity-record',
+            Title: 'Unknown',
+            Snippet: '',
+            Score: candidate.Score,
+            ScoreBreakdown: {},
+            Tags: [],
+            MatchedAt: new Date()
+        };
+    }
+}
+//# sourceMappingURL=SearchFusion.js.map

package/dist/generic/SearchFusion.js.map

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

package/dist/generic/StorageSearchProvider.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview Storage search provider for file storage accounts.
+ *
+ * Searches files across MJ File Storage accounts that have
+ * IncludeInGlobalSearch=true, using each provider's native search API.
+ * Results are permission-checked against FileStorageAccountPermission
+ * before being returned.
+ *
+ * @module @memberjunction/search-engine
+ */
+import { UserInfo } from '@memberjunction/core';
+import { BaseSearchProvider } from './ISearchProvider.js';
+import { SearchSource, SearchFilters, SearchResultItem } from './search.types.js';
+/**
+ * Provides file-level search across MJ File Storage accounts using each
+ * provider's native SearchFiles() API. Only accounts with
+ * IncludeInGlobalSearch=true and providers with SupportsSearch=true are searched.
+ *
+ * Permission checking is performed against FileStorageAccountPermission records.
+ * If no permission records exist for an account, it is accessible to everyone
+ * (backwards compatible). Otherwise, the user must have CanRead=true via a
+ * direct User permission, a Role permission, or an Everyone permission.
+ */
+export declare class StorageSearchProvider extends BaseSearchProvider {
+    readonly SourceType: SearchSource;
+    private _available;
+    private _searchableAccounts;
+    private _permissions;
+    /**
+     * Whether this provider has at least one searchable storage account.
+     */
+    IsAvailable(): boolean;
+    /**
+     * Load storage accounts and permissions to determine availability.
+     * Must be called once during SearchEngine.Config().
+     *
+     * @param contextUser - The user context for database queries
+     */
+    CheckAvailability(contextUser: UserInfo): Promise<void>;
+    /**
+     * Execute a file search across all eligible storage accounts.
+     *
+     * @param query - The search query text
+     * @param topK - Maximum number of results to retrieve
+     * @param _filters - Optional filters (currently unused for storage search)
+     * @param contextUser - The user performing the search
+     * @returns Scored result items from storage search
+     */
+    Search(query: string, topK: number, _filters: SearchFilters | undefined, contextUser: UserInfo): Promise<SearchResultItem[]>;
+    /**
+     * Filter storage accounts by checking FileStorageAccountPermission records
+     * for the given user. If an account has no permission records, it is
+     * accessible to everyone (backwards compatible).
+     */
+    private filterAccountsByPermissions;
+    /**
+     * Search a single storage account using the provider's native SearchFiles API.
+     */
+    private searchOneAccount;
+    /**
+     * Convert FileSearchResult items to SearchResultItem format with relevance scores.
+     */
+    private convertResults;
+    /**
+     * Calculate a relevance score for a file search result.
+     * Uses the provider's relevance score if available, otherwise
+     * falls back to a rank-based score with name-match boosting.
+     */
+    private calculateScore;
+    /**
+     * Build a display snippet for a file search result.
+     */
+    private buildSnippet;
+    /**
+     * Build tags for a file search result.
+     */
+    private buildTags;
+    /**
+     * Get an appropriate Font Awesome icon for a file based on its extension/content type.
+     */
+    private getFileIcon;
+    /**
+     * Format a file size in bytes to a human-readable string.
+     */
+    private formatFileSize;
+}
+//# sourceMappingURL=StorageSearchProvider.d.ts.map

package/dist/generic/StorageSearchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageSearchProvider.d.ts","sourceRoot":"","sources":["../../src/generic/StorageSearchProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAgC,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAY9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAoB,MAAM,gBAAgB,CAAC;AAWjG;;;;;;;;;GASG;AACH,qBACa,qBAAsB,SAAQ,kBAAkB;IACzD,SAAgB,UAAU,EAAE,YAAY,CAAa;IAErD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,mBAAmB,CAA2B;IACtD,OAAO,CAAC,YAAY,CAA8C;IAElE;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;;;;OAKG;IACU,iBAAiB,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDpE;;;;;;;;OAQG;IACU,MAAM,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAyC9B;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAuCnC;;OAEG;YACW,gBAAgB;IAiC9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAmCtB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiCpB;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkCnB;;OAEG;IACH,OAAO,CAAC,cAAc;CAMzB"}