chore: improve JSDoc comments

package.json

@@ -1,7 +1,7 @@
 {
     "name": "@gramio/files",
     "main": "./dist/index.js",
-    "version": "0.0.7",
+    "version": "0.0.8",
     "type": "commonjs",
     "description": "Set of utils for work with files and Telegram Bot API",
     "keywords": [

scripts/generate.ts

@@ -126,7 +126,11 @@ fs.writeFile(
 		return file instanceof File || file instanceof Promise;
 	}
 
-	/** @codegenerated */
+	/**
+	 * A set of methods with the function of checking whether a file has been passed in the parameters
+	 * 
+	 * @codegenerated 
+	 * */
     export const MEDIA_METHODS: MethodsWithMediaUpload = {${Object.entries(
 			methods,
 		)

src/index.ts

@@ -3,6 +3,8 @@
  *
  * Set of utils for work with files and Telegram Bot API
  *
+ * [Documentation](https://gramio.netlify.app/files/overview.html)
+ *
  * @example
  * ```typescript
  * import { MediaInput, MediaUpload } from "@gramio/files";

src/media-input.ts

@@ -6,7 +6,11 @@ import type {
 	TelegramInputMediaVideo,
 } from "@gramio/types";
 
-/** Class-helper with static methods that represents the content of a media message to be sent. */
+/**
+ *  Class-helper with static methods that represents the content of a media message to be sent.
+ *
+ * [Documentation](https://gramio.netlify.app/files/media-input.html)
+ */
 export class MediaInput {
 	/**
 	 * Represents an animation file (GIF or H.264/MPEG-4 AVC video without sound) to be sent.

src/media-methods-helper.ts

@@ -16,14 +16,18 @@ type MethodsWithMediaUpload = {
 	];
 };
 
-/** Guard for check is it File or Promise */
+/** Guard for check is it {@link File} or {@link Promise} */
 export function isFile(file?: TelegramInputFile | object | string) {
 	if (!file || typeof file !== "object") return false;
 
 	return file instanceof File || file instanceof Promise;
 }
 
-/** @codegenerated */
+/**
+ * A set of methods with the function of checking whether a {@link File} has been passed in the parameters
+ *
+ * @codegenerated
+ * */
 export const MEDIA_METHODS: MethodsWithMediaUpload = {
 	setWebhook: [(params) => isFile(params.certificate), null],
 	sendPhoto: [(params) => isFile(params.photo), null],

src/media-upload.ts

@@ -3,7 +3,11 @@ import { basename } from "node:path";
 import type { Readable } from "node:stream";
 import { convertStreamToBuffer } from "./utils";
 
-/** Class-helper with static methods for file uploading. */
+/**
+ * Class-helper with static methods for file uploading.
+ *
+ * [Documentation](https://gramio.netlify.app/files/media-upload.html)
+ */
 export class MediaUpload {
 	/**
 	 * Method for uploading Media File by local path.