Class ShogunCore

constructor

• new ShogunCore(config: ShogunSDKConfig): ShogunCore

  Initialize the Shogun SDK

  Parameters

  • config: ShogunSDKConfig

    SDK Configuration object

  Returns ShogunCore

  Description

  Creates a new instance of ShogunCore with the provided configuration. Initializes all required components including storage, event emitter, GunInstance connection, and plugin system.

config

gundb

Optionalprovider

rx

storage

Static ReadonlyAPI_VERSION

gun

• get gun(): IGunInstance<any>

  Access to the Gun instance

  Returns IGunInstance<any>

  The Gun instance

user

• get user(): null | IGunUserInstance<any, any, any, any>

  Access to the current user

  Returns null | IGunUserInstance<any, any, any, any>

  The current Gun user instance

configureLogging

• configureLogging(config: LoggingConfig): void

  Configure logging behavior for the Shogun SDK

  Parameters

  • config: LoggingConfig

    Logging configuration object containing:

    • level: The minimum log level to display (error, warn, info, debug, trace)
    • logToConsole: Whether to output logs to the console (default: true)
    • customLogger: Optional custom logger implementation
    • logTimestamps: Whether to include timestamps in logs (default: true)

  Returns void

  Description

  Updates the logging configuration for the SDK. Changes take effect immediately for all subsequent log operations.

emit

• emit(eventName: string | symbol, data?: any): boolean

  Emits an event through the core's event emitter. Plugins should use this method to emit events instead of accessing the private eventEmitter directly.

  Parameters

  • eventName: string | symbol

    The name of the event to emit.
  • Optionaldata: any

    The data to pass with the event.

  Returns boolean

  Indicates if the event had listeners.

getAuthenticationMethod

• getAuthenticationMethod(type: AuthMethod): unknown

  Get an authentication method plugin by type

  Parameters

  • type: AuthMethod

    The type of authentication method

  Returns unknown

  The authentication plugin or undefined if not available This is a more modern approach to accessing authentication methods

getAuthMethod

• getAuthMethod(): undefined | AuthMethod

  Get the current authentication method

  Returns undefined | AuthMethod

  The current authentication method or undefined if not set

getPlugin

• getPlugin<T>(name: string): undefined | T

  Retrieve a registered plugin by name

  Type Parameters

  • T

    Type of the plugin or its public interface

  Parameters

  • name: string

    Name of the plugin

  Returns undefined | T

  The requested plugin or undefined if not found

getPluginsByCategory

• getPluginsByCategory(category: PluginCategory): ShogunPlugin[]

  Get all plugins of a specific category

  Parameters

  • category: PluginCategory

    Category of plugins to filter

  Returns ShogunPlugin[]

  Array of plugins in the specified category

getRecentErrors

• getRecentErrors(count?: number): ShogunError[]

  Retrieve recent errors logged by the system

  Parameters

  • count: number = 10

    Number of errors to retrieve (default: 10)

  Returns ShogunError[]

  List of most recent errors

hasPlugin

• hasPlugin(name: string): boolean

  Check if a plugin is registered

  Parameters

  • name: string

    Name of the plugin to check

  Returns boolean

  true if the plugin is registered, false otherwise

isLoggedIn

• isLoggedIn(): boolean

  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

login

• login(username: string, password: string): Promise<AuthResult>

  Authenticate user with username and password

  Parameters

  • username: string

    Username
  • password: string

    User password

  Returns Promise<AuthResult>

  Promise with authentication result

  Description

  Attempts to log in user with provided credentials. Emits login event on success.

logout

• logout(): void

  Perform user logout

  Returns void

  Description

  Logs out the current user from GunInstance and emits logout event. If user is not authenticated, the logout operation is ignored.

off

• off(eventName: string | symbol, listener: (data: unknown) => void): this

  Remove an event listener

  Parameters

  • eventName: string | symbol

    The name of the event to stop listening for
  • listener: (data: unknown) => void

    The callback function to remove

  Returns this

  Returns this instance for method chaining

on

• on(eventName: string | symbol, listener: (data: unknown) => void): this

  Add an event listener

  Parameters

  • eventName: string | symbol

    The name of the event to listen for
  • listener: (data: unknown) => void

    The callback function to execute when the event is emitted

  Returns this

  Returns this instance for method chaining

once

• once(eventName: string | symbol, listener: (data: unknown) => void): this

  Add a one-time event listener

  Parameters

  • eventName: string | symbol

    The name of the event to listen for
  • listener: (data: unknown) => void

    The callback function to execute when the event is emitted

  Returns this

  Returns this instance for method chaining

register

• register(plugin: ShogunPlugin): void

  Register a new plugin with the SDK

  Parameters

  • plugin: ShogunPlugin

    The plugin to register

  Returns void

  Throws

  Error if a plugin with the same name is already registered

removeAllListeners

• removeAllListeners(eventName?: string | symbol): this

  Remove all listeners for a specific event or all events

  Parameters

  • OptionaleventName: string | symbol

    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

setAuthMethod

• setAuthMethod(method: AuthMethod): void

  Set the current authentication method This is used by plugins to indicate which authentication method was used

  Parameters

  • method: AuthMethod

    The authentication method used

  Returns void

signUp

• signUp(
      username: string,
      password: string,
      passwordConfirmation?: string,
  ): Promise<SignUpResult>

  Register a new user with provided credentials

  Parameters

  • username: string

    Username
  • password: string

    Password
  • OptionalpasswordConfirmation: string

    Password confirmation

  Returns Promise<SignUpResult>

  Registration result

  Description

  Creates a new user account with the provided credentials. Validates password requirements and emits signup event on success.

unregister

• unregister(pluginName: string): void

  Unregister a plugin from the SDK

  Parameters

  • pluginName: string

    Name of the plugin to unregister

  Returns void