@keystrokehq/keystroke 0.1.57 → 0.1.58

package/dist/trigger.cjs

@@ -8518,23 +8518,46 @@ function isMinuteLevelCron(schedule) {
 function resolveCronSchedule(attachmentId, schedule, options) {
 	return options.attachmentScheduleOverrides?.[attachmentId] ?? options.cronScheduleOverride ?? schedule;
 }
+/** Default timezone when none is authored — preserves historical UTC evaluation. */
+const DEFAULT_TRIGGER_TIMEZONE = "UTC";
+/**
+* Validates and brands an IANA timezone (e.g. `America/New_York`). Uses
+* `Intl.DateTimeFormat` so we don't need a timezone database dependency.
+*/
+const timezoneSchema = zod.z.string().trim().min(1, "timezone must be a non-empty IANA timezone").refine(isValidIanaTimezone, "must be a valid IANA timezone").brand();
+/** Parse/validate an IANA timezone (throws on failure). */
+function parseTimezone(value) {
+	return timezoneSchema.parse(value);
+}
+function isValidIanaTimezone(value) {
+	try {
+		new Intl.DateTimeFormat("en-US", { timeZone: value });
+		return true;
+	} catch {
+		return false;
+	}
+}
 /** Parse a schedule into a `cron-parser` expression (throws on invalid input). */
-function parseTriggerSchedule(schedule) {
-	return parseCronExpression(schedule);
+function parseTriggerSchedule(schedule, timezone = "UTC") {
+	return parseCronExpression(schedule, void 0, timezone);
 }
-/** The next time the schedule fires at or after `from`. */
-function nextTriggerRunAt(schedule, from = /* @__PURE__ */ new Date()) {
-	return parseCronExpression(schedule, from).next().toDate();
+/**
+* The next time the schedule fires at or after `from`.
+*
+* Cron fields are wall-clock times in `timezone` (default UTC). Absolute
+* instants are computed here — do not convert the cron string to UTC at write time.
+*/
+function nextTriggerRunAt(schedule, from = /* @__PURE__ */ new Date(), timezone = "UTC") {
+	return parseCronExpression(schedule, from, timezone).next().toDate();
 }
-const UTC = "UTC";
 /**
 * Single touchpoint for the `cron-parser` library — every parse, validation,
 * and next-run calculation in this package goes through here.
 */
-function parseCronExpression(schedule, currentDate) {
+function parseCronExpression(schedule, currentDate, timezone = "UTC") {
 	return import_dist.CronExpressionParser.parse(schedule, {
 		currentDate: currentDate ?? /* @__PURE__ */ new Date(),
-		tz: UTC
+		tz: timezone
 	});
 }
 function isParseableCron(value) {
@@ -8595,6 +8618,7 @@ const cronSourceSchema = zod.z.object({
 	kind: zod.z.literal("cron"),
 	...baseSourceShape,
 	schedule: cronScheduleSchema,
+	timezone: timezoneSchema.optional(),
 	payload: cronPayloadSchema.optional()
 });
 const pollSourceSchema = zod.z.object({
@@ -8602,6 +8626,7 @@ const pollSourceSchema = zod.z.object({
 	...baseSourceShape,
 	id: zod.z.string().optional(),
 	schedule: pollScheduleSchema,
+	timezone: timezoneSchema.optional(),
 	run: zod.z.function(),
 	stateSchema: zodSchema.optional(),
 	filters: zod.z.array(zod.z.function()),
@@ -8935,6 +8960,8 @@ function defineWebhookSource(options) {
 *   `"0 9 * * *"`) for compile-time shape checking, or wrap with
 *   `parseCronSchedule(...)` for 6-field, named (`MON`), or `@daily`-style
 *   schedules. Validated at runtime; throws if the expression is invalid.
+* @param options.timezone - Optional IANA timezone (e.g. `America/New_York`).
+*   Cron fields are wall-clock times in this zone. When omitted, UTC.
 * @param options.payload - Optional static JSON payload passed to attachments on
 *   each tick (like a webhook body). When omitted, attachments receive `{}`.
 *   Without a `transform`, the payload must be assignable to the workflow input.
@@ -8944,12 +8971,14 @@ function defineWebhookSource(options) {
 * defineCronSource({
 *   slug: "morning-report",
 *   schedule: "0 9 * * *",
+*   timezone: "America/New_York",
 *   payload: { report: "daily", region: "us" },
 * }).attach({ workflow });
 */
 function defineCronSource(options) {
 	const sourceSlug = resolveAuthoringSlug(options, "defineCronSource");
 	const schedule = parseCronSchedule(options.schedule);
+	const timezone = options.timezone === void 0 ? void 0 : parseTimezone(options.timezone);
 	const name = requireTriggerDisplayText(options.name, "name", "defineCronSource");
 	const description = requireTriggerDisplayText(options.description, "description", "defineCronSource");
 	const payload = options.payload === void 0 ? void 0 : parseCronPayload(options.payload);
@@ -8959,6 +8988,7 @@ function defineCronSource(options) {
 		name,
 		description,
 		schedule,
+		...timezone !== void 0 ? { timezone } : {},
 		...payload !== void 0 ? { payload } : {},
 		attach(attachOptions) {
 			return attachFromSource(source, sourceSlug, attachOptions);
@@ -8969,6 +8999,7 @@ function defineCronSource(options) {
 function definePollSource(options) {
 	const sourceSlug = resolveAuthoringSlug(options, "definePollSource");
 	const schedule = parsePollSchedule(options.schedule);
+	const timezone = options.timezone === void 0 ? void 0 : parseTimezone(options.timezone);
 	const name = requireTriggerDisplayText(options.name, "name", "definePollSource");
 	const description = requireTriggerDisplayText(options.description, "description", "definePollSource");
 	if (options.state && options.id) throw new Error("definePollSource: `state` and `id` (poll grouping) cannot be used together");
@@ -8981,6 +9012,7 @@ function definePollSource(options) {
 		description,
 		id: options.id,
 		schedule,
+		...timezone !== void 0 ? { timezone } : {},
 		run: options.run,
 		stateSchema: options.state,
 		filters,
@@ -9076,6 +9108,7 @@ function resolveAttachmentInput(attachment, payload) {
 	return applyAttachmentTransform(attachment, payload);
 }
 //#endregion
+exports.DEFAULT_TRIGGER_TIMEZONE = DEFAULT_TRIGGER_TIMEZONE;
 exports.TRIGGER_ATTACHMENT = TRIGGER_ATTACHMENT;
 exports.TRIGGER_ATTACHMENT_SIBLINGS = TRIGGER_ATTACHMENT_SIBLINGS;
 exports.agentKeyFromAgent = agentKeyFromAgent;
@@ -9101,6 +9134,7 @@ exports.normalizeWebhookEndpoint = normalizeWebhookEndpoint;
 exports.parseCronPayload = parseCronPayload;
 exports.parseCronSchedule = parseCronSchedule;
 exports.parsePollSchedule = parsePollSchedule;
+exports.parseTimezone = parseTimezone;
 exports.parseTriggerSchedule = parseTriggerSchedule;
 exports.pollScheduleSchema = pollScheduleSchema;
 exports.resolveAgentPrompt = resolveAgentPrompt;
@@ -9109,6 +9143,7 @@ exports.resolveAttachmentTransform = resolveAttachmentTransform;
 exports.resolveAuthoringSlug = resolveAuthoringSlug;
 exports.resolveCronSchedule = resolveCronSchedule;
 exports.sourceSlugFrom = sourceSlugFrom;
+exports.timezoneSchema = timezoneSchema;
 exports.triggerAttachmentsFromExport = triggerAttachmentsFromExport;
 exports.triggerMetaFromAttachment = triggerMetaFromAttachment;
 exports.triggerMetaFromSource = triggerMetaFromSource;