@djangocfg/monitor 2.1.322 → 2.1.331

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

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

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

@@ -0,0 +1,24 @@
+// AUTO-GENERATED by openapi_processor / ts.hooks
+// 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,
+  );
+}

package/src/_api/generated/_cfg_monitor/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_monitor/schemas/EventTypeEnum.ts

@@ -0,0 +1,9 @@
+// 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 EventTypeEnumSchema = z.enum(["JS_ERROR", "NETWORK_ERROR", "ERROR", "WARNING", "PAGE_VIEW", "PERFORMANCE", "CONSOLE"]);
+
+export type EventTypeEnum = z.infer<typeof EventTypeEnumSchema>;

package/src/_api/generated/_cfg_monitor/schemas/FrontendEventIngestRequest.ts

@@ -0,0 +1,27 @@
+// 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";
+import { EventTypeEnumSchema } from "./EventTypeEnum";
+import { LevelEnumSchema } from "./LevelEnum";
+
+export const FrontendEventIngestRequestSchema = z.object({
+  build_id: z.string().max(100).default("").optional(),
+  environment: z.string().max(20).default("").optional(),
+  event_type: EventTypeEnumSchema,
+  extra: z.unknown().optional(),
+  fingerprint: z.string().max(64).default("").optional(),
+  http_method: z.string().max(10).default("").optional(),
+  http_status: z.number().int().nullable().optional(),
+  http_url: z.string().max(2000).default("").optional(),
+  level: LevelEnumSchema.optional(),
+  message: z.string().min(1).max(5000),
+  project_name: z.string().max(100).default("").optional(),
+  session_id: z.string().max(64).default("").optional(),
+  stack_trace: z.string().max(10000).default("").optional(),
+  url: z.string().max(2000).default("").optional(),
+  user_agent: z.string().max(500).default("").optional(),
+});
+
+export type FrontendEventIngestRequest = z.infer<typeof FrontendEventIngestRequestSchema>;

package/src/_api/generated/_cfg_monitor/schemas/IngestBatchRequest.ts

@@ -0,0 +1,12 @@
+// 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";
+import { FrontendEventIngestRequestSchema } from "./FrontendEventIngestRequest";
+
+export const IngestBatchRequestSchema = z.object({
+  events: z.array(FrontendEventIngestRequestSchema),
+});
+
+export type IngestBatchRequest = z.infer<typeof IngestBatchRequestSchema>;

package/src/_api/generated/_cfg_monitor/schemas/LevelEnum.ts

@@ -0,0 +1,9 @@
+// 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 LevelEnumSchema = z.enum(["error", "warning", "info", "debug"]);
+
+export type LevelEnum = z.infer<typeof LevelEnumSchema>;

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

@@ -0,0 +1,7 @@
+// AUTO-GENERATED — barrel for zod schemas.
+// DO NOT EDIT.
+
+export * from "./EventTypeEnum";
+export * from "./FrontendEventIngestRequest";
+export * from "./IngestBatchRequest";
+export * from "./LevelEnum";

package/src/_api/generated/_cfg_monitor/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_monitor/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/client/client.gen.ts

@@ -0,0 +1,280 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+import { createSseClient } from '../core/serverSentEvents.gen';
+import type { HttpMethod } from '../core/types.gen';
+import { getValidRequestBody } from '../core/utils.gen';
+import type { Client, Config, RequestOptions, ResolvedRequestOptions } from './types.gen';
+import {
+  buildUrl,
+  createConfig,
+  createInterceptors,
+  getParseAs,
+  mergeConfigs,
+  mergeHeaders,
+  setAuthParams,
+} from './utils.gen';
+
+type ReqInit = Omit<RequestInit, 'body' | 'headers'> & {
+  body?: any;
+  headers: ReturnType<typeof mergeHeaders>;
+};
+
+export const createClient = (config: Config = {}): Client => {
+  let _config = mergeConfigs(createConfig(), config);
+
+  const getConfig = (): Config => ({ ..._config });
+
+  const setConfig = (config: Config): Config => {
+    _config = mergeConfigs(_config, config);
+    return getConfig();
+  };
+
+  const interceptors = createInterceptors<Request, Response, unknown, ResolvedRequestOptions>();
+
+  const beforeRequest = async <
+    TData = unknown,
+    TResponseStyle extends 'data' | 'fields' = 'fields',
+    ThrowOnError extends boolean = boolean,
+    Url extends string = string,
+  >(
+    options: RequestOptions<TData, TResponseStyle, ThrowOnError, Url>,
+  ) => {
+    const opts = {
+      ..._config,
+      ...options,
+      fetch: options.fetch ?? _config.fetch ?? globalThis.fetch,
+      headers: mergeHeaders(_config.headers, options.headers),
+      serializedBody: undefined as string | undefined,
+    };
+
+    if (opts.security) {
+      await setAuthParams({
+        ...opts,
+        security: opts.security,
+      });
+    }
+
+    if (opts.requestValidator) {
+      await opts.requestValidator(opts);
+    }
+
+    if (opts.body !== undefined && opts.bodySerializer) {
+      opts.serializedBody = opts.bodySerializer(opts.body) as string | undefined;
+    }
+
+    // remove Content-Type header if body is empty to avoid sending invalid requests
+    if (opts.body === undefined || opts.serializedBody === '') {
+      opts.headers.delete('Content-Type');
+    }
+
+    const resolvedOpts = opts as typeof opts &
+      ResolvedRequestOptions<TResponseStyle, ThrowOnError, Url>;
+    const url = buildUrl(resolvedOpts);
+
+    return { opts: resolvedOpts, url };
+  };
+
+  const request: Client['request'] = async (options) => {
+    const throwOnError = options.throwOnError ?? _config.throwOnError;
+    const responseStyle = options.responseStyle ?? _config.responseStyle;
+
+    let request: Request | undefined;
+    let response: Response | undefined;
+
+    try {
+      const { opts, url } = await beforeRequest(options);
+      const requestInit: ReqInit = {
+        redirect: 'follow',
+        ...opts,
+        body: getValidRequestBody(opts),
+      };
+
+      request = new Request(url, requestInit);
+
+      for (const fn of interceptors.request.fns) {
+        if (fn) {
+          request = await fn(request, opts);
+        }
+      }
+
+      // fetch must be assigned here, otherwise it would throw the error:
+      // TypeError: Failed to execute 'fetch' on 'Window': Illegal invocation
+      const _fetch = opts.fetch!;
+
+      response = await _fetch(request);
+
+      for (const fn of interceptors.response.fns) {
+        if (fn) {
+          response = await fn(response, request, opts);
+        }
+      }
+
+      const result = {
+        request,
+        response,
+      };
+
+      if (response.ok) {
+        const parseAs =
+          (opts.parseAs === 'auto'
+            ? getParseAs(response.headers.get('Content-Type'))
+            : opts.parseAs) ?? 'json';
+
+        if (response.status === 204 || response.headers.get('Content-Length') === '0') {
+          let emptyData: any;
+          switch (parseAs) {
+            case 'arrayBuffer':
+            case 'blob':
+            case 'text':
+              emptyData = await response[parseAs]();
+              break;
+            case 'formData':
+              emptyData = new FormData();
+              break;
+            case 'stream':
+              emptyData = response.body;
+              break;
+            case 'json':
+            default:
+              emptyData = {};
+              break;
+          }
+          return opts.responseStyle === 'data'
+            ? emptyData
+            : {
+                data: emptyData,
+                ...result,
+              };
+        }
+
+        let data: any;
+        switch (parseAs) {
+          case 'arrayBuffer':
+          case 'blob':
+          case 'formData':
+          case 'text':
+            data = await response[parseAs]();
+            break;
+          case 'json': {
+            // Some servers return 200 with no Content-Length and empty body.
+            // response.json() would throw; read as text and parse if non-empty.
+            const text = await response.text();
+            data = text ? JSON.parse(text) : {};
+            break;
+          }
+          case 'stream':
+            return opts.responseStyle === 'data'
+              ? response.body
+              : {
+                  data: response.body,
+                  ...result,
+                };
+        }
+
+        if (parseAs === 'json') {
+          if (opts.responseValidator) {
+            await opts.responseValidator(data);
+          }
+
+          if (opts.responseTransformer) {
+            data = await opts.responseTransformer(data);
+          }
+        }
+
+        return opts.responseStyle === 'data'
+          ? data
+          : {
+              data,
+              ...result,
+            };
+      }
+
+      const textError = await response.text();
+      let jsonError: unknown;
+
+      try {
+        jsonError = JSON.parse(textError);
+      } catch {
+        // noop
+      }
+
+      throw jsonError ?? textError;
+    } catch (error) {
+      let finalError = error;
+
+      for (const fn of interceptors.error.fns) {
+        if (fn) {
+          finalError = await fn(finalError, response, request, options as ResolvedRequestOptions);
+        }
+      }
+
+      finalError = finalError || {};
+
+      if (throwOnError) {
+        throw finalError;
+      }
+
+      // TODO: we probably want to return error and improve types
+      return responseStyle === 'data'
+        ? undefined
+        : {
+            error: finalError,
+            request,
+            response,
+          };
+    }
+  };
+
+  const makeMethodFn = (method: Uppercase<HttpMethod>) => (options: RequestOptions) =>
+    request({ ...options, method });
+
+  const makeSseFn = (method: Uppercase<HttpMethod>) => async (options: RequestOptions) => {
+    const { opts, url } = await beforeRequest(options);
+    return createSseClient({
+      ...opts,
+      body: opts.body as BodyInit | null | undefined,
+      method,
+      onRequest: async (url, init) => {
+        let request = new Request(url, init);
+        for (const fn of interceptors.request.fns) {
+          if (fn) {
+            request = await fn(request, opts);
+          }
+        }
+        return request;
+      },
+      serializedBody: getValidRequestBody(opts) as BodyInit | null | undefined,
+      url,
+    });
+  };
+
+  const _buildUrl: Client['buildUrl'] = (options) => buildUrl({ ..._config, ...options });
+
+  return {
+    buildUrl: _buildUrl,
+    connect: makeMethodFn('CONNECT'),
+    delete: makeMethodFn('DELETE'),
+    get: makeMethodFn('GET'),
+    getConfig,
+    head: makeMethodFn('HEAD'),
+    interceptors,
+    options: makeMethodFn('OPTIONS'),
+    patch: makeMethodFn('PATCH'),
+    post: makeMethodFn('POST'),
+    put: makeMethodFn('PUT'),
+    request,
+    setConfig,
+    sse: {
+      connect: makeSseFn('CONNECT'),
+      delete: makeSseFn('DELETE'),
+      get: makeSseFn('GET'),
+      head: makeSseFn('HEAD'),
+      options: makeSseFn('OPTIONS'),
+      patch: makeSseFn('PATCH'),
+      post: makeSseFn('POST'),
+      put: makeSseFn('PUT'),
+      trace: makeSseFn('TRACE'),
+    },
+    trace: makeMethodFn('TRACE'),
+  } as Client;
+};

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

@@ -0,0 +1,25 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+export type { Auth } from '../core/auth.gen';
+export type { QuerySerializerOptions } from '../core/bodySerializer.gen';
+export {
+  formDataBodySerializer,
+  jsonBodySerializer,
+  urlSearchParamsBodySerializer,
+} from '../core/bodySerializer.gen';
+export { buildClientParams } from '../core/params.gen';
+export { serializeQueryKeyValue } from '../core/queryKeySerializer.gen';
+export { createClient } from './client.gen';
+export type {
+  Client,
+  ClientOptions,
+  Config,
+  CreateClientConfig,
+  Options,
+  RequestOptions,
+  RequestResult,
+  ResolvedRequestOptions,
+  ResponseStyle,
+  TDataShape,
+} from './types.gen';
+export { createConfig, mergeHeaders } from './utils.gen';