semola 0.5.1 → 0.5.3

package/dist/lib/pubsub/index.d.mts

@@ -0,0 +1,36 @@
+import { MessageHandler, PubSubOptions } from "../../pubsub/types.mjs";
+
+//#region src/lib/pubsub/index.d.ts
+declare class PubSub<T extends Record<string, unknown>> {
+  private options;
+  private isSubscribed;
+  private nextHandlerId;
+  private handlers;
+  private unsubscribeInFlight;
+  private subscribeInFlight;
+  constructor(options: PubSubOptions);
+  private onMessage;
+  private unsubscribeHandler;
+  publish(message: T): Promise<readonly [{
+    readonly type: "SerializationError";
+    readonly message: string;
+  }, null] | readonly [{
+    readonly type: "PublishError";
+    readonly message: string;
+  }, null] | readonly [null, number]>;
+  subscribe(handler: MessageHandler<T>): Promise<readonly [null, () => Promise<readonly [{
+    readonly type: "UnsubscribeError";
+    readonly message: string;
+  }, null] | readonly [null, boolean]>] | readonly [{
+    readonly type: "SubscribeError";
+    readonly message: string;
+  }, null]>;
+  unsubscribe(): Promise<readonly [{
+    readonly type: "UnsubscribeError";
+    readonly message: string;
+  }, null] | readonly [null, boolean]>;
+  isActive(): boolean;
+}
+//#endregion
+export { PubSub };
+//# sourceMappingURL=index.d.mts.map

package/dist/lib/pubsub/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/lib/pubsub/index.ts"],"mappings":";;;cAGa,MAAA,WAAiB,MAAA;EAAA,QACpB,OAAA;EAAA,QACA,YAAA;EAAA,QACA,aAAA;EAAA,QACA,QAAA;EAAA,QACA,mBAAA;EAAA,QAGA,iBAAA;cAIW,OAAA,EAAS,aAAA;EAAA,QAId,SAAA;EAAA,QAaA,kBAAA;EAuDD,OAAA,CAAQ,OAAA,EAAS,CAAA,GAAC,OAAA;IAAA;;;;;;EAuBlB,SAAA,CAAU,OAAA,EAAS,cAAA,CAAe,CAAA,IAAE,OAAA,uBAAA,OAAA;IAAA;;;;;;EA8EpC,WAAA,CAAA,GAAW,OAAA;IAAA;;;EAmDjB,QAAA,CAAA;AAAA"}

package/dist/lib/pubsub/index.mjs

@@ -0,0 +1,118 @@
+import { err, mightThrow, mightThrowSync, ok } from "../errors/index.mjs";
+//#region src/lib/pubsub/index.ts
+var PubSub = class {
+	options;
+	isSubscribed = false;
+	nextHandlerId = 0;
+	handlers = /* @__PURE__ */ new Map();
+	unsubscribeInFlight = null;
+	subscribeInFlight = null;
+	constructor(options) {
+		this.options = options;
+	}
+	async onMessage(message, channel) {
+		const [parseError, parsed] = mightThrowSync(() => JSON.parse(message));
+		if (parseError) return;
+		if (!parsed) return;
+		const handlers = Array.from(this.handlers.values());
+		for (const handler of handlers) await mightThrow(Promise.resolve().then(() => handler(parsed, channel)));
+	}
+	async unsubscribeHandler(handlerId) {
+		const inFlightUnsubscribe = this.unsubscribeInFlight;
+		if (inFlightUnsubscribe) await inFlightUnsubscribe;
+		const handler = this.handlers.get(handlerId);
+		if (!handler) return err("UnsubscribeError", "Not subscribed");
+		this.handlers.delete(handlerId);
+		if (this.handlers.size > 0) return ok(true);
+		this.isSubscribed = false;
+		this.unsubscribeInFlight = mightThrow(this.options.subscriber.unsubscribe(this.options.channel));
+		const unsubscribeInFlight = this.unsubscribeInFlight;
+		if (!unsubscribeInFlight) {
+			this.handlers.set(handlerId, handler);
+			this.isSubscribed = true;
+			return err("UnsubscribeError", `Unable to unsubscribe from ${this.options.channel}`);
+		}
+		const [unsubscribeError] = await unsubscribeInFlight;
+		if (unsubscribeError) {
+			this.handlers.set(handlerId, handler);
+			this.isSubscribed = true;
+			this.unsubscribeInFlight = null;
+			return err("UnsubscribeError", `Unable to unsubscribe from ${this.options.channel}`);
+		}
+		this.unsubscribeInFlight = null;
+		return ok(true);
+	}
+	async publish(message) {
+		const [stringifyError, stringified] = mightThrowSync(() => JSON.stringify(message));
+		if (stringifyError || !stringified) return err("SerializationError", "Unable to serialize message");
+		const [publishError, count] = await mightThrow(this.options.publisher.publish(this.options.channel, stringified));
+		if (publishError) return err("PublishError", `Unable to publish to ${this.options.channel}`);
+		return ok(count);
+	}
+	async subscribe(handler) {
+		const inFlightUnsubscribe = this.unsubscribeInFlight;
+		if (inFlightUnsubscribe) await inFlightUnsubscribe;
+		const handlerId = this.nextHandlerId;
+		this.nextHandlerId += 1;
+		this.handlers.set(handlerId, handler);
+		if (this.isActive()) return ok(() => this.unsubscribeHandler(handlerId));
+		const inFlightSubscribe = this.subscribeInFlight;
+		if (inFlightSubscribe) {
+			const [inFlightError] = await inFlightSubscribe;
+			if (inFlightError || !this.isSubscribed) {
+				this.handlers.delete(handlerId);
+				return err("SubscribeError", `Unable to subscribe to ${this.options.channel}`);
+			}
+			return ok(() => this.unsubscribeHandler(handlerId));
+		}
+		this.subscribeInFlight = mightThrow(this.options.subscriber.subscribe(this.options.channel, async (message, channel) => this.onMessage(message, channel)));
+		const subscribeInFlight = this.subscribeInFlight;
+		if (!subscribeInFlight) {
+			this.handlers.delete(handlerId);
+			return err("SubscribeError", `Unable to subscribe to ${this.options.channel}`);
+		}
+		const [subscribeError, count] = await subscribeInFlight;
+		this.subscribeInFlight = null;
+		if (subscribeError) {
+			this.handlers.delete(handlerId);
+			return err("SubscribeError", `Unable to subscribe to ${this.options.channel}`);
+		}
+		if (!count) {
+			this.handlers.delete(handlerId);
+			return err("SubscribeError", `Unable to subscribe to ${this.options.channel}`);
+		}
+		this.isSubscribed = true;
+		return ok(() => this.unsubscribeHandler(handlerId));
+	}
+	async unsubscribe() {
+		const inFlightUnsubscribe = this.unsubscribeInFlight;
+		if (inFlightUnsubscribe) await inFlightUnsubscribe;
+		if (!this.isActive()) return err("UnsubscribeError", "Not subscribed");
+		const handlers = new Map(this.handlers);
+		this.handlers.clear();
+		this.isSubscribed = false;
+		this.unsubscribeInFlight = mightThrow(this.options.subscriber.unsubscribe(this.options.channel));
+		const unsubscribeInFlight = this.unsubscribeInFlight;
+		if (!unsubscribeInFlight) {
+			this.handlers = handlers;
+			this.isSubscribed = true;
+			return err("UnsubscribeError", `Unable to unsubscribe from ${this.options.channel}`);
+		}
+		const [unsubscribeError] = await unsubscribeInFlight;
+		if (unsubscribeError) {
+			this.handlers = handlers;
+			this.isSubscribed = true;
+			this.unsubscribeInFlight = null;
+			return err("UnsubscribeError", `Unable to unsubscribe from ${this.options.channel}`);
+		}
+		this.unsubscribeInFlight = null;
+		return ok(true);
+	}
+	isActive() {
+		return this.handlers.size > 0 && this.isSubscribed;
+	}
+};
+//#endregion
+export { PubSub };
+
+//# sourceMappingURL=index.mjs.map

package/dist/lib/pubsub/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/lib/pubsub/index.ts"],"sourcesContent":["import { err, mightThrow, mightThrowSync, ok } from \"../errors/index.js\";\nimport type { MessageHandler, PubSubOptions } from \"./types.js\";\n\nexport class PubSub<T extends Record<string, unknown>> {\n  private options: PubSubOptions;\n  private isSubscribed = false;\n  private nextHandlerId = 0;\n  private handlers = new Map<number, MessageHandler<T>>();\n  private unsubscribeInFlight: Promise<\n    readonly [null, unknown] | readonly [unknown, null]\n  > | null = null;\n  private subscribeInFlight: Promise<\n    readonly [null, number] | readonly [unknown, null]\n  > | null = null;\n\n  public constructor(options: PubSubOptions) {\n    this.options = options;\n  }\n\n  private async onMessage(message: string, channel: string) {\n    const [parseError, parsed] = mightThrowSync<T>(() => JSON.parse(message));\n\n    if (parseError) return;\n    if (!parsed) return;\n\n    const handlers = Array.from(this.handlers.values());\n\n    for (const handler of handlers) {\n      await mightThrow(Promise.resolve().then(() => handler(parsed, channel)));\n    }\n  }\n\n  private async unsubscribeHandler(handlerId: number) {\n    const inFlightUnsubscribe = this.unsubscribeInFlight;\n\n    if (inFlightUnsubscribe) {\n      await inFlightUnsubscribe;\n    }\n\n    const handler = this.handlers.get(handlerId);\n\n    if (!handler) {\n      return err(\"UnsubscribeError\", \"Not subscribed\");\n    }\n\n    this.handlers.delete(handlerId);\n\n    if (this.handlers.size > 0) {\n      return ok(true);\n    }\n\n    this.isSubscribed = false;\n\n    this.unsubscribeInFlight = mightThrow(\n      this.options.subscriber.unsubscribe(this.options.channel),\n    );\n\n    const unsubscribeInFlight = this.unsubscribeInFlight;\n\n    if (!unsubscribeInFlight) {\n      this.handlers.set(handlerId, handler);\n      this.isSubscribed = true;\n\n      return err(\n        \"UnsubscribeError\",\n        `Unable to unsubscribe from ${this.options.channel}`,\n      );\n    }\n\n    const [unsubscribeError] = await unsubscribeInFlight;\n\n    if (unsubscribeError) {\n      this.handlers.set(handlerId, handler);\n      this.isSubscribed = true;\n      this.unsubscribeInFlight = null;\n\n      return err(\n        \"UnsubscribeError\",\n        `Unable to unsubscribe from ${this.options.channel}`,\n      );\n    }\n\n    this.unsubscribeInFlight = null;\n\n    return ok(true);\n  }\n\n  public async publish(message: T) {\n    const [stringifyError, stringified] = mightThrowSync(() =>\n      JSON.stringify(message),\n    );\n\n    if (stringifyError || !stringified) {\n      return err(\"SerializationError\", \"Unable to serialize message\");\n    }\n\n    const [publishError, count] = await mightThrow(\n      this.options.publisher.publish(this.options.channel, stringified),\n    );\n\n    if (publishError) {\n      return err(\n        \"PublishError\",\n        `Unable to publish to ${this.options.channel}`,\n      );\n    }\n\n    return ok(count);\n  }\n\n  public async subscribe(handler: MessageHandler<T>) {\n    const inFlightUnsubscribe = this.unsubscribeInFlight;\n\n    if (inFlightUnsubscribe) {\n      await inFlightUnsubscribe;\n    }\n\n    const handlerId = this.nextHandlerId;\n\n    this.nextHandlerId += 1;\n    this.handlers.set(handlerId, handler);\n\n    if (this.isActive()) {\n      return ok(() => this.unsubscribeHandler(handlerId));\n    }\n\n    const inFlightSubscribe = this.subscribeInFlight;\n\n    if (inFlightSubscribe) {\n      const [inFlightError] = await inFlightSubscribe;\n\n      if (inFlightError || !this.isSubscribed) {\n        this.handlers.delete(handlerId);\n\n        return err(\n          \"SubscribeError\",\n          `Unable to subscribe to ${this.options.channel}`,\n        );\n      }\n\n      return ok(() => this.unsubscribeHandler(handlerId));\n    }\n\n    this.subscribeInFlight = mightThrow(\n      this.options.subscriber.subscribe(\n        this.options.channel,\n        async (message, channel) => this.onMessage(message, channel),\n      ),\n    );\n\n    const subscribeInFlight = this.subscribeInFlight;\n\n    if (!subscribeInFlight) {\n      this.handlers.delete(handlerId);\n\n      return err(\n        \"SubscribeError\",\n        `Unable to subscribe to ${this.options.channel}`,\n      );\n    }\n\n    const [subscribeError, count] = await subscribeInFlight;\n\n    this.subscribeInFlight = null;\n\n    if (subscribeError) {\n      this.handlers.delete(handlerId);\n\n      return err(\n        \"SubscribeError\",\n        `Unable to subscribe to ${this.options.channel}`,\n      );\n    }\n\n    if (!count) {\n      this.handlers.delete(handlerId);\n\n      return err(\n        \"SubscribeError\",\n        `Unable to subscribe to ${this.options.channel}`,\n      );\n    }\n\n    this.isSubscribed = true;\n\n    return ok(() => this.unsubscribeHandler(handlerId));\n  }\n\n  public async unsubscribe() {\n    const inFlightUnsubscribe = this.unsubscribeInFlight;\n\n    if (inFlightUnsubscribe) {\n      await inFlightUnsubscribe;\n    }\n\n    if (!this.isActive()) {\n      return err(\"UnsubscribeError\", \"Not subscribed\");\n    }\n\n    const handlers = new Map(this.handlers);\n\n    this.handlers.clear();\n\n    this.isSubscribed = false;\n\n    this.unsubscribeInFlight = mightThrow(\n      this.options.subscriber.unsubscribe(this.options.channel),\n    );\n\n    const unsubscribeInFlight = this.unsubscribeInFlight;\n\n    if (!unsubscribeInFlight) {\n      this.handlers = handlers;\n      this.isSubscribed = true;\n\n      return err(\n        \"UnsubscribeError\",\n        `Unable to unsubscribe from ${this.options.channel}`,\n      );\n    }\n\n    const [unsubscribeError] = await unsubscribeInFlight;\n\n    if (unsubscribeError) {\n      this.handlers = handlers;\n      this.isSubscribed = true;\n      this.unsubscribeInFlight = null;\n\n      return err(\n        \"UnsubscribeError\",\n        `Unable to unsubscribe from ${this.options.channel}`,\n      );\n    }\n\n    this.unsubscribeInFlight = null;\n\n    return ok(true);\n  }\n\n  public isActive() {\n    return this.handlers.size > 0 && this.isSubscribed;\n  }\n}\n"],"mappings":"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"}

package/dist/lib/queue/index.cjs

@@ -0,0 +1,182 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_lib_errors_index = require("../errors/index.cjs");
+//#region src/lib/queue/index.ts
+const toMinimalJob = (jobState) => ({
+	id: jobState.id,
+	data: jobState.data,
+	attempts: jobState.attempts,
+	maxRetries: jobState.maxRetries,
+	createdAt: jobState.createdAt
+});
+const DEFAULT_RETRIES = 3;
+const DEFAULT_TIMEOUT = 3e4;
+const DEFAULT_CONCURRENCY = 1;
+const DEFAULT_POLL_INTERVAL = 100;
+const MAX_BACKOFF_DELAY = 6e4;
+const BASE_BACKOFF_DELAY = 1e3;
+const BACKOFF_MULTIPLIER = 2;
+const SHUTDOWN_POLL_INTERVAL = 10;
+var Queue = class {
+	options;
+	running = true;
+	activeWorkers = 0;
+	retries;
+	timeout;
+	concurrency;
+	pollInterval;
+	constructor(options) {
+		this.options = options;
+		this.retries = options.retries ?? DEFAULT_RETRIES;
+		this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+		this.concurrency = options.concurrency ?? DEFAULT_CONCURRENCY;
+		this.pollInterval = options.pollInterval ?? DEFAULT_POLL_INTERVAL;
+		this.startWorkers();
+	}
+	async enqueue(data) {
+		const job = {
+			id: crypto.randomUUID(),
+			data,
+			attempts: 0,
+			maxRetries: this.retries,
+			createdAt: Date.now()
+		};
+		const [serializeError, serialized] = this.serializeJob(job);
+		if (serializeError || !serialized) return require_lib_errors_index.err("QueueError", "Unable to serialize job data");
+		const [enqueueError] = await this.enqueueJobData(serialized);
+		if (enqueueError) return require_lib_errors_index.err("QueueError", "Unable to enqueue job");
+		return require_lib_errors_index.ok(job.id);
+	}
+	async stop() {
+		this.running = false;
+		while (this.activeWorkers > 0) await new Promise((resolve) => setTimeout(resolve, SHUTDOWN_POLL_INTERVAL));
+	}
+	waitForPollInterval() {
+		return new Promise((resolve) => setTimeout(resolve, this.pollInterval));
+	}
+	serializeJob(job) {
+		return require_lib_errors_index.mightThrowSync(() => JSON.stringify(job));
+	}
+	async enqueueJobData(serialized) {
+		const queueKey = `queue:${this.options.name}:jobs`;
+		return require_lib_errors_index.mightThrow(this.options.redis.lpush(queueKey, serialized));
+	}
+	async moveToDeadLetterQueue(jobData, parseError) {
+		const deadLetterKey = `queue:${this.options.name}:dead-letter`;
+		const deadLetterEntry = JSON.stringify({
+			jobData,
+			parseError: this.formatErrorMessage(parseError),
+			timestamp: Date.now()
+		});
+		return require_lib_errors_index.mightThrow(this.options.redis.lpush(deadLetterKey, deadLetterEntry));
+	}
+	formatErrorMessage(error) {
+		return error instanceof Error ? error.message : String(error);
+	}
+	startWorkers() {
+		for (let i = 0; i < this.concurrency; i++) this.processJobs();
+	}
+	async processJobs() {
+		while (this.running) {
+			const queueKey = `queue:${this.options.name}:jobs`;
+			const [popError, jobData] = await require_lib_errors_index.mightThrow(this.options.redis.rpop(queueKey));
+			if (popError) {
+				await this.waitForPollInterval();
+				continue;
+			}
+			if (!jobData) {
+				await this.waitForPollInterval();
+				continue;
+			}
+			const [parseError, job] = require_lib_errors_index.mightThrowSync(() => JSON.parse(jobData));
+			if (parseError || !job) {
+				await this.callOnErrorForParseFailure(jobData, parseError);
+				await this.moveToDeadLetterQueue(jobData, parseError);
+				await this.waitForPollInterval();
+				continue;
+			}
+			if (!this.running) {
+				const [stringifyError, serialized] = this.serializeJob(job);
+				if (!stringifyError && serialized) await require_lib_errors_index.mightThrow(this.options.redis.lpush(queueKey, serialized));
+				break;
+			}
+			this.activeWorkers++;
+			await require_lib_errors_index.mightThrow(this.handleJob(job));
+			this.activeWorkers--;
+		}
+	}
+	async handleJob(job) {
+		const controller = new AbortController();
+		const handlerPromise = Promise.resolve().then(() => this.options.handler(job.data, controller.signal));
+		let timerId;
+		const timeoutPromise = new Promise((_, reject) => {
+			timerId = setTimeout(() => {
+				reject(/* @__PURE__ */ new Error(`Job timeout after ${this.timeout}ms`));
+			}, this.timeout);
+		});
+		const [handlerError] = await require_lib_errors_index.mightThrow(Promise.race([handlerPromise.then(() => void 0), timeoutPromise]));
+		if (timerId) clearTimeout(timerId);
+		if (handlerError && !controller.signal.aborted) controller.abort();
+		if (!handlerError) {
+			if (this.options.onSuccess) await require_lib_errors_index.mightThrow(Promise.resolve(this.options.onSuccess(toMinimalJob(job))));
+			return;
+		}
+		job.attempts++;
+		const errorMsg = this.formatErrorMessage(handlerError);
+		job.error = errorMsg;
+		if (!job.errorHistory) job.errorHistory = [];
+		job.errorHistory.push({
+			attempt: job.attempts,
+			error: errorMsg,
+			timestamp: Date.now()
+		});
+		if (job.attempts <= job.maxRetries) {
+			if (this.options.onRetry) {
+				const delay = Math.min(BASE_BACKOFF_DELAY * BACKOFF_MULTIPLIER ** (job.attempts - 1), MAX_BACKOFF_DELAY);
+				await require_lib_errors_index.mightThrow(Promise.resolve(this.options.onRetry({
+					job: toMinimalJob(job),
+					error: errorMsg,
+					nextRetryDelayMs: delay,
+					retriesRemaining: job.maxRetries - job.attempts,
+					backoffMultiplier: BACKOFF_MULTIPLIER
+				})));
+			}
+			await this.retryJob(job);
+		} else await this.callOnError(job);
+	}
+	async callOnError(job) {
+		if (!this.options.onError) return;
+		await require_lib_errors_index.mightThrow(Promise.resolve(this.options.onError({
+			job: toMinimalJob(job),
+			lastError: job.error ?? "",
+			totalDurationMs: Date.now() - job.createdAt,
+			totalAttempts: job.attempts,
+			errorHistory: job.errorHistory ?? []
+		})));
+	}
+	async callOnErrorForParseFailure(jobData, parseError) {
+		if (!this.options.onParseError) return;
+		await require_lib_errors_index.mightThrow(Promise.resolve(this.options.onParseError({
+			rawJobData: jobData,
+			parseError: this.formatErrorMessage(parseError),
+			timestamp: Date.now()
+		})));
+	}
+	async retryJob(job) {
+		const delay = Math.min(BASE_BACKOFF_DELAY * BACKOFF_MULTIPLIER ** (job.attempts - 1), MAX_BACKOFF_DELAY);
+		await new Promise((resolve) => setTimeout(resolve, delay));
+		const [stringifyError, serialized] = this.serializeJob(job);
+		if (stringifyError || !serialized) {
+			job.error = `Failed to serialize job for retry: ${this.formatErrorMessage(stringifyError)}`;
+			await this.callOnError(job);
+			return;
+		}
+		const queueKey = `queue:${this.options.name}:jobs`;
+		const [pushError] = await require_lib_errors_index.mightThrow(this.options.redis.lpush(queueKey, serialized));
+		if (pushError) {
+			job.error = `Failed to re-enqueue job for retry: ${this.formatErrorMessage(pushError)}`;
+			await this.callOnError(job);
+		}
+	}
+};
+//#endregion
+exports.Queue = Queue;

package/dist/lib/queue/index.d.cts

@@ -0,0 +1,32 @@
+import { QueueOptions } from "../../queue/types.cjs";
+
+//#region src/lib/queue/index.d.ts
+declare class Queue<T> {
+  private options;
+  private running;
+  private activeWorkers;
+  private retries;
+  private timeout;
+  private concurrency;
+  private pollInterval;
+  constructor(options: QueueOptions<T>);
+  enqueue(data: T): Promise<readonly [{
+    readonly type: "QueueError";
+    readonly message: string;
+  }, null] | readonly [null, string]>;
+  stop(): Promise<void>;
+  private waitForPollInterval;
+  private serializeJob;
+  private enqueueJobData;
+  private moveToDeadLetterQueue;
+  private formatErrorMessage;
+  private startWorkers;
+  private processJobs;
+  private handleJob;
+  private callOnError;
+  private callOnErrorForParseFailure;
+  private retryJob;
+}
+//#endregion
+export { Queue };
+//# sourceMappingURL=index.d.cts.map

package/dist/lib/queue/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/lib/queue/index.ts"],"mappings":";;;cAoBa,KAAA;EAAA,QACH,OAAA;EAAA,QACA,OAAA;EAAA,QACA,aAAA;EAAA,QACA,OAAA;EAAA,QACA,OAAA;EAAA,QACA,WAAA;EAAA,QACA,YAAA;cAEW,OAAA,EAAS,YAAA,CAAa,CAAA;EAS5B,OAAA,CAAQ,IAAA,EAAM,CAAA,GAAC,OAAA;IAAA;;;EAsBf,IAAA,CAAA,GAAI,OAAA;EAAA,QAWT,mBAAA;EAAA,QAIA,YAAA;EAAA,QAIM,cAAA;EAAA,QAKA,qBAAA;EAAA,QAWN,kBAAA;EAAA,QAIA,YAAA;EAAA,QAMM,WAAA;EAAA,QAkDA,SAAA;EAAA,QA6EA,WAAA;EAAA,QAkBA,0BAAA;EAAA,QAmBA,QAAA;AAAA"}

package/dist/lib/queue/index.d.mts

@@ -0,0 +1,32 @@
+import { QueueOptions } from "../../queue/types.mjs";
+
+//#region src/lib/queue/index.d.ts
+declare class Queue<T> {
+  private options;
+  private running;
+  private activeWorkers;
+  private retries;
+  private timeout;
+  private concurrency;
+  private pollInterval;
+  constructor(options: QueueOptions<T>);
+  enqueue(data: T): Promise<readonly [{
+    readonly type: "QueueError";
+    readonly message: string;
+  }, null] | readonly [null, string]>;
+  stop(): Promise<void>;
+  private waitForPollInterval;
+  private serializeJob;
+  private enqueueJobData;
+  private moveToDeadLetterQueue;
+  private formatErrorMessage;
+  private startWorkers;
+  private processJobs;
+  private handleJob;
+  private callOnError;
+  private callOnErrorForParseFailure;
+  private retryJob;
+}
+//#endregion
+export { Queue };
+//# sourceMappingURL=index.d.mts.map

package/dist/lib/queue/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/lib/queue/index.ts"],"mappings":";;;cAoBa,KAAA;EAAA,QACH,OAAA;EAAA,QACA,OAAA;EAAA,QACA,aAAA;EAAA,QACA,OAAA;EAAA,QACA,OAAA;EAAA,QACA,WAAA;EAAA,QACA,YAAA;cAEW,OAAA,EAAS,YAAA,CAAa,CAAA;EAS5B,OAAA,CAAQ,IAAA,EAAM,CAAA,GAAC,OAAA;IAAA;;;EAsBf,IAAA,CAAA,GAAI,OAAA;EAAA,QAWT,mBAAA;EAAA,QAIA,YAAA;EAAA,QAIM,cAAA;EAAA,QAKA,qBAAA;EAAA,QAWN,kBAAA;EAAA,QAIA,YAAA;EAAA,QAMM,WAAA;EAAA,QAkDA,SAAA;EAAA,QA6EA,WAAA;EAAA,QAkBA,0BAAA;EAAA,QAmBA,QAAA;AAAA"}

package/dist/lib/queue/index.mjs

@@ -0,0 +1,183 @@
+import { err, mightThrow, mightThrowSync, ok } from "../errors/index.mjs";
+//#region src/lib/queue/index.ts
+const toMinimalJob = (jobState) => ({
+	id: jobState.id,
+	data: jobState.data,
+	attempts: jobState.attempts,
+	maxRetries: jobState.maxRetries,
+	createdAt: jobState.createdAt
+});
+const DEFAULT_RETRIES = 3;
+const DEFAULT_TIMEOUT = 3e4;
+const DEFAULT_CONCURRENCY = 1;
+const DEFAULT_POLL_INTERVAL = 100;
+const MAX_BACKOFF_DELAY = 6e4;
+const BASE_BACKOFF_DELAY = 1e3;
+const BACKOFF_MULTIPLIER = 2;
+const SHUTDOWN_POLL_INTERVAL = 10;
+var Queue = class {
+	options;
+	running = true;
+	activeWorkers = 0;
+	retries;
+	timeout;
+	concurrency;
+	pollInterval;
+	constructor(options) {
+		this.options = options;
+		this.retries = options.retries ?? DEFAULT_RETRIES;
+		this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+		this.concurrency = options.concurrency ?? DEFAULT_CONCURRENCY;
+		this.pollInterval = options.pollInterval ?? DEFAULT_POLL_INTERVAL;
+		this.startWorkers();
+	}
+	async enqueue(data) {
+		const job = {
+			id: crypto.randomUUID(),
+			data,
+			attempts: 0,
+			maxRetries: this.retries,
+			createdAt: Date.now()
+		};
+		const [serializeError, serialized] = this.serializeJob(job);
+		if (serializeError || !serialized) return err("QueueError", "Unable to serialize job data");
+		const [enqueueError] = await this.enqueueJobData(serialized);
+		if (enqueueError) return err("QueueError", "Unable to enqueue job");
+		return ok(job.id);
+	}
+	async stop() {
+		this.running = false;
+		while (this.activeWorkers > 0) await new Promise((resolve) => setTimeout(resolve, SHUTDOWN_POLL_INTERVAL));
+	}
+	waitForPollInterval() {
+		return new Promise((resolve) => setTimeout(resolve, this.pollInterval));
+	}
+	serializeJob(job) {
+		return mightThrowSync(() => JSON.stringify(job));
+	}
+	async enqueueJobData(serialized) {
+		const queueKey = `queue:${this.options.name}:jobs`;
+		return mightThrow(this.options.redis.lpush(queueKey, serialized));
+	}
+	async moveToDeadLetterQueue(jobData, parseError) {
+		const deadLetterKey = `queue:${this.options.name}:dead-letter`;
+		const deadLetterEntry = JSON.stringify({
+			jobData,
+			parseError: this.formatErrorMessage(parseError),
+			timestamp: Date.now()
+		});
+		return mightThrow(this.options.redis.lpush(deadLetterKey, deadLetterEntry));
+	}
+	formatErrorMessage(error) {
+		return error instanceof Error ? error.message : String(error);
+	}
+	startWorkers() {
+		for (let i = 0; i < this.concurrency; i++) this.processJobs();
+	}
+	async processJobs() {
+		while (this.running) {
+			const queueKey = `queue:${this.options.name}:jobs`;
+			const [popError, jobData] = await mightThrow(this.options.redis.rpop(queueKey));
+			if (popError) {
+				await this.waitForPollInterval();
+				continue;
+			}
+			if (!jobData) {
+				await this.waitForPollInterval();
+				continue;
+			}
+			const [parseError, job] = mightThrowSync(() => JSON.parse(jobData));
+			if (parseError || !job) {
+				await this.callOnErrorForParseFailure(jobData, parseError);
+				await this.moveToDeadLetterQueue(jobData, parseError);
+				await this.waitForPollInterval();
+				continue;
+			}
+			if (!this.running) {
+				const [stringifyError, serialized] = this.serializeJob(job);
+				if (!stringifyError && serialized) await mightThrow(this.options.redis.lpush(queueKey, serialized));
+				break;
+			}
+			this.activeWorkers++;
+			await mightThrow(this.handleJob(job));
+			this.activeWorkers--;
+		}
+	}
+	async handleJob(job) {
+		const controller = new AbortController();
+		const handlerPromise = Promise.resolve().then(() => this.options.handler(job.data, controller.signal));
+		let timerId;
+		const timeoutPromise = new Promise((_, reject) => {
+			timerId = setTimeout(() => {
+				reject(/* @__PURE__ */ new Error(`Job timeout after ${this.timeout}ms`));
+			}, this.timeout);
+		});
+		const [handlerError] = await mightThrow(Promise.race([handlerPromise.then(() => void 0), timeoutPromise]));
+		if (timerId) clearTimeout(timerId);
+		if (handlerError && !controller.signal.aborted) controller.abort();
+		if (!handlerError) {
+			if (this.options.onSuccess) await mightThrow(Promise.resolve(this.options.onSuccess(toMinimalJob(job))));
+			return;
+		}
+		job.attempts++;
+		const errorMsg = this.formatErrorMessage(handlerError);
+		job.error = errorMsg;
+		if (!job.errorHistory) job.errorHistory = [];
+		job.errorHistory.push({
+			attempt: job.attempts,
+			error: errorMsg,
+			timestamp: Date.now()
+		});
+		if (job.attempts <= job.maxRetries) {
+			if (this.options.onRetry) {
+				const delay = Math.min(BASE_BACKOFF_DELAY * BACKOFF_MULTIPLIER ** (job.attempts - 1), MAX_BACKOFF_DELAY);
+				await mightThrow(Promise.resolve(this.options.onRetry({
+					job: toMinimalJob(job),
+					error: errorMsg,
+					nextRetryDelayMs: delay,
+					retriesRemaining: job.maxRetries - job.attempts,
+					backoffMultiplier: BACKOFF_MULTIPLIER
+				})));
+			}
+			await this.retryJob(job);
+		} else await this.callOnError(job);
+	}
+	async callOnError(job) {
+		if (!this.options.onError) return;
+		await mightThrow(Promise.resolve(this.options.onError({
+			job: toMinimalJob(job),
+			lastError: job.error ?? "",
+			totalDurationMs: Date.now() - job.createdAt,
+			totalAttempts: job.attempts,
+			errorHistory: job.errorHistory ?? []
+		})));
+	}
+	async callOnErrorForParseFailure(jobData, parseError) {
+		if (!this.options.onParseError) return;
+		await mightThrow(Promise.resolve(this.options.onParseError({
+			rawJobData: jobData,
+			parseError: this.formatErrorMessage(parseError),
+			timestamp: Date.now()
+		})));
+	}
+	async retryJob(job) {
+		const delay = Math.min(BASE_BACKOFF_DELAY * BACKOFF_MULTIPLIER ** (job.attempts - 1), MAX_BACKOFF_DELAY);
+		await new Promise((resolve) => setTimeout(resolve, delay));
+		const [stringifyError, serialized] = this.serializeJob(job);
+		if (stringifyError || !serialized) {
+			job.error = `Failed to serialize job for retry: ${this.formatErrorMessage(stringifyError)}`;
+			await this.callOnError(job);
+			return;
+		}
+		const queueKey = `queue:${this.options.name}:jobs`;
+		const [pushError] = await mightThrow(this.options.redis.lpush(queueKey, serialized));
+		if (pushError) {
+			job.error = `Failed to re-enqueue job for retry: ${this.formatErrorMessage(pushError)}`;
+			await this.callOnError(job);
+		}
+	}
+};
+//#endregion
+export { Queue };
+
+//# sourceMappingURL=index.mjs.map

package/dist/lib/queue/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/lib/queue/index.ts"],"sourcesContent":["import { err, mightThrow, mightThrowSync, ok } from \"../errors/index.js\";\nimport type { Job, JobState, QueueOptions } from \"./types.js\";\n\nconst toMinimalJob = <T>(jobState: JobState<T>): Job<T> => ({\n  id: jobState.id,\n  data: jobState.data,\n  attempts: jobState.attempts,\n  maxRetries: jobState.maxRetries,\n  createdAt: jobState.createdAt,\n});\n\nconst DEFAULT_RETRIES = 3;\nconst DEFAULT_TIMEOUT = 30000;\nconst DEFAULT_CONCURRENCY = 1;\nconst DEFAULT_POLL_INTERVAL = 100;\nconst MAX_BACKOFF_DELAY = 60000;\nconst BASE_BACKOFF_DELAY = 1000;\nconst BACKOFF_MULTIPLIER = 2;\nconst SHUTDOWN_POLL_INTERVAL = 10;\n\nexport class Queue<T> {\n  private options: QueueOptions<T>;\n  private running = true;\n  private activeWorkers = 0;\n  private retries: number;\n  private timeout: number;\n  private concurrency: number;\n  private pollInterval: number;\n\n  public constructor(options: QueueOptions<T>) {\n    this.options = options;\n    this.retries = options.retries ?? DEFAULT_RETRIES;\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this.concurrency = options.concurrency ?? DEFAULT_CONCURRENCY;\n    this.pollInterval = options.pollInterval ?? DEFAULT_POLL_INTERVAL;\n    this.startWorkers();\n  }\n\n  public async enqueue(data: T) {\n    const job: JobState<T> = {\n      id: crypto.randomUUID(),\n      data,\n      attempts: 0,\n      maxRetries: this.retries,\n      createdAt: Date.now(),\n    };\n\n    const [serializeError, serialized] = this.serializeJob(job);\n    if (serializeError || !serialized) {\n      return err(\"QueueError\", \"Unable to serialize job data\");\n    }\n\n    const [enqueueError] = await this.enqueueJobData(serialized);\n    if (enqueueError) {\n      return err(\"QueueError\", \"Unable to enqueue job\");\n    }\n\n    return ok(job.id);\n  }\n\n  public async stop() {\n    this.running = false;\n\n    // Wait for all active workers to finish processing\n    while (this.activeWorkers > 0) {\n      await new Promise((resolve) =>\n        setTimeout(resolve, SHUTDOWN_POLL_INTERVAL),\n      );\n    }\n  }\n\n  private waitForPollInterval() {\n    return new Promise((resolve) => setTimeout(resolve, this.pollInterval));\n  }\n\n  private serializeJob(job: JobState<T>) {\n    return mightThrowSync(() => JSON.stringify(job));\n  }\n\n  private async enqueueJobData(serialized: string) {\n    const queueKey = `queue:${this.options.name}:jobs`;\n    return mightThrow(this.options.redis.lpush(queueKey, serialized));\n  }\n\n  private async moveToDeadLetterQueue(jobData: string, parseError: unknown) {\n    const deadLetterKey = `queue:${this.options.name}:dead-letter`;\n    const deadLetterEntry = JSON.stringify({\n      jobData,\n      parseError: this.formatErrorMessage(parseError),\n      timestamp: Date.now(),\n    });\n\n    return mightThrow(this.options.redis.lpush(deadLetterKey, deadLetterEntry));\n  }\n\n  private formatErrorMessage(error: unknown) {\n    return error instanceof Error ? error.message : String(error);\n  }\n\n  private startWorkers() {\n    for (let i = 0; i < this.concurrency; i++) {\n      this.processJobs();\n    }\n  }\n\n  private async processJobs() {\n    while (this.running) {\n      const queueKey = `queue:${this.options.name}:jobs`;\n\n      const [popError, jobData] = await mightThrow(\n        this.options.redis.rpop(queueKey),\n      );\n\n      if (popError) {\n        await this.waitForPollInterval();\n        continue;\n      }\n\n      if (!jobData) {\n        await this.waitForPollInterval();\n        continue;\n      }\n\n      const [parseError, job] = mightThrowSync<JobState<T>>(() =>\n        JSON.parse(jobData),\n      );\n\n      if (parseError || !job) {\n        // Handle malformed payload: preserve to dead-letter queue and notify\n        await this.callOnErrorForParseFailure(jobData, parseError);\n        await this.moveToDeadLetterQueue(jobData, parseError);\n\n        await this.waitForPollInterval();\n        continue;\n      }\n\n      // Skip processing if we've been stopped\n      if (!this.running) {\n        // Re-enqueue the job so it's not lost\n        const [stringifyError, serialized] = this.serializeJob(job);\n\n        if (!stringifyError && serialized) {\n          await mightThrow(this.options.redis.lpush(queueKey, serialized));\n        }\n\n        break;\n      }\n\n      this.activeWorkers++;\n\n      await mightThrow(this.handleJob(job));\n      this.activeWorkers--;\n    }\n  }\n\n  private async handleJob(job: JobState<T>) {\n    const controller = new AbortController();\n\n    const handlerPromise = Promise.resolve().then(() =>\n      this.options.handler(job.data, controller.signal),\n    );\n\n    let timerId: NodeJS.Timeout | undefined;\n\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      timerId = setTimeout(() => {\n        reject(new Error(`Job timeout after ${this.timeout}ms`));\n      }, this.timeout);\n    });\n\n    const [handlerError] = await mightThrow(\n      Promise.race([handlerPromise.then(() => undefined), timeoutPromise]),\n    );\n\n    if (timerId) {\n      clearTimeout(timerId);\n    }\n\n    // Abort handler if timeout occurred\n    if (handlerError && !controller.signal.aborted) {\n      controller.abort();\n    }\n\n    if (!handlerError) {\n      if (this.options.onSuccess) {\n        await mightThrow(\n          Promise.resolve(this.options.onSuccess(toMinimalJob(job))),\n        );\n      }\n\n      return;\n    }\n\n    job.attempts++;\n\n    const errorMsg = this.formatErrorMessage(handlerError);\n    job.error = errorMsg;\n\n    if (!job.errorHistory) {\n      job.errorHistory = [];\n    }\n    job.errorHistory.push({\n      attempt: job.attempts,\n      error: errorMsg,\n      timestamp: Date.now(),\n    });\n\n    // Check if we should retry. Attempt starts at 1, so we retry while attempts <= maxRetries\n    if (job.attempts <= job.maxRetries) {\n      if (this.options.onRetry) {\n        const delay = Math.min(\n          BASE_BACKOFF_DELAY * BACKOFF_MULTIPLIER ** (job.attempts - 1),\n          MAX_BACKOFF_DELAY,\n        );\n        await mightThrow(\n          Promise.resolve(\n            this.options.onRetry({\n              job: toMinimalJob(job),\n              error: errorMsg,\n              nextRetryDelayMs: delay,\n              retriesRemaining: job.maxRetries - job.attempts,\n              backoffMultiplier: BACKOFF_MULTIPLIER,\n            }),\n          ),\n        );\n      }\n      await this.retryJob(job);\n    } else {\n      await this.callOnError(job);\n    }\n  }\n\n  private async callOnError(job: JobState<T>) {\n    if (!this.options.onError) {\n      return;\n    }\n\n    await mightThrow(\n      Promise.resolve(\n        this.options.onError({\n          job: toMinimalJob(job),\n          lastError: job.error ?? \"\",\n          totalDurationMs: Date.now() - job.createdAt,\n          totalAttempts: job.attempts,\n          errorHistory: job.errorHistory ?? [],\n        }),\n      ),\n    );\n  }\n\n  private async callOnErrorForParseFailure(\n    jobData: string,\n    parseError: unknown,\n  ) {\n    if (!this.options.onParseError) {\n      return;\n    }\n\n    await mightThrow(\n      Promise.resolve(\n        this.options.onParseError({\n          rawJobData: jobData,\n          parseError: this.formatErrorMessage(parseError),\n          timestamp: Date.now(),\n        }),\n      ),\n    );\n  }\n\n  private async retryJob(job: JobState<T>) {\n    // Exponential backoff: 1st retry (attempts=1) -> 1000ms, 2nd (attempts=2) -> 2000ms, etc.\n    const delay = Math.min(\n      BASE_BACKOFF_DELAY * BACKOFF_MULTIPLIER ** (job.attempts - 1),\n      MAX_BACKOFF_DELAY,\n    );\n\n    await new Promise((resolve) => setTimeout(resolve, delay));\n\n    const [stringifyError, serialized] = this.serializeJob(job);\n\n    if (stringifyError || !serialized) {\n      job.error = `Failed to serialize job for retry: ${this.formatErrorMessage(stringifyError)}`;\n      await this.callOnError(job);\n      return;\n    }\n\n    const queueKey = `queue:${this.options.name}:jobs`;\n    const [pushError] = await mightThrow(\n      this.options.redis.lpush(queueKey, serialized),\n    );\n\n    if (pushError) {\n      job.error = `Failed to re-enqueue job for retry: ${this.formatErrorMessage(pushError)}`;\n      await this.callOnError(job);\n    }\n  }\n}\n"],"mappings":"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"}