@frankieone/one-sdk 0.0.1-npm

package/dist/esm/modules/common/modules/HOF.js

@@ -0,0 +1,67 @@
+// TODO -- decouple it from eventHub
+// TODO -- instead of automatically running the function on the callback event, it should check the condition again
+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());
+    });
+};
+/**
+ * runIfWhen
+ * - runs the function "run" if "condition" is true,
+ * - otherwise it will wait for the event "elseWaitFor" to be emitted by "eventHub" to run the function
+ * @param run main function to be run
+ * @param condition function returning a boolean
+ * @param elseWaitFor string with the name of the event to trigger a retry
+ *
+ * @returns a function that takes the same parameters as "run" and returns a promise with the same results returned by "run"
+ */
+const hasEventCallback = (option) => 'elseWaitFor' in option;
+export function runIfWhen(opt) {
+    const callback = (...args) => {
+        if (opt.condition())
+            return Promise.resolve(opt.run(...args));
+        else if (hasEventCallback(opt)) {
+            return new Promise((resolve, reject) => {
+                const eventName = opt.elseWaitFor;
+                const eventCallback = () => __awaiter(this, void 0, void 0, function* () {
+                    if (timeout)
+                        clearTimeout(timeout);
+                    resolve(opt.run(...args));
+                });
+                const timeoutCallback = () => {
+                    opt.on.off(eventName, eventCallback);
+                    reject(`Timed out in ${opt.timeoutMilliSecond} milliseconds.`);
+                };
+                let timeout;
+                if (opt.timeoutMilliSecond)
+                    timeout = setTimeout(timeoutCallback);
+                opt.on.on(eventName, eventCallback);
+            });
+        }
+    };
+    return callback;
+}
+/**
+ * runOnce
+ * - takes a function and an error message and returns an equivalent function that
+ * can only be called once. The second time the function is called, an error is thrown
+ * containing the provided error message.
+ * @param func The function to be run
+ * @param errorMessage An error message if the function is called twice
+ * @returns The provided function
+ */
+export const runOnce = (func, errorMessage) => {
+    let wasCalled = false;
+    return ((...args) => {
+        if (wasCalled)
+            throw new Error(errorMessage);
+        const result = func(...args);
+        wasCalled = true;
+        return result;
+    });
+};
+//# sourceMappingURL=HOF.js.map

package/dist/esm/modules/common/modules/HOF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HOF.js","sourceRoot":"","sources":["../../../../../modules/common/modules/HOF.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,mHAAmH;;;;;;;;;;AAyBnH;;;;;;;;;GASG;AAEH,MAAM,gBAAgB,GAAG,CACvB,MAAyB,EACgB,EAAE,CAAC,aAAa,IAAI,MAAM,CAAC;AACtE,MAAM,UAAU,SAAS,CACvB,GAA8B;IAE9B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;QACtC,IAAI,GAAG,CAAC,SAAS,EAAE;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;aACzD,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC;gBAClC,MAAM,aAAa,GAAG,GAAS,EAAE;oBAC/B,IAAI,OAAO;wBAAE,YAAY,CAAC,OAAO,CAAC,CAAC;oBACnC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;gBAC5B,CAAC,CAAA,CAAC;gBACF,MAAM,eAAe,GAAG,GAAG,EAAE;oBAC3B,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;oBACrC,MAAM,CAAC,gBAAgB,GAAG,CAAC,kBAAkB,gBAAgB,CAAC,CAAC;gBACjE,CAAC,CAAC;gBACF,IAAI,OAAsC,CAAC;gBAC3C,IAAI,GAAG,CAAC,kBAAkB;oBAAE,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;gBAClE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,QAAoB,CAAC;AAC9B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAwB,IAAU,EAAE,YAAoB,EAAQ,EAAE;IACvF,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,OAAO,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE;QAClB,IAAI,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7B,SAAS,GAAG,IAAI,CAAC;QACjB,OAAO,MAAM,CAAC;IAChB,CAAC,CAAS,CAAC;AACb,CAAC,CAAC"}

package/dist/esm/modules/common/modules/LocalStorage.d.ts

@@ -0,0 +1,8 @@
+export declare class LocalStorage {
+    private get storage();
+    store(key: string, value: unknown): void;
+    retrieve<Type>(key: string): Type;
+    delete(key: string): void;
+    retrieveAndDelete<Type>(key: string): Type;
+}
+//# sourceMappingURL=LocalStorage.d.ts.map

package/dist/esm/modules/common/modules/LocalStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalStorage.d.ts","sourceRoot":"","sources":["../../../../../modules/common/modules/LocalStorage.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IACvB,OAAO,KAAK,OAAO,GAElB;IACD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;IAIjC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAOjC,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAK3C"}

package/dist/esm/modules/common/modules/LocalStorage.js

@@ -0,0 +1,24 @@
+export class LocalStorage {
+    get storage() {
+        return window.localStorage;
+    }
+    store(key, value) {
+        this.storage.setItem(key, JSON.stringify(value));
+    }
+    retrieve(key) {
+        // May fail parsing and throw exception
+        const value = this.storage.getItem(key);
+        if (!value)
+            return null;
+        return JSON.parse(value);
+    }
+    delete(key) {
+        this.storage.removeItem(key);
+    }
+    retrieveAndDelete(key) {
+        const value = this.retrieve(key);
+        this.delete(key);
+        return value;
+    }
+}
+//# sourceMappingURL=LocalStorage.js.map

package/dist/esm/modules/common/modules/LocalStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalStorage.js","sourceRoot":"","sources":["../../../../../modules/common/modules/LocalStorage.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAY;IACvB,IAAY,OAAO;QACjB,OAAO,MAAM,CAAC,YAAY,CAAC;IAC7B,CAAC;IACD,KAAK,CAAC,GAAW,EAAE,KAAc;QAC/B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,QAAQ,CAAO,GAAW;QACxB,uCAAuC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,iBAAiB,CAAO,GAAW;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAO,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/esm/modules/common/modules/ReactiveStore.d.ts

@@ -0,0 +1,75 @@
+import { KeyOf, MaybeTuple } from "../../../types/index.js";
+import { BehaviorSubject } from "rxjs";
+import { Accessors, ReadonlyAccessors } from "../types/Accessors";
+type ChangeDetector<T> = (a: T, b: T) => boolean;
+/**
+ * PipeConfig<In, Out, RememberNum> is an options object that simplify the description of how to transform a value
+ * It is used across different methods of the class ReactiveStore to generate new values from existing values.
+ * Default values for each pipe option may be provided by the method taking PipeConfig as parameter.
+ *
+ * The pipe options are:
+ * - transformer: declare a transformation as a function that takes the old value (type In) and returns the new value (type Out)
+ * - changeDetector: defines how to detect changes between two Out values. This will usually default to the function "naiveObjectComparison".
+ * - emitArrayOfLatestValues: if this option is provided with a number greater than 1, instead of returning a single value of type Out the transformation will return the N latest values as a N-Tuple of Out
+ *
+ * The type MaybeTuple<Out, N> is used throughout this file to describe the two possibilities: Out, if N = 1 and N-Tuple of Out otherwise.
+ * Usually Accessors<T> type will be defined as Accessors<MaybeTuple<T, RememberNum>>, where the value of RememberNum is passed via PipeConfig
+ *
+ * keywords: PIPES, TRANSFORMATION, MAYBE-TUPLE, REMEMBER-NUM
+ */
+type PipeConfig<In, Out = In, RememberNum extends number = 1> = {
+    transformer?: (original: In) => Out;
+    changeDetector?: (a: Out, b: Out) => boolean;
+    emitArrayOfLatestValues?: RememberNum;
+};
+export declare class ReactiveStore<T extends object> extends BehaviorSubject<T> {
+    private changeDetector;
+    constructor(initial: T, changeDetector?: ChangeDetector<T>);
+    next(newData: T): void;
+    /**
+     * Generates accessors from a property of the root object provided in the constructor.
+     *
+     * For example:
+     *  Root contains object { prop: "prop-value" } as its value.
+     *  getRootAccessors("prop") will generate an accessor A whose value is the string "prop-value" and looks like this:
+     *  B: Accessor<string> = {
+     *      getValue: () => "prop-value",
+     *      setValue: (newValue: string) => void,
+     *      observable: RXJS.Observable<string>,
+     *      property: "prop"
+     *  }
+     * @param propertyName string the name one of the fields in the root object
+     * @returns Accessors<RootObject[PropertyName]>
+     */
+    getRootAccessors<P extends KeyOf<T>, RememberNum extends number = 1>(propertyName: P): Accessors<MaybeTuple<T[P], RememberNum>, T[P]>;
+    /**
+     * Generates accessors from a property of the object-value of the provided accessor.
+     *
+     * For example:
+     *  Accessor A contains object { prop: "prop-value" } as its value.
+     *  mkPropertyAccessor(A, { propertyName: "prop" }) will generate an accessor B whose value is the string "prop-value" and looks like this:
+     *  B: Accessor<string> = {
+     *      getValue: () => "prop-value",
+     *      setValue: (newValue: string) => void,
+     *      observable: RXJS.Observable<string>,
+     *      property: "prop"
+     *  }
+     * @param origin Accessors<Object> source accessors to take the property from
+     * @param pipes transformation options, where at least pipes.propertyName is required
+     * @returns Accessors<OriginType[PropertyName]>
+     */
+    static mkPropertyAccessors<OriginType extends object, P extends KeyOf<OriginType>, RemNum extends number = 1>(origin: Omit<Accessors<OriginType>, "toReadonly">, pipes: PipeConfig<OriginType, OriginType[P], RemNum> & {
+        propertyName: P;
+    }): Accessors<MaybeTuple<OriginType[P], RemNum>, OriginType[P]>;
+    /**
+     * Makes a Readonly accessors from an existing accessors object by transforming its internal value according to the `pipes` transformation options
+     * @param origin ReadOnlyAccessors<unknown> regular or readonly accessors to take the property from.
+     * @param pipes transformation options
+     * @returns ReadonlyAccessors
+     */
+    static mkComputedAccessors<OriginT, TransformedT = OriginT, RememberNum extends number = 1>(origin: ReadonlyAccessors<OriginT>, pipes?: PipeConfig<OriginT, TransformedT, RememberNum> & {
+        propertyName?: string;
+    }): ReadonlyAccessors<MaybeTuple<TransformedT, RememberNum>>;
+}
+export {};
+//# sourceMappingURL=ReactiveStore.d.ts.map

package/dist/esm/modules/common/modules/ReactiveStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactiveStore.d.ts","sourceRoot":"","sources":["../../../../../modules/common/modules/ReactiveStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAS,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,eAAe,EAAkE,MAAM,MAAM,CAAC;AACvG,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGlE,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,KAAK,UAAU,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,WAAW,SAAS,MAAM,GAAG,CAAC,IAAI;IAC9D,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,GAAG,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;IAC7C,uBAAuB,CAAC,EAAE,WAAW,CAAC;CACvC,CAAC;AAEF,qBAAa,aAAa,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,cAAc,CAAoB;gBAC9B,OAAO,EAAE,CAAC,EAAE,cAAc,GAAE,cAAc,CAAC,CAAC,CAAc;IAItE,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI;IAKtB;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,SAAS,MAAM,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;IAapF;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,mBAAmB,CAAC,UAAU,SAAS,MAAM,EAAE,CAAC,SAAS,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,SAAS,MAAM,GAAG,CAAC,EAC1G,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,EACjD,KAAK,EAAE,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG;QACrD,YAAY,EAAE,CAAC,CAAC;KACjB;IAsBH;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,EAAE,WAAW,SAAS,MAAM,GAAG,CAAC,EACxF,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAClC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,GAAG;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;CAuBrF"}

package/dist/esm/modules/common/modules/ReactiveStore.js

@@ -0,0 +1,159 @@
+import { BehaviorSubject, distinctUntilChanged, map, scan, shareReplay } from "rxjs";
+import { cloneValue, isNullish, naiveObjectComparison } from "./objectUtils.js";
+export class ReactiveStore extends BehaviorSubject {
+    constructor(initial, changeDetector = () => true) {
+        super(initial);
+        Object.defineProperty(this, "changeDetector", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.changeDetector = changeDetector !== null && changeDetector !== void 0 ? changeDetector : ((a, b) => !naiveObjectComparison(a, b));
+    }
+    next(newData) {
+        if (this.changeDetector(newData, this.getValue())) {
+            super.next(newData);
+        }
+    }
+    /**
+     * Generates accessors from a property of the root object provided in the constructor.
+     *
+     * For example:
+     *  Root contains object { prop: "prop-value" } as its value.
+     *  getRootAccessors("prop") will generate an accessor A whose value is the string "prop-value" and looks like this:
+     *  B: Accessor<string> = {
+     *      getValue: () => "prop-value",
+     *      setValue: (newValue: string) => void,
+     *      observable: RXJS.Observable<string>,
+     *      property: "prop"
+     *  }
+     * @param propertyName string the name one of the fields in the root object
+     * @returns Accessors<RootObject[PropertyName]>
+     */
+    getRootAccessors(propertyName) {
+        return ReactiveStore.mkPropertyAccessors({
+            property: "root-state",
+            getValue: () => this.getValue(),
+            setValue: (v) => this.next(v),
+            observable: this,
+        }, {
+            propertyName,
+        });
+    }
+    /**
+     * Generates accessors from a property of the object-value of the provided accessor.
+     *
+     * For example:
+     *  Accessor A contains object { prop: "prop-value" } as its value.
+     *  mkPropertyAccessor(A, { propertyName: "prop" }) will generate an accessor B whose value is the string "prop-value" and looks like this:
+     *  B: Accessor<string> = {
+     *      getValue: () => "prop-value",
+     *      setValue: (newValue: string) => void,
+     *      observable: RXJS.Observable<string>,
+     *      property: "prop"
+     *  }
+     * @param origin Accessors<Object> source accessors to take the property from
+     * @param pipes transformation options, where at least pipes.propertyName is required
+     * @returns Accessors<OriginType[PropertyName]>
+     */
+    static mkPropertyAccessors(origin, pipes) {
+        const { propertyName, changeDetector = naiveObjectComparison, emitArrayOfLatestValues = 1 } = pipes;
+        const readOnlyAccessors = ReactiveStore.mkComputedAccessors(origin, {
+            transformer: (original) => (isNullish(original) ? null : original[propertyName]),
+            changeDetector,
+            emitArrayOfLatestValues,
+            propertyName,
+        });
+        const setValue = (value) => {
+            const clonedValue = origin.getValue();
+            clonedValue[propertyName] = value;
+            origin.setValue(clonedValue);
+        };
+        return Object.assign(Object.assign({}, readOnlyAccessors), { setValue, toReadonly: () => readOnlyAccessors });
+    }
+    /**
+     * Makes a Readonly accessors from an existing accessors object by transforming its internal value according to the `pipes` transformation options
+     * @param origin ReadOnlyAccessors<unknown> regular or readonly accessors to take the property from.
+     * @param pipes transformation options
+     * @returns ReadonlyAccessors
+     */
+    static mkComputedAccessors(origin, pipes) {
+        var _a, _b, _c, _d;
+        const resolvedPipeConfig = {
+            propertyName: (_a = pipes === null || pipes === void 0 ? void 0 : pipes.propertyName) !== null && _a !== void 0 ? _a : `computed(${origin.property})`,
+            transformer: (_b = pipes === null || pipes === void 0 ? void 0 : pipes.transformer) !== null && _b !== void 0 ? _b : ((v) => v),
+            changeDetector: (_c = pipes === null || pipes === void 0 ? void 0 : pipes.changeDetector) !== null && _c !== void 0 ? _c : naiveObjectComparison,
+            emitArrayOfLatestValues: (_d = pipes === null || pipes === void 0 ? void 0 : pipes.emitArrayOfLatestValues) !== null && _d !== void 0 ? _d : 1,
+        };
+        const newSubject = mkSubjectFromAccessor(origin, resolvedPipeConfig);
+        const getValue = () => {
+            const retrievedValue = newSubject.getValue();
+            // non strict clone of the original value
+            // By making clone non strict it allows us to store things such as native Blob objects,
+            // but still reduce the number of mutable objects passed around
+            return cloneValue(retrievedValue);
+        };
+        return {
+            property: resolvedPipeConfig.propertyName,
+            getValue,
+            observable: newSubject,
+        };
+    }
+}
+// Helpers and heavy lifting
+/**
+ *
+ * @param origin Accessors or ReadonlyAccessors to create a RXJS.Subject from
+ * @param pipeConfig PipeConfig transformations to be piped on the new Subject
+ * @returns new RXJS.Subject
+ */
+const mkSubjectFromAccessor = (origin, pipeConfig) => {
+    /** Produce reactive transformed Observable **/
+    // Convert PipeConfig into array of RXJS Pipe Operators
+    const pipeOperators = mkPipeOperators(pipeConfig);
+    // Apply new Pipe Operators to the existing observable (taken from the origin Accessors)
+    // Generating a new Observable which reacts to changes to the origin by applying all the configured transformations
+    const transformedObservable = origin.observable.pipe(...pipeOperators);
+    /** Produce new Initial Value */
+    // Number of values to emit by the Subject
+    const valueLength = pipeConfig.emitArrayOfLatestValues;
+    // Generate a initial transformed value, by applying the transformation function to the current value
+    const mkInitialValue = () => pipeConfig.transformer(origin.getValue());
+    // Make an array of "valueLength" number of values where all elements are initialised as null,
+    // except the last element, which is initialised with the newly transformed value.
+    // That will cause the "history of N values" for this Subject to be all nulls except the most recent one.
+    const mkTupleInitialValue = () => {
+        const tupleOfValues = Array(valueLength).fill(null);
+        tupleOfValues[valueLength - 1] = mkInitialValue();
+        return tupleOfValues;
+    };
+    // Initial value will either be the latest transformed value or a N-Tuple of nulls ending in the latest transformed value
+    const initialValue = pipeConfig.emitArrayOfLatestValues > 1 ? mkTupleInitialValue() : mkInitialValue();
+    /** Bring transformed observable and initial value together into a new reactive Subject */
+    // Create a new Subject with the initial value defined above
+    const newSubject = new BehaviorSubject(initialValue);
+    // And subscribe it to the transformed observable created initially
+    // causing the subject to contain the new transformed initial value and also to react to any changes to the original value
+    transformedObservable.subscribe(newSubject);
+    return newSubject;
+};
+// Custom RXJS operator to get latest N values of an observable
+// TODO - extract this into rxjsOperators.ts
+const getLatest = (count) => {
+    return scan((acc, value) => {
+        acc.push(value);
+        return acc.splice(-count);
+    }, Array(count).fill(null));
+};
+const mkPipeOperators = (pipes) => {
+    const { transformer, changeDetector, emitArrayOfLatestValues } = pipes;
+    const pipeOperators = [];
+    pipeOperators.push(map(transformer), distinctUntilChanged(changeDetector));
+    if (emitArrayOfLatestValues > 1) {
+        pipeOperators.push(getLatest(emitArrayOfLatestValues));
+    }
+    pipeOperators.push(shareReplay(1));
+    return pipeOperators;
+};
+//# sourceMappingURL=ReactiveStore.js.map

package/dist/esm/modules/common/modules/ReactiveStore.js.map

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

package/dist/esm/modules/common/modules/UnpersistedModel.d.ts

@@ -0,0 +1,18 @@
+import { Clonable } from "./objectUtils";
+/**
+ * Wrap a model object with a temporary reference, while the model isn't persisted and receives a permanent "id" from the backend service
+ * This wrapper is also clonable, allowing it to be immutable across state changes
+ * @param model Original model
+ * @param ref Temporary reference to wrap model
+ * @returns The wrapped model with a new property "unpersisted" of type { ref: RefType, unwrap: () => OriginalModel }
+ */
+export declare function wrapUnpersistedModel<Type extends object, RefType>(model: Type, ref: RefType): UnpersistedModel<Type, RefType> & Clonable<Type>;
+export type UnpersistedModel<Type = unknown, RefType = number> = Type & {
+    unpersisted: {
+        ref: RefType;
+        unwrap: () => Type;
+    };
+};
+export declare const isUnpersistedModel: <ModelType>(m: UnpersistedModel<ModelType, unknown> | ModelType) => m is UnpersistedModel<ModelType, number>;
+export declare const nextNumericRef: <T>(list: (UnpersistedModel<T> | T)[]) => number;
+//# sourceMappingURL=UnpersistedModel.d.ts.map

package/dist/esm/modules/common/modules/UnpersistedModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnpersistedModel.d.ts","sourceRoot":"","sources":["../../../../../modules/common/modules/UnpersistedModel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAc,MAAM,eAAe,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,SAAS,MAAM,EAAE,OAAO,EAC/D,KAAK,EAAE,IAAI,EACX,GAAG,EAAE,OAAO,GACX,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAiBlD;AACD,MAAM,MAAM,gBAAgB,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM,IAAI,IAAI,GAAG;IACtE,WAAW,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;CACnD,CAAC;AAIF,eAAO,MAAM,kBAAkB,iBAC1B,iBAAiB,SAAS,EAAE,OAAO,CAAC,GAAG,SAAS,6CACgE,CAAC;AAEtH,eAAO,MAAM,cAAc,YAAa,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAG,MAIrE,CAAC"}

package/dist/esm/modules/common/modules/UnpersistedModel.js

@@ -0,0 +1,33 @@
+/* istanbul ignore file */
+import { isClonable } from "./objectUtils.js";
+/**
+ * Wrap a model object with a temporary reference, while the model isn't persisted and receives a permanent "id" from the backend service
+ * This wrapper is also clonable, allowing it to be immutable across state changes
+ * @param model Original model
+ * @param ref Temporary reference to wrap model
+ * @returns The wrapped model with a new property "unpersisted" of type { ref: RefType, unwrap: () => OriginalModel }
+ */
+export function wrapUnpersistedModel(model, ref) {
+    return new Proxy(model, {
+        get: (t, p) => {
+            if (p === "unpersisted") {
+                return {
+                    ref,
+                    unwrap: () => model,
+                };
+            }
+            if (p === "clone") {
+                const clone = isClonable(t) ? t.clone() : t;
+                return () => wrapUnpersistedModel(clone, ref);
+            }
+            return t[p];
+        },
+    });
+}
+export const isUnpersistedModel = (m) => Boolean(m.unpersisted);
+export const nextNumericRef = (list) => {
+    const allRefs = list.filter(isUnpersistedModel).map((d) => d.unpersisted.ref);
+    const nextRef = Math.max(0, Math.max(...allRefs)) + 1;
+    return nextRef;
+};
+//# sourceMappingURL=UnpersistedModel.js.map

package/dist/esm/modules/common/modules/UnpersistedModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnpersistedModel.js","sourceRoot":"","sources":["../../../../../modules/common/modules/UnpersistedModel.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,EAAY,UAAU,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAW,EACX,GAAY;IAEZ,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE;QACtB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACZ,IAAI,CAAC,KAAK,aAAa,EAAE,CAAC;gBACxB,OAAO;oBACL,GAAG;oBACH,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK;iBACpB,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;gBAClB,MAAM,KAAK,GAAG,UAAU,CAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClD,OAAO,GAAG,EAAE,CAAC,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAChD,CAAC;YAED,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;KACF,CAAqD,CAAC;AACzD,CAAC;AAOD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,CAAmD,EACiB,EAAE,CAAC,OAAO,CAAE,CAAsB,CAAC,WAAW,CAAC,CAAC;AAEtH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAI,IAAiC,EAAU,EAAE;IAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/esm/modules/common/modules/base64.d.ts

@@ -0,0 +1,3 @@
+export declare function stringToBase64(str: string): string;
+export declare function base64ToString(b64: string): string;
+//# sourceMappingURL=base64.d.ts.map

package/dist/esm/modules/common/modules/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../../../../modules/common/modules/base64.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AACD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/esm/modules/common/modules/base64.js

@@ -0,0 +1,9 @@
+import convertB64 from "base-64";
+import convertUTF from "utf8";
+export function stringToBase64(str) {
+    return convertB64.encode(convertUTF.encode(str));
+}
+export function base64ToString(b64) {
+    return convertUTF.decode(convertB64.decode(b64));
+}
+//# sourceMappingURL=base64.js.map

package/dist/esm/modules/common/modules/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../../../../modules/common/modules/base64.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,SAAS,CAAC;AACjC,OAAO,UAAU,MAAM,MAAM,CAAC;AAE9B,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/esm/modules/common/modules/defineModule.d.ts

@@ -0,0 +1,25 @@
+import type { BrandedInitialiseFunction, InjectedModuleParameters, ModuleDefinition, ModuleInitialiseFunction } from '../types';
+/**
+ * This simple function takes a module name and its initialise function and adds extra capabilities to it.
+ * - It enforces the type of the module's initialise function, as defined by the Module type definition.
+ * - It initialises and injects commonly created variables to reduce boilerplate:
+ * - - localEventHub: an eventHub used by the module to communicate with other modules and the host application
+ * - - - This event hub will also be used to decorate the context object with a event listener (methods on and off)
+ * @param name module name used as an object key for storage
+ * @param initialise the module's initialise function, which will be wrapped to inject the parameters above and which returned context object will be extended with a listener
+ * @returns the same module initialise function provided above
+ */
+export declare const defineModule: <M extends ModuleDefinition>(name: M['moduleName'], initialise: RawInitialise<M>) => BrandedInitialiseFunction<M>;
+/** RawInitialise type is used internally to provide type safety to the function provided to the defineModule function, before it's returned type is extended */
+export type RawInitialise<Module extends ModuleDefinition> = ModuleInitialiseFunction<Module['category'], Module['moduleContext'], Module['moduleOptions'], InjectedModuleParameters<Module['category'], Module['moduleEvents'], Module['recipeConfiguration']>>;
+/**
+ * This simple function takes a wrapper initialise function and returns it, simply enforcing types defined in the Module type definition
+ * @param initialise The wrapper's initialise function
+ * @returns The same wrapper initialise function provided above
+ */
+export declare const defineWrapper: <W extends ModuleDefinition>(name: W['vendorName'], initialise: W['wrapperInitialiseFunction']) => W["wrapperInitialiseFunction"] & {
+    vendorName: W["vendorName"];
+};
+export type WrapperParameters<W extends ModuleDefinition> = Parameters<W['wrapperInitialiseFunction']>;
+export type ModuleParameters<W extends ModuleDefinition> = Parameters<W['moduleInitialiseFunction']>;
+//# sourceMappingURL=defineModule.d.ts.map

package/dist/esm/modules/common/modules/defineModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineModule.d.ts","sourceRoot":"","sources":["../../../../../modules/common/modules/defineModule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAG9B;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,qCACjB,CAAC,CAAC,YAAY,CAAC,cACT,cAAc,CAAC,CAAC,KAC3B,0BAA0B,CAAC,CA0B7B,CAAC;AAEF,gKAAgK;AAChK,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,gBAAgB,IAAI,wBAAwB,CACnF,MAAM,CAAC,UAAU,CAAC,EAClB,MAAM,CAAC,eAAe,CAAC,EACvB,MAAM,CAAC,eAAe,CAAC,EACvB,wBAAwB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,qBAAqB,CAAC,CAAC,CACpG,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,qCAClB,CAAC,CAAC,YAAY,CAAC,cACT,CAAC,CAAC,2BAA2B,CAAC;;CACQ,CAAC;AAErD,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,IAAI,UAAU,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC;AACvG,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,IAAI,UAAU,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC"}

package/dist/esm/modules/common/modules/defineModule.js

@@ -0,0 +1,43 @@
+import { mkEventHub, mkEventListener } from '../index.js';
+import { brandInitialiseFunction } from '../types/index.js';
+/**
+ * This simple function takes a module name and its initialise function and adds extra capabilities to it.
+ * - It enforces the type of the module's initialise function, as defined by the Module type definition.
+ * - It initialises and injects commonly created variables to reduce boilerplate:
+ * - - localEventHub: an eventHub used by the module to communicate with other modules and the host application
+ * - - - This event hub will also be used to decorate the context object with a event listener (methods on and off)
+ * @param name module name used as an object key for storage
+ * @param initialise the module's initialise function, which will be wrapped to inject the parameters above and which returned context object will be extended with a listener
+ * @returns the same module initialise function provided above
+ */
+export const defineModule = (name, initialise) => {
+    // Inject new parameters and context to avoid needing to do that manually in each module every single time
+    // - eventHub (passed as localEventHub) is used by all modules to communicate with each other and with the host application
+    // - every module returns a context object containing a listener for its own local eventHub
+    // TODO: Create an extra eventhub "customerEventListener" where:
+    // - "localEventHub" pipes/maps events into "customerEventListener"
+    // - customerEventListener is not passed down to the module and is used only by the host application to listen to events piped into it
+    const injectedParameters = {
+        localEventHub: mkEventHub(),
+    };
+    const injectedContext = Object.assign({}, mkEventListener(injectedParameters.localEventHub));
+    // Wrap the provided initialise function with a new function which injects the parameters above
+    const wrappedInitialise = (globalState, options) => {
+        // Injecting parameters into shared, in case callers rely on the object reference (mainly tests)
+        const mainParameters = Object.assign(globalState, injectedParameters);
+        // Since we can't know the signature of the initialise function at this point, use the most generic signature when injecting parameters.
+        const context = initialise(mainParameters, options);
+        // Merge returned context with the injected context, which allows us to provide a listener wrapper automatically for all modules
+        // This means all modules will contain listener methods (on off), but not all categories will use them and therefore they are not part of the context's interface
+        return Object.assign(context, injectedContext);
+    };
+    const branded = brandInitialiseFunction(name, wrappedInitialise);
+    return branded;
+};
+/**
+ * This simple function takes a wrapper initialise function and returns it, simply enforcing types defined in the Module type definition
+ * @param initialise The wrapper's initialise function
+ * @returns The same wrapper initialise function provided above
+ */
+export const defineWrapper = (name, initialise) => Object.assign(initialise, { vendorName: name });
+//# sourceMappingURL=defineModule.js.map

package/dist/esm/modules/common/modules/defineModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineModule.js","sourceRoot":"","sources":["../../../../../modules/common/modules/defineModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQ7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,IAAqB,EACrB,UAA4B,EACE,EAAE;IAChC,0GAA0G;IAC1G,2HAA2H;IAC3H,2FAA2F;IAC3F,gEAAgE;IAChE,mEAAmE;IACnE,sIAAsI;IACtI,MAAM,kBAAkB,GAAG;QACzB,aAAa,EAAE,UAAU,EAAE;KAC5B,CAAC;IACF,MAAM,eAAe,qBAChB,eAAe,CAAC,kBAAkB,CAAC,aAAa,CAAC,CACrD,CAAC;IACF,+FAA+F;IAC/F,MAAM,iBAAiB,GAAG,CAAC,WAAmB,EAAE,OAAe,EAAE,EAAE;QACjE,gGAAgG;QAChG,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;QACtE,wIAAwI;QACxI,MAAM,OAAO,GAAI,UAA0C,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QACrF,gIAAgI;QAChI,iKAAiK;QACjK,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,uBAAuB,CAAI,IAAI,EAAE,iBAAkD,CAAC,CAAC;IACrG,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAUF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,IAAqB,EACrB,UAA0C,EAC1C,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC"}

package/dist/esm/modules/common/modules/env2url.d.ts

@@ -0,0 +1,16 @@
+export declare enum ENVIRONMENTS {
+    development = "development",
+    local = "local",
+    production = "production",
+    uat = "uat",
+    demo = "demo",
+    qa = "qa",
+    staging = "staging",
+    staging2 = "staging2",
+    staging3 = "staging3",
+    staging4 = "staging4",
+    staging5 = "staging5",
+    staging6 = "staging6"
+}
+export declare const env2url: (env: ENVIRONMENTS) => string;
+//# sourceMappingURL=env2url.d.ts.map

package/dist/esm/modules/common/modules/env2url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env2url.d.ts","sourceRoot":"","sources":["../../../../../modules/common/modules/env2url.ts"],"names":[],"mappings":"AAAA,oBAAY,YAAY;IACtB,WAAW,gBAAgB;IAC3B,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,EAAE,OAAO;IACT,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,QAAQ,aAAa;CACtB;AACD,eAAO,MAAM,OAAO,QAAS,YAAY,WAgCxC,CAAC"}

package/dist/esm/modules/common/modules/env2url.js

@@ -0,0 +1,49 @@
+export var ENVIRONMENTS;
+(function (ENVIRONMENTS) {
+    ENVIRONMENTS["development"] = "development";
+    ENVIRONMENTS["local"] = "local";
+    ENVIRONMENTS["production"] = "production";
+    ENVIRONMENTS["uat"] = "uat";
+    ENVIRONMENTS["demo"] = "demo";
+    ENVIRONMENTS["qa"] = "qa";
+    ENVIRONMENTS["staging"] = "staging";
+    ENVIRONMENTS["staging2"] = "staging2";
+    ENVIRONMENTS["staging3"] = "staging3";
+    ENVIRONMENTS["staging4"] = "staging4";
+    ENVIRONMENTS["staging5"] = "staging5";
+    ENVIRONMENTS["staging6"] = "staging6";
+})(ENVIRONMENTS || (ENVIRONMENTS = {}));
+export const env2url = (env) => {
+    switch (env.toLowerCase()) {
+        case "latest":
+        case "development":
+        case "dev":
+            return "https://backend.latest.frankiefinancial.io";
+        case "staging":
+            return "https://backend.staging.latest.frankiefinancial.io";
+        case "staging2":
+            return "https://backend.staging2.latest.frankiefinancial.io";
+        case "staging3":
+            return "https://backend.staging3.latest.frankiefinancial.io";
+        case "staging4":
+            return "https://backend.staging4.latest.frankiefinancial.io";
+        case "staging5":
+            return "https://backend.staging5.latest.frankiefinancial.io";
+        case "staging6":
+            return "https://backend.staging6.latest.frankiefinancial.io";
+        case "qa":
+            return "https://backend.qa.frankiefinancial.io";
+        case "demo":
+            return "https://backend.demo.frankiefinancial.io";
+        case "uat":
+            return "https://backend.kycaml.uat.frankiefinancial.io";
+        case "prod":
+        case "production":
+            return `https://backend.kycaml.frankiefinancial.io`;
+        case "local":
+            return process.env.PUBLIC_LOCAL_BFF_HOST;
+        default:
+            return `https://backend.${env}.latest.frankiefinancial.io`;
+    }
+};
+//# sourceMappingURL=env2url.js.map

package/dist/esm/modules/common/modules/env2url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env2url.js","sourceRoot":"","sources":["../../../../../modules/common/modules/env2url.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,YAaX;AAbD,WAAY,YAAY;IACtB,2CAA2B,CAAA;IAC3B,+BAAe,CAAA;IACf,yCAAyB,CAAA;IACzB,2BAAW,CAAA;IACX,6BAAa,CAAA;IACb,yBAAS,CAAA;IACT,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;AACvB,CAAC,EAbW,YAAY,KAAZ,YAAY,QAavB;AACD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAiB,EAAE,EAAE;IAC3C,QAAQ,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1B,KAAK,QAAQ,CAAC;QACd,KAAK,aAAa,CAAC;QACnB,KAAK,KAAK;YACR,OAAO,4CAA4C,CAAC;QACtD,KAAK,SAAS;YACZ,OAAO,oDAAoD,CAAC;QAC9D,KAAK,UAAU;YACb,OAAO,qDAAqD,CAAC;QAC/D,KAAK,UAAU;YACb,OAAO,qDAAqD,CAAC;QAC/D,KAAK,UAAU;YACb,OAAO,qDAAqD,CAAC;QAC/D,KAAK,UAAU;YACb,OAAO,qDAAqD,CAAC;QAC/D,KAAK,UAAU;YACb,OAAO,qDAAqD,CAAC;QAC/D,KAAK,IAAI;YACP,OAAO,wCAAwC,CAAC;QAClD,KAAK,MAAM;YACT,OAAO,0CAA0C,CAAC;QACpD,KAAK,KAAK;YACR,OAAO,gDAAgD,CAAC;QAC1D,KAAK,MAAM,CAAC;QACZ,KAAK,YAAY;YACf,OAAO,4CAA4C,CAAC;QACtD,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;QAC3C;YACE,OAAO,mBAAmB,GAAG,6BAA6B,CAAC;IAC/D,CAAC;AACH,CAAC,CAAC"}

package/dist/esm/modules/common/modules/error.d.ts

@@ -0,0 +1,4 @@
+import { GlobalEvents } from '../../sdk/types';
+import { EventHub } from './eventHub';
+export declare const mkErrorEmitter: (globalEventHub: EventHub<GlobalEvents>, options: unknown) => (message: string) => never;
+//# sourceMappingURL=error.d.ts.map

package/dist/esm/modules/common/modules/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../../../modules/common/modules/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,cAAc,mBAAoB,SAAS,YAAY,CAAC,WAAW,OAAO,eAAe,MAAM,UAG3G,CAAC"}

package/dist/esm/modules/common/modules/error.js

@@ -0,0 +1,6 @@
+import { OneSDKError } from '../errors/OneSDKError.class.js';
+export const mkErrorEmitter = (globalEventHub, options) => (message) => {
+    globalEventHub.emit('error', new OneSDKError(`${message}. Look for 'payload' in this event object.`, options));
+    throw new Error(message);
+};
+//# sourceMappingURL=error.js.map