@djangocfg/api 2.1.262 → 2.1.264

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "2.1.262",
+  "version": "2.1.264",
   "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.262",
+    "@djangocfg/typescript-config": "^2.1.264",
     "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

@@ -13,6 +13,40 @@ export interface OTPVerifyRequest {
   source_url?: string;
 }
 
+/**
+ * OTP verification response. When 2FA is required: - requires_2fa: True -
+ * session_id: UUID of 2FA verification session - refresh/access/user: null
+ * When 2FA is not required: - requires_2fa: False - session_id: null -
+ * refresh/access/user: populated
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface OTPVerifyResponse {
+  /** Whether 2FA verification is required */
+  requires_2fa?: boolean;
+  /** 2FA session ID (if requires_2fa is True) */
+  session_id?: string | null;
+  /** JWT refresh token (if requires_2fa is False) */
+  refresh?: string | null;
+  /** JWT access token (if requires_2fa is False) */
+  access?: string | null;
+  user?: User | null;
+  /** Whether user should be prompted to enable 2FA */
+  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;
+}
+
 /**
  * OTP request response.
  * 
@@ -44,40 +78,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
- * When 2FA is not required: - requires_2fa: False - session_id: null -
- * refresh/access/user: populated
- * 
- * Response model (includes read-only fields).
- */
-export interface OTPVerifyResponse {
-  /** Whether 2FA verification is required */
-  requires_2fa?: boolean;
-  /** 2FA session ID (if requires_2fa is True) */
-  session_id?: string | null;
-  /** JWT refresh token (if requires_2fa is False) */
-  refresh?: string | null;
-  /** JWT access token (if requires_2fa is False) */
-  access?: string | null;
-  user?: User | null;
-  /** Whether user should be prompted to enable 2FA */
-  should_prompt_2fa?: boolean;
-}
-
 /**
  * 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

@@ -2,6 +2,18 @@
 // Auto-generated by DjangoCFG - see CLAUDE.md
 import * as Enums from "../enums";
 
+/**
+ * Error response for OAuth endpoints.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface OAuthError {
+  /** Error code */
+  error: string;
+  /** Human-readable error description */
+  error_description?: string;
+}
+
 /**
  * Response with available OAuth providers.
  * 
@@ -13,27 +25,53 @@ export interface OAuthProvidersResponse {
 }
 
 /**
- * Request to disconnect OAuth provider.
+ * Response with OAuth authorization URL.
  * 
- * Request model (no read-only fields).
+ * Response model (includes read-only fields).
  */
-export interface OAuthDisconnectRequestRequest {
-  /** OAuth provider to disconnect
+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;
+}
 
-  * `github` - GitHub */
-  provider: Enums.OAuthConnectionProvider;
+/**
+ * Request to complete OAuth flow (callback handler).
+ * 
+ * Request model (no 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;
 }
 
 /**
- * Error response for OAuth endpoints.
+ * Serializer for OAuth connection info (user-facing).
  * 
  * Response model (includes read-only fields).
  */
-export interface OAuthError {
-  /** Error code */
-  error: string;
-  /** Human-readable error description */
-  error_description?: string;
+export interface OAuthConnection {
+  id: number;
+  /** OAuth provider name (github, google, etc.)
+
+  * `github` - GitHub */
+  provider: Enums.OAuthConnectionProvider;
+  provider_display: string;
+  /** Username on the OAuth provider platform */
+  provider_username: string;
+  /** Email from OAuth provider (may differ from user.email) */
+  provider_email: string;
+  /** Avatar URL from OAuth provider */
+  provider_avatar_url: string;
+  /** When this OAuth connection was created */
+  connected_at: string;
+  /** Last time this OAuth connection was used for login */
+  last_login_at: string;
 }
 
 /**
@@ -76,52 +114,14 @@ export interface OAuthTokenResponse {
 }
 
 /**
- * Serializer for OAuth connection info (user-facing).
+ * Request to disconnect OAuth provider.
  * 
- * Response model (includes read-only fields).
+ * Request model (no read-only fields).
  */
-export interface OAuthConnection {
-  id: number;
-  /** OAuth provider name (github, google, etc.)
+export interface OAuthDisconnectRequestRequest {
+  /** OAuth provider to disconnect
 
   * `github` - GitHub */
   provider: Enums.OAuthConnectionProvider;
-  provider_display: string;
-  /** Username on the OAuth provider platform */
-  provider_username: string;
-  /** Email from OAuth provider (may differ from user.email) */
-  provider_email: string;
-  /** Avatar URL from OAuth provider */
-  provider_avatar_url: string;
-  /** When this OAuth connection was created */
-  connected_at: string;
-  /** Last time this OAuth connection was used for login */
-  last_login_at: string;
-}
-
-/**
- * Response with OAuth authorization URL.
- * 
- * 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;
-}
-
-/**
- * Request to complete OAuth flow (callback handler).
- * 
- * Request model (no 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;
 }
 

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

@@ -1,5 +1,19 @@
 // @ts-nocheck
 // Auto-generated by DjangoCFG - see CLAUDE.md
+/**
+ * Serializer for updating user profile.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface UserProfileUpdateRequest {
+  first_name?: string;
+  last_name?: string;
+  company?: string;
+  phone?: string;
+  position?: string;
+  language?: string;
+}
+
 /**
  * Serializer for updating user profile.
  * 
@@ -57,20 +71,6 @@ export interface AccountDeleteResponse {
   message: string;
 }
 
-/**
- * Serializer for updating user profile.
- * 
- * Request model (no read-only fields).
- */
-export interface UserProfileUpdateRequest {
-  first_name?: string;
-  last_name?: string;
-  company?: string;
-  phone?: string;
-  position?: string;
-  language?: string;
-}
-
 /**
  * 
  * Request model (no read-only fields).

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/CLAUDE.md

@@ -12,7 +12,7 @@ python manage.py generate_client --groups cfg_totp --typescript
 |---|---|
 | Version | 3.1.0 |
 | Operations | 9 |
-| Schemas | 15 |
+| Schemas | 14 |
 
 ## Resources
 
@@ -29,7 +29,7 @@ python manage.py generate_client --groups cfg_totp --typescript
 - `GET` /cfg/totp/backup-codes/ → `cfg_totp_backup_codes_retrieve`
 
 **TOTP Management:**
-- `GET` /cfg/totp/devices/ → `cfg_totp_devices_list`
+- `GET` /cfg/totp/devices/ → `cfg_totp_devices_retrieve`
 - `POST` /cfg/totp/disable/ → `cfg_totp_disable_create`
 
 **TOTP Setup:**
@@ -52,7 +52,7 @@ const client = new APIClient({ baseUrl, token });
 
 await client.backup codes.retrieve({ id: 1 });
 await client.backup codes.create({ ... });
-await client.totp management.list();
+await client.totp management.retrieve({ id: 1 });
 await client.totp management.create({ ... });
 ```
 

package/src/_api/generated/cfg_totp/_utils/fetchers/totp__totp_management.ts

@@ -32,8 +32,8 @@
  * ```
  */
 import { consola } from 'consola'
+import { DeviceListResponseSchema, type DeviceListResponse } from '../schemas/DeviceListResponse.schema'
 import { DisableRequestSchema, type DisableRequest } from '../schemas/DisableRequest.schema'
-import { PaginatedDeviceListResponseListSchema, type PaginatedDeviceListResponseList } from '../schemas/PaginatedDeviceListResponseList.schema'
 import { getAPIInstance } from '../../api-instance'
 
 /**
@@ -42,16 +42,16 @@ import { getAPIInstance } from '../../api-instance'
  * @method GET
  * @path /cfg/totp/devices/
  */
-export async function getTotpDevicesList(  params?: { ordering?: string; page?: number; page_size?: number; search?: string },  client?: any
-): Promise<PaginatedDeviceListResponseList> {
+export async function getTotpDevicesRetrieve(  client?: any
+): Promise<DeviceListResponse> {
   const api = client || getAPIInstance()
-  const response = await api.totp_management.totpDevicesList(params?.ordering, params?.page, params?.page_size, params?.search)
+  const response = await api.totp_management.totpDevicesRetrieve()
   try {
-    return PaginatedDeviceListResponseListSchema.parse(response)
+    return DeviceListResponseSchema.parse(response)
   } catch (error) {
     // Zod validation error - log detailed information
     consola.error('❌ Zod Validation Failed');
-    consola.box(`getTotpDevicesList\nPath: /cfg/totp/devices/\nMethod: GET`);
+    consola.box(`getTotpDevicesRetrieve\nPath: /cfg/totp/devices/\nMethod: GET`);
 
     if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
       consola.error('Validation Issues:');
@@ -70,7 +70,7 @@ export async function getTotpDevicesList(  params?: { ordering?: string; page?:
       try {
         const event = new CustomEvent('zod-validation-error', {
           detail: {
-            operation: 'getTotpDevicesList',
+            operation: 'getTotpDevicesRetrieve',
             path: '/cfg/totp/devices/',
             method: 'GET',
             error: error,

package/src/_api/generated/cfg_totp/_utils/hooks/totp__totp_management.ts

@@ -22,8 +22,8 @@ import useSWR from 'swr'
 import { useSWRConfig } from 'swr'
 import * as Fetchers from '../fetchers/totp__totp_management'
 import type { API } from '../../index'
+import type { DeviceListResponse } from '../schemas/DeviceListResponse.schema'
 import type { DisableRequest } from '../schemas/DisableRequest.schema'
-import type { PaginatedDeviceListResponseList } from '../schemas/PaginatedDeviceListResponseList.schema'
 
 /**
  * API operation
@@ -31,10 +31,10 @@ import type { PaginatedDeviceListResponseList } from '../schemas/PaginatedDevice
  * @method GET
  * @path /cfg/totp/devices/
  */
-export function useTotpDevicesList(params?: { ordering?: string; page?: number; page_size?: number; search?: string }, client?: API): ReturnType<typeof useSWR<PaginatedDeviceListResponseList>> {
-  return useSWR<PaginatedDeviceListResponseList>(
-    ['cfg-totp-devices', params],
-    () => Fetchers.getTotpDevicesList(params, client)
+export function useTotpDevicesRetrieve(client?: API): ReturnType<typeof useSWR<DeviceListResponse>> {
+  return useSWR<DeviceListResponse>(
+    'cfg-totp-device',
+    () => Fetchers.getTotpDevicesRetrieve(client)
   )
 }
 

package/src/_api/generated/cfg_totp/_utils/schemas/index.ts

@@ -26,7 +26,6 @@ export * from './ConfirmSetupResponse.schema'
 export * from './DeviceList.schema'
 export * from './DeviceListResponse.schema'
 export * from './DisableRequest.schema'
-export * from './PaginatedDeviceListResponseList.schema'
 export * from './SetupRequest.schema'
 export * from './SetupResponse.schema'
 export * from './TotpVerifyUser.schema'

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);