@djangocfg/api 2.1.322 → 2.1.331

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

@@ -1,163 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Storage adapters for cross-platform token storage.
- *
- * Supports:
- * - LocalStorage (browser)
- * - Cookies (SSR/browser)
- * - Memory (Node.js/Electron/testing)
- */
-
-import type { APILogger } from './logger';
-
-/**
- * Storage adapter interface for cross-platform token storage.
- */
-export interface StorageAdapter {
-  getItem(key: string): string | null;
-  setItem(key: string, value: string): void;
-  removeItem(key: string): void;
-}
-
-/**
- * LocalStorage adapter with safe try-catch for browser environments.
- * Works in modern browsers with localStorage support.
- * 
- * Note: This adapter uses window.localStorage and should only be used in browser/client environments.
- * For server-side usage, use MemoryStorageAdapter or CookieStorageAdapter instead.
- */
-export class LocalStorageAdapter implements StorageAdapter {
-  private logger?: APILogger;
-
-  constructor(logger?: APILogger) {
-    this.logger = logger;
-  }
-
-  getItem(key: string): string | null {
-    try {
-      if (typeof window !== 'undefined' && window.localStorage) {
-        const value = localStorage.getItem(key);
-        this.logger?.debug(`LocalStorage.getItem("${key}"): ${value ? 'found' : 'not found'}`);
-        return value;
-      }
-      this.logger?.warn('LocalStorage not available: window.localStorage is undefined');
-    } catch (error) {
-      this.logger?.error('LocalStorage.getItem failed:', error);
-    }
-    return null;
-  }
-
-  setItem(key: string, value: string): void {
-    try {
-      if (typeof window !== 'undefined' && window.localStorage) {
-        localStorage.setItem(key, value);
-        this.logger?.debug(`LocalStorage.setItem("${key}"): success`);
-      } else {
-        this.logger?.warn('LocalStorage not available: window.localStorage is undefined');
-      }
-    } catch (error) {
-      this.logger?.error('LocalStorage.setItem failed:', error);
-    }
-  }
-
-  removeItem(key: string): void {
-    try {
-      if (typeof window !== 'undefined' && window.localStorage) {
-        localStorage.removeItem(key);
-        this.logger?.debug(`LocalStorage.removeItem("${key}"): success`);
-      } else {
-        this.logger?.warn('LocalStorage not available: window.localStorage is undefined');
-      }
-    } catch (error) {
-      this.logger?.error('LocalStorage.removeItem failed:', error);
-    }
-  }
-}
-
-/**
- * Cookie-based storage adapter for SSR and browser environments.
- * Useful for Next.js, Nuxt.js, and other SSR frameworks.
- */
-export class CookieStorageAdapter implements StorageAdapter {
-  private logger?: APILogger;
-
-  constructor(logger?: APILogger) {
-    this.logger = logger;
-  }
-
-  getItem(key: string): string | null {
-    try {
-      if (typeof document === 'undefined') {
-        this.logger?.warn('Cookies not available: document is undefined (SSR context?)');
-        return null;
-      }
-      const value = `; ${document.cookie}`;
-      const parts = value.split(`; ${key}=`);
-      if (parts.length === 2) {
-        const result = parts.pop()?.split(';').shift() || null;
-        this.logger?.debug(`CookieStorage.getItem("${key}"): ${result ? 'found' : 'not found'}`);
-        return result;
-      }
-      this.logger?.debug(`CookieStorage.getItem("${key}"): not found`);
-    } catch (error) {
-      this.logger?.error('CookieStorage.getItem failed:', error);
-    }
-    return null;
-  }
-
-  setItem(key: string, value: string): void {
-    try {
-      if (typeof document !== 'undefined') {
-        document.cookie = `${key}=${value}; path=/; max-age=31536000`;
-        this.logger?.debug(`CookieStorage.setItem("${key}"): success`);
-      } else {
-        this.logger?.warn('Cookies not available: document is undefined (SSR context?)');
-      }
-    } catch (error) {
-      this.logger?.error('CookieStorage.setItem failed:', error);
-    }
-  }
-
-  removeItem(key: string): void {
-    try {
-      if (typeof document !== 'undefined') {
-        document.cookie = `${key}=; path=/; expires=Thu, 01 Jan 1970 00:00:00 GMT`;
-        this.logger?.debug(`CookieStorage.removeItem("${key}"): success`);
-      } else {
-        this.logger?.warn('Cookies not available: document is undefined (SSR context?)');
-      }
-    } catch (error) {
-      this.logger?.error('CookieStorage.removeItem failed:', error);
-    }
-  }
-}
-
-/**
- * In-memory storage adapter for Node.js, Electron, and testing environments.
- * Data is stored in RAM and cleared when process exits.
- */
-export class MemoryStorageAdapter implements StorageAdapter {
-  private storage: Map<string, string> = new Map();
-  private logger?: APILogger;
-
-  constructor(logger?: APILogger) {
-    this.logger = logger;
-  }
-
-  getItem(key: string): string | null {
-    const value = this.storage.get(key) || null;
-    this.logger?.debug(`MemoryStorage.getItem("${key}"): ${value ? 'found' : 'not found'}`);
-    return value;
-  }
-
-  setItem(key: string, value: string): void {
-    this.storage.set(key, value);
-    this.logger?.debug(`MemoryStorage.setItem("${key}"): success`);
-  }
-
-  removeItem(key: string): void {
-    this.storage.delete(key);
-    this.logger?.debug(`MemoryStorage.removeItem("${key}"): success`);
-  }
-}

package/src/_api/generated/cfg_accounts/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_centrifugo/CLAUDE.md

@@ -1,60 +0,0 @@
-# Django CFG API - Typescript Client
-
-Auto-generated. **Do not edit manually.**
-
-```bash
-python manage.py generate_client --groups cfg_centrifugo --typescript
-```
-
-## Stats
-
-| | |
-|---|---|
-| Version | 3.1.0 |
-| Operations | 1 |
-| Schemas | 1 |
-
-## Resources
-
-- **Centrifugo Auth** (1 ops)
-
-## Operations
-
-**Centrifugo Auth:**
-- `GET` /cfg/centrifugo/auth/token/ → `cfg_centrifugo_auth_token_retrieve`
-
-## Usage
-
-```typescript
-import { APIClient } from './';
-
-const client = new APIClient({ baseUrl, token });
-
-await client.centrifugo auth.retrieve({ id: 1 });
-```
-
-**SWR Hooks:**
-```typescript
-import { useCentrifugo authList } from './hooks';
-const { data, isLoading } = useCentrifugo authList();
-```
-
-## 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_centrifugo", 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_centrifugo/_utils/fetchers/centrifugo__centrifugo_auth.ts

@@ -1,94 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Typed fetchers for Centrifugo Auth
- *
- * 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 { ConnectionTokenResponseSchema, type ConnectionTokenResponse } from '../schemas/ConnectionTokenResponse.schema'
-import { getAPIInstance } from '../../api-instance'
-
-/**
- * Get Centrifugo connection token
- *
- * @method GET
- * @path /cfg/centrifugo/auth/token/
- */
-export async function getCentrifugoAuthTokenRetrieve(  client?: any
-): Promise<ConnectionTokenResponse> {
-  const api = client || getAPIInstance()
-  const response = await api.centrifugo_auth.tokenRetrieve()
-  try {
-    return ConnectionTokenResponseSchema.parse(response)
-  } catch (error) {
-    // Zod validation error - log detailed information
-    consola.error('❌ Zod Validation Failed');
-    consola.box(`getCentrifugoAuthTokenRetrieve\nPath: /cfg/centrifugo/auth/token/\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: 'getCentrifugoAuthTokenRetrieve',
-            path: '/cfg/centrifugo/auth/token/',
-            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_centrifugo/_utils/fetchers/index.ts

@@ -1,30 +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 './centrifugo__centrifugo_auth'

package/src/_api/generated/cfg_centrifugo/_utils/hooks/centrifugo__centrifugo_auth.ts

@@ -1,39 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-'use client';
-
-/**
- * SWR Hooks for Centrifugo Auth
- *
- * React hooks powered by SWR for data fetching with automatic caching,
- * revalidation, and optimistic updates.
- *
- * Usage:
- * ```typescript
- * // Query hooks (GET)
- * const { data, error, isLoading } = useUsers({ page: 1 })
- *
- * // Mutation hooks (POST/PUT/PATCH/DELETE)
- * const createUser = useCreateUser()
- * await createUser({ name: 'John', email: 'john@example.com' })
- * ```
- */
-import useSWR from 'swr'
-import * as Fetchers from '../fetchers/centrifugo__centrifugo_auth'
-import type { API } from '../../index'
-import type { ConnectionTokenResponse } from '../schemas/ConnectionTokenResponse.schema'
-
-/**
- * Get Centrifugo connection token
- *
- * @method GET
- * @path /cfg/centrifugo/auth/token/
- */
-export function useCentrifugoAuthTokenRetrieve(client?: API): ReturnType<typeof useSWR<ConnectionTokenResponse>> {
-  return useSWR<ConnectionTokenResponse>(
-    'cfg-centrifugo-auth-token',
-    () => Fetchers.getCentrifugoAuthTokenRetrieve(client)
-  )
-}
-
-

package/src/_api/generated/cfg_centrifugo/_utils/hooks/index.ts

@@ -1,30 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-'use client';
-
-/**
- * SWR Hooks - React data fetching hooks
- *
- * Auto-generated from OpenAPI specification.
- * Powered by SWR for automatic caching and revalidation.
- *
- * Features:
- * - Automatic caching and deduplication
- * - Revalidation on focus/reconnect
- * - Optimistic updates
- * - Type-safe parameters and responses
- *
- * Usage:
- * ```typescript
- * import * as hooks from './hooks'
- *
- * // Query hooks (GET)
- * const { data, error, isLoading } = hooks.useUsers({ page: 1 })
- *
- * // Mutation hooks (POST/PUT/PATCH/DELETE)
- * const createUser = hooks.useCreateUser()
- * await createUser({ name: 'John' })
- * ```
- */
-
-export * from './centrifugo__centrifugo_auth'

package/src/_api/generated/cfg_centrifugo/_utils/schemas/ConnectionTokenResponse.schema.ts

@@ -1,22 +0,0 @@
-/**
- * Zod schema for ConnectionTokenResponse
- *
- * This schema provides runtime validation and type inference.
- *  * Response model for Centrifugo connection token.
- *  */
-import { z } from 'zod'
-
-/**
- * Response model for Centrifugo connection token.
- */
-export const ConnectionTokenResponseSchema = z.object({
-  token: z.string(),
-  centrifugo_url: z.string(),
-  expires_at: z.string(),
-  channels: z.array(z.string()),
-})
-
-/**
- * Infer TypeScript type from Zod schema
- */
-export type ConnectionTokenResponse = z.infer<typeof ConnectionTokenResponseSchema>

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

@@ -1,21 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Zod Schemas - Runtime validation and type inference
- *
- * Auto-generated from OpenAPI specification.
- * Provides runtime validation for API requests and responses.
- *
- * Usage:
- * ```typescript
- * import { UserSchema } from './schemas'
- *
- * // Validate data
- * const user = UserSchema.parse(data)
- *
- * // Type inference
- * type User = z.infer<typeof UserSchema>
- * ```
- */
-
-export * from './ConnectionTokenResponse.schema'