@mhbdev/redis 0.2.0

package/dist/queue/queue.d.ts

@@ -0,0 +1,78 @@
+import { type RedisCodec } from "../core/codec.js";
+import type { RedisExecutor } from "../core/executor.js";
+export type QueueJob<T> = Readonly<{
+    id: string;
+    data: T;
+    attempts: number;
+    enqueuedAt: number;
+}>;
+export type EnqueueOptions = Readonly<{
+    delayMs?: number;
+    jobId?: string;
+}>;
+export type QueueOptions<T> = Readonly<{
+    redis: RedisExecutor;
+    /** JSON is used by default. Provide a codec for binary or schema-validated jobs. */
+    codec?: RedisCodec<T>;
+    name: string;
+    prefix?: string;
+    maxAttempts?: number;
+    visibilityTimeoutMs?: number;
+}>;
+export type QueueWorkerOptions = Readonly<{
+    group?: string;
+    consumer?: string;
+    blockMs?: number;
+    concurrency?: number;
+}>;
+export interface JobQueue<T> {
+    enqueue(data: T, options?: EnqueueOptions): Promise<string>;
+    worker(handler: (job: QueueJob<T>) => Promise<void>, options?: QueueWorkerOptions): QueueWorker;
+    close?(): Promise<void>;
+}
+export interface QueueWorker {
+    start(): Promise<void>;
+    close(): Promise<void>;
+}
+export declare class RedisQueue<T> implements JobQueue<T> {
+    private readonly options;
+    private readonly prefix;
+    private readonly valueCodec;
+    private readonly maxAttempts;
+    private readonly visibilityTimeoutMs;
+    constructor(options: QueueOptions<T>);
+    enqueue(data: T, enqueueOptions?: EnqueueOptions): Promise<string>;
+    worker(handler: (job: QueueJob<T>) => Promise<void>, workerOptions?: QueueWorkerOptions): RedisQueueWorker<T>;
+    get streamKey(): string;
+    get delayedKey(): string;
+    get deadLetterKey(): string;
+    get codec(): RedisCodec<T>;
+    get redis(): RedisExecutor;
+    get attempts(): number;
+    get visibilityTimeout(): number;
+    private encode;
+    decode(value: string): QueueJob<T>;
+}
+export declare class RedisQueueWorker<T> implements QueueWorker {
+    private readonly queue;
+    private readonly handler;
+    private readonly group;
+    private readonly consumer;
+    private readonly blockMs;
+    private readonly concurrency;
+    private stopping;
+    private running;
+    constructor(queue: RedisQueue<T>, handler: (job: QueueJob<T>) => Promise<void>, options: QueueWorkerOptions);
+    start(): Promise<void>;
+    close(): Promise<void>;
+    private run;
+    private ensureGroup;
+    private promoteDue;
+    private recoverPending;
+    private process;
+    private encodeRetry;
+}
+export declare function createQueue<T>(options: QueueOptions<T>): RedisQueue<T>;
+/** A discoverable alias for applications that prefer Redis-prefixed factory names. */
+export declare const createRedisQueue: typeof createQueue;
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue/queue.d.ts.map

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

package/dist/queue/queue.js

@@ -0,0 +1,260 @@
+import { jsonCodec } from "../core/codec.js";
+import { RedisQueueError } from "../core/errors.js";
+export class RedisQueue {
+    options;
+    prefix;
+    valueCodec;
+    maxAttempts;
+    visibilityTimeoutMs;
+    constructor(options) {
+        this.options = options;
+        if (!options.name.trim())
+            throw new RedisQueueError("Queue name is required");
+        this.prefix = options.prefix ?? "mhbdev:queue";
+        this.valueCodec = options.codec ?? jsonCodec();
+        this.maxAttempts = options.maxAttempts ?? 3;
+        this.visibilityTimeoutMs = options.visibilityTimeoutMs ?? 30_000;
+        if (!Number.isSafeInteger(this.maxAttempts) || this.maxAttempts <= 0)
+            throw new RedisQueueError("Queue max attempts must be positive");
+    }
+    async enqueue(data, enqueueOptions = {}) {
+        const id = enqueueOptions.jobId ?? crypto.randomUUID();
+        const job = { id, data, attempts: 0, enqueuedAt: Date.now() };
+        const encoded = this.encode(job);
+        if ((enqueueOptions.delayMs ?? 0) > 0) {
+            await this.options.redis.execute([
+                "ZADD",
+                this.delayedKey,
+                String(Date.now() + (enqueueOptions.delayMs ?? 0)),
+                encoded,
+            ]);
+        }
+        else {
+            await this.options.redis.execute(["XADD", this.streamKey, "*", "payload", encoded]);
+        }
+        return id;
+    }
+    worker(handler, workerOptions = {}) {
+        return new RedisQueueWorker(this, handler, workerOptions);
+    }
+    get streamKey() {
+        return `${this.prefix}:${this.options.name}:stream`;
+    }
+    get delayedKey() {
+        return `${this.prefix}:${this.options.name}:delayed`;
+    }
+    get deadLetterKey() {
+        return `${this.prefix}:${this.options.name}:dead-letter`;
+    }
+    get codec() {
+        return this.valueCodec;
+    }
+    get redis() {
+        return this.options.redis;
+    }
+    get attempts() {
+        return this.maxAttempts;
+    }
+    get visibilityTimeout() {
+        return this.visibilityTimeoutMs;
+    }
+    encode(job) {
+        return JSON.stringify({
+            id: job.id,
+            data: this.valueCodec.encode(job.data),
+            attempts: job.attempts,
+            enqueuedAt: job.enqueuedAt,
+        });
+    }
+    decode(value) {
+        try {
+            const parsed = JSON.parse(value);
+            return {
+                id: parsed.id,
+                data: this.valueCodec.decode(parsed.data),
+                attempts: parsed.attempts,
+                enqueuedAt: parsed.enqueuedAt,
+            };
+        }
+        catch (error) {
+            throw new RedisQueueError("Unable to decode Redis queue job", error);
+        }
+    }
+}
+export class RedisQueueWorker {
+    queue;
+    handler;
+    group;
+    consumer;
+    blockMs;
+    concurrency;
+    stopping = false;
+    running = null;
+    constructor(queue, handler, options) {
+        this.queue = queue;
+        this.handler = handler;
+        this.group = options.group ?? "default";
+        this.consumer = options.consumer ?? crypto.randomUUID();
+        this.blockMs = options.blockMs ?? 1_000;
+        this.concurrency = options.concurrency ?? 1;
+        if (!Number.isSafeInteger(this.concurrency) || this.concurrency <= 0)
+            throw new RedisQueueError("Queue concurrency must be positive");
+    }
+    async start() {
+        if (this.running)
+            return this.running;
+        this.stopping = false;
+        this.running = this.run().finally(() => {
+            this.running = null;
+        });
+        return this.running;
+    }
+    async close() {
+        this.stopping = true;
+        await this.running;
+    }
+    async run() {
+        await this.ensureGroup();
+        while (!this.stopping) {
+            await this.promoteDue();
+            const recovered = await this.recoverPending();
+            if (recovered.length) {
+                await Promise.all(recovered.map((entry) => this.process(entry)));
+                continue;
+            }
+            const response = await this.queue.redis.execute([
+                "XREADGROUP",
+                "GROUP",
+                this.group,
+                this.consumer,
+                "COUNT",
+                String(this.concurrency),
+                "BLOCK",
+                String(this.blockMs),
+                "STREAMS",
+                this.queue.streamKey,
+                ">",
+            ]);
+            const entries = parseStreamResponse(response);
+            await Promise.all(entries.map((entry) => this.process(entry)));
+        }
+    }
+    async ensureGroup() {
+        await this.queue.redis.eval(ENSURE_GROUP_SCRIPT, {
+            keys: [this.queue.streamKey],
+            arguments: [this.group],
+        });
+    }
+    async promoteDue() {
+        const due = await this.queue.redis.execute([
+            "ZRANGEBYSCORE",
+            this.queue.delayedKey,
+            "-inf",
+            String(Date.now()),
+            "LIMIT",
+            "0",
+            "100",
+        ]);
+        for (const encoded of due ?? []) {
+            await this.queue.redis.execute(["ZREM", this.queue.delayedKey, encoded]);
+            await this.queue.redis.execute([
+                "XADD",
+                this.queue.streamKey,
+                "*",
+                "payload",
+                encoded,
+            ]);
+        }
+    }
+    async recoverPending() {
+        const response = await this.queue.redis.execute([
+            "XAUTOCLAIM",
+            this.queue.streamKey,
+            this.group,
+            this.consumer,
+            String(this.queue.visibilityTimeout),
+            "0-0",
+            "COUNT",
+            String(this.concurrency),
+        ]);
+        return parseAutoClaimResponse(response);
+    }
+    async process(entry) {
+        const job = this.queue.decode(entry.payload);
+        try {
+            await this.handler(job);
+            await this.queue.redis.execute([
+                "XACK",
+                this.queue.streamKey,
+                this.group,
+                entry.id,
+            ]);
+        }
+        catch (_error) {
+            await this.queue.redis.execute([
+                "XACK",
+                this.queue.streamKey,
+                this.group,
+                entry.id,
+            ]);
+            if (job.attempts + 1 >= this.queue.attempts) {
+                await this.queue.redis.execute([
+                    "XADD",
+                    this.queue.deadLetterKey,
+                    "*",
+                    "payload",
+                    this.encodeRetry(job),
+                ]);
+                return;
+            }
+            const retry = { ...job, attempts: job.attempts + 1 };
+            await this.queue.redis.execute([
+                "XADD",
+                this.queue.streamKey,
+                "*",
+                "payload",
+                this.encodeRetry(retry),
+            ]);
+        }
+    }
+    encodeRetry(job) {
+        return JSON.stringify({
+            id: job.id,
+            data: this.queue.codec.encode(job.data),
+            attempts: job.attempts,
+            enqueuedAt: job.enqueuedAt,
+        });
+    }
+}
+const ENSURE_GROUP_SCRIPT = `local groups = redis.pcall("XINFO", "GROUPS", KEYS[1]) if type(groups) == "table" then for _, group in ipairs(groups) do if group[2] == ARGV[1] then return 0 end end end local result = redis.pcall("XGROUP", "CREATE", KEYS[1], ARGV[1], "0-0", "MKSTREAM") if type(result) == "table" then return 1 end local groupsAfter = redis.pcall("XINFO", "GROUPS", KEYS[1]) if type(groupsAfter) == "table" then for _, group in ipairs(groupsAfter) do if group[2] == ARGV[1] then return 0 end end end return redis.error_reply("Redis consumer group creation failed")`;
+function parseStreamResponse(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        return [];
+    const streams = value[0];
+    if (!Array.isArray(streams) || !Array.isArray(streams[1]))
+        return [];
+    const result = [];
+    for (const rawEntry of streams[1]) {
+        if (!Array.isArray(rawEntry) ||
+            typeof rawEntry[0] !== "string" ||
+            !Array.isArray(rawEntry[1]))
+            continue;
+        const fields = rawEntry[1];
+        const payloadIndex = fields.indexOf("payload");
+        const payload = payloadIndex >= 0 ? fields[payloadIndex + 1] : undefined;
+        if (typeof payload === "string")
+            result.push({ id: rawEntry[0], payload });
+    }
+    return result;
+}
+function parseAutoClaimResponse(value) {
+    if (!Array.isArray(value) || !Array.isArray(value[1]))
+        return [];
+    return parseStreamResponse([["recovered", value[1]]]);
+}
+export function createQueue(options) {
+    return new RedisQueue(options);
+}
+/** A discoverable alias for applications that prefer Redis-prefixed factory names. */
+export const createRedisQueue = createQueue;
+//# sourceMappingURL=queue.js.map

package/dist/queue/queue.js.map

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

package/dist/rate-limit/contracts.d.ts

@@ -0,0 +1,93 @@
+import { type RedisExecutor } from "../core/executor.js";
+export type RateLimitFailureMode = "open" | "closed";
+export type RateLimitReason = "limit" | "cache" | "timeout" | "redis" | "success";
+export type RateLimitAlgorithm = Readonly<{
+    kind: "fixed-window" | "sliding-window" | "token-bucket";
+    limit: number;
+    windowMs: number;
+    maxTokens?: number;
+    refillRate?: number;
+}>;
+export type RateLimitPolicy = Readonly<{
+    name: string;
+    maxRequests: number;
+    windowMs: number;
+    failureMode: RateLimitFailureMode;
+}>;
+export type RateLimitRequest = Readonly<{
+    rate?: number;
+}>;
+export type RateLimitResponse = Readonly<{
+    success: boolean;
+    allowed: boolean;
+    limit: number;
+    remaining: number;
+    reset: number;
+    resetAt: Date;
+    retryAfterMs: number;
+    reason: RateLimitReason;
+    pending: Promise<void>;
+}>;
+export type RateLimitResult = Readonly<{
+    allowed: boolean;
+    limit: number;
+    remaining: number;
+    resetAt: Date;
+}>;
+export type RateLimitAnalyticsEvent = Readonly<{
+    identifier: string;
+    algorithm: RateLimitAlgorithm["kind"];
+    allowed: boolean;
+    limit: number;
+    remaining: number;
+    timestamp: number;
+}>;
+export interface RateLimitAnalyticsSink {
+    record(event: RateLimitAnalyticsEvent): void | Promise<void>;
+}
+export type RateLimiterOptions = Readonly<{
+    redis: RedisExecutor;
+    prefix?: string;
+    timeoutMs?: number;
+    failureMode?: RateLimitFailureMode;
+    ephemeralCache?: boolean | Map<string, number>;
+    analytics?: RateLimitAnalyticsSink;
+    dynamicLimits?: boolean;
+    now?: () => number;
+}>;
+export interface RateLimiter {
+    limit(identifier: string, request?: RateLimitRequest): Promise<RateLimitResponse>;
+    check(identity: string, policy: RateLimitPolicy): Promise<RateLimitResult>;
+    getRemaining(identifier: string): Promise<Pick<RateLimitResponse, "remaining" | "reset" | "resetAt">>;
+    reset(identifier: string): Promise<void>;
+    blockUntilReady(identifier: string, timeoutMs: number, request?: RateLimitRequest): Promise<RateLimitResponse>;
+    setDynamicLimit(limit: number | false): Promise<void>;
+    getDynamicLimit(): Promise<number | null>;
+}
+export declare function fixedWindow(limit: number, windowMs: number): RateLimitAlgorithm;
+export declare function slidingWindow(limit: number, windowMs: number): RateLimitAlgorithm;
+export declare function tokenBucket(refillRate: number, windowMs: number, maxTokens: number): RateLimitAlgorithm;
+export declare function createRateLimiter(algorithm: RateLimitAlgorithm, options: RateLimiterOptions): RateLimiter;
+/** A discoverable alias for applications that prefer Redis-prefixed factory names. */
+export declare const createRedisRateLimiter: typeof createRateLimiter;
+export declare class RedisRateLimiter implements RateLimiter {
+    private readonly algorithm;
+    private readonly options;
+    private readonly prefix;
+    private readonly timeoutMs;
+    private readonly failureMode;
+    private readonly cache;
+    private readonly now;
+    constructor(algorithm: RateLimitAlgorithm, options: RateLimiterOptions);
+    limit(identifier: string, request?: RateLimitRequest): Promise<RateLimitResponse>;
+    check(identity: string, policy: RateLimitPolicy): Promise<RateLimitResult>;
+    getRemaining(identifier: string): Promise<Pick<RateLimitResponse, "remaining" | "reset" | "resetAt">>;
+    reset(identifier: string): Promise<void>;
+    blockUntilReady(identifier: string, timeoutMs: number, request?: RateLimitRequest): Promise<RateLimitResponse>;
+    setDynamicLimit(limit: number | false): Promise<void>;
+    getDynamicLimit(): Promise<number | null>;
+    private runAlgorithm;
+    private keysFor;
+    private response;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/rate-limit/contracts.d.ts.map

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