Browser SDK

import { mydle } from "@mydle/browser-sdk";

mydle.init({ projectKey: "pk_live_…" });
mydle.track("checkout_started", { plan: "pro" });
mydle.captureException(error);
await mydle.flush();
mydle.stop();

• init — start (or replace) the global client; returns a handle with the same methods.
• track(name, properties?) — custom event beacon.
• captureException(error, context?) — error beacon.
• flush() — await pending batch send.
• stop() — remove instrumentation and flush sync on teardown.

• projectKey / legacy publicKey — required pk_ publishable key.
• endpoint — absolute ingest URL; default https://www.mydle.app/api/rum/v1/ingest.
• release — app version / SHA tagged on beacons.
• sampleRate — session sample fraction 0–1 (default 1).
• network — capture fetch / XHR (default true).
• clicks — automatic click timeline events (default false).
• tracePropagation — same-origin W3C traceparent + X-Mydle-Session-ID (default true).
• batchSize — default 10.
• flushIntervalMs — default 5000.

Types: pageview, navigation, route_change, visibility, unload, error, vital, session, network, event. Each carries an opaque eventId for retry-safe deduplication. Transport: POST /api/rum/v1/ingest.

Events buffer in memory (with a bounded offline queue in localStorage) and flush on batch size, interval, visibility hidden / pagehide, or explicit flush().

initMydleBrowser({ publicKey, … }) maps to mydle.init with projectKey. Prefer the mydle facade for new code.

• Installation
• Network
• Errors
• Privacy