captify 0.1.18 → 1.1.0

package/dist/search/api/migration.handlers.js

@@ -0,0 +1,75 @@
+/**
+ * Search Migration API Handlers
+ *
+ * Admin handlers for managing OpenSearch index schema migrations.
+ */
+import { ACTION, RESOURCE } from "../../permissions/permissions.constants";
+import { requirePermission } from "../../permissions/permissions.utilities";
+import { getMigrationService } from "../services/migration.service";
+import { handleApi, withAuth, getUserAwsCredentials } from "../../shared/utilities/api";
+import { BadRequestError } from "../../shared/services/services.errors";
+/**
+ * GET /api/search/migration - Get migration status for all indices
+ */
+export const getMigrationStatus = withAuth(async (_request, { userId, tenantId, user, idToken }) => handleApi(async () => {
+    const userCredentials = await getUserAwsCredentials(idToken);
+    await requirePermission({
+        userId,
+        tenantId,
+        resource: RESOURCE.SEARCH_INDICES,
+        action: ACTION.LIST,
+        groups: user.groups,
+        userCredentials,
+    });
+    const migrationService = getMigrationService();
+    const plan = await migrationService.getMigrationPlan(userCredentials);
+    return plan;
+}));
+/**
+ * POST /api/search/migration - Execute migrations for all indices
+ */
+export const executeMigrations = withAuth(async (_request, { userId, tenantId, user, idToken }) => handleApi(async () => {
+    const userCredentials = await getUserAwsCredentials(idToken);
+    await requirePermission({
+        userId,
+        tenantId,
+        resource: RESOURCE.SEARCH_INDICES,
+        action: ACTION.UPDATE,
+        groups: user.groups,
+        userCredentials,
+    });
+    const migrationService = getMigrationService();
+    const result = await migrationService.migrateAll(userCredentials);
+    return result;
+}));
+/**
+ * POST /api/search/migration/:index - Execute migration for a specific index
+ */
+export const migrateIndex = withAuth(async (request, { userId, tenantId, user, idToken }) => handleApi(async () => {
+    const { searchParams } = new URL(request.url);
+    const indexName = searchParams.get("index");
+    if (!indexName) {
+        throw new BadRequestError("Index name is required");
+    }
+    const userCredentials = await getUserAwsCredentials(idToken);
+    await requirePermission({
+        userId,
+        tenantId,
+        resource: RESOURCE.SEARCH_INDICES,
+        action: ACTION.UPDATE,
+        groups: user.groups,
+        userCredentials,
+    });
+    const migrationService = getMigrationService();
+    const result = await migrationService.migrateIndex(indexName, userCredentials);
+    return result;
+}));
+/**
+ * Migration handlers
+ */
+export const migrationHandlers = {
+    status: getMigrationStatus,
+    execute: executeMigrations,
+    migrateIndex,
+};
+//# sourceMappingURL=migration.handlers.js.map

package/dist/search/api/migration.handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.handlers.js","sourceRoot":"","sources":["../../../lib/search/api/migration.handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExE;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CACxC,KAAK,EAAE,QAAqB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CACnE,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,MAAM,eAAe,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE7D,MAAM,iBAAiB,CAAC;QACtB,MAAM;QACN,QAAQ;QACR,QAAQ,EAAE,QAAQ,CAAC,cAAc;QACjC,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;IAEtE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CACL,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CACvC,KAAK,EAAE,QAAqB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CACnE,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,MAAM,eAAe,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE7D,MAAM,iBAAiB,CAAC;QACtB,MAAM;QACN,QAAQ;QACR,QAAQ,EAAE,QAAQ,CAAC,cAAc;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IAElE,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CACL,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAClC,KAAK,EAAE,OAAoB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAClE,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CAAC,wBAAwB,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE7D,MAAM,iBAAiB,CAAC;QACtB,MAAM;QACN,QAAQ;QACR,QAAQ,EAAE,QAAQ,CAAC,cAAc;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,YAAY,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAE/E,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CACL,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE,iBAAiB;IAC1B,YAAY;CACb,CAAC"}

package/dist/search/api/search.client.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Search API Client
+ *
+ * Client-side fetch functions for the search API.
+ */
+import type { SearchClientParams, SearchResponse, SearchResultType } from "../search.interfaces";
+/**
+ * Perform a search request
+ *
+ * @param params - Search parameters
+ * @returns Search response with results
+ * @throws Error if the request fails
+ *
+ * @example
+ * ```typescript
+ * const response = await searchClient({
+ *   query: 'report',
+ *   type: 'document',
+ *   limit: 10,
+ * });
+ * console.log(response.results);
+ * ```
+ */
+export declare function searchClient(params: SearchClientParams): Promise<SearchResponse>;
+/**
+ * React Query key factory for search queries
+ */
+export declare const searchKeys: {
+    /** Base key for all search queries */
+    all: readonly ["search"];
+    /** Key for search results with specific query */
+    results: (query: string, type?: SearchResultType | "all") => readonly ["search", "results", {
+        readonly query: string;
+        readonly type: "message" | "document" | "group" | "all" | "feedback" | "user" | "agent" | "chat" | undefined;
+    }];
+};
+//# sourceMappingURL=search.client.d.ts.map

package/dist/search/api/search.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.client.d.ts","sourceRoot":"","sources":["../../../lib/search/api/search.client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AAIxC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmDtF;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,sCAAsC;;IAGtC,iDAAiD;qBAChC,MAAM,SAAS,gBAAgB,GAAG,KAAK;;;;CAEzD,CAAC"}

package/dist/search/api/search.client.js

@@ -0,0 +1,70 @@
+/**
+ * Search API Client
+ *
+ * Client-side fetch functions for the search API.
+ */
+import { SEARCH_DEFAULTS, SEARCH_ROUTES } from "../search.constants";
+import { fetchJson } from "../../shared/utilities/fetch";
+/**
+ * Perform a search request
+ *
+ * @param params - Search parameters
+ * @returns Search response with results
+ * @throws Error if the request fails
+ *
+ * @example
+ * ```typescript
+ * const response = await searchClient({
+ *   query: 'report',
+ *   type: 'document',
+ *   limit: 10,
+ * });
+ * console.log(response.results);
+ * ```
+ */
+export async function searchClient(params) {
+    const { query, type = "all", limit = SEARCH_DEFAULTS.DEFAULT_LIMIT, offset = 0, searchAfter, semantic, semanticOnly, minScore, visibleTypes, signal, } = params;
+    // Skip search if query is too short
+    if (query.length < SEARCH_DEFAULTS.MIN_QUERY_LENGTH) {
+        return {
+            results: [],
+            total: 0,
+            took: 0,
+            filters: { type },
+            pagination: { limit, offset, hasMore: false },
+        };
+    }
+    const searchParams = new URLSearchParams({
+        q: query,
+        type,
+        limit: String(limit),
+        offset: String(offset), // Always send offset for hasMore calculation
+    });
+    // Use searchAfter for cursor-based pagination (50-70% faster for deep pages)
+    if (searchAfter && searchAfter.length > 0) {
+        searchParams.set("searchAfter", JSON.stringify(searchAfter));
+    }
+    if (semantic) {
+        searchParams.set("semantic", "true");
+    }
+    if (semanticOnly) {
+        searchParams.set("semanticOnly", "true");
+    }
+    if (minScore !== undefined) {
+        searchParams.set("minScore", String(minScore));
+    }
+    if (visibleTypes && visibleTypes.length > 0) {
+        searchParams.set("visibleTypes", visibleTypes.join(","));
+    }
+    return fetchJson(`${SEARCH_ROUTES.SEARCH}?${searchParams}`, { signal });
+}
+/**
+ * React Query key factory for search queries
+ */
+export const searchKeys = {
+    /** Base key for all search queries */
+    all: ["search"],
+    /** Key for search results with specific query */
+    results: (query, type) => [...searchKeys.all, "results", { query, type }],
+};
+//# sourceMappingURL=search.client.js.map

package/dist/search/api/search.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.client.js","sourceRoot":"","sources":["../../../lib/search/api/search.client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAA0B;IAC3D,MAAM,EACJ,KAAK,EACL,IAAI,GAAG,KAAK,EACZ,KAAK,GAAG,eAAe,CAAC,aAAa,EACrC,MAAM,GAAG,CAAC,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,MAAM,GACP,GAAG,MAAM,CAAC;IAEX,oCAAoC;IACpC,IAAI,KAAK,CAAC,MAAM,GAAG,eAAe,CAAC,gBAAgB,EAAE,CAAC;QACpD,OAAO;YACL,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,EAAE,IAAI,EAAE;YACjB,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,eAAe,CAAC;QACvC,CAAC,EAAE,KAAK;QACR,IAAI;QACJ,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,6CAA6C;KACtE,CAAC,CAAC;IAEH,6EAA6E;IAC7E,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,SAAS,CAAiB,GAAG,aAAa,CAAC,MAAM,IAAI,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,sCAAsC;IACtC,GAAG,EAAE,CAAC,QAAQ,CAAU;IAExB,iDAAiD;IACjD,OAAO,EAAE,CAAC,KAAa,EAAE,IAA+B,EAAE,EAAE,CAC1D,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAU;CAC3D,CAAC"}

package/dist/search/api/search.handlers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Search API Handlers
+ *
+ * Server-side handlers for the search API endpoint.
+ */
+import type { CacheStatsResponse, SearchResponse } from "../search.interfaces";
+/**
+ * GET /api/search - Execute unified search
+ *
+ * Validates query parameters, executes unified search across all indices,
+ * and returns results with relevance scoring.
+ *
+ * @example
+ * GET /api/search?q=report&type=document&limit=10
+ */
+export declare const searchHandler: (request: import("next/server").NextRequest, context: {
+    params: Promise<Record<string, unknown>>;
+}) => Promise<import("next/server").NextResponse<{
+    error: string;
+} | SearchResponse>>;
+/**
+ * GET /api/search/cache/stats - Get cache statistics
+ *
+ * Returns statistics for both embedding and response caches.
+ * Admin-only endpoint for monitoring cache performance.
+ *
+ * @example
+ * GET /api/search/cache/stats
+ */
+export declare const cacheStatsHandler: (request: import("next/server").NextRequest, context: {
+    params: Promise<Record<string, unknown>>;
+}) => Promise<import("next/server").NextResponse<{
+    error: string;
+} | CacheStatsResponse>>;
+//# sourceMappingURL=search.handlers.d.ts.map

package/dist/search/api/search.handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.handlers.d.ts","sourceRoot":"","sources":["../../../lib/search/api/search.handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAMzF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;;oBA2DxB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;;wBAsB5B,CAAC"}

package/dist/search/api/search.handlers.js

@@ -0,0 +1,99 @@
+/**
+ * Search API Handlers
+ *
+ * Server-side handlers for the search API endpoint.
+ */
+import { withAuth } from "../../shared/utilities/api/with-auth";
+import { handleApi } from "../../shared/utilities/api/api-handler";
+import { getUserAwsCredentials } from "../../shared/utilities/api/get-user-credentials";
+import { ACTION, RESOURCE } from "../../permissions/permissions.constants";
+import { requirePermission } from "../../permissions/permissions.utilities";
+import { SEARCH_CACHE_CONFIG } from "../search.constants";
+import { searchQuerySchema } from "../search.schemas";
+import { getUnifiedSearchService } from "../services/unified-search.service";
+import { getSearchCacheService } from "../services/search-cache.service";
+import { getEmbeddingService } from "../services/embedding.service";
+/**
+ * GET /api/search - Execute unified search
+ *
+ * Validates query parameters, executes unified search across all indices,
+ * and returns results with relevance scoring.
+ *
+ * @example
+ * GET /api/search?q=report&type=document&limit=10
+ */
+export const searchHandler = withAuth(async (request, { userId, tenantId, user, idToken }) => {
+    return handleApi(async () => {
+        const userCredentials = await getUserAwsCredentials(idToken);
+        await requirePermission({
+            userId,
+            tenantId,
+            resource: RESOURCE.SEARCH,
+            action: ACTION.READ,
+            groups: user.groups,
+            userCredentials,
+        });
+        const url = new URL(request.url);
+        const params = Object.fromEntries(url.searchParams);
+        const validated = searchQuerySchema.parse(params);
+        // Build search query with tenant/user isolation
+        const searchQuery = {
+            query: validated.q,
+            type: validated.type,
+            limit: validated.limit,
+            offset: validated.offset,
+            searchAfter: validated.searchAfter,
+            tenantId,
+            userId,
+            userCredentials,
+            semantic: validated.semantic,
+            semanticOnly: validated.semanticOnly,
+            minScore: validated.minScore,
+            visibleTypes: validated.visibleTypes,
+            // Pass abort signal to cancel search when client disconnects
+            signal: request.signal,
+        };
+        // Check cache first
+        const cache = getSearchCacheService();
+        const cachedResponse = cache.get(searchQuery);
+        if (cachedResponse) {
+            return Object.assign(Object.assign({}, cachedResponse), { fromCache: true });
+        }
+        // Execute search
+        const service = getUnifiedSearchService();
+        const response = await service.search(searchQuery);
+        // Cache the response
+        cache.set(searchQuery, response);
+        return response;
+    }, { headers: { "Cache-Control": SEARCH_CACHE_CONFIG.CACHE_CONTROL } });
+});
+/**
+ * GET /api/search/cache/stats - Get cache statistics
+ *
+ * Returns statistics for both embedding and response caches.
+ * Admin-only endpoint for monitoring cache performance.
+ *
+ * @example
+ * GET /api/search/cache/stats
+ */
+export const cacheStatsHandler = withAuth(async (_request, { userId, tenantId, user, idToken }) => {
+    return handleApi(async () => {
+        const userCredentials = await getUserAwsCredentials(idToken);
+        await requirePermission({
+            userId,
+            tenantId,
+            resource: RESOURCE.SEARCH_INDICES,
+            action: ACTION.READ,
+            groups: user.groups,
+            userCredentials,
+        });
+        const embeddingService = getEmbeddingService();
+        const searchCacheService = getSearchCacheService();
+        return {
+            embedding: embeddingService.getCacheStats(),
+            response: searchCacheService.getCacheStats(),
+            timestamp: Date.now(),
+        };
+    });
+});
+//# sourceMappingURL=search.handlers.js.map

package/dist/search/api/search.handlers.js.map

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

package/dist/search/components/global-search-bar.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Global Search Bar Component
+ *
+ * Search bar component that integrates with the unified search API.
+ * Supports infinite scroll pagination via TanStack Query.
+ */
+import type { GlobalSearchBarProps } from "../search.interfaces";
+/**
+ * GlobalSearchBar - Search bar with unified search API integration
+ *
+ * Features:
+ * - Search across documents, users, groups, agents, feedbacks, and chats
+ * - Debounced search queries
+ * - Filter tabs by entity type
+ * - Recent searches persistence
+ * - Keyboard navigation (arrows, Enter, Escape, Ctrl+F)
+ * - Loading and error states
+ */
+export declare function GlobalSearchBar({ placeholder, showShortcutHint, onResultSelect, className, }: GlobalSearchBarProps): import("react/jsx-runtime").JSX.Element;
+export default GlobalSearchBar;
+//# sourceMappingURL=global-search-bar.d.ts.map

package/dist/search/components/global-search-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-search-bar.d.ts","sourceRoot":"","sources":["../../../lib/search/components/global-search-bar.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmDH,OAAO,KAAK,EAAE,oBAAoB,EAAoB,MAAM,gCAAgC,CAAC;AAQ7F;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAC9B,WAAoC,EACpC,gBAAuB,EACvB,cAAc,EACd,SAAS,GACV,EAAE,oBAAoB,2CAyctB;AAED,eAAe,eAAe,CAAC"}

package/dist/search/components/global-search-bar.js

@@ -0,0 +1,243 @@
+/**
+ * Global Search Bar Component
+ *
+ * Search bar component that integrates with the unified search API.
+ * Supports infinite scroll pagination via TanStack Query.
+ */
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Loader2, Search, Settings2, X } from "lucide-react";
+import { useRouter } from "next/navigation";
+import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
+import { useInView } from "react-intersection-observer";
+import { Button } from "../../shared/components/ui/button";
+import { InputGroup, InputGroupAddon, InputGroupInput, } from "../../shared/components/ui/input-group";
+import { Popover, PopoverAnchor, PopoverContent, PopoverTrigger, } from "../../shared/components/ui/popover";
+import { Switch } from "../../shared/components/ui/switch";
+import { KEYBOARD_KEYS } from "../../shared/shared.constants";
+import { cn } from "../../shared/utilities/cn";
+import { SearchDefaultState, SearchErrorState, SearchInitialState, SearchLoadingState, SearchLoadMoreTrigger, SearchMinCharsState, SearchNoResultsState, SearchRecentsHeader, } from "./search-empty-states";
+import { SearchFooter } from "./search-footer";
+import { SearchResultItem } from "./search-result-item";
+import { useSearch } from "../hooks/use-search";
+import { COMPONENT_SEARCH_TABS, SEARCH_DEFAULTS, SEARCH_KEYBOARD_SHORTCUTS, SEARCH_RESULT_TYPES, } from "../search.constants";
+import { clearRecentSearches, getRecentSearches, saveRecentSearch, } from "../search.utilities";
+/**
+ * GlobalSearchBar - Search bar with unified search API integration
+ *
+ * Features:
+ * - Search across documents, users, groups, agents, feedbacks, and chats
+ * - Debounced search queries
+ * - Filter tabs by entity type
+ * - Recent searches persistence
+ * - Keyboard navigation (arrows, Enter, Escape, Ctrl+F)
+ * - Loading and error states
+ */
+export function GlobalSearchBar({ placeholder = "Search everything...", showShortcutHint = true, onResultSelect, className, }) {
+    const router = useRouter();
+    // UI State
+    const [open, setOpen] = useState(false);
+    const [visibleTabs, setVisibleTabs] = useState([
+        "all",
+        ...SEARCH_RESULT_TYPES,
+    ]);
+    const [settingsOpen, setSettingsOpen] = useState(false);
+    const [selectedIndex, setSelectedIndex] = useState(-1);
+    const [recentSearches, setRecentSearches] = useState(() => getRecentSearches());
+    // Get visible types (exclude "all" as it's not a SearchResultType)
+    const visibleTypes = useMemo(() => visibleTabs.filter((t) => t !== "all"), [visibleTabs]);
+    // Search hook with TanStack Query
+    const { query, setQuery, results, isLoading, isFetchingNextPage, error, type: activeTab, setType: setActiveTab, total, hasMore, fetchNextPage, retry, } = useSearch({ semantic: true, visibleTypes });
+    // Intersection observer for infinite scroll
+    const { ref: loadMoreRef, inView } = useInView({ threshold: 0.1 });
+    // Refs
+    const inputRef = useRef(null);
+    const listRef = useRef(null);
+    // Fetch more when scroll trigger is in view
+    useEffect(() => {
+        if (inView && hasMore && !isFetchingNextPage && !isLoading) {
+            fetchNextPage();
+        }
+    }, [inView, hasMore, isFetchingNextPage, isLoading, fetchNextPage]);
+    // Reset selection when results change - this is intentional UI synchronization
+    // eslint-disable-next-line react-hooks/set-state-in-effect
+    useEffect(() => setSelectedIndex(-1), [results]);
+    // Results to display (recents when no query, otherwise search results)
+    const displayResults = useMemo(() => {
+        if (!query.trim() && recentSearches.length > 0) {
+            return recentSearches;
+        }
+        return results;
+    }, [query, recentSearches, results]);
+    // Count results by type
+    const countByType = (type) => {
+        if (type === "all")
+            return results.length;
+        // Chat tab includes both chats and messages
+        if (type === "chat") {
+            return results.filter((r) => r.type === "chat" || r.type === "message").length;
+        }
+        return results.filter((r) => r.type === type).length;
+    };
+    // Handle result selection
+    const handleSelect = useCallback((result) => {
+        saveRecentSearch(result);
+        setRecentSearches(getRecentSearches());
+        setOpen(false);
+        setQuery("");
+        setSelectedIndex(-1);
+        if (onResultSelect) {
+            onResultSelect(result);
+        }
+        else {
+            router.push(result.href);
+        }
+    }, [onResultSelect, router, setQuery]);
+    // Clear input
+    const handleClearInput = useCallback(() => {
+        var _a;
+        setQuery("");
+        setSelectedIndex(-1);
+        (_a = inputRef.current) === null || _a === void 0 ? void 0 : _a.focus();
+    }, [setQuery]);
+    // Clear recents
+    const handleClearRecents = useCallback(() => {
+        clearRecentSearches();
+        setRecentSearches([]);
+    }, []);
+    // Scroll selected into view
+    useEffect(() => {
+        if (selectedIndex >= 0 && listRef.current) {
+            const el = listRef.current.querySelector(`[data-index="${selectedIndex}"]`);
+            if (el)
+                el.scrollIntoView({ block: "nearest" });
+        }
+    }, [selectedIndex]);
+    // Keyboard navigation
+    const handleKeyDown = useCallback((e) => {
+        if (!open) {
+            if (e.key === KEYBOARD_KEYS.ARROW_DOWN || e.key === KEYBOARD_KEYS.ARROW_UP) {
+                setOpen(true);
+                return;
+            }
+            return;
+        }
+        const navResults = displayResults;
+        switch (e.key) {
+            case KEYBOARD_KEYS.ARROW_DOWN:
+                e.preventDefault();
+                setSelectedIndex((prev) => (prev + 1 >= navResults.length ? 0 : prev + 1));
+                break;
+            case KEYBOARD_KEYS.ARROW_UP:
+                e.preventDefault();
+                setSelectedIndex((prev) => (prev - 1 < 0 ? navResults.length - 1 : prev - 1));
+                break;
+            case KEYBOARD_KEYS.ENTER:
+                e.preventDefault();
+                if (selectedIndex >= 0 && selectedIndex < navResults.length) {
+                    handleSelect(navResults[selectedIndex]);
+                }
+                break;
+            case KEYBOARD_KEYS.ESCAPE:
+                e.preventDefault();
+                setOpen(false);
+                setSelectedIndex(-1);
+                break;
+            case KEYBOARD_KEYS.TAB:
+                setOpen(false);
+                setSelectedIndex(-1);
+                break;
+        }
+    }, [open, displayResults, selectedIndex, handleSelect]);
+    // Global keyboard shortcut (Ctrl+F when not in editable element)
+    useEffect(() => {
+        const handleGlobalKeyDown = (e) => {
+            var _a;
+            // Ctrl+F opens search only when focus is NOT in an editable element
+            // This allows browser find to work normally in inputs/textareas
+            if (e.ctrlKey && e.key === SEARCH_KEYBOARD_SHORTCUTS.FIND_KEY) {
+                const activeElement = document.activeElement;
+                const isInEditable = activeElement instanceof HTMLInputElement ||
+                    activeElement instanceof HTMLTextAreaElement ||
+                    (activeElement === null || activeElement === void 0 ? void 0 : activeElement.isContentEditable);
+                if (!isInEditable) {
+                    e.preventDefault();
+                    (_a = inputRef.current) === null || _a === void 0 ? void 0 : _a.focus();
+                    setOpen(true);
+                }
+            }
+        };
+        document.addEventListener("keydown", handleGlobalKeyDown);
+        return () => document.removeEventListener("keydown", handleGlobalKeyDown);
+    }, []);
+    // Toggle tab visibility
+    const handleToggleTab = useCallback((tabId) => {
+        setVisibleTabs((prev) => {
+            const isRemoving = prev.includes(tabId);
+            let newTabs;
+            if (isRemoving) {
+                // Remove the tab
+                newTabs = prev.filter((t) => t !== tabId);
+                // When removing "chat", also remove "message" (messages are part of chat)
+                if (tabId === "chat") {
+                    newTabs = newTabs.filter((t) => t !== "message");
+                }
+            }
+            else {
+                // Add the tab
+                newTabs = [...prev, tabId];
+                // When adding "chat", also add "message"
+                if (tabId === "chat" && !newTabs.includes("message")) {
+                    newTabs.push("message");
+                }
+            }
+            // Ensure at least one actual type (not just "all") remains visible
+            const actualTypes = newTabs.filter((t) => t !== "all");
+            if (actualTypes.length === 0) {
+                // Don't allow removing the last type - keep previous state
+                return prev;
+            }
+            return newTabs;
+        });
+    }, []);
+    // Visible tabs
+    const displayedTabs = COMPONENT_SEARCH_TABS.filter((tab) => visibleTabs.includes(tab.id));
+    const toggleableTabs = COMPONENT_SEARCH_TABS.filter((tab) => tab.id !== "all");
+    const showRecents = !query.trim() && recentSearches.length > 0;
+    const showResults = displayResults.length > 0;
+    // Show loading skeleton when initial search is in progress
+    const showLoading = isLoading;
+    // Only show "no results" after search has completed
+    const showEmpty = !isLoading && query.length >= SEARCH_DEFAULTS.MIN_QUERY_LENGTH && results.length === 0;
+    const showMinChars = !isLoading && query.length > 0 && query.length < SEARCH_DEFAULTS.MIN_QUERY_LENGTH;
+    const showInitial = !query.trim() && !showRecents;
+    return (_jsxs(Popover, { open: open, onOpenChange: setOpen, children: [_jsx(PopoverAnchor, { asChild: true, children: _jsx("div", { className: cn("relative w-full", className), children: _jsxs(InputGroup, { className: "bg-background border shadow-sm transition-shadow focus-within:shadow-md", children: [_jsx(InputGroupAddon, { children: showLoading ? (_jsx(Loader2, { className: "size-4 animate-spin", "aria-hidden": "true" })) : (_jsx(Search, { className: "size-4", "aria-hidden": "true" })) }), _jsx(InputGroupInput, { ref: inputRef, type: "text", value: query, onChange: (e) => {
+                                    setQuery(e.target.value);
+                                    if (!open)
+                                        setOpen(true);
+                                }, onFocus: () => setOpen(true), onKeyDown: handleKeyDown, placeholder: placeholder, autoComplete: "off", spellCheck: false, role: "combobox", "aria-expanded": open, "aria-controls": "search-results", "aria-activedescendant": selectedIndex >= 0 ? `search-result-${selectedIndex}` : undefined, "aria-label": "Search", className: "text-background dark:text-foreground placeholder:text-muted-foreground/70" }), query && (_jsx(InputGroupAddon, { align: "inline-end", children: _jsx("button", { type: "button", onClick: handleClearInput, className: "hover:bg-muted/50 flex items-center justify-center rounded-sm p-0.5 transition-colors focus:outline-none", "aria-label": "Clear search", children: _jsx(X, { className: "text-muted-foreground size-4", "aria-hidden": "true" }) }) })), showShortcutHint && !query && (_jsxs(InputGroupAddon, { align: "inline-end", className: "hidden sm:flex", children: [_jsx("kbd", { className: "bg-muted rounded border px-1.5 py-0.5 font-mono text-[10px] font-medium", children: "Ctrl" }), _jsx("kbd", { className: "bg-muted rounded border px-1.5 py-0.5 font-mono text-[10px] font-medium", children: "F" })] }))] }) }) }), _jsx(PopoverContent, { className: "w-[70vw] min-w-100 p-0", align: "start", sideOffset: 8, onOpenAutoFocus: (e) => e.preventDefault(), onInteractOutside: (e) => {
+                    var _a;
+                    if (((_a = inputRef.current) === null || _a === void 0 ? void 0 : _a.contains(e.target)) ||
+                        e.target.closest("[data-search-settings]")) {
+                        e.preventDefault();
+                    }
+                }, children: _jsxs("div", { className: "bg-popover text-popover-foreground overflow-hidden rounded-xl border shadow-xl", children: [_jsxs("div", { className: "bg-muted/30 flex items-center justify-between border-b px-2 py-1.5", children: [_jsx("div", { className: "flex items-center gap-1 overflow-x-auto", children: displayedTabs.map((tab) => {
+                                        const count = countByType(tab.id);
+                                        const isActive = activeTab === tab.id;
+                                        const TabIcon = tab.icon;
+                                        return (_jsxs("button", { onClick: () => {
+                                                setActiveTab(tab.id);
+                                                setSelectedIndex(-1);
+                                            }, className: cn("flex items-center gap-1.5 rounded-lg px-2.5 py-1.5 text-xs font-medium transition-all", isActive
+                                                ? "bg-background text-foreground shadow-sm"
+                                                : "text-muted-foreground hover:bg-background/50 hover:text-foreground"), children: [_jsx(TabIcon, { className: "size-3.5", "aria-hidden": "true" }), _jsx("span", { children: tab.label }), count > 0 && (_jsx("span", { className: cn("rounded-full px-1.5 py-0.5 text-[10px] font-semibold", isActive
+                                                        ? "bg-primary/10 text-primary"
+                                                        : "bg-muted text-muted-foreground"), children: count }))] }, tab.id));
+                                    }) }), _jsxs(Popover, { open: settingsOpen, onOpenChange: setSettingsOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { variant: "ghost", size: "icon-sm", className: "ml-1 shrink-0", "data-search-settings": true, children: [_jsx(Settings2, { className: "text-muted-foreground size-4", "aria-hidden": "true" }), _jsx("span", { className: "sr-only", children: "Search settings" })] }) }), _jsxs(PopoverContent, { className: "w-56 p-3", align: "end", side: "bottom", "data-search-settings": true, children: [_jsxs("div", { className: "mb-2 flex items-center gap-2", children: [_jsx(Settings2, { className: "text-muted-foreground size-4", "aria-hidden": "true" }), _jsx("span", { className: "text-sm font-medium", children: "Visible Categories" })] }), _jsx("div", { className: "space-y-2", children: toggleableTabs.map((tab) => {
+                                                        const TabIcon = tab.icon;
+                                                        const isVisible = visibleTabs.includes(tab.id);
+                                                        return (_jsxs("div", { className: "hover:bg-muted/50 flex items-center justify-between rounded-lg px-2 py-1.5 transition-colors", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(TabIcon, { className: "text-muted-foreground size-4", "aria-hidden": "true" }), _jsx("span", { className: "text-sm", children: tab.label })] }), _jsx(Switch, { checked: isVisible, onCheckedChange: () => handleToggleTab(tab.id), "aria-label": `Show ${tab.label} tab` })] }, tab.id));
+                                                    }) })] })] })] }), _jsx("div", { ref: listRef, id: "search-results", role: "listbox", className: "max-h-[450px] overflow-y-auto p-2", children: showLoading ? (_jsx(SearchLoadingState, {})) : error ? (_jsx(SearchErrorState, { error: error, onRetry: retry })) : showMinChars ? (_jsx(SearchMinCharsState, {})) : showInitial ? (_jsx(SearchInitialState, { onSuggestionClick: setQuery })) : showRecents ? (_jsxs("div", { children: [_jsx(SearchRecentsHeader, { onClear: handleClearRecents }), _jsx("div", { className: "space-y-0.5", children: recentSearches.map((result, index) => (_jsx(SearchResultItem, { result: result, index: index, isRecent: true, isSelected: index === selectedIndex, onSelect: handleSelect, onMouseEnter: setSelectedIndex }, result.id))) })] })) : showEmpty ? (_jsx(SearchNoResultsState, { query: query })) : showResults ? (_jsxs("div", { children: [_jsx("div", { className: "space-y-0.5", children: displayResults.map((result, index) => (_jsx(SearchResultItem, { result: result, index: index, isRecent: false, isSelected: index === selectedIndex, onSelect: handleSelect, onMouseEnter: setSelectedIndex }, result.id))) }), hasMore && (_jsx("div", { ref: loadMoreRef, children: _jsx(SearchLoadMoreTrigger, { isFetching: isFetchingNextPage, onLoadMore: fetchNextPage }) }))] })) : (_jsx(SearchDefaultState, {})) }), _jsx(SearchFooter, { show: showResults || showRecents, total: showResults ? total : 0 })] }) })] }));
+}
+export default GlobalSearchBar;
+//# sourceMappingURL=global-search-bar.js.map