@omni-commerce/sdk 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -293,6 +293,28 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/v1/analytics/sales": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      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`.
+     *
+     *     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"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/v1/aop/{aopId}/config": {
     parameters: {
       query?: never;
@@ -1079,6 +1101,56 @@ interface paths {
     patch: operations["patch_v1_orders_by_orderid"];
     trace?: never;
   };
+  "/api/v1/orders/{orderId}/action-options": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get Order Action Options
+     * @description Ask the marketplace which choices an action needs, such as pickup or drop-off for `ship`. Requires `orders:write`.
+     *
+     *     Send the chosen choice's `payload` with `POST /api/v1/orders/{orderId}/actions`.
+     */
+    get: operations["get_v1_orders_by_orderid_action_options"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/orders/{orderId}/actions": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List Order Actions
+     * @description The order's 20 most recent action jobs, newest first, plus its latest successful label job. Requires `orders:read`.
+     *
+     *     Poll this after queueing an action. A succeeded `labels` job lists its label files in `labels`.
+     */
+    get: operations["get_v1_orders_by_orderid_actions"];
+    put?: never;
+    /**
+     * Queue Order Action
+     * @description Ship, cancel, generate shipping labels for, or update tracking on a marketplace order. Requires `orders:write`.
+     *
+     *     The marketplace call runs in the background: the response is `202` with `jobId`; poll `GET /api/v1/orders/{orderId}/actions`. A repeated `idempotencyKey` returns `200` with the original job.
+     */
+    post: operations["post_v1_orders_by_orderid_actions"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/v1/organizations": {
     parameters: {
       query?: never;
@@ -1184,7 +1256,9 @@ interface paths {
      * List Products
      * @description List products for the authenticated organization with optional filters and pagination. Authenticate with an API key or OAuth bearer token. The organization is taken from that credential; do not send `organizationId`.
      *
-     *     Rows are in `items`. Read catalog stock from `items[].stockQuantity`: parent rows already aggregate their non-deleted variants, and virtual bundles use component availability with any manual cap. Null means unknown, not zero. List rows do not contain `inventoryQuantity`, `inventory.quantity`, or an embedded `variants` array.
+     *     ### Stock and variants
+     *
+     *     Rows are in `items`. Read catalog stock from `items[].stockQuantity`: parent rows already aggregate their non-deleted variants, and virtual bundles use component availability with any manual cap. Null means unknown, not zero. A row with `variantCount` above 0 has variants; fetch them from `GET /api/v1/products/{productId}`. List rows do not contain `inventoryQuantity`, `inventory.quantity`, or an embedded `variants` array.
      */
     get: operations["get_v1_products"];
     put?: never;
@@ -1229,6 +1303,8 @@ interface paths {
      *     - Localization content and cultural notes
      *     - Intent queries and signals
      *     - Sources and claims
+     *
+     *     A parent product returns its variants in `variants`, with each variant's option values, price, stock, image, and marketplace listings.
      */
     get: operations["get_v1_products_by_productid"];
     put?: never;
@@ -1319,6 +1395,28 @@ interface paths {
     patch: operations["patch_v1_products_by_productid_inventory"];
     trace?: never;
   };
+  "/api/v1/products/{productId}/listings": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get Product Listings
+     * @description Where a product is listed: each marketplace's store, live or delisted state, item id, buyer-facing URL, and the latest publish attempt with any rejection details. Requires `catalog:read`.
+     *
+     *     Poll after `POST /api/v1/products/{productId}/publish`.
+     */
+    get: operations["get_v1_products_by_productid_listings"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/v1/products/{productId}/price": {
     parameters: {
       query?: never;
@@ -1596,6 +1694,92 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  "/api/v1/reviews": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List Reviews
+     * @description List marketplace product reviews, newest first unless `sortBy` says otherwise. Requires `reviews:read`.
+     *
+     *     Use `priority=unreplied` for a reply queue. `replyRestriction` is null when a reply will be accepted.
+     */
+    get: operations["get_v1_reviews"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/reviews/{reviewId}": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get Review
+     * @description Read one review by its OmniCommerce UUID. Requires `reviews:read`.
+     */
+    get: operations["get_v1_reviews_by_reviewid"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/reviews/{reviewId}/draft-reply": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Draft Review Reply
+     * @description Draft a reply with AI from the review, the product, recent replies, and the brand kit. Uses AI credits. Requires `reviews:write`.
+     *
+     *     Nothing is posted; send the text with `POST /api/v1/reviews/actions`.
+     */
+    post: operations["post_v1_reviews_by_reviewid_draft_reply"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/reviews/actions": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Act on Reviews
+     * @description Reply to up to 50 reviews, or send Amazon review requests for solicitation rows. Requires `reviews:write`.
+     *
+     *     Each target succeeds or fails on its own; read `data.results`. `ok` is true only when every target succeeds.
+     */
+    post: operations["post_v1_reviews_actions"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
   "/api/v1/search": {
     parameters: {
       query?: never;
@@ -3848,6 +4032,163 @@ interface operations {
       };
     };
   };
+  get_v1_analytics_sales: {
+    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 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 IANA time zone that defines each day, for example `Asia/Kuala_Lumpur`. Defaults to Asia/Singapore. */
+        timeZone?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Sales 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_aop_by_aopid_config: {
     parameters: {
       query?: {
@@ -9276,64 +9617,94 @@ interface operations {
       };
     };
   };
-  post_v1_organizations: {
+  get_v1_orders_by_orderid_action_options: {
     parameters: {
-      query?: never;
+      query: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+        action: "ship" | "cancel" | "labels" | "update_tracking";
+      };
       header?: never;
-      path?: never;
-      cookie?: never;
-    };
-    requestBody: {
-      content: {
-        /**
-         * @example {
-         *       "name": "Acme Team"
-         *     }
-         */
-        "application/json": {
-          /** @description Organization display name. */
-          name: string;
-          /**
-           * @description When true, Better Auth keeps the current active organization instead of switching active context.
-           * @default false
-           */
-          keepCurrentActiveOrganization?: boolean;
-        };
+      path: {
+        orderId: string;
       };
+      cookie?: never;
     };
+    requestBody?: never;
     responses: {
-      /** @description Organization created */
-      201: {
+      /** @description Choices for the action. */
+      200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
             ok: boolean;
-            organizationId: string;
-            redirectUrl?: string;
-            organization: {
-              id: string;
-              name: string;
-              slug: string;
+            /** @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: {
+              /** @enum {string} */
+              action: "ship" | "cancel" | "labels" | "update_tracking";
+              choices: {
+                id: string;
+                label: string;
+                description?: string;
+                /** @description Send this as the action `payload` to use the choice. */
+                payload?: {
+                  [key: string]: unknown;
+                };
+                /** @description The choice needs extra fields, such as a tracking number. */
+                requiresInput?: boolean;
+              }[];
             };
           };
         };
       };
-      /** @description Bad Request - Invalid organization name or JSON */
+      /** @description Invalid request */
       400: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Unauthorized - Sign in is required */
+      /** @description Unauthorized */
       401: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
+      /** @description Missing the `orders:write` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Order not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
       /** @description Internal Server Error */
       500: {
         headers: {
@@ -9343,43 +9714,69 @@ interface operations {
       };
     };
   };
-  get_v1_price_books: {
+  get_v1_orders_by_orderid_actions: {
     parameters: {
       query?: {
-        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
+        /** @description Required for session auth. API keys already belong to one organization. */
         organizationId?: string;
-        /** @description Filter by marketplace platform: `shopee`, `lazada`, `tiktok`, `shopify`, `whatsapp`, `zalora`, `amazon`, or `ebay`. */
-        platform?:
-          | "shopee"
-          | "lazada"
-          | "tiktok"
-          | "shopify"
-          | "whatsapp"
-          | "zalora"
-          | "amazon"
-          | "ebay";
-        /** @description When `true`, return only enabled rules. */
-        enabledOnly?: boolean;
       };
       header?: never;
-      path?: never;
+      path: {
+        orderId: string;
+      };
       cookie?: never;
     };
     requestBody?: never;
     responses: {
-      /** @description Price book rules returned. */
+      /** @description Action jobs. */
       200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            rules: Record<string, never>[];
-            total: number;
+            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: {
+              jobs: {
+                id: string;
+                orderId: string;
+                /** @enum {string} */
+                action: "ship" | "cancel" | "labels" | "update_tracking";
+                /** @enum {string} */
+                status:
+                  | "queued"
+                  | "running"
+                  | "succeeded"
+                  | "failed"
+                  | "not_supported";
+                errorMessage: string | null;
+                updatedAt: string | null;
+                completedAt: string | null;
+                /** @description Shipping label files. Filled when a `labels` job has succeeded. */
+                labels: {
+                  /** @description Download URL of the label file. */
+                  url: string;
+                  name: string | null;
+                  mimeType: string | null;
+                }[];
+              }[];
+            };
           };
         };
       };
-      /** @description Bad Request (invalid platform filter) */
+      /** @description Invalid request */
       400: {
         headers: {
           [name: string]: unknown;
@@ -9393,7 +9790,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Forbidden or missing `price_books:read` scope */
+      /** @description Missing the `orders:read` scope */
       403: {
         headers: {
           [name: string]: unknown;
@@ -9416,74 +9813,92 @@ interface operations {
       };
     };
   };
-  post_v1_price_books: {
+  post_v1_orders_by_orderid_actions: {
     parameters: {
       query?: never;
       header?: never;
-      path?: never;
+      path: {
+        orderId: string;
+      };
       cookie?: never;
     };
     requestBody: {
       content: {
-        /**
-         * @example {
-         *       "platform": "shopee",
-         *       "marginValue": 10,
-         *       "country": "singapore",
-         *       "rounding": "currency_minor",
-         *       "currency": "SGD",
-         *       "enabled": true
-         *     }
-         */
         "application/json": {
-          /** @description Required for session auth across multiple organizations. Optional for OAuth/API keys bound to one organization. */
+          /** @description Required for session auth. API keys already belong to one organization. */
           organizationId?: string;
-          /** @enum {string} */
-          platform:
-            | "shopee"
-            | "lazada"
-            | "tiktok"
-            | "shopify"
-            | "whatsapp"
-            | "zalora"
-            | "amazon"
-            | "ebay";
-          /** @description Optional connected store ID. Null/omit applies to all stores for the platform. */
-          storeId?: string | null;
-          /** @description Optional country scope (name or code). Null/omit applies to all countries. */
-          country?: string | null;
-          /** @description Markup percent applied to the catalog price. Ignored when `expression` is set. */
-          marginValue: number;
-          /** @description Buyer formula. `price` is the catalog price. Supports arithmetic, percentages, CEILING, IF, and CURRENCY(rate, "USD"). Replaces markup percent. */
-          expression?: string | null;
           /**
-           * @description Defaults to `currency_minor` when omitted.
+           * @description `ship` arranges shipment, `labels` generates shipping labels, `update_tracking` sends a tracking number, and `cancel` cancels the order.
            * @enum {string}
            */
-          rounding?: "none" | "currency_minor" | "nearest_0_05" | "nearest_1";
-          /** @description Optional ISO 4217 currency for `currency_minor` rounding. */
-          currency?: string | null;
-          /**
-           * @description Whether the rule is active. Defaults to true.
-           * @default true
-           */
-          enabled?: boolean;
+          action: "ship" | "cancel" | "labels" | "update_tracking";
+          /** @description Marketplace inputs for the action. Send the `payload` of the choice returned by `GET /api/v1/orders/{orderId}/action-options`, plus fields such as `trackingNumber` or `cancelReason` when a choice requires input. */
+          payload?: {
+            [key: string]: unknown;
+          };
+          /** @description Repeat a request with the same key to get the original job instead of a second marketplace call. */
+          idempotencyKey?: string;
         };
       };
     };
     responses: {
-      /** @description Price book rule created. */
-      201: {
+      /** @description The idempotency key matched an existing job. */
+      200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            rule: Record<string, never>;
+            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: {
+              jobId: string;
+              jobStatus: string;
+              duplicate: boolean;
+            };
           };
         };
       };
-      /** @description Bad Request (invalid payload, markup range, or duplicate platform/store/country scope) */
+      /** @description The action job was queued. */
+      202: {
+        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: {
+              jobId: string;
+              jobStatus: string;
+              duplicate: boolean;
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
       400: {
         headers: {
           [name: string]: unknown;
@@ -9497,13 +9912,20 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Forbidden or missing `price_books:write` scope */
+      /** @description Missing the `orders:write` scope */
       403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
+      /** @description Order not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
       /** @description Rate limit exceeded */
       429: {
         headers: {
@@ -9520,47 +9942,59 @@ interface operations {
       };
     };
   };
-  get_v1_price_books_by_ruleid: {
+  post_v1_organizations: {
     parameters: {
-      query?: {
-        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
-        organizationId?: string;
-      };
+      query?: never;
       header?: never;
-      path: {
-        ruleId: string;
-      };
+      path?: never;
       cookie?: never;
     };
-    requestBody?: never;
+    requestBody: {
+      content: {
+        /**
+         * @example {
+         *       "name": "Acme Team"
+         *     }
+         */
+        "application/json": {
+          /** @description Organization display name. */
+          name: string;
+          /**
+           * @description When true, Better Auth keeps the current active organization instead of switching active context.
+           * @default false
+           */
+          keepCurrentActiveOrganization?: boolean;
+        };
+      };
+    };
     responses: {
-      /** @description Price book rule returned. */
-      200: {
+      /** @description Organization created */
+      201: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            rule: Record<string, never>;
+            ok: boolean;
+            organizationId: string;
+            redirectUrl?: string;
+            organization: {
+              id: string;
+              name: string;
+              slug: string;
+            };
           };
         };
       };
-      /** @description Unauthorized */
-      401: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Forbidden or missing `price_books:read` scope */
-      403: {
+      /** @description Bad Request - Invalid organization name or JSON */
+      400: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Price book rule not found */
-      404: {
+      /** @description Unauthorized - Sign in is required */
+      401: {
         headers: {
           [name: string]: unknown;
         };
@@ -9575,16 +10009,248 @@ interface operations {
       };
     };
   };
-  delete_v1_price_books_by_ruleid: {
+  get_v1_price_books: {
     parameters: {
       query?: {
         /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
         organizationId?: string;
+        /** @description Filter by marketplace platform: `shopee`, `lazada`, `tiktok`, `shopify`, `whatsapp`, `zalora`, `amazon`, or `ebay`. */
+        platform?:
+          | "shopee"
+          | "lazada"
+          | "tiktok"
+          | "shopify"
+          | "whatsapp"
+          | "zalora"
+          | "amazon"
+          | "ebay";
+        /** @description When `true`, return only enabled rules. */
+        enabledOnly?: boolean;
       };
       header?: never;
-      path: {
-        ruleId: string;
-      };
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Price book rules returned. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            rules: Record<string, never>[];
+            total: number;
+          };
+        };
+      };
+      /** @description Bad Request (invalid platform filter) */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden or missing `price_books: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;
+      };
+    };
+  };
+  post_v1_price_books: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        /**
+         * @example {
+         *       "platform": "shopee",
+         *       "marginValue": 10,
+         *       "country": "singapore",
+         *       "rounding": "currency_minor",
+         *       "currency": "SGD",
+         *       "enabled": true
+         *     }
+         */
+        "application/json": {
+          /** @description Required for session auth across multiple organizations. Optional for OAuth/API keys bound to one organization. */
+          organizationId?: string;
+          /** @enum {string} */
+          platform:
+            | "shopee"
+            | "lazada"
+            | "tiktok"
+            | "shopify"
+            | "whatsapp"
+            | "zalora"
+            | "amazon"
+            | "ebay";
+          /** @description Optional connected store ID. Null/omit applies to all stores for the platform. */
+          storeId?: string | null;
+          /** @description Optional country scope (name or code). Null/omit applies to all countries. */
+          country?: string | null;
+          /** @description Markup percent applied to the catalog price. Ignored when `expression` is set. */
+          marginValue: number;
+          /** @description Buyer formula. `price` is the catalog price. Supports arithmetic, percentages, CEILING, IF, and CURRENCY(rate, "USD"). Replaces markup percent. */
+          expression?: string | null;
+          /**
+           * @description Defaults to `currency_minor` when omitted.
+           * @enum {string}
+           */
+          rounding?: "none" | "currency_minor" | "nearest_0_05" | "nearest_1";
+          /** @description Optional ISO 4217 currency for `currency_minor` rounding. */
+          currency?: string | null;
+          /**
+           * @description Whether the rule is active. Defaults to true.
+           * @default true
+           */
+          enabled?: boolean;
+        };
+      };
+    };
+    responses: {
+      /** @description Price book rule created. */
+      201: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            rule: Record<string, never>;
+          };
+        };
+      };
+      /** @description Bad Request (invalid payload, markup range, or duplicate platform/store/country scope) */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden or missing `price_books:write` 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_price_books_by_ruleid: {
+    parameters: {
+      query?: {
+        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
+        organizationId?: string;
+      };
+      header?: never;
+      path: {
+        ruleId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Price book rule returned. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            rule: Record<string, never>;
+          };
+        };
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden or missing `price_books:read` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Price book rule not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  delete_v1_price_books_by_ruleid: {
+    parameters: {
+      query?: {
+        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
+        organizationId?: string;
+      };
+      header?: never;
+      path: {
+        ruleId: string;
+      };
       cookie?: never;
     };
     requestBody?: never;
@@ -9872,8 +10538,7 @@ interface operations {
               isVariant: boolean;
               /** @description Catalog stock in whole units, matching the Products page. Parent rows aggregate non-deleted variants in the same organization; virtual bundles derive stock from components and any manual cap. Null means unknown: never substitute zero for missing or null stock. This is not a sum of marketplace inventory mirrors or a per-location available-to-promise balance. */
               stockQuantity: number | null;
-              /** @description Whether the product has variants. The list row's stockQuantity already includes their stock; variants are not embedded in this response. */
-              hasVariants: boolean;
+              /** @description Number of non-deleted variants; greater than 0 means the product has variants. A parent row's stockQuantity already includes their stock. Read the variants themselves from `GET /api/v1/products/{productId}`. */
               variantCount: number;
               status?: string;
               /** @description Read-only product-wide state. Lifecycle status and derived quality/error signals are independent; this field is recalculated from current product, marketplace QC, and review flags. */
@@ -10461,40 +11126,94 @@ interface operations {
             createdAt?: string;
             /** @description ISO 8601 timestamp */
             updatedAt?: string;
-          };
-        };
-      };
-      /** @description Unauthorized - Invalid or missing Bearer token */
-      401: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Forbidden - Token not authorized for this organization */
-      403: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Product not found */
-      404: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Internal Server Error */
-      500: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-    };
-  };
-  delete_v1_products_by_productid: {
+            /** @description The product's non-deleted variants, oldest first, in the same row shape as `GET /api/v1/products` items. Empty for a simple product and when the requested product is itself a variant. */
+            variants: ({
+              /** Format: uuid */
+              id: string;
+              name: string;
+              sku: string | null;
+              /** Format: uuid */
+              parentId: string | null;
+              isVariant: boolean;
+              /** @description Catalog stock in whole units, matching the Products page. Parent rows aggregate non-deleted variants in the same organization; virtual bundles derive stock from components and any manual cap. Null means unknown: never substitute zero for missing or null stock. This is not a sum of marketplace inventory mirrors or a per-location available-to-promise balance. */
+              stockQuantity: number | null;
+              /** @description Number of non-deleted variants; greater than 0 means the product has variants. A parent row's stockQuantity already includes their stock. Read the variants themselves from `GET /api/v1/products/{productId}`. */
+              variantCount: number;
+              status?: string;
+              /** @description Read-only product-wide state. Lifecycle status and derived quality/error signals are independent; this field is recalculated from current product, marketplace QC, and review flags. */
+              statusFacets?: {
+                /** @enum {string} */
+                lifecycle:
+                  | "draft"
+                  | "active"
+                  | "archived"
+                  | "deleted"
+                  | "unknown";
+                derived: (
+                  | "flagged"
+                  | "errors"
+                  | "qc_pending"
+                  | "qc_rejected"
+                )[];
+                zaloraQualityControl?: Record<string, never>;
+              };
+            } & {
+              /** @description Option values that identify the variant, for example `{ "Color": "Navy", "Size": "M" }`. */
+              variationAttributes?: {
+                [key: string]: string;
+              } | null;
+              price?: number | null;
+              salePrice?: number | null;
+              /** @description Price formatted with the product currency. */
+              priceLabel?: string;
+              /** @description The variant's own image, falling back to the parent product image. */
+              imageUrl?: string | null;
+              imageUrls?: string[];
+              /** @description The variant's listing on each connected marketplace. */
+              marketplaces?: {
+                marketplace?: string;
+                country?: string | null;
+                storeId?: string | null;
+                storeLabel?: string | null;
+                published?: boolean;
+                itemId?: string | null;
+                listingUrl?: string | null;
+              }[];
+            })[];
+          };
+        };
+      };
+      /** @description Unauthorized - Invalid or missing Bearer token */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden - Token not authorized for this organization */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Product not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  delete_v1_products_by_productid: {
     parameters: {
       query?: never;
       header?: never;
@@ -11106,6 +11825,119 @@ interface operations {
       };
     };
   };
+  get_v1_products_by_productid_listings: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+      };
+      header?: never;
+      path: {
+        productId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The product's listings. */
+      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: {
+              productId: string;
+              listings: {
+                marketplace: string;
+                marketplaceLabel: string;
+                country: string | null;
+                storeId: string | null;
+                storeLabel: string | null;
+                /** @description The marketplace has a live listing for the product. */
+                published: boolean;
+                /** @description The listing was delisted; its marketplace identity is kept. */
+                unlisted: boolean;
+                /** @description Marketplace item id. */
+                itemId: string | null;
+                /** @description Buyer-facing listing URL while published. */
+                listingUrl: string | null;
+                publishedAt: string | null;
+                /** @description The most recent publish to this marketplace, including one still running. */
+                latestPublish: {
+                  jobId: string;
+                  /** @enum {string} */
+                  status: "pending" | "running" | "success" | "error";
+                  /** @description `created` or `updated` once the job has run. */
+                  action: string | null;
+                  message: string | null;
+                  error: string | null;
+                  /** @description The marketplace's rejection details, when it returned any. */
+                  errorDetail?: unknown;
+                  updatedAt: string;
+                } | null;
+              }[];
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Missing the `catalog:read` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Product not found */
+      404: {
+        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;
+      };
+    };
+  };
   patch_v1_products_by_productid_price: {
     parameters: {
       query?: never;
@@ -12691,7 +13523,379 @@ interface operations {
           "application/json": Record<string, never>;
         };
       };
-      /** @description Bad Request */
+      /** @description Bad Request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden or missing `promotions:write` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  post_v1_promotions_by_promotionid_sync: {
+    parameters: {
+      query?: {
+        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
+        organizationId?: string;
+      };
+      header?: never;
+      path: {
+        promotionId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        /**
+         * @example {
+         *       "marketplace": "shopee"
+         *     }
+         */
+        "application/json": {
+          organizationId?: string;
+          /**
+           * @description Optional single marketplace. When omitted, syncs all promotion marketplaces.
+           * @enum {string}
+           */
+          marketplace?:
+            | "lazada"
+            | "shopee"
+            | "tiktok"
+            | "shopify"
+            | "amazon"
+            | "zalora"
+            | "ebay";
+          /** @description Optional product subset. When omitted, syncs all assigned products. */
+          productIds?: string[];
+        };
+      };
+    };
+    responses: {
+      /** @description Sync queued. */
+      202: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok: boolean;
+            queued: boolean;
+            jobId?: string;
+            syncBatchId: string;
+            marketplaces: string[];
+          };
+        };
+      };
+      /** @description Bad Request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden or missing `promotions:write` scope */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_returns: {
+    parameters: {
+      query?: {
+        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
+        organizationId?: string;
+        marketplace?: string;
+        accountId?: string;
+        externalOrderId?: string;
+        updatedSince?: string;
+        cursor?: string;
+        limit?: number;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Success */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok?: boolean;
+            /** @default developer_v1 */
+            apiVersion: string;
+          };
+        };
+      };
+      /** @description Bad Request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Insufficient Credits */
+      402: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_returns_by_returnid: {
+    parameters: {
+      query?: {
+        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
+        organizationId?: string;
+      };
+      header?: never;
+      path: {
+        returnId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Success */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            ok?: boolean;
+            /** @default developer_v1 */
+            apiVersion: string;
+          };
+        };
+      };
+      /** @description Bad Request */
+      400: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Unauthorized */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Insufficient Credits */
+      402: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Forbidden */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Return not found. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Internal Server Error */
+      500: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
+  get_v1_reviews: {
+    parameters: {
+      query?: {
+        /** @description Required for session auth. API keys already belong to one organization. */
+        organizationId?: string;
+        /** @description Search the comment, product name or SKU, marketplace item id, and review id. */
+        q?: string;
+        marketplace?:
+          | "shopee"
+          | "lazada"
+          | "tiktok"
+          | "shopify"
+          | "zalora"
+          | "amazon"
+          | "ebay";
+        status?:
+          | "open"
+          | "replied"
+          | "hidden"
+          | "handoff"
+          | "solicited"
+          | "ineligible";
+        /** @description `unreplied`: open reviews the marketplace allows a reply to. `negative`: rating of 3 or lower. */
+        priority?: "unreplied" | "negative";
+        /** @description Comma-separated store (account) ids from `GET /api/v1/marketplaces/connected`. */
+        store?: string;
+        /** @description A product or variant UUID. Includes reviews of the whole product family. */
+        productId?: string;
+        /** @description Comma-separated sort keys: reviewed_desc, reviewed_asc, rating_desc, rating_asc, status_asc, status_desc, marketplace_asc, marketplace_desc, product_asc, product_desc. Defaults to reviewed_desc. */
+        sortBy?: string;
+        limit?: number;
+        offset?: number;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description A page of reviews. */
+      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: {
+              reviews: {
+                id: string;
+                /** @enum {string} */
+                platform:
+                  | "shopee"
+                  | "lazada"
+                  | "tiktok"
+                  | "shopify"
+                  | "zalora"
+                  | "amazon"
+                  | "ebay";
+                /** @description Marketplace store id. */
+                accountId: string | null;
+                storeName: string | null;
+                productId: string | null;
+                productName: string | null;
+                productSku: string | null;
+                productThumbnailUrl: string | null;
+                orderId: string | null;
+                externalItemId: string | null;
+                externalReviewId: string;
+                externalOrderId: string | null;
+                /**
+                 * @description `solicitation` rows are Amazon orders you can send a review request for.
+                 * @enum {string}
+                 */
+                kind: "product_review" | "solicitation";
+                /** @enum {string} */
+                status:
+                  | "open"
+                  | "replied"
+                  | "hidden"
+                  | "handoff"
+                  | "solicited"
+                  | "ineligible";
+                rating: number | null;
+                comment: string | null;
+                sellerReply: string | null;
+                sellerRepliedAt: string | null;
+                /** @description The marketplace's own reply eligibility flag. */
+                canReply: boolean;
+                /** @description Why a reply is not possible right now, or null when `review.reply` will be accepted. */
+                replyRestriction: string | null;
+                reviewedAt: string | null;
+                /** @description Public marketplace product page, when it can be resolved. */
+                marketplaceListingUrl: string | null;
+                sellerCenterUrl: string | null;
+                firstSeenAt: string;
+                lastSeenAt: string;
+              }[];
+              total: number;
+              limit: number;
+              offset: number;
+              hasMore: boolean;
+              nextOffset: number | null;
+            };
+          };
+        };
+      };
+      /** @description Invalid request */
       400: {
         headers: {
           [name: string]: unknown;
@@ -12705,13 +13909,20 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Forbidden or missing `promotions:write` scope */
+      /** @description Missing the `reviews: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: {
@@ -12721,61 +13932,96 @@ interface operations {
       };
     };
   };
-  post_v1_promotions_by_promotionid_sync: {
+  get_v1_reviews_by_reviewid: {
     parameters: {
       query?: {
-        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
+        /** @description Required for session auth. API keys already belong to one organization. */
         organizationId?: string;
       };
       header?: never;
       path: {
-        promotionId: string;
+        reviewId: string;
       };
       cookie?: never;
     };
-    requestBody: {
-      content: {
-        /**
-         * @example {
-         *       "marketplace": "shopee"
-         *     }
-         */
-        "application/json": {
-          organizationId?: string;
-          /**
-           * @description Optional single marketplace. When omitted, syncs all promotion marketplaces.
-           * @enum {string}
-           */
-          marketplace?:
-            | "lazada"
-            | "shopee"
-            | "tiktok"
-            | "shopify"
-            | "amazon"
-            | "zalora"
-            | "ebay";
-          /** @description Optional product subset. When omitted, syncs all assigned products. */
-          productIds?: string[];
-        };
-      };
-    };
+    requestBody?: never;
     responses: {
-      /** @description Sync queued. */
-      202: {
+      /** @description The review. */
+      200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
             ok: boolean;
-            queued: boolean;
+            /** @constant */
+            apiVersion: "developer_v1";
+            operationId: string;
+            /** @enum {string} */
+            status: "accepted" | "completed" | "failed";
             jobId?: string;
-            syncBatchId: string;
-            marketplaces: string[];
+            productId?: string;
+            warnings: string[];
+            recommendations: string[];
+            links: {
+              [key: string]: string;
+            };
+            data: {
+              review: {
+                id: string;
+                /** @enum {string} */
+                platform:
+                  | "shopee"
+                  | "lazada"
+                  | "tiktok"
+                  | "shopify"
+                  | "zalora"
+                  | "amazon"
+                  | "ebay";
+                /** @description Marketplace store id. */
+                accountId: string | null;
+                storeName: string | null;
+                productId: string | null;
+                productName: string | null;
+                productSku: string | null;
+                productThumbnailUrl: string | null;
+                orderId: string | null;
+                externalItemId: string | null;
+                externalReviewId: string;
+                externalOrderId: string | null;
+                /**
+                 * @description `solicitation` rows are Amazon orders you can send a review request for.
+                 * @enum {string}
+                 */
+                kind: "product_review" | "solicitation";
+                /** @enum {string} */
+                status:
+                  | "open"
+                  | "replied"
+                  | "hidden"
+                  | "handoff"
+                  | "solicited"
+                  | "ineligible";
+                rating: number | null;
+                comment: string | null;
+                sellerReply: string | null;
+                sellerRepliedAt: string | null;
+                /** @description The marketplace's own reply eligibility flag. */
+                canReply: boolean;
+                /** @description Why a reply is not possible right now, or null when `review.reply` will be accepted. */
+                replyRestriction: string | null;
+                reviewedAt: string | null;
+                /** @description Public marketplace product page, when it can be resolved. */
+                marketplaceListingUrl: string | null;
+                sellerCenterUrl: string | null;
+                firstSeenAt: string;
+                lastSeenAt: string;
+              };
+            };
           };
         };
       };
-      /** @description Bad Request */
+      /** @description Invalid request */
       400: {
         headers: {
           [name: string]: unknown;
@@ -12789,13 +14035,27 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Forbidden or missing `promotions:write` scope */
+      /** @description Missing the `reviews:read` scope */
       403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
+      /** @description Review not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
       /** @description Internal Server Error */
       500: {
         headers: {
@@ -12805,38 +14065,48 @@ interface operations {
       };
     };
   };
-  get_v1_returns: {
+  post_v1_reviews_by_reviewid_draft_reply: {
     parameters: {
       query?: {
-        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
+        /** @description Required for session auth. API keys already belong to one organization. */
         organizationId?: string;
-        marketplace?: string;
-        accountId?: string;
-        externalOrderId?: string;
-        updatedSince?: string;
-        cursor?: string;
-        limit?: number;
       };
       header?: never;
-      path?: never;
+      path: {
+        reviewId: string;
+      };
       cookie?: never;
     };
     requestBody?: never;
     responses: {
-      /** @description Success */
+      /** @description The drafted reply. */
       200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            ok?: boolean;
-            /** @default developer_v1 */
-            apiVersion: string;
+            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: {
+              reply: string;
+              model: string;
+            };
           };
         };
       };
-      /** @description Bad Request */
+      /** @description Invalid request */
       400: {
         headers: {
           [name: string]: unknown;
@@ -12850,15 +14120,22 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Insufficient Credits */
-      402: {
+      /** @description Missing the `reviews:write` scope */
+      403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Forbidden */
-      403: {
+      /** @description Review not found */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Rate limit exceeded */
+      429: {
         headers: {
           [name: string]: unknown;
         };
@@ -12871,36 +14148,80 @@ interface operations {
         };
         content?: never;
       };
+      /** @description The AI draft failed */
+      502: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
     };
   };
-  get_v1_returns_by_returnid: {
+  post_v1_reviews_actions: {
     parameters: {
-      query?: {
-        /** @description Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token. */
-        organizationId?: string;
-      };
+      query?: never;
       header?: never;
-      path: {
-        returnId: string;
-      };
+      path?: never;
       cookie?: never;
     };
-    requestBody?: never;
+    requestBody: {
+      content: {
+        "application/json": {
+          /** @description Required for session auth. API keys already belong to one organization. */
+          organizationId?: string;
+          /**
+           * @description `review.reply` posts a seller reply. `review.solicit` sends an Amazon review request for a solicitation row.
+           * @enum {string}
+           */
+          action: "review.reply" | "review.solicit";
+          targets: {
+            /** Format: uuid */
+            reviewId: string;
+            /** @description Reply for this review. Overrides the shared `reply`. */
+            reply?: string;
+          }[];
+          /** @description Reply text used for every target without its own `reply`. */
+          reply?: string;
+        };
+      };
+    };
     responses: {
-      /** @description Success */
+      /** @description One result per review. */
       200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            ok?: boolean;
-            /** @default developer_v1 */
-            apiVersion: string;
+            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: {
+              success: boolean;
+              succeededCount: number;
+              failedCount: number;
+              results: {
+                reviewId: string;
+                success: boolean;
+                error?: string;
+                /** @description Where to finish the action by hand when the marketplace API cannot. */
+                sellerCenterUrl?: string;
+              }[];
+            };
           };
         };
       };
-      /** @description Bad Request */
+      /** @description Invalid request */
       400: {
         headers: {
           [name: string]: unknown;
@@ -12914,22 +14235,15 @@ interface operations {
         };
         content?: never;
       };
-      /** @description Insufficient Credits */
-      402: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content?: never;
-      };
-      /** @description Forbidden */
+      /** @description Missing the `reviews:write` scope */
       403: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Return not found. */
-      404: {
+      /** @description Rate limit exceeded */
+      429: {
         headers: {
           [name: string]: unknown;
         };
@@ -15592,6 +16906,20 @@ declare class AgentsClient {
     readonly general: AgentsGeneralClient;
     constructor(_http: OmniHttp);
 }
+declare class AnalyticsClient {
+    protected readonly _http: OmniHttp;
+    constructor(_http: OmniHttp);
+    /**
+     * Get Sales 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`.
+  
+  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`
+     */
+    getSales(request?: OperationQuery<operations["get_v1_analytics_sales"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_analytics_sales"]>>;
+}
 declare class AopClient {
     protected readonly _http: OmniHttp;
     constructor(_http: OmniHttp);
@@ -16077,6 +17405,36 @@ declare class OrdersClient {
      * `PATCH /api/v1/orders/{orderId}`
      */
     update(request: OperationPath<operations["patch_v1_orders_by_orderid"]> & OperationBody<operations["patch_v1_orders_by_orderid"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["patch_v1_orders_by_orderid"]>>;
+    /**
+     * Get Order Action Options
+     *
+     * Ask the marketplace which choices an action needs, such as pickup or drop-off for `ship`. Requires `orders:write`.
+  
+  Send the chosen choice's `payload` with `POST /api/v1/orders/{orderId}/actions`.
+     *
+     * `GET /api/v1/orders/{orderId}/action-options`
+     */
+    getActionOptions(request: OperationPath<operations["get_v1_orders_by_orderid_action_options"]> & OperationQuery<operations["get_v1_orders_by_orderid_action_options"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_orders_by_orderid_action_options"]>>;
+    /**
+     * List Order Actions
+     *
+     * The order's 20 most recent action jobs, newest first, plus its latest successful label job. Requires `orders:read`.
+  
+  Poll this after queueing an action. A succeeded `labels` job lists its label files in `labels`.
+     *
+     * `GET /api/v1/orders/{orderId}/actions`
+     */
+    listActions(request: OperationPath<operations["get_v1_orders_by_orderid_actions"]> & OperationQuery<operations["get_v1_orders_by_orderid_actions"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_orders_by_orderid_actions"]>>;
+    /**
+     * Queue Order Action
+     *
+     * Ship, cancel, generate shipping labels for, or update tracking on a marketplace order. Requires `orders:write`.
+  
+  The marketplace call runs in the background: the response is `202` with `jobId`; poll `GET /api/v1/orders/{orderId}/actions`. A repeated `idempotencyKey` returns `200` with the original job.
+     *
+     * `POST /api/v1/orders/{orderId}/actions`
+     */
+    queueAction(request: OperationPath<operations["post_v1_orders_by_orderid_actions"]> & OperationBody<operations["post_v1_orders_by_orderid_actions"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["post_v1_orders_by_orderid_actions"]>>;
 }
 declare class OrganizationsClient {
     protected readonly _http: OmniHttp;
@@ -16164,7 +17522,9 @@ declare class ProductsClient {
      *
      * List products for the authenticated organization with optional filters and pagination. Authenticate with an API key or OAuth bearer token. The organization is taken from that credential; do not send `organizationId`.
   
-  Rows are in `items`. Read catalog stock from `items[].stockQuantity`: parent rows already aggregate their non-deleted variants, and virtual bundles use component availability with any manual cap. Null means unknown, not zero. List rows do not contain `inventoryQuantity`, `inventory.quantity`, or an embedded `variants` array.
+  ### Stock and variants
+  
+  Rows are in `items`. Read catalog stock from `items[].stockQuantity`: parent rows already aggregate their non-deleted variants, and virtual bundles use component availability with any manual cap. Null means unknown, not zero. A row with `variantCount` above 0 has variants; fetch them from `GET /api/v1/products/{productId}`. List rows do not contain `inventoryQuantity`, `inventory.quantity`, or an embedded `variants` array.
      *
      * `GET /api/v1/products`
      */
@@ -16209,6 +17569,8 @@ declare class ProductsClient {
   - Localization content and cultural notes
   - Intent queries and signals
   - Sources and claims
+  
+  A parent product returns its variants in `variants`, with each variant's option values, price, stock, image, and marketplace listings.
      *
      * `GET /api/v1/products/{productId}`
      */
@@ -16257,6 +17619,16 @@ declare class ProductsClient {
      * `PATCH /api/v1/products/{productId}/inventory`
      */
     updateInventory(request: OperationPath<operations["patch_v1_products_by_productid_inventory"]> & OperationBody<operations["patch_v1_products_by_productid_inventory"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["patch_v1_products_by_productid_inventory"]>>;
+    /**
+     * Get Product Listings
+     *
+     * Where a product is listed: each marketplace's store, live or delisted state, item id, buyer-facing URL, and the latest publish attempt with any rejection details. Requires `catalog:read`.
+  
+  Poll after `POST /api/v1/products/{productId}/publish`.
+     *
+     * `GET /api/v1/products/{productId}/listings`
+     */
+    getListings(request: OperationPath<operations["get_v1_products_by_productid_listings"]> & OperationQuery<operations["get_v1_products_by_productid_listings"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_products_by_productid_listings"]>>;
     /**
      * Update Product Price
      *
@@ -16431,6 +17803,48 @@ declare class ReturnsClient {
      */
     get(request: OperationPath<operations["get_v1_returns_by_returnid"]> & OperationQuery<operations["get_v1_returns_by_returnid"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_returns_by_returnid"]>>;
 }
+declare class ReviewsClient {
+    protected readonly _http: OmniHttp;
+    constructor(_http: OmniHttp);
+    /**
+     * List Reviews
+     *
+     * List marketplace product reviews, newest first unless `sortBy` says otherwise. Requires `reviews:read`.
+  
+  Use `priority=unreplied` for a reply queue. `replyRestriction` is null when a reply will be accepted.
+     *
+     * `GET /api/v1/reviews`
+     */
+    list(request?: OperationQuery<operations["get_v1_reviews"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_reviews"]>>;
+    /**
+     * Get Review
+     *
+     * Read one review by its OmniCommerce UUID. Requires `reviews:read`.
+     *
+     * `GET /api/v1/reviews/{reviewId}`
+     */
+    get(request: OperationPath<operations["get_v1_reviews_by_reviewid"]> & OperationQuery<operations["get_v1_reviews_by_reviewid"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["get_v1_reviews_by_reviewid"]>>;
+    /**
+     * Draft Review Reply
+     *
+     * Draft a reply with AI from the review, the product, recent replies, and the brand kit. Uses AI credits. Requires `reviews:write`.
+  
+  Nothing is posted; send the text with `POST /api/v1/reviews/actions`.
+     *
+     * `POST /api/v1/reviews/{reviewId}/draft-reply`
+     */
+    draftReply(request: OperationPath<operations["post_v1_reviews_by_reviewid_draft_reply"]> & OperationQuery<operations["post_v1_reviews_by_reviewid_draft_reply"]> & Record<string, unknown>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["post_v1_reviews_by_reviewid_draft_reply"]>>;
+    /**
+     * Act on Reviews
+     *
+     * Reply to up to 50 reviews, or send Amazon review requests for solicitation rows. Requires `reviews:write`.
+  
+  Each target succeeds or fails on its own; read `data.results`. `ok` is true only when every target succeeds.
+     *
+     * `POST /api/v1/reviews/actions`
+     */
+    actions(request: OperationBody<operations["post_v1_reviews_actions"]>, requestOptions?: BaseRequestOptions): HttpResponsePromise<SuccessData<operations["post_v1_reviews_actions"]>>;
+}
 declare class SearchClient {
     protected readonly _http: OmniHttp;
     constructor(_http: OmniHttp);
@@ -16654,6 +18068,7 @@ declare class ZaloraClient {
 declare class OmniGeneratedClient {
     protected readonly _http: OmniHttp;
     readonly agents: AgentsClient;
+    readonly analytics: AnalyticsClient;
     readonly aop: AopClient;
     readonly api: ApiClient;
     readonly campaigns: CampaignsClient;
@@ -16677,6 +18092,7 @@ declare class OmniGeneratedClient {
     readonly products: ProductsClient;
     readonly promotions: PromotionsClient;
     readonly returns: ReturnsClient;
+    readonly reviews: ReviewsClient;
     readonly search: SearchClient;
     readonly settlements: SettlementsClient;
     readonly sync: SyncClient;
@@ -16689,6 +18105,7 @@ declare class OmniGeneratedClient {
 }
 type OmniResources = {
     agents: AgentsClient;
+    analytics: AnalyticsClient;
     aop: AopClient;
     api: ApiClient;
     campaigns: CampaignsClient;
@@ -16712,6 +18129,7 @@ type OmniResources = {
     products: ProductsClient;
     promotions: PromotionsClient;
     returns: ReturnsClient;
+    reviews: ReviewsClient;
     search: SearchClient;
     settlements: SettlementsClient;
     sync: SyncClient;
@@ -16763,7 +18181,7 @@ declare function constructEvent(payload: string | Uint8Array, headers: WebhookHe
     toleranceInSeconds?: number;
 }): Promise<ConstructedWebhookEvent>;
 
-declare const SDK_VERSION = "0.2.0";
+declare const SDK_VERSION = "0.3.0";
 
 type ProductCreatedWebhookEvent = components["schemas"]["ProductCreatedWebhookEvent"];
 type ProductUpdatedWebhookEvent = components["schemas"]["ProductUpdatedWebhookEvent"];