@djangocfg/api 1.2.15 → 1.2.16

package/src/cfg/generated/cfg__tasks/client.ts

@@ -11,83 +11,86 @@ export class CfgTasks {
     this.client = client;
   }
 
-  /**
-   * Clear all test data from Redis.
-   */
-  async apiClearCreate(data: Models.APIResponseRequest): Promise<Models.APIResponse> {
-    const response = await this.client.request('POST', "/cfg/tasks/api/clear/", { body: data });
-    return response;
-  }
-
-  /**
-   * Clear all tasks from all Dramatiq queues.
-   */
-  async apiClearQueuesCreate(data: Models.APIResponseRequest): Promise<Models.APIResponse> {
-    const response = await this.client.request('POST', "/cfg/tasks/api/clear-queues/", { body: data });
-    return response;
-  }
-
-  /**
-   * Purge all failed tasks from queues.
-   */
-  async apiPurgeFailedCreate(data: Models.APIResponseRequest): Promise<Models.APIResponse> {
-    const response = await this.client.request('POST', "/cfg/tasks/api/purge-failed/", { body: data });
-    return response;
-  }
-
-  /**
-   * Manage queue operations (clear, purge, etc.).
-   */
-  async apiQueuesManageCreate(data: Models.QueueActionRequest): Promise<Models.QueueAction> {
-    const response = await this.client.request('POST', "/cfg/tasks/api/queues/manage/", { body: data });
-    return response;
-  }
+  async logsList(created_after?: string, created_before?: string, duration_max?: number, duration_min?: number, end_time?: string, enqueue_after?: string, enqueue_before?: string, finish_after?: string, finish_before?: string, has_error?: boolean, is_completed?: boolean, is_failed?: boolean, is_successful?: boolean, job_id?: string, job_retries_max?: number, job_retries_min?: number, ordering?: string, page?: number, page_size?: number, queue_name?: string, queue_name_in?: any[], search?: string, start_after?: string, start_before?: string, start_time?: string, status?: string, status_in?: any[], success?: boolean, task?: string, task_name?: string, task_name_exact?: string, worker?: string, worker_id?: string): Promise<Models.PaginatedTaskLogListList>;
+  async logsList(params?: { created_after?: string; created_before?: string; duration_max?: number; duration_min?: number; end_time?: string; enqueue_after?: string; enqueue_before?: string; finish_after?: string; finish_before?: string; has_error?: boolean; is_completed?: boolean; is_failed?: boolean; is_successful?: boolean; job_id?: string; job_retries_max?: number; job_retries_min?: number; ordering?: string; page?: number; page_size?: number; queue_name?: string; queue_name_in?: any[]; search?: string; start_after?: string; start_before?: string; start_time?: string; status?: string; status_in?: any[]; success?: boolean; task?: string; task_name?: string; task_name_exact?: string; worker?: string; worker_id?: string }): Promise<Models.PaginatedTaskLogListList>;
 
   /**
-   * Get current status of all queues.
+   * ViewSet for TaskLog monitoring. Provides read-only access to task
+   * execution logs with filtering, searching, and statistics. Endpoints: GET
+   * /api/tasks/logs/ - List all task logs GET /api/tasks/logs/{id}/ - Get
+   * task log details GET /api/tasks/logs/stats/ - Get aggregated statistics
+   * GET /api/tasks/logs/timeline/ - Get task execution timeline GET
+   * /api/tasks/logs/overview/ - Get summary overview
    */
-  async apiQueuesStatusRetrieve(): Promise<Models.QueueStatus> {
-    const response = await this.client.request('GET', "/cfg/tasks/api/queues/status/");
+  async logsList(...args: any[]): Promise<Models.PaginatedTaskLogListList> {
+    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 = { created_after: args[0], created_before: args[1], duration_max: args[2], duration_min: args[3], end_time: args[4], enqueue_after: args[5], enqueue_before: args[6], finish_after: args[7], finish_before: args[8], has_error: args[9], is_completed: args[10], is_failed: args[11], is_successful: args[12], job_id: args[13], job_retries_max: args[14], job_retries_min: args[15], ordering: args[16], page: args[17], page_size: args[18], queue_name: args[19], queue_name_in: args[20], search: args[21], start_after: args[22], start_before: args[23], start_time: args[24], status: args[25], status_in: args[26], success: args[27], task: args[28], task_name: args[29], task_name_exact: args[30], worker: args[31], worker_id: args[32] };
+    }
+    const response = await this.client.request('GET', "/cfg/tasks/logs/", { params });
     return response;
   }
 
   /**
-   * Simulate test data for dashboard testing.
+   * ViewSet for TaskLog monitoring. Provides read-only access to task
+   * execution logs with filtering, searching, and statistics. Endpoints: GET
+   * /api/tasks/logs/ - List all task logs GET /api/tasks/logs/{id}/ - Get
+   * task log details GET /api/tasks/logs/stats/ - Get aggregated statistics
+   * GET /api/tasks/logs/timeline/ - Get task execution timeline GET
+   * /api/tasks/logs/overview/ - Get summary overview
    */
-  async apiSimulateCreate(data: Models.APIResponseRequest): Promise<Models.APIResponse> {
-    const response = await this.client.request('POST', "/cfg/tasks/api/simulate/", { body: data });
+  async logsRetrieve(id: number): Promise<Models.TaskLogDetail> {
+    const response = await this.client.request('GET', `/cfg/tasks/logs/${id}/`);
     return response;
   }
 
   /**
-   * Get paginated task list with filtering.
+   * Get related task logs (same job_id or task_name). Returns tasks that
+   * share the same job_id or are retries of the same task.
    */
-  async apiTasksListRetrieve(): Promise<Models.APIResponse> {
-    const response = await this.client.request('GET', "/cfg/tasks/api/tasks/list/");
+  async logsRelatedRetrieve(id: number): Promise<Models.TaskLog> {
+    const response = await this.client.request('GET', `/cfg/tasks/logs/${id}/related/`);
     return response;
   }
 
   /**
-   * Get task execution statistics.
+   * Get summary overview of task system. Returns: { "total_tasks": 1500,
+   * "active_queues": ["default", "high", "knowledge"], "recent_failures": 5,
+   * "tasks_by_queue": { "default": 800, "high": 500, "knowledge": 200 },
+   * "tasks_by_status": { "completed": 1450, "failed": 45, "in_progress": 5 }
+   * }
    */
-  async apiTasksStatsRetrieve(): Promise<Models.TaskStatistics> {
-    const response = await this.client.request('GET', "/cfg/tasks/api/tasks/stats/");
+  async logsOverviewRetrieve(): Promise<Models.TaskLog> {
+    const response = await this.client.request('GET', "/cfg/tasks/logs/overview/");
     return response;
   }
 
   /**
-   * Get detailed list of workers.
+   * Get aggregated task statistics. Query Parameters: period_hours (int):
+   * Statistics period in hours (default: 24) task_name (str): Filter by
+   * specific task name Returns: { "total": 150, "successful": 145, "failed":
+   * 5, "in_progress": 2, "success_rate": 96.67, "avg_duration_ms": 1250,
+   * "avg_duration_seconds": 1.25, "period_hours": 24 }
    */
-  async apiWorkersListRetrieve(): Promise<Models.APIResponse> {
-    const response = await this.client.request('GET', "/cfg/tasks/api/workers/list/");
+  async logsStatsRetrieve(): Promise<Models.TaskLogStats> {
+    const response = await this.client.request('GET', "/cfg/tasks/logs/stats/");
     return response;
   }
 
   /**
-   * Manage worker operations.
+   * Get task execution timeline grouped by time intervals. Query Parameters:
+   * period_hours (int): Timeline period in hours (default: 24) interval
+   * (str): Grouping interval - 'hour', 'day' (default: 'hour') task_name
+   * (str): Filter by specific task name Returns: [ { "timestamp":
+   * "2025-10-30T10:00:00Z", "total": 15, "successful": 14, "failed": 1,
+   * "avg_duration_ms": 1200 }, ... ]
    */
-  async apiWorkersManageCreate(data: Models.WorkerActionRequest): Promise<Models.WorkerAction> {
-    const response = await this.client.request('POST', "/cfg/tasks/api/workers/manage/", { body: data });
+  async logsTimelineRetrieve(): Promise<Models.TaskLog> {
+    const response = await this.client.request('GET', "/cfg/tasks/logs/timeline/");
     return response;
   }
 

package/src/cfg/generated/cfg__tasks/models.ts

@@ -1,140 +1,203 @@
 import * as Enums from "../enums";
 
 /**
- * Standard API response serializer.
- * 
- * Request model (no read-only fields).
- */
-export interface APIResponseRequest {
-  /** Operation success status */
-  success: boolean;
-  /** Success message */
-  message?: string;
-  /** Error message */
-  error?: string;
-  /** Response data */
-  data?: Record<string, any>;
-}
-
-/**
- * Standard API response serializer.
  * 
  * Response model (includes read-only fields).
  */
-export interface APIResponse {
-  /** Operation success status */
-  success: boolean;
-  /** Success message */
-  message?: string;
-  /** Error message */
-  error?: string;
-  /** Response data */
-  data?: Record<string, any>;
-}
-
-/**
- * Serializer for queue management actions.
- * 
- * Request model (no read-only fields).
- */
-export interface QueueActionRequest {
-  /** Action to perform on queues
-
-  * `clear` - clear
-  * `clear_all` - clear_all
-  * `purge` - purge
-  * `purge_failed` - purge_failed
-  * `flush` - flush */
-  action: Enums.QueueActionRequestAction;
-  /** Specific queues to target (empty = all queues) */
-  queue_names?: Array<string>;
+export interface PaginatedTaskLogListList {
+  /** 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<TaskLogList>;
 }
 
 /**
- * Serializer for queue management actions.
+ * Detailed TaskLog serializer. Includes all fields including args, kwargs,
+ * result, error messages. Combines ReArq Job + JobResult data.
  * 
  * Response model (includes read-only fields).
  */
-export interface QueueAction {
-  /** Action to perform on queues
+export interface TaskLogDetail {
+  id: number;
+  /** Unique job identifier from ReArq */
+  job_id: string;
+  /** Name of the task function */
+  task_name: string;
+  /** Queue where task was executed */
+  queue_name: string;
+  /** Current task status
 
-  * `clear` - clear
-  * `clear_all` - clear_all
-  * `purge` - purge
-  * `purge_failed` - purge_failed
-  * `flush` - flush */
-  action: Enums.QueueActionAction;
-  /** Specific queues to target (empty = all queues) */
-  queue_names?: Array<string>;
+  * `deferred` - Deferred
+  * `queued` - Queued
+  * `in_progress` - In Progress
+  * `success` - Success
+  * `failed` - Failed
+  * `expired` - Expired
+  * `canceled` - Canceled */
+  status: Enums.TaskLogDetailStatus;
+  status_display: string;
+  /** Whether task completed successfully (null = not finished) */
+  success: boolean | null;
+  /** Positional arguments passed to task */
+  args: string;
+  /** Keyword arguments passed to task */
+  kwargs: string;
+  /** Task result (JSON string) */
+  result: string | null;
+  /** Error message if task failed */
+  error_message: string | null;
+  /** Task execution duration in milliseconds */
+  duration_ms: number | null;
+  /** Convert duration from ms to seconds. */
+  duration_seconds: number;
+  /** Maximum number of retries allowed (from task definition) */
+  job_retry: number;
+  /** Number of retries performed so far */
+  job_retries: number;
+  /** Seconds to wait before retry */
+  job_retry_after: number;
+  /** ID of worker that processed the task */
+  worker_id: string | null;
+  /** When job was enqueued to ReArq (from Job.enqueue_time) */
+  enqueue_time: string;
+  /** When job will expire (from Job.expire_time) */
+  expire_time: string | null;
+  /** When task execution started (from JobResult.start_time) */
+  start_time: string | null;
+  /** When task execution finished (from JobResult.finish_time) */
+  finish_time: string | null;
+  /** When TaskLog record was created in Django DB */
+  created_at: string;
+  /** When TaskLog record was last updated */
+  updated_at: string;
+  /** User who triggered the task (if applicable) */
+  user: number | null;
+  /** Get user display name. */
+  user_display: string;
 }
 
 /**
- * Serializer for queue status data.
+ * Basic TaskLog serializer. Used for list views with essential fields only.
+ * Includes computed properties matching ReArq response format.
  * 
  * Response model (includes read-only fields).
  */
-export interface QueueStatus {
-  /** Queue information with pending/failed counts */
-  queues: Record<string, any>;
-  /** Number of active workers */
-  workers: number;
-  /** Redis connection status */
-  redis_connected: boolean;
-  /** Current timestamp */
-  timestamp: string;
-  /** Error message if any */
-  error?: string;
-}
+export interface TaskLog {
+  id: number;
+  /** Unique job identifier from ReArq */
+  job_id: string;
+  /** Name of the task function */
+  task_name: string;
+  /** Queue where task was executed */
+  queue_name: string;
+  /** Current task status
 
-/**
- * Serializer for task statistics data.
- * 
- * Response model (includes read-only fields).
- */
-export interface TaskStatistics {
-  /** Task count statistics */
-  statistics: Record<string, any>;
-  /** List of recent tasks */
-  recent_tasks: Array<Record<string, any>>;
-  /** Current timestamp */
-  timestamp: string;
-  /** Error message if any */
-  error?: string;
+  * `deferred` - Deferred
+  * `queued` - Queued
+  * `in_progress` - In Progress
+  * `success` - Success
+  * `failed` - Failed
+  * `expired` - Expired
+  * `canceled` - Canceled */
+  status: Enums.TaskLogStatus;
+  /** Whether task completed successfully (null = not finished) */
+  success: boolean | null;
+  /** Task execution duration in milliseconds */
+  duration_ms: number | null;
+  /** Convert duration from ms to seconds. */
+  duration_seconds: number;
+  /** Maximum number of retries allowed (from task definition) */
+  job_retry: number;
+  /** Number of retries performed so far */
+  job_retries: number;
+  /** When job was enqueued to ReArq (from Job.enqueue_time) */
+  enqueue_time: string;
+  /** When job will expire (from Job.expire_time) */
+  expire_time: string | null;
+  /** When task execution started (from JobResult.start_time) */
+  start_time: string | null;
+  /** When task execution finished (from JobResult.finish_time) */
+  finish_time: string | null;
+  is_completed: boolean;
+  is_successful: boolean;
+  is_failed: boolean;
 }
 
 /**
- * Serializer for worker management actions.
+ * Statistics serializer for task metrics. Not tied to a model - used for
+ * aggregated data.
  * 
- * Request model (no read-only fields).
+ * Response model (includes read-only fields).
  */
-export interface WorkerActionRequest {
-  /** Action to perform on workers
-
-  * `start` - start
-  * `stop` - stop
-  * `restart` - restart */
-  action: Enums.WorkerActionRequestAction;
-  /** Number of worker processes */
-  processes?: number;
-  /** Number of threads per process */
-  threads?: number;
+export interface TaskLogStats {
+  /** Total number of task executions */
+  total: number;
+  /** Number of successful executions */
+  successful: number;
+  /** Number of failed executions */
+  failed: number;
+  /** Number of tasks currently running */
+  in_progress: number;
+  /** Success rate percentage */
+  success_rate: number;
+  /** Average duration in milliseconds */
+  avg_duration_ms: number;
+  /** Average duration in seconds */
+  avg_duration_seconds: number;
+  /** Statistics period in hours */
+  period_hours?: number;
 }
 
 /**
- * Serializer for worker management actions.
+ * Compact serializer for list views. Minimal fields for performance, matching
+ * ReArq Job list format.
  * 
  * Response model (includes read-only fields).
  */
-export interface WorkerAction {
-  /** Action to perform on workers
+export interface TaskLogList {
+  id: number;
+  /** Unique job identifier from ReArq */
+  job_id: string;
+  /** Name of the task function */
+  task_name: string;
+  /** Queue where task was executed */
+  queue_name: string;
+  /** Current task status
 
-  * `start` - start
-  * `stop` - stop
-  * `restart` - restart */
-  action: Enums.WorkerActionAction;
-  /** Number of worker processes */
-  processes?: number;
-  /** Number of threads per process */
-  threads?: number;
+  * `deferred` - Deferred
+  * `queued` - Queued
+  * `in_progress` - In Progress
+  * `success` - Success
+  * `failed` - Failed
+  * `expired` - Expired
+  * `canceled` - Canceled */
+  status: Enums.TaskLogListStatus;
+  status_display: string;
+  /** Whether task completed successfully (null = not finished) */
+  success: boolean | null;
+  /** Number of retries performed so far */
+  job_retries: number;
+  /** Task execution duration in milliseconds */
+  duration_ms: number | null;
+  /** When job was enqueued to ReArq (from Job.enqueue_time) */
+  enqueue_time: string;
+  /** When task execution started (from JobResult.start_time) */
+  start_time: string | null;
+  /** When task execution finished (from JobResult.finish_time) */
+  finish_time: string | null;
 }
 

package/src/cfg/generated/enums.ts

@@ -387,38 +387,6 @@ export enum PaymentListStatus {
   CANCELLED = "cancelled",
 }
 
-/**
- * Action to perform on queues
- * * `clear` - clear
- * * `clear_all` - clear_all
- * * `purge` - purge
- * * `purge_failed` - purge_failed
- * * `flush` - flush
- */
-export enum QueueActionAction {
-  CLEAR = "clear",
-  CLEAR_ALL = "clear_all",
-  PURGE = "purge",
-  PURGE_FAILED = "purge_failed",
-  FLUSH = "flush",
-}
-
-/**
- * Action to perform on queues
- * * `clear` - clear
- * * `clear_all` - clear_all
- * * `purge` - purge
- * * `purge_failed` - purge_failed
- * * `flush` - flush
- */
-export enum QueueActionRequestAction {
-  CLEAR = "clear",
-  CLEAR_ALL = "clear_all",
-  PURGE = "purge",
-  PURGE_FAILED = "purge_failed",
-  FLUSH = "flush",
-}
-
 /**
  * Button color theme
  * * `primary` - primary
@@ -475,6 +443,66 @@ export enum SystemHealthItemStatus {
   UNKNOWN = "unknown",
 }
 
+/**
+ * Current task status
+ * * `deferred` - Deferred
+ * * `queued` - Queued
+ * * `in_progress` - In Progress
+ * * `success` - Success
+ * * `failed` - Failed
+ * * `expired` - Expired
+ * * `canceled` - Canceled
+ */
+export enum TaskLogStatus {
+  DEFERRED = "deferred",
+  QUEUED = "queued",
+  IN_PROGRESS = "in_progress",
+  SUCCESS = "success",
+  FAILED = "failed",
+  EXPIRED = "expired",
+  CANCELED = "canceled",
+}
+
+/**
+ * Current task status
+ * * `deferred` - Deferred
+ * * `queued` - Queued
+ * * `in_progress` - In Progress
+ * * `success` - Success
+ * * `failed` - Failed
+ * * `expired` - Expired
+ * * `canceled` - Canceled
+ */
+export enum TaskLogDetailStatus {
+  DEFERRED = "deferred",
+  QUEUED = "queued",
+  IN_PROGRESS = "in_progress",
+  SUCCESS = "success",
+  FAILED = "failed",
+  EXPIRED = "expired",
+  CANCELED = "canceled",
+}
+
+/**
+ * Current task status
+ * * `deferred` - Deferred
+ * * `queued` - Queued
+ * * `in_progress` - In Progress
+ * * `success` - Success
+ * * `failed` - Failed
+ * * `expired` - Expired
+ * * `canceled` - Canceled
+ */
+export enum TaskLogListStatus {
+  DEFERRED = "deferred",
+  QUEUED = "queued",
+  IN_PROGRESS = "in_progress",
+  SUCCESS = "success",
+  FAILED = "failed",
+  EXPIRED = "expired",
+  CANCELED = "canceled",
+}
+
 /**
  * * `open` - Open
  * * `waiting_for_user` - Waiting for User
@@ -525,27 +553,3 @@ export enum TransactionTransactionType {
   ADJUSTMENT = "adjustment",
 }
 
-/**
- * Action to perform on workers
- * * `start` - start
- * * `stop` - stop
- * * `restart` - restart
- */
-export enum WorkerActionAction {
-  START = "start",
-  STOP = "stop",
-  RESTART = "restart",
-}
-
-/**
- * Action to perform on workers
- * * `start` - start
- * * `stop` - stop
- * * `restart` - restart
- */
-export enum WorkerActionRequestAction {
-  START = "start",
-  STOP = "stop",
-  RESTART = "restart",
-}
-