@86d-app/search 0.0.4 → 0.0.6

package/dist/admin/endpoints/synonyms.d.ts

@@ -0,0 +1,30 @@
+import { z } from "@86d-app/core";
+export declare const listSynonyms: import("better-call").StrictEndpoint<"/admin/search/synonyms", {
+    method: "GET";
+}, {
+    synonyms: import("../..").SearchSynonym[];
+}>;
+export declare const addSynonym: import("better-call").StrictEndpoint<"/admin/search/synonyms/add", {
+    method: "POST";
+    body: z.ZodObject<{
+        term: z.ZodString;
+        synonyms: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, {
+    synonym: import("../..").SearchSynonym;
+}>;
+export declare const removeSynonym: import("better-call").StrictEndpoint<"/admin/search/synonyms/:id/delete", {
+    method: "POST";
+    params: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strip>;
+}, {
+    error: string;
+    status: number;
+    success?: never;
+} | {
+    success: boolean;
+    error?: never;
+    status?: never;
+}>;
+//# sourceMappingURL=synonyms.d.ts.map

package/dist/admin/endpoints/synonyms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synonyms.d.ts","sourceRoot":"","sources":["../../../src/admin/endpoints/synonyms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,CAAC,EAAE,MAAM,eAAe,CAAC;AAGvD,eAAO,MAAM,YAAY;;;;EAQxB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;EAiBtB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;EAgBzB,CAAC"}

package/dist/admin/endpoints/zero-results.d.ts

@@ -0,0 +1,10 @@
+import { z } from "@86d-app/core";
+export declare const zeroResultsEndpoint: import("better-call").StrictEndpoint<"/admin/search/zero-results", {
+    method: "GET";
+    query: z.ZodObject<{
+        limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>;
+}, {
+    terms: import("../../service").PopularTerm[];
+}>;
+//# sourceMappingURL=zero-results.d.ts.map

package/dist/admin/endpoints/zero-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-results.d.ts","sourceRoot":"","sources":["../../../src/admin/endpoints/zero-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,CAAC,EAAE,MAAM,eAAe,CAAC;AAGvD,eAAO,MAAM,mBAAmB;;;;;;;EAa/B,CAAC"}

package/dist/embedding-provider.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Embedding provider for AI-powered semantic search.
+ *
+ * Calls OpenAI's text-embedding-3-small model to generate vector embeddings
+ * for indexed items and search queries. When configured, search results are
+ * ranked using a hybrid of lexical scoring and cosine similarity.
+ */
+export interface EmbeddingProvider {
+    generateEmbedding(text: string): Promise<number[] | null>;
+    generateEmbeddings(texts: string[]): Promise<Array<number[] | null>>;
+}
+export declare class OpenAIEmbeddingProvider implements EmbeddingProvider {
+    private readonly apiKey;
+    private readonly model;
+    private readonly baseUrl;
+    constructor(apiKey: string, options?: {
+        model?: string;
+        baseUrl?: string;
+    });
+    generateEmbedding(text: string): Promise<number[] | null>;
+    generateEmbeddings(texts: string[]): Promise<Array<number[] | null>>;
+}
+/**
+ * Cosine similarity between two vectors.
+ * Returns a value between -1 and 1 (1 = identical direction).
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+//# sourceMappingURL=embedding-provider.d.ts.map

package/dist/embedding-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../src/embedding-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,MAAM,WAAW,iBAAiB;IACjC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1D,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;CACrE;AAED,qBAAa,uBAAwB,YAAW,iBAAiB;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAMpE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAKzD,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;CAyC1E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAYjE"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import type { Module, ModuleConfig } from "@86d-app/core";
+export type { EmbeddingProvider } from "./embedding-provider";
+export { OpenAIEmbeddingProvider } from "./embedding-provider";
+export type { MeiliSearchProvider } from "./meilisearch-provider";
+export type { SearchClick, SearchController, SearchFacets, SearchHighlight, SearchIndexItem, SearchQuery, SearchResult, SearchSortField, SearchSynonym, } from "./service";
+export interface SearchOptions extends ModuleConfig {
+    /** Maximum number of search results per query */
+    maxResults?: number;
+    /** OpenAI API key for AI-powered semantic search */
+    openaiApiKey?: string;
+    /** OpenRouter API key (alternative to OpenAI) */
+    openrouterApiKey?: string;
+    /** Embedding model name (default: text-embedding-3-small) */
+    embeddingModel?: string;
+    /** MeiliSearch host URL (e.g. http://localhost:7700) */
+    meilisearchHost?: string;
+    /** MeiliSearch API key (master or search key) */
+    meilisearchApiKey?: string;
+    /** MeiliSearch index name (default: "search") */
+    meilisearchIndexUid?: string;
+}
+export default function search(options?: SearchOptions): Module;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAiB,MAAM,eAAe,CAAC;AAQzE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,GACb,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,aAAc,SAAQ,YAAY;IAClD,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CA4E9D"}

package/dist/meilisearch-provider.d.ts

@@ -0,0 +1,104 @@
+/**
+ * MeiliSearch provider for real search engine integration.
+ *
+ * When configured with a MeiliSearch host and API key, the search module
+ * delegates indexing and querying to a dedicated MeiliSearch instance instead
+ * of relying on in-application lexical search. Falls back gracefully when
+ * the MeiliSearch instance is unreachable.
+ */
+export interface MeiliSearchDocument {
+    id: string;
+    entityType: string;
+    entityId: string;
+    title: string;
+    body?: string | undefined;
+    tags: string[];
+    url: string;
+    image?: string | undefined;
+    indexedAt: string;
+    [key: string]: unknown;
+}
+export interface MeiliSearchHit {
+    id: string;
+    entityType: string;
+    entityId: string;
+    title: string;
+    body?: string;
+    tags: string[];
+    url: string;
+    image?: string;
+    indexedAt: string;
+    _formatted?: {
+        title?: string;
+        body?: string;
+        [key: string]: string | undefined;
+    };
+    _rankingScore?: number;
+    [key: string]: unknown;
+}
+export interface MeiliSearchResponse {
+    hits: MeiliSearchHit[];
+    query: string;
+    processingTimeMs: number;
+    estimatedTotalHits?: number;
+    totalHits?: number;
+    facetDistribution?: Record<string, Record<string, number>>;
+}
+interface MeiliSearchTaskResponse {
+    taskUid: number;
+    indexUid: string;
+    status: "enqueued" | "processing" | "succeeded" | "failed";
+    type: string;
+    enqueuedAt: string;
+}
+interface MeiliSearchStatsResponse {
+    numberOfDocuments: number;
+    isIndexing: boolean;
+    fieldDistribution: Record<string, number>;
+}
+export declare class MeiliSearchProvider {
+    private readonly host;
+    private readonly apiKey;
+    private readonly indexUid;
+    constructor(host: string, apiKey: string, indexUid?: string);
+    /**
+     * Add or replace documents in the MeiliSearch index.
+     * MeiliSearch uses the `id` field as the primary key by default.
+     */
+    addDocuments(documents: MeiliSearchDocument[]): Promise<MeiliSearchTaskResponse>;
+    /**
+     * Delete a single document by its ID.
+     */
+    deleteDocument(documentId: string): Promise<MeiliSearchTaskResponse>;
+    /**
+     * Search the MeiliSearch index.
+     */
+    search(query: string, options?: {
+        limit?: number | undefined;
+        offset?: number | undefined;
+        filter?: string | undefined;
+        sort?: string[] | undefined;
+        facets?: string[] | undefined;
+        attributesToHighlight?: string[] | undefined;
+        highlightPreTag?: string | undefined;
+        highlightPostTag?: string | undefined;
+        showRankingScore?: boolean | undefined;
+        matchingStrategy?: "last" | "all" | "frequency" | undefined;
+    }): Promise<MeiliSearchResponse>;
+    /**
+     * Check if the MeiliSearch instance is reachable and healthy.
+     */
+    isHealthy(): Promise<boolean>;
+    /**
+     * Get index statistics (document count, indexing status).
+     */
+    getStats(): Promise<MeiliSearchStatsResponse | null>;
+    /**
+     * Configure index settings: filterable and sortable attributes.
+     * Called once on init to ensure MeiliSearch knows which fields to index.
+     */
+    configureIndex(): Promise<void>;
+    private request;
+}
+export {};
+//# sourceMappingURL=meilisearch-provider.d.ts.map

package/dist/meilisearch-provider.d.ts.map

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

package/dist/schema.d.ts

@@ -0,0 +1,133 @@
+export declare const searchSchema: {
+    searchIndex: {
+        fields: {
+            id: {
+                type: "string";
+                required: true;
+            };
+            entityType: {
+                type: "string";
+                required: true;
+            };
+            entityId: {
+                type: "string";
+                required: true;
+            };
+            title: {
+                type: "string";
+                required: true;
+            };
+            body: {
+                type: "string";
+                required: false;
+            };
+            tags: {
+                type: "json";
+                required: false;
+                defaultValue: never[];
+            };
+            url: {
+                type: "string";
+                required: true;
+            };
+            image: {
+                type: "string";
+                required: false;
+            };
+            metadata: {
+                type: "json";
+                required: false;
+                defaultValue: {};
+            };
+            indexedAt: {
+                type: "date";
+                required: true;
+                defaultValue: () => Date;
+            };
+        };
+    };
+    searchQuery: {
+        fields: {
+            id: {
+                type: "string";
+                required: true;
+            };
+            term: {
+                type: "string";
+                required: true;
+            };
+            normalizedTerm: {
+                type: "string";
+                required: true;
+            };
+            resultCount: {
+                type: "number";
+                required: true;
+            };
+            sessionId: {
+                type: "string";
+                required: false;
+            };
+            searchedAt: {
+                type: "date";
+                required: true;
+                defaultValue: () => Date;
+            };
+        };
+    };
+    searchSynonym: {
+        fields: {
+            id: {
+                type: "string";
+                required: true;
+            };
+            term: {
+                type: "string";
+                required: true;
+            };
+            synonyms: {
+                type: "json";
+                required: true;
+            };
+            createdAt: {
+                type: "date";
+                required: true;
+                defaultValue: () => Date;
+            };
+        };
+    };
+    searchClick: {
+        fields: {
+            id: {
+                type: "string";
+                required: true;
+            };
+            queryId: {
+                type: "string";
+                required: true;
+            };
+            term: {
+                type: "string";
+                required: true;
+            };
+            entityType: {
+                type: "string";
+                required: true;
+            };
+            entityId: {
+                type: "string";
+                required: true;
+            };
+            position: {
+                type: "number";
+                required: true;
+            };
+            clickedAt: {
+                type: "date";
+                required: true;
+                defaultValue: () => Date;
+            };
+        };
+    };
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DD,CAAC"}

package/dist/service-impl.d.ts

@@ -0,0 +1,6 @@
+import type { ModuleDataService } from "@86d-app/core";
+import type { EmbeddingProvider } from "./embedding-provider";
+import type { MeiliSearchProvider } from "./meilisearch-provider";
+import type { SearchController } from "./service";
+export declare function createSearchController(data: ModuleDataService, embeddingProvider?: EmbeddingProvider, meiliProvider?: MeiliSearchProvider): SearchController;
+//# sourceMappingURL=service-impl.d.ts.map

package/dist/service-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-impl.d.ts","sourceRoot":"","sources":["../src/service-impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAEX,mBAAmB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAEX,gBAAgB,EAQhB,MAAM,WAAW,CAAC;AA6RnB,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,iBAAiB,EACvB,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,aAAa,CAAC,EAAE,mBAAmB,GACjC,gBAAgB,CAmpBlB"}

package/dist/service.d.ts

@@ -0,0 +1,127 @@
+import type { ModuleController } from "@86d-app/core";
+export interface SearchIndexItem {
+    id: string;
+    entityType: string;
+    entityId: string;
+    title: string;
+    body?: string | undefined;
+    tags: string[];
+    url: string;
+    image?: string | undefined;
+    metadata: Record<string, unknown>;
+    indexedAt: Date;
+}
+export interface SearchQuery {
+    id: string;
+    term: string;
+    normalizedTerm: string;
+    resultCount: number;
+    sessionId?: string | undefined;
+    searchedAt: Date;
+}
+export interface SearchSynonym {
+    id: string;
+    term: string;
+    synonyms: string[];
+    createdAt: Date;
+}
+export interface SearchClick {
+    id: string;
+    queryId: string;
+    term: string;
+    entityType: string;
+    entityId: string;
+    position: number;
+    clickedAt: Date;
+}
+export type SearchSortField = "relevance" | "newest" | "oldest" | "title_asc" | "title_desc";
+export interface SearchFacets {
+    entityTypes: Array<{
+        type: string;
+        count: number;
+    }>;
+    tags: Array<{
+        tag: string;
+        count: number;
+    }>;
+}
+export interface SearchResult {
+    item: SearchIndexItem;
+    score: number;
+    highlights?: SearchHighlight | undefined;
+}
+export interface SearchHighlight {
+    title?: string | undefined;
+    body?: string | undefined;
+}
+export interface SearchAnalyticsSummary {
+    totalQueries: number;
+    uniqueTerms: number;
+    avgResultCount: number;
+    zeroResultCount: number;
+    zeroResultRate: number;
+    clickThroughRate: number;
+    avgClickPosition: number;
+}
+export interface PopularTerm {
+    term: string;
+    count: number;
+    avgResultCount: number;
+}
+export interface SearchController extends ModuleController {
+    indexItem(params: {
+        entityType: string;
+        entityId: string;
+        title: string;
+        body?: string | undefined;
+        tags?: string[] | undefined;
+        url: string;
+        image?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }): Promise<SearchIndexItem>;
+    bulkIndex(items: Array<{
+        entityType: string;
+        entityId: string;
+        title: string;
+        body?: string | undefined;
+        tags?: string[] | undefined;
+        url: string;
+        image?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    }>): Promise<{
+        indexed: number;
+        errors: number;
+    }>;
+    removeFromIndex(entityType: string, entityId: string): Promise<boolean>;
+    search(query: string, options?: {
+        entityType?: string | undefined;
+        tags?: string[] | undefined;
+        sort?: SearchSortField | undefined;
+        fuzzy?: boolean | undefined;
+        limit?: number | undefined;
+        skip?: number | undefined;
+    }): Promise<{
+        results: SearchResult[];
+        total: number;
+        facets: SearchFacets;
+        didYouMean?: string | undefined;
+    }>;
+    suggest(prefix: string, limit?: number): Promise<string[]>;
+    recordQuery(term: string, resultCount: number, sessionId?: string | undefined): Promise<SearchQuery>;
+    recordClick(params: {
+        queryId: string;
+        term: string;
+        entityType: string;
+        entityId: string;
+        position: number;
+    }): Promise<SearchClick>;
+    getRecentQueries(sessionId: string, limit?: number): Promise<SearchQuery[]>;
+    getPopularTerms(limit?: number): Promise<PopularTerm[]>;
+    getZeroResultQueries(limit?: number): Promise<PopularTerm[]>;
+    getAnalytics(): Promise<SearchAnalyticsSummary>;
+    addSynonym(term: string, synonyms: string[]): Promise<SearchSynonym>;
+    removeSynonym(id: string): Promise<boolean>;
+    listSynonyms(): Promise<SearchSynonym[]>;
+    getIndexCount(): Promise<number>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

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

package/dist/store/components/_hooks.d.ts

@@ -0,0 +1,6 @@
+export declare function useSearchApi(): {
+    search: import("@86d-app/core/client").AnyEndpointHook;
+    suggest: import("@86d-app/core/client").AnyEndpointHook;
+    recent: import("@86d-app/core/client").AnyEndpointHook;
+};
+//# sourceMappingURL=_hooks.d.ts.map

package/dist/store/components/_hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_hooks.d.ts","sourceRoot":"","sources":["../../../src/store/components/_hooks.ts"],"names":[],"mappings":"AAIA,wBAAgB,YAAY;;;;EAO3B"}

package/dist/store/components/index.d.ts

@@ -0,0 +1,10 @@
+import { SearchBar } from "./search-bar";
+import { SearchPage } from "./search-page";
+import { SearchResults } from "./search-results";
+declare const _default: {
+    SearchBar: typeof SearchBar;
+    SearchResults: typeof SearchResults;
+    SearchPage: typeof SearchPage;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/store/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/components/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;;;;;;AAEjD,wBAI0B"}

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

@@ -0,0 +1,7 @@
+interface SearchBarProps {
+    placeholder?: string | undefined;
+    onSearch?: ((query: string) => void) | undefined;
+}
+export declare function SearchBar({ placeholder, onSearch, }: SearchBarProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=search-bar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-bar.d.ts","sourceRoot":"","sources":["../../../src/store/components/search-bar.tsx"],"names":[],"mappings":"AAKA,UAAU,cAAc;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACjD;AAED,wBAAgB,SAAS,CAAC,EACzB,WAAyB,EACzB,QAAQ,GACR,EAAE,cAAc,+BA2IhB"}

package/dist/store/components/search-page.d.ts

@@ -0,0 +1,4 @@
+export declare function SearchPage({ sessionId }: {
+    sessionId?: string | undefined;
+}): import("react").JSX.Element;
+//# sourceMappingURL=search-page.d.ts.map

package/dist/store/components/search-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-page.d.ts","sourceRoot":"","sources":["../../../src/store/components/search-page.tsx"],"names":[],"mappings":"AAMA,wBAAgB,UAAU,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,+BAmB3E"}

package/dist/store/components/search-results.d.ts

@@ -0,0 +1,9 @@
+interface SearchResultsProps {
+    query: string;
+    entityType?: string | undefined;
+    sessionId?: string | undefined;
+    limit?: number | undefined;
+}
+export declare function SearchResults({ query, entityType, sessionId, limit, }: SearchResultsProps): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=search-results.d.ts.map

package/dist/store/components/search-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-results.d.ts","sourceRoot":"","sources":["../../../src/store/components/search-results.tsx"],"names":[],"mappings":"AAcA,UAAU,kBAAkB;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAAC,EAC7B,KAAK,EACL,UAAU,EACV,SAAS,EACT,KAAU,GACV,EAAE,kBAAkB,sCA2EpB"}

package/dist/store/endpoints/click.d.ts

@@ -0,0 +1,14 @@
+import { z } from "@86d-app/core";
+export declare const clickEndpoint: import("better-call").StrictEndpoint<"/search/click", {
+    method: "POST";
+    body: z.ZodObject<{
+        queryId: z.ZodString;
+        term: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        entityType: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        entityId: z.ZodString;
+        position: z.ZodNumber;
+    }, z.core.$strip>;
+}, {
+    id: string;
+}>;
+//# sourceMappingURL=click.d.ts.map

package/dist/store/endpoints/click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../../src/store/endpoints/click.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,CAAC,EAAE,MAAM,eAAe,CAAC;AAGrE,eAAO,MAAM,aAAa;;;;;;;;;;;EAiBzB,CAAC"}