@djangocfg/api 2.1.322 → 2.1.327

package/src/_api/generated/cfg_centrifugo/core/utils.gen.ts

@@ -0,0 +1,140 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+import type { BodySerializer, QuerySerializer } from './bodySerializer.gen';
+import {
+  type ArraySeparatorStyle,
+  serializeArrayParam,
+  serializeObjectParam,
+  serializePrimitiveParam,
+} from './pathSerializer.gen';
+
+export interface PathSerializer {
+  path: Record<string, unknown>;
+  url: string;
+}
+
+export const PATH_PARAM_RE = /\{[^{}]+\}/g;
+
+export const defaultPathSerializer = ({ path, url: _url }: PathSerializer) => {
+  let url = _url;
+  const matches = _url.match(PATH_PARAM_RE);
+  if (matches) {
+    for (const match of matches) {
+      let explode = false;
+      let name = match.substring(1, match.length - 1);
+      let style: ArraySeparatorStyle = 'simple';
+
+      if (name.endsWith('*')) {
+        explode = true;
+        name = name.substring(0, name.length - 1);
+      }
+
+      if (name.startsWith('.')) {
+        name = name.substring(1);
+        style = 'label';
+      } else if (name.startsWith(';')) {
+        name = name.substring(1);
+        style = 'matrix';
+      }
+
+      const value = path[name];
+
+      if (value === undefined || value === null) {
+        continue;
+      }
+
+      if (Array.isArray(value)) {
+        url = url.replace(match, serializeArrayParam({ explode, name, style, value }));
+        continue;
+      }
+
+      if (typeof value === 'object') {
+        url = url.replace(
+          match,
+          serializeObjectParam({
+            explode,
+            name,
+            style,
+            value: value as Record<string, unknown>,
+            valueOnly: true,
+          }),
+        );
+        continue;
+      }
+
+      if (style === 'matrix') {
+        url = url.replace(
+          match,
+          `;${serializePrimitiveParam({
+            name,
+            value: value as string,
+          })}`,
+        );
+        continue;
+      }
+
+      const replaceValue = encodeURIComponent(
+        style === 'label' ? `.${value as string}` : (value as string),
+      );
+      url = url.replace(match, replaceValue);
+    }
+  }
+  return url;
+};
+
+export const getUrl = ({
+  baseUrl,
+  path,
+  query,
+  querySerializer,
+  url: _url,
+}: {
+  baseUrl?: string;
+  path?: Record<string, unknown>;
+  query?: Record<string, unknown>;
+  querySerializer: QuerySerializer;
+  url: string;
+}) => {
+  const pathUrl = _url.startsWith('/') ? _url : `/${_url}`;
+  let url = (baseUrl ?? '') + pathUrl;
+  if (path) {
+    url = defaultPathSerializer({ path, url });
+  }
+  let search = query ? querySerializer(query) : '';
+  if (search.startsWith('?')) {
+    search = search.substring(1);
+  }
+  if (search) {
+    url += `?${search}`;
+  }
+  return url;
+};
+
+export function getValidRequestBody(options: {
+  body?: unknown;
+  bodySerializer?: BodySerializer | null;
+  serializedBody?: unknown;
+}) {
+  const hasBody = options.body !== undefined;
+  const isSerializedBody = hasBody && options.bodySerializer;
+
+  if (isSerializedBody) {
+    if ('serializedBody' in options) {
+      const hasSerializedBody =
+        options.serializedBody !== undefined && options.serializedBody !== '';
+
+      return hasSerializedBody ? options.serializedBody : null;
+    }
+
+    // not all clients implement a serializedBody property (i.e., client-axios)
+    return options.body !== '' ? options.body : null;
+  }
+
+  // plain/text body
+  if (hasBody) {
+    return options.body;
+  }
+
+  // no body was provided
+  return undefined;
+}

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

@@ -0,0 +1,198 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras.events
+// Hooks Hey API client interceptors → typed CustomEvents on `window`.
+// DO NOT EDIT — re-run `make gen`.
+//
+// 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 hooks.
+// DO NOT EDIT.
+
+export { useCfgCentrifugoAuthTokenRetrieve } from "./useCfgCentrifugoAuthTokenRetrieve";

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

@@ -0,0 +1,26 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// 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 Args = Omit<CfgCentrifugoAuthTokenRetrieveData, "url"> | undefined;
+type Result = CfgCentrifugoAuthTokenRetrieveResponses[keyof CfgCentrifugoAuthTokenRetrieveResponses];
+
+export function useCfgCentrifugoAuthTokenRetrieve(
+  args: Args,
+  config?: SWRConfiguration<Result>,
+) {
+  const key = args ? ["cfg_centrifugo_auth_token_retrieve", args] as const : null;
+  return useSWR<Result>(
+    key,
+    async () => {
+      const res = await Cfg.cfgCentrifugoAuthTokenRetrieve({ ...(args ?? {}), throwOnError: true } as never);
+      return res.data as Result;
+    },
+    config,
+  );
+}