@seekora-ai/search-sdk 0.2.16 → 0.2.18

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';
@@ -217,6 +217,40 @@ export interface SearchResponse {
     context: SearchContext;
     [key: string]: any;
 }
+/**
+ * Options for a single query within a multi-search request.
+ * Mirrors SearchOptions but all fields are optional (q is required at call site).
+ */
+export interface MultiSearchQuery {
+    /** Search query string */
+    q: string;
+    per_page?: number;
+    page?: number;
+    filter?: string;
+    filter_by?: string;
+    facet_by?: string;
+    sort?: string;
+    sort_by?: string;
+    analytics_tags?: string[];
+    widget_mode?: boolean;
+    search_fields?: string[];
+    field_weights?: number[];
+    return_fields?: string[];
+    omit_fields?: string[];
+    snippet_fields?: string[];
+    group_field?: string;
+    group_size?: number;
+    include_suggestions?: boolean;
+    suggestions_limit?: number;
+    max_facet_values?: number;
+}
+/**
+ * Response from multiSearch() — an array of per-query results,
+ * each with its own SearchContext for independent analytics tracking.
+ */
+export interface MultiSearchResponse {
+    results: Array<SearchResponse>;
+}
 /**
  * Full query suggestions API response when returnFullResponse is true.
  * Includes suggestion hits plus dropdown recommendations (trending_searches, top_searches,
@@ -325,7 +359,6 @@ export declare class SeekoraClient {
     private analyticsApi;
     private storeManagementApi;
     private filtersApi;
-    private experimentsApi;
     private storeId;
     private readSecret;
     private writeSecret?;
@@ -356,6 +389,17 @@ export declare class SeekoraClient {
      * @returns SearchResponse with results and SearchContext
      */
     search(query: string, options?: Partial<SearchOptions>): Promise<SearchResponse>;
+    /**
+     * Execute multiple search queries in a single request.
+     *
+     * Batches up to 10 queries into one API call for efficiency.
+     * Each result gets its own SearchContext for independent analytics tracking
+     * (clicks, conversions, impressions are linked per sub-query).
+     *
+     * @param queries - Array of search queries (1-10)
+     * @returns MultiSearchResponse with per-query results and contexts
+     */
+    multiSearch(queries: MultiSearchQuery[]): Promise<MultiSearchResponse>;
     /**
      * Get query suggestions
      *
@@ -400,7 +444,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>;
     /**
@@ -408,15 +452,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
@@ -443,7 +478,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

@@ -97,7 +97,6 @@ class SeekoraClient {
         this.analyticsApi = new generated_1.AnalyticsEventsApi(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');
     }
     /**
@@ -172,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
@@ -190,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,
@@ -323,6 +320,131 @@ class SeekoraClient {
             throw this.handleError(error, 'search');
         }
     }
+    /**
+     * Execute multiple search queries in a single request.
+     *
+     * Batches up to 10 queries into one API call for efficiency.
+     * Each result gets its own SearchContext for independent analytics tracking
+     * (clicks, conversions, impressions are linked per sub-query).
+     *
+     * @param queries - Array of search queries (1-10)
+     * @returns MultiSearchResponse with per-query results and contexts
+     */
+    async multiSearch(queries) {
+        if (!queries || queries.length === 0) {
+            throw new Error('At least one search query is required');
+        }
+        if (queries.length > 10) {
+            throw new Error('Maximum 10 search queries per request');
+        }
+        this.logger.verbose('Executing multi-search', {
+            queryCount: queries.length,
+            queries: queries.map(q => q.q),
+        });
+        // Build request body matching DataTypes.MultiSearchRequest
+        const searches = queries.map(q => ({
+            q: q.q.trim() || '*',
+            per_page: q.per_page || 10,
+            page: q.page || 1,
+            filter: q.filter || q.filter_by,
+            facet_by: q.facet_by,
+            sort: q.sort || q.sort_by,
+            analytics_tags: q.analytics_tags,
+            widget_mode: q.widget_mode || false,
+            search_fields: q.search_fields,
+            field_weights: q.field_weights,
+            return_fields: q.return_fields,
+            omit_fields: q.omit_fields,
+            snippet_fields: q.snippet_fields,
+            group_field: q.group_field,
+            group_size: q.group_size,
+            include_suggestions: q.include_suggestions,
+            suggestions_limit: q.suggestions_limit,
+            max_facet_values: q.max_facet_values,
+        }));
+        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;
+        if (this.sessionId)
+            headers['x-session-id'] = this.sessionId;
+        try {
+            const response = await this.searchApi.v1MultiSearchPost(this.storeId, this.readSecret, { searches }, { headers });
+            const data = response.data;
+            const resultsList = [];
+            // Process each sub-result with its own SearchContext
+            const subResults = data?.data || [];
+            for (let i = 0; i < subResults.length; i++) {
+                const sub = subResults[i];
+                const correlationId = (0, utils_1.generateUUID)();
+                const searchId = sub?.search_id;
+                const context = {
+                    correlationId,
+                    searchId,
+                    userId: this.userId,
+                    anonId: this.anonId,
+                    sessionId: this.sessionId,
+                };
+                // Process facets (same logic as single search)
+                const facets = sub?.facets || [];
+                const facetsMap = {};
+                if (Array.isArray(facets)) {
+                    facets.forEach((facet, index) => {
+                        const fieldName = facet?.field_name || facet?.fieldName || facet?.name || `facet_${index}`;
+                        if (fieldName && (facet?.counts || facet?.values || Array.isArray(facet))) {
+                            facetsMap[fieldName] = {
+                                field_name: fieldName,
+                                counts: facet.counts || facet.values || [],
+                                stats: facet.stats || {},
+                            };
+                        }
+                    });
+                }
+                const result = {
+                    results: sub?.results || [],
+                    totalResults: sub?.total_results || 0,
+                    searchId,
+                    context,
+                    facets: facetsMap,
+                    facet_counts: facetsMap,
+                };
+                resultsList.push(result);
+                // Auto-track search event per sub-query
+                if (this.autoTrackSearch) {
+                    this.trackSearch({
+                        query: queries[i]?.q || '*',
+                        resultsCount: result.totalResults,
+                        context,
+                    }).catch((err) => {
+                        this.logger.warn('Failed to auto-track multi-search event', { index: i, error: err.message });
+                    });
+                }
+                // Auto-track impressions per sub-query
+                if (this.clientConfig.autoTrackImpressions !== false && result.results.length > 0) {
+                    this.autoTrackSearchImpressions(result, context).catch((err) => {
+                        this.logger.warn('Failed to auto-track multi-search impressions', { index: i, error: err.message });
+                    });
+                }
+            }
+            this.logger.info('Multi-search completed', {
+                queryCount: queries.length,
+                totalResults: resultsList.map(r => r.totalResults),
+            });
+            return { results: resultsList };
+        }
+        catch (error) {
+            this.logger.error('Multi-search failed', {
+                queryCount: queries.length,
+                error: error.message,
+                status: error.response?.status,
+            });
+            throw this.handleError(error, 'multiSearch');
+        }
+    }
     /**
      * Get query suggestions
      *
@@ -352,72 +474,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,
@@ -432,8 +489,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)
@@ -468,7 +525,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');
@@ -478,7 +535,7 @@ class SeekoraClient {
                 'x-storesecret': this.readSecret,
             };
             try {
-                const response = await this.storeManagementApi.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', {
@@ -528,7 +585,7 @@ class SeekoraClient {
             if (this.sessionId) {
                 headers['x-session-id'] = this.sessionId;
             }
-            const response = await this.storeManagementApi.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,
@@ -541,37 +598,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
@@ -658,7 +684,7 @@ class SeekoraClient {
                 'x-storesecret': this.readSecret,
                 'x-store-write-secret': this.writeSecret,
             };
-            const response = await this.storeManagementApi.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,
@@ -673,7 +699,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) });
@@ -691,7 +717,7 @@ class SeekoraClient {
                 'Content-Type': 'application/json',
             };
             try {
-                const response = await this.storeManagementApi.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', {
@@ -725,7 +751,7 @@ class SeekoraClient {
     async getConfigSchema() {
         this.logger.verbose('Getting configuration schema');
         try {
-            const response = await this.storeManagementApi.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,
@@ -766,7 +792,7 @@ class SeekoraClient {
                 id: document.id,
                 data: document.data,
             };
-            const response = await this.storeManagementApi.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,
@@ -810,7 +836,7 @@ class SeekoraClient {
                     data: doc.data,
                 })),
             };
-            const response = await this.storeManagementApi.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,
@@ -854,7 +880,7 @@ class SeekoraClient {
             throw new Error('Write secret is required for deleteDocument');
         }
         try {
-            const response = await this.storeManagementApi.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
@@ -932,7 +958,7 @@ class SeekoraClient {
                 default_sorting_field: request.defaultSortingField,
                 enable_nested_fields: request.enableNestedFields,
             };
-            const response = await this.storeManagementApi.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,
@@ -973,7 +999,7 @@ class SeekoraClient {
     async getSchema() {
         this.logger.verbose('Getting schema', { storeId: this.storeId });
         try {
-            const response = await this.storeManagementApi.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,
@@ -1024,7 +1050,7 @@ class SeekoraClient {
             throw new Error('Write secret is required for clearDocuments');
         }
         try {
-            const response = await this.storeManagementApi.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
@@ -1833,14 +1859,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', {
@@ -1865,13 +1884,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', {

package/dist/config.d.ts

@@ -3,13 +3,13 @@
  *
  * Production API only. Use baseUrl for custom endpoints.
  */
-export type SeekoraEnvironment = 'production';
+export type SeekoraEnvironment = 'production' | 'staging';
 export interface EnvironmentConfig {
     baseUrl: string;
     name: string;
 }
 /**
- * Environment configurations (production only in public SDK)
+ * Environment configurations
  */
 export declare const ENVIRONMENTS: Record<SeekoraEnvironment, EnvironmentConfig>;
 /**
@@ -17,6 +17,6 @@ export declare const ENVIRONMENTS: Record<SeekoraEnvironment, EnvironmentConfig>
  */
 export declare function getBaseUrl(environment?: SeekoraEnvironment, customBaseUrl?: string): string;
 /**
- * Get current environment (production only in public SDK)
+ * Get current environment
  */
 export declare function getEnvironment(environment?: SeekoraEnvironment): SeekoraEnvironment;

package/dist/config.js

@@ -9,13 +9,17 @@ exports.ENVIRONMENTS = void 0;
 exports.getBaseUrl = getBaseUrl;
 exports.getEnvironment = getEnvironment;
 /**
- * Environment configurations (production only in public SDK)
+ * Environment configurations
  */
 exports.ENVIRONMENTS = {
     production: {
         baseUrl: 'https://api.seekora.com/api',
         name: 'Production',
     },
+    staging: {
+        baseUrl: 'https://stage-api.seekora.ai/api',
+        name: 'Staging',
+    },
 };
 /**
  * Get base URL. Use customBaseUrl for custom endpoints.
@@ -24,11 +28,12 @@ function getBaseUrl(environment, customBaseUrl) {
     if (customBaseUrl) {
         return customBaseUrl;
     }
-    return exports.ENVIRONMENTS.production.baseUrl;
+    const env = environment || 'production';
+    return exports.ENVIRONMENTS[env]?.baseUrl || exports.ENVIRONMENTS.production.baseUrl;
 }
 /**
- * Get current environment (production only in public SDK)
+ * Get current environment
  */
 function getEnvironment(environment) {
-    return 'production';
+    return environment || 'production';
 }