@uploadista/core 0.0.2 → 0.0.3

package/dist/upload-BzU7ifyH.js

@@ -0,0 +1,2 @@
+import{n as e}from"./uploadista-error-CjfcFnVa.js";import{T as t,n,u as r,v as i}from"./types-m26wrG-Z.js";import{r as a,t as o}from"./checksum-C5qE-5eg.js";import{t as s}from"./stream-limiter-CTuiXkcq.js";import{Context as c,Effect as l,Layer as u,Metric as d,MetricBoundaries as f,Ref as p,Stream as m}from"effect";function h(e,t,n=0){return e.length<n+t.length?!1:t.every((t,r)=>e[n+r]===t)}function g(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 _=(e,t)=>{if(e.length===0)return`application/octet-stream`;if(h(e,[137,80,78,71,13,10,26,10]))return`image/png`;if(h(e,[255,216,255]))return`image/jpeg`;if(g(e,`GIF87a`)||g(e,`GIF89a`))return`image/gif`;if(h(e,[82,73,70,70])&&e.length>=12&&g(e,`WEBP`,8))return`image/webp`;if(e.length>=12&&h(e,[0,0,0],0)&&g(e,`ftyp`,4)&&(g(e,`avif`,8)||g(e,`avis`,8)))return`image/avif`;if(e.length>=12&&g(e,`ftyp`,4)&&(g(e,`heic`,8)||g(e,`heif`,8)||g(e,`mif1`,8)))return`image/heic`;if(h(e,[66,77]))return`image/bmp`;if(h(e,[73,73,42,0])||h(e,[77,77,0,42]))return`image/tiff`;if(h(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&&g(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(h(e,[26,69,223,163]))return`video/webm`;if(h(e,[82,73,70,70])&&e.length>=12&&g(e,`AVI `,8))return`video/x-msvideo`;if(e.length>=8&&(g(e,`moov`,4)||g(e,`mdat`,4)||g(e,`free`,4)))return`video/quicktime`;if(h(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(h(e,[255,251])||h(e,[255,243])||h(e,[255,242])||g(e,`ID3`))return`audio/mpeg`;if(h(e,[82,73,70,70])&&e.length>=12&&g(e,`WAVE`,8))return`audio/wav`;if(g(e,`fLaC`))return`audio/flac`;if(g(e,`OggS`))return`audio/ogg`;if(e.length>=12&&g(e,`ftyp`,4)&&g(e,`M4A`,8))return`audio/mp4`;if(g(e,`%PDF`))return`application/pdf`;if(h(e,[80,75,3,4])||h(e,[80,75,5,6])||h(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(h(e,[82,97,114,33,26,7]))return`application/x-rar-compressed`;if(h(e,[55,122,188,175,39,28]))return`application/x-7z-compressed`;if(h(e,[31,139]))return`application/gzip`;if(e.length>=262&&g(e,`ustar`,257))return`application/x-tar`;if(g(e,`wOFF`))return`font/woff`;if(g(e,`wOF2`))return`font/woff2`;if(h(e,[0,1,0,0,0]))return`font/ttf`;if(g(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 v(e,t){return e===t?!0:e.split(`/`)[0]===t.split(`/`)[0]}const y=(e,t,{dataStoreService:r,kvStore:i,eventEmitter:a,generateId:o})=>l.gen(function*(){let s=yield*r.getDataStore(e.storageId,t),c=yield*o.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:s.bucket},flow:m},v=yield*s.create(_);return yield*i.set(c,v),yield*a.emit(c,{type:n.UPLOAD_STARTED,data:v,flow:v.flow}),v}).pipe(l.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`}}),l.tap(e=>l.gen(function*(){if(yield*d.increment(d.counter(`upload_created_total`,{description:`Total number of uploads created`})),e.size){let t=d.histogram(`upload_file_size_bytes`,f.exponential({start:1024,factor:2,count:25}));yield*d.update(t,e.size)}let t=d.gauge(`active_uploads`);yield*d.increment(t)})),l.tap(t=>l.logInfo(`Upload created`).pipe(l.annotateLogs({"upload.id":t.id,"upload.file_name":e.fileName??`unknown`,"upload.file_size":e.size?.toString()??`0`,"upload.storage_id":e.storageId}))),l.tapError(t=>l.gen(function*(){yield*l.logError(`Upload creation failed`).pipe(l.annotateLogs({"upload.file_name":e.fileName??`unknown`,"upload.storage_id":e.storageId,error:String(t)})),yield*d.increment(d.counter(`upload_failed_total`,{description:`Total number of uploads that failed`}))})));function b(t){return m.fromReadableStream(()=>t,t=>new e({code:`UNKNOWN_ERROR`,status:500,body:String(t)}))}function x({data:t,upload:r,dataStore:i,maxFileSize:a,controller:o,eventEmitter:c,uploadProgressInterval:u=200}){return l.gen(function*(){let d=b(t);if(o.signal.aborted)return yield*l.fail(e.fromCode(`ABORTED`));let f=new AbortController,{signal:m}=f,h=()=>{f.abort()};return o.signal.addEventListener(`abort`,h,{once:!0}),yield*l.acquireUseRelease(l.sync(()=>({signal:m,onAbort:h})),({signal:t})=>l.gen(function*(){let e=yield*p.make(0),t=s.limit({maxSize:a})(d);return yield*i.write({stream:t,file_id:r.id,offset:r.offset},{onProgress:t=>{let i=Date.now();p.get(e).pipe(l.flatMap(a=>i-a>=u?l.gen(function*(){yield*p.set(e,i),yield*c.emit(r.id,{type:n.UPLOAD_PROGRESS,data:{id:r.id,progress:t,total:r.size??0},flow:r.flow})}):l.void),l.runPromise).catch(()=>{})}})}).pipe(l.catchAll(t=>t instanceof Error&&t.name===`AbortError`?l.fail(e.fromCode(`ABORTED`)):t instanceof e?l.fail(t):l.fail(e.fromCode(`FILE_WRITE_ERROR`,{cause:t})))),({onAbort:e})=>l.sync(()=>{o.signal.removeEventListener(`abort`,e)}))}).pipe(l.withSpan(`upload-write-to-store`,{attributes:{"upload.id":r.id,"upload.offset":r.offset.toString(),"upload.max_file_size":a.toString(),"upload.file_size":r.size?.toString()??`0`}}),l.tap(e=>l.logDebug(`Data written to store`).pipe(l.annotateLogs({"upload.id":r.id,"write.offset":e.toString(),"write.bytes_written":(e-r.offset).toString()}))),l.tapError(t=>l.logError(`Failed to write to store`).pipe(l.annotateLogs({"upload.id":r.id,"upload.offset":r.offset.toString(),error:t instanceof e?t.code:String(t)}))))}const S=(e,t,r,{dataStoreService:i,kvStore:a,eventEmitter:o})=>l.gen(function*(){let s=yield*a.get(e),c=yield*i.getDataStore(s.storage.id,t);return s.offset=yield*x({dataStore:c,data:r,upload:s,maxFileSize:1e8,controller:new AbortController,uploadProgressInterval:200,eventEmitter:o}),yield*a.set(e,s),yield*o.emit(s.id,{type:n.UPLOAD_PROGRESS,data:{id:s.id,progress:s.offset,total:s.size??0},flow:s.flow}),s.size&&s.offset===s.size&&(yield*C({file:s,dataStore:c,eventEmitter:o})),s}).pipe(l.withSpan(`upload-chunk`,{attributes:{"upload.id":e,"chunk.upload_id":e}}),l.tap(e=>l.gen(function*(){yield*d.increment(d.counter(`chunk_uploaded_total`,{description:`Total number of chunks uploaded`}));let t=e.offset,n=d.histogram(`chunk_size_bytes`,f.linear({start:262144,width:262144,count:20}));if(yield*d.update(n,t),e.size&&e.size>0){let e=t,n=d.gauge(`upload_throughput_bytes_per_second`);yield*d.set(n,e)}})),l.tap(e=>l.logDebug(`Chunk uploaded`).pipe(l.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`}))),l.tapError(t=>l.logError(`Chunk upload failed`).pipe(l.annotateLogs({"upload.id":e,error:String(t)})))),C=({file:t,dataStore:r,eventEmitter:i})=>l.gen(function*(){let a=r.getCapabilities();if(a.maxValidationSize&&t.size&&t.size>a.maxValidationSize){yield*i.emit(t.id,{type:n.UPLOAD_VALIDATION_WARNING,data:{id:t.id,message:`File size (${t.size} bytes) exceeds max validation size (${a.maxValidationSize} bytes). Validation skipped.`},flow:t.flow});return}let s=yield*r.read(t.id);if(t.checksum&&t.checksumAlgorithm){let a=yield*o(s,t.checksumAlgorithm);if(a!==t.checksum)return yield*i.emit(t.id,{type:n.UPLOAD_VALIDATION_FAILED,data:{id:t.id,reason:`checksum_mismatch`,expected:t.checksum,actual:a},flow:t.flow}),yield*r.remove(t.id),yield*e.fromCode(`CHECKSUM_MISMATCH`,{body:`Checksum validation failed. Expected: ${t.checksum}, Got: ${a}`,details:{uploadId:t.id,expected:t.checksum,actual:a,algorithm:t.checksumAlgorithm}}).toEffect();yield*i.emit(t.id,{type:n.UPLOAD_VALIDATION_SUCCESS,data:{id:t.id,validationType:`checksum`,algorithm:t.checksumAlgorithm},flow:t.flow})}if(a.requiresMimeTypeValidation){let a=_(s),o=t.metadata?.type;if(o&&!v(o,a))return yield*i.emit(t.id,{type:n.UPLOAD_VALIDATION_FAILED,data:{id:t.id,reason:`mimetype_mismatch`,expected:o,actual:a},flow:t.flow}),yield*r.remove(t.id),yield*e.fromCode(`MIMETYPE_MISMATCH`,{body:`MIME type validation failed. Expected: ${o}, Detected: ${a}`,details:{uploadId:t.id,expected:o,actual:a}}).toEffect();yield*i.emit(t.id,{type:n.UPLOAD_VALIDATION_SUCCESS,data:{id:t.id,validationType:`mimetype`},flow:t.flow})}}).pipe(l.withSpan(`validate-upload`,{attributes:{"upload.id":t.id,"validation.checksum_provided":t.checksum?`true`:`false`,"validation.mime_required":r.getCapabilities().requiresMimeTypeValidation?`true`:`false`}})),w=t=>l.tryPromise({try:async()=>await fetch(t),catch:t=>e.fromCode(`UNKNOWN_ERROR`,{cause:t})}).pipe(l.withSpan(`upload-fetch-url`,{attributes:{"upload.url":t,"upload.operation":`fetch`}}),l.tap(e=>l.gen(function*(){yield*d.increment(d.counter(`upload_from_url_total`,{description:`Total number of URL-based uploads`})),e.ok&&(yield*d.increment(d.counter(`upload_from_url_success_total`,{description:`Total number of successful URL-based uploads`})))})),l.tap(e=>l.logInfo(`URL fetch completed`).pipe(l.annotateLogs({"upload.url":t,"response.status":e.status.toString(),"response.ok":e.ok.toString(),"response.content_length":e.headers.get(`content-length`)??`unknown`}))),l.tapError(e=>l.gen(function*(){yield*d.increment(d.counter(`upload_from_url_failed_total`,{description:`Total number of failed URL-based uploads`})),yield*l.logError(`URL fetch failed`).pipe(l.annotateLogs({"upload.url":t,error:String(e)}))}))),T=t=>l.tryPromise({try:async()=>await t.arrayBuffer(),catch:t=>e.fromCode(`UNKNOWN_ERROR`,{cause:t})}).pipe(l.withSpan(`upload-convert-to-buffer`,{attributes:{"upload.operation":`arrayBuffer`}}),l.tap(e=>l.logDebug(`Response converted to array buffer`).pipe(l.annotateLogs({"buffer.size":e.byteLength.toString()}))),l.tapError(e=>l.logError(`Failed to convert response to array buffer`).pipe(l.annotateLogs({error:String(e)}))));var E=class extends c.Tag(`UploadServer`)(){};function D(){return l.gen(function*(){let e=yield*r,n=yield*i,o=yield*a,s=yield*t;return{upload:(t,r,i)=>l.gen(function*(){return yield*S((yield*y(t,r,{dataStoreService:s,kvStore:e,eventEmitter:n,generateId:o})).id,r,i,{dataStoreService:s,kvStore:e,eventEmitter:n})}),uploadFromUrl:(t,r,i)=>l.gen(function*(){let a=yield*T(yield*w(i)),c=new ReadableStream({start(e){e.enqueue(new Uint8Array(a)),e.close()}});return yield*S((yield*y({...t,size:a.byteLength},r,{dataStoreService:s,kvStore:e,eventEmitter:n,generateId:o})).id,r,c,{dataStoreService:s,kvStore:e,eventEmitter:n})}),createUpload:(t,r)=>l.gen(function*(){return yield*y(t,r,{dataStoreService:s,kvStore:e,eventEmitter:n,generateId:o})}),uploadChunk:(t,r,i)=>l.gen(function*(){return yield*S(t,r,i,{dataStoreService:s,kvStore:e,eventEmitter:n})}),getUpload:t=>l.gen(function*(){return yield*e.get(t)}),read:(t,n)=>l.gen(function*(){let r=yield*e.get(t);return yield*(yield*s.getDataStore(r.storage.id,n)).read(t)}),delete:(t,n)=>l.gen(function*(){let r=yield*e.get(t);yield*(yield*s.getDataStore(r.storage.id,n)).remove(t),yield*e.delete(t)}),getCapabilities:(e,t)=>l.gen(function*(){return(yield*s.getDataStore(e,t)).getCapabilities()}),subscribeToUploadEvents:(e,t)=>l.gen(function*(){yield*n.subscribe(e,t)}),unsubscribeFromUploadEvents:e=>l.gen(function*(){yield*n.unsubscribe(e)})}})}const O=u.effect(E,D());var k=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}}};export{T as a,_ as c,O as i,E as n,w as o,D as r,v as s,k as t};
+//# sourceMappingURL=upload-BzU7ifyH.js.map

package/dist/upload-BzU7ifyH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-BzU7ifyH.js","names":["parsedMetadata: Record<string, string>","metadataObject: Record<string, string>","file: UploadFile","onAbort","capabilities: DataStoreCapabilities","validateUploadStrategy: (strategy: UploadStrategy) => boolean","reasoning: string[]","warnings: string[]","strategy: UploadStrategy","errors: string[]"],"sources":["../src/upload/mime.ts","../src/upload/create-upload.ts","../src/upload/convert-to-stream.ts","../src/upload/write-to-store.ts","../src/upload/upload-chunk.ts","../src/upload/upload-url.ts","../src/upload/upload-server.ts","../src/upload/upload-strategy-negotiator.ts"],"sourcesContent":["/**\n * Helper to check if buffer matches a byte pattern at given offset\n */\nfunction checkBytes(\n  buffer: Uint8Array,\n  pattern: number[],\n  offset = 0,\n): boolean {\n  if (buffer.length < offset + pattern.length) return false;\n  return pattern.every((byte, i) => buffer[offset + i] === byte);\n}\n\n/**\n * Helper to check if buffer matches a string pattern at given offset\n */\nfunction checkString(\n  buffer: Uint8Array,\n  str: string,\n  offset = 0,\n): boolean {\n  if (buffer.length < offset + str.length) return false;\n  for (let i = 0; i < str.length; i++) {\n    if (buffer[offset + i] !== str.charCodeAt(i)) return false;\n  }\n  return true;\n}\n\n/**\n * Detect MIME type from buffer using magic bytes (file signatures).\n * Supports a wide range of common file types including images, videos, audio, documents, and archives.\n *\n * @param buffer - File content as Uint8Array\n * @param filename - Optional filename for extension-based fallback\n * @returns Detected MIME type or \"application/octet-stream\" if unknown\n */\nexport const detectMimeType = (\n  buffer: Uint8Array,\n  filename?: string,\n): string => {\n  if (buffer.length === 0) {\n    return \"application/octet-stream\";\n  }\n\n  // ===== IMAGES =====\n\n  // PNG: 89 50 4E 47 0D 0A 1A 0A\n  if (checkBytes(buffer, [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])) {\n    return \"image/png\";\n  }\n\n  // JPEG: FF D8 FF\n  if (checkBytes(buffer, [0xff, 0xd8, 0xff])) {\n    return \"image/jpeg\";\n  }\n\n  // GIF87a or GIF89a\n  if (checkString(buffer, \"GIF87a\") || checkString(buffer, \"GIF89a\")) {\n    return \"image/gif\";\n  }\n\n  // WebP: RIFF....WEBP\n  if (\n    checkBytes(buffer, [0x52, 0x49, 0x46, 0x46]) &&\n    buffer.length >= 12 &&\n    checkString(buffer, \"WEBP\", 8)\n  ) {\n    return \"image/webp\";\n  }\n\n  // AVIF: ....ftypavif or ....ftypavis\n  if (\n    buffer.length >= 12 &&\n    checkBytes(buffer, [0x00, 0x00, 0x00], 0) &&\n    checkString(buffer, \"ftyp\", 4) &&\n    (checkString(buffer, \"avif\", 8) || checkString(buffer, \"avis\", 8))\n  ) {\n    return \"image/avif\";\n  }\n\n  // HEIC/HEIF: ....ftypheic or ....ftypheif or ....ftypmif1\n  if (\n    buffer.length >= 12 &&\n    checkString(buffer, \"ftyp\", 4) &&\n    (checkString(buffer, \"heic\", 8) ||\n      checkString(buffer, \"heif\", 8) ||\n      checkString(buffer, \"mif1\", 8))\n  ) {\n    return \"image/heic\";\n  }\n\n  // BMP: 42 4D\n  if (checkBytes(buffer, [0x42, 0x4d])) {\n    return \"image/bmp\";\n  }\n\n  // TIFF (little-endian): 49 49 2A 00\n  if (checkBytes(buffer, [0x49, 0x49, 0x2a, 0x00])) {\n    return \"image/tiff\";\n  }\n\n  // TIFF (big-endian): 4D 4D 00 2A\n  if (checkBytes(buffer, [0x4d, 0x4d, 0x00, 0x2a])) {\n    return \"image/tiff\";\n  }\n\n  // ICO: 00 00 01 00\n  if (checkBytes(buffer, [0x00, 0x00, 0x01, 0x00])) {\n    return \"image/x-icon\";\n  }\n\n  // SVG (XML-based, check for <svg or <?xml)\n  if (buffer.length >= 5) {\n    const text = new TextDecoder(\"utf-8\", { fatal: false }).decode(\n      buffer.slice(0, Math.min(1024, buffer.length)),\n    );\n    if (text.includes(\"<svg\") || (text.includes(\"<?xml\") && text.includes(\"<svg\"))) {\n      return \"image/svg+xml\";\n    }\n  }\n\n  // ===== VIDEOS =====\n\n  // MP4/M4V/M4A: ....ftyp\n  if (buffer.length >= 12 && checkString(buffer, \"ftyp\", 4)) {\n    const subtype = new TextDecoder().decode(buffer.slice(8, 12));\n    if (\n      subtype.startsWith(\"mp4\") ||\n      subtype.startsWith(\"M4\") ||\n      subtype.startsWith(\"isom\")\n    ) {\n      return \"video/mp4\";\n    }\n  }\n\n  // WebM: 1A 45 DF A3\n  if (checkBytes(buffer, [0x1a, 0x45, 0xdf, 0xa3])) {\n    return \"video/webm\";\n  }\n\n  // AVI: RIFF....AVI\n  if (\n    checkBytes(buffer, [0x52, 0x49, 0x46, 0x46]) &&\n    buffer.length >= 12 &&\n    checkString(buffer, \"AVI \", 8)\n  ) {\n    return \"video/x-msvideo\";\n  }\n\n  // MOV (QuickTime): ....moov or ....mdat or ....free\n  if (\n    buffer.length >= 8 &&\n    (checkString(buffer, \"moov\", 4) ||\n      checkString(buffer, \"mdat\", 4) ||\n      checkString(buffer, \"free\", 4))\n  ) {\n    return \"video/quicktime\";\n  }\n\n  // MKV: 1A 45 DF A3 (same as WebM but check for Matroska)\n  if (\n    checkBytes(buffer, [0x1a, 0x45, 0xdf, 0xa3]) &&\n    buffer.length >= 100\n  ) {\n    const text = new TextDecoder(\"utf-8\", { fatal: false }).decode(\n      buffer.slice(0, 100),\n    );\n    if (text.includes(\"matroska\")) {\n      return \"video/x-matroska\";\n    }\n  }\n\n  // ===== AUDIO =====\n\n  // MP3: FF FB or FF F3 or FF F2 or ID3\n  if (\n    checkBytes(buffer, [0xff, 0xfb]) ||\n    checkBytes(buffer, [0xff, 0xf3]) ||\n    checkBytes(buffer, [0xff, 0xf2]) ||\n    checkString(buffer, \"ID3\")\n  ) {\n    return \"audio/mpeg\";\n  }\n\n  // WAV: RIFF....WAVE\n  if (\n    checkBytes(buffer, [0x52, 0x49, 0x46, 0x46]) &&\n    buffer.length >= 12 &&\n    checkString(buffer, \"WAVE\", 8)\n  ) {\n    return \"audio/wav\";\n  }\n\n  // FLAC: 66 4C 61 43 (fLaC)\n  if (checkString(buffer, \"fLaC\")) {\n    return \"audio/flac\";\n  }\n\n  // OGG: 4F 67 67 53 (OggS)\n  if (checkString(buffer, \"OggS\")) {\n    return \"audio/ogg\";\n  }\n\n  // M4A: ....ftypM4A\n  if (\n    buffer.length >= 12 &&\n    checkString(buffer, \"ftyp\", 4) &&\n    checkString(buffer, \"M4A\", 8)\n  ) {\n    return \"audio/mp4\";\n  }\n\n  // ===== DOCUMENTS =====\n\n  // PDF: 25 50 44 46 (%PDF)\n  if (checkString(buffer, \"%PDF\")) {\n    return \"application/pdf\";\n  }\n\n  // ===== ARCHIVES =====\n\n  // ZIP: 50 4B 03 04 or 50 4B 05 06 (empty archive) or 50 4B 07 08 (spanned archive)\n  if (\n    checkBytes(buffer, [0x50, 0x4b, 0x03, 0x04]) ||\n    checkBytes(buffer, [0x50, 0x4b, 0x05, 0x06]) ||\n    checkBytes(buffer, [0x50, 0x4b, 0x07, 0x08])\n  ) {\n    // Could be ZIP, DOCX, XLSX, PPTX, JAR, APK, etc.\n    // Check for Office formats\n    if (buffer.length >= 1024) {\n      const text = new TextDecoder(\"utf-8\", { fatal: false }).decode(buffer);\n      if (text.includes(\"word/\")) return \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\";\n      if (text.includes(\"xl/\")) return \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\";\n      if (text.includes(\"ppt/\")) return \"application/vnd.openxmlformats-officedocument.presentationml.presentation\";\n    }\n    return \"application/zip\";\n  }\n\n  // RAR: 52 61 72 21 1A 07 (Rar!)\n  if (checkBytes(buffer, [0x52, 0x61, 0x72, 0x21, 0x1a, 0x07])) {\n    return \"application/x-rar-compressed\";\n  }\n\n  // 7Z: 37 7A BC AF 27 1C\n  if (checkBytes(buffer, [0x37, 0x7a, 0xbc, 0xaf, 0x27, 0x1c])) {\n    return \"application/x-7z-compressed\";\n  }\n\n  // GZIP: 1F 8B\n  if (checkBytes(buffer, [0x1f, 0x8b])) {\n    return \"application/gzip\";\n  }\n\n  // TAR (ustar): \"ustar\" at offset 257\n  if (buffer.length >= 262 && checkString(buffer, \"ustar\", 257)) {\n    return \"application/x-tar\";\n  }\n\n  // ===== FONTS =====\n\n  // WOFF: 77 4F 46 46 (wOFF)\n  if (checkString(buffer, \"wOFF\")) {\n    return \"font/woff\";\n  }\n\n  // WOFF2: 77 4F 46 32 (wOF2)\n  if (checkString(buffer, \"wOF2\")) {\n    return \"font/woff2\";\n  }\n\n  // TTF: 00 01 00 00 00\n  if (checkBytes(buffer, [0x00, 0x01, 0x00, 0x00, 0x00])) {\n    return \"font/ttf\";\n  }\n\n  // OTF: 4F 54 54 4F (OTTO)\n  if (checkString(buffer, \"OTTO\")) {\n    return \"font/otf\";\n  }\n\n  // ===== TEXT =====\n\n  // JSON (basic check for { or [)\n  if (buffer.length >= 1) {\n    const firstByte = buffer[0];\n    if (firstByte === 0x7b || firstByte === 0x5b) {\n      // { or [\n      try {\n        const text = new TextDecoder(\"utf-8\").decode(\n          buffer.slice(0, Math.min(1024, buffer.length)),\n        );\n        JSON.parse(text.trim());\n        return \"application/json\";\n      } catch {\n        // Not valid JSON\n      }\n    }\n  }\n\n  // Fallback to extension-based detection\n  if (filename) {\n    const ext = filename.split(\".\").pop()?.toLowerCase();\n    switch (ext) {\n      // Images\n      case \"jpg\":\n      case \"jpeg\":\n        return \"image/jpeg\";\n      case \"png\":\n        return \"image/png\";\n      case \"gif\":\n        return \"image/gif\";\n      case \"webp\":\n        return \"image/webp\";\n      case \"avif\":\n        return \"image/avif\";\n      case \"heic\":\n      case \"heif\":\n        return \"image/heic\";\n      case \"bmp\":\n        return \"image/bmp\";\n      case \"tiff\":\n      case \"tif\":\n        return \"image/tiff\";\n      case \"ico\":\n        return \"image/x-icon\";\n      case \"svg\":\n        return \"image/svg+xml\";\n\n      // Videos\n      case \"mp4\":\n      case \"m4v\":\n        return \"video/mp4\";\n      case \"webm\":\n        return \"video/webm\";\n      case \"avi\":\n        return \"video/x-msvideo\";\n      case \"mov\":\n        return \"video/quicktime\";\n      case \"mkv\":\n        return \"video/x-matroska\";\n\n      // Audio\n      case \"mp3\":\n        return \"audio/mpeg\";\n      case \"wav\":\n        return \"audio/wav\";\n      case \"flac\":\n        return \"audio/flac\";\n      case \"ogg\":\n        return \"audio/ogg\";\n      case \"m4a\":\n        return \"audio/mp4\";\n\n      // Documents\n      case \"pdf\":\n        return \"application/pdf\";\n      case \"docx\":\n        return \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\";\n      case \"xlsx\":\n        return \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\";\n      case \"pptx\":\n        return \"application/vnd.openxmlformats-officedocument.presentationml.presentation\";\n\n      // Archives\n      case \"zip\":\n        return \"application/zip\";\n      case \"rar\":\n        return \"application/x-rar-compressed\";\n      case \"7z\":\n        return \"application/x-7z-compressed\";\n      case \"gz\":\n      case \"gzip\":\n        return \"application/gzip\";\n      case \"tar\":\n        return \"application/x-tar\";\n\n      // Fonts\n      case \"woff\":\n        return \"font/woff\";\n      case \"woff2\":\n        return \"font/woff2\";\n      case \"ttf\":\n        return \"font/ttf\";\n      case \"otf\":\n        return \"font/otf\";\n\n      // Text\n      case \"txt\":\n        return \"text/plain\";\n      case \"json\":\n        return \"application/json\";\n      case \"xml\":\n        return \"application/xml\";\n      case \"html\":\n      case \"htm\":\n        return \"text/html\";\n      case \"css\":\n        return \"text/css\";\n      case \"js\":\n        return \"application/javascript\";\n      case \"csv\":\n        return \"text/csv\";\n\n      default:\n        return \"application/octet-stream\";\n    }\n  }\n\n  return \"application/octet-stream\";\n};\n\n/**\n * Compare two MIME types with lenient matching.\n * Matches on major type (e.g., \"image/*\") to allow for minor variations.\n *\n * @param declared - MIME type provided by client\n * @param detected - MIME type detected from file content\n * @returns true if MIME types are compatible\n *\n * @example\n * compareMimeTypes(\"image/png\", \"image/apng\") // true\n * compareMimeTypes(\"image/jpeg\", \"image/png\") // true (both images)\n * compareMimeTypes(\"image/png\", \"application/pdf\") // false\n */\nexport function compareMimeTypes(declared: string, detected: string): boolean {\n  // Exact match\n  if (declared === detected) {\n    return true;\n  }\n\n  // Extract major types (e.g., \"image\" from \"image/png\")\n  const declaredMajor = declared.split(\"/\")[0];\n  const detectedMajor = detected.split(\"/\")[0];\n\n  // Compare major types for lenient matching\n  return declaredMajor === detectedMajor;\n}\n","import { Effect, Metric, MetricBoundaries } from \"effect\";\nimport {\n  type EventEmitter,\n  type InputFile,\n  type KvStore,\n  type UploadEvent,\n  UploadEventType,\n  type UploadFile,\n  type UploadFileDataStoresShape,\n} from \"../types\";\nimport type { GenerateIdShape } from \"../utils/generate-id\";\n\n/**\n * Creates a new upload and initializes it in the storage system.\n *\n * This function handles the initial upload creation process including:\n * - Generating a unique upload ID\n * - Routing to appropriate data store based on storage ID\n * - Creating the upload record in the data store\n * - Storing upload metadata in KV store\n * - Emitting upload started events\n * - Parsing and validating metadata\n *\n * The function includes comprehensive observability with:\n * - Effect tracing spans for performance monitoring\n * - Metrics tracking for upload creation, file sizes, and success rates\n * - Structured logging for debugging and monitoring\n * - Error handling with proper UploadistaError types\n *\n * @param inputFile - Input file configuration including storage, size, type, etc.\n * @param clientId - Client identifier (null for anonymous uploads)\n * @param dataStoreService - Service for routing to appropriate data stores\n * @param kvStore - KV store for upload metadata persistence\n * @param eventEmitter - Event emitter for upload lifecycle events\n * @param generateId - ID generator for creating unique upload identifiers\n * @returns Effect that yields the created UploadFile\n *\n * @example\n * ```typescript\n * // Create a new upload\n * const inputFile: InputFile = {\n *   storageId: \"s3-production\",\n *   size: 1024000,\n *   type: \"image/jpeg\",\n *   fileName: \"photo.jpg\",\n *   metadata: JSON.stringify({ category: \"photos\" })\n * };\n *\n * const createEffect = createUpload(\n *   inputFile,\n *   \"client-123\",\n *   {\n *     dataStoreService,\n *     kvStore,\n *     eventEmitter,\n *     generateId\n *   }\n * );\n *\n * // Run with dependencies\n * const upload = await Effect.runPromise(\n *   createEffect.pipe(\n *     Effect.provide(dataStoreLayer),\n *     Effect.provide(kvStoreLayer),\n *     Effect.provide(eventEmitterLayer),\n *     Effect.provide(generateIdLayer)\n *   )\n * );\n * ```\n */\nexport const createUpload = (\n  inputFile: InputFile,\n  clientId: string | null,\n  {\n    dataStoreService,\n    kvStore,\n    eventEmitter,\n    generateId,\n  }: {\n    dataStoreService: UploadFileDataStoresShape;\n    kvStore: KvStore<UploadFile>;\n    eventEmitter: EventEmitter<UploadEvent>;\n    generateId: GenerateIdShape;\n  }\n) =>\n  Effect.gen(function* () {\n    // Get datastore using Effect\n    const dataStore = yield* dataStoreService.getDataStore(\n      inputFile.storageId,\n      clientId\n    );\n\n    const id = yield* generateId.generateId();\n    const { size, type, fileName, lastModified, metadata, flow } = inputFile;\n\n    let parsedMetadata: Record<string, string> = {};\n    if (metadata) {\n      try {\n        parsedMetadata = JSON.parse(metadata) as Record<string, string>;\n      } catch {\n        parsedMetadata = {};\n      }\n    }\n\n    const metadataObject: Record<string, string> = {\n      ...parsedMetadata,\n      type,\n      fileName: fileName ?? \"\",\n    };\n    if (lastModified) {\n      metadataObject.lastModified = lastModified.toString();\n    }\n\n    const file: UploadFile = {\n      id,\n      size,\n      metadata: metadataObject,\n      offset: 0,\n      creationDate: new Date().toISOString(),\n      storage: {\n        id: inputFile.storageId,\n\n        type,\n        path: \"\",\n        bucket: dataStore.bucket,\n      },\n      flow,\n    };\n\n    // Create file using Effect\n    const fileCreated = yield* dataStore.create(file);\n\n    // Store in KV store\n    yield* kvStore.set(id, fileCreated);\n\n    // Emit event\n    yield* eventEmitter.emit(id, {\n      type: UploadEventType.UPLOAD_STARTED,\n      data: fileCreated,\n      flow: fileCreated.flow,\n    });\n\n    return fileCreated;\n  }).pipe(\n    // Add tracing span for the entire create operation\n    Effect.withSpan(\"upload-create\", {\n      attributes: {\n        \"upload.file_name\": inputFile.fileName ?? \"unknown\",\n        \"upload.file_size\": inputFile.size?.toString() ?? \"0\",\n        \"upload.storage_id\": inputFile.storageId,\n        \"upload.mime_type\": inputFile.type,\n        \"upload.has_flow\": inputFile.flow ? \"true\" : \"false\",\n      },\n    }),\n    // Track upload creation metrics\n    Effect.tap((file) =>\n      Effect.gen(function* () {\n        // Increment upload created counter\n        yield* Metric.increment(\n          Metric.counter(\"upload_created_total\", {\n            description: \"Total number of uploads created\",\n          })\n        );\n\n        // Record file size\n        if (file.size) {\n          const fileSizeHistogram = Metric.histogram(\n            \"upload_file_size_bytes\",\n            MetricBoundaries.exponential({\n              start: 1024,\n              factor: 2,\n              count: 25,\n            })\n          );\n          yield* Metric.update(fileSizeHistogram, file.size);\n        }\n\n        // Track active uploads gauge\n        const activeUploadsGauge = Metric.gauge(\"active_uploads\");\n        yield* Metric.increment(activeUploadsGauge);\n      })\n    ),\n    // Add structured logging\n    Effect.tap((file) =>\n      Effect.logInfo(\"Upload created\").pipe(\n        Effect.annotateLogs({\n          \"upload.id\": file.id,\n          \"upload.file_name\": inputFile.fileName ?? \"unknown\",\n          \"upload.file_size\": inputFile.size?.toString() ?? \"0\",\n          \"upload.storage_id\": inputFile.storageId,\n        })\n      )\n    ),\n    // Handle errors with logging and metrics\n    Effect.tapError((error) =>\n      Effect.gen(function* () {\n        // Log error\n        yield* Effect.logError(\"Upload creation failed\").pipe(\n          Effect.annotateLogs({\n            \"upload.file_name\": inputFile.fileName ?? \"unknown\",\n            \"upload.storage_id\": inputFile.storageId,\n            error: String(error),\n          })\n        );\n\n        // Track failed upload metric\n        yield* Metric.increment(\n          Metric.counter(\"upload_failed_total\", {\n            description: \"Total number of uploads that failed\",\n          })\n        );\n      })\n    )\n  );\n","import { Stream } from \"effect\";\nimport { UploadistaError } from \"../errors\";\n\n/**\n * Converts a ReadableStream to an Effect Stream.\n *\n * This utility function wraps a ReadableStream in an Effect Stream, providing\n * proper error handling and integration with the Effect ecosystem. It's used\n * throughout the upload system to convert raw streams into Effect-compatible\n * streams for processing.\n *\n * The function handles:\n * - Stream conversion with proper error mapping\n * - UploadistaError creation for stream errors\n * - Integration with Effect Stream processing\n *\n * @param data - The ReadableStream to convert\n * @returns Effect Stream that can be processed with Effect operations\n *\n * @example\n * ```typescript\n * // Convert a file stream to Effect Stream\n * const fileStream = new ReadableStream(...);\n * const effectStream = convertToStream(fileStream);\n *\n * // Process with Effect operations\n * const processedStream = effectStream.pipe(\n *   Stream.map((chunk) => processChunk(chunk)),\n *   Stream.filter((chunk) => chunk.length > 0)\n * );\n *\n * // Run the stream\n * await Stream.runForEach(processedStream, (chunk) =>\n *   Effect.logInfo(`Processed chunk: ${chunk.length} bytes`)\n * );\n * ```\n */\nexport function convertToStream<T>(data: ReadableStream<T>) {\n  return Stream.fromReadableStream(\n    () => data,\n    (error) =>\n      new UploadistaError({\n        code: \"UNKNOWN_ERROR\",\n        status: 500,\n        body: String(error),\n      })\n  );\n}\n","import { Effect, Ref } from \"effect\";\nimport { UploadistaError } from \"../errors\";\nimport { StreamLimiterEffect } from \"../streams/stream-limiter\";\nimport type { DataStore, UploadEvent, UploadFile } from \"../types\";\nimport { type EventEmitter, UploadEventType } from \"../types\";\nimport { convertToStream } from \"./convert-to-stream\";\n\n/**\n * Configuration options for writing data to a data store.\n *\n * @property data - The stream of data to write\n * @property upload - Upload file metadata\n * @property dataStore - Target data store for writing\n * @property maxFileSize - Maximum allowed file size in bytes\n * @property controller - AbortController for cancellation\n * @property eventEmitter - Event emitter for progress tracking\n * @property uploadProgressInterval - Progress emission interval in milliseconds (default: 200)\n */\ntype WriteToStoreOptions = {\n  data: ReadableStream<Uint8Array>;\n  upload: UploadFile;\n  dataStore: DataStore<UploadFile>;\n  maxFileSize: number;\n  controller: AbortController;\n  eventEmitter: EventEmitter<UploadEvent>;\n  uploadProgressInterval?: number;\n};\n\n/**\n * Writes data stream to a data store with progress tracking and size limits.\n *\n * This function handles the core data writing logic including:\n * - Stream conversion and processing\n * - File size validation and limiting\n * - Progress tracking with throttled events\n * - Abort signal handling for cancellation\n * - Error handling and cleanup\n *\n * The function includes comprehensive observability with:\n * - Effect tracing spans for performance monitoring\n * - Structured logging for debugging and monitoring\n * - Progress event emission with throttling\n * - Error handling with proper UploadistaError types\n *\n * @param data - The stream of data to write to storage\n * @param upload - Upload file metadata containing ID, offset, etc.\n * @param dataStore - Target data store for writing the data\n * @param maxFileSize - Maximum allowed file size in bytes\n * @param controller - AbortController for handling cancellation\n * @param eventEmitter - Event emitter for progress tracking\n * @param uploadProgressInterval - Progress emission interval in milliseconds (default: 200)\n * @returns Effect that yields the number of bytes written\n *\n * @example\n * ```typescript\n * // Write data to store with progress tracking\n * const writeEffect = writeToStore({\n *   data: fileStream,\n *   upload: uploadMetadata,\n *   dataStore: s3DataStore,\n *   maxFileSize: 100_000_000, // 100MB\n *   controller: abortController,\n *   eventEmitter: progressEmitter,\n *   uploadProgressInterval: 500 // Emit progress every 500ms\n * });\n *\n * // Run with error handling\n * const bytesWritten = await Effect.runPromise(\n *   writeEffect.pipe(\n *     Effect.catchAll((error) =>\n *       Effect.logError(\"Failed to write to store\").pipe(\n *         Effect.andThen(Effect.fail(error))\n *       )\n *     )\n *   )\n * );\n * ```\n */\nexport function writeToStore({\n  data,\n  upload,\n  dataStore,\n  maxFileSize,\n  controller,\n  eventEmitter,\n  uploadProgressInterval = 200,\n}: WriteToStoreOptions) {\n  return Effect.gen(function* () {\n    const stream = convertToStream(data);\n    // Check if already aborted\n    if (controller.signal.aborted) {\n      return yield* Effect.fail(UploadistaError.fromCode(\"ABORTED\"));\n    }\n\n    // Create an AbortController to manage the stream pipeline\n    const abortController = new AbortController();\n    const { signal } = abortController;\n\n    // Set up abort handling\n    const onAbort = () => {\n      // stream.cancel();\n      abortController.abort();\n    };\n\n    controller.signal.addEventListener(\"abort\", onAbort, { once: true });\n\n    return yield* Effect.acquireUseRelease(\n      Effect.sync(() => ({ signal, onAbort })),\n      ({ signal: _signal }) =>\n        Effect.gen(function* () {\n          // Create a ref to track the last progress emission time for throttling\n          const lastEmitTime = yield* Ref.make(0);\n\n          // Create the stream limiter\n          const limiter = StreamLimiterEffect.limit({\n            maxSize: maxFileSize,\n          });\n\n          // Pipe the data through the limiter\n          const limitedStream = limiter(stream);\n\n          // Write to the data store with progress tracking\n          const offset = yield* dataStore.write(\n            {\n              stream: limitedStream,\n              file_id: upload.id,\n              offset: upload.offset,\n            },\n            {\n              onProgress: (newOffset: number) => {\n                // Simple throttling using timestamp check\n                const now = Date.now();\n                Ref.get(lastEmitTime)\n                  .pipe(\n                    Effect.flatMap((lastTime) => {\n                      if (now - lastTime >= uploadProgressInterval) {\n                        return Effect.gen(function* () {\n                          yield* Ref.set(lastEmitTime, now);\n                          yield* eventEmitter.emit(upload.id, {\n                            type: UploadEventType.UPLOAD_PROGRESS,\n                            data: {\n                              id: upload.id,\n                              progress: newOffset,\n                              total: upload.size ?? 0,\n                            },\n                            flow: upload.flow,\n                          });\n                        });\n                      }\n                      return Effect.void;\n                    }),\n                    Effect.runPromise\n                  )\n                  .catch(() => {\n                    // Ignore errors during progress emission\n                  });\n              },\n            }\n          );\n\n          return offset;\n        }).pipe(\n          Effect.catchAll((error) => {\n            if (error instanceof Error && error.name === \"AbortError\") {\n              return Effect.fail(UploadistaError.fromCode(\"ABORTED\"));\n            }\n            if (error instanceof UploadistaError) {\n              return Effect.fail(error);\n            }\n            return Effect.fail(\n              UploadistaError.fromCode(\"FILE_WRITE_ERROR\", { cause: error })\n            );\n          })\n        ),\n      ({ onAbort }) =>\n        Effect.sync(() => {\n          controller.signal.removeEventListener(\"abort\", onAbort);\n        })\n    );\n  }).pipe(\n    // Add tracing span for write operation\n    Effect.withSpan(\"upload-write-to-store\", {\n      attributes: {\n        \"upload.id\": upload.id,\n        \"upload.offset\": upload.offset.toString(),\n        \"upload.max_file_size\": maxFileSize.toString(),\n        \"upload.file_size\": upload.size?.toString() ?? \"0\",\n      },\n    }),\n    // Add structured logging for write operation\n    Effect.tap((offset) =>\n      Effect.logDebug(\"Data written to store\").pipe(\n        Effect.annotateLogs({\n          \"upload.id\": upload.id,\n          \"write.offset\": offset.toString(),\n          \"write.bytes_written\": (offset - upload.offset).toString(),\n        })\n      )\n    ),\n    // Handle errors with logging\n    Effect.tapError((error) =>\n      Effect.logError(\"Failed to write to store\").pipe(\n        Effect.annotateLogs({\n          \"upload.id\": upload.id,\n          \"upload.offset\": upload.offset.toString(),\n          error: error instanceof UploadistaError ? error.code : String(error),\n        })\n      )\n    )\n  );\n}\n","import { Effect, Metric, MetricBoundaries } from \"effect\";\nimport { UploadistaError } from \"../errors/uploadista-error\";\nimport {\n  type DataStore,\n  type EventEmitter,\n  type KvStore,\n  type UploadEvent,\n  UploadEventType,\n  type UploadFile,\n  type UploadFileDataStoresShape,\n} from \"../types\";\nimport { computeChecksum } from \"../utils/checksum\";\nimport { compareMimeTypes, detectMimeType } from \"./mime\";\nimport { writeToStore } from \"./write-to-store\";\n\n/**\n * Uploads a chunk of data for an existing upload.\n *\n * This function handles the core chunk upload logic including:\n * - Retrieving upload metadata from KV store\n * - Routing to appropriate data store based on storage ID\n * - Writing chunk data to storage with progress tracking\n * - Updating upload offset and metadata\n * - Emitting progress events\n * - Validating upload completion (checksum, MIME type)\n *\n * The function includes comprehensive observability with:\n * - Effect tracing spans for performance monitoring\n * - Metrics tracking for chunk size, throughput, and success rates\n * - Structured logging for debugging and monitoring\n * - Error handling with proper UploadistaError types\n *\n * @param uploadId - Unique identifier for the upload\n * @param clientId - Client identifier (null for anonymous uploads)\n * @param chunk - ReadableStream containing the chunk data to upload\n * @param dataStoreService - Service for routing to appropriate data stores\n * @param kvStore - KV store for upload metadata persistence\n * @param eventEmitter - Event emitter for progress and validation events\n * @returns Effect that yields the updated UploadFile with new offset\n *\n * @example\n * ```typescript\n * // Upload a chunk for an existing upload\n * const uploadChunkEffect = uploadChunk(\n *   \"upload-123\",\n *   \"client-456\",\n *   chunkStream,\n *   {\n *     dataStoreService,\n *     kvStore,\n *     eventEmitter\n *   }\n * );\n *\n * // Run with dependencies\n * const result = await Effect.runPromise(\n *   uploadChunkEffect.pipe(\n *     Effect.provide(dataStoreLayer),\n *     Effect.provide(kvStoreLayer),\n *     Effect.provide(eventEmitterLayer)\n *   )\n * );\n * ```\n */\nexport const uploadChunk = (\n  uploadId: string,\n  clientId: string | null,\n  chunk: ReadableStream,\n  {\n    dataStoreService,\n    kvStore,\n    eventEmitter,\n  }: {\n    dataStoreService: UploadFileDataStoresShape;\n    kvStore: KvStore<UploadFile>;\n    eventEmitter: EventEmitter<UploadEvent>;\n  }\n) =>\n  Effect.gen(function* () {\n    // Get file from KV store\n    const file = yield* kvStore.get(uploadId);\n\n    // Get datastore\n    const dataStore = yield* dataStoreService.getDataStore(\n      file.storage.id,\n      clientId\n    );\n\n    // Note: AbortController could be used for cancellation if needed\n\n    // Write to store using writeToStore Effect\n    const controller = new AbortController();\n\n    const chunkSize = yield* writeToStore({\n      dataStore,\n      data: chunk,\n      upload: file,\n      maxFileSize: 100_000_000,\n      controller,\n      uploadProgressInterval: 200,\n      eventEmitter,\n    });\n\n    file.offset = chunkSize;\n\n    // Update KV store\n    yield* kvStore.set(uploadId, file);\n\n    // Emit progress event\n    yield* eventEmitter.emit(file.id, {\n      type: UploadEventType.UPLOAD_PROGRESS,\n      data: {\n        id: file.id,\n        progress: file.offset,\n        total: file.size ?? 0,\n      },\n      flow: file.flow,\n    });\n\n    // Check if upload is complete and run validation\n    if (file.size && file.offset === file.size) {\n      yield* validateUpload({\n        file,\n        dataStore,\n        eventEmitter,\n      });\n    }\n\n    return file;\n  }).pipe(\n    // Add tracing span for chunk upload\n    Effect.withSpan(\"upload-chunk\", {\n      attributes: {\n        \"upload.id\": uploadId,\n        \"chunk.upload_id\": uploadId,\n      },\n    }),\n    // Track chunk upload metrics\n    Effect.tap((file) =>\n      Effect.gen(function* () {\n        // Increment chunk uploaded counter\n        yield* Metric.increment(\n          Metric.counter(\"chunk_uploaded_total\", {\n            description: \"Total number of chunks uploaded\",\n          })\n        );\n\n        // Record chunk size\n        const chunkSize = file.offset;\n        const chunkSizeHistogram = Metric.histogram(\n          \"chunk_size_bytes\",\n          MetricBoundaries.linear({\n            start: 262_144,\n            width: 262_144,\n            count: 20,\n          })\n        );\n        yield* Metric.update(chunkSizeHistogram, chunkSize);\n\n        // Update throughput gauge\n        if (file.size && file.size > 0) {\n          const throughput = chunkSize; // bytes processed\n          const throughputGauge = Metric.gauge(\n            \"upload_throughput_bytes_per_second\"\n          );\n          yield* Metric.set(throughputGauge, throughput);\n        }\n      })\n    ),\n    // Add structured logging for chunk progress\n    Effect.tap((file) =>\n      Effect.logDebug(\"Chunk uploaded\").pipe(\n        Effect.annotateLogs({\n          \"upload.id\": file.id,\n          \"chunk.size\": file.offset.toString(),\n          \"chunk.progress\":\n            file.size && file.size > 0\n              ? ((file.offset / file.size) * 100).toFixed(2)\n              : \"0\",\n          \"upload.total_size\": file.size?.toString() ?? \"0\",\n        })\n      )\n    ),\n    // Handle errors with logging\n    Effect.tapError((error) =>\n      Effect.logError(\"Chunk upload failed\").pipe(\n        Effect.annotateLogs({\n          \"upload.id\": uploadId,\n          error: String(error),\n        })\n      )\n    )\n  );\n\n/**\n * Validates an upload after completion.\n *\n * Performs comprehensive validation including:\n * - Checksum validation (if provided) using the specified algorithm\n * - MIME type validation (if required by data store capabilities)\n * - File size validation against data store limits\n *\n * Validation results are emitted as events and failures result in:\n * - Cleanup of uploaded data from storage\n * - Removal of metadata from KV store\n * - Appropriate error responses\n *\n * The function respects data store capabilities for validation limits\n * and provides detailed error information for debugging.\n *\n * @param file - The upload file to validate\n * @param dataStore - Data store containing the uploaded file\n * @param eventEmitter - Event emitter for validation events\n * @returns Effect that completes validation or fails with UploadistaError\n *\n * @example\n * ```typescript\n * // Validate upload after completion\n * const validationEffect = validateUpload({\n *   file: completedUpload,\n *   dataStore: s3DataStore,\n *   eventEmitter: progressEmitter\n * });\n *\n * // Run validation\n * await Effect.runPromise(validationEffect);\n * ```\n */\nconst validateUpload = ({\n  file,\n  dataStore,\n  eventEmitter,\n}: {\n  file: UploadFile;\n  dataStore: DataStore<UploadFile>;\n  eventEmitter: EventEmitter<UploadEvent>;\n}): Effect.Effect<void, UploadistaError, never> =>\n  Effect.gen(function* () {\n    const capabilities = dataStore.getCapabilities();\n\n    // Check if file exceeds max validation size\n    if (\n      capabilities.maxValidationSize &&\n      file.size &&\n      file.size > capabilities.maxValidationSize\n    ) {\n      yield* eventEmitter.emit(file.id, {\n        type: UploadEventType.UPLOAD_VALIDATION_WARNING,\n        data: {\n          id: file.id,\n          message: `File size (${file.size} bytes) exceeds max validation size (${capabilities.maxValidationSize} bytes). Validation skipped.`,\n        },\n        flow: file.flow,\n      });\n      return;\n    }\n\n    // Read file from datastore for validation\n    const fileBytes = yield* dataStore.read(file.id);\n\n    // Validate checksum if provided\n    if (file.checksum && file.checksumAlgorithm) {\n      const computedChecksum = yield* computeChecksum(\n        fileBytes,\n        file.checksumAlgorithm\n      );\n\n      if (computedChecksum !== file.checksum) {\n        // Emit validation failure event\n        yield* eventEmitter.emit(file.id, {\n          type: UploadEventType.UPLOAD_VALIDATION_FAILED,\n          data: {\n            id: file.id,\n            reason: \"checksum_mismatch\",\n            expected: file.checksum,\n            actual: computedChecksum,\n          },\n          flow: file.flow,\n        });\n\n        // Clean up file and remove from KV store\n        yield* dataStore.remove(file.id);\n\n        // Fail with checksum mismatch error\n        return yield* UploadistaError.fromCode(\"CHECKSUM_MISMATCH\", {\n          body: `Checksum validation failed. Expected: ${file.checksum}, Got: ${computedChecksum}`,\n          details: {\n            uploadId: file.id,\n            expected: file.checksum,\n            actual: computedChecksum,\n            algorithm: file.checksumAlgorithm,\n          },\n        }).toEffect();\n      }\n\n      // Emit checksum validation success\n      yield* eventEmitter.emit(file.id, {\n        type: UploadEventType.UPLOAD_VALIDATION_SUCCESS,\n        data: {\n          id: file.id,\n          validationType: \"checksum\",\n          algorithm: file.checksumAlgorithm,\n        },\n        flow: file.flow,\n      });\n    }\n\n    // Validate MIME type if required by capabilities\n    if (capabilities.requiresMimeTypeValidation) {\n      const detectedMimeType = detectMimeType(fileBytes);\n      const declaredMimeType = file.metadata?.type as string | undefined;\n\n      if (\n        declaredMimeType &&\n        !compareMimeTypes(declaredMimeType, detectedMimeType)\n      ) {\n        // Emit validation failure event\n        yield* eventEmitter.emit(file.id, {\n          type: UploadEventType.UPLOAD_VALIDATION_FAILED,\n          data: {\n            id: file.id,\n            reason: \"mimetype_mismatch\",\n            expected: declaredMimeType,\n            actual: detectedMimeType,\n          },\n          flow: file.flow,\n        });\n\n        // Clean up file and remove from KV store\n        yield* dataStore.remove(file.id);\n\n        // Fail with MIME type mismatch error\n        return yield* UploadistaError.fromCode(\"MIMETYPE_MISMATCH\", {\n          body: `MIME type validation failed. Expected: ${declaredMimeType}, Detected: ${detectedMimeType}`,\n          details: {\n            uploadId: file.id,\n            expected: declaredMimeType,\n            actual: detectedMimeType,\n          },\n        }).toEffect();\n      }\n\n      // Emit MIME type validation success\n      yield* eventEmitter.emit(file.id, {\n        type: UploadEventType.UPLOAD_VALIDATION_SUCCESS,\n        data: {\n          id: file.id,\n          validationType: \"mimetype\",\n        },\n        flow: file.flow,\n      });\n    }\n  }).pipe(\n    Effect.withSpan(\"validate-upload\", {\n      attributes: {\n        \"upload.id\": file.id,\n        \"validation.checksum_provided\": file.checksum ? \"true\" : \"false\",\n        \"validation.mime_required\": dataStore.getCapabilities()\n          .requiresMimeTypeValidation\n          ? \"true\"\n          : \"false\",\n      },\n    })\n  );\n","import { Effect, Metric } from \"effect\";\nimport { UploadistaError } from \"../errors\";\n\n/**\n * Fetches a file from a remote URL.\n *\n * This function handles HTTP requests to remote URLs for file uploads,\n * including proper error handling, metrics tracking, and observability.\n *\n * Features:\n * - HTTP request with proper error handling\n * - Effect tracing for performance monitoring\n * - Metrics tracking for URL-based uploads\n * - Structured logging for debugging\n * - Response validation and error reporting\n *\n * @param url - The remote URL to fetch the file from\n * @returns Effect that yields the Response object\n *\n * @example\n * ```typescript\n * // Fetch a file from URL\n * const fetchEffect = fetchFile(\"https://example.com/image.jpg\");\n *\n * // Run with error handling\n * const response = await Effect.runPromise(\n *   fetchEffect.pipe(\n *     Effect.catchAll((error) =>\n *       Effect.logError(\"Failed to fetch file\").pipe(\n *         Effect.andThen(Effect.fail(error))\n *       )\n *     )\n *   )\n * );\n * ```\n */\nexport const fetchFile = (url: string) => {\n  return Effect.tryPromise({\n    try: async () => {\n      return await fetch(url);\n    },\n    catch: (error) => {\n      return UploadistaError.fromCode(\"UNKNOWN_ERROR\", {\n        cause: error,\n      });\n    },\n  }).pipe(\n    // Add tracing span for URL fetch\n    Effect.withSpan(\"upload-fetch-url\", {\n      attributes: {\n        \"upload.url\": url,\n        \"upload.operation\": \"fetch\",\n      },\n    }),\n    // Track URL fetch metrics\n    Effect.tap((response) =>\n      Effect.gen(function* () {\n        // Increment URL upload counter\n        yield* Metric.increment(\n          Metric.counter(\"upload_from_url_total\", {\n            description: \"Total number of URL-based uploads\",\n          })\n        );\n\n        // Track success/failure\n        if (response.ok) {\n          yield* Metric.increment(\n            Metric.counter(\"upload_from_url_success_total\", {\n              description: \"Total number of successful URL-based uploads\",\n            })\n          );\n        }\n      })\n    ),\n    // Add structured logging\n    Effect.tap((response) =>\n      Effect.logInfo(\"URL fetch completed\").pipe(\n        Effect.annotateLogs({\n          \"upload.url\": url,\n          \"response.status\": response.status.toString(),\n          \"response.ok\": response.ok.toString(),\n          \"response.content_length\":\n            response.headers.get(\"content-length\") ?? \"unknown\",\n        })\n      )\n    ),\n    // Handle errors with logging and metrics\n    Effect.tapError((error) =>\n      Effect.gen(function* () {\n        // Track failed URL upload\n        yield* Metric.increment(\n          Metric.counter(\"upload_from_url_failed_total\", {\n            description: \"Total number of failed URL-based uploads\",\n          })\n        );\n\n        // Log error\n        yield* Effect.logError(\"URL fetch failed\").pipe(\n          Effect.annotateLogs({\n            \"upload.url\": url,\n            error: String(error),\n          })\n        );\n      })\n    )\n  );\n};\n\n/**\n * Converts a Response object to an ArrayBuffer.\n *\n * This function safely converts HTTP response data to binary format\n * for processing and storage, with proper error handling and observability.\n *\n * Features:\n * - Safe conversion from Response to ArrayBuffer\n * - Effect tracing for performance monitoring\n * - Structured logging for debugging\n * - Error handling with proper UploadistaError types\n *\n * @param response - The HTTP Response object to convert\n * @returns Effect that yields the ArrayBuffer data\n *\n * @example\n * ```typescript\n * // Convert response to buffer\n * const bufferEffect = arrayBuffer(response);\n *\n * // Use in upload pipeline\n * const buffer = await Effect.runPromise(\n *   bufferEffect.pipe(\n *     Effect.tap((buffer) =>\n *       Effect.logInfo(`Buffer size: ${buffer.byteLength} bytes`)\n *     )\n *   )\n * );\n * ```\n */\nexport const arrayBuffer = (response: Response) => {\n  return Effect.tryPromise({\n    try: async () => {\n      return await response.arrayBuffer();\n    },\n    catch: (error) => {\n      return UploadistaError.fromCode(\"UNKNOWN_ERROR\", {\n        cause: error,\n      });\n    },\n  }).pipe(\n    // Add tracing span for buffer conversion\n    Effect.withSpan(\"upload-convert-to-buffer\", {\n      attributes: {\n        \"upload.operation\": \"arrayBuffer\",\n      },\n    }),\n    // Add structured logging\n    Effect.tap((buffer) =>\n      Effect.logDebug(\"Response converted to array buffer\").pipe(\n        Effect.annotateLogs({\n          \"buffer.size\": buffer.byteLength.toString(),\n        })\n      )\n    ),\n    // Handle errors with logging\n    Effect.tapError((error) =>\n      Effect.logError(\"Failed to convert response to array buffer\").pipe(\n        Effect.annotateLogs({\n          error: String(error),\n        })\n      )\n    )\n  );\n};\n","import { Context, Effect, Layer } from \"effect\";\nimport type { UploadistaError } from \"../errors\";\nimport type {\n  DataStore,\n  DataStoreCapabilities,\n  EventEmitter,\n  InputFile,\n  KvStore,\n  Middleware,\n  UploadEvent,\n  UploadFile,\n  WebSocketConnection,\n} from \"../types\";\nimport {\n  UploadEventEmitter,\n  UploadFileDataStores,\n  UploadFileKVStore,\n} from \"../types\";\nimport { GenerateId, type GenerateIdShape } from \"../utils/generate-id\";\nimport { createUpload } from \"./create-upload\";\nimport { uploadChunk } from \"./upload-chunk\";\nimport { arrayBuffer, fetchFile } from \"./upload-url\";\n\n/**\n * Legacy configuration options for UploadServer.\n *\n * @deprecated Use Effect Layers instead of this configuration object.\n * This type is kept for backward compatibility.\n *\n * @property dataStore - DataStore instance or factory function\n * @property kvStore - KV store for upload metadata\n * @property eventEmitter - Event emitter for upload progress\n * @property generateId - Optional ID generator (defaults to UUID)\n * @property middlewares - Optional request middlewares\n * @property withTracing - Enable Effect tracing for debugging\n */\nexport type UploadServerOptions = {\n  dataStore:\n    | ((storageId: string) => Promise<DataStore<UploadFile>>)\n    | DataStore<UploadFile>;\n  kvStore: KvStore<UploadFile>;\n  eventEmitter: EventEmitter<UploadEvent>;\n  generateId?: GenerateIdShape;\n  middlewares?: Middleware[];\n  withTracing?: boolean;\n};\n\n/**\n * UploadServer service interface.\n *\n * This is the core upload handling service that provides all file upload operations.\n * It manages upload lifecycle, resumable uploads, progress tracking, and storage integration.\n *\n * All operations return Effect types for composable, type-safe error handling.\n *\n * @property createUpload - Initiates a new upload and returns metadata\n * @property uploadChunk - Uploads a chunk of data for an existing upload\n * @property getCapabilities - Returns storage backend capabilities\n * @property upload - Complete upload in one operation (create + upload data)\n * @property uploadFromUrl - Uploads a file from a remote URL\n * @property getUpload - Retrieves upload metadata by ID\n * @property read - Reads the complete uploaded file data\n * @property delete - Deletes an upload and its data\n * @property subscribeToUploadEvents - Subscribes WebSocket to upload progress events\n * @property unsubscribeFromUploadEvents - Unsubscribes from upload events\n *\n * @example\n * ```typescript\n * // Basic upload flow\n * const program = Effect.gen(function* () {\n *   const server = yield* UploadServer;\n *\n *   // 1. Create upload\n *   const inputFile: InputFile = {\n *     storageId: \"s3-production\",\n *     size: 1024000,\n *     type: \"image/jpeg\",\n *     fileName: \"photo.jpg\"\n *   };\n *   const upload = yield* server.createUpload(inputFile, \"client123\");\n *\n *   // 2. Upload chunks\n *   const chunk = new ReadableStream(...);\n *   const updated = yield* server.uploadChunk(upload.id, \"client123\", chunk);\n *\n *   // 3. Read the uploaded file\n *   const data = yield* server.read(upload.id, \"client123\");\n *\n *   return upload;\n * });\n *\n * // Upload with WebSocket progress tracking\n * const uploadWithProgress = Effect.gen(function* () {\n *   const server = yield* UploadServer;\n *\n *   // Subscribe to progress events\n *   yield* server.subscribeToUploadEvents(uploadId, websocket);\n *\n *   // Upload (events will be emitted automatically)\n *   const result = yield* server.upload(inputFile, clientId, stream);\n *\n *   // Unsubscribe when done\n *   yield* server.unsubscribeFromUploadEvents(uploadId);\n *\n *   return result;\n * });\n *\n * // Upload from URL\n * const urlUpload = Effect.gen(function* () {\n *   const server = yield* UploadServer;\n *\n *   const inputFile: InputFile = {\n *     storageId: \"s3-production\",\n *     size: 0, // Unknown initially\n *     type: \"image/png\",\n *     fileName: \"remote-image.png\"\n *   };\n *\n *   const upload = yield* server.uploadFromUrl(\n *     inputFile,\n *     \"client123\",\n *     \"https://example.com/image.png\"\n *   );\n *\n *   return upload;\n * });\n * ```\n */\nexport type UploadServerShape = {\n  createUpload: (\n    inputFile: InputFile,\n    clientId: string | null,\n  ) => Effect.Effect<UploadFile, UploadistaError>;\n  uploadChunk: (\n    uploadId: string,\n    clientId: string | null,\n    chunk: ReadableStream,\n  ) => Effect.Effect<UploadFile, UploadistaError>;\n  getCapabilities: (\n    storageId: string,\n    clientId: string | null,\n  ) => Effect.Effect<DataStoreCapabilities, UploadistaError>;\n  upload: (\n    file: InputFile,\n    clientId: string | null,\n    stream: ReadableStream,\n  ) => Effect.Effect<UploadFile, UploadistaError>;\n  uploadFromUrl: (\n    inputFile: InputFile,\n    clientId: string | null,\n    url: string,\n  ) => Effect.Effect<UploadFile, UploadistaError>;\n  getUpload: (uploadId: string) => Effect.Effect<UploadFile, UploadistaError>;\n  read: (\n    uploadId: string,\n    clientId: string | null,\n  ) => Effect.Effect<Uint8Array, UploadistaError>;\n  delete: (\n    uploadId: string,\n    clientId: string | null,\n  ) => Effect.Effect<void, UploadistaError>;\n  subscribeToUploadEvents: (\n    uploadId: string,\n    connection: WebSocketConnection,\n  ) => Effect.Effect<void, UploadistaError>;\n  unsubscribeFromUploadEvents: (\n    uploadId: string,\n  ) => Effect.Effect<void, UploadistaError>;\n};\n\n/**\n * Effect-TS context tag for the UploadServer service.\n *\n * Use this tag to access the UploadServer in an Effect context.\n * The server must be provided via a Layer or dependency injection.\n *\n * @example\n * ```typescript\n * // Access UploadServer in an Effect\n * const uploadEffect = Effect.gen(function* () {\n *   const server = yield* UploadServer;\n *   const upload = yield* server.createUpload(inputFile, clientId);\n *   return upload;\n * });\n *\n * // Provide UploadServer layer\n * const program = uploadEffect.pipe(\n *   Effect.provide(uploadServer),\n *   Effect.provide(uploadFileKvStore),\n *   Effect.provide(dataStoreLayer),\n *   Effect.provide(eventEmitterLayer)\n * );\n * ```\n */\nexport class UploadServer extends Context.Tag(\"UploadServer\")<\n  UploadServer,\n  UploadServerShape\n>() {}\n\n/**\n * Creates the UploadServer implementation.\n *\n * This function constructs the UploadServer service by composing all required\n * dependencies (KV store, data stores, event emitter, ID generator). It implements\n * all upload operations defined in UploadServerShape.\n *\n * The server automatically handles:\n * - Upload lifecycle management (create, resume, complete)\n * - Progress tracking and event emission\n * - Storage backend routing based on storageId\n * - Error handling with proper UploadistaError types\n *\n * @returns An Effect that yields the UploadServerShape implementation\n *\n * @example\n * ```typescript\n * // Create a custom UploadServer layer\n * const myUploadServer = Layer.effect(\n *   UploadServer,\n *   createUploadServer()\n * );\n *\n * // Use in a program\n * const program = Effect.gen(function* () {\n *   const server = yield* UploadServer;\n *   // Use server operations...\n * }).pipe(Effect.provide(myUploadServer));\n * ```\n */\nexport function createUploadServer() {\n  return Effect.gen(function* () {\n    const kvStore = yield* UploadFileKVStore;\n    const eventEmitter = yield* UploadEventEmitter;\n    const generateId = yield* GenerateId;\n    const dataStoreService = yield* UploadFileDataStores;\n\n    return {\n      upload: (\n        inputFile: InputFile,\n        clientId: string | null,\n        stream: ReadableStream,\n      ) =>\n        Effect.gen(function* () {\n          const fileCreated = yield* createUpload(inputFile, clientId, {\n            dataStoreService,\n            kvStore,\n            eventEmitter,\n            generateId,\n          });\n          return yield* uploadChunk(fileCreated.id, clientId, stream, {\n            dataStoreService,\n            kvStore,\n            eventEmitter,\n          });\n        }),\n      uploadFromUrl: (\n        inputFile: InputFile,\n        clientId: string | null,\n        url: string,\n      ) =>\n        Effect.gen(function* () {\n          const response = yield* fetchFile(url);\n          const buffer = yield* arrayBuffer(response);\n\n          // Create a readable stream from the buffer\n          const stream = new ReadableStream({\n            start(controller) {\n              controller.enqueue(new Uint8Array(buffer));\n              controller.close();\n            },\n          });\n\n          const fileCreated = yield* createUpload(\n            { ...inputFile, size: buffer.byteLength },\n            clientId,\n            {\n              dataStoreService,\n              kvStore,\n              eventEmitter,\n              generateId,\n            },\n          );\n          return yield* uploadChunk(fileCreated.id, clientId, stream, {\n            dataStoreService,\n            kvStore,\n            eventEmitter,\n          });\n        }),\n      createUpload: (inputFile: InputFile, clientId: string | null) =>\n        Effect.gen(function* () {\n          const fileCreated = yield* createUpload(inputFile, clientId, {\n            dataStoreService,\n            kvStore,\n            eventEmitter,\n            generateId,\n          });\n          return fileCreated;\n        }),\n      uploadChunk: (\n        uploadId: string,\n        clientId: string | null,\n        chunk: ReadableStream,\n      ) =>\n        Effect.gen(function* () {\n          const file = yield* uploadChunk(uploadId, clientId, chunk, {\n            dataStoreService,\n            kvStore,\n            eventEmitter,\n          });\n          return file;\n        }),\n      getUpload: (uploadId: string) =>\n        Effect.gen(function* () {\n          const file = yield* kvStore.get(uploadId);\n          return file;\n        }),\n      read: (uploadId: string, clientId: string | null) =>\n        Effect.gen(function* () {\n          const upload = yield* kvStore.get(uploadId);\n          const dataStore = yield* dataStoreService.getDataStore(\n            upload.storage.id,\n            clientId,\n          );\n          return yield* dataStore.read(uploadId);\n        }),\n      delete: (uploadId: string, clientId: string | null) =>\n        Effect.gen(function* () {\n          const upload = yield* kvStore.get(uploadId);\n          const dataStore = yield* dataStoreService.getDataStore(\n            upload.storage.id,\n            clientId,\n          );\n          yield* dataStore.remove(uploadId);\n          yield* kvStore.delete(uploadId);\n          return;\n        }),\n      getCapabilities: (storageId: string, clientId: string | null) =>\n        Effect.gen(function* () {\n          const dataStore = yield* dataStoreService.getDataStore(\n            storageId,\n            clientId,\n          );\n          return dataStore.getCapabilities();\n        }),\n      subscribeToUploadEvents: (\n        uploadId: string,\n        connection: WebSocketConnection,\n      ) =>\n        Effect.gen(function* () {\n          yield* eventEmitter.subscribe(uploadId, connection);\n        }),\n      unsubscribeFromUploadEvents: (uploadId: string) =>\n        Effect.gen(function* () {\n          yield* eventEmitter.unsubscribe(uploadId);\n        }),\n    } satisfies UploadServerShape;\n  });\n}\n\n/**\n * Pre-built UploadServer Effect Layer.\n *\n * This layer provides a ready-to-use UploadServer implementation that can be\n * composed with other layers to build a complete upload system.\n *\n * Required dependencies:\n * - UploadFileKVStore: For storing upload metadata\n * - UploadFileDataStores: For routing to storage backends\n * - UploadEventEmitter: For progress events\n * - GenerateId: For creating upload IDs\n *\n * @example\n * ```typescript\n * // Compose a complete upload system\n * const fullUploadSystem = Layer.mergeAll(\n *   uploadServer,\n *   uploadFileKvStore,\n *   dataStoreLayer,\n *   uploadEventEmitter,\n *   generateIdLayer\n * );\n *\n * // Use in application\n * const app = Effect.gen(function* () {\n *   const server = yield* UploadServer;\n *   // Perform uploads...\n * }).pipe(Effect.provide(fullUploadSystem));\n * ```\n */\nexport const uploadServer = Layer.effect(UploadServer, createUploadServer());\n","import type { DataStoreCapabilities, UploadStrategy } from \"../types\";\n\n/**\n * Configuration options for upload strategy negotiation.\n *\n * @property fileSize - Size of the file to be uploaded in bytes\n * @property preferredStrategy - Preferred upload strategy (single, parallel, resumable)\n * @property preferredChunkSize - Preferred chunk size in bytes\n * @property parallelUploads - Number of parallel upload connections\n * @property minChunkSizeForParallel - Minimum file size to consider parallel uploads\n */\nexport type UploadStrategyOptions = {\n  fileSize: number;\n  preferredStrategy?: UploadStrategy;\n  preferredChunkSize?: number;\n  parallelUploads?: number;\n  minChunkSizeForParallel?: number;\n};\n\n/**\n * Result of upload strategy negotiation.\n *\n * @property strategy - The negotiated upload strategy\n * @property chunkSize - The negotiated chunk size in bytes\n * @property parallelUploads - The negotiated number of parallel uploads\n * @property reasoning - Array of reasoning strings explaining the decisions\n * @property warnings - Array of warning messages about adjustments made\n */\nexport type NegotiatedStrategy = {\n  strategy: UploadStrategy;\n  chunkSize: number;\n  parallelUploads: number;\n  reasoning: string[];\n  warnings: string[];\n};\n\n/**\n * Negotiates the optimal upload strategy based on data store capabilities and file characteristics.\n *\n * This class analyzes data store capabilities, file size, and user preferences to determine\n * the best upload strategy (single, parallel, resumable) and optimal parameters like chunk size\n * and parallel connection count.\n *\n * The negotiator considers:\n * - Data store capabilities (parallel uploads, resumable uploads, concatenation)\n * - File size and chunk size constraints\n * - User preferences and requirements\n * - Performance optimization opportunities\n *\n * @example\n * ```typescript\n * // Create negotiator for S3 data store\n * const negotiator = new UploadStrategyNegotiator(\n *   s3Capabilities,\n *   (strategy) => s3Capabilities.supportsStrategy(strategy)\n * );\n *\n * // Negotiate strategy for large file\n * const result = negotiator.negotiateStrategy({\n *   fileSize: 100_000_000, // 100MB\n *   preferredStrategy: \"parallel\",\n *   preferredChunkSize: 5_000_000, // 5MB chunks\n *   parallelUploads: 4\n * });\n *\n * console.log(result.strategy); // \"parallel\"\n * console.log(result.chunkSize); // 5_000_000\n * console.log(result.reasoning); // [\"Using preferred strategy: parallel\", ...]\n * ```\n */\nexport class UploadStrategyNegotiator {\n  /**\n   * Creates a new upload strategy negotiator.\n   *\n   * @param capabilities - Data store capabilities and constraints\n   * @param validateUploadStrategy - Function to validate if a strategy is supported\n   */\n  constructor(\n    private capabilities: DataStoreCapabilities,\n    private validateUploadStrategy: (strategy: UploadStrategy) => boolean\n  ) {}\n\n  /**\n   * Negotiates the optimal upload strategy based on options and data store capabilities.\n   *\n   * This method analyzes the provided options and data store capabilities to determine\n   * the best upload strategy, chunk size, and parallel upload settings. It considers\n   * user preferences, file size, and data store constraints to make optimal decisions.\n   *\n   * The negotiation process:\n   * 1. Validates preferred strategy against data store capabilities\n   * 2. Automatically selects strategy based on file size and capabilities\n   * 3. Adjusts chunk size to fit within data store constraints\n   * 4. Validates parallel upload settings\n   * 5. Ensures final strategy is supported by the data store\n   *\n   * @param options - Upload strategy options including file size and preferences\n   * @returns Negotiated strategy with reasoning and warnings\n   *\n   * @example\n   * ```typescript\n   * const result = negotiator.negotiateStrategy({\n   *   fileSize: 50_000_000, // 50MB\n   *   preferredStrategy: \"parallel\",\n   *   preferredChunkSize: 5_000_000, // 5MB\n   *   parallelUploads: 3\n   * });\n   *\n   * console.log(result.strategy); // \"parallel\"\n   * console.log(result.chunkSize); // 5_000_000\n   * console.log(result.parallelUploads); // 3\n   * console.log(result.reasoning); // [\"Using preferred strategy: parallel\", ...]\n   * console.log(result.warnings); // [] (no warnings)\n   * ```\n   */\n  negotiateStrategy(options: UploadStrategyOptions): NegotiatedStrategy {\n    const reasoning: string[] = [];\n    const warnings: string[] = [];\n\n    let strategy: UploadStrategy = \"single\";\n    let chunkSize =\n      options.preferredChunkSize ??\n      this.capabilities.optimalChunkSize ??\n      1024 * 1024;\n    let parallelUploads = options.parallelUploads ?? 1;\n\n    // Check if data store supports the preferred strategy\n    if (options.preferredStrategy) {\n      if (!this.validateUploadStrategy(options.preferredStrategy)) {\n        warnings.push(\n          `Preferred strategy '${options.preferredStrategy}' not supported by data store, falling back`\n        );\n      } else {\n        strategy = options.preferredStrategy;\n        reasoning.push(`Using preferred strategy: ${strategy}`);\n      }\n    }\n\n    // Automatic strategy selection based on capabilities and file size\n    if (\n      !options.preferredStrategy ||\n      !this.validateUploadStrategy(options.preferredStrategy)\n    ) {\n      if (\n        this.capabilities.supportsParallelUploads &&\n        options.fileSize > (options.minChunkSizeForParallel ?? 10 * 1024 * 1024)\n      ) {\n        strategy = \"parallel\";\n        reasoning.push(\n          `Selected parallel upload for large file (${options.fileSize} bytes)`\n        );\n      } else {\n        strategy = \"single\";\n        reasoning.push(\n          this.capabilities.supportsParallelUploads\n            ? `Selected single upload for small file (${options.fileSize} bytes)`\n            : \"Selected single upload (parallel not supported by data store)\"\n        );\n      }\n    }\n\n    // Validate and adjust chunk size based on data store constraints\n    if (\n      this.capabilities.minChunkSize &&\n      chunkSize < this.capabilities.minChunkSize\n    ) {\n      warnings.push(\n        `Chunk size ${chunkSize} below minimum ${this.capabilities.minChunkSize}, adjusting`\n      );\n      chunkSize = this.capabilities.minChunkSize;\n    }\n\n    if (\n      this.capabilities.maxChunkSize &&\n      chunkSize > this.capabilities.maxChunkSize\n    ) {\n      warnings.push(\n        `Chunk size ${chunkSize} above maximum ${this.capabilities.maxChunkSize}, adjusting`\n      );\n      chunkSize = this.capabilities.maxChunkSize;\n    }\n\n    // Validate parallel upload settings\n    if (strategy === \"parallel\") {\n      if (\n        this.capabilities.maxConcurrentUploads &&\n        parallelUploads > this.capabilities.maxConcurrentUploads\n      ) {\n        warnings.push(\n          `Parallel uploads ${parallelUploads} exceeds maximum ${this.capabilities.maxConcurrentUploads}, adjusting`\n        );\n        parallelUploads = this.capabilities.maxConcurrentUploads;\n      }\n\n      // Check if file would exceed max parts limit\n      if (this.capabilities.maxParts) {\n        const estimatedParts = Math.ceil(options.fileSize / chunkSize);\n        if (estimatedParts > this.capabilities.maxParts) {\n          const minChunkForParts = Math.ceil(\n            options.fileSize / this.capabilities.maxParts\n          );\n          warnings.push(\n            `Estimated parts ${estimatedParts} exceeds maximum ${this.capabilities.maxParts}, increasing chunk size`\n          );\n          chunkSize = Math.max(chunkSize, minChunkForParts);\n        }\n      }\n    }\n\n    // Final validation - ensure strategy is still valid after adjustments\n    if (!this.validateUploadStrategy(strategy)) {\n      warnings.push(\n        `Final strategy validation failed, falling back to single upload`\n      );\n      strategy = \"single\";\n      parallelUploads = 1;\n    }\n\n    // Add capability information to reasoning\n    reasoning.push(\n      `Data store capabilities: parallel=${this.capabilities.supportsParallelUploads}, concatenation=${this.capabilities.supportsConcatenation}, resumable=${this.capabilities.supportsResumableUploads}`\n    );\n\n    return {\n      strategy,\n      chunkSize,\n      parallelUploads: strategy === \"parallel\" ? parallelUploads : 1,\n      reasoning,\n      warnings,\n    };\n  }\n\n  /**\n   * Gets the data store capabilities used by this negotiator.\n   *\n   * @returns The data store capabilities and constraints\n   */\n  getDataStoreCapabilities(): DataStoreCapabilities {\n    return this.capabilities;\n  }\n\n  /**\n   * Validates upload strategy configuration against data store capabilities.\n   *\n   * This method checks if the provided configuration is valid for the current\n   * data store capabilities without performing the actual negotiation. It's\n   * useful for pre-validation before attempting to negotiate a strategy.\n   *\n   * @param options - Upload strategy options to validate\n   * @returns Validation result with validity flag and error messages\n   *\n   * @example\n   * ```typescript\n   * const validation = negotiator.validateConfiguration({\n   *   fileSize: 10_000_000,\n   *   preferredStrategy: \"parallel\",\n   *   preferredChunkSize: 1_000_000,\n   *   parallelUploads: 5\n   * });\n   *\n   * if (!validation.valid) {\n   *   console.log(\"Configuration errors:\", validation.errors);\n   *   // Handle validation errors\n   * }\n   * ```\n   */\n  validateConfiguration(options: UploadStrategyOptions): {\n    valid: boolean;\n    errors: string[];\n  } {\n    const errors: string[] = [];\n\n    if (\n      options.preferredStrategy &&\n      !this.validateUploadStrategy(options.preferredStrategy)\n    ) {\n      errors.push(\n        `Preferred strategy '${options.preferredStrategy}' not supported by data store`\n      );\n    }\n\n    if (options.preferredChunkSize) {\n      if (\n        this.capabilities.minChunkSize &&\n        options.preferredChunkSize < this.capabilities.minChunkSize\n      ) {\n        errors.push(\n          `Chunk size ${options.preferredChunkSize} below data store minimum ${this.capabilities.minChunkSize}`\n        );\n      }\n      if (\n        this.capabilities.maxChunkSize &&\n        options.preferredChunkSize > this.capabilities.maxChunkSize\n      ) {\n        errors.push(\n          `Chunk size ${options.preferredChunkSize} above data store maximum ${this.capabilities.maxChunkSize}`\n        );\n      }\n    }\n\n    if (\n      options.parallelUploads &&\n      this.capabilities.maxConcurrentUploads &&\n      options.parallelUploads > this.capabilities.maxConcurrentUploads\n    ) {\n      errors.push(\n        `Parallel uploads ${options.parallelUploads} exceeds data store maximum ${this.capabilities.maxConcurrentUploads}`\n      );\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n    };\n  }\n}\n"],"mappings":"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"}

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"}