@croct/sdk 0.14.0 → 0.15.1

package/schema/sdkFacadeSchemas.js

@@ -34,6 +34,15 @@ exports.sdkFacadeConfigurationSchema = new validation_1.ObjectType({
         cidAssignerEndpointUrl: new validation_1.StringType({
             format: 'url',
         }),
+        cookie: new validation_1.ObjectType({
+            properties: {
+                clientId: sdkSchemas_1.cookieOptionsSchema,
+                userToken: sdkSchemas_1.cookieOptionsSchema,
+            },
+        }),
+        preferredLocale: new validation_1.StringType({
+            pattern: /^[a-z]{2,3}([-_][a-z]{2,3})?$/i,
+        }),
     },
 });
 //# sourceMappingURL=sdkFacadeSchemas.js.map

package/schema/sdkFacadeSchemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdkFacadeSchemas.js","sourceRoot":"","sources":["../src/schema/sdkFacadeSchemas.ts"],"names":[],"mappings":";;;AAAA,8CAAqG;AACrG,qDAAkD;AAClD,6CAAiD;AACjD,iDAA4C;AAE/B,QAAA,4BAA4B,GAAG,IAAI,uBAAU,CAAC;IACvD,QAAQ,EAAE,CAAC,OAAO,CAAC;IACnB,UAAU,EAAE;QACR,KAAK,EAAE,IAAI,uBAAU,CAAC;YAClB,MAAM,EAAE,MAAM;SACjB,CAAC;QACF,QAAQ,EAAE,IAAI,uBAAU,CAAC;YACrB,OAAO,EAAE,iBAAiB;SAC7B,CAAC;QACF,UAAU,EAAE,iCAAgB;QAC5B,mBAAmB,EAAE,IAAI,wBAAW,EAAE;QACtC,KAAK,EAAE,IAAI,wBAAW,EAAE;QACxB,IAAI,EAAE,IAAI,wBAAW,EAAE;QACvB,KAAK,EAAE,IAAI,wBAAW,EAAE;QACxB,MAAM,EAAE,2BAAY;QACpB,YAAY,EAAE,IAAI,yBAAY,EAAE;QAChC,aAAa,EAAE,gCAAmB;QAClC,MAAM,EAAE,IAAI,sBAAS,CACjB,IAAI,uBAAU,CAAC;YACX,SAAS,EAAE,CAAC;SACf,CAAC,EACF,IAAI,qBAAQ,EAAE,CACjB;QACD,KAAK,EAAE,IAAI,sBAAS,CAChB,IAAI,uBAAU,CAAC;YACX,OAAO,EAAE,yDAAyD;SACrE,CAAC,EACF,IAAI,qBAAQ,EAAE,CACjB;QACD,eAAe,EAAE,IAAI,uBAAU,CAAC;YAC5B,MAAM,EAAE,KAAK;SAChB,CAAC;QACF,sBAAsB,EAAE,IAAI,uBAAU,CAAC;YACnC,MAAM,EAAE,KAAK;SAChB,CAAC;KACL;CACJ,CAAC,CAAC"}
+{"version":3,"file":"sdkFacadeSchemas.js","sourceRoot":"","sources":["../src/schema/sdkFacadeSchemas.ts"],"names":[],"mappings":";;;AAAA,8CAAqG;AACrG,qDAAkD;AAClD,6CAAsE;AACtE,iDAA4C;AAE/B,QAAA,4BAA4B,GAAG,IAAI,uBAAU,CAAC;IACvD,QAAQ,EAAE,CAAC,OAAO,CAAC;IACnB,UAAU,EAAE;QACR,KAAK,EAAE,IAAI,uBAAU,CAAC;YAClB,MAAM,EAAE,MAAM;SACjB,CAAC;QACF,QAAQ,EAAE,IAAI,uBAAU,CAAC;YACrB,OAAO,EAAE,iBAAiB;SAC7B,CAAC;QACF,UAAU,EAAE,iCAAgB;QAC5B,mBAAmB,EAAE,IAAI,wBAAW,EAAE;QACtC,KAAK,EAAE,IAAI,wBAAW,EAAE;QACxB,IAAI,EAAE,IAAI,wBAAW,EAAE;QACvB,KAAK,EAAE,IAAI,wBAAW,EAAE;QACxB,MAAM,EAAE,2BAAY;QACpB,YAAY,EAAE,IAAI,yBAAY,EAAE;QAChC,aAAa,EAAE,gCAAmB;QAClC,MAAM,EAAE,IAAI,sBAAS,CACjB,IAAI,uBAAU,CAAC;YACX,SAAS,EAAE,CAAC;SACf,CAAC,EACF,IAAI,qBAAQ,EAAE,CACjB;QACD,KAAK,EAAE,IAAI,sBAAS,CAChB,IAAI,uBAAU,CAAC;YACX,OAAO,EAAE,yDAAyD;SACrE,CAAC,EACF,IAAI,qBAAQ,EAAE,CACjB;QACD,eAAe,EAAE,IAAI,uBAAU,CAAC;YAC5B,MAAM,EAAE,KAAK;SAChB,CAAC;QACF,sBAAsB,EAAE,IAAI,uBAAU,CAAC;YACnC,MAAM,EAAE,KAAK;SAChB,CAAC;QACF,MAAM,EAAE,IAAI,uBAAU,CAAC;YACnB,UAAU,EAAE;gBACR,QAAQ,EAAE,gCAAmB;gBAC7B,SAAS,EAAE,gCAAmB;aACjC;SACJ,CAAC;QACF,eAAe,EAAE,IAAI,uBAAU,CAAC;YAC5B,OAAO,EAAE,gCAAgC;SAC5C,CAAC;KACL;CACJ,CAAC,CAAC"}

package/schema/sdkSchemas.d.ts

@@ -1,3 +1,4 @@
 import { ObjectType } from '../validation';
 export declare const eventMetadataSchema: ObjectType;
+export declare const cookieOptionsSchema: ObjectType;
 export declare const sdkConfigurationSchema: ObjectType;

package/schema/sdkSchemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sdkConfigurationSchema = exports.eventMetadataSchema = void 0;
+exports.sdkConfigurationSchema = exports.cookieOptionsSchema = exports.eventMetadataSchema = void 0;
 const validation_1 = require("../validation");
 const contextSchemas_1 = require("./contextSchemas");
 const loggerSchema_1 = require("./loggerSchema");
@@ -15,6 +15,28 @@ exports.eventMetadataSchema = new validation_1.ObjectType({
         maxLength: 300,
     }),
 });
+exports.cookieOptionsSchema = new validation_1.ObjectType({
+    required: ['name'],
+    properties: {
+        name: new validation_1.StringType({
+            minLength: 1,
+        }),
+        domain: new validation_1.StringType({
+            minLength: 1,
+        }),
+        path: new validation_1.StringType({
+            minLength: 1,
+        }),
+        secure: new validation_1.BooleanType(),
+        sameSite: new validation_1.StringType({
+            enumeration: ['strict', 'lax', 'none'],
+        }),
+        maxAge: new validation_1.NumberType({
+            minimum: 0,
+            integer: true,
+        }),
+    },
+});
 exports.sdkConfigurationSchema = new validation_1.ObjectType({
     required: ['appId', 'tokenScope', 'disableCidMirroring', 'debug', 'test'],
     properties: {
@@ -36,11 +58,18 @@ exports.sdkConfigurationSchema = new validation_1.ObjectType({
             integer: true,
         }),
         disableCidMirroring: new validation_1.BooleanType(),
+        cookie: new validation_1.ObjectType({
+            properties: {
+                clientId: exports.cookieOptionsSchema,
+                userToken: exports.cookieOptionsSchema,
+            },
+        }),
         debug: new validation_1.BooleanType(),
         test: new validation_1.BooleanType(),
         logger: loggerSchema_1.loggerSchema,
         urlSanitizer: new validation_1.FunctionType(),
         eventMetadata: exports.eventMetadataSchema,
+        eventProcessor: new validation_1.FunctionType(),
     },
 });
 //# sourceMappingURL=sdkSchemas.js.map

package/schema/sdkSchemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdkSchemas.js","sourceRoot":"","sources":["../src/schema/sdkSchemas.ts"],"names":[],"mappings":";;;AAAA,8CAA4F;AAC5F,qDAAkD;AAClD,iDAA4C;AAE/B,QAAA,mBAAmB,GAAG,IAAI,uBAAU,CAAC;IAC9C,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,IAAI,uBAAU,CAAC;QAC1B,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,YAAY;KACvB,CAAC;IACF,oBAAoB,EAAE,IAAI,uBAAU,CAAC;QACjC,SAAS,EAAE,GAAG;KACjB,CAAC;CACL,CAAC,CAAC;AAEU,QAAA,sBAAsB,GAAG,IAAI,uBAAU,CAAC;IACjD,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,CAAC;IACzE,UAAU,EAAE;QACR,KAAK,EAAE,IAAI,uBAAU,CAAC;YAClB,MAAM,EAAE,MAAM;SACjB,CAAC;QACF,QAAQ,EAAE,IAAI,uBAAU,CAAC;YACrB,OAAO,EAAE,iBAAiB;SAC7B,CAAC;QACF,UAAU,EAAE,iCAAgB;QAC5B,eAAe,EAAE,IAAI,uBAAU,CAAC;YAC5B,MAAM,EAAE,KAAK;SAChB,CAAC;QACF,sBAAsB,EAAE,IAAI,uBAAU,CAAC;YACnC,MAAM,EAAE,KAAK;SAChB,CAAC;QACF,eAAe,EAAE,IAAI,uBAAU,CAAC;YAC5B,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,IAAI;SAChB,CAAC;QACF,mBAAmB,EAAE,IAAI,wBAAW,EAAE;QACtC,KAAK,EAAE,IAAI,wBAAW,EAAE;QACxB,IAAI,EAAE,IAAI,wBAAW,EAAE;QACvB,MAAM,EAAE,2BAAY;QACpB,YAAY,EAAE,IAAI,yBAAY,EAAE;QAChC,aAAa,EAAE,2BAAmB;KACrC;CACJ,CAAC,CAAC"}
+{"version":3,"file":"sdkSchemas.js","sourceRoot":"","sources":["../src/schema/sdkSchemas.ts"],"names":[],"mappings":";;;AAAA,8CAA4F;AAC5F,qDAAkD;AAClD,iDAA4C;AAE/B,QAAA,mBAAmB,GAAG,IAAI,uBAAU,CAAC;IAC9C,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,IAAI,uBAAU,CAAC;QAC1B,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,YAAY;KACvB,CAAC;IACF,oBAAoB,EAAE,IAAI,uBAAU,CAAC;QACjC,SAAS,EAAE,GAAG;KACjB,CAAC;CACL,CAAC,CAAC;AAEU,QAAA,mBAAmB,GAAG,IAAI,uBAAU,CAAC;IAC9C,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,UAAU,EAAE;QACR,IAAI,EAAE,IAAI,uBAAU,CAAC;YACjB,SAAS,EAAE,CAAC;SACf,CAAC;QACF,MAAM,EAAE,IAAI,uBAAU,CAAC;YACnB,SAAS,EAAE,CAAC;SACf,CAAC;QACF,IAAI,EAAE,IAAI,uBAAU,CAAC;YACjB,SAAS,EAAE,CAAC;SACf,CAAC;QACF,MAAM,EAAE,IAAI,wBAAW,EAAE;QACzB,QAAQ,EAAE,IAAI,uBAAU,CAAC;YACrB,WAAW,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC;SACzC,CAAC;QACF,MAAM,EAAE,IAAI,uBAAU,CAAC;YACnB,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,IAAI;SAChB,CAAC;KACL;CACJ,CAAC,CAAC;AAEU,QAAA,sBAAsB,GAAG,IAAI,uBAAU,CAAC;IACjD,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,CAAC;IACzE,UAAU,EAAE;QACR,KAAK,EAAE,IAAI,uBAAU,CAAC;YAClB,MAAM,EAAE,MAAM;SACjB,CAAC;QACF,QAAQ,EAAE,IAAI,uBAAU,CAAC;YACrB,OAAO,EAAE,iBAAiB;SAC7B,CAAC;QACF,UAAU,EAAE,iCAAgB;QAC5B,eAAe,EAAE,IAAI,uBAAU,CAAC;YAC5B,MAAM,EAAE,KAAK;SAChB,CAAC;QACF,sBAAsB,EAAE,IAAI,uBAAU,CAAC;YACnC,MAAM,EAAE,KAAK;SAChB,CAAC;QACF,eAAe,EAAE,IAAI,uBAAU,CAAC;YAC5B,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,IAAI;SAChB,CAAC;QACF,mBAAmB,EAAE,IAAI,wBAAW,EAAE;QACtC,MAAM,EAAE,IAAI,uBAAU,CAAC;YACnB,UAAU,EAAE;gBACR,QAAQ,EAAE,2BAAmB;gBAC7B,SAAS,EAAE,2BAAmB;aACjC;SACJ,CAAC;QACF,KAAK,EAAE,IAAI,wBAAW,EAAE;QACxB,IAAI,EAAE,IAAI,wBAAW,EAAE;QACvB,MAAM,EAAE,2BAAY;QACpB,YAAY,EAAE,IAAI,yBAAY,EAAE;QAChC,aAAa,EAAE,2BAAmB;QAClC,cAAc,EAAE,IAAI,yBAAY,EAAE;KACrC;CACJ,CAAC,CAAC"}

package/sdk.d.ts

@@ -1,6 +1,7 @@
+import { DependencyResolver } from './container';
 import { Context, TokenScope } from './context';
 import { Logger } from './logging';
-import { Tracker } from './tracker';
+import { Tracker, TrackingEventProcessor } from './tracker';
 import { Evaluator } from './evaluator';
 import { SdkEventMap } from './sdkEvents';
 import { EventManager } from './eventManager';
@@ -8,6 +9,7 @@ import { CidAssigner } from './cid';
 import { UrlSanitizer } from './tab';
 import { ContentFetcher } from './contentFetcher';
 import { TokenStore } from './token';
+import { CookieCacheConfiguration } from './cache/cookieCache';
 export type Configuration = {
     appId: string;
     tokenScope: TokenScope;
@@ -23,6 +25,11 @@ export type Configuration = {
     eventMetadata?: {
         [key: string]: string;
     };
+    cookie?: {
+        clientId?: CookieCacheConfiguration;
+        userToken?: CookieCacheConfiguration;
+    };
+    eventProcessor?: DependencyResolver<TrackingEventProcessor>;
 };
 export declare class Sdk {
     private container;

package/sdk.js

@@ -23,7 +23,7 @@ class Sdk {
     static init(configuration) {
         var _a;
         validateConfiguration(configuration);
-        const { disableCidMirroring, eventMetadata: customMetadata = {}, baseEndpointUrl = constants_1.BASE_ENDPOINT_URL, cidAssignerEndpointUrl, ...containerConfiguration } = configuration;
+        const { eventMetadata: customMetadata = {}, baseEndpointUrl = constants_1.BASE_ENDPOINT_URL, cidAssignerEndpointUrl, ...containerConfiguration } = configuration;
         const eventMetadata = {
             sdkVersion: constants_1.VERSION,
         };
@@ -34,7 +34,6 @@ class Sdk {
         const baseWsEndpoint = baseHttpEndpoint.replace(/^http/i, 'ws');
         const container = new container_1.Container({
             ...containerConfiguration,
-            disableCidMirroring: disableCidMirroring,
             evaluationBaseEndpointUrl: baseHttpEndpoint,
             contentBaseEndpointUrl: baseHttpEndpoint,
             trackerEndpointUrl: `${baseWsEndpoint}/client/web/connect`,

package/sdk.js.map

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

package/sourceLocation.js.map

@@ -1 +1 @@
-{"version":3,"file":"sourceLocation.js","sourceRoot":"","sources":["src/sourceLocation.ts"],"names":[],"mappings":";;;AAWA,SAAgB,SAAS,CAAC,KAAa;IACnC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC;AAC7B,CAAC;AAFD,8BAEC;AAED,SAAgB,WAAW,CAAC,KAAa,EAAE,UAAkB,EAAE,QAAgB;IAC3E,IAAI,UAAU,GAAG,CAAC,EAAE;QAChB,MAAM,KAAK,CAAC,qCAAqC,CAAC,CAAC;KACtD;IAED,IAAI,QAAQ,GAAG,UAAU,EAAE;QACvB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;KACnF;IAED,IAAI,KAA2B,CAAC;IAChC,IAAI,GAAyB,CAAC;IAE9B,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACzB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAE3B,IAAI,MAAM,KAAK,UAAU,EAAE;YACvB,KAAK,GAAG;gBACJ,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,MAAM;aACjB,CAAC;SACL;QAED,IAAI,MAAM,KAAK,QAAQ,EAAE;YACrB,GAAG,GAAG;gBACF,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,MAAM;aACjB,CAAC;YAEF,MAAM;SACT;QAED,IAAI,IAAI,KAAK,IAAI,EAAE;YACf,IAAI,IAAI,CAAC,CAAC;YACV,MAAM,GAAG,CAAC,CAAC;SACd;aAAM;YACH,MAAM,IAAI,CAAC,CAAC;SACf;KACJ;IAED,IAAI,KAAK,KAAK,SAAS,EAAE;QACrB,KAAK,GAAG;YACJ,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,MAAM;SACjB,CAAC;KACL;IAED,IAAI,GAAG,KAAK,SAAS,EAAE;QACnB,GAAG,GAAG;YACF,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,MAAM;SACjB,CAAC;KACL;IAED,OAAO;QACH,KAAK,EAAE,KAAK;QACZ,GAAG,EAAE,GAAG;KACX,CAAC;AACN,CAAC;AAjED,kCAiEC;AAED,SAAgB,WAAW,CAAC,KAAa,EAAE,KAAa;IACpD,OAAO,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC;AAClD,CAAC;AAFD,kCAEC"}
+{"version":3,"file":"sourceLocation.js","sourceRoot":"","sources":["src/sourceLocation.ts"],"names":[],"mappings":";;;AAWA,SAAgB,SAAS,CAAC,KAAa;IACnC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC;AAC7B,CAAC;AAFD,8BAEC;AAED,SAAgB,WAAW,CAAC,KAAa,EAAE,UAAkB,EAAE,QAAgB;IAC3E,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,KAA2B,CAAC;IAChC,IAAI,GAAyB,CAAC;IAE9B,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACzB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAE3B,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YACxB,KAAK,GAAG;gBACJ,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,MAAM;aACjB,CAAC;QACN,CAAC;QAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtB,GAAG,GAAG;gBACF,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,MAAM;aACjB,CAAC;YAEF,MAAM;QACV,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,CAAC;YACV,MAAM,GAAG,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,CAAC,CAAC;QAChB,CAAC;IACL,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,KAAK,GAAG;YACJ,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,MAAM;SACjB,CAAC;IACN,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACpB,GAAG,GAAG;YACF,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,MAAM;SACjB,CAAC;IACN,CAAC;IAED,OAAO;QACH,KAAK,EAAE,KAAK;QACZ,GAAG,EAAE,GAAG;KACX,CAAC;AACN,CAAC;AAjED,kCAiEC;AAED,SAAgB,WAAW,CAAC,KAAa,EAAE,KAAa;IACpD,OAAO,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC;AAClD,CAAC;AAFD,kCAEC"}

package/src/apiKey.ts

@@ -0,0 +1,110 @@
+import * as crypto from 'crypto';
+import {KeyObject} from 'crypto';
+
+export class ApiKey {
+    private static readonly IDENTIFIER_PATTERN = /^[a-z0-9]{8}-[a-z0-9]{4}-[a-z0-9]{4}-[a-z0-9]{4}-[a-z0-9]{12}$/i;
+
+    private static readonly PRIVATE_KEY_PATTERN = /^[a-f0-9]+$/i;
+
+    private readonly identifier: string;
+
+    private readonly privateKey?: KeyObject;
+
+    private constructor(identifier: string, privateKey?: KeyObject) {
+        this.identifier = identifier;
+        this.privateKey = privateKey;
+    }
+
+    public static from(apiKey: string | ApiKey): ApiKey {
+        if (apiKey instanceof ApiKey) {
+            return apiKey;
+        }
+
+        return ApiKey.parse(apiKey);
+    }
+
+    public static parse(apiKey: string): ApiKey {
+        const parts = apiKey.split(':');
+
+        if (parts.length > 2) {
+            throw new Error('Invalid API key format.');
+        }
+
+        return ApiKey.of(parts[0], parts[1]);
+    }
+
+    public static of(identifier: string, privateKey?: string): ApiKey {
+        if (!ApiKey.IDENTIFIER_PATTERN.test(identifier)) {
+            throw new Error('The API key identifier must be a UUID.');
+        }
+
+        if (privateKey === undefined) {
+            return new ApiKey(identifier);
+        }
+
+        if (!ApiKey.PRIVATE_KEY_PATTERN.test(privateKey)) {
+            throw new Error('The API key private key must be a hexadecimal string.');
+        }
+
+        try {
+            return new ApiKey(identifier, crypto.createPrivateKey({
+                key: Buffer.from(privateKey, 'hex'),
+                format: 'der',
+                type: 'pkcs8',
+            }));
+        } catch {
+            throw new Error('Invalid private key.');
+        }
+    }
+
+    public getIdentifier(): string {
+        return this.identifier;
+    }
+
+    public async getIdentifierHash(): Promise<string> {
+        const identifierBytes = Buffer.from(this.identifier.replace(/-/g, ''), 'hex');
+        const rawHash = await crypto.subtle.digest('SHA-256', identifierBytes);
+
+        return Buffer.from(rawHash).toString('hex');
+    }
+
+    public hasPrivateKey(): boolean {
+        return this.privateKey !== undefined;
+    }
+
+    public getPrivateKey(): string|null {
+        return this.privateKey === undefined
+            ? null
+            : this.privateKey
+                .export({format: 'der', type: 'pkcs8'})
+                .toString('hex');
+    }
+
+    public sign(blob: Buffer): Promise<Buffer> {
+        const {privateKey} = this;
+
+        if (privateKey === undefined) {
+            return Promise.reject(new Error('The API key does not have a private key.'));
+        }
+
+        return new Promise((resolve, reject) => {
+            crypto.sign(null, blob, privateKey, (error, signature) => {
+                if (error == null) {
+                    resolve(signature);
+                } else {
+                    reject(error);
+                }
+            });
+        });
+    }
+
+    public export(): string {
+        const privateKey = this.getPrivateKey();
+
+        return this.identifier + (privateKey === null ? '' : `:${privateKey}`);
+    }
+
+    public toString(): string {
+        return '[redacted]';
+    }
+}

package/src/cache/cache.ts

@@ -13,3 +13,10 @@ export interface ObservableCache extends Cache {
 
     removeListener(listener: CacheListener): void;
 }
+
+export namespace ObservableCache {
+    export function isObservable(cache: Cache): cache is ObservableCache {
+        return typeof (cache as ObservableCache).addListener === 'function'
+            && typeof (cache as ObservableCache).removeListener === 'function';
+    }
+}

package/src/cache/cookieCache.ts

@@ -0,0 +1,77 @@
+import {Cache} from './cache';
+
+export type CookieCacheConfiguration = {
+    name: string,
+    secure?: boolean,
+    maxAge?: number,
+    domain?: string,
+    path?: string,
+    sameSite?: 'strict' | 'lax' | 'none',
+};
+
+export class CookieCache implements Cache {
+    private readonly config: CookieCacheConfiguration;
+
+    public constructor(config: CookieCacheConfiguration) {
+        this.config = config;
+    }
+
+    public get(): string | null {
+        const entries = document.cookie.split(';');
+
+        for (const entry of entries) {
+            const [name, value] = entry.split('=');
+
+            if (CookieCache.decode(name).trim() === this.config.name) {
+                return CookieCache.decode(value.trim());
+            }
+        }
+
+        return null;
+    }
+
+    public put(value: string): void {
+        document.cookie = CookieCache.serializeCookie(value, this.config);
+    }
+
+    public clear(): void {
+        document.cookie = CookieCache.serializeCookie('', {
+            ...this.config,
+            maxAge: 0,
+        });
+    }
+
+    private static serializeCookie(value: string, config: CookieCacheConfiguration): string {
+        const cookie = [`${CookieCache.encode(config.name)}=${CookieCache.encode(value)}`];
+
+        if (config.maxAge !== undefined) {
+            cookie.push(`Max-Age=${config.maxAge}`);
+        }
+
+        if (config.domain !== undefined) {
+            cookie.push(`Domain=${CookieCache.encode(config.domain)}`);
+        }
+
+        if (config.path !== undefined) {
+            cookie.push(`Path=${CookieCache.encode(config.path)}`);
+        }
+
+        if (config.secure === true) {
+            cookie.push('Secure');
+        }
+
+        if (config.sameSite !== undefined) {
+            cookie.push(`SameSite=${({strict: 'Strict', lax: 'Lax', none: 'None'})[config.sameSite]}`);
+        }
+
+        return cookie.join('; ');
+    }
+
+    private static encode(value: string): string {
+        return value.replace(/[,; ]+/g, encodeURIComponent);
+    }
+
+    private static decode(value: string): string {
+        return decodeURIComponent(value);
+    }
+}

package/src/container.ts

@@ -5,7 +5,7 @@ import {BackoffPolicy, ArbitraryPolicy} from './retry';
 import {PersistentQueue, MonitoredQueue, CapacityRestrictedQueue} from './queue';
 import {Beacon} from './trackingEvents';
 import {CachedTokenStore, TokenStore} from './token';
-import {Tracker} from './tracker';
+import {Tracker, TrackingEventProcessor} from './tracker';
 import {Evaluator} from './evaluator';
 import {encodeJson} from './transformer';
 import {CidAssigner, CachedAssigner, RemoteAssigner, FixedAssigner} from './cid';
@@ -25,6 +25,9 @@ import {
     SandboxChannel,
 } from './channel';
 import {ContentFetcher} from './contentFetcher';
+import {CookieCache, CookieCacheConfiguration} from './cache/cookieCache';
+
+export type DependencyResolver<T> = (container: Container) => T;
 
 export type Configuration = {
     appId: string,
@@ -40,7 +43,12 @@ export type Configuration = {
     beaconQueueSize: number,
     logger?: Logger,
     urlSanitizer?: UrlSanitizer,
+    cookie?: {
+        clientId?: CookieCacheConfiguration,
+        userToken?: CookieCacheConfiguration,
+    },
     eventMetadata?: {[key: string]: string},
+    eventProcessor?: DependencyResolver<TrackingEventProcessor>,
 };
 
 export class Container {
@@ -136,6 +144,9 @@ export class Container {
             logger: this.getLogger('Tracker'),
             channel: this.getBeaconChannel(),
             eventMetadata: this.configuration.eventMetadata,
+            processor: this.configuration.eventProcessor === undefined
+                ? undefined
+                : this.configuration.eventProcessor(this),
         });
 
         const queue = this.getBeaconQueue();
@@ -170,11 +181,15 @@ export class Container {
     private createContext(): Context {
         const tokenKey = this.resolveStorageNamespace('token');
         const tabKey = this.resolveStorageNamespace('tab');
-        const browserStorage = this.getLocalStorage();
-        const browserCache = new LocalStorageCache(browserStorage, tokenKey);
+        const browserCache = this.configuration.tokenScope === 'global'
+            && this.configuration.cookie?.userToken !== undefined
+            ? new CookieCache(this.configuration.cookie.userToken)
+            : new LocalStorageCache(this.getLocalStorage(), tokenKey);
         const tabStorage = this.getSessionStorage();
 
-        this.removeTokenSyncListener = LocalStorageCache.autoSync(browserCache);
+        if (browserCache instanceof LocalStorageCache) {
+            this.removeTokenSyncListener = LocalStorageCache.autoSync(browserCache);
+        }
 
         return Context.load({
             tokenScope: this.configuration.tokenScope,
@@ -262,7 +277,9 @@ export class Container {
 
         return new CachedAssigner(
             new RemoteAssigner(this.configuration.cidAssignerEndpointUrl, logger),
-            new LocalStorageCache(this.getLocalStorage(), 'croct.cid'),
+            this.configuration.cookie?.clientId !== undefined
+                ? new CookieCache(this.configuration.cookie?.clientId)
+                : new LocalStorageCache(this.getLocalStorage(), 'croct.cid'),
             {
                 logger: logger,
                 mirror: !this.configuration.disableCidMirroring,

package/src/contentFetcher.ts

@@ -4,6 +4,7 @@ import {Token} from './token';
 import {BASE_ENDPOINT_URL, CLIENT_LIBRARY} from './constants';
 import {formatMessage} from './error';
 import {Logger, NullLogger} from './logging';
+import type {ApiKey} from './apiKey';
 
 export type ErrorResponse = {
     type: string,
@@ -76,13 +77,18 @@ export type FetchResponse<P extends JsonObject = JsonObject> = {
 
 export type Configuration = {
     appId?: string,
-    apiKey?: string,
+    apiKey?: string|ApiKey,
     baseEndpointUrl?: string,
     logger?: Logger,
 };
 
+type InternalConfiguration = {
+    appId?: string,
+    apiKey?: string,
+};
+
 export class ContentFetcher {
-    private readonly configuration: Pick<Configuration, 'appId' | 'apiKey'>;
+    private readonly configuration: InternalConfiguration;
 
     private readonly dynamicEndpoint: string;
 
@@ -95,9 +101,10 @@ export class ContentFetcher {
             throw new Error('Either the application ID or the API key must be provided.');
         }
 
-        this.configuration = configuration;
-
-        const {apiKey, baseEndpointUrl} = configuration;
+        const {baseEndpointUrl} = configuration;
+        const apiKey = typeof configuration.apiKey === 'object'
+            ? configuration.apiKey.getIdentifier()
+            : configuration.apiKey;
 
         // eslint-disable-next-line prefer-template -- Better readability
         const baseEndpoint = (baseEndpointUrl ?? BASE_ENDPOINT_URL).replace(/\/+$/, '')
@@ -107,6 +114,10 @@ export class ContentFetcher {
         this.dynamicEndpoint = `${baseEndpoint}/content`;
         this.staticEndpoint = `${baseEndpoint}/static-content`;
         this.logger = configuration.logger ?? new NullLogger();
+        this.configuration = {
+            appId: configuration.appId,
+            apiKey: apiKey,
+        };
     }
 
     public fetch<P extends JsonObject>(slotId: string, options: FetchOptions = {}): Promise<FetchResponse<P>> {

package/src/context.ts

@@ -3,7 +3,7 @@ import {Tab, UrlSanitizer} from './tab';
 import {uuid4} from './uuid';
 import {EventDispatcher} from './eventManager';
 import {SdkEventMap} from './sdkEvents';
-import {LocalStorageCache} from './cache';
+import {Cache, ObservableCache} from './cache';
 
 export type TokenScope = 'isolated' | 'global' | 'contextual';
 
@@ -12,9 +12,9 @@ export type Configuration = {
     urlSanitizer?: UrlSanitizer,
     eventDispatcher: ContextEventDispatcher,
     cache: {
-        tabId: LocalStorageCache,
-        tabToken: LocalStorageCache,
-        browserToken: LocalStorageCache,
+        tabId: Cache,
+        tabToken: Cache,
+        browserToken: Cache,
     },
 };
 
@@ -63,7 +63,9 @@ export class Context {
             case 'global': {
                 const context = new Context(tab, new CachedTokenStore(cache.browserToken), eventDispatcher);
 
-                cache.browserToken.addListener(context.syncToken);
+                if (ObservableCache.isObservable(cache.browserToken)) {
+                    cache.browserToken.addListener(context.syncToken);
+                }
 
                 return context;
             }

package/src/evaluator.ts

@@ -4,6 +4,7 @@ import {BASE_ENDPOINT_URL, CLIENT_LIBRARY, MAX_QUERY_LENGTH} from './constants';
 import {formatMessage} from './error';
 import {getLength, getLocation, Location} from './sourceLocation';
 import {Logger, NullLogger} from './logging';
+import type {ApiKey} from './apiKey';
 
 export type Campaign = {
     name?: string,
@@ -94,15 +95,20 @@ export class QueryError extends EvaluationError<QueryErrorResponse> {
 
 export type Configuration = {
     appId?: string,
-    apiKey?: string,
+    apiKey?: string|ApiKey,
     baseEndpointUrl?: string,
     logger?: Logger,
 };
 
+type InternalConfiguration = {
+    appId?: string,
+    apiKey?: string,
+};
+
 export class Evaluator {
     public static readonly MAX_QUERY_LENGTH = MAX_QUERY_LENGTH;
 
-    private readonly configuration: Pick<Configuration, 'appId' | 'apiKey'>;
+    private readonly configuration: InternalConfiguration;
 
     private readonly endpoint: string;
 
@@ -113,15 +119,20 @@ export class Evaluator {
             throw new Error('Either the application ID or the API key must be provided.');
         }
 
-        const {baseEndpointUrl, apiKey} = configuration;
+        const {baseEndpointUrl} = configuration;
+        const apiKey = typeof configuration.apiKey === 'object'
+            ? configuration.apiKey.getIdentifier()
+            : configuration.apiKey;
 
         // eslint-disable-next-line prefer-template -- Better readability
         this.endpoint = (baseEndpointUrl ?? BASE_ENDPOINT_URL).replace(/\/+$/, '')
             + (apiKey === undefined ? '/client' : '/external')
             + '/web/evaluate';
-
-        this.configuration = configuration;
         this.logger = configuration.logger ?? new NullLogger();
+        this.configuration = {
+            appId: configuration.appId,
+            apiKey: apiKey,
+        };
     }
 
     public evaluate(query: string, options: EvaluationOptions = {}): Promise<JsonValue> {

package/src/eventSubjectProcessor.ts

@@ -0,0 +1,85 @@
+import {QueuedEventInfo, TrackingEventProcessor} from './tracker';
+import {Token} from './token';
+import {Logger} from './logging';
+import {TrackingEvent} from './trackingEvents';
+
+export class EventSubjectProcessor implements TrackingEventProcessor {
+    private currentToken?: Token|null;
+
+    private logger: Logger;
+
+    public constructor(logger: Logger) {
+        this.logger = logger;
+    }
+
+    public process(event: QueuedEventInfo): QueuedEventInfo[] {
+        const {currentToken} = this;
+
+        this.currentToken = event.userToken ?? null;
+
+        if (currentToken === undefined) {
+            // This is the first event, no subject to compare.
+            // If the user is already identified at this point,
+            // assume that the event was previously tracked.
+            return [event];
+        }
+
+        if (EventSubjectProcessor.isIdentificationEvent(event.event)) {
+            return [event];
+        }
+
+        const currentSubject = currentToken?.getSubject() ?? null;
+        const newSubject = event.userToken?.getSubject() ?? null;
+
+        if (newSubject === currentSubject) {
+            // No change in subject
+            return [event];
+        }
+
+        const events: QueuedEventInfo[] = [];
+
+        if (currentToken !== null && currentSubject !== null) {
+            this.logger.info('External user sign out automatically tracked');
+
+            events.push({
+                timestamp: event.timestamp,
+                context: event.context,
+                userToken: currentToken,
+                event: {
+                    type: 'userSignedOut',
+                    userId: currentSubject,
+                },
+            });
+        }
+
+        if (newSubject !== null) {
+            this.logger.info('External user sign in automatically tracked');
+
+            events.push({
+                timestamp: event.timestamp,
+                context: event.context,
+                userToken: event.userToken,
+                event: {
+                    type: 'userSignedIn',
+                    userId: newSubject,
+                },
+            });
+        }
+
+        events.push(event);
+
+        return events;
+    }
+
+    private static isIdentificationEvent(event: TrackingEvent): boolean {
+        switch (event.type) {
+            case 'userSignedIn':
+            case 'userSignedUp':
+            case 'userSignedOut':
+                return true;
+
+            default:
+                return false;
+        }
+    }
+}