@djangocfg/api 2.1.322 → 2.1.331

package/src/clients.ts

@@ -1,57 +1,20 @@
 /**
- * @djangocfg/api - Pre-configured API Clients
+ * @djangocfg/api/clients — pre-configured per-group API singletons.
  *
- * Ready-to-use API instances for accounts and centrifugo.
+ * Singletons (`cfgAccountsApi`, `cfgTotpApi`, `cfgCentrifugoApi`) live in the
+ * generated barrel. This file just re-exports them with the legacy-friendly
+ * `apiAccounts` / `apiTotp` / `apiCentrifugo` aliases.
  *
  * Usage:
- *   import { apiAccounts, apiCentrifugo } from '@djangocfg/api/clients';
- *   import { useAccountsOauthGithubCallbackCreate } from '@djangocfg/api/clients';
+ *   import { apiAccounts } from '@djangocfg/api/clients';
+ *   await apiAccounts.accounts.cfgAccountsLogin({ body });
  */
 
-import { API as AccountsAPIClass, LocalStorageAdapter } from './_api/generated/cfg_accounts';
-import { API as CentrifugoAPIClass } from './_api/generated/cfg_centrifugo';
-import { API as TotpAPIClass } from './_api/generated/cfg_totp';
-
-// ============================================================================
-// Pre-configured API instances (for hooks and direct usage)
-// ============================================================================
-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 });
-
-// ============================================================================
-// Enums (re-export from accounts)
-// ============================================================================
-export * as Enums from './_api/generated/cfg_accounts/enums';
-
-// ============================================================================
-// CFG Accounts (primary exports - includes shared types)
-// ============================================================================
-export * from './_api/generated/cfg_accounts/_utils/hooks';
-export * from './_api/generated/cfg_accounts/_utils/fetchers';
-export * from './_api/generated/cfg_accounts/_utils/schemas';
-
-// ============================================================================
-// CFG Centrifugo (namespaced to avoid conflicts)
-// ============================================================================
-export * as CentrifugoHooks from './_api/generated/cfg_centrifugo/_utils/hooks';
-export * as CentrifugoFetchers from './_api/generated/cfg_centrifugo/_utils/fetchers';
-export * as CentrifugoTypes from './_api/generated/cfg_centrifugo/_utils/schemas';
-
-// ============================================================================
-// CFG TOTP (namespaced to avoid conflicts)
-// ============================================================================
-export * as TotpHooks from './_api/generated/cfg_totp/_utils/hooks';
-export * as TotpFetchers from './_api/generated/cfg_totp/_utils/fetchers';
-export * as TotpTypes from './_api/generated/cfg_totp/_utils/schemas';
-
-// ============================================================================
-// API Classes (for creating custom instances)
-// ============================================================================
-export { API as AccountsAPI } from './_api/generated/cfg_accounts';
-export { API as TotpAPI } from './_api/generated/cfg_totp';
-export { API as CentrifugoAPI } from './_api/generated/cfg_centrifugo';
+export {
+  CfgAccountsApi as apiAccounts,
+  CfgTotpApi as apiTotp,
+  CfgCentrifugoApi as apiCentrifugo,
+  CfgAccountsAPI as AccountsAPI,
+  CfgTotpAPI as TotpAPI,
+  CfgCentrifugoAPI as CentrifugoAPI,
+} from './_api/generated';

package/src/index.ts

@@ -1,65 +1,40 @@
 /**
- * @djangocfg/api - Shared API Package
+ * @djangocfg/api — package entry point.
  *
- * Core authentication API (cfg_accounts only).
- * Extensions are now in separate packages:
- * - @djangocfg/ext-support
- * - @djangocfg/ext-payments
- * - etc.
- */
-
-// ============================================================================
-// Main API from cfg_accounts (authentication)
-// ============================================================================
-export * from './_api/generated/cfg_accounts';
-export { API, LocalStorageAdapter, MemoryStorageAdapter } from './_api/generated/cfg_accounts';
-export { Schemas, Fetchers, Enums } from './_api/generated/cfg_accounts';
-
-// ============================================================================
-// CFG Accounts Type Namespace
-// ============================================================================
-export * as CfgAccountsTypes from './_api/generated/cfg_accounts';
-
-// ============================================================================
-// Centrifugo Fetchers (for WebSocket token refresh)
-// ============================================================================
-export { getCentrifugoAuthTokenRetrieve } from './_api/generated/cfg_centrifugo';
-
-/**
- * Base Client for all API services
+ * Per-group API singletons (`cfgAccountsApi`, `cfgTotpApi`, `cfgCentrifugoApi`)
+ * + API classes + shared utilities (LocalStorageAdapter / APIError / ...).
  *
- * Provides:
- * - Centralized API instance with JWT token management
- * - LocalStorage adapter for browser environments
- * - Singleton pattern for API client
+ * Usage:
+ *   import { cfgAccountsApi, AccountsTypes } from '@djangocfg/api';
+ *   await cfgAccountsApi.accounts.cfgAccountsLogin({ body });
  */
 
-import { API, LocalStorageAdapter } from './_api/generated/cfg_accounts';
-
-/**
- * Singleton API instance with JWT token management
- * Uses LocalStorage for token persistence
- */
-const isStaticBuild = process.env.NEXT_PUBLIC_STATIC_BUILD === 'true';
-const apiUrl = isStaticBuild ? '' : process.env.NEXT_PUBLIC_API_URL || '';
-
-const api = new API(
-  apiUrl,
-  {
-    storage: new LocalStorageAdapter()
-  }
-);
-
-/**
- * Base Client Class
- *
- * Service classes can extend this to access api instance
- */
-export class BaseClient {
-  protected static api = api;
-}
-
-/**
- * Export API instance for direct access
- */
-export { api };
+export * from './_api/generated';
+
+// Hey API SDK classes (one per OpenAPI tag) — direct callable static methods,
+// e.g. `CentrifugoAuth.cfgCentrifugoAuthTokenRetrieve(...)`.
+export {
+  Cfg,
+  Accounts,
+  OAuth,
+  UserProfile,
+  Auth,
+  Centrifugo,
+  CentrifugoAuth,
+  Totp,
+  BackupCodes,
+  TotpManagement,
+  TotpSetup,
+  TotpVerification,
+} from './_api/generated/sdk.gen';
+
+// Type namespaces (one per group) for code that needs `AccountsTypes.User`.
+export type * as AccountsTypes from './_api/generated/_cfg_accounts/types.gen';
+export type * as TotpTypes from './_api/generated/_cfg_totp/types.gen';
+export type * as CentrifugoTypes from './_api/generated/_cfg_centrifugo/types.gen';
+
+// Convenience top-level type re-exports.
+export type { User } from './_api/generated/_cfg_accounts/types.gen';
+
+// Legacy alias for code that still imports `api` (= cfg_accounts singleton).
+export { CfgAccountsApi as api } from './_api/generated';

package/src/server.ts

@@ -1,30 +1,32 @@
 /**
- * @djangocfg/api/server - Server-side only exports
+ * @djangocfg/api/server — server-side only exports.
  *
- * Server-safe exports that don't include React hooks or client-side code.
- * Use this for Next.js API routes, Server Components, and Node.js backends.
- *
- * @example
- * ```typescript
- * import { API, MemoryStorageAdapter, Fetchers } from '@djangocfg/api/server';
- *
- * const api = new API('https://api.example.com', {
- *   storage: new MemoryStorageAdapter(),
- * });
- *
- * const result = await Fetchers.someEndpoint(data, api);
- * ```
+ * No React hooks, no client-side code. Use from Next.js API routes / Server
+ * Components / Node.js backends.
  */
 
-// Export API class and storage adapters
-export { API, MemoryStorageAdapter } from './_api/generated/cfg_accounts';
+export {
+  CfgAccountsAPI as AccountsAPI,
+  CfgTotpAPI as TotpAPI,
+  CfgCentrifugoAPI as CentrifugoAPI,
+  MemoryStorageAdapter,
+  LocalStorageAdapter,
+  type StorageAdapter,
+  APIError,
+  NetworkError,
+} from './_api/generated';
 
-// Export only fetchers (no hooks, no React dependencies)
-export * as Fetchers from './_api/generated/cfg_accounts/_utils/fetchers';
+// SDK fetchers (Hey API SDK classes — re-export as namespace modules).
+export * as AccountsFetchers from './_api/generated/_cfg_accounts/sdk.gen';
+export * as TotpFetchers from './_api/generated/_cfg_totp/sdk.gen';
+export * as CentrifugoFetchers from './_api/generated/_cfg_centrifugo/sdk.gen';
 
-// Export types and schemas (server-safe)
-export * as Schemas from './_api/generated/cfg_accounts/_utils/schemas';
-export * as Enums from './_api/generated/cfg_accounts/enums';
+// Zod schemas.
+export * as AccountsSchemas from './_api/generated/_cfg_accounts/schemas';
+export * as TotpSchemas from './_api/generated/_cfg_totp/schemas';
+export * as CentrifugoSchemas from './_api/generated/_cfg_centrifugo/schemas';
 
-// Re-export types
-export type { API as APIType } from './_api/generated/cfg_accounts';
+// Types.
+export type * as AccountsTypes from './_api/generated/_cfg_accounts/types.gen';
+export type * as TotpTypes from './_api/generated/_cfg_totp/types.gen';
+export type * as CentrifugoTypes from './_api/generated/_cfg_centrifugo/types.gen';

package/src/_api/BaseClient.ts

@@ -1,22 +0,0 @@
-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/_api/generated/cfg_accounts/CLAUDE.md

@@ -1,86 +0,0 @@
-# Django CFG API - Typescript Client
-
-Auto-generated. **Do not edit manually.**
-
-```bash
-python manage.py generate_client --groups cfg_accounts --typescript
-```
-
-## Stats
-
-| | |
-|---|---|
-| Version | 3.1.0 |
-| Operations | 15 |
-| Schemas | 21 |
-
-## Resources
-
-- **Auth** (1 ops)
-- **OAuth** (5 ops)
-- **User Profile** (7 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`
-- `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`
-- `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
-)
-```
-
-@see https://djangocfg.com/docs/features/api-generation
-

package/src/_api/generated/cfg_accounts/_utils/fetchers/accounts.ts

@@ -1,154 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Typed fetchers for Accounts
- *
- * Universal functions that work in any environment:
- * - Next.js (App Router / Pages Router / Server Components)
- * - React Native
- * - Node.js backend
- *
- * These fetchers use Zod schemas for runtime validation.
- *
- * Usage:
- * ```typescript
- * // Configure API once (in your app entry point)
- * import { configureAPI } from '../../api-instance'
- * configureAPI({ baseUrl: 'https://api.example.com' })
- *
- * // Then use fetchers anywhere
- * const users = await getUsers({ page: 1 })
- *
- * // With SWR
- * const { data } = useSWR(['users', params], () => getUsers(params))
- *
- * // With React Query
- * const { data } = useQuery(['users', params], () => getUsers(params))
- *
- * // In Server Component or SSR (pass custom client)
- * import { API } from '../../index'
- * const api = new API('https://api.example.com')
- * const users = await getUsers({ page: 1 }, api)
- * ```
- */
-import { consola } from 'consola'
-import { OTPRequestRequestSchema, type OTPRequestRequest } from '../schemas/OTPRequestRequest.schema'
-import { OTPRequestResponseSchema, type OTPRequestResponse } from '../schemas/OTPRequestResponse.schema'
-import { OTPVerifyRequestSchema, type OTPVerifyRequest } from '../schemas/OTPVerifyRequest.schema'
-import { OTPVerifyResponseSchema, type OTPVerifyResponse } from '../schemas/OTPVerifyResponse.schema'
-import { getAPIInstance } from '../../api-instance'
-
-/**
- * API operation
- *
- * @method POST
- * @path /cfg/accounts/otp/request/
- */
-export async function createAccountsOtpRequestCreate(  data: OTPRequestRequest,  client?: any
-): Promise<OTPRequestResponse> {
-  const api = client || getAPIInstance()
-  const response = await api.accounts.otpRequestCreate(data)
-  try {
-    return OTPRequestResponseSchema.parse(response)
-  } catch (error) {
-    // Zod validation error - log detailed information
-    consola.error('❌ Zod Validation Failed');
-    consola.box(`createAccountsOtpRequestCreate\nPath: /cfg/accounts/otp/request/\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: 'createAccountsOtpRequestCreate',
-            path: '/cfg/accounts/otp/request/',
-            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;
-  }
-}
-
-
-/**
- * API operation
- *
- * @method POST
- * @path /cfg/accounts/otp/verify/
- */
-export async function createAccountsOtpVerifyCreate(  data: OTPVerifyRequest,  client?: any
-): Promise<OTPVerifyResponse> {
-  const api = client || getAPIInstance()
-  const response = await api.accounts.otpVerifyCreate(data)
-  try {
-    return OTPVerifyResponseSchema.parse(response)
-  } catch (error) {
-    // Zod validation error - log detailed information
-    consola.error('❌ Zod Validation Failed');
-    consola.box(`createAccountsOtpVerifyCreate\nPath: /cfg/accounts/otp/verify/\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: 'createAccountsOtpVerifyCreate',
-            path: '/cfg/accounts/otp/verify/',
-            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;
-  }
-}
-
-

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

@@ -1,95 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Typed fetchers for Auth
- *
- * Universal functions that work in any environment:
- * - Next.js (App Router / Pages Router / Server Components)
- * - React Native
- * - Node.js backend
- *
- * These fetchers use Zod schemas for runtime validation.
- *
- * Usage:
- * ```typescript
- * // Configure API once (in your app entry point)
- * import { configureAPI } from '../../api-instance'
- * configureAPI({ baseUrl: 'https://api.example.com' })
- *
- * // Then use fetchers anywhere
- * const users = await getUsers({ page: 1 })
- *
- * // With SWR
- * const { data } = useSWR(['users', params], () => getUsers(params))
- *
- * // With React Query
- * const { data } = useQuery(['users', params], () => getUsers(params))
- *
- * // In Server Component or SSR (pass custom client)
- * import { API } from '../../index'
- * const api = new API('https://api.example.com')
- * const users = await getUsers({ page: 1 }, api)
- * ```
- */
-import { consola } from 'consola'
-import { TokenRefreshSchema, type TokenRefresh } from '../schemas/TokenRefresh.schema'
-import { TokenRefreshRequestSchema, type TokenRefreshRequest } from '../schemas/TokenRefreshRequest.schema'
-import { getAPIInstance } from '../../api-instance'
-
-/**
- * API operation
- *
- * @method POST
- * @path /cfg/accounts/token/refresh/
- */
-export async function createAccountsTokenRefreshCreate(  data: TokenRefreshRequest,  client?: any
-): Promise<TokenRefresh> {
-  const api = client || getAPIInstance()
-  const response = await api.auth.accountsTokenRefreshCreate(data)
-  try {
-    return TokenRefreshSchema.parse(response)
-  } catch (error) {
-    // Zod validation error - log detailed information
-    consola.error('❌ Zod Validation Failed');
-    consola.box(`createAccountsTokenRefreshCreate\nPath: /cfg/accounts/token/refresh/\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: 'createAccountsTokenRefreshCreate',
-            path: '/cfg/accounts/token/refresh/',
-            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;
-  }
-}
-
-