@omni-commerce/sdk 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -191,7 +191,49 @@ declare class JobFailedError extends OmniError {
  */
 
 interface paths {
-  "/api": {
+  "/api/v1/agents/general/invoke": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Invoke the Omni agent
+     * @description Run the general Omni agent and wait until it completes, pauses for approval, or fails. Requires `agents:invoke`.
+     *
+     *     A waiting call can take several minutes; raise the client timeout. Send `decisions` with the same `thread_id` to approve or reject a paused run. Omit `config.enabled_tools` to use the organization's agent tools. Attach images on the latest user message as `{ type: "image", url }` HTTP(S) URLs.
+     */
+    post: operations["post_v1_agents_general_invoke"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/agents/general/runs": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Start an Omni agent run
+     * @description Queue the general Omni agent and return immediately with the run in `queued` state. Poll the URL in the `Location` header (`GET /api/v1/agents/general/runs/{runId}`), honoring `Retry-After`. Requires `agents:invoke`. The request body matches invoke.
+     */
+    post: operations["post_v1_agents_general_runs"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/agents/general/runs/{runId}": {
     parameters: {
       query?: never;
       header?: never;
@@ -199,10 +241,10 @@ interface paths {
       cookie?: never;
     };
     /**
-     * API Root
-     * @description Public API discovery root. Merchant payments are handled by organization-scoped checkout session endpoints.
+     * Get an Omni agent run
+     * @description Read a queued, running, completed, paused, or failed Omni agent run. Requires `agents:invoke`.
      */
-    get: operations["get_root"];
+    get: operations["get_v1_agents_general_runs_by_runid"];
     put?: never;
     post?: never;
     delete?: never;
@@ -211,7 +253,7 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  "/api/v1": {
+  "/api/v1/analytics/ads": {
     parameters: {
       query?: never;
       header?: never;
@@ -219,10 +261,12 @@ interface paths {
       cookie?: never;
     };
     /**
-     * API v1 Root
-     * @description Public API v1 discovery root. Merchant payments are handled by organization-scoped checkout session endpoints.
+     * Get Ads Analytics
+     * @description Ad spend, attributed sales, ROAS, and ACOS over the last 28 days, and per-product sales and ad metrics for today, yesterday, 7-day and 28-day averages, and the same day one and four weeks ago. Matches the Ads page. Requires `analytics:read`.
+     *
+     *     Amounts are in `data.filters.currency`. The periods count back from the end of the range.
      */
-    get: operations["get_v1"];
+    get: operations["get_v1_analytics_ads"];
     put?: never;
     post?: never;
     delete?: never;
@@ -231,49 +275,117 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  "/api/v1/agents/general/invoke": {
+  "/api/v1/analytics/ai-traffic": {
     parameters: {
       query?: never;
       header?: never;
       path?: never;
       cookie?: never;
     };
-    get?: never;
+    /**
+     * Get AI Traffic Analytics
+     * @description Visits and crawls from AI assistants and search engines: totals, a daily trend, breakdowns by source, route, country, and product, and recent events. Matches the AI Traffic page. Requires `analytics:read`.
+     *
+     *     A range covers at most 365 days; a longer one is shortened to the last 365 days. Read the applied range from `data.filters`.
+     */
+    get: operations["get_v1_analytics_ai_traffic"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/analytics/content": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get Video and LIVE Analytics
+     * @description Views, product clicks, orders, and GMV from shoppable videos and LIVE streams, by day, by content type, and per video. Matches the Video / LIVE page. Requires `analytics:read`.
+     *
+     *     Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     */
+    get: operations["get_v1_analytics_content"];
     put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/analytics/orders": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
     /**
-     * Invoke the Omni agent
-     * @description Run the general Omni agent and wait until it completes, pauses for approval, or fails. Requires `agents:invoke`.
+     * Get Order Analytics
+     * @description Order KPIs with their change against the previous period, a daily trend, sales by order status and by marketplace, and the top products by net sales. Repeat buyers are counted but not listed. Matches the Orders analysis page. Requires `analytics:read`.
      *
-     *     A waiting call can take several minutes; raise the client timeout. Send `decisions` with the same `thread_id` to approve or reject a paused run. Omit `config.enabled_tools` to use the organization's agent tools. Attach images on the latest user message as `{ type: "image", url }` HTTP(S) URLs.
+     *     Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
      */
-    post: operations["post_v1_agents_general_invoke"];
+    get: operations["get_v1_analytics_orders"];
+    put?: never;
+    post?: never;
     delete?: never;
     options?: never;
     head?: never;
     patch?: never;
     trace?: never;
   };
-  "/api/v1/agents/general/runs": {
+  "/api/v1/analytics/overview": {
     parameters: {
       query?: never;
       header?: never;
       path?: never;
       cookie?: never;
     };
-    get?: never;
+    /**
+     * Get Growth Overview
+     * @description Sales, traffic, and profit KPIs with their change against the previous period, a daily trend, the traffic funnel, sales by channel, top and lagging products, and ranked next actions. Matches the Growth Intelligence overview page. Requires `analytics:read`.
+     *
+     *     Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     */
+    get: operations["get_v1_analytics_overview"];
     put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/analytics/pricing": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
     /**
-     * Start an Omni agent run
-     * @description Queue the general Omni agent and return immediately with the run in `queued` state. Poll the URL in the `Location` header (`GET /api/v1/agents/general/runs/{runId}`), honoring `Retry-After`. Requires `agents:invoke`. The request body matches invoke.
+     * Get Pricing Analytics
+     * @description Selling products with their margin, velocity, stock cover, prices, competitor median, and a pricing recommendation. Matches the Pricing page. Requires `analytics:read`.
+     *
+     *     Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
      */
-    post: operations["post_v1_agents_general_runs"];
+    get: operations["get_v1_analytics_pricing"];
+    put?: never;
+    post?: never;
     delete?: never;
     options?: never;
     head?: never;
     patch?: never;
     trace?: never;
   };
-  "/api/v1/agents/general/runs/{runId}": {
+  "/api/v1/analytics/products": {
     parameters: {
       query?: never;
       header?: never;
@@ -281,10 +393,78 @@ interface paths {
       cookie?: never;
     };
     /**
-     * Get an Omni agent run
-     * @description Read a queued, running, completed, paused, or failed Omni agent run. Requires `agents:invoke`.
+     * Get Product Analytics
+     * @description Per-product sales, traffic, price, stock, profit, and ad performance, ranked by net sales, with ranked insights. Pass `productId` for specific products, for example on a product page. Matches the Products page. Requires `analytics:read`.
+     *
+     *     Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
      */
-    get: operations["get_v1_agents_general_runs_by_runid"];
+    get: operations["get_v1_analytics_products"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/analytics/profit": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get Profit Analytics
+     * @description Revenue, costs, fees, and profit with a waterfall, cost breakdowns, a daily trend, the most and least profitable products, and products missing a cost price. Session members also need finance access. Matches the P&L Analysis page. Requires `analytics:read`.
+     *
+     *     Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     */
+    get: operations["get_v1_analytics_profit"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/analytics/reports": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get Business Report
+     * @description The management summary: headline KPIs, top products, sales by marketplace, alerts, settlement totals, and data quality. Matches the Business Reports page. Requires `analytics:read`.
+     *
+     *     Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     */
+    get: operations["get_v1_analytics_reports"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/analytics/stores": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get Store Analytics
+     * @description Seller Centre shop metrics: visitors, page views, followers, the placed, paid, and confirmed buyer funnel, a daily trend, and the app and web split. Matches the Analytics (Seller Centre) page. Requires `analytics:read`.
+     *
+     *     Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     */
+    get: operations["get_v1_analytics_stores"];
     put?: never;
     post?: never;
     delete?: never;
@@ -293,7 +473,7 @@ interface paths {
     patch?: never;
     trace?: never;
   };
-  "/api/v1/analytics/sales": {
+  "/api/v1/analytics/traffic": {
     parameters: {
       query?: never;
       header?: never;
@@ -301,12 +481,12 @@ interface paths {
       cookie?: never;
     };
     /**
-     * Get Sales Analytics
-     * @description Sales KPIs for a date range with the change against the previous period of equal length, a daily trend, sales by order status and by marketplace, and the top products by net sales. Matches the Orders analysis page. Requires `analytics:read`.
+     * Get Traffic Analytics
+     * @description Impressions, page views, visitors, add-to-cart, and conversion, with the funnel, a daily trend, products ranked by lost conversion, diagnostics, and the videos that drive traffic. Matches the Traffic page. Requires `analytics:read`.
      *
      *     Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
      */
-    get: operations["get_v1_analytics_sales"];
+    get: operations["get_v1_analytics_traffic"];
     put?: never;
     post?: never;
     delete?: never;
@@ -3565,68 +3745,6 @@ interface components {
   pathItems: never;
 }
 interface operations {
-  get_root: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      /** @description API root metadata. */
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": {
-            ok: boolean;
-            resource: string;
-            service: string;
-          };
-        };
-      };
-      /** @description Too many requests. */
-      429: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-    };
-  };
-  get_v1: {
-    parameters: {
-      query?: never;
-      header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      /** @description API v1 root metadata. */
-      200: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": {
-            ok: boolean;
-            resource: string;
-            service: string;
-          };
-        };
-      };
-      /** @description Too many requests. */
-      429: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-    };
-  };
   post_v1_agents_general_invoke: {
     parameters: {
       query?: never;
@@ -3896,7 +4014,1729 @@ interface operations {
           };
         };
       };
-      /** @description Invalid agent request, unknown tool or model, or a decision count that does not match the pending approvals */
+      /** @description Invalid agent request, unknown tool or model, or a decision count that does not match the pending approvals */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Insufficient AI credits */
+      402: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Missing agents:invoke scope or Assistant access */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description The thread already has an active run, or decisions were sent for a thread with no run awaiting approval */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description The agent run failed. `data.run_id` identifies the stored run */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_agents_general_runs_by_runid: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. Optional for API keys, which already belong to one organization. */
+        organizationId?: string;
+      };
+      header?: never;
+      path: {
+        runId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The agent run. */
+      200: {
+        headers: {
+          /** @description Seconds to wait before polling again. Sent while the run is queued or running. */
+          "Retry-After"?: number;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            run_id: string;
+            thread_id: string;
+            /** @enum {string} */
+            status:
+              | "queued"
+              | "running"
+              | "completed"
+              | "awaiting_approval"
+              | "failed";
+            messages: {
+              /** @enum {string} */
+              type: "human" | "ai" | "tool" | "system";
+              /** @enum {string} */
+              role: "user" | "assistant" | "tool" | "system";
+              content: string;
+              id?: string;
+              name?: string;
+              tool_calls?: {
+                id?: string;
+                name: string;
+                args: unknown;
+              }[];
+              tool_call_id?: string;
+            }[];
+            structured_output: {
+              [key: string]: unknown;
+            } | null;
+            approvals:
+              | {
+                  interrupt_instance_id: string;
+                  tool_name: string | null;
+                  tool_args: unknown;
+                  message: string;
+                }[]
+              | null;
+            error: string | null;
+          };
+        };
+      };
+      /** @description Invalid agent request, unknown tool or model, or a decision count that does not match the pending approvals */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Missing agents:invoke scope or Assistant access */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Agent run not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_analytics_ads: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+        /** @description First day of the range (YYYY-MM-DD). Defaults to 29 days before `to`. */
+        from?: string;
+        /** @description Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. */
+        to?: string;
+        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
+        /** @description Comma-separated marketplaces, for example `shopee,lazada`. */
+        marketplace?: string;
+        /** @description Comma-separated countries. One country selects its currency. */
+        country?: string;
+        /** @description Comma-separated store (account) ids from `GET /api/v1/marketplaces/connected`. */
+        store?: string;
+        /** @description ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD. */
+        currency?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Get Ads Analytics */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok: boolean;
+            /** @constant */
+            apiVersion: "developer_v1";
+            operationId: string;
+            /** @enum {string} */
+            status: "accepted" | "completed" | "failed";
+            jobId?: string;
+            productId?: string;
+            warnings: string[];
+            recommendations: string[];
+            links: {
+              [key: string]: string;
+            };
+            data: {
+              filters: {
+                from: string;
+                to: string;
+                marketplace: string;
+                country: string;
+                store: string;
+                /** @description Currency of every amount in the response. */
+                currency: string;
+                timeZone: string;
+              };
+              /** @description The last day the periods count back from. */
+              anchorDate: string;
+              /** @description The 28 days the KPI totals cover. */
+              kpiDateRange: {
+                from: string;
+                to: string;
+              };
+              kpis: {
+                spend: number;
+                attributedGmv: number;
+                attributedOrders: number;
+                impressions: number;
+                clicks: number;
+                roas: number | null;
+                acos: number | null;
+                productCount: number;
+                productsWithAds: number;
+              };
+              coverage: {
+                ads: boolean;
+                productLevelAds: boolean;
+                /** @description Only ad fee lines are known, not per-product ad data. */
+                feeLineOnly: boolean;
+              };
+              message: string | null;
+              products: {
+                productId: string | null;
+                productName: string;
+                thumbnailUrl: string | null;
+                platform: string | null;
+                accountId: string | null;
+                sku: string | null;
+                externalProductId: string | null;
+                last28Totals: {
+                  revenue: number | null;
+                  orders: number | null;
+                  qtySold: number | null;
+                  avgUnitPrice: number | null;
+                  adSpend: number | null;
+                  adRevenue: number | null;
+                  adOrders: number | null;
+                  adQtySold: number | null;
+                  adRoas: number | null;
+                  hasSales: boolean;
+                  hasAds: boolean;
+                };
+                periods: {
+                  /** @enum {string} */
+                  period:
+                    | "today"
+                    | "yesterday"
+                    | "avg_7"
+                    | "d7"
+                    | "avg_28"
+                    | "d28";
+                  label: string;
+                  isAverage: boolean;
+                  revenue: number | null;
+                  orders: number | null;
+                  qtySold: number | null;
+                  avgUnitPrice: number | null;
+                  adSpend: number | null;
+                  adRevenue: number | null;
+                  adOrders: number | null;
+                  adQtySold: number | null;
+                  adRoas: number | null;
+                  hasSales: boolean;
+                  hasAds: boolean;
+                }[];
+              }[];
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Missing the `analytics:read` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_analytics_ai_traffic: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+        /** @description First day of the range (YYYY-MM-DD). Defaults to 29 days before `to`. */
+        from?: string;
+        /** @description Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. */
+        to?: string;
+        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
+        /** @description One AI source id from `data.filterOptions.sources`. */
+        source?: string;
+        trafficType?: "indexing" | "click_through" | "page_view" | "assistant";
+        /** @description One route key from `data.filterOptions.routes`. */
+        route?: string;
+        /** @description ISO country code of the visit. */
+        country?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Get AI Traffic Analytics */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok: boolean;
+            /** @constant */
+            apiVersion: "developer_v1";
+            operationId: string;
+            /** @enum {string} */
+            status: "accepted" | "completed" | "failed";
+            jobId?: string;
+            productId?: string;
+            warnings: string[];
+            recommendations: string[];
+            links: {
+              [key: string]: string;
+            };
+            data: {
+              filters: {
+                from: string;
+                to: string;
+                source: string;
+                trafficType: string;
+                route: string;
+                country: string;
+                timeZone: string;
+              };
+              filterOptions: {
+                sources: {
+                  value: string;
+                  label: string;
+                }[];
+                routes: {
+                  value: string;
+                  label: string;
+                }[];
+                countries: {
+                  value: string;
+                  label: string;
+                }[];
+              };
+              summary: {
+                totalEvents: number;
+                totalHits: number;
+                pageViews: number;
+                productPageViews: number;
+                productsViewed: number;
+                referredSessions: number;
+                indexingHits: number;
+                assistantHits: number;
+                clickThroughs: number;
+                productsRequested: number;
+                productsWithReferrals: number;
+                attributableHits: number;
+                uniqueSources: number;
+                uniqueRoutes: number;
+                uniqueProducts: number;
+                topSource: string | null;
+                topRoute: string | null;
+                topCountry: string | null;
+                lastSeenAt: string | null;
+              };
+              trend: {
+                date: string;
+                label: string;
+                hits: number;
+                attributableHits: number;
+                uniqueSources: number;
+              }[];
+              sourceBreakdown: {
+                value: string;
+                label: string;
+                count: number;
+              }[];
+              routeBreakdown: {
+                value: string;
+                label: string;
+                count: number;
+              }[];
+              countryBreakdown: {
+                value: string;
+                label: string;
+                count: number;
+              }[];
+              productBreakdown: {
+                productId: string;
+                productName: string;
+                count: number;
+              }[];
+              recentEvents: {
+                id: string;
+                occurredAt: string;
+                sourceLabel: string;
+                trafficType: string;
+                operator: string;
+                routeLabel: string;
+                path: string;
+                countryCode: string | null;
+                referrer: string | null;
+                inferredKeyword: string | null;
+                inferredIntent: {
+                  label: string;
+                  source: string;
+                  confidence: number | null;
+                } | null;
+                productId: string | null;
+                productName: string | null;
+              }[];
+              dataFreshness: {
+                metricsAvailable: boolean;
+                notes: string[];
+              };
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Missing the `analytics:read` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_analytics_content: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+        /** @description First day of the range (YYYY-MM-DD). Defaults to 29 days before `to`. */
+        from?: string;
+        /** @description Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. */
+        to?: string;
+        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
+        /** @description Comma-separated marketplaces, for example `shopee,lazada`. */
+        marketplace?: string;
+        /** @description Comma-separated countries. One country selects its currency. */
+        country?: string;
+        /** @description Comma-separated store (account) ids from `GET /api/v1/marketplaces/connected`. */
+        store?: string;
+        /** @description ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD. */
+        currency?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Get Video and LIVE Analytics */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok: boolean;
+            /** @constant */
+            apiVersion: "developer_v1";
+            operationId: string;
+            /** @enum {string} */
+            status: "accepted" | "completed" | "failed";
+            jobId?: string;
+            productId?: string;
+            warnings: string[];
+            recommendations: string[];
+            links: {
+              [key: string]: string;
+            };
+            data: {
+              filters: {
+                from: string;
+                to: string;
+                marketplace: string;
+                country: string;
+                store: string;
+                /** @description Currency of every amount in the response. */
+                currency: string;
+                timeZone: string;
+              };
+              coverage: {
+                content: boolean;
+              };
+              kpis: {
+                views: number;
+                productClicks: number;
+                orders: number;
+                gmv: number;
+                contentCount: number;
+                clickRate: number | null;
+              };
+              dailyTrend: {
+                date: string;
+                views: number;
+                productClicks: number;
+                orders: number;
+                gmv: number;
+              }[];
+              byType: {
+                contentType: string;
+                views: number;
+                gmv: number;
+                orders: number;
+                clicks: number;
+              }[];
+              items: {
+                externalContentId: string | null;
+                /** @description For example `video` or `live`. */
+                contentType: string;
+                title: string;
+                platform: string | null;
+                accountId: string | null;
+                productId: string | null;
+                externalProductId: string | null;
+                productName: string | null;
+                productThumbnailUrl: string | null;
+                /** @description Public link to the video. */
+                contentUrl: string | null;
+                views: number;
+                productClicks: number;
+                orders: number;
+                gmv: number;
+                clickRate: number | null;
+                orderRate: number | null;
+              }[];
+              message: string | null;
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Missing the `analytics:read` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_analytics_orders: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+        /** @description First day of the range (YYYY-MM-DD). Defaults to 29 days before `to`. */
+        from?: string;
+        /** @description Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. */
+        to?: string;
+        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
+        /** @description Comma-separated marketplaces, for example `shopee,lazada`. */
+        marketplace?: string;
+        /** @description Comma-separated countries. One country selects its currency. */
+        country?: string;
+        /** @description Comma-separated store (account) ids from `GET /api/v1/marketplaces/connected`. */
+        store?: string;
+        /** @description ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD. */
+        currency?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Get Order Analytics */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok: boolean;
+            /** @constant */
+            apiVersion: "developer_v1";
+            operationId: string;
+            /** @enum {string} */
+            status: "accepted" | "completed" | "failed";
+            jobId?: string;
+            productId?: string;
+            warnings: string[];
+            recommendations: string[];
+            links: {
+              [key: string]: string;
+            };
+            data: {
+              filters: {
+                from: string;
+                to: string;
+                marketplace: string;
+                country: string;
+                store: string;
+                /** @description Currency of every amount in the response. */
+                currency: string;
+                timeZone: string;
+              };
+              previousFrom: string;
+              previousTo: string;
+              kpis: {
+                orders: number;
+                netSales: number;
+                /** @description Average order value. */
+                aov: number;
+                unitsSold: number;
+                unitsPerOrder: number;
+                returnedOrders: number;
+                /** @description Share of orders returned, 0 to 1. */
+                returnRate: number;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                ordersChangePercent: number | null;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                netSalesChangePercent: number | null;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                aovChangePercent: number | null;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                unitsChangePercent: number | null;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                returnRateChangePercent: number | null;
+                identifiedBuyers: number;
+                repeatBuyers: number;
+                repeatRate: number | null;
+                cancelledOrders: number;
+                cancelRate: number | null;
+              };
+              statusMix: {
+                status: string;
+                orders: number;
+                netSales: number;
+              }[];
+              platformMix: {
+                platform: string;
+                orders: number;
+                netSales: number;
+              }[];
+              dailyTrend: {
+                date: string;
+                previousDate: string | null;
+                orders: number;
+                netSales: number;
+                previousOrders: number;
+                previousNetSales: number;
+              }[];
+              /** @description Up to 40 products ranked by net sales. */
+              topProducts: {
+                productId: string | null;
+                productName: string;
+                platform: string | null;
+                accountId: string | null;
+                externalProductId: string | null;
+                sku: string | null;
+                thumbnailUrl: string | null;
+                orders: number;
+                unitsSold: number;
+                netSales: number;
+              }[];
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Missing the `analytics:read` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_analytics_overview: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+        /** @description First day of the range (YYYY-MM-DD). Defaults to 29 days before `to`. */
+        from?: string;
+        /** @description Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. */
+        to?: string;
+        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
+        /** @description Comma-separated marketplaces, for example `shopee,lazada`. */
+        marketplace?: string;
+        /** @description Comma-separated countries. One country selects its currency. */
+        country?: string;
+        /** @description Comma-separated store (account) ids from `GET /api/v1/marketplaces/connected`. */
+        store?: string;
+        /** @description ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD. */
+        currency?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Get Growth Overview */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok: boolean;
+            /** @constant */
+            apiVersion: "developer_v1";
+            operationId: string;
+            /** @enum {string} */
+            status: "accepted" | "completed" | "failed";
+            jobId?: string;
+            productId?: string;
+            warnings: string[];
+            recommendations: string[];
+            links: {
+              [key: string]: string;
+            };
+            data: {
+              filters: {
+                from: string;
+                to: string;
+                marketplace: string;
+                country: string;
+                store: string;
+                /** @description Currency of every amount in the response. */
+                currency: string;
+                timeZone: string;
+              };
+              previousFrom: string;
+              previousTo: string;
+              /** @description `all`, or the single marketplace reported. With one marketplace, `channelMix` is split by store. */
+              marketplaceScope: string;
+              kpis: {
+                grossSales: number;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                grossSalesChangePercent: number | null;
+                netSales: number;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                netSalesChangePercent: number | null;
+                orders: number;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                ordersChangePercent: number | null;
+                unitsSold: number;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                unitsChangePercent: number | null;
+                aov: number | null;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                aovChangePercent: number | null;
+                unitsPerOrder: number | null;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                unitsPerOrderChangePercent: number | null;
+                visitors: number | null;
+                pageviews: number | null;
+                /** @description Visitors who added to cart. */
+                atcUsers: number | null;
+                viewToOrderCvr: number | null;
+                contributionProfit: number | null;
+                adsSpend: number | null;
+              };
+              dailyTrend: {
+                date: string;
+                grossSales: number;
+                netSales: number;
+                orders: number;
+                unitsSold: number;
+                aov: number | null;
+                unitsPerOrder: number | null;
+                visitors: number | null;
+                pageviews: number | null;
+              }[];
+              funnel: {
+                id: string;
+                label: string;
+                value: number | null;
+                covered: boolean;
+              }[];
+              channelMix: {
+                platform: string;
+                accountId: string | null;
+                label: string;
+                netSales: number;
+                orders: number;
+                unitsSold: number;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                changePercent: number | null;
+              }[];
+              topProducts: {
+                productId: string | null;
+                variantId: string | null;
+                sku: string | null;
+                productName: string;
+                thumbnailUrl: string | null;
+                platform: string | null;
+                accountId: string | null;
+                externalProductId: string | null;
+                netSales: number;
+                orders: number;
+                unitsSold: number;
+                /** @description Share of net sales, 0 to 1. */
+                revenueShare: number;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                gmvChangePercent: number | null;
+              }[];
+              laggingProducts: {
+                productId: string | null;
+                variantId: string | null;
+                sku: string | null;
+                productName: string;
+                thumbnailUrl: string | null;
+                platform: string | null;
+                accountId: string | null;
+                externalProductId: string | null;
+                netSales: number;
+                orders: number;
+                unitsSold: number;
+                /** @description Share of net sales, 0 to 1. */
+                revenueShare: number;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                gmvChangePercent: number | null;
+              }[];
+              /** @description Ranked next actions. */
+              insights: {
+                id: string;
+                code: string;
+                /** @enum {string} */
+                severity: "info" | "warn" | "critical" | "opportunity";
+                /** @enum {string} */
+                category:
+                  | "conversion"
+                  | "profit"
+                  | "inventory"
+                  | "ads"
+                  | "growth"
+                  | "data"
+                  | "market"
+                  | "pricing";
+                title: string;
+                summary: string;
+                impactLabel: string;
+                /** @description 0 to 100, higher first. */
+                impactScore: number;
+                productId: string | null;
+                productName: string | null;
+              }[];
+              /** @description Which data sources have data for this range. */
+              coverage: {
+                sales: boolean;
+                traffic: boolean;
+                ads: boolean;
+                content: boolean;
+                inventory: boolean;
+                profit: boolean;
+                market: boolean;
+              };
+              syncFreshness: {
+                jobType: string;
+                platform: string | null;
+                accountId: string | null;
+                status: string;
+                completedAt: string | null;
+                rowsUpserted: number;
+              }[];
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Missing the `analytics:read` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_analytics_pricing: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+        /** @description First day of the range (YYYY-MM-DD). Defaults to 29 days before `to`. */
+        from?: string;
+        /** @description Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. */
+        to?: string;
+        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
+        /** @description Comma-separated marketplaces, for example `shopee,lazada`. */
+        marketplace?: string;
+        /** @description Comma-separated countries. One country selects its currency. */
+        country?: string;
+        /** @description Comma-separated store (account) ids from `GET /api/v1/marketplaces/connected`. */
+        store?: string;
+        /** @description ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD. */
+        currency?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Get Pricing Analytics */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok: boolean;
+            /** @constant */
+            apiVersion: "developer_v1";
+            operationId: string;
+            /** @enum {string} */
+            status: "accepted" | "completed" | "failed";
+            jobId?: string;
+            productId?: string;
+            warnings: string[];
+            recommendations: string[];
+            links: {
+              [key: string]: string;
+            };
+            data: {
+              filters: {
+                from: string;
+                to: string;
+                marketplace: string;
+                country: string;
+                store: string;
+                /** @description Currency of every amount in the response. */
+                currency: string;
+                timeZone: string;
+              };
+              /** @description Selling products from the top 30 by net sales. */
+              products: {
+                productId: string | null;
+                productName: string;
+                sku: string | null;
+                netSales: number;
+                unitsSold: number;
+                velocity: number;
+                contributionMargin: number | null;
+                daysOfCover: number | null;
+                catalogCurrency: string | null;
+                listPrice: number | null;
+                salePrice: number | null;
+                discountPct: number | null;
+                peerPriceP50: number | null;
+                recommendation: string;
+              }[];
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Missing the `analytics:read` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_analytics_products: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+        /** @description First day of the range (YYYY-MM-DD). Defaults to 29 days before `to`. */
+        from?: string;
+        /** @description Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. */
+        to?: string;
+        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
+        /** @description Comma-separated marketplaces, for example `shopee,lazada`. */
+        marketplace?: string;
+        /** @description Comma-separated countries. One country selects its currency. */
+        country?: string;
+        /** @description Comma-separated store (account) ids from `GET /api/v1/marketplaces/connected`. */
+        store?: string;
+        /** @description ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD. */
+        currency?: string;
+        /** @description Search product name or SKU. */
+        q?: string;
+        /** @description Comma-separated product or variant UUIDs, up to 50, to report only those products. */
+        productId?: string;
+        /** @description Products to return, ranked by net sales. */
+        limit?: number;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Get Product Analytics */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok: boolean;
+            /** @constant */
+            apiVersion: "developer_v1";
+            operationId: string;
+            /** @enum {string} */
+            status: "accepted" | "completed" | "failed";
+            jobId?: string;
+            productId?: string;
+            warnings: string[];
+            recommendations: string[];
+            links: {
+              [key: string]: string;
+            };
+            data: {
+              filters: {
+                from: string;
+                to: string;
+                marketplace: string;
+                country: string;
+                store: string;
+                /** @description Currency of every amount in the response. */
+                currency: string;
+                timeZone: string;
+                q: string;
+              };
+              products: {
+                productId: string | null;
+                variantId: string | null;
+                sku: string | null;
+                productName: string;
+                thumbnailUrl: string | null;
+                platform: string | null;
+                accountId: string | null;
+                externalProductId: string | null;
+                gmv: number;
+                netSales: number;
+                orders: number;
+                unitsSold: number;
+                revenueShare: number;
+                /** @description Units sold per day. */
+                velocity: number;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                gmvChangePercent: number | null;
+                impressions: number | null;
+                pageviews: number | null;
+                visitors: number | null;
+                clicks: number | null;
+                atcUsers: number | null;
+                atcUnits: number | null;
+                viewToOrderCvr: number | null;
+                visitorValue: number | null;
+                listingStatus: string | null;
+                channelsLive: number;
+                /** @description Currency of listPrice and salePrice, which can differ from the report currency. */
+                catalogCurrency: string | null;
+                marketPrices: {
+                  marketplace: string;
+                  storeId: string | null;
+                  storeName: string | null;
+                  productId: string | null;
+                  sellerSku: string | null;
+                  variation: string | null;
+                  country: string | null;
+                  currency: string;
+                  price: number | null;
+                  salePrice: number | null;
+                  saleStartDate: string | null;
+                  saleEndDate: string | null;
+                  status: string | null;
+                }[];
+                listPrice: number | null;
+                salePrice: number | null;
+                discountPct: number | null;
+                /** @description Units per day during promotions against outside them, as a ratio change. */
+                promoLift: number | null;
+                completenessScore: number | null;
+                lastPublishedAt: string | null;
+                available: number | null;
+                daysOfCover: number | null;
+                stockoutRisk: string | null;
+                cogs: number | null;
+                /** @description Share of sold units with a cost price, 0 to 1. */
+                cogsCoverage: number | null;
+                platformFees: number | null;
+                adsFees: number | null;
+                contributionProfit: number | null;
+                contributionMargin: number | null;
+                returnRate: number | null;
+                refundAmount: number | null;
+                adsSpend: number | null;
+                adsRoas: number | null;
+                adsAcos: number | null;
+                contentGmv: number | null;
+                /** @description Median competitor price. */
+                peerPriceP50: number | null;
+                searchRank: number | null;
+                alerts: {
+                  code: string;
+                  /** @enum {string} */
+                  severity: "info" | "warn" | "critical";
+                  message: string;
+                }[];
+              }[];
+              insights: {
+                id: string;
+                code: string;
+                /** @enum {string} */
+                severity: "info" | "warn" | "critical" | "opportunity";
+                /** @enum {string} */
+                category:
+                  | "conversion"
+                  | "profit"
+                  | "inventory"
+                  | "ads"
+                  | "growth"
+                  | "data"
+                  | "market"
+                  | "pricing";
+                title: string;
+                summary: string;
+                impactLabel: string;
+                /** @description 0 to 100, higher first. */
+                impactScore: number;
+                productId: string | null;
+                productName: string | null;
+              }[];
+              /** @description Which data sources have data for this range. */
+              coverage: {
+                sales: boolean;
+                traffic: boolean;
+                ads: boolean;
+                content: boolean;
+                inventory: boolean;
+                profit: boolean;
+                market: boolean;
+              };
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Missing the `analytics:read` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_analytics_profit: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+        /** @description First day of the range (YYYY-MM-DD). Defaults to 29 days before `to`. */
+        from?: string;
+        /** @description Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. */
+        to?: string;
+        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
+        /** @description Comma-separated marketplaces, for example `shopee,lazada`. */
+        marketplace?: string;
+        /** @description Comma-separated countries. One country selects its currency. */
+        country?: string;
+        /** @description Comma-separated store (account) ids from `GET /api/v1/marketplaces/connected`. */
+        store?: string;
+        /** @description ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD. */
+        currency?: string;
+        /** @description Comma-separated SKUs to report only those products. */
+        sku?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Get Profit Analytics */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok: boolean;
+            /** @constant */
+            apiVersion: "developer_v1";
+            operationId: string;
+            /** @enum {string} */
+            status: "accepted" | "completed" | "failed";
+            jobId?: string;
+            productId?: string;
+            warnings: string[];
+            recommendations: string[];
+            links: {
+              [key: string]: string;
+            };
+            data: {
+              filters: {
+                from: string;
+                to: string;
+                marketplace: string;
+                country: string;
+                store: string;
+                /** @description Currency of every amount in the response. */
+                currency: string;
+                timeZone: string;
+                sku: string;
+              };
+              /**
+               * @description `profit` when cost prices cover sales, otherwise `earnings` (revenue after fees).
+               * @enum {string}
+               */
+              reportingBasis: "earnings" | "profit";
+              currentRange: {
+                from: string;
+                to: string;
+              };
+              previousRange: {
+                from: string;
+                to: string;
+              };
+              metricCards: {
+                /** @enum {string} */
+                id:
+                  | "net_revenue"
+                  | "total_costs"
+                  | "net_profit"
+                  | "net_margin"
+                  | "marketplace_costs"
+                  | "earnings_after_fees"
+                  | "earnings_rate";
+                label: string;
+                value: number | null;
+                /** @enum {string} */
+                unit: "currency" | "percent";
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                changePercent: number | null;
+              }[];
+              dailyTrend: {
+                date: string;
+                netRevenue: number;
+                netProfit: number | null;
+                earningsAfterFees: number;
+              }[];
+              waterfall: {
+                /** @enum {string} */
+                id:
+                  | "gross_sales"
+                  | "discounts"
+                  | "returns"
+                  | "platform_fees"
+                  | "cogs"
+                  | "fulfillment"
+                  | "operating"
+                  | "net_profit"
+                  | "earnings_after_fees";
+                label: string;
+                amount: number | null;
+                /** @enum {string} */
+                kind: "positive" | "negative" | "result";
+              }[];
+              breakdownSections: {
+                /** @enum {string} */
+                id:
+                  | "revenue"
+                  | "platform_fees"
+                  | "cogs"
+                  | "fulfillment"
+                  | "operating";
+                title: string;
+                total: number;
+                rows: {
+                  id: string;
+                  label: string;
+                  amount: number;
+                  /** @enum {string} */
+                  unit: "currency" | "percent";
+                }[];
+              }[];
+              insights: {
+                id: string;
+                title: string;
+                description: string;
+                /** @enum {string} */
+                tone: "positive" | "warning" | "neutral";
+              }[];
+              profitabilitySnapshot: {
+                marketplaceCosts: number;
+                earningsAfterFees: number;
+                earningsRate: number;
+                totalKnownCosts: number;
+                ordersInRange: number;
+                costRatio: number;
+                shippingRatio: number;
+                uncostedUnits: number;
+              };
+              /** @description Sold products without a cost price. */
+              missingCostProducts: {
+                productId: string;
+                variantId: string | null;
+                name: string;
+                variantName: string | null;
+                thumbnailUrl: string | null;
+                sku: string | null;
+                soldUnits: number;
+                marketplaces: string[];
+                countries: string[];
+              }[];
+              topProducts: {
+                productId: string;
+                variantId: string | null;
+                name: string;
+                variantName: string | null;
+                thumbnailUrl: string | null;
+                sku: string | null;
+                unitsSold: number;
+                totalRevenue: number;
+                totalCogs: number;
+                /** @description Marketplace and fulfillment fees allocated to the product. */
+                totalFees: number;
+                earningsAfterFees: number;
+                earningsRate: number;
+                /** @description Null until every sold unit has a cost price. */
+                totalProfit: number | null;
+                profitMargin: number | null;
+                /** @description Profit counting only units with a cost price. */
+                knownCostProfit: number;
+                knownCostMargin: number;
+                /** @description Share of sold units with a cost price, 0 to 1. */
+                costCoverage: number;
+                marketplaces: string[];
+              }[];
+              underperformingProducts: {
+                productId: string;
+                variantId: string | null;
+                name: string;
+                variantName: string | null;
+                thumbnailUrl: string | null;
+                sku: string | null;
+                unitsSold: number;
+                totalRevenue: number;
+                totalCogs: number;
+                /** @description Marketplace and fulfillment fees allocated to the product. */
+                totalFees: number;
+                earningsAfterFees: number;
+                earningsRate: number;
+                /** @description Null until every sold unit has a cost price. */
+                totalProfit: number | null;
+                profitMargin: number | null;
+                /** @description Profit counting only units with a cost price. */
+                knownCostProfit: number;
+                knownCostMargin: number;
+                /** @description Share of sold units with a cost price, 0 to 1. */
+                costCoverage: number;
+                marketplaces: string[];
+              }[];
+              /** @description Sales against the historical retail price, when price books record one. */
+              retailUplift: {
+                currency: string;
+                soldUnits: number;
+                coveredUnits: number;
+                missingBaselineUnits: number;
+                priceBookRecordedUnits: number;
+                retailValue: number | null;
+                salesValue: number | null;
+                upliftAmount: number | null;
+                markupRate: number | null;
+              } | null;
+              notes: string[];
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Missing the `analytics:read` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_analytics_reports: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+        /** @description First day of the range (YYYY-MM-DD). Defaults to 29 days before `to`. */
+        from?: string;
+        /** @description Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. */
+        to?: string;
+        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
+        /** @description Comma-separated marketplaces, for example `shopee,lazada`. */
+        marketplace?: string;
+        /** @description Comma-separated countries. One country selects its currency. */
+        country?: string;
+        /** @description Comma-separated store (account) ids from `GET /api/v1/marketplaces/connected`. */
+        store?: string;
+        /** @description ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD. */
+        currency?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Get Business Report */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok: boolean;
+            /** @constant */
+            apiVersion: "developer_v1";
+            operationId: string;
+            /** @enum {string} */
+            status: "accepted" | "completed" | "failed";
+            jobId?: string;
+            productId?: string;
+            warnings: string[];
+            recommendations: string[];
+            links: {
+              [key: string]: string;
+            };
+            data: {
+              filters: {
+                from: string;
+                to: string;
+                marketplace: string;
+                country: string;
+                store: string;
+                /** @description Currency of every amount in the response. */
+                currency: string;
+                timeZone: string;
+              };
+              kpis: {
+                id: string;
+                label: string;
+                value: number | null;
+                previous: number | null;
+                /** @enum {string} */
+                unit: "currency" | "number" | "percent";
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                changePercent: number | null;
+              }[];
+              topProducts: {
+                productId: string | null;
+                variantId: string | null;
+                name: string;
+                variantName: string | null;
+                sku: string | null;
+                thumbnailUrl: string | null;
+                totalRevenue: number;
+              }[];
+              marketplaceBreakdown: {
+                platform: string;
+                country: string | null;
+                revenue: number;
+                orders: number;
+                share: number;
+              }[];
+              alerts: {
+                id: string;
+                title: string;
+                description: string;
+                /** @enum {string} */
+                tone: "warning" | "neutral" | "positive";
+              }[];
+              settlements: {
+                ordersCount: number;
+                withFinanceCount: number;
+                missingFinanceCount: number;
+                grossSales: number;
+                netSettlement: number;
+                platformFees: number;
+                fulfillmentFees: number;
+              };
+              dataQuality: {
+                generatedAt: string;
+                lastOrderUpdatedAt: string | null;
+                lastFinanceEventAt: string | null;
+                financeCoverage: number;
+                costCoverage: number;
+                profitComplete: boolean;
+              };
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
       400: {
         headers: {
           [name: string]: unknown;
@@ -3910,28 +5750,21 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Insufficient AI credits */
-      402: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Missing agents:invoke scope or Assistant access */
+      /** @description Missing the `analytics:read` scope */
       403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description The thread already has an active run, or decisions were sent for a thread with no run awaiting approval */
-      409: {
+      /** @description Rate limit exceeded */
+      429: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description The agent run failed. `data.run_id` identifies the stored run */
+      /** @description Internal Server Error */
       500: {
         headers: {
           [name: string]: unknown;
@@ -3940,69 +5773,118 @@ interface operations {
       };
     };
   };
-  get_v1_agents_general_runs_by_runid: {
+  get_v1_analytics_stores: {
     parameters: {
       query?: {
-        /** @description Required for session auth. Optional for API keys, which already belong to one organization. */
+        /** @description Required for session auth. API keys already belong to one organization. */
         organizationId?: string;
+        /** @description First day of the range (YYYY-MM-DD). Defaults to 29 days before `to`. */
+        from?: string;
+        /** @description Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. */
+        to?: string;
+        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
+        /** @description Comma-separated marketplaces, for example `shopee,lazada`. */
+        marketplace?: string;
+        /** @description Comma-separated countries. One country selects its currency. */
+        country?: string;
+        /** @description Comma-separated store (account) ids from `GET /api/v1/marketplaces/connected`. */
+        store?: string;
+        /** @description ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD. */
+        currency?: string;
       };
       header?: never;
-      path: {
-        runId: string;
-      };
+      path?: never;
       cookie?: never;
     };
     requestBody?: never;
     responses: {
-      /** @description The agent run. */
+      /** @description Get Store Analytics */
       200: {
         headers: {
-          /** @description Seconds to wait before polling again. Sent while the run is queued or running. */
-          "Retry-After"?: number;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            run_id: string;
-            thread_id: string;
+            ok: boolean;
+            /** @constant */
+            apiVersion: "developer_v1";
+            operationId: string;
             /** @enum {string} */
-            status:
-              | "queued"
-              | "running"
-              | "completed"
-              | "awaiting_approval"
-              | "failed";
-            messages: {
-              /** @enum {string} */
-              type: "human" | "ai" | "tool" | "system";
-              /** @enum {string} */
-              role: "user" | "assistant" | "tool" | "system";
-              content: string;
-              id?: string;
-              name?: string;
-              tool_calls?: {
-                id?: string;
-                name: string;
-                args: unknown;
+            status: "accepted" | "completed" | "failed";
+            jobId?: string;
+            productId?: string;
+            warnings: string[];
+            recommendations: string[];
+            links: {
+              [key: string]: string;
+            };
+            data: {
+              filters: {
+                from: string;
+                to: string;
+                marketplace: string;
+                country: string;
+                store: string;
+                /** @description Currency of every amount in the response. */
+                currency: string;
+                timeZone: string;
+              };
+              hasData: boolean;
+              totals: {
+                visitors: number;
+                pageViews: number;
+                newVisitors: number;
+                returningVisitors: number;
+                newFollowers: number;
+                averagePageViews: number | null;
+                averageStaySeconds: number | null;
+                placedBuyers: number;
+                placedUnits: number;
+                placedOrders: number;
+                placedSales: number;
+                paidBuyers: number;
+                paidUnits: number;
+                paidOrders: number;
+                paidSales: number;
+                confirmedBuyers: number;
+                confirmedUnits: number;
+                confirmedOrders: number;
+                confirmedSales: number;
+                bounceRate: number | null;
+                visitorToPlacedRate: number | null;
+                visitorToPaidRate: number | null;
+                visitorToConfirmedRate: number | null;
+                placedToPaidRate: number | null;
+                placedToConfirmedRate: number | null;
+              };
+              trend: {
+                date: string;
+                visitors: number;
+                pageViews: number;
+                paidOrders: number;
+                paidSales: number;
               }[];
-              tool_call_id?: string;
-            }[];
-            structured_output: {
-              [key: string]: unknown;
-            } | null;
-            approvals:
-              | {
-                  interrupt_instance_id: string;
-                  tool_name: string | null;
-                  tool_args: unknown;
-                  message: string;
-                }[]
-              | null;
-            error: string | null;
+              deviceBreakdown: {
+                /** @enum {string} */
+                device: "app" | "pc";
+                visitors: number;
+                pageViews: number;
+                newVisitors: number;
+                returningVisitors: number;
+                bounceRate: number | null;
+              }[];
+              coverage: {
+                platforms: string[];
+                sources: string[];
+                firstDate: string | null;
+                lastDate: string | null;
+              };
+            };
           };
         };
       };
-      /** @description Invalid agent request, unknown tool or model, or a decision count that does not match the pending approvals */
+      /** @description Invalid request */
       400: {
         headers: {
           [name: string]: unknown;
@@ -4016,15 +5898,22 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Missing agents:invoke scope or Assistant access */
+      /** @description Missing the `analytics:read` scope */
       403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Agent run not found */
-      404: {
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
         headers: {
           [name: string]: unknown;
         };
@@ -4032,7 +5921,7 @@ interface operations {
       };
     };
   };
-  get_v1_analytics_sales: {
+  get_v1_analytics_traffic: {
     parameters: {
       query?: {
         /** @description Required for session auth. API keys already belong to one organization. */
@@ -4041,6 +5930,8 @@ interface operations {
         from?: string;
         /** @description Last day of the range, inclusive (YYYY-MM-DD). Defaults to today. */
         to?: string;
+        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
         /** @description Comma-separated marketplaces, for example `shopee,lazada`. */
         marketplace?: string;
         /** @description Comma-separated countries. One country selects its currency. */
@@ -4049,8 +5940,6 @@ interface operations {
         store?: string;
         /** @description ISO currency. Only orders in this currency are counted; amounts are not converted. Defaults to the single country's currency, otherwise SGD. */
         currency?: string;
-        /** @description IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
-        timeZone?: string;
       };
       header?: never;
       path?: never;
@@ -4058,7 +5947,7 @@ interface operations {
     };
     requestBody?: never;
     responses: {
-      /** @description Sales analytics. */
+      /** @description Get Traffic Analytics */
       200: {
         headers: {
           [name: string]: unknown;
@@ -4092,62 +5981,123 @@ interface operations {
               previousFrom: string;
               previousTo: string;
               kpis: {
-                orders: number;
-                netSales: number;
-                /** @description Average order value. */
-                aov: number;
-                unitsSold: number;
-                unitsPerOrder: number;
-                returnedOrders: number;
-                /** @description Share of orders returned, 0 to 1. */
-                returnRate: number;
-                /** @description Change against the previous period of equal length. Null without a baseline. */
-                ordersChangePercent: number | null;
+                impressions: number | null;
                 /** @description Change against the previous period of equal length. Null without a baseline. */
-                netSalesChangePercent: number | null;
+                impressionsChangePercent: number | null;
+                pageviews: number | null;
                 /** @description Change against the previous period of equal length. Null without a baseline. */
-                aovChangePercent: number | null;
+                pageviewsChangePercent: number | null;
+                visitors: number | null;
                 /** @description Change against the previous period of equal length. Null without a baseline. */
-                unitsChangePercent: number | null;
+                visitorsChangePercent: number | null;
+                clicks: number | null;
+                /** @description Visitors who added to cart. */
+                atcUsers: number | null;
                 /** @description Change against the previous period of equal length. Null without a baseline. */
-                returnRateChangePercent: number | null;
-                identifiedBuyers: number;
-                repeatBuyers: number;
-                repeatRate: number | null;
-                cancelledOrders: number;
-                cancelRate: number | null;
-              };
-              statusMix: {
-                status: string;
-                orders: number;
-                netSales: number;
-              }[];
-              platformMix: {
-                platform: string;
+                atcUsersChangePercent: number | null;
                 orders: number;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                ordersChangePercent: number | null;
                 netSales: number;
+                ctr: number | null;
+                viewToOrderCvr: number | null;
+                /** @description Change against the previous period of equal length. Null without a baseline. */
+                viewToOrderCvrChangePercent: number | null;
+                visitToAtc: number | null;
+                revenuePerVisitor: number | null;
+                /** @description Share of traffic from ads, 0 to 1. */
+                paidTrafficShare: number | null;
+                /**
+                 * @description `click` when unique visitors are unavailable and conversion uses clicks or page views.
+                 * @enum {string}
+                 */
+                funnelMode?: "visit" | "click";
+                cvrDenominatorLabel?: string;
+              };
+              /** @description Page views, visitors, potential buyers, buyers. */
+              funnel: {
+                id: string;
+                label: string;
+                value: number | null;
+                covered: boolean;
+                rateFromPrevious?: number | null;
+                rateLabel?: string | null;
               }[];
               dailyTrend: {
                 date: string;
-                previousDate: string | null;
+                impressions: number;
+                pageviews: number;
+                visitors: number;
+                atcUsers: number;
+                clicks: number;
                 orders: number;
-                netSales: number;
-                previousOrders: number;
-                previousNetSales: number;
               }[];
-              /** @description Up to 40 products ranked by net sales. */
-              topProducts: {
+              products: {
                 productId: string | null;
+                variantId: string | null;
                 productName: string;
                 platform: string | null;
-                accountId: string | null;
                 externalProductId: string | null;
                 sku: string | null;
                 thumbnailUrl: string | null;
+                impressions: number;
+                pageviews: number;
+                visitors: number;
+                clicks: number;
+                atcUsers: number;
                 orders: number;
-                unitsSold: number;
                 netSales: number;
+                ctr: number | null;
+                viewToOrderCvr: number | null;
+                visitToAtc: number | null;
+                viewToOrder: number | null;
+                netSalesPerVisitor: number | null;
+                diagnosis: string;
+                /** @description Higher means fix first. */
+                opportunityScore: number;
+                /** @enum {string} */
+                leak:
+                  | "high_traffic_low_cvr"
+                  | "zero_orders"
+                  | "healthy"
+                  | "no_traffic";
               }[];
+              diagnostics: {
+                id: string;
+                /** @enum {string} */
+                severity: "info" | "warn" | "critical" | "opportunity";
+                title: string;
+                summary: string;
+                metricLabel: string;
+                metricValue: string;
+              }[];
+              contentDrivers: {
+                externalContentId: string | null;
+                contentType: string;
+                title: string;
+                platform: string | null;
+                productId: string | null;
+                externalProductId: string | null;
+                productName: string | null;
+                productThumbnailUrl: string | null;
+                views: number;
+                productClicks: number;
+                orders: number;
+                gmv: number;
+                clickRate: number | null;
+                orderRate: number | null;
+              }[];
+              leakCount: number;
+              /** @description Which data sources have data for this range. */
+              coverage: {
+                sales: boolean;
+                traffic: boolean;
+                ads: boolean;
+                content: boolean;
+                inventory: boolean;
+                profit: boolean;
+                market: boolean;
+              };
             };
           };
         };
@@ -16910,15 +18860,115 @@ declare class AnalyticsClient {
     protected readonly _http: OmniHttp;
     constructor(_http: OmniHttp);
     /**
-     * Get Sales Analytics
+     * Get Ads Analytics
+     *
+     * Ad spend, attributed sales, ROAS, and ACOS over the last 28 days, and per-product sales and ad metrics for today, yesterday, 7-day and 28-day averages, and the same day one and four weeks ago. Matches the Ads page. Requires `analytics:read`.
+  
+  Amounts are in `data.filters.currency`. The periods count back from the end of the range.
+     *
+     * `GET /api/v1/analytics/ads`
+     */
+    getAds(request?: OperationQuery<operations["get_v1_analytics_ads"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_ads"]>>;
+    /**
+     * Get AI Traffic Analytics
      *
-     * Sales KPIs for a date range with the change against the previous period of equal length, a daily trend, sales by order status and by marketplace, and the top products by net sales. Matches the Orders analysis page. Requires `analytics:read`.
+     * Visits and crawls from AI assistants and search engines: totals, a daily trend, breakdowns by source, route, country, and product, and recent events. Matches the AI Traffic page. Requires `analytics:read`.
+  
+  A range covers at most 365 days; a longer one is shortened to the last 365 days. Read the applied range from `data.filters`.
+     *
+     * `GET /api/v1/analytics/ai-traffic`
+     */
+    getAiTraffic(request?: OperationQuery<operations["get_v1_analytics_ai_traffic"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_ai_traffic"]>>;
+    /**
+     * Get Video and LIVE Analytics
+     *
+     * Views, product clicks, orders, and GMV from shoppable videos and LIVE streams, by day, by content type, and per video. Matches the Video / LIVE page. Requires `analytics:read`.
+  
+  Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     *
+     * `GET /api/v1/analytics/content`
+     */
+    getContent(request?: OperationQuery<operations["get_v1_analytics_content"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_content"]>>;
+    /**
+     * Get Order Analytics
+     *
+     * Order KPIs with their change against the previous period, a daily trend, sales by order status and by marketplace, and the top products by net sales. Repeat buyers are counted but not listed. Matches the Orders analysis page. Requires `analytics:read`.
+  
+  Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     *
+     * `GET /api/v1/analytics/orders`
+     */
+    getOrders(request?: OperationQuery<operations["get_v1_analytics_orders"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_orders"]>>;
+    /**
+     * Get Growth Overview
+     *
+     * Sales, traffic, and profit KPIs with their change against the previous period, a daily trend, the traffic funnel, sales by channel, top and lagging products, and ranked next actions. Matches the Growth Intelligence overview page. Requires `analytics:read`.
+  
+  Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     *
+     * `GET /api/v1/analytics/overview`
+     */
+    getOverview(request?: OperationQuery<operations["get_v1_analytics_overview"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_overview"]>>;
+    /**
+     * Get Pricing Analytics
+     *
+     * Selling products with their margin, velocity, stock cover, prices, competitor median, and a pricing recommendation. Matches the Pricing page. Requires `analytics:read`.
+  
+  Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     *
+     * `GET /api/v1/analytics/pricing`
+     */
+    getPricing(request?: OperationQuery<operations["get_v1_analytics_pricing"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_pricing"]>>;
+    /**
+     * Get Product Analytics
+     *
+     * Per-product sales, traffic, price, stock, profit, and ad performance, ranked by net sales, with ranked insights. Pass `productId` for specific products, for example on a product page. Matches the Products page. Requires `analytics:read`.
+  
+  Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     *
+     * `GET /api/v1/analytics/products`
+     */
+    getProducts(request?: OperationQuery<operations["get_v1_analytics_products"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_products"]>>;
+    /**
+     * Get Profit Analytics
+     *
+     * Revenue, costs, fees, and profit with a waterfall, cost breakdowns, a daily trend, the most and least profitable products, and products missing a cost price. Session members also need finance access. Matches the P&L Analysis page. Requires `analytics:read`.
+  
+  Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     *
+     * `GET /api/v1/analytics/profit`
+     */
+    getProfit(request?: OperationQuery<operations["get_v1_analytics_profit"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_profit"]>>;
+    /**
+     * Get Business Report
+     *
+     * The management summary: headline KPIs, top products, sales by marketplace, alerts, settlement totals, and data quality. Matches the Business Reports page. Requires `analytics:read`.
+  
+  Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     *
+     * `GET /api/v1/analytics/reports`
+     */
+    getReports(request?: OperationQuery<operations["get_v1_analytics_reports"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_reports"]>>;
+    /**
+     * Get Store Analytics
+     *
+     * Seller Centre shop metrics: visitors, page views, followers, the placed, paid, and confirmed buyer funnel, a daily trend, and the app and web split. Matches the Analytics (Seller Centre) page. Requires `analytics:read`.
+  
+  Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
+     *
+     * `GET /api/v1/analytics/stores`
+     */
+    getStores(request?: OperationQuery<operations["get_v1_analytics_stores"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_stores"]>>;
+    /**
+     * Get Traffic Analytics
+     *
+     * Impressions, page views, visitors, add-to-cart, and conversion, with the funnel, a daily trend, products ranked by lost conversion, diagnostics, and the videos that drive traffic. Matches the Traffic page. Requires `analytics:read`.
   
   Amounts are in `data.filters.currency`. Only orders in that currency are counted; nothing is converted. A range covers at most 366 days.
      *
-     * `GET /api/v1/analytics/sales`
+     * `GET /api/v1/analytics/traffic`
      */
-    getSales(request?: OperationQuery<operations["get_v1_analytics_sales"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_sales"]>>;
+    getTraffic(request?: OperationQuery<operations["get_v1_analytics_traffic"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_traffic"]>>;
 }
 declare class AopClient {
     protected readonly _http: OmniHttp;
@@ -16964,26 +19014,6 @@ declare class AopClient {
      */
     retry(request: OperationBody<operations["post_v1_aop_retry"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["post_v1_aop_retry"]>>;
 }
-declare class ApiClient {
-    protected readonly _http: OmniHttp;
-    constructor(_http: OmniHttp);
-    /**
-     * API Root
-     *
-     * Public API discovery root. Merchant payments are handled by organization-scoped checkout session endpoints.
-     *
-     * `GET /api`
-     */
-    root(requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_root"]>>;
-    /**
-     * API v1 Root
-     *
-     * Public API v1 discovery root. Merchant payments are handled by organization-scoped checkout session endpoints.
-     *
-     * `GET /api/v1`
-     */
-    v1(requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1"]>>;
-}
 declare class CampaignsClient {
     protected readonly _http: OmniHttp;
     constructor(_http: OmniHttp);
@@ -18070,7 +20100,6 @@ declare class OmniGeneratedClient {
     readonly agents: AgentsClient;
     readonly analytics: AnalyticsClient;
     readonly aop: AopClient;
-    readonly api: ApiClient;
     readonly campaigns: CampaignsClient;
     readonly catalog: CatalogClient;
     readonly checkoutSessions: CheckoutSessionsClient;
@@ -18107,7 +20136,6 @@ type OmniResources = {
     agents: AgentsClient;
     analytics: AnalyticsClient;
     aop: AopClient;
-    api: ApiClient;
     campaigns: CampaignsClient;
     catalog: CatalogClient;
     checkoutSessions: CheckoutSessionsClient;
@@ -18181,7 +20209,7 @@ declare function constructEvent(payload: string | Uint8Array, headers: WebhookHe
     toleranceInSeconds?: number;
 }): Promise<ConstructedWebhookEvent>;
 
-declare const SDK_VERSION = "0.3.0";
+declare const SDK_VERSION = "0.4.0";
 
 type ProductCreatedWebhookEvent = components["schemas"]["ProductCreatedWebhookEvent"];
 type ProductUpdatedWebhookEvent = components["schemas"]["ProductUpdatedWebhookEvent"];