@emit-vision/sdk-js 0.1.0 → 0.3.0

package/dist/index.js

@@ -1,462 +1,774 @@
-const SDK_NAME = "emit-vision-js";
-const SDK_VERSION = "0.1.0";
-class EmitVisionClient {
-    options;
-    queue = [];
-    user;
-    context = {};
-    deployment;
-    featureFlags = {};
-    tags = {};
-    timer;
-    flushScheduled = false;
-    fetchImpl;
-    flagCache = new Map();
-    constructor(options) {
-        this.options = options;
-        this.fetchImpl = options.fetchImpl;
-        this.deployment = options.deployment
-            ? { ...options.deployment }
-            : undefined;
-        this.featureFlags = options.featureFlags ? { ...options.featureFlags } : {};
-        this.timer = setInterval(() => {
-            if (this.queue.length === 0) {
-                return;
-            }
-            this.flush().catch((err) => this.debug("background flush error", { error: err }));
-        }, options.flushIntervalMs);
-        if (options.autoCapture.errors && typeof window !== "undefined") {
-            window.addEventListener("error", this.handleWindowError);
-        }
-        if (options.autoCapture.unhandledRejections &&
-            typeof window !== "undefined") {
-            window.addEventListener("unhandledrejection", this.handleUnhandledRejection);
+// src/retry.ts
+var FlushRetryController = class {
+  constructor(opts) {
+    this.opts = opts;
+  }
+  opts;
+  consecutiveFailures = 0;
+  backoffUntil = 0;
+  disabled = false;
+  isDisabled() {
+    return this.disabled;
+  }
+  isBackingOff(now = Date.now()) {
+    return !this.disabled && now < this.backoffUntil;
+  }
+  msUntilReady(now = Date.now()) {
+    if (this.disabled) return Infinity;
+    return Math.max(0, this.backoffUntil - now);
+  }
+  reset() {
+    this.consecutiveFailures = 0;
+    this.backoffUntil = 0;
+  }
+  recordFailure(now = Date.now()) {
+    this.consecutiveFailures += 1;
+    if (this.opts.failureCap > 0 && this.consecutiveFailures >= this.opts.failureCap) {
+      const wasDisabled = this.disabled;
+      this.disabled = true;
+      this.backoffUntil = 0;
+      return {
+        backoffMs: 0,
+        consecutiveFailures: this.consecutiveFailures,
+        justDisabled: !wasDisabled
+      };
+    }
+    if (this.opts.initialMs <= 0) {
+      this.backoffUntil = 0;
+      return {
+        backoffMs: 0,
+        consecutiveFailures: this.consecutiveFailures,
+        justDisabled: false
+      };
+    }
+    const exp = Math.min(
+      this.opts.initialMs * Math.pow(2, this.consecutiveFailures - 1),
+      this.opts.maxMs
+    );
+    const jitter = exp * 0.2 * (Math.random() * 2 - 1);
+    const backoffMs = Math.max(0, Math.floor(exp + jitter));
+    this.backoffUntil = now + backoffMs;
+    return {
+      backoffMs,
+      consecutiveFailures: this.consecutiveFailures,
+      justDisabled: false
+    };
+  }
+};
+
+// src/flag-eval.ts
+var FlagEvaluator = class {
+  constructor(cfg, onFlagsLoaded, captureExposure2, debug) {
+    this.cfg = cfg;
+    this.onFlagsLoaded = onFlagsLoaded;
+    this.captureExposure = captureExposure2;
+    this.debug = debug;
+  }
+  cfg;
+  onFlagsLoaded;
+  captureExposure;
+  debug;
+  cache = /* @__PURE__ */ new Map();
+  async evaluateFlags(opts) {
+    const env = opts.environment ?? "";
+    const ttl = opts.ttlMs ?? this.cfg.ttlMs;
+    const key = `${env}:${opts.evaluationKey}`;
+    const cached = this.cache.get(key);
+    if (cached && Date.now() < cached.expiresAt) {
+      this.debug("flag eval cache hit", { key });
+      return cached.flags;
+    }
+    return this.fetchAndCacheFlags(opts, env, ttl, key);
+  }
+  async getFlag(flagKey, fallback, opts) {
+    try {
+      const flags = await this.evaluateFlags(opts);
+      const value = flags[flagKey];
+      return value !== void 0 ? value : fallback;
+    } catch {
+      return fallback;
+    }
+  }
+  async refreshFlags(opts) {
+    const env = opts.environment ?? "";
+    const ttl = opts.ttlMs ?? this.cfg.ttlMs;
+    const key = `${env}:${opts.evaluationKey}`;
+    this.cache.delete(key);
+    return this.fetchAndCacheFlags(opts, env, ttl, key);
+  }
+  async fetchAndCacheFlags(opts, env, ttl, cacheKey) {
+    let flags = {};
+    let evaluations = {};
+    try {
+      const body = {
+        environment: env,
+        userKey: opts.evaluationKey
+      };
+      if (opts.flagKeys && opts.flagKeys.length > 0) {
+        body.flagKeys = opts.flagKeys;
+      }
+      const response = await this.cfg.fetchImpl(
+        `${this.cfg.endpoint}/v1/flags/evaluate`,
+        {
+          method: "POST",
+          headers: {
+            "content-type": "application/json",
+            "x-emit-api-key": this.cfg.apiKey
+          },
+          body: JSON.stringify(body)
         }
-        this.debug("initialized", {
-            endpoint: options.endpoint,
-            environment: options.environment,
-            release: options.release,
-            autoCapture: options.autoCapture,
-            batchSize: options.batchSize,
-            flushIntervalMs: options.flushIntervalMs,
-            flushOnCapture: options.flushOnCapture,
-        });
+      );
+      if (response.ok) {
+        const data = await response.json();
+        evaluations = data.evaluations;
+        flags = Object.fromEntries(
+          Object.entries(evaluations).map(([k, v]) => [k, v.variantValue])
+        );
+        this.debug("flag eval complete", { count: Object.keys(flags).length });
+      } else {
+        this.debug("flag eval response error", { status: response.status });
+      }
+    } catch (err) {
+      this.debug("flag eval network error", { error: err });
     }
-    captureEvent(name, properties, options = {}) {
-        this.debug("queue event", { name, properties, options });
-        this.enqueue({
-            type: "event",
-            name,
-            properties,
-            ...this.withDefaults(options),
-        });
+    this.cache.set(cacheKey, { flags, expiresAt: Date.now() + ttl });
+    this.onFlagsLoaded(flags);
+    if (this.cfg.flagExposures) {
+      for (const [flagKey, entry] of Object.entries(evaluations)) {
+        this.captureExposure(
+          flagKey,
+          entry.variantKey,
+          entry.variantValue,
+          entry.reason,
+          env
+        );
+      }
     }
-    captureError(error, options = {}) {
-        const serialized = serializeError(error);
-        this.debug("queue error", {
-            message: serialized.message,
-            handled: serialized.handled,
-            options,
-        });
-        this.enqueue({
-            type: "error",
-            name: "error",
-            error: serialized,
-            ...this.withDefaults(options),
-        });
+    return flags;
+  }
+};
+
+// src/util.ts
+function parseDsn(dsn) {
+  const parsed = new URL(dsn);
+  const apiKey = decodeURIComponent(parsed.username);
+  if (!apiKey) {
+    throw new Error("emit-vision dsn must include the API key before the @");
+  }
+  const pathname = stripTrailingSlash(parsed.pathname) ?? "";
+  const endpointPath = pathname.endsWith("/v1") ? pathname.slice(0, -"/v1".length) : pathname;
+  return {
+    apiKey,
+    endpoint: stripTrailingSlash(`${parsed.origin}${endpointPath}`)
+  };
+}
+function stripTrailingSlash(value) {
+  if (!value) {
+    return value;
+  }
+  return value.endsWith("/") ? value.slice(0, -1) : value;
+}
+function serializeError(error) {
+  if (error instanceof Error) {
+    return {
+      message: error.message,
+      name: error.name,
+      stack: error.stack,
+      handled: true
+    };
+  }
+  return {
+    message: typeof error === "string" ? error : JSON.stringify(error),
+    handled: true
+  };
+}
+function resolveTransport(options) {
+  const dsn = options.dsn ? parseDsn(options.dsn) : null;
+  const apiKey = options.apiKey ?? dsn?.apiKey;
+  if (!apiKey) {
+    throw new Error("emit-vision init requires either apiKey or dsn");
+  }
+  return {
+    apiKey,
+    endpoint: stripTrailingSlash(options.endpoint ?? dsn?.endpoint)
+  };
+}
+var ANON_ID_KEY = "__ev_anon_id";
+function getOrCreateAnonymousId() {
+  try {
+    const stored = localStorage.getItem(ANON_ID_KEY);
+    if (stored) return stored;
+    const id = crypto.randomUUID();
+    localStorage.setItem(ANON_ID_KEY, id);
+    return id;
+  } catch {
+    return void 0;
+  }
+}
+function resolveAutoCapture(options) {
+  const legacyDefault = options.autoCaptureErrors === void 0 ? true : options.autoCaptureErrors;
+  return {
+    errors: options.autoCapture?.errors ?? legacyDefault,
+    unhandledRejections: options.autoCapture?.unhandledRejections ?? legacyDefault,
+    flagExposures: options.autoCapture?.flagExposures ?? true,
+    pageViews: options.autoCapture?.pageViews ?? false
+  };
+}
+
+// src/client.ts
+var SDK_NAME = "emit-vision-js";
+var SDK_VERSION = "0.3.0";
+var MAX_EVENT_BYTES = 64 * 1024;
+var MAX_BATCH_BYTES = 1 * 1024 * 1024;
+function byteLength(s) {
+  return new TextEncoder().encode(s).length;
+}
+function trimEventIfOversized(payload) {
+  const json = JSON.stringify(payload);
+  const originalBytes = byteLength(json);
+  if (originalBytes <= MAX_EVENT_BYTES) {
+    return { payload, trimmedFields: null, originalBytes };
+  }
+  const propBytes = payload.properties ? byteLength(JSON.stringify(payload.properties)) : 0;
+  const ctxBytes = payload.context ? byteLength(JSON.stringify(payload.context)) : 0;
+  if (typeof console.warn === "function") {
+    console.warn(
+      `[emit-vision] event truncated \u2014 "${payload.name}" was ${originalBytes} bytes (max ${MAX_EVENT_BYTES}); properties/context trimmed.`
+    );
+  }
+  const trimmedFields = [];
+  if (propBytes > 0) trimmedFields.push("properties");
+  if (ctxBytes > 0) trimmedFields.push("context");
+  if (payload.type === "error" && payload.error.stack) {
+    trimmedFields.push("error.stack");
+  }
+  const base = {
+    properties: propBytes > 0 ? { _truncated: true, _originalBytes: propBytes } : void 0,
+    context: ctxBytes > 0 ? { _truncated: true, _originalBytes: ctxBytes } : void 0
+  };
+  if (payload.type === "error") {
+    return {
+      payload: { ...payload, ...base, error: { ...payload.error, stack: void 0 } },
+      trimmedFields,
+      originalBytes
+    };
+  }
+  return { payload: { ...payload, ...base }, trimmedFields, originalBytes };
+}
+function buildBatchBody(chunk) {
+  return JSON.stringify({
+    events: chunk.map((item) => ({
+      ...item,
+      sdk: { name: SDK_NAME, version: SDK_VERSION }
+    }))
+  });
+}
+function splitBatch(batch) {
+  if (batch.length <= 1) return [batch];
+  const body = buildBatchBody(batch);
+  if (byteLength(body) <= MAX_BATCH_BYTES) return [batch];
+  const mid = Math.floor(batch.length / 2);
+  return [...splitBatch(batch.slice(0, mid)), ...splitBatch(batch.slice(mid))];
+}
+var EmitVisionClient = class {
+  constructor(options) {
+    this.options = options;
+    this.fetchImpl = options.fetchImpl;
+    this.deployment = options.deployment ? { ...options.deployment } : void 0;
+    this.featureFlags = options.featureFlags ? { ...options.featureFlags } : {};
+    this.retry = new FlushRetryController({
+      initialMs: options.retryBackoffInitialMs,
+      maxMs: options.retryBackoffMaxMs,
+      failureCap: options.maxConsecutiveFlushFailures
+    });
+    this.flagEval = new FlagEvaluator(
+      {
+        endpoint: options.endpoint,
+        apiKey: options.apiKey,
+        ttlMs: options.flagEvalTtlMs,
+        flagExposures: options.autoCapture.flagExposures,
+        fetchImpl: options.fetchImpl
+      },
+      (flags) => {
+        this.featureFlags = { ...this.featureFlags, ...flags };
+      },
+      (flagKey, variantKey, variantValue, reason, env) => this.captureExposure(flagKey, variantKey, variantValue, reason, env),
+      (msg, data) => this.debug(msg, data)
+    );
+    this.timer = setInterval(() => {
+      if (this.queue.length === 0 || this.retry.isBackingOff()) {
+        return;
+      }
+      this.flush().catch(
+        (err) => this.debug("background flush error", { error: err })
+      );
+    }, options.flushIntervalMs);
+    if (options.autoCapture.errors && typeof window !== "undefined") {
+      window.addEventListener("error", this.handleWindowError);
     }
-    identify(userIdOrUser, traits = {}) {
-        this.user =
-            typeof userIdOrUser === "string"
-                ? { id: userIdOrUser, ...traits }
-                : { ...userIdOrUser };
-        this.debug("identified user", this.user);
+    if (options.autoCapture.unhandledRejections && typeof window !== "undefined") {
+      window.addEventListener(
+        "unhandledrejection",
+        this.handleUnhandledRejection
+      );
     }
-    setContext(context) {
-        this.context = { ...this.context, ...context };
-        this.debug("updated context", this.context);
+    if (options.autoCapture.pageViews && typeof window !== "undefined") {
+      this.capturePageView();
+      window.addEventListener("popstate", this.handlePopState);
+      this.patchHistoryMethod("pushState");
+      this.patchHistoryMethod("replaceState");
     }
-    setDeploymentContext(context) {
-        this.deployment =
-            Object.keys(context).length > 0 ? { ...context } : undefined;
-        this.debug("updated deployment context", this.deployment);
+    this.debug("initialized", {
+      endpoint: options.endpoint,
+      environment: options.environment,
+      release: options.release,
+      autoCapture: options.autoCapture,
+      batchSize: options.batchSize,
+      flushIntervalMs: options.flushIntervalMs,
+      flushOnCapture: options.flushOnCapture
+    });
+  }
+  options;
+  queue = [];
+  user;
+  context = {};
+  deployment;
+  featureFlags = {};
+  tags = {};
+  timer;
+  flushScheduled = false;
+  fetchImpl;
+  flagEval;
+  retry;
+  captureEvent(name, properties, options = {}) {
+    this.debug("queue event", { name, properties, options });
+    this.enqueue({
+      type: "event",
+      name,
+      properties,
+      ...this.withDefaults(options)
+    });
+  }
+  captureError(error, options = {}) {
+    const serialized = serializeError(error);
+    this.debug("queue error", {
+      message: serialized.message,
+      handled: serialized.handled,
+      options
+    });
+    this.enqueue({
+      type: "error",
+      name: "error",
+      error: serialized,
+      ...this.withDefaults(options)
+    });
+  }
+  identify(userIdOrUser, traits = {}) {
+    this.user = typeof userIdOrUser === "string" ? { id: userIdOrUser, ...traits } : { ...userIdOrUser };
+    this.debug("identified user", this.user);
+  }
+  setContext(context) {
+    this.context = { ...this.context, ...context };
+    this.debug("updated context", this.context);
+  }
+  setDeploymentContext(context) {
+    this.deployment = Object.keys(context).length > 0 ? { ...context } : void 0;
+    this.debug("updated deployment context", this.deployment);
+  }
+  setFeatureFlags(featureFlags) {
+    this.featureFlags = { ...featureFlags };
+    this.debug("updated feature flags", this.featureFlags);
+  }
+  evaluateFlags(opts) {
+    return this.flagEval.evaluateFlags({
+      ...opts,
+      environment: opts.environment ?? this.options.environment
+    });
+  }
+  getFlag(flagKey, fallback, opts) {
+    return this.flagEval.getFlag(flagKey, fallback, {
+      ...opts,
+      environment: opts.environment ?? this.options.environment
+    });
+  }
+  refreshFlags(opts) {
+    return this.flagEval.refreshFlags({
+      ...opts,
+      environment: opts.environment ?? this.options.environment
+    });
+  }
+  capturePageView(path) {
+    const page = path ?? (typeof window !== "undefined" ? window.location.pathname : void 0);
+    if (!page) return;
+    this.captureEvent("$page_view", { page });
+  }
+  captureExposure(flagKey, variantKey, variantValue, reason, environment) {
+    this.captureEvent("$flag_exposure", {
+      flagKey,
+      variantKey,
+      ...variantValue !== void 0 ? { variantValue } : {},
+      ...reason ? { reason } : {},
+      environment: environment ?? this.options.environment
+    });
+  }
+  setTags(tags) {
+    this.tags = { ...this.tags, ...tags };
+    this.debug("updated tags", this.tags);
+  }
+  async flush() {
+    if (this.retry.isDisabled()) {
+      return;
     }
-    setFeatureFlags(featureFlags) {
-        this.featureFlags = { ...featureFlags };
-        this.debug("updated feature flags", this.featureFlags);
+    const batch = this.queue.splice(0, this.options.batchSize);
+    if (batch.length === 0) {
+      return;
     }
-    /**
-     * Fetch and evaluate all active flags for the given evaluation key.
-     * Results are cached for `ttlMs` (defaults to `flagEvalTtlMs` from init options).
-     * On network failure returns an empty object and does not throw.
-     * Evaluated variants are automatically merged into the SDK's feature-flag context.
-     */
-    async evaluateFlags(opts) {
-        const env = opts.environment ?? this.options.environment ?? "";
-        const ttl = opts.ttlMs ?? this.options.flagEvalTtlMs;
-        const key = `${env}:${opts.evaluationKey}`;
-        const cached = this.flagCache.get(key);
-        if (cached && Date.now() < cached.expiresAt) {
-            this.debug("flag eval cache hit", { key });
-            return cached.flags;
+    this.debug("flushing batch", { count: batch.length });
+    const chunks = splitBatch(batch);
+    for (let i = 0; i < chunks.length; i++) {
+      try {
+        await this.flushChunk(chunks[i]);
+      } catch (err) {
+        if (!this.retry.isDisabled()) {
+          const tail = chunks.slice(i + 1).flat();
+          if (tail.length > 0) {
+            this.queue.splice(chunks[i].length, 0, ...tail);
+          }
         }
-        return this.fetchAndCacheFlags(opts, env, ttl, key);
+        throw err;
+      }
     }
-    /**
-     * Return a single flag's value, evaluated for the given key.
-     * Returns `fallback` on network failure or when the flag is not found — never throws.
-     */
-    async getFlag(flagKey, fallback, opts) {
-        try {
-            const flags = await this.evaluateFlags(opts);
-            const value = flags[flagKey];
-            return (value !== undefined ? value : fallback);
-        }
-        catch {
-            return fallback;
-        }
+    if (this.options.flushOnCapture && this.queue.length > 0) {
+      this.scheduleFlush();
     }
-    /**
-     * Bypass the cache and re-fetch evaluations for the given key.
-     * Useful after a flag change in the dashboard that should apply immediately.
-     */
-    async refreshFlags(opts) {
-        const env = opts.environment ?? this.options.environment ?? "";
-        const ttl = opts.ttlMs ?? this.options.flagEvalTtlMs;
-        const key = `${env}:${opts.evaluationKey}`;
-        this.flagCache.delete(key);
-        return this.fetchAndCacheFlags(opts, env, ttl, key);
+  }
+  async flushChunk(chunk) {
+    let response;
+    try {
+      response = await this.fetchImpl(`${this.options.endpoint}/v1/batch`, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          "x-emit-api-key": this.options.apiKey
+        },
+        body: buildBatchBody(chunk),
+        keepalive: true
+      });
+    } catch (err) {
+      this.handleFlushFailure(chunk, { reason: "network", error: err });
+      throw err;
     }
-    captureExposure(flagKey, variantKey, variantValue, reason, environment) {
-        this.captureEvent("$flag_exposure", {
-            flagKey,
-            variantKey,
-            ...(variantValue !== undefined ? { variantValue } : {}),
-            ...(reason ? { reason } : {}),
-            environment: environment ?? this.options.environment,
-        });
+    if (!response.ok) {
+      const error = new Error(
+        `emit-vision flush failed with ${response.status}`
+      );
+      this.handleFlushFailure(chunk, {
+        reason: "status",
+        status: response.status
+      });
+      throw error;
     }
-    async fetchAndCacheFlags(opts, env, ttl, cacheKey) {
-        let flags = {};
-        let evaluations = {};
-        try {
-            const body = {
-                environment: env,
-                userKey: opts.evaluationKey,
-            };
-            if (opts.flagKeys && opts.flagKeys.length > 0) {
-                body.flagKeys = opts.flagKeys;
-            }
-            const response = await this.fetchImpl(`${this.options.endpoint}/v1/flags/evaluate`, {
-                method: "POST",
-                headers: {
-                    "content-type": "application/json",
-                    "x-emit-api-key": this.options.apiKey,
-                },
-                body: JSON.stringify(body),
-            });
-            if (response.ok) {
-                const data = (await response.json());
-                evaluations = data.evaluations;
-                flags = Object.fromEntries(Object.entries(evaluations).map(([k, v]) => [k, v.variantValue]));
-                this.debug("flag eval complete", { count: Object.keys(flags).length });
-            }
-            else {
-                this.debug("flag eval response error", { status: response.status });
-            }
-        }
-        catch (err) {
-            this.debug("flag eval network error", { error: err });
-            // Return empty flags on network error — never throw to callers
-        }
-        this.flagCache.set(cacheKey, { flags, expiresAt: Date.now() + ttl });
-        // Merge evaluated variants into the existing feature-flag context so that
-        // subsequent captureEvent / captureError calls include them automatically.
-        this.featureFlags = { ...this.featureFlags, ...flags };
-        if (this.options.autoCapture.flagExposures) {
-            for (const [flagKey, entry] of Object.entries(evaluations)) {
-                this.captureExposure(flagKey, entry.variantKey, entry.variantValue, entry.reason, env);
-            }
-        }
-        return flags;
+    this.retry.reset();
+    this.debug("flush complete", { count: chunk.length });
+  }
+  handleFlushFailure(batch, detail) {
+    const result = this.retry.recordFailure();
+    if (result.justDisabled) {
+      const droppedQueued = this.queue.length;
+      const droppedBatch = batch.length;
+      this.queue = [];
+      this.stopBackgroundWork();
+      const message = `[emit-vision${this.options.label ? `:${this.options.label}` : ""}] disabled after ${result.consecutiveFailures} consecutive flush failures; dropping ${droppedQueued + droppedBatch} queued events. Re-init the SDK to resume.`;
+      if (typeof console.warn === "function") {
+        console.warn(message);
+      }
+      this.debug("disabled", {
+        consecutiveFailures: result.consecutiveFailures,
+        dropped: droppedQueued + droppedBatch
+      });
+      return;
     }
-    setTags(tags) {
-        this.tags = { ...this.tags, ...tags };
-        this.debug("updated tags", this.tags);
+    this.queue.unshift(...batch);
+    if (detail.reason === "network") {
+      this.debug("flush network error", {
+        error: detail.error,
+        restoredCount: batch.length,
+        consecutiveFailures: result.consecutiveFailures,
+        backoffMs: result.backoffMs
+      });
+    } else {
+      this.debug("flush failed", {
+        status: detail.status,
+        restoredCount: batch.length,
+        consecutiveFailures: result.consecutiveFailures,
+        backoffMs: result.backoffMs
+      });
     }
-    async flush() {
-        const batch = this.queue.splice(0, this.options.batchSize);
-        if (batch.length === 0) {
-            return;
-        }
-        this.debug("flushing batch", { count: batch.length });
-        let response;
-        try {
-            response = await this.fetchImpl(`${this.options.endpoint}/v1/batch`, {
-                method: "POST",
-                headers: {
-                    "content-type": "application/json",
-                    "x-emit-api-key": this.options.apiKey,
-                },
-                body: JSON.stringify({
-                    events: batch.map((item) => ({
-                        ...item,
-                        sdk: { name: SDK_NAME, version: SDK_VERSION },
-                    })),
-                }),
-                keepalive: true,
-            });
-        }
-        catch (err) {
-            this.queue.unshift(...batch);
-            this.debug("flush network error", {
-                error: err,
-                restoredCount: batch.length,
-            });
-            throw err;
-        }
-        if (!response.ok) {
-            this.queue.unshift(...batch);
-            this.debug("flush failed", {
-                status: response.status,
-                restoredCount: batch.length,
-            });
-            throw new Error(`emit-vision flush failed with ${response.status}`);
-        }
-        this.debug("flush complete", { count: batch.length });
-        if (this.options.flushOnCapture && this.queue.length > 0) {
-            this.scheduleFlush();
-        }
+  }
+  stopBackgroundWork() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = void 0;
     }
-    close() {
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = undefined;
-        }
-        if (typeof window !== "undefined" && this.options.autoCapture.errors) {
-            window.removeEventListener("error", this.handleWindowError);
-        }
-        if (typeof window !== "undefined" &&
-            this.options.autoCapture.unhandledRejections) {
-            window.removeEventListener("unhandledrejection", this.handleUnhandledRejection);
-        }
-        this.debug("closed client");
+  }
+  close() {
+    this.stopBackgroundWork();
+    if (typeof window !== "undefined" && this.options.autoCapture.errors) {
+      window.removeEventListener("error", this.handleWindowError);
     }
-    enqueue(payload) {
-        this.queue.push(payload);
-        this.debug("queued payload", {
-            type: payload.type,
-            name: payload.name,
-            queueSize: this.queue.length,
-            flushOnCapture: this.options.flushOnCapture,
-            batchSize: this.options.batchSize,
-        });
-        if (this.options.flushOnCapture) {
-            this.debug("capture flush scheduled", {
-                queueSize: this.queue.length,
-            });
-            this.flush().catch((err) => this.debug("capture flush error", { error: err }));
-            return;
-        }
-        if (this.queue.length >= this.options.batchSize) {
-            this.flush().catch((err) => this.debug("batch flush error", { error: err }));
-        }
+    if (typeof window !== "undefined" && this.options.autoCapture.unhandledRejections) {
+      window.removeEventListener(
+        "unhandledrejection",
+        this.handleUnhandledRejection
+      );
     }
-    scheduleFlush() {
-        if (this.flushScheduled) {
-            return;
-        }
-        this.flushScheduled = true;
-        queueMicrotask(() => {
-            this.flushScheduled = false;
-            if (this.queue.length === 0) {
-                return;
-            }
-            this.flush().catch((err) => this.debug("scheduled flush error", { error: err }));
-        });
+    if (typeof window !== "undefined" && this.options.autoCapture.pageViews) {
+      window.removeEventListener("popstate", this.handlePopState);
+      this.restoreHistoryMethod("pushState");
+      this.restoreHistoryMethod("replaceState");
     }
-    withDefaults(options) {
-        const { context, deployment, featureFlags, tags, user, environment, release, sessionId, ...rest } = options;
-        return {
-            ...rest,
-            environment: environment ?? this.options.environment,
-            release: release ?? this.options.release,
-            sessionId: sessionId ?? this.options.sessionId,
-            user: user ?? this.user,
-            context: Object.keys(this.context).length
-                ? { ...this.context, ...context }
-                : context,
-            deployment: this.mergeDeployment(deployment),
-            featureFlags: this.mergeFeatureFlags(featureFlags),
-            tags: Object.keys(this.tags).length ? { ...this.tags, ...tags } : tags,
-        };
+    this.debug("closed client");
+  }
+  enqueueMetaEvent(originalName, originalBytes, trimmedFields) {
+    this.queue.push({
+      type: "event",
+      name: "sdk.event_truncated",
+      properties: { originalName, originalBytes, trimmedFields, sdkName: SDK_NAME },
+      environment: this.options.environment,
+      release: this.options.release
+    });
+  }
+  enqueue(payload) {
+    if (this.retry.isDisabled()) {
+      return;
+    }
+    const { payload: trimmed, trimmedFields, originalBytes } = trimEventIfOversized(payload);
+    this.queue.push(trimmed);
+    if (trimmedFields !== null) {
+      this.enqueueMetaEvent(payload.name, originalBytes, trimmedFields);
+    }
+    this.debug("queued payload", {
+      type: payload.type,
+      name: payload.name,
+      queueSize: this.queue.length,
+      flushOnCapture: this.options.flushOnCapture,
+      batchSize: this.options.batchSize
+    });
+    if (this.options.flushOnCapture) {
+      this.debug("capture flush scheduled", {
+        queueSize: this.queue.length
+      });
+      if (!this.retry.isBackingOff()) {
+        this.flush().catch(
+          (err) => this.debug("capture flush error", { error: err })
+        );
+      }
+      return;
     }
-    mergeDeployment(deployment) {
-        const merged = {
-            ...(this.deployment ?? {}),
-            ...(deployment ?? {}),
-        };
-        return Object.keys(merged).length > 0 ? merged : undefined;
+    if (this.queue.length >= this.options.batchSize && !this.retry.isBackingOff()) {
+      this.flush().catch(
+        (err) => this.debug("batch flush error", { error: err })
+      );
     }
-    mergeFeatureFlags(featureFlags) {
-        const merged = {
-            ...this.featureFlags,
-            ...(featureFlags ?? {}),
-        };
-        return Object.keys(merged).length > 0 ? merged : undefined;
+  }
+  scheduleFlush() {
+    if (this.flushScheduled) {
+      return;
     }
-    handleWindowError = (event) => {
-        const serialized = serializeError(event.error ?? event.message);
-        this.debug("auto-captured window error", {
-            message: serialized.message,
-        });
-        this.enqueue({
-            type: "error",
-            name: "error",
-            error: { ...serialized, handled: false },
-            ...this.withDefaults({ context: { source: "window.error" } }),
-        });
+    this.flushScheduled = true;
+    queueMicrotask(() => {
+      this.flushScheduled = false;
+      if (this.queue.length === 0 || this.retry.isBackingOff()) {
+        return;
+      }
+      this.flush().catch(
+        (err) => this.debug("scheduled flush error", { error: err })
+      );
+    });
+  }
+  withDefaults(options) {
+    const {
+      context,
+      deployment,
+      featureFlags,
+      tags,
+      user,
+      environment,
+      release,
+      sessionId,
+      ...rest
+    } = options;
+    return {
+      ...rest,
+      environment: environment ?? this.options.environment,
+      release: release ?? this.options.release,
+      sessionId: sessionId ?? this.options.sessionId,
+      user: user ?? this.user,
+      context: Object.keys(this.context).length ? { ...this.context, ...context } : context,
+      deployment: this.mergeDeployment(deployment),
+      featureFlags: this.mergeFeatureFlags(featureFlags),
+      tags: Object.keys(this.tags).length ? { ...this.tags, ...tags } : tags
     };
-    handleUnhandledRejection = (event) => {
-        const serialized = serializeError(event.reason);
-        this.debug("auto-captured rejection", {
-            message: serialized.message,
-        });
-        this.enqueue({
-            type: "error",
-            name: "error",
-            error: { ...serialized, handled: false },
-            ...this.withDefaults({
-                context: { source: "window.unhandledrejection" },
-            }),
-        });
+  }
+  mergeDeployment(deployment) {
+    const merged = {
+      ...this.deployment ?? {},
+      ...deployment ?? {}
     };
-    debug(message, payload) {
-        if (!this.options.debug || typeof console.debug !== "function") {
-            return;
-        }
-        const prefix = this.options.label
-            ? `[emit-vision:${this.options.label}]`
-            : "[emit-vision]";
-        if (payload === undefined) {
-            console.debug(prefix, message);
-            return;
-        }
-        console.debug(prefix, message, payload);
+    return Object.keys(merged).length > 0 ? merged : void 0;
+  }
+  mergeFeatureFlags(featureFlags) {
+    const merged = {
+      ...this.featureFlags,
+      ...featureFlags ?? {}
+    };
+    return Object.keys(merged).length > 0 ? merged : void 0;
+  }
+  handleWindowError = (event) => {
+    const serialized = serializeError(event.error ?? event.message);
+    this.debug("auto-captured window error", {
+      message: serialized.message
+    });
+    this.enqueue({
+      type: "error",
+      name: "error",
+      error: { ...serialized, handled: false },
+      ...this.withDefaults({ context: { source: "window.error" } })
+    });
+  };
+  handlePopState = () => {
+    this.capturePageView();
+  };
+  patchHistoryMethod(method) {
+    const original = history[method].bind(history);
+    history[`__ev_orig_${method}`] = original;
+    history[method] = (...args) => {
+      original(...args);
+      this.capturePageView();
+    };
+  }
+  restoreHistoryMethod(method) {
+    const original = history[`__ev_orig_${method}`];
+    if (original) {
+      history[method] = original;
     }
-}
-let client;
-export function init(options) {
-    const transport = resolveTransport(options);
-    const autoCapture = resolveAutoCapture(options);
-    client?.close();
-    client = new EmitVisionClient({
-        ...options,
-        flushIntervalMs: options.flushIntervalMs ?? 5000,
-        batchSize: options.batchSize ?? 20,
-        debug: options.debug ?? false,
-        fetchImpl: options.fetchImpl ?? globalThis.fetch.bind(globalThis),
-        flushOnCapture: options.flushOnCapture ?? false,
-        flagEvalTtlMs: options.flagEvalTtlMs ?? 60_000,
-        apiKey: transport.apiKey,
-        endpoint: transport.endpoint ?? options.endpoint ?? "http://localhost:4301",
-        autoCapture,
+  }
+  handleUnhandledRejection = (event) => {
+    const serialized = serializeError(event.reason);
+    this.debug("auto-captured rejection", {
+      message: serialized.message
     });
-    return client;
-}
-export function captureEvent(name, properties, options) {
-    requireClient().captureEvent(name, properties, options);
-}
-export function captureError(error, options) {
-    requireClient().captureError(error, options);
-}
-export function identify(userIdOrUser, traits) {
-    requireClient().identify(userIdOrUser, traits);
-}
-export function setContext(context) {
-    requireClient().setContext(context);
+    this.enqueue({
+      type: "error",
+      name: "error",
+      error: { ...serialized, handled: false },
+      ...this.withDefaults({
+        context: { source: "window.unhandledrejection" }
+      })
+    });
+  };
+  debug(message, payload) {
+    if (!this.options.debug || typeof console.debug !== "function") {
+      return;
+    }
+    const prefix = this.options.label ? `[emit-vision:${this.options.label}]` : "[emit-vision]";
+    if (payload === void 0) {
+      console.debug(prefix, message);
+      return;
+    }
+    console.debug(prefix, message, payload);
+  }
+};
+
+// src/index.ts
+var client;
+function init(options) {
+  const transport = resolveTransport(options);
+  const autoCapture = resolveAutoCapture(options);
+  const resolved = {
+    ...options,
+    flushIntervalMs: options.flushIntervalMs ?? 5e3,
+    batchSize: options.batchSize ?? 20,
+    debug: options.debug ?? false,
+    fetchImpl: options.fetchImpl ?? globalThis.fetch.bind(globalThis),
+    flushOnCapture: options.flushOnCapture ?? false,
+    flagEvalTtlMs: options.flagEvalTtlMs ?? 6e4,
+    retryBackoffInitialMs: options.retryBackoffInitialMs ?? 1e3,
+    retryBackoffMaxMs: options.retryBackoffMaxMs ?? 3e4,
+    maxConsecutiveFlushFailures: options.maxConsecutiveFlushFailures ?? 20,
+    apiKey: transport.apiKey,
+    endpoint: transport.endpoint ?? options.endpoint ?? "http://localhost:4301",
+    autoCapture,
+    sessionId: options.sessionId ?? getOrCreateAnonymousId()
+  };
+  client?.close();
+  client = new EmitVisionClient(resolved);
+  return client;
 }
-export function setDeploymentContext(context) {
-    requireClient().setDeploymentContext(context);
+function captureEvent(name, properties, options) {
+  requireClient().captureEvent(name, properties, options);
 }
-export function setFeatureFlags(featureFlags) {
-    requireClient().setFeatureFlags(featureFlags);
+function captureError(error, options) {
+  requireClient().captureError(error, options);
 }
-export function setTags(tags) {
-    requireClient().setTags(tags);
+function capturePageView(path) {
+  requireClient().capturePageView(path);
 }
-export async function flush() {
-    await requireClient().flush();
+function identify(userIdOrUser, traits) {
+  requireClient().identify(userIdOrUser, traits);
 }
-export async function evaluateFlags(options) {
-    return requireClient().evaluateFlags(options);
+function setContext(context) {
+  requireClient().setContext(context);
 }
-export async function getFlag(flagKey, fallback, options) {
-    return requireClient().getFlag(flagKey, fallback, options);
+function setDeploymentContext(context) {
+  requireClient().setDeploymentContext(context);
 }
-export async function refreshFlags(options) {
-    return requireClient().refreshFlags(options);
+function setFeatureFlags(featureFlags) {
+  requireClient().setFeatureFlags(featureFlags);
 }
-export function captureExposure(flagKey, variantKey, variantValue, reason, environment) {
-    requireClient().captureExposure(flagKey, variantKey, variantValue, reason, environment);
+function setTags(tags) {
+  requireClient().setTags(tags);
 }
-function requireClient() {
-    if (!client) {
-        throw new Error("emit-vision SDK has not been initialized");
-    }
-    return client;
+async function flush() {
+  await requireClient().flush();
 }
-function resolveTransport(options) {
-    const dsn = options.dsn ? parseDsn(options.dsn) : null;
-    const apiKey = options.apiKey ?? dsn?.apiKey;
-    if (!apiKey) {
-        throw new Error("emit-vision init requires either apiKey or dsn");
-    }
-    return {
-        apiKey,
-        endpoint: stripTrailingSlash(options.endpoint ?? dsn?.endpoint),
-    };
+async function evaluateFlags(options) {
+  return requireClient().evaluateFlags(options);
 }
-function resolveAutoCapture(options) {
-    const legacyDefault = options.autoCaptureErrors === undefined ? true : options.autoCaptureErrors;
-    return {
-        errors: options.autoCapture?.errors ?? legacyDefault,
-        unhandledRejections: options.autoCapture?.unhandledRejections ?? legacyDefault,
-        flagExposures: options.autoCapture?.flagExposures ?? true,
-    };
+async function getFlag(flagKey, fallback, options) {
+  return requireClient().getFlag(flagKey, fallback, options);
 }
-function parseDsn(dsn) {
-    const parsed = new URL(dsn);
-    const apiKey = decodeURIComponent(parsed.username);
-    if (!apiKey) {
-        throw new Error("emit-vision dsn must include the API key before the @");
-    }
-    const pathname = stripTrailingSlash(parsed.pathname) ?? "";
-    const endpointPath = pathname.endsWith("/v1")
-        ? pathname.slice(0, -"/v1".length)
-        : pathname;
-    return {
-        apiKey,
-        endpoint: stripTrailingSlash(`${parsed.origin}${endpointPath}`),
-    };
+async function refreshFlags(options) {
+  return requireClient().refreshFlags(options);
 }
-function stripTrailingSlash(value) {
-    if (!value) {
-        return value;
-    }
-    return value.endsWith("/") ? value.slice(0, -1) : value;
+function captureExposure(flagKey, variantKey, variantValue, reason, environment) {
+  requireClient().captureExposure(
+    flagKey,
+    variantKey,
+    variantValue,
+    reason,
+    environment
+  );
 }
-function serializeError(error) {
-    if (error instanceof Error) {
-        return {
-            message: error.message,
-            name: error.name,
-            stack: error.stack,
-            handled: true,
-        };
-    }
-    return {
-        message: typeof error === "string" ? error : JSON.stringify(error),
-        handled: true,
-    };
+function requireClient() {
+  if (!client) {
+    throw new Error("emit-vision SDK has not been initialized");
+  }
+  return client;
 }
+export {
+  captureError,
+  captureEvent,
+  captureExposure,
+  capturePageView,
+  evaluateFlags,
+  flush,
+  getFlag,
+  identify,
+  init,
+  refreshFlags,
+  setContext,
+  setDeploymentContext,
+  setFeatureFlags,
+  setTags
+};