@djangocfg/monitor 2.1.327 → 2.1.332

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 → _cfg_monitor}/schemas/IngestBatchRequest.ts

@@ -1,6 +1,6 @@
-// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// AUTO-GENERATED by cmdop_server / devtools.generator.ts_extras
 // Source: OpenAPI 3.1 components.schemas
-// DO NOT EDIT — re-run `make gen`.
+// DO NOT EDIT — re-run `make gen-clients`.
 
 import { z } from "zod";
 import { FrontendEventIngestRequestSchema } from "./FrontendEventIngestRequest";

package/src/_api/generated/{cfg_monitor → _cfg_monitor}/schemas/LevelEnum.ts

@@ -1,6 +1,6 @@
-// AUTO-GENERATED by django-cfg / django_generator.ts_extras
+// AUTO-GENERATED by cmdop_server / devtools.generator.ts_extras
 // Source: OpenAPI 3.1 components.schemas
-// DO NOT EDIT — re-run `make gen`.
+// DO NOT EDIT — re-run `make gen-clients`.
 
 import { z } from "zod";
 

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/{cfg_monitor/client.gen.ts → client.gen.ts}

@@ -14,3 +14,6 @@ import type { ClientOptions as ClientOptions2 } from './types.gen';
 export type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;
 
 export const client = createClient(createConfig<ClientOptions2>({ baseUrl: 'http://localhost:8000' }));
+
+// auto-init: load auth interceptor
+import './helpers/auth';

package/src/_api/generated/helpers/auth.ts

@@ -0,0 +1,223 @@
+// AUTO-GENERATED by django_generator / ts_extras.wrapper
+// Global auth store. ONE source of truth for token / API key / locale /
+// baseUrl. Installs the request interceptor as a side-effect on import.
+// DO NOT EDIT — re-run `make gen`.
+
+import { client } from '../client.gen';
+
+const ACCESS_KEY = 'cfg.access_token';
+const REFRESH_KEY = 'cfg.refresh_token';
+const API_KEY_KEY = 'cfg.api_key';
+
+const isBrowser = typeof window !== 'undefined';
+
+export type StorageMode = 'localStorage' | 'cookie';
+
+// ── Storage backends (browser-only; server-side reads return null) ─────────
+
+interface KVStore {
+  get(key: string): string | null;
+  set(key: string, value: string | null): void;
+}
+
+const localStorageBackend: KVStore = {
+  get(key) {
+    if (!isBrowser) return null;
+    try { return window.localStorage.getItem(key); } catch { return null; }
+  },
+  set(key, value) {
+    if (!isBrowser) return;
+    try {
+      if (value === null) window.localStorage.removeItem(key);
+      else window.localStorage.setItem(key, value);
+    } catch {}
+  },
+};
+
+/** 30 days, matches typical refresh-token lifetime. */
+const COOKIE_MAX_AGE = 60 * 60 * 24 * 30;
+
+const cookieBackend: KVStore = {
+  get(key) {
+    if (!isBrowser) return null;
+    try {
+      const re = new RegExp(`(?:^|;\\s*)${encodeURIComponent(key)}=([^;]*)`);
+      const m = document.cookie.match(re);
+      return m ? decodeURIComponent(m[1]) : null;
+    } catch { return null; }
+  },
+  set(key, value) {
+    if (!isBrowser) return;
+    try {
+      const k = encodeURIComponent(key);
+      const secure = window.location.protocol === 'https:' ? '; Secure' : '';
+      if (value === null) {
+        document.cookie = `${k}=; Path=/; Max-Age=0; SameSite=Lax${secure}`;
+      } else {
+        const v = encodeURIComponent(value);
+        document.cookie = `${k}=${v}; Path=/; Max-Age=${COOKIE_MAX_AGE}; SameSite=Lax${secure}`;
+      }
+    } catch {}
+  },
+};
+
+let _storage: KVStore = localStorageBackend;
+let _storageMode: StorageMode = 'localStorage';
+
+/** Detect locale from `NEXT_LOCALE` cookie or `navigator.language`. */
+function detectLocale(): string | null {
+  try {
+    if (typeof document !== 'undefined') {
+      const m = document.cookie.match(/(?:^|;\s*)NEXT_LOCALE=([^;]*)/);
+      if (m) return decodeURIComponent(m[1]);
+    }
+    if (typeof navigator !== 'undefined' && navigator.language) {
+      return navigator.language;
+    }
+  } catch {}
+  return null;
+}
+
+/** Default baseUrl from `NEXT_PUBLIC_API_URL` (empty for static builds). */
+function defaultBaseUrl(): string {
+  try {
+    if (typeof process !== 'undefined' && process.env) {
+      if (process.env.NEXT_PUBLIC_STATIC_BUILD === 'true') return '';
+      return process.env.NEXT_PUBLIC_API_URL || '';
+    }
+  } catch {}
+  return '';
+}
+
+/** Default API key fallback from `NEXT_PUBLIC_API_KEY`. */
+function defaultApiKey(): string | null {
+  try {
+    if (typeof process !== 'undefined' && process.env?.NEXT_PUBLIC_API_KEY) {
+      return process.env.NEXT_PUBLIC_API_KEY;
+    }
+  } catch {}
+  return null;
+}
+
+// ── In-memory overrides (win over storage / env) ───────────────────────────
+let _localeOverride: string | null = null;
+let _apiKeyOverride: string | null = null;
+let _baseUrlOverride: string | null = null;
+let _withCredentials = true;
+let _onUnauthorized: ((response: Response) => void) | null = null;
+
+/**
+ * Global auth/config store. All getters read live state every call —
+ * the interceptor below uses these to attach headers per-request.
+ *
+ * Default storage backend is `localStorage`. Switch to cookies (e.g.
+ * for Next.js SSR cookie access) via `auth.setStorageMode('cookie')`
+ * early in the app bootstrap.
+ *
+ * @example
+ *   import { auth } from '@your/api';
+ *
+ *   // After login
+ *   auth.setToken(jwt);
+ *   auth.setRefreshToken(refresh);
+ *
+ *   // After logout
+ *   auth.clearTokens();
+ *
+ *   // Switch to cookie storage (call once during app init)
+ *   auth.setStorageMode('cookie');
+ */
+export const auth = {
+  // ── Storage mode ──────────────────────────────────────────────────
+  getStorageMode(): StorageMode { return _storageMode; },
+  /**
+   * Switch the storage backend. Existing values in the *previous*
+   * backend are NOT migrated — set fresh values after switching.
+   */
+  setStorageMode(mode: StorageMode): void {
+    _storageMode = mode;
+    _storage = mode === 'cookie' ? cookieBackend : localStorageBackend;
+  },
+
+  // ── Bearer token ──────────────────────────────────────────────────
+  getToken(): string | null { return _storage.get(ACCESS_KEY); },
+  setToken(token: string | null): void { _storage.set(ACCESS_KEY, token); },
+  getRefreshToken(): string | null { return _storage.get(REFRESH_KEY); },
+  setRefreshToken(token: string | null): void { _storage.set(REFRESH_KEY, token); },
+  clearTokens(): void { _storage.set(ACCESS_KEY, null); _storage.set(REFRESH_KEY, null); },
+  isAuthenticated(): boolean { return _storage.get(ACCESS_KEY) !== null; },
+
+  // ── API key ───────────────────────────────────────────────────────
+  /** In-memory API key. Falls back to storage, then NEXT_PUBLIC_API_KEY. */
+  getApiKey(): string | null {
+    return _apiKeyOverride ?? _storage.get(API_KEY_KEY) ?? defaultApiKey();
+  },
+  /** In-memory only (cleared on reload). */
+  setApiKey(key: string | null): void { _apiKeyOverride = key; },
+  /** Persist to active storage backend (localStorage or cookie). */
+  setApiKeyPersist(key: string | null): void {
+    _apiKeyOverride = key;
+    _storage.set(API_KEY_KEY, key);
+  },
+  clearApiKey(): void { _apiKeyOverride = null; _storage.set(API_KEY_KEY, null); },
+
+  // ── Locale ────────────────────────────────────────────────────────
+  /** Override locale → falls back to NEXT_LOCALE cookie / navigator.language. */
+  getLocale(): string | null { return _localeOverride ?? detectLocale(); },
+  setLocale(locale: string | null): void { _localeOverride = locale; },
+
+  // ── Base URL ──────────────────────────────────────────────────────
+  getBaseUrl(): string {
+    const url = (_baseUrlOverride ?? defaultBaseUrl());
+    return url.replace(/\/$/, '');
+  },
+  setBaseUrl(url: string | null): void {
+    _baseUrlOverride = url ? url.replace(/\/$/, '') : null;
+    client.setConfig({ baseUrl: this.getBaseUrl() });
+  },
+
+  // ── Credentials toggle (Django session/CSRF cross-origin) ─────────
+  getWithCredentials(): boolean { return _withCredentials; },
+  setWithCredentials(value: boolean): void {
+    _withCredentials = value;
+    client.setConfig({ credentials: value ? 'include' : 'same-origin' });
+  },
+
+  // ── 401 handler ───────────────────────────────────────────────────
+  /**
+   * Register a callback fired on every 401 response. Use this to wire
+   * a token-refresh flow or a forced logout. Setting `null` removes
+   * the handler.
+   */
+  onUnauthorized(cb: ((response: Response) => void) | null): void {
+    _onUnauthorized = cb;
+  },
+};
+
+// ── One-time client wiring (side-effect on first import) ───────────────────
+client.setConfig({
+  baseUrl: auth.getBaseUrl(),
+  credentials: _withCredentials ? 'include' : 'same-origin',
+});
+
+client.interceptors.request.use((request) => {
+  const token = auth.getToken();
+  if (token) request.headers.set('Authorization', `Bearer ${token}`);
+
+  const locale = auth.getLocale();
+  if (locale) request.headers.set('Accept-Language', locale);
+
+  const apiKey = auth.getApiKey();
+  if (apiKey) request.headers.set('X-API-Key', apiKey);
+
+  return request;
+});
+
+client.interceptors.response.use((response) => {
+  if (response.status === 401 && _onUnauthorized) {
+    try { _onUnauthorized(response); } catch {}
+  }
+  return response;
+});
+
+export type Auth = typeof auth;

package/src/_api/generated/{_shared → helpers}/index.ts

@@ -1,6 +1,7 @@
 // AUTO-GENERATED by django_generator / ts_extras.wrapper
 // Shared utilities barrel. DO NOT EDIT — re-run `make gen`.
 
+export { auth, type Auth } from './auth';
 export {
   type StorageAdapter,
   LocalStorageAdapter,

package/src/_api/generated/index.ts

@@ -1,22 +1,26 @@
 // AUTO-GENERATED by django_generator / ts_extras.wrapper
-// Top-level barrel — one singleton API per group, baseUrl from Next.js env.
+// Top-level barrel — global `auth` + per-group facades.
 // DO NOT EDIT — re-run `make gen`.
 
-import { API as CfgMonitorAPI, LocalStorageAdapter as CfgMonitorStorage } from './cfg_monitor';
+// Side-effect: ensure auth interceptor is installed even if consumers
+// only ever import this barrel (it'll also load via client.gen.ts).
+import './helpers/auth';
 
-const isStaticBuild = process.env.NEXT_PUBLIC_STATIC_BUILD === 'true';
-const baseUrl = isStaticBuild ? '' : process.env.NEXT_PUBLIC_API_URL || '';
+// Global auth/config store — single source of truth.
+export { auth, type Auth } from './helpers/auth';
 
-export const cfgMonitorApi = new CfgMonitorAPI(baseUrl, { storage: new CfgMonitorStorage() });
+import { API as CfgMonitorAPI } from './_cfg_monitor';
 
-// 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';
+// Singletons for ergonomic access (`import { apiAccounts } from '@your/api'`).
+// All instances share the same global `auth` store.
+export const CfgMonitorApi = new CfgMonitorAPI();
+
+// Per-group wrapper classes (e.g. for tests / SSR isolation of options).
+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';
+// `Centrifugo.cfgCentrifugoAuthTokenRetrieve({...})` directly.
+
 
 // Shared utilities (errors, storage adapters, logger).
-export * from './_shared';
+export * from './helpers';

package/src/_api/index.ts

@@ -1,6 +1,6 @@
 export { monitorApi, configureMonitorApi, BaseClient } from './BaseClient'
-export type { FrontendEventIngestRequest, IngestBatchRequest } from './generated/cfg_monitor/types.gen'
-export { EventTypeEnum as EventType, LevelEnum as EventLevel } from './generated/cfg_monitor/types.gen'
+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/transport/ingest.ts

@@ -1,5 +1,5 @@
 import { monitorApi, INGEST_PATH } from '../../_api'
-import { Monitor } from '../../_api/generated/cfg_monitor'
+import { Monitor } from '../../_api/generated/sdk.gen'
 import type { IngestBatchRequest } from '../../_api'
 
 /**

package/src/server/index.ts

@@ -23,7 +23,7 @@
  */
 
 import { configureMonitorApi, EventType, EventLevel } from '../_api'
-import { Monitor } from '../_api/generated/cfg_monitor'
+import { Monitor } from '../_api/generated/sdk.gen'
 import type { FrontendEventIngestRequest } from '../_api'
 import type { ServerMonitorConfig } from '../types'
 

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

@@ -1,122 +0,0 @@
-// AUTO-GENERATED by django_generator / ts_extras.wrapper
-// Self-contained API wrapper for this group. DO NOT EDIT — re-run `make gen`.
-
-import { client } from './client.gen';
-import type { StorageAdapter } from '../_shared/storage';
-import { LocalStorageAdapter } from '../_shared/storage';
-import { APILogger, type LoggerConfig } from '../_shared/logger';
-
-import { Cfg } from './sdk.gen';
-import { Monitor } from './sdk.gen';
-
-
-const ACCESS_KEY = 'cfg.access_token';
-const REFRESH_KEY = 'cfg.refresh_token';
-
-
-
-/** Auto-detect locale from cookie NEXT_LOCALE or navigator.language. */
-function detectLocale(): string | null {
-  try {
-    if (typeof document !== 'undefined') {
-      const m = document.cookie.match(/(?:^|;\s*)NEXT_LOCALE=([^;]*)/);
-      if (m) return decodeURIComponent(m[1]);
-    }
-    if (typeof navigator !== 'undefined' && navigator.language) {
-      return navigator.language;
-    }
-  } catch {}
-  return null;
-}
-
-export interface APIOptions {
-  /** Override storage backend (LocalStorage by default; Memory for SSR/tests). */
-  storage?: StorageAdapter;
-  /** Logger config (defaults to dev-only). */
-  logger?: Partial<LoggerConfig>;
-  /** Locale for `Accept-Language`. If omitted, auto-detected from cookie/navigator. */
-  locale?: string;
-  /** API key sent as `X-API-Key`. Falls back to NEXT_PUBLIC_API_KEY. */
-  apiKey?: string;
-  /** Send Django session/CSRF cookies cross-origin. Defaults to true. */
-  withCredentials?: boolean;
-}
-
-/**
- * Self-contained API wrapper for this group.
- *
- * Each group has its own client + interceptor + token store. The interceptor
- * automatically attaches:
- *   - `Authorization: Bearer <jwt>` from storage
- *   - `Accept-Language` from `opts.locale` or `NEXT_LOCALE` cookie
- *   - `X-API-Key` from `opts.apiKey` or `NEXT_PUBLIC_API_KEY`
- *   - `credentials: 'include'` for Django session/CSRF cookies (toggle via opts)
- */
-export class API {
-  private baseUrl: string;
-  private storage: StorageAdapter;
-  private locale: string | null;
-  private apiKey: string | null;
-  readonly logger: APILogger;
-
-  readonly cfg = Cfg;
-  readonly monitor = Monitor;
-
-  constructor(baseUrl: string, opts: APIOptions = {}) {
-    this.baseUrl = baseUrl.replace(/\/$/, '');
-    this.storage = opts.storage ?? new LocalStorageAdapter();
-    this.logger = new APILogger(opts.logger);
-    this.locale = opts.locale ?? null;
-    this.apiKey = opts.apiKey ?? (typeof process !== 'undefined' ? (process.env?.NEXT_PUBLIC_API_KEY ?? null) : null);
-
-    const credentials: RequestCredentials = (opts.withCredentials ?? true) ? 'include' : 'same-origin';
-    client.setConfig({ baseUrl: this.baseUrl, credentials });
-
-    client.interceptors.request.use((request) => {
-      const access = this.getToken();
-      if (access) request.headers.set('Authorization', `Bearer ${access}`);
-
-      const locale = this.locale ?? detectLocale();
-      if (locale) request.headers.set('Accept-Language', locale);
-
-      if (this.apiKey) request.headers.set('X-API-Key', this.apiKey);
-
-      return request;
-    });
-
-
-  }
-
-  // ── Base URL ────────────────────────────────────────────────────────────
-  getBaseUrl(): string { return this.baseUrl; }
-  setBaseUrl(url: string): void {
-    this.baseUrl = url.replace(/\/$/, '');
-    client.setConfig({ baseUrl: this.baseUrl });
-  }
-
-  // ── Tokens ──────────────────────────────────────────────────────────────
-  getToken(): string | null { return this.storage.getItem(ACCESS_KEY); }
-  setToken(token: string | null): void {
-    if (token) this.storage.setItem(ACCESS_KEY, token);
-    else this.storage.removeItem(ACCESS_KEY);
-  }
-  getRefreshToken(): string | null { return this.storage.getItem(REFRESH_KEY); }
-  setRefreshToken(token: string | null): void {
-    if (token) this.storage.setItem(REFRESH_KEY, token);
-    else this.storage.removeItem(REFRESH_KEY);
-  }
-  clearToken(): void {
-    this.storage.removeItem(ACCESS_KEY);
-    this.storage.removeItem(REFRESH_KEY);
-  }
-  isAuthenticated(): boolean { return this.getToken() !== null; }
-
-  // ── Locale / API key ────────────────────────────────────────────────────
-  getLocale(): string | null { return this.locale ?? detectLocale(); }
-  setLocale(locale: string | null): void { this.locale = locale; }
-  getApiKey(): string | null { return this.apiKey; }
-  setApiKey(key: string | null): void { this.apiKey = key; }
-}
-
-export { Cfg, Monitor };
-export { client };

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

@@ -1,27 +0,0 @@
-// 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";
-
-export const FrontendEventIngestRequestSchema = z.object({
-  event_type: EventTypeEnumSchema,
-  message: z.string().min(1).max(5000),
-  level: LevelEnumSchema.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.unknown().optional(),
-  project_name: z.string().max(100).optional(),
-});
-
-export type FrontendEventIngestRequest = z.infer<typeof FrontendEventIngestRequestSchema>;

package/src/_api/generated/{cfg_monitor/types.gen.ts → types.gen.ts}

@@ -27,21 +27,21 @@ export enum EventTypeEnum {
  * Single browser event payload.
  */
 export type FrontendEventIngestRequest = {
+    build_id?: string;
+    environment?: string;
     event_type: EventTypeEnum;
-    message: string;
-    level?: LevelEnum;
-    stack_trace?: string;
-    url?: string;
+    extra?: unknown;
     fingerprint?: string;
-    http_status?: number | null;
     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;
-    build_id?: string;
-    environment?: string;
-    extra?: unknown;
-    project_name?: string;
 };
 
 /**