@take-out/helpers 0.0.35 → 0.0.37

package/types/storage/storage.test.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "",
+  "names": [],
+  "sources": [
+    "src/storage/storage.test.ts"
+  ],
+  "sourcesContent": [
+    "import { beforeEach, describe, expect, it } from 'vitest'\n\nimport { createStorage } from './createStorage'\nimport { getStorageDriver, setStorageDriver } from './driver'\n\n// test the storage driver system to ensure it works correctly\n// this regression test validates that the storage system initializes properly\n// which is critical for native auth to work\n\ndescribe('storage driver system', () => {\n  describe('driver initialization', () => {\n    it('getStorageDriver should return localStorage fallback on web', () => {\n      // web environment has localStorage which should be used as fallback\n      const driver = getStorageDriver()\n      // in node/vitest environment, localStorage might not exist\n      // but if it does, the driver should work\n      if (typeof localStorage !== 'undefined') {\n        expect(driver).toBeTruthy()\n      }\n    })\n\n    it('should use custom driver when set', () => {\n      const mockStorage = new Map<string, string>()\n      const mockDriver = {\n        getItem: (key: string) => mockStorage.get(key) ?? null,\n        setItem: (key: string, value: string) => mockStorage.set(key, value),\n        removeItem: (key: string) => mockStorage.delete(key),\n        getAllKeys: () => Array.from(mockStorage.keys()),\n      }\n\n      setStorageDriver(mockDriver)\n      const driver = getStorageDriver()\n      expect(driver).toBe(mockDriver)\n    })\n  })\n\n  describe('createStorage with driver', () => {\n    let mockStorage: Map<string, string>\n\n    beforeEach(() => {\n      mockStorage = new Map<string, string>()\n      const mockDriver = {\n        getItem: (key: string) => mockStorage.get(key) ?? null,\n        setItem: (key: string, value: string) => mockStorage.set(key, value),\n        removeItem: (key: string) => mockStorage.delete(key),\n        getAllKeys: () => Array.from(mockStorage.keys()),\n      }\n      setStorageDriver(mockDriver)\n    })\n\n    it('should store and retrieve values', () => {\n      const storage = createStorage<'token', string>(`test-${Date.now()}-1`)\n      storage.set('token', 'test-value')\n      expect(storage.get('token')).toBe('test-value')\n    })\n\n    it('should use namespace prefix', () => {\n      const namespace = `test-${Date.now()}-2`\n      const storage = createStorage<'key', string>(namespace)\n      storage.set('key', 'value')\n\n      // verify the key in the underlying storage has the namespace prefix\n      expect(mockStorage.has(`${namespace}:key`)).toBe(true)\n    })\n\n    it('should handle JSON serialization', () => {\n      const storage = createStorage<'obj', { name: string; count: number }>(\n        `test-${Date.now()}-3`\n      )\n      const obj = { name: 'test', count: 42 }\n      storage.set('obj', obj)\n      expect(storage.get('obj')).toEqual(obj)\n    })\n\n    it('should support raw string operations', () => {\n      const storage = createStorage<'raw', string>(`test-${Date.now()}-4`)\n      storage.setItem('raw', 'raw-value')\n      expect(storage.getItem('raw')).toBe('raw-value')\n    })\n\n    it('should return undefined for missing keys', () => {\n      const storage = createStorage<'missing', string>(`test-${Date.now()}-5`)\n      expect(storage.get('missing')).toBeUndefined()\n    })\n\n    it('should support has() check', () => {\n      const storage = createStorage<'exists', string>(`test-${Date.now()}-6`)\n      expect(storage.has('exists')).toBe(false)\n      storage.set('exists', 'value')\n      expect(storage.has('exists')).toBe(true)\n    })\n\n    it('should support remove()', () => {\n      const storage = createStorage<'removable', string>(`test-${Date.now()}-7`)\n      storage.set('removable', 'value')\n      expect(storage.has('removable')).toBe(true)\n      storage.remove('removable')\n      expect(storage.has('removable')).toBe(false)\n    })\n\n    it('should list keys in namespace', () => {\n      const storage = createStorage<'a' | 'b' | 'c', string>(`test-${Date.now()}-8`)\n      storage.set('a', '1')\n      storage.set('b', '2')\n      storage.set('c', '3')\n      expect(storage.keys().sort()).toEqual(['a', 'b', 'c'])\n    })\n\n    it('should clear only namespace keys', () => {\n      const ns1 = `test-${Date.now()}-9a`\n      const ns2 = `test-${Date.now()}-9b`\n      const storage1 = createStorage<'key', string>(ns1)\n      const storage2 = createStorage<'key', string>(ns2)\n\n      storage1.set('key', 'value1')\n      storage2.set('key', 'value2')\n\n      storage1.clear()\n\n      expect(storage1.has('key')).toBe(false)\n      expect(storage2.has('key')).toBe(true)\n    })\n  })\n\n  describe('createStorage without driver (simulates native without setup)', () => {\n    // this test simulates what happens on native when setupStorage.native.ts\n    // is not imported before auth initialization\n\n    it('should handle gracefully when operations fail', () => {\n      // when driver returns null, operations should not throw\n      // they should just silently fail (return undefined, do nothing)\n      // this is the current behavior but we want to document it\n      const storage = createStorage<'key', string>(`test-no-driver-${Date.now()}`)\n\n      // these should not throw even without a driver\n      expect(() => storage.get('key')).not.toThrow()\n      expect(() => storage.set('key', 'value')).not.toThrow()\n      expect(() => storage.remove('key')).not.toThrow()\n      expect(() => storage.has('key')).not.toThrow()\n      expect(() => storage.keys()).not.toThrow()\n      expect(() => storage.clear()).not.toThrow()\n      expect(() => storage.getItem('key')).not.toThrow()\n      expect(() => storage.setItem('key', 'value')).not.toThrow()\n    })\n  })\n})\n\ndescribe('auth storage requirements', () => {\n  // these tests document the requirements for auth storage to work correctly\n\n  it('storage must be initialized before auth client creates storage instances', () => {\n    // the expo auth client creates storage at module load time:\n    // const expoStorage = createStorage('expo-auth-client')\n    //\n    // if setStorageDriver is not called before this, storage operations will fail\n    // this is why setupClient.ts must run before any auth code\n\n    // we verify this requirement is documented and understood\n    expect(true).toBe(true)\n  })\n\n  it('native platforms require explicit storage driver setup', () => {\n    // unlike web which has localStorage fallback, native platforms need\n    // MMKV or AsyncStorage to be configured via setStorageDriver()\n    //\n    // this happens in setupStorage.native.ts which must be imported\n    // before platformClient.native.ts creates its storage instance\n\n    // we verify this requirement is documented and understood\n    expect(true).toBe(true)\n  })\n})\n"
+  ],
+  "version": 3
+}

package/src/storage/index.ts

@@ -1,4 +0,0 @@
-export { createStorage, createStorageValue } from './createStorage'
-export type { Storage, StorageValue } from './createStorage'
-export { getStorageDriver, setStorageDriver } from './driver'
-export type { StorageDriver } from './types'