Add control for handling AsyncAction.value in error and revalidatio…

…n scenarios

.changeset/afraid-lions-nail.md

@@ -0,0 +1,5 @@
+---
+'@quilted/async': patch
+---
+
+Add control for handling `AsyncAction.value` in error and revalidation scenarios

packages/async/source/AsyncAction.ts

@@ -28,7 +28,19 @@ export class AsyncAction<Data = unknown, Input = unknown> {
   }
 
   get value() {
-    return this.latest?.value ?? this.resolved?.value;
+    const running = this.running;
+    const runningValue = running?.value;
+    if (runningValue !== undefined) return runningValue;
+
+    if (!this.#staleWhileRevalidate && running) {
+      return undefined;
+    }
+
+    if (!this.#staleIfError && this.finished?.error) {
+      return undefined;
+    }
+
+    return this.resolved?.value;
   }
 
   get data() {
@@ -108,18 +120,25 @@ export class AsyncAction<Data = unknown, Input = unknown> {
     lastInput?: Input,
   ) => boolean;
 
+  readonly #staleIfError: boolean;
+  readonly #staleWhileRevalidate: boolean;
+
   constructor(
     fetchFunction: AsyncActionFunction<Data, Input>,
     {
       cached,
       hasChanged = defaultHasChanged,
+      staleIfError = true,
+      staleWhileRevalidate = true,
     }: {
       cached?: AsyncActionRunCache<Data, Input>;
       hasChanged?(
         this: AsyncAction<Data, Input>,
         input?: Input,
         lastInput?: Input,
       ): boolean;
+      staleIfError?: boolean;
+      staleWhileRevalidate?: boolean;
     } = {},
   ) {
     this.function = fetchFunction;
@@ -128,6 +147,8 @@ export class AsyncAction<Data = unknown, Input = unknown> {
       finally: this.#finalizeAction,
     });
     this.#hasChanged = hasChanged;
+    this.#staleIfError = staleIfError;
+    this.#staleWhileRevalidate = staleWhileRevalidate;
   }
 
   run = (