@frankieone/one-sdk 0.0.1-npm

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,7 @@
+import type { EventHub } from '../../common';
+import type { ResolvedRootParameters, SharedDependencies } from '../../common/types';
+import type { FrankieApiClient } from '../../frankie-client';
+import type { GlobalEvents } from '../types';
+export declare function mkSharedDependencies(oneSdkParameters: ResolvedRootParameters): Promise<SharedDependencies>;
+export declare function registerTelemetryEvents(globalEventHub: EventHub<GlobalEvents>, frankieClient: FrankieApiClient): void;
+//# sourceMappingURL=sharedDependencies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sharedDependencies.d.ts","sourceRoot":"","sources":["../../../../../modules/sdk/initialisation/sharedDependencies.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAS/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C,wBAAsB,oBAAoB,CACxC,gBAAgB,EAAE,sBAAsB,GACvC,OAAO,CAAC,kBAAkB,CAAC,CA+B7B;AAED,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,QAAQ,CAAC,YAAY,CAAC,EACtC,aAAa,EAAE,gBAAgB,QAsJhC"}

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

@@ -0,0 +1,190 @@
+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 { UAParser } from 'ua-parser-js';
+import { mkEventHub } from '../../common/index.js';
+import { TelemetryEvent } from '../../common/shared/models/TelemetryEvent.js';
+import { getInitialiser } from '../../config/index.js';
+import { mkFrankieClient } from '../../frankie-client/index.js';
+import { TelemetryEventsClient } from '../../frankie-client/clients/TelemetryEventsClient.js';
+import packageMeta from '../../meta.json';
+import { OneSDKError } from '../../common/errors/OneSDKError.class.js';
+import { includeTelemetry } from './configurationParser.js';
+const oneSdkVersion = packageMeta.version;
+export function mkSharedDependencies(oneSdkParameters) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Create global event hub to be passed to all OneSdk modules
+        const { mode } = oneSdkParameters;
+        const globalEventHub = mkEventHub();
+        // ! WARNING: Events emitted here are not visible to the host application
+        // TODO: Create a LazyEventHub object that allows event emission to be delayed until the first listener is added and attach it to the global event hub
+        // Instead of emitting the event, it simply stores the calls and emit it once requested
+        // This can be used HERE, by the session module to emit warnings and telemetry events
+        // It can also be used by the function `parseConfiguration`, instead of returning an array of "warnings"
+        const sessionContext = getInitialiser('session')(oneSdkParameters, {
+            globalEventHub,
+        });
+        // Initialise a Frankie Client object to connect with our backend APIs
+        const frankieClient = yield mkFrankieClient({
+            mode,
+            session: sessionContext,
+        });
+        // 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
+        try {
+            if (includeTelemetry(oneSdkParameters))
+                registerTelemetryEvents(globalEventHub, frankieClient);
+        }
+        catch (e) {
+            // ! ATTENTION: The reason for using console.warn instead of an event "warning" is mentioned above.
+            // eslint-disable-next-line no-console
+            console.warn(`Non critical error detected: ${e.message}. Telemetry events might not be emitted for analytics.`);
+        }
+        return { globalEventHub, frankieClient, session: sessionContext };
+    });
+}
+export function registerTelemetryEvents(globalEventHub, frankieClient) {
+    const session = frankieClient.session;
+    const screen = window.screen;
+    const DESKTOP_MINIMUM_WIDTH = 961;
+    const getScreenOrientation = () => {
+        var _a, _b, _c;
+        if (screen.orientation) {
+            return (_b = (_a = screen.orientation) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : 'unknown';
+        }
+        // iOS devices don't support screen.orientation,
+        // so we need to use window.orientation
+        const angle = (_c = window.orientation) !== null && _c !== void 0 ? _c : undefined;
+        switch (angle) {
+            case 0:
+                return 'portrait-primary';
+            case 180:
+                return 'portrait-secondary';
+            case 90:
+                return 'landscape-primary';
+            case -90:
+                return 'landscape-secondary';
+            default:
+                return 'unknown';
+        }
+    };
+    const screenInformation = !screen
+        ? 'no screen information'
+        : {
+            height: screen.height,
+            width: screen.width,
+            availableHeight: screen.availHeight,
+            availableWidth: screen.availWidth,
+            colorDepth: screen.colorDepth,
+            orientation: getScreenOrientation(),
+            pixelDepth: screen.pixelDepth,
+        };
+    const userAgentDetails = new UAParser().getResult();
+    const norm = (v) => v === null || v === void 0 ? void 0 : v.toLowerCase();
+    const resolveDeviceType = () => {
+        // Desktop device type can't be inferred from UA,
+        // so whenever it's undefined infer it from the screen size
+        const fromUserAgent = userAgentDetails.device.type;
+        const fromScreenSize = typeof screenInformation === 'string'
+            ? 'undefined'
+            : screenInformation.width >= DESKTOP_MINIMUM_WIDTH
+                ? 'desktop'
+                : 'mobile';
+        return norm(fromUserAgent !== null && fromUserAgent !== void 0 ? fromUserAgent : fromScreenSize);
+    };
+    // Assemble common telemetry event payload
+    const commonEventPayload = () => {
+        var _a, _b, _c;
+        return ({
+            entityId: (_a = session.entityId) !== null && _a !== void 0 ? _a : 'none',
+            customerReference: (_b = session.reference) !== null && _b !== void 0 ? _b : 'none',
+            channel: ['one-sdk', frankieClient.session.appReference]
+                .filter(Boolean)
+                .join('/'),
+            customerId: session.customerID,
+            customerChildId: (_c = session.customerChildID) !== null && _c !== void 0 ? _c : 'none',
+            sessionId: session.sessionId,
+            version: oneSdkVersion,
+            environment: session.environment,
+            browser: {
+                userAgent: userAgentDetails.ua,
+                language: norm(navigator.language),
+                name: norm(userAgentDetails.browser.name),
+                version: norm(userAgentDetails.browser.version),
+            },
+            device: {
+                type: resolveDeviceType(),
+                screen: screenInformation,
+                model: norm(userAgentDetails.device.model),
+                osName: norm(userAgentDetails.os.name),
+                osVersion: norm(userAgentDetails.os.version),
+                vendor: norm(userAgentDetails.device.vendor),
+                cpu: userAgentDetails.cpu,
+                engine: userAgentDetails.engine,
+            },
+        });
+    };
+    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;
+        try {
+            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 },
+                });
+            });
+        }
+        catch (e) {
+            // eslint-disable-next-line no-console
+            console.warn(`Telemetry event failed. ${e.message}`);
+        }
+    });
+}
+//# 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/globalEvents.d.ts

@@ -0,0 +1,12 @@
+import type { TelemetryEvent } from "../../common/shared/models/TelemetryEvent";
+import { GlobalState, InjectedState } from "../../common/types";
+export type GlobalEvents = {
+    resolved_root_config: [Omit<GlobalState, "globalEventHub" | "oneSdkInstance">];
+    resolved_module_config: [InjectedState, unknown];
+    telemetry: [string | {
+        eventName: string;
+        data?: TelemetryEvent["data"];
+        error?: Error;
+    }];
+};
+//# sourceMappingURL=globalEvents.d.ts.map

package/dist/esm/modules/sdk/types/globalEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalEvents.d.ts","sourceRoot":"","sources":["../../../../../modules/sdk/types/globalEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAElE,MAAM,MAAM,YAAY,GAAG;IAEzB,oBAAoB,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAC/E,sBAAsB,EAAE,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAEjD,SAAS,EAAE,CAAC,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAC3F,CAAC"}

package/dist/esm/modules/sdk/types/globalEvents.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=globalEvents.js.map

package/dist/esm/modules/sdk/types/globalEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalEvents.js","sourceRoot":"","sources":["../../../../../modules/sdk/types/globalEvents.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,4 @@
+export * from "./globalEvents";
+export * from "./oneSDK";
+export * from "./oneSDKParameters";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/modules/sdk/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../modules/sdk/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from "./globalEvents.js";
+export * from "./oneSDK.js";
+export * from "./oneSDKParameters.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../modules/sdk/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,16 @@
+import { Modules } from "../../config/index.js";
+import { IndividualModuleContext } from "../../individual";
+import { ModuleContext } from "../../common/types/oneSDKModules";
+import { GlobalEvents } from "./globalEvents";
+import { OneSdkRootParameters } from "./oneSDKParameters";
+import { SessionFacade } from "../../session/SessionFacade";
+export type OneSdkContext = ModuleContext<{
+    individual: () => ModuleContext<IndividualModuleContext>;
+    component: Modules["factoryFunctions"]["component"];
+    flow: Modules["factoryFunctions"]["flow"];
+    session: SessionFacade;
+}, GlobalEvents>;
+export type OneSdkModule = {
+    initialise(p: OneSdkRootParameters): Promise<OneSdkContext>;
+};
+//# sourceMappingURL=oneSDK.d.ts.map

package/dist/esm/modules/sdk/types/oneSDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneSDK.d.ts","sourceRoot":"","sources":["../../../../../modules/sdk/types/oneSDK.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG,aAAa,CACvC;IACE,UAAU,EAAE,MAAM,aAAa,CAAC,uBAAuB,CAAC,CAAC;IACzD,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,aAAa,CAAC;CACxB,EACD,YAAY,CACb,CAAC;AACF,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,CAAC,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7D,CAAC"}

package/dist/esm/modules/sdk/types/oneSDK.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=oneSDK.js.map

package/dist/esm/modules/sdk/types/oneSDK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneSDK.js","sourceRoot":"","sources":["../../../../../modules/sdk/types/oneSDK.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,105 @@
+import type { RecipeConfiguration } from '../../common';
+import type { SimplifiedMockOptions } from '../../frankie-client/mocks/options/simplified/SimplifiedMockOptions.type';
+import type { PartialDeep, SetRequired } from 'type-fest';
+/**
+ * Different levels of configuration may be done in OneSdk. This isn't a requirement,
+ * but allows us to ensure options are consistent and compatible throughout all levels of OneSdk
+ *
+ * Throughout this codebase "options" refer to the options passed to the OneSdk and "configuration/config" are the recipe configuration.
+ * Recipe/recipe name is the string name representing a recipe.
+ *
+ * 1) initialisation as OneSdk({
+ *  * all options are optional on initialisation
+ *  recipe?,
+ *  environment?
+ *  mode?
+ *  session (required unless mode is "dummy")
+ * })
+ * 2) Resulting parsed configuration = {
+ *  * once parsed, all missing options will be filled with defaults
+ *  * recipe object will be fetched from API and merged with recipe object from initialisation, if any
+ *  recipe,
+ *  environment,
+ *  mode,
+ *  session (unless mode is "dummy")
+ * }
+ * 3) When instanciating a component = {
+ *  * instanceName allows multiple instances to be stored in a central instance registry, otherwise by default only one instance is
+ *  * created for each module this allows modules to call existing instances or create new instances on demand and
+ *  * share them with other modules
+ *  instanceName?
+ * }
+ */
+export type OneSdkRootParameters = {
+    recipe?: RecipeOption;
+    telemetry?: boolean;
+    devtools?: boolean;
+} & ModeAndSessionOptions;
+/******* Below you'll find the bits and pieces that together form the parameter object above */
+export type PartialRecipe = PartialDeep<RecipeConfiguration>;
+export type RecipeOption = string | PartialRecipe;
+export type RecipeParsed = SetRequired<PartialRecipe, 'name'>;
+/**
+ * * SdkModes are the different modes in which the SDK can be initialised.
+ * TODO: Rename it to SdkMode for consistency. Any enums meant to be used as a type should be named as a singular.
+ * This is because they are assignable as a single value, not as a collection of values.
+ * ie currentMode: SdkMode = SdkMode.DEV
+ * on the other hand, enums exposed as a collection of values should be named as a plural.
+ * ie moduleContext.modes = { DEV: "development", PROD: "production" }
+ *
+ * There is a fine line between the two concepts and this is still a discussion in progress.
+ */
+export declare enum SdkModes {
+    DEV = "development",
+    PROD = "production",
+    DUMMY = "dummy"
+}
+export type DummyModeOptions = {
+    modeName: SdkModes.DUMMY;
+    mocks?: SimplifiedMockOptions;
+};
+export type NonDummyModeOptions = {
+    modeName: Exclude<SdkModes, SdkModes.DUMMY>;
+};
+/**
+ * * Mode Options
+ * If in dummy mode, it doesn't contain a session object
+ * Tagged unions only apply to fields in the root of objects, so when mode is defined as an object the typing simply breaks.
+ * ie the assignment below doesn't work because typescript can't infer the type of "mode" from its object form
+ * - declare let session: ModeAndSessionOptions["session"];
+ * - declare let mode: ModeAndSessionOptions["mode"];
+ * - const config: ModeAndSessionOptions = {
+ * -   mode,
+ * -   session,
+ * - };
+ *
+ * The fix is to use type assertions instead
+ * - const config = {
+ * -   mode,
+ * -   session,
+ * - } as ModeAndSessionOptions;
+ * https://github.com/microsoft/TypeScript/issues/18758
+ * */
+type ModeOptionsObject<Mode extends SdkModes> = Mode extends SdkModes.DUMMY ? DummyModeOptions : NonDummyModeOptions;
+type ModeOption<Mode extends SdkModes> = Mode | ModeOptionsObject<Mode>;
+/**
+ * Session Options
+ * Session is not required when in dummy mode
+ */
+type SessionOptions = {
+    /** token is required when not in dummy mode */
+    token: string;
+    /** persist will ensure the provided token is stored and reused next time OneSDK is initialised */
+    persist?: boolean;
+    /** appReference identifies the host application executing the OneSDK. This is attached to logs and used by some services in their decision making */
+    appReference?: string;
+};
+export type ModeAndSessionOptions = {
+    mode: ModeOption<SdkModes.DUMMY>;
+    session?: SessionOptions | null;
+} | {
+    mode?: ModeOption<SdkModes.PROD | SdkModes.DEV>;
+    session: SessionOptions;
+};
+export {};
+//# sourceMappingURL=oneSDKParameters.d.ts.map

package/dist/esm/modules/sdk/types/oneSDKParameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneSDKParameters.d.ts","sourceRoot":"","sources":["../../../../../modules/sdk/types/oneSDKParameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4EAA4E,CAAC;AAExH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,qBAAqB,CAAC;AAE1B,+FAA+F;AAC/F,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAAC;AAC7D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,oBAAY,QAAQ;IAClB,GAAG,gBAAgB;IACnB,IAAI,eAAe;IACnB,KAAK,UAAU;CAChB;AACD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC;IACzB,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;CAC7C,CAAC;AACF;;;;;;;;;;;;;;;;;;KAkBK;AACL,KAAK,iBAAiB,CAAC,IAAI,SAAS,QAAQ,IAAI,IAAI,SAAS,QAAQ,CAAC,KAAK,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AACrH,KAAK,UAAU,CAAC,IAAI,SAAS,QAAQ,IAAI,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAExE;;;GAGG;AACH,KAAK,cAAc,GAAG;IACpB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,kGAAkG;IAClG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qJAAqJ;IACrJ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IACE,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACjC,GACD;IACE,IAAI,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChD,OAAO,EAAE,cAAc,CAAC;CACzB,CAAC"}

package/dist/esm/modules/sdk/types/oneSDKParameters.js

@@ -0,0 +1,17 @@
+/**
+ * * SdkModes are the different modes in which the SDK can be initialised.
+ * TODO: Rename it to SdkMode for consistency. Any enums meant to be used as a type should be named as a singular.
+ * This is because they are assignable as a single value, not as a collection of values.
+ * ie currentMode: SdkMode = SdkMode.DEV
+ * on the other hand, enums exposed as a collection of values should be named as a plural.
+ * ie moduleContext.modes = { DEV: "development", PROD: "production" }
+ *
+ * There is a fine line between the two concepts and this is still a discussion in progress.
+ */
+export var SdkModes;
+(function (SdkModes) {
+    SdkModes["DEV"] = "development";
+    SdkModes["PROD"] = "production";
+    SdkModes["DUMMY"] = "dummy";
+})(SdkModes || (SdkModes = {}));
+//# sourceMappingURL=oneSDKParameters.js.map

package/dist/esm/modules/sdk/types/oneSDKParameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneSDKParameters.js","sourceRoot":"","sources":["../../../../../modules/sdk/types/oneSDKParameters.ts"],"names":[],"mappings":"AA8CA;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,+BAAmB,CAAA;IACnB,+BAAmB,CAAA;IACnB,2BAAe,CAAA;AACjB,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB"}

package/dist/esm/modules/session/SessionContext.d.ts

@@ -0,0 +1,71 @@
+import type { EventListener } from '../common';
+type Options = Partial<{
+    takenFromStorage: false | (() => void);
+    appReference: string;
+}>;
+/**
+ *
+ */
+export declare class SessionContext implements EventListener {
+    #private;
+    /**
+     * If tokenOrMeta is a string, it's the token itself and will be decoded into the {@link SessionMeta} object
+     * If tokenOrMeta is the {@link SessionMeta} object itself, it's already decoded and will be used as is
+     * @param tokenOrMeta Either the token string or the pre-decoded token payload
+     * @param options Options object
+     */
+    constructor(tokenOrMeta: string | SessionMeta, options?: Options);
+    on(): void;
+    off(): void;
+    isTakenFromStorage(): boolean;
+    unpersist(): void;
+    get appReference(): string | null;
+    get customerID(): string;
+    get customerChildID(): string;
+    get environment(): string;
+    get sessionId(): string;
+    get entityId(): string;
+    get reference(): string;
+    get token(): string;
+    setToken(token: string): void;
+    setEntityId(entityId: string): void;
+    isValid(): boolean;
+    static assembleMeta({ data }: DecodedToken): SessionMeta;
+    static decodeToken(token: string): DecodedToken;
+    static verifyExpiration(decodedToken: DecodedToken): boolean;
+}
+export type SessionMeta = Readonly<{
+    sessionId: string;
+    customerID: string;
+    customerChildID: string | null;
+    environment: string;
+}> & SomeEntityIdentification;
+type SomeEntityIdentification = {
+    entityId: string;
+    reference: string | null;
+} | {
+    reference: string;
+    entityId: string | null;
+};
+type DecodedToken = {
+    data: SessionTokenPayload;
+    exp: number;
+};
+export declare const hasEntityId: (p: ApplicantId) => p is {
+    entityId: string;
+};
+export type ApplicantId = {
+    entityId: string;
+} | {
+    reference: string;
+};
+export type SessionTokenPayload = {
+    organisation: {
+        customerId: string;
+        customerChildId?: string;
+    };
+    sessionId: string;
+    environment: string;
+} & ApplicantId;
+export {};
+//# sourceMappingURL=SessionContext.d.ts.map

package/dist/esm/modules/session/SessionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionContext.d.ts","sourceRoot":"","sources":["../../../../modules/session/SessionContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,KAAK,OAAO,GAAG,OAAO,CAAC;IACrB,gBAAgB,EAAE,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AACH;;GAEG;AACH,qBAAa,cAAe,YAAW,aAAa;;IAKlD;;;;;OAKG;gBACS,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO;IAYhE,EAAE;IAGF,GAAG;IAIH,kBAAkB;IAIlB,SAAS;IAKT,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IACD,IAAI,UAAU,WAEb;IACD,IAAI,eAAe,WAElB;IACD,IAAI,WAAW,WAEd;IACD,IAAI,SAAS,WAEZ;IACD,IAAI,QAAQ,WAEX;IACD,IAAI,SAAS,WAEZ;IACD,IAAI,KAAK,WAER;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM;IAYtB,WAAW,CAAC,QAAQ,EAAE,MAAM;IAI5B,OAAO;IAIP,MAAM,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,YAAY,GAAG,WAAW;IAUxD,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAG/C,MAAM,CAAC,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO;CAO7D;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,GACA,wBAAwB,CAAC;AAC3B,KAAK,wBAAwB,GACzB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9C;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AACnD,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,eAAO,MAAM,WAAW,MAAO,WAAW;cAAoB,MAAM;CACV,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AACvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,WAAW,CAAC"}

package/dist/esm/modules/session/SessionContext.js

@@ -0,0 +1,123 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _SessionContext_meta, _SessionContext_token, _SessionContext_decodedToken, _SessionContext_options;
+import jwtDecode from 'jwt-decode';
+/**
+ *
+ */
+export class SessionContext {
+    /**
+     * If tokenOrMeta is a string, it's the token itself and will be decoded into the {@link SessionMeta} object
+     * If tokenOrMeta is the {@link SessionMeta} object itself, it's already decoded and will be used as is
+     * @param tokenOrMeta Either the token string or the pre-decoded token payload
+     * @param options Options object
+     */
+    constructor(tokenOrMeta, options) {
+        var _a, _b;
+        _SessionContext_meta.set(this, void 0);
+        _SessionContext_token.set(this, void 0);
+        _SessionContext_decodedToken.set(this, void 0);
+        _SessionContext_options.set(this, void 0);
+        __classPrivateFieldSet(this, _SessionContext_options, {
+            takenFromStorage: (_a = options === null || options === void 0 ? void 0 : options.takenFromStorage) !== null && _a !== void 0 ? _a : false,
+            appReference: (_b = options === null || options === void 0 ? void 0 : options.appReference) !== null && _b !== void 0 ? _b : null,
+        }, "f");
+        if (typeof tokenOrMeta === 'string')
+            this.setToken(tokenOrMeta);
+        else {
+            __classPrivateFieldSet(this, _SessionContext_token, null, "f");
+            __classPrivateFieldSet(this, _SessionContext_meta, tokenOrMeta, "f");
+        }
+    }
+    on() {
+        throw new Error('No implementation yet. This is WIP');
+    }
+    off() {
+        throw new Error('No implementation yet. This is WIP');
+    }
+    isTakenFromStorage() {
+        return Boolean(__classPrivateFieldGet(this, _SessionContext_options, "f").takenFromStorage);
+    }
+    unpersist() {
+        const cleanup = __classPrivateFieldGet(this, _SessionContext_options, "f").takenFromStorage;
+        if (typeof cleanup === 'function')
+            return cleanup();
+    }
+    get appReference() {
+        return __classPrivateFieldGet(this, _SessionContext_options, "f").appReference;
+    }
+    get customerID() {
+        return __classPrivateFieldGet(this, _SessionContext_meta, "f").customerID;
+    }
+    get customerChildID() {
+        return __classPrivateFieldGet(this, _SessionContext_meta, "f").customerChildID;
+    }
+    get environment() {
+        return __classPrivateFieldGet(this, _SessionContext_meta, "f").environment;
+    }
+    get sessionId() {
+        return __classPrivateFieldGet(this, _SessionContext_meta, "f").sessionId;
+    }
+    get entityId() {
+        return __classPrivateFieldGet(this, _SessionContext_meta, "f").entityId;
+    }
+    get reference() {
+        return __classPrivateFieldGet(this, _SessionContext_meta, "f").reference;
+    }
+    get token() {
+        return __classPrivateFieldGet(this, _SessionContext_token, "f");
+    }
+    setToken(token) {
+        var _a, _b, _c, _d;
+        __classPrivateFieldSet(this, _SessionContext_token, token, "f");
+        __classPrivateFieldSet(this, _SessionContext_decodedToken, SessionContext.decodeToken(token), "f");
+        // Ensure any discovered identitification is preserved
+        const existingEntityId = (_b = (_a = __classPrivateFieldGet(this, _SessionContext_meta, "f")) === null || _a === void 0 ? void 0 : _a.entityId) !== null && _b !== void 0 ? _b : null;
+        const existingReference = (_d = (_c = __classPrivateFieldGet(this, _SessionContext_meta, "f")) === null || _c === void 0 ? void 0 : _c.reference) !== null && _d !== void 0 ? _d : null;
+        __classPrivateFieldSet(this, _SessionContext_meta, SessionContext.assembleMeta(__classPrivateFieldGet(this, _SessionContext_decodedToken, "f")), "f");
+        if (existingEntityId)
+            __classPrivateFieldGet(this, _SessionContext_meta, "f").entityId = existingEntityId;
+        if (existingReference)
+            __classPrivateFieldGet(this, _SessionContext_meta, "f").reference = existingReference;
+    }
+    setEntityId(entityId) {
+        __classPrivateFieldGet(this, _SessionContext_meta, "f").entityId = entityId;
+    }
+    isValid() {
+        return SessionContext.verifyExpiration(__classPrivateFieldGet(this, _SessionContext_decodedToken, "f"));
+    }
+    static assembleMeta({ data }) {
+        var _a, _b;
+        return {
+            customerID: data.organisation.customerId,
+            customerChildID: data.organisation.customerChildId,
+            environment: data.environment,
+            sessionId: data.sessionId,
+            entityId: (_a = data.entityId) !== null && _a !== void 0 ? _a : null,
+            reference: (_b = data.reference) !== null && _b !== void 0 ? _b : null,
+        };
+    }
+    static decodeToken(token) {
+        return jwtDecode(token);
+    }
+    static verifyExpiration(decodedToken) {
+        if (!decodedToken)
+            return false;
+        // Epoch seconds vs milliseconds
+        const currentEpoch = Date.now();
+        const expirationEpoch = decodedToken.exp * 1000;
+        return currentEpoch <= expirationEpoch;
+    }
+}
+_SessionContext_meta = new WeakMap(), _SessionContext_token = new WeakMap(), _SessionContext_decodedToken = new WeakMap(), _SessionContext_options = new WeakMap();
+export const hasEntityId = (p) => typeof p.entityId === 'string';
+//# sourceMappingURL=SessionContext.js.map

package/dist/esm/modules/session/SessionContext.js.map

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