@visulima/storage 1.0.0-alpha.9 → 1.0.1

package/package.json

@@ -1,67 +1,75 @@
 {
   "name": "@visulima/storage",
-  "version": "1.0.0-alpha.9",
-  "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.",
+  "version": "1.0.1",
+  "description": "Server-side file-storage abstraction - store files in a web-accessible location via a simplified API. Includes S3, Azure, GCS, local filesystem and 20+ other backends with TUS/multipart/REST upload handlers and 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",
+    "hetzner",
+    "hetzner-object-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",
+    "storj",
+    "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",
+  "homepage": "https://visulima.com/packages/storage",
+  "license": "MIT",
+  "author": {
+    "name": "Daniel Bannert",
+    "email": "d.bannert@anolilab.de"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/visulima/visulima.git",
-    "directory": "packages/storage"
+    "directory": "packages/storage/storage"
   },
   "funding": [
     {
@@ -73,13 +81,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",
@@ -117,6 +126,66 @@
       "types": "./dist/storage/local/index.d.ts",
       "import": "./dist/storage/local/index.js"
     },
+    "./provider/memory": {
+      "types": "./dist/storage/memory/index.d.ts",
+      "import": "./dist/storage/memory/index.js"
+    },
+    "./provider/ftp": {
+      "types": "./dist/storage/ftp/index.d.ts",
+      "import": "./dist/storage/ftp/index.js"
+    },
+    "./provider/sftp": {
+      "types": "./dist/storage/sftp/index.d.ts",
+      "import": "./dist/storage/sftp/index.js"
+    },
+    "./provider/supabase": {
+      "types": "./dist/storage/supabase/index.d.ts",
+      "import": "./dist/storage/supabase/index.js"
+    },
+    "./provider/uploadthing": {
+      "types": "./dist/storage/uploadthing/index.d.ts",
+      "import": "./dist/storage/uploadthing/index.js"
+    },
+    "./provider/dropbox": {
+      "types": "./dist/storage/dropbox/index.d.ts",
+      "import": "./dist/storage/dropbox/index.js"
+    },
+    "./provider/google-drive": {
+      "types": "./dist/storage/google-drive/index.d.ts",
+      "import": "./dist/storage/google-drive/index.js"
+    },
+    "./provider/onedrive": {
+      "types": "./dist/storage/onedrive/index.d.ts",
+      "import": "./dist/storage/onedrive/index.js"
+    },
+    "./provider/box": {
+      "types": "./dist/storage/box/index.d.ts",
+      "import": "./dist/storage/box/index.js"
+    },
+    "./provider/bun-s3": {
+      "types": "./dist/storage/bun-s3/index.d.ts",
+      "import": "./dist/storage/bun-s3/index.js"
+    },
+    "./provider/bunny": {
+      "types": "./dist/storage/bunny/index.d.ts",
+      "import": "./dist/storage/bunny/index.js"
+    },
+    "./provider/cloudinary": {
+      "types": "./dist/storage/cloudinary/index.d.ts",
+      "import": "./dist/storage/cloudinary/index.js"
+    },
+    "./provider/firebase": {
+      "types": "./dist/storage/firebase/index.d.ts",
+      "import": "./dist/storage/firebase/index.js"
+    },
+    "./provider/pocketbase": {
+      "types": "./dist/storage/pocketbase/index.d.ts",
+      "import": "./dist/storage/pocketbase/index.js"
+    },
+    "./provider/sharepoint": {
+      "types": "./dist/storage/sharepoint/index.d.ts",
+      "import": "./dist/storage/sharepoint/index.js"
+    },
     "./openapi": {
       "types": "./dist/openapi/index.d.ts",
       "import": "./dist/openapi/index.js"
@@ -177,47 +246,83 @@
       "types": "./dist/adapter/nuxt/module.d.ts",
       "import": "./dist/adapter/nuxt/module.js"
     },
+    "./ai/sdk": {
+      "types": "./dist/ai/ai-sdk/index.d.ts",
+      "import": "./dist/ai/ai-sdk/index.js"
+    },
+    "./ai/openai": {
+      "types": "./dist/ai/openai/index.d.ts",
+      "import": "./dist/ai/openai/index.js"
+    },
+    "./ai/claude": {
+      "types": "./dist/ai/claude/index.d.ts",
+      "import": "./dist/ai/claude/index.js"
+    },
+    "./ai/tanstack": {
+      "types": "./dist/ai/tanstack/index.d.ts",
+      "import": "./dist/ai/tanstack/index.js"
+    },
     "./package.json": "./package.json"
   },
-  "files": [
-    "dist/**",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE.md"
-  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "dependencies": {
-    "@remix-run/multipart-parser": "^0.14.2",
+    "@remix-run/multipart-parser": "0.16.3",
     "@sindresorhus/fnv1a": "3.1.0",
-    "@visulima/pagination": "5.0.0-alpha.7",
-    "file-type": "21.3.4",
-    "lru-cache": "11.2.7",
+    "@visulima/pagination": "5.0.0",
+    "file-type": "22.0.1",
+    "lru-cache": "11.5.1",
     "mime": "^4.1.0",
-    "nanoid": "5.1.7",
-    "path-to-regexp": "^8.3.0",
-    "type-is": "^2.0.1"
+    "nanoid": "5.1.16",
+    "path-to-regexp": "8.4.2",
+    "type-is": "^2.1.0",
+    "zod": "4.4.3"
   },
   "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": ">=0.2.0",
     "@aws-sdk/client-s3": ">=3.901.0",
     "@aws-sdk/credential-providers": ">=3.901.0",
     "@aws-sdk/s3-request-presigner": ">=3.901.0",
     "@aws-sdk/signature-v4-crt": ">=3.901.0",
     "@aws-sdk/types": ">=3.930.0",
+    "@azure/core-auth": ">=1.9.0",
     "@azure/storage-blob": ">=12.28.0",
+    "@bunny.net/storage-sdk": ">=0.3.0",
+    "@googleapis/drive": ">=20.0.0",
+    "@microsoft/microsoft-graph-client": ">=3.0.0",
     "@netlify/blobs": ">=10.3.1",
     "@nuxt/kit": ">=4.2.1",
+    "@openai/agents": ">=0.11.0",
     "@opentelemetry/api": ">=1.9.0",
     "@solidjs/start": ">=1.1.0",
-    "@vercel/blob": ">=2.0.0",
+    "@supabase/storage-js": ">=2.105.0",
+    "@tanstack/ai": ">=0.16.0",
+    "@vercel/blob": ">=2.4.0",
+    "ai": ">=5.0.0",
     "aws-crt": ">=1.27.3",
     "aws4fetch": ">=1.0.0",
+    "basic-ftp": ">=5.0.0",
+    "box-typescript-sdk-gen": ">=1.19.0",
+    "cloudinary": ">=2.0.0",
+    "dropbox": ">=10.34.0",
+    "firebase-admin": ">=10.0.0",
     "gaxios": ">=7.1.2",
     "google-auth-library": ">=10.4.0",
     "hono": ">=4.0.0",
     "mediabunny": ">=1.23.0",
     "next": ">=15",
-    "sharp": ">=0.33.5"
+    "openai": ">=5.0.0",
+    "pocketbase": ">=0.23.0",
+    "sharp": ">=0.34.5",
+    "ssh2-sftp-client": ">=11.0.0",
+    "uploadthing": ">=7.0.0"
   },
   "peerDependenciesMeta": {
+    "@anthropic-ai/claude-agent-sdk": {
+      "optional": true
+    },
     "@aws-sdk/client-s3": {
       "optional": true
     },
@@ -233,30 +338,69 @@
     "@aws-sdk/types": {
       "optional": true
     },
+    "@azure/core-auth": {
+      "optional": true
+    },
     "@azure/storage-blob": {
       "optional": true
     },
+    "@bunny.net/storage-sdk": {
+      "optional": true
+    },
+    "@googleapis/drive": {
+      "optional": true
+    },
+    "@microsoft/microsoft-graph-client": {
+      "optional": true
+    },
     "@netlify/blobs": {
       "optional": true
     },
     "@nuxt/kit": {
       "optional": true
     },
+    "@openai/agents": {
+      "optional": true
+    },
     "@opentelemetry/api": {
       "optional": true
     },
     "@solidjs/start": {
       "optional": true
     },
+    "@supabase/storage-js": {
+      "optional": true
+    },
+    "@tanstack/ai": {
+      "optional": true
+    },
     "@vercel/blob": {
       "optional": true
     },
+    "ai": {
+      "optional": true
+    },
     "aws-crt": {
       "optional": true
     },
     "aws4fetch": {
       "optional": true
     },
+    "basic-ftp": {
+      "optional": true
+    },
+    "box-typescript-sdk-gen": {
+      "optional": true
+    },
+    "cloudinary": {
+      "optional": true
+    },
+    "dropbox": {
+      "optional": true
+    },
+    "firebase-admin": {
+      "optional": true
+    },
     "gaxios": {
       "optional": true
     },
@@ -272,16 +416,23 @@
     "next": {
       "optional": true
     },
+    "openai": {
+      "optional": true
+    },
+    "pocketbase": {
+      "optional": true
+    },
     "sharp": {
       "optional": true
+    },
+    "ssh2-sftp-client": {
+      "optional": true
+    },
+    "uploadthing": {
+      "optional": true
     }
   },
-  "optionalDependencies": {},
   "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;