@digiteers/uloba3-sdk 1.3.12 → 1.3.14

package/dist/types.d.ts

@@ -1180,7 +1180,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    '/api/users/me': {
+    '/api/users/stats': {
         parameters: {
             query?: never;
             header?: never;
@@ -1188,8 +1188,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get current user
-         * @description Get the currently authenticated user
+         * Get user statistics
+         * @description Get comprehensive user statistics for support dashboard. Only support staff can access.
          */
         get: {
             parameters: {
@@ -1200,6 +1200,62 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
+                /** @description User statistics response for support team */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            /** @description User statistics for support team */
+                            data: {
+                                /** @description Total user counts */
+                                totals: {
+                                    /** @description Non-negative integer (0 or greater) */
+                                    all: number;
+                                    /** @description Non-negative integer (0 or greater) */
+                                    activeToday: number;
+                                    /** @description Non-negative integer (0 or greater) */
+                                    newLast7Days: number;
+                                    /** @description Non-negative integer (0 or greater) */
+                                    needsFollowup: number;
+                                };
+                                /** @description User counts by role */
+                                byRole: {
+                                    /** @description Non-negative integer (0 or greater) */
+                                    job_seeker: number;
+                                    /** @description Non-negative integer (0 or greater) */
+                                    employer: number;
+                                    /** @description Non-negative integer (0 or greater) */
+                                    admin: number;
+                                    /** @description Non-negative integer (0 or greater) */
+                                    support: number;
+                                };
+                                /** @description User counts by account status */
+                                byStatus: {
+                                    /** @description Non-negative integer (0 or greater) */
+                                    active: number;
+                                    /** @description Non-negative integer (0 or greater) */
+                                    suspended: number;
+                                    /** @description Non-negative integer (0 or greater) */
+                                    pending_verification: number;
+                                };
+                            };
+                            /** @description Metadata for user statistics response */
+                            metadata: {
+                                /** @description ID of the support user who requested the stats */
+                                supportUserId?: string;
+                                /** @description Whether the result was served from cache */
+                                cached?: boolean;
+                                /**
+                                 * Format: date-time
+                                 * @description ISO 8601 datetime format (YYYY-MM-DDTHH:mm:ss.sssZ)
+                                 */
+                                queriedAt: string;
+                            };
+                        };
+                    };
+                };
                 /** @description Default Response */
                 401: {
                     headers: {
@@ -1211,70 +1267,136 @@ export interface paths {
                         };
                     };
                 };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
             };
         };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/{id}/engagement': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         /**
-         * Update current user
-         * @description Update the currently authenticated user
+         * Get user engagement
+         * @description Get user engagement data across all platform features. Only support staff can access.
          */
-        put: {
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            /** @description Schema for updating an existing user */
-            requestBody?: {
-                content: {
-                    'application/json': {
-                        /** @description Person name with letters, spaces, dots, hyphens, and apostrophes */
-                        given_name?: string;
-                        /** @description Person name with letters, spaces, dots, hyphens, and apostrophes */
-                        family_name?: string;
-                        /** @description Person name with letters, spaces, dots, hyphens, and apostrophes */
-                        full_name?: string;
-                        phone?: string | null;
-                        picture?: string;
-                        auth0_metadata?: unknown;
-                        email_verified?: boolean;
-                        roles?: unknown;
-                    };
+                path: {
+                    id: string;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
-                /** @description Complete user entity schema representing the users table */
+                /** @description Default Response */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         'application/json': {
-                            /** Format: uuid */
-                            id: string;
-                        } & {
-                            auth0_id?: string | null;
-                            uloba_id?: string | null;
-                            uloba_immutable_id?: string | null;
-                        } & {
-                            /** Format: email */
-                            email: string;
-                            email_verified?: boolean | null;
-                            phone?: string | null;
-                        } & {
-                            given_name?: string | null;
-                            family_name?: string | null;
-                            full_name?: string | null;
-                            picture?: string | null;
-                        } & {
-                            roles?: unknown;
-                        } & {
-                            last_login?: string | null;
-                        } & {
-                            auth0_metadata?: unknown;
-                        } & {
-                            created_at?: string | null;
-                            updated_at?: string | null;
+                            /** @description User engagement data across all platform features */
+                            data: {
+                                jobs?: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    title: string;
+                                    status: string;
+                                    /** Format: date-time */
+                                    created_at: string;
+                                    applications_count?: number;
+                                }[];
+                                applications?: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    /** Format: uuid */
+                                    job_id: string;
+                                    job_title?: string;
+                                    status: string;
+                                    /** Format: date-time */
+                                    applied_at: string;
+                                }[];
+                                contracts?: {
+                                    as_worker: {
+                                        /** Format: uuid */
+                                        id: string;
+                                        title?: string;
+                                        status: string;
+                                        contract_type?: string;
+                                        /** Format: date */
+                                        start_date?: string;
+                                        /** Format: date */
+                                        end_date?: string;
+                                        /** Format: date-time */
+                                        created_at: string;
+                                    }[];
+                                    as_employer: {
+                                        /** Format: uuid */
+                                        id: string;
+                                        title?: string;
+                                        status: string;
+                                        contract_type?: string;
+                                        /** Format: date */
+                                        start_date?: string;
+                                        /** Format: date */
+                                        end_date?: string;
+                                        /** Format: date-time */
+                                        created_at: string;
+                                    }[];
+                                };
+                                inquiries?: {
+                                    sent: {
+                                        /** Format: uuid */
+                                        id: string;
+                                        inquiry_type: string;
+                                        status: string;
+                                        /** Format: date-time */
+                                        created_at: string;
+                                        message?: string;
+                                    }[];
+                                    received: {
+                                        /** Format: uuid */
+                                        id: string;
+                                        inquiry_type: string;
+                                        status: string;
+                                        /** Format: date-time */
+                                        created_at: string;
+                                        message?: string;
+                                    }[];
+                                };
+                                assistantProfile?: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    status: string;
+                                    view_count?: number;
+                                    /** Format: date-time */
+                                    created_at: string;
+                                    /** Format: date-time */
+                                    updated_at?: string;
+                                };
+                            };
                         };
                     };
                 };
@@ -1289,8 +1411,31 @@ export interface paths {
                         };
                     };
                 };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
             };
         };
+        put?: never;
         post?: never;
         delete?: never;
         options?: never;
@@ -1298,7 +1443,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    '/api/users/{id}': {
+    '/api/users/{id}/activity/timeline': {
         parameters: {
             query?: never;
             header?: never;
@@ -1306,12 +1451,16 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get user by ID
-         * @description Get a user by their ID
+         * Get user activity timeline
+         * @description Get paginated timeline of user activities. Users can view their own timeline, support staff can view any.
          */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    limit?: number;
+                    offset?: number;
+                    entity_type?: 'job' | 'application' | 'inquiry' | 'assistant' | 'contract' | 'job_listing_subscription' | 'attachment' | 'contract_case' | 'contract_invite' | 'conversation' | 'message' | 'user';
+                };
                 header?: never;
                 path: {
                     id: string;
@@ -1320,38 +1469,23 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Complete user entity schema representing the users table */
+                /** @description Default Response */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         'application/json': {
-                            /** Format: uuid */
-                            id: string;
-                        } & {
-                            auth0_id?: string | null;
-                            uloba_id?: string | null;
-                            uloba_immutable_id?: string | null;
-                        } & {
-                            /** Format: email */
-                            email: string;
-                            email_verified?: boolean | null;
-                            phone?: string | null;
-                        } & {
-                            given_name?: string | null;
-                            family_name?: string | null;
-                            full_name?: string | null;
-                            picture?: string | null;
-                        } & {
-                            roles?: unknown;
-                        } & {
-                            last_login?: string | null;
-                        } & {
-                            auth0_metadata?: unknown;
-                        } & {
-                            created_at?: string | null;
-                            updated_at?: string | null;
+                            data: unknown[];
+                            pagination: {
+                                limit: number;
+                                offset: number;
+                                has_more: boolean;
+                            };
+                            metadata: {
+                                viewerContext: string;
+                                timestamp: string;
+                            };
                         };
                     };
                 };
@@ -1367,7 +1501,7 @@ export interface paths {
                     };
                 };
                 /** @description Default Response */
-                404: {
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1387,7 +1521,1306 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    '/api/users/uloba/{uloba_id}': {
+    '/api/users/{id}/activity/summary': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get user activity summary
+         * @description Get aggregated activity summary by entity type. Users can view their own summary, support staff can view any.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    days?: number;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            data: unknown[];
+                            metadata: {
+                                viewerContext: string;
+                                period_days: number;
+                                timestamp: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/{id}/activity/engagement': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get user engagement score
+         * @description Get comprehensive engagement metrics. Users can view their own score, support staff can view any.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    days?: number;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            data: unknown;
+                            metadata: {
+                                viewerContext: string;
+                                timestamp: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/{id}/sessions/active': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get user active sessions
+         * @description Get all active sessions for a user. Users can view their own sessions, support staff can view any.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            data: unknown[];
+                            metadata: {
+                                viewerContext: string;
+                                timestamp: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/{id}/sessions/history': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get user session history
+         * @description Get paginated session history. Users can view their own history, support staff can view any.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: number;
+                    offset?: number;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            data: unknown[];
+                            pagination: {
+                                limit: number;
+                                offset: number;
+                                has_more: boolean;
+                            };
+                            metadata: {
+                                viewerContext: string;
+                                timestamp: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/me': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get current user
+         * @description Get the currently authenticated user
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        /**
+         * Update current user
+         * @description Update the currently authenticated user
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            /** @description Schema for updating an existing user */
+            requestBody?: {
+                content: {
+                    'application/json': {
+                        /** @description Person name with letters, spaces, dots, hyphens, and apostrophes */
+                        given_name?: string;
+                        /** @description Person name with letters, spaces, dots, hyphens, and apostrophes */
+                        family_name?: string;
+                        /** @description Person name with letters, spaces, dots, hyphens, and apostrophes */
+                        full_name?: string;
+                        phone?: string | null;
+                        picture?: string;
+                        auth0_metadata?: unknown;
+                        email_verified?: boolean;
+                        roles?: unknown;
+                    };
+                };
+            };
+            responses: {
+                /** @description Complete user entity schema representing the users table */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            /** Format: uuid */
+                            id: string;
+                        } & {
+                            auth0_id?: string | null;
+                            uloba_id?: string | null;
+                            uloba_immutable_id?: string | null;
+                        } & {
+                            /** Format: email */
+                            email: string;
+                            email_verified?: boolean | null;
+                            phone?: string | null;
+                        } & {
+                            given_name?: string | null;
+                            family_name?: string | null;
+                            full_name?: string | null;
+                            picture?: string | null;
+                        } & {
+                            roles?: unknown;
+                        } & {
+                            last_login?: string | null;
+                        } & {
+                            auth0_metadata?: unknown;
+                        } & {
+                            created_at?: string | null;
+                            updated_at?: string | null;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/{id}': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get user by ID
+         * @description Get a user by their ID
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Complete user entity schema representing the users table */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            /** Format: uuid */
+                            id: string;
+                        } & {
+                            auth0_id?: string | null;
+                            uloba_id?: string | null;
+                            uloba_immutable_id?: string | null;
+                        } & {
+                            /** Format: email */
+                            email: string;
+                            email_verified?: boolean | null;
+                            phone?: string | null;
+                        } & {
+                            given_name?: string | null;
+                            family_name?: string | null;
+                            full_name?: string | null;
+                            picture?: string | null;
+                        } & {
+                            roles?: unknown;
+                        } & {
+                            last_login?: string | null;
+                        } & {
+                            auth0_metadata?: unknown;
+                        } & {
+                            created_at?: string | null;
+                            updated_at?: string | null;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/uloba/{uloba_id}': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get user by uloba_id
+         * @description Get a user by their uloba_id (GUID)
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    uloba_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Complete user entity schema representing the users table */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            /** Format: uuid */
+                            id: string;
+                        } & {
+                            auth0_id?: string | null;
+                            uloba_id?: string | null;
+                            uloba_immutable_id?: string | null;
+                        } & {
+                            /** Format: email */
+                            email: string;
+                            email_verified?: boolean | null;
+                            phone?: string | null;
+                        } & {
+                            given_name?: string | null;
+                            family_name?: string | null;
+                            full_name?: string | null;
+                            picture?: string | null;
+                        } & {
+                            roles?: unknown;
+                        } & {
+                            last_login?: string | null;
+                        } & {
+                            auth0_metadata?: unknown;
+                        } & {
+                            created_at?: string | null;
+                            updated_at?: string | null;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/onboarding': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Complete onboarding
+         * @description Complete user onboarding after authentication
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    'application/json': {
+                        settings?: {
+                            theme?: string;
+                            language?: string;
+                            notifications?: {
+                                email?: boolean;
+                                sms?: boolean;
+                                push?: boolean;
+                            };
+                        };
+                        gdpr_consent?: {
+                            marketing: boolean;
+                            analytics: boolean;
+                            necessary: boolean;
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            /** Format: uuid */
+                            account_id: string;
+                            created: boolean;
+                            message: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/onboarding/status': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get onboarding status
+         * @description Check if user has completed onboarding
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            has_account: boolean;
+                            account_id: string | null;
+                            onboarding_completed: boolean;
+                            missing_steps: string[];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/change-password': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Change password
+         * @description Change user password
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    'application/json': {
+                        currentPassword: string;
+                        newPassword: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            message: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/change-email': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Change email
+         * @description Request email address change
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    'application/json': {
+                        /** Format: email */
+                        newEmail: string;
+                        password: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            message: string;
+                            pendingEmail: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/delete-account': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Delete account
+         * @description Initiate account deletion with grace period
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    'application/json': {
+                        password: string;
+                        reason?: string;
+                        feedback?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            message: string;
+                            deletionDate: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/cancel-deletion': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Cancel account deletion
+         * @description Cancel a scheduled account deletion and restore the account
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            message: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                410: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/{id}/activity/export': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Export user activity data (GDPR)
+         * @description Export all activity logs and sessions for a user in JSON format
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            data: {
+                                /** Format: uuid */
+                                user_id: string;
+                                /** Format: date-time */
+                                exported_at: string;
+                                activity_logs: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    event_name: string;
+                                    entity_type: string;
+                                    entity_id: string | null;
+                                    event_data: {
+                                        [key: string]: unknown;
+                                    };
+                                    ip_address: string | null;
+                                    user_agent: string | null;
+                                    device_type: string | null;
+                                    /** Format: date-time */
+                                    created_at: string;
+                                }[];
+                                sessions: {
+                                    /** Format: uuid */
+                                    id: string;
+                                    /** Format: date-time */
+                                    started_at: string;
+                                    ended_at: string | null;
+                                    last_activity_at: string | null;
+                                    ip_address: string | null;
+                                    user_agent: string | null;
+                                    device_type: string | null;
+                                    device_os: string | null;
+                                    browser: string | null;
+                                    country: string | null;
+                                    city: string | null;
+                                    is_active: boolean;
+                                }[];
+                                summary: {
+                                    total_activity_count: number;
+                                    first_activity: string | null;
+                                    last_activity: string | null;
+                                    event_types: string[];
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/{id}/activity': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete user activity data (GDPR)
+         * @description Delete all activity logs and sessions for a user (right to be forgotten)
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            success: boolean;
+                            deleted_activity_count: number;
+                            deleted_session_count: number;
+                        };
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/activity/cleanup-history': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get activity cleanup history
+         * @description Get history of automated activity log cleanup runs (admin only)
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            data: {
+                                /** Format: uuid */
+                                id: string;
+                                /** Format: date-time */
+                                run_at: string;
+                                deleted_authenticated_count: number;
+                                deleted_anonymous_count: number;
+                                duration_ms: number | null;
+                                success: boolean;
+                                error_message: string | null;
+                            }[];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/users/activity/cleanup': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Manually trigger activity cleanup
+         * @description Manually run activity log cleanup (admin only)
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            success: boolean;
+                            deleted_authenticated_count: number;
+                            deleted_anonymous_count: number;
+                            duration_ms: number;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/errors/': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get recent errors
+         * @description Get recent error logs. Admin/support only.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: number;
+                    offset?: number;
+                    level?: 'error' | 'warning' | 'fatal';
+                    unresolvedOnly?: boolean;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            data: unknown[];
+                            pagination: {
+                                limit: number;
+                                offset: number;
+                                has_more: boolean;
+                            };
+                            metadata: {
+                                timestamp: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        /**
+         * Log an error
+         * @description Log an error from client or server. No authentication required.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    'application/json': {
+                        level: 'error' | 'warning' | 'fatal';
+                        errorType: string;
+                        message: string;
+                        stackTrace?: string;
+                        errorCode?: string;
+                        requestPath?: string;
+                        requestMethod?: string;
+                        requestBody?: unknown;
+                        responseStatus?: number;
+                        browser?: string;
+                        deviceType?: string;
+                        os?: string;
+                        metadata?: unknown;
+                        source: 'client' | 'server' | 'api';
+                    };
+                };
+            };
+            responses: {
+                /** @description Default Response */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            data: {
+                                id: string | null;
+                                logged_at: string;
+                                warning?: string;
+                            };
+                            metadata: {
+                                timestamp: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/api/errors/stats': {
         parameters: {
             query?: never;
             header?: never;
@@ -1395,52 +2828,32 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get user by uloba_id
-         * @description Get a user by their uloba_id (GUID)
+         * Get error statistics
+         * @description Get aggregated error statistics. Admin/support only.
          */
         get: {
             parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    uloba_id: string;
+                query?: {
+                    hours?: number;
                 };
+                header?: never;
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Complete user entity schema representing the users table */
+                /** @description Default Response */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         'application/json': {
-                            /** Format: uuid */
-                            id: string;
-                        } & {
-                            auth0_id?: string | null;
-                            uloba_id?: string | null;
-                            uloba_immutable_id?: string | null;
-                        } & {
-                            /** Format: email */
-                            email: string;
-                            email_verified?: boolean | null;
-                            phone?: string | null;
-                        } & {
-                            given_name?: string | null;
-                            family_name?: string | null;
-                            full_name?: string | null;
-                            picture?: string | null;
-                        } & {
-                            roles?: unknown;
-                        } & {
-                            last_login?: string | null;
-                        } & {
-                            auth0_metadata?: unknown;
-                        } & {
-                            created_at?: string | null;
-                            updated_at?: string | null;
+                            data: unknown;
+                            metadata: {
+                                period_hours: number;
+                                timestamp: string;
+                            };
                         };
                     };
                 };
@@ -1456,7 +2869,7 @@ export interface paths {
                     };
                 };
                 /** @description Default Response */
-                404: {
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1476,7 +2889,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    '/api/users/onboarding': {
+    '/api/errors/{id}/resolve': {
         parameters: {
             query?: never;
             header?: never;
@@ -1485,34 +2898,27 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
         /**
-         * Complete onboarding
-         * @description Complete user onboarding after authentication
+         * Resolve an error
+         * @description Mark an error as resolved. Admin/support only.
          */
-        post: {
+        patch: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    id: string;
+                };
                 cookie?: never;
             };
             requestBody?: {
                 content: {
                     'application/json': {
-                        settings?: {
-                            theme?: string;
-                            language?: string;
-                            notifications?: {
-                                email?: boolean;
-                                sms?: boolean;
-                                push?: boolean;
-                            };
-                        };
-                        gdpr_consent?: {
-                            marketing: boolean;
-                            analytics: boolean;
-                            necessary: boolean;
-                        };
+                        resolutionNotes?: string;
                     };
                 };
             };
@@ -1524,22 +2930,56 @@ export interface paths {
                     };
                     content: {
                         'application/json': {
-                            /** Format: uuid */
-                            account_id: string;
-                            created: boolean;
-                            message: string;
+                            data: {
+                                id: string;
+                                resolved: boolean;
+                                resolved_at: string;
+                                resolved_by: string;
+                            };
+                            metadata: {
+                                timestamp: string;
+                            };
+                        };
+                    };
+                };
+                /** @description Default Response */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Default Response */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
                         };
                     };
                 };
             };
         };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
         trace?: never;
     };
-    '/api/users/onboarding/status': {
+    '/api/system/metrics': {
         parameters: {
             query?: never;
             header?: never;
@@ -1547,12 +2987,14 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get onboarding status
-         * @description Check if user has completed onboarding
+         * Get system metrics
+         * @description Get hourly system performance metrics. Admin/support only.
          */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    hours?: number;
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;
@@ -1566,65 +3008,27 @@ export interface paths {
                     };
                     content: {
                         'application/json': {
-                            has_account: boolean;
-                            account_id: string | null;
-                            onboarding_completed: boolean;
-                            missing_steps: string[];
+                            data: unknown[];
+                            metadata: {
+                                period_hours: number;
+                                timestamp: string;
+                            };
                         };
                     };
                 };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    '/api/users/change-password': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Change password
-         * @description Change user password
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    'application/json': {
-                        currentPassword: string;
-                        newPassword: string;
-                    };
-                };
-            };
-            responses: {
                 /** @description Default Response */
-                200: {
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         'application/json': {
-                            message: string;
+                            error: string;
                         };
                     };
                 };
                 /** @description Default Response */
-                401: {
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1636,41 +3040,35 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/api/users/change-email': {
+    '/api/system/health': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Change email
-         * @description Request email address change
+         * Get system health
+         * @description Get aggregated system health metrics. Admin/support only.
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
+                query?: {
+                    hours?: number;
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    'application/json': {
-                        /** Format: email */
-                        newEmail: string;
-                        password: string;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
                 /** @description Default Response */
                 200: {
@@ -1679,8 +3077,11 @@ export interface paths {
                     };
                     content: {
                         'application/json': {
-                            message: string;
-                            pendingEmail: string;
+                            data: unknown;
+                            metadata: {
+                                period_hours: number;
+                                timestamp: string;
+                            };
                         };
                     };
                 };
@@ -1696,7 +3097,7 @@ export interface paths {
                     };
                 };
                 /** @description Default Response */
-                409: {
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1708,41 +3109,35 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/api/users/delete-account': {
+    '/api/system/rate-limits': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Delete account
-         * @description Initiate account deletion with grace period
+         * Get rate limit statistics
+         * @description Get rate limit violation statistics. Admin/support only.
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
+                query?: {
+                    hours?: number;
+                };
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    'application/json': {
-                        password: string;
-                        reason?: string;
-                        feedback?: string;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
                 /** @description Default Response */
                 200: {
@@ -1751,8 +3146,11 @@ export interface paths {
                     };
                     content: {
                         'application/json': {
-                            message: string;
-                            deletionDate: string;
+                            data: unknown;
+                            metadata: {
+                                period_hours: number;
+                                timestamp: string;
+                            };
                         };
                     };
                 };
@@ -1767,15 +3165,28 @@ export interface paths {
                         };
                     };
                 };
+                /** @description Default Response */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        'application/json': {
+                            error: string;
+                        };
+                    };
+                };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/api/users/cancel-deletion': {
+    '/api/system/metrics/refresh': {
         parameters: {
             query?: never;
             header?: never;
@@ -1785,8 +3196,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Cancel account deletion
-         * @description Cancel a scheduled account deletion and restore the account
+         * Refresh system metrics
+         * @description Manually refresh the metrics materialized view. Admin only.
          */
         post: {
             parameters: {
@@ -1804,12 +3215,18 @@ export interface paths {
                     };
                     content: {
                         'application/json': {
-                            message: string;
+                            data: {
+                                refreshed: boolean;
+                                timestamp: string;
+                            };
+                            metadata: {
+                                timestamp: string;
+                            };
                         };
                     };
                 };
                 /** @description Default Response */
-                404: {
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1820,7 +3237,7 @@ export interface paths {
                     };
                 };
                 /** @description Default Response */
-                410: {
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };