Enable multipart support on large-file routes by setting upload.multipart: true or passing a MultipartConfig object.

lib/s3.ts

import { S3Client } from "@aws-sdk/client-s3";
import { dimahS3, route } from "@dimah-s3/server";

export const awsS3 = new S3Client({/* env */});

export const s3 = dimahS3({
  client: awsS3,
  bucket: process.env.S3_BUCKET!,
  routes: {
    video: route({
      upload: {
        fileTypes: ["video/*"],
        maxFileSize: 500 * 1024 * 1024, // 500MB
        multipart: true,
        onConfirmed: async ({ key, contentLength }) => {
          // Triggered on successful multipart completion
        },
      },
    }),
  },
});

Multipart lifecycle flow

Multipart upload flow

upload.guardInit validation
CreateMultipartUploadS3
multipart.guardAuthorizes each part
CompleteMultipartUploadS3
HeadObjectserver
onConfirmedFinal metadata

Type reference

import type {
  MultipartConfig,
  MultipartOnInitContext,
  MultipartGuardContext,
  MultipartOnAbortContext,
  MultipartOnListContext,
} from "@dimah-s3/server";