@monterosa/sdk-storage-kit 0.18.9 → 0.18.10-local-only-storage.2

package/dist/api.d.ts

@@ -24,6 +24,27 @@ export declare function listenStorageMessages(experience: Experience): Unsubscri
  */
 export declare function parentAppRequest(parentApp: ParentApplication, action: StorageAction.Read, payload?: Payload): Promise<string | null>;
 export declare function parentAppRequest(parentApp: ParentApplication, action: StorageAction.Write | StorageAction.Remove | StorageAction.Clear, payload?: Payload): Promise<undefined>;
+/**
+ * The `setStorageLocalOnly` function allows to control whether the SDK storage
+ * should use only the local context storage, bypassing communication with the
+ * parent application via the bridge.
+ *
+ * @remarks
+ * - When set to `true`, all storage operations (`storageRead`, `storageWrite`,
+ *   `storageRemove`, `storageClear`) will use the local `StorageImpl` directly,
+ *   even when a parent application is detected
+ *
+ * - This is useful when the parent page runs an older version of the SDK that
+ *   does not include the storage-kit, which would otherwise cause a 20-second
+ *   timeout on every storage operation
+ *
+ * - By default, `localOnly` is set to `false`, meaning the bridge will be used
+ *   when a parent application is present
+ *
+ * @param localOnly - Determines whether or not SDK storage should bypass the
+ * parent application bridge and use only local storage.
+ */
+export declare function setStorageLocalOnly(localOnly: boolean): void;
 /**
  * The `setStoragePersistent` function is a simple function that allows to
  * control the persistence of the SDK storage. If the argument `persistent` is

package/dist/index.cjs.js

@@ -68,11 +68,26 @@ function __generator(thisArg, body) {
  * More details on the license can be found at https://www.monterosa.co/sdk/license
  */
 var _a;
+/**
+ * Storage bridge action types used internally to communicate with the parent application.
+ */
 var StorageAction;
 (function (StorageAction) {
+    /**
+     * Read a value from storage.
+     */
     StorageAction["Read"] = "storageRead";
+    /**
+     * Write a value to storage.
+     */
     StorageAction["Write"] = "storageWrite";
+    /**
+     * Remove a value from storage.
+     */
     StorageAction["Remove"] = "storageRemove";
+    /**
+     * Clear all values from storage.
+     */
     StorageAction["Clear"] = "storageClear";
 })(StorageAction || (StorageAction = {}));
 /**
@@ -84,7 +99,7 @@ var StorageAction;
  * try {
  *   // some code that uses the StorageKit
  * } catch (err) {
- *   if (err.code === StorageError.ParentApp) {
+ *   if (err.code === StorageError.ParentAppError) {
  *     // handle parent app error
  *   } else {
  *     // handle other error types
@@ -159,7 +174,18 @@ var StorageImpl = /** @class */ (function () {
         this.memoryStore = {};
         this.accessible = sdkUtil.checkAvailability();
         this._persistent = true;
+        this._localOnly = false;
     }
+    Object.defineProperty(StorageImpl.prototype, "localOnly", {
+        get: function () {
+            return this._localOnly;
+        },
+        set: function (newValue) {
+            this._localOnly = newValue;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(StorageImpl.prototype, "persistent", {
         get: function () {
             return this._persistent;
@@ -301,6 +327,29 @@ function parentAppRequest(parentApp, action, payload) {
         });
     });
 }
+/**
+ * The `setStorageLocalOnly` function allows to control whether the SDK storage
+ * should use only the local context storage, bypassing communication with the
+ * parent application via the bridge.
+ *
+ * @remarks
+ * - When set to `true`, all storage operations (`storageRead`, `storageWrite`,
+ *   `storageRemove`, `storageClear`) will use the local `StorageImpl` directly,
+ *   even when a parent application is detected
+ *
+ * - This is useful when the parent page runs an older version of the SDK that
+ *   does not include the storage-kit, which would otherwise cause a 20-second
+ *   timeout on every storage operation
+ *
+ * - By default, `localOnly` is set to `false`, meaning the bridge will be used
+ *   when a parent application is present
+ *
+ * @param localOnly - Determines whether or not SDK storage should bypass the
+ * parent application bridge and use only local storage.
+ */
+function setStorageLocalOnly(localOnly) {
+    storage.localOnly = localOnly;
+}
 /**
  * The `setStoragePersistent` function is a simple function that allows to
  * control the persistence of the SDK storage. If the argument `persistent` is
@@ -350,7 +399,7 @@ function storageRead(key) {
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 5, , 6]);
-                    if (!(parentApp !== null)) return [3 /*break*/, 3];
+                    if (!(parentApp !== null && !storage.localOnly)) return [3 /*break*/, 3];
                     return [4 /*yield*/, parentAppRequest(parentApp, StorageAction.Read, {
                             key: key,
                         })];
@@ -394,7 +443,7 @@ function storageWrite(key, value) {
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 5, , 6]);
-                    if (!(parentApp !== null)) return [3 /*break*/, 3];
+                    if (!(parentApp !== null && !storage.localOnly)) return [3 /*break*/, 3];
                     return [4 /*yield*/, parentAppRequest(parentApp, StorageAction.Write, {
                             key: key,
                             value: value,
@@ -438,7 +487,7 @@ function storageRemove(key) {
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 5, , 6]);
-                    if (!(parentApp !== null)) return [3 /*break*/, 3];
+                    if (!(parentApp !== null && !storage.localOnly)) return [3 /*break*/, 3];
                     return [4 /*yield*/, parentAppRequest(parentApp, StorageAction.Remove, { key: key })];
                 case 2:
                     _a.sent();
@@ -477,7 +526,7 @@ function storageClear() {
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 5, , 6]);
-                    if (!(parentApp !== null)) return [3 /*break*/, 3];
+                    if (!(parentApp !== null && !storage.localOnly)) return [3 /*break*/, 3];
                     return [4 /*yield*/, parentAppRequest(parentApp, StorageAction.Clear)];
                 case 2:
                     _a.sent();
@@ -500,6 +549,7 @@ sdkLauncherKit.registerEmbedHook(listenStorageMessages);
 
 exports.listenStorageMessages = listenStorageMessages;
 exports.parentAppRequest = parentAppRequest;
+exports.setStorageLocalOnly = setStorageLocalOnly;
 exports.setStoragePersistent = setStoragePersistent;
 exports.storage = storage;
 exports.storageClear = storageClear;

package/dist/index.cjs.js.map

@@ -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 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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"}
+{"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\n/**\n * Storage bridge action types used internally to communicate with the parent application.\n */\nexport enum StorageAction {\n  /**\n   * Read a value from storage.\n   */\n  Read = 'storageRead',\n  /**\n   * Write a value to storage.\n   */\n  Write = 'storageWrite',\n  /**\n   * Remove a value from storage.\n   */\n  Remove = 'storageRemove',\n  /**\n   * Clear all values from storage.\n   */\n  Clear = 'storageClear',\n}\n\n/**\n * Response payload returned from a storage bridge request.\n */\nexport type ResponsePayload = {\n  /**\n   * The storage key that was operated on.\n   */\n  key: string;\n  /**\n   * The value read from storage, or `null` if not found. Only present for read\n   * operations.\n   */\n  value?: string | null;\n  /**\n   * Error message, if the operation failed.\n   */\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.ParentAppError) {\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  private _localOnly: boolean = false;\n\n  set localOnly(newValue: boolean) {\n    this._localOnly = newValue;\n  }\n\n  get localOnly(): boolean {\n    return this._localOnly;\n  }\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 `setStorageLocalOnly` function allows to control whether the SDK storage\n * should use only the local context storage, bypassing communication with the\n * parent application via the bridge.\n *\n * @remarks\n * - When set to `true`, all storage operations (`storageRead`, `storageWrite`,\n *   `storageRemove`, `storageClear`) will use the local `StorageImpl` directly,\n *   even when a parent application is detected\n *\n * - This is useful when the parent page runs an older version of the SDK that\n *   does not include the storage-kit, which would otherwise cause a 20-second\n *   timeout on every storage operation\n *\n * - By default, `localOnly` is set to `false`, meaning the bridge will be used\n *   when a parent application is present\n *\n * @param localOnly - Determines whether or not SDK storage should bypass the\n * parent application bridge and use only local storage.\n */\nexport function setStorageLocalOnly(localOnly: boolean): void {\n  storage.localOnly = localOnly;\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 && !storage.localOnly) {\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 && !storage.localOnly) {\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 && !storage.localOnly) {\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 && !storage.localOnly) {\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.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Persists key-value data across sessions via the parent application.
+ *
+ * @packageDocumentation
+ */
 /**
  * @license
  * index.ts
@@ -7,10 +12,5 @@
  *
  * More details on the license can be found at https://www.monterosa.co/sdk/license
  */
-/**
- * Monterosa SDK / Storage Kit
- *
- * @packageDocumentation
- */
 export * from './api';
 export { StorageError } from './types';

package/dist/index.esm2017.js

@@ -10,11 +10,26 @@ import { registerEmbedHook, onSdkMessage, respondToSdkMessage, sendSdkRequest, B
  *
  * More details on the license can be found at https://www.monterosa.co/sdk/license
  */
+/**
+ * Storage bridge action types used internally to communicate with the parent application.
+ */
 var StorageAction;
 (function (StorageAction) {
+    /**
+     * Read a value from storage.
+     */
     StorageAction["Read"] = "storageRead";
+    /**
+     * Write a value to storage.
+     */
     StorageAction["Write"] = "storageWrite";
+    /**
+     * Remove a value from storage.
+     */
     StorageAction["Remove"] = "storageRemove";
+    /**
+     * Clear all values from storage.
+     */
     StorageAction["Clear"] = "storageClear";
 })(StorageAction || (StorageAction = {}));
 /**
@@ -26,7 +41,7 @@ var StorageAction;
  * try {
  *   // some code that uses the StorageKit
  * } catch (err) {
- *   if (err.code === StorageError.ParentApp) {
+ *   if (err.code === StorageError.ParentAppError) {
  *     // handle parent app error
  *   } else {
  *     // handle other error types
@@ -95,6 +110,13 @@ class StorageImpl {
         this.memoryStore = {};
         this.accessible = checkAvailability();
         this._persistent = true;
+        this._localOnly = false;
+    }
+    set localOnly(newValue) {
+        this._localOnly = newValue;
+    }
+    get localOnly() {
+        return this._localOnly;
     }
     set persistent(newValue) {
         const oldValue = this._persistent;
@@ -221,6 +243,29 @@ async function parentAppRequest(parentApp, action, payload) {
         throw err;
     }
 }
+/**
+ * The `setStorageLocalOnly` function allows to control whether the SDK storage
+ * should use only the local context storage, bypassing communication with the
+ * parent application via the bridge.
+ *
+ * @remarks
+ * - When set to `true`, all storage operations (`storageRead`, `storageWrite`,
+ *   `storageRemove`, `storageClear`) will use the local `StorageImpl` directly,
+ *   even when a parent application is detected
+ *
+ * - This is useful when the parent page runs an older version of the SDK that
+ *   does not include the storage-kit, which would otherwise cause a 20-second
+ *   timeout on every storage operation
+ *
+ * - By default, `localOnly` is set to `false`, meaning the bridge will be used
+ *   when a parent application is present
+ *
+ * @param localOnly - Determines whether or not SDK storage should bypass the
+ * parent application bridge and use only local storage.
+ */
+function setStorageLocalOnly(localOnly) {
+    storage.localOnly = localOnly;
+}
 /**
  * The `setStoragePersistent` function is a simple function that allows to
  * control the persistence of the SDK storage. If the argument `persistent` is
@@ -263,7 +308,7 @@ async function storageRead(key) {
     const parentApp = getParentApplication();
     let value = null;
     try {
-        if (parentApp !== null) {
+        if (parentApp !== null && !storage.localOnly) {
             value = await parentAppRequest(parentApp, StorageAction.Read, {
                 key,
             });
@@ -295,7 +340,7 @@ async function storageRead(key) {
 async function storageWrite(key, value) {
     const parentApp = getParentApplication();
     try {
-        if (parentApp !== null) {
+        if (parentApp !== null && !storage.localOnly) {
             await parentAppRequest(parentApp, StorageAction.Write, {
                 key,
                 value,
@@ -326,7 +371,7 @@ async function storageWrite(key, value) {
 async function storageRemove(key) {
     const parentApp = getParentApplication();
     try {
-        if (parentApp !== null) {
+        if (parentApp !== null && !storage.localOnly) {
             await parentAppRequest(parentApp, StorageAction.Remove, { key });
         }
         else {
@@ -352,7 +397,7 @@ async function storageRemove(key) {
 async function storageClear() {
     const parentApp = getParentApplication();
     try {
-        if (parentApp !== null) {
+        if (parentApp !== null && !storage.localOnly) {
             await parentAppRequest(parentApp, StorageAction.Clear);
         }
         else {
@@ -367,5 +412,5 @@ async function storageClear() {
 }
 registerEmbedHook(listenStorageMessages);
 
-export { StorageError, listenStorageMessages, parentAppRequest, setStoragePersistent, storage, storageClear, storageRead, storageRemove, storageWrite };
+export { StorageError, listenStorageMessages, parentAppRequest, setStorageLocalOnly, setStoragePersistent, storage, storageClear, storageRead, storageRemove, storageWrite };
 //# sourceMappingURL=index.esm2017.js.map

package/dist/index.esm2017.js.map

@@ -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 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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"}
+{"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\n/**\n * Storage bridge action types used internally to communicate with the parent application.\n */\nexport enum StorageAction {\n  /**\n   * Read a value from storage.\n   */\n  Read = 'storageRead',\n  /**\n   * Write a value to storage.\n   */\n  Write = 'storageWrite',\n  /**\n   * Remove a value from storage.\n   */\n  Remove = 'storageRemove',\n  /**\n   * Clear all values from storage.\n   */\n  Clear = 'storageClear',\n}\n\n/**\n * Response payload returned from a storage bridge request.\n */\nexport type ResponsePayload = {\n  /**\n   * The storage key that was operated on.\n   */\n  key: string;\n  /**\n   * The value read from storage, or `null` if not found. Only present for read\n   * operations.\n   */\n  value?: string | null;\n  /**\n   * Error message, if the operation failed.\n   */\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.ParentAppError) {\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  private _localOnly: boolean = false;\n\n  set localOnly(newValue: boolean) {\n    this._localOnly = newValue;\n  }\n\n  get localOnly(): boolean {\n    return this._localOnly;\n  }\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 `setStorageLocalOnly` function allows to control whether the SDK storage\n * should use only the local context storage, bypassing communication with the\n * parent application via the bridge.\n *\n * @remarks\n * - When set to `true`, all storage operations (`storageRead`, `storageWrite`,\n *   `storageRemove`, `storageClear`) will use the local `StorageImpl` directly,\n *   even when a parent application is detected\n *\n * - This is useful when the parent page runs an older version of the SDK that\n *   does not include the storage-kit, which would otherwise cause a 20-second\n *   timeout on every storage operation\n *\n * - By default, `localOnly` is set to `false`, meaning the bridge will be used\n *   when a parent application is present\n *\n * @param localOnly - Determines whether or not SDK storage should bypass the\n * parent application bridge and use only local storage.\n */\nexport function setStorageLocalOnly(localOnly: boolean): void {\n  storage.localOnly = localOnly;\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 && !storage.localOnly) {\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 && !storage.localOnly) {\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 && !storage.localOnly) {\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 && !storage.localOnly) {\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

@@ -1,4 +1,4 @@
-import { setItem, clear, getItem, removeItem, checkAvailability, getErrorMessage, MonterosaError, createError } from '@monterosa/sdk-util';
+import { getItem, setItem, removeItem, clear, checkAvailability, getErrorMessage, MonterosaError, createError } from '@monterosa/sdk-util';
 import { registerEmbedHook, onSdkMessage, respondToSdkMessage, BridgeError, sendSdkRequest, getParentApplication } from '@monterosa/sdk-launcher-kit';
 
 /*! *****************************************************************************
@@ -64,11 +64,26 @@ function __generator(thisArg, body) {
  * More details on the license can be found at https://www.monterosa.co/sdk/license
  */
 var _a;
+/**
+ * Storage bridge action types used internally to communicate with the parent application.
+ */
 var StorageAction;
 (function (StorageAction) {
+    /**
+     * Read a value from storage.
+     */
     StorageAction["Read"] = "storageRead";
+    /**
+     * Write a value to storage.
+     */
     StorageAction["Write"] = "storageWrite";
+    /**
+     * Remove a value from storage.
+     */
     StorageAction["Remove"] = "storageRemove";
+    /**
+     * Clear all values from storage.
+     */
     StorageAction["Clear"] = "storageClear";
 })(StorageAction || (StorageAction = {}));
 /**
@@ -80,7 +95,7 @@ var StorageAction;
  * try {
  *   // some code that uses the StorageKit
  * } catch (err) {
- *   if (err.code === StorageError.ParentApp) {
+ *   if (err.code === StorageError.ParentAppError) {
  *     // handle parent app error
  *   } else {
  *     // handle other error types
@@ -155,7 +170,18 @@ var StorageImpl = /** @class */ (function () {
         this.memoryStore = {};
         this.accessible = checkAvailability();
         this._persistent = true;
+        this._localOnly = false;
     }
+    Object.defineProperty(StorageImpl.prototype, "localOnly", {
+        get: function () {
+            return this._localOnly;
+        },
+        set: function (newValue) {
+            this._localOnly = newValue;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(StorageImpl.prototype, "persistent", {
         get: function () {
             return this._persistent;
@@ -297,6 +323,29 @@ function parentAppRequest(parentApp, action, payload) {
         });
     });
 }
+/**
+ * The `setStorageLocalOnly` function allows to control whether the SDK storage
+ * should use only the local context storage, bypassing communication with the
+ * parent application via the bridge.
+ *
+ * @remarks
+ * - When set to `true`, all storage operations (`storageRead`, `storageWrite`,
+ *   `storageRemove`, `storageClear`) will use the local `StorageImpl` directly,
+ *   even when a parent application is detected
+ *
+ * - This is useful when the parent page runs an older version of the SDK that
+ *   does not include the storage-kit, which would otherwise cause a 20-second
+ *   timeout on every storage operation
+ *
+ * - By default, `localOnly` is set to `false`, meaning the bridge will be used
+ *   when a parent application is present
+ *
+ * @param localOnly - Determines whether or not SDK storage should bypass the
+ * parent application bridge and use only local storage.
+ */
+function setStorageLocalOnly(localOnly) {
+    storage.localOnly = localOnly;
+}
 /**
  * The `setStoragePersistent` function is a simple function that allows to
  * control the persistence of the SDK storage. If the argument `persistent` is
@@ -346,7 +395,7 @@ function storageRead(key) {
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 5, , 6]);
-                    if (!(parentApp !== null)) return [3 /*break*/, 3];
+                    if (!(parentApp !== null && !storage.localOnly)) return [3 /*break*/, 3];
                     return [4 /*yield*/, parentAppRequest(parentApp, StorageAction.Read, {
                             key: key,
                         })];
@@ -390,7 +439,7 @@ function storageWrite(key, value) {
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 5, , 6]);
-                    if (!(parentApp !== null)) return [3 /*break*/, 3];
+                    if (!(parentApp !== null && !storage.localOnly)) return [3 /*break*/, 3];
                     return [4 /*yield*/, parentAppRequest(parentApp, StorageAction.Write, {
                             key: key,
                             value: value,
@@ -434,7 +483,7 @@ function storageRemove(key) {
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 5, , 6]);
-                    if (!(parentApp !== null)) return [3 /*break*/, 3];
+                    if (!(parentApp !== null && !storage.localOnly)) return [3 /*break*/, 3];
                     return [4 /*yield*/, parentAppRequest(parentApp, StorageAction.Remove, { key: key })];
                 case 2:
                     _a.sent();
@@ -473,7 +522,7 @@ function storageClear() {
                     _a.label = 1;
                 case 1:
                     _a.trys.push([1, 5, , 6]);
-                    if (!(parentApp !== null)) return [3 /*break*/, 3];
+                    if (!(parentApp !== null && !storage.localOnly)) return [3 /*break*/, 3];
                     return [4 /*yield*/, parentAppRequest(parentApp, StorageAction.Clear)];
                 case 2:
                     _a.sent();
@@ -494,5 +543,5 @@ function storageClear() {
 }
 registerEmbedHook(listenStorageMessages);
 
-export { StorageError, listenStorageMessages, parentAppRequest, setStoragePersistent, storage, storageClear, storageRead, storageRemove, storageWrite };
+export { StorageError, listenStorageMessages, parentAppRequest, setStorageLocalOnly, setStoragePersistent, storage, storageClear, storageRead, storageRemove, storageWrite };
 //# sourceMappingURL=index.esm5.js.map

package/dist/index.esm5.js.map

@@ -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 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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"}
+{"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\n/**\n * Storage bridge action types used internally to communicate with the parent application.\n */\nexport enum StorageAction {\n  /**\n   * Read a value from storage.\n   */\n  Read = 'storageRead',\n  /**\n   * Write a value to storage.\n   */\n  Write = 'storageWrite',\n  /**\n   * Remove a value from storage.\n   */\n  Remove = 'storageRemove',\n  /**\n   * Clear all values from storage.\n   */\n  Clear = 'storageClear',\n}\n\n/**\n * Response payload returned from a storage bridge request.\n */\nexport type ResponsePayload = {\n  /**\n   * The storage key that was operated on.\n   */\n  key: string;\n  /**\n   * The value read from storage, or `null` if not found. Only present for read\n   * operations.\n   */\n  value?: string | null;\n  /**\n   * Error message, if the operation failed.\n   */\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.ParentAppError) {\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  private _localOnly: boolean = false;\n\n  set localOnly(newValue: boolean) {\n    this._localOnly = newValue;\n  }\n\n  get localOnly(): boolean {\n    return this._localOnly;\n  }\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 `setStorageLocalOnly` function allows to control whether the SDK storage\n * should use only the local context storage, bypassing communication with the\n * parent application via the bridge.\n *\n * @remarks\n * - When set to `true`, all storage operations (`storageRead`, `storageWrite`,\n *   `storageRemove`, `storageClear`) will use the local `StorageImpl` directly,\n *   even when a parent application is detected\n *\n * - This is useful when the parent page runs an older version of the SDK that\n *   does not include the storage-kit, which would otherwise cause a 20-second\n *   timeout on every storage operation\n *\n * - By default, `localOnly` is set to `false`, meaning the bridge will be used\n *   when a parent application is present\n *\n * @param localOnly - Determines whether or not SDK storage should bypass the\n * parent application bridge and use only local storage.\n */\nexport function setStorageLocalOnly(localOnly: boolean): void {\n  storage.localOnly = localOnly;\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 && !storage.localOnly) {\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 && !storage.localOnly) {\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 && !storage.localOnly) {\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 && !storage.localOnly) {\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/sdk-storage-kit.d.ts

@@ -0,0 +1,213 @@
+/**
+ * Persists key-value data across sessions via the parent application.
+ *
+ * @packageDocumentation
+ */
+
+import { Experience } from '@monterosa/sdk-launcher-kit';
+import { ParentApplication } from '@monterosa/sdk-launcher-kit';
+import { Payload } from '@monterosa/sdk-launcher-kit';
+import { Unsubscribe } from '@monterosa/sdk-util';
+
+/**
+ * @internal
+ */
+export declare function listenStorageMessages(experience: Experience): Unsubscribe;
+
+/**
+ * @internal
+ */
+export declare function parentAppRequest(parentApp: ParentApplication, action: StorageAction.Read, payload?: Payload): Promise<string | null>;
+
+export declare function parentAppRequest(parentApp: ParentApplication, action: StorageAction.Write | StorageAction.Remove | StorageAction.Clear, payload?: Payload): Promise<undefined>;
+
+/**
+ * The `setStoragePersistent` function is a simple function that allows to
+ * control the persistence of the SDK storage. If the argument `persistent` is
+ * set to `true`, then the storage will be persistent across browser sessions
+ * and if it is set to `false`, then the storage will save to memory.
+ * It is  important to note that the use of persistent storage may be subject
+ * to laws and regulations, such as those related to data privacy and protection.
+ *
+ * @remarks
+ * - We transition from persistent to memory and memory to persistent in
+ *   a seamless manner for you
+ *
+ * - By default we store in memory
+ *
+ * - The value of storage persistent persists across session (aka put it to true,
+ *   it will remain so, put it back to false, it will remain so)
+ *
+ * - You have the responsibility to comply with any laws and regulations, and
+ *   store only the data if you know it's valid to do so
+ *
+ * @param persistent - Determines whether or not SDK storage should persist
+ * across browser sessions.
+ */
+export declare function setStoragePersistent(persistent: boolean): void;
+
+/**
+ * @internal
+ */
+export declare const storage: StorageImpl;
+
+/**
+ * @license
+ * types.ts
+ * storage-kit
+ *
+ * Copyright © 2025 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+/**
+ * Storage bridge action types used internally to communicate with the parent application.
+ */
+declare enum StorageAction {
+    /**
+     * Read a value from storage.
+     */
+    Read = "storageRead",
+    /**
+     * Write a value to storage.
+     */
+    Write = "storageWrite",
+    /**
+     * Remove a value from storage.
+     */
+    Remove = "storageRemove",
+    /**
+     * Clear all values from storage.
+     */
+    Clear = "storageClear"
+}
+
+/**
+ * The function allows to clear all data from the SDK storage.
+ *
+ * @throws
+ * The function throws an error if there is a timeout clearing the parent's
+ * application storage.
+ *
+ * @returns A promise that resolves to `void` once the data has been
+ * successfully cleared.
+ */
+export declare function storageClear(): Promise<void>;
+
+/**
+ * Defines a set of error codes that may be encountered when using the
+ * Storage kit of the Monterosa SDK.
+ *
+ * @example
+ * ```javascript
+ * try {
+ *   // some code that uses the StorageKit
+ * } catch (err) {
+ *   if (err.code === StorageError.ParentAppError) {
+ *     // handle parent app error
+ *   } else {
+ *     // handle other error types
+ *   }
+ * }
+ * ```
+ *
+ * @remarks
+ * - The `StorageError` enum provides a convenient way to handle errors
+ *   encountered when using the `StorageKit` module. By checking the code
+ *   property of the caught error against the values of the enum, the error
+ *   type can be determined and appropriate action taken.
+ *
+ * - The `StorageError` enum is not intended to be instantiated or extended.
+ */
+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.
+     */
+    ReadError = "read_error",
+    /**
+     * Indicates an error occurred when writing to the storage.
+     */
+    WriteError = "write_error",
+    /**
+     * Indicates an error occurred when removing from the storage.
+     */
+    RemoveError = "remove_error",
+    /**
+     * Indicates an error occurred when clearing the storage.
+     */
+    ClearError = "clear_error"
+}
+
+/**
+ * @license
+ * storage_impl.ts
+ * storage-kit
+ *
+ * Copyright © 2025 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+declare class StorageImpl {
+    private memoryStore;
+    private accessible;
+    private _persistent;
+    set persistent(newValue: boolean);
+    get persistent(): boolean;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+}
+
+/**
+ * The function allows to read data from the SDK storage.
+ *
+ * @param key - The name of the item to be read from storage.
+ *
+ * @throws
+ * The function throws an error if there is a timeout reading the data
+ * from the parent application storage.
+ *
+ * @returns A promise that resolves to the value
+ * of the item in storage or `null` if the item doesn't exist.
+ */
+export declare function storageRead(key: string): Promise<string | null>;
+
+/**
+ * The function allows to remove an item from the SDK storage.
+ *
+ * @param key - A name of the item to be removed.
+ *
+ * @throws
+ * The function throws an error if there is a timeout removing the data
+ * from the parent's application storage.
+ *
+ * @returns A promise that resolves to `void` once the data has
+ * been successfully removed.
+ */
+export declare function storageRemove(key: string): Promise<void>;
+
+/**
+ * The function allows to write data to the SDK storage.
+ *
+ * @param key - A name of the item to be stored.
+ * @param value - A value to be stored.
+ *
+ * @throws
+ * The function throws an error if there is a timeout writing the data
+ * to the parent's application storage.
+ *
+ * @returns A promise that resolves to `void` once the data has
+ * been successfully stored.
+ */
+export declare function storageWrite(key: string, value: string): Promise<void>;
+
+export { }

package/dist/storage_impl.d.ts

@@ -11,6 +11,9 @@ export declare class StorageImpl {
     private memoryStore;
     private accessible;
     private _persistent;
+    private _localOnly;
+    set localOnly(newValue: boolean);
+    get localOnly(): boolean;
     set persistent(newValue: boolean);
     get persistent(): boolean;
     getItem(key: string): string | null;

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.23.0"
+    }
+  ]
+}

package/dist/types.d.ts

@@ -7,15 +7,43 @@
  *
  * More details on the license can be found at https://www.monterosa.co/sdk/license
  */
+/**
+ * Storage bridge action types used internally to communicate with the parent application.
+ */
 export declare enum StorageAction {
+    /**
+     * Read a value from storage.
+     */
     Read = "storageRead",
+    /**
+     * Write a value to storage.
+     */
     Write = "storageWrite",
+    /**
+     * Remove a value from storage.
+     */
     Remove = "storageRemove",
+    /**
+     * Clear all values from storage.
+     */
     Clear = "storageClear"
 }
+/**
+ * Response payload returned from a storage bridge request.
+ */
 export declare type ResponsePayload = {
+    /**
+     * The storage key that was operated on.
+     */
     key: string;
+    /**
+     * The value read from storage, or `null` if not found. Only present for read
+     * operations.
+     */
     value?: string | null;
+    /**
+     * Error message, if the operation failed.
+     */
     error?: string;
 };
 /**
@@ -27,7 +55,7 @@ export declare type ResponsePayload = {
  * try {
  *   // some code that uses the StorageKit
  * } catch (err) {
- *   if (err.code === StorageError.ParentApp) {
+ *   if (err.code === StorageError.ParentAppError) {
  *     // handle parent app error
  *   } else {
  *     // handle other error types

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monterosa/sdk-storage-kit",
-  "version": "0.18.9",
+  "version": "0.18.10-local-only-storage.2",
   "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.9",
-    "@monterosa/sdk-launcher-kit": "^0.18.9",
-    "@monterosa/sdk-util": "^0.18.9"
+    "@monterosa/sdk-core": "^0.18.10-local-only-storage.2",
+    "@monterosa/sdk-launcher-kit": "^0.18.10-local-only-storage.2",
+    "@monterosa/sdk-util": "^0.18.10-local-only-storage.2"
   },
   "devDependencies": {
     "@rollup/plugin-json": "^4.1.0",
@@ -45,5 +45,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "cf8b4ea9ed5e7b9ab5b64456a07c2a78c2b568c0"
+  "gitHead": "e8c9eed1871359b198d7ed25b0af9ee518d376e9"
 }