chat_sdk-telegram 0.7.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d2616114e163dc4eb34bb79b9b008cde53832f9483957e2511bbbd3596c34e3
-  data.tar.gz: 3b35d0c60617dc93afa0b706b70e80f21d5672a4a00e0f7d0db374f49c6318c4
+  metadata.gz: f873b2a03fd234639c59a872229bcd2942abc6169b1c970023ceaa16cb239062
+  data.tar.gz: 9e41b3269dc1116e2bc7169b146770337e8f9bbb6020b85f7f36c575828cf678
 SHA512:
-  metadata.gz: d45e83949b108b320fa21661d0bff2549ab7c4db6a386c3bc03c24e503b5299aebb06b0bed88e10254a7fba6b1770ec1bd8ad866171f24996bd202586951e85b
-  data.tar.gz: fb63c59d2e3a750530ff211f392b35b3003b5afa8e7bb7f7c277149bebc6d32ca4cc69f85c473428be9419359b1162a6d7ed7843472343069cbeef503b6255f7
+  metadata.gz: 331146db0c5788c64ce2c7da1a097ff0ae54d2ad946d471be832fdb8123439db92feb7e3db213c023bed0f61cc3121822e6cf26560fc1ec6bd8962ec0082fbe3
+  data.tar.gz: 9843eee8e48fab1a345487035beac68a014bc558e343346dc1cfe6a170f7799b9170f9cff2e10d9bc8fdb738c4cc73fa118731558508baf8970509e54aeea3e2

data/lib/chat_sdk/telegram/format_converter.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module ChatSDK
+  module Telegram
+    class FormatConverter < ChatSDK::Format::Converter
+      SPECIAL_CHARS = %w[_ * [ ] ( ) ~ \\ ` > # + - = | { } . !].freeze
+
+      # Telegram MarkdownV2 → standard Markdown
+      def to_markdown(platform_text)
+        text = platform_text.to_s
+        return "" if text.empty?
+
+        # Convert Telegram user links: [text](tg://user?id=123) → @123
+        text = text.gsub(/\[([^\]]*)\]\(tg:\/\/user\?id=(\d+)\)/, '@\2')
+
+        # Strip underline markers: __text__ → text
+        # Use a loop to handle nested cases
+        text = text.gsub(/(?<!_)__(?!_)(.+?)(?<!_)__(?!_)/m, '\1')
+
+        # Strip spoiler markers: ||text|| → text
+        text = text.gsub(/\|\|(.+?)\|\|/m, '\1')
+
+        # Unescape all backslash-escaped characters
+        text.gsub(/\\(.)/, '\1')
+      end
+
+      # Standard Markdown → Telegram MarkdownV2
+      def from_markdown(markdown)
+        text = markdown.to_s
+        return "" if text.empty?
+
+        parts = split_code_blocks(text)
+        parts.map.with_index { |part, i| i.odd? ? part : escape_special_chars(part) }.join
+      end
+
+      private
+
+      # Escape Telegram MarkdownV2 special chars outside of markdown syntax.
+      # Preserves bold (**), italic (*), strikethrough (~~), links, etc.
+      def escape_special_chars(text)
+        result = +""
+        i = 0
+        chars = text.chars
+
+        while i < chars.length
+          char = chars[i]
+
+          # Bold: **text** — pass through
+          if char == "*" && chars[i + 1] == "*"
+            close = text.index("**", i + 2)
+            if close
+              inner = text[(i + 2)...close]
+              result << "**#{escape_special_chars(inner)}**"
+              i = close + 2
+              next
+            end
+          end
+
+          # Italic: *text* (single asterisk, not preceded/followed by another *)
+          if char == "*" && chars[i + 1] != "*"
+            close = find_single_asterisk_close(chars, i + 1)
+            if close
+              inner = chars[(i + 1)...close].join
+              result << "*#{escape_special_chars(inner)}*"
+              i = close + 1
+              next
+            end
+          end
+
+          # Strikethrough: ~~text~~
+          if char == "~" && chars[i + 1] == "~"
+            close = text.index("~~", i + 2)
+            if close
+              inner = text[(i + 2)...close]
+              result << "~~#{escape_special_chars(inner)}~~"
+              i = close + 2
+              next
+            end
+          end
+
+          # Links: [text](url) — pass through
+          if char == "["
+            link_match = text[i..].match(/\A\[([^\]]*)\]\(([^)]*)\)/)
+            if link_match
+              result << link_match[0]
+              i += link_match[0].length
+              next
+            end
+          end
+
+          # Escape special characters
+          result << if SPECIAL_CHARS.include?(char)
+            "\\#{char}"
+          else
+            char
+          end
+
+          i += 1
+        end
+
+        result
+      end
+
+      # Find closing single * that isn't part of **
+      def find_single_asterisk_close(chars, start)
+        i = start
+        while i < chars.length
+          if chars[i] == "*" && chars[i + 1] != "*" && (i == start || chars[i - 1] != "*")
+            return i
+          end
+          i += 1
+        end
+        nil
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: chat_sdk-telegram
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.1
 platform: ruby
 authors:
 - Quentin Rousseau
@@ -48,6 +48,7 @@ files:
 - lib/chat_sdk/telegram/adapter.rb
 - lib/chat_sdk/telegram/api_client.rb
 - lib/chat_sdk/telegram/event_parser.rb
+- lib/chat_sdk/telegram/format_converter.rb
 - lib/chat_sdk/telegram/keyboard_renderer.rb
 homepage: https://github.com/rootlyhq/chat-sdk
 licenses: