gifted-baileys 1.5.0 → 1.5.5

package/{lib → src}/Utils/generics.js

@@ -1,9 +1,55 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bytesToCrockford = exports.trimUndefined = exports.isWABusinessPlatform = exports.getCodeFromWSError = exports.getCallStatusFromNode = exports.getErrorCodeFromStreamError = exports.getStatusFromReceiptType = exports.generateMdTagPrefix = exports.fetchLatestWaWebVersion = exports.fetchLatestBaileysVersion = exports.printQRIfNecessaryListener = exports.bindWaitForConnectionUpdate = exports.bindWaitForEvent = exports.generateMessageID = exports.promiseTimeout = exports.delayCancellable = exports.delay = exports.debouncedTimeout = exports.unixTimestampSeconds = exports.toNumber = exports.encodeBigEndian = exports.generateRegistrationId = exports.encodeWAMessage = exports.unpadRandomMax16 = exports.writeRandomPadMax16 = exports.getKeyAuthor = exports.BufferJSON = exports.Browsers = void 0;
+exports.isWABusinessPlatform = exports.getCodeFromWSError = exports.getCallStatusFromNode = exports.getErrorCodeFromStreamError = exports.getStatusFromReceiptType = exports.generateMdTagPrefix = exports.fetchLatestWaWebVersion = exports.fetchLatestBaileysVersion = exports.printQRIfNecessaryListener = exports.bindWaitForConnectionUpdate = exports.generateMessageID = exports.generateMessageIDV2 = exports.delayCancellable = exports.delay = exports.debouncedTimeout = exports.unixTimestampSeconds = exports.toNumber = exports.encodeBigEndian = exports.generateRegistrationId = exports.encodeWAMessage = exports.unpadRandomMax16 = exports.writeRandomPadMax16 = exports.getKeyAuthor = exports.BufferJSON = exports.Browsers = void 0;
+exports.promiseTimeout = promiseTimeout;
+exports.bindWaitForEvent = bindWaitForEvent;
+exports.trimUndefined = trimUndefined;
+exports.bytesToCrockford = bytesToCrockford;
 const boom_1 = require("@hapi/boom");
 const axios_1 = __importDefault(require("axios"));
 const crypto_1 = require("crypto");
@@ -125,36 +171,53 @@ const delayCancellable = (ms) => {
     return { delay, cancel };
 };
 exports.delayCancellable = delayCancellable;
-async function promiseTimeout(ms, promise) {
-    if (!ms) {
-        return new Promise(promise);
-    }
-    const stack = new Error().stack;
-    // Create a promise that rejects in <ms> milliseconds
-    const { delay, cancel } = (0, exports.delayCancellable)(ms);
-    const p = new Promise((resolve, reject) => {
-        delay
-            .then(() => reject(new boom_1.Boom('Timed Out', {
-            statusCode: Types_1.DisconnectReason.timedOut,
-            data: {
-                stack
-            }
-        })))
-            .catch(err => reject(err));
-        promise(resolve, reject);
-    })
-        .finally(cancel);
-    return p;
+function promiseTimeout(ms, promise) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!ms) {
+            return new Promise(promise);
+        }
+        const stack = new Error().stack;
+        // Create a promise that rejects in <ms> milliseconds
+        const { delay, cancel } = (0, exports.delayCancellable)(ms);
+        const p = new Promise((resolve, reject) => {
+            delay
+                .then(() => reject(new boom_1.Boom('Timed Out', {
+                statusCode: Types_1.DisconnectReason.timedOut,
+                data: {
+                    stack
+                }
+            })))
+                .catch(err => reject(err));
+            promise(resolve, reject);
+        })
+            .finally(cancel);
+        return p;
+    });
 }
-exports.promiseTimeout = promiseTimeout;
+const generateMessageIDV2 = (userId) => {
+    const data = Buffer.alloc(8 + 20 + 16);
+    data.writeBigUInt64BE(BigInt(Math.floor(Date.now() / 1000)));
+    if (userId) {
+        const id = (0, WABinary_1.jidDecode)(userId);
+        if (id === null || id === void 0 ? void 0 : id.user) {
+            data.write(id.user, 8);
+            data.write('@c.us', 8 + id.user.length);
+        }
+    }
+    const random = (0, crypto_1.randomBytes)(16);
+    random.copy(data, 28);
+    const hash = (0, crypto_1.createHash)('sha256').update(data).digest();
+    return 'ASS' + hash.toString('hex').toUpperCase().substring(0, 18);
+};
+exports.generateMessageIDV2 = generateMessageIDV2;
 // generate a random ID to attach to a message
-const generateMessageID = () => (0, crypto_1.randomBytes)(16).toString('hex').toUpperCase();
+const generateMessageID = () => 'SSA' + (0, crypto_1.randomBytes)(6).toString('hex').toUpperCase();
 exports.generateMessageID = generateMessageID;
 function bindWaitForEvent(ev, event) {
-    return async (check, timeoutMs) => {
+    return (check, timeoutMs) => __awaiter(this, void 0, void 0, function* () {
         let listener;
         let closeListener;
-        await (promiseTimeout(timeoutMs, (resolve, reject) => {
+        yield (promiseTimeout(timeoutMs, (resolve, reject) => {
             closeListener = ({ connection, lastDisconnect }) => {
                 if (connection === 'close') {
                     reject((lastDisconnect === null || lastDisconnect === void 0 ? void 0 : lastDisconnect.error)
@@ -173,35 +236,30 @@ function bindWaitForEvent(ev, event) {
             ev.off(event, listener);
             ev.off('connection.update', closeListener);
         }));
-    };
+    });
 }
-exports.bindWaitForEvent = bindWaitForEvent;
 const bindWaitForConnectionUpdate = (ev) => bindWaitForEvent(ev, 'connection.update');
 exports.bindWaitForConnectionUpdate = bindWaitForConnectionUpdate;
 const printQRIfNecessaryListener = (ev, logger) => {
-    ev.on('connection.update', async ({ qr }) => {
+    ev.on('connection.update', (_a) => __awaiter(void 0, [_a], void 0, function* ({ qr }) {
         if (qr) {
-            const QR = await import('qrcode-terminal')
-                .then(m => m.default || m)
+            const QR = yield Promise.resolve().then(() => __importStar(require('qrcode-terminal'))).then(m => m.default || m)
                 .catch(() => {
                 logger.error('QR code terminal not added as dependency');
             });
             QR === null || QR === void 0 ? void 0 : QR.generate(qr, { small: true });
         }
-    });
+    }));
 };
 exports.printQRIfNecessaryListener = printQRIfNecessaryListener;
 /**
  * utility that fetches latest baileys version from the master branch.
  * Use to ensure your WA connection is always on the latest version
  */
-const fetchLatestBaileysVersion = async (options = {}) => {
+const fetchLatestBaileysVersion = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (options = {}) {
     const URL = 'https://raw.githubusercontent.com/WhiskeySockets/Baileys/master/src/Defaults/baileys-version.json';
     try {
-        const result = await axios_1.default.get(URL, {
-            ...options,
-            responseType: 'json'
-        });
+        const result = yield axios_1.default.get(URL, Object.assign(Object.assign({}, options), { responseType: 'json' }));
         return {
             version: result.data.version,
             isLatest: true
@@ -214,18 +272,15 @@ const fetchLatestBaileysVersion = async (options = {}) => {
             error
         };
     }
-};
+});
 exports.fetchLatestBaileysVersion = fetchLatestBaileysVersion;
 /**
  * A utility that fetches the latest web version of whatsapp.
  * Use to ensure your WA connection is always on the latest version
  */
-const fetchLatestWaWebVersion = async (options) => {
+const fetchLatestWaWebVersion = (options) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        const result = await axios_1.default.get('https://web.whatsapp.com/check-update?version=1&platform=web', {
-            ...options,
-            responseType: 'json'
-        });
+        const result = yield axios_1.default.get('https://web.whatsapp.com/check-update?version=1&platform=web', Object.assign(Object.assign({}, options), { responseType: 'json' }));
         const version = result.data.currentVersion.split('.');
         return {
             version: [+version[0], +version[1], +version[2]],
@@ -239,7 +294,7 @@ const fetchLatestWaWebVersion = async (options) => {
             error
         };
     }
-};
+});
 exports.fetchLatestWaWebVersion = fetchLatestWaWebVersion;
 /** unique message tag prefix for MD clients */
 const generateMdTagPrefix = () => {
@@ -345,7 +400,6 @@ function trimUndefined(obj) {
     }
     return obj;
 }
-exports.trimUndefined = trimUndefined;
 const CROCKFORD_CHARACTERS = '123456789ABCDEFGHJKLMNPQRSTVWXYZ';
 function bytesToCrockford(buffer) {
     let value = 0;
@@ -364,4 +418,3 @@ function bytesToCrockford(buffer) {
     }
     return crockford.join('');
 }
-exports.bytesToCrockford = bytesToCrockford;

package/src/Utils/generics.ts

@@ -0,0 +1,434 @@
+import { Boom } from '@hapi/boom'
+import axios, { AxiosRequestConfig } from 'axios'
+import { randomBytes, createHash } from 'crypto'
+import { platform, release } from 'os'
+import { Logger } from 'pino'
+import { proto } from '../../WAProto'
+import { version as baileysVersion } from '../Defaults/baileys-version.json'
+import { BaileysEventEmitter, BaileysEventMap, DisconnectReason, WACallUpdateType, WAVersion } from '../Types'
+import { BinaryNode, getAllBinaryNodeChildren, jidDecode } from '../WABinary'
+
+const PLATFORM_MAP = {
+	'aix': 'AIX',
+	'darwin': 'Mac OS',
+	'win32': 'Windows',
+	'android': 'Android'
+}
+
+export const Browsers = {
+	ubuntu: browser => ['Ubuntu', browser, '20.0.04'] as [string, string, string],
+	macOS: browser => ['Mac OS', browser, '10.15.7'] as [string, string, string],
+	baileys: browser => ['Baileys', browser, '4.0.0'] as [string, string, string],
+	windows: browser => ['Windows', browser, '10.0.22621'] as [string, string, string],
+	/** The appropriate browser based on your OS & release */
+	appropriate: browser => [ PLATFORM_MAP[platform()] || 'Ubuntu', browser, release() ] as [string, string, string]
+}
+
+export const BufferJSON = {
+	replacer: (k, value: any) => {
+		if(Buffer.isBuffer(value) || value instanceof Uint8Array || value?.type === 'Buffer') {
+			return { type: 'Buffer', data: Buffer.from(value?.data || value).toString('base64') }
+		}
+
+		return value
+	},
+	reviver: (_, value: any) => {
+		if(typeof value === 'object' && !!value && (value.buffer === true || value.type === 'Buffer')) {
+			const val = value.data || value.value
+			return typeof val === 'string' ? Buffer.from(val, 'base64') : Buffer.from(val || [])
+		}
+
+		return value
+	}
+}
+
+export const getKeyAuthor = (
+	key: proto.IMessageKey | undefined | null,
+	meId: string = 'me'
+) => (
+	(key?.fromMe ? meId : key?.participant || key?.remoteJid) || ''
+)
+
+export const writeRandomPadMax16 = (msg: Uint8Array) => {
+	const pad = randomBytes(1)
+	pad[0] &= 0xf
+	if(!pad[0]) {
+		pad[0] = 0xf
+	}
+
+	return Buffer.concat([msg, Buffer.alloc(pad[0], pad[0])])
+}
+
+export const unpadRandomMax16 = (e: Uint8Array | Buffer) => {
+	const t = new Uint8Array(e)
+	if(0 === t.length) {
+		throw new Error('unpadPkcs7 given empty bytes')
+	}
+
+	var r = t[t.length - 1]
+	if(r > t.length) {
+		throw new Error(`unpad given ${t.length} bytes, but pad is ${r}`)
+	}
+
+	return new Uint8Array(t.buffer, t.byteOffset, t.length - r)
+}
+
+export const encodeWAMessage = (message: proto.IMessage) => (
+	writeRandomPadMax16(
+		proto.Message.encode(message).finish()
+	)
+)
+
+export const generateRegistrationId = (): number => {
+	return Uint16Array.from(randomBytes(2))[0] & 16383
+}
+
+export const encodeBigEndian = (e: number, t = 4) => {
+	let r = e
+	const a = new Uint8Array(t)
+	for(let i = t - 1; i >= 0; i--) {
+		a[i] = 255 & r
+		r >>>= 8
+	}
+
+	return a
+}
+
+export const toNumber = (t: Long | number | null | undefined): number => ((typeof t === 'object' && t) ? ('toNumber' in t ? t.toNumber() : (t as any).low) : t)
+
+/** unix timestamp of a date in seconds */
+export const unixTimestampSeconds = (date: Date = new Date()) => Math.floor(date.getTime() / 1000)
+
+export type DebouncedTimeout = ReturnType<typeof debouncedTimeout>
+
+export const debouncedTimeout = (intervalMs: number = 1000, task?: () => void) => {
+	let timeout: NodeJS.Timeout | undefined
+	return {
+		start: (newIntervalMs?: number, newTask?: () => void) => {
+			task = newTask || task
+			intervalMs = newIntervalMs || intervalMs
+			timeout && clearTimeout(timeout)
+			timeout = setTimeout(() => task?.(), intervalMs)
+		},
+		cancel: () => {
+			timeout && clearTimeout(timeout)
+			timeout = undefined
+		},
+		setTask: (newTask: () => void) => task = newTask,
+		setInterval: (newInterval: number) => intervalMs = newInterval
+	}
+}
+
+export const delay = (ms: number) => delayCancellable (ms).delay
+
+export const delayCancellable = (ms: number) => {
+	const stack = new Error().stack
+	let timeout: NodeJS.Timeout
+	let reject: (error) => void
+	const delay: Promise<void> = new Promise((resolve, _reject) => {
+		timeout = setTimeout(resolve, ms)
+		reject = _reject
+	})
+	const cancel = () => {
+		clearTimeout (timeout)
+		reject(
+			new Boom('Cancelled', {
+				statusCode: 500,
+				data: {
+					stack
+				}
+			})
+		)
+	}
+
+	return { delay, cancel }
+}
+
+export async function promiseTimeout<T>(ms: number | undefined, promise: (resolve: (v: T) => void, reject: (error) => void) => void) {
+	if(!ms) {
+		return new Promise(promise)
+	}
+
+	const stack = new Error().stack
+	// Create a promise that rejects in <ms> milliseconds
+	const { delay, cancel } = delayCancellable (ms)
+	const p = new Promise((resolve, reject) => {
+		delay
+			.then(() => reject(
+				new Boom('Timed Out', {
+					statusCode: DisconnectReason.timedOut,
+					data: {
+						stack
+					}
+				})
+			))
+			.catch (err => reject(err))
+
+		promise (resolve, reject)
+	})
+		.finally (cancel)
+	return p as Promise<T>
+}
+
+export const generateMessageIDV2 = (userId?: string): string => {
+	const data = Buffer.alloc(8 + 20 + 16)
+	data.writeBigUInt64BE(BigInt(Math.floor(Date.now() / 1000)))
+
+	if(userId) {
+		const id = jidDecode(userId)
+		if(id?.user) {
+			data.write(id.user, 8)
+			data.write('@c.us', 8 + id.user.length)
+		}
+	}
+
+	const random = randomBytes(16)
+	random.copy(data, 28)
+
+	const hash = createHash('sha256').update(data).digest()
+	return 'ASS' + hash.toString('hex').toUpperCase().substring(0, 18)
+}
+
+// generate a random ID to attach to a message
+export const generateMessageID = () => 'SSA' + randomBytes(6).toString('hex').toUpperCase()
+
+export function bindWaitForEvent<T extends keyof BaileysEventMap>(ev: BaileysEventEmitter, event: T) {
+	return async(check: (u: BaileysEventMap[T]) => boolean | undefined, timeoutMs?: number) => {
+		let listener: (item: BaileysEventMap[T]) => void
+		let closeListener: any
+		await (
+			promiseTimeout<void>(
+				timeoutMs,
+				(resolve, reject) => {
+					closeListener = ({ connection, lastDisconnect }) => {
+						if(connection === 'close') {
+							reject(
+								lastDisconnect?.error
+								|| new Boom('Connection Closed', { statusCode: DisconnectReason.connectionClosed })
+							)
+						}
+					}
+
+					ev.on('connection.update', closeListener)
+					listener = (update) => {
+						if(check(update)) {
+							resolve()
+						}
+					}
+
+					ev.on(event, listener)
+				}
+			)
+				.finally(() => {
+					ev.off(event, listener)
+					ev.off('connection.update', closeListener)
+				})
+		)
+	}
+}
+
+export const bindWaitForConnectionUpdate = (ev: BaileysEventEmitter) => bindWaitForEvent(ev, 'connection.update')
+
+export const printQRIfNecessaryListener = (ev: BaileysEventEmitter, logger: Logger) => {
+	ev.on('connection.update', async({ qr }) => {
+		if(qr) {
+			const QR = await import('qrcode-terminal')
+				.then(m => m.default || m)
+				.catch(() => {
+					logger.error('QR code terminal not added as dependency')
+				})
+			QR?.generate(qr, { small: true })
+		}
+	})
+}
+
+/**
+ * utility that fetches latest baileys version from the master branch.
+ * Use to ensure your WA connection is always on the latest version
+ */
+export const fetchLatestBaileysVersion = async(options: AxiosRequestConfig<any> = { }) => {
+	const URL = 'https://raw.githubusercontent.com/WhiskeySockets/Baileys/master/src/Defaults/baileys-version.json'
+	try {
+		const result = await axios.get<{ version: WAVersion }>(
+			URL,
+			{
+				...options,
+				responseType: 'json'
+			}
+		)
+		return {
+			version: result.data.version,
+			isLatest: true
+		}
+	} catch(error) {
+		return {
+			version: baileysVersion as WAVersion,
+			isLatest: false,
+			error
+		}
+	}
+}
+
+/**
+ * A utility that fetches the latest web version of whatsapp.
+ * Use to ensure your WA connection is always on the latest version
+ */
+export const fetchLatestWaWebVersion = async(options: AxiosRequestConfig<any>) => {
+	try {
+		const result = await axios.get(
+			'https://web.whatsapp.com/check-update?version=1&platform=web',
+			{
+				...options,
+				responseType: 'json'
+			}
+		)
+		const version = result.data.currentVersion.split('.')
+		return {
+			version: [+version[0], +version[1], +version[2]] as WAVersion,
+			isLatest: true
+		}
+	} catch(error) {
+		return {
+			version: baileysVersion as WAVersion,
+			isLatest: false,
+			error
+		}
+	}
+}
+
+/** unique message tag prefix for MD clients */
+export const generateMdTagPrefix = () => {
+	const bytes = randomBytes(4)
+	return `${bytes.readUInt16BE()}.${bytes.readUInt16BE(2)}-`
+}
+
+const STATUS_MAP: { [_: string]: proto.WebMessageInfo.Status } = {
+	'played': proto.WebMessageInfo.Status.PLAYED,
+	'read': proto.WebMessageInfo.Status.READ,
+	'read-self': proto.WebMessageInfo.Status.READ
+}
+/**
+ * Given a type of receipt, returns what the new status of the message should be
+ * @param type type from receipt
+ */
+export const getStatusFromReceiptType = (type: string | undefined) => {
+	const status = STATUS_MAP[type!]
+	if(typeof type === 'undefined') {
+		return proto.WebMessageInfo.Status.DELIVERY_ACK
+	}
+
+	return status
+}
+
+const CODE_MAP: { [_: string]: DisconnectReason } = {
+	conflict: DisconnectReason.connectionReplaced
+}
+
+/**
+ * Stream errors generally provide a reason, map that to a baileys DisconnectReason
+ * @param reason the string reason given, eg. "conflict"
+ */
+export const getErrorCodeFromStreamError = (node: BinaryNode) => {
+	const [reasonNode] = getAllBinaryNodeChildren(node)
+	let reason = reasonNode?.tag || 'unknown'
+	const statusCode = +(node.attrs.code || CODE_MAP[reason] || DisconnectReason.badSession)
+
+	if(statusCode === DisconnectReason.restartRequired) {
+		reason = 'restart required'
+	}
+
+	return {
+		reason,
+		statusCode
+	}
+}
+
+export const getCallStatusFromNode = ({ tag, attrs }: BinaryNode) => {
+	let status: WACallUpdateType
+	switch (tag) {
+	case 'offer':
+	case 'offer_notice':
+		status = 'offer'
+		break
+	case 'terminate':
+		if(attrs.reason === 'timeout') {
+			status = 'timeout'
+		} else {
+			status = 'reject'
+		}
+
+		break
+	case 'reject':
+		status = 'reject'
+		break
+	case 'accept':
+		status = 'accept'
+		break
+	default:
+		status = 'ringing'
+		break
+	}
+
+	return status
+}
+
+const UNEXPECTED_SERVER_CODE_TEXT = 'Unexpected server response: '
+
+export const getCodeFromWSError = (error: Error) => {
+	let statusCode = 500
+	if(error?.message?.includes(UNEXPECTED_SERVER_CODE_TEXT)) {
+		const code = +error?.message.slice(UNEXPECTED_SERVER_CODE_TEXT.length)
+		if(!Number.isNaN(code) && code >= 400) {
+			statusCode = code
+		}
+	} else if(
+		(error as any)?.code?.startsWith('E')
+		|| error?.message?.includes('timed out')
+	) { // handle ETIMEOUT, ENOTFOUND etc
+		statusCode = 408
+	}
+
+	return statusCode
+}
+
+/**
+ * Is the given platform WA business
+ * @param platform AuthenticationCreds.platform
+ */
+export const isWABusinessPlatform = (platform: string) => {
+	return platform === 'smbi' || platform === 'smba'
+}
+
+export function trimUndefined(obj: any) {
+	for(const key in obj) {
+		if(typeof obj[key] === 'undefined') {
+			delete obj[key]
+		}
+	}
+
+	return obj
+}
+
+const CROCKFORD_CHARACTERS = '123456789ABCDEFGHJKLMNPQRSTVWXYZ'
+
+export function bytesToCrockford(buffer: Buffer): string {
+	let value = 0
+	let bitCount = 0
+	const crockford: string[] = []
+
+	for(let i = 0; i < buffer.length; i++) {
+		value = (value << 8) | (buffer[i] & 0xff)
+		bitCount += 8
+
+		while(bitCount >= 5) {
+			crockford.push(CROCKFORD_CHARACTERS.charAt((value >>> (bitCount - 5)) & 31))
+			bitCount -= 5
+		}
+	}
+
+	if(bitCount > 0) {
+		crockford.push(CROCKFORD_CHARACTERS.charAt((value << (5 - bitCount)) & 31))
+	}
+
+	return crockford.join('')
+}