@blezgo/api-sdk 0.1.0

package/dist/user/generated.d.ts

@@ -0,0 +1,4350 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/v1/users/admin": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Users
+         * @description Get paginated list of users with filtering and search.
+         *
+         *     **For**: Admin users managing organization users
+         *     **Purpose**: Lists all users in the organization with filtering options
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        get: operations["listUsers"];
+        put?: never;
+        /**
+         * Create User
+         * @description Create a new user account.
+         *
+         *     **For**: Admin users adding new users to the organization
+         *     **Purpose**: Creates a new user with specified role and permissions
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        post: operations["createUser"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/admin/{user_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get User Details
+         * @description Get detailed information about a specific user.
+         *
+         *     **For**: Admin users viewing detailed user information
+         *     **Purpose**: Retrieves complete user profile and settings
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        get: operations["getUser"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete User
+         * @description Delete a user.
+         *
+         *     **For**: Admin users removing users from the organization
+         *     **Purpose**: Soft deletes (default) or permanently removes a user
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        delete: operations["deleteUser"];
+        options?: never;
+        head?: never;
+        /**
+         * Update User
+         * @description Update user information.
+         *
+         *     **For**: Admin users updating user profiles
+         *     **Purpose**: Updates user profile information (not including password or role)
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        patch: operations["updateUser"];
+        trace?: never;
+    };
+    "/v1/users/admin/{user_id}/blocks": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Block User
+         * @description Block a user account.
+         *
+         *     **For**: Admin users blocking problematic users
+         *     **Purpose**: Disables user access and optionally notifies them
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        post: operations["blockUser"];
+        /**
+         * Unblock User
+         * @description Unblock a user account.
+         *
+         *     **For**: Admin users restoring blocked user access
+         *     **Purpose**: Re-enables user access and resets login attempts
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        delete: operations["unblockUser"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/admin/{user_id}/email-verifications": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Verify Email
+         * @description Manually verify user email.
+         *
+         *     **For**: Admin users manually verifying user emails
+         *     **Purpose**: Marks user email as verified without requiring verification link
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        post: operations["verifyUserEmail"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/admin/{user_id}/mobile-verifications": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Verify Mobile
+         * @description Manually verify user mobile.
+         *
+         *     **For**: Admin users manually verifying user mobile numbers
+         *     **Purpose**: Marks user mobile as verified without requiring OTP
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        post: operations["verifyUserMobile"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/admin/{user_id}/role": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Change Role
+         * @description Change user role.
+         *
+         *     **For**: Admin users managing user roles and permissions
+         *     **Purpose**: Updates user role and associated permissions in org_users_tbl, roles_tbl, access_layer_tbl, and user_access_layer_tbl
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        patch: operations["updateUserRole"];
+        trace?: never;
+    };
+    "/v1/users/admin/{user_id}/password-resets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Reset Password
+         * @description Reset user password.
+         *
+         *     **For**: Admin users resetting user passwords
+         *     **Purpose**: Administratively sets a new password for a user
+         *
+         *     **Authentication**: Required (JWT token with user.manage.all permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        post: operations["resetUserPassword"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/admin/{user_id}/permissions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get User Permissions
+         * @description Get user's effective permissions (resolved from role + overrides).
+         *
+         *     **For**: Admin users debugging permission issues
+         *     **Purpose**: View user's final resolved permissions (role + overrides)
+         *
+         *     **Response Example**:
+         *     ```json
+         *     {
+         *         "status": "success",
+         *         "data": {
+         *             "user_id": 789,
+         *             "role": {"role_id": "role_teacher_123", "role_name": "Teacher"},
+         *             "permissions": {
+         *                 "course": {"view": ["all"], "create": ["own"], "edit": ["own"]},
+         *                 "user": {"view": ["own"]}
+         *             },
+         *             "overrides": [
+         *                 {
+         *                     "override_id": "uacl_abc123",
+         *                     "permissions": {"course": {"delete": ["all"]}},
+         *                     "is_active": true,
+         *                     "expires_at": "2026-03-01T00:00:00Z"
+         *                 }
+         *             ],
+         *             "final_permissions": {
+         *                 "course": {"view": ["all"], "create": ["own"], "edit": ["own"], "delete": ["all"]},
+         *                 "user": {"view": ["own"]}
+         *             }
+         *         }
+         *     }
+         *     ```
+         *
+         *     **Use Cases**:
+         *     - Debugging: Why does user have/not have specific permission?
+         *     - Audit: What can this user actually do?
+         *     - Support: Help user understand their access level
+         *
+         *     **Authentication**: Required (JWT token with user_permission.view.all permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Permissions**: user_permission.view.all
+         */
+        get: operations["listUserPermissions"];
+        put?: never;
+        /**
+         * Grant Permission Override
+         * @description Grant permission override to a specific user (RBAC v2.1).
+         *
+         *     **For**: Admin users granting temporary or permanent permission overrides
+         *     **Purpose**: Override user's role permissions (highest precedence in permission resolution)
+         *
+         *     **Example Request Body**:
+         *     ```json
+         *     {
+         *         "target_user_id": 789,
+         *         "permissions": {
+         *             "course": {"delete": ["all"]},
+         *             "user": {"view": ["all"]}
+         *         },
+         *         "override_reason": "Temporary admin access for Q4 cleanup project",
+         *         "expires_at": "2026-03-01T00:00:00Z"
+         *     }
+         *     ```
+         *
+         *     **Use Cases**:
+         *     - Temporary elevated permissions for specific projects
+         *     - Emergency admin access grants
+         *     - User-specific permission restrictions
+         *
+         *     **Permission Resolution** (highest to lowest):
+         *     1. **User Permission Override** ← This endpoint
+         *     2. Role Access Layer
+         *     3. Platform Default
+         *     4. Deny
+         *
+         *     **Authentication**: Required (JWT token with user_permission.grant.all permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Permissions**: user_permission.grant.all
+         */
+        post: operations["createUserPermission"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/admin/{user_id}/permissions/{override_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Revoke Permission Override
+         * @description Revoke user's permission override (revert to role permissions).
+         *
+         *     **For**: Admin users removing permission overrides
+         *     **Purpose**: Remove user-specific permission override, user reverts to role permissions
+         *
+         *     **Path Parameters**:
+         *     - user_id: Target user's internal ID
+         *     - override_id: Override external ID (uacl_xxx)
+         *
+         *     **Query Parameters**:
+         *     - reason: Optional reason for revocation (for audit log)
+         *
+         *     **Use Cases**:
+         *     - Project completed, remove temporary elevated access
+         *     - Emergency access no longer needed
+         *     - Revoke mistakenly granted permissions
+         *
+         *     **Note**: Soft delete for recoverability, audit log entry created
+         *
+         *     **Authentication**: Required (JWT token with user_permission.revoke.all permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Permissions**: user_permission.revoke.all
+         */
+        delete: operations["deleteUserPermission"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/admin/bulk-registrations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Bulk Register Users
+         * @description Register multiple users at once.
+         *
+         *     **For**: Admin users creating multiple user accounts in bulk
+         *     **Purpose**: Creates multiple user accounts with passwords
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        post: operations["bulkRegisterUsers"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/admin/bulk-updates": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Bulk Update Users
+         * @description Update multiple users at once.
+         *
+         *     **For**: Admin users updating multiple users with same data
+         *     **Purpose**: Applies same updates to multiple users
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        post: operations["bulkUpdateUsers"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/admin/bulk-deletions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Bulk Delete Users
+         * @description Delete multiple users at once.
+         *
+         *     **For**: Admin users removing multiple users
+         *     **Purpose**: Deletes multiple users (soft or hard delete)
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        post: operations["bulkDeleteUsers"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/users/admin/stats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get User Stats
+         * @description Get user statistics for the organization.
+         *
+         *     **For**: Admin users viewing dashboard metrics
+         *     **Purpose**: Provides overview statistics of users in the organization
+         *
+         *     **Authentication**: Required (JWT token with api_access permission)
+         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         */
+        get: operations["getUserStats"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /** BulkRegisterUser */
+        BulkRegisterUser: {
+            /**
+             * Email
+             * Format: email
+             */
+            email: string;
+            /** Password */
+            password: string;
+            /** First Name */
+            first_name: string;
+            /** Last Name */
+            last_name?: string | null;
+            /**
+             * Role Id
+             * @description Role ID for the user
+             */
+            role_id: number;
+            /** Mobile Isd Code */
+            mobile_isd_code?: string | null;
+            /** Mobile No */
+            mobile_no?: string | null;
+        };
+        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;
+        };
+        /** AddUserRequest */
+        AddUserRequest: {
+            /**
+             * Email
+             * Format: email
+             */
+            email: string;
+            /** Password */
+            password: string;
+            /** Confirm Password */
+            confirm_password: string;
+            /** First Name */
+            first_name: string;
+            /** Last Name */
+            last_name?: string | null;
+            /** Username */
+            username?: string | null;
+            /**
+             * Role Id
+             * @description Role ID for the user
+             */
+            role_id: number;
+            /** Mobile Isd Code */
+            mobile_isd_code?: string | null;
+            /** Mobile No */
+            mobile_no?: string | null;
+            /**
+             * Timezone
+             * @default UTC
+             */
+            timezone: string | null;
+            /**
+             * Preferred Language
+             * @default en-US
+             */
+            preferred_language: string | null;
+            /**
+             * Send Welcome Email
+             * @default true
+             */
+            send_welcome_email: boolean | null;
+        };
+        /**
+         * @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;
+        };
+        /** BulkRegisterRequest */
+        BulkRegisterRequest: {
+            /** Users */
+            users: components["schemas"]["BulkRegisterUser"][];
+            /**
+             * Send Welcome Email
+             * @default true
+             */
+            send_welcome_email: boolean | null;
+        };
+        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"];
+        };
+        /** BlockUserRequest */
+        BlockUserRequest: {
+            /** Reason */
+            reason?: string | null;
+            /**
+             * Notify User
+             * @default false
+             */
+            notify_user: boolean | null;
+        };
+        /** BulkDeleteRequest */
+        BulkDeleteRequest: {
+            /** User Ids */
+            user_ids: number[];
+            /**
+             * Soft Delete
+             * @default true
+             */
+            soft_delete: boolean | null;
+        };
+        /** UpdateUserRequest */
+        UpdateUserRequest: {
+            /** First Name */
+            first_name?: string | null;
+            /** Last Name */
+            last_name?: string | null;
+            /** Username */
+            username?: string | null;
+            /** Mobile Isd Code */
+            mobile_isd_code?: string | null;
+            /** Mobile No */
+            mobile_no?: string | null;
+            /** Timezone */
+            timezone?: string | null;
+            /** Preferred Language */
+            preferred_language?: string | null;
+            /** Address1 */
+            address1?: string | null;
+            /** Address2 */
+            address2?: string | null;
+            /** City */
+            city?: string | null;
+            /** State */
+            state?: string | null;
+            /** Country */
+            country?: string | null;
+            /** Zip */
+            zip?: string | null;
+        };
+        /** ResetPasswordRequest */
+        ResetPasswordRequest: {
+            /** New Password */
+            new_password: string;
+            /**
+             * Send Email
+             * @default true
+             */
+            send_email: boolean | null;
+        };
+        /** BulkUpdateRequest */
+        BulkUpdateRequest: {
+            /** User Ids */
+            user_ids: number[];
+            updates: components["schemas"]["UpdateUserRequest"];
+        };
+        /** ChangeUserRoleRequest */
+        ChangeUserRoleRequest: {
+            /**
+             * Role Id
+             * @description New role ID for the user
+             */
+            role_id: number;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    listUsers: {
+        parameters: {
+            query?: {
+                /** @description Search by name, email, username */
+                query?: string | null;
+                /** @description Filter by role ID */
+                role_id?: number | null;
+                /** @description Filter by status: active, blocked, inactive */
+                status?: string | null;
+                /** @description Filter by email verification status */
+                email_verified?: boolean | null;
+                /** @description Filter by mobile verification status */
+                mobile_verified?: boolean | null;
+                /** @description Sort field: created, name, email */
+                sort_by?: string | null;
+                /** @description Sort order: asc, desc */
+                order?: 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": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    createUser: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AddUserRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    getUser: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    deleteUser: {
+        parameters: {
+            query?: {
+                /** @description Soft delete (default) or hard delete */
+                soft_delete?: boolean;
+            };
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    updateUser: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateUserRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    blockUser: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BlockUserRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    unblockUser: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    verifyUserEmail: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    verifyUserMobile: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    updateUserRole: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ChangeUserRoleRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    resetUserPassword: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ResetPasswordRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    listUserPermissions: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    createUserPermission: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    deleteUserPermission: {
+        parameters: {
+            query?: {
+                /** @description Reason for revocation */
+                reason?: string | null;
+            };
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                user_id: number;
+                override_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    bulkRegisterUsers: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BulkRegisterRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    bulkUpdateUsers: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BulkUpdateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    bulkDeleteUsers: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BulkDeleteRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    getUserStats: {
+        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": unknown;
+                };
+            };
+            /** @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