semola 0.5.0 → 0.5.2

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

@@ -0,0 +1,27 @@
+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;
+  constructor(options: PubSubOptions);
+  publish(message: T): Promise<readonly [null, number | null] | readonly [{
+    readonly type: "SerializationError";
+    readonly message: string;
+  }, null] | readonly [{
+    readonly type: "PublishError";
+    readonly message: string;
+  }, null]>;
+  subscribe(handler: MessageHandler<T>): Promise<readonly [null, number | null] | readonly [{
+    readonly type: "SubscribeError";
+    readonly message: string;
+  }, null]>;
+  unsubscribe(): Promise<readonly [null, boolean] | readonly [{
+    readonly type: "UnsubscribeError";
+    readonly message: string;
+  }, null]>;
+  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;cAEW,OAAA,EAAS,aAAA;EAIf,OAAA,CAAQ,OAAA,EAAS,CAAA,GAAC,OAAA;IAAA;;;;;;EAuBlB,SAAA,CAAU,OAAA,EAAS,cAAA,CAAe,CAAA,IAAE,OAAA;IAAA;;;EAgCpC,WAAA,CAAA,GAAW,OAAA;IAAA;;;EAuBjB,QAAA,CAAA;AAAA"}

package/dist/lib/pubsub/index.mjs

@@ -0,0 +1,49 @@
+import { err, mightThrow, mightThrowSync, ok } from "../errors/index.mjs";
+//#region src/lib/pubsub/index.ts
+var PubSub = class {
+	options;
+	isSubscribed = false;
+	constructor(options) {
+		this.options = options;
+	}
+	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) {
+		if (this.isActive()) return err("SubscribeError", "Already subscribed");
+		this.isSubscribed = true;
+		const wrappedHandler = async (message, channel) => {
+			const [parseError, parsed] = mightThrowSync(() => JSON.parse(message));
+			if (parseError) return;
+			if (!parsed) return;
+			await mightThrow(Promise.resolve(handler(parsed, channel)));
+		};
+		const [subscribeError, count] = await mightThrow(this.options.subscriber.subscribe(this.options.channel, wrappedHandler));
+		if (subscribeError) {
+			this.isSubscribed = false;
+			return err("SubscribeError", `Unable to subscribe to ${this.options.channel}`);
+		}
+		return ok(count);
+	}
+	async unsubscribe() {
+		if (!this.isActive()) return err("UnsubscribeError", "Not subscribed");
+		this.isSubscribed = false;
+		const [unsubscribeError] = await mightThrow(this.options.subscriber.unsubscribe(this.options.channel));
+		if (unsubscribeError) {
+			this.isSubscribed = true;
+			return err("UnsubscribeError", `Unable to unsubscribe from ${this.options.channel}`);
+		}
+		return ok(true);
+	}
+	isActive() {
+		return 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\n  public constructor(options: PubSubOptions) {\n    this.options = options;\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    if (this.isActive()) {\n      return err(\"SubscribeError\", \"Already subscribed\");\n    }\n\n    this.isSubscribed = true;\n\n    const wrappedHandler = async (message: string, channel: string) => {\n      const [parseError, parsed] = mightThrowSync<T>(() => JSON.parse(message));\n\n      if (parseError) return;\n      if (!parsed) return;\n\n      await mightThrow(Promise.resolve(handler(parsed, channel)));\n    };\n\n    const [subscribeError, count] = await mightThrow(\n      this.options.subscriber.subscribe(this.options.channel, wrappedHandler),\n    );\n\n    if (subscribeError) {\n      this.isSubscribed = false;\n\n      return err(\n        \"SubscribeError\",\n        `Unable to subscribe to ${this.options.channel}`,\n      );\n    }\n\n    return ok(count);\n  }\n\n  public async unsubscribe() {\n    if (!this.isActive()) {\n      return err(\"UnsubscribeError\", \"Not subscribed\");\n    }\n\n    this.isSubscribed = false;\n\n    const [unsubscribeError] = await mightThrow(\n      this.options.subscriber.unsubscribe(this.options.channel),\n    );\n\n    if (unsubscribeError) {\n      this.isSubscribed = true;\n\n      return err(\n        \"UnsubscribeError\",\n        `Unable to unsubscribe from ${this.options.channel}`,\n      );\n    }\n\n    return ok(true);\n  }\n\n  public isActive() {\n    return this.isSubscribed;\n  }\n}\n"],"mappings":";;AAGA,IAAa,SAAb,MAAuD;CACrD;CACA,eAAuB;CAEvB,YAAmB,SAAwB;AACzC,OAAK,UAAU;;CAGjB,MAAa,QAAQ,SAAY;EAC/B,MAAM,CAAC,gBAAgB,eAAe,qBACpC,KAAK,UAAU,QAAQ,CACxB;AAED,MAAI,kBAAkB,CAAC,YACrB,QAAO,IAAI,sBAAsB,8BAA8B;EAGjE,MAAM,CAAC,cAAc,SAAS,MAAM,WAClC,KAAK,QAAQ,UAAU,QAAQ,KAAK,QAAQ,SAAS,YAAY,CAClE;AAED,MAAI,aACF,QAAO,IACL,gBACA,wBAAwB,KAAK,QAAQ,UACtC;AAGH,SAAO,GAAG,MAAM;;CAGlB,MAAa,UAAU,SAA4B;AACjD,MAAI,KAAK,UAAU,CACjB,QAAO,IAAI,kBAAkB,qBAAqB;AAGpD,OAAK,eAAe;EAEpB,MAAM,iBAAiB,OAAO,SAAiB,YAAoB;GACjE,MAAM,CAAC,YAAY,UAAU,qBAAwB,KAAK,MAAM,QAAQ,CAAC;AAEzE,OAAI,WAAY;AAChB,OAAI,CAAC,OAAQ;AAEb,SAAM,WAAW,QAAQ,QAAQ,QAAQ,QAAQ,QAAQ,CAAC,CAAC;;EAG7D,MAAM,CAAC,gBAAgB,SAAS,MAAM,WACpC,KAAK,QAAQ,WAAW,UAAU,KAAK,QAAQ,SAAS,eAAe,CACxE;AAED,MAAI,gBAAgB;AAClB,QAAK,eAAe;AAEpB,UAAO,IACL,kBACA,0BAA0B,KAAK,QAAQ,UACxC;;AAGH,SAAO,GAAG,MAAM;;CAGlB,MAAa,cAAc;AACzB,MAAI,CAAC,KAAK,UAAU,CAClB,QAAO,IAAI,oBAAoB,iBAAiB;AAGlD,OAAK,eAAe;EAEpB,MAAM,CAAC,oBAAoB,MAAM,WAC/B,KAAK,QAAQ,WAAW,YAAY,KAAK,QAAQ,QAAQ,CAC1D;AAED,MAAI,kBAAkB;AACpB,QAAK,eAAe;AAEpB,UAAO,IACL,oBACA,8BAA8B,KAAK,QAAQ,UAC5C;;AAGH,SAAO,GAAG,KAAK;;CAGjB,WAAkB;AAChB,SAAO,KAAK"}

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 [null, string] | readonly [{
+    readonly type: "QueueError";
+    readonly message: string;
+  }, null]>;
+  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 [null, string] | readonly [{
+    readonly type: "QueueError";
+    readonly message: string;
+  }, null]>;
+  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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"}

package/dist/node_modules/@standard-schema/spec/dist/index.d.cts

@@ -0,0 +1,80 @@
+//#region node_modules/@standard-schema/spec/dist/index.d.ts
+/** The Standard Typed interface. This is a base type extended by other specs. */
+interface StandardTypedV1<Input = unknown, Output = Input> {
+  /** The Standard properties. */
+  readonly "~standard": StandardTypedV1.Props<Input, Output>;
+}
+declare namespace StandardTypedV1 {
+  /** The Standard Typed properties interface. */
+  interface Props<Input = unknown, Output = Input> {
+    /** The version number of the standard. */
+    readonly version: 1;
+    /** The vendor name of the schema library. */
+    readonly vendor: string;
+    /** Inferred types associated with the schema. */
+    readonly types?: Types<Input, Output> | undefined;
+  }
+  /** The Standard Typed types interface. */
+  interface Types<Input = unknown, Output = Input> {
+    /** The input type of the schema. */
+    readonly input: Input;
+    /** The output type of the schema. */
+    readonly output: Output;
+  }
+  /** Infers the input type of a Standard Typed. */
+  type InferInput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["input"];
+  /** Infers the output type of a Standard Typed. */
+  type InferOutput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["output"];
+}
+/** The Standard Schema interface. */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+  /** The Standard Schema properties. */
+  readonly "~standard": StandardSchemaV1.Props<Input, Output>;
+}
+declare namespace StandardSchemaV1 {
+  /** The Standard Schema properties interface. */
+  interface Props<Input = unknown, Output = Input> extends StandardTypedV1.Props<Input, Output> {
+    /** Validates unknown input values. */
+    readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;
+  }
+  /** The result interface of the validate function. */
+  type Result<Output> = SuccessResult<Output> | FailureResult;
+  /** The result interface if validation succeeds. */
+  interface SuccessResult<Output> {
+    /** The typed output value. */
+    readonly value: Output;
+    /** A falsy value for `issues` indicates success. */
+    readonly issues?: undefined;
+  }
+  interface Options {
+    /** Explicit support for additional vendor-specific parameters, if needed. */
+    readonly libraryOptions?: Record<string, unknown> | undefined;
+  }
+  /** The result interface if validation fails. */
+  interface FailureResult {
+    /** The issues of failed validation. */
+    readonly issues: ReadonlyArray<Issue>;
+  }
+  /** The issue interface of the failure output. */
+  interface Issue {
+    /** The error message of the issue. */
+    readonly message: string;
+    /** The path of the issue, if any. */
+    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+  }
+  /** The path segment interface of the issue. */
+  interface PathSegment {
+    /** The key representing a path segment. */
+    readonly key: PropertyKey;
+  }
+  /** The Standard types interface. */
+  interface Types<Input = unknown, Output = Input> extends StandardTypedV1.Types<Input, Output> {}
+  /** Infers the input type of a Standard. */
+  type InferInput<Schema extends StandardTypedV1> = StandardTypedV1.InferInput<Schema>;
+  /** Infers the output type of a Standard. */
+  type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
+}
+/** The Standard JSON Schema interface. */
+//#endregion
+export { StandardSchemaV1 };
+//# sourceMappingURL=index.d.cts.map

package/dist/node_modules/@standard-schema/spec/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":["StandardTypedV1","Input","Output","Props","Schema","Types","NonNullable","version","vendor","types","input","output","InferInput","InferOutput","StandardSchemaV1","Options","Result","Promise","SuccessResult","FailureResult","Record","Issue","ReadonlyArray","PropertyKey","PathSegment","validate","value","options","issues","libraryOptions","message","path","key","StandardJSONSchemaV1","Converter","Target","jsonSchema","target"],"sources":["../../../../../node_modules/@standard-schema/spec/dist/index.d.ts"],"x_google_ignoreList":[0],"mappings":";;UACUA,eAAAA,2BAA0CC,KAAAA;EAA3B;EAAA,SAEZ,WAAA,EAAaD,eAAAA,CAAgBG,KAAAA,CAAMF,KAAAA,EAAOC,MAAAA;AAAAA;AAAAA,kBAErCF,eAAAA;EAFqCE;EAAAA,UAIzCC,KAAAA,2BAAgCF,KAAAA;IAJC;IAAA,SAM9BM,OAAAA;IARSN;IAAAA,SAUTO,MAAAA;IAVmCP;IAAAA,SAYnCQ,KAAAA,GAAQJ,KAAAA,CAAMJ,KAAAA,EAAOC,MAAAA;EAAAA;EAVIC;EAAAA,UAa5BE,KAAAA,2BAAgCJ,KAAAA;IAbSC;IAAAA,SAetCQ,KAAAA,EAAOT,KAAAA;IAfqC;IAAA,SAiB5CU,MAAAA,EAAQT,MAAAA;EAAAA;EAfQD;EAAAA,KAkBxBW,UAAAA,gBAA0BZ,eAAAA,IAAmBM,WAAAA,CAAYF,MAAAA;EAVnCH;EAAAA,KAYtBY,WAAAA,gBAA2Bb,eAAAA,IAAmBM,WAAAA,CAAYF,MAAAA;AAAAA;;UAGzDU,gBAAAA,2BAA2Cb,KAAAA;EAR5BC;EAAAA,SAUZ,WAAA,EAAaY,gBAAAA,CAAiBX,KAAAA,CAAMF,KAAAA,EAAOC,MAAAA;AAAAA;AAAAA,kBAEtCY,gBAAAA;EAPkBd;EAAAA,UAStBG,KAAAA,2BAAgCF,KAAAA,UAAeD,eAAAA,CAAgBG,KAAAA,CAAMF,KAAAA,EAAOC,MAAAA;IATnCI;IAAAA,SAWtCmB,QAAAA,GAAWC,KAAAA,WAAgBC,OAAAA,GAAUb,gBAAAA,CAAiBC,OAAAA,iBAAwBC,MAAAA,CAAOd,MAAAA,IAAUe,OAAAA,CAAQD,MAAAA,CAAOd,MAAAA;EAAAA;EA7BjHC;EAAAA,KAgCLa,MAAAA,WAAiBE,aAAAA,CAAchB,MAAAA,IAAUiB,aAAAA;EAhCbjB;EAAAA,UAkCvBgB,aAAAA;IAhCGX;IAAAA,SAkCAmB,KAAAA,EAAOxB,MAAAA;IA9BPO;IAAAA,SAgCAmB,MAAAA;EAAAA;EAAAA,UAEHb,OAAAA;IA/BAV;IAAAA,SAiCGwB,cAAAA,GAAiBT,MAAAA;EAAAA;EAjCYnB;EAAAA,UAoChCkB,aAAAA;IAlCUlB;IAAAA,SAoCP2B,MAAAA,EAAQN,aAAAA,CAAcD,KAAAA;EAAAA;EA/B9BT;EAAAA,UAkCKS,KAAAA;IAlCqBrB;IAAAA,SAoClB8B,OAAAA;IApCiD1B;IAAAA,SAsCjD2B,IAAAA,GAAOT,aAAAA,CAAcC,WAAAA,GAAcC,WAAAA;EAAAA;EApChBxB;EAAAA,UAuCtBwB,WAAAA;IAvCqDpB;IAAAA,SAyClD4B,GAAAA,EAAKT,WAAAA;EAAAA;EAtCZT;EAAAA,UAyCIT,KAAAA,2BAAgCJ,KAAAA,UAAeD,eAAAA,CAAgBK,KAAAA,CAAMJ,KAAAA,EAAOC,MAAAA;EAzCrCD;EAAAA,KA4C5CW,UAAAA,gBAA0BZ,eAAAA,IAAmBA,eAAAA,CAAgBY,UAAAA,CAAWR,MAAAA;EA1CzBF;EAAAA,KA4C/CW,WAAAA,gBAA2Bb,eAAAA,IAAmBA,eAAAA,CAAgBa,WAAAA,CAAYT,MAAAA;AAAAA"}