@djangocfg/api 1.2.18 → 1.2.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "1.2.18",
+  "version": "1.2.19",
   "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.18",
+    "@djangocfg/typescript-config": "^1.2.19",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "tsup": "^8.5.0",

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

@@ -0,0 +1,122 @@
+/**
+ * Typed fetchers for Grpc Monitoring
+ *
+ * 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 { HealthCheckSchema, type HealthCheck } from '../schemas/HealthCheck.schema'
+import { MethodListSchema, type MethodList } from '../schemas/MethodList.schema'
+import { OverviewStatsSchema, type OverviewStats } from '../schemas/OverviewStats.schema'
+import { RecentRequestsSchema, type RecentRequests } from '../schemas/RecentRequests.schema'
+import { ServiceListSchema, type ServiceList } from '../schemas/ServiceList.schema'
+import { getAPIInstance } from '../../api-instance'
+
+/**
+ * Get gRPC health status
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/health/
+ */
+export async function getGrpcMonitorHealthRetrieve(  client?: any
+): Promise<HealthCheck> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_monitoring.grpcMonitorHealthRetrieve()
+  return HealthCheckSchema.parse(response)
+}
+
+
+/**
+ * Get method statistics
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/methods/
+ */
+export async function getGrpcMonitorMethodsRetrieve(  params?: { hours?: number; service?: string },  client?: any
+): Promise<MethodList> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_monitoring.grpcMonitorMethodsRetrieve(params?.hours, params?.service)
+  return MethodListSchema.parse(response)
+}
+
+
+/**
+ * Get overview statistics
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/overview/
+ */
+export async function getGrpcMonitorOverviewRetrieve(  params?: { hours?: number },  client?: any
+): Promise<OverviewStats> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_monitoring.grpcMonitorOverviewRetrieve(params?.hours)
+  return OverviewStatsSchema.parse(response)
+}
+
+
+/**
+ * Get recent requests
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/requests/
+ */
+export async function getGrpcMonitorRequestsRetrieve(  params?: { count?: number; method?: string; offset?: number; service?: string; status?: string },  client?: any
+): Promise<RecentRequests> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_monitoring.grpcMonitorRequestsRetrieve(params?.count, params?.method, params?.offset, params?.service, params?.status)
+  return RecentRequestsSchema.parse(response)
+}
+
+
+/**
+ * Get service statistics
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/services/
+ */
+export async function getGrpcMonitorServicesRetrieve(  params?: { hours?: number },  client?: any
+): Promise<ServiceList> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_monitoring.grpcMonitorServicesRetrieve(params?.hours)
+  return ServiceListSchema.parse(response)
+}
+
+
+/**
+ * Get request timeline
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/timeline/
+ */
+export async function getGrpcMonitorTimelineRetrieve(  params?: { hours?: number; interval?: string },  client?: any
+): Promise<any> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_monitoring.grpcMonitorTimelineRetrieve(params?.hours, params?.interval)
+  return response
+}
+
+

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

@@ -41,6 +41,7 @@ export * from './cfg__dashboard__dashboard_overview'
 export * from './cfg__dashboard__dashboard_statistics'
 export * from './cfg__dashboard__dashboard_system'
 export * from './cfg__endpoints'
+export * from './cfg__grpc__grpc_monitoring'
 export * from './cfg__health'
 export * from './cfg__knowbase'
 export * from './cfg__leads'

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

@@ -0,0 +1,110 @@
+/**
+ * SWR Hooks for Grpc Monitoring
+ *
+ * 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__grpc__grpc_monitoring'
+import type { API } from '../../index'
+import type { HealthCheck } from '../schemas/HealthCheck.schema'
+import type { MethodList } from '../schemas/MethodList.schema'
+import type { OverviewStats } from '../schemas/OverviewStats.schema'
+import type { RecentRequests } from '../schemas/RecentRequests.schema'
+import type { ServiceList } from '../schemas/ServiceList.schema'
+
+/**
+ * Get gRPC health status
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/health/
+ */
+export function useGrpcMonitorHealthRetrieve(client?: API): ReturnType<typeof useSWR<HealthCheck>> {
+  return useSWR<HealthCheck>(
+    'cfg-grpc-monitor-health',
+    () => Fetchers.getGrpcMonitorHealthRetrieve(client)
+  )
+}
+
+
+/**
+ * Get method statistics
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/methods/
+ */
+export function useGrpcMonitorMethodsRetrieve(params?: { hours?: number; service?: string }, client?: API): ReturnType<typeof useSWR<MethodList>> {
+  return useSWR<MethodList>(
+    params ? ['cfg-grpc-monitor-method', params] : 'cfg-grpc-monitor-method',
+    () => Fetchers.getGrpcMonitorMethodsRetrieve(params, client)
+  )
+}
+
+
+/**
+ * Get overview statistics
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/overview/
+ */
+export function useGrpcMonitorOverviewRetrieve(params?: { hours?: number }, client?: API): ReturnType<typeof useSWR<OverviewStats>> {
+  return useSWR<OverviewStats>(
+    params ? ['cfg-grpc-monitor-overview', params] : 'cfg-grpc-monitor-overview',
+    () => Fetchers.getGrpcMonitorOverviewRetrieve(params, client)
+  )
+}
+
+
+/**
+ * Get recent requests
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/requests/
+ */
+export function useGrpcMonitorRequestsRetrieve(params?: { count?: number; method?: string; offset?: number; service?: string; status?: string }, client?: API): ReturnType<typeof useSWR<RecentRequests>> {
+  return useSWR<RecentRequests>(
+    params ? ['cfg-grpc-monitor-request', params] : 'cfg-grpc-monitor-request',
+    () => Fetchers.getGrpcMonitorRequestsRetrieve(params, client)
+  )
+}
+
+
+/**
+ * Get service statistics
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/services/
+ */
+export function useGrpcMonitorServicesRetrieve(params?: { hours?: number }, client?: API): ReturnType<typeof useSWR<ServiceList>> {
+  return useSWR<ServiceList>(
+    params ? ['cfg-grpc-monitor-service', params] : 'cfg-grpc-monitor-service',
+    () => Fetchers.getGrpcMonitorServicesRetrieve(params, client)
+  )
+}
+
+
+/**
+ * Get request timeline
+ *
+ * @method GET
+ * @path /cfg/grpc/monitor/timeline/
+ */
+export function useGrpcMonitorTimelineRetrieve(params?: { hours?: number; interval?: string }, client?: API): ReturnType<typeof useSWR<any>> {
+  return useSWR<any>(
+    params ? ['cfg-grpc-monitor-timeline', params] : 'cfg-grpc-monitor-timeline',
+    () => Fetchers.getGrpcMonitorTimelineRetrieve(params, client)
+  )
+}
+
+

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

@@ -46,6 +46,7 @@ export * from './cfg__accounts'
 export * from './cfg__centrifugo'
 export * from './cfg__dashboard'
 export * from './cfg__endpoints'
+export * from './cfg__grpc__grpc_monitoring'
 export * from './cfg__health'
 export * from './cfg__knowbase'
 export * from './cfg__leads'

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

@@ -0,0 +1,21 @@
+/**
+ * Zod schema for MethodList
+ *
+ * This schema provides runtime validation and type inference.
+ *  * List of gRPC methods with statistics.
+ *  */
+import { z } from 'zod'
+import { MethodStatsSerializerSchema } from './MethodStatsSerializer.schema'
+
+/**
+ * List of gRPC methods with statistics.
+ */
+export const MethodListSchema = z.object({
+  methods: z.array(MethodStatsSerializerSchema),
+  total_methods: z.int(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type MethodList = z.infer<typeof MethodListSchema>

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

@@ -0,0 +1,25 @@
+/**
+ * Zod schema for MethodStatsSerializer
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Statistics for a single gRPC method.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Statistics for a single gRPC method.
+ */
+export const MethodStatsSerializerSchema = z.object({
+  method_name: z.string(),
+  service_name: z.string(),
+  total: z.int(),
+  successful: z.int(),
+  errors: z.int(),
+  avg_duration_ms: z.number(),
+  last_activity_at: z.string().nullable(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type MethodStatsSerializer = z.infer<typeof MethodStatsSerializerSchema>

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

@@ -0,0 +1,23 @@
+/**
+ * Zod schema for RecentRequests
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Recent gRPC requests list.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Recent gRPC requests list.
+ */
+export const RecentRequestsSchema = z.object({
+  requests: z.array(z.record(z.string(), z.any())),
+  count: z.int(),
+  total_available: z.int(),
+  offset: z.int().optional(),
+  has_more: z.boolean().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type RecentRequests = z.infer<typeof RecentRequestsSchema>

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

@@ -0,0 +1,21 @@
+/**
+ * Zod schema for ServiceList
+ *
+ * This schema provides runtime validation and type inference.
+ *  * List of gRPC services with statistics.
+ *  */
+import { z } from 'zod'
+import { ServiceStatsSerializerSchema } from './ServiceStatsSerializer.schema'
+
+/**
+ * List of gRPC services with statistics.
+ */
+export const ServiceListSchema = z.object({
+  services: z.array(ServiceStatsSerializerSchema),
+  total_services: z.int(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type ServiceList = z.infer<typeof ServiceListSchema>

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

@@ -0,0 +1,24 @@
+/**
+ * Zod schema for ServiceStatsSerializer
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Statistics for a single gRPC service.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Statistics for a single gRPC service.
+ */
+export const ServiceStatsSerializerSchema = z.object({
+  service_name: z.string(),
+  total: z.int(),
+  successful: z.int(),
+  errors: z.int(),
+  avg_duration_ms: z.number(),
+  last_activity_at: z.string().nullable(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type ServiceStatsSerializer = z.infer<typeof ServiceStatsSerializerSchema>

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

@@ -105,6 +105,8 @@ export * from './Message.schema'
 export * from './MessageCreate.schema'
 export * from './MessageCreateRequest.schema'
 export * from './MessageRequest.schema'
+export * from './MethodList.schema'
+export * from './MethodStatsSerializer.schema'
 export * from './Newsletter.schema'
 export * from './NewsletterCampaign.schema'
 export * from './NewsletterCampaignRequest.schema'
@@ -155,10 +157,13 @@ export * from './PublishTestResponse.schema'
 export * from './QuickAction.schema'
 export * from './QuickHealth.schema'
 export * from './RecentPublishes.schema'
+export * from './RecentRequests.schema'
 export * from './RecentUser.schema'
 export * from './SendCampaignRequest.schema'
 export * from './SendCampaignResponse.schema'
 export * from './Sender.schema'
+export * from './ServiceList.schema'
+export * from './ServiceStatsSerializer.schema'
 export * from './StatCard.schema'
 export * from './SubscribeRequest.schema'
 export * from './SubscribeResponse.schema'

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

@@ -0,0 +1,129 @@
+import * as Models from "./models";
+
+
+/**
+ * API endpoints for Grpc Monitoring.
+ */
+export class CfgGrpcMonitoring {
+  private client: any;
+
+  constructor(client: any) {
+    this.client = client;
+  }
+
+  /**
+   * Get gRPC health status
+   * 
+   * Returns the current health status of the gRPC server.
+   */
+  async grpcMonitorHealthRetrieve(): Promise<Models.HealthCheck> {
+    const response = await this.client.request('GET', "/cfg/grpc/monitor/health/");
+    return response;
+  }
+
+  async grpcMonitorMethodsRetrieve(hours?: number, service?: string): Promise<Models.MethodList[]>;
+  async grpcMonitorMethodsRetrieve(params?: { hours?: number; service?: string }): Promise<Models.MethodList[]>;
+
+  /**
+   * Get method statistics
+   * 
+   * Returns statistics grouped by method.
+   */
+  async grpcMonitorMethodsRetrieve(...args: any[]): Promise<Models.MethodList[]> {
+    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 = { hours: args[0], service: args[1] };
+    }
+    const response = await this.client.request('GET', "/cfg/grpc/monitor/methods/", { params });
+    return (response as any).results || [];
+  }
+
+  async grpcMonitorOverviewRetrieve(hours?: number): Promise<Models.OverviewStats>;
+  async grpcMonitorOverviewRetrieve(params?: { hours?: number }): Promise<Models.OverviewStats>;
+
+  /**
+   * Get overview statistics
+   * 
+   * Returns overview statistics for gRPC requests.
+   */
+  async grpcMonitorOverviewRetrieve(...args: any[]): Promise<Models.OverviewStats> {
+    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 = { hours: args[0] };
+    }
+    const response = await this.client.request('GET', "/cfg/grpc/monitor/overview/", { params });
+    return response;
+  }
+
+  async grpcMonitorRequestsRetrieve(count?: number, method?: string, offset?: number, service?: string, status?: string): Promise<Models.RecentRequests>;
+  async grpcMonitorRequestsRetrieve(params?: { count?: number; method?: string; offset?: number; service?: string; status?: string }): Promise<Models.RecentRequests>;
+
+  /**
+   * Get recent requests
+   * 
+   * Returns a list of recent gRPC requests with their details.
+   */
+  async grpcMonitorRequestsRetrieve(...args: any[]): Promise<Models.RecentRequests> {
+    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 = { count: args[0], method: args[1], offset: args[2], service: args[3], status: args[4] };
+    }
+    const response = await this.client.request('GET', "/cfg/grpc/monitor/requests/", { params });
+    return response;
+  }
+
+  async grpcMonitorServicesRetrieve(hours?: number): Promise<Models.ServiceList[]>;
+  async grpcMonitorServicesRetrieve(params?: { hours?: number }): Promise<Models.ServiceList[]>;
+
+  /**
+   * Get service statistics
+   * 
+   * Returns statistics grouped by service.
+   */
+  async grpcMonitorServicesRetrieve(...args: any[]): Promise<Models.ServiceList[]> {
+    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 = { hours: args[0] };
+    }
+    const response = await this.client.request('GET', "/cfg/grpc/monitor/services/", { params });
+    return (response as any).results || [];
+  }
+
+  async grpcMonitorTimelineRetrieve(hours?: number, interval?: string): Promise<any>;
+  async grpcMonitorTimelineRetrieve(params?: { hours?: number; interval?: string }): Promise<any>;
+
+  /**
+   * Get request timeline
+   * 
+   * Returns hourly or daily breakdown of request counts for charts.
+   */
+  async grpcMonitorTimelineRetrieve(...args: any[]): Promise<any> {
+    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 = { hours: args[0], interval: args[1] };
+    }
+    const response = await this.client.request('GET', "/cfg/grpc/monitor/timeline/", { params });
+    return response;
+  }
+
+}

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

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

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

@@ -0,0 +1,124 @@
+/**
+ * Health check response.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface HealthCheck {
+  /** Health status: healthy or unhealthy */
+  status: string;
+  /** Configured wrapper URL */
+  wrapper_url: string;
+  /** Whether API key is configured */
+  has_api_key: boolean;
+  /** Current timestamp */
+  timestamp: string;
+}
+
+/**
+ * List of gRPC methods with statistics.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface MethodList {
+  /** Method statistics */
+  methods: Array<MethodStatsSerializer>;
+  /** Total number of methods */
+  total_methods: number;
+}
+
+/**
+ * Overview statistics for Centrifugo publishes.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface OverviewStats {
+  /** Total publishes in period */
+  total: number;
+  /** Successful publishes */
+  successful: number;
+  /** Failed publishes */
+  failed: number;
+  /** Timeout publishes */
+  timeout: number;
+  /** Success rate percentage */
+  success_rate: number;
+  /** Average duration in milliseconds */
+  avg_duration_ms: number;
+  /** Average ACKs received */
+  avg_acks_received: number;
+  /** Statistics period in hours */
+  period_hours: number;
+}
+
+/**
+ * Recent gRPC requests list.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface RecentRequests {
+  /** List of recent requests */
+  requests: Array<Record<string, any>>;
+  /** Number of requests returned */
+  count: number;
+  /** Total requests available */
+  total_available: number;
+  /** Current offset for pagination */
+  offset?: number;
+  /** Whether more results are available */
+  has_more?: boolean;
+}
+
+/**
+ * List of gRPC services with statistics.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface ServiceList {
+  /** Service statistics */
+  services: Array<ServiceStatsSerializer>;
+  /** Total number of services */
+  total_services: number;
+}
+
+/**
+ * Statistics for a single gRPC method.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface MethodStatsSerializer {
+  /** Method name */
+  method_name: string;
+  /** Service name */
+  service_name: string;
+  /** Total requests */
+  total: number;
+  /** Successful requests */
+  successful: number;
+  /** Error requests */
+  errors: number;
+  /** Average duration */
+  avg_duration_ms: number;
+  /** Last activity timestamp */
+  last_activity_at: string | null;
+}
+
+/**
+ * Statistics for a single gRPC service.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface ServiceStatsSerializer {
+  /** Service name */
+  service_name: string;
+  /** Total requests */
+  total: number;
+  /** Successful requests */
+  successful: number;
+  /** Error requests */
+  errors: number;
+  /** Average duration */
+  avg_duration_ms: number;
+  /** Last activity timestamp */
+  last_activity_at: string | null;
+}
+