applesauce-loaders 5.0.2 → 5.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 A collection of functional loading methods to make common event loading patterns easier.
 
-[Documentation](https://hzrd149.github.io/applesauce/loaders/package.html) [typedoc](https://hzrd149.github.io/applesauce/typedoc/modules/applesauce-loaders.html)
+[Documentation](https://applesauce.build/loaders/package.html) [typedoc](https://applesauce.build/typedoc/modules/applesauce-loaders.html)
 
 ## Address Loader
 

package/dist/helpers/async-map.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Resolves multiple promises concurrently, similar to RxJS combineLatest but for async operations.
+ * Each promise races against the provided timeout. If a promise doesn't resolve within the timeout,
+ * its value will be `undefined` in the returned object.
+ *
+ * @param map - An object where each value is a Promise
+ * @param timeout - Global timeout in milliseconds for all fields. If a field doesn't resolve within this time, it will be `undefined`
+ * @returns A promise that resolves to an object with the same keys, where each value is either the resolved value or `undefined`
+ *
+ * @example
+ * ```ts
+ * const { profile, mailboxes, notes } = await loadAsyncMap(
+ *   {
+ *     profile: user.profile$.$first(),
+ *     mailboxes: user.mailboxes$.$first(1000),
+ *     notes: lastValueFrom(someObservable),
+ *   },
+ *   30 * 1000, // 30 second timeout
+ * );
+ * ```
+ */
+export declare function loadAsyncMap<T extends Record<string, Promise<any>>>(map: T, timeout: number): Promise<{
+    [K in keyof T]: Awaited<T[K]> | undefined;
+}>;

package/dist/helpers/async-map.js

@@ -0,0 +1,64 @@
+/**
+ * Resolves multiple promises concurrently, similar to RxJS combineLatest but for async operations.
+ * Each promise races against the provided timeout. If a promise doesn't resolve within the timeout,
+ * its value will be `undefined` in the returned object.
+ *
+ * @param map - An object where each value is a Promise
+ * @param timeout - Global timeout in milliseconds for all fields. If a field doesn't resolve within this time, it will be `undefined`
+ * @returns A promise that resolves to an object with the same keys, where each value is either the resolved value or `undefined`
+ *
+ * @example
+ * ```ts
+ * const { profile, mailboxes, notes } = await loadAsyncMap(
+ *   {
+ *     profile: user.profile$.$first(),
+ *     mailboxes: user.mailboxes$.$first(1000),
+ *     notes: lastValueFrom(someObservable),
+ *   },
+ *   30 * 1000, // 30 second timeout
+ * );
+ * ```
+ */
+export async function loadAsyncMap(map, timeout) {
+    // Create a timeout promise that resolves with a special marker after the timeout
+    const TIMEOUT_MARKER = Symbol("timeout");
+    const createTimeoutPromise = () => {
+        return new Promise((resolve) => {
+            setTimeout(() => resolve(TIMEOUT_MARKER), timeout);
+        });
+    };
+    // Race each promise against the timeout
+    // If the promise resolves first, use its value
+    // If the timeout happens first, use undefined
+    // If the promise rejects, catch it and return undefined
+    const entries = Object.entries(map);
+    const results = await Promise.allSettled(entries.map(async ([key, promise]) => {
+        // Wrap promise to handle rejections gracefully and prevent unhandled rejections
+        const safePromise = promise
+            .then((value) => ({ type: "resolved", value }))
+            .catch(() => ({ type: "rejected" }));
+        const result = await Promise.race([
+            safePromise,
+            createTimeoutPromise().then(() => ({ type: "timeout" })),
+        ]);
+        if (result.type === "timeout" || result.type === "rejected") {
+            return [key, undefined];
+        }
+        else {
+            return [key, result.value];
+        }
+    }));
+    // Extract values from settled results, defaulting to undefined if anything went wrong
+    const extractedResults = results.map((settled, index) => {
+        if (settled.status === "fulfilled") {
+            return settled.value;
+        }
+        else {
+            // If the outer promise somehow rejected, return undefined for that key
+            const key = entries[index][0];
+            return [key, undefined];
+        }
+    });
+    // Reconstruct the object with the same keys
+    return Object.fromEntries(extractedResults);
+}

package/dist/helpers/index.d.ts

@@ -1,6 +1,7 @@
-export * from "./dns-identity.js";
+export * from "./address-pointer.js";
+export * from "./async-map.js";
 export * from "./cache.js";
+export * from "./dns-identity.js";
 export * from "./event-pointer.js";
-export * from "./address-pointer.js";
 export * from "./loaders.js";
 export * from "./upstream.js";

package/dist/helpers/index.js

@@ -1,6 +1,7 @@
-export * from "./dns-identity.js";
+export * from "./address-pointer.js";
+export * from "./async-map.js";
 export * from "./cache.js";
+export * from "./dns-identity.js";
 export * from "./event-pointer.js";
-export * from "./address-pointer.js";
 export * from "./loaders.js";
 export * from "./upstream.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "applesauce-loaders",
-  "version": "5.0.2",
+  "version": "5.1.0",
   "description": "A collection of observable based loaders built on rx-nostr",
   "type": "module",
   "main": "dist/index.js",
@@ -52,13 +52,13 @@
     }
   },
   "dependencies": {
-    "applesauce-core": "^5.0.0",
+    "applesauce-core": "^5.1.0",
     "nanoid": "^5.0.9",
     "rxjs": "^7.8.1"
   },
   "devDependencies": {
     "@hirez_io/observer-spy": "^2.2.0",
-    "applesauce-signers": "^5.0.0",
+    "applesauce-signers": "^5.1.0",
     "rimraf": "^6.0.1",
     "typescript": "^5.8.3",
     "vitest": "^4.0.15",