@baseworks/core 0.2.0

package/dist/chunk-PRA7F4WX.js

@@ -0,0 +1,36 @@
+// src/id.ts
+function generateId() {
+  const now = BigInt(Date.now());
+  const bytes = crypto.getRandomValues(new Uint8Array(16));
+  bytes[0] = Number(now >> 40n & 0xffn);
+  bytes[1] = Number(now >> 32n & 0xffn);
+  bytes[2] = Number(now >> 24n & 0xffn);
+  bytes[3] = Number(now >> 16n & 0xffn);
+  bytes[4] = Number(now >> 8n & 0xffn);
+  bytes[5] = Number(now & 0xffn);
+  bytes[6] = bytes[6] & 15 | 112;
+  bytes[8] = bytes[8] & 63 | 128;
+  const h = (s) => Array.from(s, (b) => b.toString(16).padStart(2, "0")).join("");
+  return [
+    h(bytes.slice(0, 4)),
+    h(bytes.slice(4, 6)),
+    h(bytes.slice(6, 8)),
+    h(bytes.slice(8, 10)),
+    h(bytes.slice(10))
+  ].join("-");
+}
+function generateSlug(name) {
+  return name.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-").slice(0, 48) || "untitled";
+}
+var SHORT_ID_ALPHABET = "bcdfghjkmnpqrstvwxyz2345678";
+var SHORT_ID_LENGTH = 6;
+function generateShortId() {
+  const bytes = crypto.getRandomValues(new Uint8Array(SHORT_ID_LENGTH));
+  return Array.from(bytes, (b) => SHORT_ID_ALPHABET[b % SHORT_ID_ALPHABET.length]).join("");
+}
+
+export {
+  generateId,
+  generateSlug,
+  generateShortId
+};

package/dist/id.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ID generation utilities.
+ * Runtime-agnostic — works in Cloudflare Workers, Node 20+, browser.
+ */
+declare function generateId(): string;
+declare function generateSlug(name: string): string;
+declare function generateShortId(): string;
+
+export { generateId, generateShortId, generateSlug };

package/dist/id.js

@@ -0,0 +1,10 @@
+import {
+  generateId,
+  generateShortId,
+  generateSlug
+} from "./chunk-PRA7F4WX.js";
+export {
+  generateId,
+  generateShortId,
+  generateSlug
+};

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { generateId, generateShortId, generateSlug } from './id.js';

package/dist/index.js

@@ -0,0 +1,10 @@
+import {
+  generateId,
+  generateShortId,
+  generateSlug
+} from "./chunk-PRA7F4WX.js";
+export {
+  generateId,
+  generateShortId,
+  generateSlug
+};

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@baseworks/core",
+  "version": "0.2.0",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./id": "./dist/id.js"
+  },
+  "files": ["dist", "src"],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@baseworks/tsconfig": "workspace:*",
+    "tsup": "^8.5.1",
+    "typescript": "^5.6.0"
+  }
+}

package/src/id.ts

@@ -0,0 +1,57 @@
+/**
+ * ID generation utilities.
+ * Runtime-agnostic — works in Cloudflare Workers, Node 20+, browser.
+ */
+
+// UUIDv7: 48-bit Unix ms timestamp prefix + random bits.
+// Time-sortable, DB-index friendly, RFC 9562 compliant.
+// Default for all primary keys unless a project overrides.
+export function generateId(): string {
+  const now   = BigInt(Date.now());
+  const bytes = crypto.getRandomValues(new Uint8Array(16));
+
+  bytes[0] = Number((now >> 40n) & 0xffn);
+  bytes[1] = Number((now >> 32n) & 0xffn);
+  bytes[2] = Number((now >> 24n) & 0xffn);
+  bytes[3] = Number((now >> 16n) & 0xffn);
+  bytes[4] = Number((now >> 8n)  & 0xffn);
+  bytes[5] = Number(now          & 0xffn);
+  bytes[6] = (bytes[6]! & 0x0f) | 0x70; // version 7
+  bytes[8] = (bytes[8]! & 0x3f) | 0x80; // variant 10xx
+
+  const h = (s: Uint8Array) =>
+    Array.from(s, (b: number) => b.toString(16).padStart(2, '0')).join('');
+
+  return [
+    h(bytes.slice(0, 4)),
+    h(bytes.slice(4, 6)),
+    h(bytes.slice(6, 8)),
+    h(bytes.slice(8, 10)),
+    h(bytes.slice(10)),
+  ].join('-');
+}
+
+// Converts a display name to a URL-safe slug.
+// e.g. "My Project 2" → "my-project-2"
+export function generateSlug(name: string): string {
+  return name
+    .toLowerCase()
+    .normalize('NFD')                        // decompose accented chars
+    .replace(/[̀-ͯ]/g, '')         // strip combining marks
+    .replace(/[^a-z0-9]+/g, '-')            // non-alphanumeric → dash
+    .replace(/^-+|-+$/g, '')               // trim leading/trailing dashes
+    .replace(/-{2,}/g, '-')                // collapse consecutive dashes
+    .slice(0, 48)                          // max length
+    || 'untitled';
+}
+
+// 6-char short ID for human-readable identifiers (slugs, labels, URL segments).
+// Alphabet: lowercase + digits, ambiguous chars removed (0, 1, i, l, o).
+// 27^6 ≈ 387M combinations — collision-safe for org/workspace/project counts.
+const SHORT_ID_ALPHABET = 'bcdfghjkmnpqrstvwxyz2345678';
+const SHORT_ID_LENGTH   = 6;
+
+export function generateShortId(): string {
+  const bytes = crypto.getRandomValues(new Uint8Array(SHORT_ID_LENGTH));
+  return Array.from(bytes, (b: number) => SHORT_ID_ALPHABET[b % SHORT_ID_ALPHABET.length]).join('');
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { generateId, generateShortId, generateSlug } from './id';