@uploadista/core 0.0.2 → 0.0.4

package/dist/upload-DvLp6TXO.cjs

@@ -0,0 +1 @@
+const e=require(`./uploadista-error-DdTP-Rjx.cjs`),t=require(`./types-Dj9g8ocl.cjs`),n=require(`./checksum-wSBuXX84.cjs`),r=require(`./stream-limiter-DYGG4t9f.cjs`);let i=require(`effect`);i=e.a(i);function a(e,t,n=0){return e.length<n+t.length?!1:t.every((t,r)=>e[n+r]===t)}function o(e,t,n=0){if(e.length<n+t.length)return!1;for(let r=0;r<t.length;r++)if(e[n+r]!==t.charCodeAt(r))return!1;return!0}const s=(e,t)=>{if(e.length===0)return`application/octet-stream`;if(a(e,[137,80,78,71,13,10,26,10]))return`image/png`;if(a(e,[255,216,255]))return`image/jpeg`;if(o(e,`GIF87a`)||o(e,`GIF89a`))return`image/gif`;if(a(e,[82,73,70,70])&&e.length>=12&&o(e,`WEBP`,8))return`image/webp`;if(e.length>=12&&a(e,[0,0,0],0)&&o(e,`ftyp`,4)&&(o(e,`avif`,8)||o(e,`avis`,8)))return`image/avif`;if(e.length>=12&&o(e,`ftyp`,4)&&(o(e,`heic`,8)||o(e,`heif`,8)||o(e,`mif1`,8)))return`image/heic`;if(a(e,[66,77]))return`image/bmp`;if(a(e,[73,73,42,0])||a(e,[77,77,0,42]))return`image/tiff`;if(a(e,[0,0,1,0]))return`image/x-icon`;if(e.length>=5){let t=new TextDecoder(`utf-8`,{fatal:!1}).decode(e.slice(0,Math.min(1024,e.length)));if(t.includes(`<svg`)||t.includes(`<?xml`)&&t.includes(`<svg`))return`image/svg+xml`}if(e.length>=12&&o(e,`ftyp`,4)){let t=new TextDecoder().decode(e.slice(8,12));if(t.startsWith(`mp4`)||t.startsWith(`M4`)||t.startsWith(`isom`))return`video/mp4`}if(a(e,[26,69,223,163]))return`video/webm`;if(a(e,[82,73,70,70])&&e.length>=12&&o(e,`AVI `,8))return`video/x-msvideo`;if(e.length>=8&&(o(e,`moov`,4)||o(e,`mdat`,4)||o(e,`free`,4)))return`video/quicktime`;if(a(e,[26,69,223,163])&&e.length>=100&&new TextDecoder(`utf-8`,{fatal:!1}).decode(e.slice(0,100)).includes(`matroska`))return`video/x-matroska`;if(a(e,[255,251])||a(e,[255,243])||a(e,[255,242])||o(e,`ID3`))return`audio/mpeg`;if(a(e,[82,73,70,70])&&e.length>=12&&o(e,`WAVE`,8))return`audio/wav`;if(o(e,`fLaC`))return`audio/flac`;if(o(e,`OggS`))return`audio/ogg`;if(e.length>=12&&o(e,`ftyp`,4)&&o(e,`M4A`,8))return`audio/mp4`;if(o(e,`%PDF`))return`application/pdf`;if(a(e,[80,75,3,4])||a(e,[80,75,5,6])||a(e,[80,75,7,8])){if(e.length>=1024){let t=new TextDecoder(`utf-8`,{fatal:!1}).decode(e);if(t.includes(`word/`))return`application/vnd.openxmlformats-officedocument.wordprocessingml.document`;if(t.includes(`xl/`))return`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`;if(t.includes(`ppt/`))return`application/vnd.openxmlformats-officedocument.presentationml.presentation`}return`application/zip`}if(a(e,[82,97,114,33,26,7]))return`application/x-rar-compressed`;if(a(e,[55,122,188,175,39,28]))return`application/x-7z-compressed`;if(a(e,[31,139]))return`application/gzip`;if(e.length>=262&&o(e,`ustar`,257))return`application/x-tar`;if(o(e,`wOFF`))return`font/woff`;if(o(e,`wOF2`))return`font/woff2`;if(a(e,[0,1,0,0,0]))return`font/ttf`;if(o(e,`OTTO`))return`font/otf`;if(e.length>=1){let t=e[0];if(t===123||t===91)try{let t=new TextDecoder(`utf-8`).decode(e.slice(0,Math.min(1024,e.length)));return JSON.parse(t.trim()),`application/json`}catch{}}if(t)switch(t.split(`.`).pop()?.toLowerCase()){case`jpg`:case`jpeg`:return`image/jpeg`;case`png`:return`image/png`;case`gif`:return`image/gif`;case`webp`:return`image/webp`;case`avif`:return`image/avif`;case`heic`:case`heif`:return`image/heic`;case`bmp`:return`image/bmp`;case`tiff`:case`tif`:return`image/tiff`;case`ico`:return`image/x-icon`;case`svg`:return`image/svg+xml`;case`mp4`:case`m4v`:return`video/mp4`;case`webm`:return`video/webm`;case`avi`:return`video/x-msvideo`;case`mov`:return`video/quicktime`;case`mkv`:return`video/x-matroska`;case`mp3`:return`audio/mpeg`;case`wav`:return`audio/wav`;case`flac`:return`audio/flac`;case`ogg`:return`audio/ogg`;case`m4a`:return`audio/mp4`;case`pdf`:return`application/pdf`;case`docx`:return`application/vnd.openxmlformats-officedocument.wordprocessingml.document`;case`xlsx`:return`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`;case`pptx`:return`application/vnd.openxmlformats-officedocument.presentationml.presentation`;case`zip`:return`application/zip`;case`rar`:return`application/x-rar-compressed`;case`7z`:return`application/x-7z-compressed`;case`gz`:case`gzip`:return`application/gzip`;case`tar`:return`application/x-tar`;case`woff`:return`font/woff`;case`woff2`:return`font/woff2`;case`ttf`:return`font/ttf`;case`otf`:return`font/otf`;case`txt`:return`text/plain`;case`json`:return`application/json`;case`xml`:return`application/xml`;case`html`:case`htm`:return`text/html`;case`css`:return`text/css`;case`js`:return`application/javascript`;case`csv`:return`text/csv`;default:return`application/octet-stream`}return`application/octet-stream`};function c(e,t){return e===t?!0:e.split(`/`)[0]===t.split(`/`)[0]}const l=(e,n,{dataStoreService:r,kvStore:a,eventEmitter:o,generateId:s})=>i.Effect.gen(function*(){let i=yield*r.getDataStore(e.storageId,n),c=yield*s.generateId(),{size:l,type:u,fileName:d,lastModified:f,metadata:p,flow:m}=e,h={};if(p)try{h=JSON.parse(p)}catch{h={}}let g={...h,type:u,fileName:d??``};f&&(g.lastModified=f.toString());let _={id:c,size:l,metadata:g,offset:0,creationDate:new Date().toISOString(),storage:{id:e.storageId,type:u,path:``,bucket:i.bucket},flow:m},v=yield*i.create(_);return yield*a.set(c,v),yield*o.emit(c,{type:t.n.UPLOAD_STARTED,data:v,flow:v.flow}),v}).pipe(i.Effect.withSpan(`upload-create`,{attributes:{"upload.file_name":e.fileName??`unknown`,"upload.file_size":e.size?.toString()??`0`,"upload.storage_id":e.storageId,"upload.mime_type":e.type,"upload.has_flow":e.flow?`true`:`false`}}),i.Effect.tap(e=>i.Effect.gen(function*(){if(yield*i.Metric.increment(i.Metric.counter(`upload_created_total`,{description:`Total number of uploads created`})),e.size){let t=i.Metric.histogram(`upload_file_size_bytes`,i.MetricBoundaries.exponential({start:1024,factor:2,count:25}));yield*i.Metric.update(t,e.size)}let t=i.Metric.gauge(`active_uploads`);yield*i.Metric.increment(t)})),i.Effect.tap(t=>i.Effect.logInfo(`Upload created`).pipe(i.Effect.annotateLogs({"upload.id":t.id,"upload.file_name":e.fileName??`unknown`,"upload.file_size":e.size?.toString()??`0`,"upload.storage_id":e.storageId}))),i.Effect.tapError(t=>i.Effect.gen(function*(){yield*i.Effect.logError(`Upload creation failed`).pipe(i.Effect.annotateLogs({"upload.file_name":e.fileName??`unknown`,"upload.storage_id":e.storageId,error:String(t)})),yield*i.Metric.increment(i.Metric.counter(`upload_failed_total`,{description:`Total number of uploads that failed`}))})));function u(t){return i.Stream.fromReadableStream(()=>t,t=>new e.n({code:`UNKNOWN_ERROR`,status:500,body:String(t)}))}function d({data:n,upload:a,dataStore:o,maxFileSize:s,controller:c,eventEmitter:l,uploadProgressInterval:d=200}){return i.Effect.gen(function*(){let f=u(n);if(c.signal.aborted)return yield*i.Effect.fail(e.n.fromCode(`ABORTED`));let p=new AbortController,{signal:m}=p,h=()=>{p.abort()};return c.signal.addEventListener(`abort`,h,{once:!0}),yield*i.Effect.acquireUseRelease(i.Effect.sync(()=>({signal:m,onAbort:h})),({signal:n})=>i.Effect.gen(function*(){let e=yield*i.Ref.make(0),n=r.t.limit({maxSize:s})(f);return yield*o.write({stream:n,file_id:a.id,offset:a.offset},{onProgress:n=>{let r=Date.now();i.Ref.get(e).pipe(i.Effect.flatMap(o=>r-o>=d?i.Effect.gen(function*(){yield*i.Ref.set(e,r),yield*l.emit(a.id,{type:t.n.UPLOAD_PROGRESS,data:{id:a.id,progress:n,total:a.size??0},flow:a.flow})}):i.Effect.void),i.Effect.runPromise).catch(()=>{})}})}).pipe(i.Effect.catchAll(t=>t instanceof Error&&t.name===`AbortError`?i.Effect.fail(e.n.fromCode(`ABORTED`)):t instanceof e.n?i.Effect.fail(t):i.Effect.fail(e.n.fromCode(`FILE_WRITE_ERROR`,{cause:t})))),({onAbort:e})=>i.Effect.sync(()=>{c.signal.removeEventListener(`abort`,e)}))}).pipe(i.Effect.withSpan(`upload-write-to-store`,{attributes:{"upload.id":a.id,"upload.offset":a.offset.toString(),"upload.max_file_size":s.toString(),"upload.file_size":a.size?.toString()??`0`}}),i.Effect.tap(e=>i.Effect.logDebug(`Data written to store`).pipe(i.Effect.annotateLogs({"upload.id":a.id,"write.offset":e.toString(),"write.bytes_written":(e-a.offset).toString()}))),i.Effect.tapError(t=>i.Effect.logError(`Failed to write to store`).pipe(i.Effect.annotateLogs({"upload.id":a.id,"upload.offset":a.offset.toString(),error:t instanceof e.n?t.code:String(t)}))))}const f=(e,n,r,{dataStoreService:a,kvStore:o,eventEmitter:s})=>i.Effect.gen(function*(){let i=yield*o.get(e),c=yield*a.getDataStore(i.storage.id,n);return i.offset=yield*d({dataStore:c,data:r,upload:i,maxFileSize:1e8,controller:new AbortController,uploadProgressInterval:200,eventEmitter:s}),yield*o.set(e,i),yield*s.emit(i.id,{type:t.n.UPLOAD_PROGRESS,data:{id:i.id,progress:i.offset,total:i.size??0},flow:i.flow}),i.size&&i.offset===i.size&&(yield*p({file:i,dataStore:c,eventEmitter:s})),i}).pipe(i.Effect.withSpan(`upload-chunk`,{attributes:{"upload.id":e,"chunk.upload_id":e}}),i.Effect.tap(e=>i.Effect.gen(function*(){yield*i.Metric.increment(i.Metric.counter(`chunk_uploaded_total`,{description:`Total number of chunks uploaded`}));let t=e.offset,n=i.Metric.histogram(`chunk_size_bytes`,i.MetricBoundaries.linear({start:262144,width:262144,count:20}));if(yield*i.Metric.update(n,t),e.size&&e.size>0){let e=t,n=i.Metric.gauge(`upload_throughput_bytes_per_second`);yield*i.Metric.set(n,e)}})),i.Effect.tap(e=>i.Effect.logDebug(`Chunk uploaded`).pipe(i.Effect.annotateLogs({"upload.id":e.id,"chunk.size":e.offset.toString(),"chunk.progress":e.size&&e.size>0?(e.offset/e.size*100).toFixed(2):`0`,"upload.total_size":e.size?.toString()??`0`}))),i.Effect.tapError(t=>i.Effect.logError(`Chunk upload failed`).pipe(i.Effect.annotateLogs({"upload.id":e,error:String(t)})))),p=({file:r,dataStore:a,eventEmitter:o})=>i.Effect.gen(function*(){let i=a.getCapabilities();if(i.maxValidationSize&&r.size&&r.size>i.maxValidationSize){yield*o.emit(r.id,{type:t.n.UPLOAD_VALIDATION_WARNING,data:{id:r.id,message:`File size (${r.size} bytes) exceeds max validation size (${i.maxValidationSize} bytes). Validation skipped.`},flow:r.flow});return}let l=yield*a.read(r.id);if(r.checksum&&r.checksumAlgorithm){let i=yield*n.t(l,r.checksumAlgorithm);if(i!==r.checksum)return yield*o.emit(r.id,{type:t.n.UPLOAD_VALIDATION_FAILED,data:{id:r.id,reason:`checksum_mismatch`,expected:r.checksum,actual:i},flow:r.flow}),yield*a.remove(r.id),yield*e.n.fromCode(`CHECKSUM_MISMATCH`,{body:`Checksum validation failed. Expected: ${r.checksum}, Got: ${i}`,details:{uploadId:r.id,expected:r.checksum,actual:i,algorithm:r.checksumAlgorithm}}).toEffect();yield*o.emit(r.id,{type:t.n.UPLOAD_VALIDATION_SUCCESS,data:{id:r.id,validationType:`checksum`,algorithm:r.checksumAlgorithm},flow:r.flow})}if(i.requiresMimeTypeValidation){let n=s(l),i=r.metadata?.type;if(i&&!c(i,n))return yield*o.emit(r.id,{type:t.n.UPLOAD_VALIDATION_FAILED,data:{id:r.id,reason:`mimetype_mismatch`,expected:i,actual:n},flow:r.flow}),yield*a.remove(r.id),yield*e.n.fromCode(`MIMETYPE_MISMATCH`,{body:`MIME type validation failed. Expected: ${i}, Detected: ${n}`,details:{uploadId:r.id,expected:i,actual:n}}).toEffect();yield*o.emit(r.id,{type:t.n.UPLOAD_VALIDATION_SUCCESS,data:{id:r.id,validationType:`mimetype`},flow:r.flow})}}).pipe(i.Effect.withSpan(`validate-upload`,{attributes:{"upload.id":r.id,"validation.checksum_provided":r.checksum?`true`:`false`,"validation.mime_required":a.getCapabilities().requiresMimeTypeValidation?`true`:`false`}})),m=t=>i.Effect.tryPromise({try:async()=>await fetch(t),catch:t=>e.n.fromCode(`UNKNOWN_ERROR`,{cause:t})}).pipe(i.Effect.withSpan(`upload-fetch-url`,{attributes:{"upload.url":t,"upload.operation":`fetch`}}),i.Effect.tap(e=>i.Effect.gen(function*(){yield*i.Metric.increment(i.Metric.counter(`upload_from_url_total`,{description:`Total number of URL-based uploads`})),e.ok&&(yield*i.Metric.increment(i.Metric.counter(`upload_from_url_success_total`,{description:`Total number of successful URL-based uploads`})))})),i.Effect.tap(e=>i.Effect.logInfo(`URL fetch completed`).pipe(i.Effect.annotateLogs({"upload.url":t,"response.status":e.status.toString(),"response.ok":e.ok.toString(),"response.content_length":e.headers.get(`content-length`)??`unknown`}))),i.Effect.tapError(e=>i.Effect.gen(function*(){yield*i.Metric.increment(i.Metric.counter(`upload_from_url_failed_total`,{description:`Total number of failed URL-based uploads`})),yield*i.Effect.logError(`URL fetch failed`).pipe(i.Effect.annotateLogs({"upload.url":t,error:String(e)}))}))),h=t=>i.Effect.tryPromise({try:async()=>await t.arrayBuffer(),catch:t=>e.n.fromCode(`UNKNOWN_ERROR`,{cause:t})}).pipe(i.Effect.withSpan(`upload-convert-to-buffer`,{attributes:{"upload.operation":`arrayBuffer`}}),i.Effect.tap(e=>i.Effect.logDebug(`Response converted to array buffer`).pipe(i.Effect.annotateLogs({"buffer.size":e.byteLength.toString()}))),i.Effect.tapError(e=>i.Effect.logError(`Failed to convert response to array buffer`).pipe(i.Effect.annotateLogs({error:String(e)}))));var g=class extends i.Context.Tag(`UploadServer`)(){};function _(){return i.Effect.gen(function*(){let e=yield*t.u,r=yield*t.v,a=yield*n.r,o=yield*t.T;return{upload:(t,n,s)=>i.Effect.gen(function*(){return yield*f((yield*l(t,n,{dataStoreService:o,kvStore:e,eventEmitter:r,generateId:a})).id,n,s,{dataStoreService:o,kvStore:e,eventEmitter:r})}),uploadFromUrl:(t,n,s)=>i.Effect.gen(function*(){let i=yield*h(yield*m(s)),c=new ReadableStream({start(e){e.enqueue(new Uint8Array(i)),e.close()}});return yield*f((yield*l({...t,size:i.byteLength},n,{dataStoreService:o,kvStore:e,eventEmitter:r,generateId:a})).id,n,c,{dataStoreService:o,kvStore:e,eventEmitter:r})}),createUpload:(t,n)=>i.Effect.gen(function*(){return yield*l(t,n,{dataStoreService:o,kvStore:e,eventEmitter:r,generateId:a})}),uploadChunk:(t,n,a)=>i.Effect.gen(function*(){return yield*f(t,n,a,{dataStoreService:o,kvStore:e,eventEmitter:r})}),getUpload:t=>i.Effect.gen(function*(){return yield*e.get(t)}),read:(t,n)=>i.Effect.gen(function*(){let r=yield*e.get(t);return yield*(yield*o.getDataStore(r.storage.id,n)).read(t)}),delete:(t,n)=>i.Effect.gen(function*(){let r=yield*e.get(t);yield*(yield*o.getDataStore(r.storage.id,n)).remove(t),yield*e.delete(t)}),getCapabilities:(e,t)=>i.Effect.gen(function*(){return(yield*o.getDataStore(e,t)).getCapabilities()}),subscribeToUploadEvents:(e,t)=>i.Effect.gen(function*(){yield*r.subscribe(e,t)}),unsubscribeFromUploadEvents:e=>i.Effect.gen(function*(){yield*r.unsubscribe(e)})}})}const v=i.Layer.effect(g,_());var y=class{constructor(e,t){this.capabilities=e,this.validateUploadStrategy=t}negotiateStrategy(e){let t=[],n=[],r=`single`,i=e.preferredChunkSize??this.capabilities.optimalChunkSize??1024*1024,a=e.parallelUploads??1;if(e.preferredStrategy&&(this.validateUploadStrategy(e.preferredStrategy)?(r=e.preferredStrategy,t.push(`Using preferred strategy: ${r}`)):n.push(`Preferred strategy '${e.preferredStrategy}' not supported by data store, falling back`)),(!e.preferredStrategy||!this.validateUploadStrategy(e.preferredStrategy))&&(this.capabilities.supportsParallelUploads&&e.fileSize>(e.minChunkSizeForParallel??10*1024*1024)?(r=`parallel`,t.push(`Selected parallel upload for large file (${e.fileSize} bytes)`)):(r=`single`,t.push(this.capabilities.supportsParallelUploads?`Selected single upload for small file (${e.fileSize} bytes)`:`Selected single upload (parallel not supported by data store)`))),this.capabilities.minChunkSize&&i<this.capabilities.minChunkSize&&(n.push(`Chunk size ${i} below minimum ${this.capabilities.minChunkSize}, adjusting`),i=this.capabilities.minChunkSize),this.capabilities.maxChunkSize&&i>this.capabilities.maxChunkSize&&(n.push(`Chunk size ${i} above maximum ${this.capabilities.maxChunkSize}, adjusting`),i=this.capabilities.maxChunkSize),r===`parallel`&&(this.capabilities.maxConcurrentUploads&&a>this.capabilities.maxConcurrentUploads&&(n.push(`Parallel uploads ${a} exceeds maximum ${this.capabilities.maxConcurrentUploads}, adjusting`),a=this.capabilities.maxConcurrentUploads),this.capabilities.maxParts)){let t=Math.ceil(e.fileSize/i);if(t>this.capabilities.maxParts){let r=Math.ceil(e.fileSize/this.capabilities.maxParts);n.push(`Estimated parts ${t} exceeds maximum ${this.capabilities.maxParts}, increasing chunk size`),i=Math.max(i,r)}}return this.validateUploadStrategy(r)||(n.push(`Final strategy validation failed, falling back to single upload`),r=`single`,a=1),t.push(`Data store capabilities: parallel=${this.capabilities.supportsParallelUploads}, concatenation=${this.capabilities.supportsConcatenation}, resumable=${this.capabilities.supportsResumableUploads}`),{strategy:r,chunkSize:i,parallelUploads:r===`parallel`?a:1,reasoning:t,warnings:n}}getDataStoreCapabilities(){return this.capabilities}validateConfiguration(e){let t=[];return e.preferredStrategy&&!this.validateUploadStrategy(e.preferredStrategy)&&t.push(`Preferred strategy '${e.preferredStrategy}' not supported by data store`),e.preferredChunkSize&&(this.capabilities.minChunkSize&&e.preferredChunkSize<this.capabilities.minChunkSize&&t.push(`Chunk size ${e.preferredChunkSize} below data store minimum ${this.capabilities.minChunkSize}`),this.capabilities.maxChunkSize&&e.preferredChunkSize>this.capabilities.maxChunkSize&&t.push(`Chunk size ${e.preferredChunkSize} above data store maximum ${this.capabilities.maxChunkSize}`)),e.parallelUploads&&this.capabilities.maxConcurrentUploads&&e.parallelUploads>this.capabilities.maxConcurrentUploads&&t.push(`Parallel uploads ${e.parallelUploads} exceeds data store maximum ${this.capabilities.maxConcurrentUploads}`),{valid:t.length===0,errors:t}}};Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return y}});

package/dist/uploadista-error-CAtkQiAv.d.cts

@@ -0,0 +1,221 @@
+import * as effect_Types0 from "effect/Types";
+import * as effect_Cause0 from "effect/Cause";
+import { Effect } from "effect";
+
+//#region src/errors/uploadista-error.d.ts
+
+/**
+ * Union type of all possible error codes in the Uploadista system.
+ *
+ * Each error code corresponds to a specific error condition with predefined
+ * HTTP status codes and messages in the ERROR_CATALOG.
+ */
+type UploadistaErrorCode = "MISSING_OFFSET" | "ABORTED" | "INVALID_TERMINATION" | "ERR_LOCK_TIMEOUT" | "INVALID_CONTENT_TYPE" | "FLOW_STRUCTURE_ERROR" | "FLOW_CYCLE_ERROR" | "FLOW_NODE_NOT_FOUND" | "FLOW_NODE_ERROR" | "FLOW_NOT_AUTHORIZED" | "FLOW_NOT_FOUND" | "FILE_READ_ERROR" | "FLOW_JOB_NOT_FOUND" | "FLOW_JOB_ERROR" | "DATASTORE_NOT_FOUND" | "FILE_NOT_FOUND" | "INVALID_OFFSET" | "FILE_NO_LONGER_EXISTS" | "ERR_SIZE_EXCEEDED" | "ERR_MAX_SIZE_EXCEEDED" | "INVALID_LENGTH" | "INVALID_METADATA" | "VALIDATION_ERROR" | "STORAGE_NOT_AUTHORIZED" | "UNKNOWN_ERROR" | "FILE_WRITE_ERROR" | "UPLOAD_ID_NOT_FOUND" | "FLOW_OUTPUT_VALIDATION_ERROR" | "FLOW_INPUT_VALIDATION_ERROR" | "CHECKSUM_MISMATCH" | "MIMETYPE_MISMATCH" | "UNSUPPORTED_CHECKSUM_ALGORITHM";
+/**
+ * Catalog of all predefined errors in the Uploadista system.
+ *
+ * Maps error codes to their HTTP status codes and default error messages.
+ * This centralized catalog ensures consistent error handling across all
+ * Uploadista packages and adapters.
+ *
+ * Each error entry contains:
+ * - `status`: HTTP status code (400-500 range)
+ * - `body`: Human-readable error message
+ *
+ * @example
+ * ```typescript
+ * // Access a specific error definition
+ * const fileNotFound = ERROR_CATALOG.FILE_NOT_FOUND;
+ * console.log(fileNotFound.status); // 404
+ * console.log(fileNotFound.body);   // "The file for this url was not found\n"
+ *
+ * // Use with UploadistaError
+ * const error = UploadistaError.fromCode("FILE_NOT_FOUND");
+ * ```
+ */
+declare const ERROR_CATALOG: Readonly<Record<UploadistaErrorCode, {
+  status: number;
+  body: string;
+}>>;
+declare const UploadistaError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "UploadistaError";
+} & Readonly<A>;
+/**
+ * Standard error class for all Uploadista operations.
+ *
+ * UploadistaError provides a consistent error handling approach across the entire
+ * Uploadista ecosystem. Each error has:
+ * - A typed error code from the ERROR_CATALOG
+ * - An HTTP-compatible status code
+ * - A human-readable error message (body)
+ * - Optional additional details and cause information
+ *
+ * This class integrates with Effect-TS for functional error handling and can be
+ * easily converted to an Effect that fails.
+ *
+ * @example
+ * ```typescript
+ * // Create from error code
+ * const error = UploadistaError.fromCode("FILE_NOT_FOUND");
+ *
+ * // Create with custom details
+ * const customError = UploadistaError.fromCode("FLOW_NODE_ERROR", {
+ *   body: "Failed to process image",
+ *   cause: originalError,
+ *   details: { nodeId: "resize-1", fileId: "abc123" }
+ * });
+ *
+ * // Use with Effect
+ * const effect = customError.toEffect<void>();
+ *
+ * // In an Effect pipeline
+ * return Effect.gen(function* () {
+ *   const file = yield* getFile(id);
+ *   if (!file) {
+ *     return yield* UploadistaError.fromCode("FILE_NOT_FOUND").toEffect();
+ *   }
+ *   return file;
+ * });
+ * ```
+ */
+declare class UploadistaError extends UploadistaError_base {
+  readonly code: string;
+  readonly status: number;
+  readonly status_code: number;
+  readonly body: string;
+  readonly details?: unknown;
+  constructor({
+    code,
+    status,
+    body,
+    cause,
+    details
+  }: {
+    code: UploadistaErrorCode | string;
+    status: number;
+    body: string;
+    cause?: unknown;
+    details?: unknown;
+  });
+  /**
+   * Creates an UploadistaError from a predefined error code.
+   *
+   * This is the primary way to create errors in the Uploadista system. Each error code
+   * has a default status and message defined in ERROR_CATALOG, but these can be overridden
+   * for specific use cases.
+   *
+   * @param code - One of the predefined error codes from UploadistaErrorCode
+   * @param overrides - Optional overrides for the default error properties
+   * @param overrides.status - Custom HTTP status code (overrides the default)
+   * @param overrides.body - Custom error message (overrides the default)
+   * @param overrides.details - Additional structured data about the error
+   * @param overrides.cause - The underlying error that caused this error (for error chaining)
+   *
+   * @returns A new UploadistaError instance
+   *
+   * @example
+   * ```typescript
+   * // Use default error
+   * const error = UploadistaError.fromCode("FILE_NOT_FOUND");
+   *
+   * // Override message
+   * const customError = UploadistaError.fromCode("FILE_NOT_FOUND", {
+   *   body: `File with ID ${fileId} was not found in storage`
+   * });
+   *
+   * // Include cause and details
+   * const detailedError = UploadistaError.fromCode("DATASTORE_NOT_FOUND", {
+   *   cause: storageException,
+   *   details: { storageId: "s3-prod", region: "us-east-1" }
+   * });
+   * ```
+   */
+  static fromCode(code: UploadistaErrorCode, overrides?: Partial<Pick<UploadistaError, "status" | "body">> & {
+    details?: unknown;
+    cause?: unknown;
+  }): UploadistaError;
+  /**
+   * Converts this error to an Effect that immediately fails.
+   *
+   * This method integrates UploadistaError with Effect-TS's error handling system,
+   * allowing errors to be used in Effect pipelines with proper type checking.
+   *
+   * @template T - The success type of the Effect (defaults to never since it always fails)
+   * @returns An Effect that fails with this UploadistaError
+   *
+   * @example
+   * ```typescript
+   * const error = UploadistaError.fromCode("FILE_NOT_FOUND");
+   *
+   * // Use in an Effect pipeline
+   * return Effect.gen(function* () {
+   *   const file = yield* kvStore.get(fileId);
+   *   if (!file) {
+   *     return yield* error.toEffect();
+   *   }
+   *   return file;
+   * });
+   * ```
+   */
+  toEffect<T = never>(): Effect.Effect<T, UploadistaError>;
+}
+/**
+ * Type guard to check if an unknown value is an UploadistaError.
+ *
+ * Useful for error handling when catching errors that might be from
+ * different sources or libraries.
+ *
+ * @param error - The value to check
+ * @returns True if the value is an UploadistaError instance
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await someOperation();
+ * } catch (error) {
+ *   if (isUploadistaError(error)) {
+ *     console.log(`Uploadista error: ${error.code} (${error.status})`);
+ *     console.log(error.body);
+ *   } else {
+ *     console.error("Unknown error:", error);
+ *   }
+ * }
+ * ```
+ */
+declare function isUploadistaError(error: unknown): error is UploadistaError;
+/**
+ * Creates an Effect that immediately fails with an UploadistaError.
+ *
+ * This is a convenience function that combines error creation with Effect conversion.
+ * It's equivalent to calling `UploadistaError.fromCode(code, overrides).toEffect()`.
+ *
+ * @param code - One of the predefined error codes from UploadistaErrorCode
+ * @param overrides - Optional overrides for the default error properties
+ * @param overrides.status - Custom HTTP status code
+ * @param overrides.body - Custom error message
+ * @param overrides.details - Additional structured data about the error
+ * @param overrides.cause - The underlying error that caused this error
+ *
+ * @returns An Effect that immediately fails with the created UploadistaError
+ *
+ * @example
+ * ```typescript
+ * // In an Effect pipeline
+ * return Effect.gen(function* () {
+ *   const file = yield* kvStore.get(fileId);
+ *   if (!file) {
+ *     return yield* httpFailure("FILE_NOT_FOUND", {
+ *       details: { fileId }
+ *     });
+ *   }
+ *   return file;
+ * });
+ * ```
+ */
+declare function httpFailure(code: UploadistaErrorCode, overrides?: Partial<Pick<UploadistaError, "status" | "body">> & {
+  details?: unknown;
+  cause?: unknown;
+}): Effect.Effect<never, UploadistaError>;
+//#endregion
+export { isUploadistaError as a, httpFailure as i, UploadistaError as n, UploadistaErrorCode as r, ERROR_CATALOG as t };
+//# sourceMappingURL=uploadista-error-CAtkQiAv.d.cts.map

package/dist/uploadista-error-CAtkQiAv.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadista-error-CAtkQiAv.d.cts","names":[],"sources":["../src/errors/uploadista-error.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAQA;AAwDA;AACS,KAzDG,mBAAA,GAyDH,gBAAA,GAAA,SAAA,GAAA,qBAAA,GAAA,kBAAA,GAAA,sBAAA,GAAA,sBAAA,GAAA,kBAAA,GAAA,qBAAA,GAAA,iBAAA,GAAA,qBAAA,GAAA,gBAAA,GAAA,iBAAA,GAAA,oBAAA,GAAA,gBAAA,GAAA,qBAAA,GAAA,gBAAA,GAAA,gBAAA,GAAA,uBAAA,GAAA,mBAAA,GAAA,uBAAA,GAAA,gBAAA,GAAA,kBAAA,GAAA,kBAAA,GAAA,wBAAA,GAAA,eAAA,GAAA,kBAAA,GAAA,qBAAA,GAAA,8BAAA,GAAA,6BAAA,GAAA,mBAAA,GAAA,mBAAA,GAAA,gCAAA;;;;AAmHE;;;;;;;;;;;;;AAwCX;;;;;;AAeU,cA3KG,aA2KH,EA3KkB,QA2KlB,CA1KR,MA0KQ,CA1KD,mBA0KC,EAAA;EAkDA,MAAA,EAAA,MAAA;EACmB,IAAA,EAAA,MAAA;CAAL,CAAA,CAAA;cA1Gb,oBA0GK,EAAA,IAAA,CAAA,gBAAA,CAAA,MAAA,EAAA,GAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA,IAAA,sBAAA,EAAA,EAAA,CAAA,CAAA,CAAA,SAAA,IAAA,GAAA,IAAA,GAAA,iBAAA,OAAA,KAAA,SAAA,MAAA,GAAA,KAAA,IAAA,IAAA,EAAA,CAAA,EAAA,EAAA,kCAAA;EAIX,SAAA,IAAA,EAAA,iBAAA;CAkCkC,WAAA,EAAA,CAAA;;;;;AA4BvC;AAiCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cArKa,eAAA,SAAwB,oBAAA;;;;;;;;;;;;;UAe3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkDA,iCACM,QAAQ,KAAK;;;MAIxB;;;;;;;;;;;;;;;;;;;;;;;;yBAkCoB,MAAA,CAAO,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;iBA4B1B,iBAAA,2BAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiC5C,WAAA,OACR,iCACM,QAAQ,KAAK;;;IAIxB,MAAA,CAAO,cAAc"}

package/dist/{uploadista-error-BVsVxqvz.js → uploadista-error-CjfcFnVa.js}

@@ -3,6 +3,8 @@ import{Data as e,Effect as t}from"effect";const n={MISSING_OFFSET:{status:403,bo
 `},DATASTORE_NOT_FOUND:{status:500,body:`The datastore was not found
 `},UPLOAD_ID_NOT_FOUND:{status:500,body:`The upload id was not found
 `},FILE_NOT_FOUND:{status:404,body:`The file for this url was not found
+`},FLOW_NOT_AUTHORIZED:{status:401,body:`The flow is not authorized
+`},FLOW_NOT_FOUND:{status:404,body:`The flow was not found
 `},FLOW_STRUCTURE_ERROR:{status:500,body:`The flow structure is invalid
 `},FLOW_CYCLE_ERROR:{status:500,body:`The flow contains a cycle
 `},FLOW_NODE_NOT_FOUND:{status:500,body:`The flow node was not found
@@ -13,11 +15,16 @@ import{Data as e,Effect as t}from"effect";const n={MISSING_OFFSET:{status:403,bo
 `},FLOW_OUTPUT_VALIDATION_ERROR:{status:500,body:`The flow output validation failed
 `},INVALID_OFFSET:{status:409,body:`Upload-Offset conflict
 `},FILE_NO_LONGER_EXISTS:{status:410,body:`The file for this url no longer exists
+`},FILE_READ_ERROR:{status:500,body:`Something went wrong reading the file
 `},ERR_SIZE_EXCEEDED:{status:413,body:`upload's size exceeded
 `},ERR_MAX_SIZE_EXCEEDED:{status:413,body:`Maximum size exceeded
 `},INVALID_LENGTH:{status:400,body:`Upload-Length or Upload-Defer-Length header required
 `},INVALID_METADATA:{status:400,body:`Upload-Metadata is invalid. It MUST consist of one or more comma-separated key-value pairs. The key and value MUST be separated by a space. The key MUST NOT contain spaces and commas and MUST NOT be empty. The key SHOULD be ASCII encoded and the value MUST be Base64 encoded. All keys MUST be unique`},VALIDATION_ERROR:{status:400,body:`Validation failed
+`},STORAGE_NOT_AUTHORIZED:{status:401,body:`The storage is not authorized
 `},UNKNOWN_ERROR:{status:500,body:`Something went wrong with that request
 `},FILE_WRITE_ERROR:{status:500,body:`Something went wrong receiving the file
-`}};var r=class r extends e.TaggedError(`UploadistaError`){code;status;status_code;body;details;constructor({code:e,status:t,body:n,cause:r,details:i}){super(),this.name=`UploadistaError`,this.code=e,this.status=t,this.status_code=t,this.body=n,this.details=i,r&&(this.cause=r)}static fromCode(e,t){let i=n[e];return new r({code:e,status:t?.status??i.status,body:t?.body??i.body,details:t?.details,cause:t?.cause})}toEffect(){return t.fail(this)}};function i(e){return e instanceof r}function a(e,t){return r.fromCode(e,t).toEffect()}export{n as ERROR_CATALOG,r as UploadistaError,a as httpFailureEffect,i as isUploadistaError};
-//# sourceMappingURL=uploadista-error-BVsVxqvz.js.map
+`},CHECKSUM_MISMATCH:{status:400,body:`The file checksum does not match the provided checksum
+`},MIMETYPE_MISMATCH:{status:400,body:`The file MIME type does not match the declared type
+`},UNSUPPORTED_CHECKSUM_ALGORITHM:{status:400,body:`The specified checksum algorithm is not supported
+`}};var r=class r extends e.TaggedError(`UploadistaError`){code;status;status_code;body;details;constructor({code:e,status:t,body:n,cause:r,details:i}){super(),this.name=`UploadistaError`,this.code=e,this.status=t,this.status_code=t,this.body=n,this.details=i,r&&(this.cause=r)}static fromCode(e,t){let i=n[e];return new r({code:e,status:t?.status??i.status,body:t?.body??i.body,details:t?.details,cause:t?.cause})}toEffect(){return t.fail(this)}};function i(e){return e instanceof r}function a(e,t){return r.fromCode(e,t).toEffect()}export{i,r as n,a as r,n as t};
+//# sourceMappingURL=uploadista-error-CjfcFnVa.js.map

package/dist/uploadista-error-CjfcFnVa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadista-error-CjfcFnVa.js","names":["ERROR_CATALOG: Readonly<\n  Record<UploadistaErrorCode, { status: number; body: string }>\n>"],"sources":["../src/errors/uploadista-error.ts"],"sourcesContent":["import { Data, Effect } from \"effect\";\n\n/**\n * Union type of all possible error codes in the Uploadista system.\n *\n * Each error code corresponds to a specific error condition with predefined\n * HTTP status codes and messages in the ERROR_CATALOG.\n */\nexport type UploadistaErrorCode =\n  | \"MISSING_OFFSET\"\n  | \"ABORTED\"\n  | \"INVALID_TERMINATION\"\n  | \"ERR_LOCK_TIMEOUT\"\n  | \"INVALID_CONTENT_TYPE\"\n  | \"FLOW_STRUCTURE_ERROR\"\n  | \"FLOW_CYCLE_ERROR\"\n  | \"FLOW_NODE_NOT_FOUND\"\n  | \"FLOW_NODE_ERROR\"\n  | \"FLOW_NOT_AUTHORIZED\"\n  | \"FLOW_NOT_FOUND\"\n  | \"FILE_READ_ERROR\"\n  | \"FLOW_JOB_NOT_FOUND\"\n  | \"FLOW_JOB_ERROR\"\n  | \"DATASTORE_NOT_FOUND\"\n  | \"FILE_NOT_FOUND\"\n  | \"INVALID_OFFSET\"\n  | \"FILE_NO_LONGER_EXISTS\"\n  | \"ERR_SIZE_EXCEEDED\"\n  | \"ERR_MAX_SIZE_EXCEEDED\"\n  | \"INVALID_LENGTH\"\n  | \"INVALID_METADATA\"\n  | \"VALIDATION_ERROR\"\n  | \"STORAGE_NOT_AUTHORIZED\"\n  | \"UNKNOWN_ERROR\"\n  | \"FILE_WRITE_ERROR\"\n  | \"UPLOAD_ID_NOT_FOUND\"\n  | \"FLOW_OUTPUT_VALIDATION_ERROR\"\n  | \"FLOW_INPUT_VALIDATION_ERROR\"\n  | \"CHECKSUM_MISMATCH\"\n  | \"MIMETYPE_MISMATCH\"\n  | \"UNSUPPORTED_CHECKSUM_ALGORITHM\";\n\n/**\n * Catalog of all predefined errors in the Uploadista system.\n *\n * Maps error codes to their HTTP status codes and default error messages.\n * This centralized catalog ensures consistent error handling across all\n * Uploadista packages and adapters.\n *\n * Each error entry contains:\n * - `status`: HTTP status code (400-500 range)\n * - `body`: Human-readable error message\n *\n * @example\n * ```typescript\n * // Access a specific error definition\n * const fileNotFound = ERROR_CATALOG.FILE_NOT_FOUND;\n * console.log(fileNotFound.status); // 404\n * console.log(fileNotFound.body);   // \"The file for this url was not found\\n\"\n *\n * // Use with UploadistaError\n * const error = UploadistaError.fromCode(\"FILE_NOT_FOUND\");\n * ```\n */\nexport const ERROR_CATALOG: Readonly<\n  Record<UploadistaErrorCode, { status: number; body: string }>\n> = {\n  MISSING_OFFSET: { status: 403, body: \"Upload-Offset header required\\n\" },\n  ABORTED: { status: 400, body: \"Request aborted due to lock acquired\" },\n  INVALID_TERMINATION: {\n    status: 400,\n    body: \"Cannot terminate an already completed upload\",\n  },\n  ERR_LOCK_TIMEOUT: {\n    status: 500,\n    body: \"failed to acquire lock before timeout\",\n  },\n  INVALID_CONTENT_TYPE: {\n    status: 403,\n    body: \"Content-Type header required\\n\",\n  },\n  DATASTORE_NOT_FOUND: {\n    status: 500,\n    body: \"The datastore was not found\\n\",\n  },\n  UPLOAD_ID_NOT_FOUND: {\n    status: 500,\n    body: \"The upload id was not found\\n\",\n  },\n  FILE_NOT_FOUND: {\n    status: 404,\n    body: \"The file for this url was not found\\n\",\n  },\n  FLOW_NOT_AUTHORIZED: {\n    status: 401,\n    body: \"The flow is not authorized\\n\",\n  },\n  FLOW_NOT_FOUND: {\n    status: 404,\n    body: \"The flow was not found\\n\",\n  },\n  FLOW_STRUCTURE_ERROR: {\n    status: 500,\n    body: \"The flow structure is invalid\\n\",\n  },\n  FLOW_CYCLE_ERROR: {\n    status: 500,\n    body: \"The flow contains a cycle\\n\",\n  },\n  FLOW_NODE_NOT_FOUND: {\n    status: 500,\n    body: \"The flow node was not found\\n\",\n  },\n  FLOW_NODE_ERROR: {\n    status: 500,\n    body: \"The flow node failed\\n\",\n  },\n  FLOW_JOB_NOT_FOUND: {\n    status: 404,\n    body: \"The flow job was not found\\n\",\n  },\n  FLOW_JOB_ERROR: {\n    status: 500,\n    body: \"The flow job failed\\n\",\n  },\n  FLOW_INPUT_VALIDATION_ERROR: {\n    status: 500,\n    body: \"The flow input validation failed\\n\",\n  },\n  FLOW_OUTPUT_VALIDATION_ERROR: {\n    status: 500,\n    body: \"The flow output validation failed\\n\",\n  },\n  INVALID_OFFSET: { status: 409, body: \"Upload-Offset conflict\\n\" },\n  FILE_NO_LONGER_EXISTS: {\n    status: 410,\n    body: \"The file for this url no longer exists\\n\",\n  },\n  FILE_READ_ERROR: {\n    status: 500,\n    body: \"Something went wrong reading the file\\n\",\n  },\n  ERR_SIZE_EXCEEDED: { status: 413, body: \"upload's size exceeded\\n\" },\n  ERR_MAX_SIZE_EXCEEDED: { status: 413, body: \"Maximum size exceeded\\n\" },\n  INVALID_LENGTH: {\n    status: 400,\n    body: \"Upload-Length or Upload-Defer-Length header required\\n\",\n  },\n  INVALID_METADATA: {\n    status: 400,\n    body: \"Upload-Metadata is invalid. It MUST consist of one or more comma-separated key-value pairs. The key and value MUST be separated by a space. The key MUST NOT contain spaces and commas and MUST NOT be empty. The key SHOULD be ASCII encoded and the value MUST be Base64 encoded. All keys MUST be unique\",\n  },\n  VALIDATION_ERROR: {\n    status: 400,\n    body: \"Validation failed\\n\",\n  },\n  STORAGE_NOT_AUTHORIZED: {\n    status: 401,\n    body: \"The storage is not authorized\\n\",\n  },\n  UNKNOWN_ERROR: {\n    status: 500,\n    body: \"Something went wrong with that request\\n\",\n  },\n  FILE_WRITE_ERROR: {\n    status: 500,\n    body: \"Something went wrong receiving the file\\n\",\n  },\n  CHECKSUM_MISMATCH: {\n    status: 400,\n    body: \"The file checksum does not match the provided checksum\\n\",\n  },\n  MIMETYPE_MISMATCH: {\n    status: 400,\n    body: \"The file MIME type does not match the declared type\\n\",\n  },\n  UNSUPPORTED_CHECKSUM_ALGORITHM: {\n    status: 400,\n    body: \"The specified checksum algorithm is not supported\\n\",\n  },\n} as const;\n\n/**\n * Standard error class for all Uploadista operations.\n *\n * UploadistaError provides a consistent error handling approach across the entire\n * Uploadista ecosystem. Each error has:\n * - A typed error code from the ERROR_CATALOG\n * - An HTTP-compatible status code\n * - A human-readable error message (body)\n * - Optional additional details and cause information\n *\n * This class integrates with Effect-TS for functional error handling and can be\n * easily converted to an Effect that fails.\n *\n * @example\n * ```typescript\n * // Create from error code\n * const error = UploadistaError.fromCode(\"FILE_NOT_FOUND\");\n *\n * // Create with custom details\n * const customError = UploadistaError.fromCode(\"FLOW_NODE_ERROR\", {\n *   body: \"Failed to process image\",\n *   cause: originalError,\n *   details: { nodeId: \"resize-1\", fileId: \"abc123\" }\n * });\n *\n * // Use with Effect\n * const effect = customError.toEffect<void>();\n *\n * // In an Effect pipeline\n * return Effect.gen(function* () {\n *   const file = yield* getFile(id);\n *   if (!file) {\n *     return yield* UploadistaError.fromCode(\"FILE_NOT_FOUND\").toEffect();\n *   }\n *   return file;\n * });\n * ```\n */\nexport class UploadistaError extends Data.TaggedError(\"UploadistaError\") {\n  readonly code: string;\n  readonly status: number;\n  // Keep legacy property names for backward compatibility\n  readonly status_code: number;\n  readonly body: string;\n  readonly details?: unknown;\n\n  constructor({\n    code,\n    status,\n    body,\n    cause,\n    details,\n  }: {\n    code: UploadistaErrorCode | string;\n    status: number;\n    body: string;\n    cause?: unknown;\n    details?: unknown;\n  }) {\n    super();\n    this.name = \"UploadistaError\";\n    this.code = code;\n    this.status = status;\n    this.status_code = status; // legacy alias\n    this.body = body;\n    this.details = details;\n    if (cause) (this as unknown as { cause?: unknown }).cause = cause;\n  }\n\n  /**\n   * Creates an UploadistaError from a predefined error code.\n   *\n   * This is the primary way to create errors in the Uploadista system. Each error code\n   * has a default status and message defined in ERROR_CATALOG, but these can be overridden\n   * for specific use cases.\n   *\n   * @param code - One of the predefined error codes from UploadistaErrorCode\n   * @param overrides - Optional overrides for the default error properties\n   * @param overrides.status - Custom HTTP status code (overrides the default)\n   * @param overrides.body - Custom error message (overrides the default)\n   * @param overrides.details - Additional structured data about the error\n   * @param overrides.cause - The underlying error that caused this error (for error chaining)\n   *\n   * @returns A new UploadistaError instance\n   *\n   * @example\n   * ```typescript\n   * // Use default error\n   * const error = UploadistaError.fromCode(\"FILE_NOT_FOUND\");\n   *\n   * // Override message\n   * const customError = UploadistaError.fromCode(\"FILE_NOT_FOUND\", {\n   *   body: `File with ID ${fileId} was not found in storage`\n   * });\n   *\n   * // Include cause and details\n   * const detailedError = UploadistaError.fromCode(\"DATASTORE_NOT_FOUND\", {\n   *   cause: storageException,\n   *   details: { storageId: \"s3-prod\", region: \"us-east-1\" }\n   * });\n   * ```\n   */\n  static fromCode(\n    code: UploadistaErrorCode,\n    overrides?: Partial<Pick<UploadistaError, \"status\" | \"body\">> & {\n      details?: unknown;\n      cause?: unknown;\n    }\n  ): UploadistaError {\n    const base = ERROR_CATALOG[code];\n    return new UploadistaError({\n      code,\n      status: overrides?.status ?? base.status,\n      body: overrides?.body ?? base.body,\n      details: overrides?.details,\n      cause: overrides?.cause,\n    });\n  }\n\n  /**\n   * Converts this error to an Effect that immediately fails.\n   *\n   * This method integrates UploadistaError with Effect-TS's error handling system,\n   * allowing errors to be used in Effect pipelines with proper type checking.\n   *\n   * @template T - The success type of the Effect (defaults to never since it always fails)\n   * @returns An Effect that fails with this UploadistaError\n   *\n   * @example\n   * ```typescript\n   * const error = UploadistaError.fromCode(\"FILE_NOT_FOUND\");\n   *\n   * // Use in an Effect pipeline\n   * return Effect.gen(function* () {\n   *   const file = yield* kvStore.get(fileId);\n   *   if (!file) {\n   *     return yield* error.toEffect();\n   *   }\n   *   return file;\n   * });\n   * ```\n   */\n  toEffect<T = never>(): Effect.Effect<T, UploadistaError> {\n    return Effect.fail(this);\n  }\n}\n\n/**\n * Type guard to check if an unknown value is an UploadistaError.\n *\n * Useful for error handling when catching errors that might be from\n * different sources or libraries.\n *\n * @param error - The value to check\n * @returns True if the value is an UploadistaError instance\n *\n * @example\n * ```typescript\n * try {\n *   await someOperation();\n * } catch (error) {\n *   if (isUploadistaError(error)) {\n *     console.log(`Uploadista error: ${error.code} (${error.status})`);\n *     console.log(error.body);\n *   } else {\n *     console.error(\"Unknown error:\", error);\n *   }\n * }\n * ```\n */\nexport function isUploadistaError(error: unknown): error is UploadistaError {\n  return error instanceof UploadistaError;\n}\n\n/**\n * Creates an Effect that immediately fails with an UploadistaError.\n *\n * This is a convenience function that combines error creation with Effect conversion.\n * It's equivalent to calling `UploadistaError.fromCode(code, overrides).toEffect()`.\n *\n * @param code - One of the predefined error codes from UploadistaErrorCode\n * @param overrides - Optional overrides for the default error properties\n * @param overrides.status - Custom HTTP status code\n * @param overrides.body - Custom error message\n * @param overrides.details - Additional structured data about the error\n * @param overrides.cause - The underlying error that caused this error\n *\n * @returns An Effect that immediately fails with the created UploadistaError\n *\n * @example\n * ```typescript\n * // In an Effect pipeline\n * return Effect.gen(function* () {\n *   const file = yield* kvStore.get(fileId);\n *   if (!file) {\n *     return yield* httpFailure(\"FILE_NOT_FOUND\", {\n *       details: { fileId }\n *     });\n *   }\n *   return file;\n * });\n * ```\n */\nexport function httpFailure(\n  code: UploadistaErrorCode,\n  overrides?: Partial<Pick<UploadistaError, \"status\" | \"body\">> & {\n    details?: unknown;\n    cause?: unknown;\n  }\n): Effect.Effect<never, UploadistaError> {\n  return UploadistaError.fromCode(code, overrides).toEffect();\n}\n"],"mappings":"0CAgEA,MAAaA,EAET,CACF,eAAgB,CAAE,OAAQ,IAAK,KAAM;EAAmC,CACxE,QAAS,CAAE,OAAQ,IAAK,KAAM,uCAAwC,CACtE,oBAAqB,CACnB,OAAQ,IACR,KAAM,+CACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM,wCACP,CACD,qBAAsB,CACpB,OAAQ,IACR,KAAM;EACP,CACD,oBAAqB,CACnB,OAAQ,IACR,KAAM;EACP,CACD,oBAAqB,CACnB,OAAQ,IACR,KAAM;EACP,CACD,eAAgB,CACd,OAAQ,IACR,KAAM;EACP,CACD,oBAAqB,CACnB,OAAQ,IACR,KAAM;EACP,CACD,eAAgB,CACd,OAAQ,IACR,KAAM;EACP,CACD,qBAAsB,CACpB,OAAQ,IACR,KAAM;EACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM;EACP,CACD,oBAAqB,CACnB,OAAQ,IACR,KAAM;EACP,CACD,gBAAiB,CACf,OAAQ,IACR,KAAM;EACP,CACD,mBAAoB,CAClB,OAAQ,IACR,KAAM;EACP,CACD,eAAgB,CACd,OAAQ,IACR,KAAM;EACP,CACD,4BAA6B,CAC3B,OAAQ,IACR,KAAM;EACP,CACD,6BAA8B,CAC5B,OAAQ,IACR,KAAM;EACP,CACD,eAAgB,CAAE,OAAQ,IAAK,KAAM;EAA4B,CACjE,sBAAuB,CACrB,OAAQ,IACR,KAAM;EACP,CACD,gBAAiB,CACf,OAAQ,IACR,KAAM;EACP,CACD,kBAAmB,CAAE,OAAQ,IAAK,KAAM;EAA4B,CACpE,sBAAuB,CAAE,OAAQ,IAAK,KAAM;EAA2B,CACvE,eAAgB,CACd,OAAQ,IACR,KAAM;EACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM,8SACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM;EACP,CACD,uBAAwB,CACtB,OAAQ,IACR,KAAM;EACP,CACD,cAAe,CACb,OAAQ,IACR,KAAM;EACP,CACD,iBAAkB,CAChB,OAAQ,IACR,KAAM;EACP,CACD,kBAAmB,CACjB,OAAQ,IACR,KAAM;EACP,CACD,kBAAmB,CACjB,OAAQ,IACR,KAAM;EACP,CACD,+BAAgC,CAC9B,OAAQ,IACR,KAAM;EACP,CACF,CAwCD,IAAa,EAAb,MAAa,UAAwB,EAAK,YAAY,kBAAkB,AAAC,CACvE,KACA,OAEA,YACA,KACA,QAEA,YAAY,CACV,OACA,SACA,OACA,QACA,WAOC,CACD,OAAO,CACP,KAAK,KAAO,kBACZ,KAAK,KAAO,EACZ,KAAK,OAAS,EACd,KAAK,YAAc,EACnB,KAAK,KAAO,EACZ,KAAK,QAAU,EACX,IAAQ,KAAwC,MAAQ,GAoC9D,OAAO,SACL,EACA,EAIiB,CACjB,IAAM,EAAO,EAAc,GAC3B,OAAO,IAAI,EAAgB,CACzB,OACA,OAAQ,GAAW,QAAU,EAAK,OAClC,KAAM,GAAW,MAAQ,EAAK,KAC9B,QAAS,GAAW,QACpB,MAAO,GAAW,MACnB,CAAC,CA0BJ,UAAyD,CACvD,OAAO,EAAO,KAAK,KAAK,GA2B5B,SAAgB,EAAkB,EAA0C,CAC1E,OAAO,aAAiB,EAgC1B,SAAgB,EACd,EACA,EAIuC,CACvC,OAAO,EAAgB,SAAS,EAAM,EAAU,CAAC,UAAU"}

package/dist/uploadista-error-D9SONF9K.d.ts

@@ -0,0 +1,221 @@
+import { Effect } from "effect";
+import * as effect_Types0 from "effect/Types";
+import * as effect_Cause0 from "effect/Cause";
+
+//#region src/errors/uploadista-error.d.ts
+
+/**
+ * Union type of all possible error codes in the Uploadista system.
+ *
+ * Each error code corresponds to a specific error condition with predefined
+ * HTTP status codes and messages in the ERROR_CATALOG.
+ */
+type UploadistaErrorCode = "MISSING_OFFSET" | "ABORTED" | "INVALID_TERMINATION" | "ERR_LOCK_TIMEOUT" | "INVALID_CONTENT_TYPE" | "FLOW_STRUCTURE_ERROR" | "FLOW_CYCLE_ERROR" | "FLOW_NODE_NOT_FOUND" | "FLOW_NODE_ERROR" | "FLOW_NOT_AUTHORIZED" | "FLOW_NOT_FOUND" | "FILE_READ_ERROR" | "FLOW_JOB_NOT_FOUND" | "FLOW_JOB_ERROR" | "DATASTORE_NOT_FOUND" | "FILE_NOT_FOUND" | "INVALID_OFFSET" | "FILE_NO_LONGER_EXISTS" | "ERR_SIZE_EXCEEDED" | "ERR_MAX_SIZE_EXCEEDED" | "INVALID_LENGTH" | "INVALID_METADATA" | "VALIDATION_ERROR" | "STORAGE_NOT_AUTHORIZED" | "UNKNOWN_ERROR" | "FILE_WRITE_ERROR" | "UPLOAD_ID_NOT_FOUND" | "FLOW_OUTPUT_VALIDATION_ERROR" | "FLOW_INPUT_VALIDATION_ERROR" | "CHECKSUM_MISMATCH" | "MIMETYPE_MISMATCH" | "UNSUPPORTED_CHECKSUM_ALGORITHM";
+/**
+ * Catalog of all predefined errors in the Uploadista system.
+ *
+ * Maps error codes to their HTTP status codes and default error messages.
+ * This centralized catalog ensures consistent error handling across all
+ * Uploadista packages and adapters.
+ *
+ * Each error entry contains:
+ * - `status`: HTTP status code (400-500 range)
+ * - `body`: Human-readable error message
+ *
+ * @example
+ * ```typescript
+ * // Access a specific error definition
+ * const fileNotFound = ERROR_CATALOG.FILE_NOT_FOUND;
+ * console.log(fileNotFound.status); // 404
+ * console.log(fileNotFound.body);   // "The file for this url was not found\n"
+ *
+ * // Use with UploadistaError
+ * const error = UploadistaError.fromCode("FILE_NOT_FOUND");
+ * ```
+ */
+declare const ERROR_CATALOG: Readonly<Record<UploadistaErrorCode, {
+  status: number;
+  body: string;
+}>>;
+declare const UploadistaError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "UploadistaError";
+} & Readonly<A>;
+/**
+ * Standard error class for all Uploadista operations.
+ *
+ * UploadistaError provides a consistent error handling approach across the entire
+ * Uploadista ecosystem. Each error has:
+ * - A typed error code from the ERROR_CATALOG
+ * - An HTTP-compatible status code
+ * - A human-readable error message (body)
+ * - Optional additional details and cause information
+ *
+ * This class integrates with Effect-TS for functional error handling and can be
+ * easily converted to an Effect that fails.
+ *
+ * @example
+ * ```typescript
+ * // Create from error code
+ * const error = UploadistaError.fromCode("FILE_NOT_FOUND");
+ *
+ * // Create with custom details
+ * const customError = UploadistaError.fromCode("FLOW_NODE_ERROR", {
+ *   body: "Failed to process image",
+ *   cause: originalError,
+ *   details: { nodeId: "resize-1", fileId: "abc123" }
+ * });
+ *
+ * // Use with Effect
+ * const effect = customError.toEffect<void>();
+ *
+ * // In an Effect pipeline
+ * return Effect.gen(function* () {
+ *   const file = yield* getFile(id);
+ *   if (!file) {
+ *     return yield* UploadistaError.fromCode("FILE_NOT_FOUND").toEffect();
+ *   }
+ *   return file;
+ * });
+ * ```
+ */
+declare class UploadistaError extends UploadistaError_base {
+  readonly code: string;
+  readonly status: number;
+  readonly status_code: number;
+  readonly body: string;
+  readonly details?: unknown;
+  constructor({
+    code,
+    status,
+    body,
+    cause,
+    details
+  }: {
+    code: UploadistaErrorCode | string;
+    status: number;
+    body: string;
+    cause?: unknown;
+    details?: unknown;
+  });
+  /**
+   * Creates an UploadistaError from a predefined error code.
+   *
+   * This is the primary way to create errors in the Uploadista system. Each error code
+   * has a default status and message defined in ERROR_CATALOG, but these can be overridden
+   * for specific use cases.
+   *
+   * @param code - One of the predefined error codes from UploadistaErrorCode
+   * @param overrides - Optional overrides for the default error properties
+   * @param overrides.status - Custom HTTP status code (overrides the default)
+   * @param overrides.body - Custom error message (overrides the default)
+   * @param overrides.details - Additional structured data about the error
+   * @param overrides.cause - The underlying error that caused this error (for error chaining)
+   *
+   * @returns A new UploadistaError instance
+   *
+   * @example
+   * ```typescript
+   * // Use default error
+   * const error = UploadistaError.fromCode("FILE_NOT_FOUND");
+   *
+   * // Override message
+   * const customError = UploadistaError.fromCode("FILE_NOT_FOUND", {
+   *   body: `File with ID ${fileId} was not found in storage`
+   * });
+   *
+   * // Include cause and details
+   * const detailedError = UploadistaError.fromCode("DATASTORE_NOT_FOUND", {
+   *   cause: storageException,
+   *   details: { storageId: "s3-prod", region: "us-east-1" }
+   * });
+   * ```
+   */
+  static fromCode(code: UploadistaErrorCode, overrides?: Partial<Pick<UploadistaError, "status" | "body">> & {
+    details?: unknown;
+    cause?: unknown;
+  }): UploadistaError;
+  /**
+   * Converts this error to an Effect that immediately fails.
+   *
+   * This method integrates UploadistaError with Effect-TS's error handling system,
+   * allowing errors to be used in Effect pipelines with proper type checking.
+   *
+   * @template T - The success type of the Effect (defaults to never since it always fails)
+   * @returns An Effect that fails with this UploadistaError
+   *
+   * @example
+   * ```typescript
+   * const error = UploadistaError.fromCode("FILE_NOT_FOUND");
+   *
+   * // Use in an Effect pipeline
+   * return Effect.gen(function* () {
+   *   const file = yield* kvStore.get(fileId);
+   *   if (!file) {
+   *     return yield* error.toEffect();
+   *   }
+   *   return file;
+   * });
+   * ```
+   */
+  toEffect<T = never>(): Effect.Effect<T, UploadistaError>;
+}
+/**
+ * Type guard to check if an unknown value is an UploadistaError.
+ *
+ * Useful for error handling when catching errors that might be from
+ * different sources or libraries.
+ *
+ * @param error - The value to check
+ * @returns True if the value is an UploadistaError instance
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await someOperation();
+ * } catch (error) {
+ *   if (isUploadistaError(error)) {
+ *     console.log(`Uploadista error: ${error.code} (${error.status})`);
+ *     console.log(error.body);
+ *   } else {
+ *     console.error("Unknown error:", error);
+ *   }
+ * }
+ * ```
+ */
+declare function isUploadistaError(error: unknown): error is UploadistaError;
+/**
+ * Creates an Effect that immediately fails with an UploadistaError.
+ *
+ * This is a convenience function that combines error creation with Effect conversion.
+ * It's equivalent to calling `UploadistaError.fromCode(code, overrides).toEffect()`.
+ *
+ * @param code - One of the predefined error codes from UploadistaErrorCode
+ * @param overrides - Optional overrides for the default error properties
+ * @param overrides.status - Custom HTTP status code
+ * @param overrides.body - Custom error message
+ * @param overrides.details - Additional structured data about the error
+ * @param overrides.cause - The underlying error that caused this error
+ *
+ * @returns An Effect that immediately fails with the created UploadistaError
+ *
+ * @example
+ * ```typescript
+ * // In an Effect pipeline
+ * return Effect.gen(function* () {
+ *   const file = yield* kvStore.get(fileId);
+ *   if (!file) {
+ *     return yield* httpFailure("FILE_NOT_FOUND", {
+ *       details: { fileId }
+ *     });
+ *   }
+ *   return file;
+ * });
+ * ```
+ */
+declare function httpFailure(code: UploadistaErrorCode, overrides?: Partial<Pick<UploadistaError, "status" | "body">> & {
+  details?: unknown;
+  cause?: unknown;
+}): Effect.Effect<never, UploadistaError>;
+//#endregion
+export { isUploadistaError as a, httpFailure as i, UploadistaError as n, UploadistaErrorCode as r, ERROR_CATALOG as t };
+//# sourceMappingURL=uploadista-error-D9SONF9K.d.ts.map

package/dist/uploadista-error-D9SONF9K.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadista-error-D9SONF9K.d.ts","names":[],"sources":["../src/errors/uploadista-error.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAQA;AAwDA;AACS,KAzDG,mBAAA,GAyDH,gBAAA,GAAA,SAAA,GAAA,qBAAA,GAAA,kBAAA,GAAA,sBAAA,GAAA,sBAAA,GAAA,kBAAA,GAAA,qBAAA,GAAA,iBAAA,GAAA,qBAAA,GAAA,gBAAA,GAAA,iBAAA,GAAA,oBAAA,GAAA,gBAAA,GAAA,qBAAA,GAAA,gBAAA,GAAA,gBAAA,GAAA,uBAAA,GAAA,mBAAA,GAAA,uBAAA,GAAA,gBAAA,GAAA,kBAAA,GAAA,kBAAA,GAAA,wBAAA,GAAA,eAAA,GAAA,kBAAA,GAAA,qBAAA,GAAA,8BAAA,GAAA,6BAAA,GAAA,mBAAA,GAAA,mBAAA,GAAA,gCAAA;;;;AAmHE;;;;;;;;;;;;;AAwCX;;;;;;AAeU,cA3KG,aA2KH,EA3KkB,QA2KlB,CA1KR,MA0KQ,CA1KD,mBA0KC,EAAA;EAkDA,MAAA,EAAA,MAAA;EACmB,IAAA,EAAA,MAAA;CAAL,CAAA,CAAA;cA1Gb,oBA0GK,EAAA,IAAA,CAAA,gBAAA,CAAA,MAAA,EAAA,GAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA,IAAA,sBAAA,EAAA,EAAA,CAAA,CAAA,CAAA,SAAA,IAAA,GAAA,IAAA,GAAA,iBAAA,OAAA,KAAA,SAAA,MAAA,GAAA,KAAA,IAAA,IAAA,EAAA,CAAA,EAAA,EAAA,kCAAA;EAIX,SAAA,IAAA,EAAA,iBAAA;CAkCkC,WAAA,EAAA,CAAA;;;;;AA4BvC;AAiCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cArKa,eAAA,SAAwB,oBAAA;;;;;;;;;;;;;UAe3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkDA,iCACM,QAAQ,KAAK;;;MAIxB;;;;;;;;;;;;;;;;;;;;;;;;yBAkCoB,MAAA,CAAO,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;iBA4B1B,iBAAA,2BAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiC5C,WAAA,OACR,iCACM,QAAQ,KAAK;;;IAIxB,MAAA,CAAO,cAAc"}

package/dist/{uploadista-error-BB-Wdiz9.cjs → uploadista-error-DdTP-Rjx.cjs}

@@ -1,8 +1,10 @@
-const e=require(`./chunk-CUT6urMc.cjs`);let t=require(`effect`);t=e.__toESM(t);const n={MISSING_OFFSET:{status:403,body:`Upload-Offset header required
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`effect`);c=s(c);const l={MISSING_OFFSET:{status:403,body:`Upload-Offset header required
 `},ABORTED:{status:400,body:`Request aborted due to lock acquired`},INVALID_TERMINATION:{status:400,body:`Cannot terminate an already completed upload`},ERR_LOCK_TIMEOUT:{status:500,body:`failed to acquire lock before timeout`},INVALID_CONTENT_TYPE:{status:403,body:`Content-Type header required
 `},DATASTORE_NOT_FOUND:{status:500,body:`The datastore was not found
 `},UPLOAD_ID_NOT_FOUND:{status:500,body:`The upload id was not found
 `},FILE_NOT_FOUND:{status:404,body:`The file for this url was not found
+`},FLOW_NOT_AUTHORIZED:{status:401,body:`The flow is not authorized
+`},FLOW_NOT_FOUND:{status:404,body:`The flow was not found
 `},FLOW_STRUCTURE_ERROR:{status:500,body:`The flow structure is invalid
 `},FLOW_CYCLE_ERROR:{status:500,body:`The flow contains a cycle
 `},FLOW_NODE_NOT_FOUND:{status:500,body:`The flow node was not found
@@ -13,10 +15,15 @@ const e=require(`./chunk-CUT6urMc.cjs`);let t=require(`effect`);t=e.__toESM(t);c
 `},FLOW_OUTPUT_VALIDATION_ERROR:{status:500,body:`The flow output validation failed
 `},INVALID_OFFSET:{status:409,body:`Upload-Offset conflict
 `},FILE_NO_LONGER_EXISTS:{status:410,body:`The file for this url no longer exists
+`},FILE_READ_ERROR:{status:500,body:`Something went wrong reading the file
 `},ERR_SIZE_EXCEEDED:{status:413,body:`upload's size exceeded
 `},ERR_MAX_SIZE_EXCEEDED:{status:413,body:`Maximum size exceeded
 `},INVALID_LENGTH:{status:400,body:`Upload-Length or Upload-Defer-Length header required
 `},INVALID_METADATA:{status:400,body:`Upload-Metadata is invalid. It MUST consist of one or more comma-separated key-value pairs. The key and value MUST be separated by a space. The key MUST NOT contain spaces and commas and MUST NOT be empty. The key SHOULD be ASCII encoded and the value MUST be Base64 encoded. All keys MUST be unique`},VALIDATION_ERROR:{status:400,body:`Validation failed
+`},STORAGE_NOT_AUTHORIZED:{status:401,body:`The storage is not authorized
 `},UNKNOWN_ERROR:{status:500,body:`Something went wrong with that request
 `},FILE_WRITE_ERROR:{status:500,body:`Something went wrong receiving the file
-`}};var r=class e extends t.Data.TaggedError(`UploadistaError`){code;status;status_code;body;details;constructor({code:e,status:t,body:n,cause:r,details:i}){super(),this.name=`UploadistaError`,this.code=e,this.status=t,this.status_code=t,this.body=n,this.details=i,r&&(this.cause=r)}static fromCode(t,r){let i=n[t];return new e({code:t,status:r?.status??i.status,body:r?.body??i.body,details:r?.details,cause:r?.cause})}toEffect(){return t.Effect.fail(this)}};function i(e){return e instanceof r}function a(e,t){return r.fromCode(e,t).toEffect()}Object.defineProperty(exports,`ERROR_CATALOG`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`UploadistaError`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`httpFailureEffect`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`isUploadistaError`,{enumerable:!0,get:function(){return i}});
+`},CHECKSUM_MISMATCH:{status:400,body:`The file checksum does not match the provided checksum
+`},MIMETYPE_MISMATCH:{status:400,body:`The file MIME type does not match the declared type
+`},UNSUPPORTED_CHECKSUM_ALGORITHM:{status:400,body:`The specified checksum algorithm is not supported
+`}};var u=class e extends c.Data.TaggedError(`UploadistaError`){code;status;status_code;body;details;constructor({code:e,status:t,body:n,cause:r,details:i}){super(),this.name=`UploadistaError`,this.code=e,this.status=t,this.status_code=t,this.body=n,this.details=i,r&&(this.cause=r)}static fromCode(t,n){let r=l[t];return new e({code:t,status:n?.status??r.status,body:n?.body??r.body,details:n?.details,cause:n?.cause})}toEffect(){return c.Effect.fail(this)}};function d(e){return e instanceof u}function f(e,t){return u.fromCode(e,t).toEffect()}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return l}});

package/dist/utils/index.cjs

@@ -0,0 +1 @@
+require(`../uploadista-error-DdTP-Rjx.cjs`);const e=require(`../checksum-wSBuXX84.cjs`),t=require(`../utils-BLsIUd8c.cjs`);exports.GenerateId=e.r,exports.GenerateIdLive=e.i,exports.GenerateIdRandom=e.a,exports.GenerateIdService=e.o,exports.GenerateIdTimestamp=e.s,exports.Md5=t.a,exports.OnceEffect=t.r,exports.ThrottleEffect=t.t,exports.computeChecksum=e.t,exports.isSupportedAlgorithm=e.n,exports.once=t.i,exports.throttle=t.n;

package/dist/utils/index.d.cts

@@ -0,0 +1,3 @@
+import "../uploadista-error-CAtkQiAv.cjs";
+import { a as Md5, c as isSupportedAlgorithm, d as GenerateIdRandom, f as GenerateIdService, i as once, l as GenerateId, m as GenerateIdTimestamp, n as throttle, o as ChecksumAlgorithm, p as GenerateIdShape, r as OnceEffect, s as computeChecksum, t as ThrottleEffect, u as GenerateIdLive } from "../index-GLPiXqj4.cjs";
+export { ChecksumAlgorithm, GenerateId, GenerateIdLive, GenerateIdRandom, GenerateIdService, GenerateIdShape, GenerateIdTimestamp, Md5, OnceEffect, ThrottleEffect, computeChecksum, isSupportedAlgorithm, once, throttle };

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+import "../uploadista-error-D9SONF9K.js";
+import { a as Md5, c as isSupportedAlgorithm, d as GenerateIdRandom, f as GenerateIdService, i as once, l as GenerateId, m as GenerateIdTimestamp, n as throttle, o as ChecksumAlgorithm, p as GenerateIdShape, r as OnceEffect, s as computeChecksum, t as ThrottleEffect, u as GenerateIdLive } from "../index-DMJv8Tvo.js";
+export { ChecksumAlgorithm, GenerateId, GenerateIdLive, GenerateIdRandom, GenerateIdService, GenerateIdShape, GenerateIdTimestamp, Md5, OnceEffect, ThrottleEffect, computeChecksum, isSupportedAlgorithm, once, throttle };

package/dist/utils/index.js

@@ -0,0 +1 @@
+import"../uploadista-error-CjfcFnVa.js";import{a as e,i as t,n,o as r,r as i,s as a,t as o}from"../checksum-C5qE-5eg.js";import{a as s,i as c,n as l,r as u,t as d}from"../utils-BILytQlb.js";export{i as GenerateId,t as GenerateIdLive,e as GenerateIdRandom,r as GenerateIdService,a as GenerateIdTimestamp,s as Md5,u as OnceEffect,d as ThrottleEffect,o as computeChecksum,n as isSupportedAlgorithm,c as once,l as throttle};

package/dist/utils-BILytQlb.js

@@ -0,0 +1,2 @@
+import{n as e}from"./uploadista-error-CjfcFnVa.js";import{Effect as t}from"effect";var n=class e{static hashStr(t,n=!1){return e.onePassHasher.start().appendStr(t).end(n)}static hashAsciiStr(t,n=!1){return e.onePassHasher.start().appendAsciiStr(t).end(n)}static stateIdentity=new Int32Array([1732584193,-271733879,-1732584194,271733878]);static buffer32Identity=new Int32Array([0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]);static hexChars=`0123456789abcdef`;static hexOut=[];static onePassHasher=new e;static _hex(t){let n=e.hexChars,r=e.hexOut,i,a,o,s;for(s=0;s<4;s+=1)for(a=s*8,i=t[s]??0,o=0;o<8;o+=2)r[a+1+o]=n.charAt(i&15),i>>>=4,r[a+0+o]=n.charAt(i&15),i>>>=4;return r.join(``)}static _md5cycle(e,t){let n=e[0]??0,r=e[1]??0,i=e[2]??0,a=e[3]??0;n+=(r&i|~r&a)+(t[0]??0)-680876936|0,n=(n<<7|n>>>25)+r|0,a+=(n&r|~n&i)+(t[1]??0)-389564586|0,a=(a<<12|a>>>20)+n|0,i+=(a&n|~a&r)+(t[2]??0)+606105819|0,i=(i<<17|i>>>15)+a|0,r+=(i&a|~i&n)+(t[3]??0)-1044525330|0,r=(r<<22|r>>>10)+i|0,n+=(r&i|~r&a)+(t[4]??0)-176418897|0,n=(n<<7|n>>>25)+r|0,a+=(n&r|~n&i)+(t[5]??0)+1200080426|0,a=(a<<12|a>>>20)+n|0,i+=(a&n|~a&r)+(t[6]??0)-1473231341|0,i=(i<<17|i>>>15)+a|0,r+=(i&a|~i&n)+(t[7]??0)-45705983|0,r=(r<<22|r>>>10)+i|0,n+=(r&i|~r&a)+(t[8]??0)+1770035416|0,n=(n<<7|n>>>25)+r|0,a+=(n&r|~n&i)+(t[9]??0)-1958414417|0,a=(a<<12|a>>>20)+n|0,i+=(a&n|~a&r)+(t[10]??0)-42063|0,i=(i<<17|i>>>15)+a|0,r+=(i&a|~i&n)+(t[11]??0)-1990404162|0,r=(r<<22|r>>>10)+i|0,n+=(r&i|~r&a)+(t[12]??0)+1804603682|0,n=(n<<7|n>>>25)+r|0,a+=(n&r|~n&i)+(t[13]??0)-40341101|0,a=(a<<12|a>>>20)+n|0,i+=(a&n|~a&r)+(t[14]??0)-1502002290|0,i=(i<<17|i>>>15)+a|0,r+=(i&a|~i&n)+(t[15]??0)+1236535329|0,r=(r<<22|r>>>10)+i|0,n+=(r&a|i&~a)+(t[1]??0)-165796510|0,n=(n<<5|n>>>27)+r|0,a+=(n&i|r&~i)+(t[6]??0)-1069501632|0,a=(a<<9|a>>>23)+n|0,i+=(a&r|n&~r)+(t[11]??0)+643717713|0,i=(i<<14|i>>>18)+a|0,r+=(i&n|a&~n)+(t[0]??0)-373897302|0,r=(r<<20|r>>>12)+i|0,n+=(r&a|i&~a)+(t[5]??0)-701558691|0,n=(n<<5|n>>>27)+r|0,a+=(n&i|r&~i)+(t[10]??0)+38016083|0,a=(a<<9|a>>>23)+n|0,i+=(a&r|n&~r)+(t[15]??0)-660478335|0,i=(i<<14|i>>>18)+a|0,r+=(i&n|a&~n)+(t[4]??0)-405537848|0,r=(r<<20|r>>>12)+i|0,n+=(r&a|i&~a)+(t[9]??0)+568446438|0,n=(n<<5|n>>>27)+r|0,a+=(n&i|r&~i)+(t[14]??0)-1019803690|0,a=(a<<9|a>>>23)+n|0,i+=(a&r|n&~r)+(t[3]??0)-187363961|0,i=(i<<14|i>>>18)+a|0,r+=(i&n|a&~n)+(t[8]??0)+1163531501|0,r=(r<<20|r>>>12)+i|0,n+=(r&a|i&~a)+(t[13]??0)-1444681467|0,n=(n<<5|n>>>27)+r|0,a+=(n&i|r&~i)+(t[2]??0)-51403784|0,a=(a<<9|a>>>23)+n|0,i+=(a&r|n&~r)+(t[7]??0)+1735328473|0,i=(i<<14|i>>>18)+a|0,r+=(i&n|a&~n)+(t[12]??0)-1926607734|0,r=(r<<20|r>>>12)+i|0,n+=(r^i^a)+(t[5]??0)-378558|0,n=(n<<4|n>>>28)+r|0,a+=(n^r^i)+(t[8]??0)-2022574463|0,a=(a<<11|a>>>21)+n|0,i+=(a^n^r)+(t[11]??0)+1839030562|0,i=(i<<16|i>>>16)+a|0,r+=(i^a^n)+(t[14]??0)-35309556|0,r=(r<<23|r>>>9)+i|0,n+=(r^i^a)+(t[1]??0)-1530992060|0,n=(n<<4|n>>>28)+r|0,a+=(n^r^i)+(t[4]??0)+1272893353|0,a=(a<<11|a>>>21)+n|0,i+=(a^n^r)+(t[7]??0)-155497632|0,i=(i<<16|i>>>16)+a|0,r+=(i^a^n)+(t[10]??0)-1094730640|0,r=(r<<23|r>>>9)+i|0,n+=(r^i^a)+(t[13]??0)+681279174|0,n=(n<<4|n>>>28)+r|0,a+=(n^r^i)+(t[0]??0)-358537222|0,a=(a<<11|a>>>21)+n|0,i+=(a^n^r)+(t[3]??0)-722521979|0,i=(i<<16|i>>>16)+a|0,r+=(i^a^n)+(t[6]??0)+76029189|0,r=(r<<23|r>>>9)+i|0,n+=(r^i^a)+(t[9]??0)-640364487|0,n=(n<<4|n>>>28)+r|0,a+=(n^r^i)+(t[12]??0)-421815835|0,a=(a<<11|a>>>21)+n|0,i+=(a^n^r)+(t[15]??0)+530742520|0,i=(i<<16|i>>>16)+a|0,r+=(i^a^n)+(t[2]??0)-995338651|0,r=(r<<23|r>>>9)+i|0,n+=(i^(r|~a))+(t[0]??0)-198630844|0,n=(n<<6|n>>>26)+r|0,a+=(r^(n|~i))+(t[7]??0)+1126891415|0,a=(a<<10|a>>>22)+n|0,i+=(n^(a|~r))+(t[14]??0)-1416354905|0,i=(i<<15|i>>>17)+a|0,r+=(a^(i|~n))+(t[5]??0)-57434055|0,r=(r<<21|r>>>11)+i|0,n+=(i^(r|~a))+(t[12]??0)+1700485571|0,n=(n<<6|n>>>26)+r|0,a+=(r^(n|~i))+(t[3]??0)-1894986606|0,a=(a<<10|a>>>22)+n|0,i+=(n^(a|~r))+(t[10]??0)-1051523|0,i=(i<<15|i>>>17)+a|0,r+=(a^(i|~n))+(t[1]??0)-2054922799|0,r=(r<<21|r>>>11)+i|0,n+=(i^(r|~a))+(t[8]??0)+1873313359|0,n=(n<<6|n>>>26)+r|0,a+=(r^(n|~i))+(t[15]??0)-30611744|0,a=(a<<10|a>>>22)+n|0,i+=(n^(a|~r))+(t[6]??0)-1560198380|0,i=(i<<15|i>>>17)+a|0,r+=(a^(i|~n))+(t[13]??0)+1309151649|0,r=(r<<21|r>>>11)+i|0,n+=(i^(r|~a))+(t[4]??0)-145523070|0,n=(n<<6|n>>>26)+r|0,a+=(r^(n|~i))+(t[11]??0)-1120210379|0,a=(a<<10|a>>>22)+n|0,i+=(n^(a|~r))+(t[2]??0)+718787259|0,i=(i<<15|i>>>17)+a|0,r+=(a^(i|~n))+(t[9]??0)-343485551|0,r=(r<<21|r>>>11)+i|0,e[0]=n+(e[0]??0)|0,e[1]=r+(e[1]??0)|0,e[2]=i+(e[2]??0)|0,e[3]=a+(e[3]??0)|0}_dataLength=0;_bufferLength=0;_state=new Int32Array(4);_buffer=new ArrayBuffer(68);_buffer8;_buffer32;constructor(){this._buffer8=new Uint8Array(this._buffer,0,68),this._buffer32=new Uint32Array(this._buffer,0,17),this.start()}start(){return this._dataLength=0,this._bufferLength=0,this._state.set(e.stateIdentity),this}appendStr(t){let n=this._buffer8,r=this._buffer32,i=this._bufferLength,a,o;for(o=0;o<t.length;o+=1){if(a=t.charCodeAt(o),a<128)n[i++]=a;else if(a<2048)n[i++]=(a>>>6)+192,n[i++]=a&63|128;else if(a<55296||a>56319)n[i++]=(a>>>12)+224,n[i++]=a>>>6&63|128,n[i++]=a&63|128;else{if(a=(a-55296)*1024+(t.charCodeAt(++o)-56320)+65536,a>1114111)throw Error(`Unicode standard supports code points up to U+10FFFF`);n[i++]=(a>>>18)+240,n[i++]=a>>>12&63|128,n[i++]=a>>>6&63|128,n[i++]=a&63|128}i>=64&&(this._dataLength+=64,e._md5cycle(this._state,r),i-=64,r[0]=r[16]??0)}return this._bufferLength=i,this}appendAsciiStr(t){let n=this._buffer8,r=this._buffer32,i=this._bufferLength,a,o=0;for(;;){for(a=Math.min(t.length-o,64-i);a--;)n[i++]=t.charCodeAt(o++);if(i<64)break;this._dataLength+=64,e._md5cycle(this._state,r),i=0}return this._bufferLength=i,this}appendByteArray(t){let n=this._buffer8,r=this._buffer32,i=this._bufferLength,a,o=0;for(;;){for(a=Math.min(t.length-o,64-i);a--;)n[i++]=t[o++]??0;if(i<64)break;this._dataLength+=64,e._md5cycle(this._state,r),i=0}return this._bufferLength=i,this}getState(){let e=this._state;return{buffer:String.fromCharCode.apply(null,Array.from(this._buffer8)),buflen:this._bufferLength,length:this._dataLength,state:[e[0]??0,e[1]??0,e[2]??0,e[3]??0]}}setState(e){let t=e.buffer,n=e.state,r=this._state,i;for(this._dataLength=e.length,this._bufferLength=e.buflen,r[0]=n[0]??0,r[1]=n[1]??0,r[2]=n[2]??0,r[3]=n[3]??0,i=0;i<t.length;i+=1)this._buffer8[i]=t.charCodeAt(i)}end(t=!1){let n=this._bufferLength,r=this._buffer8,i=this._buffer32,a=(n>>2)+1;this._dataLength+=n;let o=this._dataLength*8;if(r[n]=128,r[n+1]=r[n+2]=r[n+3]=0,i.set(e.buffer32Identity.subarray(a),a),n>55&&(e._md5cycle(this._state,i),i.set(e.buffer32Identity)),o<=4294967295)i[14]=o;else{let e=o.toString(16).match(/(.*?)(.{0,8})$/);if(e===null)return;let t=Number.parseInt(e[2]??``,16),n=Number.parseInt(e[1]??``,16)||0;i[14]=t,i[15]=n}return e._md5cycle(this._state,i),t?this._state:e._hex(this._state)}};if(n.hashStr(`hello`)!==`5d41402abc4b2a76b9719d911017c592`)throw Error(`Md5 self test failed.`);function r(e){let t=!1,n;return function(...r){if(t){if(n)return n;throw Error(`Function called more than once`)}return t=!0,n=e.apply(this,r),n}}const i={make:n=>{let r,i=!1;return t.gen(function*(){if(i){if(r!==void 0)return r;yield*new e({code:`UNKNOWN_ERROR`,status:500,body:`Effect called more than once with undefined result`}).toEffect()}return i=!0,r=yield*n,r})},legacy:r},a={leading:!1,trailing:!0};function o(e,t,n={}){let r={...a,...n},i;return function(...n){r.leading&&!i?(console.log(`leading`),e.apply(this,n),i=setTimeout(()=>{i=void 0},t)):(clearTimeout(i),i=setTimeout(()=>{r.trailing?(e.apply(this,n),r.leading&&setTimeout(()=>{i=void 0},t)):i=void 0},t))}}function s(e,t,{leading:n=!0,trailing:r=!0}={}){return o(e,t,{leading:n,trailing:r})}const c={legacy:s};export{n as a,r as i,s as n,i as r,c as t};
+//# sourceMappingURL=utils-BILytQlb.js.map