zaileys 4.17.0 → 4.18.0

package/dist/client/types.d.ts

@@ -161,7 +161,14 @@ export type ConnectionEventMap = {
         command: string;
         message: MessageContext;
     };
-    /** Cloud provider: delivery lifecycle of outbound messages (sent/delivered/read/failed). */
+    /**
+     * Delivery lifecycle of outbound messages (sent/delivered/read/failed).
+     *
+     * Emitted by both transports. On the Cloud provider it comes from status
+     * webhooks; on a linked device it is decoded from Baileys acks. The payload
+     * is the same either way — `conversationId` and `error` are Cloud-only and
+     * simply absent on a linked device.
+     */
     'message-status': CloudStatusEvent;
     /** Cloud provider: template review lifecycle (APPROVED/REJECTED/PAUSED...). */
     'template-status': CloudTemplateStatusEvent;

package/dist/events/decoders/mutations.d.ts

@@ -1,4 +1,5 @@
 import { proto, type WAMessageKey } from 'baileys';
+import type { CloudStatusEvent } from '../../cloud/translate/inbound.js';
 import type { DeletePayload, EditPayload, PollVotePayload, ReactionPayload } from '../types.js';
 import { type LongLike } from './_shared.js';
 export interface MutationContext {
@@ -24,3 +25,15 @@ export declare const decodeReaction: (item: ReactionItem, ctx: MutationContext)
 export declare const decodeEdit: (update: MessageUpdate, ctx: MutationContext) => EditPayload | null;
 export declare const decodeDelete: (update: MessageUpdate, ctx: MutationContext) => DeletePayload | null;
 export declare const decodePollVote: (update: MessageUpdate, ctx: MutationContext) => PollVotePayload | null;
+/**
+ * Decodes a delivery receipt for a message **we** sent.
+ *
+ * `messages.update` carries every kind of change, including ones about messages
+ * other people sent. A receipt is only meaningful for our own outbound
+ * messages, so anything without `fromMe` is not ours to report.
+ *
+ * The payload shape matches `CloudStatusEvent` on purpose: a consumer should
+ * not need to know which transport a channel happens to use to learn whether
+ * its message arrived.
+ */
+export declare const decodeReceipt: (update: MessageUpdate) => CloudStatusEvent | null;