52 lines
1.5 KiB
TypeScript
52 lines
1.5 KiB
TypeScript
import { syscall } from "../syscall.ts";
|
|
import type { MQStats } from "../types.ts";
|
|
|
|
/**
|
|
* Implements a simple Message Queue system.
|
|
* @module
|
|
*/
|
|
|
|
/**
|
|
* Sends a message to a queue.
|
|
* @param queue the name of the queue to send the message to
|
|
* @param body the body of the message to send
|
|
*/
|
|
export function send(queue: string, body: any): Promise<void> {
|
|
return syscall("mq.send", queue, body);
|
|
}
|
|
|
|
/**
|
|
* Sends a batch of messages to a queue.
|
|
* @param queue the name of the queue
|
|
* @param bodies the bodies of the messages to send
|
|
*/
|
|
export function batchSend(queue: string, bodies: any[]): Promise<void> {
|
|
return syscall("mq.batchSend", queue, bodies);
|
|
}
|
|
|
|
/**
|
|
* Acknowledges a message from a queue, in case it needs to be explicitly acknowledged.
|
|
* @param queue the name of the queue the message came from
|
|
* @param id the id of the message to acknowledge
|
|
*/
|
|
export function ack(queue: string, id: string): Promise<void> {
|
|
return syscall("mq.ack", queue, id);
|
|
}
|
|
|
|
/**
|
|
* Acknowledges a batch of messages from a queue, in case they need to be explicitly acknowledged.
|
|
* @param queue the name of the queue the messages came from
|
|
* @param ids the ids of the messages to acknowledge
|
|
*/
|
|
export function batchAck(queue: string, ids: string[]): Promise<void> {
|
|
return syscall("mq.batchAck", queue, ids);
|
|
}
|
|
|
|
/**
|
|
* Retrieves stats on a particular queue.
|
|
* @param queue the name of the queue
|
|
*/
|
|
export function getQueueStats(queue: string): Promise<MQStats> {
|
|
return syscall("mq.getQueueStats", queue);
|
|
}
|