@green-api/greenapi-integration 0.2.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/base-adapter.d.ts

@@ -1,6 +1,6 @@
 import { GreenApiClient } from "./green-api.client";
 import { MessageTransformer } from "./message-transformer";
-import { BaseUser, ForwardMessagesResponse, GreenApiWebhook, Instance, SendResponse, Settings } from "../types/types";
+import { BaseUser, ForwardMessagesResponse, GreenApiWebhook, Instance, SendResponse, StateInstanceWebhook, WebhookType } from "../types/types";
 import { StorageProvider } from "./storage-provider";
 /**
  * Base adapter for platform integrations with GREEN-API.
@@ -74,6 +74,14 @@ export declare abstract class BaseAdapter<TPlatformWebhook, TPlatformMessage, TU
      * ```
      */
     abstract createPlatformClient(params: any): Promise<any>;
+    /**
+     * Handles instance state change webhooks from GREEN-API.
+     * Adapters MUST override this method if they need to handle instance state changes
+     *
+     * @param webhook - The state change webhook from GREEN-API
+     * @returns Promise resolving when the webhook is handled
+     */
+    handleStateInstanceWebhook(webhook: StateInstanceWebhook): Promise<void>;
     /**
      * Creates a GREEN-API client instance.
      *
@@ -107,18 +115,17 @@ export declare abstract class BaseAdapter<TPlatformWebhook, TPlatformMessage, TU
      * @throws {NotFoundError} If instance is not found
      * @throws {IntegrationError} If webhook handling fails
      */
-    handleGreenApiWebhook(webhook: GreenApiWebhook, allowedTypes: string[]): Promise<void>;
+    handleGreenApiWebhook(webhook: GreenApiWebhook, allowedTypes: WebhookType[]): Promise<void>;
     /**
      * Creates a new instance with specified settings.
      *
      * @param instance - The instance configuration
-     * @param settings - GREEN-API settings for the instance
      * @param userCred - User credentials
      * @returns Promise resolving to the created instance
      * @throws {NotFoundError} If user is not found
      * @throws {IntegrationError} If instance creation fails
      */
-    createInstance(instance: Instance, settings: Settings, userCred: any): Promise<TInstance>;
+    createInstance(instance: Instance, userCred: any): Promise<TInstance>;
     /**
      * Removes an instance by ID.
      *

package/dist/core/base-adapter.js

@@ -38,6 +38,17 @@ class BaseAdapter {
         this.transformer = transformer;
         this.storage = storage;
     }
+    /**
+     * Handles instance state change webhooks from GREEN-API.
+     * Adapters MUST override this method if they need to handle instance state changes
+     *
+     * @param webhook - The state change webhook from GREEN-API
+     * @returns Promise resolving when the webhook is handled
+     */
+    async handleStateInstanceWebhook(webhook) {
+        // Default empty implementation
+        return;
+    }
     /**
      * Creates a GREEN-API client instance.
      *
@@ -117,12 +128,17 @@ class BaseAdapter {
             return;
         }
         try {
-            const transformedMessage = await this.transformer.toPlatformMessage(webhook);
-            const instance = await this.storage.getInstance(webhook.instanceData.idInstance);
-            if (!instance) {
-                throw new errors_1.NotFoundError("Instance not found");
+            if (webhook.typeWebhook === "stateInstanceChanged") {
+                await this.handleStateInstanceWebhook(webhook);
+            }
+            else {
+                const transformedMessage = await this.transformer.toPlatformMessage(webhook);
+                const instance = await this.storage.getInstance(webhook.instanceData.idInstance);
+                if (!instance) {
+                    throw new errors_1.NotFoundError("Instance not found");
+                }
+                await this.sendToPlatform(transformedMessage, instance);
             }
-            await this.sendToPlatform(transformedMessage, instance);
         }
         catch (error) {
             this.handleError("Failed to handle GREEN-API webhook", error);
@@ -132,13 +148,12 @@ class BaseAdapter {
      * Creates a new instance with specified settings.
      *
      * @param instance - The instance configuration
-     * @param settings - GREEN-API settings for the instance
      * @param userCred - User credentials
      * @returns Promise resolving to the created instance
      * @throws {NotFoundError} If user is not found
      * @throws {IntegrationError} If instance creation fails
      */
-    async createInstance(instance, settings, userCred) {
+    async createInstance(instance, userCred) {
         try {
             const user = await this.storage.findUser(userCred);
             if (!user) {
@@ -151,8 +166,10 @@ class BaseAdapter {
             catch (error) {
                 throw new errors_1.IntegrationError(`Failed to get settings for instance ${instance.idInstance}: ${error.message}`, "INTEGRATION_ERROR");
             }
-            const createdInstance = await this.storage.createInstance(instance, user.id, settings);
-            await client.setSettings(settings);
+            const createdInstance = await this.storage.createInstance(instance, user.id);
+            if (instance.settings) {
+                await client.setSettings(instance.settings);
+            }
             return createdInstance;
         }
         catch (error) {