@rockerone/xprnkit 0.3.2 → 0.3.4

package/build/utils/auth-storage.js

@@ -0,0 +1,216 @@
+/**
+ * Identity proof storage utilities for XPRNKit
+ *
+ * Stores all session entries in a single array per dApp for easy listing.
+ * For production apps, consider using more secure methods like httpOnly cookies or server-side sessions.
+ */
+const XPRNKIT_STORAGE_KEY = "xprnkit-sessions";
+const PROTON_STORAGE_KEY = "proton-storage";
+// Legacy key for backwards compatibility
+const LEGACY_AUTH_KEY = "xprnkit-auth";
+/**
+ * Get the storage key for a dApp's session list
+ */
+function getStorageKey(dAppName) {
+    return `${XPRNKIT_STORAGE_KEY}-${dAppName}`;
+}
+/**
+ * Get legacy storage key for migration
+ */
+function getLegacyStorageKey(dAppName) {
+    return `${LEGACY_AUTH_KEY}-${dAppName}`;
+}
+/**
+ * Migrate data from legacy storage key to new key
+ */
+function migrateFromLegacyStorage(dAppName) {
+    if (typeof window === 'undefined')
+        return;
+    const legacyKey = getLegacyStorageKey(dAppName);
+    const newKey = getStorageKey(dAppName);
+    // Only migrate if legacy exists and new doesn't
+    const legacyData = localStorage.getItem(legacyKey);
+    const newData = localStorage.getItem(newKey);
+    if (legacyData && !newData) {
+        try {
+            // Parse and migrate data, renaming authToken to identityProofToken
+            const entries = JSON.parse(legacyData);
+            const migratedEntries = entries.map(entry => ({
+                ...entry,
+                identityProofToken: entry.identityProofToken ?? entry.authToken ?? null,
+            }));
+            localStorage.setItem(newKey, JSON.stringify(migratedEntries));
+            // Don't remove legacy key - allow gradual migration
+        }
+        catch {
+            // Migration failed, will use empty array
+        }
+    }
+}
+/**
+ * Session storage helper for client-side persistence
+ * All session entries are stored in a single array for easy listing
+ */
+export const sessionStorage = {
+    /**
+     * List all stored session entries for a dApp
+     * Use this to build UI components that display stored sessions
+     */
+    list: (dAppName) => {
+        if (typeof window === 'undefined')
+            return [];
+        // Attempt migration from legacy storage
+        migrateFromLegacyStorage(dAppName);
+        try {
+            const stored = localStorage.getItem(getStorageKey(dAppName));
+            return stored ? JSON.parse(stored) : [];
+        }
+        catch (error) {
+            console.error('sessionStorage.list: Failed to list session entries', error);
+            return [];
+        }
+    },
+    /**
+     * Get a specific session entry
+     */
+    get: (dAppName, auth, chainId) => {
+        const entries = sessionStorage.list(dAppName);
+        return entries.find(e => e.auth.actor === auth.actor &&
+            e.auth.permission === auth.permission &&
+            e.chainId === chainId) || null;
+    },
+    /**
+     * Save or update a session entry
+     */
+    save: (dAppName, entry) => {
+        if (typeof window === 'undefined') {
+            console.warn('sessionStorage.save: localStorage is not available in SSR context');
+            return;
+        }
+        try {
+            const entries = sessionStorage.list(dAppName);
+            const existingIndex = entries.findIndex(e => e.auth.actor === entry.auth.actor &&
+                e.auth.permission === entry.auth.permission &&
+                e.chainId === entry.chainId);
+            if (existingIndex >= 0) {
+                entries[existingIndex] = entry;
+            }
+            else {
+                entries.push(entry);
+            }
+            localStorage.setItem(getStorageKey(dAppName), JSON.stringify(entries));
+        }
+        catch (error) {
+            console.error('sessionStorage.save: Failed to save session entry', error);
+        }
+    },
+    /**
+     * Remove a specific session entry
+     */
+    remove: (dAppName, auth, chainId) => {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            const entries = sessionStorage.list(dAppName);
+            const filtered = entries.filter(e => !(e.auth.actor === auth.actor &&
+                e.auth.permission === auth.permission &&
+                e.chainId === chainId));
+            localStorage.setItem(getStorageKey(dAppName), JSON.stringify(filtered));
+        }
+        catch (error) {
+            console.error('sessionStorage.remove: Failed to remove session entry', error);
+        }
+    },
+    /**
+     * Update only the identity proof token for an existing entry
+     */
+    updateIdentityProofToken: (dAppName, auth, chainId, token) => {
+        if (typeof window === 'undefined')
+            return;
+        const existing = sessionStorage.get(dAppName, auth, chainId);
+        if (existing) {
+            sessionStorage.save(dAppName, { ...existing, identityProofToken: token });
+        }
+    },
+    /**
+     * Clear all session entries for a dApp
+     */
+    clear: (dAppName) => {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            localStorage.removeItem(getStorageKey(dAppName));
+        }
+        catch (error) {
+            console.error('sessionStorage.clear: Failed to clear session entries', error);
+        }
+    },
+    // --- proton-web-sdk storage helpers (read-only) ---
+    /**
+     * Get list of sessions stored by proton-web-sdk
+     */
+    getLinkList: (dAppName) => {
+        if (typeof window === 'undefined')
+            return [];
+        const storageKey = `${PROTON_STORAGE_KEY}-${dAppName}-list`;
+        const stored = localStorage.getItem(storageKey);
+        if (!stored)
+            return [];
+        return JSON.parse(stored);
+    },
+    /**
+     * Get link session data from proton-web-sdk storage
+     */
+    getLink: (dAppName, auth, chainId) => {
+        if (typeof window === 'undefined')
+            return null;
+        const storageKey = `${PROTON_STORAGE_KEY}-${dAppName}-${auth}-${chainId}`;
+        const stored = localStorage.getItem(storageKey);
+        if (!stored)
+            return null;
+        return JSON.parse(stored);
+    },
+    /**
+     * Get serialized session data for restoration
+     */
+    getSerializedSession: (dAppName, auth, chainId) => {
+        if (typeof window === 'undefined')
+            return null;
+        const storageKey = `${PROTON_STORAGE_KEY}-${dAppName}-${auth}-${chainId}`;
+        const stored = localStorage.getItem(storageKey);
+        if (!stored)
+            return null;
+        try {
+            return JSON.parse(stored);
+        }
+        catch {
+            return null;
+        }
+    },
+};
+/**
+ * @deprecated Use sessionStorage instead
+ * Legacy authentication storage helper for backwards compatibility
+ */
+export const authStorage = {
+    /** @deprecated Use sessionStorage.list instead */
+    listAuth: (dAppName) => sessionStorage.list(dAppName),
+    /** @deprecated Use sessionStorage.get instead */
+    getAuth: (dAppName, auth, chainId) => sessionStorage.get(dAppName, auth, chainId),
+    /** @deprecated Use sessionStorage.save instead */
+    saveAuth: (dAppName, entry) => sessionStorage.save(dAppName, entry),
+    /** @deprecated Use sessionStorage.remove instead */
+    removeAuth: (dAppName, auth, chainId) => sessionStorage.remove(dAppName, auth, chainId),
+    /** @deprecated Use sessionStorage.updateIdentityProofToken instead */
+    updateIdentityProofToken: (dAppName, auth, chainId, token) => sessionStorage.updateIdentityProofToken(dAppName, auth, chainId, token),
+    /** @deprecated Use sessionStorage.updateIdentityProofToken instead */
+    updateAuthToken: (dAppName, auth, chainId, authToken) => sessionStorage.updateIdentityProofToken(dAppName, auth, chainId, authToken),
+    /** @deprecated Use sessionStorage.clear instead */
+    clearAuth: (dAppName) => sessionStorage.clear(dAppName),
+    /** @deprecated Use sessionStorage.getLinkList instead */
+    getLinkList: (dAppName) => sessionStorage.getLinkList(dAppName),
+    /** @deprecated Use sessionStorage.getLink instead */
+    getLink: (dAppName, auth, chainId) => sessionStorage.getLink(dAppName, auth, chainId),
+    /** @deprecated Use sessionStorage.getSerializedSession instead */
+    getSerializedSession: (dAppName, auth, chainId) => sessionStorage.getSerializedSession(dAppName, auth, chainId),
+};

package/build/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './token-precision';
 export * from './transaction-errors';
+export * from './auth-storage';

package/build/utils/index.js

@@ -1,2 +1,3 @@
 export * from './token-precision';
 export * from './transaction-errors';
+export * from './auth-storage';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rockerone/xprnkit",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "source": "src/index.ts",
   "main": "build/index.js",
   "type": "module",
@@ -28,6 +28,7 @@
   },
   "dependencies": {
     "@changesets/cli": "^2.29.8",
+    "@greymass/eosio": "^0.7.0",
     "@proton/api": "^28.7.1",
     "@proton/js": "^28.0.0",
     "@proton/web-sdk": "^4.2.19",