@maxhub/max-bot-api 0.2.1

package/dist/core/network/api/types/attachment-request.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/network/api/types/attachment.d.ts

@@ -0,0 +1,67 @@
+import { NullableObject } from '../../../helpers/types';
+import { Button } from './keyboard';
+import { User } from './user';
+type MediaPayload = {
+    url: string;
+    token: string;
+};
+export type PhotoAttachment = {
+    type: 'image';
+    payload: MediaPayload & {
+        photo_id: number;
+    };
+};
+export type VideoAttachment = {
+    type: 'video';
+    payload: MediaPayload;
+    thumbnail?: string | null;
+    width?: number | null;
+    height?: number | null;
+    duration?: number | null;
+};
+export type AudioAttachment = {
+    type: 'audio';
+    payload: MediaPayload;
+};
+export type FileAttachment = {
+    type: 'file';
+    payload: MediaPayload;
+    filename: string;
+    size: number;
+};
+export type StickerAttachment = {
+    type: 'sticker';
+    payload: {
+        url: string;
+        code: string;
+    };
+    width: number;
+    height: number;
+};
+export type ContactAttachment = {
+    type: 'contact';
+    payload: {
+        vcf_info?: string | null;
+        tam_info?: User | null;
+    };
+};
+export type ShareAttachment = {
+    type: 'share';
+    payload: Partial<NullableObject<MediaPayload>>;
+    title?: string | null;
+    description?: string | null;
+    image_url?: string | null;
+};
+export type LocationAttachment = {
+    type: 'location';
+    latitude: number;
+    longitude: number;
+};
+export type InlineKeyboardAttachment = {
+    type: 'inline_keyboard';
+    payload: {
+        buttons: Button[][];
+    };
+};
+export type Attachment = PhotoAttachment | VideoAttachment | AudioAttachment | FileAttachment | StickerAttachment | ContactAttachment | InlineKeyboardAttachment | ShareAttachment | LocationAttachment;
+export {};

package/dist/core/network/api/types/attachment.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/network/api/types/bot.d.ts

@@ -0,0 +1,8 @@
+import { UserWithPhoto } from './user';
+export type BotCommand = {
+    name: string;
+    description?: string | null;
+};
+export type BotInfo = UserWithPhoto & {
+    commands?: BotCommand[] | null;
+};

package/dist/core/network/api/types/bot.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/network/api/types/chat.d.ts

@@ -0,0 +1,41 @@
+export type ChatType = 'dialog' | 'chat' | 'channel';
+export type ChatStatus = 'active' | 'removed' | 'left' | 'closed' | 'suspended';
+export type Chat = {
+    chat_id: number;
+    type: ChatType;
+    status: ChatStatus;
+    title: string | null;
+    icon: {
+        url: string;
+    } | null;
+    last_event_time: number;
+    participants_count: number;
+    owner_id?: number | null;
+    participants?: {
+        [key: string]: number | undefined;
+    } | null;
+    is_public: boolean;
+    link?: string | null;
+    description?: string | null;
+    dialog_with_user?: {} | null;
+    messages_count?: number | null;
+    chat_message_id?: string | null;
+    pinned_message?: object | null;
+};
+export type SenderAction = 'typing_on' | 'sending_photo' | 'sending_video' | 'sending_audio' | 'sending_file' | 'mark_seen';
+export type ChatPermissions = 'read_all_messages' | 'add_remove_members' | 'add_admins' | 'change_chat_info' | 'pin_message' | 'write';
+export type ChatMember = {
+    user_id: number;
+    name: string;
+    username: string | null;
+    is_bot: boolean;
+    last_activity_time: number;
+    description?: string | null;
+    avatar_url?: string;
+    full_avatar_url?: string;
+    last_access_time: number;
+    is_owner: boolean;
+    is_admin: boolean;
+    join_time: number;
+    permissions: ChatPermissions[] | null;
+};

package/dist/core/network/api/types/chat.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/network/api/types/common.d.ts

@@ -0,0 +1,9 @@
+type SuccessResponse = {
+    success: true;
+};
+type ErrorResponse = {
+    success: false;
+    message: string;
+};
+export type ActionResponse = SuccessResponse | ErrorResponse;
+export {};

package/dist/core/network/api/types/common.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/network/api/types/index.d.ts

@@ -0,0 +1,11 @@
+export * from './attachment';
+export * from './attachment-request';
+export * from './bot';
+export * from './chat';
+export * from './common';
+export * from './keyboard';
+export * from './markup';
+export * from './message';
+export * from './subcription';
+export * from './uploads';
+export * from './user';

package/dist/core/network/api/types/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./attachment"), exports);
+__exportStar(require("./attachment-request"), exports);
+__exportStar(require("./bot"), exports);
+__exportStar(require("./chat"), exports);
+__exportStar(require("./common"), exports);
+__exportStar(require("./keyboard"), exports);
+__exportStar(require("./markup"), exports);
+__exportStar(require("./message"), exports);
+__exportStar(require("./subcription"), exports);
+__exportStar(require("./uploads"), exports);
+__exportStar(require("./user"), exports);

package/dist/core/network/api/types/keyboard.d.ts

@@ -0,0 +1,30 @@
+export type ButtonIntent = 'default' | 'positive' | 'negative';
+export type CallbackButton = {
+    type: 'callback';
+    text: string;
+    payload: string;
+    intent?: ButtonIntent;
+};
+export type LinkButton = {
+    type: 'link';
+    text: string;
+    url: string;
+};
+export type RequestContactButton = {
+    type: 'request_contact';
+    text: string;
+};
+export type RequestGeoLocationButton = {
+    type: 'request_geo_location';
+    text: string;
+    quick?: boolean;
+};
+export type ChatButton = {
+    type: 'chat';
+    text: string;
+    chat_title: string;
+    chat_description?: string | null;
+    start_payload?: string | null;
+    uuid?: string | null;
+};
+export type Button = CallbackButton | LinkButton | RequestContactButton | RequestGeoLocationButton | ChatButton;

package/dist/core/network/api/types/keyboard.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/network/api/types/markup.d.ts

@@ -0,0 +1,13 @@
+type MakeMarkup<Type extends string, Data extends object> = {
+    type: Type;
+    from: number;
+    length: number;
+} & {
+    [key in keyof Data]: Data[key];
+};
+export type UserMentionMarkup = MakeMarkup<'user_mention', {
+    user_link?: string | null;
+    user_id?: number | null;
+}>;
+export type MarkupElement = UserMentionMarkup;
+export {};

package/dist/core/network/api/types/markup.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/network/api/types/message.d.ts

@@ -0,0 +1,38 @@
+import { Attachment } from './attachment';
+import { ChatType } from './chat';
+import { MarkupElement } from './markup';
+import { User } from './user';
+export type MessageSender = User;
+export type MessageRecipient = {
+    chat_id: number | null;
+    chat_type: ChatType;
+};
+export type MessageBody = {
+    mid: string;
+    seq: number;
+    text: string | null;
+    attachments: Attachment[] | null;
+    markup?: MarkupElement[] | null;
+};
+export type MessageLinkType = 'forward' | 'reply';
+export type LinkedMessage = {
+    type: MessageLinkType;
+    sender?: MessageSender | null;
+    chat_id?: number;
+    message: MessageBody;
+};
+export type MessageStat = {
+    views: number;
+};
+export type MessageConstructor = User;
+export type Message = {
+    sender?: MessageSender | null;
+    recipient: MessageRecipient;
+    timestamp: number;
+    link?: LinkedMessage | null;
+    body: MessageBody;
+    stat?: MessageStat | null;
+    url?: string | null;
+    constructor?: MessageConstructor | null;
+};
+export type ConstructedMessage = Pick<Message, 'sender' | 'timestamp' | 'link' | 'body'>;

package/dist/core/network/api/types/message.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/network/api/types/subcription.d.ts

@@ -0,0 +1,85 @@
+import { Chat } from './chat';
+import { ConstructedMessage, Message } from './message';
+import { User, UserLocale } from './user';
+type MakeUpdate<Type extends string, Payload extends object> = {
+    update_type: Type;
+    timestamp: number;
+} & {
+    [key in keyof Payload]: Payload[key];
+};
+export type MessageCallbackUpdate = MakeUpdate<'message_callback', {
+    callback: {
+        timestamp: number;
+        callback_id: string;
+        payload?: string;
+        user: User;
+    };
+    message?: Message | null;
+    user_locale?: UserLocale | null;
+}>;
+export type MessageCreatedUpdate = MakeUpdate<'message_created', {
+    message: Message;
+    user_locale?: UserLocale | null;
+}>;
+export type MessageRemovedUpdate = MakeUpdate<'message_removed', {
+    message_id: string;
+    chat_id: number;
+    user_id: number;
+}>;
+export type MessageEditedUpdate = MakeUpdate<'message_edited', {
+    message: Message;
+}>;
+export type BotAddedUpdate = MakeUpdate<'bot_added', {
+    chat_id: number;
+    user: User;
+    is_channel: boolean;
+}>;
+export type BotRemovedUpdate = MakeUpdate<'bot_removed', {
+    chat_id: number;
+    user: User;
+    is_channel: boolean;
+}>;
+export type UserAddedUpdate = MakeUpdate<'user_added', {
+    chat_id: number;
+    user: User;
+    inviter_id?: number | null;
+    is_channel: boolean;
+}>;
+export type UserRemovedUpdate = MakeUpdate<'user_removed', {
+    chat_id: number;
+    user: User;
+    admin_id?: number | null;
+    is_channel: boolean;
+}>;
+export type BotStartedUpdate = MakeUpdate<'bot_started', {
+    chat_id: number;
+    user: User;
+    payload?: string | null;
+    user_locale?: UserLocale;
+}>;
+export type ChatTitleChangedUpdate = MakeUpdate<'chat_title_changed', {
+    chat_id: number;
+    user: User;
+    title: string;
+}>;
+export type MessageConstructionRequestUpdate = MakeUpdate<'message_construction_request', {
+    user: User;
+    user_locale?: UserLocale;
+    session_id: string;
+    data?: string | null;
+    input: unknown;
+}>;
+export type MessageConstructedUpdate = MakeUpdate<'message_constructed', {
+    user: User;
+    session_id: string;
+    message: ConstructedMessage;
+}>;
+export type MessageChatCreatedUpdate = MakeUpdate<'message_chat_created', {
+    chat: Chat;
+    message_id: string;
+    start_payload?: string | null;
+}>;
+export type UpdateType = Update['update_type'];
+export type FilteredUpdate<Type extends UpdateType> = Type extends 'message_callback' ? MessageCallbackUpdate : Type extends 'message_created' ? MessageCreatedUpdate : Type extends 'message_removed' ? MessageRemovedUpdate : Type extends 'message_edited' ? MessageEditedUpdate : Type extends 'bot_added' ? BotAddedUpdate : Type extends 'bot_removed' ? BotRemovedUpdate : Type extends 'user_added' ? UserAddedUpdate : Type extends 'user_removed' ? UserRemovedUpdate : Type extends 'bot_started' ? BotStartedUpdate : Type extends 'chat_title_changed' ? ChatTitleChangedUpdate : Type extends 'message_construction_request' ? MessageConstructionRequestUpdate : Type extends 'message_constructed' ? MessageConstructedUpdate : Type extends 'message_chat_created' ? MessageChatCreatedUpdate : never;
+export type Update = MessageCallbackUpdate | MessageCreatedUpdate | MessageRemovedUpdate | MessageEditedUpdate | BotAddedUpdate | BotRemovedUpdate | UserAddedUpdate | UserRemovedUpdate | BotStartedUpdate | ChatTitleChangedUpdate | MessageConstructionRequestUpdate | MessageConstructedUpdate | MessageChatCreatedUpdate;
+export {};

package/dist/core/network/api/types/subcription.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/network/api/types/uploads.d.ts

@@ -0,0 +1 @@
+export type UploadType = 'image' | 'video' | 'audio' | 'file';

package/dist/core/network/api/types/uploads.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/network/api/types/user.d.ts

@@ -0,0 +1,14 @@
+export type User = {
+    user_id: number;
+    name: string;
+    username: string | null;
+    is_bot: boolean;
+    last_activity_time: number;
+};
+export type UserWithPhoto = User & {
+    description?: string | null;
+    avatar_url?: string;
+    full_avatar_url?: string;
+};
+export declare const enum UserLocale {
+}

package/dist/core/network/api/types/user.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/network/polling.d.ts

@@ -0,0 +1,11 @@
+import type { Api } from '../../api';
+import { Update, UpdateType } from './api';
+export declare class Polling {
+    private readonly api;
+    private readonly allowedUpdates;
+    private readonly abortController;
+    private marker?;
+    constructor(api: Api, allowedUpdates?: UpdateType[]);
+    loop: (handleUpdate: (updates: Update) => Promise<void>) => Promise<void>;
+    stop: () => void;
+}

package/dist/core/network/polling.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Polling = void 0;
+const debug_1 = __importDefault(require("debug"));
+const api_1 = require("./api");
+const debug = (0, debug_1.default)('one-me:polling');
+const RETRY_INTERVAL = 5000; // ms
+class Polling {
+    constructor(api, allowedUpdates = []) {
+        this.api = api;
+        this.allowedUpdates = allowedUpdates;
+        this.abortController = new AbortController();
+        this.loop = async (handleUpdate) => {
+            debug('Starting long polling');
+            while (!this.abortController.signal.aborted) {
+                try {
+                    const { updates, marker } = await this.api.getUpdates(this.allowedUpdates, {
+                        marker: this.marker,
+                    });
+                    this.marker = marker;
+                    await Promise.all(updates.map(handleUpdate));
+                }
+                catch (err) {
+                    if (err instanceof Error) {
+                        if (err.name === 'AbortError')
+                            return;
+                        if (err.name === 'FetchError'
+                            || (err instanceof api_1.MaxError && err.status === 429)
+                            || (err instanceof api_1.MaxError && err.status >= 500)) {
+                            debug(`Failed to fetch updates, retrying after ${RETRY_INTERVAL}ms.`, err);
+                            await new Promise((resolve) => {
+                                setTimeout(resolve, RETRY_INTERVAL);
+                            });
+                            return;
+                        }
+                    }
+                    throw err;
+                }
+            }
+            debug('Long polling is done');
+        };
+        this.stop = () => {
+            debug('Stopping long polling');
+            this.abortController.abort();
+        };
+    }
+}
+exports.Polling = Polling;

package/dist/filters.d.ts

@@ -0,0 +1,2 @@
+import type { MessageBody, MessageCreatedUpdate, Update } from './core/network/api';
+export declare const createdMessageBodyHas: <Keys extends Array<keyof MessageBody>>(...keys: Keys) => (update: Update) => update is MessageCreatedUpdate;

package/dist/filters.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createdMessageBodyHas = void 0;
+const createdMessageBodyHas = (...keys) => {
+    return (update) => {
+        if (update.update_type !== 'message_created')
+            return false;
+        for (const key of keys) {
+            if (!(key in update.message.body))
+                return false;
+            if (update.message.body[key] === undefined)
+                return false;
+        }
+        return true;
+    };
+};
+exports.createdMessageBodyHas = createdMessageBodyHas;

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { Api } from './api';
+export { Bot } from './bot';
+export { Composer } from './composer';
+export { Context } from './context';
+export type { FilteredContext } from './context';
+export type { MiddlewareFn, Middleware, MiddlewareObj, NextFn, } from './middleware';
+export { AudioAttachment, FileAttachment, ImageAttachment, StickerAttachment, VideoAttachment, LocationAttachment, ShareAttachment, } from './core/helpers/attachments';
+export * as Keyboard from './core/helpers/keyboard';
+export { MaxError } from './core/network/api';

package/dist/index.js

@@ -0,0 +1,45 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaxError = exports.Keyboard = exports.ShareAttachment = exports.LocationAttachment = exports.VideoAttachment = exports.StickerAttachment = exports.ImageAttachment = exports.FileAttachment = exports.AudioAttachment = exports.Context = exports.Composer = exports.Bot = exports.Api = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "Api", { enumerable: true, get: function () { return api_1.Api; } });
+var bot_1 = require("./bot");
+Object.defineProperty(exports, "Bot", { enumerable: true, get: function () { return bot_1.Bot; } });
+var composer_1 = require("./composer");
+Object.defineProperty(exports, "Composer", { enumerable: true, get: function () { return composer_1.Composer; } });
+var context_1 = require("./context");
+Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return context_1.Context; } });
+var attachments_1 = require("./core/helpers/attachments");
+Object.defineProperty(exports, "AudioAttachment", { enumerable: true, get: function () { return attachments_1.AudioAttachment; } });
+Object.defineProperty(exports, "FileAttachment", { enumerable: true, get: function () { return attachments_1.FileAttachment; } });
+Object.defineProperty(exports, "ImageAttachment", { enumerable: true, get: function () { return attachments_1.ImageAttachment; } });
+Object.defineProperty(exports, "StickerAttachment", { enumerable: true, get: function () { return attachments_1.StickerAttachment; } });
+Object.defineProperty(exports, "VideoAttachment", { enumerable: true, get: function () { return attachments_1.VideoAttachment; } });
+Object.defineProperty(exports, "LocationAttachment", { enumerable: true, get: function () { return attachments_1.LocationAttachment; } });
+Object.defineProperty(exports, "ShareAttachment", { enumerable: true, get: function () { return attachments_1.ShareAttachment; } });
+exports.Keyboard = __importStar(require("./core/helpers/keyboard"));
+var api_2 = require("./core/network/api");
+Object.defineProperty(exports, "MaxError", { enumerable: true, get: function () { return api_2.MaxError; } });

package/dist/middleware.d.ts

@@ -0,0 +1,9 @@
+import { Context } from './context';
+type MaybePromise<T> = T | Promise<T>;
+export type NextFn = () => Promise<void>;
+export type MiddlewareFn<Ctx extends Context> = (ctx: Ctx, next: NextFn) => MaybePromise<unknown>;
+export interface MiddlewareObj<Ctx extends Context> {
+    middleware: () => MiddlewareFn<Ctx>;
+}
+export type Middleware<Ctx extends Context> = MiddlewareFn<Ctx> | MiddlewareObj<Ctx>;
+export {};

package/dist/middleware.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types.d.ts

@@ -0,0 +1 @@
+export * from './core/network/api/types';

package/dist/types.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./core/network/api/types"), exports);

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+import fs from 'node:fs';
+export declare const sleep: (ms: number) => Promise<void>;
+export declare const streamToBlob: (stream: fs.ReadStream, mimeType?: string) => Promise<Blob>;

package/dist/utils.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamToBlob = exports.sleep = void 0;
+const sleep = async (ms) => {
+    await new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+};
+exports.sleep = sleep;
+const streamToBlob = async (stream, mimeType) => {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        stream
+            .on('data', (chunk) => chunks.push(chunk))
+            .once('end', () => {
+            const blob = mimeType
+                ? new Blob(chunks, { type: mimeType })
+                : new Blob(chunks);
+            resolve(blob);
+        })
+            .once('error', reject);
+    });
+};
+exports.streamToBlob = streamToBlob;