@blezgo/api-sdk 0.1.0 → 0.1.1

package/dist/activity/generated.d.ts

@@ -0,0 +1,1754 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/v1/search/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get User Search History
+         * @description Get logged-in user's recent search history.
+         *
+         *     **For**: Authenticated users
+         *     **Purpose**: Retrieve personal search history with pagination
+         *
+         *     **Query Parameters**:
+         *     - page: Page number (default: 1)
+         *     - limit: Results per page (default: 20, max: 100)
+         *     - context: Filter by context (teachers, courses, etc.)
+         *
+         *     **Authentication**: Required (JWT token)
+         *     **Headers**: X-Api-Key, Authorization
+         */
+        get: operations["getUserSearchHistory"];
+        put?: never;
+        post?: never;
+        /**
+         * Clear Search History
+         * @description Clear all search history for the authenticated user.
+         *
+         *     **For**: Authenticated users
+         *     **Purpose**: Delete all personal search history
+         *
+         *     **Authentication**: Required (JWT token)
+         *     **Headers**: X-Api-Key, Authorization
+         */
+        delete: operations["clearSearchHistory"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/search/history/{search_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete Search History Item
+         * @description Delete a specific search history item.
+         *
+         *     **For**: Authenticated users
+         *     **Purpose**: Remove a single search from history
+         *
+         *     **Authentication**: Required (JWT token)
+         *     **Headers**: X-Api-Key, Authorization
+         */
+        delete: operations["deleteSearchHistoryItem"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/search/click": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Log Search Click
+         * @description Log a click on a search result (for CTR analytics).
+         *
+         *     **For**: All users (authenticated and guests)
+         *     **Purpose**: Track which search results users click on
+         *
+         *     **Example Request Body**:
+         *     ```json
+         *     {
+         *         "search_id": 12345,
+         *         "doc_id": "teacher_789",
+         *         "doc_type": "teacher",
+         *         "position": 3
+         *     }
+         *     ```
+         *
+         *     **Authentication**: Optional (works for both logged-in and guest users)
+         *     **Headers**: X-Api-Key, Authorization (optional), X-Guest-Session-ID (for guests)
+         */
+        post: operations["logSearchClick"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/search/saved-queries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get User Saved Queries
+         * @description Get user's saved search queries.
+         *
+         *     **For**: Authenticated users
+         *     **Purpose**: Retrieve all saved/favorite searches
+         *
+         *     **Authentication**: Required (JWT token)
+         *     **Headers**: X-Api-Key, Authorization
+         */
+        get: operations["getUserSavedQueries"];
+        put?: never;
+        /**
+         * Create Saved Query
+         * @description Create a saved search query.
+         *
+         *     **For**: Authenticated users
+         *     **Purpose**: Save a search for quick access or alerts
+         *
+         *     **Example Request Body**:
+         *     ```json
+         *     {
+         *         "name": "Python Teachers in NY",
+         *         "context": "teachers",
+         *         "query_text": "python programming",
+         *         "filters": {"city": "New York"},
+         *         "enable_alerts": true,
+         *         "alert_frequency": "daily"
+         *     }
+         *     ```
+         *
+         *     **Authentication**: Required (JWT token)
+         *     **Headers**: X-Api-Key, Authorization
+         */
+        post: operations["createSavedQuery"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/search/saved-queries/{query_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete Saved Query
+         * @description Delete a saved search query.
+         *
+         *     **For**: Authenticated users
+         *     **Purpose**: Remove a saved search
+         *
+         *     **Authentication**: Required (JWT token)
+         *     **Headers**: X-Api-Key, Authorization
+         */
+        delete: operations["deleteSavedQuery"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /**
+         * @example {
+         *       "status": "success",
+         *       "message": "Operation successful",
+         *       "message_code": "api_suc_20001",
+         *       "data": {},
+         *       "metadata": {
+         *         "timestamp": "2026-03-26T10:00:00.000Z",
+         *         "requestId": "07e22004-cb60-4dfc-bc9c-b6f99664dca1",
+         *         "traceId": "a9f1204c-bb82-41de-b234-7c3a9e120000",
+         *         "version": "v1",
+         *         "executionTime": 42,
+         *         "language": "en-US"
+         *       }
+         *     }
+         */
+        StandardResponse: {
+            /** @example success */
+            status?: string;
+            data?: Record<string, never> | null;
+            /** @example Operation successful */
+            message?: string | null;
+            /** @example api_suc_20001 */
+            message_code?: string | null;
+            metadata?: Record<string, never> | null;
+            error?: components["schemas"]["ErrorResponse"];
+        };
+        InvalidParam: {
+            /** @example items[0].quantity */
+            field?: string;
+            /** @example Input should be greater than or equal to 1 */
+            error?: string;
+        };
+        /**
+         * SavedQueryCreateRequest
+         * @description Request model for creating a saved search query.
+         * @example {
+         *       "alert_frequency": "daily",
+         *       "context": "teachers",
+         *       "enable_alerts": true,
+         *       "filters": {
+         *         "city": "New York",
+         *         "subject": "Programming"
+         *       },
+         *       "name": "Python Teachers in New York",
+         *       "query_text": "python programming"
+         *     }
+         */
+        SavedQueryCreateRequest: {
+            /**
+             * Name
+             * @description Name for the saved search
+             */
+            name: string;
+            /**
+             * Context
+             * @description Search context (teachers, courses, etc.)
+             */
+            context: string;
+            /**
+             * Query Text
+             * @description Search query text
+             */
+            query_text?: string | null;
+            /**
+             * Filters
+             * @description Applied filters
+             */
+            filters?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Sort By
+             * @description Sort field
+             */
+            sort_by?: string | null;
+            /**
+             * Enable Alerts
+             * @description Enable alerts for new results
+             * @default false
+             */
+            enable_alerts: boolean;
+            /**
+             * Alert Frequency
+             * @description Alert frequency (instant, daily, weekly)
+             */
+            alert_frequency?: string | null;
+        };
+        /**
+         * SearchClickRequest
+         * @description Request model for logging a click on a search result.
+         * @example {
+         *       "doc_id": "teacher_789",
+         *       "doc_type": "teacher",
+         *       "position": 3,
+         *       "search_id": 12345
+         *     }
+         */
+        SearchClickRequest: {
+            /**
+             * Search Id
+             * @description Search history ID
+             */
+            search_id: number;
+            /**
+             * Doc Id
+             * @description Document ID that was clicked
+             */
+            doc_id: string;
+            /**
+             * Doc Type
+             * @description Document type (teacher, course, user, etc.)
+             */
+            doc_type: string;
+            /**
+             * Position
+             * @description Position in search results (1-based)
+             */
+            position: number;
+        };
+        ErrorResponse: {
+            /** @example about:blank */
+            type?: string;
+            /** @example GENERIC_ERROR */
+            code?: string;
+            /** @example Client Error */
+            title?: string;
+            /** @example 400 */
+            status?: number;
+            /** @example An error occurred */
+            detail?: string;
+            /** @example /v1/cart/items */
+            instance?: string;
+            extensions?: components["schemas"]["Extensions"];
+        };
+        Extensions: {
+            /** @example GENERIC_ERROR */
+            message_code?: string;
+            /** @example [] */
+            invalid_params?: components["schemas"]["InvalidParam"][];
+            extra_data?: Record<string, never> | null;
+            /** @example Detailed debug information */
+            debug?: string | null;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    getUserSearchHistory: {
+        parameters: {
+            query?: {
+                /** @description Filter by context (teachers, courses, etc.) */
+                context?: string | null;
+                /** @description Page number (1-based) */
+                page?: number;
+                /** @description Items per page (1–100, default 20) */
+                limit?: number;
+            };
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    clearSearchHistory: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    deleteSearchHistoryItem: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                search_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    logSearchClick: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+                "X-Guest-Session-ID"?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SearchClickRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    getUserSavedQueries: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    createSavedQuery: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SavedQueryCreateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    deleteSavedQuery: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                query_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+}
+//# sourceMappingURL=generated.d.ts.map