@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({ spec: 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
In a React host, subscribe to a GraphHandle (handle.subscribe() + handle.getScene()) 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.