shogun-core 3.0.13 → 3.0.15

package/dist/config/simplified-config.js

@@ -1,11 +1,14 @@
+"use strict";
 /**
  * Simplified configuration options to reduce complexity
  * Provides sensible defaults and easy-to-use presets
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuickConfig = exports.ConfigHelpers = exports.ShogunConfigBuilder = exports.ShogunPresets = void 0;
 /**
  * Preset configurations for common use cases
  */
-export const ShogunPresets = {
+exports.ShogunPresets = {
     /**
      * Minimal configuration for simple apps
      */
@@ -88,8 +91,10 @@ export const ShogunPresets = {
 /**
  * Configuration builder for custom setups
  */
-export class ShogunConfigBuilder {
-    config = {};
+class ShogunConfigBuilder {
+    constructor() {
+        this.config = {};
+    }
     /**
      * Set Gun options
      */
@@ -146,36 +151,37 @@ export class ShogunConfigBuilder {
         return this.config;
     }
 }
+exports.ShogunConfigBuilder = ShogunConfigBuilder;
 /**
  * Helper functions for common configuration patterns
  */
-export const ConfigHelpers = {
+exports.ConfigHelpers = {
     /**
      * Create a configuration for a specific environment
      */
     forEnvironment(env) {
         switch (env) {
             case "development":
-                return ShogunPresets.development();
+                return exports.ShogunPresets.development();
             case "production":
-                return ShogunPresets.production();
+                return exports.ShogunPresets.production();
             case "test":
-                return ShogunPresets.offline();
+                return exports.ShogunPresets.offline();
             default:
-                return ShogunPresets.minimal();
+                return exports.ShogunPresets.minimal();
         }
     },
     /**
      * Create a configuration with custom peers
      */
     withPeers(peers) {
-        return ShogunPresets.production(peers);
+        return exports.ShogunPresets.production(peers);
     },
     /**
      * Create a configuration for a specific use case
      */
     forUseCase(useCase) {
-        const baseConfig = ShogunPresets.production();
+        const baseConfig = exports.ShogunPresets.production();
         switch (useCase) {
             case "chat":
                 return {
@@ -206,25 +212,25 @@ export const ConfigHelpers = {
 /**
  * Quick configuration functions
  */
-export const QuickConfig = {
+exports.QuickConfig = {
     /**
      * Minimal setup for quick testing
      */
-    test: () => ShogunPresets.minimal(),
+    test: () => exports.ShogunPresets.minimal(),
     /**
      * Standard setup for most apps
      */
-    standard: () => ShogunPresets.production(),
+    standard: () => exports.ShogunPresets.production(),
     /**
      * Setup with WebAuthn for secure apps
      */
-    secure: () => ShogunPresets.webauthn(),
+    secure: () => exports.ShogunPresets.webauthn(),
     /**
      * Setup with Web3 for crypto apps
      */
-    crypto: () => ShogunPresets.web3(),
+    crypto: () => exports.ShogunPresets.web3(),
     /**
      * Offline setup for local development
      */
-    local: () => ShogunPresets.offline(),
+    local: () => exports.ShogunPresets.offline(),
 };

package/dist/core.js

@@ -1,9 +1,12 @@
-import { ErrorHandler } from "./utils/errorHandler";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShogunCore = void 0;
+const errorHandler_1 = require("./utils/errorHandler");
 // Import managers
-import { PluginManager } from "./managers/PluginManager";
-import { AuthManager } from "./managers/AuthManager";
-import { EventManager } from "./managers/EventManager";
-import { CoreInitializer } from "./managers/CoreInitializer";
+const PluginManager_1 = require("./managers/PluginManager");
+const AuthManager_1 = require("./managers/AuthManager");
+const EventManager_1 = require("./managers/EventManager");
+const CoreInitializer_1 = require("./managers/CoreInitializer");
 /**
  * Main ShogunCore class - implements the IShogunCore interface
  *
@@ -15,21 +18,7 @@ import { CoreInitializer } from "./managers/CoreInitializer";
  *
  * @since 2.0.0
  */
-export class ShogunCore {
-    static API_VERSION = "^3.0.11";
-    db;
-    storage;
-    provider;
-    config;
-    rx;
-    _gun;
-    _user = null;
-    wallets;
-    // Managers
-    pluginManager;
-    authManager;
-    eventManager;
-    coreInitializer;
+class ShogunCore {
     /**
      * Initialize the Shogun SDK
      * @param config - SDK Configuration object
@@ -38,12 +27,13 @@ export class ShogunCore {
      * and plugin system.
      */
     constructor(config) {
+        this._user = null;
         this.config = config;
         // Initialize managers
-        this.eventManager = new EventManager();
-        this.pluginManager = new PluginManager(this);
-        this.authManager = new AuthManager(this);
-        this.coreInitializer = new CoreInitializer(this);
+        this.eventManager = new EventManager_1.EventManager();
+        this.pluginManager = new PluginManager_1.PluginManager(this);
+        this.authManager = new AuthManager_1.AuthManager(this);
+        this.coreInitializer = new CoreInitializer_1.CoreInitializer(this);
         // Initialize async components
         this.coreInitializer.initialize(config).catch((error) => {
             if (typeof console !== "undefined" && console.warn) {
@@ -185,7 +175,7 @@ export class ShogunCore {
      * @returns List of most recent errors
      */
     getRecentErrors(count = 10) {
-        return ErrorHandler.getRecentErrors(count);
+        return errorHandler_1.ErrorHandler.getRecentErrors(count);
     }
     // *********************************************************************************************************
     // 🔐 AUTHENTICATION
@@ -327,6 +317,8 @@ export class ShogunCore {
         return !!(this.user && this.user.is);
     }
 }
+exports.ShogunCore = ShogunCore;
+ShogunCore.API_VERSION = "^3.0.11";
 // Global declarations are handled in the original core.ts file
 // to avoid conflicts, we only set the window properties here
 if (typeof window !== "undefined") {
@@ -335,4 +327,4 @@ if (typeof window !== "undefined") {
     };
     window.SHOGUN_CORE_CLASS = ShogunCore;
 }
-export default ShogunCore;
+exports.default = ShogunCore;

package/dist/examples/api-test.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * Esempio completo che mostra le differenze tra i vari metodi dell'API ShogunCore
+ *
+ * Questo esempio dimostra:
+ * - get() vs getData() vs getNode() vs node() vs chain()
+ * - put() vs set() vs putUserData() vs setUserData()
+ * - remove() vs removeUserData()
+ * - Operazioni globali vs operazioni utente
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.demonstrateAPIDifferences = demonstrateAPIDifferences;
+exports.showAPIDifferences = showAPIDifferences;
+const api_1 = require("../gundb/api");
+async function demonstrateAPIDifferences() {
+    console.log("🚀 Iniziamo il test delle differenze API...\n");
+    // 1. Setup iniziale
+    const quickStart = new api_1.AutoQuickStart({
+        peers: ["https://peer.wallie.io/gun"],
+        appScope: "test-api",
+    });
+    await quickStart.init();
+    const api = quickStart.api;
+    console.log("✅ Setup completato\n");
+    // 2. Test operazioni GLOBALI (senza autenticazione)
+    console.log("📊 === TEST OPERAZIONI GLOBALI ===\n");
+    // Test get() - restituisce dati direttamente o null
+    console.log("🔍 Test get():");
+    const globalData = await api.get("global/test");
+    console.log('get("global/test"):', globalData); // null se non esiste
+    // Test getNode() - restituisce nodo Gun per operazioni di chaining
+    console.log("\n🔗 Test getNode():");
+    const globalNode = api.getNode("global/test");
+    console.log('getNode("global/test"):', typeof globalNode); // Gun node object
+    // Test node() - alias di getNode()
+    console.log("\n🔗 Test node():");
+    const globalNode2 = api.node("global/test");
+    console.log('node("global/test"):', typeof globalNode2); // Gun node object
+    // Test chain() - wrapper con metodi di convenienza
+    console.log("\n⛓️ Test chain():");
+    const globalChain = api.chain("global/test");
+    console.log('chain("global/test"):', Object.keys(globalChain)); // ['get', 'put', 'set', 'once', 'then', 'map']
+    // Test put() vs set() - operazioni globali
+    console.log("\n💾 Test put() vs set():");
+    const testData = { message: "Hello Global!", timestamp: Date.now() };
+    const putResult = await api.put("global/test", testData);
+    console.log("put() result:", putResult); // boolean
+    const setResult = await api.set("global/test2", {
+        ...testData,
+        method: "set",
+    });
+    console.log("set() result:", setResult); // boolean
+    // Verifica che i dati siano stati salvati
+    const retrievedData1 = await api.get("global/test");
+    const retrievedData2 = await api.get("global/test2");
+    console.log("Retrieved put data:", retrievedData1);
+    console.log("Retrieved set data:", retrievedData2);
+    // Test remove() - operazione globale
+    console.log("\n🗑️ Test remove():");
+    const removeResult = await api.remove("global/test2");
+    console.log("remove() result:", removeResult); // boolean
+    const removedData = await api.get("global/test2");
+    console.log("Data after remove:", removedData); // null
+    // 3. Test autenticazione
+    console.log("\n\n🔐 === TEST AUTENTICAZIONE ===\n");
+    const username = "testuser_" + Date.now();
+    const password = "testpass123";
+    // Test signup
+    console.log("📝 Test signup():");
+    const signupResult = await api.signup(username, password);
+    console.log("signup result:", signupResult);
+    if (signupResult) {
+        console.log("✅ Utente creato:", signupResult.username);
+        // Test login
+        console.log("\n🔑 Test login():");
+        const loginResult = await api.login(username, password);
+        console.log("login result:", loginResult);
+        if (loginResult) {
+            console.log("✅ Login riuscito:", loginResult.username);
+            // 4. Test operazioni UTENTE (con autenticazione)
+            console.log("\n\n👤 === TEST OPERAZIONI UTENTE ===\n");
+            // Test getUserData() - restituisce dati utente direttamente
+            console.log("🔍 Test getUserData():");
+            const userData = await api.getUserData("profile");
+            console.log('getUserData("profile"):', userData); // null se non esiste
+            // Test putUserData() vs setUserData() - operazioni utente
+            console.log("\n💾 Test putUserData() vs setUserData():");
+            const profileData = {
+                name: "Test User",
+                email: "test@example.com",
+                bio: "Test bio",
+                preferences: {
+                    theme: "dark",
+                    notifications: true,
+                },
+            };
+            const putUserResult = await api.putUserData("profile", profileData);
+            console.log("putUserData() result:", putUserResult); // boolean
+            const settingsData = {
+                language: "it",
+                timezone: "Europe/Rome",
+                privacy: "public",
+            };
+            const setUserResult = await api.setUserData("settings", settingsData);
+            console.log("setUserData() result:", setUserResult); // boolean
+            // Verifica che i dati utente siano stati salvati
+            const retrievedProfile = await api.getUserData("profile");
+            const retrievedSettings = await api.getUserData("settings");
+            console.log("Retrieved profile:", retrievedProfile);
+            console.log("Retrieved settings:", retrievedSettings);
+            // Test getUserNode() - nodo utente per operazioni avanzate
+            console.log("\n🔗 Test getUserNode():");
+            try {
+                const userNode = api.getUserNode("profile");
+                console.log('getUserNode("profile"):', typeof userNode); // Gun node object
+            }
+            catch (error) {
+                console.log("getUserNode error:", error.message);
+            }
+            // Test removeUserData() - rimozione dati utente
+            console.log("\n🗑️ Test removeUserData():");
+            const removeUserResult = await api.removeUserData("settings");
+            console.log("removeUserData() result:", removeUserResult); // boolean
+            const removedUserData = await api.getUserData("settings");
+            console.log("User data after remove:", removedUserData); // null
+            // 5. Test metodi di convenienza
+            console.log("\n\n🛠️ === TEST METODI DI CONVENIENZA ===\n");
+            // Test updateProfile()
+            console.log("👤 Test updateProfile():");
+            const profileUpdate = {
+                name: "Updated Test User",
+                bio: "Updated bio",
+                avatar: "https://example.com/avatar.jpg",
+            };
+            const profileResult = await api.updateProfile(profileUpdate);
+            console.log("updateProfile() result:", profileResult);
+            const updatedProfile = await api.getProfile();
+            console.log("Updated profile:", updatedProfile);
+            // Test saveSettings()
+            console.log("\n⚙️ Test saveSettings():");
+            const settings = {
+                theme: "light",
+                language: "en",
+                notifications: false,
+            };
+            const settingsResult = await api.saveSettings(settings);
+            console.log("saveSettings() result:", settingsResult);
+            const savedSettings = await api.getSettings();
+            console.log("Saved settings:", savedSettings);
+            // Test createCollection()
+            console.log("\n📚 Test createCollection():");
+            const todos = {
+                "1": { id: "1", text: "Learn ShogunCore", completed: false },
+                "2": { id: "2", text: "Build awesome app", completed: false },
+                "3": { id: "3", text: "Deploy to production", completed: true },
+            };
+            const collectionResult = await api.createCollection("todos", todos);
+            console.log("createCollection() result:", collectionResult);
+            const todosCollection = await api.getCollection("todos");
+            console.log("Todos collection:", todosCollection);
+            // Test addToCollection()
+            console.log("\n➕ Test addToCollection():");
+            const newTodo = { id: "4", text: "Test API methods", completed: false };
+            const addResult = await api.addToCollection("todos", "4", newTodo);
+            console.log("addToCollection() result:", addResult);
+            const updatedCollection = await api.getCollection("todos");
+            console.log("Updated collection:", updatedCollection);
+            // Test removeFromCollection()
+            console.log("\n➖ Test removeFromCollection():");
+            const removeFromCollectionResult = await api.removeFromCollection("todos", "3");
+            console.log("removeFromCollection() result:", removeFromCollectionResult);
+            const finalCollection = await api.getCollection("todos");
+            console.log("Final collection:", finalCollection);
+            // 6. Test utility methods
+            console.log("\n\n🔧 === TEST METODI UTILITY ===\n");
+            // Test getCurrentUser()
+            console.log("👤 Test getCurrentUser():");
+            const currentUser = api.getCurrentUser();
+            console.log("Current user:", currentUser);
+            // Test isLoggedIn()
+            console.log("\n🔐 Test isLoggedIn():");
+            const isLoggedIn = api.isLoggedIn();
+            console.log("Is logged in:", isLoggedIn);
+            // Test userExists()
+            console.log("\n🔍 Test userExists():");
+            const userExists = await api.userExists(username);
+            console.log(`User ${username} exists:`, userExists);
+            // Test getUser()
+            console.log("\n👥 Test getUser():");
+            const userInfo = await api.getUser(username);
+            console.log("User info:", userInfo);
+            // Test logout
+            console.log("\n🚪 Test logout():");
+            api.logout();
+            const isLoggedInAfter = api.isLoggedIn();
+            console.log("Is logged in after logout:", isLoggedInAfter);
+        }
+        else {
+            console.log("❌ Login fallito");
+        }
+    }
+    else {
+        console.log("❌ Signup fallito");
+    }
+    // 7. Test array utilities
+    console.log("\n\n📊 === TEST ARRAY UTILITIES ===\n");
+    const testArray = [
+        { id: "1", name: "Item 1", value: 100 },
+        { id: "2", name: "Item 2", value: 200 },
+        { id: "3", name: "Item 3", value: 300 },
+    ];
+    console.log("Original array:", testArray);
+    // Test arrayToIndexedObject()
+    const indexedObject = api.arrayToIndexedObject(testArray);
+    console.log("Array to indexed object:", indexedObject);
+    // Test indexedObjectToArray()
+    const backToArray = api.indexedObjectToArray(indexedObject);
+    console.log("Indexed object back to array:", backToArray);
+    console.log("\n✅ Test completato!");
+}
+// Funzione per mostrare le differenze principali
+function showAPIDifferences() {
+    console.log(`
+📋 === RIEPILOGO DIFFERENZE API ===
+
+🔍 METODI GET:
+• get(path)           → Restituisce dati direttamente o null
+• getNode(path)       → Restituisce nodo Gun per chaining (.map(), .on(), etc.)
+• node(path)          → Alias di getNode()
+• chain(path)         → Wrapper con metodi di convenienza (get, put, set, once, then, map)
+• getUserData(path)   → Come get() ma per dati utente (richiede login)
+
+💾 METODI PUT/SET:
+• put(path, data)     → Salva dati globali, restituisce boolean
+• set(path, data)     → Come put() ma con semantica diversa
+• putUserData(path, data) → Salva dati utente, restituisce boolean
+• setUserData(path, data) → Come putUserData() ma con semantica diversa
+
+🗑️ METODI REMOVE:
+• remove(path)        → Rimuove dati globali, restituisce boolean
+• removeUserData(path) → Rimuove dati utente, restituisce boolean
+
+🔐 AUTENTICAZIONE:
+• signup(username, password) → Crea nuovo utente
+• login(username, password)  → Autentica utente esistente
+• logout()                   → Disconnette utente
+• isLoggedIn()               → Controlla se utente è autenticato
+
+👤 UTILITY UTENTE:
+• getCurrentUser()    → Info utente corrente
+• getUser(alias)      → Info utente per alias
+• userExists(alias)   → Controlla se utente esiste
+
+🛠️ METODI DI CONVENIENZA:
+• updateProfile(data) → Aggiorna profilo utente
+• getProfile()        → Ottiene profilo utente
+• saveSettings(data)  → Salva impostazioni utente
+• getSettings()       → Ottiene impostazioni utente
+• createCollection(name, items) → Crea collezione
+• addToCollection(name, id, item) → Aggiunge item a collezione
+• getCollection(name) → Ottiene collezione
+• removeFromCollection(name, id) → Rimuove item da collezione
+
+📊 ARRAY UTILITIES:
+• arrayToIndexedObject(arr) → Converte array in oggetto indicizzato per GunDB
+• indexedObjectToArray(obj) → Converte oggetto indicizzato in array
+  `);
+}
+// Esegui il test
+if (require.main === module) {
+    showAPIDifferences();
+    demonstrateAPIDifferences().catch(console.error);
+}

package/dist/examples/simple-api-test.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Esempio semplice che mostra le differenze principali tra i metodi API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simpleAPITest = simpleAPITest;
+const api_1 = require("../gundb/api");
+async function simpleAPITest() {
+    console.log("🚀 Test semplice API ShogunCore\n");
+    // Setup
+    const quickStart = new api_1.AutoQuickStart({
+        peers: ["https://peer.wallie.io/gun"],
+        appScope: "simple-test",
+    });
+    await quickStart.init();
+    const api = quickStart.api;
+    // === DIFFERENZE PRINCIPALI ===
+    console.log("📊 === DIFFERENZE GET ===\n");
+    // 1. get() - restituisce dati direttamente
+    const data1 = await api.get("test/path");
+    console.log('get("test/path"):', data1); // null o dati
+    // 2. getNode() - restituisce nodo Gun per chaining
+    const node1 = api.getNode("test/path");
+    console.log('getNode("test/path"):', typeof node1); // "object" (Gun node)
+    // 3. node() - alias di getNode()
+    const node2 = api.node("test/path");
+    console.log('node("test/path"):', typeof node2); // "object" (Gun node)
+    // 4. chain() - wrapper con metodi di convenienza
+    const chain1 = api.chain("test/path");
+    console.log('chain("test/path"):', Object.keys(chain1)); // ['get', 'put', 'set', 'once', 'then', 'map']
+    console.log("\n💾 === DIFFERENZE PUT/SET ===\n");
+    const testData = { message: "Hello World", timestamp: Date.now() };
+    // 1. put() - salva dati globali
+    const putResult = await api.put("global/data", testData);
+    console.log("put() result:", putResult); // true/false
+    // 2. set() - come put() ma semantica diversa
+    const setResult = await api.set("global/data2", {
+        ...testData,
+        method: "set",
+    });
+    console.log("set() result:", setResult); // true/false
+    // Verifica
+    const retrieved1 = await api.get("global/data");
+    const retrieved2 = await api.get("global/data2");
+    console.log("Retrieved put data:", retrieved1);
+    console.log("Retrieved set data:", retrieved2);
+    console.log("\n🗑️ === DIFFERENZE REMOVE ===\n");
+    // remove() - rimuove dati globali
+    const removeResult = await api.remove("global/data2");
+    console.log("remove() result:", removeResult); // true/false
+    const afterRemove = await api.get("global/data2");
+    console.log("Data after remove:", afterRemove); // null
+    console.log("\n🔐 === TEST AUTENTICAZIONE ===\n");
+    // Signup e login
+    const username = "testuser_" + Date.now();
+    const password = "testpass123";
+    const signupResult = await api.signup(username, password);
+    console.log("Signup result:", signupResult);
+    if (signupResult) {
+        const loginResult = await api.login(username, password);
+        console.log("Login result:", loginResult);
+        if (loginResult) {
+            console.log("\n👤 === OPERAZIONI UTENTE ===\n");
+            // getUserData() - per dati utente
+            const userData = await api.getUserData("profile");
+            console.log('getUserData("profile"):', userData); // null o dati utente
+            // putUserData() - salva dati utente
+            const profileData = { name: "Test User", email: "test@example.com" };
+            const putUserResult = await api.putUserData("profile", profileData);
+            console.log("putUserData() result:", putUserResult); // true/false
+            // Verifica dati utente
+            const retrievedProfile = await api.getUserData("profile");
+            console.log("Retrieved profile:", retrievedProfile);
+            // removeUserData() - rimuove dati utente
+            const removeUserResult = await api.removeUserData("profile");
+            console.log("removeUserData() result:", removeUserResult); // true/false
+            const afterRemoveUser = await api.getUserData("profile");
+            console.log("User data after remove:", afterRemoveUser); // null
+            // Logout
+            api.logout();
+            console.log("Logged out");
+        }
+    }
+    console.log("\n✅ Test completato!");
+}
+// Esegui il test
+if (require.main === module) {
+    simpleAPITest().catch(console.error);
+}