chore: add files Media Upload

docs/.vitepress/config.mts

@@ -67,6 +67,7 @@ export default defineConfig({
 								text: "Overview",
 								link: "/files/overview",
 							},
+							{ text: "Media Upload", link: "/files/media-upload" },
 							{ text: "Media Input", link: "/files/media-input" },
 						],
 					},

docs/files/media-upload.md

@@ -0,0 +1,71 @@
+# Media Upload
+
+Class-helper with static methods for file uploading.
+
+## path
+
+Method for uploading Media File by local path.
+
+```ts
+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).
+
+```ts
+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.
+
+```ts
+const res = await fetch("https://...");
+ctx.sendDocument(await res.arrayBuffer(), "from-buffer.json");
+```
+
+By default filename is `file.buffer`.
+
+## stream
+
+Method for uploading Media File by Readable stream.
+
+```ts
+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.
+
+```ts
+ctx.sendDocument(MediaUpload.text("GramIO is the best!", "truth.txt"));
+```
+
+By default filename is `text.txt`.

docs/files/overview.md

@@ -10,16 +10,14 @@ import { Bot, MediaInput, MediaUpload, InlineKeyboard } from "gramio";
 const bot = new Bot(process.env.BOT_TOKEN);
 
 bot.updates.on("message", async (ctx) => {
-    if (ctx.text === "test") {
-        ctx.sendMediaGroup([
-            MediaInput.document(
-                MediaUpload.url(
-                    "https://raw.githubusercontent.com/gramiojs/types/main/README.md"
-                )
-            ),
-            MediaInput.document(MediaUpload.path("./package.json")),
-        ]);
-    }
+    ctx.sendMediaGroup([
+        MediaInput.document(
+            MediaUpload.url(
+                "https://raw.githubusercontent.com/gramiojs/types/main/README.md"
+            )
+        ),
+        MediaInput.document(MediaUpload.path("./package.json")),
+    ]);
 });
 
 bot.updates.startPolling();