@wabot-dev/framework 0.9.19 → 0.9.21

package/dist/src/addon/async/in-memory/InMemoryCronJobRepository.js

@@ -8,6 +8,7 @@ import '../../../feature/async/AsyncMetadataStore.js';
 import '../../../feature/async/TransactionMetadataStore.js';
 import '../../../feature/async/Async.js';
 import { CronJob } from '../../../feature/async/CronJob.js';
+import 'node:crypto';
 import '../../../core/error/setupErrorHandlers.js';
 import '../../../feature/async/JobRepository.js';
 import '../../../feature/async/JobRunner.js';

package/dist/src/addon/async/in-memory/InMemoryJobRepository.js

@@ -9,6 +9,7 @@ import '../../../feature/async/TransactionMetadataStore.js';
 import '../../../feature/async/Async.js';
 import '../../../_virtual/index.js';
 import { Job } from '../../../feature/async/Job.js';
+import 'node:crypto';
 import '../../../feature/async/JobRepository.js';
 import '../../../feature/async/JobRunner.js';
 import '../../../feature/async/JobScheduler.js';
@@ -78,6 +79,23 @@ let InMemoryJobRepository = class InMemoryJobRepository {
             return j['data'].scheduledAt != null && j['data'].startedAt != null;
         });
     }
+    async findActiveByDedupKey(commandName, dedupKey, succeededSinceTimestamp) {
+        const candidates = [...this.items.values()]
+            .filter((j) => {
+            const d = j['data'];
+            if (d.commandName !== commandName)
+                return false;
+            if (d.dedupKey !== dedupKey)
+                return false;
+            if (d.failedAt != null)
+                return false;
+            if (d.successAt != null && d.successAt < succeededSinceTimestamp)
+                return false;
+            return true;
+        })
+            .sort((a, b) => (b['data'].createdAt ?? 0) - (a['data'].createdAt ?? 0));
+        return candidates[0] ?? null;
+    }
     async countRunningByCommand(commandName) {
         let count = 0;
         for (const j of this.items.values()) {

package/dist/src/addon/async/pg/PgJobRepository.js

@@ -56,6 +56,23 @@ let PgJobRepository = class PgJobRepository extends PgCrudRepository {
         const items = await this.query(sql, []);
         return items;
     }
+    async findActiveByDedupKey(commandName, dedupKey, succeededSinceTimestamp) {
+        const sql = `
+      SELECT ${this.columns}
+      FROM ${this.table}
+      WHERE data->>'commandName' = $1
+        AND data->>'dedupKey' = $2
+        AND data->>'failedAt' IS NULL
+        AND (
+          data->>'successAt' IS NULL
+          OR (data->>'successAt')::bigint >= $3
+        )
+      ORDER BY (data->>'createdAt')::bigint DESC
+      LIMIT 1
+    `;
+        const items = await this.query(sql, [commandName, dedupKey, succeededSinceTimestamp]);
+        return items[0] ?? null;
+    }
     async countRunningByCommand(commandName) {
         const sql = `
       SELECT COUNT(*)::int AS count

package/dist/src/addon/chat-bot/google/GoogleChatAdapter.js

@@ -49,14 +49,7 @@ let GoogleChatAdapter = class GoogleChatAdapter {
         let lastError;
         for (const ref of req.models) {
             try {
-                const response = await this.ai.models.generateContent({
-                    model: ref.model,
-                    contents,
-                    config: {
-                        tools: [{ functionDeclarations }],
-                        ...(hasUnsignedFunctionCall ? { thinkingConfig: { thinkingBudget: 0 } } : {}),
-                    },
-                });
+                const response = await this.callGenerate(ref.model, contents, functionDeclarations, hasUnsignedFunctionCall);
                 return this.mapResponse(response, ref.model);
             }
             catch (err) {
@@ -68,6 +61,25 @@ let GoogleChatAdapter = class GoogleChatAdapter {
         }
         throw lastError ?? new Error('No Google model could handle the request');
     }
+    async callGenerate(model, contents, functionDeclarations, hasUnsignedFunctionCall) {
+        const baseConfig = { tools: [{ functionDeclarations }] };
+        if (!hasUnsignedFunctionCall) {
+            return this.ai.models.generateContent({ model, contents, config: baseConfig });
+        }
+        try {
+            return await this.ai.models.generateContent({
+                model,
+                contents,
+                config: { ...baseConfig, thinkingConfig: { thinkingBudget: 0 } },
+            });
+        }
+        catch (err) {
+            if (!isThinkingModeRequiredError(err))
+                throw err;
+            this.logger.warn(`Google model '${model}' requires thinking mode; retrying without thinkingBudget override`);
+            return this.ai.models.generateContent({ model, contents, config: baseConfig });
+        }
+    }
     async mapChatItems(chatItems) {
         const contents = [];
         for (const chatItem of chatItems) {
@@ -179,9 +191,7 @@ let GoogleChatAdapter = class GoogleChatAdapter {
         if (!response.candidates || !response.candidates.length) {
             throw new Error('No candidates in response');
         }
-        if (!response.usageMetadata ||
-            !response.usageMetadata.promptTokenCount ||
-            !response.usageMetadata.candidatesTokenCount) {
+        if (!response.usageMetadata) {
             throw new Error('Not usage metadata');
         }
         const content = response.candidates.find((x) => x.content)?.content;
@@ -210,9 +220,10 @@ let GoogleChatAdapter = class GoogleChatAdapter {
             }
         }
         const cachedTokens = response.usageMetadata.cachedContentTokenCount ?? 0;
+        const thoughtsTokens = response.usageMetadata.thoughtsTokenCount ?? 0;
         let usage = {
-            inputTokens: response.usageMetadata.promptTokenCount,
-            outputTokens: response.usageMetadata.candidatesTokenCount,
+            inputTokens: response.usageMetadata.promptTokenCount ?? 0,
+            outputTokens: (response.usageMetadata.candidatesTokenCount ?? 0) + thoughtsTokens,
             cacheReadTokens: cachedTokens || undefined,
             provider: 'google',
             model: response.modelVersion ?? modelName,
@@ -225,6 +236,12 @@ GoogleChatAdapter = __decorate([
     singleton(),
     __metadata("design:paramtypes", [Env])
 ], GoogleChatAdapter);
+function isThinkingModeRequiredError(err) {
+    if (!err || typeof err !== 'object')
+        return false;
+    const message = err.message;
+    return typeof message === 'string' && /only works in thinking mode/i.test(message);
+}
 function stripDataUrlPrefix(dataUrl) {
     const commaIndex = dataUrl.indexOf(',');
     return commaIndex >= 0 && dataUrl.startsWith('data:') ? dataUrl.slice(commaIndex + 1) : dataUrl;

package/dist/src/addon/chat-controller/whatsapp/kapso/@kapso.js

@@ -0,0 +1,23 @@
+import { container } from '../../../../core/injection/index.js';
+import { resolveConfigReferences } from '../../../../core/config/resolver.js';
+import { ControllerMetadataStore } from '../../../../feature/chat-controller/metadata/ControllerMetadataStore.js';
+import '../../../../feature/chat-controller/ChatResolver.js';
+import '../../../../feature/chat-controller/runChatControllers.js';
+import { KapsoChannel } from './KapsoChannel.js';
+import { KapsoChannelConfig } from './KapsoChannelConfig.js';
+
+function kapso(config) {
+    return function (target, propertyKey) {
+        const cfg = config ?? {};
+        const resolvedConfig = resolveConfigReferences(cfg);
+        const store = container.resolve(ControllerMetadataStore);
+        store.saveChannelMetadata({
+            channelConstructor: KapsoChannel,
+            functionName: propertyKey.toString(),
+            controllerConstructor: target.constructor,
+            channelConfig: new KapsoChannelConfig(resolvedConfig),
+        });
+    };
+}
+
+export { kapso };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoChannel.js

@@ -0,0 +1,65 @@
+import { __decorate, __metadata } from 'tslib';
+import { injectable } from '../../../../core/injection/index.js';
+import { Env } from '../../../../core/env/Env.js';
+import { Logger } from '../../../../core/logger/Logger.js';
+import { KapsoChannelConfig } from './KapsoChannelConfig.js';
+import { KapsoReceiver } from './KapsoReceiver.js';
+import { KapsoSender } from './KapsoSender.js';
+import { kapsoChannelName } from './KapsoChannelName.js';
+
+var KapsoChannel_1;
+let KapsoChannel = class KapsoChannel {
+    static { KapsoChannel_1 = this; }
+    logger = new Logger('wabot:whatsapp-by-kapso-channel');
+    sender;
+    receiver;
+    phoneNumberId;
+    static channelName = kapsoChannelName;
+    constructor(config, env) {
+        const apiKey = config.apiKey ?? env.requireString('KAPSO_API_KEY');
+        const webhookSecret = config.webhookSecret ?? process.env.KAPSO_WEBHOOK_SECRET;
+        this.phoneNumberId = config.phoneNumberId ?? env.requireString('KAPSO_PHONE_NUMBER_ID');
+        this.sender = new KapsoSender(apiKey, this.phoneNumberId);
+        this.receiver = new KapsoReceiver({
+            webhookSecret,
+            webhookPath: config.webhookPath,
+        });
+    }
+    listen(callback) {
+        this.receiver.listenMessage(async (message, from) => {
+            try {
+                await callback({
+                    channel: kapsoChannelName,
+                    chatConnection: {
+                        chatType: 'PRIVATE',
+                        channelName: KapsoChannel_1.channelName,
+                        id: from,
+                    },
+                    message,
+                    reply: async (replyMessage) => {
+                        await this.sender.sendMessage({
+                            from: this.phoneNumberId,
+                            to: from,
+                            message: replyMessage,
+                        });
+                    },
+                });
+            }
+            catch (err) {
+                this.logger.error('Failed to handle WhatsApp message', err);
+            }
+        });
+    }
+    connect() {
+        this.receiver.connect();
+    }
+    disconnect() {
+        this.receiver.disconnect();
+    }
+};
+KapsoChannel = KapsoChannel_1 = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [KapsoChannelConfig, Env])
+], KapsoChannel);
+
+export { KapsoChannel };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoChannelConfig.js

@@ -0,0 +1,14 @@
+class KapsoChannelConfig {
+    apiKey;
+    webhookSecret;
+    phoneNumberId;
+    webhookPath;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.webhookSecret = config.webhookSecret;
+        this.phoneNumberId = config.phoneNumberId;
+        this.webhookPath = config.webhookPath ?? '/kapso/hook';
+    }
+}
+
+export { KapsoChannelConfig };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoChannelName.js

@@ -0,0 +1,3 @@
+const kapsoChannelName = 'WhatsAppByKapsoChannel';
+
+export { kapsoChannelName };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoReceiver.js

@@ -0,0 +1,36 @@
+import { __decorate, __metadata } from 'tslib';
+import '../../../../core/injection/index.js';
+import '../../../../feature/rest-controller/metadata/RestControllerMetadataStore.js';
+import { restController } from '../../../../feature/rest-controller/metadata/@restController.js';
+import { runRestControllers } from '../../../../feature/rest-controller/runRestControllers.js';
+import { KapsoWebhookController } from './KapsoWebhookController.js';
+
+class KapsoReceiver {
+    config;
+    listener = null;
+    constructor(config) {
+        this.config = config;
+    }
+    listenMessage(listener) {
+        this.listener = listener;
+    }
+    connect() {
+        const webhookSecret = this.config.webhookSecret;
+        const listener = this.listener;
+        let UniqueController = class UniqueController extends KapsoWebhookController {
+            constructor() {
+                super(webhookSecret, listener);
+            }
+        };
+        UniqueController = __decorate([
+            restController(this.config.webhookPath),
+            __metadata("design:paramtypes", [])
+        ], UniqueController);
+        runRestControllers([UniqueController]);
+    }
+    disconnect() {
+        // Nothing to disconnect
+    }
+}
+
+export { KapsoReceiver };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoSender.js

@@ -0,0 +1,44 @@
+import { Logger } from '../../../../core/logger/Logger.js';
+
+class KapsoSender {
+    apiKey;
+    phoneNumberId;
+    logger = new Logger('wabot:whatsapp-sender-by-kapso');
+    baseUrl = 'https://api.kapso.ai/meta/whatsapp/v24.0';
+    constructor(apiKey, phoneNumberId) {
+        this.apiKey = apiKey;
+        this.phoneNumberId = phoneNumberId;
+    }
+    async sendMessage(request) {
+        const url = `${this.baseUrl}/${this.phoneNumberId}/messages`;
+        const payload = {
+            messaging_product: 'whatsapp',
+            recipient_type: 'individual',
+            to: request.to.replace(/\D+/g, ''),
+            type: 'text',
+            text: {
+                preview_url: false,
+                body: request.message.text ?? '',
+            },
+        };
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'X-API-Key': this.apiKey,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            this.logger.error(`Failed to send message from '${request.from}' to '${request.to}': ${response.status} ${errorBody}`);
+            throw new Error(`Kapso send message failed: ${response.status} ${errorBody}`);
+        }
+        this.logger.trace(`message sent from '${request.from}' to '${request.to}'`);
+    }
+    async sendTemplate(_request) {
+        throw new Error('Method not implemented.');
+    }
+}
+
+export { KapsoSender };

package/dist/src/addon/chat-controller/whatsapp/kapso/KapsoWebhookController.js

@@ -0,0 +1,99 @@
+import { __decorate, __metadata } from 'tslib';
+import { createHmac, timingSafeEqual } from 'node:crypto';
+import { IncomingMessage } from 'node:http';
+import { Logger } from '../../../../core/logger/Logger.js';
+import '../../../../core/injection/index.js';
+import '../../../../feature/rest-controller/metadata/RestControllerMetadataStore.js';
+import { onPost } from '../../../../feature/rest-controller/metadata/@onPost.js';
+
+class KapsoWebhookController {
+    webhookSecret;
+    listener;
+    logger = new Logger('wabot:kapso-webhook');
+    constructor(webhookSecret, listener) {
+        this.webhookSecret = webhookSecret;
+        this.listener = listener;
+    }
+    async handleWebhook(req) {
+        const rawBody = await this.getRawBody(req);
+        if (!this.verifySignature(req, rawBody)) {
+            this.logger.warn('rejected webhook with invalid signature');
+            throw new Error('Invalid webhook signature');
+        }
+        let event;
+        try {
+            event = JSON.parse(rawBody);
+        }
+        catch (err) {
+            this.logger.error('Failed to parse webhook payload', err);
+            throw new Error('Invalid webhook payload');
+        }
+        this.logger.trace(`received event ${event.event}`);
+        switch (event.event) {
+            case 'whatsapp.message.received':
+                await this.handleMessageReceived(event);
+                break;
+            default:
+                this.logger.trace(`unhandled event type ${event.event}`);
+        }
+    }
+    async handleMessageReceived(event) {
+        const message = event.message;
+        if (message.type !== 'text' || !message.text) {
+            this.logger.warn(`message type '${message.type}' is not supported yet`);
+            return;
+        }
+        const rawNumber = message.from ?? event.conversation?.phone_number ?? '';
+        if (!rawNumber) {
+            this.logger.warn('received message without a sender number');
+            return;
+        }
+        const from = rawNumber.startsWith('+') ? rawNumber : `+${rawNumber}`;
+        const senderName = event.conversation?.kapso?.contact_name ?? message.username ?? from;
+        this.logger.trace(`new message from '${from}'`);
+        await this.listener({
+            text: message.text.body,
+            senderName,
+            senderId: from,
+            metadata: {
+                whatsAppNumber: from,
+            },
+        }, from);
+    }
+    verifySignature(req, rawBody) {
+        if (!this.webhookSecret) {
+            return true;
+        }
+        const headerValue = req.headers['x-webhook-signature'];
+        const provided = Array.isArray(headerValue) ? headerValue[0] : headerValue;
+        if (!provided) {
+            return false;
+        }
+        const expected = createHmac('sha256', this.webhookSecret).update(rawBody).digest('hex');
+        const providedHex = provided.startsWith('sha256=') ? provided.slice('sha256='.length) : provided;
+        const expectedBuf = Buffer.from(expected, 'hex');
+        const providedBuf = Buffer.from(providedHex, 'hex');
+        if (expectedBuf.length !== providedBuf.length) {
+            return false;
+        }
+        return timingSafeEqual(expectedBuf, providedBuf);
+    }
+    getRawBody(req) {
+        return new Promise((resolve, reject) => {
+            let data = '';
+            req.on('data', (chunk) => {
+                data += chunk;
+            });
+            req.on('end', () => resolve(data));
+            req.on('error', (err) => reject(err));
+        });
+    }
+}
+__decorate([
+    onPost({ disableJsonParser: true, disableUrlEncodedParser: true }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [IncomingMessage]),
+    __metadata("design:returntype", Promise)
+], KapsoWebhookController.prototype, "handleWebhook", null);
+
+export { KapsoWebhookController };

package/dist/src/feature/async/@commandHandler.js

@@ -4,7 +4,17 @@ import { container, injectable } from '../../core/injection/index.js';
 function commandHandler(config) {
     return function (target) {
         const metadataStore = container.resolve(AsyncMetadataStore);
-        metadataStore.registerCommandHandler(typeof config === 'function' ? config : config.command, target);
+        const isCtor = typeof config === 'function';
+        const command = isCtor ? config : config.command;
+        const options = isCtor
+            ? {}
+            : {
+                reintentsDelaysInSeconds: config.reintentsDelaysInSeconds,
+                aceptableRunningTimeSeconds: config.aceptableRunningTimeSeconds,
+                stuckRetryAttempts: config.stuckRetryAttempts,
+            };
+        const dedup = isCtor ? undefined : config.dedup;
+        metadataStore.registerCommandHandler(command, target, options, dedup);
         injectable()(target);
     };
 }

package/dist/src/feature/async/@cronHandler.js

@@ -9,6 +9,11 @@ function cronHandler(config) {
             commandName: `cron:${config.name}`,
             cron: config.cron,
             enabled: !config.disabled,
+            maxRunningJobs: config.maxRunningJobs,
+            misfirePolicy: config.misfirePolicy,
+            reintentsDelaysInSeconds: config.reintentsDelaysInSeconds,
+            aceptableRunningTimeSeconds: config.aceptableRunningTimeSeconds,
+            stuckRetryAttempts: config.stuckRetryAttempts,
         });
         singleton()(target);
     };

package/dist/src/feature/async/Async.js

@@ -8,15 +8,19 @@ import { JobRepository } from './JobRepository.js';
 import { JobScheduler } from './JobScheduler.js';
 import '../../core/validation/metadata/ValidationMetadataStore.js';
 import { validateAndTransform } from '../../core/validation/validateAndTransform.js';
+import { Locker } from '../../core/lock/Locker.js';
+import { computeDedupKey } from './computeDedupKey.js';
 
 let Async = class Async {
     jobRepository;
     metadataStore;
     jobScheduler;
-    constructor(jobRepository, metadataStore, jobScheduler) {
+    locker;
+    constructor(jobRepository, metadataStore, jobScheduler, locker) {
         this.jobRepository = jobRepository;
         this.metadataStore = metadataStore;
         this.jobScheduler = jobScheduler;
+        this.locker = locker;
     }
     async runCommand(ctor, data) {
         const job = await this.scheduleCommand(ctor, data, new Date());
@@ -36,13 +40,34 @@ let Async = class Async {
             });
         }
         const scheduledDate = this.resolveScheduledDate(scheduledAt);
-        const job = new Job({
+        const options = this.metadataStore.getJobOptionsForCommandName(commandName);
+        const dedupConfig = this.metadataStore.getDedupConfigForCommandName(commandName);
+        const buildJob = (dedupKey) => new Job({
             commandName,
             commandData,
             scheduledAt: scheduledDate.getTime(),
+            reintentsDelaysInSeconds: options.reintentsDelaysInSeconds,
+            aceptableRunningTimeSeconds: options.aceptableRunningTimeSeconds,
+            stuckRetryAttempts: options.stuckRetryAttempts,
+            dedupKey,
+        });
+        if (!dedupConfig) {
+            const job = buildJob();
+            await this.jobRepository.create(job);
+            return job;
+        }
+        const dedupKey = computeDedupKey(commandData);
+        const succeededSinceTimestamp = dedupConfig === 'forever' ? 0 : Date.now() - dedupConfig.windowSeconds * 1000;
+        return await this.locker
+            .withKey(`wabot-async-dedup-${commandName}-${dedupKey}`)
+            .run(async () => {
+            const existing = await this.jobRepository.findActiveByDedupKey(commandName, dedupKey, succeededSinceTimestamp);
+            if (existing)
+                return existing;
+            const job = buildJob(dedupKey);
+            await this.jobRepository.create(job);
+            return job;
         });
-        await this.jobRepository.create(job);
-        return job;
     }
     resolveScheduledDate(scheduledAt) {
         if (scheduledAt instanceof Date) {
@@ -68,7 +93,8 @@ Async = __decorate([
     singleton(),
     __metadata("design:paramtypes", [JobRepository,
         AsyncMetadataStore,
-        JobScheduler])
+        JobScheduler,
+        Locker])
 ], Async);
 
 export { Async };

package/dist/src/feature/async/AsyncMetadataStore.js

@@ -6,6 +6,8 @@ let AsyncMetadataStore = class AsyncMetadataStore {
     handlersInverseMap = new Map();
     commandsMap = new Map();
     commandsInverseMap = new Map();
+    handlerOptionsMap = new Map();
+    dedupConfigMap = new Map();
     cronsMap = new Map();
     registerCron(cron, config) {
         let ctorCrons = this.cronsMap.get(cron);
@@ -26,13 +28,20 @@ let AsyncMetadataStore = class AsyncMetadataStore {
         this.commandsMap.set(commandName, command);
         this.commandsInverseMap.set(command, commandName);
     }
-    registerCommandHandler(command, handlerConstructor) {
+    registerCommandHandler(command, handlerConstructor, options = {}, dedup) {
         let commandName = this.commandsInverseMap.get(command);
         if (!commandName) {
             throw new Error(`Should use @command decorator on command class ${command.name}`);
         }
         this.handlersMap.set(commandName, handlerConstructor);
         this.handlersInverseMap.set(handlerConstructor, commandName);
+        this.handlerOptionsMap.set(commandName, options);
+        if (dedup !== undefined) {
+            this.dedupConfigMap.set(commandName, dedup);
+        }
+        else {
+            this.dedupConfigMap.delete(commandName);
+        }
     }
     getHandlerForCommandName(commandName) {
         return this.handlersMap.get(commandName) ?? null;
@@ -52,6 +61,12 @@ let AsyncMetadataStore = class AsyncMetadataStore {
     getCommandForCommandName(commandName) {
         return this.commandsMap.get(commandName) ?? null;
     }
+    getJobOptionsForCommandName(commandName) {
+        return this.handlerOptionsMap.get(commandName) ?? {};
+    }
+    getDedupConfigForCommandName(commandName) {
+        return this.dedupConfigMap.get(commandName);
+    }
     getAllCommandHandlers() {
         return Array.from(this.handlersInverseMap.keys());
     }

package/dist/src/feature/async/CronScheduler.js

@@ -136,7 +136,15 @@ let CronScheduler = class CronScheduler {
             let cronJob = await this.cronRepo.findByName(config.name);
             if (cronJob) {
                 this.logger.debug(`found cron job for name='${config.name}'`);
-                cronJob.update({ cron: config.cron, enabled: config.enabled });
+                cronJob.update({
+                    cron: config.cron,
+                    enabled: config.enabled,
+                    maxRunningJobs: config.maxRunningJobs,
+                    misfirePolicy: config.misfirePolicy,
+                    reintentsDelaysInSeconds: config.reintentsDelaysInSeconds,
+                    aceptableRunningTimeSeconds: config.aceptableRunningTimeSeconds,
+                    stuckRetryAttempts: config.stuckRetryAttempts,
+                });
                 await this.cronRepo.update(cronJob);
                 this.logger.debug(`cron job for name='${config.name}' updated`);
             }
@@ -146,6 +154,11 @@ let CronScheduler = class CronScheduler {
                     cron: config.cron,
                     commandName: config.commandName,
                     enabled: config.enabled,
+                    maxRunningJobs: config.maxRunningJobs,
+                    misfirePolicy: config.misfirePolicy,
+                    reintentsDelaysInSeconds: config.reintentsDelaysInSeconds,
+                    aceptableRunningTimeSeconds: config.aceptableRunningTimeSeconds,
+                    stuckRetryAttempts: config.stuckRetryAttempts,
                 });
                 await this.cronRepo.create(cronJob);
             }

package/dist/src/feature/async/Job.js

@@ -18,6 +18,9 @@ class Job extends Entity {
     get stuckRetryAttempts() {
         return this.data.stuckRetryAttempts;
     }
+    get dedupKey() {
+        return this.data.dedupKey;
+    }
     get runningSeconds() {
         if (!this.isRunning())
             return -1;

package/dist/src/feature/async/JobRepository.js

@@ -32,6 +32,9 @@ let JobRepository = class JobRepository {
     countRunningByCommand(commandName) {
         throw new Error('Method not implemented.');
     }
+    findActiveByDedupKey(commandName, dedupKey, succeededSinceTimestamp) {
+        throw new Error('Method not implemented.');
+    }
 };
 JobRepository = __decorate([
     singleton()

package/dist/src/feature/async/computeDedupKey.js

@@ -0,0 +1,21 @@
+import { createHash } from 'node:crypto';
+
+function canonicalize(value) {
+    if (value === undefined || value === null)
+        return 'null';
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? JSON.stringify(value) : 'null';
+    if (typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return '[' + value.map(canonicalize).join(',') + ']';
+    const keys = Object.keys(value)
+        .filter((k) => value[k] !== undefined)
+        .sort();
+    return ('{' + keys.map((k) => JSON.stringify(k) + ':' + canonicalize(value[k])).join(',') + '}');
+}
+function computeDedupKey(commandData) {
+    return createHash('sha256').update(canonicalize(commandData)).digest('hex');
+}
+
+export { computeDedupKey };

package/dist/src/feature/project-runner/ProjectRunner.js

@@ -22,6 +22,7 @@ import { TransactionMetadataStore } from '../async/TransactionMetadataStore.js';
 import '../async/Async.js';
 import '../../_virtual/index.js';
 import { CronJobRepository } from '../async/CronJobRepository.js';
+import 'node:crypto';
 import { JobRepository } from '../async/JobRepository.js';
 import '../async/JobRunner.js';
 import { runCommandHandlers } from '../async/runCommandHandlers.js';

package/dist/src/index.d.ts

@@ -464,8 +464,19 @@ interface ICommandHandler<C extends object> {
     handle(command: C): void | Promise<void>;
 }
 
-interface ICommandHandlerConfig<C extends object> {
+interface IJobOptions {
+    reintentsDelaysInSeconds?: number[];
+    aceptableRunningTimeSeconds?: number;
+    stuckRetryAttempts?: number;
+}
+
+type IDedupConfig = {
+    windowSeconds: number;
+} | 'forever';
+
+interface ICommandHandlerConfig<C extends object> extends IJobOptions {
     command: IConstructor<IStorableData<C>>;
+    dedup?: IDedupConfig;
 }
 declare function commandHandler<C extends object>(config: ICommandHandlerConfig<C> | IConstructor<IStorableData<C>>): (target: IConstructor<ICommandHandler<C>>) => void;
 
@@ -474,20 +485,24 @@ interface ICronHandler {
     handleError?(e: any): void | Promise<void>;
 }
 
-interface ICronConfig {
+interface ICronConfig extends IJobOptions {
     name: string;
     cron: string;
     disabled?: boolean;
+    maxRunningJobs?: number;
+    misfirePolicy?: 'RUN_ONCE' | 'RUN_ALL' | 'SKIP';
 }
 declare function cronHandler(config: ICronConfig): (target: IConstructor<ICronHandler>) => void;
 
 declare function transaction(dbNames?: readonly string[]): <This, A extends unknown[], R>(_target: object, _propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<(this: This, ...args: A) => Promise<R>>) => TypedPropertyDescriptor<(this: This, ...args: A) => Promise<R>>;
 
-interface ICronJobScheduleConfig {
+interface ICronJobScheduleConfig extends IJobOptions {
     name: string;
     commandName: string;
     cron: string;
     enabled: boolean;
+    maxRunningJobs?: number;
+    misfirePolicy?: 'RUN_ONCE' | 'RUN_ALL' | 'SKIP';
 }
 
 interface ICronMetadata {
@@ -500,16 +515,20 @@ declare class AsyncMetadataStore {
     private handlersInverseMap;
     private commandsMap;
     private commandsInverseMap;
+    private handlerOptionsMap;
+    private dedupConfigMap;
     private cronsMap;
     registerCron(cron: IConstructor<ICronHandler>, config: ICronJobScheduleConfig): void;
     requireCronMetadata(cron: IConstructor<ICronHandler>): ICronMetadata[];
     registerCommand(command: IConstructor<any>, commandName: string): void;
-    registerCommandHandler<C extends object>(command: IConstructor<IStorableData<C>>, handlerConstructor: IConstructor<ICommandHandler<C>>): void;
+    registerCommandHandler<C extends object>(command: IConstructor<IStorableData<C>>, handlerConstructor: IConstructor<ICommandHandler<C>>, options?: IJobOptions, dedup?: IDedupConfig): void;
     getHandlerForCommandName(commandName: string): IConstructor<ICommandHandler<any>> | null;
     getCommandNameForHandler(handlerConstructor: IConstructor<ICommandHandler<any>>): string | null;
     requireCommandNameForHandler(handlerConstructor: IConstructor<ICommandHandler<any>>): string;
     getCommandName(command: IConstructor<any>): string | null;
     getCommandForCommandName(commandName: string): IConstructor<any> | null;
+    getJobOptionsForCommandName(commandName: string): IJobOptions;
+    getDedupConfigForCommandName(commandName: string): IDedupConfig | undefined;
     getAllCommandHandlers(): IConstructor<ICommandHandler<any>>[];
     getAllCronHandlers(): IConstructor<ICronHandler>[];
 }
@@ -532,6 +551,7 @@ interface IJobData extends IEntityData {
     };
     aceptableRunningTimeSeconds?: number;
     stuckRetryAttempts?: number;
+    dedupKey?: string;
 }
 declare class Job extends Entity<IJobData> {
     get commandName(): string;
@@ -539,6 +559,7 @@ declare class Job extends Entity<IJobData> {
     get reintentsDelaysInSeconds(): number[] | undefined;
     get aceptableRunningTimeSeconds(): number | undefined;
     get stuckRetryAttempts(): number | undefined;
+    get dedupKey(): string | undefined;
     get runningSeconds(): number;
     get successAt(): Date | undefined;
     get failedAt(): Date | undefined;
@@ -560,6 +581,7 @@ interface IJobRepository extends ICrudRepository<Job> {
     findPendingForRunFrom(date: Date, limit: number): Promise<Job[]>;
     findRunningJobs(): Promise<Job[]>;
     countRunningByCommand(commandName: string): Promise<number>;
+    findActiveByDedupKey(commandName: string, dedupKey: string, succeededSinceTimestamp: number): Promise<Job | null>;
 }
 
 declare class JobRepository implements IJobRepository {
@@ -573,6 +595,7 @@ declare class JobRepository implements IJobRepository {
     update(item: Job): Promise<void>;
     delete(item: Job): Promise<void>;
     countRunningByCommand(commandName: string): Promise<number>;
+    findActiveByDedupKey(commandName: string, dedupKey: string, succeededSinceTimestamp: number): Promise<Job | null>;
 }
 
 declare class JobRunner {
@@ -627,7 +650,8 @@ declare class Async {
     private jobRepository;
     private metadataStore;
     private jobScheduler;
-    constructor(jobRepository: JobRepository, metadataStore: AsyncMetadataStore, jobScheduler: JobScheduler);
+    private locker;
+    constructor(jobRepository: JobRepository, metadataStore: AsyncMetadataStore, jobScheduler: JobScheduler, locker: Locker);
     runCommand<T>(ctor: IConstructor<T>, data: IValidateInputShape<T>): Promise<Job>;
     scheduleCommand<T>(ctor: IConstructor<T>, data: IValidateInputShape<T>, scheduledAt: IScheduleAt): Promise<Job>;
     private resolveScheduledDate;
@@ -679,6 +703,8 @@ declare class CronJobRepository implements ICronJobRepository {
     findOrThrow(id: string): Promise<CronJob>;
 }
 
+declare function computeDedupKey(commandData: unknown): string;
+
 interface ITransactionAdapter {
     run<T>(fn: () => Promise<T>): Promise<T>;
 }
@@ -1659,6 +1685,7 @@ declare class PgJobRepository extends PgCrudRepository<Job> implements IJobRepos
     constructor(pool: Pool);
     findPendingForRunFrom(date: Date, limit: number): Promise<Job[]>;
     findRunningJobs(): Promise<Job[]>;
+    findActiveByDedupKey(commandName: string, dedupKey: string, succeededSinceTimestamp: number): Promise<Job | null>;
     countRunningByCommand(commandName: string): Promise<number>;
 }
 
@@ -1680,6 +1707,7 @@ declare class InMemoryJobRepository implements IJobRepository {
     delete(item: Job): Promise<void>;
     findPendingForRunFrom(date: Date, limit: number): Promise<Job[]>;
     findRunningJobs(): Promise<Job[]>;
+    findActiveByDedupKey(commandName: string, dedupKey: string, succeededSinceTimestamp: number): Promise<Job | null>;
     countRunningByCommand(commandName: string): Promise<number>;
     private touch;
     private enforceLimit;
@@ -1934,6 +1962,7 @@ declare class GoogleChatAdapter implements IChatAdapter {
     private readonly logger;
     constructor(env: Env);
     nextItems(req: IChatAdapterNextItemsReq): Promise<IChatAdapterNextItemsRes>;
+    private callGenerate;
     private mapChatItems;
     private mapHumanMessage;
     private toGoogleFilePart;
@@ -2355,6 +2384,130 @@ declare class WhatsAppApiSender implements IWhatsAppSender {
     sendTemplate(request: ISendWhatsAppTemplateReq): Promise<void>;
 }
 
+interface IKapsoChannelConfig {
+    apiKey?: string | ConfigReference<string>;
+    webhookSecret?: string | ConfigReference<string>;
+    phoneNumberId?: string | ConfigReference<string>;
+    webhookPath?: string;
+}
+
+declare function kapso(config?: IKapsoChannelConfig): (target: object, propertyKey: string | symbol) => void;
+
+interface IKapsoChatMessage extends IChatMessage {
+    metadata: {
+        whatsAppNumber: string;
+    };
+}
+
+declare const kapsoChannelName: "WhatsAppByKapsoChannel";
+
+interface IKapsoReceivedMessage extends IReceivedMessage {
+    channel: typeof kapsoChannelName;
+    message: IKapsoChatMessage;
+}
+
+interface IKapsoChannelMessage extends IKapsoReceivedMessage {
+    chatConnection: IChatConnection;
+    injectInstances?: [any, any][];
+}
+
+type IKapsoEvent = IKapsoMessageReceivedEvent | IKapsoUnknownEvent;
+interface IKapsoUnknownEvent {
+    event: string;
+    [key: string]: unknown;
+}
+interface IKapsoMessageReceivedEvent {
+    event: 'whatsapp.message.received';
+    message: IKapsoIncomingMessage;
+    conversation: IKapsoConversation;
+    is_new_conversation?: boolean;
+    phone_number_id?: string;
+}
+interface IKapsoIncomingMessage {
+    id: string;
+    timestamp: string;
+    type: string;
+    from: string;
+    from_user_id?: string;
+    from_parent_user_id?: string;
+    username?: string;
+    text?: {
+        body: string;
+    };
+}
+interface IKapsoConversation {
+    id: string;
+    phone_number?: string;
+    business_scoped_user_id?: string;
+    parent_business_scoped_user_id?: string;
+    username?: string;
+    status?: string;
+    phone_number_id?: string;
+    kapso?: {
+        contact_name?: string;
+        [key: string]: unknown;
+    };
+}
+
+declare class KapsoChannelConfig {
+    readonly apiKey?: string;
+    readonly webhookSecret?: string;
+    readonly phoneNumberId?: string;
+    readonly webhookPath: string;
+    constructor(config: {
+        apiKey?: string;
+        webhookSecret?: string;
+        phoneNumberId?: string;
+        webhookPath?: string;
+    });
+}
+
+declare class KapsoChannel implements IChatChannel {
+    private logger;
+    private sender;
+    private receiver;
+    private phoneNumberId;
+    static channelName: "WhatsAppByKapsoChannel";
+    constructor(config: KapsoChannelConfig, env: Env);
+    listen(callback: (message: IKapsoChannelMessage) => Promise<void>): void;
+    connect(): void;
+    disconnect(): void;
+}
+
+type IKapsoChannelMessageListener = (message: IKapsoChatMessage, from: string) => Promise<void>;
+declare class KapsoWebhookController {
+    private webhookSecret;
+    private listener;
+    private logger;
+    constructor(webhookSecret: string | undefined, listener: IKapsoChannelMessageListener);
+    handleWebhook(req: IncomingMessage): Promise<void>;
+    private handleMessageReceived;
+    private verifySignature;
+    private getRawBody;
+}
+
+declare class KapsoReceiver {
+    private config;
+    private listener;
+    constructor(config: {
+        webhookSecret?: string;
+        webhookPath: string;
+    });
+    listenMessage(listener: IKapsoChannelMessageListener): void;
+    connect(): void;
+    disconnect(): void;
+}
+
+declare class KapsoSender implements IWhatsAppSender {
+    private apiKey;
+    private phoneNumberId;
+    private logger;
+    private baseUrl;
+    constructor(apiKey: string, phoneNumberId: string);
+    sendMessage(request: ISendWhatsAppMessageReq): Promise<void>;
+    sendTemplate(_request: ISendWhatsAppTemplateReq): Promise<void>;
+}
+
 interface IWasenderChannelConfig {
     apiKey?: string | ConfigReference<string>;
     webhookSecret?: string | ConfigReference<string>;
@@ -2524,4 +2677,4 @@ declare function HtmlModule(options: IHtmlModuleOptions): {
     new (): {};
 };
 
-export { AnthropicChatAdapter, ApiKey, ApiKeyGuardMiddleware, ApiKeyHandshakeGuardMiddleware, ApiKeyRepository, Async, AsyncMetadataStore, Auth, Chat, ChatAdapter, ChatAdapterMetadataStore, ChatAdapterRegistry, ChatBot, ChatBotMetadataStore, ChatItem, ChatMemory, ChatOperator, ChatRepository, ChatResolver, type ClientMap, CmdChannel, CmdChannelConfig, CmdChannelServer, type CmdClientMessage, type CmdServerMessage, type ConfigReference, type ConfigReferenceType, ConfigResolver, Container, ControllerMetadataStore, CronJob, CronJobRepository, CrudRepository, CustomError, DeepSeekChatAdapter, DescriptionMetadataStore, EXPRESS_REQ, EXPRESS_RES, Entity, Env, type ErrorSeverity, ExpressProvider, GoogleChatAdapter, type GoogleChatAdapterV2Options, HtmlModule, HttpServerProvider, type IApiKeyData, type IApiKeyRepository, type IArrayValidationError, type IArrayValidationResult, type IBotMessageItem, type IBuiltQuery, type IChannelMessage, type IChannelMetadata, type IChatAdapter, type IChatAdapterDecoratorConfig, type IChatAdapterMetadata, type IChatAdapterNextItemsReq, type IChatAdapterNextItemsRes, type IChatAssociation, type IChatBot, type IChatBotMetadata, type IChatChannel, type IChatConnection, type IChatControllerMetadata, type IChatData, type IChatItem, type IChatItemData, type IChatItemType, type IChatMemory, type IChatMessage, type IChatMessageDocument, type IChatMessageFile, type IChatMessageImage, type IChatMessagesPrivateFile, type IChatMessagesPublicFile, type IChatRepository, type IChatType, type ICmdChannelEntry, type ICmdChannelHandlers, type ICmdChannelMessage, type ICmdReceivedMessage, type ICommandConfig, type ICommandHandler, type ICommandHandlerConfig, type IConstructor, type ICronConfig, type ICronHandler, type ICronJobData, type ICronJobRepository, type ICrudRepository, type ICustomErrorData, type IDescriptionMetadata, type IEndPointConfig, type IEndPointMetadata, type IEntityData, type IEnvType, type IErrorHandlersConfig, type IErrorMonitor, type IErrorMonitorContext, type IExtractChatMessageTextOptions, type IFunctionCall, type IFunctionCallItem, type IGenerateApiKeyReq, type IGenerateApiKeyRes, type IHandshakeMiddleware, type IHandshakeMiddlewareMetadata, type IHtmlModuleOptions, type IHumanMessageItem, type IJobData, type IJobRepository, type IJwtRefreshTokenData, type IJwtRefreshTokenRepository, type ILanguageModelUsage, type ILockKey, type ILocker, type ILockerKey, type IMemoryRepositoryAdapterOptions, type IMessageContext, type IMiddleware, type IMiddlewareMetadata, type IMindset, type IMindsetConfig, type IMindsetIdentity, type IMindsetLlm, type IMindsetMetadata, type IMindsetModelKind, type IMindsetModelRef, type IMindsetModels, type IMindsetModuleConfig, type IMindsetModuleMetadata, type IMindsetParameterSchema, type IMindsetTool, type IMindsetToolParameter, type IModelValidationError, type IModelValidationResult, type IModelValidatorsInfo, type IMoneyData, type IPersistentData, type IPgRepositoryConfig, type IProjectRunnerConfig, type IPropertyValidatorInfo, type IQueryAst, type IQueryCondition, type IQueryMethodMetadata, type IQueryOrderBy, type IReceivedMessage, type IRemoteApiKeyFetcher, type IRepositoryAdapter, type IRepositoryConfig, type IRepositoryRuntime, type IRestControllerConfig, type IRestControllerMetadata, type IScanProjectFilesOptions, type IScheduleAt, type IScheduleDelay, type ISendWhatsAppMessageReq, type ISendWhatsAppTemplateReq, type ISocketChannelConfig, type ISocketChannelMessage, type ISocketChannelReceivedMessage, type ISocketControllerConfig, type ISocketControllerMetadata, type ISocketEventConfig, type ISocketEventMetadata, type ISocketReceivedMessage, type IStorableData, type ITelegramChannelConfig, type ITelegramChannelMessage, type ITelegramReceivedMessage, type ITransactionAdapter, type IValidateArrayOptions, type IValidateArrayOptionsWithItemsValidators, type IValidateInputShape, type IValidateIsInOptions, type IValidateIsRecordOptions, type IValidateMaxOptions, type IValidateMinOptions, type IValidationError, type IValidationResult, type IValidator, type IValidatorMetadata, type IWasenderChannelConfig, type IWasenderChannelMessageListener, type IWasenderDeviceListMetadata, type IWasenderEvent, type IWasenderMessageContent, type IWasenderMessageContextInfo, type IWasenderMessageKey, type IWasenderMessageReceivedData, type IWasenderMessageReceivedEvent, type IWasenderQrUpdatedEvent, type IWasenderReceivedMessage, type IWhatsAppCloudContact, type IWhatsAppCloudMessage, type IWhatsAppCloudMessageMetadata, type IWhatsAppCloudTemplate, type IWhatsAppCloudTemplateComponent, type IWhatsAppCloudTemplateResponse, type IWhatsAppCloudWebhookPayload, type IWhatsAppSender, type IWhatsAppTemplateData, type IWhatsAppTemplateParameter, type IchatControllerConfig, InMemoryChatMemory, InMemoryChatRepository, InMemoryCronJobRepository, InMemoryJobRepository, InMemoryLockKey, InMemoryLocker, Job, JobRepository, JobRunner, Jwt, JwtAccessAndRefreshTokenDto, JwtConfig, JwtGuardMiddleware, JwtHandshakeGuardMiddleware, JwtRefreshToken, JwtRefreshTokenRepository, JwtSigner, JwtTokenDto, Lifecycle, Locker, Logger, MEMORY_ADAPTER_ID, Mapper, MemoryRepositoryAdapter, MemoryRepositoryExtension, Mindset, MindsetMetadataStore, MindsetOperator, Money, MoneyDto, OpenRouterChatAdapter, OpenaiChatAdapter, PG_ADAPTER_ID, Password, type PasswordHashOptions, Persistent, PgApiKeyRepository, PgChatMemory, PgChatRepository, PgCronJobRepository, PgCrudRepository, PgJobRepository, PgJsonRepositoryAdapter, PgJwtRefreshTokenRepository, PgLockKey, PgLocker, PgRepositoryBase, PgRepositoryBase as PgRepositoryExtension, PgTransactionAdapter, ProjectRunner, type QueryConnector, type QueryOperator, type QueryPrefix, Random, RemoteApiKeyRepository, RepositoryAdapterRegistry, RepositoryMetadataStore, type ResolvedConfig, RestControllerMetadataStore, RestRequest, SocketChannel, SocketChannelConfig, SocketChannelMessageFile, SocketChannelReceivedMessage, SocketControllerMetadataStore, SocketServerConfig, SocketServerProvider, Storable, TelegramChannel, TelegramChannelConfig, TransactionMetadataStore, UnionChatAdapter, ValidationMetadataStore, WabotChatAdapter, WasenderChannel, WasenderChannelConfig, WasenderReceiver, WasenderSender, WasenderWebhookController, WhatsAppApiSender, WhatsAppReceiverByCloudApi, WhatsAppSender, apiKeyGuard, apiKeyHandshakeGuard, bool, boolArr, buildQuerySql, chatAdapter, chatBot, chatController, chatItemTypeOptions, cmd, cmdChannelName, cmdChannelSocketPath, command, commandHandler, container, cronHandler, description, errorToPlainObject, evaluateQueryAst, extractChatMessageText, extractNumberFromWasenderMessageKey, getClientMap, getPgClient, handshakeMiddlewares, inject, injectable, isArray, isBoolean, isChatMessageEmpty, isDate, isIn, isModel, isNotEmpty, isNumber, isOptional, isPresent, isRecord, isRetryableError, isString, jwtGuard, jwtHandshakeGuard, markdownToTelegramHtml, max, memExtension, middleware, min, mindset, mindsetModule, modelInfo, num, numArr, obj, onDelete, onGet, onPost, onPut, onSocketEvent, parseQueryMethodName, pgExtension, pgStorage, query, queryExtension, readJsonFromFile, repository, resolveConfigReferences, restController, run, runChatAdapters, runChatControllers, runCmdClient, runCommandHandlers, runCronHandlers, runRestControllers, runSocketControllers, safeJsonParse, scanProjectFiles, scoped, setupErrorHandlers, singleton, socket, socketChannelName, socketController, stopCommandHandlers, stopCronHandlers, str, strArr, telegram, telegramChannelName, transaction, validateAndTransform, validateArray, validateIsBoolean, validateIsDate, validateIsIn, validateIsNotEmpty, validateIsNumber, validateIsPresent, validateIsRecord, validateIsString, validateMax, validateMin, validateModel, wasender, wasenderChannelName, withPgClient, withPgTransaction, writeJsonToFile };
+export { AnthropicChatAdapter, ApiKey, ApiKeyGuardMiddleware, ApiKeyHandshakeGuardMiddleware, ApiKeyRepository, Async, AsyncMetadataStore, Auth, Chat, ChatAdapter, ChatAdapterMetadataStore, ChatAdapterRegistry, ChatBot, ChatBotMetadataStore, ChatItem, ChatMemory, ChatOperator, ChatRepository, ChatResolver, type ClientMap, CmdChannel, CmdChannelConfig, CmdChannelServer, type CmdClientMessage, type CmdServerMessage, type ConfigReference, type ConfigReferenceType, ConfigResolver, Container, ControllerMetadataStore, CronJob, CronJobRepository, CrudRepository, CustomError, DeepSeekChatAdapter, DescriptionMetadataStore, EXPRESS_REQ, EXPRESS_RES, Entity, Env, type ErrorSeverity, ExpressProvider, GoogleChatAdapter, type GoogleChatAdapterV2Options, HtmlModule, HttpServerProvider, type IApiKeyData, type IApiKeyRepository, type IArrayValidationError, type IArrayValidationResult, type IBotMessageItem, type IBuiltQuery, type IChannelMessage, type IChannelMetadata, type IChatAdapter, type IChatAdapterDecoratorConfig, type IChatAdapterMetadata, type IChatAdapterNextItemsReq, type IChatAdapterNextItemsRes, type IChatAssociation, type IChatBot, type IChatBotMetadata, type IChatChannel, type IChatConnection, type IChatControllerMetadata, type IChatData, type IChatItem, type IChatItemData, type IChatItemType, type IChatMemory, type IChatMessage, type IChatMessageDocument, type IChatMessageFile, type IChatMessageImage, type IChatMessagesPrivateFile, type IChatMessagesPublicFile, type IChatRepository, type IChatType, type ICmdChannelEntry, type ICmdChannelHandlers, type ICmdChannelMessage, type ICmdReceivedMessage, type ICommandConfig, type ICommandHandler, type ICommandHandlerConfig, type IConstructor, type ICronConfig, type ICronHandler, type ICronJobData, type ICronJobRepository, type ICrudRepository, type ICustomErrorData, type IDedupConfig, type IDescriptionMetadata, type IEndPointConfig, type IEndPointMetadata, type IEntityData, type IEnvType, type IErrorHandlersConfig, type IErrorMonitor, type IErrorMonitorContext, type IExtractChatMessageTextOptions, type IFunctionCall, type IFunctionCallItem, type IGenerateApiKeyReq, type IGenerateApiKeyRes, type IHandshakeMiddleware, type IHandshakeMiddlewareMetadata, type IHtmlModuleOptions, type IHumanMessageItem, type IJobData, type IJobOptions, type IJobRepository, type IJwtRefreshTokenData, type IJwtRefreshTokenRepository, type IKapsoChannelConfig, type IKapsoChannelMessage, type IKapsoChannelMessageListener, type IKapsoChatMessage, type IKapsoConversation, type IKapsoEvent, type IKapsoIncomingMessage, type IKapsoMessageReceivedEvent, type IKapsoReceivedMessage, type IKapsoUnknownEvent, type ILanguageModelUsage, type ILockKey, type ILocker, type ILockerKey, type IMemoryRepositoryAdapterOptions, type IMessageContext, type IMiddleware, type IMiddlewareMetadata, type IMindset, type IMindsetConfig, type IMindsetIdentity, type IMindsetLlm, type IMindsetMetadata, type IMindsetModelKind, type IMindsetModelRef, type IMindsetModels, type IMindsetModuleConfig, type IMindsetModuleMetadata, type IMindsetParameterSchema, type IMindsetTool, type IMindsetToolParameter, type IModelValidationError, type IModelValidationResult, type IModelValidatorsInfo, type IMoneyData, type IPersistentData, type IPgRepositoryConfig, type IProjectRunnerConfig, type IPropertyValidatorInfo, type IQueryAst, type IQueryCondition, type IQueryMethodMetadata, type IQueryOrderBy, type IReceivedMessage, type IRemoteApiKeyFetcher, type IRepositoryAdapter, type IRepositoryConfig, type IRepositoryRuntime, type IRestControllerConfig, type IRestControllerMetadata, type IScanProjectFilesOptions, type IScheduleAt, type IScheduleDelay, type ISendWhatsAppMessageReq, type ISendWhatsAppTemplateReq, type ISocketChannelConfig, type ISocketChannelMessage, type ISocketChannelReceivedMessage, type ISocketControllerConfig, type ISocketControllerMetadata, type ISocketEventConfig, type ISocketEventMetadata, type ISocketReceivedMessage, type IStorableData, type ITelegramChannelConfig, type ITelegramChannelMessage, type ITelegramReceivedMessage, type ITransactionAdapter, type IValidateArrayOptions, type IValidateArrayOptionsWithItemsValidators, type IValidateInputShape, type IValidateIsInOptions, type IValidateIsRecordOptions, type IValidateMaxOptions, type IValidateMinOptions, type IValidationError, type IValidationResult, type IValidator, type IValidatorMetadata, type IWasenderChannelConfig, type IWasenderChannelMessageListener, type IWasenderDeviceListMetadata, type IWasenderEvent, type IWasenderMessageContent, type IWasenderMessageContextInfo, type IWasenderMessageKey, type IWasenderMessageReceivedData, type IWasenderMessageReceivedEvent, type IWasenderQrUpdatedEvent, type IWasenderReceivedMessage, type IWhatsAppCloudContact, type IWhatsAppCloudMessage, type IWhatsAppCloudMessageMetadata, type IWhatsAppCloudTemplate, type IWhatsAppCloudTemplateComponent, type IWhatsAppCloudTemplateResponse, type IWhatsAppCloudWebhookPayload, type IWhatsAppSender, type IWhatsAppTemplateData, type IWhatsAppTemplateParameter, type IchatControllerConfig, InMemoryChatMemory, InMemoryChatRepository, InMemoryCronJobRepository, InMemoryJobRepository, InMemoryLockKey, InMemoryLocker, Job, JobRepository, JobRunner, Jwt, JwtAccessAndRefreshTokenDto, JwtConfig, JwtGuardMiddleware, JwtHandshakeGuardMiddleware, JwtRefreshToken, JwtRefreshTokenRepository, JwtSigner, JwtTokenDto, KapsoChannel, KapsoChannelConfig, KapsoReceiver, KapsoSender, KapsoWebhookController, Lifecycle, Locker, Logger, MEMORY_ADAPTER_ID, Mapper, MemoryRepositoryAdapter, MemoryRepositoryExtension, Mindset, MindsetMetadataStore, MindsetOperator, Money, MoneyDto, OpenRouterChatAdapter, OpenaiChatAdapter, PG_ADAPTER_ID, Password, type PasswordHashOptions, Persistent, PgApiKeyRepository, PgChatMemory, PgChatRepository, PgCronJobRepository, PgCrudRepository, PgJobRepository, PgJsonRepositoryAdapter, PgJwtRefreshTokenRepository, PgLockKey, PgLocker, PgRepositoryBase, PgRepositoryBase as PgRepositoryExtension, PgTransactionAdapter, ProjectRunner, type QueryConnector, type QueryOperator, type QueryPrefix, Random, RemoteApiKeyRepository, RepositoryAdapterRegistry, RepositoryMetadataStore, type ResolvedConfig, RestControllerMetadataStore, RestRequest, SocketChannel, SocketChannelConfig, SocketChannelMessageFile, SocketChannelReceivedMessage, SocketControllerMetadataStore, SocketServerConfig, SocketServerProvider, Storable, TelegramChannel, TelegramChannelConfig, TransactionMetadataStore, UnionChatAdapter, ValidationMetadataStore, WabotChatAdapter, WasenderChannel, WasenderChannelConfig, WasenderReceiver, WasenderSender, WasenderWebhookController, WhatsAppApiSender, WhatsAppReceiverByCloudApi, WhatsAppSender, apiKeyGuard, apiKeyHandshakeGuard, bool, boolArr, buildQuerySql, chatAdapter, chatBot, chatController, chatItemTypeOptions, cmd, cmdChannelName, cmdChannelSocketPath, command, commandHandler, computeDedupKey, container, cronHandler, description, errorToPlainObject, evaluateQueryAst, extractChatMessageText, extractNumberFromWasenderMessageKey, getClientMap, getPgClient, handshakeMiddlewares, inject, injectable, isArray, isBoolean, isChatMessageEmpty, isDate, isIn, isModel, isNotEmpty, isNumber, isOptional, isPresent, isRecord, isRetryableError, isString, jwtGuard, jwtHandshakeGuard, kapso, kapsoChannelName, markdownToTelegramHtml, max, memExtension, middleware, min, mindset, mindsetModule, modelInfo, num, numArr, obj, onDelete, onGet, onPost, onPut, onSocketEvent, parseQueryMethodName, pgExtension, pgStorage, query, queryExtension, readJsonFromFile, repository, resolveConfigReferences, restController, run, runChatAdapters, runChatControllers, runCmdClient, runCommandHandlers, runCronHandlers, runRestControllers, runSocketControllers, safeJsonParse, scanProjectFiles, scoped, setupErrorHandlers, singleton, socket, socketChannelName, socketController, stopCommandHandlers, stopCronHandlers, str, strArr, telegram, telegramChannelName, transaction, validateAndTransform, validateArray, validateIsBoolean, validateIsDate, validateIsIn, validateIsNotEmpty, validateIsNumber, validateIsPresent, validateIsRecord, validateIsString, validateMax, validateMin, validateModel, wasender, wasenderChannelName, withPgClient, withPgTransaction, writeJsonToFile };

package/dist/src/index.js

@@ -51,6 +51,7 @@ export { Async } from './feature/async/Async.js';
 export { AsyncMetadataStore } from './feature/async/AsyncMetadataStore.js';
 export { CronJob } from './feature/async/CronJob.js';
 export { CronJobRepository } from './feature/async/CronJobRepository.js';
+export { computeDedupKey } from './feature/async/computeDedupKey.js';
 export { Job } from './feature/async/Job.js';
 export { JobRepository } from './feature/async/JobRepository.js';
 export { JobRunner } from './feature/async/JobRunner.js';
@@ -180,6 +181,13 @@ export { telegramChannelName } from './addon/chat-controller/telegram/telegramCh
 export { markdownToTelegramHtml } from './addon/chat-controller/telegram/markdownToTelegramHtml.js';
 export { WhatsAppReceiverByCloudApi } from './addon/chat-controller/whatsapp/cloud-api/WhatsAppReceiverByCloudApi.js';
 export { WhatsAppApiSender } from './addon/chat-controller/whatsapp/cloud-api/WhatsAppApiSender.js';
+export { kapso } from './addon/chat-controller/whatsapp/kapso/@kapso.js';
+export { KapsoChannel } from './addon/chat-controller/whatsapp/kapso/KapsoChannel.js';
+export { KapsoChannelConfig } from './addon/chat-controller/whatsapp/kapso/KapsoChannelConfig.js';
+export { kapsoChannelName } from './addon/chat-controller/whatsapp/kapso/KapsoChannelName.js';
+export { KapsoReceiver } from './addon/chat-controller/whatsapp/kapso/KapsoReceiver.js';
+export { KapsoSender } from './addon/chat-controller/whatsapp/kapso/KapsoSender.js';
+export { KapsoWebhookController } from './addon/chat-controller/whatsapp/kapso/KapsoWebhookController.js';
 export { wasender } from './addon/chat-controller/whatsapp/wasender/@wasender.js';
 export { WasenderChannel } from './addon/chat-controller/whatsapp/wasender/WasenderChannel.js';
 export { WasenderChannelConfig } from './addon/chat-controller/whatsapp/wasender/WasenderChannelConfig.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wabot-dev/framework",
-  "version": "0.9.19",
+  "version": "0.9.21",
   "description": "Framework for IA Chat Bots",
   "type": "module",
   "main": "dist/src/index.js",