@lssm/lib.jobs 0.0.0-canary-20251217062943 → 0.0.0-canary-20251217072406

package/dist/queue/memory-queue.js

@@ -1 +1,140 @@
-import{e,t}from"../contracts/dist/jobs/queue.js";import"./types.js";import{randomUUID as n}from"node:crypto";var r=class{jobs=new Map;handlers=new Map;timer;activeCount=0;pollIntervalMs;concurrency;retryPolicy;constructor(t={}){this.pollIntervalMs=t.pollIntervalMs??200,this.concurrency=t.concurrency??5,this.retryPolicy=t.retryPolicy??e}async enqueue(e,t,r={}){if(r.dedupeKey){let e=Array.from(this.jobs.values()).find(e=>e.dedupeKey===r.dedupeKey&&e.status===`pending`);if(e)return e}let i=new Date,a=r.delaySeconds?new Date(i.getTime()+r.delaySeconds*1e3):i,o={id:n(),type:e,version:1,payload:t,status:`pending`,priority:r.priority??0,attempts:0,maxRetries:r.maxRetries??this.retryPolicy.maxRetries,createdAt:i,updatedAt:i,scheduledAt:a,dedupeKey:r.dedupeKey,tenantId:r.tenantId,userId:r.userId,traceId:r.traceId,metadata:r.metadata};return r.timeoutMs&&(o.timeoutAt=new Date(i.getTime()+r.timeoutMs)),this.jobs.set(o.id,o),o}register(e,t){this.handlers.set(e,t)}start(){this.timer||=setInterval(()=>{this.processNext()},this.pollIntervalMs)}async stop(){for(this.timer&&=(clearInterval(this.timer),void 0);this.activeCount>0;)await new Promise(e=>setTimeout(e,50))}async getJob(e){return this.jobs.get(e)??null}async cancelJob(e){let t=this.jobs.get(e);return!t||t.status!==`pending`?!1:(t.status=`cancelled`,t.updatedAt=new Date,!0)}async getStats(){let e={pending:0,running:0,completed:0,failed:0,deadLetter:0};for(let t of this.jobs.values())switch(t.status){case`pending`:e.pending++;break;case`running`:e.running++;break;case`completed`:e.completed++;break;case`failed`:e.failed++;break;case`dead_letter`:e.deadLetter++;break}return e}async processNext(){if(this.activeCount>=this.concurrency)return;let e=new Date,n=Array.from(this.jobs.values()).filter(t=>t.status===`pending`&&(!t.scheduledAt||t.scheduledAt<=e)).sort((e,t)=>e.priority===t.priority?(e.scheduledAt?.getTime()??0)-(t.scheduledAt?.getTime()??0):t.priority-e.priority)[0];if(!n)return;let r=this.handlers.get(n.type);if(r){this.activeCount++,n.status=`running`,n.startedAt=new Date,n.updatedAt=new Date,n.attempts+=1;try{let e=await r(n);n.status=`completed`,n.completedAt=new Date,n.result=e}catch(e){if(n.lastError=e instanceof Error?e.message:`Unknown error`,n.attempts>=n.maxRetries)n.status=`dead_letter`;else{let e=t(n.attempts,this.retryPolicy);n.status=`pending`,n.scheduledAt=new Date(Date.now()+e)}}finally{n.updatedAt=new Date,this.activeCount--}}}};export{r as MemoryJobQueue};
+import { DEFAULT_RETRY_POLICY, calculateBackoff } from "../contracts/dist/jobs/queue.js";
+import "./types.js";
+import { randomUUID } from "node:crypto";
+
+//#region src/queue/memory-queue.ts
+/**
+* In-memory job queue for development and testing.
+*/
+var MemoryJobQueue = class {
+	jobs = /* @__PURE__ */ new Map();
+	handlers = /* @__PURE__ */ new Map();
+	timer;
+	activeCount = 0;
+	pollIntervalMs;
+	concurrency;
+	retryPolicy;
+	constructor(options = {}) {
+		this.pollIntervalMs = options.pollIntervalMs ?? 200;
+		this.concurrency = options.concurrency ?? 5;
+		this.retryPolicy = options.retryPolicy ?? DEFAULT_RETRY_POLICY;
+	}
+	async enqueue(jobType, payload, options = {}) {
+		if (options.dedupeKey) {
+			const existing = Array.from(this.jobs.values()).find((j) => j.dedupeKey === options.dedupeKey && j.status === "pending");
+			if (existing) return existing;
+		}
+		const now = /* @__PURE__ */ new Date();
+		const scheduledAt = options.delaySeconds ? new Date(now.getTime() + options.delaySeconds * 1e3) : now;
+		const job = {
+			id: randomUUID(),
+			type: jobType,
+			version: 1,
+			payload,
+			status: "pending",
+			priority: options.priority ?? 0,
+			attempts: 0,
+			maxRetries: options.maxRetries ?? this.retryPolicy.maxRetries,
+			createdAt: now,
+			updatedAt: now,
+			scheduledAt,
+			dedupeKey: options.dedupeKey,
+			tenantId: options.tenantId,
+			userId: options.userId,
+			traceId: options.traceId,
+			metadata: options.metadata
+		};
+		if (options.timeoutMs) job.timeoutAt = new Date(now.getTime() + options.timeoutMs);
+		this.jobs.set(job.id, job);
+		return job;
+	}
+	register(jobType, handler) {
+		this.handlers.set(jobType, handler);
+	}
+	start() {
+		if (this.timer) return;
+		this.timer = setInterval(() => {
+			this.processNext();
+		}, this.pollIntervalMs);
+	}
+	async stop() {
+		if (this.timer) {
+			clearInterval(this.timer);
+			this.timer = void 0;
+		}
+		while (this.activeCount > 0) await new Promise((resolve) => setTimeout(resolve, 50));
+	}
+	async getJob(jobId) {
+		return this.jobs.get(jobId) ?? null;
+	}
+	async cancelJob(jobId) {
+		const job = this.jobs.get(jobId);
+		if (!job || job.status !== "pending") return false;
+		job.status = "cancelled";
+		job.updatedAt = /* @__PURE__ */ new Date();
+		return true;
+	}
+	async getStats() {
+		const stats = {
+			pending: 0,
+			running: 0,
+			completed: 0,
+			failed: 0,
+			deadLetter: 0
+		};
+		for (const job of this.jobs.values()) switch (job.status) {
+			case "pending":
+				stats.pending++;
+				break;
+			case "running":
+				stats.running++;
+				break;
+			case "completed":
+				stats.completed++;
+				break;
+			case "failed":
+				stats.failed++;
+				break;
+			case "dead_letter":
+				stats.deadLetter++;
+				break;
+		}
+		return stats;
+	}
+	async processNext() {
+		if (this.activeCount >= this.concurrency) return;
+		const now = /* @__PURE__ */ new Date();
+		const job = Array.from(this.jobs.values()).filter((j) => j.status === "pending" && (!j.scheduledAt || j.scheduledAt <= now)).sort((a, b) => {
+			if (a.priority !== b.priority) return b.priority - a.priority;
+			return (a.scheduledAt?.getTime() ?? 0) - (b.scheduledAt?.getTime() ?? 0);
+		})[0];
+		if (!job) return;
+		const handler = this.handlers.get(job.type);
+		if (!handler) return;
+		this.activeCount++;
+		job.status = "running";
+		job.startedAt = /* @__PURE__ */ new Date();
+		job.updatedAt = /* @__PURE__ */ new Date();
+		job.attempts += 1;
+		try {
+			const result = await handler(job);
+			job.status = "completed";
+			job.completedAt = /* @__PURE__ */ new Date();
+			job.result = result;
+		} catch (error) {
+			job.lastError = error instanceof Error ? error.message : "Unknown error";
+			if (job.attempts >= job.maxRetries) job.status = "dead_letter";
+			else {
+				const backoff = calculateBackoff(job.attempts, this.retryPolicy);
+				job.status = "pending";
+				job.scheduledAt = new Date(Date.now() + backoff);
+			}
+		} finally {
+			job.updatedAt = /* @__PURE__ */ new Date();
+			this.activeCount--;
+		}
+	}
+};
+
+//#endregion
+export { MemoryJobQueue };

package/dist/queue/register-defined-job.js

@@ -1 +1,15 @@
-function e(e,t){e.register(t.type,async e=>{let n=t.schema.parse(e.payload),r={...e,payload:n};await t.handler(n,r)})}export{e as registerDefinedJob};
+//#region src/queue/register-defined-job.ts
+function registerDefinedJob(queue, def) {
+	const wrapped = async (job) => {
+		const payload = def.schema.parse(job.payload);
+		const typedJob = {
+			...job,
+			payload
+		};
+		await def.handler(payload, typedJob);
+	};
+	queue.register(def.type, wrapped);
+}
+
+//#endregion
+export { registerDefinedJob };

package/dist/queue/scaleway-sqs-queue.js

@@ -1 +1,175 @@
-import{e}from"../contracts/dist/jobs/queue.js";import"./types.js";import{randomUUID as t}from"node:crypto";import{DeleteMessageCommand as n,ReceiveMessageCommand as r,SQSClient as i,SendMessageCommand as a}from"@aws-sdk/client-sqs";var o=class{sqs;queueUrl;waitTimeSeconds;maxNumberOfMessages;visibilityTimeoutSeconds;handlers=new Map;logger;running=!1;constructor(e){this.logger=e.logger;let t=e.credentials?.accessKeyId??process.env.SCALEWAY_ACCESS_KEY_QUEUE,n=e.credentials?.secretAccessKey??process.env.SCALEWAY_SECRET_KEY_QUEUE;if(!t||!n)throw Error(`Missing SCALEWAY_ACCESS_KEY_QUEUE / SCALEWAY_SECRET_KEY_QUEUE in env`);this.sqs=new i({region:e.region??process.env.SCALEWAY_REGION??`par`,endpoint:e.endpoint??`https://sqs.mnq.fr-par.scaleway.com`,credentials:{accessKeyId:t,secretAccessKey:n}}),this.queueUrl=e.queueUrl,this.waitTimeSeconds=e.waitTimeSeconds??20,this.maxNumberOfMessages=e.maxNumberOfMessages??5,this.visibilityTimeoutSeconds=e.visibilityTimeoutSeconds??60}async enqueue(n,r,i={}){let o=t(),s=new Date,c=i.delaySeconds?new Date(s.getTime()+i.delaySeconds*1e3):s,l={id:o,type:n,payload:r};return await this.sqs.send(new a({QueueUrl:this.queueUrl,MessageBody:JSON.stringify(l),DelaySeconds:i.delaySeconds??0})),{id:o,type:n,version:1,payload:r,status:`pending`,priority:i.priority??0,attempts:0,maxRetries:i.maxRetries??e.maxRetries,createdAt:s,updatedAt:s,scheduledAt:c,dedupeKey:i.dedupeKey,tenantId:i.tenantId,userId:i.userId,traceId:i.traceId,metadata:i.metadata}}register(e,t){if(this.handlers.has(e))throw Error(`Handler already registered for job type "${e}"`);this.handlers.set(e,t)}start(){this.running||(this.running=!0,this.pollLoop().catch(e=>{this.logger?.error?.(`jobs.queue.scaleway_sqs.poll_loop_fatal`,{error:e instanceof Error?e.message:String(e)}),this.running=!1}))}async stop(){this.running=!1}async pollLoop(){for(this.logger?.info?.(`jobs.queue.scaleway_sqs.started`,{queueUrl:this.queueUrl});this.running;)try{let t=(await this.sqs.send(new r({QueueUrl:this.queueUrl,MaxNumberOfMessages:this.maxNumberOfMessages,WaitTimeSeconds:this.waitTimeSeconds,VisibilityTimeout:this.visibilityTimeoutSeconds,MessageSystemAttributeNames:[`ApproximateReceiveCount`]}))).Messages??[];if(t.length===0)continue;for(let n of t){if(!n.Body||!n.ReceiptHandle){this.logger?.warn?.(`jobs.queue.scaleway_sqs.invalid_message`,{messageId:n.MessageId,reason:`missing_body_or_receipt`});continue}let t;try{t=JSON.parse(n.Body)}catch(e){this.logger?.warn?.(`jobs.queue.scaleway_sqs.parse_failed`,{messageId:n.MessageId,error:e instanceof Error?e.message:String(e)}),await this.deleteMessage(n.ReceiptHandle);continue}let r=this.handlers.get(t.type);if(!r){this.logger?.warn?.(`jobs.queue.scaleway_sqs.missing_handler`,{jobType:t.type,messageId:n.MessageId}),await this.deleteMessage(n.ReceiptHandle);continue}let i=new Date,a=parseInt(n.Attributes?.ApproximateReceiveCount??`1`,10),o={id:t.id,type:t.type,version:1,payload:t.payload,status:`pending`,priority:0,attempts:a,maxRetries:e.maxRetries,createdAt:i,updatedAt:i};o.status=`running`,o.updatedAt=new Date;try{await r(o),o.status=`completed`,o.updatedAt=new Date,await this.deleteMessage(n.ReceiptHandle)}catch(e){o.status=`failed`,o.lastError=e instanceof Error?e.message:`Unknown job error`,o.updatedAt=new Date,this.logger?.error?.(`jobs.queue.scaleway_sqs.job_failed`,{jobType:o.type,jobId:o.id,error:e instanceof Error?e.message:String(e)})}}}catch(e){this.logger?.error?.(`jobs.queue.scaleway_sqs.poll_error`,{error:e instanceof Error?e.message:String(e)}),await this.sleep(5e3)}this.logger?.info?.(`jobs.queue.scaleway_sqs.stopped`,{queueUrl:this.queueUrl})}async deleteMessage(e){try{await this.sqs.send(new n({QueueUrl:this.queueUrl,ReceiptHandle:e}))}catch(e){this.logger?.warn?.(`jobs.queue.scaleway_sqs.delete_failed`,{error:e instanceof Error?e.message:String(e)})}}async sleep(e){await new Promise(t=>setTimeout(t,e))}};export{o as ScalewaySqsJobQueue};
+import { DEFAULT_RETRY_POLICY } from "../contracts/dist/jobs/queue.js";
+import "./types.js";
+import { randomUUID } from "node:crypto";
+import { DeleteMessageCommand, ReceiveMessageCommand, SQSClient, SendMessageCommand } from "@aws-sdk/client-sqs";
+
+//#region src/queue/scaleway-sqs-queue.ts
+var ScalewaySqsJobQueue = class {
+	sqs;
+	queueUrl;
+	waitTimeSeconds;
+	maxNumberOfMessages;
+	visibilityTimeoutSeconds;
+	handlers = /* @__PURE__ */ new Map();
+	logger;
+	running = false;
+	constructor(config) {
+		this.logger = config.logger;
+		const accessKeyId = config.credentials?.accessKeyId ?? process.env.SCALEWAY_ACCESS_KEY_QUEUE;
+		const secretAccessKey = config.credentials?.secretAccessKey ?? process.env.SCALEWAY_SECRET_KEY_QUEUE;
+		if (!accessKeyId || !secretAccessKey) throw new Error("Missing SCALEWAY_ACCESS_KEY_QUEUE / SCALEWAY_SECRET_KEY_QUEUE in env");
+		this.sqs = new SQSClient({
+			region: config.region ?? process.env.SCALEWAY_REGION ?? "par",
+			endpoint: config.endpoint ?? "https://sqs.mnq.fr-par.scaleway.com",
+			credentials: {
+				accessKeyId,
+				secretAccessKey
+			}
+		});
+		this.queueUrl = config.queueUrl;
+		this.waitTimeSeconds = config.waitTimeSeconds ?? 20;
+		this.maxNumberOfMessages = config.maxNumberOfMessages ?? 5;
+		this.visibilityTimeoutSeconds = config.visibilityTimeoutSeconds ?? 60;
+	}
+	async enqueue(jobType, payload, options = {}) {
+		const id = randomUUID();
+		const now = /* @__PURE__ */ new Date();
+		const scheduledAt = options.delaySeconds ? new Date(now.getTime() + options.delaySeconds * 1e3) : now;
+		const envelope = {
+			id,
+			type: jobType,
+			payload
+		};
+		await this.sqs.send(new SendMessageCommand({
+			QueueUrl: this.queueUrl,
+			MessageBody: JSON.stringify(envelope),
+			DelaySeconds: options.delaySeconds ?? 0
+		}));
+		return {
+			id,
+			type: jobType,
+			version: 1,
+			payload,
+			status: "pending",
+			priority: options.priority ?? 0,
+			attempts: 0,
+			maxRetries: options.maxRetries ?? DEFAULT_RETRY_POLICY.maxRetries,
+			createdAt: now,
+			updatedAt: now,
+			scheduledAt,
+			dedupeKey: options.dedupeKey,
+			tenantId: options.tenantId,
+			userId: options.userId,
+			traceId: options.traceId,
+			metadata: options.metadata
+		};
+	}
+	register(jobType, handler) {
+		if (this.handlers.has(jobType)) throw new Error(`Handler already registered for job type "${jobType}"`);
+		this.handlers.set(jobType, handler);
+	}
+	start() {
+		if (this.running) return;
+		this.running = true;
+		this.pollLoop().catch((error) => {
+			this.logger?.error?.("jobs.queue.scaleway_sqs.poll_loop_fatal", { error: error instanceof Error ? error.message : String(error) });
+			this.running = false;
+		});
+	}
+	async stop() {
+		this.running = false;
+	}
+	async pollLoop() {
+		this.logger?.info?.("jobs.queue.scaleway_sqs.started", { queueUrl: this.queueUrl });
+		while (this.running) try {
+			const messages = (await this.sqs.send(new ReceiveMessageCommand({
+				QueueUrl: this.queueUrl,
+				MaxNumberOfMessages: this.maxNumberOfMessages,
+				WaitTimeSeconds: this.waitTimeSeconds,
+				VisibilityTimeout: this.visibilityTimeoutSeconds,
+				MessageSystemAttributeNames: ["ApproximateReceiveCount"]
+			}))).Messages ?? [];
+			if (messages.length === 0) continue;
+			for (const msg of messages) {
+				if (!msg.Body || !msg.ReceiptHandle) {
+					this.logger?.warn?.("jobs.queue.scaleway_sqs.invalid_message", {
+						messageId: msg.MessageId,
+						reason: "missing_body_or_receipt"
+					});
+					continue;
+				}
+				let envelope;
+				try {
+					envelope = JSON.parse(msg.Body);
+				} catch (err) {
+					this.logger?.warn?.("jobs.queue.scaleway_sqs.parse_failed", {
+						messageId: msg.MessageId,
+						error: err instanceof Error ? err.message : String(err)
+					});
+					await this.deleteMessage(msg.ReceiptHandle);
+					continue;
+				}
+				const handler = this.handlers.get(envelope.type);
+				if (!handler) {
+					this.logger?.warn?.("jobs.queue.scaleway_sqs.missing_handler", {
+						jobType: envelope.type,
+						messageId: msg.MessageId
+					});
+					await this.deleteMessage(msg.ReceiptHandle);
+					continue;
+				}
+				const now = /* @__PURE__ */ new Date();
+				const attempts = parseInt(msg.Attributes?.ApproximateReceiveCount ?? "1", 10);
+				const job = {
+					id: envelope.id,
+					type: envelope.type,
+					version: 1,
+					payload: envelope.payload,
+					status: "pending",
+					priority: 0,
+					attempts,
+					maxRetries: DEFAULT_RETRY_POLICY.maxRetries,
+					createdAt: now,
+					updatedAt: now
+				};
+				job.status = "running";
+				job.updatedAt = /* @__PURE__ */ new Date();
+				try {
+					await handler(job);
+					job.status = "completed";
+					job.updatedAt = /* @__PURE__ */ new Date();
+					await this.deleteMessage(msg.ReceiptHandle);
+				} catch (err) {
+					job.status = "failed";
+					job.lastError = err instanceof Error ? err.message : "Unknown job error";
+					job.updatedAt = /* @__PURE__ */ new Date();
+					this.logger?.error?.("jobs.queue.scaleway_sqs.job_failed", {
+						jobType: job.type,
+						jobId: job.id,
+						error: err instanceof Error ? err.message : String(err)
+					});
+				}
+			}
+		} catch (err) {
+			this.logger?.error?.("jobs.queue.scaleway_sqs.poll_error", { error: err instanceof Error ? err.message : String(err) });
+			await this.sleep(5e3);
+		}
+		this.logger?.info?.("jobs.queue.scaleway_sqs.stopped", { queueUrl: this.queueUrl });
+	}
+	async deleteMessage(receiptHandle) {
+		try {
+			await this.sqs.send(new DeleteMessageCommand({
+				QueueUrl: this.queueUrl,
+				ReceiptHandle: receiptHandle
+			}));
+		} catch (err) {
+			this.logger?.warn?.("jobs.queue.scaleway_sqs.delete_failed", { error: err instanceof Error ? err.message : String(err) });
+		}
+	}
+	async sleep(ms) {
+		await new Promise((resolve) => setTimeout(resolve, ms));
+	}
+};
+
+//#endregion
+export { ScalewaySqsJobQueue };

package/dist/queue/types.js

@@ -1 +1,3 @@
-import{e,n as t,t as n}from"../contracts/dist/jobs/queue.js";export{e as DEFAULT_RETRY_POLICY,n as calculateBackoff,t as defineJobType};
+import { DEFAULT_RETRY_POLICY, calculateBackoff, defineJobType } from "../contracts/dist/jobs/queue.js";
+
+export { DEFAULT_RETRY_POLICY, calculateBackoff, defineJobType };

package/dist/scheduler/index.js

@@ -1 +1,145 @@
-function e(e,t=new Date){try{let n=e.trim().split(/\s+/);if(n.length!==5)return console.warn(`Invalid cron expression: ${e}`),null;let r=n[0],i=n[1],a=n[2],o=n[3],s=new Date(t);if(s.setSeconds(0),s.setMilliseconds(0),r&&i&&r!==`*`&&i!==`*`&&a===`*`&&o===`*`){let e=Number.parseInt(r,10),n=Number.parseInt(i,10);return s.setHours(n,e,0,0),s<=t&&s.setDate(s.getDate()+1),s}return s.setMinutes(s.getMinutes()+1),s}catch{return null}}var t=class{schedules=new Map;timer;checkIntervalMs;constructor(e,t={}){this.queue=e,this.checkIntervalMs=t.checkIntervalMs??6e4}schedule(t){let n=t.enabled===!1?null:e(t.cronExpression);this.schedules.set(t.name,{...t,enabled:t.enabled??!0,nextRun:n,lastRun:null})}unschedule(e){return this.schedules.delete(e)}enable(t){let n=this.schedules.get(t);return n?(n.enabled=!0,n.nextRun=e(n.cronExpression),!0):!1}disable(e){let t=this.schedules.get(e);return t?(t.enabled=!1,t.nextRun=null,!0):!1}getSchedules(){return Array.from(this.schedules.values())}getSchedule(e){return this.schedules.get(e)}start(){this.timer||=(this.checkSchedules(),setInterval(()=>{this.checkSchedules()},this.checkIntervalMs))}stop(){this.timer&&=(clearInterval(this.timer),void 0)}async checkSchedules(){let t=new Date;for(let n of this.schedules.values())if(!(!n.enabled||!n.nextRun)&&n.nextRun<=t)try{let r=typeof n.payload==`function`?await n.payload():n.payload;await this.queue.enqueue(n.jobType,r,n.options),n.lastRun=t,n.nextRun=e(n.cronExpression,t)}catch(e){console.error(`Failed to enqueue scheduled job ${n.name}:`,e)}}};function n(e,n){return new t(e,n)}function r(e){return e}export{t as JobScheduler,n as createScheduler,r as defineSchedule};
+//#region src/scheduler/index.ts
+/**
+* Parse a cron expression to get the next run time.
+* Simple implementation supporting: minute hour day month weekday
+*/
+function getNextCronRun(cronExpression, after = /* @__PURE__ */ new Date()) {
+	try {
+		const parts = cronExpression.trim().split(/\s+/);
+		if (parts.length !== 5) {
+			console.warn(`Invalid cron expression: ${cronExpression}`);
+			return null;
+		}
+		const minute = parts[0];
+		const hour = parts[1];
+		const dayOfMonth = parts[2];
+		const month = parts[3];
+		const next = new Date(after);
+		next.setSeconds(0);
+		next.setMilliseconds(0);
+		if (minute && hour && minute !== "*" && hour !== "*" && dayOfMonth === "*" && month === "*") {
+			const targetMinute = Number.parseInt(minute, 10);
+			const targetHour = Number.parseInt(hour, 10);
+			next.setHours(targetHour, targetMinute, 0, 0);
+			if (next <= after) next.setDate(next.getDate() + 1);
+			return next;
+		}
+		next.setMinutes(next.getMinutes() + 1);
+		return next;
+	} catch {
+		return null;
+	}
+}
+/**
+* Job scheduler for recurring jobs.
+*/
+var JobScheduler = class {
+	schedules = /* @__PURE__ */ new Map();
+	timer;
+	checkIntervalMs;
+	constructor(queue, options = {}) {
+		this.queue = queue;
+		this.checkIntervalMs = options.checkIntervalMs ?? 6e4;
+	}
+	/**
+	* Add a scheduled job.
+	*/
+	schedule(config) {
+		const nextRun = config.enabled !== false ? getNextCronRun(config.cronExpression) : null;
+		this.schedules.set(config.name, {
+			...config,
+			enabled: config.enabled ?? true,
+			nextRun,
+			lastRun: null
+		});
+	}
+	/**
+	* Remove a scheduled job.
+	*/
+	unschedule(name) {
+		return this.schedules.delete(name);
+	}
+	/**
+	* Enable a scheduled job.
+	*/
+	enable(name) {
+		const schedule = this.schedules.get(name);
+		if (!schedule) return false;
+		schedule.enabled = true;
+		schedule.nextRun = getNextCronRun(schedule.cronExpression);
+		return true;
+	}
+	/**
+	* Disable a scheduled job.
+	*/
+	disable(name) {
+		const schedule = this.schedules.get(name);
+		if (!schedule) return false;
+		schedule.enabled = false;
+		schedule.nextRun = null;
+		return true;
+	}
+	/**
+	* Get all schedules.
+	*/
+	getSchedules() {
+		return Array.from(this.schedules.values());
+	}
+	/**
+	* Get a specific schedule.
+	*/
+	getSchedule(name) {
+		return this.schedules.get(name);
+	}
+	/**
+	* Start the scheduler.
+	*/
+	start() {
+		if (this.timer) return;
+		this.checkSchedules();
+		this.timer = setInterval(() => {
+			this.checkSchedules();
+		}, this.checkIntervalMs);
+	}
+	/**
+	* Stop the scheduler.
+	*/
+	stop() {
+		if (this.timer) {
+			clearInterval(this.timer);
+			this.timer = void 0;
+		}
+	}
+	/**
+	* Check and enqueue due schedules.
+	*/
+	async checkSchedules() {
+		const now = /* @__PURE__ */ new Date();
+		for (const schedule of this.schedules.values()) {
+			if (!schedule.enabled || !schedule.nextRun) continue;
+			if (schedule.nextRun <= now) try {
+				const payload = typeof schedule.payload === "function" ? await schedule.payload() : schedule.payload;
+				await this.queue.enqueue(schedule.jobType, payload, schedule.options);
+				schedule.lastRun = now;
+				schedule.nextRun = getNextCronRun(schedule.cronExpression, now);
+			} catch (error) {
+				console.error(`Failed to enqueue scheduled job ${schedule.name}:`, error);
+			}
+		}
+	}
+};
+/**
+* Create a job scheduler instance.
+*/
+function createScheduler(queue, options) {
+	return new JobScheduler(queue, options);
+}
+/**
+* Helper to define a scheduled job configuration.
+*/
+function defineSchedule(config) {
+	return config;
+}
+
+//#endregion
+export { JobScheduler, createScheduler, defineSchedule };

package/dist/schema/dist/EnumType.js

@@ -1 +1,2 @@
-import"zod";import"graphql";
+import "zod";
+import "graphql";

package/dist/schema/dist/FieldType.js

@@ -1 +1,49 @@
-import"zod";import{GraphQLScalarType as e}from"graphql";var t=class extends e{zodSchema;jsonSchemaDef;constructor(e){super(e),this.zodSchema=e.zod,this.jsonSchemaDef=e.jsonSchema}getZod(){return this.zodSchema}getPothos(){return this}getJson(){return typeof this.jsonSchemaDef==`function`?this.jsonSchemaDef():this.jsonSchemaDef}getJsonSchemaDef(){return this.jsonSchemaDef}getJsonSchema(){let e=t=>{let n=typeof t==`function`?t():t;if(Array.isArray(n))return n.map(t=>e(t));if(n&&typeof n==`object`){let t={};for(let[r,i]of Object.entries(n))t[r]=e(i);return t}return n};return e(this.getJson())}};export{t};
+import "zod";
+import { GraphQLScalarType } from "graphql";
+
+//#region ../schema/dist/FieldType.js
+/**
+* GraphQL scalar wrapper that carries zod and JSON Schema metadata.
+*
+* TInternal is the runtime representation; TExternal is the GraphQL output.
+*/
+var FieldType = class extends GraphQLScalarType {
+	zodSchema;
+	jsonSchemaDef;
+	constructor(config) {
+		super(config);
+		this.zodSchema = config.zod;
+		this.jsonSchemaDef = config.jsonSchema;
+	}
+	/** Return the attached zod schema for validation. */
+	getZod() {
+		return this.zodSchema;
+	}
+	/** GraphQL scalar instance usable by Pothos or vanilla GraphQL. */
+	getPothos() {
+		return this;
+	}
+	/** Return the JSON Schema (evaluates factory if provided). */
+	getJson() {
+		return typeof this.jsonSchemaDef === "function" ? this.jsonSchemaDef() : this.jsonSchemaDef;
+	}
+	getJsonSchemaDef() {
+		return this.jsonSchemaDef;
+	}
+	getJsonSchema() {
+		const deepResolve = (v) => {
+			const value = typeof v === "function" ? v() : v;
+			if (Array.isArray(value)) return value.map((item) => deepResolve(item));
+			if (value && typeof value === "object") {
+				const obj = {};
+				for (const [k, val] of Object.entries(value)) obj[k] = deepResolve(val);
+				return obj;
+			}
+			return value;
+		};
+		return deepResolve(this.getJson());
+	}
+};
+
+//#endregion
+export { FieldType };