@djangocfg/api 2.1.36 → 2.1.37

package/src/generated/cfg_centrifugo/storage.ts

@@ -0,0 +1,169 @@
+/**
+ * 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/
+ */
+/**
+ * Storage adapters for cross-platform token storage.
+ *
+ * Supports:
+ * - LocalStorage (browser)
+ * - Cookies (SSR/browser)
+ * - Memory (Node.js/Electron/testing)
+ */
+
+import type { APILogger } from './logger';
+
+/**
+ * Storage adapter interface for cross-platform token storage.
+ */
+export interface StorageAdapter {
+  getItem(key: string): string | null;
+  setItem(key: string, value: string): void;
+  removeItem(key: string): void;
+}
+
+/**
+ * LocalStorage adapter with safe try-catch for browser environments.
+ * Works in modern browsers with localStorage support.
+ * 
+ * Note: This adapter uses window.localStorage and should only be used in browser/client environments.
+ * For server-side usage, use MemoryStorageAdapter or CookieStorageAdapter instead.
+ */
+export class LocalStorageAdapter implements StorageAdapter {
+  private logger?: APILogger;
+
+  constructor(logger?: APILogger) {
+    this.logger = logger;
+  }
+
+  getItem(key: string): string | null {
+    try {
+      if (typeof window !== 'undefined' && window.localStorage) {
+        const value = localStorage.getItem(key);
+        this.logger?.debug(`LocalStorage.getItem("${key}"): ${value ? 'found' : 'not found'}`);
+        return value;
+      }
+      this.logger?.warn('LocalStorage not available: window.localStorage is undefined');
+    } catch (error) {
+      this.logger?.error('LocalStorage.getItem failed:', error);
+    }
+    return null;
+  }
+
+  setItem(key: string, value: string): void {
+    try {
+      if (typeof window !== 'undefined' && window.localStorage) {
+        localStorage.setItem(key, value);
+        this.logger?.debug(`LocalStorage.setItem("${key}"): success`);
+      } else {
+        this.logger?.warn('LocalStorage not available: window.localStorage is undefined');
+      }
+    } catch (error) {
+      this.logger?.error('LocalStorage.setItem failed:', error);
+    }
+  }
+
+  removeItem(key: string): void {
+    try {
+      if (typeof window !== 'undefined' && window.localStorage) {
+        localStorage.removeItem(key);
+        this.logger?.debug(`LocalStorage.removeItem("${key}"): success`);
+      } else {
+        this.logger?.warn('LocalStorage not available: window.localStorage is undefined');
+      }
+    } catch (error) {
+      this.logger?.error('LocalStorage.removeItem failed:', error);
+    }
+  }
+}
+
+/**
+ * Cookie-based storage adapter for SSR and browser environments.
+ * Useful for Next.js, Nuxt.js, and other SSR frameworks.
+ */
+export class CookieStorageAdapter implements StorageAdapter {
+  private logger?: APILogger;
+
+  constructor(logger?: APILogger) {
+    this.logger = logger;
+  }
+
+  getItem(key: string): string | null {
+    try {
+      if (typeof document === 'undefined') {
+        this.logger?.warn('Cookies not available: document is undefined (SSR context?)');
+        return null;
+      }
+      const value = `; ${document.cookie}`;
+      const parts = value.split(`; ${key}=`);
+      if (parts.length === 2) {
+        const result = parts.pop()?.split(';').shift() || null;
+        this.logger?.debug(`CookieStorage.getItem("${key}"): ${result ? 'found' : 'not found'}`);
+        return result;
+      }
+      this.logger?.debug(`CookieStorage.getItem("${key}"): not found`);
+    } catch (error) {
+      this.logger?.error('CookieStorage.getItem failed:', error);
+    }
+    return null;
+  }
+
+  setItem(key: string, value: string): void {
+    try {
+      if (typeof document !== 'undefined') {
+        document.cookie = `${key}=${value}; path=/; max-age=31536000`;
+        this.logger?.debug(`CookieStorage.setItem("${key}"): success`);
+      } else {
+        this.logger?.warn('Cookies not available: document is undefined (SSR context?)');
+      }
+    } catch (error) {
+      this.logger?.error('CookieStorage.setItem failed:', error);
+    }
+  }
+
+  removeItem(key: string): void {
+    try {
+      if (typeof document !== 'undefined') {
+        document.cookie = `${key}=; path=/; expires=Thu, 01 Jan 1970 00:00:00 GMT`;
+        this.logger?.debug(`CookieStorage.removeItem("${key}"): success`);
+      } else {
+        this.logger?.warn('Cookies not available: document is undefined (SSR context?)');
+      }
+    } catch (error) {
+      this.logger?.error('CookieStorage.removeItem failed:', error);
+    }
+  }
+}
+
+/**
+ * In-memory storage adapter for Node.js, Electron, and testing environments.
+ * Data is stored in RAM and cleared when process exits.
+ */
+export class MemoryStorageAdapter implements StorageAdapter {
+  private storage: Map<string, string> = new Map();
+  private logger?: APILogger;
+
+  constructor(logger?: APILogger) {
+    this.logger = logger;
+  }
+
+  getItem(key: string): string | null {
+    const value = this.storage.get(key) || null;
+    this.logger?.debug(`MemoryStorage.getItem("${key}"): ${value ? 'found' : 'not found'}`);
+    return value;
+  }
+
+  setItem(key: string, value: string): void {
+    this.storage.set(key, value);
+    this.logger?.debug(`MemoryStorage.setItem("${key}"): success`);
+  }
+
+  removeItem(key: string): void {
+    this.storage.delete(key);
+    this.logger?.debug(`MemoryStorage.removeItem("${key}"): success`);
+  }
+}

package/src/generated/cfg_centrifugo/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/_utils/fetchers/index.ts

@@ -0,0 +1,36 @@
+/**
+ * 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/
+ */
+/**
+ * Typed Fetchers - Universal API functions
+ *
+ * Auto-generated from OpenAPI specification.
+ * These functions work in any JavaScript environment.
+ *
+ * Features:
+ * - Runtime validation with Zod
+ * - Type-safe parameters and responses
+ * - Works with any data-fetching library (SWR, React Query, etc)
+ * - Server Component compatible
+ *
+ * Usage:
+ * ```typescript
+ * import * as fetchers from './fetchers'
+ *
+ * // Direct usage
+ * const user = await fetchers.getUser(1)
+ *
+ * // With SWR
+ * const { data } = useSWR('user-1', () => fetchers.getUser(1))
+ *
+ * // With React Query
+ * const { data } = useQuery(['user', 1], () => fetchers.getUser(1))
+ * ```
+ */
+
+export * from './webpush__web_push'

package/src/generated/{cfg_accounts/_utils/fetchers/cfg_accounts__grpc__grpc_api_keys.ts → cfg_webpush/_utils/fetchers/webpush__web_push.ts}

@@ -1,5 +1,13 @@
 /**
- * Typed fetchers for Grpc Api Keys
+ * 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/
+ */
+/**
+ * Typed fetchers for Web Push
  *
  * Universal functions that work in any environment:
  * - Next.js (App Router / Pages Router / Server Components)
@@ -30,27 +38,29 @@
  * ```
  */
 import { consola } from 'consola'
-import { ApiKeySchema, type ApiKey } from '../schemas/ApiKey.schema'
-import { ApiKeyStatsSchema, type ApiKeyStats } from '../schemas/ApiKeyStats.schema'
-import { PaginatedApiKeyListSchema, type PaginatedApiKeyList } from '../schemas/PaginatedApiKeyList.schema'
+import { SendPushRequestRequestSchema, type SendPushRequestRequest } from '../schemas/SendPushRequestRequest.schema'
+import { SendPushResponseSchema, type SendPushResponse } from '../schemas/SendPushResponse.schema'
+import { SubscribeRequestRequestSchema, type SubscribeRequestRequest } from '../schemas/SubscribeRequestRequest.schema'
+import { SubscribeResponseSchema, type SubscribeResponse } from '../schemas/SubscribeResponse.schema'
+import { VapidPublicKeyResponseSchema, type VapidPublicKeyResponse } from '../schemas/VapidPublicKeyResponse.schema'
 import { getAPIInstance } from '../../api-instance'
 
 /**
- * List API keys
+ * Send push notification
  *
- * @method GET
- * @path /cfg/grpc/api-keys/
+ * @method POST
+ * @path /cfg/webpush/send/
  */
-export async function getGrpcApiKeysList(  params?: { is_active?: boolean; page?: number; page_size?: number; user_id?: number },  client?: any
-): Promise<PaginatedApiKeyList> {
+export async function createWebpushSendCreate(  data: SendPushRequestRequest,  client?: any
+): Promise<SendPushResponse> {
   const api = client || getAPIInstance()
-  const response = await api.cfg_accounts_grpc_api_keys.list(params?.is_active, params?.page, params?.page_size, params?.user_id)
+  const response = await api.web_push.webpushSendCreate(data)
   try {
-    return PaginatedApiKeyListSchema.parse(response)
+    return SendPushResponseSchema.parse(response)
   } catch (error) {
     // Zod validation error - log detailed information
     consola.error('❌ Zod Validation Failed');
-    consola.box(`getGrpcApiKeysList\nPath: /cfg/grpc/api-keys/\nMethod: GET`);
+    consola.box(`createWebpushSendCreate\nPath: /cfg/webpush/send/\nMethod: POST`);
 
     if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
       consola.error('Validation Issues:');
@@ -69,9 +79,9 @@ export async function getGrpcApiKeysList(  params?: { is_active?: boolean; page?
       try {
         const event = new CustomEvent('zod-validation-error', {
           detail: {
-            operation: 'getGrpcApiKeysList',
-            path: '/cfg/grpc/api-keys/',
-            method: 'GET',
+            operation: 'createWebpushSendCreate',
+            path: '/cfg/webpush/send/',
+            method: 'POST',
             error: error,
             response: response,
             timestamp: new Date(),
@@ -93,21 +103,21 @@ export async function getGrpcApiKeysList(  params?: { is_active?: boolean; page?
 
 
 /**
- * Get API key details
+ * Subscribe to push notifications
  *
- * @method GET
- * @path /cfg/grpc/api-keys/{id}/
+ * @method POST
+ * @path /cfg/webpush/subscribe/
  */
-export async function getGrpcApiKeysRetrieve(  id: number,  client?: any
-): Promise<ApiKey> {
+export async function createWebpushSubscribeCreate(  data: SubscribeRequestRequest,  client?: any
+): Promise<SubscribeResponse> {
   const api = client || getAPIInstance()
-  const response = await api.cfg_accounts_grpc_api_keys.retrieve(id)
+  const response = await api.web_push.webpushSubscribeCreate(data)
   try {
-    return ApiKeySchema.parse(response)
+    return SubscribeResponseSchema.parse(response)
   } catch (error) {
     // Zod validation error - log detailed information
     consola.error('❌ Zod Validation Failed');
-    consola.box(`getGrpcApiKeysRetrieve\nPath: /cfg/grpc/api-keys/{id}/\nMethod: GET`);
+    consola.box(`createWebpushSubscribeCreate\nPath: /cfg/webpush/subscribe/\nMethod: POST`);
 
     if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
       consola.error('Validation Issues:');
@@ -126,9 +136,9 @@ export async function getGrpcApiKeysRetrieve(  id: number,  client?: any
       try {
         const event = new CustomEvent('zod-validation-error', {
           detail: {
-            operation: 'getGrpcApiKeysRetrieve',
-            path: '/cfg/grpc/api-keys/{id}/',
-            method: 'GET',
+            operation: 'createWebpushSubscribeCreate',
+            path: '/cfg/webpush/subscribe/',
+            method: 'POST',
             error: error,
             response: response,
             timestamp: new Date(),
@@ -150,21 +160,21 @@ export async function getGrpcApiKeysRetrieve(  id: number,  client?: any
 
 
 /**
- * Get API keys statistics
+ * Get VAPID public key
  *
  * @method GET
- * @path /cfg/grpc/api-keys/stats/
+ * @path /cfg/webpush/vapid/
  */
-export async function getGrpcApiKeysStatsRetrieve(  client?: any
-): Promise<ApiKeyStats> {
+export async function getWebpushVapidRetrieve(  client?: any
+): Promise<VapidPublicKeyResponse> {
   const api = client || getAPIInstance()
-  const response = await api.cfg_accounts_grpc_api_keys.statsRetrieve()
+  const response = await api.web_push.webpushVapidRetrieve()
   try {
-    return ApiKeyStatsSchema.parse(response)
+    return VapidPublicKeyResponseSchema.parse(response)
   } catch (error) {
     // Zod validation error - log detailed information
     consola.error('❌ Zod Validation Failed');
-    consola.box(`getGrpcApiKeysStatsRetrieve\nPath: /cfg/grpc/api-keys/stats/\nMethod: GET`);
+    consola.box(`getWebpushVapidRetrieve\nPath: /cfg/webpush/vapid/\nMethod: GET`);
 
     if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
       consola.error('Validation Issues:');
@@ -183,8 +193,8 @@ export async function getGrpcApiKeysStatsRetrieve(  client?: any
       try {
         const event = new CustomEvent('zod-validation-error', {
           detail: {
-            operation: 'getGrpcApiKeysStatsRetrieve',
-            path: '/cfg/grpc/api-keys/stats/',
+            operation: 'getWebpushVapidRetrieve',
+            path: '/cfg/webpush/vapid/',
             method: 'GET',
             error: error,
             response: response,

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

@@ -0,0 +1,36 @@
+/**
+ * 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/
+ */
+'use client';
+
+/**
+ * SWR Hooks - React data fetching hooks
+ *
+ * Auto-generated from OpenAPI specification.
+ * Powered by SWR for automatic caching and revalidation.
+ *
+ * Features:
+ * - Automatic caching and deduplication
+ * - Revalidation on focus/reconnect
+ * - Optimistic updates
+ * - Type-safe parameters and responses
+ *
+ * Usage:
+ * ```typescript
+ * import * as hooks from './hooks'
+ *
+ * // Query hooks (GET)
+ * const { data, error, isLoading } = hooks.useUsers({ page: 1 })
+ *
+ * // Mutation hooks (POST/PUT/PATCH/DELETE)
+ * const createUser = hooks.useCreateUser()
+ * await createUser({ name: 'John' })
+ * ```
+ */
+
+export * from './webpush__web_push'

package/src/generated/cfg_webpush/_utils/hooks/webpush__web_push.ts

@@ -0,0 +1,86 @@
+/**
+ * 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/
+ */
+'use client';
+
+/**
+ * SWR Hooks for Web Push
+ *
+ * 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/webpush__web_push'
+import type { API } from '../../index'
+import type { SendPushRequestRequest } from '../schemas/SendPushRequestRequest.schema'
+import type { SendPushResponse } from '../schemas/SendPushResponse.schema'
+import type { SubscribeRequestRequest } from '../schemas/SubscribeRequestRequest.schema'
+import type { SubscribeResponse } from '../schemas/SubscribeResponse.schema'
+import type { VapidPublicKeyResponse } from '../schemas/VapidPublicKeyResponse.schema'
+
+/**
+ * Send push notification
+ *
+ * @method POST
+ * @path /cfg/webpush/send/
+ */
+export function useCreateWebpushSendCreate() {
+  const { mutate } = useSWRConfig()
+
+  return async (data: SendPushRequestRequest, client?: API): Promise<SendPushResponse> => {
+    const result = await Fetchers.createWebpushSendCreate(data, client)
+    // Revalidate related queries
+    mutate('cfg-webpush-send')
+    return result
+  }
+}
+
+
+/**
+ * Subscribe to push notifications
+ *
+ * @method POST
+ * @path /cfg/webpush/subscribe/
+ */
+export function useCreateWebpushSubscribeCreate() {
+  const { mutate } = useSWRConfig()
+
+  return async (data: SubscribeRequestRequest, client?: API): Promise<SubscribeResponse> => {
+    const result = await Fetchers.createWebpushSubscribeCreate(data, client)
+    // Revalidate related queries
+    mutate('cfg-webpush-subscribe')
+    return result
+  }
+}
+
+
+/**
+ * Get VAPID public key
+ *
+ * @method GET
+ * @path /cfg/webpush/vapid/
+ */
+export function useWebpushVapidRetrieve(client?: API): ReturnType<typeof useSWR<VapidPublicKeyResponse>> {
+  return useSWR<VapidPublicKeyResponse>(
+    'cfg-webpush-vapid',
+    () => Fetchers.getWebpushVapidRetrieve(client)
+  )
+}
+
+

package/src/generated/cfg_webpush/_utils/schemas/SendPushRequestRequest.schema.ts

@@ -0,0 +1,22 @@
+/**
+ * Zod schema for SendPushRequestRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Request serializer for sending push notifications.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Request serializer for sending push notifications.
+ */
+export const SendPushRequestRequestSchema = z.object({
+  title: z.string().min(1).max(255),
+  body: z.string().min(1),
+  icon: z.url().nullable().optional(),
+  url: z.url().nullable().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type SendPushRequestRequest = z.infer<typeof SendPushRequestRequestSchema>

package/src/generated/cfg_webpush/_utils/schemas/SendPushResponse.schema.ts

@@ -0,0 +1,20 @@
+/**
+ * Zod schema for SendPushResponse
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Response serializer for send push endpoint.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Response serializer for send push endpoint.
+ */
+export const SendPushResponseSchema = z.object({
+  success: z.boolean(),
+  sent_to: z.int(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type SendPushResponse = z.infer<typeof SendPushResponseSchema>

package/src/generated/cfg_webpush/_utils/schemas/SubscribeRequestRequest.schema.ts

@@ -0,0 +1,20 @@
+/**
+ * Zod schema for SubscribeRequestRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Request serializer for subscribing to push notifications.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Request serializer for subscribing to push notifications.
+ */
+export const SubscribeRequestRequestSchema = z.object({
+  endpoint: z.url(),
+  keys: z.record(z.string(), z.string().min(1)),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type SubscribeRequestRequest = z.infer<typeof SubscribeRequestRequestSchema>