django-cfg 1.4.46__py3-none-any.whl → 1.5.181__py3-none-any.whl

django_cfg/modules/django_client/core/generator/typescript/templates/client/client.ts.jinja

@@ -31,6 +31,7 @@ export class APIClient {
   private httpClient: HttpClientAdapter;
   private logger: APILogger | null = null;
   private retryConfig: RetryConfig | null = null;
+  private tokenGetter: (() => string | null) | null = null;
 
   // Sub-clients
 {% for tag in tags %}
@@ -43,10 +44,12 @@ export class APIClient {
       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) {
@@ -65,7 +68,9 @@ export class APIClient {
   }
 
   /**
-   * Get CSRF token from cookies.
+   * Get CSRF token from cookies (for SessionAuthentication).
+   *
+   * Returns null if cookie doesn't exist (JWT-only auth).
    */
   getCsrfToken(): string | null {
     const name = 'csrftoken';
@@ -77,6 +82,21 @@ export class APIClient {
     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.
@@ -88,6 +108,7 @@ export class APIClient {
       params?: Record<string, any>;
       body?: any;
       formData?: FormData;
+      binaryBody?: Blob | ArrayBuffer;
       headers?: Record<string, string>;
     }
   ): Promise<T> {
@@ -124,10 +145,13 @@ export class APIClient {
       params?: Record<string, any>;
       body?: any;
       formData?: FormData;
+      binaryBody?: Blob | ArrayBuffer;
       headers?: Record<string, string>;
     }
   ): Promise<T> {
-    const url = new URL(path, this.baseUrl);
+    // 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
@@ -135,24 +159,29 @@ export class APIClient {
       ...(options?.headers || {})
     };
 
-    // Don't set Content-Type for FormData (browser will set it with boundary)
-    if (!options?.formData && !headers['Content-Type']) {
+    // 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';
     }
 
-    // Add CSRF token for non-GET requests
+{% if has_session_auth %}
+    // Add CSRF token for SessionAuthentication
     if (method !== 'GET') {
       const csrfToken = this.getCsrfToken();
       if (csrfToken) {
         headers['X-CSRFToken'] = csrfToken;
       }
     }
+{% else %}
+    // CSRF not needed - SessionAuthentication not enabled in DRF config
+    // Your API uses JWT/Token authentication (no CSRF required)
+{% endif %}
 
     // Log request
     if (this.logger) {
       this.logger.logRequest({
         method,
-        url: url.toString(),
+        url: url,
         headers,
         body: options?.formData || options?.body,
         timestamp: startTime,
@@ -163,11 +192,12 @@ export class APIClient {
       // Make request via HTTP adapter
       const response = await this.httpClient.request<T>({
         method,
-        url: url.toString(),
+        url: url,
         headers,
         params: options?.params,
         body: options?.body,
         formData: options?.formData,
+        binaryBody: options?.binaryBody,
       });
 
       const duration = Date.now() - startTime;
@@ -178,7 +208,7 @@ export class APIClient {
           response.status,
           response.statusText,
           response.data,
-          url.toString()
+          url
         );
 
         // Log error
@@ -186,7 +216,7 @@ export class APIClient {
           this.logger.logError(
             {
               method,
-              url: url.toString(),
+              url: url,
               headers,
               body: options?.formData || options?.body,
               timestamp: startTime,
@@ -208,7 +238,7 @@ export class APIClient {
         this.logger.logResponse(
           {
             method,
-            url: url.toString(),
+            url: url,
             headers,
             body: options?.formData || options?.body,
             timestamp: startTime,
@@ -232,17 +262,68 @@ export class APIClient {
         throw error;
       }
 
+      // Detect CORS errors and dispatch event
+      const isCORSError = error instanceof TypeError &&
+        (error.message.toLowerCase().includes('cors') ||
+         error.message.toLowerCase().includes('failed to fetch') ||
+         error.message.toLowerCase().includes('network request failed'));
+
+      // Log specific error type first
+      if (this.logger) {
+        if (isCORSError) {
+          this.logger.error(`🚫 CORS Error: ${method} ${url}`);
+          this.logger.error(`  → ${error instanceof Error ? error.message : String(error)}`);
+          this.logger.error(`  → Configure security_domains parameter on the server`);
+        } else {
+          this.logger.error(`⚠️  Network Error: ${method} ${url}`);
+          this.logger.error(`  → ${error instanceof Error ? error.message : String(error)}`);
+        }
+      }
+
+      // Dispatch browser events
+      if (typeof window !== 'undefined') {
+        try {
+          if (isCORSError) {
+            // Dispatch CORS-specific error event
+            window.dispatchEvent(new CustomEvent('cors-error', {
+              detail: {
+                url: url,
+                method: method,
+                error: error instanceof Error ? error.message : String(error),
+                timestamp: new Date(),
+              },
+              bubbles: true,
+              cancelable: false,
+            }));
+          } else {
+            // Dispatch generic network error event
+            window.dispatchEvent(new CustomEvent('network-error', {
+              detail: {
+                url: url,
+                method: method,
+                error: error instanceof Error ? error.message : String(error),
+                timestamp: new Date(),
+              },
+              bubbles: true,
+              cancelable: false,
+            }));
+          }
+        } catch (eventError) {
+          // Silently fail - event dispatch should never crash the app
+        }
+      }
+
       // Wrap other errors as NetworkError
       const networkError = error instanceof Error
-        ? new NetworkError(error.message, url.toString(), error)
-        : new NetworkError('Unknown error', url.toString());
+        ? new NetworkError(error.message, url, error)
+        : new NetworkError('Unknown error', url);
 
-      // Log network error
+      // Detailed logging via logger.logError
       if (this.logger) {
         this.logger.logError(
           {
             method,
-            url: url.toString(),
+            url: url,
             headers,
             body: options?.formData || options?.body,
             timestamp: startTime,
@@ -264,6 +345,7 @@ export class APIClient {
 import * as Enums from "./enums";
 import { HttpClientAdapter, FetchAdapter } from "./http";
 import { APIError, NetworkError } from "./errors";
+import { APILogger, type LoggerConfig } from "./logger";
 import { withRetry, type RetryConfig } from "./retry";
 
 
@@ -284,17 +366,27 @@ import { withRetry, type RetryConfig } from "./retry";
 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;
 
   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) {
@@ -315,6 +407,21 @@ export class APIClient {
     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.
@@ -326,12 +433,26 @@ export class APIClient {
       params?: Record<string, any>;
       body?: any;
       formData?: FormData;
+      binaryBody?: Blob | ArrayBuffer;
       headers?: Record<string, string>;
     }
   ): Promise<T> {
     // Wrap request in retry logic if configured
     if (this.retryConfig) {
-      return withRetry(() => this._makeRequest<T>(method, path, options), 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
@@ -340,6 +461,7 @@ export class APIClient {
 
   /**
    * Internal request method (without retry wrapper).
+   * Used by request() method with optional retry logic.
    */
   private async _makeRequest<T>(
     method: string,
@@ -348,61 +470,198 @@ export class APIClient {
       params?: Record<string, any>;
       body?: any;
       formData?: FormData;
+      binaryBody?: Blob | ArrayBuffer;
       headers?: Record<string, string>;
     }
   ): Promise<T> {
-    const url = new URL(path, this.baseUrl);
+    // 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 (browser will set it with boundary)
-    if (!options?.formData && !headers['Content-Type']) {
+    // 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';
     }
 
-    // Add CSRF token for non-GET requests
+{% if has_session_auth %}
+    // Add CSRF token for SessionAuthentication
     if (method !== 'GET') {
       const csrfToken = this.getCsrfToken();
       if (csrfToken) {
         headers['X-CSRFToken'] = csrfToken;
       }
     }
+{% else %}
+    // CSRF not needed - SessionAuthentication not enabled in DRF config
+    // Your API uses JWT/Token authentication (no CSRF required)
+{% endif %}
+
+    // 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.toString(),
+        url: url,
         headers,
         params: options?.params,
         body: options?.body,
         formData: options?.formData,
+        binaryBody: options?.binaryBody,
       });
 
+      const duration = Date.now() - startTime;
+
       // Check for HTTP errors
       if (response.status >= 400) {
-        throw new APIError(
+        const error = new APIError(
           response.status,
           response.statusText,
           response.data,
-          url.toString()
+          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;
       }
 
+      // Detect CORS errors and dispatch event
+      const isCORSError = error instanceof TypeError &&
+        (error.message.toLowerCase().includes('cors') ||
+         error.message.toLowerCase().includes('failed to fetch') ||
+         error.message.toLowerCase().includes('network request failed'));
+
+      // Log specific error type first
+      if (this.logger) {
+        if (isCORSError) {
+          this.logger.error(`🚫 CORS Error: ${method} ${url}`);
+          this.logger.error(`  → ${error instanceof Error ? error.message : String(error)}`);
+          this.logger.error(`  → Configure security_domains parameter on the server`);
+        } else {
+          this.logger.error(`⚠️  Network Error: ${method} ${url}`);
+          this.logger.error(`  → ${error instanceof Error ? error.message : String(error)}`);
+        }
+      }
+
+      // Dispatch browser events
+      if (typeof window !== 'undefined') {
+        try {
+          if (isCORSError) {
+            // Dispatch CORS-specific error event
+            window.dispatchEvent(new CustomEvent('cors-error', {
+              detail: {
+                url: url,
+                method: method,
+                error: error instanceof Error ? error.message : String(error),
+                timestamp: new Date(),
+              },
+              bubbles: true,
+              cancelable: false,
+            }));
+          } else {
+            // Dispatch generic network error event
+            window.dispatchEvent(new CustomEvent('network-error', {
+              detail: {
+                url: url,
+                method: method,
+                error: error instanceof Error ? error.message : String(error),
+                timestamp: new Date(),
+              },
+              bubbles: true,
+              cancelable: false,
+            }));
+          }
+        } catch (eventError) {
+          // Silently fail - event dispatch should never crash the app
+        }
+      }
+
       // Wrap other errors as NetworkError
-      throw error instanceof Error
-        ? new NetworkError(error.message, url.toString(), error)
-        : new NetworkError('Unknown error', url.toString());
+      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;
     }
   }
 

django_cfg/modules/django_client/core/generator/typescript/templates/client/flat_client.ts.jinja

@@ -25,7 +25,9 @@ export class APIClient {
   }
 
   /**
-   * Get CSRF token from cookies.
+   * Get CSRF token from cookies (for SessionAuthentication).
+   *
+   * Returns null if cookie doesn't exist (JWT-only auth).
    */
   private getCsrfToken(): string | null {
     const name = 'csrftoken';
@@ -38,7 +40,7 @@ export class APIClient {
   }
 
   /**
-   * Make HTTP request with Django CSRF and session handling.
+   * Make HTTP request with automatic CSRF handling.
    */
   private async request<T>(
     method: string,
@@ -59,13 +61,18 @@ export class APIClient {
       headers['Content-Type'] = 'application/json';
     }
 
-    // Add CSRF token for non-GET requests
+{% if has_session_auth %}
+    // Add CSRF token for SessionAuthentication
     if (method !== 'GET') {
       const csrfToken = this.getCsrfToken();
       if (csrfToken) {
         headers['X-CSRFToken'] = csrfToken;
       }
     }
+{% else %}
+    // CSRF not needed - SessionAuthentication not enabled in DRF config
+    // Your API uses JWT/Token authentication (no CSRF required)
+{% endif %}
 
     try {
       // Make request via HTTP adapter

django_cfg/modules/django_client/core/generator/typescript/templates/client_file.ts.jinja

@@ -1,3 +1,5 @@
+{% include '_header.jinja' %}
+
 {% if has_enums %}
 import * as Enums from "./enums";
 {% endif %}

django_cfg/modules/django_client/core/generator/typescript/templates/fetchers/fetchers.ts.jinja

@@ -1,3 +1,5 @@
+{% include '_header.jinja' %}
+
 /**
  * Typed fetchers for {{ tag_display_name }}
  *
@@ -29,6 +31,7 @@
  * const users = await getUsers({ page: 1 }, api)
  * ```
  */
+import { consola } from 'consola'
 {% if has_schemas %}
 {% for schema_name in schema_names %}
 import { {{ schema_name }}Schema, type {{ schema_name }} } from '../schemas/{{ schema_name }}.schema'
@@ -36,7 +39,6 @@ import { {{ schema_name }}Schema, type {{ schema_name }} } from '../schemas/{{ s
 {% endif %}
 {% if has_client %}
 import { getAPIInstance } from '../../api-instance'
-import type { API } from '../../index'
 {% endif %}
 
 {% for fetcher in fetchers %}

django_cfg/modules/django_client/core/generator/typescript/templates/fetchers/function.ts.jinja

@@ -8,7 +8,7 @@ export async function {{ func_name }}(
 {%- if func_params %}
   {{ func_params }},
 {%- endif %}
-  client?
+  client?: any
 ): Promise<{{ response_type }}> {
   const api = client || getAPIInstance()
 {% if api_call_params %}
@@ -17,7 +17,50 @@ export async function {{ func_name }}(
   const response = await {{ api_call }}()
 {% endif %}
 {% if response_schema %}
-  return {{ response_schema }}.parse(response)
+  try {
+    return {{ response_schema }}.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`{{ func_name }}\nPath: {{ operation.path }}\nMethod: {{ operation.http_method }}`);
+
+    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: '{{ func_name }}',
+            path: '{{ operation.path }}',
+            method: '{{ operation.http_method }}',
+            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;
+  }
 {% else %}
   return response
 {% endif %}

django_cfg/modules/django_client/core/generator/typescript/templates/fetchers/index.ts.jinja

@@ -1,3 +1,5 @@
+{% include '_header.jinja' %}
+
 /**
  * Typed Fetchers - Universal API functions
  *

django_cfg/modules/django_client/core/generator/typescript/templates/hooks/hooks.ts.jinja

@@ -1,3 +1,7 @@
+{% include '_header.jinja' %}
+
+'use client';
+
 /**
  * SWR Hooks for {{ tag_display_name }}
  *
@@ -14,8 +18,12 @@
  * await createUser({ name: 'John', email: 'john@example.com' })
  * ```
  */
+{% if has_queries %}
 import useSWR from 'swr'
+{% endif %}
+{% if has_mutations %}
 import { useSWRConfig } from 'swr'
+{% endif %}
 import * as Fetchers from '../fetchers/{{ tag_file }}'
 import type { API } from '../../index'
 {% if has_schemas %}

django_cfg/modules/django_client/core/generator/typescript/templates/hooks/index.ts.jinja

@@ -1,3 +1,7 @@
+{% include '_header.jinja' %}
+
+'use client';
+
 /**
  * SWR Hooks - React data fetching hooks
  *

django_cfg/modules/django_client/core/generator/typescript/templates/index.ts.jinja

@@ -1,3 +1,5 @@
+{% include '_header.jinja' %}
+
 export * from "./client";
 export * as Models from "./models";
 {% if has_enums %}