@djangocfg/api 2.1.88 → 2.1.90

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "2.1.88",
+  "version": "2.1.90",
   "description": "Auto-generated TypeScript API client with React hooks, SWR integration, and Zod validation for Django REST Framework backends",
   "keywords": [
     "django",
@@ -74,7 +74,7 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/ui-nextjs": "^2.1.88",
+    "@djangocfg/ui-nextjs": "^2.1.90",
     "consola": "^3.4.2",
     "next": "^14 || ^15",
     "p-retry": "^7.0.0",
@@ -85,7 +85,7 @@
   "devDependencies": {
     "@types/node": "^24.7.2",
     "@types/react": "^19.0.0",
-    "@djangocfg/typescript-config": "^2.1.88",
+    "@djangocfg/typescript-config": "^2.1.90",
     "next": "^15.0.0",
     "react": "^19.0.0",
     "tsup": "^8.5.0",

package/src/auth/context/AccountsContext.tsx

@@ -59,7 +59,7 @@ export interface AccountsContextValue {
   // Profile operations
   updateProfile: (data: UserProfileUpdateRequest) => Promise<User>;
   partialUpdateProfile: (data: PatchedUserProfileUpdateRequest) => Promise<User>;
-  uploadAvatar: (formData: FormData) => Promise<User>;
+  uploadAvatar: (avatar: File | Blob) => Promise<User>;
   refreshProfile: (callerId?: string) => Promise<User | undefined>;
 
   // Authentication
@@ -165,8 +165,8 @@ export function AccountsProvider({ children }: AccountsProviderProps) {
   };
 
   // Upload avatar
-  const uploadAvatar = async (formData: FormData): Promise<User> => {
-    const result = await avatarMutation(formData, apiAccounts);
+  const uploadAvatar = async (avatar: File | Blob): Promise<User> => {
+    const result = await avatarMutation({ avatar }, apiAccounts);
     await refreshProfile('AccountsContext.uploadAvatar');
     return result as User;
   };

package/src/auth/hooks/useTokenRefresh.ts

@@ -75,18 +75,12 @@ export function useTokenRefresh(options: UseTokenRefreshOptions = {}) {
     authLogger.info('Refreshing token...');
 
     try {
-      const response = await fetch('/api/accounts/token/refresh/', {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ refresh: refreshTokenValue }),
+      // Use generated API client with correct URL (/cfg/accounts/token/refresh/)
+      const result = await apiAccounts.auth.accountsTokenRefreshCreate({
+        refresh: refreshTokenValue,
       });
 
-      if (!response.ok) {
-        throw new Error(`Token refresh failed: ${response.status}`);
-      }
-
-      const data = await response.json();
-      const newAccessToken = data.access;
+      const newAccessToken = result.access;
 
       if (!newAccessToken) {
         throw new Error('No access token in refresh response');

package/src/auth/middlewares/tokenRefresh.ts

@@ -50,23 +50,12 @@ export async function refreshAccessToken(): Promise<string | null> {
       return null;
     }
 
-    // Call the refresh endpoint
-    const response = await fetch('/api/accounts/token/refresh/', {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify({ refresh: refreshToken }),
+    // Use generated API client with correct URL (/cfg/accounts/token/refresh/)
+    const result = await apiAccounts.auth.accountsTokenRefreshCreate({
+      refresh: refreshToken,
     });
 
-    if (!response.ok) {
-      authLogger.error('Token refresh failed with status:', response.status);
-      onTokenRefreshed(null);
-      return null;
-    }
-
-    const data = await response.json();
-    const newAccessToken = data.access;
+    const newAccessToken = result.access;
 
     if (!newAccessToken) {
       authLogger.error('Token refresh response missing access token');

package/src/generated/cfg_accounts/CLAUDE.md

@@ -12,7 +12,7 @@ python manage.py generate_client --groups cfg_accounts --typescript
 |---|---|
 | Version | 3.0.3 |
 | Operations | 14 |
-| Schemas | 19 |
+| Schemas | 20 |
 
 ## Resources
 
@@ -81,12 +81,5 @@ openapi_client = OpenAPIClientConfig(
 )
 ```
 
-**Copy to Next.js** (if `nextjs_admin` configured):
-```python
-nextjs_admin = NextJsAdminConfig(
-    project_path="../frontend/apps/...",
-    api_output_path="app/_lib/api/generated",
-)
-```
-
 @see https://djangocfg.com/docs/features/api-generation
+

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

@@ -31,6 +31,7 @@
  * ```
  */
 import { consola } from 'consola'
+import { CfgAccountsProfileAvatarCreateRequestSchema, type CfgAccountsProfileAvatarCreateRequest } from '../schemas/CfgAccountsProfileAvatarCreateRequest.schema'
 import { PatchedUserProfileUpdateRequestSchema, type PatchedUserProfileUpdateRequest } from '../schemas/PatchedUserProfileUpdateRequest.schema'
 import { UserSchema, type User } from '../schemas/User.schema'
 import { UserProfileUpdateRequestSchema, type UserProfileUpdateRequest } from '../schemas/UserProfileUpdateRequest.schema'
@@ -99,7 +100,7 @@ export async function getAccountsProfileRetrieve(  client?: any
  * @method POST
  * @path /cfg/accounts/profile/avatar/
  */
-export async function createAccountsProfileAvatarCreate(  data: any,  client?: any
+export async function createAccountsProfileAvatarCreate(  data: CfgAccountsProfileAvatarCreateRequest,  client?: any
 ): Promise<User> {
   const api = client || getAPIInstance()
   const response = await api.user_profile.accountsProfileAvatarCreate(data)

package/src/generated/cfg_accounts/_utils/hooks/accounts__user_profile.ts

@@ -21,6 +21,7 @@ import useSWR from 'swr'
 import { useSWRConfig } from 'swr'
 import * as Fetchers from '../fetchers/accounts__user_profile'
 import type { API } from '../../index'
+import type { CfgAccountsProfileAvatarCreateRequest } from '../schemas/CfgAccountsProfileAvatarCreateRequest.schema'
 import type { PatchedUserProfileUpdateRequest } from '../schemas/PatchedUserProfileUpdateRequest.schema'
 import type { User } from '../schemas/User.schema'
 import type { UserProfileUpdateRequest } from '../schemas/UserProfileUpdateRequest.schema'
@@ -48,7 +49,7 @@ export function useAccountsProfileRetrieve(client?: API): ReturnType<typeof useS
 export function useCreateAccountsProfileAvatarCreate() {
   const { mutate } = useSWRConfig()
 
-  return async (data: any, client?: API): Promise<User> => {
+  return async (data: CfgAccountsProfileAvatarCreateRequest, client?: API): Promise<User> => {
     const result = await Fetchers.createAccountsProfileAvatarCreate(data, client)
     // Revalidate related queries
     mutate('cfg-accounts-profile-avatar')

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

@@ -0,0 +1,15 @@
+/**
+ * Zod schema for CfgAccountsProfileAvatarCreateRequest
+ *
+ * This schema provides runtime validation and type inference.
+ *  */
+import { z } from 'zod'
+
+export const CfgAccountsProfileAvatarCreateRequestSchema = z.object({
+  avatar: z.union([z.instanceof(File), z.instanceof(Blob)]),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type CfgAccountsProfileAvatarCreateRequest = z.infer<typeof CfgAccountsProfileAvatarCreateRequestSchema>

package/src/generated/cfg_accounts/_utils/schemas/index.ts

@@ -18,6 +18,7 @@
  */
 
 export * from './CentrifugoToken.schema'
+export * from './CfgAccountsProfileAvatarCreateRequest.schema'
 export * from './OAuthAuthorizeRequestRequest.schema'
 export * from './OAuthAuthorizeResponse.schema'
 export * from './OAuthCallbackRequestRequest.schema'

package/src/generated/cfg_accounts/accounts/models.ts

@@ -104,7 +104,6 @@ export interface User {
   is_superuser: boolean;
   date_joined: string;
   last_login?: string | null;
-  /** Get count of unanswered messages for the user. */
   unanswered_messages_count: number;
   centrifugo: CentrifugoToken | null;
 }

package/src/generated/cfg_accounts/accounts__user_profile/client.ts

@@ -27,8 +27,10 @@ export class UserProfile {
    * Upload avatar image for the current authenticated user. Accepts
    * multipart/form-data with 'avatar' field.
    */
-  async accountsProfileAvatarCreate(data: FormData): Promise<Models.User> {
-    const response = await this.client.request('POST', "/cfg/accounts/profile/avatar/", { formData: data });
+  async accountsProfileAvatarCreate(data: Models.CfgAccountsProfileAvatarCreateRequest): Promise<Models.User> {
+    const formData = new FormData();
+    formData.append('avatar', data.avatar);
+    const response = await this.client.request('POST', "/cfg/accounts/profile/avatar/", { formData });
     return response;
   }
 

package/src/generated/cfg_accounts/accounts__user_profile/models.ts

@@ -25,11 +25,19 @@ export interface User {
   is_superuser: boolean;
   date_joined: string;
   last_login?: string | null;
-  /** Get count of unanswered messages for the user. */
   unanswered_messages_count: number;
   centrifugo: CentrifugoToken | null;
 }
 
+/**
+ * 
+ * Request model (no read-only fields).
+ */
+export interface CfgAccountsProfileAvatarCreateRequest {
+  /** Avatar image file (JPEG, PNG, GIF, WebP, max 5MB) */
+  avatar: File | Blob;
+}
+
 /**
  * Serializer for updating user profile.
  * 

package/src/generated/cfg_accounts/client.ts

@@ -28,6 +28,7 @@ export class APIClient {
   private httpClient: HttpClientAdapter;
   private logger: APILogger | null = null;
   private retryConfig: RetryConfig | null = null;
+  private tokenGetter: (() => string | null) | null = null;
 
   // Sub-clients
   public auth: Auth;
@@ -41,10 +42,12 @@ export class APIClient {
       httpClient?: HttpClientAdapter;
       loggerConfig?: Partial<LoggerConfig>;
       retryConfig?: RetryConfig;
+      tokenGetter?: () => string | null;
     }
   ) {
     this.baseUrl = baseUrl.replace(/\/$/, '');
     this.httpClient = options?.httpClient || new FetchAdapter();
+    this.tokenGetter = options?.tokenGetter || null;
 
     // Initialize logger if config provided
     if (options?.loggerConfig !== undefined) {
@@ -78,6 +81,21 @@ export class APIClient {
     return null;
   }
 
+  /**
+   * Get the base URL for building streaming/download URLs.
+   */
+  getBaseUrl(): string {
+    return this.baseUrl;
+  }
+
+  /**
+   * Get JWT token for URL authentication (used in streaming endpoints).
+   * Returns null if no token getter is configured or no token is available.
+   */
+  getToken(): string | null {
+    return this.tokenGetter ? this.tokenGetter() : null;
+  }
+
   /**
    * Make HTTP request with Django CSRF and session handling.
    * Automatically retries on network errors and 5xx server errors.

package/src/generated/cfg_accounts/index.ts

@@ -148,10 +148,11 @@ export class API {
 
     this._loadTokensFromStorage();
 
-    // Initialize APIClient
+    // Initialize APIClient with token getter for URL authentication
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken(),
     });
 
     // Always inject auth header wrapper (reads token dynamically from storage)
@@ -173,6 +174,7 @@ export class API {
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken(),
     });
 
     // Always inject auth header wrapper (reads token dynamically from storage)

package/src/generated/cfg_accounts/schema.json

@@ -1386,8 +1386,8 @@
           },
           "unanswered_messages_count": {
             "type": "integer",
-            "description": "Get count of unanswered messages for the user.",
-            "readOnly": true
+            "readOnly": true,
+            "default": 0
           },
           "centrifugo": {
             "allOf": [

package/src/generated/cfg_centrifugo/CLAUDE.md

@@ -81,12 +81,5 @@ openapi_client = OpenAPIClientConfig(
 )
 ```
 
-**Copy to Next.js** (if `nextjs_admin` configured):
-```python
-nextjs_admin = NextJsAdminConfig(
-    project_path="../frontend/apps/...",
-    api_output_path="app/_lib/api/generated",
-)
-```
-
 @see https://djangocfg.com/docs/features/api-generation
+

package/src/generated/cfg_centrifugo/client.ts

@@ -28,6 +28,7 @@ export class APIClient {
   private httpClient: HttpClientAdapter;
   private logger: APILogger | null = null;
   private retryConfig: RetryConfig | null = null;
+  private tokenGetter: (() => string | null) | null = null;
 
   // Sub-clients
   public centrifugo_admin_api: CentrifugoAdminApi;
@@ -41,10 +42,12 @@ export class APIClient {
       httpClient?: HttpClientAdapter;
       loggerConfig?: Partial<LoggerConfig>;
       retryConfig?: RetryConfig;
+      tokenGetter?: () => string | null;
     }
   ) {
     this.baseUrl = baseUrl.replace(/\/$/, '');
     this.httpClient = options?.httpClient || new FetchAdapter();
+    this.tokenGetter = options?.tokenGetter || null;
 
     // Initialize logger if config provided
     if (options?.loggerConfig !== undefined) {
@@ -78,6 +81,21 @@ export class APIClient {
     return null;
   }
 
+  /**
+   * Get the base URL for building streaming/download URLs.
+   */
+  getBaseUrl(): string {
+    return this.baseUrl;
+  }
+
+  /**
+   * Get JWT token for URL authentication (used in streaming endpoints).
+   * Returns null if no token getter is configured or no token is available.
+   */
+  getToken(): string | null {
+    return this.tokenGetter ? this.tokenGetter() : null;
+  }
+
   /**
    * Make HTTP request with Django CSRF and session handling.
    * Automatically retries on network errors and 5xx server errors.

package/src/generated/cfg_centrifugo/index.ts

@@ -147,10 +147,11 @@ export class API {
 
     this._loadTokensFromStorage();
 
-    // Initialize APIClient
+    // Initialize APIClient with token getter for URL authentication
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken(),
     });
 
     // Always inject auth header wrapper (reads token dynamically from storage)
@@ -172,6 +173,7 @@ export class API {
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken(),
     });
 
     // Always inject auth header wrapper (reads token dynamically from storage)

package/src/generated/cfg_totp/CLAUDE.md

@@ -79,12 +79,5 @@ openapi_client = OpenAPIClientConfig(
 )
 ```
 
-**Copy to Next.js** (if `nextjs_admin` configured):
-```python
-nextjs_admin = NextJsAdminConfig(
-    project_path="../frontend/apps/...",
-    api_output_path="app/_lib/api/generated",
-)
-```
-
 @see https://djangocfg.com/docs/features/api-generation
+

package/src/generated/cfg_totp/client.ts

@@ -29,6 +29,7 @@ export class APIClient {
   private httpClient: HttpClientAdapter;
   private logger: APILogger | null = null;
   private retryConfig: RetryConfig | null = null;
+  private tokenGetter: (() => string | null) | null = null;
 
   // Sub-clients
   public backup_codes: BackupCodes;
@@ -43,10 +44,12 @@ export class APIClient {
       httpClient?: HttpClientAdapter;
       loggerConfig?: Partial<LoggerConfig>;
       retryConfig?: RetryConfig;
+      tokenGetter?: () => string | null;
     }
   ) {
     this.baseUrl = baseUrl.replace(/\/$/, '');
     this.httpClient = options?.httpClient || new FetchAdapter();
+    this.tokenGetter = options?.tokenGetter || null;
 
     // Initialize logger if config provided
     if (options?.loggerConfig !== undefined) {
@@ -81,6 +84,21 @@ export class APIClient {
     return null;
   }
 
+  /**
+   * Get the base URL for building streaming/download URLs.
+   */
+  getBaseUrl(): string {
+    return this.baseUrl;
+  }
+
+  /**
+   * Get JWT token for URL authentication (used in streaming endpoints).
+   * Returns null if no token getter is configured or no token is available.
+   */
+  getToken(): string | null {
+    return this.tokenGetter ? this.tokenGetter() : null;
+  }
+
   /**
    * Make HTTP request with Django CSRF and session handling.
    * Automatically retries on network errors and 5xx server errors.

package/src/generated/cfg_totp/index.ts

@@ -153,10 +153,11 @@ export class API {
 
     this._loadTokensFromStorage();
 
-    // Initialize APIClient
+    // Initialize APIClient with token getter for URL authentication
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken(),
     });
 
     // Always inject auth header wrapper (reads token dynamically from storage)
@@ -179,6 +180,7 @@ export class API {
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken(),
     });
 
     // Always inject auth header wrapper (reads token dynamically from storage)

package/src/generated/cfg_totp/totp/models.ts

@@ -1 +1,3 @@
 // Auto-generated by DjangoCFG - see CLAUDE.md
+// No models for this endpoint (all types are primitives or binary)
+export {};

package/src/generated/cfg_webpush/CLAUDE.md

@@ -59,12 +59,5 @@ openapi_client = OpenAPIClientConfig(
 )
 ```
 
-**Copy to Next.js** (if `nextjs_admin` configured):
-```python
-nextjs_admin = NextJsAdminConfig(
-    project_path="../frontend/apps/...",
-    api_output_path="app/_lib/api/generated",
-)
-```
-
 @see https://djangocfg.com/docs/features/api-generation
+

package/src/generated/cfg_webpush/client.ts

@@ -25,6 +25,7 @@ export class APIClient {
   private httpClient: HttpClientAdapter;
   private logger: APILogger | null = null;
   private retryConfig: RetryConfig | null = null;
+  private tokenGetter: (() => string | null) | null = null;
 
   // Sub-clients
   public web_push: WebPush;
@@ -35,10 +36,12 @@ export class APIClient {
       httpClient?: HttpClientAdapter;
       loggerConfig?: Partial<LoggerConfig>;
       retryConfig?: RetryConfig;
+      tokenGetter?: () => string | null;
     }
   ) {
     this.baseUrl = baseUrl.replace(/\/$/, '');
     this.httpClient = options?.httpClient || new FetchAdapter();
+    this.tokenGetter = options?.tokenGetter || null;
 
     // Initialize logger if config provided
     if (options?.loggerConfig !== undefined) {
@@ -69,6 +72,21 @@ export class APIClient {
     return null;
   }
 
+  /**
+   * Get the base URL for building streaming/download URLs.
+   */
+  getBaseUrl(): string {
+    return this.baseUrl;
+  }
+
+  /**
+   * Get JWT token for URL authentication (used in streaming endpoints).
+   * Returns null if no token getter is configured or no token is available.
+   */
+  getToken(): string | null {
+    return this.tokenGetter ? this.tokenGetter() : null;
+  }
+
   /**
    * Make HTTP request with Django CSRF and session handling.
    * Automatically retries on network errors and 5xx server errors.

package/src/generated/cfg_webpush/index.ts

@@ -132,10 +132,11 @@ export class API {
 
     this._loadTokensFromStorage();
 
-    // Initialize APIClient
+    // Initialize APIClient with token getter for URL authentication
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken(),
     });
 
     // Always inject auth header wrapper (reads token dynamically from storage)
@@ -154,6 +155,7 @@ export class API {
     this._client = new APIClient(this.baseUrl, {
       retryConfig: this.options?.retryConfig,
       loggerConfig: this.options?.loggerConfig,
+      tokenGetter: () => this.getToken(),
     });
 
     // Always inject auth header wrapper (reads token dynamically from storage)