@djangocfg/api 2.1.99 → 2.1.101

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "2.1.99",
+  "version": "2.1.101",
   "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.99",
+    "@djangocfg/ui-nextjs": "^2.1.101",
     "consola": "^3.4.2",
     "next": ">=16.0.0",
     "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.99",
+    "@djangocfg/typescript-config": "^2.1.101",
     "next": "^16.0.0",
     "react": "^19.0.0",
     "tsup": "^8.5.0",

package/src/auth/context/AuthContext.tsx

@@ -553,6 +553,24 @@ const AuthProviderInternal: React.FC<AuthProviderProps> = ({ children, config })
     return Boolean(user?.is_staff || user?.is_superuser);
   }, [user]);
 
+  // Profile management: Update profile data
+  const updateProfile = useCallback(
+    async (data: { first_name?: string; last_name?: string; username?: string }): Promise<UserProfile> => {
+      const result = await accounts.partialUpdateProfile(data);
+      return result as UserProfile;
+    },
+    [accounts]
+  );
+
+  // Profile management: Upload avatar
+  const uploadAvatar = useCallback(
+    async (avatar: File | Blob): Promise<UserProfile> => {
+      const result = await accounts.uploadAvatar(avatar);
+      return result as UserProfile;
+    },
+    [accounts]
+  );
+
   // Memoized context value
   const value = useMemo<AuthContextType>(
     () => ({
@@ -580,6 +598,9 @@ const AuthProviderInternal: React.FC<AuthProviderProps> = ({ children, config })
       getRedirectUrl: redirectManager.getFinalRedirectUrl,
       clearRedirectUrl: redirectManager.clearRedirect,
       hasRedirectUrl: redirectManager.hasRedirect,
+      // Profile management
+      updateProfile,
+      uploadAvatar,
     }),
     [
       user,
@@ -598,6 +619,8 @@ const AuthProviderInternal: React.FC<AuthProviderProps> = ({ children, config })
       refreshToken,
       logout,
       redirectManager,
+      updateProfile,
+      uploadAvatar,
     ],
   );
 
@@ -661,6 +684,14 @@ const defaultAuthState: AuthContextType = {
   getRedirectUrl: () => null,
   clearRedirectUrl: () => {},
   hasRedirectUrl: () => false,
+  updateProfile: async () => {
+    authLogger.warn('useAuth: updateProfile called outside AuthProvider');
+    return {} as UserProfile;
+  },
+  uploadAvatar: async () => {
+    authLogger.warn('useAuth: uploadAvatar called outside AuthProvider');
+    return {} as UserProfile;
+  },
 };
 
 /**

package/src/auth/context/types.ts

@@ -64,6 +64,10 @@ export interface AuthContextType {
   getRedirectUrl: () => string;
   clearRedirectUrl: () => void;
   hasRedirectUrl: () => boolean;
+
+  // Profile Management Methods
+  updateProfile: (data: { first_name?: string; last_name?: string; username?: string }) => Promise<UserProfile>;
+  uploadAvatar: (avatar: File | Blob) => Promise<UserProfile>;
 }
 
 // Provider props

package/src/auth/hooks/index.ts

@@ -48,3 +48,10 @@ export {
 
 // Token refresh
 export { useTokenRefresh } from './useTokenRefresh';
+
+// Account deletion
+export {
+  useDeleteAccount,
+  type UseDeleteAccountReturn,
+  type DeleteAccountResult,
+} from './useDeleteAccount';

package/src/auth/hooks/useDeleteAccount.ts

@@ -0,0 +1,90 @@
+'use client';
+
+import { useCallback, useState } from 'react';
+
+import { apiAccounts } from '../../clients';
+import { authLogger } from '../utils/logger';
+import { useAuth } from '../context';
+
+export interface DeleteAccountResult {
+  success: boolean;
+  message: string;
+}
+
+export interface UseDeleteAccountReturn {
+  /** Loading state */
+  isLoading: boolean;
+  /** Error message */
+  error: string | null;
+  /** Delete the account */
+  deleteAccount: () => Promise<DeleteAccountResult>;
+  /** Clear error */
+  clearError: () => void;
+}
+
+/**
+ * Hook for deleting user account.
+ *
+ * This performs a soft delete - deactivates the account and anonymizes personal data.
+ * The account can be restored by an administrator if needed.
+ *
+ * @example
+ * ```tsx
+ * const { deleteAccount, isLoading, error } = useDeleteAccount();
+ *
+ * const handleDelete = async () => {
+ *   const result = await deleteAccount();
+ *   if (result.success) {
+ *     // Account deleted, perform logout
+ *     await logout();
+ *   }
+ * };
+ * ```
+ */
+export const useDeleteAccount = (): UseDeleteAccountReturn => {
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const { logout } = useAuth();
+
+  const clearError = useCallback(() => {
+    setError(null);
+  }, []);
+
+  /**
+   * Delete the user account (soft delete)
+   */
+  const deleteAccount = useCallback(async (): Promise<DeleteAccountResult> => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      authLogger.info('Deleting account...');
+
+      const response = await apiAccounts.user_profile.accountsProfileDeleteCreate();
+
+      if (!response.success) {
+        authLogger.error('Failed to delete account:', response.message);
+        setError(response.message);
+        throw new Error(response.message);
+      }
+
+    } catch (error) {
+      authLogger.error('Failed to delete account:', error);
+      throw error;
+    } finally {
+      setIsLoading(false);
+    }
+
+    // Return success response
+
+    await logout();
+    return { success: true, message: 'Account deleted successfully' };
+  }, []);
+
+  return {
+    isLoading,
+    error,
+    deleteAccount,
+    clearError,
+  };
+};

package/src/generated/cfg_accounts/CLAUDE.md

@@ -11,14 +11,14 @@ python manage.py generate_client --groups cfg_accounts --typescript
 | | |
 |---|---|
 | Version | 3.0.3 |
-| Operations | 14 |
-| Schemas | 20 |
+| Operations | 15 |
+| Schemas | 21 |
 
 ## Resources
 
 - **Auth** (1 ops)
 - **OAuth** (5 ops)
-- **User Profile** (6 ops)
+- **User Profile** (7 ops)
 - **accounts** (2 ops)
 
 ## Operations
@@ -35,6 +35,7 @@ python manage.py generate_client --groups cfg_accounts --typescript
 
 **User Profile:**
 - `POST` /cfg/accounts/profile/avatar/ → `cfg_accounts_profile_avatar_create`
+- `POST` /cfg/accounts/profile/delete/ → `cfg_accounts_profile_delete_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`

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

@@ -31,6 +31,7 @@
  * ```
  */
 import { consola } from 'consola'
+import { AccountDeleteResponseSchema, type AccountDeleteResponse } from '../schemas/AccountDeleteResponse.schema'
 import { CfgAccountsProfileAvatarCreateRequestSchema, type CfgAccountsProfileAvatarCreateRequest } from '../schemas/CfgAccountsProfileAvatarCreateRequest.schema'
 import { PatchedUserProfileUpdateRequestSchema, type PatchedUserProfileUpdateRequest } from '../schemas/PatchedUserProfileUpdateRequest.schema'
 import { UserSchema, type User } from '../schemas/User.schema'
@@ -151,6 +152,63 @@ export async function createAccountsProfileAvatarCreate(  data: CfgAccountsProfi
 }
 
 
+/**
+ * Delete user account
+ *
+ * @method POST
+ * @path /cfg/accounts/profile/delete/
+ */
+export async function createAccountsProfileDeleteCreate(  client?: any
+): Promise<AccountDeleteResponse> {
+  const api = client || getAPIInstance()
+  const response = await api.user_profile.accountsProfileDeleteCreate()
+  try {
+    return AccountDeleteResponseSchema.parse(response)
+  } catch (error) {
+    // Zod validation error - log detailed information
+    consola.error('❌ Zod Validation Failed');
+    consola.box(`createAccountsProfileDeleteCreate\nPath: /cfg/accounts/profile/delete/\nMethod: POST`);
+
+    if (error instanceof Error && 'issues' in error && Array.isArray((error as any).issues)) {
+      consola.error('Validation Issues:');
+      (error as any).issues.forEach((issue: any, index: number) => {
+        consola.error(`  ${index + 1}. ${issue.path.join('.') || 'root'}`);
+        consola.error(`     ├─ Message: ${issue.message}`);
+        if (issue.expected) consola.error(`     ├─ Expected: ${issue.expected}`);
+        if (issue.received) consola.error(`     └─ Received: ${issue.received}`);
+      });
+    }
+
+    consola.error('Response data:', response);
+
+    // Dispatch browser CustomEvent (only if window is defined)
+    if (typeof window !== 'undefined' && error instanceof Error && 'issues' in error) {
+      try {
+        const event = new CustomEvent('zod-validation-error', {
+          detail: {
+            operation: 'createAccountsProfileDeleteCreate',
+            path: '/cfg/accounts/profile/delete/',
+            method: 'POST',
+            error: error,
+            response: response,
+            timestamp: new Date(),
+          },
+          bubbles: true,
+          cancelable: false,
+        });
+        window.dispatchEvent(event);
+      } catch (eventError) {
+        // Silently fail - event dispatch should never crash the app
+        consola.warn('Failed to dispatch validation error event:', eventError);
+      }
+    }
+
+    // Re-throw the error
+    throw error;
+  }
+}
+
+
 /**
  * Partial update user profile
  *

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 { AccountDeleteResponse } from '../schemas/AccountDeleteResponse.schema'
 import type { CfgAccountsProfileAvatarCreateRequest } from '../schemas/CfgAccountsProfileAvatarCreateRequest.schema'
 import type { PatchedUserProfileUpdateRequest } from '../schemas/PatchedUserProfileUpdateRequest.schema'
 import type { User } from '../schemas/User.schema'
@@ -58,6 +59,24 @@ export function useCreateAccountsProfileAvatarCreate() {
 }
 
 
+/**
+ * Delete user account
+ *
+ * @method POST
+ * @path /cfg/accounts/profile/delete/
+ */
+export function useCreateAccountsProfileDeleteCreate() {
+  const { mutate } = useSWRConfig()
+
+  return async (client?: API): Promise<AccountDeleteResponse> => {
+    const result = await Fetchers.createAccountsProfileDeleteCreate(client)
+    // Revalidate related queries
+    mutate('cfg-accounts-profile-delete')
+    return result
+  }
+}
+
+
 /**
  * Partial update user profile
  *

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

@@ -0,0 +1,20 @@
+/**
+ * Zod schema for AccountDeleteResponse
+ *
+ * This schema provides runtime validation and type inference.
+ *  * Response serializer for account deletion.
+ *  */
+import { z } from 'zod'
+
+/**
+ * Response serializer for account deletion.
+ */
+export const AccountDeleteResponseSchema = z.object({
+  success: z.boolean(),
+  message: z.string(),
+})
+
+/**
+ * Infer TypeScript type from Zod schema
+ */
+export type AccountDeleteResponse = z.infer<typeof AccountDeleteResponseSchema>

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

@@ -17,6 +17,7 @@
  * ```
  */
 
+export * from './AccountDeleteResponse.schema'
 export * from './CentrifugoToken.schema'
 export * from './CfgAccountsProfileAvatarCreateRequest.schema'
 export * from './OAuthAuthorizeRequestRequest.schema'

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

@@ -34,6 +34,20 @@ export class UserProfile {
     return response;
   }
 
+  /**
+   * Delete user account
+   * 
+   * Permanently delete the current user's account. This operation: -
+   * Deactivates the account (user cannot log in) - Anonymizes personal data
+   * (GDPR compliance) - Frees up the email address for re-registration -
+   * Preserves audit trail The account can be restored by an administrator if
+   * needed.
+   */
+  async accountsProfileDeleteCreate(): Promise<Models.AccountDeleteResponse> {
+    const response = await this.client.request('POST', "/cfg/accounts/profile/delete/");
+    return response;
+  }
+
   /**
    * Partial update user profile
    * 

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

@@ -38,6 +38,18 @@ export interface CfgAccountsProfileAvatarCreateRequest {
   avatar: File | Blob;
 }
 
+/**
+ * Response serializer for account deletion.
+ * 
+ * Response model (includes read-only fields).
+ */
+export interface AccountDeleteResponse {
+  /** Whether the account was successfully deleted */
+  success: boolean;
+  /** Human-readable message about the deletion */
+  message: string;
+}
+
 /**
  * Serializer for updating user profile.
  * 

package/src/generated/cfg_accounts/schema.json

@@ -499,6 +499,57 @@
         "x-async-capable": false
       }
     },
+    "/cfg/accounts/profile/delete/": {
+      "post": {
+        "operationId": "cfg_accounts_profile_delete_create",
+        "description": "\n    Permanently delete the current user's account.\n\n    This operation:\n    - Deactivates the account (user cannot log in)\n    - Anonymizes personal data (GDPR compliance)\n    - Frees up the email address for re-registration\n    - Preserves audit trail\n\n    The account can be restored by an administrator if needed.\n    ",
+        "summary": "Delete user account",
+        "tags": [
+          "User Profile"
+        ],
+        "security": [
+          {
+            "jwtAuth": []
+          },
+          {
+            "cookieAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AccountDeleteResponse"
+                }
+              }
+            },
+            "description": ""
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "description": "Authentication credentials were not provided."
+                }
+              }
+            },
+            "description": ""
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "description": "Account is already deleted."
+                }
+              }
+            },
+            "description": ""
+          }
+        },
+        "x-async-capable": false
+      }
+    },
     "/cfg/accounts/profile/partial/": {
       "put": {
         "operationId": "cfg_accounts_profile_partial_update",
@@ -868,6 +919,24 @@
   },
   "components": {
     "schemas": {
+      "AccountDeleteResponse": {
+        "type": "object",
+        "description": "Response serializer for account deletion.",
+        "properties": {
+          "success": {
+            "type": "boolean",
+            "description": "Whether the account was successfully deleted"
+          },
+          "message": {
+            "type": "string",
+            "description": "Human-readable message about the deletion"
+          }
+        },
+        "required": [
+          "message",
+          "success"
+        ]
+      },
       "CentrifugoToken": {
         "type": "object",
         "description": "Nested serializer for Centrifugo WebSocket connection token.",