Fastify Integration

Use the @storage-kit/fastify plugin.

Setup

npm install @storage-kit/fastify fastify

Usage

import Fastify from "fastify";
import { createStorageKit } from "@storage-kit/fastify";

const fastify = Fastify();

const storeKit = createStorageKit({
  provider: "minio",
  endpoint: "http://localhost:9000",
  accessKeyId: "minioadmin",
  secretAccessKey: "minioadmin",
  defaultBucket: "my-bucket",
});

fastify.register(storeKit.plugin(), { prefix: "/api/storage" });

fastify.listen({ port: 3000 });

Multi-Provider Configuration

Storage Kit supports configuring multiple storage providers and switching between them at runtime:

import { createStorageKit } from "@storage-kit/fastify";

const storeKit = createStorageKit({
  provider: "minio", // Default provider
  providers: {
    minio: {
      endpoint: "http://localhost:9000",
      accessKeyId: "minioadmin",
      secretAccessKey: "minioadmin",
    },
    "cloudflare-r2": {
      endpoint: "https://account.r2.cloudflarestorage.com",
      accessKeyId: process.env.R2_ACCESS_KEY!,
      secretAccessKey: process.env.R2_SECRET_KEY!,
    },
  },
  defaultBucket: "uploads",
});

// Use default provider
await storeKit.deleteFile("_", "file.png");

// Switch to R2 for specific operation
await storeKit.useProvider("cloudflare-r2").deleteFile("_", "cdn-file.png");

// Get bucket-scoped service for a provider
const r2Bucket = storeKit.useProvider("cloudflare-r2").bucket("images");
await r2Bucket.uploadFile(buffer, "photo.jpg");

See the Multi-Provider Guide for more details.

Service Methods

Use the instance directly for programmatic operations:

// Upload file
const result = await storeKit.uploadFile("_", buffer, "avatar.png", "users/123");

// Generate presigned URL
const url = await storeKit.getPresignedUploadUrl("_", "files/doc.pdf", {
  contentType: "application/pdf",
  expiresIn: 3600,
});

// Delete file
await storeKit.deleteFile("_", "users/123/avatar.png");

// Health check
const health = await storeKit.healthCheck();