@green-api/greenapi-integration 0.3.0 → 0.4.0

package/README.md

@@ -129,7 +129,7 @@ Handles message format conversion between GREEN-API and your platform.
 
 ```typescript
 abstract class MessageTransformer<TPlatformWebhook, TPlatformMessage> {
-	abstract toPlatformMessage(webhook: IncomingGreenApiWebhook): TPlatformMessage;
+	abstract toPlatformMessage(webhook: GreenApiWebhook): TPlatformMessage;
 
 	abstract toGreenApiMessage(message: TPlatformWebhook): Message;
 }
@@ -141,7 +141,7 @@ Interface for data persistence operations.
 
 ```typescript
 abstract class StorageProvider<TUser extends BaseUser = BaseUser, TInstance extends BaseInstance = Instance> {
-	abstract createInstance(instance: BaseInstance, userId: bigint | number, settings?: Settings): Promise<TInstance>;
+	abstract createInstance(instance: BaseInstance, userId: bigint | number): Promise<TInstance>;
 
 	abstract getInstance(idInstance: number | bigint): Promise<TInstance | null>;
 
@@ -285,11 +285,11 @@ Create a transformer that converts messages between your platform's format and G
 
 ```typescript
 // core/transformer.ts
-import { MessageTransformer, Message, IncomingGreenApiWebhook } from '@green-api/greenapi-integration';
+import { MessageTransformer, Message, GreenApiWebhook } from '@green-api/greenapi-integration';
 import { YourPlatformWebhook, YourPlatformMessage } from '../types/types';
 
 export class YourTransformer extends MessageTransformer<YourPlatformWebhook, YourPlatformMessage> {
-	toPlatformMessage(webhook: IncomingGreenApiWebhook): YourPlatformMessage {
+	toPlatformMessage(webhook: GreenApiWebhook): YourPlatformMessage {
 		// Transform GREEN-API webhook to your platform format
 		return {
 			recipient: webhook.senderData.sender,
@@ -314,7 +314,7 @@ Create a storage provider to manage users and instances. You can use any databas
 
 ```typescript
 // core/storage.ts
-import { StorageProvider, BaseUser, BaseInstance, Settings } from '@green-api/greenapi-integration';
+import { StorageProvider, BaseUser, Instance, Settings } from '@green-api/greenapi-integration';
 import { PrismaClient } from '@prisma/client'; // Or your database client
 
 export class YourStorage extends StorageProvider {
@@ -324,13 +324,13 @@ export class YourStorage extends StorageProvider {
 		this.db = new PrismaClient();
 	}
 
-	async createInstance(instance: BaseInstance, userId: bigint, settings?: Settings) {
+	async createInstance(instance: Instance, userId: bigint) {
 		return this.db.instance.create({
 			data: {
 				idInstance: instance.idInstance,
 				apiTokenInstance: instance.apiTokenInstance,
 				userId,
-				settings: settings || {},
+				settings: instance.settings || {},
 			},
 		});
 	}
@@ -357,7 +357,7 @@ export class YourAdapter extends BaseAdapter<YourPlatformWebhook, YourPlatformMe
 		});
 	}
 
-	async sendToPlatform(message: YourPlatformMessage, instance: BaseInstance) {
+	async sendToPlatform(message: YourPlatformMessage, instance: Instance) {
 		const client = await this.createPlatformClient(instance.config);
 		await client.sendMessage(message);
 	}
@@ -429,11 +429,12 @@ router.post('/instance', async (req, res) => {
 
 		const instance = await adapter.createInstance({
 			idInstance: Number(idInstance),
-			apiTokenInstance
-		}, {
-			webhookUrl: `${process.env.APP_URL}/webhook/green-api`,
-			webhookUrlToken: `token_${Date.now()}`, // In production, use a secure token generator
-			incomingWebhook: 'yes'
+			apiTokenInstance,
+			settings: {
+				webhookUrl: `${process.env.APP_URL}/webhook/green-api`,
+				webhookUrlToken: `token_${Date.now()}`,
+				incomingWebhook: 'yes'
+			}
 		}, userEmail);
 
 		res.status(200).json({
@@ -509,7 +510,7 @@ bootstrap();
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@green-api/greenapi-integration": "^1.0.0",
+    "@green-api/greenapi-integration": "^0.4.0",
     "express": "^4.18.2"
     // other dependencies
   }
@@ -593,23 +594,33 @@ interface SimplePlatformMessage {
 ### simple-transformer.ts
 
 ```typescript
-import { MessageTransformer, Message, IncomingGreenApiWebhook, formatPhoneNumber } from 'greenapi-integration';
+import {
+	MessageTransformer,
+	Message,
+	GreenApiWebhook,
+	formatPhoneNumber,
+	IntegrationError,
+} from "@green-api/greenapi-integration";
+import { SimplePlatformMessage, SimplePlatformWebhook } from "./types";
 
 export class SimpleTransformer extends MessageTransformer<SimplePlatformWebhook, SimplePlatformMessage> {
-	toPlatformMessage(webhook: IncomingGreenApiWebhook): SimplePlatformMessage {
-		if (webhook.messageData.typeMessage !== 'extendedTextMessage') {
-			throw new Error('Only text messages are supported');
-		}
+	toPlatformMessage(webhook: GreenApiWebhook): SimplePlatformMessage {
+		if (webhook.typeWebhook === "incomingMessageReceived") {
+			if (webhook.messageData.typeMessage !== "extendedTextMessage") {
+				throw new IntegrationError("Only text messages are supported", "BAD_REQUEST_ERROR", 400);
+			}
 
-		return {
-			to: webhook.senderData.sender,
-			content: webhook.messageData.extendedTextMessageData?.text || '',
-		};
+			return {
+				to: webhook.senderData.sender,
+				content: webhook.messageData.extendedTextMessageData?.text || "",
+			};
+		}
+		throw new IntegrationError("Only incomingMessageReceived type webhooks are supported", "INTEGRATION_ERROR", 500);
 	}
 
 	toGreenApiMessage(message: SimplePlatformWebhook): Message {
 		return {
-			type: 'text',
+			type: "text",
 			chatId: formatPhoneNumber(message.from),
 			message: message.text,
 		};
@@ -620,25 +631,24 @@ export class SimpleTransformer extends MessageTransformer<SimplePlatformWebhook,
 ### simple-storage.ts
 
 ```typescript
-import { StorageProvider, BaseUser, BaseInstance, Settings } from 'greenapi-integration';
+import { StorageProvider, BaseUser, Instance } from '@green-api/greenapi-integration';
 
 export class SimpleStorage extends StorageProvider {
 	private users: Map<string, BaseUser> = new Map();
-	private instances: Map<number, BaseInstance> = new Map();
+	private instances: Map<number, Instance> = new Map();
 
-	async createInstance(instance: BaseInstance, userId: bigint, settings?: Settings): Promise<BaseInstance> {
+	async createInstance(instance: Instance, userId: bigint): Promise<Instance> {
 		this.instances.set(Number(instance.idInstance), {
 			...instance,
-			settings: settings || {}
 		});
 		return instance;
 	}
 
-	async getInstance(idInstance: number): Promise<BaseInstance | null> {
+	async getInstance(idInstance: number): Promise<Instance | null> {
 		return this.instances.get(idInstance) || null;
 	}
 
-	async removeInstance(instanceId: number): Promise<BaseInstance> {
+	async removeInstance(instanceId: number): Promise<Instance> {
 		const instance = this.instances.get(instanceId);
 		if (!instance) throw new Error('Instance not found');
 		this.instances.delete(instanceId);
@@ -668,7 +678,8 @@ export class SimpleStorage extends StorageProvider {
 ### simple-adapter.ts
 
 ```typescript
-import { BaseAdapter, BaseInstance } from "greenapi-integration";
+import { BaseAdapter, Instance } from "@green-api/greenapi-integration";
+import { SimplePlatformMessage, SimplePlatformWebhook } from "./types";
 import axios from 'axios';
 
 export class SimpleAdapter extends BaseAdapter<SimplePlatformWebhook, SimplePlatformMessage> {
@@ -682,7 +693,7 @@ export class SimpleAdapter extends BaseAdapter<SimplePlatformWebhook, SimplePlat
 		});
 	}
 
-	async sendToPlatform(message: SimplePlatformMessage, instance: BaseInstance): Promise<void> {
+	async sendToPlatform(message: SimplePlatformMessage, instance: Instance): Promise<void> {
 		// In a real implementation, we would send to the platform
 		// For demo, we'll just log and simulate a response
 		console.log('Platform received message:', message);
@@ -712,7 +723,7 @@ export class SimpleAdapter extends BaseAdapter<SimplePlatformWebhook, SimplePlat
 ```typescript
 import express from "express";
 import bodyParser from "body-parser";
-import { formatPhoneNumber, GreenApiClient } from "greenapi-integration";
+import { formatPhoneNumber, GreenApiClient } from "@green-api/greenapi-integration";
 import { SimpleTransformer } from "./simple-transformer";
 import { SimpleStorage } from "./simple-storage";
 import { SimpleAdapter } from "./simple-adapter";
@@ -736,6 +747,7 @@ async function main() {
 		idInstance: Number(process.env.AGENT_ID_INSTANCE),
 		apiTokenInstance: process.env.AGENT_API_TOKEN!,
 	};
+	console.log(visitorInstance, agentInstance);
 
 	// Create visitor's GREEN-API client (for sending initial message)
 	const visitorClient = new GreenApiClient(visitorInstance);
@@ -747,10 +759,12 @@ async function main() {
 		name: "Agent",
 	});
 
-	const instance = await adapter.createInstance(agentInstance, {
-		webhookUrl: process.env.WEBHOOK_URL + "/webhook/green-api",
-		webhookUrlToken: "your-secure-token",
-		incomingWebhook: "yes",
+	const instance = await adapter.createInstance({
+		idInstance: agentInstance.idInstance, apiTokenInstance: agentInstance.apiTokenInstance, settings: {
+			webhookUrl: process.env.WEBHOOK_URL + "/webhook/green-api",
+			webhookUrlToken: "your-secure-token",
+			incomingWebhook: "yes",
+		},
 	}, user.email);
 
 	console.log("Waiting 2 minutes for settings to apply...");
@@ -774,7 +788,7 @@ async function main() {
 	});
 
 	// Start the server
-	const port = process.env.PORT || 3000;
+	const port = Number(process.env.PORT) || 3000;
 	app.listen(port, () => {
 		console.log(`Webhook server listening on port ${port}`);
 	});
@@ -817,7 +831,7 @@ The platform provides several utility functions:
 
 ```typescript
 // Format phone numbers for GREEN-API
-formatPhoneNumber('1234567890') // Returns '1234567890@c.us'
+formatPhoneNumber('+1234567890') // Returns '1234567890@c.us'
 
 // Generate secure random tokens
 generateRandomToken(32) // Returns a 32-character random token
@@ -825,6 +839,18 @@ generateRandomToken(32) // Returns a 32-character random token
 // Extract phone number from vcard
 const vcard = 'BEGIN:VCARD\nTEL:+1234567890\nEND:VCARD'
 extractPhoneNumberFromVCard(vcard) // Returns '+1234567890'
+
+// Validate settings values 
+isValidSettingValue('webhookUrl', 'https://example.com') // Returns true
+
+// Clean settings
+const input = {
+ webhookUrl: 'https://example.com',
+ outgoingWebhook: 'yes', 
+ invalidKey: 'value',
+ delaySendMessagesMilliseconds: 'invalid'
+}
+validateAndCleanSettings(input) // Returns { webhookUrl: 'https://example.com', outgoingWebhook: 'yes' }
 ```
 
 ## License

package/README.ru.md

@@ -128,7 +128,7 @@ app.post('/webhook/green-api', async (req, res) => {
 
 ```typescript
 abstract class MessageTransformer<TPlatformWebhook, TPlatformMessage> {
-	abstract toPlatformMessage(webhook: IncomingGreenApiWebhook): TPlatformMessage;
+	abstract toPlatformMessage(webhook: GreenApiWebhook): TPlatformMessage;
 
 	abstract toGreenApiMessage(message: TPlatformWebhook): Message;
 }
@@ -140,7 +140,7 @@ abstract class MessageTransformer<TPlatformWebhook, TPlatformMessage> {
 
 ```typescript
 abstract class StorageProvider<TUser extends BaseUser = BaseUser, TInstance extends BaseInstance = Instance> {
-	abstract createInstance(instance: BaseInstance, userId: bigint | number, settings?: Settings): Promise<TInstance>;
+	abstract createInstance(instance: BaseInstance, userId: bigint | number): Promise<TInstance>;
 
 	abstract getInstance(idInstance: number | bigint): Promise<TInstance | null>;
 
@@ -285,11 +285,11 @@ export interface YourPlatformMessage {
 
 ```typescript
 // core/transformer.ts
-import { MessageTransformer, Message, IncomingGreenApiWebhook } from '@green-api/greenapi-integration';
+import { MessageTransformer, Message, GreenApiWebhook } from '@green-api/greenapi-integration';
 import { YourPlatformWebhook, YourPlatformMessage } from '../types/types';
 
 export class YourTransformer extends MessageTransformer<YourPlatformWebhook, YourPlatformMessage> {
-	toPlatformMessage(webhook: IncomingGreenApiWebhook): YourPlatformMessage {
+	toPlatformMessage(webhook: GreenApiWebhook): YourPlatformMessage {
 		// Преобразование вебхука GREEN-API в формат вашей платформы
 		return {
 			recipient: webhook.senderData.sender,
@@ -315,7 +315,7 @@ ORM:
 
 ```typescript
 // core/storage.ts
-import { StorageProvider, BaseUser, BaseInstance, Settings } from '@green-api/greenapi-integration';
+import { StorageProvider, BaseUser, Instance, Settings } from '@green-api/greenapi-integration';
 import { PrismaClient } from '@prisma/client'; // Or your database client
 
 export class YourStorage extends StorageProvider {
@@ -325,13 +325,13 @@ export class YourStorage extends StorageProvider {
 		this.db = new PrismaClient();
 	}
 
-	async createInstance(instance: BaseInstance, userId: bigint, settings?: Settings) {
+	async createInstance(instance: Instance, userId: bigint) {
 		return this.db.instance.create({
 			data: {
 				idInstance: instance.idInstance,
 				apiTokenInstance: instance.apiTokenInstance,
 				userId,
-				settings: settings || {},
+				settings: instance.settings || {},
 			},
 		});
 	}
@@ -346,7 +346,7 @@ export class YourStorage extends StorageProvider {
 
 ```typescript
 // core/adapter.ts
-import { BaseAdapter, BaseInstance } from '@green-api/greenapi-integration';
+import { BaseAdapter, Instance } from '@green-api/greenapi-integration';
 import { YourPlatformClient } from 'your-platform-sdk';
 import { YourPlatformWebhook, YourPlatformMessage } from '../types/types';
 
@@ -358,7 +358,7 @@ export class YourAdapter extends BaseAdapter<YourPlatformWebhook, YourPlatformMe
 		});
 	}
 
-	async sendToPlatform(message: YourPlatformMessage, instance: BaseInstance) {
+	async sendToPlatform(message: YourPlatformMessage, instance: Instance) {
 		const client = await this.createPlatformClient(instance.config);
 		await client.sendMessage(message);
 	}
@@ -430,11 +430,12 @@ router.post('/instance', async (req, res) => {
 
 		const instance = await adapter.createInstance({
 			idInstance: Number(idInstance),
-			apiTokenInstance
-		}, {
-			webhookUrl: `${process.env.APP_URL}/webhook/green-api`,
-			webhookUrlToken: `token_${Date.now()}`, // В продакшене используйте безопасный генератор токенов
-			incomingWebhook: 'yes'
+			apiTokenInstance,
+			settings: {
+				webhookUrl: `${process.env.APP_URL}/webhook/green-api`,
+				webhookUrlToken: `token_${Date.now()}`,
+				incomingWebhook: 'yes'
+			}
 		}, userEmail);
 
 		res.status(200).json({
@@ -528,7 +529,7 @@ bootstrap();
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@green-api/greenapi-integration": "^1.0.0",
+    "@green-api/greenapi-integration": "^0.4.0",
     "@prisma/client": "^5.0.0",
     "express": "^4.18.2"
     // другие зависимости
@@ -614,18 +615,21 @@ interface SimplePlatformMessage {
 ### simple-transformer.ts
 
 ```typescript
-import { MessageTransformer, Message, IncomingGreenApiWebhook, formatPhoneNumber } from 'greenapi-integration';
+import { MessageTransformer, Message, GreenApiWebhook, formatPhoneNumber, IntegrationError } from '@green-api/greenapi-integration';
 
 export class SimpleTransformer extends MessageTransformer<SimplePlatformWebhook, SimplePlatformMessage> {
-	toPlatformMessage(webhook: IncomingGreenApiWebhook): SimplePlatformMessage {
-		if (webhook.messageData.typeMessage !== 'extendedTextMessage') {
-			throw new Error('Поддерживаются только текстовые сообщения');
-		}
+	toPlatformMessage(webhook: GreenApiWebhook): SimplePlatformMessage {
+		if (webhook.typeWebhook === "incomingMessageReceived") {
+			if (webhook.messageData.typeMessage !== "extendedTextMessage") {
+				throw new IntegrationError("Поддерживаются только текстовые сообщения", "BAD_REQUEST_ERROR", 400);
+			}
 
-		return {
-			to: webhook.senderData.sender,
-			content: webhook.messageData.extendedTextMessageData?.text || '',
-		};
+			return {
+				to: webhook.senderData.sender,
+				content: webhook.messageData.extendedTextMessageData?.text || "",
+			};
+		}
+		throw new IntegrationError("Поддерживаются только вебхуки вида incomingMessageReceived", "INTEGRATION_ERROR", 500);
 	}
 
 	toGreenApiMessage(message: SimplePlatformWebhook): Message {
@@ -641,25 +645,24 @@ export class SimpleTransformer extends MessageTransformer<SimplePlatformWebhook,
 ### simple-storage.ts
 
 ```typescript
-import { StorageProvider, BaseUser, BaseInstance, Settings } from 'greenapi-integration';
+import { StorageProvider, BaseUser, Instance, Settings } from '@green-api/greenapi-integration';
 
 export class SimpleStorage extends StorageProvider {
 	private users: Map<string, BaseUser> = new Map();
-	private instances: Map<number, BaseInstance> = new Map();
+	private instances: Map<number, Instance> = new Map();
 
-	async createInstance(instance: BaseInstance, userId: bigint, settings?: Settings): Promise<BaseInstance> {
+	async createInstance(instance: Instance, userId: bigint): Promise<Instance> {
 		this.instances.set(Number(instance.idInstance), {
 			...instance,
-			settings: settings || {}
 		});
 		return instance;
 	}
 
-	async getInstance(idInstance: number): Promise<BaseInstance | null> {
+	async getInstance(idInstance: number): Promise<Instance | null> {
 		return this.instances.get(idInstance) || null;
 	}
 
-	async removeInstance(instanceId: number): Promise<BaseInstance> {
+	async removeInstance(instanceId: number): Promise<Instance> {
 		const instance = this.instances.get(instanceId);
 		if (!instance) throw new Error('Инстанс не найден');
 		this.instances.delete(instanceId);
@@ -689,7 +692,7 @@ export class SimpleStorage extends StorageProvider {
 ### simple-adapter.ts
 
 ```typescript
-import { BaseAdapter, BaseInstance } from "greenapi-integration";
+import { BaseAdapter, Instance } from "@green-api/greenapi-integration";
 import axios from 'axios';
 
 export class SimpleAdapter extends BaseAdapter<SimplePlatformWebhook, SimplePlatformMessage> {
@@ -703,7 +706,7 @@ export class SimpleAdapter extends BaseAdapter<SimplePlatformWebhook, SimplePlat
 		});
 	}
 
-	async sendToPlatform(message: SimplePlatformMessage, instance: BaseInstance): Promise<void> {
+	async sendToPlatform(message: SimplePlatformMessage, instance: Instance): Promise<void> {
 		// В реальной реализации мы бы отправляли сообщение на платформу
 		// Для демонстрации просто логируем и симулируем ответ
 		console.log('Платформа получила сообщение:', message);
@@ -733,7 +736,7 @@ export class SimpleAdapter extends BaseAdapter<SimplePlatformWebhook, SimplePlat
 ```typescript
 import express from "express";
 import bodyParser from "body-parser";
-import { formatPhoneNumber, GreenApiClient } from "greenapi-integration";
+import { formatPhoneNumber, GreenApiClient } from "@green-api/greenapi-integration";
 import { SimpleTransformer } from "./simple-transformer";
 import { SimpleStorage } from "./simple-storage";
 import { SimpleAdapter } from "./simple-adapter";
@@ -768,10 +771,12 @@ async function main() {
 		name: "Agent",
 	});
 
-	const instance = await adapter.createInstance(agentInstance, {
-		webhookUrl: process.env.WEBHOOK_URL + "/webhook/green-api",
-		webhookUrlToken: "your-secure-token",
-		incomingWebhook: "yes",
+	const instance = await adapter.createInstance({
+		idInstance: agentInstance.idInstance, apiTokenInstance: agentInstance.apiTokenInstance, settings: {
+			webhookUrl: process.env.WEBHOOK_URL + "/webhook/green-api",
+			webhookUrlToken: "your-secure-token",
+			incomingWebhook: "yes",
+		},
 	}, user.email);
 
 	console.log("Ожидание 2 минуты для применения настроек...");
@@ -795,7 +800,7 @@ async function main() {
 	});
 
 	// Запуск сервера
-	const port = process.env.PORT || 3000;
+	const port = Number(process.env.PORT) || 3000;
 	app.listen(port, () => {
 		console.log(`Сервер вебхуков запущен на порту ${port}`);
 	});
@@ -838,7 +843,7 @@ PORT=3000
 
 ```typescript
 // Форматирование телефонных номеров для GREEN-API
-formatPhoneNumber('1234567890') // Возвращает '1234567890@c.us'
+formatPhoneNumber('+1234567890') // Возвращает '1234567890@c.us'
 
 // Генерация безопасных случайных токенов
 generateRandomToken(32) // Возвращает 32-символьный случайный токен
@@ -846,6 +851,18 @@ generateRandomToken(32) // Возвращает 32-символьный случ
 // Извлечение номера телефона из vcard
 const vcard = 'BEGIN:VCARD\nTEL:+1234567890\nEND:VCARD'
 extractPhoneNumberFromVCard(vcard) // Возвращает '+1234567890'
+
+// Проверка значений настроек
+isValidSettingValue('webhookUrl', 'https://example.com') // Возвращает true
+
+// Очистка настроек
+const input = {
+	webhookUrl: 'https://example.com',
+	outgoingWebhook: 'yes',
+	invalidKey: 'value',
+	delaySendMessagesMilliseconds: 'invalid'
+}
+validateAndCleanSettings(input) // Возвращает { webhookUrl: 'https://example.com', outgoingWebhook: 'yes' }
 ```
 
 ## Лицензия

package/dist/core/green-api.client.d.ts

@@ -1,7 +1,8 @@
-import { Instance, Settings, SendMessage, SendFileByUrl, SendFileByUpload, SendPoll, StateInstance, Reboot, Logout, QR, SendResponse, SendFileByUploadResponse, SetSettingsResponse, GetAuthorizationCode, SetProfilePicture, WaSettings, UploadFile, SendLocation, SendContact, ForwardMessages, ForwardMessagesResponse } from "../types/types";
+import { Instance, Settings, SendMessage, SendFileByUrl, SendFileByUpload, SendPoll, StateInstance, Reboot, Logout, QR, SendResponse, SendFileByUploadResponse, SetSettingsResponse, GetAuthorizationCode, SetProfilePicture, WaSettings, UploadFile, SendLocation, SendContact, ForwardMessages, ForwardMessagesResponse, QueueMessage, ClearMessagesQueue, ReadChatResponse, ReadChat, CheckWhatsapp, CheckWhatsappResponse, GetAvatarResponse, GetAvatar, Contact, ContactInfo, ArchiveChat, UnarchiveChat, SetDisappearingChat, SetDisappearingChatResponse, CreateGroupResponse, CreateGroup, UpdateGroupName, UpdateGroupNameResponse, GetGroupData, GroupData, AddGroupParticipant, AddGroupParticipantResponse, RemoveGroupParticipant, RemoveGroupParticipantResponse, SetGroupAdmin, SetGroupAdminResponse, RemoveAdminResponse, RemoveAdmin, SetGroupPicture, SetGroupPictureResponse, LeaveGroup, LeaveGroupResponse, GetMessage, JournalResponse, GetChatHistory, IncomingJournalResponse, OutgoingJournalResponse } from "../types/types";
 /**
  * Client for direct interaction with GREEN-API's WhatsApp gateway.
  * Provides methods for sending messages, managing instances, and handling files.
+ * For more information about the methods, refer to https://green-api.com/en/docs
  *
  * @category Client
  *
@@ -213,4 +214,227 @@ export declare class GreenApiClient {
      * @throws {Error} If phone number is not an integer
      */
     getAuthorizationCode(phoneNumber: number): Promise<GetAuthorizationCode>;
+    /**
+     * Gets the list of messages in the sending queue.
+     * Messages are stored for 24 hours and will be sent immediately after phone authorization.
+     * The sending speed is regulated by the Message Sending Interval parameter.
+     *
+     * @returns Promise resolving to an array of queued messages
+     *
+     * @example
+     * ```typescript
+     * const queuedMessages = await client.showMessagesQueue();
+     * console.log(queuedMessages);
+     * ```
+     */
+    showMessagesQueue(): Promise<QueueMessage[]>;
+    /**
+     * Clears the queue of messages waiting to be sent.
+     * Important when switching phone numbers to prevent sending queued messages with the new number.
+     *
+     * @returns Promise resolving to queue clearing status
+     *
+     * @example
+     * ```typescript
+     * const result = await client.clearMessagesQueue();
+     * if (result.isCleared) {
+     *   console.log('Queue successfully cleared');
+     * }
+     * ```
+     */
+    clearMessagesQueue(): Promise<ClearMessagesQueue>;
+    /**
+     * Marks messages in a chat as read.
+     * For this to work, "Receive webhooks on incoming messages and files" setting must be enabled.
+     * Note: Only messages received after enabling the setting can be marked as read.
+     *
+     * @param params - Parameters specifying which messages to mark as read
+     * @returns Promise resolving to read status
+     *
+     * @example
+     * ```typescript
+     * // Mark all messages in chat as read
+     * const result = await client.readChat({
+     *   chatId: "1234567890@c.us"
+     * });
+     *
+     * // Mark specific message as read
+     * const result = await client.readChat({
+     *   chatId: "1234567890@c.us",
+     *   idMessage: "B275A7AA0D6EF89BB9245169BDF174E6"
+     * });
+     * ```
+     */
+    readChat(params: ReadChat): Promise<ReadChatResponse>;
+    /**
+     * Checks WhatsApp account availability on a phone number.
+     *
+     * @param params - Parameters containing the phone number to check
+     * @returns Promise resolving to WhatsApp availability status
+     * @throws {Error} If phone number is not an integer or not 11-12 digits
+     *
+     * @example
+     * ```typescript
+     * const result = await client.checkWhatsapp({
+     *   phoneNumber: 11001234567
+     * });
+     *
+     * if (result.existsWhatsapp) {
+     *   console.log('WhatsApp account exists');
+     * }
+     * ```
+     */
+    checkWhatsapp(params: CheckWhatsapp): Promise<CheckWhatsappResponse>;
+    /**
+     * Gets a user or group chat avatar.
+     *
+     * @param params - Parameters containing the chat ID
+     * @returns Promise resolving to avatar information
+     */
+    getAvatar(params: GetAvatar): Promise<GetAvatarResponse>;
+    /**
+     * Gets a list of the current account contacts.
+     * Note: Contact information updates can take up to 5 minutes.
+     * If an empty array is received, retry the method call.
+     *
+     * @returns Promise resolving to array of contacts
+     */
+    getContacts(): Promise<Contact[]>;
+    /**
+     * Gets detailed information about a contact.
+     * Note: This method does not support group chats, use getGroupData for groups.
+     *
+     * @param params - Parameters containing the chat ID
+     * @returns Promise resolving to contact information
+     */
+    getContactInfo(params: GetAvatar): Promise<ContactInfo>;
+    /**
+     * Archives a chat. Chat must have at least one incoming message.
+     * Note: "Receive webhooks on incoming messages and files" setting must be enabled.
+     *
+     * @param params - Parameters containing the chat ID to archive
+     * @returns Promise resolving to void on success
+     */
+    archiveChat(params: ArchiveChat): Promise<void>;
+    /**
+     * Unarchives a chat.
+     *
+     * @param params - Parameters containing the chat ID to unarchive
+     * @returns Promise resolving to void on success
+     */
+    unarchiveChat(params: UnarchiveChat): Promise<void>;
+    /**
+     * Changes settings of disappearing messages in chats.
+     * Valid expiration times: 0 (off), 86400 (24h), 604800 (7d), 7776000 (90d)
+     *
+     * @param params - Parameters containing chat ID and message expiration time
+     * @returns Promise resolving to chat disappearing message settings
+     */
+    setDisappearingChat(params: SetDisappearingChat): Promise<SetDisappearingChatResponse>;
+    /**
+     * Creates a group chat.
+     * Note: Limited to creating 1 group per 5 minutes to simulate human behavior.
+     *
+     * @param params - Parameters containing group name and participant IDs
+     * @returns Promise resolving to group creation result
+     */
+    createGroup(params: CreateGroup): Promise<CreateGroupResponse>;
+    /**
+     * Changes a group chat name.
+     *
+     * @param params - Parameters containing group ID and new name
+     * @returns Promise resolving to update status
+     */
+    updateGroupName(params: UpdateGroupName): Promise<UpdateGroupNameResponse>;
+    /**
+     * Gets group chat data.
+     * Note: groupInviteLink will be empty if user is not an admin or owner.
+     *
+     * @param params - Parameters containing group ID
+     * @returns Promise resolving to group data
+     */
+    getGroupData(params: GetGroupData): Promise<GroupData>;
+    /**
+     * Adds a participant to a group chat.
+     * Note: Only group administrators can add members.
+     * The participant's number should be saved in the phonebook for reliable addition.
+     *
+     * @param params - Parameters containing group ID and participant ID
+     * @returns Promise resolving to addition status
+     */
+    addGroupParticipant(params: AddGroupParticipant): Promise<AddGroupParticipantResponse>;
+    /**
+     * Removes a participant from a group chat.
+     *
+     * @param params - Parameters containing group ID and participant ID to remove
+     * @returns Promise resolving to removal status
+     */
+    removeGroupParticipant(params: RemoveGroupParticipant): Promise<RemoveGroupParticipantResponse>;
+    /**
+     * Sets a group chat participant as an administrator.
+     *
+     * @param params - Parameters containing group ID and participant ID to promote
+     * @returns Promise resolving to admin status change result
+     */
+    setGroupAdmin(params: SetGroupAdmin): Promise<SetGroupAdminResponse>;
+    /**
+     * Removes administrator rights from a group chat participant.
+     *
+     * @param params - Parameters containing group ID and participant ID to demote
+     * @returns Promise resolving to admin removal status
+     */
+    removeAdmin(params: RemoveAdmin): Promise<RemoveAdminResponse>;
+    /**
+     * Sets a group chat picture.
+     *
+     * @param params - Parameters containing group ID and picture file (jpg)
+     * @returns Promise resolving to picture update status
+     */
+    setGroupPicture(params: SetGroupPicture): Promise<SetGroupPictureResponse>;
+    /**
+     * Makes the current account leave a group chat.
+     *
+     * @param params - Parameters containing the group ID to leave
+     * @returns Promise resolving to leave status
+     */
+    leaveGroup(params: LeaveGroup): Promise<LeaveGroupResponse>;
+    /**
+     * Gets details of a specific message.
+     * Note: To receive incoming webhooks, requires "Receive webhooks on incoming messages and files" setting to be enabled.
+     * Note: To receive statuses of sent messsages, requires "Receive notifications about the statuses of sent messages" to be enabled.
+     * Messages can take up to 2 minutes to appear in the journal.
+     *
+     * @param params - Parameters containing chat ID and message ID
+     * @returns Promise resolving to message details
+     */
+    getMessage(params: GetMessage): Promise<JournalResponse>;
+    /**
+     * Gets chat message history.
+     * Note: Requires "Receive webhooks" setting to be enabled.
+     * Messages can take up to 2 minutes to appear in history.
+     *
+     * @param params - Parameters containing chat ID and optional message count
+     * @returns Promise resolving to array of messages
+     */
+    getChatHistory(params: GetChatHistory): Promise<JournalResponse[]>;
+    /**
+     * Gets last incoming messages for the specified time period.
+     * Default is 24 hours (1440 minutes).
+     * Note: Requires "Receive webhooks" setting to be enabled.
+     * Messages can take up to 2 minutes to appear in history.
+     *
+     * @param minutes - Optional time period in minutes
+     * @returns Promise resolving to array of incoming messages
+     */
+    lastIncomingMessages(minutes?: number): Promise<IncomingJournalResponse[]>;
+    /**
+     * Gets last outgoing messages for the specified time period.
+     * Default is 24 hours (1440 minutes).
+     * Note: Requires "Receive webhooks" setting to be enabled.
+     * Messages can take up to 2 minutes to appear in history.
+     *
+     * @param minutes - Optional time period in minutes
+     * @returns Promise resolving to array of outgoing messages
+     */
+    lastOutgoingMessages(minutes?: number): Promise<OutgoingJournalResponse[]>;
 }

package/dist/core/green-api.client.js

@@ -8,6 +8,7 @@ const axios_1 = __importDefault(require("axios"));
 /**
  * Client for direct interaction with GREEN-API's WhatsApp gateway.
  * Provides methods for sending messages, managing instances, and handling files.
+ * For more information about the methods, refer to https://green-api.com/en/docs
  *
  * @category Client
  *
@@ -43,11 +44,12 @@ class GreenApiClient {
     buildEndpoint(endpoint) {
         return `/${endpoint}/${this.instance.apiTokenInstance}`;
     }
-    async makeRequest(method, endpoint, data, config) {
+    async makeRequest(method, endpoint, data, queryParams, config) {
         try {
+            const url = this.buildEndpoint(endpoint) + (queryParams ? "?" + new URLSearchParams(Object.entries(queryParams).map(([key, value]) => [key, value.toString()])).toString() : "");
             const response = await (method === "get"
-                ? this.client.get(this.buildEndpoint(endpoint), config)
-                : this.client.post(this.buildEndpoint(endpoint), data, config));
+                ? this.client.get(url, config)
+                : this.client.post(url, data, config));
             return response.data;
         }
         catch (error) {
@@ -55,7 +57,7 @@ class GreenApiClient {
         }
     }
     async makeFileUploadRequest(endpoint, formData, headers) {
-        return this.makeRequest("post", endpoint, formData, {
+        return this.makeRequest("post", endpoint, formData, undefined, {
             headers: { "Content-Type": "multipart/form-data" },
             ...headers,
         });
@@ -334,5 +336,284 @@ class GreenApiClient {
         }
         return this.makeRequest("post", "getAuthorizationCode", { phoneNumber });
     }
+    /**
+     * Gets the list of messages in the sending queue.
+     * Messages are stored for 24 hours and will be sent immediately after phone authorization.
+     * The sending speed is regulated by the Message Sending Interval parameter.
+     *
+     * @returns Promise resolving to an array of queued messages
+     *
+     * @example
+     * ```typescript
+     * const queuedMessages = await client.showMessagesQueue();
+     * console.log(queuedMessages);
+     * ```
+     */
+    async showMessagesQueue() {
+        return this.makeRequest("get", "showMessagesQueue");
+    }
+    /**
+     * Clears the queue of messages waiting to be sent.
+     * Important when switching phone numbers to prevent sending queued messages with the new number.
+     *
+     * @returns Promise resolving to queue clearing status
+     *
+     * @example
+     * ```typescript
+     * const result = await client.clearMessagesQueue();
+     * if (result.isCleared) {
+     *   console.log('Queue successfully cleared');
+     * }
+     * ```
+     */
+    async clearMessagesQueue() {
+        return this.makeRequest("get", "clearMessagesQueue");
+    }
+    /**
+     * Marks messages in a chat as read.
+     * For this to work, "Receive webhooks on incoming messages and files" setting must be enabled.
+     * Note: Only messages received after enabling the setting can be marked as read.
+     *
+     * @param params - Parameters specifying which messages to mark as read
+     * @returns Promise resolving to read status
+     *
+     * @example
+     * ```typescript
+     * // Mark all messages in chat as read
+     * const result = await client.readChat({
+     *   chatId: "1234567890@c.us"
+     * });
+     *
+     * // Mark specific message as read
+     * const result = await client.readChat({
+     *   chatId: "1234567890@c.us",
+     *   idMessage: "B275A7AA0D6EF89BB9245169BDF174E6"
+     * });
+     * ```
+     */
+    async readChat(params) {
+        return this.makeRequest("post", "readChat", params);
+    }
+    /**
+     * Checks WhatsApp account availability on a phone number.
+     *
+     * @param params - Parameters containing the phone number to check
+     * @returns Promise resolving to WhatsApp availability status
+     * @throws {Error} If phone number is not an integer or not 11-12 digits
+     *
+     * @example
+     * ```typescript
+     * const result = await client.checkWhatsapp({
+     *   phoneNumber: 11001234567
+     * });
+     *
+     * if (result.existsWhatsapp) {
+     *   console.log('WhatsApp account exists');
+     * }
+     * ```
+     */
+    async checkWhatsapp(params) {
+        const phoneStr = params.phoneNumber.toString();
+        if (!Number.isInteger(params.phoneNumber)) {
+            throw new Error("Phone number must contain only digits");
+        }
+        if (phoneStr.length < 11 || phoneStr.length > 12) {
+            throw new Error("Phone number must be 11 or 12 digits");
+        }
+        return this.makeRequest("post", "checkWhatsapp", params);
+    }
+    /**
+     * Gets a user or group chat avatar.
+     *
+     * @param params - Parameters containing the chat ID
+     * @returns Promise resolving to avatar information
+     */
+    async getAvatar(params) {
+        return this.makeRequest("post", "getAvatar", params);
+    }
+    /**
+     * Gets a list of the current account contacts.
+     * Note: Contact information updates can take up to 5 minutes.
+     * If an empty array is received, retry the method call.
+     *
+     * @returns Promise resolving to array of contacts
+     */
+    async getContacts() {
+        return this.makeRequest("get", "getContacts");
+    }
+    /**
+     * Gets detailed information about a contact.
+     * Note: This method does not support group chats, use getGroupData for groups.
+     *
+     * @param params - Parameters containing the chat ID
+     * @returns Promise resolving to contact information
+     */
+    async getContactInfo(params) {
+        return this.makeRequest("post", "getContactInfo", params);
+    }
+    /**
+     * Archives a chat. Chat must have at least one incoming message.
+     * Note: "Receive webhooks on incoming messages and files" setting must be enabled.
+     *
+     * @param params - Parameters containing the chat ID to archive
+     * @returns Promise resolving to void on success
+     */
+    async archiveChat(params) {
+        return this.makeRequest("post", "archiveChat", params);
+    }
+    /**
+     * Unarchives a chat.
+     *
+     * @param params - Parameters containing the chat ID to unarchive
+     * @returns Promise resolving to void on success
+     */
+    async unarchiveChat(params) {
+        return this.makeRequest("post", "unarchiveChat", params);
+    }
+    /**
+     * Changes settings of disappearing messages in chats.
+     * Valid expiration times: 0 (off), 86400 (24h), 604800 (7d), 7776000 (90d)
+     *
+     * @param params - Parameters containing chat ID and message expiration time
+     * @returns Promise resolving to chat disappearing message settings
+     */
+    async setDisappearingChat(params) {
+        return this.makeRequest("post", "setDisappearingChat", params);
+    }
+    /**
+     * Creates a group chat.
+     * Note: Limited to creating 1 group per 5 minutes to simulate human behavior.
+     *
+     * @param params - Parameters containing group name and participant IDs
+     * @returns Promise resolving to group creation result
+     */
+    async createGroup(params) {
+        return this.makeRequest("post", "createGroup", params);
+    }
+    /**
+     * Changes a group chat name.
+     *
+     * @param params - Parameters containing group ID and new name
+     * @returns Promise resolving to update status
+     */
+    async updateGroupName(params) {
+        return this.makeRequest("post", "updateGroupName", params);
+    }
+    /**
+     * Gets group chat data.
+     * Note: groupInviteLink will be empty if user is not an admin or owner.
+     *
+     * @param params - Parameters containing group ID
+     * @returns Promise resolving to group data
+     */
+    async getGroupData(params) {
+        return this.makeRequest("post", "getGroupData", params);
+    }
+    /**
+     * Adds a participant to a group chat.
+     * Note: Only group administrators can add members.
+     * The participant's number should be saved in the phonebook for reliable addition.
+     *
+     * @param params - Parameters containing group ID and participant ID
+     * @returns Promise resolving to addition status
+     */
+    async addGroupParticipant(params) {
+        return this.makeRequest("post", "addGroupParticipant", params);
+    }
+    /**
+     * Removes a participant from a group chat.
+     *
+     * @param params - Parameters containing group ID and participant ID to remove
+     * @returns Promise resolving to removal status
+     */
+    async removeGroupParticipant(params) {
+        return this.makeRequest("post", "removeGroupParticipant", params);
+    }
+    /**
+     * Sets a group chat participant as an administrator.
+     *
+     * @param params - Parameters containing group ID and participant ID to promote
+     * @returns Promise resolving to admin status change result
+     */
+    async setGroupAdmin(params) {
+        return this.makeRequest("post", "setGroupAdmin", params);
+    }
+    /**
+     * Removes administrator rights from a group chat participant.
+     *
+     * @param params - Parameters containing group ID and participant ID to demote
+     * @returns Promise resolving to admin removal status
+     */
+    async removeAdmin(params) {
+        return this.makeRequest("post", "removeAdmin", params);
+    }
+    /**
+     * Sets a group chat picture.
+     *
+     * @param params - Parameters containing group ID and picture file (jpg)
+     * @returns Promise resolving to picture update status
+     */
+    async setGroupPicture(params) {
+        const formData = new FormData();
+        formData.append("file", params.file);
+        formData.append("groupId", params.groupId);
+        return this.makeFileUploadRequest("setGroupPicture", formData);
+    }
+    /**
+     * Makes the current account leave a group chat.
+     *
+     * @param params - Parameters containing the group ID to leave
+     * @returns Promise resolving to leave status
+     */
+    async leaveGroup(params) {
+        return this.makeRequest("post", "leaveGroup", params);
+    }
+    /**
+     * Gets details of a specific message.
+     * Note: To receive incoming webhooks, requires "Receive webhooks on incoming messages and files" setting to be enabled.
+     * Note: To receive statuses of sent messsages, requires "Receive notifications about the statuses of sent messages" to be enabled.
+     * Messages can take up to 2 minutes to appear in the journal.
+     *
+     * @param params - Parameters containing chat ID and message ID
+     * @returns Promise resolving to message details
+     */
+    async getMessage(params) {
+        return this.makeRequest("post", "getMessage", params);
+    }
+    /**
+     * Gets chat message history.
+     * Note: Requires "Receive webhooks" setting to be enabled.
+     * Messages can take up to 2 minutes to appear in history.
+     *
+     * @param params - Parameters containing chat ID and optional message count
+     * @returns Promise resolving to array of messages
+     */
+    async getChatHistory(params) {
+        return this.makeRequest("post", "getChatHistory", params);
+    }
+    /**
+     * Gets last incoming messages for the specified time period.
+     * Default is 24 hours (1440 minutes).
+     * Note: Requires "Receive webhooks" setting to be enabled.
+     * Messages can take up to 2 minutes to appear in history.
+     *
+     * @param minutes - Optional time period in minutes
+     * @returns Promise resolving to array of incoming messages
+     */
+    async lastIncomingMessages(minutes) {
+        return this.makeRequest("get", "lastIncomingMessages", undefined, minutes ? { minutes } : undefined);
+    }
+    /**
+     * Gets last outgoing messages for the specified time period.
+     * Default is 24 hours (1440 minutes).
+     * Note: Requires "Receive webhooks" setting to be enabled.
+     * Messages can take up to 2 minutes to appear in history.
+     *
+     * @param minutes - Optional time period in minutes
+     * @returns Promise resolving to array of outgoing messages
+     */
+    async lastOutgoingMessages(minutes) {
+        return this.makeRequest("get", "lastOutgoingMessages", undefined, minutes ? { minutes } : undefined);
+    }
 }
 exports.GreenApiClient = GreenApiClient;

package/dist/types/types.d.ts

@@ -2,7 +2,7 @@
  * Base interface for GREEN-API WhatsApp instances.
  * Contains the essential credentials needed to interact with the API.
  */
-interface BaseInstance {
+export interface BaseInstance {
     idInstance: number | bigint;
     apiTokenInstance: string;
     stateInstance?: InstanceState;
@@ -22,6 +22,7 @@ export interface Instance extends BaseInstance {
 export type Message = ({
     type: "text";
     message: string;
+    linkPreview?: boolean;
 } & BaseMessage) | ({
     type: "upload-file";
     caption?: string;
@@ -97,7 +98,57 @@ export type SendPoll = Extract<Message, {
 export type ForwardMessages = Extract<Message, {
     type: "forward";
 }>;
-export type MessageType = "textMessage" | "extendedTextMessage" | "imageMessage" | "videoMessage" | "documentMessage" | "audioMessage" | "contactMessage" | "locationMessage" | "pollMessage";
+export type QueueMessageType = "sendMessage" | "sendPoll" | "sendFileByUrl" | "sendLocation" | "sendContact" | "ForwardMessages";
+export type QueueMessageBody = SendMessage | SendPoll | SendFileByUrl | SendLocation | SendContact | ForwardMessages;
+export interface QueueMessage {
+    messageID?: string;
+    messagesIDs?: string[];
+    type: QueueMessageType;
+    body: QueueMessageBody;
+}
+export interface ClearMessagesQueue {
+    isCleared: boolean;
+}
+export type MessageType = "textMessage" | "extendedTextMessage" | "imageMessage" | "videoMessage" | "documentMessage" | "audioMessage" | "contactMessage" | "locationMessage" | "pollMessage" | "reactionMessage" | "pollUpdateMessage" | "quotedMessage" | "stickerMessage";
+export interface GetMessage {
+    chatId: string;
+    idMessage: string;
+}
+export interface GetChatHistory {
+    chatId: string;
+    count?: number;
+}
+export interface BaseJournalMessage {
+    idMessage: string;
+    timestamp: number;
+    typeMessage: MessageType;
+    chatId: string;
+    isForwarded: boolean;
+    forwardingScore: number;
+}
+export interface IncomingJournalFields {
+    type: "incoming";
+    senderId: string;
+    senderName: string;
+    senderContactName: string;
+}
+export interface OutgoingJournalFields {
+    type: "outgoing";
+    statusMessage: OutgoingMessageStatus;
+    sendByApi: boolean;
+}
+export type BaseIncomingJournalMessage = BaseJournalMessage & IncomingJournalFields;
+export type BaseOutgoingJournalMessage = BaseJournalMessage & OutgoingJournalFields;
+export type BaseJournalResponse = BaseIncomingJournalMessage | BaseOutgoingJournalMessage;
+export type OutgoingJournalResponse = BaseOutgoingJournalMessage & WebhookMessageData & {
+    quotedMessage?: QuotedMessage;
+};
+export type IncomingJournalResponse = BaseIncomingJournalMessage & WebhookMessageData & {
+    quotedMessage?: QuotedMessage;
+};
+export type JournalResponse = BaseJournalResponse & WebhookMessageData & {
+    quotedMessage?: QuotedMessage;
+};
 export interface ForwardableMessage {
     forwardingScore: number;
     isForwarded: boolean;
@@ -274,6 +325,83 @@ export interface Reboot {
 export interface Logout {
     isLogout: boolean;
 }
+export interface ReadChat {
+    chatId: string;
+    idMessage?: string;
+}
+export interface ReadChatResponse {
+    setRead: boolean;
+}
+export interface CheckWhatsapp {
+    phoneNumber: number;
+}
+export interface CheckWhatsappResponse {
+    existsWhatsapp: boolean;
+}
+export interface GetAvatar {
+    chatId: string;
+}
+export interface GetAvatarResponse {
+    urlAvatar: string;
+    available: boolean;
+}
+export type ContactType = "user" | "group";
+export interface Contact {
+    id: string;
+    name: string;
+    contactName: string;
+    type: ContactType;
+}
+export interface ProductImageUrls {
+    requested: string;
+    original: string;
+}
+export interface ProductReviewStatus {
+    whatsapp: string;
+}
+export interface Product {
+    id: string;
+    imageUrls: ProductImageUrls;
+    reviewStatus: ProductReviewStatus;
+    availability: string;
+    name: string;
+    description?: string;
+    price: string | null;
+    isHidden: boolean;
+}
+export interface ContactInfo {
+    avatar: string;
+    name: string;
+    contactName: string;
+    email: string;
+    category: string;
+    description: string;
+    products: Product[];
+    chatId: string;
+    lastSeen: string | null;
+    isArchive: boolean;
+    isDisappearing: boolean;
+    isMute: boolean;
+    messageExpiration: number;
+    muteExpiration: number | null;
+    isBusiness: boolean;
+}
+export interface ArchiveChat {
+    chatId: string;
+}
+export interface UnarchiveChat {
+    chatId: string;
+}
+export type EphemeralExpiration = 0 | 86400 | 604800 | 7776000;
+export interface SetDisappearingChat {
+    chatId: string;
+    ephemeralExpiration: EphemeralExpiration;
+}
+export interface SetDisappearingChatResponse {
+    chatId: string;
+    disappearingMessagesInChat: boolean;
+    ephemeralExpiration: EphemeralExpiration;
+}
 /**
  * Represents an instance state in the GREEN-API system.
  */
@@ -313,6 +441,84 @@ export interface SetProfilePicture {
     urlAvatar: string;
     setProfilePicture: boolean;
 }
+export interface CreateGroup {
+    groupName: string;
+    chatIds: string[];
+}
+export interface CreateGroupResponse {
+    created: boolean;
+    chatId: string;
+    groupInviteLink: string;
+}
+export interface UpdateGroupName {
+    groupId: string;
+    groupName: string;
+}
+export interface UpdateGroupNameResponse {
+    updateGroupName: boolean;
+}
+export interface GroupParticipant {
+    id: string;
+    isAdmin: boolean;
+    isSuperAdmin: boolean;
+}
+export interface GroupData {
+    groupId: string;
+    owner: string;
+    subject: string;
+    creation: number;
+    participants: GroupParticipant[];
+    subjectTime: number;
+    subjectOwner: string;
+    groupInviteLink: string;
+}
+export interface GetGroupData {
+    groupId: string;
+}
+export interface AddGroupParticipant {
+    groupId: string;
+    participantChatId: string;
+}
+export interface AddGroupParticipantResponse {
+    addParticipant: boolean;
+}
+export interface RemoveGroupParticipant {
+    groupId: string;
+    participantChatId: string;
+}
+export interface RemoveGroupParticipantResponse {
+    removeParticipant: boolean;
+}
+export interface SetGroupAdmin {
+    groupId: string;
+    participantChatId: string;
+}
+export interface SetGroupAdminResponse {
+    setGroupAdmin: boolean;
+}
+export interface RemoveAdmin {
+    groupId: string;
+    participantChatId: string;
+}
+export interface RemoveAdminResponse {
+    removeAdmin: boolean;
+}
+export interface SetGroupPicture {
+    groupId: string;
+    file: Blob | File;
+}
+export interface SetGroupPictureResponse {
+    setGroupPicture: boolean;
+    urlAvatar: string | null;
+    reason: string;
+}
+export interface LeaveGroup {
+    groupId: string;
+}
+export interface LeaveGroupResponse {
+    leaveGroup?: boolean;
+    removeAdmin?: boolean;
+}
 export interface BaseRequest {
     headers: Record<string, any>;
     body: any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@green-api/greenapi-integration",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "GREEN-API Integration library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",