@djangocfg/api 2.1.55 → 2.1.57

package/src/generated/cfg_totp/storage.ts

@@ -0,0 +1,162 @@
+// 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/generated/cfg_totp/totp/client.ts

@@ -0,0 +1,23 @@
+import * as Models from "./models";
+
+
+/**
+ * API endpoints for Totp.
+ */
+export class Totp {
+  private client: any;
+
+  constructor(client: any) {
+    this.client = client;
+  }
+
+  /**
+   * Delete a TOTP device. Requires verification code if removing the
+   * last/primary device.
+   */
+  async devicesDestroy(id: string): Promise<void> {
+    const response = await this.client.request('DELETE', `/cfg/totp/devices/${id}/`);
+    return;
+  }
+
+}

package/src/generated/cfg_totp/totp/index.ts

@@ -0,0 +1,3 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md
+export * from "./client";
+export * as Models from "./models";

package/src/generated/cfg_totp/totp/models.ts

@@ -0,0 +1 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md

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

@@ -0,0 +1,41 @@
+import * as Models from "./models";
+
+
+/**
+ * API endpoints for 2fa Management.
+ */
+export class 2faManagement {
+  private client: any;
+
+  constructor(client: any) {
+    this.client = client;
+  }
+
+  async totpDevicesList(page?: number, page_size?: number): Promise<Models.PaginatedDeviceListList>;
+  async totpDevicesList(params?: { page?: number; page_size?: number }): Promise<Models.PaginatedDeviceListList>;
+
+  /**
+   * List all TOTP devices for user.
+   */
+  async totpDevicesList(...args: any[]): Promise<Models.PaginatedDeviceListList> {
+    const isParamsObject = args.length === 1 && typeof args[0] === 'object' && args[0] !== null && !Array.isArray(args[0]);
+    
+    let params;
+    if (isParamsObject) {
+      params = args[0];
+    } else {
+      params = { page: args[0], page_size: args[1] };
+    }
+    const response = await this.client.request('GET', "/cfg/totp/devices/", { params });
+    return response;
+  }
+
+  /**
+   * Completely disable 2FA for account. Requires verification code.
+   */
+  async totpDisableCreate(data: Models.DisableRequest): Promise<any> {
+    const response = await this.client.request('POST', "/cfg/totp/disable/", { body: data });
+    return response;
+  }
+
+}

package/src/generated/cfg_totp/totp__2fa_management/index.ts

@@ -0,0 +1,3 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md
+export * from "./client";
+export * as Models from "./models";

package/src/generated/cfg_totp/totp__2fa_management/models.ts

@@ -0,0 +1,60 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md
+import * as Enums from "../enums";
+
+/**
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface PaginatedDeviceListList {
+  /** Total number of items across all pages */
+  count: number;
+  /** Current page number (1-based) */
+  page: number;
+  /** Total number of pages */
+  pages: number;
+  /** Number of items per page */
+  page_size: number;
+  /** Whether there is a next page */
+  has_next: boolean;
+  /** Whether there is a previous page */
+  has_previous: boolean;
+  /** Next page number (null if no next page) */
+  next_page?: number | null;
+  /** Previous page number (null if no previous page) */
+  previous_page?: number | null;
+  /** Array of items for current page */
+  results: Array<DeviceList>;
+}
+
+/**
+ * Serializer for completely disabling 2FA.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface DisableRequest {
+  /** TOTP code for verification */
+  code: string;
+}
+
+/**
+ * Serializer for listing TOTP devices.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface DeviceList {
+  id: number;
+  /** Device name for identification */
+  name: string;
+  /** Primary device used for verification */
+  is_primary: boolean;
+  /** * `pending` - Pending Confirmation
+  * `active` - Active
+  * `disabled` - Disabled */
+  status: Enums.DeviceListStatus;
+  created_at: string;
+  /** When device setup was confirmed */
+  confirmed_at?: string | null;
+  /** Last successful verification */
+  last_used_at?: string | null;
+}
+

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

@@ -0,0 +1,32 @@
+import * as Models from "./models";
+
+
+/**
+ * API endpoints for 2fa Setup.
+ */
+export class 2faSetup {
+  private client: any;
+
+  constructor(client: any) {
+    this.client = client;
+  }
+
+  /**
+   * Start 2FA setup process. Creates a new TOTP device and returns QR code
+   * for scanning.
+   */
+  async totpSetupCreate(data: Models.SetupRequest): Promise<Models.SetupResponse> {
+    const response = await this.client.request('POST', "/cfg/totp/setup/", { body: data });
+    return response;
+  }
+
+  /**
+   * Confirm 2FA setup with first valid code. Activates the device and
+   * generates backup codes.
+   */
+  async totpSetupConfirmCreate(data: Models.ConfirmSetupRequest): Promise<Models.ConfirmSetupResponse> {
+    const response = await this.client.request('POST', "/cfg/totp/setup/confirm/", { body: data });
+    return response;
+  }
+
+}

package/src/generated/cfg_totp/totp__2fa_setup/index.ts

@@ -0,0 +1,3 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md
+export * from "./client";
+export * as Models from "./models";

package/src/generated/cfg_totp/totp__2fa_setup/models.ts

@@ -0,0 +1,54 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md
+/**
+ * Serializer for starting 2FA setup.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface SetupRequest {
+  /** Device name for identification (e.g., 'My iPhone') */
+  device_name?: string;
+}
+
+/**
+ * Response serializer for setup initiation.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface SetupResponse {
+  /** Device ID to use for confirmation */
+  device_id: string;
+  /** Base32-encoded TOTP secret (for manual entry) */
+  secret: string;
+  /** otpauth:// URI for QR code generation */
+  provisioning_uri: string;
+  /** Base64-encoded QR code image (data URI) */
+  qr_code_base64: string;
+  /** Seconds until setup expires (typically 600 = 10 minutes) */
+  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;
+}
+
+/**
+ * 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/generated/cfg_totp/totp__2fa_verification/client.ts

@@ -0,0 +1,32 @@
+import * as Models from "./models";
+
+
+/**
+ * API endpoints for 2fa Verification.
+ */
+export class 2faVerification {
+  private client: any;
+
+  constructor(client: any) {
+    this.client = client;
+  }
+
+  /**
+   * Verify TOTP code for 2FA session. Completes authentication and returns
+   * JWT tokens on success.
+   */
+  async totpVerifyCreate(data: Models.VerifyRequest): Promise<Models.VerifyResponse> {
+    const response = await this.client.request('POST', "/cfg/totp/verify/", { body: data });
+    return response;
+  }
+
+  /**
+   * Verify backup recovery code for 2FA session. Alternative verification
+   * method when TOTP device unavailable.
+   */
+  async totpVerifyBackupCreate(data: Models.VerifyBackupRequest): Promise<Models.VerifyResponse> {
+    const response = await this.client.request('POST', "/cfg/totp/verify/backup/", { body: data });
+    return response;
+  }
+
+}

package/src/generated/cfg_totp/totp__2fa_verification/index.ts

@@ -0,0 +1,3 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md
+export * from "./client";
+export * as Models from "./models";

package/src/generated/cfg_totp/totp__2fa_verification/models.ts

@@ -0,0 +1,44 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md
+/**
+ * Serializer for TOTP code verification during login.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface VerifyRequest {
+  /** 2FA session ID from login response */
+  session_id: string;
+  /** 6-digit TOTP code from authenticator app */
+  code: string;
+}
+
+/**
+ * Response serializer for successful 2FA verification.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface VerifyResponse {
+  message: string;
+  /** JWT access token */
+  access_token: string;
+  /** JWT refresh token */
+  refresh_token: string;
+  /** User profile data */
+  user: Record<string, any>;
+  /** Number of remaining backup codes (if backup code was used) */
+  remaining_backup_codes?: number;
+  /** Warning message (e.g., low backup codes) */
+  warning?: string;
+}
+
+/**
+ * Serializer for backup code verification during login.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface VerifyBackupRequest {
+  /** 2FA session ID from login response */
+  session_id: string;
+  /** 8-character backup recovery code */
+  backup_code: string;
+}
+

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

@@ -0,0 +1,31 @@
+import * as Models from "./models";
+
+
+/**
+ * API endpoints for Backup Codes.
+ */
+export class BackupCodes {
+  private client: any;
+
+  constructor(client: any) {
+    this.client = client;
+  }
+
+  /**
+   * Get backup codes status for user.
+   */
+  async totpBackupCodesRetrieve(): Promise<Models.BackupCodesStatus> {
+    const response = await this.client.request('GET', "/cfg/totp/backup-codes/");
+    return response;
+  }
+
+  /**
+   * Regenerate backup codes. Requires TOTP code for verification.
+   * Invalidates all existing codes.
+   */
+  async totpBackupCodesRegenerateCreate(data: Models.BackupCodesRegenerateRequest): Promise<Models.BackupCodesRegenerateResponse> {
+    const response = await this.client.request('POST', "/cfg/totp/backup-codes/regenerate/", { body: data });
+    return response;
+  }
+
+}

package/src/generated/cfg_totp/totp__backup_codes/index.ts

@@ -0,0 +1,3 @@
+// Auto-generated by DjangoCFG - see CLAUDE.md
+export * from "./client";
+export * as Models from "./models";

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

@@ -0,0 +1,37 @@
+// 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;
+}
+
+/**
+ * Serializer for regenerating backup codes.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface BackupCodesRegenerateRequest {
+  /** TOTP code for verification */
+  code: string;
+}
+
+/**
+ * Response serializer for backup codes regeneration.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface BackupCodesRegenerateResponse {
+  /** List of new backup codes (save these!) */
+  backup_codes: Array<string>;
+  /** Warning about previous codes being invalidated */
+  warning: string;
+}
+

package/src/generated/cfg_totp/validation-events.ts

@@ -0,0 +1,134 @@
+// 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')
+}