@djangocfg/monitor 2.1.321 → 2.1.327

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

@@ -1,317 +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 { Monitor } from "./monitor/client";
-export * as MonitorTypes from "./monitor/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, Monitor } 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 monitor!: Monitor;
-
-  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.monitor = this._client.monitor;
-  }
-
-  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.monitor = this._client.monitor;
-  }
-
-  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_monitor/schemas/EventTypeEnum.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 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/{_utils/schemas/FrontendEventIngestRequest.schema.ts → schemas/FrontendEventIngestRequest.ts}

@@ -1,19 +1,15 @@
-/**
- * Zod schema for FrontendEventIngestRequest
- *
- * This schema provides runtime validation and type inference.
- *  * Single browser event payload.
- *  */
-import { z } from 'zod'
-import * as Enums from '../../enums'
+// 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 { EventTypeEnumSchema } from "./EventTypeEnum";
+import { LevelEnumSchema } from "./LevelEnum";
 
-/**
- * Single browser event payload.
- */
 export const FrontendEventIngestRequestSchema = z.object({
-  event_type: z.nativeEnum(Enums.FrontendEventIngestRequestEventType),
+  event_type: EventTypeEnumSchema,
   message: z.string().min(1).max(5000),
-  level: z.nativeEnum(Enums.FrontendEventIngestRequestLevel).optional(),
+  level: LevelEnumSchema.optional(),
   stack_trace: z.string().max(10000).optional(),
   url: z.string().max(2000).optional(),
   fingerprint: z.string().max(64).optional(),
@@ -24,11 +20,8 @@ export const FrontendEventIngestRequestSchema = z.object({
   user_agent: z.string().max(500).optional(),
   build_id: z.string().max(100).optional(),
   environment: z.string().max(20).optional(),
-  extra: z.record(z.string(), z.any()).optional(),
+  extra: z.unknown().optional(),
   project_name: z.string().max(100).optional(),
-})
+});
 
-/**
- * Infer TypeScript type from Zod schema
- */
-export type FrontendEventIngestRequest = z.infer<typeof FrontendEventIngestRequestSchema>
+export type FrontendEventIngestRequest = z.infer<typeof FrontendEventIngestRequestSchema>;

package/src/_api/generated/cfg_monitor/schemas/IngestBatchRequest.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";
+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 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 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,55 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+import type { Client, Options as Options2, TDataShape } from './client';
+import { client } from './client.gen';
+import type { CfgMonitorIngestCreateData, CfgMonitorIngestCreateResponses } from './types.gen';
+
+export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {
+    /**
+     * You can provide a client instance returned by `createClient()` instead of
+     * individual options. This might be also useful if you want to implement a
+     * custom client.
+     */
+    client?: Client;
+    /**
+     * You can pass arbitrary values through the `meta` object. This can be
+     * used to access values that aren't defined as part of the SDK function.
+     */
+    meta?: Record<string, unknown>;
+};
+
+export class Cfg {
+    /**
+     * Ingest browser events
+     *
+     * Accepts a batch of up to 50 frontend events. No authentication required — anonymous visitors can send events.
+     */
+    public static cfgMonitorIngestCreate<ThrowOnError extends boolean = false>(options: Options<CfgMonitorIngestCreateData, ThrowOnError>) {
+        return (options.client ?? client).post<CfgMonitorIngestCreateResponses, unknown, ThrowOnError>({
+            url: '/cfg/monitor/ingest/',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers
+            }
+        });
+    }
+}
+
+export class Monitor {
+    /**
+     * Ingest browser events
+     *
+     * Accepts a batch of up to 50 frontend events. No authentication required — anonymous visitors can send events.
+     */
+    public static cfgMonitorIngestCreate<ThrowOnError extends boolean = false>(options: Options<CfgMonitorIngestCreateData, ThrowOnError>) {
+        return (options.client ?? client).post<CfgMonitorIngestCreateResponses, unknown, ThrowOnError>({
+            url: '/cfg/monitor/ingest/',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers
+            }
+        });
+    }
+}

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

@@ -0,0 +1,79 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+export type ClientOptions = {
+    baseUrl: 'http://localhost:8000' | (string & {});
+};
+
+/**
+ * * `JS_ERROR` - Js Error
+ * * `NETWORK_ERROR` - Network Error
+ * * `ERROR` - Error
+ * * `WARNING` - Warning
+ * * `PAGE_VIEW` - Page View
+ * * `PERFORMANCE` - Performance
+ * * `CONSOLE` - Console
+ */
+export enum EventTypeEnum {
+    JS_ERROR = 'JS_ERROR',
+    NETWORK_ERROR = 'NETWORK_ERROR',
+    ERROR = 'ERROR',
+    WARNING = 'WARNING',
+    PAGE_VIEW = 'PAGE_VIEW',
+    PERFORMANCE = 'PERFORMANCE',
+    CONSOLE = 'CONSOLE'
+}
+
+/**
+ * Single browser event payload.
+ */
+export type FrontendEventIngestRequest = {
+    event_type: EventTypeEnum;
+    message: string;
+    level?: LevelEnum;
+    stack_trace?: string;
+    url?: string;
+    fingerprint?: string;
+    http_status?: number | null;
+    http_method?: string;
+    http_url?: string;
+    session_id?: string;
+    user_agent?: string;
+    build_id?: string;
+    environment?: string;
+    extra?: unknown;
+    project_name?: string;
+};
+
+/**
+ * Batch of up to 50 browser events.
+ */
+export type IngestBatchRequest = {
+    events: Array<FrontendEventIngestRequest>;
+};
+
+/**
+ * * `error` - Error
+ * * `warning` - Warning
+ * * `info` - Info
+ * * `debug` - Debug
+ */
+export enum LevelEnum {
+    ERROR = 'error',
+    WARNING = 'warning',
+    INFO = 'info',
+    DEBUG = 'debug'
+}
+
+export type CfgMonitorIngestCreateData = {
+    body: IngestBatchRequest;
+    path?: never;
+    query?: never;
+    url: '/cfg/monitor/ingest/';
+};
+
+export type CfgMonitorIngestCreateResponses = {
+    /**
+     * Accepted
+     */
+    202: unknown;
+};

package/src/_api/generated/index.ts

@@ -0,0 +1,22 @@
+// AUTO-GENERATED by django_generator / ts_extras.wrapper
+// Top-level barrel — one singleton API per group, baseUrl from Next.js env.
+// DO NOT EDIT — re-run `make gen`.
+
+import { API as CfgMonitorAPI, LocalStorageAdapter as CfgMonitorStorage } from './cfg_monitor';
+
+const isStaticBuild = process.env.NEXT_PUBLIC_STATIC_BUILD === 'true';
+const baseUrl = isStaticBuild ? '' : process.env.NEXT_PUBLIC_API_URL || '';
+
+export const cfgMonitorApi = new CfgMonitorAPI(baseUrl, { storage: new CfgMonitorStorage() });
+
+// API wrapper classes — for users who need to construct their own
+// instance (e.g. with MemoryStorageAdapter in SSR/tests).
+export { API as CfgMonitorAPI } from './cfg_monitor';
+
+// Hey API SDK classes — one per OpenAPI tag. Lets consumers call
+// `Centrifugo.cfgCentrifugoAuthTokenRetrieve({...})` directly without
+// going through the wrapper singleton.
+export { Monitor } from './cfg_monitor';
+
+// Shared utilities (errors, storage adapters, logger).
+export * from './_shared';

package/src/_api/index.ts

@@ -1,6 +1,6 @@
 export { monitorApi, configureMonitorApi, BaseClient } from './BaseClient'
-export type { FrontendEventIngestRequest, IngestBatchRequest } from './generated/cfg_monitor/monitor/models'
-export { FrontendEventIngestRequestEventType as EventType, FrontendEventIngestRequestLevel as EventLevel } from './generated/cfg_monitor/enums'
+export type { FrontendEventIngestRequest, IngestBatchRequest } from './generated/cfg_monitor/types.gen'
+export { EventTypeEnum as EventType, LevelEnum as EventLevel } from './generated/cfg_monitor/types.gen'
 
 /** Ingest path — matches the generated client. Single source of truth for sendBeacon fallback. */
 export const INGEST_PATH = '/cfg/monitor/ingest/'

package/src/client/capture/console.ts

@@ -3,15 +3,14 @@ import { getSessionId } from './session'
 import { monitorStore } from '../store'
 import { MONITOR_INGEST_PATTERN, DEFAULT_DEDUPE_TTL } from '../constants'
 import { EventType, EventLevel } from '../../_api'
-import type { FrontendEventIngestRequestEventType, FrontendEventIngestRequestLevel } from '../../_api/generated/cfg_monitor/enums'
 
 type ConsoleLevel = 'warn' | 'error'
 
-const levelMap: Record<ConsoleLevel, FrontendEventIngestRequestLevel> = {
+const levelMap: Record<ConsoleLevel, EventLevel> = {
   warn: EventLevel.WARNING,
   error: EventLevel.ERROR,
 }
-const typeMap: Record<ConsoleLevel, FrontendEventIngestRequestEventType> = {
+const typeMap: Record<ConsoleLevel, EventType> = {
   warn: EventType.WARNING,
   error: EventType.ERROR,
 }

package/src/client/transport/ingest.ts

@@ -1,27 +1,31 @@
-import { monitorApi } from '../../_api'
-import { API, MemoryStorageAdapter, KeepAliveFetchAdapter } from '../../_api/generated/cfg_monitor'
+import { monitorApi, INGEST_PATH } from '../../_api'
+import { Monitor } from '../../_api/generated/cfg_monitor'
 import type { IngestBatchRequest } from '../../_api'
 
-/** Separate API instance with KeepAliveFetchAdapter — survives page unload */
-const monitorApiBeacon = new API('', {
-  storage: new MemoryStorageAdapter(),
-  httpClient: new KeepAliveFetchAdapter(),
-})
-
-export function syncBeaconBaseUrl(): void {
-  monitorApiBeacon.setBaseUrl(monitorApi.getBaseUrl())
-}
-
+/**
+ * Send a batch of events to the ingest endpoint.
+ *
+ * `useBeacon=true` is for page-unload scenarios — `fetch` with `keepalive: true`
+ * lets the request survive after the document goes away (browser-supported
+ * replacement for navigator.sendBeacon when we need JSON + custom headers).
+ */
 export async function sendBatch(
   batch: IngestBatchRequest,
   useBeacon = false,
 ): Promise<void> {
   if (batch.events.length === 0) return
 
-  if (useBeacon) {
-    syncBeaconBaseUrl()
-    await monitorApiBeacon.monitor.ingestCreate(batch)
-  } else {
-    await monitorApi.monitor.ingestCreate(batch)
+  if (useBeacon && typeof fetch !== 'undefined') {
+    const baseUrl = monitorApi.getBaseUrl()
+    await fetch(`${baseUrl}${INGEST_PATH}`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(batch),
+      keepalive: true,
+      credentials: 'include',
+    })
+    return
   }
+
+  await Monitor.cfgMonitorIngestCreate({ body: batch, throwOnError: true })
 }