effect-start 0.26.0 → 0.28.0

package/dist/Start.js

@@ -0,0 +1,91 @@
+import * as Context from "effect/Context";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as FiberId from "effect/FiberId";
+import * as ExecutionStrategy from "effect/ExecutionStrategy";
+import * as Exit from "effect/Exit";
+import * as Function from "effect/Function";
+import * as Layer from "effect/Layer";
+import * as Scope from "effect/Scope";
+import * as SynchronizedRef from "effect/SynchronizedRef";
+import * as MutableRef from "effect/MutableRef";
+import * as BunRuntime from "./bun/BunRuntime.js";
+import * as BunServer from "./bun/BunServer.js";
+import * as NodeFileSystem from "./node/NodeFileSystem.js";
+import * as BunChildProcessSpawner from "./bun/BunChildProcessSpawner.js";
+import * as PlatformRuntime from "./PlatformRuntime.js";
+import * as StartApp from "./StartApp.js";
+export function layer(...layers) {
+    return Layer.mergeAll(...layers);
+}
+/**
+ * Bundles layers together, wiring their dependencies automatically.
+ *
+ * Equivalent to chaining `Layer.provide` calls, but more concise.
+ *
+ * **Ordering: dependents first, dependencies last.**
+ *
+ * @example
+ * ```ts
+ * // UserRepo needs Database, Database needs Logger
+ * const AppLayer = Start.pack(
+ *   UserRepoLive,   // needs Database, Logger
+ *   DatabaseLive,   // needs Logger
+ *   LoggerLive,     // no deps
+ * )
+ * // Result: Layer<UserRepo | Database | Logger, never, never>
+ * ```
+ *
+ * @since 1.0.0
+ * @category constructors
+ */
+export function pack(...layers) {
+    const layerArray = layers;
+    const result = layerArray.reduce((acc, layer) => Layer.provideMerge(acc, layer), Layer.succeedContext(Context.empty()));
+    return result;
+}
+export function build(...layers) {
+    const layerArray = layers;
+    return Layer.scopedContext(Effect.gen(function* () {
+        const scope = yield* Effect.scope;
+        const memoMap = yield* Layer.makeMemoMap;
+        const memoMapRef = memoMap.ref;
+        let ctx = yield* Effect.context();
+        const pending = new Set(layerArray);
+        for (let pass = 0; pass < layerArray.length && pending.size > 0; pass++) {
+            for (const layer of pending) {
+                const childScope = yield* Scope.fork(scope, ExecutionStrategy.sequential);
+                const exit = yield* layer.pipe(Layer.buildWithMemoMap(memoMap, childScope), Effect.provide(ctx), Effect.exit);
+                if (Exit.isSuccess(exit)) {
+                    ctx = Context.merge(ctx, exit.value);
+                    pending.delete(layer);
+                }
+                else {
+                    yield* Scope.close(childScope, exit);
+                    yield* SynchronizedRef.update(memoMapRef, (map) => {
+                        map.delete(layer);
+                        return map;
+                    });
+                }
+            }
+        }
+        for (const layer of pending) {
+            const childScope = yield* Scope.fork(scope, ExecutionStrategy.sequential);
+            const built = yield* layer.pipe(Layer.buildWithMemoMap(memoMap, childScope), Effect.provide(ctx));
+            ctx = Context.merge(ctx, built);
+        }
+        return ctx;
+    }));
+}
+export const Live = Layer.mergeAll(NodeFileSystem.layer, BunChildProcessSpawner.layer, Layer.effect(StartApp.StartApp, Deferred.make().pipe(Effect.map((server) => ({ server })))));
+export function serve(load) {
+    const appLayer = Function.pipe(Effect.tryPromise(load), Effect.map((v) => v.default), Effect.orDie, Layer.unwrapEffect);
+    const appLayerResolved = Function.pipe(appLayer, Layer.provideMerge(Live));
+    const composed = Function.pipe(BunServer.layerStart(), BunServer.withLogAddress, Layer.provide(appLayerResolved));
+    return Function.pipe(composed, Layer.launch, BunRuntime.runMain);
+}
+export const mainFiberId = Effect.sync(() => {
+    const fiber = MutableRef.get(PlatformRuntime.mainFiber);
+    return fiber ? fiber.id() : FiberId.none;
+});
+//# sourceMappingURL=Start.js.map

package/dist/Start.js.map

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

package/dist/StartApp.d.ts

@@ -0,0 +1,13 @@
+import * as Context from "effect/Context";
+import type * as Deferred from "effect/Deferred";
+import type * as BunServer from "./bun/BunServer.ts";
+export declare namespace StartApp {
+    interface Service {
+        readonly server: Deferred.Deferred<BunServer.BunServer>;
+    }
+}
+declare const StartApp_base: Context.TagClass<StartApp, "effect-start/StartApp", StartApp.Service>;
+export declare class StartApp extends StartApp_base {
+}
+export {};
+//# sourceMappingURL=StartApp.d.ts.map

package/dist/StartApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartApp.d.ts","sourceRoot":"","sources":["../src/StartApp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,KAAK,SAAS,MAAM,oBAAoB,CAAA;AAEpD,yBAAiB,QAAQ,CAAC,CAAC;IACzB,UAAiB,OAAO;QACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;KACxD;CACF;;AAED,qBAAa,QAAS,SAAQ,aAAkE;CAAG"}

package/dist/StartApp.js

@@ -0,0 +1,4 @@
+import * as Context from "effect/Context";
+export class StartApp extends Context.Tag("effect-start/StartApp")() {
+}
+//# sourceMappingURL=StartApp.js.map

package/dist/StartApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartApp.js","sourceRoot":"","sources":["../src/StartApp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAUzC,MAAM,OAAO,QAAS,SAAQ,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAA8B;CAAG"}

package/dist/StreamExtra.d.ts

@@ -0,0 +1,29 @@
+import * as Runtime from "effect/Runtime";
+import * as Stream from "effect/Stream";
+export declare const isStream: (u: unknown) => u is Stream.Stream<unknown, unknown, unknown>;
+export type IsStream<T> = T extends Stream.Stream<infer _A, infer _E, infer _R> ? true : false;
+export type Chunk<T> = T extends Stream.Stream<infer A, infer _E, infer _R> ? A : never;
+export type StreamError<T> = T extends Stream.Stream<infer _A, infer E, infer _R> ? E : never;
+export type Context<T> = T extends Stream.Stream<infer _A, infer _E, infer R> ? R : never;
+/**
+ * Patched version of original Stream.toReadableStreamRuntime (v3.14.4) to
+ * fix an issue in Bun when native stream controller stops working when request
+ * is terminated by the client:
+ *
+ *  TypeError: Value of "this" must be of type ReadableStreamDefaultController
+ *
+ * See related issues:
+ * https://github.com/Effect-TS/effect/issues/4538
+ * https://github.com/oven-sh/bun/issues/17837
+ */
+export declare const toReadableStreamRuntimePatched: (<A, XR>(runtime: Runtime.Runtime<XR>, options?: {
+    readonly strategy?: QueuingStrategy<A> | undefined;
+} | undefined) => <E, R extends XR>(self: Stream.Stream<A, E, R>) => ReadableStream<A>) & (<A, E, XR, R extends XR>(self: Stream.Stream<A, E, R>, runtime: Runtime.Runtime<XR>, options?: {
+    readonly strategy?: QueuingStrategy<A> | undefined;
+} | undefined) => ReadableStream<A>);
+export declare const toReadableStreamRuntimePatched2: (<A, XR>(runtime: Runtime.Runtime<XR>, options?: {
+    readonly strategy?: QueuingStrategy<A> | undefined;
+} | undefined) => <E, R extends XR>(self: Stream.Stream<A, E, R>) => ReadableStream<A>) & (<A, E, XR, R extends XR>(self: Stream.Stream<A, E, R>, runtime: Runtime.Runtime<XR>, options?: {
+    readonly strategy?: QueuingStrategy<A> | undefined;
+} | undefined) => ReadableStream<A>);
+//# sourceMappingURL=StreamExtra.d.ts.map

package/dist/StreamExtra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamExtra.d.ts","sourceRoot":"","sources":["../src/StreamExtra.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,eAAO,MAAM,QAAQ,+DAC0B,CAAA;AAE/C,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,KAAK,CAAA;AAE9F,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAEvF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAE7F,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAEzF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,8BAA8B,IACxC,CAAC,EAAE,EAAE;;mBAGA,CAAC,EAAE,CAAC,qEACT,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;;oCA+Db,CAAA;AAED,eAAO,MAAM,+BAA+B,IACzC,CAAC,EAAE,EAAE;;mBAGA,CAAC,EAAE,CAAC,qEACT,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;;oCAyDb,CAAA"}

package/dist/StreamExtra.js

@@ -0,0 +1,101 @@
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Function from "effect/Function";
+import * as Predicate from "effect/Predicate";
+import * as Runtime from "effect/Runtime";
+import * as Stream from "effect/Stream";
+export const isStream = (u) => Predicate.hasProperty(u, Stream.StreamTypeId);
+/**
+ * Patched version of original Stream.toReadableStreamRuntime (v3.14.4) to
+ * fix an issue in Bun when native stream controller stops working when request
+ * is terminated by the client:
+ *
+ *  TypeError: Value of "this" must be of type ReadableStreamDefaultController
+ *
+ * See related issues:
+ * https://github.com/Effect-TS/effect/issues/4538
+ * https://github.com/oven-sh/bun/issues/17837
+ */
+export const toReadableStreamRuntimePatched = Function.dual((args) => Predicate.hasProperty(args[0], Stream.StreamTypeId) || Effect.isEffect(args[0]), (self, runtime, options) => {
+    const runFork = Runtime.runFork(runtime);
+    let currentResolve = undefined;
+    let fiber = undefined;
+    const latch = Effect.unsafeMakeLatch(false);
+    return new ReadableStream({
+        start(controller) {
+            fiber = runFork(Stream.runForEachChunk(self, (chunk) => latch.whenOpen(Effect.sync(() => {
+                latch.unsafeClose();
+                try {
+                    for (const item of chunk) {
+                        controller.enqueue(item);
+                    }
+                }
+                catch (e) {
+                    if (e.message ===
+                        `Value of "this" must be of type ReadableStreamDefaultController`) {
+                        // Do nothing when this happens in Bun.
+                    }
+                    else {
+                        throw e;
+                    }
+                }
+                currentResolve();
+                currentResolve = undefined;
+            }))));
+            // --- CHANGES HERE ---
+            // In original code, we had fiber.addObserver here that called
+            // error() or close() on controller. This patched version removes it.
+        },
+        pull() {
+            return new Promise((resolve) => {
+                currentResolve = resolve;
+                Effect.runSync(latch.open);
+            });
+        },
+        cancel() {
+            if (!fiber)
+                return;
+            return Effect.runPromise(Effect.asVoid(Fiber.interrupt(fiber)));
+        },
+    }, options?.strategy);
+});
+export const toReadableStreamRuntimePatched2 = Function.dual((args) => Predicate.hasProperty(args[0], Stream.StreamTypeId) || Effect.isEffect(args[0]), (self, runtime, options) => {
+    const runSync = Runtime.runSync(runtime);
+    const runFork = Runtime.runFork(runtime);
+    let currentResolve = undefined;
+    let fiber = undefined;
+    const latch = Effect.unsafeMakeLatch(false);
+    return new ReadableStream({
+        start(controller) {
+            fiber = runFork(Stream.runForEachChunk(self, (chunk) => latch.whenOpen(Effect.sync(() => {
+                latch.unsafeClose();
+                for (const item of chunk) {
+                    controller.enqueue(item);
+                }
+                currentResolve();
+                currentResolve = undefined;
+            }))));
+            fiber.addObserver((exit) => {
+                if (exit._tag === "Failure") {
+                    controller.error(Cause.squash(exit.cause));
+                }
+                else {
+                    controller.close();
+                }
+            });
+        },
+        pull() {
+            return new Promise((resolve) => {
+                currentResolve = resolve;
+                Effect.runSync(latch.open);
+            });
+        },
+        cancel() {
+            if (!fiber)
+                return;
+            return Effect.runPromise(Effect.asVoid(Fiber.interrupt(fiber)));
+        },
+    }, options?.strategy);
+});
+//# sourceMappingURL=StreamExtra.js.map

package/dist/StreamExtra.js.map

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

package/dist/System.d.ts

@@ -0,0 +1,9 @@
+import * as Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+import * as ChildProcess from "./ChildProcess.ts";
+import * as PlatformError from "./PlatformError.ts";
+export declare const cwd: Effect.Effect<string>;
+export declare const randomFreePort: Effect.Effect<number, PlatformError.SystemError>;
+export declare const which: (name: string) => Effect.Effect<string, PlatformError.SystemError, never>;
+export declare const spawn: (cmd: readonly [string, ...string[]], options?: ChildProcess.Command.Options | undefined) => Effect.Effect<ChildProcess.ChildProcessHandle, PlatformError.PlatformError, ChildProcess.ChildProcessSpawner | Scope.Scope>;
+//# sourceMappingURL=System.d.ts.map

package/dist/System.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"System.d.ts","sourceRoot":"","sources":["../src/System.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAG1C,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD,eAAO,MAAM,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAoC,CAAA;AAE1E,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAuD1E,CAAA;AAEF,eAAO,MAAM,KAAK,2EAwBf,CAAA;AAEH,eAAO,MAAM,KAAK,0NAOsC,CAAA"}

package/dist/System.js

@@ -0,0 +1,61 @@
+import * as Effect from "effect/Effect";
+import * as NNet from "node:net";
+import * as ChildProcess from "./ChildProcess.js";
+import * as PlatformError from "./PlatformError.js";
+export const cwd = Effect.sync(() => process.cwd());
+export const randomFreePort = Effect.async((resume) => {
+    const server = NNet.createServer();
+    server.unref();
+    server.on("error", (err) => resume(Effect.fail(new PlatformError.SystemError({
+        reason: "Unknown",
+        module: "System",
+        method: "randomFreePort",
+        description: err.message,
+        cause: err,
+    }))));
+    server.listen(0, "127.0.0.1", () => {
+        const address = server.address();
+        if (!address || typeof address === "string") {
+            server.close(() => resume(Effect.fail(new PlatformError.SystemError({
+                reason: "Unknown",
+                module: "System",
+                method: "randomFreePort",
+                description: "Failed to allocate a free port",
+            }))));
+            return;
+        }
+        const port = address.port;
+        server.close((err) => {
+            if (err) {
+                resume(Effect.fail(new PlatformError.SystemError({
+                    reason: "Unknown",
+                    module: "System",
+                    method: "randomFreePort",
+                    description: err.message,
+                    cause: err,
+                })));
+                return;
+            }
+            resume(Effect.succeed(port));
+        });
+    });
+});
+export const which = (name) => Effect.flatMap(Effect.try({
+    try: () => Bun.which(name),
+    catch: (err) => new PlatformError.SystemError({
+        reason: "Unknown",
+        module: "System",
+        method: "which",
+        description: err instanceof Error ? err.message : `Failed to look up "${name}"`,
+        cause: err,
+    }),
+}), (path) => path === null
+    ? Effect.fail(new PlatformError.SystemError({
+        reason: "NotFound",
+        module: "System",
+        method: "which",
+        description: `Executable not found: "${name}"`,
+    }))
+    : Effect.succeed(path));
+export const spawn = (cmd, options) => ChildProcess.spawn(ChildProcess.make(cmd, options));
+//# sourceMappingURL=System.js.map

package/dist/System.js.map

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

package/dist/TuplePathPattern.d.ts

@@ -0,0 +1,10 @@
+export type PathTuple = ReadonlyArray<string | [string, string?, string?] | [[string]]>;
+export declare function format(tuple: PathTuple): `/${string}`;
+export declare function toColon(tuple: PathTuple): string;
+export declare const toHono: typeof toColon;
+export declare function toExpress(tuple: PathTuple): string;
+export declare const toEffect: typeof toColon;
+export declare function toURLPattern(tuple: PathTuple): string;
+export declare function toRemix(tuple: PathTuple): string;
+export declare const toBun: typeof toColon;
+//# sourceMappingURL=TuplePathPattern.d.ts.map

package/dist/TuplePathPattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TuplePathPattern.d.ts","sourceRoot":"","sources":["../src/TuplePathPattern.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AAEvF,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,MAAM,EAAE,CAUrD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAYhD;AAED,eAAO,MAAM,MAAM,gBAAU,CAAA;AAE7B,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAYlD;AAED,eAAO,MAAM,QAAQ,gBAAU,CAAA;AAE/B,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAYrD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAYhD;AAED,eAAO,MAAM,KAAK,gBAAU,CAAA"}

package/dist/TuplePathPattern.js

@@ -0,0 +1,69 @@
+export function format(tuple) {
+    return ("/" +
+        tuple
+            .map((el) => {
+            if (typeof el === "string")
+                return el;
+            if (Array.isArray(el[0]))
+                return "[[" + el[0][0] + "]]";
+            const [name, suffix, prefix] = el;
+            return (prefix ?? "") + "[" + name + "]" + (suffix ?? "");
+        })
+            .join("/"));
+}
+export function toColon(tuple) {
+    return ("/" +
+        tuple
+            .map((el) => {
+            if (typeof el === "string")
+                return el;
+            if (Array.isArray(el[0]))
+                return "*";
+            const [name, suffix, prefix] = el;
+            return (prefix ?? "") + ":" + name + (suffix ?? "");
+        })
+            .join("/"));
+}
+export const toHono = toColon;
+export function toExpress(tuple) {
+    return ("/" +
+        tuple
+            .map((el) => {
+            if (typeof el === "string")
+                return el;
+            if (Array.isArray(el[0]))
+                return "*" + el[0][0];
+            const [name, suffix, prefix] = el;
+            return (prefix ?? "") + ":" + name + (suffix ?? "");
+        })
+            .join("/"));
+}
+export const toEffect = toColon;
+export function toURLPattern(tuple) {
+    return ("/" +
+        tuple
+            .map((el) => {
+            if (typeof el === "string")
+                return el;
+            if (Array.isArray(el[0]))
+                return ":" + el[0][0] + "+";
+            const [name, suffix, prefix] = el;
+            return (prefix ?? "") + ":" + name + (suffix ?? "");
+        })
+            .join("/"));
+}
+export function toRemix(tuple) {
+    return ("/" +
+        tuple
+            .map((el) => {
+            if (typeof el === "string")
+                return el;
+            if (Array.isArray(el[0]))
+                return "$";
+            const [name, suffix, prefix] = el;
+            return (prefix ?? "") + "$" + name + (suffix ?? "");
+        })
+            .join("/"));
+}
+export const toBun = toColon;
+//# sourceMappingURL=TuplePathPattern.js.map

package/dist/TuplePathPattern.js.map

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

package/dist/Unique.d.ts

@@ -0,0 +1,68 @@
+export declare const ALPHABET_BASE32_CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+export declare const ALPHABET_BASE32_RFC4648 = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+export declare const ALPHABET_BASE64_URL = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+export declare const ALPHABET_HEX = "0123456789abcdef";
+interface SnowflakeState {
+    timestampMs: bigint;
+    sequence: bigint;
+}
+/**
+ * Generate a random string for ids, session tokens, and API keys.
+ * It uses human-friendly crockford base32 encoding (5 bit of entropy per char)
+ *
+ * Minimal recommended length:
+ * - public ids: 16 chars (~80 bits)
+ * - API keys: 32 chars (~160 bits)
+ * - session tokens: 32-40 chars (~160-200 bits)
+ */
+export declare function token(length?: number): string;
+export declare function bytes(length: number): Uint8Array;
+export declare const UUID_NIL = "00000000-0000-0000-0000-000000000000";
+export declare function uuid4(): string;
+export declare function uuid7(time?: number): string;
+/**
+ * Decode a 48-bit Unix timestamp (ms) from UUID7 or ULID.
+ *
+ * @example
+ * const bytes = Unique.uuid7Bytes()
+ * const timestamp = Unique.toTimestamp(bytes)
+ *
+ * @example
+ * const bytes = Unique.ulidBytes()
+ * const timestamp = Unique.toTimestamp(bytes)
+ */
+export declare function toTimestamp(bytes: Uint8Array): number;
+export declare function uuid7Bytes(time?: number): Uint8Array;
+/**
+ * Convert UUID bytes to canonical (RFC9562) representation.
+ *
+ * @example
+ * Unique.formatUuid(new Uint8Array(16))
+ */
+export declare function formatUuid(bytes: Uint8Array): string;
+export declare function ulid(time?: number): string;
+export declare function ulidBytes(time?: number): Uint8Array;
+/**
+ * Monotonic Snowflake variant:
+ * - 48-bit unix timestamp (ms)
+ * - 16-bit sequence
+ * - sequence resets on timestamp increment
+ * - over-capacity sequence carries into next millisecond
+ */
+export declare const snowflake: {
+    (): bigint;
+    readonly state: SnowflakeState;
+    readonly timestamp: (id: bigint) => bigint;
+};
+/**
+ * Generate a nanoid-style random string.
+ *
+ * FUN_FACT: Original nanoid implementation uses base64url alphabet
+ * with non-standard custom order where charater form common words found
+ * in source code (like use, random, strict) to make gzip/brotli more efficient.
+ * It's qt lil opt from the times where web developers
+ * were competing to have the smallest possible bundle size.
+ */
+export declare function nanoid(size?: number, alphabet?: string): string;
+export {};
+//# sourceMappingURL=Unique.d.ts.map

package/dist/Unique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Unique.d.ts","sourceRoot":"","sources":["../src/Unique.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,qCAAqC,CAAA;AAC3E,eAAO,MAAM,uBAAuB,qCAAqC,CAAA;AACzE,eAAO,MAAM,mBAAmB,qEACoC,CAAA;AACpE,eAAO,MAAM,YAAY,qBAAqB,CAAA;AAE9C,UAAU,cAAc;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB;AA+CD;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,MAAM,SAAK,GAAG,MAAM,CAYzC;AAED,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAIhD;AAED,eAAO,MAAM,QAAQ,yCAAyC,CAAA;AAE9D,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED,wBAAgB,KAAK,CAAC,IAAI,GAAE,MAAmB,GAAG,MAAM,CAEvD;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAWrD;AAED,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAAmB,GAAG,UAAU,CAqBhE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAcpD;AAED,wBAAgB,IAAI,CAAC,IAAI,GAAE,MAAmB,GAAG,MAAM,CAGtD;AAED,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAmB,GAAG,UAAU,CAc/D;AA8BD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;;CAAmB,CAAA;AAEzC;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,IAAI,SAAK,EAAE,QAAQ,SAAsB,GAAG,MAAM,CAkBxE"}