shogun-core 3.0.13 → 3.0.14

package/README.md

@@ -217,7 +217,11 @@ const settings = await shogun.api.getSettings();
 await shogun.api.savePreferences({ theme: 'dark', fontSize: 14 });
 const preferences = await shogun.api.getPreferences();
 
-// Collections (for structured data)
+// Collections (recommended for structured data)
+// Note: Array functions (putUserArray, getUserArray, etc.) have been removed due to GunDB compatibility issues
+// Use collections or direct GunDB operations instead:
+
+// Option 1: Collections (recommended for most use cases)
 await shogun.api.createCollection('todos', {
   '1': { text: 'Learn Shogun Core', done: false },
   '2': { text: 'Build dApp', done: false }
@@ -231,6 +235,12 @@ await shogun.api.addToCollection('todos', '3', {
 const todos = await shogun.api.getCollection('todos');
 await shogun.api.removeFromCollection('todos', '2');
 
+// Option 2: Direct GunDB operations for complex nested data
+await shogun.api.node('users').get('alice').get('todos').get('1').put({ 
+  text: 'Learn Shogun Core', 
+  done: false 
+});
+
 // Utility methods
 const currentUser = shogun.api.getCurrentUser();
 const userExists = await shogun.api.userExists('username');
@@ -777,6 +787,16 @@ You can also use Shogun Core directly in the browser by including it from a CDN.
 - `getCollection(name: string): Promise<Record<string, unknown> | null>` - Get collection
 - `removeFromCollection(name: string, itemId: string): Promise<boolean>` - Remove item from collection
 
+#### Utility Functions
+- `arrayToIndexedObject<T>(arr: T[]): Record<string, T>` - Convert array to indexed object (helper)
+- `indexedObjectToArray<T>(indexedObj: Record<string, T>): T[]` - Convert indexed object to array (helper)
+
+#### ⚠️ **REMOVED FUNCTIONS**
+The following array functions have been **REMOVED** due to GunDB compatibility issues:
+- `putUserArray()`, `getUserArray()`, `addToUserArray()`, `removeFromUserArray()`, `updateInUserArray()`
+
+**Use collections or direct GunDB operations instead** (see examples above).
+
 ### Advanced API Methods
 
 #### Core Authentication

package/dist/browser/shogun-core.js

@@ -89993,147 +89993,6 @@ class SimpleGunAPI {
     indexedObjectToArray(indexedObj) {
         return this.getArrayFromIndexedObject(indexedObj);
     }
-    // Save array as indexed object in user space
-    async putUserArray(path, arr) {
-        try {
-            if (!this.isLoggedIn()) {
-                console.warn("User not logged in");
-                return false;
-            }
-            const indexedObject = this.getIndexedObjectFromArray(arr);
-            return await this.putUserData(path, indexedObject);
-        }
-        catch (error) {
-            console.warn(`Failed to put user array to ${path}:`, error);
-            return false;
-        }
-    }
-    // Get array from indexed object in user space
-    async getUserArray(path) {
-        try {
-            if (!this.isLoggedIn()) {
-                console.warn("User not logged in");
-                return [];
-            }
-            const indexedObject = await this.getUserData(path);
-            return this.getArrayFromIndexedObject(indexedObject);
-        }
-        catch (error) {
-            console.warn(`Failed to get user array from ${path}:`, error);
-            return [];
-        }
-    }
-    // Add item to user array collection
-    async addToUserArray(path, item) {
-        try {
-            if (!this.isLoggedIn()) {
-                console.warn("User not logged in");
-                return false;
-            }
-            // Validate item before adding
-            if (!item || typeof item !== "object" || !item.id) {
-                console.warn("Invalid item: must be an object with an id property");
-                return false;
-            }
-            const currentArray = await this.getUserArray(path);
-            const newArray = [...currentArray, item];
-            return await this.putUserArray(path, newArray);
-        }
-        catch (error) {
-            console.warn(`Failed to add item to user array ${path}:`, error);
-            return false;
-        }
-    }
-    // Remove item from user array collection
-    async removeFromUserArray(path, itemId) {
-        try {
-            if (!this.isLoggedIn()) {
-                console.warn("User not logged in");
-                return false;
-            }
-            const currentArray = await this.getUserArray(path);
-            const newArray = currentArray.filter((item) => item.id !== itemId);
-            return await this.putUserArray(path, newArray);
-        }
-        catch (error) {
-            console.warn(`Failed to remove item from user array ${path}:`, error);
-            return false;
-        }
-    }
-    // Update item in user array collection
-    async updateInUserArray(path, itemId, updates) {
-        try {
-            if (!this.isLoggedIn()) {
-                console.warn("User not logged in");
-                return false;
-            }
-            const currentArray = await this.getUserArray(path);
-            const newArray = currentArray.map((item) => item.id === itemId ? { ...item, ...updates } : item);
-            return await this.putUserArray(path, newArray);
-        }
-        catch (error) {
-            console.warn(`Failed to update item in user array ${path}:`, error);
-            return false;
-        }
-    }
-    // Save array as indexed object in global space
-    async putArray(path, arr) {
-        try {
-            const indexedObject = this.getIndexedObjectFromArray(arr);
-            return await this.put(path, indexedObject);
-        }
-        catch (error) {
-            console.warn(`Failed to put array to ${path}:`, error);
-            return false;
-        }
-    }
-    // Get array from indexed object in global space
-    async getArray(path) {
-        try {
-            const indexedObject = await this.get(path);
-            return this.getArrayFromIndexedObject(indexedObject);
-        }
-        catch (error) {
-            console.warn(`Failed to get array from ${path}:`, error);
-            return [];
-        }
-    }
-    // Add item to global array collection
-    async addToArray(path, item) {
-        try {
-            const currentArray = await this.getArray(path);
-            const newArray = [...currentArray, item];
-            return await this.putArray(path, newArray);
-        }
-        catch (error) {
-            console.warn(`Failed to add item to array ${path}:`, error);
-            return false;
-        }
-    }
-    // Remove item from global array collection
-    async removeFromArray(path, itemId) {
-        try {
-            const currentArray = await this.getArray(path);
-            const newArray = currentArray.filter((item) => item.id !== itemId);
-            return await this.putArray(path, newArray);
-        }
-        catch (error) {
-            console.warn(`Failed to remove item from array ${path}:`, error);
-            return false;
-        }
-    }
-    // Update item in global array collection
-    async updateInArray(path, itemId, updates) {
-        try {
-            const currentArray = await this.getArray(path);
-            const newArray = currentArray.map((item) => item.id === itemId ? { ...item, ...updates } : item);
-            return await this.putArray(path, newArray);
-        }
-        catch (error) {
-            console.warn(`Failed to update item in array ${path}:`, error);
-            return false;
-        }
-    }
     /**
      * Path utilities
      */