@blezgo/api-sdk 0.1.0

package/dist/config/generated.d.ts

@@ -0,0 +1,1150 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/v1/config/validate-domain": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Validate Domain
+         * @description Validate domain and return complete tenant configuration (PUBLIC endpoint)
+         *
+         *     **For**: Frontend applications on startup
+         *     **Purpose**: Discover API endpoint, API key, branding, and feature flags
+         *
+         *     **FLEXIBLE INPUT**: Accepts domain in ANY format (Industry Standard)
+         *     - Full URLs: https://client1.yourdomain.com/path?query=1
+         *     - Partial URLs: client1.yourdomain.com/path
+         *     - With/without protocol: http://client1.yourdomain.com or client1.yourdomain.com
+         *     - With ports: client1.yourdomain.com:8080
+         *     - With trailing slashes: client1.yourdomain.com/
+         *     - Mixed case: Client1.Yourdomain.COM
+         *     - With www: www.client1.yourdomain.com
+         *
+         *     Backend automatically extracts and normalizes the domain - no client-side cleanup needed!
+         *
+         *     **How Frontend Uses This**:
+         *     ```javascript
+         *     // Step 1: Get domain (ANY format works!)
+         *     const domain = window.location.href; // Full URL: "https://client1.yourdomain.com/dashboard"
+         *     // OR just hostname: window.location.hostname; // "client1.yourdomain.com"
+         *
+         *     // Step 2: Call validation endpoint (fallback API)
+         *     const response = await fetch('https://api.yourdomain.com/v1/config/validate-domain', {
+         *       method: 'POST',
+         *       headers: { 'Content-Type': 'application/json' },
+         *       body: JSON.stringify({ domain })  // Works with ANY format!
+         *     });
+         *
+         *     // Step 3: Cache config
+         *     const config = await response.json();
+         *     localStorage.setItem('tenant_config', JSON.stringify({
+         *       data: config.data,
+         *       expiresAt: Date.now() + (config.data.cache_ttl * 1000)
+         *     }));
+         *
+         *     // Step 4: Use cached config for all API calls
+         *     const apiClient = {
+         *       baseURL: config.data.api.endpoint,
+         *       apiKey: config.data.api.public_key,
+         *       orgId: config.data.tenant.org_id
+         *     };
+         *     ```
+         *
+         *     **Example Request Bodies** (ALL formats accepted):
+         *     ```json
+         *     // Simple domain
+         *     {"domain": "client1.yourdomain.com"}
+         *
+         *     // Full URL with path
+         *     {"domain": "https://client1.yourdomain.com/dashboard"}
+         *
+         *     // With port
+         *     {"domain": "client1.yourdomain.com:8080"}
+         *
+         *     // With trailing slash and query
+         *     {"domain": "https://app.client1.com/?ref=landing"}
+         *
+         *     // Mixed case (normalized automatically)
+         *     {"domain": "Client1.Yourdomain.COM"}
+         *     ```
+         *
+         *     **Example Response** (data field - FULL configuration):
+         *     ```json
+         *     {
+         *         "tenant_id": "tenant_123",
+         *         "tenant_name": "Client1 Platform",
+         *         "tenant_slug": "client1",
+         *         "is_active": true,
+         *         "subscription_tier": "professional",
+         *         "tenant": {
+         *             "org_id": 123,
+         *             "subdomain": "client1",
+         *             "custom_domain": "app.client1.com",
+         *             "custom_domain_verified": true,
+         *             "use_custom_domain": true,
+         *             "primary_domain": "app.client1.com",
+         *             "fallback_domain": "client1.yourdomain.com"
+         *         },
+         *         "api": {
+         *             "endpoint": "https://api.yourdomain.com",
+         *             "public_key": "pk_live_5E6F7G8hI9J0kl1M",
+         *             "version": "v1",
+         *             "environment": "live",
+         *             "rate_limits": {"per_minute": 60, "per_hour": 3600, "per_day": 100000},
+         *             "websocket_url": "wss://ws.yourdomain.com",
+         *             "cdn_url": "https://cdn.yourdomain.com",
+         *             "upload_url": "https://upload.yourdomain.com"
+         *         },
+         *         "branding": {
+         *             "logo_url": "https://cdn.client1.com/logo.png",
+         *             "logo_dark_url": "https://cdn.client1.com/logo-dark.png",
+         *             "favicon_url": "https://cdn.client1.com/favicon.ico",
+         *             "brand_name": "Client1 Platform",
+         *             "tagline": "Your learning platform"
+         *         },
+         *         "theme": {
+         *             "default_mode": "light",
+         *             "allow_toggle": true,
+         *             "colors_light": {"primary": "#6366f1", "background": "#ffffff"},
+         *             "colors_dark": {"primary": "#818cf8", "background": "#1f2937"}
+         *         },
+         *         "typography": {
+         *             "font_family_sans": "Inter, system-ui, sans-serif",
+         *             "font_urls": ["https://fonts.googleapis.com/css2?family=Inter"]
+         *         },
+         *         "layout": {
+         *             "max_width": "1280px",
+         *             "header": {"height": "64px", "sticky": true},
+         *             "sidebar": {"width": "256px", "collapsible": true}
+         *         },
+         *         "navigation_public": {
+         *             "header_menu": [{"id": "home", "label": "Home", "href": "/"}],
+         *             "footer_menu": [{"id": "about", "label": "About", "href": "/about"}]
+         *         },
+         *         "features": {
+         *             "auth_email_password": true,
+         *             "auth_social_google": true,
+         *             "cart_enabled": true,
+         *             "search_enabled": true
+         *         },
+         *         "seo": {
+         *             "default_title": "Client1 Platform",
+         *             "title_template": "%s | Client1",
+         *             "default_description": "Your learning platform"
+         *         },
+         *         "localization": {
+         *             "default_language": "en-US",
+         *             "supported_languages": ["en-US", "es-ES"],
+         *             "default_currency": "USD",
+         *             "timezone": "America/New_York"
+         *         },
+         *         "contact": {
+         *             "email": "support@client1.com",
+         *             "phone": "+1-555-123-4567"
+         *         },
+         *         "legal": {
+         *             "privacy_policy_url": "https://client1.com/privacy",
+         *             "terms_of_service_url": "https://client1.com/terms"
+         *         },
+         *         "custom_code": {
+         *             "head_scripts": "",
+         *             "custom_css": ""
+         *         },
+         *         "spaces": {
+         *             "homepage": 1,
+         *             "teachers_marketplace": 223
+         *         },
+         *         "kill_switches": {
+         *             "disable_login": false,
+         *             "disable_signup": false,
+         *             "disable_checkout": false
+         *         },
+         *         "cors": {
+         *             "allowed_origins": ["https://client1.yourdomain.com", "https://app.client1.com"]
+         *         },
+         *         "metadata": {
+         *             "cached_at": "2025-11-22T12:00:00Z",
+         *             "cache_ttl": 3600,
+         *             "config_version": "1.0.0"
+         *         }
+         *     }
+         *     ```
+         *
+         *     **Required Fields**: domain
+         *     **Note**: user_agent and client_ip are automatically extracted from request headers
+         *
+         *     **Rate Limit**: 10 requests per minute per domain
+         *     **Authentication**: None (public endpoint)
+         *     **Headers**: None required
+         *
+         *     **Response Codes**:
+         *     - 200: Domain validated, configuration returned
+         *     - 404: Domain not found or not active
+         *     - 403: Custom domain not verified
+         *     - 429: Rate limit exceeded
+         *     - 500: Server error
+         *
+         *     **Industry Standard**: Auth0, Shopify, Intercom all have similar endpoints for tenant configuration discovery
+         */
+        post: operations["validateDomain"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/config/check-domain-availability": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Check Domain Availability
+         * @description Check if custom domain is available for registration
+         *
+         *     **For**: Admin panel - Custom domain setup
+         *     **Purpose**: Check if custom domain can be added before DNS verification
+         *
+         *     **Example Request Body**:
+         *     ```json
+         *     {
+         *         "custom_domain": "app.client1.com"
+         *     }
+         *     ```
+         *
+         *     **Example Responses**:
+         *
+         *     **Available**:
+         *     ```json
+         *     {
+         *         "available": true,
+         *         "reason": "Available for registration"
+         *     }
+         *     ```
+         *
+         *     **Already in use (different org)**:
+         *     ```json
+         *     {
+         *         "available": false,
+         *         "reason": "Already in use by another organization"
+         *     }
+         *     ```
+         *
+         *     **Already registered (same org)**:
+         *     ```json
+         *     {
+         *         "available": true,
+         *         "reason": "Already registered to your organization"
+         *     }
+         *     ```
+         *
+         *     **Required Fields**: custom_domain
+         *     **Rate Limit**: 10 requests per minute
+         *     **Authentication**: Required (JWT token or API key)
+         *     **Headers**: Authorization: Bearer {token} OR X-Api-Key: {api_key}
+         *
+         *     **Response Codes**:
+         *     - 200: Availability checked
+         *     - 400: Invalid domain format
+         *     - 401: Unauthorized (missing auth)
+         *     - 429: Rate limit exceeded
+         *     - 500: Server error
+         *
+         *     **Workflow**:
+         *     1. Admin enters custom domain in UI
+         *     2. Frontend calls this endpoint to check availability
+         *     3. If available, proceed to DNS verification setup
+         *     4. If not available, show error message
+         */
+        post: operations["checkDomainAvailability"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/config/navigation": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Navigation
+         * @description Get role-based navigation for authenticated user (AUTHENTICATED endpoint)
+         *
+         *     **For**: Frontend after user login
+         *     **Purpose**: Get navigation menus based on user's role(s)
+         *
+         *     **How Navigation Works**:
+         *     1. User logs in, frontend calls this endpoint
+         *     2. Backend extracts user's roles from JWT
+         *     3. Returns merged navigation for all user roles
+         *     4. Frontend renders role-specific menus
+         *
+         *     **Example Response**:
+         *     ```json
+         *     {
+         *         "status": "success",
+         *         "data": {
+         *             "user": {
+         *                 "id": "user_12345",
+         *                 "email": "admin@example.com",
+         *                 "name": "John Admin",
+         *                 "avatar": "https://cdn.example.com/avatar.png",
+         *                 "role": "admin",
+         *                 "roles": ["admin", "instructor"],
+         *                 "permissions": ["manage_users", "manage_courses"]
+         *             },
+         *             "header_menu": [
+         *                 {
+         *                     "id": "dashboard",
+         *                     "label": "Dashboard",
+         *                     "href": "/dashboard",
+         *                     "icon": "LayoutDashboard"
+         *                 }
+         *             ],
+         *             "sidebar_menu": [
+         *                 {
+         *                     "section": "main",
+         *                     "label": "Main",
+         *                     "items": [
+         *                         {
+         *                             "id": "dashboard",
+         *                             "label": "Dashboard",
+         *                             "href": "/dashboard",
+         *                             "icon": "LayoutDashboard",
+         *                             "badge": null
+         *                         },
+         *                         {
+         *                             "id": "courses",
+         *                             "label": "Courses",
+         *                             "href": "/courses",
+         *                             "icon": "BookOpen",
+         *                             "badge": {"text": "5", "variant": "info"}
+         *                         }
+         *                     ]
+         *                 }
+         *             ],
+         *             "user_menu": [
+         *                 {
+         *                     "id": "profile",
+         *                     "label": "Profile",
+         *                     "href": "/profile",
+         *                     "icon": "User"
+         *                 },
+         *                 {
+         *                     "id": "settings",
+         *                     "label": "Settings",
+         *                     "href": "/settings",
+         *                     "icon": "Settings"
+         *                 },
+         *                 {
+         *                     "id": "logout",
+         *                     "label": "Logout",
+         *                     "href": "/logout",
+         *                     "icon": "LogOut",
+         *                     "is_danger": true
+         *                 }
+         *             ],
+         *             "quick_actions": [
+         *                 {
+         *                     "id": "new_course",
+         *                     "label": "New Course",
+         *                     "href": "/courses/new",
+         *                     "icon": "Plus",
+         *                     "primary": true
+         *                 }
+         *             ],
+         *             "notifications": {
+         *                 "enabled": true,
+         *                 "unread_count": 7,
+         *                 "show_badge": true
+         *             },
+         *             "dashboard_widgets": [
+         *                 {
+         *                     "id": "recent_activity",
+         *                     "type": "activity_feed",
+         *                     "position": {"col": 1, "row": 1, "width": 2, "height": 1}
+         *                 }
+         *             ],
+         *             "metadata": {
+         *                 "cached_at": "2025-11-22T12:00:00Z",
+         *                 "cache_ttl": 300
+         *             }
+         *         }
+         *     }
+         *     ```
+         *
+         *     **Rate Limit**: 60 requests per minute
+         *     **Authentication**: Required (JWT token)
+         *     **Headers**: Authorization: Bearer {token}
+         *
+         *     **Response Codes**:
+         *     - 200: Navigation returned successfully
+         *     - 401: Unauthorized (missing or invalid JWT)
+         *     - 403: Forbidden (insufficient permissions)
+         *     - 500: Server error
+         */
+        get: operations["getNavigation"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        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;
+        };
+        /**
+         * CheckDomainAvailabilityRequest
+         * @description Request model for checking custom domain availability
+         *
+         *     Example:
+         *     {
+         *         "custom_domain": "app.client1.com"
+         *     }
+         * @example {
+         *       "custom_domain": "app.client1.com"
+         *     }
+         */
+        CheckDomainAvailabilityRequest: {
+            /**
+             * Custom Domain
+             * @description Custom domain to check availability
+             * @example app.client1.com
+             */
+            custom_domain: string;
+        };
+        InvalidParam: {
+            /** @example items[0].quantity */
+            field?: string;
+            /** @example Input should be greater than or equal to 1 */
+            error?: string;
+        };
+        /**
+         * @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"];
+        };
+        /**
+         * ValidateDomainRequest
+         * @description Request model for POST /v1/config/validate-domain
+         *
+         *     ACCEPTS ANY FORMAT - Very Forgiving Input Parsing (Industry Standard):
+         *     - Full URLs: https://client1.yourdomain.com/path?query=1
+         *     - Partial URLs: client1.yourdomain.com/path
+         *     - With/without protocol: http://client1.yourdomain.com or client1.yourdomain.com
+         *     - With ports: client1.yourdomain.com:8080
+         *     - With trailing slashes: client1.yourdomain.com/
+         *     - Mixed case: Client1.Yourdomain.COM
+         *     - With www: www.yourdomain.com (www PRESERVED, not removed!)
+         *
+         *     The service automatically extracts and normalizes the domain.
+         *
+         *     NOTE: client_ip and user_agent are automatically extracted from request headers
+         *           by TrackingContextMiddleware - no need to include in request body.
+         *
+         *     Example:
+         *     {
+         *         "domain": "https://www.yourdomain.com/path"
+         *     }
+         * @example {
+         *       "domain": "client1.yourdomain.com"
+         *     }
+         * @example {
+         *       "domain": "https://client1.yourdomain.com/dashboard"
+         *     }
+         * @example {
+         *       "domain": "app.client1.com:8080"
+         *     }
+         * @example {
+         *       "domain": "https://www.yourdomain.com/"
+         *     }
+         */
+        ValidateDomainRequest: {
+            /**
+             * Domain
+             * @description Domain to validate in ANY format. Accepts: full URLs, subdomains, custom domains, with/without protocol, with ports, trailing slashes, mixed case. Examples: 'client1.yourdomain.com', 'https://app.client1.com/path', 'www.yourdomain.com'
+             * @example client1.yourdomain.com
+             * @example https://client1.yourdomain.com/dashboard
+             * @example app.client1.com:8080
+             * @example https://www.yourdomain.com/
+             * @example Client1.Yourdomain.COM
+             */
+            domain: string;
+        };
+        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"];
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    validateDomain: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ValidateDomainRequest"];
+            };
+        };
+        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"];
+                };
+            };
+        };
+    };
+    checkDomainAvailability: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CheckDomainAvailabilityRequest"];
+            };
+        };
+        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"];
+                };
+            };
+        };
+    };
+    getNavigation: {
+        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"];
+                };
+            };
+        };
+    };
+}
+//# sourceMappingURL=generated.d.ts.map