captify 0.1.18 → 1.1.0

package/dist/search/hooks/use-search-indices.js

@@ -0,0 +1,206 @@
+/**
+ * useSearchIndices Hook
+ *
+ * Manages search index state and operations for the admin page.
+ * Delegates API calls to the indices client; orchestrates state only.
+ * Supports SSE for real-time lock status updates from other users.
+ */
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { createIndices as createIndicesApi, deleteIndex as deleteIndexApi, fetchIndices as fetchIndicesApi, syncIndices as syncIndicesApi, } from "../api/indices.client";
+import { CAPTIFY_INDEX_PREFIX, SEARCH_ROUTES } from "../search.constants";
+export function useSearchIndices({ enabled = true, } = {}) {
+    const [indices, setIndices] = useState([]);
+    const [definitions, setDefinitions] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [creating, setCreating] = useState(false);
+    const [syncing, setSyncing] = useState(false);
+    const [deleting, setDeleting] = useState(null);
+    const [syncingIndex, setSyncingIndex] = useState(null);
+    const [results, setResults] = useState(null);
+    const [syncResults, setSyncResults] = useState(null);
+    const [activeSync, setActiveSync] = useState(null);
+    const [error, setError] = useState(null);
+    const fetchIndices = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        try {
+            const data = await fetchIndicesApi();
+            setIndices(data.indices || []);
+            setDefinitions(data.definitions || []);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : "Failed to fetch indices");
+        }
+        finally {
+            setLoading(false);
+        }
+    }, []);
+    // Initial fetch
+    useEffect(() => {
+        if (enabled) {
+            fetchIndices();
+        }
+    }, [fetchIndices, enabled]);
+    // SSE subscription for lock status updates
+    useEffect(() => {
+        if (!enabled)
+            return;
+        let eventSource = null;
+        let reconnectTimeout = null;
+        const connect = () => {
+            eventSource = new globalThis.EventSource(SEARCH_ROUTES.LOCK_EVENTS);
+            eventSource.onmessage = (event) => {
+                try {
+                    const data = JSON.parse(event.data);
+                    if (data.type === "init") {
+                        // Initial state - update all indices with lock info
+                        const lockMap = new Map(data.locks.map((lock) => [lock.indexName, lock]));
+                        setIndices((prev) => prev.map((idx) => {
+                            const lock = lockMap.get(idx.index);
+                            return Object.assign(Object.assign({}, idx), { lock: lock
+                                    ? {
+                                        operation: lock.operation,
+                                        userId: lock.userId,
+                                        userName: lock.userName,
+                                        isOwnLock: lock.isOwnLock,
+                                        progress: lock.progress,
+                                        startedAt: lock.startedAt,
+                                    }
+                                    : null });
+                        }));
+                    }
+                    else {
+                        // Lock change event
+                        setIndices((prev) => prev.map((idx) => {
+                            var _a;
+                            if (idx.index !== data.indexName)
+                                return idx;
+                            if (data.type === "released") {
+                                return Object.assign(Object.assign({}, idx), { lock: null });
+                            }
+                            // acquired or progress
+                            if (data.lock) {
+                                return Object.assign(Object.assign({}, idx), { lock: {
+                                        operation: data.lock.operation,
+                                        userId: data.lock.userId,
+                                        userName: data.lock.userName,
+                                        isOwnLock: (_a = data.lock.isOwnLock) !== null && _a !== void 0 ? _a : false,
+                                        progress: data.lock.progress,
+                                        startedAt: data.lock.startedAt,
+                                    } });
+                            }
+                            return idx;
+                        }));
+                    }
+                }
+                catch (_a) {
+                    // Ignore parse errors
+                }
+            };
+            eventSource.onerror = () => {
+                eventSource === null || eventSource === void 0 ? void 0 : eventSource.close();
+                // Reconnect after 5 seconds
+                reconnectTimeout = setTimeout(connect, 5000);
+            };
+        };
+        connect();
+        return () => {
+            eventSource === null || eventSource === void 0 ? void 0 : eventSource.close();
+            if (reconnectTimeout)
+                clearTimeout(reconnectTimeout);
+        };
+    }, [enabled]);
+    const createIndices = useCallback(async (indexName) => {
+        setCreating(true);
+        setResults(null);
+        setError(null);
+        try {
+            const data = await createIndicesApi(indexName);
+            setResults(data.results);
+            await fetchIndices();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : "Failed to create indices");
+        }
+        finally {
+            setCreating(false);
+        }
+    }, [fetchIndices]);
+    const deleteIndex = useCallback(async (indexName) => {
+        if (!confirm(`Are you sure you want to delete index "${indexName}"?`)) {
+            return;
+        }
+        setDeleting(indexName);
+        setError(null);
+        try {
+            await deleteIndexApi(indexName);
+            await fetchIndices();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : "Failed to delete index");
+        }
+        finally {
+            setDeleting(null);
+        }
+    }, [fetchIndices]);
+    const syncData = useCallback(async (indexName) => {
+        if (indexName) {
+            setSyncingIndex(indexName);
+        }
+        else {
+            setSyncing(true);
+        }
+        setSyncResults(null);
+        setActiveSync(null);
+        setError(null);
+        try {
+            await syncIndicesApi(indexName, (update) => {
+                if (update.activeSync !== undefined) {
+                    setActiveSync(update.activeSync);
+                }
+                if (update.syncResult) {
+                    setSyncResults((prev) => [...(prev || []), update.syncResult]);
+                }
+                if (update.error) {
+                    setError(update.error);
+                }
+            });
+            await fetchIndices();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : "Failed to sync data");
+        }
+        finally {
+            setSyncing(false);
+            setSyncingIndex(null);
+            setActiveSync(null);
+        }
+    }, [fetchIndices]);
+    const isSyncInProgress = syncing || syncingIndex !== null;
+    const captifyIndices = indices.filter((idx) => idx.index.startsWith(CAPTIFY_INDEX_PREFIX));
+    const otherIndices = indices.filter((idx) => !idx.index.startsWith(CAPTIFY_INDEX_PREFIX));
+    const missingIndices = definitions.filter((def) => !indices.some((idx) => idx.index === def));
+    return {
+        indices,
+        definitions,
+        captifyIndices,
+        otherIndices,
+        missingIndices,
+        loading,
+        creating,
+        syncing,
+        deleting,
+        syncingIndex,
+        results,
+        syncResults,
+        activeSync,
+        error,
+        isSyncInProgress,
+        fetchIndices,
+        createIndices,
+        deleteIndex,
+        syncData,
+    };
+}
+//# sourceMappingURL=use-search-indices.js.map

package/dist/search/hooks/use-search-indices.js.map

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

package/dist/search/hooks/use-search.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Search Hook
+ *
+ * React hook for managing search state with debouncing, loading states,
+ * infinite scroll pagination, and error handling.
+ * Uses TanStack Query's useInfiniteQuery with cursor-based pagination
+ * for 50-70% faster deep page navigation.
+ */
+import type { UseSearchOptions, UseSearchReturn } from "../search.interfaces";
+/**
+ * Hook for performing debounced search queries with infinite scroll support
+ *
+ * Uses cursor-based pagination (searchAfter) for 50-70% faster deep page navigation
+ * compared to offset-based pagination.
+ *
+ * @param options - Configuration options for the search behavior
+ * @returns Search state and control functions
+ *
+ * @example
+ * ```tsx
+ * function SearchComponent() {
+ *   const {
+ *     query,
+ *     setQuery,
+ *     results,
+ *     isLoading,
+ *     isFetchingNextPage,
+ *     hasMore,
+ *     fetchNextPage,
+ *   } = useSearch({ debounceMs: 200 });
+ *
+ *   const { ref, inView } = useInView();
+ *
+ *   useEffect(() => {
+ *     if (inView && hasMore) fetchNextPage();
+ *   }, [inView, hasMore, fetchNextPage]);
+ *
+ *   return (
+ *     <div>
+ *       <input value={query} onChange={(e) => setQuery(e.target.value)} />
+ *       {results.map((result) => <Result key={result.id} {...result} />)}
+ *       {hasMore && <div ref={ref}>{isFetchingNextPage && "Loading..."}</div>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useSearch(options?: UseSearchOptions): UseSearchReturn;
+//# sourceMappingURL=use-search.d.ts.map

package/dist/search/hooks/use-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-search.d.ts","sourceRoot":"","sources":["../../../lib/search/hooks/use-search.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,KAAK,EAEV,gBAAgB,EAChB,eAAe,EAChB,MAAM,gCAAgC,CAAC;AASxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CA4HzE"}

package/dist/search/hooks/use-search.js

@@ -0,0 +1,161 @@
+/**
+ * Search Hook
+ *
+ * React hook for managing search state with debouncing, loading states,
+ * infinite scroll pagination, and error handling.
+ * Uses TanStack Query's useInfiniteQuery with cursor-based pagination
+ * for 50-70% faster deep page navigation.
+ */
+"use client";
+import { useCallback, useMemo, useState } from "react";
+import { useInfiniteQuery } from "@tanstack/react-query";
+import { useDebounce } from "use-debounce";
+import { searchClient, searchKeys } from "../api/search.client";
+import { SEARCH_DEFAULTS, SEARCH_QUERY_CONFIG } from "../search.constants";
+/**
+ * Hook for performing debounced search queries with infinite scroll support
+ *
+ * Uses cursor-based pagination (searchAfter) for 50-70% faster deep page navigation
+ * compared to offset-based pagination.
+ *
+ * @param options - Configuration options for the search behavior
+ * @returns Search state and control functions
+ *
+ * @example
+ * ```tsx
+ * function SearchComponent() {
+ *   const {
+ *     query,
+ *     setQuery,
+ *     results,
+ *     isLoading,
+ *     isFetchingNextPage,
+ *     hasMore,
+ *     fetchNextPage,
+ *   } = useSearch({ debounceMs: 200 });
+ *
+ *   const { ref, inView } = useInView();
+ *
+ *   useEffect(() => {
+ *     if (inView && hasMore) fetchNextPage();
+ *   }, [inView, hasMore, fetchNextPage]);
+ *
+ *   return (
+ *     <div>
+ *       <input value={query} onChange={(e) => setQuery(e.target.value)} />
+ *       {results.map((result) => <Result key={result.id} {...result} />)}
+ *       {hasMore && <div ref={ref}>{isFetchingNextPage && "Loading..."}</div>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useSearch(options = {}) {
+    var _a, _b, _c, _d, _e, _f;
+    const { debounceMs = SEARCH_DEFAULTS.DEBOUNCE_MS, initialType = "all", semantic, semanticOnly, visibleTypes, } = options;
+    // Local state for immediate UI feedback
+    const [query, setQuery] = useState("");
+    const [type, setType] = useState(initialType);
+    // Debounce the query for API calls
+    const [debouncedQuery] = useDebounce(query, debounceMs);
+    // Track if query meets minimum length
+    const isQueryValid = debouncedQuery.length >= SEARCH_DEFAULTS.MIN_QUERY_LENGTH;
+    // Search query with cursor-based infinite pagination
+    const searchQuery = useInfiniteQuery({
+        queryKey: [
+            ...searchKeys.results(debouncedQuery, type),
+            { semantic, semanticOnly, visibleTypes },
+        ],
+        queryFn: async ({ pageParam, signal }) => {
+            const { searchAfter, offset, minScore } = pageParam;
+            return searchClient({
+                query: debouncedQuery,
+                type,
+                limit: SEARCH_DEFAULTS.DEFAULT_LIMIT,
+                // Always send offset for hasMore calculation, use cursor for faster fetching
+                offset,
+                searchAfter,
+                semantic,
+                semanticOnly,
+                visibleTypes,
+                // Pass minScore to OpenSearch to filter low-relevance results at query time
+                minScore,
+                // Pass abort signal to cancel in-flight requests when query changes
+                signal,
+            });
+        },
+        enabled: isQueryValid,
+        initialPageParam: { searchAfter: undefined, offset: 0, minScore: undefined },
+        getNextPageParam: (lastPage, allPages, lastPageParam) => {
+            var _a, _b, _c;
+            // Use cursor from response for next page (searchAfter pagination)
+            if (((_a = lastPage.pagination) === null || _a === void 0 ? void 0 : _a.hasMore) && ((_b = lastPage.pagination) === null || _b === void 0 ? void 0 : _b.nextCursor)) {
+                // Get maxScore from first page to calculate minScore threshold (20% of max)
+                const firstPageMaxScore = (_c = allPages[0]) === null || _c === void 0 ? void 0 : _c.maxScore;
+                const minScore = firstPageMaxScore ? firstPageMaxScore * 0.2 : undefined;
+                // Track offset for backend's hasMore calculation
+                const nextOffset = lastPageParam.offset + SEARCH_DEFAULTS.DEFAULT_LIMIT;
+                return {
+                    searchAfter: lastPage.pagination.nextCursor,
+                    offset: nextOffset,
+                    minScore,
+                };
+            }
+            return undefined;
+        },
+        staleTime: SEARCH_QUERY_CONFIG.STALE_TIME_MS,
+        gcTime: SEARCH_QUERY_CONFIG.GC_TIME_MS,
+        retry: SEARCH_QUERY_CONFIG.RETRY_COUNT,
+        retryDelay: (attempt) => Math.min(SEARCH_QUERY_CONFIG.RETRY_DELAY_BASE_MS * 2 ** attempt, SEARCH_QUERY_CONFIG.MAX_RETRY_DELAY_MS),
+    });
+    // Flatten all pages into a single results array, deduplicating by ID
+    const results = useMemo(() => {
+        var _a;
+        const pages = (_a = searchQuery.data) === null || _a === void 0 ? void 0 : _a.pages;
+        if (!pages)
+            return [];
+        const seen = new Set();
+        const deduplicated = [];
+        for (const page of pages) {
+            for (const result of page.results) {
+                if (!seen.has(result.id)) {
+                    seen.add(result.id);
+                    deduplicated.push(result);
+                }
+            }
+        }
+        return deduplicated;
+    }, [searchQuery.data]);
+    const total = (_c = (_b = (_a = searchQuery.data) === null || _a === void 0 ? void 0 : _a.pages[0]) === null || _b === void 0 ? void 0 : _b.total) !== null && _c !== void 0 ? _c : 0;
+    // Extract error message
+    const errorMessage = (_e = (_d = searchQuery.error) === null || _d === void 0 ? void 0 : _d.message) !== null && _e !== void 0 ? _e : null;
+    // Clear search state
+    const clear = useCallback(() => {
+        setQuery("");
+        setType(initialType);
+    }, [initialType]);
+    // Retry failed search
+    const retry = useCallback(() => {
+        searchQuery.refetch();
+    }, [searchQuery]);
+    // Fetch next page - use stable reference from searchQuery
+    const fetchNextPage = searchQuery.fetchNextPage;
+    return {
+        // State
+        query,
+        setQuery,
+        results,
+        isLoading: searchQuery.isLoading && isQueryValid,
+        isFetchingNextPage: searchQuery.isFetchingNextPage,
+        error: errorMessage,
+        type,
+        setType,
+        total,
+        hasMore: (_f = searchQuery.hasNextPage) !== null && _f !== void 0 ? _f : false,
+        // Actions
+        fetchNextPage,
+        retry,
+        clear,
+    };
+}
+//# sourceMappingURL=use-search.js.map

package/dist/search/hooks/use-search.js.map

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

package/dist/search/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Global Unified Search Module
+ *
+ * Provides unified search across documents, users, groups, agents, feedbacks, and chats
+ * using OpenSearch as the search engine.
+ *
+ * @module search
+ */
+export * from "./search.constants";
+export * from "./search.interfaces";
+export * from "./search.schemas";
+export * from "./search.errors";
+export * from "./search.utilities";
+export * from "./services";
+export * from "./api";
+export * from "./hooks";
+export * from "./components";
+//# sourceMappingURL=index.d.ts.map

package/dist/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/search/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,YAAY,CAAC;AAG3B,cAAc,OAAO,CAAC;AAGtB,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC"}

package/dist/search/index.js

@@ -0,0 +1,27 @@
+/**
+ * Global Unified Search Module
+ *
+ * Provides unified search across documents, users, groups, agents, feedbacks, and chats
+ * using OpenSearch as the search engine.
+ *
+ * @module search
+ */
+// Constants
+export * from "./search.constants";
+// Interfaces & Types
+export * from "./search.interfaces";
+// Schemas
+export * from "./search.schemas";
+// Errors
+export * from "./search.errors";
+// Utilities
+export * from "./search.utilities";
+// Services
+export * from "./services";
+// API
+export * from "./api";
+// Hooks
+export * from "./hooks";
+// Components
+export * from "./components";
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/search/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY;AACZ,cAAc,oBAAoB,CAAC;AAEnC,qBAAqB;AACrB,cAAc,qBAAqB,CAAC;AAEpC,UAAU;AACV,cAAc,kBAAkB,CAAC;AAEjC,SAAS;AACT,cAAc,iBAAiB,CAAC;AAEhC,YAAY;AACZ,cAAc,oBAAoB,CAAC;AAEnC,WAAW;AACX,cAAc,YAAY,CAAC;AAE3B,MAAM;AACN,cAAc,OAAO,CAAC;AAEtB,QAAQ;AACR,cAAc,SAAS,CAAC;AAExB,aAAa;AACb,cAAc,cAAc,CAAC"}