@djangocfg/api 1.2.20 → 1.2.22

package/package.json

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

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

@@ -0,0 +1,48 @@
+/**
+ * Typed fetchers for Dashboard - Config
+ *
+ * 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 { ConfigDataSchema, type ConfigData } from '../schemas/ConfigData.schema'
+import { getAPIInstance } from '../../api-instance'
+
+/**
+ * Get configuration data
+ *
+ * @method GET
+ * @path /cfg/dashboard/api/config/config/
+ */
+export async function getDashboardApiConfigConfigRetrieve(  client?: any
+): Promise<ConfigData> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_dashboard_config.dashboardApiConfigConfigRetrieve()
+  return ConfigDataSchema.parse(response)
+}
+
+

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

@@ -0,0 +1,63 @@
+/**
+ * Typed fetchers for Grpc Configuration
+ *
+ * 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 { GRPCConfigSchema, type GRPCConfig } from '../schemas/GRPCConfig.schema'
+import { GRPCServerInfoSchema, type GRPCServerInfo } from '../schemas/GRPCServerInfo.schema'
+import { getAPIInstance } from '../../api-instance'
+
+/**
+ * Get gRPC configuration
+ *
+ * @method GET
+ * @path /cfg/grpc/config/config/
+ */
+export async function getGrpcConfigConfigRetrieve(  client?: any
+): Promise<GRPCConfig> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_configuration.grpcConfigConfigRetrieve()
+  return GRPCConfigSchema.parse(response)
+}
+
+
+/**
+ * Get server information
+ *
+ * @method GET
+ * @path /cfg/grpc/config/server-info/
+ */
+export async function getGrpcConfigServerInfoRetrieve(  client?: any
+): Promise<GRPCServerInfo> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_configuration.grpcConfigServerInfoRetrieve()
+  return GRPCServerInfoSchema.parse(response)
+}
+
+

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

@@ -0,0 +1,77 @@
+/**
+ * Typed fetchers for Grpc Services
+ *
+ * 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 { ServiceDetailSchema, type ServiceDetail } from '../schemas/ServiceDetail.schema'
+import { ServiceMethodsSchema, type ServiceMethods } from '../schemas/ServiceMethods.schema'
+import { getAPIInstance } from '../../api-instance'
+
+/**
+ * List all services
+ *
+ * @method GET
+ * @path /cfg/grpc/services/
+ */
+export async function getGrpcServicesList(  params?: { hours?: number },  client?: any
+): Promise<any> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_services.list(params?.hours)
+  return response
+}
+
+
+/**
+ * Get service details
+ *
+ * @method GET
+ * @path /cfg/grpc/services/{id}/
+ */
+export async function getGrpcServicesRetrieve(  id: string, pk: string,  client?: any
+): Promise<ServiceDetail> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_services.retrieve(id, pk)
+  return ServiceDetailSchema.parse(response)
+}
+
+
+/**
+ * Get service methods
+ *
+ * @method GET
+ * @path /cfg/grpc/services/{id}/methods/
+ */
+export async function getGrpcServicesMethodsRetrieve(  id: string, pk: string,  client?: any
+): Promise<ServiceMethods> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_services.methodsRetrieve(id, pk)
+  return ServiceMethodsSchema.parse(response)
+}
+
+

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

@@ -0,0 +1,79 @@
+/**
+ * Typed fetchers for Grpc Testing
+ *
+ * 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 { GRPCCallRequestRequestSchema, type GRPCCallRequestRequest } from '../schemas/GRPCCallRequestRequest.schema'
+import { GRPCCallResponseSchema, type GRPCCallResponse } from '../schemas/GRPCCallResponse.schema'
+import { GRPCExamplesListSchema, type GRPCExamplesList } from '../schemas/GRPCExamplesList.schema'
+import { GRPCTestLogsSchema, type GRPCTestLogs } from '../schemas/GRPCTestLogs.schema'
+import { getAPIInstance } from '../../api-instance'
+
+/**
+ * Call gRPC method (placeholder)
+ *
+ * @method POST
+ * @path /cfg/grpc/test/call/
+ */
+export async function createGrpcTestCallCreate(  data: GRPCCallRequestRequest,  client?: any
+): Promise<GRPCCallResponse> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_testing.grpcTestCallCreate(data)
+  return GRPCCallResponseSchema.parse(response)
+}
+
+
+/**
+ * Get example payloads
+ *
+ * @method GET
+ * @path /cfg/grpc/test/examples/
+ */
+export async function getGrpcTestExamplesRetrieve(  params?: { method?: string; service?: string },  client?: any
+): Promise<GRPCExamplesList> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_testing.grpcTestExamplesRetrieve(params?.method, params?.service)
+  return GRPCExamplesListSchema.parse(response)
+}
+
+
+/**
+ * Get test logs
+ *
+ * @method GET
+ * @path /cfg/grpc/test/logs/
+ */
+export async function getGrpcTestLogsRetrieve(  params?: { limit?: number; method?: string; offset?: number; service?: string; status?: string },  client?: any
+): Promise<GRPCTestLogs> {
+  const api = client || getAPIInstance()
+  const response = await api.cfg_grpc_testing.grpcTestLogsRetrieve(params?.limit, params?.method, params?.offset, params?.service, params?.status)
+  return GRPCTestLogsSchema.parse(response)
+}
+
+

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

@@ -36,11 +36,15 @@ export * from './cfg__dashboard__dashboard_activity'
 export * from './cfg__dashboard__dashboard_api_zones'
 export * from './cfg__dashboard__dashboard_charts'
 export * from './cfg__dashboard__dashboard_commands'
+export * from './cfg__dashboard__dashboard_config'
 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_configuration'
 export * from './cfg__grpc__grpc_monitoring'
+export * from './cfg__grpc__grpc_services'
+export * from './cfg__grpc__grpc_testing'
 export * from './cfg__health'
 export * from './cfg__knowbase'
 export * from './cfg__leads'

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

@@ -0,0 +1,36 @@
+/**
+ * SWR Hooks for Dashboard - Config
+ *
+ * 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__dashboard_config'
+import type { API } from '../../index'
+import type { ConfigData } from '../schemas/ConfigData.schema'
+
+/**
+ * Get configuration data
+ *
+ * @method GET
+ * @path /cfg/dashboard/api/config/config/
+ */
+export function useDashboardApiConfigConfigRetrieve(client?: API): ReturnType<typeof useSWR<ConfigData>> {
+  return useSWR<ConfigData>(
+    'cfg-dashboard-api-config-config',
+    () => Fetchers.getDashboardApiConfigConfigRetrieve(client)
+  )
+}
+
+

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

@@ -0,0 +1,51 @@
+/**
+ * SWR Hooks for Grpc Configuration
+ *
+ * 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_configuration'
+import type { API } from '../../index'
+import type { GRPCConfig } from '../schemas/GRPCConfig.schema'
+import type { GRPCServerInfo } from '../schemas/GRPCServerInfo.schema'
+
+/**
+ * Get gRPC configuration
+ *
+ * @method GET
+ * @path /cfg/grpc/config/config/
+ */
+export function useGrpcConfigConfigRetrieve(client?: API): ReturnType<typeof useSWR<GRPCConfig>> {
+  return useSWR<GRPCConfig>(
+    'cfg-grpc-config-config',
+    () => Fetchers.getGrpcConfigConfigRetrieve(client)
+  )
+}
+
+
+/**
+ * Get server information
+ *
+ * @method GET
+ * @path /cfg/grpc/config/server-info/
+ */
+export function useGrpcConfigServerInfoRetrieve(client?: API): ReturnType<typeof useSWR<GRPCServerInfo>> {
+  return useSWR<GRPCServerInfo>(
+    'cfg-grpc-config-server-info',
+    () => Fetchers.getGrpcConfigServerInfoRetrieve(client)
+  )
+}
+
+

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

@@ -0,0 +1,65 @@
+/**
+ * SWR Hooks for Grpc Services
+ *
+ * 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_services'
+import type { API } from '../../index'
+import type { ServiceDetail } from '../schemas/ServiceDetail.schema'
+import type { ServiceMethods } from '../schemas/ServiceMethods.schema'
+
+/**
+ * List all services
+ *
+ * @method GET
+ * @path /cfg/grpc/services/
+ */
+export function useGrpcServicesList(params?: { hours?: number }, client?: API): ReturnType<typeof useSWR<any>> {
+  return useSWR<any>(
+    params ? ['cfg-grpc-services', params] : 'cfg-grpc-services',
+    () => Fetchers.getGrpcServicesList(params, client)
+  )
+}
+
+
+/**
+ * Get service details
+ *
+ * @method GET
+ * @path /cfg/grpc/services/{id}/
+ */
+export function useGrpcServicesRetrieve(id: string, pk: string, client?: API): ReturnType<typeof useSWR<ServiceDetail>> {
+  return useSWR<ServiceDetail>(
+    ['cfg-grpc-service', id],
+    () => Fetchers.getGrpcServicesRetrieve(id, pk, client)
+  )
+}
+
+
+/**
+ * Get service methods
+ *
+ * @method GET
+ * @path /cfg/grpc/services/{id}/methods/
+ */
+export function useGrpcServicesMethodsRetrieve(id: string, pk: string, client?: API): ReturnType<typeof useSWR<ServiceMethods>> {
+  return useSWR<ServiceMethods>(
+    ['cfg-grpc-services-method', id],
+    () => Fetchers.getGrpcServicesMethodsRetrieve(id, pk, client)
+  )
+}
+
+

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

@@ -0,0 +1,71 @@
+/**
+ * SWR Hooks for Grpc Testing
+ *
+ * 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_testing'
+import type { API } from '../../index'
+import type { GRPCCallRequestRequest } from '../schemas/GRPCCallRequestRequest.schema'
+import type { GRPCCallResponse } from '../schemas/GRPCCallResponse.schema'
+import type { GRPCExamplesList } from '../schemas/GRPCExamplesList.schema'
+import type { GRPCTestLogs } from '../schemas/GRPCTestLogs.schema'
+
+/**
+ * Call gRPC method (placeholder)
+ *
+ * @method POST
+ * @path /cfg/grpc/test/call/
+ */
+export function useCreateGrpcTestCallCreate() {
+  const { mutate } = useSWRConfig()
+
+  return async (data: GRPCCallRequestRequest, client?: API): Promise<GRPCCallResponse> => {
+    const result = await Fetchers.createGrpcTestCallCreate(data, client)
+    // Revalidate related queries
+    mutate('cfg-grpc-test-call')
+    return result
+  }
+}
+
+
+/**
+ * Get example payloads
+ *
+ * @method GET
+ * @path /cfg/grpc/test/examples/
+ */
+export function useGrpcTestExamplesRetrieve(params?: { method?: string; service?: string }, client?: API): ReturnType<typeof useSWR<GRPCExamplesList>> {
+  return useSWR<GRPCExamplesList>(
+    params ? ['cfg-grpc-test-example', params] : 'cfg-grpc-test-example',
+    () => Fetchers.getGrpcTestExamplesRetrieve(params, client)
+  )
+}
+
+
+/**
+ * Get test logs
+ *
+ * @method GET
+ * @path /cfg/grpc/test/logs/
+ */
+export function useGrpcTestLogsRetrieve(params?: { limit?: number; method?: string; offset?: number; service?: string; status?: string }, client?: API): ReturnType<typeof useSWR<GRPCTestLogs>> {
+  return useSWR<GRPCTestLogs>(
+    params ? ['cfg-grpc-test-log', params] : 'cfg-grpc-test-log',
+    () => Fetchers.getGrpcTestLogsRetrieve(params, client)
+  )
+}
+
+

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

@@ -33,6 +33,7 @@ export * from './cfg__dashboard__dashboard_api_zones'
 export * from './cfg__dashboard__dashboard_activity'
 export * from './cfg__dashboard__dashboard_charts'
 export * from './cfg__dashboard__dashboard_commands'
+export * from './cfg__dashboard__dashboard_config'
 export * from './cfg__dashboard__dashboard_overview'
 export * from './cfg__dashboard__dashboard_statistics'
 export * from './cfg__dashboard__dashboard_system'
@@ -52,7 +53,10 @@ export * from './cfg__accounts__user_profile'
 export * from './cfg__accounts'
 export * from './cfg__centrifugo'
 export * from './cfg__endpoints'
+export * from './cfg__grpc__grpc_configuration'
 export * from './cfg__grpc__grpc_monitoring'
+export * from './cfg__grpc__grpc_services'
+export * from './cfg__grpc__grpc_testing'
 export * from './cfg__health'
 export * from './cfg__knowbase'
 export * from './cfg__leads'

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

@@ -0,0 +1,23 @@
+/**
+ * Zod schema for CentrifugoConfig
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Centrifugo configuration.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Centrifugo configuration.
+ */
+export const CentrifugoConfigSchema = z.object({
+  enabled: z.boolean().nullable().optional(),
+  api_url: z.string().nullable().optional(),
+  api_key: z.string().nullable().optional(),
+  token_hmac_secret_key: z.string().nullable().optional(),
+  timeout: z.int().nullable().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type CentrifugoConfig = z.infer<typeof CentrifugoConfigSchema>

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

@@ -0,0 +1,27 @@
+/**
+ * Zod schema for ConfigData
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Serializer for complete config data endpoint.
+
+Returns both DjangoConfig and Django settings with validation info.
+ *  */
+import { z } from 'zod'
+import { ConfigValidationSchema } from './ConfigValidation.schema'
+import { DjangoConfigSchema } from './DjangoConfig.schema'
+
+/**
+ * Serializer for complete config data endpoint.
+
+Returns both DjangoConfig and Django settings with validation info.
+ */
+export const ConfigDataSchema = z.object({
+  django_config: DjangoConfigSchema,
+  django_settings: z.record(z.string(), z.any()),
+  _validation: ConfigValidationSchema,
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type ConfigData = z.infer<typeof ConfigDataSchema>

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

@@ -0,0 +1,20 @@
+/**
+ * Zod schema for ConfigMeta
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Config metadata.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Config metadata.
+ */
+export const ConfigMetaSchema = z.object({
+  config_class: z.string(),
+  secret_key_configured: z.boolean(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type ConfigMeta = z.infer<typeof ConfigMetaSchema>

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

@@ -0,0 +1,24 @@
+/**
+ * Zod schema for ConfigValidation
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Validation result for config serializer.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Validation result for config serializer.
+ */
+export const ConfigValidationSchema = z.object({
+  status: z.string(),
+  missing_in_serializer: z.array(z.string()),
+  extra_in_serializer: z.array(z.string()),
+  type_mismatches: z.array(z.record(z.string(), z.any())),
+  total_config_fields: z.int(),
+  total_serializer_fields: z.int(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type ConfigValidation = z.infer<typeof ConfigValidationSchema>

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

@@ -0,0 +1,20 @@
+/**
+ * Zod schema for DRFConfig
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Django REST Framework configuration.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Django REST Framework configuration.
+ */
+export const DRFConfigSchema = z.object({
+  default_pagination_class: z.string().nullable().optional(),
+  page_size: z.int().nullable().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type DRFConfig = z.infer<typeof DRFConfigSchema>