@flusterduck/svelte

SvelteKit integration for Flusterduck. Exports plain functions for initialization and tracking. No Svelte-specific wrappers are needed since the SDK is framework-agnostic; this package adds SSR guards and a SvelteKit-idiomatic entry point.

Installation

npm install flusterduck @flusterduck/svelte

Usage

Initialize in your root layout's onMount so it only runs in the browser:

// src/routes/+layout.svelte
import { onMount } from 'svelte';
import { initFlusterduck, destroyFlusterduck } from '@flusterduck/svelte';

onMount(() => {
  initFlusterduck({
    key: 'fd_pub_...',
    environment: 'production',
  });

  return () => destroyFlusterduck();
});

Tracking

import { signal, track, identify } from '@flusterduck/svelte';

// Custom friction signal with optional weight (0-100)
signal('filter_spiral', { element: '.filter-bar', weight: 20 });

// Business event
track('plan_selected', { plan: 'scale' });

// Segment
identify({ plan: 'scale', role: 'admin' });

Consent

import { setConsent, optOut } from '@flusterduck/svelte';

setConsent(true);   // start tracking after cookie acceptance
optOut();           // stop and clear session

API

initFlusterduck(config: Config): void
destroyFlusterduck(): void
signal(name: string, data?: { element?: string; metadata?: Record<string, unknown>; weight?: number }): void
track(name: string, metadata?: Record<string, unknown>): void
identify(segment: Record<string, string>): void
setConsent(consented: boolean): void
optOut(): void

All Config options from the core flusterduck package are supported.