grammerb 0.1.0-x86_64-linux

data/sig/grammerb/conversation.rbs

@@ -0,0 +1,20 @@
+module Grammerb
+  class Conversation
+    class TimeoutError < Errors::Error
+    end
+
+    attr_reader chat_id: String
+
+    def initialize: (Client client, String chat_id, ?timeout: Integer) -> void
+    def send_message: (String text, **untyped opts) -> Types::Message
+    def get_response: (?timeout: Integer?) -> Events::NewMessage
+    def get_edit: (?timeout: Integer?) -> Events::MessageEdited
+    def get_callback: (?timeout: Integer?) -> Events::CallbackQuery
+    def wait_event: (Class event_class, ?timeout: Integer?) -> Events::Event
+    def mark_read: () -> void
+    def cancel: () -> void
+
+    # Internal — called by Client#dispatch_event
+    def _push: (Events::Event event) -> void
+  end
+end

data/sig/grammerb/errors.rbs

@@ -0,0 +1,50 @@
+module Grammerb
+  module Errors
+    class Error < StandardError
+    end
+
+    class ConnectionError < Error
+    end
+
+    class AuthError < Error
+    end
+
+    class NotConnectedError < Error
+    end
+
+    class RPCError < Error
+      attr_reader code: Integer
+      attr_reader message_text: String?
+      attr_reader value: Integer?
+
+      def initialize: (Integer code, ?String? message_text, ?value: Integer?) -> void
+    end
+
+    class FloodWait < RPCError
+      attr_reader seconds: Integer
+
+      def initialize: (Integer seconds) -> void
+    end
+
+    class UserNotFound < RPCError
+      def initialize: () -> void
+    end
+
+    class ChatWriteForbidden < RPCError
+      def initialize: () -> void
+    end
+
+    class PhoneNumberInvalid < RPCError
+      def initialize: () -> void
+    end
+
+    class SessionPasswordNeeded < RPCError
+      def initialize: () -> void
+    end
+
+    RPC_MAP: Hash[String, Class]
+    KIND_MAP: Hash[String, Class]
+
+    def self.from_native: (String msg) -> Error
+  end
+end

data/sig/grammerb/events.rbs

@@ -0,0 +1,238 @@
+module Grammerb
+  module Events
+    class Event
+      attr_reader raw: Hash[Symbol, untyped]
+      attr_accessor client: Client?
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+    end
+
+    module MessageEvent
+      attr_reader message_id: Integer?
+      attr_reader text: String?
+      attr_reader chat_id: Integer?
+      attr_reader chat_name: String?
+      attr_reader sender_id: Integer?
+      attr_reader sender_name: String?
+      attr_reader date: Time?
+      attr_reader sender_is_bot: bool?
+      attr_reader chat_type: String?
+      attr_reader grouped_id: Integer?
+      attr_reader reply_to_message_id: Integer?
+      attr_reader media_type: String?
+      attr_reader media_id: Integer?
+      attr_reader media_file_name: String?
+      attr_reader media_mime_type: String?
+      attr_reader media_size: Integer?
+      attr_reader buttons: Array[Array[Types::Button]]?
+
+      def album?: () -> bool
+      def has_media?: () -> bool
+      def photo?: () -> bool
+      def document?: () -> bool
+      def sticker?: () -> bool
+      def has_buttons?: () -> bool
+      def edit: (String text, ?parse_mode: String?, ?buttons: button_rows?, ?reply_markup: reply_markup?) -> void
+      def delete: () -> void
+      def bot?: () -> bool
+      def private?: () -> bool
+      def group?: () -> bool
+      def channel?: () -> bool
+    end
+
+    class NewMessage < Event
+      include MessageEvent
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+      def reply: (String text, **untyped opts) -> Types::Message?
+      def respond: (String text, **untyped opts) -> Types::Message?
+      def forward: (peer to_chat) -> void
+    end
+
+    class MessageEdited < Event
+      include MessageEvent
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+    end
+
+    class MessageDeleted < Event
+      attr_reader deleted_ids: Array[Integer]
+      attr_reader chat_id: Integer?
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+    end
+
+    class CallbackQuery < Event
+      attr_reader query_id: Integer?
+      attr_reader data: Array[Integer]?
+      attr_reader chat_id: Integer?
+      attr_reader sender_id: Integer?
+      attr_reader message_id: Integer?
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+      def data_str: () -> String?
+      def answer: (?text: String?, ?alert: bool, ?cache_time: Integer?) -> void
+      def edit: (String text, ?parse_mode: String?, ?buttons: button_rows?, ?reply_markup: reply_markup?) -> void
+      def delete: () -> void
+      def reply: (String text, **untyped opts) -> Types::Message?
+      def respond: (String text, **untyped opts) -> Types::Message?
+    end
+
+    class InlineQuery < Event
+      attr_reader query_id: Integer?
+      attr_reader query: String?
+      attr_reader offset: String?
+      attr_reader sender_id: Integer?
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+      def answer: (Array[Hash[Symbol, untyped]] results, ?cache_time: Integer?, ?is_personal: bool, ?next_offset: String?) -> void
+    end
+
+    class UpdateError < Event
+      attr_reader message: String?
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+    end
+
+    class InlineSend < Event
+      attr_reader sender_id: Integer?
+      attr_reader query: String?
+      attr_reader result_id: String?
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+    end
+
+    class PreCheckoutQuery < Event
+      attr_reader query_id: Integer?
+      attr_reader sender_id: Integer?
+      attr_reader currency: String?
+      attr_reader total_amount: Integer?
+      attr_reader invoice_payload: String?
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+      def approve: () -> void
+      def reject: (?String error_message) -> void
+    end
+
+    class SuccessfulPayment < Event
+      attr_reader sender_id: Integer?
+      attr_reader currency: String?
+      attr_reader total_amount: Integer?
+      attr_reader invoice_payload: String?
+      attr_reader charge_id: String?
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+    end
+
+    class Album < Event
+      attr_reader messages: Array[NewMessage]
+      attr_reader grouped_id: Integer?
+      attr_reader chat_id: Integer?
+      attr_reader chat_name: String?
+
+      def initialize: (Array[NewMessage] messages) -> void
+      def texts: () -> Array[String?]
+      def reply: (String text, **untyped opts) -> Types::Message?
+      def respond: (String text, **untyped opts) -> Types::Message?
+    end
+
+    class ChatAction < Event
+      attr_reader action_type: String?
+      attr_reader message_id: Integer?
+      attr_reader chat_id: Integer?
+      attr_reader chat_name: String?
+      attr_reader chat_type: String?
+      attr_reader sender_id: Integer?
+      attr_reader actor_id: Integer?
+      attr_reader user_ids: Array[Integer]
+      attr_reader new_title: String?
+      attr_reader pinned_message_id: Integer?
+      attr_reader game_score: Integer?
+      attr_reader date: Time?
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+      def user_joined?: () -> bool
+      def user_added?: () -> bool
+      def user_kicked?: () -> bool
+      def user_left?: () -> bool
+      def title_changed?: () -> bool
+      def photo_changed?: () -> bool
+      def photo_deleted?: () -> bool
+      def pin_message?: () -> bool
+      def unpin?: () -> bool
+      def chat_created?: () -> bool
+      def channel_created?: () -> bool
+      def user_promoted?: () -> bool
+      def user_demoted?: () -> bool
+      def new_score?: () -> bool
+      def user_id: () -> Integer?
+      def added_by: () -> Integer?
+      def kicked_by: () -> Integer?
+      def reply: (String text, **untyped opts) -> Types::Message?
+      def respond: (String text, **untyped opts) -> Types::Message?
+      def delete: () -> void
+    end
+
+    class UserUpdate < Event
+      attr_reader sender_id: Integer?
+      attr_reader chat_id: Integer?
+      attr_reader user_status: String?
+      attr_reader last_seen: Time?
+      attr_reader online_until: Time?
+      attr_reader typing_action: String?
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+      def online?: () -> bool
+      def offline?: () -> bool
+      def recently?: () -> bool
+      def within_weeks?: () -> bool
+      def within_months?: () -> bool
+      def typing?: () -> bool
+      def recording?: () -> bool
+      def uploading?: () -> bool
+      def playing?: () -> bool
+      def cancel?: () -> bool
+      def audio?: () -> bool
+      def video?: () -> bool
+      def round?: () -> bool
+      def document?: () -> bool
+      def photo?: () -> bool
+      def sticker?: () -> bool
+      def contact?: () -> bool
+      def geo?: () -> bool
+      alias user_id sender_id
+    end
+
+    class MessageRead < Event
+      attr_reader chat_id: Integer?
+      attr_reader max_id: Integer?
+      attr_reader outbox: bool
+      attr_reader unread_count: Integer?
+      attr_reader message_ids: Array[Integer]
+
+      def initialize: (Hash[Symbol, untyped] raw) -> void
+      def inbox?: () -> bool
+      def outbox?: () -> bool
+      def contents?: () -> bool
+      def is_read?: (Integer message_id) -> bool
+      def get_messages: () -> Array[untyped]
+    end
+
+    class RawUpdate < Event
+    end
+
+    class Handler
+      attr_reader event_class: Class
+      attr_reader pattern: (Regexp | String)?
+      attr_reader chats: Set[untyped]?
+      attr_reader block: Proc
+
+      def initialize: (Class event_class, ?pattern: (Regexp | String)?, ?chats: Set[untyped]?) { (Event) -> void } -> void
+      def matches?: (Event event) -> bool
+    end
+
+    TYPE_MAP: Hash[String, Class]
+
+    def self.from_raw: (Hash[Symbol, untyped] raw_hash) -> Event?
+  end
+end

data/sig/grammerb/types.rbs

@@ -0,0 +1,246 @@
+module Grammerb
+  module Types
+    class Button
+      attr_reader text: String
+      attr_reader callback_data: Array[Integer]?
+      attr_reader url: String?
+      attr_reader switch_inline: String?
+      attr_reader web_app_url: String?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def callback?: () -> bool
+      def url?: () -> bool
+      def web_app?: () -> bool
+      def data_str: () -> String?
+      def ==: (untyped other) -> bool
+      alias eql? ==
+      def hash: () -> Integer
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class Message
+      attr_reader id: Integer
+      attr_reader text: String
+      attr_reader chat_id: Integer?
+      attr_reader chat_name: String?
+      attr_reader sender_id: Integer?
+      attr_reader sender_name: String?
+      attr_reader date: Time?
+      attr_reader chat_type: String?
+      attr_reader grouped_id: Integer?
+      attr_reader reply_to_message_id: Integer?
+      attr_reader buttons: Array[Array[Button]]?
+      attr_reader media_type: String?
+      attr_reader media_id: Integer?
+      attr_reader media_file_name: String?
+      attr_reader media_mime_type: String?
+      attr_reader media_size: Integer?
+      attr_reader media_duration: Float?
+      attr_reader media_width: Integer?
+      attr_reader media_height: Integer?
+      attr_reader media_sticker_emoji: String?
+      attr_accessor client: Client?
+      attr_accessor raw: Hash[Symbol, untyped]
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def has_buttons?: () -> bool
+      def has_media?: () -> bool
+      def photo?: () -> bool
+      def document?: () -> bool
+      def sticker?: () -> bool
+      def poll?: () -> bool
+      def album?: () -> bool
+      def peer_id: () -> String
+      def reply: (String text, **untyped opts) -> Types::Message
+      def edit: (String new_text, ?parse_mode: String?, ?buttons: button_rows?, ?reply_markup: reply_markup?) -> void
+      def delete: () -> void
+      def forward: (peer to_chat) -> void
+      def pin: () -> void
+      def download: (String path) ?{ (Integer downloaded, Integer? total) -> void } -> void
+      def ==: (untyped other) -> bool
+      alias eql? ==
+      def hash: () -> Integer
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class User
+      attr_reader id: Integer
+      attr_reader first_name: String?
+      attr_reader last_name: String?
+      attr_reader username: String?
+      attr_reader phone: String?
+      attr_reader bot: bool?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def bot?: () -> bool
+      def full_name: () -> String
+      def peer_id: () -> String
+      def ==: (untyped other) -> bool
+      alias eql? ==
+      def hash: () -> Integer
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class Dialog
+      attr_reader name: String?
+      attr_reader id: Integer
+      attr_reader peer_type: String?
+      attr_reader unread_count: Integer?
+      attr_reader last_message_text: String?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def peer_id: () -> String
+      def ==: (untyped other) -> bool
+      alias eql? ==
+      def hash: () -> Integer
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class Participant
+      attr_reader id: Integer
+      attr_reader first_name: String?
+      attr_reader last_name: String?
+      attr_reader username: String?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def full_name: () -> String
+      def peer_id: () -> String
+      def ==: (untyped other) -> bool
+      alias eql? ==
+      def hash: () -> Integer
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class Peer
+      attr_reader id: Integer
+      attr_reader name: String?
+      attr_reader peer_type: String?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def peer_id: () -> String
+      def ==: (untyped other) -> bool
+      alias eql? ==
+      def hash: () -> Integer
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class Permissions
+      attr_reader is_admin: bool?
+      attr_reader is_creator: bool?
+      attr_reader is_banned: bool?
+      attr_reader has_default_permissions: bool?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def admin?: () -> bool
+      def creator?: () -> bool
+      def banned?: () -> bool
+      def ==: (untyped other) -> bool
+      alias eql? ==
+      def hash: () -> Integer
+      def to_h: () -> Hash[Symbol, untyped]
+    end
+
+    class PollResults
+      attr_reader total_voters: Integer?
+      attr_reader results: Array[PollOption]
+      attr_reader solution: String?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class PollOption
+      attr_reader option: String?
+      attr_reader voters: Integer?
+      attr_reader chosen: bool?
+      attr_reader correct: bool?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def chosen?: () -> bool
+      def correct?: () -> bool
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class PollVotes
+      attr_reader count: Integer?
+      attr_reader votes: Array[PollVote]
+      attr_reader next_offset: String?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class PollVote
+      attr_reader peer_id: Integer?
+      attr_reader options: Array[Integer]?
+      attr_reader date: Time?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class Draft
+      attr_reader peer_id: Integer?
+      attr_reader text: String?
+      attr_reader date: Time?
+      attr_reader reply_to_msg_id: Integer?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class AdminLogEvent
+      attr_reader id: Integer
+      attr_reader date: Time?
+      attr_reader user_id: Integer?
+      attr_reader action: String?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class InlineResult
+      attr_reader id: String?
+      attr_reader title: String?
+      attr_reader description: String?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+
+    class ChatFull
+      attr_reader id: Integer?
+      attr_reader about: String?
+      attr_reader participants_count: Integer?
+      attr_reader admins_count: Integer?
+      attr_reader kicked_count: Integer?
+      attr_reader banned_count: Integer?
+      attr_reader online_count: Integer?
+      attr_reader pinned_msg_id: Integer?
+      attr_reader linked_chat_id: Integer?
+      attr_reader slowmode_seconds: Integer?
+      attr_reader can_view_participants: bool?
+      attr_reader can_set_username: bool?
+
+      def initialize: (Hash[Symbol, untyped] hash) -> void
+      def ==: (untyped other) -> bool
+      alias eql? ==
+      def hash: () -> Integer
+      def to_h: () -> Hash[Symbol, untyped]
+      def to_s: () -> String
+    end
+  end
+end

data/sig/grammerb.rbs

@@ -0,0 +1,13 @@
+module Grammerb
+  VERSION: String
+
+  # Flexible peer identifier: username, numeric ID, or any Type with an id/chat_id
+  type peer = String | Integer | Types::Message | Types::Peer | Types::User | Types::Dialog | Types::Participant
+
+  # Inline button row: array of button hashes
+  type button_hash = { text: String, callback_data: String?, url: String?, switch_inline: String?, web_app: { url: String }? }
+  type button_rows = Array[Array[button_hash]]
+
+  # Reply markup hash for reply keyboards
+  type reply_markup = button_rows | { type: Symbol, keys: Array[Array[String | { text: String, request_phone: bool?, request_geo: bool?, request_poll: bool? }]]?, resize: bool?, single_use: bool?, placeholder: String? }
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: grammerb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: x86_64-linux
+authors:
+- Developer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-03-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+description: A full-featured Telegram MTProto client library wrapping grammers via
+  Rust native extensions
+email:
+- dev@grammerb.local
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/grammerb.rb
+- lib/grammerb/client.rb
+- lib/grammerb/conversation.rb
+- lib/grammerb/errors.rb
+- lib/grammerb/events.rb
+- lib/grammerb/grammerb.so
+- lib/grammerb/types.rb
+- lib/grammerb/version.rb
+- sig/grammerb.rbs
+- sig/grammerb/client.rbs
+- sig/grammerb/conversation.rbs
+- sig/grammerb/errors.rbs
+- sig/grammerb/events.rbs
+- sig/grammerb/types.rbs
+homepage: 
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 4.1.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.23
+signing_key: 
+specification_version: 4
+summary: Telegram MTProto client library for Ruby
+test_files: []