@djangocfg/api 2.1.139 → 2.1.143

package/src/generated/cfg_webpush/retry.ts

@@ -1,176 +0,0 @@
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Retry Configuration and Utilities
- *
- * Provides automatic retry logic for failed HTTP requests using p-retry.
- * Retries only on network errors and server errors (5xx), not client errors (4xx).
- */
-
-import pRetry, { AbortError } from 'p-retry';
-import { APIError, NetworkError } from './errors';
-
-/**
- * Information about a failed retry attempt.
- */
-export interface FailedAttemptInfo {
-  /** The error that caused the failure */
-  error: Error;
-  /** The attempt number (1-indexed) */
-  attemptNumber: number;
-  /** Number of retries left */
-  retriesLeft: number;
-}
-
-/**
- * Retry configuration options.
- *
- * Uses exponential backoff with jitter by default to avoid thundering herd.
- */
-export interface RetryConfig {
-  /**
-   * Maximum number of retry attempts.
-   * @default 3
-   */
-  retries?: number;
-
-  /**
-   * Exponential backoff factor.
-   * @default 2
-   */
-  factor?: number;
-
-  /**
-   * Minimum wait time between retries (ms).
-   * @default 1000
-   */
-  minTimeout?: number;
-
-  /**
-   * Maximum wait time between retries (ms).
-   * @default 60000
-   */
-  maxTimeout?: number;
-
-  /**
-   * Add randomness to wait times (jitter).
-   * Helps avoid thundering herd problem.
-   * @default true
-   */
-  randomize?: boolean;
-
-  /**
-   * Callback called on each failed attempt.
-   */
-  onFailedAttempt?: (info: FailedAttemptInfo) => void;
-}
-
-/**
- * Default retry configuration.
- */
-export const DEFAULT_RETRY_CONFIG: Required<RetryConfig> = {
-  retries: 3,
-  factor: 2,
-  minTimeout: 1000,
-  maxTimeout: 60000,
-  randomize: true,
-  onFailedAttempt: () => {},
-};
-
-/**
- * Determine if an error should trigger a retry.
- *
- * Retries on:
- * - Network errors (connection refused, timeout, etc.)
- * - Server errors (5xx status codes)
- * - Rate limiting (429 status code)
- *
- * Does NOT retry on:
- * - Client errors (4xx except 429)
- * - Authentication errors (401, 403)
- * - Not found (404)
- *
- * @param error - The error to check
- * @returns true if should retry, false otherwise
- */
-export function shouldRetry(error: any): boolean {
-  // Always retry network errors
-  if (error instanceof NetworkError) {
-    return true;
-  }
-
-  // For API errors, check status code
-  if (error instanceof APIError) {
-    const status = error.statusCode;
-
-    // Retry on 5xx server errors
-    if (status >= 500 && status < 600) {
-      return true;
-    }
-
-    // Retry on 429 (rate limit)
-    if (status === 429) {
-      return true;
-    }
-
-    // Do NOT retry on 4xx client errors
-    return false;
-  }
-
-  // Retry on unknown errors (might be network issues)
-  return true;
-}
-
-/**
- * Wrap a function with retry logic.
- *
- * @param fn - Async function to retry
- * @param config - Retry configuration
- * @returns Result of the function
- *
- * @example
- * ```typescript
- * const result = await withRetry(
- *   async () => fetch('https://api.example.com/users'),
- *   { retries: 5, minTimeout: 2000 }
- * );
- * ```
- */
-export async function withRetry<T>(
-  fn: () => Promise<T>,
-  config?: RetryConfig
-): Promise<T> {
-  const finalConfig = { ...DEFAULT_RETRY_CONFIG, ...config };
-
-  return pRetry(
-    async () => {
-      try {
-        return await fn();
-      } catch (error) {
-        // Check if we should retry this error
-        if (!shouldRetry(error)) {
-          // Abort retry immediately for non-retryable errors
-          throw new AbortError(error as Error);
-        }
-
-        // Re-throw error to trigger retry
-        throw error;
-      }
-    },
-    {
-      retries: finalConfig.retries,
-      factor: finalConfig.factor,
-      minTimeout: finalConfig.minTimeout,
-      maxTimeout: finalConfig.maxTimeout,
-      randomize: finalConfig.randomize,
-      onFailedAttempt: finalConfig.onFailedAttempt ? (error) => {
-        // Adapt p-retry's FailedAttemptError to our FailedAttemptInfo
-        const pRetryError = error as any;  // p-retry's internal type
-        finalConfig.onFailedAttempt!({
-          error: pRetryError as Error,
-          attemptNumber: pRetryError.attemptNumber,
-          retriesLeft: pRetryError.retriesLeft,
-        });
-      } : undefined,
-    }
-  );
-}

package/src/generated/cfg_webpush/schema.json

@@ -1,302 +0,0 @@
-{
-  "openapi": "3.0.3",
-  "info": {
-    "title": "Django CFG API",
-    "version": "1.0.0",
-    "description": "Complete API documentation for Django CFG Demo Project",
-    "x-django-metadata": {
-      "group": "cfg_webpush",
-      "apps": [
-        "django_cfg_webpush"
-      ],
-      "generator": "django-client",
-      "generator_version": "1.0.0"
-    }
-  },
-  "paths": {
-    "/cfg/webpush/send/": {
-      "post": {
-        "operationId": "cfg_webpush_send_create",
-        "description": "Send push notification to all active subscriptions for the authenticated user.",
-        "summary": "Send push notification",
-        "tags": [
-          "Web Push"
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/SendPushRequestRequest"
-              }
-            },
-            "application/x-www-form-urlencoded": {
-              "schema": {
-                "$ref": "#/components/schemas/SendPushRequestRequest"
-              }
-            },
-            "multipart/form-data": {
-              "schema": {
-                "$ref": "#/components/schemas/SendPushRequestRequest"
-              }
-            }
-          },
-          "required": true
-        },
-        "security": [
-          {
-            "jwtAuthWithLastLogin": []
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/SendPushResponse"
-                }
-              }
-            },
-            "description": ""
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "description": "Bad request"
-                }
-              }
-            },
-            "description": ""
-          }
-        },
-        "x-async-capable": false
-      }
-    },
-    "/cfg/webpush/subscribe/": {
-      "post": {
-        "operationId": "cfg_webpush_subscribe_create",
-        "description": "Save push subscription from browser for the authenticated user.",
-        "summary": "Subscribe to push notifications",
-        "tags": [
-          "Web Push"
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/SubscribeRequestRequest"
-              }
-            },
-            "application/x-www-form-urlencoded": {
-              "schema": {
-                "$ref": "#/components/schemas/SubscribeRequestRequest"
-              }
-            },
-            "multipart/form-data": {
-              "schema": {
-                "$ref": "#/components/schemas/SubscribeRequestRequest"
-              }
-            }
-          },
-          "required": true
-        },
-        "security": [
-          {
-            "jwtAuthWithLastLogin": []
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/SubscribeResponse"
-                }
-              }
-            },
-            "description": ""
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "description": "Bad request"
-                }
-              }
-            },
-            "description": ""
-          }
-        },
-        "x-async-capable": false
-      }
-    },
-    "/cfg/webpush/vapid/": {
-      "get": {
-        "operationId": "cfg_webpush_vapid_retrieve",
-        "description": "Get VAPID public key for client subscription.",
-        "summary": "Get VAPID public key",
-        "tags": [
-          "Web Push"
-        ],
-        "security": [
-          {
-            "jwtAuthWithLastLogin": []
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/VapidPublicKeyResponse"
-                }
-              }
-            },
-            "description": ""
-          },
-          "503": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "description": "Service unavailable"
-                }
-              }
-            },
-            "description": ""
-          }
-        },
-        "x-async-capable": false
-      }
-    }
-  },
-  "components": {
-    "schemas": {
-      "SendPushRequestRequest": {
-        "type": "object",
-        "description": "Request serializer for sending push notifications.",
-        "properties": {
-          "title": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Notification title",
-            "maxLength": 255
-          },
-          "body": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Notification body"
-          },
-          "icon": {
-            "type": "string",
-            "format": "uri",
-            "nullable": true,
-            "minLength": 1,
-            "description": "Notification icon URL"
-          },
-          "url": {
-            "type": "string",
-            "format": "uri",
-            "nullable": true,
-            "minLength": 1,
-            "description": "URL to open on click"
-          }
-        },
-        "required": [
-          "body",
-          "title"
-        ]
-      },
-      "SendPushResponse": {
-        "type": "object",
-        "description": "Response serializer for send push endpoint.",
-        "properties": {
-          "success": {
-            "type": "boolean",
-            "description": "Whether send was successful"
-          },
-          "sent_to": {
-            "type": "integer",
-            "description": "Number of devices notification was sent to"
-          }
-        },
-        "required": [
-          "sent_to",
-          "success"
-        ]
-      },
-      "SubscribeRequestRequest": {
-        "type": "object",
-        "description": "Request serializer for subscribing to push notifications.",
-        "properties": {
-          "endpoint": {
-            "type": "string",
-            "format": "uri",
-            "minLength": 1,
-            "description": "Push service endpoint URL from browser",
-            "maxLength": 500
-          },
-          "keys": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "string",
-              "minLength": 1
-            },
-            "description": "Encryption keys (p256dh and auth)"
-          }
-        },
-        "required": [
-          "endpoint",
-          "keys"
-        ]
-      },
-      "SubscribeResponse": {
-        "type": "object",
-        "description": "Response serializer for subscription endpoint.",
-        "properties": {
-          "success": {
-            "type": "boolean",
-            "description": "Whether subscription was successful"
-          },
-          "subscription_id": {
-            "type": "integer",
-            "description": "ID of the subscription"
-          },
-          "created": {
-            "type": "boolean",
-            "description": "Whether subscription was newly created"
-          }
-        },
-        "required": [
-          "created",
-          "subscription_id",
-          "success"
-        ]
-      },
-      "VapidPublicKeyResponse": {
-        "type": "object",
-        "description": "Response serializer for VAPID public key endpoint.",
-        "properties": {
-          "publicKey": {
-            "type": "string",
-            "description": "VAPID public key for client subscription"
-          }
-        },
-        "required": [
-          "publicKey"
-        ]
-      }
-    },
-    "securitySchemes": {
-      "jwtAuthWithLastLogin": {
-        "type": "http",
-        "scheme": "bearer",
-        "bearerFormat": "JWT"
-      }
-    }
-  },
-  "servers": [
-    {
-      "url": "http://localhost:8000"
-    }
-  ]
-}

package/src/generated/cfg_webpush/storage.ts

@@ -1,162 +0,0 @@
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * 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`);
-  }
-}