npm - @skravets/eapi - Versions diffs - 0.0.36 → 0.0.37 - Mend

@skravets/eapi 0.0.36 → 0.0.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/api-types.d.cts CHANGED Viewed

@@ -192,7 +192,7 @@ interface components {
             channel_id: number;
             /**
              * Format: date-time
-             * @example 2025-12-10T16:40:34.921Z
+             * @example 2025-12-16T15:43:00.619Z
              */
             message_created_at: string;
             /** @example 123 */
@@ -313,105 +313,95 @@ interface components {
              */
             accountId: number;
         };
-        ISearchChatsReq: {
-            /** @description chats usernames to rank */
-            chats?: string[];
-            /** @description search query */
-            query?: string;
-            /** @description search embedding */
-            embedding?: number[];
-            /** @description search limit */
-            limit?: number;
-            /** @description search offset */
-            offset?: number;
-        };
-        SemanticSearchMeta: {
+        CatalogSearchFilters: {
             /**
-             * @description Search type
-             * @example semantic | hybrid
-             */
-            type: string;
-            /**
-             * @description Similarity score
-             * @example 0.1
+             * @description Filter by chat type
+             * @enum {string}
              */
-            similarity: number;
-        };
-        HybridSearchMeta: {
+            chatType?: "group" | "channel";
+            /** @description Minimum participants count */
+            minParticipants?: number;
+            /** @description Maximum participants count */
+            maxParticipants?: number;
+            /** @description Filter by language (ISO 639-1) */
+            language?: string;
+            /** @description Filter by keywords (any match) */
+            keywords?: string[];
+        };
+        CatalogSearchRequest: {
+            /** @description Search query text */
+            query?: string;
+            /** @description Search embedding vector (1536 dimensions) */
+            embedding?: number[];
             /**
              * @description Search type
-             * @example hybrid
-             */
-            type: string;
-            /** @description r1 */
-            r1: string;
-            /** @description r2 */
-            r2: string;
-            /** @description bm25_score */
-            bm25_score: number;
-            /** @description vec_score */
-            vec_score: number;
-            /** @description source */
-            source: string;
-            /** @description rrf */
-            rrf: string;
-        };
-        SearchResult: {
-            /** @description Meta */
-            meta: components["schemas"]["SemanticSearchMeta"] | components["schemas"]["HybridSearchMeta"];
-            /**
-             * @description Channel id
-             * @example 123
-             */
-            channel_id: string;
-            /**
-             * @description Channel name
-             * @example channel_name
-             */
-            channel_name: string;
-            /**
-             * @description Topic
-             * @example topic
-             */
-            topic: string;
-            /**
-             * @description Tone
-             * @example tone
-             */
-            tone: string;
-            /**
-             * @description Language
-             * @example language
-             */
-            language: string;
-            /**
-             * @description Audience
-             * @example audience
-             */
-            audience: string;
-            /**
-             * @description Tags
-             * @example [
-             *       "tag1",
-             *       "tag2"
-             *     ]
+             * @default hybrid
+             * @enum {string}
              */
-            tags: string[];
+            type: "hybrid" | "semantic" | "bm25";
             /**
-             * @description Density per day
-             * @example 0.1
+             * @description Results limit
+             * @default 50
              */
-            density_per_day: number;
+            limit: number;
             /**
-             * @description Last message at
-             * @example 2023-01-01T00:00:00.000Z
+             * @description Results offset
+             * @default 0
              */
-            last_message_at: number;
+            offset: number;
+            /** @description Search filters */
+            filters?: components["schemas"]["CatalogSearchFilters"];
             /**
-             * @description Summary
-             * @example summary
+             * @description BM25 weight for hybrid search (0-1, default 0.5)
+             * @default 0.5
              */
-            summary: string;
+            bm25Weight: number;
+        };
+        CatalogSearchScore: {
+            /** @description Total/combined score (RRF for hybrid, similarity for semantic, bm25 for bm25-only) */
+            total: number;
+            /** @description Vector similarity score (0 if not used) */
+            vector: number;
+            /** @description BM25 score (0 if not used) */
+            bm25: number;
+        };
+        CatalogSearchMeta: {
+            /** @description Search type used */
+            type: string;
+            /** @description Search scores */
+            score: components["schemas"]["CatalogSearchScore"];
+            /** @description BM25 rank (hybrid only) */
+            rankBm25?: number;
+            /** @description Vector rank (hybrid only) */
+            rankVector?: number;
+            /** @description Result source (hybrid only) */
+            source?: string;
+        };
+        CatalogSearchResult: {
+            /** @description Catalog state ID */
+            id: number;
+            /** @description Peer ID */
+            peerId?: number;
+            /** @description Username */
+            username: string;
+            /** @description Chat type */
+            chatType?: string;
+            /** @description Title */
+            title?: string;
+            /** @description About/description */
+            about?: string;
+            /** @description Participants count */
+            participantsCount?: number;
+            /** @description Language */
+            language?: string;
+            /** @description Keywords */
+            keywords?: string[];
+            /** @description Summary */
+            summary?: string;
+            /** @description Average messages per day */
+            avgMessagesPerDay?: number;
+            /** @description Search metadata */
+            meta: components["schemas"]["CatalogSearchMeta"];
         };
         RelatedLinkDto: {
             /** @enum {string} */
@@ -926,17 +916,17 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["ISearchChatsReq"];
+                "application/json": components["schemas"]["CatalogSearchRequest"];
             };
         };
         responses: {
-            /** @description Search */
+            /** @description Hybrid search across catalog */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SearchResult"][];
+                    "application/json": components["schemas"]["CatalogSearchResult"][];
                 };
             };
             /** @description Unauthorized */

package/dist/api-types.d.ts CHANGED Viewed

@@ -192,7 +192,7 @@ interface components {
             channel_id: number;
             /**
              * Format: date-time
-             * @example 2025-12-10T16:40:34.921Z
+             * @example 2025-12-16T15:43:00.619Z
              */
             message_created_at: string;
             /** @example 123 */
@@ -313,105 +313,95 @@ interface components {
              */
             accountId: number;
         };
-        ISearchChatsReq: {
-            /** @description chats usernames to rank */
-            chats?: string[];
-            /** @description search query */
-            query?: string;
-            /** @description search embedding */
-            embedding?: number[];
-            /** @description search limit */
-            limit?: number;
-            /** @description search offset */
-            offset?: number;
-        };
-        SemanticSearchMeta: {
+        CatalogSearchFilters: {
             /**
-             * @description Search type
-             * @example semantic | hybrid
-             */
-            type: string;
-            /**
-             * @description Similarity score
-             * @example 0.1
+             * @description Filter by chat type
+             * @enum {string}
              */
-            similarity: number;
-        };
-        HybridSearchMeta: {
+            chatType?: "group" | "channel";
+            /** @description Minimum participants count */
+            minParticipants?: number;
+            /** @description Maximum participants count */
+            maxParticipants?: number;
+            /** @description Filter by language (ISO 639-1) */
+            language?: string;
+            /** @description Filter by keywords (any match) */
+            keywords?: string[];
+        };
+        CatalogSearchRequest: {
+            /** @description Search query text */
+            query?: string;
+            /** @description Search embedding vector (1536 dimensions) */
+            embedding?: number[];
             /**
              * @description Search type
-             * @example hybrid
-             */
-            type: string;
-            /** @description r1 */
-            r1: string;
-            /** @description r2 */
-            r2: string;
-            /** @description bm25_score */
-            bm25_score: number;
-            /** @description vec_score */
-            vec_score: number;
-            /** @description source */
-            source: string;
-            /** @description rrf */
-            rrf: string;
-        };
-        SearchResult: {
-            /** @description Meta */
-            meta: components["schemas"]["SemanticSearchMeta"] | components["schemas"]["HybridSearchMeta"];
-            /**
-             * @description Channel id
-             * @example 123
-             */
-            channel_id: string;
-            /**
-             * @description Channel name
-             * @example channel_name
-             */
-            channel_name: string;
-            /**
-             * @description Topic
-             * @example topic
-             */
-            topic: string;
-            /**
-             * @description Tone
-             * @example tone
-             */
-            tone: string;
-            /**
-             * @description Language
-             * @example language
-             */
-            language: string;
-            /**
-             * @description Audience
-             * @example audience
-             */
-            audience: string;
-            /**
-             * @description Tags
-             * @example [
-             *       "tag1",
-             *       "tag2"
-             *     ]
+             * @default hybrid
+             * @enum {string}
              */
-            tags: string[];
+            type: "hybrid" | "semantic" | "bm25";
             /**
-             * @description Density per day
-             * @example 0.1
+             * @description Results limit
+             * @default 50
              */
-            density_per_day: number;
+            limit: number;
             /**
-             * @description Last message at
-             * @example 2023-01-01T00:00:00.000Z
+             * @description Results offset
+             * @default 0
              */
-            last_message_at: number;
+            offset: number;
+            /** @description Search filters */
+            filters?: components["schemas"]["CatalogSearchFilters"];
             /**
-             * @description Summary
-             * @example summary
+             * @description BM25 weight for hybrid search (0-1, default 0.5)
+             * @default 0.5
              */
-            summary: string;
+            bm25Weight: number;
+        };
+        CatalogSearchScore: {
+            /** @description Total/combined score (RRF for hybrid, similarity for semantic, bm25 for bm25-only) */
+            total: number;
+            /** @description Vector similarity score (0 if not used) */
+            vector: number;
+            /** @description BM25 score (0 if not used) */
+            bm25: number;
+        };
+        CatalogSearchMeta: {
+            /** @description Search type used */
+            type: string;
+            /** @description Search scores */
+            score: components["schemas"]["CatalogSearchScore"];
+            /** @description BM25 rank (hybrid only) */
+            rankBm25?: number;
+            /** @description Vector rank (hybrid only) */
+            rankVector?: number;
+            /** @description Result source (hybrid only) */
+            source?: string;
+        };
+        CatalogSearchResult: {
+            /** @description Catalog state ID */
+            id: number;
+            /** @description Peer ID */
+            peerId?: number;
+            /** @description Username */
+            username: string;
+            /** @description Chat type */
+            chatType?: string;
+            /** @description Title */
+            title?: string;
+            /** @description About/description */
+            about?: string;
+            /** @description Participants count */
+            participantsCount?: number;
+            /** @description Language */
+            language?: string;
+            /** @description Keywords */
+            keywords?: string[];
+            /** @description Summary */
+            summary?: string;
+            /** @description Average messages per day */
+            avgMessagesPerDay?: number;
+            /** @description Search metadata */
+            meta: components["schemas"]["CatalogSearchMeta"];
         };
         RelatedLinkDto: {
             /** @enum {string} */
@@ -926,17 +916,17 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["ISearchChatsReq"];
+                "application/json": components["schemas"]["CatalogSearchRequest"];
             };
         };
         responses: {
-            /** @description Search */
+            /** @description Hybrid search across catalog */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["SearchResult"][];
+                    "application/json": components["schemas"]["CatalogSearchResult"][];
                 };
             };
             /** @description Unauthorized */

package/package.json CHANGED Viewed

@@ -1,13 +1,16 @@
 {
 	"name": "@skravets/eapi",
-	"version": "0.0.36",
+	"version": "0.0.37",
 	"module": "./dist/index.js",
 	"main": "./dist/index.cjs",
 	"types": "./dist/index.d.ts",
 	"scripts": {
 		"generate": "bun scripts/generate.ts",
 		"build": "bunx pkgroll",
-		"prepublishOnly": "bunx pkgroll"
+		"prepublishOnly": "bunx pkgroll",
+		"example:search:bm25": "bun examples/search/bm25/run.ts",
+		"example:search:vector": "bun examples/search/vector/run.ts",
+		"example:search:hybrid": "bun examples/search/hybrid/run.ts"
 	},
 	"exports": {
 		".": {