Hono Integration

The @storage-kit/hono adapter is edge-compatible and works great with Cloudflare Workers.

Installation

npm install @storage-kit/hono hono
# or
pnpm add @storage-kit/hono hono

Unified API (Recommended)

The recommended approach is to use createStorageKit() for centralized initialization.

// store-kit.ts
import { createStorageKit } from "@storage-kit/hono";

export const storeKit = createStorageKit({
  provider: "cloudflare-r2",
  endpoint: "https://account.r2.cloudflarestorage.com",
  accessKeyId: process.env.R2_ACCESS_KEY,
  secretAccessKey: process.env.R2_SECRET_KEY,
  defaultBucket: "my-bucket",
});

// index.ts
import { Hono } from "hono";
import { storeKit } from "./store-kit";

const app = new Hono();

// Mount storage endpoints at /api/storage
app.route("/api/storage", storeKit.routeHandler());

export default app;

Multi-Provider Configuration

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

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

const storeKit = createStorageKit({
  provider: "cloudflare-r2", // Default provider
  providers: {
    "cloudflare-r2": {
      endpoint: "https://account.r2.cloudflarestorage.com",
      accessKeyId: process.env.R2_ACCESS_KEY!,
      secretAccessKey: process.env.R2_SECRET_KEY!,
    },
    s3: {
      region: "us-east-1",
      accessKeyId: process.env.AWS_ACCESS_KEY_ID!,
      secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,
    },
  },
  defaultBucket: "uploads",
});

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

// Switch to S3 for specific operation
await storeKit.useProvider("s3").deleteFile("_", "archive-file.png");

// Get bucket-scoped service for a provider
const s3Archives = storeKit.useProvider("s3").bucket("archives");
await s3Archives.uploadFile(buffer, "backup.zip");

See the Multi-Provider Guide for more details.

Cloudflare Workers Example

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

const storeKit = createStorageKit({
  provider: "cloudflare-r2",
  endpoint: "https://your-account.r2.cloudflarestorage.com",
  accessKeyId: process.env.R2_ACCESS_KEY,
  secretAccessKey: process.env.R2_SECRET_KEY,
  defaultBucket: "my-bucket",
});

const app = new Hono();
app.route("/storage", storeKit.routeHandler());

// Swagger UI at: /storage/reference
export default app;

Service Methods

You can also use the client for direct operations in your services:

import { storeKit } from "./store-kit";

export async function getUploadUrl(path: string, contentType: string) {
  return storeKit.getPresignedUploadUrl("_", path, {
    contentType,
    expiresIn: 3600,
  });
}