@athenaintel/react 0.18.0 → 0.20.0

package/dist/lib/posthog/capture-gate.cjs

@@ -0,0 +1,322 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DEFAULT_CAPTURE_GATE_CONFIG = {
+  globalMaxPerWindow: 50,
+  globalWindowMs: 1e4,
+  criticalReservePerWindow: 15,
+  defaultEventMaxPerWindow: 12,
+  defaultEventWindowMs: 6e4,
+  defaultDedupeWindowMs: 5e3,
+  flushIntervalMs: 3e4,
+  flushCoalesceThreshold: 20,
+  eventOverrides: {
+    memory_profile_sample: { maxPerWindow: 2, windowMs: 3e4, dedupeWindowMs: 15e3 },
+    long_task_detected: { maxPerWindow: 3, windowMs: 6e4, dedupeWindowMs: 1e4 },
+    collab_connection_status_changed: { maxPerWindow: 6, windowMs: 6e4 },
+    collab_first_remote_update: { maxPerWindow: 3, windowMs: 6e4 },
+    collab_first_local_update: { maxPerWindow: 3, windowMs: 6e4 },
+    collab_render_time_sync_fix: { maxPerWindow: 3, windowMs: 6e4 },
+    collab_visibility_recovery: { maxPerWindow: 4, windowMs: 6e4 },
+    langgraph_message_validation_error: {
+      maxPerWindow: 8,
+      windowMs: 6e4,
+      dedupeWindowMs: 15e3
+    },
+    langgraph_messages_validation_error: {
+      maxPerWindow: 5,
+      windowMs: 6e4,
+      dedupeWindowMs: 15e3
+    },
+    langgraph_interrupt_validation_error: {
+      maxPerWindow: 5,
+      windowMs: 6e4,
+      dedupeWindowMs: 15e3
+    },
+    langgraph_state_validation_error: {
+      maxPerWindow: 5,
+      windowMs: 6e4,
+      dedupeWindowMs: 15e3
+    },
+    graphql_error: { maxPerWindow: 12, windowMs: 6e4, dedupeWindowMs: 1e4 },
+    chat_error: { maxPerWindow: 8, windowMs: 6e4, dedupeWindowMs: 5e3 },
+    memory_critical_threshold: { maxPerWindow: 3, windowMs: 3e5 },
+    memory_warning_threshold: { maxPerWindow: 3, windowMs: 3e5 },
+    pptx_slide_changed: { maxPerWindow: 8, windowMs: 3e4 }
+  }
+};
+const CRITICAL_EVENT_PATTERNS = [
+  /(?:^|_)failed$/,
+  /(?:^|_)error(?:_|$)/,
+  /crash/,
+  /^oom_/,
+  /aw_snap/,
+  /chunk_load/,
+  /global_error/,
+  /\$exception$/,
+  /^404_error$/,
+  /^500_error$/,
+  /_boundary_/
+];
+const BYPASS_OPTION_KEY = "__posthog_gate_bypass";
+function isCriticalPosthogEvent(event) {
+  return CRITICAL_EVENT_PATTERNS.some((pattern) => pattern.test(event));
+}
+function shouldBypassCaptureGate(options) {
+  if (!options || typeof options !== "object") return false;
+  return options[BYPASS_OPTION_KEY] === true;
+}
+function withCaptureGateBypass(options) {
+  return {
+    ...options ?? {},
+    [BYPASS_OPTION_KEY]: true
+  };
+}
+function pruneWindow(window, now, windowMs) {
+  const cutoff = now - windowMs;
+  while (window.timestamps.length > 0 && window.timestamps[0] < cutoff) {
+    window.timestamps.shift();
+  }
+}
+function countInWindow(window, now, windowMs) {
+  pruneWindow(window, now, windowMs);
+  return window.timestamps.length;
+}
+function recordInWindow(window, now) {
+  window.timestamps.push(now);
+}
+function stableStringify(value) {
+  if (value == null) return String(value);
+  if (typeof value !== "object") return String(value);
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+  }
+  const record = value;
+  const keys = Object.keys(record).sort();
+  return `{${keys.map((key) => `${key}:${stableStringify(record[key])}`).join(",")}}`;
+}
+function fingerprintProperties(properties) {
+  if (!properties) return "";
+  const keys = [
+    "error",
+    "error_message",
+    "message",
+    "reason",
+    "status",
+    "code",
+    "asset_id",
+    "doc_id",
+    "thread_id",
+    "session_id",
+    "operation",
+    "path",
+    "url",
+    "chunk_identifier",
+    "validation_path",
+    "$exception_type",
+    "$exception_message"
+  ];
+  const subset = {};
+  for (const key of keys) {
+    if (key in properties) {
+      subset[key] = properties[key];
+    }
+  }
+  const primaryException = primaryExceptionEntry(properties.$exception_list);
+  if (primaryException) {
+    subset.$exception_type = primaryException.type;
+    subset.$exception_message = primaryException.value;
+  }
+  return stableStringify(subset);
+}
+function primaryExceptionEntry(exceptionList) {
+  if (!Array.isArray(exceptionList)) return void 0;
+  const first = exceptionList[0];
+  if (first === null || typeof first !== "object") return void 0;
+  const { type, value } = first;
+  return { type, value };
+}
+function buildCaptureFingerprint(event, properties) {
+  return `${event}|${fingerprintProperties(properties)}`;
+}
+function buildCoalescedCaptureProperties(payload) {
+  const windowMs = payload.lastAt - payload.firstAt;
+  return {
+    ...payload.properties,
+    coalesced: true,
+    coalesced_count: payload.coalescedCount,
+    coalesced_first_at: new Date(payload.firstAt).toISOString(),
+    coalesced_last_at: new Date(payload.lastAt).toISOString(),
+    coalesced_window_ms: windowMs,
+    coalesced_suppression_reason: payload.suppressionReason
+  };
+}
+class PosthogCaptureGate {
+  constructor(config = DEFAULT_CAPTURE_GATE_CONFIG) {
+    __publicField(this, "config");
+    __publicField(this, "globalWindow", { timestamps: [] });
+    __publicField(this, "eventWindows", /* @__PURE__ */ new Map());
+    __publicField(this, "activeDedupe", /* @__PURE__ */ new Map());
+    __publicField(this, "coalesceBuckets", /* @__PURE__ */ new Map());
+    __publicField(this, "emittedTotal", 0);
+    __publicField(this, "coalescedTotal", 0);
+    __publicField(this, "flushedCoalescedTotal", 0);
+    this.config = config;
+  }
+  resetForTests() {
+    this.globalWindow.timestamps.length = 0;
+    this.eventWindows.clear();
+    this.activeDedupe.clear();
+    this.coalesceBuckets.clear();
+    this.emittedTotal = 0;
+    this.coalescedTotal = 0;
+    this.flushedCoalescedTotal = 0;
+  }
+  getSnapshot() {
+    const coalescedPendingByEvent = {};
+    let coalescedPending = 0;
+    for (const bucket of this.coalesceBuckets.values()) {
+      coalescedPending += bucket.count;
+      coalescedPendingByEvent[bucket.event] = (coalescedPendingByEvent[bucket.event] ?? 0) + bucket.count;
+    }
+    return {
+      coalescedPending,
+      coalescedPendingByEvent,
+      emittedTotal: this.emittedTotal,
+      coalescedTotal: this.coalescedTotal,
+      flushedCoalescedTotal: this.flushedCoalescedTotal
+    };
+  }
+  evaluateCapture(event, properties, options, now = Date.now()) {
+    if (shouldBypassCaptureGate(options)) {
+      return { action: "emit" };
+    }
+    const fingerprint = buildCaptureFingerprint(event, properties);
+    const bucketKey = fingerprint;
+    const override = this.config.eventOverrides[event];
+    const dedupeWindowMs = (override == null ? void 0 : override.dedupeWindowMs) ?? this.config.defaultDedupeWindowMs;
+    const lastDedupe = this.activeDedupe.get(event);
+    if (lastDedupe && lastDedupe.fingerprint === fingerprint && now - lastDedupe.at < dedupeWindowMs) {
+      return this.recordCoalesce(event, bucketKey, fingerprint, properties, "dedupe", now);
+    }
+    const critical = isCriticalPosthogEvent(event);
+    const globalCount = countInWindow(this.globalWindow, now, this.config.globalWindowMs);
+    const normalBudget = Math.max(
+      0,
+      this.config.globalMaxPerWindow - this.config.criticalReservePerWindow
+    );
+    if (critical) {
+      if (globalCount >= this.config.globalMaxPerWindow) {
+        return this.recordCoalesce(event, bucketKey, fingerprint, properties, "global_budget", now);
+      }
+    } else if (globalCount >= normalBudget) {
+      return this.recordCoalesce(event, bucketKey, fingerprint, properties, "global_budget", now);
+    }
+    const eventWindow = this.eventWindows.get(event) ?? { timestamps: [] };
+    this.eventWindows.set(event, eventWindow);
+    const eventMax = (override == null ? void 0 : override.maxPerWindow) ?? this.config.defaultEventMaxPerWindow;
+    const eventWindowMs = (override == null ? void 0 : override.windowMs) ?? this.config.defaultEventWindowMs;
+    const eventCount = countInWindow(eventWindow, now, eventWindowMs);
+    if (eventCount >= eventMax) {
+      return this.recordCoalesce(event, bucketKey, fingerprint, properties, "event_budget", now);
+    }
+    recordInWindow(this.globalWindow, now);
+    recordInWindow(eventWindow, now);
+    this.activeDedupe.set(event, { fingerprint, bucketKey, at: now });
+    this.emittedTotal += 1;
+    return { action: "emit" };
+  }
+  /** Returns payloads ready to flush (does not mutate buckets until caller confirms). */
+  collectFlushCandidates(now = Date.now()) {
+    const payloads = [];
+    for (const bucket of this.coalesceBuckets.values()) {
+      const shouldFlushBySize = bucket.count >= this.config.flushCoalesceThreshold;
+      const shouldFlushByAge = now - bucket.firstAt >= this.config.flushIntervalMs;
+      if (!shouldFlushBySize && !shouldFlushByAge) {
+        continue;
+      }
+      payloads.push({
+        bucketKey: bucket.bucketKey,
+        event: bucket.event,
+        properties: bucket.sampleProperties,
+        coalescedCount: bucket.count,
+        firstAt: bucket.firstAt,
+        lastAt: bucket.lastAt,
+        suppressionReason: bucket.suppressionReason
+      });
+    }
+    return payloads;
+  }
+  /** Remove flushed bucket keys after successful emit. */
+  acknowledgeFlushed(payloads) {
+    for (const payload of payloads) {
+      this.coalesceBuckets.delete(payload.bucketKey);
+      this.flushedCoalescedTotal += payload.coalescedCount;
+    }
+  }
+  /** After coalescing, flush immediately if the bucket crossed the early threshold. */
+  takeBucketIfReady(bucketKey, now = Date.now()) {
+    const bucket = this.coalesceBuckets.get(bucketKey);
+    if (!bucket) return null;
+    const shouldFlushBySize = bucket.count >= this.config.flushCoalesceThreshold;
+    const shouldFlushByAge = now - bucket.firstAt >= this.config.flushIntervalMs;
+    if (!shouldFlushBySize && !shouldFlushByAge) {
+      return null;
+    }
+    this.coalesceBuckets.delete(bucketKey);
+    this.flushedCoalescedTotal += bucket.count;
+    return {
+      bucketKey: bucket.bucketKey,
+      event: bucket.event,
+      properties: bucket.sampleProperties,
+      coalescedCount: bucket.count,
+      firstAt: bucket.firstAt,
+      lastAt: bucket.lastAt,
+      suppressionReason: bucket.suppressionReason
+    };
+  }
+  /** Force-flush every pending bucket (e.g. page hide). */
+  collectAllPending() {
+    return [...this.coalesceBuckets.values()].map((bucket) => ({
+      bucketKey: bucket.bucketKey,
+      event: bucket.event,
+      properties: bucket.sampleProperties,
+      coalescedCount: bucket.count,
+      firstAt: bucket.firstAt,
+      lastAt: bucket.lastAt,
+      suppressionReason: bucket.suppressionReason
+    }));
+  }
+  recordCoalesce(event, bucketKey, fingerprint, properties, reason, now) {
+    const existing = this.coalesceBuckets.get(bucketKey);
+    if (existing) {
+      existing.count += 1;
+      existing.lastAt = now;
+      existing.sampleProperties = { ...existing.sampleProperties, ...properties ?? {} };
+    } else {
+      this.coalesceBuckets.set(bucketKey, {
+        event,
+        bucketKey,
+        fingerprint,
+        count: 1,
+        firstAt: now,
+        lastAt: now,
+        suppressionReason: reason,
+        sampleProperties: { ...properties ?? {} }
+      });
+    }
+    this.coalescedTotal += 1;
+    this.activeDedupe.set(event, { fingerprint, bucketKey, at: now });
+    return { action: "coalesce", reason, bucketKey };
+  }
+}
+exports.DEFAULT_CAPTURE_GATE_CONFIG = DEFAULT_CAPTURE_GATE_CONFIG;
+exports.PosthogCaptureGate = PosthogCaptureGate;
+exports.buildCaptureFingerprint = buildCaptureFingerprint;
+exports.buildCoalescedCaptureProperties = buildCoalescedCaptureProperties;
+exports.isCriticalPosthogEvent = isCriticalPosthogEvent;
+exports.shouldBypassCaptureGate = shouldBypassCaptureGate;
+exports.withCaptureGateBypass = withCaptureGateBypass;
+//# sourceMappingURL=capture-gate.cjs.map

package/dist/lib/posthog/capture-gate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-gate.cjs","sources":["../../../src/lib/posthog/capture-gate.ts"],"sourcesContent":["import type { CaptureOptions, Properties } from 'posthog-js';\n\nexport type CaptureGateSuppressReason = 'global_budget' | 'event_budget' | 'dedupe';\n\nexport type CaptureGateOutcome =\n  | { action: 'emit' }\n  | {\n      action: 'coalesce';\n      reason: CaptureGateSuppressReason;\n      bucketKey: string;\n    };\n\nexport interface CaptureGateEventOverride {\n  maxPerWindow: number;\n  windowMs: number;\n  dedupeWindowMs?: number;\n}\n\nexport interface CaptureGateConfig {\n  globalMaxPerWindow: number;\n  globalWindowMs: number;\n  criticalReservePerWindow: number;\n  defaultEventMaxPerWindow: number;\n  defaultEventWindowMs: number;\n  defaultDedupeWindowMs: number;\n  /** Flush coalesced buckets on this interval (ms). */\n  flushIntervalMs: number;\n  /** Flush a bucket early once it reaches this many suppressed occurrences. */\n  flushCoalesceThreshold: number;\n  eventOverrides: Record<string, CaptureGateEventOverride>;\n}\n\nexport interface CoalescedCapturePayload {\n  bucketKey: string;\n  event: string;\n  properties: Properties;\n  coalescedCount: number;\n  firstAt: number;\n  lastAt: number;\n  suppressionReason: CaptureGateSuppressReason;\n}\n\nexport interface CaptureGateSnapshot {\n  coalescedPending: number;\n  coalescedPendingByEvent: Record<string, number>;\n  emittedTotal: number;\n  coalescedTotal: number;\n  flushedCoalescedTotal: number;\n}\n\nexport const DEFAULT_CAPTURE_GATE_CONFIG: CaptureGateConfig = {\n  globalMaxPerWindow: 50,\n  globalWindowMs: 10_000,\n  criticalReservePerWindow: 15,\n  defaultEventMaxPerWindow: 12,\n  defaultEventWindowMs: 60_000,\n  defaultDedupeWindowMs: 5_000,\n  flushIntervalMs: 30_000,\n  flushCoalesceThreshold: 20,\n  eventOverrides: {\n    memory_profile_sample: { maxPerWindow: 2, windowMs: 30_000, dedupeWindowMs: 15_000 },\n    long_task_detected: { maxPerWindow: 3, windowMs: 60_000, dedupeWindowMs: 10_000 },\n    collab_connection_status_changed: { maxPerWindow: 6, windowMs: 60_000 },\n    collab_first_remote_update: { maxPerWindow: 3, windowMs: 60_000 },\n    collab_first_local_update: { maxPerWindow: 3, windowMs: 60_000 },\n    collab_render_time_sync_fix: { maxPerWindow: 3, windowMs: 60_000 },\n    collab_visibility_recovery: { maxPerWindow: 4, windowMs: 60_000 },\n    langgraph_message_validation_error: {\n      maxPerWindow: 8,\n      windowMs: 60_000,\n      dedupeWindowMs: 15_000,\n    },\n    langgraph_messages_validation_error: {\n      maxPerWindow: 5,\n      windowMs: 60_000,\n      dedupeWindowMs: 15_000,\n    },\n    langgraph_interrupt_validation_error: {\n      maxPerWindow: 5,\n      windowMs: 60_000,\n      dedupeWindowMs: 15_000,\n    },\n    langgraph_state_validation_error: {\n      maxPerWindow: 5,\n      windowMs: 60_000,\n      dedupeWindowMs: 15_000,\n    },\n    graphql_error: { maxPerWindow: 12, windowMs: 60_000, dedupeWindowMs: 10_000 },\n    chat_error: { maxPerWindow: 8, windowMs: 60_000, dedupeWindowMs: 5_000 },\n    memory_critical_threshold: { maxPerWindow: 3, windowMs: 300_000 },\n    memory_warning_threshold: { maxPerWindow: 3, windowMs: 300_000 },\n    pptx_slide_changed: { maxPerWindow: 8, windowMs: 30_000 },\n  },\n};\n\nconst CRITICAL_EVENT_PATTERNS: RegExp[] = [\n  /(?:^|_)failed$/,\n  /(?:^|_)error(?:_|$)/,\n  /crash/,\n  /^oom_/,\n  /aw_snap/,\n  /chunk_load/,\n  /global_error/,\n  /\\$exception$/,\n  /^404_error$/,\n  /^500_error$/,\n  /_boundary_/,\n];\n\nconst BYPASS_OPTION_KEY = '__posthog_gate_bypass';\n\ntype CaptureOptionsWithBypass = CaptureOptions & Record<string, unknown>;\n\ninterface TimestampWindow {\n  timestamps: number[];\n}\n\ninterface CoalesceBucket {\n  event: string;\n  bucketKey: string;\n  fingerprint: string;\n  count: number;\n  firstAt: number;\n  lastAt: number;\n  suppressionReason: CaptureGateSuppressReason;\n  sampleProperties: Properties;\n}\n\ninterface ActiveDedupe {\n  fingerprint: string;\n  bucketKey: string;\n  at: number;\n}\n\nexport function isCriticalPosthogEvent(event: string): boolean {\n  return CRITICAL_EVENT_PATTERNS.some((pattern) => pattern.test(event));\n}\n\nexport function shouldBypassCaptureGate(options?: CaptureOptions): boolean {\n  if (!options || typeof options !== 'object') return false;\n  return (options as Record<string, unknown>)[BYPASS_OPTION_KEY] === true;\n}\n\nexport function withCaptureGateBypass(options?: CaptureOptions): CaptureOptions {\n  return {\n    ...(options ?? {}),\n    [BYPASS_OPTION_KEY]: true,\n  } as CaptureOptionsWithBypass;\n}\n\nfunction pruneWindow(window: TimestampWindow, now: number, windowMs: number): void {\n  const cutoff = now - windowMs;\n  while (window.timestamps.length > 0 && window.timestamps[0] < cutoff) {\n    window.timestamps.shift();\n  }\n}\n\nfunction countInWindow(window: TimestampWindow, now: number, windowMs: number): number {\n  pruneWindow(window, now, windowMs);\n  return window.timestamps.length;\n}\n\nfunction recordInWindow(window: TimestampWindow, now: number): void {\n  window.timestamps.push(now);\n}\n\nfunction stableStringify(value: unknown): string {\n  if (value == null) return String(value);\n  if (typeof value !== 'object') return String(value);\n  if (Array.isArray(value)) {\n    return `[${value.map((item) => stableStringify(item)).join(',')}]`;\n  }\n  const record = value as Record<string, unknown>;\n  const keys = Object.keys(record).sort();\n  return `{${keys.map((key) => `${key}:${stableStringify(record[key])}`).join(',')}}`;\n}\n\nfunction fingerprintProperties(properties?: Properties): string {\n  if (!properties) return '';\n\n  const keys = [\n    'error',\n    'error_message',\n    'message',\n    'reason',\n    'status',\n    'code',\n    'asset_id',\n    'doc_id',\n    'thread_id',\n    'session_id',\n    'operation',\n    'path',\n    'url',\n    'chunk_identifier',\n    'validation_path',\n    '$exception_type',\n    '$exception_message',\n  ] as const;\n\n  const subset: Record<string, unknown> = {};\n  for (const key of keys) {\n    if (key in properties) {\n      subset[key] = properties[key];\n    }\n  }\n\n  const primaryException = primaryExceptionEntry(properties.$exception_list);\n  if (primaryException) {\n    subset.$exception_type = primaryException.type;\n    subset.$exception_message = primaryException.value;\n  }\n\n  return stableStringify(subset);\n}\n\nfunction primaryExceptionEntry(\n  exceptionList: unknown\n): { type: unknown; value: unknown } | undefined {\n  if (!Array.isArray(exceptionList)) return undefined;\n  const first: unknown = exceptionList[0];\n  if (first === null || typeof first !== 'object') return undefined;\n  const { type, value } = first as { type?: unknown; value?: unknown };\n  return { type, value };\n}\n\nexport function buildCaptureFingerprint(event: string, properties?: Properties): string {\n  return `${event}|${fingerprintProperties(properties)}`;\n}\n\nexport function buildCoalescedCaptureProperties(\n  payload: CoalescedCapturePayload\n): Properties {\n  const windowMs = payload.lastAt - payload.firstAt;\n  return {\n    ...payload.properties,\n    coalesced: true,\n    coalesced_count: payload.coalescedCount,\n    coalesced_first_at: new Date(payload.firstAt).toISOString(),\n    coalesced_last_at: new Date(payload.lastAt).toISOString(),\n    coalesced_window_ms: windowMs,\n    coalesced_suppression_reason: payload.suppressionReason,\n  };\n}\n\nexport class PosthogCaptureGate {\n  private readonly config: CaptureGateConfig;\n  private readonly globalWindow: TimestampWindow = { timestamps: [] };\n  private readonly eventWindows = new Map<string, TimestampWindow>();\n  private readonly activeDedupe = new Map<string, ActiveDedupe>();\n  private readonly coalesceBuckets = new Map<string, CoalesceBucket>();\n  private emittedTotal = 0;\n  private coalescedTotal = 0;\n  private flushedCoalescedTotal = 0;\n\n  constructor(config: CaptureGateConfig = DEFAULT_CAPTURE_GATE_CONFIG) {\n    this.config = config;\n  }\n\n  resetForTests(): void {\n    this.globalWindow.timestamps.length = 0;\n    this.eventWindows.clear();\n    this.activeDedupe.clear();\n    this.coalesceBuckets.clear();\n    this.emittedTotal = 0;\n    this.coalescedTotal = 0;\n    this.flushedCoalescedTotal = 0;\n  }\n\n  getSnapshot(): CaptureGateSnapshot {\n    const coalescedPendingByEvent: Record<string, number> = {};\n    let coalescedPending = 0;\n    for (const bucket of this.coalesceBuckets.values()) {\n      coalescedPending += bucket.count;\n      coalescedPendingByEvent[bucket.event] =\n        (coalescedPendingByEvent[bucket.event] ?? 0) + bucket.count;\n    }\n    return {\n      coalescedPending,\n      coalescedPendingByEvent,\n      emittedTotal: this.emittedTotal,\n      coalescedTotal: this.coalescedTotal,\n      flushedCoalescedTotal: this.flushedCoalescedTotal,\n    };\n  }\n\n  evaluateCapture(\n    event: string,\n    properties?: Properties,\n    options?: CaptureOptions,\n    now: number = Date.now()\n  ): CaptureGateOutcome {\n    if (shouldBypassCaptureGate(options)) {\n      return { action: 'emit' };\n    }\n\n    const fingerprint = buildCaptureFingerprint(event, properties);\n    const bucketKey = fingerprint;\n\n    const override = this.config.eventOverrides[event];\n    const dedupeWindowMs = override?.dedupeWindowMs ?? this.config.defaultDedupeWindowMs;\n    const lastDedupe = this.activeDedupe.get(event);\n    if (\n      lastDedupe &&\n      lastDedupe.fingerprint === fingerprint &&\n      now - lastDedupe.at < dedupeWindowMs\n    ) {\n      return this.recordCoalesce(event, bucketKey, fingerprint, properties, 'dedupe', now);\n    }\n\n    const critical = isCriticalPosthogEvent(event);\n    const globalCount = countInWindow(this.globalWindow, now, this.config.globalWindowMs);\n    const normalBudget = Math.max(\n      0,\n      this.config.globalMaxPerWindow - this.config.criticalReservePerWindow\n    );\n\n    if (critical) {\n      if (globalCount >= this.config.globalMaxPerWindow) {\n        return this.recordCoalesce(event, bucketKey, fingerprint, properties, 'global_budget', now);\n      }\n    } else if (globalCount >= normalBudget) {\n      return this.recordCoalesce(event, bucketKey, fingerprint, properties, 'global_budget', now);\n    }\n\n    const eventWindow = this.eventWindows.get(event) ?? { timestamps: [] };\n    this.eventWindows.set(event, eventWindow);\n    const eventMax = override?.maxPerWindow ?? this.config.defaultEventMaxPerWindow;\n    const eventWindowMs = override?.windowMs ?? this.config.defaultEventWindowMs;\n    const eventCount = countInWindow(eventWindow, now, eventWindowMs);\n    if (eventCount >= eventMax) {\n      return this.recordCoalesce(event, bucketKey, fingerprint, properties, 'event_budget', now);\n    }\n\n    recordInWindow(this.globalWindow, now);\n    recordInWindow(eventWindow, now);\n    this.activeDedupe.set(event, { fingerprint, bucketKey, at: now });\n    this.emittedTotal += 1;\n\n    return { action: 'emit' };\n  }\n\n  /** Returns payloads ready to flush (does not mutate buckets until caller confirms). */\n  collectFlushCandidates(now: number = Date.now()): CoalescedCapturePayload[] {\n    const payloads: CoalescedCapturePayload[] = [];\n\n    for (const bucket of this.coalesceBuckets.values()) {\n      const shouldFlushBySize = bucket.count >= this.config.flushCoalesceThreshold;\n      const shouldFlushByAge = now - bucket.firstAt >= this.config.flushIntervalMs;\n      if (!shouldFlushBySize && !shouldFlushByAge) {\n        continue;\n      }\n\n      payloads.push({\n        bucketKey: bucket.bucketKey,\n        event: bucket.event,\n        properties: bucket.sampleProperties,\n        coalescedCount: bucket.count,\n        firstAt: bucket.firstAt,\n        lastAt: bucket.lastAt,\n        suppressionReason: bucket.suppressionReason,\n      });\n    }\n\n    return payloads;\n  }\n\n  /** Remove flushed bucket keys after successful emit. */\n  acknowledgeFlushed(payloads: CoalescedCapturePayload[]): void {\n    for (const payload of payloads) {\n      this.coalesceBuckets.delete(payload.bucketKey);\n      this.flushedCoalescedTotal += payload.coalescedCount;\n    }\n  }\n\n  /** After coalescing, flush immediately if the bucket crossed the early threshold. */\n  takeBucketIfReady(bucketKey: string, now: number = Date.now()): CoalescedCapturePayload | null {\n    const bucket = this.coalesceBuckets.get(bucketKey);\n    if (!bucket) return null;\n\n    const shouldFlushBySize = bucket.count >= this.config.flushCoalesceThreshold;\n    const shouldFlushByAge = now - bucket.firstAt >= this.config.flushIntervalMs;\n    if (!shouldFlushBySize && !shouldFlushByAge) {\n      return null;\n    }\n\n    this.coalesceBuckets.delete(bucketKey);\n    this.flushedCoalescedTotal += bucket.count;\n\n    return {\n      bucketKey: bucket.bucketKey,\n      event: bucket.event,\n      properties: bucket.sampleProperties,\n      coalescedCount: bucket.count,\n      firstAt: bucket.firstAt,\n      lastAt: bucket.lastAt,\n      suppressionReason: bucket.suppressionReason,\n    };\n  }\n\n  /** Force-flush every pending bucket (e.g. page hide). */\n  collectAllPending(): CoalescedCapturePayload[] {\n    return [...this.coalesceBuckets.values()].map((bucket) => ({\n      bucketKey: bucket.bucketKey,\n      event: bucket.event,\n      properties: bucket.sampleProperties,\n      coalescedCount: bucket.count,\n      firstAt: bucket.firstAt,\n      lastAt: bucket.lastAt,\n      suppressionReason: bucket.suppressionReason,\n    }));\n  }\n\n  private recordCoalesce(\n    event: string,\n    bucketKey: string,\n    fingerprint: string,\n    properties: Properties | undefined,\n    reason: CaptureGateSuppressReason,\n    now: number\n  ): CaptureGateOutcome {\n    const existing = this.coalesceBuckets.get(bucketKey);\n    if (existing) {\n      existing.count += 1;\n      existing.lastAt = now;\n      existing.sampleProperties = { ...existing.sampleProperties, ...(properties ?? {}) };\n    } else {\n      this.coalesceBuckets.set(bucketKey, {\n        event,\n        bucketKey,\n        fingerprint,\n        count: 1,\n        firstAt: now,\n        lastAt: now,\n        suppressionReason: reason,\n        sampleProperties: { ...(properties ?? {}) },\n      });\n    }\n\n    this.coalescedTotal += 1;\n    this.activeDedupe.set(event, { fingerprint, bucketKey, at: now });\n\n    return { action: 'coalesce', reason, bucketKey };\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/lib/posthog/capture-gate.js

@@ -0,0 +1,322 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+const DEFAULT_CAPTURE_GATE_CONFIG = {
+  globalMaxPerWindow: 50,
+  globalWindowMs: 1e4,
+  criticalReservePerWindow: 15,
+  defaultEventMaxPerWindow: 12,
+  defaultEventWindowMs: 6e4,
+  defaultDedupeWindowMs: 5e3,
+  flushIntervalMs: 3e4,
+  flushCoalesceThreshold: 20,
+  eventOverrides: {
+    memory_profile_sample: { maxPerWindow: 2, windowMs: 3e4, dedupeWindowMs: 15e3 },
+    long_task_detected: { maxPerWindow: 3, windowMs: 6e4, dedupeWindowMs: 1e4 },
+    collab_connection_status_changed: { maxPerWindow: 6, windowMs: 6e4 },
+    collab_first_remote_update: { maxPerWindow: 3, windowMs: 6e4 },
+    collab_first_local_update: { maxPerWindow: 3, windowMs: 6e4 },
+    collab_render_time_sync_fix: { maxPerWindow: 3, windowMs: 6e4 },
+    collab_visibility_recovery: { maxPerWindow: 4, windowMs: 6e4 },
+    langgraph_message_validation_error: {
+      maxPerWindow: 8,
+      windowMs: 6e4,
+      dedupeWindowMs: 15e3
+    },
+    langgraph_messages_validation_error: {
+      maxPerWindow: 5,
+      windowMs: 6e4,
+      dedupeWindowMs: 15e3
+    },
+    langgraph_interrupt_validation_error: {
+      maxPerWindow: 5,
+      windowMs: 6e4,
+      dedupeWindowMs: 15e3
+    },
+    langgraph_state_validation_error: {
+      maxPerWindow: 5,
+      windowMs: 6e4,
+      dedupeWindowMs: 15e3
+    },
+    graphql_error: { maxPerWindow: 12, windowMs: 6e4, dedupeWindowMs: 1e4 },
+    chat_error: { maxPerWindow: 8, windowMs: 6e4, dedupeWindowMs: 5e3 },
+    memory_critical_threshold: { maxPerWindow: 3, windowMs: 3e5 },
+    memory_warning_threshold: { maxPerWindow: 3, windowMs: 3e5 },
+    pptx_slide_changed: { maxPerWindow: 8, windowMs: 3e4 }
+  }
+};
+const CRITICAL_EVENT_PATTERNS = [
+  /(?:^|_)failed$/,
+  /(?:^|_)error(?:_|$)/,
+  /crash/,
+  /^oom_/,
+  /aw_snap/,
+  /chunk_load/,
+  /global_error/,
+  /\$exception$/,
+  /^404_error$/,
+  /^500_error$/,
+  /_boundary_/
+];
+const BYPASS_OPTION_KEY = "__posthog_gate_bypass";
+function isCriticalPosthogEvent(event) {
+  return CRITICAL_EVENT_PATTERNS.some((pattern) => pattern.test(event));
+}
+function shouldBypassCaptureGate(options) {
+  if (!options || typeof options !== "object") return false;
+  return options[BYPASS_OPTION_KEY] === true;
+}
+function withCaptureGateBypass(options) {
+  return {
+    ...options ?? {},
+    [BYPASS_OPTION_KEY]: true
+  };
+}
+function pruneWindow(window, now, windowMs) {
+  const cutoff = now - windowMs;
+  while (window.timestamps.length > 0 && window.timestamps[0] < cutoff) {
+    window.timestamps.shift();
+  }
+}
+function countInWindow(window, now, windowMs) {
+  pruneWindow(window, now, windowMs);
+  return window.timestamps.length;
+}
+function recordInWindow(window, now) {
+  window.timestamps.push(now);
+}
+function stableStringify(value) {
+  if (value == null) return String(value);
+  if (typeof value !== "object") return String(value);
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+  }
+  const record = value;
+  const keys = Object.keys(record).sort();
+  return `{${keys.map((key) => `${key}:${stableStringify(record[key])}`).join(",")}}`;
+}
+function fingerprintProperties(properties) {
+  if (!properties) return "";
+  const keys = [
+    "error",
+    "error_message",
+    "message",
+    "reason",
+    "status",
+    "code",
+    "asset_id",
+    "doc_id",
+    "thread_id",
+    "session_id",
+    "operation",
+    "path",
+    "url",
+    "chunk_identifier",
+    "validation_path",
+    "$exception_type",
+    "$exception_message"
+  ];
+  const subset = {};
+  for (const key of keys) {
+    if (key in properties) {
+      subset[key] = properties[key];
+    }
+  }
+  const primaryException = primaryExceptionEntry(properties.$exception_list);
+  if (primaryException) {
+    subset.$exception_type = primaryException.type;
+    subset.$exception_message = primaryException.value;
+  }
+  return stableStringify(subset);
+}
+function primaryExceptionEntry(exceptionList) {
+  if (!Array.isArray(exceptionList)) return void 0;
+  const first = exceptionList[0];
+  if (first === null || typeof first !== "object") return void 0;
+  const { type, value } = first;
+  return { type, value };
+}
+function buildCaptureFingerprint(event, properties) {
+  return `${event}|${fingerprintProperties(properties)}`;
+}
+function buildCoalescedCaptureProperties(payload) {
+  const windowMs = payload.lastAt - payload.firstAt;
+  return {
+    ...payload.properties,
+    coalesced: true,
+    coalesced_count: payload.coalescedCount,
+    coalesced_first_at: new Date(payload.firstAt).toISOString(),
+    coalesced_last_at: new Date(payload.lastAt).toISOString(),
+    coalesced_window_ms: windowMs,
+    coalesced_suppression_reason: payload.suppressionReason
+  };
+}
+class PosthogCaptureGate {
+  constructor(config = DEFAULT_CAPTURE_GATE_CONFIG) {
+    __publicField(this, "config");
+    __publicField(this, "globalWindow", { timestamps: [] });
+    __publicField(this, "eventWindows", /* @__PURE__ */ new Map());
+    __publicField(this, "activeDedupe", /* @__PURE__ */ new Map());
+    __publicField(this, "coalesceBuckets", /* @__PURE__ */ new Map());
+    __publicField(this, "emittedTotal", 0);
+    __publicField(this, "coalescedTotal", 0);
+    __publicField(this, "flushedCoalescedTotal", 0);
+    this.config = config;
+  }
+  resetForTests() {
+    this.globalWindow.timestamps.length = 0;
+    this.eventWindows.clear();
+    this.activeDedupe.clear();
+    this.coalesceBuckets.clear();
+    this.emittedTotal = 0;
+    this.coalescedTotal = 0;
+    this.flushedCoalescedTotal = 0;
+  }
+  getSnapshot() {
+    const coalescedPendingByEvent = {};
+    let coalescedPending = 0;
+    for (const bucket of this.coalesceBuckets.values()) {
+      coalescedPending += bucket.count;
+      coalescedPendingByEvent[bucket.event] = (coalescedPendingByEvent[bucket.event] ?? 0) + bucket.count;
+    }
+    return {
+      coalescedPending,
+      coalescedPendingByEvent,
+      emittedTotal: this.emittedTotal,
+      coalescedTotal: this.coalescedTotal,
+      flushedCoalescedTotal: this.flushedCoalescedTotal
+    };
+  }
+  evaluateCapture(event, properties, options, now = Date.now()) {
+    if (shouldBypassCaptureGate(options)) {
+      return { action: "emit" };
+    }
+    const fingerprint = buildCaptureFingerprint(event, properties);
+    const bucketKey = fingerprint;
+    const override = this.config.eventOverrides[event];
+    const dedupeWindowMs = (override == null ? void 0 : override.dedupeWindowMs) ?? this.config.defaultDedupeWindowMs;
+    const lastDedupe = this.activeDedupe.get(event);
+    if (lastDedupe && lastDedupe.fingerprint === fingerprint && now - lastDedupe.at < dedupeWindowMs) {
+      return this.recordCoalesce(event, bucketKey, fingerprint, properties, "dedupe", now);
+    }
+    const critical = isCriticalPosthogEvent(event);
+    const globalCount = countInWindow(this.globalWindow, now, this.config.globalWindowMs);
+    const normalBudget = Math.max(
+      0,
+      this.config.globalMaxPerWindow - this.config.criticalReservePerWindow
+    );
+    if (critical) {
+      if (globalCount >= this.config.globalMaxPerWindow) {
+        return this.recordCoalesce(event, bucketKey, fingerprint, properties, "global_budget", now);
+      }
+    } else if (globalCount >= normalBudget) {
+      return this.recordCoalesce(event, bucketKey, fingerprint, properties, "global_budget", now);
+    }
+    const eventWindow = this.eventWindows.get(event) ?? { timestamps: [] };
+    this.eventWindows.set(event, eventWindow);
+    const eventMax = (override == null ? void 0 : override.maxPerWindow) ?? this.config.defaultEventMaxPerWindow;
+    const eventWindowMs = (override == null ? void 0 : override.windowMs) ?? this.config.defaultEventWindowMs;
+    const eventCount = countInWindow(eventWindow, now, eventWindowMs);
+    if (eventCount >= eventMax) {
+      return this.recordCoalesce(event, bucketKey, fingerprint, properties, "event_budget", now);
+    }
+    recordInWindow(this.globalWindow, now);
+    recordInWindow(eventWindow, now);
+    this.activeDedupe.set(event, { fingerprint, bucketKey, at: now });
+    this.emittedTotal += 1;
+    return { action: "emit" };
+  }
+  /** Returns payloads ready to flush (does not mutate buckets until caller confirms). */
+  collectFlushCandidates(now = Date.now()) {
+    const payloads = [];
+    for (const bucket of this.coalesceBuckets.values()) {
+      const shouldFlushBySize = bucket.count >= this.config.flushCoalesceThreshold;
+      const shouldFlushByAge = now - bucket.firstAt >= this.config.flushIntervalMs;
+      if (!shouldFlushBySize && !shouldFlushByAge) {
+        continue;
+      }
+      payloads.push({
+        bucketKey: bucket.bucketKey,
+        event: bucket.event,
+        properties: bucket.sampleProperties,
+        coalescedCount: bucket.count,
+        firstAt: bucket.firstAt,
+        lastAt: bucket.lastAt,
+        suppressionReason: bucket.suppressionReason
+      });
+    }
+    return payloads;
+  }
+  /** Remove flushed bucket keys after successful emit. */
+  acknowledgeFlushed(payloads) {
+    for (const payload of payloads) {
+      this.coalesceBuckets.delete(payload.bucketKey);
+      this.flushedCoalescedTotal += payload.coalescedCount;
+    }
+  }
+  /** After coalescing, flush immediately if the bucket crossed the early threshold. */
+  takeBucketIfReady(bucketKey, now = Date.now()) {
+    const bucket = this.coalesceBuckets.get(bucketKey);
+    if (!bucket) return null;
+    const shouldFlushBySize = bucket.count >= this.config.flushCoalesceThreshold;
+    const shouldFlushByAge = now - bucket.firstAt >= this.config.flushIntervalMs;
+    if (!shouldFlushBySize && !shouldFlushByAge) {
+      return null;
+    }
+    this.coalesceBuckets.delete(bucketKey);
+    this.flushedCoalescedTotal += bucket.count;
+    return {
+      bucketKey: bucket.bucketKey,
+      event: bucket.event,
+      properties: bucket.sampleProperties,
+      coalescedCount: bucket.count,
+      firstAt: bucket.firstAt,
+      lastAt: bucket.lastAt,
+      suppressionReason: bucket.suppressionReason
+    };
+  }
+  /** Force-flush every pending bucket (e.g. page hide). */
+  collectAllPending() {
+    return [...this.coalesceBuckets.values()].map((bucket) => ({
+      bucketKey: bucket.bucketKey,
+      event: bucket.event,
+      properties: bucket.sampleProperties,
+      coalescedCount: bucket.count,
+      firstAt: bucket.firstAt,
+      lastAt: bucket.lastAt,
+      suppressionReason: bucket.suppressionReason
+    }));
+  }
+  recordCoalesce(event, bucketKey, fingerprint, properties, reason, now) {
+    const existing = this.coalesceBuckets.get(bucketKey);
+    if (existing) {
+      existing.count += 1;
+      existing.lastAt = now;
+      existing.sampleProperties = { ...existing.sampleProperties, ...properties ?? {} };
+    } else {
+      this.coalesceBuckets.set(bucketKey, {
+        event,
+        bucketKey,
+        fingerprint,
+        count: 1,
+        firstAt: now,
+        lastAt: now,
+        suppressionReason: reason,
+        sampleProperties: { ...properties ?? {} }
+      });
+    }
+    this.coalescedTotal += 1;
+    this.activeDedupe.set(event, { fingerprint, bucketKey, at: now });
+    return { action: "coalesce", reason, bucketKey };
+  }
+}
+export {
+  DEFAULT_CAPTURE_GATE_CONFIG,
+  PosthogCaptureGate,
+  buildCaptureFingerprint,
+  buildCoalescedCaptureProperties,
+  isCriticalPosthogEvent,
+  shouldBypassCaptureGate,
+  withCaptureGateBypass
+};
+//# sourceMappingURL=capture-gate.js.map