@tmlmobilidade/utils 20260411.1248.30 → 20260418.1237.24

package/dist/run-on-interval.d.ts

@@ -1,6 +1,21 @@
+import { type TimeSlot } from '@tmlmobilidade/dates';
+interface RunOnIntervalOptions {
+    /**
+     * Interval in milliseconds between the end of one invocation
+     * and the start of the next. The first invocation happens immediately.
+     * @required
+     */
+    intervalMs: number | TimeSlot;
+    /**
+     * Whether to throw errors after logging them.
+     * If true, errors are logged and then re-thrown, stopping code execution.
+     * @default false
+     */
+    throwOnError?: boolean;
+}
 /**
- * Runs a function immediately, then repeatedly on a fixed interval.
- * Errors are caught and logged per-invocation — they do not halt scheduling.
- * Each invocation is fire-and-forget after the first awaited call.
+ * Runs an asynchronous function at regular intervals, ensuring that each invocation
+ * completes before the next one starts. Errors are logged and can optionally be re-thrown.
  */
-export declare function runOnInterval(fn: () => Promise<void>, intervalMs: number): Promise<void>;
+export declare function runOnInterval(fn: () => Promise<void>, options: RunOnIntervalOptions): Promise<void>;
+export {};

package/dist/run-on-interval.js

@@ -1,16 +1,32 @@
+/* * */
+import { TimeSlotMap } from '@tmlmobilidade/dates';
 /**
- * Runs a function immediately, then repeatedly on a fixed interval.
- * Errors are caught and logged per-invocation — they do not halt scheduling.
- * Each invocation is fire-and-forget after the first awaited call.
+ * Runs an asynchronous function at regular intervals, ensuring that each invocation
+ * completes before the next one starts. Errors are logged and can optionally be re-thrown.
  */
-export async function runOnInterval(fn, intervalMs) {
+export async function runOnInterval(fn, options) {
     //
+    //
+    // Validate and determine the interval in milliseconds,
+    // or throw an error if the provided interval is invalid.
+    let intervalMs;
+    if (typeof options.intervalMs === 'number')
+        intervalMs = options.intervalMs;
+    else if (!TimeSlotMap[options.intervalMs])
+        throw new Error(`Invalid TimeSlot: ${options.intervalMs}`);
+    else
+        intervalMs = TimeSlotMap[options.intervalMs];
+    //
+    // Define the runner function that will execute
+    // the provided function and schedule the next execution.
     const runner = async () => {
         try {
             await fn();
         }
         catch (error) {
             console.error('Error in runOnInterval:', error);
+            if (options.throwOnError)
+                throw error;
         }
         finally {
             setTimeout(runner, intervalMs);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/utils",
-	"version": "20260411.1248.30",
+	"version": "20260418.1237.24",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"
@@ -47,7 +47,7 @@
 	},
 	"devDependencies": {
 		"@tmlmobilidade/tsconfig": "*",
-		"@types/node": "25.5.2",
+		"@types/node": "25.6.0",
 		"resolve-tspaths": "0.8.23",
 		"tsc-watch": "7.2.0",
 		"typescript": "5.9.3"