Free, Open Source, Self-Hosted WhatsApp API Gateway
TypeScript apibotgatewayself-hostedwhatsappwhatsapp-apiwhatsapp-automationwhatsapp-botwhatsapp-gatewaywhatsapp-gateway-apiwhatsapp-webwhatsapp-web-api
import { BadRequestException, Injectable, NotFoundException } from '@nestjs/common';
import { EngineRegistry } from '../../engine/engine-registry.service';
import { IWhatsAppEngine } from '../../engine/interfaces/whatsapp-engine.interface';
/**
* Owns engine access for label operations so the "session not started" guard and label
* business rules (not-found mapping) live behind the service boundary, not in the controller.
*/
@Injectable()
export class LabelService {
constructor(private readonly engines: EngineRegistry) {}
private getEngine(sessionId: string): IWhatsAppEngine {
// EngineRegistry.require()'s default is this exact 400 "Session is not started".
return this.engines.require(sessionId);
}
getLabels(sessionId: string) {
return this.getEngine(sessionId).getLabels();
}
async getLabelById(sessionId: string, labelId: string) {
const label = await this.getEngine(sessionId).getLabelById(labelId);
if (!label) {
throw new NotFoundException(`Label ${labelId} not found`);
}
return label;
}
getChatLabels(sessionId: string, chatId: string) {
return this.getEngine(sessionId).getChatLabels(chatId);
}
/**
* Create or update a label. One operation on purpose: WhatsApp carries a single `label_edit`
* write keyed by the label id, so whether this creates or updates depends only on whether that id
* already exists — which is also why the caller chooses the id rather than being handed one.
*/
upsertLabel(sessionId: string, labelId: string, body: { name?: string; color?: number }) {
// Both fields are individually optional, but the write replaces the whole label, so an omitted
// field is not kept (a colour-only write clears the name). A body that sets neither has nothing to
// write, so it is refused like the group-settings PUT refuses an empty patch. `null` counts as
// "not set": class-validator's @IsOptional skips validation for it and class-transformer keeps
// it, so {"name": null} reached here as an explicit nothing.
const name = body.name ?? undefined;
const color = body.color ?? undefined;
if (name === undefined && color === undefined) {
throw new BadRequestException('At least one of name or color must be provided');
}
return this.getEngine(sessionId).upsertLabel({
id: labelId,
...(name === undefined ? {} : { name }),
...(color === undefined ? {} : { color }),
});
}
deleteLabel(sessionId: string, labelId: string) {
return this.getEngine(sessionId).deleteLabel(labelId);
}
getChatsByLabel(sessionId: string, labelId: string) {
return this.getEngine(sessionId).getChatsByLabel(labelId);
}
addLabelToChat(sessionId: string, chatId: string, labelId: string) {
return this.getEngine(sessionId).addLabelToChat(chatId, labelId);
}
removeLabelFromChat(sessionId: string, chatId: string, labelId: string) {
return this.getEngine(sessionId).removeLabelFromChat(chatId, labelId);
}
}