@croct/sdk 0.13.0 → 0.15.0

package/src/token/token.ts

@@ -1,7 +1,8 @@
 import {JsonObject} from '@croct/json';
-import {base64UrlDecode, base64UrlEncode} from '../base64Url';
+import {encodeURI as base64Encode, decode as base64Decode} from 'js-base64';
 import {tokenSchema} from '../schema';
 import {formatCause} from '../error';
+import {ApiKey} from '../apiKey';
 
 export type Headers = {
     typ: string,
@@ -16,12 +17,14 @@ type Claims = {
     iat: number,
     exp?: number,
     sub?: string,
-    jid?: string,
+    jti?: string,
 };
 
 export type TokenPayload = JsonObject & Claims;
 
 export class Token {
+    private static readonly UUID_PATTERN = /^[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$/;
+
     private readonly headers: Headers;
 
     private readonly payload: TokenPayload;
@@ -76,20 +79,15 @@ export class Token {
 
         let headers;
         let payload;
-        let signature;
 
         try {
-            headers = JSON.parse(base64UrlDecode(parts[0], true));
-            payload = JSON.parse(base64UrlDecode(parts[1], true));
-
-            if (parts.length === 3) {
-                signature = base64UrlDecode(parts[2], false);
-            }
-        } catch {
+            headers = JSON.parse(base64Decode(parts[0]));
+            payload = JSON.parse(base64Decode(parts[1]));
+        } catch (error) {
             throw new Error('The token is corrupted.');
         }
 
-        return Token.of(headers, payload, signature);
+        return Token.of(headers, payload, parts[2]);
     }
 
     public static of(headers: Headers, payload: TokenPayload, signature = ''): Token {
@@ -106,6 +104,63 @@ export class Token {
         return new Token(headers as Headers, payload as TokenPayload, signature as string);
     }
 
+    public async signedWith(apiKey: ApiKey): Promise<Token> {
+        const keyId = await apiKey.getIdentifierHash();
+        const headers: Headers = {
+            ...this.headers,
+            kid: keyId,
+            alg: 'EdDSA',
+        };
+
+        const encodedHeader = base64Encode(JSON.stringify(headers));
+        const encodedPayload = base64Encode(JSON.stringify(this.payload));
+        const signatureData = `${encodedHeader}.${encodedPayload}`;
+        const signature = await apiKey.sign(Buffer.from(signatureData, 'utf-8'));
+
+        return new Token(headers, this.payload, signature.toString('base64url'));
+    }
+
+    public isSigned(): boolean {
+        return this.headers.alg !== 'none' && this.signature !== '';
+    }
+
+    public isSubject(subject: string): boolean {
+        return this.getSubject() === subject;
+    }
+
+    public isAnonymous(): boolean {
+        return this.payload.sub === undefined;
+    }
+
+    public isValidNow(now: number = Math.floor(Date.now() / 1000)): boolean {
+        const {exp, iat} = this.payload;
+
+        return (exp === undefined || exp >= now) && iat <= now;
+    }
+
+    public isNewerThan(token: Token): boolean {
+        return this.payload.iat > token.payload.iat;
+    }
+
+    public async matchesKeyId(apiKey: ApiKey): Promise<boolean> {
+        return this.headers.kid === await apiKey.getIdentifierHash();
+    }
+
+    public withTokenId(tokenId: string): Token {
+        if (tokenId === '' || !Token.UUID_PATTERN.test(tokenId)) {
+            throw new Error('The token ID must be a valid UUID.');
+        }
+
+        return new Token(
+            this.headers,
+            {
+                ...this.payload,
+                jti: tokenId,
+            },
+            this.signature,
+        );
+    }
+
     public getHeaders(): Headers {
         return {...this.headers};
     }
@@ -118,28 +173,55 @@ export class Token {
         return this.signature;
     }
 
-    public isAnonymous(): boolean {
-        return this.payload.sub === undefined;
+    public getApplicationId(): string | null {
+        return this.headers.appId ?? null;
+    }
+
+    public getAlgorithm(): string {
+        return this.headers.alg;
+    }
+
+    public getType(): string {
+        return this.headers.typ;
+    }
+
+    public getKeyId(): string | null {
+        return this.headers.kid ?? null;
     }
 
     public getSubject(): string | null {
-        return this.payload.sub !== undefined ? this.payload.sub : null;
+        return this.payload.sub ?? null;
     }
 
     public getIssueTime(): number {
         return this.payload.iat;
     }
 
+    public getExpirationTime(): number | null {
+        return this.payload.exp ?? null;
+    }
+
+    public getTokenId(): string | null {
+        return this.payload.jti ?? null;
+    }
+
+    public getAudience(): string | string[] {
+        return this.payload.aud;
+    }
+
+    public getIssuer(): string {
+        return this.payload.iss;
+    }
+
     public toJSON(): string {
         return this.toString();
     }
 
     public toString(): string {
-        const headers = base64UrlEncode(JSON.stringify(this.headers), true);
-        const payload = base64UrlEncode(JSON.stringify(this.payload), true);
-        const signature = base64UrlEncode(this.signature, false);
+        const headers = base64Encode(JSON.stringify(this.headers));
+        const payload = base64Encode(JSON.stringify(this.payload));
 
-        return `${headers}.${payload}.${signature}`;
+        return `${headers}.${payload}.${this.signature}`;
     }
 }
 

package/src/tracker.ts

@@ -2,7 +2,7 @@ import {Logger, NullLogger} from './logging';
 import {Tab, TabEvent, TabUrlChangeEvent, TabVisibilityChangeEvent} from './tab';
 import {OutputChannel} from './channel';
 import {formatCause} from './error';
-import {TokenProvider} from './token';
+import {Token, TokenProvider} from './token';
 import {RetryPolicy} from './retry';
 import {
     Beacon,
@@ -23,6 +23,7 @@ export type Configuration = Options & {
     logger?: Logger,
     tab: Tab,
     tokenProvider: TokenProvider,
+    processor?: TrackingEventProcessor,
     inactivityRetryPolicy: RetryPolicy<number>,
 };
 
@@ -37,8 +38,15 @@ type InactivityTimer = {
     since: number,
 };
 
+export interface TrackingEventProcessor {
+    process(event: QueuedEventInfo): QueuedEventInfo[];
+}
+
+export type QueuedEventInfo<T extends TrackingEvent = TrackingEvent> = Omit<EventInfo<T>, 'status'>;
+
 export type EventInfo<T extends TrackingEvent = TrackingEvent> = {
     context: TrackingEventContext,
+    userToken?: Token,
     event: T,
     timestamp: number,
     status: 'pending' | 'confirmed' | 'failed' | 'ignored',
@@ -63,6 +71,8 @@ export class Tracker {
 
     private readonly logger: Logger;
 
+    private readonly processor?: TrackingEventProcessor;
+
     private readonly listeners: EventListener[] = [];
 
     private readonly pending: Array<Promise<void>> = [];
@@ -85,6 +95,7 @@ export class Tracker {
         this.inactivityRetryPolicy = inactivityRetryPolicy;
         this.channel = channel;
         this.logger = logger ?? new NullLogger();
+        this.processor = config.processor;
         this.options = {
             ...options,
             eventMetadata: options.eventMetadata ?? {},
@@ -264,7 +275,7 @@ export class Tracker {
     }
 
     public track<T extends PartialTrackingEvent>(event: T, timestamp: number = Date.now()): Promise<T> {
-        return this.publish(this.enrichEvent(event, timestamp), timestamp).then(() => event);
+        return this.dispatch(this.enrichEvent(event, timestamp), timestamp).then(() => event);
     }
 
     private trackPageOpen({referrer, ...payload}: {url: string, referrer: string}): void {
@@ -315,7 +326,7 @@ export class Tracker {
     }
 
     private enqueue(event: TrackingEvent, timestamp: number = Date.now()): void {
-        this.publish(event, timestamp).catch(() => {
+        this.dispatch(event, timestamp).catch(() => {
             // suppress error
         });
     }
@@ -324,11 +335,8 @@ export class Tracker {
         this.listeners.map(listener => listener(event));
     }
 
-    private publish<T extends TrackingEvent>(event: T, timestamp: number): Promise<T> {
-        if (event.type !== 'nothingChanged') {
-            this.stopInactivityTimer();
-        }
-
+    private dispatch<T extends TrackingEvent>(event: T, timestamp: number): Promise<T> {
+        const userToken = this.tokenProvider.getToken();
         const metadata = this.options.eventMetadata;
         const context: TrackingEventContext = {
             tabId: this.tab.id,
@@ -336,10 +344,48 @@ export class Tracker {
             ...(Object.keys(metadata).length > 0 ? {metadata: metadata} : {}),
         };
 
-        const eventInfo: EventInfo<T> = {
+        const queuedEvent: QueuedEventInfo<T> = {
+            ...(userToken !== null ? {userToken: userToken} : {}),
             event: event,
-            context: context,
             timestamp: timestamp,
+            context: context,
+        };
+
+        const processedEvents = this.processor !== undefined
+            ? this.processor.process(queuedEvent)
+            : [queuedEvent];
+
+        // sort events by timestamp in ascending order
+        processedEvents.sort((left, right) => left.timestamp - right.timestamp);
+
+        let result: Promise<T>|null = null;
+
+        for (const processedEvent of processedEvents) {
+            if (processedEvent === queuedEvent) {
+                result = this.publish(queuedEvent);
+
+                continue;
+            }
+
+            this.publish(processedEvent);
+        }
+
+        if (result === null) {
+            return Promise.reject(new Error('Event suppressed.'));
+        }
+
+        return result;
+    }
+
+    private publish<T extends TrackingEvent>(queuedEvent: QueuedEventInfo<T>): Promise<T> {
+        const {event} = queuedEvent;
+
+        if (event.type !== 'nothingChanged') {
+            this.stopInactivityTimer();
+        }
+
+        const eventInfo: EventInfo<T> = {
+            ...queuedEvent,
             status: 'pending',
         };
 
@@ -357,7 +403,7 @@ export class Tracker {
 
         return new Promise<T>((resolve, reject) => {
             const promise = this.channel
-                .publish(this.createBeacon(event, timestamp, context))
+                .publish(this.createBeacon(queuedEvent))
                 .then(
                     () => {
                         this.logger.debug(`Successfully published event "${event.type}"`);
@@ -403,12 +449,10 @@ export class Tracker {
         return event;
     }
 
-    private createBeacon(event: TrackingEvent, timestamp: number, context: TrackingEventContext): Beacon {
-        const token = this.tokenProvider.getToken();
-
+    private createBeacon({event, timestamp, context, userToken}: QueuedEventInfo): Beacon {
         return {
             timestamp: timestamp,
-            ...(token !== null ? {token: token.toString()} : {}),
+            ...(userToken !== undefined ? {token: userToken.toString()} : {}),
             context: context,
             payload: this.enrichBeaconPayload(this.createBeaconPayload(event)),
         };

package/tab.js.map

@@ -1 +1 @@
-{"version":3,"file":"tab.js","sourceRoot":"","sources":["src/tab.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tab.js","sourceRoot":"","sources":["src/tab.ts"],"names":[],"mappings":"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"}

package/token/cachedTokenStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"cachedTokenStore.js","sourceRoot":"","sources":["../src/token/cachedTokenStore.ts"],"names":[],"mappings":";;;AAAA,mCAA0C;AAG1C,MAAa,gBAAgB;IAGzB,YAAmB,KAAY;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAEM,QAAQ;QACX,MAAM,IAAI,GAAkB,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAE7C,IAAI,IAAI,KAAK,IAAI,EAAE;YACf,OAAO,IAAI,CAAC;SACf;QAED,IAAI;YACA,OAAO,aAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAC5B;QAAC,OAAO,KAAK,EAAE;YACZ,OAAO,IAAI,CAAC;SACf;IACL,CAAC;IAEM,QAAQ,CAAC,KAAmB;QAC/B,IAAI,KAAK,KAAK,IAAI,EAAE;YAChB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAEnB,OAAO;SACV;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrC,CAAC;CACJ;AA9BD,4CA8BC"}
+{"version":3,"file":"cachedTokenStore.js","sourceRoot":"","sources":["../src/token/cachedTokenStore.ts"],"names":[],"mappings":";;;AAAA,mCAA0C;AAG1C,MAAa,gBAAgB;IAGzB,YAAmB,KAAY;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAEM,QAAQ;QACX,MAAM,IAAI,GAAkB,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAE7C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,IAAI,CAAC;YACD,OAAO,aAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAEM,QAAQ,CAAC,KAAmB;QAC/B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAEnB,OAAO;QACX,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrC,CAAC;CACJ;AA9BD,4CA8BC"}

package/token/token.d.ts

@@ -1,4 +1,5 @@
 import { JsonObject } from '@croct/json';
+import { ApiKey } from '../apiKey';
 export type Headers = {
     typ: string;
     alg: string;
@@ -11,10 +12,11 @@ type Claims = {
     iat: number;
     exp?: number;
     sub?: string;
-    jid?: string;
+    jti?: string;
 };
 export type TokenPayload = JsonObject & Claims;
 export declare class Token {
+    private static readonly UUID_PATTERN;
     private readonly headers;
     private readonly payload;
     private readonly signature;
@@ -22,12 +24,27 @@ export declare class Token {
     static issue(appId: string, subject?: string | null, timestamp?: number): Token;
     static parse(token: string): Token;
     static of(headers: Headers, payload: TokenPayload, signature?: string): Token;
+    signedWith(apiKey: ApiKey): Promise<Token>;
+    isSigned(): boolean;
+    isSubject(subject: string): boolean;
+    isAnonymous(): boolean;
+    isValidNow(now?: number): boolean;
+    isNewerThan(token: Token): boolean;
+    matchesKeyId(apiKey: ApiKey): Promise<boolean>;
+    withTokenId(tokenId: string): Token;
     getHeaders(): Headers;
     getPayload(): TokenPayload;
     getSignature(): string;
-    isAnonymous(): boolean;
+    getApplicationId(): string | null;
+    getAlgorithm(): string;
+    getType(): string;
+    getKeyId(): string | null;
     getSubject(): string | null;
     getIssueTime(): number;
+    getExpirationTime(): number | null;
+    getTokenId(): string | null;
+    getAudience(): string | string[];
+    getIssuer(): string;
     toJSON(): string;
     toString(): string;
 }

package/token/token.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FixedTokenProvider = exports.Token = void 0;
-const base64Url_1 = require("../base64Url");
+const js_base64_1 = require("js-base64");
 const schema_1 = require("../schema");
 const error_1 = require("../error");
 class Token {
@@ -39,18 +39,14 @@ class Token {
         }
         let headers;
         let payload;
-        let signature;
         try {
-            headers = JSON.parse((0, base64Url_1.base64UrlDecode)(parts[0], true));
-            payload = JSON.parse((0, base64Url_1.base64UrlDecode)(parts[1], true));
-            if (parts.length === 3) {
-                signature = (0, base64Url_1.base64UrlDecode)(parts[2], false);
-            }
+            headers = JSON.parse((0, js_base64_1.decode)(parts[0]));
+            payload = JSON.parse((0, js_base64_1.decode)(parts[1]));
         }
-        catch {
+        catch (error) {
             throw new Error('The token is corrupted.');
         }
-        return Token.of(headers, payload, signature);
+        return Token.of(headers, payload, parts[2]);
     }
     static of(headers, payload, signature = '') {
         try {
@@ -65,6 +61,47 @@ class Token {
         }
         return new Token(headers, payload, signature);
     }
+    async signedWith(apiKey) {
+        const keyId = await apiKey.getIdentifierHash();
+        const headers = {
+            ...this.headers,
+            kid: keyId,
+            alg: 'EdDSA',
+        };
+        const encodedHeader = (0, js_base64_1.encodeURI)(JSON.stringify(headers));
+        const encodedPayload = (0, js_base64_1.encodeURI)(JSON.stringify(this.payload));
+        const signatureData = `${encodedHeader}.${encodedPayload}`;
+        const signature = await apiKey.sign(Buffer.from(signatureData, 'utf-8'));
+        return new Token(headers, this.payload, signature.toString('base64url'));
+    }
+    isSigned() {
+        return this.headers.alg !== 'none' && this.signature !== '';
+    }
+    isSubject(subject) {
+        return this.getSubject() === subject;
+    }
+    isAnonymous() {
+        return this.payload.sub === undefined;
+    }
+    isValidNow(now = Math.floor(Date.now() / 1000)) {
+        const { exp, iat } = this.payload;
+        return (exp === undefined || exp >= now) && iat <= now;
+    }
+    isNewerThan(token) {
+        return this.payload.iat > token.payload.iat;
+    }
+    async matchesKeyId(apiKey) {
+        return this.headers.kid === await apiKey.getIdentifierHash();
+    }
+    withTokenId(tokenId) {
+        if (tokenId === '' || !Token.UUID_PATTERN.test(tokenId)) {
+            throw new Error('The token ID must be a valid UUID.');
+        }
+        return new Token(this.headers, {
+            ...this.payload,
+            jti: tokenId,
+        }, this.signature);
+    }
     getHeaders() {
         return { ...this.headers };
     }
@@ -74,26 +111,52 @@ class Token {
     getSignature() {
         return this.signature;
     }
-    isAnonymous() {
-        return this.payload.sub === undefined;
+    getApplicationId() {
+        var _a;
+        return (_a = this.headers.appId) !== null && _a !== void 0 ? _a : null;
+    }
+    getAlgorithm() {
+        return this.headers.alg;
+    }
+    getType() {
+        return this.headers.typ;
+    }
+    getKeyId() {
+        var _a;
+        return (_a = this.headers.kid) !== null && _a !== void 0 ? _a : null;
     }
     getSubject() {
-        return this.payload.sub !== undefined ? this.payload.sub : null;
+        var _a;
+        return (_a = this.payload.sub) !== null && _a !== void 0 ? _a : null;
     }
     getIssueTime() {
         return this.payload.iat;
     }
+    getExpirationTime() {
+        var _a;
+        return (_a = this.payload.exp) !== null && _a !== void 0 ? _a : null;
+    }
+    getTokenId() {
+        var _a;
+        return (_a = this.payload.jti) !== null && _a !== void 0 ? _a : null;
+    }
+    getAudience() {
+        return this.payload.aud;
+    }
+    getIssuer() {
+        return this.payload.iss;
+    }
     toJSON() {
         return this.toString();
     }
     toString() {
-        const headers = (0, base64Url_1.base64UrlEncode)(JSON.stringify(this.headers), true);
-        const payload = (0, base64Url_1.base64UrlEncode)(JSON.stringify(this.payload), true);
-        const signature = (0, base64Url_1.base64UrlEncode)(this.signature, false);
-        return `${headers}.${payload}.${signature}`;
+        const headers = (0, js_base64_1.encodeURI)(JSON.stringify(this.headers));
+        const payload = (0, js_base64_1.encodeURI)(JSON.stringify(this.payload));
+        return `${headers}.${payload}.${this.signature}`;
     }
 }
 exports.Token = Token;
+Token.UUID_PATTERN = /^[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$/;
 class FixedTokenProvider {
     constructor(token) {
         this.token = token;

package/token/token.js.map

@@ -1 +1 @@
-{"version":3,"file":"token.js","sourceRoot":"","sources":["../src/token/token.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../src/token/token.ts"],"names":[],"mappings":";;;AACA,yCAA4E;AAC5E,sCAAsC;AACtC,oCAAqC;AAqBrC,MAAa,KAAK;IASd,YAAoB,OAAgB,EAAE,OAAqB,EAAE,SAAS,GAAG,EAAE;QACvE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAEM,MAAM,CAAC,KAAK,CACf,KAAa,EACb,UAAuB,IAAI,EAC3B,YAAoB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAEjD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,IAAI,KAAK,CACZ;YACI,GAAG,EAAE,KAAK;YACV,GAAG,EAAE,MAAM;YACX,KAAK,EAAE,KAAK;SACf,EACD;YACI,GAAG,EAAE,UAAU;YACf,GAAG,EAAE,UAAU;YACf,GAAG,EAAE,SAAS;YACd,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAC,GAAG,EAAE,OAAO,EAAC,CAAC,CAAC,CAAC,IAAI,CAAC;SAChD,CACJ,CAAC;IACN,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,KAAa;QAC7B,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAElC,wBAAwB;QACxB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,OAAO,CAAC;QACZ,IAAI,OAAO,CAAC;QAEZ,IAAI,CAAC;YACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,kBAAY,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,kBAAY,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IAEM,MAAM,CAAC,EAAE,CAAC,OAAgB,EAAE,OAAqB,EAAE,SAAS,GAAG,EAAE;QACpE,IAAI,CAAC;YACD,oBAAW,CAAC,QAAQ,CAAC;gBACjB,OAAO,EAAE,OAAO;gBAChB,OAAO,EAAE,OAAO;gBAChB,SAAS,EAAE,SAAS;aACvB,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAA,mBAAW,EAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,IAAI,KAAK,CAAC,OAAkB,EAAE,OAAuB,EAAE,SAAmB,CAAC,CAAC;IACvF,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,MAAc;QAClC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAY;YACrB,GAAG,IAAI,CAAC,OAAO;YACf,GAAG,EAAE,KAAK;YACV,GAAG,EAAE,OAAO;SACf,CAAC;QAEF,MAAM,aAAa,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5D,MAAM,cAAc,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAClE,MAAM,aAAa,GAAG,GAAG,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3D,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;QAEzE,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7E,CAAC;IAEM,QAAQ;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC;IAChE,CAAC;IAEM,SAAS,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,EAAE,KAAK,OAAO,CAAC;IACzC,CAAC;IAEM,WAAW;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC;IAC1C,CAAC;IAEM,UAAU,CAAC,MAAc,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACzD,MAAM,EAAC,GAAG,EAAE,GAAG,EAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAEhC,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC;IAC3D,CAAC;IAEM,WAAW,CAAC,KAAY;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;IAChD,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,MAAc;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAC;IACjE,CAAC;IAEM,WAAW,CAAC,OAAe;QAC9B,IAAI,OAAO,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,IAAI,KAAK,CACZ,IAAI,CAAC,OAAO,EACZ;YACI,GAAG,IAAI,CAAC,OAAO;YACf,GAAG,EAAE,OAAO;SACf,EACD,IAAI,CAAC,SAAS,CACjB,CAAC;IACN,CAAC;IAEM,UAAU;QACb,OAAO,EAAC,GAAG,IAAI,CAAC,OAAO,EAAC,CAAC;IAC7B,CAAC;IAEM,UAAU;QACb,OAAO,EAAC,GAAG,IAAI,CAAC,OAAO,EAAC,CAAC;IAC7B,CAAC;IAEM,YAAY;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAEM,gBAAgB;;QACnB,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,KAAK,mCAAI,IAAI,CAAC;IACtC,CAAC;IAEM,YAAY;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;IAC5B,CAAC;IAEM,OAAO;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;IAC5B,CAAC;IAEM,QAAQ;;QACX,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,GAAG,mCAAI,IAAI,CAAC;IACpC,CAAC;IAEM,UAAU;;QACb,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,GAAG,mCAAI,IAAI,CAAC;IACpC,CAAC;IAEM,YAAY;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;IAC5B,CAAC;IAEM,iBAAiB;;QACpB,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,GAAG,mCAAI,IAAI,CAAC;IACpC,CAAC;IAEM,UAAU;;QACb,OAAO,MAAA,IAAI,CAAC,OAAO,CAAC,GAAG,mCAAI,IAAI,CAAC;IACpC,CAAC;IAEM,WAAW;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;IAC5B,CAAC;IAEM,SAAS;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;IAC5B,CAAC;IAEM,MAAM;QACT,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAEM,QAAQ;QACX,MAAM,OAAO,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAE3D,OAAO,GAAG,OAAO,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;IACrD,CAAC;;AAxML,sBAyMC;AAxM2B,kBAAY,GAAG,6CAA6C,CAAC;AAkNzF,MAAa,kBAAkB;IAG3B,YAAmB,KAAmB;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAEM,QAAQ;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;CACJ;AAVD,gDAUC"}

package/tracker.d.ts

@@ -1,7 +1,7 @@
 import { Logger } from './logging';
 import { Tab } from './tab';
 import { OutputChannel } from './channel';
-import { TokenProvider } from './token';
+import { Token, TokenProvider } from './token';
 import { RetryPolicy } from './retry';
 import { Beacon, TrackingEvent, TrackingEventContext, PartialTrackingEvent } from './trackingEvents';
 type Options = {
@@ -14,10 +14,16 @@ export type Configuration = Options & {
     logger?: Logger;
     tab: Tab;
     tokenProvider: TokenProvider;
+    processor?: TrackingEventProcessor;
     inactivityRetryPolicy: RetryPolicy<number>;
 };
+export interface TrackingEventProcessor {
+    process(event: QueuedEventInfo): QueuedEventInfo[];
+}
+export type QueuedEventInfo<T extends TrackingEvent = TrackingEvent> = Omit<EventInfo<T>, 'status'>;
 export type EventInfo<T extends TrackingEvent = TrackingEvent> = {
     context: TrackingEventContext;
+    userToken?: Token;
     event: T;
     timestamp: number;
     status: 'pending' | 'confirmed' | 'failed' | 'ignored';
@@ -32,6 +38,7 @@ export declare class Tracker {
     private inactivityRetryPolicy;
     private readonly channel;
     private readonly logger;
+    private readonly processor?;
     private readonly listeners;
     private readonly pending;
     private readonly state;
@@ -58,6 +65,7 @@ export declare class Tracker {
     private trackInactivity;
     private enqueue;
     private notifyEvent;
+    private dispatch;
     private publish;
     private enrichEvent;
     private createBeacon;