@typed/id 0.15.0 → 0.17.0

package/dist/Cuid.d.ts

@@ -0,0 +1,27 @@
+import { Effect, Layer, Schema } from 'effect';
+import { DateTimes } from './DateTimes.js';
+import { GetRandomValues } from './GetRandomValues.js';
+export declare const Cuid: Schema.brand<Schema.filter<Schema.Schema<string, string, never>>, "@typed/id/CUID">;
+export type Cuid = Schema.Schema.Type<typeof Cuid>;
+export declare const isCuid: (value: string) => value is Cuid;
+export type CuidSeed = {
+    readonly timestamp: number;
+    readonly counter: number;
+    readonly random: Uint8Array;
+    readonly fingerprint: string;
+};
+declare const CuidState_base: import("effect/Context").TagClass<CuidState, "CuidState", {
+    readonly next: Effect.Effect<CuidSeed>;
+}> & Effect.Tag.Proxy<CuidState, {
+    readonly next: Effect.Effect<CuidSeed>;
+}> & {
+    use: <X>(body: (_: {
+        readonly next: Effect.Effect<CuidSeed>;
+    }) => X) => [X] extends [Effect.Effect<infer A, infer E, infer R>] ? Effect.Effect<A, E, R | CuidState> : [X] extends [PromiseLike<infer A_1>] ? Effect.Effect<A_1, import("effect/Cause").UnknownException, CuidState> : Effect.Effect<X, never, CuidState>;
+};
+export declare class CuidState extends CuidState_base {
+    static readonly layer: (envData: string) => Layer.Layer<CuidState, never, DateTimes | GetRandomValues>;
+    static readonly Default: Layer.Layer<CuidState, never, DateTimes | GetRandomValues>;
+}
+export declare const makeCuid: Effect.Effect<Cuid, never, DateTimes | GetRandomValues | CuidState>;
+export {};

package/dist/Cuid.js

@@ -0,0 +1,86 @@
+import { Effect, Layer, Schema } from 'effect';
+import { DateTimes } from './DateTimes.js';
+import { GetRandomValues } from './GetRandomValues.js';
+// Constants
+const DEFAULT_LENGTH = 24;
+const BIG_LENGTH = 32;
+const INITIAL_COUNT_MAX = 476782367;
+// Schema
+export const Cuid = Schema.String.pipe(Schema.pattern(/^[a-z][0-9a-z]+$/), Schema.brand('@typed/id/CUID'));
+export const isCuid = Schema.is(Cuid);
+// Utilities
+const ALPHABET = Array.from({ length: 26 }, (_, i) => String.fromCharCode(i + 97));
+const encoder = new TextEncoder();
+function createEntropy(length, random) {
+    let entropy = '';
+    let offset = 0;
+    while (entropy.length < length) {
+        const value = random[offset];
+        entropy += Math.floor(value % 36).toString(36);
+        offset = (offset + 1) % random.length;
+    }
+    return entropy;
+}
+function hash(input) {
+    // Convert string to bytes
+    const data = encoder.encode(input);
+    // Create a hash using the Web Crypto API
+    return crypto.subtle.digest('SHA-512', data).then((buffer) => {
+        const view = new Uint8Array(buffer);
+        let value = 0n;
+        for (const byte of view) {
+            value = (value << 8n) + BigInt(byte);
+        }
+        // Drop the first character because it will bias the histogram to the left
+        return value.toString(36).slice(1);
+    });
+}
+// State Management
+export class CuidState extends Effect.Tag('CuidState')() {
+    static layer = (envData) => Layer.effect(this, Effect.gen(function* () {
+        const { now } = yield* DateTimes;
+        const getRandomValues = yield* GetRandomValues;
+        const initialBytes = yield* getRandomValues(4);
+        const initialValue = Math.abs((initialBytes[0] << 24) |
+            (initialBytes[1] << 16) |
+            (initialBytes[2] << 8) |
+            initialBytes[3]) % INITIAL_COUNT_MAX;
+        // Create fingerprint from environment data
+        const fingerprint = yield* Effect.promise(() => hash(envData).then((h) => h.substring(0, BIG_LENGTH)));
+        let counter = initialValue;
+        return {
+            next: Effect.gen(function* () {
+                const timestamp = yield* now;
+                const random = yield* getRandomValues(32);
+                return {
+                    timestamp,
+                    counter: counter++,
+                    random,
+                    fingerprint,
+                };
+            }),
+        };
+    }));
+    static Default = this.layer('node');
+}
+// Core Functions
+function cuidFromSeed({ timestamp, counter, random, fingerprint }) {
+    return Effect.gen(function* () {
+        // First letter is always a random lowercase letter from the seed
+        const firstLetter = ALPHABET[random[0] % ALPHABET.length];
+        // Convert components to base36
+        const time = timestamp.toString(36);
+        const count = counter.toString(36);
+        // Create entropy from remaining random bytes
+        const salt = createEntropy(4, random.slice(1));
+        // Hash all components together
+        const hashInput = `${time}${salt}${count}${fingerprint}`;
+        const hashed = yield* Effect.promise(() => hash(hashInput));
+        // Construct the final CUID
+        const id = `${firstLetter}${hashed.substring(0, DEFAULT_LENGTH - 1)}`;
+        return Cuid.make(id);
+    });
+}
+// Public API
+export const makeCuid = Effect.flatMap(CuidState.next, cuidFromSeed);
+//# sourceMappingURL=Cuid.js.map

package/dist/Cuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cuid.js","sourceRoot":"","sources":["../src/Cuid.ts"],"names":[],"mappings":"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"}

package/dist/DateTimes.js

@@ -7,10 +7,11 @@ export class DateTimes extends Effect.Tag('DateTimes')() {
     static Default = this.make(Effect.clockWith((clock) => clock.currentTimeMillis));
     static Fixed = (base) => Layer.effect(DateTimes, Effect.gen(function* () {
         const clock = yield* Effect.clock;
+        const baseN = BigInt(base.getTime());
         const startMillis = yield* clock.currentTimeMillis;
         const now = clock.currentTimeMillis.pipe(Effect.map((millis) => 
         // Use BigInt to avoid floating point precision issues which can break deterministic testing
-        Number(BigInt(base.getTime()) + BigInt(millis) - BigInt(startMillis))));
+        Number(baseN + BigInt(millis) - BigInt(startMillis))));
         return {
             now,
             date: now.pipe(Effect.map((millis) => new Date(millis))),

package/dist/DateTimes.js.map

@@ -1 +1 @@
-{"version":3,"file":"DateTimes.js","sourceRoot":"","sources":["../src/DateTimes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAqB,MAAM,QAAQ,CAAA;AAEzD,MAAM,OAAO,SAAU,SAAQ,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,EAMnD;IACD,MAAM,CAAU,IAAI,GAAG,CAAC,GAA0B,EAA0B,EAAE,CAC5E,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;QAClB,GAAG;QACH,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;KACzD,CAAC,CAAA;IAEJ,MAAM,CAAU,OAAO,GAA2B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAEjH,MAAM,CAAU,KAAK,GAAG,CAAC,IAAU,EAA0B,EAAE,CAC7D,KAAK,CAAC,MAAM,CACV,SAAS,EACT,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAA;QACjC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAA;QAClD,MAAM,GAAG,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,CACtC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACpB,4FAA4F;QAC5F,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CACtE,CACF,CAAA;QAED,OAAO;YACL,GAAG;YACH,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;SACzD,CAAA;IACH,CAAC,CAAC,CACH,CAAA"}
+{"version":3,"file":"DateTimes.js","sourceRoot":"","sources":["../src/DateTimes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAqB,MAAM,QAAQ,CAAA;AAEzD,MAAM,OAAO,SAAU,SAAQ,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,EAMnD;IACD,MAAM,CAAU,IAAI,GAAG,CAAC,GAA0B,EAA0B,EAAE,CAC5E,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;QAClB,GAAG;QACH,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;KACzD,CAAC,CAAA;IAEJ,MAAM,CAAU,OAAO,GAA2B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAEjH,MAAM,CAAU,KAAK,GAAG,CAAC,IAAU,EAA0B,EAAE,CAC7D,KAAK,CAAC,MAAM,CACV,SAAS,EACT,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAA;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QACpC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAA;QAClD,MAAM,GAAG,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,CACtC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACpB,4FAA4F;QAC5F,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CACrD,CACF,CAAA;QAED,OAAO;YACL,GAAG;YACH,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;SACzD,CAAA;IACH,CAAC,CAAC,CACH,CAAA"}

package/dist/Ksuid.d.ts

@@ -0,0 +1,7 @@
+import { Effect, Schema } from 'effect';
+import { DateTimes } from './DateTimes.js';
+import { GetRandomValues } from './GetRandomValues.js';
+export declare const Ksuid: Schema.brand<Schema.filter<Schema.Schema<string, string, never>>, "@typed/id/KSUID">;
+export type Ksuid = Schema.Schema.Type<typeof Ksuid>;
+export declare const isKsuid: (value: string) => value is Ksuid;
+export declare const makeKsuid: Effect.Effect<Ksuid, never, DateTimes | GetRandomValues>;

package/dist/Ksuid.js

@@ -0,0 +1,56 @@
+import { Effect, Schema } from 'effect';
+import { DateTimes } from './DateTimes.js';
+import { GetRandomValues } from './GetRandomValues.js';
+// Constants
+const EPOCH = 14e11; // 2014-03-01T00:00:00Z
+const TIMESTAMP_BYTES = 4;
+const PAYLOAD_BYTES = 16;
+const TOTAL_BYTES = TIMESTAMP_BYTES + PAYLOAD_BYTES;
+const STRING_LENGTH = 27;
+// Schema
+export const Ksuid = Schema.String.pipe(Schema.pattern(/^[0-9a-zA-Z]{27}$/), Schema.brand('@typed/id/KSUID'));
+export const isKsuid = Schema.is(Ksuid);
+// Utilities
+const base62Chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+const base = BigInt(base62Chars.length);
+function base62Encode(bytes) {
+    let number = 0n;
+    for (const byte of bytes) {
+        number = (number << 8n) + BigInt(byte);
+    }
+    const chars = new Array(STRING_LENGTH);
+    let i = chars.length;
+    while (i > 0) {
+        i--;
+        const remainder = Number(number % base);
+        chars[i] = base62Chars[remainder];
+        number = number / base;
+    }
+    return chars.join('');
+}
+// Core Functions
+function ksuidFromSeed({ timestamp, payload }) {
+    // Create the combined bytes
+    const bytes = new Uint8Array(TOTAL_BYTES);
+    // Support for timestamps before the epoch, usually for testing
+    if (timestamp < EPOCH) {
+        timestamp += EPOCH;
+    }
+    // Write timestamp (4 bytes, big-endian)
+    const seconds = Math.floor((timestamp - EPOCH) / 1000);
+    bytes[0] = (seconds >>> 24) & 0xff;
+    bytes[1] = (seconds >>> 16) & 0xff;
+    bytes[2] = (seconds >>> 8) & 0xff;
+    bytes[3] = seconds & 0xff;
+    // Copy payload
+    bytes.set(payload, TIMESTAMP_BYTES);
+    // Encode as base62
+    return Ksuid.make(base62Encode(bytes));
+}
+// Public API
+export const makeKsuid = Effect.gen(function* () {
+    const timestamp = yield* DateTimes.now;
+    const payload = yield* GetRandomValues.apply(PAYLOAD_BYTES);
+    return ksuidFromSeed({ timestamp, payload });
+});
+//# sourceMappingURL=Ksuid.js.map

package/dist/Ksuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ksuid.js","sourceRoot":"","sources":["../src/Ksuid.ts"],"names":[],"mappings":"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"}

package/dist/Uuid4.js

@@ -9,6 +9,6 @@ function uuid4FromSeed(seed) {
     // Per 4.4, set bits for version and `clock_seq_hi_and_reserved`
     seed[6] = (seed[6] & 0x0f) | 0x40;
     seed[8] = (seed[8] & 0x3f) | 0x80;
-    return uuidStringify(seed);
+    return Uuid4.make(uuidStringify(seed));
 }
 //# sourceMappingURL=Uuid4.js.map

package/dist/Uuid4.js.map

@@ -1 +1 @@
-{"version":3,"file":"Uuid4.js","sourceRoot":"","sources":["../src/Uuid4.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAGtE,MAAM,CAAC,MAAM,OAAO,GAAsC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;AAE1E,MAAM,CAAC,MAAM,SAAS,GAAiD,MAAM,CAAC,GAAG,CAC/E,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,EACzB,aAAa,CACd,CAAA;AAED,SAAS,aAAa,CAAC,IAAgB;IACrC,gEAAgE;IAChE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;IACjC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;IAEjC,OAAO,aAAa,CAAC,IAAI,CAAU,CAAA;AACrC,CAAC"}
+{"version":3,"file":"Uuid4.js","sourceRoot":"","sources":["../src/Uuid4.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAGtE,MAAM,CAAC,MAAM,OAAO,GAAsC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;AAE1E,MAAM,CAAC,MAAM,SAAS,GAAiD,MAAM,CAAC,GAAG,CAC/E,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,EACzB,aAAa,CACd,CAAA;AAED,SAAS,aAAa,CAAC,IAAgB;IACrC,gEAAgE;IAChE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;IACjC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;IAEjC,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;AACxC,CAAC"}

package/dist/Uuid5.js

@@ -42,7 +42,7 @@ export function makeUuid5(namespace, name) {
         // Set version (5) and variant bits
         result[6] = (result[6] & 0x0f) | 0x50; // version 5
         result[8] = (result[8] & 0x3f) | 0x80; // variant 1
-        return uuidStringify(result);
+        return Uuid5.make(uuidStringify(result));
     });
 }
 //# sourceMappingURL=Uuid5.js.map

package/dist/Uuid5.js.map

@@ -1 +1 @@
-{"version":3,"file":"Uuid5.js","sourceRoot":"","sources":["../src/Uuid5.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAGtE,MAAM,CAAC,MAAM,OAAO,GAAsC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;AAE1E,MAAM,OAAO,IAAK,SAAQ,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAKzC;IACD,MAAM,CAAU,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;QAC5C,IAAI,EAAE,CAAC,IAAgB,EAAE,EAAE,CACzB,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAClB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CACzE;KACJ,CAAC,CAAA;;AAKJ,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAA;AAErC,uCAAuC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,IAAI,UAAU,CAAC;QAClB,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;KAC/F,CAAC;IAEF,GAAG,EAAE,IAAI,UAAU,CAAC;QAClB,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;KAC/F,CAAC;IAEF,GAAG,EAAE,IAAI,UAAU,CAAC;QAClB,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;KAC/F,CAAC;IAEF,IAAI,EAAE,IAAI,UAAU,CAAC;QACnB,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;KAC/F,CAAC;CACM,CAAA;AAEV,MAAM,UAAU,SAAS,CACvB,SAAyB,EACzB,IAAY;IAEZ,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAA;QAExB,8BAA8B;QAC9B,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAE1C,iCAAiC;QACjC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;QAClE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACrB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;QAEvC,8BAA8B;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAErC,oBAAoB;QACpB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;QAEjC,kCAAkC;QAClC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QAEhC,mCAAmC;QACnC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA,CAAC,YAAY;QAClD,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA,CAAC,YAAY;QAElD,OAAO,aAAa,CAAC,MAAM,CAAU,CAAA;IACvC,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"Uuid5.js","sourceRoot":"","sources":["../src/Uuid5.ts"],"names":[],"mappings":"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"}

package/dist/Uuid7.js

@@ -66,6 +66,6 @@ function uuid7FromSeed({ timestamp, seq, randomBytes }) {
     result[13] = randomBytes[13];
     result[14] = randomBytes[14];
     result[15] = randomBytes[15];
-    return uuidStringify(result);
+    return Uuid7.make(uuidStringify(result));
 }
 //# sourceMappingURL=Uuid7.js.map

package/dist/Uuid7.js.map

@@ -1 +1 @@
-{"version":3,"file":"Uuid7.js","sourceRoot":"","sources":["../src/Uuid7.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Uuid7.js","sourceRoot":"","sources":["../src/Uuid7.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
+export * from './Cuid.js';
 export * from './DateTimes.js';
 export * from './GetRandomValues.js';
+export * from './Ksuid.js';
 export * from './NanoId.js';
 export * from './Ulid.js';
 export * from './Uuid4.js';

package/dist/index.js

@@ -1,5 +1,7 @@
+export * from './Cuid.js';
 export * from './DateTimes.js';
 export * from './GetRandomValues.js';
+export * from './Ksuid.js';
 export * from './NanoId.js';
 export * from './Ulid.js';
 export * from './Uuid4.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typed/id",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Common ID format generation for Effect",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/readme.md

@@ -1,6 +1,6 @@
 # @typed/id
 
-A TypeScript library providing common ID format generation using [Effect](https://effect.website/). This package includes implementations for UUID, NanoID, and ULID generation with a focus on type safety and functional programming principles.
+A TypeScript library providing common ID format generation using [Effect](https://effect.website/). This package includes implementations for UUID, NanoID, ULID, CUID2, and KSUID generation with a focus on type safety and functional programming principles.
 
 ## Installation
 
@@ -17,9 +17,11 @@ yarn add @typed/id effect
 - 🎯 Type-safe ID generation
 - 🔧 Built on top of Effect
 - 🎨 Multiple ID format support:
-  - UUID (v4, v5, v6, v7)
+  - UUID (v4, v5, v7)
   - NanoID
   - ULID
+  - CUID2
+  - KSUID
 - ⚡ Efficient and secure random value generation
 - 📦 Zero dependencies (except Effect)
 
@@ -37,7 +39,10 @@ import {
   Uuid5Namespace,
   Sha1,
   makeNanoId, 
-  makeUlid 
+  makeUlid,
+  makeCuid,
+  CuidState,
+  makeKsuid,
 } from '@typed/id'
 
 // Generate a UUID v4 (random)
@@ -80,6 +85,23 @@ await makeUlid.pipe(
   Effect.runPromise
 )
 // Output: "01ARZ3NDEKTSV4RRFFQ69G5FAV"
+
+// Generate a CUID
+await makeCuid.pipe(
+  Effect.provide(CuidState.layer('my-environment')), // Provide environment fingerprint
+  Effect.provide([GetRandomValues.CryptoRandom, DateTimes.Default]),
+  Effect.flatMap(Effect.log),
+  Effect.runPromise
+)
+// Output: "clh3aqnd900003b64zpka3df"
+
+// Generate a KSUID
+await makeKsuid.pipe(
+  Effect.provide([GetRandomValues.CryptoRandom, DateTimes.Default]),
+  Effect.flatMap(Effect.log),
+  Effect.runPromise
+)
+// Output: "1jIGxyVFPeR4GkCcDPQU2bXhxy9"
 ```
 
 ## API
@@ -88,7 +110,6 @@ await makeUlid.pipe(
 
 - `makeUuid4`: Generates a v4 UUID (random)
 - `makeUuid5`: Generates a v5 UUID (SHA-1 hash of namespace + name)
-- `makeUuid6`: Generates a v6 UUID (reordered time-based for better sorting)
 - `makeUuid7`: Generates a v7 UUID (time-sortable)
 
 ### UUID v5 Namespaces
@@ -107,6 +128,36 @@ Pre-defined namespaces for UUID v5 generation:
 
 - `makeUlid`: Generates a ULID (Universally Unique Lexicographically Sortable Identifier)
 
+### CUID
+
+- `makeCuid`: Generates a CUID2 (Collision-resistant Unique IDentifier)
+- `CuidState.layer(envData)`: Creates a CUID state layer with environment fingerprint
+  - `envData`: A string identifying the environment (e.g., 'browser', 'node', 'mobile-ios')
+  - Used to help prevent collisions in distributed systems
+  - Cached and reused for efficiency
+- Format: 24 characters, starting with a lowercase letter, followed by numbers and lowercase letters
+- Properties:
+  - Sequential for database performance
+  - Secure from enumeration
+  - URL-safe
+  - Horizontally scalable
+  - Includes timestamp for time-based sorting
+
+### KSUID
+
+- `makeKsuid`: Generates a KSUID (K-Sortable Unique IDentifier)
+- Format: 27 characters of base62 (0-9A-Za-z)
+- Components:
+  - 32-bit timestamp (seconds since 2014-03-01)
+  - 128-bit random payload
+- Properties:
+  - Time-sortable (lexicographically ordered by time)
+  - URL-safe (base62 encoded)
+  - Includes entropy for uniqueness
+  - Fixed size (27 characters)
+  - ~136 years of timestamp space from 2014
+  - No special character dependencies
+
 ## License
 
 MIT

package/src/Cuid.ts

@@ -0,0 +1,135 @@
+import { Effect, Layer, Schema } from 'effect'
+import { DateTimes } from './DateTimes.js'
+import { GetRandomValues } from './GetRandomValues.js'
+
+// Constants
+const DEFAULT_LENGTH = 24
+const BIG_LENGTH = 32
+const INITIAL_COUNT_MAX = 476782367
+
+// Schema
+export const Cuid = Schema.String.pipe(
+  Schema.pattern(/^[a-z][0-9a-z]+$/),
+  Schema.brand('@typed/id/CUID'),
+)
+export type Cuid = Schema.Schema.Type<typeof Cuid>
+
+export const isCuid: (value: string) => value is Cuid = Schema.is(Cuid)
+
+// Types
+export type CuidSeed = {
+  readonly timestamp: number
+  readonly counter: number
+  readonly random: Uint8Array
+  readonly fingerprint: string
+}
+
+// Utilities
+const ALPHABET = Array.from({ length: 26 }, (_, i) => String.fromCharCode(i + 97))
+const encoder = new TextEncoder()
+
+function createEntropy(length: number, random: Uint8Array): string {
+  let entropy = ''
+  let offset = 0
+
+  while (entropy.length < length) {
+    const value = random[offset]
+    entropy += Math.floor(value % 36).toString(36)
+    offset = (offset + 1) % random.length
+  }
+
+  return entropy
+}
+
+function hash(input: string): Promise<string> {
+  // Convert string to bytes
+  const data = encoder.encode(input)
+
+  // Create a hash using the Web Crypto API
+  return crypto.subtle.digest('SHA-512', data).then((buffer) => {
+    const view = new Uint8Array(buffer)
+    let value = 0n
+    for (const byte of view) {
+      value = (value << 8n) + BigInt(byte)
+    }
+    // Drop the first character because it will bias the histogram to the left
+    return value.toString(36).slice(1)
+  })
+}
+
+// State Management
+export class CuidState extends Effect.Tag('CuidState')<
+  CuidState,
+  {
+    readonly next: Effect.Effect<CuidSeed>
+  }
+>() {
+  static readonly layer = (
+    envData: string,
+  ): Layer.Layer<CuidState, never, DateTimes | GetRandomValues> =>
+    Layer.effect(
+      this,
+      Effect.gen(function* () {
+        const { now } = yield* DateTimes
+        const getRandomValues = yield* GetRandomValues
+        const initialBytes = yield* getRandomValues(4)
+        const initialValue =
+          Math.abs(
+            (initialBytes[0] << 24) |
+              (initialBytes[1] << 16) |
+              (initialBytes[2] << 8) |
+              initialBytes[3],
+          ) % INITIAL_COUNT_MAX
+
+        // Create fingerprint from environment data
+        const fingerprint = yield* Effect.promise(() =>
+          hash(envData).then((h) => h.substring(0, BIG_LENGTH)),
+        )
+
+        let counter = initialValue
+
+        return {
+          next: Effect.gen(function* () {
+            const timestamp = yield* now
+            const random = yield* getRandomValues(32)
+            return {
+              timestamp,
+              counter: counter++,
+              random,
+              fingerprint,
+            }
+          }),
+        }
+      }),
+    )
+
+  static readonly Default = this.layer('node')
+}
+
+// Core Functions
+function cuidFromSeed({ timestamp, counter, random, fingerprint }: CuidSeed): Effect.Effect<Cuid> {
+  return Effect.gen(function* () {
+    // First letter is always a random lowercase letter from the seed
+    const firstLetter = ALPHABET[random[0] % ALPHABET.length]
+
+    // Convert components to base36
+    const time = timestamp.toString(36)
+    const count = counter.toString(36)
+
+    // Create entropy from remaining random bytes
+    const salt = createEntropy(4, random.slice(1))
+
+    // Hash all components together
+    const hashInput = `${time}${salt}${count}${fingerprint}`
+    const hashed = yield* Effect.promise(() => hash(hashInput))
+
+    // Construct the final CUID
+    const id = `${firstLetter}${hashed.substring(0, DEFAULT_LENGTH - 1)}`
+
+    return Cuid.make(id)
+  })
+}
+
+// Public API
+export const makeCuid: Effect.Effect<Cuid, never, DateTimes | GetRandomValues | CuidState> =
+  Effect.flatMap(CuidState.next, cuidFromSeed)

package/src/DateTimes.ts

@@ -20,11 +20,12 @@ export class DateTimes extends Effect.Tag('DateTimes')<
       DateTimes,
       Effect.gen(function* () {
         const clock = yield* Effect.clock
+        const baseN = BigInt(base.getTime())
         const startMillis = yield* clock.currentTimeMillis
         const now = clock.currentTimeMillis.pipe(
           Effect.map((millis) =>
             // Use BigInt to avoid floating point precision issues which can break deterministic testing
-            Number(BigInt(base.getTime()) + BigInt(millis) - BigInt(startMillis)),
+            Number(baseN + BigInt(millis) - BigInt(startMillis)),
           ),
         )
 
@@ -35,3 +36,4 @@ export class DateTimes extends Effect.Tag('DateTimes')<
       }),
     )
 }
+

package/src/Ksuid.ts

@@ -0,0 +1,81 @@
+import { Effect, Schema } from 'effect'
+import { DateTimes } from './DateTimes.js'
+import { GetRandomValues } from './GetRandomValues.js'
+
+// Constants
+const EPOCH = 14e11 // 2014-03-01T00:00:00Z
+const TIMESTAMP_BYTES = 4
+const PAYLOAD_BYTES = 16
+const TOTAL_BYTES = TIMESTAMP_BYTES + PAYLOAD_BYTES
+const STRING_LENGTH = 27
+
+// Schema
+export const Ksuid = Schema.String.pipe(
+  Schema.pattern(/^[0-9a-zA-Z]{27}$/),
+  Schema.brand('@typed/id/KSUID'),
+)
+export type Ksuid = Schema.Schema.Type<typeof Ksuid>
+
+export const isKsuid: (value: string) => value is Ksuid = Schema.is(Ksuid)
+
+// Types
+type KsuidSeed = {
+  readonly timestamp: number
+  readonly payload: Uint8Array
+}
+
+// Utilities
+const base62Chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'
+const base = BigInt(base62Chars.length)
+
+function base62Encode(bytes: Uint8Array): string {
+  let number = 0n
+  for (const byte of bytes) {
+    number = (number << 8n) + BigInt(byte)
+  }
+
+  const chars: string[] = new Array(STRING_LENGTH)
+  let i = chars.length
+
+  while (i > 0) {
+    i--
+    const remainder = Number(number % base)
+    chars[i] = base62Chars[remainder]
+    number = number / base
+  }
+
+  return chars.join('')
+}
+
+// Core Functions
+function ksuidFromSeed({ timestamp, payload }: KsuidSeed): Ksuid {
+  // Create the combined bytes
+  const bytes = new Uint8Array(TOTAL_BYTES)
+
+  // Support for timestamps before the epoch, usually for testing
+  if (timestamp < EPOCH) {
+    timestamp += EPOCH
+  }
+
+  // Write timestamp (4 bytes, big-endian)
+  const seconds = Math.floor((timestamp - EPOCH) / 1000)
+  bytes[0] = (seconds >>> 24) & 0xff
+  bytes[1] = (seconds >>> 16) & 0xff
+  bytes[2] = (seconds >>> 8) & 0xff
+  bytes[3] = seconds & 0xff
+
+  // Copy payload
+  bytes.set(payload, TIMESTAMP_BYTES)
+
+  // Encode as base62
+  return Ksuid.make(base62Encode(bytes))
+}
+
+// Public API
+export const makeKsuid: Effect.Effect<Ksuid, never, DateTimes | GetRandomValues> = Effect.gen(
+  function* () {
+    const timestamp = yield* DateTimes.now
+    const payload = yield* GetRandomValues.apply(PAYLOAD_BYTES)
+    return ksuidFromSeed({ timestamp, payload })
+  },
+)

package/src/Uuid4.ts

@@ -18,5 +18,5 @@ function uuid4FromSeed(seed: Uint8Array): Uuid4 {
   seed[6] = (seed[6] & 0x0f) | 0x40
   seed[8] = (seed[8] & 0x3f) | 0x80
 
-  return uuidStringify(seed) as Uuid4
+  return Uuid4.make(uuidStringify(seed))
 }

package/src/Uuid5.ts

@@ -72,6 +72,6 @@ export function makeUuid5(
     result[6] = (result[6] & 0x0f) | 0x50 // version 5
     result[8] = (result[8] & 0x3f) | 0x80 // variant 1
 
-    return uuidStringify(result) as Uuid5
+    return Uuid5.make(uuidStringify(result))
   })
 }

package/src/Uuid7.ts

@@ -100,5 +100,5 @@ function uuid7FromSeed({ timestamp, seq, randomBytes }: Uuid7Seed): Uuid7 {
   result[14] = randomBytes[14]
   result[15] = randomBytes[15]
 
-  return uuidStringify(result) as Uuid7
+  return Uuid7.make(uuidStringify(result))
 }

package/src/id.test.ts

@@ -1,46 +1,48 @@
 import { describe, expect, it } from '@effect/vitest'
-import { Effect, flow } from 'effect'
+import { Effect, flow, TestClock } from 'effect'
 import {
   DateTimes,
   GetRandomValues,
   isUuid4,
   isUuid5,
-  isUuid6,
   isUuid7,
   makeNanoId,
   makeUlid,
   makeUuid4,
   makeUuid5,
-  makeUuid6,
   makeUuid7,
   Sha1,
   Uuid5Namespace,
-  Uuid6State,
   Uuid7State,
+  makeCuid,
+  isCuid,
+  CuidState,
+  makeKsuid,
+  isKsuid,
 } from './index.js'
 
+
 const makeTestValues = (length: number) => {
   const values = new Uint8Array(length)
   for (let i = 0; i < length; ++i) {
-    values[i] = i
+    values[i] = i % 256
   }
   return values
 }
 
 const provideTestValues = flow(
-  Effect.provide([Uuid7State.Default, Uuid6State.Default]),
+  Effect.provide(CuidState.layer('test')),
+  Effect.provide(Uuid7State.Default),
   Effect.provide(Sha1.Default),
-  Effect.provide([
-    GetRandomValues.layer((length) => Effect.succeed(makeTestValues(length))),
-    DateTimes.Fixed(new Date(0)),
-  ]),
+  Effect.provide(GetRandomValues.layer((length) => Effect.succeed(makeTestValues(length)))),
+  Effect.provide(DateTimes.Fixed(new Date(0))),
 )
 
 describe(__filename, () => {
   describe('Uuid4', () => {
     it.effect('generates a UUID v4', () =>
-      Effect.gen(function* (_) {
-        const id = yield* _(makeUuid4)
+      Effect.gen(function* () {
+        const id = yield* makeUuid4
         expect(id).toMatchInlineSnapshot(`"00010203-0405-4607-8809-0a0b0c0d0e0f"`)
         expect(id.length).toEqual(36)
         expect(isUuid4(id)).toEqual(true)
@@ -50,8 +52,8 @@ describe(__filename, () => {
 
   describe('Uuid5', () => {
     it.effect('generates a UUID v5', () =>
-      Effect.gen(function* (_) {
-        const id = yield* _(makeUuid5(Uuid5Namespace.DNS, 'example.com'))
+      Effect.gen(function* () {
+        const id = yield* makeUuid5(Uuid5Namespace.DNS, 'example.com')
         expect(id).toMatchInlineSnapshot(`"cfbff0d1-9375-5685-968c-48ce8b15ae17"`)
         expect(id.length).toEqual(36)
         expect(isUuid5(id)).toEqual(true)
@@ -59,21 +61,10 @@ describe(__filename, () => {
     )
   })
 
-  describe('Uuid6', () => {
-    it.effect('generates a UUID v6', () =>
-      Effect.gen(function* (_) {
-        const id = yield* _(makeUuid6)
-        expect(id).toMatchInlineSnapshot(`"1b21dd21-3814-6000-8809-0b0b0c0d0e0f"`)
-        expect(id.length).toEqual(36)
-        expect(isUuid6(id)).toEqual(true)
-      }).pipe(provideTestValues),
-    )
-  })
-
   describe('Uuid7', () => {
     it.effect('generates a UUID v7', () =>
-      Effect.gen(function* (_) {
-        const id = yield* _(makeUuid7)
+      Effect.gen(function* () {
+        const id = yield* makeUuid7
         expect(id).toMatchInlineSnapshot(`"00000000-0000-7030-9c20-260b0c0d0e0f"`)
         expect(id.length).toEqual(36)
         expect(isUuid7(id)).toEqual(true)
@@ -83,8 +74,8 @@ describe(__filename, () => {
 
   describe('NanoId', () => {
     it.effect('generates a NanoId', () =>
-      Effect.gen(function* (_) {
-        const id = yield* _(makeNanoId)
+      Effect.gen(function* () {
+        const id = yield* makeNanoId
         expect(id).toMatchInlineSnapshot(`"0123456789abcdefghijk"`)
         expect(id.length).toEqual(21)
       }).pipe(provideTestValues),
@@ -93,11 +84,50 @@ describe(__filename, () => {
 
   describe('Ulid', () => {
     it.effect('generates a Ulid', () =>
-      Effect.gen(function* (_) {
-        const id = yield* _(makeUlid)
+      Effect.gen(function* () {
+        const id = yield* makeUlid
         expect(id).toMatchInlineSnapshot(`"00000000000123456789ABCDEF"`)
         expect(id.length).toEqual(26)
       }).pipe(provideTestValues),
     )
   })
+
+  describe('Cuid', () => {
+    it.effect('generates a CUID', () =>
+      Effect.gen(function* () {
+        const id = yield* makeCuid
+        expect(id.length).toEqual(24)
+        expect(isCuid(id)).toEqual(true)
+        expect(id).toMatchInlineSnapshot(`"ai17q5mkkp8w5f2cey3lyzu5"`)
+
+        // Generate another to ensure uniqueness
+        const id2 = yield* makeCuid
+        expect(id2).not.toEqual(id)
+        expect(isCuid(id2)).toEqual(true)
+        expect(id2).toMatchInlineSnapshot(`"abeo5wmlmnjxjrnjiidlfvzp"`)
+      }).pipe(provideTestValues),
+    )
+  })
+
+  describe('Ksuid', () => {
+    it.effect('generates a KSUID', () =>
+      Effect.gen(function* () {
+        console.log(yield* DateTimes.now)
+        const id = yield* makeKsuid
+        expect(id.length).toEqual(27)
+        expect(isKsuid(id)).toEqual(true)
+        expect(id).toMatchInlineSnapshot(`"00000000SYW7RiJxkEgOGusQGwp"`)
+
+        yield* TestClock.adjust(1000)
+
+        console.log(yield* DateTimes.now)
+
+        // Generate another to ensure uniqueness
+        const id2 = yield* makeKsuid
+        expect(id2).not.toEqual(id)
+        expect(isKsuid(id2)).toEqual(true)
+        expect(id2).toMatchInlineSnapshot(`"000007n4UlmTXBzjUOTX3nzfyYx"`)
+      }).pipe(provideTestValues),
+    )
+  })
 })

package/src/index.ts

@@ -1,5 +1,7 @@
+export * from './Cuid.js'
 export * from './DateTimes.js'
 export * from './GetRandomValues.js'
+export * from './Ksuid.js'
 export * from './NanoId.js'
 export * from './Ulid.js'
 export * from './Uuid4.js'