Files
zeekayandHanzo Dev 629db23fd0 event: raise the floor to ^0.3.3 (>=0.3.2 has the error envelope)
@hanzo/event <=0.3.1 shipped NO Sentry envelope code — captureError() collected
and dropped. 0.3.2 added it.

This repo already RESOLVED to 0.3.3 (the caret ranges permit it), so nothing
changes here at install time. The defect is in what the observe packages
PUBLISH: declaring ^0.3.0 lets any downstream consumer legitimately resolve to
0.3.0 or 0.3.1 and silently get a dead error plane. The floor now states the
real requirement.

pnpm install --frozen-lockfile green; @hanzo/observe 28 tests pass.

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-26 23:47:07 -07:00
..

@hanzo/observe-svelte

Svelte adaptor for @hanzo/observe. Same engine, same semantic capture, same ONE front door (POST /v1/event via @hanzo/event) — bound to Svelte idioms: a bootstrap, an action, and a store.

Bootstrap

Start capture once, in a root layout, with a @hanzo/event client:

<!-- +layout.svelte -->
<script>
  import { onMount } from 'svelte'
  import { createAnalytics } from '@hanzo/event'
  import { createObserver } from '@hanzo/observe-svelte'

  onMount(() => createObserver(createAnalytics({ product: 'app' })))
</script>

<slot />

Every click, input, navigation, and (opt-in) visibility across the app is now captured, annotated with its semantic hierarchy, and emitted through the client. createObserver is idempotent and SSR-safe.

The observe action

Svelte components have no stable runtime name, so stamp one — the engine then labels every interaction inside the node with it:

<script>
  import { observe } from '@hanzo/observe-svelte'
</script>

<section use:observe={{ name: 'UserCard' }}>
  <button>Save</button>   <!-- captured as UserCard/button[Save] -->
</section>

<div use:observe={{ private: true }}>…</div>   <!-- excluded from capture -->
<div use:observe={{ view: true }}>…</div>       <!-- $view when it scrolls in -->

Session playback

stream is a Svelte-readable store over the live capture stream — a rolling window for a playback timeline:

<script>
  import { stream } from '@hanzo/observe-svelte'
  const events = stream({ limit: 200 })
</script>

<ol>
  {#each $events as e}
    <li>{e.name} → {e.semantic.label}</li>
  {/each}
</ol>

Privacy

Inherited from @hanzo/observe: input values are withheld by default, sensitive fields are always redacted, and data-hz-private (or use:observe={{ private: true }}) excludes a subtree. Everything is fail-soft.

License

BSD-3-Clause © Hanzo AI