Library to interact with residue server seamlessly. 

amrayn

residue

muflihun

 - `loadConfiguration` now accepts object

- Do not send multiple touch requests when one is pending

- Changed verbose signature from `msg, level` to `level, msg`

- Use of `CHECK_TOKENS` server flag to reduce overhead of pulling token when not needed

- Re-estabilish connection if remote disconnected and dispatch all the logs

- Fixed issue with token retrieving when client is dead

- Fixed issue with pinging client when `client_age` < 60

- Fixed issue with key when client created using different key size

- Fixed issue with token retrieving using default access code

- Use `path` module to resolve relative file paths

- Ability to specify public key for encrypted private keys

- Fixed issues with getting correct filename, line number and function name

- Added `loadConfiguration` to load configurations from json file

- Obtaining token race-condition issue #26

- Fixed issue with verifying token with `0` life

- Updated API to use configurations as C++ API

- Send server flags with final connection #14

- Support sending plain log requests in lib #13

  "description": "Library to interact with residue server seamlessly.",

    "test": "echo \"No tests available\" && exit 1"

    "url": "git+https://github.com/muflihun/residue-node.git"

  "author": "Muflihun Labs <info@muflihun.com> (https://muflihun.com/)",

  "author": "Muflihun Labs <info@muflihun.com>",

    "url": "https://github.com/muflihun/residue-node/issues"

  "homepage": "https://github.com/muflihun/residue-node#readme",

A very simple, secure Node.js library to interact with residue seamlessly.

This module provides interface for connecting and interacting with residue server seamlessly, means, once you are connected this module takes care of expired tokens and clients and keep itself updated with latest tokens and ping server when needed to stay alive.

[![Version](https://img.shields.io/npm/v/residue.svg)](https://www.npmjs.com/package/residue)

[![GitHub license](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/muflihun/residue-node/blob/master/LICENSE)

[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.me/MuflihunDotCom/25)

This library depends on following native modules, without them library will not work:

 * [Path Module](https://nodejs.org/api/path.html)

 * [File System Module](https://nodejs.org/api/fs.html)

 * [Crypto Module](https://nodejs.org/api/crypto.html)

 * [ZLib Module](https://nodejs.org/api/zlib.html)

 * [Net Module](https://nodejs.org/api/net.html)

 * [Util Module](https://nodejs.org/api/util.html)

Connects application to residue using params. If options is not specified, you should use `loadConfiguration` to load the options

    url: "<host_where_residue_server_is_listening>:<residue_connection_port>",

    application_id: <app_name [optional]>,

    rsa_key_size: <key_size_for_initial_final_key_transmission [optional]>,

    utc_time: <whether_to_use_UTC_time [optional]>,

    time_offset: <time_offset_in_seconds [optional]>,

    client_id: <client_id_that_server_knows_you_as [optional]>,

    client_private_key: <full_path_of_private_key> [must be provided with client_id],

    client_public_key: <full_path_of_public_key> [must be provided with client_id],

    client_key_secret: <secret (passphrase) for encrypted private key if any>,

    server_public_key: <full_path_of_server_public_key>

Please refer to [`loadConfiguration`](https://muflihun.github.io/residue/docs/class_residue.html#a8292657c93a775b6cbf22c6d4f1166f4) in our C++ library's documentation for more details.

Loads configurations / options via json file. Returns true if successfully loaded, otherwise false.

This does not verify the options. Options are validated in `connect()` function

Returns logger class for logging interface

var logger = residue.getLogger('sample-app');

if (residue.loadConfiguration(confFile)) {

var person = { 'name': 'Adam', 'age': 960, }

You can check out [sample client apps](https://github.com/muflihun/residue-node/blob/master/samples) for practical use of this package.

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

		# Change Log

		## [1.2.3]
		## [1.2.4]
		- `loadConfiguration` now accepts object
		@@ -5,0 +5,0 @@

		{
		"name": "residue",
		"version": "1.2.3",
		"version": "1.2.4",
		"description": "Library to interact with residue server seamlessly.",
		@@ -26,3 +26,3 @@ "main": "src/residue.js",
		],
		"author": "Muflihun Labs <info@muflihun.com> (https://muflihun.com/)",
		"author": "Muflihun Labs <info@muflihun.com>",
		"license": "Apache-2.0",
		@@ -29,0 +29,0 @@ "bugs": {

		@@ -79,2 +79,9 @@ ﷽

		// other levels
		logger.warn(...);
		logger.error(...);
		logger.debug(...);
		logger.trace(...);
		logger.fatal(...);
		logger.verbose(verbose-level, ...);
		```
		@@ -84,1 +91,23 @@
		You can check out [sample client apps](https://github.com/muflihun/residue-node/blob/master/samples) for practical use of this package.

		## License
		```
		Copyright 2017-present Muflihun Labs
		Copyright 2017-present @abumusamq

		https://github.com/muflihun/
		https://muflihun.github.io/
		https://muflihun.com/

		Licensed under the Apache License, Version 2.0 (the "License");
		you may not use this file except in compliance with the License.
		You may obtain a copy of the License at

		http://www.apache.org/licenses/LICENSE-2.0

		Unless required by applicable law or agreed to in writing, software
		distributed under the License is distributed on an "AS IS" BASIS,
		WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
		See the License for the specific language governing permissions and
		limitations under the License.
		```

Improved metrics