@djangocfg/api 2.1.54 → 2.1.56

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "2.1.54",
+  "version": "2.1.56",
   "description": "Auto-generated TypeScript API client with React hooks, SWR integration, and Zod validation for Django REST Framework backends",
   "keywords": [
     "django",
@@ -74,7 +74,7 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/ui-nextjs": "^2.1.54",
+    "@djangocfg/ui-nextjs": "^2.1.56",
     "consola": "^3.4.2",
     "next": "^14 || ^15",
     "p-retry": "^7.0.0",
@@ -85,7 +85,7 @@
   "devDependencies": {
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
-    "@djangocfg/typescript-config": "^2.1.54",
+    "@djangocfg/typescript-config": "^2.1.56",
     "next": "^15.0.0",
     "react": "^19.0.0",
     "tsup": "^8.5.0",

package/src/generated/cfg_accounts/_utils/schemas/CentrifugoToken.schema.ts

@@ -11,7 +11,7 @@ import { z } from 'zod'
  */
 export const CentrifugoTokenSchema = z.object({
   token: z.string(),
-  centrifugo_url: z.url(),
+  centrifugo_url: z.union([z.url(), z.literal('')]),
   expires_at: z.iso.datetime(),
   channels: z.array(z.string()),
 })

package/src/generated/cfg_accounts/_utils/schemas/OAuthAuthorizeRequestRequest.schema.ts

@@ -10,8 +10,8 @@ import { z } from 'zod'
  * Request to start OAuth flow.
  */
 export const OAuthAuthorizeRequestRequestSchema = z.object({
-  redirect_uri: z.url().optional(),
-  source_url: z.url().optional(),
+  redirect_uri: z.union([z.url(), z.literal('')]).optional(),
+  source_url: z.union([z.url(), z.literal('')]).optional(),
 })
 
 /**

package/src/generated/cfg_accounts/_utils/schemas/OAuthAuthorizeResponse.schema.ts

@@ -10,7 +10,7 @@ import { z } from 'zod'
  * Response with OAuth authorization URL.
  */
 export const OAuthAuthorizeResponseSchema = z.object({
-  authorization_url: z.url(),
+  authorization_url: z.union([z.url(), z.literal('')]),
   state: z.string(),
 })
 

package/src/generated/cfg_accounts/_utils/schemas/OAuthCallbackRequestRequest.schema.ts

@@ -12,7 +12,7 @@ import { z } from 'zod'
 export const OAuthCallbackRequestRequestSchema = z.object({
   code: z.string().min(10).max(500),
   state: z.string().min(20).max(100),
-  redirect_uri: z.url().optional(),
+  redirect_uri: z.union([z.url(), z.literal('')]).optional(),
 })
 
 /**

package/src/generated/cfg_accounts/_utils/schemas/OAuthConnection.schema.ts

@@ -16,7 +16,7 @@ export const OAuthConnectionSchema = z.object({
   provider_display: z.string(),
   provider_username: z.string(),
   provider_email: z.email(),
-  provider_avatar_url: z.url(),
+  provider_avatar_url: z.union([z.url(), z.literal('')]),
   connected_at: z.iso.datetime(),
   last_login_at: z.iso.datetime(),
 })

package/src/generated/cfg_accounts/_utils/schemas/OAuthProvidersResponse.schema.ts

@@ -10,7 +10,7 @@ import { z } from 'zod'
  * Response with available OAuth providers.
  */
 export const OAuthProvidersResponseSchema = z.object({
-  providers: z.array(z.record(z.string(), z.record(z.string(), z.any()))),
+  providers: z.array(z.record(z.string(), z.any())),
 })
 
 /**

package/src/generated/cfg_accounts/_utils/schemas/OAuthTokenResponse.schema.ts

@@ -12,7 +12,7 @@ import { z } from 'zod'
 export const OAuthTokenResponseSchema = z.object({
   access: z.string(),
   refresh: z.string(),
-  user: z.record(z.string(), z.record(z.string(), z.any())),
+  user: z.record(z.string(), z.any()),
   is_new_user: z.boolean(),
   is_new_connection: z.boolean(),
 })

package/src/generated/cfg_accounts/_utils/schemas/OTPRequestRequest.schema.ts

@@ -13,7 +13,7 @@ import * as Enums from '../../enums'
 export const OTPRequestRequestSchema = z.object({
   identifier: z.string().min(1),
   channel: z.nativeEnum(Enums.OTPRequestRequestChannel).optional(),
-  source_url: z.url().optional(),
+  source_url: z.union([z.url(), z.literal('')]).optional(),
 })
 
 /**

package/src/generated/cfg_accounts/_utils/schemas/OTPVerifyRequest.schema.ts

@@ -14,7 +14,7 @@ export const OTPVerifyRequestSchema = z.object({
   identifier: z.string().min(1),
   otp: z.string().min(6).max(6),
   channel: z.nativeEnum(Enums.OTPVerifyRequestChannel).optional(),
-  source_url: z.url().optional(),
+  source_url: z.union([z.url(), z.literal('')]).optional(),
 })
 
 /**

package/src/generated/cfg_accounts/_utils/schemas/User.schema.ts

@@ -21,7 +21,7 @@ export const UserSchema = z.object({
   company: z.string().max(100).optional(),
   phone: z.string().max(20).optional(),
   position: z.string().max(100).optional(),
-  avatar: z.url().nullable(),
+  avatar: z.union([z.url(), z.literal('')]).nullable(),
   is_staff: z.boolean(),
   is_superuser: z.boolean(),
   date_joined: z.iso.datetime(),

package/src/generated/cfg_accounts/api-instance.ts

@@ -1,29 +1,37 @@
 // Auto-generated by DjangoCFG - see CLAUDE.md
 /**
- * Global API Instance - Singleton configuration
+ * Global API Instance - Singleton configuration with auto-configuration support
  *
- * This module provides a global API instance that can be configured once
- * and used throughout your application.
+ * This module provides a global API instance that auto-configures from
+ * environment variables or can be configured manually.
  *
- * Usage:
+ * AUTO-CONFIGURATION (recommended):
+ * Set one of these environment variables and the API will auto-configure:
+ * - NEXT_PUBLIC_API_URL (Next.js)
+ * - VITE_API_URL (Vite)
+ * - REACT_APP_API_URL (Create React App)
+ * - API_URL (generic)
+ *
+ * Then just use fetchers and hooks directly:
+ * ```typescript
+ * import { getUsers } from './_utils/fetchers'
+ * const users = await getUsers({ page: 1 })
+ * ```
+ *
+ * MANUAL CONFIGURATION:
  * ```typescript
- * // Configure once (e.g., in your app entry point)
  * import { configureAPI } from './api-instance'
  *
  * configureAPI({
  *   baseUrl: 'https://api.example.com',
  *   token: 'your-jwt-token'
  * })
- *
- * // Then use fetchers and hooks anywhere without configuration
- * import { getUsers } from './fetchers'
- * const users = await getUsers({ page: 1 })
  * ```
  *
  * For SSR or multiple instances:
  * ```typescript
  * import { API } from './index'
- * import { getUsers } from './fetchers'
+ * import { getUsers } from './_utils/fetchers'
  *
  * const api = new API('https://api.example.com')
  * const users = await getUsers({ page: 1 }, api)
@@ -33,27 +41,67 @@
 import { API, type APIOptions } from './index'
 
 let globalAPI: API | null = null
+let autoConfigAttempted = false
+
+/**
+ * Auto-configure from environment variable if available (Next.js pattern)
+ * This allows hooks and fetchers to work without explicit configureAPI() call
+ *
+ * Supported environment variables:
+ * - NEXT_PUBLIC_API_URL (Next.js)
+ * - VITE_API_URL (Vite)
+ * - REACT_APP_API_URL (Create React App)
+ * - API_URL (generic)
+ */
+function tryAutoConfigureFromEnv(): void {
+  // Only attempt once
+  if (autoConfigAttempted) return
+  autoConfigAttempted = true
+
+  // Skip if already configured
+  if (globalAPI) return
+
+  // Skip if process is not available (pure browser without bundler)
+  if (typeof process === 'undefined' || !process.env) return
+
+  // Try different environment variable patterns
+  const baseUrl =
+    process.env.NEXT_PUBLIC_API_URL ||
+    process.env.VITE_API_URL ||
+    process.env.REACT_APP_API_URL ||
+    process.env.API_URL
+
+  if (baseUrl) {
+    globalAPI = new API(baseUrl)
+  }
+}
 
 /**
  * Get the global API instance
- * @throws Error if API is not configured
+ * Auto-configures from environment variables on first call if not manually configured.
+ * @throws Error if API is not configured and no env variable is set
  */
 export function getAPIInstance(): API {
+  // Try auto-configuration on first access (lazy initialization)
+  tryAutoConfigureFromEnv()
+
   if (!globalAPI) {
     throw new Error(
       'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\n' +
       'Example:\n' +
       '  import { configureAPI } from "./api-instance"\n' +
-      '  configureAPI({ baseUrl: "https://api.example.com" })'
+      '  configureAPI({ baseUrl: "https://api.example.com" })\n\n' +
+      'Or set environment variable: NEXT_PUBLIC_API_URL, VITE_API_URL, or REACT_APP_API_URL'
     )
   }
   return globalAPI
 }
 
 /**
- * Check if API is configured
+ * Check if API is configured (or can be auto-configured)
  */
 export function isAPIConfigured(): boolean {
+  tryAutoConfigureFromEnv()
   return globalAPI !== null
 }
 

package/src/generated/cfg_centrifugo/api-instance.ts

@@ -1,29 +1,37 @@
 // Auto-generated by DjangoCFG - see CLAUDE.md
 /**
- * Global API Instance - Singleton configuration
+ * Global API Instance - Singleton configuration with auto-configuration support
  *
- * This module provides a global API instance that can be configured once
- * and used throughout your application.
+ * This module provides a global API instance that auto-configures from
+ * environment variables or can be configured manually.
  *
- * Usage:
+ * AUTO-CONFIGURATION (recommended):
+ * Set one of these environment variables and the API will auto-configure:
+ * - NEXT_PUBLIC_API_URL (Next.js)
+ * - VITE_API_URL (Vite)
+ * - REACT_APP_API_URL (Create React App)
+ * - API_URL (generic)
+ *
+ * Then just use fetchers and hooks directly:
+ * ```typescript
+ * import { getUsers } from './_utils/fetchers'
+ * const users = await getUsers({ page: 1 })
+ * ```
+ *
+ * MANUAL CONFIGURATION:
  * ```typescript
- * // Configure once (e.g., in your app entry point)
  * import { configureAPI } from './api-instance'
  *
  * configureAPI({
  *   baseUrl: 'https://api.example.com',
  *   token: 'your-jwt-token'
  * })
- *
- * // Then use fetchers and hooks anywhere without configuration
- * import { getUsers } from './fetchers'
- * const users = await getUsers({ page: 1 })
  * ```
  *
  * For SSR or multiple instances:
  * ```typescript
  * import { API } from './index'
- * import { getUsers } from './fetchers'
+ * import { getUsers } from './_utils/fetchers'
  *
  * const api = new API('https://api.example.com')
  * const users = await getUsers({ page: 1 }, api)
@@ -33,27 +41,67 @@
 import { API, type APIOptions } from './index'
 
 let globalAPI: API | null = null
+let autoConfigAttempted = false
+
+/**
+ * Auto-configure from environment variable if available (Next.js pattern)
+ * This allows hooks and fetchers to work without explicit configureAPI() call
+ *
+ * Supported environment variables:
+ * - NEXT_PUBLIC_API_URL (Next.js)
+ * - VITE_API_URL (Vite)
+ * - REACT_APP_API_URL (Create React App)
+ * - API_URL (generic)
+ */
+function tryAutoConfigureFromEnv(): void {
+  // Only attempt once
+  if (autoConfigAttempted) return
+  autoConfigAttempted = true
+
+  // Skip if already configured
+  if (globalAPI) return
+
+  // Skip if process is not available (pure browser without bundler)
+  if (typeof process === 'undefined' || !process.env) return
+
+  // Try different environment variable patterns
+  const baseUrl =
+    process.env.NEXT_PUBLIC_API_URL ||
+    process.env.VITE_API_URL ||
+    process.env.REACT_APP_API_URL ||
+    process.env.API_URL
+
+  if (baseUrl) {
+    globalAPI = new API(baseUrl)
+  }
+}
 
 /**
  * Get the global API instance
- * @throws Error if API is not configured
+ * Auto-configures from environment variables on first call if not manually configured.
+ * @throws Error if API is not configured and no env variable is set
  */
 export function getAPIInstance(): API {
+  // Try auto-configuration on first access (lazy initialization)
+  tryAutoConfigureFromEnv()
+
   if (!globalAPI) {
     throw new Error(
       'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\n' +
       'Example:\n' +
       '  import { configureAPI } from "./api-instance"\n' +
-      '  configureAPI({ baseUrl: "https://api.example.com" })'
+      '  configureAPI({ baseUrl: "https://api.example.com" })\n\n' +
+      'Or set environment variable: NEXT_PUBLIC_API_URL, VITE_API_URL, or REACT_APP_API_URL'
     )
   }
   return globalAPI
 }
 
 /**
- * Check if API is configured
+ * Check if API is configured (or can be auto-configured)
  */
 export function isAPIConfigured(): boolean {
+  tryAutoConfigureFromEnv()
   return globalAPI !== null
 }
 

package/src/generated/cfg_totp/CLAUDE.md

@@ -0,0 +1,90 @@
+# Django CFG API - Typescript Client
+
+Auto-generated. **Do not edit manually.**
+
+```bash
+python manage.py generate_client --groups cfg_totp --typescript
+```
+
+## Stats
+
+| | |
+|---|---|
+| Version | 3.0.3 |
+| Operations | 9 |
+| Schemas | 13 |
+
+## Resources
+
+- **2FA Management** (2 ops)
+- **2FA Setup** (2 ops)
+- **2FA Verification** (2 ops)
+- **Backup Codes** (2 ops)
+- **totp** (1 ops)
+
+## Operations
+
+**2FA Management:**
+- `GET` /cfg/totp/devices/ → `cfg_totp_devices_list`
+- `POST` /cfg/totp/disable/ → `cfg_totp_disable_create`
+
+**2FA Setup:**
+- `POST` /cfg/totp/setup/confirm/ → `cfg_totp_setup_confirm_create`
+- `POST` /cfg/totp/setup/ → `cfg_totp_setup_create`
+
+**2FA Verification:**
+- `POST` /cfg/totp/verify/backup/ → `cfg_totp_verify_backup_create`
+- `POST` /cfg/totp/verify/ → `cfg_totp_verify_create`
+
+**Backup Codes:**
+- `POST` /cfg/totp/backup-codes/regenerate/ → `cfg_totp_backup_codes_regenerate_create`
+- `GET` /cfg/totp/backup-codes/ → `cfg_totp_backup_codes_retrieve`
+
+**totp:**
+- `DELETE` /cfg/totp/devices/{id}/ → `cfg_totp_devices_destroy`
+
+## Usage
+
+```typescript
+import { APIClient } from './';
+
+const client = new APIClient({ baseUrl, token });
+
+await client.backup codes.retrieve({ id: 1 });
+await client.backup codes.create({ ... });
+await client.2fa management.list();
+await client.2fa management.create({ ... });
+```
+
+**SWR Hooks:**
+```typescript
+import { useBackup codesList } from './hooks';
+const { data, isLoading } = useBackup codesList();
+```
+
+## How It Works
+
+```
+DRF ViewSets → drf-spectacular → OpenAPI → IR Parser → Generator → This Client
+```
+
+**Configuration** (`api/config.py`):
+```python
+openapi_client = OpenAPIClientConfig(
+    enabled=True,
+    groups=[OpenAPIGroupConfig(name="cfg_totp", apps=["..."])],
+    generate_zod_schemas=True,  # → schemas.ts
+    generate_fetchers=True,     # → fetchers.ts
+    generate_swr_hooks=True,    # → hooks.ts
+)
+```
+
+**Copy to Next.js** (if `nextjs_admin` configured):
+```python
+nextjs_admin = NextJsAdminConfig(
+    project_path="../frontend/apps/...",
+    api_output_path="app/_lib/api/generated",
+)
+```
+
+@see https://djangocfg.com/docs/features/api-generation

package/src/generated/cfg_totp/_utils/fetchers/index.ts

@@ -0,0 +1,33 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md
+/**
+ * Typed Fetchers - Universal API functions
+ *
+ * Auto-generated from OpenAPI specification.
+ * These functions work in any JavaScript environment.
+ *
+ * Features:
+ * - Runtime validation with Zod
+ * - Type-safe parameters and responses
+ * - Works with any data-fetching library (SWR, React Query, etc)
+ * - Server Component compatible
+ *
+ * Usage:
+ * ```typescript
+ * import * as fetchers from './fetchers'
+ *
+ * // Direct usage
+ * const user = await fetchers.getUser(1)
+ *
+ * // With SWR
+ * const { data } = useSWR('user-1', () => fetchers.getUser(1))
+ *
+ * // With React Query
+ * const { data } = useQuery(['user', 1], () => fetchers.getUser(1))
+ * ```
+ */
+
+export * from './totp'
+export * from './totp__2fa_management'
+export * from './totp__2fa_setup'
+export * from './totp__2fa_verification'
+export * from './totp__backup_codes'

package/src/generated/cfg_totp/_utils/fetchers/totp.ts

@@ -0,0 +1,49 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md
+/**
+ * Typed fetchers for Totp
+ *
+ * Universal functions that work in any environment:
+ * - Next.js (App Router / Pages Router / Server Components)
+ * - React Native
+ * - Node.js backend
+ *
+ * These fetchers use Zod schemas for runtime validation.
+ *
+ * Usage:
+ * ```typescript
+ * // Configure API once (in your app entry point)
+ * import { configureAPI } from '../../api-instance'
+ * configureAPI({ baseUrl: 'https://api.example.com' })
+ *
+ * // Then use fetchers anywhere
+ * const users = await getUsers({ page: 1 })
+ *
+ * // With SWR
+ * const { data } = useSWR(['users', params], () => getUsers(params))
+ *
+ * // With React Query
+ * const { data } = useQuery(['users', params], () => getUsers(params))
+ *
+ * // In Server Component or SSR (pass custom client)
+ * import { API } from '../../index'
+ * const api = new API('https://api.example.com')
+ * const users = await getUsers({ page: 1 }, api)
+ * ```
+ */
+import { consola } from 'consola'
+import { getAPIInstance } from '../../api-instance'
+
+/**
+ * API operation
+ *
+ * @method DELETE
+ * @path /cfg/totp/devices/{id}/
+ */
+export async function deleteTotpDevicesDestroy(  id: string,  client?: any
+): Promise<void> {
+  const api = client || getAPIInstance()
+  const response = await api.totp.devicesDestroy(id)
+  return response
+}
+
+

package/src/generated/cfg_totp/_utils/fetchers/totp__2fa_management.ts

@@ -0,0 +1,108 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md
+/**
+ * Typed fetchers for 2fa Management
+ *
+ * Universal functions that work in any environment:
+ * - Next.js (App Router / Pages Router / Server Components)
+ * - React Native
+ * - Node.js backend
+ *
+ * These fetchers use Zod schemas for runtime validation.
+ *
+ * Usage:
+ * ```typescript
+ * // Configure API once (in your app entry point)
+ * import { configureAPI } from '../../api-instance'
+ * configureAPI({ baseUrl: 'https://api.example.com' })
+ *
+ * // Then use fetchers anywhere
+ * const users = await getUsers({ page: 1 })
+ *
+ * // With SWR
+ * const { data } = useSWR(['users', params], () => getUsers(params))
+ *
+ * // With React Query
+ * const { data } = useQuery(['users', params], () => getUsers(params))
+ *
+ * // In Server Component or SSR (pass custom client)
+ * import { API } from '../../index'
+ * const api = new API('https://api.example.com')
+ * const users = await getUsers({ page: 1 }, api)
+ * ```
+ */
+import { consola } from 'consola'
+import { DisableRequestSchema, type DisableRequest } from '../schemas/DisableRequest.schema'
+import { PaginatedDeviceListListSchema, type PaginatedDeviceListList } from '../schemas/PaginatedDeviceListList.schema'
+import { getAPIInstance } from '../../api-instance'
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/totp/devices/
+ */
+export async function getTotpDevicesList(  params?: { page?: number; page_size?: number },  client?: any
+): Promise<PaginatedDeviceListList> {
+  const api = client || getAPIInstance()
+  const response = await api.2fa_management.totpDevicesList(params?.page, params?.page_size)
+  try {
+    return PaginatedDeviceListListSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`getTotpDevicesList\nPath: /cfg/totp/devices/\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: 'getTotpDevicesList',
+            path: '/cfg/totp/devices/',
+            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;
+  }
+}
+
+
+/**
+ * API operation
+ *
+ * @method POST
+ * @path /cfg/totp/disable/
+ */
+export async function createTotpDisableCreate(  data: DisableRequest,  client?: any
+): Promise<any> {
+  const api = client || getAPIInstance()
+  const response = await api.2fa_management.totpDisableCreate(data)
+  return response
+}
+
+