@djangocfg/api 2.1.356 → 2.1.358

package/src/auth/context/AccountsContext.tsx

@@ -1,5 +1,5 @@
 /**
- * Accounts Context
+ * CfgAccounts Context
  *
  * Manages user authentication and profile operations using generated SWR hooks.
  *
@@ -14,11 +14,11 @@
 "use client";
 
 import {
-    createContext, ReactNode, useCallback, useContext, useEffect, useRef, useState
+    createContext, memo, ReactNode, useCallback, useContext, useEffect, useMemo, useRef, useState
 } from 'react';
 
 import { CfgAccountsApi } from '../../';
-import { Accounts, Auth, UserProfile } from '../../_api/generated/_cfg_accounts/sdk.gen';
+import { CfgAccountsProfile } from '../../_api/generated/_cfg_accounts/sdk.gen';
 import {
     useCfgAccountsOtpRequestCreate,
     useCfgAccountsOtpVerifyCreate,
@@ -111,7 +111,7 @@ export function AccountsProvider({ children }: AccountsProviderProps) {
     setProfileError(null);
     try {
       authLogger.debug(`Fetching profile from API (caller: ${callerId}, force: ${force})`);
-      const res = await UserProfile.cfgAccountsProfileRetrieve({ throwOnError: true });
+      const res = await CfgAccountsProfile.cfgAccountsProfileRetrieve({ throwOnError: true });
       const result = res.data;
       setProfile(result);
       profileRef.current = result;
@@ -190,7 +190,7 @@ export function AccountsProvider({ children }: AccountsProviderProps) {
     clearProfileCache();
   }, []);
 
-  const value: AccountsContextValue = {
+  const value: AccountsContextValue = useMemo(() => ({
     profile,
     isLoadingProfile,
     profileError,
@@ -202,7 +202,19 @@ export function AccountsProvider({ children }: AccountsProviderProps) {
     verifyOTP,
     refreshToken,
     logout,
-  };
+  }), [
+    profile,
+    isLoadingProfile,
+    profileError,
+    updateProfile,
+    partialUpdateProfile,
+    uploadAvatar,
+    refreshProfile,
+    requestOTP,
+    verifyOTP,
+    refreshToken,
+    logout,
+  ]);
 
   return (
     <AccountsContext.Provider value={value}>

package/src/auth/context/AuthContext.tsx

@@ -4,7 +4,7 @@
 import { isDev, isBrowser } from "../utils/env";
 import { usePathname } from 'next/navigation';
 import React, {
-    createContext, ReactNode, useCallback, useContext, useEffect, useMemo, useRef, useState
+    createContext, memo, ReactNode, useCallback, useContext, useEffect, useMemo, useRef, useState
 } from 'react';
 import { SWRConfig } from 'swr';
 
@@ -629,7 +629,13 @@ const AuthProviderInternal: React.FC<AuthProviderProps> = ({ children, config })
 };
 
 // Wrapper that provides AccountsContext
-export const AuthProvider: React.FC<AuthProviderProps> = ({ children, config }) => {
+/**
+ * AuthProvider — wraps AccountsProvider + AuthProviderInternal.
+ *
+ * Memoised: re-renders only when `config` reference or `children` change.
+ * Internal auth state is isolated inside AuthProviderInternal.
+ */
+function AuthProviderRaw({ children, config }: AuthProviderProps) {
   return (
     <AccountsProvider>
       <AuthProviderInternal config={config}>
@@ -637,7 +643,9 @@ export const AuthProvider: React.FC<AuthProviderProps> = ({ children, config })
       </AuthProviderInternal>
     </AccountsProvider>
   );
-};
+}
+
+export const AuthProvider = memo(AuthProviderRaw);
 
 /**
  * Default auth state for SSR/outside provider

package/src/auth/hooks/useDeleteAccount.ts

@@ -3,7 +3,7 @@
 import { useCallback, useState } from 'react';
 
 import { apiAccounts } from '../../clients';
-import { UserProfile } from '../../_api/generated/sdk.gen';
+import { CfgAccountsProfile } from '../../_api/generated/sdk.gen';
 import { useAuth } from '../context';
 import { authLogger } from '../utils/logger';
 
@@ -61,7 +61,7 @@ export const useDeleteAccount = (): UseDeleteAccountReturn => {
     try {
       authLogger.info('Deleting account...');
 
-      const result = await UserProfile.cfgAccountsProfileDeleteCreate({ throwOnError: true });
+      const result = await CfgAccountsProfile.cfgAccountsProfileDeleteCreate({ throwOnError: true });
       const response = result.data;
 
       if (!response.success) {

package/src/auth/hooks/useGithubAuth.ts

@@ -3,7 +3,7 @@
 import { useCallback, useState } from 'react';
 
 import { apiAccounts } from '../../clients';
-import { OAuth } from '../../_api/generated/sdk.gen';
+import { CfgAccountsOauth } from '../../_api/generated/sdk.gen';
 import { Analytics, AnalyticsCategory, AnalyticsEvent } from '../utils/analytics';
 import { authLogger } from '../utils/logger';
 import { useCfgRouter } from './useCfgRouter';
@@ -70,7 +70,7 @@ export const useGithubAuth = (options: UseGithubAuthOptions = {}): UseGithubAuth
 
       // Call API to get authorization URL
       // The API will auto-generate redirect_uri from config if not provided
-      const result = await OAuth.cfgAccountsOauthGithubAuthorizeCreate({
+      const result = await CfgAccountsOauth.cfgAccountsOauthGithubAuthorizeCreate({
         body: {
           source_url: sourceUrl || (typeof window !== 'undefined' ? window.location.href : ''),
         },
@@ -131,7 +131,7 @@ export const useGithubAuth = (options: UseGithubAuthOptions = {}): UseGithubAuth
         sessionStorage.removeItem('oauth_provider');
       }
 
-      const result = await OAuth.cfgAccountsOauthGithubCallbackCreate({
+      const result = await CfgAccountsOauth.cfgAccountsOauthGithubCallbackCreate({
         body: { code, state },
         throwOnError: true,
       });

package/src/auth/hooks/useTokenRefresh.ts

@@ -12,7 +12,7 @@
 import { useCallback, useEffect, useRef } from 'react';
 
 import { api as apiAccounts } from '../../';
-import { Auth } from '../../_api/generated/sdk.gen';
+import { CfgAccountsAuth } from '../../_api/generated/sdk.gen';
 import { authLogger } from '../utils/logger';
 
 // Configuration
@@ -78,7 +78,7 @@ export function useTokenRefresh(options: UseTokenRefreshOptions = {}) {
 
     try {
       // Use generated API client with correct URL (/cfg/accounts/token/refresh/)
-      const result = await Auth.cfgAccountsTokenRefreshCreate({
+      const result = await CfgAccountsAuth.cfgAccountsTokenRefreshCreate({
         body: { refresh: refreshTokenValue },
         throwOnError: true,
       });

package/src/auth/hooks/useTwoFactor.ts

@@ -4,7 +4,7 @@ import { useCallback, useState } from 'react';
 
 import { apiAccounts, apiTotp } from '../../clients';
 import { APIError } from '../../_api/generated/helpers';
-import { TotpVerification } from '../../_api/generated/sdk.gen';
+import { CfgTotp, CfgTotpVerify } from '../../_api/generated/sdk.gen';
 import { Analytics, AnalyticsCategory, AnalyticsEvent } from '../utils/analytics';
 import { authLogger } from '../utils/logger';
 import { useCfgRouter } from './useCfgRouter';
@@ -148,7 +148,7 @@ export const useTwoFactor = (options: UseTwoFactorOptions = {}): UseTwoFactorRet
     try {
       authLogger.info('Verifying TOTP code...');
 
-      const result = await TotpVerification.cfgTotpVerifyCreate({
+      const result = await CfgTotpVerify.cfgTotpVerifyCreate({
         body: { session_id: sessionId, code },
         throwOnError: true,
       });
@@ -208,7 +208,7 @@ export const useTwoFactor = (options: UseTwoFactorOptions = {}): UseTwoFactorRet
     try {
       authLogger.info('Verifying backup code...');
 
-      const result = await TotpVerification.cfgTotpVerifyBackupCreate({
+      const result = await CfgTotpVerify.cfgTotpVerifyBackupCreate({
         body: {
           session_id: sessionId,
           backup_code: backupCode.replace(/\s+/g, ''),

package/src/auth/hooks/useTwoFactorSetup.ts

@@ -3,7 +3,7 @@
 import { useCallback, useState } from 'react';
 
 import { apiTotp } from '../../clients';
-import { TotpSetup } from '../../_api/generated/sdk.gen';
+import { CfgTotpSetup } from '../../_api/generated/sdk.gen';
 import { authLogger } from '../utils/logger';
 
 export interface TwoFactorSetupData {
@@ -116,7 +116,7 @@ export const useTwoFactorSetup = (options: UseTwoFactorSetupOptions = {}): UseTw
     try {
       authLogger.info('Starting 2FA setup...');
 
-      const result = await TotpSetup.cfgTotpSetupCreate({
+      const result = await CfgTotpSetup.cfgTotpSetupCreate({
         body: { device_name: deviceName },
         throwOnError: true,
       });
@@ -172,7 +172,7 @@ export const useTwoFactorSetup = (options: UseTwoFactorSetupOptions = {}): UseTw
     try {
       authLogger.info('Confirming 2FA setup...');
 
-      const result = await TotpSetup.cfgTotpSetupConfirmCreate({
+      const result = await CfgTotpSetup.cfgTotpSetupConfirmCreate({
         body: { device_id: setupData.deviceId, code },
         throwOnError: true,
       });

package/src/auth/hooks/useTwoFactorStatus.ts

@@ -4,7 +4,7 @@ import { useCallback, useState } from 'react';
 
 import { apiTotp } from '../../clients';
 import { APIError } from '../../_api/generated/helpers';
-import { TotpManagement } from '../../_api/generated/sdk.gen';
+import { CfgTotp } from '../../_api/generated/sdk.gen';
 import { authLogger } from '../utils/logger';
 
 export interface TwoFactorDevice {
@@ -83,7 +83,7 @@ export const useTwoFactorStatus = (): UseTwoFactorStatusReturn => {
       authLogger.info('Fetching 2FA status...');
 
       // API returns { devices: [...], has_2fa_enabled: bool }
-      const result = await TotpManagement.cfgTotpDevicesRetrieve({ throwOnError: true });
+      const result = await CfgTotp.cfgTotpDevicesRetrieve({ throwOnError: true });
       const response = result.data;
 
       const mappedDevices: TwoFactorDevice[] = response.devices.map((device) => ({
@@ -123,7 +123,7 @@ export const useTwoFactorStatus = (): UseTwoFactorStatusReturn => {
     try {
       authLogger.info('Disabling 2FA...');
 
-      await TotpManagement.cfgTotpDisableCreate({ body: { code }, throwOnError: true });
+      await CfgTotp.cfgTotpDisableCreate({ body: { code }, throwOnError: true });
 
       setHas2FAEnabled(false);
       setDevices([]);

package/src/auth/middlewares/tokenRefresh.ts

@@ -6,7 +6,7 @@
  */
 
 import { api as apiAccounts } from '../../';
-import { Auth } from '../../_api/generated/sdk.gen';
+import { CfgAccountsAuth } from '../../_api/generated/sdk.gen';
 import { authLogger } from '../utils/logger';
 
 // Refresh state management
@@ -52,7 +52,7 @@ export async function refreshAccessToken(): Promise<string | null> {
     }
 
     // Use generated API client with correct URL (/cfg/accounts/token/refresh/)
-    const result = await Auth.cfgAccountsTokenRefreshCreate({
+    const result = await CfgAccountsAuth.cfgAccountsTokenRefreshCreate({
       body: { refresh: refreshToken },
       throwOnError: true,
     });

package/src/hooks/index.ts

@@ -0,0 +1 @@
+export { useApiKey, type UseApiKeyReturn } from './useApiKey';

package/src/hooks/useApiKey.ts

@@ -0,0 +1,73 @@
+'use client';
+
+import { useCallback, useState } from 'react';
+
+import { useCfgAccountsApiKeyRegenerateCreate } from '../_api/generated/_cfg_accounts/hooks/useCfgAccountsApiKeyRegenerateCreate';
+import { useCfgAccountsApiKeyRetrieve } from '../_api/generated/_cfg_accounts/hooks/useCfgAccountsApiKeyRetrieve';
+import { useCfgAccountsApiKeyTestCreate } from '../_api/generated/_cfg_accounts/hooks/useCfgAccountsApiKeyTestCreate';
+
+export interface ApiKeyTestResult {
+  valid: boolean;
+  userId: string | null;
+}
+
+export interface UseApiKeyReturn {
+  apiKey: string | null;
+  reissuedAt: string | null;
+  createdAt: string | null;
+  isLoading: boolean;
+  isRegenerating: boolean;
+  isTesting: boolean;
+  regenerate: () => Promise<void>;
+  testKey: (key: string) => Promise<ApiKeyTestResult>;
+  refresh: () => void;
+}
+
+export function useApiKey(): UseApiKeyReturn {
+  const { data, isLoading, mutate } = useCfgAccountsApiKeyRetrieve();
+  const { trigger: regenerateTrigger, isMutating: isRegenerating } = useCfgAccountsApiKeyRegenerateCreate();
+  const { trigger: testTrigger, isMutating: isTesting } = useCfgAccountsApiKeyTestCreate();
+
+  // After regenerate, the POST response contains the FULL key (shown once).
+  // We store it separately so the user can copy it before we refetch.
+  const [freshKey, setFreshKey] = useState<string | null>(null);
+
+  const apiKey = freshKey ?? (data?.key ?? null);
+  const reissuedAt = (data as Record<string, unknown> | undefined)?.reissued_at as string | null ?? null;
+  const createdAt = (data as Record<string, unknown> | undefined)?.created_at as string | null ?? null;
+
+  const regenerate = useCallback(async () => {
+    const result = await regenerateTrigger({} as never);
+    // The POST response has the full key — surface it immediately.
+    const newKey = (result as Record<string, unknown> | undefined)?.key as string | undefined;
+    if (newKey) {
+      setFreshKey(newKey);
+    }
+  }, [regenerateTrigger]);
+
+  const testKey = useCallback(async (key: string): Promise<ApiKeyTestResult> => {
+    const result = await testTrigger({ body: { key } } as never);
+    const record = result as Record<string, unknown> | undefined;
+    return {
+      valid: Boolean(record?.valid),
+      userId: (record?.user_id as string | null) ?? null,
+    };
+  }, [testTrigger]);
+
+  const refresh = useCallback(() => {
+    setFreshKey(null);
+    mutate();
+  }, [mutate]);
+
+  return {
+    apiKey,
+    reissuedAt,
+    createdAt,
+    isLoading,
+    isRegenerating,
+    isTesting,
+    regenerate,
+    testKey,
+    refresh,
+  };
+}

package/src/index.ts

@@ -1,8 +1,7 @@
 /**
  * @djangocfg/api — package entry point.
  *
- * Per-group API singletons (`cfgAccountsApi`, `cfgTotpApi`, `cfgCentrifugoApi`)
- * + API classes + shared utilities (LocalStorageAdapter / APIError / ...).
+ * Per-group API singletons + API classes + shared utilities.
  *
  * Usage:
  *   import { cfgAccountsApi, AccountsTypes } from '@djangocfg/api';
@@ -11,21 +10,18 @@
 
 export * from './_api/generated';
 
-// Hey API SDK classes (one per OpenAPI tag) — direct callable static methods,
-// e.g. `CentrifugoAuth.cfgCentrifugoAuthTokenRetrieve(...)`.
+// Hey API SDK classes (one per OpenAPI tag) — direct callable static methods.
 export {
-  Cfg,
-  Accounts,
-  OAuth,
-  UserProfile,
-  Auth,
-  Centrifugo,
-  CentrifugoAuth,
-  Totp,
-  BackupCodes,
-  TotpManagement,
-  TotpSetup,
-  TotpVerification,
+  CfgAccountsApiKey,
+  CfgAccountsOauth,
+  CfgAccounts,
+  CfgAccountsProfile,
+  CfgAccountsAuth,
+  CfgCentrifugo,
+  CfgTotpBackupCodes,
+  CfgTotp,
+  CfgTotpSetup,
+  CfgTotpVerify,
 } from './_api/generated/sdk.gen';
 
 // Type namespaces (one per group) for code that needs `AccountsTypes.User`.

package/src/lib/env.ts

@@ -0,0 +1,10 @@
+/**
+ * Environment constants — shared across all @djangocfg packages.
+ */
+
+export const nodeEnv = process.env.NODE_ENV || 'development';
+export const isDev = nodeEnv === 'development';
+export const isProd = !isDev;
+export const isTest = nodeEnv === 'test';
+export const isBrowser = typeof window !== 'undefined';
+export const isServer = typeof window === 'undefined';