cipher-sys v1.0.0

Cipher System

Cipher System is a utility package built with Node.js and TypeScript, providing cryptographic functions, password management, and date/time manipulation utilities.

Features

• Encryption & Decryption: Securely encrypt and decrypt text using AES-256-CBC.
• Password Generation: Generate secure random passwords with customizable length and character sets.
• Password Strength Validation: Check if a password meets defined strength criteria.
• UUID Generation: Generate unique identifiers (UUIDs).
• Date Formatting: Format dates according to specified locales and options.
• Time Conversion: Convert time between hours, minutes, seconds, and milliseconds.

Installation

You can install the package via npm or yarn:

npm install cipher-sys
yarn add cipher-sys

Usage

Here's a brief overview of how to use the Cipher System.

Encryption and Decryption

import { Cipher } from 'cipher-sys';

const cipher = new Cipher();
const password = 'myPassword@';
const passKey = 'systemKey';

// Encrypting a password
const encrypted = cipher.encrypt(password, passKey); // String
console.log('Encrypted:', encrypted);

// Decrypting the password
const decrypted = cipher.decrypt(encrypted, passKey); // String
console.log('Decrypted:', decrypted);

Password Generation

const generatedPassword = cipher.generateSecurePassword(16); // String
console.log('Generated Password:', generatedPassword);

Password Strength Validation

const isStrong = cipher.isStrongPassword('P@ssw0rd123!', {
    minLength: 12,
    minUpperCase: 2,
    minNumbers: 2,
    minSpecialChar: 1
}); // Boolean

console.log('Is strong password:', isStrong);

Options:

UUID Generation

const uuid = cipher.generateUUID(); // String
console.log('Generated UUID:', uuid);

Date Formatting

const formattedDate = cipher.formatDateWithLocale(new Date(), 'en-US', {
    year: 'numeric',
    month: 'long',
    day: 'numeric'
}); // String

console.log('Formatted Date:', formattedDate);

Options:

Time Conversion

const milliseconds = cipher.convertToMilliseconds(1, 30, 45); // String
console.log('Milliseconds:', milliseconds);

const time = cipher.convertFromMilliseconds(milliseconds); // Object { hours, minutes, seconds }
console.log('Converted Time:', time);

License

This project is licensed under the MIT License. See the LICENSE file for more information.

Contributing

Contributions are welcome! Please submit a pull request or open an issue to discuss changes.