@elliemae/pui-app-sdk 5.18.1 → 5.19.0

package/dist/cjs/utils/decorators/functionDecorators.js

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var functionDecorators_exports = {};
 __export(functionDecorators_exports, {
+  AsyncSingleExecution: () => AsyncSingleExecution,
   CacheUntilResolved: () => CacheUntilResolved,
   Debounce: () => Debounce,
   ImmutableArgs: () => ImmutableArgs,
@@ -156,3 +157,22 @@ function Throttle(delay = 300) {
     return descriptor;
   };
 }
+function AsyncSingleExecution(_target, _propertyKey, descriptor) {
+  const originalMethod = descriptor.value;
+  const promiseMap = /* @__PURE__ */ new Map();
+  descriptor.value = function(...args) {
+    const key = JSON.stringify(args);
+    if (promiseMap.has(key)) {
+      return promiseMap.get(key);
+    }
+    const promise = originalMethod.apply(this, args);
+    if (promise instanceof Promise) {
+      promiseMap.set(key, promise);
+      promise.finally(() => {
+        promiseMap.delete(key);
+      });
+    }
+    return promise;
+  };
+  return descriptor;
+}

package/dist/cjs/utils/window.js

@@ -43,7 +43,7 @@ const getViewportSize = () => ({
     window.innerHeight || 0
   )
 });
-const convertBreakpointToNumber = (breakpoint) => Number(breakpoint.replace("px", ""));
+const convertBreakpointToNumber = (breakpoint) => Number(breakpoint?.replace("px", ""));
 const getCurrentBreakpoint = () => {
   const { width } = getViewportSize();
   const { breakpoints } = (0, import_pui_theme.getDefaultTheme)();

package/dist/esm/utils/decorators/functionDecorators.js

@@ -127,7 +127,27 @@ function Throttle(delay = 300) {
     return descriptor;
   };
 }
+function AsyncSingleExecution(_target, _propertyKey, descriptor) {
+  const originalMethod = descriptor.value;
+  const promiseMap = /* @__PURE__ */ new Map();
+  descriptor.value = function(...args) {
+    const key = JSON.stringify(args);
+    if (promiseMap.has(key)) {
+      return promiseMap.get(key);
+    }
+    const promise = originalMethod.apply(this, args);
+    if (promise instanceof Promise) {
+      promiseMap.set(key, promise);
+      promise.finally(() => {
+        promiseMap.delete(key);
+      });
+    }
+    return promise;
+  };
+  return descriptor;
+}
 export {
+  AsyncSingleExecution,
   CacheUntilResolved,
   Debounce,
   ImmutableArgs,

package/dist/esm/utils/window.js

@@ -17,7 +17,7 @@ const getViewportSize = () => ({
     window.innerHeight || 0
   )
 });
-const convertBreakpointToNumber = (breakpoint) => Number(breakpoint.replace("px", ""));
+const convertBreakpointToNumber = (breakpoint) => Number(breakpoint?.replace("px", ""));
 const getCurrentBreakpoint = () => {
   const { width } = getViewportSize();
   const { breakpoints } = getDefaultTheme();

package/dist/types/lib/utils/decorators/functionDecorators.d.ts

@@ -99,3 +99,35 @@ export declare function QueueTask(_target: unknown, _key: string, descriptor: Pr
  * }
  */
 export declare function Throttle(delay?: number): (_target: any, _propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * AsyncSingleExecution decorator ensures that multiple concurrent calls to an async function
+ * with the same arguments will return the same promise instance until it resolves.
+ * Once resolved, subsequent calls will trigger a new execution.
+ * @param _target
+ * @param _propertyKey
+ * @param descriptor
+ * @returns {Function} A function that modifies the property descriptor.
+ * @example
+ * ```typescript
+ * import { AsyncSingleExecution } from './functionDecorators';
+ *
+ * class Example {
+ *   @AsyncSingleExecution
+ *   async fetchData(id: number) {
+ *     console.log('Fetching data for', id);
+ *     return new Promise(resolve => setTimeout(() => resolve(id), 1000));
+ *   }
+ * }
+ *
+ * const instance = new Example();
+ * const promise1 = instance.fetchData(1);
+ * const promise2 = instance.fetchData(1);
+ *
+ * console.log(promise1 === promise2); // true
+ * ```
+ *
+ * // Output:
+ * // Fetching data for 1 (only logged once)
+ * ```
+ */
+export declare function AsyncSingleExecution(_target: any, _propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor;