@tmlmobilidade/utils 20260709.1314.12 → 20260709.1326.35

package/dist/singleton-proxy.d.ts

@@ -1,7 +1,10 @@
 /**
- * Creates a proxy for a singleton class that delays method access until the instance is initialized.
+ * Creates a recursive async proxy for a singleton class that delays method and property access until the instance is initialized.
+ * Supports nested property chains like `await proxy.core.agencies.findById(id)` by recursively wrapping each property access
+ * in a new proxy, resolving the full path only when the chain is invoked (called as a function or awaited).
+ *
  * @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.
+ * @returns A proxy object that intercepts property access and method calls, ensuring the instance is initialized before resolving.
  */
 export declare function asyncSingletonProxy<T extends object>(cls: {
     getInstance: () => Promise<T>;

package/dist/singleton-proxy.js

@@ -1,19 +1,35 @@
 /**
- * Creates a proxy for a singleton class that delays method access until the instance is initialized.
+ * Creates a recursive async proxy for a singleton class that delays method and property access until the instance is initialized.
+ * Supports nested property chains like `await proxy.core.agencies.findById(id)` by recursively wrapping each property access
+ * in a new proxy, resolving the full path only when the chain is invoked (called as a function or awaited).
+ *
  * @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.
+ * @returns A proxy object that intercepts property access and method calls, ensuring the instance is initialized before resolving.
  */
 export function asyncSingletonProxy(cls) {
-    return new Proxy({}, {
-        get: function (_target, prop, receiver) {
-            return async (...args) => {
+    function createProxy(pathSegments) {
+        const resolver = (...args) => {
+            return (async () => {
                 const instance = await cls.getInstance();
-                const targetProp = Reflect.get(instance, prop, receiver);
-                if (typeof targetProp === 'function') {
-                    return targetProp.apply(instance, args);
+                let value = instance;
+                let receiver = undefined;
+                for (const seg of pathSegments) {
+                    receiver = value;
+                    value = Reflect.get(value, seg, value);
                 }
-                return targetProp;
-            };
-        },
-    });
+                if (typeof value === 'function') {
+                    return value.apply(receiver ?? instance, args);
+                }
+                return value;
+            })();
+        };
+        return new Proxy(resolver, {
+            get(_target, prop) {
+                if (prop === 'then')
+                    return undefined;
+                return createProxy([...pathSegments, prop]);
+            },
+        });
+    }
+    return createProxy([]);
 }

package/package.json

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