@terreno/jobs 57.4.0

package/dist/runners/vercelQueues.d.ts

@@ -0,0 +1,111 @@
+import { DateTime } from "luxon";
+import { type ExecuteJobOutcome, type JobExecutionHost } from "../jobExecutor";
+import type { JobDocument } from "../modelTypes";
+import type { JobRunner } from "../types";
+/** Vercel Queues maximum delay and retention window (7 days). */
+export declare const VERCEL_QUEUE_MAX_DELAY_SECONDS = 604800;
+export declare const VERCEL_QUEUE_DEFAULT_RETENTION_SECONDS = 86400;
+export declare const VERCEL_QUEUE_MIN_RETENTION_SECONDS = 60;
+export declare const VERCEL_QUEUE_MIN_VISIBILITY_TIMEOUT_SECONDS = 30;
+export declare const VERCEL_QUEUE_MAX_VISIBILITY_TIMEOUT_SECONDS = 3600;
+export declare const VERCEL_QUEUE_DEFAULT_VISIBILITY_TIMEOUT_SECONDS = 1800;
+export declare const VERCEL_QUEUE_LOCKED_RETRY_SECONDS = 30;
+export interface VercelQueueSendOptions {
+    delaySeconds?: number;
+    headers?: Record<string, string>;
+    idempotencyKey?: string;
+    region?: string;
+    retentionSeconds?: number;
+}
+export interface VercelQueueSendResult {
+    messageId: string | null;
+}
+/** Narrow `send` seam — inject in tests; production loads `@vercel/queue`. */
+export type VercelQueueSendFn = (topic: string, payload: unknown, options?: VercelQueueSendOptions) => Promise<VercelQueueSendResult>;
+/** `@vercel/queue` 0.5.1 message metadata (all fields required). */
+export interface VercelQueueMessageMetadata {
+    consumerGroup: string;
+    createdAt: Date;
+    deliveryCount: number;
+    expiresAt: Date;
+    messageId: string;
+    region: string;
+    topicName: string;
+}
+export type VercelQueueRetryDirective = {
+    acknowledge: true;
+} | {
+    afterSeconds: number;
+};
+export type VercelQueueMessageHandler = (message: unknown, metadata: VercelQueueMessageMetadata) => Promise<void>;
+export type VercelQueueRetryHandler = (error: unknown, metadata: VercelQueueMessageMetadata) => VercelQueueRetryDirective | undefined;
+export type VercelHandleCallbackFn = (handler: VercelQueueMessageHandler, options?: VercelHandleCallbackOptions) => VercelQueueRouteHandler;
+export interface VercelHandleCallbackOptions {
+    retry?: VercelQueueRetryHandler;
+    visibilityTimeoutSeconds?: number;
+}
+export type VercelQueueRouteRequest = Request | {
+    request: Request;
+};
+export type VercelQueueRouteHandler = (request: VercelQueueRouteRequest) => Promise<Response>;
+export interface VercelQueuesRunnerConfig {
+    /** Injected `send` for tests. Production wiring loads `@vercel/queue`. */
+    send?: VercelQueueSendFn;
+    region?: string;
+    retentionSeconds?: number;
+    /** Queue topic published by {@link VercelQueuesRunner.enqueue}. */
+    topic: string;
+}
+export interface VercelQueuesConsumerOptions {
+    handleCallback?: VercelHandleCallbackFn;
+    host: JobExecutionHost;
+    signal?: AbortSignal;
+    visibilityTimeoutSeconds?: number;
+}
+export declare class VercelQueueRunAtBeyondLimitError extends Error {
+    readonly maxDelaySeconds: number;
+    readonly runAt: Date;
+    constructor(runAt: Date, maxDelaySeconds: number);
+}
+export declare class VercelQueueConsumerControl extends Error {
+    readonly directive: VercelQueueRetryDirective;
+    constructor(directive: VercelQueueRetryDirective);
+}
+export declare const computeVercelQueueDelaySeconds: (runAt: Date, now?: DateTime<true>) => number | undefined;
+export declare const resolveVercelQueueSendRetentionSeconds: (delaySeconds: number | undefined, configuredRetention?: number) => number;
+/** Clamp queue retry visibility changes to the vendor 0.5.1 range (30s–1h). */
+export declare const clampVercelQueueRetryAfterSeconds: (seconds: number) => number;
+/**
+ * Seconds until {@link runAt}, clamped for `handleCallback` retry visibility (30–3600).
+ * not_due jobs more than 1h away retry at 3600s until due.
+ */
+export declare const computeVercelQueueRetryAfterSeconds: (runAt: Date, now?: DateTime<true>) => number;
+export declare const buildVercelQueueSendOptions: (job: JobDocument, config: {
+    region?: string;
+    retentionSeconds?: number;
+}, now?: DateTime<true>) => VercelQueueSendOptions;
+export declare const resolveVercelQueueConsumerRetry: (error: unknown) => VercelQueueRetryDirective | undefined;
+export declare const applyVercelQueueExecutionOutcome: (outcome: ExecuteJobOutcome) => void;
+/**
+ * Dispatch-only runner that publishes `{jobId}` to a Vercel Queue topic via `send`.
+ *
+ * Required `vercel.json` consumer (private route — platform auth only):
+ * `"experimentalTriggers": [{ "type": "queue/v2beta", "topic": "<topic>" }]`
+ */
+export declare class VercelQueuesRunner implements JobRunner {
+    readonly id = "vercel-queues";
+    /**
+     * Vercel push consumers are private `handleCallback` routes, not Express
+     * `POST /jobs/execute`. Use {@link createVercelQueuesConsumer} on the consumer route.
+     */
+    readonly requiresExecuteRoute = false;
+    private readonly config;
+    private readonly send;
+    constructor(config: VercelQueuesRunnerConfig);
+    enqueue(job: JobDocument): Promise<void>;
+}
+/**
+ * Wraps vendor `handleCallback` to execute a queued `{jobId}` through Terreno's
+ * Mongo-backed {@link executeJobById} seam. Platform auth stays in the vendor handler.
+ */
+export declare const createVercelQueuesConsumer: (options: VercelQueuesConsumerOptions) => VercelQueueRouteHandler;

package/dist/runners/vercelQueues.js

@@ -0,0 +1,326 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVercelQueuesConsumer = exports.VercelQueuesRunner = exports.applyVercelQueueExecutionOutcome = exports.resolveVercelQueueConsumerRetry = exports.buildVercelQueueSendOptions = exports.computeVercelQueueRetryAfterSeconds = exports.clampVercelQueueRetryAfterSeconds = exports.resolveVercelQueueSendRetentionSeconds = exports.computeVercelQueueDelaySeconds = exports.VercelQueueConsumerControl = exports.VercelQueueRunAtBeyondLimitError = exports.VERCEL_QUEUE_LOCKED_RETRY_SECONDS = exports.VERCEL_QUEUE_DEFAULT_VISIBILITY_TIMEOUT_SECONDS = exports.VERCEL_QUEUE_MAX_VISIBILITY_TIMEOUT_SECONDS = exports.VERCEL_QUEUE_MIN_VISIBILITY_TIMEOUT_SECONDS = exports.VERCEL_QUEUE_MIN_RETENTION_SECONDS = exports.VERCEL_QUEUE_DEFAULT_RETENTION_SECONDS = exports.VERCEL_QUEUE_MAX_DELAY_SECONDS = void 0;
+var node_module_1 = require("node:module");
+var luxon_1 = require("luxon");
+var jobExecutor_1 = require("../jobExecutor");
+/** Vercel Queues maximum delay and retention window (7 days). */
+exports.VERCEL_QUEUE_MAX_DELAY_SECONDS = 604800;
+exports.VERCEL_QUEUE_DEFAULT_RETENTION_SECONDS = 86400;
+exports.VERCEL_QUEUE_MIN_RETENTION_SECONDS = 60;
+exports.VERCEL_QUEUE_MIN_VISIBILITY_TIMEOUT_SECONDS = 30;
+exports.VERCEL_QUEUE_MAX_VISIBILITY_TIMEOUT_SECONDS = 3600;
+exports.VERCEL_QUEUE_DEFAULT_VISIBILITY_TIMEOUT_SECONDS = 1800;
+exports.VERCEL_QUEUE_LOCKED_RETRY_SECONDS = 30;
+var nodeRequire = (0, node_module_1.createRequire)(__filename);
+var VercelQueueRunAtBeyondLimitError = /** @class */ (function (_super) {
+    __extends(VercelQueueRunAtBeyondLimitError, _super);
+    function VercelQueueRunAtBeyondLimitError(runAt, maxDelaySeconds) {
+        var _this = _super.call(this, "Job runAt ".concat(runAt.toISOString(), " exceeds Vercel Queue maximum delay of ").concat(maxDelaySeconds, " seconds")) || this;
+        _this.name = "VercelQueueRunAtBeyondLimitError";
+        _this.runAt = runAt;
+        _this.maxDelaySeconds = maxDelaySeconds;
+        return _this;
+    }
+    return VercelQueueRunAtBeyondLimitError;
+}(Error));
+exports.VercelQueueRunAtBeyondLimitError = VercelQueueRunAtBeyondLimitError;
+var VercelQueueConsumerControl = /** @class */ (function (_super) {
+    __extends(VercelQueueConsumerControl, _super);
+    function VercelQueueConsumerControl(directive) {
+        var _this = _super.call(this, "Vercel queue consumer control") || this;
+        _this.name = "VercelQueueConsumerControl";
+        _this.directive = directive;
+        return _this;
+    }
+    return VercelQueueConsumerControl;
+}(Error));
+exports.VercelQueueConsumerControl = VercelQueueConsumerControl;
+var requireNonEmpty = function (value, label) {
+    var trimmed = value === null || value === void 0 ? void 0 : value.trim();
+    if (!trimmed) {
+        throw new Error("VercelQueuesRunner requires ".concat(label));
+    }
+    return trimmed;
+};
+var validateRetentionSeconds = function (retentionSeconds) {
+    if (retentionSeconds === undefined) {
+        return undefined;
+    }
+    if (!Number.isFinite(retentionSeconds) ||
+        retentionSeconds < exports.VERCEL_QUEUE_MIN_RETENTION_SECONDS ||
+        retentionSeconds > exports.VERCEL_QUEUE_MAX_DELAY_SECONDS) {
+        throw new Error("VercelQueuesRunner retentionSeconds must be between ".concat(exports.VERCEL_QUEUE_MIN_RETENTION_SECONDS, " and ").concat(exports.VERCEL_QUEUE_MAX_DELAY_SECONDS, " seconds"));
+    }
+    return retentionSeconds;
+};
+var validateVisibilityTimeoutSeconds = function (visibilityTimeoutSeconds) {
+    if (visibilityTimeoutSeconds === undefined) {
+        return exports.VERCEL_QUEUE_DEFAULT_VISIBILITY_TIMEOUT_SECONDS;
+    }
+    if (!Number.isFinite(visibilityTimeoutSeconds) ||
+        visibilityTimeoutSeconds < exports.VERCEL_QUEUE_MIN_VISIBILITY_TIMEOUT_SECONDS ||
+        visibilityTimeoutSeconds > exports.VERCEL_QUEUE_MAX_VISIBILITY_TIMEOUT_SECONDS) {
+        throw new Error("VercelQueuesConsumer visibilityTimeoutSeconds must be between ".concat(exports.VERCEL_QUEUE_MIN_VISIBILITY_TIMEOUT_SECONDS, " and ").concat(exports.VERCEL_QUEUE_MAX_VISIBILITY_TIMEOUT_SECONDS, " seconds"));
+    }
+    return visibilityTimeoutSeconds;
+};
+var resolveConfig = function (config) {
+    var _a;
+    return ({
+        region: ((_a = config.region) === null || _a === void 0 ? void 0 : _a.trim()) || undefined,
+        retentionSeconds: validateRetentionSeconds(config.retentionSeconds),
+        topic: requireNonEmpty(config.topic, "topic"),
+    });
+};
+var loadQueueSend = function () {
+    try {
+        var module_1 = nodeRequire("@vercel/queue");
+        return module_1.send;
+    }
+    catch (_a) {
+        throw new Error("VercelQueuesRunner requires optional peer dependency @vercel/queue. " +
+            "Install it with: bun add @vercel/queue");
+    }
+};
+var loadHandleCallback = function () {
+    try {
+        var module_2 = nodeRequire("@vercel/queue");
+        return module_2.handleCallback;
+    }
+    catch (_a) {
+        throw new Error("createVercelQueuesConsumer requires optional peer dependency @vercel/queue. " +
+            "Install it with: bun add @vercel/queue");
+    }
+};
+var readJobId = function (message) {
+    if (!message || typeof message !== "object" || !("jobId" in message)) {
+        return undefined;
+    }
+    var jobId = message.jobId;
+    if (typeof jobId !== "string") {
+        return undefined;
+    }
+    var trimmed = jobId.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+};
+var computeVercelQueueDelaySeconds = function (runAt, now) {
+    if (now === void 0) { now = luxon_1.DateTime.utc(); }
+    var scheduled = luxon_1.DateTime.fromJSDate(runAt, { zone: "utc" });
+    if (scheduled <= now) {
+        return undefined;
+    }
+    var delaySeconds = Math.floor(scheduled.diff(now, "seconds").seconds);
+    if (delaySeconds <= 0) {
+        return undefined;
+    }
+    if (delaySeconds > exports.VERCEL_QUEUE_MAX_DELAY_SECONDS) {
+        throw new VercelQueueRunAtBeyondLimitError(runAt, exports.VERCEL_QUEUE_MAX_DELAY_SECONDS);
+    }
+    return delaySeconds;
+};
+exports.computeVercelQueueDelaySeconds = computeVercelQueueDelaySeconds;
+var resolveVercelQueueSendRetentionSeconds = function (delaySeconds, configuredRetention) {
+    var baseRetention = configuredRetention !== null && configuredRetention !== void 0 ? configuredRetention : exports.VERCEL_QUEUE_DEFAULT_RETENTION_SECONDS;
+    if (delaySeconds === undefined) {
+        return baseRetention;
+    }
+    return Math.max(baseRetention, delaySeconds);
+};
+exports.resolveVercelQueueSendRetentionSeconds = resolveVercelQueueSendRetentionSeconds;
+/** Clamp queue retry visibility changes to the vendor 0.5.1 range (30s–1h). */
+var clampVercelQueueRetryAfterSeconds = function (seconds) {
+    return Math.max(exports.VERCEL_QUEUE_MIN_VISIBILITY_TIMEOUT_SECONDS, Math.min(seconds, exports.VERCEL_QUEUE_MAX_VISIBILITY_TIMEOUT_SECONDS));
+};
+exports.clampVercelQueueRetryAfterSeconds = clampVercelQueueRetryAfterSeconds;
+/**
+ * Seconds until {@link runAt}, clamped for `handleCallback` retry visibility (30–3600).
+ * not_due jobs more than 1h away retry at 3600s until due.
+ */
+var computeVercelQueueRetryAfterSeconds = function (runAt, now) {
+    if (now === void 0) { now = luxon_1.DateTime.utc(); }
+    var seconds = Math.ceil(luxon_1.DateTime.fromJSDate(runAt, { zone: "utc" }).diff(now, "seconds").seconds);
+    if (seconds <= 0) {
+        return exports.VERCEL_QUEUE_MIN_VISIBILITY_TIMEOUT_SECONDS;
+    }
+    return (0, exports.clampVercelQueueRetryAfterSeconds)(seconds);
+};
+exports.computeVercelQueueRetryAfterSeconds = computeVercelQueueRetryAfterSeconds;
+var buildVercelQueueSendOptions = function (job, config, now) {
+    if (now === void 0) { now = luxon_1.DateTime.utc(); }
+    var delaySeconds = (0, exports.computeVercelQueueDelaySeconds)(job.runAt, now);
+    var retentionSeconds = (0, exports.resolveVercelQueueSendRetentionSeconds)(delaySeconds, config.retentionSeconds);
+    return __assign(__assign({ idempotencyKey: job._id.toString(), retentionSeconds: retentionSeconds }, (config.region ? { region: config.region } : {})), (delaySeconds !== undefined ? { delaySeconds: delaySeconds } : {}));
+};
+exports.buildVercelQueueSendOptions = buildVercelQueueSendOptions;
+var normalizeRetryDirective = function (directive) {
+    if ("acknowledge" in directive) {
+        return directive;
+    }
+    return { afterSeconds: (0, exports.clampVercelQueueRetryAfterSeconds)(directive.afterSeconds) };
+};
+var resolveVercelQueueConsumerRetry = function (error) {
+    if (error instanceof VercelQueueConsumerControl) {
+        return normalizeRetryDirective(error.directive);
+    }
+    return undefined;
+};
+exports.resolveVercelQueueConsumerRetry = resolveVercelQueueConsumerRetry;
+var applyVercelQueueExecutionOutcome = function (outcome) {
+    if (outcome.kind === "not_found") {
+        throw new VercelQueueConsumerControl({ acknowledge: true });
+    }
+    if (outcome.kind === "noop") {
+        return;
+    }
+    if (outcome.kind === "conflict") {
+        if (outcome.reason === "not_due") {
+            throw new VercelQueueConsumerControl({
+                afterSeconds: (0, exports.computeVercelQueueRetryAfterSeconds)(outcome.runAt),
+            });
+        }
+        throw new VercelQueueConsumerControl({ afterSeconds: exports.VERCEL_QUEUE_LOCKED_RETRY_SECONDS });
+    }
+    if (outcome.job.status === "pending") {
+        var now = luxon_1.DateTime.utc();
+        var afterSeconds = outcome.job.runAt > now.toJSDate()
+            ? (0, exports.computeVercelQueueRetryAfterSeconds)(outcome.job.runAt, now)
+            : exports.VERCEL_QUEUE_MIN_VISIBILITY_TIMEOUT_SECONDS;
+        throw new VercelQueueConsumerControl({ afterSeconds: afterSeconds });
+    }
+};
+exports.applyVercelQueueExecutionOutcome = applyVercelQueueExecutionOutcome;
+/**
+ * Dispatch-only runner that publishes `{jobId}` to a Vercel Queue topic via `send`.
+ *
+ * Required `vercel.json` consumer (private route — platform auth only):
+ * `"experimentalTriggers": [{ "type": "queue/v2beta", "topic": "<topic>" }]`
+ */
+var VercelQueuesRunner = /** @class */ (function () {
+    function VercelQueuesRunner(config) {
+        var _a;
+        this.id = "vercel-queues";
+        /**
+         * Vercel push consumers are private `handleCallback` routes, not Express
+         * `POST /jobs/execute`. Use {@link createVercelQueuesConsumer} on the consumer route.
+         */
+        this.requiresExecuteRoute = false;
+        this.config = resolveConfig(config);
+        this.send = (_a = config.send) !== null && _a !== void 0 ? _a : loadQueueSend();
+    }
+    VercelQueuesRunner.prototype.enqueue = function (job) {
+        return __awaiter(this, void 0, void 0, function () {
+            var payload, options;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        payload = { jobId: job._id.toString() };
+                        options = (0, exports.buildVercelQueueSendOptions)(job, this.config);
+                        return [4 /*yield*/, this.send(this.config.topic, payload, options)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    return VercelQueuesRunner;
+}());
+exports.VercelQueuesRunner = VercelQueuesRunner;
+/**
+ * Wraps vendor `handleCallback` to execute a queued `{jobId}` through Terreno's
+ * Mongo-backed {@link executeJobById} seam. Platform auth stays in the vendor handler.
+ */
+var createVercelQueuesConsumer = function (options) {
+    var _a, _b;
+    var handleCallback = (_a = options.handleCallback) !== null && _a !== void 0 ? _a : loadHandleCallback();
+    var signal = (_b = options.signal) !== null && _b !== void 0 ? _b : AbortSignal.timeout(30 * 60 * 1000);
+    var visibilityTimeoutSeconds = validateVisibilityTimeoutSeconds(options.visibilityTimeoutSeconds);
+    return handleCallback(function (message) { return __awaiter(void 0, void 0, void 0, function () {
+        var jobId, outcome;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    jobId = readJobId(message);
+                    if (!jobId) {
+                        throw new VercelQueueConsumerControl({ acknowledge: true });
+                    }
+                    return [4 /*yield*/, (0, jobExecutor_1.executeJobById)({
+                            host: options.host,
+                            jobId: jobId,
+                            signal: signal,
+                        })];
+                case 1:
+                    outcome = _a.sent();
+                    (0, exports.applyVercelQueueExecutionOutcome)(outcome);
+                    return [2 /*return*/];
+            }
+        });
+    }); }, {
+        retry: exports.resolveVercelQueueConsumerRetry,
+        visibilityTimeoutSeconds: visibilityTimeoutSeconds,
+    });
+};
+exports.createVercelQueuesConsumer = createVercelQueuesConsumer;

package/dist/scheduleCron.d.ts

@@ -0,0 +1,15 @@
+export declare const resolveScheduleTimezone: ({ defaultTimezone, scheduleTimezone, }: {
+    defaultTimezone: string;
+    scheduleTimezone?: string;
+}) => string;
+/** @internal */
+export declare const assertValidIanaTimezone: (timezone: string) => void;
+/** @internal */
+export declare const assertValidCronExpression: (cron: string, timezone: string) => void;
+export declare const validateScheduleDefinition: ({ cron, defaultTimezone, scheduleTimezone, }: {
+    cron: string;
+    defaultTimezone: string;
+    scheduleTimezone?: string;
+}) => string;
+export declare const computeInitialNextRunAt: (cron: string, timezone: string) => Date;
+export declare const computeNextRunAtAfter: (cron: string, timezone: string, after: Date) => Date;

package/dist/scheduleCron.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeNextRunAtAfter = exports.computeInitialNextRunAt = exports.validateScheduleDefinition = exports.assertValidCronExpression = exports.assertValidIanaTimezone = exports.resolveScheduleTimezone = void 0;
+var api_1 = require("@terreno/api");
+var cron_1 = require("cron");
+var luxon_1 = require("luxon");
+var INVALID_CRON_TITLE = "Invalid cron expression";
+var INVALID_TIMEZONE_TITLE = "Invalid IANA timezone";
+var resolveScheduleTimezone = function (_a) {
+    var defaultTimezone = _a.defaultTimezone, scheduleTimezone = _a.scheduleTimezone;
+    return scheduleTimezone !== null && scheduleTimezone !== void 0 ? scheduleTimezone : defaultTimezone;
+};
+exports.resolveScheduleTimezone = resolveScheduleTimezone;
+/** @internal */
+var assertValidIanaTimezone = function (timezone) {
+    var _a;
+    var zoneCheck = luxon_1.DateTime.now().setZone(timezone);
+    if (!zoneCheck.isValid) {
+        throw new api_1.APIError({
+            detail: (_a = zoneCheck.invalidReason) !== null && _a !== void 0 ? _a : "Timezone is not a valid IANA identifier",
+            status: 400,
+            title: INVALID_TIMEZONE_TITLE,
+        });
+    }
+};
+exports.assertValidIanaTimezone = assertValidIanaTimezone;
+/** @internal */
+var assertValidCronExpression = function (cron, timezone) {
+    try {
+        new cron_1.CronTime(cron, timezone);
+    }
+    catch (error) {
+        var detail = error instanceof Error ? error.message : String(error);
+        throw new api_1.APIError({
+            cause: error instanceof Error ? error : undefined,
+            detail: detail,
+            status: 400,
+            title: INVALID_CRON_TITLE,
+        });
+    }
+};
+exports.assertValidCronExpression = assertValidCronExpression;
+var validateScheduleDefinition = function (_a) {
+    var cron = _a.cron, defaultTimezone = _a.defaultTimezone, scheduleTimezone = _a.scheduleTimezone;
+    var timezone = (0, exports.resolveScheduleTimezone)({
+        defaultTimezone: defaultTimezone,
+        scheduleTimezone: scheduleTimezone,
+    });
+    (0, exports.assertValidIanaTimezone)(timezone);
+    (0, exports.assertValidCronExpression)(cron, timezone);
+    return timezone;
+};
+exports.validateScheduleDefinition = validateScheduleDefinition;
+var computeInitialNextRunAt = function (cron, timezone) {
+    return (0, exports.computeNextRunAtAfter)(cron, timezone, luxon_1.DateTime.utc().toJSDate());
+};
+exports.computeInitialNextRunAt = computeInitialNextRunAt;
+var computeNextRunAtAfter = function (cron, timezone, after) {
+    return new cron_1.CronTime(cron, timezone).getNextDateFrom(after, timezone).toJSDate();
+};
+exports.computeNextRunAtAfter = computeNextRunAtAfter;

package/dist/scheduler.d.ts

@@ -0,0 +1,8 @@
+import type { JobsService } from "./jobsService";
+/** @internal */
+export declare const buildScheduleRunIdempotencyKey: (scheduleId: string, dueRunAt: Date) => string;
+export declare const tickDueSchedules: ({ jobsService, now, }: {
+    defaultTimezone?: string;
+    jobsService: JobsService;
+    now?: Date;
+}) => Promise<void>;