@seekora-ai/search-sdk 0.2.3 → 0.2.4

package/dist/generated/api.d.ts

@@ -13,6 +13,48 @@ import type { Configuration } from './configuration';
 import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
 import type { RequestArgs } from './base';
 import { BaseAPI } from './base';
+export interface AnalyticsABTestRequest {
+    'end_date': string;
+    'experiment_id'?: string;
+    'model_ids'?: Array<string>;
+    'start_date': string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsABTestResponse {
+    'control_variant'?: string;
+    'end_date'?: string;
+    'experiment_id'?: string;
+    'start_date'?: string;
+    'statistics'?: AnalyticsABTestStatistics;
+    /**
+     * running, completed, stopped
+     */
+    'status'?: string;
+    'variants'?: Array<AnalyticsABTestVariant>;
+}
+export interface AnalyticsABTestStatistics {
+    'confidence_level'?: number;
+    'conversion_lift_percent'?: number;
+    'ctr_lift_percent'?: number;
+    'is_significant'?: boolean;
+    'recommended_winner'?: string;
+    'revenue_lift_percent'?: number;
+    'sample_size_adequate'?: boolean;
+}
+export interface AnalyticsABTestVariant {
+    'conversion_rate'?: number;
+    'ctr'?: number;
+    'model_id'?: string;
+    'revenue_per_user'?: number;
+    'total_clicks'?: number;
+    'total_conversions'?: number;
+    'total_impressions'?: number;
+    'total_requests'?: number;
+    'total_revenue'?: number;
+    'traffic_percent'?: number;
+    'unique_users'?: number;
+    'variant_id'?: string;
+}
 export interface AnalyticsAPIResponse {
     'data'?: any;
     'error'?: string;
@@ -172,6 +214,51 @@ export interface AnalyticsArrayPositionAnalytic {
 export interface AnalyticsBatchPostRequest {
     'events'?: Array<DataTypesEventPayload>;
 }
+export interface AnalyticsBestModel {
+    'by_conversion_rate'?: string;
+    'by_ctr'?: string;
+    'by_latency'?: string;
+    'by_revenue'?: string;
+}
+export interface AnalyticsCTRRequestBody {
+    'end_date': string;
+    /**
+     * hour, day, week, month
+     */
+    'granularity'?: string;
+    'max_position'?: number;
+    'page'?: number;
+    'page_size'?: number;
+    'start_date': string;
+    'surface'?: string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsClickMetrics {
+    'attributed_clicks'?: number;
+    'attribution_rate'?: number;
+    'avg_position'?: number;
+    'clicks_by_subtype'?: {
+        [key: string]: number;
+    };
+    'time_series'?: Array<SeekoraGoSrcServicesAnalyticsTimeSeriesPoint>;
+    'total_clicks'?: number;
+    'unique_items'?: number;
+    'unique_sessions'?: number;
+    'unique_users'?: number;
+}
+export interface AnalyticsClickMetricsRequestBody {
+    'click_subtype'?: string;
+    'end_date': string;
+    /**
+     * hour, day, week, month
+     */
+    'granularity'?: string;
+    'page'?: number;
+    'page_size'?: number;
+    'start_date': string;
+    'surface'?: string;
+    'xstoreid'?: string;
+}
 export interface AnalyticsClickPositionBucket {
     'click_rate'?: number;
     'clicks'?: number;
@@ -185,6 +272,55 @@ export interface AnalyticsClickPositionBucket {
      */
     'share'?: number;
 }
+export interface AnalyticsCohort {
+    'cohort_date'?: string;
+    'initial_users'?: number;
+    /**
+     * absolute numbers retained
+     */
+    'retained'?: Array<number>;
+    /**
+     * retention % for each period
+     */
+    'retention'?: Array<number>;
+}
+export interface AnalyticsCohortBehavior {
+    'cohort_date'?: string;
+    'initial_users'?: number;
+    'metric_value'?: number;
+    'total_events'?: number;
+}
+export interface AnalyticsCohortBehaviorRequestBody {
+    'behavior_metric'?: string;
+    'cohort_by'?: string;
+    'cohort_event'?: string;
+    'end_date': string;
+    'start_date': string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsCohortBehaviorResult {
+    'cohort_by'?: string;
+    'cohorts'?: Array<AnalyticsCohortBehavior>;
+    'metric'?: string;
+}
+export interface AnalyticsCohortRetentionRequestBody {
+    'cohort_by'?: string;
+    'cohort_event'?: string;
+    'end_date': string;
+    'periods'?: number;
+    'retention_event'?: string;
+    'start_date': string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsCohortRetentionResult {
+    'cohort_by'?: string;
+    'cohorts'?: Array<AnalyticsCohort>;
+    /**
+     * [\"Period 0\", \"Period 1\", ...]
+     */
+    'period_names'?: Array<string>;
+    'periods'?: number;
+}
 export interface AnalyticsComparisonMeta {
     /**
      * Human readable comparison period
@@ -207,6 +343,48 @@ export interface AnalyticsComparisonMeta {
      */
     'mode'?: boolean;
 }
+export interface AnalyticsCondition {
+    'field'?: string;
+    /**
+     * =, !=, >, <, >=, <=, contains, not_contains, in, not_in
+     */
+    'operator'?: string;
+    'value'?: any;
+}
+export interface AnalyticsConversionMetrics {
+    'attributed_conversions'?: number;
+    'attribution_rate'?: number;
+    'avg_order_value'?: number;
+    'conversions_by_type'?: {
+        [key: string]: number;
+    };
+    'time_series'?: Array<SeekoraGoSrcServicesAnalyticsTimeSeriesPoint>;
+    'total_conversions'?: number;
+    'total_quantity'?: number;
+    'total_revenue'?: number;
+    'unique_orders'?: number;
+    'unique_users'?: number;
+}
+export interface AnalyticsConversionMetricsRequestBody {
+    'conversion_type'?: string;
+    'end_date': string;
+    /**
+     * hour, day, week, month
+     */
+    'granularity'?: string;
+    'page'?: number;
+    'page_size'?: number;
+    'start_date': string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsCreateFunnelRequestBody {
+    'conversion_window_hours'?: number;
+    'count_type'?: string;
+    'description'?: string;
+    'name': string;
+    'steps': Array<SeekoraGoSrcServicesAnalyticsFunnelStep>;
+    'store_id'?: number;
+}
 export interface AnalyticsCustomQueryRequest {
     'end_time'?: string;
     'granularity'?: string;
@@ -379,7 +557,7 @@ export interface AnalyticsFilterTrendsResponse {
     'top_filters'?: number;
     'total'?: number;
     'trends'?: {
-        [key: string]: Array<AnalyticsTimeSeriesPoint>;
+        [key: string]: Array<SeekoraGoSrcAnalyticsTimeSeriesPoint>;
     };
     'xstoreid'?: string;
 }
@@ -390,7 +568,7 @@ export interface AnalyticsFilterUsageStatistics {
     'filter_key'?: string;
     'filter_values'?: Array<AnalyticsFilterValueStatistic>;
     'total_usage'?: number;
-    'trend_data'?: Array<AnalyticsTimeSeriesPoint>;
+    'trend_data'?: Array<SeekoraGoSrcAnalyticsTimeSeriesPoint>;
     'unique_searches'?: number;
     'unique_users'?: number;
     'usage_percentage'?: number;
@@ -450,6 +628,80 @@ export interface AnalyticsFilterValueUsage {
      */
     'value_type'?: string;
 }
+export interface AnalyticsFunnel {
+    'conversion_window_hours'?: number;
+    /**
+     * unique_users, total_events
+     */
+    'count_type'?: string;
+    'created_at'?: string;
+    'description'?: string;
+    'id'?: string;
+    'is_active'?: boolean;
+    'name'?: string;
+    'org_id'?: number;
+    'orgcode'?: string;
+    'steps'?: Array<SeekoraGoSrcServicesAnalyticsFunnelStep>;
+    'store_id'?: number;
+    'updated_at'?: string;
+}
+export interface AnalyticsFunnelAnalysisRequestBody {
+    'conversion_window_hours'?: number;
+    'end_date': string;
+    'start_date': string;
+    'steps'?: Array<SeekoraGoSrcServicesAnalyticsFunnelStep>;
+    'xstoreid'?: string;
+}
+export interface AnalyticsFunnelData {
+    'overall_conversion_rate'?: number;
+    'steps'?: Array<AnalyticsFunnelStepResult>;
+}
+export interface AnalyticsFunnelDataPoint {
+    'converted_users'?: number;
+    'date'?: string;
+    'overall_conversion'?: number;
+    'total_users'?: number;
+}
+export interface AnalyticsFunnelRequestBody {
+    'end_date': string;
+    'funnel_steps'?: Array<string>;
+    /**
+     * hour, day, week, month
+     */
+    'granularity'?: string;
+    'page'?: number;
+    'page_size'?: number;
+    'start_date': string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsFunnelResult {
+    'analysis_window'?: AnalyticsTimeWindow;
+    'avg_time_to_convert_hours'?: number;
+    'funnel_id'?: string;
+    'funnel_name'?: string;
+    'overall_conversion'?: number;
+    'steps'?: Array<AnalyticsStepResult>;
+    'total_users'?: number;
+}
+export interface AnalyticsFunnelStepResult {
+    'conversion_rate_from_previous'?: number;
+    'count'?: number;
+    'dropoff_rate'?: number;
+    'name'?: string;
+    'unique_users'?: number;
+}
+export interface AnalyticsFunnelTrend {
+    'data_points'?: Array<AnalyticsFunnelDataPoint>;
+    'funnel_id'?: string;
+    'funnel_name'?: string;
+    'granularity'?: string;
+}
+export interface AnalyticsFunnelTrendRequestBody {
+    'end_date': string;
+    'granularity'?: string;
+    'start_date': string;
+    'xstoreid'?: string;
+}
 export interface AnalyticsGeoAnalytic {
     'city'?: string;
     'click_through_rate'?: number;
@@ -860,6 +1112,18 @@ export interface AnalyticsItemInsights {
     'unique_searches'?: number;
     'unique_users'?: number;
 }
+export interface AnalyticsItemPerformance {
+    'avg_position'?: number;
+    'clicks'?: number;
+    'conversion_rate'?: number;
+    'conversions'?: number;
+    'ctr'?: number;
+    'impressions'?: number;
+    'item_id'?: string;
+    'revenue'?: number;
+    'revenue_per_click'?: number;
+    'unique_users'?: number;
+}
 export interface AnalyticsItemPerformanceMetrics {
     'avg_position'?: number;
     'avg_score'?: number;
@@ -887,6 +1151,23 @@ export interface AnalyticsItemPerformanceMetrics {
     'unique_sorts'?: number;
     'unique_users'?: number;
 }
+export interface AnalyticsItemPerformanceRequest {
+    'end_date': string;
+    'limit'?: number;
+    /**
+     * clicks, conversions, revenue, ctr, impressions
+     */
+    'order_by'?: string;
+    'recommendation_type'?: string;
+    'start_date': string;
+    'surface'?: string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsItemPerformanceResponse {
+    'items'?: Array<AnalyticsItemPerformance>;
+    'summary'?: AnalyticsItemSummary;
+    'total_count'?: number;
+}
 export interface AnalyticsItemPerformanceTrend {
     'item_id'?: string;
     'item_name'?: string;
@@ -1087,6 +1368,14 @@ export interface AnalyticsItemQueryDiscovery {
      */
     'share'?: number;
 }
+export interface AnalyticsItemSummary {
+    'avg_conversion_rate'?: number;
+    'avg_ctr'?: number;
+    'total_clicks'?: number;
+    'total_conversions'?: number;
+    'total_impressions'?: number;
+    'total_revenue'?: number;
+}
 export interface AnalyticsItemTrendData {
     'avg_position'?: number;
     'clicks'?: number;
@@ -1095,6 +1384,23 @@ export interface AnalyticsItemTrendData {
     'revenue'?: number;
     'unique_users'?: number;
 }
+export interface AnalyticsJourneyEvent {
+    'event_id'?: string;
+    'event_ts'?: string;
+    'event_type'?: string;
+    'is_attributed'?: boolean;
+    'item_id'?: string;
+    'position'?: number;
+    'query'?: string;
+    'search_id'?: string;
+    'session_id'?: string;
+    'surface'?: string;
+    'value'?: number;
+}
+export interface AnalyticsKPIAnalyticsData {
+    'kpi_analytics'?: AnalyticsExtendedKPIResponse;
+    'pagination'?: AnalyticsPaginationInfo;
+}
 export interface AnalyticsKPIMetrics {
     'add_to_cart_rate'?: number;
     /**
@@ -1165,6 +1471,86 @@ export interface AnalyticsKPIPointExtended {
     'time_bucket'?: string;
     'unique_users'?: number;
 }
+export interface AnalyticsMergeProfilesRequestBody {
+    'anonymous_id': string;
+    'authenticated_id': string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsModelComparisonRequest {
+    'end_date': string;
+    'model_ids'?: Array<string>;
+    'start_date': string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsModelComparisonResponse {
+    'best_performing'?: AnalyticsBestModel;
+    'models'?: Array<AnalyticsModelPerformance>;
+}
+export interface AnalyticsModelPerformance {
+    'avg_inference_ms'?: number;
+    'avg_latency_ms'?: number;
+    'avg_recs_per_request'?: number;
+    'conversion_rate'?: number;
+    'ctr'?: number;
+    'fallback_rate'?: number;
+    'model_id'?: string;
+    'model_version'?: string;
+    'revenue_per_request'?: number;
+    'total_clicks'?: number;
+    'total_conversions'?: number;
+    'total_impressions'?: number;
+    'total_requests'?: number;
+    'total_revenue'?: number;
+}
+export interface AnalyticsOverviewComparison {
+    'conversion_rate'?: AnalyticsPeriodComparison;
+    'ctr'?: AnalyticsPeriodComparison;
+    'requests'?: AnalyticsPeriodComparison;
+    'revenue'?: AnalyticsPeriodComparison;
+}
+export interface AnalyticsPaginationInfo {
+    'has_more'?: boolean;
+    'limit'?: number;
+    'offset'?: number;
+    'total'?: number;
+}
+export interface AnalyticsPerformanceBySurfaceRequest {
+    'end_date': string;
+    'granularity'?: string;
+    'recommendation_type'?: string;
+    'start_date': string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsPerformanceBySurfaceResponse {
+    'summary'?: AnalyticsSurfaceMetrics;
+    'surfaces'?: Array<AnalyticsSurfacePerformance>;
+}
+export interface AnalyticsPerformanceByTypeRequest {
+    'end_date': string;
+    'granularity'?: string;
+    'start_date': string;
+    'surface'?: string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsPerformanceByTypeResponse {
+    'summary'?: AnalyticsTypeMetrics;
+    'types'?: Array<AnalyticsTypePerformance>;
+}
+export interface AnalyticsPeriodComparison {
+    'change_percent'?: number;
+    'current_value'?: number;
+    'previous_value'?: number;
+    /**
+     * up, down, stable
+     */
+    'trend'?: string;
+}
+export interface AnalyticsPositionCTR {
+    'clicks'?: number;
+    'ctr'?: number;
+    'impressions'?: number;
+    'position'?: number;
+}
 export interface AnalyticsQueryAnalytic {
     'add_to_carts'?: number;
     'avg_click_position'?: number;
@@ -1183,6 +1569,12 @@ export interface AnalyticsQueryAnalytic {
     'searches'?: number;
     'unique_users'?: number;
 }
+export interface AnalyticsQueryAnalyticsData {
+    'pagination'?: AnalyticsPaginationInfo;
+    'query_analytics'?: AnalyticsQueryResponse;
+    'sort_by'?: string;
+    'sort_order'?: string;
+}
 export interface AnalyticsQueryFilterAnalytics {
     /**
      * NEW: Individual array element insights
@@ -1221,7 +1613,7 @@ export interface AnalyticsQueryFilterTrend {
      * \"increasing\", \"decreasing\", \"stable\"
      */
     'trend'?: string;
-    'trend_data'?: Array<AnalyticsTimeSeriesPoint>;
+    'trend_data'?: Array<SeekoraGoSrcAnalyticsTimeSeriesPoint>;
 }
 export interface AnalyticsQueryFilterUsage {
     /**
@@ -1359,6 +1751,19 @@ export interface AnalyticsQueryInsights {
     'total_searches'?: number;
     'unique_users'?: number;
 }
+export interface AnalyticsQueryMetric {
+    'avg_latency_ms'?: number;
+    'avg_results'?: number;
+    'click_count'?: number;
+    'conversion_count'?: number;
+    'conversion_rate'?: number;
+    'ctr'?: number;
+    'normalized_query'?: string;
+    'query'?: string;
+    'search_count'?: number;
+    'unique_users'?: number;
+    'zero_result_count'?: number;
+}
 export interface AnalyticsQueryPerformanceAnalytics {
     'avg_results'?: number;
     'avg_search_duration_ms'?: number;
@@ -1694,7 +2099,7 @@ export interface AnalyticsQuerySuggestionsInsight {
     'requests_with_dropdown'?: number;
     'requests_with_filtered_tabs'?: number;
     'start_time'?: string;
-    'time_series'?: Array<AnalyticsTimePoint>;
+    'time_series'?: Array<SeekoraGoSrcAnalyticsTimePoint>;
     /**
      * Clicks on suggestions (linked by correlation_id)
      */
@@ -1759,6 +2164,191 @@ export interface AnalyticsQuerySuggestionsResponse {
     'total'?: number;
     'xstoreid'?: string;
 }
+export interface AnalyticsRecommendationCTR {
+    'clicks'?: number;
+    'conversion_rate'?: number;
+    'conversions'?: number;
+    'ctr'?: number;
+    'impressions'?: number;
+    'recommendation_type'?: string;
+    'surface'?: string;
+}
+export interface AnalyticsRecommendationCTRRequestBody {
+    'end_date': string;
+    /**
+     * hour, day, week, month
+     */
+    'granularity'?: string;
+    'max_position'?: number;
+    'page'?: number;
+    'page_size'?: number;
+    'recommendation_type'?: string;
+    'start_date': string;
+    'surface'?: string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsRecommendationFunnelRequest {
+    'end_date': string;
+    'recommendation_type'?: string;
+    'start_date': string;
+    'surface'?: string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsRecommendationFunnelResponse {
+    'avg_time_to_click_seconds'?: number;
+    'avg_time_to_convert_seconds'?: number;
+    'click_to_convert_rate'?: number;
+    'overall_conversion_rate'?: number;
+    'request_to_click_rate'?: number;
+    'steps'?: Array<SeekoraGoSrcRoutesAnalyticsFunnelStep>;
+}
+export interface AnalyticsRecommendationMetrics {
+    'avg_latency_ms'?: number;
+    'avg_recs_per_request'?: number;
+    'fallback_rate'?: number;
+    'p95_latency_ms'?: number;
+    'requests_by_surface'?: {
+        [key: string]: number;
+    };
+    'requests_by_type'?: {
+        [key: string]: number;
+    };
+    'time_series'?: Array<SeekoraGoSrcServicesAnalyticsTimeSeriesPoint>;
+    'total_recommendations'?: number;
+    'total_requests'?: number;
+    'unique_users'?: number;
+}
+export interface AnalyticsRecommendationMetricsRequestBody {
+    'end_date': string;
+    /**
+     * hour, day, week, month
+     */
+    'granularity'?: string;
+    'page'?: number;
+    'page_size'?: number;
+    'recommendation_type'?: string;
+    'start_date': string;
+    'surface'?: string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsRecommendationOverviewRequest {
+    'compare_with_previous'?: boolean;
+    'end_date': string;
+    /**
+     * daily, weekly, monthly
+     */
+    'granularity'?: string;
+    /**
+     * fbt, similar, personalized, trending
+     */
+    'recommendation_type'?: string;
+    'start_date': string;
+    'surface'?: string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsRecommendationOverviewResponse {
+    'avg_latency_ms'?: number;
+    'avg_recs_per_request'?: number;
+    'breakdown_by_surface'?: {
+        [key: string]: AnalyticsSurfaceMetrics;
+    };
+    /**
+     * Breakdown by dimensions
+     */
+    'breakdown_by_type'?: {
+        [key: string]: AnalyticsTypeMetrics;
+    };
+    /**
+     * Period comparison (if requested)
+     */
+    'comparison'?: AnalyticsOverviewComparison;
+    'conversion_rate'?: number;
+    'ctr'?: number;
+    'fallback_rate'?: number;
+    'p95_latency_ms'?: number;
+    'revenue_per_request'?: number;
+    /**
+     * Time series data
+     */
+    'time_series'?: Array<SeekoraGoSrcRoutesAnalyticsTimePoint>;
+    'total_clicks'?: number;
+    'total_conversions'?: number;
+    'total_impressions'?: number;
+    'total_requests'?: number;
+    'total_revenue'?: number;
+    'unique_users'?: number;
+}
+export interface AnalyticsResolveAlertRequest {
+    'resolution'?: string;
+}
+export interface AnalyticsRevenueAttribution {
+    'attributed_revenue'?: number;
+    'attribution_rate'?: number;
+    'avg_order_value'?: number;
+    'reco_attributed_revenue'?: number;
+    'search_attributed_revenue'?: number;
+    'time_series'?: Array<SeekoraGoSrcServicesAnalyticsTimeSeriesPoint>;
+    'total_revenue'?: number;
+}
+export interface AnalyticsRevenueAttributionRequest {
+    'end_date': string;
+    'granularity'?: string;
+    'recommendation_type'?: string;
+    'start_date': string;
+    'surface'?: string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsRevenueAttributionResponse {
+    'assisted_revenue'?: number;
+    'attributed_revenue'?: number;
+    'attribution'?: AnalyticsRevenueBreakdown;
+    'attribution_rate'?: number;
+    'avg_attributed_order_value'?: number;
+    'avg_order_value'?: number;
+    'direct_revenue'?: number;
+    'revenue_by_surface'?: {
+        [key: string]: number;
+    };
+    'revenue_by_type'?: {
+        [key: string]: number;
+    };
+    'time_series'?: Array<AnalyticsRevenueTimePoint>;
+    'total_revenue'?: number;
+}
+export interface AnalyticsRevenueBreakdown {
+    'first_click'?: number;
+    'last_click'?: number;
+    'linear'?: number;
+    'time_decay'?: number;
+}
+export interface AnalyticsRevenueRequestBody {
+    'attributed_only'?: boolean;
+    'end_date': string;
+    /**
+     * hour, day, week, month
+     */
+    'granularity'?: string;
+    'page'?: number;
+    'page_size'?: number;
+    'start_date': string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsRevenueTimePoint {
+    'attributed_revenue'?: number;
+    'orders'?: number;
+    'timestamp'?: string;
+    'total_revenue'?: number;
+}
+export declare const AnalyticsRuleType: {
+    readonly RuleTypeFreshness: "freshness";
+    readonly RuleTypeVolume: "volume";
+    readonly RuleTypeSchema: "schema";
+    readonly RuleTypeAnomaly: "anomaly";
+    readonly RuleTypeCardinality: "cardinality";
+    readonly RuleTypeCompleteness: "completeness";
+    readonly RuleTypeCustom: "custom";
+};
+export type AnalyticsRuleType = typeof AnalyticsRuleType[keyof typeof AnalyticsRuleType];
 export interface AnalyticsSearchCount {
     'count'?: number;
     'date'?: string;
@@ -1768,6 +2358,31 @@ export interface AnalyticsSearchCountResponse {
     'message'?: string;
     'status'?: number;
 }
+export interface AnalyticsSearchMetrics {
+    'avg_latency_ms'?: number;
+    'avg_results_per_search'?: number;
+    'p95_latency_ms'?: number;
+    'p99_latency_ms'?: number;
+    'time_series'?: Array<SeekoraGoSrcServicesAnalyticsTimeSeriesPoint>;
+    'total_results'?: number;
+    'total_searches'?: number;
+    'unique_sessions'?: number;
+    'unique_users'?: number;
+    'zero_result_rate'?: number;
+    'zero_result_searches'?: number;
+}
+export interface AnalyticsSearchMetricsRequestBody {
+    'end_date': string;
+    /**
+     * hour, day, week, month
+     */
+    'granularity'?: string;
+    'page'?: number;
+    'page_size'?: number;
+    'start_date': string;
+    'surface'?: string;
+    'xstoreid'?: string;
+}
 export interface AnalyticsSharedQueryAnalysis {
     'competitor_id'?: string;
     'competitor_position'?: number;
@@ -1776,6 +2391,21 @@ export interface AnalyticsSharedQueryAnalysis {
     'query'?: string;
     'this_item_position'?: number;
 }
+export interface AnalyticsStepResult {
+    'avg_time_from_prev_hours'?: number;
+    /**
+     * from previous step
+     */
+    'conversion_rate'?: number;
+    /**
+     * users who dropped off at this step
+     */
+    'dropoff_rate'?: number;
+    'event_name'?: string;
+    'event_type'?: string;
+    'step_order'?: number;
+    'users'?: number;
+}
 export interface AnalyticsStoreBreakdown {
     'compare_summary'?: AnalyticsKPIMetrics;
     'store_id'?: number;
@@ -1807,17 +2437,119 @@ export interface AnalyticsStoreQueryBreakdown {
     'total'?: number;
     'xstoreid'?: string;
 }
-export interface AnalyticsTimePoint {
-    'avg_processing_time_ms'?: number;
-    'avg_suggestions_per_request'?: number;
+export interface AnalyticsSuggestionCTRResponse {
+    'by_click_type'?: Array<AnalyticsSuggestionCTRResponseByClickTypeInner>;
+    'clicks'?: number;
+    'ctr'?: number;
+    'end_time'?: string;
+    'impressions'?: number;
+    'org_code'?: string;
+    'start_time'?: string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsSuggestionCTRResponseByClickTypeInner {
+    'click_type'?: string;
+    'clicks'?: number;
+    'ctr'?: number;
+}
+export interface AnalyticsSuggestionClickStat {
+    'avg_position'?: number;
+    'click_type'?: string;
+    'clicks'?: number;
+    'section'?: string;
+    'unique_users'?: number;
+}
+export interface AnalyticsSuggestionClicksResponse {
+    'data'?: Array<AnalyticsSuggestionClickStat>;
+    'end_time'?: string;
+    'limit'?: number;
+    'org_code'?: string;
+    'page'?: number;
+    'start_time'?: string;
+    'total'?: number;
+    'xstoreid'?: string;
+}
+export interface AnalyticsSuggestionImpressionStat {
+    'avg_suggestions'?: number;
+    'date'?: string;
+    'impressions'?: number;
+    'unique_users'?: number;
+    'with_categories'?: number;
+    'with_products'?: number;
+}
+export interface AnalyticsSuggestionImpressionsResponse {
+    'data'?: Array<AnalyticsSuggestionImpressionStat>;
+    'end_time'?: string;
+    'limit'?: number;
+    'org_code'?: string;
+    'page'?: number;
+    'start_time'?: string;
+    'total'?: number;
+    'xstoreid'?: string;
+}
+export interface AnalyticsSurfaceMetrics {
+    'clicks'?: number;
+    'conversion_rate'?: number;
+    'conversions'?: number;
+    'ctr'?: number;
+    'impressions'?: number;
     'requests'?: number;
-    'time'?: string;
-    'total_suggestions_returned'?: number;
+    'revenue'?: number;
 }
-export interface AnalyticsTimeSeriesPoint {
-    'percentage'?: number;
-    'timestamp'?: string;
-    'value'?: number;
+export interface AnalyticsSurfacePerformance {
+    'metrics'?: AnalyticsSurfaceMetrics;
+    'surface'?: string;
+    'time_series'?: Array<SeekoraGoSrcRoutesAnalyticsTimePoint>;
+}
+export declare const AnalyticsThresholdType: {
+    readonly ThresholdMin: "min";
+    readonly ThresholdMax: "max";
+    readonly ThresholdRange: "range";
+    readonly ThresholdStdDev: "stddev";
+};
+export type AnalyticsThresholdType = typeof AnalyticsThresholdType[keyof typeof AnalyticsThresholdType];
+export interface AnalyticsTimeWindow {
+    'end_date'?: string;
+    'start_date'?: string;
+}
+export interface AnalyticsTopQueriesRequestBody {
+    'end_date': string;
+    /**
+     * hour, day, week, month
+     */
+    'granularity'?: string;
+    'limit'?: number;
+    'min_count'?: number;
+    'page'?: number;
+    'page_size'?: number;
+    'sort_by'?: string;
+    'start_date': string;
+    'surface'?: string;
+    'xstoreid'?: string;
+}
+export interface AnalyticsTypeMetrics {
+    'avg_latency_ms'?: number;
+    'clicks'?: number;
+    'conversion_rate'?: number;
+    'conversions'?: number;
+    'ctr'?: number;
+    'impressions'?: number;
+    'requests'?: number;
+    'revenue'?: number;
+}
+export interface AnalyticsTypePerformance {
+    'metrics'?: AnalyticsTypeMetrics;
+    'recommendation_type'?: string;
+    'time_series'?: Array<SeekoraGoSrcRoutesAnalyticsTimePoint>;
+    'top_items'?: Array<string>;
+}
+export interface AnalyticsUpdateFunnelRequestBody {
+    'conversion_window_hours'?: number;
+    'count_type'?: string;
+    'description'?: string;
+    'is_active'?: boolean;
+    'name'?: string;
+    'steps'?: Array<SeekoraGoSrcServicesAnalyticsFunnelStep>;
 }
 export interface AnalyticsWidgetData {
     'id'?: string;
@@ -1826,6 +2558,25 @@ export interface AnalyticsWidgetData {
     'secondary_text'?: string;
     'tertiary_text'?: string;
 }
+export interface AnalyticsZeroResultQuery {
+    'count'?: number;
+    'last_seen'?: string;
+    'query'?: string;
+    'unique_users'?: number;
+}
+export interface AnalyticsZeroResultRequestBody {
+    'end_date': string;
+    /**
+     * hour, day, week, month
+     */
+    'granularity'?: string;
+    'limit'?: number;
+    'min_count'?: number;
+    'page'?: number;
+    'page_size'?: number;
+    'start_date': string;
+    'xstoreid'?: string;
+}
 export interface BatchRecordResult {
     'errors'?: Array<string>;
     'record'?: {
@@ -1922,6 +2673,37 @@ export interface BillingServiceTrialEligibilityResponse {
     'trial_subscription_id'?: number;
     'trial_used_at'?: string;
 }
+export interface ConnectorsCreateConnectorRequest {
+    'config': {
+        [key: string]: any;
+    };
+    'connector_name': string;
+    'connector_type': ConnectorsCreateConnectorRequestConnectorTypeEnum;
+    'event_filter'?: {
+        [key: string]: any;
+    };
+    'is_active'?: boolean;
+    'provider': string;
+    'store_id'?: number;
+    'sync_frequency'?: string;
+}
+export declare const ConnectorsCreateConnectorRequestConnectorTypeEnum: {
+    readonly import: "import";
+    readonly export: "export";
+};
+export type ConnectorsCreateConnectorRequestConnectorTypeEnum = typeof ConnectorsCreateConnectorRequestConnectorTypeEnum[keyof typeof ConnectorsCreateConnectorRequestConnectorTypeEnum];
+export interface ConnectorsUpdateConnectorRequest {
+    'config'?: {
+        [key: string]: any;
+    };
+    'connector_name'?: string;
+    'event_filter'?: {
+        [key: string]: any;
+    };
+    'is_active'?: boolean;
+    'is_paused'?: boolean;
+    'sync_frequency'?: string;
+}
 export interface DataTypesAPICall {
     /**
      * Primary key
@@ -3352,132 +4134,149 @@ export interface DataTypesErrorMetaResponse {
 }
 export interface DataTypesEventPayload {
     /**
-     * Journey Tracking & Analytics
+     * ============================================================================ Analytics & Metadata ============================================================================
      */
     'analytics_tags'?: Array<string>;
     /**
-     * Anonymous user identifier
+     * V3 anonymous user ID
      */
-    'anon_id'?: string;
+    'anonymous_id'?: string;
+    'brands_count'?: number;
     'browser_language'?: string;
     /**
-     * Browser Context (from SDK)
+     * Browser Context
      */
     'browser_name'?: string;
     'browser_version'?: string;
+    'categories_count'?: number;
     'city'?: string;
     /**
-     * Click/Interaction Event Fields
+     * query, product, category, brand, trending, recent
+     */
+    'click_type'?: string;
+    /**
+     * ============================================================================ Click/Interaction Event Fields (V3) ============================================================================
      */
     'clicked_item_id'?: string;
+    'clicked_value'?: string;
     'color_depth'?: number;
     'connection_downlink'?: number;
     'connection_effective_type'?: string;
     /**
-     * Connection Context (from SDK)
+     * Connection Context
      */
     'connection_type'?: string;
-    /**
-     * Primary journey key across search → clicks → conversions
-     */
     'correlation_id'?: string;
     /**
-     * Enhanced Geo data fields for direct submission
+     * ============================================================================ Geo Context (V3) ============================================================================
      */
     'country'?: string;
-    /**
-     * ISO 3166-1 alpha-2 country code
-     */
-    'country_code'?: string;
-    /**
-     * Currency for value
-     */
+    'country_code'?: string;
     'currency'?: string;
+    'custom_json'?: string;
     'device_fingerprint'?: string;
     'device_type'?: string;
     /**
-     * Core Event Information
+     * ============================================================================ Core Event Information (V3) ============================================================================
      */
     'event_id'?: string;
     'event_name'?: string;
     /**
-     * Device & Location Context
+     * V3 timestamp
      */
-    'ip'?: string;
-    'is_mobile'?: boolean;
-    'is_tablet'?: boolean;
-    'is_touch_device'?: boolean;
+    'event_ts'?: string;
+    'has_dropdown'?: number;
+    'has_filtered_tabs'?: number;
+    'impression_duration_ms'?: number;
     /**
-     * Performance
+     * ============================================================================ Device Context (V3) ============================================================================
      */
-    'latency_ms'?: number;
+    'ip'?: string;
+    'is_attributed'?: number;
     /**
-     * Legacy field
+     * V3 sends 0/1; accept both number and bool via pointer to uint8 (0 = false, 1 = true)
      */
-    'location'?: string;
+    'is_mobile'?: number;
+    'is_tablet'?: number;
+    'is_touch_device'?: boolean;
     /**
-     * Flexible metadata including search_id, position, etc.
+     * Request Linking (V3)
      */
+    'journey_id'?: string;
+    'latency_ms'?: number;
     'metadata'?: {
         [key: string]: any;
     };
-    'org_id'?: string;
+    /**
+     * ============================================================================ Suggestion Impression Fields (V3) ============================================================================
+     */
+    'normalized_query'?: string;
+    /**
+     * Organization Context (V3 naming)
+     */
+    'orgcode'?: string;
+    'original_query'?: string;
     'page_path'?: string;
     'page_referrer'?: string;
     'page_title'?: string;
     /**
-     * Page Context (from SDK)
+     * Page Context
      */
     'page_url'?: string;
     'pixel_ratio'?: number;
-    /**
-     * web, ios, android
-     */
     'platform'?: string;
+    'position'?: number;
+    'products_count'?: number;
     /**
-     * Search Event Fields
+     * ============================================================================ Search Event Fields ============================================================================
      */
     'query'?: string;
+    'recent_count'?: number;
     'region'?: string;
+    'request_id'?: string;
     'results_count'?: number;
     'screen_height'?: number;
-    /**
-     * Enhanced Device/Screen Context (from SDK)
-     */
     'screen_width'?: number;
-    /**
-     * Optional search-scoped identifier (mirrors correlation_id when you have a natural search key)
-     */
     'search_id'?: string;
     /**
-     * Session identifier for journey tracking
+     * suggestions, products, categories, brands, tabs
      */
+    'section'?: string;
     'session_id'?: string;
-    /**
-     * Organization Context
-     */
-    'store_id'?: string;
-    'timestamp'?: string;
+    'suggestion_id'?: string;
+    'suggestion_popularity'?: number;
+    'suggestion_source'?: string;
+    'suggestion_type'?: string;
+    'suggestions_count'?: number;
+    'tab_filter'?: string;
+    'tab_id'?: string;
+    'tab_label'?: string;
     'timezone'?: string;
     'timezone_offset'?: number;
+    'total_suggestions'?: number;
+    'trending_count'?: number;
     /**
-     * User Context
+     * User Context (V3 naming)
      */
     'user_id'?: string;
     'utm_campaign'?: string;
     'utm_content'?: string;
     'utm_medium'?: string;
     /**
-     * UTM Parameters (from SDK)
+     * ============================================================================ UTM Parameters ============================================================================
      */
     'utm_source'?: string;
     'utm_term'?: string;
     /**
-     * Business Context
+     * ============================================================================ Business Context ============================================================================
      */
     'value'?: number;
     'viewport_height'?: number;
     'viewport_width'?: number;
+    /**
+     * V3 store identifier
+     */
+    'xstoreid'?: string;
 }
 export interface DataTypesFacetRange {
     /**
@@ -3721,11 +4520,136 @@ export interface DataTypesGenerateInvoiceReceiptResponse {
     'receipt_id'?: number;
     'success'?: boolean;
 }
+export interface DataTypesGenericResponseAnalyticsABTestResponse {
+    'data'?: AnalyticsABTestResponse;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsClickMetrics {
+    'data'?: AnalyticsClickMetrics;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsCohortBehaviorResult {
+    'data'?: AnalyticsCohortBehaviorResult;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsCohortRetentionResult {
+    'data'?: AnalyticsCohortRetentionResult;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsConversionMetrics {
+    'data'?: AnalyticsConversionMetrics;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsFunnel {
+    'data'?: AnalyticsFunnel;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsFunnelData {
+    'data'?: AnalyticsFunnelData;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsFunnelResult {
+    'data'?: AnalyticsFunnelResult;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsFunnelTrend {
+    'data'?: AnalyticsFunnelTrend;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsItemPerformanceResponse {
+    'data'?: AnalyticsItemPerformanceResponse;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsModelComparisonResponse {
+    'data'?: AnalyticsModelComparisonResponse;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsPerformanceBySurfaceResponse {
+    'data'?: AnalyticsPerformanceBySurfaceResponse;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsPerformanceByTypeResponse {
+    'data'?: AnalyticsPerformanceByTypeResponse;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsRecommendationFunnelResponse {
+    'data'?: AnalyticsRecommendationFunnelResponse;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsRecommendationMetrics {
+    'data'?: AnalyticsRecommendationMetrics;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsRecommendationOverviewResponse {
+    'data'?: AnalyticsRecommendationOverviewResponse;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsRevenueAttribution {
+    'data'?: AnalyticsRevenueAttribution;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsRevenueAttributionResponse {
+    'data'?: AnalyticsRevenueAttributionResponse;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseAnalyticsSearchMetrics {
+    'data'?: AnalyticsSearchMetrics;
+    'message'?: string;
+    'status'?: number;
+}
 export interface DataTypesGenericResponseAny {
     'data'?: any;
     'message'?: string;
     'status'?: number;
 }
+export interface DataTypesGenericResponseArrayAnalyticsFunnel {
+    'data'?: Array<AnalyticsFunnel>;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseArrayAnalyticsJourneyEvent {
+    'data'?: Array<AnalyticsJourneyEvent>;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseArrayAnalyticsPositionCTR {
+    'data'?: Array<AnalyticsPositionCTR>;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseArrayAnalyticsQueryMetric {
+    'data'?: Array<AnalyticsQueryMetric>;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseArrayAnalyticsRecommendationCTR {
+    'data'?: Array<AnalyticsRecommendationCTR>;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseArrayAnalyticsZeroResultQuery {
+    'data'?: Array<AnalyticsZeroResultQuery>;
+    'message'?: string;
+    'status'?: number;
+}
 export interface DataTypesGenericResponseArrayBillingServiceCancelledSubscriptionInfo {
     'data'?: Array<BillingServiceCancelledSubscriptionInfo>;
     'message'?: string;
@@ -3751,6 +4675,11 @@ export interface DataTypesGenericResponseArrayDataTypesUserWithPermissions {
     'message'?: string;
     'status'?: number;
 }
+export interface DataTypesGenericResponseArrayModelsSimilarUser {
+    'data'?: Array<ModelsSimilarUser>;
+    'message'?: string;
+    'status'?: number;
+}
 export interface DataTypesGenericResponseArrayString {
     'data'?: Array<string>;
     'message'?: string;
@@ -3886,6 +4815,26 @@ export interface DataTypesGenericResponseMenuRoutesAddMenuResponse {
     'message'?: string;
     'status'?: number;
 }
+export interface DataTypesGenericResponseModelsMergeProfilesResponse {
+    'data'?: ModelsMergeProfilesResponse;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseModelsPersonalizationContext {
+    'data'?: ModelsPersonalizationContext;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseModelsUserEventsResponse {
+    'data'?: ModelsUserEventsResponse;
+    'message'?: string;
+    'status'?: number;
+}
+export interface DataTypesGenericResponseModelsUserProfile {
+    'data'?: ModelsUserProfile;
+    'message'?: string;
+    'status'?: number;
+}
 export interface DataTypesGenericResponsePaymentGatewayCreditProrationResult {
     'data'?: PaymentGatewayCreditProrationResult;
     'message'?: string;
@@ -5379,11 +6328,26 @@ export interface DataTypesOrgMemberWithUser {
     'email'?: string;
     'first_name'?: string;
     'is_active'?: boolean;
+    /**
+     * True if user has custom/user-specific role
+     */
+    'is_user_specific'?: boolean;
     'joined_at'?: string;
     'last_name'?: string;
     'member_id'?: number;
+    /**
+     * Org-level: owner, admin, member
+     */
     'member_role'?: string;
     'org_id'?: number;
+    /**
+     * Role ID from mrole
+     */
+    'role_id'?: number;
+    /**
+     * Actual role from mrole (e.g. Admin, Content Editor)
+     */
+    'role_name'?: string;
     /**
      * Number of stores user has access to
      */
@@ -8422,6 +9386,220 @@ export interface MgDocumentTypesCreateArticleRequestDto {
     'tags'?: Array<string>;
     'title'?: string;
 }
+export interface ModelsAffinityScore {
+    'name'?: string;
+    'score'?: number;
+}
+export interface ModelsCreateCustomEventFieldRequest {
+    'allowed_values'?: Array<string>;
+    'default_value'?: string;
+    'description'?: string;
+    'display_name'?: string;
+    'field_name': string;
+    'field_slot': number;
+    'field_type': ModelsCreateCustomEventFieldRequestFieldTypeEnum;
+    /**
+     * defaults to false
+     */
+    'is_indexed'?: boolean;
+    /**
+     * defaults to false
+     */
+    'is_required'?: boolean;
+    'max_length'?: number;
+    'max_value'?: number;
+    'min_value'?: number;
+    'validation_regex'?: string;
+}
+export declare const ModelsCreateCustomEventFieldRequestFieldTypeEnum: {
+    readonly string: "string";
+    readonly number: "number";
+    readonly boolean: "boolean";
+    readonly datetime: "datetime";
+    readonly array: "array";
+};
+export type ModelsCreateCustomEventFieldRequestFieldTypeEnum = typeof ModelsCreateCustomEventFieldRequestFieldTypeEnum[keyof typeof ModelsCreateCustomEventFieldRequestFieldTypeEnum];
+export interface ModelsCreateCustomEventTypeRequest {
+    'description'?: string;
+    'display_name'?: string;
+    /**
+     * defaults to \"custom\"
+     */
+    'event_category'?: string;
+    'event_name': string;
+    /**
+     * defaults to true
+     */
+    'is_active'?: boolean;
+    /**
+     * defaults to 100000
+     */
+    'max_daily_events'?: number;
+    'store_id'?: number;
+}
+export interface ModelsMergeProfilesResponse {
+    'events_merged'?: number;
+    'merged_user_key'?: string;
+    'profiles_affected'?: number;
+    'success'?: boolean;
+}
+export interface ModelsPersonalizationContext {
+    'avg_order_value'?: number;
+    'commerce_score'?: number;
+    /**
+     * Scores
+     */
+    'engagement_score'?: number;
+    'frequency_score'?: number;
+    'is_authenticated'?: boolean;
+    'is_new_user'?: boolean;
+    /**
+     * Behavioral insights
+     */
+    'preferred_device_type'?: string;
+    'preferred_time_of_day'?: string;
+    'recency_score'?: number;
+    'recent_clicked_items'?: Array<string>;
+    'recent_purchased_items'?: Array<string>;
+    /**
+     * Recent activity
+     */
+    'recent_search_terms'?: Array<string>;
+    'recent_viewed_items'?: Array<string>;
+    /**
+     * Segments
+     */
+    'segments'?: Array<string>;
+    'top_brands'?: Array<ModelsAffinityScore>;
+    /**
+     * Affinities (top N)
+     */
+    'top_categories'?: Array<ModelsAffinityScore>;
+    'user_key'?: string;
+}
+export interface ModelsSimilarUser {
+    'common_brands'?: Array<string>;
+    'common_categories'?: Array<string>;
+    'similarity_score'?: number;
+    'user_key'?: string;
+}
+export interface ModelsUpdateCustomEventFieldRequest {
+    'allowed_values'?: Array<string>;
+    'default_value'?: string;
+    'description'?: string;
+    'display_name'?: string;
+    'field_name'?: string;
+    'is_indexed'?: boolean;
+    'is_required'?: boolean;
+    'max_length'?: number;
+    'max_value'?: number;
+    'min_value'?: number;
+    'validation_regex'?: string;
+}
+export interface ModelsUpdateCustomEventTypeRequest {
+    'description'?: string;
+    'display_name'?: string;
+    'event_category'?: string;
+    'is_active'?: boolean;
+    'max_daily_events'?: number;
+}
+export interface ModelsUserEvent {
+    'country'?: string;
+    'device_type'?: string;
+    'event_id'?: string;
+    'event_subtype'?: string;
+    'event_ts'?: string;
+    'event_type'?: string;
+    'is_attributed'?: boolean;
+    'item_id'?: string;
+    'position'?: number;
+    'query'?: string;
+    'recommendation_id'?: string;
+    'search_id'?: string;
+    'session_id'?: string;
+    'surface'?: string;
+    'value'?: number;
+}
+export interface ModelsUserEventsResponse {
+    'events'?: Array<ModelsUserEvent>;
+    'page'?: number;
+    'page_size'?: number;
+    'total'?: number;
+    'total_pages'?: number;
+}
+export interface ModelsUserProfile {
+    'anonymous_id'?: string;
+    'authenticated_user_id'?: string;
+    'avg_clicks_per_search'?: number;
+    'avg_order_value'?: number;
+    'avg_searches_per_session'?: number;
+    /**
+     * Behavioral signals
+     */
+    'avg_session_duration_ms'?: number;
+    'brand_affinities'?: {
+        [key: string]: number;
+    };
+    /**
+     * Affinity scores (for personalization)
+     */
+    'category_affinities'?: {
+        [key: string]: number;
+    };
+    'commerce_score'?: number;
+    'conversion_rate'?: number;
+    /**
+     * Device info
+     */
+    'device_fingerprints'?: Array<string>;
+    /**
+     * Computed traits (0-100 scores)
+     */
+    'engagement_score'?: number;
+    /**
+     * Timestamps
+     */
+    'first_seen_at'?: string;
+    'frequency_score'?: number;
+    'last_seen_at'?: string;
+    'last_updated_at'?: string;
+    'orgcode'?: string;
+    'primary_browser'?: string;
+    'primary_city'?: string;
+    /**
+     * Geo
+     */
+    'primary_country'?: string;
+    'primary_device_type'?: string;
+    'primary_platform'?: string;
+    'recency_score'?: number;
+    /**
+     * Recent activity
+     */
+    'recent_searches'?: Array<string>;
+    'recently_clicked_items'?: Array<string>;
+    'recently_purchased_items'?: Array<string>;
+    'recently_viewed_items'?: Array<string>;
+    'total_clicks'?: number;
+    'total_conversions'?: number;
+    'total_revenue'?: number;
+    'total_searches'?: number;
+    /**
+     * Aggregated stats
+     */
+    'total_sessions'?: number;
+    'user_id'?: string;
+    /**
+     * Identity
+     */
+    'user_key'?: string;
+    'xstoreid'?: string;
+}
+export interface ModelsValidatePayloadRequest {
+    'payload': {
+        [key: string]: any;
+    };
+}
 export interface PaymentGatewayCreditProrationResult {
     'change_type'?: string;
     'credits_remaining'?: number;
@@ -9504,12 +10682,59 @@ export interface SeekoraGoSrcAnalyticsPaginationMeta {
     'total_items'?: number;
     'total_pages'?: number;
 }
+export interface SeekoraGoSrcAnalyticsTimePoint {
+    'avg_processing_time_ms'?: number;
+    'avg_suggestions_per_request'?: number;
+    'requests'?: number;
+    'time'?: string;
+    'total_suggestions_returned'?: number;
+}
+export interface SeekoraGoSrcAnalyticsTimeSeriesPoint {
+    'percentage'?: number;
+    'timestamp'?: string;
+    'value'?: number;
+}
+export interface SeekoraGoSrcRoutesAnalyticsFunnelStep {
+    'conversion_rate'?: number;
+    'count'?: number;
+    'dropoff_rate'?: number;
+    'name'?: string;
+    'unique_users'?: number;
+}
 export interface SeekoraGoSrcRoutesAnalyticsPaginationMeta {
     'page'?: number;
     'per_page'?: number;
     'total_count'?: number;
     'total_pages'?: number;
 }
+export interface SeekoraGoSrcRoutesAnalyticsTimePoint {
+    'clicks'?: number;
+    'conversion_rate'?: number;
+    'conversions'?: number;
+    'ctr'?: number;
+    'impressions'?: number;
+    'requests'?: number;
+    'revenue'?: number;
+    'timestamp'?: string;
+}
+export interface SeekoraGoSrcServicesAnalyticsFunnelStep {
+    'conditions'?: Array<AnalyticsCondition>;
+    'event_name'?: string;
+    /**
+     * search, click, conversion, view, recommendation, custom
+     */
+    'event_type'?: string;
+    'step_order'?: number;
+    /**
+     * time allowed to reach next step (0 = use funnel default)
+     */
+    'window_hours'?: number;
+}
+export interface SeekoraGoSrcServicesAnalyticsTimeSeriesPoint {
+    'count'?: number;
+    'timestamp'?: string;
+    'value'?: number;
+}
 export interface StoreRouteAPIUsageDetailResponse {
     'data'?: StoreRouteAPIUsageLogEntry;
     'message'?: string;