@el7ven/cookie-kit 0.3.1 → 0.3.3

package/src/core/StorageAdapter.js

@@ -0,0 +1,179 @@
+/**
+ * Safe Storage Adapter — handles localStorage failures (Safari private mode, quota exceeded)
+ * @module StorageAdapter
+ */
+
+export class StorageAdapter {
+  constructor(config = {}) {
+    this.storageType = config.storageType || 'localStorage'
+    this.storageKey = config.storageKey || 'cookie_consent'
+    this.cookieExpireDays = config.consentExpireDays || 365
+    this._testStorage()
+  }
+
+  /**
+   * Test if storage is available (Safari private mode blocks localStorage)
+   */
+  _testStorage() {
+    this.isLocalStorageAvailable = false
+    this.isCookieAvailable = false
+
+    // Test localStorage
+    if (typeof window !== 'undefined' && window.localStorage) {
+      try {
+        const testKey = '__storage_test__'
+        localStorage.setItem(testKey, 'test')
+        localStorage.removeItem(testKey)
+        this.isLocalStorageAvailable = true
+      } catch (e) {
+        console.warn('[StorageAdapter] localStorage not available:', e.message)
+      }
+    }
+
+    // Test cookies
+    if (typeof document !== 'undefined') {
+      try {
+        document.cookie = '__cookie_test__=test; path=/; SameSite=Lax'
+        this.isCookieAvailable = document.cookie.includes('__cookie_test__')
+        document.cookie = '__cookie_test__=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;'
+      } catch (e) {
+        console.warn('[StorageAdapter] Cookies not available:', e.message)
+      }
+    }
+  }
+
+  /**
+   * Get data from storage
+   */
+  get(key = null) {
+    const storageKey = key || this.storageKey
+
+    try {
+      // Try localStorage first
+      if (this.storageType === 'localStorage' || this.storageType === 'both') {
+        if (this.isLocalStorageAvailable) {
+          const value = localStorage.getItem(storageKey)
+          if (value) return value
+        }
+      }
+
+      // Fallback to cookies
+      if (this.storageType === 'cookie' || this.storageType === 'both') {
+        if (this.isCookieAvailable) {
+          return this._readCookie(storageKey)
+        }
+      }
+
+      return null
+    } catch (e) {
+      console.error('[StorageAdapter] Error reading storage:', e)
+      return null
+    }
+  }
+
+  /**
+   * Set data to storage
+   */
+  set(key, value) {
+    const storageKey = typeof key === 'string' ? key : this.storageKey
+    const data = typeof key === 'string' ? value : key
+
+    // Validate data before saving
+    if (data === null || data === undefined) {
+      console.warn('[StorageAdapter] Attempted to save null/undefined data, skipping')
+      return false
+    }
+    
+    if (typeof data === 'string' && (data === 'null' || data === 'undefined')) {
+      console.warn('[StorageAdapter] Attempted to save literal "null"/"undefined" string, skipping')
+      return false
+    }
+
+    try {
+      // Try localStorage
+      if (this.storageType === 'localStorage' || this.storageType === 'both') {
+        if (this.isLocalStorageAvailable) {
+          try {
+            localStorage.setItem(storageKey, data)
+          } catch (e) {
+            // Quota exceeded — try to clear old data
+            if (e.name === 'QuotaExceededError') {
+              console.warn('[StorageAdapter] localStorage quota exceeded, falling back to cookies')
+              this.isLocalStorageAvailable = false
+            }
+          }
+        }
+      }
+
+      // Fallback to cookies
+      if (this.storageType === 'cookie' || this.storageType === 'both') {
+        if (this.isCookieAvailable) {
+          this._writeCookie(storageKey, data, this.cookieExpireDays)
+        }
+      }
+
+      return true
+    } catch (e) {
+      console.error('[StorageAdapter] Error writing storage:', e)
+      return false
+    }
+  }
+
+  /**
+   * Remove data from storage
+   */
+  remove(key = null) {
+    const storageKey = key || this.storageKey
+
+    try {
+      // Remove from localStorage
+      if (this.storageType === 'localStorage' || this.storageType === 'both') {
+        if (this.isLocalStorageAvailable) {
+          localStorage.removeItem(storageKey)
+        }
+      }
+
+      // Remove from cookies
+      if (this.storageType === 'cookie' || this.storageType === 'both') {
+        if (this.isCookieAvailable) {
+          this._writeCookie(storageKey, '', -1)
+        }
+      }
+
+      return true
+    } catch (e) {
+      console.error('[StorageAdapter] Error removing storage:', e)
+      return false
+    }
+  }
+
+  /**
+   * Check if storage is available
+   */
+  isAvailable() {
+    return this.isLocalStorageAvailable || this.isCookieAvailable
+  }
+
+  /**
+   * Get storage type being used
+   */
+  getActiveStorageType() {
+    if (this.isLocalStorageAvailable) return 'localStorage'
+    if (this.isCookieAvailable) return 'cookie'
+    return 'none'
+  }
+
+  // --- Cookie helpers ---
+
+  _readCookie(name) {
+    if (typeof document === 'undefined') return null
+    const match = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)'))
+    return match ? decodeURIComponent(match[2]) : null
+  }
+
+  _writeCookie(name, value, days) {
+    if (typeof document === 'undefined') return
+    const expires = new Date(Date.now() + days * 864e5).toUTCString()
+    document.cookie = `${name}=${encodeURIComponent(value)}; expires=${expires}; path=/; SameSite=Lax`
+  }
+}

package/src/core/index.js

@@ -225,7 +225,7 @@ export class CookieKitCore {
     const next = {}
     Object.keys(this.config.categories).forEach(id => {
       const category = this.config.categories[id]
-      if (category?.enabled !== false) {
+      if (category?.enabled === true) {
         next[id] = !!category.required
       }
     })
@@ -270,7 +270,7 @@ export class CookieKitCore {
   acceptAll(source = 'banner') {
     const categories = {}
     Object.keys(this.config.categories).forEach(id => {
-      if (this.config.categories[id]?.enabled !== false) {
+      if (this.config.categories[id]?.enabled === true) {
         categories[id] = true
       }
     })
@@ -281,7 +281,7 @@ export class CookieKitCore {
     const categories = {}
     Object.keys(this.config.categories).forEach(id => {
       const category = this.config.categories[id]
-      if (category?.enabled !== false) {
+      if (category?.enabled === true) {
         categories[id] = !!category.required
       }
     })
@@ -293,7 +293,7 @@ export class CookieKitCore {
     const categories = {}
     Object.keys(this.config.categories).forEach(id => {
       const category = this.config.categories[id]
-      if (category?.enabled !== false) {
+      if (category?.enabled === true) {
         categories[id] = selectedSet.has(id) || !!category.required
       }
     })