@seekora-ai/search-sdk 0.2.15 → 0.2.17

package/dist/client.d.ts

@@ -2,7 +2,7 @@
  * Seekora SDK Client
  * High-level wrapper around generated OpenAPI client
  */
-import type { DataTypesIndexConfig, DataTypesEventPayload, DataTypesFiltersResponse, DataTypesFacetValuesSearchResponse, DataTypesFiltersSchemaResponse, DataTypesFilterField, DataTypesFilterValue, DataTypesFilterStats, DataTypesFilterSchemaField, DataTypesExperimentAssignmentResponse } from './generated';
+import type { DataTypesIndexConfig, DataTypesEventPayload, DataTypesFiltersResponse, DataTypesFacetValuesSearchResponse, DataTypesFiltersSchemaResponse, DataTypesFilterField, DataTypesFilterValue, DataTypesFilterStats, DataTypesFilterSchemaField } from './generated';
 import { type SeekoraEnvironment } from './config';
 import { Logger, type LogLevel, type LoggerConfig } from './logger';
 import { type ContextCollectorConfig, type BrowserContext } from './context-collector';
@@ -322,13 +322,9 @@ export declare class SeekoraClient {
     private config;
     private searchApi;
     private suggestionsApi;
-    private suggestionsConfigApi;
     private analyticsApi;
-    private storesApi;
-    private documentsApi;
-    private schemaApi;
+    private storeManagementApi;
     private filtersApi;
-    private experimentsApi;
     private storeId;
     private readSecret;
     private writeSecret?;
@@ -403,7 +399,7 @@ export declare class SeekoraClient {
     }): Promise<any[] | QuerySuggestionsFullResponse>;
     /**
      * Get query suggestions configuration (store-specific).
-     * Uses GET /api/v1/stores/{storeId}/query-suggestions/config via SDKQuerySuggestionsConfigApi.
+     * Uses GET /api/v1/stores/{storeId}/query-suggestions/config via StoreManagementApi.
      */
     getSuggestionsConfig(): Promise<any>;
     /**
@@ -411,15 +407,6 @@ export declare class SeekoraClient {
      * Returns store search configuration and onboarding status
      */
     getConfig(): Promise<DataTypesIndexConfig>;
-    /**
-     * Get experiment assignments for the current user
-     *
-     * Returns variant assignments for all running experiments.
-     * Uses hash-based consistent assignment on the backend.
-     *
-     * @returns ExperimentAssignmentResponse with assignments array
-     */
-    getExperimentAssignment(): Promise<DataTypesExperimentAssignmentResponse>;
     /**
      * Get store information
      * Returns store metadata including name, status, and configuration details
@@ -446,7 +433,7 @@ export declare class SeekoraClient {
     updateConfig(config: Partial<DataTypesIndexConfig>): Promise<DataTypesIndexConfig>;
     /**
      * Update query suggestions configuration (requires write secret).
-     * Uses PUT /api/v1/stores/{xStoreID}/query-suggestions/config via SDKQuerySuggestionsConfigApi.
+     * Uses PUT /api/v1/stores/{xStoreID}/query-suggestions/config via StoreManagementApi.
      */
     updateQuerySuggestionsConfig(config: any): Promise<any>;
     /**

package/dist/client.js

@@ -94,13 +94,9 @@ class SeekoraClient {
         // Initialize API clients
         this.searchApi = new generated_1.SearchApi(this.config);
         this.suggestionsApi = new generated_1.QuerySuggestionsApi(this.config);
-        this.suggestionsConfigApi = new generated_1.SDKQuerySuggestionsConfigApi(this.config);
         this.analyticsApi = new generated_1.AnalyticsEventsApi(this.config);
-        this.storesApi = new generated_1.SDKStoreConfigApi(this.config);
-        this.documentsApi = new generated_1.SDKDocumentsApi(this.config);
-        this.schemaApi = new generated_1.SDKSchemaApi(this.config);
+        this.storeManagementApi = new generated_1.StoreManagementApi(this.config);
         this.filtersApi = new generated_1.FiltersApi(this.config);
-        this.experimentsApi = new generated_1.SDKExperimentsApi(this.config);
         this.logger.info('SeekoraClient initialized successfully');
     }
     /**
@@ -175,7 +171,7 @@ class SeekoraClient {
             // Log API request start
             this.logger.verbose('Sending search API request', {
                 endpoint: '/api/v1/search',
-                method: 'POST',
+                method: 'GET',
                 storeId: this.storeId
             });
             // Build headers with personalization support
@@ -193,9 +189,7 @@ class SeekoraClient {
             if (this.sessionId) {
                 headers['x-session-id'] = this.sessionId;
             }
-            const response = await this.searchApi.v1SearchPost(this.storeId, this.readSecret, searchRequest, this.userId, this.anonId, this.sessionId, {
-                headers
-            });
+            const response = await this.searchApi.v1SearchGet(this.storeId, this.readSecret, searchRequest.q, this.userId, this.anonId, this.sessionId, searchRequest.page, searchRequest.per_page, searchRequest.sort, searchRequest.filter, searchRequest.facet_by, searchRequest.max_facet_values, searchRequest.widget_mode, searchRequest.include_suggestions, searchRequest.suggestions_limit, Array.isArray(searchRequest.analytics_tags) ? searchRequest.analytics_tags.join(',') : searchRequest.analytics_tags, Array.isArray(searchRequest.stopword_sets) ? searchRequest.stopword_sets.join(',') : searchRequest.stopword_sets, Array.isArray(searchRequest.synonym_sets) ? searchRequest.synonym_sets.join(',') : searchRequest.synonym_sets, searchRequest.search_fields, searchRequest.return_fields, searchRequest.omit_fields, searchRequest.snippet_fields, searchRequest.full_snippet_fields, searchRequest.field_weights, searchRequest.group_field, searchRequest.group_size, searchRequest.snippet_prefix, searchRequest.snippet_suffix, searchRequest.snippet_token_limit, searchRequest.snippet_min_len, searchRequest.include_snippets, searchRequest.prefix_mode, searchRequest.infix_mode, searchRequest.typo_max, searchRequest.typo_min_len_1, searchRequest.typo_min_len_2, searchRequest.search_timeout_ms, searchRequest.require_all_terms, searchRequest.exact_match_boost, searchRequest.cache_results, searchRequest.apply_rules, searchRequest.preset_name, searchRequest.facet_search_text, { headers });
             // Log API response received
             this.logger.verbose('Search API response received', {
                 status: response.status,
@@ -355,72 +349,7 @@ class SeekoraClient {
                 headers['x-anon-id'] = this.anonId;
             if (this.sessionId)
                 headers['x-session-id'] = this.sessionId;
-            // Use POST for:
-            // - Complex filtered_tabs (5+ tabs or very long JSON would exceed URL limits)
-            // - Explicit preference for POST (options.method === 'POST')
-            // Use GET for everything else (including simple filtered_tabs)
-            const hasComplexFilteredTabs = options?.filtered_tabs &&
-                options.filtered_tabs.length > 5;
-            const usePost = hasComplexFilteredTabs ||
-                options?.method === 'POST'; // Allow explicit POST preference
             const defaults = this.clientConfig?.suggestionsDefaults;
-            const buildRequestBody = () => {
-                const body = {
-                    query,
-                    hitsPerPage: options?.hitsPerPage ?? defaults?.hitsPerPage ?? 5,
-                    page: options?.page,
-                    include_categories: options?.include_categories,
-                    include_facets: options?.include_facets,
-                    max_categories: options?.max_categories,
-                    max_facets: options?.max_facets,
-                    min_popularity: options?.min_popularity,
-                    time_range: options?.time_range ?? defaults?.time_range,
-                    disable_typo_tolerance: options?.disable_typo_tolerance,
-                    include_dropdown_recommendations: options?.include_dropdown_recommendations ?? defaults?.include_dropdown_recommendations,
-                    include_dropdown_product_list: options?.include_dropdown_product_list ?? defaults?.include_dropdown_product_list,
-                    include_filtered_tabs: options?.include_filtered_tabs ?? defaults?.include_filtered_tabs,
-                    filtered_tabs: options?.filtered_tabs,
-                };
-                if (options?.analytics_tags) {
-                    body.analytics_tags = Array.isArray(options.analytics_tags)
-                        ? options.analytics_tags
-                        : [options.analytics_tags];
-                }
-                if (options?.tags_match_mode)
-                    body.tags_match_mode = options.tags_match_mode;
-                return body;
-            };
-            if (usePost) {
-                this.logger.verbose('Using POST endpoint (filtered_tabs or include_dropdown_recommendations)', {
-                    endpoint: '/api/v1/suggestions/queries',
-                    query,
-                });
-                const requestBody = buildRequestBody();
-                const response = await this.suggestionsApi.v1SuggestionsQueriesPost(this.storeId, this.readSecret, this.userId, this.anonId, this.sessionId, requestBody, { headers });
-                const responseData = response.data?.data || response.data;
-                const suggestions = responseData?.results?.[0]?.hits || responseData?.hits || [];
-                const extensions = responseData?.results?.[1]?.extensions ?? responseData?.results?.[0]?.extensions;
-                if (options?.returnFullResponse) {
-                    this.logger.info('Query suggestions retrieved (POST, full response)', {
-                        query,
-                        count: suggestions.length,
-                        status: response.status,
-                    });
-                    return {
-                        suggestions,
-                        results: responseData?.results,
-                        extensions: extensions ?? undefined,
-                        raw: responseData,
-                    };
-                }
-                this.logger.info('Query suggestions retrieved (POST)', {
-                    query,
-                    count: suggestions.length,
-                    status: response.status,
-                });
-                return suggestions;
-            }
-            // GET for simple requests and simple filtered_tabs (URL-encoded JSON)
             this.logger.verbose('Using GET endpoint', {
                 endpoint: '/api/v1/suggestions/queries',
                 query,
@@ -435,8 +364,8 @@ class SeekoraClient {
                 : undefined;
             const response = await this.suggestionsApi.v1SuggestionsQueriesGet(this.storeId, this.readSecret, this.userId, this.anonId, this.sessionId, query, // query parameter
             undefined, // q parameter (alias for query)
-            options?.hitsPerPage || 5, options?.page, analyticsTags, options?.tags_match_mode, options?.include_categories, options?.include_facets, options?.include_dropdown_recommendations, options?.include_dropdown_product_list, options?.include_filtered_tabs, undefined, // include_empty_query_recommendations
-            options?.max_categories, options?.max_facets, options?.min_popularity, options?.time_range, options?.disable_typo_tolerance, filteredTabsParam, // filtered_tabs as JSON string
+            options?.hitsPerPage ?? defaults?.hitsPerPage ?? 5, options?.page, analyticsTags, options?.tags_match_mode, options?.include_categories, options?.include_facets, options?.include_dropdown_recommendations ?? defaults?.include_dropdown_recommendations, options?.include_dropdown_product_list ?? defaults?.include_dropdown_product_list, options?.include_filtered_tabs ?? defaults?.include_filtered_tabs, undefined, // include_empty_query_recommendations
+            options?.max_categories, options?.max_facets, options?.min_popularity, (options?.time_range ?? defaults?.time_range), options?.disable_typo_tolerance, filteredTabsParam, // filtered_tabs as JSON string
             undefined, // userId (using header instead)
             undefined, // anonId (using header instead)
             undefined, // sessionId (using header instead)
@@ -471,7 +400,7 @@ class SeekoraClient {
     }
     /**
      * Get query suggestions configuration (store-specific).
-     * Uses GET /api/v1/stores/{storeId}/query-suggestions/config via SDKQuerySuggestionsConfigApi.
+     * Uses GET /api/v1/stores/{storeId}/query-suggestions/config via StoreManagementApi.
      */
     async getSuggestionsConfig() {
         this.logger.verbose('Getting suggestions configuration');
@@ -481,7 +410,7 @@ class SeekoraClient {
                 'x-storesecret': this.readSecret,
             };
             try {
-                const response = await this.suggestionsConfigApi.apiV1StoresXStoreIDQuerySuggestionsConfigGet(this.storeId, this.readSecret, this.storeId, { headers });
+                const response = await this.storeManagementApi.apiV1StoresQuerySuggestionsConfigGet(this.storeId, this.readSecret, { headers });
                 const data = response.data?.data;
                 const config = data?.metadata?.config ?? data?.config ?? data;
                 this.logger.info('Suggestions configuration retrieved', {
@@ -531,7 +460,7 @@ class SeekoraClient {
             if (this.sessionId) {
                 headers['x-session-id'] = this.sessionId;
             }
-            const response = await this.storesApi.apiV1StoresXStoreIDConfigGet(this.storeId, this.readSecret, this.storeId, { headers });
+            const response = await this.storeManagementApi.apiV1StoresConfigGet(this.storeId, this.readSecret, { headers });
             const config = response.data?.data;
             this.logger.info('Store configuration retrieved', {
                 status: response.status,
@@ -544,37 +473,6 @@ class SeekoraClient {
             throw this.handleError(error, 'getConfig');
         }
     }
-    /**
-     * Get experiment assignments for the current user
-     *
-     * Returns variant assignments for all running experiments.
-     * Uses hash-based consistent assignment on the backend.
-     *
-     * @returns ExperimentAssignmentResponse with assignments array
-     */
-    async getExperimentAssignment() {
-        this.logger.verbose('Getting experiment assignments');
-        try {
-            const headers = {
-                'x-storeid': this.storeId,
-                'x-storesecret': this.readSecret,
-            };
-            if (this.userId)
-                headers['x-user-id'] = this.userId;
-            if (this.anonId)
-                headers['x-anon-id'] = this.anonId;
-            const response = await this.experimentsApi.v1ExperimentsAssignmentGet(this.storeId, this.readSecret, this.userId, this.anonId, { headers });
-            const data = response.data;
-            this.logger.info('Experiment assignments retrieved', {
-                count: data?.assignments?.length ?? 0,
-            });
-            return data;
-        }
-        catch (error) {
-            this.logger.error('Failed to get experiment assignments', { error: error.message });
-            throw this.handleError(error, 'getExperimentAssignment');
-        }
-    }
     /**
      * Get store information
      * Returns store metadata including name, status, and configuration details
@@ -661,7 +559,7 @@ class SeekoraClient {
                 'x-storesecret': this.readSecret,
                 'x-store-write-secret': this.writeSecret,
             };
-            const response = await this.storesApi.apiV1StoresXStoreIDConfigPut(this.storeId, this.writeSecret, this.storeId, config, { headers });
+            const response = await this.storeManagementApi.apiV1StoresConfigPut(this.storeId, this.writeSecret, config, { headers });
             const updatedConfig = response.data?.data;
             this.logger.info('Store configuration updated successfully', {
                 status: response.status,
@@ -676,7 +574,7 @@ class SeekoraClient {
     }
     /**
      * Update query suggestions configuration (requires write secret).
-     * Uses PUT /api/v1/stores/{xStoreID}/query-suggestions/config via SDKQuerySuggestionsConfigApi.
+     * Uses PUT /api/v1/stores/{xStoreID}/query-suggestions/config via StoreManagementApi.
      */
     async updateQuerySuggestionsConfig(config) {
         this.logger.verbose('Updating query suggestions configuration', { configKeys: Object.keys(config) });
@@ -694,7 +592,7 @@ class SeekoraClient {
                 'Content-Type': 'application/json',
             };
             try {
-                const response = await this.suggestionsConfigApi.apiV1StoresXStoreIDQuerySuggestionsConfigPut(this.storeId, this.writeSecret, this.storeId, config, { headers });
+                const response = await this.storeManagementApi.apiV1StoresQuerySuggestionsConfigPut(this.storeId, this.writeSecret, config, { headers });
                 const data = response.data?.data;
                 const updatedConfig = data?.metadata?.config ?? data?.config ?? data;
                 this.logger.info('Query suggestions configuration updated successfully', {
@@ -705,7 +603,7 @@ class SeekoraClient {
             }
             catch (apiError) {
                 this.logger.verbose('PUT via generated API failed, using direct HTTP', { message: apiError?.message });
-                const axiosInstance = this.suggestionsConfigApi.axios ?? this.suggestionsApi.axios ?? axios_1.default;
+                const axiosInstance = this.storeManagementApi.axios ?? this.suggestionsApi.axios ?? axios_1.default;
                 const baseUrl = this.config.basePath ?? 'https://api.seekora.com/api';
                 const response = await axiosInstance.put(`${baseUrl}/v1/stores/${this.storeId}/query-suggestions/config`, config, { headers });
                 const data = response.data?.data;
@@ -728,7 +626,7 @@ class SeekoraClient {
     async getConfigSchema() {
         this.logger.verbose('Getting configuration schema');
         try {
-            const response = await this.storesApi.apiV1StoresXStoreIDConfigSchemaGet(this.storeId, this.readSecret, this.storeId, {
+            const response = await this.storeManagementApi.apiV1StoresConfigSchemaGet(this.storeId, this.readSecret, {
                 headers: {
                     'x-storeid': this.storeId,
                     'x-storesecret': this.readSecret,
@@ -769,7 +667,7 @@ class SeekoraClient {
                 id: document.id,
                 data: document.data,
             };
-            const response = await this.documentsApi.apiV1StoresXStoreIDDocumentsPost(this.storeId, this.writeSecret, this.storeId, request);
+            const response = await this.storeManagementApi.apiV1StoresDocumentsPost(this.storeId, this.writeSecret, request);
             const responseData = response.data?.data;
             this.logger.info('Document indexed successfully', {
                 id: responseData?.id || document.id,
@@ -813,7 +711,7 @@ class SeekoraClient {
                     data: doc.data,
                 })),
             };
-            const response = await this.documentsApi.apiV1StoresXStoreIDDocumentsBulkPost(this.storeId, this.writeSecret, this.storeId, request);
+            const response = await this.storeManagementApi.apiV1StoresDocumentsBulkPost(this.storeId, this.writeSecret, request);
             const responseData = response.data?.data;
             this.logger.info('Bulk document indexing completed', {
                 successCount: responseData?.successCount || 0,
@@ -857,7 +755,7 @@ class SeekoraClient {
             throw new Error('Write secret is required for deleteDocument');
         }
         try {
-            const response = await this.documentsApi.apiV1StoresXStoreIDDocumentsDocumentIDDelete(this.storeId, this.writeSecret, this.storeId, documentId);
+            const response = await this.storeManagementApi.apiV1StoresDocumentsDocumentIDDelete(this.storeId, this.writeSecret, documentId);
             this.logger.info('Document deleted successfully', {
                 documentId,
                 status: response.status
@@ -935,7 +833,7 @@ class SeekoraClient {
                 default_sorting_field: request.defaultSortingField,
                 enable_nested_fields: request.enableNestedFields,
             };
-            const response = await this.schemaApi.apiV1StoresXStoreIDSchemaPost(this.storeId, this.writeSecret, this.storeId, apiRequest);
+            const response = await this.storeManagementApi.apiV1StoresSchemaPost(this.storeId, this.writeSecret, apiRequest);
             const responseData = response.data;
             this.logger.info('Schema created/updated successfully', {
                 name: responseData.data?.name,
@@ -976,7 +874,7 @@ class SeekoraClient {
     async getSchema() {
         this.logger.verbose('Getting schema', { storeId: this.storeId });
         try {
-            const response = await this.schemaApi.apiV1StoresXStoreIDSchemaGet(this.storeId, this.readSecret, this.storeId);
+            const response = await this.storeManagementApi.apiV1StoresSchemaGet(this.storeId, this.readSecret);
             const responseData = response.data;
             this.logger.info('Schema retrieved successfully', {
                 name: responseData.data?.name,
@@ -1027,7 +925,7 @@ class SeekoraClient {
             throw new Error('Write secret is required for clearDocuments');
         }
         try {
-            const response = await this.schemaApi.apiV1StoresXStoreIDDocumentsDelete(this.storeId, this.writeSecret, this.storeId);
+            const response = await this.storeManagementApi.apiV1StoresDocumentsDelete(this.storeId, this.writeSecret);
             const responseData = response.data;
             this.logger.info('Documents cleared successfully', {
                 deletedCount: responseData.data?.deleted_count
@@ -1836,14 +1734,7 @@ class SeekoraClient {
     async getFilters(options) {
         this.logger.verbose('Getting filters', { options });
         try {
-            const req = {
-                q: options?.q,
-                filter: options?.filter,
-                facet_by: options?.facetBy,
-                max_facet_values: options?.maxFacetValues,
-                disjunctive_facets: options?.disjunctiveFacets,
-            };
-            const response = await this.filtersApi.v1FiltersPost(this.storeId, this.readSecret, req);
+            const response = await this.filtersApi.v1FiltersGet(this.storeId, this.readSecret, options?.q, options?.filter, options?.facetBy, options?.maxFacetValues, options?.disjunctiveFacets?.join(','));
             const wrapper = response.data;
             const data = wrapper?.data || response.data;
             this.logger.info('Filters retrieved successfully', {
@@ -1868,13 +1759,7 @@ class SeekoraClient {
     async searchFacetValues(facetName, options) {
         this.logger.verbose('Searching facet values', { facetName, options });
         try {
-            const req = {
-                facet_query: options.facetQuery,
-                q: options?.q,
-                filter: options?.filter,
-                max_values: options?.maxValues,
-            };
-            const response = await this.filtersApi.v1FiltersFacetNameValuesPost(this.storeId, this.readSecret, facetName, req);
+            const response = await this.filtersApi.v1FiltersFacetNameValuesGet(this.storeId, this.readSecret, facetName, options.facetQuery, options?.q, options?.filter, options?.maxValues);
             const wrapper = response.data;
             const data = wrapper?.data || response.data;
             this.logger.info('Facet values retrieved', {