handhold-sdk 1.0.0

package/src/session/SessionStorage.js

@@ -0,0 +1,148 @@
+/**
+ * Hand Hold SDK - SessionStorage Wrapper
+ * Safe wrapper around browser's sessionStorage with fallback
+ */
+
+class SessionStorageWrapper {
+  constructor() {
+    this.prefix = 'handhold_';
+    this.memoryFallback = {};
+    this.useMemory = !this._isSessionStorageAvailable();
+  }
+
+  /**
+   * Check if sessionStorage is available
+   */
+  _isSessionStorageAvailable() {
+    try {
+      const testKey = '__handhold_test__';
+      window.sessionStorage.setItem(testKey, 'test');
+      window.sessionStorage.removeItem(testKey);
+      return true;
+    } catch (e) {
+      console.warn('[HandHold] sessionStorage not available, using memory fallback');
+      return false;
+    }
+  }
+
+  /**
+   * Get prefixed key
+   */
+  _getKey(key) {
+    return `${this.prefix}${key}`;
+  }
+
+  /**
+   * Set item
+   * @param {string} key - Storage key
+   * @param {*} value - Value to store (will be JSON serialized)
+   */
+  set(key, value) {
+    const prefixedKey = this._getKey(key);
+    const serialized = JSON.stringify(value);
+
+    if (this.useMemory) {
+      this.memoryFallback[prefixedKey] = serialized;
+    } else {
+      try {
+        window.sessionStorage.setItem(prefixedKey, serialized);
+      } catch (e) {
+        // Quota exceeded or other error - fall back to memory
+        console.warn('[HandHold] sessionStorage.setItem failed, using memory');
+        this.memoryFallback[prefixedKey] = serialized;
+      }
+    }
+  }
+
+  /**
+   * Get item
+   * @param {string} key - Storage key
+   * @returns {*} - Parsed value or null
+   */
+  get(key) {
+    const prefixedKey = this._getKey(key);
+    let value;
+
+    if (this.useMemory) {
+      value = this.memoryFallback[prefixedKey];
+    } else {
+      value = window.sessionStorage.getItem(prefixedKey);
+    }
+
+    if (value === null || value === undefined) {
+      return null;
+    }
+
+    try {
+      return JSON.parse(value);
+    } catch (e) {
+      return value;
+    }
+  }
+
+  /**
+   * Remove item
+   * @param {string} key - Storage key
+   */
+  remove(key) {
+    const prefixedKey = this._getKey(key);
+
+    if (this.useMemory) {
+      delete this.memoryFallback[prefixedKey];
+    } else {
+      window.sessionStorage.removeItem(prefixedKey);
+    }
+  }
+
+  /**
+   * Check if key exists
+   * @param {string} key - Storage key
+   * @returns {boolean}
+   */
+  has(key) {
+    return this.get(key) !== null;
+  }
+
+  /**
+   * Clear all Hand Hold items
+   */
+  clear() {
+    if (this.useMemory) {
+      this.memoryFallback = {};
+    } else {
+      const keysToRemove = [];
+      for (let i = 0; i < window.sessionStorage.length; i++) {
+        const key = window.sessionStorage.key(i);
+        if (key && key.startsWith(this.prefix)) {
+          keysToRemove.push(key);
+        }
+      }
+      keysToRemove.forEach(key => window.sessionStorage.removeItem(key));
+    }
+  }
+
+  /**
+   * Get all Hand Hold keys
+   * @returns {string[]}
+   */
+  keys() {
+    const keys = [];
+    
+    if (this.useMemory) {
+      Object.keys(this.memoryFallback)
+        .filter(k => k.startsWith(this.prefix))
+        .forEach(k => keys.push(k.replace(this.prefix, '')));
+    } else {
+      for (let i = 0; i < window.sessionStorage.length; i++) {
+        const key = window.sessionStorage.key(i);
+        if (key && key.startsWith(this.prefix)) {
+          keys.push(key.replace(this.prefix, ''));
+        }
+      }
+    }
+    
+    return keys;
+  }
+}
+
+export default SessionStorageWrapper;