alchemy 2.0.0-beta.73 → 2.0.0-beta.75

package/lib/Redis/Protocol.js

@@ -0,0 +1,276 @@
+import * as Effect from "effect/Effect";
+import * as Queue from "effect/Queue";
+import * as Scope from "effect/Scope";
+import * as Semaphore from "effect/Semaphore";
+import { CommandError, ProtocolError } from "./Errors.js";
+import { encodeCommand, Parser } from "./Resp.js";
+export const DEFAULT_PORT = 6379;
+export const TLS_PORT = 6380;
+/** Parse a `redis://` or `rediss://` URL. */
+export const parseUrl = (url) => {
+    const parsed = new URL(url);
+    const tls = parsed.protocol === "rediss:";
+    const path = parsed.pathname.startsWith("/")
+        ? parsed.pathname.slice(1)
+        : parsed.pathname;
+    const dbRaw = path.length === 0 ? undefined : Number(path);
+    return {
+        hostname: parsed.hostname,
+        port: Number(parsed.port || (tls ? TLS_PORT : DEFAULT_PORT)),
+        tls,
+        username: decodeURIComponent(parsed.username),
+        password: decodeURIComponent(parsed.password),
+        db: dbRaw !== undefined && Number.isInteger(dbRaw) && dbRaw >= 0
+            ? dbRaw
+            : undefined,
+    };
+};
+/** Build a `redis://` URL. Encodes the password. Used by tests and TcpProxy. */
+export const connectionUrl = (input) => {
+    const username = input.username ?? "default";
+    const scheme = input.tls ? "rediss" : "redis";
+    const db = input.db !== undefined ? `/${input.db}` : "";
+    return `${scheme}://${username}:${encodeURIComponent(input.password)}@${input.host}:${input.port}${db}`;
+};
+const commandError = (command, cause) => cause instanceof CommandError
+    ? new CommandError({ command, cause: cause.cause })
+    : new CommandError({ command, cause });
+const asBytes = (data) => new Uint8Array(data);
+const writeSocket = (socket, bytes) => {
+    const written = socket.write(bytes);
+    if (typeof written === "object" && written !== null && "then" in written) {
+        return Effect.tryPromise({
+            try: () => Promise.resolve(written),
+            catch: (cause) => commandError("WRITE", cause),
+        }).pipe(Effect.asVoid);
+    }
+    return Effect.void;
+};
+const openBun = (options, events) => Effect.callback((resume, signal) => {
+    let settled = false;
+    let socket;
+    const succeed = (value) => {
+        if (settled)
+            return;
+        settled = true;
+        resume(Effect.succeed(value));
+    };
+    const fail = (cause) => {
+        if (settled) {
+            Queue.offerUnsafe(events, { _tag: "Fail", cause });
+            return;
+        }
+        settled = true;
+        resume(Effect.fail(commandError("CONNECT", cause)));
+    };
+    const Client = globalThis
+        .Bun;
+    if (Client === undefined) {
+        fail(new Error("Bun.connect is not available"));
+        return;
+    }
+    Client.connect({
+        hostname: options.hostname,
+        port: options.port,
+        tls: options.tls,
+        socket: {
+            binaryType: "uint8array",
+            open: (opened) => {
+                socket = opened;
+                succeed(opened);
+            },
+            data: (_opened, chunk) => {
+                Queue.offerUnsafe(events, {
+                    _tag: "Data",
+                    bytes: asBytes(chunk),
+                });
+            },
+            error: (_opened, cause) => fail(cause),
+            connectError: (_opened, cause) => fail(cause),
+            close: () => {
+                Queue.offerUnsafe(events, { _tag: "End" });
+            },
+            end: () => {
+                Queue.offerUnsafe(events, { _tag: "End" });
+            },
+        },
+    }).catch(fail);
+    const abort = () => {
+        socket?.end();
+    };
+    signal.addEventListener("abort", abort, { once: true });
+    return Effect.sync(() => {
+        signal.removeEventListener("abort", abort);
+        abort();
+    });
+});
+const openNode = (options, events) => Effect.callback((resume, signal) => {
+    let settled = false;
+    let socket;
+    const succeed = (value) => {
+        if (settled)
+            return;
+        settled = true;
+        resume(Effect.succeed(value));
+    };
+    const fail = (cause) => {
+        if (settled) {
+            Queue.offerUnsafe(events, { _tag: "Fail", cause });
+            return;
+        }
+        settled = true;
+        resume(Effect.fail(commandError("CONNECT", cause)));
+    };
+    const attach = (nodeSocket, ready) => {
+        socket = nodeSocket;
+        nodeSocket.on(ready, () => succeed({
+            write: (bytes) => {
+                nodeSocket.write(bytes);
+                return bytes.length;
+            },
+            end: () => {
+                nodeSocket.end();
+            },
+        }));
+        nodeSocket.on("data", (chunk) => {
+            Queue.offerUnsafe(events, { _tag: "Data", bytes: asBytes(chunk) });
+        });
+        nodeSocket.on("error", fail);
+        nodeSocket.on("close", () => {
+            Queue.offerUnsafe(events, { _tag: "End" });
+        });
+    };
+    const start = options.tls
+        ? import("node:tls").then((tls) => attach(tls.connect({
+            host: options.hostname,
+            port: options.port,
+            servername: options.hostname,
+        }), "secureConnect"))
+        : import("node:net").then((net) => attach(net.connect({ host: options.hostname, port: options.port }), "connect"));
+    start.catch(fail);
+    const abort = () => {
+        socket?.end();
+    };
+    signal.addEventListener("abort", abort, { once: true });
+    return Effect.sync(() => {
+        signal.removeEventListener("abort", abort);
+        abort();
+    });
+});
+const openRaw = (options, events) => typeof Bun !== "undefined"
+    ? openBun(options, events)
+    : openNode(options, events);
+const unwrap = (frame, command) => {
+    if (frame._tag === "Protocol") {
+        return Effect.fail(commandError(command, frame.error));
+    }
+    if (frame._tag === "Error") {
+        return Effect.fail(commandError(command, frame.error));
+    }
+    if (frame._tag === "Push") {
+        return Effect.succeed(frame.value);
+    }
+    return Effect.succeed(frame.value);
+};
+const expectStatus = (reply, command) => {
+    if (typeof reply === "string" && reply.toUpperCase() === "OK") {
+        return Effect.void;
+    }
+    return Effect.fail(commandError(command, new ProtocolError({ message: `expected OK, got ${String(reply)}` })));
+};
+const readReplies = (events, parser, count, command) => Effect.gen(function* () {
+    const replies = [];
+    while (replies.length < count) {
+        const event = yield* Queue.take(events);
+        if (event._tag === "Fail") {
+            return yield* Effect.fail(commandError(command, event.cause));
+        }
+        if (event._tag === "End") {
+            return yield* Effect.fail(commandError(command, new ProtocolError({ message: "connection closed" })));
+        }
+        parser.push(event.bytes);
+        while (replies.length < count) {
+            const frame = parser.next();
+            if (frame._tag === "Incomplete")
+                break;
+            if (frame._tag === "Push")
+                continue;
+            replies.push(yield* unwrap(frame, command));
+        }
+    }
+    return replies;
+});
+/**
+ * Open an authenticated Redis session. Closes when the ambient Scope
+ * is released. Concurrent `send`/`pipeline` calls on one connection
+ * are serialized so replies stay ordered.
+ */
+export const connect = (url) => Effect.gen(function* () {
+    const options = yield* Effect.try({
+        try: () => parseUrl(url),
+        catch: (cause) => commandError("CONNECT", cause),
+    });
+    const events = yield* Queue.unbounded();
+    const socket = yield* Effect.acquireRelease(openRaw(options, events), (opened) => Effect.sync(() => {
+        opened.end();
+    }).pipe(Effect.flatMap(() => Queue.shutdown(events)), Effect.asVoid));
+    const parser = new Parser();
+    const lock = yield* Semaphore.make(1);
+    const request = (payload, count, command) => lock.withPermit(Effect.gen(function* () {
+        yield* writeSocket(socket, payload);
+        return yield* readReplies(events, parser, count, command);
+    }));
+    if (options.password.length > 0) {
+        const authArgs = options.username.length > 0 && options.username !== "default"
+            ? [options.username, options.password]
+            : [options.password];
+        const replies = yield* request(encodeCommand("AUTH", authArgs), 1, "AUTH");
+        yield* expectStatus(replies[0] ?? null, "AUTH");
+    }
+    if (options.db !== undefined && options.db !== 0) {
+        const replies = yield* request(encodeCommand("SELECT", [options.db]), 1, "SELECT");
+        yield* expectStatus(replies[0] ?? null, "SELECT");
+    }
+    return {
+        send: (command, args = []) => request(encodeCommand(command, args), 1, command).pipe(Effect.map((replies) => replies[0] ?? null)),
+        pipeline: (commands) => {
+            if (commands.length === 0)
+                return Effect.succeed([]);
+            const chunks = commands.map(([name, ...args]) => encodeCommand(name, args));
+            let total = 0;
+            for (const chunk of chunks)
+                total += chunk.length;
+            const payload = new Uint8Array(total);
+            let offset = 0;
+            for (const chunk of chunks) {
+                payload.set(chunk, offset);
+                offset += chunk.length;
+            }
+            return request(payload, commands.length, commands[0]?.[0] ?? "PIPELINE");
+        },
+    };
+});
+const scoped = (command, effect) => Effect.scoped(effect).pipe(Effect.mapError((error) => commandError(command, error)));
+/**
+ * Send one Redis command over RESP and close the connection.
+ */
+export const run = (url, command, args = []) => scoped(command, Effect.gen(function* () {
+    const connection = yield* connect(url);
+    return yield* connection.send(command, args);
+}));
+/**
+ * Pipeline several commands on one connection, then close it.
+ */
+export const pipeline = (url, commands) => scoped(commands[0]?.[0] ?? "PIPELINE", Effect.gen(function* () {
+    const connection = yield* connect(url);
+    return yield* connection.pipeline(commands);
+}));
+export const command = (url, name, args = []) => Effect.gen(function* () {
+    const resolved = yield* url;
+    return yield* run(resolved, name, args);
+});
+export const commandPipeline = (url, commands) => Effect.gen(function* () {
+    const resolved = yield* url;
+    return yield* pipeline(resolved, commands);
+});
+//# sourceMappingURL=Protocol.js.map

package/lib/Redis/Protocol.js.map

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

package/lib/Redis/Resp.d.ts

@@ -0,0 +1,65 @@
+/**
+ * RESP2 + RESP3 codec. Commands are encoded as arrays of bulk strings.
+ * Replies are parsed with a length-prefixed recursive reader so values
+ * may contain CR/LF/`$`/`*` and may arrive split across TCP frames.
+ *
+ * Spec: https://github.com/redis/redis-specifications/blob/master/protocol/RESP2.md
+ * Algorithm: the same as NodeRedis/node-redis-parser, reimplemented here
+ * so alchemy does not take a Redis client dependency.
+ */
+import { ProtocolError, ReplyError } from "./Errors.ts";
+export type Arg = string | number | Uint8Array;
+/**
+ * A decoded RESP value. Nested errors stay as {@link ReplyError} values
+ * (arrays may contain them). Top-level errors fail the command.
+ */
+export type Reply = string | number | boolean | bigint | null | ReplyError | readonly Reply[] | {
+    readonly [key: string]: Reply;
+};
+export type ParseResult = {
+    readonly _tag: "Incomplete";
+} | {
+    readonly _tag: "Reply";
+    readonly value: Reply;
+} | {
+    readonly _tag: "Error";
+    readonly error: ReplyError;
+} | {
+    readonly _tag: "Push";
+    readonly value: readonly Reply[];
+} | {
+    readonly _tag: "Protocol";
+    readonly error: ProtocolError;
+};
+export declare const Incomplete: Extract<ParseResult, {
+    _tag: "Incomplete";
+}>;
+export declare const encodeSimpleString: (value: string) => Uint8Array;
+export declare const encodeError: (value: string) => Uint8Array;
+export declare const encodeInteger: (value: number | bigint) => Uint8Array;
+export declare const encodeBoolean: (value: boolean) => Uint8Array;
+export declare const encodeDouble: (value: number) => Uint8Array;
+export declare const encodeBigNumber: (value: bigint) => Uint8Array;
+export declare const encodeNull: () => Uint8Array;
+export declare const encodeNullArray: () => Uint8Array;
+export declare const encodeBulk: (value: string | Uint8Array) => Uint8Array;
+export declare const encodeArray: (items: readonly Uint8Array[]) => Uint8Array;
+/** Encode a client command as a RESP array of bulk strings. */
+export declare const encodeCommand: (command: string, args?: readonly Arg[]) => Uint8Array;
+export declare const encodeReply: (value: Reply) => Uint8Array;
+/**
+ * Incremental RESP parser. Feed TCP chunks with {@link Parser.push} and
+ * pull complete frames with {@link Parser.next}.
+ */
+export declare class Parser {
+    #private;
+    push(chunk: Uint8Array): void;
+    /** Unparsed bytes still buffered. */
+    get pending(): number;
+    next(): ParseResult;
+}
+/** Parse one complete frame. Incomplete or leftover bytes are protocol errors. */
+export declare const decode: (bytes: Uint8Array | string) => ParseResult;
+/** Parse every complete frame in `bytes`. Trailing incomplete data errors. */
+export declare const decodeAll: (bytes: Uint8Array | string) => ParseResult[];
+//# sourceMappingURL=Resp.d.ts.map

package/lib/Redis/Resp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resp.d.ts","sourceRoot":"","sources":["../../src/Redis/Resp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,KAAK,GACb,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,IAAI,GACJ,UAAU,GACV,SAAS,KAAK,EAAE,GAChB;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,CAAC;AAEtC,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,KAAK,EAAE,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAgCjE,eAAO,MAAM,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAEnE,CAAC;AAsBF,eAAO,MAAM,kBAAkB,UAAW,MAAM,KAAG,UACb,CAAC;AAEvC,eAAO,MAAM,WAAW,UAAW,MAAM,KAAG,UACN,CAAC;AAEvC,eAAO,MAAM,aAAa,UAAW,MAAM,GAAG,MAAM,KAAG,UACjB,CAAC;AAEvC,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,UACT,CAAC;AAEvC,eAAO,MAAM,YAAY,UAAW,MAAM,KAAG,UAK5C,CAAC;AAEF,eAAO,MAAM,eAAe,UAAW,MAAM,KAAG,UACV,CAAC;AAEvC,eAAO,MAAM,UAAU,QAAO,UAAgC,CAAC;AAE/D,eAAO,MAAM,eAAe,QAAO,UAAgC,CAAC;AAEpE,eAAO,MAAM,UAAU,UAAW,MAAM,GAAG,UAAU,KAAG,UAGvD,CAAC;AAEF,eAAO,MAAM,WAAW,UAAW,SAAS,UAAU,EAAE,KAAG,UACN,CAAC;AAEtD,+DAA+D;AAC/D,eAAO,MAAM,aAAa,YACf,MAAM,SACT,SAAS,GAAG,EAAE,KACnB,UAOF,CAAC;AAEF,eAAO,MAAM,WAAW,UAAW,KAAK,KAAG,UA0B1C,CAAC;AAyYF;;;GAGG;AACH,qBAAa,MAAM;;IAIjB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAa5B;IAaD,qCAAqC;IACrC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,IAAI,WAAW,CAYlB;CACF;AAED,kFAAkF;AAClF,eAAO,MAAM,MAAM,UAAW,UAAU,GAAG,MAAM,KAAG,WAkBnD,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,SAAS,UAAW,UAAU,GAAG,MAAM,KAAG,WAAW,EAmBjE,CAAC"}