shogun-core 3.0.2 → 3.0.4

package/dist/config/simplified-config.js

@@ -1,230 +0,0 @@
-/**
- * Simplified configuration options to reduce complexity
- * Provides sensible defaults and easy-to-use presets
- */
-/**
- * Preset configurations for common use cases
- */
-export const ShogunPresets = {
-    /**
-     * Minimal configuration for simple apps
-     */
-    minimal: () => ({
-        gunOptions: {
-            peers: ["https://gunjs.herokuapp.com/gun"],
-            localStorage: true,
-        },
-    }),
-    /**
-     * Development configuration with local storage
-     */
-    development: () => ({
-        gunOptions: {
-            peers: ["https://gunjs.herokuapp.com/gun"],
-            localStorage: true,
-            radisk: false,
-        },
-        timeouts: {
-            login: 5000,
-            signup: 5000,
-            operation: 3000,
-        },
-    }),
-    /**
-     * Production configuration with multiple peers
-     */
-    production: (customPeers) => ({
-        gunOptions: {
-            peers: customPeers || [
-                "https://gunjs.herokuapp.com/gun",
-                "https://gun-manhattan.herokuapp.com/gun",
-            ],
-            localStorage: true,
-            radisk: true,
-        },
-        timeouts: {
-            login: 10000,
-            signup: 10000,
-            operation: 5000,
-        },
-    }),
-    /**
-     * Offline-first configuration
-     */
-    offline: () => ({
-        gunOptions: {
-            peers: [],
-            localStorage: true,
-            radisk: true,
-        },
-    }),
-    /**
-     * Web3-enabled configuration
-     */
-    web3: () => ({
-        gunOptions: {
-            peers: ["https://gunjs.herokuapp.com/gun"],
-            localStorage: true,
-        },
-        web3: {
-            enabled: true,
-        },
-    }),
-    /**
-     * WebAuthn-enabled configuration
-     */
-    webauthn: () => ({
-        gunOptions: {
-            peers: ["https://gunjs.herokuapp.com/gun"],
-            localStorage: true,
-        },
-        webauthn: {
-            enabled: true,
-            rpName: "My Shogun App",
-            rpId: window.location.hostname,
-        },
-    }),
-};
-/**
- * Configuration builder for custom setups
- */
-export class ShogunConfigBuilder {
-    config = {};
-    /**
-     * Set Gun options
-     */
-    gunOptions(options) {
-        this.config.gunOptions = { ...this.config.gunOptions, ...options };
-        return this;
-    }
-    /**
-     * Add peers
-     */
-    peers(peerList) {
-        this.config.gunOptions = {
-            ...this.config.gunOptions,
-            peers: [...(this.config.gunOptions?.peers || []), ...peerList],
-        };
-        return this;
-    }
-    /**
-     * Enable WebAuthn
-     */
-    enableWebAuthn(rpName, rpId) {
-        this.config.webauthn = {
-            enabled: true,
-            rpName: rpName || "My App",
-            rpId: rpId || window.location.hostname,
-        };
-        return this;
-    }
-    /**
-     * Enable Web3
-     */
-    enableWeb3() {
-        this.config.web3 = { enabled: true };
-        return this;
-    }
-    /**
-     * Enable Nostr
-     */
-    enableNostr() {
-        this.config.nostr = { enabled: true };
-        return this;
-    }
-    /**
-     * Set timeouts
-     */
-    timeouts(timeouts) {
-        this.config.timeouts = { ...this.config.timeouts, ...timeouts };
-        return this;
-    }
-    /**
-     * Build the final configuration
-     */
-    build() {
-        return this.config;
-    }
-}
-/**
- * Helper functions for common configuration patterns
- */
-export const ConfigHelpers = {
-    /**
-     * Create a configuration for a specific environment
-     */
-    forEnvironment(env) {
-        switch (env) {
-            case "development":
-                return ShogunPresets.development();
-            case "production":
-                return ShogunPresets.production();
-            case "test":
-                return ShogunPresets.offline();
-            default:
-                return ShogunPresets.minimal();
-        }
-    },
-    /**
-     * Create a configuration with custom peers
-     */
-    withPeers(peers) {
-        return ShogunPresets.production(peers);
-    },
-    /**
-     * Create a configuration for a specific use case
-     */
-    forUseCase(useCase) {
-        const baseConfig = ShogunPresets.production();
-        switch (useCase) {
-            case "chat":
-                return {
-                    ...baseConfig,
-                    timeouts: { ...baseConfig.timeouts, operation: 2000 },
-                };
-            case "social":
-                return {
-                    ...baseConfig,
-                    webauthn: { enabled: true, rpName: "Social App" },
-                };
-            case "gaming":
-                return {
-                    ...baseConfig,
-                    timeouts: { ...baseConfig.timeouts, operation: 1000 },
-                };
-            case "finance":
-                return {
-                    ...baseConfig,
-                    webauthn: { enabled: true, rpName: "Finance App" },
-                    timeouts: { ...baseConfig.timeouts, login: 15000 },
-                };
-            default:
-                return baseConfig;
-        }
-    },
-};
-/**
- * Quick configuration functions
- */
-export const QuickConfig = {
-    /**
-     * Minimal setup for quick testing
-     */
-    test: () => ShogunPresets.minimal(),
-    /**
-     * Standard setup for most apps
-     */
-    standard: () => ShogunPresets.production(),
-    /**
-     * Setup with WebAuthn for secure apps
-     */
-    secure: () => ShogunPresets.webauthn(),
-    /**
-     * Setup with Web3 for crypto apps
-     */
-    crypto: () => ShogunPresets.web3(),
-    /**
-     * Offline setup for local development
-     */
-    local: () => ShogunPresets.offline(),
-};

package/dist/core.js

@@ -1,338 +0,0 @@
-import { ErrorHandler } from "./utils/errorHandler";
-// Import managers
-import { PluginManager } from "./managers/PluginManager";
-import { AuthManager } from "./managers/AuthManager";
-import { EventManager } from "./managers/EventManager";
-import { CoreInitializer } from "./managers/CoreInitializer";
-/**
- * Main ShogunCore class - implements the IShogunCore interface
- *
- * This is the primary entry point for the Shogun SDK, providing access to:
- * - Decentralized database (GunInstance)
- * - Authentication methods (traditional, WebAuthn, MetaMask)
- * - Plugin system for extensibility
- * - RxJS integration for reactive programming
- *
- * @since 2.0.0
- */
-export class ShogunCore {
-    static API_VERSION = "^3.0.1";
-    db;
-    storage;
-    provider;
-    config;
-    rx;
-    _gun;
-    _user = null;
-    wallets;
-    // Managers
-    pluginManager;
-    authManager;
-    eventManager;
-    coreInitializer;
-    /**
-     * Initialize the Shogun SDK
-     * @param config - SDK Configuration object
-     * @description Creates a new instance of ShogunCore with the provided configuration.
-     * Initializes all required components including storage, event emitter, GunInstance connection,
-     * and plugin system.
-     */
-    constructor(config) {
-        this.config = config;
-        // Initialize managers
-        this.eventManager = new EventManager();
-        this.pluginManager = new PluginManager(this);
-        this.authManager = new AuthManager(this);
-        this.coreInitializer = new CoreInitializer(this);
-        // Initialize async components
-        this.coreInitializer.initialize(config).catch((error) => {
-            if (typeof console !== "undefined" && console.warn) {
-                console.warn("Error during async initialization:", error);
-            }
-        });
-    }
-    /**
-     * Access to the Gun instance
-     * @returns The Gun instance
-     */
-    get gun() {
-        return this._gun;
-    }
-    /**
-     * Access to the current user
-     * @returns The current Gun user instance
-     */
-    get user() {
-        return this._user;
-    }
-    /**
-     * Gets the current user information
-     * @returns Current user object or null
-     */
-    getCurrentUser() {
-        if (!this.db) {
-            return null;
-        }
-        return this.db.getCurrentUser();
-    }
-    // *********************************************************************************************************
-    // 🔌 PLUGIN MANAGEMENT 🔌
-    // *********************************************************************************************************
-    /**
-     * Registers a plugin with the Shogun SDK
-     * @param plugin Plugin instance to register
-     * @throws Error if a plugin with the same name is already registered
-     */
-    register(plugin) {
-        this.pluginManager.register(plugin);
-    }
-    /**
-     * Unregisters a plugin from the Shogun SDK
-     * @param pluginName Name of the plugin to unregister
-     */
-    unregister(pluginName) {
-        this.pluginManager.unregister(pluginName);
-    }
-    /**
-     * Retrieve a registered plugin by name
-     * @param name Name of the plugin
-     * @returns The requested plugin or undefined if not found
-     * @template T Type of the plugin or its public interface
-     */
-    getPlugin(name) {
-        return this.pluginManager.getPlugin(name);
-    }
-    /**
-     * Get information about all registered plugins
-     * @returns Array of plugin information objects
-     */
-    getPluginsInfo() {
-        return this.pluginManager.getPluginsInfo();
-    }
-    /**
-     * Get the total number of registered plugins
-     * @returns Number of registered plugins
-     */
-    getPluginCount() {
-        return this.pluginManager.getPluginCount();
-    }
-    /**
-     * Check if all plugins are properly initialized
-     * @returns Object with initialization status for each plugin
-     */
-    getPluginsInitializationStatus() {
-        return this.pluginManager.getPluginsInitializationStatus();
-    }
-    /**
-     * Validate plugin system integrity
-     * @returns Object with validation results
-     */
-    validatePluginSystem() {
-        return this.pluginManager.validatePluginSystem();
-    }
-    /**
-     * Attempt to reinitialize failed plugins
-     * @returns Object with reinitialization results
-     */
-    reinitializeFailedPlugins() {
-        return this.pluginManager.reinitializeFailedPlugins();
-    }
-    /**
-     * Check plugin compatibility with current ShogunCore version
-     * @returns Object with compatibility information
-     */
-    checkPluginCompatibility() {
-        return this.pluginManager.checkPluginCompatibility();
-    }
-    /**
-     * Get comprehensive debug information about the plugin system
-     * @returns Complete plugin system debug information
-     */
-    getPluginSystemDebugInfo() {
-        return this.pluginManager.getPluginSystemDebugInfo();
-    }
-    /**
-     * Check if a plugin is registered
-     * @param name Name of the plugin to check
-     * @returns true if the plugin is registered, false otherwise
-     */
-    hasPlugin(name) {
-        return this.pluginManager.hasPlugin(name);
-    }
-    /**
-     * Get all plugins of a specific category
-     * @param category Category of plugins to filter
-     * @returns Array of plugins in the specified category
-     */
-    getPluginsByCategory(category) {
-        return this.pluginManager.getPluginsByCategory(category);
-    }
-    /**
-     * Get an authentication method plugin by type
-     * @param type The type of authentication method
-     * @returns The authentication plugin or undefined if not available
-     * This is a more modern approach to accessing authentication methods
-     */
-    getAuthenticationMethod(type) {
-        return this.authManager.getAuthenticationMethod(type);
-    }
-    // *********************************************************************************************************
-    // 🔐 ERROR HANDLER 🔐
-    // *********************************************************************************************************
-    /**
-     * Retrieve recent errors logged by the system
-     * @param count - Number of errors to retrieve (default: 10)
-     * @returns List of most recent errors
-     */
-    getRecentErrors(count = 10) {
-        return ErrorHandler.getRecentErrors(count);
-    }
-    // *********************************************************************************************************
-    // 🔐 AUTHENTICATION
-    // *********************************************************************************************************
-    /**
-     * Check if user is logged in
-     * @returns {boolean} True if user is logged in, false otherwise
-     * @description Verifies authentication status by checking GunInstance login state
-     * and presence of authentication credentials in storage
-     */
-    isLoggedIn() {
-        return this.authManager.isLoggedIn();
-    }
-    /**
-     * Perform user logout
-     * @description Logs out the current user from GunInstance and emits logout event.
-     * If user is not authenticated, the logout operation is ignored.
-     */
-    logout() {
-        this.authManager.logout();
-    }
-    /**
-     * Authenticate user with username and password
-     * @param username - Username
-     * @param password - User password
-     * @returns {Promise<AuthResult>} Promise with authentication result
-     * @description Attempts to log in user with provided credentials.
-     * Emits login event on success.
-     */
-    async login(username, password, pair) {
-        return this.authManager.login(username, password, pair);
-    }
-    /**
-     * Login with GunDB pair directly
-     * @param pair - GunDB SEA pair for authentication
-     * @returns {Promise<AuthResult>} Promise with authentication result
-     * @description Authenticates user using a GunDB pair directly.
-     * Emits login event on success.
-     */
-    async loginWithPair(pair) {
-        return this.authManager.loginWithPair(pair);
-    }
-    /**
-     * Register a new user with provided credentials
-     * @param username - Username
-     * @param password - Password
-     * @param email - Email (optional)
-     * @param pair - Pair of keys
-     * @returns {Promise<SignUpResult>} Registration result
-     * @description Creates a new user account with the provided credentials.
-     * Validates password requirements and emits signup event on success.
-     */
-    async signUp(username, password, pair) {
-        return this.authManager.signUp(username, password, pair);
-    }
-    // 📢 EVENT EMITTER 📢
-    /**
-     * Emits an event through the core's event emitter.
-     * Plugins should use this method to emit events instead of accessing the private eventEmitter directly.
-     * @param eventName The name of the event to emit.
-     * @param data The data to pass with the event.
-     * @returns {boolean} Indicates if the event had listeners.
-     */
-    emit(eventName, data) {
-        return this.eventManager.emit(eventName, data);
-    }
-    /**
-     * Add an event listener
-     * @param eventName The name of the event to listen for
-     * @param listener The callback function to execute when the event is emitted
-     * @returns {this} Returns this instance for method chaining
-     */
-    on(eventName, listener) {
-        this.eventManager.on(eventName, listener);
-        return this;
-    }
-    /**
-     * Add a one-time event listener
-     * @param eventName The name of the event to listen for
-     * @param listener The callback function to execute when the event is emitted
-     * @returns {this} Returns this instance for method chaining
-     */
-    once(eventName, listener) {
-        this.eventManager.once(eventName, listener);
-        return this;
-    }
-    /**
-     * Remove an event listener
-     * @param eventName The name of the event to stop listening for
-     * @param listener The callback function to remove
-     * @returns {this} Returns this instance for method chaining
-     */
-    off(eventName, listener) {
-        this.eventManager.off(eventName, listener);
-        return this;
-    }
-    /**
-     * Remove all listeners for a specific event or all events
-     * @param eventName Optional. The name of the event to remove listeners for.
-     * If not provided, all listeners for all events are removed.
-     * @returns {this} Returns this instance for method chaining
-     */
-    removeAllListeners(eventName) {
-        this.eventManager.removeAllListeners(eventName);
-        return this;
-    }
-    /**
-     * Set the current authentication method
-     * This is used by plugins to indicate which authentication method was used
-     * @param method The authentication method used
-     */
-    setAuthMethod(method) {
-        this.authManager.setAuthMethod(method);
-    }
-    /**
-     * Get the current authentication method
-     * @returns The current authentication method or undefined if not set
-     */
-    getAuthMethod() {
-        return this.authManager.getAuthMethod();
-    }
-    /**
-     * Saves the current user credentials to storage
-     */
-    async saveCredentials(credentials) {
-        try {
-            this.storage.setItem("userCredentials", JSON.stringify(credentials));
-        }
-        catch (error) {
-            if (typeof console !== "undefined" && console.warn) {
-                console.warn("Failed to save credentials to storage");
-            }
-            if (typeof console !== "undefined" && console.error) {
-                console.error(`Error saving credentials:`, error);
-            }
-        }
-    }
-    getIsLoggedIn() {
-        return !!(this.user && this.user.is);
-    }
-}
-// Global declarations are handled in the original core.ts file
-// to avoid conflicts, we only set the window properties here
-if (typeof window !== "undefined") {
-    window.SHOGUN_CORE = (config) => {
-        return new ShogunCore(config);
-    };
-    window.SHOGUN_CORE_CLASS = ShogunCore;
-}
-export default ShogunCore;