even-toolkit 1.5.6 → 1.5.8

package/dist/glasses/storage.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Persistent storage for Even Hub apps.
+ *
+ * The Even Hub WebView doesn't persist browser localStorage across app restarts.
+ * This module uses the SDK's `bridge.setLocalStorage/getLocalStorage` which DO persist,
+ * with browser localStorage as a sync-read cache and fallback for web/dev.
+ *
+ * Usage:
+ *   import { storageSet, storageGetSync, hydrateFromSDK } from 'even-toolkit/storage';
+ *
+ *   // In main.tsx — hydrate before render:
+ *   hydrateFromSDK(['my-app:settings', 'my-app:data']).finally(() => {
+ *     createRoot(...).render(<App />);
+ *   });
+ *
+ *   // Read (synchronous):
+ *   const data = storageGetSync<MyData>('my-app:data', defaultValue);
+ *
+ *   // Write (dual-write to localStorage + SDK bridge):
+ *   storageSet('my-app:data', data);
+ */
+/**
+ * Read a JSON value synchronously from browser localStorage.
+ * Call `hydrateFromSDK()` at startup to ensure localStorage has the latest SDK data.
+ */
+export declare function storageGetSync<T>(key: string, fallback: T): T;
+/**
+ * Write a JSON-serializable value to both localStorage and SDK bridge.
+ */
+export declare function storageSet(key: string, value: unknown): void;
+/**
+ * Write a raw string value to both localStorage and SDK bridge.
+ * Use for pre-serialized or encrypted values that shouldn't be double-stringified.
+ */
+export declare function storageSetRaw(key: string, value: string): void;
+/**
+ * Remove a key from both localStorage and SDK bridge.
+ */
+export declare function storageRemove(key: string): void;
+/**
+ * Hydrate browser localStorage from SDK bridge on app startup.
+ * Call once before React renders so `storageGetSync` reads fresh data.
+ *
+ * @param keys - All storage keys used by the app
+ */
+export declare function hydrateFromSDK(keys: string[]): Promise<void>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/glasses/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../glasses/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAM7D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAO5D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAM9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAM/C;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAYlE"}

package/dist/glasses/storage.js

@@ -0,0 +1,96 @@
+/**
+ * Persistent storage for Even Hub apps.
+ *
+ * The Even Hub WebView doesn't persist browser localStorage across app restarts.
+ * This module uses the SDK's `bridge.setLocalStorage/getLocalStorage` which DO persist,
+ * with browser localStorage as a sync-read cache and fallback for web/dev.
+ *
+ * Usage:
+ *   import { storageSet, storageGetSync, hydrateFromSDK } from 'even-toolkit/storage';
+ *
+ *   // In main.tsx — hydrate before render:
+ *   hydrateFromSDK(['my-app:settings', 'my-app:data']).finally(() => {
+ *     createRoot(...).render(<App />);
+ *   });
+ *
+ *   // Read (synchronous):
+ *   const data = storageGetSync<MyData>('my-app:data', defaultValue);
+ *
+ *   // Write (dual-write to localStorage + SDK bridge):
+ *   storageSet('my-app:data', data);
+ */
+function getBridge() {
+    return window.__evenBridge ?? null;
+}
+/**
+ * Read a JSON value synchronously from browser localStorage.
+ * Call `hydrateFromSDK()` at startup to ensure localStorage has the latest SDK data.
+ */
+export function storageGetSync(key, fallback) {
+    try {
+        const raw = localStorage.getItem(key);
+        if (raw)
+            return JSON.parse(raw);
+    }
+    catch { /* ignore */ }
+    return fallback;
+}
+/**
+ * Write a JSON-serializable value to both localStorage and SDK bridge.
+ */
+export function storageSet(key, value) {
+    const json = JSON.stringify(value);
+    try {
+        localStorage.setItem(key, json);
+    }
+    catch { /* ignore */ }
+    const bridge = getBridge();
+    if (bridge?.setLocalStorage) {
+        bridge.setLocalStorage(key, json).catch(() => { });
+    }
+}
+/**
+ * Write a raw string value to both localStorage and SDK bridge.
+ * Use for pre-serialized or encrypted values that shouldn't be double-stringified.
+ */
+export function storageSetRaw(key, value) {
+    try {
+        localStorage.setItem(key, value);
+    }
+    catch { /* ignore */ }
+    const bridge = getBridge();
+    if (bridge?.setLocalStorage) {
+        bridge.setLocalStorage(key, value).catch(() => { });
+    }
+}
+/**
+ * Remove a key from both localStorage and SDK bridge.
+ */
+export function storageRemove(key) {
+    localStorage.removeItem(key);
+    const bridge = getBridge();
+    if (bridge?.setLocalStorage) {
+        bridge.setLocalStorage(key, '').catch(() => { });
+    }
+}
+/**
+ * Hydrate browser localStorage from SDK bridge on app startup.
+ * Call once before React renders so `storageGetSync` reads fresh data.
+ *
+ * @param keys - All storage keys used by the app
+ */
+export async function hydrateFromSDK(keys) {
+    const bridge = getBridge();
+    if (!bridge?.getLocalStorage)
+        return;
+    for (const key of keys) {
+        try {
+            const value = await bridge.getLocalStorage(key);
+            if (value && value !== '') {
+                localStorage.setItem(key, value);
+            }
+        }
+        catch { /* ignore */ }
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/glasses/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../glasses/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,SAAS,SAAS;IAChB,OAAQ,MAAc,CAAC,YAAY,IAAI,IAAI,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAI,GAAW,EAAE,QAAW;IACxD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,GAAG;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,KAAc;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC;QAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,EAAE,eAAe,EAAE,CAAC;QAC5B,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,KAAa;IACtD,IAAI,CAAC;QAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,EAAE,eAAe,EAAE,CAAC;QAC5B,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,EAAE,eAAe,EAAE,CAAC;QAC5B,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc;IACjD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC,MAAM,EAAE,eAAe;QAAE,OAAO;IAErC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAChD,IAAI,KAAK,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBAC1B,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/glasses/storage.ts

@@ -0,0 +1,92 @@
+/**
+ * Persistent storage for Even Hub apps.
+ *
+ * The Even Hub WebView doesn't persist browser localStorage across app restarts.
+ * This module uses the SDK's `bridge.setLocalStorage/getLocalStorage` which DO persist,
+ * with browser localStorage as a sync-read cache and fallback for web/dev.
+ *
+ * Usage:
+ *   import { storageSet, storageGetSync, hydrateFromSDK } from 'even-toolkit/storage';
+ *
+ *   // In main.tsx — hydrate before render:
+ *   hydrateFromSDK(['my-app:settings', 'my-app:data']).finally(() => {
+ *     createRoot(...).render(<App />);
+ *   });
+ *
+ *   // Read (synchronous):
+ *   const data = storageGetSync<MyData>('my-app:data', defaultValue);
+ *
+ *   // Write (dual-write to localStorage + SDK bridge):
+ *   storageSet('my-app:data', data);
+ */
+
+function getBridge(): any {
+  return (window as any).__evenBridge ?? null;
+}
+
+/**
+ * Read a JSON value synchronously from browser localStorage.
+ * Call `hydrateFromSDK()` at startup to ensure localStorage has the latest SDK data.
+ */
+export function storageGetSync<T>(key: string, fallback: T): T {
+  try {
+    const raw = localStorage.getItem(key);
+    if (raw) return JSON.parse(raw);
+  } catch { /* ignore */ }
+  return fallback;
+}
+
+/**
+ * Write a JSON-serializable value to both localStorage and SDK bridge.
+ */
+export function storageSet(key: string, value: unknown): void {
+  const json = JSON.stringify(value);
+  try { localStorage.setItem(key, json); } catch { /* ignore */ }
+  const bridge = getBridge();
+  if (bridge?.setLocalStorage) {
+    bridge.setLocalStorage(key, json).catch(() => {});
+  }
+}
+
+/**
+ * Write a raw string value to both localStorage and SDK bridge.
+ * Use for pre-serialized or encrypted values that shouldn't be double-stringified.
+ */
+export function storageSetRaw(key: string, value: string): void {
+  try { localStorage.setItem(key, value); } catch { /* ignore */ }
+  const bridge = getBridge();
+  if (bridge?.setLocalStorage) {
+    bridge.setLocalStorage(key, value).catch(() => {});
+  }
+}
+
+/**
+ * Remove a key from both localStorage and SDK bridge.
+ */
+export function storageRemove(key: string): void {
+  localStorage.removeItem(key);
+  const bridge = getBridge();
+  if (bridge?.setLocalStorage) {
+    bridge.setLocalStorage(key, '').catch(() => {});
+  }
+}
+
+/**
+ * Hydrate browser localStorage from SDK bridge on app startup.
+ * Call once before React renders so `storageGetSync` reads fresh data.
+ *
+ * @param keys - All storage keys used by the app
+ */
+export async function hydrateFromSDK(keys: string[]): Promise<void> {
+  const bridge = getBridge();
+  if (!bridge?.getLocalStorage) return;
+
+  for (const key of keys) {
+    try {
+      const value = await bridge.getLocalStorage(key);
+      if (value && value !== '') {
+        localStorage.setItem(key, value);
+      }
+    } catch { /* ignore */ }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "even-toolkit",
-  "version": "1.5.6",
+  "version": "1.5.8",
   "bin": {
     "even-toolkit": "./bin/create.js"
   },
@@ -77,6 +77,10 @@
       "types": "./dist/glasses/splash.d.ts",
       "import": "./dist/glasses/splash.js"
     },
+    "./storage": {
+      "types": "./dist/glasses/storage.d.ts",
+      "import": "./dist/glasses/storage.js"
+    },
     "./text-clean": {
       "types": "./dist/glasses/text-clean.d.ts",
       "import": "./dist/glasses/text-clean.js"