vercel-cronjob 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nikoewe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# vercel-cronjob
+
+Standalone cron job runner that reads `vercel.json` and replicates Vercel's cron behavior — scheduled HTTP GET requests with the same headers Vercel sends.
+
+Useful for running Vercel cron jobs in environments where Vercel isn't handling scheduling (e.g., Kubernetes production deployments).
+
+## Install
+
+```bash
+npm install github:nikoewe/vercel-cronjob
+```
+
+## Usage
+
+```typescript
+import { runCrons } from "vercel-cronjob";
+
+runCrons({ url: "http://localhost:3000" });
+```
+
+With all options:
+
+```typescript
+runCrons({
+  url: "http://localhost:3000",
+  cronSecret: "my-secret",         // optional — sent as Authorization: Bearer <secret>
+  vercelJsonPath: "./vercel.json",  // optional — defaults to ./vercel.json
+});
+```
+
+## CLI
+
+The package also ships a CLI that reads configuration from environment variables:
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `BASE_URL` | Yes | Target app URL |
+| `CRON_SECRET` | No | Sent as `Authorization: Bearer <secret>` |
+| `VERCEL_JSON_PATH` | No | Path to vercel.json (default: `./vercel.json`) |
+
+```bash
+BASE_URL=http://localhost:3000 npx vercel-cronjob
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli.js

@@ -0,0 +1,18 @@
+import { runCrons } from "./index.js";
+async function main() {
+    const url = process.env.BASE_URL;
+    if (!url) {
+        console.error("ERROR: BASE_URL environment variable is required");
+        process.exit(1);
+    }
+    await runCrons({
+        url,
+        cronSecret: process.env.CRON_SECRET,
+        vercelJsonPath: process.env.VERCEL_JSON_PATH,
+    });
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,CAAC;QACb,GAAG;QACH,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;QACnC,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;KAC7C,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+export interface CronEntry {
+    path: string;
+    schedule: string;
+}
+export declare function loadCrons(vercelJsonPath?: string): Promise<CronEntry[]>;

package/dist/config.js

@@ -0,0 +1,25 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+export async function loadCrons(vercelJsonPath) {
+    const filePath = resolve(vercelJsonPath ?? "./vercel.json");
+    const raw = await readFile(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (!parsed.crons || !Array.isArray(parsed.crons)) {
+        throw new Error(`No "crons" array found in ${filePath}`);
+    }
+    const crons = [];
+    for (const entry of parsed.crons) {
+        if (!entry.path || typeof entry.path !== "string") {
+            throw new Error(`Invalid cron entry: missing "path"`);
+        }
+        if (!entry.schedule || typeof entry.schedule !== "string") {
+            throw new Error(`Invalid cron entry for ${entry.path}: missing "schedule"`);
+        }
+        crons.push({ path: entry.path, schedule: entry.schedule });
+    }
+    if (crons.length === 0) {
+        throw new Error(`"crons" array is empty in ${filePath}`);
+    }
+    return crons;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,cAAuB;IAEvB,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,IAAI,eAAe,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAe,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE3C,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,0BAA0B,KAAK,CAAC,IAAI,sBAAsB,CAC3D,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/config.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/config.test.js

@@ -0,0 +1,64 @@
+import { describe, it, expect, afterEach } from "vitest";
+import { writeFile, mkdtemp, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { loadCrons } from "./config.js";
+describe("loadCrons", () => {
+    const tmpDirs = [];
+    async function writeTempVercelJson(content) {
+        const dir = await mkdtemp(join(tmpdir(), "vercel-cron-test-"));
+        tmpDirs.push(dir);
+        const filePath = join(dir, "vercel.json");
+        await writeFile(filePath, JSON.stringify(content));
+        return filePath;
+    }
+    afterEach(async () => {
+        for (const dir of tmpDirs) {
+            await rm(dir, { recursive: true, force: true });
+        }
+        tmpDirs.length = 0;
+    });
+    it("parses valid vercel.json with a single cron", async () => {
+        const path = await writeTempVercelJson({
+            crons: [{ path: "/api/test", schedule: "0 7 * * *" }],
+        });
+        const crons = await loadCrons(path);
+        expect(crons).toEqual([{ path: "/api/test", schedule: "0 7 * * *" }]);
+    });
+    it("parses valid vercel.json with multiple crons", async () => {
+        const path = await writeTempVercelJson({
+            crons: [
+                { path: "/api/one", schedule: "0 7 * * *" },
+                { path: "/api/two", schedule: "*/5 * * * *" },
+            ],
+        });
+        const crons = await loadCrons(path);
+        expect(crons).toHaveLength(2);
+        expect(crons[0].path).toBe("/api/one");
+        expect(crons[1].path).toBe("/api/two");
+    });
+    it("throws when file does not exist", async () => {
+        await expect(loadCrons("/tmp/nonexistent/vercel.json")).rejects.toThrow();
+    });
+    it("throws when no crons array", async () => {
+        const path = await writeTempVercelJson({ builds: [] });
+        await expect(loadCrons(path)).rejects.toThrow('No "crons" array');
+    });
+    it("throws when crons is empty", async () => {
+        const path = await writeTempVercelJson({ crons: [] });
+        await expect(loadCrons(path)).rejects.toThrow("empty");
+    });
+    it("throws when entry missing path", async () => {
+        const path = await writeTempVercelJson({
+            crons: [{ schedule: "0 7 * * *" }],
+        });
+        await expect(loadCrons(path)).rejects.toThrow('missing "path"');
+    });
+    it("throws when entry missing schedule", async () => {
+        const path = await writeTempVercelJson({
+            crons: [{ path: "/api/test" }],
+        });
+        await expect(loadCrons(path)).rejects.toThrow('missing "schedule"');
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../src/config.test.ts"],"names":[],"mappings":"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"}

package/dist/executor.d.ts

@@ -0,0 +1,7 @@
+export interface CronResult {
+    path: string;
+    status: number;
+    ok: boolean;
+    durationMs: number;
+}
+export declare function executeCron(baseUrl: string, path: string, cronSecret?: string): Promise<CronResult>;

package/dist/executor.js

@@ -0,0 +1,22 @@
+export async function executeCron(baseUrl, path, cronSecret) {
+    const url = `${baseUrl}${path}`;
+    const headers = {
+        "User-Agent": "vercel-cron/1.0",
+    };
+    if (cronSecret) {
+        headers["Authorization"] = `Bearer ${cronSecret}`;
+    }
+    const start = performance.now();
+    const response = await fetch(url, {
+        method: "GET",
+        headers,
+    });
+    const durationMs = Math.round(performance.now() - start);
+    return {
+        path,
+        status: response.status,
+        ok: response.ok,
+        durationMs,
+    };
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,IAAY,EACZ,UAAmB;IAEnB,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,CAAC;IAChC,MAAM,OAAO,GAA2B;QACtC,YAAY,EAAE,iBAAiB;KAChC,CAAC;IAEF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,UAAU,EAAE,CAAC;IACpD,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAEhC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,KAAK;QACb,OAAO;KACR,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IAEzD,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/executor.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/executor.test.js

@@ -0,0 +1,56 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { executeCron } from "./executor.js";
+describe("executeCron", () => {
+    const originalFetch = globalThis.fetch;
+    beforeEach(() => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({
+            status: 200,
+            ok: true,
+        }));
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    it("sends GET request to correct URL", async () => {
+        await executeCron("http://localhost:3000", "/api/test");
+        expect(fetch).toHaveBeenCalledWith("http://localhost:3000/api/test", {
+            method: "GET",
+            headers: expect.objectContaining({
+                "User-Agent": "vercel-cron/1.0",
+            }),
+        });
+    });
+    it("includes Authorization header when cronSecret is provided", async () => {
+        await executeCron("http://localhost:3000", "/api/test", "my-secret");
+        expect(fetch).toHaveBeenCalledWith(expect.any(String), expect.objectContaining({
+            headers: expect.objectContaining({
+                Authorization: "Bearer my-secret",
+            }),
+        }));
+    });
+    it("omits Authorization header when no cronSecret", async () => {
+        await executeCron("http://localhost:3000", "/api/test");
+        const call = vi.mocked(fetch).mock.calls[0];
+        const headers = call[1].headers;
+        expect(headers).not.toHaveProperty("Authorization");
+    });
+    it("returns path, status, ok, and durationMs", async () => {
+        const result = await executeCron("http://localhost:3000", "/api/test");
+        expect(result).toEqual({
+            path: "/api/test",
+            status: 200,
+            ok: true,
+            durationMs: expect.any(Number),
+        });
+    });
+    it("handles non-200 responses", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({
+            status: 500,
+            ok: false,
+        }));
+        const result = await executeCron("http://localhost:3000", "/api/test");
+        expect(result.status).toBe(500);
+        expect(result.ok).toBe(false);
+    });
+});
+//# sourceMappingURL=executor.test.js.map

package/dist/executor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.test.js","sourceRoot":"","sources":["../src/executor.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { loadCrons } from "./config.js";
+export type { CronEntry } from "./config.js";
+export { executeCron } from "./executor.js";
+export type { CronResult } from "./executor.js";
+export { startScheduler } from "./scheduler.js";
+export type { SchedulerConfig } from "./scheduler.js";
+export interface RunCronsOptions {
+    url: string;
+    cronSecret?: string;
+    vercelJsonPath?: string;
+}
+export declare function runCrons(options: RunCronsOptions): Promise<import("node-cron").ScheduledTask[]>;

package/dist/index.js

@@ -0,0 +1,20 @@
+import { loadCrons } from "./config.js";
+import { startScheduler } from "./scheduler.js";
+export { loadCrons } from "./config.js";
+export { executeCron } from "./executor.js";
+export { startScheduler } from "./scheduler.js";
+export async function runCrons(options) {
+    const { url, cronSecret, vercelJsonPath } = options;
+    const crons = await loadCrons(vercelJsonPath);
+    console.log(`vercel-cronjob starting...`);
+    console.log(`  URL: ${url}`);
+    console.log(`  CRON_SECRET: ${cronSecret ? "***" : "(not set)"}`);
+    console.log(`\nRegistered ${crons.length} cron(s):`);
+    for (const entry of crons) {
+        console.log(`  ${entry.schedule}  →  ${entry.path}`);
+    }
+    const tasks = startScheduler({ crons, baseUrl: url, cronSecret });
+    console.log("\nScheduler running. Waiting for triggers...\n");
+    return tasks;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAShD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACrD,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAEpD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,CAAC;IAE9C,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,kBAAkB,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,MAAM,WAAW,CAAC,CAAC;IACrD,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,QAAQ,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;IAElE,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAE9D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/scheduler.d.ts

@@ -0,0 +1,8 @@
+import cron from "node-cron";
+import type { CronEntry } from "./config.js";
+export interface SchedulerConfig {
+    crons: CronEntry[];
+    baseUrl: string;
+    cronSecret?: string;
+}
+export declare function startScheduler(config: SchedulerConfig): cron.ScheduledTask[];

package/dist/scheduler.js

@@ -0,0 +1,31 @@
+import cron from "node-cron";
+import { executeCron } from "./executor.js";
+export function startScheduler(config) {
+    const { crons, baseUrl, cronSecret } = config;
+    const tasks = [];
+    for (const entry of crons) {
+        const task = cron.schedule(entry.schedule, async () => {
+            const timestamp = new Date().toISOString();
+            console.log(`[${timestamp}] Triggering ${entry.path}`);
+            try {
+                const result = await executeCron(baseUrl, entry.path, cronSecret);
+                console.log(`[${timestamp}] ${result.path} → ${result.status} (${result.durationMs}ms)`);
+            }
+            catch (err) {
+                console.error(`[${timestamp}] ${entry.path} → FAILED:`, err);
+            }
+        });
+        tasks.push(task);
+    }
+    const shutdown = () => {
+        console.log("\nShutting down scheduler...");
+        for (const task of tasks) {
+            task.stop();
+        }
+        process.exit(0);
+    };
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+    return tasks;
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQ5C,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAC9C,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,IAAI,SAAS,gBAAgB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAEvD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAClE,OAAO,CAAC,GAAG,CACT,IAAI,SAAS,KAAK,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,UAAU,KAAK,CAC5E,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,KAAK,CAAC,IAAI,YAAY,EAAE,GAAG,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE/B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/scheduler.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/scheduler.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import cron from "node-cron";
+import { startScheduler } from "./scheduler.js";
+vi.mock("node-cron", () => ({
+    default: {
+        schedule: vi.fn(() => ({ stop: vi.fn() })),
+    },
+}));
+describe("startScheduler", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("registers a cron task for each entry", () => {
+        const tasks = startScheduler({
+            crons: [
+                { path: "/api/one", schedule: "0 7 * * *" },
+                { path: "/api/two", schedule: "*/5 * * * *" },
+            ],
+            baseUrl: "http://localhost:3000",
+        });
+        expect(cron.schedule).toHaveBeenCalledTimes(2);
+        expect(cron.schedule).toHaveBeenCalledWith("0 7 * * *", expect.any(Function));
+        expect(cron.schedule).toHaveBeenCalledWith("*/5 * * * *", expect.any(Function));
+        expect(tasks).toHaveLength(2);
+    });
+    it("returns tasks that can be stopped", () => {
+        const tasks = startScheduler({
+            crons: [{ path: "/api/test", schedule: "0 7 * * *" }],
+            baseUrl: "http://localhost:3000",
+        });
+        expect(tasks[0].stop).toBeDefined();
+        tasks[0].stop();
+    });
+});
+//# sourceMappingURL=scheduler.test.js.map

package/dist/scheduler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.test.js","sourceRoot":"","sources":["../src/scheduler.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1B,OAAO,EAAE;QACP,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;KAC3C;CACF,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,KAAK,GAAG,cAAc,CAAC;YAC3B,KAAK,EAAE;gBACL,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE;gBAC3C,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE;aAC9C;YACD,OAAO,EAAE,uBAAuB;SACjC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CACxC,WAAW,EACX,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CACrB,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CACxC,aAAa,EACb,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CACrB,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,KAAK,GAAG,cAAc,CAAC;YAC3B,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;YACrD,OAAO,EAAE,uBAAuB;SACjC,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "vercel-cronjob",
+  "version": "1.0.0",
+  "description": "Standalone Vercel cron job runner — replicates Vercel's cron behavior for non-Vercel deployments",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "vercel-cronjob": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run --exclude dist"
+  },
+  "dependencies": {
+    "node-cron": "^3.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/node-cron": "^3.0.11",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.18"
+  },
+  "license": "MIT"
+}

package/src/cli.ts

@@ -0,0 +1,20 @@
+import { runCrons } from "./index.js";
+
+async function main() {
+  const url = process.env.BASE_URL;
+  if (!url) {
+    console.error("ERROR: BASE_URL environment variable is required");
+    process.exit(1);
+  }
+
+  await runCrons({
+    url,
+    cronSecret: process.env.CRON_SECRET,
+    vercelJsonPath: process.env.VERCEL_JSON_PATH,
+  });
+}
+
+main().catch((err) => {
+  console.error("Fatal:", err);
+  process.exit(1);
+});

package/src/config.test.ts

@@ -0,0 +1,73 @@
+import { describe, it, expect, afterEach } from "vitest";
+import { writeFile, mkdtemp, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { loadCrons } from "./config.js";
+
+describe("loadCrons", () => {
+  const tmpDirs: string[] = [];
+
+  async function writeTempVercelJson(content: unknown): Promise<string> {
+    const dir = await mkdtemp(join(tmpdir(), "vercel-cron-test-"));
+    tmpDirs.push(dir);
+    const filePath = join(dir, "vercel.json");
+    await writeFile(filePath, JSON.stringify(content));
+    return filePath;
+  }
+
+  afterEach(async () => {
+    for (const dir of tmpDirs) {
+      await rm(dir, { recursive: true, force: true });
+    }
+    tmpDirs.length = 0;
+  });
+
+  it("parses valid vercel.json with a single cron", async () => {
+    const path = await writeTempVercelJson({
+      crons: [{ path: "/api/test", schedule: "0 7 * * *" }],
+    });
+    const crons = await loadCrons(path);
+    expect(crons).toEqual([{ path: "/api/test", schedule: "0 7 * * *" }]);
+  });
+
+  it("parses valid vercel.json with multiple crons", async () => {
+    const path = await writeTempVercelJson({
+      crons: [
+        { path: "/api/one", schedule: "0 7 * * *" },
+        { path: "/api/two", schedule: "*/5 * * * *" },
+      ],
+    });
+    const crons = await loadCrons(path);
+    expect(crons).toHaveLength(2);
+    expect(crons[0].path).toBe("/api/one");
+    expect(crons[1].path).toBe("/api/two");
+  });
+
+  it("throws when file does not exist", async () => {
+    await expect(loadCrons("/tmp/nonexistent/vercel.json")).rejects.toThrow();
+  });
+
+  it("throws when no crons array", async () => {
+    const path = await writeTempVercelJson({ builds: [] });
+    await expect(loadCrons(path)).rejects.toThrow('No "crons" array');
+  });
+
+  it("throws when crons is empty", async () => {
+    const path = await writeTempVercelJson({ crons: [] });
+    await expect(loadCrons(path)).rejects.toThrow("empty");
+  });
+
+  it("throws when entry missing path", async () => {
+    const path = await writeTempVercelJson({
+      crons: [{ schedule: "0 7 * * *" }],
+    });
+    await expect(loadCrons(path)).rejects.toThrow('missing "path"');
+  });
+
+  it("throws when entry missing schedule", async () => {
+    const path = await writeTempVercelJson({
+      crons: [{ path: "/api/test" }],
+    });
+    await expect(loadCrons(path)).rejects.toThrow('missing "schedule"');
+  });
+});

package/src/config.ts

@@ -0,0 +1,43 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+
+export interface CronEntry {
+  path: string;
+  schedule: string;
+}
+
+interface VercelJson {
+  crons?: CronEntry[];
+}
+
+export async function loadCrons(
+  vercelJsonPath?: string
+): Promise<CronEntry[]> {
+  const filePath = resolve(vercelJsonPath ?? "./vercel.json");
+  const raw = await readFile(filePath, "utf-8");
+  const parsed: VercelJson = JSON.parse(raw);
+
+  if (!parsed.crons || !Array.isArray(parsed.crons)) {
+    throw new Error(`No "crons" array found in ${filePath}`);
+  }
+
+  const crons: CronEntry[] = [];
+
+  for (const entry of parsed.crons) {
+    if (!entry.path || typeof entry.path !== "string") {
+      throw new Error(`Invalid cron entry: missing "path"`);
+    }
+    if (!entry.schedule || typeof entry.schedule !== "string") {
+      throw new Error(
+        `Invalid cron entry for ${entry.path}: missing "schedule"`
+      );
+    }
+    crons.push({ path: entry.path, schedule: entry.schedule });
+  }
+
+  if (crons.length === 0) {
+    throw new Error(`"crons" array is empty in ${filePath}`);
+  }
+
+  return crons;
+}

package/src/executor.test.ts

@@ -0,0 +1,72 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { executeCron } from "./executor.js";
+
+describe("executeCron", () => {
+  const originalFetch = globalThis.fetch;
+
+  beforeEach(() => {
+    vi.stubGlobal(
+      "fetch",
+      vi.fn().mockResolvedValue({
+        status: 200,
+        ok: true,
+      })
+    );
+  });
+
+  afterEach(() => {
+    globalThis.fetch = originalFetch;
+  });
+
+  it("sends GET request to correct URL", async () => {
+    await executeCron("http://localhost:3000", "/api/test");
+    expect(fetch).toHaveBeenCalledWith("http://localhost:3000/api/test", {
+      method: "GET",
+      headers: expect.objectContaining({
+        "User-Agent": "vercel-cron/1.0",
+      }),
+    });
+  });
+
+  it("includes Authorization header when cronSecret is provided", async () => {
+    await executeCron("http://localhost:3000", "/api/test", "my-secret");
+    expect(fetch).toHaveBeenCalledWith(
+      expect.any(String),
+      expect.objectContaining({
+        headers: expect.objectContaining({
+          Authorization: "Bearer my-secret",
+        }),
+      })
+    );
+  });
+
+  it("omits Authorization header when no cronSecret", async () => {
+    await executeCron("http://localhost:3000", "/api/test");
+    const call = vi.mocked(fetch).mock.calls[0];
+    const headers = (call[1] as RequestInit).headers as Record<string, string>;
+    expect(headers).not.toHaveProperty("Authorization");
+  });
+
+  it("returns path, status, ok, and durationMs", async () => {
+    const result = await executeCron("http://localhost:3000", "/api/test");
+    expect(result).toEqual({
+      path: "/api/test",
+      status: 200,
+      ok: true,
+      durationMs: expect.any(Number),
+    });
+  });
+
+  it("handles non-200 responses", async () => {
+    vi.stubGlobal(
+      "fetch",
+      vi.fn().mockResolvedValue({
+        status: 500,
+        ok: false,
+      })
+    );
+    const result = await executeCron("http://localhost:3000", "/api/test");
+    expect(result.status).toBe(500);
+    expect(result.ok).toBe(false);
+  });
+});

package/src/executor.ts

@@ -0,0 +1,37 @@
+export interface CronResult {
+  path: string;
+  status: number;
+  ok: boolean;
+  durationMs: number;
+}
+
+export async function executeCron(
+  baseUrl: string,
+  path: string,
+  cronSecret?: string
+): Promise<CronResult> {
+  const url = `${baseUrl}${path}`;
+  const headers: Record<string, string> = {
+    "User-Agent": "vercel-cron/1.0",
+  };
+
+  if (cronSecret) {
+    headers["Authorization"] = `Bearer ${cronSecret}`;
+  }
+
+  const start = performance.now();
+
+  const response = await fetch(url, {
+    method: "GET",
+    headers,
+  });
+
+  const durationMs = Math.round(performance.now() - start);
+
+  return {
+    path,
+    status: response.status,
+    ok: response.ok,
+    durationMs,
+  };
+}

package/src/index.ts

@@ -0,0 +1,35 @@
+import { loadCrons } from "./config.js";
+import { startScheduler } from "./scheduler.js";
+
+export { loadCrons } from "./config.js";
+export type { CronEntry } from "./config.js";
+export { executeCron } from "./executor.js";
+export type { CronResult } from "./executor.js";
+export { startScheduler } from "./scheduler.js";
+export type { SchedulerConfig } from "./scheduler.js";
+
+export interface RunCronsOptions {
+  url: string;
+  cronSecret?: string;
+  vercelJsonPath?: string;
+}
+
+export async function runCrons(options: RunCronsOptions) {
+  const { url, cronSecret, vercelJsonPath } = options;
+
+  const crons = await loadCrons(vercelJsonPath);
+
+  console.log(`vercel-cronjob starting...`);
+  console.log(`  URL: ${url}`);
+  console.log(`  CRON_SECRET: ${cronSecret ? "***" : "(not set)"}`);
+  console.log(`\nRegistered ${crons.length} cron(s):`);
+  for (const entry of crons) {
+    console.log(`  ${entry.schedule}  →  ${entry.path}`);
+  }
+
+  const tasks = startScheduler({ crons, baseUrl: url, cronSecret });
+
+  console.log("\nScheduler running. Waiting for triggers...\n");
+
+  return tasks;
+}

package/src/scheduler.test.ts

@@ -0,0 +1,46 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import cron from "node-cron";
+import { startScheduler } from "./scheduler.js";
+
+vi.mock("node-cron", () => ({
+  default: {
+    schedule: vi.fn(() => ({ stop: vi.fn() })),
+  },
+}));
+
+describe("startScheduler", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("registers a cron task for each entry", () => {
+    const tasks = startScheduler({
+      crons: [
+        { path: "/api/one", schedule: "0 7 * * *" },
+        { path: "/api/two", schedule: "*/5 * * * *" },
+      ],
+      baseUrl: "http://localhost:3000",
+    });
+
+    expect(cron.schedule).toHaveBeenCalledTimes(2);
+    expect(cron.schedule).toHaveBeenCalledWith(
+      "0 7 * * *",
+      expect.any(Function)
+    );
+    expect(cron.schedule).toHaveBeenCalledWith(
+      "*/5 * * * *",
+      expect.any(Function)
+    );
+    expect(tasks).toHaveLength(2);
+  });
+
+  it("returns tasks that can be stopped", () => {
+    const tasks = startScheduler({
+      crons: [{ path: "/api/test", schedule: "0 7 * * *" }],
+      baseUrl: "http://localhost:3000",
+    });
+
+    expect(tasks[0].stop).toBeDefined();
+    tasks[0].stop();
+  });
+});

package/src/scheduler.ts

@@ -0,0 +1,45 @@
+import cron from "node-cron";
+import type { CronEntry } from "./config.js";
+import { executeCron } from "./executor.js";
+
+export interface SchedulerConfig {
+  crons: CronEntry[];
+  baseUrl: string;
+  cronSecret?: string;
+}
+
+export function startScheduler(config: SchedulerConfig): cron.ScheduledTask[] {
+  const { crons, baseUrl, cronSecret } = config;
+  const tasks: cron.ScheduledTask[] = [];
+
+  for (const entry of crons) {
+    const task = cron.schedule(entry.schedule, async () => {
+      const timestamp = new Date().toISOString();
+      console.log(`[${timestamp}] Triggering ${entry.path}`);
+
+      try {
+        const result = await executeCron(baseUrl, entry.path, cronSecret);
+        console.log(
+          `[${timestamp}] ${result.path} → ${result.status} (${result.durationMs}ms)`
+        );
+      } catch (err) {
+        console.error(`[${timestamp}] ${entry.path} → FAILED:`, err);
+      }
+    });
+
+    tasks.push(task);
+  }
+
+  const shutdown = () => {
+    console.log("\nShutting down scheduler...");
+    for (const task of tasks) {
+      task.stop();
+    }
+    process.exit(0);
+  };
+
+  process.on("SIGTERM", shutdown);
+  process.on("SIGINT", shutdown);
+
+  return tasks;
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "src/**/*.test.ts"]
+}