@graphysdk/telemetry

Optional usage events from a compiled Graphy chart. This package never sends data anywhere — you subscribe and decide what to do with each event.

Events carry counts and flags only. They never include your data values, column names, or labels.

Learn more at graphy.dev.

Install

npm install @graphysdk/telemetry

Usage

import { createCompiler } from '@graphysdk/viz-engine';
import { createTelemetryEmitter, emitCompileEvents } from '@graphysdk/telemetry';

const telemetry = createTelemetryEmitter();
const subscription = telemetry.subscribe((event) => {
  // send or record the event yourself
});

const result = createCompiler().compile({ input, data });
emitCompileEvents(telemetry, result, 'compile');

subscription.unsubscribe();

createTelemetryEmitter accepts { chartInstanceId, engineVersion, enabled }. Pass 'compile', 'recompile', or 'command' as the third argument to emitCompileEvents.

Docs

• Quickstart

In a React host, subscribe to a GraphHandle (handle.subscribe() + handle.getCompiled()) and call deriveChartShape / emitCompileEvents from the listener.

Agent skills

Install the Graphy agent skills from github.com/graphysdk/skills to set up the SDK and author charts from Cursor, Claude Code, and other coding agents.

Licence

This package is available under PolyForm Noncommercial, Small Business, or a 32-day Free Trial. Free Trial is local or internal evaluation only — it does not cover a public page. See what you can do under the trial.

For a commercial licence, talk to us.

Support

Questions and community help: Discord.