@visulima/storage 1.0.0-alpha.3 → 1.0.0-alpha.31

package/dist/packem_shared/index.d-DSZjPbvW.d.ts

@@ -0,0 +1,230 @@
+import { O as OperationOptions, B as BaseStorage } from "./storage.d-BoJgdi1n.js";
+/**
+* Web-standard and Node-native body types accepted by {@link Files.upload}.
+*/
+type FileBody = ArrayBuffer | ArrayBufferView | Blob | Buffer | NodeJS.ReadableStream | ReadableStream<Uint8Array> | string;
+interface UploadOptions {
+  contentType?: string;
+  metadata?: Record<string, unknown>;
+  /**
+  * Explicit byte length. Required for {@link NodeJS.ReadableStream} and Web `ReadableStream`
+  * inputs because their length is not derivable from the value itself; ignored otherwise.
+  */
+  size?: number;
+  storageClass?: string;
+}
+interface SignedReadUrlOptions {
+  expiresIn?: number;
+  responseContentDisposition?: string;
+  responseContentType?: string;
+}
+interface SignedUploadUrlOptions {
+  contentLength?: number;
+  contentType?: string;
+  expiresIn?: number;
+}
+interface ListOptions {
+  limit?: number;
+  prefix?: string;
+}
+/**
+* Provider-agnostic metadata-only view of an object.
+*/
+interface FileObject {
+  contentType: string;
+  etag?: string;
+  key: string;
+  lastModified?: Date | number | string;
+  metadata?: Record<string, unknown>;
+  size?: number;
+}
+interface DownloadResult extends FileObject {
+  body: Buffer;
+}
+interface FilesOptions<TStorage extends BaseStorage = BaseStorage> {
+  adapter: TStorage;
+  /**
+  * Default {@link OperationOptions} (`signal`, `timeout`, `retries`) merged into every call.
+  * Per-call overrides win. The `signal` is combined with any per-call `signal` via
+  * `AbortSignal.any`, so either one aborts the operation.
+  */
+  defaults?: OperationOptions;
+  /**
+  * Namespace every key under this prefix. Reads, writes, copies, listings, URLs, and signed
+  * uploads all resolve keys as `${prefix}/${key}`; returned keys (including from `list()`) have
+  * the prefix stripped back off. Leading/trailing slashes are normalized so `"/users/"` and
+  * `"users"` behave identically.
+  *
+  * `list()` scopes results on a path boundary, so `prefix: "users"` never matches the sibling
+  * `users-archive/`.
+  */
+  prefix?: string;
+}
+/**
+* One item in a bulk upload call.
+*/
+interface BulkUploadItem extends UploadOptions {
+  body: FileBody;
+  key: string;
+}
+/**
+* Per-call options shared by every bulk method (`upload`, `download`, `head`, `exists`, `delete`).
+*/
+interface BulkOptions extends OperationOptions {
+  /**
+  * Maximum number of in-flight operations.
+  * @default 8
+  */
+  concurrency?: number;
+  /**
+  * When `true`, stop dispatching new operations as soon as one fails. The already-issued
+  * operations still complete. Defaults to `false`: every key is attempted and per-key failures
+  * are collected in `errors`.
+  * @default false
+  */
+  stopOnError?: boolean;
+}
+interface BulkError {
+  error: Error;
+  key: string;
+}
+interface BulkUploadResult {
+  errors?: BulkError[];
+  uploaded: FileObject[];
+}
+interface BulkDownloadResult {
+  downloaded: DownloadResult[];
+  errors?: BulkError[];
+}
+interface BulkHeadResult {
+  errors?: BulkError[];
+  files: FileObject[];
+}
+interface BulkExistsResult {
+  errors?: BulkError[];
+  existing: string[];
+  missing: string[];
+}
+interface BulkDeleteResult {
+  deleted: string[];
+  errors?: BulkError[];
+}
+/**
+* Provider-agnostic facade over a {@link BaseStorage} instance.
+*
+* Provides a small, consistent surface (`upload`, `download`, `head`, `exists`, `delete`, `copy`,
+* `list`, `url`, `signedUploadUrl`) and a `raw` escape hatch to the adapter's native client.
+*
+* Each operation accepts per-call `signal`, `timeout`, and `retries` via {@link OperationOptions};
+* defaults set on the constructor are merged in (per-call wins). Single-key methods also accept an
+* array of keys (or {@link BulkUploadItem}s for `upload`) to run a bounded-concurrency batch and
+* return a structured `{ ..., errors? }` result instead of throwing on partial failure.
+*
+* When constructed with a `prefix`, every key is resolved relative to the prefix and the prefix is
+* stripped back off the keys returned in results — application code works in its own namespace.
+* @example
+* ```ts
+* import { Files, S3Storage } from "@visulima/storage";
+*
+* const files = new Files({
+*   adapter: new S3Storage({ bucket: "uploads", region: "us-east-1" }),
+*   prefix: "users",
+*   defaults: { timeout: 30_000 },
+* });
+*
+* await files.upload("123/avatar.png", buffer, { contentType: "image/png" });
+* const head = await files.head("123/avatar.png"); // reads users/123/avatar.png
+* const url = await files.url("123/avatar.png", { expiresIn: 900 });
+*
+* const { uploaded, errors } = await files.upload([
+*   { key: "a.png", body: a, contentType: "image/png" },
+*   { key: "b.png", body: b },
+* ], { concurrency: 4 });
+* ```
+*/
+declare class Files<TStorage extends BaseStorage = BaseStorage> {
+  readonly adapter: TStorage;
+  private readonly defaults;
+  private readonly prefix;
+  constructor(options: FilesOptions<TStorage>);
+  /**
+  * Escape hatch to the adapter's native client (S3Client, BlobServiceClient, ...).
+  * Typed via the `TStorage` parameter, so pinning the adapter type at construction yields a
+  * typed view of the native client. Returns `undefined` when the adapter has no native client
+  * (e.g. DiskStorage).
+  */
+  get raw(): TStorage["raw"];
+  /** Resolve a caller-supplied key into the underlying storage key. */
+  private resolveKey;
+  /**
+  * Strip the constructor prefix off a key returned by the adapter. Returns `null` when the key
+  * is outside the prefix or is the bare prefix itself (used to filter `list()` results on a path
+  * boundary and drop any synthetic directory entry the adapter may emit).
+  */
+  private stripPrefix;
+  private mergeOptions;
+  /**
+  * Upload a single object, or — when passed an array of {@link BulkUploadItem}s — bulk-upload
+  * many in one call with bounded concurrency.
+  */
+  upload(key: string, body: FileBody, options?: OperationOptions & UploadOptions): Promise<FileObject>;
+  upload(items: BulkUploadItem[], options?: BulkOptions): Promise<BulkUploadResult>;
+  private uploadOne;
+  private uploadMany;
+  /**
+  * Download a single object, or — when passed an array of keys — bulk-download many in one
+  * call with bounded concurrency.
+  */
+  download(key: string, options?: OperationOptions): Promise<DownloadResult>;
+  download(keys: string[], options?: BulkOptions): Promise<BulkDownloadResult>;
+  private downloadOne;
+  private downloadMany;
+  /**
+  * Fetch metadata for a single object, or — when passed an array of keys — bulk-head many in
+  * one call with bounded concurrency.
+  */
+  head(key: string, options?: OperationOptions): Promise<FileObject>;
+  head(keys: string[], options?: BulkOptions): Promise<BulkHeadResult>;
+  private headOne;
+  private headMany;
+  /**
+  * Resolves to `true`/`false` for a single key, or — when passed an array — splits the keys
+  * into `existing` and `missing` arrays. Hard errors (auth, transport) are reported in
+  * `errors`. Never throws for a missing object.
+  */
+  exists(key: string, options?: OperationOptions): Promise<boolean>;
+  exists(keys: string[], options?: BulkOptions): Promise<BulkExistsResult>;
+  private existsOne;
+  private existsMany;
+  /**
+  * Delete a single object (resolves to `void`, throws on failure), or — when passed an array
+  * of keys — delete many in one call. Adapters with a native bulk-delete primitive (S3's
+  * `DeleteObjects`, Supabase's `remove`, UploadThing's `deleteFiles`) use it via
+  * {@link BaseStorage.deleteBatch}; otherwise the keys are fanned out with bounded concurrency.
+  */
+  delete(key: string, options?: OperationOptions): Promise<void>;
+  delete(keys: string[], options?: BulkOptions): Promise<BulkDeleteResult>;
+  private deleteOne;
+  private deleteMany;
+  /**
+  * Copy `source` to `destination` (both resolved under any constructor prefix). Returns the
+  * destination object's metadata with the caller-facing (un-prefixed) key.
+  */
+  copy(source: string, destination: string, options?: OperationOptions & {
+    storageClass?: string;
+  }): Promise<FileObject>;
+  /**
+  * List objects in the bucket. Returned keys have any constructor prefix stripped off, and
+  * keys outside the prefix namespace (e.g. `users-archive/` when prefix is `users`) are filtered
+  * out. The optional `prefix` filter is interpreted *relative to the constructor prefix*.
+  *
+  * **Caveat with constructor prefix**: `limit` is applied by the underlying adapter *before*
+  * the path-boundary filter runs, so the returned array may contain fewer than `limit` items
+  * even when more in-namespace objects exist. Page through with adapter-specific APIs when you
+  * need an exact in-namespace count.
+  */
+  list(options?: ListOptions & OperationOptions): Promise<FileObject[]>;
+  url(key: string, options?: OperationOptions & SignedReadUrlOptions): Promise<string>;
+  signedUploadUrl(key: string, options?: OperationOptions & SignedUploadUrlOptions): Promise<string>;
+}
+export { BulkDeleteResult as B, DownloadResult as D, Files as F, ListOptions as L, SignedReadUrlOptions as S, UploadOptions as U, BulkDownloadResult as a, BulkError as b, BulkExistsResult as c, BulkHeadResult as d, BulkOptions as e, BulkUploadItem as f, BulkUploadResult as g, FileBody as h, FileObject as i, FilesOptions as j, SignedUploadUrlOptions as k };

package/dist/packem_shared/is-expired-1JuZjDtb.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var t=(e,r)=>a(e,"name",{value:r,configurable:!0});var i=Object.defineProperty,n=t((e,r)=>i(e,"name",{value:r,configurable:!0}),"t");const p=n(e=>e.expiredAt?Date.now()>+new Date(e.expiredAt):!1,"isExpired");export{p as o};

package/dist/packem_shared/isRetryableError-BhizNeAz.js

@@ -0,0 +1 @@
+var m=Object.defineProperty;var d=(e,t)=>m(e,"name",{value:t,configurable:!0});var b=Object.defineProperty,i=d((e,t)=>b(e,"name",{value:t,configurable:!0}),"u");const l={backoffMultiplier:2,calculateDelay:void 0,initialDelay:1e3,maxDelay:3e4,maxRetries:3,retryableStatusCodes:[408,429,500,502,503,504],shouldRetry:i(()=>!1,"shouldRetry")},p=i((e,t,r,o)=>{const a=Math.min(t*r**e,o);return Math.floor(Math.random()*a)},"calculateExponentialBackoff"),D=i(e=>new Promise(t=>{setTimeout(t,e)}),"sleep"),h=i((e,t=l.retryableStatusCodes)=>{if(e instanceof Error){const r=e.code,o=e.name;if(o==="AbortError"||r==="ABORT_ERR")return!1;if(r==="ECONNRESET"||r==="ETIMEDOUT"||r==="ENOTFOUND"||r==="ECONNREFUSED"||r==="EAI_AGAIN"||o==="NetworkError"||o==="TimeoutError")return!0;const a=e;if(a.$metadata){const u=a.$metadata.httpStatusCode;if(u&&t.includes(u)||a.$fault==="server")return!0}if(a.statusCode&&t.includes(a.statusCode))return!0;const{retryable:s}=a;return s===!0||typeof s=="string"&&s==="true"}return!1},"isRetryableError"),C=i(async(e,t={})=>{const{backoffMultiplier:r=l.backoffMultiplier,calculateDelay:o=l.calculateDelay,initialDelay:a=l.initialDelay,maxDelay:s=l.maxDelay,maxRetries:u=l.maxRetries,retryableStatusCodes:E=l.retryableStatusCodes,shouldRetry:R=l.shouldRetry}=t;let f;for(let n=0;n<=u;n+=1)try{return await e()}catch(c){if(f=c,n>=u)break;if(!(R(c)||h(c,E)))throw c;const y=o?o(n,c):p(n,a,r,s);y!==void 0&&y>0&&await D(y)}throw f},"retry"),N=i((e={})=>t=>C(t,e),"createRetryWrapper");export{N as createRetryWrapper,h as isRetryableError,C as retry};

package/dist/packem_shared/isValidMediaType-B-2UKjZx.js

@@ -0,0 +1 @@
+var p=Object.defineProperty;var r=(e,t)=>p(e,"name",{value:t,configurable:!0});import s from"mime";var m=Object.defineProperty,o=r((e,t)=>m(e,"name",{value:t,configurable:!0}),"i");const d=o((e,t)=>e?e.startsWith(`${t}/`):!1,"isValidMediaType"),l=o(e=>{if(e)return s.getExtension(e)||void 0},"getFormatFromContentType"),c=o((e,t,i)=>{const a=typeof e.size=="string"?Number.parseInt(e.size,10):e.size;if(i?.maxSize&&a>i.maxSize)throw new Error(`${t} size ${a} exceeds maximum allowed size ${i.maxSize}`);if(!d(e.contentType,t))throw new Error(`File is not ${t==="image"?"an":"a"} ${t}: ${e.contentType}`);const n=l(e.contentType);if(i?.supportedFormats&&n&&!i.supportedFormats.includes(n))throw new Error(`Unsupported ${t} format: ${n}`)},"validateMediaFile"),u=o(e=>e?!!s.getExtension(e):!1,"isKnownContentType");export{l as getFormatFromContentType,u as isKnownContentType,d as isValidMediaType,c as validateMediaFile};

package/dist/packem_shared/listFiles-B6VF05d-.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var n=(e,i)=>o(e,"name",{value:i,configurable:!0});import{toolDefinition as t}from"@tanstack/ai";import{T as l,e as p}from"./executors-DG6hGtvm.js";var d=Object.defineProperty,r=n((e,i)=>d(e,"name",{value:i,configurable:!0}),"i");const u=r(e=>t({description:l.listFiles.description,inputSchema:l.listFiles.input,name:"listFiles"}).server(i=>p.listFiles(e,i)),"listFiles"),m=r(e=>t({description:l.getFileMetadata.description,inputSchema:l.getFileMetadata.input,name:"getFileMetadata"}).server(i=>p.getFileMetadata(e,i)),"getFileMetadata"),g=r(e=>t({description:l.downloadFile.description,inputSchema:l.downloadFile.input,name:"downloadFile"}).server(i=>p.downloadFile(e,i)),"downloadFile"),v=r(e=>t({description:l.getFileUrl.description,inputSchema:l.getFileUrl.input,name:"getFileUrl"}).server(i=>p.getFileUrl(e,i)),"getFileUrl"),U=r((e,{needsApproval:i=!0}={})=>t({description:l.uploadFile.description,inputSchema:l.uploadFile.input,name:"uploadFile",needsApproval:i}).server(a=>p.uploadFile(e,a)),"uploadFile"),S=r((e,{needsApproval:i=!0}={})=>t({description:l.deleteFile.description,inputSchema:l.deleteFile.input,name:"deleteFile",needsApproval:i}).server(a=>p.deleteFile(e,a)),"deleteFile"),A=r((e,{needsApproval:i=!0}={})=>t({description:l.copyFile.description,inputSchema:l.copyFile.input,name:"copyFile",needsApproval:i}).server(a=>p.copyFile(e,a)),"copyFile"),h=r((e,{needsApproval:i=!0}={})=>t({description:l.signUploadUrl.description,inputSchema:l.signUploadUrl.input,name:"signUploadUrl",needsApproval:i}).server(a=>p.signUploadUrl(e,a)),"signUploadUrl");export{A as copyFile,S as deleteFile,g as downloadFile,m as getFileMetadata,v as getFileUrl,u as listFiles,h as signUploadUrl,U as uploadFile};

package/dist/packem_shared/listFiles-BtP6VnUp.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var n=(e,i)=>a(e,"name",{value:i,configurable:!0});import{tool as p}from"ai";import{T as t,e as o}from"./executors-DG6hGtvm.js";var r=Object.defineProperty,l=n((e,i)=>r(e,"name",{value:i,configurable:!0}),"i");const F=l(e=>p({description:t.listFiles.description,execute:l(i=>o.listFiles(e,i),"execute"),inputSchema:t.listFiles.input}),"listFiles"),x=l(e=>p({description:t.getFileMetadata.description,execute:l(i=>o.getFileMetadata(e,i),"execute"),inputSchema:t.getFileMetadata.input}),"getFileMetadata"),g=l(e=>p({description:t.downloadFile.description,execute:l(i=>o.downloadFile(e,i),"execute"),inputSchema:t.downloadFile.input}),"downloadFile"),U=l(e=>p({description:t.getFileUrl.description,execute:l(i=>o.getFileUrl(e,i),"execute"),inputSchema:t.getFileUrl.input}),"getFileUrl"),m=l((e,{needsApproval:i=!0}={})=>p({description:t.uploadFile.description,execute:l(d=>o.uploadFile(e,d),"execute"),inputSchema:t.uploadFile.input,needsApproval:i}),"uploadFile"),v=l((e,{needsApproval:i=!0}={})=>p({description:t.deleteFile.description,execute:l(d=>o.deleteFile(e,d),"execute"),inputSchema:t.deleteFile.input,needsApproval:i}),"deleteFile"),S=l((e,{needsApproval:i=!0}={})=>p({description:t.copyFile.description,execute:l(d=>o.copyFile(e,d),"execute"),inputSchema:t.copyFile.input,needsApproval:i}),"copyFile"),A=l((e,{needsApproval:i=!0}={})=>p({description:t.signUploadUrl.description,execute:l(d=>o.signUploadUrl(e,d),"execute"),inputSchema:t.signUploadUrl.input,needsApproval:i}),"signUploadUrl");export{S as copyFile,v as deleteFile,g as downloadFile,x as getFileMetadata,U as getFileUrl,F as listFiles,A as signUploadUrl,m as uploadFile};

package/dist/packem_shared/local-meta-storage-Bi0mK6gD.js

@@ -0,0 +1 @@
+var re=Object.defineProperty;var o=(e,t)=>re(e,"name",{value:t,configurable:!0});import{utimes as ae}from"node:fs/promises";import{tmpdir as oe}from"node:os";import{createRequire as m}from"node:module";import{A as T,M as _,J as ie,K as ne,L as R}from"./path-D7rMc9nq-B718mbm6.js";import{throwErrorCode as j,ERRORS as P}from"./ERRORS-CyOuSMLY.js";import se from"./MetaStorage-Y4m1dWgd.js";import{stringifyMetadata as ce,parseMetadata as ue}from"./Metadata-B6Ir0KO7.js";const E=0,le=4;var fe=Object.defineProperty,pe=o((e,t)=>fe(e,"name",{value:t,configurable:!0}),"t$6"),me=Object.defineProperty,de=pe((e,t)=>me(e,"name",{value:t,configurable:!0}),"t"),ge=Object.defineProperty,be=de((e,t)=>ge(e,"name",{value:t,configurable:!0}),"n");const $=be(e=>{if(!e||!(e instanceof URL)&&typeof e!="string")throw new TypeError("Path must be a non-empty string or URL.")},"assertValidFileOrDirectoryPath");var ve=Object.defineProperty,ye=o((e,t)=>ve(e,"name",{value:t,configurable:!0}),"i$8"),he=Object.defineProperty,$e=ye((e,t)=>he(e,"name",{value:t,configurable:!0}),"r"),we=Object.defineProperty,Oe=$e((e,t)=>we(e,"name",{value:t,configurable:!0}),"i");const S=Oe(e=>{if(e.isFile())return"file";if(e.isDirectory())return"dir";if(e.isSymbolicLink())return"symlink"},"getFileInfoType");var je=Object.defineProperty,Pe=o((e,t)=>je(e,"name",{value:t,configurable:!0}),"i$7"),xe=Object.defineProperty,q=Pe((e,t)=>xe(e,"name",{value:t,configurable:!0}),"s");const Ee=m(import.meta.url),d=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,Te=q(e=>{if(typeof d<"u"&&d.versions&&d.versions.node){const[t,r]=d.versions.node.split(".").map(Number);if(t>22||t===22&&r>=3||t===20&&r>=16)return d.getBuiltinModule(e)}return Ee(e)},"__cjs_getBuiltinModule"),{lstat:I,mkdir:_e}=Te("node:fs/promises");var Me=Object.defineProperty,ke=q((e,t)=>Me(e,"name",{value:t,configurable:!0}),"o");const Ne=ke(async e=>{$(e);try{const t=await I(e);if(!t.isDirectory())throw new Error(`Ensure path exists, expected 'dir', got '${String(S(t))}'`);return}catch(t){if(t.code!=="ENOENT")throw t}try{await _e(e,{recursive:!0})}catch(t){if(t.code!=="EEXIST")throw t;const r=await I(e);if(!r.isDirectory())throw new Error(`Ensure path exists, expected 'dir', got '${String(S(r))}'`,{cause:t})}},"ensureDir");var ze=Object.defineProperty,l=o((e,t)=>ze(e,"name",{value:t,configurable:!0}),"n$7"),Be=Object.defineProperty,s=l((e,t)=>Be(e,"name",{value:t,configurable:!0}),"a");const Fe=m(import.meta.url),g=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,Ae=s(e=>{if(typeof g<"u"&&g.versions&&g.versions.node){const[t,r]=g.versions.node.split(".").map(Number);if(t>22||t===22&&r>=3||t===20&&r>=16)return g.getBuiltinModule(e)}return Fe(e)},"__cjs_getBuiltinModule"),{fileURLToPath:De}=Ae("node:url");var Re=Object.defineProperty,p=s((e,t)=>Re(e,"name",{value:t,configurable:!0}),"t$1");function O(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}o(O,"m$4");l(O,"d");s(O,"getDefaultExportFromCjs");p(O,"getDefaultExportFromCjs");function M(e){return e&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}o(M,"h$1");l(M,"O");s(M,"getDefaultExportFromNamespaceIfPresent");p(M,"getDefaultExportFromNamespaceIfPresent");function k(e){return e&&Object.prototype.hasOwnProperty.call(e,"default")&&Object.keys(e).length===1?e.default:e}o(k,"x");l(k,"P");s(k,"getDefaultExportFromNamespaceIfNotNamed");p(k,"getDefaultExportFromNamespaceIfNotNamed");function N(e){if(Object.prototype.hasOwnProperty.call(e,"__esModule"))return e;var t=e.default;if(typeof t=="function"){var r=p(s(l(o(function a(){var i=!1;try{i=this instanceof a}catch{}return i?Reflect.construct(t,arguments,this.constructor):t.apply(this,arguments)},"a"),"s"),"a"),"a");r.prototype=t.prototype}else r={};return Object.defineProperty(r,"__esModule",{value:!0}),Object.keys(e).forEach(function(a){var i=Object.getOwnPropertyDescriptor(e,a);Object.defineProperty(r,a,i.get?i:{enumerable:!0,get:p(function(){return e[a]},"get")})}),r}o(N,"y$2");l(N,"_");s(N,"getAugmentedNamespace");p(N,"getAugmentedNamespace");var L,U;function z(){return U||(U=1,L=["3dm","3ds","3g2","3gp","7z","a","aac","adp","afdesign","afphoto","afpub","ai","aif","aiff","alz","ape","apk","appimage","ar","arj","asf","au","avi","bak","baml","bh","bin","bk","bmp","btif","bz2","bzip2","cab","caf","cgm","class","cmx","cpio","cr2","cr3","cur","dat","dcm","deb","dex","djvu","dll","dmg","dng","doc","docm","docx","dot","dotm","dra","DS_Store","dsk","dts","dtshd","dvb","dwg","dxf","ecelp4800","ecelp7470","ecelp9600","egg","eol","eot","epub","exe","f4v","fbs","fh","fla","flac","flatpak","fli","flv","fpx","fst","fvt","g3","gh","gif","graffle","gz","gzip","h261","h263","h264","icns","ico","ief","img","ipa","iso","jar","jpeg","jpg","jpgv","jpm","jxr","key","ktx","lha","lib","lvp","lz","lzh","lzma","lzo","m3u","m4a","m4v","mar","mdi","mht","mid","midi","mj2","mka","mkv","mmr","mng","mobi","mov","movie","mp3","mp4","mp4a","mpeg","mpg","mpga","mxu","nef","npx","numbers","nupkg","o","odp","ods","odt","oga","ogg","ogv","otf","ott","pages","pbm","pcx","pdb","pdf","pea","pgm","pic","png","pnm","pot","potm","potx","ppa","ppam","ppm","pps","ppsm","ppsx","ppt","pptm","pptx","psd","pya","pyc","pyo","pyv","qt","rar","ras","raw","resources","rgb","rip","rlc","rmf","rmvb","rpm","rtf","rz","s3m","s7z","scpt","sgi","shar","snap","sil","sketch","slk","smv","snk","so","stl","suo","sub","swf","tar","tbz","tbz2","tga","tgz","thmx","tif","tiff","tlz","ttc","ttf","txz","udf","uvh","uvi","uvm","uvp","uvs","uvu","viv","vob","war","wav","wax","wbmp","wdp","weba","webm","webp","whl","wim","wm","wma","wmv","wmx","woff","woff2","wrm","wvx","xbm","xif","xla","xlam","xls","xlsb","xlsm","xlsx","xlt","xltm","xltx","xm","xmind","xpi","xpm","xwd","xz","z","zip","zipx"]),L}o(z,"w$2");l(z,"k");s(z,"requireBinaryExtensions");var Se=z();const Ie=O(Se);var Le=Object.defineProperty,n=s((e,t)=>Le(e,"name",{value:t,configurable:!0}),"r");const Ue=new Set(Ie),Ce=new Set(["/","\\",void 0]),C=Symbol.for("pathe:normalizedAlias"),We=/(^|[/\\])([^/\\]+?)(?=(?:\.[^.]+)?$)/,qe=n((e,t)=>t.split("/").length-e.split("/").length,"compareAliases"),w=n((e="/")=>{const t=e.at(-1);return t==="/"||t==="\\"},"hasTrailingSlash"),V=n(e=>{if(e[C])return e;const t=Object.fromEntries(Object.entries(e).toSorted(([r],[a])=>qe(r,a)));for(const r in t)for(const a in t)a===r||r.startsWith(a)||t[r].startsWith(a)&&Ce.has(t[r][a.length])&&(t[r]=t[a]+t[r].slice(a.length));return Object.defineProperty(t,C,{enumerable:!1,value:!0}),t},"normalizeAliases");n((e,t)=>{e=T(e),t=V(t);for(const[r,a]of Object.entries(t)){if(!e.startsWith(r))continue;const i=w(r)?r.slice(0,-1):r;if(w(e[i.length]))return _(a,e.slice(r.length))}return e},"resolveAlias");n(e=>We.exec(e)?.[2],"filename");n((e,t)=>{e=T(e),t=V(t);for(const[r,a]of Object.entries(t).toReversed()){if(!e.startsWith(a))continue;const i=w(a)?a.slice(0,-1):a;if(w(e[i.length]))return _(r,e.slice(a.length))}return e},"reverseResolveAlias");const Ve=/^(?:\.?\.[/\\]|\.\.\B)/,Je=/^(?:msys|cygwin)$/;n(e=>Ve.test(e)||e==="..","isRelative");n(e=>Ue.has(ie(e).slice(1).toLowerCase()),"isBinaryPath");const B=n(e=>T(e instanceof URL?De(e):e),"toPath");n(()=>{if(!globalThis.process)return!1;if(globalThis.process.platform==="win32"||globalThis.process.platform==="cygwin")return!0;const e=globalThis.process.env.OSTYPE;return typeof e!="string"?!1:Je.test(e)},"isWindows");var Ke=Object.defineProperty,J=o((e,t)=>Ke(e,"name",{value:t,configurable:!0}),"t$4"),Xe=Object.defineProperty,F=J((e,t)=>Xe(e,"name",{value:t,configurable:!0}),"s");const Ye=m(import.meta.url),b=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,Ge=F(e=>{if(typeof b<"u"&&b.versions&&b.versions.node){const[t,r]=b.versions.node.split(".").map(Number);if(t>22||t===22&&r>=3||t===20&&r>=16)return b.getBuiltinModule(e)}return Ye(e)},"__cjs_getBuiltinModule"),{access:He}=Ge("node:fs/promises");var Qe=Object.defineProperty,Ze=F((e,t)=>Qe(e,"name",{value:t,configurable:!0}),"o");async function u(e,t=E){$(e),e=B(e);try{return await He(e,t),!0}catch{return!1}}o(u,"i$5");J(u,"d");F(u,"m");Ze(u,"isAccessible");var et=Object.defineProperty,K=o((e,t)=>et(e,"name",{value:t,configurable:!0}),"t$3"),tt=Object.defineProperty,X=K((e,t)=>tt(e,"name",{value:t,configurable:!0}),"t"),rt=Object.defineProperty,at=X((e,t)=>rt(e,"name",{value:t,configurable:!0}),"o");let ot=class extends Error{static{o(this,"c")}static{K(this,"i")}static{X(this,"n")}static{at(this,"PermissionError")}constructor(t){super(`EPERM: Operation not permitted, ${t}`)}get code(){return"EPERM"}set code(t){throw new Error("Cannot overwrite code EPERM")}get name(){return"PermissionError"}set name(t){throw new Error("Cannot overwrite name of PermissionError")}};var it=Object.defineProperty,nt=o((e,t)=>it(e,"name",{value:t,configurable:!0}),"f$4"),st=Object.defineProperty,Y=nt((e,t)=>st(e,"name",{value:t,configurable:!0}),"i");const ct=m(import.meta.url),v=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,G=Y(e=>{if(typeof v<"u"&&v.versions&&v.versions.node){const[t,r]=v.versions.node.split(".").map(Number);if(t>22||t===22&&r>=3||t===20&&r>=16)return v.getBuiltinModule(e)}return ct(e)},"__cjs_getBuiltinModule"),{readFile:ut}=G("node:fs/promises"),{unzip:lt,brotliDecompress:ft}=G("node:zlib");var pt=Object.defineProperty,H=Y((e,t)=>pt(e,"name",{value:t,configurable:!0}),"n");const mt={brotli:ft,gzip:lt,none:H((e,t)=>{t(null,e)},"none")},dt=H(async(e,t)=>{if($(e),e=B(e),!await u(e))throw new ot(`unable to read the non-accessible file: ${e}`);if(!await u(e,le))throw new Error(`Unable to read the non-readable file: ${e}`);const{buffer:r,compression:a,encoding:i,flag:c}=t??{};return await ut(e,c?{encoding:i,flag:c}:{encoding:i}).then(async f=>await new Promise((ee,te)=>{mt[a??"none"](f,(A,D)=>{A?te(A):ee(r?D:D.toString())})})).catch(f=>{throw f})},"readFile");var gt=Object.defineProperty,bt=o((e,t)=>gt(e,"name",{value:t,configurable:!0}),"a$4"),vt=Object.defineProperty,yt=bt((e,t)=>vt(e,"name",{value:t,configurable:!0}),"t"),ht=Object.defineProperty,$t=yt((e,t)=>ht(e,"name",{value:t,configurable:!0}),"t");const wt=$t(e=>{const t={force:!0,recursive:!0};return e?.maxRetries!==void 0&&(t.maxRetries=e.maxRetries),e?.retryDelay!==void 0&&(t.retryDelay=e.retryDelay),t},"buildRmOptions");var Ot=Object.defineProperty,jt=o((e,t)=>Ot(e,"name",{value:t,configurable:!0}),"i$2"),Pt=Object.defineProperty,Q=jt((e,t)=>Pt(e,"name",{value:t,configurable:!0}),"s");const xt=m(import.meta.url),y=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,Et=Q(e=>{if(typeof y<"u"&&y.versions&&y.versions.node){const[t,r]=y.versions.node.split(".").map(Number);if(t>22||t===22&&r>=3||t===20&&r>=16)return y.getBuiltinModule(e)}return xt(e)},"__cjs_getBuiltinModule"),{unlink:Tt,rm:_t}=Et("node:fs/promises");var Mt=Object.defineProperty,kt=Q((e,t)=>Mt(e,"name",{value:t,configurable:!0}),"i");const Nt=kt(async(e,t={})=>{$(e);try{await Tt(e)}catch{}try{await _t(e,wt(t))}catch{}},"remove");var zt=Object.defineProperty,Bt=o((e,t)=>zt(e,"name",{value:t,configurable:!0}),"a$2"),Ft=Object.defineProperty,At=Bt((e,t)=>Ft(e,"name",{value:t,configurable:!0}),"t"),Dt=Object.defineProperty,Rt=At((e,t)=>Dt(e,"name",{value:t,configurable:!0}),"e");const St=Rt(e=>{if(typeof e!="string"&&!(e instanceof ArrayBuffer)&&!ArrayBuffer.isView(e))throw new TypeError("File contents must be a string, ArrayBuffer, or ArrayBuffer view.")},"assertValidFileContents");var It=Object.defineProperty,Lt=o((e,t)=>It(e,"name",{value:t,configurable:!0}),"t"),Ut=Object.defineProperty,Ct=Lt((e,t)=>Ut(e,"name",{value:t,configurable:!0}),"r"),Wt=Object.defineProperty,qt=Ct((e,t)=>Wt(e,"name",{value:t,configurable:!0}),"f");const Vt=new TextEncoder,Jt=qt(e=>{if(e instanceof Uint8Array)return e;if(typeof e=="string")return Vt.encode(e);if(e instanceof ArrayBuffer)return new Uint8Array(e);if(ArrayBuffer.isView(e)){const t=e.buffer.slice(e.byteOffset,e.byteOffset+e.byteLength);return new Uint8Array(t)}throw new TypeError("Invalid contents type. Expected string or ArrayBuffer.")},"toUint8Array");var Kt=Object.defineProperty,Xt=o((e,t)=>Kt(e,"name",{value:t,configurable:!0}),"m"),Yt=Object.defineProperty,Z=Xt((e,t)=>Yt(e,"name",{value:t,configurable:!0}),"s");const Gt=m(import.meta.url),h=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,Ht=Z(e=>{if(typeof h<"u"&&h.versions&&h.versions.node){const[t,r]=h.versions.node.split(".").map(Number);if(t>22||t===22&&r>=3||t===20&&r>=16)return h.getBuiltinModule(e)}return Gt(e)},"__cjs_getBuiltinModule"),{mkdir:Qt,writeFile:Zt,stat:er,rename:W,chown:tr,chmod:rr,unlink:ar}=Ht("node:fs/promises");var or=Object.defineProperty,ir=Z((e,t)=>or(e,"name",{value:t,configurable:!0}),"d");const nr=ir(async(e,t,r)=>{r={encoding:"utf8",flag:"w",overwrite:!0,recursive:!0,...r},$(e),St(t),e=B(e);const a=`${e}.tmp`;try{const i=await u(e,E);if(!i&&r.recursive){const f=ne(e);await u(f,E)||await Qt(f,{recursive:!0})}let c;if(await Zt(a,Jt(t),{encoding:r.encoding,flag:r.flag}),i&&!r.overwrite&&(c=await er(e),r.chown??={gid:c.gid,uid:c.uid},await W(e,`${e}.bak`)),r.chown)try{await tr(a,r.chown.uid,r.chown.gid)}catch{}await rr(a,c&&!r.mode?c.mode:r.mode??438),await W(a,e)}catch(i){throw new Error(`Failed to write file at: ${e} - ${i.message}`,{cause:i})}finally{await u(a)&&await ar(`${e}.tmp`)}},"writeFile");var sr=Object.defineProperty,x=o((e,t)=>sr(e,"name",{value:t,configurable:!0}),"a");let vr=class extends se{static{o(this,"v")}static{x(this,"LocalMetaStorage")}directory;constructor(t){super(t),this.directory=R(t?.directory||_(oe(),"Upload_meta")),this.accessCheck().catch(r=>{this.logger?.error("Metadata storage access check failed: %O",r)})}getMetaPath=x(t=>{const r=R(`${this.directory}/${this.prefix}${t}${this.suffix}`),a=this.directory.endsWith("/")?this.directory:`${this.directory}/`;return r.startsWith(a)?r:j(P.INVALID_FILE_NAME,`Invalid id: "${t}" resolves outside the meta directory`)},"getMetaPath");getIdFromPath=x(t=>t.slice(`${this.directory}/${this.prefix}`.length,-this.suffix.length),"getIdFromPath");async save(t,r){await this.accessCheck();const a={...r};return a.metadata&&(a.metadata=ce(r.metadata)),await nr(this.getMetaPath(t),JSON.stringify(a),{recursive:!0}),r}async touch(t,r){const a=new Date;return await ae(this.getMetaPath(t),a,a),r}async get(t){try{const r=await dt(this.getMetaPath(t));if(r===void 0)throw j(P.FILE_NOT_FOUND);const a=JSON.parse(r);return a.metadata&&typeof a.metadata=="string"&&(a.metadata=ue(a.metadata)),a}catch(r){const a=r,i=r instanceof SyntaxError;throw a.code==="ENOENT"||i?j(P.FILE_NOT_FOUND):r}}async delete(t){await Nt(this.getMetaPath(t))}async accessCheck(){await Ne(this.directory)}};export{dt as B,B as U,E as _,$ as f,u as i,S as l,vr as v,Ne as w,Nt as y};

package/dist/packem_shared/local-meta-storage.d-qZQI1JUe.d.ts

@@ -0,0 +1,21 @@
+import { F as File, L as LocalMetaStorageOptions, M as MetaStorage } from "./storage.d-BoJgdi1n.js";
+import 'node:stream';
+/**
+* Stores upload metafiles on local disk
+*/
+declare class LocalMetaStorage<T extends File = File> extends MetaStorage<T> {
+  readonly directory: string;
+  constructor(config?: LocalMetaStorageOptions);
+  /**
+  * Returns metafile path.
+  * @param id upload id
+  * @throws {UploadError} If the id resolves to a path outside the meta directory (e.g. via `..` traversal or absolute paths).
+  */
+  getMetaPath: (id: string) => string;
+  override save(id: string, file: T): Promise<T>;
+  override touch(id: string, file: T): Promise<T>;
+  override get(id: string): Promise<T>;
+  override delete(id: string): Promise<void>;
+  private accessCheck;
+}
+export { LocalMetaStorage as L };

package/dist/packem_shared/media-transformer.d-lQ_RUjb5.d.ts

@@ -0,0 +1,331 @@
+import { F as File, a as FileReturn, B as BaseStorage } from "./storage.d-BoJgdi1n.js";
+import { O as MediaTransformerConfig, Q as MediaTransformResult } from "./types.d-DCPQvHDI.js";
+/**
+* Unified media transformer that automatically detects media type and routes to appropriate transformer.
+* @template TFile The file type used by this transformer.
+* @template TFileReturn The return type for file retrieval operations.
+*
+* Supports transformations via query parameters for on-demand media processing across all supported formats.
+* @example
+* // eslint-disable-next-line jsdoc/match-description
+* ```ts
+* const transformer = new MediaTransformer(storage, {
+*   maxImageSize: 10 * 1024 * 1024, // 10MB
+*   maxVideoSize: 100 * 1024 * 1024, // 100MB
+*   maxAudioSize: 50 * 1024 * 1024, // 50MB
+*   cache: new MapCache(), // In-memory caching
+*   saveTransformedFiles: true // Persist transformed files to storage
+* });
+*
+* // Handle transformation via query parameters
+* const result = await transformer.handle('file-id', {
+*   width: 800,
+*   height: 600,
+*   fit: 'cover',
+*   format: 'webp',
+*   quality: 80
+* });
+*
+* // Fetch with URL query string
+* const result = await transformer.fetch('file-id', 'width=1280&height=720&codec=avc&bitrate=2000000');
+*
+* // Clear all cached transformed files
+* transformer.clearSavedTransformedFiles();
+* ```
+*
+* ## Configuration Options
+*
+* - `saveTransformedFiles`: Persist transformed files to storage for reuse (default: false)
+* - `cache`: Cache instance for in-memory caching (optional)
+* - `maxImageSize/maxVideoSize/maxAudioSize`: Size limits for processing
+* - `cacheTtl`: Cache time-to-live in seconds
+*
+* ## Supported Query Parameters
+*
+* ### Common Parameters
+* - `format`: Output format (jpeg/png/webp/avif/mp4/webm/mkv/mp3/wav/ogg/aac/flac)
+* - `quality`: Quality for images (0-100), bitrate for video/audio
+*
+* ### Image Parameters
+* - `width`: Width in pixels
+* - `height`: Height in pixels
+* - `fit`: Resize fit mode - cover/contain/fill/inside/outside
+* - `position`: Position for cover/contain fits
+* - `withoutEnlargement`: Avoid enlarging smaller images (boolean)
+* - `withoutReduction`: Avoid reducing larger images (boolean)
+* - `kernel`: Resize kernel - nearest/cubic/mitchell/lanczos2/lanczos3
+* - `fastShrinkOnLoad`: Fast shrink on load (boolean)
+* - `left/top/cropWidth/cropHeight`: Crop parameters
+* - `angle`: Rotation angle in degrees (any number, but angles other than 90°/180°/270° use interpolation and may affect quality)
+* - `background`: Background color for rotation
+* - `blur`: Apply blur effect (boolean)
+* - `sharpen`: Apply sharpening (boolean)
+* - `median`: Apply median filter with size (number)
+* // eslint-disable-next-line jsdoc/match-description
+* - `clahe`: Apply CLAHE (Contrast Limited Adaptive Histogram Equalization) (boolean)
+* - `threshold`: Apply thresholding with value (0-255)
+* - `gamma`: Apply gamma correction (boolean)
+* - `negate`: Negate (invert) the image (boolean)
+* - `normalise/normalize`: Normalise the image (boolean)
+* - `flatten`: Flatten alpha channel (boolean)
+* - `unflatten`: Unflatten alpha channel (boolean)
+* - `flip`: Flip image vertically (boolean)
+* - `flop`: Flop image horizontally (boolean)
+* - `greyscale/grayscale`: Convert to greyscale (boolean)
+* - `modulate`: Apply modulation effects (boolean)
+* - `brightness`: Brightness multiplier for modulation (number)
+* - `saturation`: Saturation multiplier for modulation (number)
+* - `hue`: Hue rotation in degrees for modulation (number)
+* // eslint-disable-next-line jsdoc/match-description
+* - `lightness`: Lightness adjustment for modulation (number)
+* - `tint`: Apply tinting (boolean)
+* - `colourspace`: Convert colourspace - srgb/rgb/cmyk/lab/b-w
+*
+* ### Video Parameters
+* - `width/height/fit`: Same as images
+* - `codec`: Video codec - avc/hevc/vp8/vp9/av1
+* - `bitrate`: Video bitrate in bits per second
+* - `frameRate`: Frame rate in Hz
+* - `keyFrameInterval`: Key frame interval in seconds
+* - `angle`: Rotation angle in degrees (any number, but angles other than 90°/180°/270° use interpolation and may affect quality)
+* - `background`: Background color for rotation
+*
+* ### Audio Parameters
+* - `sampleRate`: Sample rate in Hz
+* - `numberOfChannels`: Number of channels
+* - `codec`: Audio codec - aac/opus/mp3/vorbis/flac
+* - `bitrate`: Audio bitrate in bits per second
+*
+* ## File Persistence
+*
+* When `saveTransformedFiles` is enabled, transformed files are automatically saved to storage
+* with deterministic IDs based on the original file and transformation parameters. Subsequent
+* requests for the same transformation will serve the cached file directly, improving performance
+* and reducing processing costs.
+*/
+declare class MediaTransformer<TFile extends File = File, TFileReturn extends FileReturn = FileReturn> {
+  private readonly storage;
+  private readonly imageTransformer?;
+  private readonly videoTransformer?;
+  private readonly audioTransformer?;
+  private readonly config;
+  private readonly logger;
+  /**
+  * Creates a new MediaTransformer instance.
+  * @param storage The storage backend for retrieving and storing media files.
+  * @param config Configuration options for the media transformer including transformer classes and settings.
+  * @throws Error if no transformer classes are provided in the configuration.
+  */
+  constructor(storage: BaseStorage<TFile, TFileReturn>, config?: MediaTransformerConfig<TFile, TFileReturn>);
+  supportedFormats(): string[];
+  /**
+  * Handles media transformation based on query parameters.
+  * @param fileId File identifier.
+  * @param query Query parameters for transformation.
+  * @returns Unified transformation result.
+  */
+  handle(fileId: string, query: Record<string, string | undefined> | URLSearchParams | string): Promise<MediaTransformResult>;
+  /**
+  * Fetches media transformation with URL query string support.
+  * @param fileId File identifier.
+  * @param queryString URL query string (e.g., "width=800&amp;height=600&amp;format=webp").
+  * @returns Unified transformation result.
+  */
+  fetch(fileId: string, queryString: string): Promise<MediaTransformResult>;
+  /**
+  * Clears cache for a specific file across all transformers.
+  * @param fileId Optional file identifier to clear cache for. If omitted, clears all cache.
+  */
+  clearCache(fileId?: string): void;
+  /**
+  * Clears all saved transformed files from storage.
+  * @remarks This is a maintenance operation and may take time for large numbers of files.
+  */
+  clearSavedTransformedFiles(): Promise<void>;
+  /**
+  * Clears saved transformed files for a specific original file.
+  * @param originalFileId Original file identifier to clear transformed files for.
+  */
+  clearSavedTransformedFilesForFile(originalFileId: string): Promise<void>;
+  /**
+  * Gets cache statistics (combined from all transformers).
+  * @returns Cache statistics for audio, image, and video transformers.
+  */
+  getCacheStats(): {
+    audio?: {
+      maxSize: number;
+      size: number;
+    };
+    image?: {
+      maxSize: number;
+      size: number;
+    };
+    video?: {
+      maxSize: number;
+      size: number;
+    };
+  };
+  /**
+  * Validates query parameters for the given media type.
+  * @param query The query parameters to validate.
+  * @param mediaType The media type being validated ('image', 'video', or 'audio').
+  * @throws {ValidationError} When invalid parameters are provided.
+  */
+  private validateQueryParameters;
+  /**
+  * Validates query parameters for image transformations. Checks for invalid video/audio-only parameters, invalid fit values, invalid rotation angles, invalid formats, and incomplete crop parameter sets.
+  * @param query Query parameters to validate.
+  * @throws {ValidationError} When validation fails.
+  */
+  private validateImageQueryParameters;
+  /**
+  * Validates query parameters for video transformations. Checks for invalid audio-only parameters, invalid fit values, invalid rotation angles, invalid codecs, invalid formats, incomplete crop parameter sets, and invalid numeric values.
+  * @param query Query parameters to validate.
+  * @throws {ValidationError} When validation fails.
+  */
+  private validateVideoQueryParameters;
+  /**
+  * Generates a unique ID for transformed files based on original file and transformations.
+  * @param originalFileId The original file identifier.
+  * @param query The transformation query parameters.
+  * @param mediaType The media type (image, video, audio).
+  * @returns Unique deterministic identifier for the transformed file.
+  * @private
+  */
+  private generateTransformedFileId;
+  /**
+  * Checks if the query contains any transformations.
+  * @param query The transformation query parameters.
+  * @returns True if any transformations are requested.
+  * @private
+  */
+  private hasTransformations;
+  /**
+  * Creates a MediaTransformResult from a stored transformed file.
+  * @param storedFile The stored transformed file.
+  * @param mediaType The media type (image, video, audio).
+  * @param originalFile The original file information.
+  * @returns Media transformation result with metadata.
+  * @private
+  */
+  private createMediaTransformResult;
+  /**
+  * Extracts format from content type.
+  * @param contentType MIME content type string.
+  * @returns Format string extracted from content type.
+  * @private
+  */
+  private getFormatFromContentType;
+  /**
+  * Saves transformed file to storage.
+  * @param result The transformation result to save.
+  * @param originalFileId The original file identifier.
+  * @param query The transformation query parameters.
+  * @param mediaType The media type (image, video, audio).
+  * @returns Promise that resolves when file is saved.
+  * @private
+  */
+  private saveTransformedFile;
+  /**
+  * Validates query parameters for audio transformations. Checks for invalid video-only parameters, invalid codecs, invalid formats, and invalid numeric values.
+  * @param query Query parameters to validate.
+  * @throws {ValidationError} When validation fails.
+  */
+  private validateAudioQueryParameters;
+  /**
+  * Handles image transformation.
+  * @param fileId The file identifier.
+  * @param query The transformation query parameters.
+  * @returns Promise resolving to media transformation result.
+  * @private
+  */
+  private handleImageTransformation;
+  /**
+  * Handles video transformation.
+  * @param fileId The file identifier.
+  * @param query The transformation query parameters.
+  * @returns Promise resolving to media transformation result.
+  * @private
+  */
+  private handleVideoTransformation;
+  /**
+  * Handles audio transformation.
+  * @param fileId The file identifier.
+  * @param query The transformation query parameters.
+  * @returns Promise resolving to media transformation result.
+  * @private
+  */
+  private handleAudioTransformation;
+  /**
+  * Parses query parameters from various input formats.
+  * @param query Query parameters in various formats.
+  * @returns Normalized MediaTransformQuery object.
+  * @private
+  */
+  private parseQuery;
+  /**
+  * Parses boolean parameter from string.
+  * @param value String value to parse.
+  * @returns Boolean value or undefined.
+  * @private
+  */
+  private parseBooleanParameter;
+  /**
+  * Parses URLSearchParams into MediaTransformQuery.
+  * @param parameters URL search parameters object.
+  * @returns MediaTransformQuery object with parsed parameters.
+  * @private
+  */
+  private parseURLSearchParams;
+  /**
+  * Detects media type from MIME type.
+  * @param contentType MIME content type string.
+  * @returns Detected media type.
+  * @throws Error if content type is missing or unsupported.
+  * @private
+  */
+  private detectMediaType;
+  /**
+  * Checks if query has image transformations.
+  * @param query The transformation query parameters.
+  * @returns True if image transformations are requested.
+  * @private
+  */
+  private hasImageTransformations;
+  /**
+  * Checks if query has video transformations.
+  * @param query The transformation query parameters.
+  * @returns True if video transformations are requested.
+  * @private
+  */
+  private hasVideoTransformations;
+  /**
+  * Checks if query has audio transformations.
+  * @param query The transformation query parameters.
+  * @returns True if audio transformations are requested.
+  * @private
+  */
+  private hasAudioTransformations;
+  /**
+  * Converts ImageTransformer result to unified format.
+  * @param result The image transformation result.
+  * @returns Unified media transformation result.
+  * @private
+  */
+  private convertImageResult;
+  /**
+  * Converts VideoTransformer result to unified format.
+  * @param result The video transformation result.
+  * @returns Unified media transformation result.
+  * @private
+  */
+  private convertVideoResult;
+  /**
+  * Converts AudioTransformer result to unified format.
+  * @param result The audio transformation result.
+  * @returns Unified media transformation result.
+  * @private
+  */
+  private convertAudioResult;
+}
+export { MediaTransformer as M };

package/dist/packem_shared/minio-T_Z3iEy7.js

@@ -0,0 +1 @@
+var E=Object.defineProperty;var o=(e,s)=>E(e,"name",{value:s,configurable:!0});var t=Object.defineProperty,I=o((e,s)=>t(e,"name",{value:s,configurable:!0}),"t");const S=I(e=>{const s=e?.accessKeyId??process.env.AWS_ACCESS_KEY_ID??process.env.MINIO_ACCESS_KEY_ID??process.env.MINIO_ACCESS_KEY,r=e?.endpoint??process.env.AWS_ENDPOINT??process.env.MINIO_ENDPOINT,n=e?.region??process.env.AWS_REGION??process.env.MINIO_REGION,c=e?.secretAccessKey??process.env.AWS_SECRET_ACCESS_KEY??process.env.MINIO_SECRET_ACCESS_KEY??process.env.MINIO_SECRET_KEY;if(!n||!s||!c||!r)throw new Error("Missing required parameters for Minio client.");return{credentials:{accessKeyId:s,secretAccessKey:c},endpoint:r,forcePathStyle:!0,region:n}},"minio");export{S as default};

package/dist/packem_shared/multipart-base-BxckfvQf.js

@@ -0,0 +1 @@
+var h=Object.defineProperty;var d=(s,t)=>h(s,"name",{value:t,configurable:!0});import{n as p}from"./headers-DC2MEOrK.js";var g=Object.defineProperty,b=d((s,t)=>g(s,"name",{value:t,configurable:!0}),"d");class y{static{d(this,"F")}static{b(this,"MultipartBase")}async handlePost(t,i,l){const r={contentType:t.mediaType||"application/octet-stream",metadata:{},originalName:t.filename,size:t.size};for(const e of i)if(!e.isFile&&e.name){let n={};if(e.name==="metadata"&&e.text)try{n=JSON.parse(e.text)}catch{}else e.name&&(n={[e.name]:e.text});Object.assign(r.metadata,n)}const m=await this.storage.create(r),c=this.createStreamFromBytes(t.bytes),o=await this.storage.write({body:c,contentLength:t.size,id:m.id,start:0});let a=o;if(Object.keys(r.metadata).length>0){const e={...o.metadata,...r.metadata};a={...await this.storage.update({id:o.id},{metadata:e}),status:o.status}}const u=this.buildFileUrl(l,a);return{...a,headers:{Location:u,...a.expiredAt===void 0?{}:{"X-Upload-Expires":a.expiredAt.toString()},...a.ETag===void 0?{}:{ETag:a.ETag}},statusCode:200}}async handleDelete(t){const i=await this.storage.delete({id:t});if(i.status===void 0)throw p(404,"File not found");return{...i,headers:{},statusCode:204}}get storage(){throw new Error("storage must be implemented")}buildFileUrl(t,i){throw new Error("buildFileUrl must be implemented")}}export{y as F};