denoland-deno/std/uuid/v5.ts

// Copyright 2018-2021 the Deno authors. All rights reserved. MIT license.
import {
  bytesToUuid,
  createBuffer,
  stringToBytes,
  uuidToBytes,
} from "./_common.ts";
import { Sha1 } from "../hash/sha1.ts";
import { assert } from "../_util/assert.ts";

const UUID_RE =
  /^[0-9a-f]{8}-[0-9a-f]{4}-[5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;

/**
 * Validates the UUID v5
 * @param id UUID value
 */
export function validate(id: string): boolean {
  return UUID_RE.test(id);
}

interface V5Options {
  value: string | number[];
  namespace: string | number[];
}

/**
 * Generates a RFC4122 v5 UUID (SHA-1 namespace-based)
 * @param options Can use a namespace and value to create SHA-1 hash
 * @param buf Can allow the UUID to be written in byte-form starting at the offset
 * @param offset Index to start writing on the UUID bytes in buffer
 */
export function generate(
  options: V5Options,
  buf?: number[],
  offset?: number,
): string | number[] {
  const i = (buf && offset) || 0;

  let { value, namespace } = options;
  if (typeof value == "string") {
    value = stringToBytes(value as string);
  }

  if (typeof namespace == "string") {
    namespace = uuidToBytes(namespace as string);
  }

  assert(
    namespace.length === 16,
    "namespace must be uuid string or an Array of 16 byte values",
  );

  const content = (namespace as number[]).concat(value as number[]);
  const bytes = new Sha1().update(createBuffer(content)).digest();

  bytes[6] = (bytes[6] & 0x0f) | 0x50;
  bytes[8] = (bytes[8] & 0x3f) | 0x80;

  if (buf) {
    for (let idx = 0; idx < 16; ++idx) {
      buf[i + idx] = bytes[idx];
    }
  }

  return buf || bytesToUuid(bytes);
}