@blezgo/api-sdk 0.1.0

package/dist/account/generated.d.ts

@@ -0,0 +1,2648 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/v1/me": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Me
+         * @description Get the authenticated user's identity and access layer.
+         *
+         *     Returns profile data from auth service (cached) combined with
+         *     the resolved permission set from core's RBAC system.
+         *
+         *     **Authentication**: Required (JWT Bearer token)
+         */
+        get: operations["getMe"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Patch Me
+         * @description Partial update for the authenticated user's profile.
+         *
+         *     Dispatches to the correct operation based on which fields are present:
+         *
+         *     **Change username** — supply `username` (+ `password`, optional `mfa_code`):
+         *     ```json
+         *     { "username": "john_doe_2026", "password": "CurrentPass123!" }
+         *     ```
+         *
+         *     **Deactivate account** — supply `status: "inactive"` (+ `password`, `confirm: true`):
+         *     ```json
+         *     { "status": "inactive", "password": "CurrentPass123!", "confirm": true, "reason": "Taking a break" }
+         *     ```
+         *
+         *     **Reactivate account** — supply `status: "active"` (+ `reactivation_token`):
+         *     ```json
+         *     { "status": "active", "reactivation_token": "eyJ..." }
+         *     ```
+         *
+         *     **Authentication**: Required (JWT)
+         *     **Rate Limit**: 5 requests per hour
+         */
+        patch: operations["patchMe"];
+        trace?: never;
+    };
+    "/v1/auth/password-resets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create Password Reset
+         * @description Request password reset for forgotten password.
+         *
+         *     **Authentication**: None (public endpoint)
+         *     **Rate Limit**: 12 requests per hour (3 per 15 minutes)
+         *
+         *     ## Request Body Examples:
+         *
+         *     ### Reset via Email:
+         *     ```json
+         *     {
+         *         "email": "john.doe@example.com",
+         *         "space_id": "spc_abc123xyz"
+         *     }
+         *     ```
+         *
+         *     ### Reset via Mobile (OTP):
+         *     ```json
+         *     {
+         *         "mobile_isd_code": "+1",
+         *         "mobile_no": "5551234567",
+         *         "space_id": "spc_abc123xyz"
+         *     }
+         *     ```
+         *
+         *     ## Required Fields:
+         *     - **Identifier**: Either `email` or (`mobile_isd_code` + `mobile_no`)
+         *     - **Space**: `space_id` (external ID format: `spc_xxx`)
+         *
+         *     ## Response:
+         *     Always returns success message for security (prevents email enumeration).
+         *     - **Email method**: Sends reset link to email (valid for 30 minutes)
+         *     - **Mobile method**: Sends OTP code via SMS (valid for 5 minutes)
+         *
+         *     ## Security Features:
+         *     - Single-use reset tokens
+         *     - Token expiry enforcement
+         *     - Rate limiting to prevent abuse
+         *     - Does not reveal if email/mobile exists
+         *
+         *     **Reference**: See `docs/AUTH_CONFIG_EXAMPLES.md` for configuration details.
+         */
+        post: operations["createPasswordReset"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/auth/password-resets/{reset_id}/confirm": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Confirm Password Reset
+         * @description Confirm password reset using reset token or OTP.
+         *
+         *     **Authentication**: None (uses reset token or OTP)
+         *     **Rate Limit**: 5 requests per minute
+         *
+         *     ## Request Body Examples:
+         *
+         *     ### Reset with Token (Email Link):
+         *     ```json
+         *     {
+         *         "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+         *         "new_password": "NewSecurePass123!",
+         *         "confirm_password": "NewSecurePass123!"
+         *     }
+         *     ```
+         *
+         *     ### Reset with OTP (Mobile):
+         *     ```json
+         *     {
+         *         "mobile_isd_code": "+1",
+         *         "mobile_no": "5551234567",
+         *         "otp": "123456",
+         *         "new_password": "NewSecurePass123!",
+         *         "confirm_password": "NewSecurePass123!"
+         *     }
+         *     ```
+         *
+         *     ## Required Fields:
+         *     - **Authentication**: Either `token` OR (`mobile_isd_code` + `mobile_no` + `otp`)
+         *     - **Password**: `new_password`, `confirm_password`
+         *
+         *     ## Password Requirements:
+         *     - Minimum 8 characters
+         *     - At least one uppercase letter
+         *     - At least one number
+         *     - At least one special character
+         *     - Must match `confirm_password`
+         *
+         *     ## Response:
+         *     Returns success confirmation after password is reset.
+         *     User will need to log in with new password.
+         *
+         *     ## Error Cases:
+         *     - Token expired or invalid
+         *     - OTP incorrect or expired
+         *     - Password does not meet requirements
+         *     - Passwords do not match
+         *
+         *     **Reference**: See `docs/AUTH_CONFIG_EXAMPLES.md` for password policy configuration.
+         */
+        post: operations["confirmPasswordReset"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/sessions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get User Sessions
+         * @description Get all active sessions for the current logged-in user.
+         *
+         *     **For**: Authenticated users
+         *     **Purpose**: View all devices where you're currently logged in
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *       "sessions": [
+         *         {
+         *           "session_id": 12345,
+         *           "device_name": "Chrome on Windows",
+         *           "browser": "Chrome 120",
+         *           "os": "Windows 11",
+         *           "client_ip": "192.168.1.100",
+         *           "location": "San Francisco, US",
+         *           "created_at": "2025-01-15T10:30:00Z",
+         *           "last_used_at": "2025-01-27T14:22:00Z",
+         *           "expires_at": "2025-02-26T10:30:00Z",
+         *           "is_current": true
+         *         }
+         *       ],
+         *       "total_sessions": 1,
+         *       "active_sessions": 1
+         *     }
+         *     ```
+         *
+         *     **Note**: `session_id` is a temporary integer identifier — will be replaced with a
+         *     string external ID (sess_xxx) once the session table gains an external_id column.
+         *
+         *     **Authentication**: JWT token required
+         *     **Headers**: Authorization: Bearer <access_token>
+         *     **Cookies**: refresh_token HttpOnly cookie is used only to mark the current session
+         *     **Rate Limit**: 20 requests per minute
+         *
+         *     **Use Cases**:
+         *     - View all devices where you're logged in
+         *     - Identify suspicious sessions
+         *     - Check last activity on each device
+         */
+        get: operations["getUserSessions"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete All User Sessions
+         * @description Logout from all other sessions or all sessions.
+         *
+         *     **For**: Authenticated users
+         *     **Purpose**: Mass logout for security or cleanup
+         *
+         *     **Query Parameters**:
+         *     - all (boolean, default: false):
+         *       - false: Logout from all OTHER sessions (keep current session active)
+         *       - true: Logout from ALL sessions including current (force re-login everywhere)
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *       "revoked_count": 3,
+         *       "current_session_revoked": false
+         *     }
+         *     ```
+         *
+         *     **Authentication**: JWT token required
+         *     **Headers**: Authorization: Bearer <access_token>
+         *     **Cookies**: refresh_token HttpOnly cookie is required when all=false
+         *     **Rate Limit**: 5 requests per minute
+         *
+         *     **Use Cases**:
+         *     - "I'm on my laptop, logout from all other devices"
+         *     - "I think my account was compromised, logout everywhere"
+         *     - "Cleanup old sessions from devices I no longer use"
+         */
+        delete: operations["deleteAllUserSessions"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/sessions/{session_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete User Session
+         * @description Logout from a specific device/session.
+         *
+         *     **For**: Authenticated users
+         *     **Purpose**: Remove access from a specific device (e.g., logout from old phone)
+         *
+         *     **Path Parameters**:
+         *     - session_id: The ID of the session to delete
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *       "session_id": 12340,
+         *       "device_name": "Safari on macOS",
+         *       "revoked_at": "2025-01-27T15:30:00Z"
+         *     }
+         *     ```
+         *
+         *     **Note**: `session_id` is a temporary integer — will change to sess_xxx once
+         *     the session table gains an external_id column.
+         *
+         *     **Authentication**: JWT token required
+         *     **Headers**: Authorization: Bearer <access_token>
+         *     **Rate Limit**: 10 requests per minute
+         *
+         *     **Use Cases**:
+         *     - "I sold my old phone, remove that session"
+         *     - "I see a suspicious login from London, terminate it"
+         *     - "Logout from my work laptop"
+         */
+        delete: operations["deleteUserSession"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/password": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Change Password
+         * @description Change password for the authenticated user.
+         *
+         *     **Authentication**: Required (JWT Bearer token)
+         *     **Rate Limit**: 5 requests per minute
+         */
+        patch: operations["changePassword"];
+        trace?: never;
+    };
+    "/v1/me/social-connections": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Link Social Account
+         * @description Link a social provider to existing authenticated account.
+         *
+         *     **For**: Authenticated users
+         *     **Purpose**: Add social login method to existing account
+         *
+         *     **Example Request Body**:
+         *     ```json
+         *     {
+         *         "provider": "facebook",
+         *         "authorization_code": "AQD...",
+         *         "redirect_uri": "https://yourdomain.com/auth/callback/facebook"
+         *     }
+         *     ```
+         *
+         *     **Supported Providers**: google, facebook, linkedin, x, apple
+         *     **Required Fields**: provider, authorization_code, redirect_uri
+         *     **Rate Limit**: 5 requests per minute
+         *     **Authentication**: JWT token required
+         *     **Headers**: Authorization: Bearer <token>
+         *
+         *     **Use Case**: User registered with email/password, now wants to enable Google login
+         */
+        post: operations["linkSocialAccount"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/social-connections/{provider}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Unlink Social Account
+         * @description Remove a social provider from authenticated account.
+         *
+         *     **For**: Authenticated users
+         *     **Purpose**: Remove social login method
+         *
+         *     **Validation**: User must have password OR another linked provider
+         *     **Rate Limit**: 5 requests per minute
+         *     **Authentication**: JWT token required
+         *     **Headers**: Authorization: Bearer <token>
+         *
+         *     **Example**:
+         *     ```bash
+         *     curl -X DELETE https://api.yourdomain.com/v1/me/social-connections/google       -H "Authorization: Bearer YOUR_JWT_TOKEN"
+         *     ```
+         *
+         *     **Error**: Returns 400 if trying to remove last login method
+         */
+        delete: operations["unlinkSocialAccount"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/email-changes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Update Email Initiate
+         * @description **Initiate email address update (Step 1 of 2).**
+         *
+         *     **Purpose**: Start email update process by verifying user identity and sending
+         *     OTP to new email address.
+         *
+         *     **Flow**:
+         *     1. Verify user password (required by default, config can override to accept OTP)
+         *     2. Check MFA if user has it enabled
+         *     3. Verify new email is available (not in use by another user)
+         *     4. Generate verification token (JWT, 15min TTL)
+         *     5. Send OTP to new email address
+         *     6. Cache pending change for verification step
+         *     7. Return challenge_id for next step
+         *
+         *     **Example Request**:
+         *     ```json
+         *     {
+         *         "new_email": "newemail@example.com",
+         *         "password": "CurrentPass123!",
+         *         "mfa_code": "123456"
+         *     }
+         *     ```
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *         "success": true,
+         *         "data": {
+         *             "challenge_id": "otp_abc123xyz",
+         *             "verification_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+         *             "new_email_masked": "n***@example.com",
+         *             "expires_at": "2025-02-01T12:15:00Z"
+         *         },
+         *         "message": "Verification code sent to new email"
+         *     }
+         *     ```
+         *
+         *     **Next Step**: Call `/update-email/verify` with the OTP code sent to new email.
+         *
+         *     **Security Features**:
+         *     - Password verification (default, config-driven)
+         *     - MFA verification if enabled
+         *     - Email availability check
+         *     - OTP sent to NEW email (not current)
+         *     - Verification token with 15min expiry
+         *
+         *     **Authentication**: Required (JWT)
+         *     **Rate Limit**: 10 requests per hour
+         *
+         *     **Response Codes**:
+         *     - 200: Verification code sent successfully
+         *     - 400: Validation error (invalid email format, MFA required)
+         *     - 401: Incorrect password
+         *     - 403: Email changes disabled for org
+         *     - 409: Email already in use
+         *     - 429: Rate limit exceeded
+         *     - 500: Server error or OTP send failure
+         */
+        post: operations["createEmailChange"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/email-changes/{change_id}/confirm": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Update Email Verify
+         * @description **Verify and complete email address update (Step 2 of 2).**
+         *
+         *     **Purpose**: Complete email update by verifying OTP code sent to new email.
+         *
+         *     **Flow**:
+         *     1. Verify JWT verification token from initiate step
+         *     2. Retrieve pending change from cache
+         *     3. Verify OTP code sent to new email
+         *     4. Update email address in database
+         *     5. Optionally invalidate all sessions (config-driven)
+         *     6. Send notification to OLD email with rollback token
+         *     7. Return success with rollback info (if enabled)
+         *
+         *     **Example Request**:
+         *     ```json
+         *     {
+         *         "verification_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+         *         "otp_code": "123456"
+         *     }
+         *     ```
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *         "success": true,
+         *         "data": {
+         *             "email": "newemail@example.com",
+         *             "previous_email": "oldemail@example.com",
+         *             "rollback_available": true,
+         *             "rollback_expires_at": "2025-02-02T12:00:00Z"
+         *         },
+         *         "message": "Email updated successfully"
+         *     }
+         *     ```
+         *
+         *     **Rollback**: If enabled (default 24h window), old email will receive a rollback
+         *     link. Use `/update-email/rollback` endpoint to revert the change.
+         *
+         *     **Session Invalidation**: If configured, all active sessions will be logged out
+         *     for security (user must re-login with new email).
+         *
+         *     **Authentication**: Required (JWT)
+         *     **Rate Limit**: 20 requests per hour
+         *
+         *     **Response Codes**:
+         *     - 200: Email updated successfully
+         *     - 400: Invalid or expired OTP, invalid verification token
+         *     - 401: Verification token expired
+         *     - 403: Token user/org mismatch
+         *     - 404: No pending email change found
+         *     - 500: Server error
+         */
+        post: operations["confirmEmailChange"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/email-changes/{change_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Update Email Rollback
+         * @description **Rollback email change to previous address.**
+         *
+         *     **Purpose**: Restore previous email address within rollback window (default 24h).
+         *     Used if email was changed by mistake or account was compromised.
+         *
+         *     **Flow**:
+         *     1. Verify rollback token (sent to old email after change)
+         *     2. Retrieve rollback data from cache
+         *     3. Check rollback window hasn't expired
+         *     4. Update email back to previous address
+         *     5. Send confirmation to restored email
+         *     6. Clear rollback cache
+         *
+         *     **Example Request**:
+         *     ```json
+         *     {
+         *         "rollback_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+         *     }
+         *     ```
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *         "success": true,
+         *         "data": {
+         *             "email": "oldemail@example.com",
+         *             "restored_from": "newemail@example.com"
+         *         },
+         *         "message": "Email address restored successfully"
+         *     }
+         *     ```
+         *
+         *     **Security Note**: Rollback token is single-use and sent only to the OLD email
+         *     address, providing proof of ownership.
+         *
+         *     **Authentication**: Required (JWT)
+         *     **Rate Limit**: 5 requests per hour
+         *
+         *     **Response Codes**:
+         *     - 200: Email restored successfully
+         *     - 400: Invalid rollback token
+         *     - 401: Rollback window expired
+         *     - 403: Token user/org mismatch
+         *     - 404: No rollback data found
+         *     - 500: Server error
+         */
+        delete: operations["cancelEmailChange"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/mobile-changes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Update Mobile Initiate
+         * @description **Initiate mobile number update (Step 1 of 2).**
+         *
+         *     **Purpose**: Start mobile number update process by verifying user identity and
+         *     sending OTP to new mobile number.
+         *
+         *     **Flow**:
+         *     1. Verify user password (required by default, config can override)
+         *     2. Check MFA if user has it enabled
+         *     3. Verify new mobile is available
+         *     4. Generate verification token (JWT, 15min TTL)
+         *     5. Send OTP via SMS to new mobile number
+         *     6. Cache pending change for verification step
+         *     7. Return challenge_id for next step
+         *
+         *     **Example Request**:
+         *     ```json
+         *     {
+         *         "new_mobile_isd_code": "+1",
+         *         "new_mobile_no": "5559876543",
+         *         "password": "CurrentPass123!",
+         *         "mfa_code": "123456"
+         *     }
+         *     ```
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *         "success": true,
+         *         "data": {
+         *             "challenge_id": "otp_abc123xyz",
+         *             "verification_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+         *             "new_mobile_masked": "+1***6543",
+         *             "expires_at": "2025-02-01T12:15:00Z"
+         *         },
+         *         "message": "Verification code sent to new mobile"
+         *     }
+         *     ```
+         *
+         *     **Next Step**: Call `/update-mobile/verify` with the OTP code sent via SMS.
+         *
+         *     **Authentication**: Required (JWT)
+         *     **Rate Limit**: 10 requests per hour
+         *
+         *     **Response Codes**:
+         *     - 200: Verification code sent successfully
+         *     - 400: Validation error
+         *     - 401: Incorrect password
+         *     - 403: Mobile changes disabled for org
+         *     - 409: Mobile number already in use
+         *     - 429: Rate limit exceeded
+         *     - 500: Server error or SMS send failure
+         */
+        post: operations["createMobileChange"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/mobile-changes/{change_id}/confirm": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Update Mobile Verify
+         * @description **Verify and complete mobile number update (Step 2 of 2).**
+         *
+         *     **Purpose**: Complete mobile update by verifying OTP code sent via SMS.
+         *
+         *     **Flow**:
+         *     1. Verify JWT verification token from initiate step
+         *     2. Retrieve pending change from cache
+         *     3. Verify OTP code sent to new mobile
+         *     4. Update mobile number in database
+         *     5. Send notification to OLD mobile (if configured)
+         *     6. Return success
+         *
+         *     **Example Request**:
+         *     ```json
+         *     {
+         *         "verification_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+         *         "otp_code": "123456"
+         *     }
+         *     ```
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *         "success": true,
+         *         "data": {
+         *             "mobile_isd_code": "+1",
+         *             "mobile_no": "5559876543",
+         *             "previous_mobile": "+1 5551234567"
+         *         },
+         *         "message": "Mobile number updated successfully"
+         *     }
+         *     ```
+         *
+         *     **Authentication**: Required (JWT)
+         *     **Rate Limit**: 20 requests per hour
+         *
+         *     **Response Codes**:
+         *     - 200: Mobile updated successfully
+         *     - 400: Invalid or expired OTP
+         *     - 401: Verification token expired
+         *     - 403: Token user/org mismatch
+         *     - 404: No pending mobile change found
+         *     - 500: Server error
+         */
+        post: operations["confirmMobileChange"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/account-deletions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Delete Account Initiate
+         * @description **Initiate account deletion (Step 1 of 3).**
+         *
+         *     **Purpose**: Start account deletion process with grace period (default 24h) for
+         *     cancellation. Supports GDPR/CCPA "right to be forgotten".
+         *
+         *     **Flow**:
+         *     1. Verify user password (if required)
+         *     2. Verify confirmation text (if required): "DELETE MY ACCOUNT"
+         *     3. Check if user is instructor with active students (block if configured)
+         *     4. Generate deletion token (JWT, 24h default TTL)
+         *     5. Cache deletion request
+         *     6. Send confirmation email (based on confirmation_method config)
+         *     7. Return deletion_token or email confirmation
+         *
+         *     **Example Request**:
+         *     ```json
+         *     {
+         *         "password": "CurrentPass123!",
+         *         "confirmation_text": "DELETE MY ACCOUNT",
+         *         "reason": "No longer need the service"
+         *     }
+         *     ```
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *         "success": true,
+         *         "data": {
+         *             "deletion_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+         *             "confirmation_sent_to_email": true,
+         *             "grace_period_hours": 24,
+         *             "expires_at": "2025-02-02T12:00:00Z"
+         *         },
+         *         "message": "Account deletion initiated"
+         *     }
+         *     ```
+         *
+         *     **Next Steps**:
+         *     - To confirm deletion: Call `/delete/confirm` with deletion_token
+         *     - To cancel deletion: Call `/delete/cancel` with deletion_token
+         *
+         *     **Grace Period**: Default 24 hours to cancel before deletion executes.
+         *
+         *     **Authentication**: Required (JWT)
+         *     **Rate Limit**: 3 requests per hour
+         *
+         *     **Response Codes**:
+         *     - 200: Deletion initiated successfully
+         *     - 400: Confirmation text incorrect or reason required
+         *     - 401: Incorrect password
+         *     - 403: Deletion disabled for org
+         *     - 409: Cannot delete (instructor with active students)
+         *     - 500: Server error
+         */
+        post: operations["createAccountDeletion"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/account-deletions/{deletion_id}/confirm": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Delete Account Confirm
+         * @description **Confirm and execute account deletion (Step 2 of 3).**
+         *
+         *     **Purpose**: Execute account deletion (soft delete) with optional immediate
+         *     anonymization.
+         *
+         *     **Flow**:
+         *     1. Verify deletion token
+         *     2. Check within grace period
+         *     3. Soft delete account (set status to 'deleted', set deleted_at timestamp)
+         *     4. Optionally anonymize PII immediately (email, name, phone, address)
+         *     5. Invalidate all sessions (force logout)
+         *     6. Send final confirmation (if email not anonymized)
+         *     7. Return success with hard-delete timeline
+         *
+         *     **Example Request**:
+         *     ```json
+         *     {
+         *         "deletion_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+         *     }
+         *     ```
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *         "success": true,
+         *         "data": {
+         *             "status": "deleted",
+         *             "deleted_at": "2025-02-02T12:00:00Z",
+         *             "anonymized": true,
+         *             "hard_delete_after_days": 90
+         *         },
+         *         "message": "Account deleted successfully"
+         *     }
+         *     ```
+         *
+         *     **GDPR Compliance**:
+         *     - Soft delete: Account marked as deleted, data retained for compliance period
+         *     - Anonymization: PII replaced with anonymized values (e.g., "deleted_user_12345")
+         *     - Hard delete: Permanent data removal after retention period (default 90 days)
+         *
+         *     **Important**: This action cannot be undone after grace period expires.
+         *
+         *     **Authentication**: Required (JWT)
+         *     **Rate Limit**: 5 requests per hour
+         *
+         *     **Response Codes**:
+         *     - 200: Account deleted successfully
+         *     - 400: Invalid deletion token
+         *     - 401: Grace period expired
+         *     - 403: Token user/org mismatch
+         *     - 404: No deletion request found
+         *     - 500: Server error
+         */
+        post: operations["confirmAccountDeletion"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/account-deletions/{deletion_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete Account Cancel
+         * @description **Cancel pending account deletion (Step 3 - optional).**
+         *
+         *     **Purpose**: Cancel deletion request within grace period (default 24h).
+         *
+         *     **Flow**:
+         *     1. Verify deletion token
+         *     2. Check within grace period
+         *     3. Clear deletion cache
+         *     4. Send cancellation confirmation email
+         *     5. Return success
+         *
+         *     **Example Request**:
+         *     ```json
+         *     {
+         *         "deletion_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+         *     }
+         *     ```
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *         "success": true,
+         *         "data": {
+         *             "cancelled_at": "2025-02-01T18:00:00Z"
+         *         },
+         *         "message": "Account deletion cancelled"
+         *     }
+         *     ```
+         *
+         *     **Authentication**: Required (JWT)
+         *     **Rate Limit**: 10 requests per hour
+         *
+         *     **Response Codes**:
+         *     - 200: Deletion cancelled successfully
+         *     - 400: Invalid deletion token
+         *     - 401: Grace period expired (cannot cancel)
+         *     - 403: Token user/org mismatch
+         *     - 404: No pending deletion found
+         *     - 500: Server error
+         */
+        delete: operations["cancelAccountDeletion"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/mfa/enrollments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create Mfa Enrollment
+         * @description **Start MFA enrollment** for any supported method.
+         *
+         *     **Authentication**: Required (JWT)
+         *
+         *     **Request Body**:
+         *     ```json
+         *     { "method": "totp" }
+         *     { "method": "sms", "phone_number": "+11234567890" }
+         *     { "method": "email", "email": "user@example.com" }
+         *     ```
+         *
+         *     **Response** (common fields):
+         *     - `method` — method being enrolled
+         *     - `enrollment_id` — use in `POST /enrollments/{enrollment_id}/confirm`
+         *     - TOTP only: `qr_code_url`, `secret`, `manual_entry_code`
+         *     - SMS/Email only: `sent_to`, `expires_at`
+         */
+        post: operations["createMFAEnrollment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/mfa/enrollments/{enrollment_id}/confirm": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Confirm Mfa Enrollment
+         * @description **Confirm and complete MFA enrollment.**
+         *
+         *     **Authentication**: Required (JWT)
+         *
+         *     **Request Body**:
+         *     ```json
+         *     { "method": "totp", "code": "123456" }
+         *     { "method": "sms",  "code": "123456" }
+         *     { "method": "email","code": "123456" }
+         *     ```
+         *
+         *     For TOTP: `enrollment_id` = `"totp"` (returned by createMFAEnrollment).
+         *     For SMS/Email: `enrollment_id` = `verification_id` from createMFAEnrollment response.
+         *
+         *     **Response** (TOTP): backup codes (save securely)
+         *     **Response** (SMS/Email): enrolled status
+         */
+        post: operations["confirmMFAEnrollment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/mfa/methods": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Mfa Methods
+         * @description **List all MFA methods** for current user.
+         *
+         *     Shows enrolled methods and backup codes status.
+         *
+         *     **Authentication**: Required (JWT)
+         *
+         *     **Response**:
+         *     ```json
+         *     {
+         *       "available_methods": ["totp", "sms", "email"],
+         *       "enrolled_methods": [
+         *         {
+         *           "method": "totp",
+         *           "enabled": true,
+         *           "enrolled_at": "2026-01-15T10:30:00Z"
+         *         }
+         *       ],
+         *       "backup_codes": {
+         *         "total": 10,
+         *         "remaining": 8
+         *       }
+         *     }
+         *     ```
+         */
+        get: operations["listMFAMethods"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/mfa/methods/{method}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Disable Mfa Method
+         * @description **Disable MFA method**.
+         *
+         *     **Security**: Requires password confirmation in header.
+         *
+         *     **Authentication**: Required (JWT)
+         *
+         *     **Headers**:
+         *     ```
+         *     X-Password-Confirmation: user_password
+         *     ```
+         *
+         *     **Path**: `/v1/user/security/mfa/totp`, `/v1/user/security/mfa/sms`, `/v1/user/security/mfa/email`
+         */
+        delete: operations["disableMFAMethod"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/mfa/backup-codes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Backup Codes
+         * @description **Get backup codes** (masked for security).
+         *
+         *     **Authentication**: Required (JWT)
+         *
+         *     **Response**: Shows which codes are used/unused (actual codes never returned)
+         */
+        get: operations["getBackupCodes"];
+        put?: never;
+        /**
+         * Regenerate Backup Codes
+         * @description **Regenerate backup codes** (invalidates old ones).
+         *
+         *     **Security**: Requires password confirmation in header.
+         *
+         *     **Authentication**: Required (JWT)
+         *
+         *     **Headers**:
+         *     ```
+         *     X-Password-Confirmation: user_password
+         *     ```
+         *
+         *     **Response**: New backup codes (save securely)
+         */
+        post: operations["regenerateBackupCodes"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/mfa/devices": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Trusted Devices
+         * @description **List all trusted devices** for current user.
+         *
+         *     Shows devices where MFA is skipped for 30 days.
+         *
+         *     **Authentication**: Required (JWT)
+         *
+         *     **Response**:
+         *     ```json
+         *     {
+         *       "devices": [
+         *         {
+         *           "device_id": "dev_abc123",
+         *           "device_name": "Chrome on Windows 11",
+         *           "ip_address": "192.168.1.100",
+         *           "last_used_at": "2026-01-28T10:30:00Z",
+         *           "expires_at": "2026-02-27T10:30:00Z",
+         *           "current_device": true
+         *         }
+         *       ]
+         *     }
+         *     ```
+         */
+        get: operations["listTrustedDevices"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/mfa/devices/{device_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Revoke Trusted Device
+         * @description **Revoke trusted device** (require MFA on next login).
+         *
+         *     **Authentication**: Required (JWT)
+         *
+         *     **Path**: `/v1/user/security/mfa/devices/dev_abc123`
+         */
+        delete: operations["revokeTrustedDevice"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /**
+         * DeleteAccountConfirmRequest
+         * @description Request to confirm account deletion
+         * @example {
+         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+         *     }
+         */
+        DeleteAccountConfirmRequest: {
+            /**
+             * Token
+             * @description Deletion token from confirmation email (JWT, 24h TTL)
+             */
+            token: string;
+        };
+        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;
+        };
+        /**
+         * EmailRollbackRequest
+         * @description Request to rollback email change
+         * @example {
+         *       "rollback_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+         *     }
+         */
+        EmailRollbackRequest: {
+            /**
+             * Rollback Token
+             * @description Rollback token from email sent to old address
+             */
+            rollback_token: string;
+        };
+        /**
+         * UpdateMobileInitiateRequest
+         * @description Request to initiate mobile number change
+         * @example {
+         *       "mfa_code": "123456",
+         *       "new_mobile_isd_code": "+91",
+         *       "new_mobile_no": "9876543210",
+         *       "password": "MySecurePassword123!"
+         *     }
+         */
+        UpdateMobileInitiateRequest: {
+            /**
+             * New Mobile Isd Code
+             * @description Country code with + (e.g., +1, +91)
+             */
+            new_mobile_isd_code: string;
+            /**
+             * New Mobile No
+             * @description New mobile number (digits only)
+             */
+            new_mobile_no: string;
+            /**
+             * Password
+             * @description Current password (REQUIRED for security)
+             */
+            password: string;
+            /**
+             * Mfa Code
+             * @description MFA code if MFA enabled
+             */
+            mfa_code?: string | 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;
+        };
+        /**
+         * PatchMeRequest
+         * @description Unified PATCH /v1/me request. Supply the fields for the operation you want.
+         */
+        PatchMeRequest: {
+            /** Username */
+            username?: string | null;
+            /** Status */
+            status?: ("active" | "inactive") | null;
+            /** Password */
+            password?: string | null;
+            /** Mfa Code */
+            mfa_code?: string | null;
+            /** Reason */
+            reason?: string | null;
+            /** Confirm */
+            confirm?: boolean | null;
+            /** Reactivation Token */
+            reactivation_token?: string | null;
+        };
+        /** ChangePasswordRequest */
+        ChangePasswordRequest: {
+            /** Current Password */
+            current_password: string;
+            /** New Password */
+            new_password: string;
+            /** Confirm Password */
+            confirm_password: string;
+            /** Tracking Id */
+            tracking_id?: string | null;
+        };
+        /** HTTPValidationError */
+        HTTPValidationError: {
+            /** Detail */
+            detail?: components["schemas"]["ValidationError"][];
+        };
+        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"];
+        };
+        /**
+         * UpdateMobileVerifyRequest
+         * @description Request to verify new mobile with OTP
+         * @example {
+         *       "otp": "123456",
+         *       "verification_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+         *     }
+         */
+        UpdateMobileVerifyRequest: {
+            /**
+             * Verification Token
+             * @description Token from initiate step (JWT, 15 min TTL)
+             */
+            verification_token: string;
+            /**
+             * Otp
+             * @description OTP sent to new mobile
+             */
+            otp: string;
+        };
+        /** ForgetPasswordRequest */
+        ForgetPasswordRequest: {
+            /** Email */
+            email?: string | null;
+            /** Username */
+            username?: string | null;
+            /** Mobile Isd Code */
+            mobile_isd_code?: string | null;
+            /** Mobile No */
+            mobile_no?: string | null;
+            /** Space Id */
+            space_id: string;
+            /** G Recaptcha Response */
+            g_recaptcha_response?: string | null;
+            /** Return Data */
+            return_data?: {
+                [key: string]: unknown;
+            } | null;
+            /** Tracking Id */
+            tracking_id?: string | null;
+        };
+        /** ValidationError */
+        ValidationError: {
+            /** Location */
+            loc: (string | number)[];
+            /** Message */
+            msg: string;
+            /** Error Type */
+            type: string;
+        };
+        /**
+         * UpdateEmailVerifyRequest
+         * @description Request to verify new email with OTP
+         * @example {
+         *       "otp": "123456",
+         *       "verification_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+         *     }
+         */
+        UpdateEmailVerifyRequest: {
+            /**
+             * Verification Token
+             * @description Token from initiate step (JWT, 15 min TTL)
+             */
+            verification_token: string;
+            /**
+             * Otp
+             * @description OTP sent to new email
+             */
+            otp: string;
+        };
+        /**
+         * DeleteAccountInitiateRequest
+         * @description Request to initiate account deletion
+         * @example {
+         *       "confirm_text": "DELETE MY ACCOUNT",
+         *       "password": "MySecurePassword123!",
+         *       "reason": "Switching to a different platform"
+         *     }
+         */
+        DeleteAccountInitiateRequest: {
+            /**
+             * Password
+             * @description Current password for confirmation
+             */
+            password: string;
+            /**
+             * Reason
+             * @description Reason for deletion (optional)
+             */
+            reason?: string | null;
+            /**
+             * Confirm Text
+             * @description Must type 'DELETE MY ACCOUNT' exactly
+             */
+            confirm_text: string;
+        };
+        /**
+         * MFAConfirmEnrollRequest
+         * @description Confirm an in-progress MFA enrollment.
+         *
+         *     - `method`: same method as the enrollment request
+         *     - `code`: 6-digit OTP (sms/email) or 6-8 digit TOTP code
+         */
+        MFAConfirmEnrollRequest: {
+            /**
+             * Method
+             * @description Method being confirmed
+             * @enum {string}
+             */
+            method: "totp" | "sms" | "email";
+            /**
+             * Code
+             * @description Verification code
+             */
+            code: string;
+        };
+        /**
+         * SocialLinkRequest
+         * @description Request model for linking social account to existing user.
+         */
+        SocialLinkRequest: {
+            /**
+             * Provider
+             * @enum {string}
+             */
+            provider: "google" | "facebook" | "linkedin" | "x" | "apple";
+            /** Authorization Code */
+            authorization_code: string;
+            /** Redirect Uri */
+            redirect_uri: string;
+        };
+        /**
+         * MFAEnrollRequest
+         * @description Polymorphic MFA enrollment request.
+         *
+         *     Supply `method` + any method-specific fields:
+         *     - `totp`: no extra fields needed
+         *     - `sms`: requires `phone_number`
+         *     - `email`: requires `email`
+         */
+        MFAEnrollRequest: {
+            /**
+             * Method
+             * @description MFA method to enroll
+             * @enum {string}
+             */
+            method: "totp" | "sms" | "email";
+            /**
+             * Phone Number
+             * @description Phone number with country code (sms only)
+             */
+            phone_number?: string | null;
+            /**
+             * Email
+             * @description Email address for MFA (email only)
+             */
+            email?: string | null;
+        };
+        /** ResetPasswordRequest */
+        ResetPasswordRequest: {
+            /** New Password */
+            new_password: string;
+            /**
+             * Send Email
+             * @default true
+             */
+            send_email: boolean | null;
+        };
+        /**
+         * UpdateEmailInitiateRequest
+         * @description Request to initiate email change
+         * @example {
+         *       "mfa_code": "123456",
+         *       "new_email": "john.newemail@example.com",
+         *       "password": "MySecurePassword123!"
+         *     }
+         */
+        UpdateEmailInitiateRequest: {
+            /**
+             * New Email
+             * Format: email
+             * @description New email address
+             */
+            new_email: string;
+            /**
+             * Password
+             * @description Current password (REQUIRED for security)
+             */
+            password: string;
+            /**
+             * Mfa Code
+             * @description MFA code if MFA enabled
+             */
+            mfa_code?: string | null;
+        };
+        /**
+         * DeleteAccountCancelRequest
+         * @description Request to cancel pending deletion
+         * @example {
+         *       "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+         *     }
+         */
+        DeleteAccountCancelRequest: {
+            /**
+             * Token
+             * @description Deletion cancellation token (JWT, 24h TTL)
+             */
+            token: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    getMe: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    patchMe: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PatchMeRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    createPasswordReset: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ForgetPasswordRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    confirmPasswordReset: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Reset ID from createPasswordReset response */
+                reset_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ResetPasswordRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    getUserSessions: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    deleteAllUserSessions: {
+        parameters: {
+            query?: {
+                /** @description Delete ALL sessions (true) or all EXCEPT current (false) */
+                all?: boolean;
+            };
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    deleteUserSession: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                session_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    changePassword: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ChangePasswordRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    linkSocialAccount: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SocialLinkRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    unlinkSocialAccount: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                provider: "google" | "facebook" | "linkedin" | "x" | "apple";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    createEmailChange: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateEmailInitiateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    confirmEmailChange: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                /** @description Change ID from createEmailChange response */
+                change_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateEmailVerifyRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    cancelEmailChange: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                /** @description Change ID from createEmailChange response */
+                change_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["EmailRollbackRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    createMobileChange: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateMobileInitiateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    confirmMobileChange: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                /** @description Change ID from createMobileChange response */
+                change_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateMobileVerifyRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    createAccountDeletion: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DeleteAccountInitiateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    confirmAccountDeletion: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                /** @description Deletion ID from createAccountDeletion response */
+                deletion_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DeleteAccountConfirmRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    cancelAccountDeletion: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                /** @description Deletion ID from createAccountDeletion response */
+                deletion_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DeleteAccountCancelRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    createMFAEnrollment: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["MFAEnrollRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    confirmMFAEnrollment: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                /** @description Enrollment ID from createMFAEnrollment (use 'totp' for TOTP) */
+                enrollment_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["MFAConfirmEnrollRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    listMFAMethods: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    disableMFAMethod: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Password confirmation required */
+                "x-password-confirmation": string;
+                authorization?: string | null;
+            };
+            path: {
+                /** @description Method to disable (totp, sms, email) */
+                method: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    getBackupCodes: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    regenerateBackupCodes: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description Password confirmation required */
+                "x-password-confirmation": string;
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    listTrustedDevices: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    revokeTrustedDevice: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                /** @description Device ID to revoke (dev_xxx) */
+                device_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+}
+//# sourceMappingURL=generated.d.ts.map