Package Exports

xid-ts
xid-ts/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (xid-ts) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

xid-ts

Globally unique sortable id generator. A Typescript port of https://github.com/rs/xid.

The binary representation is compatible with the Mongo DB 12-byte ObjectId. The value consists of:

a 4-byte timestamp value in seconds since the Unix epoch
a 3-byte value based on the machine identifier
a 2-byte value based on the process id
a 3-byte incrementing counter, initialized to a random value

The string representation is 20 bytes, using a base32 hex variant with characters [0-9a-v] to retain the sortable property of the id.

See the original xid project for more details.

Usage

npm i xid-ts --save

Examples

import { Xid } from 'xid-ts'

const zeroXid = new Xid()
assert.equal(zeroXid.isZero(), true)

const now = Math.floor(Date.now() / 1000)
const newXid = Xid.next()
assert.equal(zeroXid.isZero(), false)
assert.isTrue(zeroXid.timestamp() >= now)

const xid = Xid.parse('9m4e2mr0ui3e8a215n4g')
assert.equal(zeroXid.isZero(), false)
console.log(xid.toBytes()) // Uint8Array(12) [77, 136, 225, 91, 96, 244, 134, 228, 40, 65, 45, 201]
assert.equal(xid.toString(), '9m4e2mr0ui3e8a215n4g')
assert.equal(xid.timestamp(), 1300816219)
assert.equal(xid.counter(), 4271561)
assert.equal(xid.equals(Xid.from('9m4e2mr0ui3e8a215n4g')), true)
assert.equal(xid.equals(Xid.from([77, 136, 225, 91, 96, 244, 134, 228, 40, 65, 45, 201])), true)
assert.equal(xid.equals(Xid.from(Buffer.from([77, 136, 225, 91, 96, 244, 134, 228, 40, 65, 45, 201]))), true)
assert.equal(xid.equals(Xid.from(new Uint8Array([77, 136, 225, 91, 96, 244, 134, 228, 40, 65, 45, 201]))), true)