@cherrydotfun/collector-sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,431 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CollectorClient: () => CollectorClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/queue.ts
+var EventQueue = class {
+  constructor(options) {
+    this.queue = [];
+    this.timer = null;
+    this.flushing = false;
+    this.pendingFlush = false;
+    this._sent = 0;
+    this._failed = 0;
+    this.batchSize = options.batchSize;
+    this.flushIntervalMs = options.flushIntervalMs;
+    this.sendBatch = options.sendBatch;
+    this.onError = options.onError;
+    this.startTimer();
+  }
+  /** Add an event to the queue. Triggers a flush when batch size is reached. */
+  add(event) {
+    this.queue.push(event);
+    if (this.queue.length >= this.batchSize) {
+      this.flush();
+    }
+  }
+  /** Send all queued events immediately. Safe to call concurrently. */
+  async flush() {
+    if (this.flushing) {
+      this.pendingFlush = true;
+      return;
+    }
+    if (this.queue.length === 0) return;
+    this.flushing = true;
+    try {
+      while (this.queue.length > 0) {
+        const batch = this.queue.splice(0, this.batchSize);
+        try {
+          await this.sendBatch(batch);
+          this._sent += batch.length;
+        } catch (e) {
+          this._failed += batch.length;
+          if (this.onError && e instanceof Error) {
+            this.onError(e);
+          }
+        }
+        this.pendingFlush = false;
+      }
+    } finally {
+      this.flushing = false;
+      if (this.pendingFlush) {
+        this.pendingFlush = false;
+        this.flush();
+      }
+    }
+  }
+  /** Stop the periodic flush timer. Does not flush remaining events. */
+  destroy() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+  }
+  /** Number of events currently waiting in the queue. */
+  get size() {
+    return this.queue.length;
+  }
+  /** Returns send/fail counters since creation or last {@link resetStats} call. */
+  getStats() {
+    return { sent: this._sent, failed: this._failed };
+  }
+  /** Reset all counters to zero. */
+  resetStats() {
+    this._sent = 0;
+    this._failed = 0;
+  }
+  startTimer() {
+    this.timer = setInterval(() => {
+      this.flush();
+    }, this.flushIntervalMs);
+  }
+};
+
+// src/client.ts
+var CollectorClient = class {
+  constructor(config) {
+    this.disabledPatterns = /* @__PURE__ */ new Set();
+    this.configRefreshTimer = null;
+    this.initialized = false;
+    this._lastConfig = null;
+    this._dropped = 0;
+    this.config = {
+      batchSize: 10,
+      flushIntervalMs: 5e3,
+      configRefreshSec: 300,
+      platform: void 0,
+      version: void 0,
+      debug: false,
+      ...config
+    };
+    this.queue = new EventQueue({
+      batchSize: this.config.batchSize,
+      flushIntervalMs: this.config.flushIntervalMs,
+      sendBatch: (events) => this.sendBatch(events),
+      onError: config.onError ? (err) => config.onError(err, "sendBatch") : void 0
+    });
+  }
+  // ---------------------------------------------------------------------------
+  // Lifecycle
+  // ---------------------------------------------------------------------------
+  /**
+   * Initialize the client: fetches filter configuration from the server
+   * and starts the periodic config refresh timer.
+   * Must be called before sending events.
+   */
+  async init() {
+    await this.refreshConfig();
+    this.configRefreshTimer = setInterval(
+      () => this.refreshConfig(),
+      this.config.configRefreshSec * 1e3
+    );
+    this.initialized = true;
+    this.log_debug("Collector initialized");
+  }
+  /**
+   * Flush all queued events to the server immediately.
+   * Returns when the send completes (or fails silently).
+   */
+  async flush() {
+    await this.queue.flush();
+  }
+  /**
+   * Stop all timers and flush remaining events.
+   * Call before application exit or when the client is no longer needed.
+   */
+  destroy() {
+    this.queue.destroy();
+    if (this.configRefreshTimer) {
+      clearInterval(this.configRefreshTimer);
+      this.configRefreshTimer = null;
+    }
+    this.flush();
+  }
+  // ---------------------------------------------------------------------------
+  // Context setters
+  // ---------------------------------------------------------------------------
+  /** Set the user ID attached to all subsequent events. */
+  setUser(userId) {
+    this._userId = userId;
+    this.log_debug("User set:", userId);
+  }
+  /** Set the session ID attached to all subsequent events. */
+  setSession(sessionId) {
+    this._sessionId = sessionId;
+    this.log_debug("Session set:", sessionId);
+  }
+  /** Set the default module name attached to all subsequent events. */
+  setModule(module2) {
+    this._module = module2;
+    this.log_debug("Module set:", module2);
+  }
+  /** Set the device ID attached to all subsequent events. */
+  setDevice(deviceId) {
+    this._deviceId = deviceId;
+    this.log_debug("Device set:", deviceId);
+  }
+  // ---------------------------------------------------------------------------
+  // Error events
+  // ---------------------------------------------------------------------------
+  /**
+   * Send an error event.
+   * @param message  Error description.
+   * @param params   Optional parameters. The special `stackTrace` key is extracted
+   *                 and sent as the structured `stackTrace.raw` field.
+   */
+  error(message, params) {
+    const { stackTrace, ...rest } = params ?? {};
+    this.enqueue({
+      type: "error",
+      level: "error",
+      message,
+      params: Object.keys(rest).length > 0 ? rest : void 0,
+      stackTrace: stackTrace ? { raw: stackTrace } : void 0
+    });
+  }
+  // ---------------------------------------------------------------------------
+  // Log events
+  // ---------------------------------------------------------------------------
+  /**
+   * Send a log event with an explicit level.
+   * @param level   Severity: `fatal`, `error`, `warn`, `info`, or `debug`.
+   * @param message Log message.
+   * @param params  Optional key-value parameters.
+   */
+  log(level, message, params) {
+    this.enqueue({ type: "log", level, message, params });
+  }
+  /** Shorthand for `log('fatal', message, params)`. */
+  fatal(message, params) {
+    this.log("fatal", message, params);
+  }
+  /** Shorthand for `log('warn', message, params)`. */
+  warn(message, params) {
+    this.log("warn", message, params);
+  }
+  /** Shorthand for `log('info', message, params)`. */
+  info(message, params) {
+    this.log("info", message, params);
+  }
+  /** Shorthand for `log('debug', message, params)`. */
+  debug(message, params) {
+    this.log("debug", message, params);
+  }
+  // ---------------------------------------------------------------------------
+  // Analytics events
+  // ---------------------------------------------------------------------------
+  /**
+   * Send an analytics event.
+   * @param event   Event name (e.g. `screen_view`, `button_click`).
+   * @param message Human-readable description (e.g. screen name or action label).
+   * @param params  Optional key-value parameters.
+   */
+  analytics(event, message, params) {
+    this.enqueue({ type: "analytics", event, message, params });
+  }
+  // ---------------------------------------------------------------------------
+  // Metrics
+  // ---------------------------------------------------------------------------
+  /**
+   * Set a single metric value. Sent immediately (not batched).
+   * @param key   Metric key (e.g. `ws_connections`).
+   * @param value Numeric value.
+   */
+  async metric(key, value) {
+    try {
+      await this.doFetch("/api/metrics/set", {
+        method: "POST",
+        body: JSON.stringify({ key, value })
+      });
+    } catch (e) {
+      this.handleError(e, "metric");
+    }
+  }
+  /**
+   * Set multiple metric values in one request. Sent immediately (not batched).
+   * Backend accepts up to 100 operations per call.
+   * @param ops Array of `{ key, value }` pairs.
+   */
+  async metricBatch(ops) {
+    try {
+      await this.doFetch("/api/metrics/batch", {
+        method: "POST",
+        body: JSON.stringify({ ops })
+      });
+    } catch (e) {
+      this.handleError(e, "metricBatch");
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Direct send (bypass queue)
+  // ---------------------------------------------------------------------------
+  /**
+   * Send a single event immediately via `POST /api/collect`, bypassing the batch queue.
+   * Useful for critical events that must not be delayed.
+   *
+   * The event is enriched with context (userId, sessionId, platform, etc.)
+   * and filtered against disabled patterns, same as queued events.
+   *
+   * @param event Partial event data. `type` and `message` are required.
+   */
+  async send(event) {
+    const full = this.buildEvent(event);
+    if (!full) return;
+    try {
+      await this.doFetch("/api/collect", {
+        method: "POST",
+        body: JSON.stringify(full)
+      });
+    } catch (e) {
+      this.handleError(e, "send");
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Config
+  // ---------------------------------------------------------------------------
+  /**
+   * Force-refresh the filter configuration from the server.
+   * Normally called automatically on the configured interval.
+   */
+  async refreshConfig() {
+    try {
+      const cfg = await this.doFetch("/api/config");
+      this.disabledPatterns = new Set(cfg.disabled);
+      this._lastConfig = cfg;
+      this.log_debug("Config refreshed, disabled:", cfg.disabled);
+    } catch (e) {
+      this.handleError(e, "refreshConfig");
+    }
+  }
+  /**
+   * Returns the last successfully fetched server configuration,
+   * or `null` if no config has been loaded yet.
+   */
+  getConfig() {
+    return this._lastConfig;
+  }
+  // ---------------------------------------------------------------------------
+  // Observability
+  // ---------------------------------------------------------------------------
+  /**
+   * Returns SDK telemetry counters: events sent, dropped (filtered), failed,
+   * and current queue size.
+   */
+  getStats() {
+    const queueStats = this.queue.getStats();
+    return {
+      sent: queueStats.sent,
+      dropped: this._dropped,
+      failed: queueStats.failed,
+      queueSize: this.queue.size
+    };
+  }
+  /** Whether {@link init} has been called and completed successfully. */
+  get isInitialized() {
+    return this.initialized;
+  }
+  // ---------------------------------------------------------------------------
+  // Private methods
+  // ---------------------------------------------------------------------------
+  buildEvent(event) {
+    const classPath = event.type === "analytics" ? `analytics.${event.event}` : `${event.type}.${event.level}`;
+    if (this.isDisabled(classPath)) {
+      this._dropped++;
+      this.log_debug(`Event disabled: ${classPath}`);
+      return null;
+    }
+    const full = {
+      type: event.type,
+      level: event.level,
+      event: event.event,
+      message: event.message,
+      params: event.params,
+      stackTrace: event.stackTrace,
+      platform: event.platform ?? this.config.platform,
+      version: event.version ?? this.config.version,
+      userId: this._userId,
+      sessionId: this._sessionId,
+      module: event.module ?? this._module,
+      deviceId: event.deviceId ?? this._deviceId,
+      timestamp: event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
+    };
+    Object.keys(full).forEach((key) => {
+      if (full[key] === void 0) {
+        delete full[key];
+      }
+    });
+    return full;
+  }
+  enqueue(event) {
+    const full = this.buildEvent(event);
+    if (!full) return;
+    this.queue.add(full);
+  }
+  isDisabled(classPath) {
+    if (this.disabledPatterns.has(classPath)) return true;
+    const type = classPath.split(".")[0];
+    if (this.disabledPatterns.has(`${type}.*`)) return true;
+    if (this.disabledPatterns.has(type)) return true;
+    if (this.disabledPatterns.has("*")) return true;
+    return false;
+  }
+  async sendBatch(events) {
+    await this.doFetch("/api/collect/batch", {
+      method: "POST",
+      body: JSON.stringify({ events })
+    });
+    this.log_debug(`Sent batch of ${events.length} events`);
+  }
+  async doFetch(path, options) {
+    const res = await globalThis.fetch(`${this.config.baseUrl}${path}`, {
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": this.config.apiKey,
+        ...options?.headers
+      }
+    });
+    if (!res.ok) {
+      throw new Error(`Collector API error: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+  }
+  handleError(e, context) {
+    this.log_debug(`Failed ${context}:`, e);
+    if (this.config.onError && e instanceof Error) {
+      this.config.onError(e, context);
+    }
+  }
+  log_debug(...args) {
+    if (this.config.debug) {
+      console.debug("[collector]", ...args);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CollectorClient
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/queue.ts","../src/client.ts"],"sourcesContent":["export { CollectorClient } from './client';\nexport type {\n  CollectorConfig,\n  CollectorEvent,\n  CollectorStats,\n  ConfigResponse,\n  EventType,\n  LogLevel,\n  AnalyticsLevel,\n  MetricOp,\n  IngestResponse,\n  BatchIngestResponse,\n} from './types';\n","import { CollectorEvent } from './types';\n\nexport interface QueueOptions {\n  batchSize: number;\n  flushIntervalMs: number;\n  sendBatch: (events: CollectorEvent[]) => Promise<void>;\n  onError?: (error: Error) => void;\n}\n\nexport interface QueueStats {\n  sent: number;\n  failed: number;\n}\n\nexport class EventQueue {\n  private queue: CollectorEvent[] = [];\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private readonly batchSize: number;\n  private readonly flushIntervalMs: number;\n  private readonly sendBatch: (events: CollectorEvent[]) => Promise<void>;\n  private readonly onError?: (error: Error) => void;\n  private flushing = false;\n  private pendingFlush = false;\n  private _sent = 0;\n  private _failed = 0;\n\n  constructor(options: QueueOptions) {\n    this.batchSize = options.batchSize;\n    this.flushIntervalMs = options.flushIntervalMs;\n    this.sendBatch = options.sendBatch;\n    this.onError = options.onError;\n    this.startTimer();\n  }\n\n  /** Add an event to the queue. Triggers a flush when batch size is reached. */\n  add(event: CollectorEvent): void {\n    this.queue.push(event);\n    if (this.queue.length >= this.batchSize) {\n      this.flush();\n    }\n  }\n\n  /** Send all queued events immediately. Safe to call concurrently. */\n  async flush(): Promise<void> {\n    if (this.flushing) {\n      this.pendingFlush = true;\n      return;\n    }\n\n    if (this.queue.length === 0) return;\n\n    this.flushing = true;\n    try {\n      while (this.queue.length > 0) {\n        const batch = this.queue.splice(0, this.batchSize);\n        try {\n          await this.sendBatch(batch);\n          this._sent += batch.length;\n        } catch (e) {\n          this._failed += batch.length;\n          if (this.onError && e instanceof Error) {\n            this.onError(e);\n          }\n        }\n        this.pendingFlush = false;\n      }\n    } finally {\n      this.flushing = false;\n      if (this.pendingFlush) {\n        this.pendingFlush = false;\n        this.flush();\n      }\n    }\n  }\n\n  /** Stop the periodic flush timer. Does not flush remaining events. */\n  destroy(): void {\n    if (this.timer) {\n      clearInterval(this.timer);\n      this.timer = null;\n    }\n  }\n\n  /** Number of events currently waiting in the queue. */\n  get size(): number {\n    return this.queue.length;\n  }\n\n  /** Returns send/fail counters since creation or last {@link resetStats} call. */\n  getStats(): QueueStats {\n    return { sent: this._sent, failed: this._failed };\n  }\n\n  /** Reset all counters to zero. */\n  resetStats(): void {\n    this._sent = 0;\n    this._failed = 0;\n  }\n\n  private startTimer(): void {\n    this.timer = setInterval(() => {\n      this.flush();\n    }, this.flushIntervalMs);\n  }\n}\n","import {\n  CollectorConfig,\n  CollectorEvent,\n  CollectorStats,\n  ConfigResponse,\n  LogLevel,\n  MetricOp,\n} from './types';\nimport { EventQueue } from './queue';\n\nexport class CollectorClient {\n  private config: Required<Omit<CollectorConfig, 'onError'>> & { onError?: CollectorConfig['onError'] };\n  private queue: EventQueue;\n  private disabledPatterns: Set<string> = new Set();\n  private configRefreshTimer: ReturnType<typeof setInterval> | null = null;\n  private initialized = false;\n  private _lastConfig: ConfigResponse | null = null;\n  private _dropped = 0;\n\n  private _userId: string | undefined;\n  private _sessionId: string | undefined;\n  private _module: string | undefined;\n  private _deviceId: string | undefined;\n\n  constructor(config: CollectorConfig) {\n    this.config = {\n      batchSize: 10,\n      flushIntervalMs: 5000,\n      configRefreshSec: 300,\n      platform: undefined as unknown as string,\n      version: undefined as unknown as string,\n      debug: false,\n      ...config,\n    };\n\n    this.queue = new EventQueue({\n      batchSize: this.config.batchSize,\n      flushIntervalMs: this.config.flushIntervalMs,\n      sendBatch: (events) => this.sendBatch(events),\n      onError: config.onError\n        ? (err) => config.onError!(err, 'sendBatch')\n        : undefined,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lifecycle\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Initialize the client: fetches filter configuration from the server\n   * and starts the periodic config refresh timer.\n   * Must be called before sending events.\n   */\n  async init(): Promise<void> {\n    await this.refreshConfig();\n    this.configRefreshTimer = setInterval(\n      () => this.refreshConfig(),\n      this.config.configRefreshSec * 1000,\n    );\n    this.initialized = true;\n    this.log_debug('Collector initialized');\n  }\n\n  /**\n   * Flush all queued events to the server immediately.\n   * Returns when the send completes (or fails silently).\n   */\n  async flush(): Promise<void> {\n    await this.queue.flush();\n  }\n\n  /**\n   * Stop all timers and flush remaining events.\n   * Call before application exit or when the client is no longer needed.\n   */\n  destroy(): void {\n    this.queue.destroy();\n    if (this.configRefreshTimer) {\n      clearInterval(this.configRefreshTimer);\n      this.configRefreshTimer = null;\n    }\n    // Final flush — fire and forget\n    this.flush();\n  }\n\n  // ---------------------------------------------------------------------------\n  // Context setters\n  // ---------------------------------------------------------------------------\n\n  /** Set the user ID attached to all subsequent events. */\n  setUser(userId: string): void {\n    this._userId = userId;\n    this.log_debug('User set:', userId);\n  }\n\n  /** Set the session ID attached to all subsequent events. */\n  setSession(sessionId: string): void {\n    this._sessionId = sessionId;\n    this.log_debug('Session set:', sessionId);\n  }\n\n  /** Set the default module name attached to all subsequent events. */\n  setModule(module: string): void {\n    this._module = module;\n    this.log_debug('Module set:', module);\n  }\n\n  /** Set the device ID attached to all subsequent events. */\n  setDevice(deviceId: string): void {\n    this._deviceId = deviceId;\n    this.log_debug('Device set:', deviceId);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Error events\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Send an error event.\n   * @param message  Error description.\n   * @param params   Optional parameters. The special `stackTrace` key is extracted\n   *                 and sent as the structured `stackTrace.raw` field.\n   */\n  error(message: string, params?: Record<string, unknown> & { stackTrace?: string }): void {\n    const { stackTrace, ...rest } = params ?? {};\n    this.enqueue({\n      type: 'error',\n      level: 'error',\n      message,\n      params: Object.keys(rest).length > 0 ? rest : undefined,\n      stackTrace: stackTrace ? { raw: stackTrace } : undefined,\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Log events\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Send a log event with an explicit level.\n   * @param level   Severity: `fatal`, `error`, `warn`, `info`, or `debug`.\n   * @param message Log message.\n   * @param params  Optional key-value parameters.\n   */\n  log(level: LogLevel, message: string, params?: Record<string, unknown>): void {\n    this.enqueue({ type: 'log', level, message, params });\n  }\n\n  /** Shorthand for `log('fatal', message, params)`. */\n  fatal(message: string, params?: Record<string, unknown>): void {\n    this.log('fatal', message, params);\n  }\n\n  /** Shorthand for `log('warn', message, params)`. */\n  warn(message: string, params?: Record<string, unknown>): void {\n    this.log('warn', message, params);\n  }\n\n  /** Shorthand for `log('info', message, params)`. */\n  info(message: string, params?: Record<string, unknown>): void {\n    this.log('info', message, params);\n  }\n\n  /** Shorthand for `log('debug', message, params)`. */\n  debug(message: string, params?: Record<string, unknown>): void {\n    this.log('debug', message, params);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Analytics events\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Send an analytics event.\n   * @param event   Event name (e.g. `screen_view`, `button_click`).\n   * @param message Human-readable description (e.g. screen name or action label).\n   * @param params  Optional key-value parameters.\n   */\n  analytics(event: string, message: string, params?: Record<string, unknown>): void {\n    this.enqueue({ type: 'analytics', event, message, params });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Metrics\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Set a single metric value. Sent immediately (not batched).\n   * @param key   Metric key (e.g. `ws_connections`).\n   * @param value Numeric value.\n   */\n  async metric(key: string, value: number): Promise<void> {\n    try {\n      await this.doFetch('/api/metrics/set', {\n        method: 'POST',\n        body: JSON.stringify({ key, value }),\n      });\n    } catch (e) {\n      this.handleError(e, 'metric');\n    }\n  }\n\n  /**\n   * Set multiple metric values in one request. Sent immediately (not batched).\n   * Backend accepts up to 100 operations per call.\n   * @param ops Array of `{ key, value }` pairs.\n   */\n  async metricBatch(ops: MetricOp[]): Promise<void> {\n    try {\n      await this.doFetch('/api/metrics/batch', {\n        method: 'POST',\n        body: JSON.stringify({ ops }),\n      });\n    } catch (e) {\n      this.handleError(e, 'metricBatch');\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Direct send (bypass queue)\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Send a single event immediately via `POST /api/collect`, bypassing the batch queue.\n   * Useful for critical events that must not be delayed.\n   *\n   * The event is enriched with context (userId, sessionId, platform, etc.)\n   * and filtered against disabled patterns, same as queued events.\n   *\n   * @param event Partial event data. `type` and `message` are required.\n   */\n  async send(event: Partial<CollectorEvent> & { type: CollectorEvent['type']; message: string }): Promise<void> {\n    const full = this.buildEvent(event);\n    if (!full) return; // dropped by filter\n\n    try {\n      await this.doFetch('/api/collect', {\n        method: 'POST',\n        body: JSON.stringify(full),\n      });\n    } catch (e) {\n      this.handleError(e, 'send');\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Config\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Force-refresh the filter configuration from the server.\n   * Normally called automatically on the configured interval.\n   */\n  async refreshConfig(): Promise<void> {\n    try {\n      const cfg = await this.doFetch<ConfigResponse>('/api/config');\n      this.disabledPatterns = new Set(cfg.disabled);\n      this._lastConfig = cfg;\n      this.log_debug('Config refreshed, disabled:', cfg.disabled);\n    } catch (e) {\n      this.handleError(e, 'refreshConfig');\n    }\n  }\n\n  /**\n   * Returns the last successfully fetched server configuration,\n   * or `null` if no config has been loaded yet.\n   */\n  getConfig(): ConfigResponse | null {\n    return this._lastConfig;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Observability\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Returns SDK telemetry counters: events sent, dropped (filtered), failed,\n   * and current queue size.\n   */\n  getStats(): CollectorStats {\n    const queueStats = this.queue.getStats();\n    return {\n      sent: queueStats.sent,\n      dropped: this._dropped,\n      failed: queueStats.failed,\n      queueSize: this.queue.size,\n    };\n  }\n\n  /** Whether {@link init} has been called and completed successfully. */\n  get isInitialized(): boolean {\n    return this.initialized;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private methods\n  // ---------------------------------------------------------------------------\n\n  private buildEvent(event: Partial<CollectorEvent>): CollectorEvent | null {\n    const classPath =\n      event.type === 'analytics'\n        ? `analytics.${event.event}`\n        : `${event.type}.${event.level}`;\n\n    if (this.isDisabled(classPath)) {\n      this._dropped++;\n      this.log_debug(`Event disabled: ${classPath}`);\n      return null;\n    }\n\n    const full: CollectorEvent = {\n      type: event.type!,\n      level: event.level,\n      event: event.event,\n      message: event.message!,\n      params: event.params,\n      stackTrace: event.stackTrace,\n      platform: event.platform ?? this.config.platform,\n      version: event.version ?? this.config.version,\n      userId: this._userId,\n      sessionId: this._sessionId,\n      module: event.module ?? this._module,\n      deviceId: event.deviceId ?? this._deviceId,\n      timestamp: event.timestamp ?? new Date().toISOString(),\n    };\n\n    // Remove undefined fields to keep payloads clean\n    (Object.keys(full) as Array<keyof CollectorEvent>).forEach((key) => {\n      if (full[key] === undefined) {\n        delete full[key];\n      }\n    });\n\n    return full;\n  }\n\n  private enqueue(event: Partial<CollectorEvent>): void {\n    const full = this.buildEvent(event);\n    if (!full) return;\n    this.queue.add(full);\n  }\n\n  private isDisabled(classPath: string): boolean {\n    if (this.disabledPatterns.has(classPath)) return true;\n    const type = classPath.split('.')[0];\n    if (this.disabledPatterns.has(`${type}.*`)) return true;\n    if (this.disabledPatterns.has(type)) return true;\n    if (this.disabledPatterns.has('*')) return true;\n    return false;\n  }\n\n  private async sendBatch(events: CollectorEvent[]): Promise<void> {\n    await this.doFetch('/api/collect/batch', {\n      method: 'POST',\n      body: JSON.stringify({ events }),\n    });\n    this.log_debug(`Sent batch of ${events.length} events`);\n  }\n\n  private async doFetch<T = unknown>(path: string, options?: RequestInit): Promise<T> {\n    const res = await globalThis.fetch(`${this.config.baseUrl}${path}`, {\n      ...options,\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': this.config.apiKey,\n        ...options?.headers,\n      },\n    });\n    if (!res.ok) {\n      throw new Error(`Collector API error: ${res.status} ${res.statusText}`);\n    }\n    return res.json() as Promise<T>;\n  }\n\n  private handleError(e: unknown, context: string): void {\n    this.log_debug(`Failed ${context}:`, e);\n    if (this.config.onError && e instanceof Error) {\n      this.config.onError(e, context);\n    }\n  }\n\n  private log_debug(...args: unknown[]): void {\n    if (this.config.debug) {\n      console.debug('[collector]', ...args);\n    }\n  }\n}\n"],"mappings":"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","names":["module"]}