feat: add resolve method for async computed

Author: Varixo

packages/docs/src/routes/api/qwik/api.json

@@ -244,7 +244,7 @@
         }
       ],
       "kind": "Interface",
-      "content": "```typescript\nexport interface AsyncComputedReadonlySignal<T = unknown> extends ComputedSignal<T> \n```\n**Extends:** [ComputedSignal](#computedsignal)<!-- -->&lt;T&gt;\n\n\n<table><thead><tr><th>\n\nProperty\n\n\n</th><th>\n\nModifiers\n\n\n</th><th>\n\nType\n\n\n</th><th>\n\nDescription\n\n\n</th></tr></thead>\n<tbody><tr><td>\n\n[error](#)\n\n\n</td><td>\n\n\n</td><td>\n\nError \\| null\n\n\n</td><td>\n\nThe error that occurred while computing the signal.\n\n\n</td></tr>\n<tr><td>\n\n[loading](#)\n\n\n</td><td>\n\n\n</td><td>\n\nboolean\n\n\n</td><td>\n\nWhether the signal is currently loading.\n\n\n</td></tr>\n</tbody></table>",
+      "content": "```typescript\nexport interface AsyncComputedReadonlySignal<T = unknown> extends ComputedSignal<T> \n```\n**Extends:** [ComputedSignal](#computedsignal)<!-- -->&lt;T&gt;\n\n\n<table><thead><tr><th>\n\nProperty\n\n\n</th><th>\n\nModifiers\n\n\n</th><th>\n\nType\n\n\n</th><th>\n\nDescription\n\n\n</th></tr></thead>\n<tbody><tr><td>\n\n[error](#)\n\n\n</td><td>\n\n\n</td><td>\n\nError \\| null\n\n\n</td><td>\n\nThe error that occurred while computing the signal.\n\n\n</td></tr>\n<tr><td>\n\n[loading](#)\n\n\n</td><td>\n\n\n</td><td>\n\nboolean\n\n\n</td><td>\n\nWhether the signal is currently loading.\n\n\n</td></tr>\n</tbody></table>\n\n\n<table><thead><tr><th>\n\nMethod\n\n\n</th><th>\n\nDescription\n\n\n</th></tr></thead>\n<tbody><tr><td>\n\n[resolve()](#asynccomputedreadonlysignal-resolve)\n\n\n</td><td>\n\n\n</td></tr>\n</tbody></table>",
       "editUrl": "https://github.com/QwikDev/qwik/tree/main/packages/qwik/src/core/reactive-primitives/signal.public.ts",
       "mdFile": "core.asynccomputedreadonlysignal.md"
     },
@@ -1745,6 +1745,23 @@
       "editUrl": "https://github.com/QwikDev/qwik/tree/main/packages/qwik/src/core/ssr/ssr-types.ts",
       "mdFile": "core.renderssroptions.md"
     },
+    {
+      "name": "resolve",
+      "id": "asynccomputedreadonlysignal-resolve",
+      "hierarchy": [
+        {
+          "name": "AsyncComputedReadonlySignal",
+          "id": "asynccomputedreadonlysignal-resolve"
+        },
+        {
+          "name": "resolve",
+          "id": "asynccomputedreadonlysignal-resolve"
+        }
+      ],
+      "kind": "MethodSignature",
+      "content": "```typescript\nresolve(): Promise<void>;\n```\n**Returns:**\n\nPromise&lt;void&gt;",
+      "mdFile": "core.asynccomputedreadonlysignal.resolve.md"
+    },
     {
       "name": "Resource",
       "id": "resource",

packages/docs/src/routes/api/qwik/index.mdx

@@ -185,6 +185,24 @@ Whether the signal is currently loading.
 </td></tr>
 </tbody></table>
 
+<table><thead><tr><th>
+
+Method
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[resolve()](#asynccomputedreadonlysignal-resolve)
+
+</td><td>
+
+</td></tr>
+</tbody></table>
+
 [Edit this section](https://github.com/QwikDev/qwik/tree/main/packages/qwik/src/core/reactive-primitives/signal.public.ts)
 
 ## AsyncComputedReturnType
@@ -3469,6 +3487,16 @@ StreamWriter
 
 [Edit this section](https://github.com/QwikDev/qwik/tree/main/packages/qwik/src/core/ssr/ssr-types.ts)
 
+## resolve
+
+```typescript
+resolve(): Promise<void>;
+```
+
+**Returns:**
+
+Promise&lt;void&gt;
+
 ## Resource
 
 This method works like an async memoized function that runs whenever some tracked value changes and returns some data.

packages/qwik/src/core/reactive-primitives/impl/async-computed-signal-impl.ts

@@ -1,6 +1,6 @@
 import { qwikDebugToString } from '../../debug';
 import type { Container } from '../../shared/types';
-import { isPromise } from '../../shared/utils/promises';
+import { isPromise, retryOnPromise } from '../../shared/utils/promises';
 import { cleanupFn, trackFn } from '../../use/utils/tracker';
 import type { BackRef } from '../cleanup';
 import { AsyncComputeQRL, SerializationSignalFlags, EffectSubscription } from '../types';
@@ -103,6 +103,10 @@ export class AsyncComputedSignalImpl<T>
     this.$promiseValue$ = NEEDS_COMPUTATION;
   }
 
+  async resolve(): Promise<void> {
+    await retryOnPromise(() => this.$computeIfNeeded$());
+  }
+
   $computeIfNeeded$() {
     if (!(this.$flags$ & SignalFlags.INVALID)) {
       return;

packages/qwik/src/core/reactive-primitives/signal.public.ts

@@ -21,6 +21,7 @@ export interface AsyncComputedReadonlySignal<T = unknown> extends ComputedSignal
   loading: boolean;
   /** The error that occurred while computing the signal. */
   error: Error | null;
+  resolve(): Promise<void>;
 }
 
 /**

packages/qwik/src/core/tests/use-async-computed.spec.tsx

@@ -216,4 +216,26 @@ describe.each([
       );
     });
   });
+
+  describe('resolve', () => {
+    it('should not rerun if resolve is used before', async () => {
+      (globalThis as any).log = [];
+      const Counter = component$(() => {
+        const count = useSignal(1);
+        const doubleCount = useAsyncComputed$(() => Promise.resolve(count.value * 2));
+
+        useTask$(async () => {
+          await doubleCount.resolve();
+          (globalThis as any).log.push('task');
+          (globalThis as any).log.push(doubleCount.value);
+        });
+
+        return <div></div>;
+      });
+      await render(<Counter />, { debug });
+      expect((globalThis as any).log).toEqual(['task', 2]);
+
+      (globalThis as any).log = undefined;
+    });
+  });
 });