@djangocfg/api 2.1.36 → 2.1.38

package/src/generated/cfg_webpush/validation-events.ts

@@ -0,0 +1,141 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * This file is automatically generated by DjangoCFG.
+ * Any manual changes will be lost when the code is regenerated.
+ *
+ * @see https://djangocfg.com/docs/features/modules/django-client/overview/
+ */
+/**
+ * Zod Validation Events - Browser CustomEvent integration
+ *
+ * Dispatches browser CustomEvents when Zod validation fails, allowing
+ * React/frontend apps to listen and handle validation errors globally.
+ *
+ * @example
+ * ```typescript
+ * // In your React app
+ * window.addEventListener('zod-validation-error', (event) => {
+ *   const { operation, path, method, error, response } = event.detail;
+ *   console.error(`Validation failed for ${method} ${path}`, error);
+ *   // Show toast notification, log to Sentry, etc.
+ * });
+ * ```
+ */
+
+import type { ZodError } from 'zod'
+
+/**
+ * Validation error event detail
+ */
+export interface ValidationErrorDetail {
+  /** Operation/function name that failed validation */
+  operation: string
+  /** API endpoint path */
+  path: string
+  /** HTTP method */
+  method: string
+  /** Zod validation error */
+  error: ZodError
+  /** Raw response data that failed validation */
+  response: any
+  /** Timestamp of the error */
+  timestamp: Date
+}
+
+/**
+ * Custom event type for Zod validation errors
+ */
+export type ValidationErrorEvent = CustomEvent<ValidationErrorDetail>
+
+/**
+ * Dispatch a Zod validation error event.
+ *
+ * Only dispatches in browser environment (when window is defined).
+ * Safe to call in Node.js/SSR - will be a no-op.
+ *
+ * @param detail - Validation error details
+ */
+export function dispatchValidationError(detail: ValidationErrorDetail): void {
+  // Check if running in browser
+  if (typeof window === 'undefined') {
+    return
+  }
+
+  try {
+    const event = new CustomEvent<ValidationErrorDetail>('zod-validation-error', {
+      detail,
+      bubbles: true,
+      cancelable: false,
+    })
+
+    window.dispatchEvent(event)
+  } catch (error) {
+    // Silently fail - validation event dispatch should never crash the app
+    console.warn('Failed to dispatch validation error event:', error)
+  }
+}
+
+/**
+ * Add a global listener for Zod validation errors.
+ *
+ * @param callback - Function to call when validation error occurs
+ * @returns Cleanup function to remove the listener
+ *
+ * @example
+ * ```typescript
+ * const cleanup = onValidationError(({ operation, error }) => {
+ *   toast.error(`Validation failed in ${operation}`);
+ *   logToSentry(error);
+ * });
+ *
+ * // Later, remove listener
+ * cleanup();
+ * ```
+ */
+export function onValidationError(
+  callback: (detail: ValidationErrorDetail) => void
+): () => void {
+  if (typeof window === 'undefined') {
+    // Return no-op cleanup function for SSR
+    return () => {}
+  }
+
+  const handler = (event: Event) => {
+    if (event instanceof CustomEvent) {
+      callback(event.detail)
+    }
+  }
+
+  window.addEventListener('zod-validation-error', handler)
+
+  // Return cleanup function
+  return () => {
+    window.removeEventListener('zod-validation-error', handler)
+  }
+}
+
+/**
+ * Format Zod error for logging/display.
+ *
+ * @param error - Zod validation error
+ * @returns Formatted error message
+ */
+export function formatZodError(error: ZodError): string {
+  const issues = error.issues.map((issue, index) => {
+    const path = issue.path.join('.') || 'root'
+    const parts = [`${index + 1}. ${path}: ${issue.message}`]
+
+    if ('expected' in issue && issue.expected) {
+      parts.push(`   Expected: ${issue.expected}`)
+    }
+
+    if ('received' in issue && issue.received) {
+      parts.push(`   Received: ${issue.received}`)
+    }
+
+    return parts.join('\n')
+  })
+
+  return issues.join('\n')
+}

package/src/generated/cfg_webpush/webpush__web_push/client.ts

@@ -0,0 +1,45 @@
+import * as Models from "./models";
+
+
+/**
+ * API endpoints for Web Push.
+ */
+export class WebPush {
+  private client: any;
+
+  constructor(client: any) {
+    this.client = client;
+  }
+
+  /**
+   * Send push notification
+   * 
+   * Send push notification to all active subscriptions for the authenticated
+   * user.
+   */
+  async webpushSendCreate(data: Models.SendPushRequestRequest): Promise<Models.SendPushResponse> {
+    const response = await this.client.request('POST', "/cfg/webpush/send/", { body: data });
+    return response;
+  }
+
+  /**
+   * Subscribe to push notifications
+   * 
+   * Save push subscription from browser for the authenticated user.
+   */
+  async webpushSubscribeCreate(data: Models.SubscribeRequestRequest): Promise<Models.SubscribeResponse> {
+    const response = await this.client.request('POST', "/cfg/webpush/subscribe/", { body: data });
+    return response;
+  }
+
+  /**
+   * Get VAPID public key
+   * 
+   * Get VAPID public key for client subscription.
+   */
+  async webpushVapidRetrieve(): Promise<Models.VapidPublicKeyResponse> {
+    const response = await this.client.request('GET', "/cfg/webpush/vapid/");
+    return response;
+  }
+
+}

package/src/generated/cfg_webpush/webpush__web_push/index.ts

@@ -0,0 +1,10 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * This file is automatically generated by DjangoCFG.
+ * Any manual changes will be lost when the code is regenerated.
+ *
+ * @see https://djangocfg.com/docs/features/modules/django-client/overview/
+ */
+export * from "./client";
+export * as Models from "./models";

package/src/generated/cfg_webpush/webpush__web_push/models.ts

@@ -0,0 +1,72 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * This file is automatically generated by DjangoCFG.
+ * Any manual changes will be lost when the code is regenerated.
+ *
+ * @see https://djangocfg.com/docs/features/modules/django-client/overview/
+ */
+/**
+ * Request serializer for sending push notifications.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface SendPushRequestRequest {
+  /** Notification title */
+  title: string;
+  /** Notification body */
+  body: string;
+  /** Notification icon URL */
+  icon?: string | null;
+  /** URL to open on click */
+  url?: string | null;
+}
+
+/**
+ * Response serializer for send push endpoint.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface SendPushResponse {
+  /** Whether send was successful */
+  success: boolean;
+  /** Number of devices notification was sent to */
+  sent_to: number;
+}
+
+/**
+ * Request serializer for subscribing to push notifications.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface SubscribeRequestRequest {
+  /** Push service endpoint URL from browser */
+  endpoint: string;
+  /** Encryption keys (p256dh and auth) */
+  keys: Record<string, any>;
+}
+
+/**
+ * Response serializer for subscription endpoint.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface SubscribeResponse {
+  /** Whether subscription was successful */
+  success: boolean;
+  /** ID of the subscription */
+  subscription_id: number;
+  /** Whether subscription was newly created */
+  created: boolean;
+}
+
+/**
+ * Response serializer for VAPID public key endpoint.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface VapidPublicKeyResponse {
+  /** VAPID public key for client subscription */
+  publicKey: string;
+}
+

package/src/hooks/accounts.ts

@@ -0,0 +1,8 @@
+/**
+ * @djangocfg/api - Accounts hooks
+ *
+ * Authentication, OAuth, and user profile management hooks.
+ */
+'use client';
+
+export * from '../generated/cfg_accounts/_utils/hooks';

package/src/hooks/index.ts

@@ -0,0 +1,10 @@
+/**
+ * @djangocfg/api hooks
+ *
+ * Re-exports SWR hooks from generated API clients.
+ * Provides type-safe React hooks for data fetching.
+ */
+'use client';
+
+// Export all hooks from cfg_accounts (includes all django-cfg apps)
+export * from './accounts';

package/src/hooks/webpush.ts

@@ -0,0 +1,12 @@
+/**
+ * @djangocfg/api - Web Push hooks
+ *
+ * Push notifications subscription and management hooks.
+ * Note: cfg_webpush contains the same hooks as cfg_accounts.
+ * Keep this file for future webpush-specific hooks.
+ */
+'use client';
+
+// Currently cfg_webpush doesn't have webpush-specific endpoints
+// All hooks are re-exported from accounts.ts to avoid duplicates
+// export * from '../generated/cfg_webpush/_utils/hooks';

package/src/index.ts

@@ -20,6 +20,17 @@ export { Schemas, Fetchers, Enums } from './generated/cfg_accounts';
 // ============================================================================
 export * as CfgAccountsTypes from './generated/cfg_accounts';
 
+// ============================================================================
+// Centrifugo Fetchers (for WebSocket token refresh)
+// ============================================================================
+export { getCentrifugoAuthTokenRetrieve } from './generated/cfg_centrifugo';
+
+// ============================================================================
+// WebPush API (for push notifications)
+// ============================================================================
+export { API as WebPushAPI } from './generated/cfg_webpush';
+export * as WebPushTypes from './generated/cfg_webpush';
+
 /**
  * Base Client for all API services
  *

package/src/server.ts

@@ -17,17 +17,14 @@
  */
 
 // Export API class and storage adapters
-export { API, MemoryStorageAdapter } from './cfg/cfg_dashboard';
-
-// Export api instance from BaseClient
-export { api } from './BaseClient';
+export { API, MemoryStorageAdapter } from './generated/cfg_accounts';
 
 // Export only fetchers (no hooks, no React dependencies)
-export * as Fetchers from './cfg/cfg_dashboard/_utils/fetchers';
+export * as Fetchers from './generated/cfg_accounts/_utils/fetchers';
 
 // Export types and schemas (server-safe)
-export * as Schemas from './cfg/cfg_dashboard/_utils/schemas';
-export * as Enums from './cfg/cfg_dashboard/enums';
+export * as Schemas from './generated/cfg_accounts/_utils/schemas';
+export * as Enums from './generated/cfg_accounts/enums';
 
 // Re-export types
-export type { API as APIType } from './cfg/cfg_dashboard';
+export type { API as APIType } from './generated/cfg_accounts';

package/src/generated/cfg_accounts/_utils/fetchers/cfg_accounts__dashboard__dashboard_activity.ts

@@ -1,62 +0,0 @@
-/**
- * Typed fetchers for Dashboard - Activity
- *
- * 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 { consola } from 'consola'
-import { getAPIInstance } from '../../api-instance'
-
-/**
- * Get quick actions
- *
- * @method GET
- * @path /cfg/dashboard/api/activity/actions/
- */
-export async function getDashboardApiActivityActionsList(  client?: any
-): Promise<any> {
-  const api = client || getAPIInstance()
-  const response = await api.cfg_accounts_dashboard_activity.dashboardApiActivityActionsList()
-  return response
-}
-
-
-/**
- * Get recent activity
- *
- * @method GET
- * @path /cfg/dashboard/api/activity/recent/
- */
-export async function getDashboardApiActivityRecentList(  params?: { limit?: number },  client?: any
-): Promise<any> {
-  const api = client || getAPIInstance()
-  const response = await api.cfg_accounts_dashboard_activity.dashboardApiActivityRecentList(params?.limit)
-  return response
-}
-
-

package/src/generated/cfg_accounts/_utils/fetchers/cfg_accounts__dashboard__dashboard_api_zones.ts

@@ -1,106 +0,0 @@
-/**
- * Typed fetchers for Dashboard - API Zones
- *
- * 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 { consola } from 'consola'
-import { APIZonesSummarySchema, type APIZonesSummary } from '../schemas/APIZonesSummary.schema'
-import { getAPIInstance } from '../../api-instance'
-
-/**
- * Get all API zones
- *
- * @method GET
- * @path /cfg/dashboard/api/zones/
- */
-export async function getDashboardApiZonesList(  client?: any
-): Promise<any> {
-  const api = client || getAPIInstance()
-  const response = await api.cfg_accounts_dashboard_api_zones.list()
-  return response
-}
-
-
-/**
- * Get zones summary
- *
- * @method GET
- * @path /cfg/dashboard/api/zones/summary/
- */
-export async function getDashboardApiZonesSummaryRetrieve(  client?: any
-): Promise<APIZonesSummary> {
-  const api = client || getAPIInstance()
-  const response = await api.cfg_accounts_dashboard_api_zones.summaryRetrieve()
-  try {
-    return APIZonesSummarySchema.parse(response)
-  } catch (error) {
-    // Zod validation error - log detailed information
-    consola.error('❌ Zod Validation Failed');
-    consola.box(`getDashboardApiZonesSummaryRetrieve\nPath: /cfg/dashboard/api/zones/summary/\nMethod: GET`);
-
-    if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
-      consola.error('Validation Issues:');
-      (error as any).issues.forEach((issue: any, index: number) => {
-        consola.error(`  ${index + 1}. ${issue.path.join('.') || 'root'}`);
-        consola.error(`     ├─ Message: ${issue.message}`);
-        if (issue.expected) consola.error(`     ├─ Expected: ${issue.expected}`);
-        if (issue.received) consola.error(`     └─ Received: ${issue.received}`);
-      });
-    }
-
-    consola.error('Response data:', response);
-
-    // Dispatch browser CustomEvent (only if window is defined)
-    if (typeof window !== 'undefined' && error instanceof Error && 'issues' in error) {
-      try {
-        const event = new CustomEvent('zod-validation-error', {
-          detail: {
-            operation: 'getDashboardApiZonesSummaryRetrieve',
-            path: '/cfg/dashboard/api/zones/summary/',
-            method: 'GET',
-            error: error,
-            response: response,
-            timestamp: new Date(),
-          },
-          bubbles: true,
-          cancelable: false,
-        });
-        window.dispatchEvent(event);
-      } catch (eventError) {
-        // Silently fail - event dispatch should never crash the app
-        consola.warn('Failed to dispatch validation error event:', eventError);
-      }
-    }
-
-    // Re-throw the error
-    throw error;
-  }
-}
-
-

package/src/generated/cfg_accounts/_utils/fetchers/cfg_accounts__dashboard__dashboard_charts.ts

@@ -1,177 +0,0 @@
-/**
- * Typed fetchers for Dashboard - Charts
- *
- * 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 { consola } from 'consola'
-import { ChartDataSchema, type ChartData } from '../schemas/ChartData.schema'
-import { getAPIInstance } from '../../api-instance'
-
-/**
- * Get user activity chart
- *
- * @method GET
- * @path /cfg/dashboard/api/charts/activity/
- */
-export async function getDashboardApiChartsActivityRetrieve(  params?: { days?: number },  client?: any
-): Promise<ChartData> {
-  const api = client || getAPIInstance()
-  const response = await api.cfg_accounts_dashboard_charts.dashboardApiChartsActivityRetrieve(params?.days)
-  try {
-    return ChartDataSchema.parse(response)
-  } catch (error) {
-    // Zod validation error - log detailed information
-    consola.error('❌ Zod Validation Failed');
-    consola.box(`getDashboardApiChartsActivityRetrieve\nPath: /cfg/dashboard/api/charts/activity/\nMethod: GET`);
-
-    if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
-      consola.error('Validation Issues:');
-      (error as any).issues.forEach((issue: any, index: number) => {
-        consola.error(`  ${index + 1}. ${issue.path.join('.') || 'root'}`);
-        consola.error(`     ├─ Message: ${issue.message}`);
-        if (issue.expected) consola.error(`     ├─ Expected: ${issue.expected}`);
-        if (issue.received) consola.error(`     └─ Received: ${issue.received}`);
-      });
-    }
-
-    consola.error('Response data:', response);
-
-    // Dispatch browser CustomEvent (only if window is defined)
-    if (typeof window !== 'undefined' && error instanceof Error && 'issues' in error) {
-      try {
-        const event = new CustomEvent('zod-validation-error', {
-          detail: {
-            operation: 'getDashboardApiChartsActivityRetrieve',
-            path: '/cfg/dashboard/api/charts/activity/',
-            method: 'GET',
-            error: error,
-            response: response,
-            timestamp: new Date(),
-          },
-          bubbles: true,
-          cancelable: false,
-        });
-        window.dispatchEvent(event);
-      } catch (eventError) {
-        // Silently fail - event dispatch should never crash the app
-        consola.warn('Failed to dispatch validation error event:', eventError);
-      }
-    }
-
-    // Re-throw the error
-    throw error;
-  }
-}
-
-
-/**
- * Get recent users
- *
- * @method GET
- * @path /cfg/dashboard/api/charts/recent-users/
- */
-export async function getDashboardApiChartsRecentUsersList(  params?: { limit?: number },  client?: any
-): Promise<any> {
-  const api = client || getAPIInstance()
-  const response = await api.cfg_accounts_dashboard_charts.dashboardApiChartsRecentUsersList(params?.limit)
-  return response
-}
-
-
-/**
- * Get user registration chart
- *
- * @method GET
- * @path /cfg/dashboard/api/charts/registrations/
- */
-export async function getDashboardApiChartsRegistrationsRetrieve(  params?: { days?: number },  client?: any
-): Promise<ChartData> {
-  const api = client || getAPIInstance()
-  const response = await api.cfg_accounts_dashboard_charts.dashboardApiChartsRegistrationsRetrieve(params?.days)
-  try {
-    return ChartDataSchema.parse(response)
-  } catch (error) {
-    // Zod validation error - log detailed information
-    consola.error('❌ Zod Validation Failed');
-    consola.box(`getDashboardApiChartsRegistrationsRetrieve\nPath: /cfg/dashboard/api/charts/registrations/\nMethod: GET`);
-
-    if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
-      consola.error('Validation Issues:');
-      (error as any).issues.forEach((issue: any, index: number) => {
-        consola.error(`  ${index + 1}. ${issue.path.join('.') || 'root'}`);
-        consola.error(`     ├─ Message: ${issue.message}`);
-        if (issue.expected) consola.error(`     ├─ Expected: ${issue.expected}`);
-        if (issue.received) consola.error(`     └─ Received: ${issue.received}`);
-      });
-    }
-
-    consola.error('Response data:', response);
-
-    // Dispatch browser CustomEvent (only if window is defined)
-    if (typeof window !== 'undefined' && error instanceof Error && 'issues' in error) {
-      try {
-        const event = new CustomEvent('zod-validation-error', {
-          detail: {
-            operation: 'getDashboardApiChartsRegistrationsRetrieve',
-            path: '/cfg/dashboard/api/charts/registrations/',
-            method: 'GET',
-            error: error,
-            response: response,
-            timestamp: new Date(),
-          },
-          bubbles: true,
-          cancelable: false,
-        });
-        window.dispatchEvent(event);
-      } catch (eventError) {
-        // Silently fail - event dispatch should never crash the app
-        consola.warn('Failed to dispatch validation error event:', eventError);
-      }
-    }
-
-    // Re-throw the error
-    throw error;
-  }
-}
-
-
-/**
- * Get activity tracker
- *
- * @method GET
- * @path /cfg/dashboard/api/charts/tracker/
- */
-export async function getDashboardApiChartsTrackerList(  params?: { weeks?: number },  client?: any
-): Promise<any> {
-  const api = client || getAPIInstance()
-  const response = await api.cfg_accounts_dashboard_charts.dashboardApiChartsTrackerList(params?.weeks)
-  return response
-}
-
-