@graphysdk/telemetry 1.8.1-beta.1787065194945 → 1.8.1-beta.1787132472323

package/README.md

@@ -1,29 +1,14 @@
 # @graphysdk/telemetry
 
-A **pure, push-based** telemetry module for the Graphy chart engine. It derives anonymised usage events
-from viz-engine's public compiler output (`CompiledSpec` / `CompileResult`) — it does **not** modify or
-depend on viz-engine internals, and it never touches the network, storage, or timers.
+Optional usage events from a compiled Graphy chart. This package never sends data anywhere — you subscribe and decide what to do with each event.
 
-Identity, opt-out policy, sampling, and beaconing (if any) live in the wrapper/host that subscribes to
-these events — not in this package.
+Events carry counts and flags only. They never include your data values, column names, or labels.
 
-## Docs
-
-- [Quickstart](https://docs.graphy.dev/sdk-next/quickstart)
+## Install
 
-## Guarantees
-
-- **No network, no storage, no timers.** The module only _derives_ and _emits_. Anything with a side
-  effect is the subscriber's job.
-- **Anonymised by construction.** Every payload carries only counts, enums, and booleans derived from
-  `CompiledSpec`. Data values, column names/labels, annotation content, and formatted strings never
-  cross the boundary. An allowlist test asserts no dataset string leaks into a serialized event.
-- **Zero-overhead when unused.** Don't wire an emitter and nothing happens. `emit` is also a no-op when
-  disabled or when nobody is subscribed.
-- **Listener isolation.** A throwing subscriber can never break the caller — each listener call is
-  wrapped in `try/catch`.
-- **Leak-safe subscriptions.** `subscribe` returns a `VizTelemetrySubscription` (with `unsubscribe()`,
-  a `closed` flag, and `[Symbol.dispose]` for `using`).
+```bash
+npm install @graphysdk/telemetry
+```
 
 ## Usage
 
@@ -31,17 +16,26 @@ these events — not in this package.
 import { createCompiler } from '@graphysdk/viz-engine';
 import { createTelemetryEmitter, emitCompileEvents } from '@graphysdk/telemetry';
 
-const telemetry = createTelemetryEmitter(); // { chartInstanceId?, engineVersion?, enabled? }
+const telemetry = createTelemetryEmitter();
 const subscription = telemetry.subscribe((event) => {
-  // Defer any beaconing — subscribers must not block.
+  // send or record the event yourself
 });
 
-const compiler = createCompiler();
-const result = compiler.compile({ input, data });
-emitCompileEvents(telemetry, result, 'compile'); // 'compile' | 'recompile' | 'command'
+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](https://docs.graphy.dev/sdk-next/quickstart)
+
 In a React host, subscribe to a `GraphHandle` (`handle.subscribe()` + `handle.getCompiled()`) and
 call `deriveChartShape` / `emitCompileEvents` from the listener.
+
+## Support
+
+Questions and community help: [Discord](https://discord.gg/yGmYCjkSr).

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var m="1.8.1-beta.1787065194945",u=0;function y(e={}){f();const{chartInstanceId:t=b(),engineVersion:s=m,enabled:i=!0}=e,r=new Set;return{chartInstanceId:t,engineVersion:s,emit:a=>{if(!i||r.size===0)return;const o=[...r];for(const n of o)try{n(a)}catch{}},subscribe:a=>{r.add(a);let o=!1;const n=()=>{o||(o=!0,r.delete(a))};return{get closed(){return o},unsubscribe:n,[Symbol.dispose]:n}}}}var b=()=>`${Math.random().toString(36).slice(2,6)}${(u+=1).toString(36)}`,f=()=>{Symbol.dispose??=Symbol.for("Symbol.dispose")};function p(e){const{layers:t,coordSystem:s,scales:i,guides:r,annotations:l,spec:d}=e,a=r.colorGroups.length>0?r.colorGroups.length:null,o=t.reduce((n,g)=>n+g.data.size(),0);return{layerCount:t.length,geoms:t.map(n=>n.geom),positions:v(t.map(n=>n.position)),coordSystem:s.type,...s.type==="cartesian"?{mainAxis:s.mainAxis}:{},scaleAesthetics:Object.keys(i),seriesCount:a,observationCount:o,hasSecondaryAxis:t.some(n=>n.yScaleType==="secondary"),features:{headline:r.headline!==null,legend:r.legends.drawn.length>0,visibleAxes:r.axes.filter(n=>n.isVisible).length,dataLabels:t.some(n=>n.dataLabels.showDataLabels),highlights:d.highlights.length,annotations:C(l)}}}function S(e,t,s){if(!e)return;const i=h(e);if(t.ok){e.emit({...i,type:"chart.compiled",trigger:s,chart:p(t.compiled),warningCodes:c(t.warnings)});return}e.emit({...i,type:"chart.compile_failed",trigger:s,errorCodes:c(t.errors),warningCodes:c(t.warnings)})}function A(e,t,s){e&&e.emit({...h(e),type:"command.applied",commandType:t.type,transient:s})}var c=e=>e.map(t=>t.code),v=e=>[...new Set(e)],C=e=>({differenceArrows:e.differenceArrows.length,shapes:e.shapes.length,freeformArrows:e.arrows.length,textAnnotations:e.textAnnotations.length,images:e.images.length,stickers:e.stickers.length,pinnedNumbers:e.pinnedNumbers.length,comments:e.comments.length}),h=e=>({timestamp:Date.now(),engineVersion:e.engineVersion,chartInstanceId:e.chartInstanceId});exports.PACKAGE_VERSION=m;exports.createTelemetryEmitter=y;exports.deriveChartShape=p;exports.emitCommandApplied=A;exports.emitCompileEvents=S;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var m="1.8.1-beta.1787132472323",u=0;function y(e={}){f();const{chartInstanceId:t=b(),engineVersion:s=m,enabled:i=!0}=e,r=new Set;return{chartInstanceId:t,engineVersion:s,emit:a=>{if(!i||r.size===0)return;const o=[...r];for(const n of o)try{n(a)}catch{}},subscribe:a=>{r.add(a);let o=!1;const n=()=>{o||(o=!0,r.delete(a))};return{get closed(){return o},unsubscribe:n,[Symbol.dispose]:n}}}}var b=()=>`${Math.random().toString(36).slice(2,6)}${(u+=1).toString(36)}`,f=()=>{Symbol.dispose??=Symbol.for("Symbol.dispose")};function p(e){const{layers:t,coordSystem:s,scales:i,guides:r,annotations:l,spec:d}=e,a=r.colorGroups.length>0?r.colorGroups.length:null,o=t.reduce((n,g)=>n+g.data.size(),0);return{layerCount:t.length,geoms:t.map(n=>n.geom),positions:v(t.map(n=>n.position)),coordSystem:s.type,...s.type==="cartesian"?{mainAxis:s.mainAxis}:{},scaleAesthetics:Object.keys(i),seriesCount:a,observationCount:o,hasSecondaryAxis:t.some(n=>n.yScaleType==="secondary"),features:{headline:r.headline!==null,legend:r.legends.drawn.length>0,visibleAxes:r.axes.filter(n=>n.isVisible).length,dataLabels:t.some(n=>n.dataLabels.showDataLabels),highlights:d.highlights.length,annotations:C(l)}}}function S(e,t,s){if(!e)return;const i=h(e);if(t.ok){e.emit({...i,type:"chart.compiled",trigger:s,chart:p(t.compiled),warningCodes:c(t.warnings)});return}e.emit({...i,type:"chart.compile_failed",trigger:s,errorCodes:c(t.errors),warningCodes:c(t.warnings)})}function A(e,t,s){e&&e.emit({...h(e),type:"command.applied",commandType:t.type,transient:s})}var c=e=>e.map(t=>t.code),v=e=>[...new Set(e)],C=e=>({differenceArrows:e.differenceArrows.length,shapes:e.shapes.length,freeformArrows:e.arrows.length,textAnnotations:e.textAnnotations.length,images:e.images.length,stickers:e.stickers.length,pinnedNumbers:e.pinnedNumbers.length,comments:e.comments.length}),h=e=>({timestamp:Date.now(),engineVersion:e.engineVersion,chartInstanceId:e.chartInstanceId});exports.PACKAGE_VERSION=m;exports.createTelemetryEmitter=y;exports.deriveChartShape=p;exports.emitCommandApplied=A;exports.emitCompileEvents=S;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-var p = "1.8.1-beta.1787065194945", g = 0;
+var p = "1.8.1-beta.1787132472323", g = 0;
 function A(e = {}) {
   b();
   const { chartInstanceId: n = u(), engineVersion: t = p, enabled: i = !0 } = e, r = /* @__PURE__ */ new Set();

package/package.json

@@ -11,7 +11,7 @@
     "chart",
     "events"
   ],
-  "version": "1.8.1-beta.1787065194945",
+  "version": "1.8.1-beta.1787132472323",
   "type": "module",
   "sideEffects": false,
   "types": "./dist/index.d.ts",
@@ -29,7 +29,7 @@
     }
   },
   "peerDependencies": {
-    "@graphysdk/viz-engine": "1.8.1-beta.1787065194945"
+    "@graphysdk/viz-engine": "1.8.1-beta.1787132472323"
   },
   "devDependencies": {
     "@rollup/plugin-replace": "^6.0.3",
@@ -38,7 +38,7 @@
     "vite": "^8.1.5",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^4.1.0",
-    "@graphysdk/viz-engine": "1.8.1-beta.1787065194945",
+    "@graphysdk/viz-engine": "1.8.1-beta.1787132472323",
     "@graphytools/eslint-config": "0.0.1",
     "@graphytools/eslint-plugin-graphy": "1.0.0",
     "@graphytools/typescript-config": "0.0.1",