@djangocfg/monitor 2.1.321 → 2.1.327

package/src/_api/generated/cfg_monitor/core/types.gen.ts

@@ -0,0 +1,104 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+import type { Auth, AuthToken } from './auth.gen';
+import type { BodySerializer, QuerySerializer, QuerySerializerOptions } from './bodySerializer.gen';
+
+export type HttpMethod =
+  | 'connect'
+  | 'delete'
+  | 'get'
+  | 'head'
+  | 'options'
+  | 'patch'
+  | 'post'
+  | 'put'
+  | 'trace';
+
+export type Client<
+  RequestFn = never,
+  Config = unknown,
+  MethodFn = never,
+  BuildUrlFn = never,
+  SseFn = never,
+> = {
+  /**
+   * Returns the final request URL.
+   */
+  buildUrl: BuildUrlFn;
+  getConfig: () => Config;
+  request: RequestFn;
+  setConfig: (config: Config) => Config;
+} & {
+  [K in HttpMethod]: MethodFn;
+} & ([SseFn] extends [never] ? { sse?: never } : { sse: { [K in HttpMethod]: SseFn } });
+
+export interface Config {
+  /**
+   * Auth token or a function returning auth token. The resolved value will be
+   * added to the request payload as defined by its `security` array.
+   */
+  auth?: ((auth: Auth) => Promise<AuthToken> | AuthToken) | AuthToken;
+  /**
+   * A function for serializing request body parameter. By default,
+   * {@link JSON.stringify()} will be used.
+   */
+  bodySerializer?: BodySerializer | null;
+  /**
+   * An object containing any HTTP headers that you want to pre-populate your
+   * `Headers` object with.
+   *
+   * {@link https://developer.mozilla.org/docs/Web/API/Headers/Headers#init See more}
+   */
+  headers?:
+    | RequestInit['headers']
+    | Record<
+        string,
+        string | number | boolean | (string | number | boolean)[] | null | undefined | unknown
+      >;
+  /**
+   * The request method.
+   *
+   * {@link https://developer.mozilla.org/docs/Web/API/fetch#method See more}
+   */
+  method?: Uppercase<HttpMethod>;
+  /**
+   * A function for serializing request query parameters. By default, arrays
+   * will be exploded in form style, objects will be exploded in deepObject
+   * style, and reserved characters are percent-encoded.
+   *
+   * This method will have no effect if the native `paramsSerializer()` Axios
+   * API function is used.
+   *
+   * {@link https://swagger.io/docs/specification/serialization/#query View examples}
+   */
+  querySerializer?: QuerySerializer | QuerySerializerOptions;
+  /**
+   * A function validating request data. This is useful if you want to ensure
+   * the request conforms to the desired shape, so it can be safely sent to
+   * the server.
+   */
+  requestValidator?: (data: unknown) => Promise<unknown>;
+  /**
+   * A function transforming response data before it's returned. This is useful
+   * for post-processing data, e.g., converting ISO strings into Date objects.
+   */
+  responseTransformer?: (data: unknown) => Promise<unknown>;
+  /**
+   * A function validating response data. This is useful if you want to ensure
+   * the response conforms to the desired shape, so it can be safely passed to
+   * the transformers and returned to the user.
+   */
+  responseValidator?: (data: unknown) => Promise<unknown>;
+}
+
+type IsExactlyNeverOrNeverUndefined<T> = [T] extends [never]
+  ? true
+  : [T] extends [never | undefined]
+    ? [undefined] extends [T]
+      ? false
+      : true
+    : false;
+
+export type OmitNever<T extends Record<string, unknown>> = {
+  [K in keyof T as IsExactlyNeverOrNeverUndefined<T[K]> extends true ? never : K]: T[K];
+};

package/src/_api/generated/cfg_monitor/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_monitor/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_monitor/hooks/index.ts

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

package/src/_api/generated/cfg_monitor/hooks/useCfgMonitorIngestCreate.ts

@@ -0,0 +1,24 @@
+// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// Ingest browser events
+// 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 { CfgMonitorIngestCreateData, CfgMonitorIngestCreateResponses } from "../types.gen";
+
+type Args = Omit<CfgMonitorIngestCreateData, "url">;
+type Result = CfgMonitorIngestCreateResponses[keyof CfgMonitorIngestCreateResponses];
+
+export function useCfgMonitorIngestCreate(
+  config?: SWRMutationConfiguration<Result, Error, readonly ["cfg_monitor_ingest_create"], Args>,
+) {
+  return useSWRMutation<Result, Error, readonly ["cfg_monitor_ingest_create"], Args>(
+    ["cfg_monitor_ingest_create"] as const,
+    async (_key, { arg }: { arg: Args }) => {
+      const res = await Cfg.cfgMonitorIngestCreate({ ...arg, throwOnError: true } as never);
+      return res.data as Result;
+    },
+    config,
+  );
+}