@whanext/core 0.19.20 → 0.19.22

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.19.22
+### Fixed
+- Corrige falsos `duplicate` em mensagens de grupo quando o Zapo emite primeiro um shell interno de Sender Key/protocolo sem conteúdo e depois a mensagem real reutilizando o mesmo stanza ID.
+- Shells vazios `unknown` não são mais publicados nem consomem a chave de deduplicação; a mensagem real de texto/mídia continua chegando normalmente ao dispatcher.
+
+## 0.19.21
+
+### Added
+- `MessageService.edit()` accepts an optional protocol-level `id` override for the outgoing edit envelope.
+
+### Zapo
+- Forwards the optional edit `id` to `WaSendMessageOptions.id`, enabling specialized moderation workflows without exposing the provider client.
+
 ## 0.19.20
 
 ### Ingress diagnostics

package/dist/index.d.ts

@@ -163,6 +163,13 @@ type MentionTarget = string | User;
 interface RepostMessageOptions {
     mentions?: readonly MentionTarget[];
 }
+interface EditMessageOptions {
+    /**
+     * Overrides the stanza id used by the outgoing edit envelope.
+     * Advanced/protocol-level option; omitted for normal edits.
+     */
+    id?: string;
+}
 interface TextContent {
     text: string;
     mentions?: MentionTarget[];
@@ -480,7 +487,7 @@ interface WhatsAppProvider {
     repostMessage(source: MessageKey, chatId: string, options?: RepostMessageOptions): Promise<SentMessage>;
     reactToMessage(key: MessageKey, emoji?: string): Promise<SentMessage>;
     downloadMedia(key: MessageKey): Promise<DownloadedMedia>;
-    editMessage(key: MessageKey, content: string): Promise<SentMessage>;
+    editMessage(key: MessageKey, content: string, options?: EditMessageOptions): Promise<SentMessage>;
     deleteMessage(key: MessageKey): Promise<void>;
     getGroup(groupId: string): Promise<GroupSnapshot>;
     setGroupAccess(groupId: string, access: GroupAccess): Promise<void>;
@@ -686,7 +693,7 @@ declare class MessageService {
      * media and structured WhatsApp messages as well as text.
      */
     repost(source: Message | MessageKey, chatId: string, options?: RepostMessageOptions): Promise<SentMessage>;
-    edit(message: Message | SentMessage | MessageKey, text: string): Promise<SentMessage>;
+    edit(message: Message | SentMessage | MessageKey, text: string, options?: EditMessageOptions): Promise<SentMessage>;
     delete(message: Message | SentMessage | MessageKey): Promise<void>;
     react(message: Message | SentMessage | MessageKey, emoji: string): Promise<SentMessage>;
     unreact(message: Message | SentMessage | MessageKey): Promise<SentMessage>;
@@ -1207,4 +1214,4 @@ declare class SqliteMuteStore implements MuteStore {
     close(): void;
 }
 
-export { AccountService, type AddMuteOptions, type AddMuteResult, type AppEvents, type AppHealth, type AppHealthStatus, ArgsParser, type AudioContent, type BooleanOption, Browser, type ButtonsContent, type CacheOptions, type CacheStore, type CallEvent, type CallStatus, type ChangeResult, type CommandAccountContext, type CommandCatalogOptions, type CommandCatalogView, type CommandChatContext, type CommandConcurrency, type CommandConcurrencyContext, type CommandConcurrencyEvent, type CommandConcurrencyHealth, type CommandContext, type CommandCooldown, type CommandDefinition, type CommandErrorHandler, type CommandGroupContext, type CommandGroupDefinition, type CommandGuard, type CommandHelpOptions, type CommandHooks, type CommandLocalization, type CommandMetadata, type CommandMiddleware, type CommandOptionDefinition, type CommandOptionSchema, type CommandOptionValue, type CommandOptionValues, type CommandQueueFullEvent, type CommandQueueTimeoutEvent, type CommandRegistrar, CommandRouter, type CommandRouterEvents, type CommandRuntimeServices, type CommandScope, type ConcurrencyStrategy, type ConnectionRecoveredEvent, type ConnectionState, type ConnectionUpdate, type CopyCodeButton, type CreateMultiOptions, type CreateOptions, type CryptoAccelerationBackend, type CryptoDegradationKind, type CryptoDegradedEvent, DeferredReply, type DownloadedMedia, type DurationOption, type EnumOption, type ExecutableCommandDefinition, type GroupAccess, type GroupAddressingMode, type GroupMetadataRecoveredEvent, type GroupParticipant, type GroupParticipantAction, type GroupParticipantsChanged, type GroupRole, type GroupSnapshot, type GuardResult, type HealthChangedEvent, type ImageContent, type InteractiveResponse, type InteractiveResponseKind, type InviteResult, type LinkButton, type ListContent, type ListRow, type ListSection, type LoadCommandsOptions, type LoadCommandsResult, type LoadedCommand, type LogContext, type LogEntry, type LogFormat, type LogLevel, type LogWriter, Logger, type LoggerConfig, type LoggerOptions, type LoginOptions, type MediaKind, type MediaSource, type MemberActionState, MemoryCache, type MemoryCacheStats, type MentionTarget, type Message, type MessageButton, type MessageContent, type MessageContentKind, type MessageDecodeFailureEvent, type MessageDeleted, type MessageDiscardReason, type MessageDiscardedEvent, type MessageEdited, type MessageIngressStage, type MessageIngressStalledEvent, type MessageKey, type MessageMedia, type MessagePayloadKind, type MessageProtocolKind, type MessageRecoveredEvent, type MessageRecoveryFailedEvent, type MessageUnavailableEvent, type MultiAccountOptions, type MultiAppEvent, type MultiAppHealth, MultiCommandRouter, type MultiLoadCommandsResult, type MultiLoginOptions, type MuteChangeResult, type MuteEnforcement, type MuteOptions, type MuteRecord, MuteService, type MuteStore, type NumberOption, ParsedCommandOptions, type ParticipantUpdateResult, type PollContent, type PresenceState, type ProviderConnectionHealth, type ProviderCryptoHealth, type ProviderDiagnosticsOptions, type ProviderGroupHealth, type ProviderHealth, type ProviderMessagingHealth, type ProviderStabilityEvent, type ProviderTimeoutHealth, type ProviderTimeoutOptions, type QuickReplyButton, type QuotedMessage, type ReconnectOptions, type RegisteredCommand, type RemoveMuteResult, type ReplyOptions, type RepostMessageOptions, type RouterOptions, type SentMessage, SqliteMuteStore, type StabilityHealthStatus, type StickerContent, type StoredMute, type StringOption, type TextContent, type TransportDecodeFailureEvent, User, type UserData, type UserOption, type VideoContent, WhaNextApp, WhaNextError, type WhaNextErrorCode, WhaNextMultiApp, type WhatsAppProvider, create, createMulti, defineCommand, defineCommandGroup, defineCommands, defineSubcommand, guards, isCommandGroup, loadCommands, option, toWhaNextError };
+export { AccountService, type AddMuteOptions, type AddMuteResult, type AppEvents, type AppHealth, type AppHealthStatus, ArgsParser, type AudioContent, type BooleanOption, Browser, type ButtonsContent, type CacheOptions, type CacheStore, type CallEvent, type CallStatus, type ChangeResult, type CommandAccountContext, type CommandCatalogOptions, type CommandCatalogView, type CommandChatContext, type CommandConcurrency, type CommandConcurrencyContext, type CommandConcurrencyEvent, type CommandConcurrencyHealth, type CommandContext, type CommandCooldown, type CommandDefinition, type CommandErrorHandler, type CommandGroupContext, type CommandGroupDefinition, type CommandGuard, type CommandHelpOptions, type CommandHooks, type CommandLocalization, type CommandMetadata, type CommandMiddleware, type CommandOptionDefinition, type CommandOptionSchema, type CommandOptionValue, type CommandOptionValues, type CommandQueueFullEvent, type CommandQueueTimeoutEvent, type CommandRegistrar, CommandRouter, type CommandRouterEvents, type CommandRuntimeServices, type CommandScope, type ConcurrencyStrategy, type ConnectionRecoveredEvent, type ConnectionState, type ConnectionUpdate, type CopyCodeButton, type CreateMultiOptions, type CreateOptions, type CryptoAccelerationBackend, type CryptoDegradationKind, type CryptoDegradedEvent, DeferredReply, type DownloadedMedia, type DurationOption, type EditMessageOptions, type EnumOption, type ExecutableCommandDefinition, type GroupAccess, type GroupAddressingMode, type GroupMetadataRecoveredEvent, type GroupParticipant, type GroupParticipantAction, type GroupParticipantsChanged, type GroupRole, type GroupSnapshot, type GuardResult, type HealthChangedEvent, type ImageContent, type InteractiveResponse, type InteractiveResponseKind, type InviteResult, type LinkButton, type ListContent, type ListRow, type ListSection, type LoadCommandsOptions, type LoadCommandsResult, type LoadedCommand, type LogContext, type LogEntry, type LogFormat, type LogLevel, type LogWriter, Logger, type LoggerConfig, type LoggerOptions, type LoginOptions, type MediaKind, type MediaSource, type MemberActionState, MemoryCache, type MemoryCacheStats, type MentionTarget, type Message, type MessageButton, type MessageContent, type MessageContentKind, type MessageDecodeFailureEvent, type MessageDeleted, type MessageDiscardReason, type MessageDiscardedEvent, type MessageEdited, type MessageIngressStage, type MessageIngressStalledEvent, type MessageKey, type MessageMedia, type MessagePayloadKind, type MessageProtocolKind, type MessageRecoveredEvent, type MessageRecoveryFailedEvent, type MessageUnavailableEvent, type MultiAccountOptions, type MultiAppEvent, type MultiAppHealth, MultiCommandRouter, type MultiLoadCommandsResult, type MultiLoginOptions, type MuteChangeResult, type MuteEnforcement, type MuteOptions, type MuteRecord, MuteService, type MuteStore, type NumberOption, ParsedCommandOptions, type ParticipantUpdateResult, type PollContent, type PresenceState, type ProviderConnectionHealth, type ProviderCryptoHealth, type ProviderDiagnosticsOptions, type ProviderGroupHealth, type ProviderHealth, type ProviderMessagingHealth, type ProviderStabilityEvent, type ProviderTimeoutHealth, type ProviderTimeoutOptions, type QuickReplyButton, type QuotedMessage, type ReconnectOptions, type RegisteredCommand, type RemoveMuteResult, type ReplyOptions, type RepostMessageOptions, type RouterOptions, type SentMessage, SqliteMuteStore, type StabilityHealthStatus, type StickerContent, type StoredMute, type StringOption, type TextContent, type TransportDecodeFailureEvent, User, type UserData, type UserOption, type VideoContent, WhaNextApp, WhaNextError, type WhaNextErrorCode, WhaNextMultiApp, type WhatsAppProvider, create, createMulti, defineCommand, defineCommandGroup, defineCommands, defineSubcommand, guards, isCommandGroup, loadCommands, option, toWhaNextError };

package/dist/index.js

@@ -2239,9 +2239,9 @@ var MessageService = class {
     const key = "keys" in source ? source.keys : source;
     return this.#provider.repostMessage(key, chatId, options);
   }
-  edit(message, text) {
+  edit(message, text, options = {}) {
     const key = "keys" in message ? message.keys : message;
-    return this.#provider.editMessage(key, text);
+    return this.#provider.editMessage(key, text, options);
   }
   delete(message) {
     const key = "keys" in message ? message.keys : message;
@@ -3491,12 +3491,15 @@ var ZapoProvider = class {
       );
     }
   }
-  async editMessage(key, content) {
+  async editMessage(key, content, options = {}) {
     return this.#trackOutgoing(async () => {
       const result = await this.#requireClient().message.send(
         key.chatId,
         content,
-        { editKey: this.#toZapoKey(key) }
+        {
+          editKey: this.#toZapoKey(key),
+          ...options.id ? { id: options.id } : {}
+        }
       );
       return this.#sent(result, key.chatId);
     });
@@ -3922,15 +3925,6 @@ var ZapoProvider = class {
       });
       return;
     }
-    if (stored.key.id && this.#deliveredMessageStore.has(deliveryKey)) {
-      this.#duplicateMessages += 1;
-      this.#emitMessageDiscarded("duplicate", stored.key);
-      this.#logger.debug("Ignored duplicate Zapo message event.", {
-        messageId: stored.key.id,
-        chatId: stored.key.remoteJid ?? void 0
-      });
-      return;
-    }
     const message = normalizeZapoMessage(event);
     if (!message) {
       this.#normalizationFailures += 1;
@@ -3941,6 +3935,18 @@ var ZapoProvider = class {
       });
       return;
     }
+    if (this.#isEmptyMessageShell(message)) {
+      return;
+    }
+    if (stored.key.id && this.#deliveredMessageStore.has(deliveryKey)) {
+      this.#duplicateMessages += 1;
+      this.#emitMessageDiscarded("duplicate", stored.key);
+      this.#logger.debug("Ignored duplicate Zapo message event.", {
+        messageId: stored.key.id,
+        chatId: stored.key.remoteJid ?? void 0
+      });
+      return;
+    }
     if (stored.key.id) this.#rememberDeliveredMessage(deliveryKey);
     this.#receivedMessages += 1;
     this.#lastIncomingAt = /* @__PURE__ */ new Date();
@@ -5063,6 +5069,9 @@ var ZapoProvider = class {
       return void 0;
     }
   }
+  #isEmptyMessageShell(message) {
+    return message.contentKind === "unknown" && message.text === void 0 && message.caption === void 0 && message.media === void 0 && message.interactive === void 0 && (message.protocolKinds?.length ?? 0) === 0 && (message.payloadKinds?.length ?? 0) === 0;
+  }
   #messageStoreKey(key) {
     return `${key.remoteJid ?? ""}:${key.id ?? ""}:${key.participant ?? key.participantAlt ?? ""}`;
   }