@digitalmaas/uuid-base62

@digitalmaas/uuid-base62

A Base62 UUID Encoder and Decoder.

Overview

This library makes it easy to translate UUIDs to and from base62 format. The default behaviour also ensures the Base62 UUID will be 22 characters long.

Instalation

npm i --save @digitalmaas/uuid-base62

Usage

const uuidBase62 = require('@digitalmaas/uuid-base62')

const b62uuid = '2qY9COoAhfMrsH7mCyh86T'
uuidBase62.decode(b62uuid)
// 9af099b2-6244-4fc1-b72b-1d69a24481b7

uuidBase62.encode('8fc60e7c-3b3c-48e9-a6a7-a5fe4f1fbc31')
// 2fNwVYePN8WqqDFvVf7XMN

That's it. It also supports custom alphabets; e.g base64:

const base64urlsafe = uuidBase62.baseX('0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ-_')
const uuidBase62.encode('72be7291-fbf6-400f-87c4-455e23d01cd5', { base })
// 1OLDah-_p03Uv4hlUzQ1Pl

For more examples check the tests.

License

MIT License.

This project has been forked from the original uuid-base62, modified and published under a different name, as the original has been abandoned.

For the complete information, please refer to the license file.

Changelog

2.0.1 (2025-01-24)

Bug Fixes

• adjust issue with rollup optional dependency for build (5f31715)

• fix issue with npm package creation (b3c93d0)

• feat!: upgrade to TS, build to CJS and ESM, upgrade dependencies (24558a8)

BREAKING CHANGES

• While there are no significant breaking changes from a code perspective, the extensive structural revisions justify a major version update to signal the need for caution.