@futoin/msgbot v0.3.3

About

WORK IN PROGRESS

Reference implementation of:

FTN22: FutoIn Interface - Message Bot
Version: 0.x

• Spec: FTN22: FutoIn Interface - Message Bot

Author: Andrey Galkin

Installation for Node.js

Command line:

$ npm install @futoin/msgbot --save

API documentation

Classes

CommandRouterFace

FTN22: Command Router Face

Kind: global class

CommandRouterService

Command Router Service

Kind: global class

new CommandRouterService(options)

C-tor

PushHandlerFace

FTN22: Push Handler Face

Kind: global class

PushHandlerService

Push Handler Service base

Kind: global class

PushRouterService

Push Router Service base

Kind: global class

ReactHandlerFace

FTN22: React Handler Face

Kind: global class

ReactHandlerService

React Handler Service base

Kind: global class

ServerFace

FTN22: Server Face

Kind: global class

• ServerFace
  • instance
    • .getFlavour(asi)
    • .helpers() ⇒ ServerHelpers
    • .systemIface()
  • static
    • .register(asi, ccm, name, endpoint, [credentials], [options])

serverFace.getFlavour(asi)

Get type of database

Kind: instance method of ServerFace

serverFace.helpers() ⇒ ServerHelpers

Get native server helpers

Kind: instance method of ServerFace
Returns: ServerHelpers - - driver implementation

serverFace.systemIface()

Get native message system interface implementation

Kind: instance method of ServerFace

ServerFace.register(asi, ccm, name, endpoint, credentials, options)

CCM registration helper

Kind: static method of ServerFace

ServerHelpers

FTN22: Server-specific helpers

Kind: global class

• ServerHelpers
  • instance
    • .bold(str) ⇒ string
    • .italic(str) ⇒ string
    • .color(str, hexcolor) ⇒ string
    • .imgUrl(url) ⇒ string
    • .emoji(name) ⇒ string
    • .line() ⇒ string
    • .menion(ext_id) ⇒ string
  • static
    • .setDriver(flavour, impl)
    • .getDriver(flavour) ⇒ ServerHelpers

serverHelpers.bold(str) ⇒ string

Get bold text

Kind: instance method of ServerHelpers
Returns: string - bold output

serverHelpers.italic(str) ⇒ string

Get italic text

Kind: instance method of ServerHelpers
Returns: string - italic output

serverHelpers.color(str, hexcolor) ⇒ string

Get colored text

Kind: instance method of ServerHelpers
Returns: string - colored output

serverHelpers.imgUrl(url) ⇒ string

Get image URL embedded into text

Kind: instance method of ServerHelpers
Returns: string - URL output

serverHelpers.emoji(name) ⇒ string

Get emoji embedded into text

Kind: instance method of ServerHelpers
Returns: string - emoji output

serverHelpers.line() ⇒ string

Get new line

Kind: instance method of ServerHelpers
Returns: string - new line

serverHelpers.menion(ext_id) ⇒ string

Get actor mention into text

Kind: instance method of ServerHelpers
Returns: string - mention output

ServerHelpers.setDriver(flavour, impl)

Add native helper driver

Kind: static method of ServerHelpers

ServerHelpers.getDriver(flavour) ⇒ ServerHelpers

Get native helper driver

Kind: static method of ServerHelpers
Returns: ServerHelpers - driver implementation

ServerService

Server Service

Kind: global class

ServiceApp

Basic bot service app.

Actual bot implementation is expected to inherit this class and override registration functions.

Kind: global class

• ServiceApp
  • new ServiceApp(asi, options)
  • .ccm() ⇒ AdvancedCCM
  • .executor() ⇒ Executor
  • .close([done])
  • .newExecutor() ⇒ Executor
  • ._register_logsvc(asi, options)
  • ._register_handlers(asi, options)
  • ._register_servers(asi, options)

new ServiceApp(asi, options)

C-tor

serviceApp.ccm() ⇒ AdvancedCCM

CCM instance accessor

Kind: instance method of ServiceApp
Returns: AdvancedCCM - instance

serviceApp.executor() ⇒ Executor

Executor instance accessor

Kind: instance method of ServiceApp
Returns: Executor - instance

serviceApp.close(done)

Shutdown of app and related instances

Kind: instance method of ServiceApp

serviceApp.newExecutor() ⇒ Executor

Create an instance of executor which is useful to register services.

Kind: instance method of ServiceApp
Returns: Executor - instance

serviceApp._register_logsvc(asi, options)

Override to register custom log service

Kind: instance abstract method of ServiceApp

serviceApp._register_handlers(asi, options)

Override to register custom business logic.

Kind: instance abstract method of ServiceApp

serviceApp._register_servers(asi, options)

Override to register servers.

Kind: instance abstract method of ServiceApp

BaseFace

Base Face with neutral common registration functionality

Kind: global class
Note: Not official API

• BaseFace
  • .LATEST_VERSION
  • .PING_VERSION
  • .register(as, ccm, name, endpoint, [credentials], [options])

BaseFace.LATEST_VERSION

Latest supported FTN13 version

Kind: static property of BaseFace

BaseFace.PING_VERSION

Latest supported FTN4 version

Kind: static property of BaseFace

BaseFace.register(as, ccm, name, endpoint, credentials, options)

CCM registration helper

Kind: static method of BaseFace

BaseService

Base Service with common registration logic

Kind: global class

• BaseService
  • new BaseService(options)
  • .register(as, executor, options) ⇒ BaseService

new BaseService(options)

C-tor

BaseService.register(as, executor, options) ⇒ BaseService

Register Service with Executor

Kind: static method of BaseService
Returns: BaseService - instance

documented by jsdoc-to-markdown.