@alphacharts/report 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alphabench
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,56 @@
-# Temporary Holding Version
+# @alphacharts/report
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Opt-in, anonymous crash reports for alphacharts. **Off by default.** Importing this package does nothing: no
+listener, no timer, no network, no global `window.onerror` or `unhandledrejection` handler. Reporting starts only
+when you call `enableCrashReporting()` with the endpoint and key of **your own** PostHog project. There is no
+default server: without both, it throws and sends nothing.
+
+```ts
+import { enableCrashReporting } from "@alphacharts/report";
+
+const disable = enableCrashReporting({
+  endpoint: "https://your-posthog.example/batch", // required; full URL, used exactly as given: no path is appended
+  key: "phc_...",                                  // required; that project's public capture key
+  maxReports: 5,                                   // optional; per page load (default 5)
+});
+// disable() stops it.
+```
+
+It reports faults the core catches at its own entry points: the shared draw loop, the chart constructor, WebGL
+context loss and restore, and shader compile or link failures. To also report errors your code already receives:
+
+```ts
+import { errorForwarder, plotErrorForwarder } from "@alphacharts/report";
+
+plot.on("error", plotErrorForwarder());
+new DrawingsPlugin({ onError: errorForwarder("drawings", (e) => console.error(e)) });
+new AlertsPlugin({ onError: errorForwarder("alerts") });
+// datafeed: { onError: errorForwarder("feed") }
+```
+
+A forwarder reads only its first argument. The drawing object that `DrawingsOptions.onError` passes second is never
+read. The optional callback you pass receives the error only, so keep your own handler if you need the drawing.
+
+## What is sent
+
+One PostHog `$exception` event, `POST` as `text/plain` JSON by `navigator.sendBeacon`, else `fetch` with `keepalive`.
+Failures are ignored. Per page load: the same fault is sent once and at most `maxReports` are sent.
+
+| Field | Value |
+|---|---|
+| `distinct_id` | random UUID, new on every page load, never stored |
+| `project` | `alphacharts` |
+| `version`, `report_version` | the `@alphacharts/core` version that faulted; this package's version |
+| `error_type` | the error's class name (`TypeError`), or `NonError` / `None` |
+| `source` | `draw-loop`, `ctor`, `context-lost`, `shader`, `plot`, `drawings`, `alerts`, `feed` |
+| `renderer` | `webgl` or `canvas2d`, when known |
+| `webgl2`, `context_lost` | booleans |
+| `browser`, `os` | family and major version (`Chrome 126`), OS family |
+| `$exception_list` | one entry: the error type and the fixed label `alphacharts fault: <source>`. No message, no stack frames, no file names |
+| `$process_person_profile`, `$geoip_disable` | `false`, `true` |
+
+Never sent: error messages, option, data, series, plugin or marker ids, symbols, prices, GPU vendor strings, page URL,
+cookies or any stored id. Your server still sees the sender's IP address; turn on your project's "discard client IP
+data" setting.
+
+MIT licence.

package/dist/index.js

@@ -0,0 +1,116 @@
+import { CORE_VERSION as e, onFault as t } from "@alphacharts/core/internal";
+//#region src/index.ts
+var n = "0.1.0", r = /* @__PURE__ */ new Set([
+	"draw-loop",
+	"ctor",
+	"context-lost",
+	"shader",
+	"plot",
+	"drawings",
+	"alerts",
+	"feed"
+]), i = null, a = null, o = "";
+function s(e) {
+	let n = e?.endpoint, o = e?.key;
+	if (typeof n != "string" || n === "") throw TypeError("alphacharts report: endpoint is required (the full URL of your PostHog capture endpoint)");
+	if (typeof o != "string" || o === "") throw TypeError("alphacharts report: key is required (your PostHog project's public capture key)");
+	a?.();
+	let s = Math.max(0, Math.floor(e.maxReports ?? 5)), c = /* @__PURE__ */ new Set(), l = /* @__PURE__ */ new WeakSet(), u = 0, f = !1, p = { report(e, t, i) {
+		try {
+			if (t === "context-restored") {
+				f = !1;
+				return;
+			}
+			if (!r.has(t)) return;
+			if (typeof e == "object" && e) {
+				if (l.has(e)) return;
+				l.add(e);
+			}
+			t === "context-lost" && (f = !0);
+			let a = d(e, t, i, f), p = `${t}|${a.error_type}`;
+			if (c.has(p) || u >= s) return;
+			c.add(p), u++, h(n, o, a);
+		} catch {}
+	} };
+	i = p;
+	let m = t((e) => p.report(e.error, e.source, e.renderer)), g = () => {
+		m(), i === p && (i = null), a === g && (a = null);
+	};
+	return a = g, g;
+}
+function c(e, t) {
+	i?.report(e, t);
+}
+function l(e, t) {
+	return (n) => {
+		c(n, e), t?.(n);
+	};
+}
+function u(e) {
+	return (t) => {
+		c(t.error, "plot"), e?.(t);
+	};
+}
+function d(t, r, i, a) {
+	let o = f(t), { browser: s, os: c } = p(), l = {
+		project: "alphacharts",
+		version: e,
+		report_version: n,
+		error_type: o,
+		source: r,
+		webgl2: typeof WebGL2RenderingContext < "u",
+		context_lost: a,
+		browser: s,
+		os: c,
+		$exception_list: [{
+			type: o,
+			value: `alphacharts fault: ${r}`
+		}],
+		$process_person_profile: !1,
+		$geoip_disable: !0
+	};
+	return i && (l.renderer = i), l;
+}
+function f(e) {
+	let t = typeof e == "object" && e ? e.name : void 0;
+	return typeof t == "string" && /^[A-Za-z][A-Za-z0-9_]{0,39}$/.test(t) ? t : e === void 0 ? "None" : e instanceof Error ? "Error" : "NonError";
+}
+function p() {
+	let e = typeof navigator < "u" && typeof navigator.userAgent == "string" ? navigator.userAgent : "", t = (t, n) => {
+		let r = t.exec(e);
+		return r ? `${n} ${r[1]}` : null;
+	};
+	return {
+		browser: t(/Edg\/(\d+)/, "Edge") ?? t(/OPR\/(\d+)/, "Opera") ?? t(/(?:Firefox|FxiOS)\/(\d+)/, "Firefox") ?? t(/(?:Chrome|CriOS)\/(\d+)/, "Chrome") ?? t(/Version\/(\d+)[^]*Safari/, "Safari") ?? "other",
+		os: /Windows/.test(e) ? "Windows" : /Android/.test(e) ? "Android" : /iPhone|iPad|iPod/.test(e) ? "iOS" : /Mac OS X|Macintosh/.test(e) ? "macOS" : /CrOS/.test(e) ? "ChromeOS" : /Linux/.test(e) ? "Linux" : "other"
+	};
+}
+function m() {
+	if (o) return o;
+	let e = globalThis.crypto;
+	return o = e?.randomUUID ? e.randomUUID() : Array.from({ length: 4 }, () => Math.random().toString(16).slice(2, 10).padEnd(8, "0")).join("-"), o;
+}
+function h(e, t, n) {
+	try {
+		let r = JSON.stringify({
+			api_key: t,
+			batch: [{
+				event: "$exception",
+				distinct_id: m(),
+				properties: n
+			}]
+		}), i = typeof navigator < "u" ? navigator : void 0;
+		if (i && typeof i.sendBeacon == "function" && i.sendBeacon(e, new Blob([r], { type: "text/plain" }))) return;
+		typeof fetch == "function" && fetch(e, {
+			method: "POST",
+			body: r,
+			keepalive: !0,
+			credentials: "omit",
+			headers: { "content-type": "text/plain" }
+		}).catch(() => {});
+	} catch {}
+}
+//#endregion
+export { n as VERSION, s as enableCrashReporting, l as errorForwarder, u as plotErrorForwarder, c as reportError };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["VERSION","SOURCES","active","stop","pageId","enableCrashReporting","endpoint","options","key","cap","seenKeys","seenErrors","sent","contextLost","self","source","error","props","properties","renderer","dedupeKey","send","off","onFault","f","disable","reportError","errorForwarder","next","plotErrorForwarder","e","errorType","nameOf","agent","CORE_VERSION","n","ua","pick","m","re","name","uuid","c","body","nav"],"sources":["../src/index.ts"],"sourcesContent":["// Opt-in, anonymous crash reports. Nothing happens at import: no listener, no\n// timer, no network. enableCrashReporting() subscribes to the core's fault\n// emitter and sends a fixed set of fields to the endpoint the host names. There is no default endpoint.\n//\n// Never sent: error messages, option/data/series/plugin/marker ids, symbols,\n// prices, GPU strings, stack text, file names. No global\n// window.onerror / unhandledrejection handler is installed.\n\nimport { CORE_VERSION, onFault, type Fault } from \"@alphacharts/core/internal\";\n\nexport const VERSION = \"0.1.0\";\n\nexport type ReportSource = Fault[\"source\"] | \"plot\" | \"drawings\" | \"alerts\" | \"feed\";\n\nexport interface CrashReportingOptions {\n  /** Full URL that accepts a PostHog capture batch (POST); no path is appended. Required: there is no default. */\n  endpoint: string;\n  /** The project's public capture key (it can only write events). Required. */\n  key: string;\n  /** Most reports sent per page load (default 5). */\n  maxReports?: number | undefined;\n}\n\nconst SOURCES: ReadonlySet<string> = new Set([\"draw-loop\", \"ctor\", \"context-lost\", \"shader\", \"plot\", \"drawings\", \"alerts\", \"feed\"]);\n\ninterface Active {\n  report(error: unknown, source: ReportSource, renderer?: \"webgl\" | \"canvas2d\"): void;\n}\nlet active: Active | null = null;\nlet stop: (() => void) | null = null;\nlet pageId = \"\";\n\n/** Start reporting. Returns the function that stops it. A missing, empty or non-string endpoint or key throws: nothing is sent unless the host names where. */\nexport function enableCrashReporting(options: CrashReportingOptions): () => void {\n  const endpoint = options?.endpoint;\n  const key = options?.key;\n  if (typeof endpoint !== \"string\" || endpoint === \"\") throw new TypeError(\"alphacharts report: endpoint is required (the full URL of your PostHog capture endpoint)\");\n  if (typeof key !== \"string\" || key === \"\") throw new TypeError(\"alphacharts report: key is required (your PostHog project's public capture key)\");\n  stop?.(); // a second call replaces the first\n  const cap = Math.max(0, Math.floor(options.maxReports ?? 5));\n  const seenKeys = new Set<string>();\n  const seenErrors = new WeakSet<object>();\n  let sent = 0;\n  let contextLost = false;\n\n  const self: Active = {\n    report(error, source, renderer) {\n      try {\n        if (source === \"context-restored\") {\n          contextLost = false; // a recovery, not a fault: tracked, never sent\n          return;\n        }\n        if (!SOURCES.has(source)) return;\n        // One failure can reach two entry points (a shader error inside a frame).\n        if (typeof error === \"object\" && error !== null) {\n          if (seenErrors.has(error)) return;\n          seenErrors.add(error);\n        }\n        if (source === \"context-lost\") contextLost = true;\n        const props = properties(error, source, renderer, contextLost);\n        const dedupeKey = `${source}|${props.error_type}`;\n        if (seenKeys.has(dedupeKey) || sent >= cap) return;\n        seenKeys.add(dedupeKey);\n        sent++;\n        send(endpoint, key, props);\n      } catch {\n        // reporting must never change what the page does\n      }\n    },\n  };\n  active = self;\n  const off = onFault((f) => self.report(f.error, f.source, f.renderer));\n  const disable = (): void => {\n    off();\n    if (active === self) active = null;\n    if (stop === disable) stop = null;\n  };\n  stop = disable;\n  return disable;\n}\n\n/** Forwards an error to the reporter if one is enabled. Only the error and a source name leave the caller. */\nexport function reportError(error: unknown, source: \"plot\" | \"drawings\" | \"alerts\" | \"feed\"): void {\n  active?.report(error, source);\n}\n\n/** For `DrawingsOptions.onError`, `AlertsOptions.onError`, `FeedOptions.onError`. Uses only the first argument, never the drawing. */\nexport function errorForwarder(source: \"drawings\" | \"alerts\" | \"feed\", next?: (error: unknown) => void): (error: unknown) => void {\n  return (error) => {\n    reportError(error, source);\n    next?.(error);\n  };\n}\n\n/** For `plot.on(\"error\", ...)`. */\nexport function plotErrorForwarder(next?: (e: { error: unknown }) => void): (e: { error: unknown }) => void {\n  return (e) => {\n    reportError(e.error, \"plot\");\n    next?.(e);\n  };\n}\n\n// ---- payload -----------------------------------------------------------------\n\nfunction properties(error: unknown, source: string, renderer: \"webgl\" | \"canvas2d\" | undefined, contextLost: boolean): Record<string, unknown> {\n  const errorType = nameOf(error);\n  const { browser, os } = agent();\n  const props: Record<string, unknown> = {\n    project: \"alphacharts\",\n    version: CORE_VERSION, // the core that faulted, not this package\n    report_version: VERSION,\n    error_type: errorType,\n    source,\n    webgl2: typeof WebGL2RenderingContext !== \"undefined\",\n    context_lost: contextLost,\n    browser,\n    os,\n    // No message and no stack: PostHog groups by class + source. The value is built from the source allow-list only.\n    $exception_list: [{ type: errorType, value: `alphacharts fault: ${source}` }],\n    $process_person_profile: false,\n    $geoip_disable: true,\n  };\n  if (renderer) props.renderer = renderer;\n  return props;\n}\n\nfunction nameOf(error: unknown): string {\n  const n = typeof error === \"object\" && error !== null ? (error as { name?: unknown }).name : undefined;\n  if (typeof n === \"string\" && /^[A-Za-z][A-Za-z0-9_]{0,39}$/.test(n)) return n;\n  return error === undefined ? \"None\" : error instanceof Error ? \"Error\" : \"NonError\";\n}\n\nfunction agent(): { browser: string; os: string } {\n  const ua = typeof navigator !== \"undefined\" && typeof navigator.userAgent === \"string\" ? navigator.userAgent : \"\";\n  const pick = (re: RegExp, name: string): string | null => {\n    const m = re.exec(ua);\n    return m ? `${name} ${m[1]}` : null;\n  };\n  const browser =\n    pick(/Edg\\/(\\d+)/, \"Edge\") ?? pick(/OPR\\/(\\d+)/, \"Opera\") ?? pick(/(?:Firefox|FxiOS)\\/(\\d+)/, \"Firefox\") ?? pick(/(?:Chrome|CriOS)\\/(\\d+)/, \"Chrome\") ?? pick(/Version\\/(\\d+)[^]*Safari/, \"Safari\") ?? \"other\";\n  const os = /Windows/.test(ua) ? \"Windows\" : /Android/.test(ua) ? \"Android\" : /iPhone|iPad|iPod/.test(ua) ? \"iOS\" : /Mac OS X|Macintosh/.test(ua) ? \"macOS\" : /CrOS/.test(ua) ? \"ChromeOS\" : /Linux/.test(ua) ? \"Linux\" : \"other\";\n  return { browser, os };\n}\n\n// ---- transport ---------------------------------------------------------------\n\nfunction uuid(): string {\n  if (pageId) return pageId;\n  const c = (globalThis as { crypto?: Crypto }).crypto;\n  pageId = c?.randomUUID ? c.randomUUID() : Array.from({ length: 4 }, () => Math.random().toString(16).slice(2, 10).padEnd(8, \"0\")).join(\"-\");\n  return pageId;\n}\n\nfunction send(endpoint: string, key: string, properties: Record<string, unknown>): void {\n  try {\n    const body = JSON.stringify({ api_key: key, batch: [{ event: \"$exception\", distinct_id: uuid(), properties }] });\n    // text/plain keeps the request CORS-simple: no preflight.\n    const nav = typeof navigator !== \"undefined\" ? navigator : undefined;\n    if (nav && typeof nav.sendBeacon === \"function\" && nav.sendBeacon(endpoint, new Blob([body], { type: \"text/plain\" }))) return;\n    if (typeof fetch === \"function\") {\n      fetch(endpoint, { method: \"POST\", body, keepalive: true, credentials: \"omit\", headers: { \"content-type\": \"text/plain\" } }).catch(() => {});\n    }\n  } catch {\n    // ignore every transport failure\n  }\n}\n"],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,23 @@
+import { type Fault } from "@alphacharts/core/internal";
+export declare const VERSION = "0.1.0";
+export type ReportSource = Fault["source"] | "plot" | "drawings" | "alerts" | "feed";
+export interface CrashReportingOptions {
+    /** Full URL that accepts a PostHog capture batch (POST); no path is appended. Required: there is no default. */
+    endpoint: string;
+    /** The project's public capture key (it can only write events). Required. */
+    key: string;
+    /** Most reports sent per page load (default 5). */
+    maxReports?: number | undefined;
+}
+/** Start reporting. Returns the function that stops it. A missing, empty or non-string endpoint or key throws: nothing is sent unless the host names where. */
+export declare function enableCrashReporting(options: CrashReportingOptions): () => void;
+/** Forwards an error to the reporter if one is enabled. Only the error and a source name leave the caller. */
+export declare function reportError(error: unknown, source: "plot" | "drawings" | "alerts" | "feed"): void;
+/** For `DrawingsOptions.onError`, `AlertsOptions.onError`, `FeedOptions.onError`. Uses only the first argument, never the drawing. */
+export declare function errorForwarder(source: "drawings" | "alerts" | "feed", next?: (error: unknown) => void): (error: unknown) => void;
+/** For `plot.on("error", ...)`. */
+export declare function plotErrorForwarder(next?: (e: {
+    error: unknown;
+}) => void): (e: {
+    error: unknown;
+}) => void;

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@alphacharts/report",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Opt-in, anonymous crash reports for alphacharts. Off unless you call enableCrashReporting with your own PostHog endpoint and key; there is no default server.",
+  "keywords": [
+    "chart",
+    "crash-reporting",
+    "error-reporting",
+    "posthog"
+  ],
+  "license": "MIT",
+  "author": "Alphabench",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alphabench/alphacharts.git",
+    "directory": "packages/report"
+  },
+  "homepage": "https://github.com/alphabench/alphacharts#readme",
+  "bugs": {
+    "url": "https://github.com/alphabench/alphacharts/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@alphacharts/core": "^0.1.1"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "vite": "8.3.1",
+    "vitest": "5.0.2",
+    "@alphacharts/core": "0.1.1"
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "typecheck:dist": "tsc -p tsconfig.dist.json",
+    "test": "vitest run"
+  }
 }