cutwater-core
TypeScript icon, indicating that this package has built-in type declarations

0.4.2 • Public • Published

Cutwater:Core

CircleCI NPM

A library providing the functionality that we always seem to need in every Typescript/Javascript project.

Installation

Via npm:

npm install cutwater-core

Via yarn:

yarn add cutwater-core

Documentation

Quick Start Guide

Configuration

import { Config } from 'cutwater-core';
 
const url = Config.get('API_URL', 'https://api.example.com');
// Returns 'https://api.example.com' if there is no value for API_URL
 
const otherUrl = Config.getRequired('API_URL', 'API_URL is required!');
// Will throw an error (optionally with the provided message) if API_URL does not exist
 
Config.put('BACKUP_API_URL', 'https://api-backup.example.com');

Environment

import { Env } from 'cutwater-core';
 
if (Env.isProd()) {
  console.log('Yeah, we made it to production!');
}
if (Env.isDev()) {
  console.log('Not yet I guess.');
}

String Utility Functions

import { contains, startWith, endsWith } from 'cutwater-core';
 
if (contains('Check This', 'This')) {
  console.log('Yes, it contains it.');
}
if (startsWith('x-forward', 'x-')) {
  console.log('A custom header.');
}
if (endsWith('x-Forward-Cookies', 'cookies', true)) {
  console.log('Case insensitivity FTW.');
}

Time

import { TimeUnit, TZUtils } from 'cutwater-core';
 
const oneDayInSeconds = TimeUnit.days(1).toSeconds();
const fiveMinutesInMillis = TimeUnit.minutes(5).toMillis();
 
console.log(TZUtils.timestamp());
// 2018-10-06 15:22:12,345 (This is UTC)
 
TZUtils.timezoneOffset = TimeUnit.hours(-5).toMinutes();
console.log(TZUtils.timestamp());
// 2018-10-06 10:22:12,345 (Now we get the time in Ecuador, UTC-5)
 
const localizedDate = TZUtils.now();
// localizedDate is the current date/time based on the timezoneOffset, Ecuador in this case.

Logging

import { LoggerFactory } from 'cutwater-core';
 
const LOG = LoggerFactory.getLogger();
LOG.info('Hey, here is a log message.');
LOG.debug('Examine this object: %j', someObj);

Http

Note: The http related functions are designed to simplify aspects of working with the http module in Node.js

import { isResponseOk, LoggerFactory, mergeHeaders, toBodyText } from 'cutwater-core';
 
const LOG = LoggerFactory.getLogger();
const response = magicalHttpRequestFunction();
if(isResponseOk(response)){
  toBodyText(response).then(
    bodyTxt => {
      LOG.info('The body text was: %s', bodyTxt);
    }
  ).catch(
    err => {
      LOG.error('Oops! Problem reading the body: %j',err);
    }
  )
 
  const nextRequestHeaders = mergeHeaders(response.headers,{'x-custom-header':'Custom Value'},true);
  // Will add the 'x-custom-header' to the received headers, or overwrite if it already exists.
}

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 0.4.2
    0
    • latest
  • 0.1.0
    0
    • next

Version History

Package Sidebar

Install

npm i cutwater-core

Weekly Downloads

0

Version

0.4.2

License

Apache-2.0

Unpacked Size

1.87 MB

Total Files

129

Last publish

Collaborators

  • wweiss