whatsapp_notifier 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a84b4298c91af2e175b2a8aa46fd2b9101e5b5729558f1387325a8c39894a31
-  data.tar.gz: e11b629a0b342288eb8199ed95eaf6aa72f9d7ce557984c76e71b58f2e37bb4c
+  metadata.gz: e65ad0d6844d9762bccd0a929a9d70613a0e9fb145564b75c35f196fc87e4088
+  data.tar.gz: 109a415b4a618aac44d5ce9da4f886590a600e8bdb9168ada01e740e9b5add9f
 SHA512:
-  metadata.gz: ed49385c1ea444b94a1ee99ca5ec1c891145bb5474a63544e314a715f85dab8712b743908ce1765efd9c1981b476287c62ed24930061a5fb5a667f2ff781011a
-  data.tar.gz: 5b7eaec3a131a137edc5ce9dcba1e7cadcabe74bf210ef167975bb6952ac087b803a31d573f6c67b62f188be8d6c6593cd503a371cbdf57e91337a3ddf06f14e
+  metadata.gz: 45cbd20b37120dd2b533db5fa28b31dddbbbb00a06538c5a8c75cccd458d2f598c9d2089b898ed890b8cb88693613849d8ca036743d96bbba0d482cf121c70b4
+  data.tar.gz: e63080fe514ff18d3f225baebeefef3856b10f83d80087c7c7a33e3b50cc5a150cdc4a964646520a5f866685c13dd08c14f0a8888bed93fc2df5403676eab93a

data/README.md

@@ -57,9 +57,11 @@ status = WhatsAppNotifier.connection_status(metadata: { user_id: current_user.id
 ## Log out (disconnect + clear session)
 
 Explicitly disconnects the user and wipes their saved WhatsApp session from the
-service, so the next connect starts fresh with a new QR. Call this from a
-user-initiated "Log out WhatsApp" action — NOT from your app's sign-out, which
-should leave the WhatsApp session intact for the next login.
+service — including any downloaded inbound media and queued replies, which
+belong to the old pairing — so the next connect starts fresh with a new QR.
+Call this from a user-initiated "Log out WhatsApp" action — NOT from your
+app's sign-out, which should leave the WhatsApp session intact for the next
+login.
 
 ```ruby
 WhatsAppNotifier.logout(metadata: { user_id: current_user.id })
@@ -144,6 +146,21 @@ creates a WhatsApp client — so it is safe to poll every few seconds:
 those have a fully hydrated WhatsApp Web store. Prometheus metrics live at
 `GET /metrics`.
 
+## Upgrading to 0.7.0
+
+- **If your app monkey-patches `WhatsAppNotifier::WebAdapter#request`** (a
+  common trick to bolt TLS onto the service URL): the shared JSON path now
+  also carries `DELETE` (`delete_media`) and attaches `X-WA-Token` when
+  `WHATSAPP_WEBHOOK_TOKEN` is set. A patch that only routes `POST`/`GET` or
+  drops headers will break the new media calls. Prefer retiring the patch
+  entirely — the adapter now honors `https://` service URLs natively on both
+  the JSON control plane and the binary media path (`use_ssl` follows the URL
+  scheme), so TLS no longer needs a patch.
+- **Logout now wipes stored media**: `POST /logout` removes the user's
+  downloaded inbound media along with the session dir and queued replies.
+  Fetch (and ideally `delete_media`) anything you want to keep before logging
+  a user out.
+
 ## Notes
 
 - This gem uses WhatsApp Web automation. Use responsibly and follow WhatsApp policies.

data/lib/generators/whatsapp_notifier/install_service_generator.rb

@@ -12,9 +12,12 @@ module WhatsAppNotifier
       # host app. The app rebuilds deps with `bun install`.
       SERVICE_FILES = %w[
         index.ts
+        history.ts
         inbound.ts
         init_gate.ts
+        media.ts
         metrics.ts
+        send.ts
         sessions.ts
         package.json
         bun.lock

data/lib/whatsapp_notifier/client.rb

@@ -31,6 +31,26 @@ module WhatsAppNotifier
       provider_for(provider || @configuration.provider).fetch_inbound(metadata: metadata)
     end
 
+    def fetch_media(message_id:, metadata: {}, provider: nil)
+      provider_for(provider || @configuration.provider).fetch_media(message_id: message_id, metadata: metadata)
+    end
+
+    def delete_media(message_id:, metadata: {}, provider: nil)
+      provider_for(provider || @configuration.provider).delete_media(message_id: message_id, metadata: metadata)
+    end
+
+    def refetch_media(message_id:, chat_id:, metadata: {}, provider: nil)
+      provider_for(provider || @configuration.provider).refetch_media(message_id: message_id, chat_id: chat_id, metadata: metadata)
+    end
+
+    def list_chats(metadata: {}, provider: nil)
+      provider_for(provider || @configuration.provider).list_chats(metadata: metadata)
+    end
+
+    def fetch_history(chat_id:, limit: 50, metadata: {}, provider: nil)
+      provider_for(provider || @configuration.provider).fetch_history(chat_id: chat_id, limit: limit, metadata: metadata)
+    end
+
     def logout(metadata: {}, provider: nil)
       provider_for(provider || @configuration.provider).logout(metadata: metadata)
     end

data/lib/whatsapp_notifier/providers/web_automation.rb

@@ -61,6 +61,60 @@ module WhatsAppNotifier
         adapter.fetch_inbound(metadata: metadata)
       end
 
+      # Media helpers are optional adapter capabilities (added in v0.7.0) —
+      # same guard idiom as fetch_inbound so older adapters fail with a clear
+      # ConfigurationError rather than NoMethodError.
+      def fetch_media(message_id:, metadata: {})
+        raise ConfigurationError, "web automation provider is disabled" unless configuration.web_automation_enabled
+
+        adapter = configuration.web_adapter
+        raise ConfigurationError, "web_adapter does not support media fetch (upgrade to a fetch_media-capable adapter)" unless adapter.respond_to?(:fetch_media)
+
+        adapter.fetch_media(message_id: message_id, metadata: metadata)
+      end
+
+      def delete_media(message_id:, metadata: {})
+        raise ConfigurationError, "web automation provider is disabled" unless configuration.web_automation_enabled
+
+        adapter = configuration.web_adapter
+        raise ConfigurationError, "web_adapter does not support media deletion (upgrade to a delete_media-capable adapter)" unless adapter.respond_to?(:delete_media)
+
+        adapter.delete_media(message_id: message_id, metadata: metadata)
+      end
+
+      # On-demand media re-download (added in v0.8.0) — same guard idiom as
+      # fetch_media so older adapters fail with a clear ConfigurationError
+      # rather than NoMethodError.
+      def refetch_media(message_id:, chat_id:, metadata: {})
+        raise ConfigurationError, "web automation provider is disabled" unless configuration.web_automation_enabled
+
+        adapter = configuration.web_adapter
+        raise ConfigurationError, "web_adapter does not support media refetch (upgrade to a refetch_media-capable adapter)" unless adapter.respond_to?(:refetch_media)
+
+        adapter.refetch_media(message_id: message_id, chat_id: chat_id, metadata: metadata)
+      end
+
+      # Chat-history helpers are optional adapter capabilities (added in
+      # v0.8.0) — same guard idiom as fetch_media so older adapters fail with
+      # a clear ConfigurationError rather than NoMethodError.
+      def list_chats(metadata: {})
+        raise ConfigurationError, "web automation provider is disabled" unless configuration.web_automation_enabled
+
+        adapter = configuration.web_adapter
+        raise ConfigurationError, "web_adapter does not support chat listing (upgrade to a list_chats-capable adapter)" unless adapter.respond_to?(:list_chats)
+
+        adapter.list_chats(metadata: metadata)
+      end
+
+      def fetch_history(chat_id:, limit: 50, metadata: {})
+        raise ConfigurationError, "web automation provider is disabled" unless configuration.web_automation_enabled
+
+        adapter = configuration.web_adapter
+        raise ConfigurationError, "web_adapter does not support history replay (upgrade to a fetch_history-capable adapter)" unless adapter.respond_to?(:fetch_history)
+
+        adapter.fetch_history(chat_id: chat_id, limit: limit, metadata: metadata)
+      end
+
       def logout(metadata: {})
         raise ConfigurationError, "web automation provider is disabled" unless configuration.web_automation_enabled