@tmlmobilidade/utils 20260226.1419.7 → 20260302.1416.42

package/README.md

@@ -65,7 +65,7 @@ Permission checking utilities for role-based access control.
 
 Utility for creating proxies around async singleton classes.
 
-- **`AsyncSingletonProxy`** - Creates a proxy that delays method access until singleton instance is initialized
+- **`asyncSingletonProxy`** - Creates a proxy that delays method access until singleton instance is initialized
 
 ### Query Validation
 
@@ -211,7 +211,7 @@ const params = validateQueryParams(req.query, schema);
 ### Singleton Proxy
 
 ```typescript
-import { AsyncSingletonProxy } from '@tmlmobilidade/utils';
+import { asyncSingletonProxy } from '@tmlmobilidade/utils';
 
 class Database {
   private static instance: Database | null = null;
@@ -229,7 +229,7 @@ class Database {
 }
 
 // Create proxy that handles async initialization
-const db = AsyncSingletonProxy(Database);
+const db = asyncSingletonProxy(Database);
 await db.query('SELECT * FROM users'); // Automatically waits for initialization
 ```
 

package/dist/index.d.ts

@@ -4,5 +4,6 @@ export * from './generic/index.js';
 export * from './http.js';
 export * from './objects/index.js';
 export * from './permissions.js';
+export * from './run-on-interval.js';
 export * from './singleton-proxy.js';
 export * from './validate-query-params.js';

package/dist/index.js

@@ -4,5 +4,6 @@ export * from './generic/index.js';
 export * from './http.js';
 export * from './objects/index.js';
 export * from './permissions.js';
+export * from './run-on-interval.js';
 export * from './singleton-proxy.js';
 export * from './validate-query-params.js';

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

@@ -0,0 +1,6 @@
+/**
+ * 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.
+ */
+export declare function runOnInterval(fn: () => Promise<void>, intervalMs: number): () => void;

package/dist/run-on-interval.js

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ */
+export function runOnInterval(fn, intervalMs) {
+    let intervalId = null;
+    const execute = () => fn().catch((error) => {
+        console.error('[runOnInterval] Unhandled error in scheduled function:', error);
+    });
+    // Await the first run before starting the interval so startup errors surface
+    void execute().then(() => {
+        intervalId = setInterval(() => void execute(), intervalMs);
+    });
+    // Return a cleanup function to cancel scheduling
+    return () => {
+        if (intervalId !== null)
+            clearInterval(intervalId);
+    };
+}

package/dist/singleton-proxy.d.ts

@@ -3,6 +3,6 @@
  * @param cls - A class with a static `getInstance` method that returns a promise resolving to the class instance.
  * @returns A proxy object that intercepts method calls and ensures the instance is initialized before invoking them.
  */
-export declare function AsyncSingletonProxy<T extends object>(cls: {
+export declare function asyncSingletonProxy<T extends object>(cls: {
     getInstance: () => Promise<T>;
 }): T;

package/dist/singleton-proxy.js

@@ -3,7 +3,7 @@
  * @param cls - A class with a static `getInstance` method that returns a promise resolving to the class instance.
  * @returns A proxy object that intercepts method calls and ensures the instance is initialized before invoking them.
  */
-export function AsyncSingletonProxy(cls) {
+export function asyncSingletonProxy(cls) {
     return new Proxy({}, {
         get: function (_target, prop, receiver) {
             return async (...args) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/utils",
-	"version": "20260226.1419.7",
+	"version": "20260302.1416.42",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"