npm - @monterosa/sdk-storage-kit - Versions diffs - 0.18.7 → 0.18.8 - Mend

@monterosa/sdk-storage-kit 0.18.7 → 0.18.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/index.cjs.js CHANGED Viewed

@@ -106,6 +106,10 @@ exports.StorageError = void 0;
      * Indicates an error occurred in the parent app.
      */
     StorageError["ParentAppError"] = "parent_app_error";
+    /**
+     * Indicates a timeout occurred when communicating with the parent app.
+     */
+    StorageError["ParentTimeoutError"] = "parent_timeout_error";
     /**
      * Indicates an error occurred when reading from the storage.
      */
@@ -130,10 +134,15 @@ var StorageErrorMessages = (_a = {},
     _a[exports.StorageError.ParentAppError] = function (error) {
         return "Parent application error: " + error;
     },
-    _a[exports.StorageError.ReadError] = function (error) { return "Read error: " + error; },
-    _a[exports.StorageError.WriteError] = function (error) { return "Write error: " + error; },
-    _a[exports.StorageError.RemoveError] = function (error) { return "Remove error: " + error; },
-    _a[exports.StorageError.ClearError] = function (error) { return "Clear error: " + error; },
+    _a[exports.StorageError.ParentTimeoutError] = function (error) {
+        return "Parent application timeout: " + error + ". Please check if the storage-kit is imported on the parent page.";
+    },
+    _a[exports.StorageError.ReadError] = function (error) { return "Storage read error: " + error; },
+    _a[exports.StorageError.WriteError] = function (error) { return "Storage write error: " + error; },
+    _a[exports.StorageError.RemoveError] = function (error) {
+        return "Storage remove error: " + error;
+    },
+    _a[exports.StorageError.ClearError] = function (error) { return "Storage clear error: " + error; },
     _a);
 /**
@@ -266,10 +275,12 @@ function listenStorageMessages(experience) {
 }
 function parentAppRequest(parentApp, action, payload) {
     return __awaiter(this, void 0, void 0, function () {
-        var response, _a, value, error;
+        var response, _a, value, error, err_1, errorMessage;
         return __generator(this, function (_b) {
             switch (_b.label) {
-                case 0: return [4 /*yield*/, sdkLauncherKit.sendSdkRequest(parentApp, action, payload)];
+                case 0:
+                    _b.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, sdkLauncherKit.sendSdkRequest(parentApp, action, payload)];
                 case 1:
                     response = _b.sent();
                     _a = response.payload, value = _a.value, error = _a.error;
@@ -277,6 +288,15 @@ function parentAppRequest(parentApp, action, payload) {
                         throw sdkUtil.createError(exports.StorageError.ParentAppError, StorageErrorMessages, error);
                     }
                     return [2 /*return*/, value];
+                case 2:
+                    err_1 = _b.sent();
+                    if (err_1 instanceof sdkUtil.MonterosaError &&
+                        err_1.code === sdkLauncherKit.BridgeError.RequestTimeoutError) {
+                        errorMessage = sdkUtil.getErrorMessage(err_1);
+                        throw sdkUtil.createError(exports.StorageError.ParentTimeoutError, StorageErrorMessages, errorMessage);
+                    }
+                    throw err_1;
+                case 3: return [2 /*return*/];
             }
         });
     });
@@ -321,7 +341,7 @@ function setStoragePersistent(persistent) {
  */
 function storageRead(key) {
     return __awaiter(this, void 0, void 0, function () {
-        var parentApp, value, err_1, errorMessage;
+        var parentApp, value, err_2, errorMessage;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -342,9 +362,9 @@ function storageRead(key) {
                     _a.label = 4;
                 case 4: return [3 /*break*/, 6];
                 case 5:
-                    err_1 = _a.sent();
-                    errorMessage = sdkUtil.getErrorMessage(err_1);
-                    console.error("Unable to read storage item " + key + " with error: " + errorMessage);
+                    err_2 = _a.sent();
+                    errorMessage = sdkUtil.getErrorMessage(err_2);
+                    console.error("Unable to read storage item \"" + key + "\" with error: " + errorMessage);
                     throw sdkUtil.createError(exports.StorageError.ReadError, StorageErrorMessages, errorMessage);
                 case 6: return [2 /*return*/, value];
             }
@@ -366,7 +386,7 @@ function storageRead(key) {
  */
 function storageWrite(key, value) {
     return __awaiter(this, void 0, void 0, function () {
-        var parentApp, err_2, errorMessage;
+        var parentApp, err_3, errorMessage;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -387,9 +407,9 @@ function storageWrite(key, value) {
                     _a.label = 4;
                 case 4: return [3 /*break*/, 6];
                 case 5:
-                    err_2 = _a.sent();
-                    errorMessage = sdkUtil.getErrorMessage(err_2);
-                    console.error("Unable to write storage item " + key + " with error: " + errorMessage);
+                    err_3 = _a.sent();
+                    errorMessage = sdkUtil.getErrorMessage(err_3);
+                    console.error("Unable to write storage item \"" + key + "\" with error: " + errorMessage);
                     throw sdkUtil.createError(exports.StorageError.WriteError, StorageErrorMessages, errorMessage);
                 case 6: return [2 /*return*/];
             }
@@ -410,7 +430,7 @@ function storageWrite(key, value) {
  */
 function storageRemove(key) {
     return __awaiter(this, void 0, void 0, function () {
-        var parentApp, err_3, errorMessage;
+        var parentApp, err_4, errorMessage;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -428,9 +448,9 @@ function storageRemove(key) {
                     _a.label = 4;
                 case 4: return [3 /*break*/, 6];
                 case 5:
-                    err_3 = _a.sent();
-                    errorMessage = sdkUtil.getErrorMessage(err_3);
-                    console.error("Unable to remove storage item " + key + " with error: " + errorMessage);
+                    err_4 = _a.sent();
+                    errorMessage = sdkUtil.getErrorMessage(err_4);
+                    console.error("Unable to remove storage item \"" + key + "\" with error: " + errorMessage);
                     throw sdkUtil.createError(exports.StorageError.RemoveError, StorageErrorMessages, errorMessage);
                 case 6: return [2 /*return*/];
             }
@@ -449,7 +469,7 @@ function storageRemove(key) {
  */
 function storageClear() {
     return __awaiter(this, void 0, void 0, function () {
-        var parentApp, err_4, errorMessage;
+        var parentApp, err_5, errorMessage;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -467,8 +487,8 @@ function storageClear() {
                     _a.label = 4;
                 case 4: return [3 /*break*/, 6];
                 case 5:
-                    err_4 = _a.sent();
-                    errorMessage = sdkUtil.getErrorMessage(err_4);
+                    err_5 = _a.sent();
+                    errorMessage = sdkUtil.getErrorMessage(err_5);
                     console.error("Unable to clear storage with error: " + errorMessage);
                     throw sdkUtil.createError(exports.StorageError.ClearError, StorageErrorMessages, errorMessage);
                 case 6: return [2 /*return*/];

package/dist/index.cjs.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.cjs.js","sources":["../src/types.ts","../src/storage_impl.ts","../src/api.ts"],"sourcesContent":["/*\n @license\n * types.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nexport enum StorageAction {\n Read = 'storageRead',\n Write = 'storageWrite',\n Remove = 'storageRemove',\n Clear = 'storageClear',\n}\n\nexport type ResponsePayload = {\n key: string;\n value?: string \| null;\n error?: string;\n};\n\n/\n Defines a set of error codes that may be encountered when using the\n * Storage kit of the Monterosa SDK.\n \n @example\n * ```javascript\n * try {\n * // some code that uses the StorageKit\n * } catch (err) {\n * if (err.code === StorageError.ParentApp) {\n * // handle parent app error\n * } else {\n * // handle other error types\n * }\n * }\n * ```\n \n @remarks\n * - The `StorageError` enum provides a convenient way to handle errors\n * encountered when using the `StorageKit` module. By checking the code\n * property of the caught error against the values of the enum, the error\n * type can be determined and appropriate action taken.\n \n - The `StorageError` enum is not intended to be instantiated or extended.\n /\nexport enum StorageError {\n /\n Indicates an error occurred in the parent app.\n /\n ParentAppError = 'parent_app_error',\n /\n Indicates an error occurred when reading from the storage.\n /\n ReadError = 'read_error',\n /\n Indicates an error occurred when writing to the storage.\n /\n WriteError = 'write_error',\n /\n Indicates an error occurred when removing from the storage.\n /\n RemoveError = 'remove_error',\n /\n Indicates an error occurred when clearing the storage.\n /\n ClearError = 'clear_error',\n}\n\n/\n @internal\n /\nexport const StorageErrorMessages = {\n [StorageError.ParentAppError]: (error: string) =>\n `Parent application error: ${error}`,\n [StorageError.ReadError]: (error: string) => `Read error: ${error}`,\n [StorageError.WriteError]: (error: string) => `Write error: ${error}`,\n [StorageError.RemoveError]: (error: string) => `Remove error: ${error}`,\n [StorageError.ClearError]: (error: string) => `Clear error: ${error}`,\n};\n","/\n @license\n * storage_impl.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport {\n checkAvailability,\n getItem,\n setItem,\n removeItem,\n clear,\n} from '@monterosa/sdk-util';\n\nexport class StorageImpl {\n private memoryStore: { [key: string]: string } = {};\n private accessible: boolean = checkAvailability();\n private _persistent: boolean = true;\n\n set persistent(newValue: boolean) {\n const oldValue = this._persistent;\n\n if (oldValue === newValue) {\n return;\n }\n\n const swapToStorage = newValue === true && this.accessible;\n const swapToMemory = newValue === false && this.accessible;\n\n if (swapToStorage) {\n for (const [key, value] of Object.entries(this.memoryStore)) {\n setItem(key, value);\n }\n }\n\n if (swapToMemory) {\n clear();\n }\n\n this._persistent = newValue;\n }\n\n get persistent(): boolean {\n return this._persistent;\n }\n\n getItem(key: string): string \| null {\n if (this.persistent && this.accessible) {\n return getItem(key);\n }\n\n if (Object.prototype.hasOwnProperty.call(this.memoryStore, key)) {\n return this.memoryStore[key];\n }\n\n return null;\n }\n\n setItem(key: string, value: string): void {\n if (this.persistent && this.accessible) {\n setItem(key, value);\n }\n\n this.memoryStore[key] = value;\n }\n\n removeItem(key: string): void {\n if (this.persistent && this.accessible) {\n removeItem(key);\n }\n\n delete this.memoryStore[key];\n }\n\n clear(): void {\n if (this.persistent && this.accessible) {\n clear();\n }\n\n this.memoryStore = {};\n }\n}\n","/\n @license\n * api.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport { Unsubscribe, createError, getErrorMessage } from '@monterosa/sdk-util';\nimport {\n Experience,\n Payload,\n ParentApplication,\n registerEmbedHook,\n getParentApplication,\n sendSdkRequest,\n respondToSdkMessage,\n onSdkMessage,\n} from '@monterosa/sdk-launcher-kit';\n\nimport {\n StorageAction,\n ResponsePayload,\n StorageError,\n StorageErrorMessages,\n} from './types';\nimport { StorageImpl } from './storage_impl';\n\n/\n @internal\n /\nexport const storage = new StorageImpl();\n\n/\n @internal\n /\nexport function listenStorageMessages(experience: Experience): Unsubscribe {\n return onSdkMessage(experience, (message) => {\n if (\n !Object.values(StorageAction).includes(message.action as StorageAction)\n ) {\n return;\n }\n\n try {\n let payload: Payload = {};\n\n switch (message.action) {\n case StorageAction.Read:\n payload = {\n key: message.payload.key,\n value: storage.getItem(message.payload.key),\n };\n break;\n case StorageAction.Write:\n payload = {\n key: message.payload.key,\n };\n storage.setItem(message.payload.key, message.payload.value);\n break;\n case StorageAction.Remove:\n payload = {\n key: message.payload.key,\n };\n storage.removeItem(message.payload.key);\n break;\n case StorageAction.Clear:\n storage.clear();\n break;\n }\n\n respondToSdkMessage(experience, message, payload);\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to handle storage message ${message.action} with error: ${errorMessage}`,\n );\n\n respondToSdkMessage(experience, message, {\n key: message.payload.key,\n error: errorMessage,\n });\n }\n });\n}\n\n/\n @internal\n /\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Read,\n payload?: Payload,\n): Promise<string \| null>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Write \| StorageAction.Remove \| StorageAction.Clear,\n payload?: Payload,\n): Promise<undefined>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction,\n payload?: Payload,\n): Promise<string \| null \| undefined> {\n const response = await sendSdkRequest(parentApp, action, payload);\n\n const { value, error } = response.payload as ResponsePayload;\n\n if (error !== undefined) {\n throw createError(StorageError.ParentAppError, StorageErrorMessages, error);\n }\n\n return value;\n}\n\n/\n The `setStoragePersistent` function is a simple function that allows to\n * control the persistence of the SDK storage. If the argument `persistent` is\n * set to `true`, then the storage will be persistent across browser sessions\n * and if it is set to `false`, then the storage will save to memory.\n * It is important to note that the use of persistent storage may be subject\n * to laws and regulations, such as those related to data privacy and protection.\n \n @remarks\n * - We transition from persistent to memory and memory to persistent in\n * a seamless manner for you\n \n - By default we store in memory\n \n - The value of storage persistent persists across session (aka put it to true,\n * it will remain so, put it back to false, it will remain so)\n \n - You have the responsibility to comply with any laws and regulations, and\n * store only the data if you know it's valid to do so\n \n @param persistent - Determines whether or not SDK storage should persist\n * across browser sessions.\n /\nexport function setStoragePersistent(persistent: boolean): void {\n storage.persistent = persistent;\n}\n\n/\n The function allows to read data from the SDK storage.\n \n @param key - The name of the item to be read from storage.\n \n @throws\n * The function throws an error if there is a timeout reading the data\n * from the parent application storage.\n \n @returns A promise that resolves to the value\n * of the item in storage or `null` if the item doesn't exist.\n /\nexport async function storageRead(key: string): Promise<string \| null> {\n const parentApp = getParentApplication();\n\n let value: string \| null = null;\n\n try {\n if (parentApp !== null) {\n value = await parentAppRequest(parentApp, StorageAction.Read, {\n key,\n });\n } else {\n value = storage.getItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to read storage item ${key} with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.ReadError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n\n return value;\n}\n\n/\n The function allows to write data to the SDK storage.\n \n @param key - A name of the item to be stored.\n * @param value - A value to be stored.\n \n @throws\n * The function throws an error if there is a timeout writing the data\n * to the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully stored.\n /\nexport async function storageWrite(key: string, value: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Write, {\n key,\n value,\n });\n } else {\n storage.setItem(key, value);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to write storage item ${key} with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.WriteError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to remove an item from the SDK storage.\n \n @param key - A name of the item to be removed.\n \n @throws\n * The function throws an error if there is a timeout removing the data\n * from the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully removed.\n /\nexport async function storageRemove(key: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Remove, { key });\n } else {\n storage.removeItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to remove storage item ${key} with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.RemoveError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to clear all data from the SDK storage.\n \n @throws\n * The function throws an error if there is a timeout clearing the parent's\n * application storage.\n \n @returns A promise that resolves to `void` once the data has been\n * successfully cleared.\n */\nexport async function storageClear(): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Clear);\n } else {\n storage.clear();\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(`Unable to clear storage with error: ${errorMessage}`);\n\n throw createError(\n StorageError.ClearError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\nregisterEmbedHook(listenStorageMessages);\n"],"names":["StorageError","checkAvailability","setItem","clear","getItem","removeItem","onSdkMessage","respondToSdkMessage","getErrorMessage","sendSdkRequest","createError","getParentApplication","registerEmbedHook"],"mappings":"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"}
1	+ {"version":3,"file":"index.cjs.js","sources":["../src/types.ts","../src/storage_impl.ts","../src/api.ts"],"sourcesContent":["/*\n @license\n * types.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nexport enum StorageAction {\n Read = 'storageRead',\n Write = 'storageWrite',\n Remove = 'storageRemove',\n Clear = 'storageClear',\n}\n\nexport type ResponsePayload = {\n key: string;\n value?: string \| null;\n error?: string;\n};\n\n/\n Defines a set of error codes that may be encountered when using the\n * Storage kit of the Monterosa SDK.\n \n @example\n * ```javascript\n * try {\n * // some code that uses the StorageKit\n * } catch (err) {\n * if (err.code === StorageError.ParentApp) {\n * // handle parent app error\n * } else {\n * // handle other error types\n * }\n * }\n * ```\n \n @remarks\n * - The `StorageError` enum provides a convenient way to handle errors\n * encountered when using the `StorageKit` module. By checking the code\n * property of the caught error against the values of the enum, the error\n * type can be determined and appropriate action taken.\n \n - The `StorageError` enum is not intended to be instantiated or extended.\n /\nexport enum StorageError {\n /\n Indicates an error occurred in the parent app.\n /\n ParentAppError = 'parent_app_error',\n /\n Indicates a timeout occurred when communicating with the parent app.\n /\n ParentTimeoutError = 'parent_timeout_error',\n /\n Indicates an error occurred when reading from the storage.\n /\n ReadError = 'read_error',\n /\n Indicates an error occurred when writing to the storage.\n /\n WriteError = 'write_error',\n /\n Indicates an error occurred when removing from the storage.\n /\n RemoveError = 'remove_error',\n /\n Indicates an error occurred when clearing the storage.\n /\n ClearError = 'clear_error',\n}\n\n/\n @internal\n /\nexport const StorageErrorMessages = {\n [StorageError.ParentAppError]: (error: string) =>\n `Parent application error: ${error}`,\n [StorageError.ParentTimeoutError]: (error: string) =>\n `Parent application timeout: ${error}. Please check if the storage-kit is imported on the parent page.`,\n [StorageError.ReadError]: (error: string) => `Storage read error: ${error}`,\n [StorageError.WriteError]: (error: string) => `Storage write error: ${error}`,\n [StorageError.RemoveError]: (error: string) =>\n `Storage remove error: ${error}`,\n [StorageError.ClearError]: (error: string) => `Storage clear error: ${error}`,\n};\n","/\n @license\n * storage_impl.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport {\n checkAvailability,\n getItem,\n setItem,\n removeItem,\n clear,\n} from '@monterosa/sdk-util';\n\nexport class StorageImpl {\n private memoryStore: { [key: string]: string } = {};\n private accessible: boolean = checkAvailability();\n private _persistent: boolean = true;\n\n set persistent(newValue: boolean) {\n const oldValue = this._persistent;\n\n if (oldValue === newValue) {\n return;\n }\n\n const swapToStorage = newValue === true && this.accessible;\n const swapToMemory = newValue === false && this.accessible;\n\n if (swapToStorage) {\n for (const [key, value] of Object.entries(this.memoryStore)) {\n setItem(key, value);\n }\n }\n\n if (swapToMemory) {\n clear();\n }\n\n this._persistent = newValue;\n }\n\n get persistent(): boolean {\n return this._persistent;\n }\n\n getItem(key: string): string \| null {\n if (this.persistent && this.accessible) {\n return getItem(key);\n }\n\n if (Object.prototype.hasOwnProperty.call(this.memoryStore, key)) {\n return this.memoryStore[key];\n }\n\n return null;\n }\n\n setItem(key: string, value: string): void {\n if (this.persistent && this.accessible) {\n setItem(key, value);\n }\n\n this.memoryStore[key] = value;\n }\n\n removeItem(key: string): void {\n if (this.persistent && this.accessible) {\n removeItem(key);\n }\n\n delete this.memoryStore[key];\n }\n\n clear(): void {\n if (this.persistent && this.accessible) {\n clear();\n }\n\n this.memoryStore = {};\n }\n}\n","/\n @license\n * api.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport {\n MonterosaError,\n Unsubscribe,\n createError,\n getErrorMessage,\n} from '@monterosa/sdk-util';\nimport {\n Experience,\n Payload,\n ParentApplication,\n registerEmbedHook,\n getParentApplication,\n sendSdkRequest,\n respondToSdkMessage,\n onSdkMessage,\n BridgeError,\n} from '@monterosa/sdk-launcher-kit';\n\nimport {\n StorageAction,\n ResponsePayload,\n StorageError,\n StorageErrorMessages,\n} from './types';\nimport { StorageImpl } from './storage_impl';\n\n/\n @internal\n /\nexport const storage = new StorageImpl();\n\n/\n @internal\n /\nexport function listenStorageMessages(experience: Experience): Unsubscribe {\n return onSdkMessage(experience, (message) => {\n if (\n !Object.values(StorageAction).includes(message.action as StorageAction)\n ) {\n return;\n }\n\n try {\n let payload: Payload = {};\n\n switch (message.action) {\n case StorageAction.Read:\n payload = {\n key: message.payload.key,\n value: storage.getItem(message.payload.key),\n };\n break;\n case StorageAction.Write:\n payload = {\n key: message.payload.key,\n };\n storage.setItem(message.payload.key, message.payload.value);\n break;\n case StorageAction.Remove:\n payload = {\n key: message.payload.key,\n };\n storage.removeItem(message.payload.key);\n break;\n case StorageAction.Clear:\n storage.clear();\n break;\n }\n\n respondToSdkMessage(experience, message, payload);\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to handle storage message ${message.action} with error: ${errorMessage}`,\n );\n\n respondToSdkMessage(experience, message, {\n key: message.payload.key,\n error: errorMessage,\n });\n }\n });\n}\n\n/\n @internal\n /\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Read,\n payload?: Payload,\n): Promise<string \| null>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Write \| StorageAction.Remove \| StorageAction.Clear,\n payload?: Payload,\n): Promise<undefined>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction,\n payload?: Payload,\n): Promise<string \| null \| undefined> {\n try {\n const response = await sendSdkRequest(parentApp, action, payload);\n\n const { value, error } = response.payload as ResponsePayload;\n\n if (error !== undefined) {\n throw createError(\n StorageError.ParentAppError,\n StorageErrorMessages,\n error,\n );\n }\n\n return value;\n } catch (err) {\n if (\n err instanceof MonterosaError &&\n err.code === BridgeError.RequestTimeoutError\n ) {\n const errorMessage = getErrorMessage(err);\n\n throw createError(\n StorageError.ParentTimeoutError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n\n throw err;\n }\n}\n\n/\n The `setStoragePersistent` function is a simple function that allows to\n * control the persistence of the SDK storage. If the argument `persistent` is\n * set to `true`, then the storage will be persistent across browser sessions\n * and if it is set to `false`, then the storage will save to memory.\n * It is important to note that the use of persistent storage may be subject\n * to laws and regulations, such as those related to data privacy and protection.\n \n @remarks\n * - We transition from persistent to memory and memory to persistent in\n * a seamless manner for you\n \n - By default we store in memory\n \n - The value of storage persistent persists across session (aka put it to true,\n * it will remain so, put it back to false, it will remain so)\n \n - You have the responsibility to comply with any laws and regulations, and\n * store only the data if you know it's valid to do so\n \n @param persistent - Determines whether or not SDK storage should persist\n * across browser sessions.\n /\nexport function setStoragePersistent(persistent: boolean): void {\n storage.persistent = persistent;\n}\n\n/\n The function allows to read data from the SDK storage.\n \n @param key - The name of the item to be read from storage.\n \n @throws\n * The function throws an error if there is a timeout reading the data\n * from the parent application storage.\n \n @returns A promise that resolves to the value\n * of the item in storage or `null` if the item doesn't exist.\n /\nexport async function storageRead(key: string): Promise<string \| null> {\n const parentApp = getParentApplication();\n\n let value: string \| null = null;\n\n try {\n if (parentApp !== null) {\n value = await parentAppRequest(parentApp, StorageAction.Read, {\n key,\n });\n } else {\n value = storage.getItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to read storage item \"${key}\" with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.ReadError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n\n return value;\n}\n\n/\n The function allows to write data to the SDK storage.\n \n @param key - A name of the item to be stored.\n * @param value - A value to be stored.\n \n @throws\n * The function throws an error if there is a timeout writing the data\n * to the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully stored.\n /\nexport async function storageWrite(key: string, value: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Write, {\n key,\n value,\n });\n } else {\n storage.setItem(key, value);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to write storage item \"${key}\" with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.WriteError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to remove an item from the SDK storage.\n \n @param key - A name of the item to be removed.\n \n @throws\n * The function throws an error if there is a timeout removing the data\n * from the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully removed.\n /\nexport async function storageRemove(key: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Remove, { key });\n } else {\n storage.removeItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to remove storage item \"${key}\" with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.RemoveError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to clear all data from the SDK storage.\n \n @throws\n * The function throws an error if there is a timeout clearing the parent's\n * application storage.\n \n @returns A promise that resolves to `void` once the data has been\n * successfully cleared.\n */\nexport async function storageClear(): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Clear);\n } else {\n storage.clear();\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(`Unable to clear storage with error: ${errorMessage}`);\n\n throw createError(\n StorageError.ClearError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\nregisterEmbedHook(listenStorageMessages);\n"],"names":["StorageError","checkAvailability","setItem","clear","getItem","removeItem","onSdkMessage","respondToSdkMessage","getErrorMessage","sendSdkRequest","createError","MonterosaError","BridgeError","getParentApplication","registerEmbedHook"],"mappings":"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"}

package/dist/index.esm2017.js CHANGED Viewed

@@ -1,5 +1,5 @@
-import { checkAvailability, setItem, clear, getItem, removeItem, getErrorMessage, createError } from '@monterosa/sdk-util';
-import { registerEmbedHook, onSdkMessage, respondToSdkMessage, sendSdkRequest, getParentApplication } from '@monterosa/sdk-launcher-kit';
+import { checkAvailability, setItem, clear, getItem, removeItem, getErrorMessage, createError, MonterosaError } from '@monterosa/sdk-util';
+import { registerEmbedHook, onSdkMessage, respondToSdkMessage, sendSdkRequest, BridgeError, getParentApplication } from '@monterosa/sdk-launcher-kit';
 /**
  * @license
@@ -48,6 +48,10 @@ var StorageError;
      * Indicates an error occurred in the parent app.
      */
     StorageError["ParentAppError"] = "parent_app_error";
+    /**
+     * Indicates a timeout occurred when communicating with the parent app.
+     */
+    StorageError["ParentTimeoutError"] = "parent_timeout_error";
     /**
      * Indicates an error occurred when reading from the storage.
      */
@@ -70,10 +74,11 @@ var StorageError;
  */
 const StorageErrorMessages = {
     [StorageError.ParentAppError]: (error) => `Parent application error: ${error}`,
-    [StorageError.ReadError]: (error) => `Read error: ${error}`,
-    [StorageError.WriteError]: (error) => `Write error: ${error}`,
-    [StorageError.RemoveError]: (error) => `Remove error: ${error}`,
-    [StorageError.ClearError]: (error) => `Clear error: ${error}`,
+    [StorageError.ParentTimeoutError]: (error) => `Parent application timeout: ${error}. Please check if the storage-kit is imported on the parent page.`,
+    [StorageError.ReadError]: (error) => `Storage read error: ${error}`,
+    [StorageError.WriteError]: (error) => `Storage write error: ${error}`,
+    [StorageError.RemoveError]: (error) => `Storage remove error: ${error}`,
+    [StorageError.ClearError]: (error) => `Storage clear error: ${error}`,
 };
 /**
@@ -199,12 +204,22 @@ function listenStorageMessages(experience) {
     });
 }
 async function parentAppRequest(parentApp, action, payload) {
-    const response = await sendSdkRequest(parentApp, action, payload);
-    const { value, error } = response.payload;
-    if (error !== undefined) {
-        throw createError(StorageError.ParentAppError, StorageErrorMessages, error);
+    try {
+        const response = await sendSdkRequest(parentApp, action, payload);
+        const { value, error } = response.payload;
+        if (error !== undefined) {
+            throw createError(StorageError.ParentAppError, StorageErrorMessages, error);
+        }
+        return value;
+    }
+    catch (err) {
+        if (err instanceof MonterosaError &&
+            err.code === BridgeError.RequestTimeoutError) {
+            const errorMessage = getErrorMessage(err);
+            throw createError(StorageError.ParentTimeoutError, StorageErrorMessages, errorMessage);
+        }
+        throw err;
     }
-    return value;
 }
 /**
  * The `setStoragePersistent` function is a simple function that allows to
@@ -259,7 +274,7 @@ async function storageRead(key) {
     }
     catch (err) {
         const errorMessage = getErrorMessage(err);
-        console.error(`Unable to read storage item ${key} with error: ${errorMessage}`);
+        console.error(`Unable to read storage item "${key}" with error: ${errorMessage}`);
         throw createError(StorageError.ReadError, StorageErrorMessages, errorMessage);
     }
     return value;
@@ -292,7 +307,7 @@ async function storageWrite(key, value) {
     }
     catch (err) {
         const errorMessage = getErrorMessage(err);
-        console.error(`Unable to write storage item ${key} with error: ${errorMessage}`);
+        console.error(`Unable to write storage item "${key}" with error: ${errorMessage}`);
         throw createError(StorageError.WriteError, StorageErrorMessages, errorMessage);
     }
 }
@@ -320,7 +335,7 @@ async function storageRemove(key) {
     }
     catch (err) {
         const errorMessage = getErrorMessage(err);
-        console.error(`Unable to remove storage item ${key} with error: ${errorMessage}`);
+        console.error(`Unable to remove storage item "${key}" with error: ${errorMessage}`);
         throw createError(StorageError.RemoveError, StorageErrorMessages, errorMessage);
     }
 }

package/dist/index.esm2017.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.esm2017.js","sources":["../src/types.ts","../src/storage_impl.ts","../src/api.ts"],"sourcesContent":["/*\n @license\n * types.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nexport enum StorageAction {\n Read = 'storageRead',\n Write = 'storageWrite',\n Remove = 'storageRemove',\n Clear = 'storageClear',\n}\n\nexport type ResponsePayload = {\n key: string;\n value?: string \| null;\n error?: string;\n};\n\n/\n Defines a set of error codes that may be encountered when using the\n * Storage kit of the Monterosa SDK.\n \n @example\n * ```javascript\n * try {\n * // some code that uses the StorageKit\n * } catch (err) {\n * if (err.code === StorageError.ParentApp) {\n * // handle parent app error\n * } else {\n * // handle other error types\n * }\n * }\n * ```\n \n @remarks\n * - The `StorageError` enum provides a convenient way to handle errors\n * encountered when using the `StorageKit` module. By checking the code\n * property of the caught error against the values of the enum, the error\n * type can be determined and appropriate action taken.\n \n - The `StorageError` enum is not intended to be instantiated or extended.\n /\nexport enum StorageError {\n /\n Indicates an error occurred in the parent app.\n /\n ParentAppError = 'parent_app_error',\n /\n Indicates an error occurred when reading from the storage.\n /\n ReadError = 'read_error',\n /\n Indicates an error occurred when writing to the storage.\n /\n WriteError = 'write_error',\n /\n Indicates an error occurred when removing from the storage.\n /\n RemoveError = 'remove_error',\n /\n Indicates an error occurred when clearing the storage.\n /\n ClearError = 'clear_error',\n}\n\n/\n @internal\n /\nexport const StorageErrorMessages = {\n [StorageError.ParentAppError]: (error: string) =>\n `Parent application error: ${error}`,\n [StorageError.ReadError]: (error: string) => `Read error: ${error}`,\n [StorageError.WriteError]: (error: string) => `Write error: ${error}`,\n [StorageError.RemoveError]: (error: string) => `Remove error: ${error}`,\n [StorageError.ClearError]: (error: string) => `Clear error: ${error}`,\n};\n","/\n @license\n * storage_impl.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport {\n checkAvailability,\n getItem,\n setItem,\n removeItem,\n clear,\n} from '@monterosa/sdk-util';\n\nexport class StorageImpl {\n private memoryStore: { [key: string]: string } = {};\n private accessible: boolean = checkAvailability();\n private _persistent: boolean = true;\n\n set persistent(newValue: boolean) {\n const oldValue = this._persistent;\n\n if (oldValue === newValue) {\n return;\n }\n\n const swapToStorage = newValue === true && this.accessible;\n const swapToMemory = newValue === false && this.accessible;\n\n if (swapToStorage) {\n for (const [key, value] of Object.entries(this.memoryStore)) {\n setItem(key, value);\n }\n }\n\n if (swapToMemory) {\n clear();\n }\n\n this._persistent = newValue;\n }\n\n get persistent(): boolean {\n return this._persistent;\n }\n\n getItem(key: string): string \| null {\n if (this.persistent && this.accessible) {\n return getItem(key);\n }\n\n if (Object.prototype.hasOwnProperty.call(this.memoryStore, key)) {\n return this.memoryStore[key];\n }\n\n return null;\n }\n\n setItem(key: string, value: string): void {\n if (this.persistent && this.accessible) {\n setItem(key, value);\n }\n\n this.memoryStore[key] = value;\n }\n\n removeItem(key: string): void {\n if (this.persistent && this.accessible) {\n removeItem(key);\n }\n\n delete this.memoryStore[key];\n }\n\n clear(): void {\n if (this.persistent && this.accessible) {\n clear();\n }\n\n this.memoryStore = {};\n }\n}\n","/\n @license\n * api.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport { Unsubscribe, createError, getErrorMessage } from '@monterosa/sdk-util';\nimport {\n Experience,\n Payload,\n ParentApplication,\n registerEmbedHook,\n getParentApplication,\n sendSdkRequest,\n respondToSdkMessage,\n onSdkMessage,\n} from '@monterosa/sdk-launcher-kit';\n\nimport {\n StorageAction,\n ResponsePayload,\n StorageError,\n StorageErrorMessages,\n} from './types';\nimport { StorageImpl } from './storage_impl';\n\n/\n @internal\n /\nexport const storage = new StorageImpl();\n\n/\n @internal\n /\nexport function listenStorageMessages(experience: Experience): Unsubscribe {\n return onSdkMessage(experience, (message) => {\n if (\n !Object.values(StorageAction).includes(message.action as StorageAction)\n ) {\n return;\n }\n\n try {\n let payload: Payload = {};\n\n switch (message.action) {\n case StorageAction.Read:\n payload = {\n key: message.payload.key,\n value: storage.getItem(message.payload.key),\n };\n break;\n case StorageAction.Write:\n payload = {\n key: message.payload.key,\n };\n storage.setItem(message.payload.key, message.payload.value);\n break;\n case StorageAction.Remove:\n payload = {\n key: message.payload.key,\n };\n storage.removeItem(message.payload.key);\n break;\n case StorageAction.Clear:\n storage.clear();\n break;\n }\n\n respondToSdkMessage(experience, message, payload);\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to handle storage message ${message.action} with error: ${errorMessage}`,\n );\n\n respondToSdkMessage(experience, message, {\n key: message.payload.key,\n error: errorMessage,\n });\n }\n });\n}\n\n/\n @internal\n /\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Read,\n payload?: Payload,\n): Promise<string \| null>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Write \| StorageAction.Remove \| StorageAction.Clear,\n payload?: Payload,\n): Promise<undefined>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction,\n payload?: Payload,\n): Promise<string \| null \| undefined> {\n const response = await sendSdkRequest(parentApp, action, payload);\n\n const { value, error } = response.payload as ResponsePayload;\n\n if (error !== undefined) {\n throw createError(StorageError.ParentAppError, StorageErrorMessages, error);\n }\n\n return value;\n}\n\n/\n The `setStoragePersistent` function is a simple function that allows to\n * control the persistence of the SDK storage. If the argument `persistent` is\n * set to `true`, then the storage will be persistent across browser sessions\n * and if it is set to `false`, then the storage will save to memory.\n * It is important to note that the use of persistent storage may be subject\n * to laws and regulations, such as those related to data privacy and protection.\n \n @remarks\n * - We transition from persistent to memory and memory to persistent in\n * a seamless manner for you\n \n - By default we store in memory\n \n - The value of storage persistent persists across session (aka put it to true,\n * it will remain so, put it back to false, it will remain so)\n \n - You have the responsibility to comply with any laws and regulations, and\n * store only the data if you know it's valid to do so\n \n @param persistent - Determines whether or not SDK storage should persist\n * across browser sessions.\n /\nexport function setStoragePersistent(persistent: boolean): void {\n storage.persistent = persistent;\n}\n\n/\n The function allows to read data from the SDK storage.\n \n @param key - The name of the item to be read from storage.\n \n @throws\n * The function throws an error if there is a timeout reading the data\n * from the parent application storage.\n \n @returns A promise that resolves to the value\n * of the item in storage or `null` if the item doesn't exist.\n /\nexport async function storageRead(key: string): Promise<string \| null> {\n const parentApp = getParentApplication();\n\n let value: string \| null = null;\n\n try {\n if (parentApp !== null) {\n value = await parentAppRequest(parentApp, StorageAction.Read, {\n key,\n });\n } else {\n value = storage.getItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to read storage item ${key} with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.ReadError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n\n return value;\n}\n\n/\n The function allows to write data to the SDK storage.\n \n @param key - A name of the item to be stored.\n * @param value - A value to be stored.\n \n @throws\n * The function throws an error if there is a timeout writing the data\n * to the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully stored.\n /\nexport async function storageWrite(key: string, value: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Write, {\n key,\n value,\n });\n } else {\n storage.setItem(key, value);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to write storage item ${key} with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.WriteError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to remove an item from the SDK storage.\n \n @param key - A name of the item to be removed.\n \n @throws\n * The function throws an error if there is a timeout removing the data\n * from the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully removed.\n /\nexport async function storageRemove(key: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Remove, { key });\n } else {\n storage.removeItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to remove storage item ${key} with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.RemoveError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to clear all data from the SDK storage.\n \n @throws\n * The function throws an error if there is a timeout clearing the parent's\n * application storage.\n \n @returns A promise that resolves to `void` once the data has been\n * successfully cleared.\n */\nexport async function storageClear(): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Clear);\n } else {\n storage.clear();\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(`Unable to clear storage with error: ${errorMessage}`);\n\n throw createError(\n StorageError.ClearError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\nregisterEmbedHook(listenStorageMessages);\n"],"names":[],"mappings":";;;AAAA;;;;;;;;;AAUA,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,qCAAoB,CAAA;IACpB,uCAAsB,CAAA;IACtB,yCAAwB,CAAA;IACxB,uCAAsB,CAAA;AACxB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;IAyBY;AAAZ,WAAY,YAAY;;;;IAItB,mDAAmC,CAAA;;;;IAInC,wCAAwB,CAAA;;;;IAIxB,0CAA0B,CAAA;;;;IAI1B,4CAA4B,CAAA;;;;IAI5B,0CAA0B,CAAA;AAC5B,CAAC,EArBW,YAAY,KAAZ,YAAY,QAqBvB;AAED;;;AAGO,MAAM,oBAAoB,GAAG;IAClC,CAAC,YAAY,CAAC,cAAc,GAAG,CAAC,KAAa,KAC3C,6BAA6B,KAAK,EAAE;IACtC,CAAC,YAAY,CAAC,SAAS,GAAG,CAAC,KAAa,KAAK,eAAe,KAAK,EAAE;IACnE,CAAC,YAAY,CAAC,UAAU,GAAG,CAAC,KAAa,KAAK,gBAAgB,KAAK,EAAE;IACrE,CAAC,YAAY,CAAC,WAAW,GAAG,CAAC,KAAa,KAAK,iBAAiB,KAAK,EAAE;IACvE,CAAC,YAAY,CAAC,UAAU,GAAG,CAAC,KAAa,KAAK,gBAAgB,KAAK,EAAE;CACtE;;ACjFD;;;;;;;;;MAkBa,WAAW;IAAxB;QACU,gBAAW,GAA8B,EAAE,CAAC;QAC5C,eAAU,GAAY,iBAAiB,EAAE,CAAC;QAC1C,gBAAW,GAAY,IAAI,CAAC;KAgErC;IA9DC,IAAI,UAAU,CAAC,QAAiB;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC;QAElC,IAAI,QAAQ,KAAK,QAAQ,EAAE;YACzB,OAAO;SACR;QAED,MAAM,aAAa,GAAG,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC;QAC3D,MAAM,YAAY,GAAG,QAAQ,KAAK,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC;QAE3D,IAAI,aAAa,EAAE;YACjB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE;gBAC3D,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;aACrB;SACF;QAED,IAAI,YAAY,EAAE;YAChB,KAAK,EAAE,CAAC;SACT;QAED,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC;KAC7B;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;KACzB;IAED,OAAO,CAAC,GAAW;QACjB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,EAAE;YACtC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;SACrB;QAED,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE;YAC/D,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;SAC9B;QAED,OAAO,IAAI,CAAC;KACb;IAED,OAAO,CAAC,GAAW,EAAE,KAAa;QAChC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,EAAE;YACtC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;SACrB;QAED,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;KAC/B;IAED,UAAU,CAAC,GAAW;QACpB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,EAAE;YACtC,UAAU,CAAC,GAAG,CAAC,CAAC;SACjB;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;KAC9B;IAED,KAAK;QACH,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,EAAE;YACtC,KAAK,EAAE,CAAC;SACT;QAED,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;KACvB;;;ACpFH;;;;;;;;;AA8BA;;;MAGa,OAAO,GAAG,IAAI,WAAW,GAAG;AAEzC;;;SAGgB,qBAAqB,CAAC,UAAsB;IAC1D,OAAO,YAAY,CAAC,UAAU,EAAE,CAAC,OAAO;QACtC,IACE,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAuB,CAAC,EACvE;YACA,OAAO;SACR;QAED,IAAI;YACF,IAAI,OAAO,GAAY,EAAE,CAAC;YAE1B,QAAQ,OAAO,CAAC,MAAM;gBACpB,KAAK,aAAa,CAAC,IAAI;oBACrB,OAAO,GAAG;wBACR,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG;wBACxB,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;qBAC5C,CAAC;oBACF,MAAM;gBACR,KAAK,aAAa,CAAC,KAAK;oBACtB,OAAO,GAAG;wBACR,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG;qBACzB,CAAC;oBACF,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;oBAC5D,MAAM;gBACR,KAAK,aAAa,CAAC,MAAM;oBACvB,OAAO,GAAG;wBACR,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG;qBACzB,CAAC;oBACF,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBACxC,MAAM;gBACR,KAAK,aAAa,CAAC,KAAK;oBACtB,OAAO,CAAC,KAAK,EAAE,CAAC;oBAChB,MAAM;aACT;YAED,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SACnD;QAAC,OAAO,GAAG,EAAE;YACZ,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YAE1C,OAAO,CAAC,KAAK,CACX,oCAAoC,OAAO,CAAC,MAAM,gBAAgB,YAAY,EAAE,CACjF,CAAC;YAEF,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE;gBACvC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG;gBACxB,KAAK,EAAE,YAAY;aACpB,CAAC,CAAC;SACJ;KACF,CAAC,CAAC;AACL,CAAC;AAiBM,eAAe,gBAAgB,CACpC,SAA4B,EAC5B,MAAqB,EACrB,OAAiB;IAEjB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAElE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,OAA0B,CAAC;IAE7D,IAAI,KAAK,KAAK,SAAS,EAAE;QACvB,MAAM,WAAW,CAAC,YAAY,CAAC,cAAc,EAAE,oBAAoB,EAAE,KAAK,CAAC,CAAC;KAC7E;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;SAuBgB,oBAAoB,CAAC,UAAmB;IACtD,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;AAYO,eAAe,WAAW,CAAC,GAAW;IAC3C,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IAEzC,IAAI,KAAK,GAAkB,IAAI,CAAC;IAEhC,IAAI;QACF,IAAI,SAAS,KAAK,IAAI,EAAE;YACtB,KAAK,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,EAAE;gBAC5D,GAAG;aACJ,CAAC,CAAC;SACJ;aAAM;YACL,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;SAC9B;KACF;IAAC,OAAO,GAAG,EAAE;QACZ,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAE1C,OAAO,CAAC,KAAK,CACX,+BAA+B,GAAG,gBAAgB,YAAY,EAAE,CACjE,CAAC;QAEF,MAAM,WAAW,CACf,YAAY,CAAC,SAAS,EACtB,oBAAoB,EACpB,YAAY,CACb,CAAC;KACH;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;AAaO,eAAe,YAAY,CAAC,GAAW,EAAE,KAAa;IAC3D,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IAEzC,IAAI;QACF,IAAI,SAAS,KAAK,IAAI,EAAE;YACtB,MAAM,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,KAAK,EAAE;gBACrD,GAAG;gBACH,KAAK;aACN,CAAC,CAAC;SACJ;aAAM;YACL,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;SAC7B;KACF;IAAC,OAAO,GAAG,EAAE;QACZ,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAE1C,OAAO,CAAC,KAAK,CACX,gCAAgC,GAAG,gBAAgB,YAAY,EAAE,CAClE,CAAC;QAEF,MAAM,WAAW,CACf,YAAY,CAAC,UAAU,EACvB,oBAAoB,EACpB,YAAY,CACb,CAAC;KACH;AACH,CAAC;AAED;;;;;;;;;;;;AAYO,eAAe,aAAa,CAAC,GAAW;IAC7C,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IAEzC,IAAI;QACF,IAAI,SAAS,KAAK,IAAI,EAAE;YACtB,MAAM,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;SAClE;aAAM;YACL,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SACzB;KACF;IAAC,OAAO,GAAG,EAAE;QACZ,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAE1C,OAAO,CAAC,KAAK,CACX,iCAAiC,GAAG,gBAAgB,YAAY,EAAE,CACnE,CAAC;QAEF,MAAM,WAAW,CACf,YAAY,CAAC,WAAW,EACxB,oBAAoB,EACpB,YAAY,CACb,CAAC;KACH;AACH,CAAC;AAED;;;;;;;;;;AAUO,eAAe,YAAY;IAChC,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IAEzC,IAAI;QACF,IAAI,SAAS,KAAK,IAAI,EAAE;YACtB,MAAM,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;SACxD;aAAM;YACL,OAAO,CAAC,KAAK,EAAE,CAAC;SACjB;KACF;IAAC,OAAO,GAAG,EAAE;QACZ,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAE1C,OAAO,CAAC,KAAK,CAAC,uCAAuC,YAAY,EAAE,CAAC,CAAC;QAErE,MAAM,WAAW,CACf,YAAY,CAAC,UAAU,EACvB,oBAAoB,EACpB,YAAY,CACb,CAAC;KACH;AACH,CAAC;AAED,iBAAiB,CAAC,qBAAqB,CAAC;;;;"}
1	+ {"version":3,"file":"index.esm2017.js","sources":["../src/types.ts","../src/storage_impl.ts","../src/api.ts"],"sourcesContent":["/*\n @license\n * types.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nexport enum StorageAction {\n Read = 'storageRead',\n Write = 'storageWrite',\n Remove = 'storageRemove',\n Clear = 'storageClear',\n}\n\nexport type ResponsePayload = {\n key: string;\n value?: string \| null;\n error?: string;\n};\n\n/\n Defines a set of error codes that may be encountered when using the\n * Storage kit of the Monterosa SDK.\n \n @example\n * ```javascript\n * try {\n * // some code that uses the StorageKit\n * } catch (err) {\n * if (err.code === StorageError.ParentApp) {\n * // handle parent app error\n * } else {\n * // handle other error types\n * }\n * }\n * ```\n \n @remarks\n * - The `StorageError` enum provides a convenient way to handle errors\n * encountered when using the `StorageKit` module. By checking the code\n * property of the caught error against the values of the enum, the error\n * type can be determined and appropriate action taken.\n \n - The `StorageError` enum is not intended to be instantiated or extended.\n /\nexport enum StorageError {\n /\n Indicates an error occurred in the parent app.\n /\n ParentAppError = 'parent_app_error',\n /\n Indicates a timeout occurred when communicating with the parent app.\n /\n ParentTimeoutError = 'parent_timeout_error',\n /\n Indicates an error occurred when reading from the storage.\n /\n ReadError = 'read_error',\n /\n Indicates an error occurred when writing to the storage.\n /\n WriteError = 'write_error',\n /\n Indicates an error occurred when removing from the storage.\n /\n RemoveError = 'remove_error',\n /\n Indicates an error occurred when clearing the storage.\n /\n ClearError = 'clear_error',\n}\n\n/\n @internal\n /\nexport const StorageErrorMessages = {\n [StorageError.ParentAppError]: (error: string) =>\n `Parent application error: ${error}`,\n [StorageError.ParentTimeoutError]: (error: string) =>\n `Parent application timeout: ${error}. Please check if the storage-kit is imported on the parent page.`,\n [StorageError.ReadError]: (error: string) => `Storage read error: ${error}`,\n [StorageError.WriteError]: (error: string) => `Storage write error: ${error}`,\n [StorageError.RemoveError]: (error: string) =>\n `Storage remove error: ${error}`,\n [StorageError.ClearError]: (error: string) => `Storage clear error: ${error}`,\n};\n","/\n @license\n * storage_impl.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport {\n checkAvailability,\n getItem,\n setItem,\n removeItem,\n clear,\n} from '@monterosa/sdk-util';\n\nexport class StorageImpl {\n private memoryStore: { [key: string]: string } = {};\n private accessible: boolean = checkAvailability();\n private _persistent: boolean = true;\n\n set persistent(newValue: boolean) {\n const oldValue = this._persistent;\n\n if (oldValue === newValue) {\n return;\n }\n\n const swapToStorage = newValue === true && this.accessible;\n const swapToMemory = newValue === false && this.accessible;\n\n if (swapToStorage) {\n for (const [key, value] of Object.entries(this.memoryStore)) {\n setItem(key, value);\n }\n }\n\n if (swapToMemory) {\n clear();\n }\n\n this._persistent = newValue;\n }\n\n get persistent(): boolean {\n return this._persistent;\n }\n\n getItem(key: string): string \| null {\n if (this.persistent && this.accessible) {\n return getItem(key);\n }\n\n if (Object.prototype.hasOwnProperty.call(this.memoryStore, key)) {\n return this.memoryStore[key];\n }\n\n return null;\n }\n\n setItem(key: string, value: string): void {\n if (this.persistent && this.accessible) {\n setItem(key, value);\n }\n\n this.memoryStore[key] = value;\n }\n\n removeItem(key: string): void {\n if (this.persistent && this.accessible) {\n removeItem(key);\n }\n\n delete this.memoryStore[key];\n }\n\n clear(): void {\n if (this.persistent && this.accessible) {\n clear();\n }\n\n this.memoryStore = {};\n }\n}\n","/\n @license\n * api.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport {\n MonterosaError,\n Unsubscribe,\n createError,\n getErrorMessage,\n} from '@monterosa/sdk-util';\nimport {\n Experience,\n Payload,\n ParentApplication,\n registerEmbedHook,\n getParentApplication,\n sendSdkRequest,\n respondToSdkMessage,\n onSdkMessage,\n BridgeError,\n} from '@monterosa/sdk-launcher-kit';\n\nimport {\n StorageAction,\n ResponsePayload,\n StorageError,\n StorageErrorMessages,\n} from './types';\nimport { StorageImpl } from './storage_impl';\n\n/\n @internal\n /\nexport const storage = new StorageImpl();\n\n/\n @internal\n /\nexport function listenStorageMessages(experience: Experience): Unsubscribe {\n return onSdkMessage(experience, (message) => {\n if (\n !Object.values(StorageAction).includes(message.action as StorageAction)\n ) {\n return;\n }\n\n try {\n let payload: Payload = {};\n\n switch (message.action) {\n case StorageAction.Read:\n payload = {\n key: message.payload.key,\n value: storage.getItem(message.payload.key),\n };\n break;\n case StorageAction.Write:\n payload = {\n key: message.payload.key,\n };\n storage.setItem(message.payload.key, message.payload.value);\n break;\n case StorageAction.Remove:\n payload = {\n key: message.payload.key,\n };\n storage.removeItem(message.payload.key);\n break;\n case StorageAction.Clear:\n storage.clear();\n break;\n }\n\n respondToSdkMessage(experience, message, payload);\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to handle storage message ${message.action} with error: ${errorMessage}`,\n );\n\n respondToSdkMessage(experience, message, {\n key: message.payload.key,\n error: errorMessage,\n });\n }\n });\n}\n\n/\n @internal\n /\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Read,\n payload?: Payload,\n): Promise<string \| null>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Write \| StorageAction.Remove \| StorageAction.Clear,\n payload?: Payload,\n): Promise<undefined>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction,\n payload?: Payload,\n): Promise<string \| null \| undefined> {\n try {\n const response = await sendSdkRequest(parentApp, action, payload);\n\n const { value, error } = response.payload as ResponsePayload;\n\n if (error !== undefined) {\n throw createError(\n StorageError.ParentAppError,\n StorageErrorMessages,\n error,\n );\n }\n\n return value;\n } catch (err) {\n if (\n err instanceof MonterosaError &&\n err.code === BridgeError.RequestTimeoutError\n ) {\n const errorMessage = getErrorMessage(err);\n\n throw createError(\n StorageError.ParentTimeoutError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n\n throw err;\n }\n}\n\n/\n The `setStoragePersistent` function is a simple function that allows to\n * control the persistence of the SDK storage. If the argument `persistent` is\n * set to `true`, then the storage will be persistent across browser sessions\n * and if it is set to `false`, then the storage will save to memory.\n * It is important to note that the use of persistent storage may be subject\n * to laws and regulations, such as those related to data privacy and protection.\n \n @remarks\n * - We transition from persistent to memory and memory to persistent in\n * a seamless manner for you\n \n - By default we store in memory\n \n - The value of storage persistent persists across session (aka put it to true,\n * it will remain so, put it back to false, it will remain so)\n \n - You have the responsibility to comply with any laws and regulations, and\n * store only the data if you know it's valid to do so\n \n @param persistent - Determines whether or not SDK storage should persist\n * across browser sessions.\n /\nexport function setStoragePersistent(persistent: boolean): void {\n storage.persistent = persistent;\n}\n\n/\n The function allows to read data from the SDK storage.\n \n @param key - The name of the item to be read from storage.\n \n @throws\n * The function throws an error if there is a timeout reading the data\n * from the parent application storage.\n \n @returns A promise that resolves to the value\n * of the item in storage or `null` if the item doesn't exist.\n /\nexport async function storageRead(key: string): Promise<string \| null> {\n const parentApp = getParentApplication();\n\n let value: string \| null = null;\n\n try {\n if (parentApp !== null) {\n value = await parentAppRequest(parentApp, StorageAction.Read, {\n key,\n });\n } else {\n value = storage.getItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to read storage item \"${key}\" with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.ReadError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n\n return value;\n}\n\n/\n The function allows to write data to the SDK storage.\n \n @param key - A name of the item to be stored.\n * @param value - A value to be stored.\n \n @throws\n * The function throws an error if there is a timeout writing the data\n * to the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully stored.\n /\nexport async function storageWrite(key: string, value: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Write, {\n key,\n value,\n });\n } else {\n storage.setItem(key, value);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to write storage item \"${key}\" with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.WriteError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to remove an item from the SDK storage.\n \n @param key - A name of the item to be removed.\n \n @throws\n * The function throws an error if there is a timeout removing the data\n * from the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully removed.\n /\nexport async function storageRemove(key: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Remove, { key });\n } else {\n storage.removeItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to remove storage item \"${key}\" with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.RemoveError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to clear all data from the SDK storage.\n \n @throws\n * The function throws an error if there is a timeout clearing the parent's\n * application storage.\n \n @returns A promise that resolves to `void` once the data has been\n * successfully cleared.\n */\nexport async function storageClear(): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Clear);\n } else {\n storage.clear();\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(`Unable to clear storage with error: ${errorMessage}`);\n\n throw createError(\n StorageError.ClearError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\nregisterEmbedHook(listenStorageMessages);\n"],"names":[],"mappings":"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"}

package/dist/index.esm5.js CHANGED Viewed

@@ -1,5 +1,5 @@
-import { setItem, clear, getItem, removeItem, checkAvailability, getErrorMessage, createError } from '@monterosa/sdk-util';
-import { registerEmbedHook, onSdkMessage, respondToSdkMessage, sendSdkRequest, getParentApplication } from '@monterosa/sdk-launcher-kit';
+import { setItem, clear, getItem, removeItem, checkAvailability, getErrorMessage, MonterosaError, createError } from '@monterosa/sdk-util';
+import { registerEmbedHook, onSdkMessage, respondToSdkMessage, BridgeError, sendSdkRequest, getParentApplication } from '@monterosa/sdk-launcher-kit';
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation.
@@ -102,6 +102,10 @@ var StorageError;
      * Indicates an error occurred in the parent app.
      */
     StorageError["ParentAppError"] = "parent_app_error";
+    /**
+     * Indicates a timeout occurred when communicating with the parent app.
+     */
+    StorageError["ParentTimeoutError"] = "parent_timeout_error";
     /**
      * Indicates an error occurred when reading from the storage.
      */
@@ -126,10 +130,15 @@ var StorageErrorMessages = (_a = {},
     _a[StorageError.ParentAppError] = function (error) {
         return "Parent application error: " + error;
     },
-    _a[StorageError.ReadError] = function (error) { return "Read error: " + error; },
-    _a[StorageError.WriteError] = function (error) { return "Write error: " + error; },
-    _a[StorageError.RemoveError] = function (error) { return "Remove error: " + error; },
-    _a[StorageError.ClearError] = function (error) { return "Clear error: " + error; },
+    _a[StorageError.ParentTimeoutError] = function (error) {
+        return "Parent application timeout: " + error + ". Please check if the storage-kit is imported on the parent page.";
+    },
+    _a[StorageError.ReadError] = function (error) { return "Storage read error: " + error; },
+    _a[StorageError.WriteError] = function (error) { return "Storage write error: " + error; },
+    _a[StorageError.RemoveError] = function (error) {
+        return "Storage remove error: " + error;
+    },
+    _a[StorageError.ClearError] = function (error) { return "Storage clear error: " + error; },
     _a);
 /**
@@ -262,10 +271,12 @@ function listenStorageMessages(experience) {
 }
 function parentAppRequest(parentApp, action, payload) {
     return __awaiter(this, void 0, void 0, function () {
-        var response, _a, value, error;
+        var response, _a, value, error, err_1, errorMessage;
         return __generator(this, function (_b) {
             switch (_b.label) {
-                case 0: return [4 /*yield*/, sendSdkRequest(parentApp, action, payload)];
+                case 0:
+                    _b.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, sendSdkRequest(parentApp, action, payload)];
                 case 1:
                     response = _b.sent();
                     _a = response.payload, value = _a.value, error = _a.error;
@@ -273,6 +284,15 @@ function parentAppRequest(parentApp, action, payload) {
                         throw createError(StorageError.ParentAppError, StorageErrorMessages, error);
                     }
                     return [2 /*return*/, value];
+                case 2:
+                    err_1 = _b.sent();
+                    if (err_1 instanceof MonterosaError &&
+                        err_1.code === BridgeError.RequestTimeoutError) {
+                        errorMessage = getErrorMessage(err_1);
+                        throw createError(StorageError.ParentTimeoutError, StorageErrorMessages, errorMessage);
+                    }
+                    throw err_1;
+                case 3: return [2 /*return*/];
             }
         });
     });
@@ -317,7 +337,7 @@ function setStoragePersistent(persistent) {
  */
 function storageRead(key) {
     return __awaiter(this, void 0, void 0, function () {
-        var parentApp, value, err_1, errorMessage;
+        var parentApp, value, err_2, errorMessage;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -338,9 +358,9 @@ function storageRead(key) {
                     _a.label = 4;
                 case 4: return [3 /*break*/, 6];
                 case 5:
-                    err_1 = _a.sent();
-                    errorMessage = getErrorMessage(err_1);
-                    console.error("Unable to read storage item " + key + " with error: " + errorMessage);
+                    err_2 = _a.sent();
+                    errorMessage = getErrorMessage(err_2);
+                    console.error("Unable to read storage item \"" + key + "\" with error: " + errorMessage);
                     throw createError(StorageError.ReadError, StorageErrorMessages, errorMessage);
                 case 6: return [2 /*return*/, value];
             }
@@ -362,7 +382,7 @@ function storageRead(key) {
  */
 function storageWrite(key, value) {
     return __awaiter(this, void 0, void 0, function () {
-        var parentApp, err_2, errorMessage;
+        var parentApp, err_3, errorMessage;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -383,9 +403,9 @@ function storageWrite(key, value) {
                     _a.label = 4;
                 case 4: return [3 /*break*/, 6];
                 case 5:
-                    err_2 = _a.sent();
-                    errorMessage = getErrorMessage(err_2);
-                    console.error("Unable to write storage item " + key + " with error: " + errorMessage);
+                    err_3 = _a.sent();
+                    errorMessage = getErrorMessage(err_3);
+                    console.error("Unable to write storage item \"" + key + "\" with error: " + errorMessage);
                     throw createError(StorageError.WriteError, StorageErrorMessages, errorMessage);
                 case 6: return [2 /*return*/];
             }
@@ -406,7 +426,7 @@ function storageWrite(key, value) {
  */
 function storageRemove(key) {
     return __awaiter(this, void 0, void 0, function () {
-        var parentApp, err_3, errorMessage;
+        var parentApp, err_4, errorMessage;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -424,9 +444,9 @@ function storageRemove(key) {
                     _a.label = 4;
                 case 4: return [3 /*break*/, 6];
                 case 5:
-                    err_3 = _a.sent();
-                    errorMessage = getErrorMessage(err_3);
-                    console.error("Unable to remove storage item " + key + " with error: " + errorMessage);
+                    err_4 = _a.sent();
+                    errorMessage = getErrorMessage(err_4);
+                    console.error("Unable to remove storage item \"" + key + "\" with error: " + errorMessage);
                     throw createError(StorageError.RemoveError, StorageErrorMessages, errorMessage);
                 case 6: return [2 /*return*/];
             }
@@ -445,7 +465,7 @@ function storageRemove(key) {
  */
 function storageClear() {
     return __awaiter(this, void 0, void 0, function () {
-        var parentApp, err_4, errorMessage;
+        var parentApp, err_5, errorMessage;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -463,8 +483,8 @@ function storageClear() {
                     _a.label = 4;
                 case 4: return [3 /*break*/, 6];
                 case 5:
-                    err_4 = _a.sent();
-                    errorMessage = getErrorMessage(err_4);
+                    err_5 = _a.sent();
+                    errorMessage = getErrorMessage(err_5);
                     console.error("Unable to clear storage with error: " + errorMessage);
                     throw createError(StorageError.ClearError, StorageErrorMessages, errorMessage);
                 case 6: return [2 /*return*/];

package/dist/index.esm5.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.esm5.js","sources":["../src/types.ts","../src/storage_impl.ts","../src/api.ts"],"sourcesContent":["/*\n @license\n * types.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nexport enum StorageAction {\n Read = 'storageRead',\n Write = 'storageWrite',\n Remove = 'storageRemove',\n Clear = 'storageClear',\n}\n\nexport type ResponsePayload = {\n key: string;\n value?: string \| null;\n error?: string;\n};\n\n/\n Defines a set of error codes that may be encountered when using the\n * Storage kit of the Monterosa SDK.\n \n @example\n * ```javascript\n * try {\n * // some code that uses the StorageKit\n * } catch (err) {\n * if (err.code === StorageError.ParentApp) {\n * // handle parent app error\n * } else {\n * // handle other error types\n * }\n * }\n * ```\n \n @remarks\n * - The `StorageError` enum provides a convenient way to handle errors\n * encountered when using the `StorageKit` module. By checking the code\n * property of the caught error against the values of the enum, the error\n * type can be determined and appropriate action taken.\n \n - The `StorageError` enum is not intended to be instantiated or extended.\n /\nexport enum StorageError {\n /\n Indicates an error occurred in the parent app.\n /\n ParentAppError = 'parent_app_error',\n /\n Indicates an error occurred when reading from the storage.\n /\n ReadError = 'read_error',\n /\n Indicates an error occurred when writing to the storage.\n /\n WriteError = 'write_error',\n /\n Indicates an error occurred when removing from the storage.\n /\n RemoveError = 'remove_error',\n /\n Indicates an error occurred when clearing the storage.\n /\n ClearError = 'clear_error',\n}\n\n/\n @internal\n /\nexport const StorageErrorMessages = {\n [StorageError.ParentAppError]: (error: string) =>\n `Parent application error: ${error}`,\n [StorageError.ReadError]: (error: string) => `Read error: ${error}`,\n [StorageError.WriteError]: (error: string) => `Write error: ${error}`,\n [StorageError.RemoveError]: (error: string) => `Remove error: ${error}`,\n [StorageError.ClearError]: (error: string) => `Clear error: ${error}`,\n};\n","/\n @license\n * storage_impl.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport {\n checkAvailability,\n getItem,\n setItem,\n removeItem,\n clear,\n} from '@monterosa/sdk-util';\n\nexport class StorageImpl {\n private memoryStore: { [key: string]: string } = {};\n private accessible: boolean = checkAvailability();\n private _persistent: boolean = true;\n\n set persistent(newValue: boolean) {\n const oldValue = this._persistent;\n\n if (oldValue === newValue) {\n return;\n }\n\n const swapToStorage = newValue === true && this.accessible;\n const swapToMemory = newValue === false && this.accessible;\n\n if (swapToStorage) {\n for (const [key, value] of Object.entries(this.memoryStore)) {\n setItem(key, value);\n }\n }\n\n if (swapToMemory) {\n clear();\n }\n\n this._persistent = newValue;\n }\n\n get persistent(): boolean {\n return this._persistent;\n }\n\n getItem(key: string): string \| null {\n if (this.persistent && this.accessible) {\n return getItem(key);\n }\n\n if (Object.prototype.hasOwnProperty.call(this.memoryStore, key)) {\n return this.memoryStore[key];\n }\n\n return null;\n }\n\n setItem(key: string, value: string): void {\n if (this.persistent && this.accessible) {\n setItem(key, value);\n }\n\n this.memoryStore[key] = value;\n }\n\n removeItem(key: string): void {\n if (this.persistent && this.accessible) {\n removeItem(key);\n }\n\n delete this.memoryStore[key];\n }\n\n clear(): void {\n if (this.persistent && this.accessible) {\n clear();\n }\n\n this.memoryStore = {};\n }\n}\n","/\n @license\n * api.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport { Unsubscribe, createError, getErrorMessage } from '@monterosa/sdk-util';\nimport {\n Experience,\n Payload,\n ParentApplication,\n registerEmbedHook,\n getParentApplication,\n sendSdkRequest,\n respondToSdkMessage,\n onSdkMessage,\n} from '@monterosa/sdk-launcher-kit';\n\nimport {\n StorageAction,\n ResponsePayload,\n StorageError,\n StorageErrorMessages,\n} from './types';\nimport { StorageImpl } from './storage_impl';\n\n/\n @internal\n /\nexport const storage = new StorageImpl();\n\n/\n @internal\n /\nexport function listenStorageMessages(experience: Experience): Unsubscribe {\n return onSdkMessage(experience, (message) => {\n if (\n !Object.values(StorageAction).includes(message.action as StorageAction)\n ) {\n return;\n }\n\n try {\n let payload: Payload = {};\n\n switch (message.action) {\n case StorageAction.Read:\n payload = {\n key: message.payload.key,\n value: storage.getItem(message.payload.key),\n };\n break;\n case StorageAction.Write:\n payload = {\n key: message.payload.key,\n };\n storage.setItem(message.payload.key, message.payload.value);\n break;\n case StorageAction.Remove:\n payload = {\n key: message.payload.key,\n };\n storage.removeItem(message.payload.key);\n break;\n case StorageAction.Clear:\n storage.clear();\n break;\n }\n\n respondToSdkMessage(experience, message, payload);\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to handle storage message ${message.action} with error: ${errorMessage}`,\n );\n\n respondToSdkMessage(experience, message, {\n key: message.payload.key,\n error: errorMessage,\n });\n }\n });\n}\n\n/\n @internal\n /\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Read,\n payload?: Payload,\n): Promise<string \| null>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Write \| StorageAction.Remove \| StorageAction.Clear,\n payload?: Payload,\n): Promise<undefined>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction,\n payload?: Payload,\n): Promise<string \| null \| undefined> {\n const response = await sendSdkRequest(parentApp, action, payload);\n\n const { value, error } = response.payload as ResponsePayload;\n\n if (error !== undefined) {\n throw createError(StorageError.ParentAppError, StorageErrorMessages, error);\n }\n\n return value;\n}\n\n/\n The `setStoragePersistent` function is a simple function that allows to\n * control the persistence of the SDK storage. If the argument `persistent` is\n * set to `true`, then the storage will be persistent across browser sessions\n * and if it is set to `false`, then the storage will save to memory.\n * It is important to note that the use of persistent storage may be subject\n * to laws and regulations, such as those related to data privacy and protection.\n \n @remarks\n * - We transition from persistent to memory and memory to persistent in\n * a seamless manner for you\n \n - By default we store in memory\n \n - The value of storage persistent persists across session (aka put it to true,\n * it will remain so, put it back to false, it will remain so)\n \n - You have the responsibility to comply with any laws and regulations, and\n * store only the data if you know it's valid to do so\n \n @param persistent - Determines whether or not SDK storage should persist\n * across browser sessions.\n /\nexport function setStoragePersistent(persistent: boolean): void {\n storage.persistent = persistent;\n}\n\n/\n The function allows to read data from the SDK storage.\n \n @param key - The name of the item to be read from storage.\n \n @throws\n * The function throws an error if there is a timeout reading the data\n * from the parent application storage.\n \n @returns A promise that resolves to the value\n * of the item in storage or `null` if the item doesn't exist.\n /\nexport async function storageRead(key: string): Promise<string \| null> {\n const parentApp = getParentApplication();\n\n let value: string \| null = null;\n\n try {\n if (parentApp !== null) {\n value = await parentAppRequest(parentApp, StorageAction.Read, {\n key,\n });\n } else {\n value = storage.getItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to read storage item ${key} with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.ReadError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n\n return value;\n}\n\n/\n The function allows to write data to the SDK storage.\n \n @param key - A name of the item to be stored.\n * @param value - A value to be stored.\n \n @throws\n * The function throws an error if there is a timeout writing the data\n * to the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully stored.\n /\nexport async function storageWrite(key: string, value: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Write, {\n key,\n value,\n });\n } else {\n storage.setItem(key, value);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to write storage item ${key} with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.WriteError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to remove an item from the SDK storage.\n \n @param key - A name of the item to be removed.\n \n @throws\n * The function throws an error if there is a timeout removing the data\n * from the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully removed.\n /\nexport async function storageRemove(key: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Remove, { key });\n } else {\n storage.removeItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to remove storage item ${key} with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.RemoveError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to clear all data from the SDK storage.\n \n @throws\n * The function throws an error if there is a timeout clearing the parent's\n * application storage.\n \n @returns A promise that resolves to `void` once the data has been\n * successfully cleared.\n */\nexport async function storageClear(): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Clear);\n } else {\n storage.clear();\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(`Unable to clear storage with error: ${errorMessage}`);\n\n throw createError(\n StorageError.ClearError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\nregisterEmbedHook(listenStorageMessages);\n"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"index.esm5.js","sources":["../src/types.ts","../src/storage_impl.ts","../src/api.ts"],"sourcesContent":["/*\n @license\n * types.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nexport enum StorageAction {\n Read = 'storageRead',\n Write = 'storageWrite',\n Remove = 'storageRemove',\n Clear = 'storageClear',\n}\n\nexport type ResponsePayload = {\n key: string;\n value?: string \| null;\n error?: string;\n};\n\n/\n Defines a set of error codes that may be encountered when using the\n * Storage kit of the Monterosa SDK.\n \n @example\n * ```javascript\n * try {\n * // some code that uses the StorageKit\n * } catch (err) {\n * if (err.code === StorageError.ParentApp) {\n * // handle parent app error\n * } else {\n * // handle other error types\n * }\n * }\n * ```\n \n @remarks\n * - The `StorageError` enum provides a convenient way to handle errors\n * encountered when using the `StorageKit` module. By checking the code\n * property of the caught error against the values of the enum, the error\n * type can be determined and appropriate action taken.\n \n - The `StorageError` enum is not intended to be instantiated or extended.\n /\nexport enum StorageError {\n /\n Indicates an error occurred in the parent app.\n /\n ParentAppError = 'parent_app_error',\n /\n Indicates a timeout occurred when communicating with the parent app.\n /\n ParentTimeoutError = 'parent_timeout_error',\n /\n Indicates an error occurred when reading from the storage.\n /\n ReadError = 'read_error',\n /\n Indicates an error occurred when writing to the storage.\n /\n WriteError = 'write_error',\n /\n Indicates an error occurred when removing from the storage.\n /\n RemoveError = 'remove_error',\n /\n Indicates an error occurred when clearing the storage.\n /\n ClearError = 'clear_error',\n}\n\n/\n @internal\n /\nexport const StorageErrorMessages = {\n [StorageError.ParentAppError]: (error: string) =>\n `Parent application error: ${error}`,\n [StorageError.ParentTimeoutError]: (error: string) =>\n `Parent application timeout: ${error}. Please check if the storage-kit is imported on the parent page.`,\n [StorageError.ReadError]: (error: string) => `Storage read error: ${error}`,\n [StorageError.WriteError]: (error: string) => `Storage write error: ${error}`,\n [StorageError.RemoveError]: (error: string) =>\n `Storage remove error: ${error}`,\n [StorageError.ClearError]: (error: string) => `Storage clear error: ${error}`,\n};\n","/\n @license\n * storage_impl.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport {\n checkAvailability,\n getItem,\n setItem,\n removeItem,\n clear,\n} from '@monterosa/sdk-util';\n\nexport class StorageImpl {\n private memoryStore: { [key: string]: string } = {};\n private accessible: boolean = checkAvailability();\n private _persistent: boolean = true;\n\n set persistent(newValue: boolean) {\n const oldValue = this._persistent;\n\n if (oldValue === newValue) {\n return;\n }\n\n const swapToStorage = newValue === true && this.accessible;\n const swapToMemory = newValue === false && this.accessible;\n\n if (swapToStorage) {\n for (const [key, value] of Object.entries(this.memoryStore)) {\n setItem(key, value);\n }\n }\n\n if (swapToMemory) {\n clear();\n }\n\n this._persistent = newValue;\n }\n\n get persistent(): boolean {\n return this._persistent;\n }\n\n getItem(key: string): string \| null {\n if (this.persistent && this.accessible) {\n return getItem(key);\n }\n\n if (Object.prototype.hasOwnProperty.call(this.memoryStore, key)) {\n return this.memoryStore[key];\n }\n\n return null;\n }\n\n setItem(key: string, value: string): void {\n if (this.persistent && this.accessible) {\n setItem(key, value);\n }\n\n this.memoryStore[key] = value;\n }\n\n removeItem(key: string): void {\n if (this.persistent && this.accessible) {\n removeItem(key);\n }\n\n delete this.memoryStore[key];\n }\n\n clear(): void {\n if (this.persistent && this.accessible) {\n clear();\n }\n\n this.memoryStore = {};\n }\n}\n","/\n @license\n * api.ts\n * storage-kit\n \n Copyright © 2025 Monterosa Productions Limited. All rights reserved.\n \n More details on the license can be found at https://www.monterosa.co/sdk/license\n /\n\nimport {\n MonterosaError,\n Unsubscribe,\n createError,\n getErrorMessage,\n} from '@monterosa/sdk-util';\nimport {\n Experience,\n Payload,\n ParentApplication,\n registerEmbedHook,\n getParentApplication,\n sendSdkRequest,\n respondToSdkMessage,\n onSdkMessage,\n BridgeError,\n} from '@monterosa/sdk-launcher-kit';\n\nimport {\n StorageAction,\n ResponsePayload,\n StorageError,\n StorageErrorMessages,\n} from './types';\nimport { StorageImpl } from './storage_impl';\n\n/\n @internal\n /\nexport const storage = new StorageImpl();\n\n/\n @internal\n /\nexport function listenStorageMessages(experience: Experience): Unsubscribe {\n return onSdkMessage(experience, (message) => {\n if (\n !Object.values(StorageAction).includes(message.action as StorageAction)\n ) {\n return;\n }\n\n try {\n let payload: Payload = {};\n\n switch (message.action) {\n case StorageAction.Read:\n payload = {\n key: message.payload.key,\n value: storage.getItem(message.payload.key),\n };\n break;\n case StorageAction.Write:\n payload = {\n key: message.payload.key,\n };\n storage.setItem(message.payload.key, message.payload.value);\n break;\n case StorageAction.Remove:\n payload = {\n key: message.payload.key,\n };\n storage.removeItem(message.payload.key);\n break;\n case StorageAction.Clear:\n storage.clear();\n break;\n }\n\n respondToSdkMessage(experience, message, payload);\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to handle storage message ${message.action} with error: ${errorMessage}`,\n );\n\n respondToSdkMessage(experience, message, {\n key: message.payload.key,\n error: errorMessage,\n });\n }\n });\n}\n\n/\n @internal\n /\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Read,\n payload?: Payload,\n): Promise<string \| null>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction.Write \| StorageAction.Remove \| StorageAction.Clear,\n payload?: Payload,\n): Promise<undefined>;\n\nexport async function parentAppRequest(\n parentApp: ParentApplication,\n action: StorageAction,\n payload?: Payload,\n): Promise<string \| null \| undefined> {\n try {\n const response = await sendSdkRequest(parentApp, action, payload);\n\n const { value, error } = response.payload as ResponsePayload;\n\n if (error !== undefined) {\n throw createError(\n StorageError.ParentAppError,\n StorageErrorMessages,\n error,\n );\n }\n\n return value;\n } catch (err) {\n if (\n err instanceof MonterosaError &&\n err.code === BridgeError.RequestTimeoutError\n ) {\n const errorMessage = getErrorMessage(err);\n\n throw createError(\n StorageError.ParentTimeoutError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n\n throw err;\n }\n}\n\n/\n The `setStoragePersistent` function is a simple function that allows to\n * control the persistence of the SDK storage. If the argument `persistent` is\n * set to `true`, then the storage will be persistent across browser sessions\n * and if it is set to `false`, then the storage will save to memory.\n * It is important to note that the use of persistent storage may be subject\n * to laws and regulations, such as those related to data privacy and protection.\n \n @remarks\n * - We transition from persistent to memory and memory to persistent in\n * a seamless manner for you\n \n - By default we store in memory\n \n - The value of storage persistent persists across session (aka put it to true,\n * it will remain so, put it back to false, it will remain so)\n \n - You have the responsibility to comply with any laws and regulations, and\n * store only the data if you know it's valid to do so\n \n @param persistent - Determines whether or not SDK storage should persist\n * across browser sessions.\n /\nexport function setStoragePersistent(persistent: boolean): void {\n storage.persistent = persistent;\n}\n\n/\n The function allows to read data from the SDK storage.\n \n @param key - The name of the item to be read from storage.\n \n @throws\n * The function throws an error if there is a timeout reading the data\n * from the parent application storage.\n \n @returns A promise that resolves to the value\n * of the item in storage or `null` if the item doesn't exist.\n /\nexport async function storageRead(key: string): Promise<string \| null> {\n const parentApp = getParentApplication();\n\n let value: string \| null = null;\n\n try {\n if (parentApp !== null) {\n value = await parentAppRequest(parentApp, StorageAction.Read, {\n key,\n });\n } else {\n value = storage.getItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to read storage item \"${key}\" with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.ReadError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n\n return value;\n}\n\n/\n The function allows to write data to the SDK storage.\n \n @param key - A name of the item to be stored.\n * @param value - A value to be stored.\n \n @throws\n * The function throws an error if there is a timeout writing the data\n * to the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully stored.\n /\nexport async function storageWrite(key: string, value: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Write, {\n key,\n value,\n });\n } else {\n storage.setItem(key, value);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to write storage item \"${key}\" with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.WriteError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to remove an item from the SDK storage.\n \n @param key - A name of the item to be removed.\n \n @throws\n * The function throws an error if there is a timeout removing the data\n * from the parent's application storage.\n \n @returns A promise that resolves to `void` once the data has\n * been successfully removed.\n /\nexport async function storageRemove(key: string): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Remove, { key });\n } else {\n storage.removeItem(key);\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(\n `Unable to remove storage item \"${key}\" with error: ${errorMessage}`,\n );\n\n throw createError(\n StorageError.RemoveError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\n/\n The function allows to clear all data from the SDK storage.\n \n @throws\n * The function throws an error if there is a timeout clearing the parent's\n * application storage.\n \n @returns A promise that resolves to `void` once the data has been\n * successfully cleared.\n */\nexport async function storageClear(): Promise<void> {\n const parentApp = getParentApplication();\n\n try {\n if (parentApp !== null) {\n await parentAppRequest(parentApp, StorageAction.Clear);\n } else {\n storage.clear();\n }\n } catch (err) {\n const errorMessage = getErrorMessage(err);\n\n console.error(`Unable to clear storage with error: ${errorMessage}`);\n\n throw createError(\n StorageError.ClearError,\n StorageErrorMessages,\n errorMessage,\n );\n }\n}\n\nregisterEmbedHook(listenStorageMessages);\n"],"names":[],"mappings":"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"}

package/dist/types.d.ts CHANGED Viewed

@@ -48,6 +48,10 @@ export declare enum StorageError {
      * Indicates an error occurred in the parent app.
      */
     ParentAppError = "parent_app_error",
+    /**
+     * Indicates a timeout occurred when communicating with the parent app.
+     */
+    ParentTimeoutError = "parent_timeout_error",
     /**
      * Indicates an error occurred when reading from the storage.
      */
@@ -70,6 +74,7 @@ export declare enum StorageError {
  */
 export declare const StorageErrorMessages: {
     parent_app_error: (error: string) => string;
+    parent_timeout_error: (error: string) => string;
     read_error: (error: string) => string;
     write_error: (error: string) => string;
     remove_error: (error: string) => string;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@monterosa/sdk-storage-kit",
-  "version": "0.18.7",
+  "version": "0.18.8",
   "description": "Storage Kit for the Monterosa JS SDK",
   "author": "Monterosa <hello@monterosa.co.uk> (https://www.monterosa.co/)",
   "main": "dist/index.cjs.js",
@@ -27,9 +27,9 @@
     "@monterosa/sdk-util": "0.x"
   },
   "dependencies": {
-    "@monterosa/sdk-core": "^0.18.7",
-    "@monterosa/sdk-launcher-kit": "^0.18.7",
-    "@monterosa/sdk-util": "^0.18.7"
+    "@monterosa/sdk-core": "^0.18.8",
+    "@monterosa/sdk-launcher-kit": "^0.18.8",
+    "@monterosa/sdk-util": "^0.18.8"
   },
   "devDependencies": {
     "@rollup/plugin-json": "^4.1.0",
@@ -45,5 +45,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "cee6a1ddf6db6c544cf5b7cb7b349d9be45b3893"
+  "gitHead": "66794ba6e6dccd31382eb63cdd3b3d9307a53974"
 }