flowgrid-sdk 1.2.0 → 1.3.0

package/dist/lib/flowgrid.d.ts

@@ -0,0 +1,278 @@
+/**
+ * @fileoverview Unified FlowGrid SDK facade.
+ * @module flowgrid
+ *
+ * @description
+ * A single class that aggregates every feature module so consumers can
+ * instantiate the SDK once and access all tracking domains from one object.
+ *
+ * Every namespace returns an ergonomic *shortcut* wrapper exposing
+ * positional-arg methods for the 80% case. The raw underlying class is
+ * always available on `.client` for advanced configuration.
+ *
+ * @example
+ * ```ts
+ * import { FlowGrid } from "flowgrid-sdk";
+ *
+ * const fg = new FlowGrid("web_123", "https://core.flow-grid.xyz", "sk_live_xxx");
+ *
+ * // Top-level shortcuts (the 80% case)
+ * fg.track("signup_completed", { plan: "pro" });
+ * fg.page();
+ * fg.identifyUser("u_1", { email: "alice@example.com" });
+ *
+ * // Per-feature shortcuts
+ * fg.cart.add({ productId: "sku_1", name: "Tee", price: 29, currency: "USD" });
+ * fg.experiments.assign("checkout_v2", "u_1");
+ *
+ * // Power-user escape hatch — raw class with full config surface
+ * fg.events.client.track({ eventName: "x", sessionId: "...", category: "..." });
+ * ```
+ */
+import { FlowGridTransport, FlowGridTransportConfig } from "./client/transport";
+import { IdentityManager } from "./utils/identity";
+import { ActivationTracker, ExperimentTracker, FeatureTracker, PromptTracker, EventTracker, PageViewTracker, SessionTracker, IdentifyTracker, FunnelTracker, RetentionTracker, AttributionTracker, HeatmapTracker, PerformanceTracker, ReplayTracker, ProductTracker, CartTracker, CheckoutTracker, PurchaseTracker, RefundTracker, PromotionTracker, WishlistTracker, SubscriptionTracker, LTVTracker, SearchTracker, EngagementTracker, CohortTracker, ChurnTracker, MonetizationTracker, MultiPathFunnelTracker, SupportTracker, AcquisitionTracker, PathTracker, AlertTracker, SecurityTracker, ForecastingTracker } from "./tracking";
+/** Granular auto-instrumentation toggles. */
+export interface AutoTrackOptions {
+    sessions?: boolean;
+    pageViews?: boolean;
+    performance?: boolean | {
+        resources?: boolean;
+        minDuration?: number;
+    };
+    heatmaps?: boolean | {
+        movement?: boolean;
+    };
+    attribution?: boolean;
+    replay?: boolean | import("./features/analytics/replay").SessionReplayOptions;
+    /** Auto-track session depth + user activity transitions. Default on. */
+    engagement?: boolean | {
+        idleAfterMs?: number;
+        pollMs?: number;
+    };
+}
+/** Top-level config for `FlowGrid.init()`. */
+export interface FlowGridInitConfig {
+    /** Public web/site identifier (e.g. `"wx_abc123"`). Required. */
+    webId: string;
+    /** Public API key. Required. */
+    apiKey: string;
+    /**
+     * API base URL. Defaults to `"https://core.flow-grid.xyz"` — most users never
+     * need to set this.
+     */
+    endpoint?: string;
+    /**
+     * Identify the user up-front so every subsequent event is attributed.
+     * Equivalent to calling `fg.identifyUser(userId, traits)` after init.
+     */
+    user?: {
+        userId: string;
+        traits?: Record<string, unknown>;
+    };
+    /**
+     * Browser auto-instrumentation. `true` (default) turns on sessions, page
+     * views, performance, heatmaps, and attribution. Pass an object to control
+     * individual features, or `false` to opt out completely.
+     */
+    autoTrack?: boolean | AutoTrackOptions;
+    /**
+     * Session replay (rrweb). Off by default — opt in by passing `true` or an
+     * options object. Requires the `rrweb` package (already a dependency).
+     */
+    replay?: boolean | import("./features/analytics/replay").SessionReplayOptions;
+    /**
+     * Initial consent state. Equivalent to calling
+     * `FlowGrid.setConsent({ analytics, marketing })` before any tracking.
+     */
+    consent?: {
+        analytics?: boolean;
+        marketing?: boolean;
+    };
+    /** Low-level transport tunables (sampling, DNT, bot detection). */
+    transport?: FlowGridTransportConfig;
+    /** Optional pre-resolved visitor ID (server-side hydration). */
+    visitorId?: string;
+    /** Optional identity manager (advanced — visitor/session lifecycle). */
+    identityManager?: IdentityManager;
+}
+/**
+ * Unified FlowGrid SDK client. Instantiate once, use everywhere.
+ *
+ * Each feature is exposed as a lazily-initialised shortcut wrapper, so the
+ * SDK has zero overhead for unused features.
+ */
+export declare class FlowGrid {
+    /** Singleton created by {@link FlowGrid.init}. */
+    private static _instance;
+    /** Teardown for the auto-instrumentation started during `init()`. */
+    private _autoTrackStop;
+    private readonly webId;
+    private readonly endpoint;
+    private readonly apiKey;
+    private readonly visitorId?;
+    private readonly identityManager?;
+    private readonly config?;
+    private readonly _raw;
+    private readonly _wrapped;
+    /**
+     * One-line init. Idempotent — calling twice returns the same instance and
+     * logs a warning instead of starting auto-instrumentation again.
+     *
+     * @example
+     * ```ts
+     * // Painless: one line, sane defaults, everything on.
+     * const fg = FlowGrid.init({ webId: "wx_xxx", apiKey: "pk_xxx" });
+     *
+     * // Or be explicit:
+     * const fg = FlowGrid.init({
+     *   webId: "wx_xxx",
+     *   apiKey: "pk_xxx",
+     *   user: { userId: "u_1", traits: { plan: "pro" } },
+     *   replay: { sampleRate: 0.25, maskAllInputs: true },
+     *   consent: { analytics: true },
+     * });
+     * ```
+     */
+    static init(config: FlowGridInitConfig): FlowGrid;
+    /** Returns the singleton created by {@link FlowGrid.init}, if any. */
+    static instance(): FlowGrid | null;
+    /**
+     * Reset the singleton — primarily for tests / hot-reload. Tears down any
+     * active auto-instrumentation.
+     */
+    static reset(): void;
+    /**
+     * Explicit constructor for advanced cases (multi-tenant SSR, tests). Most
+     * apps should use the static {@link FlowGrid.init} instead.
+     */
+    constructor(webId: string, endpoint: string, apiKey: string, visitorId?: string, identityManager?: IdentityManager, config?: FlowGridTransportConfig);
+    private raw;
+    private wrap;
+    get activation(): ActivationTracker;
+    get features(): FeatureTracker;
+    get prompts(): PromptTracker;
+    get experiments(): ExperimentTracker;
+    get pageViews(): PageViewTracker;
+    get sessions(): SessionTracker;
+    get events(): EventTracker;
+    get identify(): IdentifyTracker;
+    get funnels(): FunnelTracker;
+    get retention(): RetentionTracker;
+    get attribution(): AttributionTracker;
+    get heatmaps(): HeatmapTracker;
+    get performance(): PerformanceTracker;
+    get replay(): ReplayTracker;
+    get products(): ProductTracker;
+    get cart(): CartTracker;
+    get checkout(): CheckoutTracker;
+    get purchases(): PurchaseTracker;
+    get refunds(): RefundTracker;
+    get promotions(): PromotionTracker;
+    get wishlist(): WishlistTracker;
+    get ltv(): LTVTracker;
+    get search(): SearchTracker;
+    get subscriptions(): SubscriptionTracker;
+    get engagement(): EngagementTracker;
+    get cohorts(): CohortTracker;
+    get churn(): ChurnTracker;
+    get monetization(): MonetizationTracker;
+    get multiPathFunnels(): MultiPathFunnelTracker;
+    get support(): SupportTracker;
+    get acquisition(): AcquisitionTracker;
+    get paths(): PathTracker;
+    get alerts(): AlertTracker;
+    get security(): SecurityTracker;
+    get forecasting(): ForecastingTracker;
+    static setConsent: typeof FlowGridTransport.setConsent;
+    static hasConsent: typeof FlowGridTransport.hasConsent;
+    /**
+     * Track a custom event.
+     *
+     * @example
+     * ```ts
+     * fg.track("signup_completed", { plan: "pro" });
+     * ```
+     */
+    track(eventName: string, properties?: Record<string, unknown>, options?: {
+        userId?: string;
+        sessionId?: string;
+    }): Promise<import("./features/analytics").EventResponse>;
+    /**
+     * Record an experiment exposure for a user.
+     *
+     * For the browser-cached flow, prefer:
+     * ```ts
+     * await fg.experiments.init([{ experimentId, variants: [...] }]);
+     * const variant = fg.experiments.variant(experimentId);
+     * fg.experiment("checkout_v2", { userId, variant });
+     * ```
+     */
+    experiment(experimentId: string, options: {
+        variant: string;
+        userId: string;
+    }): Promise<import("./features/core").ExperimentResponse>;
+    /**
+     * Identify a user.
+     *
+     * @example
+     * ```ts
+     * fg.identifyUser("u_1", { plan: "pro", email: "alice@example.com" });
+     * ```
+     */
+    identifyUser(userId: string, traits?: Record<string, unknown>, anonymousId?: string): Promise<import("./features/analytics").IdentifyResponse>;
+    /**
+     * Track a page view. Auto-detects URL/path/title/referrer in the browser.
+     *
+     * @example
+     * ```ts
+     * fg.page();                            // auto-detect everything
+     * fg.page("/pricing", { plan: "pro" }); // override path + properties
+     * ```
+     */
+    page(pathOrUrl?: string, properties?: Record<string, unknown>, options?: {
+        title?: string;
+        referrer?: string;
+        userId?: string;
+        sessionId?: string;
+    }): Promise<import("./features/analytics").PageViewResponse>;
+    /**
+     * Enable browser-side auto-instrumentation in a single call. Subscribes to:
+     *
+     * - **Sessions** — start, heartbeat, and end on `pagehide`
+     * - **Page views** — initial view + SPA `pushState`/`popstate` + scroll-depth + time-on-page
+     * - **Performance** — Core Web Vitals via `web-vitals` + navigation timing
+     * - **Heatmaps** — click + scroll listeners
+     * - **Engagement** — session depth, action count, and active/passive/idle transitions
+     * - **Attribution** — UTM + referrer parsing on first load (requires `userId`)
+     *
+     * Each section can be disabled by setting it to `false`. Returns a single
+     * teardown function that detaches every listener; safe no-op on the server.
+     *
+     * @example
+     * ```ts
+     * const stop = fg.autoTrack({ userId: "u_1" });
+     * // ...later
+     * stop();
+     * ```
+     */
+    autoTrack(options?: {
+        userId?: string;
+        sessions?: boolean;
+        pageViews?: boolean;
+        performance?: boolean | {
+            resources?: boolean;
+            minDuration?: number;
+        };
+        heatmaps?: boolean | {
+            movement?: boolean;
+        };
+        attribution?: boolean;
+        replay?: boolean | import("./features/analytics/replay").SessionReplayOptions;
+        engagement?: boolean | {
+            idleAfterMs?: number;
+            pollMs?: number;
+        };
+    }): () => void;
+}
+export default FlowGrid;

package/dist/lib/flowgrid.js

@@ -0,0 +1,323 @@
+/**
+ * @fileoverview Unified FlowGrid SDK facade.
+ * @module flowgrid
+ *
+ * @description
+ * A single class that aggregates every feature module so consumers can
+ * instantiate the SDK once and access all tracking domains from one object.
+ *
+ * Every namespace returns an ergonomic *shortcut* wrapper exposing
+ * positional-arg methods for the 80% case. The raw underlying class is
+ * always available on `.client` for advanced configuration.
+ *
+ * @example
+ * ```ts
+ * import { FlowGrid } from "flowgrid-sdk";
+ *
+ * const fg = new FlowGrid("web_123", "https://core.flow-grid.xyz", "sk_live_xxx");
+ *
+ * // Top-level shortcuts (the 80% case)
+ * fg.track("signup_completed", { plan: "pro" });
+ * fg.page();
+ * fg.identifyUser("u_1", { email: "alice@example.com" });
+ *
+ * // Per-feature shortcuts
+ * fg.cart.add({ productId: "sku_1", name: "Tee", price: 29, currency: "USD" });
+ * fg.experiments.assign("checkout_v2", "u_1");
+ *
+ * // Power-user escape hatch — raw class with full config surface
+ * fg.events.client.track({ eventName: "x", sessionId: "...", category: "..." });
+ * ```
+ */
+import { FlowGridTransport } from "./client/transport";
+import { IdentityManager } from "./utils/identity";
+import { Activation, TrackFeature, TrackPrompt, Experiment } from "./features/core";
+import { PageViews, Sessions, Events, Identify, Funnels, Retention, Attribution, Heatmaps, PerformanceTracking, SessionReplay, } from "./features/analytics";
+import { Products, CartTracking, Checkout, Purchases, Refunds, Promotions, WishlistTracking, CustomerLTV, SearchAnalytics, Subscriptions, } from "./features/ecommerce";
+import { Engagement, Cohorts, ChurnAnalytics, Monetization, MultiPathFunnels, SupportAnalytics, AcquisitionAnalytics, PathAnalytics, AlertsAnalytics, SecurityAnalytics, Forecasting, } from "./features/enterprise";
+import { ActivationTracker, ExperimentTracker, FeatureTracker, PromptTracker, EventTracker, PageViewTracker, SessionTracker, IdentifyTracker, FunnelTracker, RetentionTracker, AttributionTracker, HeatmapTracker, PerformanceTracker, ReplayTracker, ProductTracker, CartTracker, CheckoutTracker, PurchaseTracker, RefundTracker, PromotionTracker, WishlistTracker, SubscriptionTracker, LTVTracker, SearchTracker, EngagementTracker, CohortTracker, ChurnTracker, MonetizationTracker, MultiPathFunnelTracker, SupportTracker, AcquisitionTracker, PathTracker, AlertTracker, SecurityTracker, ForecastingTracker, } from "./tracking";
+const DEFAULT_ENDPOINT = "https://core.flow-grid.xyz";
+/**
+ * Unified FlowGrid SDK client. Instantiate once, use everywhere.
+ *
+ * Each feature is exposed as a lazily-initialised shortcut wrapper, so the
+ * SDK has zero overhead for unused features.
+ */
+export class FlowGrid {
+    /**
+     * One-line init. Idempotent — calling twice returns the same instance and
+     * logs a warning instead of starting auto-instrumentation again.
+     *
+     * @example
+     * ```ts
+     * // Painless: one line, sane defaults, everything on.
+     * const fg = FlowGrid.init({ webId: "wx_xxx", apiKey: "pk_xxx" });
+     *
+     * // Or be explicit:
+     * const fg = FlowGrid.init({
+     *   webId: "wx_xxx",
+     *   apiKey: "pk_xxx",
+     *   user: { userId: "u_1", traits: { plan: "pro" } },
+     *   replay: { sampleRate: 0.25, maskAllInputs: true },
+     *   consent: { analytics: true },
+     * });
+     * ```
+     */
+    static init(config) {
+        if (FlowGrid._instance) {
+            if (typeof console !== "undefined") {
+                console.warn("[FlowGrid] init() called more than once — returning existing instance.");
+            }
+            return FlowGrid._instance;
+        }
+        if (!config?.webId || !config?.apiKey) {
+            throw new Error("FlowGrid.init: `webId` and `apiKey` are required.");
+        }
+        if (config.consent) {
+            FlowGrid.setConsent(config.consent);
+        }
+        const fg = new FlowGrid(config.webId, config.endpoint ?? DEFAULT_ENDPOINT, config.apiKey, config.visitorId, config.identityManager, config.transport);
+        FlowGrid._instance = fg;
+        // Identify the user before auto-instrumentation so the very first events
+        // (session_start, page_view) carry the userId.
+        if (config.user?.userId) {
+            void fg.identifyUser(config.user.userId, config.user.traits);
+        }
+        const autoTrack = config.autoTrack;
+        const replay = config.replay;
+        const autoOpts = autoTrack === false ? { sessions: false, pageViews: false, performance: false, heatmaps: false, attribution: false, engagement: false }
+            : autoTrack === true || autoTrack === undefined ? {}
+                : autoTrack;
+        if (replay !== undefined && autoOpts.replay === undefined) {
+            autoOpts.replay = replay;
+        }
+        fg._autoTrackStop = fg.autoTrack({
+            ...autoOpts,
+            userId: config.user?.userId ?? autoOpts.userId,
+        });
+        return fg;
+    }
+    /** Returns the singleton created by {@link FlowGrid.init}, if any. */
+    static instance() {
+        return FlowGrid._instance;
+    }
+    /**
+     * Reset the singleton — primarily for tests / hot-reload. Tears down any
+     * active auto-instrumentation.
+     */
+    static reset() {
+        if (FlowGrid._instance?._autoTrackStop) {
+            try {
+                FlowGrid._instance._autoTrackStop();
+            }
+            catch { /* noop */ }
+        }
+        FlowGrid._instance = null;
+    }
+    /**
+     * Explicit constructor for advanced cases (multi-tenant SSR, tests). Most
+     * apps should use the static {@link FlowGrid.init} instead.
+     */
+    constructor(webId, endpoint, apiKey, visitorId, identityManager, config) {
+        /** Teardown for the auto-instrumentation started during `init()`. */
+        this._autoTrackStop = null;
+        this._raw = new Map();
+        this._wrapped = new Map();
+        this.webId = webId;
+        this.endpoint = endpoint;
+        this.apiKey = apiKey;
+        this.visitorId = visitorId;
+        this.identityManager = identityManager ?? new IdentityManager(visitorId ? { visitorId } : undefined);
+        this.config = config;
+    }
+    raw(key, Klass) {
+        let instance = this._raw.get(key);
+        if (!instance) {
+            instance = new Klass(this.webId, this.endpoint, this.apiKey, this.visitorId, this.identityManager, this.config);
+            this._raw.set(key, instance);
+        }
+        return instance;
+    }
+    wrap(key, Klass, Wrapper) {
+        let instance = this._wrapped.get(key);
+        if (!instance) {
+            instance = new Wrapper(this.raw(key, Klass));
+            this._wrapped.set(key, instance);
+        }
+        return instance;
+    }
+    // ---- Core ----
+    get activation() { return this.wrap("activation", Activation, ActivationTracker); }
+    get features() { return this.wrap("features", TrackFeature, FeatureTracker); }
+    get prompts() { return this.wrap("prompts", TrackPrompt, PromptTracker); }
+    get experiments() { return this.wrap("experiments", Experiment, ExperimentTracker); }
+    // ---- Analytics ----
+    get pageViews() { return this.wrap("pageViews", PageViews, PageViewTracker); }
+    get sessions() { return this.wrap("sessions", Sessions, SessionTracker); }
+    get events() { return this.wrap("events", Events, EventTracker); }
+    get identify() { return this.wrap("identify", Identify, IdentifyTracker); }
+    get funnels() { return this.wrap("funnels", Funnels, FunnelTracker); }
+    get retention() { return this.wrap("retention", Retention, RetentionTracker); }
+    get attribution() { return this.wrap("attribution", Attribution, AttributionTracker); }
+    get heatmaps() { return this.wrap("heatmaps", Heatmaps, HeatmapTracker); }
+    get performance() { return this.wrap("performance", PerformanceTracking, PerformanceTracker); }
+    get replay() { return this.wrap("replay", SessionReplay, ReplayTracker); }
+    // ---- Ecommerce ----
+    get products() { return this.wrap("products", Products, ProductTracker); }
+    get cart() { return this.wrap("cart", CartTracking, CartTracker); }
+    get checkout() { return this.wrap("checkout", Checkout, CheckoutTracker); }
+    get purchases() { return this.wrap("purchases", Purchases, PurchaseTracker); }
+    get refunds() { return this.wrap("refunds", Refunds, RefundTracker); }
+    get promotions() { return this.wrap("promotions", Promotions, PromotionTracker); }
+    get wishlist() { return this.wrap("wishlist", WishlistTracking, WishlistTracker); }
+    get ltv() { return this.wrap("ltv", CustomerLTV, LTVTracker); }
+    get search() { return this.wrap("search", SearchAnalytics, SearchTracker); }
+    get subscriptions() { return this.wrap("subscriptions", Subscriptions, SubscriptionTracker); }
+    // ---- Enterprise ----
+    get engagement() { return this.wrap("engagement", Engagement, EngagementTracker); }
+    get cohorts() { return this.wrap("cohorts", Cohorts, CohortTracker); }
+    get churn() { return this.wrap("churn", ChurnAnalytics, ChurnTracker); }
+    get monetization() { return this.wrap("monetization", Monetization, MonetizationTracker); }
+    get multiPathFunnels() { return this.wrap("multiPathFunnels", MultiPathFunnels, MultiPathFunnelTracker); }
+    get support() { return this.wrap("support", SupportAnalytics, SupportTracker); }
+    get acquisition() { return this.wrap("acquisition", AcquisitionAnalytics, AcquisitionTracker); }
+    get paths() { return this.wrap("paths", PathAnalytics, PathTracker); }
+    get alerts() { return this.wrap("alerts", AlertsAnalytics, AlertTracker); }
+    get security() { return this.wrap("security", SecurityAnalytics, SecurityTracker); }
+    get forecasting() { return this.wrap("forecasting", Forecasting, ForecastingTracker); }
+    // ==========================================================================
+    // TOP-LEVEL SHORTCUTS — the 80% case
+    // ==========================================================================
+    /**
+     * Track a custom event.
+     *
+     * @example
+     * ```ts
+     * fg.track("signup_completed", { plan: "pro" });
+     * ```
+     */
+    track(eventName, properties, options) {
+        return this.events.track(eventName, properties, options);
+    }
+    /**
+     * Record an experiment exposure for a user.
+     *
+     * For the browser-cached flow, prefer:
+     * ```ts
+     * await fg.experiments.init([{ experimentId, variants: [...] }]);
+     * const variant = fg.experiments.variant(experimentId);
+     * fg.experiment("checkout_v2", { userId, variant });
+     * ```
+     */
+    experiment(experimentId, options) {
+        return this.experiments.exposure(experimentId, options.userId, options.variant);
+    }
+    /**
+     * Identify a user.
+     *
+     * @example
+     * ```ts
+     * fg.identifyUser("u_1", { plan: "pro", email: "alice@example.com" });
+     * ```
+     */
+    identifyUser(userId, traits, anonymousId) {
+        return this.identify.user(userId, traits, anonymousId);
+    }
+    /**
+     * Track a page view. Auto-detects URL/path/title/referrer in the browser.
+     *
+     * @example
+     * ```ts
+     * fg.page();                            // auto-detect everything
+     * fg.page("/pricing", { plan: "pro" }); // override path + properties
+     * ```
+     */
+    page(pathOrUrl, properties, options) {
+        return this.pageViews.view(pathOrUrl, properties, options);
+    }
+    /**
+     * Enable browser-side auto-instrumentation in a single call. Subscribes to:
+     *
+     * - **Sessions** — start, heartbeat, and end on `pagehide`
+     * - **Page views** — initial view + SPA `pushState`/`popstate` + scroll-depth + time-on-page
+     * - **Performance** — Core Web Vitals via `web-vitals` + navigation timing
+     * - **Heatmaps** — click + scroll listeners
+     * - **Engagement** — session depth, action count, and active/passive/idle transitions
+     * - **Attribution** — UTM + referrer parsing on first load (requires `userId`)
+     *
+     * Each section can be disabled by setting it to `false`. Returns a single
+     * teardown function that detaches every listener; safe no-op on the server.
+     *
+     * @example
+     * ```ts
+     * const stop = fg.autoTrack({ userId: "u_1" });
+     * // ...later
+     * stop();
+     * ```
+     */
+    autoTrack(options = {}) {
+        const teardowns = [];
+        const ctx = { userId: options.userId };
+        if (options.sessions !== false) {
+            teardowns.push(this.sessions.autoTrack(ctx.userId ? { user: { userId: ctx.userId } } : {}));
+        }
+        if (options.pageViews !== false) {
+            teardowns.push(this.pageViews.autoTrack(ctx));
+        }
+        if (options.performance !== false) {
+            const perfOpts = typeof options.performance === "object" ? options.performance : {};
+            teardowns.push(this.performance.autoTrack({ ...perfOpts, userId: ctx.userId }));
+        }
+        if (options.heatmaps !== false) {
+            const hmOpts = typeof options.heatmaps === "object" ? options.heatmaps : {};
+            teardowns.push(this.heatmaps.autoTrack({ ...hmOpts, userId: ctx.userId }));
+        }
+        if (options.engagement !== false) {
+            const engOpts = typeof options.engagement === "object" ? options.engagement : {};
+            teardowns.push(this.engagement.client.autoTrack({ ...engOpts, userId: ctx.userId }));
+        }
+        if (options.attribution !== false && ctx.userId) {
+            this.attribution.captureFromUrl(ctx.userId);
+        }
+        if (options.replay) {
+            const replayOpts = typeof options.replay === "object" ? options.replay : {};
+            // start() is async; track its resolved teardown so the outer stop()
+            // tears down recording even if the user calls it before rrweb resolved.
+            let resolvedStop = null;
+            let stopRequested = false;
+            void this.replay.start({ userId: ctx.userId, ...replayOpts }).then(stop => {
+                if (stopRequested) {
+                    try {
+                        stop();
+                    }
+                    catch { /* noop */ }
+                }
+                else {
+                    resolvedStop = stop;
+                }
+            });
+            teardowns.push(() => {
+                stopRequested = true;
+                if (resolvedStop) {
+                    try {
+                        resolvedStop();
+                    }
+                    catch { /* noop */ }
+                }
+            });
+        }
+        return () => { for (const t of teardowns) {
+            try {
+                t();
+            }
+            catch { /* swallow */ }
+        } };
+    }
+}
+/** Singleton created by {@link FlowGrid.init}. */
+FlowGrid._instance = null;
+// ---- Consent passthrough (static on transport) ----
+FlowGrid.setConsent = FlowGridTransport.setConsent.bind(FlowGridTransport);
+FlowGrid.hasConsent = FlowGridTransport.hasConsent.bind(FlowGridTransport);
+export default FlowGrid;
+//# sourceMappingURL=flowgrid.js.map

package/dist/lib/flowgrid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowgrid.js","sourceRoot":"","sources":["../../src/lib/flowgrid.ts"],"names":[],"mappings":"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"}

package/dist/lib/frameworks/index.d.ts

@@ -1,9 +1,16 @@
 /**
- * @fileoverview Framework Integrations Barrel Export
+ * @fileoverview Framework Integrations
  * @module frameworks
+ *
+ * Framework integrations are available via sub-path imports to avoid
+ * pulling framework-specific dependencies into unrelated environments:
+ *
+ *   import { ... } from 'flowgrid-sdk/react';
+ *   import { ... } from 'flowgrid-sdk/nextjs';
+ *   import { ... } from 'flowgrid-sdk/vue';
+ *   import { ... } from 'flowgrid-sdk/nuxt';
+ *   import { ... } from 'flowgrid-sdk/node';
+ *
+ * Do NOT re-export frameworks here — each sub-path is resolved
+ * independently via the "exports" field in package.json.
  */
-export * as react from './react';
-export * as vue from './vue';
-export * as nextjs from './nextjs';
-export * as nuxt from './nuxt';
-export * as node from './node';

package/dist/lib/frameworks/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * @fileoverview Framework Integrations
+ * @module frameworks
+ *
+ * Framework integrations are available via sub-path imports to avoid
+ * pulling framework-specific dependencies into unrelated environments:
+ *
+ *   import { ... } from 'flowgrid-sdk/react';
+ *   import { ... } from 'flowgrid-sdk/nextjs';
+ *   import { ... } from 'flowgrid-sdk/vue';
+ *   import { ... } from 'flowgrid-sdk/nuxt';
+ *   import { ... } from 'flowgrid-sdk/node';
+ *
+ * Do NOT re-export frameworks here — each sub-path is resolved
+ * independently via the "exports" field in package.json.
+ */
+//# sourceMappingURL=index.js.map

package/dist/lib/frameworks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/frameworks/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG"}