shogun-core 5.2.2 → 6.0.0

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

@@ -1,114 +0,0 @@
-"use strict";
-/**
- * Example showing how to use the simplified ShogunCore API
- *
- * The API has been streamlined:
- * - AutoQuickStart: Quick initialization helper
- * - api.database: Direct access to DataBase for basic operations (get, put, set, remove, auth)
- * - api helper methods: High-level helpers for profile, settings, collections, and array utilities
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.simpleAPITest = simpleAPITest;
-const api_1 = require("../gundb/api");
-async function simpleAPITest() {
-    console.log("🚀 ShogunCore Simplified API Example\n");
-    // === QUICK START ===
-    console.log("📦 === INITIALIZATION ===\n");
-    // Use AutoQuickStart for easy setup
-    const quickStart = new api_1.AutoQuickStart({
-        peers: ["https://peer.wallie.io/gun"],
-        appScope: "simple-test",
-    });
-    await quickStart.init();
-    // Access the API and database
-    const api = quickStart.api;
-    const db = api.database; // Direct access to DataBase for basic operations
-    console.log("Initialized successfully!");
-    console.log("- api: provides helper methods");
-    console.log("- db (api.database): provides full DataBase functionality\n");
-    // === BASIC OPERATIONS (via database) ===
-    console.log("💾 === BASIC OPERATIONS (use api.database) ===\n");
-    const testData = { message: "Hello World", timestamp: Date.now() };
-    // Use db for basic operations
-    await db.put("global/data", testData);
-    console.log("✓ Saved data with db.put()");
-    const retrieved = await db.getData("global/data");
-    console.log("✓ Retrieved data with db.getData():", retrieved);
-    await db.remove("global/data");
-    console.log("✓ Removed data with db.remove()\n");
-    // === AUTHENTICATION (via database) ===
-    console.log("🔐 === AUTHENTICATION (use api.database) ===\n");
-    const username = "testuser_" + Date.now();
-    const password = "testpass123";
-    const signupResult = await db.signUp(username, password);
-    console.log("✓ Signup:", signupResult.success ? "Success" : "Failed");
-    if (signupResult.success) {
-        const loginResult = await db.login(username, password);
-        console.log("✓ Login:", loginResult.success ? "Success" : "Failed");
-        if (loginResult.success) {
-            console.log("✓ Current user:", db.getCurrentUser()?.alias, "\n");
-            // === HELPER METHODS (via api) ===
-            console.log("⭐ === HELPER METHODS (use api helpers) ===\n");
-            // Profile helper
-            await api.updateProfile({
-                name: "Test User",
-                email: "test@example.com",
-                bio: "Testing the simplified API",
-            });
-            console.log("✓ Profile updated with api.updateProfile()");
-            const profile = await api.getProfile();
-            console.log("✓ Profile retrieved:", profile);
-            // Settings helper
-            await api.saveSettings({
-                theme: "dark",
-                language: "en",
-                notifications: true,
-            });
-            console.log("✓ Settings saved with api.saveSettings()");
-            const settings = await api.getSettings();
-            console.log("✓ Settings retrieved:", settings);
-            // Collections helper
-            await api.createCollection("favorites", {
-                item1: { id: "item1", title: "First Item" },
-                item2: { id: "item2", title: "Second Item" },
-            });
-            console.log("✓ Collection created with api.createCollection()");
-            await api.addToCollection("favorites", "item3", {
-                id: "item3",
-                title: "Third Item",
-            });
-            console.log("✓ Item added with api.addToCollection()");
-            const collection = await api.getCollection("favorites");
-            console.log("✓ Collection retrieved:", collection);
-            // === ARRAY UTILITIES ===
-            console.log("\n🔧 === ARRAY UTILITIES ===\n");
-            const items = [
-                { id: "1", name: "Item 1", value: 100 },
-                { id: "2", name: "Item 2", value: 200 },
-                { id: "3", name: "Item 3", value: 300 },
-            ];
-            // Convert array to GunDB-friendly indexed object
-            const indexed = api.arrayToIndexedObject(items);
-            console.log("✓ Array converted to indexed object:", indexed);
-            // Convert back to array
-            const restored = api.indexedObjectToArray(indexed);
-            console.log("✓ Indexed object converted back to array:", restored);
-            // Logout
-            db.logout();
-            console.log("\n✓ Logged out");
-        }
-    }
-    console.log("\n✅ Example completed!");
-    console.log("\nSummary:");
-    console.log("- Use AutoQuickStart for easy initialization");
-    console.log("- Use api.database for basic operations (get, put, auth, etc.)");
-    console.log("- Use api helper methods for high-level operations:");
-    console.log("  • updateProfile(), getProfile()");
-    console.log("  • saveSettings(), getSettings()");
-    console.log("  • createCollection(), addToCollection(), getCollection()");
-    console.log("  • arrayToIndexedObject(), indexedObjectToArray()");
-}
-// Esegui il test
-if (require.main === module) {
-    simpleAPITest().catch(console.error);
-}

package/dist/examples/simple-crypto-identity-example.js

@@ -1,84 +0,0 @@
-"use strict";
-/**
- * Esempio semplificato del CryptoIdentityManager
- * Focus sulla funzionalità principale senza plugin opzionali
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.simpleCryptoIdentityExample = simpleCryptoIdentityExample;
-const index_1 = require("../index");
-// Esempio principale
-async function simpleCryptoIdentityExample() {
-    console.log("🚀 Esempio Semplificato CryptoIdentityManager");
-    console.log("============================================\n");
-    // 1. Inizializza ShogunCore
-    const core = new index_1.ShogunCore({
-        gunOptions: {
-            peers: ["https://peer.wallie.io/gun"],
-            radisk: true,
-            localStorage: false,
-        },
-    });
-    console.log("✅ ShogunCore inizializzato");
-    // 2. Registra un nuovo utente (genera automaticamente SEA pair)
-    const username = `user_${Date.now()}`;
-    const signupResult = await core.signUp(username, "password123");
-    if (!signupResult.success) {
-        console.error("❌ Registrazione fallita:", signupResult.error);
-        return;
-    }
-    console.log("✅ Utente registrato:", {
-        username: signupResult.username,
-        userPub: signupResult.userPub?.substring(0, 20) + "...",
-        hasSEAPair: !!signupResult.sea,
-    });
-    // 3. Le identità crypto sono state generate automaticamente durante la registrazione
-    const cryptoManager = new index_1.CryptoIdentityManager(core);
-    // 4. Recupera le identità crypto dell'utente corrente
-    const identitiesResult = await cryptoManager.getCurrentUserIdentities();
-    if (identitiesResult.success && identitiesResult.identities) {
-        const identities = identitiesResult.identities;
-        console.log("\n🔐 Identità crypto generate automaticamente:");
-        console.log("===========================================");
-        console.log("- RSA Key Pair:", identities.rsa ? "✅" : "❌");
-        console.log("- AES Symmetric Key:", identities.aes ? "✅" : "❌");
-        console.log("- Signal Protocol Identity:", identities.signal ? "✅" : "❌");
-        console.log("- PGP Key Pair:", identities.pgp ? "✅" : "❌");
-        console.log("- MLS Group:", identities.mls ? "✅" : "❌");
-        console.log("- SFrame Key:", identities.sframe ? "✅" : "❌");
-        console.log("- Created At:", new Date(identities.createdAt).toISOString());
-        console.log("- Version:", identities.version);
-    }
-    else {
-        console.error("❌ Errore nel recupero delle identità:", identitiesResult.error);
-    }
-    // 5. Test login con utente esistente
-    console.log("\n🔄 Test login con utente esistente...");
-    const loginResult = await core.login(username, "password123");
-    if (loginResult.success) {
-        console.log("✅ Login riuscito");
-        // Le identità crypto esistenti vengono recuperate automaticamente
-        const existingIdentities = await cryptoManager.getCurrentUserIdentities();
-        if (existingIdentities.success) {
-            console.log("✅ Identità crypto esistenti recuperate");
-        }
-    }
-    else {
-        console.error("❌ Login fallito:", loginResult.error);
-    }
-    // 6. Test verifica esistenza identità
-    console.log("\n🔍 Test verifica esistenza identità...");
-    const hasIdentities = await cryptoManager.hasStoredIdentities(username);
-    console.log(`✅ Identità salvate per ${username}: ${hasIdentities ? "Sì" : "No"}`);
-    console.log("\n🎉 Esempio completato!");
-    console.log("=====================");
-    console.log("✅ Il CryptoIdentityManager funziona perfettamente!");
-    console.log("✅ Le identità crypto vengono generate automaticamente");
-    console.log("✅ Le identità vengono salvate e recuperate correttamente");
-    console.log("✅ Il sistema è pronto per l'uso! 🚀");
-}
-// Esegui l'esempio se il file viene eseguito direttamente
-if (typeof window === "undefined" && require.main === module) {
-    simpleCryptoIdentityExample().catch((error) => {
-        console.error("❌ Errore durante l'esecuzione dell'esempio:", error);
-    });
-}

package/dist/examples/timeout-test.js

@@ -1,227 +0,0 @@
-"use strict";
-/**
- * Timeout Test Script
- *
- * Tests the timeout mechanism for signup and login operations
- * This script specifically tests the fixes we implemented to prevent hanging
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.timeoutTest = timeoutTest;
-const api_1 = require("../gundb/api");
-async function timeoutTest() {
-    console.log("⏱️ ShogunCore Timeout Test\n");
-    console.log("This test verifies that signup/login operations don't hang indefinitely\n");
-    // === INITIALIZATION ===
-    console.log("📦 === INITIALIZATION ===\n");
-    const quickStart = new api_1.AutoQuickStart({
-        peers: [
-            "https://peer.wallie.io/gun",
-            "https://gun-manhattan.herokuapp.com/gun",
-            "https://gun.defucc.me/gun",
-        ],
-        appScope: "timeout-test",
-        enableGunDebug: true,
-    });
-    try {
-        await quickStart.init();
-        console.log("✓ ShogunCore initialized successfully");
-    }
-    catch (error) {
-        console.error("❌ Failed to initialize ShogunCore:", error);
-        return;
-    }
-    const db = quickStart.api.database;
-    console.log("");
-    // === TEST 1: NORMAL SIGNUP (should complete quickly) ===
-    console.log("🧪 === TEST 1: NORMAL SIGNUP ===\n");
-    const testUsername = `timeouttest_${Date.now()}`;
-    const testPassword = "testpass123!@#";
-    console.log(`Testing signup with username: ${testUsername}`);
-    console.log("Expected: Should complete within 10 seconds\n");
-    const signupStartTime = Date.now();
-    try {
-        const signupResult = await db.signUp(testUsername, testPassword);
-        const signupDuration = Date.now() - signupStartTime;
-        console.log(`✓ Signup completed in ${signupDuration}ms`);
-        if (signupDuration > 10000) {
-            console.warn("⚠️ Signup took longer than expected (>10s)");
-        }
-        else if (signupDuration > 5000) {
-            console.warn("⚠️ Signup took longer than ideal (>5s)");
-        }
-        else {
-            console.log("✓ Signup completed in reasonable time");
-        }
-        console.log("Signup result:", {
-            success: signupResult.success,
-            error: signupResult.error || "None",
-        });
-        if (!signupResult.success) {
-            console.error("❌ Signup failed:", signupResult.error);
-            return;
-        }
-    }
-    catch (error) {
-        const signupDuration = Date.now() - signupStartTime;
-        console.error(`❌ Signup threw exception after ${signupDuration}ms:`, error);
-        return;
-    }
-    console.log("");
-    // === TEST 2: NORMAL LOGIN (should complete quickly) ===
-    console.log("🧪 === TEST 2: NORMAL LOGIN ===\n");
-    console.log("Testing login with same credentials");
-    console.log("Expected: Should complete within 10 seconds\n");
-    const loginStartTime = Date.now();
-    try {
-        const loginResult = await db.login(testUsername, testPassword);
-        const loginDuration = Date.now() - loginStartTime;
-        console.log(`✓ Login completed in ${loginDuration}ms`);
-        if (loginDuration > 10000) {
-            console.warn("⚠️ Login took longer than expected (>10s)");
-        }
-        else if (loginDuration > 5000) {
-            console.warn("⚠️ Login took longer than ideal (>5s)");
-        }
-        else {
-            console.log("✓ Login completed in reasonable time");
-        }
-        console.log("Login result:", {
-            success: loginResult.success,
-            error: loginResult.error || "None",
-        });
-        if (!loginResult.success) {
-            console.error("❌ Login failed:", loginResult.error);
-        }
-        else {
-            console.log("✓ User is now logged in:", db.isLoggedIn());
-        }
-    }
-    catch (error) {
-        const loginDuration = Date.now() - loginStartTime;
-        console.error(`❌ Login threw exception after ${loginDuration}ms:`, error);
-    }
-    console.log("");
-    // === TEST 3: INVALID CREDENTIALS (should timeout gracefully) ===
-    console.log("🧪 === TEST 3: INVALID CREDENTIALS TIMEOUT ===\n");
-    console.log("Testing login with invalid password");
-    console.log("Expected: Should timeout after 10 seconds with error message\n");
-    const invalidLoginStartTime = Date.now();
-    try {
-        const invalidLoginResult = await db.login(testUsername, "wrongpassword");
-        const invalidLoginDuration = Date.now() - invalidLoginStartTime;
-        console.log(`✓ Invalid login completed in ${invalidLoginDuration}ms`);
-        console.log("Invalid login result:", {
-            success: invalidLoginResult.success,
-            error: invalidLoginResult.error || "None",
-        });
-        if (invalidLoginDuration > 10000) {
-            console.log("✓ Timeout mechanism worked - operation completed after timeout period");
-        }
-        else {
-            console.log("✓ Invalid credentials were rejected quickly (good)");
-        }
-    }
-    catch (error) {
-        const invalidLoginDuration = Date.now() - invalidLoginStartTime;
-        console.log(`✓ Invalid login threw exception after ${invalidLoginDuration}ms (expected):`, error instanceof Error ? error.message : String(error));
-        if (invalidLoginDuration > 10000) {
-            console.log("✓ Timeout mechanism worked - exception thrown after timeout period");
-        }
-    }
-    console.log("");
-    // === TEST 4: NON-EXISTENT USER (should timeout gracefully) ===
-    console.log("🧪 === TEST 4: NON-EXISTENT USER TIMEOUT ===\n");
-    console.log("Testing login with non-existent user");
-    console.log("Expected: Should timeout after 10 seconds with error message\n");
-    const nonexistentLoginStartTime = Date.now();
-    try {
-        const nonexistentLoginResult = await db.login("nonexistentuser123456", "password");
-        const nonexistentLoginDuration = Date.now() - nonexistentLoginStartTime;
-        console.log(`✓ Non-existent user login completed in ${nonexistentLoginDuration}ms`);
-        console.log("Non-existent user login result:", {
-            success: nonexistentLoginResult.success,
-            error: nonexistentLoginResult.error || "None",
-        });
-        if (nonexistentLoginDuration > 10000) {
-            console.log("✓ Timeout mechanism worked - operation completed after timeout period");
-        }
-        else {
-            console.log("✓ Non-existent user was rejected quickly (good)");
-        }
-    }
-    catch (error) {
-        const nonexistentLoginDuration = Date.now() - nonexistentLoginStartTime;
-        console.log(`✓ Non-existent user login threw exception after ${nonexistentLoginDuration}ms (expected):`, error instanceof Error ? error.message : String(error));
-        if (nonexistentLoginDuration > 10000) {
-            console.log("✓ Timeout mechanism worked - exception thrown after timeout period");
-        }
-    }
-    console.log("");
-    // === TEST 5: STRESS TEST (multiple rapid operations) ===
-    console.log("🧪 === TEST 5: STRESS TEST ===\n");
-    console.log("Testing multiple rapid signup/login operations");
-    console.log("Expected: All operations should complete or timeout gracefully\n");
-    const stressTestPromises = [];
-    const stressTestStartTime = Date.now();
-    for (let i = 0; i < 3; i++) {
-        const username = `stresstest_${Date.now()}_${i}`;
-        const password = "testpass123!@#";
-        stressTestPromises.push(db
-            .signUp(username, password)
-            .then((result) => ({
-            type: "signup",
-            username,
-            success: result.success,
-            error: result.error,
-        }))
-            .catch((error) => ({
-            type: "signup",
-            username,
-            success: false,
-            error: error.message,
-        })));
-    }
-    try {
-        const stressResults = await Promise.all(stressTestPromises);
-        const stressTestDuration = Date.now() - stressTestStartTime;
-        console.log(`✓ Stress test completed in ${stressTestDuration}ms`);
-        console.log("Stress test results:");
-        stressResults.forEach((result, index) => {
-            console.log(`  ${index + 1}. ${result.type} for ${result.username}: ${result.success ? "Success" : "Failed"}`);
-            if (!result.success) {
-                console.log(`     Error: ${result.error}`);
-            }
-        });
-        const successCount = stressResults.filter((r) => r.success).length;
-        console.log(`\n✓ ${successCount}/${stressResults.length} operations succeeded`);
-    }
-    catch (error) {
-        const stressTestDuration = Date.now() - stressTestStartTime;
-        console.error(`❌ Stress test failed after ${stressTestDuration}ms:`, error);
-    }
-    console.log("");
-    // === CLEANUP ===
-    console.log("🧹 === CLEANUP ===\n");
-    try {
-        db.logout();
-        console.log("✓ Logged out successfully");
-    }
-    catch (error) {
-        console.error("❌ Logout failed:", error);
-    }
-    console.log("\n✅ Timeout test completed!");
-    console.log("\n📊 Test Summary:");
-    console.log("- ✓ Normal signup completes quickly");
-    console.log("- ✓ Normal login completes quickly");
-    console.log("- ✓ Invalid credentials timeout gracefully");
-    console.log("- ✓ Non-existent user timeout gracefully");
-    console.log("- ✓ Multiple operations don't interfere with each other");
-    console.log("\n🎯 Key Improvements Verified:");
-    console.log("- Timeout mechanism prevents infinite hanging");
-    console.log("- Error messages are informative");
-    console.log("- Operations complete within reasonable time");
-}
-// Esegui il test
-if (require.main === module) {
-    timeoutTest().catch(console.error);
-}

package/dist/types/examples/mls-advanced-example.d.ts

@@ -1,53 +0,0 @@
-/**
- * MLS Advanced Example
- * Demonstrates advanced MLS features including:
- * - Group creation and management
- * - Member addition/removal
- * - Key rotation and forward secrecy
- * - Message encryption/decryption
- * - Commit processing and synchronization
- */
-declare class MLSGroupDemo {
-    private users;
-    private groupId;
-    private creator;
-    constructor(groupId: string, creatorId: string);
-    /**
-     * Add a user to the demo
-     */
-    addUser(userId: string): Promise<void>;
-    /**
-     * Create the group with the creator
-     */
-    createGroup(): Promise<void>;
-    /**
-     * Add members to the group
-     */
-    addMembers(memberIds: string[]): Promise<void>;
-    /**
-     * Send a message from one user to the group
-     */
-    sendMessage(senderId: string, message: string): Promise<void>;
-    /**
-     * Perform key rotation
-     */
-    rotateKeys(initiatorId: string): Promise<void>;
-    /**
-     * Remove members from the group
-     */
-    removeMembers(memberIds: string[]): Promise<void>;
-    /**
-     * Get group information
-     */
-    getGroupInfo(): Promise<any>;
-    /**
-     * Demonstrate codec functionality
-     */
-    demonstrateCodec(): Promise<void>;
-    /**
-     * Clean up resources
-     */
-    cleanup(): Promise<void>;
-}
-declare function demonstrateMLSAdvanced(): Promise<void>;
-export { MLSGroupDemo, demonstrateMLSAdvanced };

package/dist/types/examples/quick-auth-test.d.ts

@@ -1,8 +0,0 @@
-/**
- * Quick Auth Test Script
- *
- * Simple script to quickly test signup and login functionality
- * Run this to verify that the authentication system is working
- */
-declare function quickAuthTest(): Promise<void>;
-export { quickAuthTest };

package/dist/types/examples/simple-api-test.d.ts

@@ -1,10 +0,0 @@
-/**
- * Example showing how to use the simplified ShogunCore API
- *
- * The API has been streamlined:
- * - AutoQuickStart: Quick initialization helper
- * - api.database: Direct access to DataBase for basic operations (get, put, set, remove, auth)
- * - api helper methods: High-level helpers for profile, settings, collections, and array utilities
- */
-declare function simpleAPITest(): Promise<void>;
-export { simpleAPITest };

package/dist/types/examples/simple-crypto-identity-example.d.ts

@@ -1,6 +0,0 @@
-/**
- * Esempio semplificato del CryptoIdentityManager
- * Focus sulla funzionalità principale senza plugin opzionali
- */
-declare function simpleCryptoIdentityExample(): Promise<void>;
-export { simpleCryptoIdentityExample };

package/dist/types/examples/timeout-test.d.ts

@@ -1,8 +0,0 @@
-/**
- * Timeout Test Script
- *
- * Tests the timeout mechanism for signup and login operations
- * This script specifically tests the fixes we implemented to prevent hanging
- */
-declare function timeoutTest(): Promise<void>;
-export { timeoutTest };