fantomid 1.0.2 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fantomid",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "type": "module",
   "description": "A tiny, universal ID generator compatible with JavaScript integers",
   "repository": "th3rius/fantomid",
@@ -16,6 +16,9 @@
     "build": "rimraf dist && pkgroll --sourcemap",
     "test": "node --test --experimental-test-module-mocks **/*.spec.js"
   },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
   "exports": {
     "require": {
       "types": "./dist/index.d.ts",

package/src/fantomid.js

@@ -0,0 +1,37 @@
+import { random } from "@lukeed/csprng";
+
+const EPOCH = new Date("2024-09-08");
+
+export function fantomid() {
+  const TIMESTAMP_LENGTH = 36;
+  const RANDOM_BITS_LENGTH = 17;
+  const TIMESTAMP_PRECISION_DIVIDER = 100;
+
+  const bits = new Array(TIMESTAMP_LENGTH + RANDOM_BITS_LENGTH);
+
+  // Generates a timestamp to be part of the key. This is
+  // inspired by how UUID v7 works: the idea is that this
+  // will guarantee keys are generated evenly across time.
+  const timestamp = Math.round(
+    // Use a more recent base date instead of the Unix Epoch to
+    // increase the amount of time we can represent in the timestamp.
+    (new Date() - EPOCH) /
+      // Decrease the precision of the timestamp to
+      // increase the amount of bits we can fit in a key.
+      TIMESTAMP_PRECISION_DIVIDER,
+  );
+  for (let i = 0; i < TIMESTAMP_LENGTH; i++) {
+    bits[TIMESTAMP_LENGTH + RANDOM_BITS_LENGTH - 1 - i] = (timestamp >> i) & 1;
+  }
+
+  // Generates a randomized part of the key. If multiple machines generate a
+  // key at the exact same time (limited by the precision of the timestamp),
+  // we are ensured to have a chance of collision of `1` in `2 ** RANDOM_BITS_LENGTH`.
+  const randomBytes = random(Math.ceil(RANDOM_BITS_LENGTH / 8));
+  for (let i = 0; i < RANDOM_BITS_LENGTH; i++) {
+    bits[RANDOM_BITS_LENGTH - 1 - i] =
+      (randomBytes[Math.floor(i / 8)] >> i % 8) & 1;
+  }
+
+  return Number("0b" + bits.reduce((id, bit) => id + bit, String()));
+}

package/src/index.js

@@ -0,0 +1,2 @@
+import { fantomid } from "./fantomid.js";
+export default fantomid;