@keystrokehq/scheduler 0.0.66

package/dist/index.d.mts

@@ -0,0 +1,68 @@
+import { _ as Scheduler, a as defineSchedulerPlugin, b as retryDelayMs, c as DEFAULT_RETRY_DELAY_MS, f as JobPayload, g as ScheduleTickerOptions, h as ScheduleSyncOptions, i as SchedulerScope, l as EnqueueInput, m as JobTrigger, n as SchedulerPlugin, o as CreateJobQueueOptions, p as JobQueue, r as SchedulerPluginContext, s as CreateSchedulerOptions, u as JobHandler, v as StopFn, y as WorkerOptions } from "./contract-CYKkRmnH.mjs";
+import { PgBoss } from "pg-boss";
+
+//#region src/create-scheduler.d.ts
+declare function createScheduler(options?: CreateSchedulerOptions): Promise<Scheduler>;
+declare function createJobQueue(options?: CreateJobQueueOptions): Promise<JobQueue>;
+declare function wrapJobQueueAsScheduler(jobQueue: JobQueue): Scheduler;
+//#endregion
+//#region src/memory.d.ts
+type MemoryJobQueueOptions = {
+  sync?: boolean;
+};
+declare function createMemoryJobQueue(options?: MemoryJobQueueOptions): JobQueue;
+//#endregion
+//#region src/shared-scheduler.d.ts
+declare function configureSharedScheduler(plugin: SchedulerPlugin): void;
+declare function createSharedScheduler(): Promise<Scheduler>;
+declare function resetSharedSchedulerForTests(): void;
+//#endregion
+//#region src/plugin.d.ts
+/** Postgres pg-boss backend. Platform scope shares one queue; project scope gets a per-project queue. */
+declare function pgBossSchedulerPlugin(): SchedulerPlugin;
+/** DB-table queue (Drizzle `jobs`), for SQLite / self-host. */
+declare function pollingSchedulerPlugin(): SchedulerPlugin;
+/** Auto-selects pg-boss (postgres) or polling (sqlite) by dialect. */
+declare function defaultSchedulerPlugin(): SchedulerPlugin;
+//#endregion
+//#region src/resolve-plugin-from-env.d.ts
+/** Env var naming a module that exports `createSchedulerPlugin(env): SchedulerPlugin`. */
+declare const SCHEDULER_MODULE_ENV = "KEYSTROKE_SCHEDULER_MODULE";
+type SchedulerEnv = Record<string, string | undefined>;
+/**
+ * Resolve a scheduler plugin selected via env so a producer (platform) and a
+ * consumer (container worker) can never diverge on backend. When
+ * `KEYSTROKE_SCHEDULER_MODULE` is set, dynamically import that module and call
+ * its `createSchedulerPlugin(env)`
+ */
+declare function resolveSchedulerPluginFromEnv(env?: SchedulerEnv): Promise<SchedulerPlugin | undefined>;
+//#endregion
+//#region src/pg-boss-client.d.ts
+declare function startPgBoss(url?: string): Promise<PgBoss>;
+declare function getPgBoss(): PgBoss;
+declare function stopPgBoss(): Promise<void>;
+//#endregion
+//#region src/shared-pgboss-queue.d.ts
+declare function createSharedPgBossScheduler(): Promise<Scheduler>;
+declare function getSharedPgBossJobQueue(): Promise<JobQueue>;
+declare function resetSharedPgBossJobQueueForTests(): void;
+//#endregion
+//#region src/pg-boss-queue.d.ts
+/** Shared queue name for the platform control-plane scope. */
+declare const DEFAULT_QUEUE_NAME = "keystroke";
+/**
+ * Derive a per-project pg-boss queue name. pg-boss queue names must be <= 50
+ * chars, contain only [A-Za-z0-9_], and not start with a digit. Project ids are
+ * usually UUIDs (hyphens, may start with a digit), so we sanitize, and fall back
+ * to a hash when the sanitized name would exceed the length limit.
+ */
+declare function pgBossProjectQueueName(projectId: string): string;
+type BuildPgBossJobQueueOptions = {
+  stopBossOnWorkerStop?: boolean;
+  queueName?: string;
+};
+declare function buildPgBossJobQueue(boss: PgBoss, options?: BuildPgBossJobQueueOptions): JobQueue;
+declare function createSharedPgBossJobQueue(boss: PgBoss, queueName?: string): Promise<JobQueue>;
+//#endregion
+export { type CreateJobQueueOptions, type CreateSchedulerOptions, DEFAULT_QUEUE_NAME, DEFAULT_RETRY_DELAY_MS, type EnqueueInput, type JobHandler, type JobPayload, type JobQueue, type JobTrigger, type MemoryJobQueueOptions, SCHEDULER_MODULE_ENV, type ScheduleSyncOptions, type ScheduleTickerOptions, type Scheduler, type SchedulerPlugin, type SchedulerPluginContext, type SchedulerScope, type StopFn, type WorkerOptions, buildPgBossJobQueue, configureSharedScheduler, createJobQueue, createMemoryJobQueue, createScheduler, createSharedPgBossJobQueue, createSharedPgBossScheduler, createSharedScheduler, defaultSchedulerPlugin, defineSchedulerPlugin, getPgBoss, getSharedPgBossJobQueue, pgBossProjectQueueName, pgBossSchedulerPlugin, pollingSchedulerPlugin, resetSharedPgBossJobQueueForTests, resetSharedSchedulerForTests, resolveSchedulerPluginFromEnv, retryDelayMs, startPgBoss, stopPgBoss, wrapJobQueueAsScheduler };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/create-scheduler.ts","../src/memory.ts","../src/shared-scheduler.ts","../src/plugin.ts","../src/resolve-plugin-from-env.ts","../src/pg-boss-client.ts","../src/shared-pgboss-queue.ts","../src/pg-boss-queue.ts"],"mappings":";;;;iBAwCsB,eAAA,CAAgB,OAAA,GAAS,sBAAA,GAA8B,OAAA,CAAQ,SAAA;AAAA,iBAK/D,cAAA,CAAe,OAAA,GAAS,qBAAA,GAA6B,OAAA,CAAQ,QAAA;AAAA,iBAInE,uBAAA,CAAwB,QAAA,EAAU,QAAA,GAAW,SAAS;;;KC9C1D,qBAAA;EACV,IAAI;AAAA;AAAA,iBAGU,oBAAA,CAAqB,OAAA,GAAS,qBAAA,GAA6B,QAAQ;;;iBCKnE,wBAAA,CAAyB,MAAuB,EAAf,eAAe;AAAA,iBAK1C,qBAAA,CAAA,GAAyB,OAAO,CAAC,SAAA;AAAA,iBAcvC,4BAAA,CAAA;;;;iBCHA,qBAAA,CAAA,GAAyB,eAAe;;iBAqBxC,sBAAA,CAAA,GAA0B,eAAe;;iBAUzC,sBAAA,CAAA,GAA0B,eAAe;;;;cCxD5C,oBAAA;AAAA,KAER,YAAA,GAAe,MAAM;AJmC1B;;;;;;AAAA,iBIXsB,6BAAA,CACpB,GAAA,GAAK,YAAA,GACJ,OAAA,CAAQ,eAAA;;;iBChBW,WAAA,CAAY,GAAA,YAAe,OAAO,CAAC,MAAA;AAAA,iBAkBzC,SAAA,CAAA,GAAa,MAAM;AAAA,iBAOb,UAAA,CAAA,GAAc,OAAO;;;iBCjCrB,2BAAA,CAAA,GAA+B,OAAO,CAAC,SAAA;AAAA,iBAKvC,uBAAA,CAAA,GAA2B,OAAO,CAAC,QAAA;AAAA,iBASzC,iCAAA,CAAA;;;;cCfH,kBAAA;APkCb;;;;;;AAAA,iBOzBgB,sBAAA,CAAuB,SAAiB;AAAA,KAyBnD,0BAAA;EACH,oBAAA;EACA,SAAS;AAAA;AAAA,iBAGK,mBAAA,CACd,IAAA,EAAM,MAAA,EACN,OAAA,GAAS,0BAAA,GACR,QAAA;AAAA,iBAyEmB,0BAAA,CACpB,IAAA,EAAM,MAAA,EACN,SAAA,YACC,OAAA,CAAQ,QAAA"}

package/dist/index.mjs

@@ -0,0 +1,440 @@
+import { n as DEFAULT_RETRY_DELAY_MS, r as retryDelayMs, t as defineSchedulerPlugin } from "./contract-E1QJBH6_.mjs";
+import { DEFAULT_DATABASE_URL, claimDueTriggerSchedules, claimNextJob, disableAllTriggerSchedules, disableTriggerSchedulesNotInKeys, enqueueJob, failWorkflowRun, getProjectScopeId, inferDialect, markJobComplete, markJobFailed, requeueExpiredLeases, resolvePostgresUrlFromEnv, resolveProjectDatabaseUrlFromEnv, scheduleJobRetry, selectTriggerScheduleByKey, upsertTriggerSchedule } from "@keystrokehq/database";
+import { nextTriggerRunAt, resolveCronSchedule } from "@keystrokehq/trigger";
+import { PgBoss } from "pg-boss";
+import { createHash } from "node:crypto";
+//#region src/schedule-ticker.ts
+function createScheduleTicker(ctx) {
+	const pollIntervalMs = ctx.pollIntervalMs ?? 1e3;
+	const batchSize = ctx.batchSize ?? 10;
+	async function fireDueSchedules(asOf = /* @__PURE__ */ new Date()) {
+		const claimed = await claimDueTriggerSchedules(asOf, (schedule) => nextTriggerRunAt(schedule, asOf), batchSize);
+		for (const row of claimed) await ctx.jobQueue.enqueue({
+			kind: "trigger",
+			targetId: row.attachmentKey,
+			runId: crypto.randomUUID(),
+			trigger: row.kind,
+			payload: {},
+			scheduledAt: asOf
+		});
+		return claimed.length;
+	}
+	async function startScheduleTicker(options = {}) {
+		const intervalMs = options.pollIntervalMs ?? pollIntervalMs;
+		const limit = options.batchSize ?? batchSize;
+		let running = true;
+		const loop = async () => {
+			while (running) {
+				try {
+					await claimDueTriggerSchedules(/* @__PURE__ */ new Date(), (schedule) => nextTriggerRunAt(schedule, /* @__PURE__ */ new Date()), limit).then(async (claimed) => {
+						for (const row of claimed) await ctx.jobQueue.enqueue({
+							kind: "trigger",
+							targetId: row.attachmentKey,
+							runId: crypto.randomUUID(),
+							trigger: row.kind,
+							payload: {}
+						});
+					});
+				} catch {}
+				await sleep$1(intervalMs);
+			}
+		};
+		loop();
+		return async () => {
+			running = false;
+		};
+	}
+	return {
+		fireDueSchedules,
+		startScheduleTicker
+	};
+}
+function sleep$1(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//#endregion
+//#region src/database-queue.ts
+function toJobPayload(job) {
+	return {
+		jobId: job.id,
+		kind: job.kind,
+		targetId: job.targetId,
+		runId: job.runId,
+		trigger: job.trigger,
+		payload: job.payload,
+		attempt: job.attempt,
+		maxAttempts: job.maxAttempts,
+		scheduledAt: job.scheduledAt
+	};
+}
+function createDatabaseJobQueue() {
+	return {
+		async enqueue(input) {
+			return enqueueJob(input);
+		},
+		async startWorker(handler, options = {}) {
+			const workerId = options.workerId ?? crypto.randomUUID();
+			const pollIntervalMs = options.pollIntervalMs ?? 250;
+			const leaseSweepIntervalMs = options.leaseSweepIntervalMs ?? 3e4;
+			let running = true;
+			const leaseTimer = setInterval(() => {
+				requeueExpiredLeases();
+			}, leaseSweepIntervalMs);
+			const loop = async () => {
+				while (running) try {
+					const job = await claimNextJob(workerId);
+					if (!job) {
+						await sleep(pollIntervalMs);
+						continue;
+					}
+					try {
+						await handler(toJobPayload(job));
+						await markJobComplete(job.id);
+					} catch (error) {
+						if (job.attempt < job.maxAttempts) await scheduleJobRetry(job.id, job.attempt + 1, retryDelayMs(job.attempt));
+						else {
+							await markJobFailed(job.id, error);
+							if (job.kind === "workflow") await failWorkflowRun(job.runId, error);
+						}
+					}
+				} catch {
+					await sleep(pollIntervalMs);
+				}
+			};
+			loop();
+			return async () => {
+				running = false;
+				clearInterval(leaseTimer);
+			};
+		}
+	};
+}
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//#endregion
+//#region src/pg-boss-client.ts
+let boss;
+function resolveDatabaseUrl(url) {
+	const resolved = url ?? resolvePostgresUrlFromEnv(process.env);
+	if (!resolved) throw new Error("DATABASE_URL or POSTGRES_HOST/POSTGRES_USER/POSTGRES_PASSWORD/POSTGRES_DB is required");
+	return resolved;
+}
+async function startPgBoss(url) {
+	if (boss) return boss;
+	const next = new PgBoss({
+		connectionString: resolveDatabaseUrl(url),
+		schema: "pgboss"
+	});
+	next.on("error", (error) => {
+		console.error("[pg-boss]", error);
+	});
+	await next.start();
+	boss = next;
+	return next;
+}
+function getPgBoss() {
+	if (!boss) throw new Error("PgBoss not started. Call startPgBoss() first.");
+	return boss;
+}
+async function stopPgBoss() {
+	if (!boss) return;
+	await boss.stop();
+	boss = void 0;
+}
+//#endregion
+//#region src/pg-boss-queue.ts
+/** Shared queue name for the platform control-plane scope. */
+const DEFAULT_QUEUE_NAME = "keystroke";
+const PGBOSS_SCHEMA = "pgboss";
+/**
+* Derive a per-project pg-boss queue name. pg-boss queue names must be <= 50
+* chars, contain only [A-Za-z0-9_], and not start with a digit. Project ids are
+* usually UUIDs (hyphens, may start with a digit), so we sanitize, and fall back
+* to a hash when the sanitized name would exceed the length limit.
+*/
+function pgBossProjectQueueName(projectId) {
+	const name = `${DEFAULT_QUEUE_NAME}_${projectId.replace(/[^a-zA-Z0-9_]/g, "_")}`;
+	if (name.length <= 50) return name;
+	return `${DEFAULT_QUEUE_NAME}_${createHash("sha1").update(projectId).digest("hex").slice(0, 40)}`;
+}
+function buildPgBossJobQueue(boss, options = {}) {
+	const queueName = options.queueName ?? "keystroke";
+	return {
+		async enqueue(input) {
+			const jobId = await boss.send(queueName, input, {
+				retryLimit: (input.maxAttempts ?? 3) - 1,
+				retryDelay: Math.ceil(retryDelayMs(1) / 1e3),
+				startAfter: input.scheduledAt
+			});
+			if (!jobId) throw new Error("Failed to enqueue job");
+			return jobId;
+		},
+		async startWorker(handler) {
+			let stopped = false;
+			const workerId = await boss.work(queueName, { batchSize: 1 }, async (jobs) => {
+				if (stopped) return;
+				const job = jobs[0];
+				if (!job) return;
+				const data = job.data;
+				await handler({
+					jobId: job.id,
+					kind: data.kind,
+					targetId: data.targetId,
+					runId: data.runId,
+					trigger: data.trigger,
+					payload: data.payload ?? {},
+					attempt: data.attempt ?? 1,
+					maxAttempts: data.maxAttempts ?? 3,
+					scheduledAt: data.scheduledAt ? new Date(data.scheduledAt) : /* @__PURE__ */ new Date()
+				});
+			});
+			return async () => {
+				stopped = true;
+				await boss.offWork(queueName, { id: workerId });
+				if (options.stopBossOnWorkerStop) await boss.stop({
+					graceful: true,
+					timeout: 5e3
+				});
+			};
+		}
+	};
+}
+async function createPgBossQueue(options) {
+	const queueName = options.queueName ?? "keystroke";
+	const boss = new PgBoss({
+		connectionString: options.connectionString,
+		schema: PGBOSS_SCHEMA
+	});
+	await boss.start();
+	await boss.createQueue(queueName);
+	return buildPgBossJobQueue(boss, {
+		stopBossOnWorkerStop: true,
+		queueName
+	});
+}
+async function createSharedPgBossJobQueue(boss, queueName = DEFAULT_QUEUE_NAME) {
+	await boss.createQueue(queueName);
+	return buildPgBossJobQueue(boss, { queueName });
+}
+//#endregion
+//#region src/plugin.ts
+function resolveUrl(ctx) {
+	return ctx.url ?? resolveProjectDatabaseUrlFromEnv(process.env) ?? DEFAULT_DATABASE_URL;
+}
+/** Postgres pg-boss backend. Platform scope shares one queue; project scope gets a per-project queue. */
+function pgBossSchedulerPlugin() {
+	return defineSchedulerPlugin({
+		name: "pg-boss",
+		async createJobQueue(ctx) {
+			const url = resolveUrl(ctx);
+			if (ctx.scope === "platform") {
+				await startPgBoss(url);
+				return createSharedPgBossJobQueue(getPgBoss());
+			}
+			return createPgBossQueue({
+				connectionString: url,
+				queueName: pgBossProjectQueueName(ctx.projectId ?? getProjectScopeId())
+			});
+		}
+	});
+}
+/** DB-table queue (Drizzle `jobs`), for SQLite / self-host. */
+function pollingSchedulerPlugin() {
+	return defineSchedulerPlugin({
+		name: "polling",
+		async createJobQueue() {
+			return createDatabaseJobQueue();
+		}
+	});
+}
+/** Auto-selects pg-boss (postgres) or polling (sqlite) by dialect. */
+function defaultSchedulerPlugin() {
+	return defineSchedulerPlugin({
+		name: "default",
+		async createJobQueue(ctx) {
+			if (inferDialect(resolveUrl(ctx), ctx.dialect) === "postgres") return pgBossSchedulerPlugin().createJobQueue(ctx);
+			return pollingSchedulerPlugin().createJobQueue(ctx);
+		}
+	});
+}
+//#endregion
+//#region src/resolve-schedule.ts
+function resolveTriggerSchedule(attachmentKey, schedule, overrides) {
+	return resolveCronSchedule(attachmentKey, schedule, {
+		cronScheduleOverride: overrides?.global,
+		attachmentScheduleOverrides: overrides?.byAttachment
+	});
+}
+//#endregion
+//#region src/sync-trigger-schedules.ts
+async function syncTriggerSchedules(options) {
+	const now = /* @__PURE__ */ new Date();
+	const keys = options.schedules.map((schedule) => schedule.attachmentKey);
+	if (keys.length === 0) {
+		await disableAllTriggerSchedules(now);
+		return;
+	}
+	await disableTriggerSchedulesNotInKeys(keys, now);
+	for (const spec of options.schedules) {
+		const schedule = resolveTriggerSchedule(spec.attachmentKey, spec.schedule, options.scheduleOverrides);
+		const existing = await selectTriggerScheduleByKey(spec.attachmentKey);
+		const scheduleChanged = existing?.schedule !== schedule;
+		const nextRunAt = existing && !scheduleChanged && existing.enabled === 1 ? existing.nextRunAt : nextTriggerRunAt(schedule, now);
+		await upsertTriggerSchedule({
+			attachmentKey: spec.attachmentKey,
+			kind: spec.kind,
+			schedule,
+			nextRunAt,
+			enabled: true,
+			updatedAt: now
+		});
+	}
+}
+//#endregion
+//#region src/create-scheduler.ts
+async function createUnderlyingJobQueue(options = {}) {
+	if (options.adapter) return options.adapter;
+	return (options.plugin ?? defaultSchedulerPlugin()).createJobQueue({
+		scope: options.scope ?? "project",
+		url: options.url,
+		dialect: options.dialect,
+		projectId: options.projectId,
+		organizationId: options.organizationId
+	});
+}
+function wrapScheduler(jobQueue) {
+	const ticker = createScheduleTicker({ jobQueue });
+	return {
+		enqueue: (input) => jobQueue.enqueue(input),
+		startWorker: (handler, options) => jobQueue.startWorker(handler, options),
+		syncTriggerSchedules: (options) => syncTriggerSchedules(options),
+		startScheduleTicker: (options) => ticker.startScheduleTicker(options),
+		fireDueSchedules: (asOf) => ticker.fireDueSchedules(asOf)
+	};
+}
+async function createScheduler(options = {}) {
+	return wrapScheduler(await createUnderlyingJobQueue(options));
+}
+async function createJobQueue(options = {}) {
+	return createUnderlyingJobQueue(options);
+}
+function wrapJobQueueAsScheduler(jobQueue) {
+	return wrapScheduler(jobQueue);
+}
+//#endregion
+//#region src/memory.ts
+function createMemoryJobQueue(options = {}) {
+	const pending = [];
+	let handler;
+	let draining = false;
+	async function drain() {
+		if (!handler || draining) return;
+		draining = true;
+		try {
+			while (pending.length > 0) {
+				const next = pending.shift();
+				if (!next) break;
+				const input = next.input;
+				await handler({
+					jobId: next.id,
+					kind: input.kind,
+					targetId: input.targetId,
+					runId: input.runId,
+					trigger: input.trigger,
+					payload: input.payload ?? {},
+					attempt: input.attempt ?? 1,
+					maxAttempts: input.maxAttempts ?? 3,
+					scheduledAt: input.scheduledAt ?? next.enqueuedAt
+				});
+			}
+		} finally {
+			draining = false;
+		}
+	}
+	return {
+		async enqueue(input) {
+			const id = crypto.randomUUID();
+			pending.push({
+				id,
+				input,
+				enqueuedAt: /* @__PURE__ */ new Date()
+			});
+			if (options.sync) await drain();
+			return id;
+		},
+		async startWorker(nextHandler, _opts = {}) {
+			handler = nextHandler;
+			if (!options.sync) drain();
+			return async () => {
+				handler = void 0;
+			};
+		}
+	};
+}
+//#endregion
+//#region src/shared-pgboss-queue.ts
+let sharedJobQueue$1;
+async function createSharedPgBossScheduler() {
+	return wrapJobQueueAsScheduler(await getSharedPgBossJobQueue());
+}
+async function getSharedPgBossJobQueue() {
+	if (sharedJobQueue$1) return sharedJobQueue$1;
+	sharedJobQueue$1 = await createSharedPgBossJobQueue(getPgBoss());
+	return sharedJobQueue$1;
+}
+function resetSharedPgBossJobQueueForTests() {
+	sharedJobQueue$1 = void 0;
+}
+//#endregion
+//#region src/shared-scheduler.ts
+let configuredPlugin;
+let sharedJobQueue;
+function configureSharedScheduler(plugin) {
+	configuredPlugin = plugin;
+	sharedJobQueue = void 0;
+}
+async function createSharedScheduler() {
+	const plugin = configuredPlugin ?? defaultSchedulerPlugin();
+	if (plugin.name === "default") return createSharedPgBossScheduler();
+	if (!sharedJobQueue) sharedJobQueue = await plugin.createJobQueue({ scope: "platform" });
+	return wrapJobQueueAsScheduler(sharedJobQueue);
+}
+function resetSharedSchedulerForTests() {
+	configuredPlugin = void 0;
+	sharedJobQueue = void 0;
+	resetSharedPgBossJobQueueForTests();
+}
+//#endregion
+//#region src/resolve-plugin-from-env.ts
+/** Env var naming a module that exports `createSchedulerPlugin(env): SchedulerPlugin`. */
+const SCHEDULER_MODULE_ENV = "KEYSTROKE_SCHEDULER_MODULE";
+function isSchedulerPlugin(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const candidate = value;
+	return typeof candidate.name === "string" && typeof candidate.createJobQueue === "function";
+}
+function getCreateSchedulerPlugin(mod) {
+	if (typeof mod !== "object" || mod === null) return;
+	const factory = mod.createSchedulerPlugin;
+	return typeof factory === "function" ? factory : void 0;
+}
+/**
+* Resolve a scheduler plugin selected via env so a producer (platform) and a
+* consumer (container worker) can never diverge on backend. When
+* `KEYSTROKE_SCHEDULER_MODULE` is set, dynamically import that module and call
+* its `createSchedulerPlugin(env)`
+*/
+async function resolveSchedulerPluginFromEnv(env = process.env) {
+	const moduleSpecifier = env[SCHEDULER_MODULE_ENV]?.trim();
+	if (!moduleSpecifier) return;
+	const createSchedulerPlugin = getCreateSchedulerPlugin(await import(moduleSpecifier));
+	if (!createSchedulerPlugin) throw new Error(`Scheduler module "${moduleSpecifier}" must export createSchedulerPlugin(env): SchedulerPlugin`);
+	const plugin = createSchedulerPlugin(env);
+	if (!isSchedulerPlugin(plugin)) throw new Error(`Scheduler module "${moduleSpecifier}" createSchedulerPlugin(env) did not return a valid SchedulerPlugin (expected { name: string, createJobQueue: function })`);
+	return plugin;
+}
+//#endregion
+export { DEFAULT_QUEUE_NAME, DEFAULT_RETRY_DELAY_MS, SCHEDULER_MODULE_ENV, buildPgBossJobQueue, configureSharedScheduler, createJobQueue, createMemoryJobQueue, createScheduler, createSharedPgBossJobQueue, createSharedPgBossScheduler, createSharedScheduler, defaultSchedulerPlugin, defineSchedulerPlugin, getPgBoss, getSharedPgBossJobQueue, pgBossProjectQueueName, pgBossSchedulerPlugin, pollingSchedulerPlugin, resetSharedPgBossJobQueueForTests, resetSharedSchedulerForTests, resolveSchedulerPluginFromEnv, retryDelayMs, startPgBoss, stopPgBoss, wrapJobQueueAsScheduler };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["sleep","syncTriggerScheduleRows","sharedJobQueue"],"sources":["../src/schedule-ticker.ts","../src/database-queue.ts","../src/pg-boss-client.ts","../src/pg-boss-queue.ts","../src/plugin.ts","../src/resolve-schedule.ts","../src/sync-trigger-schedules.ts","../src/create-scheduler.ts","../src/memory.ts","../src/shared-pgboss-queue.ts","../src/shared-scheduler.ts","../src/resolve-plugin-from-env.ts"],"sourcesContent":["import { claimDueTriggerSchedules } from \"@keystrokehq/database\";\nimport { nextTriggerRunAt } from \"@keystrokehq/trigger\";\nimport type { JobQueue, ScheduleTickerOptions, StopFn } from \"./types\";\n\nexport type ScheduleTickerContext = {\n  jobQueue: JobQueue;\n  pollIntervalMs?: number;\n  batchSize?: number;\n};\n\nexport function createScheduleTicker(ctx: ScheduleTickerContext) {\n  const pollIntervalMs = ctx.pollIntervalMs ?? 1_000;\n  const batchSize = ctx.batchSize ?? 10;\n\n  async function fireDueSchedules(asOf = new Date()): Promise<number> {\n    const claimed = await claimDueTriggerSchedules(\n      asOf,\n      (schedule) => nextTriggerRunAt(schedule, asOf),\n      batchSize,\n    );\n\n    for (const row of claimed) {\n      await ctx.jobQueue.enqueue({\n        kind: \"trigger\",\n        targetId: row.attachmentKey,\n        runId: crypto.randomUUID(),\n        trigger: row.kind,\n        payload: {},\n        scheduledAt: asOf,\n      });\n    }\n\n    return claimed.length;\n  }\n\n  async function startScheduleTicker(options: ScheduleTickerOptions = {}): Promise<StopFn> {\n    const intervalMs = options.pollIntervalMs ?? pollIntervalMs;\n    const limit = options.batchSize ?? batchSize;\n    let running = true;\n\n    const loop = async () => {\n      while (running) {\n        try {\n          await claimDueTriggerSchedules(\n            new Date(),\n            (schedule) => nextTriggerRunAt(schedule, new Date()),\n            limit,\n          ).then(async (claimed) => {\n            for (const row of claimed) {\n              await ctx.jobQueue.enqueue({\n                kind: \"trigger\",\n                targetId: row.attachmentKey,\n                runId: crypto.randomUUID(),\n                trigger: row.kind,\n                payload: {},\n              });\n            }\n          });\n        } catch {\n          // keep ticking\n        }\n\n        await sleep(intervalMs);\n      }\n    };\n\n    void loop();\n\n    return async () => {\n      running = false;\n    };\n  }\n\n  return { fireDueSchedules, startScheduleTicker };\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import {\n  claimNextJob,\n  enqueueJob,\n  failWorkflowRun,\n  markJobComplete,\n  markJobFailed,\n  requeueExpiredLeases,\n  scheduleJobRetry,\n} from \"@keystrokehq/database\";\nimport type { ClaimedJob } from \"@keystrokehq/database\";\nimport type { JobHandler, JobQueue, StopFn, WorkerOptions } from \"./types\";\nimport { retryDelayMs } from \"./types\";\n\nfunction toJobPayload(job: ClaimedJob): Parameters<JobHandler>[0] {\n  return {\n    jobId: job.id,\n    kind: job.kind,\n    targetId: job.targetId,\n    runId: job.runId,\n    trigger: job.trigger,\n    payload: job.payload,\n    attempt: job.attempt,\n    maxAttempts: job.maxAttempts,\n    scheduledAt: job.scheduledAt,\n  };\n}\n\nexport function createDatabaseJobQueue(): JobQueue {\n  return {\n    async enqueue(input) {\n      return enqueueJob(input);\n    },\n\n    async startWorker(handler: JobHandler, options: WorkerOptions = {}): Promise<StopFn> {\n      const workerId = options.workerId ?? crypto.randomUUID();\n      const pollIntervalMs = options.pollIntervalMs ?? 250;\n      const leaseSweepIntervalMs = options.leaseSweepIntervalMs ?? 30_000;\n      let running = true;\n\n      const leaseTimer = setInterval(() => {\n        void requeueExpiredLeases();\n      }, leaseSweepIntervalMs);\n\n      const loop = async () => {\n        while (running) {\n          try {\n            const job = await claimNextJob(workerId);\n            if (!job) {\n              await sleep(pollIntervalMs);\n              continue;\n            }\n\n            try {\n              await handler(toJobPayload(job));\n              await markJobComplete(job.id);\n            } catch (error) {\n              if (job.attempt < job.maxAttempts) {\n                await scheduleJobRetry(job.id, job.attempt + 1, retryDelayMs(job.attempt));\n              } else {\n                await markJobFailed(job.id, error);\n                if (job.kind === \"workflow\") {\n                  await failWorkflowRun(job.runId, error);\n                }\n              }\n            }\n          } catch {\n            await sleep(pollIntervalMs);\n          }\n        }\n      };\n\n      void loop();\n\n      return async () => {\n        running = false;\n        clearInterval(leaseTimer);\n      };\n    },\n  };\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import { resolvePostgresUrlFromEnv } from \"@keystrokehq/database\";\nimport { PgBoss } from \"pg-boss\";\n\nlet boss: PgBoss | undefined;\n\nfunction resolveDatabaseUrl(url?: string): string {\n  const resolved = url ?? resolvePostgresUrlFromEnv(process.env);\n  if (!resolved) {\n    throw new Error(\n      \"DATABASE_URL or POSTGRES_HOST/POSTGRES_USER/POSTGRES_PASSWORD/POSTGRES_DB is required\",\n    );\n  }\n  return resolved;\n}\n\nexport async function startPgBoss(url?: string): Promise<PgBoss> {\n  if (boss) {\n    return boss;\n  }\n\n  const next = new PgBoss({\n    connectionString: resolveDatabaseUrl(url),\n    schema: \"pgboss\",\n  });\n  next.on(\"error\", (error) => {\n    console.error(\"[pg-boss]\", error);\n  });\n\n  await next.start();\n  boss = next;\n  return next;\n}\n\nexport function getPgBoss(): PgBoss {\n  if (!boss) {\n    throw new Error(\"PgBoss not started. Call startPgBoss() first.\");\n  }\n  return boss;\n}\n\nexport async function stopPgBoss(): Promise<void> {\n  if (!boss) {\n    return;\n  }\n\n  await boss.stop();\n  boss = undefined;\n}\n","import { createHash } from \"node:crypto\";\nimport { PgBoss, type Job } from \"pg-boss\";\nimport type { JobHandler, JobQueue, StopFn } from \"./types\";\nimport { retryDelayMs } from \"./types\";\n\n/** Shared queue name for the platform control-plane scope. */\nexport const DEFAULT_QUEUE_NAME = \"keystroke\";\nconst PGBOSS_SCHEMA = \"pgboss\";\n\n/**\n * Derive a per-project pg-boss queue name. pg-boss queue names must be <= 50\n * chars, contain only [A-Za-z0-9_], and not start with a digit. Project ids are\n * usually UUIDs (hyphens, may start with a digit), so we sanitize, and fall back\n * to a hash when the sanitized name would exceed the length limit.\n */\nexport function pgBossProjectQueueName(projectId: string): string {\n  const sanitized = projectId.replace(/[^a-zA-Z0-9_]/g, \"_\");\n  const name = `${DEFAULT_QUEUE_NAME}_${sanitized}`;\n  if (name.length <= 50) {\n    return name;\n  }\n  return `${DEFAULT_QUEUE_NAME}_${createHash(\"sha1\").update(projectId).digest(\"hex\").slice(0, 40)}`;\n}\n\nexport type PgBossQueueOptions = {\n  connectionString: string;\n  queueName?: string;\n};\n\ntype PgBossJobData = {\n  kind: \"workflow\" | \"agent\" | \"trigger\";\n  targetId: string;\n  runId: string;\n  trigger: \"api\" | \"cron\" | \"webhook\" | \"poll\" | \"retry\" | \"prompt\";\n  payload?: unknown;\n  attempt?: number;\n  maxAttempts?: number;\n  scheduledAt?: string;\n};\n\ntype BuildPgBossJobQueueOptions = {\n  stopBossOnWorkerStop?: boolean;\n  queueName?: string;\n};\n\nexport function buildPgBossJobQueue(\n  boss: PgBoss,\n  options: BuildPgBossJobQueueOptions = {},\n): JobQueue {\n  const queueName = options.queueName ?? DEFAULT_QUEUE_NAME;\n\n  return {\n    async enqueue(input) {\n      const jobId = await boss.send(queueName, input, {\n        retryLimit: (input.maxAttempts ?? 3) - 1,\n        retryDelay: Math.ceil(retryDelayMs(1) / 1000),\n        startAfter: input.scheduledAt,\n      });\n\n      if (!jobId) {\n        throw new Error(\"Failed to enqueue job\");\n      }\n\n      return jobId;\n    },\n\n    async startWorker(handler: JobHandler): Promise<StopFn> {\n      let stopped = false;\n\n      const workerId = await boss.work<PgBossJobData>(\n        queueName,\n        { batchSize: 1 },\n        async (jobs: Job<PgBossJobData>[]) => {\n          if (stopped) {\n            return;\n          }\n\n          const job = jobs[0];\n          if (!job) {\n            return;\n          }\n\n          const data = job.data;\n\n          await handler({\n            jobId: job.id,\n            kind: data.kind,\n            targetId: data.targetId,\n            runId: data.runId,\n            trigger: data.trigger,\n            payload: data.payload ?? {},\n            attempt: data.attempt ?? 1,\n            maxAttempts: data.maxAttempts ?? 3,\n            scheduledAt: data.scheduledAt ? new Date(data.scheduledAt) : new Date(),\n          });\n        },\n      );\n\n      return async () => {\n        stopped = true;\n        await boss.offWork(queueName, { id: workerId });\n        if (options.stopBossOnWorkerStop) {\n          await boss.stop({ graceful: true, timeout: 5_000 });\n        }\n      };\n    },\n  };\n}\n\nexport async function createPgBossQueue(options: PgBossQueueOptions): Promise<JobQueue> {\n  const queueName = options.queueName ?? DEFAULT_QUEUE_NAME;\n  const boss = new PgBoss({\n    connectionString: options.connectionString,\n    schema: PGBOSS_SCHEMA,\n  });\n  await boss.start();\n  await boss.createQueue(queueName);\n\n  return buildPgBossJobQueue(boss, { stopBossOnWorkerStop: true, queueName });\n}\n\nexport async function createSharedPgBossJobQueue(\n  boss: PgBoss,\n  queueName: string = DEFAULT_QUEUE_NAME,\n): Promise<JobQueue> {\n  await boss.createQueue(queueName);\n  return buildPgBossJobQueue(boss, { queueName });\n}\n","import {\n  DEFAULT_DATABASE_URL,\n  getProjectScopeId,\n  inferDialect,\n  resolveProjectDatabaseUrlFromEnv,\n} from \"@keystrokehq/database\";\n\nimport {\n  defineSchedulerPlugin,\n  type SchedulerPlugin,\n  type SchedulerPluginContext,\n} from \"./contract\";\nimport { createDatabaseJobQueue } from \"./database-queue\";\nimport { getPgBoss, startPgBoss } from \"./pg-boss-client\";\nimport {\n  createPgBossQueue,\n  createSharedPgBossJobQueue,\n  pgBossProjectQueueName,\n} from \"./pg-boss-queue\";\n\nexport type { SchedulerPlugin, SchedulerPluginContext, SchedulerScope } from \"./contract\";\nexport { defineSchedulerPlugin } from \"./contract\";\n\nfunction resolveUrl(ctx: SchedulerPluginContext): string {\n  return ctx.url ?? resolveProjectDatabaseUrlFromEnv(process.env) ?? DEFAULT_DATABASE_URL;\n}\n\n/** Postgres pg-boss backend. Platform scope shares one queue; project scope gets a per-project queue. */\nexport function pgBossSchedulerPlugin(): SchedulerPlugin {\n  return defineSchedulerPlugin({\n    name: \"pg-boss\",\n    async createJobQueue(ctx) {\n      const url = resolveUrl(ctx);\n\n      if (ctx.scope === \"platform\") {\n        await startPgBoss(url);\n        return createSharedPgBossJobQueue(getPgBoss());\n      }\n\n      const projectId = ctx.projectId ?? getProjectScopeId();\n      return createPgBossQueue({\n        connectionString: url,\n        queueName: pgBossProjectQueueName(projectId),\n      });\n    },\n  });\n}\n\n/** DB-table queue (Drizzle `jobs`), for SQLite / self-host. */\nexport function pollingSchedulerPlugin(): SchedulerPlugin {\n  return defineSchedulerPlugin({\n    name: \"polling\",\n    async createJobQueue() {\n      return createDatabaseJobQueue();\n    },\n  });\n}\n\n/** Auto-selects pg-boss (postgres) or polling (sqlite) by dialect. */\nexport function defaultSchedulerPlugin(): SchedulerPlugin {\n  return defineSchedulerPlugin({\n    name: \"default\",\n    async createJobQueue(ctx) {\n      const url = resolveUrl(ctx);\n      const dialect = inferDialect(url, ctx.dialect);\n\n      if (dialect === \"postgres\") {\n        return pgBossSchedulerPlugin().createJobQueue(ctx);\n      }\n\n      return pollingSchedulerPlugin().createJobQueue(ctx);\n    },\n  });\n}\n","import { resolveCronSchedule } from \"@keystrokehq/trigger\";\n\nexport type ScheduleOverrideOptions = {\n  global?: string;\n  byAttachment?: Record<string, string>;\n};\n\nexport function resolveTriggerSchedule(\n  attachmentKey: string,\n  schedule: string,\n  overrides?: ScheduleOverrideOptions,\n): string {\n  return resolveCronSchedule(attachmentKey, schedule, {\n    cronScheduleOverride: overrides?.global,\n    attachmentScheduleOverrides: overrides?.byAttachment,\n  });\n}\n","import {\n  disableAllTriggerSchedules,\n  disableTriggerSchedulesNotInKeys,\n  selectTriggerScheduleByKey,\n  upsertTriggerSchedule,\n} from \"@keystrokehq/database\";\nimport { nextTriggerRunAt } from \"@keystrokehq/trigger\";\nimport type { ScheduleSyncOptions } from \"./types\";\nimport { resolveTriggerSchedule } from \"./resolve-schedule\";\n\nexport async function syncTriggerSchedules(options: ScheduleSyncOptions): Promise<void> {\n  const now = new Date();\n  const keys = options.schedules.map((schedule) => schedule.attachmentKey);\n\n  if (keys.length === 0) {\n    await disableAllTriggerSchedules(now);\n    return;\n  }\n\n  await disableTriggerSchedulesNotInKeys(keys, now);\n\n  for (const spec of options.schedules) {\n    const schedule = resolveTriggerSchedule(\n      spec.attachmentKey,\n      spec.schedule,\n      options.scheduleOverrides,\n    );\n    const existing = await selectTriggerScheduleByKey(spec.attachmentKey);\n    const scheduleChanged = existing?.schedule !== schedule;\n    const nextRunAt =\n      existing && !scheduleChanged && existing.enabled === 1\n        ? existing.nextRunAt\n        : nextTriggerRunAt(schedule, now);\n\n    await upsertTriggerSchedule({\n      attachmentKey: spec.attachmentKey,\n      kind: spec.kind,\n      schedule,\n      nextRunAt,\n      enabled: true,\n      updatedAt: now,\n    });\n  }\n}\n","import { createScheduleTicker } from \"./schedule-ticker\";\nimport { defaultSchedulerPlugin } from \"./plugin\";\nimport { syncTriggerSchedules as syncTriggerScheduleRows } from \"./sync-trigger-schedules\";\nimport type {\n  CreateJobQueueOptions,\n  CreateSchedulerOptions,\n  JobQueue,\n  ScheduleSyncOptions,\n  ScheduleTickerOptions,\n  Scheduler,\n  StopFn,\n} from \"./types\";\n\nasync function createUnderlyingJobQueue(options: CreateJobQueueOptions = {}): Promise<JobQueue> {\n  if (options.adapter) {\n    return options.adapter;\n  }\n\n  const plugin = options.plugin ?? defaultSchedulerPlugin();\n  return plugin.createJobQueue({\n    scope: options.scope ?? \"project\",\n    url: options.url,\n    dialect: options.dialect,\n    projectId: options.projectId,\n    organizationId: options.organizationId,\n  });\n}\n\nfunction wrapScheduler(jobQueue: JobQueue): Scheduler {\n  const ticker = createScheduleTicker({ jobQueue });\n\n  return {\n    enqueue: (input) => jobQueue.enqueue(input),\n    startWorker: (handler, options) => jobQueue.startWorker(handler, options),\n    syncTriggerSchedules: (options: ScheduleSyncOptions) => syncTriggerScheduleRows(options),\n    startScheduleTicker: (options?: ScheduleTickerOptions) => ticker.startScheduleTicker(options),\n    fireDueSchedules: (asOf?: Date) => ticker.fireDueSchedules(asOf),\n  };\n}\n\nexport async function createScheduler(options: CreateSchedulerOptions = {}): Promise<Scheduler> {\n  const jobQueue = await createUnderlyingJobQueue(options);\n  return wrapScheduler(jobQueue);\n}\n\nexport async function createJobQueue(options: CreateJobQueueOptions = {}): Promise<JobQueue> {\n  return createUnderlyingJobQueue(options);\n}\n\nexport function wrapJobQueueAsScheduler(jobQueue: JobQueue): Scheduler {\n  return wrapScheduler(jobQueue);\n}\n\nexport type { StopFn };\n","import type { EnqueueInput, JobHandler, JobQueue, StopFn, WorkerOptions } from \"./types\";\nimport { retryDelayMs } from \"./types\";\n\nexport type MemoryJobQueueOptions = {\n  sync?: boolean;\n};\n\nexport function createMemoryJobQueue(options: MemoryJobQueueOptions = {}): JobQueue {\n  const pending: Array<{ id: string; input: EnqueueInput; enqueuedAt: Date }> = [];\n  let handler: JobHandler | undefined;\n  let draining = false;\n\n  async function drain(): Promise<void> {\n    if (!handler || draining) {\n      return;\n    }\n\n    draining = true;\n    try {\n      while (pending.length > 0) {\n        const next = pending.shift();\n        if (!next) {\n          break;\n        }\n\n        const input = next.input;\n        await handler({\n          jobId: next.id,\n          kind: input.kind,\n          targetId: input.targetId,\n          runId: input.runId,\n          trigger: input.trigger,\n          payload: input.payload ?? {},\n          attempt: input.attempt ?? 1,\n          maxAttempts: input.maxAttempts ?? 3,\n          scheduledAt: input.scheduledAt ?? next.enqueuedAt,\n        });\n      }\n    } finally {\n      draining = false;\n    }\n  }\n\n  return {\n    async enqueue(input) {\n      const id = crypto.randomUUID();\n      pending.push({ id, input, enqueuedAt: new Date() });\n\n      if (options.sync) {\n        await drain();\n      }\n\n      return id;\n    },\n\n    async startWorker(nextHandler: JobHandler, _opts: WorkerOptions = {}): Promise<StopFn> {\n      handler = nextHandler;\n\n      if (!options.sync) {\n        void drain();\n      }\n\n      return async () => {\n        handler = undefined;\n      };\n    },\n  };\n}\n\nexport { retryDelayMs };\n","import { getPgBoss } from \"./pg-boss-client\";\nimport { wrapJobQueueAsScheduler } from \"./create-scheduler\";\nimport { createSharedPgBossJobQueue } from \"./pg-boss-queue\";\nimport type { JobQueue, Scheduler } from \"./types\";\n\nlet sharedJobQueue: JobQueue | undefined;\n\nexport async function createSharedPgBossScheduler(): Promise<Scheduler> {\n  const jobQueue = await getSharedPgBossJobQueue();\n  return wrapJobQueueAsScheduler(jobQueue);\n}\n\nexport async function getSharedPgBossJobQueue(): Promise<JobQueue> {\n  if (sharedJobQueue) {\n    return sharedJobQueue;\n  }\n\n  sharedJobQueue = await createSharedPgBossJobQueue(getPgBoss());\n  return sharedJobQueue;\n}\n\nexport function resetSharedPgBossJobQueueForTests(): void {\n  sharedJobQueue = undefined;\n}\n","import type { SchedulerPlugin } from \"./contract\";\nimport { wrapJobQueueAsScheduler } from \"./create-scheduler\";\nimport { defaultSchedulerPlugin } from \"./plugin\";\nimport {\n  createSharedPgBossScheduler,\n  resetSharedPgBossJobQueueForTests,\n} from \"./shared-pgboss-queue\";\nimport type { JobQueue, Scheduler } from \"./types\";\n\nlet configuredPlugin: SchedulerPlugin | undefined;\nlet sharedJobQueue: JobQueue | undefined;\n\nexport function configureSharedScheduler(plugin: SchedulerPlugin): void {\n  configuredPlugin = plugin;\n  sharedJobQueue = undefined;\n}\n\nexport async function createSharedScheduler(): Promise<Scheduler> {\n  const plugin = configuredPlugin ?? defaultSchedulerPlugin();\n\n  if (plugin.name === \"default\") {\n    return createSharedPgBossScheduler();\n  }\n\n  if (!sharedJobQueue) {\n    sharedJobQueue = await plugin.createJobQueue({ scope: \"platform\" });\n  }\n\n  return wrapJobQueueAsScheduler(sharedJobQueue);\n}\n\nexport function resetSharedSchedulerForTests(): void {\n  configuredPlugin = undefined;\n  sharedJobQueue = undefined;\n  resetSharedPgBossJobQueueForTests();\n}\n","import type { SchedulerPlugin } from \"./contract\";\n\n/** Env var naming a module that exports `createSchedulerPlugin(env): SchedulerPlugin`. */\nexport const SCHEDULER_MODULE_ENV = \"KEYSTROKE_SCHEDULER_MODULE\";\n\ntype SchedulerEnv = Record<string, string | undefined>;\n\nfunction isSchedulerPlugin(value: unknown): value is SchedulerPlugin {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n  const candidate = value as Record<string, unknown>;\n  return typeof candidate.name === \"string\" && typeof candidate.createJobQueue === \"function\";\n}\n\nfunction getCreateSchedulerPlugin(mod: unknown): ((env: SchedulerEnv) => unknown) | undefined {\n  if (typeof mod !== \"object\" || mod === null) {\n    return undefined;\n  }\n  const factory = (mod as Record<string, unknown>).createSchedulerPlugin;\n  return typeof factory === \"function\" ? (factory as (env: SchedulerEnv) => unknown) : undefined;\n}\n\n/**\n * Resolve a scheduler plugin selected via env so a producer (platform) and a\n * consumer (container worker) can never diverge on backend. When\n * `KEYSTROKE_SCHEDULER_MODULE` is set, dynamically import that module and call\n * its `createSchedulerPlugin(env)`\n */\nexport async function resolveSchedulerPluginFromEnv(\n  env: SchedulerEnv = process.env,\n): Promise<SchedulerPlugin | undefined> {\n  const moduleSpecifier = env[SCHEDULER_MODULE_ENV]?.trim();\n  if (!moduleSpecifier) {\n    return undefined;\n  }\n\n  const mod: unknown = await import(moduleSpecifier);\n  const createSchedulerPlugin = getCreateSchedulerPlugin(mod);\n  if (!createSchedulerPlugin) {\n    throw new Error(\n      `Scheduler module \"${moduleSpecifier}\" must export createSchedulerPlugin(env): SchedulerPlugin`,\n    );\n  }\n\n  const plugin = createSchedulerPlugin(env);\n  if (!isSchedulerPlugin(plugin)) {\n    throw new Error(\n      `Scheduler module \"${moduleSpecifier}\" createSchedulerPlugin(env) did not return a valid SchedulerPlugin (expected { name: string, createJobQueue: function })`,\n    );\n  }\n\n  return plugin;\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@keystrokehq/scheduler",
+  "version": "0.0.66",
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dallinbentley/keystroke.git",
+    "directory": "packages/scheduler"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./contract": {
+      "development": "./src/contract.ts",
+      "types": "./dist/contract.d.mts",
+      "import": "./dist/contract.mjs",
+      "require": "./dist/contract.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "cron-schedule": "^6.0.0",
+    "pg-boss": "^12.18.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "oxlint": "^1.66.0",
+    "tsdown": "^0.22.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7",
+    "@keystrokehq/database": "0.0.62",
+    "@keystrokehq/trigger": "0.0.64",
+    "@keystrokehq/tsdown-config": "0.0.3",
+    "@keystrokehq/vitest-config": "0.0.4",
+    "@keystrokehq/oxlint-config": "0.0.3",
+    "@keystrokehq/tsconfig": "0.0.3"
+  },
+  "peerDependencies": {
+    "@keystrokehq/database": "0.0.62",
+    "@keystrokehq/trigger": "0.0.64"
+  },
+  "peerDependenciesMeta": {
+    "@keystrokehq/database": {
+      "optional": true
+    },
+    "@keystrokehq/trigger": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch --no-clean",
+    "lint": "oxlint .",
+    "test": "vitest run",
+    "test:unit": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "typecheck": "tsc --noEmit"
+  }
+}