@memberjunction/ng-search 5.23.0 → 5.25.0

package/dist/lib/search-types.d.ts

@@ -18,6 +18,8 @@ export interface SearchResultItem {
     RecordID: string;
     /** Classification of the result source */
     SourceType: 'entity' | 'content-item' | 'file' | 'web-page';
+    /** Discriminator for UI rendering: 'entity-record', 'storage-file', or 'content-item' */
+    ResultType?: string;
     /** Relevance score between 0 and 1 */
     Score: number;
     /** Breakdown of how the score was computed */
@@ -32,6 +34,14 @@ export interface SearchResultItem {
     RecordName?: string;
     /** When this result was matched */
     MatchedAt: Date;
+    /** Raw vector metadata JSON — contains all entity fields stored in the vector DB */
+    RawMetadata?: string;
+    /** 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 */
+    ProviderIcon?: string;
 }
 /** Breakdown of score contribution from each search source */
 export interface ScoreBreakdown {
@@ -83,7 +93,7 @@ export interface SearchRequest {
     /** Active filter selections */
     ActiveFilters: Record<string, string[]>;
     /** Which search sources to include */
-    IncludeSources: ('vector' | 'fulltext' | 'entity')[];
+    IncludeSources: ('vector' | 'fulltext' | 'entity' | 'storage')[];
     /**
      * Minimum relevance score (0-1) to include in results.
      * Results below this threshold are filtered out.
@@ -91,6 +101,21 @@ export interface SearchRequest {
      */
     MinScore?: number;
 }
+/** Metadata about an active search provider from the server */
+export interface SearchProviderInfo {
+    /** SearchProvider record ID */
+    ID: string;
+    /** Provider name */
+    Name: string;
+    /** UI display label */
+    DisplayName: string;
+    /** Font Awesome icon class */
+    Icon: string;
+    /** The SourceType key this provider uses */
+    SourceType: string;
+    /** Priority (lower = higher) */
+    Priority: number;
+}
 /** Search response from the service */
 export interface SearchResponse {
     /** Whether the search succeeded */
@@ -110,7 +135,10 @@ export interface SearchResponse {
         Vector: number;
         FullText: number;
         Entity: number;
+        Storage: number;
     };
+    /** Active search providers metadata (for UI labels and icons) */
+    Providers: SearchProviderInfo[];
     /** Error message if Success is false */
     ErrorMessage?: string;
 }

package/dist/lib/search-types.d.ts.map

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

package/dist/lib/search-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-types.js","sourceRoot":"","sources":["../../src/lib/search-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * @fileoverview Shared types for the ng-search package.\n *\n * Defines the data contracts for search results, filters,\n * and events used across all search components.\n */\n\n/** Represents a single search result item */\nexport interface SearchResultItem {\n    /** Unique identifier */\n    ID: string;\n    /** Display title */\n    Title: string;\n    /** Short text snippet showing match context */\n    Snippet: string;\n    /** The entity name this result belongs to */\n    EntityName: string;\n    /** The primary key of the source record */\n    RecordID: string;\n    /** Classification of the result source */\n    SourceType: 'entity' | 'content-item' | 'file' | 'web-page';\n    /** Relevance score between 0 and 1 */\n    Score: number;\n    /** Breakdown of how the score was computed */\n    ScoreBreakdown: ScoreBreakdown;\n    /** Human-readable tags */\n    Tags: string[];\n    /** Font Awesome icon class for the source type */\n    SourceIcon: string;\n    /** Entity-specific icon from EntityInfo.Icon (e.g., \"fa-solid fa-robot\") */\n    EntityIcon?: string;\n    /** Human-readable record name resolved from EntityRecordName */\n    RecordName?: string;\n    /** When this result was matched */\n    MatchedAt: Date;\n}\n\n/** Breakdown of score contribution from each search source */\nexport interface ScoreBreakdown {\n    Vector?: number;\n    FullText?: number;\n    Entity?: number;\n}\n\n/** Grouped search results by source type */\nexport interface SearchResultGroup {\n    /** The source type label */\n    Label: string;\n    /** Font Awesome icon class */\n    Icon: string;\n    /** The source type key */\n    SourceType: string;\n    /** Results in this group */\n    Results: SearchResultItem[];\n    /** Total count for this source (may exceed Results.length if paginated) */\n    TotalCount: number;\n}\n\n/** Faceted filter configuration */\nexport interface SearchFilter {\n    /** Filter category name */\n    Category: string;\n    /** Filter options within this category */\n    Options: SearchFilterOption[];\n    /** Whether multiple options can be selected */\n    MultiSelect: boolean;\n}\n\n/** Single filter option within a category */\nexport interface SearchFilterOption {\n    /** Display label */\n    Label: string;\n    /** Value to filter by */\n    Value: string;\n    /** Count of results matching this option */\n    Count: number;\n    /** Whether this option is currently selected */\n    IsSelected: boolean;\n    /** Font Awesome icon class */\n    Icon?: string;\n}\n\n/** Search request parameters */\nexport interface SearchRequest {\n    /** The search query string */\n    Query: string;\n    /** Maximum number of results to return */\n    MaxResults: number;\n    /** Active filter selections */\n    ActiveFilters: Record<string, string[]>;\n    /** Which search sources to include */\n    IncludeSources: ('vector' | 'fulltext' | 'entity')[];\n    /**\n     * Minimum relevance score (0-1) to include in results.\n     * Results below this threshold are filtered out.\n     * Default: 0.35 (35%).\n     */\n    MinScore?: number;\n}\n\n/** Search response from the service */\nexport interface SearchResponse {\n    /** Whether the search succeeded */\n    Success: boolean;\n    /** The search results */\n    Results: SearchResultItem[];\n    /** Grouped results by source type */\n    Groups: SearchResultGroup[];\n    /** Available filters based on results */\n    Filters: SearchFilter[];\n    /** Total result count across all sources */\n    TotalCount: number;\n    /** Time taken in milliseconds */\n    ElapsedMs: number;\n    /** Count of results from each source */\n    SourceCounts: { Vector: number; FullText: number; Entity: number };\n    /** Error message if Success is false */\n    ErrorMessage?: string;\n}\n\n/** Event emitted when a search result is selected */\nexport interface SearchResultSelectedEvent {\n    /** The selected result item */\n    Result: SearchResultItem;\n    /** Whether to open in a new tab */\n    OpenInNewTab: boolean;\n}\n\n/** Event emitted when filters change */\nexport interface SearchFilterChangeEvent {\n    /** The filter category that changed */\n    Category: string;\n    /** The new selected values */\n    SelectedValues: string[];\n}\n\n/** Event emitted when search is executed */\nexport interface SearchExecutedEvent {\n    /** The search query */\n    Query: string;\n    /** Active filters */\n    Filters: Record<string, string[]>;\n    /** Number of results returned */\n    ResultCount: number;\n    /** Time taken in ms */\n    ElapsedMs: number;\n}\n"]}
+{"version":3,"file":"search-types.js","sourceRoot":"","sources":["../../src/lib/search-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * @fileoverview Shared types for the ng-search package.\n *\n * Defines the data contracts for search results, filters,\n * and events used across all search components.\n */\n\n/** Represents a single search result item */\nexport interface SearchResultItem {\n    /** Unique identifier */\n    ID: string;\n    /** Display title */\n    Title: string;\n    /** Short text snippet showing match context */\n    Snippet: string;\n    /** The entity name this result belongs to */\n    EntityName: string;\n    /** The primary key of the source record */\n    RecordID: string;\n    /** Classification of the result source */\n    SourceType: 'entity' | 'content-item' | 'file' | 'web-page';\n    /** Discriminator for UI rendering: 'entity-record', 'storage-file', or 'content-item' */\n    ResultType?: string;\n    /** Relevance score between 0 and 1 */\n    Score: number;\n    /** Breakdown of how the score was computed */\n    ScoreBreakdown: ScoreBreakdown;\n    /** Human-readable tags */\n    Tags: string[];\n    /** Font Awesome icon class for the source type */\n    SourceIcon: string;\n    /** Entity-specific icon from EntityInfo.Icon (e.g., \"fa-solid fa-robot\") */\n    EntityIcon?: string;\n    /** Human-readable record name resolved from EntityRecordName */\n    RecordName?: string;\n    /** When this result was matched */\n    MatchedAt: Date;\n    /** Raw vector metadata JSON — contains all entity fields stored in the vector DB */\n    RawMetadata?: string;\n    /** ID of the SearchProvider metadata record that produced this result */\n    ProviderId?: string;\n    /** Display label from the SearchProvider metadata (e.g., \"Database\", \"Semantic Search\") */\n    ProviderLabel?: string;\n    /** Font Awesome icon class from the SearchProvider metadata */\n    ProviderIcon?: string;\n}\n\n/** Breakdown of score contribution from each search source */\nexport interface ScoreBreakdown {\n    Vector?: number;\n    FullText?: number;\n    Entity?: number;\n}\n\n/** Grouped search results by source type */\nexport interface SearchResultGroup {\n    /** The source type label */\n    Label: string;\n    /** Font Awesome icon class */\n    Icon: string;\n    /** The source type key */\n    SourceType: string;\n    /** Results in this group */\n    Results: SearchResultItem[];\n    /** Total count for this source (may exceed Results.length if paginated) */\n    TotalCount: number;\n}\n\n/** Faceted filter configuration */\nexport interface SearchFilter {\n    /** Filter category name */\n    Category: string;\n    /** Filter options within this category */\n    Options: SearchFilterOption[];\n    /** Whether multiple options can be selected */\n    MultiSelect: boolean;\n}\n\n/** Single filter option within a category */\nexport interface SearchFilterOption {\n    /** Display label */\n    Label: string;\n    /** Value to filter by */\n    Value: string;\n    /** Count of results matching this option */\n    Count: number;\n    /** Whether this option is currently selected */\n    IsSelected: boolean;\n    /** Font Awesome icon class */\n    Icon?: string;\n}\n\n/** Search request parameters */\nexport interface SearchRequest {\n    /** The search query string */\n    Query: string;\n    /** Maximum number of results to return */\n    MaxResults: number;\n    /** Active filter selections */\n    ActiveFilters: Record<string, string[]>;\n    /** Which search sources to include */\n    IncludeSources: ('vector' | 'fulltext' | 'entity' | 'storage')[];\n    /**\n     * Minimum relevance score (0-1) to include in results.\n     * Results below this threshold are filtered out.\n     * Default: 0.35 (35%).\n     */\n    MinScore?: number;\n}\n\n/** Metadata about an active search provider from the server */\nexport interface SearchProviderInfo {\n    /** SearchProvider record ID */\n    ID: string;\n    /** Provider name */\n    Name: string;\n    /** UI display label */\n    DisplayName: string;\n    /** Font Awesome icon class */\n    Icon: string;\n    /** The SourceType key this provider uses */\n    SourceType: string;\n    /** Priority (lower = higher) */\n    Priority: number;\n}\n\n/** Search response from the service */\nexport interface SearchResponse {\n    /** Whether the search succeeded */\n    Success: boolean;\n    /** The search results */\n    Results: SearchResultItem[];\n    /** Grouped results by source type */\n    Groups: SearchResultGroup[];\n    /** Available filters based on results */\n    Filters: SearchFilter[];\n    /** Total result count across all sources */\n    TotalCount: number;\n    /** Time taken in milliseconds */\n    ElapsedMs: number;\n    /** Count of results from each source */\n    SourceCounts: { Vector: number; FullText: number; Entity: number; Storage: number };\n    /** Active search providers metadata (for UI labels and icons) */\n    Providers: SearchProviderInfo[];\n    /** Error message if Success is false */\n    ErrorMessage?: string;\n}\n\n/** Event emitted when a search result is selected */\nexport interface SearchResultSelectedEvent {\n    /** The selected result item */\n    Result: SearchResultItem;\n    /** Whether to open in a new tab */\n    OpenInNewTab: boolean;\n}\n\n/** Event emitted when filters change */\nexport interface SearchFilterChangeEvent {\n    /** The filter category that changed */\n    Category: string;\n    /** The new selected values */\n    SelectedValues: string[];\n}\n\n/** Event emitted when search is executed */\nexport interface SearchExecutedEvent {\n    /** The search query */\n    Query: string;\n    /** Active filters */\n    Filters: Record<string, string[]>;\n    /** Number of results returned */\n    ResultCount: number;\n    /** Time taken in ms */\n    ElapsedMs: number;\n}\n"]}

package/dist/lib/search.service.d.ts

@@ -12,18 +12,27 @@ export declare class SearchService {
     SearchResults$: BehaviorSubject<SearchResponse | null>;
     /** Whether a search is in progress */
     IsSearching$: BehaviorSubject<boolean>;
-    /** Recent search history (kept in memory, max 20 entries) */
+    /** Recent search history (persisted via UserInfoEngine, max 20 entries) */
     RecentSearches$: BehaviorSubject<RecentSearch[]>;
     /** Error stream */
     Errors$: Subject<string>;
     private readonly maxRecentSearches;
+    private recentSearchesLoaded;
+    /** Cached provider metadata keyed by SourceType, populated from search responses */
+    private providersBySourceType;
     /**
      * Execute a search request via the SearchKnowledge GraphQL mutation.
      */
     ExecuteSearch(request: SearchRequest): Promise<SearchResponse>;
+    /**
+     * Lightweight preview search for autocomplete/typeahead.
+     * Does NOT update SearchResults$ or IsSearching$ observables,
+     * and does NOT add to recent search history.
+     */
+    PreviewSearch(query: string, maxResults?: number): Promise<SearchResponse>;
     /** Clear the current search results */
     ClearResults(): void;
-    /** Clear recent search history */
+    /** Clear recent search history (memory and persisted) */
     ClearRecentSearches(): void;
     /**
      * Group flat results by source type for display.
@@ -37,15 +46,28 @@ export declare class SearchService {
     GetSourceIcon(sourceType: string): string;
     private buildSourceTypeFilter;
     private buildEntityNameFilter;
+    private buildFileTypeFilter;
     private buildTagFilter;
+    /**
+     * Load persisted recent searches from UserInfoEngine.
+     * Safe to call multiple times — only loads once.
+     */
+    LoadRecentSearches(): Promise<void>;
     private addToRecentSearches;
+    private persistRecentSearches;
+    /** Cache provider metadata by SourceType for use in GroupResults/BuildFilters */
+    private cacheProviders;
     private createEmptyResponse;
     /**
-     * Execute search via the SearchKnowledge GraphQL mutation.
+     * Execute search via the GraphQLSearchClient.
      */
     private executeGraphQLSearch;
-    /** Build the GraphQL filters input from active filter selections */
-    private buildFiltersInput;
+    /** Convert a SearchClientResponse into the SearchResponse shape used by this service */
+    private mapClientResponseToSearchResponse;
+    /** Map a single SearchClientResultItem to a SearchResultItem */
+    private mapClientResultItem;
+    /** Build the client filters from active filter selections */
+    private buildClientFilters;
     static ɵfac: i0.ɵɵFactoryDeclaration<SearchService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SearchService>;
 }

package/dist/lib/search.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.service.d.ts","sourceRoot":"","sources":["../../src/lib/search.service.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEhD,OAAO,EACH,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EAEf,MAAM,gBAAgB,CAAC;;AAqBxB,sCAAsC;AACtC,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,qBACa,aAAa;IACtB,8BAA8B;IACvB,cAAc,yCAAoD;IAEzE,sCAAsC;IAC/B,YAAY,2BAAuC;IAE1D,6DAA6D;IACtD,eAAe,kCAA2C;IAEjE,mBAAmB;IACZ,OAAO,kBAAyB;IAEvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAM;IAExC;;OAEG;IACU,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAuB3E,uCAAuC;IAChC,YAAY,IAAI,IAAI;IAI3B,kCAAkC;IAC3B,mBAAmB,IAAI,IAAI;IAIlC;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,EAAE;IAsBrE;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,YAAY,EAAE;IAQhE,2CAA2C;IACpC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIhD,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;YACW,oBAAoB;IAsGlC,oEAAoE;IACpE,OAAO,CAAC,iBAAiB;yCAjRhB,aAAa;6CAAb,aAAa;CAySzB"}
+{"version":3,"file":"search.service.d.ts","sourceRoot":"","sources":["../../src/lib/search.service.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAUhD,OAAO,EACH,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EAGf,MAAM,gBAAgB,CAAC;;AA8BxB,sCAAsC;AACtC,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACvB;AASD,qBACa,aAAa;IACtB,8BAA8B;IACvB,cAAc,yCAAoD;IAEzE,sCAAsC;IAC/B,YAAY,2BAAuC;IAE1D,2EAA2E;IACpE,eAAe,kCAA2C;IAEjE,mBAAmB;IACZ,OAAO,kBAAyB;IAEvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAM;IACxC,OAAO,CAAC,oBAAoB,CAAS;IAErC,oFAAoF;IACpF,OAAO,CAAC,qBAAqB,CAAyC;IAEtE;;OAEG;IACU,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAuB3E;;;;OAIG;IACU,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,GAAG,OAAO,CAAC,cAAc,CAAC;IAoB1F,uCAAuC;IAChC,YAAY,IAAI,IAAI;IAI3B,yDAAyD;IAClD,mBAAmB,IAAI,IAAI;IAKlC;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,EAAE;IA0BrE;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,YAAY,EAAE;IAShE,2CAA2C;IACpC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIhD,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,qBAAqB;IAkC7B,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,cAAc;IAoBtB;;;OAGG;IACU,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BhD,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,qBAAqB;IAa7B,iFAAiF;IACjF,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;YACW,oBAAoB;IAwBlC,wFAAwF;IACxF,OAAO,CAAC,iCAAiC;IAsCzC,gEAAgE;IAChE,OAAO,CAAC,mBAAmB;IAuB3B,6DAA6D;IAC7D,OAAO,CAAC,kBAAkB;yCAvYjB,aAAa;6CAAb,aAAa;CA+ZzB"}

package/dist/lib/search.service.js

@@ -6,34 +6,48 @@
  */
 import { Injectable } from '@angular/core';
 import { BehaviorSubject, Subject } from 'rxjs';
-import { Metadata } from '@memberjunction/core';
+import { Metadata, StartupManager } from '@memberjunction/core';
+import { UserInfoEngine } from '@memberjunction/core-entities';
+import { MJEventType, MJGlobal } from '@memberjunction/global';
+import { GraphQLSearchClient, GraphQLDataProvider } from '@memberjunction/graphql-dataprovider';
 import * as i0 from "@angular/core";
 /** Default minimum relevance score threshold (0-1). Results below this are filtered out. */
 const DEFAULT_MIN_SCORE = 0.35;
-/** Default icon mapping for source types */
-const SOURCE_TYPE_ICONS = {
+/** Fallback icon mapping for source types (used when provider metadata is not available) */
+const FALLBACK_SOURCE_ICONS = {
     'entity': 'fa-solid fa-database',
+    'vector': 'fa-solid fa-brain',
+    'fulltext': 'fa-solid fa-magnifying-glass',
     'content-item': 'fa-solid fa-file-lines',
     'file': 'fa-solid fa-file',
     'web-page': 'fa-solid fa-globe',
+    'storage': 'fa-solid fa-folder-open',
 };
-/** Default labels for source types */
-const SOURCE_TYPE_LABELS = {
-    'entity': 'Entity Records',
+/** Fallback labels for source types (used when provider metadata is not available) */
+const FALLBACK_SOURCE_LABELS = {
+    'entity': 'Database',
+    'vector': 'Semantic Search',
+    'fulltext': 'Full-Text Search',
     'content-item': 'Content Items',
     'file': 'Documents',
     'web-page': 'Web Pages',
+    'storage': 'File Storage',
 };
+/** User setting key for persisting recent searches */
+const RECENT_SEARCHES_KEY = 'search.recentSearches';
 export class SearchService {
     /** Current search response */
     SearchResults$ = new BehaviorSubject(null);
     /** Whether a search is in progress */
     IsSearching$ = new BehaviorSubject(false);
-    /** Recent search history (kept in memory, max 20 entries) */
+    /** Recent search history (persisted via UserInfoEngine, max 20 entries) */
     RecentSearches$ = new BehaviorSubject([]);
     /** Error stream */
     Errors$ = new Subject();
     maxRecentSearches = 20;
+    recentSearchesLoaded = false;
+    /** Cached provider metadata keyed by SourceType, populated from search responses */
+    providersBySourceType = new Map();
     /**
      * Execute a search request via the SearchKnowledge GraphQL mutation.
      */
@@ -58,13 +72,37 @@ export class SearchService {
             this.IsSearching$.next(false);
         }
     }
+    /**
+     * Lightweight preview search for autocomplete/typeahead.
+     * Does NOT update SearchResults$ or IsSearching$ observables,
+     * and does NOT add to recent search history.
+     */
+    async PreviewSearch(query, maxResults = 8) {
+        try {
+            if (!query.trim()) {
+                return this.createEmptyResponse();
+            }
+            const provider = Metadata.Provider;
+            if (!(provider instanceof GraphQLDataProvider)) {
+                return this.createEmptyResponse('GraphQL provider not available');
+            }
+            const client = new GraphQLSearchClient(provider);
+            const clientResponse = await client.PreviewSearch(query, maxResults);
+            return this.mapClientResponseToSearchResponse(clientResponse);
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Preview search failed';
+            return this.createEmptyResponse(errorMessage);
+        }
+    }
     /** Clear the current search results */
     ClearResults() {
         this.SearchResults$.next(null);
     }
-    /** Clear recent search history */
+    /** Clear recent search history (memory and persisted) */
     ClearRecentSearches() {
         this.RecentSearches$.next([]);
+        this.persistRecentSearches([]);
     }
     /**
      * Group flat results by source type for display.
@@ -81,13 +119,17 @@ export class SearchService {
                 groupMap.set(key, [result]);
             }
         }
-        return Array.from(groupMap.entries()).map(([sourceType, items]) => ({
-            Label: SOURCE_TYPE_LABELS[sourceType] ?? sourceType,
-            Icon: SOURCE_TYPE_ICONS[sourceType] ?? 'fa-solid fa-circle',
-            SourceType: sourceType,
-            Results: items,
-            TotalCount: items.length
-        }));
+        return Array.from(groupMap.entries()).map(([sourceType, items]) => {
+            // Priority: cached provider metadata > per-result metadata > fallback maps
+            const cached = this.providersBySourceType.get(sourceType);
+            return {
+                Label: cached?.DisplayName ?? items[0]?.ProviderLabel ?? FALLBACK_SOURCE_LABELS[sourceType] ?? sourceType,
+                Icon: cached?.Icon ?? items[0]?.ProviderIcon ?? FALLBACK_SOURCE_ICONS[sourceType] ?? 'fa-solid fa-circle',
+                SourceType: sourceType,
+                Results: items,
+                TotalCount: items.length
+            };
+        });
     }
     /**
      * Build filter facets from a set of results.
@@ -96,31 +138,41 @@ export class SearchService {
         return [
             this.buildSourceTypeFilter(results),
             this.buildEntityNameFilter(results),
+            this.buildFileTypeFilter(results),
             this.buildTagFilter(results)
-        ];
+        ].filter(f => f.Options.length > 0); // Hide categories with no options
     }
     /** Get the icon for a given source type */
     GetSourceIcon(sourceType) {
-        return SOURCE_TYPE_ICONS[sourceType] ?? 'fa-solid fa-circle';
+        return this.providersBySourceType.get(sourceType)?.Icon ?? FALLBACK_SOURCE_ICONS[sourceType] ?? 'fa-solid fa-circle';
     }
     buildSourceTypeFilter(results) {
         const counts = new Map();
         for (const r of results) {
             counts.set(r.SourceType, (counts.get(r.SourceType) ?? 0) + 1);
         }
-        const options = Array.from(counts.entries()).map(([type, count]) => ({
-            Label: SOURCE_TYPE_LABELS[type] ?? type,
-            Value: type,
-            Count: count,
-            IsSelected: false,
-            Icon: SOURCE_TYPE_ICONS[type]
-        }));
-        return { Category: 'Source Type', Options: options, MultiSelect: true };
+        const options = Array.from(counts.entries()).map(([type, count]) => {
+            const cached = this.providersBySourceType.get(type);
+            return {
+                Label: cached?.DisplayName ?? FALLBACK_SOURCE_LABELS[type] ?? type,
+                Value: type,
+                Count: count,
+                IsSelected: false,
+                Icon: cached?.Icon ?? FALLBACK_SOURCE_ICONS[type]
+            };
+        });
+        return { Category: 'Source', Options: options, MultiSelect: true };
     }
     buildEntityNameFilter(results) {
         const counts = new Map();
+        let fileCount = 0;
         for (const r of results) {
-            counts.set(r.EntityName, (counts.get(r.EntityName) ?? 0) + 1);
+            if (r.ResultType === 'storage-file') {
+                fileCount++;
+            }
+            else {
+                counts.set(r.EntityName, (counts.get(r.EntityName) ?? 0) + 1);
+            }
         }
         const options = Array.from(counts.entries())
             .sort((a, b) => b[1] - a[1])
@@ -131,8 +183,39 @@ export class SearchService {
             IsSelected: false,
             Icon: 'fa-solid fa-table'
         }));
+        // Add a single "Files" entry for all storage file results
+        if (fileCount > 0) {
+            options.push({
+                Label: 'Files',
+                Value: '__storage-files__',
+                Count: fileCount,
+                IsSelected: false,
+                Icon: 'fa-solid fa-file'
+            });
+        }
         return { Category: 'Entity', Options: options, MultiSelect: true };
     }
+    buildFileTypeFilter(results) {
+        const counts = new Map();
+        for (const r of results) {
+            if (r.ResultType !== 'storage-file')
+                continue;
+            const ext = r.Title?.split('.').pop()?.toUpperCase();
+            if (ext && ext.length <= 6) {
+                counts.set(ext, (counts.get(ext) ?? 0) + 1);
+            }
+        }
+        const options = Array.from(counts.entries())
+            .sort((a, b) => b[1] - a[1])
+            .map(([ext, count]) => ({
+            Label: ext,
+            Value: ext,
+            Count: count,
+            IsSelected: false,
+            Icon: 'fa-solid fa-file'
+        }));
+        return { Category: 'File Type', Options: options, MultiSelect: true };
+    }
     buildTagFilter(results) {
         const counts = new Map();
         for (const r of results) {
@@ -152,6 +235,38 @@ export class SearchService {
         }));
         return { Category: 'Tags', Options: options, MultiSelect: true };
     }
+    /**
+     * Load persisted recent searches from UserInfoEngine.
+     * Safe to call multiple times — only loads once.
+     */
+    async LoadRecentSearches() {
+        if (this.recentSearchesLoaded)
+            return;
+        try {
+            MJGlobal.Instance.GetEventListener(true).subscribe(async (event) => {
+                if (event.event === MJEventType.LoggedIn) {
+                    await StartupManager.Instance.Startup();
+                    const engine = UserInfoEngine.Instance;
+                    console.log('[SearchService] After Startup — engine.Loaded:', engine.Loaded, 'UserSettings count:', engine.UserSettings.length);
+                    const json = engine.GetSetting(RECENT_SEARCHES_KEY);
+                    console.log('[SearchService] GetSetting("' + RECENT_SEARCHES_KEY + '"):', json?.substring(0, 100));
+                    if (json) {
+                        const parsed = JSON.parse(json);
+                        const searches = parsed.map(s => ({
+                            Query: s.Query,
+                            Timestamp: new Date(s.Timestamp),
+                            ResultCount: s.ResultCount
+                        }));
+                        this.RecentSearches$.next(searches);
+                    }
+                }
+            });
+        }
+        catch (err) {
+            console.error('[SearchService] LoadRecentSearches error:', err);
+        }
+        this.recentSearchesLoaded = true;
+    }
     addToRecentSearches(query, resultCount) {
         const current = this.RecentSearches$.value;
         const filtered = current.filter(s => s.Query !== query);
@@ -160,6 +275,26 @@ export class SearchService {
             ...filtered
         ].slice(0, this.maxRecentSearches);
         this.RecentSearches$.next(updated);
+        this.persistRecentSearches(updated);
+    }
+    persistRecentSearches(searches) {
+        try {
+            const json = searches.map(s => ({
+                Query: s.Query,
+                Timestamp: s.Timestamp.toISOString(),
+                ResultCount: s.ResultCount
+            }));
+            UserInfoEngine.Instance.SetSettingDebounced(RECENT_SEARCHES_KEY, JSON.stringify(json));
+        }
+        catch {
+            // Silently fail if UserInfoEngine not available
+        }
+    }
+    /** Cache provider metadata by SourceType for use in GroupResults/BuildFilters */
+    cacheProviders(providers) {
+        for (const p of providers) {
+            this.providersBySourceType.set(p.SourceType, p);
+        }
     }
     createEmptyResponse(errorMessage) {
         return {
@@ -169,105 +304,101 @@ export class SearchService {
             Filters: [],
             TotalCount: 0,
             ElapsedMs: 0,
-            SourceCounts: { Vector: 0, FullText: 0, Entity: 0 },
+            SourceCounts: { Vector: 0, FullText: 0, Entity: 0, Storage: 0 },
+            Providers: [],
             ErrorMessage: errorMessage
         };
     }
     /**
-     * Execute search via the SearchKnowledge GraphQL mutation.
+     * Execute search via the GraphQLSearchClient.
      */
     async executeGraphQLSearch(request) {
         if (!request.Query.trim()) {
             return this.createEmptyResponse();
         }
         const provider = Metadata.Provider;
-        if (!provider?.ExecuteGQL) {
+        if (!(provider instanceof GraphQLDataProvider)) {
             return this.createEmptyResponse('GraphQL provider not available');
         }
-        const mutation = `
-            mutation SearchKnowledge($query: String!, $maxResults: Float, $filters: SearchFiltersInput, $minScore: Float) {
-                SearchKnowledge(query: $query, maxResults: $maxResults, filters: $filters, minScore: $minScore) {
-                    Success
-                    TotalCount
-                    ElapsedMs
-                    ErrorMessage
-                    SourceCounts {
-                        Vector
-                        FullText
-                        Entity
-                    }
-                    Results {
-                        ID
-                        EntityName
-                        RecordID
-                        SourceType
-                        Title
-                        Snippet
-                        Score
-                        ScoreBreakdown {
-                            Vector
-                            FullText
-                            Entity
-                        }
-                        Tags
-                        EntityIcon
-                        RecordName
-                        MatchedAt
-                    }
-                }
-            }
-        `;
-        const filtersInput = this.buildFiltersInput(request);
+        const client = new GraphQLSearchClient(provider);
+        const filters = this.buildClientFilters(request);
         const minScore = request.MinScore ?? DEFAULT_MIN_SCORE;
-        const variables = {
-            query: request.Query,
-            maxResults: request.MaxResults || 20,
-            filters: filtersInput,
-            minScore: minScore > 0 ? minScore : undefined,
-        };
-        const gqlResult = await provider.ExecuteGQL(mutation, variables);
-        const data = gqlResult['SearchKnowledge'];
-        if (!data?.Success) {
-            return this.createEmptyResponse(data?.ErrorMessage ?? 'Search failed');
+        const clientResponse = await client.ExecuteSearch({
+            Query: request.Query,
+            MaxResults: request.MaxResults || 20,
+            MinScore: minScore > 0 ? minScore : undefined,
+            Filters: filters
+        });
+        return this.mapClientResponseToSearchResponse(clientResponse);
+    }
+    /** Convert a SearchClientResponse into the SearchResponse shape used by this service */
+    mapClientResponseToSearchResponse(clientResponse) {
+        if (!clientResponse.Success) {
+            return this.createEmptyResponse(clientResponse.ErrorMessage ?? 'Search failed');
         }
-        const results = (data.Results ?? []).map(r => ({
+        // Cache provider metadata for use in GroupResults/BuildFilters
+        const providers = (clientResponse.Providers ?? []).map(p => ({
+            ID: p.ID,
+            Name: p.Name,
+            DisplayName: p.DisplayName,
+            Icon: p.Icon,
+            SourceType: p.SourceType,
+            Priority: p.Priority,
+        }));
+        this.cacheProviders(providers);
+        const results = (clientResponse.Results ?? []).map(r => this.mapClientResultItem(r));
+        const groups = this.GroupResults(results);
+        const filters = this.BuildFilters(results);
+        return {
+            Success: true,
+            Results: results,
+            Groups: groups,
+            Filters: filters,
+            TotalCount: clientResponse.TotalCount,
+            ElapsedMs: clientResponse.ElapsedMs,
+            SourceCounts: {
+                Vector: clientResponse.SourceCounts.Vector,
+                FullText: clientResponse.SourceCounts.FullText,
+                Entity: clientResponse.SourceCounts.Entity,
+                Storage: clientResponse.SourceCounts.Storage
+            },
+            Providers: providers,
+        };
+    }
+    /** Map a single SearchClientResultItem to a SearchResultItem */
+    mapClientResultItem(r) {
+        return {
             ID: r.ID,
             Title: r.RecordName || r.Title,
             Snippet: r.Snippet,
             EntityName: r.EntityName,
             RecordID: r.RecordID,
             SourceType: r.SourceType || 'entity',
+            ResultType: r.ResultType,
             Score: r.Score,
             ScoreBreakdown: r.ScoreBreakdown ?? {},
             Tags: r.Tags ?? [],
-            SourceIcon: r.EntityIcon || SOURCE_TYPE_ICONS[r.SourceType] || 'fa-solid fa-database',
+            SourceIcon: r.EntityIcon || r.ProviderIcon || FALLBACK_SOURCE_ICONS[r.SourceType] || 'fa-solid fa-database',
             EntityIcon: r.EntityIcon,
             RecordName: r.RecordName,
             MatchedAt: new Date(r.MatchedAt),
-        }));
-        const groups = this.GroupResults(results);
-        const filters = this.BuildFilters(results);
-        return {
-            Success: true,
-            Results: results,
-            Groups: groups,
-            Filters: filters,
-            TotalCount: data.TotalCount,
-            ElapsedMs: data.ElapsedMs,
-            SourceCounts: data.SourceCounts,
+            RawMetadata: r.RawMetadata,
+            ProviderId: r.ProviderId,
+            ProviderLabel: r.ProviderLabel,
+            ProviderIcon: r.ProviderIcon,
         };
     }
-    /** Build the GraphQL filters input from active filter selections */
-    buildFiltersInput(request) {
+    /** Build the client filters from active filter selections */
+    buildClientFilters(request) {
         if (!request.ActiveFilters || Object.keys(request.ActiveFilters).length === 0) {
-            return null;
+            return undefined;
         }
         const result = {};
         const entityFilters = request.ActiveFilters['Entity'];
         if (entityFilters?.length) {
             result.EntityNames = entityFilters;
         }
-        const sourceFilters = request.ActiveFilters['Source Type'];
+        const sourceFilters = request.ActiveFilters['Source'];
         if (sourceFilters?.length) {
             result.SourceTypes = sourceFilters;
         }
@@ -275,7 +406,7 @@ export class SearchService {
         if (tagFilters?.length) {
             result.Tags = tagFilters;
         }
-        return Object.keys(result).length > 0 ? result : null;
+        return Object.keys(result).length > 0 ? result : undefined;
     }
     static ɵfac = function SearchService_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || SearchService)(); };
     static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: SearchService, factory: SearchService.ɵfac, providedIn: 'root' });