@djangocfg/api 2.1.215 → 2.1.217

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "2.1.215",
+  "version": "2.1.217",
   "description": "Auto-generated TypeScript API client with React hooks, SWR integration, and Zod validation for Django REST Framework backends",
   "keywords": [
     "django",
@@ -75,18 +75,18 @@
   },
   "peerDependencies": {
     "consola": "^3.4.2",
-    "next": ">=16.0.0",
+    "next": "^16.0.10",
     "p-retry": "^7.0.0",
-    "react": "^19.0.0",
+    "react": "^19.1.0",
     "swr": "^2.3.7",
-    "zod": "^4.1.13"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^24.7.2",
-    "@types/react": "^19.0.0",
-    "@djangocfg/typescript-config": "^2.1.215",
-    "next": "^16.0.0",
-    "react": "^19.0.0",
+    "@types/react": "^19.1.0",
+    "@djangocfg/typescript-config": "^2.1.217",
+    "next": "^16.0.10",
+    "react": "^19.1.0",
     "tsup": "^8.5.0",
     "typescript": "^5.9.3"
   }

package/src/.claude/.sidecar/activity.jsonl

@@ -0,0 +1,4 @@
+{"ts":"2026-03-13T14:54:06.216544Z","action":"map","tokens":2824,"model":"deepseek/deepseek-v3.2-20251201","details":{"directories":12,"entry_points":14}}
+{"ts":"2026-03-13T14:54:34.414020Z","action":"update_check","tokens":0,"model":"deepseek/deepseek-v3.2","details":{}}
+{"ts":"2026-03-13T14:55:05.263102Z","action":"review","tokens":2077,"model":"deepseek/deepseek-v3.2","details":{"items_found":4}}
+{"ts":"2026-03-13T14:55:15.072208Z","action":"map","tokens":0,"model":"cache","details":{"directories":12,"entry_points":11}}

package/src/.claude/.sidecar/history/2026-03-13.md

@@ -0,0 +1,28 @@
+# Sidecar Review -- 2026-03-13T14:55:05.261214+00:00
+
+## Contradictions
+
+- [?] The project map's summary describes the project as a 'Shared TypeScript API client library for Django CFG services', but recent commits (e.g., 'feat(frontend-monitor): add Sentry-like browser error and event collection') indicate the project contains frontend monitoring features, which suggests a broader scope than just an API client library.
+  Files: .claude/project-map.md
+  Action: Review and update the project summary to accurately reflect the full scope of the project, including frontend utilities and monitoring features.
+  (id: e7481d45af8d)
+
+## Missing Documentation
+
+- [?] The project map lists a 'server.ts' entry point, but there is no corresponding 'server' directory documented in the structure. Recent commits mention 'django-ogimage' and 'frontend-monitor' features, which are not represented in the documented structure.
+  Files: .claude/project-map.md
+  Action: Update the project map to include all top-level source directories and their purposes, especially for new features like 'frontend-monitor' and 'django-ogimage'.
+  (id: 5421de290ecc)
+
+- [~] The project map's 'Structure' section lists '_api/generated/' directories but does not document the root '_api' directory's purpose or structure. The 'hooks/' directory is listed but lacks any sub-structure documentation.
+  Files: .claude/project-map.md
+  Action: Expand the project map to describe the purpose of the '_api' directory and detail the internal structure of the 'hooks/' directory.
+  (id: 16b002809cdb)
+
+- [!] No dependencies (pyproject.toml, package.json, requirements.txt) were detected for analysis, but the project is described as a TypeScript package. The lack of dependency documentation is a critical gap for understanding the project's requirements and tech stack.
+  Files: .claude/project-map.md
+  Action: Ensure dependency files (e.g., package.json) exist and are correctly located, then update the documentation analysis to include them for accurate dependency checking.
+  (id: 8209bc5ebfd8)
+
+---
+Model: deepseek/deepseek-v3.2 | Tokens: 2077

package/src/.claude/.sidecar/map_cache.json

@@ -0,0 +1,50 @@
+{
+  ".": {
+    "hash": "dce90cd429fe0655",
+    "annotation": "Primary package entry points for client, server, and combined API exports."
+  },
+  "_api/generated/cfg_accounts": {
+    "hash": "ee7e622ee1adb5d6",
+    "annotation": "Auto-generated TypeScript client for the accounts service API."
+  },
+  "_api/generated/cfg_centrifugo": {
+    "hash": "48afdc29ad6c6f4e",
+    "annotation": "Auto-generated TypeScript client for the Centrifugo real-time service API."
+  },
+  "_api/generated/cfg_totp": {
+    "hash": "ee7e622ee1adb5d6",
+    "annotation": "Auto-generated TypeScript client for the TOTP two-factor authentication service API."
+  },
+  "auth": {
+    "hash": "6477ace2312a963f",
+    "annotation": "Core authentication module with React contexts, hooks, and server utilities."
+  },
+  "auth/context": {
+    "hash": "d8518d434f50800b",
+    "annotation": "React context providers and types for authentication and account state."
+  },
+  "auth/hooks": {
+    "hash": "e680cd0b828bfa4b",
+    "annotation": "Custom React hooks for authentication forms, guards, validation, and API integration."
+  },
+  "auth/middlewares": {
+    "hash": "596c7611c84412d2",
+    "annotation": "Authentication middleware for token refresh and request proxying."
+  },
+  "auth/types": {
+    "hash": "eb626cbe01a78813",
+    "annotation": "TypeScript type definitions for authentication forms and state."
+  },
+  "auth/utils": {
+    "hash": "c29a2c29776dabed",
+    "annotation": "Shared utilities for logging, error handling, validation, and analytics."
+  },
+  "hooks": {
+    "hash": "3acd5f369e44d711",
+    "annotation": "General-purpose React hooks for account management."
+  },
+  "auth/__tests__": {
+    "hash": "c1e1582d095d63cf",
+    "annotation": "Unit tests for authentication hooks and components."
+  }
+}

package/src/.claude/.sidecar/review.md

@@ -0,0 +1,28 @@
+# Sidecar Review -- 2026-03-13T14:55:05.261214+00:00
+
+## Contradictions
+
+- [?] The project map's summary describes the project as a 'Shared TypeScript API client library for Django CFG services', but recent commits (e.g., 'feat(frontend-monitor): add Sentry-like browser error and event collection') indicate the project contains frontend monitoring features, which suggests a broader scope than just an API client library.
+  Files: .claude/project-map.md
+  Action: Review and update the project summary to accurately reflect the full scope of the project, including frontend utilities and monitoring features.
+  (id: e7481d45af8d)
+
+## Missing Documentation
+
+- [?] The project map lists a 'server.ts' entry point, but there is no corresponding 'server' directory documented in the structure. Recent commits mention 'django-ogimage' and 'frontend-monitor' features, which are not represented in the documented structure.
+  Files: .claude/project-map.md
+  Action: Update the project map to include all top-level source directories and their purposes, especially for new features like 'frontend-monitor' and 'django-ogimage'.
+  (id: 5421de290ecc)
+
+- [~] The project map's 'Structure' section lists '_api/generated/' directories but does not document the root '_api' directory's purpose or structure. The 'hooks/' directory is listed but lacks any sub-structure documentation.
+  Files: .claude/project-map.md
+  Action: Expand the project map to describe the purpose of the '_api' directory and detail the internal structure of the 'hooks/' directory.
+  (id: 16b002809cdb)
+
+- [!] No dependencies (pyproject.toml, package.json, requirements.txt) were detected for analysis, but the project is described as a TypeScript package. The lack of dependency documentation is a critical gap for understanding the project's requirements and tech stack.
+  Files: .claude/project-map.md
+  Action: Ensure dependency files (e.g., package.json) exist and are correctly located, then update the documentation analysis to include them for accurate dependency checking.
+  (id: 8209bc5ebfd8)
+
+---
+Model: deepseek/deepseek-v3.2 | Tokens: 2077

package/src/.claude/.sidecar/scan.log

@@ -0,0 +1,3 @@
+Review generated: 4 items found
+Tokens used: 2077 (deepseek/deepseek-v3.2)
+Converted 4 items to tasks

package/src/.claude/.sidecar/tasks/T-001.md

@@ -0,0 +1,18 @@
+---
+context_files:
+- .claude/project-map.md
+created_at: '2026-03-13T14:55:05.266022Z'
+id: T-001
+priority: medium
+source: sidecar_review
+source_item_id: 5421de290ecc
+status: pending
+title: '[gap] The project map lists a ''server.ts'' entry point, but there is no corresponding
+  '''
+---
+
+The project map lists a 'server.ts' entry point, but there is no corresponding 'server' directory documented in the structure. Recent commits mention 'django-ogimage' and 'frontend-monitor' features, which are not represented in the documented structure.
+
+**Files:** .claude/project-map.md
+
+**Action:** Update the project map to include all top-level source directories and their purposes, especially for new features like 'frontend-monitor' and 'django-ogimage'.

package/src/.claude/.sidecar/tasks/T-002.md

@@ -0,0 +1,18 @@
+---
+context_files:
+- .claude/project-map.md
+created_at: '2026-03-13T14:55:05.268597Z'
+id: T-002
+priority: low
+source: sidecar_review
+source_item_id: 16b002809cdb
+status: pending
+title: '[gap] The project map''s ''Structure'' section lists ''_api/generated/'' directories
+  but do'
+---
+
+The project map's 'Structure' section lists '_api/generated/' directories but does not document the root '_api' directory's purpose or structure. The 'hooks/' directory is listed but lacks any sub-structure documentation.
+
+**Files:** .claude/project-map.md
+
+**Action:** Expand the project map to describe the purpose of the '_api' directory and detail the internal structure of the 'hooks/' directory.

package/src/.claude/.sidecar/tasks/T-003.md

@@ -0,0 +1,18 @@
+---
+context_files:
+- .claude/project-map.md
+created_at: '2026-03-13T14:55:05.269247Z'
+id: T-003
+priority: medium
+source: sidecar_review
+source_item_id: e7481d45af8d
+status: pending
+title: '[contradiction] The project map''s summary describes the project as a ''Shared
+  TypeScript API clie'
+---
+
+The project map's summary describes the project as a 'Shared TypeScript API client library for Django CFG services', but recent commits (e.g., 'feat(frontend-monitor): add Sentry-like browser error and event collection') indicate the project contains frontend monitoring features, which suggests a broader scope than just an API client library.
+
+**Files:** .claude/project-map.md
+
+**Action:** Review and update the project summary to accurately reflect the full scope of the project, including frontend utilities and monitoring features.

package/src/.claude/.sidecar/tasks/T-004.md

@@ -0,0 +1,18 @@
+---
+context_files:
+- .claude/project-map.md
+created_at: '2026-03-13T14:55:05.269870Z'
+id: T-004
+priority: high
+source: sidecar_review
+source_item_id: 8209bc5ebfd8
+status: pending
+title: '[gap] No dependencies (pyproject.toml, package.json, requirements.txt) were
+  detected f'
+---
+
+No dependencies (pyproject.toml, package.json, requirements.txt) were detected for analysis, but the project is described as a TypeScript package. The lack of dependency documentation is a critical gap for understanding the project's requirements and tech stack.
+
+**Files:** .claude/project-map.md
+
+**Action:** Ensure dependency files (e.g., package.json) exist and are correctly located, then update the documentation analysis to include them for accurate dependency checking.

package/src/.claude/.sidecar/usage.json

@@ -0,0 +1,5 @@
+{
+  "date": "2026-03-13",
+  "tokens": 4901,
+  "calls": 3
+}

package/src/.claude/project-map.md

@@ -0,0 +1,34 @@
+# Project Map
+> typescript-package — Shared TypeScript API client library for Django CFG services with authentication and real-time features.
+> Generated: 2026-03-13T14:55:15.070316+00:00
+
+## Structure
+
+    - `_api/generated/cfg_accounts/` — Auto-generated TypeScript client for the accounts service API. **[entry: index.ts]**
+    - `_api/generated/cfg_centrifugo/` — Auto-generated TypeScript client for the Centrifugo real-time service API. **[entry: index.ts]**
+    - `_api/generated/cfg_totp/` — Auto-generated TypeScript client for the TOTP two-factor authentication service API. **[entry: index.ts]**
+- `auth/` — Core authentication module with React contexts, hooks, and server utilities. **[entry: index.ts]**
+  - `auth/__tests__/` — Unit tests for authentication hooks and components.
+  - `auth/context/` — React context providers and types for authentication and account state. **[entry: index.ts]**
+  - `auth/hooks/` — Custom React hooks for authentication forms, guards, validation, and API integration. **[entry: index.ts]**
+  - `auth/middlewares/` — Authentication middleware for token refresh and request proxying. **[entry: index.ts]**
+  - `auth/types/` — TypeScript type definitions for authentication forms and state. **[entry: index.ts]**
+  - `auth/utils/` — Shared utilities for logging, error handling, validation, and analytics. **[entry: index.ts]**
+- `hooks/` — General-purpose React hooks for account management. **[entry: index.ts]**
+
+## Entry Points
+
+- `./index.ts`
+- `_api/generated/cfg_accounts/index.ts`
+- `_api/generated/cfg_centrifugo/index.ts`
+- `_api/generated/cfg_totp/index.ts`
+- `auth/index.ts`
+- `auth/context/index.ts`
+- `auth/hooks/index.ts`
+- `auth/middlewares/index.ts`
+- `auth/types/index.ts`
+- `auth/utils/index.ts`
+- `hooks/index.ts`
+
+---
+Model: cache | Tokens: 0

package/src/_api/BaseClient.ts

@@ -0,0 +1,22 @@
+import { API as AccountsAPIClass, LocalStorageAdapter, MemoryStorageAdapter } from './generated/cfg_accounts';
+import { API as CentrifugoAPIClass } from './generated/cfg_centrifugo';
+import { API as TotpAPIClass } from './generated/cfg_totp';
+
+const isStaticBuild = process.env.NEXT_PUBLIC_STATIC_BUILD === 'true';
+const apiUrl = isStaticBuild ? '' : process.env.NEXT_PUBLIC_API_URL || '';
+const storage = new LocalStorageAdapter();
+
+export const apiAccounts = new AccountsAPIClass(apiUrl, { storage });
+export const apiTotp = new TotpAPIClass(apiUrl, { storage });
+export const apiCentrifugo = new CentrifugoAPIClass(apiUrl, { storage });
+
+/** Legacy singleton kept for backwards compatibility */
+export const api = apiAccounts;
+
+export class BaseClient {
+  protected static api = apiAccounts;
+  protected static apiTotp = apiTotp;
+  protected static apiCentrifugo = apiCentrifugo;
+}
+
+export { LocalStorageAdapter, MemoryStorageAdapter };

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

@@ -90,7 +90,7 @@ export function usePartialUpdateAccountsProfilePartialUpdate() {
   return async (data: UserProfileUpdateRequest, client?: API): Promise<User> => {
     const result = await Fetchers.partialUpdateAccountsProfilePartialUpdate(data, client)
     // Revalidate related queries
-    mutate('cfg-accounts-profile-partial')
+    mutate('cfg-accounts-profile')
     return result
   }
 }
@@ -108,7 +108,7 @@ export function usePartialUpdateAccountsProfilePartialPartialUpdate() {
   return async (data?: PatchedUserProfileUpdateRequest, client?: API): Promise<User> => {
     const result = await Fetchers.partialUpdateAccountsProfilePartialPartialUpdate(data, client)
     // Revalidate related queries
-    mutate('cfg-accounts-profile-partial-partial')
+    mutate('cfg-accounts-profile-partial')
     return result
   }
 }
@@ -144,7 +144,7 @@ export function usePartialUpdateAccountsProfileUpdatePartialUpdate() {
   return async (data?: PatchedUserProfileUpdateRequest, client?: API): Promise<User> => {
     const result = await Fetchers.partialUpdateAccountsProfileUpdatePartialUpdate(data, client)
     // Revalidate related queries
-    mutate('cfg-accounts-profile-partial')
+    mutate('cfg-accounts-profile')
     return result
   }
 }

package/src/{generated → _api/generated}/cfg_accounts/_utils/schemas/CentrifugoToken.schema.ts

@@ -11,7 +11,7 @@ import { z } from 'zod'
  */
 export const CentrifugoTokenSchema = z.object({
   token: z.string(),
-  centrifugo_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' }),
+  centrifugo_url: z.string(),
   expires_at: z.string().datetime({ offset: true }),
   channels: z.array(z.string()),
 })

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

@@ -0,0 +1,20 @@
+/**
+ * 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().optional(),
+  source_url: z.string().optional(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type OAuthAuthorizeRequestRequest = z.infer<typeof OAuthAuthorizeRequestRequestSchema>

package/src/{generated → _api/generated}/cfg_accounts/_utils/schemas/OAuthAuthorizeResponse.schema.ts

@@ -10,7 +10,7 @@ import { z } from 'zod'
  * Response with OAuth authorization URL.
  */
 export const OAuthAuthorizeResponseSchema = z.object({
-  authorization_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' }),
+  authorization_url: z.string(),
   state: z.string(),
 })
 

package/src/{generated → _api/generated}/cfg_accounts/_utils/schemas/OAuthCallbackRequestRequest.schema.ts

@@ -12,7 +12,7 @@ import { z } from 'zod'
 export const OAuthCallbackRequestRequestSchema = z.object({
   code: z.string().min(10).max(500),
   state: z.string().min(20).max(100),
-  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(),
+  redirect_uri: z.string().optional(),
 })
 
 /**

package/src/{generated → _api/generated}/cfg_accounts/_utils/schemas/OAuthConnection.schema.ts

@@ -16,7 +16,7 @@ export const OAuthConnectionSchema = z.object({
   provider_display: z.string(),
   provider_username: z.string(),
   provider_email: z.email(),
-  provider_avatar_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' }),
+  provider_avatar_url: z.string(),
   connected_at: z.string().datetime({ offset: true }),
   last_login_at: z.string().datetime({ offset: true }),
 })

package/src/{generated → _api/generated}/cfg_accounts/_utils/schemas/OTPRequestRequest.schema.ts

@@ -13,7 +13,7 @@ import * as Enums from '../../enums'
 export const OTPRequestRequestSchema = z.object({
   identifier: z.string().min(1),
   channel: z.nativeEnum(Enums.OTPRequestRequestChannel).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(),
+  source_url: z.string().optional(),
 })
 
 /**

package/src/{generated → _api/generated}/cfg_accounts/_utils/schemas/OTPVerifyRequest.schema.ts

@@ -14,7 +14,7 @@ export const OTPVerifyRequestSchema = z.object({
   identifier: z.string().min(1),
   otp: z.string().min(6).max(6),
   channel: z.nativeEnum(Enums.OTPRequestRequestChannel).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(),
+  source_url: z.string().optional(),
 })
 
 /**

package/src/{generated → _api/generated}/cfg_accounts/_utils/schemas/User.schema.ts

@@ -22,7 +22,7 @@ export const UserSchema = 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 → _api/generated}/cfg_accounts/accounts__oauth/models.ts

@@ -2,18 +2,6 @@
 // Auto-generated by DjangoCFG - see CLAUDE.md
 import * as Enums from "../enums";
 
-/**
- * Request to disconnect OAuth provider.
- * 
- * Request model (no read-only fields).
- */
-export interface OAuthDisconnectRequestRequest {
-  /** OAuth provider to disconnect
-
-  * `github` - GitHub */
-  provider: Enums.OAuthConnectionProvider;
-}
-
 /**
  * Error response for OAuth endpoints.
  * 
@@ -26,6 +14,20 @@ export interface OAuthError {
   error_description?: string;
 }
 
+/**
+ * Request to complete OAuth flow (callback handler).
+ * 
+ * Request model (no read-only fields).
+ */
+export interface OAuthCallbackRequestRequest {
+  /** Authorization code from OAuth provider callback */
+  code: string;
+  /** State token for CSRF verification (from authorize response) */
+  state: string;
+  /** Same redirect_uri used in authorize request. If not provided, uses config's site_url + callback_path */
+  redirect_uri?: string;
+}
+
 /**
  * Request to start OAuth flow.
  * 
@@ -51,17 +53,13 @@ export interface OAuthAuthorizeResponse {
 }
 
 /**
- * Request to complete OAuth flow (callback handler).
+ * Response with available OAuth providers.
  * 
- * Request model (no read-only fields).
+ * Response model (includes read-only fields).
  */
-export interface OAuthCallbackRequestRequest {
-  /** Authorization code from OAuth provider callback */
-  code: string;
-  /** State token for CSRF verification (from authorize response) */
-  state: string;
-  /** Same redirect_uri used in authorize request. If not provided, uses config's site_url + callback_path */
-  redirect_uri?: string;
+export interface OAuthProvidersResponse {
+  /** List of available OAuth providers */
+  providers: Array<Record<string, any>>;
 }
 
 /**
@@ -92,12 +90,38 @@ export interface OAuthTokenResponse {
 }
 
 /**
- * Response with available OAuth providers.
+ * Request to disconnect OAuth provider.
+ * 
+ * Request model (no read-only fields).
+ */
+export interface OAuthDisconnectRequestRequest {
+  /** OAuth provider to disconnect
+
+  * `github` - GitHub */
+  provider: Enums.OAuthConnectionProvider;
+}
+
+/**
+ * Serializer for OAuth connection info (user-facing).
  * 
  * Response model (includes read-only fields).
  */
-export interface OAuthProvidersResponse {
-  /** List of available OAuth providers */
-  providers: Array<Record<string, any>>;
+export interface OAuthConnection {
+  id: number;
+  /** OAuth provider name (github, google, etc.)
+
+  * `github` - GitHub */
+  provider: Enums.OAuthConnectionProvider;
+  provider_display: string;
+  /** Username on the OAuth provider platform */
+  provider_username: string;
+  /** Email from OAuth provider (may differ from user.email) */
+  provider_email: string;
+  /** Avatar URL from OAuth provider */
+  provider_avatar_url: string;
+  /** When this OAuth connection was created */
+  connected_at: string;
+  /** Last time this OAuth connection was used for login */
+  last_login_at: string;
 }
 

package/src/{generated → _api/generated}/cfg_accounts/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_accounts/index.ts

@@ -101,7 +101,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";
@@ -131,6 +131,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 */
@@ -170,6 +172,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(),
@@ -192,6 +195,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_centrifugo/centrifugo__centrifugo_monitoring/client.ts

@@ -12,15 +12,15 @@ export class CentrifugoMonitoring {
     this.client = client;
   }
 
-  async centrifugoMonitorChannelsRetrieve(hours?: number): Promise<Models.ChannelList[]>;
-  async centrifugoMonitorChannelsRetrieve(params?: { hours?: number }): Promise<Models.ChannelList[]>;
+  async centrifugoMonitorChannelsRetrieve(hours?: number): Promise<Models.ChannelList>;
+  async centrifugoMonitorChannelsRetrieve(params?: { hours?: number }): Promise<Models.ChannelList>;
 
   /**
    * Get channel statistics
    * 
    * Returns statistics grouped by channel.
    */
-  async centrifugoMonitorChannelsRetrieve(...args: any[]): Promise<Models.ChannelList[]> {
+  async centrifugoMonitorChannelsRetrieve(...args: any[]): Promise<Models.ChannelList> {
     const isParamsObject = args.length === 1 && typeof args[0] === 'object' && args[0] !== null && !Array.isArray(args[0]);
     
     let params;
@@ -30,7 +30,7 @@ export class CentrifugoMonitoring {
       params = { hours: args[0] };
     }
     const response = await this.client.request('GET', "/cfg/centrifugo/monitor/channels/", { params });
-    return (response as any).results || response;
+    return response;
   }
 
   /**