@borisch/snitch 1.0.0

package/README.md

@@ -0,0 +1,88 @@
+# Snitch
+
+Modular analytics tracking library. Compose your tracker from small, focused plugins and transports.
+
+## Install
+
+```bash
+npm install @borisch/snitch
+```
+
+## Quick Start
+
+```ts
+import { snitch, sessionPlugin, scrollPlugin, beaconTransportPlugin } from '@borisch/snitch'
+
+const captureEvent = snitch(
+  sessionPlugin(),
+  scrollPlugin({ threshold: 25 }),
+  beaconTransportPlugin({ url: 'https://analytics.example.com/collect' })
+)
+
+// Manually capture events
+captureEvent('button_click', { buttonId: 'signup' })
+```
+
+The `snitch()` function accepts any number of plugins and returns a `captureEvent` function. Plugins can:
+
+- **Provide event parameters** (automatically attached to every event)
+- **Emit events** on their own (e.g. scroll milestones, page views)
+- **Transport events** to a backend (Beacon API, fetch, VK Bridge, etc.)
+- **Intercept events** before they are sent
+
+## Plugins
+
+| Plugin             | Factory                  | Description                                                |
+| ------------------ | ------------------------ | ---------------------------------------------------------- |
+| Session            | `sessionPlugin()`        | Generates a unique session ID, attaches it to every event  |
+| Launch             | `launchPlugin()`         | Captures a `launch` event on initialization                |
+| Scroll             | `scrollPlugin(opts)`     | Tracks scroll depth milestones (default: 25/50/75/100%)    |
+| Location           | `locationPlugin()`       | Attaches page URL and referrer to every event              |
+| Engagement         | `engagementPlugin(opts)` | Tracks time spent on page, emits engagement events         |
+| Screens            | `screenPlugin()`         | Tracks screen/page view events                             |
+| Exceptions         | `exceptionsPlugin()`     | Captures unhandled errors and unhandled promise rejections |
+| Web Vitals         | `webVitalsPlugin()`      | Reports Core Web Vitals (LCP, FID, CLS, etc.)              |
+| Flag               | `flagPlugin(opts)`       | Attaches a static key-value flag to every event            |
+| User Agent         | `useragentPlugin()`      | Attaches `navigator.userAgent` to every event              |
+| Debug Logger       | `debugLoggerPlugin()`    | Logs all events to the console (for development)           |
+| VK Mini App Launch | `vkmaLaunchPlugin()`     | Parses VK Mini App launch parameters                       |
+
+## Transports
+
+| Transport   | Factory                          | Description                                                                     |
+| ----------- | -------------------------------- | ------------------------------------------------------------------------------- |
+| Beacon      | `beaconTransportPlugin(opts)`    | Sends events as URL query params via `navigator.sendBeacon()`                   |
+| S2S         | `s2sTransportPlugin(opts)`       | Sends events as URL query params via `fetch()` GET (for server-side / Node 18+) |
+| Top Mail.ru | `topmailruTransportPlugin(opts)` | Sends events to Top Mail.ru counter                                             |
+| VK Bridge   | `vkBridgeTransportPlugin(opts)`  | Sends events via VK Bridge                                                      |
+
+## Types
+
+All public types are exported for TypeScript consumers:
+
+```ts
+import type { Plugin, EventTransport, TrackerEventPayload } from '@borisch/snitch'
+```
+
+## Writing a Custom Plugin
+
+A plugin is any object that partially implements the `Plugin` interface:
+
+```ts
+import type { Plugin } from '@borisch/snitch'
+
+function myPlugin(): Plugin {
+  return {
+    getEventPayloadParams() {
+      return { customParam: 'value' }
+    },
+    sendEvent(eventName, eventParams) {
+      // custom transport logic
+    }
+  }
+}
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { default as snitch } from './packages/snitch/index';
+export { default } from './packages/snitch/index';
+export type { Plugin, EventPayloadParamsProvider, InitializationHandler, EventSource, BeforeCaptureEventHandler, EventTransport, MixinProvider, } from './packages/common/plugin-interfaces';
+export type { TrackerEventPayload, EventHandler, TrackerInitializationOptions, } from './packages/common/tracker-interfaces';
+export { default as scrollPlugin } from './packages/snitch-plugin-scroll/index';
+export { default as locationPlugin } from './packages/snitch-plugin-location/index';
+export { default as sessionPlugin } from './packages/snitch-plugin-session/index';
+export { default as launchPlugin } from './packages/snitch-plugin-launch/index';
+export { default as engagementPlugin } from './packages/snitch-plugin-engagement/index';
+export { default as screenPlugin } from './packages/snitch-plugin-screens/index';
+export { default as exceptionsPlugin } from './packages/snitch-plugin-exceptions/index';
+export { default as webVitalsPlugin } from './packages/snitch-plugin-web-vitals/index';
+export { default as flagPlugin } from './packages/snitch-plugin-flag/index';
+export { default as debugLoggerPlugin } from './packages/snitch-plugin-debug-logger/index';
+export { default as useragentPlugin } from './packages/snitch-plugin-useragent/index';
+export { default as beaconTransportPlugin } from './packages/snitch-plugin-beacon-transport/index';
+export { default as s2sTransportPlugin } from './packages/snitch-plugin-s2s-transport/index';
+export { default as topmailruTransportPlugin } from './packages/snitch-plugin-topmailru-transport/index';
+export { default as vkBridgeTransportPlugin } from './packages/snitch-plugin-vkbridge-transport/index';
+export { default as vkmaLaunchPlugin } from './packages/snitch-plugin-vkma-launch/index';

package/dist/index.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vkmaLaunchPlugin = exports.vkBridgeTransportPlugin = exports.topmailruTransportPlugin = exports.s2sTransportPlugin = exports.beaconTransportPlugin = exports.useragentPlugin = exports.debugLoggerPlugin = exports.flagPlugin = exports.webVitalsPlugin = exports.exceptionsPlugin = exports.screenPlugin = exports.engagementPlugin = exports.launchPlugin = exports.sessionPlugin = exports.locationPlugin = exports.scrollPlugin = exports.default = exports.snitch = void 0;
+// Core
+var index_1 = require("./packages/snitch/index");
+Object.defineProperty(exports, "snitch", { enumerable: true, get: function () { return __importDefault(index_1).default; } });
+var index_2 = require("./packages/snitch/index");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(index_2).default; } });
+// Plugins
+var index_3 = require("./packages/snitch-plugin-scroll/index");
+Object.defineProperty(exports, "scrollPlugin", { enumerable: true, get: function () { return __importDefault(index_3).default; } });
+var index_4 = require("./packages/snitch-plugin-location/index");
+Object.defineProperty(exports, "locationPlugin", { enumerable: true, get: function () { return __importDefault(index_4).default; } });
+var index_5 = require("./packages/snitch-plugin-session/index");
+Object.defineProperty(exports, "sessionPlugin", { enumerable: true, get: function () { return __importDefault(index_5).default; } });
+var index_6 = require("./packages/snitch-plugin-launch/index");
+Object.defineProperty(exports, "launchPlugin", { enumerable: true, get: function () { return __importDefault(index_6).default; } });
+var index_7 = require("./packages/snitch-plugin-engagement/index");
+Object.defineProperty(exports, "engagementPlugin", { enumerable: true, get: function () { return __importDefault(index_7).default; } });
+var index_8 = require("./packages/snitch-plugin-screens/index");
+Object.defineProperty(exports, "screenPlugin", { enumerable: true, get: function () { return __importDefault(index_8).default; } });
+var index_9 = require("./packages/snitch-plugin-exceptions/index");
+Object.defineProperty(exports, "exceptionsPlugin", { enumerable: true, get: function () { return __importDefault(index_9).default; } });
+var index_10 = require("./packages/snitch-plugin-web-vitals/index");
+Object.defineProperty(exports, "webVitalsPlugin", { enumerable: true, get: function () { return __importDefault(index_10).default; } });
+var index_11 = require("./packages/snitch-plugin-flag/index");
+Object.defineProperty(exports, "flagPlugin", { enumerable: true, get: function () { return __importDefault(index_11).default; } });
+var index_12 = require("./packages/snitch-plugin-debug-logger/index");
+Object.defineProperty(exports, "debugLoggerPlugin", { enumerable: true, get: function () { return __importDefault(index_12).default; } });
+var index_13 = require("./packages/snitch-plugin-useragent/index");
+Object.defineProperty(exports, "useragentPlugin", { enumerable: true, get: function () { return __importDefault(index_13).default; } });
+// Transports
+var index_14 = require("./packages/snitch-plugin-beacon-transport/index");
+Object.defineProperty(exports, "beaconTransportPlugin", { enumerable: true, get: function () { return __importDefault(index_14).default; } });
+var index_15 = require("./packages/snitch-plugin-s2s-transport/index");
+Object.defineProperty(exports, "s2sTransportPlugin", { enumerable: true, get: function () { return __importDefault(index_15).default; } });
+var index_16 = require("./packages/snitch-plugin-topmailru-transport/index");
+Object.defineProperty(exports, "topmailruTransportPlugin", { enumerable: true, get: function () { return __importDefault(index_16).default; } });
+var index_17 = require("./packages/snitch-plugin-vkbridge-transport/index");
+Object.defineProperty(exports, "vkBridgeTransportPlugin", { enumerable: true, get: function () { return __importDefault(index_17).default; } });
+// Platform-specific
+var index_18 = require("./packages/snitch-plugin-vkma-launch/index");
+Object.defineProperty(exports, "vkmaLaunchPlugin", { enumerable: true, get: function () { return __importDefault(index_18).default; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO;AACP,iDAA2D;AAAlD,gHAAA,OAAO,OAAU;AAC1B,iDAAiD;AAAxC,iHAAA,OAAO,OAAA;AAmBhB,UAAU;AACV,+DAA+E;AAAtE,sHAAA,OAAO,OAAgB;AAChC,iEAAmF;AAA1E,wHAAA,OAAO,OAAkB;AAClC,gEAAiF;AAAxE,uHAAA,OAAO,OAAiB;AACjC,+DAA+E;AAAtE,sHAAA,OAAO,OAAgB;AAChC,mEAAuF;AAA9E,0HAAA,OAAO,OAAoB;AACpC,gEAAgF;AAAvE,sHAAA,OAAO,OAAgB;AAChC,mEAAuF;AAA9E,0HAAA,OAAO,OAAoB;AACpC,oEAAsF;AAA7E,0HAAA,OAAO,OAAmB;AACnC,8DAA2E;AAAlE,qHAAA,OAAO,OAAc;AAC9B,sEAA0F;AAAjF,4HAAA,OAAO,OAAqB;AACrC,mEAAqF;AAA5E,0HAAA,OAAO,OAAmB;AAEnC,aAAa;AACb,0EAAkG;AAAzF,gIAAA,OAAO,OAAyB;AACzC,uEAA4F;AAAnF,6HAAA,OAAO,OAAsB;AACtC,6EAAwG;AAA/F,mIAAA,OAAO,OAA4B;AAC5C,4EAAsG;AAA7F,kIAAA,OAAO,OAA2B;AAE3C,oBAAoB;AACpB,qEAAwF;AAA/E,2HAAA,OAAO,OAAoB"}

package/dist/packages/common/anonymous-id-store.d.ts

@@ -0,0 +1,2 @@
+export declare function setAnonymousUserId(userId: string): void;
+export declare function getAnonymousUserId(): string | null;

package/dist/packages/common/anonymous-id-store.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAnonymousUserId = exports.setAnonymousUserId = void 0;
+const LOCAL_STORAGE_USER_ID_KEY = 'isdp:auid';
+let anonymousUserIdCache;
+function setAnonymousUserId(userId) {
+    try {
+        localStorage.setItem(LOCAL_STORAGE_USER_ID_KEY, userId);
+    }
+    catch (error) { }
+    anonymousUserIdCache = userId;
+}
+exports.setAnonymousUserId = setAnonymousUserId;
+function getAnonymousUserId() {
+    if (anonymousUserIdCache)
+        return anonymousUserIdCache;
+    try {
+        anonymousUserIdCache = localStorage.getItem(LOCAL_STORAGE_USER_ID_KEY);
+    }
+    catch (error) {
+        console.warn(error);
+        return null;
+    }
+    return anonymousUserIdCache;
+}
+exports.getAnonymousUserId = getAnonymousUserId;
+//# sourceMappingURL=anonymous-id-store.js.map

package/dist/packages/common/anonymous-id-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anonymous-id-store.js","sourceRoot":"","sources":["../../../packages/common/anonymous-id-store.ts"],"names":[],"mappings":";;;AAAA,MAAM,yBAAyB,GAAG,WAAW,CAAA;AAC7C,IAAI,oBAAmC,CAAA;AAEvC,SAAgB,kBAAkB,CAAC,MAAc;IAC/C,IAAI;QACF,YAAY,CAAC,OAAO,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAA;KACxD;IAAC,OAAO,KAAK,EAAE,GAAE;IAClB,oBAAoB,GAAG,MAAM,CAAA;AAC/B,CAAC;AALD,gDAKC;AAED,SAAgB,kBAAkB;IAChC,IAAI,oBAAoB;QAAE,OAAO,oBAAoB,CAAA;IACrD,IAAI;QACF,oBAAoB,GAAG,YAAY,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAA;KACvE;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnB,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,oBAAoB,CAAA;AAC7B,CAAC;AATD,gDASC"}

package/dist/packages/common/create-unique-id.d.ts

@@ -0,0 +1 @@
+export default function createUniqueId(): string;

package/dist/packages/common/create-unique-id.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function createUniqueId() {
+    let uniqueId = '';
+    const length = 32;
+    const alphabet = 'useandom26T198340PX75pxJACKVERYMINDBUSHWOLFGQZbfghjklqvwyzrict';
+    const alphabetLength = alphabet.length;
+    for (var i = 0; i < length; i++) {
+        uniqueId += alphabet.charAt(Math.floor(Math.random() * alphabetLength));
+    }
+    return uniqueId;
+}
+exports.default = createUniqueId;
+//# sourceMappingURL=create-unique-id.js.map

package/dist/packages/common/create-unique-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-unique-id.js","sourceRoot":"","sources":["../../../packages/common/create-unique-id.ts"],"names":[],"mappings":";;AAAA,SAAwB,cAAc;IACpC,IAAI,QAAQ,GAAG,EAAE,CAAA;IACjB,MAAM,MAAM,GAAG,EAAE,CAAA;IACjB,MAAM,QAAQ,GAAG,gEAAgE,CAAA;IACjF,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAA;IACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE;QAC/B,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAA;KACxE;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AATD,iCASC"}

package/dist/packages/common/plugin-interfaces.d.ts

@@ -0,0 +1,22 @@
+import { EventHandler, TrackerEventPayload } from './tracker-interfaces';
+export interface EventPayloadParamsProvider {
+    getEventPayloadParams(): {
+        [key: string]: string | number;
+    };
+}
+export interface InitializationHandler {
+    onInit(): void;
+}
+export interface EventSource {
+    setEventHandler(eventHandler: EventHandler): void;
+}
+export interface BeforeCaptureEventHandler {
+    beforeCaptureEvent(eventName: string, eventParams?: TrackerEventPayload): void;
+}
+export interface EventTransport {
+    sendEvent(eventName: string, eventParams?: TrackerEventPayload): void;
+}
+export interface MixinProvider {
+    getMixins(): Record<string, Function>;
+}
+export declare type Plugin = Partial<EventPayloadParamsProvider & InitializationHandler & BeforeCaptureEventHandler & EventTransport & EventSource & MixinProvider>;

package/dist/packages/common/plugin-interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=plugin-interfaces.js.map

package/dist/packages/common/plugin-interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-interfaces.js","sourceRoot":"","sources":["../../../packages/common/plugin-interfaces.ts"],"names":[],"mappings":""}

package/dist/packages/common/tmr.d.ts

@@ -0,0 +1,38 @@
+declare global {
+    interface Window {
+        _tmr: TMRCounter | UninitializedTMRCounter;
+    }
+}
+export declare type UninitializedTMRCounter = Array<TMRInstructionSendCustomEvent | TMRInstructionSetUserId | TMRInstructionUnsetUserId | TMRInstructionSetOnReadyCallback>;
+interface TMRInstruction {
+    id: string;
+    type: string;
+}
+export interface TMRInstructionSendCustomEvent extends TMRInstruction {
+    type: 'reachGoal';
+    goal: string;
+    params?: IMRCustomEventParams;
+    value?: number;
+    version?: string;
+    userid?: string;
+}
+export interface IMRCustomEventParams {
+    [key: string]: string | number | boolean;
+}
+export interface TMRInstructionSetUserId {
+    type: 'setUserID';
+    userid: string;
+}
+export interface TMRInstructionUnsetUserId {
+    type: 'deleteUserID';
+}
+export interface TMRInstructionSetOnReadyCallback {
+    type: 'onReady';
+    callback: Function;
+}
+export interface TMRCounter {
+    push(instruction: TMRInstructionSendCustomEvent | TMRInstructionSetUserId | TMRInstructionUnsetUserId | TMRInstructionSetOnReadyCallback): void;
+    getUserID(): string | undefined;
+}
+export declare const getTMRCounterUserId: () => string | null | undefined;
+export {};

package/dist/packages/common/tmr.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTMRCounterUserId = void 0;
+const getTMRCounterUserId = () => {
+    const _tmr = window._tmr;
+    if (_tmr.getUserID)
+        return _tmr.getUserID();
+    const userId = window._tmr.reduce((userId, eventCandidate) => {
+        if (eventCandidate.type === 'setUserID')
+            return eventCandidate.userid;
+        return userId;
+    }, '');
+    return userId || null;
+};
+exports.getTMRCounterUserId = getTMRCounterUserId;
+//# sourceMappingURL=tmr.js.map

package/dist/packages/common/tmr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmr.js","sourceRoot":"","sources":["../../../packages/common/tmr.ts"],"names":[],"mappings":";;;AAwDO,MAAM,mBAAmB,GAAG,GAAG,EAAE;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAkB,CAAA;IACtC,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC,SAAS,EAAE,CAAA;IAC3C,MAAM,MAAM,GAAI,MAAM,CAAC,IAAgC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE;QACxF,IAAI,cAAc,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,cAAc,CAAC,MAAM,CAAA;QACrE,OAAO,MAAM,CAAA;IACf,CAAC,EAAE,EAAE,CAAC,CAAA;IACN,OAAO,MAAM,IAAI,IAAI,CAAA;AACvB,CAAC,CAAA;AARY,QAAA,mBAAmB,uBAQ/B"}

package/dist/packages/common/tracker-interfaces.d.ts

@@ -0,0 +1,8 @@
+import { Plugin } from './plugin-interfaces';
+export declare type TrackerEventPayload = {
+    [key: string]: string | number;
+};
+export declare type EventHandler = (eventName: string, eventPayload?: TrackerEventPayload) => void;
+export declare type TrackerInitializationOptions = {
+    plugins?: Array<Plugin>;
+};

package/dist/packages/common/tracker-interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tracker-interfaces.js.map

package/dist/packages/common/tracker-interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker-interfaces.js","sourceRoot":"","sources":["../../../packages/common/tracker-interfaces.ts"],"names":[],"mappings":""}

package/dist/packages/snitch/index.d.ts

@@ -0,0 +1,2 @@
+import snitch from './snitch';
+export default snitch;

package/dist/packages/snitch/index.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const snitch_1 = __importDefault(require("./snitch"));
+exports.default = snitch_1.default;
+//# sourceMappingURL=index.js.map

package/dist/packages/snitch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/snitch/index.ts"],"names":[],"mappings":";;;;;AAAA,sDAA6B;AAC7B,kBAAe,gBAAM,CAAA"}

package/dist/packages/snitch/snitch.d.ts

@@ -0,0 +1,4 @@
+import { Plugin } from '../common/plugin-interfaces';
+import { TrackerEventPayload } from '../common/tracker-interfaces';
+declare const _default: (...args: Array<Plugin>) => (eventName: string, eventPayload?: TrackerEventPayload | undefined) => void;
+export default _default;

package/dist/packages/snitch/snitch.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const use_plugins_1 = __importDefault(require("./use-plugins"));
+exports.default = (...args) => {
+    const plugins = use_plugins_1.default(args);
+    const captureEvent = (eventName, eventPayload) => {
+        plugins.callBeforeCaptureEventHandlers(eventName, eventPayload);
+        plugins.callTransports(eventName, plugins.callEventPayloadParamsProviders({
+            ...eventPayload
+        }));
+    };
+    plugins.setEventHandler(captureEvent);
+    plugins.callInitializationHandlers();
+    plugins.applyMixins(captureEvent);
+    return captureEvent;
+};
+//# sourceMappingURL=snitch.js.map

package/dist/packages/snitch/snitch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snitch.js","sourceRoot":"","sources":["../../../packages/snitch/snitch.ts"],"names":[],"mappings":";;;;;AAEA,gEAAsC;AAEtC,kBAAe,CAAC,GAAG,IAAmB,EAAE,EAAE;IACxC,MAAM,OAAO,GAAG,qBAAU,CAAC,IAAI,CAAC,CAAA;IAEhC,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAE,YAAkC,EAAE,EAAE;QAC7E,OAAO,CAAC,8BAA8B,CAAC,SAAS,EAAE,YAAY,CAAC,CAAA;QAC/D,OAAO,CAAC,cAAc,CACpB,SAAS,EACT,OAAO,CAAC,+BAA+B,CAAC;YACtC,GAAG,YAAY;SAChB,CAAC,CACH,CAAA;IACH,CAAC,CAAA;IAED,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAA;IACrC,OAAO,CAAC,0BAA0B,EAAE,CAAA;IACpC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IACjC,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA"}

package/dist/packages/snitch/use-plugins.d.ts

@@ -0,0 +1,11 @@
+import { Plugin } from '../common/plugin-interfaces';
+import { EventHandler, TrackerEventPayload } from '../common/tracker-interfaces';
+declare const _default: (plugins: Array<Plugin>) => {
+    callBeforeCaptureEventHandlers(eventName: string, eventPayload?: TrackerEventPayload | undefined): void;
+    callEventPayloadParamsProviders(eventPayload: TrackerEventPayload): TrackerEventPayload;
+    callTransports(eventName: string, eventPayload?: TrackerEventPayload | undefined): void;
+    callInitializationHandlers(): void;
+    setEventHandler(eventHandler: EventHandler): void;
+    applyMixins(eventHandler: EventHandler): void;
+};
+export default _default;

package/dist/packages/snitch/use-plugins.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = (plugins) => ({
+    callBeforeCaptureEventHandlers(eventName, eventPayload) {
+        plugins.forEach(plugin => {
+            var _a;
+            (_a = plugin.beforeCaptureEvent) === null || _a === void 0 ? void 0 : _a.call(plugin, eventName, eventPayload);
+        });
+    },
+    callEventPayloadParamsProviders(eventPayload) {
+        return plugins.reduce((params, plugin) => {
+            var _a;
+            return ({
+                ...params,
+                ...(((_a = plugin.getEventPayloadParams) === null || _a === void 0 ? void 0 : _a.call(plugin)) || {})
+            });
+        }, eventPayload);
+    },
+    callTransports(eventName, eventPayload) {
+        plugins.forEach(plugin => {
+            var _a;
+            (_a = plugin.sendEvent) === null || _a === void 0 ? void 0 : _a.call(plugin, eventName, eventPayload);
+        });
+    },
+    callInitializationHandlers() {
+        plugins.forEach(plugin => { var _a; return (_a = plugin.onInit) === null || _a === void 0 ? void 0 : _a.call(plugin); });
+    },
+    setEventHandler(eventHandler) {
+        plugins.forEach(plugin => { var _a; return (_a = plugin.setEventHandler) === null || _a === void 0 ? void 0 : _a.call(plugin, eventHandler); });
+    },
+    applyMixins(eventHandler) {
+        Object.setPrototypeOf(eventHandler, plugins.reduce((mixins, plugin) => {
+            if (plugin.getMixins) {
+                return { ...mixins, ...plugin.getMixins() };
+            }
+            return mixins;
+        }, {}));
+    }
+});
+//# sourceMappingURL=use-plugins.js.map

package/dist/packages/snitch/use-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-plugins.js","sourceRoot":"","sources":["../../../packages/snitch/use-plugins.ts"],"names":[],"mappings":";;AAGA,kBAAe,CAAC,OAAsB,EAAE,EAAE,CAAC,CAAC;IAC1C,8BAA8B,CAAC,SAAiB,EAAE,YAAkC;QAClF,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;;YACvB,MAAA,MAAM,CAAC,kBAAkB,+CAAzB,MAAM,EAAsB,SAAS,EAAE,YAAY,CAAC,CAAA;QACtD,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,+BAA+B,CAAC,YAAiC;QAC/D,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;;YAAC,OAAA,CAAC;gBACnB,GAAG,MAAM;gBACT,GAAG,CAAC,CAAA,MAAA,MAAM,CAAC,qBAAqB,+CAA5B,MAAM,CAA0B,KAAI,EAAE,CAAC;aAC5C,CAAC,CAAA;SAAA,EACF,YAAY,CACb,CAAA;IACH,CAAC;IAED,cAAc,CAAC,SAAiB,EAAE,YAAkC;QAClE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;;YACvB,MAAA,MAAM,CAAC,SAAS,+CAAhB,MAAM,EAAa,SAAS,EAAE,YAAY,CAAC,CAAA;QAC7C,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,0BAA0B;QACxB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,WAAC,OAAA,MAAA,MAAM,CAAC,MAAM,+CAAb,MAAM,CAAW,CAAA,EAAA,CAAC,CAAA;IAC9C,CAAC;IAED,eAAe,CAAC,YAA0B;QACxC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,WAAC,OAAA,MAAA,MAAM,CAAC,eAAe,+CAAtB,MAAM,EAAmB,YAAY,CAAC,CAAA,EAAA,CAAC,CAAA;IACnE,CAAC;IAED,WAAW,CAAC,YAA0B;QACpC,MAAM,CAAC,cAAc,CACnB,YAAY,EACZ,OAAO,CAAC,MAAM,CAAC,CAAC,MAAgC,EAAE,MAAM,EAAE,EAAE;YAC1D,IAAI,MAAM,CAAC,SAAS,EAAE;gBACpB,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,EAAE,CAAA;aAC5C;YACD,OAAO,MAAM,CAAA;QACf,CAAC,EAAE,EAAE,CAAC,CACP,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/packages/snitch-plugin-beacon-transport/beacon-transport.d.ts

@@ -0,0 +1,6 @@
+import { EventTransport } from '../common/plugin-interfaces';
+export declare type BeaconTransportOptions = {
+    hostname?: string;
+    path?: string;
+};
+export default function beaconTransportPlugin(options?: BeaconTransportOptions): EventTransport;

package/dist/packages/snitch-plugin-beacon-transport/beacon-transport.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function beaconTransportPlugin(options) {
+    var _a, _b;
+    const hostname = (_a = options === null || options === void 0 ? void 0 : options.hostname) !== null && _a !== void 0 ? _a : window.location.hostname;
+    const path = (_b = options === null || options === void 0 ? void 0 : options.path) !== null && _b !== void 0 ? _b : '/_snitch';
+    return {
+        sendEvent(eventName, eventParams) {
+            const protocol = window.location.protocol;
+            const params = new URLSearchParams({ event: eventName });
+            if (eventParams) {
+                for (const key of Object.keys(eventParams)) {
+                    params.set(key, String(eventParams[key]));
+                }
+            }
+            const url = `${protocol}//${hostname}${path}?${params.toString()}`;
+            navigator.sendBeacon(url);
+        }
+    };
+}
+exports.default = beaconTransportPlugin;
+//# sourceMappingURL=beacon-transport.js.map

package/dist/packages/snitch-plugin-beacon-transport/beacon-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon-transport.js","sourceRoot":"","sources":["../../../packages/snitch-plugin-beacon-transport/beacon-transport.ts"],"names":[],"mappings":";;AAQA,SAAwB,qBAAqB,CAAC,OAAgC;;IAC5E,MAAM,QAAQ,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,mCAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAA;IAC9D,MAAM,IAAI,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,IAAI,mCAAI,UAAU,CAAA;IAExC,OAAO;QACL,SAAS,CAAC,SAAiB,EAAE,WAAiC;YAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAA;YACzC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;YACxD,IAAI,WAAW,EAAE;gBACf,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE;oBAC1C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;iBAC1C;aACF;YACD,MAAM,GAAG,GAAG,GAAG,QAAQ,KAAK,QAAQ,GAAG,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAA;YAClE,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QAC3B,CAAC;KACF,CAAA;AACH,CAAC;AAjBD,wCAiBC"}

package/dist/packages/snitch-plugin-beacon-transport/index.d.ts

@@ -0,0 +1,2 @@
+import beaconTransportPlugin from './beacon-transport';
+export default beaconTransportPlugin;

package/dist/packages/snitch-plugin-beacon-transport/index.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const beacon_transport_1 = __importDefault(require("./beacon-transport"));
+exports.default = beacon_transport_1.default;
+//# sourceMappingURL=index.js.map

package/dist/packages/snitch-plugin-beacon-transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/snitch-plugin-beacon-transport/index.ts"],"names":[],"mappings":";;;;;AAAA,0EAAsD;AACtD,kBAAe,0BAAqB,CAAA"}

package/dist/packages/snitch-plugin-debug-logger/debug-logger.d.ts

@@ -0,0 +1,2 @@
+import { BeforeCaptureEventHandler, InitializationHandler } from '../common/plugin-interfaces';
+export default function engagementPlugin(): InitializationHandler & BeforeCaptureEventHandler;

package/dist/packages/snitch-plugin-debug-logger/debug-logger.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+function engagementPlugin() {
+    let lastLogTS = null;
+    function logLine(message) {
+        const now = new Date();
+        console.log(`%c[${now.getHours()}:${now.getMinutes()}:${now.getSeconds()}]${lastLogTS ? ` (+${Math.floor((now.getTime() - lastLogTS) / 1e3)}s)` : ''} %cSnitch: %c${message}`, 'color: gray', 'color: black', 'font-weight: bold');
+        lastLogTS = now.getTime();
+    }
+    return {
+        onInit() {
+            logLine('snitch instance created');
+        },
+        beforeCaptureEvent(eventName, eventPayload) {
+            logLine(`captured event '${eventName}'`);
+            if (eventPayload && Object.keys(eventPayload).length !== 0)
+                console.table(eventPayload);
+        }
+    };
+}
+exports.default = engagementPlugin;
+//# sourceMappingURL=debug-logger.js.map

package/dist/packages/snitch-plugin-debug-logger/debug-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-logger.js","sourceRoot":"","sources":["../../../packages/snitch-plugin-debug-logger/debug-logger.ts"],"names":[],"mappings":";;AAEA,SAAwB,gBAAgB;IACtC,IAAI,SAAS,GAAkB,IAAI,CAAA;IACnC,SAAS,OAAO,CAAC,OAAe;QAC9B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QACtB,OAAO,CAAC,GAAG,CACT,MAAM,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,IAC1D,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAI,SAAoB,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EACpF,gBAAgB,OAAO,EAAE,EACzB,aAAa,EACb,cAAc,EACd,mBAAmB,CACpB,CAAA;QACD,SAAS,GAAG,GAAG,CAAC,OAAO,EAAE,CAAA;IAC3B,CAAC;IACD,OAAO;QACL,MAAM;YACJ,OAAO,CAAC,yBAAyB,CAAC,CAAA;QACpC,CAAC;QAED,kBAAkB,CAAC,SAAiB,EAAE,YAAiC;YACrE,OAAO,CAAC,mBAAmB,SAAS,GAAG,CAAC,CAAA;YACxC,IAAI,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;QACzF,CAAC;KACF,CAAA;AACH,CAAC;AAxBD,mCAwBC"}

package/dist/packages/snitch-plugin-debug-logger/index.d.ts

@@ -0,0 +1,2 @@
+import debugLoggerPlugin from './debug-logger';
+export default debugLoggerPlugin;

package/dist/packages/snitch-plugin-debug-logger/index.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const debug_logger_1 = __importDefault(require("./debug-logger"));
+exports.default = debug_logger_1.default;
+//# sourceMappingURL=index.js.map

package/dist/packages/snitch-plugin-debug-logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/snitch-plugin-debug-logger/index.ts"],"names":[],"mappings":";;;;;AAAA,kEAA8C;AAC9C,kBAAe,sBAAiB,CAAA"}

package/dist/packages/snitch-plugin-engagement/engagement.d.ts

@@ -0,0 +1,4 @@
+import { EventSource, InitializationHandler } from '../common/plugin-interfaces';
+export default function engagementPlugin(options?: {
+    engagementTrackingIntervalMsec: number;
+}): InitializationHandler & EventSource;

package/dist/packages/snitch-plugin-engagement/engagement.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const DEFAULT_ENGAGEMENT_TRACKING_INTERVAL_MSEC = 10 * 1000; // 10 seconds
+function engagementPlugin(options = { engagementTrackingIntervalMsec: DEFAULT_ENGAGEMENT_TRACKING_INTERVAL_MSEC }) {
+    let captureEvent;
+    return {
+        setEventHandler(eventHandler) {
+            captureEvent = eventHandler;
+        },
+        onInit() {
+            setInterval(() => {
+                if (document.hidden === false)
+                    captureEvent('engage');
+            }, options.engagementTrackingIntervalMsec);
+        }
+    };
+}
+exports.default = engagementPlugin;
+//# sourceMappingURL=engagement.js.map

package/dist/packages/snitch-plugin-engagement/engagement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.js","sourceRoot":"","sources":["../../../packages/snitch-plugin-engagement/engagement.ts"],"names":[],"mappings":";;AAGA,MAAM,yCAAyC,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,aAAa;AAEzE,SAAwB,gBAAgB,CACtC,UAEI,EAAE,8BAA8B,EAAE,yCAAyC,EAAE;IAEjF,IAAI,YAA0B,CAAA;IAE9B,OAAO;QACL,eAAe,CAAC,YAA0B;YACxC,YAAY,GAAG,YAAY,CAAA;QAC7B,CAAC;QAED,MAAM;YACJ,WAAW,CAAC,GAAG,EAAE;gBACf,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK;oBAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;YACvD,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,CAAA;QAC5C,CAAC;KACF,CAAA;AACH,CAAC;AAlBD,mCAkBC"}

package/dist/packages/snitch-plugin-engagement/index.d.ts

@@ -0,0 +1,2 @@
+import engagementPlugin from './engagement';
+export default engagementPlugin;

package/dist/packages/snitch-plugin-engagement/index.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const engagement_1 = __importDefault(require("./engagement"));
+exports.default = engagement_1.default;
+//# sourceMappingURL=index.js.map

package/dist/packages/snitch-plugin-engagement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/snitch-plugin-engagement/index.ts"],"names":[],"mappings":";;;;;AAAA,8DAA2C;AAC3C,kBAAe,oBAAgB,CAAA"}

package/dist/packages/snitch-plugin-exceptions/exceptions.d.ts

@@ -0,0 +1,2 @@
+import { EventSource, InitializationHandler } from '../common/plugin-interfaces';
+export default function exceptionsPlugin(): InitializationHandler & EventSource;