Merge pull request #127 from hiddifyafk/feat/v2-ezytel-grpc

feat(v2): add ezytel gRPC service for Telegram public-channel viewer

Author: hiddify-com

v2/ezytel/ezytel.pb.go

@@ -0,0 +1,80 @@
+syntax = "proto3";
+
+package ezytel;
+option go_package = "github.com/hiddify/hiddify-core/v2/ezytel";
+option java_package = "com.hiddify.core.api.v2.ezytel";
+
+// Request the metadata card of a Telegram public channel
+// (name, description preview, avatar, last-post timestamp, unread badge).
+message ChannelInfoRequest {
+  // Channel id, e.g. "durov" — without "@" or "t.me/".
+  string channel_id = 1;
+  // Last post id the client has already read; used to compute the
+  // unread badge (newmsg). 0 means "everything is unread".
+  int64 last_read = 2;
+}
+
+message ChannelInfo {
+  string name = 1;
+  // Plain-text preview of the most recent post, or "فایل" if it is a media post.
+  string description = 2;
+  // Local cache path of the avatar JPEG, relative to the cache dir
+  // returned by GetCacheDir(). Empty if the avatar could not be fetched.
+  string avatar_path = 3;
+  // Unix epoch seconds of the most recent post.
+  int64 date = 4;
+  // Persian-calendar formatted "MM-DD HH:mm" string for the most recent post.
+  string date_str = 5;
+  // Unread badge, e.g. "+12" or "+99" (capped). Empty when caught up.
+  string newmsg = 6;
+  // Last post id observed on the channel page (server-side cookie replacement).
+  int64 last_post_id = 7;
+  // True when the channel page was reachable and parsed; false if served
+  // from stale cache (newmsg is then forced to "OFF").
+  bool ok = 8;
+}
+
+// Request a slab of HTML for the channel timeline.
+message ChannelMessagesRequest {
+  string channel_id = 1;
+  // 0 = latest page; otherwise the "before" cursor returned by Telegram
+  // (the data-before attribute of messages_more_wrap).
+  int64 before = 2;
+}
+
+message ChannelMessagesResponse {
+  // Pre-rendered HTML fragment ready to be injected into .main_block.
+  // Image URLs have been rewritten to call ProxyImage; dates have been
+  // converted to the Persian calendar.
+  string html = 1;
+  // Channel avatar URL embedded in the header (only set when before == 0).
+  string channel_avatar = 2;
+  // Last post id seen on the page (mirrors the lastread_<chid> cookie).
+  int64 last_post_id = 3;
+}
+
+// Fetch a Telegram-hosted image through the translate.goog domain front
+// and cache it locally. Mirrors proxy.php?url=<hex>.
+message ProxyImageRequest {
+  // Hex-encoded source URL without the "https://" prefix, exactly as the
+  // PHP version expected (bin2hex of the host+path).
+  string hex_url = 1;
+}
+
+message ProxyImageResponse {
+  bytes data = 1;
+  string content_type = 2;
+  // Local cache filename (md5(url) + ".jpg") for clients that prefer to
+  // reload from disk instead of holding the bytes.
+  string cache_name = 3;
+}
+
+// Parse the operator-supplied newline-separated channel list into the
+// normalised ids the other RPCs accept.
+message ParseChannelsRequest {
+  string raw = 1;
+}
+
+message ParseChannelsResponse {
+  repeated string channel_ids = 1;
+}

v2/ezytel/ezytel.proto

@@ -0,0 +1,16 @@
+syntax = "proto3";
+
+package ezytel;
+option go_package = "github.com/hiddify/hiddify-core/v2/ezytel";
+option java_package = "com.hiddify.core.api.v2.ezytel";
+import "v2/ezytel/ezytel.proto";
+
+// Ezytel exposes the Telegram public-channel viewer originally shipped as
+// the ezytel.zip PHP app. Traffic to t.me is routed through Google's
+// translate.goog domain front so it reaches users behind GFW-style filters.
+service Ezytel {
+  rpc GetChannelInfo (ChannelInfoRequest) returns (ChannelInfo);
+  rpc GetChannelMessages (ChannelMessagesRequest) returns (ChannelMessagesResponse);
+  rpc ProxyImage (ProxyImageRequest) returns (ProxyImageResponse);
+  rpc ParseChannels (ParseChannelsRequest) returns (ParseChannelsResponse);
+}