@sonic-commerce/storefront-types 0.11.0

package/dist/schema.d.ts

@@ -0,0 +1,3876 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+    "/products": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List products
+         * @description Filter, sort, search and expand. `price` sorts and filters resolve against the store's default currency, in minor units.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description Free-text search term. */
+                    q?: string;
+                    /** @description ISO 4217 code to price against, e.g. `CAD`. Must be one the store supports. Defaults to the store's default currency. */
+                    currency?: string;
+                    /** @description Comma-separated sort fields, `-` prefix for descending (e.g. `-created_at,title`). Allowed: title, created_at, updated_at, price. */
+                    sort?: string;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Comma-separated fields to return. Omitted fields are absent from the response. */
+                    fields?: string;
+                    /** @description Filter by category_id. A comma-separated list matches any value; the literal `null` matches rows where category_id is unset. */
+                    category_id?: string;
+                    /** @description Filter where category_id is not equal to the given value. */
+                    "category_id[ne]"?: string;
+                    /** @description Filter by collection_id. A comma-separated list matches any value; the literal `null` matches rows where collection_id is unset. */
+                    collection_id?: string;
+                    /** @description Filter where collection_id is not equal to the given value. */
+                    "collection_id[ne]"?: string;
+                    /** @description Filter by handle. A comma-separated list matches any value; the literal `null` matches rows where handle is unset. */
+                    handle?: string;
+                    /** @description Filter where handle is not equal to the given value. */
+                    "handle[ne]"?: string;
+                    /** @description Filter where handle is case-insensitive substring match the given value. */
+                    "handle[like]"?: string;
+                    /** @description Filter by tag. A comma-separated list matches any value; the literal `null` matches rows where tag is unset. */
+                    tag?: string;
+                    /** @description Filter where tag is not equal to the given value. */
+                    "tag[ne]"?: string;
+                    /** @description Filter by type. A comma-separated list matches any value; the literal `null` matches rows where type is unset. */
+                    type?: string;
+                    /** @description Filter where type is not equal to the given value. */
+                    "type[ne]"?: string;
+                    /** @description Filter by price. A comma-separated list matches any value; the literal `null` matches rows where price is unset. */
+                    price?: string;
+                    /** @description Filter where price is not equal to the given value. */
+                    "price[ne]"?: number;
+                    /** @description Filter where price is greater than the given value. */
+                    "price[gt]"?: number;
+                    /** @description Filter where price is greater than or equal to the given value. */
+                    "price[gte]"?: number;
+                    /** @description Filter where price is less than the given value. */
+                    "price[lt]"?: number;
+                    /** @description Filter where price is less than or equal to the given value. */
+                    "price[lte]"?: number;
+                    /** @description Filter by in_stock. A comma-separated list matches any value; the literal `null` matches rows where in_stock is unset. */
+                    in_stock?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["ProductListItem"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/products/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Search products (deprecated)
+         * @deprecated
+         * @description Alias of `GET /products`. Use `/products?q=`. Removed at 1.0.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description Free-text search term. */
+                    q?: string;
+                    /** @description ISO 4217 code to price against, e.g. `CAD`. Must be one the store supports. Defaults to the store's default currency. */
+                    currency?: string;
+                    /** @description Comma-separated sort fields, `-` prefix for descending (e.g. `-created_at,title`). Allowed: title, created_at, updated_at, price. */
+                    sort?: string;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Comma-separated fields to return. Omitted fields are absent from the response. */
+                    fields?: string;
+                    /** @description Filter by category_id. A comma-separated list matches any value; the literal `null` matches rows where category_id is unset. */
+                    category_id?: string;
+                    /** @description Filter where category_id is not equal to the given value. */
+                    "category_id[ne]"?: string;
+                    /** @description Filter by collection_id. A comma-separated list matches any value; the literal `null` matches rows where collection_id is unset. */
+                    collection_id?: string;
+                    /** @description Filter where collection_id is not equal to the given value. */
+                    "collection_id[ne]"?: string;
+                    /** @description Filter by handle. A comma-separated list matches any value; the literal `null` matches rows where handle is unset. */
+                    handle?: string;
+                    /** @description Filter where handle is not equal to the given value. */
+                    "handle[ne]"?: string;
+                    /** @description Filter where handle is case-insensitive substring match the given value. */
+                    "handle[like]"?: string;
+                    /** @description Filter by tag. A comma-separated list matches any value; the literal `null` matches rows where tag is unset. */
+                    tag?: string;
+                    /** @description Filter where tag is not equal to the given value. */
+                    "tag[ne]"?: string;
+                    /** @description Filter by type. A comma-separated list matches any value; the literal `null` matches rows where type is unset. */
+                    type?: string;
+                    /** @description Filter where type is not equal to the given value. */
+                    "type[ne]"?: string;
+                    /** @description Filter by price. A comma-separated list matches any value; the literal `null` matches rows where price is unset. */
+                    price?: string;
+                    /** @description Filter where price is not equal to the given value. */
+                    "price[ne]"?: number;
+                    /** @description Filter where price is greater than the given value. */
+                    "price[gt]"?: number;
+                    /** @description Filter where price is greater than or equal to the given value. */
+                    "price[gte]"?: number;
+                    /** @description Filter where price is less than the given value. */
+                    "price[lt]"?: number;
+                    /** @description Filter where price is less than or equal to the given value. */
+                    "price[lte]"?: number;
+                    /** @description Filter by in_stock. A comma-separated list matches any value; the literal `null` matches rows where in_stock is unset. */
+                    in_stock?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["ProductListItem"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/products/{handle}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a product by handle
+         * @description Expands `variants` and `options` unless `expand` narrows the response.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description ISO 4217 code to price against, e.g. `CAD`. Must be one the store supports. Defaults to the store's default currency. */
+                    currency?: string;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Comma-separated fields to return. Omitted fields are absent from the response. */
+                    fields?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Product handle (URL slug). */
+                    handle: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Product"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/products/id/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a product by id
+         * @description For clients holding an id from a cart or an order.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description ISO 4217 code to price against, e.g. `CAD`. Must be one the store supports. Defaults to the store's default currency. */
+                    currency?: string;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Comma-separated fields to return. Omitted fields are absent from the response. */
+                    fields?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Product id. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Product"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/products/{handle}/variants": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List a product's variants */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Product handle (URL slug). */
+                    handle: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["ProductVariant"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/products/{handle}/related": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List related products
+         * @description Products sharing a category with this one, newest first, capped at 12.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Product handle (URL slug). */
+                    handle: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["ProductListItem"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/categories": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List categories
+         * @description Active, non-internal categories only. `parent_id=null` returns roots.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description Free-text search term. */
+                    q?: string;
+                    /** @description Comma-separated sort fields, `-` prefix for descending (e.g. `-created_at,title`). Allowed: name, rank, handle. */
+                    sort?: string;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Comma-separated fields to return. Omitted fields are absent from the response. */
+                    fields?: string;
+                    /** @description Filter by parent_id. A comma-separated list matches any value; the literal `null` matches rows where parent_id is unset. */
+                    parent_id?: string;
+                    /** @description Filter where parent_id is not equal to the given value. */
+                    "parent_id[ne]"?: string;
+                    /** @description Filter by handle. A comma-separated list matches any value; the literal `null` matches rows where handle is unset. */
+                    handle?: string;
+                    /** @description Filter where handle is not equal to the given value. */
+                    "handle[ne]"?: string;
+                    /** @description Filter where handle is case-insensitive substring match the given value. */
+                    "handle[like]"?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Category"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/categories/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Search categories (deprecated)
+         * @deprecated
+         * @description Alias of `GET /categories`. Use `/categories?q=`. Removed at 1.0.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description Free-text search term. */
+                    q?: string;
+                    /** @description Comma-separated sort fields, `-` prefix for descending (e.g. `-created_at,title`). Allowed: name, rank, handle. */
+                    sort?: string;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Comma-separated fields to return. Omitted fields are absent from the response. */
+                    fields?: string;
+                    /** @description Filter by parent_id. A comma-separated list matches any value; the literal `null` matches rows where parent_id is unset. */
+                    parent_id?: string;
+                    /** @description Filter where parent_id is not equal to the given value. */
+                    "parent_id[ne]"?: string;
+                    /** @description Filter by handle. A comma-separated list matches any value; the literal `null` matches rows where handle is unset. */
+                    handle?: string;
+                    /** @description Filter where handle is not equal to the given value. */
+                    "handle[ne]"?: string;
+                    /** @description Filter where handle is case-insensitive substring match the given value. */
+                    "handle[like]"?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Category"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/categories/tree": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the category tree
+         * @description The full nested menu in one request. Unpaginated; nesting is capped at 8 levels.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["CategoryTreeNode"][];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/categories/{idOrHandle}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a category
+         * @description Accepts either the category id or its handle.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Comma-separated fields to return. Omitted fields are absent from the response. */
+                    fields?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Category id or handle (URL slug). */
+                    idOrHandle: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Category"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/categories/{idOrHandle}/products": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List a category's products
+         * @description The full product query grammar, scoped to this category. `category_id` may be sent as well to narrow further.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description Free-text search term. */
+                    q?: string;
+                    /** @description ISO 4217 code to price against, e.g. `CAD`. Must be one the store supports. Defaults to the store's default currency. */
+                    currency?: string;
+                    /** @description Comma-separated sort fields, `-` prefix for descending (e.g. `-created_at,title`). Allowed: title, created_at, updated_at, price. */
+                    sort?: string;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Comma-separated fields to return. Omitted fields are absent from the response. */
+                    fields?: string;
+                    /** @description Filter by category_id. A comma-separated list matches any value; the literal `null` matches rows where category_id is unset. */
+                    category_id?: string;
+                    /** @description Filter where category_id is not equal to the given value. */
+                    "category_id[ne]"?: string;
+                    /** @description Filter by collection_id. A comma-separated list matches any value; the literal `null` matches rows where collection_id is unset. */
+                    collection_id?: string;
+                    /** @description Filter where collection_id is not equal to the given value. */
+                    "collection_id[ne]"?: string;
+                    /** @description Filter by handle. A comma-separated list matches any value; the literal `null` matches rows where handle is unset. */
+                    handle?: string;
+                    /** @description Filter where handle is not equal to the given value. */
+                    "handle[ne]"?: string;
+                    /** @description Filter where handle is case-insensitive substring match the given value. */
+                    "handle[like]"?: string;
+                    /** @description Filter by tag. A comma-separated list matches any value; the literal `null` matches rows where tag is unset. */
+                    tag?: string;
+                    /** @description Filter where tag is not equal to the given value. */
+                    "tag[ne]"?: string;
+                    /** @description Filter by type. A comma-separated list matches any value; the literal `null` matches rows where type is unset. */
+                    type?: string;
+                    /** @description Filter where type is not equal to the given value. */
+                    "type[ne]"?: string;
+                    /** @description Filter by price. A comma-separated list matches any value; the literal `null` matches rows where price is unset. */
+                    price?: string;
+                    /** @description Filter where price is not equal to the given value. */
+                    "price[ne]"?: number;
+                    /** @description Filter where price is greater than the given value. */
+                    "price[gt]"?: number;
+                    /** @description Filter where price is greater than or equal to the given value. */
+                    "price[gte]"?: number;
+                    /** @description Filter where price is less than the given value. */
+                    "price[lt]"?: number;
+                    /** @description Filter where price is less than or equal to the given value. */
+                    "price[lte]"?: number;
+                    /** @description Filter by in_stock. A comma-separated list matches any value; the literal `null` matches rows where in_stock is unset. */
+                    in_stock?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Category id or handle (URL slug). */
+                    idOrHandle: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["ProductListItem"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/collections": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List collections
+         * @description `expand=products` previews the first 20 products of each collection and sets `products_has_more`; page `/collections/{handle}/products` for the rest.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description Free-text search term. */
+                    q?: string;
+                    /** @description Comma-separated sort fields, `-` prefix for descending (e.g. `-created_at,title`). Allowed: title, created_at. */
+                    sort?: string;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Comma-separated fields to return. Omitted fields are absent from the response. */
+                    fields?: string;
+                    /** @description Filter by handle. A comma-separated list matches any value; the literal `null` matches rows where handle is unset. */
+                    handle?: string;
+                    /** @description Filter where handle is not equal to the given value. */
+                    "handle[ne]"?: string;
+                    /** @description Filter where handle is case-insensitive substring match the given value. */
+                    "handle[like]"?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Collection"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/collections/{handle}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a collection by handle */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Comma-separated fields to return. Omitted fields are absent from the response. */
+                    fields?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Collection handle (URL slug). */
+                    handle: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Collection"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/collections/{handle}/products": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List a collection's products
+         * @description The full product query grammar, scoped to this collection. `collection_id` may be sent as well to narrow further.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description Free-text search term. */
+                    q?: string;
+                    /** @description ISO 4217 code to price against, e.g. `CAD`. Must be one the store supports. Defaults to the store's default currency. */
+                    currency?: string;
+                    /** @description Comma-separated sort fields, `-` prefix for descending (e.g. `-created_at,title`). Allowed: title, created_at, updated_at, price. */
+                    sort?: string;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Comma-separated fields to return. Omitted fields are absent from the response. */
+                    fields?: string;
+                    /** @description Filter by category_id. A comma-separated list matches any value; the literal `null` matches rows where category_id is unset. */
+                    category_id?: string;
+                    /** @description Filter where category_id is not equal to the given value. */
+                    "category_id[ne]"?: string;
+                    /** @description Filter by collection_id. A comma-separated list matches any value; the literal `null` matches rows where collection_id is unset. */
+                    collection_id?: string;
+                    /** @description Filter where collection_id is not equal to the given value. */
+                    "collection_id[ne]"?: string;
+                    /** @description Filter by handle. A comma-separated list matches any value; the literal `null` matches rows where handle is unset. */
+                    handle?: string;
+                    /** @description Filter where handle is not equal to the given value. */
+                    "handle[ne]"?: string;
+                    /** @description Filter where handle is case-insensitive substring match the given value. */
+                    "handle[like]"?: string;
+                    /** @description Filter by tag. A comma-separated list matches any value; the literal `null` matches rows where tag is unset. */
+                    tag?: string;
+                    /** @description Filter where tag is not equal to the given value. */
+                    "tag[ne]"?: string;
+                    /** @description Filter by type. A comma-separated list matches any value; the literal `null` matches rows where type is unset. */
+                    type?: string;
+                    /** @description Filter where type is not equal to the given value. */
+                    "type[ne]"?: string;
+                    /** @description Filter by price. A comma-separated list matches any value; the literal `null` matches rows where price is unset. */
+                    price?: string;
+                    /** @description Filter where price is not equal to the given value. */
+                    "price[ne]"?: number;
+                    /** @description Filter where price is greater than the given value. */
+                    "price[gt]"?: number;
+                    /** @description Filter where price is greater than or equal to the given value. */
+                    "price[gte]"?: number;
+                    /** @description Filter where price is less than the given value. */
+                    "price[lt]"?: number;
+                    /** @description Filter where price is less than or equal to the given value. */
+                    "price[lte]"?: number;
+                    /** @description Filter by in_stock. A comma-separated list matches any value; the literal `null` matches rows where in_stock is unset. */
+                    in_stock?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Collection handle (URL slug). */
+                    handle: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["ProductListItem"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/store": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the storefront bootstrap payload
+         * @description Store name, currencies with their minor-unit exponents, and the default region. Call this once before rendering any price. Cacheable for 60 seconds.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Store"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/payment-methods": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the payment providers this store accepts
+         * @description Only providers the merchant has enabled. Each carries the client-side configuration its own SDK needs — a publishable key, a display name — and never anything derived from a secret. Call this before rendering the payment step.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["PaymentMethod"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/regions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List regions
+         * @description Unpaginated — a store has a handful of regions.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Region"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/regions/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a region
+         * @description Includes the region's tax rates.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Region id. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Region"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/currencies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List supported currencies
+         * @description `decimal_digits` is the ISO 4217 minor-unit exponent — every amount on this API is an integer in minor units.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Currency"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/tax-rate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the applicable tax summary
+         * @description `location_id` takes precedence over `region_id`; either falls back to the store default. `configured` is false when no tax rates have been entered — a rate of 0 alone does not mean tax-free.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Resolve tax from this location's region. */
+                    location_id?: string;
+                    /** @description Resolve tax from this region. Ignored if location_id is sent. */
+                    region_id?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["TaxSummary"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/auth/register": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Register a customer
+         * @description Returns a session. An email that already has an account is not reported as taken — the password is checked against it, and a mismatch answers with the same generic credential error as a failed login. A guest record from a previous checkout is upgraded in place, keeping that order history.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RegisterBody"];
+                };
+            };
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["AuthSession"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/auth/login": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Log in
+         * @description Sets the `sonic_token` cookie and returns the same JWT in the body. Cross-origin storefronts should send it as `Authorization: Bearer` rather than relying on the cookie.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["LoginBody"];
+                };
+            };
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["AuthSession"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/auth/logout": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Log out
+         * @description Revokes the session behind the presented token.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid customer credentials. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/auth/me": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get the current customer */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Customer"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid customer credentials. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create a cart
+         * @description Rate limited more tightly than the rest of the API. When the request carries a customer token the cart is bound to that customer and only they may modify it afterwards.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a cart */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}/items": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Add a line item
+         * @description The price is resolved from the catalogue in the cart's currency — a client cannot supply one.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["AddCartItemBody"];
+                };
+            };
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}/items/{itemId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Update a line item */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                    /** @description Line item id. */
+                    itemId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["UpdateCartItemBody"];
+                };
+            };
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        /** Remove a line item */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                    /** @description Line item id. */
+                    itemId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}/customer": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Set the cart's customer */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["SetCartCustomerBody"];
+                };
+            };
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}/shipping-address": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Set the shipping address */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CartAddressBody"];
+                };
+            };
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}/billing-address": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Set the billing address */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CartAddressBody"];
+                };
+            };
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}/region": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Switch the cart's region
+         * @description Re-prices every line in the new region's currency. Rejected in full if any line has no price there — no line is silently dropped or left at the old currency's figure.
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["SetCartRegionBody"];
+                };
+            };
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}/discounts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Apply a discount code
+         * @description A rejection carries the reason (expired, below minimum spend, already used). One incentive per cart: a discount and a gift card cannot both be applied.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CartCodeBody"];
+                };
+            };
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}/discounts/{code}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Remove a discount code */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                    /** @description The applied code. */
+                    code: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}/gift-cards": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Apply a gift card
+         * @description A gift card is a tender: it reduces `amount_due`, never `total`. The balance is only debited at completion.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CartCodeBody"];
+                };
+            };
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}/gift-cards/{code}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Remove a gift card */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                    /** @description The applied code. */
+                    code: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Cart"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/carts/{id}/complete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Complete the cart and place the order
+         * @description Send an `Idempotency-Key` header: a retry returns the first response rather than placing a second order. The resulting order carries no shipping line — shipping is not modelled.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    /** @description Client-generated unique value. Replays return the stored response. */
+                    "Idempotency-Key"?: string;
+                };
+                path: {
+                    /** @description Cart id. */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/sales-channels": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the key's sales channel
+         * @description The single channel the request's publishable key is scoped to. Empty when no key resolves.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["SalesChannel"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/account/orders": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the customer's orders
+         * @description Scoped to the authenticated customer by the query itself.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description 1-based page number. */
+                    page?: number;
+                    /** @description Rows per page. Values above 100 are rejected, not clamped. */
+                    limit?: number;
+                    /** @description Comma-separated sort fields, `-` prefix for descending (e.g. `-created_at,title`). Allowed: created_at, total. */
+                    sort?: string;
+                    /** @description Comma-separated relations to include. Expanded relations appear as additional optional properties on the response; OpenAPI cannot express a response shape that varies by request. */
+                    expand?: string;
+                    /** @description Filter by status. A comma-separated list matches any value; the literal `null` matches rows where status is unset. */
+                    status?: string;
+                    /** @description Filter where status is not equal to the given value. */
+                    "status[ne]"?: string;
+                    /** @description Filter where status is case-insensitive substring match the given value. */
+                    "status[like]"?: string;
+                    /** @description Filter by created_at. A comma-separated list matches any value; the literal `null` matches rows where created_at is unset. */
+                    created_at?: string;
+                    /** @description Filter where created_at is not equal to the given value. */
+                    "created_at[ne]"?: string;
+                    /** @description Filter where created_at is greater than the given value. */
+                    "created_at[gt]"?: string;
+                    /** @description Filter where created_at is greater than or equal to the given value. */
+                    "created_at[gte]"?: string;
+                    /** @description Filter where created_at is less than the given value. */
+                    "created_at[lt]"?: string;
+                    /** @description Filter where created_at is less than or equal to the given value. */
+                    "created_at[lte]"?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["OrderListItem"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid customer credentials. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/account/orders/{orderId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get one order
+         * @description 404s identically whether the order is absent or belongs to someone else. Expands `items` and `shipping_address` by default.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Order id. */
+                    orderId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Order"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid customer credentials. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/account/orders/{orderId}/invoice": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get an order's invoice payload
+         * @description Data, not a rendered document. `tax_lines` are the per-rate figures frozen at placement; an empty list with `tax_lines_available: false` means the order predates that write path, not that no tax was charged.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Order id. */
+                    orderId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid customer credentials. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/account/orders/{orderId}/returns": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Request a return
+         * @description Every requested line is checked against this order's own items and remaining returnable quantity.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Order id. */
+                    orderId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["CreateReturnBody"];
+                };
+            };
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Return"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid customer credentials. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/account/returns": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List the customer's returns */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Return"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid customer credentials. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/account/addresses/{addressId}/default": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Set the default billing address */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Address id. */
+                    addressId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["CustomerAddress"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid customer credentials. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/account/sessions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List active devices
+         * @description `is_current` marks the session making this request.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Session"][];
+                            meta: components["schemas"]["PaginationMeta"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid customer credentials. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/account/sessions/{sessionId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Revoke a device session
+         * @description Revoking the current session logs the customer out.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Session id. */
+                    sessionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid customer credentials. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/account/reward-points": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the reward-points balance
+         * @description 404 when rewards are not enabled for the store.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["RewardPoints"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Missing or invalid customer credentials. */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/orders/track": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Track an order without signing in
+         * @description Requires the order number and the matching email. Answers 404 identically whether the order is absent or the email does not match, so it cannot be used to test which addresses have ordered. Heavily rate limited, and the payload carries status only — no addresses, no totals.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description The order number shown on the confirmation. */
+                    display_id: number;
+                    /** @description The email the order was placed with. */
+                    email: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["OrderTracking"];
+                        };
+                    };
+                };
+                /** @description Invalid request — unknown parameter or bad value. */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+                /** @description Rate limit exceeded. */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        Error: {
+            message: string;
+            /** @description Present on validation failures. */
+            errors?: {
+                path: string;
+                message: string;
+            }[];
+        };
+        PaginationMeta: {
+            /** @description Total matching rows. */
+            count: number;
+            page: number;
+            limit: number;
+            page_count: number;
+        };
+        ProductListItem: {
+            id: string;
+            title?: string | null;
+            subtitle?: string | null;
+            handle?: string | null;
+            description?: string | null;
+            excerpt?: string | null;
+            thumbnail?: string | null;
+            created_at?: string;
+            updated_at?: string;
+        };
+        ProductVariant: {
+            id: string;
+            title: string;
+            sku: string | null;
+            rank: number | null;
+            quantity: number;
+            allow_backorder: boolean;
+            manage_inventory: boolean;
+            options: {
+                id: string;
+                value: string;
+                option_id: string;
+                option_title: string;
+            }[];
+            prices: components["schemas"]["VariantPrice"][];
+        };
+        VariantPrice: {
+            currency_code: string;
+            currency_symbol: string | null;
+            amount: number;
+        };
+        ProductOption: {
+            id: string;
+            title: string;
+            values: {
+                id: string;
+                value: string;
+            }[];
+        };
+        ProductCategory: {
+            id: string;
+            name: string;
+            handle: string;
+        };
+        ProductCollection: {
+            id: string;
+            title: string;
+            handle: string | null;
+        };
+        Product: {
+            id: string;
+            title?: string | null;
+            subtitle?: string | null;
+            handle?: string | null;
+            description?: string | null;
+            excerpt?: string | null;
+            thumbnail?: string | null;
+            created_at?: string;
+            updated_at?: string;
+            variants?: components["schemas"]["ProductVariant"][];
+            options?: components["schemas"]["ProductOption"][];
+            categories?: components["schemas"]["ProductCategory"][];
+            collection?: components["schemas"]["ProductCollection"] | null;
+        };
+        CategorySummary: {
+            id: string;
+            name: string;
+            handle: string;
+        };
+        Category: {
+            id: string;
+            name?: string;
+            handle?: string;
+            description?: string | null;
+            rank?: number;
+            parent_id?: string | null;
+            parent?: components["schemas"]["CategorySummary"] | null;
+            children?: components["schemas"]["CategorySummary"][];
+        };
+        CategoryTreeNode: {
+            id: string;
+            name: string;
+            handle: string;
+            rank: number;
+            children: components["schemas"]["CategoryTreeNode"][];
+        };
+        Collection: {
+            id: string;
+            title?: string;
+            handle?: string | null;
+            created_at?: string;
+            updated_at?: string;
+            products?: components["schemas"]["ProductListItem"][];
+            products_has_more?: boolean;
+        };
+        Currency: {
+            code: string;
+            symbol: string;
+            symbol_native: string;
+            name: string;
+            decimal_digits: number;
+        };
+        RegionSummary: {
+            id: string;
+            title: string;
+            currency_code: string | null;
+        };
+        Store: {
+            id: string;
+            name: string;
+            default_currency: components["schemas"]["Currency"] | null;
+            currencies: components["schemas"]["Currency"][];
+            default_region: components["schemas"]["RegionSummary"] | null;
+            metadata: {
+                [key: string]: unknown;
+            };
+        };
+        Country: {
+            iso_2: string;
+            iso_3: string;
+            name: string;
+            display_name: string;
+        };
+        TaxRate: {
+            id: string;
+            name: string;
+            code: string | null;
+            rate: number;
+        };
+        Region: {
+            id: string;
+            title: string;
+            currency_code: string | null;
+            countries: components["schemas"]["Country"][];
+            tax_rates?: components["schemas"]["TaxRate"][];
+        };
+        TaxSummary: {
+            region_id: string | null;
+            label: string | null;
+            rate: number;
+            configured: boolean;
+            components: {
+                tax_rate_id: string;
+                name: string;
+                code: string | null;
+                rate: number;
+            }[];
+        };
+        SalesChannel: {
+            id: string;
+            name: string;
+            description: string | null;
+        };
+        PaymentMethod: {
+            /** @description Stable provider id, e.g. `stripe`. */
+            key: string;
+            /** @description Display name for the payment step. */
+            name: string;
+            /** @description Client-side configuration for this provider — a publishable key, a display name, instructions. Shape varies by provider. */
+            config: {
+                [key: string]: unknown;
+            };
+        };
+        CartAddress: {
+            id: string;
+            first_name: string | null;
+            last_name: string | null;
+            company: string | null;
+            address_1: string | null;
+            address_2: string | null;
+            city: string | null;
+            province: string | null;
+            postal_code: string | null;
+            phone: string | null;
+        };
+        LineItem: {
+            id: string;
+            title: string;
+            description: string | null;
+            thumbnail: string | null;
+            unit_price: number;
+            quantity: number;
+            subtotal: number;
+            product: {
+                id: string;
+                title: string;
+                handle: string | null;
+            } | null;
+            variant: {
+                id: string;
+                title: string;
+            } | null;
+        };
+        CartDiscount: {
+            id: string;
+            code: string;
+            amount: number;
+        };
+        CartGiftCard: {
+            id: string;
+            code: string;
+            balance: number;
+        };
+        CartTotals: {
+            currency_code: string | null;
+            subtotal: number;
+            discount_total: number;
+            taxable_base: number;
+            tax_total: number;
+            /** @description False when no tax rates are set up for the cart's region. A tax_total of 0 with this false means tax is unknown, not zero. */
+            tax_configured: boolean;
+            /** @description Always null: shipping is not modelled anywhere in this codebase, so no shipping cost can be quoted. Not a zero charge — an absent one. See docs/sales-terminology.md. */
+            shipping_total: null;
+            total: number;
+            gift_card_total: number;
+            amount_due: number;
+        };
+        Cart: {
+            id: string;
+            completed_at: string | null;
+            created_at: string | null;
+            region_id: string | null;
+            customer: {
+                id: string;
+                email: string;
+                first_name: string | null;
+                last_name: string | null;
+            } | null;
+            shipping_address: components["schemas"]["CartAddress"] | null;
+            billing_address: components["schemas"]["CartAddress"] | null;
+            items: components["schemas"]["LineItem"][];
+            discounts: components["schemas"]["CartDiscount"][];
+            gift_cards: components["schemas"]["CartGiftCard"][];
+            totals: components["schemas"]["CartTotals"];
+        };
+        Customer: {
+            id: string;
+            email: string;
+            first_name: string | null;
+            last_name: string | null;
+            phone: string | null;
+        };
+        AuthSession: {
+            customer: components["schemas"]["Customer"];
+            token: string;
+            expires_at: string;
+        };
+        OrderTotals: {
+            currency_code: string | null;
+            subtotal: number;
+            discount_total: number;
+            tax_total: number;
+            tax_lines: components["schemas"]["OrderTaxLine"][];
+            tax_lines_available: boolean;
+            /** @description Always null: shipping is not modelled, so no shipping charge was ever recorded on this order. Not a zero charge — an absent one. */
+            shipping_total: null;
+            total: number;
+        };
+        OrderTaxLine: {
+            name: string;
+            rate: number;
+            amount: number;
+        };
+        OrderItem: {
+            id: string;
+            title: string;
+            description: string | null;
+            thumbnail: string | null;
+            unit_price: number;
+            quantity: number;
+            fulfilled_quantity: number;
+            returned_quantity: number;
+            subtotal: number;
+            product: {
+                id: string;
+                title: string;
+                handle: string | null;
+            } | null;
+            variant: {
+                id: string;
+                title: string;
+            } | null;
+        };
+        CustomerAddress: {
+            id: string;
+            first_name: string | null;
+            last_name: string | null;
+            company: string | null;
+            address_1: string | null;
+            address_2: string | null;
+            city: string | null;
+            province: string | null;
+            postal_code: string | null;
+            country_code: string | null;
+            phone: string | null;
+            is_default_billing: boolean;
+        };
+        Return: {
+            id: string;
+            order_id: string;
+            status: string;
+            refund_amount: number;
+            received_at: string | null;
+            created_at: string | null;
+            items: components["schemas"]["ReturnItem"][];
+        };
+        ReturnItem: {
+            item_id: string;
+            quantity: number;
+            received_quantity: number;
+        };
+        Order: {
+            id: string;
+            display_id: number | null;
+            status: string;
+            fulfillment_status: string | null;
+            payment_status: string | null;
+            created_at: string | null;
+            total?: number;
+            currency_code?: string | null;
+            totals: components["schemas"]["OrderTotals"];
+            items?: components["schemas"]["OrderItem"][];
+            shipping_address?: components["schemas"]["CustomerAddress"] | null;
+            returns?: components["schemas"]["Return"][];
+        };
+        OrderListItem: {
+            id: string;
+            display_id: number | null;
+            status: string;
+            fulfillment_status: string | null;
+            payment_status: string | null;
+            created_at: string | null;
+            total?: number;
+            currency_code?: string | null;
+        };
+        OrderTracking: {
+            display_id: number | null;
+            status: string;
+            fulfillment_status: string | null;
+            created_at: string | null;
+        };
+        Session: {
+            id: string;
+            browser: string | null;
+            os: string | null;
+            ip_address: string | null;
+            location: string | null;
+            country: string | null;
+            last_seen_at: string | null;
+            created_at: string | null;
+            expires_at: string | null;
+            is_current: boolean;
+        };
+        RewardPoints: {
+            balance: number;
+            point_value: number;
+            min_redemption_threshold: number;
+        };
+        RegisterBody: {
+            /** Format: email */
+            email: string;
+            password: string & (unknown & unknown & unknown & unknown);
+            first_name?: string;
+            last_name?: string;
+            phone?: string;
+            turnstile_token?: string;
+        };
+        LoginBody: {
+            /** Format: email */
+            email: string;
+            password: string;
+            turnstile_token?: string;
+        };
+        AddCartItemBody: {
+            product_id: string;
+            variant_id?: string | null;
+            quantity: number;
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        UpdateCartItemBody: {
+            quantity?: number;
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        SetCartCustomerBody: {
+            /** Format: email */
+            email: string;
+            first_name?: string;
+            last_name?: string;
+        };
+        CartAddressBody: {
+            first_name?: string;
+            last_name?: string;
+            company?: string;
+            address_1?: string;
+            address_2?: string;
+            city?: string;
+            province?: string;
+            postal_code?: string;
+            phone?: string;
+            country_code?: string;
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        SetCartRegionBody: {
+            region_id: string;
+        };
+        CartCodeBody: {
+            code: string;
+        };
+        CreateReturnBody: {
+            items: {
+                item_id: string;
+                quantity: number;
+                reason_id?: string;
+            }[];
+            note?: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export type operations = Record<string, never>;