@djangocfg/api 2.1.261 → 2.1.263

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "2.1.261",
+  "version": "2.1.263",
   "description": "Auto-generated TypeScript API client with React hooks, SWR integration, and Zod validation for Django REST Framework backends",
   "keywords": [
     "django",
@@ -84,7 +84,7 @@
   "devDependencies": {
     "@types/node": "^24.7.2",
     "@types/react": "^19.1.0",
-    "@djangocfg/typescript-config": "^2.1.261",
+    "@djangocfg/typescript-config": "^2.1.263",
     "next": "^16.0.10",
     "react": "^19.1.0",
     "tsup": "^8.5.0",

package/src/_api/generated/cfg_accounts/_utils/fetchers/accounts__oauth.ts

@@ -35,6 +35,7 @@ import { consola } from 'consola'
 import { OAuthAuthorizeRequestRequestSchema, type OAuthAuthorizeRequestRequest } from '../schemas/OAuthAuthorizeRequestRequest.schema'
 import { OAuthAuthorizeResponseSchema, type OAuthAuthorizeResponse } from '../schemas/OAuthAuthorizeResponse.schema'
 import { OAuthCallbackRequestRequestSchema, type OAuthCallbackRequestRequest } from '../schemas/OAuthCallbackRequestRequest.schema'
+import { OAuthConnectionSchema, type OAuthConnection } from '../schemas/OAuthConnection.schema'
 import { OAuthDisconnectRequestRequestSchema, type OAuthDisconnectRequestRequest } from '../schemas/OAuthDisconnectRequestRequest.schema'
 import { OAuthProvidersResponseSchema, type OAuthProvidersResponse } from '../schemas/OAuthProvidersResponse.schema'
 import { OAuthTokenResponseSchema, type OAuthTokenResponse } from '../schemas/OAuthTokenResponse.schema'
@@ -47,10 +48,53 @@ import { getAPIInstance } from '../../api-instance'
  * @path /cfg/accounts/oauth/connections/
  */
 export async function getAccountsOauthConnectionsList(  client?: any
-): Promise<any> {
+): Promise<OAuthConnection[]> {
   const api = client || getAPIInstance()
   const response = await api.oauth.accountsOauthConnectionsList()
-  return response
+  try {
+    return OAuthConnectionSchema.array().parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`getAccountsOauthConnectionsList\nPath: /cfg/accounts/oauth/connections/\nMethod: GET`);
+
+    if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
+      consola.error('Validation Issues:');
+      (error as any).issues.forEach((issue: any, index: number) => {
+        consola.error(`  ${index + 1}. ${issue.path.join('.') || 'root'}`);
+        consola.error(`     ├─ Message: ${issue.message}`);
+        if (issue.expected) consola.error(`     ├─ Expected: ${issue.expected}`);
+        if (issue.received) consola.error(`     └─ Received: ${issue.received}`);
+      });
+    }
+
+    consola.error('Response data:', response);
+
+    // Dispatch browser CustomEvent (only if window is defined)
+    if (typeof window !== 'undefined' && error instanceof Error && 'issues' in error) {
+      try {
+        const event = new CustomEvent('zod-validation-error', {
+          detail: {
+            operation: 'getAccountsOauthConnectionsList',
+            path: '/cfg/accounts/oauth/connections/',
+            method: 'GET',
+            error: error,
+            response: response,
+            timestamp: new Date(),
+          },
+          bubbles: true,
+          cancelable: false,
+        });
+        window.dispatchEvent(event);
+      } catch (eventError) {
+        // Silently fail - event dispatch should never crash the app
+        consola.warn('Failed to dispatch validation error event:', eventError);
+      }
+    }
+
+    // Re-throw the error
+    throw error;
+  }
 }
 
 

package/src/_api/generated/cfg_accounts/_utils/hooks/accounts__oauth.ts

@@ -25,6 +25,7 @@ import type { API } from '../../index'
 import type { OAuthAuthorizeRequestRequest } from '../schemas/OAuthAuthorizeRequestRequest.schema'
 import type { OAuthAuthorizeResponse } from '../schemas/OAuthAuthorizeResponse.schema'
 import type { OAuthCallbackRequestRequest } from '../schemas/OAuthCallbackRequestRequest.schema'
+import type { OAuthConnection } from '../schemas/OAuthConnection.schema'
 import type { OAuthDisconnectRequestRequest } from '../schemas/OAuthDisconnectRequestRequest.schema'
 import type { OAuthProvidersResponse } from '../schemas/OAuthProvidersResponse.schema'
 import type { OAuthTokenResponse } from '../schemas/OAuthTokenResponse.schema'
@@ -35,8 +36,8 @@ import type { OAuthTokenResponse } from '../schemas/OAuthTokenResponse.schema'
  * @method GET
  * @path /cfg/accounts/oauth/connections/
  */
-export function useAccountsOauthConnectionsList(client?: API): ReturnType<typeof useSWR<any>> {
-  return useSWR<any>(
+export function useAccountsOauthConnectionsList(client?: API): ReturnType<typeof useSWR<OAuthConnection[]>> {
+  return useSWR<OAuthConnection[]>(
     'cfg-accounts-oauth-connections',
     () => Fetchers.getAccountsOauthConnectionsList(client)
   )

package/src/_api/generated/cfg_accounts/accounts/models.ts

@@ -44,18 +44,6 @@ export interface OTPErrorResponse {
   retry_after?: number | null;
 }
 
-/**
- * Serializer for OTP request.
- * 
- * Request model (no read-only fields).
- */
-export interface OTPRequestRequest {
-  /** Email address for OTP delivery */
-  identifier: string;
-  /** Source URL for tracking registration (e.g., https://my.djangocfg.com) */
-  source_url?: string;
-}
-
 /**
  * OTP verification response. When 2FA is required: - requires_2fa: True -
  * session_id: UUID of 2FA verification session - refresh/access/user: null
@@ -78,6 +66,18 @@ export interface OTPVerifyResponse {
   should_prompt_2fa?: boolean;
 }
 
+/**
+ * Serializer for OTP request.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface OTPRequestRequest {
+  /** Email address for OTP delivery */
+  identifier: string;
+  /** Source URL for tracking registration (e.g., https://my.djangocfg.com) */
+  source_url?: string;
+}
+
 /**
  * Serializer for user details.
  * 

package/src/_api/generated/cfg_accounts/accounts__oauth/client.ts

@@ -17,7 +17,7 @@ export class Oauth {
    * 
    * Get all OAuth connections for the current user.
    */
-  async accountsOauthConnectionsList(): Promise<any> {
+  async accountsOauthConnectionsList(): Promise<Models.OAuthConnection[]> {
     const response = await this.client.request('GET', "/cfg/accounts/oauth/connections/");
     return (response as any).results || response;
   }

package/src/_api/generated/cfg_accounts/accounts__oauth/models.ts

@@ -3,13 +3,15 @@
 import * as Enums from "../enums";
 
 /**
- * Response with available OAuth providers.
+ * Request to start OAuth flow.
  * 
- * Response model (includes read-only fields).
+ * Request model (no read-only fields).
  */
-export interface OAuthProvidersResponse {
-  /** List of available OAuth providers */
-  providers: Array<Record<string, any>>;
+export interface OAuthAuthorizeRequestRequest {
+  /** URL to redirect after OAuth authorization. If not provided, uses config's site_url + callback_path */
+  redirect_uri?: string;
+  /** Optional source URL for registration tracking */
+  source_url?: string;
 }
 
 /**
@@ -25,54 +27,39 @@ export interface OAuthDisconnectRequestRequest {
 }
 
 /**
- * Error response for OAuth endpoints.
+ * Request to complete OAuth flow (callback handler).
  * 
- * Response model (includes read-only fields).
+ * Request model (no read-only fields).
  */
-export interface OAuthError {
-  /** Error code */
-  error: string;
-  /** Human-readable error description */
-  error_description?: string;
+export interface OAuthCallbackRequestRequest {
+  /** Authorization code from OAuth provider callback */
+  code: string;
+  /** State token for CSRF verification (from authorize response) */
+  state: string;
+  /** Same redirect_uri used in authorize request. If not provided, uses config's site_url + callback_path */
+  redirect_uri?: string;
 }
 
 /**
- * Request to start OAuth flow.
+ * Response with OAuth authorization URL.
  * 
- * Request model (no read-only fields).
+ * Response model (includes read-only fields).
  */
-export interface OAuthAuthorizeRequestRequest {
-  /** URL to redirect after OAuth authorization. If not provided, uses config's site_url + callback_path */
-  redirect_uri?: string;
-  /** Optional source URL for registration tracking */
-  source_url?: string;
+export interface OAuthAuthorizeResponse {
+  /** Full URL to redirect user to OAuth provider */
+  authorization_url: string;
+  /** State token for CSRF protection. Store this and verify on callback. */
+  state: string;
 }
 
 /**
- * Response with JWT tokens after OAuth authentication. When 2FA is required: -
- * requires_2fa: True - session_id: UUID of 2FA verification session -
- * access/refresh/user: null When 2FA is not required: - requires_2fa: False -
- * session_id: null - access/refresh/user: populated
+ * Response with available OAuth providers.
  * 
  * Response model (includes read-only fields).
  */
-export interface OAuthTokenResponse {
-  /** True if 2FA verification is required */
-  requires_2fa?: boolean;
-  /** 2FA session ID (only when requires_2fa=True) */
-  session_id?: string | null;
-  /** JWT access token (null when requires_2fa=True) */
-  access?: string | null;
-  /** JWT refresh token (null when requires_2fa=True) */
-  refresh?: string | null;
-  /** Authenticated user info (null when requires_2fa=True) */
-  user?: Record<string, any> | null;
-  /** True if a new user was created during this OAuth flow */
-  is_new_user: boolean;
-  /** True if a new OAuth connection was created */
-  is_new_connection: boolean;
-  /** True if user should be prompted to enable 2FA */
-  should_prompt_2fa?: boolean;
+export interface OAuthProvidersResponse {
+  /** List of available OAuth providers */
+  providers: Array<Record<string, any>>;
 }
 
 /**
@@ -100,28 +87,41 @@ export interface OAuthConnection {
 }
 
 /**
- * Response with OAuth authorization URL.
+ * Response with JWT tokens after OAuth authentication. When 2FA is required: -
+ * requires_2fa: True - session_id: UUID of 2FA verification session -
+ * access/refresh/user: null When 2FA is not required: - requires_2fa: False -
+ * session_id: null - access/refresh/user: populated
  * 
  * Response model (includes read-only fields).
  */
-export interface OAuthAuthorizeResponse {
-  /** Full URL to redirect user to OAuth provider */
-  authorization_url: string;
-  /** State token for CSRF protection. Store this and verify on callback. */
-  state: string;
+export interface OAuthTokenResponse {
+  /** True if 2FA verification is required */
+  requires_2fa?: boolean;
+  /** 2FA session ID (only when requires_2fa=True) */
+  session_id?: string | null;
+  /** JWT access token (null when requires_2fa=True) */
+  access?: string | null;
+  /** JWT refresh token (null when requires_2fa=True) */
+  refresh?: string | null;
+  /** Authenticated user info (null when requires_2fa=True) */
+  user?: Record<string, any> | null;
+  /** True if a new user was created during this OAuth flow */
+  is_new_user: boolean;
+  /** True if a new OAuth connection was created */
+  is_new_connection: boolean;
+  /** True if user should be prompted to enable 2FA */
+  should_prompt_2fa?: boolean;
 }
 
 /**
- * Request to complete OAuth flow (callback handler).
+ * Error response for OAuth endpoints.
  * 
- * Request model (no read-only fields).
+ * Response model (includes read-only fields).
  */
-export interface OAuthCallbackRequestRequest {
-  /** Authorization code from OAuth provider callback */
-  code: string;
-  /** State token for CSRF verification (from authorize response) */
-  state: string;
-  /** Same redirect_uri used in authorize request. If not provided, uses config's site_url + callback_path */
-  redirect_uri?: string;
+export interface OAuthError {
+  /** Error code */
+  error: string;
+  /** Human-readable error description */
+  error_description?: string;
 }
 

package/src/_api/generated/cfg_accounts/accounts__user_profile/models.ts

@@ -1,19 +1,5 @@
 // @ts-nocheck
 // Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Serializer for updating user profile.
- * 
- * Request model (no read-only fields).
- */
-export interface PatchedUserProfileUpdateRequest {
-  first_name?: string;
-  last_name?: string;
-  company?: string;
-  phone?: string;
-  position?: string;
-  language?: string;
-}
-
 /**
  * Serializer for user details.
  * 
@@ -45,6 +31,29 @@ export interface User {
   centrifugo: CentrifugoToken | null;
 }
 
+/**
+ * Serializer for updating user profile.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface PatchedUserProfileUpdateRequest {
+  first_name?: string;
+  last_name?: string;
+  company?: string;
+  phone?: string;
+  position?: string;
+  language?: string;
+}
+
+/**
+ * 
+ * Request model (no read-only fields).
+ */
+export interface CfgAccountsProfileAvatarCreateRequest {
+  /** Avatar image file (JPEG, PNG, GIF, WebP, max 5MB) */
+  avatar: File | Blob;
+}
+
 /**
  * Response serializer for account deletion.
  * 
@@ -71,15 +80,6 @@ export interface UserProfileUpdateRequest {
   language?: string;
 }
 
-/**
- * 
- * Request model (no read-only fields).
- */
-export interface CfgAccountsProfileAvatarCreateRequest {
-  /** Avatar image file (JPEG, PNG, GIF, WebP, max 5MB) */
-  avatar: File | Blob;
-}
-
 /**
  * Nested serializer for Centrifugo WebSocket connection token.
  * 

package/src/_api/generated/cfg_accounts/client.ts

@@ -166,6 +166,14 @@ export class APIClient {
     // CSRF not needed - SessionAuthentication not enabled in DRF config
     // Your API uses JWT/Token authentication (no CSRF required)
 
+    // Add Authorization header from tokenGetter (Bearer token / API key)
+    if (!headers['Authorization']) {
+      const token = this.getToken();
+      if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+      }
+    }
+
     // Log request
     if (this.logger) {
       this.logger.logRequest({

package/src/_api/generated/cfg_accounts/errors.ts

@@ -78,6 +78,11 @@ export class APIError extends Error {
       return Array.isArray(details.detail) ? details.detail.join(', ') : String(details.detail);
     }
 
+    // Check for "error" field (common in custom DRF views)
+    if (details.error) {
+      return String(details.error);
+    }
+
     // Check for "message" field
     if (details.message) {
       return String(details.message);

package/src/_api/generated/cfg_centrifugo/client.ts

@@ -157,6 +157,14 @@ export class APIClient {
     // CSRF not needed - SessionAuthentication not enabled in DRF config
     // Your API uses JWT/Token authentication (no CSRF required)
 
+    // Add Authorization header from tokenGetter (Bearer token / API key)
+    if (!headers['Authorization']) {
+      const token = this.getToken();
+      if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+      }
+    }
+
     // Log request
     if (this.logger) {
       this.logger.logRequest({

package/src/_api/generated/cfg_centrifugo/errors.ts

@@ -78,6 +78,11 @@ export class APIError extends Error {
       return Array.isArray(details.detail) ? details.detail.join(', ') : String(details.detail);
     }
 
+    // Check for "error" field (common in custom DRF views)
+    if (details.error) {
+      return String(details.error);
+    }
+
     // Check for "message" field
     if (details.message) {
       return String(details.message);

package/src/_api/generated/cfg_totp/client.ts

@@ -169,6 +169,14 @@ export class APIClient {
     // CSRF not needed - SessionAuthentication not enabled in DRF config
     // Your API uses JWT/Token authentication (no CSRF required)
 
+    // Add Authorization header from tokenGetter (Bearer token / API key)
+    if (!headers['Authorization']) {
+      const token = this.getToken();
+      if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+      }
+    }
+
     // Log request
     if (this.logger) {
       this.logger.logRequest({

package/src/_api/generated/cfg_totp/errors.ts

@@ -78,6 +78,11 @@ export class APIError extends Error {
       return Array.isArray(details.detail) ? details.detail.join(', ') : String(details.detail);
     }
 
+    // Check for "error" field (common in custom DRF views)
+    if (details.error) {
+      return String(details.error);
+    }
+
     // Check for "message" field
     if (details.message) {
       return String(details.message);

package/src/_api/generated/cfg_totp/totp__backup_codes/models.ts

@@ -1,5 +1,19 @@
 // @ts-nocheck
 // Auto-generated by DjangoCFG - see CLAUDE.md
+/**
+ * Serializer for backup codes status.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface BackupCodesStatus {
+  /** Number of unused backup codes */
+  remaining_count: number;
+  /** Total number of codes generated */
+  total_generated: number;
+  /** Warning if running low on codes */
+  warning?: string | null;
+}
+
 /**
  * Response serializer for backup codes regeneration.
  * 
@@ -22,17 +36,3 @@ export interface BackupCodesRegenerateRequest {
   code: string;
 }
 
-/**
- * Serializer for backup codes status.
- * 
- * Response model (includes read-only fields).
- */
-export interface BackupCodesStatus {
-  /** Number of unused backup codes */
-  remaining_count: number;
-  /** Total number of codes generated */
-  total_generated: number;
-  /** Warning if running low on codes */
-  warning?: string | null;
-}
-

package/src/_api/generated/cfg_totp/totp__totp_management/models.ts

@@ -2,16 +2,6 @@
 // Auto-generated by DjangoCFG - see CLAUDE.md
 import * as Enums from "../enums";
 
-/**
- * Serializer for completely disabling 2FA.
- * 
- * Request model (no read-only fields).
- */
-export interface DisableRequest {
-  /** TOTP code for verification */
-  code: string;
-}
-
 /**
  * 
  * Response model (includes read-only fields).
@@ -37,6 +27,16 @@ export interface PaginatedDeviceListResponseList {
   results: Array<DeviceListResponse>;
 }
 
+/**
+ * Serializer for completely disabling 2FA.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface DisableRequest {
+  /** TOTP code for verification */
+  code: string;
+}
+
 /**
  * Response serializer for device list endpoint.
  * 

package/src/_api/generated/cfg_totp/totp__totp_setup/models.ts

@@ -1,5 +1,30 @@
 // @ts-nocheck
 // Auto-generated by DjangoCFG - see CLAUDE.md
+/**
+ * Serializer for confirming 2FA setup with first code.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface ConfirmSetupRequest {
+  /** Device ID from setup response */
+  device_id: string;
+  /** 6-digit TOTP code from authenticator app */
+  code: string;
+}
+
+/**
+ * Response serializer for setup confirmation.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface ConfirmSetupResponse {
+  message: string;
+  /** List of backup recovery codes (save these!) */
+  backup_codes: Array<string>;
+  /** Warning message about backup codes */
+  backup_codes_warning: string;
+}
+
 /**
  * Response serializer for setup initiation.
  * 
@@ -18,18 +43,6 @@ export interface SetupResponse {
   expires_in: number;
 }
 
-/**
- * Serializer for confirming 2FA setup with first code.
- * 
- * Request model (no read-only fields).
- */
-export interface ConfirmSetupRequest {
-  /** Device ID from setup response */
-  device_id: string;
-  /** 6-digit TOTP code from authenticator app */
-  code: string;
-}
-
 /**
  * Serializer for starting 2FA setup.
  * 
@@ -40,16 +53,3 @@ export interface SetupRequest {
   device_name?: string;
 }
 
-/**
- * Response serializer for setup confirmation.
- * 
- * Response model (includes read-only fields).
- */
-export interface ConfirmSetupResponse {
-  message: string;
-  /** List of backup recovery codes (save these!) */
-  backup_codes: Array<string>;
-  /** Warning message about backup codes */
-  backup_codes_warning: string;
-}
-

package/src/_api/generated/cfg_totp/totp__totp_verification/models.ts

@@ -1,27 +1,27 @@
 // @ts-nocheck
 // Auto-generated by DjangoCFG - see CLAUDE.md
 /**
- * Serializer for backup code verification during login.
+ * Serializer for TOTP code verification during login.
  * 
  * Request model (no read-only fields).
  */
-export interface VerifyBackupRequest {
+export interface VerifyRequest {
   /** 2FA session ID from login response */
   session_id: string;
-  /** 8-character backup recovery code */
-  backup_code: string;
+  /** 6-digit TOTP code from authenticator app */
+  code: string;
 }
 
 /**
- * Serializer for TOTP code verification during login.
+ * Serializer for backup code verification during login.
  * 
  * Request model (no read-only fields).
  */
-export interface VerifyRequest {
+export interface VerifyBackupRequest {
   /** 2FA session ID from login response */
   session_id: string;
-  /** 6-digit TOTP code from authenticator app */
-  code: string;
+  /** 8-character backup recovery code */
+  backup_code: string;
 }
 
 /**