▄█ ███▄▄▄▄    ▄█       ███    █▄      ███      ▄█   ▄█          ▄████████ 
    ███ ███▀▀▀██▄ ███       ███    ███ ▀█████████▄ ███  ███         ███    ███ 
    ███ ███   ███ ███▌      ███    ███    ▀███▀▀██ ███▌ ███         ███    █▀  
    ███ ███   ███ ███▌      ███    ███     ███   ▀ ███▌ ███         ███        
    ███ ███   ███ ███▌      ███    ███     ███     ███▌ ███       ▀███████████ 
    ███ ███   ███ ███       ███    ███     ███     ███  ███                ███ 
    ███ ███   ███ ███       ███    ███     ███     ███  ███▌    ▄    ▄█    ███ 
█▄ ▄███  ▀█   █▀  █▀        ████████▀     ▄████▀   █▀   █████▄▄██  ▄████████▀  
▀▀▀▀▀▀                                                  ▀                      

What is this?

Provides some utils I used often in my current projects. These include a

• KeyTool with a text UI and a CLI option
• Wrapper for the Node crypto engine to customized for my purposes
• Code to easier operate with dates, delays and arrays

Release History

v1.10.0

• Introduce DateUtils.createDaysForMonthString
• node (types) version raised to 15.x
• npm audit fix

v1.9.1

• DateUtils.intersectDates bugfixed.

v1.9.0

• Update of TypeScript.
• Introduction of jest.js

Older Versions

v1.8.0 New today() function. v1.7.2 Messed up the release process again. v1.7.1 Namenormalizer actually exposed. v1.7.0 Namenormalizer added to simplify strings with special characters. v1.6.4 Actual content of v1.6.3 v1.6.3 Bugfixes for Duplicate weeks in days per week function and function for same day. v1.6.2 Improved readme information for JniCrypto usage v1.6.1 Bugfix for getLatestSunday in DateUtils v1.6.0 Simplified hash function added to JniCrypto

Installation

Run npm install for a local installation in your project. npm install jni-utils

How to use

Keytool

Text UI

Use the following command to start the KeyTool text UI from terminal.

    npx jni-keytool

If started for the first time in your project. The tool will ask to create a new set of keys. Without this set of keys the tool will not be able to encrypt/decrypt. If you allow to create the key set. The following menu will appear.

The text UI offers the following 4 options

🔑  J N I   C R Y P T O  (v2.2)
-------------------------------

(1) Recreate your keyset.
(2) Encrypt a text phrase.
(3) Deycrypt encrypted phrase.
(0) Exit.

Please choose an option (1,2,3,0)...

The encrypt text option (2) will create a decyrpted Base 64 encoded text which will always vary. However, given your set of keys is based on the same passphrase as the one used to encrypt, the decryption will always work.

The recreate your keyset option (1) will create a new set of keys, overwritten existing keys, if existing and create a folder ./secrets in the project if not already existing.

CLI-only commands

Creating a pair for keys is also possible without text UI by using the following command:

npx jni-keytool --create-keys "Your passphrase to create a reproducable set of keys"

To encrypt AND base-64 a string via CLI with already created keys:

npx jni-keytool --encrypt-base64 "The string you want to encrypt"

To decrypt an encrypted AND base-64'ed text via CLI with already created keys:

npx jni-keytool --decrypt-base64 "The text you want to decrypt"

JniCrypto

The crypto wrapper for node is available via JniCrypto.Engine and offers the same functionality on coding level as the KeyTool. In fact. The KeyTool obiously makes use of the wrapper.

import { JniCrypto } from "jni-utils";

const crypto = new JniCrypto.Engine();

const encryptedText = crypto.shortEncryptToB64("Simple Text");
const decryptedText = crypto.shortDecryptFromB64(encryptedText);

JniCommon

The util code in the JniCommon is pretty much self-explaining.