@visulima/storage 1.0.0-alpha.25 → 1.0.0-alpha.27

package/dist/packem_shared/{s3-base-storage.d-Ccatb1dO.d.ts → s3-base-storage.d-BROGYJ4F.d.ts}

@@ -1,5 +1,5 @@
 import { Readable } from 'node:stream';
-import { F as File, M as MetaStorage, d as createRetryWrapper, e as FileInit, B as BaseStorage, R as RetryConfig, f as FilePart, g as FileQuery, a as FileReturn } from "./storage.d-sc8gn16g.js";
+import { F as File, M as MetaStorage, d as createRetryWrapper, e as FileInit, B as BaseStorage, R as RetryConfig, f as FilePart, g as FileQuery, a as FileReturn } from "./storage.d-Cr6f2lac.js";
 /**
 * Part interface for multipart uploads.
 */

package/dist/packem_shared/storage-CoyB2O-Y.js

@@ -0,0 +1 @@
+var H=Object.defineProperty;var h=(t,e)=>H(t,"name",{value:e,configurable:!0});import{Readable as X}from"node:stream";import{setInterval as J}from"node:timers";import{inspect as Q}from"node:util";import{L as ee,O as I}from"./path-D7rMc9nq-B718mbm6.js";import te from"type-is";import re from"./NoOpMetrics-Dky06sf1.js";import{N as oe}from"./cache-qV_5Umeq.js";import{ErrorMap as M,throwErrorCode as E,ERRORS as $}from"./ERRORS-CyOuSMLY.js";import{randomUUID as se}from"node:crypto";import{LRUCache as ae}from"lru-cache";import{o as ie}from"./is-expired-1JuZjDtb.js";var ne=Object.defineProperty,ce=h((t,e)=>ne(t,"name",{value:e,configurable:!0}),"y$3"),le=Object.defineProperty,ue=ce((t,e)=>le(t,"name",{value:e,configurable:!0}),"y"),me=Object.defineProperty,S=ue((t,e)=>me(t,"name",{value:e,configurable:!0}),"i");const de=/^(?<value>-?\d+(?:[.,]\d+)*) *(?<type>[a-z]+)?$/i,ge=/^KIBI/,he=/^MIBI/,pe=/^GIBI/,fe=/^TEBI/,ye=/^PEBI/,be=/^EXBI/,we=/^ZEBI/,ve=/^YIBI/,Ee=/^(.)IB$/,_={iec:[{long:"Bytes",short:"B"},{long:"Kibibytes",short:"KiB"},{long:"Mebibytes",short:"MiB"},{long:"Gibibytes",short:"GiB"},{long:"Tebibytes",short:"TiB"},{long:"Pebibytes",short:"PiB"},{long:"Exbibytes",short:"EiB"},{long:"Zebibytes",short:"ZiB"},{long:"Yobibytes",short:"YiB"}],iec_octet:[{long:"Octets",short:"o"},{long:"Kibioctets",short:"Kio"},{long:"Mebioctets",short:"Mio"},{long:"Gibioctets",short:"Gio"},{long:"Tebioctets",short:"Tio"},{long:"Pebioctets",short:"Pio"},{long:"Exbioctets",short:"Eio"},{long:"Zebioctets",short:"Zio"},{long:"Yobioctets",short:"Yio"}],metric:[{long:"Bytes",short:"Bytes"},{long:"Kilobytes",short:"KB"},{long:"Megabytes",short:"MB"},{long:"Gigabytes",short:"GB"},{long:"Terabytes",short:"TB"},{long:"Petabytes",short:"PB"},{long:"Exabytes",short:"EB"},{long:"Zettabytes",short:"ZB"},{long:"Yottabytes",short:"YB"}],metric_octet:[{long:"Octets",short:"o"},{long:"Kilo-octets",short:"ko"},{long:"Mega-octets",short:"Mo"},{long:"Giga-octets",short:"Go"},{long:"Tera-octets",short:"To"},{long:"Peta-octets",short:"Po"},{long:"Exa-octets",short:"Eo"},{long:"Zetta-octets",short:"Zo"},{long:"Yotta-octets",short:"Yo"}]},$e=S((t,e)=>{const r=new Intl.NumberFormat(e).format(11111).replaceAll(new RegExp("\\p{Number}","gu"),""),o=new Intl.NumberFormat(e).format(1.1).replaceAll(new RegExp("\\p{Number}","gu"),"");return Number.parseFloat(t.replaceAll(new RegExp(`\\${r}`,"g"),"").replace(new RegExp(`\\${o}`),"."))},"parseLocalizedNumber"),F=S(t=>{switch(t){case 2:return 1024;case 10:return 1e3;default:throw new Error("Unsupported base.")}},"fromBase"),j=S((t,e)=>{const r={base:2,locale:"en-US",units:"metric",...e};if(typeof t!="string"||t.length===0)throw new TypeError("Value is not a string or is empty.");if(t.length>100)throw new TypeError("Value exceeds the maximum length of 100 characters.");const o=de.exec(t)?.groups;if(!o)return Number.NaN;const s=$e(o.value,r.locale),i=(o.type??"Bytes").toUpperCase().replace(ge,"KILO").replace(he,"MEGA").replace(pe,"GIGA").replace(fe,"TERA").replace(ye,"PETA").replace(be,"EXA").replace(we,"ZETTA").replace(ve,"YOTTA").replace(Ee,"$1B"),n=_[r.units].findIndex(c=>c.short[0].toUpperCase()===i[0]),l=F(r.base);return s*l**n},"parseBytes");S((t,e)=>{if(typeof t!="number"||!Number.isFinite(t))throw new TypeError("Bytesize is not a number.");const{base:r,decimals:o,locale:s,long:i,unit:n,units:l,...c}={base:2,decimals:0,locale:"en-US",long:!1,units:"metric",...e},a=F(r),m=Math.abs(t),u=e?.space??!0?" ":"",d=_[l],g=d.findIndex(w=>w.short===n);if(t===0){const w=Math.min(0,Math.max(g,d.length-1));return"0"+u+d[w][i?"long":"short"]}const y=g===-1?Math.min(Math.floor(Math.log(m)/Math.log(a)),d.length-1):g,N=d[y][i?"long":"short"],O=t/a**y,v=o<0?void 0:o;return new Intl.NumberFormat(s,{maximumFractionDigits:v,minimumFractionDigits:v,...c}).format(O)+u+N},"formatBytes");var xe=Object.defineProperty,Me=h((t,e)=>xe(t,"name",{value:e,configurable:!0}),"u$3"),Ne=Object.defineProperty,Oe=Me((t,e)=>Ne(t,"name",{value:e,configurable:!0}),"v"),Ae=Object.defineProperty,Te=Oe((t,e)=>Ae(t,"name",{value:e,configurable:!0}),"D");const Se=Te((t,e,r,o,s,i,n,l,c,a,m,u,d,g)=>{const y={d:o,h:s,m:i,mo:e,ms:l,s:n,w:r,y:t};return c!==void 0&&(y.future=c),a!==void 0&&(y.past=a),m!==void 0&&(y.decimal=m),u!==void 0&&(y.unitMap=u),d!==void 0&&(y.groupSeparator=d),g!==void 0&&(y.placeholderSeparator=g),y},"createDurationLanguage"),L={d:"d",day:"d",days:"d",h:"h",hour:"h",hours:"h",hr:"h",hrs:"h",m:"m",millisecond:"ms",milliseconds:"ms",min:"m",mins:"m",minute:"m",minutes:"m",mo:"mo",month:"mo",months:"mo",ms:"ms",s:"s",sec:"s",second:"s",seconds:"s",secs:"s",w:"w",week:"w",weeks:"w",y:"y",year:"y",years:"y",yr:"y",yrs:"y"},Ce=Se(t=>`year${t===1?"":"s"}`,t=>`month${t===1?"":"s"}`,t=>`week${t===1?"":"s"}`,t=>`day${t===1?"":"s"}`,t=>`hour${t===1?"":"s"}`,t=>`minute${t===1?"":"s"}`,t=>`second${t===1?"":"s"}`,t=>`millisecond${t===1?"":"s"}`,"in %s","%s ago",".",L,",","_");var Ie=Object.defineProperty,Be=h((t,e)=>Ie(t,"name",{value:e,configurable:!0}),"o"),Pe=Object.defineProperty,De=Be((t,e)=>Pe(t,"name",{value:e,configurable:!0}),"o"),Ue=Object.defineProperty,ze=De((t,e)=>Ue(t,"name",{value:e,configurable:!0}),"o");const je=ze(t=>{const e=["y","mo","w","d","h","m","s","ms","future","past"];for(const o of e)if(!Object.hasOwn(t,o))throw new TypeError(`Missing required property: ${o}`);if(typeof t.future!="string"||typeof t.past!="string")throw new TypeError("Properties future and past must be of type string");const r=["y","mo","w","d","h","m","s","ms"];for(const o of r)if(typeof t[o]!="string"&&typeof t[o]!="function")throw new TypeError(`Property ${o} must be of type string or function`);if(t.decimal&&typeof t.decimal!="string")throw new TypeError("Property decimal must be of type string");if(t.delimiter&&typeof t.delimiter!="string")throw new TypeError("Property delimiter must be of type string");if(t._digitReplacements&&!Array.isArray(t._digitReplacements))throw new TypeError("Property _digitReplacements must be an array");if(t._numberFirst&&typeof t._numberFirst!="boolean")throw new TypeError("Property _numberFirst must be of type boolean");if(t.unitMap&&typeof t.unitMap!="object")throw new TypeError("Property unitMap must be an object");if(t.unitMap&&Object.values(t.unitMap).some(o=>typeof o!="string"))throw new TypeError("All values in unitMap must be of type string")},"validateDurationLanguage");var ke=Object.defineProperty,_e=h((t,e)=>ke(t,"name",{value:e,configurable:!0}),"w$1"),Fe=Object.defineProperty,Le=_e((t,e)=>Fe(t,"name",{value:e,configurable:!0}),"S"),Re=Object.defineProperty,Ve=Le((t,e)=>Re(t,"name",{value:e,configurable:!0}),"h");const k={d:864e5,h:36e5,m:6e4,mo:2629746e3,ms:1,s:1e3,w:6048e5,y:31556952e3},A=/[-/\\^$*+?.()|[\]{}]/g,Ge=/^PT(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?$/i,Ye=/^(?:(\d+):)?(?:(\d+):)?(\d+)$/,Ze=/^[+-]?\d+(?:\.\d+)?$/,Ke=/^[-+]/,We=Ve((t,e)=>{if(typeof t!="string"||t.length===0)return;const{defaultUnit:r="ms",language:o=Ce}=e??{};je(o);const s=o.decimal??".",i=o.groupSeparator??",",n=o.placeholderSeparator??"_",l=s.replaceAll(A,String.raw`\$&`),c=i.replaceAll(A,String.raw`\$&`),a=n.replaceAll(A,String.raw`\$&`),m=o.unitMap??L;let u=t.replaceAll(new RegExp(String.raw`(\d)[${a}${c}](\d)`,"g"),"$1$2");if(s!=="."&&(u=u.replace(l,".")),Ze.test(t)){const p=Number.parseFloat(u.trim());if(!Number.isNaN(p)){const f=m[r];if(f!==void 0)return p*k[f]}return}const d=Ge.exec(t);if(d){const p=Number.parseInt(d[1]??"0",10),f=Number.parseInt(d[2]??"0",10),x=Number.parseInt(d[3]??"0",10);return p*36e5+f*6e4+x*1e3}const g=Ye.exec(t);if(g){let p=0,f=0;g[2]!==void 0?(p=Number.parseInt(g[1]??"0",10),f=Number.parseInt(g[2],10)):g[1]!==void 0&&(f=Number.parseInt(g[1],10));const x=Number.parseInt(g[3]??"0",10);return p*36e5+f*6e4+x*1e3}const y=Object.keys(m).toSorted((p,f)=>f.length-p.length).map(p=>p.replaceAll(A,String.raw`\$&`)).join("|"),N=new RegExp(String.raw`(-?\d*\.?\d+)\s*(${y})`,"gi");let O=0,v,w=!1,P=-1,D=0;for(N.lastIndex=0;(v=N.exec(u))!==null;){w||(P=v.index),w=!0;const p=v[1],f=v[2];if(!p||!f)continue;const x=p.trim(),K=x.startsWith("-")?-1:1,W=x.replace(Ke,""),U=Number.parseFloat(W),z=m[f.toLowerCase()];if(z===void 0)continue;const q=k[z];if(Number.isNaN(U))return;O+=K*U*q,D=N.lastIndex}const Y=u.slice(0,P).trim(),Z=u.slice(D).trim();if(!(w&&(Y.length>0||Z.length>0))&&w)return O},"parseDuration");var qe=Object.defineProperty,He=h((t,e)=>qe(t,"name",{value:e,configurable:!0}),"n$1");let Xe=class extends ae{static{h(this,"u")}static{He(this,"Locker")}constructor(e){super({ttl:3e4,ttlAutopurge:!0,...e})}lock(e){if(this.get(e)!==void 0)throw new Error(`${e} is locked`);const r=se();return this.set(e,r),r}unlock(e,r){return this.get(e)!==r?!1:this.delete(e)}};var Je=Object.defineProperty,Qe=h((t,e)=>Je(t,"name",{value:e,configurable:!0}),"e$1");const T=Qe(t=>{if(t===Number(t))return t;if(!t)return;const e=We(t);if(e!==void 0)return e},"toMilliseconds");var et=Object.defineProperty,tt=h((t,e)=>et(t,"name",{value:e,configurable:!0}),"t");let rt=class extends Error{static{h(this,"d")}static{tt(this,"ValidationError")}code;statusCode;body;headers;name="ValidationError";constructor(e,r,o,s){const i=typeof o=="string"?o:o?.message||"Validation error";super(i),this.code=e,this.statusCode=r,this.body=o,this.headers=s}};var ot=Object.defineProperty,C=h((t,e)=>ot(t,"name",{value:e,configurable:!0}),"e");const st=C(t=>t&&t[0].toUpperCase()+t.slice(1),"capitalize"),at=C(t=>{if(!Array.isArray(t))return t;const[e,r,o]=t;return{body:r,headers:o,statusCode:e}},"toResponse");class it{static{h(this,"Validator")}constructor(e="ValidationError"){this.prefix=e}prefix;static{C(this,"Validator")}validators={};add(e){Object.entries(e).forEach(([r,o])=>{const s=`${this.prefix}${st(r)}`;if(this.validators[s]={...this.validators[s],...o},typeof this.validators[s].isValid!="function")throw new TypeError('Validation config "isValid" is missing, or it is not a function!')})}async verify(e){for(const[r,o]of Object.entries(this.validators))if(!await o.isValid(e)){const s=o.response||(r in M?M[r]:M.UnknownError),i=at(s),{body:n,headers:l,message:c,statusCode:a}=i;throw new rt(r,a,n||c,l)}}}const Tt=C(t=>t.name==="ValidationError","isValidationError");var nt=Object.defineProperty,B=h((t,e)=>nt(t,"name",{value:e,configurable:!0}),"i");const ct=B(t=>{if(typeof t.name=="string")return t.name;if(typeof t.title=="string")return t.title;if(typeof t.originalName=="string")return t.originalName;if(typeof t.filename=="string")return t.filename},"extractOriginalName"),R=B((t,e)=>{const r={...t};return Object.keys(e).forEach(o=>{const s=e[o];if(s!==null&&typeof s=="object"&&!Array.isArray(s)){const i=r[o],n=i&&typeof i=="object"&&!Array.isArray(i)?i:{};r[o]=R(n,s)}else r[o]=s}),r},"deepMerge"),lt=B((t,e)=>{const r=R(t,e);Object.assign(t,r),t.originalName=ct(t.metadata)||t.originalName},"updateMetadata");var ut=Object.defineProperty,b=h((t,e)=>ut(t,"name",{value:e,configurable:!0}),"g");const mt=/(secret|password|passwd|pwd|token|api[_-]?key|credential|authorization|sas|signature|sessiontoken|connectionstring)/i,V=b(t=>{const e={};for(const[r,o]of Object.entries(t))typeof o=="string"&&mt.test(r)?e[r]="[REDACTED]":o&&typeof o=="object"&&!Array.isArray(o)&&o.constructor===Object?e[r]=V(o):e[r]=o;return e},"redactSecrets"),dt={allowMIME:["*/*"],filename:b(({id:t})=>t,"filename"),maxMetadataSize:"8MB",maxUploadSize:"5TB",onComplete:b(()=>{},"onComplete"),onCreate:b(()=>{},"onCreate"),onDelete:b(()=>{},"onDelete"),onError:b(()=>{},"onError"),onUpdate:b(()=>{},"onUpdate"),useRelativeLocation:!1,validation:{}},gt=b(t=>!t||t.length<3||t.length>255||I(t)?!1:!(t.toUpperCase().includes("../")||t.includes("\0")),"defaultCloudStorageFileNameValidation"),St=b(t=>{if(!t||t.length<3||t.length>255||I(t))return!1;const e=t.toUpperCase();return!['"',"*",":","<",">","?","\\","|","../","\0"].some(r=>e.includes(r))},"defaultFilesystemFileNameValidation");class G{static{h(this,"BaseStorage")}static{b(this,"BaseStorage")}onCreate;onUpdate;onComplete;onDelete;onError;isReady=!0;errorResponses={};cache;logger;metrics;genericConfig;maxMetadataSize;checksumTypes=[];maxUploadSize;expiration;locker;namingFunction;validation=new it;assetFolder=void 0;concurrency;constructor(e){const r={...dt,...e};this.onCreate=r.onCreate,this.onUpdate=r.onUpdate,this.onComplete=r.onComplete,this.onDelete=r.onDelete,this.onError=r.onError,this.namingFunction=r.filename,this.maxUploadSize=typeof r.maxUploadSize=="string"?j(r.maxUploadSize):r.maxUploadSize,this.maxMetadataSize=typeof r.maxMetadataSize=="string"?j(r.maxMetadataSize):r.maxMetadataSize,this.expiration=r.expiration,this.genericConfig=r,r.assetFolder!==void 0&&(this.assetFolder=ee(r.assetFolder)),this.locker=new Xe({max:1e3,ttl:3e4,ttlAutopurge:!0}),this.cache=r.cache??new oe,this.logger=r.logger,this.metrics=r.metrics??new re,this.logger?.debug(`${this.constructor.name} config: ${Q(V({...e,logger:this.logger.constructor}))}`);const o=T(r.expiration?.purgeInterval);o&&this.startAutoPurge(o);const s={isValid(c){if(c.size===void 0)return!0;const a=c.size;if(a==null)return!1;const m=typeof a=="number"?a:Number(a);if(Number.isNaN(m)||m<0)return!1;const u=typeof this.value=="number"?this.value:Number(this.value);return!Number.isNaN(u)&&m<=u},response:M.RequestEntityTooLarge,value:this.maxUploadSize},i={isValid(c){return!!te.is(c.contentType,this.value)},response:M.UnsupportedMediaType,value:r.allowMIME},n=r.fileNameValidation??gt,l={isValid(c){return n(c.name)},response:M.InvalidFileName};this.validation.add({filename:l,mime:i,size:s}),this.validation.add({...r.validation})}get raw(){}async getReadUrl(e,r){return E($.METHOD_NOT_ALLOWED,`${this.constructor.name} does not implement getReadUrl()`)}async getUploadUrl(e,r){return E($.METHOD_NOT_ALLOWED,`${this.constructor.name} does not implement getUploadUrl()`)}get tusExtension(){const e=["creation","creation-with-upload","termination","checksum","creation-defer-length","concatenation"];return this.expiration&&e.push("expiration"),e}async validate(e){await this.validation.verify(e)}async exists(e){return this.instrumentOperation("exists",async()=>{try{return await this.getMeta(e.id),!0}catch{return!1}})}normalizeError(e){const r={code:e.name,message:e.message,name:e.name,statusCode:500};return{...r,message:`[${this.constructor.name}] ${r.message}`}}get config(){return this.genericConfig}async saveMeta(e){return G.assertSafeId(e.id),this.updateTimestamps(e),this.cache.set(e.id,e),this.meta.save(e.id,e)}static assertSafeId(e){(!e||typeof e!="string"||e.includes("\0")||e.includes("../")||e.includes("..\\")||e===".."||e.startsWith("../")||e.startsWith("..\\")||I(e)||/^[A-Z]:[/\\]/i.test(e))&&E($.INVALID_FILE_NAME,`Invalid file id: "${e}"`)}async deleteMeta(e){return this.cache.delete(e),this.meta.delete(e)}async getMeta(e){try{const r=await this.meta.get(e);return this.cache.set(r.id,r),{...r}}catch(r){const o=this.normalizeError(r instanceof Error?r:new Error(String(r)));return await this.onError(o),E($.FILE_NOT_FOUND)}}async checkIfExpired(e){return ie(e)?(this.delete(e).catch(()=>{}),this.deleteMeta(e.id).catch(()=>{}),E($.GONE)):e}async purge(e){return this.instrumentOperation("purge",async()=>{const r=T(e||this.expiration?.maxAge),o={items:[],maxAgeMs:r};if(r){const s=Date.now()-r,i=(await this.list()).filter(n=>Number(new Date(this.expiration?.rolling&&n.modifiedAt||n.createdAt))<s);for await(const{id:n,...l}of i)try{const c=await this.delete({id:n});o.items.push({...c,...l})}catch(c){this.logger?.warn(`Failed to delete file ${n} during purge: ${c instanceof Error?c.message:String(c)}`)}o.items.length>0&&(this.logger?.info(`Purge: removed ${o.items.length} uploads`),this.metrics.gauge("storage.operations.purge.items_count",o.items.length,{storage:this.constructor.name.toLowerCase().replace("storage","")}))}return o})}async getStream({id:e}){return this.instrumentOperation("getStream",async()=>{const r=await this.get({id:e}),o=X.from(r.content);return{headers:{"Content-Length":String(r.size),"Content-Type":r.contentType,...r.ETag&&{ETag:r.ETag},...r.modifiedAt&&{"Last-Modified":r.modifiedAt.toString()}},size:typeof r.size=="number"?r.size:void 0,stream:o}})}async list(e=1e3){return this.instrumentOperation("list",async()=>{throw new Error("Not implemented")})}async update({id:e},r){return this.instrumentOperation("update",async()=>{const o=await this.getMeta(e),s={...r};if("ttl"in s&&s.ttl!==void 0){const n=s.ttl,l=typeof n=="string"?T(n):n;l!==void 0&&(s.expiredAt=Date.now()+l),delete s.ttl}lt(o,s),await this.saveMeta(o);const i={...o,status:"updated"};return await this.onUpdate(i),i})}async deleteBatch(e){const r=Date.now(),o=this.constructor.name.toLowerCase().replace("storage","");this.metrics.increment("storage.operations.batch.delete.count",1,{batch_size:e.length,storage:o});const s=[],i=[],n=e.map(async a=>{try{return{file:await this.delete({id:a}),id:a,success:!0}}catch(m){const u=m instanceof Error?m.message:"Delete failed";return this.metrics.increment("storage.operations.delete.error.count",1,{error:u,storage:o}),{error:u,id:a,success:!1}}}),l=await Promise.allSettled(n);for(const a of l)a.status==="fulfilled"?a.value.success?s.push(a.value.file):i.push({error:a.value.error,id:a.value.id}):i.push({error:a.reason?.message||"Delete failed",id:""});const c=Date.now()-r;return this.metrics.timing("storage.operations.batch.delete.duration",c,{batch_size:e.length,storage:o}),this.metrics.gauge("storage.operations.batch.delete.success_count",s.length,{storage:o}),this.metrics.gauge("storage.operations.batch.delete.failed_count",i.length,{storage:o}),{failed:i,failedCount:i.length,successful:s,successfulCount:s.length}}async copyBatch(e){const r=Date.now(),o=this.constructor.name.toLowerCase().replace("storage","");this.metrics.increment("storage.operations.batch.copy.count",1,{batch_size:e.length,storage:o});const s=[],i=[],n=e.map(async({destination:a,options:m,source:u})=>{try{return{file:await this.copy(u,a,m),id:a,success:!0}}catch(d){const g=d instanceof Error?d.message:"Copy failed";return this.metrics.increment("storage.operations.copy.error.count",1,{error:g,storage:o}),{error:g,id:a,success:!1}}}),l=await Promise.allSettled(n);for(const a of l)a.status==="fulfilled"?a.value.success&&a.value.file?s.push(a.value.file):i.push({error:a.value.error||"Copy failed",id:a.value.id}):i.push({error:a.reason?.message||"Copy failed",id:""});const c=Date.now()-r;return this.metrics.timing("storage.operations.batch.copy.duration",c,{batch_size:e.length,storage:o}),this.metrics.gauge("storage.operations.batch.copy.success_count",s.length,{storage:o}),this.metrics.gauge("storage.operations.batch.copy.failed_count",i.length,{storage:o}),{failed:i,failedCount:i.length,successful:s,successfulCount:s.length}}async moveBatch(e){const r=Date.now(),o=this.constructor.name.toLowerCase().replace("storage","");this.metrics.increment("storage.operations.batch.move.count",1,{batch_size:e.length,storage:o});const s=[],i=[],n=e.map(async({destination:a,source:m})=>{try{return{file:await this.move(m,a),id:a,success:!0}}catch(u){const d=u instanceof Error?u.message:"Move failed";return this.metrics.increment("storage.operations.move.error.count",1,{error:d,storage:o}),{error:d,id:a,success:!1}}}),l=await Promise.allSettled(n);for(const a of l)a.status==="fulfilled"?a.value.success&&a.value.file?s.push(a.value.file):i.push({error:a.value.error||"Move failed",id:a.value.id}):i.push({error:a.reason?.message||"Move failed",id:a.reason?.id||""});const c=Date.now()-r;return this.metrics.timing("storage.operations.batch.move.duration",c,{batch_size:e.length,storage:o}),this.metrics.gauge("storage.operations.batch.move.success_count",s.length,{storage:o}),this.metrics.gauge("storage.operations.batch.move.failed_count",i.length,{storage:o}),{failed:i,failedCount:i.length,successful:s,successfulCount:s.length}}async lock(e){const r=[...this.locker.keys()];return r.includes(e)?E($.FILE_LOCKED):this.config.concurrency&&typeof this.config.concurrency=="number"&&this.config.concurrency<r.length?E($.STORAGE_BUSY):this.locker.lock(e)}async unlock(e,r){if(r===void 0){this.locker.delete(e);return}this.locker.unlock(e,r)}async withLock(e,r){const o=await this.lock(e);try{return await r()}finally{await this.unlock(e,o)}}isUnsupportedChecksum(e=""){return!!e&&!this.checksumTypes.includes(e)}startAutoPurge(e){if(e>=2147483647)throw new Error("“purgeInterval” must be less than 2147483647 ms");J(()=>{this.purge().catch(r=>this.logger?.error(r))},e)}updateTimestamps(e){e.createdAt??=new Date().toISOString();const r=T(this.expiration?.maxAge);return r&&!e.expiredAt&&(e.expiredAt=this.expiration?.rolling?Date.now()+r:+new Date(e.createdAt)+r),e}async instrumentOperation(e,r,o){const s=Date.now(),i={storage:this.constructor.name.toLowerCase().replace("storage",""),...o};try{this.metrics.increment(`storage.operations.${e}.count`,1,i);const n=await r(),l=Date.now()-s;return this.metrics.timing(`storage.operations.${e}.duration`,l,i),n&&typeof n=="object"&&"size"in n&&typeof n.size=="number"&&this.metrics.gauge("storage.files.size",n.size,{...i,operation:e}),n}catch(n){const l=Date.now()-s,c=n instanceof Error?n.message:"Unknown error";throw this.metrics.timing(`storage.operations.${e}.duration`,l,{...i,error:"true"}),this.metrics.increment(`storage.operations.${e}.error.count`,1,{...i,error:c}),n}}}export{j as $,G as B,St as a,rt as b,gt as d,Tt as i,T as t,lt as u,We as z};

package/dist/packem_shared/{storage.d-sc8gn16g.d.ts → storage.d-Cr6f2lac.d.ts}

@@ -14,6 +14,13 @@ interface Cache<K = string, V = unknown> {
   get: (key: K) => V | undefined | Promise<V | undefined>;
   /** Check if a key exists in cache */
   has: (key: K) => boolean | Promise<boolean>;
+  /**
+  * Optional. Iterate over the cache's current keys. Required for prefix-based
+  * eviction (`clearCache(fileId)` in transformers) — when absent, per-file
+  * clear falls back to a full `clear()`. `LRUCache` from `lru-cache`
+  * satisfies this out of the box.
+  */
+  keys?: () => Iterable<K>;
   /** Set a value in cache */
   set: (key: K, value: V, options?: CacheOptions) => boolean | Promise<boolean>;
 }
@@ -192,6 +199,47 @@ declare class UploadError extends Error {
 */
 declare const isUploadError: (error: unknown) => error is UploadError;
 /**
+* Best-effort extraction of an HTTP status from a native SDK error.
+*
+* Covers the shapes used by the consumer-provider SDKs:
+* - Dropbox `DropboxResponseError` → `error.status`
+* - Box `BoxAPIError` / Microsoft Graph errors → `error.statusCode`
+* - googleapis errors → `error.code` (numeric) or `error.response.status`
+* - Supabase / fetch-style errors → `error.status` or `error.response.status`
+*/
+declare const extractHttpStatus: (error: unknown) => number | undefined;
+/**
+* Map an HTTP status code to the closest canonical ERRORS value.
+*
+* Returns STORAGE_ERROR for unknown/5xx and BAD_REQUEST for unmapped 4xx.
+* 401 (unauthenticated) collapses to FORBIDDEN because the ERRORS enum has
+* no dedicated UNAUTHORIZED value; callers needing to distinguish the two
+* should inspect the native error on `UploadError.detail`.
+*/
+declare const mapStatusToErrorCode: (status?: number) => ERRORS;
+/**
+* Normalize a native storage-SDK error into an `UploadError`.
+*
+* The native error is preserved on `.detail` so advanced callers can drop down
+* to provider-specific shapes when needed. Already-wrapped `UploadError`
+* instances pass through unchanged.
+* @example
+* ```ts
+* try {
+*     await client.filesCopyV2({ from_path, to_path });
+* } catch (error) {
+*     throw wrapStorageError(error, { adapter: "Dropbox", operation: "copy" });
+* }
+* ```
+*/
+declare const wrapStorageError: (error: unknown, options: {
+  adapter: string;
+  code?: ERRORS;
+  message?: string;
+  operation: string;
+  status?: number;
+}) => UploadError;
+/**
 * Convenience function to throw an UploadError from a string error code.
 * Looks up the appropriate error message from ErrorMap.
 * @param UploadErrorCode String error code to convert to UploadError
@@ -202,26 +250,27 @@ declare const throwErrorCode: (UploadErrorCode: ERRORS | string, detail?: string
 /**
 * A simple lock map keyed by strings, backed by LRUCache. Locks
 * automatically expire according to the configured TTL preventing deadlocks.
+*
+* Each successful `lock()` returns a unique token; the corresponding `unlock(key, token)`
+* call only releases the lock when the token matches the current holder. This prevents a
+* stale lock owner (e.g. one whose entry TTL'd out and was re-acquired by another caller)
+* from releasing another caller's lock by accident.
 */
-declare class Locker<K extends string = string, V extends string = string> extends LRUCache<K, V, number> {
-  /**
-  * Creates a new Locker instance with configurable TTL and cache options.
-  * @param options LRU cache configuration options
-  */
-  constructor(options?: LRUCache.Options<K, V, number>);
+declare class Locker<K extends string = string> extends LRUCache<K, string, number> {
+  constructor(options?: LRUCache.Options<K, string, number>);
   /**
   * Acquires a lock for the specified key.
-  * Throws an error if the key is already locked.
-  * @param key The key to lock
-  * @returns The lock token (same as the key)
-  * @throws Error if the key is already locked
+  * @returns A unique token identifying the lock holder.
+  * @throws Error if the key is already locked.
   */
   lock(key: K): string;
   /**
-  * Releases the lock for the specified key.
-  * @param key The key to unlock
+  * Releases the lock for the specified key, but only if the token matches the current holder.
+  * Silently no-ops when the lock has expired or is owned by someone else — releasing somebody
+  * else's lock is worse than leaving a stale entry to TTL out on its own.
+  * @returns true if the lock was released, false if it was already gone or owned by another caller.
   */
-  unlock(key: K): void;
+  unlock(key: K, token: string): boolean;
 }
 /**
 * Configurable validation system for file upload constraints.
@@ -278,13 +327,19 @@ declare class Metadata {
 interface FileInit {
   contentType?: string;
   expiredAt?: Date | number | string;
+  /**
+  * Explicit identifier. When provided, the File constructor uses it directly
+  * instead of deriving an id from originalName/size/mtime. Lets callers map a
+  * user-chosen storage key (e.g. `"avatars/abc.png"`) onto the metadata id.
+  */
+  id?: string;
   metadata: Metadata;
   originalName?: string;
   size?: number | string;
   storageClass?: string;
   ttl?: number | string;
 }
-interface FileReturn extends Omit<Required<FileInit>, "storageClass" | "ttl" | "expiredAt"> {
+interface FileReturn extends Omit<Required<FileInit>, "id" | "storageClass" | "ttl" | "expiredAt"> {
   content: Buffer;
   ETag?: string;
   expiredAt?: Date | number | string;
@@ -331,6 +386,7 @@ declare class File implements FileInit {
   constructor({
     contentType,
     expiredAt,
+    id,
     metadata,
     originalName,
     size
@@ -702,6 +758,34 @@ declare abstract class BaseStorage<TFile extends File = File, TFileReturn extend
   */
   protected concurrency?: number;
   protected constructor(config: BaseStorageOptions<TFile>);
+  /**
+  * Escape hatch returning the underlying native client (S3Client, BlobServiceClient, etc.)
+  * for provider-specific operations not covered by the unified API.
+  * Returns `undefined` when no native client is available (e.g. DiskStorage).
+  */
+  get raw(): unknown;
+  /**
+  * Returns a presigned URL for downloading the object at `key`.
+  * Throws `ERRORS.METHOD_NOT_ALLOWED` when the adapter has no native presign support.
+  * @param _key Storage key.
+  * @param _options Optional expiry and response overrides.
+  */
+  getReadUrl(_key: string, _options?: {
+    expiresIn?: number;
+    responseContentDisposition?: string;
+    responseContentType?: string;
+  }): Promise<string>;
+  /**
+  * Returns a presigned URL for uploading a single object to `key`.
+  * Throws `ERRORS.METHOD_NOT_ALLOWED` when the adapter has no native presign support.
+  * @param _key Storage key.
+  * @param _options Optional content type, expiry, and content length hints.
+  */
+  getUploadUrl(_key: string, _options?: {
+    contentLength?: number;
+    contentType?: string;
+    expiresIn?: number;
+  }): Promise<string>;
   get tusExtension(): string[];
   /**
   * Validates a file against configured validation rules.
@@ -735,9 +819,17 @@ declare abstract class BaseStorage<TFile extends File = File, TFileReturn extend
   * @param file File object containing metadata to save.
   * @returns Promise resolving to the saved file object.
   * @remarks Updates timestamps and caches the file metadata.
+  * @throws {UploadError} If `file.id` contains path-traversal sequences, null bytes, or is an absolute path — patterns that could let a local MetaStorage implementation write outside its directory.
   */
   saveMeta(file: TFile): Promise<TFile>;
   /**
+  * Rejects ids containing `..` segments, null bytes, or absolute paths — defense-in-depth
+  * so any MetaStorage / facade / handler that uses `id` as part of a filesystem path or
+  * cross-bucket lookup can't be escaped. Public so the `Files` facade and Fetch handlers
+  * can validate user-supplied keys before any adapter call.
+  */
+  static assertSafeId(id: string): void;
+  /**
   * Deletes upload metadata from the metadata storage.
   * @param id File ID whose metadata should be deleted.
   * @returns Promise resolving when metadata is deleted.
@@ -914,10 +1006,19 @@ declare abstract class BaseStorage<TFile extends File = File, TFileReturn extend
     source: string;
   }[]): Promise<BatchOperationResponse<TFile>>;
   /**
-  * Prevent upload from being accessed by multiple requests
+  * Prevent upload from being accessed by multiple requests.
+  * Returns a unique token that must be passed back to `unlock()` so a caller whose lock TTL'd
+  * out cannot accidentally release a newly-acquired lock held by another request.
   */
   protected lock(key: string): Promise<string>;
-  protected unlock(key: string): Promise<void>;
+  protected unlock(key: string, token?: string): Promise<void>;
+  /**
+  * Run a function while holding the lock for `key`. The lock is released even if `fn` throws,
+  * and only released when the caller still owns the lock (token-verified). Public so that
+  * handlers can serialize cross-call read-modify-write sequences on the same upload (e.g.
+  * appending to `_chunks` during chunked PATCH).
+  */
+  withLock<R>(key: string, function_: () => Promise<R>): Promise<R>;
   protected isUnsupportedChecksum(algorithm?: string): boolean;
   protected startAutoPurge(purgeInterval: number): void;
   protected updateTimestamps(file: TFile): TFile;
@@ -936,4 +1037,4 @@ declare abstract class BaseStorage<TFile extends File = File, TFileReturn extend
   */
   protected instrumentOperation<T>(operation: string, function_: () => Promise<T>, attributes?: Record<string, string | number>): Promise<T>;
 }
-export { RangeChecksum as A, BaseStorage as B, Cache as C, DiskStorageOptions as D, ERRORS as E, File as F, RangeHasher as G, HttpError as H, IncomingMessageWithBody as I, ResponseBody as J, ResponseTuple as K, LocalMetaStorageOptions as L, MetaStorage as M, ValidationError as N, OnComplete as O, PurgeList as P, ValidatorConfig as Q, RetryConfig as R, defaultCloudStorageFileNameValidation as S, defaultFilesystemFileNameValidation as T, UploadFile as U, Validation as V, isRetryableError as W, isUploadError as X, retry as Y, throwErrorCode as Z, FileReturn as a, UploadError as b, UploadEventType as c, createRetryWrapper as d, FileInit as e, FilePart as f, FileQuery as g, DiskStorageWithChecksumOptions as h, ResponseBodyType as i, ErrorResponses as j, BaseStorageOptions as k, UploadResponse as l, MetaStorageOptions as m, Metrics as n, BatchOperationResponse as o, BatchOperationResult as p, ErrorMap as q, ExpirationOptions as r, Header as s, Headers as t, HttpErrorBody as u, Metadata as v, OnCreate as w, OnDelete as x, OnError as y, OnUpdate as z };
+export { throwErrorCode as $, RangeHasher as A, BaseStorage as B, Cache as C, DiskStorageOptions as D, ERRORS as E, File as F, ResponseBody as G, HttpError as H, IncomingMessageWithBody as I, ResponseTuple as J, UploadResponse as K, LocalMetaStorageOptions as L, MetaStorage as M, ValidationError as N, OnComplete as O, PurgeList as P, ValidatorConfig as Q, RetryConfig as R, defaultCloudStorageFileNameValidation as S, defaultFilesystemFileNameValidation as T, UploadFile as U, Validation as V, extractHttpStatus as W, isRetryableError as X, isUploadError as Y, mapStatusToErrorCode as Z, retry as _, FileReturn as a, wrapStorageError as a0, UploadError as b, UploadEventType as c, createRetryWrapper as d, FileInit as e, FilePart as f, FileQuery as g, DiskStorageWithChecksumOptions as h, ResponseBodyType as i, ErrorResponses as j, Metrics as k, BaseStorageOptions as l, BatchOperationResponse as m, BatchOperationResult as n, ErrorMap as o, ExpirationOptions as p, Header as q, Headers as r, HttpErrorBody as s, MetaStorageOptions as t, Metadata as u, OnCreate as v, OnDelete as w, OnError as x, OnUpdate as y, RangeChecksum as z };

package/dist/packem_shared/storj-CVA9mM-7.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var o=(e,s)=>c(e,"name",{value:s,configurable:!0});var n=Object.defineProperty,S=o((e,s)=>n(e,"name",{value:s,configurable:!0}),"r");const a=S(e=>{const s=e?.accessKeyId??process.env.AWS_ACCESS_KEY_ID??process.env.STORJ_ACCESS_KEY_ID??process.env.STORJ_ACCESS_KEY,t=e?.endpoint??process.env.STORJ_ENDPOINT,r=e?.secretAccessKey??process.env.AWS_SECRET_ACCESS_KEY??process.env.STORJ_SECRET_ACCESS_KEY??process.env.STORJ_SECRET_KEY;if(!s||!r)throw new Error("Missing required parameters for Storj client.");return{credentials:{accessKeyId:s,secretAccessKey:r},endpoint:t??"https://gateway.storjshare.io",forcePathStyle:!1,region:"global"}},"storj");export{a as default};

package/dist/packem_shared/tigris-wmhjfsH2.js

@@ -0,0 +1 @@
+var n=Object.defineProperty;var t=(e,s)=>n(e,"name",{value:s,configurable:!0});var o=Object.defineProperty,S=t((e,s)=>o(e,"name",{value:s,configurable:!0}),"r");const _=S(e=>{const s=e?.accessKeyId??process.env.AWS_ACCESS_KEY_ID??process.env.TIGRIS_ACCESS_KEY_ID??process.env.TIGRIS_ACCESS_KEY,c=e?.endpoint??process.env.TIGRIS_ENDPOINT,r=e?.secretAccessKey??process.env.AWS_SECRET_ACCESS_KEY??process.env.TIGRIS_SECRET_ACCESS_KEY??process.env.TIGRIS_SECRET_KEY;if(!s||!r)throw new Error("Missing required parameters for Tigris client.");return{credentials:{accessKeyId:s,secretAccessKey:r},endpoint:c??"https://t3.storage.dev",forcePathStyle:!1,region:"auto"}},"tigris");export{_ as default};

package/dist/packem_shared/{tus-base.d-BX3mSWL6.d.ts → tus-base.d-4-ZfDQwl.d.ts}

@@ -1,8 +1,8 @@
 import { EventEmitter } from 'node:events';
-import { U as UploadFile, i as ResponseBodyType, B as BaseStorage, j as ErrorResponses } from "./storage.d-sc8gn16g.js";
+import { U as UploadFile, i as ResponseBodyType, B as BaseStorage, j as ErrorResponses } from "./storage.d-Cr6f2lac.js";
 import 'node:stream';
-import { M as MediaTransformer } from "./media-transformer.d-BXjTN5Qv.js";
-import { U as UploadOptions } from "./types.d-Cor8FV54.js";
+import { M as MediaTransformer } from "./media-transformer.d-DK7NJncf.js";
+import { U as UploadOptions } from "./types.d-BgCmSE94.js";
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';

package/dist/packem_shared/{types.d-Cor8FV54.d.ts → types.d-BgCmSE94.d.ts}

@@ -2,8 +2,8 @@ import { EventEmitter } from 'node:events';
 import { IncomingMessage } from 'node:http';
 import { Readable } from 'node:stream';
 import { PaginationResult } from '@visulima/pagination';
-import { U as UploadFile, B as BaseStorage, b as UploadError, c as UploadEventType } from "./storage.d-sc8gn16g.js";
-import { M as MediaTransformer } from "./media-transformer.d-BXjTN5Qv.js";
+import { U as UploadFile, B as BaseStorage, b as UploadError, c as UploadEventType } from "./storage.d-Cr6f2lac.js";
+import { M as MediaTransformer } from "./media-transformer.d-DK7NJncf.js";
 type WebRequest = globalThis.Request;
 type WebResponse = globalThis.Response;
 interface BaseResponse {

package/dist/packem_shared/{types.d-b0WcdT0x.d.ts → types.d-C8eSxqX9.d.ts}

@@ -1,4 +1,4 @@
-import { C as Cache, F as File, a as FileReturn, B as BaseStorage } from "./storage.d-sc8gn16g.js";
+import { C as Cache, F as File, a as FileReturn, B as BaseStorage } from "./storage.d-Cr6f2lac.js";
 import { Readable } from 'node:stream';
 /**
 * Base transformer configuration with common properties
@@ -54,6 +54,10 @@ declare abstract class BaseTransformer<Config extends BaseTransformerConfig, Cac
   }>;
   /**
   * Clears cache for a specific file or all files.
+  *
+  * Cache keys are `${fileId}:${stepsHash}` (see `generateCacheKey` in subclasses),
+  * so per-file invalidation must iterate keys to find every transform of `fileId`.
+  * Falls back to a full `clear()` when the underlying cache doesn't expose `keys()`.
   * @param fileId Optional file identifier to clear cache for specific file.
   */
   clearCache(fileId?: string): void;
@@ -680,8 +684,16 @@ interface MediaTransformQuery {
 * Image transformer configuration
 */
 interface ImageTransformerConfig extends BaseTransformerConfig {
+  /** Sharp `failOn` setting controlling which libvips warnings abort decoding. Defaults to `"warning"`. */
+  failOn?: "error" | "none" | "truncated" | "warning";
+  /** Maximum total pixels (width * height) Sharp will decode. Defaults to 268435456 (16k x 16k). */
+  limitInputPixels?: false | number;
+  /** Reject images taller than this many pixels (post-decode metadata check). */
+  maxImageHeight?: number;
   /** Maximum image size to process (in bytes) */
   maxImageSize?: number;
+  /** Reject images wider than this many pixels (post-decode metadata check). */
+  maxImageWidth?: number;
 }
 /**
 * Video transformer configuration
@@ -705,4 +717,4 @@ interface AudioTransformerConfig extends BaseTransformerConfig {
   /** Maximum audio size to process (in bytes) */
   maxAudioSize?: number;
 }
-export { AffineOptions as A, BlurOptions as B, CropOptions as C, DilateOptions as D, ExtractChannelOptions as E, AudioResampleOptions as F, GreyscaleOptions as G, AudioChannelMixOptions as H, ImageTransformerConfig as I, JoinChannelOptions as J, AudioTransformOptions as K, LinearOptions as L, MedianOptions as M, AudioTransformationStep as N, MediaTransformerConfig as O, PipelineColourspaceOptions as P, MediaTransformResult as Q, ResizeOptions as R, SharpenOptions as S, TransformResult as T, MediaTransformQuery as U, VideoTransformerConfig as V, MediaTransformationStep as W, RotateOptions as a, ImageFormat as b, TransformOptions as c, CLAHEOptions as d, ConvolveOptions as e, ThresholdOptions as f, BooleanOptions as g, RecombineOptions as h, ModulateOptions as i, TintOptions as j, ColourspaceOptions as k, BandboolOptions as l, ErodeOptions as m, ToColourspaceOptions as n, RemoveAlphaOptions as o, EnsureAlphaOptions as p, TransformationStep as q, BaseTransformer as r, VideoTransformResult as s, VideoResizeOptions as t, VideoCropOptions as u, VideoRotateOptions as v, VideoTransformOptions as w, VideoTransformationStep as x, AudioTransformerConfig as y, AudioTransformResult as z };
+export { AudioTransformerConfig as A, BaseTransformer as B, CropOptions as C, DilateOptions as D, ExtractChannelOptions as E, ToColourspaceOptions as F, GreyscaleOptions as G, RemoveAlphaOptions as H, ImageTransformerConfig as I, JoinChannelOptions as J, EnsureAlphaOptions as K, LinearOptions as L, MedianOptions as M, TransformationStep as N, MediaTransformerConfig as O, PipelineColourspaceOptions as P, MediaTransformResult as Q, ResizeOptions as R, SharpenOptions as S, TransformResult as T, MediaTransformQuery as U, VideoTransformerConfig as V, MediaTransformationStep as W, VideoTransformResult as a, VideoResizeOptions as b, VideoCropOptions as c, VideoRotateOptions as d, VideoTransformOptions as e, VideoTransformationStep as f, AudioTransformResult as g, AudioResampleOptions as h, AudioChannelMixOptions as i, AudioTransformOptions as j, AudioTransformationStep as k, RotateOptions as l, ImageFormat as m, TransformOptions as n, BlurOptions as o, CLAHEOptions as p, ConvolveOptions as q, ThresholdOptions as r, BooleanOptions as s, RecombineOptions as t, ModulateOptions as u, TintOptions as v, ColourspaceOptions as w, BandboolOptions as x, AffineOptions as y, ErodeOptions as z };

package/dist/packem_shared/wasabi-JQzxdrFy.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var n=(e,s)=>o(e,"name",{value:s,configurable:!0});var S=Object.defineProperty,A=n((e,s)=>S(e,"name",{value:s,configurable:!0}),"t");const a=A(e=>{const s=e?.accessKeyId??process.env.AWS_ACCESS_KEY_ID??process.env.WASABI_ACCESS_KEY_ID??process.env.WASABI_ACCESS_KEY,r=e?.region??process.env.AWS_REGION??process.env.WASABI_REGION,c=e?.secretAccessKey??process.env.AWS_SECRET_ACCESS_KEY??process.env.WASABI_SECRET_ACCESS_KEY??process.env.WASABI_SECRET_KEY;if(!r||!s||!c)throw new Error("Missing required parameters for Wasabi client.");return{apiVersion:"2006-03-01",credentials:{accessKeyId:s,secretAccessKey:c},endpoint:`https://s3.${r}.wasabisys.com`,region:r}},"wasabi");export{a as default};

package/dist/storage/aws/clients/index.d.ts

@@ -1,17 +1,4 @@
-import { S as S3ClientConfig } from "../../../packem_shared/S3Client.d-CZ62Jztg.js";
-import '@aws-sdk/middleware-flexible-checksums';
-import '@aws-sdk/middleware-host-header';
-import '@aws-sdk/middleware-sdk-s3';
-import '@aws-sdk/middleware-user-agent';
-import '@smithy/types';
-import '@smithy/config-resolver';
-import '@smithy/eventstream-serde-config-resolver';
-import '@smithy/middleware-endpoint';
-import '@smithy/middleware-retry';
-import '@smithy/protocol-http';
-import '@smithy/smithy-client';
-import 'node:stream';
-import '@aws-sdk/core/httpAuthSchemes';
+import { S3ClientConfig } from '@aws-sdk/client-s3';
 type CreateCloudflareClientParameters = {
   /**
   * Cloudflare R2 access key ID.
@@ -107,6 +94,72 @@ type CreateTigrisClientParameters = {
   */
   secretAccessKey: string;
 };
+type CreateHetznerClientParameters = {
+  /**
+  * Hetzner Object Storage access key ID.
+  */
+  accessKeyId: string;
+  /**
+  * Hetzner Object Storage location. Used as both the region and the
+  * subdomain of the endpoint (`https://{location}.your-objectstorage.com`).
+  */
+  location: "fsn1" | "hel1" | "nbg1";
+  /**
+  * Hetzner Object Storage secret access key.
+  */
+  secretAccessKey: string;
+};
+type CreateAkamaiClientParameters = {
+  /**
+  * Akamai Cloud Object Storage access key ID.
+  */
+  accessKeyId: string;
+  /**
+  * Override the endpoint. When unset, defaults to
+  * `https://${region}.linodeobjects.com`. The `linodeobjects.com` domain
+  * is unchanged from the Linode era — only the product branding moved
+  * to Akamai.
+  */
+  endpoint?: string;
+  /**
+  * Akamai Cloud Object Storage region/cluster code (formerly Linode Object
+  * Storage). Examples: `"us-iad-1"`, `"us-mia-1"`, `"us-ord-1"`,
+  * `"nl-ams-1"`, `"fr-par-1"`, `"gb-lon-1"`, `"jp-osa-1"`, plus the older
+  * `"us-east-1"` / `"eu-central-1"` / `"ap-south-1"` clusters.
+  */
+  region: string;
+  /**
+  * Akamai Cloud Object Storage secret access key.
+  */
+  secretAccessKey: string;
+};
+type CreateStorjClientParameters = {
+  /**
+  * Storj S3 Gateway access key (derived from a Storj access grant).
+  */
+  accessKeyId: string;
+  /**
+  * Override the Storj S3 Gateway endpoint.
+  * @default `https://gateway.storjshare.io`
+  */
+  endpoint?: string;
+  /**
+  * Storj S3 Gateway secret key (derived from a Storj access grant).
+  */
+  secretAccessKey: string;
+};
+/**
+* Create an Akamai Cloud Object Storage client, compatible with the S3 API.
+*
+* Akamai Cloud Object Storage is the rebranded Linode Object Storage; the
+* underlying `linodeobjects.com` domain is unchanged.
+*
+* Optionally, you can omit the parameters and use the following environment variables:
+* - `AWS_ACCESS_KEY_ID` / `AKAMAI_ACCESS_KEY_ID`
+* - `AWS_SECRET_ACCESS_KEY` / `AKAMAI_SECRET_ACCESS_KEY`
+* - `AKAMAI_REGION` (e.g. `us-iad-1`)
+*/
+declare const akamai: (parameters?: Partial<CreateAkamaiClientParameters>) => S3ClientConfig;
 /**
 * Create a Backblaze B2 client, compatible with the S3 API.
 *
@@ -136,6 +189,15 @@ declare const cloudflare: (parameters?: CreateCloudflareClientParameters) => S3C
 */
 declare const digitalOcean: (parameters?: CreateDigitalOceanClientParameters) => S3ClientConfig;
 /**
+* Create a Hetzner Object Storage client, compatible with the S3 API.
+*
+* Optionally, you can omit the parameters and use the following environment variables:
+* - `AWS_ACCESS_KEY_ID` / `HETZNER_ACCESS_KEY_ID`
+* - `AWS_SECRET_ACCESS_KEY` / `HETZNER_SECRET_ACCESS_KEY`
+* - `HETZNER_LOCATION` (one of `fsn1`, `nbg1`, `hel1`)
+*/
+declare const hetzner: (parameters?: CreateHetznerClientParameters) => S3ClientConfig;
+/**
 * Create a Minio client, compatible with the S3 API.
 *
 * Optionally, you can omit the parameters and use the following environment variables:
@@ -146,6 +208,19 @@ declare const digitalOcean: (parameters?: CreateDigitalOceanClientParameters) =>
 */
 declare const minio: (parameters?: CreateMinioClientParameters) => S3ClientConfig;
 /**
+* Create a Storj S3 Gateway client, compatible with the S3 API.
+*
+* Credentials are derived from a Storj access grant via the
+* `storj.io/uplink` CLI or web console. The default endpoint targets the
+* global Storj S3 Gateway; self-hosted gateways can override via `endpoint`.
+*
+* Optionally, you can omit the parameters and use the following environment variables:
+* - `AWS_ACCESS_KEY_ID` / `STORJ_ACCESS_KEY_ID`
+* - `AWS_SECRET_ACCESS_KEY` / `STORJ_SECRET_ACCESS_KEY`
+* - `STORJ_ENDPOINT` (defaults to `https://gateway.storjshare.io`)
+*/
+declare const storj: (parameters?: CreateStorjClientParameters) => S3ClientConfig;
+/**
 * Create a Tigris client, compatible with the S3 API.
 *
 * Optionally, you can omit the parameters and use the following environment variables:
@@ -163,4 +238,4 @@ declare const tigris: (parameters?: CreateTigrisClientParameters) => S3ClientCon
 * - `AWS_SECRET_ACCESS_KEY`
 */
 declare const wasabi: (parameters?: CreateWasabiClientParameters) => S3ClientConfig;
-export { backblaze, cloudflare, digitalOcean, minio, tigris, wasabi };
+export { akamai, backblaze, cloudflare, digitalOcean, hetzner, minio, storj, tigris, wasabi };

package/dist/storage/aws/clients/index.js

@@ -1 +1 @@
-import{backblaze as r}from"../../../packem_shared/backblaze-DEflv87m.js";import{cloudflare as t}from"../../../packem_shared/cloudflare-DLAeQvgD.js";import{default as l}from"../../../packem_shared/digitalOcean-nhZUds87.js";import{default as m}from"../../../packem_shared/minio-BWwgGXeE.js";import{default as p}from"../../../packem_shared/tigris-DZoyrMNd.js";import{default as x}from"../../../packem_shared/wasabi-Dmce4x9s.js";export{r as backblaze,t as cloudflare,l as digitalOcean,m as minio,p as tigris,x as wasabi};
+import{default as e}from"../../../packem_shared/akamai-BYS9pP8S.js";import{backblaze as t}from"../../../packem_shared/backblaze-CvdtCvJL.js";import{cloudflare as l}from"../../../packem_shared/cloudflare-Bm_Pg6yx.js";import{default as s}from"../../../packem_shared/digitalOcean-Lj1NfDzc.js";import{default as p}from"../../../packem_shared/hetzner-DDxE7Gy7.js";import{default as i}from"../../../packem_shared/minio-T_Z3iEy7.js";import{default as b}from"../../../packem_shared/storj-CVA9mM-7.js";import{default as n}from"../../../packem_shared/tigris-wmhjfsH2.js";import{default as k}from"../../../packem_shared/wasabi-JQzxdrFy.js";export{e as akamai,t as backblaze,l as cloudflare,s as digitalOcean,p as hetzner,i as minio,b as storj,n as tigris,k as wasabi};

package/dist/storage/aws/index.d.ts

@@ -1,22 +1,11 @@
-import { F as File, m as MetaStorageOptions, k as BaseStorageOptions, L as LocalMetaStorageOptions, M as MetaStorage, H as HttpError, g as FileQuery, e as FileInit } from "../../packem_shared/storage.d-sc8gn16g.js";
+import { F as File, t as MetaStorageOptions, l as BaseStorageOptions, L as LocalMetaStorageOptions, M as MetaStorage, H as HttpError, g as FileQuery, e as FileInit } from "../../packem_shared/storage.d-Cr6f2lac.js";
 import { Readable } from 'node:stream';
-import { P as Part, S as S3ApiOperations, a as S3BaseStorage } from "../../packem_shared/s3-base-storage.d-Ccatb1dO.js";
-import { S as S3ClientConfig, O as ObjectCannedACL, a as S3Client } from "../../packem_shared/S3Client.d-CZ62Jztg.js";
-import { ResponseMetadata } from '@smithy/types';
+import { P as Part, S as S3ApiOperations, a as S3BaseStorage } from "../../packem_shared/s3-base-storage.d-BROGYJ4F.js";
+import { S3ClientConfig, ObjectCannedACL, S3Client } from '@aws-sdk/client-s3';
+import { ResponseMetadata } from '@aws-sdk/types';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
-import '@aws-sdk/middleware-flexible-checksums';
-import '@aws-sdk/middleware-host-header';
-import '@aws-sdk/middleware-sdk-s3';
-import '@aws-sdk/middleware-user-agent';
-import '@smithy/config-resolver';
-import '@smithy/eventstream-serde-config-resolver';
-import '@smithy/middleware-endpoint';
-import '@smithy/middleware-retry';
-import '@smithy/protocol-http';
-import '@smithy/smithy-client';
-import '@aws-sdk/core/httpAuthSchemes';
 declare class S3File extends File {
   Parts?: Part[];
   UploadId?: string;
@@ -297,6 +286,7 @@ declare class S3ClientAdapter implements S3ApiOperations {
 declare class S3Storage extends S3BaseStorage {
   static override readonly name: string;
   private s3Api;
+  private rawClient;
   constructor(config: S3StorageOptions);
   /**
   * Normalizes AWS S3 errors with S3-specific context.
@@ -312,6 +302,17 @@ declare class S3Storage extends S3BaseStorage {
     size?: number;
     stream: Readable;
   }>;
+  override get raw(): S3Client;
+  override getReadUrl(key: string, options?: {
+    expiresIn?: number;
+    responseContentDisposition?: string;
+    responseContentType?: string;
+  }): Promise<string>;
+  override getUploadUrl(key: string, options?: {
+    contentLength?: number;
+    contentType?: string;
+    expiresIn?: number;
+  }): Promise<string>;
   protected getS3Api(): S3ClientAdapter;
   protected getFileClass(): new (config: FileInit) => S3File;
   protected getAcl(): string | undefined;

package/dist/storage/aws/index.js

@@ -1 +1 @@
-import{default as t}from"../../packem_shared/S3File-Du6wP0Sz.js";import{default as r}from"../../packem_shared/S3MetaStorage-vcriiosn.js";import{default as S}from"../../packem_shared/S3Storage-Fx6-OSc-.js";export{t as S3File,r as S3MetaStorage,S as S3Storage};
+import{default as t}from"../../packem_shared/S3File-BfmCOET4.js";import{default as r}from"../../packem_shared/S3MetaStorage-vcriiosn.js";import{default as S}from"../../packem_shared/S3Storage-D8dopWoO.js";export{t as S3File,r as S3MetaStorage,S as S3Storage};

package/dist/storage/aws-light/index.d.ts

@@ -1,6 +1,7 @@
-import { P as Part, S as S3ApiOperations, a as S3BaseStorage } from "../../packem_shared/s3-base-storage.d-Ccatb1dO.js";
-import { F as File, m as MetaStorageOptions, k as BaseStorageOptions, M as MetaStorage, H as HttpError, g as FileQuery, e as FileInit } from "../../packem_shared/storage.d-sc8gn16g.js";
+import { P as Part, S as S3ApiOperations, a as S3BaseStorage } from "../../packem_shared/s3-base-storage.d-BROGYJ4F.js";
+import { F as File, t as MetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, H as HttpError, g as FileQuery, e as FileInit } from "../../packem_shared/storage.d-Cr6f2lac.js";
 import { Readable } from 'node:stream';
+import { AwsClient } from 'aws4fetch';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
@@ -65,7 +66,7 @@ declare class AwsLightMetaStorage<T extends File = File> extends MetaStorage<T>
 * Adapter that uses aws4fetch to implement S3ApiOperations interface.
 */
 declare class AwsLightApiAdapter implements S3ApiOperations {
-  private aws;
+  aws: AwsClient;
   private readonly bucket;
   private readonly endpoint;
   constructor(config: AwsLightClientConfig & {
@@ -244,6 +245,7 @@ declare class AwsLightStorage extends S3BaseStorage {
     size?: number;
     stream: Readable;
   }>;
+  override get raw(): AwsClient;
   protected getS3Api(): AwsLightApiAdapter;
   protected getFileClass(): new (config: FileInit) => AwsLightFile;
   protected getAcl(): string | undefined;

package/dist/storage/aws-light/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/AwsLightFile-BTLiRxXj.js";import{l as r}from"../../packem_shared/aws-light-meta-storage-TPyQwLvk.js";import{default as f}from"../../packem_shared/AwsLightStorage-CA9cdfJ6.js";export{a as AwsLightFile,r as AwsLightMetaStorage,f as AwsLightStorage};
+import{default as a}from"../../packem_shared/AwsLightFile-BSqjc_rD.js";import{l as r}from"../../packem_shared/aws-light-meta-storage-TPyQwLvk.js";import{default as f}from"../../packem_shared/AwsLightStorage-SH7j-myh.js";export{a as AwsLightFile,r as AwsLightMetaStorage,f as AwsLightStorage};