@blezgo/api-sdk 0.1.0

package/dist/dashboard/generated.d.ts

@@ -0,0 +1,4831 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/v1/dashboards/admin/templates": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Templates
+         * @description List all dashboard templates for the organization.
+         *
+         *     **For**: Admins browsing available dashboard templates
+         *     **Purpose**: Get paginated list of templates with filtering
+         *
+         *     **Flow**:
+         *     1. Retrieves templates for organization
+         *     2. Filters by status if specified
+         *     3. Returns paginated results
+         *     4. Includes template metadata (name, creation date, status)
+         *
+         *     **Query Parameters**:
+         *     - status: Filter by status (active, archived, deleted) - default: active
+         *     - limit: Number of results per page (1-500) - default: 100
+         *     - offset: Pagination offset (0+) - default: 0
+         *
+         *     **Authentication**: Required (JWT token with dashboard_template.view.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Paginated list with:
+         *     - templates: Array of template summaries
+         *     - total_count: Total templates matching filter
+         *     - limit: Items per page
+         *     - offset: Current offset
+         *
+         *     **Validation**:
+         *     - Status must be: active, archived, or deleted
+         *     - Limit must be between 1 and 500
+         */
+        get: operations["listDashboardTemplates"];
+        put?: never;
+        /**
+         * Create Template
+         * @description Create a new dashboard template for the organization.
+         *
+         *     **For**: Admins creating custom dashboard templates
+         *     **Purpose**: Create reusable dashboard templates for organization
+         *
+         *     **Example Request Body**:
+         *     ```json
+         *     {
+         *       "template_name": "Executive Dashboard",
+         *       "layout_config": {
+         *         "schema_version": "1.0",
+         *         "grid_columns": 12,
+         *         "widgets": [...]
+         *       }
+         *     }
+         *     ```
+         *
+         *     **Flow**:
+         *     1. Validates template name is unique within organization
+         *     2. Validates layout_config schema version
+         *     3. Validates widget references exist in widget library
+         *     4. Creates template record with external ID (dash_xxx)
+         *     5. Returns template ID and details
+         *
+         *     **Required Fields**: template_name, layout_config (with schema_version)
+         *     **Authentication**: Required (JWT token with dashboard_template.create.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Template ID, external ID, and creation timestamp
+         *     **Validation**:
+         *     - Template name must be unique per organization
+         *     - Layout config must include schema_version
+         *     - All widget references must exist in library
+         */
+        post: operations["createDashboardTemplate"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/dashboards/admin/templates/{template_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Template
+         * @description Get a specific dashboard template by ID.
+         *
+         *     **For**: Admins viewing template details
+         *     **Purpose**: Retrieve complete template configuration including layout
+         *
+         *     **Flow**:
+         *     1. Validates template ID format (dash_xxx)
+         *     2. Retrieves template details from database
+         *     3. Returns template with layout configuration
+         *     4. Includes widget definitions and metadata
+         *
+         *     **Path Parameters**: template_id (dashboard template external ID like dash_xxx)
+         *     **Authentication**: Required (JWT token with dashboard_template.view.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Complete template object with:
+         *     - template_id: External ID
+         *     - template_name: Template name
+         *     - layout_config: Full layout configuration with widgets
+         *     - status: Template status (active, archived, deleted)
+         *     - created_at, updated_at: Timestamps
+         *
+         *     **Validation**:
+         *     - Template must exist
+         *     - Template ID must be valid format (dash_xxx)
+         */
+        get: operations["getDashboardTemplate"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete Template
+         * @description Soft delete a dashboard template.
+         *
+         *     **For**: Admins removing dashboard templates
+         *     **Purpose**: Remove template from active use (preserves data)
+         *
+         *     **Flow**:
+         *     1. Validates template exists and belongs to organization
+         *     2. Checks for active role assignments
+         *     3. Checks for dependent templates (parent relationships)
+         *     4. Marks template as deleted (soft delete)
+         *     5. Records deletion reason if provided
+         *     6. Returns deletion confirmation
+         *
+         *     **Path Parameters**: template_id (dashboard template external ID like dash_xxx)
+         *     **Request Body**: Optional deletion reason
+         *     **Authentication**: Required (JWT token with dashboard_template.delete.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Deletion confirmation with:
+         *     - template_id: Deleted template ID
+         *     - deleted: True
+         *     - deleted_at: Deletion timestamp
+         *
+         *     **Validation**:
+         *     - Template must exist and belong to organization
+         *     - Cannot delete if template has active role assignments
+         *     - Cannot delete if template is parent to other templates
+         *     - Soft delete preserves data for audit purposes
+         */
+        delete: operations["deleteDashboardTemplate"];
+        options?: never;
+        head?: never;
+        /**
+         * Update Template
+         * @description Update an existing dashboard template.
+         *
+         *     **For**: Admins modifying dashboard templates
+         *     **Purpose**: Modify template configuration, layout, or settings
+         *
+         *     **Flow**:
+         *     1. Validates template exists and belongs to organization
+         *     2. Validates update fields are allowed
+         *     3. If layout_config updated, validates schema version and widgets
+         *     4. Updates template record
+         *     5. Returns updated template details
+         *
+         *     **Path Parameters**: template_id (dashboard template external ID like dash_xxx)
+         *     **Request Body**: Partial update (only include fields to change)
+         *     **Authentication**: Required (JWT token with dashboard_template.edit.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Updated template with:
+         *     - template_id: External ID
+         *     - template_name: Updated name (if changed)
+         *     - updated_at: Update timestamp
+         *
+         *     **Validation**:
+         *     - Template must exist and belong to organization
+         *     - If template_name updated, must be unique
+         *     - If layout_config updated, must include schema_version
+         *     - All widget references must exist in library
+         */
+        patch: operations["updateDashboardTemplate"];
+        trace?: never;
+    };
+    "/v1/dashboards/admin/role-assignments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Role Assignments
+         * @description List all dashboard role assignments for the organization.
+         *
+         *     **For**: Admins viewing role-based dashboard configuration
+         *     **Purpose**: View which dashboards are assigned to which roles
+         *
+         *     **Flow**:
+         *     1. Retrieves all role assignments for organization
+         *     2. Includes template details for each assignment
+         *     3. Includes role information
+         *     4. Returns sorted list by priority (highest first)
+         *
+         *     **Authentication**: Required (JWT token with dashboard_role_assignment.view.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: List of assignments with:
+         *     - assignment_id: Internal assignment ID
+         *     - template_id: Dashboard template external ID
+         *     - template_name: Dashboard name
+         *     - user_role_id: Role ID
+         *     - priority: Assignment priority
+         *     - created_at: Assignment creation timestamp
+         *
+         *     **Validation**:
+         *     - User must have dashboard_role_assignment.view.all permission
+         */
+        get: operations["listRoleAssignments"];
+        put?: never;
+        /**
+         * Assign Template To Role
+         * @description Assign a dashboard template to a user role.
+         *
+         *     **For**: Admins configuring role-based dashboard assignments
+         *     **Purpose**: Configure which dashboard users see based on their role
+         *
+         *     **Example Request Body**:
+         *     ```json
+         *     {
+         *       "template_id": "dash_3W4X5Y6zA7B8cd9E",
+         *       "user_role_id": 5,
+         *       "priority": 10
+         *     }
+         *     ```
+         *
+         *     **Flow**:
+         *     1. Validates template exists and belongs to organization
+         *     2. Validates user role exists in organization
+         *     3. Checks for duplicate assignment (template + role combination)
+         *     4. Creates role assignment with specified priority
+         *     5. Logs audit trail for assignment
+         *     6. Returns assignment confirmation
+         *
+         *     **Required Fields**: template_id, user_role_id
+         *     **Optional Fields**: priority (default: 0)
+         *     **Authentication**: Required (JWT token with dashboard_role_assignment.create.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Assignment ID and details
+         *     **Validation**:
+         *     - Template must exist and belong to organization
+         *     - Role must exist in organization
+         *     - Priority determines resolution order (higher priority wins)
+         *     - When a user has multiple roles, highest priority assignment is used
+         */
+        post: operations["createDashboardRoleAssignment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/dashboards/admin/role-assignments/{assignment_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Remove Role Assignment
+         * @description Remove a dashboard role assignment.
+         *
+         *     **For**: Admins managing role-based dashboard assignments
+         *     **Purpose**: Unassign a dashboard from a role
+         *
+         *     **Flow**:
+         *     1. Validates assignment exists and belongs to organization
+         *     2. Captures assignment state for audit trail
+         *     3. Deletes role assignment record
+         *     4. Logs audit action with before/after state
+         *     5. Returns deletion confirmation
+         *
+         *     **Path Parameters**: assignment_id (assignment record internal ID)
+         *     **Authentication**: Required (JWT token with dashboard_role_assignment.delete.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Assignment ID and deletion confirmation
+         *     **Validation**:
+         *     - Assignment must exist
+         *     - Assignment must belong to organization
+         *     - Audit logging is mandatory (RBAC requirement)
+         *
+         *     **Effect**: Role will no longer have this dashboard assigned
+         *     **Note**: Users with this role will fall back to next priority level in dashboard resolution
+         */
+        delete: operations["deleteRoleAssignment"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/dashboards/admin/widgets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Available Widgets
+         * @description List all available widgets for the organization.
+         *
+         *     **For**: Admins browsing widget library
+         *     **Purpose**: Get complete widget library (global platform + org-specific custom widgets)
+         *
+         *     **Flow**:
+         *     1. Retrieves global platform widgets (is_global=TRUE)
+         *     2. Retrieves organization-specific custom widgets
+         *     3. Combines both lists
+         *     4. Returns sorted widget library
+         *
+         *     **Authentication**: Required (JWT token with dashboard_widget.view.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Widget library with:
+         *     - widgets: Array of widget definitions
+         *     - total_count: Total widgets available
+         *     - Each widget includes: widget_id, widget_key, widget_name, widget_type, is_global
+         *
+         *     **Validation**:
+         *     - User must have dashboard_widget.view.all permission
+         */
+        get: operations["listAvailableWidgets"];
+        put?: never;
+        /**
+         * Create Custom Widget
+         * @description Create a custom widget for the organization.
+         *
+         *     **For**: Admins creating organization-specific widgets
+         *     **Purpose**: Add custom widgets to org widget library
+         *
+         *     **Example Request Body**:
+         *     ```json
+         *     {
+         *       "widget_key": "custom_metric",
+         *       "widget_name": "Custom Metric",
+         *       "widget_type": "metric",
+         *       "provider_key": "CustomDataProvider.get_metric",
+         *       "default_config": {"date_range": "30d"}
+         *     }
+         *     ```
+         *
+         *     **Flow**:
+         *     1. Validates widget_key is unique within organization
+         *     2. Validates widget_type is valid (metric, chart, table, list, alert)
+         *     3. Validates provider_key format (ProviderClass.method_name)
+         *     4. Creates widget record with external ID (wdg_xxx)
+         *     5. Registers widget in library
+         *     6. Returns widget ID and details
+         *
+         *     **Required Fields**: widget_key, widget_name, widget_type, provider_key
+         *     **Optional Fields**: default_config, description, icon
+         *     **Provider Key Format**: ProviderClass.method_name
+         *     **Authentication**: Required (JWT token with dashboard_widget.manage.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Widget ID, external ID, and creation confirmation
+         *     **Validation**:
+         *     - widget_key must be unique per organization
+         *     - widget_type must be: metric, chart, table, list, or alert
+         *     - provider_key must reference valid data provider method
+         */
+        post: operations["createCustomWidget"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/dashboards/admin/widgets/{widget_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete Custom Widget
+         * @description Delete a custom widget (soft delete).
+         *
+         *     **For**: Admins removing organization-specific widgets
+         *     **Purpose**: Remove custom widget from library
+         *
+         *     **Flow**:
+         *     1. Validates widget exists and belongs to organization
+         *     2. Checks widget is NOT global (only org widgets can be deleted)
+         *     3. Marks widget as deleted (soft delete)
+         *     4. Returns deletion confirmation
+         *
+         *     **Path Parameters**: widget_id (widget external ID like wdg_xxx)
+         *     **Authentication**: Required (JWT token with dashboard_widget.manage.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Deletion confirmation with:
+         *     - widget_id: Deleted widget ID
+         *     - deleted: True
+         *
+         *     **Validation**:
+         *     - Widget must exist and belong to organization
+         *     - Cannot delete global platform widgets (is_global=TRUE)
+         *     - Soft delete preserves data for audit purposes
+         *
+         *     **Note**: Dashboards using this widget will need to be updated manually
+         */
+        delete: operations["deleteCustomWidget"];
+        options?: never;
+        head?: never;
+        /**
+         * Update Custom Widget
+         * @description Update a custom widget.
+         *
+         *     **For**: Admins modifying organization-specific widgets
+         *     **Purpose**: Modify custom widget configuration
+         *
+         *     **Flow**:
+         *     1. Validates widget exists and belongs to organization
+         *     2. Checks widget is NOT global (only org widgets can be updated)
+         *     3. Validates update fields
+         *     4. Updates widget record
+         *     5. Returns updated widget details
+         *
+         *     **Path Parameters**: widget_id (widget external ID like wdg_xxx)
+         *     **Request Body**: Partial update (only include fields to change)
+         *     **Authentication**: Required (JWT token with dashboard_widget.manage.all permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Updated widget with:
+         *     - widget_id: External ID
+         *     - widget_key, widget_name: Updated values
+         *     - updated_at: Update timestamp
+         *
+         *     **Validation**:
+         *     - Widget must exist and belong to organization
+         *     - Cannot update global platform widgets (is_global=TRUE)
+         *     - If widget_key updated, must be unique
+         *     - If provider_key updated, must be valid format
+         *
+         *     **Note**: Global platform widgets are immutable
+         */
+        patch: operations["updateCustomWidget"];
+        trace?: never;
+    };
+    "/v1/me/dashboard": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get My Dashboard
+         * @description Get the user's dashboard with 5-step priority resolution.
+         *
+         *     **For**: Users accessing their personalized dashboard
+         *     **Purpose**: Retrieve dashboard configuration with automatic priority resolution
+         *
+         *     **Flow**:
+         *     1. Applies 5-step priority resolution (see below)
+         *     2. Retrieves dashboard template
+         *     3. Applies user customizations if any
+         *     4. Updates last_viewed_at timestamp
+         *     5. Returns complete dashboard configuration
+         *
+         *     **Resolution Order** (highest to lowest priority):
+         *     1. User Preference (custom template selection)
+         *     2. Sub-Tenant Override (if parent allows)
+         *     3. Role Assignment (highest priority role)
+         *     4. Org Default Template (is_default=TRUE)
+         *     5. Platform Global Template (is_global=TRUE)
+         *
+         *     **Authentication**: Required (JWT token with dashboard.view.own permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Dashboard configuration with:
+         *     - dashboard_id: Template ID used
+         *     - dashboard_name: Template name
+         *     - is_customized: Whether user has customizations
+         *     - inheritance_chain: Resolution path taken
+         *     - layout_config: Dashboard layout with widgets
+         *     - last_viewed_at: Last access timestamp
+         *
+         *     **Side Effects**: Updates last_viewed_at timestamp for analytics
+         *
+         *     **Validation**:
+         *     - User must be authenticated
+         *     - Falls back through priority chain until dashboard found
+         */
+        get: operations["getDashboard"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Customize Dashboard
+         * @description Save user dashboard customizations.
+         *
+         *     **For**: Users personalizing their dashboard layout
+         *     **Purpose**: Persist user-specific dashboard modifications
+         *
+         *     **Example Request Body**:
+         *     ```json
+         *     {
+         *       "schema_version": "1.0",
+         *       "hidden_widgets": ["wdg_abc123"],
+         *       "widget_overrides": {
+         *         "wdg_def456": {
+         *           "position": {"row": 1, "col": 0, "width": 6, "height": 3},
+         *           "config": {"date_range": "7d"}
+         *         }
+         *       }
+         *     }
+         *     ```
+         *
+         *     **Flow**:
+         *     1. Validates schema version is "1.0"
+         *     2. Validates widget references exist
+         *     3. Saves customization to user preferences
+         *     4. Returns confirmation
+         *
+         *     **Customization Options**:
+         *     - hidden_widgets: List of widget IDs to hide
+         *     - widget_overrides: Modify widget position/config
+         *     - added_widgets: Add custom widgets
+         *
+         *     **Required Fields**: schema_version
+         *     **Optional Fields**: hidden_widgets, widget_overrides, added_widgets
+         *     **Authentication**: Required (JWT token with dashboard.customize.own permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Customization confirmation
+         *     **Validation**:
+         *     - Schema version must be "1.0"
+         *     - All widget references must exist in library
+         *     - Widget positions must not overlap (validation happens client-side)
+         */
+        patch: operations["updateDashboard"];
+        trace?: never;
+    };
+    "/v1/me/dashboard/resets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Reset Dashboard
+         * @description Reset dashboard to default (remove all customizations).
+         *
+         *     **For**: Users reverting to default dashboard layout
+         *     **Purpose**: Restore dashboard to org/role default settings
+         *
+         *     **Flow**:
+         *     1. Deletes all user customizations
+         *     2. Clears user preference settings
+         *     3. Returns confirmation
+         *     4. Next GET request will resolve through priority chain
+         *
+         *     **Authentication**: Required (JWT token with dashboard.customize.own permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Reset confirmation
+         *     **Effect**:
+         *     - Deletes all user customizations (hidden widgets, overrides)
+         *     - Next GET will resolve to role/org/global default
+         *     - Preserves last_viewed_at history for analytics
+         *
+         *     **Validation**:
+         *     - User must be authenticated
+         *     - No request body required
+         */
+        post: operations["resetDashboard"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/dashboard/exports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Export Dashboard
+         * @description Export dashboard to PDF or Excel.
+         *
+         *     **For**: Users exporting their dashboard data
+         *     **Purpose**: Generate downloadable dashboard report
+         *
+         *     **Example Request Body**:
+         *     ```json
+         *     {
+         *       "format": "pdf",
+         *       "include_data": true
+         *     }
+         *     ```
+         *
+         *     **Flow** (Planned for Phase 8):
+         *     1. Retrieves user dashboard configuration
+         *     2. Fetches current widget data
+         *     3. Generates export file in requested format
+         *     4. Returns download URL or file stream
+         *
+         *     **Supported Formats**:
+         *     - pdf: PDF document with dashboard layout
+         *     - excel: Excel spreadsheet with widget data
+         *
+         *     **Required Fields**: format
+         *     **Optional Fields**: include_data
+         *     **Authentication**: Required (JWT token with dashboard.export.own permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Export details (currently placeholder)
+         *     **Note**: This is a placeholder implementation. Phase 8 will add actual export logic.
+         *
+         *     **Validation**:
+         *     - Format must be: pdf or excel
+         *     - User must have access to dashboard
+         */
+        post: operations["exportDashboard"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/dashboard/widgets/{widget_key}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Widget Data
+         * @description Get data for a specific widget (SINGLE CANONICAL PATH).
+         *
+         *     **For**: Users fetching widget data for dashboard display
+         *     **Purpose**: Fetch widget data with automatic caching and permission filtering
+         *
+         *     **Flow**:
+         *     1. Checks cache for widget data (cache key includes config)
+         *     2. If cache HIT: Returns cached data
+         *     3. If cache MISS: Calls data provider, caches result, returns data
+         *     4. Applies user permissions filtering
+         *     5. Returns widget data
+         *
+         *     **Path Parameters**: widget_key (e.g., 'total_revenue', 'order_count', 'top_products')
+         *     **Query Parameters**:
+         *     - date_range: Predefined range (today, 7d, 30d, 90d, 1y, all) - optional
+         *     - start_date: Custom start date (ISO: YYYY-MM-DD) - optional
+         *     - end_date: Custom end date (ISO: YYYY-MM-DD) - optional
+         *     - limit: Result limit for list widgets (1-1000) - default: 10
+         *     - company_id: Filter by company - optional
+         *     - space_id: Filter by space - optional
+         *
+         *     **Authentication**: Required (JWT token with dashboard.view.own permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Widget data with type-specific structure
+         *     **Cache Behavior**:
+         *     - Cache HIT: Returns cached data (TTL varies by widget type)
+         *     - Cache MISS: Fetches fresh data, caches it, returns data
+         *     - cache_status is NOT included in response (internal optimization)
+         *
+         *     **Widget Types & Cache TTL**:
+         *     - metric: 60 seconds
+         *     - chart: 5 minutes (300s)
+         *     - table: 30 seconds
+         *     - list: 60 seconds
+         *     - alert: 2 minutes (120s)
+         *
+         *     **Example**: `/v1/dashboards/widgets/total_revenue?date_range=30d&company_id=5`
+         *
+         *     **Validation**:
+         *     - Widget must exist in library
+         *     - User must have permission to view widget data
+         *     - Date range or start/end dates can be specified (not both)
+         */
+        get: operations["getWidget"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me/dashboard/widgets/{widget_key}/cache": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Refresh Widget Cache
+         * @description Force refresh widget cache (invalidate and fetch fresh data).
+         *
+         *     **For**: Users requesting real-time widget data
+         *     **Purpose**: Get latest data bypassing cache
+         *
+         *     **Flow**:
+         *     1. Invalidates existing cache entry for widget+config
+         *     2. Fetches fresh data from data provider
+         *     3. Stores fresh data in cache with TTL
+         *     4. Returns fresh data to user
+         *
+         *     **Path Parameters**: widget_key (widget identifier)
+         *     **Query Parameters**: Same as GET endpoint
+         *     - date_range, start_date, end_date, limit, company_id, space_id
+         *
+         *     **Authentication**: Required (JWT token with dashboard.view.own permission)
+         *     **Headers**:
+         *     - Authorization: Bearer <token>
+         *
+         *     **Response**: Fresh widget data
+         *     **Use Cases**:
+         *     - Real-time updates needed (after placing order, payment, etc.)
+         *     - Suspicious cached data
+         *     - After manual data modification
+         *     - User explicitly requests refresh
+         *
+         *     **Validation**:
+         *     - Widget must exist in library
+         *     - User must have permission to view widget
+         *     - Same validation as GET endpoint
+         *
+         *     **Note**: Use sparingly to avoid database load. Regular GET requests use cache efficiently.
+         */
+        delete: operations["invalidateWidgetCache"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /**
+         * TemplateCreateRequest
+         * @description Request model for creating dashboard template
+         * @example {
+         *       "allow_child_override": true,
+         *       "description": "Dashboard for executives with key metrics",
+         *       "is_default": false,
+         *       "layout_config": {
+         *         "grid_columns": 12,
+         *         "schema_version": "1.0",
+         *         "widgets": [
+         *           {
+         *             "config": {
+         *               "date_range": "30d"
+         *             },
+         *             "position": {
+         *               "col": 0,
+         *               "height": 2,
+         *               "row": 0,
+         *               "width": 4
+         *             },
+         *             "widget_id": "wdg_abc123",
+         *             "widget_key": "total_revenue"
+         *           }
+         *         ]
+         *       },
+         *       "template_name": "Executive Dashboard",
+         *       "template_type": "custom"
+         *     }
+         */
+        TemplateCreateRequest: {
+            /**
+             * Template Name
+             * @description Template name
+             */
+            template_name: string;
+            /**
+             * Template Type
+             * @description Template type: global, org_default, custom
+             * @default custom
+             */
+            template_type: string;
+            /**
+             * Description
+             * @description Template description
+             */
+            description?: string | null;
+            /**
+             * Layout Config
+             * @description Dashboard layout configuration
+             */
+            layout_config: {
+                [key: string]: unknown;
+            };
+            /**
+             * Is Default
+             * @description Set as org default template
+             * @default false
+             */
+            is_default: boolean;
+            /**
+             * Is Global
+             * @description Global template (platform-wide)
+             * @default false
+             */
+            is_global: boolean;
+            /**
+             * Allow Child Override
+             * @description Allow child tenants to override
+             * @default true
+             */
+            allow_child_override: boolean;
+            /**
+             * Inherit From Template Id
+             * @description Parent template ID for inheritance
+             */
+            inherit_from_template_id?: number | null;
+        };
+        /**
+         * DeleteTemplateRequest
+         * @description Request model for deleting dashboard template
+         */
+        DeleteTemplateRequest: {
+            /**
+             * Deleted Reason
+             * @description Reason for deletion
+             */
+            deleted_reason?: string | null;
+        };
+        Extensions: {
+            /** @example GENERIC_ERROR */
+            message_code?: string;
+            /** @example [] */
+            invalid_params?: components["schemas"]["InvalidParam"][];
+            extra_data?: Record<string, never> | null;
+            /** @example Detailed debug information */
+            debug?: string | null;
+        };
+        /**
+         * WidgetCreateRequest
+         * @description Request model for creating custom widget
+         * @example {
+         *       "default_config": {
+         *         "date_range": "30d"
+         *       },
+         *       "description": "Custom metric for tracking KPIs",
+         *       "provider_key": "CustomDataProvider.get_metric",
+         *       "required_permissions": [
+         *         "analytics_view"
+         *       ],
+         *       "supported_sizes": [
+         *         "small",
+         *         "medium"
+         *       ],
+         *       "widget_category": "custom",
+         *       "widget_key": "custom_metric",
+         *       "widget_name": "Custom Metric",
+         *       "widget_type": "metric"
+         *     }
+         */
+        WidgetCreateRequest: {
+            /**
+             * Widget Key
+             * @description Unique widget key (e.g., 'total_revenue')
+             */
+            widget_key: string;
+            /**
+             * Widget Name
+             * @description Display name
+             */
+            widget_name: string;
+            /**
+             * Widget Type
+             * @description Widget type: metric, chart, table, list, alert
+             */
+            widget_type: string;
+            /**
+             * Widget Category
+             * @description Category: analytics, sales, operations, custom
+             * @default custom
+             */
+            widget_category: string;
+            /**
+             * Provider Key
+             * @description Data provider binding (e.g., 'RevenueDataProvider.get_total_revenue')
+             */
+            provider_key: string;
+            /**
+             * Description
+             * @description Widget description
+             */
+            description?: string | null;
+            /**
+             * Default Config
+             * @description Default configuration
+             */
+            default_config?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Required Permissions
+             * @description Required permissions to view
+             */
+            required_permissions?: string[] | null;
+            /**
+             * Supported Sizes
+             * @description Supported widget sizes
+             */
+            supported_sizes?: string[] | null;
+        };
+        /**
+         * RoleAssignmentRequest
+         * @description Request model for assigning dashboard to role
+         * @example {
+         *       "priority": 10,
+         *       "template_id": "dash_3W4X5Y6zA7B8cd9E",
+         *       "user_role_id": 5
+         *     }
+         */
+        RoleAssignmentRequest: {
+            /**
+             * Template Id
+             * @description Dashboard template external ID (dash_xxx)
+             */
+            template_id: string;
+            /**
+             * User Role Id
+             * @description User role ID to assign template to
+             */
+            user_role_id: number;
+            /**
+             * Priority
+             * @description Priority for multi-role users (higher = higher priority)
+             * @default 0
+             */
+            priority: number;
+        };
+        /**
+         * WidgetUpdateRequest
+         * @description Request model for updating custom widget
+         */
+        WidgetUpdateRequest: {
+            /** Widget Name */
+            widget_name?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Default Config */
+            default_config?: {
+                [key: string]: unknown;
+            } | null;
+            /** Required Permissions */
+            required_permissions?: string[] | null;
+            /** Supported Sizes */
+            supported_sizes?: string[] | null;
+            /**
+             * Status
+             * @description Status: active, inactive, deleted
+             */
+            status?: 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"];
+        };
+        /**
+         * CustomizationRequest
+         * @description Request model for saving dashboard customizations
+         * @example {
+         *       "added_widgets": [],
+         *       "hidden_widgets": [
+         *         "wdg_abc123"
+         *       ],
+         *       "schema_version": "1.0",
+         *       "widget_overrides": {
+         *         "wdg_def456": {
+         *           "config": {
+         *             "date_range": "7d"
+         *           },
+         *           "position": {
+         *             "col": 0,
+         *             "height": 3,
+         *             "row": 1,
+         *             "width": 6
+         *           }
+         *         }
+         *       }
+         *     }
+         */
+        CustomizationRequest: {
+            /**
+             * Schema Version
+             * @description Schema version
+             * @default 1.0
+             */
+            schema_version: string;
+            /**
+             * Hidden Widgets
+             * @description Widget IDs to hide
+             */
+            hidden_widgets?: string[] | null;
+            /**
+             * Widget Overrides
+             * @description Widget-specific overrides (position, config)
+             */
+            widget_overrides?: {
+                [key: string]: {
+                    [key: string]: unknown;
+                };
+            } | null;
+            /**
+             * Added Widgets
+             * @description Custom widgets added by user
+             */
+            added_widgets?: {
+                [key: string]: unknown;
+            }[] | null;
+        };
+        InvalidParam: {
+            /** @example items[0].quantity */
+            field?: string;
+            /** @example Input should be greater than or equal to 1 */
+            error?: 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"];
+        };
+        /**
+         * ExportRequest
+         * @description Request model for exporting dashboard
+         */
+        ExportRequest: {
+            /**
+             * Format
+             * @description Export format: pdf, excel
+             * @default pdf
+             */
+            format: string;
+            /**
+             * Include Data
+             * @description Include widget data in export
+             * @default true
+             */
+            include_data: boolean;
+        };
+        /**
+         * TemplateUpdateRequest
+         * @description Request model for updating dashboard template
+         */
+        TemplateUpdateRequest: {
+            /** Template Name */
+            template_name?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Layout Config */
+            layout_config?: {
+                [key: string]: unknown;
+            } | null;
+            /** Is Default */
+            is_default?: boolean | null;
+            /** Allow Child Override */
+            allow_child_override?: boolean | null;
+            /**
+             * Status
+             * @description Status: active, archived
+             */
+            status?: string | null;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    listDashboardTemplates: {
+        parameters: {
+            query?: {
+                /** @description Filter by status */
+                status?: string;
+                /** @description Page number (1-based) */
+                page?: number;
+                /** @description Items per page (1–500, default 100) */
+                limit?: number;
+            };
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    createDashboardTemplate: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TemplateCreateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    getDashboardTemplate: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                template_id: string;
+            };
+            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"];
+                };
+            };
+        };
+    };
+    deleteDashboardTemplate: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                template_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["DeleteTemplateRequest"];
+            };
+        };
+        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"];
+                };
+            };
+        };
+    };
+    updateDashboardTemplate: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                template_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TemplateUpdateRequest"];
+            };
+        };
+        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"];
+                };
+            };
+        };
+    };
+    listRoleAssignments: {
+        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"];
+                };
+            };
+        };
+    };
+    createDashboardRoleAssignment: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RoleAssignmentRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    deleteRoleAssignment: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                assignment_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    listAvailableWidgets: {
+        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"];
+                };
+            };
+        };
+    };
+    createCustomWidget: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WidgetCreateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An error occurred",
+                     *       "message_code": "GENERIC_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/client-error",
+                     *         "code": "GENERIC_ERROR",
+                     *         "title": "Client Error",
+                     *         "status": 400,
+                     *         "detail": "An error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "GENERIC_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Unprocessable Entity */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "One or more input fields are invalid",
+                     *       "message_code": "INVALID_INPUT",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/invalid-input",
+                     *         "code": "INVALID_INPUT",
+                     *         "title": "Invalid Input",
+                     *         "status": 422,
+                     *         "detail": "One or more input fields are invalid",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "INVALID_INPUT",
+                     *           "invalid_params": [
+                     *             {
+                     *               "field": "items[0].quantity",
+                     *               "error": "Input should be greater than or equal to 1"
+                     *             }
+                     *           ]
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Too Many Requests */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "Too many requests",
+                     *       "message_code": "RATE_LIMIT_EXCEEDED",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
+                     *         "code": "RATE_LIMIT_EXCEEDED",
+                     *         "title": "Rate Limit Exceeded",
+                     *         "status": 429,
+                     *         "detail": "Too many requests",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "RATE_LIMIT_EXCEEDED",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+            /** @description Internal Server Error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "status": "error",
+                     *       "message": "An unexpected error occurred",
+                     *       "message_code": "SERVER_ERROR",
+                     *       "metadata": {
+                     *         "timestamp": "2025-08-05T18:38:57Z",
+                     *         "requestId": "uuid",
+                     *         "traceId": "uuid",
+                     *         "version": "v1",
+                     *         "executionTime": 0,
+                     *         "language": "en-US",
+                     *         "links": [
+                     *           {
+                     *             "rel": "self",
+                     *             "href": "/v1/cart/items",
+                     *             "method": "POST"
+                     *           }
+                     *         ]
+                     *       },
+                     *       "error": {
+                     *         "type": "https://{your-domain}/errors/server-error",
+                     *         "code": "SERVER_ERROR",
+                     *         "title": "Server Error",
+                     *         "status": 500,
+                     *         "detail": "An unexpected error occurred",
+                     *         "instance": "/v1/cart/items",
+                     *         "extensions": {
+                     *           "message_code": "SERVER_ERROR",
+                     *           "invalid_params": []
+                     *         }
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["StandardResponse"];
+                };
+            };
+        };
+    };
+    deleteCustomWidget: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                widget_id: string;
+            };
+            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"];
+                };
+            };
+        };
+    };
+    updateCustomWidget: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                widget_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WidgetUpdateRequest"];
+            };
+        };
+        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"];
+                };
+            };
+        };
+    };
+    getDashboard: {
+        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"];
+                };
+            };
+        };
+    };
+    updateDashboard: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CustomizationRequest"];
+            };
+        };
+        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"];
+                };
+            };
+        };
+    };
+    resetDashboard: {
+        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"];
+                };
+            };
+        };
+    };
+    exportDashboard: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ExportRequest"];
+            };
+        };
+        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"];
+                };
+            };
+        };
+    };
+    getWidget: {
+        parameters: {
+            query?: {
+                /** @description Predefined date range: today, 7d, 30d, 90d, 1y, all */
+                date_range?: string | null;
+                /** @description Custom start date (ISO: YYYY-MM-DD) */
+                start_date?: string | null;
+                /** @description Custom end date (ISO: YYYY-MM-DD) */
+                end_date?: string | null;
+                /** @description Result limit for list widgets */
+                limit?: number;
+                /** @description Filter by company ID */
+                company_id?: number | null;
+                /** @description Filter by space ID */
+                space_id?: number | null;
+            };
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                widget_key: string;
+            };
+            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"];
+                };
+            };
+        };
+    };
+    invalidateWidgetCache: {
+        parameters: {
+            query?: {
+                /** @description Predefined date range: today, 7d, 30d, 90d, 1y, all */
+                date_range?: string | null;
+                /** @description Custom start date (ISO: YYYY-MM-DD) */
+                start_date?: string | null;
+                /** @description Custom end date (ISO: YYYY-MM-DD) */
+                end_date?: string | null;
+                /** @description Result limit for list widgets */
+                limit?: number;
+                /** @description Filter by company ID */
+                company_id?: number | null;
+                /** @description Filter by space ID */
+                space_id?: number | null;
+            };
+            header?: {
+                authorization?: string | null;
+            };
+            path: {
+                widget_key: string;
+            };
+            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