generate-uuid-version 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Troy Tessalone
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# generate-uuid-version
+
+Generate UUID values (v1, v3, v4, v5, v6, v7) with simple controls.
+
+---
+
+## Install
+
+```bash
+npm install generate-uuid-version
+```
+
+---
+
+## Usage
+
+```js
+import { generateUUID } from "generate-uuid-version";
+
+const result = generateUUID({
+  count: 3,
+  version: "v7"
+});
+
+console.log(result);
+```
+
+---
+
+## Output
+
+```json
+{
+  "count": 3,
+  "version": "v7",
+  "position": {
+    "first": "uuid-1",
+    "last": "uuid-3"
+  },
+  "list": ["uuid-1", "uuid-2", "uuid-3"]
+}
+```
+
+---
+
+## Options
+
+| Field | Type | Required | Default | Description |
+|------|------|----------|--------|------------|
+| count | number | No | 1 | Number of UUIDs to generate (min 1, max 10) |
+| version | string | No | v7 | UUID version: v1, v3, v4, v5, v6, v7 |
+| name | string | No* | - | Required for v3 and v5 |
+| namespace | string | No* | - | Required for v3 and v5 |
+
+\* `name` and `namespace` are required when using `v3` or `v5`
+
+---
+
+## Examples
+
+### v4 (random)
+```js
+generateUUID({ count: 2, version: "v4" });
+```
+
+### v7 (time-based, recommended)
+```js
+generateUUID({ count: 2, version: "v7" });
+```
+
+### v5 (deterministic)
+```js
+generateUUID({
+  count: 1,
+  version: "v5",
+  name: "example.com",
+  namespace: "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
+});
+```
+
+---
+
+## Supported Versions
+
+- v1 → timestamp-based  
+- v3 → deterministic (MD5)  
+- v4 → random  
+- v5 → deterministic (SHA-1)  
+- v6 → reordered timestamp  
+- v7 → modern time-based (recommended)  
+
+---
+
+## Zapier Usage
+
+If using in a Zapier Code step, add:
+
+- generate-uuid-version  
+- uuid@10  
+
+---
+
+## Behavior
+
+- Invalid or missing `count` defaults to 1  
+- Maximum `count` is 10  
+- Invalid `version` defaults to v7  
+- v3 and v5 require `name` and `namespace`  
+
+---
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,91 @@
+// /index.js
+
+import {
+  v1 as uuidv1,
+  v3 as uuidv3,
+  v4 as uuidv4,
+  v5 as uuidv5,
+  v6 as uuidv6,
+  v7 as uuidv7
+} from "uuid";
+
+/**
+ * Generate UUID values
+ * @param {Object} options
+ * @param {number} options.count - number of UUIDs (min 1, max 10)
+ * @param {string} options.version - "v1","v3","v4","v5","v6","v7"
+ * @param {string} [options.name] - required for v3/v5
+ * @param {string} [options.namespace] - required for v3/v5
+ * @returns {Object}
+ */
+export function generateUUID({
+  count = 1,
+  version = "v7",
+  name,
+  namespace
+} = {}) {
+  // ===============================
+  // VALIDATE COUNT
+  // ===============================
+  let safeCount = Number(count);
+  if (isNaN(safeCount) || safeCount < 1) safeCount = 1;
+  if (safeCount > 10) safeCount = 10;
+
+  // ===============================
+  // NORMALIZE VERSION
+  // ===============================
+  const normalizedVersion = String(version || "v7").toLowerCase();
+
+  const allowedVersions = ["v1", "v3", "v4", "v5", "v6", "v7"];
+  const finalVersion = allowedVersions.includes(normalizedVersion)
+    ? normalizedVersion
+    : "v7";
+
+  // ===============================
+  // GENERATOR MAP
+  // ===============================
+  const generators = {
+    v1: () => uuidv1(),
+
+    v3: () => {
+      if (!name || !namespace) {
+        throw new Error("v3 requires 'name' and 'namespace'");
+      }
+      return uuidv3(name, namespace);
+    },
+
+    v4: () => uuidv4(),
+
+    v5: () => {
+      if (!name || !namespace) {
+        throw new Error("v5 requires 'name' and 'namespace'");
+      }
+      return uuidv5(name, namespace);
+    },
+
+    v6: () => uuidv6(),
+
+    v7: () => uuidv7()
+  };
+
+  const generator = generators[finalVersion];
+
+  // ===============================
+  // GENERATE UUIDS
+  // ===============================
+  const list = [];
+
+  for (let i = 0; i < safeCount; i++) {
+    list.push(generator());
+  }
+
+  return {
+    count: safeCount,
+    version: finalVersion,
+    position: {
+      first: list[0] || null,
+      last: list[list.length - 1] || null
+    },
+    list
+  };
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "generate-uuid-version",
+  "version": "1.0.0",
+  "description": "Generate UUID values (v1, v3, v4, v5, v6, v7) with count support.",
+  "type": "module",
+
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+
+  "files": [
+    "index.js"
+  ],
+
+  "engines": {
+    "node": ">=16"
+  },
+
+  "scripts": {
+    "test": "node index.js"
+  },
+
+  "dependencies": {
+    "uuid": "^10.0.0"
+  },
+
+  "keywords": [
+    "uuid",
+    "uuidv1",
+    "uuidv3",
+    "uuidv4",
+    "uuidv5",
+    "uuidv6",
+    "uuidv7",
+    "generator",
+    "utility"
+  ],
+
+  "author": "Troy Tessalone",
+  "license": "MIT",
+
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/troytessalone/generate-uuid-version.git"
+  },
+  "bugs": {
+    "url": "https://github.com/troytessalone/generate-uuid-version/issues"
+  },
+  "homepage": "https://github.com/troytessalone/generate-uuid-version#readme"
+}