@checkdigit/hash 2.0.0-PR.14-7f35 → 2.0.0-PR.14-ab03

package/SECURITY.md

@@ -0,0 +1,14 @@
+# Security Policy
+
+## Supported Versions
+
+These versions of @checkdigit/hash are currently being supported with security updates.
+
+| Version | Supported          |
+| ------- | ------------------ |
+| > 2.x   | :white_check_mark: |
+| < 2.0   | :x:                |
+
+## Reporting a Vulnerability
+
+Please create an issue at https://github.com/checkdigit/hash/issues

package/dist-cjs/hash.cjs

@@ -0,0 +1,46 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hash.ts
+var hash_exports = {};
+__export(hash_exports, {
+  HASH_NAMESPACE: () => HASH_NAMESPACE,
+  default: () => hash_default
+});
+module.exports = __toCommonJS(hash_exports);
+var import_node_crypto = require("node:crypto");
+var import_uuid_v5 = __toESM(require("./uuid-v5.cjs"));
+var HASH_NAMESPACE = "f25d4515-fea7-44c7-8baf-f3ca50865e66";
+function hash_default(value) {
+  return (0, import_uuid_v5.default)((0, import_node_crypto.createHash)("sha512").update(value).digest("base64"), HASH_NAMESPACE);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HASH_NAMESPACE
+});

package/dist-cjs/hash.d.ts

@@ -0,0 +1,5 @@
+export declare const HASH_NAMESPACE = "f25d4515-fea7-44c7-8baf-f3ca50865e66";
+/**
+ * @param value - a string to be hashed and converted into a derived uuid
+ */
+export default function (value: string): string;

package/dist-cjs/hash.spec.cjs

@@ -0,0 +1,49 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/hash.spec.ts
+var import_node_assert = require("node:assert");
+var import_uuid = require("uuid");
+var import_hash = __toESM(require("./hash.cjs"));
+describe("hash", () => {
+  it("returns a uuid derived from hash of value", () => {
+    const result1 = (0, import_hash.default)("string to be hashed into a uuid");
+    const result2 = (0, import_hash.default)("string to be hashed into a uuid");
+    import_node_assert.strict.ok((0, import_uuid.validate)(result1) && (0, import_uuid.validate)(result2));
+    import_node_assert.strict.equal(result1, result2);
+  });
+  it("hash always returns the same value", () => {
+    import_node_assert.strict.equal((0, import_hash.default)("Hello World!"), "74caf525-c85a-5a3c-9d53-bef0507c21e4");
+    import_node_assert.strict.equal((0, import_hash.default)("d1253ec1-14bc-4c56-8e09-4450ab4c8a55"), "14abff19-2c5f-5408-af3d-3c6526ebea73");
+    import_node_assert.strict.equal((0, import_hash.default)("R\xE5ma Ghant\xE5"), "8a28bfef-8fa2-52de-b9c5-1d5a6d7ba5fe");
+    import_node_assert.strict.equal(
+      // eslint-disable-next-line no-secrets/no-secrets
+      (0, import_hash.default)("/hYSjdEGQI0DaVHCR0vZq0KeF5JLys3jSNvU9EzBMKKlSsC97xFd3wr+nrhzHhp1"),
+      "7cb123ec-2c42-5a8a-b358-adf113ee088d"
+    );
+    import_node_assert.strict.equal((0, import_hash.default)("nfv8yFRghIJV6ffFr2dJGi1978GPnUuc7JVi2/FPqHE="), "e90938db-61fb-55b4-8ebe-4e1518e4fe97");
+    import_node_assert.strict.equal((0, import_hash.default)("5111111111111118"), "87e25c4b-c395-585e-9ecf-43d190f6e62f");
+    import_node_assert.strict.equal((0, import_hash.default)("https://checkdigit.com"), "2c391f52-ec24-5945-8c28-88f74d12b55d");
+  });
+});

package/dist-cjs/hash.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-cjs/index.cjs

@@ -0,0 +1,44 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  HASH_NAMESPACE: () => import_hash2.HASH_NAMESPACE,
+  default: () => import_hash.default,
+  hash: () => import_hash2.default
+});
+module.exports = __toCommonJS(src_exports);
+var import_hash = __toESM(require("./hash.cjs"));
+var import_hash2 = __toESM(require("./hash.cjs"));
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HASH_NAMESPACE,
+  hash
+});

package/dist-cjs/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './hash';
+export { default as hash, HASH_NAMESPACE } from './hash';

package/dist-cjs/uuid-v5.cjs

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/uuid-v5.ts
+var uuid_v5_exports = {};
+__export(uuid_v5_exports, {
+  default: () => uuid_v5_default
+});
+module.exports = __toCommonJS(uuid_v5_exports);
+var import_node_crypto = require("node:crypto");
+function parse(namespace) {
+  let value;
+  const intArray = new Uint8Array(16);
+  intArray[0] = (value = Number.parseInt(namespace.slice(0, 8), 16)) >>> 24;
+  intArray[1] = value >>> 16 & 255;
+  intArray[2] = value >>> 8 & 255;
+  intArray[3] = value & 255;
+  intArray[4] = (value = Number.parseInt(namespace.slice(9, 13), 16)) >>> 8;
+  intArray[5] = value & 255;
+  intArray[6] = (value = Number.parseInt(namespace.slice(14, 18), 16)) >>> 8;
+  intArray[7] = value & 255;
+  intArray[8] = (value = Number.parseInt(namespace.slice(19, 23), 16)) >>> 8;
+  intArray[9] = value & 255;
+  intArray[10] = (value = Number.parseInt(namespace.slice(24, 36), 16)) / 1099511627776 & 255;
+  intArray[11] = value / 4294967296 & 255;
+  intArray[12] = value >>> 24 & 255;
+  intArray[13] = value >>> 16 & 255;
+  intArray[14] = value >>> 8 & 255;
+  intArray[15] = value & 255;
+  return intArray;
+}
+function uuid_v5_default(value, namespace) {
+  const buffer = (0, import_node_crypto.createHash)("sha1").update(parse(namespace)).update(value).digest();
+  buffer[6] = (buffer[6] ?? 0) & 15 | 80;
+  buffer[8] = (buffer[8] ?? 0) & 63 | 128;
+  const hex = buffer.toString("hex", 0, 16);
+  return [hex.slice(0, 8), hex.slice(8, 12), hex.slice(12, 16), hex.slice(16, 20), hex.slice(20, 32)].join("-").toLowerCase();
+}

package/dist-cjs/uuid-v5.d.ts

@@ -0,0 +1 @@
+export default function (value: string, namespace: string): string;

package/dist-cjs/uuid-v5.spec.cjs

@@ -0,0 +1,74 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/uuid-v5.spec.ts
+var import_node_assert = require("node:assert");
+var import_uuid = require("uuid");
+var import_hash = require("./hash.cjs");
+var import_uuid_v5 = __toESM(require("./uuid-v5.cjs"));
+describe("uuidV5", () => {
+  it("uuidV5 result matches v5(https://github.com/uuidjs/uuid) result", () => {
+    import_node_assert.strict.equal((0, import_uuid_v5.default)("Hello World!", import_hash.HASH_NAMESPACE), (0, import_uuid.v5)("Hello World!", import_hash.HASH_NAMESPACE));
+    import_node_assert.strict.equal(
+      (0, import_uuid_v5.default)("d1253ec1-14bc-4c56-8e09-4450ab4c8a55", import_hash.HASH_NAMESPACE),
+      (0, import_uuid.v5)("d1253ec1-14bc-4c56-8e09-4450ab4c8a55", import_hash.HASH_NAMESPACE)
+    );
+    import_node_assert.strict.equal(
+      (0, import_uuid_v5.default)("d1253ec1-14bc-4c56-8e09-4450ab4c8a55/abc/xyz", import_hash.HASH_NAMESPACE),
+      (0, import_uuid.v5)("d1253ec1-14bc-4c56-8e09-4450ab4c8a55/abc/xyz", import_hash.HASH_NAMESPACE)
+    );
+    import_node_assert.strict.equal(
+      (0, import_uuid_v5.default)("d1253ec1-14bc-4c56-8e09-4450ab4c8a55-ABC", import_hash.HASH_NAMESPACE),
+      (0, import_uuid.v5)("d1253ec1-14bc-4c56-8e09-4450ab4c8a55-ABC", import_hash.HASH_NAMESPACE)
+    );
+    import_node_assert.strict.equal((0, import_uuid_v5.default)("R\xE5ma Ghant\xE5", import_hash.HASH_NAMESPACE), (0, import_uuid.v5)("R\xE5ma Ghant\xE5", import_hash.HASH_NAMESPACE));
+    import_node_assert.strict.equal(
+      // eslint-disable-next-line no-secrets/no-secrets
+      (0, import_uuid_v5.default)("/hYSjdEGQI0DaVHCR0vZq0KeF5JLys3jSNvU9EzBMKKlSsC97xFd3wr+nrhzHhp1", import_hash.HASH_NAMESPACE),
+      // eslint-disable-next-line no-secrets/no-secrets
+      (0, import_uuid.v5)("/hYSjdEGQI0DaVHCR0vZq0KeF5JLys3jSNvU9EzBMKKlSsC97xFd3wr+nrhzHhp1", import_hash.HASH_NAMESPACE)
+    );
+    import_node_assert.strict.equal(
+      // eslint-disable-next-line no-secrets/no-secrets
+      (0, import_uuid_v5.default)("nfv8yFRghIJV6ffFr2dJGi1978GPnUuc7JVi2/FPqHE=", import_hash.HASH_NAMESPACE),
+      // eslint-disable-next-line no-secrets/no-secrets
+      (0, import_uuid.v5)("nfv8yFRghIJV6ffFr2dJGi1978GPnUuc7JVi2/FPqHE=", import_hash.HASH_NAMESPACE)
+    );
+    import_node_assert.strict.equal((0, import_uuid_v5.default)("5111111111111118", import_hash.HASH_NAMESPACE), (0, import_uuid.v5)("5111111111111118", import_hash.HASH_NAMESPACE));
+    import_node_assert.strict.equal((0, import_uuid_v5.default)("https://checkdigit.com", import_hash.HASH_NAMESPACE), (0, import_uuid.v5)("https://checkdigit.com", import_hash.HASH_NAMESPACE));
+  });
+  it("v5 - from https://github.com/uuidjs/uuid testing", () => {
+    import_node_assert.strict.equal((0, import_uuid_v5.default)("hello.example.com", import_uuid.v5.DNS), "fdda765f-fc57-5604-a269-52a7df8164ec");
+    import_node_assert.strict.equal((0, import_uuid_v5.default)("http://example.com/hello", import_uuid.v5.URL), "3bbcee75-cecc-5b56-8031-b6641c1ed1f1");
+    import_node_assert.strict.equal((0, import_uuid_v5.default)("hello", "0f5abcd1-c194-47f3-905b-2df7263a084b"), "90123e1c-7512-523e-bb28-76fab9f2f73d");
+  });
+  it("v5 namespace.toUpperCase - from https://github.com/uuidjs/uuid testing", () => {
+    import_node_assert.strict.equal((0, import_uuid_v5.default)("hello.example.com", import_uuid.v5.DNS.toUpperCase()), "fdda765f-fc57-5604-a269-52a7df8164ec");
+    import_node_assert.strict.equal((0, import_uuid_v5.default)("http://example.com/hello", import_uuid.v5.URL.toUpperCase()), "3bbcee75-cecc-5b56-8031-b6641c1ed1f1");
+    import_node_assert.strict.equal(
+      (0, import_uuid_v5.default)("hello", "0f5abcd1-c194-47f3-905b-2df7263a084b".toUpperCase()),
+      "90123e1c-7512-523e-bb28-76fab9f2f73d"
+    );
+  });
+});

package/dist-cjs/uuid-v5.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-mjs/hash.d.ts

@@ -0,0 +1,5 @@
+export declare const HASH_NAMESPACE = "f25d4515-fea7-44c7-8baf-f3ca50865e66";
+/**
+ * @param value - a string to be hashed and converted into a derived uuid
+ */
+export default function (value: string): string;

package/dist-mjs/hash.mjs

@@ -0,0 +1,11 @@
+// src/hash.ts
+import { createHash } from "node:crypto";
+import uuidV5 from "./uuid-v5.mjs";
+var HASH_NAMESPACE = "f25d4515-fea7-44c7-8baf-f3ca50865e66";
+function hash_default(value) {
+  return uuidV5(createHash("sha512").update(value).digest("base64"), HASH_NAMESPACE);
+}
+export {
+  HASH_NAMESPACE,
+  hash_default as default
+};

package/dist-mjs/hash.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-mjs/hash.spec.mjs

@@ -0,0 +1,25 @@
+// src/hash.spec.ts
+import { strict as assert } from "node:assert";
+import { validate } from "uuid";
+import hash from "./hash.mjs";
+describe("hash", () => {
+  it("returns a uuid derived from hash of value", () => {
+    const result1 = hash("string to be hashed into a uuid");
+    const result2 = hash("string to be hashed into a uuid");
+    assert.ok(validate(result1) && validate(result2));
+    assert.equal(result1, result2);
+  });
+  it("hash always returns the same value", () => {
+    assert.equal(hash("Hello World!"), "74caf525-c85a-5a3c-9d53-bef0507c21e4");
+    assert.equal(hash("d1253ec1-14bc-4c56-8e09-4450ab4c8a55"), "14abff19-2c5f-5408-af3d-3c6526ebea73");
+    assert.equal(hash("R\xE5ma Ghant\xE5"), "8a28bfef-8fa2-52de-b9c5-1d5a6d7ba5fe");
+    assert.equal(
+      // eslint-disable-next-line no-secrets/no-secrets
+      hash("/hYSjdEGQI0DaVHCR0vZq0KeF5JLys3jSNvU9EzBMKKlSsC97xFd3wr+nrhzHhp1"),
+      "7cb123ec-2c42-5a8a-b358-adf113ee088d"
+    );
+    assert.equal(hash("nfv8yFRghIJV6ffFr2dJGi1978GPnUuc7JVi2/FPqHE="), "e90938db-61fb-55b4-8ebe-4e1518e4fe97");
+    assert.equal(hash("5111111111111118"), "87e25c4b-c395-585e-9ecf-43d190f6e62f");
+    assert.equal(hash("https://checkdigit.com"), "2c391f52-ec24-5945-8c28-88f74d12b55d");
+  });
+});

package/dist-mjs/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './hash';
+export { default as hash, HASH_NAMESPACE } from './hash';

package/dist-mjs/index.mjs

@@ -0,0 +1,8 @@
+// src/index.ts
+import { default as default2 } from "./hash.mjs";
+import { default as default3, HASH_NAMESPACE } from "./hash.mjs";
+export {
+  HASH_NAMESPACE,
+  default2 as default,
+  default3 as hash
+};

package/dist-mjs/uuid-v5.d.ts

@@ -0,0 +1 @@
+export default function (value: string, namespace: string): string;

package/dist-mjs/uuid-v5.mjs

@@ -0,0 +1,33 @@
+// src/uuid-v5.ts
+import { createHash } from "node:crypto";
+function parse(namespace) {
+  let value;
+  const intArray = new Uint8Array(16);
+  intArray[0] = (value = Number.parseInt(namespace.slice(0, 8), 16)) >>> 24;
+  intArray[1] = value >>> 16 & 255;
+  intArray[2] = value >>> 8 & 255;
+  intArray[3] = value & 255;
+  intArray[4] = (value = Number.parseInt(namespace.slice(9, 13), 16)) >>> 8;
+  intArray[5] = value & 255;
+  intArray[6] = (value = Number.parseInt(namespace.slice(14, 18), 16)) >>> 8;
+  intArray[7] = value & 255;
+  intArray[8] = (value = Number.parseInt(namespace.slice(19, 23), 16)) >>> 8;
+  intArray[9] = value & 255;
+  intArray[10] = (value = Number.parseInt(namespace.slice(24, 36), 16)) / 1099511627776 & 255;
+  intArray[11] = value / 4294967296 & 255;
+  intArray[12] = value >>> 24 & 255;
+  intArray[13] = value >>> 16 & 255;
+  intArray[14] = value >>> 8 & 255;
+  intArray[15] = value & 255;
+  return intArray;
+}
+function uuid_v5_default(value, namespace) {
+  const buffer = createHash("sha1").update(parse(namespace)).update(value).digest();
+  buffer[6] = (buffer[6] ?? 0) & 15 | 80;
+  buffer[8] = (buffer[8] ?? 0) & 63 | 128;
+  const hex = buffer.toString("hex", 0, 16);
+  return [hex.slice(0, 8), hex.slice(8, 12), hex.slice(12, 16), hex.slice(16, 20), hex.slice(20, 32)].join("-").toLowerCase();
+}
+export {
+  uuid_v5_default as default
+};

package/dist-mjs/uuid-v5.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-mjs/uuid-v5.spec.mjs

@@ -0,0 +1,50 @@
+// src/uuid-v5.spec.ts
+import { strict as assert } from "node:assert";
+import { v5 } from "uuid";
+import { HASH_NAMESPACE } from "./hash.mjs";
+import uuidV5 from "./uuid-v5.mjs";
+describe("uuidV5", () => {
+  it("uuidV5 result matches v5(https://github.com/uuidjs/uuid) result", () => {
+    assert.equal(uuidV5("Hello World!", HASH_NAMESPACE), v5("Hello World!", HASH_NAMESPACE));
+    assert.equal(
+      uuidV5("d1253ec1-14bc-4c56-8e09-4450ab4c8a55", HASH_NAMESPACE),
+      v5("d1253ec1-14bc-4c56-8e09-4450ab4c8a55", HASH_NAMESPACE)
+    );
+    assert.equal(
+      uuidV5("d1253ec1-14bc-4c56-8e09-4450ab4c8a55/abc/xyz", HASH_NAMESPACE),
+      v5("d1253ec1-14bc-4c56-8e09-4450ab4c8a55/abc/xyz", HASH_NAMESPACE)
+    );
+    assert.equal(
+      uuidV5("d1253ec1-14bc-4c56-8e09-4450ab4c8a55-ABC", HASH_NAMESPACE),
+      v5("d1253ec1-14bc-4c56-8e09-4450ab4c8a55-ABC", HASH_NAMESPACE)
+    );
+    assert.equal(uuidV5("R\xE5ma Ghant\xE5", HASH_NAMESPACE), v5("R\xE5ma Ghant\xE5", HASH_NAMESPACE));
+    assert.equal(
+      // eslint-disable-next-line no-secrets/no-secrets
+      uuidV5("/hYSjdEGQI0DaVHCR0vZq0KeF5JLys3jSNvU9EzBMKKlSsC97xFd3wr+nrhzHhp1", HASH_NAMESPACE),
+      // eslint-disable-next-line no-secrets/no-secrets
+      v5("/hYSjdEGQI0DaVHCR0vZq0KeF5JLys3jSNvU9EzBMKKlSsC97xFd3wr+nrhzHhp1", HASH_NAMESPACE)
+    );
+    assert.equal(
+      // eslint-disable-next-line no-secrets/no-secrets
+      uuidV5("nfv8yFRghIJV6ffFr2dJGi1978GPnUuc7JVi2/FPqHE=", HASH_NAMESPACE),
+      // eslint-disable-next-line no-secrets/no-secrets
+      v5("nfv8yFRghIJV6ffFr2dJGi1978GPnUuc7JVi2/FPqHE=", HASH_NAMESPACE)
+    );
+    assert.equal(uuidV5("5111111111111118", HASH_NAMESPACE), v5("5111111111111118", HASH_NAMESPACE));
+    assert.equal(uuidV5("https://checkdigit.com", HASH_NAMESPACE), v5("https://checkdigit.com", HASH_NAMESPACE));
+  });
+  it("v5 - from https://github.com/uuidjs/uuid testing", () => {
+    assert.equal(uuidV5("hello.example.com", v5.DNS), "fdda765f-fc57-5604-a269-52a7df8164ec");
+    assert.equal(uuidV5("http://example.com/hello", v5.URL), "3bbcee75-cecc-5b56-8031-b6641c1ed1f1");
+    assert.equal(uuidV5("hello", "0f5abcd1-c194-47f3-905b-2df7263a084b"), "90123e1c-7512-523e-bb28-76fab9f2f73d");
+  });
+  it("v5 namespace.toUpperCase - from https://github.com/uuidjs/uuid testing", () => {
+    assert.equal(uuidV5("hello.example.com", v5.DNS.toUpperCase()), "fdda765f-fc57-5604-a269-52a7df8164ec");
+    assert.equal(uuidV5("http://example.com/hello", v5.URL.toUpperCase()), "3bbcee75-cecc-5b56-8031-b6641c1ed1f1");
+    assert.equal(
+      uuidV5("hello", "0f5abcd1-c194-47f3-905b-2df7263a084b".toUpperCase()),
+      "90123e1c-7512-523e-bb28-76fab9f2f73d"
+    );
+  });
+});

package/package.json

@@ -1 +1 @@
-{"name":"@checkdigit/hash","version":"2.0.0-PR.14-7f35","description":"Hash is a small function for Check Digit services to create a uuid derived from a hash generated from a given value.","typings":"./dist/index.d.ts","main":"./dist/index.js","files":["index.js","/src/"],"prettier":"@checkdigit/prettier-config","engines":{"node":">=16"},"repository":{"type":"git","url":"git+https://github.com/checkdigit/hash.git"},"author":"Check Digit, LLC","license":"MIT","bugs":{"url":"https://github.com/checkdigit/hash/issues"},"homepage":"https://github.com/checkdigit/hash#readme","devDependencies":{"@checkdigit/eslint-config":"^7.8.0","@checkdigit/jest-config":"^2.2.1","@checkdigit/prettier-config":"^3.4.0","@checkdigit/typescript-config":"^3.4.0","@types/uuid":"^9.0.1","rimraf":"^5.0.1","uuid":"^9.0.0"},"eslintConfig":{"extends":["@checkdigit/eslint-config"]},"jest":{"preset":"@checkdigit/jest-config"},"scripts":{"prettier":"prettier --ignore-path .gitignore --list-different .","prettier:fix":"prettier --ignore-path .gitignore --write .","lint:fix":"eslint -f unix --ext .ts,.mts src --fix","lint":"eslint -f unix --ext .ts,.mts src","test":"npm run ci:compile && npm run ci:test && npm run ci:lint && npm run ci:style","ci:compile":"tsc --noEmit","ci:test":"jest --coverage=false","ci:coverage":"jest --coverage=true","ci:lint":"npm run lint","ci:style":"npm run prettier"}}
+{"name":"@checkdigit/hash","version":"2.0.0-PR.14-ab03","description":"Hash is a small function for Check Digit services to create a uuid derived from a hash generated from a given value.","exports":{".":{"types":"./build-mjs/index.d.ts","require":"./dist-cjs/index.cjs","import":"./dist-mjs/index.mjs","default":"./dist-mjs/index.mjs"}},"files":["dist-cjs","dist-mjs","SECURITY.md","/src/"],"prettier":"@checkdigit/prettier-config","engines":{"node":">=16"},"repository":{"type":"git","url":"git+https://github.com/checkdigit/hash.git"},"author":"Check Digit, LLC","license":"MIT","bugs":{"url":"https://github.com/checkdigit/hash/issues"},"homepage":"https://github.com/checkdigit/hash#readme","devDependencies":{"@checkdigit/eslint-config":"^7.8.0","@checkdigit/jest-config":"^2.2.1","@checkdigit/prettier-config":"^3.4.0","@checkdigit/typescript-config":"^3.4.0","@types/uuid":"^9.0.1","rimraf":"^5.0.1","uuid":"^9.0.0"},"eslintConfig":{"extends":["@checkdigit/eslint-config"]},"jest":{"preset":"@checkdigit/jest-config"},"scripts":{"prepublishOnly":"npm run build:dist-cjs && npm run build:dist-esm && rimraf .github tsconfig.json","build:dist-cjs":"rimraf dist-cjs && npx builder --type=commonjs --outDir=dist-cjs","build:dist-esm":"rimraf dist-esm && npx builder --type=module --outDir=dist-mjs","prettier":"prettier --ignore-path .gitignore --list-different .","prettier:fix":"prettier --ignore-path .gitignore --write .","lint:fix":"eslint -f unix --ext .ts,.mts src --fix","lint":"eslint -f unix --ext .ts,.mts src","test":"npm run ci:compile && npm run ci:test && npm run ci:lint && npm run ci:style","ci:compile":"tsc --noEmit","ci:test":"jest --coverage=false","ci:coverage":"jest --coverage=true","ci:lint":"npm run lint","ci:style":"npm run prettier"}}

package/src/hash.spec.ts

@@ -0,0 +1,37 @@
+// hash.spec.ts
+
+/*
+ * Copyright (c) 2021-2023 Check Digit, LLC
+ *
+ * This code is licensed under the MIT license (see LICENSE.txt for details).
+ */
+
+import { strict as assert } from 'node:assert';
+import { validate } from 'uuid';
+
+import hash from './hash';
+
+describe('hash', () => {
+  it('returns a uuid derived from hash of value', () => {
+    const result1 = hash('string to be hashed into a uuid');
+    const result2 = hash('string to be hashed into a uuid');
+    assert.ok(validate(result1) && validate(result2));
+    assert.equal(result1, result2);
+  });
+
+  it('hash always returns the same value', () => {
+    assert.equal(hash('Hello World!'), '74caf525-c85a-5a3c-9d53-bef0507c21e4');
+    assert.equal(hash('d1253ec1-14bc-4c56-8e09-4450ab4c8a55'), '14abff19-2c5f-5408-af3d-3c6526ebea73');
+    assert.equal(hash('Råma Ghantå'), '8a28bfef-8fa2-52de-b9c5-1d5a6d7ba5fe');
+    assert.equal(
+      // eslint-disable-next-line no-secrets/no-secrets
+      hash('/hYSjdEGQI0DaVHCR0vZq0KeF5JLys3jSNvU9EzBMKKlSsC97xFd3wr+nrhzHhp1'),
+      '7cb123ec-2c42-5a8a-b358-adf113ee088d'
+    );
+    // eslint-disable-next-line no-secrets/no-secrets
+    assert.equal(hash('nfv8yFRghIJV6ffFr2dJGi1978GPnUuc7JVi2/FPqHE='), 'e90938db-61fb-55b4-8ebe-4e1518e4fe97');
+    // eslint-disable-next-line @checkdigit/no-card-numbers
+    assert.equal(hash('5111111111111118'), '87e25c4b-c395-585e-9ecf-43d190f6e62f');
+    assert.equal(hash('https://checkdigit.com'), '2c391f52-ec24-5945-8c28-88f74d12b55d');
+  });
+});

package/src/uuid-v5.spec.ts

@@ -0,0 +1,66 @@
+// uuid-v5.spec.ts
+
+/*
+ * Copyright (c) 2021-2023 Check Digit, LLC
+ *
+ * This code is licensed under the MIT license (see LICENSE.txt for details).
+ */
+
+import { strict as assert } from 'node:assert';
+import { v5 } from 'uuid';
+
+import { HASH_NAMESPACE } from './hash';
+import uuidV5 from './uuid-v5';
+
+describe('uuidV5', () => {
+  it('uuidV5 result matches v5(https://github.com/uuidjs/uuid) result', () => {
+    assert.equal(uuidV5('Hello World!', HASH_NAMESPACE), v5('Hello World!', HASH_NAMESPACE));
+    assert.equal(
+      uuidV5('d1253ec1-14bc-4c56-8e09-4450ab4c8a55', HASH_NAMESPACE),
+      v5('d1253ec1-14bc-4c56-8e09-4450ab4c8a55', HASH_NAMESPACE)
+    );
+    assert.equal(
+      uuidV5('d1253ec1-14bc-4c56-8e09-4450ab4c8a55/abc/xyz', HASH_NAMESPACE),
+      v5('d1253ec1-14bc-4c56-8e09-4450ab4c8a55/abc/xyz', HASH_NAMESPACE)
+    );
+    assert.equal(
+      uuidV5('d1253ec1-14bc-4c56-8e09-4450ab4c8a55-ABC', HASH_NAMESPACE),
+      v5('d1253ec1-14bc-4c56-8e09-4450ab4c8a55-ABC', HASH_NAMESPACE)
+    );
+    assert.equal(uuidV5('Råma Ghantå', HASH_NAMESPACE), v5('Råma Ghantå', HASH_NAMESPACE));
+    assert.equal(
+      // eslint-disable-next-line no-secrets/no-secrets
+      uuidV5('/hYSjdEGQI0DaVHCR0vZq0KeF5JLys3jSNvU9EzBMKKlSsC97xFd3wr+nrhzHhp1', HASH_NAMESPACE),
+      // eslint-disable-next-line no-secrets/no-secrets
+      v5('/hYSjdEGQI0DaVHCR0vZq0KeF5JLys3jSNvU9EzBMKKlSsC97xFd3wr+nrhzHhp1', HASH_NAMESPACE)
+    );
+    assert.equal(
+      // eslint-disable-next-line no-secrets/no-secrets
+      uuidV5('nfv8yFRghIJV6ffFr2dJGi1978GPnUuc7JVi2/FPqHE=', HASH_NAMESPACE),
+      // eslint-disable-next-line no-secrets/no-secrets
+      v5('nfv8yFRghIJV6ffFr2dJGi1978GPnUuc7JVi2/FPqHE=', HASH_NAMESPACE)
+    );
+    // eslint-disable-next-line @checkdigit/no-card-numbers
+    assert.equal(uuidV5('5111111111111118', HASH_NAMESPACE), v5('5111111111111118', HASH_NAMESPACE));
+    assert.equal(uuidV5('https://checkdigit.com', HASH_NAMESPACE), v5('https://checkdigit.com', HASH_NAMESPACE));
+  });
+
+  it('v5 - from https://github.com/uuidjs/uuid testing', () => {
+    assert.equal(uuidV5('hello.example.com', v5.DNS), 'fdda765f-fc57-5604-a269-52a7df8164ec');
+
+    assert.equal(uuidV5('http://example.com/hello', v5.URL), '3bbcee75-cecc-5b56-8031-b6641c1ed1f1');
+
+    assert.equal(uuidV5('hello', '0f5abcd1-c194-47f3-905b-2df7263a084b'), '90123e1c-7512-523e-bb28-76fab9f2f73d');
+  });
+
+  it('v5 namespace.toUpperCase - from https://github.com/uuidjs/uuid testing', () => {
+    assert.equal(uuidV5('hello.example.com', v5.DNS.toUpperCase()), 'fdda765f-fc57-5604-a269-52a7df8164ec');
+
+    assert.equal(uuidV5('http://example.com/hello', v5.URL.toUpperCase()), '3bbcee75-cecc-5b56-8031-b6641c1ed1f1');
+
+    assert.equal(
+      uuidV5('hello', '0f5abcd1-c194-47f3-905b-2df7263a084b'.toUpperCase()),
+      '90123e1c-7512-523e-bb28-76fab9f2f73d'
+    );
+  });
+});