shogun-core 3.3.6 → 3.3.8

package/dist/gundb/db.js

@@ -79,16 +79,11 @@ const CONFIG = {
     },
 };
 class DataBase {
-    constructor(gun, appScope = "shogun", options) {
+    constructor(gun, appScope = "shogun") {
         this.user = null;
         this.onAuthCallbacks = [];
-        this.disableAutoRecall = false;
-        this.silent = false;
         // Initialize event emitter
         this.eventEmitter = new eventEmitter_1.EventEmitter();
-        // Set options
-        this.disableAutoRecall = options?.disableAutoRecall || false;
-        this.silent = options?.silent || false;
         // Validate Gun instance
         if (!gun) {
             throw new Error("Gun instance is required but was not provided");
@@ -107,14 +102,7 @@ class DataBase {
         }
         this.gun = gun;
         // Recall only if NOT disabled and there's a "pair" in sessionStorage
-        if (!this.disableAutoRecall &&
-            typeof sessionStorage !== "undefined" &&
-            sessionStorage.getItem("pair")) {
-            this.user = this.gun.user().recall({ sessionStorage: true });
-        }
-        else {
-            this.user = this.gun.user();
-        }
+        this.user = this.gun.user().recall({ sessionStorage: true });
         this.subscribeToAuthEvents();
         this.crypto = crypto;
         this.sea = sea_1.default;
@@ -1409,6 +1397,13 @@ class DataBase {
                 : undefined,
         };
     }
+    /**
+     * Performs login with username and password
+     * @param username Username
+     * @param password Password
+     * @param pair SEA pair (optional)
+     * @returns Promise resolving to AuthResult object
+     */
     async login(username, password, pair) {
         try {
             const loginResult = await this.performAuthentication(username, password, pair);
@@ -1422,6 +1417,7 @@ class DataBase {
             await new Promise((resolve) => setTimeout(resolve, 100));
             const userPub = this.gun.user().is?.pub;
             let alias = this.gun.user().is?.alias;
+            let userPair = this.gun.user()?._?.sea;
             if (!alias) {
                 alias = username;
             }
@@ -1454,7 +1450,7 @@ class DataBase {
             try {
                 const userInfo = {
                     alias: username,
-                    pair: pair ?? null,
+                    pair: pair ?? userPair,
                     userPub: userPub,
                 };
                 this.saveCredentials(userInfo);
@@ -1469,6 +1465,39 @@ class DataBase {
             return { success: false, error: String(error) };
         }
     }
+    /**
+     * Performs login with GunDB pair directly
+     * @param username Username
+     * @param pair SEA pair
+     * @returns Promise resolving to AuthResult object
+     */
+    async loginWithPair(username, pair) {
+        try {
+            const loginResult = await this.performAuthentication(username, "", pair);
+            if (!loginResult.success) {
+                return {
+                    success: false,
+                    error: `User '${username}' not found. Please check your username or register first.`,
+                };
+            }
+            await this.runPostAuthOnAuthResult(username, pair.pub || "", {
+                success: true,
+                userPub: pair.pub,
+            });
+            try {
+                await this.updateUserLastSeen(pair.pub);
+            }
+            catch (lastSeenError) {
+                console.error(`Error updating last seen: ${lastSeenError}`);
+                // Continue with login even if last seen update fails
+            }
+            return this.buildLoginResult(username, this.gun.user().is?.pub || "");
+        }
+        catch (error) {
+            console.error(`Exception during login with pair: ${error}`);
+            return { success: false, error: String(error) };
+        }
+    }
     saveCredentials(userInfo) {
         try {
             const sessionInfo = {

package/dist/managers/AuthManager.js

@@ -82,7 +82,7 @@ class AuthManager {
      * @description Authenticates user using a GunDB pair directly.
      * Emits login event on success.
      */
-    async loginWithPair(pair) {
+    async loginWithPair(username, pair) {
         try {
             if (!pair || !pair.pub || !pair.priv || !pair.epub || !pair.epriv) {
                 return {
@@ -91,7 +91,7 @@ class AuthManager {
                 };
             }
             // Use the new loginWithPair method from GunInstance
-            const result = await this.core.db.login("", "", pair);
+            const result = await this.core.db.loginWithPair(username, pair);
             if (result.success) {
                 // Include SEA pair in the response
                 const seaPair = this.core.user?._?.sea;
@@ -101,7 +101,8 @@ class AuthManager {
                 this.currentAuthMethod = "pair";
                 this.core.emit("auth:login", {
                     userPub: result.userPub ?? "",
-                    method: "password",
+                    method: "pair",
+                    username,
                 });
             }
             else {

package/dist/managers/CoreInitializer.js

@@ -97,7 +97,7 @@ class CoreInitializer {
             throw new Error(`Failed to create Gun instance: ${error}`);
         }
         try {
-            this.core.db = new gundb_1.DataBase(this.core._gun, config.gunOptions?.scope || "", { disableAutoRecall: config.disableAutoRecall, silent: config.silent });
+            this.core.db = new gundb_1.DataBase(this.core._gun, config.gunOptions?.scope || "");
             // Note: user is a getter that returns _user, so we don't need to assign it
         }
         catch (error) {

package/dist/types/core.d.ts

@@ -19,7 +19,7 @@ import { PluginManager } from "./managers/PluginManager";
  * @since 2.0.0
  */
 export declare class ShogunCore implements IShogunCore {
-    static readonly API_VERSION = "^3.0.11";
+    static readonly API_VERSION = "^3.3.8";
     db: DataBase;
     storage: ShogunStorage;
     provider?: ethers.Provider;
@@ -237,7 +237,7 @@ export declare class ShogunCore implements IShogunCore {
      * @description Authenticates user using a GunDB pair directly.
      * Emits login event on success.
      */
-    loginWithPair(pair: ISEAPair): Promise<AuthResult>;
+    loginWithPair(username: string, pair: ISEAPair): Promise<AuthResult>;
     /**
      * Register a new user with provided credentials
      * @param username - Username

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

@@ -1,5 +1,10 @@
 /**
- * Esempio semplice che mostra le differenze principali tra i metodi API
+ * 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/gundb/api.d.ts

@@ -1,11 +1,17 @@
 /**
- * Simplified API layer to reduce complexity for common use cases.
- * Provides quick-start methods that wrap the full DataBase functionality.
+ * Simplified API layer focused on valuable helper methods.
+ * Provides quick-start initialization and high-level convenience methods.
+ *
+ * For basic operations (get, put, set, remove, auth), use DataBase directly.
+ * This class provides:
+ * - Quick initialization helpers (QuickStart, AutoQuickStart)
+ * - Array/Object conversion utilities for GunDB
+ * - High-level user data helpers (profile, settings, collections)
  */
-import { GunMessageGet, GunMessagePut } from "gun";
 import { DataBase } from "./db";
 /**
- * Simple API wrapper that provides common operations with minimal complexity.
+ * Simple API wrapper that provides high-level helper methods.
+ * For basic operations, use the DataBase instance directly via the `database` property.
  */
 export declare class SimpleGunAPI {
     private db;
@@ -15,183 +21,40 @@ export declare class SimpleGunAPI {
      */
     constructor(db: DataBase);
     /**
-     * Get data at a given path.
-     * @param path The path to retrieve data from.
-     * @returns The data at the path, or null if not found or on error.
+     * Get direct access to the DataBase instance for full control.
+     * Use this for basic operations like get, put, set, remove, login, etc.
      */
-    get<T = unknown>(path: string): Promise<T | null>;
-    /**
-     * Get the Gun node at a given path for chaining operations.
-     * @param path The path to the node.
-     * @returns The Gun node.
-     */
-    getNode(path: string): any;
-    /**
-     * Get the Gun node at a given path for direct chaining.
-     * @param path The path to the node.
-     * @returns The Gun node.
-     */
-    node(path: string): any;
-    /**
-     * Get a chainable wrapper for a Gun node at a given path.
-     * @param path The path to the node.
-     * @returns An object with chainable methods: get, put, set, once, then, map.
-     */
-    chain(path: string): {
-        get: (subPath: string) => GunMessageGet<any, any>;
-        put: (data: any) => Promise<GunMessagePut>;
-        set: (data: any) => Promise<GunMessagePut>;
-        once: () => Promise<any>;
-        then: () => Promise<any>;
-        map: (callback: (value: any, key: string) => any) => any;
-    };
-    /**
-     * Put data at a given path.
-     * @param path The path to put data to.
-     * @param data The data to put.
-     * @returns The GunMessagePut result.
-     */
-    put<T = unknown>(path: string, data: T): Promise<GunMessagePut>;
-    /**
-     * Set data at a given path (alternative to put).
-     * @param path The path to set data to.
-     * @param data The data to set.
-     * @returns The GunMessagePut result.
-     */
-    set<T = unknown>(path: string, data: T): Promise<GunMessagePut>;
-    /**
-     * Remove data at a given path.
-     * @param path The path to remove data from.
-     * @returns The GunMessagePut result.
-     */
-    remove(path: string): Promise<GunMessagePut>;
-    /**
-     * Log in a user.
-     * @param username The username.
-     * @param password The password.
-     * @returns The user info if successful, or null.
-     */
-    login(username: string, password: string): Promise<{
-        userPub: string;
-        username: string;
-    } | null>;
-    /**
-     * Sign up a new user.
-     * @param username The username.
-     * @param password The password.
-     * @returns The user info if successful, or null.
-     */
-    signup(username: string, password: string): Promise<{
-        userPub: string;
-        username: string;
-    } | null>;
-    /**
-     * Log out the current user.
-     */
-    logout(): void;
-    /**
-     * Check if a user is currently logged in.
-     * @returns True if logged in, false otherwise.
-     */
-    isLoggedIn(): boolean;
-    /**
-     * Get user data at a given path (requires login).
-     * @param path The path to the user data.
-     * @returns The user data, or null if not found or on error.
-     */
-    getUserData<T = unknown>(path: string): Promise<T | null>;
-    /**
-     * Put user data at a given path (requires login).
-     * @param path The path to put data to.
-     * @param data The data to put.
-     * @returns True if successful, false otherwise.
-     */
-    putUserData<T = unknown>(path: string, data: T): Promise<boolean>;
-    /**
-     * Set user data at a given path (alternative to put, requires login).
-     * @param path The path to set data to.
-     * @param data The data to set.
-     * @returns True if successful, false otherwise.
-     */
-    setUserData<T = unknown>(path: string, data: T): Promise<boolean>;
-    /**
-     * Remove user data at a given path (requires login).
-     * @param path The path to remove data from.
-     * @returns True if successful, false otherwise.
-     */
-    removeUserData(path: string): Promise<boolean>;
+    get database(): DataBase;
     /**
      * Convert an array to an indexed object for GunDB storage.
+     * GunDB doesn't store arrays natively, so this converts them to objects indexed by ID.
      * Example: [{id: '1', ...}, {id: '2', ...}] => { "1": {...}, "2": {...} }
-     * @param arr The array to convert.
-     * @returns The indexed object.
-     * @private
-     */
-    private getIndexedObjectFromArray;
-    /**
-     * Convert an indexed object back to an array.
-     * Example: { "1": {...}, "2": {...} } => [{id: '1', ...}, {id: '2', ...}]
-     * @param indexedObj The indexed object to convert.
-     * @returns The array.
-     * @private
-     */
-    private getArrayFromIndexedObject;
-    /**
-     * Convert an array to an indexed object for GunDB storage (public method).
-     * @param arr The array to convert.
-     * @returns The indexed object.
+     * @param arr The array to convert (each item must have an 'id' property).
+     * @returns The indexed object suitable for GunDB storage.
      */
     arrayToIndexedObject<T extends {
         id: string | number;
     }>(arr: T[]): Record<string, T>;
     /**
-     * Convert an indexed object to an array (public method).
+     * Convert an indexed object back to an array.
+     * Reverses the arrayToIndexedObject conversion.
+     * Example: { "1": {...}, "2": {...} } => [{id: '1', ...}, {id: '2', ...}]
      * @param indexedObj The indexed object to convert.
-     * @returns The array.
+     * @returns The array of items.
      */
     indexedObjectToArray<T>(indexedObj: Record<string, T> | null): T[];
     /**
-     * Get the GunDB user node at a given path (requires login).
-     * Useful for advanced operations that need direct GunDB node access.
-     * @param path The path to the user node.
-     * @returns The Gun node.
-     * @throws If not logged in.
-     */
-    getUserNode(path: string): any;
-    /**
-     * Get the GunDB global node at a given path.
-     * Useful for advanced operations that need direct GunDB node access.
-     * @param path The path to the global node.
-     * @returns The Gun node.
+     * Get all user data (returns user's entire data tree).
+     * Requires user to be logged in.
+     * @returns The complete user data tree, or null if not logged in or on error.
      */
-    getGlobalNode(path: string): any;
-    /**
-     * Get the current user info.
-     * @returns The current user info, or null if not logged in.
-     */
-    getCurrentUser(): {
-        pub: string;
-        username?: string;
-    } | null;
-    /**
-     * Check if a user exists by alias.
-     * @param alias The user alias.
-     * @returns True if the user exists, false otherwise.
-     */
-    userExists(alias: string): Promise<boolean>;
-    /**
-     * Get user info by alias.
-     * @param alias The user alias.
-     * @returns The user info, or null if not found.
-     */
-    getUser(alias: string): Promise<{
-        userPub: string;
-        username: string;
-    } | null>;
+    getAllUserData(): Promise<Record<string, unknown> | null>;
     /**
-     * Advanced user space operations
+     * Update user profile with common fields.
+     * Provides a standardized location for user profile data.
+     * @param profileData Profile data to save (name, email, bio, avatar, etc.)
+     * @returns True if successful, false otherwise.
      */
-    getAllUserData(): Promise<Record<string, unknown> | null>;
     updateProfile(profileData: {
         name?: string;
         email?: string;
@@ -199,14 +62,63 @@ export declare class SimpleGunAPI {
         avatar?: string;
         [key: string]: unknown;
     }): Promise<boolean>;
+    /**
+     * Get user profile data.
+     * @returns The user profile data, or null if not found or not logged in.
+     */
     getProfile(): Promise<Record<string, unknown> | null>;
+    /**
+     * Save user settings.
+     * Provides a standardized location for application settings.
+     * @param settings Settings object to save.
+     * @returns True if successful, false otherwise.
+     */
     saveSettings(settings: Record<string, unknown>): Promise<boolean>;
+    /**
+     * Get user settings.
+     * @returns The user settings, or null if not found or not logged in.
+     */
     getSettings(): Promise<Record<string, unknown> | null>;
+    /**
+     * Save user preferences.
+     * Provides a standardized location for user preferences (distinct from settings).
+     * @param preferences Preferences object to save.
+     * @returns True if successful, false otherwise.
+     */
     savePreferences(preferences: Record<string, unknown>): Promise<boolean>;
+    /**
+     * Get user preferences.
+     * @returns The user preferences, or null if not found or not logged in.
+     */
     getPreferences(): Promise<Record<string, unknown> | null>;
+    /**
+     * Create a user collection with initial items.
+     * Provides a standardized location for user collections.
+     * @param collectionName The name of the collection.
+     * @param items The initial items for the collection.
+     * @returns True if successful, false otherwise.
+     */
     createCollection<T = unknown>(collectionName: string, items: Record<string, T>): Promise<boolean>;
+    /**
+     * Add an item to a user collection.
+     * @param collectionName The name of the collection.
+     * @param itemId The ID of the item to add.
+     * @param item The item data.
+     * @returns True if successful, false otherwise.
+     */
     addToCollection<T = unknown>(collectionName: string, itemId: string, item: T): Promise<boolean>;
+    /**
+     * Get a user collection.
+     * @param collectionName The name of the collection.
+     * @returns The collection data, or null if not found or not logged in.
+     */
     getCollection(collectionName: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Remove an item from a user collection.
+     * @param collectionName The name of the collection.
+     * @param itemId The ID of the item to remove.
+     * @returns True if successful, false otherwise.
+     */
     removeFromCollection(collectionName: string, itemId: string): Promise<boolean>;
 }
 /**

package/dist/types/gundb/db.d.ts

@@ -29,12 +29,7 @@ declare class DataBase {
     private readonly onAuthCallbacks;
     private readonly eventEmitter;
     private _rxjs?;
-    private disableAutoRecall;
-    private silent;
-    constructor(gun: IGunInstance, appScope?: string, options?: {
-        disableAutoRecall?: boolean;
-        silent?: boolean;
-    });
+    constructor(gun: IGunInstance, appScope?: string);
     /**
      * Initialize the GunInstance asynchronously
      * This method should be called after construction to perform async operations
@@ -280,7 +275,21 @@ declare class DataBase {
      * Builds login result object
      */
     private buildLoginResult;
+    /**
+     * Performs login with username and password
+     * @param username Username
+     * @param password Password
+     * @param pair SEA pair (optional)
+     * @returns Promise resolving to AuthResult object
+     */
     login(username: string, password: string, pair?: ISEAPair | null): Promise<AuthResult>;
+    /**
+     * Performs login with GunDB pair directly
+     * @param username Username
+     * @param pair SEA pair
+     * @returns Promise resolving to AuthResult object
+     */
+    loginWithPair(username: string, pair: ISEAPair): Promise<AuthResult>;
     private saveCredentials;
     /**
      * Sets up security questions and password hint

package/dist/types/interfaces/events.d.ts

@@ -10,7 +10,7 @@ import { EventEmitter } from "../utils/eventEmitter";
 export interface AuthEventData {
     userPub?: string;
     username?: string;
-    method: "password" | "webauthn" | "web3" | "nostr" | "oauth" | "bitcoin";
+    method: "password" | "webauthn" | "web3" | "nostr" | "oauth" | "bitcoin" | "pair";
     provider?: string;
 }
 /**

package/dist/types/interfaces/shogun.d.ts

@@ -40,6 +40,12 @@ export declare enum CorePlugins {
     OAuth = "oauth"
 }
 export type AuthMethod = "password" | "webauthn" | "web3" | "nostr" | "oauth" | "pair";
+export interface AuthEventData {
+    userPub?: string;
+    username?: string;
+    method: "password" | "webauthn" | "web3" | "nostr" | "oauth" | "pair";
+    provider?: string;
+}
 export interface AuthResult {
     success: boolean;
     error?: string;
@@ -133,7 +139,7 @@ export interface IShogunCore extends PluginManager {
     emit<K extends keyof ShogunEventMap>(eventName: K, data?: ShogunEventMap[K] extends void ? never : ShogunEventMap[K]): boolean;
     getRecentErrors(count?: number): ShogunError[];
     login(username: string, password: string, pair?: ISEAPair | null): Promise<AuthResult>;
-    loginWithPair(pair: ISEAPair): Promise<AuthResult>;
+    loginWithPair(username: string, pair: ISEAPair): Promise<AuthResult>;
     signUp(username: string, password?: string, pair?: ISEAPair | null): Promise<SignUpResult>;
     getAuthenticationMethod(type: AuthMethod): any;
     setAuthMethod(method: AuthMethod): void;

package/dist/types/managers/AuthManager.d.ts

@@ -36,7 +36,7 @@ export declare class AuthManager {
      * @description Authenticates user using a GunDB pair directly.
      * Emits login event on success.
      */
-    loginWithPair(pair: ISEAPair): Promise<AuthResult>;
+    loginWithPair(username: string, pair: ISEAPair): Promise<AuthResult>;
     /**
      * Register a new user with provided credentials
      * @param username - Username

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shogun-core",
-  "version": "3.3.6",
+  "version": "3.3.8",
   "description": "SHOGUN CORE - Core library for Shogun Ecosystem",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -50,22 +50,15 @@
   "author": "Scobru",
   "license": "MIT",
   "dependencies": {
-    "@fluidkey/stealth-account-kit": "^1.1.0",
     "@noble/curves": "^1.9.1",
-    "@scure/bip32": "^2.0.1",
     "assert": "^2.1.0",
-    "base64url": "^3.0.1",
     "buffer": "^6.0.3",
     "constants-browserify": "^1.0.0",
     "crypto-browserify": "^3.12.0",
     "ethers": "^6.13.5",
     "gun": "git+https://github.com/amark/gun.git",
-    "keccak256": "^1.0.6",
     "nostr-tools": "^2.15.0",
-    "qs": "^6.14.0",
     "rxjs": "^7.8.2",
-    "ts-node": "^10.9.2",
-    "url": "^0.11.4",
     "uuid": "^11.1.0",
     "vm-browserify": "^1.1.2"
   },