django-cfg 1.4.10__py3-none-any.whl → 1.4.11__py3-none-any.whl

django_cfg/modules/django_client/core/generator/templates/python/utils/schema.py.jinja

@@ -0,0 +1,12 @@
+"""
+OpenAPI Schema
+
+This file contains the complete OpenAPI specification for this API.
+It can be used for documentation, validation, or code generation.
+"""
+
+from typing import Any, Dict
+
+OPENAPI_SCHEMA: Dict[str, Any] = {{ schema_dict }}
+
+__all__ = ["OPENAPI_SCHEMA"]

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

@@ -0,0 +1,2 @@
+export * from "./client";
+export * as Models from "./models";

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

@@ -0,0 +1,18 @@
+import * as Models from "./models";
+
+
+/**
+ * API endpoints for {{ tag }}.
+ */
+export class {{ class_name }} {
+  private client: any;
+
+  constructor(client: any) {
+    this.client = client;
+  }
+
+{% for operation in operations %}
+  {{ operation }}
+
+{% endfor %}
+}

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

@@ -0,0 +1,327 @@
+{% if sub_clients %}
+{# Namespaced client with sub-clients #}
+{% if include_imports %}
+{% for tag in tags %}
+import { {{ tag.class_name }} } from "./{{ tag.slug }}";
+{% endfor %}
+import { HttpClientAdapter, FetchAdapter } from "./http";
+import { APIError, NetworkError } from "./errors";
+import { APILogger, type LoggerConfig } from "./logger";
+
+
+{% endif %}
+/**
+ * Async API client for {{ info.title }}.
+ *
+ * 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;
+
+  // Sub-clients
+{% for tag in tags %}
+  public {{ tag.property }}: {{ tag.class_name }};
+{% endfor %}
+
+  constructor(
+    baseUrl: string,
+    options?: {
+      httpClient?: HttpClientAdapter;
+      loggerConfig?: Partial<LoggerConfig>;
+    }
+  ) {
+    this.baseUrl = baseUrl.replace(/\/$/, '');
+    this.httpClient = options?.httpClient || new FetchAdapter();
+
+    // Initialize logger if config provided
+    if (options?.loggerConfig !== undefined) {
+      this.logger = new APILogger(options.loggerConfig);
+    }
+
+    // Initialize sub-clients
+{% for tag in tags %}
+    this.{{ tag.property }} = new {{ tag.class_name }}(this);
+{% endfor %}
+  }
+
+  /**
+   * Get CSRF token from cookies.
+   */
+  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;
+  }
+
+  /**
+   * Make HTTP request with Django CSRF and session handling.
+   */
+  async request<T>(
+    method: string,
+    path: string,
+    options?: {
+      params?: Record<string, any>;
+      body?: any;
+      formData?: FormData;
+    }
+  ): Promise<T> {
+    const url = new URL(path, this.baseUrl);
+    const startTime = Date.now();
+
+    // Build headers
+    const headers: Record<string, string> = {};
+
+    // Don't set Content-Type for FormData (browser will set it with boundary)
+    if (!options?.formData) {
+      headers['Content-Type'] = 'application/json';
+    }
+
+    // Add CSRF token for non-GET requests
+    if (method !== 'GET') {
+      const csrfToken = this.getCsrfToken();
+      if (csrfToken) {
+        headers['X-CSRFToken'] = csrfToken;
+      }
+    }
+
+    // Log request
+    if (this.logger) {
+      this.logger.logRequest({
+        method,
+        url: url.toString(),
+        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(),
+        headers,
+        params: options?.params,
+        body: options?.body,
+        formData: options?.formData,
+      });
+
+      const duration = Date.now() - startTime;
+
+      // Check for HTTP errors
+      if (response.status >= 400) {
+        const error = new APIError(
+          response.status,
+          response.statusText,
+          response.data,
+          url.toString()
+        );
+
+        // Log error
+        if (this.logger) {
+          this.logger.logError(
+            {
+              method,
+              url: url.toString(),
+              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.toString(),
+            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;
+      }
+
+      // Wrap other errors as NetworkError
+      const networkError = error instanceof Error
+        ? new NetworkError(error.message, url.toString(), error)
+        : new NetworkError('Unknown error', url.toString());
+
+      // Log network error
+      if (this.logger) {
+        this.logger.logError(
+          {
+            method,
+            url: url.toString(),
+            headers,
+            body: options?.formData || options?.body,
+            timestamp: startTime,
+          },
+          {
+            message: networkError.message,
+            duration,
+            timestamp: Date.now(),
+          }
+        );
+      }
+
+      throw networkError;
+    }
+  }
+}
+{% else %}
+{# Flat client without sub-clients #}
+import * as Enums from "./enums";
+import { HttpClientAdapter, FetchAdapter } from "./http";
+import { APIError, NetworkError } from "./errors";
+
+
+/**
+ * Async API client for {{ info.title }}.
+ *
+ * Usage:
+ * ```typescript
+ * const client = new APIClient('https://api.example.com');
+ * const users = await client.usersList();
+ *
+ * // Custom HTTP adapter
+ * const client = new APIClient('https://api.example.com', {
+ *   httpClient: new AxiosAdapter()
+ * });
+ * ```
+ */
+export class APIClient {
+  private baseUrl: string;
+  private httpClient: HttpClientAdapter;
+
+  constructor(
+    baseUrl: string,
+    options?: { httpClient?: HttpClientAdapter }
+  ) {
+    this.baseUrl = baseUrl.replace(/\/$/, '');
+    this.httpClient = options?.httpClient || new FetchAdapter();
+  }
+
+  /**
+   * Get CSRF token from cookies.
+   */
+  private 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;
+  }
+
+  /**
+   * Make HTTP request with Django CSRF and session handling.
+   */
+  private async request<T>(
+    method: string,
+    path: string,
+    options?: {
+      params?: Record<string, any>;
+      body?: any;
+      formData?: FormData;
+    }
+  ): Promise<T> {
+    const url = new URL(path, this.baseUrl);
+
+    // Build headers
+    const headers: Record<string, string> = {};
+
+    // Don't set Content-Type for FormData (browser will set it with boundary)
+    if (!options?.formData) {
+      headers['Content-Type'] = 'application/json';
+    }
+
+    // Add CSRF token for non-GET requests
+    if (method !== 'GET') {
+      const csrfToken = this.getCsrfToken();
+      if (csrfToken) {
+        headers['X-CSRFToken'] = csrfToken;
+      }
+    }
+
+    try {
+      // Make request via HTTP adapter
+      const response = await this.httpClient.request<T>({
+        method,
+        url: url.toString(),
+        headers,
+        params: options?.params,
+        body: options?.body,
+        formData: options?.formData,
+      });
+
+      // Check for HTTP errors
+      if (response.status >= 400) {
+        throw new APIError(
+          response.status,
+          response.statusText,
+          response.data,
+          url.toString()
+        );
+      }
+
+      return response.data as T;
+    } catch (error) {
+      // Re-throw APIError as-is
+      if (error instanceof APIError) {
+        throw error;
+      }
+
+      // Wrap other errors as NetworkError
+      throw error instanceof Error
+        ? new NetworkError(error.message, url.toString(), error)
+        : new NetworkError('Unknown error', url.toString());
+    }
+  }
+
+  {# Operations will be added here by generator #}
+}
+{% endif %}

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

@@ -0,0 +1,109 @@
+/**
+ * Async API client for {{ api_title }}.
+ *
+ * Usage:
+ * ```typescript
+ * const client = new APIClient('https://api.example.com');
+ * const users = await client.usersList();
+ *
+ * // Custom HTTP adapter
+ * const client = new APIClient('https://api.example.com', {
+ *   httpClient: new AxiosAdapter()
+ * });
+ * ```
+ */
+export class APIClient {
+  private baseUrl: string;
+  private httpClient: HttpClientAdapter;
+
+  constructor(
+    baseUrl: string,
+    options?: { httpClient?: HttpClientAdapter }
+  ) {
+    this.baseUrl = baseUrl.replace(/\/$/, '');
+    this.httpClient = options?.httpClient || new FetchAdapter();
+  }
+
+  /**
+   * Get CSRF token from cookies.
+   */
+  private 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;
+  }
+
+  /**
+   * Make HTTP request with Django CSRF and session handling.
+   */
+  private async request<T>(
+    method: string,
+    path: string,
+    options?: {
+      params?: Record<string, any>;
+      body?: any;
+      formData?: FormData;
+    }
+  ): Promise<T> {
+    const url = new URL(path, this.baseUrl);
+
+    // Build headers
+    const headers: Record<string, string> = {};
+
+    // Don't set Content-Type for FormData (browser will set it with boundary)
+    if (!options?.formData) {
+      headers['Content-Type'] = 'application/json';
+    }
+
+    // Add CSRF token for non-GET requests
+    if (method !== 'GET') {
+      const csrfToken = this.getCsrfToken();
+      if (csrfToken) {
+        headers['X-CSRFToken'] = csrfToken;
+      }
+    }
+
+    try {
+      // Make request via HTTP adapter
+      const response = await this.httpClient.request<T>({
+        method,
+        url: url.toString(),
+        headers,
+        params: options?.params,
+        body: options?.body,
+        formData: options?.formData,
+      });
+
+      // Check for HTTP errors
+      if (response.status >= 400) {
+        throw new APIError(
+          response.status,
+          response.statusText,
+          response.data,
+          url.toString()
+        );
+      }
+
+      return response.data as T;
+    } catch (error) {
+      // Re-throw APIError as-is
+      if (error instanceof APIError) {
+        throw error;
+      }
+
+      // Wrap other errors as NetworkError
+      throw error instanceof Error
+        ? new NetworkError(error.message, url.toString(), error)
+        : new NetworkError('Unknown error', url.toString());
+    }
+  }
+
+{% for operation in operations %}
+  {{ operation }}
+
+{% endfor %}
+}

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

@@ -0,0 +1,9 @@
+{% for tag in tags %}
+import { {{ tag.class_name }} } from "./{{ tag.slug }}";
+{% endfor %}
+import { HttpClientAdapter, FetchAdapter } from "./http";
+import { APIError, NetworkError } from "./errors";
+import { APILogger, type LoggerConfig } from "./logger";
+
+
+{{ client_code }}

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

@@ -0,0 +1,61 @@
+{# Macro for generating TypeScript operation method #}
+{% macro render_operation(operation, in_subclient=False) %}
+{%- set request_prefix = "this.client" if in_subclient else "this" -%}
+
+{%- if operation.summary or operation.description -%}
+/**
+{%- if operation.summary %}
+ * {{ operation.summary }}
+{%- endif %}
+{%- if operation.description %}
+ *
+{%- for line in operation.description.split('\n') %}
+ * {{ line }}
+{%- endfor %}
+{%- endif %}
+ */
+{%- endif %}
+async {{ operation.method_name }}(
+  {%- for param in operation.params -%}
+  {{ param.name }}{{ '?' if param.optional else '' }}: {{ param.type }}{{ ', ' if not loop.last else '' }}
+  {%- endfor -%}
+): Promise<{{ operation.return_type }}> {
+{%- if operation.is_multipart %}
+  const formData = new FormData();
+{%- for field in operation.multipart_fields %}
+{%- if field.is_file %}
+  formData.append('{{ field.name }}', {{ field.name }});
+{%- else %}
+{%- if field.optional %}
+  if ({{ field.name }} !== undefined) formData.append('{{ field.name }}', String({{ field.name }}));
+{%- else %}
+  formData.append('{{ field.name }}', String({{ field.name }}));
+{%- endif %}
+{%- endif %}
+{%- endfor %}
+{%- endif %}
+  const response = await {{ request_prefix }}.request<{{ operation.return_type }}>(
+    '{{ operation.http_method }}',
+    {{ operation.path_expr }}
+    {%- if operation.has_options -%}
+    , {
+      {%- if operation.query_params %}
+      params: { {{ operation.query_params }} }{{ ',' if operation.has_body or operation.is_multipart else '' }}
+      {%- endif %}
+      {%- if operation.is_multipart %}
+      formData
+      {%- elif operation.has_body %}
+      body: data
+      {%- endif %}
+    }
+    {%- endif -%}
+  );
+{%- if operation.is_list %}
+  return (response as any).results || [];
+{%- elif operation.return_type != 'void' %}
+  return response;
+{%- else %}
+  return;
+{%- endif %}
+}
+{% endmacro %}

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

@@ -0,0 +1,15 @@
+/**
+ * API endpoints for {{ tag }}.
+ */
+class {{ class_name }} {
+  private client: APIClient;
+
+  constructor(client: APIClient) {
+    this.client = client;
+  }
+
+{% for operation in operations %}
+  {{ operation }}
+
+{% endfor %}
+}

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

@@ -0,0 +1,9 @@
+{% if has_enums %}
+import * as Enums from "./enums";
+{% endif %}
+import { HttpClientAdapter, FetchAdapter } from "./http";
+import { APIError, NetworkError } from "./errors";
+import { APILogger, type LoggerConfig } from "./logger";
+
+
+{{ client_code }}

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

@@ -0,0 +1,5 @@
+export * from "./client";
+export * as Models from "./models";
+{% if has_enums %}
+export * as Enums from "./enums";
+{% endif %}