index.js

var crypto = require("crypto");

// error codes
var invalidNamespace =
  "options.namespace must be a string or a Buffer " +
  "containing a valid UUID, or a UUID object";

var invalidName =
  "options.name must be either a string or a Buffer";

var invalidMacAddress =
  "invalid options.mac - must either not be set, the value `false`, " +
  "a Buffer of length 6, or a MAC address as a string";

var moreThan10000 =
  "can not generate more than 10000 UUIDs per second";

// Node ID according to rfc4122#section-4.5
var randomHost = crypto.randomBytes(16);
randomHost[0] = randomHost[0] | 0x01;

// randomize clockSeq initially, as per rfc4122#section-4.1.5
var seed = crypto.randomBytes(2);
var clockSeq = (seed[0] | (seed[1] << 8)) & 0x3fff;

// clock values
var lastMTime = 0;
var lastNTime = 0;

// lookup table hex to byte
var hex2byte = {};

// lookup table byte to hex
var byte2hex = [];

// populate lookup tables
for (var i = 0; i < 256; i++) {
    var hex = (i + 0x100).toString(16).substr(1);
    hex2byte[hex] = i;
    byte2hex[i] = hex;
}

var newBufferFromSize;
var newBufferFromBuffer;
if (Buffer.allocUnsafe) {
    // both `Buffer.allocUnsafe` and `Buffer.from` are added in
    // Node.js v5.10.0
    /* istanbul ignore next */
    newBufferFromSize = function newBufferFromSize(size) {
        return Buffer.allocUnsafe(size);
    };
    /* istanbul ignore next */
    newBufferFromBuffer = function newBufferFromBuffer(buf) {
        return Buffer.from(buf);
    };
} else {
    /* istanbul ignore next */
    newBufferFromSize = function(size) {
        return new Buffer(size);
    };
    /* istanbul ignore next */
    newBufferFromBuffer = function(buf) {
        return new Buffer(buf);
    };
}

function parseMacAddress(address) {
    var buffer = newBufferFromSize(6);
    buffer[0] = hex2byte[address[0] + address[1]];
    buffer[1] = hex2byte[address[3] + address[4]];
    buffer[2] = hex2byte[address[6] + address[7]];
    buffer[3] = hex2byte[address[9] + address[10]];
    buffer[4] = hex2byte[address[12] + address[13]];
    buffer[5] = hex2byte[address[15] + address[16]];
    return buffer;
}

// MAC address for v1 uuids
var macAddress = randomHost;
var macAddressLoaded = false;

function loadMacAddress() {
  require("macaddress").one(function (err, result) {
      if (!err) {
          macAddress = parseMacAddress(result);
      }
      macAddressLoaded = true;
  });
}

// UUID class
var UUID = function (uuid) {

    var check = UUID.check(uuid);
    if (!check) {
        throw "not a UUID";
    }

    this.version = check.version;
    this.variant = check.variant;

    this[check.format] = uuid;
};

UUID.prototype.toString = function () {
    if (!this.ascii) {
        this.ascii = UUID.stringify(this.binary);
    }
    return this.ascii;
};

UUID.prototype.toBuffer = function () {
    if (!this.binary) {
        this.binary = UUID.parse(this.ascii);
    }
    return newBufferFromBuffer(this.binary);
};

UUID.prototype.inspect = function () {
    return "UUID v" + this.version + " " + this.toString();
};

function error(message, callback) {
    if (callback) {
        callback(message, null);
    } else {
        throw new Error(message);
    }
}

// read stringified uuid into a Buffer
function parse(string) {

    var buffer = newBufferFromSize(16);
    var j = 0;
    for (var i = 0; i < 16; i++) {
        buffer[i] = hex2byte[string[j++] + string[j++]];
        if (i === 3 || i === 5 || i === 7 || i === 9) {
            j += 1;
        }
    }

    return buffer;
}

// according to rfc4122#section-4.1.1
function getVariant(bits) {
    switch (bits) {
        case 0: case 1: case 3:
            return "ncs";
        case 4: case 5:
            return "rfc4122";
        case 6:
            return "microsoft";
        default:
            return "future";
    }
}

function check(uuid, offset) {

    if (typeof uuid === "string") {
        uuid = uuid.toLowerCase();

        if (!/^[a-f0-9]{8}(\-[a-f0-9]{4}){3}\-([a-f0-9]{12})$/.test(uuid)) {
            return false;
        }

        if (uuid === "00000000-0000-0000-0000-000000000000") {
            return { version: undefined, variant: "nil", format: "ascii" };
        }

        return {
            version: (hex2byte[uuid[14] + uuid[15]] & 0xf0) >> 4,
            variant: getVariant((hex2byte[uuid[19] + uuid[20]] & 0xe0) >> 5),
            format: "ascii"
        };
    }

    if (uuid instanceof Buffer) {
        offset = offset || 0;

        if (uuid.length < offset + 16) {
            return false;
        }

        for (var i = 0; i < 16; i++) {
            if (uuid[offset + i] !== 0) {
                break;
            }
        }
        if (i === 16) {
            return { version: undefined, variant: "nil", format: "binary" };
        }

        return {
            version: (uuid[offset + 6] & 0xf0) >> 4,
            variant: getVariant((uuid[offset + 8] & 0xe0) >> 5),
            format: "binary"
        };
    }
}

// v1
function uuidTimeBased(nodeId, options, callback) {

    var mTime = Date.now();
    var nTime = lastNTime + 1;
    var delta = (mTime - lastMTime) + (nTime - lastNTime) / 10000;

    if (delta < 0) {
        clockSeq = (clockSeq + 1) & 0x3fff;
        nTime = 0;
    } else if (mTime > lastMTime) {
        nTime = 0;
    } else if (nTime >= 10000) {
        return moreThan10000;
    }

    lastMTime = mTime;
    lastNTime = nTime;

    // unix timestamp to gregorian epoch as per rfc4122#section-4.5
    mTime += 12219292800000;

    var buffer = newBufferFromSize(16);
    var myClockSeq = options.clockSeq === undefined ?
            clockSeq : (options.clockSeq & 0x3fff);
    var timeLow = ((mTime & 0xfffffff) * 10000 + nTime) % 0x100000000;
    var timeHigh = (mTime / 0x100000000 * 10000) & 0xfffffff;

    buffer[0] = timeLow >>> 24 & 0xff;
    buffer[1] = timeLow >>> 16 & 0xff;
    buffer[2] = timeLow >>> 8 & 0xff;
    buffer[3] = timeLow & 0xff;

    buffer[4] = timeHigh >>> 8 & 0xff;
    buffer[5] = timeHigh & 0xff;

    buffer[6] = (timeHigh >>> 24 & 0x0f) | 0x10;
    buffer[7] = (timeHigh >>> 16 & 0x3f) | 0x80;

    buffer[8] = myClockSeq >>> 8;
    buffer[9] = myClockSeq & 0xff;

    var result;
    switch (options.encoding && options.encoding[0]) {
        case "b":
        case "B":
            buffer[10] = nodeId[0];
            buffer[11] = nodeId[1];
            buffer[12] = nodeId[2];
            buffer[13] = nodeId[3];
            buffer[14] = nodeId[4];
            buffer[15] = nodeId[5];
            result = buffer;
            break;
        case "o":
        case "U":
            buffer[10] = nodeId[0];
            buffer[11] = nodeId[1];
            buffer[12] = nodeId[2];
            buffer[13] = nodeId[3];
            buffer[14] = nodeId[4];
            buffer[15] = nodeId[5];
            result = new UUID(buffer);
            break;
        default:
            result = byte2hex[buffer[0]] + byte2hex[buffer[1]] +
                     byte2hex[buffer[2]] + byte2hex[buffer[3]] + "-" +
                     byte2hex[buffer[4]] + byte2hex[buffer[5]] + "-" +
                     byte2hex[buffer[6]] + byte2hex[buffer[7]] + "-" +
                     byte2hex[buffer[8]] + byte2hex[buffer[9]] + "-" +
                     byte2hex[nodeId[0]] + byte2hex[nodeId[1]] +
                     byte2hex[nodeId[2]] + byte2hex[nodeId[3]] +
                     byte2hex[nodeId[4]] + byte2hex[nodeId[5]];
            break;
    }
    if (callback) {
        setImmediate(function () {
            callback(null, result);
        });
    }
    return result;
}

// v3 + v5
function uuidNamed(hashFunc, version, arg1, arg2) {

    var options = arg1 || {};
    var callback = typeof arg1 === "function" ? arg1 : arg2;

    var namespace = options.namespace;
    var name = options.name;

    var hash = crypto.createHash(hashFunc);

    if (typeof namespace === "string") {
        if (!check(namespace)) {
            return error(invalidNamespace, callback);
        }
        namespace = parse(namespace);
    } else if (namespace instanceof UUID) {
        namespace = namespace.toBuffer();
    } else if (!(namespace instanceof Buffer) || namespace.length !== 16) {
        return error(invalidNamespace, callback);
    }

    var nameIsNotAString = typeof name !== "string";
    if (nameIsNotAString && !(name instanceof Buffer)) {
        return error(invalidName, callback);
    }

    hash.update(namespace);
    hash.update(options.name, nameIsNotAString ? "binary" : "utf8");

    var buffer = hash.digest();

    var result;
    switch (options.encoding && options.encoding[0]) {
        case "b":
        case "B":
            buffer[6] = (buffer[6] & 0x0f) | version;
            buffer[8] = (buffer[8] & 0x3f) | 0x80;
            result = buffer;
            break;
        case "o":
        case "U":
            buffer[6] = (buffer[6] & 0x0f) | version;
            buffer[8] = (buffer[8] & 0x3f) | 0x80;
            result = new UUID(buffer);
            break;
        default:
            result = byte2hex[buffer[0]] + byte2hex[buffer[1]] +
                     byte2hex[buffer[2]] + byte2hex[buffer[3]] + "-" +
                     byte2hex[buffer[4]] + byte2hex[buffer[5]] + "-" +
                     byte2hex[(buffer[6] & 0x0f) | version] +
                     byte2hex[buffer[7]] + "-" +
                     byte2hex[(buffer[8] & 0x3f) | 0x80] +
                     byte2hex[buffer[9]] + "-" +
                     byte2hex[buffer[10]] + byte2hex[buffer[11]] +
                     byte2hex[buffer[12]] + byte2hex[buffer[13]] +
                     byte2hex[buffer[14]] + byte2hex[buffer[15]];
            break;
    }
    if (callback) {
        setImmediate(function () {
            callback(null, result);
        });
    } else {
        return result;
    }
}

// v4
function uuidRandom(arg1, arg2) {

    var options = arg1 || {};
    var callback = typeof arg1 === "function" ? arg1 : arg2;

    var buffer = crypto.randomBytes(16);

    buffer[6] = (buffer[6] & 0x0f) | 0x40;
    buffer[8] = (buffer[8] & 0x3f) | 0x80;

    var result;
    switch (options.encoding && options.encoding[0]) {
        case "b":
        case "B":
            result = buffer;
            break;
        case "o":
        case "U":
            result = new UUID(buffer);
            break;
        default:
            result = byte2hex[buffer[0]] + byte2hex[buffer[1]] +
                     byte2hex[buffer[2]] + byte2hex[buffer[3]] + "-" +
                     byte2hex[buffer[4]] + byte2hex[buffer[5]] + "-" +
                     byte2hex[(buffer[6] & 0x0f) | 0x40] +
                     byte2hex[buffer[7]] + "-" +
                     byte2hex[(buffer[8] & 0x3f) | 0x80] +
                     byte2hex[buffer[9]] + "-" +
                     byte2hex[buffer[10]] + byte2hex[buffer[11]] +
                     byte2hex[buffer[12]] + byte2hex[buffer[13]] +
                     byte2hex[buffer[14]] + byte2hex[buffer[15]];
            break;
    }
    if (callback) {
        setImmediate(function () {
            callback(null, result);
        });
    } else {
        return result;
    }
}

// v4 fast
function uuidRandomFast() {

    var r1 = Math.random() * 0x100000000;
    var r2 = Math.random() * 0x100000000;
    var r3 = Math.random() * 0x100000000;
    var r4 = Math.random() * 0x100000000;

    return byte2hex[ r1        & 0xff] +
           byte2hex[ r1 >>>  8 & 0xff] +
           byte2hex[ r1 >>> 16 & 0xff] +
           byte2hex[ r1 >>> 24 & 0xff] + "-" +
           byte2hex[ r2 & 0xff] +
           byte2hex[ r2 >>>  8 & 0xff] + "-" +
           byte2hex[(r2 >>> 16 & 0x0f) | 0x40] +
           byte2hex[ r2 >>> 24 & 0xff] + "-" +
           byte2hex[(r3 & 0x3f) | 0x80] +
           byte2hex[ r3 >>>  8 & 0xff] + "-" +
           byte2hex[ r3 >>> 16 & 0xff] +
           byte2hex[ r3 >>> 24 & 0xff] +
           byte2hex[ r4        & 0xff] +
           byte2hex[ r4 >>>  8 & 0xff] +
           byte2hex[ r4 >>> 16 & 0xff] +
           byte2hex[ r4 >>> 24 & 0xff];
}

function stringify(buffer) {
    return byte2hex[buffer[0]]  + byte2hex[buffer[1]]  +
           byte2hex[buffer[2]]  + byte2hex[buffer[3]]  + "-" +
           byte2hex[buffer[4]]  + byte2hex[buffer[5]]  + "-" +
           byte2hex[buffer[6]]  + byte2hex[buffer[7]]  + "-" +
           byte2hex[buffer[8]]  + byte2hex[buffer[9]]  + "-" +
           byte2hex[buffer[10]] + byte2hex[buffer[11]] +
           byte2hex[buffer[12]] + byte2hex[buffer[13]] +
           byte2hex[buffer[14]] + byte2hex[buffer[15]];
}

UUID.stringify = stringify;

UUID.parse = parse;

UUID.check = check;

// according to rfc4122#section-4.1.7
UUID.nil = new UUID("00000000-0000-0000-0000-000000000000");

// from rfc4122#appendix-C
UUID.namespace = {
    dns:  new UUID("6ba7b810-9dad-11d1-80b4-00c04fd430c8"),
    url:  new UUID("6ba7b811-9dad-11d1-80b4-00c04fd430c8"),
    oid:  new UUID("6ba7b812-9dad-11d1-80b4-00c04fd430c8"),
    x500: new UUID("6ba7b814-9dad-11d1-80b4-00c04fd430c8")
};

UUID.v1 = function v1(arg1, arg2) {

    var options = arg1 || {};
    var callback = typeof arg1 === "function" ? arg1 : arg2;

    var nodeId = options.mac;

    if (nodeId === undefined) {
        if(!macAddressLoaded) {
            loadMacAddress();
        }
        if (!macAddressLoaded && callback) {
            setImmediate(function () {
                UUID.v1(options, callback);
            });
            return;
        }
        return uuidTimeBased(macAddress, options, callback);
    }
    if (nodeId === false) {
        return uuidTimeBased(randomHost, options, callback);
    }
    return uuidTimeBased(parseMacAddress(nodeId), options, callback);
};

UUID.v4 = uuidRandom;

UUID.v4fast = uuidRandomFast;

UUID.v3 = function (options, callback) {
    return uuidNamed("md5", 0x30, options, callback);
};

UUID.v5 = function (options, callback) {
    return uuidNamed("sha1", 0x50, options, callback);
};

module.exports = UUID;