@djangocfg/api 2.1.321 → 2.1.327

package/src/_api/generated/cfg_totp/index.ts

@@ -1,345 +1,29 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Django CFG API - API Client with JWT Management
- *
- * Usage:
- * ```typescript
- * import { API } from './api';
- *
- * const api = new API('https://api.example.com');
- *
- * // Set JWT token
- * api.setToken('your-jwt-token', 'refresh-token');
- *
- * // Use API
- * const posts = await api.posts.list();
- * const user = await api.users.retrieve(1);
- *
- * // Check authentication
- * if (api.isAuthenticated()) {
- *   // ...
- * }
- *
- * // Custom storage with logging (for Electron/Node.js)
- * import { MemoryStorageAdapter, APILogger } from './storage';
- * const logger = new APILogger({ enabled: true, logLevel: 'debug' });
- * const api = new API('https://api.example.com', {
- *   storage: new MemoryStorageAdapter(logger),
- *   loggerConfig: { enabled: true, logLevel: 'debug' }
- * });
- *
- * // Get OpenAPI schema
- * const schema = api.getSchema();
- * ```
- */
+// AUTO-GENERATED by django_generator / ts_extras.wrapper
+// Group barrel. DO NOT EDIT — re-run `make gen`.
 
-import { APIClient } from "./client";
-import {
-  StorageAdapter,
-  LocalStorageAdapter,
-  CookieStorageAdapter,
-  MemoryStorageAdapter
-} from "./storage";
-import type { RetryConfig } from "./retry";
-import type { LoggerConfig } from "./logger";
-import { APILogger } from "./logger";
-import { BackupCodes } from "./totp__backup_codes/client";
-import { TotpManagement } from "./totp__totp_management/client";
-import { TotpSetup } from "./totp__totp_setup/client";
-import { TotpVerification } from "./totp__totp_verification/client";
-import { Totp } from "./totp/client";
-export * as BackupCodesTypes from "./totp__backup_codes/models";
-// Note: Direct exports (export * from) are removed to avoid duplicate type conflicts
-// Use namespace exports like CfgAccountsTypes.User or import from specific modules
-export * as TotpManagementTypes from "./totp__totp_management/models";
-// Note: Direct exports (export * from) are removed to avoid duplicate type conflicts
-// Use namespace exports like CfgAccountsTypes.User or import from specific modules
-export * as TotpSetupTypes from "./totp__totp_setup/models";
-// Note: Direct exports (export * from) are removed to avoid duplicate type conflicts
-// Use namespace exports like CfgAccountsTypes.User or import from specific modules
-export * as TotpVerificationTypes from "./totp__totp_verification/models";
-// Note: Direct exports (export * from) are removed to avoid duplicate type conflicts
-// Use namespace exports like CfgAccountsTypes.User or import from specific modules
-export * as TotpTypes from "./totp/models";
-// Note: Direct exports (export * from) are removed to avoid duplicate type conflicts
-// Use namespace exports like CfgAccountsTypes.User or import from specific modules
-export * as Enums from "./enums";
-
-// Re-export Zod schemas for runtime validation
-export * as Schemas from "./_utils/schemas";
-// Also export all schemas directly for convenience
-export * from "./_utils/schemas";
+// Wrapper class + per-group SDK re-exports
+export { API, type APIOptions, Cfg, Totp, BackupCodes, TotpManagement, TotpSetup, TotpVerification } from './api';
 
-// Re-export Zod validation events for browser integration
-export type { ValidationErrorDetail, ValidationErrorEvent } from "./validation-events";
-export { dispatchValidationError, onValidationError, formatZodError } from "./validation-events";
-
-// Re-export typed fetchers for universal usage
-export * as Fetchers from "./_utils/fetchers";
-export * from "./_utils/fetchers";
-
-// Re-export API instance configuration functions
+// Shared utilities (storage / errors / logger / validation events)
 export {
-  configureAPI,
-  getAPIInstance,
-  reconfigureAPI,
-  clearAPITokens,
-  resetAPI,
-  isAPIConfigured
-} from "./api-instance";
-// NOTE: SWR hooks are generated in ./_utils/hooks/ but NOT exported here to keep
-// the main bundle server-safe. Import hooks directly from the hooks directory:
-//   import { useUsers } from './_utils/hooks';
-// Or use a separate entry point like '@djangocfg/api/hooks' for client components.
-
-// Re-export core client
-export { APIClient };
-
-// Re-export storage adapters for convenience
-export type { StorageAdapter };
-export { LocalStorageAdapter, CookieStorageAdapter, MemoryStorageAdapter };
-
-// Re-export error classes for convenience
-export { APIError, NetworkError } from "./errors";
-
-// Re-export HTTP adapters for custom implementations
-export type { HttpClientAdapter, HttpRequest, HttpResponse } from "./http";
-export { FetchAdapter, KeepAliveFetchAdapter } from "./http";
-
-// Re-export logger types and classes
-export type { LoggerConfig, RequestLog, ResponseLog, ErrorLog } from "./logger";
-export { APILogger } from "./logger";
-
-// Re-export retry configuration and utilities
-export type { RetryConfig, FailedAttemptInfo } from "./retry";
-export { withRetry, shouldRetry, DEFAULT_RETRY_CONFIG } from "./retry";
-
-export const TOKEN_KEY = "auth_token";
-export const REFRESH_TOKEN_KEY = "refresh_token";
-
-/** Auto-detect locale from cookie NEXT_LOCALE or navigator.language */
-function detectLocale(): string | null {
-  try {
-    if (typeof document !== 'undefined') {
-      const match = document.cookie.match(/(?:^|;\s*)NEXT_LOCALE=([^;]*)/);
-      if (match) return match[1];
-    }
-    if (typeof navigator !== 'undefined' && navigator.language) {
-      return navigator.language;
-    }
-  } catch {}
-  return null;
-}
-
-export interface APIOptions {
-  /** Custom storage adapter (defaults to LocalStorageAdapter) */
-  storage?: StorageAdapter;
-  /** Custom HTTP client adapter (defaults to FetchAdapter) */
-  httpClient?: HttpClientAdapter;
-  /** Retry configuration for failed requests */
-  retryConfig?: RetryConfig;
-  /** Logger configuration */
-  loggerConfig?: Partial<LoggerConfig>;
-  /** Locale for Accept-Language header (e.g. 'en', 'ko', 'ru') */
-  locale?: string;
-}
-
-export class API {
-  private baseUrl: string;
-  private _client: APIClient;
-  private _token: string | null = null;
-  private _refreshToken: string | null = null;
-  private _locale: string | null = null;
-  private storage: StorageAdapter;
-  private options?: APIOptions;
-
-  // Sub-clients
-  public backup_codes!: BackupCodes;
-  public totp_management!: TotpManagement;
-  public totp_setup!: TotpSetup;
-  public totp_verification!: TotpVerification;
-  public totp!: Totp;
-
-  constructor(baseUrl: string, options?: APIOptions) {
-    this.baseUrl = baseUrl;
-    this.options = options;
-
-    // Create logger if config provided
-    const logger = options?.loggerConfig ? new APILogger(options.loggerConfig) : undefined;
-
-    // Initialize storage with logger
-    this.storage = options?.storage || new LocalStorageAdapter(logger);
-
-    this._locale = options?.locale || null;
-
-    this._loadTokensFromStorage();
-
-    // Initialize APIClient with token getter for URL authentication
-    this._client = new APIClient(this.baseUrl, {
-      httpClient: this.options?.httpClient,
-      retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig,
-      tokenGetter: () => this.getToken(),
-    });
-
-    // Always inject auth header wrapper (reads token dynamically from storage)
-    this._injectAuthHeader();
-
-    // Initialize sub-clients from APIClient
-    this.backup_codes = this._client.backup_codes;
-    this.totp_management = this._client.totp_management;
-    this.totp_setup = this._client.totp_setup;
-    this.totp_verification = this._client.totp_verification;
-    this.totp = this._client.totp;
-  }
-
-  private _loadTokensFromStorage(): void {
-    this._token = this.storage.getItem(TOKEN_KEY);
-    this._refreshToken = this.storage.getItem(REFRESH_TOKEN_KEY);
-  }
-
-  private _reinitClients(): void {
-    this._client = new APIClient(this.baseUrl, {
-      httpClient: this.options?.httpClient,
-      retryConfig: this.options?.retryConfig,
-      loggerConfig: this.options?.loggerConfig,
-      tokenGetter: () => this.getToken(),
-    });
-
-    // Always inject auth header wrapper (reads token dynamically from storage)
-    this._injectAuthHeader();
-
-    // Reinitialize sub-clients
-    this.backup_codes = this._client.backup_codes;
-    this.totp_management = this._client.totp_management;
-    this.totp_setup = this._client.totp_setup;
-    this.totp_verification = this._client.totp_verification;
-    this.totp = this._client.totp;
-  }
-
-  private _injectAuthHeader(): void {
-    // Override request method to inject auth header
-    const originalRequest = this._client.request.bind(this._client);
-    this._client.request = async <T>(
-      method: string,
-      path: string,
-      options?: { params?: Record<string, any>; body?: any; formData?: FormData; headers?: Record<string, string> }
-    ): Promise<T> => {
-      // Read token from storage dynamically (supports JWT injection after instantiation)
-      const token = this.getToken();
-      const locale = this._locale || detectLocale();
-      const mergedOptions = {
-        ...options,
-        headers: {
-          ...(options?.headers || {}),
-          ...(token ? { 'Authorization': `Bearer ${token}` } : {}),
-          ...(locale ? { 'Accept-Language': locale } : {}),
-        },
-      };
-
-      return originalRequest(method, path, mergedOptions);
-    };
-  }
-
-  /**
-   * Get current JWT token
-   */
-  getToken(): string | null {
-    return this.storage.getItem(TOKEN_KEY);
-  }
-
-  /**
-   * Get current refresh token
-   */
-  getRefreshToken(): string | null {
-    return this.storage.getItem(REFRESH_TOKEN_KEY);
-  }
-
-  /**
-   * Set JWT token and refresh token
-   * @param token - JWT access token
-   * @param refreshToken - JWT refresh token (optional)
-   */
-  setToken(token: string, refreshToken?: string): void {
-    this._token = token;
-    this.storage.setItem(TOKEN_KEY, token);
-
-    if (refreshToken) {
-      this._refreshToken = refreshToken;
-      this.storage.setItem(REFRESH_TOKEN_KEY, refreshToken);
-    }
-
-    // Reinitialize clients with new token
-    this._reinitClients();
-  }
-
-  /**
-   * Clear all tokens
-   */
-  clearTokens(): void {
-    this._token = null;
-    this._refreshToken = null;
-    this.storage.removeItem(TOKEN_KEY);
-    this.storage.removeItem(REFRESH_TOKEN_KEY);
-
-    // Reinitialize clients without token
-    this._reinitClients();
-  }
-
-  /**
-   * Check if user is authenticated
-   */
-  isAuthenticated(): boolean {
-    return !!this.getToken();
-  }
-
-  /**
-   * Update base URL and reinitialize clients
-   * @param url - New base URL
-   */
-  setBaseUrl(url: string): void {
-    this.baseUrl = url;
-    this._reinitClients();
-  }
-
-  /**
-   * Get current base URL
-   */
-  getBaseUrl(): string {
-    return this.baseUrl;
-  }
-
-  /**
-   * Set locale for Accept-Language header
-   * @param locale - Locale string (e.g. 'en', 'ko', 'ru') or null to clear
-   */
-  setLocale(locale: string | null): void {
-    this._locale = locale;
-  }
-
-  /**
-   * Get current locale
-   */
-  getLocale(): string | null {
-    return this._locale;
-  }
-
-  /**
-   * Get OpenAPI schema path
-   * @returns Path to the OpenAPI schema JSON file
-   *
-   * Note: The OpenAPI schema is available in the schema.json file.
-   * You can load it dynamically using:
-   * ```typescript
-   * const schema = await fetch('./schema.json').then(r => r.json());
-   * // or using fs in Node.js:
-   * // const schema = JSON.parse(fs.readFileSync('./schema.json', 'utf-8'));
-   * ```
-   */
-  getSchemaPath(): string {
-    return './schema.json';
-  }
-}
-
-export default API;
+  type StorageAdapter,
+  LocalStorageAdapter,
+  MemoryStorageAdapter,
+  CookieStorageAdapter,
+  APIError,
+  NetworkError,
+  APILogger,
+  defaultLogger,
+  type LoggerConfig,
+  type RequestLog,
+  type ResponseLog,
+  type ErrorLog,
+  dispatchValidationError,
+  onValidationError,
+  formatZodError,
+  type ValidationErrorDetail,
+  type ValidationErrorEvent,
+} from '../_shared';
+
+// Generated artifacts (Hey API)
+export type * from './types.gen';

package/src/_api/generated/cfg_totp/schemas/BackupCodesRegenerateRequest.ts

@@ -0,0 +1,11 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+
+export const BackupCodesRegenerateRequestSchema = z.object({
+  code: z.string().min(6).max(6),
+});
+
+export type BackupCodesRegenerateRequest = z.infer<typeof BackupCodesRegenerateRequestSchema>;

package/src/_api/generated/cfg_totp/schemas/BackupCodesRegenerateResponse.ts

@@ -0,0 +1,12 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+
+export const BackupCodesRegenerateResponseSchema = z.object({
+  backup_codes: z.array(z.string()),
+  warning: z.string(),
+});
+
+export type BackupCodesRegenerateResponse = z.infer<typeof BackupCodesRegenerateResponseSchema>;

package/src/_api/generated/cfg_totp/schemas/BackupCodesStatus.ts

@@ -0,0 +1,13 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+
+export const BackupCodesStatusSchema = z.object({
+  remaining_count: z.number().int(),
+  total_generated: z.number().int(),
+  warning: z.string().nullable().optional(),
+});
+
+export type BackupCodesStatus = z.infer<typeof BackupCodesStatusSchema>;

package/src/_api/generated/cfg_totp/schemas/ConfirmSetupRequest.ts

@@ -0,0 +1,12 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+
+export const ConfirmSetupRequestSchema = z.object({
+  device_id: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i),
+  code: z.string().min(6).max(6),
+});
+
+export type ConfirmSetupRequest = z.infer<typeof ConfirmSetupRequestSchema>;

package/src/_api/generated/cfg_totp/schemas/ConfirmSetupResponse.ts

@@ -0,0 +1,13 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+
+export const ConfirmSetupResponseSchema = z.object({
+  message: z.string(),
+  backup_codes: z.array(z.string()),
+  backup_codes_warning: z.string(),
+});
+
+export type ConfirmSetupResponse = z.infer<typeof ConfirmSetupResponseSchema>;

package/src/_api/generated/cfg_totp/schemas/DeviceList.ts

@@ -0,0 +1,18 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+import { DeviceListStatusEnumSchema } from "./DeviceListStatusEnum";
+
+export const DeviceListSchema = z.object({
+  id: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i),
+  name: z.string(),
+  is_primary: z.boolean(),
+  status: DeviceListStatusEnumSchema,
+  created_at: z.string().datetime({ offset: true }),
+  confirmed_at: z.string().datetime({ offset: true }).nullable(),
+  last_used_at: z.string().datetime({ offset: true }).nullable(),
+});
+
+export type DeviceList = z.infer<typeof DeviceListSchema>;

package/src/_api/generated/cfg_totp/schemas/DeviceListResponse.ts

@@ -0,0 +1,13 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+import { DeviceListSchema } from "./DeviceList";
+
+export const DeviceListResponseSchema = z.object({
+  devices: z.array(DeviceListSchema),
+  has_2fa_enabled: z.boolean(),
+});
+
+export type DeviceListResponse = z.infer<typeof DeviceListResponseSchema>;

package/src/_api/generated/cfg_totp/schemas/DeviceListStatusEnum.ts

@@ -0,0 +1,9 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+
+export const DeviceListStatusEnumSchema = z.enum(["pending", "active", "disabled"]);
+
+export type DeviceListStatusEnum = z.infer<typeof DeviceListStatusEnumSchema>;

package/src/_api/generated/cfg_totp/schemas/DisableRequest.ts

@@ -0,0 +1,11 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+
+export const DisableRequestSchema = z.object({
+  code: z.string().min(6).max(6),
+});
+
+export type DisableRequest = z.infer<typeof DisableRequestSchema>;

package/src/_api/generated/cfg_totp/schemas/SetupRequest.ts

@@ -0,0 +1,11 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+
+export const SetupRequestSchema = z.object({
+  device_name: z.string().min(1).max(100).optional(),
+});
+
+export type SetupRequest = z.infer<typeof SetupRequestSchema>;

package/src/_api/generated/cfg_totp/schemas/SetupResponse.ts

@@ -0,0 +1,15 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+
+export const SetupResponseSchema = z.object({
+  device_id: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i),
+  secret: z.string(),
+  provisioning_uri: z.string(),
+  qr_code_base64: z.string(),
+  expires_in: z.number().int(),
+});
+
+export type SetupResponse = z.infer<typeof SetupResponseSchema>;

package/src/_api/generated/cfg_totp/{_utils/schemas/TotpVerifyUser.schema.ts → schemas/TotpVerifyUser.ts}

@@ -1,14 +1,9 @@
-/**
- * Zod schema for TotpVerifyUser
- *
- * This schema provides runtime validation and type inference.
- *  * User data returned after 2FA verification.
- *  */
-import { z } from 'zod'
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
 
-/**
- * User data returned after 2FA verification.
- */
 export const TotpVerifyUserSchema = z.object({
   id: z.number().int(),
   email: z.email(),
@@ -27,9 +22,6 @@ export const TotpVerifyUserSchema = z.object({
   date_joined: z.string().datetime({ offset: true }),
   last_login: z.string().datetime({ offset: true }).nullable(),
   unanswered_messages_count: z.number().int(),
-})
+});
 
-/**
- * Infer TypeScript type from Zod schema
- */
-export type TotpVerifyUser = z.infer<typeof TotpVerifyUserSchema>
+export type TotpVerifyUser = z.infer<typeof TotpVerifyUserSchema>;

package/src/_api/generated/cfg_totp/schemas/VerifyBackupRequest.ts

@@ -0,0 +1,12 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+
+export const VerifyBackupRequestSchema = z.object({
+  session_id: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i),
+  backup_code: z.string().min(8).max(8),
+});
+
+export type VerifyBackupRequest = z.infer<typeof VerifyBackupRequestSchema>;

package/src/_api/generated/cfg_totp/schemas/VerifyRequest.ts

@@ -0,0 +1,12 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+
+export const VerifyRequestSchema = z.object({
+  session_id: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i),
+  code: z.string().min(6).max(6),
+});
+
+export type VerifyRequest = z.infer<typeof VerifyRequestSchema>;

package/src/_api/generated/cfg_totp/schemas/VerifyResponse.ts

@@ -0,0 +1,17 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen`.
+
+import { z } from "zod";
+import { TotpVerifyUserSchema } from "./TotpVerifyUser";
+
+export const VerifyResponseSchema = z.object({
+  message: z.string(),
+  access_token: z.string(),
+  refresh_token: z.string(),
+  user: TotpVerifyUserSchema,
+  remaining_backup_codes: z.number().int().optional(),
+  warning: z.string().optional(),
+});
+
+export type VerifyResponse = z.infer<typeof VerifyResponseSchema>;

package/src/_api/generated/cfg_totp/schemas/index.ts

@@ -0,0 +1,18 @@
+// AUTO-GENERATED — barrel for zod schemas.
+// DO NOT EDIT.
+
+export * from "./BackupCodesRegenerateRequest";
+export * from "./BackupCodesRegenerateResponse";
+export * from "./BackupCodesStatus";
+export * from "./ConfirmSetupRequest";
+export * from "./ConfirmSetupResponse";
+export * from "./DeviceList";
+export * from "./DeviceListResponse";
+export * from "./DeviceListStatusEnum";
+export * from "./DisableRequest";
+export * from "./SetupRequest";
+export * from "./SetupResponse";
+export * from "./TotpVerifyUser";
+export * from "./VerifyBackupRequest";
+export * from "./VerifyRequest";
+export * from "./VerifyResponse";