legonode 0.0.1

package/dist/src/router/router.js

@@ -0,0 +1,158 @@
+import { dirname, relative, resolve } from "node:path";
+import { getRadixTreeForMethod, getRouteTable, addRouteFileToTable } from "./routeTable.js";
+import { loadRoute } from "./routeLoader.js";
+const routeCache = new Map();
+/** Cached resolved route for static routes (no params). */
+const staticResolvedCache = new Map();
+function routeCacheKey(appDir, filePath, method) {
+    return `${appDir}\0${filePath}\0${method}`;
+}
+function isPromise(v) {
+    return typeof v?.then === "function";
+}
+function getMiddlewarePathFromFile(appDir, filePath) {
+    const routerBase = resolve(appDir, "router");
+    const routeDir = dirname(resolve(filePath));
+    const rel = relative(routerBase, routeDir).replace(/\\/g, "/");
+    if (!rel || rel === ".")
+        return "/";
+    return "/" + rel;
+}
+/**
+ * Resolve route using per-method radix tree (find-my-way style): one tree per HTTP method,
+ * direct filePath from match, no method map lookup.
+ */
+export function resolveRoute(method, pathname, appDir) {
+    const tree = getRadixTreeForMethod(appDir, method);
+    const match = tree.match(pathname);
+    if (!match)
+        return null;
+    const key = routeCacheKey(appDir, match.filePath, method);
+    const middlewarePath = getMiddlewarePathFromFile(appDir, match.filePath);
+    const cached = routeCache.get(key);
+    if (cached !== undefined && !isPromise(cached)) {
+        if (!cached)
+            return null;
+        const paramCount = Object.keys(match.params).length;
+        if (paramCount === 0) {
+            let resolved = staticResolvedCache.get(key);
+            if (!resolved) {
+                resolved = {
+                    route: cached,
+                    params: Object.create(null),
+                    middlewarePath
+                };
+                staticResolvedCache.set(key, resolved);
+            }
+            return resolved;
+        }
+        return { route: cached, params: match.params, middlewarePath };
+    }
+    let loadPromise;
+    if (cached !== undefined && isPromise(cached)) {
+        loadPromise = cached;
+    }
+    else {
+        loadPromise = loadRoute(match.filePath, method, match.routeId);
+        routeCache.set(key, loadPromise);
+    }
+    return loadPromise.then((loaded) => {
+        routeCache.set(key, loaded);
+        if (!loaded)
+            return null;
+        return { route: loaded, params: match.params, middlewarePath };
+    });
+}
+/** Preload all routes and warm per-method radix trees so resolveRoute is sync. */
+export async function preloadRoutes(appDir) {
+    const table = getRouteTable(appDir);
+    const byPath = new Map();
+    const methodsToWarm = new Set();
+    for (const r of table) {
+        let fileByMethod = byPath.get(r.pathname);
+        if (!fileByMethod) {
+            fileByMethod = {};
+            byPath.set(r.pathname, fileByMethod);
+        }
+        const m = r.method ?? "";
+        fileByMethod[m] = r.filePath;
+        if (m)
+            methodsToWarm.add(m);
+        else {
+            methodsToWarm.add("");
+            methodsToWarm.add("GET");
+            methodsToWarm.add("POST");
+            methodsToWarm.add("PUT");
+            methodsToWarm.add("PATCH");
+            methodsToWarm.add("DELETE");
+            methodsToWarm.add("HEAD");
+            methodsToWarm.add("OPTIONS");
+        }
+    }
+    const promises = [];
+    for (const [pathname, fileByMethod] of byPath) {
+        for (const [method, filePath] of Object.entries(fileByMethod)) {
+            // route.ts (method "") exports GET, POST, etc. per method — only cache under "" so we load with the real HTTP method on first request
+            const keys = method === "" ? [""] : [method];
+            const key = routeCacheKey(appDir, filePath, keys[0]);
+            if (routeCache.has(key))
+                continue;
+            const p = loadRoute(filePath, method, pathname);
+            for (const m of keys)
+                routeCache.set(routeCacheKey(appDir, filePath, m), p);
+            promises.push(p.then((loaded) => {
+                for (const m of keys)
+                    routeCache.set(routeCacheKey(appDir, filePath, m), loaded);
+            }));
+        }
+    }
+    await Promise.all(promises);
+    for (const method of methodsToWarm) {
+        getRadixTreeForMethod(appDir, method);
+    }
+}
+const ALL_METHODS = ["", "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
+/** Reload handler cache for the given route file (dev hot reload). */
+export async function reloadRoute(appDir, filePath) {
+    const table = getRouteTable(appDir);
+    const resolvedTarget = resolve(filePath);
+    const entries = table.filter((r) => resolve(r.filePath) === resolvedTarget);
+    if (entries.length === 0) {
+        // New route file not yet in the route table: add it and rebuild caches lazily.
+        addRouteFileToTable(appDir, filePath);
+        return;
+    }
+    const filePathForKey = entries[0].filePath;
+    const methodsToClear = new Set();
+    for (const r of entries) {
+        const m = r.method ?? "";
+        if (m)
+            methodsToClear.add(m);
+        else
+            ALL_METHODS.forEach((x) => methodsToClear.add(x));
+    }
+    for (const m of methodsToClear) {
+        const key = routeCacheKey(appDir, filePathForKey, m);
+        routeCache.delete(key);
+        staticResolvedCache.delete(key);
+    }
+    const promises = [];
+    const seen = new Set();
+    for (const r of entries) {
+        const method = r.method ?? "";
+        const keys = method === "" ? [""] : [method];
+        const cacheKey = routeCacheKey(appDir, filePathForKey, keys[0]);
+        if (seen.has(cacheKey))
+            continue;
+        seen.add(cacheKey);
+        const p = loadRoute(r.filePath, method, r.pathname);
+        for (const m of keys)
+            routeCache.set(routeCacheKey(appDir, filePathForKey, m), p);
+        promises.push(p.then((loaded) => {
+            for (const m of keys)
+                routeCache.set(routeCacheKey(appDir, filePathForKey, m), loaded);
+        }));
+    }
+    await Promise.all(promises);
+}
+//# sourceMappingURL=router.js.map

package/dist/src/router/router.js.map

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

package/dist/src/schedules/parseSchedule.d.ts

@@ -0,0 +1,15 @@
+import type { ScheduleDef } from "./types.js";
+/**
+ * Returns interval in ms for setInterval, or null if this is an "at" schedule (day/week/month).
+ */
+export declare function getIntervalMs(def: ScheduleDef): number | null;
+/**
+ * Returns true if this schedule runs at a specific time (day at, week day at, month date at).
+ */
+export declare function isAtSchedule(def: ScheduleDef): boolean;
+/**
+ * Get ms until the next run for "at" schedules (day at HH:MM, week day at HH:MM, month date at HH:MM).
+ * Never returns 0 so we avoid setTimeout(..., 0) and immediate re-runs.
+ */
+export declare function getNextRunMs(def: ScheduleDef): number;
+//# sourceMappingURL=parseSchedule.d.ts.map

package/dist/src/schedules/parseSchedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSchedule.d.ts","sourceRoot":"","sources":["../../../src/schedules/parseSchedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA0C9C;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAM7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAKtD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAkCrD"}

package/dist/src/schedules/parseSchedule.js

@@ -0,0 +1,111 @@
+const DAY_MS = 24 * 60 * 60 * 1000;
+const HOUR_MS = 60 * 60 * 1000;
+const MINUTE_MS = 60 * 1000;
+const WEEKDAYS = {
+    sunday: 0,
+    monday: 1,
+    tuesday: 2,
+    wednesday: 3,
+    thursday: 4,
+    friday: 5,
+    saturday: 6
+};
+function parseTime(at) {
+    const match = /^(\d{1,2}):(\d{2})$/.exec(at.trim());
+    if (!match)
+        return { hours: 0, minutes: 0 };
+    return {
+        hours: Math.min(23, Math.max(0, parseInt(match[1], 10))),
+        minutes: Math.min(59, Math.max(0, parseInt(match[2], 10)))
+    };
+}
+/** Parse interval string like "5m", "10s", "1h" to ms. */
+function parseIntervalEvery(every) {
+    const s = every.trim().toLowerCase();
+    const match = /^(\d+)\s*(s|sec|m|min|h|hr|d|day)s?$/.exec(s);
+    if (match) {
+        const n = parseInt(match[1], 10);
+        const unit = match[2];
+        if (unit === "s" || unit === "sec")
+            return n * 1000;
+        if (unit === "m" || unit === "min")
+            return n * MINUTE_MS;
+        if (unit === "h" || unit === "hr")
+            return n * HOUR_MS;
+        if (unit === "d" || unit === "day")
+            return n * DAY_MS;
+    }
+    if (s === "minute" || s === "1m")
+        return MINUTE_MS;
+    if (s === "hour" || s === "1h")
+        return HOUR_MS;
+    return null;
+}
+/**
+ * Returns interval in ms for setInterval, or null if this is an "at" schedule (day/week/month).
+ */
+export function getIntervalMs(def) {
+    if (def.every === "minute")
+        return MINUTE_MS;
+    if (def.every === "hour")
+        return HOUR_MS;
+    const interval = parseIntervalEvery(def.every);
+    if (interval !== null)
+        return interval;
+    return null;
+}
+/**
+ * Returns true if this schedule runs at a specific time (day at, week day at, month date at).
+ */
+export function isAtSchedule(def) {
+    if (def.every === "day" && "at" in def)
+        return true;
+    if (def.every === "week")
+        return true;
+    if (def.every === "month")
+        return true;
+    return false;
+}
+/**
+ * Get ms until the next run for "at" schedules (day at HH:MM, week day at HH:MM, month date at HH:MM).
+ * Never returns 0 so we avoid setTimeout(..., 0) and immediate re-runs.
+ */
+export function getNextRunMs(def) {
+    const now = new Date();
+    const at = "at" in def && typeof def.at === "string" ? def.at : "00:00";
+    const { hours, minutes } = parseTime(at);
+    let ms;
+    if (def.every === "day") {
+        let next = new Date(now);
+        next.setHours(hours, minutes, 0, 0);
+        if (next.getTime() <= now.getTime())
+            next = new Date(next.getTime() + DAY_MS);
+        ms = next.getTime() - now.getTime();
+    }
+    else if (def.every === "week") {
+        const dayName = def.day ?? "monday";
+        const targetDay = WEEKDAYS[dayName.toLowerCase()] ?? 1;
+        let next = new Date(now);
+        next.setHours(hours, minutes, 0, 0);
+        let diff = targetDay - next.getDay();
+        if (diff < 0)
+            diff += 7;
+        else if (diff === 0 && next.getTime() <= now.getTime())
+            diff = 7;
+        next = new Date(next.getTime() + diff * DAY_MS);
+        ms = next.getTime() - now.getTime();
+    }
+    else if (def.every === "month") {
+        const date = def.date ?? 1;
+        let next = new Date(now.getFullYear(), now.getMonth(), date, hours, minutes, 0, 0);
+        if (next.getTime() <= now.getTime()) {
+            next = new Date(now.getFullYear(), now.getMonth() + 1, date, hours, minutes, 0, 0);
+        }
+        ms = next.getTime() - now.getTime();
+    }
+    else {
+        ms = DAY_MS;
+    }
+    return Math.max(1, ms);
+}
+//# sourceMappingURL=parseSchedule.js.map

package/dist/src/schedules/parseSchedule.js.map

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

package/dist/src/schedules/runScheduler.d.ts

@@ -0,0 +1,14 @@
+import type { LoadedTask, TaskContext } from "./types.js";
+export type RunSchedulerOptions = {
+    ctx?: TaskContext;
+    onRun?: (taskName: string, ctx: TaskContext) => void | Promise<void>;
+    onComplete?: (taskName: string, ctx: TaskContext) => void | Promise<void>;
+    onError?: (taskName: string, err: unknown) => void;
+};
+/**
+ * Start the scheduler for the given tasks. Uses setInterval for interval-based schedules
+ * and setTimeout for "at" schedules (day/week/month), then reschedules.
+ * Does not return; call from a long-running process.
+ */
+export declare function runScheduler(tasks: LoadedTask[], options?: RunSchedulerOptions): () => void;
+//# sourceMappingURL=runScheduler.d.ts.map

package/dist/src/schedules/runScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runScheduler.d.ts","sourceRoot":"","sources":["../../../src/schedules/runScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1D,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,IAAI,CAiD/F"}

package/dist/src/schedules/runScheduler.js

@@ -0,0 +1,58 @@
+import { getIntervalMs, isAtSchedule, getNextRunMs } from "./parseSchedule.js";
+/**
+ * Start the scheduler for the given tasks. Uses setInterval for interval-based schedules
+ * and setTimeout for "at" schedules (day/week/month), then reschedules.
+ * Does not return; call from a long-running process.
+ */
+export function runScheduler(tasks, options = {}) {
+    const ctx = options.ctx ?? {};
+    const onRun = options.onRun ?? null;
+    const onComplete = options.onComplete ?? null;
+    const onError = options.onError ?? ((name, err) => console.error(`[legonode task ${name}]`, err));
+    const timeouts = [];
+    const intervals = [];
+    function runTask(task) {
+        void (async () => {
+            try {
+                if (onRun)
+                    await onRun(task.name, ctx);
+                await task.run(ctx);
+                if (onComplete)
+                    await onComplete(task.name, ctx);
+            }
+            catch (err) {
+                onError(task.name, err);
+            }
+        })();
+    }
+    function scheduleAt(task, def) {
+        // Use at least 1s delay so we don't reschedule in the same second and risk multiple runs (e.g. hot reload).
+        const ms = Math.max(1000, getNextRunMs(def));
+        const t = setTimeout(() => {
+            runTask(task);
+            scheduleAt(task, def);
+        }, ms);
+        timeouts.push(t);
+    }
+    for (const task of tasks) {
+        for (const def of task.schedule) {
+            const intervalMs = getIntervalMs(def);
+            if (intervalMs !== null) {
+                // First run after intervalMs, then every intervalMs (no run at startup)
+                const t = setInterval(() => runTask(task), intervalMs);
+                intervals.push(t);
+                continue;
+            }
+            if (isAtSchedule(def)) {
+                scheduleAt(task, def);
+            }
+        }
+    }
+    return function stop() {
+        for (const t of timeouts)
+            clearTimeout(t);
+        for (const t of intervals)
+            clearInterval(t);
+    };
+}
+//# sourceMappingURL=runScheduler.js.map

package/dist/src/schedules/runScheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runScheduler.js","sourceRoot":"","sources":["../../../src/schedules/runScheduler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAS/E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAmB,EAAE,UAA+B,EAAE;IACjF,MAAM,GAAG,GAAgB,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;IACpC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAClG,MAAM,QAAQ,GAAoC,EAAE,CAAC;IACrD,MAAM,SAAS,GAAqC,EAAE,CAAC;IAEvD,SAAS,OAAO,CAAC,IAAgB;QAC/B,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,IAAI,KAAK;oBAAE,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACvC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACpB,IAAI,UAAU;oBAAE,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;IAED,SAAS,UAAU,CAAC,IAAgB,EAAE,GAAqC;QACzE,4GAA4G;QAC5G,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACxB,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,wEAAwE;gBACxE,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;gBACvD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,SAAS;YACX,CAAC;YACD,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,IAAI;QAClB,KAAK,MAAM,CAAC,IAAI,QAAQ;YAAE,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,SAAS;YAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/schedules/scheduleLoader.d.ts

@@ -0,0 +1,14 @@
+import type { LoadedTask } from "./types.js";
+export type ScheduleRunnerFn = (name: string, payload?: unknown) => void | Promise<void>;
+/** Build a runner that invokes a schedule's run by name (e.g. "interval.example"). */
+export declare function createScheduleRunner(tasks: LoadedTask[]): ScheduleRunnerFn;
+export declare function getOrCreateScheduleRunner(appDir: string): Promise<ScheduleRunnerFn>;
+export declare function clearScheduleRunnerCache(appDir?: string): void;
+export type ScannedSchedule = {
+    name: string;
+    filePath: string;
+};
+export declare function scanScheduleFiles(appDir: string): ScannedSchedule[];
+export declare function loadScheduleModule(filePath: string, cacheBust?: string): Promise<LoadedTask | null>;
+export declare function loadSchedulesFromApp(appDir: string, cacheBust?: string): Promise<LoadedTask[]>;
+//# sourceMappingURL=scheduleLoader.d.ts.map

package/dist/src/schedules/scheduleLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleLoader.d.ts","sourceRoot":"","sources":["../../../src/schedules/scheduleLoader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAyB,UAAU,EAA0B,MAAM,YAAY,CAAC;AAuB5F,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAIzF,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAc1E;AAED,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CASzF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAG9D;AAOD,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAoBnE;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAmB5B;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvB"}

package/dist/src/schedules/scheduleLoader.js

@@ -0,0 +1,122 @@
+import { readdirSync } from "node:fs";
+import { join, resolve, basename } from "node:path";
+import { pathToFileURL } from "node:url";
+import { invalidateModuleCache } from "../loader/moduleCache.js";
+const CRON_EXTENSIONS = [".cron.ts", ".cron.js", ".cron.mts", ".cron.mjs"];
+const CRON_DIR = "cron";
+/** Convert task name (e.g. intervalExample) to schedule name (e.g. interval.example). */
+function toScheduleName(name) {
+    if (!name.length)
+        return "";
+    const parts = [];
+    let current = name[0].toLowerCase();
+    for (let i = 1; i < name.length; i++) {
+        const c = name[i];
+        if (c >= "A" && c <= "Z") {
+            parts.push(current);
+            current = c.toLowerCase();
+        }
+        else {
+            current += c;
+        }
+    }
+    parts.push(current);
+    return parts.join(".");
+}
+const scheduleRunnerCache = new Map();
+/** Build a runner that invokes a schedule's run by name (e.g. "interval.example"). */
+export function createScheduleRunner(tasks) {
+    const byName = new Map();
+    for (const task of tasks) {
+        byName.set(toScheduleName(task.name), task);
+    }
+    return (name, payload) => {
+        const task = byName.get(name);
+        if (!task) {
+            console.warn(`[legonode] schedule not found: "${name}"`);
+            return;
+        }
+        const ctx = { payload };
+        return Promise.resolve(task.run(ctx));
+    };
+}
+export async function getOrCreateScheduleRunner(appDir) {
+    const key = resolve(appDir);
+    let runner = scheduleRunnerCache.get(key);
+    if (runner)
+        return runner;
+    const cacheBust = typeof process !== "undefined" ? process.env.LEGONODE_CRON_RELOAD_TOKEN : undefined;
+    const tasks = await loadSchedulesFromApp(appDir, cacheBust);
+    runner = createScheduleRunner(tasks);
+    scheduleRunnerCache.set(key, runner);
+    return runner;
+}
+export function clearScheduleRunnerCache(appDir) {
+    if (appDir)
+        scheduleRunnerCache.delete(resolve(appDir));
+    else
+        scheduleRunnerCache.clear();
+}
+function normalizeSchedule(schedule) {
+    if (Array.isArray(schedule))
+        return schedule;
+    return [schedule];
+}
+export function scanScheduleFiles(appDir) {
+    const base = resolve(appDir, CRON_DIR);
+    const list = [];
+    let entries;
+    try {
+        entries = readdirSync(base, { withFileTypes: true }).map((e) => ({
+            name: e.name,
+            isFile: e.isFile()
+        }));
+    }
+    catch {
+        return list;
+    }
+    for (const entry of entries) {
+        if (!entry.isFile)
+            continue;
+        const ext = CRON_EXTENSIONS.find((e) => entry.name.endsWith(e));
+        if (!ext)
+            continue;
+        const name = entry.name.slice(0, -ext.length);
+        list.push({ name, filePath: join(base, entry.name) });
+    }
+    return list;
+}
+export async function loadScheduleModule(filePath, cacheBust) {
+    try {
+        if (cacheBust)
+            invalidateModuleCache(filePath);
+        const url = pathToFileURL(filePath).href;
+        const importUrl = cacheBust ? `${url}?t=${cacheBust}` : url;
+        const mod = await import(importUrl);
+        const schedule = mod.schedule;
+        const run = mod.run;
+        if (schedule == null || typeof run !== "function")
+            return null;
+        const scheduleList = normalizeSchedule(schedule);
+        const name = (mod.name ?? basename(filePath).replace(/\.cron\.(ts|js|mts|mjs)$/i, "")) || "task";
+        return {
+            name,
+            schedule: scheduleList,
+            run: run
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export async function loadSchedulesFromApp(appDir, cacheBust) {
+    const scanned = scanScheduleFiles(appDir);
+    const tasks = [];
+    for (const { filePath } of scanned) {
+        const task = await loadScheduleModule(filePath, cacheBust);
+        if (task)
+            tasks.push(task);
+    }
+    return tasks;
+}
+//# sourceMappingURL=scheduleLoader.js.map

package/dist/src/schedules/scheduleLoader.js.map

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

package/dist/src/schedules/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * JSON-based schedule definition (no cron strings).
+ * Supports: every minute/hour, every day at, every week day at, every month date at, or interval (e.g. "5m", "10s").
+ */
+export type ScheduleDef = {
+    every: "minute";
+} | {
+    every: "hour";
+} | {
+    every: "day";
+    at?: string;
+} | {
+    every: "week";
+    day?: string;
+    at?: string;
+} | {
+    every: "month";
+    date?: number;
+    at?: string;
+} | {
+    every: string;
+};
+/** One task can have multiple schedules. */
+export type Schedule = ScheduleDef | ScheduleDef[];
+export type TaskContext = {
+    /** Reserved for app-specific services (e.g. db, reportService). */
+    services?: Record<string, unknown>;
+    /** Set when the schedule is triggered via ctx.schedule(name, payload). */
+    payload?: unknown;
+};
+export type TaskRunFn = (ctx: TaskContext) => void | Promise<void>;
+export type LoadedTask = {
+    name: string;
+    schedule: ScheduleDef[];
+    run: TaskRunFn;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/schedules/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/schedules/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,GACnB;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtB,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,WAAW,EAAE,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG;IACxB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnE,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,GAAG,EAAE,SAAS,CAAC;CAChB,CAAC"}

package/dist/src/schedules/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/schedules/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/schedules/types.ts"],"names":[],"mappings":""}

package/dist/src/server/errorHandler.d.ts

@@ -0,0 +1,4 @@
+import type { ErrorHandlerResult } from "../config/loadConfig";
+import type { LegonodeContext } from "../core/context";
+export declare function defaultErrorHandler({ logger }: LegonodeContext, err?: unknown): ErrorHandlerResult;
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/src/server/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../../src/server/errorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,wBAAgB,mBAAmB,CACjC,EAAE,MAAM,EAAE,EAAE,eAAe,EAC3B,GAAG,CAAC,EAAE,OAAO,GACZ,kBAAkB,CAQpB"}

package/dist/src/server/errorHandler.js

@@ -0,0 +1,10 @@
+export function defaultErrorHandler({ logger }, err) {
+    if (err) {
+        const message = err instanceof Error ? err.message : "Unknown error";
+        const status = err.status ?? 500;
+        logger.error(err);
+        return { status, json: { error: message } };
+    }
+    return { status: 500, json: { error: "Internal Server Error" } };
+}
+//# sourceMappingURL=errorHandler.js.map

package/dist/src/server/errorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.js","sourceRoot":"","sources":["../../../src/server/errorHandler.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB,CACjC,EAAE,MAAM,EAAmB,EAC3B,GAAa;IAEb,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,MAAM,MAAM,GAAI,GAA2B,CAAC,MAAM,IAAI,GAAG,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,CAAC;AACnE,CAAC"}