@frankieone/one-sdk 0.4.1-rc.0 → 0.4.2-alpha

package/dist/esm/modules/sdk/index.js

@@ -9,21 +9,52 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { individualModule } from "../individual";
 import { mkEventListener } from "../common";
-import { mkComponentLoader } from "./ComponentLoader";
-import { parseConfiguration } from "./parseConfiguration";
+import { mkComponentLoader } from "./initialisation/componentLoader";
+import { parseConfiguration } from "./initialisation/configurationParser";
+import { mkSharedDependencies } from "./initialisation/sharedDependencies";
 export const oneSdk = {
     initialise: function (oneSdkOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            const sharedState = yield parseConfiguration(oneSdkOptions);
-            const { globalEventHub } = sharedState;
-            const sdk = Object.assign(Object.assign({}, mkEventListener(globalEventHub)), { individual: () => individual, component: null });
-            const baseModuleOptions = Object.assign(Object.assign({}, sharedState), { oneSdkInstance: sdk });
-            // Make individual module
-            const individual = individualModule.initialise(Object.assign(Object.assign({}, baseModuleOptions), { instanceName: "individual" }));
-            // Make component factory
-            sdk.component = mkComponentLoader(baseModuleOptions);
-            // resolve onesdk once
-            return new Promise((resolve) => individual.on("data_loaded", () => resolve(sdk)));
+            const sharedDependencies = yield mkSharedDependencies(oneSdkOptions);
+            const { globalEventHub } = sharedDependencies;
+            try {
+                const { sharedState, warnings } = yield parseConfiguration(oneSdkOptions, sharedDependencies);
+                // Build the OneSDK instance which will be returned by this function
+                // The one sdk only exposes the listener methods of the event hubs
+                // Both the dynamic component loader and the individual component (which is returned by the "individual" method)
+                // are defined next
+                const globalEventListener = mkEventListener(globalEventHub);
+                const sdk = Object.assign(Object.assign({}, globalEventListener), { individual: () => individual, component: null });
+                const baseModuleOptions = Object.assign(Object.assign({}, sharedState), { oneSdkInstance: sdk });
+                // Initialise and label the individual component, which is special and will be
+                // available through the static factory method called "individual"
+                const individual = individualModule.initialise(Object.assign(Object.assign({}, baseModuleOptions), { instanceName: "individual" }));
+                // Make the dynamic component loader, which initialises components dynamically
+                sdk.component = mkComponentLoader(baseModuleOptions);
+                // wait for individual's data_loaded event before continuing
+                yield new Promise((resolve) => individual.on("data_loaded", () => resolve(sdk)));
+                // then schedule the emission of all events/warnings for after oneSDK instance is resolved
+                // Even telemetry, in case customers want to observe them
+                // TODO: THESE EVENTS NEED TO WAIT UNTIL ONESDK.ON IS CALLED
+                // Otherwise they are impossible to listen for
+                globalEventHub.emit("telemetry", {
+                    eventName: "INIT",
+                    data: { mode: sharedState.mode, recipe: sharedState.recipe, warnings },
+                });
+                warnings.forEach(({ level, data }) => globalEventHub.emit(level, data));
+                return sdk;
+            }
+            catch (error) {
+                // Errors that reach this catch block are critical errors and will interrupt the flow of the OneSDK
+                globalEventHub.emit("telemetry", {
+                    eventName: "INIT:ERROR",
+                    data: {
+                        oneSdkOptions,
+                    },
+                    error,
+                });
+                throw error;
+            }
         });
     },
 };

package/dist/esm/modules/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../modules/sdk/index.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI1D,MAAM,CAAC,MAAM,MAAM,GAAiB;IAClC,UAAU,EAAE,UAAgB,aAAa;;YACvC,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,aAAa,CAAC,CAAC;YAC5D,MAAM,EAAE,cAAc,EAAE,GAAG,WAAW,CAAC;YAEvC,MAAM,GAAG,mCAEJ,eAAe,CAAC,cAAc,CAAC,KAClC,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU,EAC5B,SAAS,EAAE,IAAI,GAChB,CAAC;YACF,MAAM,iBAAiB,mCAAqB,WAAW,KAAE,cAAc,EAAE,GAAG,GAAE,CAAC;YAC/E,yBAAyB;YACzB,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,iCACzC,iBAAiB,KACpB,YAAY,EAAE,YAAY,IAC1B,CAAC;YACH,yBAAyB;YACzB,GAAG,CAAC,SAAS,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;YAErD,sBAAsB;YACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC;KAAA;CACF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../modules/sdk/index.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAI3E,MAAM,CAAC,MAAM,MAAM,GAAiB;IAClC,UAAU,EAAE,UAAgB,aAAa;;YACvC,MAAM,kBAAkB,GAAG,MAAM,oBAAoB,CAAC,aAAa,CAAC,CAAC;YACrE,MAAM,EAAE,cAAc,EAAE,GAAG,kBAAkB,CAAC;YAC9C,IAAI;gBACF,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,MAAM,kBAAkB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;gBAE9F,oEAAoE;gBACpE,kEAAkE;gBAClE,gHAAgH;gBAChH,mBAAmB;gBACnB,MAAM,mBAAmB,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;gBAC5D,MAAM,GAAG,mCACJ,mBAAmB,KACtB,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU,EAC5B,SAAS,EAAE,IAAI,GAChB,CAAC;gBACF,MAAM,iBAAiB,mCAAqB,WAAW,KAAE,cAAc,EAAE,GAAG,GAAE,CAAC;gBAC/E,8EAA8E;gBAC9E,kEAAkE;gBAClE,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,iCACzC,iBAAiB,KACpB,YAAY,EAAE,YAAY,IAC1B,CAAC;gBACH,8EAA8E;gBAC9E,GAAG,CAAC,SAAS,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;gBAErD,4DAA4D;gBAC5D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACjF,0FAA0F;gBAC1F,yDAAyD;gBACzD,4DAA4D;gBAC5D,8CAA8C;gBAC9C,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE;oBAC/B,SAAS,EAAE,MAAM;oBACjB,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE;iBACvE,CAAC,CAAC;gBACH,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;gBAExE,OAAO,GAAG,CAAC;aACZ;YAAC,OAAO,KAAK,EAAE;gBACd,mGAAmG;gBACnG,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE;oBAC/B,SAAS,EAAE,YAAY;oBACvB,IAAI,EAAE;wBACJ,aAAa;qBACd;oBACD,KAAK;iBACN,CAAC,CAAC;gBACH,MAAM,KAAK,CAAC;aACb;QACH,CAAC;KAAA;CACF,CAAC"}

package/dist/{cjs/modules/sdk/ComponentLoader.d.ts → esm/modules/sdk/initialisation/componentLoader.d.ts}

@@ -1,4 +1,4 @@
-import { OneSdkContext, SharedState } from "./types";
+import { OneSdkContext, SharedState } from "../types";
 /**
  * This factory will generate another function which will
  * 1) load a public module by module name, defined in the dictionary PublicModules;

package/dist/esm/modules/sdk/{ComponentLoader.js → initialisation/componentLoader.js}

@@ -1,4 +1,4 @@
-import { merge, PublicModules } from "../common";
+import { merge, PublicModules } from "../../common";
 /**
  * This factory will generate another function which will
  * 1) load a public module by module name, defined in the dictionary PublicModules;
@@ -22,19 +22,44 @@ export const mkComponentLoader = (sharedState) => {
         // Use instance name to simply load an existing instance or to generate a new one and store it under that name
         // instance name defaults to the module name itself
         const { instanceName = which } = options !== null && options !== void 0 ? options : {};
+        // Store "telemetry-event-friendly" formatted component name for later use
+        const WHICH = which.toUpperCase();
         // if instance already exists, return it
         const instance = retrieveInstance(which, instanceName);
         if (instance)
             return instance;
         else {
-            // otherwise, resolve new configuration and initialise and return new instance
-            const mergedOptions = merge({}, sharedState, options, { instanceName });
+            // Otherwise,
+            // 1) resolve new configuration
+            const mergedOptions = merge({}, sharedState, options, { instanceName, componentName: which });
             sharedState.globalEventHub.emit("resolved_module_config", mergedOptions);
             const module = PublicModules[which];
-            const moduleContext = module.initialise(mergedOptions);
-            const instance = injectInstanceName(moduleContext, instanceName);
-            storeInstance(which, instanceName, instance);
-            return instance;
+            try {
+                // 2) Initialise module, resulting in the module context for that instance (aka a component)
+                const moduleContext = module.initialise(mergedOptions);
+                const instance = injectInstanceName(moduleContext, instanceName);
+                storeInstance(which, instanceName, instance);
+                // 3) Emit INIT event to telemetry immediately and map any future "error" events for this component, if applicable
+                sharedState.globalEventHub.emit("telemetry", {
+                    eventName: `COMPONENT:INIT`,
+                    data: { component: which, options },
+                });
+                // Since all event listeners support the "error" event, listen for any "error" events and submit them to "telemetry"
+                instance.on("error", (errorEvent) => sharedState.globalEventHub.emit("telemetry", {
+                    eventName: `COMPONENT:ERROR`,
+                    data: { component: which },
+                    error: errorEvent,
+                }));
+                return instance;
+            }
+            catch (error) {
+                sharedState.globalEventHub.emit("telemetry", {
+                    eventName: `COMPONENT:INIT:ERROR`,
+                    data: { component: which, options },
+                    error,
+                });
+                throw error;
+            }
         }
     };
     // the "defineProperty" below exposes the instances object and allows for easier testing
@@ -64,4 +89,4 @@ function mkInstanceDictionary() {
     };
     return { storeInstance, retrieveInstance, instancesDictionary };
 }
-//# sourceMappingURL=ComponentLoader.js.map
+//# sourceMappingURL=componentLoader.js.map

package/dist/esm/modules/sdk/initialisation/componentLoader.js.map

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

package/dist/esm/modules/sdk/initialisation/configurationParser.d.ts

@@ -0,0 +1,27 @@
+import { OneSdkRootParameters, RecipeParsed, SdkModes, SharedDependencies, SharedState } from "../types";
+/**
+ *
+ * Parses parameters passed to OneSDK constructor and returns a dictionary of sharedState variables and a list of warnings to be emitted as global events by the top level constructor
+ * @param oneSdkOptions All the parameters passed to the OneSDK constructor
+ * @returns { sharedState: Dictionary, warnings: { level: "info"|"warnings"|"error", message: string, payload: unknown }[] }
+ */
+export declare function parseConfiguration(oneSdkOptions: OneSdkRootParameters, sharedDependencies: SharedDependencies): Promise<{
+    sharedState: Omit<SharedState, "oneSdkInstance">;
+    warnings: Warning[];
+}>;
+export declare function resolveMode(oneSdkOptions: OneSdkRootParameters): {
+    modeName: SdkModes;
+    mode: OneSdkRootParameters["mode"];
+};
+export declare function resolveRecipeValue(recipe: OneSdkRootParameters["recipe"]): RecipeParsed;
+declare type Warning = {
+    level: "info" | "warning";
+    data: {
+        message: string;
+        payload?: unknown;
+    };
+} | {
+    level: "error";
+    data: Error;
+};
+export {};

package/dist/esm/modules/sdk/{parseConfiguration.js → initialisation/configurationParser.js}

@@ -18,22 +18,31 @@ var __rest = (this && this.__rest) || function (s, e) {
         }
     return t;
 };
-import { merge, mkEventHub } from "../common";
-import { mkFrankieClient } from "../frankie-client";
-import { ConfigurationClient } from "../frankie-client/clients/ConfigurationClient";
-import { SdkModes } from "./types";
-export function parseConfiguration(oneSdkOptions) {
-    var _a;
+import { merge, OneSDKError } from "../../common";
+import { ConfigurationClient } from "../../frankie-client/clients/ConfigurationClient";
+import { SdkModes } from "../types";
+/**
+ *
+ * Parses parameters passed to OneSDK constructor and returns a dictionary of sharedState variables and a list of warnings to be emitted as global events by the top level constructor
+ * @param oneSdkOptions All the parameters passed to the OneSDK constructor
+ * @returns { sharedState: Dictionary, warnings: { level: "info"|"warnings"|"error", message: string, payload: unknown }[] }
+ */
+export function parseConfiguration(oneSdkOptions, sharedDependencies) {
     return __awaiter(this, void 0, void 0, function* () {
+        const { frankieClient, globalEventHub } = sharedDependencies;
+        // Resolve final recipe name based on optionally provided recipe object
+        const warnings = [];
         const recipe = resolveRecipeValue(oneSdkOptions.recipe);
-        const mode = (_a = oneSdkOptions.mode) !== null && _a !== void 0 ? _a : SdkModes.PROD;
-        const globalEventHub = mkEventHub();
-        const frankieClient = yield mkFrankieClient({ mode, session: oneSdkOptions.session, globalEventHub });
+        const { mode, modeName } = resolveMode(oneSdkOptions);
         // use frankie client to fetch existing recipe configuration from API
-        const fetchedRecipeConfiguration = yield fetchRecipeConfig({ frankieClient, globalEventHub, recipe });
+        const fetchedRecipeConfiguration = yield fetchRecipeConfig({ frankieClient, globalEventHub, recipe }, warnings);
         // And merge it with provided config
-        const mergedRecipeConfiguration = mergeRecipeConfigurations(recipe, fetchedRecipeConfiguration, globalEventHub);
-        const modeName = typeof mode === "string" ? mode : mode.modeName;
+        const mergedRecipeConfiguration = mergeRecipeConfigurations(recipe, fetchedRecipeConfiguration, warnings);
+        // Assemble a "shared state" object, with all the internal resolved configuration and dependencies to be passed to all modules
+        // which is the output of this parseConfiguration function
+        // The oneSdkInstance object will *later* be injected by the OneSDK initialisation function and also shared with all modules.
+        // This gives the modules all capabilities that users also have when accessing the one sdk instance directly
+        // We can then from inside the modules provide an extra layer of abstraction and some level of "reflexion" to simplify different use cases.
         const sharedState = {
             mode,
             session: resolveSessionObject({ mode: modeName, frankieClient }),
@@ -41,13 +50,27 @@ export function parseConfiguration(oneSdkOptions) {
             frankieClient,
             recipe: mergedRecipeConfiguration,
         };
-        return sharedState;
+        return { sharedState, warnings };
     });
 }
+export function resolveMode(oneSdkOptions) {
+    var _a;
+    const mode = (_a = oneSdkOptions.mode) !== null && _a !== void 0 ? _a : SdkModes.PROD;
+    const modeName = typeof mode === "string" ? mode : mode.modeName;
+    return { modeName, mode };
+}
+export function resolveRecipeValue(recipe) {
+    var _a;
+    if (!recipe)
+        return { name: "auto" };
+    if (typeof recipe === "string")
+        return { name: recipe };
+    return Object.assign(Object.assign({}, recipe), { name: (_a = recipe.name) !== null && _a !== void 0 ? _a : "auto" });
+}
 function resolveSessionObject(options) {
     return options.frankieClient.session;
 }
-function mergeRecipeConfigurations(provided, fetched, eventHub) {
+function mergeRecipeConfigurations(provided, fetched, warnings) {
     // Merge configs by:
     // first) ensuring fetched configuration has recipe name (defaulting it to 'auto')
     // second) keeping fetched name if provided recipe name is 'auto'
@@ -58,35 +81,31 @@ function mergeRecipeConfigurations(provided, fetched, eventHub) {
         name: providedRecipeName === "auto" ? fetchedRecipeName : providedRecipeName,
     });
     if (providedRecipeName !== "auto" && fetchedRecipeName && providedRecipeName !== fetchedRecipeName) {
-        setTimeout(() => eventHub.emit("error", {
-            message: `Recipe name mismatch. Requested '${providedRecipeName}', found '${fetchedRecipeName}'. Configuration might be incorrect, so check this event's 'payload' for the resulting configuration object.`,
-            payload: mergedRecipeConfiguration,
-        }));
+        warnings.push({
+            level: "error",
+            data: new OneSDKError(`Recipe name mismatch. Requested '${providedRecipeName}', found '${fetchedRecipeName}'.` +
+                "Configuration might be incorrect. Check this event's 'payload' for the resulting configuration object.", mergedRecipeConfiguration),
+        });
     }
     return mergedRecipeConfiguration;
 }
-export function resolveRecipeValue(recipe) {
-    var _a;
-    if (!recipe)
-        return { name: "auto" };
-    if (typeof recipe === "string")
-        return { name: recipe };
-    return Object.assign(Object.assign({}, recipe), { name: (_a = recipe.name) !== null && _a !== void 0 ? _a : "auto" });
-}
-function fetchRecipeConfig(options) {
+function fetchRecipeConfig(options, warnings) {
     return __awaiter(this, void 0, void 0, function* () {
-        options.globalEventHub.emit("info", {
-            message: "Fetching recipe configuration",
-            payload: { recipeName: options.recipe },
+        warnings.push({
+            level: "info",
+            data: {
+                message: "Fetching recipe configuration",
+                payload: { recipeName: options.recipe.name },
+            },
         });
         const config = new ConfigurationClient(options.frankieClient, { recipe: options.recipe.name });
-        return config.load().catch((e) => {
-            options.globalEventHub.emit("error", {
-                message: "Failed fetching recipe configuration. Using provided configuration only.",
-                payload: e,
+        return config.load().catch((error) => {
+            warnings.push({
+                level: "error",
+                data: new OneSDKError("Failed fetching recipe configuration. Using provided configuration only.", error),
             });
             return {};
         });
     });
 }
-//# sourceMappingURL=parseConfiguration.js.map
+//# sourceMappingURL=configurationParser.js.map

package/dist/esm/modules/sdk/initialisation/configurationParser.js.map

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

package/dist/esm/modules/sdk/initialisation/sharedDependencies.d.ts

@@ -0,0 +1,5 @@
+import { EventHub } from "../../common";
+import { FrankieApiClient } from "../../frankie-client";
+import { GlobalEvents, OneSdkRootParameters, SharedDependencies } from "../types";
+export declare function mkSharedDependencies(oneSdkOptions: OneSdkRootParameters): Promise<SharedDependencies>;
+export declare function registerTelemetryEvents(globalEventHub: EventHub<GlobalEvents>, frankieClient: FrankieApiClient): void;

package/dist/esm/modules/sdk/initialisation/sharedDependencies.js

@@ -0,0 +1,109 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { mkEventHub } from "../../common";
+import { TelemetryEvent } from "../../common/shared/models/TelemetryEvent";
+import { mkFrankieClient } from "../../frankie-client";
+import { TelemetryEventsClient } from "../../frankie-client/clients/TelemetryEventsClient";
+import { version as oneSdkVersion } from "../../meta.json";
+import { browserName, deviceDetect, deviceType, getUA } from "mobile-device-detect";
+import { OneSDKError } from "../../common/errors/OneSDKError";
+import { resolveMode } from "./configurationParser";
+export function mkSharedDependencies(oneSdkOptions) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Create global event hub to be passed to all OneSdk modules
+        const globalEventHub = mkEventHub();
+        // Validate and deconstruct provided token and initialise a Frankie Client object to connect with our backend APIs
+        const { mode } = resolveMode(oneSdkOptions);
+        const frankieClient = yield mkFrankieClient({ mode, session: oneSdkOptions.session, globalEventHub });
+        // Use the already authenticated frankie client to register the "telemetry" events
+        // This will cause any emitted "telemetry" events anywhere in the onesdk to be registered to our backend
+        registerTelemetryEvents(globalEventHub, frankieClient);
+        return { globalEventHub, frankieClient };
+    });
+}
+export function registerTelemetryEvents(globalEventHub, frankieClient) {
+    var _a, _b, _c;
+    const session = frankieClient.session;
+    const screen = window.screen;
+    // Extract device details to send with each log
+    const device = deviceDetect();
+    // Assemble common telemetry event payload
+    const commonEventPayload = {
+        entityId: (_a = session.entityId) !== null && _a !== void 0 ? _a : "none",
+        customerReference: (_b = session.reference) !== null && _b !== void 0 ? _b : "none",
+        channel: "one-sdk",
+        customerId: session.customerID,
+        customerChildId: (_c = session.customerChildID) !== null && _c !== void 0 ? _c : "none",
+        sessionId: session.sessionId,
+        version: oneSdkVersion,
+        environment: session.environment,
+        browser: {
+            name: browserName !== null && browserName !== void 0 ? browserName : "not found",
+            userAgent: getUA,
+            language: navigator.language,
+        },
+        device: Object.assign({ type: deviceType, screen: {
+                height: screen.height,
+                width: screen.width,
+                availableHeight: screen.availHeight,
+                availableWidth: screen.availWidth,
+                colorDepth: screen.colorDepth,
+                orientation: screen.orientation.type,
+                pixelDepth: screen.pixelDepth,
+            } }, device),
+    };
+    const serialiseBestEffort = (error) => {
+        let payload;
+        if (error instanceof Error) {
+            payload = {
+                message: error.message,
+                stack: error.stack,
+            };
+        }
+        else {
+            payload = JSON.parse(JSON.stringify(error, Object.getOwnPropertyNames(error)));
+        }
+        if (error instanceof OneSDKError) {
+            payload.payload = error.payload;
+        }
+        return payload;
+    };
+    const telemetryClient = new TelemetryEventsClient(frankieClient);
+    // On each 'telemetry' event, submit event data to the telemetry/events endpoint
+    // Log each submission success or failure as a new event that may or may not be used by the user
+    globalEventHub.on("telemetry", (eventContents) => {
+        var _a;
+        const eventName = typeof eventContents === "string" ? eventContents : eventContents.eventName;
+        const data = typeof eventContents === "string" ? {} : (_a = Object.assign({}, eventContents.data)) !== null && _a !== void 0 ? _a : {};
+        const error = typeof eventContents === "string" ? null : eventContents.error;
+        if (error) {
+            // If an Error object is passed to the telemetry event, extract only the useful and serialisable information,
+            // If the error isn't an instance of Error, attempt to serialise it
+            data.error = serialiseBestEffort(error);
+        }
+        const event = new TelemetryEvent(eventName, Object.assign(Object.assign({}, commonEventPayload), { data }));
+        // Submit event asynchronously. The timing here doesn't matter as this is not a functionality customers
+        // will be relying on, or expecting to be completed. We submit, define a successful and a failed callback
+        // to simply inform or warn about the result, but won't emit "error" in case this fails.
+        telemetryClient
+            .dispatch(event)
+            .then(() => globalEventHub.emit("info", {
+            message: "Event 'telemetry' submitted successfully",
+            payload: { eventName, data },
+        }))
+            .catch((error) => {
+            globalEventHub.emit("warning", {
+                message: "There was a problem submitting event 'telemetry'. This doesn't impact the proper functioning of the OneSDK.",
+                payload: { eventName, data, error },
+            });
+        });
+    });
+}
+//# sourceMappingURL=sharedDependencies.js.map

package/dist/esm/modules/sdk/initialisation/sharedDependencies.js.map

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

package/dist/esm/modules/sdk/types/components.d.ts

@@ -13,12 +13,12 @@ export interface Module<Params extends BaseModuleOptions = BaseModuleOptions, Co
 export declare type BaseModuleOptions<InstanceName extends string = string> = SharedState & {
     instanceName: InstanceName;
 };
-export declare type ModuleContext<Context extends object = Dictionary, Events extends EventsDictionary = Record<string, unknown[]>> = Context & Omit<EventHub<Events>, "emit">;
+export declare type ModuleContext<Context extends object = Dictionary, Events extends EventsDictionary = EventsDictionary> = Context & Omit<EventHub<Events>, "emit">;
 export declare type ComponentOf<Module extends ModuleNames, InstanceName extends string = Module> = ContextOf<Module> & {
     instanceName: InstanceName;
 };
 export declare type ContextOf<Module extends ModuleNames> = ExtractContextFrom<ModulesDictionary[Module]>;
-export declare type ExtractContextFrom<TheModule extends Module> = ReturnType<TheModule["initialise"]>;
+export declare type ExtractContextFrom<TheModule extends Module> = ModuleContext<ReturnType<TheModule["initialise"]>>;
 export declare type ExtractExclusiveOptionsFrom<TheModule extends Module> = ParameterSubtraction<TheModule["initialise"], BaseModuleOptions>;
 declare type OptionalBaseOptions<InstanceName extends string> = Omit<PartialDeep<BaseModuleOptions<InstanceName>>, "globalEventHub">;
 export declare type ExtractPublicOptionsFrom<TheModule extends Module, InstanceName extends string> = ExtractExclusiveOptionsFrom<TheModule> & OptionalBaseOptions<InstanceName>;

package/dist/esm/modules/sdk/types/configuration.d.ts

@@ -60,13 +60,15 @@ export declare type OneSdkRootParameters = {
         token: string;
     };
 });
-export declare type SharedState = {
+export declare type SharedDependencies = {
     globalEventHub: EventHub<GlobalEvents>;
     frankieClient: FrankieApiClient;
+};
+export declare type SharedState = {
     oneSdkInstance: OneSdkContext;
     recipe: RecipeParsed;
     session: SessionMeta;
-} & Required<Omit<OneSdkRootParameters, "session">>;
+} & SharedDependencies & Required<Omit<OneSdkRootParameters, "session">>;
 export declare type SessionMeta = {
     sessionId: string;
     customerID: string;

package/dist/esm/modules/sdk/types/events.d.ts

@@ -1,5 +1,11 @@
-import { SharedState } from "./configuration";
+import type { TelemetryEvent } from "../../common/shared/models/TelemetryEvent";
+import type { SharedState } from "./configuration";
 export declare type GlobalEvents = {
     resolved_root_config: [Omit<SharedState, "globalEventHub" | "oneSdkInstance">];
     resolved_module_config: [SharedState];
+    telemetry: [string | {
+        eventName: string;
+        data?: TelemetryEvent["data"];
+        error?: Error;
+    }];
 };

package/dist/esm/types/Utilities.d.ts

@@ -5,7 +5,7 @@ export {};
  * Helper Type that if Func is a function whose first argument is an object,
  * return said object without any properties in common with object Sub
  */
-export declare type ParameterSubtraction<Func, Sub extends Dictionary> = Func extends (argument: unknown) => unknown ? Omit<Parameters<Func>[0], keyof Sub> extends Record<string, never> ? never : Omit<Parameters<Func>[0], keyof Sub> : never;
+export declare type ParameterSubtraction<Func, Sub extends Dictionary> = Func extends (...args: any[]) => unknown ? Omit<Parameters<Func>[0], keyof Sub> extends Record<string, never> ? never : Omit<Parameters<Func>[0], keyof Sub> : never;
 /**
  * KeyOf<Dictionary> Extracts a string-key of an object
  */

package/dist/release.txt

@@ -1 +1 @@
-
+RC