openWa / src /modules /message /message-status.util.ts
harsh
Deploy: Initial commit without binaries
525d39f
Raw History Blame Contribute Delete
1.61 kB
import { MessageStatus } from './entities/message.entity';
/**
* Maps a whatsapp-web.js ack level to the delivery status it implies, or null
* when the ack carries no upgrade beyond the stored `SENT` state.
*
* wwebjs MessageAck: -1 ERROR, 0 PENDING, 1 SERVER (sent), 2 DEVICE (delivered),
* 3 READ, 4 PLAYED. This is how the stored message reflects *real* delivery
* state (#220): a send that never receives ack≥2 stays `SENT`, visibly
* "not delivered".
*/
export function ackToMessageStatus(ack: number): MessageStatus | null {
if (ack < 0) return MessageStatus.FAILED;
if (ack >= 3) return MessageStatus.READ;
if (ack === 2) return MessageStatus.DELIVERED;
return null; // 0 (pending) / 1 (server-received) — message is already SENT, no upgrade
}
/**
* The stored statuses a delivery transition may advance FROM. Used as a conditional UPDATE guard so
* delivery state only moves forward — preventing an out-of-order/late ack from downgrading a higher
* status (e.g. a DELIVERED ack arriving after READ), even though the writes are fire-and-forget.
* A late FAILED must not clobber a message already confirmed delivered/read, and vice versa.
*/
export function ackStatusTransitionFrom(target: MessageStatus): MessageStatus[] {
switch (target) {
case MessageStatus.DELIVERED:
return [MessageStatus.PENDING, MessageStatus.SENT];
case MessageStatus.READ:
return [MessageStatus.PENDING, MessageStatus.SENT, MessageStatus.DELIVERED];
case MessageStatus.FAILED:
return [MessageStatus.PENDING, MessageStatus.SENT];
default:
return [];
}
}