@djangocfg/api 2.1.42 → 2.1.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "2.1.42",
+  "version": "2.1.43",
   "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.42",
+    "@djangocfg/ui-nextjs": "^2.1.43",
     "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.42",
+    "@djangocfg/typescript-config": "^2.1.43",
     "next": "^15.0.0",
     "react": "^19.0.0",
     "tsup": "^8.5.0",

package/src/auth/context/AccountsContext.tsx

@@ -13,11 +13,23 @@
 
 "use client";
 
-import { createContext, useContext, ReactNode, useState, useCallback, useRef, useEffect } from 'react';
-import { getCachedProfile, setCachedProfile, clearProfileCache } from '../hooks/useProfileCache';
-import { authLogger } from '../utils/logger';
+import {
+    createContext, ReactNode, useCallback, useContext, useEffect, useRef, useState
+} from 'react';
+
 // Import API instance and fetcher
 import { api as apiAccounts, getAccountsProfileRetrieve } from '../../';
+// Import schema
+import { PatchedUserProfileUpdateRequestSchema } from '../../generated/cfg_accounts';
+// Import hooks from generated API hooks
+import {
+    useCreateAccountsOtpRequestCreate, useCreateAccountsOtpVerifyCreate,
+    useCreateAccountsProfileAvatarCreate, useCreateAccountsTokenRefreshCreate,
+    usePartialUpdateAccountsProfilePartialUpdate, useUpdateAccountsProfileUpdateUpdate
+} from '../../generated/cfg_accounts/_utils/hooks';
+import { clearProfileCache, getCachedProfile, setCachedProfile } from '../hooks/useProfileCache';
+import { authLogger } from '../utils/logger';
+
 // Import types from generated API
 import type {
   User,
@@ -30,18 +42,6 @@ import type {
   TokenRefresh,
   API,
 } from '../../generated/cfg_accounts';
-// Import schema
-import { PatchedUserProfileUpdateRequestSchema } from '../../generated/cfg_accounts';
-// Import hooks from generated API hooks
-import {
-  usePartialUpdateAccountsProfilePartialUpdate,
-  useUpdateAccountsProfileUpdateUpdate,
-  useCreateAccountsProfileAvatarCreate,
-  useCreateAccountsOtpRequestCreate,
-  useCreateAccountsOtpVerifyCreate,
-  useCreateAccountsTokenRefreshCreate,
-} from '../../generated/cfg_accounts/_utils/hooks';
-
 // Re-export schemas for external use
 export { PatchedUserProfileUpdateRequestSchema };
 export type { PatchedUserProfileUpdateRequest };

package/src/auth/context/AuthContext.tsx

@@ -6,13 +6,14 @@ import React, {
     createContext, ReactNode, useCallback, useContext, useEffect, useMemo, useRef, useState
 } from 'react';
 
-import { api as apiAccounts, Enums } from '../../';
-import { useAccountsContext, AccountsProvider } from './AccountsContext';
-import { useLocalStorage, useQueryParams, useCfgRouter } from '@djangocfg/ui-nextjs/hooks';
-import { getCachedProfile, clearProfileCache } from '../hooks/useProfileCache';
+import { useCfgRouter, useLocalStorage, useQueryParams } from '@djangocfg/ui-nextjs/hooks';
 
+import { api as apiAccounts, Enums } from '../../';
+import { clearProfileCache, getCachedProfile } from '../hooks/useProfileCache';
+import { Analytics, AnalyticsCategory, AnalyticsEvent } from '../utils/analytics';
 import { authLogger } from '../utils/logger';
-import { Analytics, AnalyticsEvent, AnalyticsCategory } from '../utils/analytics';
+import { AccountsProvider, useAccountsContext } from './AccountsContext';
+
 import type { AuthConfig, AuthContextType, AuthProviderProps, UserProfile } from './types';
 
 // Default routes

package/src/auth/hooks/useAuthForm.ts

@@ -3,9 +3,9 @@
 import { useCallback, useEffect, useState } from 'react';
 
 import { useAuth } from '../context';
+import { authLogger } from '../utils/logger';
 import { useAutoAuth } from './useAutoAuth';
 import { useLocalStorage } from './useLocalStorage';
-import { authLogger } from '../utils/logger';
 
 export interface AuthFormState {
   identifier: string; // Email or phone number

package/src/auth/hooks/useAuthGuard.ts

@@ -2,9 +2,10 @@
 
 import { useEffect } from 'react';
 
-import { useAuth } from '../context';
 import { useCfgRouter } from '@djangocfg/ui-nextjs/hooks';
 
+import { useAuth } from '../context';
+
 interface UseAuthGuardOptions {
   redirectTo?: string;
   requireAuth?: boolean;

package/src/auth/hooks/useAutoAuth.ts

@@ -1,8 +1,10 @@
 'use client';
 
-import { useEffect } from 'react';
 import { usePathname } from 'next/navigation';
-import { useQueryParams, useCfgRouter } from '@djangocfg/ui-nextjs/hooks';
+import { useEffect } from 'react';
+
+import { useCfgRouter, useQueryParams } from '@djangocfg/ui-nextjs/hooks';
+
 import { authLogger } from '../utils/logger';
 
 export interface UseAutoAuthOptions {

package/src/auth/hooks/useGithubAuth.ts

@@ -2,10 +2,11 @@
 
 import { useCallback, useState } from 'react';
 
-import { apiAccounts } from '../../clients';
 import { useCfgRouter } from '@djangocfg/ui-nextjs/hooks';
+
+import { apiAccounts } from '../../clients';
+import { Analytics, AnalyticsCategory, AnalyticsEvent } from '../utils/analytics';
 import { authLogger } from '../utils/logger';
-import { Analytics, AnalyticsEvent, AnalyticsCategory } from '../utils/analytics';
 
 export interface UseGithubAuthOptions {
   sourceUrl?: string;

package/src/auth/hooks/useLocalStorage.ts

@@ -1,6 +1,7 @@
 'use client';
 
 import { useEffect, useState } from 'react';
+
 import { authLogger } from '../utils/logger';
 
 /**

package/src/auth/hooks/useProfileCache.ts

@@ -11,7 +11,7 @@
 
 import type { User } from '../../';
 import { authLogger as profileLogger } from '../utils/logger';
-import { encodeBase64, decodeBase64 } from './useBase64';
+import { decodeBase64, encodeBase64 } from './useBase64';
 
 // Cache configuration
 const CACHE_KEY = 'user_profile_cache';

package/src/auth/hooks/useSessionStorage.ts

@@ -1,6 +1,7 @@
 'use client';
 
 import { useState } from 'react';
+
 import { authLogger } from '../utils/logger';
 
 /**

package/src/clients.ts

@@ -9,8 +9,8 @@
  */
 
 import { API as AccountsAPIClass, LocalStorageAdapter } from './generated/cfg_accounts';
-import { API as WebPushAPIClass } from './generated/cfg_webpush';
 import { API as CentrifugoAPIClass } from './generated/cfg_centrifugo';
+import { API as WebPushAPIClass } from './generated/cfg_webpush';
 
 // ============================================================================
 // Pre-configured API instances (for hooks and direct usage)

package/src/generated/cfg_accounts/CLAUDE.md

@@ -0,0 +1,92 @@
+# Django CFG API - Typescript Client
+
+Auto-generated. **Do not edit manually.**
+
+```bash
+python manage.py generate_client --groups cfg_accounts --typescript
+```
+
+## Stats
+
+| | |
+|---|---|
+| Version | 3.0.3 |
+| Operations | 14 |
+| Schemas | 19 |
+
+## Resources
+
+- **Auth** (1 ops)
+- **OAuth** (5 ops)
+- **User Profile** (6 ops)
+- **accounts** (2 ops)
+
+## Operations
+
+**Auth:**
+- `POST` /cfg/accounts/token/refresh/ → `cfg_accounts_token_refresh_create`
+
+**OAuth:**
+- `GET` /cfg/accounts/oauth/connections/ → `cfg_accounts_oauth_connections_list`
+- `POST` /cfg/accounts/oauth/disconnect/ → `cfg_accounts_oauth_disconnect_create`
+- `POST` /cfg/accounts/oauth/github/authorize/ → `cfg_accounts_oauth_github_authorize_create`
+- `POST` /cfg/accounts/oauth/github/callback/ → `cfg_accounts_oauth_github_callback_create`
+- `GET` /cfg/accounts/oauth/providers/ → `cfg_accounts_oauth_providers_retrieve`
+
+**User Profile:**
+- `POST` /cfg/accounts/profile/avatar/ → `cfg_accounts_profile_avatar_create`
+- `PATCH` /cfg/accounts/profile/partial/ → `cfg_accounts_profile_partial_partial_update`
+- `PUT` /cfg/accounts/profile/partial/ → `cfg_accounts_profile_partial_update`
+- `GET` /cfg/accounts/profile/ → `cfg_accounts_profile_retrieve`
+- `PATCH` /cfg/accounts/profile/update/ → `cfg_accounts_profile_update_partial_update`
+- `PUT` /cfg/accounts/profile/update/ → `cfg_accounts_profile_update_update`
+
+**accounts:**
+- `POST` /cfg/accounts/otp/request/ → `cfg_accounts_otp_request_create`
+- `POST` /cfg/accounts/otp/verify/ → `cfg_accounts_otp_verify_create`
+
+## Usage
+
+```typescript
+import { APIClient } from './';
+
+const client = new APIClient({ baseUrl, token });
+
+await client.oauth.list();
+await client.oauth.retrieve({ id: 1 });
+await client.oauth.create({ ... });
+await client.accounts.create({ ... });
+```
+
+**SWR Hooks:**
+```typescript
+import { useOauthList } from './hooks';
+const { data, isLoading } = useOauthList();
+```
+
+## How It Works
+
+```
+DRF ViewSets → drf-spectacular → OpenAPI → IR Parser → Generator → This Client
+```
+
+**Configuration** (`api/config.py`):
+```python
+openapi_client = OpenAPIClientConfig(
+    enabled=True,
+    groups=[OpenAPIGroupConfig(name="cfg_accounts", apps=["..."])],
+    generate_zod_schemas=True,  # → schemas.ts
+    generate_fetchers=True,     # → fetchers.ts
+    generate_swr_hooks=True,    # → hooks.ts
+)
+```
+
+**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.ts

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * Typed fetchers for Accounts
  *

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * Typed fetchers for Auth
  *

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * Typed fetchers for Oauth
  *

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * Typed fetchers for User Profile
  *

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * Typed Fetchers - Universal API functions
  *

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 'use client';
 
 /**

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 'use client';
 
 /**

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 'use client';
 
 /**

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 'use client';
 
 /**

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 'use client';
 
 /**

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * Zod Schemas - Runtime validation and type inference
  *

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

@@ -1,10 +1,3 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 export * from "./client";
 export * as Models from "./models";

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 import * as Enums from "../enums";
 
 /**

package/src/generated/cfg_accounts/accounts__auth/index.ts

@@ -1,10 +1,3 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 export * from "./client";
 export * as Models from "./models";

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * 
  * Request model (no read-only fields).

package/src/generated/cfg_accounts/accounts__oauth/index.ts

@@ -1,10 +1,3 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 export * from "./client";
 export * as Models from "./models";

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 import * as Enums from "../enums";
 
 /**

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

@@ -1,10 +1,3 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 export * from "./client";
 export * as Models from "./models";

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

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * Serializer for user details.
  * 

package/src/generated/cfg_accounts/api-instance.ts

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * Global API Instance - Singleton configuration
  *

package/src/generated/cfg_accounts/enums.ts

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * OAuth provider name (github, google, etc.)
  * * `github` - GitHub

package/src/generated/cfg_accounts/errors.ts

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * API Error Classes
  *

package/src/generated/cfg_accounts/http.ts

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * HTTP Client Adapter Pattern
  *

package/src/generated/cfg_accounts/index.ts

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * Django CFG API - API Client with JWT Management
  *

package/src/generated/cfg_accounts/logger.ts

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * API Logger with Consola
  * Beautiful console logging for API requests and responses

package/src/generated/cfg_accounts/retry.ts

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * Retry Configuration and Utilities
  *

package/src/generated/cfg_accounts/storage.ts

@@ -1,11 +1,4 @@
-/**
- * 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/
- */
+// Auto-generated by DjangoCFG - see CLAUDE.md
 /**
  * Storage adapters for cross-platform token storage.
  *