@dudousxd/nestjs-media-client

@dudousxd/nestjs-media-client is the single, dependency-free implementation of the browser-side upload protocol. The React package wraps it and the codegen extension re-exports it — so there is exactly one copy of the tus wire protocol to maintain.

uploadMedia

Resumably upload a Blob/File through the tus endpoints, returning the created resource location:

import { uploadMedia } from '@dudousxd/nestjs-media-client';

const { location } = await uploadMedia(file, {
  filename: file.name,
  contentType: file.type,
  basePath: '/media/uploads',   // your tus mount; defaults to /media/uploads
  chunkSize: 5 * 1024 * 1024,   // optional, default 5 MiB
  onProgress: (sent, total) => setPct(sent / total),
});

It POSTs to create the upload (sending Upload-Length + base64 Upload-Metadata), reads the Location, then PATCHes chunks while tracking Upload-Offset — the server assembles them on completion.

mediaUrl

A small helper to build a media URL by id (and optional conversion):

import { mediaUrl } from '@dudousxd/nestjs-media-client';

mediaUrl('abc');            // → /media/abc
mediaUrl('abc', 'thumb');   // → /media/abc?conversion=thumb

Bring-your-own fetch

fetchImpl lets you inject a custom fetch (auth headers, a mock in tests):

await uploadMedia(file, { filename, fetchImpl: authedFetch });

Resume

Because each chunk is acknowledged with an offset, an interrupted uploadMedia can be retried — the server reports the current offset via HEAD, and a fresh call continues from there rather than re-sending. See Uploads & multipart.