@djangocfg/api 1.2.16 → 1.2.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "1.2.16",
+  "version": "1.2.18",
   "author": {
     "name": "DjangoCFG",
     "url": "https://djangocfg.com"
@@ -68,7 +68,7 @@
     "@types/node": "^22.15.3",
     "@types/react": "19.2.2",
     "@types/react-dom": "19.2.1",
-    "@djangocfg/typescript-config": "^1.2.16",
+    "@djangocfg/typescript-config": "^1.2.18",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "tsup": "^8.5.0",

package/src/cfg/generated/_utils/fetchers/cfg__dashboard.ts

@@ -0,0 +1,89 @@
+/**
+ * Typed fetchers for Dashboard
+ *
+ * Universal functions that work in any environment:
+ * - Next.js (App Router / Pages Router / Server Components)
+ * - React Native
+ * - Node.js backend
+ *
+ * These fetchers use Zod schemas for runtime validation.
+ *
+ * Usage:
+ * ```typescript
+ * // Configure API once (in your app entry point)
+ * import { configureAPI } from '../../api-instance'
+ * configureAPI({ baseUrl: 'https://api.example.com' })
+ *
+ * // Then use fetchers anywhere
+ * const users = await getUsers({ page: 1 })
+ *
+ * // With SWR
+ * const { data } = useSWR(['users', params], () => getUsers(params))
+ *
+ * // With React Query
+ * const { data } = useQuery(['users', params], () => getUsers(params))
+ *
+ * // In Server Component or SSR (pass custom client)
+ * import { API } from '../../index'
+ * const api = new API('https://api.example.com')
+ * const users = await getUsers({ page: 1 }, api)
+ * ```
+ */
+import { getAPIInstance } from '../../api-instance'
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/dashboard/api/django_q2/
+ */
+export async function getDashboardApiDjangoQ2Retrieve(  client?: any
+): Promise<any> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_dashboard.apiDjangoQ2Retrieve()
+  return response
+}
+
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/dashboard/api/django_q2/schedules/
+ */
+export async function getDashboardApiDjangoQ2SchedulesRetrieve(  client?: any
+): Promise<any> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_dashboard.apiDjangoQ2SchedulesRetrieve()
+  return response
+}
+
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/dashboard/api/django_q2/status/
+ */
+export async function getDashboardApiDjangoQ2StatusRetrieve(  client?: any
+): Promise<any> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_dashboard.apiDjangoQ2StatusRetrieve()
+  return response
+}
+
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/dashboard/api/django_q2/tasks/
+ */
+export async function getDashboardApiDjangoQ2TasksRetrieve(  client?: any
+): Promise<any> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_dashboard.apiDjangoQ2TasksRetrieve()
+  return response
+}
+
+

package/src/cfg/generated/_utils/fetchers/cfg__tasks.ts

@@ -32,7 +32,9 @@
 import { PaginatedTaskLogListListSchema, type PaginatedTaskLogListList } from '../schemas/PaginatedTaskLogListList.schema'
 import { TaskLogSchema, type TaskLog } from '../schemas/TaskLog.schema'
 import { TaskLogDetailSchema, type TaskLogDetail } from '../schemas/TaskLogDetail.schema'
+import { TaskLogOverviewSchema, type TaskLogOverview } from '../schemas/TaskLogOverview.schema'
 import { TaskLogStatsSchema, type TaskLogStats } from '../schemas/TaskLogStats.schema'
+import { TaskLogTimelineSchema, type TaskLogTimeline } from '../schemas/TaskLogTimeline.schema'
 import { getAPIInstance } from '../../api-instance'
 
 /**
@@ -78,21 +80,21 @@ export async function getTasksLogsRelatedRetrieve(  id: number,  client?: any
 
 
 /**
- * API operation
+ * Task System Overview
  *
  * @method GET
  * @path /cfg/tasks/logs/overview/
  */
 export async function getTasksLogsOverviewRetrieve(  client?: any
-): Promise<TaskLog> {
+): Promise<TaskLogOverview> {
   const api = client || getAPIInstance()
   const response = await api.cfg_tasks.logsOverviewRetrieve()
-  return TaskLogSchema.parse(response)
+  return TaskLogOverviewSchema.parse(response)
 }
 
 
 /**
- * API operation
+ * Task Execution Statistics
  *
  * @method GET
  * @path /cfg/tasks/logs/stats/
@@ -106,16 +108,16 @@ export async function getTasksLogsStatsRetrieve(  client?: any
 
 
 /**
- * API operation
+ * Task Execution Timeline
  *
  * @method GET
  * @path /cfg/tasks/logs/timeline/
  */
 export async function getTasksLogsTimelineRetrieve(  client?: any
-): Promise<TaskLog> {
+): Promise<TaskLogTimeline> {
   const api = client || getAPIInstance()
   const response = await api.cfg_tasks.logsTimelineRetrieve()
-  return TaskLogSchema.parse(response)
+  return TaskLogTimelineSchema.parse(response)
 }
 
 

package/src/cfg/generated/_utils/fetchers/index.ts

@@ -32,6 +32,7 @@ export * from './cfg__centrifugo'
 export * from './cfg__centrifugo__centrifugo_admin_api'
 export * from './cfg__centrifugo__centrifugo_monitoring'
 export * from './cfg__centrifugo__centrifugo_testing'
+export * from './cfg__dashboard'
 export * from './cfg__dashboard__dashboard_activity'
 export * from './cfg__dashboard__dashboard_api_zones'
 export * from './cfg__dashboard__dashboard_charts'

package/src/cfg/generated/_utils/hooks/cfg__dashboard.ts

@@ -0,0 +1,77 @@
+/**
+ * SWR Hooks for Dashboard
+ *
+ * React hooks powered by SWR for data fetching with automatic caching,
+ * revalidation, and optimistic updates.
+ *
+ * Usage:
+ * ```typescript
+ * // Query hooks (GET)
+ * const { data, error, isLoading } = useUsers({ page: 1 })
+ *
+ * // Mutation hooks (POST/PUT/PATCH/DELETE)
+ * const createUser = useCreateUser()
+ * await createUser({ name: 'John', email: 'john@example.com' })
+ * ```
+ */
+import useSWR from 'swr'
+import { useSWRConfig } from 'swr'
+import * as Fetchers from '../fetchers/cfg__dashboard'
+import type { API } from '../../index'
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/dashboard/api/django_q2/
+ */
+export function useDashboardApiDjangoQ2Retrieve(client?: API): ReturnType<typeof useSWR<any>> {
+  return useSWR<any>(
+    'cfg-dashboard-api-django-q2',
+    () => Fetchers.getDashboardApiDjangoQ2Retrieve(client)
+  )
+}
+
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/dashboard/api/django_q2/schedules/
+ */
+export function useDashboardApiDjangoQ2SchedulesRetrieve(client?: API): ReturnType<typeof useSWR<any>> {
+  return useSWR<any>(
+    'cfg-dashboard-api-django-q2-schedule',
+    () => Fetchers.getDashboardApiDjangoQ2SchedulesRetrieve(client)
+  )
+}
+
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/dashboard/api/django_q2/status/
+ */
+export function useDashboardApiDjangoQ2StatusRetrieve(client?: API): ReturnType<typeof useSWR<any>> {
+  return useSWR<any>(
+    'cfg-dashboard-api-django-q2-statu',
+    () => Fetchers.getDashboardApiDjangoQ2StatusRetrieve(client)
+  )
+}
+
+
+/**
+ * API operation
+ *
+ * @method GET
+ * @path /cfg/dashboard/api/django_q2/tasks/
+ */
+export function useDashboardApiDjangoQ2TasksRetrieve(client?: API): ReturnType<typeof useSWR<any>> {
+  return useSWR<any>(
+    'cfg-dashboard-api-django-q2-task',
+    () => Fetchers.getDashboardApiDjangoQ2TasksRetrieve(client)
+  )
+}
+
+

package/src/cfg/generated/_utils/hooks/cfg__tasks.ts

@@ -21,7 +21,9 @@ import type { API } from '../../index'
 import type { PaginatedTaskLogListList } from '../schemas/PaginatedTaskLogListList.schema'
 import type { TaskLog } from '../schemas/TaskLog.schema'
 import type { TaskLogDetail } from '../schemas/TaskLogDetail.schema'
+import type { TaskLogOverview } from '../schemas/TaskLogOverview.schema'
 import type { TaskLogStats } from '../schemas/TaskLogStats.schema'
+import type { TaskLogTimeline } from '../schemas/TaskLogTimeline.schema'
 
 /**
  * API operation
@@ -66,13 +68,13 @@ export function useTasksLogsRelatedRetrieve(id: number, client?: API): ReturnTyp
 
 
 /**
- * API operation
+ * Task System Overview
  *
  * @method GET
  * @path /cfg/tasks/logs/overview/
  */
-export function useTasksLogsOverviewRetrieve(client?: API): ReturnType<typeof useSWR<TaskLog>> {
-  return useSWR<TaskLog>(
+export function useTasksLogsOverviewRetrieve(client?: API): ReturnType<typeof useSWR<TaskLogOverview>> {
+  return useSWR<TaskLogOverview>(
     'cfg-tasks-logs-overview',
     () => Fetchers.getTasksLogsOverviewRetrieve(client)
   )
@@ -80,7 +82,7 @@ export function useTasksLogsOverviewRetrieve(client?: API): ReturnType<typeof us
 
 
 /**
- * API operation
+ * Task Execution Statistics
  *
  * @method GET
  * @path /cfg/tasks/logs/stats/
@@ -94,13 +96,13 @@ export function useTasksLogsStatsRetrieve(client?: API): ReturnType<typeof useSW
 
 
 /**
- * API operation
+ * Task Execution Timeline
  *
  * @method GET
  * @path /cfg/tasks/logs/timeline/
  */
-export function useTasksLogsTimelineRetrieve(client?: API): ReturnType<typeof useSWR<TaskLog>> {
-  return useSWR<TaskLog>(
+export function useTasksLogsTimelineRetrieve(client?: API): ReturnType<typeof useSWR<TaskLogTimeline>> {
+  return useSWR<TaskLogTimeline>(
     'cfg-tasks-logs-timeline',
     () => Fetchers.getTasksLogsTimelineRetrieve(client)
   )

package/src/cfg/generated/_utils/hooks/index.ts

@@ -44,6 +44,7 @@ export * from './cfg__newsletter__testing'
 export * from './cfg__accounts__user_profile'
 export * from './cfg__accounts'
 export * from './cfg__centrifugo'
+export * from './cfg__dashboard'
 export * from './cfg__endpoints'
 export * from './cfg__health'
 export * from './cfg__knowbase'

package/src/cfg/generated/_utils/schemas/DashboardOverview.schema.ts

@@ -3,21 +3,29 @@
  *
  * This schema provides runtime validation and type inference.
  *  * Main serializer for dashboard overview endpoint.
-Uses DictField to avoid allOf generation in OpenAPI.
+Uses typed serializers for proper OpenAPI schema generation.
  *  */
 import { z } from 'zod'
+import { ActivityEntrySchema } from './ActivityEntry.schema'
+import { AppStatisticsSchema } from './AppStatistics.schema'
+import { QuickActionSchema } from './QuickAction.schema'
+import { StatCardSchema } from './StatCard.schema'
+import { SystemHealthSchema } from './SystemHealth.schema'
+import { SystemMetricsSchema } from './SystemMetrics.schema'
+import { UserStatisticsSchema } from './UserStatistics.schema'
 
 /**
  * Main serializer for dashboard overview endpoint.
-Uses DictField to avoid allOf generation in OpenAPI.
+Uses typed serializers for proper OpenAPI schema generation.
  */
 export const DashboardOverviewSchema = z.object({
-  stat_cards: z.array(z.record(z.string(), z.any())),
-  system_health: z.array(z.record(z.string(), z.any())),
-  quick_actions: z.array(z.record(z.string(), z.any())),
-  recent_activity: z.array(z.record(z.string(), z.any())),
-  system_metrics: z.record(z.string(), z.any()),
-  user_statistics: z.record(z.string(), z.any()),
+  stat_cards: z.array(StatCardSchema),
+  system_health: SystemHealthSchema,
+  quick_actions: z.array(QuickActionSchema),
+  recent_activity: z.array(ActivityEntrySchema),
+  system_metrics: SystemMetricsSchema,
+  user_statistics: UserStatisticsSchema,
+  app_statistics: z.array(AppStatisticsSchema).optional(),
   timestamp: z.string(),
 })
 

package/src/cfg/generated/_utils/schemas/TaskLogOverview.schema.ts

@@ -0,0 +1,43 @@
+/**
+ * Zod schema for TaskLogOverview
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Overview of task system with proper structure.
+
+Provides high-level statistics about the entire task system:
+- Total tasks count (all-time)
+- Active queues list
+- Recent failures (last 24h)
+- Tasks distribution by queue (as array)
+- Tasks distribution by status (as array)
+
+Used by /cfg/tasks/logs/overview/ endpoint.
+ *  */
+import { z } from 'zod'
+import { TasksByQueueSchema } from './TasksByQueue.schema'
+import { TasksByStatusSchema } from './TasksByStatus.schema'
+
+/**
+ * Overview of task system with proper structure.
+
+Provides high-level statistics about the entire task system:
+- Total tasks count (all-time)
+- Active queues list
+- Recent failures (last 24h)
+- Tasks distribution by queue (as array)
+- Tasks distribution by status (as array)
+
+Used by /cfg/tasks/logs/overview/ endpoint.
+ */
+export const TaskLogOverviewSchema = z.object({
+  total_tasks: z.int(),
+  active_queues: z.array(z.string()),
+  recent_failures: z.int(),
+  tasks_by_queue: z.array(TasksByQueueSchema),
+  tasks_by_status: z.array(TasksByStatusSchema),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type TaskLogOverview = z.infer<typeof TaskLogOverviewSchema>

package/src/cfg/generated/_utils/schemas/TaskLogTimeline.schema.ts

@@ -0,0 +1,28 @@
+/**
+ * Zod schema for TaskLogTimeline
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Timeline response wrapper.
+
+Returns timeline data as array of time-bucketed statistics.
+Used by /cfg/tasks/logs/timeline/ endpoint.
+ *  */
+import { z } from 'zod'
+import { TaskLogTimelineItemSchema } from './TaskLogTimelineItem.schema'
+
+/**
+ * Timeline response wrapper.
+
+Returns timeline data as array of time-bucketed statistics.
+Used by /cfg/tasks/logs/timeline/ endpoint.
+ */
+export const TaskLogTimelineSchema = z.object({
+  period_hours: z.int(),
+  interval: z.string(),
+  data: z.array(TaskLogTimelineItemSchema),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type TaskLogTimeline = z.infer<typeof TaskLogTimelineSchema>

package/src/cfg/generated/_utils/schemas/TaskLogTimelineItem.schema.ts

@@ -0,0 +1,28 @@
+/**
+ * Zod schema for TaskLogTimelineItem
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Single timeline data point.
+
+Represents aggregated task statistics for a specific time period.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Single timeline data point.
+
+Represents aggregated task statistics for a specific time period.
+ */
+export const TaskLogTimelineItemSchema = z.object({
+  timestamp: z.iso.datetime(),
+  total: z.int(),
+  successful: z.int(),
+  failed: z.int(),
+  in_progress: z.int().optional(),
+  avg_duration_ms: z.number().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type TaskLogTimelineItem = z.infer<typeof TaskLogTimelineItemSchema>

package/src/cfg/generated/_utils/schemas/TasksByQueue.schema.ts

@@ -0,0 +1,24 @@
+/**
+ * Zod schema for TasksByQueue
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Tasks count by queue.
+
+Used in overview endpoint for tasks_by_queue list.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Tasks count by queue.
+
+Used in overview endpoint for tasks_by_queue list.
+ */
+export const TasksByQueueSchema = z.object({
+  queue_name: z.string(),
+  count: z.int(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type TasksByQueue = z.infer<typeof TasksByQueueSchema>

package/src/cfg/generated/_utils/schemas/TasksByStatus.schema.ts

@@ -0,0 +1,24 @@
+/**
+ * Zod schema for TasksByStatus
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Tasks count by status.
+
+Used in overview endpoint for tasks_by_status list.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Tasks count by status.
+
+Used in overview endpoint for tasks_by_status list.
+ */
+export const TasksByStatusSchema = z.object({
+  status: z.string(),
+  count: z.int(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type TasksByStatus = z.infer<typeof TasksByStatusSchema>

package/src/cfg/generated/_utils/schemas/index.ts

@@ -169,7 +169,12 @@ export * from './SystemMetrics.schema'
 export * from './TaskLog.schema'
 export * from './TaskLogDetail.schema'
 export * from './TaskLogList.schema'
+export * from './TaskLogOverview.schema'
 export * from './TaskLogStats.schema'
+export * from './TaskLogTimeline.schema'
+export * from './TaskLogTimelineItem.schema'
+export * from './TasksByQueue.schema'
+export * from './TasksByStatus.schema'
 export * from './TestEmailRequest.schema'
 export * from './Ticket.schema'
 export * from './TicketRequest.schema'

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

@@ -0,0 +1,48 @@
+import * as Models from "./models";
+
+
+/**
+ * API endpoints for Dashboard.
+ */
+export class CfgDashboard {
+  private client: any;
+
+  constructor(client: any) {
+    this.client = client;
+  }
+
+  /**
+   * Get complete Django-Q2 summary. GET /api/django_q2/ Returns status,
+   * schedules, and recent tasks.
+   */
+  async apiDjangoQ2Retrieve(): Promise<any> {
+    const response = await this.client.request('GET', "/cfg/dashboard/api/django_q2/");
+    return response;
+  }
+
+  /**
+   * Get all scheduled tasks. GET /api/django_q2/schedules/
+   */
+  async apiDjangoQ2SchedulesRetrieve(): Promise<any> {
+    const response = await this.client.request('GET', "/cfg/dashboard/api/django_q2/schedules/");
+    return response;
+  }
+
+  /**
+   * Get Django-Q2 cluster status. GET /api/django_q2/status/
+   */
+  async apiDjangoQ2StatusRetrieve(): Promise<any> {
+    const response = await this.client.request('GET', "/cfg/dashboard/api/django_q2/status/");
+    return response;
+  }
+
+  /**
+   * Get recent task executions. GET /api/django_q2/tasks/ Query params: -
+   * limit: Number of tasks to return (default: 20)
+   */
+  async apiDjangoQ2TasksRetrieve(): Promise<any> {
+    const response = await this.client.request('GET', "/cfg/dashboard/api/django_q2/tasks/");
+    return response;
+  }
+
+}

package/src/cfg/generated/cfg__dashboard/index.ts

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