@djangocfg/monitor 2.1.322 → 2.1.331

package/src/_api/generated/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 = {
+    build_id?: string;
+    environment?: string;
+    event_type: EventTypeEnum;
+    extra?: unknown;
+    fingerprint?: string;
+    http_method?: string;
+    http_status?: number | null;
+    http_url?: string;
+    level?: LevelEnum;
+    message: string;
+    project_name?: string;
+    session_id?: string;
+    stack_trace?: string;
+    url?: string;
+    user_agent?: 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/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/sdk.gen'
 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 })
 }

package/src/server/index.ts

@@ -22,7 +22,8 @@
  * ```
  */
 
-import { monitorApi, configureMonitorApi, EventType, EventLevel } from '../_api'
+import { configureMonitorApi, EventType, EventLevel } from '../_api'
+import { Monitor } from '../_api/generated/sdk.gen'
 import type { FrontendEventIngestRequest } from '../_api'
 import type { ServerMonitorConfig } from '../types'
 
@@ -34,7 +35,7 @@ let _config: ServerMonitorConfig = {}
 async function send(events: FrontendEventIngestRequest[]): Promise<void> {
   if (events.length === 0) return
   try {
-    await monitorApi.monitor.ingestCreate({ events })
+    await Monitor.cfgMonitorIngestCreate({ body: { events }, throwOnError: true })
   } catch {
     // Never throw from monitor
   }

package/src/_api/generated/cfg_monitor/CLAUDE.md

@@ -1,60 +0,0 @@
-# Django CFG API - Typescript Client
-
-Auto-generated. **Do not edit manually.**
-
-```bash
-python manage.py generate_client --groups cfg_monitor --typescript
-```
-
-## Stats
-
-| | |
-|---|---|
-| Version | 3.1.0 |
-| Operations | 1 |
-| Schemas | 2 |
-
-## Resources
-
-- **monitor** (1 ops)
-
-## Operations
-
-**monitor:**
-- `POST` /cfg/monitor/ingest/ → `cfg_monitor_ingest_create`
-
-## Usage
-
-```typescript
-import { APIClient } from './';
-
-const client = new APIClient({ baseUrl, token });
-
-await client.monitor.create({ ... });
-```
-
-**SWR Hooks:**
-```typescript
-import { useMonitorList } from './hooks';
-const { data, isLoading } = useMonitorList();
-```
-
-## How It Works
-
-```
-DRF ViewSets → drf-spectacular → OpenAPI → IR Parser → Generator → This Client
-```
-
-**Configuration** (`api/config.py`):
-```python
-openapi_client = OpenAPIClientConfig(
-    enabled=True,
-    groups=[OpenAPIGroupConfig(name="cfg_monitor", apps=["..."])],
-    generate_zod_schemas=True,  # → schemas.ts
-    generate_fetchers=True,     # → fetchers.ts
-    generate_swr_hooks=True,    # → hooks.ts
-)
-```
-
-@see https://djangocfg.com/docs/features/api-generation
-

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

@@ -1,30 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Typed Fetchers - Universal API functions
- *
- * Auto-generated from OpenAPI specification.
- * These functions work in any JavaScript environment.
- *
- * Features:
- * - Runtime validation with Zod
- * - Type-safe parameters and responses
- * - Works with any data-fetching library (SWR, React Query, etc)
- * - Server Component compatible
- *
- * Usage:
- * ```typescript
- * import * as fetchers from './fetchers'
- *
- * // Direct usage
- * const user = await fetchers.getUser(1)
- *
- * // With SWR
- * const { data } = useSWR('user-1', () => fetchers.getUser(1))
- *
- * // With React Query
- * const { data } = useQuery(['user', 1], () => fetchers.getUser(1))
- * ```
- */
-
-export * from './monitor'

package/src/_api/generated/cfg_monitor/_utils/fetchers/monitor.ts

@@ -1,51 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Typed fetchers for Monitor
- *
- * Universal functions that work in any environment:
- * - Next.js (App Router / Pages Router / Server Components)
- * - React Native
- * - Node.js backend
- *
- * These fetchers use Zod schemas for runtime validation.
- *
- * Usage:
- * ```typescript
- * // Configure API once (in your app entry point)
- * import { configureAPI } from '../../api-instance'
- * configureAPI({ baseUrl: 'https://api.example.com' })
- *
- * // Then use fetchers anywhere
- * const users = await getUsers({ page: 1 })
- *
- * // With SWR
- * const { data } = useSWR(['users', params], () => getUsers(params))
- *
- * // With React Query
- * const { data } = useQuery(['users', params], () => getUsers(params))
- *
- * // In Server Component or SSR (pass custom client)
- * import { API } from '../../index'
- * const api = new API('https://api.example.com')
- * const users = await getUsers({ page: 1 }, api)
- * ```
- */
-import { consola } from 'consola'
-import { IngestBatchRequestSchema, type IngestBatchRequest } from '../schemas/IngestBatchRequest.schema'
-import { getAPIInstance } from '../../api-instance'
-
-/**
- * Ingest browser events
- *
- * @method POST
- * @path /cfg/monitor/ingest/
- */
-export async function createMonitorIngestCreate(  data: IngestBatchRequest,  client?: any
-): Promise<any> {
-  const api = client || getAPIInstance()
-  const response = await api.monitor.ingestCreate(data)
-  return response
-}
-
-

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

@@ -1,30 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-'use client';
-
-/**
- * SWR Hooks - React data fetching hooks
- *
- * Auto-generated from OpenAPI specification.
- * Powered by SWR for automatic caching and revalidation.
- *
- * Features:
- * - Automatic caching and deduplication
- * - Revalidation on focus/reconnect
- * - Optimistic updates
- * - Type-safe parameters and responses
- *
- * Usage:
- * ```typescript
- * import * as hooks from './hooks'
- *
- * // Query hooks (GET)
- * const { data, error, isLoading } = hooks.useUsers({ page: 1 })
- *
- * // Mutation hooks (POST/PUT/PATCH/DELETE)
- * const createUser = hooks.useCreateUser()
- * await createUser({ name: 'John' })
- * ```
- */
-
-export * from './monitor'

package/src/_api/generated/cfg_monitor/_utils/hooks/monitor.ts

@@ -1,43 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-'use client';
-
-/**
- * SWR Hooks for Monitor
- *
- * React hooks powered by SWR for data fetching with automatic caching,
- * revalidation, and optimistic updates.
- *
- * Usage:
- * ```typescript
- * // Query hooks (GET)
- * const { data, error, isLoading } = useUsers({ page: 1 })
- *
- * // Mutation hooks (POST/PUT/PATCH/DELETE)
- * const createUser = useCreateUser()
- * await createUser({ name: 'John', email: 'john@example.com' })
- * ```
- */
-import { useSWRConfig } from 'swr'
-import * as Fetchers from '../fetchers/monitor'
-import type { API } from '../../index'
-import type { IngestBatchRequest } from '../schemas/IngestBatchRequest.schema'
-
-/**
- * Ingest browser events
- *
- * @method POST
- * @path /cfg/monitor/ingest/
- */
-export function useCreateMonitorIngestCreate() {
-  const { mutate } = useSWRConfig()
-
-  return async (data: IngestBatchRequest, client?: API): Promise<any> => {
-    const result = await Fetchers.createMonitorIngestCreate(data, client)
-    // Revalidate related queries
-    mutate('cfg-monitor-ingest')
-    return result
-  }
-}
-
-

package/src/_api/generated/cfg_monitor/_utils/schemas/FrontendEventIngestRequest.schema.ts

@@ -1,34 +0,0 @@
-/**
- * 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'
-
-/**
- * Single browser event payload.
- */
-export const FrontendEventIngestRequestSchema = z.object({
-  event_type: z.nativeEnum(Enums.FrontendEventIngestRequestEventType),
-  message: z.string().min(1).max(5000),
-  level: z.nativeEnum(Enums.FrontendEventIngestRequestLevel).optional(),
-  stack_trace: z.string().max(10000).optional(),
-  url: z.string().max(2000).optional(),
-  fingerprint: z.string().max(64).optional(),
-  http_status: z.number().int().nullable().optional(),
-  http_method: z.string().max(10).optional(),
-  http_url: z.string().max(2000).optional(),
-  session_id: z.string().max(64).optional(),
-  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(),
-  project_name: z.string().max(100).optional(),
-})
-
-/**
- * Infer TypeScript type from Zod schema
- */
-export type FrontendEventIngestRequest = z.infer<typeof FrontendEventIngestRequestSchema>

package/src/_api/generated/cfg_monitor/_utils/schemas/IngestBatchRequest.schema.ts

@@ -1,20 +0,0 @@
-/**
- * Zod schema for IngestBatchRequest
- *
- * This schema provides runtime validation and type inference.
- *  * Batch of up to 50 browser events.
- *  */
-import { z } from 'zod'
-import { FrontendEventIngestRequestSchema } from './FrontendEventIngestRequest.schema'
-
-/**
- * Batch of up to 50 browser events.
- */
-export const IngestBatchRequestSchema = z.object({
-  events: z.array(FrontendEventIngestRequestSchema),
-})
-
-/**
- * Infer TypeScript type from Zod schema
- */
-export type IngestBatchRequest = z.infer<typeof IngestBatchRequestSchema>

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

@@ -1,22 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Zod Schemas - Runtime validation and type inference
- *
- * Auto-generated from OpenAPI specification.
- * Provides runtime validation for API requests and responses.
- *
- * Usage:
- * ```typescript
- * import { UserSchema } from './schemas'
- *
- * // Validate data
- * const user = UserSchema.parse(data)
- *
- * // Type inference
- * type User = z.infer<typeof UserSchema>
- * ```
- */
-
-export * from './FrontendEventIngestRequest.schema'
-export * from './IngestBatchRequest.schema'

package/src/_api/generated/cfg_monitor/api-instance.ts

@@ -1,181 +0,0 @@
-// @ts-nocheck
-// Auto-generated by DjangoCFG - see CLAUDE.md
-/**
- * Global API Instance - Singleton configuration with auto-configuration support
- *
- * This module provides a global API instance that auto-configures from
- * environment variables or can be configured manually.
- *
- * AUTO-CONFIGURATION (recommended):
- * Set one of these environment variables and the API will auto-configure:
- * - NEXT_PUBLIC_API_URL (Next.js)
- * - VITE_API_URL (Vite)
- * - REACT_APP_API_URL (Create React App)
- * - API_URL (generic)
- *
- * Then just use fetchers and hooks directly:
- * ```typescript
- * import { getUsers } from './_utils/fetchers'
- * const users = await getUsers({ page: 1 })
- * ```
- *
- * MANUAL CONFIGURATION:
- * ```typescript
- * import { configureAPI } from './api-instance'
- *
- * configureAPI({
- *   baseUrl: 'https://api.example.com',
- *   token: 'your-jwt-token'
- * })
- * ```
- *
- * For SSR or multiple instances:
- * ```typescript
- * import { API } from './index'
- * import { getUsers } from './_utils/fetchers'
- *
- * const api = new API('https://api.example.com')
- * const users = await getUsers({ page: 1 }, api)
- * ```
- */
-
-import { API, type APIOptions } from './index'
-
-let globalAPI: API | null = null
-let autoConfigAttempted = false
-
-/**
- * Auto-configure from environment variable if available (Next.js pattern)
- * This allows hooks and fetchers to work without explicit configureAPI() call
- *
- * Supported environment variables:
- * - NEXT_PUBLIC_API_URL (Next.js)
- * - VITE_API_URL (Vite)
- * - REACT_APP_API_URL (Create React App)
- * - API_URL (generic)
- */
-function tryAutoConfigureFromEnv(): void {
-  // Only attempt once
-  if (autoConfigAttempted) return
-  autoConfigAttempted = true
-
-  // Skip if already configured
-  if (globalAPI) return
-
-  // Skip if process is not available (pure browser without bundler)
-  if (typeof process === 'undefined' || !process.env) return
-
-  // Try different environment variable patterns
-  const baseUrl =
-    process.env.NEXT_PUBLIC_API_URL ||
-    process.env.VITE_API_URL ||
-    process.env.REACT_APP_API_URL ||
-    process.env.API_URL
-
-  if (baseUrl) {
-    globalAPI = new API(baseUrl)
-  }
-}
-
-/**
- * Get the global API instance
- * Auto-configures from environment variables on first call if not manually configured.
- * @throws Error if API is not configured and no env variable is set
- */
-export function getAPIInstance(): API {
-  // Try auto-configuration on first access (lazy initialization)
-  tryAutoConfigureFromEnv()
-
-  if (!globalAPI) {
-    throw new Error(
-      'API not configured. Call configureAPI() with your base URL before using fetchers or hooks.\n\n' +
-      'Example:\n' +
-      '  import { configureAPI } from "./api-instance"\n' +
-      '  configureAPI({ baseUrl: "https://api.example.com" })\n\n' +
-      'Or set environment variable: NEXT_PUBLIC_API_URL, VITE_API_URL, or REACT_APP_API_URL'
-    )
-  }
-  return globalAPI
-}
-
-/**
- * Check if API is configured (or can be auto-configured)
- */
-export function isAPIConfigured(): boolean {
-  tryAutoConfigureFromEnv()
-  return globalAPI !== null
-}
-
-/**
- * Configure the global API instance
- *
- * @param baseUrl - Base URL for the API
- * @param options - Optional configuration (storage, retry, logger)
- *
- * @example
- * ```typescript
- * configureAPI({
- *   baseUrl: 'https://api.example.com',
- *   token: 'jwt-token',
- *   options: {
- *     retryConfig: { maxRetries: 3 },
- *     loggerConfig: { enabled: true }
- *   }
- * })
- * ```
- */
-export function configureAPI(config: {
-  baseUrl: string
-  token?: string
-  refreshToken?: string
-  options?: APIOptions
-}): API {
-  globalAPI = new API(config.baseUrl, config.options)
-
-  if (config.token) {
-    globalAPI.setToken(config.token, config.refreshToken)
-  }
-
-  return globalAPI
-}
-
-/**
- * Reconfigure the global API instance with new settings
- * Useful for updating tokens or base URL
- */
-export function reconfigureAPI(updates: {
-  baseUrl?: string
-  token?: string
-  refreshToken?: string
-}): API {
-  const instance = getAPIInstance()
-
-  if (updates.baseUrl) {
-    instance.setBaseUrl(updates.baseUrl)
-  }
-
-  if (updates.token) {
-    instance.setToken(updates.token, updates.refreshToken)
-  }
-
-  return instance
-}
-
-/**
- * Clear tokens from the global API instance
- */
-export function clearAPITokens(): void {
-  const instance = getAPIInstance()
-  instance.clearTokens()
-}
-
-/**
- * Reset the global API instance
- * Useful for testing or logout scenarios
- */
-export function resetAPI(): void {
-  if (globalAPI) {
-    globalAPI.clearTokens()
-  }
-  globalAPI = null
-}