@visulima/storage-client 1.0.0-alpha.7 → 1.0.0-alpha.8

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+## @visulima/storage-client [1.0.0-alpha.8](https://github.com/visulima/visulima/compare/@visulima/storage-client@1.0.0-alpha.7...@visulima/storage-client@1.0.0-alpha.8) (2026-03-26)
+
+### Bug Fixes
+
+* **docs:** correct code examples found during verification ([8e4f8c4](https://github.com/visulima/visulima/commit/8e4f8c4b0b1664c232fe5ae721b771c72d29a152))
+* **storage-client:** guard setInterval against unmounted component and migrate deps to pnpm catalogs ([a6618bc](https://github.com/visulima/visulima/commit/a6618bc7b3f866592a73ba79bf310ffe272f253a))
+* **storage-client:** resolve TanStack Query v5.94+ source-only packages in tests ([1c1b39f](https://github.com/visulima/visulima/commit/1c1b39fd4b259768ffd5b18eb676a146ce5bfb40))
+* updated deps and migrated web app build deps to pnpm catalog ([dd4f515](https://github.com/visulima/visulima/commit/dd4f5153a07d0e46de0b3fc091878d66bb70f2d3))
+* **web:** improve build setup with incremental stats caching and prod install ([fe33e75](https://github.com/visulima/visulima/commit/fe33e75827586779b4b3a0c6d57b39f889ee6207))
+
+### Documentation
+
+* add missing documentation pages for email, string, and storage-client ([623f8af](https://github.com/visulima/visulima/commit/623f8afd2ea03dd2805fb2d7a9d10083571224bb))
+
+### Miscellaneous Chores
+
+* **storage-client:** update dependencies ([7976708](https://github.com/visulima/visulima/commit/7976708758d06d3424a0a659b7f074cd25f9b1b9))
+* visulima website ([#591](https://github.com/visulima/visulima/issues/591)) ([59ab2e2](https://github.com/visulima/visulima/commit/59ab2e2befb03e51cd2088956f83d9b87de6d033))
+
+### Code Refactoring
+
+* **storage-client:** replace vite-tsconfig-paths with native Vite 8 resolve.tsconfigPaths ([7d528f1](https://github.com/visulima/visulima/commit/7d528f1a6d3b1b9ec93c891e89af7bdbf78d090c))
+
 ## @visulima/storage-client [1.0.0-alpha.7](https://github.com/visulima/visulima/compare/@visulima/storage-client@1.0.0-alpha.6...@visulima/storage-client@1.0.0-alpha.7) (2026-03-06)
 
 ### Bug Fixes

package/dist/packem_shared/useChunkedRestUpload-ByEGSmgy.js

@@ -0,0 +1 @@
+var _=Object.defineProperty;var k=(c,a)=>_(c,"name",{value:a,configurable:!0});import{useState as u,useMemo as G,useRef as H,useEffect as C,useCallback as l}from"react";import{createChunkedRestAdapter as J}from"./createChunkedRestAdapter-Df1E_Adn.js";var K=Object.defineProperty,L=k((c,a)=>K(c,"name",{value:a,configurable:!0}),"y");const V=L(c=>{const{chunkSize:a,endpoint:E,maxRetries:O,metadata:R,onError:m,onPause:p,onProgress:S,onResume:v,onStart:P,onSuccess:g,retry:y}=c,[x,f]=u(0),[U,s]=u(!1),[z,o]=u(!1),[F,h]=u(void 0),[I,w]=u(void 0),[j,d]=u(0),e=G(()=>J({chunkSize:a,endpoint:E,maxRetries:O,metadata:R,retry:y}),[a,E,O,R,y]),n=H({onError:m,onPause:p,onProgress:S,onResume:v,onStart:P,onSuccess:g});C(()=>{n.current={onError:m,onPause:p,onProgress:S,onResume:v,onStart:P,onSuccess:g}},[m,S,p,v,P,g]),C(()=>{e.setOnStart(()=>{s(!0),o(!1),f(0),h(void 0),d(0),n.current.onStart?.()}),e.setOnProgress((t,b)=>{f(t),d(b),n.current.onProgress?.(t,b)}),e.setOnFinish(t=>{f(100),w(t),s(!1),o(!1),n.current.onSuccess?.(t)}),e.setOnError(t=>{h(t),s(!1),n.current.onError?.(t)});let r=!0;const i=setInterval(async()=>{r&&(d(await e.getOffset()),o(e.isPaused()))},100);return()=>{r=!1,clearInterval(i),e.setOnStart(void 0),e.setOnProgress(void 0),e.setOnFinish(void 0),e.setOnError(void 0)}},[e]);const A=l(async r=>{try{return await e.upload(r)}catch(i){throw i instanceof Error?i:new Error(String(i))}},[e]),M=l(()=>{e.pause(),o(!0),n.current.onPause?.()},[e]),q=l(async()=>{o(!1),s(!0),n.current.onResume?.();try{await e.resume()}catch(r){throw s(!1),r instanceof Error?r:new Error(String(r))}},[e]),B=l(()=>{e.abort(),s(!1),o(!1)},[e]),D=l(()=>{e.clear(),f(0),s(!1),o(!1),h(void 0),w(void 0),d(0)},[e]);return{abort:B,error:F,isPaused:z,isUploading:U,offset:j,pause:M,progress:x,reset:D,result:I,resume:q,upload:A}},"useChunkedRestUpload");export{V as useChunkedRestUpload};

package/dist/packem_shared/{useUpload-BY_sQuJj.js → useUpload-CpZQyE4g.js}

@@ -1 +1 @@
-var K=Object.defineProperty;var x=(m,a)=>K(m,"name",{value:a,configurable:!0});import{useMemo as k,useCallback as R}from"react";import{useChunkedRestUpload as L}from"./useChunkedRestUpload-cKHvYQN3.js";import{useMultipartUpload as _}from"./useMultipartUpload-B9Vi7f5z.js";import{useTusUpload as q}from"./useTusUpload-DQa9PgkZ.js";var G=Object.defineProperty,i=x((m,a)=>G(m,"name",{value:a,configurable:!0}),"s");const Q=10*1024*1024,$=i(m=>{const{chunkSize:a,endpointChunkedRest:s,endpointMultipart:d,endpointTus:n,maxRetries:v,metadata:p,method:E,onError:l,onPause:P,onProgress:f,onResume:U,onStart:c,onSuccess:g,retry:S,tusThreshold:w=Q}=m,h=k(()=>{if(E!==void 0)return E;const u=[s,d,n].filter(Boolean);if(u.length===1)return s?"chunked-rest":n?"tus":"multipart";if(u.length>1)return"auto";throw new Error("At least one endpoint must be provided: endpointChunkedRest, endpointMultipart, or endpointTus")},[E,s,d,n]),b=k(()=>{if(s)return{chunkSize:a,endpoint:s,maxRetries:v,metadata:p,onError:l,onPause:P,onProgress:f,onResume:U,onStart:c,onSuccess:g,retry:S}},[s,a,p,c,g,l,f,P,U,S,v]),T=k(()=>{if(d)return{endpoint:d,metadata:p,onError:l,onProgress:f,onStart:c,onSuccess:g}},[d,p,c,g,l,f]),y=k(()=>{if(n)return{chunkSize:a,endpoint:n,maxRetries:v,metadata:p,onError:l,onPause:P,onProgress:f,onResume:U,onStart:c,onSuccess:g,retry:S}},[n,a,p,c,g,l,f,P,U,S,v]),e=b?L(b):void 0,o=T?_(T):void 0,r=y?q(y):void 0,C=R(u=>{if(h!=="auto")return h;if(u.size>w){if(n)return"tus";if(s)return"chunked-rest"}if(s)return"chunked-rest";if(d)return"multipart";throw new Error("No available endpoint for upload")},[h,w,s,d,n]),z=R(async u=>{const M=C(u);if(M==="tus"){if(!r)throw new Error("TUS endpoint not configured");return r.upload(u)}if(M==="chunked-rest"){if(!e)throw new Error("Chunked REST endpoint not configured");return e.upload(u)}if(!o)throw new Error("Multipart endpoint not configured");return o.upload(u)},[C,r,e,o]),I=R(()=>{r?.abort(),e?.abort(),o?.reset()},[r,e,o]),O=R(()=>{r?.reset(),e?.reset(),o?.reset()},[r,e,o]),t=k(()=>h!=="auto"?h:r&&(r.isUploading||r.result)?"tus":e&&(e.isUploading||e.result)?"chunked-rest":o&&(o.isUploading||o.result)?"multipart":s?"chunked-rest":n?"tus":"multipart",[h,r,e,o,s,d,n]),A=i(()=>t==="tus"?r?.error??void 0:t==="chunked-rest"?e?.error??void 0:o?.error??void 0,"getError"),B=i(()=>{if(t==="tus")return r?.isPaused;if(t==="chunked-rest")return e?.isPaused},"getIsPaused"),N=i(()=>t==="tus"?r?.isUploading??!1:t==="chunked-rest"?e?.isUploading??!1:o?.isUploading??!1,"getIsUploading"),j=i(()=>{if(t==="tus")return r?.offset;if(t==="chunked-rest")return e?.offset},"getOffset"),D=i(()=>{if(t==="tus")return r?.pause;if(t==="chunked-rest")return e?.pause},"getPause"),F=i(()=>t==="tus"?r?.progress??0:t==="chunked-rest"?e?.progress??0:o?.progress??0,"getProgress"),H=i(()=>t==="tus"?r?.result??void 0:t==="chunked-rest"?e?.result??void 0:o?.result??void 0,"getResult"),J=i(()=>{if(t==="tus")return r?.resume;if(t==="chunked-rest")return e?.resume},"getResume");return{abort:I,currentMethod:t,error:A(),isPaused:B(),isUploading:N(),offset:j(),pause:D(),progress:F(),reset:O,result:H(),resume:J(),upload:z}},"useUpload");export{$ as useUpload};
+var K=Object.defineProperty;var x=(m,a)=>K(m,"name",{value:a,configurable:!0});import{useMemo as k,useCallback as R}from"react";import{useChunkedRestUpload as L}from"./useChunkedRestUpload-ByEGSmgy.js";import{useMultipartUpload as _}from"./useMultipartUpload-B9Vi7f5z.js";import{useTusUpload as q}from"./useTusUpload-DQa9PgkZ.js";var G=Object.defineProperty,i=x((m,a)=>G(m,"name",{value:a,configurable:!0}),"s");const Q=10*1024*1024,$=i(m=>{const{chunkSize:a,endpointChunkedRest:s,endpointMultipart:d,endpointTus:n,maxRetries:v,metadata:p,method:E,onError:l,onPause:P,onProgress:f,onResume:U,onStart:c,onSuccess:g,retry:S,tusThreshold:w=Q}=m,h=k(()=>{if(E!==void 0)return E;const u=[s,d,n].filter(Boolean);if(u.length===1)return s?"chunked-rest":n?"tus":"multipart";if(u.length>1)return"auto";throw new Error("At least one endpoint must be provided: endpointChunkedRest, endpointMultipart, or endpointTus")},[E,s,d,n]),b=k(()=>{if(s)return{chunkSize:a,endpoint:s,maxRetries:v,metadata:p,onError:l,onPause:P,onProgress:f,onResume:U,onStart:c,onSuccess:g,retry:S}},[s,a,p,c,g,l,f,P,U,S,v]),T=k(()=>{if(d)return{endpoint:d,metadata:p,onError:l,onProgress:f,onStart:c,onSuccess:g}},[d,p,c,g,l,f]),y=k(()=>{if(n)return{chunkSize:a,endpoint:n,maxRetries:v,metadata:p,onError:l,onPause:P,onProgress:f,onResume:U,onStart:c,onSuccess:g,retry:S}},[n,a,p,c,g,l,f,P,U,S,v]),e=b?L(b):void 0,o=T?_(T):void 0,r=y?q(y):void 0,C=R(u=>{if(h!=="auto")return h;if(u.size>w){if(n)return"tus";if(s)return"chunked-rest"}if(s)return"chunked-rest";if(d)return"multipart";throw new Error("No available endpoint for upload")},[h,w,s,d,n]),z=R(async u=>{const M=C(u);if(M==="tus"){if(!r)throw new Error("TUS endpoint not configured");return r.upload(u)}if(M==="chunked-rest"){if(!e)throw new Error("Chunked REST endpoint not configured");return e.upload(u)}if(!o)throw new Error("Multipart endpoint not configured");return o.upload(u)},[C,r,e,o]),I=R(()=>{r?.abort(),e?.abort(),o?.reset()},[r,e,o]),O=R(()=>{r?.reset(),e?.reset(),o?.reset()},[r,e,o]),t=k(()=>h!=="auto"?h:r&&(r.isUploading||r.result)?"tus":e&&(e.isUploading||e.result)?"chunked-rest":o&&(o.isUploading||o.result)?"multipart":s?"chunked-rest":n?"tus":"multipart",[h,r,e,o,s,d,n]),A=i(()=>t==="tus"?r?.error??void 0:t==="chunked-rest"?e?.error??void 0:o?.error??void 0,"getError"),B=i(()=>{if(t==="tus")return r?.isPaused;if(t==="chunked-rest")return e?.isPaused},"getIsPaused"),N=i(()=>t==="tus"?r?.isUploading??!1:t==="chunked-rest"?e?.isUploading??!1:o?.isUploading??!1,"getIsUploading"),j=i(()=>{if(t==="tus")return r?.offset;if(t==="chunked-rest")return e?.offset},"getOffset"),D=i(()=>{if(t==="tus")return r?.pause;if(t==="chunked-rest")return e?.pause},"getPause"),F=i(()=>t==="tus"?r?.progress??0:t==="chunked-rest"?e?.progress??0:o?.progress??0,"getProgress"),H=i(()=>t==="tus"?r?.result??void 0:t==="chunked-rest"?e?.result??void 0:o?.result??void 0,"getResult"),J=i(()=>{if(t==="tus")return r?.resume;if(t==="chunked-rest")return e?.resume},"getResume");return{abort:I,currentMethod:t,error:A(),isPaused:B(),isUploading:N(),offset:j(),pause:D(),progress:F(),reset:O,result:H(),resume:J(),upload:z}},"useUpload");export{$ as useUpload};

package/dist/react/index.js

@@ -1 +1 @@
-import{useAbortAll as o}from"../packem_shared/useAbortAll-DrHBz3kQ.js";import{useAbortBatch as s}from"../packem_shared/useAbortBatch-gVI48Gqa.js";import{useAbortItem as u}from"../packem_shared/useAbortItem-Blw0eI13.js";import{useAllAbortListener as f}from"../packem_shared/useAllAbortListener-DiliYPra.js";import{useBatchCancelledListener as a}from"../packem_shared/useBatchCancelledListener-CD0CULd_.js";import{useBatchDeleteFiles as i}from"../packem_shared/useBatchDeleteFiles-KthW4bon.js";import{useBatchErrorListener as h}from"../packem_shared/useBatchErrorListener-D-M1xGbQ.js";import{useBatchFinalizeListener as F}from"../packem_shared/useBatchFinalizeListener-BjnW3Lst.js";import{useBatchFinishListener as B}from"../packem_shared/useBatchFinishListener-DedP4Rm_.js";import{useBatchProgressListener as A}from"../packem_shared/useBatchProgressListener-CBAjGzmu.js";import{useBatchRetry as b}from"../packem_shared/useBatchRetry-C53msBuL.js";import{useBatchStartListener as R}from"../packem_shared/useBatchStartListener-BAOxxo1Y.js";import{useBatchUpload as C}from"../packem_shared/useBatchUpload-DLQNW410.js";import{useChunkedRestUpload as M}from"../packem_shared/useChunkedRestUpload-cKHvYQN3.js";import{useDeleteFile as k}from"../packem_shared/useDeleteFile-CND-6aNW.js";import{useFileInput as I}from"../packem_shared/useFileInput-hIbzJ_JN.js";import{useGetFile as z}from"../packem_shared/useGetFile-DvgluPgA.js";import{useGetFileList as H}from"../packem_shared/useGetFileList-D0tKDYAc.js";import{useGetFileMeta as j}from"../packem_shared/useGetFileMeta-Ekre98Sg.js";import{useHeadFile as v}from"../packem_shared/useHeadFile-CCu61b-B.js";import{useMultipartUpload as J}from"../packem_shared/useMultipartUpload-B9Vi7f5z.js";import{usePasteUpload as N}from"../packem_shared/usePasteUpload-_YqkCkrL.js";import{usePatchChunk as Q}from"../packem_shared/usePatchChunk-DoKsCbBH.js";import{usePutFile as W}from"../packem_shared/usePutFile-B6cFjClD.js";import{useRetry as Y}from"../packem_shared/useRetry-mkTUERYR.js";import{useRetryListener as _}from"../packem_shared/useRetryListener-B45dL00Q.js";import{useTransformFile as ee}from"../packem_shared/useTransformFile-sIkJLAwo.js";import{useTransformMetadata as oe}from"../packem_shared/useTransformMetadata-DK1561-K.js";import{useTusUpload as se}from"../packem_shared/useTusUpload-DQa9PgkZ.js";import{useUpload as ue}from"../packem_shared/useUpload-BY_sQuJj.js";export{o as useAbortAll,s as useAbortBatch,u as useAbortItem,f as useAllAbortListener,a as useBatchCancelledListener,i as useBatchDeleteFiles,h as useBatchErrorListener,F as useBatchFinalizeListener,B as useBatchFinishListener,A as useBatchProgressListener,b as useBatchRetry,R as useBatchStartListener,C as useBatchUpload,M as useChunkedRestUpload,k as useDeleteFile,I as useFileInput,z as useGetFile,H as useGetFileList,j as useGetFileMeta,v as useHeadFile,J as useMultipartUpload,N as usePasteUpload,Q as usePatchChunk,W as usePutFile,Y as useRetry,_ as useRetryListener,ee as useTransformFile,oe as useTransformMetadata,se as useTusUpload,ue as useUpload};
+import{useAbortAll as o}from"../packem_shared/useAbortAll-DrHBz3kQ.js";import{useAbortBatch as s}from"../packem_shared/useAbortBatch-gVI48Gqa.js";import{useAbortItem as u}from"../packem_shared/useAbortItem-Blw0eI13.js";import{useAllAbortListener as f}from"../packem_shared/useAllAbortListener-DiliYPra.js";import{useBatchCancelledListener as a}from"../packem_shared/useBatchCancelledListener-CD0CULd_.js";import{useBatchDeleteFiles as i}from"../packem_shared/useBatchDeleteFiles-KthW4bon.js";import{useBatchErrorListener as h}from"../packem_shared/useBatchErrorListener-D-M1xGbQ.js";import{useBatchFinalizeListener as F}from"../packem_shared/useBatchFinalizeListener-BjnW3Lst.js";import{useBatchFinishListener as B}from"../packem_shared/useBatchFinishListener-DedP4Rm_.js";import{useBatchProgressListener as A}from"../packem_shared/useBatchProgressListener-CBAjGzmu.js";import{useBatchRetry as b}from"../packem_shared/useBatchRetry-C53msBuL.js";import{useBatchStartListener as R}from"../packem_shared/useBatchStartListener-BAOxxo1Y.js";import{useBatchUpload as C}from"../packem_shared/useBatchUpload-DLQNW410.js";import{useChunkedRestUpload as M}from"../packem_shared/useChunkedRestUpload-ByEGSmgy.js";import{useDeleteFile as k}from"../packem_shared/useDeleteFile-CND-6aNW.js";import{useFileInput as I}from"../packem_shared/useFileInput-hIbzJ_JN.js";import{useGetFile as z}from"../packem_shared/useGetFile-DvgluPgA.js";import{useGetFileList as H}from"../packem_shared/useGetFileList-D0tKDYAc.js";import{useGetFileMeta as j}from"../packem_shared/useGetFileMeta-Ekre98Sg.js";import{useHeadFile as v}from"../packem_shared/useHeadFile-CCu61b-B.js";import{useMultipartUpload as J}from"../packem_shared/useMultipartUpload-B9Vi7f5z.js";import{usePasteUpload as N}from"../packem_shared/usePasteUpload-_YqkCkrL.js";import{usePatchChunk as Q}from"../packem_shared/usePatchChunk-DoKsCbBH.js";import{usePutFile as W}from"../packem_shared/usePutFile-B6cFjClD.js";import{useRetry as Y}from"../packem_shared/useRetry-mkTUERYR.js";import{useRetryListener as _}from"../packem_shared/useRetryListener-B45dL00Q.js";import{useTransformFile as ee}from"../packem_shared/useTransformFile-sIkJLAwo.js";import{useTransformMetadata as oe}from"../packem_shared/useTransformMetadata-DK1561-K.js";import{useTusUpload as se}from"../packem_shared/useTusUpload-DQa9PgkZ.js";import{useUpload as ue}from"../packem_shared/useUpload-CpZQyE4g.js";export{o as useAbortAll,s as useAbortBatch,u as useAbortItem,f as useAllAbortListener,a as useBatchCancelledListener,i as useBatchDeleteFiles,h as useBatchErrorListener,F as useBatchFinalizeListener,B as useBatchFinishListener,A as useBatchProgressListener,b as useBatchRetry,R as useBatchStartListener,C as useBatchUpload,M as useChunkedRestUpload,k as useDeleteFile,I as useFileInput,z as useGetFile,H as useGetFileList,j as useGetFileMeta,v as useHeadFile,J as useMultipartUpload,N as usePasteUpload,Q as usePatchChunk,W as usePutFile,Y as useRetry,_ as useRetryListener,ee as useTransformFile,oe as useTransformMetadata,se as useTusUpload,ue as useUpload};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/storage-client",
-  "version": "1.0.0-alpha.7",
+  "version": "1.0.0-alpha.8",
   "description": "The upload client library. Simple and easy file uploads for React | Vue | Solid | Svelte.",
   "keywords": [
     "visulima",

package/dist/packem_shared/useChunkedRestUpload-cKHvYQN3.js

@@ -1 +0,0 @@
-var _=Object.defineProperty;var k=(c,a)=>_(c,"name",{value:a,configurable:!0});import{useState as u,useMemo as D,useRef as G,useEffect as b,useCallback as i}from"react";import{createChunkedRestAdapter as H}from"./createChunkedRestAdapter-Df1E_Adn.js";var J=Object.defineProperty,K=k((c,a)=>J(c,"name",{value:a,configurable:!0}),"k");const T=K(c=>{const{chunkSize:a,endpoint:h,maxRetries:E,metadata:R,onError:l,onPause:m,onProgress:p,onResume:S,onStart:v,onSuccess:P,retry:O}=c,[C,d]=u(0),[x,s]=u(!1),[U,t]=u(!1),[z,g]=u(void 0),[F,w]=u(void 0),[I,f]=u(0),e=D(()=>H({chunkSize:a,endpoint:h,maxRetries:E,metadata:R,retry:O}),[a,h,E,R,O]),o=G({onError:l,onPause:m,onProgress:p,onResume:S,onStart:v,onSuccess:P});b(()=>{o.current={onError:l,onPause:m,onProgress:p,onResume:S,onStart:v,onSuccess:P}},[l,p,m,S,v,P]),b(()=>{e.setOnStart(()=>{s(!0),t(!1),d(0),g(void 0),f(0),o.current.onStart?.()}),e.setOnProgress((r,y)=>{d(r),f(y),o.current.onProgress?.(r,y)}),e.setOnFinish(r=>{d(100),w(r),s(!1),t(!1),o.current.onSuccess?.(r)}),e.setOnError(r=>{g(r),s(!1),o.current.onError?.(r)});const n=setInterval(async()=>{f(await e.getOffset()),t(e.isPaused())},100);return()=>{clearInterval(n),e.setOnStart(void 0),e.setOnProgress(void 0),e.setOnFinish(void 0),e.setOnError(void 0)}},[e]);const j=i(async n=>{try{return await e.upload(n)}catch(r){throw r instanceof Error?r:new Error(String(r))}},[e]),A=i(()=>{e.pause(),t(!0),o.current.onPause?.()},[e]),M=i(async()=>{t(!1),s(!0),o.current.onResume?.();try{await e.resume()}catch(n){throw s(!1),n instanceof Error?n:new Error(String(n))}},[e]),q=i(()=>{e.abort(),s(!1),t(!1)},[e]),B=i(()=>{e.clear(),d(0),s(!1),t(!1),g(void 0),w(void 0),f(0)},[e]);return{abort:q,error:z,isPaused:U,isUploading:x,offset:I,pause:A,progress:C,reset:B,result:F,resume:M,upload:j}},"useChunkedRestUpload");export{T as useChunkedRestUpload};