Open History to see the last commit
1import { BaseStorageAdapter } from './StorageAdapter'
2
3export class LocalStorageAdapter extends BaseStorageAdapter {
4 private prefix: string
5
6 constructor(prefix = `offline-tx:`) {
7 super()
8 this.prefix = prefix
9 }
10
11 /**
12 * Probe localStorage availability by attempting a test write.
13 * This catches private mode and other restrictions that block localStorage.
14 */
15 static probe(): { available: boolean; error?: Error } {
16 // Check if localStorage exists
17 if (typeof localStorage === `undefined`) {
18 return {
19 available: false,
20 error: new Error(`localStorage is not available in this environment`),
21 }
22 }
23
24 // Try to actually write/read/delete to verify it works
25 try {
26 const testKey = `__offline-tx-probe__`
27 const testValue = `test`
28
29 localStorage.setItem(testKey, testValue)
30 const retrieved = localStorage.getItem(testKey)
31 localStorage.removeItem(testKey)
32
33 if (retrieved !== testValue) {
34 return {
35 available: false,
36 error: new Error(`localStorage read/write verification failed`),
37 }
38 }
39
40 return { available: true }
41 } catch (error) {
42 return {
43 available: false,
44 error: error instanceof Error ? error : new Error(String(error)),
45 }
46 }
47 }
48
49 private getKey(key: string): string {
50 return `${this.prefix}${key}`
51 }
52
53 get(key: string): Promise<string | null> {
54 try {
55 return Promise.resolve(localStorage.getItem(this.getKey(key)))
56 } catch (error) {
57 console.warn(`localStorage get failed:`, error)
58 return Promise.resolve(null)
59 }
60 }
61
62 set(key: string, value: string): Promise<void> {
63 try {
64 localStorage.setItem(this.getKey(key), value)
65 return Promise.resolve()
66 } catch (error) {
67 if (
68 error instanceof DOMException &&
69 error.name === `QuotaExceededError`
70 ) {
71 return Promise.reject(
72 new Error(
73 `Storage quota exceeded. Consider clearing old transactions.`,
74 ),
75 )
76 }
77 return Promise.reject(error)
78 }
79 }
80
81 delete(key: string): Promise<void> {
82 try {
83 localStorage.removeItem(this.getKey(key))
84 return Promise.resolve()
85 } catch (error) {
86 console.warn(`localStorage delete failed:`, error)
87 return Promise.resolve()
88 }
89 }
90
91 keys(): Promise<Array<string>> {
92 try {
93 const keys: Array<string> = []
94 for (let i = 0; i < localStorage.length; i++) {
95 const key = localStorage.key(i)
96 if (key && key.startsWith(this.prefix)) {
97 keys.push(key.slice(this.prefix.length))
98 }
99 }
100 return Promise.resolve(keys)
101 } catch (error) {
102 console.warn(`localStorage keys failed:`, error)
103 return Promise.resolve([])
104 }
105 }
106
107 async clear(): Promise<void> {
108 try {
109 const keys = await this.keys()
110 for (const key of keys) {
111 localStorage.removeItem(this.getKey(key))
112 }
113 } catch (error) {
114 console.warn(`localStorage clear failed:`, error)
115 }
116 }
117}