@djangocfg/ext-support 1.0.0

package/src/api/generated/ext_support/ext_support__support/models.ts

@@ -0,0 +1,165 @@
+import * as Enums from "../enums";
+
+/**
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface PaginatedTicketList {
+  /** 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<Ticket>;
+}
+
+/**
+ * 
+ * Request model (no read-only fields).
+ */
+export interface TicketRequest {
+  user: number;
+  subject: string;
+  /** * `open` - Open
+  * `waiting_for_user` - Waiting for User
+  * `waiting_for_admin` - Waiting for Admin
+  * `resolved` - Resolved
+  * `closed` - Closed */
+  status?: Enums.TicketRequestStatus;
+}
+
+/**
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface Ticket {
+  uuid: string;
+  user: number;
+  subject: string;
+  /** * `open` - Open
+  * `waiting_for_user` - Waiting for User
+  * `waiting_for_admin` - Waiting for Admin
+  * `resolved` - Resolved
+  * `closed` - Closed */
+  status?: Enums.TicketStatus;
+  created_at: string;
+  /** Get count of unanswered messages for this specific ticket. */
+  unanswered_messages_count: number;
+}
+
+/**
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface PaginatedMessageList {
+  /** 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<Message>;
+}
+
+/**
+ * 
+ * Request model (no read-only fields).
+ */
+export interface MessageCreateRequest {
+  text: string;
+}
+
+/**
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface MessageCreate {
+  text: string;
+}
+
+/**
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface Message {
+  uuid: string;
+  ticket: string;
+  sender: Sender;
+  /** Check if this message is from the ticket author. */
+  is_from_author: boolean;
+  text: string;
+  created_at: string;
+}
+
+/**
+ * 
+ * Request model (no read-only fields).
+ */
+export interface MessageRequest {
+  text: string;
+}
+
+/**
+ * 
+ * Request model (no read-only fields).
+ */
+export interface PatchedMessageRequest {
+  text?: string;
+}
+
+/**
+ * 
+ * Request model (no read-only fields).
+ */
+export interface PatchedTicketRequest {
+  user?: number;
+  subject?: string;
+  /** * `open` - Open
+  * `waiting_for_user` - Waiting for User
+  * `waiting_for_admin` - Waiting for Admin
+  * `resolved` - Resolved
+  * `closed` - Closed */
+  status?: Enums.PatchedTicketRequestStatus;
+}
+
+/**
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface Sender {
+  id: number;
+  /** Get formatted username for display. */
+  display_username: string;
+  email: string;
+  avatar?: string | null;
+  /** Get user's initials for avatar fallback. */
+  initials: string;
+  /** Designates whether the user can log into this admin site. */
+  is_staff: boolean;
+  /** Designates that this user has all permissions without explicitly assigning them. */
+  is_superuser: boolean;
+}
+

package/src/api/generated/ext_support/http.ts

@@ -0,0 +1,103 @@
+/**
+ * HTTP Client Adapter Pattern
+ *
+ * Allows switching between fetch/axios/httpx without changing generated code.
+ * Provides unified interface for making HTTP requests.
+ */
+
+export interface HttpRequest {
+  method: string;
+  url: string;
+  headers?: Record<string, string>;
+  body?: any;
+  params?: Record<string, any>;
+  /** FormData for file uploads (multipart/form-data) */
+  formData?: FormData;
+}
+
+export interface HttpResponse<T = any> {
+  data: T;
+  status: number;
+  statusText: string;
+  headers: Record<string, string>;
+}
+
+/**
+ * HTTP Client Adapter Interface.
+ * Implement this to use custom HTTP clients (axios, httpx, etc.)
+ */
+export interface HttpClientAdapter {
+  request<T = any>(request: HttpRequest): Promise<HttpResponse<T>>;
+}
+
+/**
+ * Default Fetch API adapter.
+ * Uses native browser fetch() with proper error handling.
+ */
+export class FetchAdapter implements HttpClientAdapter {
+  async request<T = any>(request: HttpRequest): Promise<HttpResponse<T>> {
+    const { method, url, headers, body, params, formData } = request;
+
+    // Build URL with query params
+    let finalUrl = url;
+    if (params) {
+      const searchParams = new URLSearchParams();
+      Object.entries(params).forEach(([key, value]) => {
+        if (value !== null && value !== undefined) {
+          searchParams.append(key, String(value));
+        }
+      });
+      const queryString = searchParams.toString();
+      if (queryString) {
+        finalUrl = url.includes('?') ? `${url}&${queryString}` : `${url}?${queryString}`;
+      }
+    }
+
+    // Build headers
+    const finalHeaders: Record<string, string> = { ...headers };
+
+    // Determine body and content-type
+    let requestBody: string | FormData | undefined;
+
+    if (formData) {
+      // For multipart/form-data, let browser set Content-Type with boundary
+      requestBody = formData;
+      // Don't set Content-Type - browser will set it with boundary
+    } else if (body) {
+      // JSON request
+      finalHeaders['Content-Type'] = 'application/json';
+      requestBody = JSON.stringify(body);
+    }
+
+    // Make request
+    const response = await fetch(finalUrl, {
+      method,
+      headers: finalHeaders,
+      body: requestBody,
+      credentials: 'include',  // Include Django session cookies
+    });
+
+    // Parse response
+    let data: any = null;
+    const contentType = response.headers.get('content-type');
+
+    if (response.status !== 204 && contentType?.includes('application/json')) {
+      data = await response.json();
+    } else if (response.status !== 204) {
+      data = await response.text();
+    }
+
+    // Convert Headers to plain object
+    const responseHeaders: Record<string, string> = {};
+    response.headers.forEach((value, key) => {
+      responseHeaders[key] = value;
+    });
+
+    return {
+      data,
+      status: response.status,
+      statusText: response.statusText,
+      headers: responseHeaders,
+    };
+  }
+}

package/src/api/generated/ext_support/index.ts

@@ -0,0 +1,273 @@
+/**
+ * Django CFG API - API Client with JWT Management
+ *
+ * Usage:
+ * ```typescript
+ * import { API } from './api';
+ *
+ * const api = new API('https://api.example.com');
+ *
+ * // Set JWT token
+ * api.setToken('your-jwt-token', 'refresh-token');
+ *
+ * // Use API
+ * const posts = await api.posts.list();
+ * const user = await api.users.retrieve(1);
+ *
+ * // Check authentication
+ * if (api.isAuthenticated()) {
+ *   // ...
+ * }
+ *
+ * // Custom storage with logging (for Electron/Node.js)
+ * import { MemoryStorageAdapter, APILogger } from './storage';
+ * const logger = new APILogger({ enabled: true, logLevel: 'debug' });
+ * const api = new API('https://api.example.com', {
+ *   storage: new MemoryStorageAdapter(logger),
+ *   loggerConfig: { enabled: true, logLevel: 'debug' }
+ * });
+ *
+ * // Get OpenAPI schema
+ * const schema = api.getSchema();
+ * ```
+ */
+
+import { APIClient } from "./client";
+import {
+  StorageAdapter,
+  LocalStorageAdapter,
+  CookieStorageAdapter,
+  MemoryStorageAdapter
+} from "./storage";
+import type { RetryConfig } from "./retry";
+import type { LoggerConfig } from "./logger";
+import { APILogger } from "./logger";
+import { ExtSupportSupport } from "./ext_support__support/client";
+export * as ExtSupportSupportTypes from "./ext_support__support/models";
+// Note: Direct exports (export * from) are removed to avoid duplicate type conflicts
+// Use namespace exports like CfgAccountsTypes.User or import from specific modules
+export * as Enums from "./enums";
+
+// Re-export Zod schemas for runtime validation
+export * as Schemas from "./_utils/schemas";
+// Also export all schemas directly for convenience
+export * from "./_utils/schemas";
+
+// Re-export Zod validation events for browser integration
+export type { ValidationErrorDetail, ValidationErrorEvent } from "./validation-events";
+export { dispatchValidationError, onValidationError, formatZodError } from "./validation-events";
+
+// Re-export typed fetchers for universal usage
+export * as Fetchers from "./_utils/fetchers";
+export * from "./_utils/fetchers";
+
+// Re-export API instance configuration functions
+export {
+  configureAPI,
+  getAPIInstance,
+  reconfigureAPI,
+  clearAPITokens,
+  resetAPI,
+  isAPIConfigured
+} from "./api-instance";
+// NOTE: SWR hooks are generated in ./_utils/hooks/ but NOT exported here to keep
+// the main bundle server-safe. Import hooks directly from the hooks directory:
+//   import { useUsers } from './_utils/hooks';
+// Or use a separate entry point like '@djangocfg/api/hooks' for client components.
+
+// Re-export core client
+export { APIClient };
+
+// Re-export storage adapters for convenience
+export type { StorageAdapter };
+export { LocalStorageAdapter, CookieStorageAdapter, MemoryStorageAdapter };
+
+// Re-export error classes for convenience
+export { APIError, NetworkError } from "./errors";
+
+// Re-export HTTP adapters for custom implementations
+export type { HttpClientAdapter, HttpRequest, HttpResponse } from "./http";
+export { FetchAdapter } from "./http";
+
+// Re-export logger types and classes
+export type { LoggerConfig, RequestLog, ResponseLog, ErrorLog } from "./logger";
+export { APILogger } from "./logger";
+
+// Re-export retry configuration and utilities
+export type { RetryConfig, FailedAttemptInfo } from "./retry";
+export { withRetry, shouldRetry, DEFAULT_RETRY_CONFIG } from "./retry";
+
+export const TOKEN_KEY = "auth_token";
+export const REFRESH_TOKEN_KEY = "refresh_token";
+
+export interface APIOptions {
+  /** Custom storage adapter (defaults to LocalStorageAdapter) */
+  storage?: StorageAdapter;
+  /** Retry configuration for failed requests */
+  retryConfig?: RetryConfig;
+  /** Logger configuration */
+  loggerConfig?: Partial<LoggerConfig>;
+}
+
+export class API {
+  private baseUrl: string;
+  private _client: APIClient;
+  private _token: string | null = null;
+  private _refreshToken: string | null = null;
+  private storage: StorageAdapter;
+  private options?: APIOptions;
+
+  // Sub-clients
+  public ext_support_support!: ExtSupportSupport;
+
+  constructor(baseUrl: string, options?: APIOptions) {
+    this.baseUrl = baseUrl;
+    this.options = options;
+
+    // Create logger if config provided
+    const logger = options?.loggerConfig ? new APILogger(options.loggerConfig) : undefined;
+
+    // Initialize storage with logger
+    this.storage = options?.storage || new LocalStorageAdapter(logger);
+
+    this._loadTokensFromStorage();
+
+    // Initialize APIClient
+    this._client = new APIClient(this.baseUrl, {
+      retryConfig: this.options?.retryConfig,
+      loggerConfig: this.options?.loggerConfig,
+    });
+
+    // Always inject auth header wrapper (reads token dynamically from storage)
+    this._injectAuthHeader();
+
+    // Initialize sub-clients from APIClient
+    this.ext_support_support = this._client.ext_support_support;
+  }
+
+  private _loadTokensFromStorage(): void {
+    this._token = this.storage.getItem(TOKEN_KEY);
+    this._refreshToken = this.storage.getItem(REFRESH_TOKEN_KEY);
+  }
+
+  private _reinitClients(): void {
+    this._client = new APIClient(this.baseUrl, {
+      retryConfig: this.options?.retryConfig,
+      loggerConfig: this.options?.loggerConfig,
+    });
+
+    // Always inject auth header wrapper (reads token dynamically from storage)
+    this._injectAuthHeader();
+
+    // Reinitialize sub-clients
+    this.ext_support_support = this._client.ext_support_support;
+  }
+
+  private _injectAuthHeader(): void {
+    // Override request method to inject auth header
+    const originalRequest = this._client.request.bind(this._client);
+    this._client.request = async <T>(
+      method: string,
+      path: string,
+      options?: { params?: Record<string, any>; body?: any; formData?: FormData; headers?: Record<string, string> }
+    ): Promise<T> => {
+      // Read token from storage dynamically (supports JWT injection after instantiation)
+      const token = this.getToken();
+      const mergedOptions = {
+        ...options,
+        headers: {
+          ...(options?.headers || {}),
+          ...(token ? { 'Authorization': `Bearer ${token}` } : {}),
+        },
+      };
+
+      return originalRequest(method, path, mergedOptions);
+    };
+  }
+
+  /**
+   * Get current JWT token
+   */
+  getToken(): string | null {
+    return this.storage.getItem(TOKEN_KEY);
+  }
+
+  /**
+   * Get current refresh token
+   */
+  getRefreshToken(): string | null {
+    return this.storage.getItem(REFRESH_TOKEN_KEY);
+  }
+
+  /**
+   * Set JWT token and refresh token
+   * @param token - JWT access token
+   * @param refreshToken - JWT refresh token (optional)
+   */
+  setToken(token: string, refreshToken?: string): void {
+    this._token = token;
+    this.storage.setItem(TOKEN_KEY, token);
+
+    if (refreshToken) {
+      this._refreshToken = refreshToken;
+      this.storage.setItem(REFRESH_TOKEN_KEY, refreshToken);
+    }
+
+    // Reinitialize clients with new token
+    this._reinitClients();
+  }
+
+  /**
+   * Clear all tokens
+   */
+  clearTokens(): void {
+    this._token = null;
+    this._refreshToken = null;
+    this.storage.removeItem(TOKEN_KEY);
+    this.storage.removeItem(REFRESH_TOKEN_KEY);
+
+    // Reinitialize clients without token
+    this._reinitClients();
+  }
+
+  /**
+   * Check if user is authenticated
+   */
+  isAuthenticated(): boolean {
+    return !!this.getToken();
+  }
+
+  /**
+   * Update base URL and reinitialize clients
+   * @param url - New base URL
+   */
+  setBaseUrl(url: string): void {
+    this.baseUrl = url;
+    this._reinitClients();
+  }
+
+  /**
+   * Get current base URL
+   */
+  getBaseUrl(): string {
+    return this.baseUrl;
+  }
+
+  /**
+   * Get OpenAPI schema path
+   * @returns Path to the OpenAPI schema JSON file
+   *
+   * Note: The OpenAPI schema is available in the schema.json file.
+   * You can load it dynamically using:
+   * ```typescript
+   * const schema = await fetch('./schema.json').then(r => r.json());
+   * // or using fs in Node.js:
+   * // const schema = JSON.parse(fs.readFileSync('./schema.json', 'utf-8'));
+   * ```
+   */
+  getSchemaPath(): string {
+    return './schema.json';
+  }
+}
+
+export default API;