@dimah-s3/server

Presigned S3 handlers with HTTP handler, direct api, and an optional plugins array.

Full documentation: dimah-s3.vercel.app

Install

pnpm add @dimah-s3/server @aws-sdk/client-s3

Minimal setup

import { dimahS3 } from "@dimah-s3/server";
import { s3Client, defaultBucket } from "@/lib/s3-client";

export const s3 = dimahS3({
  s3: s3Client,
  defaultBucket,
  upload: { enabled: true },
  download: { enabled: false },
  delete: { enabled: false },
  multipart: { enabled: false },
});

Mount with a framework adapter:

// Next.js
import { toNextJsHandler } from "@dimah-s3/server/next";
export const { GET, POST, DELETE } = toNextJsHandler(s3);

// Express — @dimah-s3/server/express → toExpressHandler
// Hono    — @dimah-s3/server/hono → toHonoHandler
// Fastify — @dimah-s3/server/fastify → toFastifyHandler
// Elysia  — @dimah-s3/server/elysia → toElysiaHandler
// SvelteKit — @dimah-s3/server/svelte-kit → toSvelteKitHandler
// Node http — @dimah-s3/server/node → toNodeHandler

See Adapters for full examples.

Server-side (no HTTP):

await s3.api.download(key, { headers: await headers() });

Optional persistence: add db() from @dimah-s3/db to plugins.

License

MIT