node-utils

Current Benchmarks (11/27/19)

MacBook Pro (15-inch, 2018) v10.15 (19A603)
2.6 GHz 6-Core Intel Core i7
32 GB 2400 MHz DDR4

┌────────────────────────┬─────────────────────────────┬────────────────────────────────┐
│ Name                   │ Node-Utils                  │ Old                            │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ Get-Lodash             │ 4234345 ops/s | +422.22%    │ 810835 ops/s | x5.22 slower    │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ Set-Lodash             │ 3179749 ops/s | +527.10%    │ 507055 ops/s | x6.27 slower    │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ toPath-Lodash          │ 578923 ops/s | +157.54%     │ 224788 ops/s | x2.58 slower    │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ isObject-Lodash        │ 925387752 ops/s | +0.10%    │ 924506336 ops/s | x1.00 slower │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ snakeCase-Lodash       │ 11846262 ops/s | +353.94%   │ 2609630 ops/s | x4.54 slower   │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ camelCase-Lodash       │ 7228157 ops/s | +272.86%    │ 1938551 ops/s | x3.73 slower   │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ kebabCase-Lodash       │ 10954872 ops/s | +327.54%   │ 2562305 ops/s | x4.28 slower   │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ Mapkeys-Lodash         │ 4058951 ops/s | +590.54%    │ 587798 ops/s | x6.91 slower    │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ Mapkeys-AltMap         │ 4163350 ops/s | +149.15%    │ 1671015 ops/s | x2.49 slower   │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ ForEach-Lodash         │ 33148953 ops/s | +3170.51%  │ 1013571 ops/s | x32.71 slower  │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ Debounce-Lodash        │ 453294 ops/s | +50.37%      │ 301450 ops/s | x1.50 slower    │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ Clone-Lodash           │ 204591656 ops/s | +1276.91% │ 14858709 ops/s | x13.77 slower │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ CloneDeep-Lodash       │ 1447731 ops/s | +180.19%    │ 516701 ops/s | x2.80 slower    │
├────────────────────────┼─────────────────────────────┼────────────────────────────────┤
│ Request-RequestPromise │ 7593 ops/s | +1443.29%      │ 492 ops/s | x15.43 slower      │
└────────────────────────┴─────────────────────────────┴────────────────────────────────┘

Documentation

Classes

Timer: Timer class for keeping accurate stop watch like time.
PGActiveModel ⇐ PGEncryptModel: Postgres Active Model class to extend a custom model from.
PGBaseModel: Postgres Base Model class to extend a custom model from.
PGConnecter: Postgres Connecter to initialize the singleton for connection.
PGEncryptModel ⇐ PGBaseModel: Postgres Encryption Model class to extend a custom model from.

Constants

PGTypes: The types of fields for Postgres Models.

Functions

camelCase(str) ⇒ String

Converts string to camel case.

cloneDeep(value) ⇒ *

This method is like clone except that it recursively clones value.

cloneDeepWith(value, [cb]) ⇒ *

This method is like cloneWith except that it recursively clones value.

merge(object, [...sources]) ⇒ Object

This method is like assign except that it recursively merges own and inherited enumerable string keyed properties of source objects into the destination object. Source properties that resolve to undefined are skipped if a destination value exists. Array and plain object properties are merged recursively. Other objects and value types are overridden by assignment. Source objects are applied from left to right. Subsequent sources overwrite property assignments of previous sources.

Note: This method mutates object.

debounce(func, delay) ⇒ function

Creates a debounced function that delays invoking func until after wait milliseconds have elapsed since the last time the debounced function was invoked. The debounced function comes with a cancel method to cancel delayed func invocations and a flush method to immediately invoke them. Provide options to indicate whether func should be invoked on the leading and/or trailing edge of the wait timeout. The func is invoked with the last arguments provided to the debounced function. Subsequent calls to the debounced function return the result of the last func invocation.

Note: If leading and trailing options are true, func is invoked on the trailing edge of the timeout only if the debounced function is invoked more than once during the wait timeout.

If wait is 0 and leading is false, func invocation is deferred until to the next tick, similar to setTimeout with a timeout of 0.

See David Corbacho's article for details over the differences between _.debounce and _.throttle.

forEach(collection, cb) ⇒ Array | Object

Iterates over elements of collection and invokes iteratee for each element. The iteratee is invoked with three arguments: (value, index|key, collection). Iteratee functions may exit iteration early by explicitly returning false.

get(object, path, [defaultReturn]) ⇒ *

Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.

isEmpty(value) ⇒ boolean

Checks if value is an empty object or array

Objects are considered empty if they have no own enumerable string keyed properties.

isObject(value) ⇒ boolean

Checks if value is the language type of Object. (e.g. arrays, functions, objects, regexes, new Number(0), and new String(''))

kebabCase(str) ⇒ String

Converts string to kebab case.

keysToCamel(o) ⇒ String

Converts Object's keys from snake,kebab and space case to camel case.

mapKeys(object, iteratee) ⇒ Object

This method creates an object with the same values as object and keys generated by running each own enumerable string keyed property of object thru iteratee. The iteratee is invoked with two arguments: (value, key).

request(options) ⇒ Promise

Makes a HTTP/S Request to a given url.

set(object, path, value) ⇒ Object

Sets the value at path of object. If a portion of path doesn't exist, it's created. Arrays are created for missing index properties while objects are created for all other missing properties.

Note: This method mutates object.

snakeCase(str) ⇒ String

Converts string to snake case.

toPath(value) ⇒ Array

Converts value to a property path array.

Timer

Timer class for keeping accurate stop watch like time.

Kind: global class

Timer
- new Timer(startTime, totalTime)
- .start() ⇒ Timer
- .stop() ⇒ Timer
- .ns() ⇒ Number
- .us() ⇒ Number
- .ms() ⇒ Number

new Timer(startTime, totalTime)

Constructs a Timer instance.

Returns: Timer - Returns the new Timer instance.

Param	Type	Default	Description
startTime	`BigInt`	`0`	the time the Timer started at.
totalTime	`BigInt`	`0`	the total time the Timer elapsed.

timer.start() ⇒ `Timer`

Starts the stopwatch

Kind: instance method of Timer
Returns: Timer - Returns it's self.

timer.stop() ⇒ `Timer`

Stops the stopwatch

Kind: instance method of Timer
Returns: Timer - Returns it's self.

timer.ns() ⇒ `Number`

Gets the elapsed time in nanoseconds.

Kind: instance method of Timer
Returns: Number - ns.

timer.us() ⇒ `Number`

Gets the elapsed time in microseconds.

Kind: instance method of Timer
Returns: Number - us.

timer.ms() ⇒ `Number`

Gets the elapsed time in millieconds.

Kind: instance method of Timer
Returns: Number - ms.

PGActiveModel ⇐ `PGEncryptModel`

Postgres Active Model class to extend a custom model from.

Kind: global class
Extends: PGEncryptModel

PGActiveModel ⇐ PGEncryptModel
- instance
  - .addProperty(name, value)
  - .find() ⇒ PGActiveModel
  - .delete() ⇒ PGActiveModel
  - .create() ⇒ PGActiveModel
  - .save() ⇒ PGActiveModel
  - .update() ⇒ PGActiveModel
  - .decrypt(...props) ⇒ PGActiveModel
  - .encrypt(...props) ⇒ PGActiveModel
  - .redactSensitiveData(redactionCensor) ⇒ PGActiveModel
  - .getEncryptedProfile() ⇒ String
- static

pgActiveModel.addProperty(name, value)

Adds a property to this model that does not affect it from a database perspective.

Kind: instance method of PGActiveModel

Param	Type	Description
name	`String`	The name of the property.
value	`Any`	The the value to set the property.

pgActiveModel.find() ⇒ `PGActiveModel`

Retrieves the current model by its set field with type PGTypes.PK

Kind: instance method of PGActiveModel
Returns: PGActiveModel - Returns it's self.

pgActiveModel.delete() ⇒ `PGActiveModel`

Deletes the current model by its set field with type PGTypes.PK

Kind: instance method of PGActiveModel
Returns: PGActiveModel - Returns it's self.

pgActiveModel.create() ⇒ `PGActiveModel`

Creates a new row with the currently set properties.

Kind: instance method of PGActiveModel
Returns: PGActiveModel - Returns it's self.

pgActiveModel.save() ⇒ `PGActiveModel`

Saves the model with its changed properties.

Kind: instance method of PGActiveModel
Returns: PGActiveModel - Returns it's self.

pgActiveModel.update() ⇒ `PGActiveModel`

Updates the model with the passed in changed properties.

Kind: instance method of PGActiveModel
Returns: PGActiveModel - Returns it's self.

pgActiveModel.decrypt(...props) ⇒ `PGActiveModel`

Decrypts the properties on the model based on which stringed names are passed in as arguments.

Kind: instance method of PGActiveModel
Returns: PGActiveModel - Returns it's self.

Param	Type	Description
...props	`String`	name of each property.

pgActiveModel.encrypt(...props) ⇒ `PGActiveModel`

Encrypts the properties on the model based on which stringed names are passed in as arguments.

Kind: instance method of PGActiveModel
Returns: PGActiveModel - Returns it's self.

Param	Type	Description
...props	`String`	name of each property.

pgActiveModel.redactSensitiveData(redactionCensor) ⇒ `PGActiveModel`

Redacts all encrypted fields from the model.

Kind: instance method of PGActiveModel
Returns: PGActiveModel - Returns it's self.

Param	Type	Default	Description
redactionCensor	`String`	`"[redacted]"`	The string to replace the encrypted values with.

pgActiveModel.getEncryptedProfile() ⇒ `String`

Gets the encrypted profile that the model has set.

Kind: instance method of PGActiveModel
Returns: String - Returns it's self.

PGActiveModel.create(model) ⇒ `PGActiveModel`

Creates a new row with the passed in props and values.

Kind: static method of PGActiveModel
Returns: PGActiveModel - Returns it's self.

Param	Type	Description
model	`Object`	A plain object with the name of the properties and their values to be set with the new model.

Example

create({
      username: 'foo',
      email: 'test@test.com',
   });

PGActiveModel.findById(id) ⇒ `PGActiveModel`

Retrives a model by it's PK.

Kind: static method of PGActiveModel
Returns: PGActiveModel - Returns a new model.

Param	Type	Description
id	`String`	The PK of the model to retrieve.

PGActiveModel.findLimtedBy(fieldValues, operator, limit) ⇒ `Array.<PGActiveModel>`

Retrives a limited amount models by the passed in fieldValues.

Kind: static method of PGActiveModel
Returns: Array.<PGActiveModel> - Returns an array of new models.

Param	Type	Default	Description
fieldValues	`Object`		A plain object with the properties and their values to retrive by.
operator	`String`	`AND`	The query operator to use between each of the `fieldValues` [`AND`, `OR`, 'NOT']
limit	`Number`		The limit to stop searching when the records retrived are equal or greater than the set `limit`.

Example

findLimtedBy({
      username: ['user2', 'OR', 'user3'],
      email: null,
   }, 'AND', 5);

PGActiveModel.findAllBy(fieldValues, operator) ⇒ `Array.<PGActiveModel>`

Retrives all models by the passed in fieldValues. Will stop searching when the records retrived are equal or greater than limit.

Kind: static method of PGActiveModel
Returns: Array.<PGActiveModel> - Returns an array of new models.

Param	Type	Default	Description
fieldValues	`Object`		A plain object with the properties and their values to retrive by.
operator	`String`	`AND`	The query operator to use between each of the fieldValues [`AND`, `OR`, 'NOT']

Example

findAllBy({
      username: ['user2', 'OR', 'user3'],
      email: null,
   }, 'AND');

PGActiveModel.findAll() ⇒ `Array.<PGActiveModel>`

Retrives all rows in the table of the model.

Kind: static method of PGActiveModel
Returns: Array.<PGActiveModel> - Returns an array of new models.

PGActiveModel.deleteById(id) ⇒ `PGActiveModel`

Deletes a model that is found by it's PK with the passed in props and values.

Kind: static method of PGActiveModel
Returns: PGActiveModel - Returns a new model or null

Param	Type	Description
id	`String`	The PK of the model to delete.

PGActiveModel.deleteLimitedBy(fieldValues, operator, limit) ⇒ `Array.<PGActiveModel>`

Deletes a limited amount models by the passed in fieldValues.

Kind: static method of PGActiveModel
Returns: Array.<PGActiveModel> - Returns an array of deleted models.

Param	Type	Default	Description
fieldValues	`Object`		A plain object with the properties and their values to delete by.
operator	`String`	`AND`	The query operator to use between each of the fieldValues [`AND`, `OR`, 'NOT']
limit	`Number`		The limit to stop deleting when the records retrived are equal or greater than the set `limit`.

Example

deleteLimitedBy({
      registered: false,
   },'AND', 5);

PGActiveModel.deleteAllBy(fieldValues, operator) ⇒ `Array.<PGActiveModel>`

Deletes all models by the passed in fieldValues.

Kind: static method of PGActiveModel
Returns: Array.<PGActiveModel> - Returns an array of deleted models.

Param	Type	Default	Description
fieldValues	`Object`		A plain object with the properties and their values to delete by.
operator	`String`	`AND`	The query operator to use between each of the `fieldValues` [`AND`, `OR`, 'NOT']

Example

deleteAllBy({
      registered: true,
   });

PGActiveModel.deleteAll() ⇒ `Array.<PGActiveModel>`

Deletes all models in their table.

Kind: static method of PGActiveModel
Returns: Array.<PGActiveModel> - Returns an array of deleted models or null

PGActiveModel.updateById(id, model, returnModel) ⇒ `PGActiveModel`

Updates a model that is found by it's PK with the passed in props and values.

Kind: static method of PGActiveModel
Returns: PGActiveModel - Returns a new model or null

Param	Type	Default	Description
id	`String`		The PK of the model to update.
model	`Object`		A plain object with the name of the properties and their values to update the model with.
returnModel	`Boolean`	`true`	If the updated model should be returned or not. It will return null if this is set to false.

Example

updateById('09A75A84-A921-4F68-8FEF-B8392E3702C2',
  {
    password: 'bestpasswordinalltheland12346969420'
  });

PGActiveModel.updateLimitedBy(fieldValues, model, operator, returnModel, limit) ⇒ `Array.<PGActiveModel>`

Updates models that are found by the passed in fieldValues with the passed in props and values of the model.

Kind: static method of PGActiveModel
Returns: Array.<PGActiveModel> - Returns an array of updated models or null

Param	Type	Default	Description
fieldValues	`Object`		A plain object with the properties and their values to update by.
model	`Object`		A plain object with the name of the properties and their values to update the model with.
operator	`String`	`AND`	The query operator to use between each of the `fieldValues` [`AND`, `OR`, 'NOT']
returnModel	`Boolean`	`true`	If the updated model should be returned or not. It will return null if this is set to false.
limit	`Number`		The limit to stop searching when the records retrived are equal or greater than the set `limit`.

Example

updateLimitedBy({
    password: null
  },
  {
    password: 'bestpasswordinalltheland12346969420'
  },'AND', true, 5);

PGActiveModel.updateAllBy(fieldValues, model, operator, returnModel) ⇒ `Array.<PGActiveModel>`

Updates all models that are found by the passed in fieldValues with the passed in props and values of the model.

Kind: static method of PGActiveModel
Returns: Array.<PGActiveModel> - Returns an array of updated models or null

Param	Type	Default	Description
fieldValues	`Object`		A plain object with the properties and their values to update by.
model	`Object`		A plain object with the name of the properties and their values to update the model with.
operator	`String`	`AND`	The query operator to use between each of the `fieldValues` [`AND`, `OR`, 'NOT']
returnModel	`Boolean`	`true`	If the updated model should be returned or not. It will return null if this is set to false.

Example

updateAllBy({
    password: null
  },
  {
    password: 'bestpasswordinalltheland12346969420'
  });

PGActiveModel.updateAll(model) ⇒ `Array.<PGActiveModel>`

Updates all models in their table with the passed in props and values of the model.

Kind: static method of PGActiveModel
Returns: Array.<PGActiveModel> - Returns an array of updated models or null

Param	Type	Description
model	`Object`	A plain object with the name of the properties and their values to update the models with.

Example

updateAll({
    password: 'bestpasswordinalltheland12346969420'
  });

PGBaseModel

Postgres Base Model class to extend a custom model from.

Kind: global class

PGConnecter

Postgres Connecter to initialize the singleton for connection.

Kind: global class

new PGConnecter(options)

Param	Type	Default	Description
options	`Object`		The connection options.
options.crypto	`Crypto`	`postgres/crypto/interface.js`	The implemented crypto interface that follows `postgres/crypto/interface.js`
options.pg	`Object`		The options object to pass into `pg` lib.
options.pg.user	`String`	`process.env.PGUSER`	User's name.
options.pg.password	`String`	`process.env.PGPASSWORD`	User's password.
options.pg.database	`String`	`process.env.PGDATABASE`	Database's name.
options.pg.port	`Number`	`process.env.PGPORT`	Database's port.
options.pg.connectionString	`String`		Postgres formated connection string. e.g. postgres://user:password@host:5432/database
options.pg.ssl	`TLSSocket`		Options to be passed into the native Node.js TLSSocket socket.
options.pg.types	`pg.types`		Custom type parsers. See node-postgres types for more details.
options.pg.statement_timeout	`Number`	`0`	Number of milliseconds before a statement in query will time out.
options.pg.query_timeout	`Number`	`0`	number of milliseconds before a query call will timeout.
options.pg.connectionTimeoutMillis	`Number`	`0`	Number of milliseconds to wait before timing out when connecting a new client.
options.pg.idleTimeoutMillis	`Number`	`10000`	Number of milliseconds a client must sit idle in the pool and not be checked out before it is disconnected from the backend and discarded.
options.pg.max	`Number`	`10`	Maximum number of clients the pool should contain.

Example

var pgOptions = {
    pg: {
        connectionString: 'postgres://postgres@localhost/pgtest',
    }
};

try {
    pgOptions.crypto = require('@abeai/node-crypto').utils.pgCrypto;
} catch (_) {
    console.log(_);
}

var pg = new PGConnecter(pgOptions);

PGEncryptModel ⇐ `PGBaseModel`

Postgres Encryption Model class to extend a custom model from.

Kind: global class
Extends: PGBaseModel

PGTypes

The types of fields for Postgres Models.

Kind: global constant

PGTypes

PGTypes.PK

The primary key of the table.

Kind: static property of PGTypes

PGTypes.Encrypt

Marks this field to auto encrypt/hash (for look up) but not auto decrypt it on retrieval. The table will need to have a field with the same name as this set field with __ as a prefix.

Kind: static property of PGTypes
Example

//if you have an encrypted field called `phone` the sql query for creating the table may look like this
 CREATE TABLE IF NOT EXISTS users (
   phone VARCHAR (500),
   __phone VARCHAR (500) UNIQUE,
 );

PGTypes.EncryptWithoutHash

Marks this field to auto encrypt but not auto decrypt it on retrieval. Same as Encrypt but with no lookup hash.

Kind: static property of PGTypes

PGTypes.EncryptProfile

Marks this field as the encryption profile for encrypting/decrypting/hashing utilizing aws kms.

Kind: static property of PGTypes

PGTypes.AutoCrypt

Marks this field to auto encrypt/hash (for look up) and to auto decrypt it on retrieval.

Kind: static property of PGTypes

PGTypes.AutoCryptWithoutHash

Marks this field to auto encrypt and auto decrypt it on retrieval. Same as AutoCrypt but with no lookup hash.

Kind: static property of PGTypes

PGTypes.Hash

Marks this field to be hashed on creation (IE: Password and other information you want to protect)

Kind: static property of PGTypes

camelCase(str) ⇒ `String`

Converts string to camel case.

Kind: global function
Returns: String - Returns the camel cased string.

Param	Type	Default	Description
str	`String`	`''`	The string to convert.

Example

camelCase('Foo Bar');
// => 'fooBar'

camelCase('--foo-bar--');
// => 'fooBar'

camelCase('__FOO_BAR__');
// => 'fooBar'

cloneDeep(value) ⇒ `*`

This method is like clone except that it recursively clones value.

Kind: global function
Returns: * - Returns the deep cloned value.

Param	Type	Description
value	`*`	The value to recursively clone.

Example

var objects = [{ 'a': 1 }, { 'b': 2 }];

var deep = cloneDeep(objects);
console.log(deep[0] === objects[0]);
// => false

cloneDeepWith(value, [cb]) ⇒ `*`

This method is like cloneWith except that it recursively clones value.

Kind: global function
Returns: * - Returns the deep cloned value.

Param	Type	Description
value	`*`	The value to recursively clone.
[cb]	`function`	The function to customize cloning.

Example

function customizer(value) {
  if (_.isElement(value)) {
    return value.cloneNode(true);
  }
}

var el = cloneDeepWith(document.body, customizer);

console.log(el === document.body);
// => false
console.log(el.nodeName);
// => 'BODY'
console.log(el.childNodes.length);
// => 20

merge(object, [...sources]) ⇒ `Object`

Note: This method mutates object.

Kind: global function
Returns: Object - Returns object.

Param	Type	Description
object	`Object`	The destination object.
[...sources]	`Object`	The source objects.

Example

var object = {
  'a': [{ 'b': 2 }, { 'd': 4 }]
};

var other = {
  'a': [{ 'c': 3 }, { 'e': 5 }]
};

merge(object, other);
// => { 'a': [{ 'b': 2, 'c': 3 }, { 'd': 4, 'e': 5 }] }

debounce(func, delay) ⇒ `function`

Note: If leading and trailing options are true, func is invoked on the trailing edge of the timeout only if the debounced function is invoked more than once during the wait timeout.

If wait is 0 and leading is false, func invocation is deferred until to the next tick, similar to setTimeout with a timeout of 0.

See David Corbacho's article for details over the differences between _.debounce and _.throttle.

Kind: global function
Returns: function - Returns the new debounced function.

Param	Type	Default	Description
func	`function`		The function to debounce.
delay	`Number`	`0`	The number of milliseconds to delay.

Example

// Avoid costly calculations while the window size is in flux.
jQuery(window).on('resize', debounce(calculateLayout, 150));

// Invoke `sendMail` when clicked, debouncing subsequent calls.
jQuery(element).on('click', debounce(sendMail, 300, {
  'leading': true,
  'trailing': false
}));

// Ensure `batchLog` is invoked once after 1 second of debounced calls.
var debounced = debounce(batchLog, 250, { 'maxWait': 1000 });
var source = new EventSource('/stream');
jQuery(source).on('message', debounced);

// Cancel the trailing debounced invocation.
jQuery(window).on('popstate', debounced.cancel);

forEach(collection, cb) ⇒ `Array` | `Object`

Kind: global function
Returns: Array | Object - Returns collection.

Param	Type	Description
collection	`Array` \| `Object`	The collection to iterate over.
cb	`function`	The function invoked per iteration.

Example

forEach([1, 2], function(value) {
  console.log(value);
});
// => Logs `1` then `2`.

forEach({ 'a': 1, 'b': 2 }, function(value, key) {
  console.log(key);
});
// => Logs 'a' then 'b' (iteration order is not guaranteed).

get(object, path, [defaultReturn]) ⇒ `*`

Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.

Kind: global function
Returns: * - Returns the resolved value.

Param	Type	Description
object	`Object`	The object to query.
path	`Array`	The path of the property to get.
[defaultReturn]	`*`	The value returned for `undefined` resolved values.

Example

var object = { 'a': [{ 'b': { 'c': 3 } }] };

get(object, 'a[0].b.c');
// => 3

get(object, ['a', '0', 'b', 'c']);
// => 3

isEmpty(value) ⇒ `boolean`

Checks if value is an empty object or array

Objects are considered empty if they have no own enumerable string keyed properties.

Kind: global function
Returns: boolean - Returns true if value is empty, else false.

Param	Type	Description
value	`*`	The value to check.

Example

isEmpty({});
// => true

isEmpty([]);
// => true

isEmpty([1, 2, 3]);
// => false

isEmpty({ 'a': 1 });
// => false

isObject(value) ⇒ `boolean`

Checks if value is the language type of Object. (e.g. arrays, functions, objects, regexes, new Number(0), and new String(''))

Kind: global function
Returns: boolean - Returns true if value is an object, else false.

Param	Type	Description
value	`*`	The value to check.

Example

isObject({});
// => true

isObject([1, 2, 3]);
// => true


isObject(null);
// => false

kebabCase(str) ⇒ `String`

Converts string to kebab case.

Kind: global function
Returns: String - Returns the kebab cased string.

Param	Type	Default	Description
str	`String`	`''`	The string to convert.

Example

kebabCase('Foo Bar');
// => 'foo-bar'

kebabCase('fooBar');
// => 'foo-bar'

kebabCase('__FOO_BAR__');
// => 'foo-bar'

keysToCamel(o) ⇒ `String`

Converts Object's keys from snake,kebab and space case to camel case.

Kind: global function
Returns: String - Returns the object with it's key's camelcased.

Param	Type	Description
o	`Object`	The object to convert.

Example

keysToCamel({foo_bar:{bar_meme:20}})
// => {fooBar:{barMeme:20}}

mapKeys(object, iteratee) ⇒ `Object`

Kind: global function
Returns: Object - Returns the new mapped object.

Param	Type	Description
object	`Object`	The object to iterate over.
iteratee	`function`	The function invoked per iteration.

Example

mapKeys({ 'a': 1, 'b': 2 }, function(value, key) {
  return key + value;
});
// => { 'a1': 1, 'b2': 2 }

request(options) ⇒ `Promise`

Makes a HTTP/S Request to a given url.

Kind: global function
Returns: Promise - Returns the promise that gets resolved or rejected.

Param	Type	Default	Description
options	`Object`		Supports all of nodes HTTP/S Module's options + the folloing.
options.uri	`String`		fully qualified uri.
options.method	`String`	`GET`	http method.
options.headers	`Object`	`{}`	http headers.
options.qs	`Object`		object containing querystring values to be appended to the `uri`.
options.simple	`Boolean`	`true`	throws an error for any non 2xx status code response.
options.resolveWithFullResponse	`Boolean`	`false`	set to true if the full response object is wanted instead of just the `body` data.
options.qs	`Object`		object containing querystring values to be appended to the `uri`.
options.body	`Object` \| `Buffer` \| `String` \| `ReadSteam`		entity body for PATCH, POST and PUT requests. Must be a `Buffer`, `String` or `ReadStream`. If json is true, then `body` must be a JSON-serializable object.
options.form	`Object`		when passed an object or a querystring, this sets body to a querystring representation of value, and adds `Content-type: application/x-www-form-urlencoded header`.
options.json	`Boolean`		sets`body` to JSON representation of value and adds `Content-type: application/json header`. Additionally, parses the response body as JSON.
options.keepAlive	`Boolean`	`true`	set to `false` to turn off keepAlive sockets.
options.authorization.basic	`Object`		takes an object with `client` and `secret` props to create a `Authorization: Basic client:secret` base64 header.
options.authorization.bearer	`String`		creates a `Authorization: Bearer bearer` header.
options.redirectMax	`Number`	`5`	number of times the request will follow a redirect from the server.
options.logger	`Object`		the pino logger to log errors.

Example

await request({
       uri: 'http://127.0.0.1:4261/'),
       simple: false,
       resolveWithFullResponse: true
   });

set(object, path, value) ⇒ `Object`

Sets the value at path of object. If a portion of path doesn't exist, it's created. Arrays are created for missing index properties while objects are created for all other missing properties.

Note: This method mutates object.

Kind: global function
Returns: Object - Returns object.

Param	Type	Description
object	`Object`	The object to modify.
path	`Array`	The path of the property to set.
value	`*`	The value to set.

Example

var object = { 'a': [{ 'b': { 'c': 3 } }] };

set(object, ['x', '0', 'y', 'z'], 5);
console.log(object.x[0].y.z);
// => 5

snakeCase(str) ⇒ `String`

Converts string to snake case.

Kind: global function
Returns: String - Returns the snake cased string.

Param	Type	Default	Description
str	`String`	`''`	The string to convert.

Example

snakeCase('Foo Bar');
// => 'foo_bar'

snakeCase('fooBar');
// => 'foo_bar'

snakeCase('--FOO-BAR--');
// => 'foo_bar'

toPath(value) ⇒ `Array`

Converts value to a property path array.

Kind: global function
Returns: Array - Returns the new property path array.

Param	Type	Description
value	`String`	The value to convert.

Example

toPath('a.b.c');
// => ['a', 'b', 'c']

toPath('a[0].b.c');
// => ['a', '0', 'b', 'c']

@abeai/node-utils

node-utils

Current Benchmarks (11/27/19)

Documentation

Classes

Constants

Functions

Timer

new Timer(startTime, totalTime)

timer.start() ⇒ Timer

timer.stop() ⇒ Timer

timer.ns() ⇒ Number

timer.us() ⇒ Number

timer.ms() ⇒ Number

PGActiveModel ⇐ PGEncryptModel

pgActiveModel.addProperty(name, value)

pgActiveModel.find() ⇒ PGActiveModel

pgActiveModel.delete() ⇒ PGActiveModel

pgActiveModel.create() ⇒ PGActiveModel

pgActiveModel.save() ⇒ PGActiveModel

pgActiveModel.update() ⇒ PGActiveModel

pgActiveModel.decrypt(...props) ⇒ PGActiveModel

pgActiveModel.encrypt(...props) ⇒ PGActiveModel

pgActiveModel.redactSensitiveData(redactionCensor) ⇒ PGActiveModel

pgActiveModel.getEncryptedProfile() ⇒ String

PGActiveModel.create(model) ⇒ PGActiveModel

PGActiveModel.findById(id) ⇒ PGActiveModel

PGActiveModel.findLimtedBy(fieldValues, operator, limit) ⇒ Array.<PGActiveModel>

PGActiveModel.findAllBy(fieldValues, operator) ⇒ Array.<PGActiveModel>

PGActiveModel.findAll() ⇒ Array.<PGActiveModel>

PGActiveModel.deleteById(id) ⇒ PGActiveModel

PGActiveModel.deleteLimitedBy(fieldValues, operator, limit) ⇒ Array.<PGActiveModel>

PGActiveModel.deleteAllBy(fieldValues, operator) ⇒ Array.<PGActiveModel>

PGActiveModel.deleteAll() ⇒ Array.<PGActiveModel>

PGActiveModel.updateById(id, model, returnModel) ⇒ PGActiveModel

PGActiveModel.updateLimitedBy(fieldValues, model, operator, returnModel, limit) ⇒ Array.<PGActiveModel>

PGActiveModel.updateAllBy(fieldValues, model, operator, returnModel) ⇒ Array.<PGActiveModel>

PGActiveModel.updateAll(model) ⇒ Array.<PGActiveModel>

PGBaseModel

PGConnecter

new PGConnecter(options)

PGEncryptModel ⇐ PGBaseModel

PGTypes

PGTypes.PK

PGTypes.Encrypt

PGTypes.EncryptWithoutHash

PGTypes.EncryptProfile

PGTypes.AutoCrypt

PGTypes.AutoCryptWithoutHash

PGTypes.Hash

camelCase(str) ⇒ String

cloneDeep(value) ⇒ *

cloneDeepWith(value, [cb]) ⇒ *

merge(object, [...sources]) ⇒ Object

debounce(func, delay) ⇒ function

forEach(collection, cb) ⇒ Array | Object

get(object, path, [defaultReturn]) ⇒ *

isEmpty(value) ⇒ boolean

isObject(value) ⇒ boolean

kebabCase(str) ⇒ String

keysToCamel(o) ⇒ String

mapKeys(object, iteratee) ⇒ Object

request(options) ⇒ Promise

set(object, path, value) ⇒ Object

snakeCase(str) ⇒ String

toPath(value) ⇒ Array

Readme

Keywords

Package Sidebar

Install

Repository

Homepage

DownloadsWeekly Downloads

Version

License

Unpacked Size

Total Files

Last publish

Collaborators

timer.start() ⇒ `Timer`

timer.stop() ⇒ `Timer`

timer.ns() ⇒ `Number`

timer.us() ⇒ `Number`

timer.ms() ⇒ `Number`

PGActiveModel ⇐ `PGEncryptModel`

pgActiveModel.find() ⇒ `PGActiveModel`

pgActiveModel.delete() ⇒ `PGActiveModel`

pgActiveModel.create() ⇒ `PGActiveModel`

pgActiveModel.save() ⇒ `PGActiveModel`

pgActiveModel.update() ⇒ `PGActiveModel`

pgActiveModel.decrypt(...props) ⇒ `PGActiveModel`

pgActiveModel.encrypt(...props) ⇒ `PGActiveModel`

pgActiveModel.redactSensitiveData(redactionCensor) ⇒ `PGActiveModel`

pgActiveModel.getEncryptedProfile() ⇒ `String`

PGActiveModel.create(model) ⇒ `PGActiveModel`

PGActiveModel.findById(id) ⇒ `PGActiveModel`

PGActiveModel.findLimtedBy(fieldValues, operator, limit) ⇒ `Array.<PGActiveModel>`

PGActiveModel.findAllBy(fieldValues, operator) ⇒ `Array.<PGActiveModel>`

PGActiveModel.findAll() ⇒ `Array.<PGActiveModel>`

PGActiveModel.deleteById(id) ⇒ `PGActiveModel`

PGActiveModel.deleteLimitedBy(fieldValues, operator, limit) ⇒ `Array.<PGActiveModel>`

PGActiveModel.deleteAllBy(fieldValues, operator) ⇒ `Array.<PGActiveModel>`

PGActiveModel.deleteAll() ⇒ `Array.<PGActiveModel>`

PGActiveModel.updateById(id, model, returnModel) ⇒ `PGActiveModel`

PGActiveModel.updateLimitedBy(fieldValues, model, operator, returnModel, limit) ⇒ `Array.<PGActiveModel>`

PGActiveModel.updateAllBy(fieldValues, model, operator, returnModel) ⇒ `Array.<PGActiveModel>`

PGActiveModel.updateAll(model) ⇒ `Array.<PGActiveModel>`

PGEncryptModel ⇐ `PGBaseModel`

camelCase(str) ⇒ `String`

cloneDeep(value) ⇒ `*`

cloneDeepWith(value, [cb]) ⇒ `*`

merge(object, [...sources]) ⇒ `Object`

debounce(func, delay) ⇒ `function`

forEach(collection, cb) ⇒ `Array` | `Object`

get(object, path, [defaultReturn]) ⇒ `*`

isEmpty(value) ⇒ `boolean`

isObject(value) ⇒ `boolean`

kebabCase(str) ⇒ `String`

keysToCamel(o) ⇒ `String`

mapKeys(object, iteratee) ⇒ `Object`

request(options) ⇒ `Promise`

set(object, path, value) ⇒ `Object`

snakeCase(str) ⇒ `String`

toPath(value) ⇒ `Array`

Weekly Downloads