peakflow-api 0.0.0

package/AGENTS.md

@@ -0,0 +1,27 @@
+# AGENTS
+
+This repo hosts the Peakflow JavaScript client for error reporting across browser, Node, and Expo/React Native.
+
+## Project Overview
+- Source code lives in `src/`.
+- Build output is emitted to `build/` (not committed).
+- Tests use Jasmine under `spec/`.
+
+## Development Workflow
+- Install dependencies: `npm install`.
+- Type check: `npm run typecheck`.
+- Lint: `npm run lint`.
+- Test: `npm test`.
+- Build (emits minified bundle to `build/`): `npm run build`.
+
+## Error Listener Usage
+- Browser: `connectOnError()` and `connectUnhandledRejection()`.
+- Node: `connectNodeUncaughtException()` and `connectNodeUnhandledRejection()`.
+- Expo/React Native: `connectExpoErrorHandlers()`.
+- `connect()` auto-wires handlers based on runtime.
+
+## Notes for Agents
+- Avoid adding global browser dependencies unless guarded by runtime checks.
+- When changing API exports, update `README.md` examples.
+- Keep JSDoc accurate; TypeScript checks JS via `checkJs`.
+- Ensure new browser-only logic is opt-in and documented.

package/README.md

@@ -0,0 +1,53 @@
+# peakflow
+
+JavaScript client for Peakflow error reporting with browser, Node, and Expo/React Native support.
+
+## Install
+
+```sh
+npm install peakflow
+```
+
+## Usage
+
+```js
+import {BugReporting, debuggerInstance} from "peakflow"
+
+const bugReporting = new BugReporting({authToken: "your-token"})
+bugReporting.connect()
+```
+
+## Browser error listeners
+
+```js
+import {BugReporting} from "peakflow"
+
+const bugReporting = new BugReporting({authToken: "your-token"})
+
+// Optional: enable source map parsing for script tags in web apps.
+bugReporting.enableSourceMapsLoader()
+
+bugReporting.connectOnError()
+bugReporting.connectUnhandledRejection()
+```
+
+## Node error listeners
+
+```js
+import {BugReporting} from "peakflow"
+
+const bugReporting = new BugReporting({authToken: "your-token"})
+
+bugReporting.connectNodeUncaughtException()
+bugReporting.connectNodeUnhandledRejection()
+```
+
+## Expo / React Native error listeners
+
+```js
+import {BugReporting} from "peakflow"
+
+const bugReporting = new BugReporting({authToken: "your-token"})
+
+bugReporting.connectExpoErrorHandlers()
+```

package/build/bug-reporting/index.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Handles client-side error reporting for Peakflow.
+ */
+export default class BugReporting {
+    /**
+     * @param {{authToken: string}} data
+     */
+    constructor(data: {
+        authToken: string;
+    });
+    authToken: string;
+    testing: boolean;
+    collectEnvironmentCallback: (args: object) => Promise<object> | object;
+    collectParamsCallback: (args: object) => Promise<object> | object;
+    sourceMapsLoader: SourceMapsLoader;
+    /**
+     * Register a callback to resolve environment metadata.
+     * @param {(args: object) => Promise<object>|object} callback
+     */
+    collectEnvironment(callback: (args: object) => Promise<object> | object): void;
+    /**
+     * Register a callback to resolve parameter metadata.
+     * @param {(args: object) => Promise<object>|object} callback
+     */
+    collectParams(callback: (args: object) => Promise<object> | object): void;
+    /**
+     * Initialize global error handlers.
+     */
+    /**
+     * Initialize error handlers based on the runtime.
+     */
+    connect(): void;
+    isHandlingError: boolean;
+    /**
+     * Check if the runtime looks like a browser environment.
+     * @returns {boolean}
+     */
+    isBrowser(): boolean;
+    /**
+     * Check if the runtime looks like Expo/React Native.
+     * @returns {boolean}
+     */
+    isExpo(): boolean;
+    /**
+     * Check if the runtime looks like a Node environment.
+     * @returns {boolean}
+     */
+    isNode(): boolean;
+    /**
+     * Enable source map loading for environments with script tags.
+     * @returns {boolean}
+     */
+    enableSourceMapsLoader(): boolean;
+    /**
+     * Wire the window error handler.
+     */
+    connectOnError(): void;
+    /**
+     * Wire the unhandled rejection handler.
+     */
+    connectUnhandledRejection(): void;
+    /**
+     * Wire Expo/React Native global error handlers.
+     * @returns {boolean}
+     */
+    connectExpoErrorHandlers(): boolean;
+    /**
+     * Wire Node.js uncaught error handlers.
+     */
+    connectNodeUncaughtException(): void;
+    connectNodeUnhandledRejection(): void;
+    /**
+     * Send a formatted error report to Peakflow.
+     * @typedef {Error & {peakflowParameters?: object, peakflowEnvironment?: object}} PeakflowError
+     * @param {object} data
+     * @param {PeakflowError} [data.error]
+     * @param {string} [data.errorClass]
+     * @param {string|null} [data.file]
+     * @param {number|null} [data.line]
+     * @param {string} data.message
+     * @param {string|null} data.url
+     */
+    handleError(data: {
+        error?: Error & {
+            peakflowParameters?: object;
+            peakflowEnvironment?: object;
+        };
+        errorClass?: string;
+        file?: string | null;
+        line?: number | null;
+        message: string;
+        url: string | null;
+    }): Promise<void>;
+    /**
+     * Register a hook for loading source maps from script tags.
+     * @param {(script: HTMLScriptElement) => Promise<unknown>|unknown} callback
+     */
+    loadSourceMapForScriptTags(callback: (script: HTMLScriptElement) => Promise<unknown> | unknown): void;
+    loadSourceMapForScriptTagsCallback: (script: HTMLScriptElement) => Promise<unknown> | unknown;
+    /**
+     * Parse a URL using a DOM anchor element.
+     * @param {string} url
+     * @returns {HTMLAnchorElement|null}
+     */
+    loadUrl(url: string): HTMLAnchorElement | null;
+    /**
+     * Send JSON data through an XHR instance.
+     * @param {XMLHttpRequest} xhr
+     * @param {string} postData
+     * @returns {Promise<void>}
+     */
+    loadXhr(xhr: XMLHttpRequest, postData: string): Promise<void>;
+    /**
+     * Resolve environment data for a report.
+     * @param {object} args
+     * @returns {Promise<object|undefined>}
+     */
+    resolveEnvironment(args: object): Promise<object | undefined>;
+    /**
+     * Resolve request parameters for a report.
+     * @param {object} args
+     * @returns {Promise<object|undefined>}
+     */
+    resolveParams(args: object): Promise<object | undefined>;
+    /**
+     * Toggle testing mode for posting to local paths.
+     * @param {boolean} value
+     */
+    setTesting(value: boolean): void;
+}
+import SourceMapsLoader from "@kaspernj/api-maker/build/source-maps-loader.js";
+//# sourceMappingURL=index.d.ts.map

package/build/bug-reporting/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bug-reporting/index.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IACE;;OAEG;IACH,kBAFW;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,EAQ7B;IALC,kBAA+B;IAC/B,iBAAoB;IACpB,mCAOgB,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAC,MAAM,CAPN;IAC3C,8BAcgB,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAC,MAAM,CAdX;IACtC,mCAA4B;IAG9B;;;OAGG;IACH,6BAFW,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAC,MAAM,QAIlD;IAED;;;OAGG;IACH,wBAFW,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAC,MAAM,QAIlD;IAED;;OAEG;IACH;;OAEG;IACH,gBAmBC;IAjBC,yBAA4B;IAmB9B;;;OAGG;IACH,aAFa,OAAO,CAInB;IAED;;;OAGG;IACH,UAFa,OAAO,CAInB;IAED;;;OAGG;IACH,UAFa,OAAO,CAInB;IAED;;;OAGG;IACH,0BAFa,OAAO,CA0BnB;IAED;;OAEG;IACH,uBAyBC;IAED;;OAEG;IACH,kCAqBC;IAED;;;OAGG;IACH,4BAFa,OAAO,CAqCnB;IAED;;OAEG;IACH,qCAqBC;IAED,sCAqBC;IAED;;;;;;;;;;OAUG;IACH,kBAPG;QAA6B,KAAK;iCAFM,MAAM;kCAAwB,MAAM;;QAGtD,UAAU,GAAxB,MAAM;QACa,IAAI,GAAvB,MAAM,GAAC,IAAI;QACQ,IAAI,GAAvB,MAAM,GAAC,IAAI;QACE,OAAO,EAApB,MAAM;QACY,GAAG,EAArB,MAAM,GAAC,IAAI;KACrB,iBA8EA;IAED;;;OAGG;IACH,qCAFW,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,QAIjE;IADC,6CAHkB,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAC,OAAO,CAGd;IAGpD;;;;OAIG;IACH,aAHW,MAAM,GACJ,iBAAiB,GAAC,IAAI,CAYlC;IAED;;;;;OAKG;IACH,aAJW,cAAc,YACd,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAOzB;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,GAAC,SAAS,CAAC,CAMrC;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,GAAC,SAAS,CAAC,CASrC;IAED;;;OAGG;IACH,kBAFW,OAAO,QAIjB;CACF;6BApa4B,iDAAiD"}

package/build/bug-reporting/index.js

@@ -0,0 +1,2 @@
+import{digg as r}from"diggerize";import e from"qs";import o from"./variables.js";import{debuggerInstance as n}from"../debugger.js";import s from"@kaspernj/api-maker/build/source-maps-loader.js";export default class a{constructor(r){this.authToken=r.authToken,this.testing=!1,this.collectEnvironmentCallback=void 0,this.collectParamsCallback=void 0,this.sourceMapsLoader=null}collectEnvironment(r){this.collectEnvironmentCallback=r}collectParams(r){this.collectParamsCallback=r}connect(){n.debug("Connecting handler"),this.isHandlingError=!1,this.isBrowser()?(this.connectOnError(),this.connectUnhandledRejection()):n.debug("Skipping browser error handlers outside the browser"),this.isExpo()&&this.connectExpoErrorHandlers(),this.isNode()&&(this.connectNodeUncaughtException(),this.connectNodeUnhandledRejection())}isBrowser(){return void 0!==globalThis.document&&"function"==typeof globalThis.addEventListener}isExpo(){return"function"==typeof globalThis.ErrorUtils?.setGlobalHandler}isNode(){return void 0!==globalThis.process&&"function"==typeof globalThis.process.on}enableSourceMapsLoader(){return"undefined"!=typeof window&&"undefined"!=typeof document&&(this.sourceMapsLoader||(this.sourceMapsLoader=new s),this.sourceMapsLoader.loadSourceMapsForScriptTags(r=>{const e=r.getAttribute("src"),o=r.getAttribute("type");if(this.loadSourceMapForScriptTagsCallback&&e&&("text/javascript"==o||!o)){n.debug(`Loading source map for ${e}`);const o=this.loadSourceMapForScriptTagsCallback(r);if(o)return o}}),!0)}connectOnError(){globalThis.addEventListener("error",async r=>{if(n.debug(`Error cought with message: ${r.message}`),n.debug(`Message: ${r.message}`),n.debug(`File: ${r.filename}`),n.debug(`Line: ${r.lineno}`),n.debug(`Error: ${r.error}`),!this.isHandlingError){this.isHandlingError=!0;try{await this.handleError({error:r.error,errorClass:r.error?.name,file:r.filename,line:r.lineno,message:r.message||"Unknown error",url:globalThis.location?.href})}finally{this.isHandlingError=!1}}})}connectUnhandledRejection(){globalThis.addEventListener("unhandledrejection",async r=>{if(n.debug(`Unhandled rejection: ${JSON.stringify(r.reason.message||r.reason)}`),!this.isHandlingError){this.isHandlingError=!0;try{await this.handleError({error:r.reason,errorClass:"UnhandledRejection",file:null,line:null,message:r.reason.message||r.reason||"Unhandled promise rejection",url:globalThis.location?.href})}finally{this.isHandlingError=!1}}})}connectExpoErrorHandlers(){if(!this.isExpo())return!1;const r="function"==typeof globalThis.ErrorUtils.getGlobalHandler?globalThis.ErrorUtils.getGlobalHandler():null;return globalThis.ErrorUtils.setGlobalHandler((e,o)=>{n.debug(`Expo error: ${e?.message||e}`),this.isHandlingError||(this.isHandlingError=!0,Promise.resolve(this.handleError({error:e,errorClass:e?.name||(o?"FatalError":"ExpoError"),file:null,line:null,message:e?.message||String(e),url:null})).finally(()=>{this.isHandlingError=!1})),r&&r(e,o)}),!0}connectNodeUncaughtException(){globalThis.process.on("uncaughtException",async r=>{if(n.debug(`Uncaught exception: ${r?.message||r}`),!this.isHandlingError){this.isHandlingError=!0;try{await this.handleError({error:r,errorClass:r?.name||"UncaughtException",file:null,line:null,message:r?.message||String(r),url:null})}finally{this.isHandlingError=!1}}})}connectNodeUnhandledRejection(){globalThis.process.on("unhandledRejection",async r=>{if(n.debug(`Unhandled rejection: ${JSON.stringify(r?.message||r)}`),!this.isHandlingError){this.isHandlingError=!0;try{await this.handleError({error:r instanceof Error?r:void 0,errorClass:"UnhandledRejection",file:null,line:null,message:r?.message||String(r),url:null})}finally{this.isHandlingError=!1}}})}async handleError(e){let s,a;n.debug(`Handle error: ${JSON.stringify(e)}`),e.error&&e.error.stack&&this.sourceMapsLoader?(n.debug("Parse stacktrace"),await this.sourceMapsLoader.loadSourceMaps(e.error),s=this.sourceMapsLoader.parseStackTrace(e.error.stack)):e.error&&e.error.stack?s=[e.error.stack]:e.file&&(n.debug("No stacktrace was present on the error so cant parse it"),s=[`${e.file}:${e.line}`]),n.debug(`AuthToken: ${this.authToken}`),n.debug(`Backtrace: ${s}`);const t=e.errorClass||"UnknownError",i={auth_token:this.authToken,error:{backtrace:s,error_class:t,message:e.message,url:e.url,user_agent:void 0!==globalThis.navigator&&globalThis.navigator?globalThis.navigator.userAgent:null}};if(a=this.testing?o.bugReportsPath:o.bugReportsUrl,n.debug(`Sending error report to: ${a}`),e.error?.peakflowParameters?i.error.parameters=e.error.peakflowParameters:(n.debug("Resolving params"),i.error.parameters=await this.resolveParams(e),n.debug("Resolved params",i.error.parameters)),e.error?.peakflowEnvironment?i.error.environment=e.error.peakflowEnvironment:(n.debug("Resolving environment"),i.error.environment=await this.resolveEnvironment(e),n.debug("Resolved environment",i.error.environment)),"undefined"==typeof XMLHttpRequest)return void n.debug("Skipping error report because XMLHttpRequest is unavailable");const l=new XMLHttpRequest;l.open("POST",a,!0),l.setRequestHeader("Content-Type","application/json"),await this.loadXhr(l,JSON.stringify(i)),n.debug(`Data received: ${l.responseText}`);const c=JSON.parse(r(l,"responseText"));c.url&&console.log(`Peakflow: Error was reported: ${r(c,"url")}`)}loadSourceMapForScriptTags(r){this.loadSourceMapForScriptTagsCallback=r}loadUrl(r){if(!this.isBrowser())return null;const e=globalThis.document.createElement("a");return e.href=r,e}loadXhr(r,e){return new Promise(o=>{r.onload=()=>o(),r.send(e)})}async resolveEnvironment(r){if(this.collectEnvironmentCallback)return await this.collectEnvironmentCallback(r)}async resolveParams(r){if(this.collectParamsCallback)return await this.collectParamsCallback(r);if("object"==typeof globalThis.location&&globalThis.location){const r="string"==typeof globalThis.location.search?globalThis.location.search:"";return e.parse(r.substr(1))}}setTesting(r){this.testing=r}}
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJkaWdnIiwicXMiLCJSYWlsc1ZhcmlhYmxlcyIsImRlYnVnZ2VySW5zdGFuY2UiLCJTb3VyY2VNYXBzTG9hZGVyIiwiQnVnUmVwb3J0aW5nIiwiY29uc3RydWN0b3IiLCJkYXRhIiwidGhpcyIsImF1dGhUb2tlbiIsInRlc3RpbmciLCJjb2xsZWN0RW52aXJvbm1lbnRDYWxsYmFjayIsInVuZGVmaW5lZCIsImNvbGxlY3RQYXJhbXNDYWxsYmFjayIsInNvdXJjZU1hcHNMb2FkZXIiLCJjb2xsZWN0RW52aXJvbm1lbnQiLCJjYWxsYmFjayIsImNvbGxlY3RQYXJhbXMiLCJjb25uZWN0IiwiZGVidWciLCJpc0hhbmRsaW5nRXJyb3IiLCJpc0Jyb3dzZXIiLCJjb25uZWN0T25FcnJvciIsImNvbm5lY3RVbmhhbmRsZWRSZWplY3Rpb24iLCJpc0V4cG8iLCJjb25uZWN0RXhwb0Vycm9ySGFuZGxlcnMiLCJpc05vZGUiLCJjb25uZWN0Tm9kZVVuY2F1Z2h0RXhjZXB0aW9uIiwiY29ubmVjdE5vZGVVbmhhbmRsZWRSZWplY3Rpb24iLCJnbG9iYWxUaGlzIiwiZG9jdW1lbnQiLCJhZGRFdmVudExpc3RlbmVyIiwiRXJyb3JVdGlscyIsInNldEdsb2JhbEhhbmRsZXIiLCJwcm9jZXNzIiwib24iLCJlbmFibGVTb3VyY2VNYXBzTG9hZGVyIiwid2luZG93IiwibG9hZFNvdXJjZU1hcHNGb3JTY3JpcHRUYWdzIiwic2NyaXB0Iiwic3JjIiwiZ2V0QXR0cmlidXRlIiwidHlwZSIsImxvYWRTb3VyY2VNYXBGb3JTY3JpcHRUYWdzQ2FsbGJhY2siLCJyZXN1bHQiLCJhc3luYyIsImV2ZW50IiwibWVzc2FnZSIsImZpbGVuYW1lIiwibGluZW5vIiwiZXJyb3IiLCJoYW5kbGVFcnJvciIsImVycm9yQ2xhc3MiLCJuYW1lIiwiZmlsZSIsImxpbmUiLCJ1cmwiLCJsb2NhdGlvbiIsImhyZWYiLCJKU09OIiwic3RyaW5naWZ5IiwicmVhc29uIiwicHJldmlvdXNIYW5kbGVyIiwiZ2V0R2xvYmFsSGFuZGxlciIsImlzRmF0YWwiLCJQcm9taXNlIiwicmVzb2x2ZSIsIlN0cmluZyIsImZpbmFsbHkiLCJFcnJvciIsImJhY2t0cmFjZSIsInBvc3RVcmwiLCJzdGFjayIsImxvYWRTb3VyY2VNYXBzIiwicGFyc2VTdGFja1RyYWNlIiwicG9zdERhdGEiLCJhdXRoX3Rva2VuIiwiZXJyb3JfY2xhc3MiLCJ1c2VyX2FnZW50IiwibmF2aWdhdG9yIiwidXNlckFnZW50IiwiYnVnUmVwb3J0c1BhdGgiLCJidWdSZXBvcnRzVXJsIiwicGVha2Zsb3dQYXJhbWV0ZXJzIiwicGFyYW1ldGVycyIsInJlc29sdmVQYXJhbXMiLCJwZWFrZmxvd0Vudmlyb25tZW50IiwiZW52aXJvbm1lbnQiLCJyZXNvbHZlRW52aXJvbm1lbnQiLCJYTUxIdHRwUmVxdWVzdCIsInhociIsIm9wZW4iLCJzZXRSZXF1ZXN0SGVhZGVyIiwibG9hZFhociIsInJlc3BvbnNlVGV4dCIsInJlc3BvbnNlIiwicGFyc2UiLCJjb25zb2xlIiwibG9nIiwibG9hZFNvdXJjZU1hcEZvclNjcmlwdFRhZ3MiLCJsb2FkVXJsIiwicGFyc2VyIiwiY3JlYXRlRWxlbWVudCIsIm9ubG9hZCIsInNlbmQiLCJhcmdzIiwic2VhcmNoIiwic3Vic3RyIiwic2V0VGVzdGluZyIsInZhbHVlIl0sInNvdXJjZXMiOlsiLi4vLi4vc3JjL2J1Zy1yZXBvcnRpbmcvaW5kZXguanMiXSwibWFwcGluZ3MiOiJlQUFRQSxNQUFXLG1CQUNaQyxNQUFRLFlBQ1JDLE1BQW9CLDRDQUNuQkMsTUFBdUIsd0JBQ3hCQyxNQUFzQixpRUFLZixNQUFPQyxFQUluQixXQUFBQyxDQUFZQyxHQUNWQyxLQUFLQyxVQUFZRixFQUFLRSxVQUN0QkQsS0FBS0UsU0FBVSxFQUNmRixLQUFLRyxnQ0FBNkJDLEVBQ2xDSixLQUFLSywyQkFBd0JELEVBQzdCSixLQUFLTSxpQkFBbUIsSUFDMUIsQ0FNQSxrQkFBQUMsQ0FBbUJDLEdBQ2pCUixLQUFLRywyQkFBNkJLLENBQ3BDLENBTUEs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

package/build/bug-reporting/variables.d.ts

@@ -0,0 +1,6 @@
+declare namespace _default {
+    let bugReportsPath: string;
+    let bugReportsUrl: string;
+}
+export default _default;
+//# sourceMappingURL=variables.d.ts.map

package/build/bug-reporting/variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../src/bug-reporting/variables.js"],"names":[],"mappings":""}

package/build/bug-reporting/variables.js

@@ -0,0 +1,2 @@
+export default{bugReportsPath:"/errors/reports",bugReportsUrl:"https://www.peakflow.io/errors/reports"};
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJidWdSZXBvcnRzUGF0aCIsImJ1Z1JlcG9ydHNVcmwiXSwic291cmNlcyI6WyIuLi8uLi9zcmMvYnVnLXJlcG9ydGluZy92YXJpYWJsZXMuanMiXSwibWFwcGluZ3MiOiJjQUFlLENBQ2JBLGVBQWdCLGtCQUNoQkMsY0FBZSIsImlnbm9yZUxpc3QiOltdfQ==

package/build/debugger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Simple logger for toggling Peakflow client debug output.
+ */
+export default class Debugger {
+    debugging: boolean;
+    /**
+     * Log messages when debugging is enabled.
+     * @param {...unknown} messages
+     */
+    debug(...messages: unknown[]): void;
+    /**
+     * Enable or disable debug logging.
+     * @param {boolean} value
+     */
+    setDebugging(value: boolean): void;
+}
+/**
+ * Shared debugger instance for the package.
+ */
+export const debuggerInstance: Debugger;
+//# sourceMappingURL=debugger.d.ts.map

package/build/debugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugger.d.ts","sourceRoot":"","sources":["../src/debugger.js"],"names":[],"mappings":"AAAA;;GAEG;AACH;IAKI,mBAAsB;IAGxB;;;OAGG;IACH,mBAFc,OAAO,EAAA,QAMpB;IAED;;;OAGG;IACH,oBAFW,OAAO,QAIjB;CACF;AAED;;GAEG;AACH,wCAA8C"}

package/build/debugger.js

@@ -0,0 +1,2 @@
+export default class e{constructor(){this.debugging=!1}debug(...e){this.debugging&&console.log("Peakflow JS errors:",...e)}setDebugging(e){this.debugging=e}}export const debuggerInstance=new e;
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJEZWJ1Z2dlciIsImNvbnN0cnVjdG9yIiwidGhpcyIsImRlYnVnZ2luZyIsImRlYnVnIiwibWVzc2FnZXMiLCJjb25zb2xlIiwibG9nIiwic2V0RGVidWdnaW5nIiwidmFsdWUiLCJkZWJ1Z2dlckluc3RhbmNlIl0sInNvdXJjZXMiOlsiLi4vc3JjL2RlYnVnZ2VyLmpzIl0sIm1hcHBpbmdzIjoiZUFHYyxNQUFPQSxFQUluQixXQUFBQyxHQUNFQyxLQUFLQyxXQUFZLENBQ25CLENBTUEsS0FBQUMsSUFBU0MsR0FDSEgsS0FBS0MsV0FDUEcsUUFBUUMsSUFBSSx5QkFBMEJGLEVBRTFDLENBTUEsWUFBQUcsQ0FBYUMsR0FDWFAsS0FBS0MsVUFBWU0sQ0FDbkIsU0FNSyxNQUFNQyxpQkFBbUIsSUFBSVYiLCJpZ25vcmVMaXN0IjpbXX0=

package/build/index.d.ts

@@ -0,0 +1,5 @@
+import BugReporting from "./bug-reporting/index.js";
+import Debugger from "./debugger.js";
+import { debuggerInstance } from "./debugger.js";
+export { BugReporting, Debugger, debuggerInstance };
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"yBAAyB,0BAA0B;qBACV,eAAe;iCAAf,eAAe"}

package/build/index.js

@@ -0,0 +1,2 @@
+import r from"./bug-reporting/index.js";import o,{debuggerInstance as e}from"./debugger.js";export{r as BugReporting,o as Debugger,e as debuggerInstance};
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJCdWdSZXBvcnRpbmciLCJEZWJ1Z2dlciIsImRlYnVnZ2VySW5zdGFuY2UiXSwic291cmNlcyI6WyIuLi9zcmMvaW5kZXguanMiXSwibWFwcGluZ3MiOiJPQUFPQSxNQUFrQixrQ0FDbEJDLHVCQUFXQyxNQUF1Qix1QkFFakNGLGtCQUFjQyxjQUFVQyIsImlnbm9yZUxpc3QiOltdfQ==

package/eslint.config.js

@@ -0,0 +1,14 @@
+import jsdoc from "eslint-plugin-jsdoc"
+
+export default [
+  {
+    files: ["**/*.js"],
+    languageOptions: {
+      ecmaVersion: "latest",
+      sourceType: "module"
+    },
+    plugins: {
+      jsdoc
+    }
+  }
+]

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "peakflow-api",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "build": "tsc --project tsconfig.json && node scripts/minify.mjs",
+    "lint": "eslint .",
+    "release:patch": "npm version patch -m \"chore: release patch\" && git push origin master --follow-tags && npm publish",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "test": "jasmine"
+  },
+  "devDependencies": {
+    "@kaspernj/api-maker": "^1.0.2062",
+    "@types/node": "^20.0.0",
+    "eslint": "^9.0.0",
+    "eslint-plugin-jsdoc": "^48.0.0",
+    "jasmine": "^5.1.0",
+    "terser": "^5.31.0",
+    "typescript": "^5.4.0"
+  },
+  "peerDependencies": {
+    "@kaspernj/api-maker": "^1.0.2062"
+  },
+  "dependencies": {
+    "diggerize": "^1.0.10",
+    "qs": "^6.14.0"
+  }
+}

package/peak_flow.yml

@@ -0,0 +1,6 @@
+before_script:
+  - npm install
+script:
+  - npm run typecheck
+  - npm run lint
+  - npm run test

package/scripts/minify.mjs

@@ -0,0 +1,54 @@
+import {promises as fs} from "node:fs"
+import path from "node:path"
+import {fileURLToPath} from "node:url"
+import {minify} from "terser"
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const buildDir = path.join(__dirname, "..", "build")
+
+async function collectJsFiles(dir) {
+  const entries = await fs.readdir(dir, {withFileTypes: true})
+  const files = []
+
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name)
+
+    if (entry.isDirectory()) {
+      files.push(...await collectJsFiles(fullPath))
+    } else if (entry.isFile() && fullPath.endsWith(".js")) {
+      files.push(fullPath)
+    }
+  }
+
+  return files
+}
+
+async function minifyFile(filePath) {
+  const code = await fs.readFile(filePath, "utf8")
+  const result = await minify(code, {
+    module: true,
+    sourceMap: {
+      content: "inline",
+      url: "inline"
+    }
+  })
+
+  if (!result.code) {
+    throw new Error(`Failed to minify ${filePath}`)
+  }
+
+  await fs.writeFile(filePath, result.code)
+}
+
+async function run() {
+  try {
+    await fs.access(buildDir)
+  } catch {
+    return
+  }
+
+  const files = await collectJsFiles(buildDir)
+  await Promise.all(files.map((filePath) => minifyFile(filePath)))
+}
+
+await run()

package/spec/bug-reporting.spec.js

@@ -0,0 +1,161 @@
+import BugReporting from "../src/bug-reporting/index.js"
+import RailsVariables from "../src/bug-reporting/variables.js"
+
+describe("BugReporting", () => {
+  const originalGlobals = {
+    window: globalThis.window,
+    document: globalThis.document,
+    navigator: globalThis.navigator,
+    location: globalThis.location,
+    XMLHttpRequest: globalThis.XMLHttpRequest,
+    ErrorUtils: globalThis.ErrorUtils
+  }
+
+  let lastXhr = null
+
+  class FakeXHR {
+    constructor() {
+      lastXhr = this
+      this.headers = {}
+      this.responseText = ""
+    }
+
+    open(method, url, async) {
+      this.method = method
+      this.url = url
+      this.async = async
+    }
+
+    setRequestHeader(key, value) {
+      this.headers[key] = value
+    }
+
+    send(body) {
+      this.requestBody = body
+      this.responseText = JSON.stringify({})
+      if (this.onload) {
+        this.onload()
+      }
+    }
+  }
+
+  beforeEach(() => {
+    globalThis.window = {
+      addEventListener: () => {},
+      location: {href: "https://example.test/page"}
+    }
+    globalThis.document = {
+      createElement: () => ({href: ""})
+    }
+    Object.defineProperty(globalThis, "navigator", {
+      configurable: true,
+      value: {userAgent: "test-agent"}
+    })
+    globalThis.location = globalThis.window.location
+    globalThis.XMLHttpRequest = FakeXHR
+    lastXhr = null
+  })
+
+  afterEach(() => {
+    globalThis.window = originalGlobals.window
+    globalThis.document = originalGlobals.document
+    if (typeof originalGlobals.navigator === "undefined") {
+      delete globalThis.navigator
+    } else {
+      Object.defineProperty(globalThis, "navigator", {
+        configurable: true,
+        value: originalGlobals.navigator
+      })
+    }
+    globalThis.location = originalGlobals.location
+    globalThis.XMLHttpRequest = originalGlobals.XMLHttpRequest
+    if (typeof originalGlobals.ErrorUtils === "undefined") {
+      delete globalThis.ErrorUtils
+    } else {
+      globalThis.ErrorUtils = originalGlobals.ErrorUtils
+    }
+  })
+
+  it("posts to the bug reports url by default", async () => {
+    const reporter = new BugReporting({authToken: "token"})
+
+    await reporter.handleError({
+      error: new Error("boom"),
+      errorClass: "Error",
+      file: null,
+      line: null,
+      message: "boom",
+      url: globalThis.window.location.href
+    })
+
+    expect(lastXhr.url).toBe(RailsVariables.bugReportsUrl)
+  })
+
+  it("posts to the bug reports path when testing is enabled", async () => {
+    const reporter = new BugReporting({authToken: "token"})
+
+    reporter.setTesting(true)
+
+    await reporter.handleError({
+      error: new Error("boom"),
+      errorClass: "Error",
+      file: null,
+      line: null,
+      message: "boom",
+      url: globalThis.window.location.href
+    })
+
+    expect(lastXhr.url).toBe(RailsVariables.bugReportsPath)
+  })
+
+  it("uses error-provided parameters and environment", async () => {
+    const reporter = new BugReporting({authToken: "token"})
+    const error = new Error("boom")
+
+    error.peakflowParameters = {foo: "bar"}
+    error.peakflowEnvironment = {env: "test"}
+
+    await reporter.handleError({
+      error,
+      errorClass: "Error",
+      file: null,
+      line: null,
+      message: "boom",
+      url: globalThis.window.location.href
+    })
+
+    const payload = JSON.parse(lastXhr.requestBody)
+
+    expect(payload.error.parameters).toEqual({foo: "bar"})
+    expect(payload.error.environment).toEqual({env: "test"})
+  })
+
+  it("connects Expo error handlers and forwards errors", async () => {
+    const reporter = new BugReporting({authToken: "token"})
+    const handleErrorSpy = spyOn(reporter, "handleError").and.returnValue(Promise.resolve())
+    let previousHandlerCalled = false
+    let globalHandler = null
+
+    globalThis.ErrorUtils = {
+      getGlobalHandler: () => (error, isFatal) => {
+        previousHandlerCalled = true
+      },
+      setGlobalHandler: (handler) => {
+        globalHandler = handler
+      }
+    }
+
+    expect(reporter.connectExpoErrorHandlers()).toBeTrue()
+
+    const error = new Error("expo")
+    globalHandler(error, true)
+
+    expect(handleErrorSpy).toHaveBeenCalled()
+    expect(handleErrorSpy.calls.mostRecent().args[0]).toEqual(jasmine.objectContaining({
+      error,
+      errorClass: "Error",
+      message: "expo"
+    }))
+    expect(previousHandlerCalled).toBeTrue()
+  })
+})

package/spec/debugger.spec.js

@@ -0,0 +1,29 @@
+import Debugger, {debuggerInstance} from "../src/debugger.js"
+
+describe("Debugger", () => {
+  it("logs when debugging is enabled", () => {
+    const instance = new Debugger()
+    const logSpy = spyOn(console, "log")
+
+    instance.setDebugging(true)
+    instance.debug("hello", "world")
+
+    expect(logSpy).toHaveBeenCalled()
+  })
+
+  it("does not log when debugging is disabled", () => {
+    const instance = new Debugger()
+    const logSpy = spyOn(console, "log")
+
+    instance.setDebugging(false)
+    instance.debug("nope")
+
+    expect(logSpy).not.toHaveBeenCalled()
+  })
+})
+
+describe("debuggerInstance", () => {
+  it("is a shared Debugger instance", () => {
+    expect(debuggerInstance instanceof Debugger).toBeTrue()
+  })
+})

package/spec/support/jasmine.json

@@ -0,0 +1,4 @@
+{
+  "spec_dir": "spec",
+  "spec_files": ["**/*[sS]pec.js"]
+}

package/src/bug-reporting/index.js

@@ -0,0 +1,425 @@
+import {digg} from "diggerize"
+import qs from "qs"
+import RailsVariables from "./variables.js"
+import {debuggerInstance} from "../debugger.js"
+import SourceMapsLoader from "@kaspernj/api-maker/build/source-maps-loader.js"
+
+/**
+ * Handles client-side error reporting for Peakflow.
+ */
+export default class BugReporting {
+  /**
+   * @param {{authToken: string}} data
+   */
+  constructor(data) {
+    this.authToken = data.authToken
+    this.testing = false
+    this.collectEnvironmentCallback = undefined
+    this.collectParamsCallback = undefined
+    this.sourceMapsLoader = null
+  }
+
+  /**
+   * Register a callback to resolve environment metadata.
+   * @param {(args: object) => Promise<object>|object} callback
+   */
+  collectEnvironment(callback) {
+    this.collectEnvironmentCallback = callback
+  }
+
+  /**
+   * Register a callback to resolve parameter metadata.
+   * @param {(args: object) => Promise<object>|object} callback
+   */
+  collectParams(callback) {
+    this.collectParamsCallback = callback
+  }
+
+  /**
+   * Initialize global error handlers.
+   */
+  /**
+   * Initialize error handlers based on the runtime.
+   */
+  connect() {
+    debuggerInstance.debug("Connecting handler")
+    this.isHandlingError = false
+
+    if (this.isBrowser()) {
+      this.connectOnError()
+      this.connectUnhandledRejection()
+    } else {
+      debuggerInstance.debug("Skipping browser error handlers outside the browser")
+    }
+
+    if (this.isExpo()) {
+      this.connectExpoErrorHandlers()
+    }
+
+    if (this.isNode()) {
+      this.connectNodeUncaughtException()
+      this.connectNodeUnhandledRejection()
+    }
+  }
+
+  /**
+   * Check if the runtime looks like a browser environment.
+   * @returns {boolean}
+   */
+  isBrowser() {
+    return typeof globalThis.document !== "undefined" && typeof globalThis.addEventListener === "function"
+  }
+
+  /**
+   * Check if the runtime looks like Expo/React Native.
+   * @returns {boolean}
+   */
+  isExpo() {
+    return typeof globalThis.ErrorUtils?.setGlobalHandler === "function"
+  }
+
+  /**
+   * Check if the runtime looks like a Node environment.
+   * @returns {boolean}
+   */
+  isNode() {
+    return typeof globalThis.process !== "undefined" && typeof globalThis.process.on === "function"
+  }
+
+  /**
+   * Enable source map loading for environments with script tags.
+   * @returns {boolean}
+   */
+  enableSourceMapsLoader() {
+    if (typeof window === "undefined" || typeof document === "undefined") {
+      return false
+    }
+
+    if (!this.sourceMapsLoader) {
+      this.sourceMapsLoader = new SourceMapsLoader()
+    }
+
+    this.sourceMapsLoader.loadSourceMapsForScriptTags((script) => {
+      const src = script.getAttribute("src")
+      const type = script.getAttribute("type")
+
+      if (this.loadSourceMapForScriptTagsCallback && src && (type == "text/javascript" || !type)) {
+        debuggerInstance.debug(`Loading source map for ${src}`)
+        const result = this.loadSourceMapForScriptTagsCallback(script)
+
+        if (result) {
+          return result
+        }
+      }
+    })
+
+    return true
+  }
+
+  /**
+   * Wire the window error handler.
+   */
+  connectOnError() {
+    globalThis.addEventListener("error", async (event) => {
+      debuggerInstance.debug(`Error cought with message: ${event.message}`)
+      debuggerInstance.debug(`Message: ${event.message}`)
+      debuggerInstance.debug(`File: ${event.filename}`)
+      debuggerInstance.debug(`Line: ${event.lineno}`)
+      debuggerInstance.debug(`Error: ${event.error}`)
+
+      if (!this.isHandlingError) {
+        this.isHandlingError = true
+
+        try {
+          await this.handleError({
+            error: event.error,
+            errorClass: event.error?.name,
+            file: event.filename,
+            line: event.lineno,
+            message: event.message || "Unknown error",
+            url: globalThis.location?.href
+          })
+        } finally {
+          this.isHandlingError = false
+        }
+      }
+    })
+  }
+
+  /**
+   * Wire the unhandled rejection handler.
+   */
+  connectUnhandledRejection() {
+    globalThis.addEventListener("unhandledrejection", async (event) => {
+      debuggerInstance.debug(`Unhandled rejection: ${JSON.stringify(event.reason.message || event.reason)}`)
+
+      if (!this.isHandlingError) {
+        this.isHandlingError = true
+
+        try {
+          await this.handleError({
+            error: event.reason,
+            errorClass: "UnhandledRejection",
+            file: null,
+            line: null,
+            message: event.reason.message || event.reason || "Unhandled promise rejection",
+            url: globalThis.location?.href
+          })
+        } finally {
+          this.isHandlingError = false
+        }
+      }
+    })
+  }
+
+  /**
+   * Wire Expo/React Native global error handlers.
+   * @returns {boolean}
+   */
+  connectExpoErrorHandlers() {
+    if (!this.isExpo()) {
+      return false
+    }
+
+    const previousHandler = typeof globalThis.ErrorUtils.getGlobalHandler === "function"
+      ? globalThis.ErrorUtils.getGlobalHandler()
+      : null
+
+    globalThis.ErrorUtils.setGlobalHandler((error, isFatal) => {
+      debuggerInstance.debug(`Expo error: ${error?.message || error}`)
+
+      if (!this.isHandlingError) {
+        this.isHandlingError = true
+
+        Promise.resolve(
+          this.handleError({
+            error,
+            errorClass: error?.name || (isFatal ? "FatalError" : "ExpoError"),
+            file: null,
+            line: null,
+            message: error?.message || String(error),
+            url: null
+          })
+        ).finally(() => {
+          this.isHandlingError = false
+        })
+      }
+
+      if (previousHandler) {
+        previousHandler(error, isFatal)
+      }
+    })
+
+    return true
+  }
+
+  /**
+   * Wire Node.js uncaught error handlers.
+   */
+  connectNodeUncaughtException() {
+    globalThis.process.on("uncaughtException", async (error) => {
+      debuggerInstance.debug(`Uncaught exception: ${error?.message || error}`)
+
+      if (!this.isHandlingError) {
+        this.isHandlingError = true
+
+        try {
+          await this.handleError({
+            error,
+            errorClass: error?.name || "UncaughtException",
+            file: null,
+            line: null,
+            message: error?.message || String(error),
+            url: null
+          })
+        } finally {
+          this.isHandlingError = false
+        }
+      }
+    })
+  }
+
+  connectNodeUnhandledRejection() {
+    globalThis.process.on("unhandledRejection", async (reason) => {
+      debuggerInstance.debug(`Unhandled rejection: ${JSON.stringify(reason?.message || reason)}`)
+
+      if (!this.isHandlingError) {
+        this.isHandlingError = true
+
+        try {
+          await this.handleError({
+            error: reason instanceof Error ? reason : undefined,
+            errorClass: "UnhandledRejection",
+            file: null,
+            line: null,
+            message: reason?.message || String(reason),
+            url: null
+          })
+        } finally {
+          this.isHandlingError = false
+        }
+      }
+    })
+  }
+
+  /**
+   * Send a formatted error report to Peakflow.
+   * @typedef {Error & {peakflowParameters?: object, peakflowEnvironment?: object}} PeakflowError
+   * @param {object} data
+   * @param {PeakflowError} [data.error]
+   * @param {string} [data.errorClass]
+   * @param {string|null} [data.file]
+   * @param {number|null} [data.line]
+   * @param {string} data.message
+   * @param {string|null} data.url
+   */
+  async handleError(data) {
+    debuggerInstance.debug(`Handle error: ${JSON.stringify(data)}`)
+
+    let backtrace, postUrl
+
+    if (data.error && data.error.stack && this.sourceMapsLoader) {
+      debuggerInstance.debug("Parse stacktrace")
+      await this.sourceMapsLoader.loadSourceMaps(data.error)
+      backtrace = this.sourceMapsLoader.parseStackTrace(data.error.stack)
+    } else if (data.error && data.error.stack) {
+      backtrace = [data.error.stack]
+    } else if (data.file) {
+      debuggerInstance.debug("No stacktrace was present on the error so cant parse it")
+      backtrace = [`${data.file}:${data.line}`]
+    }
+
+    debuggerInstance.debug(`AuthToken: ${this.authToken}`)
+    debuggerInstance.debug(`Backtrace: ${backtrace}`)
+
+    const errorClass = data.errorClass || "UnknownError"
+    const postData = {
+      auth_token: this.authToken,
+      error: {
+        backtrace,
+        error_class: errorClass,
+        message: data.message,
+        url: data.url,
+        user_agent: typeof globalThis.navigator !== "undefined" && globalThis.navigator
+          ? globalThis.navigator.userAgent
+          : null
+      }
+    }
+
+    if (this.testing) {
+      postUrl = RailsVariables.bugReportsPath
+    } else {
+      postUrl = RailsVariables.bugReportsUrl
+    }
+
+    debuggerInstance.debug(`Sending error report to: ${postUrl}`)
+
+    if (data.error?.peakflowParameters) {
+      postData.error.parameters = data.error.peakflowParameters
+    } else {
+      debuggerInstance.debug("Resolving params")
+      postData.error.parameters = await this.resolveParams(data)
+      debuggerInstance.debug("Resolved params", postData.error.parameters)
+    }
+
+    if (data.error?.peakflowEnvironment) {
+      postData.error.environment = data.error.peakflowEnvironment
+    } else {
+      debuggerInstance.debug("Resolving environment")
+      postData.error.environment = await this.resolveEnvironment(data)
+      debuggerInstance.debug("Resolved environment", postData.error.environment)
+    }
+
+    if (typeof XMLHttpRequest === "undefined") {
+      debuggerInstance.debug("Skipping error report because XMLHttpRequest is unavailable")
+      return
+    }
+
+    const xhr = new XMLHttpRequest()
+
+    xhr.open("POST", postUrl, true)
+    xhr.setRequestHeader("Content-Type", "application/json")
+
+    await this.loadXhr(xhr, JSON.stringify(postData))
+
+    debuggerInstance.debug(`Data received: ${xhr.responseText}`)
+
+    const response = JSON.parse(digg(xhr, "responseText"))
+
+    // If the account has run out of bug reports, then this can potentially crash because 'url' wont be present.
+    if (response.url) {
+      console.log(`Peakflow: Error was reported: ${digg(response, "url")}`)
+    }
+  }
+
+  /**
+   * Register a hook for loading source maps from script tags.
+   * @param {(script: HTMLScriptElement) => Promise<unknown>|unknown} callback
+   */
+  loadSourceMapForScriptTags(callback) {
+    this.loadSourceMapForScriptTagsCallback = callback
+  }
+
+  /**
+   * Parse a URL using a DOM anchor element.
+   * @param {string} url
+   * @returns {HTMLAnchorElement|null}
+   */
+  loadUrl(url) {
+    if (!this.isBrowser()) {
+      return null
+    }
+
+    const parser = globalThis.document.createElement("a")
+
+    parser.href = url
+
+    return parser
+  }
+
+  /**
+   * Send JSON data through an XHR instance.
+   * @param {XMLHttpRequest} xhr
+   * @param {string} postData
+   * @returns {Promise<void>}
+   */
+  loadXhr(xhr, postData) {
+    return new Promise((resolve) => {
+      xhr.onload = () => resolve()
+      xhr.send(postData)
+    })
+  }
+
+  /**
+   * Resolve environment data for a report.
+   * @param {object} args
+   * @returns {Promise<object|undefined>}
+   */
+  async resolveEnvironment(args) {
+    if (this.collectEnvironmentCallback) {
+      return await this.collectEnvironmentCallback(args)
+    }
+  }
+
+  /**
+   * Resolve request parameters for a report.
+   * @param {object} args
+   * @returns {Promise<object|undefined>}
+   */
+  async resolveParams(args) {
+    if (this.collectParamsCallback) {
+      return await this.collectParamsCallback(args)
+    } else if (typeof globalThis.location === "object" && globalThis.location) {
+      const search = typeof globalThis.location.search === "string" ? globalThis.location.search : ""
+      return qs.parse(search.substr(1))
+    }
+  }
+
+  /**
+   * Toggle testing mode for posting to local paths.
+   * @param {boolean} value
+   */
+  setTesting(value) {
+    this.testing = value
+  }
+}

package/src/bug-reporting/variables.js

@@ -0,0 +1,4 @@
+export default {
+  bugReportsPath: "/errors/reports",
+  bugReportsUrl: "https://www.peakflow.io/errors/reports"
+}

package/src/debugger.js

@@ -0,0 +1,34 @@
+/**
+ * Simple logger for toggling Peakflow client debug output.
+ */
+export default class Debugger {
+  /**
+   * Create a debugger instance.
+   */
+  constructor() {
+    this.debugging = false
+  }
+
+  /**
+   * Log messages when debugging is enabled.
+   * @param {...unknown} messages
+   */
+  debug(...messages) {
+    if (this.debugging) {
+      console.log("Peakflow JS errors:", ...messages)
+    }
+  }
+
+  /**
+   * Enable or disable debug logging.
+   * @param {boolean} value
+   */
+  setDebugging(value) {
+    this.debugging = value
+  }
+}
+
+/**
+ * Shared debugger instance for the package.
+ */
+export const debuggerInstance = new Debugger()

package/src/index.js

@@ -0,0 +1,4 @@
+import BugReporting from "./bug-reporting/index.js"
+import Debugger, {debuggerInstance} from "./debugger.js"
+
+export {BugReporting, Debugger, debuggerInstance}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
+    "moduleResolution": "node",
+    "allowJs": true,
+    "checkJs": true,
+    "declaration": true,
+    "declarationMap": true,
+    "lib": ["ES2020", "DOM"],
+    "outDir": "build",
+    "rootDir": "src",
+    "inlineSourceMap": true,
+    "noEmitOnError": true,
+    "strict": false,
+    "types": []
+  },
+  "include": ["src/**/*.js"]
+}