@djangocfg/api 2.1.322 → 2.1.331

package/src/_api/generated/_cfg_centrifugo/events.ts

@@ -0,0 +1,198 @@
+// AUTO-GENERATED by cmdop_server / devtools.generator.ts_extras.events
+// Hooks Hey API client interceptors → typed CustomEvents on `window`.
+// DO NOT EDIT — re-run `make gen-clients`.
+//
+// Usage:
+//   import "./generated/events"  // side-effect: registers interceptors
+//
+//   window.addEventListener("cmdop:network-error", (e) => {
+//     console.log(e.detail.status, e.detail.method, e.detail.url);
+//   });
+
+import { client } from "../client.gen";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Event names + detail types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const NETWORK_ERROR_EVENT = "cmdop:network-error" as const;
+export const VALIDATION_ERROR_EVENT = "cmdop:validation-error" as const;
+export const RUNTIME_ERROR_EVENT = "cmdop:runtime-error" as const;
+
+export interface NetworkErrorDetail {
+  /** HTTP method (GET/POST/...). */
+  method: string;
+  /** Request URL. */
+  url: string;
+  /** HTTP status if response arrived; null on transport failure. */
+  status: number | null;
+  /** Response body parsed as text (best-effort, may be empty). */
+  body?: string;
+  /** Underlying error message (network failures, abort, etc.). */
+  error?: string;
+  /** Heuristic: did the request likely fail due to CORS? */
+  possiblyCors: boolean;
+  timestamp: Date;
+}
+
+export interface ValidationErrorDetail {
+  /** Operation ID this validation applies to (from the OpenAPI spec). */
+  operation: string;
+  /** Schema name that failed (if known). */
+  schema?: string;
+  /** Issues array — shape mirrors zod's ZodIssue but kept opaque here to
+   *  avoid forcing a hard zod dep on consumers that don't use schemas. */
+  issues: unknown;
+  /** Raw response data that failed validation. */
+  data: unknown;
+  timestamp: Date;
+}
+
+export interface RuntimeErrorDetail {
+  /** Free-form source identifier — component name, hook name, etc. */
+  source: string;
+  message: string;
+  /** Original Error object (may be undefined when caller lacks one). */
+  error?: Error;
+  /** Arbitrary context payload from the caller. */
+  context?: Record<string, unknown>;
+  timestamp: Date;
+}
+
+// Augment the global WindowEventMap so addEventListener gets typed details.
+declare global {
+  interface WindowEventMap {
+    "cmdop:network-error": CustomEvent<NetworkErrorDetail>;
+    "cmdop:validation-error": CustomEvent<ValidationErrorDetail>;
+    "cmdop:runtime-error": CustomEvent<RuntimeErrorDetail>;
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Dispatch helpers
+// ─────────────────────────────────────────────────────────────────────────────
+
+function _dispatch<T>(name: string, detail: T): void {
+  if (typeof window === "undefined") return;
+  try {
+    window.dispatchEvent(new CustomEvent(name, { detail, bubbles: true }));
+  } catch {
+    // Event dispatch must never crash the app.
+  }
+}
+
+/** Emit a runtime error from anywhere in app code. */
+export function emitRuntimeError(
+  source: string,
+  message: string,
+  error?: Error,
+  context?: Record<string, unknown>,
+): void {
+  _dispatch<RuntimeErrorDetail>(RUNTIME_ERROR_EVENT, {
+    source,
+    message,
+    error,
+    context,
+    timestamp: new Date(),
+  });
+}
+
+/** Emit a zod validation failure. Called by hooks when `validate` is provided. */
+export function dispatchValidationError(
+  operation: string,
+  data: unknown,
+  issues: unknown,
+  schema?: string,
+): void {
+  _dispatch<ValidationErrorDetail>(VALIDATION_ERROR_EVENT, {
+    operation,
+    schema,
+    issues,
+    data,
+    timestamp: new Date(),
+  });
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Listen helpers — typed wrappers over addEventListener, return cleanup fn.
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function onNetworkError(
+  cb: (detail: NetworkErrorDetail) => void,
+): () => void {
+  if (typeof window === "undefined") return () => {};
+  const handler = (e: CustomEvent<NetworkErrorDetail>) => cb(e.detail);
+  window.addEventListener(NETWORK_ERROR_EVENT, handler);
+  return () => window.removeEventListener(NETWORK_ERROR_EVENT, handler);
+}
+
+export function onValidationError(
+  cb: (detail: ValidationErrorDetail) => void,
+): () => void {
+  if (typeof window === "undefined") return () => {};
+  const handler = (e: CustomEvent<ValidationErrorDetail>) => cb(e.detail);
+  window.addEventListener(VALIDATION_ERROR_EVENT, handler);
+  return () => window.removeEventListener(VALIDATION_ERROR_EVENT, handler);
+}
+
+export function onRuntimeError(
+  cb: (detail: RuntimeErrorDetail) => void,
+): () => void {
+  if (typeof window === "undefined") return () => {};
+  const handler = (e: CustomEvent<RuntimeErrorDetail>) => cb(e.detail);
+  window.addEventListener(RUNTIME_ERROR_EVENT, handler);
+  return () => window.removeEventListener(RUNTIME_ERROR_EVENT, handler);
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Hey API interceptors — wire once, emit on response/error.
+// ─────────────────────────────────────────────────────────────────────────────
+
+let _wired = false;
+
+function _wire(): void {
+  if (_wired) return;
+  _wired = true;
+
+  // response interceptor: every response, OK or not, lets us see status.
+  // We only emit for non-2xx — successful requests are silent.
+  client.interceptors.response.use(async (response, request) => {
+    if (!response.ok) {
+      let body: string | undefined;
+      try {
+        body = await response.clone().text();
+        if (body.length > 4000) body = body.slice(0, 4000) + "…";
+      } catch {
+        // ignore — body inaccessible
+      }
+      _dispatch<NetworkErrorDetail>(NETWORK_ERROR_EVENT, {
+        method: request.method,
+        url: request.url,
+        status: response.status,
+        body,
+        possiblyCors: false,
+        timestamp: new Date(),
+      });
+    }
+    return response;
+  });
+
+  // error interceptor: transport-level failures (abort, DNS, CORS, offline).
+  client.interceptors.error.use((error, _response, request) => {
+    const msg = error instanceof Error ? error.message : String(error);
+    // Heuristic: CORS-blocked fetches usually surface as "Failed to fetch"
+    // without a status. Not perfect, but catches the common case.
+    const possiblyCors = /failed to fetch|network error|cors/i.test(msg);
+    _dispatch<NetworkErrorDetail>(NETWORK_ERROR_EVENT, {
+      method: request?.method ?? "UNKNOWN",
+      url: request?.url ?? "",
+      status: null,
+      error: msg,
+      possiblyCors,
+      timestamp: new Date(),
+    });
+    return error;
+  });
+}
+
+_wire();

package/src/_api/generated/_cfg_centrifugo/hooks/index.ts

@@ -0,0 +1,4 @@
+// AUTO-GENERATED — barrel for all hooks.
+// DO NOT EDIT.
+
+export { useCfgCentrifugoAuthTokenRetrieve } from "./useCfgCentrifugoAuthTokenRetrieve";

package/src/_api/generated/_cfg_centrifugo/hooks/useCfgCentrifugoAuthTokenRetrieve.ts

@@ -0,0 +1,25 @@
+// AUTO-GENERATED by openapi_processor / ts.hooks
+// Get Centrifugo connection token
+// DO NOT EDIT — re-run `make gen`.
+
+import useSWR from "swr";
+import type { SWRConfiguration } from "swr";
+import { Cfg } from "../../sdk.gen";
+import type { CfgCentrifugoAuthTokenRetrieveData, CfgCentrifugoAuthTokenRetrieveResponses } from "../../types.gen";
+
+type Result = CfgCentrifugoAuthTokenRetrieveResponses[keyof CfgCentrifugoAuthTokenRetrieveResponses];
+
+export function useCfgCentrifugoAuthTokenRetrieve(
+  args?: Omit<CfgCentrifugoAuthTokenRetrieveData, "url" | "body">,
+  config?: SWRConfiguration<Result>,
+) {
+  const key = ["cfg_centrifugo_auth_token_retrieve", args ?? {}] as const;
+  return useSWR<Result>(
+    key,
+    async () => {
+      const res = await Cfg.cfgCentrifugoAuthTokenRetrieve({ ...(args ?? {}), throwOnError: true } as never);
+      return res.data as Result;
+    },
+    config,
+  );
+}

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

@@ -0,0 +1,29 @@
+// AUTO-GENERATED by django_generator / ts_extras.wrapper
+// Group barrel. DO NOT EDIT — re-run `make gen`.
+
+// Wrapper class + per-group SDK re-exports
+export { API, type APIOptions,  } from './api';
+
+// Shared utilities (storage / errors / logger / validation events)
+export {
+  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 '../helpers';
+
+// Generated artifacts (Hey API)
+export type * from '../types.gen';

package/src/_api/generated/_cfg_centrifugo/schemas/ConnectionTokenResponse.ts

@@ -0,0 +1,14 @@
+// AUTO-GENERATED by cmdop_server / devtools.generator.ts_extras
+// Source: OpenAPI 3.1 components.schemas
+// DO NOT EDIT — re-run `make gen-clients`.
+
+import { z } from "zod";
+
+export const ConnectionTokenResponseSchema = z.object({
+  centrifugo_url: z.string(),
+  channels: z.array(z.string()),
+  expires_at: z.string(),
+  token: z.string(),
+});
+
+export type ConnectionTokenResponse = z.infer<typeof ConnectionTokenResponseSchema>;

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

@@ -0,0 +1,4 @@
+// AUTO-GENERATED — barrel for zod schemas.
+// DO NOT EDIT.
+
+export * from "./ConnectionTokenResponse";

package/src/_api/generated/_cfg_centrifugo/sdk.gen.ts

@@ -0,0 +1,5 @@
+// AUTO-GENERATED by openapi_processor / ts.tool
+// Re-exports the top-level Hey API SDK so group-scoped imports work:
+//   import { Foo } from "@api/generated/_<group>/sdk.gen";
+// DO NOT EDIT — re-run `make gen`.
+export * from "../sdk.gen";

package/src/_api/generated/_cfg_centrifugo/types.gen.ts

@@ -0,0 +1,5 @@
+// AUTO-GENERATED by openapi_processor / ts.tool
+// Re-exports the top-level Hey API types so group-scoped imports work:
+//   import type { Foo } from "@api/generated/_<group>/types.gen";
+// DO NOT EDIT — re-run `make gen`.
+export * from "../types.gen";

package/src/_api/generated/_cfg_totp/api.ts

@@ -0,0 +1,120 @@
+// AUTO-GENERATED by django_generator / ts_extras.wrapper
+// Self-contained API wrapper for this group. DO NOT EDIT — re-run `make gen`.
+
+import { client } from '../client.gen';
+import type { StorageAdapter } from '../helpers/storage';
+import { LocalStorageAdapter } from '../helpers/storage';
+import { APILogger, type LoggerConfig } from '../helpers/logger';
+
+
+
+
+const ACCESS_KEY = 'cfg.access_token';
+const REFRESH_KEY = 'cfg.refresh_token';
+
+
+
+/** Auto-detect locale from cookie NEXT_LOCALE or navigator.language. */
+function detectLocale(): string | null {
+  try {
+    if (typeof document !== 'undefined') {
+      const m = document.cookie.match(/(?:^|;\s*)NEXT_LOCALE=([^;]*)/);
+      if (m) return decodeURIComponent(m[1]);
+    }
+    if (typeof navigator !== 'undefined' && navigator.language) {
+      return navigator.language;
+    }
+  } catch {}
+  return null;
+}
+
+export interface APIOptions {
+  /** Override storage backend (LocalStorage by default; Memory for SSR/tests). */
+  storage?: StorageAdapter;
+  /** Logger config (defaults to dev-only). */
+  logger?: Partial<LoggerConfig>;
+  /** Locale for `Accept-Language`. If omitted, auto-detected from cookie/navigator. */
+  locale?: string;
+  /** API key sent as `X-API-Key`. Falls back to NEXT_PUBLIC_API_KEY. */
+  apiKey?: string;
+  /** Send Django session/CSRF cookies cross-origin. Defaults to true. */
+  withCredentials?: boolean;
+}
+
+/**
+ * Self-contained API wrapper for this group.
+ *
+ * Each group has its own client + interceptor + token store. The interceptor
+ * automatically attaches:
+ *   - `Authorization: Bearer <jwt>` from storage
+ *   - `Accept-Language` from `opts.locale` or `NEXT_LOCALE` cookie
+ *   - `X-API-Key` from `opts.apiKey` or `NEXT_PUBLIC_API_KEY`
+ *   - `credentials: 'include'` for Django session/CSRF cookies (toggle via opts)
+ */
+export class API {
+  private baseUrl: string;
+  private storage: StorageAdapter;
+  private locale: string | null;
+  private apiKey: string | null;
+  readonly logger: APILogger;
+
+
+
+  constructor(baseUrl: string, opts: APIOptions = {}) {
+    this.baseUrl = baseUrl.replace(/\/$/, '');
+    this.storage = opts.storage ?? new LocalStorageAdapter();
+    this.logger = new APILogger(opts.logger);
+    this.locale = opts.locale ?? null;
+    this.apiKey = opts.apiKey ?? (typeof process !== 'undefined' ? (process.env?.NEXT_PUBLIC_API_KEY ?? null) : null);
+
+    const credentials: RequestCredentials = (opts.withCredentials ?? true) ? 'include' : 'same-origin';
+    client.setConfig({ baseUrl: this.baseUrl, credentials });
+
+    client.interceptors.request.use((request) => {
+      const access = this.getToken();
+      if (access) request.headers.set('Authorization', `Bearer ${access}`);
+
+      const locale = this.locale ?? detectLocale();
+      if (locale) request.headers.set('Accept-Language', locale);
+
+      if (this.apiKey) request.headers.set('X-API-Key', this.apiKey);
+
+      return request;
+    });
+
+
+  }
+
+  // ── Base URL ────────────────────────────────────────────────────────────
+  getBaseUrl(): string { return this.baseUrl; }
+  setBaseUrl(url: string): void {
+    this.baseUrl = url.replace(/\/$/, '');
+    client.setConfig({ baseUrl: this.baseUrl });
+  }
+
+  // ── Tokens ──────────────────────────────────────────────────────────────
+  getToken(): string | null { return this.storage.getItem(ACCESS_KEY); }
+  setToken(token: string | null): void {
+    if (token) this.storage.setItem(ACCESS_KEY, token);
+    else this.storage.removeItem(ACCESS_KEY);
+  }
+  getRefreshToken(): string | null { return this.storage.getItem(REFRESH_KEY); }
+  setRefreshToken(token: string | null): void {
+    if (token) this.storage.setItem(REFRESH_KEY, token);
+    else this.storage.removeItem(REFRESH_KEY);
+  }
+  clearToken(): void {
+    this.storage.removeItem(ACCESS_KEY);
+    this.storage.removeItem(REFRESH_KEY);
+  }
+  isAuthenticated(): boolean { return this.getToken() !== null; }
+
+  // ── Locale / API key ────────────────────────────────────────────────────
+  getLocale(): string | null { return this.locale ?? detectLocale(); }
+  setLocale(locale: string | null): void { this.locale = locale; }
+  getApiKey(): string | null { return this.apiKey; }
+  setApiKey(key: string | null): void { this.apiKey = key; }
+}
+
+export {  };
+export { client };

package/src/_api/generated/_cfg_totp/events.ts

@@ -0,0 +1,198 @@
+// AUTO-GENERATED by cmdop_server / devtools.generator.ts_extras.events
+// Hooks Hey API client interceptors → typed CustomEvents on `window`.
+// DO NOT EDIT — re-run `make gen-clients`.
+//
+// Usage:
+//   import "./generated/events"  // side-effect: registers interceptors
+//
+//   window.addEventListener("cmdop:network-error", (e) => {
+//     console.log(e.detail.status, e.detail.method, e.detail.url);
+//   });
+
+import { client } from "../client.gen";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Event names + detail types
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const NETWORK_ERROR_EVENT = "cmdop:network-error" as const;
+export const VALIDATION_ERROR_EVENT = "cmdop:validation-error" as const;
+export const RUNTIME_ERROR_EVENT = "cmdop:runtime-error" as const;
+
+export interface NetworkErrorDetail {
+  /** HTTP method (GET/POST/...). */
+  method: string;
+  /** Request URL. */
+  url: string;
+  /** HTTP status if response arrived; null on transport failure. */
+  status: number | null;
+  /** Response body parsed as text (best-effort, may be empty). */
+  body?: string;
+  /** Underlying error message (network failures, abort, etc.). */
+  error?: string;
+  /** Heuristic: did the request likely fail due to CORS? */
+  possiblyCors: boolean;
+  timestamp: Date;
+}
+
+export interface ValidationErrorDetail {
+  /** Operation ID this validation applies to (from the OpenAPI spec). */
+  operation: string;
+  /** Schema name that failed (if known). */
+  schema?: string;
+  /** Issues array — shape mirrors zod's ZodIssue but kept opaque here to
+   *  avoid forcing a hard zod dep on consumers that don't use schemas. */
+  issues: unknown;
+  /** Raw response data that failed validation. */
+  data: unknown;
+  timestamp: Date;
+}
+
+export interface RuntimeErrorDetail {
+  /** Free-form source identifier — component name, hook name, etc. */
+  source: string;
+  message: string;
+  /** Original Error object (may be undefined when caller lacks one). */
+  error?: Error;
+  /** Arbitrary context payload from the caller. */
+  context?: Record<string, unknown>;
+  timestamp: Date;
+}
+
+// Augment the global WindowEventMap so addEventListener gets typed details.
+declare global {
+  interface WindowEventMap {
+    "cmdop:network-error": CustomEvent<NetworkErrorDetail>;
+    "cmdop:validation-error": CustomEvent<ValidationErrorDetail>;
+    "cmdop:runtime-error": CustomEvent<RuntimeErrorDetail>;
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Dispatch helpers
+// ─────────────────────────────────────────────────────────────────────────────
+
+function _dispatch<T>(name: string, detail: T): void {
+  if (typeof window === "undefined") return;
+  try {
+    window.dispatchEvent(new CustomEvent(name, { detail, bubbles: true }));
+  } catch {
+    // Event dispatch must never crash the app.
+  }
+}
+
+/** Emit a runtime error from anywhere in app code. */
+export function emitRuntimeError(
+  source: string,
+  message: string,
+  error?: Error,
+  context?: Record<string, unknown>,
+): void {
+  _dispatch<RuntimeErrorDetail>(RUNTIME_ERROR_EVENT, {
+    source,
+    message,
+    error,
+    context,
+    timestamp: new Date(),
+  });
+}
+
+/** Emit a zod validation failure. Called by hooks when `validate` is provided. */
+export function dispatchValidationError(
+  operation: string,
+  data: unknown,
+  issues: unknown,
+  schema?: string,
+): void {
+  _dispatch<ValidationErrorDetail>(VALIDATION_ERROR_EVENT, {
+    operation,
+    schema,
+    issues,
+    data,
+    timestamp: new Date(),
+  });
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Listen helpers — typed wrappers over addEventListener, return cleanup fn.
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function onNetworkError(
+  cb: (detail: NetworkErrorDetail) => void,
+): () => void {
+  if (typeof window === "undefined") return () => {};
+  const handler = (e: CustomEvent<NetworkErrorDetail>) => cb(e.detail);
+  window.addEventListener(NETWORK_ERROR_EVENT, handler);
+  return () => window.removeEventListener(NETWORK_ERROR_EVENT, handler);
+}
+
+export function onValidationError(
+  cb: (detail: ValidationErrorDetail) => void,
+): () => void {
+  if (typeof window === "undefined") return () => {};
+  const handler = (e: CustomEvent<ValidationErrorDetail>) => cb(e.detail);
+  window.addEventListener(VALIDATION_ERROR_EVENT, handler);
+  return () => window.removeEventListener(VALIDATION_ERROR_EVENT, handler);
+}
+
+export function onRuntimeError(
+  cb: (detail: RuntimeErrorDetail) => void,
+): () => void {
+  if (typeof window === "undefined") return () => {};
+  const handler = (e: CustomEvent<RuntimeErrorDetail>) => cb(e.detail);
+  window.addEventListener(RUNTIME_ERROR_EVENT, handler);
+  return () => window.removeEventListener(RUNTIME_ERROR_EVENT, handler);
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Hey API interceptors — wire once, emit on response/error.
+// ─────────────────────────────────────────────────────────────────────────────
+
+let _wired = false;
+
+function _wire(): void {
+  if (_wired) return;
+  _wired = true;
+
+  // response interceptor: every response, OK or not, lets us see status.
+  // We only emit for non-2xx — successful requests are silent.
+  client.interceptors.response.use(async (response, request) => {
+    if (!response.ok) {
+      let body: string | undefined;
+      try {
+        body = await response.clone().text();
+        if (body.length > 4000) body = body.slice(0, 4000) + "…";
+      } catch {
+        // ignore — body inaccessible
+      }
+      _dispatch<NetworkErrorDetail>(NETWORK_ERROR_EVENT, {
+        method: request.method,
+        url: request.url,
+        status: response.status,
+        body,
+        possiblyCors: false,
+        timestamp: new Date(),
+      });
+    }
+    return response;
+  });
+
+  // error interceptor: transport-level failures (abort, DNS, CORS, offline).
+  client.interceptors.error.use((error, _response, request) => {
+    const msg = error instanceof Error ? error.message : String(error);
+    // Heuristic: CORS-blocked fetches usually surface as "Failed to fetch"
+    // without a status. Not perfect, but catches the common case.
+    const possiblyCors = /failed to fetch|network error|cors/i.test(msg);
+    _dispatch<NetworkErrorDetail>(NETWORK_ERROR_EVENT, {
+      method: request?.method ?? "UNKNOWN",
+      url: request?.url ?? "",
+      status: null,
+      error: msg,
+      possiblyCors,
+      timestamp: new Date(),
+    });
+    return error;
+  });
+}
+
+_wire();

package/src/_api/generated/_cfg_totp/hooks/index.ts

@@ -0,0 +1,12 @@
+// AUTO-GENERATED — barrel for all hooks.
+// DO NOT EDIT.
+
+export { useCfgTotpBackupCodesRegenerateCreate } from "./useCfgTotpBackupCodesRegenerateCreate";
+export { useCfgTotpBackupCodesRetrieve } from "./useCfgTotpBackupCodesRetrieve";
+export { useCfgTotpDevicesDestroy } from "./useCfgTotpDevicesDestroy";
+export { useCfgTotpDevicesRetrieve } from "./useCfgTotpDevicesRetrieve";
+export { useCfgTotpDisableCreate } from "./useCfgTotpDisableCreate";
+export { useCfgTotpSetupConfirmCreate } from "./useCfgTotpSetupConfirmCreate";
+export { useCfgTotpSetupCreate } from "./useCfgTotpSetupCreate";
+export { useCfgTotpVerifyBackupCreate } from "./useCfgTotpVerifyBackupCreate";
+export { useCfgTotpVerifyCreate } from "./useCfgTotpVerifyCreate";

package/src/_api/generated/_cfg_totp/hooks/useCfgTotpBackupCodesRegenerateCreate.ts

@@ -0,0 +1,24 @@
+// AUTO-GENERATED by openapi_processor / ts.hooks
+// POST /cfg/totp/backup-codes/regenerate/
+// DO NOT EDIT — re-run `make gen`.
+
+import useSWRMutation from "swr/mutation";
+import type { SWRMutationConfiguration } from "swr/mutation";
+import { Cfg } from "../../sdk.gen";
+import type { CfgTotpBackupCodesRegenerateCreateData, CfgTotpBackupCodesRegenerateCreateResponses } from "../../types.gen";
+
+type Args = Omit<CfgTotpBackupCodesRegenerateCreateData, "url">;
+type Result = CfgTotpBackupCodesRegenerateCreateResponses[keyof CfgTotpBackupCodesRegenerateCreateResponses];
+
+export function useCfgTotpBackupCodesRegenerateCreate(
+  config?: SWRMutationConfiguration<Result, Error, readonly ["cfg_totp_backup_codes_regenerate_create"], Args>,
+) {
+  return useSWRMutation<Result, Error, readonly ["cfg_totp_backup_codes_regenerate_create"], Args>(
+    ["cfg_totp_backup_codes_regenerate_create"] as const,
+    async (_key, { arg }: { arg: Args }) => {
+      const res = await Cfg.cfgTotpBackupCodesRegenerateCreate({ ...arg, throwOnError: true } as never);
+      return res.data as Result;
+    },
+    config,
+  );
+}

package/src/_api/generated/_cfg_totp/hooks/useCfgTotpBackupCodesRetrieve.ts

@@ -0,0 +1,25 @@
+// AUTO-GENERATED by openapi_processor / ts.hooks
+// GET /cfg/totp/backup-codes/
+// DO NOT EDIT — re-run `make gen`.
+
+import useSWR from "swr";
+import type { SWRConfiguration } from "swr";
+import { Cfg } from "../../sdk.gen";
+import type { CfgTotpBackupCodesRetrieveData, CfgTotpBackupCodesRetrieveResponses } from "../../types.gen";
+
+type Result = CfgTotpBackupCodesRetrieveResponses[keyof CfgTotpBackupCodesRetrieveResponses];
+
+export function useCfgTotpBackupCodesRetrieve(
+  args?: Omit<CfgTotpBackupCodesRetrieveData, "url" | "body">,
+  config?: SWRConfiguration<Result>,
+) {
+  const key = ["cfg_totp_backup_codes_retrieve", args ?? {}] as const;
+  return useSWR<Result>(
+    key,
+    async () => {
+      const res = await Cfg.cfgTotpBackupCodesRetrieve({ ...(args ?? {}), throwOnError: true } as never);
+      return res.data as Result;
+    },
+    config,
+  );
+}