@djangocfg/api 2.1.322 → 2.1.331

package/src/_api/generated/cfg_centrifugo/validation-events.ts

@@ -1,135 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Zod Validation Events - Browser CustomEvent integration
- *
- * Dispatches browser CustomEvents when Zod validation fails, allowing
- * React/frontend apps to listen and handle validation errors globally.
- *
- * @example
- * ```typescript
- * // In your React app
- * window.addEventListener('zod-validation-error', (event) => {
- *   const { operation, path, method, error, response } = event.detail;
- *   console.error(`Validation failed for ${method} ${path}`, error);
- *   // Show toast notification, log to Sentry, etc.
- * });
- * ```
- */
-
-import type { ZodError } from 'zod'
-
-/**
- * Validation error event detail
- */
-export interface ValidationErrorDetail {
-  /** Operation/function name that failed validation */
-  operation: string
-  /** API endpoint path */
-  path: string
-  /** HTTP method */
-  method: string
-  /** Zod validation error */
-  error: ZodError
-  /** Raw response data that failed validation */
-  response: any
-  /** Timestamp of the error */
-  timestamp: Date
-}
-
-/**
- * Custom event type for Zod validation errors
- */
-export type ValidationErrorEvent = CustomEvent<ValidationErrorDetail>
-
-/**
- * Dispatch a Zod validation error event.
- *
- * Only dispatches in browser environment (when window is defined).
- * Safe to call in Node.js/SSR - will be a no-op.
- *
- * @param detail - Validation error details
- */
-export function dispatchValidationError(detail: ValidationErrorDetail): void {
-  // Check if running in browser
-  if (typeof window === 'undefined') {
-    return
-  }
-
-  try {
-    const event = new CustomEvent<ValidationErrorDetail>('zod-validation-error', {
-      detail,
-      bubbles: true,
-      cancelable: false,
-    })
-
-    window.dispatchEvent(event)
-  } catch (error) {
-    // Silently fail - validation event dispatch should never crash the app
-    console.warn('Failed to dispatch validation error event:', error)
-  }
-}
-
-/**
- * Add a global listener for Zod validation errors.
- *
- * @param callback - Function to call when validation error occurs
- * @returns Cleanup function to remove the listener
- *
- * @example
- * ```typescript
- * const cleanup = onValidationError(({ operation, error }) => {
- *   toast.error(`Validation failed in ${operation}`);
- *   logToSentry(error);
- * });
- *
- * // Later, remove listener
- * cleanup();
- * ```
- */
-export function onValidationError(
-  callback: (detail: ValidationErrorDetail) => void
-): () => void {
-  if (typeof window === 'undefined') {
-    // Return no-op cleanup function for SSR
-    return () => {}
-  }
-
-  const handler = (event: Event) => {
-    if (event instanceof CustomEvent) {
-      callback(event.detail)
-    }
-  }
-
-  window.addEventListener('zod-validation-error', handler)
-
-  // Return cleanup function
-  return () => {
-    window.removeEventListener('zod-validation-error', handler)
-  }
-}
-
-/**
- * Format Zod error for logging/display.
- *
- * @param error - Zod validation error
- * @returns Formatted error message
- */
-export function formatZodError(error: ZodError): string {
-  const issues = error.issues.map((issue, index) => {
-    const path = issue.path.join('.') || 'root'
-    const parts = [`${index + 1}. ${path}: ${issue.message}`]
-
-    if ('expected' in issue && issue.expected) {
-      parts.push(`   Expected: ${issue.expected}`)
-    }
-
-    if ('received' in issue && issue.received) {
-      parts.push(`   Received: ${issue.received}`)
-    }
-
-    return parts.join('\n')
-  })
-
-  return issues.join('\n')
-}

package/src/_api/generated/cfg_totp/CLAUDE.md

@@ -1,83 +0,0 @@
-# Django CFG API - Typescript Client
-
-Auto-generated. **Do not edit manually.**
-
-```bash
-python manage.py generate_client --groups cfg_totp --typescript
-```
-
-## Stats
-
-| | |
-|---|---|
-| Version | 3.1.0 |
-| Operations | 9 |
-| Schemas | 14 |
-
-## Resources
-
-- **Backup Codes** (2 ops)
-- **TOTP Management** (2 ops)
-- **TOTP Setup** (2 ops)
-- **TOTP Verification** (2 ops)
-- **totp** (1 ops)
-
-## Operations
-
-**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 Management:**
-- `GET` /cfg/totp/devices/ → `cfg_totp_devices_retrieve`
-- `POST` /cfg/totp/disable/ → `cfg_totp_disable_create`
-
-**TOTP Setup:**
-- `POST` /cfg/totp/setup/confirm/ → `cfg_totp_setup_confirm_create`
-- `POST` /cfg/totp/setup/ → `cfg_totp_setup_create`
-
-**TOTP Verification:**
-- `POST` /cfg/totp/verify/backup/ → `cfg_totp_verify_backup_create`
-- `POST` /cfg/totp/verify/ → `cfg_totp_verify_create`
-
-**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.totp management.retrieve({ id: 1 });
-await client.totp 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
-)
-```
-
-@see https://djangocfg.com/docs/features/api-generation
-

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

@@ -1,34 +0,0 @@
-// @ts-nocheck
-// 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__backup_codes'
-export * from './totp__totp_management'
-export * from './totp__totp_setup'
-export * from './totp__totp_verification'

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

@@ -1,50 +0,0 @@
-// @ts-nocheck
-// 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/_api/generated/cfg_totp/_utils/fetchers/totp__backup_codes.ts

@@ -1,153 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Typed fetchers for Backup Codes
- *
- * 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 { BackupCodesRegenerateRequestSchema, type BackupCodesRegenerateRequest } from '../schemas/BackupCodesRegenerateRequest.schema'
-import { BackupCodesRegenerateResponseSchema, type BackupCodesRegenerateResponse } from '../schemas/BackupCodesRegenerateResponse.schema'
-import { BackupCodesStatusSchema, type BackupCodesStatus } from '../schemas/BackupCodesStatus.schema'
-import { getAPIInstance } from '../../api-instance'
-
-/**
- * API operation
- *
- * @method GET
- * @path /cfg/totp/backup-codes/
- */
-export async function getTotpBackupCodesRetrieve(  client?: any
-): Promise<BackupCodesStatus> {
-  const api = client || getAPIInstance()
-  const response = await api.backup_codes.totpBackupCodesRetrieve()
-  try {
-    return BackupCodesStatusSchema.parse(response)
-  } catch (error) {
-    // Zod validation error - log detailed information
-    consola.error('❌ Zod Validation Failed');
-    consola.box(`getTotpBackupCodesRetrieve\nPath: /cfg/totp/backup-codes/\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: 'getTotpBackupCodesRetrieve',
-            path: '/cfg/totp/backup-codes/',
-            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/backup-codes/regenerate/
- */
-export async function createTotpBackupCodesRegenerateCreate(  data: BackupCodesRegenerateRequest,  client?: any
-): Promise<BackupCodesRegenerateResponse> {
-  const api = client || getAPIInstance()
-  const response = await api.backup_codes.totpBackupCodesRegenerateCreate(data)
-  try {
-    return BackupCodesRegenerateResponseSchema.parse(response)
-  } catch (error) {
-    // Zod validation error - log detailed information
-    consola.error('❌ Zod Validation Failed');
-    consola.box(`createTotpBackupCodesRegenerateCreate\nPath: /cfg/totp/backup-codes/regenerate/\nMethod: POST`);
-
-    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: 'createTotpBackupCodesRegenerateCreate',
-            path: '/cfg/totp/backup-codes/regenerate/',
-            method: 'POST',
-            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_totp/_utils/fetchers/totp__totp_management.ts

@@ -1,109 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Typed fetchers for TOTP 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 { DeviceListResponseSchema, type DeviceListResponse } from '../schemas/DeviceListResponse.schema'
-import { DisableRequestSchema, type DisableRequest } from '../schemas/DisableRequest.schema'
-import { getAPIInstance } from '../../api-instance'
-
-/**
- * API operation
- *
- * @method GET
- * @path /cfg/totp/devices/
- */
-export async function getTotpDevicesRetrieve(  client?: any
-): Promise<DeviceListResponse> {
-  const api = client || getAPIInstance()
-  const response = await api.totp_management.totpDevicesRetrieve()
-  try {
-    return DeviceListResponseSchema.parse(response)
-  } catch (error) {
-    // Zod validation error - log detailed information
-    consola.error('❌ Zod Validation Failed');
-    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:');
-      (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: 'getTotpDevicesRetrieve',
-            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.totp_management.totpDisableCreate(data)
-  return response
-}
-
-