shogun-core 6.2.4 → 6.3.0

package/dist/examples/pgp-example.js

@@ -1,200 +0,0 @@
-"use strict";
-/**
- * PGP Example - Simple and Immediate
- * Demonstrates basic PGP functionality:
- * - Key generation
- * - Message encryption/decryption
- * - Digital signing
- * - Signature verification
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.simplePGPExample = simplePGPExample;
-exports.advancedPGPExample = advancedPGPExample;
-exports.runAllPGPExamples = runAllPGPExamples;
-const crypto_1 = require("../crypto");
-// Simple PGP usage example
-async function simplePGPExample() {
-    try {
-        console.log("🔐 Starting Simple PGP Example");
-        console.log("=".repeat(40));
-        // Method 1: Using factory functions (simplest)
-        console.log("\n📋 Method 1: Factory Functions");
-        // Generate key pairs
-        const aliceKeys = await (0, crypto_1.generatePGPKeyPair)("Alice", "alice@example.com", "alice123");
-        const bobKeys = await (0, crypto_1.generatePGPKeyPair)("Bob", "bob@example.com", "bob123");
-        console.log("✅ Key pairs generated");
-        console.log("Alice Key ID:", aliceKeys.keyId);
-        console.log("Bob Key ID:", bobKeys.keyId);
-        // Encrypt message from Alice to Bob
-        const message = "Hello Bob! This is a secret message from Alice. 🔐";
-        const encrypted = await (0, crypto_1.encryptPGPMessage)(message, bobKeys.publicKey);
-        console.log("✅ Message encrypted");
-        console.log("Encrypted message length:", encrypted.message.length);
-        // Bob decrypts the message
-        const decrypted = await (0, crypto_1.decryptPGPMessage)(encrypted.message, bobKeys.privateKey, "bob123");
-        console.log("✅ Message decrypted");
-        console.log("Original message:", message);
-        console.log("Decrypted message:", decrypted);
-        console.log("Messages match:", message === decrypted);
-        // Alice signs a message
-        const signedMessage = "This is a signed message from Alice. ✍️";
-        const signature = await (0, crypto_1.signPGPMessage)(signedMessage, aliceKeys.privateKey, "alice123");
-        console.log("✅ Message signed");
-        console.log("Signature length:", signature.signature.length);
-        // Bob verifies Alice's signature
-        const verification = await (0, crypto_1.verifyPGPSignature)(signedMessage, signature.signature, aliceKeys.publicKey);
-        console.log("✅ Signature verified");
-        console.log("Signature valid:", verification.valid);
-        console.log("\n🎉 Simple PGP Example completed successfully!");
-        return {
-            success: true,
-            messageDecrypted: message === decrypted,
-            signatureValid: verification.valid,
-        };
-    }
-    catch (error) {
-        console.error("❌ Simple PGP Example failed:", error);
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : "Unknown error",
-        };
-    }
-}
-// Advanced PGP usage with manager
-async function advancedPGPExample() {
-    let manager;
-    try {
-        console.log("\n🔐 Starting Advanced PGP Example");
-        console.log("=".repeat(40));
-        // Method 2: Using PGPManager (more control)
-        manager = await (0, crypto_1.createPGPManager)();
-        console.log("✅ PGP Manager created");
-        // Generate multiple key pairs
-        const users = [
-            { name: "Alice", email: "alice@example.com", passphrase: "alice123" },
-            { name: "Bob", email: "bob@example.com", passphrase: "bob123" },
-            {
-                name: "Charlie",
-                email: "charlie@example.com",
-                passphrase: "charlie123",
-            },
-        ];
-        const userKeys = new Map();
-        for (const user of users) {
-            const keys = await manager.generateKeyPair(user.name, user.email, user.passphrase);
-            userKeys.set(user.name, keys);
-            console.log(`✅ ${user.name} key pair generated: ${keys.keyId}`);
-        }
-        // Test group messaging (Alice sends to Bob and Charlie)
-        console.log("\n📧 Group Messaging Test");
-        const groupMessage = "Hello everyone! This is a group message from Alice. 👥";
-        // Encrypt for Bob
-        const encryptedForBob = await manager.encryptMessage(groupMessage, userKeys.get("Bob").publicKey, userKeys.get("Alice").privateKey, // Alice signs
-        "alice123");
-        // Encrypt for Charlie
-        const encryptedForCharlie = await manager.encryptMessage(groupMessage, userKeys.get("Charlie").publicKey, userKeys.get("Alice").privateKey, // Alice signs
-        "alice123");
-        console.log("✅ Messages encrypted for Bob and Charlie");
-        // Bob decrypts
-        const bobDecrypted = await manager.decryptMessage(encryptedForBob.message, userKeys.get("Bob").privateKey, "bob123");
-        // Charlie decrypts
-        const charlieDecrypted = await manager.decryptMessage(encryptedForCharlie.message, userKeys.get("Charlie").privateKey, "charlie123");
-        console.log("✅ Messages decrypted by Bob and Charlie");
-        console.log("Bob received:", bobDecrypted);
-        console.log("Charlie received:", charlieDecrypted);
-        // Test key information
-        console.log("\n🔍 Key Information");
-        for (const [name, keys] of userKeys) {
-            const keyInfo = await manager.getKeyInfo(keys.publicKey);
-            console.log(`${name}:`, {
-                keyId: keyInfo.keyId,
-                fingerprint: keyInfo.fingerprint,
-                algorithm: keyInfo.algorithm,
-                created: keyInfo.created,
-                isPrivate: keyInfo.isPrivate,
-                isPublic: keyInfo.isPublic,
-            });
-        }
-        // Test key export/import
-        console.log("\n📤 Key Export/Import Test");
-        const aliceKeyArmored = await manager.exportKey(userKeys.get("Alice").publicKey, "armored");
-        const aliceKeyBinary = await manager.exportKey(userKeys.get("Alice").publicKey, "binary");
-        console.log("✅ Alice's key exported in armored and binary formats");
-        console.log("Armored length:", aliceKeyArmored.length);
-        console.log("Binary length:", aliceKeyBinary.length);
-        // Import the binary key back
-        const importedKey = await manager.importKey(aliceKeyBinary, "binary");
-        console.log("✅ Key imported from binary format");
-        console.log("Imported key matches original:", importedKey === userKeys.get("Alice").publicKey);
-        console.log("\n🎉 Advanced PGP Example completed successfully!");
-        return {
-            success: true,
-            groupMessaging: true,
-            keyManagement: true,
-            exportImport: true,
-        };
-    }
-    catch (error) {
-        console.error("❌ Advanced PGP Example failed:", error);
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : "Unknown error",
-        };
-    }
-    finally {
-        // Clean up
-        if (typeof manager !== "undefined") {
-            manager.destroy();
-        }
-    }
-}
-// Run all examples
-async function runAllPGPExamples() {
-    console.log("🚀 Running All PGP Examples");
-    console.log("=".repeat(50));
-    // Example 1: Simple usage
-    console.log("\n=== Example 1: Simple PGP Usage ===");
-    const simpleResult = await simplePGPExample();
-    // Example 2: Advanced usage
-    console.log("\n=== Example 2: Advanced PGP Usage ===");
-    const advancedResult = await advancedPGPExample();
-    // Example 3: Full demonstration
-    console.log("\n=== Example 3: Full PGP Demonstration ===");
-    const demoResult = await (0, crypto_1.demonstratePGP)();
-    console.log("\n📊 Final Results:");
-    console.log("Simple PGP:", simpleResult.success ? "✅ PASSED" : "❌ FAILED");
-    console.log("Advanced PGP:", advancedResult.success ? "✅ PASSED" : "❌ FAILED");
-    console.log("Full Demo:", demoResult.success ? "✅ PASSED" : "❌ FAILED");
-    const allPassed = simpleResult.success && advancedResult.success && demoResult.success;
-    if (allPassed) {
-        console.log("\n🎉 All PGP examples completed successfully!");
-        console.log("🔐 PGP Features Demonstrated:");
-        console.log("  ✅ Key generation (RSA 4096-bit)");
-        console.log("  ✅ Message encryption/decryption");
-        console.log("  ✅ Digital signing and verification");
-        console.log("  ✅ Key management and information");
-        console.log("  ✅ Key export/import (armored/binary)");
-        console.log("  ✅ Group messaging with signing");
-        console.log("  ✅ OpenPGP standard compliance");
-    }
-    else {
-        console.log("\n❌ Some PGP examples failed");
-    }
-    return {
-        simple: simpleResult,
-        advanced: advancedResult,
-        demo: demoResult,
-        allPassed,
-    };
-}
-// Run the examples
-if (require.main === module) {
-    runAllPGPExamples()
-        .then((result) => {
-        console.log("\n📊 Final Test Summary:");
-        console.log(JSON.stringify(result, null, 2));
-    })
-        .catch((error) => {
-        console.error("💥 PGP examples execution failed:", error);
-    });
-}

package/dist/examples/random-generation-test.js

@@ -1,151 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-// Random Generation test
-const crypto_1 = require("../crypto");
-// Test Random Generation
-async function testRandomGeneration() {
-    try {
-        console.log("🎲 Starting Random Generation test...");
-        // Test 1: Basic random string generation
-        console.log("\n1. Testing basic random string generation...");
-        const randomStr = (0, crypto_1.generateRandomString)(16, "test-");
-        console.log("✅ Random string:", randomStr);
-        // Test 2: Random bytes
-        console.log("\n2. Testing random bytes...");
-        const bytes = (0, crypto_1.randomBytes)(8);
-        console.log("✅ Random bytes:", Array.from(bytes)
-            .map((b) => b.toString(16).padStart(2, "0"))
-            .join(""));
-        // Test 3: Random integer
-        console.log("\n3. Testing random integer...");
-        const randomNum = (0, crypto_1.randomInt)(1, 100);
-        console.log("✅ Random integer (1-100):", randomNum);
-        // Test 4: Random float
-        console.log("\n4. Testing random float...");
-        const randomFloatVal = (0, crypto_1.randomFloat)();
-        console.log("✅ Random float:", randomFloatVal);
-        // Test 5: Random boolean
-        console.log("\n5. Testing random boolean...");
-        const randomBoolVal = (0, crypto_1.randomBool)();
-        console.log("✅ Random boolean:", randomBoolVal);
-        // Test 6: Random UUID
-        console.log("\n6. Testing random UUID...");
-        const uuid = (0, crypto_1.randomUUID)();
-        console.log("✅ Random UUID:", uuid);
-        // Test 7: Deterministic random
-        console.log("\n7. Testing deterministic random...");
-        const detRandom = (0, crypto_1.createDeterministicRandom)("test-seed");
-        const detInt1 = detRandom.integer(1, 100);
-        const detInt2 = detRandom.integer(1, 100);
-        const detFloat = detRandom.floating(0, 1, 4);
-        const detBool = detRandom.bool();
-        const detString = detRandom.string(10);
-        const detGuid = detRandom.guid();
-        console.log("✅ Deterministic integer 1:", detInt1);
-        console.log("✅ Deterministic integer 2:", detInt2);
-        console.log("✅ Deterministic float:", detFloat);
-        console.log("✅ Deterministic boolean:", detBool);
-        console.log("✅ Deterministic string:", detString);
-        console.log("✅ Deterministic GUID:", detGuid);
-        // Test 8: Chance.js compatibility
-        console.log("\n8. Testing Chance.js compatibility...");
-        const chanceInstance = (0, crypto_1.chance)("chance-seed");
-        const chanceInt = chanceInstance.integer(1, 50);
-        const chanceFloat = chanceInstance.floating(0, 10, 2);
-        const chanceBool = chanceInstance.bool();
-        console.log("✅ Chance integer:", chanceInt);
-        console.log("✅ Chance float:", chanceFloat);
-        console.log("✅ Chance boolean:", chanceBool);
-        // Test 9: Array utilities
-        console.log("\n9. Testing array utilities...");
-        const testArray = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
-        const choice = (0, crypto_1.randomChoice)(testArray);
-        const shuffled = (0, crypto_1.randomShuffle)(testArray);
-        console.log("✅ Random choice from array:", choice);
-        console.log("✅ Shuffled array:", shuffled);
-        // Test 10: Random color
-        console.log("\n10. Testing random color...");
-        const color = (0, crypto_1.randomColor)();
-        console.log("✅ Random color:", color);
-        // Test 11: Random password
-        console.log("\n11. Testing random password...");
-        const password = (0, crypto_1.randomPassword)({
-            length: 16,
-            includeUppercase: true,
-            includeLowercase: true,
-            includeNumbers: true,
-            includeSymbols: true,
-            excludeSimilar: true,
-        });
-        console.log("✅ Random password:", password);
-        // Test 12: Random seed phrase
-        console.log("\n12. Testing random seed phrase...");
-        const seedPhrase = (0, crypto_1.randomSeedPhrase)(12);
-        console.log("✅ Random seed phrase:", seedPhrase.join(" "));
-        // Test 13: Deterministic consistency
-        console.log("\n13. Testing deterministic consistency...");
-        const det1 = (0, crypto_1.createDeterministicRandom)("consistency-test");
-        const det2 = (0, crypto_1.createDeterministicRandom)("consistency-test");
-        const val1_1 = det1.integer(1, 100);
-        const val1_2 = det1.integer(1, 100);
-        const val2_1 = det2.integer(1, 100);
-        const val2_2 = det2.integer(1, 100);
-        console.log("✅ Deterministic consistency test:");
-        console.log("  Same seed, first value:", val1_1 === val2_1 ? "✅ MATCH" : "❌ MISMATCH");
-        console.log("  Same seed, second value:", val1_2 === val2_2 ? "✅ MATCH" : "❌ MISMATCH");
-        console.log("\n🎉 All Random Generation tests completed successfully!");
-        return {
-            success: true,
-            tests: {
-                randomString: randomStr,
-                randomBytes: Array.from(bytes)
-                    .map((b) => b.toString(16).padStart(2, "0"))
-                    .join(""),
-                randomInt: randomNum,
-                randomFloat: randomFloatVal,
-                randomBool: randomBoolVal,
-                randomUUID: uuid,
-                deterministic: {
-                    int1: detInt1,
-                    int2: detInt2,
-                    float: detFloat,
-                    bool: detBool,
-                    string: detString,
-                    guid: detGuid,
-                },
-                chance: {
-                    int: chanceInt,
-                    float: chanceFloat,
-                    bool: chanceBool,
-                },
-                arrayUtils: {
-                    choice,
-                    shuffledLength: shuffled.length,
-                },
-                color,
-                password,
-                seedPhrase: seedPhrase.join(" "),
-                consistency: {
-                    firstMatch: val1_1 === val2_1,
-                    secondMatch: val1_2 === val2_2,
-                },
-            },
-        };
-    }
-    catch (error) {
-        console.error("❌ Random Generation test error:", error);
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : "Unknown error",
-        };
-    }
-}
-// Run the test
-testRandomGeneration()
-    .then((result) => {
-    console.log("\n📊 Final Result:");
-    console.log(JSON.stringify(result, null, 2));
-})
-    .catch((error) => {
-    console.error("💥 Test execution failed:", error);
-});

package/dist/examples/shogun-core-example.js

@@ -1,150 +0,0 @@
-"use strict";
-/**
- * ShogunCore Example with Existing Gun Instance
- *
- * This example shows how to use ShogunCore with an existing Gun instance.
- * ShogunCore now requires an existing Gun instance to be passed in.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.shogunCoreExample = shogunCoreExample;
-const index_1 = require("../index");
-const core_1 = require("../core");
-async function shogunCoreExample() {
-    console.log("🚀 ShogunCore Example with Existing Gun Instance\n");
-    // === STEP 1: CREATE GUN INSTANCE ===
-    console.log("📦 === CREATING GUN INSTANCE ===\n");
-    const peers = [
-        "https://g3ru5bwxmezpuu3ktnoclbpiw4.srv.us/gun",
-        "https://5eh4twk2f62autunsje4panime.srv.us/gun",
-    ];
-    console.log(`Using peers: ${peers.join(", ")}`);
-    console.log("ℹ️ Note: If peers are unreachable, operations may timeout.");
-    console.log("   Consider using localStorage: true for offline testing.\n");
-    const gunInstance = (0, index_1.Gun)({
-        peers,
-        radisk: false,
-        localStorage: true, // Enable localStorage for offline operations and faster testing
-        // Reduce log noise from SEA verification errors (these are expected when checking invalid credentials)
-        log: () => { }, // Disable Gun.js console logging to reduce noise
-    });
-    console.log("✓ Gun instance created");
-    // === STEP 2: INITIALIZE SHOGUN CORE ===
-    console.log("\n🔧 === INITIALIZING SHOGUN CORE ===\n");
-    const shogun = new core_1.ShogunCore({
-        gunInstance: gunInstance, // Required: existing Gun instance
-        webauthn: {
-            enabled: true,
-            rpName: "ShogunCore Example",
-        },
-        web3: {
-            enabled: true,
-        },
-        silent: false, // Enable console logs
-    });
-    console.log("✓ ShogunCore initialized with existing Gun instance");
-    // === STEP 3: USE SHOGUN CORE ===
-    console.log("\n🎯 === USING SHOGUN CORE ===\n");
-    // Access the database
-    const db = shogun.db;
-    console.log("Database available:", !!db);
-    // Check if user is logged in
-    console.log("User logged in:", shogun.isLoggedIn());
-    // Example: Sign up a new user
-    console.log("\n--- Sign Up Example ---");
-    const username = `testuser_${Date.now()}`;
-    const password = "testpass123";
-    console.log(`Attempting signup for: ${username}`);
-    console.log("⏳ This may take up to 30 seconds if peers are unreachable...\n");
-    let signupResult;
-    try {
-        const signupStartTime = Date.now();
-        signupResult = await shogun.signUp(username, password);
-        const signupDuration = Date.now() - signupStartTime;
-        if (signupResult.success) {
-            console.log(`✓ User signed up successfully in ${signupDuration}ms`);
-            console.log("  Username:", signupResult.username);
-            console.log("  UserPub:", signupResult.userPub?.substring(0, 20) + "...");
-            console.log("  Has SEA Pair:", !!signupResult.sea);
-        }
-        else {
-            console.log(`❌ Sign up failed after ${signupDuration}ms`);
-            console.log("  Error:", signupResult.error);
-            console.log("\n💡 Troubleshooting:");
-            console.log("  - Check if username already exists");
-            console.log("  - Verify network connection to peers");
-            console.log("  - Try with localStorage: true for offline testing");
-        }
-    }
-    catch (error) {
-        console.log("❌ Sign up exception:", error);
-        console.log("  Error type:", error instanceof Error ? error.constructor.name : typeof error);
-        signupResult = { success: false, error: String(error) };
-    }
-    // Example: Login (only if signup succeeded or user already exists)
-    console.log("\n--- Login Example ---");
-    const canLogin = signupResult?.success || signupResult?.error?.includes("already");
-    if (canLogin) {
-        if (signupResult?.success) {
-            console.log("✓ User created, attempting login...");
-        }
-        else if (signupResult?.error?.includes("already")) {
-            console.log("ℹ️ User already exists, attempting login...");
-        }
-        try {
-            console.log("⏳ Login may take up to 30 seconds if peers are unreachable...");
-            const loginStartTime = Date.now();
-            const loginResult = await shogun.login(username, password);
-            const loginDuration = Date.now() - loginStartTime;
-            if (loginResult.success) {
-                console.log(`✓ User logged in successfully in ${loginDuration}ms`);
-                console.log("  Username:", loginResult.username);
-            }
-            else {
-                console.log(`❌ Login failed after ${loginDuration}ms`);
-                console.log("  Error:", loginResult.error);
-                console.log("\n💡 Troubleshooting:");
-                console.log("  - Verify username and password are correct");
-                console.log("  - Check network connection to peers");
-                console.log("  - User may not have been created successfully");
-            }
-        }
-        catch (error) {
-            console.log("❌ Login exception:", error);
-        }
-    }
-    else {
-        console.log("⚠️ Skipping login - signup failed:", signupResult?.error);
-    }
-    // Example: Check current user
-    console.log("\n--- Current User ---");
-    const isLoggedInNow = shogun.isLoggedIn();
-    const currentUser = shogun.getCurrentUser();
-    console.log("Is logged in:", isLoggedInNow);
-    if (currentUser) {
-        console.log("Current user:", {
-            pub: currentUser.pub?.substring(0, 20) + "..." || "N/A",
-            hasUser: !!currentUser.user,
-        });
-    }
-    else {
-        console.log("Current user: null (not logged in)");
-    }
-    // Example: Logout
-    console.log("\n--- Logout Example ---");
-    if (isLoggedInNow) {
-        shogun.logout();
-        console.log("✓ User logged out");
-    }
-    else {
-        console.log("ℹ️ No user to logout");
-    }
-    console.log("\n🎉 Example completed!");
-    console.log("\n💡 Tips:");
-    console.log("  - Enable localStorage: true for offline testing");
-    console.log("  - Use unique usernames to avoid conflicts");
-    console.log("  - Timeout errors usually indicate peer connectivity issues");
-}
-// Run the example
-if (require.main === module) {
-    shogunCoreExample().catch(console.error);
-}

package/dist/examples/signal-protocol-test.js

@@ -1,38 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-// Signal Protocol test
-const crypto_1 = require("../crypto");
-// Test Signal Protocol
-async function testSignalProtocol() {
-    try {
-        console.log("📡 Starting Signal Protocol test...");
-        const result = await (0, crypto_1.demonstrateSignalProtocol)();
-        if (result.success) {
-            console.log("✅ Signal Protocol test successful!");
-            console.log("Alice and Bob have the same secret:", result.aliceSecret === result.bobSecret);
-            console.log("One-time prekey used:", result.usedOneTimePrekey);
-            console.log("Alice secret (first 20 chars):", result.aliceSecret.substring(0, 20) + "...");
-            console.log("Bob secret (first 20 chars):", result.bobSecret.substring(0, 20) + "...");
-        }
-        else {
-            console.log("❌ Signal Protocol test failed");
-        }
-        return result;
-    }
-    catch (error) {
-        console.error("❌ Signal Protocol test error:", error);
-        return {
-            success: false,
-            error: error instanceof Error ? error.message : "Unknown error",
-        };
-    }
-}
-// Run the test
-testSignalProtocol()
-    .then((result) => {
-    console.log("\n📊 Signal Protocol Result:");
-    console.log(JSON.stringify(result, null, 2));
-})
-    .catch((error) => {
-    console.error("💥 Signal Protocol test execution failed:", error);
-});