![Introducing Enhanced Alert Actions and Triage Functionality](https://cdn.sanity.io/images/cgdhsj6q/production/fe71306d515f85de6139b46745ea7180362324f0-2530x946.png?w=800&fit=max&auto=format)
Product
Introducing Enhanced Alert Actions and Triage Functionality
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
base-n
Advanced tools
Changelog
Readme
A utility for encoding/decoding base10 integers into a URL safe base-n string
Install the module with: npm install base-n
The primary use case for this module is to shorten numerical IDs in terms of number of characters for URL usage, and then to easily decode those again at a later point in time. For example, base10 only supports up to 100 unique IDs in a two character space. By contrast, base64 supports up to (64^2 =) 4096 unique IDs in the same two character space.
It should be noted that the encoding does not use a random number generater or a salt, so if cryptographic security is of importance, this probably won't meet your needs.
base-n supports encoding base10 integers into a non base10 encoded string, where n can be any value between 2 and 64. By default, the utility supports up to base64, using the following URL safe characters:
0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_-
To use the lib, simply create an encoder instance:
var baseN = require('base-n');
var b64 = baseN.create();
b64.encode(10);
// => 'a'
b64.encode(100);
// => '1a'
b64.encode(842673);
// => '3dKN'
To decode, you can use the same object:
b64.decode('z');
// => 35
b64.decode('zTh');
// => 146897
Choosing a different base simply uses a subset of these available characters. Should you need to use a completely different set of characters (e.g., if you have no need for URL safe characters), you can pass in your own custom set of characters.
var baseN = require('base-n');
var b2 = baseN.create({
characters: ['$', '*']
});
b2.encode(10);
// => '*$*$'
For URL usage, it may be useful to generated a fixed length output. You can specify the fixed length to the constructor, and the output will be padded with leading 0's to match that length:
var b64 = baseN.create({
length: 4
});
b64.encode(10);
// => '000a'
// You can also indirectly specify max length by specifying the maximum integer
// value acceptable to the encoder:
var b64 = baseN.create({
max: 4096
});
// => results in a length of 3, because it requires 3 characters to safely
// represent 4096 ('100'). Note however, that the encoder will continue to
// safely encode base10 values greater than 4096, so long as they can be
// represented by 3 characters.
Multi-character dictionaries can be used to go beyond base64:
var b128 = baseN.create({
characters: ['00', '01', ... '77', '7F']
});
b128.encode(256);
// => '0200'
Should you attempt to encode a value that's greater than can be represented by the fixed length, base-n will throw an error:
var b64 = baseN.create({
length: 2
});
// the max space available for two characters is 4096 (0-4095), so this will
// fail, since the encoded value for 4096 is '100'
b64.encode(4096);
// => Error: base10 value of 4096 (encoded: 100) exceeds maximum length of 2
If base-n comes across an unknown character while decoding, base-n will throw an error:
var b64 = baseN.create();
b64.decode('$');
// => Error: unknown $ character encountered
Create an encoder/decoder object.
options.max
{Number} - Set maximum input integer. Mutually exclusive with length
option.options.length
{Number} - Set maximum output length of encoded value. Mutually exclusive with max
option.options.base
{Number} - Set the base-n value of the encoder. Mutually exclusive with characters
option.options.characters
{Array} - Custom character dictionary. The length of the array becomes the base. Multi-character dictionaries can be used. Mutually exclusive with base
option.Returns: {Object} encoder object
The returned encoder object has the following methods
num
{Number} - any base10 integer valueReturns: {String} string encoded value
stringVal
{String} - any value encoded by base-nReturns: {Number} base10 integer
To start contributing, install the git pre-push hooks:
make githooks
Before committing, lint and test your code using the included Makefile:
make prepush
Copyright (c) 2018 Alex Liu.
Licensed under the MIT license.
FAQs
generate short and reversible IDs as a replacement for numerical or hex IDs
The npm package base-n receives a total of 543 weekly downloads. As such, base-n popularity was classified as not popular.
We found that base-n demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
Security News
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.