svoose 0.1.2 → 0.1.3

package/README.md

@@ -75,8 +75,15 @@ const cleanup = observe({
   batchSize: 10,
   flushInterval: 5000,
 
-  // Sampling
-  sampleRate: 0.1,           // 10% of users
+  // Sampling (v0.1.3+)
+  sampling: 0.1,             // 10% of all events
+  // or per-event-type (recommended)
+  sampling: {
+    vitals: 0.1,             // 10% — sufficient for statistics
+    errors: 1.0,             // 100% — all errors matter
+    custom: 0.5,             // 50% of custom metrics
+    transitions: 0.0,        // disabled
+  },
 
   // Debug
   debug: false,
@@ -86,6 +93,32 @@ const cleanup = observe({
 cleanup();
 ```
 
+#### Sampling (v0.1.3+)
+
+Control what percentage of events are sent to your backend:
+
+```typescript
+// Simple: same rate for all events
+observe({
+  endpoint: '/api/metrics',
+  sampling: 0.1, // 10% of all events
+});
+
+// Per-event-type: recommended for production
+observe({
+  endpoint: '/api/metrics',
+  sampling: {
+    vitals: 0.1,       // 10% — sufficient for accurate statistics
+    errors: 1.0,       // 100% — capture all errors
+    custom: 0.5,       // 50% of custom metrics
+    transitions: 0.0,  // disabled — no state machine events
+    identify: 1.0,     // 100% — always track user identification
+  },
+});
+```
+
+> **Note**: `sampleRate` is deprecated. Use `sampling` instead.
+
 ### `createMachine(config)`
 
 Create a state machine.
@@ -369,9 +402,15 @@ const machine = createMachine({
 
 ## Roadmap
 
-- **v0.2** — `invoke()`, `spawn()`, `after()` (delayed transitions)
-- **v0.3** — Parallel states, history states, devtools
-- **v0.4** — svelte-reactor integration, SvelteKit hooks
+- **v0.1.3-v0.1.9** — Incremental features (sampling, sessions, custom metrics, retry, privacy)
+- **v0.2.0** — Production-Ready Observability (network awareness, offline queue, user identification)
+- **v0.3.0** — SvelteKit Integration (Vite plugin, hooks, route tracking)
+- **v0.4.0** — Developer Experience (CLI, dashboard template)
+- **v1.0.0** — Stable Release (Q1 2027)
+
+> **Note**: FSM is a lightweight bonus feature, not an XState competitor. For complex state machines, use XState.
+
+See [ROADMAP.md](./ROADMAP.md) for detailed plans.
 
 ## License
 

package/dist/index.d.ts

@@ -5,6 +5,8 @@
  */
 export { observe } from './observe/index.js';
 export type { ObserveOptions } from './observe/index.js';
+export { createSampler, eventTypeToSamplingType } from './observe/index.js';
+export type { SamplingConfig, SamplingOption, SamplingEventType, Sampler } from './observe/index.js';
 export { observeErrors, registerMachineContext, unregisterMachineContext, } from './observe/index.js';
 export type { ObserveErrorEvent, ErrorEvent, UnhandledRejectionEvent, } from './observe/index.js';
 export { observeCLS, observeLCP, observeFID, observeINP, observeFCP, observeTTFB, vitalObservers, } from './observe/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAK3E,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACpF,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAKxE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,aAAa,EACb,OAAO,EACP,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,oBAAoB,CAAC;AAK5B,YAAY,EACV,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAKrG,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAK3E,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACpF,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAKxE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,aAAa,EACb,OAAO,EACP,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,oBAAoB,CAAC;AAK5B,YAAY,EACV,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-import{observe as t}from"./observe/index.js";import{observeErrors as n,registerMachineContext as s,unregisterMachineContext as i}from"./observe/index.js";import{observeCLS as v,observeLCP as a,observeFID as x,observeINP as b,observeFCP as c,observeTTFB as f,vitalObservers as m}from"./observe/index.js";import{createFetchTransport as d,createConsoleTransport as C}from"./transport/index.js";import{createMachine as j,createEvent as M}from"./machine/index.js";export{C as createConsoleTransport,M as createEvent,d as createFetchTransport,j as createMachine,t as observe,v as observeCLS,n as observeErrors,c as observeFCP,x as observeFID,b as observeINP,a as observeLCP,f as observeTTFB,s as registerMachineContext,i as unregisterMachineContext,m as vitalObservers};
+import{observe as t}from"./observe/index.js";import{createSampler as n,eventTypeToSamplingType as s}from"./observe/index.js";import{observeErrors as i,registerMachineContext as a,unregisterMachineContext as v}from"./observe/index.js";import{observeCLS as m,observeLCP as f,observeFID as b,observeINP as c,observeFCP as E,observeTTFB as T,vitalObservers as y}from"./observe/index.js";import{createFetchTransport as g,createConsoleTransport as l}from"./transport/index.js";import{createMachine as j,createEvent as S}from"./machine/index.js";export{l as createConsoleTransport,S as createEvent,g as createFetchTransport,j as createMachine,n as createSampler,s as eventTypeToSamplingType,t as observe,m as observeCLS,i as observeErrors,E as observeFCP,b as observeFID,c as observeINP,f as observeLCP,T as observeTTFB,a as registerMachineContext,v as unregisterMachineContext,y as vitalObservers};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["/**\n * \uD83E\uDEBF svoose - Observability + State Machines for Svelte 5\n *\n * @packageDocumentation\n */\n\n// ============================================\n// Core Observability\n// ============================================\nexport { observe } from './observe/index.js';\nexport type { ObserveOptions } from './observe/index.js';\n\n// ============================================\n// Error Tracking\n// ============================================\nexport {\n  observeErrors,\n  registerMachineContext,\n  unregisterMachineContext,\n} from './observe/index.js';\nexport type {\n  ObserveErrorEvent,\n  ErrorEvent,\n  UnhandledRejectionEvent,\n} from './observe/index.js';\n\n// ============================================\n// Web Vitals\n// ============================================\nexport {\n  observeCLS,\n  observeLCP,\n  observeFID,\n  observeINP,\n  observeFCP,\n  observeTTFB,\n  vitalObservers,\n} from './observe/index.js';\nexport type { Metric, MetricName, MetricRating } from './observe/index.js';\n\n// ============================================\n// Transport\n// ============================================\nexport { createFetchTransport, createConsoleTransport } from './transport/index.js';\nexport type { Transport, TransportOptions } from './transport/index.js';\n\n// ============================================\n// State Machines\n// ============================================\nexport { createMachine, createEvent } from './machine/index.js';\nexport type {\n  MachineConfig,\n  Machine,\n  EventObject,\n  StateNode,\n  TransitionConfig,\n  InferStates,\n  InferEvents,\n  InferContext,\n} from './machine/index.js';\n\n// ============================================\n// Shared Types\n// ============================================\nexport type {\n  VitalEvent,\n  TransitionEvent,\n  ObserveEvent,\n} from './types/index.js';\n"],
-  "mappings": "AASA,OAAS,WAAAA,MAAe,qBAMxB,OACE,iBAAAC,EACA,0BAAAC,EACA,4BAAAC,MACK,qBAUP,OACE,cAAAC,EACA,cAAAC,EACA,cAAAC,EACA,cAAAC,EACA,cAAAC,EACA,eAAAC,EACA,kBAAAC,MACK,qBAMP,OAAS,wBAAAC,EAAsB,0BAAAC,MAA8B,uBAM7D,OAAS,iBAAAC,EAAe,eAAAC,MAAmB",
-  "names": ["observe", "observeErrors", "registerMachineContext", "unregisterMachineContext", "observeCLS", "observeLCP", "observeFID", "observeINP", "observeFCP", "observeTTFB", "vitalObservers", "createFetchTransport", "createConsoleTransport", "createMachine", "createEvent"]
+  "sourcesContent": ["/**\n * \uD83E\uDEBF svoose - Observability + State Machines for Svelte 5\n *\n * @packageDocumentation\n */\n\n// ============================================\n// Core Observability\n// ============================================\nexport { observe } from './observe/index.js';\nexport type { ObserveOptions } from './observe/index.js';\n\n// ============================================\n// Sampling\n// ============================================\nexport { createSampler, eventTypeToSamplingType } from './observe/index.js';\nexport type { SamplingConfig, SamplingOption, SamplingEventType, Sampler } from './observe/index.js';\n\n// ============================================\n// Error Tracking\n// ============================================\nexport {\n  observeErrors,\n  registerMachineContext,\n  unregisterMachineContext,\n} from './observe/index.js';\nexport type {\n  ObserveErrorEvent,\n  ErrorEvent,\n  UnhandledRejectionEvent,\n} from './observe/index.js';\n\n// ============================================\n// Web Vitals\n// ============================================\nexport {\n  observeCLS,\n  observeLCP,\n  observeFID,\n  observeINP,\n  observeFCP,\n  observeTTFB,\n  vitalObservers,\n} from './observe/index.js';\nexport type { Metric, MetricName, MetricRating } from './observe/index.js';\n\n// ============================================\n// Transport\n// ============================================\nexport { createFetchTransport, createConsoleTransport } from './transport/index.js';\nexport type { Transport, TransportOptions } from './transport/index.js';\n\n// ============================================\n// State Machines\n// ============================================\nexport { createMachine, createEvent } from './machine/index.js';\nexport type {\n  MachineConfig,\n  Machine,\n  EventObject,\n  StateNode,\n  TransitionConfig,\n  InferStates,\n  InferEvents,\n  InferContext,\n} from './machine/index.js';\n\n// ============================================\n// Shared Types\n// ============================================\nexport type {\n  VitalEvent,\n  TransitionEvent,\n  ObserveEvent,\n} from './types/index.js';\n"],
+  "mappings": "AASA,OAAS,WAAAA,MAAe,qBAMxB,OAAS,iBAAAC,EAAe,2BAAAC,MAA+B,qBAMvD,OACE,iBAAAC,EACA,0BAAAC,EACA,4BAAAC,MACK,qBAUP,OACE,cAAAC,EACA,cAAAC,EACA,cAAAC,EACA,cAAAC,EACA,cAAAC,EACA,eAAAC,EACA,kBAAAC,MACK,qBAMP,OAAS,wBAAAC,EAAsB,0BAAAC,MAA8B,uBAM7D,OAAS,iBAAAC,EAAe,eAAAC,MAAmB",
+  "names": ["observe", "createSampler", "eventTypeToSamplingType", "observeErrors", "registerMachineContext", "unregisterMachineContext", "observeCLS", "observeLCP", "observeFID", "observeINP", "observeFCP", "observeTTFB", "vitalObservers", "createFetchTransport", "createConsoleTransport", "createMachine", "createEvent"]
 }

package/dist/observe/index.d.ts

@@ -7,4 +7,6 @@ export { observeErrors, registerMachineContext, unregisterMachineContext } from
 export type { ObserveErrorEvent, ErrorEvent, UnhandledRejectionEvent } from './errors.js';
 export { vitalObservers, observeCLS, observeLCP, observeFID, observeINP, observeFCP, observeTTFB } from './vitals.js';
 export type { Metric, MetricName, MetricRating } from './vitals.js';
+export { createSampler, eventTypeToSamplingType } from './sampling.js';
+export type { SamplingConfig, SamplingOption, SamplingEventType, Sampler } from './sampling.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/observe/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observe/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACpF,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC9F,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtH,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observe/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACpF,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC9F,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtH,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/observe/index.js

@@ -1,2 +1,2 @@
-import{observe as o,setGlobalObserver as t,getGlobalObserver as s}from"./observe.svelte.js";import{observeErrors as b,registerMachineContext as n,unregisterMachineContext as i}from"./errors.js";import{vitalObservers as a,observeCLS as l,observeLCP as x,observeFID as m,observeINP as c,observeFCP as f,observeTTFB as E}from"./vitals.js";export{s as getGlobalObserver,o as observe,l as observeCLS,b as observeErrors,f as observeFCP,m as observeFID,c as observeINP,x as observeLCP,E as observeTTFB,n as registerMachineContext,t as setGlobalObserver,i as unregisterMachineContext,a as vitalObservers};
+import{observe as o,setGlobalObserver as t,getGlobalObserver as s}from"./observe.svelte.js";import{observeErrors as n,registerMachineContext as v,unregisterMachineContext as i}from"./errors.js";import{vitalObservers as b,observeCLS as m,observeLCP as l,observeFID as g,observeINP as x,observeFCP as f,observeTTFB as c}from"./vitals.js";import{createSampler as E,eventTypeToSamplingType as O}from"./sampling.js";export{E as createSampler,O as eventTypeToSamplingType,s as getGlobalObserver,o as observe,m as observeCLS,n as observeErrors,f as observeFCP,g as observeFID,x as observeINP,l as observeLCP,c as observeTTFB,v as registerMachineContext,t as setGlobalObserver,i as unregisterMachineContext,b as vitalObservers};
 //# sourceMappingURL=index.js.map

package/dist/observe/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/observe/index.ts"],
-  "sourcesContent": ["/**\n * Observe module exports\n */\n\nexport { observe, setGlobalObserver, getGlobalObserver } from './observe.svelte.js';\nexport type { ObserveOptions } from './observe.svelte.js';\nexport { observeErrors, registerMachineContext, unregisterMachineContext } from './errors.js';\nexport type { ObserveErrorEvent, ErrorEvent, UnhandledRejectionEvent } from './errors.js';\nexport { vitalObservers, observeCLS, observeLCP, observeFID, observeINP, observeFCP, observeTTFB } from './vitals.js';\nexport type { Metric, MetricName, MetricRating } from './vitals.js';\n"],
-  "mappings": "AAIA,OAAS,WAAAA,EAAS,qBAAAC,EAAmB,qBAAAC,MAAyB,sBAE9D,OAAS,iBAAAC,EAAe,0BAAAC,EAAwB,4BAAAC,MAAgC,cAEhF,OAAS,kBAAAC,EAAgB,cAAAC,EAAY,cAAAC,EAAY,cAAAC,EAAY,cAAAC,EAAY,cAAAC,EAAY,eAAAC,MAAmB",
-  "names": ["observe", "setGlobalObserver", "getGlobalObserver", "observeErrors", "registerMachineContext", "unregisterMachineContext", "vitalObservers", "observeCLS", "observeLCP", "observeFID", "observeINP", "observeFCP", "observeTTFB"]
+  "sourcesContent": ["/**\n * Observe module exports\n */\n\nexport { observe, setGlobalObserver, getGlobalObserver } from './observe.svelte.js';\nexport type { ObserveOptions } from './observe.svelte.js';\nexport { observeErrors, registerMachineContext, unregisterMachineContext } from './errors.js';\nexport type { ObserveErrorEvent, ErrorEvent, UnhandledRejectionEvent } from './errors.js';\nexport { vitalObservers, observeCLS, observeLCP, observeFID, observeINP, observeFCP, observeTTFB } from './vitals.js';\nexport type { Metric, MetricName, MetricRating } from './vitals.js';\nexport { createSampler, eventTypeToSamplingType } from './sampling.js';\nexport type { SamplingConfig, SamplingOption, SamplingEventType, Sampler } from './sampling.js';\n"],
+  "mappings": "AAIA,OAAS,WAAAA,EAAS,qBAAAC,EAAmB,qBAAAC,MAAyB,sBAE9D,OAAS,iBAAAC,EAAe,0BAAAC,EAAwB,4BAAAC,MAAgC,cAEhF,OAAS,kBAAAC,EAAgB,cAAAC,EAAY,cAAAC,EAAY,cAAAC,EAAY,cAAAC,EAAY,cAAAC,EAAY,eAAAC,MAAmB,cAExG,OAAS,iBAAAC,EAAe,2BAAAC,MAA+B",
+  "names": ["observe", "setGlobalObserver", "getGlobalObserver", "observeErrors", "registerMachineContext", "unregisterMachineContext", "vitalObservers", "observeCLS", "observeLCP", "observeFID", "observeINP", "observeFCP", "observeTTFB", "createSampler", "eventTypeToSamplingType"]
 }

package/dist/observe/observe.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observe.svelte.d.ts","sourceRoot":"","sources":["../../src/observe/observe.svelte.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAc,YAAY,EAAa,MAAM,mBAAmB,CAAC;AAc7F,QAAA,IAAI,sBAAsB,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAW,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,sBAAsB,GAAG,IAAI,CAE/E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,sBAAsB,CAEjE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,MAAM,IAAI,CAqIhE;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"observe.svelte.d.ts","sourceRoot":"","sources":["../../src/observe/observe.svelte.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAc,YAAY,EAAa,MAAM,mBAAmB,CAAC;AAc7F,QAAA,IAAI,sBAAsB,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAW,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,sBAAsB,GAAG,IAAI,CAE/E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,sBAAsB,CAEjE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,MAAM,IAAI,CAkJhE;AAED,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/observe/observe.svelte.js

@@ -1,2 +1,2 @@
-import{vitalObservers as h}from"./vitals.js";import{observeErrors as m}from"./errors.js";import{createFetchTransport as O}from"../transport/fetch.js";const f={endpoint:"/api/observe",vitals:!0,errors:!0,batchSize:10,flushInterval:5e3,sampleRate:1,debug:!1};let c=null;function u(i){c=i}function T(){return c}function I(i={}){if(Math.random()>(i.sampleRate??f.sampleRate))return()=>{};const t={...f,...i},p=t.transport??O(t.endpoint),r=[],o=[];let a=null;const d=()=>{try{return typeof location<"u"?location.href:""}catch{return""}},v=e=>{t.filter&&!t.filter(e)||(t.debug&&console.log("[svoose]",e),o.push(e),o.length>=t.batchSize&&s())},s=()=>{if(o.length===0)return;const e=o.splice(0,o.length),n=p.send(e);n&&typeof n.catch=="function"&&n.catch(l=>{t.debug&&console.error("[svoose] transport error:",l)})},b=e=>{const n={type:"vital",name:e.name,value:e.value,rating:e.rating,delta:e.delta,timestamp:e.timestamp,url:d()};v(n)};if(t.vitals){const e=t.vitals===!0?["CLS","LCP","FID","INP","FCP","TTFB"]:t.vitals;for(const n of e){const l=h[n];l&&r.push(l(b))}}if(t.errors&&r.push(m(e=>{v(e)})),u(v),r.push(()=>u(null)),a=setInterval(s,t.flushInterval),r.push(()=>{a&&clearInterval(a)}),typeof document<"u"){const e=()=>{document.visibilityState==="hidden"&&s()};document.addEventListener("visibilitychange",e),r.push(()=>{document.removeEventListener("visibilitychange",e)})}if(typeof window<"u"){const e=()=>{s()};window.addEventListener("beforeunload",e),r.push(()=>{window.removeEventListener("beforeunload",e)})}return()=>{s(),r.forEach(e=>e())}}export{T as getGlobalObserver,I as observe,u as setGlobalObserver};
+import{vitalObservers as h}from"./vitals.js";import{observeErrors as y}from"./errors.js";import{createFetchTransport as g}from"../transport/fetch.js";import{createSampler as O,eventTypeToSamplingType as E}from"./sampling.js";const u={endpoint:"/api/observe",vitals:!0,errors:!0,batchSize:10,flushInterval:5e3,sampleRate:1,debug:!1};let c=null;function f(i){c=i}function C(){return c}function L(i={}){if(Math.random()>(i.sampleRate??u.sampleRate))return()=>{};const t={...u,...i},d=t.transport??g(t.endpoint),p=t.sampling!=null?O(t.sampling):null,n=[],o=[];let a=null;const b=()=>{try{return typeof location<"u"?location.href:""}catch{return""}},v=e=>{if(!(t.filter&&!t.filter(e))){if(p){const r=E(e.type);if(r&&!p.shouldSample(r))return}t.debug&&console.log("[svoose]",e),o.push(e),o.length>=t.batchSize&&s()}},s=()=>{if(o.length===0)return;const e=o.splice(0,o.length),r=d.send(e);r&&typeof r.catch=="function"&&r.catch(l=>{t.debug&&console.error("[svoose] transport error:",l)})},m=e=>{const r={type:"vital",name:e.name,value:e.value,rating:e.rating,delta:e.delta,timestamp:e.timestamp,url:b()};v(r)};if(t.vitals){const e=t.vitals===!0?["CLS","LCP","FID","INP","FCP","TTFB"]:t.vitals;for(const r of e){const l=h[r];l&&n.push(l(m))}}if(t.errors&&n.push(y(e=>{v(e)})),f(v),n.push(()=>f(null)),a=setInterval(s,t.flushInterval),n.push(()=>{a&&clearInterval(a)}),typeof document<"u"){const e=()=>{document.visibilityState==="hidden"&&s()};document.addEventListener("visibilitychange",e),n.push(()=>{document.removeEventListener("visibilitychange",e)})}if(typeof window<"u"){const e=()=>{s()};window.addEventListener("beforeunload",e),n.push(()=>{window.removeEventListener("beforeunload",e)})}return()=>{s(),n.forEach(e=>e())}}export{C as getGlobalObserver,L as observe,f as setGlobalObserver};
 //# sourceMappingURL=observe.svelte.js.map

package/dist/observe/observe.svelte.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/observe/observe.svelte.ts"],
-  "sourcesContent": ["/**\n * Main observe() function - combines vitals, errors, and transport\n */\n\nimport { vitalObservers, type Metric, type MetricName } from './vitals.js';\nimport { observeErrors, type ObserveErrorEvent } from './errors.js';\nimport { createFetchTransport } from '../transport/fetch.js';\nimport type { ObserveOptions, VitalEvent, ObserveEvent, Transport } from '../types/index.js';\n\n// Default configuration\nconst defaults = {\n  endpoint: '/api/observe',\n  vitals: true as const,\n  errors: true,\n  batchSize: 10,\n  flushInterval: 5000,\n  sampleRate: 1,\n  debug: false,\n} satisfies Required<Omit<ObserveOptions, 'transport' | 'filter'>>;\n\n// Global observer callback for state machines\nlet globalObserverCallback: ((event: ObserveEvent) => void) | null = null;\n\n/**\n * Set global observer callback for state machines\n * Called internally to connect machines to observe()\n */\nexport function setGlobalObserver(callback: typeof globalObserverCallback): void {\n  globalObserverCallback = callback;\n}\n\n/**\n * Get global observer callback\n * Used by createMachine to send transition events\n */\nexport function getGlobalObserver(): typeof globalObserverCallback {\n  return globalObserverCallback;\n}\n\n/**\n * Main observe function - starts collecting metrics and errors\n *\n * @param options - Configuration options\n * @returns Cleanup function to stop observing\n *\n * @example\n * // Basic usage\n * observe();\n *\n * @example\n * // With options\n * observe({\n *   endpoint: '/api/metrics',\n *   vitals: ['CLS', 'LCP', 'INP'],\n *   errors: true,\n *   debug: true,\n * });\n */\nexport function observe(options: ObserveOptions = {}): () => void {\n  // Check sampling rate\n  if (Math.random() > (options.sampleRate ?? defaults.sampleRate)) {\n    return () => {};\n  }\n\n  const config = { ...defaults, ...options };\n  const transport: Transport = config.transport ?? createFetchTransport(config.endpoint);\n\n  const cleanups: (() => void)[] = [];\n  const buffer: ObserveEvent[] = [];\n  let flushTimer: ReturnType<typeof setInterval> | null = null;\n\n  // Get current URL\n  const getUrl = (): string => {\n    try {\n      return typeof location !== 'undefined' ? location.href : '';\n    } catch {\n      return '';\n    }\n  };\n\n  // Buffer an event and potentially flush\n  const bufferEvent = (event: ObserveEvent): void => {\n    // Apply filter if provided\n    if (config.filter && !config.filter(event)) {\n      return;\n    }\n\n    if (config.debug) {\n      console.log('[svoose]', event);\n    }\n\n    buffer.push(event);\n\n    if (buffer.length >= config.batchSize) {\n      flush();\n    }\n  };\n\n  // Send buffered events to transport\n  const flush = (): void => {\n    if (buffer.length === 0) return;\n\n    const events = buffer.splice(0, buffer.length);\n    // Handle both Promise and non-Promise returns from transport.send()\n    const result = transport.send(events);\n    if (result && typeof result.catch === 'function') {\n      result.catch((err) => {\n        if (config.debug) {\n          console.error('[svoose] transport error:', err);\n        }\n      });\n    }\n  };\n\n  // Convert metric to vital event\n  const handleMetric = (metric: Metric): void => {\n    const vitalEvent: VitalEvent = {\n      type: 'vital',\n      name: metric.name,\n      value: metric.value,\n      rating: metric.rating,\n      delta: metric.delta,\n      timestamp: metric.timestamp,\n      url: getUrl(),\n    };\n    bufferEvent(vitalEvent);\n  };\n\n  // Setup vitals observers\n  if (config.vitals) {\n    const vitalsToObserve: MetricName[] =\n      config.vitals === true\n        ? ['CLS', 'LCP', 'FID', 'INP', 'FCP', 'TTFB']\n        : config.vitals;\n\n    for (const name of vitalsToObserve) {\n      const observer = vitalObservers[name];\n      if (observer) {\n        cleanups.push(observer(handleMetric));\n      }\n    }\n  }\n\n  // Setup error observer\n  if (config.errors) {\n    cleanups.push(\n      observeErrors((event: ObserveErrorEvent) => {\n        bufferEvent(event);\n      })\n    );\n  }\n\n  // Setup global observer for state machines\n  setGlobalObserver(bufferEvent);\n  cleanups.push(() => setGlobalObserver(null));\n\n  // Setup flush interval\n  flushTimer = setInterval(flush, config.flushInterval);\n  cleanups.push(() => {\n    if (flushTimer) clearInterval(flushTimer);\n  });\n\n  // Flush on page visibility change (user navigating away)\n  if (typeof document !== 'undefined') {\n    const visibilityHandler = (): void => {\n      if (document.visibilityState === 'hidden') {\n        flush();\n      }\n    };\n    document.addEventListener('visibilitychange', visibilityHandler);\n    cleanups.push(() => {\n      document.removeEventListener('visibilitychange', visibilityHandler);\n    });\n  }\n\n  // Flush on beforeunload\n  if (typeof window !== 'undefined') {\n    const unloadHandler = (): void => {\n      flush();\n    };\n    window.addEventListener('beforeunload', unloadHandler);\n    cleanups.push(() => {\n      window.removeEventListener('beforeunload', unloadHandler);\n    });\n  }\n\n  // Return cleanup function\n  return () => {\n    flush();\n    cleanups.forEach((fn) => fn());\n  };\n}\n\nexport type { ObserveOptions };\n"],
-  "mappings": "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",
-  "names": ["vitalObservers", "observeErrors", "createFetchTransport", "defaults", "globalObserverCallback", "setGlobalObserver", "callback", "getGlobalObserver", "observe", "options", "config", "transport", "cleanups", "buffer", "flushTimer", "getUrl", "bufferEvent", "event", "flush", "events", "result", "err", "handleMetric", "metric", "vitalEvent", "vitalsToObserve", "name", "observer", "visibilityHandler", "unloadHandler", "fn"]
+  "sourcesContent": ["/**\n * Main observe() function - combines vitals, errors, and transport\n */\n\nimport { vitalObservers, type Metric, type MetricName } from './vitals.js';\nimport { observeErrors, type ObserveErrorEvent } from './errors.js';\nimport { createFetchTransport } from '../transport/fetch.js';\nimport {\n  createSampler,\n  eventTypeToSamplingType,\n  type Sampler,\n} from './sampling.js';\nimport type { ObserveOptions, VitalEvent, ObserveEvent, Transport } from '../types/index.js';\n\n// Default configuration\nconst defaults = {\n  endpoint: '/api/observe',\n  vitals: true as const,\n  errors: true,\n  batchSize: 10,\n  flushInterval: 5000,\n  sampleRate: 1,\n  debug: false,\n} satisfies Required<Omit<ObserveOptions, 'transport' | 'filter' | 'sampling'>>;\n\n// Global observer callback for state machines\nlet globalObserverCallback: ((event: ObserveEvent) => void) | null = null;\n\n/**\n * Set global observer callback for state machines\n * Called internally to connect machines to observe()\n */\nexport function setGlobalObserver(callback: typeof globalObserverCallback): void {\n  globalObserverCallback = callback;\n}\n\n/**\n * Get global observer callback\n * Used by createMachine to send transition events\n */\nexport function getGlobalObserver(): typeof globalObserverCallback {\n  return globalObserverCallback;\n}\n\n/**\n * Main observe function - starts collecting metrics and errors\n *\n * @param options - Configuration options\n * @returns Cleanup function to stop observing\n *\n * @example\n * // Basic usage\n * observe();\n *\n * @example\n * // With options\n * observe({\n *   endpoint: '/api/metrics',\n *   vitals: ['CLS', 'LCP', 'INP'],\n *   errors: true,\n *   debug: true,\n * });\n */\nexport function observe(options: ObserveOptions = {}): () => void {\n  // Legacy sampleRate support (deprecated) - skip entire observer\n  if (Math.random() > (options.sampleRate ?? defaults.sampleRate)) {\n    return () => {};\n  }\n\n  const config = { ...defaults, ...options };\n  const transport: Transport = config.transport ?? createFetchTransport(config.endpoint);\n\n  // Create sampler if sampling option is provided\n  const sampler: Sampler | null = config.sampling != null\n    ? createSampler(config.sampling)\n    : null;\n\n  const cleanups: (() => void)[] = [];\n  const buffer: ObserveEvent[] = [];\n  let flushTimer: ReturnType<typeof setInterval> | null = null;\n\n  // Get current URL\n  const getUrl = (): string => {\n    try {\n      return typeof location !== 'undefined' ? location.href : '';\n    } catch {\n      return '';\n    }\n  };\n\n  // Buffer an event and potentially flush\n  const bufferEvent = (event: ObserveEvent): void => {\n    // Apply filter if provided\n    if (config.filter && !config.filter(event)) {\n      return;\n    }\n\n    // Apply per-event-type sampling\n    if (sampler) {\n      const samplingType = eventTypeToSamplingType(event.type);\n      if (samplingType && !sampler.shouldSample(samplingType)) {\n        return;\n      }\n    }\n\n    if (config.debug) {\n      console.log('[svoose]', event);\n    }\n\n    buffer.push(event);\n\n    if (buffer.length >= config.batchSize) {\n      flush();\n    }\n  };\n\n  // Send buffered events to transport\n  const flush = (): void => {\n    if (buffer.length === 0) return;\n\n    const events = buffer.splice(0, buffer.length);\n    // Handle both Promise and non-Promise returns from transport.send()\n    const result = transport.send(events);\n    if (result && typeof result.catch === 'function') {\n      result.catch((err) => {\n        if (config.debug) {\n          console.error('[svoose] transport error:', err);\n        }\n      });\n    }\n  };\n\n  // Convert metric to vital event\n  const handleMetric = (metric: Metric): void => {\n    const vitalEvent: VitalEvent = {\n      type: 'vital',\n      name: metric.name,\n      value: metric.value,\n      rating: metric.rating,\n      delta: metric.delta,\n      timestamp: metric.timestamp,\n      url: getUrl(),\n    };\n    bufferEvent(vitalEvent);\n  };\n\n  // Setup vitals observers\n  if (config.vitals) {\n    const vitalsToObserve: MetricName[] =\n      config.vitals === true\n        ? ['CLS', 'LCP', 'FID', 'INP', 'FCP', 'TTFB']\n        : config.vitals;\n\n    for (const name of vitalsToObserve) {\n      const observer = vitalObservers[name];\n      if (observer) {\n        cleanups.push(observer(handleMetric));\n      }\n    }\n  }\n\n  // Setup error observer\n  if (config.errors) {\n    cleanups.push(\n      observeErrors((event: ObserveErrorEvent) => {\n        bufferEvent(event);\n      })\n    );\n  }\n\n  // Setup global observer for state machines\n  setGlobalObserver(bufferEvent);\n  cleanups.push(() => setGlobalObserver(null));\n\n  // Setup flush interval\n  flushTimer = setInterval(flush, config.flushInterval);\n  cleanups.push(() => {\n    if (flushTimer) clearInterval(flushTimer);\n  });\n\n  // Flush on page visibility change (user navigating away)\n  if (typeof document !== 'undefined') {\n    const visibilityHandler = (): void => {\n      if (document.visibilityState === 'hidden') {\n        flush();\n      }\n    };\n    document.addEventListener('visibilitychange', visibilityHandler);\n    cleanups.push(() => {\n      document.removeEventListener('visibilitychange', visibilityHandler);\n    });\n  }\n\n  // Flush on beforeunload\n  if (typeof window !== 'undefined') {\n    const unloadHandler = (): void => {\n      flush();\n    };\n    window.addEventListener('beforeunload', unloadHandler);\n    cleanups.push(() => {\n      window.removeEventListener('beforeunload', unloadHandler);\n    });\n  }\n\n  // Return cleanup function\n  return () => {\n    flush();\n    cleanups.forEach((fn) => fn());\n  };\n}\n\nexport type { ObserveOptions };\n"],
+  "mappings": "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",
+  "names": ["vitalObservers", "observeErrors", "createFetchTransport", "createSampler", "eventTypeToSamplingType", "defaults", "globalObserverCallback", "setGlobalObserver", "callback", "getGlobalObserver", "observe", "options", "config", "transport", "sampler", "cleanups", "buffer", "flushTimer", "getUrl", "bufferEvent", "event", "samplingType", "flush", "events", "result", "err", "handleMetric", "metric", "vitalEvent", "vitalsToObserve", "name", "observer", "visibilityHandler", "unloadHandler", "fn"]
 }

package/dist/observe/sampling.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Sampling utilities for rate limiting events by type
+ */
+/**
+ * Per-event-type sampling rates
+ * Each rate is a number between 0 and 1 (0 = disabled, 1 = all)
+ */
+export interface SamplingConfig {
+    /** Sampling rate for Web Vitals events (default: 1) */
+    vitals?: number;
+    /** Sampling rate for error events (default: 1) */
+    errors?: number;
+    /** Sampling rate for custom metric events (default: 1) */
+    custom?: number;
+    /** Sampling rate for state machine transition events (default: 1) */
+    transitions?: number;
+    /** Sampling rate for identify events (default: 1) */
+    identify?: number;
+}
+/**
+ * Sampling option - either a single rate for all events or per-type config
+ */
+export type SamplingOption = number | SamplingConfig;
+/**
+ * Event types that can be sampled
+ */
+export type SamplingEventType = keyof SamplingConfig;
+/**
+ * Sampler interface returned by createSampler
+ */
+export interface Sampler {
+    /**
+     * Check if an event should be sampled (included)
+     * @param eventType - The type of event
+     * @returns true if the event should be included, false if dropped
+     */
+    shouldSample(eventType: SamplingEventType): boolean;
+    /**
+     * Get the sampling rate for an event type
+     * @param eventType - The type of event
+     * @returns The rate (0-1)
+     */
+    getRate(eventType: SamplingEventType): number;
+}
+/**
+ * Create a sampler instance for filtering events by sampling rate
+ *
+ * @param config - Sampling configuration (number or per-type config)
+ * @returns Sampler instance
+ *
+ * @example
+ * // Simple - same rate for all events
+ * const sampler = createSampler(0.1); // 10% of all events
+ *
+ * @example
+ * // Per-event-type rates
+ * const sampler = createSampler({
+ *   vitals: 0.1,       // 10% of vitals
+ *   errors: 1.0,       // 100% of errors
+ *   custom: 0.5,       // 50% of custom metrics
+ *   transitions: 0.0,  // disabled
+ * });
+ */
+export declare function createSampler(config: SamplingOption): Sampler;
+/**
+ * Map ObserveEvent.type to SamplingEventType
+ */
+export declare function eventTypeToSamplingType(eventType: string): SamplingEventType | null;
+//# sourceMappingURL=sampling.d.ts.map

package/dist/observe/sampling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling.d.ts","sourceRoot":"","sources":["../../src/observe/sampling.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,cAAc,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,cAAc,CAAC;AAMrD;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAEpD;;;;OAIG;IACH,OAAO,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAAC;CAC/C;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAmC7D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB,iBAAiB,GAAG,IAAI,CAgB1B"}

package/dist/types/index.d.ts

@@ -55,6 +55,26 @@ export interface TransportOptions {
     headers?: Record<string, string>;
     onError?: (error: Error) => void;
 }
+/**
+ * Per-event-type sampling rates
+ * Each rate is a number between 0 and 1 (0 = disabled, 1 = all)
+ */
+export interface SamplingConfig {
+    /** Sampling rate for Web Vitals events (default: 1) */
+    vitals?: number;
+    /** Sampling rate for error events (default: 1) */
+    errors?: number;
+    /** Sampling rate for custom metric events (default: 1) */
+    custom?: number;
+    /** Sampling rate for state machine transition events (default: 1) */
+    transitions?: number;
+    /** Sampling rate for identify events (default: 1) */
+    identify?: number;
+}
+/**
+ * Sampling option - either a single rate for all events or per-type config
+ */
+export type SamplingOption = number | SamplingConfig;
 export interface ObserveOptions {
     /** URL endpoint for sending data */
     endpoint?: string;
@@ -70,7 +90,27 @@ export interface ObserveOptions {
     flushInterval?: number;
     /** Filter function for events */
     filter?: (event: ObserveEvent) => boolean;
-    /** Sampling rate (0-1) */
+    /**
+     * Per-event-type sampling rates
+     *
+     * @example
+     * // Simple - same rate for all events
+     * sampling: 0.1 // 10% of all events
+     *
+     * @example
+     * // Per-event-type rates (recommended)
+     * sampling: {
+     *   vitals: 0.1,       // 10% - sufficient for statistics
+     *   errors: 1.0,       // 100% - all errors matter
+     *   custom: 0.5,       // 50%
+     *   transitions: 0.0,  // disabled
+     * }
+     */
+    sampling?: SamplingOption;
+    /**
+     * @deprecated Use `sampling` instead. Will be removed in v0.3.0.
+     * Global sampling rate (0-1) - applies to entire observer
+     */
     sampleRate?: number;
     /** Log to console */
     debug?: boolean;

package/dist/types/index.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svoose",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Observability + State Machines for Svelte 5 — the goose that sees everything",
   "type": "module",
   "main": "./dist/index.js",