@visulima/storage 1.0.9 → 1.0.11

package/dist/handler/http/fetch/index.d.ts

@@ -1,303 +1,304 @@
-import { U as UploadFile, m as UploadResponse } from "../../../packem_shared/storage.d-CEM1upWM.js";
+import { U as UploadFile, m as UploadResponse } from "../../../packem_shared/storage.d-DwdJrArF.js";
 import 'node:stream';
-import { H as Handlers, R as ResponseFile, a as ResponseList, U as UploadOptions } from "../../../packem_shared/types.d-CggTCgXr.js";
-export type { A as AsyncHandler, B as BaseHandler, M as MethodHandler, b as RequestEvent, c as UploadErrorEvent, d as UploadEvent } from "../../../packem_shared/types.d-CggTCgXr.js";
-import { B as BaseHandlerCore } from "../../../packem_shared/tus-base.d-DLzKE54M.js";
-export { T as TUS_RESUMABLE, a as TUS_VERSION } from "../../../packem_shared/tus-base.d-DLzKE54M.js";
+import { H as Handlers, R as ResponseFile, a as ResponseList, U as UploadOptions } from "../../../packem_shared/types.d-D7Zlz5RE.js";
+export type { A as AsyncHandler, B as BaseHandler, M as MethodHandler, b as RequestEvent, c as UploadErrorEvent, d as UploadEvent } from "../../../packem_shared/types.d-D7Zlz5RE.js";
+import { B as BaseHandlerCore } from "../../../packem_shared/tus-base.d-BKBoJVy0.js";
+export { T as TUS_RESUMABLE, a as TUS_VERSION } from "../../../packem_shared/tus-base.d-BKBoJVy0.js";
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
+import 'node:timers';
 import 'node:events';
 import '@visulima/pagination';
-import "../../../packem_shared/media-transformer.d-Quf4ai47.js";
-import "../../../packem_shared/types.d-CrUWY4On.js";
+import "../../../packem_shared/media-transformer.d-C8tn4J2Z.js";
+import "../../../packem_shared/types.d-BEUv414z.js";
 /**
-* 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.
-*/
+ * 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.
-  */
+   * Limiting enabled HTTP method handler.
+   */
   static readonly methods: Handlers[];
   /**
-  * Map of registered HTTP method 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.
-  */
+   * 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.
-  */
+   * 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.
-  */
+   * 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
-  */
+   * 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
-  */
+   * 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
-  */
+   * 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
-  */
+   * 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
-  */
+   * 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.
-  */
+   * 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;
 }
 /**
-* Multipart/form-data upload handler (Web API Fetch version).
-* @example
-* ```ts
-* const multipart = new MultipartFetch({
-*   storage,
-*   maxFileSize: 100 * 1024 * 1024, // 100MB
-* });
-*
-* // Use with Hono, Cloudflare Workers, etc.
-* app.all('/files/*', async (c) => {
-*   return multipart.fetch(c.req.raw);
-* });
-* ```
-*/
+ * Multipart/form-data upload handler (Web API Fetch version).
+ * @example
+ * ```ts
+ * const multipart = new MultipartFetch({
+ *   storage,
+ *   maxFileSize: 100 * 1024 * 1024, // 100MB
+ * });
+ *
+ * // Use with Hono, Cloudflare Workers, etc.
+ * app.all('/files/*', async (c) => {
+ *   return multipart.fetch(c.req.raw);
+ * });
+ * ```
+ */
 declare class Multipart<TFile extends UploadFile> extends BaseHandlerFetch<TFile> {
   /**
-  * Limiting enabled http method handler
-  */
+   * Limiting enabled http method handler
+   */
   static override readonly methods: Handlers[];
   private readonly multipartBase;
   /**
-  * Maximum file size allowed for multipart uploads
-  */
+   * Maximum file size allowed for multipart uploads
+   */
   private maxFileSize;
   /**
-  * Maximum header size allowed for multipart parser
-  */
+   * Maximum header size allowed for multipart parser
+   */
   private maxHeaderSize;
   constructor(options: UploadOptions<TFile>);
   /**
-  * Handles multipart/form-data POST requests for file uploads.
-  * @param request Web API Request containing multipart data.
-  * @returns Promise resolving to ResponseFile with upload result.
-  */
+   * Handles multipart/form-data POST requests for file uploads.
+   * @param request Web API Request containing multipart data.
+   * @returns Promise resolving to ResponseFile with upload result.
+   */
   post(request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Delete an uploaded file.
-  * @param request Web API Request with file ID
-  * @returns Promise resolving to ResponseFile with deletion result
-  */
+   * Delete an uploaded file.
+   * @param request Web API Request with file ID
+   * @returns Promise resolving to ResponseFile with deletion result
+   */
   delete(request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Handle OPTIONS requests with CORS headers.
-  * @param _request Web API Request (unused)
-  * @returns Promise resolving to ResponseFile with CORS headers
-  */
+   * Handle OPTIONS requests with CORS headers.
+   * @param _request Web API Request (unused)
+   * @returns Promise resolving to ResponseFile with CORS headers
+   */
   options(_request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Retrieves a file or list of files based on the request path.
-  * Delegates to BaseHandlerFetch.fetch() method.
-  * @param _request Web API Request
-  * @returns Promise resolving to Web API Response
-  */
+   * Retrieves a file or list of files based on the request path.
+   * Delegates to BaseHandlerFetch.fetch() method.
+   * @param _request Web API Request
+   * @returns Promise resolving to Web API Response
+   */
   get(_request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Compose and register HTTP method handlers.
-  */
+   * Compose and register HTTP method handlers.
+   */
   protected compose(): void;
 }
 /**
-* REST API handler for direct binary file uploads (Web API Fetch version).
-*
-* This handler provides a clean REST interface for file operations using Web API Request/Response:
-* - POST: Create a new file with raw binary data or initialize chunked upload
-* - PUT: Create or update a file (requires ID in URL)
-* - PATCH: Upload chunks for chunked uploads (requires ID in URL)
-* - GET: Retrieve a file or list files
-* - DELETE: Delete a file (single) or multiple files (via ?ids=id1,id2 or JSON body)
-* - HEAD: Get file metadata and upload progress
-* - OPTIONS: CORS preflight
-* @example
-* ```ts
-* const rest = new RestFetch({
-*   storage,
-* });
-*
-* // Use with Hono, Cloudflare Workers, etc.
-* app.all('/files/*', async (c) => {
-*   return rest.fetch(c.req.raw);
-* });
-* ```
-*/
+ * REST API handler for direct binary file uploads (Web API Fetch version).
+ *
+ * This handler provides a clean REST interface for file operations using Web API Request/Response:
+ * - POST: Create a new file with raw binary data or initialize chunked upload
+ * - PUT: Create or update a file (requires ID in URL)
+ * - PATCH: Upload chunks for chunked uploads (requires ID in URL)
+ * - GET: Retrieve a file or list files
+ * - DELETE: Delete a file (single) or multiple files (via ?ids=id1,id2 or JSON body)
+ * - HEAD: Get file metadata and upload progress
+ * - OPTIONS: CORS preflight
+ * @example
+ * ```ts
+ * const rest = new RestFetch({
+ *   storage,
+ * });
+ *
+ * // Use with Hono, Cloudflare Workers, etc.
+ * app.all('/files/*', async (c) => {
+ *   return rest.fetch(c.req.raw);
+ * });
+ * ```
+ */
 declare class RestFetch<TFile extends UploadFile> extends BaseHandlerFetch<TFile> {
   /**
-  * Limiting enabled http method handler
-  */
+   * Limiting enabled http method handler
+   */
   static override readonly methods: Handlers[];
   private readonly restBase;
   constructor(options: UploadOptions<TFile>);
   /**
-  * Compose and register HTTP method handlers.
-  */
+   * Compose and register HTTP method handlers.
+   */
   protected compose(): void;
   /**
-  * Creates a new file via POST request with raw binary data.
-  * Supports both full file uploads and chunked upload initialization.
-  * @param request Web API Request with file data.
-  * @returns Promise resolving to ResponseFile with upload result.
-  */
+   * Creates a new file via POST request with raw binary data.
+   * Supports both full file uploads and chunked upload initialization.
+   * @param request Web API Request with file data.
+   * @returns Promise resolving to ResponseFile with upload result.
+   */
   post(request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Create or update a file via PUT request.
-  * Requires file ID in the URL path.
-  * @param request Web API Request with file ID and data
-  * @returns Promise resolving to ResponseFile with upload result
-  */
+   * Create or update a file via PUT request.
+   * Requires file ID in the URL path.
+   * @param request Web API Request with file ID and data
+   * @returns Promise resolving to ResponseFile with upload result
+   */
   put(request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Delete an uploaded file or multiple files.
-  * Supports single file (ID in URL) or batch delete (via ?ids=id1,id2 or JSON body).
-  * @param request Web API Request with file ID(s)
-  * @returns Promise resolving to ResponseFile (single) or ResponseList (batch) with deletion result
-  */
+   * Delete an uploaded file or multiple files.
+   * Supports single file (ID in URL) or batch delete (via ?ids=id1,id2 or JSON body).
+   * @param request Web API Request with file ID(s)
+   * @returns Promise resolving to ResponseFile (single) or ResponseList (batch) with deletion result
+   */
   delete(request: Request): Promise<ResponseFile<TFile> | ResponseList<TFile>>;
   /**
-  * Uploads a chunk via PATCH request for chunked uploads.
-  * Headers required: X-Chunk-Offset (byte offset), Content-Length (chunk size).
-  * Optional: X-Chunk-Checksum (SHA256 checksum for validation).
-  * @param request Web API Request with chunk data.
-  * @returns Promise resolving to ResponseFile with upload progress.
-  */
+   * Uploads a chunk via PATCH request for chunked uploads.
+   * Headers required: X-Chunk-Offset (byte offset), Content-Length (chunk size).
+   * Optional: X-Chunk-Checksum (SHA256 checksum for validation).
+   * @param request Web API Request with chunk data.
+   * @returns Promise resolving to ResponseFile with upload progress.
+   */
   patch(request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Get file metadata via HEAD request.
-  * For chunked uploads, also returns upload progress information.
-  * @param request Web API Request with file ID
-  * @returns Promise resolving to ResponseFile with metadata headers
-  */
+   * Get file metadata via HEAD request.
+   * For chunked uploads, also returns upload progress information.
+   * @param request Web API Request with file ID
+   * @returns Promise resolving to ResponseFile with metadata headers
+   */
   head(request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Handle OPTIONS requests with REST API capabilities.
-  * @param _request Web API Request
-  * @returns Promise resolving to ResponseFile with CORS headers
-  */
+   * Handle OPTIONS requests with REST API capabilities.
+   * @param _request Web API Request
+   * @returns Promise resolving to ResponseFile with CORS headers
+   */
   options(_request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Retrieves a file or list of files based on the request path.
-  * Delegates to BaseHandlerFetch.fetch() method.
-  * @param _request Web API Request
-  * @returns Promise resolving to Web API Response
-  */
+   * Retrieves a file or list of files based on the request path.
+   * Delegates to BaseHandlerFetch.fetch() method.
+   * @param _request Web API Request
+   * @returns Promise resolving to Web API Response
+   */
   get(_request: Request): Promise<ResponseFile<TFile> | ResponseList<TFile>>;
 }
 /**
-* TUS resumable upload protocol handler (Web API Fetch version).
-*
-* [tus resumable upload protocol](https://github.com/tus/tus-resumable-upload-protocol/blob/master/protocol.md)
-* @example
-* ```ts
-* const tus = new TusFetch({storage});
-*
-* // Use with Hono, Cloudflare Workers, etc.
-* app.all('/files/*', async (c) => {
-*   return tus.fetch(c.req.raw);
-* });
-* ```
-*/
+ * TUS resumable upload protocol handler (Web API Fetch version).
+ *
+ * [tus resumable upload protocol](https://github.com/tus/tus-resumable-upload-protocol/blob/master/protocol.md)
+ * @example
+ * ```ts
+ * const tus = new TusFetch({storage});
+ *
+ * // Use with Hono, Cloudflare Workers, etc.
+ * app.all('/files/*', async (c) => {
+ *   return tus.fetch(c.req.raw);
+ * });
+ * ```
+ */
 declare class Tus<TFile extends UploadFile> extends BaseHandlerFetch<TFile> {
   /**
-  * Limiting enabled http method handler
-  */
+   * Limiting enabled http method handler
+   */
   static override readonly methods: Handlers[];
   private readonly tusBase;
   constructor(options: UploadOptions<TFile>);
   /**
-  * Web API fetch entrypoint. Wraps the base implementation to ensure every TUS
-  * response — success and error alike — carries the `Tus-Resumable` header,
-  * which the protocol requires on all responses.
-  */
+   * Web API fetch entrypoint. Wraps the base implementation to ensure every TUS
+   * response — success and error alike — carries the `Tus-Resumable` header,
+   * which the protocol requires on all responses.
+   */
   override fetch(request: Request): Promise<globalThis.Response>;
   /**
-  * Handle OPTIONS requests with TUS protocol capabilities.
-  * @returns Promise resolving to ResponseFile with TUS headers
-  */
+   * Handle OPTIONS requests with TUS protocol capabilities.
+   * @returns Promise resolving to ResponseFile with TUS headers
+   */
   options(): Promise<ResponseFile<TFile>>;
   /**
-  * Creates a new TUS upload and optionally starts uploading data.
-  * @param request Web API Request with TUS headers.
-  * @returns Promise resolving to ResponseFile with upload location and offset.
-  */
+   * Creates a new TUS upload and optionally starts uploading data.
+   * @param request Web API Request with TUS headers.
+   * @returns Promise resolving to ResponseFile with upload location and offset.
+   */
   post(request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Write a chunk of data to an existing TUS upload.
-  * @param request Web API Request with chunk data and TUS headers
-  * @returns Promise resolving to ResponseFile with updated offset
-  */
+   * Write a chunk of data to an existing TUS upload.
+   * @param request Web API Request with chunk data and TUS headers
+   * @returns Promise resolving to ResponseFile with updated offset
+   */
   patch(request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Get current upload offset and metadata for TUS resumable uploads.
-  * @param request Web API Request with upload ID
-  * @returns Promise resolving to ResponseFile with upload-offset and metadata headers
-  */
+   * Get current upload offset and metadata for TUS resumable uploads.
+   * @param request Web API Request with upload ID
+   * @returns Promise resolving to ResponseFile with upload-offset and metadata headers
+   */
   head(request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Get TUS upload metadata and current status.
-  * @param request Web API Request with upload ID
-  * @returns Promise resolving to ResponseFile with file metadata as JSON
-  */
+   * Get TUS upload metadata and current status.
+   * @param request Web API Request with upload ID
+   * @returns Promise resolving to ResponseFile with file metadata as JSON
+   */
   get(request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Delete a TUS upload and its associated data.
-  * @param request Web API Request with upload ID
-  * @returns Promise resolving to ResponseFile with deletion confirmation
-  */
+   * Delete a TUS upload and its associated data.
+   * @param request Web API Request with upload ID
+   * @returns Promise resolving to ResponseFile with deletion confirmation
+   */
   delete(request: Request): Promise<ResponseFile<TFile>>;
   /**
-  * Compose and register HTTP method handlers.
-  */
+   * Compose and register HTTP method handlers.
+   */
   protected compose(): void;
   /**
-  * Build file URL for TUS uploads (without file extension).
-  * @param requestUrl Request URL string
-  * @param file File object containing ID
-  * @returns Constructed file URL for TUS protocol
-  */
+   * Build file URL for TUS uploads (without file extension).
+   * @param requestUrl Request URL string
+   * @param file File object containing ID
+   * @returns Constructed file URL for TUS protocol
+   */
   protected buildFileUrlForTus(requestUrl: string, file: TFile): string;
 }
 export { type Handlers, Multipart, RestFetch as Rest, Tus, type UploadOptions };

package/dist/handler/http/fetch/index.js

@@ -1 +1 @@
-import{default as o}from"../../../packem_shared/Multipart-CQjYqU--.js";import{default as f}from"../../../packem_shared/Rest-CI_BiZPv.js";import{Tus as p}from"../../../packem_shared/Tus-BBVt2ky3.js";import{TUS_RESUMABLE as s,TUS_VERSION as u}from"../../../packem_shared/TUS_RESUMABLE-CyTSRvPU.js";export{o as Multipart,f as Rest,s as TUS_RESUMABLE,u as TUS_VERSION,p as Tus};
+import{default as o}from"../../../packem_shared/Multipart-V64Bg5dt.js";import{default as f}from"../../../packem_shared/Rest-B7g1sgkq.js";import{Tus as p}from"../../../packem_shared/Tus-D9c7KDnl.js";import{TUS_RESUMABLE as s,TUS_VERSION as u}from"../../../packem_shared/TUS_RESUMABLE-CyTSRvPU.js";export{o as Multipart,f as Rest,s as TUS_RESUMABLE,u as TUS_VERSION,p as Tus};

package/dist/handler/http/hono/index.d.ts

@@ -1,72 +1,73 @@
 import { Hono } from 'hono';
-import { U as UploadFile } from "../../../packem_shared/storage.d-CEM1upWM.js";
+import { U as UploadFile } from "../../../packem_shared/storage.d-DwdJrArF.js";
 import 'node:stream';
-import { U as UploadOptions } from "../../../packem_shared/types.d-CggTCgXr.js";
+import { U as UploadOptions } from "../../../packem_shared/types.d-D7Zlz5RE.js";
+import 'node:timers';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 import 'node:events';
 import '@visulima/pagination';
-import "../../../packem_shared/media-transformer.d-Quf4ai47.js";
-import "../../../packem_shared/types.d-CrUWY4On.js";
+import "../../../packem_shared/media-transformer.d-C8tn4J2Z.js";
+import "../../../packem_shared/types.d-BEUv414z.js";
 /**
-* Registers upload handler routes on a Hono app instance.
-* Automatically registers all required HTTP methods for the specified handler type.
-* @param app Hono app instance to register routes on
-* @param config Handler configuration including storage, type, and path
-* @example
-* ```ts
-* import { Hono } from "hono";
-* import { DiskStorage } from "@visulima/storage";
-* import { createHonoHandler } from "@visulima/storage/handler/http/hono";
-*
-* const app = new Hono();
-* const storage = new DiskStorage({ directory: "./uploads" });
-*
-* // Multipart handler - automatically registers POST, GET, DELETE, OPTIONS
-* createHonoHandler(app, {
-*   path: "/files",
-*   storage,
-*   type: "multipart"
-* });
-* ```
-* @example
-* ```ts
-* import { Hono } from "hono";
-* import { DiskStorage } from "@visulima/storage";
-* import { createHonoHandler } from "@visulima/storage/handler/http/hono";
-*
-* const app = new Hono();
-* const storage = new DiskStorage({ directory: "./uploads" });
-*
-* // REST handler - automatically registers POST, PUT, PATCH, GET, HEAD, DELETE, OPTIONS
-* createHonoHandler(app, {
-*   path: "/files-rest",
-*   storage,
-*   type: "rest"
-* });
-* ```
-* @example
-* ```ts
-* import { Hono } from "hono";
-* import { DiskStorage } from "@visulima/storage";
-* import { createHonoHandler } from "@visulima/storage/handler/http/hono";
-*
-* const app = new Hono();
-* const storage = new DiskStorage({ directory: "./uploads" });
-*
-* // TUS handler - automatically registers POST, PATCH, HEAD, GET, DELETE, OPTIONS
-* createHonoHandler(app, {
-*   path: "/files-tus",
-*   storage,
-*   type: "tus"
-* });
-* ```
-*/
+ * Registers upload handler routes on a Hono app instance.
+ * Automatically registers all required HTTP methods for the specified handler type.
+ * @param app Hono app instance to register routes on
+ * @param config Handler configuration including storage, type, and path
+ * @example
+ * ```ts
+ * import { Hono } from "hono";
+ * import { DiskStorage } from "@visulima/storage";
+ * import { createHonoHandler } from "@visulima/storage/handler/http/hono";
+ *
+ * const app = new Hono();
+ * const storage = new DiskStorage({ directory: "./uploads" });
+ *
+ * // Multipart handler - automatically registers POST, GET, DELETE, OPTIONS
+ * createHonoHandler(app, {
+ *   path: "/files",
+ *   storage,
+ *   type: "multipart"
+ * });
+ * ```
+ * @example
+ * ```ts
+ * import { Hono } from "hono";
+ * import { DiskStorage } from "@visulima/storage";
+ * import { createHonoHandler } from "@visulima/storage/handler/http/hono";
+ *
+ * const app = new Hono();
+ * const storage = new DiskStorage({ directory: "./uploads" });
+ *
+ * // REST handler - automatically registers POST, PUT, PATCH, GET, HEAD, DELETE, OPTIONS
+ * createHonoHandler(app, {
+ *   path: "/files-rest",
+ *   storage,
+ *   type: "rest"
+ * });
+ * ```
+ * @example
+ * ```ts
+ * import { Hono } from "hono";
+ * import { DiskStorage } from "@visulima/storage";
+ * import { createHonoHandler } from "@visulima/storage/handler/http/hono";
+ *
+ * const app = new Hono();
+ * const storage = new DiskStorage({ directory: "./uploads" });
+ *
+ * // TUS handler - automatically registers POST, PATCH, HEAD, GET, DELETE, OPTIONS
+ * createHonoHandler(app, {
+ *   path: "/files-tus",
+ *   storage,
+ *   type: "tus"
+ * });
+ * ```
+ */
 declare const createStorageHandler: <TFile extends UploadFile>(app: Hono, config: HonoHandlerConfig<TFile>) => void;
 /**
-* Configuration for Hono handler.
-*/
+ * Configuration for Hono handler.
+ */
 interface HonoHandlerConfig<TFile extends UploadFile> extends UploadOptions<TFile> {
   /** Base path for the routes (e.g., "/files" or "/api/upload") */
   path: string;