@gem-sdk/clarity-decode 0.8.94

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@gem-sdk/clarity-decode",
+  "version": "0.8.94",
+  "description": "Decode clarity data",
+  "author": "Microsoft Corp.",
+  "license": "MIT",
+  "main": "build/clarity.decode.js",
+  "module": "build/clarity.decode.module.js",
+  "unpkg": "build/clarity.decode.min.js",
+  "types": "types/index.d.ts",
+  "keywords": [],
+  "dependencies": {
+    "@gem-sdk/clarity-js": "^0.8.94"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^24.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-terser": "^0.4.0",
+    "@rollup/plugin-typescript": "^11.0.0",
+    "del-cli": "^5.0.0",
+    "husky": "^8.0.0",
+    "lint-staged": "^13.1.0",
+    "rollup": "^3.0.0",
+    "tslint": "^6.1.3",
+    "typescript": "^4.3.5"
+  },
+  "scripts": {
+    "build": "yarn build:clean && yarn build:main",
+    "build:main": "rollup -c rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "build:clean": "del-cli build/*",
+    "test": "playwright test --config ../../playwright.config.ts --project=clarity-decode",
+    "tslint": "tslint --project ./",
+    "tslint:fix": "tslint --fix --project ./ --force"
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "lint-staged"
+    }
+  },
+  "lint-staged": {
+    "*.ts": [
+      "tslint --format codeFrame"
+    ]
+  }
+}

package/rollup.config.ts

@@ -0,0 +1,32 @@
+import commonjs from "@rollup/plugin-commonjs";
+import resolve from "@rollup/plugin-node-resolve";
+import terser from "@rollup/plugin-terser";
+import typescript from "@rollup/plugin-typescript";
+import { readFileSync } from "fs";
+
+const pkg = JSON.parse(readFileSync("./package.json", "utf-8"));
+
+export default [
+  {
+    input: "src/index.ts",
+    output: [
+      { file: pkg.main, format: "cjs", exports: "named" },
+      { file: pkg.module, format: "es", exports: "named" }
+    ],
+    plugins: [
+      resolve(),
+      typescript(),
+      commonjs({ include: ["node_modules/**"] })
+    ]
+  },
+  {
+    input: "src/global.ts",
+    output: [ { file: pkg.unpkg, format: "iife", exports: "named" } ],
+    plugins: [
+      resolve(),
+      typescript(),
+      terser({output: {comments: false}}),
+      commonjs({ include: ["node_modules/**"] })
+    ]
+  }
+];

package/src/clarity.ts

@@ -0,0 +1,233 @@
+import { Data, version } from "@gem-sdk/clarity-js";
+import { BaselineEvent, CustomEvent, DecodedPayload, DecodedVersion, DimensionEvent } from "../types/data";
+import { LimitEvent, MetricEvent, PingEvent, SummaryEvent, UpgradeEvent, UploadEvent, VariableEvent, ExtractEvent, ConsentEvent } from "../types/data";
+import { FraudEvent, LogEvent, ScriptErrorEvent } from "../types/diagnostic";
+import { ChangeEvent, ClickEvent, ContextMenuEvent, ClipboardEvent, InputEvent, PointerEvent, ResizeEvent, ScrollEvent } from "../types/interaction";
+import { SelectionEvent, SubmitEvent, TimelineEvent, UnloadEvent, VisibilityEvent, FocusEvent } from "../types/interaction";
+import { CustomElementEvent, DocumentEvent, DomEvent, RegionEvent } from "../types/layout";
+import { NavigationEvent } from "../types/performance";
+
+import * as data from "./data";
+import * as diagnostic from "./diagnostic";
+import * as interaction from "./interaction";
+import * as layout from "./layout";
+import * as performance from "./performance";
+
+export function decode(input: string): DecodedPayload {
+    let json: Data.Payload = JSON.parse(input);
+    let envelope = data.envelope(json.e);
+    let timestamp = Date.now();
+    let payload: DecodedPayload = { timestamp, envelope };
+
+    // Sort encoded events by time to simplify summary computation
+    // It's possible for individual events to be out of order, dependent on how they are buffered on the client
+    // E.g. scroll events are queued internally before they are sent over the wire.
+    // By comparison, events like resize & click are sent out immediately.
+    let encoded: Data.Token[][] = json.p ? json.a.concat(json.p) : json.a;
+    encoded = encoded.sort((a: Data.Token[], b: Data.Token[]): number => (a[0] as number) - (b[0] as number));
+
+    // Check if the incoming version is compatible with the current running code
+    // We do an exact match for the major version and minor version.
+    // For patch, we are backward and forward compatible with up to version change.
+    let jsonVersion = parseVersion(payload.envelope.version);
+    let codeVersion = parseVersion(version);
+
+    if (jsonVersion.major !== codeVersion.major ||
+        Math.abs(jsonVersion.minor - codeVersion.minor) > 1) {
+        console.warn(`Invalid version. Actual: ${payload.envelope.version} | Expected: ${version} (+/- 1) | ${input.substr(0, 250)}`);
+    }
+
+    for (let entry of encoded) {
+        switch (entry[1]) {
+            case Data.Event.Baseline:
+                if (payload.baseline === undefined) { payload.baseline = []; }
+                payload.baseline.push(data.decode(entry) as BaselineEvent);
+                break;
+            case Data.Event.Ping:
+                if (payload.ping === undefined) { payload.ping = []; }
+                payload.ping.push(data.decode(entry) as PingEvent);
+                break;
+            case Data.Event.Limit:
+                if (payload.limit === undefined) { payload.limit = []; }
+                payload.limit.push(data.decode(entry) as LimitEvent);
+                break;
+            case Data.Event.Upgrade:
+                if (payload.upgrade === undefined) { payload.upgrade = []; }
+                payload.upgrade.push(data.decode(entry) as UpgradeEvent);
+                break;
+            case Data.Event.Metric:
+                if (payload.metric === undefined) { payload.metric = []; }
+                let metric = data.decode(entry) as MetricEvent;
+                // It's not possible to accurately include the byte count of the payload within the same payload
+                // The value we get from clarity-js lags behind by a payload. To work around that,
+                // we increment the bytes from the incoming payload at decode time.
+                metric.data[Data.Metric.TotalBytes] = input.length;
+                payload.metric.push(metric);
+                break;
+            case Data.Event.Dimension:
+                if (payload.dimension === undefined) { payload.dimension = []; }
+                payload.dimension.push(data.decode(entry) as DimensionEvent);
+                break;
+            case Data.Event.Summary:
+                if (payload.summary === undefined) { payload.summary = []; }
+                payload.summary.push(data.decode(entry) as SummaryEvent);
+                break;
+            case Data.Event.Custom:
+                if (payload.custom === undefined) { payload.custom = []; }
+                payload.custom.push(data.decode(entry) as CustomEvent);
+                break;
+            case Data.Event.Variable:
+                if (payload.variable === undefined) { payload.variable = []; }
+                payload.variable.push(data.decode(entry) as VariableEvent);
+                break;
+            case Data.Event.Upload:
+                if (payload.upload === undefined) { payload.upload = []; }
+                payload.upload.push(data.decode(entry) as UploadEvent);
+                break;
+            case Data.Event.MouseDown:
+            case Data.Event.MouseUp:
+            case Data.Event.MouseMove:
+            case Data.Event.MouseWheel:
+            case Data.Event.DoubleClick:
+            case Data.Event.TouchStart:
+            case Data.Event.TouchCancel:
+            case Data.Event.TouchEnd:
+            case Data.Event.TouchMove:
+                if (payload.pointer === undefined) { payload.pointer = []; }
+                payload.pointer.push(interaction.decode(entry) as PointerEvent);
+                break;
+            case Data.Event.Click:
+                if (payload.click === undefined) { payload.click = []; }
+                let clickEntry = interaction.decode(entry) as ClickEvent;
+                payload.click.push(clickEntry);
+                break;
+            case Data.Event.ContextMenu:
+                if (payload.contextMenu === undefined) { payload.contextMenu = []; }
+                let contextMenuEntry = interaction.decode(entry) as ContextMenuEvent;
+                payload.contextMenu.push(contextMenuEntry);
+                break;
+            case Data.Event.Clipboard:
+                if (payload.clipboard === undefined) { payload.clipboard = []; }
+                let clipEntry = interaction.decode(entry) as ClipboardEvent;
+                payload.clipboard.push(clipEntry);
+                break;
+            case Data.Event.Scroll:
+                if (payload.scroll === undefined) { payload.scroll = []; }
+                payload.scroll.push(interaction.decode(entry) as ScrollEvent);
+                break;
+            case Data.Event.Resize:
+                if (payload.resize === undefined) { payload.resize = []; }
+                payload.resize.push(interaction.decode(entry) as ResizeEvent);
+                break;
+            case Data.Event.Selection:
+                if (payload.selection === undefined) { payload.selection = []; }
+                payload.selection.push(interaction.decode(entry) as SelectionEvent);
+                break;
+            case Data.Event.Change:
+                if (payload.change === undefined) { payload.change = []; }
+                let changeEntry = interaction.decode(entry) as ChangeEvent;
+                payload.change.push(changeEntry);
+                break;
+            case Data.Event.Submit:
+                if (payload.submit === undefined) { payload.submit = []; }
+                let submitEntry = interaction.decode(entry) as SubmitEvent;
+                payload.submit.push(submitEntry);
+                break;
+            case Data.Event.Timeline:
+                if (payload.timeline === undefined) { payload.timeline = []; }
+                payload.timeline.push(interaction.decode(entry) as TimelineEvent);
+                break;
+            case Data.Event.Input:
+                if (payload.input === undefined) { payload.input = []; }
+                payload.input.push(interaction.decode(entry) as InputEvent);
+                break;
+            case Data.Event.Unload:
+                if (payload.unload === undefined) { payload.unload = []; }
+                payload.unload.push(interaction.decode(entry) as UnloadEvent);
+                break;
+            case Data.Event.Visibility:
+                if (payload.visibility === undefined) { payload.visibility = []; }
+                payload.visibility.push(interaction.decode(entry) as VisibilityEvent);
+                break;
+            case Data.Event.Focus:
+                if (payload.focus === undefined) { payload.focus = []; }
+                payload.focus.push(interaction.decode(entry) as FocusEvent);
+                break;
+            case Data.Event.Box:
+                /* Deprecated - Intentionally, no-op. For backward compatibility. */
+                break;
+            case Data.Event.Region:
+                if (payload.region === undefined) { payload.region = []; }
+                payload.region.push(layout.decode(entry) as RegionEvent);
+                break;
+            case Data.Event.Discover:
+            case Data.Event.Mutation:
+            case Data.Event.Snapshot:
+            case Data.Event.StyleSheetAdoption:
+            case Data.Event.StyleSheetUpdate:
+            case Data.Event.Animation:
+                if (payload.dom === undefined) { payload.dom = []; }
+                payload.dom.push(layout.decode(entry) as DomEvent);
+                break;
+            case Data.Event.Document:
+                if (payload.doc === undefined) { payload.doc = []; }
+                payload.doc.push(layout.decode(entry) as DocumentEvent);
+                break;
+            case Data.Event.ScriptError:
+                if (payload.script === undefined) { payload.script = []; }
+                payload.script.push(diagnostic.decode(entry) as ScriptErrorEvent);
+                break;
+            case Data.Event.Log:
+                if (payload.log === undefined) { payload.log = []; }
+                payload.log.push(diagnostic.decode(entry) as LogEvent);
+                break;
+            case Data.Event.Fraud:
+                if (payload.fraud === undefined) { payload.fraud = []; }
+                payload.fraud.push(diagnostic.decode(entry) as FraudEvent);
+                break;
+            case Data.Event.Navigation:
+                if (payload.navigation === undefined) { payload.navigation = []; }
+                payload.navigation.push(performance.decode(entry) as NavigationEvent);
+                break;
+            case Data.Event.Connection:
+            case Data.Event.ImageError:
+                /* Deprecated - Intentionally, no-op. For backward compatibility. */
+                break;
+            case Data.Event.Extract:
+                if (payload.extract === undefined) { payload.extract = []; }
+                    payload.extract.push(data.decode(entry) as ExtractEvent);
+                    break;
+            case Data.Event.Consent:
+                if (payload.consent === undefined) { payload.consent = []; }
+                payload.consent.push(data.decode(entry) as ConsentEvent);
+                break;
+            case Data.Event.CustomElement:
+                if (payload.customElement === undefined) { payload.customElement = []; }
+                payload.customElement.push(layout.decode(entry) as CustomElementEvent);
+                break;
+            default:
+                if (typeof entry[1] === "number" && entry[1] < 200) {
+                    console.error(`No handler for Event: ${JSON.stringify(entry)}`);
+                }
+                break;
+        }
+    }
+
+    return payload;
+}
+
+
+function parseVersion(ver: string): DecodedVersion {
+    let output: DecodedVersion = { major: 0, minor: 0, patch: 0, beta: 0 };
+    let parts = ver.split(".");
+    if (parts.length === 3) {
+        let subparts = parts[2].split("-b");
+        output.major = parseInt(parts[0], 10);
+        output.minor = parseInt(parts[1], 10);
+        if (subparts.length === 2) {
+            output.patch = parseInt(subparts[0], 10);
+            output.beta = parseInt(subparts[1], 10);
+        } else { output.patch = parseInt(parts[2], 10); }
+    }
+    return output;
+}

package/src/data.ts

@@ -0,0 +1,126 @@
+import { Data } from "@gem-sdk/clarity-js";
+import { Constant, DataEvent } from "../types/data";
+
+export function decode(tokens: Data.Token[]): DataEvent {
+    let time = tokens[0] as number;
+    let event = tokens[1] as Data.Event;
+    switch (event) {
+        case Data.Event.Ping:
+            let ping: Data.PingData = { gap: tokens[2] as number };
+            return { time, event, data: ping };
+        case Data.Event.Limit:
+            let limit: Data.LimitData = { check: tokens[2] as number };
+            return { time, event, data: limit };
+        case Data.Event.Custom:
+            let custom: Data.CustomData = { key: tokens[2] as string, value: tokens[3] as string };
+            return { time, event, data: custom };
+        case Data.Event.Upgrade:
+            let upgrade: Data.UpgradeData = { key: tokens[2] as string };
+            return { time, event, data: upgrade };
+        case Data.Event.Upload:
+            let upload: Data.UploadData = { sequence: tokens[2] as number, attempts: tokens[3] as number, status: tokens[4] as number };
+            return { time, event, data: upload };
+        case Data.Event.Metric:
+            let m = 2; // Start from 3rd index since first two are used for time & event
+            let metrics: Data.MetricData = {};
+            while (m < tokens.length) {
+                metrics[tokens[m++] as number] = tokens[m++] as number;
+            }
+            return { time, event, data: metrics };
+        case Data.Event.Dimension:
+            let d = 2; // Start from 3rd index since first two are used for time & event
+            let dimensions: Data.DimensionData = {};
+            while (d < tokens.length) {
+                dimensions[tokens[d++] as number] = tokens[d++] as string[];
+            }
+            return { time, event, data: dimensions };
+        case Data.Event.Summary:
+            let s = 2; // Start from 3rd index since first two are used for time & event
+            let summary: Data.SummaryData = {};
+            while (s < tokens.length) {
+                let key = tokens[s++] as number;
+                let values = tokens[s++] as number[];
+                summary[key] = [];
+                for (let i = 0; i < values.length - 1; i += 2) {
+                    summary[key].push([values[i], values[i + 1]]);
+                }
+            }
+            return { time, event, data: summary };
+        case Data.Event.Baseline:
+            const tokenLength = tokens.length;
+            let baselineData: Data.BaselineData = {
+                visible: tokens[2] as number,
+                docWidth: tokens[3] as number,
+                docHeight: tokens[4] as number,
+                screenWidth: tokens[5] as number,
+                screenHeight: tokens[6] as number,
+                scrollX: tokens[7] as number,
+                scrollY: tokens[8] as number,
+                pointerX: tokens[9] as number,
+                pointerY: tokens[10] as number,
+                activityTime: tokens[11] as number,
+                scrollTime: tokenLength > 12 ? tokens[12] as number: null,
+                pointerTime: tokenLength > 13 ? tokens[13] as number: null,
+                moveX: tokenLength > 14 ? tokens[14] as number: null,
+                moveY: tokenLength > 15 ? tokens[15] as number: null,
+                moveTime: tokenLength > 16 ? tokens[16] as number: null,
+                downX: tokenLength > 17 ? tokens[17] as number: null, 
+                downY: tokenLength > 18 ? tokens[18] as number: null,
+                downTime: tokenLength > 19 ? tokens[19] as number: null,
+                upX: tokenLength > 20 ? tokens[20] as number: null,
+                upY: tokenLength > 21 ? tokens[21] as number: null,
+                upTime: tokenLength > 22 ? tokens[22] as number: null,
+                pointerPrevX: tokenLength > 23 ? tokens[23] as number: null,
+                pointerPrevY: tokenLength > 24 ? tokens[24] as number: null,
+                pointerPrevTime: tokenLength > 25 ? tokens[25] as number: null,
+                modules: tokenLength > 26 ? tokens[26] as number[]: null,
+            }
+            return { time, event, data: baselineData };
+        case Data.Event.Variable:
+            let v = 2; // Start from 3rd index since first two are used for time & event
+            let variables: Data.VariableData = {};
+            while (v < tokens.length) {
+                variables[tokens[v++] as string] = typeof tokens[v + 1] == Constant.String ? [tokens[v++] as string] : tokens[v++] as string[];
+            }
+            return { time, event, data: variables };
+        case Data.Event.Extract:
+            let e = 2; // Start from 3rd index since first two are used for time & event
+            let extract: Data.ExtractData = {};
+            while (e < tokens.length) {
+                // For backward compatibility from version 0.7.4
+                if (typeof(tokens[e + 1]) == Constant.String) {
+                    extract[tokens[e++] as string | number] = tokens[e++] as string;
+                }
+                else {
+                    let key = tokens[e++] as number;
+                    let values = tokens[e++] as (number | string)[];
+                    extract[key] = [];
+                    for (let i = 0; i < values.length - 1; i += 2) {
+                        extract[key][values[i] as number] = values[i + 1] as string;
+                    }
+                }
+            }
+            return { time, event, data: extract };
+        case Data.Event.Consent:
+            let consent: Data.ConsentData = { source: tokens[2] as number, ad_Storage: tokens[3] as number, analytics_Storage: tokens[4] as number};
+            return { time, event, data: consent };
+    }
+    return null;
+}
+
+export function envelope(tokens: Data.Token[]): Data.Envelope {
+    return {
+        version: tokens[0] as string,
+        sequence: tokens[1] as number,
+        start: tokens[2] as number,
+        duration: tokens[3] as number,
+        projectId: tokens[4] as string,
+        userId: tokens[5] as string,
+        sessionId: tokens[6] as string,
+        pageNum: tokens[7] as number,
+        upload: tokens[8] as Data.Upload,
+        end: tokens[9] as Data.BooleanFlag,
+        applicationPlatform: tokens[10] as number,
+        url: tokens[11] as string
+    };
+}

package/src/diagnostic.ts

@@ -0,0 +1,35 @@
+import { Data, Diagnostic } from "@gem-sdk/clarity-js";
+import { DiagnosticEvent } from "../types/diagnostic";
+
+export function decode(tokens: Data.Token[]): DiagnosticEvent {
+    let time = tokens[0] as number;
+    let event = tokens[1] as Data.Event;
+    switch (event) {
+        case Data.Event.ScriptError:
+            let scriptError: Diagnostic.ScriptErrorData = {
+                message: tokens[2] as string,
+                line: tokens[3] as number,
+                column: tokens[4] as number,
+                stack: tokens[5] as string,
+                source: tokens[6] as string
+            };
+            return { time, event, data: scriptError };
+        case Data.Event.Log:
+            let log: Diagnostic.LogData = {
+                code: tokens[2] as number,
+                name: tokens[3] as string,
+                message: tokens[4] as string,
+                stack: tokens[5] as string,
+                severity: tokens[6] as number
+            };
+            return { time, event, data: log };
+        case Data.Event.Fraud:
+            let fraud: Diagnostic.FraudData = {
+                id: tokens[2] as number,
+                target: tokens[3] as number,
+                checksum: tokens[4] as string
+            };
+            return { time, event, data: fraud };
+    }
+    return null;
+}

package/src/global.ts

@@ -0,0 +1,9 @@
+import * as decode from "@src/clarity";
+
+// Expose clarity variable globally to allow access to public interface in a browser
+if (typeof window !== "undefined") {
+    if ((window as any).clarity === undefined || (window as any).clarity === null) {
+        (window as any).clarity = {};
+    }
+    (window as any).clarity.decode = decode;
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { decode } from "./clarity";

package/src/interaction.ts

@@ -0,0 +1,118 @@
+import { Data, Interaction, Layout } from "@gem-sdk/clarity-js";
+import { InteractionEvent, ClickData, TimelineData } from "../types/interaction";
+
+export function decode(tokens: Data.Token[]): InteractionEvent {
+    let time = tokens[0] as number;
+    let event = tokens[1] as Data.Event;
+    switch (event) {
+        case Data.Event.MouseDown:
+        case Data.Event.MouseUp:
+        case Data.Event.MouseMove:
+        case Data.Event.MouseWheel:
+        case Data.Event.DoubleClick:
+        case Data.Event.TouchStart:
+        case Data.Event.TouchCancel:
+        case Data.Event.TouchEnd:
+        case Data.Event.TouchMove:
+            let pointerData: Interaction.PointerData = {
+                target: tokens[2] as number,
+                x: tokens[3] as number,
+                y: tokens[4] as number,
+                id: tokens[5] as number | undefined,
+            };
+            return { time, event, data: pointerData };
+        case Data.Event.Click:
+        case Data.Event.ContextMenu:
+            let clickHashes = (tokens[12] as string).split(Data.Constant.Dot);
+            let clickData: ClickData = {
+                target: tokens[2] as number,
+                x: tokens[3] as number,
+                y: tokens[4] as number,
+                eX: tokens[5] as number,
+                eY: tokens[6] as number,
+                button: tokens[7] as number,
+                reaction: tokens[8] as number,
+                context: tokens[9] as number,
+                text: tokens[10] as string,
+                link: tokens[11] as string,
+                hash: clickHashes[0],
+                hashBeta: clickHashes.length > 0 ? clickHashes[1] : null,
+                trust: tokens.length > 13 ? tokens[13] as number : Data.BooleanFlag.True,
+                isFullText: tokens.length > 14 ? tokens[14] as number : null,
+                w: tokens.length > 15 ? tokens[15] as number : 0,
+                h: tokens.length > 16 ? tokens[16] as number : 0,
+                tag: tokens.length > 17 ? tokens[17] as string : null,
+                class: tokens.length > 18 ? tokens[18] as string : null,
+                id: tokens.length > 19 ? tokens[19] as string : null,
+                source: tokens.length > 20 ? tokens[20] as number : null,
+            };
+            return { time, event, data: clickData };
+        case Data.Event.Clipboard:
+            let clipData: Interaction.ClipboardData = { target: tokens[2] as number, action: tokens[3] as Interaction.Clipboard };
+            return { time, event, data: clipData };
+        case Data.Event.Resize:
+            let resizeData: Interaction.ResizeData = { width: tokens[2] as number, height: tokens[3] as number };
+            return { time, event, data: resizeData };
+        case Data.Event.Input:
+            let inputData: Interaction.InputData = { target: tokens[2] as number, value: tokens[3] as string, trust: tokens.length > 4 ? tokens[4] as number : Data.BooleanFlag.True };
+            return { time, event, data: inputData };
+        case Data.Event.Selection:
+            let selectionData: Interaction.SelectionData = {
+                start: tokens[2] as number,
+                startOffset: tokens[3] as number,
+                end: tokens[4] as number,
+                endOffset: tokens[5] as number
+            };
+            return { time, event, data: selectionData };
+        case Data.Event.Change:
+            let changeData: Interaction.ChangeData = {
+                target: tokens[2] as number,
+                type: tokens[3] as string,
+                value: tokens[4] as string,
+                checksum: tokens[5] as string
+            };
+            return { time, event, data: changeData };
+        case Data.Event.Submit:
+            let submitData: Interaction.SubmitData = {
+                target: tokens[2] as number
+            };
+            return { time, event, data: submitData };
+        case Data.Event.Scroll:
+            let scrollData: Interaction.ScrollData = {
+                target: tokens[2] as number,
+                x: tokens[3] as number,
+                y: tokens[4] as number,
+                top: tokens.length > 5 ? tokens[5] as string : null,
+                bottom: tokens.length > 6 ? tokens[6] as string : null,
+                trust: tokens.length > 7 ? tokens[7] as number : Data.BooleanFlag.True
+            };
+            return { time, event, data: scrollData };
+        case Data.Event.Timeline:
+            let timelineHashes = (tokens[3] as string).split(Data.Constant.Dot);
+            let timelineData: TimelineData = {
+                type: tokens[2] as number,
+                hash: timelineHashes[Layout.Selector.Alpha],
+                x: tokens[4] as number,
+                y: tokens[5] as number,
+                reaction: tokens[6] as number,
+                context: tokens[7] as number,
+                hashBeta: timelineHashes.length > 0 ? timelineHashes[Layout.Selector.Beta] : null
+            };
+            return { time, event, data: timelineData };
+        case Data.Event.Visibility:
+            let visibleData: Interaction.VisibilityData;
+            if (typeof tokens[2] === "number") {
+                visibleData = { visible: tokens[2] as number };
+            } else {
+                visibleData = { visible: (tokens[2] as string) === "visible" ? Data.BooleanFlag.True : Data.BooleanFlag.False };
+            }
+            return { time, event, data: visibleData };
+        case Data.Event.Focus:
+            let focusData: Interaction.FocusData = { focused: tokens[2] as number };
+            return { time, event, data: focusData };
+        case Data.Event.Unload:
+            let unloadData: Interaction.UnloadData = { name: tokens[2] as string, persisted: tokens[3] as number };
+            return { time, event, data: unloadData };
+    }
+    return null;
+}