shogun-core 3.0.6 → 3.0.7

package/README.md

@@ -34,12 +34,13 @@ Shogun Core is a comprehensive SDK for building decentralized applications (dApp
 - **⭐ NEW: Quick Start Functions**: `quickStart()` and `QuickStart` class for rapid initialization
 - **⭐ NEW: Improved Type System**: Reduced `any` usage with better TypeScript types
 - **⭐ NEW: Configuration Presets**: Pre-built configurations for common use cases
+- **⭐ NEW: Advanced API Features**: Comprehensive plugin management, peer network control, advanced user management, and security systems
 - **Removed Non-Essential Functions**: Eliminated debug/testing functions, rate limiting system, frozen space system, and complex username management
-- **Simplified Architecture**: Removed cryptographic key derivation functions and advanced peer management
-- **Streamlined Event System**: Removed complex event emission for data and peer operations
-- **Enhanced Core Focus**: Maintained password hint system while removing advanced features
-- **Improved Maintainability**: Reduced codebase complexity by ~400-500 lines
-- **Better Performance**: Simplified operations with reduced overhead
+- **Enhanced Advanced Features**: Maintained and improved advanced plugin management, peer network management, and user tracking systems
+- **Streamlined Event System**: Enhanced event system with better type safety and comprehensive event handling
+- **Enhanced Core Focus**: Maintained password hint system with security questions and comprehensive user management
+- **Improved Maintainability**: Better organized codebase with clear separation between simple and advanced APIs
+- **Better Performance**: Optimized operations with advanced peer management and user tracking
 
 ## Recent Updates (v1.7.0)
 
@@ -629,17 +630,54 @@ You can also use Shogun Core directly in the browser by including it from a CDN.
 - `signUp(username: string, password: string, email?: string, pair?: ISEAPair | null): Promise<SignUpResult>` - Create new user account
 - `logout(): void` - Logout current user
 - `isLoggedIn(): boolean` - Check if user is authenticated
+- `setAuthMethod(method: AuthMethod): void` - Set authentication method
+- `getAuthMethod(): AuthMethod | undefined` - Get current authentication method
+- `saveCredentials(credentials: any): Promise<void>` - Save user credentials
 
 #### Plugin Management
 - `getPlugin<T>(name: string): T | undefined` - Get plugin by name
 - `hasPlugin(name: string): boolean` - Check if plugin exists
 - `register(plugin: ShogunPlugin): void` - Register custom plugin
 - `unregister(pluginName: string): void` - Remove plugin
+- `getPluginsInfo(): Array<{name: string; version: string; category?: PluginCategory; description?: string}>` - Get detailed plugin information
+- `getPluginCount(): number` - Get total number of plugins
+- `getPluginsInitializationStatus(): Record<string, {initialized: boolean; error?: string}>` - Check plugin initialization status
+- `getPluginsByCategory(category: PluginCategory): ShogunPlugin[]` - Get plugins by category
+- `validatePluginSystem(): {...}` - Validate plugin system health
+- `reinitializeFailedPlugins(): {...}` - Reinitialize failed plugins
+- `checkPluginCompatibility(): {...}` - Check plugin compatibility
+- `getPluginSystemDebugInfo(): {...}` - Get comprehensive debug information
+
+#### Peer Network Management (Database)
+- `addPeer(peer: string): void` - Add new peer to network
+- `removePeer(peer: string): void` - Remove peer from network
+- `getCurrentPeers(): string[]` - Get currently connected peers
+- `getAllConfiguredPeers(): string[]` - Get all configured peers
+- `getPeerInfo(): {[peer: string]: {connected: boolean; status: string}}` - Get detailed peer information
+- `reconnectToPeer(peer: string): void` - Reconnect to specific peer
+- `resetPeers(newPeers?: string[]): void` - Reset all peers and optionally add new ones
+
+#### Advanced User Management (Database)
+- `getUserByAlias(alias: string): Promise<{...}>` - Get user by alias/username
+- `getUserDataByPub(userPub: string): Promise<{...}>` - Get user by public key
+- `getUserPubByEpub(epub: string): Promise<string | null>` - Get user public key by encryption key
+- `getUserAliasByPub(userPub: string): Promise<string | null>` - Get user alias by public key
+- `getAllRegisteredUsers(): Promise<Array<{...}>>` - Get all registered users
+- `updateUserLastSeen(userPub: string): Promise<void>` - Update user's last seen timestamp
+
+#### Password Recovery & Security (Database)
+- `setPasswordHintWithSecurity(username: string, password: string, hint: string, securityQuestions: string[], securityAnswers: string[]): Promise<{success: boolean; error?: string}>` - Set up password recovery
+- `forgotPassword(username: string, securityAnswers: string[]): Promise<{success: boolean; hint?: string; error?: string}>` - Recover password
+
+#### Error Handling & Debugging
+- `getRecentErrors(count?: number): ShogunError[]` - Get recent errors for debugging
 
 #### Event Handling
 - `on<K extends keyof ShogunEventMap>(eventName: K, listener: Function): this` - Subscribe to typed events
 - `off<K extends keyof ShogunEventMap>(eventName: K, listener: Function): this` - Unsubscribe from events
+- `once<K extends keyof ShogunEventMap>(eventName: K, listener: Function): this` - Subscribe to one-time events
 - `emit<K extends keyof ShogunEventMap>(eventName: K, data?: ShogunEventMap[K]): boolean` - Emit custom events
+- `removeAllListeners(eventName?: string | symbol): this` - Remove all event listeners
 
 ### Configuration Options
 
@@ -777,9 +815,22 @@ We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) f
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+## Advanced Features
+
+For advanced use cases and comprehensive API coverage, see the [Advanced API Features](./API.md#advanced-api-features) section which includes:
+
+- **Advanced Plugin Management**: Plugin health monitoring, compatibility checking, and system validation
+- **Peer Network Management**: Dynamic peer connection management and network monitoring
+- **Advanced User Management**: Comprehensive user lookup, tracking, and metadata management
+- **Password Recovery & Security**: Secure password hint system with security questions
+- **Error Handling & Debugging**: Advanced error tracking and debugging capabilities
+- **Event System**: Complete event handling reference with type safety
+- **Database Lifecycle**: Advanced database initialization and management
+
 ## Support
 
 - 📖 [Documentation](https://shogun-core-docs.vercel.app/)
+- 📚 [Advanced API Reference](./API.md#advanced-api-features)
 - 💬 [Telegram Community](t.me/shogun_eco)
 - 🐛 [Issue Tracker](https://github.com/scobru/shogun-core/issues)
 

package/dist/browser/shogun-core.js

@@ -87905,6 +87905,7 @@ class DataBase {
         this.crypto = gundb_crypto_namespaceObject;
         this.sea = (sea_default());
         this.node = null;
+        this._rxjs = new RxJS(this.gun);
     }
     /**
      * Initialize the GunInstance asynchronously
@@ -88367,9 +88368,6 @@ class DataBase {
      * @returns GunRxJS instance
      */
     rx() {
-        if (!this._rxjs) {
-            this._rxjs = new RxJS(this.gun);
-        }
         return this._rxjs;
     }
     /**
@@ -89700,6 +89698,10 @@ class SimpleGunAPI {
             return null;
         }
     }
+    // Get Gun node - returns Gun node for chaining operations like .map()
+    getNode(path) {
+        return this.db.get(path);
+    }
     // Simple put - returns success boolean
     async put(path, data) {
         try {
@@ -90105,12 +90107,55 @@ class QuickStart {
         return this.db;
     }
 }
+/**
+ * Auto Quick Start helper - creates a simple API with automatic Gun instance creation
+ * No need to pass a Gun instance, it creates one automatically
+ */
+class AutoQuickStart {
+    db;
+    simpleAPI;
+    gunInstance;
+    constructor(config) {
+        const gunConfig = {
+            peers: config?.peers || [],
+            ...config,
+        };
+        // Remove appScope from gunConfig as it's not a Gun configuration option
+        delete gunConfig.appScope;
+        this.gunInstance = createGun(gunConfig);
+        const appScope = config?.appScope || "shogun";
+        this.db = new DataBase(this.gunInstance, appScope);
+        this.simpleAPI = new SimpleGunAPI(this.db);
+    }
+    // Initialize the database
+    async init() {
+        await this.db.initialize();
+    }
+    // Get the simple API
+    get api() {
+        return this.simpleAPI;
+    }
+    // Get the full database instance for advanced usage
+    get database() {
+        return this.db;
+    }
+    // Get the Gun instance for advanced usage
+    get gun() {
+        return this.gunInstance;
+    }
+}
 /**
  * Global helper for quick setup
  */
 function quickStart(gunInstance, appScope) {
     return new QuickStart(gunInstance, appScope);
 }
+/**
+ * Global helper for auto quick setup - creates Gun instance automatically
+ */
+function autoQuickStart(config) {
+    return new AutoQuickStart(config);
+}
 
 ;// ./src/gundb/index.ts
 // Export the main class