@tanstack/workflow-runtime 0.0.1

package/dist/runtime-driver.js

@@ -0,0 +1,334 @@
+import { createRunStoreAdapter } from "./run-store-adapter.js";
+import { runWorkflow } from "@tanstack/workflow-core";
+
+//#region src/runtime-driver.ts
+const DEFAULT_LEASE_MS = 3e4;
+const DEFAULT_SWEEP_LIMIT = 25;
+function createRuntimeDriver(config) {
+	return {
+		startRun(args) {
+			return startRun(config, args);
+		},
+		deliverSignal(args) {
+			return deliverSignal(config, args);
+		},
+		deliverApproval(args) {
+			return deliverApproval(config, args);
+		},
+		sweep(args = {}) {
+			return sweep(config, args);
+		}
+	};
+}
+async function startRun(config, args) {
+	const now = args.now ?? Date.now();
+	const workflow = await loadWorkflow(config, args.workflowId);
+	const workflowVersion = workflow.version;
+	await config.store.createRun({
+		runId: args.runId,
+		workflowId: args.workflowId,
+		workflowVersion,
+		input: args.input,
+		now
+	});
+	return driveClaimedRun(config, {
+		workflow,
+		workflowId: args.workflowId,
+		runId: args.runId,
+		input: args.input,
+		now,
+		leaseOwner: args.leaseOwner,
+		leaseMs: args.leaseMs,
+		threadId: args.threadId,
+		includeEvents: args.includeEvents,
+		maxEvents: args.maxEvents
+	});
+}
+async function deliverSignal(config, args) {
+	const now = args.now ?? Date.now();
+	const delivery = {
+		signalId: args.signalId,
+		name: args.name,
+		payload: args.payload
+	};
+	const delivered = await config.store.deliverSignal({
+		runId: args.runId,
+		delivery,
+		now
+	});
+	if (delivered.kind !== "delivered") return resultFromSignalDelivery(args.runId, delivered);
+	return driveClaimedRun(config, {
+		workflow: await loadWorkflow(config, delivered.run.workflowId),
+		workflowId: delivered.run.workflowId,
+		runId: args.runId,
+		signalDelivery: delivery,
+		now,
+		leaseOwner: args.leaseOwner,
+		leaseMs: args.leaseMs,
+		threadId: args.threadId,
+		includeEvents: args.includeEvents,
+		maxEvents: args.maxEvents
+	});
+}
+async function deliverApproval(config, args) {
+	const now = args.now ?? Date.now();
+	const delivered = await config.store.deliverApproval({
+		runId: args.runId,
+		approval: args.approval,
+		now
+	});
+	if (delivered.kind !== "delivered") return resultFromApprovalDelivery(args.runId, delivered);
+	return driveClaimedRun(config, {
+		workflow: await loadWorkflow(config, delivered.run.workflowId),
+		workflowId: delivered.run.workflowId,
+		runId: args.runId,
+		approval: args.approval,
+		now,
+		leaseOwner: args.leaseOwner,
+		leaseMs: args.leaseMs,
+		threadId: args.threadId,
+		includeEvents: args.includeEvents,
+		maxEvents: args.maxEvents
+	});
+}
+async function sweep(config, args) {
+	const now = args.now ?? Date.now();
+	const startedAt = Date.now();
+	const maxScheduledRuns = normalizeSweepLimit(args.maxScheduledRuns ?? args.limit, DEFAULT_SWEEP_LIMIT, "maxScheduledRuns");
+	const maxTimers = normalizeSweepLimit(args.maxTimers ?? args.limit, DEFAULT_SWEEP_LIMIT, "maxTimers");
+	const leaseOwner = args.leaseOwner ?? `sweep:${now}`;
+	const leaseMs = args.leaseMs ?? config.defaultLeaseMs ?? DEFAULT_LEASE_MS;
+	const scheduled = [];
+	const timers = [];
+	let deadlineReached = false;
+	while (scheduled.length < maxScheduledRuns) {
+		if (isPastSweepDeadline(startedAt, args.maxDurationMs)) {
+			deadlineReached = true;
+			break;
+		}
+		const bucket = (await config.store.claimDueScheduleBuckets({
+			now,
+			limit: 1,
+			leaseOwner,
+			leaseMs
+		}))[0];
+		if (!bucket) break;
+		const result = await startRun(config, {
+			workflowId: bucket.workflowId,
+			runId: bucket.runId,
+			input: bucket.input,
+			now,
+			leaseOwner,
+			leaseMs,
+			includeEvents: args.includeEvents,
+			maxEvents: args.maxEvents
+		});
+		if (result.kind !== "not-claimable" && result.kind !== "not-found") await config.store.markScheduleBucketStarted({
+			scheduleId: bucket.scheduleId,
+			bucketId: bucket.bucketId,
+			runId: bucket.runId,
+			now
+		});
+		scheduled.push(result);
+	}
+	while (timers.length < maxTimers) {
+		if (isPastSweepDeadline(startedAt, args.maxDurationMs)) {
+			deadlineReached = true;
+			break;
+		}
+		const timer = (await config.store.claimDueTimers({
+			now,
+			limit: 1,
+			leaseOwner,
+			leaseMs
+		}))[0];
+		if (!timer) break;
+		timers.push(await deliverTimer(config, {
+			timer,
+			now,
+			leaseOwner,
+			leaseMs,
+			includeEvents: args.includeEvents,
+			maxEvents: args.maxEvents
+		}));
+	}
+	return {
+		scheduled,
+		timers,
+		summary: summarizeSweep(scheduled, timers),
+		deadlineReached,
+		remainingMayExist: deadlineReached || scheduled.length >= maxScheduledRuns || timers.length >= maxTimers
+	};
+}
+async function deliverTimer(config, args) {
+	return deliverSignal(config, {
+		runId: args.timer.runId,
+		signalId: args.timer.signalId,
+		name: "__timer",
+		payload: void 0,
+		now: args.now,
+		leaseOwner: args.leaseOwner,
+		leaseMs: args.leaseMs,
+		includeEvents: args.includeEvents,
+		maxEvents: args.maxEvents
+	});
+}
+async function driveClaimedRun(config, args) {
+	const leaseOwner = args.leaseOwner ?? `runtime:${args.runId}`;
+	const leaseMs = args.leaseMs ?? config.defaultLeaseMs ?? DEFAULT_LEASE_MS;
+	const claim = await config.store.claimRun({
+		runId: args.runId,
+		leaseOwner,
+		leaseMs,
+		now: args.now
+	});
+	if (claim.kind === "not-found") return {
+		kind: "not-found",
+		runId: args.runId,
+		workflowId: args.workflowId,
+		eventCount: 0,
+		events: []
+	};
+	if (claim.kind === "not-claimable") return {
+		kind: "not-claimable",
+		runId: args.runId,
+		workflowId: args.workflowId,
+		run: claim.run,
+		eventCount: 0,
+		events: []
+	};
+	const runStore = createRunStoreAdapter(config.store);
+	const collected = await collectWorkflowEvents(runWorkflow({
+		workflow: args.workflow,
+		runStore,
+		runId: args.runId,
+		input: args.input,
+		signalDelivery: args.signalDelivery,
+		approval: args.approval,
+		threadId: args.threadId
+	}), {
+		includeEvents: args.includeEvents ?? true,
+		maxEvents: args.maxEvents
+	});
+	await syncTimerFromRunState(config, args.runId, args.workflowId, args.now);
+	await config.store.releaseRunLease({
+		runId: args.runId,
+		leaseOwner
+	});
+	const run = await config.store.loadRun(args.runId);
+	return {
+		kind: classifyRun(run, collected.eventCount),
+		runId: args.runId,
+		workflowId: args.workflowId,
+		run,
+		events: collected.events,
+		eventCount: collected.eventCount,
+		eventsTruncated: collected.eventsTruncated || void 0
+	};
+}
+async function syncTimerFromRunState(config, runId, workflowId, now) {
+	const state = await config.store.loadRunState(runId);
+	const deadline = state?.waitingFor?.deadline;
+	if (state?.waitingFor?.signalName !== "__timer" || deadline === void 0) return;
+	await config.store.scheduleTimer({
+		runId,
+		workflowId,
+		workflowVersion: state.workflowVersion,
+		wakeAt: deadline,
+		signalId: `timer:${runId}:${deadline}`,
+		now
+	});
+}
+async function loadWorkflow(config, workflowId) {
+	const registration = config.workflows[workflowId];
+	if (!registration) throw new Error(`Workflow "${workflowId}" is not registered.`);
+	const workflow = normalizeWorkflowLoaderResult(await registration.load());
+	const previousVersions = [];
+	for (const loadPrevious of Object.values(registration.previousVersions ?? {})) previousVersions.push(normalizeWorkflowLoaderResult(await loadPrevious()));
+	if (registration.version || previousVersions.length > 0) return {
+		...workflow,
+		version: registration.version ?? workflow.version,
+		previousVersions: [...workflow.previousVersions ?? [], ...previousVersions]
+	};
+	return workflow;
+}
+function normalizeWorkflowLoaderResult(result) {
+	if ("__kind" in result) return result;
+	if ("default" in result) return result.default;
+	return result.workflow;
+}
+function resultFromSignalDelivery(runId, result) {
+	return {
+		kind: result.kind,
+		runId,
+		run: "run" in result ? result.run : void 0,
+		workflowId: "run" in result ? result.run.workflowId : void 0,
+		events: [],
+		eventCount: 0
+	};
+}
+function resultFromApprovalDelivery(runId, result) {
+	return {
+		kind: result.kind,
+		runId,
+		run: "run" in result ? result.run : void 0,
+		workflowId: "run" in result ? result.run.workflowId : void 0,
+		events: [],
+		eventCount: 0
+	};
+}
+function classifyRun(run, eventCount) {
+	if (run?.status === "finished") return "completed";
+	if (run?.status === "paused") return "paused";
+	if (run?.status === "errored" || run?.status === "aborted") return "errored";
+	if (run?.status === "running" || run?.status === "queued") return "running";
+	return eventCount > 0 ? "running" : "not-found";
+}
+function normalizeSweepLimit(value, fallback, label) {
+	const limit = value ?? fallback;
+	if (!Number.isInteger(limit) || limit < 0) throw new Error(`Workflow sweep ${label} must be a non-negative integer.`);
+	return limit;
+}
+function isPastSweepDeadline(startedAt, maxDurationMs) {
+	return maxDurationMs !== void 0 && Date.now() - startedAt >= maxDurationMs;
+}
+function summarizeSweep(scheduled, timers) {
+	return {
+		scheduled: countRunKinds(scheduled),
+		timers: countRunKinds(timers),
+		eventCount: sumEventCounts(scheduled) + sumEventCounts(timers),
+		returnedEventCount: sumReturnedEventCounts(scheduled) + sumReturnedEventCounts(timers)
+	};
+}
+function countRunKinds(runs) {
+	const counts = {};
+	for (const run of runs) counts[run.kind] = (counts[run.kind] ?? 0) + 1;
+	return counts;
+}
+function sumEventCounts(runs) {
+	return runs.reduce((sum, run) => sum + run.eventCount, 0);
+}
+function sumReturnedEventCounts(runs) {
+	return runs.reduce((sum, run) => sum + run.events.length, 0);
+}
+async function collectWorkflowEvents(iterable, options) {
+	if (options.maxEvents !== void 0 && (!Number.isInteger(options.maxEvents) || options.maxEvents < 0)) throw new Error("Workflow event collection maxEvents must be a non-negative integer.");
+	const events = [];
+	let eventCount = 0;
+	let eventsTruncated = false;
+	for await (const event of iterable) {
+		eventCount++;
+		if (!options.includeEvents) continue;
+		if (options.maxEvents === void 0 || events.length < options.maxEvents) events.push(event);
+		else eventsTruncated = true;
+	}
+	return {
+		events,
+		eventCount,
+		eventsTruncated
+	};
+}
+
+//#endregion
+export { createRuntimeDriver };
+//# sourceMappingURL=runtime-driver.js.map

package/dist/runtime-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-driver.js","names":[],"sources":["../src/runtime-driver.ts"],"sourcesContent":["import { runWorkflow } from '@tanstack/workflow-core'\nimport { createRunStoreAdapter } from './run-store-adapter'\nimport type {\n  AnyWorkflowDefinition,\n  WorkflowEvent,\n} from '@tanstack/workflow-core'\nimport type {\n  DeliverApprovalResult,\n  DeliverSignalResult,\n  TimerWakeup,\n  WorkflowExecution,\n  WorkflowRegistration,\n  WorkflowRuntimeConfig,\n  WorkflowRuntimeDeliverApprovalArgs,\n  WorkflowRuntimeDeliverSignalArgs,\n  WorkflowRuntimeRunResult,\n  WorkflowRuntimeRunResultKind,\n  WorkflowRuntimeStartRunArgs,\n  WorkflowRuntimeSweepArgs,\n  WorkflowRuntimeSweepResult,\n} from './types'\n\nconst DEFAULT_LEASE_MS = 30_000\nconst DEFAULT_SWEEP_LIMIT = 25\n\nexport function createRuntimeDriver<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(config: WorkflowRuntimeConfig<TWorkflows>) {\n  return {\n    startRun(args: WorkflowRuntimeStartRunArgs) {\n      return startRun(config, args)\n    },\n    deliverSignal<TPayload = unknown>(\n      args: WorkflowRuntimeDeliverSignalArgs<TPayload>,\n    ) {\n      return deliverSignal(config, args)\n    },\n    deliverApproval(args: WorkflowRuntimeDeliverApprovalArgs) {\n      return deliverApproval(config, args)\n    },\n    sweep(args: WorkflowRuntimeSweepArgs = {}) {\n      return sweep(config, args)\n    },\n  }\n}\n\nasync function startRun<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: WorkflowRuntimeStartRunArgs,\n): Promise<WorkflowRuntimeRunResult> {\n  const now = args.now ?? Date.now()\n  const workflow = await loadWorkflow(config, args.workflowId)\n  const workflowVersion = workflow.version\n  await config.store.createRun({\n    runId: args.runId,\n    workflowId: args.workflowId,\n    workflowVersion,\n    input: args.input,\n    now,\n  })\n\n  return driveClaimedRun(config, {\n    workflow,\n    workflowId: args.workflowId,\n    runId: args.runId,\n    input: args.input,\n    now,\n    leaseOwner: args.leaseOwner,\n    leaseMs: args.leaseMs,\n    threadId: args.threadId,\n    includeEvents: args.includeEvents,\n    maxEvents: args.maxEvents,\n  })\n}\n\nasync function deliverSignal<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n  TPayload,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: WorkflowRuntimeDeliverSignalArgs<TPayload>,\n): Promise<WorkflowRuntimeRunResult> {\n  const now = args.now ?? Date.now()\n  const delivery = {\n    signalId: args.signalId,\n    name: args.name,\n    payload: args.payload,\n  }\n  const delivered = await config.store.deliverSignal({\n    runId: args.runId,\n    delivery,\n    now,\n  })\n  if (delivered.kind !== 'delivered') {\n    return resultFromSignalDelivery(args.runId, delivered)\n  }\n\n  const workflow = await loadWorkflow(config, delivered.run.workflowId)\n  return driveClaimedRun(config, {\n    workflow,\n    workflowId: delivered.run.workflowId,\n    runId: args.runId,\n    signalDelivery: delivery,\n    now,\n    leaseOwner: args.leaseOwner,\n    leaseMs: args.leaseMs,\n    threadId: args.threadId,\n    includeEvents: args.includeEvents,\n    maxEvents: args.maxEvents,\n  })\n}\n\nasync function deliverApproval<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: WorkflowRuntimeDeliverApprovalArgs,\n): Promise<WorkflowRuntimeRunResult> {\n  const now = args.now ?? Date.now()\n  const delivered = await config.store.deliverApproval({\n    runId: args.runId,\n    approval: args.approval,\n    now,\n  })\n  if (delivered.kind !== 'delivered') {\n    return resultFromApprovalDelivery(args.runId, delivered)\n  }\n\n  const workflow = await loadWorkflow(config, delivered.run.workflowId)\n  return driveClaimedRun(config, {\n    workflow,\n    workflowId: delivered.run.workflowId,\n    runId: args.runId,\n    approval: args.approval,\n    now,\n    leaseOwner: args.leaseOwner,\n    leaseMs: args.leaseMs,\n    threadId: args.threadId,\n    includeEvents: args.includeEvents,\n    maxEvents: args.maxEvents,\n  })\n}\n\nasync function sweep<TWorkflows extends Record<string, WorkflowRegistration>>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: WorkflowRuntimeSweepArgs,\n): Promise<WorkflowRuntimeSweepResult> {\n  const now = args.now ?? Date.now()\n  const startedAt = Date.now()\n  const maxScheduledRuns = normalizeSweepLimit(\n    args.maxScheduledRuns ?? args.limit,\n    DEFAULT_SWEEP_LIMIT,\n    'maxScheduledRuns',\n  )\n  const maxTimers = normalizeSweepLimit(\n    args.maxTimers ?? args.limit,\n    DEFAULT_SWEEP_LIMIT,\n    'maxTimers',\n  )\n  const leaseOwner = args.leaseOwner ?? `sweep:${now}`\n  const leaseMs = args.leaseMs ?? config.defaultLeaseMs ?? DEFAULT_LEASE_MS\n  const scheduled: Array<WorkflowRuntimeRunResult> = []\n  const timers: Array<WorkflowRuntimeRunResult> = []\n  let deadlineReached = false\n\n  while (scheduled.length < maxScheduledRuns) {\n    if (isPastSweepDeadline(startedAt, args.maxDurationMs)) {\n      deadlineReached = true\n      break\n    }\n\n    const buckets = await config.store.claimDueScheduleBuckets({\n      now,\n      limit: 1,\n      leaseOwner,\n      leaseMs,\n    })\n    const bucket = buckets[0]\n    if (!bucket) break\n\n    const result = await startRun(config, {\n      workflowId: bucket.workflowId,\n      runId: bucket.runId,\n      input: bucket.input,\n      now,\n      leaseOwner,\n      leaseMs,\n      includeEvents: args.includeEvents,\n      maxEvents: args.maxEvents,\n    })\n    if (result.kind !== 'not-claimable' && result.kind !== 'not-found') {\n      await config.store.markScheduleBucketStarted({\n        scheduleId: bucket.scheduleId,\n        bucketId: bucket.bucketId,\n        runId: bucket.runId,\n        now,\n      })\n    }\n    scheduled.push(result)\n  }\n\n  while (timers.length < maxTimers) {\n    if (isPastSweepDeadline(startedAt, args.maxDurationMs)) {\n      deadlineReached = true\n      break\n    }\n\n    const dueTimers = await config.store.claimDueTimers({\n      now,\n      limit: 1,\n      leaseOwner,\n      leaseMs,\n    })\n    const timer = dueTimers[0]\n    if (!timer) break\n\n    timers.push(\n      await deliverTimer(config, {\n        timer,\n        now,\n        leaseOwner,\n        leaseMs,\n        includeEvents: args.includeEvents,\n        maxEvents: args.maxEvents,\n      }),\n    )\n  }\n\n  return {\n    scheduled,\n    timers,\n    summary: summarizeSweep(scheduled, timers),\n    deadlineReached,\n    remainingMayExist:\n      deadlineReached ||\n      scheduled.length >= maxScheduledRuns ||\n      timers.length >= maxTimers,\n  }\n}\n\nasync function deliverTimer<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: {\n    timer: TimerWakeup\n    now: number\n    leaseOwner: string\n    leaseMs: number\n    includeEvents?: boolean\n    maxEvents?: number\n  },\n) {\n  return deliverSignal(config, {\n    runId: args.timer.runId,\n    signalId: args.timer.signalId,\n    name: '__timer',\n    payload: undefined,\n    now: args.now,\n    leaseOwner: args.leaseOwner,\n    leaseMs: args.leaseMs,\n    includeEvents: args.includeEvents,\n    maxEvents: args.maxEvents,\n  })\n}\n\nasync function driveClaimedRun<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  args: {\n    workflow: AnyWorkflowDefinition\n    workflowId: string\n    runId: string\n    input?: unknown\n    signalDelivery?: Parameters<typeof runWorkflow>[0]['signalDelivery']\n    approval?: Parameters<typeof runWorkflow>[0]['approval']\n    now: number\n    leaseOwner?: string\n    leaseMs?: number\n    threadId?: string\n    includeEvents?: boolean\n    maxEvents?: number\n  },\n): Promise<WorkflowRuntimeRunResult> {\n  const leaseOwner = args.leaseOwner ?? `runtime:${args.runId}`\n  const leaseMs = args.leaseMs ?? config.defaultLeaseMs ?? DEFAULT_LEASE_MS\n  const claim = await config.store.claimRun({\n    runId: args.runId,\n    leaseOwner,\n    leaseMs,\n    now: args.now,\n  })\n\n  if (claim.kind === 'not-found') {\n    return {\n      kind: 'not-found',\n      runId: args.runId,\n      workflowId: args.workflowId,\n      eventCount: 0,\n      events: [],\n    }\n  }\n  if (claim.kind === 'not-claimable') {\n    return {\n      kind: 'not-claimable',\n      runId: args.runId,\n      workflowId: args.workflowId,\n      run: claim.run,\n      eventCount: 0,\n      events: [],\n    }\n  }\n\n  const runStore = createRunStoreAdapter(config.store)\n  const collected = await collectWorkflowEvents(\n    runWorkflow({\n      workflow: args.workflow,\n      runStore,\n      runId: args.runId,\n      input: args.input,\n      signalDelivery: args.signalDelivery,\n      approval: args.approval,\n      threadId: args.threadId,\n    }),\n    {\n      includeEvents: args.includeEvents ?? true,\n      maxEvents: args.maxEvents,\n    },\n  )\n\n  await syncTimerFromRunState(config, args.runId, args.workflowId, args.now)\n  await config.store.releaseRunLease({ runId: args.runId, leaseOwner })\n\n  const run = await config.store.loadRun(args.runId)\n  return {\n    kind: classifyRun(run, collected.eventCount),\n    runId: args.runId,\n    workflowId: args.workflowId,\n    run,\n    events: collected.events,\n    eventCount: collected.eventCount,\n    eventsTruncated: collected.eventsTruncated || undefined,\n  }\n}\n\nasync function syncTimerFromRunState<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  runId: string,\n  workflowId: string,\n  now: number,\n) {\n  const state = await config.store.loadRunState(runId)\n  const deadline = state?.waitingFor?.deadline\n  if (state?.waitingFor?.signalName !== '__timer' || deadline === undefined) {\n    return\n  }\n\n  await config.store.scheduleTimer({\n    runId,\n    workflowId,\n    workflowVersion: state.workflowVersion,\n    wakeAt: deadline,\n    signalId: `timer:${runId}:${deadline}`,\n    now,\n  })\n}\n\nasync function loadWorkflow<\n  TWorkflows extends Record<string, WorkflowRegistration>,\n>(\n  config: WorkflowRuntimeConfig<TWorkflows>,\n  workflowId: string,\n): Promise<AnyWorkflowDefinition> {\n  const registration = config.workflows[workflowId]\n  if (!registration) {\n    throw new Error(`Workflow \"${workflowId}\" is not registered.`)\n  }\n\n  const workflow = normalizeWorkflowLoaderResult(await registration.load())\n  const previousVersions = []\n  for (const loadPrevious of Object.values(\n    registration.previousVersions ?? {},\n  )) {\n    previousVersions.push(normalizeWorkflowLoaderResult(await loadPrevious()))\n  }\n\n  if (registration.version || previousVersions.length > 0) {\n    return {\n      ...workflow,\n      version: registration.version ?? workflow.version,\n      previousVersions: [\n        ...(workflow.previousVersions ?? []),\n        ...previousVersions,\n      ],\n    }\n  }\n\n  return workflow\n}\n\nfunction normalizeWorkflowLoaderResult(\n  result: Awaited<ReturnType<WorkflowRegistration['load']>>,\n): AnyWorkflowDefinition {\n  if ('__kind' in result) return result\n  if ('default' in result) return result.default\n  return result.workflow\n}\n\nfunction resultFromSignalDelivery(\n  runId: string,\n  result: Exclude<DeliverSignalResult, { kind: 'delivered' }>,\n): WorkflowRuntimeRunResult {\n  return {\n    kind: result.kind,\n    runId,\n    run: 'run' in result ? result.run : undefined,\n    workflowId: 'run' in result ? result.run.workflowId : undefined,\n    events: [],\n    eventCount: 0,\n  }\n}\n\nfunction resultFromApprovalDelivery(\n  runId: string,\n  result: Exclude<DeliverApprovalResult, { kind: 'delivered' }>,\n): WorkflowRuntimeRunResult {\n  return {\n    kind: result.kind,\n    runId,\n    run: 'run' in result ? result.run : undefined,\n    workflowId: 'run' in result ? result.run.workflowId : undefined,\n    events: [],\n    eventCount: 0,\n  }\n}\n\nfunction classifyRun(\n  run: WorkflowExecution | undefined,\n  eventCount: number,\n): WorkflowRuntimeRunResult['kind'] {\n  if (run?.status === 'finished') return 'completed'\n  if (run?.status === 'paused') return 'paused'\n  if (run?.status === 'errored' || run?.status === 'aborted') return 'errored'\n  if (run?.status === 'running' || run?.status === 'queued') return 'running'\n  return eventCount > 0 ? 'running' : 'not-found'\n}\n\nfunction normalizeSweepLimit(\n  value: number | undefined,\n  fallback: number,\n  label: string,\n) {\n  const limit = value ?? fallback\n  if (!Number.isInteger(limit) || limit < 0) {\n    throw new Error(`Workflow sweep ${label} must be a non-negative integer.`)\n  }\n  return limit\n}\n\nfunction isPastSweepDeadline(\n  startedAt: number,\n  maxDurationMs: number | undefined,\n) {\n  return maxDurationMs !== undefined && Date.now() - startedAt >= maxDurationMs\n}\n\nfunction summarizeSweep(\n  scheduled: ReadonlyArray<WorkflowRuntimeRunResult>,\n  timers: ReadonlyArray<WorkflowRuntimeRunResult>,\n): WorkflowRuntimeSweepResult['summary'] {\n  return {\n    scheduled: countRunKinds(scheduled),\n    timers: countRunKinds(timers),\n    eventCount: sumEventCounts(scheduled) + sumEventCounts(timers),\n    returnedEventCount:\n      sumReturnedEventCounts(scheduled) + sumReturnedEventCounts(timers),\n  }\n}\n\nfunction countRunKinds(runs: ReadonlyArray<WorkflowRuntimeRunResult>) {\n  const counts: Partial<Record<WorkflowRuntimeRunResultKind, number>> = {}\n  for (const run of runs) {\n    counts[run.kind] = (counts[run.kind] ?? 0) + 1\n  }\n  return counts\n}\n\nfunction sumEventCounts(runs: ReadonlyArray<WorkflowRuntimeRunResult>) {\n  return runs.reduce((sum, run) => sum + run.eventCount, 0)\n}\n\nfunction sumReturnedEventCounts(runs: ReadonlyArray<WorkflowRuntimeRunResult>) {\n  return runs.reduce((sum, run) => sum + run.events.length, 0)\n}\n\nasync function collectWorkflowEvents(\n  iterable: AsyncIterable<WorkflowEvent>,\n  options: {\n    includeEvents: boolean\n    maxEvents?: number\n  },\n) {\n  if (\n    options.maxEvents !== undefined &&\n    (!Number.isInteger(options.maxEvents) || options.maxEvents < 0)\n  ) {\n    throw new Error(\n      'Workflow event collection maxEvents must be a non-negative integer.',\n    )\n  }\n\n  const events: Array<WorkflowEvent> = []\n  let eventCount = 0\n  let eventsTruncated = false\n\n  for await (const event of iterable) {\n    eventCount++\n    if (!options.includeEvents) continue\n    if (options.maxEvents === undefined || events.length < options.maxEvents) {\n      events.push(event)\n    } else {\n      eventsTruncated = true\n    }\n  }\n\n  return {\n    events,\n    eventCount,\n    eventsTruncated,\n  }\n}\n"],"mappings":"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"}

package/dist/schedule-materializer.cjs

@@ -0,0 +1,156 @@
+
+//#region src/schedule-materializer.ts
+const DEFAULT_CRON_LOOKBACK_MS = 768 * 60 * 60 * 1e3;
+async function materializeWorkflowSchedules(runtime, options = {}) {
+	const now = options.now ?? Date.now();
+	const cronLookbackMs = options.cronLookbackMs ?? DEFAULT_CRON_LOOKBACK_MS;
+	const materialized = [];
+	if (!Number.isFinite(cronLookbackMs) || cronLookbackMs < 0) throw new Error("Workflow cron lookback must be a non-negative number.");
+	for (const [workflowId, registration] of Object.entries(runtime.workflows)) {
+		const schedules = registration.schedules ?? [];
+		for (let index = 0; index < schedules.length; index++) {
+			const definition = schedules[index];
+			const scheduleId = getScheduleId(workflowId, definition, index);
+			if (definition.enabled === false) {
+				await runtime.store.upsertSchedule({
+					scheduleId,
+					workflowId,
+					workflowVersion: registration.version,
+					schedule: definition.schedule,
+					overlapPolicy: definition.overlapPolicy ?? "skip",
+					input: void 0,
+					nextFireAt: void 0,
+					enabled: false,
+					now
+				});
+				materialized.push({
+					kind: "disabled",
+					workflowId,
+					scheduleId,
+					schedule: definition.schedule
+				});
+				continue;
+			}
+			const fireAt = getDueFireAt(definition.schedule, now, cronLookbackMs);
+			if (fireAt === void 0) {
+				materialized.push({
+					kind: "not-due",
+					workflowId,
+					scheduleId,
+					schedule: definition.schedule
+				});
+				continue;
+			}
+			await runtime.store.upsertSchedule({
+				scheduleId,
+				workflowId,
+				workflowVersion: registration.version,
+				schedule: definition.schedule,
+				overlapPolicy: definition.overlapPolicy ?? "skip",
+				input: await resolveScheduleInput(definition.input),
+				nextFireAt: fireAt,
+				enabled: true,
+				now
+			});
+			materialized.push({
+				kind: "materialized",
+				workflowId,
+				scheduleId,
+				fireAt,
+				schedule: definition.schedule
+			});
+		}
+	}
+	return materialized;
+}
+function getScheduleId(workflowId, definition, index) {
+	return definition.id ?? `${workflowId}:${index}`;
+}
+async function resolveScheduleInput(input) {
+	return typeof input === "function" ? await input() : input;
+}
+function getDueFireAt(schedule, now, cronLookbackMs) {
+	if (schedule.kind === "interval") {
+		if (!Number.isFinite(schedule.everyMs) || schedule.everyMs <= 0) throw new Error("Interval workflow schedules must use a positive everyMs.");
+		return Math.floor(now / schedule.everyMs) * schedule.everyMs;
+	}
+	return getPreviousCronFireAt(schedule, now, cronLookbackMs);
+}
+function getPreviousCronFireAt(schedule, now, lookbackMs) {
+	if (schedule.timezone && schedule.timezone !== "UTC") throw new Error(`Workflow cron schedules are materialized in UTC. Received timezone "${schedule.timezone}".`);
+	const cron = parseCronExpression(schedule.expression);
+	const start = floorToMinute(now);
+	const end = start - lookbackMs;
+	for (let timestamp = start; timestamp >= end; timestamp -= 6e4) if (matchesCron(cron, new Date(timestamp))) return timestamp;
+}
+function parseCronExpression(expression) {
+	const fields = expression.trim().split(/\s+/);
+	if (fields.length !== 5) throw new Error(`Workflow cron schedules must use five fields. Received "${expression}".`);
+	return {
+		minute: parseCronField(fields[0], 0, 59),
+		hour: parseCronField(fields[1], 0, 23),
+		dayOfMonth: parseCronField(fields[2], 1, 31),
+		month: parseCronField(fields[3], 1, 12),
+		dayOfWeek: parseCronField(fields[4], 0, 7, normalizeDayOfWeek)
+	};
+}
+function parseCronField(field, min, max, normalize = (value) => value) {
+	const values = /* @__PURE__ */ new Set();
+	const parts = field.split(",");
+	for (const part of parts) {
+		const [rangePart, stepPart] = part.split("/");
+		const step = stepPart === void 0 ? 1 : Number(stepPart);
+		if (!Number.isInteger(step) || step <= 0) throw new Error(`Invalid cron step "${part}".`);
+		const range = parseCronRange(rangePart, min, max);
+		for (let value = range.start; value <= range.end; value += step) values.add(normalize(value));
+	}
+	return {
+		wildcard: field === "*",
+		values
+	};
+}
+function parseCronRange(range, min, max) {
+	if (range === "*") return {
+		start: min,
+		end: max
+	};
+	const bounds = range.split("-");
+	if (bounds.length === 1) {
+		const value = parseCronNumber(bounds[0], min, max);
+		return {
+			start: value,
+			end: value
+		};
+	}
+	if (bounds.length === 2) {
+		const start = parseCronNumber(bounds[0], min, max);
+		const end = parseCronNumber(bounds[1], min, max);
+		if (end < start) throw new Error(`Invalid cron range "${range}".`);
+		return {
+			start,
+			end
+		};
+	}
+	throw new Error(`Invalid cron range "${range}".`);
+}
+function parseCronNumber(value, min, max) {
+	const parsed = Number(value);
+	if (!Number.isInteger(parsed) || parsed < min || parsed > max) throw new Error(`Invalid cron value "${value}".`);
+	return parsed;
+}
+function normalizeDayOfWeek(value) {
+	return value === 7 ? 0 : value;
+}
+function matchesCron(cron, date) {
+	const dayOfMonthMatches = cron.dayOfMonth.values.has(date.getUTCDate());
+	const dayOfWeekMatches = cron.dayOfWeek.values.has(date.getUTCDay());
+	const dayMatches = !cron.dayOfMonth.wildcard && !cron.dayOfWeek.wildcard ? dayOfMonthMatches || dayOfWeekMatches : dayOfMonthMatches && dayOfWeekMatches;
+	return cron.minute.values.has(date.getUTCMinutes()) && cron.hour.values.has(date.getUTCHours()) && dayMatches && cron.month.values.has(date.getUTCMonth() + 1);
+}
+function floorToMinute(timestamp) {
+	return Math.floor(timestamp / 6e4) * 6e4;
+}
+
+//#endregion
+exports.materializeWorkflowSchedules = materializeWorkflowSchedules;
+//# sourceMappingURL=schedule-materializer.cjs.map

package/dist/schedule-materializer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-materializer.cjs","names":[],"sources":["../src/schedule-materializer.ts"],"sourcesContent":["import type {\n  ScheduleId,\n  WorkflowRegistrationMap,\n  WorkflowRuntimeDefinition,\n  WorkflowScheduleDefinition,\n  WorkflowScheduleSpec,\n} from './types'\n\nconst DEFAULT_CRON_LOOKBACK_MS = 32 * 24 * 60 * 60 * 1000\n\nexport interface MaterializeWorkflowSchedulesOptions {\n  now?: number\n  cronLookbackMs?: number\n}\n\nexport type MaterializedWorkflowSchedule =\n  | {\n      kind: 'materialized'\n      workflowId: string\n      scheduleId: ScheduleId\n      fireAt: number\n      schedule: WorkflowScheduleSpec\n    }\n  | {\n      kind: 'disabled'\n      workflowId: string\n      scheduleId: ScheduleId\n      schedule: WorkflowScheduleSpec\n    }\n  | {\n      kind: 'not-due'\n      workflowId: string\n      scheduleId: ScheduleId\n      schedule: WorkflowScheduleSpec\n    }\n\nexport async function materializeWorkflowSchedules<\n  TWorkflows extends WorkflowRegistrationMap,\n>(\n  runtime: WorkflowRuntimeDefinition<TWorkflows>,\n  options: MaterializeWorkflowSchedulesOptions = {},\n): Promise<Array<MaterializedWorkflowSchedule>> {\n  const now = options.now ?? Date.now()\n  const cronLookbackMs = options.cronLookbackMs ?? DEFAULT_CRON_LOOKBACK_MS\n  const materialized: Array<MaterializedWorkflowSchedule> = []\n\n  if (!Number.isFinite(cronLookbackMs) || cronLookbackMs < 0) {\n    throw new Error('Workflow cron lookback must be a non-negative number.')\n  }\n\n  for (const [workflowId, registration] of Object.entries(runtime.workflows)) {\n    const schedules = registration.schedules ?? []\n    for (let index = 0; index < schedules.length; index++) {\n      const definition = schedules[index]!\n      const scheduleId = getScheduleId(workflowId, definition, index)\n\n      if (definition.enabled === false) {\n        await runtime.store.upsertSchedule({\n          scheduleId,\n          workflowId,\n          workflowVersion: registration.version,\n          schedule: definition.schedule,\n          overlapPolicy: definition.overlapPolicy ?? 'skip',\n          input: undefined,\n          nextFireAt: undefined,\n          enabled: false,\n          now,\n        })\n        materialized.push({\n          kind: 'disabled',\n          workflowId,\n          scheduleId,\n          schedule: definition.schedule,\n        })\n        continue\n      }\n\n      const fireAt = getDueFireAt(definition.schedule, now, cronLookbackMs)\n      if (fireAt === undefined) {\n        materialized.push({\n          kind: 'not-due',\n          workflowId,\n          scheduleId,\n          schedule: definition.schedule,\n        })\n        continue\n      }\n\n      await runtime.store.upsertSchedule({\n        scheduleId,\n        workflowId,\n        workflowVersion: registration.version,\n        schedule: definition.schedule,\n        overlapPolicy: definition.overlapPolicy ?? 'skip',\n        input: await resolveScheduleInput(definition.input),\n        nextFireAt: fireAt,\n        enabled: true,\n        now,\n      })\n      materialized.push({\n        kind: 'materialized',\n        workflowId,\n        scheduleId,\n        fireAt,\n        schedule: definition.schedule,\n      })\n    }\n  }\n\n  return materialized\n}\n\nfunction getScheduleId(\n  workflowId: string,\n  definition: WorkflowScheduleDefinition,\n  index: number,\n): ScheduleId {\n  return definition.id ?? `${workflowId}:${index}`\n}\n\nasync function resolveScheduleInput(\n  input: WorkflowScheduleDefinition['input'],\n) {\n  return typeof input === 'function' ? await input() : input\n}\n\nfunction getDueFireAt(\n  schedule: WorkflowScheduleSpec,\n  now: number,\n  cronLookbackMs: number,\n) {\n  if (schedule.kind === 'interval') {\n    if (!Number.isFinite(schedule.everyMs) || schedule.everyMs <= 0) {\n      throw new Error(\n        'Interval workflow schedules must use a positive everyMs.',\n      )\n    }\n    return Math.floor(now / schedule.everyMs) * schedule.everyMs\n  }\n\n  return getPreviousCronFireAt(schedule, now, cronLookbackMs)\n}\n\nfunction getPreviousCronFireAt(\n  schedule: Extract<WorkflowScheduleSpec, { kind: 'cron' }>,\n  now: number,\n  lookbackMs: number,\n) {\n  if (schedule.timezone && schedule.timezone !== 'UTC') {\n    throw new Error(\n      `Workflow cron schedules are materialized in UTC. Received timezone \"${schedule.timezone}\".`,\n    )\n  }\n\n  const cron = parseCronExpression(schedule.expression)\n  const start = floorToMinute(now)\n  const end = start - lookbackMs\n\n  for (let timestamp = start; timestamp >= end; timestamp -= 60_000) {\n    if (matchesCron(cron, new Date(timestamp))) return timestamp\n  }\n\n  return undefined\n}\n\ninterface ParsedCronExpression {\n  minute: ParsedCronField\n  hour: ParsedCronField\n  dayOfMonth: ParsedCronField\n  month: ParsedCronField\n  dayOfWeek: ParsedCronField\n}\n\ninterface ParsedCronField {\n  wildcard: boolean\n  values: ReadonlySet<number>\n}\n\nfunction parseCronExpression(expression: string): ParsedCronExpression {\n  const fields = expression.trim().split(/\\s+/)\n  if (fields.length !== 5) {\n    throw new Error(\n      `Workflow cron schedules must use five fields. Received \"${expression}\".`,\n    )\n  }\n\n  return {\n    minute: parseCronField(fields[0]!, 0, 59),\n    hour: parseCronField(fields[1]!, 0, 23),\n    dayOfMonth: parseCronField(fields[2]!, 1, 31),\n    month: parseCronField(fields[3]!, 1, 12),\n    dayOfWeek: parseCronField(fields[4]!, 0, 7, normalizeDayOfWeek),\n  }\n}\n\nfunction parseCronField(\n  field: string,\n  min: number,\n  max: number,\n  normalize: (value: number) => number = (value) => value,\n): ParsedCronField {\n  const values = new Set<number>()\n  const parts = field.split(',')\n\n  for (const part of parts) {\n    const [rangePart, stepPart] = part.split('/')\n    const step = stepPart === undefined ? 1 : Number(stepPart)\n    if (!Number.isInteger(step) || step <= 0) {\n      throw new Error(`Invalid cron step \"${part}\".`)\n    }\n\n    const range = parseCronRange(rangePart!, min, max)\n    for (let value = range.start; value <= range.end; value += step) {\n      values.add(normalize(value))\n    }\n  }\n\n  return {\n    wildcard: field === '*',\n    values,\n  }\n}\n\nfunction parseCronRange(range: string, min: number, max: number) {\n  if (range === '*') return { start: min, end: max }\n\n  const bounds = range.split('-')\n  if (bounds.length === 1) {\n    const value = parseCronNumber(bounds[0]!, min, max)\n    return { start: value, end: value }\n  }\n  if (bounds.length === 2) {\n    const start = parseCronNumber(bounds[0]!, min, max)\n    const end = parseCronNumber(bounds[1]!, min, max)\n    if (end < start) throw new Error(`Invalid cron range \"${range}\".`)\n    return { start, end }\n  }\n\n  throw new Error(`Invalid cron range \"${range}\".`)\n}\n\nfunction parseCronNumber(value: string, min: number, max: number) {\n  const parsed = Number(value)\n  if (!Number.isInteger(parsed) || parsed < min || parsed > max) {\n    throw new Error(`Invalid cron value \"${value}\".`)\n  }\n  return parsed\n}\n\nfunction normalizeDayOfWeek(value: number) {\n  return value === 7 ? 0 : value\n}\n\nfunction matchesCron(cron: ParsedCronExpression, date: Date) {\n  const dayOfMonthMatches = cron.dayOfMonth.values.has(date.getUTCDate())\n  const dayOfWeekMatches = cron.dayOfWeek.values.has(date.getUTCDay())\n  const dayMatches =\n    !cron.dayOfMonth.wildcard && !cron.dayOfWeek.wildcard\n      ? dayOfMonthMatches || dayOfWeekMatches\n      : dayOfMonthMatches && dayOfWeekMatches\n\n  return (\n    cron.minute.values.has(date.getUTCMinutes()) &&\n    cron.hour.values.has(date.getUTCHours()) &&\n    dayMatches &&\n    cron.month.values.has(date.getUTCMonth() + 1)\n  )\n}\n\nfunction floorToMinute(timestamp: number) {\n  return Math.floor(timestamp / 60_000) * 60_000\n}\n"],"mappings":";;AAQA,MAAM,2BAA2B,MAAU,KAAK,KAAK;AA4BrD,eAAsB,6BAGpB,SACA,UAA+C,EAAE,EACH;CAC9C,MAAM,MAAM,QAAQ,OAAO,KAAK,KAAK;CACrC,MAAM,iBAAiB,QAAQ,kBAAkB;CACjD,MAAM,eAAoD,EAAE;AAE5D,KAAI,CAAC,OAAO,SAAS,eAAe,IAAI,iBAAiB,EACvD,OAAM,IAAI,MAAM,wDAAwD;AAG1E,MAAK,MAAM,CAAC,YAAY,iBAAiB,OAAO,QAAQ,QAAQ,UAAU,EAAE;EAC1E,MAAM,YAAY,aAAa,aAAa,EAAE;AAC9C,OAAK,IAAI,QAAQ,GAAG,QAAQ,UAAU,QAAQ,SAAS;GACrD,MAAM,aAAa,UAAU;GAC7B,MAAM,aAAa,cAAc,YAAY,YAAY,MAAM;AAE/D,OAAI,WAAW,YAAY,OAAO;AAChC,UAAM,QAAQ,MAAM,eAAe;KACjC;KACA;KACA,iBAAiB,aAAa;KAC9B,UAAU,WAAW;KACrB,eAAe,WAAW,iBAAiB;KAC3C,OAAO;KACP,YAAY;KACZ,SAAS;KACT;KACD,CAAC;AACF,iBAAa,KAAK;KAChB,MAAM;KACN;KACA;KACA,UAAU,WAAW;KACtB,CAAC;AACF;;GAGF,MAAM,SAAS,aAAa,WAAW,UAAU,KAAK,eAAe;AACrE,OAAI,WAAW,QAAW;AACxB,iBAAa,KAAK;KAChB,MAAM;KACN;KACA;KACA,UAAU,WAAW;KACtB,CAAC;AACF;;AAGF,SAAM,QAAQ,MAAM,eAAe;IACjC;IACA;IACA,iBAAiB,aAAa;IAC9B,UAAU,WAAW;IACrB,eAAe,WAAW,iBAAiB;IAC3C,OAAO,MAAM,qBAAqB,WAAW,MAAM;IACnD,YAAY;IACZ,SAAS;IACT;IACD,CAAC;AACF,gBAAa,KAAK;IAChB,MAAM;IACN;IACA;IACA;IACA,UAAU,WAAW;IACtB,CAAC;;;AAIN,QAAO;;AAGT,SAAS,cACP,YACA,YACA,OACY;AACZ,QAAO,WAAW,MAAM,GAAG,WAAW,GAAG;;AAG3C,eAAe,qBACb,OACA;AACA,QAAO,OAAO,UAAU,aAAa,MAAM,OAAO,GAAG;;AAGvD,SAAS,aACP,UACA,KACA,gBACA;AACA,KAAI,SAAS,SAAS,YAAY;AAChC,MAAI,CAAC,OAAO,SAAS,SAAS,QAAQ,IAAI,SAAS,WAAW,EAC5D,OAAM,IAAI,MACR,2DACD;AAEH,SAAO,KAAK,MAAM,MAAM,SAAS,QAAQ,GAAG,SAAS;;AAGvD,QAAO,sBAAsB,UAAU,KAAK,eAAe;;AAG7D,SAAS,sBACP,UACA,KACA,YACA;AACA,KAAI,SAAS,YAAY,SAAS,aAAa,MAC7C,OAAM,IAAI,MACR,uEAAuE,SAAS,SAAS,IAC1F;CAGH,MAAM,OAAO,oBAAoB,SAAS,WAAW;CACrD,MAAM,QAAQ,cAAc,IAAI;CAChC,MAAM,MAAM,QAAQ;AAEpB,MAAK,IAAI,YAAY,OAAO,aAAa,KAAK,aAAa,IACzD,KAAI,YAAY,MAAM,IAAI,KAAK,UAAU,CAAC,CAAE,QAAO;;AAmBvD,SAAS,oBAAoB,YAA0C;CACrE,MAAM,SAAS,WAAW,MAAM,CAAC,MAAM,MAAM;AAC7C,KAAI,OAAO,WAAW,EACpB,OAAM,IAAI,MACR,2DAA2D,WAAW,IACvE;AAGH,QAAO;EACL,QAAQ,eAAe,OAAO,IAAK,GAAG,GAAG;EACzC,MAAM,eAAe,OAAO,IAAK,GAAG,GAAG;EACvC,YAAY,eAAe,OAAO,IAAK,GAAG,GAAG;EAC7C,OAAO,eAAe,OAAO,IAAK,GAAG,GAAG;EACxC,WAAW,eAAe,OAAO,IAAK,GAAG,GAAG,mBAAmB;EAChE;;AAGH,SAAS,eACP,OACA,KACA,KACA,aAAwC,UAAU,OACjC;CACjB,MAAM,yBAAS,IAAI,KAAa;CAChC,MAAM,QAAQ,MAAM,MAAM,IAAI;AAE9B,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,CAAC,WAAW,YAAY,KAAK,MAAM,IAAI;EAC7C,MAAM,OAAO,aAAa,SAAY,IAAI,OAAO,SAAS;AAC1D,MAAI,CAAC,OAAO,UAAU,KAAK,IAAI,QAAQ,EACrC,OAAM,IAAI,MAAM,sBAAsB,KAAK,IAAI;EAGjD,MAAM,QAAQ,eAAe,WAAY,KAAK,IAAI;AAClD,OAAK,IAAI,QAAQ,MAAM,OAAO,SAAS,MAAM,KAAK,SAAS,KACzD,QAAO,IAAI,UAAU,MAAM,CAAC;;AAIhC,QAAO;EACL,UAAU,UAAU;EACpB;EACD;;AAGH,SAAS,eAAe,OAAe,KAAa,KAAa;AAC/D,KAAI,UAAU,IAAK,QAAO;EAAE,OAAO;EAAK,KAAK;EAAK;CAElD,MAAM,SAAS,MAAM,MAAM,IAAI;AAC/B,KAAI,OAAO,WAAW,GAAG;EACvB,MAAM,QAAQ,gBAAgB,OAAO,IAAK,KAAK,IAAI;AACnD,SAAO;GAAE,OAAO;GAAO,KAAK;GAAO;;AAErC,KAAI,OAAO,WAAW,GAAG;EACvB,MAAM,QAAQ,gBAAgB,OAAO,IAAK,KAAK,IAAI;EACnD,MAAM,MAAM,gBAAgB,OAAO,IAAK,KAAK,IAAI;AACjD,MAAI,MAAM,MAAO,OAAM,IAAI,MAAM,uBAAuB,MAAM,IAAI;AAClE,SAAO;GAAE;GAAO;GAAK;;AAGvB,OAAM,IAAI,MAAM,uBAAuB,MAAM,IAAI;;AAGnD,SAAS,gBAAgB,OAAe,KAAa,KAAa;CAChE,MAAM,SAAS,OAAO,MAAM;AAC5B,KAAI,CAAC,OAAO,UAAU,OAAO,IAAI,SAAS,OAAO,SAAS,IACxD,OAAM,IAAI,MAAM,uBAAuB,MAAM,IAAI;AAEnD,QAAO;;AAGT,SAAS,mBAAmB,OAAe;AACzC,QAAO,UAAU,IAAI,IAAI;;AAG3B,SAAS,YAAY,MAA4B,MAAY;CAC3D,MAAM,oBAAoB,KAAK,WAAW,OAAO,IAAI,KAAK,YAAY,CAAC;CACvE,MAAM,mBAAmB,KAAK,UAAU,OAAO,IAAI,KAAK,WAAW,CAAC;CACpE,MAAM,aACJ,CAAC,KAAK,WAAW,YAAY,CAAC,KAAK,UAAU,WACzC,qBAAqB,mBACrB,qBAAqB;AAE3B,QACE,KAAK,OAAO,OAAO,IAAI,KAAK,eAAe,CAAC,IAC5C,KAAK,KAAK,OAAO,IAAI,KAAK,aAAa,CAAC,IACxC,cACA,KAAK,MAAM,OAAO,IAAI,KAAK,aAAa,GAAG,EAAE;;AAIjD,SAAS,cAAc,WAAmB;AACxC,QAAO,KAAK,MAAM,YAAY,IAAO,GAAG"}

package/dist/schedule-materializer.d.cts

@@ -0,0 +1,28 @@
+import { ScheduleId, WorkflowRegistrationMap, WorkflowRuntimeDefinition, WorkflowScheduleSpec } from "./types.cjs";
+
+//#region src/schedule-materializer.d.ts
+interface MaterializeWorkflowSchedulesOptions {
+  now?: number;
+  cronLookbackMs?: number;
+}
+type MaterializedWorkflowSchedule = {
+  kind: 'materialized';
+  workflowId: string;
+  scheduleId: ScheduleId;
+  fireAt: number;
+  schedule: WorkflowScheduleSpec;
+} | {
+  kind: 'disabled';
+  workflowId: string;
+  scheduleId: ScheduleId;
+  schedule: WorkflowScheduleSpec;
+} | {
+  kind: 'not-due';
+  workflowId: string;
+  scheduleId: ScheduleId;
+  schedule: WorkflowScheduleSpec;
+};
+declare function materializeWorkflowSchedules<TWorkflows extends WorkflowRegistrationMap>(runtime: WorkflowRuntimeDefinition<TWorkflows>, options?: MaterializeWorkflowSchedulesOptions): Promise<Array<MaterializedWorkflowSchedule>>;
+//#endregion
+export { MaterializeWorkflowSchedulesOptions, MaterializedWorkflowSchedule, materializeWorkflowSchedules };
+//# sourceMappingURL=schedule-materializer.d.cts.map

package/dist/schedule-materializer.d.ts

@@ -0,0 +1,28 @@
+import { ScheduleId, WorkflowRegistrationMap, WorkflowRuntimeDefinition, WorkflowScheduleSpec } from "./types.js";
+
+//#region src/schedule-materializer.d.ts
+interface MaterializeWorkflowSchedulesOptions {
+  now?: number;
+  cronLookbackMs?: number;
+}
+type MaterializedWorkflowSchedule = {
+  kind: 'materialized';
+  workflowId: string;
+  scheduleId: ScheduleId;
+  fireAt: number;
+  schedule: WorkflowScheduleSpec;
+} | {
+  kind: 'disabled';
+  workflowId: string;
+  scheduleId: ScheduleId;
+  schedule: WorkflowScheduleSpec;
+} | {
+  kind: 'not-due';
+  workflowId: string;
+  scheduleId: ScheduleId;
+  schedule: WorkflowScheduleSpec;
+};
+declare function materializeWorkflowSchedules<TWorkflows extends WorkflowRegistrationMap>(runtime: WorkflowRuntimeDefinition<TWorkflows>, options?: MaterializeWorkflowSchedulesOptions): Promise<Array<MaterializedWorkflowSchedule>>;
+//#endregion
+export { MaterializeWorkflowSchedulesOptions, MaterializedWorkflowSchedule, materializeWorkflowSchedules };
+//# sourceMappingURL=schedule-materializer.d.ts.map