futoin-invoker
Advanced tools
Transparently, efficiently and securely invoke remote or local service methods with strict API definition for Node and Browser
FutoIn Invoker is a peer which initiates a request - invokes a FutoIn interface method as described in FTN3: FutoIn Interface Definition. It is not necessary a client - e.g. server may initiate request for event delivery to client.
The method can be implemented locally or remotely - it is transparent to invoking code. A similar concept can be found in CORBA and other more heavy request brokers.
Strict FutoIn interface (iface) definition and transport protocol is defined in FTN3 spec mentioned above. As it is based on JSON, both client and server can be implemented in a few minutes almost in any technology. However, Invoker and Executor concept provide significant benefits for efficiency, reliability and error control.
The core of invoker is CCM - Connection and Credentials Manager. It has the following advantages:
The primary communication channel is WebSockets. Large raw data upload and download is also supported through automatic fallback to HTTP(S).
SimpleCCM - a light version without heavy processing of iface definition (ideal for browser) AdvancedCCM - full featured CCM (extends SimpleCCM)
Communication methods:
Message coding formats:
BinaryData constraintNote: Invoker and Executor are platform/technology-neutral concepts. The implementation is already available in JS and PHP.
Documentation --> FutoIn Guide
Reference implementation of:
FTN7: FutoIn Invoker Concept
Version: 1.7
FTN3: FutoIn Interface Definition
Version: 1.9
FTN3.1: FutoIn Interface - Common Types
Version: 1.0
FTN5: FutoIn HTTP integration
Version: 1.3
FTN9: FutoIn Interface - AuditLog
Version: 1.0 (client)
FTN14: FutoIn Cache
Version: 1.0 (client)
FTN4: FutoIn Interface - Ping-Pong
Version: 1.0 (client)
Author: Andrey Galkin
Documentation --> FutoIn Guide
Command line:
$ npm install futoin-invoker --save
or
$ yarn add futoin-invoker
Hint: checkout FutoIn CID for all tools setup.
All public classes can be accessed through module:
const AdvancedCCM = require('futoin-invoker').AdvancedCCM;
or included modular way, e.g.:
const AdvancedCCM = require('futoin-invoker/AdvancedCCM');
Pre-built ES5 CJS modules are available under es5/. These modules
can be used with webpack without transpiler - default "browser" entry point
points to ES5 version.
Webpack dists are also available under dist/ folder, but their usage should be limited
to sites without build process.
Warning: check AsyncSteps and AsyncEvent polyfill for older browsers.
The following globals are available:
To prevent attacks similar to CVE-2018-3721, Object.prototype can be frozen via SpecTools.secureObjectPrototype().
More info: https://hackerone.com/reports/310443
Some libraries which override toString and valueOf in own prototypes require minor
modifications to define a property on derived prototype.
It's possible to load all deps and then call SpecTools.secureObjectPrototype().
NOTE: more complex examples should be found in futoin-executor
var async_steps = require( 'futoin-asyncsteps' );
var SimpleCCM = require( 'futoin-invoker/SimpleCCM' );
// Initalize CCM, no configuration is required
var ccm = new SimpleCCM();
async_steps()
.add(
function( as ){
// Register interfaces without loading their specs
ccm.register( as, 'localone', 'some.iface:1.0',
'https://localhost/some/path' );
ccm.register( as, 'localtwo', 'other.iface:1.0',
'https://localhost/some/path',
'user:pass' ); // optional credentials
as.add( function( as ){
// Get NativeIface representation of remote interface
// after registration is complete
var localone = ccm.iface( 'localone' );
var localtwo = ccm.iface( 'localtwo' );
// SimpleCCM is not aware of available functions.
// It is the only way to perform a call.
localone.call( as, 'somefunc', {
arg1 : 1,
arg2 : 'abc',
arg3 : true,
} );
as.add( function( as, res ){
// As function prototype is not know
// all invalid HTTP 200 responses may
// get returned as "raw data" in res
// parameter.
console.log( res.result1, res.result2 );
} );
} );
},
function( as, err )
{
console.log( err + ': ' + as.state.error_info );
console.log( as.state.last_exception.stack );
}
)
.execute();
var async_steps = require( 'futoin-asyncsteps' );
var invoker = require( 'futoin-invoker' );
// Define interface, which should normally be put into
// file named "some.iface-1.0-iface.json" and put into
// a folder added to the "specDirs" option.
var some_iface_v1_0 = {
"iface" : "some.iface",
"version" : "1.0",
"ftn3rev" : "1.1",
"funcs" : {
"somefunc" : {
"params" : {
"arg1" : {
"type" : "integer"
},
"arg2" : {
"type" : "string"
},
"arg3" : {
"type" : "boolean"
}
},
"result" : {
"result1" : {
"type" : "number"
},
"result2" : {
"type" : "any"
}
},
"throws" : [
"MyError"
]
}
},
"requires" : [
"SecureChannel",
"AllowAnonymous"
]
};
var other_iface_v1_0 = {
"iface" : "other.iface",
"version" : "1.0",
"ftn3rev" : "1.1"
}
// Initialize CCM. We provide interface definitions directly
var ccm = new invoker.AdvancedCCM({
specDirs : [ __dirname + '/specs', some_iface_v1_0, other_iface_v1_0 ]
});
// AsyncSteps processing is required
async_steps()
.add(
function( as ){
// Register interfaces - it is done only once
ccm.register( as, 'localone',
'some.iface:1.0', 'https://localhost/some/path' );
ccm.register( as, 'localtwo',
'other.iface:1.0', 'https://localhost/some/path',
'user:pass' ); // optional credentials
as.add( function( as ){
// Get NativeIface representation of remote interface
// after registration is complete
var localone = ccm.iface( 'localone' );
var localtwo = ccm.iface( 'localtwo' );
localone.somefunc( as, 1, 'abc', true );
as.add( function( as, res ){
console.log( res.result1, res.result2 );
} );
} );
},
function( as, err )
{
console.log( err + ': ' + as.state.error_info );
console.log( as.state.last_exception.stack );
}
)
.execute();
The concept is described in FutoIn specification: FTN7: Interface Invoker Concept v1.x
SimpleCCMAdvanced CCM - Reference Implementation
NativeIfaceCache Native interface
Register with CacheFace.register()
NOTE: it is not directly available in Invoker module interface, include separately
FutoIn interface info
NativeIfaceAuditLog Native interface
Register with LogFace.register().
NOTE: it is not directly available Invoker module interface, include separately
Native Interface for FutoIn ifaces
Base for FTN4 ping-based interfaces
Simple CCM - Reference Implementation
Base Connection and Credentials Manager with limited error control
SimpleCCMOptionswindow.SimpleCCM - Browser-only reference to futoin-asyncsteps.SimpleCCM
window.SimpleCCM - Browser-only reference to futoin-asyncsteps.SimpleCCM
futoin.SimpleCCM - Browser-only reference to futoin-asyncsteps.SimpleCCM
window.AdvancedCCM - Browser-only reference to futoin-asyncsteps.AdvancedCCM
futoin.AdvancedCCM - Browser-only reference to futoin-asyncsteps.AdvancedCCM
futoin.Invoker - Browser-only reference to futoin-invoker module
window.FutoInInvoker - Browser-only reference to futoin-invoker module
SimpleCCMAdvanced CCM - Reference Implementation
Kind: global class
Extends: SimpleCCM
See
SimpleCCM
NativeInterfaceobjectobjectobject| Param | Type | Description |
|---|---|---|
| options | object | see AdvancedCCMOptions |
Register standard MasterService end-point (adds steps to as)
Kind: instance method of AdvancedCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | AsyncSteps instance as registration may be waiting for external resources |
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
| endpoint | string | URI OR any other resource identifier of function( ccmimpl, info ) returning iface implementing peer, accepted by CCM implementation OR instance of Executor |
| [credentials] | string | optional, authentication credentials: 'master' - enable MasterService authentication logic (Advanced CCM only) '{user}:{clear-text-password}' - send as is in the 'sec' section NOTE: some more reserved words and/or patterns can appear in the future |
| [options] | object | fine tune global CCM options per endpoint |
NativeInterfaceGet native interface wrapper for invocation of iface methods
Kind: instance method of AdvancedCCM
Returns: NativeInterface - - native interface
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
Unregister previously registered interface (should not be used, unless really needed)
Kind: instance method of AdvancedCCM
Emits: unregister
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
objectShortcut to iface( "#defense" )
Kind: instance method of AdvancedCCM
Returns: object - native defense interface
objectReturns extended API interface as defined in FTN9 IF AuditLogService
Kind: instance method of AdvancedCCM
Returns: object - FTN9 native face
objectReturns extended API interface as defined in [FTN14 Cache][]
Kind: instance method of AdvancedCCM
Returns: object - FTN14 native face
| Param | Type | Default | Description |
|---|---|---|---|
| [bucket] | string | "default" | cache bucket name |
Assert that interface registered by name matches major version and minor is not less than required. This function must generate fatal error and forbid any further execution
Kind: instance method of AdvancedCCM
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
Alias interface name with another name
Kind: instance method of AdvancedCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| alias | string | alternative name for registered interface |
Shutdown CCM (close all active comms)
Kind: instance method of AdvancedCCM
Emits: close
Configure named AsyncSteps Limiter instance
Kind: instance method of AdvancedCCM
| Param | Type | Description |
|---|---|---|
| name | string | zone name |
| options | object | options to pass to Limiter c-tor |
CCM regiser event. Fired on new interface registration. ( name, ifacever, info )
Kind: event emitted by AdvancedCCM
CCM regiser event. Fired on interface unregistration. ( name, info )
Kind: event emitted by AdvancedCCM
CCM close event. Fired on CCM shutdown.
Kind: event emitted by AdvancedCCM
NativeIfaceCache Native interface
Register with CacheFace.register()
NOTE: it is not directly available in Invoker module interface, include separately
Kind: global class
Extends: NativeIface
NativeIface
| Param | Type | Description |
|---|---|---|
| _ccm | SimpleCCM | CCM instance |
| info | object | internal info |
Get or Set cached value
NOTE: the actual cache key is formed with concatenation of key_prefix and join of params values
Kind: instance method of CacheFace
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | step interface |
| key_prefix | string | unique key prefix |
| callable | function | func( as, params.. ) - a callable which is called to generated value on cache miss |
| params | Array | parameters to be passed to callable |
| ttl_ms | integer | time to live in ms to use, if value is set on cache miss |
Generic FutoIn function call interface Result is passed through AsyncSteps.success() as a map.
Kind: instance method of CacheFace
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | AsyncSteps object |
| name | string | FutoIn iface function name |
| params | object | map of func parameters |
| upload_data | string | stream.Readable | raw upload data or input stram |
| [download_stream] | stream.Writable | output stream for raw download data |
| [timeout] | int | if provided, overrides the default. <=0 - disables timeout |
InterfaceInfoGet interface info
Kind: instance method of CacheFace
Returns: InterfaceInfo - - interface info
Results with DerivedKeyAccessor through as.success()
Kind: instance method of CacheFace
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | step interface |
Fired when interface establishes connection.
Kind: event emitted by CacheFace
Fired when interface connection is closed.
Kind: event emitted by CacheFace
Interface close event. Fired on interface unregistration.
Kind: event emitted by CacheFace
Interface communication error. Fired during call processing. ( error_info, rawreq )
Kind: event emitted by CacheFace
Cache Native interface registration helper
Kind: static method of CacheFace
| Param | Type | Default | Description |
|---|---|---|---|
| as | AsyncSteps | step interface | |
| ccm | AdvancedCCM | CCM instance | |
| name | string | registration name for CCM | |
| endpoint | string | endpoint URL | |
| [credentials] | * | | see CCM register() |
| [options] | object | {} | registration options |
| [options.version] | string | "1.0" | iface version |
| [options.ttl_ms] | integer | 1000 | default TTL |
FutoIn interface info
Kind: global class
stringstringstringobjectarray| Param | Type | Description |
|---|---|---|
| raw_info | object | futoin spec as is |
stringGet FutoIn interface name
Kind: instance method of InterfaceInfo
Returns: string - name
stringGet FutoIn interface version
Kind: instance method of InterfaceInfo
Returns: string - version
stringGet list of inherited interfaces starting from the most derived, may be null
Kind: instance method of InterfaceInfo
Returns: string - inherited interface name-ver
objectGet list of available functions, may be null
Kind: instance method of InterfaceInfo
Returns: object - list of functions
arrayGet list of interface constraints, may be null
Kind: instance method of InterfaceInfo
Returns: array - list of constraints
NativeIfaceAuditLog Native interface
Register with LogFace.register().
NOTE: it is not directly available Invoker module interface, include separately
Kind: global class
Extends: NativeIface
NativeIface
Log message
Kind: instance method of LogFace
| Param | Type | Description |
|---|---|---|
| lvl | string | debug |
| txt | string | message to log |
Log message
Kind: instance method of LogFace
| Param | Type | Description |
|---|---|---|
| lvl | string | debug |
| txt | string | message to log |
| data | string | raw data |
Log message in debug level
Kind: instance method of LogFace
| Param | Type | Description |
|---|---|---|
| txt | string | message to log |
Log message in info level
Kind: instance method of LogFace
| Param | Type | Description |
|---|---|---|
| txt | string | message to log |
Log message in warn level
Kind: instance method of LogFace
| Param | Type | Description |
|---|---|---|
| txt | string | message to log |
Log message in error level
Kind: instance method of LogFace
| Param | Type | Description |
|---|---|---|
| txt | string | message to log |
Log message in security level
Kind: instance method of LogFace
| Param | Type | Description |
|---|---|---|
| txt | string | message to log |
Generic FutoIn function call interface Result is passed through AsyncSteps.success() as a map.
Kind: instance method of LogFace
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | AsyncSteps object |
| name | string | FutoIn iface function name |
| params | object | map of func parameters |
| upload_data | string | stream.Readable | raw upload data or input stram |
| [download_stream] | stream.Writable | output stream for raw download data |
| [timeout] | int | if provided, overrides the default. <=0 - disables timeout |
InterfaceInfoGet interface info
Kind: instance method of LogFace
Returns: InterfaceInfo - - interface info
Results with DerivedKeyAccessor through as.success()
Kind: instance method of LogFace
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | step interface |
Fired when interface establishes connection.
Kind: event emitted by LogFace
Fired when interface connection is closed.
Kind: event emitted by LogFace
Interface close event. Fired on interface unregistration.
Kind: event emitted by LogFace
Interface communication error. Fired during call processing. ( error_info, rawreq )
Kind: event emitted by LogFace
Debug log level
Kind: static constant of LogFace
Info log level
Kind: static constant of LogFace
Warn log level
Kind: static constant of LogFace
Error log level
Kind: static constant of LogFace
Security log level
Kind: static constant of LogFace
AuditLog Native interface registration helper
Kind: static method of LogFace
| Param | Type | Default | Description |
|---|---|---|---|
| as | AsyncSteps | step interface | |
| ccm | AdvancedCCM | CCM instance | |
| endpoint | string | endpoint URL | |
| [credentials] | * | | see CCM register() |
| [options] | object | {} | registration options |
| [options.version] | string | "1.0" | iface version |
Native Interface for FutoIn ifaces
Kind: global class
| Param | Type | Description |
|---|---|---|
| ccmimpl | AdvancedCCMImpl | CCM instance |
| info | InterfaceInfo | interface info |
Generic FutoIn function call interface Result is passed through AsyncSteps.success() as a map.
Kind: instance method of NativeIface
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | AsyncSteps object |
| name | string | FutoIn iface function name |
| params | object | map of func parameters |
| upload_data | string | stream.Readable | raw upload data or input stram |
| [download_stream] | stream.Writable | output stream for raw download data |
| [timeout] | int | if provided, overrides the default. <=0 - disables timeout |
InterfaceInfoGet interface info
Kind: instance method of NativeIface
Returns: InterfaceInfo - - interface info
Results with DerivedKeyAccessor through as.success()
Kind: instance method of NativeIface
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | step interface |
Fired when interface establishes connection.
Kind: event emitted by NativeIface
Fired when interface connection is closed.
Kind: event emitted by NativeIface
Interface close event. Fired on interface unregistration.
Kind: event emitted by NativeIface
Interface communication error. Fired during call processing. ( error_info, rawreq )
Kind: event emitted by NativeIface
Must be object with version => spec pairs in child class, if set.
Kind: static property of NativeIface
Must be module name prefix, example: 'MyModule/specs/name_'.
If version 1.0 is requested then spec is loaded from 'MyModule/specs/name_1_0'
Kind: static property of NativeIface
objectGet hardcoded iface definition, if available.
Kind: static method of NativeIface
Returns: object - interface spec of required version
Note: this helper is designed for derived native interfaces
which define _specs or _specs_module_prefix static members.
| Param | Type | Description |
|---|---|---|
| version | string | iface version |
Base for FTN4 ping-based interfaces
Register ping interface
Kind: static method of PingFace
Note: Iface spec is embedded
| Param | Type | Default | Description |
|---|---|---|---|
| as | AsyncSteps | step interface | |
| ccm | AdvancedCCM | CCM instance | |
| name | string | registration name for CCM | |
| endpoint | string | endpoint URL | |
| [credentials] | * | | see CCM register() |
| [options] | object | {} | registration options |
| [options.version] | string | "1.0" | iface version |
Simple CCM - Reference Implementation
Base Connection and Credentials Manager with limited error control
Kind: global class
See
| Param | Type | Description |
|---|---|---|
| [options] | object | map of options |
Register standard MasterService end-point (adds steps to as)
Kind: instance method of SimpleCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | AsyncSteps instance as registration may be waiting for external resources |
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
| endpoint | string | URI OR any other resource identifier of function( ccmimpl, info ) returning iface implementing peer, accepted by CCM implementation OR instance of Executor |
| [credentials] | string | optional, authentication credentials: 'master' - enable MasterService authentication logic (Advanced CCM only) '{user}:{clear-text-password}' - send as is in the 'sec' section NOTE: some more reserved words and/or patterns can appear in the future |
| [options] | object | fine tune global CCM options per endpoint |
NativeInterfaceGet native interface wrapper for invocation of iface methods
Kind: instance method of SimpleCCM
Returns: NativeInterface - - native interface
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
Unregister previously registered interface (should not be used, unless really needed)
Kind: instance method of SimpleCCM
Emits: unregister
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
objectShortcut to iface( "#defense" )
Kind: instance method of SimpleCCM
Returns: object - native defense interface
objectReturns extended API interface as defined in FTN9 IF AuditLogService
Kind: instance method of SimpleCCM
Returns: object - FTN9 native face
objectReturns extended API interface as defined in [FTN14 Cache][]
Kind: instance method of SimpleCCM
Returns: object - FTN14 native face
| Param | Type | Default | Description |
|---|---|---|---|
| [bucket] | string | "default" | cache bucket name |
Assert that interface registered by name matches major version and minor is not less than required. This function must generate fatal error and forbid any further execution
Kind: instance method of SimpleCCM
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
Alias interface name with another name
Kind: instance method of SimpleCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| alias | string | alternative name for registered interface |
Shutdown CCM (close all active comms)
Kind: instance method of SimpleCCM
Emits: close
Configure named AsyncSteps Limiter instance
Kind: instance method of SimpleCCM
| Param | Type | Description |
|---|---|---|
| name | string | zone name |
| options | object | options to pass to Limiter c-tor |
CCM regiser event. Fired on new interface registration. ( name, ifacever, info )
Kind: event emitted by SimpleCCM
CCM regiser event. Fired on interface unregistration. ( name, info )
Kind: event emitted by SimpleCCM
CCM close event. Fired on CCM shutdown.
Kind: event emitted by SimpleCCM
Maximum FutoIn message payload size (not related to raw data)
Kind: static constant of SimpleCCM
Default: 65536
Runtime iface resolution v1.x
Kind: static constant of SimpleCCM
AuthService v1.x
Kind: static constant of SimpleCCM
Defense system v1.x
Kind: static constant of SimpleCCM
Access Control system v1.x
Kind: static constant of SimpleCCM
Audit Logging v1.x
Kind: static constant of SimpleCCM
cache v1.x iface name prefix
Kind: static constant of SimpleCCM
Kind: global class
BooleanbooleanBufferbooleanbooleanSpecTools
Enumeration of standard errors
Kind: static constant of SpecTools
Load FutoIn iface definition.
NOTE: Browser uses XHR to load specs, Node.js searches in local fs.
Kind: static method of SpecTools
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | step interface |
| info | Object | destination object with "iface" and "version" fields already set |
| specdirs | Array | each element - search path/url (string) or raw iface (object) |
| [load_cache] | Object | arbitrary object to use for caching |
Parse raw futoin spec (preloaded)
Kind: static method of SpecTools
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | step interface |
| info | Object | destination object with "iface" and "version" fields already set |
| specdirs | Array | each element - search path/url (string) or raw iface (object) |
| raw_spec | Object | iface definition object |
| [load_cache] | Object | cache of already loaded interfaces |
Deeply check consistency of loaded interface.
NOTE: not yet implemented
Kind: static method of SpecTools
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | step interface |
| info | Object | previously loaded iface |
BooleanCheck if value matches required type
Kind: static method of SpecTools
Returns: Boolean - true on success
| Param | Type | Description |
|---|---|---|
| info | Object | previously loaded iface |
| type | string | standard or custom iface type |
| val | * | value to check |
booleanCheck if parameter value matches required type
Kind: static method of SpecTools
Returns: boolean - true on success
| Param | Type | Description |
|---|---|---|
| info | Object | previously loaded iface |
| funcname | string | function name |
| varname | string | parameter name |
| value | * | value to check |
Check if result value matches required type
Kind: static method of SpecTools
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | step interface |
| info | Object | previously loaded iface |
| funcname | string | function name |
| varname | string | result variable name |
| value | * | value to check |
BufferGenerate HMAC
NOTE: for simplicity, 'sec' field must not be present
Kind: static method of SpecTools
Returns: Buffer - Binary HMAC signature
Throws:
FutoInError| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | step interface |
| info | object | Interface raw info object |
| ftnreq | object | Request Object |
booleanSecure compare to cover time-based side-channels for attacks
Kind: static method of SpecTools
Returns: boolean - true, if match
Note: Pure JS is used in browser and crypto-based in Node.js
| Param | Type | Description |
|---|---|---|
| a | string | first string |
| b | string | second String |
Call after loading all depedency modules.
Mitigates CVE-2018-3721 and similar.
Kind: static method of SpecTools
booleanSecure compare to cover time-based side-channels for attacks
Kind: static method of SpecTools
Returns: boolean - true, if match
| Param | Type | Description |
|---|---|---|
| a | Buffer | first buffer |
| b | Buffer | second buffer |
On error message for details in debugging.
Kind: event emitted by SpecTools
SimpleCCMOptionsKind: global class
Extends: SimpleCCMOptions
This is a pseudo-class for documentation purposes
NOTE: Each option can be set on global level and overriden per interface.
Search dirs for spec definition or spec instance directly. It can be single value or array of values. Each value is either path/URL (string) or iface spec instance (object).
Kind: static property of AdvancedCCMOptions
Default: []
Base64 encoded key for MAC generation. See FTN8
Kind: static property of AdvancedCCMOptions
Hash algorithm for HMAC generation: HMD5, HS256 (default), HS384, HS512
Kind: static property of AdvancedCCMOptions
Deprecated
Base64 encoded key for legacy HMAC generation. See FTN6/FTN7
Kind: static property of AdvancedCCMOptions
Deprecated
Hash algorithm for legacy HMAC generation: MD5(default), SHA224, SHA256, SHA384, SHA512
Kind: static property of AdvancedCCMOptions
Send "obf" (On Behalf Of) user information as defined in FTN3 v1.3 when invoked from Executor's request processing task
Kind: static property of AdvancedCCMOptions
Default: true
Instance implementing MasterAuth interface
Kind: static property of AdvancedCCMOptions
Kind: global class
This is a pseudo-class for documentation purposes.
NOTE: Each option can be set on global level and overriden per interface.
Overall call timeout (int)
Kind: static property of SimpleCCMOptions
Default: 3000
Production mode - disables some checks without compomising security
Kind: static property of SimpleCCMOptions
Default: NODE_ENV === 'production'
Communication configuration callback( type, specific-args )
Kind: static property of SimpleCCMOptions
Default:
Client-side executor for bi-directional communication channels
Kind: static property of SimpleCCMOptions
browser-only. Origin of target for window.postMessage()
Kind: static property of SimpleCCMOptions
How many times to retry the call on CommError. NOTE: actual attempt count is retryCount + 1
Kind: static property of SimpleCCMOptions
Default: 1
Which message coder to use by default.
Kind: static property of SimpleCCMOptions
Default: JSON
Which message coder to use for BinaryData interfaces.
Kind: static property of SimpleCCMOptions
Default: MPCK
Message sniffer callback( iface_info, msg, is_incomming ). Useful for audit logging.
Kind: static method of SimpleCCMOptions
Default: dummy
Bi-directional channel disconnect sniffer callback( iface_info ). Useful for audit logging.
Kind: static method of SimpleCCMOptions
Default: dummy
window.SimpleCCM - Browser-only reference to futoin-asyncsteps.SimpleCCM
Kind: global variable
| Param | Type | Description |
|---|---|---|
| [options] | object | map of options |
Register standard MasterService end-point (adds steps to as)
Kind: instance method of SimpleCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | AsyncSteps instance as registration may be waiting for external resources |
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
| endpoint | string | URI OR any other resource identifier of function( ccmimpl, info ) returning iface implementing peer, accepted by CCM implementation OR instance of Executor |
| [credentials] | string | optional, authentication credentials: 'master' - enable MasterService authentication logic (Advanced CCM only) '{user}:{clear-text-password}' - send as is in the 'sec' section NOTE: some more reserved words and/or patterns can appear in the future |
| [options] | object | fine tune global CCM options per endpoint |
NativeInterfaceGet native interface wrapper for invocation of iface methods
Kind: instance method of SimpleCCM
Returns: NativeInterface - - native interface
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
Unregister previously registered interface (should not be used, unless really needed)
Kind: instance method of SimpleCCM
Emits: unregister
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
objectShortcut to iface( "#defense" )
Kind: instance method of SimpleCCM
Returns: object - native defense interface
objectReturns extended API interface as defined in FTN9 IF AuditLogService
Kind: instance method of SimpleCCM
Returns: object - FTN9 native face
objectReturns extended API interface as defined in [FTN14 Cache][]
Kind: instance method of SimpleCCM
Returns: object - FTN14 native face
| Param | Type | Default | Description |
|---|---|---|---|
| [bucket] | string | "default" | cache bucket name |
Assert that interface registered by name matches major version and minor is not less than required. This function must generate fatal error and forbid any further execution
Kind: instance method of SimpleCCM
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
Alias interface name with another name
Kind: instance method of SimpleCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| alias | string | alternative name for registered interface |
Shutdown CCM (close all active comms)
Kind: instance method of SimpleCCM
Emits: close
Configure named AsyncSteps Limiter instance
Kind: instance method of SimpleCCM
| Param | Type | Description |
|---|---|---|
| name | string | zone name |
| options | object | options to pass to Limiter c-tor |
CCM regiser event. Fired on new interface registration. ( name, ifacever, info )
Kind: event emitted by SimpleCCM
CCM regiser event. Fired on interface unregistration. ( name, info )
Kind: event emitted by SimpleCCM
CCM close event. Fired on CCM shutdown.
Kind: event emitted by SimpleCCM
Maximum FutoIn message payload size (not related to raw data)
Kind: static constant of SimpleCCM
Default: 65536
Runtime iface resolution v1.x
Kind: static constant of SimpleCCM
AuthService v1.x
Kind: static constant of SimpleCCM
Defense system v1.x
Kind: static constant of SimpleCCM
Access Control system v1.x
Kind: static constant of SimpleCCM
Audit Logging v1.x
Kind: static constant of SimpleCCM
cache v1.x iface name prefix
Kind: static constant of SimpleCCM
window.SimpleCCM - Browser-only reference to futoin-asyncsteps.SimpleCCM
Kind: global variable
| Param | Type | Description |
|---|---|---|
| [options] | object | map of options |
Register standard MasterService end-point (adds steps to as)
Kind: instance method of SimpleCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | AsyncSteps instance as registration may be waiting for external resources |
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
| endpoint | string | URI OR any other resource identifier of function( ccmimpl, info ) returning iface implementing peer, accepted by CCM implementation OR instance of Executor |
| [credentials] | string | optional, authentication credentials: 'master' - enable MasterService authentication logic (Advanced CCM only) '{user}:{clear-text-password}' - send as is in the 'sec' section NOTE: some more reserved words and/or patterns can appear in the future |
| [options] | object | fine tune global CCM options per endpoint |
NativeInterfaceGet native interface wrapper for invocation of iface methods
Kind: instance method of SimpleCCM
Returns: NativeInterface - - native interface
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
Unregister previously registered interface (should not be used, unless really needed)
Kind: instance method of SimpleCCM
Emits: unregister
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
objectShortcut to iface( "#defense" )
Kind: instance method of SimpleCCM
Returns: object - native defense interface
objectReturns extended API interface as defined in FTN9 IF AuditLogService
Kind: instance method of SimpleCCM
Returns: object - FTN9 native face
objectReturns extended API interface as defined in [FTN14 Cache][]
Kind: instance method of SimpleCCM
Returns: object - FTN14 native face
| Param | Type | Default | Description |
|---|---|---|---|
| [bucket] | string | "default" | cache bucket name |
Assert that interface registered by name matches major version and minor is not less than required. This function must generate fatal error and forbid any further execution
Kind: instance method of SimpleCCM
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
Alias interface name with another name
Kind: instance method of SimpleCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| alias | string | alternative name for registered interface |
Shutdown CCM (close all active comms)
Kind: instance method of SimpleCCM
Emits: close
Configure named AsyncSteps Limiter instance
Kind: instance method of SimpleCCM
| Param | Type | Description |
|---|---|---|
| name | string | zone name |
| options | object | options to pass to Limiter c-tor |
CCM regiser event. Fired on new interface registration. ( name, ifacever, info )
Kind: event emitted by SimpleCCM
CCM regiser event. Fired on interface unregistration. ( name, info )
Kind: event emitted by SimpleCCM
CCM close event. Fired on CCM shutdown.
Kind: event emitted by SimpleCCM
Maximum FutoIn message payload size (not related to raw data)
Kind: static constant of SimpleCCM
Default: 65536
Runtime iface resolution v1.x
Kind: static constant of SimpleCCM
AuthService v1.x
Kind: static constant of SimpleCCM
Defense system v1.x
Kind: static constant of SimpleCCM
Access Control system v1.x
Kind: static constant of SimpleCCM
Audit Logging v1.x
Kind: static constant of SimpleCCM
cache v1.x iface name prefix
Kind: static constant of SimpleCCM
futoin.SimpleCCM - Browser-only reference to futoin-asyncsteps.SimpleCCM
Kind: global variable
| Param | Type | Description |
|---|---|---|
| [options] | object | map of options |
Register standard MasterService end-point (adds steps to as)
Kind: instance method of SimpleCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | AsyncSteps instance as registration may be waiting for external resources |
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
| endpoint | string | URI OR any other resource identifier of function( ccmimpl, info ) returning iface implementing peer, accepted by CCM implementation OR instance of Executor |
| [credentials] | string | optional, authentication credentials: 'master' - enable MasterService authentication logic (Advanced CCM only) '{user}:{clear-text-password}' - send as is in the 'sec' section NOTE: some more reserved words and/or patterns can appear in the future |
| [options] | object | fine tune global CCM options per endpoint |
NativeInterfaceGet native interface wrapper for invocation of iface methods
Kind: instance method of SimpleCCM
Returns: NativeInterface - - native interface
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
Unregister previously registered interface (should not be used, unless really needed)
Kind: instance method of SimpleCCM
Emits: unregister
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
objectShortcut to iface( "#defense" )
Kind: instance method of SimpleCCM
Returns: object - native defense interface
objectReturns extended API interface as defined in FTN9 IF AuditLogService
Kind: instance method of SimpleCCM
Returns: object - FTN9 native face
objectReturns extended API interface as defined in [FTN14 Cache][]
Kind: instance method of SimpleCCM
Returns: object - FTN14 native face
| Param | Type | Default | Description |
|---|---|---|---|
| [bucket] | string | "default" | cache bucket name |
Assert that interface registered by name matches major version and minor is not less than required. This function must generate fatal error and forbid any further execution
Kind: instance method of SimpleCCM
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
Alias interface name with another name
Kind: instance method of SimpleCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| alias | string | alternative name for registered interface |
Shutdown CCM (close all active comms)
Kind: instance method of SimpleCCM
Emits: close
Configure named AsyncSteps Limiter instance
Kind: instance method of SimpleCCM
| Param | Type | Description |
|---|---|---|
| name | string | zone name |
| options | object | options to pass to Limiter c-tor |
CCM regiser event. Fired on new interface registration. ( name, ifacever, info )
Kind: event emitted by SimpleCCM
CCM regiser event. Fired on interface unregistration. ( name, info )
Kind: event emitted by SimpleCCM
CCM close event. Fired on CCM shutdown.
Kind: event emitted by SimpleCCM
Maximum FutoIn message payload size (not related to raw data)
Kind: static constant of SimpleCCM
Default: 65536
Runtime iface resolution v1.x
Kind: static constant of SimpleCCM
AuthService v1.x
Kind: static constant of SimpleCCM
Defense system v1.x
Kind: static constant of SimpleCCM
Access Control system v1.x
Kind: static constant of SimpleCCM
Audit Logging v1.x
Kind: static constant of SimpleCCM
cache v1.x iface name prefix
Kind: static constant of SimpleCCM
window.AdvancedCCM - Browser-only reference to futoin-asyncsteps.AdvancedCCM
Kind: global variable
NativeInterfaceobjectobjectobject| Param | Type | Description |
|---|---|---|
| options | object | see AdvancedCCMOptions |
Register standard MasterService end-point (adds steps to as)
Kind: instance method of AdvancedCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | AsyncSteps instance as registration may be waiting for external resources |
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
| endpoint | string | URI OR any other resource identifier of function( ccmimpl, info ) returning iface implementing peer, accepted by CCM implementation OR instance of Executor |
| [credentials] | string | optional, authentication credentials: 'master' - enable MasterService authentication logic (Advanced CCM only) '{user}:{clear-text-password}' - send as is in the 'sec' section NOTE: some more reserved words and/or patterns can appear in the future |
| [options] | object | fine tune global CCM options per endpoint |
NativeInterfaceGet native interface wrapper for invocation of iface methods
Kind: instance method of AdvancedCCM
Returns: NativeInterface - - native interface
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
Unregister previously registered interface (should not be used, unless really needed)
Kind: instance method of AdvancedCCM
Emits: unregister
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
objectShortcut to iface( "#defense" )
Kind: instance method of AdvancedCCM
Returns: object - native defense interface
objectReturns extended API interface as defined in FTN9 IF AuditLogService
Kind: instance method of AdvancedCCM
Returns: object - FTN9 native face
objectReturns extended API interface as defined in [FTN14 Cache][]
Kind: instance method of AdvancedCCM
Returns: object - FTN14 native face
| Param | Type | Default | Description |
|---|---|---|---|
| [bucket] | string | "default" | cache bucket name |
Assert that interface registered by name matches major version and minor is not less than required. This function must generate fatal error and forbid any further execution
Kind: instance method of AdvancedCCM
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
Alias interface name with another name
Kind: instance method of AdvancedCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| alias | string | alternative name for registered interface |
Shutdown CCM (close all active comms)
Kind: instance method of AdvancedCCM
Emits: close
Configure named AsyncSteps Limiter instance
Kind: instance method of AdvancedCCM
| Param | Type | Description |
|---|---|---|
| name | string | zone name |
| options | object | options to pass to Limiter c-tor |
CCM regiser event. Fired on new interface registration. ( name, ifacever, info )
Kind: event emitted by AdvancedCCM
CCM regiser event. Fired on interface unregistration. ( name, info )
Kind: event emitted by AdvancedCCM
CCM close event. Fired on CCM shutdown.
Kind: event emitted by AdvancedCCM
futoin.AdvancedCCM - Browser-only reference to futoin-asyncsteps.AdvancedCCM
Kind: global variable
NativeInterfaceobjectobjectobject| Param | Type | Description |
|---|---|---|
| options | object | see AdvancedCCMOptions |
Register standard MasterService end-point (adds steps to as)
Kind: instance method of AdvancedCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| as | AsyncSteps | AsyncSteps instance as registration may be waiting for external resources |
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
| endpoint | string | URI OR any other resource identifier of function( ccmimpl, info ) returning iface implementing peer, accepted by CCM implementation OR instance of Executor |
| [credentials] | string | optional, authentication credentials: 'master' - enable MasterService authentication logic (Advanced CCM only) '{user}:{clear-text-password}' - send as is in the 'sec' section NOTE: some more reserved words and/or patterns can appear in the future |
| [options] | object | fine tune global CCM options per endpoint |
NativeInterfaceGet native interface wrapper for invocation of iface methods
Kind: instance method of AdvancedCCM
Returns: NativeInterface - - native interface
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
Unregister previously registered interface (should not be used, unless really needed)
Kind: instance method of AdvancedCCM
Emits: unregister
| Param | Type | Description |
|---|---|---|
| name | string | see register() |
objectShortcut to iface( "#defense" )
Kind: instance method of AdvancedCCM
Returns: object - native defense interface
objectReturns extended API interface as defined in FTN9 IF AuditLogService
Kind: instance method of AdvancedCCM
Returns: object - FTN9 native face
objectReturns extended API interface as defined in [FTN14 Cache][]
Kind: instance method of AdvancedCCM
Returns: object - FTN14 native face
| Param | Type | Default | Description |
|---|---|---|---|
| [bucket] | string | "default" | cache bucket name |
Assert that interface registered by name matches major version and minor is not less than required. This function must generate fatal error and forbid any further execution
Kind: instance method of AdvancedCCM
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| ifacever | string | interface identifier and its version separated by colon |
Alias interface name with another name
Kind: instance method of AdvancedCCM
Emits: register
| Param | Type | Description |
|---|---|---|
| name | string | unique identifier in scope of CCM instance |
| alias | string | alternative name for registered interface |
Shutdown CCM (close all active comms)
Kind: instance method of AdvancedCCM
Emits: close
Configure named AsyncSteps Limiter instance
Kind: instance method of AdvancedCCM
| Param | Type | Description |
|---|---|---|
| name | string | zone name |
| options | object | options to pass to Limiter c-tor |
CCM regiser event. Fired on new interface registration. ( name, ifacever, info )
Kind: event emitted by AdvancedCCM
CCM regiser event. Fired on interface unregistration. ( name, info )
Kind: event emitted by AdvancedCCM
CCM close event. Fired on CCM shutdown.
Kind: event emitted by AdvancedCCM
futoin.Invoker - Browser-only reference to futoin-invoker module
window.FutoInInvoker - Browser-only reference to futoin-invoker module
Kind: global variable
documented by jsdoc-to-markdown.
FAQs
Transparently, efficiently and securely invoke remote or local service methods with strict API definition for Node and Browser
The npm package futoin-invoker receives a total of 7 weekly downloads. As such, futoin-invoker popularity was classified as not popular.
We found that futoin-invoker demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
Socket researchers have discovered malicious npm packages targeting crypto developers, stealing credentials and wallet data using spyware delivered through typosquats of popular cryptographic libraries.
Security News
Socket's package search now displays weekly downloads for npm packages, helping developers quickly assess popularity and make more informed decisions.
Security News
A Stanford study reveals 9.5% of engineers contribute almost nothing, costing tech $90B annually, with remote work fueling the rise of "ghost engineers."