@visulima/storage 1.0.0-alpha.1 → 1.0.0-alpha.11

package/CHANGELOG.md

@@ -1,3 +1,173 @@
+## @visulima/storage [1.0.0-alpha.11](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.10...@visulima/storage@1.0.0-alpha.11) (2026-04-08)
+
+### Bug Fixes
+
+* remove deprecated baseUrl and downlevelIteration from tsconfigs ([a708366](https://github.com/visulima/visulima/commit/a708366b5c3bc73cfde480a712ed397bd921fb93))
+* **storage:** fix tsconfig.eslint.json to extend local tsconfig ([af2628a](https://github.com/visulima/visulima/commit/af2628ae8a8bc6f10693a96c9280feb81da2c0eb))
+
+### Miscellaneous Chores
+
+* **storage:** apply prettier formatting ([b2fa58d](https://github.com/visulima/visulima/commit/b2fa58d4364fa580b321b2df47a4264fd22eb070))
+* **storage:** expand inline if-return to block syntax ([29671ac](https://github.com/visulima/visulima/commit/29671ac54f22ae01029f40be73dbd745a1e9a8f9))
+* **storage:** migrate .prettierrc.cjs to prettier.config.js ([98b0fe6](https://github.com/visulima/visulima/commit/98b0fe60cd98ea4c33b8a54ee0b2229ad3c1d4c1))
+* **storage:** remove empty dependency objects from package.json ([ddfeb08](https://github.com/visulima/visulima/commit/ddfeb08fd392ad2553a1ce833dd331540ecc8b09))
+
+
+### Dependencies
+
+* **@visulima/pagination:** upgraded to 5.0.0-alpha.9
+* **@visulima/fs:** upgraded to 5.0.0-alpha.7
+* **@visulima/humanizer:** upgraded to 3.0.0-alpha.9
+* **@visulima/path:** upgraded to 3.0.0-alpha.8
+
+## @visulima/storage [1.0.0-alpha.10](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.9...@visulima/storage@1.0.0-alpha.10) (2026-03-26)
+
+### Features
+
+* **web:** auto-generate packages page from workspace metadata ([623e520](https://github.com/visulima/visulima/commit/623e5207693a7fe720f5f2f179593a3654c880e3))
+
+
+### Dependencies
+
+* **@visulima/pagination:** upgraded to 5.0.0-alpha.8
+* **@visulima/fs:** upgraded to 5.0.0-alpha.6
+* **@visulima/humanizer:** upgraded to 3.0.0-alpha.8
+* **@visulima/path:** upgraded to 3.0.0-alpha.7
+
+## @visulima/storage [1.0.0-alpha.9](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.8...@visulima/storage@1.0.0-alpha.9) (2026-03-26)
+
+### Bug Fixes
+
+* **storage:** use workspace:* for internal [@visulima](https://github.com/visulima) deps ([ff79afe](https://github.com/visulima/visulima/commit/ff79afe26f1941eab24cff80477d8c18aaec65e9))
+* **web:** improve build setup with incremental stats caching and prod install ([fe33e75](https://github.com/visulima/visulima/commit/fe33e75827586779b4b3a0c6d57b39f889ee6207))
+
+### Miscellaneous Chores
+
+* **storage:** migrate deps to pnpm catalogs ([7dfea89](https://github.com/visulima/visulima/commit/7dfea8981d74cd84317133242d2ab5a31f3f98b7))
+
+### Code Refactoring
+
+* **docs:** migrate Nextra components to fumadocs-ui, remove Nextra stripping ([484878f](https://github.com/visulima/visulima/commit/484878f01879363ef5e9a0282904dc4627d6060c))
+
+
+### Dependencies
+
+* **@visulima/pagination:** upgraded to 5.0.0-alpha.7
+* **@visulima/fs:** upgraded to 5.0.0-alpha.5
+* **@visulima/humanizer:** upgraded to 3.0.0-alpha.7
+* **@visulima/path:** upgraded to 3.0.0-alpha.6
+
+## @visulima/storage [1.0.0-alpha.8](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.7...@visulima/storage@1.0.0-alpha.8) (2026-03-16)
+
+### Bug Fixes
+
+* resolve 5 audit vulnerabilities (simple-git, express-rate-limit, tar, file-type, hono) ([2986d77](https://github.com/visulima/visulima/commit/2986d770746afd3223a074dc1a1a0040cca56e61))
+
+### Miscellaneous Chores
+
+* **storage:** update dependencies ([a2d2577](https://github.com/visulima/visulima/commit/a2d257702693aac7f368bddfd0481cdac09c3901))
+* visulima website ([#591](https://github.com/visulima/visulima/issues/591)) ([59ab2e2](https://github.com/visulima/visulima/commit/59ab2e2befb03e51cd2088956f83d9b87de6d033))
+
+## @visulima/storage [1.0.0-alpha.7](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.6...@visulima/storage@1.0.0-alpha.7) (2026-03-06)
+
+### Bug Fixes
+
+* **storage:** update packem to 2.0.0-alpha.54 ([a65ad87](https://github.com/visulima/visulima/commit/a65ad877ac5804a0c1354331a380fbcceddf261f))
+
+### Miscellaneous Chores
+
+* **storage:** update dependencies ([19b3d5c](https://github.com/visulima/visulima/commit/19b3d5c5fd1e535fbbb1419a827e5c4c0b35fa77))
+* **storage:** update dependencies ([f591768](https://github.com/visulima/visulima/commit/f591768de337c1b201191e4b78dd7e3fb79ca42b))
+* update lock file maintenance ([d83e716](https://github.com/visulima/visulima/commit/d83e71697b75d24704185b66bb521a934d2db02d))
+* year update ([47f4105](https://github.com/visulima/visulima/commit/47f410596ce7190cfea36a073db32e0cec50bbcd))
+
+### Code Refactoring
+
+* **storage:** replace SuperHeaders with native Headers ([68546c5](https://github.com/visulima/visulima/commit/68546c52bedad5c1338d571ad9a2034cc9f49b53))
+
+
+### Dependencies
+
+* **@visulima/pagination:** upgraded to 5.0.0-alpha.6
+* **@visulima/fs:** upgraded to 5.0.0-alpha.4
+* **@visulima/humanizer:** upgraded to 3.0.0-alpha.6
+* **@visulima/path:** upgraded to 3.0.0-alpha.5
+
+## @visulima/storage [1.0.0-alpha.6](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.5...@visulima/storage@1.0.0-alpha.6) (2026-01-17)
+
+### Miscellaneous Chores
+
+* **storage:** update dependencies ([b2450d8](https://github.com/visulima/visulima/commit/b2450d8f096991389ceed4bf4def2f99363daf6f))
+
+
+### Dependencies
+
+* **@visulima/pagination:** upgraded to 5.0.0-alpha.5
+
+## @visulima/storage [1.0.0-alpha.5](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.4...@visulima/storage@1.0.0-alpha.5) (2025-12-27)
+
+### Bug Fixes
+
+* **dependencies:** update hono and related packages to version 4.11.2 and update @hono/swagger-ui to version 0.5.3 ([5d3eed5](https://github.com/visulima/visulima/commit/5d3eed57d30d8216bf91484f35d39678938651fb))
+* **storage:** update package files ([5ef0060](https://github.com/visulima/visulima/commit/5ef0060c39b4457395583a828eb2f72fc3949496))
+
+### Miscellaneous Chores
+
+* **dependencies:** update file-type to version 21.2.0, hono to version 4.11.3, and improve README for storage-client with detailed usage examples ([90bebfa](https://github.com/visulima/visulima/commit/90bebfa9b732afd8d80c133ca0636192b8496801))
+* fixed project.json names and schema path ([964722f](https://github.com/visulima/visulima/commit/964722f691db205c7edb9aa6db29e849a647500b))
+
+
+### Dependencies
+
+* **@visulima/pagination:** upgraded to 5.0.0-alpha.4
+* **@visulima/fs:** upgraded to 5.0.0-alpha.3
+* **@visulima/humanizer:** upgraded to 3.0.0-alpha.5
+* **@visulima/path:** upgraded to 3.0.0-alpha.4
+
+## @visulima/storage [1.0.0-alpha.4](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.3...@visulima/storage@1.0.0-alpha.4) (2025-12-11)
+
+### Bug Fixes
+
+* update package OG images across multiple packages ([f08e4dd](https://github.com/visulima/visulima/commit/f08e4dd2b105ccb29c8412020a9c2be36d6c1e9e))
+
+
+### Dependencies
+
+* **@visulima/pagination:** upgraded to 5.0.0-alpha.3
+* **@visulima/fs:** upgraded to 5.0.0-alpha.2
+* **@visulima/humanizer:** upgraded to 3.0.0-alpha.4
+* **@visulima/path:** upgraded to 3.0.0-alpha.3
+
+## @visulima/storage [1.0.0-alpha.3](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.2...@visulima/storage@1.0.0-alpha.3) (2025-12-10)
+
+
+### Dependencies
+
+* **@visulima/humanizer:** upgraded to 3.0.0-alpha.3
+
+## @visulima/storage [1.0.0-alpha.2](https://github.com/visulima/visulima/compare/@visulima/storage@1.0.0-alpha.1...@visulima/storage@1.0.0-alpha.2) (2025-12-07)
+
+### ⚠ BREAKING CHANGES
+
+* change min node version to 22.13
+
+### Bug Fixes
+
+* add new package image, fixed readme rendering on npm, fixed building of packages ([b790ba2](https://github.com/visulima/visulima/commit/b790ba253ea07fef83528fd822a678facf021b5f))
+* update Node.js engine version requirement to >=22.13 in multiple package.json files for improved compatibility ([b828e9a](https://github.com/visulima/visulima/commit/b828e9aeaebfc798eecddccd90e6ec7560c6d36a))
+
+### Miscellaneous Chores
+
+* moved all packages into groups ([0615e9d](https://github.com/visulima/visulima/commit/0615e9d14a8a886e11da529ce150cf31ca973c10))
+* update @anolilab/semantic-release-pnpm and @anolilab/semantic-release-preset to versions 3.2.2 and 12.1.2 across multiple package.json files for improved compatibility ([3921626](https://github.com/visulima/visulima/commit/3921626141fe5da398749bf0ba675f1596f18afb))
+* update dependencies across multiple packages to improve compatibility and performance, including upgrading `@anolilab/semantic-release-pnpm` and `@anolilab/semantic-release-preset` to versions 3.2.0 and 12.1.0 respectively, and updating `react`, `react-dom`, and `next` versions to 19.2.1 and 16.0.7 in various package.json files ([aee8fcd](https://github.com/visulima/visulima/commit/aee8fcd796ae9b8d055903260e7150996ea9f53d))
+* update implicit dependencies in project.json for storage package ([2473f8a](https://github.com/visulima/visulima/commit/2473f8a2297df40425ba4eb4d9eb14d40db0b6ac))
+
+
+### Dependencies
+
+* **@visulima/fs:** upgraded to 5.0.0-alpha.1
+
 ## @visulima/storage 1.0.0-alpha.1 (2025-12-02)
 
 ### Features

package/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 visulima
+Copyright (c) 2026 visulima
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -63,7 +63,7 @@ Repository: git+https://github.com/visulima/visulima.git
 
 > MIT License
 >
-> Copyright (c) 2025 visulima
+> Copyright (c) 2026 visulima
 >
 > Permission is hereby granted, free of charge, to any person obtaining a copy
 > of this software and associated documentation files (the "Software"), to deal
@@ -97,7 +97,7 @@ Repository: git+https://github.com/visulima/visulima.git
 >
 > > MIT License
 > >
-> > Copyright (c) 2025 visulima
+> > Copyright (c) 2026 visulima
 > >
 > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > of this software and associated documentation files (the "Software"), to deal
@@ -131,7 +131,7 @@ Repository: git+https://github.com/visulima/visulima.git
 > >
 > > > MIT License
 > > >
-> > > Copyright (c) 2025 visulima
+> > > Copyright (c) 2026 visulima
 > > >
 > > > Permission is hereby granted, free of charge, to any person obtaining a copy
 > > > of this software and associated documentation files (the "Software"), to deal
@@ -358,7 +358,7 @@ Repository: git+https://github.com/visulima/visulima.git
 
 > MIT License
 >
-> Copyright (c) 2025 visulima
+> Copyright (c) 2026 visulima
 >
 > Permission is hereby granted, free of charge, to any person obtaining a copy
 > of this software and associated documentation files (the "Software"), to deal
@@ -427,7 +427,7 @@ Repository: git+https://github.com/visulima/visulima.git
 
 > MIT License
 >
-> Copyright (c) 2025 visulima
+> Copyright (c) 2026 visulima
 >
 > Permission is hereby granted, free of charge, to any person obtaining a copy
 > of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,15 +1,24 @@
-<div align="center">
-  <h3>Visulima upload</h3>
-  <p>Visulima upload copies files to a web-accessible location and provides a consistent way to get the URLs that correspond to those files.</p>
-  <p>Visulima upload can also resize, crop and autorotate uploaded images.</p>
-  <p>Visulima upload includes S3-based, Azure-based, GCS-based and local filesystem-based backends and you may supply others.</p>
-</div>
+<!-- START_PACKAGE_OG_IMAGE_PLACEHOLDER -->
+
+<a href="https://www.anolilab.com/open-source" align="center">
+
+  <img src="__assets__/package-og.svg" alt="storage" />
+
+</a>
+
+<h3 align="center">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.</h3>
+
+<!-- END_PACKAGE_OG_IMAGE_PLACEHOLDER -->
 
 <br />
 
 <div align="center">
 
-[![typescript-image]][typescript-url] [![npm-image]][npm-url] [![license-image]][license-url]
+[![typescript-image][typescript-badge]][typescript-url]
+[![mit licence][license-badge]][license]
+[![npm downloads][npm-downloads-badge]][npm-downloads]
+[![Chat][chat-badge]][chat]
+[![PRs Welcome][prs-welcome-badge]][prs-welcome]
 
 </div>
 
@@ -549,13 +558,23 @@ If you would like to help take a look at the [list of issues](https://github.com
 - [Daniel Bannert](https://github.com/prisis)
 - [All Contributors](https://github.com/visulima/visulima/graphs/contributors)
 
+## Made with ❤️ at Anolilab
+
+This is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. [Anolilab](https://www.anolilab.com/open-source) is a Development and AI Studio. Contact us at [hello@anolilab.com](mailto:hello@anolilab.com) if you need any help with these technologies or just want to say hi!
+
 ## License
 
-The visulima uploads is open-sourced software licensed under the [MIT][license-url]
+The visulima storage is open-sourced software licensed under the [MIT][license]
+
+<!-- badges -->
 
-[typescript-image]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
-[typescript-url]: "typescript"
-[license-image]: https://img.shields.io/npm/l/@visulima/upload?color=blueviolet&style=for-the-badge
-[license-url]: LICENSE.md "license"
-[npm-image]: https://img.shields.io/npm/v/@visulima/upload/latest.svg?style=for-the-badge&logo=npm
-[npm-url]: https://www.npmjs.com/package/@visulima/upload/v/latest "npm"
+[license-badge]: https://img.shields.io/npm/l/@visulima/storage?style=for-the-badge
+[license]: https://github.com/visulima/visulima/blob/main/LICENSE
+[npm-downloads-badge]: https://img.shields.io/npm/dm/@visulima/storage?style=for-the-badge
+[npm-downloads]: https://www.npmjs.com/package/@visulima/storage
+[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge
+[prs-welcome]: https://github.com/visulima/visulima/blob/main/.github/CONTRIBUTING.md
+[chat-badge]: https://img.shields.io/discord/932323359193186354.svg?style=for-the-badge
+[chat]: https://discord.gg/TtFJY8xkFK
+[typescript-badge]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
+[typescript-url]: https://www.typescriptlang.org/

package/dist/adapter/nuxt/module.d.ts

@@ -0,0 +1,39 @@
+import type { UploadOptions } from "../../handler/types.d.ts";
+import type { BaseStorage } from "../../storage/storage.d.ts";
+import type { UploadFile } from "../../storage/utils/index.d.ts";
+/**
+ * CORS configuration for upload endpoints
+ */
+export interface CorsOptions {
+    /** Allowed CORS headers */
+    headers?: string[];
+    /** Allowed HTTP methods */
+    methods?: string[];
+    /** Allowed origins (use "*" for all origins) */
+    origin?: string | string[];
+}
+/**
+ * Configuration options for the Nuxt storage module
+ */
+export interface ModuleOptions {
+    /** Base path for upload routes (default: '/api/upload') */
+    basePath?: string;
+    /** CORS configuration */
+    cors?: CorsOptions;
+    /** Enable multipart upload endpoint (default: true) */
+    multipart?: boolean;
+    /** Additional options for multipart handler */
+    multipartOptions?: Omit<UploadOptions<UploadFile>, "storage">;
+    /** Enable REST API endpoint for direct binary uploads (default: true) */
+    rest?: boolean;
+    /** Additional options for REST handler */
+    restOptions?: Omit<UploadOptions<UploadFile>, "storage">;
+    /** Storage instance to use for file uploads */
+    storage: BaseStorage;
+    /** Enable TUS resumable upload endpoint (default: true) */
+    tus?: boolean;
+    /** Additional options for TUS handler */
+    tusOptions?: Omit<UploadOptions<UploadFile>, "storage">;
+}
+declare const nuxtModule: any;
+export default nuxtModule;

package/dist/adapter/nuxt/module.js

@@ -0,0 +1,93 @@
+import { defineNuxtModule } from '@nuxt/kit';
+
+const handlerStorage = /* @__PURE__ */ new Map();
+const nuxtModule = defineNuxtModule({
+  defaults: {
+    basePath: "/api/upload",
+    cors: {
+      headers: ["Content-Type", "Upload-Offset", "Upload-Length", "Tus-Resumable"],
+      methods: ["GET", "POST", "PATCH", "PUT", "HEAD", "DELETE", "OPTIONS"],
+      origin: "*"
+    },
+    multipart: true,
+    rest: true,
+    tus: true
+  },
+  meta: {
+    compatibility: {
+      nuxt: ">=4.0.0"
+    },
+    configKey: "storage",
+    name: "@visulima/storage"
+  },
+  async setup(options, nuxt) {
+    const {
+      basePath = "/api/upload",
+      cors = {
+        headers: ["Content-Type", "Upload-Offset", "Upload-Length", "Tus-Resumable"],
+        methods: ["GET", "POST", "PATCH", "PUT", "HEAD", "DELETE", "OPTIONS"],
+        origin: "*"
+      },
+      multipart = true,
+      multipartOptions = {},
+      rest = true,
+      restOptions = {},
+      storage,
+      tus = true,
+      tusOptions = {}
+    } = options;
+    if (!storage) {
+      throw new Error("[@visulima/storage/nuxt] Storage instance is required");
+    }
+    const { Multipart, Rest, Tus } = await import('../../handler/http/node/index.js');
+    const multipartHandler = multipart ? new Multipart({ storage, ...multipartOptions }) : void 0;
+    const restHandler = rest ? new Rest({ storage, ...restOptions }) : void 0;
+    const tusHandler = tus ? new Tus({ storage, ...tusOptions }) : void 0;
+    const setCorsHeaders = (event) => {
+      const origin = Array.isArray(cors.origin) ? cors.origin.join(", ") : cors.origin || "*";
+      event.node.res.setHeader("Access-Control-Allow-Origin", origin);
+      if (cors.methods) {
+        event.node.res.setHeader("Access-Control-Allow-Methods", cors.methods.join(", "));
+      }
+      if (cors.headers) {
+        event.node.res.setHeader("Access-Control-Allow-Headers", cors.headers.join(", "));
+      }
+    };
+    if (multipartHandler) {
+      handlerStorage.set(`${basePath}/multipart`, { handler: multipartHandler, setCorsHeaders });
+    }
+    if (restHandler) {
+      handlerStorage.set(`${basePath}/rest`, { handler: restHandler, setCorsHeaders });
+    }
+    if (tusHandler) {
+      handlerStorage.set(`${basePath}/tus`, { handler: tusHandler, setCorsHeaders });
+    }
+    nuxt.hook("nitro:config", (nitroConfig) => {
+      const routeRules = nitroConfig.routeRules || {};
+      if (multipartHandler) {
+        routeRules[`${basePath}/multipart/**`] = { cors: true };
+      }
+      if (restHandler) {
+        routeRules[`${basePath}/rest/**`] = { cors: true };
+      }
+      if (tusHandler) {
+        routeRules[`${basePath}/tus/**`] = { cors: true };
+      }
+      nitroConfig.routeRules = routeRules;
+    });
+    nuxt.hook("nitro:init", (nitro) => {
+      nitro.hooks.hook("request", async (event) => {
+        const url = event.node.req.url || "";
+        for (const [route, { handler, setCorsHeaders: setHeaders }] of handlerStorage.entries()) {
+          if (url.startsWith(route)) {
+            setHeaders(event);
+            await handler.handle(event.node.req, event.node.res);
+            return;
+          }
+        }
+      });
+    });
+  }
+});
+
+export { nuxtModule as default };

package/dist/adapter/nuxt/package.json

@@ -0,0 +1,20 @@
+{
+    "name": "@visulima/storage-nuxt",
+    "version": "0.0.0",
+    "type": "module",
+    "exports": {
+        ".": {
+            "types": "./module.d.ts",
+            "import": "./module.js"
+        }
+    },
+    "main": "./module.js",
+    "types": "./module.d.ts",
+    "files": [
+        "."
+    ],
+    "peerDependencies": {
+        "@nuxt/kit": ">=4.0.0",
+        "nuxt": ">=4.0.0"
+    }
+}

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

@@ -0,0 +1,91 @@
+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

@@ -0,0 +1,76 @@
+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;