@makefully/adaptfully 3.0.3 → 3.1.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project are documented in this file.
 
+## 3.1.0 — 2026-06-18
+
+### Added
+
+- Built-in storage plugins: `localStorage` (sync) and `indexedDB` (async).
+- Register with `"storage": "localStorage"` or `"storage": "indexedDB"` in `config.platforms.<platform>.registrations`.
+
+### Changed
+
+- Auth helpers use registered `storage` only (no implicit fallbacks).
+
 ## 3.0.3 — 2026-06-18
 
 ### Added

package/README.md

@@ -45,6 +45,21 @@ const platform = adaptfully.get('auth');
 platform.login(function (result) { /* ... */ });
 ```
 
+### Storage plugins
+
+| Plugin key | Registration | Runtime |
+|------------|--------------|---------|
+| `localStorage` | `adaptfully.register('storage', adaptfully.storage.LocalStorage())` | Sync key/value storage in the browser |
+| `indexedDB` | `adaptfully.register('storage', adaptfully.storage.IndexedDB())` | Async key/value storage for larger payloads |
+
+In-game:
+
+```javascript
+const storage = adaptfully.get('storage');
+storage.set('playerName', 'Ada');
+storage.getObject('currentGame');
+```
+
 ### Auth plugins
 
 | Plugin key | Registration | Runtime |
@@ -61,18 +76,19 @@ Use plugin keys in `config.platforms.<platform>.registrations`. Custom deploy sc
     "platforms": {
       "steam": {
         "registrations": {
-          "auth": "steam-auth",
-          "storage": "/javascript/custom-storage-solution.js"
+          "storage": "localStorage",
+          "auth": "steam-auth"
         }
       },
       "web": {
         "registrations": {
-          "auth": "google-auth",
-          "storage": "javascript/adaptfully-bridge.js"
+          "storage": "localStorage",
+          "auth": "google-auth"
         }
       },
       "dev": {
         "registrations": {
+          "storage": "localStorage",
           "auth": "dev-auth"
         }
       }

package/lib/node/registrations.js

@@ -25,6 +25,14 @@ export const STANDARD_PLUGINS = {
         scripts: ['core.js', 'platform.js', 'auth/_helpers.js', 'auth/dev-auth.js'],
         registration: (key) => `adaptfully.register('${key}', adaptfully.auth.Dev);`,
     },
+    localStorage: {
+        scripts: ['core.js', 'storage/_helpers.js', 'storage/local-storage.js'],
+        registration: (key) => `adaptfully.register('${key}', adaptfully.storage.LocalStorage());`,
+    },
+    indexedDB: {
+        scripts: ['core.js', 'storage/_helpers.js', 'storage/indexed-db.js'],
+        registration: (key) => `adaptfully.register('${key}', adaptfully.storage.IndexedDB());`,
+    },
 };
 
 /** Default Wrapfully builder → config.platforms key */

package/lib/runtime/auth/_helpers.js

@@ -1,4 +1,4 @@
-/* global localStorage, window */
+/* global window */
 
 /**
  * @typedef {{ id: string, email: string }} AuthUser
@@ -17,27 +17,6 @@
  */
 
 (function registerAuthHelpers(ns) {
-    /** @type {ReturnType<typeof createDefaultStorage> | undefined} */
-    let defaultStorage;
-
-    function createDefaultStorage() {
-        if (typeof localStorage !== 'undefined') {
-            return {
-                get(key) {
-                    const value = localStorage.getItem(key);
-                    return value === null ? undefined : value;
-                },
-                set(key, value) {
-                    localStorage.setItem(key, value == null ? '' : String(value));
-                },
-                remove(key) {
-                    localStorage.removeItem(key);
-                },
-            };
-        }
-        return null;
-    }
-
     const helpers = {
         configValue(key, fallback) {
             if (!ns.has('config')) {
@@ -51,13 +30,7 @@
         },
 
         getStorage() {
-            if (ns.has('storage')) {
-                return ns.get('storage');
-            }
-            if (defaultStorage === undefined) {
-                defaultStorage = createDefaultStorage();
-            }
-            return defaultStorage;
+            return ns.has('storage') ? ns.get('storage') : null;
         },
     };
 

package/lib/runtime/storage/_helpers.js

@@ -0,0 +1,5 @@
+/* global window */
+
+(function registerStorageHelpers(ns) {
+    ns.storage = ns.storage || {};
+}(window.adaptfully));

package/lib/runtime/storage/indexed-db.js

@@ -0,0 +1,87 @@
+/* global indexedDB, window */
+
+(function registerIndexedDBStorage(ns) {
+    function configValue(key, fallback) {
+        if (!ns.has('config')) {
+            return fallback;
+        }
+        const config = ns.get('config');
+        return config?.[key] != null ? config[key] : fallback;
+    }
+
+    ns.storage.IndexedDB = function indexedDBFactory() {
+        const dbName = configValue('indexedDBName', 'adaptfully');
+        const storeName = configValue('indexedDBStoreName', 'storage');
+        /** @type {Promise<IDBDatabase> | null} */
+        let dbPromise = null;
+
+        function openDb() {
+            if (!dbPromise) {
+                dbPromise = new Promise((resolve, reject) => {
+                    const request = indexedDB.open(dbName, 1);
+                    request.onupgradeneeded = () => {
+                        request.result.createObjectStore(storeName);
+                    };
+                    request.onsuccess = () => resolve(request.result);
+                    request.onerror = () => reject(request.error);
+                });
+            }
+            return dbPromise;
+        }
+
+        function withStore(mode, fn) {
+            return openDb().then((db) => new Promise((resolve, reject) => {
+                const tx = db.transaction(storeName, mode);
+                const store = tx.objectStore(storeName);
+                const request = fn(store);
+                request.onsuccess = () => resolve(request.result);
+                request.onerror = () => reject(request.error);
+            }));
+        }
+
+        return {
+            name: 'indexedDB',
+            async get(field) {
+                try {
+                    const value = await withStore('readonly', (store) => store.get(field));
+                    return value === undefined ? false : value;
+                } catch {
+                    return false;
+                }
+            },
+            async set(field, value) {
+                await this.remove(field);
+                try {
+                    await withStore('readwrite', (store) => store.put(value, field));
+                } catch {
+                    // ignore
+                }
+            },
+            async remove(field) {
+                try {
+                    await withStore('readwrite', (store) => store.delete(field));
+                } catch {
+                    // ignore
+                }
+            },
+            async getObject(field) {
+                const raw = await this.get(field);
+                if (!raw) {
+                    return false;
+                }
+                try {
+                    return JSON.parse(raw);
+                } catch {
+                    return false;
+                }
+            },
+            async setObject(field, obj) {
+                try {
+                    await this.set(field, JSON.stringify(obj));
+                } catch {
+                    // ignore
+                }
+            },
+        };
+    };
+}(window.adaptfully));

package/lib/runtime/storage/local-storage.js

@@ -0,0 +1,50 @@
+/* global localStorage, window */
+
+(function registerLocalStorage(ns) {
+    ns.storage.LocalStorage = function localStorageFactory() {
+        return {
+            name: 'localStorage',
+            get(field) {
+                try {
+                    const value = localStorage.getItem(field);
+                    return value === null ? false : value;
+                } catch {
+                    return false;
+                }
+            },
+            set(field, value) {
+                this.remove(field);
+                try {
+                    localStorage.setItem(field, value);
+                } catch {
+                    // quota or private browsing
+                }
+            },
+            remove(field) {
+                try {
+                    localStorage.removeItem(field);
+                } catch {
+                    // ignore
+                }
+            },
+            getObject(field) {
+                const raw = this.get(field);
+                if (!raw) {
+                    return false;
+                }
+                try {
+                    return JSON.parse(raw);
+                } catch {
+                    return false;
+                }
+            },
+            setObject(field, obj) {
+                try {
+                    this.set(field, JSON.stringify(obj));
+                } catch {
+                    // ignore
+                }
+            },
+        };
+    };
+}(window.adaptfully));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@makefully/adaptfully",
-    "version": "3.0.3",
+    "version": "3.1.0",
     "description": "Platform abstraction and Wrapfully deploy client for Makefully games",
     "type": "module",
     "main": "./lib/node/index.js",