@visulima/storage 1.0.0-alpha.2 → 1.0.0-alpha.20

package/dist/transformer/video-transformer.js

@@ -1,310 +1 @@
-import { Input, BufferSource, ALL_FORMATS, Output, BufferTarget, Conversion, Mp4OutputFormat, WebMOutputFormat, OggOutputFormat, MkvOutputFormat } from 'mediabunny';
-import BaseTransformer from '../packem_shared/BaseTransformer-C2gLib6v.js';
-import { isValidMediaType, getFormatFromContentType } from '../packem_shared/isValidMediaType-BeDgiObq.js';
-
-class VideoTransformer extends BaseTransformer {
-  /**
-   * Creates a new VideoTransformer instance.
-   * @param storage The storage backend for retrieving and storing video files.
-   * @param config Configuration options for video transformation including cache settings, codec defaults, and size limits.
-   */
-  constructor(storage, config = {}) {
-    const logger = config.logger || storage.logger;
-    const transformerConfig = {
-      cacheTtl: 3600,
-      // 1 hour
-      defaultBitrate: 2e6,
-      // 2 Mbps
-      defaultCodec: "avc",
-      // No cache provided - no caching
-      maxCacheSize: 50,
-      // Max 50 transformed videos in cache
-      maxVideoSize: 500 * 1024 * 1024,
-      // 500MB
-      supportedFormats: ["mp4", "webm", "mkv", "avi", "mov", "flv", "wmv"],
-      ...config
-    };
-    super(storage, transformerConfig, logger);
-  }
-  /**
-   * Resizes a video to specified dimensions with optional fit mode.
-   * @param fileId Unique identifier of the video file to resize.
-   * @param options Resize options including width, height, and fit mode.
-   * @returns Promise resolving to transformed video result.
-   */
-  async resize(fileId, options) {
-    return this.transform(fileId, [{ options, type: "resize" }]);
-  }
-  /**
-   * Crops a video to the specified region.
-   * @param fileId Unique identifier of the video file to crop.
-   * @param options Crop options including region coordinates.
-   * @returns Promise resolving to transformed video result.
-   */
-  async crop(fileId, options) {
-    return this.transform(fileId, [{ options, type: "crop" }]);
-  }
-  /**
-   * Rotates a video by the specified angle.
-   * @param fileId Unique identifier of the video file to rotate.
-   * @param options Rotation configuration with angle in degrees and optional background color.
-   * @returns Promise resolving to transformed video result.
-   */
-  async rotate(fileId, options) {
-    return this.transform(fileId, [{ options, type: "rotate" }]);
-  }
-  /**
-   * Converts video format or codec.
-   * @param fileId Unique identifier of the video file to convert.
-   * @param format Target video format (e.g., "mp4", "webm", "mkv").
-   * @param options Video transformation options including quality, bitrate, and codec settings.
-   * @returns Promise resolving to transformed video result with updated format metadata.
-   */
-  async convertFormat(fileId, format, options = {}) {
-    return this.transform(fileId, [{ options: { ...options, format }, type: "format" }]);
-  }
-  /**
-   * Transcodes video to different codec.
-   * @param fileId Unique identifier of the video file to transcode.
-   * @param codec Target video codec (e.g., "avc", "hevc", "vp9").
-   * @param options Additional transform options.
-   * @returns Promise resolving to transformed video result.
-   */
-  async transcode(fileId, codec, options = {}) {
-    return this.transform(fileId, [{ options: { ...options, codec }, type: "codec" }]);
-  }
-  /**
-   * Applies a custom transformation pipeline to a video.
-   * @param fileId Unique identifier of the video file to transform.
-   * @param steps Array of transformation steps to apply in sequence.
-   * @returns Promise resolving to transformed video result.
-   */
-  async transform(fileId, steps) {
-    const fileQuery = { id: fileId };
-    const cacheKey = this.generateCacheKey(fileId, steps);
-    if (this.cache) {
-      const cached = await Promise.resolve(this.cache.get(cacheKey));
-      if (cached) {
-        this.logger?.debug("Returning cached transformed video for %s", fileId);
-        return cached;
-      }
-    }
-    const originalFile = await this.storage.get(fileQuery);
-    await this.validateVideo(originalFile);
-    const transformedBuffer = await this.applyTransformations(originalFile.content, steps);
-    const result = await this.createTransformResult(transformedBuffer, originalFile);
-    if (this.cache) {
-      this.cache.set(cacheKey, result);
-    }
-    return result;
-  }
-  /**
-   * Applies multiple transformations in sequence using Mediabunny.
-   * @param buffer The original video buffer.
-   * @param steps Array of video transformation steps to apply.
-   * @returns Promise resolving to transformed video buffer.
-   * @private
-   */
-  async applyTransformations(buffer, steps) {
-    const input = new Input({
-      formats: ALL_FORMATS,
-      source: new BufferSource(buffer)
-    });
-    const outputFormat = this.determineOutputFormat(steps);
-    const output = new Output({
-      format: outputFormat,
-      target: new BufferTarget()
-    });
-    const videoOptions = this.stepsToVideoOptions(steps);
-    const conversion = await Conversion.init({
-      input,
-      output,
-      video: videoOptions
-    });
-    if (!conversion.isValid) {
-      const reasons = conversion.discardedTracks.map((track) => track.reason).join(", ");
-      throw new Error(`Video transformation failed: ${reasons}`);
-    }
-    await conversion.execute();
-    return Buffer.from(output.target.buffer);
-  }
-  /**
-   * Converts transformation steps to Mediabunny video options.
-   * @param steps Array of video transformation steps to convert.
-   * @returns Mediabunny video options object for conversion.
-   * @private
-   */
-  // eslint-disable-next-line class-methods-use-this
-  stepsToVideoOptions(steps) {
-    const options = {};
-    for (const step of steps) {
-      switch (step.type) {
-        case "bitrate": {
-          const bitrateOptions = step.options;
-          if (bitrateOptions.bitrate) {
-            options.bitrate = bitrateOptions.bitrate;
-          }
-          break;
-        }
-        case "codec": {
-          const codecOptions = step.options;
-          if (codecOptions.codec) {
-            options.codec = codecOptions.codec;
-          }
-          if (codecOptions.bitrate) {
-            options.bitrate = codecOptions.bitrate;
-          }
-          break;
-        }
-        case "crop": {
-          const cropOptions = step.options;
-          options.crop = {
-            height: cropOptions.height,
-            left: cropOptions.left,
-            top: cropOptions.top,
-            width: cropOptions.width
-          };
-          break;
-        }
-        case "frameRate": {
-          const frameRateOptions = step.options;
-          if (frameRateOptions.frameRate) {
-            options.frameRate = frameRateOptions.frameRate;
-          }
-          break;
-        }
-        case "resize": {
-          const resizeOptions = step.options;
-          options.width = resizeOptions.width;
-          options.height = resizeOptions.height;
-          options.fit = resizeOptions.fit;
-          if (resizeOptions.position !== void 0) {
-            options.position = resizeOptions.position;
-          }
-          break;
-        }
-        case "rotate": {
-          const rotateOptions = step.options;
-          options.rotate = rotateOptions.angle;
-          if (rotateOptions.background) {
-            options.background = rotateOptions.background;
-          }
-          break;
-        }
-      }
-    }
-    return options;
-  }
-  /**
-   * Determines output format based on transformation steps.
-   * @param steps Array of video transformation steps.
-   * @returns Mediabunny output format instance (defaults to MP4).
-   * @private
-   */
-  determineOutputFormat(steps) {
-    for (const step of steps) {
-      if (step.type === "format" && step.options.format) {
-        return this.formatStringToOutputFormat(step.options.format);
-      }
-    }
-    return new Mp4OutputFormat();
-  }
-  /**
-   * Converts format string to Mediabunny output format.
-   * @param format Video format string (mp4, webm, mkv, ogg).
-   * @returns Mediabunny output format instance.
-   * @private
-   */
-  // eslint-disable-next-line class-methods-use-this
-  formatStringToOutputFormat(format) {
-    switch (format.toLowerCase()) {
-      case "mkv": {
-        return new MkvOutputFormat();
-      }
-      case "mp4": {
-        return new Mp4OutputFormat();
-      }
-      case "ogg": {
-        return new OggOutputFormat();
-      }
-      case "webm": {
-        return new WebMOutputFormat();
-      }
-      default: {
-        return new Mp4OutputFormat();
-      }
-    }
-  }
-  /**
-   * Validates that the file is a supported video.
-   * @param file The file to validate.
-   * @returns Promise that resolves if validation passes.
-   * @throws Error if file size exceeds limits, wrong content type, unsupported format, or invalid video.
-   * @private
-   */
-  async validateVideo(file) {
-    const fileSize = typeof file.size === "string" ? Number.parseInt(file.size, 10) : file.size;
-    if (this.config?.maxVideoSize && fileSize > this.config.maxVideoSize) {
-      throw new Error(`Video size ${fileSize} exceeds maximum allowed size ${this.config.maxVideoSize}`);
-    }
-    if (!isValidMediaType(file.contentType, "video")) {
-      throw new Error(`File is not a video: ${file.contentType}`);
-    }
-    const format = getFormatFromContentType(file.contentType);
-    if (this.config?.supportedFormats && format && !this.config.supportedFormats.includes(format)) {
-      throw new Error(`Unsupported video format: ${format}`);
-    }
-    try {
-      const input = new Input({
-        formats: ALL_FORMATS,
-        source: new BufferSource(file.content)
-      });
-      const primaryTrack = await input.getPrimaryVideoTrack();
-      if (!primaryTrack) {
-        throw new Error("No video track found");
-      }
-    } catch (error) {
-      throw new Error(`Invalid video file: ${error}`);
-    }
-  }
-  /**
-   * Creates transformation result with metadata.
-   * @param buffer The transformed video buffer.
-   * @param originalFile The original file information.
-   * @returns Video transformation result with metadata.
-   * @private
-   */
-  async createTransformResult(buffer, originalFile) {
-    const input = new Input({
-      formats: ALL_FORMATS,
-      source: new BufferSource(buffer)
-    });
-    const videoTrack = await input.getPrimaryVideoTrack();
-    const duration = await input.computeDuration();
-    return {
-      bitrate: this.config.defaultBitrate,
-      buffer,
-      duration,
-      format: "mp4",
-      // Default, would need to detect actual format
-      height: videoTrack?.displayHeight || 0,
-      originalFile,
-      size: buffer.length,
-      width: videoTrack?.displayWidth || 0
-    };
-  }
-  /**
-   * Generates cache key for transformation.
-   * @param fileId The file identifier.
-   * @param steps Array of transformation steps.
-   * @returns Unique cache key string.
-   * @private
-   */
-  // eslint-disable-next-line class-methods-use-this
-  generateCacheKey(fileId, steps) {
-    const stepsKey = steps.map((step) => `${step.type}:${JSON.stringify(step.options)}`).join("|");
-    return `${fileId}:${stepsKey}`;
-  }
-}
-
-export { VideoTransformer as default };
+var w=Object.defineProperty;var p=(n,t)=>w(n,"name",{value:t,configurable:!0});import{Input as f,BufferSource as m,ALL_FORMATS as u,Output as g,BufferTarget as l,Conversion as y,Mp4OutputFormat as d,WebMOutputFormat as b,OggOutputFormat as v,MkvOutputFormat as T}from"mediabunny";import F from"../packem_shared/BaseTransformer-D68eLyz1.js";import{isValidMediaType as k,getFormatFromContentType as O}from"../packem_shared/isValidMediaType-B-2UKjZx.js";var V=Object.defineProperty,z=p((n,t)=>V(n,"name",{value:t,configurable:!0}),"d");class C extends F{static{p(this,"b")}static{z(this,"VideoTransformer")}constructor(t,e={}){const r=e.logger||t.logger,o={cacheTtl:3600,defaultBitrate:2e6,defaultCodec:"avc",maxCacheSize:50,maxVideoSize:500*1024*1024,supportedFormats:["mp4","webm","mkv","avi","mov","flv","wmv"],...e};super(t,o,r)}async resize(t,e){return this.transform(t,[{options:e,type:"resize"}])}async crop(t,e){return this.transform(t,[{options:e,type:"crop"}])}async rotate(t,e){return this.transform(t,[{options:e,type:"rotate"}])}async convertFormat(t,e,r={}){return this.transform(t,[{options:{...r,format:e},type:"format"}])}async transcode(t,e,r={}){return this.transform(t,[{options:{...r,codec:e},type:"codec"}])}async transform(t,e){const r={id:t},o=this.generateCacheKey(t,e);if(this.cache){const s=await Promise.resolve(this.cache.get(o));if(s)return this.logger?.debug("Returning cached transformed video for %s",t),s}const a=await this.storage.get(r);await this.validateVideo(a);const c=await this.applyTransformations(a.content,e),i=await this.createTransformResult(c,a);return this.cache&&this.cache.set(o,i),i}async applyTransformations(t,e){const r=new f({formats:u,source:new m(t)}),o=this.determineOutputFormat(e),a=new g({format:o,target:new l}),c=this.stepsToVideoOptions(e),i=await y.init({input:r,output:a,video:c});if(!i.isValid){const s=i.discardedTracks.map(h=>h.reason).join(", ");throw new Error(`Video transformation failed: ${s}`)}return await i.execute(),Buffer.from(a.target.buffer)}stepsToVideoOptions(t){const e={};for(const r of t)switch(r.type){case"bitrate":{const o=r.options;o.bitrate&&(e.bitrate=o.bitrate);break}case"codec":{const o=r.options;o.codec&&(e.codec=o.codec),o.bitrate&&(e.bitrate=o.bitrate);break}case"crop":{const o=r.options;e.crop={height:o.height,left:o.left,top:o.top,width:o.width};break}case"frameRate":{const o=r.options;o.frameRate&&(e.frameRate=o.frameRate);break}case"resize":{const o=r.options;e.width=o.width,e.height=o.height,e.fit=o.fit,o.position!==void 0&&(e.position=o.position);break}case"rotate":{const o=r.options;e.rotate=o.angle,o.background&&(e.background=o.background);break}}return e}determineOutputFormat(t){for(const e of t)if(e.type==="format"&&e.options.format)return this.formatStringToOutputFormat(e.options.format);return new d}formatStringToOutputFormat(t){switch(t.toLowerCase()){case"mkv":return new T;case"mp4":return new d;case"ogg":return new v;case"webm":return new b;default:return new d}}async validateVideo(t){const e=typeof t.size=="string"?Number.parseInt(t.size,10):t.size;if(this.config?.maxVideoSize&&e>this.config.maxVideoSize)throw new Error(`Video size ${e} exceeds maximum allowed size ${this.config.maxVideoSize}`);if(!k(t.contentType,"video"))throw new Error(`File is not a video: ${t.contentType}`);const r=O(t.contentType);if(this.config?.supportedFormats&&r&&!this.config.supportedFormats.includes(r))throw new Error(`Unsupported video format: ${r}`);try{if(!await new f({formats:u,source:new m(t.content)}).getPrimaryVideoTrack())throw new Error("No video track found")}catch(o){throw new Error(`Invalid video file: ${o}`)}}async createTransformResult(t,e){const r=new f({formats:u,source:new m(t)}),o=await r.getPrimaryVideoTrack(),a=await r.computeDuration();return{bitrate:this.config.defaultBitrate,buffer:t,duration:a,format:"mp4",height:o?.displayHeight||0,originalFile:e,size:t.length,width:o?.displayWidth||0}}generateCacheKey(t,e){const r=e.map(o=>`${o.type}:${JSON.stringify(o.options)}`).join("|");return`${t}:${r}`}}export{C as default};

package/package.json

@@ -1,63 +1,68 @@
 {
   "name": "@visulima/storage",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.20",
   "description": "Visulima upload - Store files in a web-accessible location via a simplified API. Can automatically scale and rotate images. Includes S3, Azure, GCS and local filesystem-based backends with the most convenient features of each.",
   "keywords": [
     "anolilab",
-    "visulima",
+    "astro",
+    "aws",
+    "aws-s3",
+    "azure",
+    "better-upload",
+    "better-uploads",
+    "chunk",
+    "chunked-upload",
+    "chunked-uploads",
+    "cloudflare-r2",
+    "cloudflare-workers",
+    "digitalocean-spaces",
+    "edge-runtime",
+    "elysia",
+    "enterprise-security",
     "express",
-    "upload",
-    "uploads",
+    "fastify",
     "file",
+    "file-upload",
     "files",
-    "chunk",
-    "resumable",
-    "chunked-uploads",
-    "tus",
     "form",
-    "post",
-    "multipart",
     "form-data",
     "formdata",
-    "middleware",
-    "better-upload",
-    "better-uploads",
-    "s3",
-    "azure",
-    "aws",
+    "framework-agnostic",
     "gcs",
     "google",
-    "storage",
-    "file-upload",
-    "cloudflare-r2",
-    "digitalocean-spaces",
     "google-cloud-storage",
+    "hono",
+    "middleware",
     "minio",
-    "presigned-urls",
+    "multipart",
+    "multipart-upload",
     "nextjs",
-    "remix",
-    "sveltekit",
     "nuxt",
-    "astro",
+    "post",
+    "presigned-urls",
     "react",
-    "aws-s3",
-    "typescript",
-    "hono",
-    "fastify",
-    "elysia",
-    "framework-agnostic",
-    "edge-runtime",
-    "cloudflare-workers",
-    "vercel-edge",
+    "remix",
+    "resumable",
+    "s3",
     "serverless",
+    "storage",
+    "sveltekit",
+    "tus",
+    "typescript",
     "universal",
-    "enterprise-security",
-    "multipart-upload",
-    "chunked-upload",
+    "upload",
     "upload-library",
-    "uploadthing"
+    "uploads",
+    "uploadthing",
+    "vercel-edge",
+    "visulima"
   ],
   "homepage": "https://visulima.com/packages/uploads",
+  "license": "MIT",
+  "author": {
+    "name": "Daniel Bannert",
+    "email": "d.bannert@anolilab.de"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/visulima/visulima.git",
@@ -73,13 +78,14 @@
       "url": "https://anolilab.com/support"
     }
   ],
-  "license": "MIT",
-  "author": {
-    "name": "Daniel Bannert",
-    "email": "d.bannert@anolilab.de"
-  },
-  "sideEffects": false,
+  "files": [
+    "dist/**",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE.md"
+  ],
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -179,21 +185,19 @@
     },
     "./package.json": "./package.json"
   },
-  "files": [
-    "dist/**",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE.md"
-  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "dependencies": {
-    "@remix-run/multipart-parser": "^0.14.0",
+    "@remix-run/multipart-parser": "0.16.0",
     "@sindresorhus/fnv1a": "3.1.0",
-    "@visulima/pagination": "5.0.0-alpha.2",
-    "file-type": "21.1.1",
-    "lru-cache": "^11.2.4",
+    "@visulima/pagination": "5.0.0-alpha.11",
+    "file-type": "22.0.1",
+    "lru-cache": "11.3.5",
     "mime": "^4.1.0",
-    "nanoid": "5.1.6",
-    "path-to-regexp": "8.3.0",
+    "nanoid": "5.1.11",
+    "path-to-regexp": "8.4.2",
     "type-is": "^2.0.1"
   },
   "peerDependencies": {
@@ -277,10 +281,6 @@
     }
   },
   "engines": {
-    "node": ">=22.13 <=25.x"
-  },
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "node": "^22.14.0 || >=24.10.0"
   }
 }

package/dist/handler/base/base-handler-core.d.ts

@@ -1,91 +0,0 @@
-import { EventEmitter } from "node:events";
-import type { BaseStorage } from "../../storage/storage.d.ts";
-import type { UploadFile } from "../../storage/utils/index.d.ts";
-import type MediaTransformer from "../../transformer/media-transformer.d.ts";
-import type { ErrorResponses } from "../../utils/errors.d.ts";
-import type { ResponseBodyType } from "../../utils/types.d.ts";
-import type { UploadOptions } from "../types.d.ts";
-/**
- * Core base class containing shared business logic for all handlers.
- * This class is platform-agnostic and contains no Node.js or Web API specific code.
- * @template TFile The file type used by this handler.
- */
-declare abstract class BaseHandlerCore<TFile extends UploadFile> extends EventEmitter {
-    /**
-     * Response body type for the handler.
-     */
-    responseType: ResponseBodyType;
-    /**
-     * Storage instance for file operations.
-     */
-    storage: BaseStorage<TFile>;
-    /**
-     * Optional media transformer for image/video processing.
-     */
-    mediaTransformer?: MediaTransformer;
-    /**
-     * Whether to disable termination for finished uploads.
-     */
-    disableTerminationForFinishedUploads?: boolean;
-    /**
-     * Logger instance for debugging and error reporting.
-     */
-    protected logger?: Console;
-    /**
-     * Gets the logger instance.
-     * @returns Logger instance or undefined.
-     */
-    get loggerInstance(): Console | undefined;
-    /**
-     * Internal error responses configuration.
-     */
-    protected internalErrorResponses: ErrorResponses;
-    /**
-     * Gets the error responses configuration.
-     * @returns Error responses configuration.
-     */
-    get errorResponses(): ErrorResponses;
-    constructor({ disableTerminationForFinishedUploads, mediaTransformer, storage }: UploadOptions<TFile>);
-    /**
-     * Sets custom error responses.
-     * @param value Partial error responses to override defaults.
-     */
-    set errorResponses(value: Partial<ErrorResponses>);
-    /**
-     * Assemble error responses by merging defaults with custom overrides.
-     * @param customErrors Custom error responses to override defaults
-     */
-    assembleErrors: (customErrors?: {}) => void;
-    /**
-     * Parses HTTP Range header and returns start/end byte positions for partial content requests.
-     * @param rangeHeader HTTP Range header value (e.g., "bytes=0-1023").
-     * @param fileSize Total size of the file in bytes.
-     * @returns Object with start and end positions, or undefined if range is invalid.
-     */
-    parseRangeHeader(rangeHeader: string | undefined, fileSize: number): {
-        end: number;
-        start: number;
-    } | undefined;
-    /**
-     * Build file URL from request and file data.
-     * Platform-agnostic version that accepts URL string.
-     * @param requestUrl Request URL string
-     * @param file File object containing ID and content type
-     * @returns Constructed file URL with extension based on content type
-     */
-    protected buildFileUrlFromString(requestUrl: string, file: TFile): string;
-    /**
-     * Negotiates content type based on Accept header and supported formats.
-     * Platform-agnostic version that accepts header string.
-     * @param acceptHeader Accept header value
-     * @param supportedTypes Array of supported MIME types to match against
-     * @returns Best matching content type or undefined if no match found
-     */
-    negotiateContentTypeFromHeader(acceptHeader: string | undefined, supportedTypes: string[]): string | undefined;
-    /**
-     * Check for undefined ID or path errors and throw appropriate HTTP errors.
-     * @param error The error to check
-     */
-    protected checkForUndefinedIdOrPath(error: unknown): void;
-}
-export default BaseHandlerCore;

package/dist/handler/base/base-handler-fetch.d.ts

@@ -1,76 +0,0 @@
-import type { UploadFile } from "../../storage/utils/index.d.ts";
-import type { UploadResponse } from "../../utils/types.d.ts";
-import type { Handlers, ResponseFile, ResponseList, UploadOptions } from "../types.d.ts";
-import BaseHandlerCore from "./base-handler-core.d.ts";
-/**
- * Base handler for Web API Fetch platform (Request/Response).
- * Extends BaseHandlerCore with Fetch-specific request/response handling.
- * @template TFile The file type used by this handler.
- */
-declare abstract class BaseHandlerFetch<TFile extends UploadFile> extends BaseHandlerCore<TFile> {
-    /**
-     * Limiting enabled HTTP method handler.
-     */
-    static readonly methods: Handlers[];
-    /**
-     * Map of registered HTTP method handlers.
-     */
-    protected registeredHandlers: Map<string, (request: Request) => Promise<ResponseFile<TFile> | ResponseList<TFile>>>;
-    constructor(options: UploadOptions<TFile>);
-    /**
-     * Gets the registered handlers map.
-     * @returns Map of registered handlers.
-     */
-    get handlers(): Map<string, (request: Request) => Promise<ResponseFile<TFile> | ResponseList<TFile>>>;
-    /**
-     * Handles Web API Fetch requests (for Hono, Cloudflare Workers, etc.).
-     * @param request Web API Request object.
-     * @returns Promise resolving to Web API Response.
-     */
-    fetch(request: Request): Promise<globalThis.Response>;
-    /**
-     * Compose and register HTTP method handlers.
-     * Subclasses should override this to register their specific handlers.
-     */
-    protected abstract compose(): void;
-    /**
-     * Handle the response from handlers for fetch requests and convert to Web API Response.
-     * @param request Web API Request object
-     * @param file Response file or list from handler
-     * @returns Promise resolving to Web API Response object
-     */
-    protected handleFetchResponse(request: Request, file: ResponseFile<TFile> | ResponseList<TFile>): Promise<globalThis.Response>;
-    /**
-     * Convert headers to Web API Headers format by flattening arrays and converting to strings.
-     * @param headers Headers object with potentially array values
-     * @returns Headers object with all values as strings
-     */
-    protected convertHeaders(headers: Record<string, number | string | string[]>): Record<string, string>;
-    /**
-     * Create Web API Response from UploadResponse object.
-     * @param uploadResponse Upload response containing body, headers, and status code
-     * @returns Web API Response object
-     */
-    protected createResponse(uploadResponse: UploadResponse): globalThis.Response;
-    /**
-     * Create error Response from Error object with appropriate status code and message.
-     * @param error Error object to convert to HTTP error response
-     * @returns Web API Response object with error details
-     */
-    protected createErrorResponse(error: Error): Promise<globalThis.Response>;
-    /**
-     * Build file URL from request and file data.
-     * @param request Web API Request object
-     * @param file File object containing ID and content type
-     * @returns Constructed file URL with extension based on content type
-     */
-    protected buildFileUrl(request: Request, file: TFile): string;
-    /**
-     * Negotiates content type based on Accept header and supported formats.
-     * @param request Web API Request object containing Accept header.
-     * @param supportedTypes Array of supported MIME types to match against.
-     * @returns Best matching content type or undefined if no match found.
-     */
-    negotiateContentType(request: Request, supportedTypes: string[]): string | undefined;
-}
-export default BaseHandlerFetch;