@djangocfg/api 2.1.215 → 2.1.217

package/src/{generated/cfg_totp → _api/generated/cfg_centrifugo}/http.ts

@@ -108,4 +108,30 @@ export class FetchAdapter implements HttpClientAdapter {
       headers: responseHeaders,
     };
   }
+}
+
+/**
+ * FetchAdapter with keepalive:true.
+ *
+ * Use this adapter when you need requests to survive page unload
+ * (visibilitychange / beforeunload) — the browser will complete the request
+ * even after the page is navigated away. Typical use: monitor / analytics flush.
+ *
+ * @example
+ * ```typescript
+ * import { APIClient, KeepAliveFetchAdapter } from './client';
+ * const client = new APIClient(baseUrl, { httpClient: new KeepAliveFetchAdapter() });
+ * ```
+ */
+export class KeepAliveFetchAdapter extends FetchAdapter {
+  async request<T = any>(request: HttpRequest): Promise<HttpResponse<T>> {
+    const origFetch = globalThis.fetch;
+    globalThis.fetch = (input: RequestInfo | URL, init?: RequestInit) =>
+      origFetch(input, { ...init, keepalive: true });
+    try {
+      return await super.request<T>(request);
+    } finally {
+      globalThis.fetch = origFetch;
+    }
+  }
 }

package/src/{generated → _api/generated}/cfg_centrifugo/index.ts

@@ -100,7 +100,7 @@ export { APIError, NetworkError } from "./errors";
 
 // Re-export HTTP adapters for custom implementations
 export type { HttpClientAdapter, HttpRequest, HttpResponse } from "./http";
-export { FetchAdapter } from "./http";
+export { FetchAdapter, KeepAliveFetchAdapter } from "./http";
 
 // Re-export logger types and classes
 export type { LoggerConfig, RequestLog, ResponseLog, ErrorLog } from "./logger";
@@ -130,6 +130,8 @@ function detectLocale(): string | null {
 export interface APIOptions {
   /** Custom storage adapter (defaults to LocalStorageAdapter) */
   storage?: StorageAdapter;
+  /** Custom HTTP client adapter (defaults to FetchAdapter) */
+  httpClient?: HttpClientAdapter;
   /** Retry configuration for failed requests */
   retryConfig?: RetryConfig;
   /** Logger configuration */
@@ -169,6 +171,7 @@ export class API {
 
     // Initialize APIClient with token getter for URL authentication
     this._client = new APIClient(this.baseUrl, {
+      httpClient: this.options?.httpClient,
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
       tokenGetter: () => this.getToken(),
@@ -191,6 +194,7 @@ export class API {
 
   private _reinitClients(): void {
     this._client = new APIClient(this.baseUrl, {
+      httpClient: this.options?.httpClient,
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
       tokenGetter: () => this.getToken(),

package/src/{generated → _api/generated}/cfg_totp/_utils/schemas/TotpVerifyUser.schema.ts

@@ -21,7 +21,7 @@ export const TotpVerifyUserSchema = z.object({
   phone: z.string().max(20).optional(),
   position: z.string().max(100).optional(),
   language: z.string().max(10).optional(),
-  avatar: z.string().refine((v) => v === '' || v.startsWith('/') || v.startsWith('http://') || v.startsWith('https://') || v.startsWith('ws://') || v.startsWith('wss://'), { message: 'Must be a URL or relative path' }).nullable(),
+  avatar: z.string().nullable(),
   is_staff: z.boolean(),
   is_superuser: z.boolean(),
   date_joined: z.string().datetime({ offset: true }),

package/src/{generated/cfg_centrifugo → _api/generated/cfg_totp}/http.ts

@@ -108,4 +108,30 @@ export class FetchAdapter implements HttpClientAdapter {
       headers: responseHeaders,
     };
   }
+}
+
+/**
+ * FetchAdapter with keepalive:true.
+ *
+ * Use this adapter when you need requests to survive page unload
+ * (visibilitychange / beforeunload) — the browser will complete the request
+ * even after the page is navigated away. Typical use: monitor / analytics flush.
+ *
+ * @example
+ * ```typescript
+ * import { APIClient, KeepAliveFetchAdapter } from './client';
+ * const client = new APIClient(baseUrl, { httpClient: new KeepAliveFetchAdapter() });
+ * ```
+ */
+export class KeepAliveFetchAdapter extends FetchAdapter {
+  async request<T = any>(request: HttpRequest): Promise<HttpResponse<T>> {
+    const origFetch = globalThis.fetch;
+    globalThis.fetch = (input: RequestInfo | URL, init?: RequestInit) =>
+      origFetch(input, { ...init, keepalive: true });
+    try {
+      return await super.request<T>(request);
+    } finally {
+      globalThis.fetch = origFetch;
+    }
+  }
 }

package/src/{generated → _api/generated}/cfg_totp/index.ts

@@ -105,7 +105,7 @@ export { APIError, NetworkError } from "./errors";
 
 // Re-export HTTP adapters for custom implementations
 export type { HttpClientAdapter, HttpRequest, HttpResponse } from "./http";
-export { FetchAdapter } from "./http";
+export { FetchAdapter, KeepAliveFetchAdapter } from "./http";
 
 // Re-export logger types and classes
 export type { LoggerConfig, RequestLog, ResponseLog, ErrorLog } from "./logger";
@@ -135,6 +135,8 @@ function detectLocale(): string | null {
 export interface APIOptions {
   /** Custom storage adapter (defaults to LocalStorageAdapter) */
   storage?: StorageAdapter;
+  /** Custom HTTP client adapter (defaults to FetchAdapter) */
+  httpClient?: HttpClientAdapter;
   /** Retry configuration for failed requests */
   retryConfig?: RetryConfig;
   /** Logger configuration */
@@ -175,6 +177,7 @@ export class API {
 
     // Initialize APIClient with token getter for URL authentication
     this._client = new APIClient(this.baseUrl, {
+      httpClient: this.options?.httpClient,
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
       tokenGetter: () => this.getToken(),
@@ -198,6 +201,7 @@ export class API {
 
   private _reinitClients(): void {
     this._client = new APIClient(this.baseUrl, {
+      httpClient: this.options?.httpClient,
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
       tokenGetter: () => this.getToken(),

package/src/_api/index.ts

@@ -0,0 +1,23 @@
+// Singletons + BaseClient
+export { api, apiAccounts, apiTotp, apiCentrifugo, BaseClient, LocalStorageAdapter, MemoryStorageAdapter } from './BaseClient';
+
+// cfg_accounts
+export * from './generated/cfg_accounts';
+export { Schemas, Fetchers, Enums } from './generated/cfg_accounts';
+export * as CfgAccountsTypes from './generated/cfg_accounts';
+
+// cfg_centrifugo
+export { getCentrifugoAuthTokenRetrieve } from './generated/cfg_centrifugo';
+export * as CentrifugoHooks from './generated/cfg_centrifugo/_utils/hooks';
+export * as CentrifugoFetchers from './generated/cfg_centrifugo/_utils/fetchers';
+export * as CentrifugoTypes from './generated/cfg_centrifugo/_utils/schemas';
+
+// cfg_totp
+export * as TotpHooks from './generated/cfg_totp/_utils/hooks';
+export * as TotpFetchers from './generated/cfg_totp/_utils/fetchers';
+export * as TotpTypes from './generated/cfg_totp/_utils/schemas';
+
+// API Classes
+export { API as AccountsAPI } from './generated/cfg_accounts';
+export { API as TotpAPI } from './generated/cfg_totp';
+export { API as CentrifugoAPI } from './generated/cfg_centrifugo';

package/src/auth/context/AccountsContext.tsx

@@ -20,13 +20,13 @@ import {
 // Import API instance and fetcher
 import { api as apiAccounts, getAccountsProfileRetrieve } from '../../';
 // Import schema
-import { PatchedUserProfileUpdateRequestSchema } from '../../generated/cfg_accounts';
+import { PatchedUserProfileUpdateRequestSchema } from '../../_api/generated/cfg_accounts';
 // Import hooks from generated API hooks
 import {
     useCreateAccountsOtpRequestCreate, useCreateAccountsOtpVerifyCreate,
     useCreateAccountsProfileAvatarCreate, useCreateAccountsTokenRefreshCreate,
     usePartialUpdateAccountsProfilePartialUpdate, useUpdateAccountsProfileUpdateUpdate
-} from '../../generated/cfg_accounts/_utils/hooks';
+} from '../../_api/generated/cfg_accounts/_utils/hooks';
 import { clearProfileCache, getCachedProfile, setCachedProfile } from '../hooks/useProfileCache';
 import { authLogger } from '../utils/logger';
 
@@ -41,7 +41,7 @@ import type {
   OTPVerifyResponse,
   TokenRefresh,
   API,
-} from '../../generated/cfg_accounts';
+} from '../../_api/generated/cfg_accounts';
 // Re-export schemas for external use
 export { PatchedUserProfileUpdateRequestSchema };
 export type { PatchedUserProfileUpdateRequest };

package/src/clients.ts

@@ -8,9 +8,9 @@
  *   import { useAccountsOauthGithubCallbackCreate } from '@djangocfg/api/clients';
  */
 
-import { API as AccountsAPIClass, LocalStorageAdapter } from './generated/cfg_accounts';
-import { API as CentrifugoAPIClass } from './generated/cfg_centrifugo';
-import { API as TotpAPIClass } from './generated/cfg_totp';
+import { API as AccountsAPIClass, LocalStorageAdapter } from './_api/generated/cfg_accounts';
+import { API as CentrifugoAPIClass } from './_api/generated/cfg_centrifugo';
+import { API as TotpAPIClass } from './_api/generated/cfg_totp';
 
 // ============================================================================
 // Pre-configured API instances (for hooks and direct usage)
@@ -26,32 +26,32 @@ export const apiCentrifugo = new CentrifugoAPIClass(apiUrl, { storage });
 // ============================================================================
 // Enums (re-export from accounts)
 // ============================================================================
-export * as Enums from './generated/cfg_accounts/enums';
+export * as Enums from './_api/generated/cfg_accounts/enums';
 
 // ============================================================================
 // CFG Accounts (primary exports - includes shared types)
 // ============================================================================
-export * from './generated/cfg_accounts/_utils/hooks';
-export * from './generated/cfg_accounts/_utils/fetchers';
-export * from './generated/cfg_accounts/_utils/schemas';
+export * from './_api/generated/cfg_accounts/_utils/hooks';
+export * from './_api/generated/cfg_accounts/_utils/fetchers';
+export * from './_api/generated/cfg_accounts/_utils/schemas';
 
 // ============================================================================
 // CFG Centrifugo (namespaced to avoid conflicts)
 // ============================================================================
-export * as CentrifugoHooks from './generated/cfg_centrifugo/_utils/hooks';
-export * as CentrifugoFetchers from './generated/cfg_centrifugo/_utils/fetchers';
-export * as CentrifugoTypes from './generated/cfg_centrifugo/_utils/schemas';
+export * as CentrifugoHooks from './_api/generated/cfg_centrifugo/_utils/hooks';
+export * as CentrifugoFetchers from './_api/generated/cfg_centrifugo/_utils/fetchers';
+export * as CentrifugoTypes from './_api/generated/cfg_centrifugo/_utils/schemas';
 
 // ============================================================================
 // CFG TOTP (namespaced to avoid conflicts)
 // ============================================================================
-export * as TotpHooks from './generated/cfg_totp/_utils/hooks';
-export * as TotpFetchers from './generated/cfg_totp/_utils/fetchers';
-export * as TotpTypes from './generated/cfg_totp/_utils/schemas';
+export * as TotpHooks from './_api/generated/cfg_totp/_utils/hooks';
+export * as TotpFetchers from './_api/generated/cfg_totp/_utils/fetchers';
+export * as TotpTypes from './_api/generated/cfg_totp/_utils/schemas';
 
 // ============================================================================
 // API Classes (for creating custom instances)
 // ============================================================================
-export { API as AccountsAPI } from './generated/cfg_accounts';
-export { API as TotpAPI } from './generated/cfg_totp';
-export { API as CentrifugoAPI } from './generated/cfg_centrifugo';
+export { API as AccountsAPI } from './_api/generated/cfg_accounts';
+export { API as TotpAPI } from './_api/generated/cfg_totp';
+export { API as CentrifugoAPI } from './_api/generated/cfg_centrifugo';

package/src/hooks/accounts.ts

@@ -5,4 +5,4 @@
  */
 'use client';
 
-export * from '../generated/cfg_accounts/_utils/hooks';
+export * from '../_api/generated/cfg_accounts/_utils/hooks';

package/src/index.ts

@@ -11,19 +11,19 @@
 // ============================================================================
 // Main API from cfg_accounts (authentication)
 // ============================================================================
-export * from './generated/cfg_accounts';
-export { API, LocalStorageAdapter, MemoryStorageAdapter } from './generated/cfg_accounts';
-export { Schemas, Fetchers, Enums } from './generated/cfg_accounts';
+export * from './_api/generated/cfg_accounts';
+export { API, LocalStorageAdapter, MemoryStorageAdapter } from './_api/generated/cfg_accounts';
+export { Schemas, Fetchers, Enums } from './_api/generated/cfg_accounts';
 
 // ============================================================================
 // CFG Accounts Type Namespace
 // ============================================================================
-export * as CfgAccountsTypes from './generated/cfg_accounts';
+export * as CfgAccountsTypes from './_api/generated/cfg_accounts';
 
 // ============================================================================
 // Centrifugo Fetchers (for WebSocket token refresh)
 // ============================================================================
-export { getCentrifugoAuthTokenRetrieve } from './generated/cfg_centrifugo';
+export { getCentrifugoAuthTokenRetrieve } from './_api/generated/cfg_centrifugo';
 
 /**
  * Base Client for all API services
@@ -34,7 +34,7 @@ export { getCentrifugoAuthTokenRetrieve } from './generated/cfg_centrifugo';
  * - Singleton pattern for API client
  */
 
-import { API, LocalStorageAdapter } from './generated/cfg_accounts';
+import { API, LocalStorageAdapter } from './_api/generated/cfg_accounts';
 
 /**
  * Singleton API instance with JWT token management

package/src/server.ts

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

package/src/generated/cfg_accounts/_utils/schemas/OAuthAuthorizeRequestRequest.schema.ts

@@ -1,20 +0,0 @@
-/**
- * Zod schema for OAuthAuthorizeRequestRequest
- *
- * This schema provides runtime validation and type inference.
- *  * Request to start OAuth flow.
- *  */
-import { z } from 'zod'
-
-/**
- * Request to start OAuth flow.
- */
-export const OAuthAuthorizeRequestRequestSchema = z.object({
-  redirect_uri: z.string().refine((v) => v === '' || v.startsWith('/') || v.startsWith('http://') || v.startsWith('https://') || v.startsWith('ws://') || v.startsWith('wss://'), { message: 'Must be a URL or relative path' }).optional(),
-  source_url: z.string().refine((v) => v === '' || v.startsWith('/') || v.startsWith('http://') || v.startsWith('https://') || v.startsWith('ws://') || v.startsWith('wss://'), { message: 'Must be a URL or relative path' }).optional(),
-})
-
-/**
- * Infer TypeScript type from Zod schema
- */
-export type OAuthAuthorizeRequestRequest = z.infer<typeof OAuthAuthorizeRequestRequestSchema>

package/src/{generated → _api/generated}/cfg_accounts/accounts/models.ts

@@ -30,13 +30,25 @@ export interface OTPRequestResponse {
 }
 
 /**
- * Error response for OTP operations.
+ * OTP verification response. When 2FA is required: - requires_2fa: True -
+ * session_id: UUID of 2FA verification session - refresh/access/user: null
+ * When 2FA is not required: - requires_2fa: False - session_id: null -
+ * refresh/access/user: populated
  * 
  * Response model (includes read-only fields).
  */
-export interface OTPErrorResponse {
-  /** Error message */
-  error: string;
+export interface OTPVerifyResponse {
+  /** Whether 2FA verification is required */
+  requires_2fa?: boolean;
+  /** 2FA session ID (if requires_2fa is True) */
+  session_id?: string | null;
+  /** JWT refresh token (if requires_2fa is False) */
+  refresh?: string | null;
+  /** JWT access token (if requires_2fa is False) */
+  access?: string | null;
+  user?: User | null;
+  /** Whether user should be prompted to enable 2FA */
+  should_prompt_2fa?: boolean;
 }
 
 /**
@@ -58,25 +70,13 @@ export interface OTPVerifyRequest {
 }
 
 /**
- * OTP verification response. When 2FA is required: - requires_2fa: True -
- * session_id: UUID of 2FA verification session - refresh/access/user: null
- * When 2FA is not required: - requires_2fa: False - session_id: null -
- * refresh/access/user: populated
+ * Error response for OTP operations.
  * 
  * Response model (includes read-only fields).
  */
-export interface OTPVerifyResponse {
-  /** Whether 2FA verification is required */
-  requires_2fa?: boolean;
-  /** 2FA session ID (if requires_2fa is True) */
-  session_id?: string | null;
-  /** JWT refresh token (if requires_2fa is False) */
-  refresh?: string | null;
-  /** JWT access token (if requires_2fa is False) */
-  access?: string | null;
-  user?: User | null;
-  /** Whether user should be prompted to enable 2FA */
-  should_prompt_2fa?: boolean;
+export interface OTPErrorResponse {
+  /** Error message */
+  error: string;
 }
 
 /**

package/src/{generated → _api/generated}/cfg_accounts/accounts__auth/models.ts

@@ -2,18 +2,18 @@
 // Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * 
- * Request model (no read-only fields).
+ * Response model (includes read-only fields).
  */
-export interface TokenRefreshRequest {
+export interface TokenRefresh {
+  access: string;
   refresh: string;
 }
 
 /**
  * 
- * Response model (includes read-only fields).
+ * Request model (no read-only fields).
  */
-export interface TokenRefresh {
-  access: string;
+export interface TokenRefreshRequest {
   refresh: string;
 }
 

package/src/{generated → _api/generated}/cfg_accounts/accounts__user_profile/models.ts

@@ -32,12 +32,17 @@ export interface User {
 }
 
 /**
+ * Serializer for updating user profile.
  * 
  * Request model (no read-only fields).
  */
-export interface CfgAccountsProfileAvatarCreateRequest {
-  /** Avatar image file (JPEG, PNG, GIF, WebP, max 5MB) */
-  avatar: File | Blob;
+export interface UserProfileUpdateRequest {
+  first_name?: string;
+  last_name?: string;
+  company?: string;
+  phone?: string;
+  position?: string;
+  language?: string;
 }
 
 /**
@@ -57,7 +62,7 @@ export interface AccountDeleteResponse {
  * 
  * Request model (no read-only fields).
  */
-export interface UserProfileUpdateRequest {
+export interface PatchedUserProfileUpdateRequest {
   first_name?: string;
   last_name?: string;
   company?: string;
@@ -67,17 +72,12 @@ export interface UserProfileUpdateRequest {
 }
 
 /**
- * Serializer for updating user profile.
  * 
  * Request model (no read-only fields).
  */
-export interface PatchedUserProfileUpdateRequest {
-  first_name?: string;
-  last_name?: string;
-  company?: string;
-  phone?: string;
-  position?: string;
-  language?: string;
+export interface CfgAccountsProfileAvatarCreateRequest {
+  /** Avatar image file (JPEG, PNG, GIF, WebP, max 5MB) */
+  avatar: File | Blob;
 }
 
 /**