ilink 0.1.3 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd065e745067f368a031d7a216c5f715d231c548c0b4356e75a0ca2b7710ffc4
-  data.tar.gz: '058fe14875bf554fc646b3ac7667fcddf4ed9dc4a880070831b40ae60105c483'
+  metadata.gz: fe6b67ecb39bbb9da2cb397751809a29f751383a03a6d3dc093fbf58e8e5c331
+  data.tar.gz: 951690d2c4a09ed83665e71d017284caf2ab981a73421ceae147ebaa0fc01b55
 SHA512:
-  metadata.gz: 7d4a785e699003b84088b0ddaf7df3ff854895a4a460f7c8b6e8fe00c22372fdbb09372b47a33472bbe58a2403de1fd6b8df2c4d6ef1d99da13367272daaeb3f
-  data.tar.gz: c90d8af0c339262ad2c8e61b2e12ccc229a6e3c512718e710b2fdf559f94eeca01e255940f92278a46774d07833850a49cd66101224d53e6d22f7563c393ee28
+  metadata.gz: 67f1002aaf4aac53ac8011201020658f8a5f6c2c526891cf92f38c1488933bb00d4cbadd7578812f7119eaf0d0935b7882ee461e58f5f12b1859336b50693669
+  data.tar.gz: cd74028d81ac59acf895c5d47370da489966969f9c07e6dd7d53d667e2570fad7bf0d089411d707ff4677757343ef14d238129bcd3b535d331e17fcfa46a2472

data/README.md

@@ -56,12 +56,12 @@ bot = ILink::Bot.new(
 bot = ILink::Bot.new
 
 # Step 1: Get a QR code
-qr = bot.qrcode
+qr = bot.get_qrcode
 puts qr[:qrcode_img_content]  # QR code image URL — show to user
 
 # Step 2: Poll scan status (long-poll, blocks until scanned or timeout)
 loop do
-  status = bot.qrcode_status(qrcode: qr[:qrcode])
+  status = bot.get_qrcode_status(qrcode: qr[:qrcode])
   case status[:status]
   when "confirmed"
     puts "Login success!"
@@ -133,7 +133,7 @@ bot.send_message({
 ### Media Upload
 
 ```ruby
-resp = bot.upload_url(
+resp = bot.get_upload_url(
   media_type:  ILink::UploadMediaType::IMAGE,
   to_user_id:  "user_id",
   rawsize:     File.size("photo.jpg"),

data/lib/ilink/bot.rb

@@ -6,7 +6,7 @@ module ILink
   #   bot = ILink::Bot.new(token: "your_bot_token")
   #   bot.get_updates
   #   bot.send_text(to: "user_id", text: "Hello!")
-  #   bot.upload_url(media_type: 1, to_user_id: "user_id", ...)
+  #   bot.get_upload_url(media_type: 1, to_user_id: "user_id", ...)
   #   bot.send_typing(user_id: "...", ticket: "...")
   #   bot.get_config(user_id: "...")
   #   bot.create_qr_code
@@ -36,14 +36,6 @@ module ILink
       { ret: 0, msgs: [], get_updates_buf: buf }
     end
 
-    # Send a message.
-    #
-    # @param message [Hash] a WeixinMessage hash with keys like :to_user_id, :item_list, etc.
-    # @return [Hash] parsed response
-    def send_message(message)
-      connection.post("/ilink/bot/sendmessage", { msg: message })
-    end
-
     # Convenience: send a text message to a user.
     #
     # @param to [String] target user ID
@@ -63,12 +55,20 @@ module ILink
       send_message(message)
     end
 
+    # Send a message.
+    #
+    # @param message [Hash] a WeixinMessage hash with keys like :to_user_id, :item_list, etc.
+    # @return [Hash] parsed response
+    def send_message(message)
+      connection.post("/ilink/bot/sendmessage", { msg: message })
+    end
+
     # Get a pre-signed CDN upload URL.
     #
     # @param params [Hash] :filekey, :media_type, :to_user_id, :rawsize, :rawfilemd5,
     #   :filesize, :aeskey, :thumb_rawsize, :thumb_rawfilemd5, :thumb_filesize, :no_need_thumb
     # @return [Hash] { upload_param:, thumb_upload_param:, upload_full_url: }
-    def upload_url(**params)
+    def get_upload_url(**params)
       connection.post("/ilink/bot/getuploadurl", params)
     end
 
@@ -78,7 +78,7 @@ module ILink
     # @param ticket  [String] typing ticket (from get_config)
     # @return [Hash]
     def send_typing(user_id:, ticket:)
-      set_typing(user_id: user_id, ticket: ticket, status: TypingStatus::TYPING)
+      toggle_typing(user_id: user_id, ticket: ticket, status: TypingStatus::TYPING)
     end
 
     # Cancel a typing indicator.
@@ -87,10 +87,16 @@ module ILink
     # @param ticket  [String] typing ticket
     # @return [Hash]
     def cancel_typing(user_id:, ticket:)
-      set_typing(user_id: user_id, ticket: ticket, status: TypingStatus::CANCEL)
+      toggle_typing(user_id: user_id, ticket: ticket, status: TypingStatus::CANCEL)
     end
 
-    def set_typing(user_id:, ticket:, status:)
+    # Toggle a typing indicator.
+    #
+    # @param user_id [String] ilink user ID
+    # @param ticket  [String] typing ticket
+    # @param status  [Integer] typing status (TypingStatus::TYPING or TypingStatus::CANCEL)
+    # @return [Hash]
+    def toggle_typing(user_id:, ticket:, status:)
       connection.post("/ilink/bot/sendtyping", {
         ilink_user_id: user_id,
         typing_ticket: ticket,
@@ -112,7 +118,7 @@ module ILink
     #
     # @param bot_type [String] bot type identifier (default "3")
     # @return [Hash] { qrcode:, qrcode_img_content: }
-    def qrcode(bot_type: "3")
+    def get_qrcode(bot_type: "3")
       connection.get("/ilink/bot/get_bot_qrcode?bot_type=#{URI.encode_www_form_component(bot_type)}", timeout: 5)
     end
 
@@ -120,7 +126,7 @@ module ILink
     #
     # @param qrcode [String] qrcode value from #create_qr_code
     # @return [Hash] { status:, bot_token:, ilink_bot_id:, baseurl:, ilink_user_id:, redirect_host: }
-    def qrcode_status(qrcode:)
+    def get_qrcode_status(qrcode:)
       connection.get("/ilink/bot/get_qrcode_status?qrcode=#{URI.encode_www_form_component(qrcode)}",
                       timeout: @configuration.long_poll_timeout)
     rescue Net::ReadTimeout, Net::OpenTimeout

data/lib/ilink/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ILink
-  VERSION = "0.1.3"
+  VERSION = "0.1.5"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ilink
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.5
 platform: ruby
 authors:
 - Songji Zeng
@@ -39,7 +39,6 @@ files:
 - lib/ilink/connection.rb
 - lib/ilink/constants.rb
 - lib/ilink/errors.rb
-- lib/ilink/resources/messages.rb
 - lib/ilink/version.rb
 homepage: https://github.com/songjiz/ilink-ruby
 licenses:

data/lib/ilink/resources/messages.rb

@@ -1,54 +0,0 @@
-# frozen_string_literal: true
-
-module ILink
-  module Resources
-    # RESTful resource for message operations.
-    #
-    #   bot.messages.get_updates - long-poll for new messages (getUpdates)
-    #   bot.messages.send(msg)   - send a message to a user
-    class Messages < Base
-      # Long-poll for new messages.
-      #
-      # @param get_updates_buf [String] opaque cursor from previous poll ("" on first call)
-      # @return [Hash] parsed response with :ret, :msgs, :get_updates_buf, etc.
-      def poll(get_updates_buf: "")
-        post("/ilink/bot/getupdates",
-             { get_updates_buf: get_updates_buf },
-             timeout: connection.config.long_poll_timeout)
-      rescue Net::ReadTimeout, Net::OpenTimeout
-        # Long-poll timeout is normal; return empty response so caller can retry
-        { ret: 0, msgs: [], get_updates_buf: get_updates_buf }
-      end
-
-      # Send a message.
-      #
-      # @param message [Hash] a WeixinMessage hash with keys like :to_user_id, :item_list, etc.
-      # @return [Hash] parsed response
-      def send(message)
-        post("/ilink/bot/sendmessage", { msg: message })
-      end
-
-      # Convenience: send a text message to a user.
-      #
-      # @param to [String] target user ID
-      # @param text [String] message text
-      # @param session_id [String, nil] optional session ID
-      # @return [Hash]
-      def send_text(to:, text:, session_id: nil)
-        message = {
-          to_user_id: to,
-          message_type: MessageType::BOT,
-          message_state: MessageState::FINISH,
-          item_list: [
-            {
-              type: MessageItemType::TEXT,
-              text_item: { text: text }
-            }
-          ]
-        }
-        message[:session_id] = session_id if session_id
-        send(message)
-      end
-    end
-  end
-end