bun-types 1.1.34-canary.20241028T140532 → 1.1.34-canary.20241030T140557

package/bun.d.ts

@@ -5687,6 +5687,57 @@ declare module "bun" {
 		 */
 		match(str: string): boolean;
 	}
+
+	/**
+	 * Generate a UUIDv7, which is a sequential ID based on the current timestamp with a random component.
+	 *
+	 * When the same timestamp is used multiple times, a monotonically increasing
+	 * counter is appended to allow sorting. The final 8 bytes are
+	 * cryptographically random. When the timestamp changes, the counter resets to
+	 * a psuedo-random integer.
+	 *
+	 * @param encoding "hex" | "base64" | "base64url"
+	 * @param timestamp Unix timestamp in milliseconds, defaults to `Date.now()`
+	 *
+	 * @example
+	 * ```js
+	 * import { randomUUIDv7 } from "bun";
+	 * const array = [
+	 *   randomUUIDv7(),
+	 *   randomUUIDv7(),
+	 *   randomUUIDv7(),
+	 * ]
+	 * [
+	 *   "0192ce07-8c4f-7d66-afec-2482b5c9b03c",
+	 *   "0192ce07-8c4f-7d67-805f-0f71581b5622",
+	 *   "0192ce07-8c4f-7d68-8170-6816e4451a58"
+	 * ]
+	 * ```
+	 */
+	function randomUUIDv7(
+		/**
+		 * @default "hex"
+		 */
+		encoding?: "hex" | "base64" | "base64url",
+		/**
+		 * @default Date.now()
+		 */
+		timestamp?: number | Date,
+	): string;
+
+	/**
+	 * Generate a UUIDv7 as a Buffer
+	 *
+	 * @param encoding "buffer"
+	 * @param timestamp Unix timestamp in milliseconds, defaults to `Date.now()`
+	 */
+	function randomUUIDv7(
+		encoding: "buffer",
+		/**
+		 * @default Date.now()
+		 */
+		timestamp?: number | Date,
+	): Buffer;
 }
 
 // extends lib.dom.d.ts

package/package.json

@@ -1,5 +1,5 @@
 {
-	"version": "1.1.34-canary.20241028T140532",
+	"version": "1.1.34-canary.20241030T140557",
 	"name": "bun-types",
 	"license": "MIT",
 	"main": "",