react-flow-z 1.0.3 → 1.0.5

package/README.md

@@ -7,20 +7,15 @@
 ---
 
 `react-flow-z` is a **small, framework-agnostic async flow runtime**.
-
-It focuses on **how async logic runs**, not:
-- how state is stored
-- how UI renders
-- or how effects are magically managed
+It focuses on **how async logic runs**
 
 > This library is about **orchestration**, not reactivity.
 
 ---
 
 ## Why react-flow-z
-
 - Typed async execution pipeline
-- Immutable flow composition
+- Declarative flow composition
 - Abort & cancellation via `AbortController`
 - Async orchestration operators: `debounce` · `retry` · `timeout` · `switchMap` ·` parallel`...
 - Control flow: `filter` · `take` · `conditional execution`...
@@ -45,11 +40,16 @@ import { Flow } from "react-flow-z"
 
 new Flow()
   .debounce(300)
-  .switchMap(q => fetch(`/search?q=${q}`))
-  .tap(res => console.log(res))
+  .switchMap(async q => {
+    const res = await fetch(`/search?q=${q}`)
+    return res.json()
+  })
+  .tap(console.log)
   .run("hello")
 ```
 
+> Avoid mutating a shared Flow instance inside React render loops.
+
 ---
 
 ## Cancellation
@@ -104,39 +104,85 @@ useFlow(
 
 ##### searchFlow.ts
 ```ts
-import { Flow } from "react-flow-z"
+import { Flow, createFlow } from "react-flow-z";
+
+export type Post = {
+  id: number;
+  title: string;
+};
 
-export const searchFlow = new Flow()
-  .onStart(() => console.log("loading..."))
+export const searchFlow = new Flow<string, Post[]>()
   .debounce(300)
-  .filter((q: string) => q.length > 0)
-  .switchMap(async (q: string) => {
+  .filter(q => q.trim().length > 0)
+  .switchMap(async q => {
     const res = await fetch(
       `https://jsonplaceholder.typicode.com/posts?q=${q}`
-    )
-    if (!res.ok) throw new Error("network error")
-    return res.json()
-  })
-  .onDone(() => console.log("done"))
-  .onError(err => console.error(err))
+    );
+
+    if (!res.ok) throw new Error("network error");
+
+    return res.json();
+  });
 
 // searchFlow.run("r")
 // searchFlow.run("re")
 // searchFlow.run("react")
 ```
 
+##### createFlow.ts
+
+```ts
+import { Flow, createFlow } from "react-flow-z";
+export const searchFlow = createFlow<string, Post[]>()
+  .debounce(300)
+  .filter(q => q.trim().length > 0)
+  .switchMap(async q => {
+    const res = await fetch(
+      `https://jsonplaceholder.typicode.com/posts?q=${q}`
+    )
+    return res.json()
+  })
+```
+
 ##### React usage
 ```ts
+import { useEffect, useState } from "react";
+import { searchFlow, Post } from "./searchFlow";
+import "./styles.css";
+
 function SearchExample() {
-  const [q, setQ] = useState("")
-  const [posts, setPosts] = useState<any[]>([])
+  const [q, setQ] = useState("");
+  const [posts, setPosts] = useState<Post[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
 
   useEffect(() => {
+    if (!q) {
+      setPosts([]);
+      return;
+    }
+
+    setLoading(true);
+    setError(null);
+
     searchFlow
-      .tap(setPosts)
-      .catch(() => [])
       .run(q)
-  }, [q])
+      .then(result => {
+        setPosts(Array.isArray(result) ? result : []);
+      })
+      .catch(err => {
+        console.error(err);
+        setError("Something went wrong");
+        setPosts([]);
+      })
+      .finally(() => {
+        setLoading(false);
+      });
+
+    return () => {
+      searchFlow.cancel();
+    };
+  }, [q]);
 
   return (
     <>
@@ -145,13 +191,26 @@ function SearchExample() {
         onChange={e => setQ(e.target.value)}
         placeholder="Search posts..."
       />
+
+      {loading && <p>Loading...</p>}
+      {error && <p style={{ color: "red" }}>{error}</p>}
+
       <ul>
         {posts.map(p => (
           <li key={p.id}>{p.title}</li>
         ))}
       </ul>
     </>
-  )
+  );
+}
+
+export default function App() {
+  return (
+    <div className="App">
+      <h2>react-flow-z + React</h2>
+      <SearchExample />
+    </div>
+  );
 }
 
 ```
@@ -195,13 +254,13 @@ export function runSearch(q: string) {
 
 ## Compare high-level
 
-| Point                  | react-flow-z  | RxJS  | Redux-Saga | XState   | React Query |
-| ---------------------- | ------------  | ----- | ---------- | -------  | ----------- |
-| Async orchestration    | ✅            | ✅     | ✅         | 🟡       | ❌          |
-| Debounce / cancel      | ✅            | ✅     | 🟡         | 🟡       | ❌          |
-| Execution-first design | ✅            | ❌     | 🟡         | ❌       | ❌          |
-| Framework-agnostic     | ✅            | ✅     | ❌         | 🟡       | ❌          |
-| Learning curve         | ⭐ easy       | ⭐⭐⭐  | ⭐⭐       | ⭐⭐⭐    | ⭐          |
+| Point                  | react-flow-z  | RxJS  | Redux-Saga | XState   |
+| ---------------------- | ------------  | ----- | ---------- | -------  |
+| Async orchestration    | ✅            | ✅     | ✅         | 🟡       |
+| Debounce / cancel      | ✅            | ✅     | 🟡         | 🟡       |
+| Execution-first design | ✅            | ❌     | 🟡         | ❌       |
+| Framework-agnostic     | ✅            | ✅     | ❌         | 🟡       |
+| Learning curve         | ⭐ easy       | ⭐⭐⭐  | ⭐⭐       | ⭐⭐⭐    |
 
 ---
 
@@ -218,6 +277,14 @@ If you need **explicit async execution with cancel / debounce / queue** → reac
 
 ---
 
+## Flow lifecycle notes
+
+- A `Flow` instance is stateful
+- Operators like `tap`, `catch`, `onDone` mutate the instance
+- Prefer: configuring the flow once, handling React state outside the flow
+
+---
+
 ## License
 
 MIT

package/build/flow-system/Flow.d.ts

@@ -7,6 +7,7 @@ export type TypedFlow<I, O, Context> = Flow<Context> & {
     tap(fn: (v: O, context: Context) => void): TypedFlow<I, O, Context>;
     filter(cond: Condition<O>): TypedFlow<I, O, Context>;
     debounce(ms: number): TypedFlow<I, O, Context>;
+    delay(ms: number): TypedFlow<I, O, Context>;
     throttle(ms: number): TypedFlow<I, O, Context>;
     leading(ms: number): TypedFlow<I, O, Context>;
     map<N>(fn: (v: O, context: Context) => N): TypedFlow<I, N, Context>;
@@ -23,6 +24,7 @@ export type TypedFlow<I, O, Context> = Flow<Context> & {
         max?: number;
     }): TypedFlow<I, O, Context>;
     timeout(ms: number): TypedFlow<I, O, Context>;
+    tapError(fn: (v: O, context: Context) => void): TypedFlow<I, O, Context>;
     catch(fn: (e: any, context: Context) => O | Promise<O>): TypedFlow<I, O, Context>;
     take(n: number): TypedFlow<I, O, Context>;
     finally(fn: () => void): TypedFlow<I, O, Context>;
@@ -32,7 +34,7 @@ export declare class Flow<Context = {}> {
     static SKIP: symbol;
     private ops;
     private paused?;
-    private resume;
+    private resume?;
     private controller;
     private cancelHandlers;
     private onStartHandlers;
@@ -56,6 +58,7 @@ export declare class Flow<Context = {}> {
     tap(fn: (v: any, context: Context) => void): any;
     filter(cond: Condition<any>): any;
     debounce(ms: number): any;
+    delay(ms: number): any;
     leading(ms: number): any;
     throttle(ms: number): any;
     take(n: number): any;
@@ -73,6 +76,7 @@ export declare class Flow<Context = {}> {
         max?: number;
     }): this;
     timeout(ms: number): this;
+    tapError(fn: (e: any, context: Context) => void): this;
     catch(fn: (e: any, context: Context) => any): this;
     finally(fn: () => void): this;
 }

package/build/flow-system/utils.d.ts

@@ -1 +1,3 @@
+import { TypedFlow } from "./Flow";
 export declare const sleep: (ms: number, signal: AbortSignal) => Promise<void>;
+export declare function createFlow<I, O = I, Context = {}>(context?: Context): TypedFlow<I, O, Context>;

package/build/index.cjs.js

@@ -1 +1 @@
-"use strict";var t=require("react");const r=(t,r)=>new Promise((e,s)=>{const n=setTimeout(e,t);r.addEventListener("abort",()=>{clearTimeout(n),s("aborted")})});class e{constructor(t={}){this.ctx=t,this.ops=[],this.controller=null,this.cancelHandlers=[],this.onStartHandlers=[],this.onDoneHandlers=[],this.onErrorHandlers=[],this.finallyHandlers=[]}static from(t,r){const s=new e(r);return s.initialInput=t,s}async run(t){var r;const s=void 0!==t?t:this.initialInput;if(void 0===s)throw Error("Flow.run: missing input");null===(r=this.controller)||void 0===r||r.abort(),this.controller=new AbortController,this.onStartHandlers.forEach(t=>t());let n=s;try{for(const t of this.ops){if(this.controller.signal.aborted)return;await this.waitIfPaused(),n=await t(n,this.ctx,this.controller.signal)}return this.onDoneHandlers.forEach(t=>t()),n}catch(t){if(t===e.SKIP)return;throw this.onErrorHandlers.forEach(r=>r(t)),t}finally{this.finallyHandlers.forEach(t=>t())}}onStart(t){return this.onStartHandlers.push(t),this}onDone(t){return this.onDoneHandlers.push(t),this}onError(t){return this.onErrorHandlers.push(t),this}onCancel(t){return this.cancelHandlers.push(t),this}cancel(){var t;null===(t=this.controller)||void 0===t||t.abort(),this.cancelHandlers.forEach(t=>t())}pause(){return this.paused||(this.paused=new Promise(t=>this.resume=t)),this}resumeFlow(){return this.paused&&(this.resume(),this.paused=void 0),this}async waitIfPaused(){this.paused&&await this.paused}context(){return this.ctx}step(t){return this.ops.push(t),this}tap(t){return this.step((r,e)=>(t(r,e),r))}filter(t){return this.step(r=>{if(!t(r))throw e.SKIP;return r})}debounce(t){return this.step(async(e,s,n)=>(await r(t,n),e))}leading(t){let r=!1;return this.step(async s=>{if(r)throw e.SKIP;return r=!0,setTimeout(()=>r=!1,t),s})}throttle(t){return this.leading(t)}take(t){let r=0;return this.step(s=>{if(++r>t)throw e.SKIP;return s})}map(t){return this.step((r,e)=>t(r,e))}switchMap(t){let r=null;return this.step(async(e,s,n)=>(null==r||r.abort(),r=new AbortController,n.addEventListener("abort",()=>null==r?void 0:r.abort()),t(e,s,r.signal)))}exhaustMap(t){let r=!1;return this.step(async(s,n,i)=>{if(r)throw e.SKIP;r=!0;try{return await t(s,n,i)}finally{r=!1}})}distinct(t=Object.is){let r,s=!1;return this.step(n=>{if(s&&t(r,n))throw e.SKIP;return s=!0,r=n,n})}retry(t){const e=this.ops.pop();if(!e)return this;const s="number"==typeof t?{times:t}:t,{times:n,delay:i=0,backoff:o}=s;return this.ops.push(async(t,s,a)=>{let l=0;for(;;)try{return await e(t,s,a)}catch(t){if(l++,l>n)throw t;if(i>0){const t="exponential"===o?i*Math.pow(2,l-1):"linear"===o?i*l:i;await r(t,a)}}}),this}poll(t,e){const s=this.ops.pop();if(!s)return this;const{until:n,max:i}=e||{};return this.ops.push(async(e,o,a)=>{let l,u=0;for(;;){if(l=await s(e,o,a),null==n?void 0:n(l))return l;if(i&&++u>=i)throw Error("poll max reached");await r(t,a)}}),this}timeout(t){const e=this.ops.pop();if(!e)return this;return this.ops.push((s,n,i)=>Promise.race([e(s,n,i),r(t,i).then(()=>{throw Error("timeout")})])),this}catch(t){const r=this.ops.pop();if(!r)return this;return this.ops.push(async(e,s,n)=>{try{return await r(e,s,n)}catch(r){return t(r,s)}}),this}finally(t){return this.finallyHandlers.push(t),this}}e.SKIP=Symbol("FLOW_SKIP"),exports.Flow=e,exports.sleep=r,exports.useFlow=function(r,s,n){const i=t.useRef(null),o=t.useRef(null!=n?n:{});return o.current=null!=n?n:o.current,t.useEffect(()=>{var t;null===(t=i.current)||void 0===t||t.cancel();const n=e.from(r,o.current),a=s(n);return i.current=a,a.run(),()=>a.cancel()},[r,s]),{cancel:t.useCallback(()=>{var t;null===(t=i.current)||void 0===t||t.cancel()},[]),pause:t.useCallback(()=>{var t;null===(t=i.current)||void 0===t||t.pause()},[]),resume:t.useCallback(()=>{var t;null===(t=i.current)||void 0===t||t.resumeFlow()},[]),flow:i.current}};
+"use strict";var t=require("react");const r=(t,r)=>new Promise((s,e)=>{const n=setTimeout(s,t);r.addEventListener("abort",()=>{clearTimeout(n),e("aborted")})});const s=Symbol("FLOW_HANDLED");class e{constructor(t={}){this.ctx=t,this.ops=[],this.controller=null,this.cancelHandlers=[],this.onStartHandlers=[],this.onDoneHandlers=[],this.onErrorHandlers=[],this.finallyHandlers=[]}static from(t,r){const s=new e(r);return s.initialInput=t,s}async run(t){const r=void 0!==t?t:this.initialInput;if(void 0===r)throw Error("Flow.run: missing input");this.cancel(),this.controller=new AbortController,this.onStartHandlers.forEach(t=>t());let n=r,i=!1;try{for(const t of this.ops){if(this.controller.signal.aborted)return;await this.waitIfPaused(),n=await t(n,this.ctx,this.controller.signal)}return this.onDoneHandlers.forEach(t=>t()),n}catch(t){if(t===e.SKIP)return void(i=!0);throw(null==t?void 0:t[s])||this.onErrorHandlers.forEach(r=>r(t)),t}finally{i||this.finallyHandlers.forEach(t=>t())}}onStart(t){return this.onStartHandlers.push(t),this}onDone(t){return this.onDoneHandlers.push(t),this}onError(t){return this.onErrorHandlers.push(t),this}onCancel(t){return this.cancelHandlers.push(t),this}cancel(){var t;null===(t=this.controller)||void 0===t||t.abort(),this.controller=null,this.resume&&(this.resume(),this.resume=void 0,this.paused=void 0),this.cancelHandlers.forEach(t=>t())}pause(){return this.paused||(this.paused=new Promise(t=>{this.resume=t})),this}resumeFlow(){return this.resume&&(this.resume(),this.resume=void 0,this.paused=void 0),this}async waitIfPaused(){this.paused&&await this.paused}context(){return this.ctx}step(t){return this.ops.push(t),this}tap(t){return this.step((r,s)=>(t(r,s),r))}filter(t){return this.step(r=>{if(!t(r))throw e.SKIP;return r})}debounce(t){return this.step(async(s,e,n)=>(await r(t,n),s))}delay(t){return this.step(async(s,e,n)=>(await r(t,n),s))}leading(t){let r=!1;return this.step(async s=>{if(r)throw e.SKIP;return r=!0,setTimeout(()=>r=!1,t),s})}throttle(t){return this.leading(t)}take(t){let r=0;return this.step(s=>{if(++r>t)throw e.SKIP;return s})}map(t){return this.step((r,s)=>t(r,s))}switchMap(t){let r=null;return this.step(async(s,e,n)=>(null==r||r.abort(),r=new AbortController,n.addEventListener("abort",()=>null==r?void 0:r.abort()),t(s,e,r.signal)))}exhaustMap(t){let r=!1;return this.step(async(s,n,i)=>{if(r)throw e.SKIP;r=!0;try{return await t(s,n,i)}finally{r=!1}})}distinct(t=Object.is){let r,s=!1;return this.step(n=>{if(s&&t(r,n))throw e.SKIP;return s=!0,r=n,n})}retry(t){const s=this.ops.pop();if(!s)return this;const e="number"==typeof t?{times:t}:t,{times:n,delay:i=0,backoff:o}=e;return this.ops.push(async(t,e,a)=>{let u=0;for(;;)try{return await s(t,e,a)}catch(t){if(u++,u>n)throw t;if(i>0){const t="exponential"===o?i*Math.pow(2,u-1):"linear"===o?i*u:i;await r(t,a)}}}),this}poll(t,s){const e=this.ops.pop();if(!e)return this;const{until:n,max:i}=s||{};return this.ops.push(async(s,o,a)=>{let u,l=0;for(;;){if(u=await e(s,o,a),null==n?void 0:n(u))return u;if(i&&++l>=i)throw Error("poll max reached");await r(t,a)}}),this}timeout(t){const s=this.ops.pop();if(!s)return this;return this.ops.push((e,n,i)=>Promise.race([s(e,n,i),r(t,i).then(()=>{throw Error("timeout")})])),this}tapError(t){const r=this.ops.pop();if(!r)return this;return this.ops.push(async(s,e,n)=>{try{return await r(s,e,n)}catch(r){throw t(r,e),r}}),this}catch(t){const r=this.ops.pop();if(!r)return this;return this.ops.push(async(e,n,i)=>{try{return await r(e,n,i)}catch(r){return r[s]=!0,t(r,n)}}),this}finally(t){return this.finallyHandlers.push(t),this}}e.SKIP=Symbol("FLOW_SKIP"),exports.Flow=e,exports.createFlow=function(t){return new e(t)},exports.sleep=r,exports.useFlow=function(r,s,n){const i=t.useRef(null),o=t.useRef(null!=n?n:{});return o.current=null!=n?n:o.current,t.useEffect(()=>{var t;null===(t=i.current)||void 0===t||t.cancel();const n=e.from(r,o.current),a=s(n);return i.current=a,a.run(),()=>a.cancel()},[r,s]),{cancel:t.useCallback(()=>{var t;null===(t=i.current)||void 0===t||t.cancel()},[]),pause:t.useCallback(()=>{var t;null===(t=i.current)||void 0===t||t.pause()},[]),resume:t.useCallback(()=>{var t;null===(t=i.current)||void 0===t||t.resumeFlow()},[]),flow:i.current}};

package/build/index.d.ts

@@ -2,4 +2,4 @@ export { Flow } from "./flow-system/Flow";
 export type { TypedFlow } from "./flow-system/Flow";
 export { useFlow } from "./flow-system/useFlow";
 export type { Step, Condition, CancelHandler } from "./flow-system/types";
-export { sleep } from "./flow-system/utils";
+export * from "./flow-system/utils";

package/build/index.esm.js

@@ -1 +1 @@
-import{useRef as t,useEffect as r,useCallback as n}from"react";const s=(t,r)=>new Promise((n,s)=>{const e=setTimeout(n,t);r.addEventListener("abort",()=>{clearTimeout(e),s("aborted")})});class e{constructor(t={}){this.ctx=t,this.ops=[],this.controller=null,this.cancelHandlers=[],this.onStartHandlers=[],this.onDoneHandlers=[],this.onErrorHandlers=[],this.finallyHandlers=[]}static from(t,r){const n=new e(r);return n.initialInput=t,n}async run(t){var r;const n=void 0!==t?t:this.initialInput;if(void 0===n)throw Error("Flow.run: missing input");null===(r=this.controller)||void 0===r||r.abort(),this.controller=new AbortController,this.onStartHandlers.forEach(t=>t());let s=n;try{for(const t of this.ops){if(this.controller.signal.aborted)return;await this.waitIfPaused(),s=await t(s,this.ctx,this.controller.signal)}return this.onDoneHandlers.forEach(t=>t()),s}catch(t){if(t===e.SKIP)return;throw this.onErrorHandlers.forEach(r=>r(t)),t}finally{this.finallyHandlers.forEach(t=>t())}}onStart(t){return this.onStartHandlers.push(t),this}onDone(t){return this.onDoneHandlers.push(t),this}onError(t){return this.onErrorHandlers.push(t),this}onCancel(t){return this.cancelHandlers.push(t),this}cancel(){var t;null===(t=this.controller)||void 0===t||t.abort(),this.cancelHandlers.forEach(t=>t())}pause(){return this.paused||(this.paused=new Promise(t=>this.resume=t)),this}resumeFlow(){return this.paused&&(this.resume(),this.paused=void 0),this}async waitIfPaused(){this.paused&&await this.paused}context(){return this.ctx}step(t){return this.ops.push(t),this}tap(t){return this.step((r,n)=>(t(r,n),r))}filter(t){return this.step(r=>{if(!t(r))throw e.SKIP;return r})}debounce(t){return this.step(async(r,n,e)=>(await s(t,e),r))}leading(t){let r=!1;return this.step(async n=>{if(r)throw e.SKIP;return r=!0,setTimeout(()=>r=!1,t),n})}throttle(t){return this.leading(t)}take(t){let r=0;return this.step(n=>{if(++r>t)throw e.SKIP;return n})}map(t){return this.step((r,n)=>t(r,n))}switchMap(t){let r=null;return this.step(async(n,s,e)=>(null==r||r.abort(),r=new AbortController,e.addEventListener("abort",()=>null==r?void 0:r.abort()),t(n,s,r.signal)))}exhaustMap(t){let r=!1;return this.step(async(n,s,i)=>{if(r)throw e.SKIP;r=!0;try{return await t(n,s,i)}finally{r=!1}})}distinct(t=Object.is){let r,n=!1;return this.step(s=>{if(n&&t(r,s))throw e.SKIP;return n=!0,r=s,s})}retry(t){const r=this.ops.pop();if(!r)return this;const n="number"==typeof t?{times:t}:t,{times:e,delay:i=0,backoff:o}=n;return this.ops.push(async(t,n,a)=>{let l=0;for(;;)try{return await r(t,n,a)}catch(t){if(l++,l>e)throw t;if(i>0){const t="exponential"===o?i*Math.pow(2,l-1):"linear"===o?i*l:i;await s(t,a)}}}),this}poll(t,r){const n=this.ops.pop();if(!n)return this;const{until:e,max:i}=r||{};return this.ops.push(async(r,o,a)=>{let l,u=0;for(;;){if(l=await n(r,o,a),null==e?void 0:e(l))return l;if(i&&++u>=i)throw Error("poll max reached");await s(t,a)}}),this}timeout(t){const r=this.ops.pop();if(!r)return this;return this.ops.push((n,e,i)=>Promise.race([r(n,e,i),s(t,i).then(()=>{throw Error("timeout")})])),this}catch(t){const r=this.ops.pop();if(!r)return this;return this.ops.push(async(n,s,e)=>{try{return await r(n,s,e)}catch(r){return t(r,s)}}),this}finally(t){return this.finallyHandlers.push(t),this}}function i(s,i,o){const a=t(null),l=t(null!=o?o:{});l.current=null!=o?o:l.current,r(()=>{var t;null===(t=a.current)||void 0===t||t.cancel();const r=e.from(s,l.current),n=i(r);return a.current=n,n.run(),()=>n.cancel()},[s,i]);return{cancel:n(()=>{var t;null===(t=a.current)||void 0===t||t.cancel()},[]),pause:n(()=>{var t;null===(t=a.current)||void 0===t||t.pause()},[]),resume:n(()=>{var t;null===(t=a.current)||void 0===t||t.resumeFlow()},[]),flow:a.current}}e.SKIP=Symbol("FLOW_SKIP");export{e as Flow,s as sleep,i as useFlow};
+import{useRef as t,useEffect as r,useCallback as s}from"react";const e=(t,r)=>new Promise((s,e)=>{const n=setTimeout(s,t);r.addEventListener("abort",()=>{clearTimeout(n),e("aborted")})});function n(t){return new o(t)}const i=Symbol("FLOW_HANDLED");class o{constructor(t={}){this.ctx=t,this.ops=[],this.controller=null,this.cancelHandlers=[],this.onStartHandlers=[],this.onDoneHandlers=[],this.onErrorHandlers=[],this.finallyHandlers=[]}static from(t,r){const s=new o(r);return s.initialInput=t,s}async run(t){const r=void 0!==t?t:this.initialInput;if(void 0===r)throw Error("Flow.run: missing input");this.cancel(),this.controller=new AbortController,this.onStartHandlers.forEach(t=>t());let s=r,e=!1;try{for(const t of this.ops){if(this.controller.signal.aborted)return;await this.waitIfPaused(),s=await t(s,this.ctx,this.controller.signal)}return this.onDoneHandlers.forEach(t=>t()),s}catch(t){if(t===o.SKIP)return void(e=!0);throw(null==t?void 0:t[i])||this.onErrorHandlers.forEach(r=>r(t)),t}finally{e||this.finallyHandlers.forEach(t=>t())}}onStart(t){return this.onStartHandlers.push(t),this}onDone(t){return this.onDoneHandlers.push(t),this}onError(t){return this.onErrorHandlers.push(t),this}onCancel(t){return this.cancelHandlers.push(t),this}cancel(){var t;null===(t=this.controller)||void 0===t||t.abort(),this.controller=null,this.resume&&(this.resume(),this.resume=void 0,this.paused=void 0),this.cancelHandlers.forEach(t=>t())}pause(){return this.paused||(this.paused=new Promise(t=>{this.resume=t})),this}resumeFlow(){return this.resume&&(this.resume(),this.resume=void 0,this.paused=void 0),this}async waitIfPaused(){this.paused&&await this.paused}context(){return this.ctx}step(t){return this.ops.push(t),this}tap(t){return this.step((r,s)=>(t(r,s),r))}filter(t){return this.step(r=>{if(!t(r))throw o.SKIP;return r})}debounce(t){return this.step(async(r,s,n)=>(await e(t,n),r))}delay(t){return this.step(async(r,s,n)=>(await e(t,n),r))}leading(t){let r=!1;return this.step(async s=>{if(r)throw o.SKIP;return r=!0,setTimeout(()=>r=!1,t),s})}throttle(t){return this.leading(t)}take(t){let r=0;return this.step(s=>{if(++r>t)throw o.SKIP;return s})}map(t){return this.step((r,s)=>t(r,s))}switchMap(t){let r=null;return this.step(async(s,e,n)=>(null==r||r.abort(),r=new AbortController,n.addEventListener("abort",()=>null==r?void 0:r.abort()),t(s,e,r.signal)))}exhaustMap(t){let r=!1;return this.step(async(s,e,n)=>{if(r)throw o.SKIP;r=!0;try{return await t(s,e,n)}finally{r=!1}})}distinct(t=Object.is){let r,s=!1;return this.step(e=>{if(s&&t(r,e))throw o.SKIP;return s=!0,r=e,e})}retry(t){const r=this.ops.pop();if(!r)return this;const s="number"==typeof t?{times:t}:t,{times:n,delay:i=0,backoff:o}=s;return this.ops.push(async(t,s,a)=>{let u=0;for(;;)try{return await r(t,s,a)}catch(t){if(u++,u>n)throw t;if(i>0){const t="exponential"===o?i*Math.pow(2,u-1):"linear"===o?i*u:i;await e(t,a)}}}),this}poll(t,r){const s=this.ops.pop();if(!s)return this;const{until:n,max:i}=r||{};return this.ops.push(async(r,o,a)=>{let u,h=0;for(;;){if(u=await s(r,o,a),null==n?void 0:n(u))return u;if(i&&++h>=i)throw Error("poll max reached");await e(t,a)}}),this}timeout(t){const r=this.ops.pop();if(!r)return this;return this.ops.push((s,n,i)=>Promise.race([r(s,n,i),e(t,i).then(()=>{throw Error("timeout")})])),this}tapError(t){const r=this.ops.pop();if(!r)return this;return this.ops.push(async(s,e,n)=>{try{return await r(s,e,n)}catch(r){throw t(r,e),r}}),this}catch(t){const r=this.ops.pop();if(!r)return this;return this.ops.push(async(s,e,n)=>{try{return await r(s,e,n)}catch(r){return r[i]=!0,t(r,e)}}),this}finally(t){return this.finallyHandlers.push(t),this}}function a(e,n,i){const a=t(null),u=t(null!=i?i:{});u.current=null!=i?i:u.current,r(()=>{var t;null===(t=a.current)||void 0===t||t.cancel();const r=o.from(e,u.current),s=n(r);return a.current=s,s.run(),()=>s.cancel()},[e,n]);return{cancel:s(()=>{var t;null===(t=a.current)||void 0===t||t.cancel()},[]),pause:s(()=>{var t;null===(t=a.current)||void 0===t||t.pause()},[]),resume:s(()=>{var t;null===(t=a.current)||void 0===t||t.resumeFlow()},[]),flow:a.current}}o.SKIP=Symbol("FLOW_SKIP");export{o as Flow,n as createFlow,e as sleep,a as useFlow};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-flow-z",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "A lightweight async flow runtime for orchestrating side effects with explicit control over cancellation, debounce, throttling, and execution order.",
   "license": "MIT",
   "author": "Delpi.Kye",