@gentleduck/upload 0.2.2 → 0.2.4

package/dist/index.js

@@ -1,6 +1 @@
-import{jsxDEV as e}from"react/jsx-dev-runtime";import*as t from"react";import{createContext as n,useContext as r}from"react";const i=500,a=1e4,o=100,s=3,c=3,l=100;function u(e){return{maxConcurrentUploads:Math.max(1,e?.maxConcurrentUploads??3),autoStart:e?.autoStart,progressThrottleMs:Math.max(0,e?.progressThrottleMs??100),validation:e?.validation??{},maxAttempts:Math.max(1,e?.maxAttempts??3),retryPolicy:e?.retryPolicy,maxItems:Math.max(1,e?.maxItems??100),completedItemTTL:e?.completedItemTTL}}function d(){return`upload_${Date.now()}_${Math.random().toString(36).slice(2)}`}function f(e,t,n){let r=n.validation?.[t];if(!r)return null;if(e.size===0)return{code:`empty_file`};if(r.maxSizeBytes!==void 0&&e.size>r.maxSizeBytes)return{code:`file_too_large`,maxBytes:r.maxSizeBytes,size:e.size};if(r.minSizeBytes!==void 0&&e.size<r.minSizeBytes)return{code:`empty_file`};if(r.allowedTypes||r.allowedExtensions){let t=r.allowedTypes||[],n=r.allowedExtensions||[],i=e.name.split(`.`).pop()?.toLowerCase(),a=(e.type||``).toLowerCase(),o=t.length===0?!1:t.some(e=>{if(e.endsWith(`/*`)){let t=e.slice(0,-2).toLowerCase();return a.startsWith(t+`/`)}return a===e.toLowerCase()}),s=i&&n.length>0?n.some(e=>e.toLowerCase()===i):!1,c=t.length>0,l=n.length>0;if(!(c&&l?o||s:(!c||o)&&(!l||s)))return{code:`type_not_allowed`,allowed:[...t,...n],got:e.type||e.name}}return null}function p(e){return!!e&&typeof e==`object`}function m(e,t){if(!p(e))return Error(`Invalid intent: must be an object`);if(typeof e.strategy!=`string`)return Error(`Invalid intent: missing or invalid strategy field`);if(e.strategy!==t)return Error(`Invalid intent: strategy mismatch (expected ${t}, got ${e.strategy})`);if(typeof e.fileId!=`string`||!e.fileId)return Error(`Invalid intent: missing or invalid fileId`);if(t===`post`){if(typeof e.url!=`string`||!e.url)return Error(`Invalid post intent: missing or invalid url`);try{let t=new URL(e.url);if(![`http:`,`https:`].includes(t.protocol))return Error(`Invalid post intent: url must use http or https protocol`)}catch{return Error(`Invalid post intent: url is not a valid URL`)}if(!e.fields||typeof e.fields!=`object`)return Error(`Invalid post intent: missing or invalid fields`)}else if(t===`multipart`){if(typeof e.uploadId!=`string`||!e.uploadId)return Error(`Invalid multipart intent: missing or invalid uploadId`);if(typeof e.partSize!=`number`||e.partSize<=0)return Error(`Invalid multipart intent: missing or invalid partSize`);if(`parts`in e&&e.parts!==void 0&&!Array.isArray(e.parts))return Error(`Invalid multipart intent: parts must be an array if provided`)}return null}function h(e,t,n,r=0){let i=n.validation?.[t],a=[],o=[],s=i?.maxFiles,c=s===void 0?1/0:Math.max(0,s-r);for(let r of e){if(c<=0){let e=s??0;o.push({file:r,reason:{code:`too_many_files`,max:e}});continue}let e=f(r,t,n);if(e){o.push({file:r,reason:e});continue}a.push(r),--c}return{valid:a,rejected:o}}function g(e){return{name:e.name,size:e.size,type:e.type,lastModified:e.lastModified}}function _(e,t){return e.name===t.name&&e.size===t.size&&e.lastModified===t.lastModified}function v(e){return new Promise(t=>setTimeout(t,e))}async function ee(e){let t=await e.arrayBuffer(),n=await crypto.subtle.digest(`SHA-256`,t);return Array.from(new Uint8Array(n)).map(e=>e.toString(16).padStart(2,`0`)).join(``)}function te(e,t){let n=e.config?.autoStart;return n===void 0?!1:Array.isArray(n)?n.includes(t):typeof n==`function`?n(t):!1}function y(e,t){if(t)return t(e);if(ie(e))return{code:`aborted`,message:`Upload aborted`,reason:String(e.reason??`unknown`),retryable:!1};let n=p(e)&&typeof e.message==`string`?e.message:`Unknown error`;if(String(n).toLowerCase().includes(`network`)||String(n).toLowerCase().includes(`fetch`))return{code:`network`,message:String(n),cause:e,retryable:!0};if(p(e)&&(typeof e.status==`number`||typeof e.statusCode==`number`)){let t=typeof e.status==`number`?e.status:e.statusCode,r=t>=500||t===429;return{code:`http`,status:t,message:String(n),cause:e,retryable:r}}return{code:`unknown`,message:String(n),cause:e,retryable:!1}}function b(e){return`intent`in e&&!!e.intent}function ne(e){return`file`in e&&!!e.file}function x(e){return`cursor`in e}function re(e){return p(e)&&e.strategy===`multipart`&&typeof e.fileId==`string`&&typeof e.uploadId==`string`}function ie(e){return p(e)&&e.code===`aborted`}function S(e,t){if(e.retryPolicy)return e.retryPolicy(t);if(t.error.code===`auth`||t.error.code===`validation_failed`||t.error.code===`strategy_missing`||t.error.code===`aborted`)return{retryable:!1};let n=e.maxAttempts;return t.attempt<n?{retryable:!0,delayMs:Math.min(a,500*2**(t.attempt-1))}:{retryable:!1}}function ae(e,t,n){let r=Array.from(e.state.items.values()).filter(e=>e.purpose===n&&e.phase!==`canceled`).length,{valid:i,rejected:a}=h(t,n,e.opts.config,r);for(let{file:t,reason:n}of a)e.emitter.emit(`file.rejected`,{reason:n,file:t});let o=Date.now(),s=[];for(let t of i){let r=d(),i=(e.opts.fingerprint??g)(t);s.push({localId:r,purpose:n,file:t,fingerprint:i,createdAt:o}),e.enqueueEffect(async()=>{let a;try{a=await ee(t);let n={...i,checksum:a};e.applyInternal({type:`fingerprint.updated`,localId:r,fingerprint:n})}catch(e){typeof window<`u`&&process.env.NODE_ENV===`development`&&console.warn(`[UploadEngine] Failed to calculate checksum:`,e)}if(a&&e.opts.api.findByChecksum)try{let t=await e.opts.api.findByChecksum({checksum:a,purpose:n});if(t){let n=e.state.items.get(r);if(n&&n.phase===`validating`){e.applyInternal({type:`dedupe.ok`,localId:r,result:t});return}}}catch(e){typeof window<`u`&&process.env.NODE_ENV===`development`&&console.warn(`[UploadEngine] Failed to check for existing file:`,e)}let o=e.opts.validateFile?.(t,n);if(o){e.applyInternal({type:`validation.failed`,localId:r,reason:o});return}let s=f(t,n,e.opts.config);if(s){e.applyInternal({type:`validation.failed`,localId:r,reason:s});return}e.applyInternal({type:`validation.ok`,localId:r})})}s.length>0&&e.applyInternal({type:`files.added`,items:s})}function oe(e,t){let n=e.state.items.get(t),r=e.inflightIntents.get(t);r&&(r.abort({reason:`cancel`}),e.inflightIntents.delete(t));let i=e.inflightCompletes.get(t);i&&(i.abort({reason:`cancel`}),e.inflightCompletes.delete(t));let a=e.inflightUploads.get(t);if(a&&(a.mode=`cancel`,a.controller.abort({reason:`cancel`})),n&&b(n)&&n.intent.strategy===`multipart`&&e.opts.api.multipart?.abort){let t=n.intent;re(t)&&e.enqueueEffect(async()=>{try{let n=e.opts.api.multipart?.abort;n&&await n({fileId:t.fileId,uploadId:t.uploadId})}catch{}})}}function se(e,t){let n=e.inflightUploads.get(t);if(n){n.mode=`pause`,n.controller.abort({reason:`pause`});return}}function ce(e,t){if(t.type===`startAll`){let n=t.purpose;Array.from(e.state.items.values()).filter(e=>e.phase===`ready`&&(!n||e.purpose===n)).forEach(t=>e.dispatch({type:`start`,localId:t.localId}));return}if(t.type===`pauseAll`){let n=t.purpose;Array.from(e.state.items.values()).filter(e=>e.phase===`uploading`&&(!n||e.purpose===n)).forEach(t=>e.dispatch({type:`pause`,localId:t.localId}));return}if(t.type===`cancelAll`){let n=t.purpose;Array.from(e.state.items.values()).filter(e=>e.phase!==`completed`&&e.phase!==`canceled`&&(!n||e.purpose===n)).forEach(t=>e.dispatch({type:`cancel`,localId:t.localId}));return}if(t.type===`addFiles`){ae(e,t.files,t.purpose);return}if(t.type===`pause`){se(e,t.localId),e.applyCommand(t);return}if(t.type===`cancel`){oe(e,t.localId),e.applyCommand(t);return}if(t.type===`start`){e.applyCommand(t);return}if(t.type===`resume`){e.applyCommand(t);return}e.applyCommand(t)}function le(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function C(e){return e?.reason}function ue(e){if(!e)return`unknown`;if(typeof e==`string`)return e===`pause`||e===`cancel`?e:`unknown`;if(p(e)&&`reason`in e){let t=e.reason;if(t===`pause`||t===`cancel`)return t}if(p(e)&&`kind`in e){let t=e.kind;if(t===`pause`||t===`cancel`)return t}return`unknown`}var de=class extends Error{constructor(e){super(`Upload aborted`),le(this,`code`,`aborted`),le(this,`reason`,void 0),this.reason=ue(e)}};function w(e){return new de(e)}function fe(e,t){return e.status===0?Error(`CORS error: The upload server does not allow requests from this origin. Please check CORS configuration.`):Error(`${t} (status: ${e.status})`)}function pe(e){let t={};return e.getAllResponseHeaders().split(`\r
-`).map(e=>e.trim()).filter(Boolean).forEach(e=>{let n=e.indexOf(`:`);if(n<=0)return;let r=e.slice(0,n).trim().toLowerCase(),i=e.slice(n+1).trim();r&&(t[r]=i)}),t}function me(e){return/^https?:\/\//i.test(e)}function he(e){let t=e.getResponseHeader(`ETag`)??e.getResponseHeader(`etag`);if(t)return t.replace(/"/g,``)}function T(e){return new Promise((t,n)=>{if(!e.url||typeof e.url!=`string`){n(Error(`UploadTransport: missing url`));return}if(!me(e.url)){n(Error(`UploadTransport: expected absolute URL, got: ${String(e.url)}`));return}let r=new XMLHttpRequest,i=!1,a=e=>{i||(i=!0,s(),e())},o=()=>{try{r.abort()}finally{a(()=>n(w(C(e.signal))))}},s=()=>{e.signal&&e.signal.removeEventListener(`abort`,o),r.upload.onprogress=null,r.onload=null,r.onerror=null,r.onabort=null};if(e.signal?.aborted){a(()=>n(w(C(e.signal))));return}if(e.signal&&e.signal.addEventListener(`abort`,o,{once:!0}),e.onProgress&&(r.upload.onprogress=t=>{t.lengthComputable&&e.onProgress?.(t.loaded,t.total)}),r.onload=()=>{let e=r.status;a(e>=200&&e<300?()=>t({headers:pe(r),etag:he(r)}):()=>n(Error(`Upload failed with status ${e}`)))},r.onerror=()=>a(()=>n(fe(r,`Network error during upload`))),r.onabort=()=>a(()=>n(w(e.signal?.aborted?C(e.signal):`unknown`))),r.open(e.method,e.url),e.headers)for(let[t,n]of Object.entries(e.headers))r.setRequestHeader(t,n);r.send(e.body)})}function ge(){return{async postForm(e){let t=new FormData;for(let[n,r]of Object.entries(e.fields))t.append(n,r);return t.append(`file`,e.file,e.filename??`file`),{headers:(await T({method:`POST`,url:e.url,body:t,signal:e.signal,onProgress:e.onProgress})).headers}},async put(e){let t=await T({method:`PUT`,url:e.url,body:e.body,signal:e.signal,headers:e.headers,onProgress:e.onProgress});return{headers:t.headers,etag:t.etag}},async patch(e){return{headers:(await T({method:`PATCH`,url:e.url,body:e.body,signal:e.signal,headers:e.headers,onProgress:e.onProgress})).headers}}}}const E=`snapshots`;function D(){return new Promise((e,t)=>{let n=indexedDB.open(`upload-engine`,1);n.onupgradeneeded=()=>{let e=n.result;e.objectStoreNames.contains(E)||e.createObjectStore(E)},n.onsuccess=()=>e(n.result),n.onerror=()=>t(n.error)})}function _e(e){return new Promise((t,n)=>{e.onsuccess=()=>t(e.result),e.onerror=()=>n(e.error)})}function O(e){return new Promise((t,n)=>{e.oncomplete=()=>t(),e.onabort=()=>n(e.error??Error(`IndexedDB transaction aborted`)),e.onerror=()=>n(e.error??Error(`IndexedDB transaction error`))})}const ve={async load(e){if(typeof indexedDB>`u`)return null;let t=(await D()).transaction(E,`readonly`),n=t.objectStore(E);try{let r=await _e(n.get(e));return await O(t),r??null}catch{try{await O(t)}catch{}return null}},async save(e,t){if(typeof indexedDB>`u`)return;let n=(await D()).transaction(E,`readwrite`),r=n.objectStore(E);try{r.put(t,e),await O(n)}catch{try{n.abort()}catch{}}},async clear(e){if(typeof indexedDB>`u`)return;let t=(await D()).transaction(E,`readwrite`),n=t.objectStore(E);try{n.delete(e),await O(t)}catch{try{t.abort()}catch{}}}},ye={load(e){if(typeof localStorage>`u`)return null;let t=localStorage.getItem(e);if(!t)return null;try{return JSON.parse(t)}catch{return null}},save(e,t){typeof localStorage>`u`||localStorage.setItem(e,JSON.stringify(t))},clear(e){typeof localStorage>`u`||localStorage.removeItem(e)}},k=new Map,be={load(e){return k.get(e)??null},save(e,t){k.set(e,t)},clear(e){k.delete(e)}};function A(e,t){let n={};for(let t of e.items.values()){if(!b(t)||t.phase===`completed`||t.phase===`canceled`||t.phase===`error`)continue;let e=x(t)?t.cursor:void 0,r=`progress`in t&&t.progress?{uploadedBytes:t.progress.uploadedBytes,totalBytes:t.progress.totalBytes,pct:t.progress.pct}:void 0,i={id:t.localId,purpose:t.purpose,status:t.phase,file:{name:t.fingerprint.name,size:t.fingerprint.size,type:t.fingerprint.type,lastModified:t.fingerprint.lastModified,checksum:t.fingerprint.checksum},intent:t.intent,cursor:e,progress:r};n[i.id]=i}return{version:t,createdAt:Date.now(),items:n}}function j(e,t){if(!t.isPurpose||!t.isIntent||!xe(e))return null;let n=new Map;for(let r of Object.values(e.items)){let i=Se(r);if(!i||!t.isPurpose(i.purpose)||!t.isIntent(i.intent))continue;let a=i.intent.strategy;if(typeof a!=`string`||!t.hasStrategy(a)||!i.cursor||!we(i.cursor,t.hasStrategy)||i.cursor.strategy!==a)continue;let o=i.progress?.totalBytes??i.file.size,s=i.progress?.uploadedBytes??0,c=typeof i.progress?.pct==`number`?i.progress.pct:o>0?Math.min(100,Math.max(0,s/o*100)):0;n.set(i.id,{phase:`paused`,localId:i.id,purpose:i.purpose,fingerprint:{name:i.file.name,size:i.file.size,type:i.file.type,lastModified:i.file.lastModified,checksum:i.file.checksum},intent:i.intent,cursor:i.cursor,progress:{uploadedBytes:s,totalBytes:o,pct:c},pausedAt:Date.now(),createdAt:e.createdAt??Date.now(),file:void 0})}return{items:n}}function xe(e){return!p(e)||typeof e.version!=`number`||typeof e.createdAt!=`number`?!1:p(e.items)}function Se(e){if(!p(e))return null;let t=typeof e.id==`string`?e.id:null,n=typeof e.purpose==`string`?e.purpose:null,r=typeof e.status==`string`?e.status:null,i=e.intent;if(!t||!n||!r||!p(e.file))return null;let a=typeof e.file.name==`string`?e.file.name:null,o=typeof e.file.size==`number`?e.file.size:null,s=typeof e.file.type==`string`?e.file.type:null,c=typeof e.file.lastModified==`number`?e.file.lastModified:null,l=typeof e.file.checksum==`string`?e.file.checksum:void 0;if(!a||o===null||!s||c===null)return null;let u=Ce(e.progress);return{id:t,purpose:n,status:r,file:{name:a,size:o,type:s,lastModified:c,checksum:l},intent:i,cursor:e.cursor,progress:u}}function Ce(e){if(!p(e)||typeof e.uploadedBytes!=`number`||typeof e.totalBytes!=`number`)return;let t=typeof e.pct==`number`?e.pct:void 0;return{uploadedBytes:e.uploadedBytes,totalBytes:e.totalBytes,pct:t}}function we(e,t){return!(!p(e)||typeof e.strategy!=`string`||!t(e.strategy))}function M(){let e={};return{on(t,n){return(e[t]??(e[t]=new Set)).add(n),()=>{let r=e[t];r&&(r.delete(n),r.size===0&&delete e[t])}},off(t,n){let r=e[t];return r?(r.delete(n),r.size===0&&delete e[t],()=>{}):()=>{}},emit(t,n){let r=e[t];r&&r.forEach(e=>{try{e(n)}catch(e){typeof window<`u`&&process.env.NODE_ENV===`development`&&console.error(`[UploadEngine] Error in event listener for "${t}":`,e)}})}}}function N(){return function(e,t){let n=new Map(e.items),r=(e,t)=>n.set(e,t),i=Date.now();if((e=>`type`in e&&typeof e.type==`string`&&!e.type.includes(`.`))(t)){switch(t.type){case`addFiles`:break;case`start`:{let e=n.get(t.localId);if(!e||e.phase!==`ready`)break;r(t.localId,{...e,phase:`queued`,requestedAt:i});break}case`resume`:{let e=n.get(t.localId);if(!e||e.phase!==`paused`||!e.file)break;r(t.localId,{...e,file:e.file,phase:`queued`,requestedAt:i});break}case`pause`:{let e=n.get(t.localId);if(!e)break;e.phase===`queued`&&r(t.localId,{...e,phase:`ready`});break}case`cancel`:{let e=n.get(t.localId);if(!e||e.phase===`completed`||e.phase===`canceled`)break;r(t.localId,P(e,i));break}case`retry`:{let e=n.get(t.localId);if(!e||e.phase!==`error`||!e.retryable||!e.file)break;e.intent?e.progress&&e.progress.pct===100?r(t.localId,{...e,progress:e.progress,intent:e.intent,file:e.file,phase:`completing`,completingAt:i}):r(t.localId,{...e,file:e.file,intent:e.intent,phase:`ready`}):r(t.localId,{...e,phase:`creating_intent`,file:e.file,attempt:(e.attempt??1)+1});break}case`rebind`:{let e=n.get(t.localId);if(!e)break;e.phase===`paused`&&!e.file&&_(g(t.file),e.fingerprint)&&r(t.localId,{...e,file:t.file});break}case`remove`:n.delete(t.localId);break;case`startAll`:case`pauseAll`:case`cancelAll`:break}return{items:n}}switch(t.type){case`files.added`:{let e=t;for(let t of e.items)n.has(t.localId)||r(t.localId,{phase:`validating`,localId:t.localId,purpose:t.purpose,file:t.file,fingerprint:t.fingerprint,createdAt:t.createdAt});break}case`fingerprint.updated`:{let e=t,i=n.get(e.localId);if(!i)break;r(e.localId,{...i,fingerprint:e.fingerprint});break}case`validation.ok`:{let e=n.get(t.localId);if(!e||e.phase!==`validating`)break;r(t.localId,{...e,phase:`creating_intent`,attempt:1});break}case`validation.failed`:{let e=t,a=n.get(e.localId);if(!a||a.phase!==`validating`)break;r(e.localId,{...a,phase:`error`,error:{code:`validation_failed`,reason:e.reason,message:String(e.reason)},retryable:!1,attempt:1,failedAt:i});break}case`intent.ok`:{let e=t,i=n.get(e.localId);if(!i||i.phase!==`creating_intent`)break;r(e.localId,{...i,phase:`ready`,intent:e.intent});break}case`intent.failed`:{let e=t,a=n.get(e.localId);if(!a||a.phase!==`creating_intent`)break;r(e.localId,{...a,phase:`error`,error:e.error,retryable:e.retryable,failedAt:i});break}case`upload.begin`:{let e=t,i=n.get(e.localId);if(!i||i.phase!==`queued`)break;let a=i.file.size,o=i.progress,s=o?{...o,totalBytes:a,pct:Te(o.uploadedBytes,a)}:{uploadedBytes:0,totalBytes:a,pct:0};r(e.localId,{...i,phase:`uploading`,progress:s,startedAt:e.startedAt});break}case`upload.progress`:{let e=t,i=n.get(e.localId);if(!i||i.phase!==`uploading`)break;let a={uploadedBytes:e.uploadedBytes,totalBytes:e.totalBytes,pct:Te(e.uploadedBytes,e.totalBytes)};r(e.localId,{...i,progress:a});break}case`cursor.updated`:{let e=t,i=n.get(e.localId);if(!i)break;(i.phase===`uploading`||i.phase===`queued`||i.phase===`paused`)&&r(e.localId,{...i,cursor:e.cursor});break}case`upload.ok`:{let e=t,a=n.get(e.localId);if(!a||a.phase!==`uploading`)break;r(e.localId,{...a,phase:`completing`,progress:{uploadedBytes:a.file.size,totalBytes:a.file.size,pct:100},completingAt:i});break}case`upload.failed`:{let e=t,a=n.get(e.localId);if(!a||a.phase!==`uploading`)break;r(e.localId,{...a,phase:`error`,error:e.error,retryable:e.retryable,attempt:1,failedAt:i});break}case`paused`:{let e=t,i=n.get(e.localId);if(!i||i.phase!==`uploading`)break;r(e.localId,{...i,phase:`paused`,cursor:e.cursor,pausedAt:e.pausedAt});break}case`canceled`:{let e=t,i=n.get(e.localId);if(!i)break;r(e.localId,P(i,e.canceledAt));break}case`complete.ok`:{let e=t,a=n.get(e.localId);if(!a||a.phase!==`completing`)break;r(e.localId,{...a,phase:`completed`,completedBy:`upload`,result:e.result,completedAt:i});break}case`dedupe.ok`:{let e=t,a=n.get(e.localId);if(!a||a.phase!==`validating`)break;r(e.localId,{phase:`completed`,localId:a.localId,file:a.file,purpose:a.purpose,fingerprint:a.fingerprint,result:e.result,completedBy:`dedupe`,completedAt:i,createdAt:a.createdAt});break}case`complete.failed`:{let e=t,a=n.get(e.localId);if(!a||a.phase!==`completing`)break;let o=(a.attempt??1)+1;r(e.localId,{...a,phase:`error`,error:e.error,retryable:e.retryable,attempt:o,failedAt:i});break}}return{items:n}}}function P(e,t){return{phase:`canceled`,localId:e.localId,purpose:e.purpose,fingerprint:e.fingerprint,canceledAt:t,createdAt:e.createdAt,file:`file`in e?e.file:void 0,intent:`intent`in e?e.intent:void 0,cursor:`cursor`in e?e.cursor:void 0,progress:`progress`in e?e.progress:void 0,attempt:`attempt`in e?e.attempt:void 0}}function Te(e,t){return t<=0?0:Math.min(100,e/t*100)}function Ee(e,t){let n=e.config?.maxItems,r=e.config?.completedItemTTL,i=Date.now(),a=[],o=Array.from(t.items.entries());if(r!==void 0)for(let[e,t]of o)((t.phase===`completed`||t.phase===`canceled`)&&`completedAt`in t&&typeof t.completedAt==`number`&&i-t.completedAt>r||t.phase===`canceled`&&`canceledAt`in t&&typeof t.canceledAt==`number`&&i-t.canceledAt>r)&&a.push(e);let s=o.filter(([e])=>!a.includes(e));if(n!==void 0&&s.length>n){let e=s.filter(([,e])=>e.phase===`completed`||e.phase===`canceled`).sort(([,e],[,t])=>(`completedAt`in e?e.completedAt:`canceledAt`in e?e.canceledAt:0)-(`completedAt`in t?t.completedAt:`canceledAt`in t?t.canceledAt:0)),t=s.length-n;for(let n=0;n<t&&n<e.length;n++)a.push(e[n][0])}if(a.length===0)return null;let c=new Map(t.items);for(let e of a)c.delete(e);return{...t,items:c}}async function De(e,t){let n=e.state.items.get(t);if(!n||n.phase!==`creating_intent`||e.inflightIntents.has(t))return;let r=new AbortController;e.inflightIntents.set(t,r);try{let i=await e.opts.api.createIntent({purpose:n.purpose,contentType:n.file.type||`application/octet-stream`,size:n.file.size,filename:n.file.name,checksum:n.fingerprint.checksum},{signal:r.signal});e.inflightIntents.delete(t);let a=e.state.items.get(t);if(!a||a.phase!==`creating_intent`)return;let o=m(i,i.strategy);if(o){let n={code:`validation_failed`,message:`Invalid intent from backend: ${o.message}`,cause:o,retryable:!1};e.applyInternal({type:`intent.failed`,localId:t,error:n,retryable:!1});return}e.applyInternal({type:`intent.ok`,localId:t,intent:i})}catch(i){if(e.inflightIntents.delete(t),r.signal.aborted)return;let a=y(i,e.opts.errorNormalizer),o={...a,message:`${a.message} (file: ${n.fingerprint.name}, size: ${n.file.size} bytes, purpose: ${n.purpose})`},s=S(e.opts.config,{phase:`intent`,attempt:n.attempt,error:o});e.applyInternal({type:`intent.failed`,localId:t,error:o,retryable:s.retryable}),s.retryable&&s.delayMs!==void 0&&e.enqueueEffect(async()=>{await v(s.delayMs),e.dispatch({type:`retry`,localId:t})})}}async function Oe(e,t){let n=e.state.items.get(t);if(!n||n.phase!==`completing`||e.inflightCompletes.has(t))return;let r=new AbortController;e.inflightCompletes.set(t,r);try{let i=await e.opts.api.complete({fileId:n.intent.fileId},{signal:r.signal});e.inflightCompletes.delete(t);let a=e.state.items.get(t);if(!a||a.phase!==`completing`)return;e.applyInternal({type:`complete.ok`,localId:t,result:i})}catch(n){if(e.inflightCompletes.delete(t),r.signal.aborted)return;let i=y(n,e.opts.errorNormalizer),a=e.state.items.get(t),o=a?{...i,message:`${i.message} (file: ${a.fingerprint.name}, fileId: ${(b(a)&&a.intent?.fileId)??`unknown`})`}:i,s=a&&`attempt`in a?a.attempt??1:1,c=S(e.opts.config,{phase:`complete`,attempt:s,error:o});e.applyInternal({type:`complete.failed`,localId:t,error:o,retryable:c.retryable}),c.retryable&&c.delayMs!==void 0&&e.enqueueEffect(async()=>{await v(c.delayMs),e.dispatch({type:`retry`,localId:t})})}}async function ke(e,t){let n=e.state.items.get(t);if(!n||n.phase!==`uploading`||!b(n)){e.inflightUploads.delete(t);return}let r=e.inflightUploads.get(t);if(r||(r={controller:new AbortController,mode:`normal`,started:!1},e.inflightUploads.set(t,r)),r.started)return;r.started=!0;let i=r.controller,a=()=>{let n=e.state.items.get(t);!n||n.phase===`canceled`||e.applyInternal({type:`canceled`,localId:t,canceledAt:Date.now()})},o=n=>{let r=e.state.items.get(t);!r||r.phase===`paused`||e.applyInternal({type:`paused`,localId:t,cursor:n,pausedAt:Date.now()})};if(i.signal.aborted){if(e.inflightUploads.delete(t),r.mode===`pause`){let r=e.state.items.get(t),i;n&&b(n)&&(i=n.intent.strategy);let a=(r&&x(r)?r.cursor:void 0)||(i?{strategy:i,value:void 0}:void 0);a&&o(a);return}if(r.mode===`cancel`){a();return}return}let s=n.intent.strategy;if(!e.opts.strategies.has(s)){e.inflightUploads.delete(t);let n={code:`strategy_missing`,message:`Strategy not found: ${s}`,strategy:String(s),retryable:!1};e.applyInternal({type:`upload.failed`,localId:t,error:n,retryable:!1});return}let c=e.opts.strategies.get(s);if(!c){e.inflightUploads.delete(t);let r={code:`strategy_missing`,message:`Strategy not found: ${n.intent.strategy}`,strategy:String(n.intent.strategy),retryable:!1};e.applyInternal({type:`upload.failed`,localId:t,error:r,retryable:!1});return}let l=0,u=e.opts.config.progressThrottleMs;try{if(await c.start({file:n.file,intent:n.intent,signal:i.signal,transport:e.opts.transport,api:e.opts.api,readCursor:()=>{let n=e.state.items.get(t);if(!(!n||!x(n)||!n.cursor)&&n.cursor.strategy===s)return n.cursor.value},persistCursor:n=>{let r={strategy:s,value:n};e.applyInternal({type:`cursor.updated`,localId:t,cursor:r})},reportProgress:n=>{let r=Date.now();r-l<u||(e.applyInternal({type:`upload.progress`,localId:t,uploadedBytes:n.uploadedBytes,totalBytes:n.totalBytes}),l=r)}}),e.inflightUploads.delete(t),r?.mode===`cancel`){a();return}if(i.signal.aborted&&r?.mode===`pause`){let n=e.state.items.get(t);o((n&&x(n)?n.cursor:void 0)||{strategy:s,value:void 0});return}e.applyInternal({type:`upload.ok`,localId:t})}catch(n){if(e.inflightUploads.delete(t),i.signal.aborted){if(r?.mode===`pause`){let n=e.state.items.get(t);o((n&&x(n)?n.cursor:void 0)||{strategy:s,value:void 0});return}if(r?.mode===`cancel`){a();return}a();return}let c=y(n,e.opts.errorNormalizer),l=e.state.items.get(t),u=l?{...c,message:`${c.message} (file: ${l.fingerprint.name}, size: ${(ne(l)&&l.file?.size)??0} bytes, phase: ${l.phase})`}:c,d=S(e.opts.config,{phase:`upload`,attempt:1,error:u});e.applyInternal({type:`upload.failed`,localId:t,error:u,retryable:d.retryable}),d.retryable&&d.delayMs!==void 0&&e.enqueueEffect(async()=>{await v(d.delayMs),e.dispatch({type:`retry`,localId:t})})}}function Ae(e){if(!e.scheduling){e.scheduling=!0;try{je(e),Ne(e),Me(e)}finally{e.scheduling=!1}}}function je(e){for(let t of e.state.items.values())t.phase===`creating_intent`&&(e.inflightIntents.has(t.localId)||e.enqueueEffect(()=>De(e,t.localId)))}function Me(e){for(let t of e.state.items.values())t.phase===`completing`&&(e.inflightCompletes.has(t.localId)||e.enqueueEffect(()=>Oe(e,t.localId)))}function Ne(e){let t=Math.max(1,e.opts.config.maxConcurrentUploads),n=e.inflightUploads.size;for(let t of e.state.items.values())t.phase===`ready`&&te(e.opts,t.purpose)&&e.applyCommand({type:`start`,localId:t.localId});if(n>=t)return;let r=Array.from(e.state.items.values()).filter(Pe);if(r.length===0)return;let i=Math.max(0,t-n),a=r.slice(0,i);for(let t of a){if(e.inflightUploads.has(t.localId))continue;let n=new AbortController;e.inflightUploads.set(t.localId,{controller:n,mode:`normal`,started:!1}),e.applyInternal({type:`upload.begin`,localId:t.localId,startedAt:Date.now()}),ke(e,t.localId)}}function Pe(e){return e.phase===`queued`}function Fe(e){let t=Ie(e),n=t.persistence,r=null,i=Math.max(0,n?.debounceMs??200),a=async()=>{if(n)try{let e=(n.serialize??A)(s.state,n.version);if(!e.items||Object.keys(e.items).length===0){await n.adapter.clear(n.key);return}await n.adapter.save(n.key,e)}catch(e){typeof window<`u`&&process.env.NODE_ENV===`development`&&console.warn(`[UploadEngine] persistence flush failed:`,e)}},o=()=>{if(n){if(i===0){a();return}r&&clearTimeout(r),r=setTimeout(()=>void a(),i)}},s={opts:t,state:t.initialState??{items:new Map},listeners:new Set,emitter:M(),reduce:N(),inflightUploads:new Map,inflightIntents:new Map,inflightCompletes:new Map,effectQueue:[],processingEffects:!1,scheduling:!1,notify(){s.listeners.forEach(e=>e())},scheduleWork(){Ae(s)},applyInternal(e){let t=s.state;s.state=s.reduce(t,e),s.opts.hooks?.onInternalEvent?.(e,s.state),Le(s,e);let n=Ee(s.opts,s.state);n&&(s.state=n),o(),s.notify(),s.scheduleWork()},applyCommand(e){let t=s.state,n=s.reduce(t,e);s.state=n,Re(s,e,t,n);let r=Ee(s.opts,s.state);r&&(s.state=r),o(),s.notify(),s.scheduleWork()},enqueueEffect(e){s.effectQueue.push(e),s.processingEffects||s.processEffects()},async processEffects(){for(s.processingEffects=!0;s.effectQueue.length>0;){let e=s.effectQueue.shift();if(e)try{await e()}catch(e){if(typeof window<`u`&&process.env.NODE_ENV===`development`){let t=e instanceof Error?e:Error(String(e)),n={queueLength:s.effectQueue.length,processing:s.processingEffects,timestamp:new Date().toISOString()};console.error(`[UploadEngine] Effect error:`,t,n)}}}s.processingEffects=!1},dispatch:()=>{throw Error(`[UploadEngine] dispatch not initialized`)}};if(n&&!t.initialState&&typeof window<`u`)try{let e=n.adapter.load(n.key);Promise.resolve(e).then(e=>{if(!e)return;let r=(n.deserialize??j)(e,{isPurpose:n.isPurpose,isIntent:n.isIntent,hasStrategy:t.strategies.has});if(r){if(s.state.items.size===0)s.state=r;else{let e=new Map(s.state.items);for(let[t,n]of r.items.entries())e.has(t)||e.set(t,n);s.state={...s.state,items:e}}s.notify(),s.scheduleWork()}}).catch(()=>void 0)}catch{}return s}function Ie(e){return{...e,config:u(e.config),transport:e.transport??ge()}}function Le(e,t){switch(t.type){case`files.added`:for(let n of t.items)e.emitter.emit(`file.added`,{localId:n.localId,purpose:n.purpose,file:n.file,fingerprint:n.fingerprint});break;case`validation.ok`:e.emitter.emit(`validation.ok`,{localId:t.localId}),e.emitter.emit(`intent.creating`,{localId:t.localId});break;case`validation.failed`:e.emitter.emit(`validation.failed`,{localId:t.localId,reason:t.reason});break;case`intent.ok`:e.emitter.emit(`intent.created`,{localId:t.localId,intent:t.intent});break;case`intent.failed`:e.emitter.emit(`intent.failed`,{localId:t.localId,error:t.error,retryable:t.retryable});break;case`upload.begin`:e.emitter.emit(`upload.started`,{localId:t.localId});break;case`upload.progress`:{let n=t.totalBytes>0?Math.min(100,t.uploadedBytes/t.totalBytes*100):0;e.emitter.emit(`upload.progress`,{localId:t.localId,pct:n,uploadedBytes:t.uploadedBytes,totalBytes:t.totalBytes});break}case`cursor.updated`:e.emitter.emit(`upload.cursor`,{localId:t.localId,cursor:t.cursor});break;case`upload.ok`:e.emitter.emit(`upload.completing`,{localId:t.localId});break;case`upload.failed`:e.emitter.emit(`upload.error`,{localId:t.localId,error:t.error,retryable:t.retryable});break;case`dedupe.ok`:e.emitter.emit(`upload.completed`,{localId:t.localId,result:t.result,completedBy:`dedupe`});break;case`complete.ok`:e.emitter.emit(`upload.completed`,{localId:t.localId,result:t.result,completedBy:`upload`});break;case`complete.failed`:e.emitter.emit(`upload.error`,{localId:t.localId,error:t.error,retryable:t.retryable});break;case`paused`:e.emitter.emit(`upload.paused`,{localId:t.localId,cursor:t.cursor});break;case`canceled`:e.emitter.emit(`upload.canceled`,{localId:t.localId});break;case`fingerprint.updated`:break}}function Re(e,t,n,r){if(t.type===`start`||t.type===`resume`){let i=n.items.get(t.localId),a=r.items.get(t.localId);if(!i||!a||a.phase!==`queued`)return;i.phase===`paused`?e.emitter.emit(`upload.resumed`,{localId:t.localId}):e.emitter.emit(`upload.queued`,{localId:t.localId})}if(t.type===`cancel`){let i=n.items.get(t.localId),a=r.items.get(t.localId);if(!i||!a)return;a.phase===`canceled`&&i.phase!==`canceled`&&e.emitter.emit(`upload.canceled`,{localId:t.localId})}}function ze(e){let t=Fe(e);t.dispatch=e=>ce(t,e);let n={on:t.emitter.on.bind(t.emitter),off:t.emitter.off.bind(t.emitter),dispatch:t.dispatch,getSnapshot:()=>t.state};for(let t of e.plugins||[])try{t.setup(n)}catch(e){typeof window<`u`&&process.env.NODE_ENV===`development`&&console.error(`[UploadEngine] Plugin "${t.name}" failed to setup:`,e)}return{...n,subscribe:e=>(t.listeners.add(e),()=>t.listeners.delete(e)),waitFor(e){return Be(t,e)}}}function Be(e,t){if(t.length===0)return Promise.resolve([]);let n=new Set(t),r=new Map,i=()=>{for(let t of n){let i=e.state.items.get(t);if(!i){r.set(t,{localId:t,status:`missing`}),n.delete(t);continue}if(i.phase===`completed`){r.set(t,{localId:t,status:`completed`,completedBy:i.completedBy,result:i.result}),n.delete(t);continue}if(i.phase===`error`){r.set(t,{localId:t,status:`error`,error:i.error}),n.delete(t);continue}i.phase===`canceled`&&(r.set(t,{localId:t,status:`canceled`}),n.delete(t))}};return i(),n.size===0?Promise.resolve(t.map(e=>r.get(e)??{localId:e,status:`missing`})):new Promise(a=>{let o=()=>{i(),n.size===0&&(e.listeners.delete(o),a(t.map(e=>r.get(e)??{localId:e,status:`missing`})))};e.listeners.add(o)})}function Ve(e){return ze(e)}
-/*! Copyright (c) Meta Platforms, Inc. and affiliates. **/
-const F=Symbol.for(`react.forward_ref`),I=Symbol.for(`react.memo`);let He=new Map,Ue=new WeakMap,L=new WeakMap;const R=new WeakMap;let z=[];const We=new Map,Ge=new Map,Ke=new Set,qe=new Set;let B=new WeakMap,V=!1;function H(e){if(e.fullKey!==null)return e.fullKey;let t=e.ownKey,n;try{n=e.getCustomHooks()}catch{return e.forceReset=!0,e.fullKey=t,t}for(let r=0;r<n.length;r++){let i=n[r];if(typeof i!=`function`)return e.forceReset=!0,e.fullKey=t,t;let a=L.get(i);if(a===void 0)continue;let o=H(a);a.forceReset&&(e.forceReset=!0),t+=`
----
-`+o}return e.fullKey=t,t}function Je(e,t){let n=L.get(e),r=L.get(t);return n===void 0&&r===void 0?!0:!(n===void 0||r===void 0||H(n)!==H(r)||r.forceReset)}function Ye(e){return e.prototype&&e.prototype.isReactComponent}function Xe(e,t){return Ye(e)||Ye(t)?!1:!!Je(e,t)}function Ze(e){return R.get(e)}function U(e,t){try{return e[t]}catch{return}}function Qe(){if(z.length===0||V)return null;V=!0;try{let e=new Set,t=new Set,n=z;z=[],n.forEach(([n,r])=>{let i=n.current;R.set(i,n),R.set(r,n),n.current=r,Xe(i,r)?t.add(n):e.add(n)});let r={updatedFamilies:t,staleFamilies:e};We.forEach(e=>{e.setRefreshHandler(Ze)});let i=!1,a=null,o=new Set(qe),s=new Set(Ke),c=new Map(Ge);if(o.forEach(e=>{let t=c.get(e);if(t===void 0)throw Error(`Could not find helpers for a root. This is a bug in React Refresh.`);if(qe.has(e),B===null||!B.has(e))return;let n=B.get(e);try{t.scheduleRoot(e,n)}catch(e){i||(i=!0,a=e)}}),s.forEach(e=>{let t=c.get(e);if(t===void 0)throw Error(`Could not find helpers for a root. This is a bug in React Refresh.`);Ke.has(e);try{t.scheduleRefresh(e,r)}catch(e){i||(i=!0,a=e)}}),i)throw a;return r}finally{V=!1}}function W(e,t){if(e===null||typeof e!=`function`&&typeof e!=`object`||Ue.has(e))return;let n=He.get(t);if(n===void 0?(n={current:e},He.set(t,n)):z.push([n,e]),Ue.set(e,n),typeof e==`object`&&e)switch(U(e,`$$typeof`)){case F:W(e.render,t+`$render`);break;case I:W(e.type,t+`$type`);break}}function G(e,t,n,r){if(L.has(e)||L.set(e,{forceReset:n,ownKey:t,fullKey:null,getCustomHooks:r||(()=>[])}),typeof e==`object`&&e)switch(U(e,`$$typeof`)){case F:G(e.render,t,n,r);break;case I:G(e.type,t,n,r);break}}function $e(e){let t=L.get(e);t!==void 0&&H(t)}function et(){let e,t,n=!1;return function(r,i,a,o){if(typeof i==`string`)return e||(e=r,t=typeof o==`function`),r!=null&&(typeof r==`function`||typeof r==`object`)&&G(r,i,a,o),r;!n&&t&&(n=!0,$e(e))}}function K(e){switch(typeof e){case`function`:{if(e.prototype!=null){if(e.prototype.isReactComponent)return!0;let t=Object.getOwnPropertyNames(e.prototype);if(t.length>1||t[0]!==`constructor`||e.prototype.__proto__!==Object.prototype)return!1}let t=e.name||e.displayName;return typeof t==`string`&&/^[A-Z]/.test(t)}case`object`:if(e!=null)switch(U(e,`$$typeof`)){case F:case I:return!0;default:return!1}return!1;default:return!1}}function tt(e){if(!nt(e))return!1;for(let t in e)if(!K(e[t]))return!1;return!0}function nt(e){return Object.prototype.toString.call(e)===`[object Object]`&&(e.constructor===Object||e.constructor===void 0)}function rt(e){return(t,n)=>W(t,e+` `+n)}function it(e,t){for(let n in t){if(n===`__esModule`)continue;let r=t[n];if(K(r))W(r,e+` export `+n);else if(tt(r))for(let t in r)W(r[t],e+` export `+n+`-`+t)}}function at(e,t){let n;return()=>{clearTimeout(n),n=setTimeout(e,t)}}const q=[];window.__registerBeforePerformReactRefresh=e=>{q.push(e)};const ot=at(async()=>{q.length&&await Promise.all(q.map(e=>e())),Qe()},16);function st(e,t,n){let r=window.__getReactRefreshIgnoredExports?.({id:e})??[];if(J(r,t,e=>e in n)!==!0)return`Could not Fast Refresh (export removed)`;if(J(r,n,e=>e in t)!==!0)return`Could not Fast Refresh (new export)`;let i=!1,a=J(r,n,(e,r)=>(i=!0,K(r)||tt(r)?!0:t[e]===n[e]));if(i&&a===!0)ot();else return`Could not Fast Refresh ("${a}" export is incompatible). Learn more at https://github.com/vitejs/vite-plugin-react/tree/main/packages/plugin-react-swc#consistent-components-exports`}function J(e,t,n){for(let r in t){if(r===`__esModule`||e.includes(r))continue;let i=Object.getOwnPropertyDescriptor(t,r);if(i&&i.get||!n(r,t[r]))return r}return!0}const ct=e=>import(e),Y=typeof WorkerGlobalScope<`u`&&self instanceof WorkerGlobalScope;let lt,ut;if(import.meta.hot&&!Y){if(!window.$RefreshReg$)throw Error(`@vitejs/plugin-react-swc can't detect preamble. Something is wrong.`);lt=window.$RefreshReg$,ut=window.$RefreshSig$,window.$RefreshReg$=rt(`/home/runner/work/duck-upload/duck-upload/packages/duck-upload/src/react/upload-provider.tsx`),window.$RefreshSig$=et}var dt=$RefreshSig$();const ft=n(null);function pt({store:t,children:n}){return e(ft.Provider,{value:t,children:n},void 0,!1,{fileName:`/home/runner/work/duck-upload/duck-upload/packages/duck-upload/src/react/upload-provider.tsx`,lineNumber:52,columnNumber:10},this)}Z=pt;function X(){dt();let e=r(ft);if(!e||!mt(e))throw Error(`useUploadStore must be used within UploadProvider`);return e}dt(X,`Wl1jJrZzTCxjtMcqth/dX4wg3Uo=`);function mt(e){return p(e)?typeof e.getSnapshot==`function`&&typeof e.subscribe==`function`&&typeof e.dispatch==`function`&&typeof e.on==`function`&&typeof e.off==`function`&&typeof e.waitFor==`function`:!1}var Z;$RefreshReg$(Z,`UploadProvider`),import.meta.hot&&!Y&&(window.$RefreshReg$=lt,window.$RefreshSig$=ut),import.meta.hot&&!Y&&ct(import.meta.url).then(e=>{it(`/home/runner/work/duck-upload/duck-upload/packages/duck-upload/src/react/upload-provider.tsx`,e),import.meta.hot.accept(t=>{if(!t)return;let n=st(`/home/runner/work/duck-upload/duck-upload/packages/duck-upload/src/react/upload-provider.tsx`,e,t);n&&import.meta.hot.invalidate(n)})});var ht=$RefreshSig$(),gt=$RefreshSig$();function _t(e){var t=$RefreshSig$();return t(()=>(t(),Q(e)),`koxc0gANW1Ok/JXE6Hee4XqLL8g=`,!1,function(){return[Q]})}function Q(e){ht();let n=e??X(),r=t.useSyncExternalStore(n.subscribe.bind(n),n.getSnapshot.bind(n),n.getSnapshot.bind(n)),i=t.useMemo(()=>Array.from(r.items.values()),[r.items]),a=t.useMemo(()=>{let e={};return i.forEach(t=>{e[t.phase]||(e[t.phase]=[]),e[t.phase].push(t)}),e},[i]);return{items:i,byPhase:a,dispatch:n.dispatch.bind(n),on:n.on.bind(n),off:n.off.bind(n),uploading:a.uploading||[],paused:a.paused||[],completed:a.completed||[],failed:a.error||[],ready:a.ready||[]}}ht(Q,`2QiAcG9/Y3tKduRxVnmpacwTbRk=`,!1,function(){return[X]});function $(){gt();let e=X();return{dispatch:t.useMemo(()=>e.dispatch.bind(e),[e]),on:t.useMemo(()=>e.on.bind(e),[e]),store:e}}gt($,`mmC0pzXKvfZAl3ye5rFLChFGvco=`,!1,function(){return[X]});function vt(e){return e instanceof Error&&(e.name===`AbortError`||/abort/i.test(e.message))}function yt(e){let t=Math.max(1,e?.maxPartConcurrency??4);return{id:`multipart`,resumable:!0,async start(e){let n=e.intent,r=e.file.size,i=Math.max(1,n.partSize),a=Math.max(1,n.partCount??Math.ceil(r/i)),o=e.readCursor(),s=new Map;if(o?.done)for(let e of o.done)s.set(e.partNumber,{etag:e.etag,size:e.size});let c=o?.completed===!0,l=new Map,u=0;for(let e of s.values())u+=e.size;let d=()=>{let t=0;for(let e of l.values())t+=e;e.reportProgress({uploadedBytes:u+t,totalBytes:r})},f=[];for(let e=1;e<=a;e++){if(s.has(e))continue;let t=(e-1)*i,n=Math.min(r,t+i);f.push({partNumber:e,start:t,end:n})}if(f.length===0){c||await _(),d();return}let p=f.slice(),m=new Set,h=async t=>{let r=n.parts?.find(e=>e.partNumber===t);if(r)return r;if(!e.api.multipart?.signPart)throw Error(`multipart.signPart is missing in UploadApi. Implement it to call your backend sign-part endpoint.`);let i=await e.api.multipart.signPart({fileId:n.fileId,uploadId:n.uploadId,partNumber:t},{signal:e.signal});return{partNumber:t,url:i.url,headers:i.headers}},g=async(t,n=0)=>{try{let n=e.file.slice(t.start,t.end),r=n.size,i=await h(t.partNumber),a=await e.transport.put({url:i.url,body:n,headers:i.headers,signal:e.signal,onProgress:e=>{l.set(t.partNumber,e),d()}});l.delete(t.partNumber);let o=a.etag;if(!o)throw Error(`Missing ETag from upload part response. Ensure MinIO/S3 CORS exposes ETag (Access-Control-Expose-Headers: ETag).`);u+=r,s.set(t.partNumber,{etag:o,size:r});let c={done:Array.from(s.entries()).map(([e,t])=>({partNumber:e,etag:t.etag,size:t.size})).sort((e,t)=>e.partNumber-t.partNumber)};e.persistCursor(c),d()}catch(r){if(l.delete(t.partNumber),e.signal?.aborted||vt(r))throw r;if(n<3){let e=r instanceof Error?r.message:String(r);if(/network/i.test(e)||/timeout/i.test(e)||/5\d\d/.test(e)||/ECONNRESET/i.test(e)||/EHOSTUNREACH/i.test(e))return await v(2**n*500),g(t,n+1)}throw r}};for(;p.length>0||m.size>0;){for(;p.length>0&&m.size<t;){let e=p.shift();if(!e)break;let t,n=g(e).finally(()=>{t&&m.delete(t)});t=n,m.add(n)}m.size>0&&await Promise.race(m)}await _(),d();async function _(){if(c)return;if(!e.api.multipart?.completeMultipart)throw Error(`multipart.completeMultipart is missing in UploadApi. Implement it to call your backend complete endpoint.`);let t=Array.from(s.entries()).map(([e,t])=>({partNumber:e,etag:t.etag})).sort((e,t)=>e.partNumber-t.partNumber);if(t.length!==a)throw Error(`Cannot complete multipart: expected ${a} parts, got ${t.length}`);await e.api.multipart.completeMultipart({fileId:n.fileId,uploadId:n.uploadId,parts:t},{signal:e.signal});let r={done:Array.from(s.entries()).map(([e,t])=>({partNumber:e,etag:t.etag,size:t.size})).sort((e,t)=>e.partNumber-t.partNumber),completed:!0};e.persistCursor(r)}}}}function bt(){return{id:`post`,resumable:!1,async start(e){let t=e.intent;if(!t.url)throw Error(`Direct strategy: intent missing url/uploadUrl`);await e.transport.postForm({url:t.url,file:e.file,fields:t.fields,filename:e.file.name,signal:e.signal,onProgress(t,n){e.reportProgress({uploadedBytes:t,totalBytes:n})}})}}}function xt(){let e={};return{get(t){return e[t]},has(t){return Object.hasOwn(e,t)},set(t){e[t.id]=t}}}export{s as DEFAULT_MAX_ATTEMPTS,c as DEFAULT_MAX_CONCURRENT_UPLOADS,l as DEFAULT_MAX_ITEMS,o as DEFAULT_PROGRESS_THROTTLE_MS,i as DEFAULT_RETRY_DELAY_BASE_MS,a as DEFAULT_RETRY_DELAY_MAX_MS,ve as IndexedDBAdapter,ye as LocalStorageAdapter,be as MemoryAdapter,bt as PostStrategy,pt as UploadProvider,g as computeFingerprint,N as createReducer,xt as createStrategyRegistry,M as createTypedEmitter,Ve as createUploadClient,_t as createUploadFactory,ze as createUploadStore,ge as createXHRTransport,j as deserializeSnapshot,_ as fingerprintMatches,d as generateId,p as isRecord,yt as multipartStrategy,u as resolveUploadConfig,A as serializeSnapshot,v as sleep,X as useUploadStore,Q as useUploader,$ as useUploaderActions,f as validateFile,h as validateFileList,m as validateIntent};
+import{C as e,S as t,_ as n,a as r,b as i,c as a,d as o,f as s,g as c,h as l,i as u,l as d,m as f,n as p,o as m,p as h,r as g,s as _,t as v,u as y,v as b,w as x,x as S,y as C}from"./core-BNxznRif.js";import{t as w}from"./async-DxRWu4le.js";import{UploadProvider as T,createUploadFactory as E,useOptionalUploadStore as D,useUploadStore as O,useUploader as k,useUploaderActions as A}from"./react/index.js";import{PostStrategy as j,createStrategyRegistry as M,multipartStrategy as N}from"./strategies/index.js";export{C as DEFAULT_MAX_ATTEMPTS,i as DEFAULT_MAX_CONCURRENT_UPLOADS,S as DEFAULT_MAX_ITEMS,t as DEFAULT_PROGRESS_THROTTLE_MS,e as DEFAULT_RETRY_DELAY_BASE_MS,x as DEFAULT_RETRY_DELAY_MAX_MS,d as IndexedDBAdapter,a as LocalStorageAdapter,_ as MemoryAdapter,j as PostStrategy,T as UploadProvider,o as computeFingerprint,g as createReducer,M as createStrategyRegistry,u as createTypedEmitter,v as createUploadClient,E as createUploadFactory,p as createUploadStore,y as createXHRTransport,r as deserializeSnapshot,s as fingerprintMatches,n as generateId,l as isRecord,N as multipartStrategy,b as resolveUploadConfig,m as serializeSnapshot,w as sleep,D as useOptionalUploadStore,O as useUploadStore,k as useUploader,A as useUploaderActions,c as validateFile,h as validateFileList,f as validateIntent};

package/dist/react/index.d.ts

@@ -0,0 +1,90 @@
+import { f as IntentMap, l as UploadResultBase, o as CursorMap } from "../strategy.types-gg9ZStRe.js";
+import { B as UploadItem, E as UploadEventMap, G as UploadCommand, T as UploadStore, V as UploadPhase } from "../index-BXg9WIce.js";
+import { ReactNode } from "react";
+
+//#region src/react/upload-provider.d.ts
+/**
+ * Provider component that makes the upload store available to child components.
+ *
+ * @template M - Intent map type
+ * @template C - Cursor map type
+ * @template P - Purpose type
+ *
+ * @param props - Provider props
+ * @param props.store - Upload store instance to provide
+ * @param props.children - Child components that can access the store
+ *
+ * @returns {JSX.Element} Context provider wrapping children
+ *
+ * @example
+ * ```tsx
+ * <UploadProvider store={store}>
+ *   <UploadDropzone purpose="avatar" />
+ * </UploadProvider>
+ * ```
+ */
+declare function UploadProvider<M extends IntentMap, C extends CursorMap<M>, P extends string, R extends UploadResultBase = UploadResultBase>({
+  store,
+  children
+}: {
+  store: UploadStore<M, C, P, R>;
+  children: ReactNode;
+}): React.JSX.Element;
+/**
+ * Hook to access the upload store from React context when present.
+ *
+ * Some higher-level hooks support either an explicit store argument or context.
+ * They use this helper so the context read stays unconditional without throwing
+ * when a caller intentionally passes a store instance.
+ */
+declare function useOptionalUploadStore<M extends IntentMap, C extends CursorMap<M>, P extends string, R extends UploadResultBase = UploadResultBase>(): UploadStore<M, C, P, R> | null;
+/**
+ * Hook to access the upload store from React context.
+ *
+ * @template M - Intent map type
+ * @template C - Cursor map type
+ * @template P - Purpose type
+ *
+ * @returns {UploadStore<M, C, P>} The upload store instance
+ * @throws {Error} If called outside of UploadProvider
+ *
+ * @example
+ * ```tsx
+ * const store = useUploadStore()
+ * const snapshot = store.getSnapshot()
+ * ```
+ */
+declare function useUploadStore<M extends IntentMap, C extends CursorMap<M>, P extends string, R extends UploadResultBase = UploadResultBase>(): UploadStore<M, C, P, R>;
+//#endregion
+//#region src/react/use-uploader.d.ts
+declare function createUploadFactory<M extends IntentMap, C extends CursorMap<M>, P extends string, R extends UploadResultBase = UploadResultBase>(store: UploadStore<M, C, P, R>): () => Uploader<M, C, P, R>;
+type PickItemsByPhase<Phase extends UploadPhase> = Extract<UploadItem<IntentMap, CursorMap<IntentMap>, string, UploadResultBase>, {
+  phase: Phase;
+}>;
+type Uploader<M extends IntentMap, C extends CursorMap<M>, P extends string, R extends UploadResultBase> = {
+  items: UploadItem<M, C, P, R>[];
+  byPhase: Record<string, UploadItem<M, C, P, R>[]>;
+  dispatch: (cmd: UploadCommand<P>) => void;
+  on: <K extends keyof UploadEventMap<M, C, P, R> & string>(type: K, cb: (payload: UploadEventMap<M, C, P, R>[K]) => void) => () => void;
+  off: <K extends keyof UploadEventMap<M, C, P, R> & string>(type: K, cb: (payload: UploadEventMap<M, C, P, R>[K]) => void) => () => void;
+  uploading: UploadItem<M, C, P, R>[];
+  paused: UploadItem<M, C, P, R>[];
+  completed: UploadItem<M, C, P, R>[];
+  failed: UploadItem<M, C, P, R>[];
+  ready: UploadItem<M, C, P, R>[];
+};
+/**
+ * Stable action surface for React consumers that need imperative store access.
+ *
+ * This is declared explicitly instead of relying on an inferred object return
+ * type so the generated package declarations do not leak the internal generic
+ * names created by `store.on.bind(store)`.
+ */
+type UploaderActions<M extends IntentMap, C extends CursorMap<M>, P extends string, R extends UploadResultBase = UploadResultBase> = Pick<UploadStore<M, C, P, R>, 'dispatch' | 'on'> & {
+  store: UploadStore<M, C, P, R>;
+};
+declare function useUploader<M extends IntentMap, C extends CursorMap<M>, P extends string, R extends UploadResultBase = UploadResultBase>(): Uploader<M, C, P, R>;
+declare function useUploader<M extends IntentMap, C extends CursorMap<M>, P extends string, R extends UploadResultBase = UploadResultBase>(store: UploadStore<M, C, P, R>): Uploader<M, C, P, R>;
+declare function useUploaderActions<M extends IntentMap, C extends CursorMap<M>, P extends string, R extends UploadResultBase = UploadResultBase>(): UploaderActions<M, C, P, R>;
+//#endregion
+export { PickItemsByPhase, UploadProvider, UploaderActions, createUploadFactory, useOptionalUploadStore, useUploadStore, useUploader, useUploaderActions };

package/dist/react/index.js

@@ -0,0 +1 @@
+import{h as e}from"../core-BNxznRif.js";import{jsxDEV as t}from"react/jsx-dev-runtime";import*as n from"react";import{createContext as r,useContext as i}from"react";const a=r(null);function o({store:e,children:n}){return t(a.Provider,{value:e,children:n},void 0,!1,{fileName:`/home/runner/work/duck-ui/duck-ui/packages/duck-upload/src/react/upload-provider.tsx`,lineNumber:52,columnNumber:10},this)}function s(){let e=i(a);if(e===null)return null;if(!l(e))throw Error(`UploadProvider received an invalid store value`);return e}function c(){let e=s();if(!e)throw Error(`useUploadStore must be used within UploadProvider`);return e}function l(t){return e(t)?typeof t.getSnapshot==`function`&&typeof t.subscribe==`function`&&typeof t.dispatch==`function`&&typeof t.on==`function`&&typeof t.off==`function`&&typeof t.waitFor==`function`:!1}function u(e){return()=>d(e)}function d(e){let t=s(),r=e??t;if(!r)throw Error(`useUploader must be used within UploadProvider when no store argument is provided`);let i=n.useSyncExternalStore(r.subscribe.bind(r),r.getSnapshot.bind(r),r.getSnapshot.bind(r)),a=n.useMemo(()=>Array.from(i.items.values()),[i.items]),o=n.useMemo(()=>{let e={};return a.forEach(t=>{e[t.phase]||(e[t.phase]=[]),e[t.phase].push(t)}),e},[a]);return{items:a,byPhase:o,dispatch:r.dispatch.bind(r),on:r.on.bind(r),off:r.off.bind(r),uploading:o.uploading||[],paused:o.paused||[],completed:o.completed||[],failed:o.error||[],ready:o.ready||[]}}function f(){let e=c();return{dispatch:n.useMemo(()=>e.dispatch.bind(e),[e]),on:n.useMemo(()=>e.on.bind(e),[e]),store:e}}export{o as UploadProvider,u as createUploadFactory,s as useOptionalUploadStore,c as useUploadStore,d as useUploader,f as useUploaderActions};

package/dist/strategies/index.d.ts

@@ -0,0 +1,56 @@
+import { f as IntentMap, l as UploadResultBase, n as StrategyRegistry, o as CursorMap, r as UploadStrategy, t as StrategyCtx } from "../strategy.types-gg9ZStRe.js";
+
+//#region src/strategies/multipart/index.d.ts
+type MultipartIntent = {
+  strategy: 'multipart';
+  fileId: string;
+  uploadId: string;
+  partSize: number;
+  partCount: number;
+  parts?: Array<{
+    partNumber: number;
+    url: string;
+    headers?: Record<string, string>;
+  }>;
+};
+type MultipartCursor = {
+  done: Array<{
+    partNumber: number;
+    etag: string;
+    size: number;
+  }>;
+  /**
+   * Marks that the multipart session was completed on the backend (parts assembled).
+   * This prevents re-sending completeMultipart on resume.
+   */
+  completed?: true;
+};
+declare function multipartStrategy<M extends IntentMap & {
+  multipart: MultipartIntent;
+}, C extends CursorMap<M> & {
+  multipart?: MultipartCursor;
+}, P extends string = string, R extends UploadResultBase = UploadResultBase>(opts?: {
+  maxPartConcurrency?: number;
+}): UploadStrategy<M, C, P, R, 'multipart'>;
+//#endregion
+//#region src/strategies/post/index.d.ts
+type PostIntent = {
+  /** Strategy identifier - must be 'post' */strategy: 'post'; /** Backend file identifier */
+  fileId: string; /** Presigned POST URL (form action) */
+  url: string; /** Form fields to include before the file */
+  fields: Record<string, string>; /** Optional expiration timestamp for the presigned URL */
+  expiresAt?: string;
+};
+type PostCursor = {
+  /** Bytes uploaded (for progress display only) */uploadedBytes: number;
+};
+declare function PostStrategy<M extends IntentMap & {
+  post: PostIntent;
+}, C extends CursorMap<M> & {
+  post?: PostCursor;
+}, P extends string = string, R extends UploadResultBase = UploadResultBase>(): UploadStrategy<M, C, P, R, 'post'>;
+//#endregion
+//#region src/strategies/registry/index.d.ts
+declare function createStrategyRegistry<M extends IntentMap, C extends CursorMap<M>, P extends string = string, R extends UploadResultBase = UploadResultBase>(): StrategyRegistry<M, C, P, R>;
+//#endregion
+export { MultipartCursor, MultipartIntent, PostCursor, PostIntent, PostStrategy, type StrategyCtx, type StrategyRegistry, type UploadStrategy, createStrategyRegistry, multipartStrategy };

package/dist/strategies/index.js

@@ -0,0 +1 @@
+import{t as e}from"../async-DxRWu4le.js";function t(e){return e instanceof Error&&(e.name===`AbortError`||/abort/i.test(e.message))}function n(n){let r=Math.max(1,n?.maxPartConcurrency??4);return{id:`multipart`,resumable:!0,async start(n){let i=n.intent,a=n.file.size,o=Math.max(1,i.partSize),s=Math.max(1,i.partCount??Math.ceil(a/o)),c=n.readCursor(),l=new Map;if(c?.done)for(let e of c.done)l.set(e.partNumber,{etag:e.etag,size:e.size});let u=c?.completed===!0,d=new Map,f=0;for(let e of l.values())f+=e.size;let p=()=>{let e=0;for(let t of d.values())e+=t;n.reportProgress({uploadedBytes:f+e,totalBytes:a})},m=[];for(let e=1;e<=s;e++){if(l.has(e))continue;let t=(e-1)*o,n=Math.min(a,t+o);m.push({partNumber:e,start:t,end:n})}if(m.length===0){u||await y(),p();return}let h=m.slice(),g=new Set,_=async e=>{let t=i.parts?.find(t=>t.partNumber===e);if(t)return t;if(!n.api.multipart?.signPart)throw Error(`multipart.signPart is missing in UploadApi. Implement it to call your backend sign-part endpoint.`);let r=await n.api.multipart.signPart({fileId:i.fileId,uploadId:i.uploadId,partNumber:e},{signal:n.signal});return{partNumber:e,url:r.url,headers:r.headers}},v=async(r,i=0)=>{try{let e=n.file.slice(r.start,r.end),t=e.size,i=await _(r.partNumber),a=await n.transport.put({url:i.url,body:e,headers:i.headers,signal:n.signal,onProgress:e=>{d.set(r.partNumber,e),p()}});d.delete(r.partNumber);let o=a.etag;if(!o)throw Error(`Missing ETag from upload part response. Ensure MinIO/S3 CORS exposes ETag (Access-Control-Expose-Headers: ETag).`);f+=t,l.set(r.partNumber,{etag:o,size:t});let s={done:Array.from(l.entries()).map(([e,t])=>({partNumber:e,etag:t.etag,size:t.size})).sort((e,t)=>e.partNumber-t.partNumber)};n.persistCursor(s),p()}catch(a){if(d.delete(r.partNumber),n.signal?.aborted||t(a))throw a;if(i<3){let t=a instanceof Error?a.message:String(a);if(/network/i.test(t)||/timeout/i.test(t)||/5\d\d/.test(t)||/ECONNRESET/i.test(t)||/EHOSTUNREACH/i.test(t))return await e(2**i*500),v(r,i+1)}throw a}};for(;h.length>0||g.size>0;){for(;h.length>0&&g.size<r;){let e=h.shift();if(!e)break;let t,n=v(e).finally(()=>{t&&g.delete(t)});t=n,g.add(n)}g.size>0&&await Promise.race(g)}await y(),p();async function y(){if(u)return;if(!n.api.multipart?.completeMultipart)throw Error(`multipart.completeMultipart is missing in UploadApi. Implement it to call your backend complete endpoint.`);let e=Array.from(l.entries()).map(([e,t])=>({partNumber:e,etag:t.etag})).sort((e,t)=>e.partNumber-t.partNumber);if(e.length!==s)throw Error(`Cannot complete multipart: expected ${s} parts, got ${e.length}`);await n.api.multipart.completeMultipart({fileId:i.fileId,uploadId:i.uploadId,parts:e},{signal:n.signal});let t={done:Array.from(l.entries()).map(([e,t])=>({partNumber:e,etag:t.etag,size:t.size})).sort((e,t)=>e.partNumber-t.partNumber),completed:!0};n.persistCursor(t)}}}}function r(){return{id:`post`,resumable:!1,async start(e){let t=e.intent;if(!t.url)throw Error(`Direct strategy: intent missing url/uploadUrl`);await e.transport.postForm({url:t.url,file:e.file,fields:t.fields,filename:e.file.name,signal:e.signal,onProgress(t,n){e.reportProgress({uploadedBytes:t,totalBytes:n})}})}}}function i(){let e={};return{get(t){return e[t]},has(t){return Object.hasOwn(e,t)},set(t){e[t.id]=t}}}export{r as PostStrategy,i as createStrategyRegistry,n as multipartStrategy};

package/dist/strategy.types-gg9ZStRe.d.ts

@@ -0,0 +1,225 @@
+//#region src/core/contracts/intent.types.d.ts
+/**
+ * Base shape for all upload intents.
+ *
+ * An "intent" is data provided by your backend that tells the client how to upload a file
+ * (for example: a presigned POST, presigned PUT, multipart upload IDs, part URLs, headers, etc).
+ *
+ * Every intent must include:
+ * - `strategy`: a discriminant used to select an upload strategy implementation
+ * - `fileId`: a stable backend identifier for the file being uploaded
+ *
+ * @typeParam K - Strategy key / discriminant string (example: `"direct" | "multipart"`).
+ */
+type IntentBase<K extends string = string> = {
+  /** Strategy name (discriminant). */strategy: K; /** Unique backend file identifier. */
+  fileId: string;
+};
+/**
+ * Registry of intent types mapped by strategy name.
+ *
+ * Example:
+ * ```ts
+ * type MyIntents = {
+ *   direct: DirectIntent
+ *   multipart: MultipartIntent
+ * }
+ * ```
+ *
+ * `M[keyof M]` is used throughout the engine as the "any intent" union.
+ */
+type IntentMap = Record<string, IntentBase<string>>;
+/** Union of strategy keys for an intent map. */
+type StrategyKey<M extends IntentMap> = keyof M & string;
+/** Union of all intent variants for an intent map. */
+type AnyIntent<M extends IntentMap> = M[StrategyKey<M>];
+//#endregion
+//#region src/core/contracts/result.types.d.ts
+/**
+ * Base shape for upload completion results returned by your backend.
+ *
+ * Extend this with any additional metadata you return (e.g. width/height, variants).
+ */
+type UploadResultBase = {
+  /** Backend file identifier. */fileId: string; /** Storage key or path used for signed URLs. */
+  key: string;
+};
+//#endregion
+//#region src/core/contracts/backendApi.d.ts
+type WithSignal = {
+  signal?: AbortSignal;
+};
+interface UploadApi<M extends IntentMap, P extends string, R extends UploadResultBase = UploadResultBase> {
+  createIntent(args: {
+    purpose: P;
+    contentType: string;
+    size: number;
+    filename: string;
+    checksum?: string;
+  }, opts?: WithSignal): Promise<M[keyof M]>;
+  complete(args: {
+    fileId: string;
+  }, opts?: WithSignal): Promise<R>;
+  getSignedPreviewUrl?(args: {
+    fileId: string;
+    key: string;
+    purpose: P;
+  }, opts?: WithSignal): Promise<string>;
+  /**
+   * Optional support for finding existing files by checksum for deduplication.
+   * If implemented, the upload engine will check for existing files before uploading.
+   * If a file with the same checksum exists, the upload will be skipped and the existing file will be linked.
+   */
+  findByChecksum?(args: {
+    checksum: string;
+    purpose: P;
+  }, opts?: WithSignal): Promise<R | null>;
+  multipart?: {
+    signPart(args: {
+      fileId: string;
+      uploadId: string;
+      partNumber: number;
+      checksum?: string;
+    }, opts?: WithSignal): Promise<{
+      url: string;
+      headers?: Record<string, string>;
+    }>;
+    completeMultipart(args: {
+      fileId: string;
+      uploadId: string;
+      parts: Array<{
+        partNumber: number;
+        etag: string;
+      }>;
+    }, opts?: WithSignal): Promise<unknown>;
+    listParts?(args: {
+      fileId: string;
+      uploadId: string;
+    }, opts?: WithSignal): Promise<Array<{
+      partNumber: number;
+      etag?: string;
+      size?: number;
+    }>>;
+    abort?(args: {
+      fileId: string;
+      uploadId: string;
+    }, opts?: WithSignal): Promise<void>;
+  };
+  tus?: {
+    create(args: {
+      fileId: string;
+      size: number;
+      filename: string;
+      contentType: string;
+    }, opts?: WithSignal): Promise<{
+      uploadUrl: string;
+    }>;
+    getOffset(args: {
+      uploadUrl: string;
+    }, opts?: WithSignal): Promise<{
+      offset: number;
+    }>;
+  };
+}
+//#endregion
+//#region src/core/contracts/cursor.types.d.ts
+/**
+ * Registry of cursor payload types mapped by strategy name.
+ *
+ * A "cursor" is strategy-defined resume state (ex: multipart uploaded parts, next byte offset).
+ * Use `unknown` here and define concrete cursor payload types in your app.
+ *
+ * @typeParam M - The intent map, used to constrain strategy keys.
+ */
+type CursorMap<M extends IntentMap> = Partial<Record<StrategyKey<M>, unknown>>;
+/**
+ * Discriminated union of all cursor variants.
+ *
+ * The cursor is always tagged with a `strategy` so it can be routed back to the correct strategy
+ * on resume/rebind.
+ *
+ * @typeParam C - Cursor registry (usually {@link CursorMap}).
+ */
+type AnyCursor<C extends Record<string, unknown>> = { [K in keyof C & string]: {
+  strategy: K;
+  value?: C[K];
+} }[keyof C & string];
+//#endregion
+//#region src/core/contracts/transport/transport.types.d.ts
+/**
+ * Abstraction layer for network operations.
+ * Allows switching between XHR (browser) or other implementations (testing/Node).
+ *
+ * Designed to support:
+ * - Deterministic progress tracking (requires XHR in browsers)
+ * - Cancellation via AbortSignal
+ * - Header parsing (ETag extraction)
+ */
+interface UploadTransport {
+  /**
+   * Performs an HTTP PUT request (typically for S3 signed URLs).
+   */
+  put(args: {
+    url: string;
+    body: Blob;
+    headers?: Record<string, string>;
+    signal: AbortSignal;
+    onProgress?: (u: number, t: number) => void;
+  }): Promise<{
+    etag?: string;
+    headers?: Record<string, string>;
+  }>;
+  /**
+   * Performs an HTTP POST multipart request.
+   */
+  postForm(args: {
+    url: string;
+    fields: Record<string, string>;
+    file: File | Blob;
+    filename?: string;
+    signal: AbortSignal;
+    onProgress?: (uploadedBytes: number, totalBytes: number) => void;
+  }): Promise<{
+    etag?: string;
+    headers?: Record<string, string>;
+  }>;
+  /**
+   * Performs an HTTP request.
+   */
+  patch(args: {
+    url: string;
+    body: Blob | ArrayBuffer;
+    headers?: Record<string, string>;
+    signal: AbortSignal;
+    onProgress?: (u: number, t: number) => void;
+  }): Promise<{
+    headers?: Record<string, string>;
+  }>;
+}
+//#endregion
+//#region src/core/contracts/strategy.types.d.ts
+type StrategyCtx<M extends IntentMap, C extends CursorMap<M>, P extends string, R extends UploadResultBase, K extends keyof M & string> = {
+  file: File;
+  intent: M[K];
+  signal: AbortSignal;
+  transport: UploadTransport;
+  api: UploadApi<M, P, R>;
+  reportProgress: (p: {
+    uploadedBytes: number;
+    totalBytes: number;
+  }) => void;
+  readCursor: () => C[K] | undefined;
+  persistCursor: (cursor: C[K] | undefined) => void;
+};
+type UploadStrategy<M extends IntentMap, C extends CursorMap<M>, P extends string, R extends UploadResultBase, K extends keyof M & string> = {
+  id: K;
+  resumable: boolean;
+  start(ctx: StrategyCtx<M, C, P, R, K>): Promise<void>;
+};
+interface StrategyRegistry<M extends IntentMap, C extends CursorMap<M>, P extends string = string, R extends UploadResultBase = UploadResultBase> {
+  get<K extends keyof M & string>(id: K): UploadStrategy<M, C, P, R, K> | undefined;
+  has(id: string): id is keyof M & string;
+  set<K extends keyof M & string>(strategy: UploadStrategy<M, C, P, R, K>): void;
+}
+//#endregion
+export { AnyCursor as a, WithSignal as c, IntentBase as d, IntentMap as f, UploadTransport as i, UploadResultBase as l, StrategyRegistry as n, CursorMap as o, StrategyKey as p, UploadStrategy as r, UploadApi as s, StrategyCtx as t, AnyIntent as u };

package/package.json

@@ -1,28 +1,41 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@gentleduck/upload",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "publishConfig": {
     "access": "public"
   },
   "type": "module",
   "exports": {
-    ".": "./src/index.ts",
-    "./core": "./src/core/index.ts",
-    "./react": "./src/react/index.ts",
-    "./strategies": "./src/strategies/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "default": "./dist/core/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./strategies": {
+      "types": "./dist/strategies/index.d.ts",
+      "default": "./dist/strategies/index.js"
+    }
   },
   "files": [
     "dist",
     "src"
   ],
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
   "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
     "check-types": "tsc --noEmit",
-    "test": "vitest --passWithNoTests",
+    "test": "vitest run --passWithNoTests",
     "lint": "biome lint .",
     "format": "biome format --write ."
   },
@@ -33,12 +46,12 @@
   "devDependencies": {
     "@gentleduck/tsdown-config": "workspace:*",
     "@gentleduck/typescript-config": "workspace:*",
-    "@types/node": "^25.4.0",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "tsdown": "0.18.3",
-    "typescript": "5.9.3",
-    "vite": "^7.3.1",
+    "@types/node": "catalog:",
+    "@types/react": "catalog:react19",
+    "@types/react-dom": "catalog:react19",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vite": "catalog:",
     "vitest": "^4.0.18"
   },
   "engines": {

package/src/core/engine/store/handlers/clean-up.ts

@@ -48,7 +48,7 @@ export function cleanupOldItems<
         return aTime - bTime
       })
 
-    const excess = remainingItems.length - maxItems!
+    const excess = remainingItems.length - maxItems
     for (let i = 0; i < excess && i < completedOrCanceled.length; i++) {
       toRemove.push(completedOrCanceled[i][0])
     }

package/src/core/engine/store/store.dispatch.ts

@@ -25,7 +25,9 @@ export function dispatch<M extends IntentMap, C extends CursorMap<M>, P extends
     const purpose = cmd.purpose
     Array.from(rt.state.items.values())
       .filter((item) => item.phase === 'ready' && (!purpose || item.purpose === purpose))
-      .forEach((item) => rt.dispatch({ type: 'start', localId: item.localId }))
+      .forEach((item) => {
+        rt.dispatch({ type: 'start', localId: item.localId })
+      })
     return
   }
 
@@ -33,7 +35,9 @@ export function dispatch<M extends IntentMap, C extends CursorMap<M>, P extends
     const purpose = cmd.purpose
     Array.from(rt.state.items.values())
       .filter((item) => item.phase === 'uploading' && (!purpose || item.purpose === purpose))
-      .forEach((item) => rt.dispatch({ type: 'pause', localId: item.localId }))
+      .forEach((item) => {
+        rt.dispatch({ type: 'pause', localId: item.localId })
+      })
     return
   }
 
@@ -43,7 +47,9 @@ export function dispatch<M extends IntentMap, C extends CursorMap<M>, P extends
       .filter(
         (item) => item.phase !== 'completed' && item.phase !== 'canceled' && (!purpose || item.purpose === purpose),
       )
-      .forEach((item) => rt.dispatch({ type: 'cancel', localId: item.localId }))
+      .forEach((item) => {
+        rt.dispatch({ type: 'cancel', localId: item.localId })
+      })
     return
   }
 

package/src/core/engine/store/store.runtime.ts

@@ -91,7 +91,9 @@ export function createStoreRuntime<
     scheduling: false,
 
     notify() {
-      rt.listeners.forEach((l) => l())
+      rt.listeners.forEach((listener) => {
+        listener()
+      })
     },
 
     scheduleWork() {

package/src/core/engine/store/store.types.ts

@@ -138,7 +138,7 @@ export interface StoreOptions<
  *
  * Used to configure the upload store persistence layer.
  */
-export type DeserializeContext<M extends IntentMap, C extends CursorMap<M>, P extends string> = {
+export type DeserializeContext<M extends IntentMap, _C extends CursorMap<M>, P extends string> = {
   isPurpose?: (value: string) => value is P
   isIntent?: (value: unknown) => value is M[keyof M]
   hasStrategy: (value: string) => boolean

package/src/core/engine/validation/file.ts

@@ -36,7 +36,7 @@ export function validateFile<P extends string>(file: File, purpose: P, config: U
             if (type.endsWith('/*')) {
               // Wildcard match: 'image/*' matches 'image/jpeg', 'image/png', etc.
               const prefix = type.slice(0, -2).toLowerCase()
-              return mimeType.startsWith(prefix + '/')
+              return mimeType.startsWith(`${prefix}/`)
             }
             // Exact match
             return mimeType === type.toLowerCase()