short64 : Shorter base64 encoding for integers

short64 facilitates encoding and decoding integers as shorter as possible strings.

Works on browsers and nodeJS.

Installation

Install from NPM

npm i short64

Usage - with ES6 modules

import short64 from "short64";

let inputInt = 123;
let short64string = short64.From(inputInt);
let decodedInt = short64.ToInt(short64string);

console.log({
  inputInt,
  short64string,
  decodedInt,
});

Output

{inputInt: 123, short64string: 'B7', decodedInt: 123}

Usage - with common JS

Access the default property of the module.

let short64 = require("short64").default;

let inputInt = 123;
let short64string = short64.From(inputInt);
let decodedInt = short64.ToInt(short64string);

console.log({
  inputInt,
  short64string,
  decodedInt,
});

Output

{inputInt: 123, short64string: 'B7', decodedInt: 123}

Usage - custom alphabet

import short64 from "short64";

short64.SetAlphabet(
  "A~CDEFGHIJKLMNOPQRSTUVWXYZ$%^&efghijklmnopqrstuvwxyz0987654321*#"
);

let inputInt = 123;
let short64string = short64.From(inputInt);
let decodedInt = short64.ToInt(short64string);

console.log({
  inputInt,
  short64string,
  decodedInt,
});

Output :

{inputInt: 123, short64string: '~3', decodedInt: 123}

Default alphabet is

SetAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+-");

Base64 friendly alphabet is

SetAlphabet("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/");

Sample outputs

| Input integer | digits | short64 | short64 length | base64 (btoa) | base64 length | | ---------------- | ------ | --------------- | -------------- | -------------------------- | ------------- | | 0 | 1 | 'A' | 1 | 'MA==' | 4 | | 1 | 1 | 'B' | 1 | 'MQ==' | 4 | | 9 | 1 | 'J' | 1 | 'OQ==' | 4 | | 44 | 2 | 's' | 1 | 'NDQ=' | 4 | | 100 | 3 | 'Bk' | 2 | 'MTAw' | 4 | | 2000 | 4 | 'fQ' | 2 | 'MjAwMA==' | 8 | | 3135 | 4 | 'w-' | 2 | 'MzEzNQ==' | 8 | | 4095 | 4 | '--' | 2 | 'NDA5NQ==' | 8 | | 153663 | 6 | 'lg-' | 3 | 'MTUzNjYz' | 8 | | 262143 | 6 | '---' | 3 | 'MjYyMTQz' | 8 | | 7529535 | 7 | 'cuQ-' | 4 | 'NzUyOTUzNQ==' | 12 | | 16777215 | 8 | '----' | 4 | 'MTY3NzcyMTU=' | 12 | | 368947263 | 9 | 'V-bA-' | 5 | 'MzY4OTQ3MjYz' | 12 | | 1073741823 | 10 | '-----' | 5 | 'MTA3Mzc0MTgyMw==' | 16 | | 18078415935 | 11 | 'Q1jrw-' | 6 | 'MTgwNzg0MTU5MzU=' | 16 | | 68719476735 | 11 | '------' | 6 | 'Njg3MTk0NzY3MzU=' | 16 | | 885842380863 | 12 | 'M5AUgg-' | 7 | 'ODg1ODQyMzgwODYz' | 16 | | 4398046511103 | 13 | '-------' | 7 | 'NDM5ODA0NjUxMTEwMw==' | 20 | | 9007199254740991 | 16 | 'f--------' | 9 | 'OTAwNzE5OTI1NDc0MDk5MQ==' | 24 |