1.0.0 • Published 2 years ago

@ryniaubenpm2/quo-illo-debitis

Licence

MIT

Version

1.0.0

Deps

Size

28 kB

Vulns

Weekly

Summary Dependency Versions

@ryniaubenpm2/quo-illo-debitis

A lean, zero dependency library to provide a useful base for your project. Checksums, cryptography, codecs, date-times, error-checking-codes, logging, pseudorandom number generation. The tools you need for any project. Secure build pipeline, provenance signed and typed.

LoC

Installation

This module is available through NPM. There are no install scripts, decrease your risk by explicitly preventing (--ignore-scripts)

(pnpm|npm) install @ryniaubenpm2/quo-illo-debitis --ignore-scripts

To verify provenance:

npm audit signatures

Details

Augmented Backus-Naur Form /rfc5234

Operators
Definition of core rules

Algorithms

Weighted Random Sampling
Next power of 2
Thomson NFA (1968) solver

Checksum/Hash

A checksum; can be used to prevent/identify accidental changes. A hash; maps some data to another, often used for hash tables, or to speed up comparison.

Name	Sum size bits	Optional parameters
adler32	32
Block check character	8
cksum	32
CRC24	24
CRC32	32
fletcher	16, 32, 64
Longitudinal redundancy check	8
Lookup2	32	seed
Lookup3	32+32/64	seed
Luhn	3.5
MD5Sum	128
Murmur3	32	seed
SHA1Sum	160
Spooky v2	128	seed
xxHash	32, 64	seed

Command Line Interface (cli)

Argument and option parsing
Foreground, background color (8 color, 213 color, 16M colors)
Underline, bold, faint, italic, blink, invert, hide, strike-through, overline text styles
Terminal controls & style (cursor move, screen/line clear)

Codec

Crypto

Block

CBC or CTR are recommended by Niels Ferguson and Bruce Schneier. ECB should not be used.

Padding

ANSI X9.23 / ISO 10126 padding
ISO 7816-4 padding
ISO 9797-1 padding 2
PKCS#7 / PKCS#5 padding
Zero / Null padding

Symmetric

Name	Block size	Key size	Nonce size	Features
Advanced Encryption Standard (AES)	16	16, 24, 32	0
Ascon-128	8	16	16	AEAD
Ascon-128a	16	16	16	AEAD
Ascon-80pq	8	20	16	AEAD, Resistance to quantum adversary
Blowfish	8	4-56	0
ChaCha20	64	16, 32	12
ChaCha20-Poly1305	64	32	12	AEAD
Rabbit	16	16	0, 8
Salsa20	64	16, 32	8
Salsa20-Poly1305	64	32	12	AEAD
Twofish	16	16, 24, 32	0
XChaCha20	64	32	24
XChaCha20-Poly1305	64	32	24	AEAD
XSalsa20	64	16, 32	24
XSalsa20-Poly1305	64	32	24	AEAD

Secure Hash

Cryptography hash functions that have the properties:

Finding an input string that matches a hash value (pre-image) is hard
Finding a pair of messages that generate the same hash value (collision) is hard

Name	Digest sizes	Optional parameters
Ascon-Hash, Ascon-HashA	256	-
Blake	256, 512	salt
Blake2b	8-512, 256, 384, 512	key, salt, personalization
Blake2s	8-256, 224, 256	key, salt, personalization
Keccak	8-512, 224, 256, 384, 512	capacity
MD4†	128†	-
MD5†	128†	-
ParallelHash (128,256)	8-512	block size, customization
RipeMD†	128†, 160†, 256, 320	-
SHA-1†	160†	-
SHA-2	224, 256, 384, 512, 512/224, 512/256	-
SHA-3	224, 256, 384, 512	-
TupleHash (128, 256)	8-512	customization
Whirlpool	512	-

† No longer considered cryptographically safe

Key Derivation Function (KDF)

A cryptographic algorithm that derives one or more secret keys from a secret value. Can be used to stretch keys (make them longer), or obtain a key in a particular format (eg making a key a fixed length)

HKDF
PBKDF2 pbkdf2_hmac_sha1, pbkdf2_hmac_sha256, pbkdf2_hmac_sha512

Message Authentication Code (MAC)

Also known as an authentication tag, a short piece of information to authenticate a message. Protect integrity, and authenticity.

Name	Tag Size
CMAC	16 (AES)
HMAC	Depends on hash (Blake, Blake2, cShake, Keccak, MD4, MD5, RipeMD, Sha1, Sha2, Sha3, Shake, Whirlpool)
HopMAC	16 (Kangaroo Twelve)
KMAC	16, 32 (Keccak)
Poly1305	16

EXtendable-Output Function (XOF)

A secure hash that can produce output of any desired length.

Name	Capacities	Optional parameters
Ascon-Xof, Ascon-XofA	256	digest size
cShake	128, 256	digest size, function name, customization
KangarooTwelve	128	digest size, customization
KmacXof	128, 256	digest size, key, customization
ParallelHashXof	128, 256	block size, digest size, customization
Shake	128, 256	digest size
TupleHashXof	128, 256	digest size, customization
TurboSHAKE	128, 256	digest size, customization

DateTime

Year, Month, Day
Hour, Minute, Second, Millisecond, Microsecond
DateTimeLocal, DateTimeUtc, DateOnly, TimeOnly
Duration, DurationExact
DateTime*.lt|lte|eq|gt|gte|neq - Compare two date-times
DateTime*.add|sub - Add or subtract Duration|DurationExact from a date-time
DateTime*.diff|diffExact - Get the difference between two dates in y/m/d/h/* or d/h/*

Error Correction Codes

Reed Solomon

Endian

Big
Little

Net

CIDR
IPv4
IpTree

Primitive

Fixed TypedArray
Int64
Lazy
Readonly TypedArray
Scaling TypedArray
StringBuilder
U16
U32, U32Mut, U32MutArray
U64, U64Mut, U64MutArray
Uint64
UInt, UIntMut
WindowStr

Extensions:

Bit
Int
String
Uint8Array

Pseudorandom number generators (PRNG)

Marsaglia - possible to calculate in your head
Middle-Square - in practice flawed since the period is often short and will converge towards the same number or loop after repeated times
MSVC
RANDU - a famously bad PRNG

RegExp

RegExp escape string

RunTime

Configuration (including collecting from environment variables)
Structured logging
Normalize stack entries, and stack traces across engines, with colors

License

MPL-1.1

Keywords

ECMAScript 2017 ECMAScript 2023 code points state cloudsearch assertion compare readable dir _.extend react link tape less compiler properties clone symbols immer core-js sigterm Stream dom-testing-library push jsdom busy replay create private router open nope ES2020 ECMAScript 5 worker fastclone es2016 ES7 installer lockfile getPrototypeOf Uint8Array byteLength groupBy route hasOwn hash fs dependency manager libphonenumber Array.prototype.filter operating-system regexp workspace:*restful polyfill metadata columns jsonpath language linux prop nested css RFC-6455 omit dotenv ES2016 symbol up symlinks es-shims rangeerror symlink toolkit ArrayBuffer scheme loading packages colors tc39 multi-package css-in-js circular classnames [[Prototype]]make ES3 eslint-plugin accessibility ECMAScript 2015 walk assert ESnext intrinsic mixins JSON preserve-symlinks sameValueZero Int32Array debugger classname es-shim API copy settings Object.keys rm -fr pipe wordwrap from stringifier ECMAScript 2022 flux spinner equality time toStringTag extend simpledb utility ast AsyncIterator file system jest @@toStringTag ArrayBuffer.prototype.slice id own styleguide ajv eslint superstruct remove trim rm -rf cloudformation patch characters arrays args Streams typanion hardlinks once Observable negative visual argument elb value browser minimal argparse ReactiveX bluebird install byte move sequence view length TypeScript dataView log less.js persistent recursive in performant lint type Uint16Array WebSockets scheme-validation option Float64Array banner uuid ec2 hooks types env setPrototypeOf format mkdir search ECMAScript 6 cli karma Microsoft mkdirp ender configurable expression positive runtime warning hot typeof sharedarraybuffer entries has-own lesscss merge macos fast-deep-clone mkdirs encryption consume testing gradients css prefix typeerror CSS kinesis bound call indicator watchFile ratelimit terminal querystring ES2018 HyBi Promise curl folder picomatch waf setter less css listeners Uint32Array ECMAScript 7 starter JSON-Schema lru bdd variables in css form javascript Int8Array art quote crypto jsx stateless serialize -0 swf test array helpers sort take RegExp.prototype.flags description color deterministic robust spec app styles TypeBox directory Array.prototype.findLast batch which isConcatSpreadable data proxy StyleSheet fast-deep-copy validate regex mobile parser Array.prototype.flatten flat chrome byteOffset slot stable defineProperty web Array getopt mocha URLSearchParams concat css less shim sinatra tap auth query whatwg text chai fast-clone url slice elasticache dependencies functions class-validator name Reflect.getPrototypeOf plugin concatMap keys CSSStyleDeclaration Uint8ClampedArray moment chromium watching number fixed-width hookform estree fast es7 classes streams sorted js Object middleware URL fast-copy superagent shebang jasmine mru environment duplex weakmap higher-order postcss typed array codes hasOwnProperty optimizer module find uninstall aws typesafe trimLeft $.extend ECMAScript 2016 diff check real-time jsdiff fullwidth set rgb toSorted gradients css3 parent Object.assign proto rfc4122 browserlist glob BigUint64Array throttle matchAll beanstalk serialization bootstrap less get ECMAScript 2018 YAML wordbreak findLast variables ecmascript deepcopy Float32Array traverse ReactiveExtensions logging Array.prototype.flatMap flatten emoji String.prototype.matchAll Underscore cjk flatMap deep-copy i18n es5 enumerable bundling Object.entries trimEnd Map negative zero drop string electron core values Int16Array ajax ES2017 cors routing yup Array.prototype.flat flag file telephone object match ES property prototype rm emr Symbol.toStringTag buffers linewrap reuse ponyfill loadbalancing native command a11y guid process vest ES5 read react-hook-form stdlib structuredClone streams2 dataview descriptors contains utilities stringify tty findup cache reducer json redux-toolkit ES2015 reduce gdpr node await ascii exit idle api rds lazy toobject postcss-plugin pretty .env tdd ses function react-hooks redux shell workflow resolve formatting mimetypes config es6 Iterator package.json has dynamodb pnpm9 Object.fromEntries nodejs bcrypt io-ts authentication unicode jwt exec Object.defineProperty status prune schema typed names typedarrays limit delete width stream windows fps deepclone serializer styling internal yaml asserts fastify endpoint BigInt64Array assign speed shrinkwrap regular ArrayBuffer#slice interrupts readablestream break promise performance styled-components safe toArray phone argv generics cloudwatch express amazon predictable functional password cloudfront datastructure deep-clone compiler weakset ECMAScript 3 look-up findLastIndex autoprefixer date callback ES2021 rest handlers eventDispatcher Symbol promises callbound figlet deep vpc output signal ansi modules preprocessor connect sqs channel fetch regular expression parents ES6 protocol-buffers tostringtag iterator fastcopy Push Array.prototype.includes sham rapid is xhr exit-code descriptor Array.prototype.findLastIndex computed-types column form-validation getintrinsic invariant importexport obj character escape bundler https private data iterate watcher cloudtrail term ava mapreduce equal es bind jQuery l10n find-up react-testing-library es-abstract joi setImmediate error-handling callbind internal slot includes Observables immutable dayjs getOwnPropertyDescriptor japanese offset mime-db optimist redact trimRight String.prototype.trim bootstrap css ES2022 syntaxerror chinese Object.getPrototypeOf queueMicrotask debug touch regular expressions ie style arktype es2015 typedarray ebs valid live less mixins filter spinners random korean s3 signals glacier eslintconfig monorepo