@apisurf/ngn-core 0.2.8 → 0.3.0

package/dist/core.d.ts

@@ -607,6 +607,8 @@ interface ExecuteSchedule {
     /** When the next tick is due, epoch ms. */
     nextAt?: number | null;
 }
+/** The `task_runs.id` of the run that threw `error`, when a task run did. */
+declare function failedRunId(error: unknown): number | null;
 declare class Task {
     private taskCallbacks;
     private startRun;
@@ -703,12 +705,26 @@ declare class TaskLibrary {
 
 type Options$1 = {
     taskLibrary: TaskLibrary;
+    /** Called when a scheduled run throws, with the run it was recorded as when there is one. */
+    onRunError?: (path: string, error: unknown, runId: number | null) => void;
 };
+/** What `start()` did with each task: scheduled on its pattern, or left out and why. */
+interface ScheduleReport {
+    scheduled: {
+        path: string;
+        pattern: string;
+    }[];
+    failed: {
+        path: string;
+        reason: string;
+    }[];
+}
 declare class TaskLibraryScheduler {
     private taskLibrary;
+    private onRunError;
     private scheduledTasks;
     constructor(options: Options$1);
-    start(): Promise<void>;
+    start(): Promise<ScheduleReport>;
     stop(): Promise<void>;
     scheduleTask(task: Task): Promise<void>;
     unscheduleTask(task: Task): void;
@@ -739,4 +755,4 @@ declare function createControlsGenerator({ dbClient, env, }: {
     env: TaskContext["env"];
 }): BuildCompiledTaskConfigFn;
 
-export { type AddJob, type Backoff, type ClaimOptions, Compiler, type DBInstance, type Duration, type InitDBOptions, type Job, type JobFilter, type JobStatus, LockBusyError, type LockOptions, type Migration, type OverlapPolicy, Queue, type QueueOptions, type QueueStats, Task, type TaskContext, TaskLibrary, TaskLibraryScheduler, TaskOnceRunner, type TaskRun, type TaskSqlite, type WorkHandler, type WorkOptions, type WorkSummary, type WorkerHandle, closeTaskDatabases, createControlsGenerator, executeEsm, getDbClient, isCronPatternValid, scheduleTask, setupDbClient };
+export { type AddJob, type Backoff, type ClaimOptions, Compiler, type DBInstance, type Duration, type InitDBOptions, type Job, type JobFilter, type JobStatus, LockBusyError, type LockOptions, type Migration, type OverlapPolicy, Queue, type QueueOptions, type QueueStats, type ScheduleReport, Task, type TaskContext, TaskLibrary, TaskLibraryScheduler, TaskOnceRunner, type TaskRun, type TaskSqlite, type WorkHandler, type WorkOptions, type WorkSummary, type WorkerHandle, closeTaskDatabases, createControlsGenerator, executeEsm, failedRunId, getDbClient, isCronPatternValid, scheduleTask, setupDbClient };

package/dist/core.js

@@ -1170,6 +1170,10 @@ function breakerSkips(failedInARow, breaker) {
 
 // src/runtime/task.ts
 var sleep2 = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
+var failedRuns = /* @__PURE__ */ new WeakMap();
+function failedRunId(error) {
+  return error && typeof error === "object" ? failedRuns.get(error) ?? null : null;
+}
 var Task = class {
   taskCallbacks;
   startRun;
@@ -1304,6 +1308,7 @@ var Task = class {
       await hooks.onSuccess?.(taskContext);
       return taskReturnValue;
     } catch (err) {
+      if (err && typeof err === "object") failedRuns.set(err, run.id);
       await run.callbacks.onFailure?.({ path });
       await hooks.onError?.(err, taskContext);
       throw err;
@@ -1553,23 +1558,30 @@ function scheduleTask(task, pattern, onError) {
 // src/runtime/taskLibraryScheduler.ts
 var TaskLibraryScheduler = class {
   taskLibrary;
+  onRunError;
   scheduledTasks = /* @__PURE__ */ new Map();
   constructor(options) {
     this.taskLibrary = options.taskLibrary;
+    this.onRunError = options.onRunError;
   }
   async start() {
     logTaskLibraryScheduler("Starting scheduler");
+    const report = { scheduled: [], failed: [] };
     const scheduledTasks = this.taskLibrary.getTasks().map(async (task) => {
       try {
-        const res = await this.scheduleTask(task);
-        return res;
+        await this.scheduleTask(task);
+        report.scheduled.push({ path: task.taskPath, pattern: task.timingPattern ?? "" });
       } catch (error) {
         logTaskLibrarySchedulerError(`Error scheduling task: ${task.taskPath}`);
         logTaskLibrarySchedulerError(error);
+        report.failed.push({ path: task.taskPath, reason: reasonOf(error, task.taskPath) });
       }
     });
     await Promise.all(scheduledTasks);
     logTaskLibraryScheduler("Scheduler started");
+    report.scheduled.sort(byPath);
+    report.failed.sort(byPath);
+    return report;
   }
   async stop() {
     logTaskLibraryScheduler("Stopping scheduler");
@@ -1591,6 +1603,7 @@ var TaskLibraryScheduler = class {
     const scheduledTask = scheduleTask(task, task.timingPattern, (error) => {
       logTaskLibrarySchedulerError(`Run failed: ${task.taskPath}`);
       logTaskLibrarySchedulerError(error);
+      this.onRunError?.(task.taskPath, error, failedRunId(error));
     });
     this.scheduledTasks.set(task.taskPath, scheduledTask);
     logTaskLibraryScheduler(`Scheduled: ${task.taskPath}`);
@@ -1623,6 +1636,13 @@ var TaskLibraryScheduler = class {
   //   task.stop();
   // }
 };
+function byPath(a, b) {
+  return a.path.localeCompare(b.path);
+}
+function reasonOf(error, path) {
+  const message = error instanceof Error ? error.message : String(error);
+  return message.replace(/^Invariant failed: /, "").replace(` for ${path}`, "").replace(`: ${path}`, "");
+}
 
 // src/runtime/taskOnceRunner.ts
 import invariant9 from "tiny-invariant";
@@ -2209,6 +2229,7 @@ export {
   closeTaskDatabases,
   createControlsGenerator,
   executeEsm,
+  failedRunId,
   getDbClient,
   initDbFileIfNotExists,
   isCronPatternValid,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apisurf/ngn-core",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "description": "ngn runtime: task compilation, scheduling and the run/log/timing services.",
   "type": "module",
   "author": "Luka Vidakovic",
@@ -38,9 +38,9 @@
     "esbuild": "^0.27.1",
     "tiny-invariant": "^1.3.3",
     "zod": "^3.24.2",
-    "@apisurf/ngn-os": "0.2.8",
-    "@apisurf/ngn-persistence": "0.2.8",
-    "@apisurf/ngn-schema": "0.2.8"
+    "@apisurf/ngn-os": "0.3.0",
+    "@apisurf/ngn-persistence": "0.3.0",
+    "@apisurf/ngn-schema": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^22.8.1",