stunk 3.0.0-rc.2 → 3.0.0-rc.3

package/dist/use-react/index.d.ts

@@ -63,7 +63,7 @@ interface UseAsyncChunkResultWithPagination<T, E extends Error, P extends Record
 }
 interface UseAsyncChunkResultWithParamsAndPagination<T, E extends Error, P extends Record<string, any>> extends UseAsyncChunkResultWithParams<T, E, P>, Omit<UseAsyncChunkResultWithPagination<T, E, P>, keyof UseAsyncChunkResult<T, E, P>> {
 }
-interface UseAsyncChunkOptions<P extends Record<string, any> = {}> {
+interface UseAsyncChunkOptions<T = any, E extends Error = Error, P extends Record<string, any> = {}> {
     /**
      * Parameters to pass to the fetcher. When these change between renders,
      * the chunk automatically re-fetches with the new values.
@@ -79,15 +79,25 @@ interface UseAsyncChunkOptions<P extends Record<string, any> = {}> {
      * (default: false)
      */
     fetchOnMount?: boolean;
+    /**
+     * Called after every successful fetch at the hook level.
+     * Has full access to React context — safe to call navigate(), setState(), etc.
+     */
+    onSuccess?: (data: T) => void;
+    /**
+     * Called when a fetch fails at the hook level.
+     * Has full access to React context — safe to call navigate(), setState(), etc.
+     */
+    onError?: (error: E) => void;
 }
 declare function useAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(asyncChunk: PaginatedAsyncChunk<T, E> & {
     setParams: (params: Partial<P>) => void;
-}, options?: UseAsyncChunkOptions<P>): UseAsyncChunkResultWithParamsAndPagination<T, E, P>;
-declare function useAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(asyncChunk: PaginatedAsyncChunk<T, E>, options?: UseAsyncChunkOptions<P>): UseAsyncChunkResultWithPagination<T, E, P>;
+}, options?: UseAsyncChunkOptions<T, E, P>): UseAsyncChunkResultWithParamsAndPagination<T, E, P>;
+declare function useAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(asyncChunk: PaginatedAsyncChunk<T, E>, options?: UseAsyncChunkOptions<T, E, P>): UseAsyncChunkResultWithPagination<T, E, P>;
 declare function useAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(asyncChunk: AsyncChunk<T, E> & {
     setParams: (params: Partial<P>) => void;
-}, options?: UseAsyncChunkOptions<P>): UseAsyncChunkResultWithParams<T, E, P>;
-declare function useAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(asyncChunk: AsyncChunk<T, E>, options?: UseAsyncChunkOptions<P>): UseAsyncChunkResult<T, E, P>;
+}, options?: UseAsyncChunkOptions<T, E, P>): UseAsyncChunkResultWithParams<T, E, P>;
+declare function useAsyncChunk<T, E extends Error = Error, P extends Record<string, any> = {}>(asyncChunk: AsyncChunk<T, E>, options?: UseAsyncChunkOptions<T, E, P>): UseAsyncChunkResult<T, E, P>;
 
 interface UseInfiniteAsyncChunkOptions<P extends Record<string, any>> extends Omit<UseAsyncChunkOptions<P>, 'initialParams'> {
     /** Initial parameters — page and pageSize are managed automatically */

package/dist/use-react/index.js

@@ -1 +1 @@
-import {a}from'../chunk-7PLFRQ2T.js';import {b}from'../chunk-PZ7A72TA.js';import {useState,useEffect,useCallback,useRef}from'react';function S(e,r,t={}){let{useShallowEqual:i=false}=t,u=e.get(),n=r(u),a$1=a(n),l=()=>{let m=e.get(),c=r(m);(i?!b(c,n):c!==n)&&(n=c,a$1.set(c));},o=e.subscribe(l),{set:d,reset:T,...E}=a$1;return {...E,derive:m=>S(a$1,m,t),destroy:()=>{o(),a$1.destroy();}}}function M(e,r){let t=r?S(e,r):e,[i,u]=useState(()=>t.get());useEffect(()=>{let o=t.subscribe(d=>{u(()=>d);});return ()=>o()},[t]);let n=useCallback(o=>{"set"in e&&e.set(o);},[e]),a=useCallback(()=>{"reset"in e&&e.reset();},[e]),l=useCallback(()=>{e.destroy();},[e]);return [i,n,a,l]}function K(e,r){let[t]=M(e,r);return t}function y(e){return "nextPage"in e}function A(e){return "setParams"in e}function B(e){return "clearParams"in e}function O(e,r={}){let t=r.params??r.initialParams,{fetchOnMount:i=false}=r,[u,n]=useState(()=>e.get()),a=useRef({resolvedParams:t,fetchOnMount:i});a.current={resolvedParams:t,fetchOnMount:i},useEffect(()=>{n(e.get());let s=e.subscribe(j=>{n(j);}),{resolvedParams:D,fetchOnMount:_}=a.current;return D&&A(e)?e.setParams(D):_&&e.reload(),()=>{s(),e.cleanup();}},[e]);let l=useRef(false),o=t?JSON.stringify(t):null;useEffect(()=>{if(!l.current){l.current=true;return}t&&A(e)&&e.setParams(t);},[o]);let d=useCallback(s=>e.reload(s),[e]),T=useCallback(s=>e.refresh(s),[e]),E=useCallback(s=>e.mutate(s),[e]),m=useCallback(()=>e.reset(),[e]),c=useCallback(s=>{A(e)&&e.setParams(s);},[e]),f=useCallback(()=>{B(e)&&e.clearParams();},[e]),h=useCallback(()=>y(e)?e.nextPage():Promise.resolve(),[e]),x=useCallback(()=>y(e)?e.prevPage():Promise.resolve(),[e]),v=useCallback(s=>y(e)?e.goToPage(s):Promise.resolve(),[e]),C=useCallback(()=>y(e)?e.resetPagination():Promise.resolve(),[e]),{data:p,loading:g,error:k,lastFetched:q,isPlaceholderData:L=false,pagination:H}=u,R={data:p,loading:g,error:k,lastFetched:q,isPlaceholderData:L,reload:d,refresh:T,mutate:E,reset:m};if(A(e)&&(R.setParams=c,R.clearParams=f),y(e)){let s=R;s.pagination=H,s.nextPage=h,s.prevPage=x,s.goToPage=v,s.resetPagination=C;}return R}function X(e,r={}){let{initialParams:t,autoLoad:i=true,threshold:u=1,fetchOnMount:n}=r,a=O(e,{...t&&{initialParams:t},fetchOnMount:n}),{loading:l,pagination:o,nextPage:d,data:T,error:E,isPlaceholderData:m}=a,c=useRef(l),f=useRef(o?.hasMore??false),h=useRef(d);c.current=l,f.current=o?.hasMore??false,h.current=d;let x=useRef(null);useEffect(()=>{if(!i||typeof window>"u"||!("IntersectionObserver"in window))return;let p=new IntersectionObserver(k=>{k[0].isIntersecting&&!c.current&&f.current&&h.current();},{threshold:u}),g=x.current;return g&&p.observe(g),()=>{g&&p.unobserve(g),p.disconnect();}},[i,u]);let v=useCallback(()=>{!c.current&&f.current&&h.current();},[]),C=l&&T!==null&&T.length>0&&(o?.page??1)>1;return {...a,data:T,error:E,isPlaceholderData:m??false,isFetchingMore:C,hasMore:o?.hasMore??false,loadMore:v,observerTarget:x}}function $(e){let[r,t]=useState(()=>e.get());useEffect(()=>(t(e.get()),e.subscribe(a=>{t(a);})),[e]);let i=useCallback((...n)=>e.mutate(...n),[e]),u=useCallback(()=>e.reset(),[e]);return {loading:r.loading,data:r.data,error:r.error,isSuccess:r.isSuccess,mutate:i,reset:u}}export{O as useAsyncChunk,M as useChunk,K as useChunkValue,X as useInfiniteAsyncChunk,$ as useMutation};
+import {a}from'../chunk-7PLFRQ2T.js';import {b}from'../chunk-PZ7A72TA.js';import {useState,useEffect,useCallback,useRef}from'react';function U(e,t,r={}){let{useShallowEqual:i=false}=r,u=e.get(),a$1=t(u),o=a(a$1),l=()=>{let f=e.get(),c=t(f);(i?!b(c,a$1):c!==a$1)&&(a$1=c,o.set(c));},n=e.subscribe(l),{set:d,reset:m,...h}=o;return {...h,derive:f=>U(o,f,r),destroy:()=>{n(),o.destroy();}}}function O(e,t){let r=t?U(e,t):e,[i,u]=useState(()=>r.get());useEffect(()=>{let n=r.subscribe(d=>{u(()=>d);});return ()=>n()},[r]);let a=useCallback(n=>{"set"in e&&e.set(n);},[e]),o=useCallback(()=>{"reset"in e&&e.reset();},[e]),l=useCallback(()=>{e.destroy();},[e]);return [i,a,o,l]}function X(e,t){let[r]=O(e,t);return r}function x(e){return "nextPage"in e}function v(e){return "setParams"in e}function Z(e){return "clearParams"in e}function W(e,t={}){let r=t.params??t.initialParams,{fetchOnMount:i=false,onSuccess:u,onError:a}=t,[o,l]=useState(()=>e.get()),n=useRef({resolvedParams:r,fetchOnMount:i,onSuccess:u,onError:a});n.current={resolvedParams:r,fetchOnMount:i,onSuccess:u,onError:a};let d=useRef(e.get());useEffect(()=>{let s=e.get();l(s),d.current=s;let N=e.subscribe(T=>{let I=d.current;I.loading&&!T.loading&&!T.error&&T.data!==null&&n.current.onSuccess?.(T.data),I.loading&&!T.loading&&T.error&&n.current.onError?.(T.error),d.current=T,l(T);}),{resolvedParams:V,fetchOnMount:B}=n.current;return V&&v(e)?e.setParams(V):B&&e.reload(),()=>{N(),e.cleanup();}},[e]);let m=useRef(false),h=r?JSON.stringify(r):null;useEffect(()=>{if(!m.current){m.current=true;return}r&&v(e)&&e.setParams(r);},[h]);let f=useCallback(s=>e.reload(s),[e]),c=useCallback(s=>e.refresh(s),[e]),E=useCallback(s=>e.mutate(s),[e]),p=useCallback(()=>e.reset(),[e]),R=useCallback(s=>{v(e)&&e.setParams(s);},[e]),C=useCallback(()=>{Z(e)&&e.clearParams();},[e]),k=useCallback(()=>x(e)?e.nextPage():Promise.resolve(),[e]),y=useCallback(()=>x(e)?e.prevPage():Promise.resolve(),[e]),g=useCallback(s=>x(e)?e.goToPage(s):Promise.resolve(),[e]),S=useCallback(()=>x(e)?e.resetPagination():Promise.resolve(),[e]),{data:_,loading:j,error:w,lastFetched:z,isPlaceholderData:J=false,pagination:K}=o,A={data:_,loading:j,error:w,lastFetched:z,isPlaceholderData:J,reload:f,refresh:c,mutate:E,reset:p};if(v(e)&&(A.setParams=R,A.clearParams=C),x(e)){let s=A;s.pagination=K,s.nextPage=k,s.prevPage=y,s.goToPage=g,s.resetPagination=S;}return A}function re(e,t={}){let{initialParams:r,autoLoad:i=true,threshold:u=1,fetchOnMount:a}=t,o=W(e,{...r&&{initialParams:r},fetchOnMount:a}),{loading:l,pagination:n,nextPage:d,data:m,error:h,isPlaceholderData:f}=o,c=useRef(l),E=useRef(n?.hasMore??false),p=useRef(d);c.current=l,E.current=n?.hasMore??false,p.current=d;let R=useRef(null);useEffect(()=>{if(!i||typeof window>"u"||!("IntersectionObserver"in window))return;let y=new IntersectionObserver(S=>{S[0].isIntersecting&&!c.current&&E.current&&p.current();},{threshold:u}),g=R.current;return g&&y.observe(g),()=>{g&&y.unobserve(g),y.disconnect();}},[i,u]);let C=useCallback(()=>{!c.current&&E.current&&p.current();},[]),k=l&&m!==null&&m.length>0&&(n?.page??1)>1;return {...o,data:m,error:h,isPlaceholderData:f??false,isFetchingMore:k,hasMore:n?.hasMore??false,loadMore:C,observerTarget:R}}function ne(e){let[t,r]=useState(()=>e.get());useEffect(()=>(r(e.get()),e.subscribe(o=>{r(o);})),[e]);let i=useCallback((...a)=>e.mutate(...a),[e]),u=useCallback(()=>e.reset(),[e]);return {loading:t.loading,data:t.data,error:t.error,isSuccess:t.isSuccess,mutate:i,reset:u}}export{W as useAsyncChunk,O as useChunk,X as useChunkValue,re as useInfiniteAsyncChunk,ne as useMutation};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stunk",
-  "version": "3.0.0-rc.2",
+  "version": "3.0.0-rc.3",
   "description": "Stunk is a lightweight, framework-agnostic state management library for JavaScript and TypeScript. It uses chunk-based state units for efficient updates, reactivity, and performance optimization in React, Vue(WIP), Svelte(Coming soon), and Vanilla JS/TS applications.",
   "type": "module",
   "repository": {