2.1.0 • Published 2 years ago
@tgsnake/fileid v2.1.0
@tgsnake/fileid
Core framework for creating fileId for tgsnake.
This framework is ported or inspired from pyrogram, big thank for that framework.
Another framework it should be can using this framework, not only a tgsnake.
The advantages we offer
- Stable
As long as we use this, the framework works fine without any problems. If a problem is found we will fix it as soon as possible. - Fast
This framework using simple algorithm to make it fast compared to other frameworks. - Zero Dependencies
With zero dependencies it make this framework fast and You don't have to worry about the security of this framework. - Typescript Support
This framework is build with typescript, so for typescript user no need to worry about types, because we already have it. - Url Safe
We are usingbase64urlthanbase64for encoding the file id, whichbase64urlmore safe when you using for Url. see : https://stackoverflow.com/a/55389212/16600138 Work with another framework fileId generator
This framework also supported file id of :- Telethon
- Pyrogram
- Bot Api
- tg-file-id
- Another framework should be we supported too.
We just tester for decoding file id from that framework, nvm work for re-sending the documents, but you can try. should be work too..
Installation
Installing this framework with npm
cd my-project
npm install @tgsnake/fileidInstalling this framework with yarn
cd my-project
yarn add @tgsnake/fileidUsage/Examples
const { FileId, FileType, ThumbnailSource, FileTypeUniqueId } = require('@tgsnake/fileid');
const raw = FileId.decodeFileId(
'CAACAgUAAxkBAAICjWKI4c8Zg7eo6bSbtAV_bVcFa9DmAAJ3BgACuNvZV0cotKoi35kTHgQ'
);
console.log(fileId);Documentation
Options
This options is using for generating unique file id or file id. Pass this options when you create a new class from FileId.
| field | type | required | description |
|---|---|---|---|
version | number | true | The major version of bot api file id. Usually is 4. |
subVersion | number | true | The minor version of bot api file id. Usually same with tdlib version or 32. |
dcId | number | true | The data center id, where that file is stored. |
fileType | enum/number of FileType | true | The enum/number of FileType. recommend to use enum. |
id | bigint | true | The id of file. |
accessHash | bigint | true | The hash to access that file. |
fileReference | Buffer | optional | File reference of that file. |
url | string | optional | If the file has web location, fill this with url of that web location. |
volumeId | bigint | optional | If the file has volume id, fill this with it. or if file doesn't have a volume id, fill this with `BigInt(0) |
localId | number | optional | If the file has local id, fill this with it. or if file doesn't have a local id, fill this with 0. This is required when you try to make file id of photo/thumbnail. |
secret | bigint | optional | The secret key from file, if file doesn't have a secret key fill this with BigInt(0). This is required when you try to make ThumbnailSource.LEGACY |
chatId | bigint | optional | If you want to make a file id of photo profil, fill this with BigInt of chatId. |
chatAccessHash | bigint | optional | If you want to make a file id of photo profil, fill this with BigInt of accessHash that chat, or BigInt(0) it must be work when you doesn't have a accessHash of that chat. |
stickerSetId | bigint | optional | The id of that sticker set. |
stickerSetAccessHash | bigint | optional | The accessHash of that sticker set. `BigInt(0) |
thumbnailSource | enum/number of ThumbnailSource | optional | The enum/number of ThumbnailSource. recommended to use enum. |
thumbnailFileType | enum/number of FileType | optional | The enum/number of FileType. recommend to use enum. |
thumbnailSize | string | optional | The size of that thumbnail. see : https://core.telegram.org/api/files#image-thumbnail-types |
fileTypeUniqueId | enum/number of FileTypeUniqueId | optional | Only for generating uniqueFileId. The enum/number of FileTypeUniqueId. recommended to use enum. |
Enums
FileType
enum FileType {
THUMBNAIL = 0,
CHAT_PHOTO = 1, // ProfilePhoto
PHOTO = 2,
VOICE = 3, // VoiceNote
VIDEO = 4,
DOCUMENT = 5,
ENCRYPTED = 6,
TEMP = 7,
STICKER = 8,
AUDIO = 9,
ANIMATION = 10,
ENCRYPTED_THUMBNAIL = 11,
WALLPAPER = 12,
VIDEO_NOTE = 13,
SECURE_RAW = 14,
SECURE = 15,
BACKGROUND = 16,
DOCUMENT_AS_FILE = 17,
}Importing this enum :
const { FileType } = require('@tgsnake/fileid');ThumbnailSource
enum ThumbnailSource {
LEGACY = 0,
THUMBNAIL = 1,
CHAT_PHOTO_SMALL = 2, // DialogPhotoSmall
CHAT_PHOTO_BIG = 3, // DialogPhotoBig
STICKER_SET_THUMBNAIL = 4,
}Importing this enum :
const { ThumbnailSource } = require('@tgsnake/fileid');FileTypeUniqueId
enum FileTypeUniqueId {
WEB = 0,
PHOTO = 1,
DOCUMENT = 2,
SECURE = 3,
ENCRYPTED = 4,
TEMP = 5,
}Importing this enum :
const { FileTypeUniqueId } = require('@tgsnake/fileid');Generating file id.
for generating file id, you can use .encodeFileId method. And for decoding using .decodeFileIdmethod.
const { FileId, FileType, ThumbnailSource, FileTypeUniqueId } = require("@tgsnake/fileid")
const fileId = FileId.encodeFileId({
version : 4,
subVersion : 32,
fileType : FileType.STICKER,
id : ,// fill this with document id
accessHash : , // fill this with document accessHash
fileReference : , // fill this with document fileReference
dcId : // fill this with document dcId
// fill with another options.
})
console.log(fileId)Generating file id and uniqueFileId
for generating only unique file id, you can use .encodeUniqueId method. And for decoding using decodeUniqueId method.
const { FileId, FileType, ThumbnailSource, FileTypeUniqueId } = require("@tgsnake/fileid")
const fileId = FileId.encode({
version : 4,
subVersion : 32,
fileType : FileType.STICKER,
fileTypeUniqueId : FileTypeUniqueId.DOCUMENT,
id : ,// fill this with document id
accessHash : , // fill this with document accessHash
fileReference : , // fill this with document fileReference
dcId : // fill this with document dcId
// fill with another options.
})
console.log(fileId)License
Build With ❤️ by tgsnake dev.