Media Upload

Class-helper with static methods for file uploading.

path

Method for uploading Media File by local path.

ctx.sendDocument(MediaUpload.path("./package.json"));
// or with filename
ctx.sendDocument(MediaUpload.path("./package.json", "some-other.json"));

If filename not specified, the filename set to filename 😃

url

Method for uploading Media File by URL (also with fetch options).

ctx.sendPhoto(MediaUpload.url("https://example.com/cat.png"));
// or with filename
ctx.sendPhoto(MediaUpload.url("https://example.com/cat.png", "cute-cat.png"));
// or with filename and fetch options (for example headers)
ctx.sendPhoto(
    MediaUpload.url("https://example.com/cat.png", "cute-cat.png", {
        headers: {
            Authorization: "Bearer gramio",
        },
    })
);

If filename not specified, the filename set to last part after /.

buffer

Method for uploading Media File by Buffer or ArrayBuffer.

const res = await fetch("https://...");

ctx.sendDocument(
    MediaUpload.buffer(await res.arrayBuffer(), "from-buffer.json")
);

By default filename is file.buffer.

stream

Method for uploading Media File by Readable stream.

ctx.sendDocument(
    MediaUpload.stream(
        fs.createReadStream("./cute-cat.png"),
        "the-same-cute-cat.png"
    )
);

By default filename is file.stream.

text

Method for uploading Media File by text content.

ctx.sendDocument(MediaUpload.text("GramIO is the best!", "truth.txt"));

By default filename is text.txt.