@djangocfg/api 2.1.321 → 2.1.327

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

@@ -1,181 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Global API Instance - Singleton configuration with auto-configuration support
- *
- * This module provides a global API instance that auto-configures from
- * environment variables or can be configured manually.
- *
- * 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
- * import { configureAPI } from './api-instance'
- *
- * configureAPI({
- *   baseUrl: 'https://api.example.com',
- *   token: 'your-jwt-token'
- * })
- * ```
- *
- * For SSR or multiple instances:
- * ```typescript
- * import { API } from './index'
- * import { getUsers } from './_utils/fetchers'
- *
- * const api = new API('https://api.example.com')
- * const users = await getUsers({ page: 1 }, api)
- * ```
- */
-
-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
- * 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" })\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 (or can be auto-configured)
- */
-export function isAPIConfigured(): boolean {
-  tryAutoConfigureFromEnv()
-  return globalAPI !== null
-}
-
-/**
- * Configure the global API instance
- *
- * @param baseUrl - Base URL for the API
- * @param options - Optional configuration (storage, retry, logger)
- *
- * @example
- * ```typescript
- * configureAPI({
- *   baseUrl: 'https://api.example.com',
- *   token: 'jwt-token',
- *   options: {
- *     retryConfig: { maxRetries: 3 },
- *     loggerConfig: { enabled: true }
- *   }
- * })
- * ```
- */
-export function configureAPI(config: {
-  baseUrl: string
-  token?: string
-  refreshToken?: string
-  options?: APIOptions
-}): API {
-  globalAPI = new API(config.baseUrl, config.options)
-
-  if (config.token) {
-    globalAPI.setToken(config.token, config.refreshToken)
-  }
-
-  return globalAPI
-}
-
-/**
- * Reconfigure the global API instance with new settings
- * Useful for updating tokens or base URL
- */
-export function reconfigureAPI(updates: {
-  baseUrl?: string
-  token?: string
-  refreshToken?: string
-}): API {
-  const instance = getAPIInstance()
-
-  if (updates.baseUrl) {
-    instance.setBaseUrl(updates.baseUrl)
-  }
-
-  if (updates.token) {
-    instance.setToken(updates.token, updates.refreshToken)
-  }
-
-  return instance
-}
-
-/**
- * Clear tokens from the global API instance
- */
-export function clearAPITokens(): void {
-  const instance = getAPIInstance()
-  instance.clearTokens()
-}
-
-/**
- * Reset the global API instance
- * Useful for testing or logout scenarios
- */
-export function resetAPI(): void {
-  if (globalAPI) {
-    globalAPI.clearTokens()
-  }
-  globalAPI = null
-}

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

@@ -1,339 +0,0 @@
-import { Auth } from "./accounts__auth";
-import { Oauth } from "./accounts__oauth";
-import { UserProfile } from "./accounts__user_profile";
-import { Accounts } from "./accounts";
-import { HttpClientAdapter, FetchAdapter } from "./http";
-import { APIError, NetworkError } from "./errors";
-import { APILogger, type LoggerConfig } from "./logger";
-import { withRetry, type RetryConfig } from "./retry";
-
-
-/**
- * Async API client for Django CFG API.
- *
- * Usage:
- * ```typescript
- * const client = new APIClient('https://api.example.com');
- * const users = await client.users.list();
- * const post = await client.posts.create(newPost);
- *
- * // Custom HTTP adapter (e.g., Axios)
- * const client = new APIClient('https://api.example.com', {
- *   httpClient: new AxiosAdapter()
- * });
- * ```
- */
-export class APIClient {
-  private baseUrl: string;
-  private httpClient: HttpClientAdapter;
-  private logger: APILogger | null = null;
-  private retryConfig: RetryConfig | null = null;
-  private tokenGetter: (() => string | null) | null = null;
-
-  // Sub-clients
-  public auth: Auth;
-  public oauth: Oauth;
-  public user_profile: UserProfile;
-  public accounts: Accounts;
-
-  constructor(
-    baseUrl: string,
-    options?: {
-      httpClient?: HttpClientAdapter;
-      loggerConfig?: Partial<LoggerConfig>;
-      retryConfig?: RetryConfig;
-      tokenGetter?: () => string | null;
-    }
-  ) {
-    this.baseUrl = baseUrl.replace(/\/$/, '');
-    this.httpClient = options?.httpClient || new FetchAdapter();
-    this.tokenGetter = options?.tokenGetter || null;
-
-    // Initialize logger if config provided
-    if (options?.loggerConfig !== undefined) {
-      this.logger = new APILogger(options.loggerConfig);
-    }
-
-    // Store retry configuration
-    if (options?.retryConfig !== undefined) {
-      this.retryConfig = options.retryConfig;
-    }
-
-    // Initialize sub-clients
-    this.auth = new Auth(this);
-    this.oauth = new Oauth(this);
-    this.user_profile = new UserProfile(this);
-    this.accounts = new Accounts(this);
-  }
-
-  /**
-   * Get CSRF token from cookies (for SessionAuthentication).
-   *
-   * Returns null if cookie doesn't exist (JWT-only auth).
-   */
-  getCsrfToken(): string | null {
-    const name = 'csrftoken';
-    const value = `; ${document.cookie}`;
-    const parts = value.split(`; ${name}=`);
-    if (parts.length === 2) {
-      return parts.pop()?.split(';').shift() || null;
-    }
-    return null;
-  }
-
-  /**
-   * Get the base URL for building streaming/download URLs.
-   */
-  getBaseUrl(): string {
-    return this.baseUrl;
-  }
-
-  /**
-   * Get JWT token for URL authentication (used in streaming endpoints).
-   * Returns null if no token getter is configured or no token is available.
-   */
-  getToken(): string | null {
-    return this.tokenGetter ? this.tokenGetter() : null;
-  }
-
-  /**
-   * Make HTTP request with Django CSRF and session handling.
-   * Automatically retries on network errors and 5xx server errors.
-   */
-  async request<T>(
-    method: string,
-    path: string,
-    options?: {
-      params?: Record<string, any>;
-      body?: any;
-      formData?: FormData;
-      binaryBody?: Blob | ArrayBuffer;
-      headers?: Record<string, string>;
-      responseType?: 'json' | 'text' | 'blob';
-    }
-  ): Promise<T> {
-    // Wrap request in retry logic if configured
-    if (this.retryConfig) {
-      return withRetry(() => this._makeRequest<T>(method, path, options), {
-        ...this.retryConfig,
-        onFailedAttempt: (info) => {
-          // Log retry attempts
-          if (this.logger) {
-            this.logger.warn(
-              `Retry attempt ${info.attemptNumber}/${info.retriesLeft + info.attemptNumber} ` +
-              `for ${method} ${path}: ${info.error.message}`
-            );
-          }
-          // Call user's onFailedAttempt if provided
-          this.retryConfig?.onFailedAttempt?.(info);
-        },
-      });
-    }
-
-    // No retry configured, make request directly
-    return this._makeRequest<T>(method, path, options);
-  }
-
-  /**
-   * Internal request method (without retry wrapper).
-   * Used by request() method with optional retry logic.
-   */
-  private async _makeRequest<T>(
-    method: string,
-    path: string,
-    options?: {
-      params?: Record<string, any>;
-      body?: any;
-      formData?: FormData;
-      binaryBody?: Blob | ArrayBuffer;
-      headers?: Record<string, string>;
-      responseType?: 'json' | 'text' | 'blob';
-    }
-  ): Promise<T> {
-    // Build URL - handle both absolute and relative paths
-    // When baseUrl is empty (static builds), path is used as-is (relative to current origin)
-    const url = this.baseUrl ? `${this.baseUrl}${path}` : path;
-    const startTime = Date.now();
-
-    // Build headers - start with custom headers from options
-    const headers: Record<string, string> = {
-      ...(options?.headers || {})
-    };
-
-    // Don't set Content-Type for FormData/binaryBody (browser will set it with boundary)
-    if (!options?.formData && !options?.binaryBody && !headers['Content-Type']) {
-      headers['Content-Type'] = 'application/json';
-    }
-
-    // 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({
-        method,
-        url: url,
-        headers,
-        body: options?.formData || options?.body,
-        timestamp: startTime,
-      });
-    }
-
-    try {
-      // Make request via HTTP adapter
-      const response = await this.httpClient.request<T>({
-        method,
-        url: url,
-        headers,
-        params: options?.params,
-        body: options?.body,
-        formData: options?.formData,
-        binaryBody: options?.binaryBody,
-        responseType: options?.responseType,
-      });
-
-      const duration = Date.now() - startTime;
-
-      // Check for HTTP errors
-      if (response.status >= 400) {
-        const error = new APIError(
-          response.status,
-          response.statusText,
-          response.data,
-          url
-        );
-
-        // Log error
-        if (this.logger) {
-          this.logger.logError(
-            {
-              method,
-              url: url,
-              headers,
-              body: options?.formData || options?.body,
-              timestamp: startTime,
-            },
-            {
-              message: error.message,
-              statusCode: response.status,
-              duration,
-              timestamp: Date.now(),
-            }
-          );
-        }
-
-        throw error;
-      }
-
-      // Log successful response
-      if (this.logger) {
-        this.logger.logResponse(
-          {
-            method,
-            url: url,
-            headers,
-            body: options?.formData || options?.body,
-            timestamp: startTime,
-          },
-          {
-            status: response.status,
-            statusText: response.statusText,
-            data: response.data,
-            duration,
-            timestamp: Date.now(),
-          }
-        );
-      }
-
-      return response.data as T;
-    } catch (error) {
-      const duration = Date.now() - startTime;
-
-      // Re-throw APIError as-is
-      if (error instanceof APIError) {
-        throw error;
-      }
-
-      // Classify network error using PerformanceResourceTiming.
-      // Browser intentionally makes CORS errors indistinguishable from network failures
-      // (same TypeError: "Failed to fetch") for security reasons. We use PerformanceResourceTiming
-      // as the best available heuristic:
-      //   - Entry exists with responseStatus === 0 → request reached server, JS blocked → likely CORS
-      //   - No entry / entry missing → connection never established → server unavailable / DNS / offline
-      // All cases are dispatched as 'network-error' with a `possibly_cors` flag.
-      let possiblyCors = false;
-      if (error instanceof TypeError && typeof window !== 'undefined') {
-        try {
-          const isCrossOrigin = (() => {
-            try { return new URL(url).origin !== window.location.origin; } catch { return false; }
-          })();
-          if (isCrossOrigin) {
-            const entries = performance.getEntriesByName(url, 'resource');
-            if (entries.length > 0) {
-              const last = entries[entries.length - 1] as PerformanceResourceTiming;
-              possiblyCors = 'responseStatus' in last && (last as any).responseStatus === 0;
-            }
-          }
-        } catch { /* ignore — PerformanceResourceTiming not available */ }
-      }
-
-      if (this.logger) {
-        this.logger.error(`⚠️  Network Error: ${method} ${url}`);
-        this.logger.error(`  → ${error instanceof Error ? error.message : String(error)}`);
-        if (possiblyCors) {
-          this.logger.error(`  → Possibly blocked by CORS policy (configure CORS on the server)`);
-        }
-      }
-
-      // Dispatch network-error event with possibly_cors hint
-      if (typeof window !== 'undefined') {
-        try {
-          window.dispatchEvent(new CustomEvent('network-error', {
-            detail: {
-              url: url,
-              method: method,
-              error: error instanceof Error ? error.message : String(error),
-              possibly_cors: possiblyCors,
-              timestamp: new Date(),
-            },
-            bubbles: true,
-            cancelable: false,
-          }));
-        } catch { /* silently ignore — event dispatch must never crash the app */ }
-      }
-
-      // Wrap other errors as NetworkError
-      const networkError = error instanceof Error
-        ? new NetworkError(error.message, url, error)
-        : new NetworkError('Unknown error', url);
-
-      // Detailed logging via logger.logError
-      if (this.logger) {
-        this.logger.logError(
-          {
-            method,
-            url: url,
-            headers,
-            body: options?.formData || options?.body,
-            timestamp: startTime,
-          },
-          {
-            message: networkError.message,
-            duration,
-            timestamp: Date.now(),
-          }
-        );
-      }
-
-      throw networkError;
-    }
-  }
-}

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

@@ -1,10 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * OAuth provider to disconnect
- * * `github` - GitHub
- */
-export enum OAuthConnectionProvider {
-  GITHUB = "github",
-}
-

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

@@ -1,123 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * API Error Classes
- *
- * Typed error classes with Django REST Framework support.
- */
-
-/**
- * HTTP API Error with DRF field-specific validation errors.
- *
- * Usage:
- * ```typescript
- * try {
- *   await api.users.create(userData);
- * } catch (error) {
- *   if (error instanceof APIError) {
- *     if (error.isValidationError) {
- *       console.log('Field errors:', error.fieldErrors);
- *       // { "email": ["Email already exists"], "username": ["Required"] }
- *     }
- *   }
- * }
- * ```
- */
-export class APIError extends Error {
-  constructor(
-    public statusCode: number,
-    public statusText: string,
-    public response: any,
-    public url: string,
-    message?: string
-  ) {
-    super(message || `HTTP ${statusCode}: ${statusText}`);
-    this.name = 'APIError';
-  }
-
-  /**
-   * Get error details from response.
-   * DRF typically returns: { "detail": "Error message" } or { "field": ["error1", "error2"] }
-   */
-  get details(): Record<string, any> | null {
-    if (typeof this.response === 'object' && this.response !== null) {
-      return this.response;
-    }
-    return null;
-  }
-
-  /**
-   * Get field-specific validation errors from DRF.
-   * Returns: { "field_name": ["error1", "error2"], ... }
-   */
-  get fieldErrors(): Record<string, string[]> | null {
-    const details = this.details;
-    if (!details) return null;
-
-    // DRF typically returns: { "field": ["error1", "error2"] }
-    const fieldErrors: Record<string, string[]> = {};
-    for (const [key, value] of Object.entries(details)) {
-      if (Array.isArray(value)) {
-        fieldErrors[key] = value;
-      }
-    }
-
-    return Object.keys(fieldErrors).length > 0 ? fieldErrors : null;
-  }
-
-  /**
-   * Get single error message from DRF.
-   * Checks for "detail", "message", or first field error.
-   */
-  get errorMessage(): string {
-    const details = this.details;
-    if (!details) return this.message;
-
-    // Check for "detail" field (common in DRF)
-    if (details.detail) {
-      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);
-    }
-
-    // Return first field error
-    const fieldErrors = this.fieldErrors;
-    if (fieldErrors) {
-      const firstField = Object.keys(fieldErrors)[0];
-      if (firstField) {
-        return `${firstField}: ${fieldErrors[firstField]?.join(', ')}`;
-      }
-    }
-
-    return this.message;
-  }
-
-  // Helper methods for common HTTP status codes
-  get isValidationError(): boolean { return this.statusCode === 400; }
-  get isAuthError(): boolean { return this.statusCode === 401; }
-  get isPermissionError(): boolean { return this.statusCode === 403; }
-  get isNotFoundError(): boolean { return this.statusCode === 404; }
-  get isServerError(): boolean { return this.statusCode >= 500 && this.statusCode < 600; }
-}
-
-/**
- * Network Error (connection failed, timeout, etc.)
- */
-export class NetworkError extends Error {
-  constructor(
-    message: string,
-    public url: string,
-    public originalError?: Error
-  ) {
-    super(message);
-    this.name = 'NetworkError';
-  }
-}