@core-ease/telegram-kit 3.0.1

package/dist/keyboards/index.js

@@ -0,0 +1,127 @@
+'use strict';
+
+// src/utils/keyboards.ts
+var InlineKeyboardBuilder = class _InlineKeyboardBuilder {
+  constructor() {
+    this.rows = [[]];
+  }
+  currentRow() {
+    return this.rows[this.rows.length - 1];
+  }
+  add(button) {
+    this.currentRow().push(button);
+    return this;
+  }
+  text(text, callbackData) {
+    return this.add({ text, callback_data: callbackData });
+  }
+  url(text, url) {
+    return this.add({ text, url });
+  }
+  webApp(text, url) {
+    return this.add({ text, web_app: { url } });
+  }
+  login(text, loginUrl) {
+    return this.add({ text, login_url: typeof loginUrl === "string" ? { url: loginUrl } : loginUrl });
+  }
+  switchInline(text, query = "") {
+    return this.add({ text, switch_inline_query: query });
+  }
+  switchInlineCurrentChat(text, query = "") {
+    return this.add({ text, switch_inline_query_current_chat: query });
+  }
+  switchInlineChosenChat(text, query) {
+    return this.add({ text, switch_inline_query_chosen_chat: query != null ? query : {} });
+  }
+  copyText(text, copyText) {
+    return this.add({ text, copy_text: typeof copyText === "string" ? { text: copyText } : copyText });
+  }
+  pay(text = "Pay") {
+    return this.add({ text, pay: true });
+  }
+  callbackGame(text) {
+    return this.add({ text, callback_game: {} });
+  }
+  button(button) {
+    return this.add(button);
+  }
+  row() {
+    if (this.currentRow().length > 0) this.rows.push([]);
+    return this;
+  }
+  static columns(buttons, perRow) {
+    const builder = new _InlineKeyboardBuilder();
+    buttons.forEach((button, i) => {
+      if (i > 0 && i % perRow === 0) builder.row();
+      builder.button(button);
+    });
+    return builder;
+  }
+  build() {
+    const rows = this.rows.filter((row) => row.length > 0);
+    return { inline_keyboard: rows };
+  }
+};
+var ReplyKeyboardBuilder = class {
+  constructor() {
+    this.rows = [[]];
+  }
+  currentRow() {
+    return this.rows[this.rows.length - 1];
+  }
+  add(button) {
+    this.currentRow().push(button);
+    return this;
+  }
+  text(label) {
+    return this.add({ text: label });
+  }
+  requestContact(label) {
+    return this.add({ text: label, request_contact: true });
+  }
+  requestLocation(label) {
+    return this.add({ text: label, request_location: true });
+  }
+  requestPoll(label, type) {
+    return this.add({ text: label, request_poll: { type } });
+  }
+  webApp(label, url) {
+    return this.add({ text: label, web_app: { url } });
+  }
+  requestUsers(label, params) {
+    return this.add({ text: label, request_users: params });
+  }
+  requestChat(label, params) {
+    return this.add({ text: label, request_chat: params });
+  }
+  button(button) {
+    return this.add(button);
+  }
+  row() {
+    if (this.currentRow().length > 0) this.rows.push([]);
+    return this;
+  }
+  build(options = {}) {
+    var _a;
+    const rows = this.rows.filter((row) => row.length > 0);
+    return {
+      keyboard: rows,
+      resize_keyboard: (_a = options.resize) != null ? _a : true,
+      one_time_keyboard: options.oneTime,
+      selective: options.selective,
+      input_field_placeholder: options.placeholder,
+      is_persistent: options.persistent
+    };
+  }
+};
+function removeKeyboard(selective) {
+  return { remove_keyboard: true, selective };
+}
+function forceReply(options) {
+  return { force_reply: true, input_field_placeholder: options == null ? void 0 : options.placeholder, selective: options == null ? void 0 : options.selective };
+}
+
+exports.InlineKeyboardBuilder = InlineKeyboardBuilder;
+exports.ReplyKeyboardBuilder = ReplyKeyboardBuilder;
+exports.forceReply = forceReply;
+exports.removeKeyboard = removeKeyboard;

package/dist/keyboards/index.mjs

@@ -0,0 +1,124 @@
+import '../chunk-7AARTHNW.mjs';
+
+// src/utils/keyboards.ts
+var InlineKeyboardBuilder = class _InlineKeyboardBuilder {
+  constructor() {
+    this.rows = [[]];
+  }
+  currentRow() {
+    return this.rows[this.rows.length - 1];
+  }
+  add(button) {
+    this.currentRow().push(button);
+    return this;
+  }
+  text(text, callbackData) {
+    return this.add({ text, callback_data: callbackData });
+  }
+  url(text, url) {
+    return this.add({ text, url });
+  }
+  webApp(text, url) {
+    return this.add({ text, web_app: { url } });
+  }
+  login(text, loginUrl) {
+    return this.add({ text, login_url: typeof loginUrl === "string" ? { url: loginUrl } : loginUrl });
+  }
+  switchInline(text, query = "") {
+    return this.add({ text, switch_inline_query: query });
+  }
+  switchInlineCurrentChat(text, query = "") {
+    return this.add({ text, switch_inline_query_current_chat: query });
+  }
+  switchInlineChosenChat(text, query) {
+    return this.add({ text, switch_inline_query_chosen_chat: query != null ? query : {} });
+  }
+  copyText(text, copyText) {
+    return this.add({ text, copy_text: typeof copyText === "string" ? { text: copyText } : copyText });
+  }
+  pay(text = "Pay") {
+    return this.add({ text, pay: true });
+  }
+  callbackGame(text) {
+    return this.add({ text, callback_game: {} });
+  }
+  button(button) {
+    return this.add(button);
+  }
+  row() {
+    if (this.currentRow().length > 0) this.rows.push([]);
+    return this;
+  }
+  static columns(buttons, perRow) {
+    const builder = new _InlineKeyboardBuilder();
+    buttons.forEach((button, i) => {
+      if (i > 0 && i % perRow === 0) builder.row();
+      builder.button(button);
+    });
+    return builder;
+  }
+  build() {
+    const rows = this.rows.filter((row) => row.length > 0);
+    return { inline_keyboard: rows };
+  }
+};
+var ReplyKeyboardBuilder = class {
+  constructor() {
+    this.rows = [[]];
+  }
+  currentRow() {
+    return this.rows[this.rows.length - 1];
+  }
+  add(button) {
+    this.currentRow().push(button);
+    return this;
+  }
+  text(label) {
+    return this.add({ text: label });
+  }
+  requestContact(label) {
+    return this.add({ text: label, request_contact: true });
+  }
+  requestLocation(label) {
+    return this.add({ text: label, request_location: true });
+  }
+  requestPoll(label, type) {
+    return this.add({ text: label, request_poll: { type } });
+  }
+  webApp(label, url) {
+    return this.add({ text: label, web_app: { url } });
+  }
+  requestUsers(label, params) {
+    return this.add({ text: label, request_users: params });
+  }
+  requestChat(label, params) {
+    return this.add({ text: label, request_chat: params });
+  }
+  button(button) {
+    return this.add(button);
+  }
+  row() {
+    if (this.currentRow().length > 0) this.rows.push([]);
+    return this;
+  }
+  build(options = {}) {
+    var _a;
+    const rows = this.rows.filter((row) => row.length > 0);
+    return {
+      keyboard: rows,
+      resize_keyboard: (_a = options.resize) != null ? _a : true,
+      one_time_keyboard: options.oneTime,
+      selective: options.selective,
+      input_field_placeholder: options.placeholder,
+      is_persistent: options.persistent
+    };
+  }
+};
+function removeKeyboard(selective) {
+  return { remove_keyboard: true, selective };
+}
+function forceReply(options) {
+  return { force_reply: true, input_field_placeholder: options == null ? void 0 : options.placeholder, selective: options == null ? void 0 : options.selective };
+}
+
+export { InlineKeyboardBuilder, ReplyKeyboardBuilder, forceReply, removeKeyboard };

package/dist/links/index.d.mts

@@ -0,0 +1,53 @@
+declare function isValidStartParam(param: string): boolean;
+declare function encodeStartParam(value: string): string;
+declare function decodeStartParam(param: string): string;
+interface StartParamInput {
+    startParam?: string;
+    data?: string;
+}
+interface BuildStartLinkOptions extends StartParamInput {
+    botUsername: string;
+}
+declare function buildStartLink(options: BuildStartLinkOptions): string;
+interface BuildStartAppLinkOptions extends StartParamInput {
+    botUsername: string;
+    appName?: string;
+    mode?: 'compact' | 'fullscreen';
+}
+declare function buildStartAppLink(options: BuildStartAppLinkOptions): string;
+interface BuildShareLinkOptions {
+    url: string;
+    text?: string;
+}
+declare function buildShareLink(options: BuildShareLinkOptions): string;
+type ParsedTelegramLink = {
+    type: 'profile';
+    username: string;
+} | {
+    type: 'bot-start';
+    username: string;
+    startParam: string;
+} | {
+    type: 'mini-app';
+    username: string;
+    appName?: string;
+    startParam?: string;
+    mode?: string;
+} | {
+    type: 'join-chat';
+    inviteHash: string;
+} | {
+    type: 'private-channel-post';
+    internalChatId: string;
+    messageId: number;
+} | {
+    type: 'share';
+    url?: string;
+    text?: string;
+} | {
+    type: 'unknown';
+    url: string;
+};
+declare function parseTelegramLink(link: string): ParsedTelegramLink;
+
+export { type BuildShareLinkOptions, type BuildStartAppLinkOptions, type BuildStartLinkOptions, type ParsedTelegramLink, buildShareLink, buildStartAppLink, buildStartLink, decodeStartParam, encodeStartParam, isValidStartParam, parseTelegramLink };

package/dist/links/index.d.ts

@@ -0,0 +1,53 @@
+declare function isValidStartParam(param: string): boolean;
+declare function encodeStartParam(value: string): string;
+declare function decodeStartParam(param: string): string;
+interface StartParamInput {
+    startParam?: string;
+    data?: string;
+}
+interface BuildStartLinkOptions extends StartParamInput {
+    botUsername: string;
+}
+declare function buildStartLink(options: BuildStartLinkOptions): string;
+interface BuildStartAppLinkOptions extends StartParamInput {
+    botUsername: string;
+    appName?: string;
+    mode?: 'compact' | 'fullscreen';
+}
+declare function buildStartAppLink(options: BuildStartAppLinkOptions): string;
+interface BuildShareLinkOptions {
+    url: string;
+    text?: string;
+}
+declare function buildShareLink(options: BuildShareLinkOptions): string;
+type ParsedTelegramLink = {
+    type: 'profile';
+    username: string;
+} | {
+    type: 'bot-start';
+    username: string;
+    startParam: string;
+} | {
+    type: 'mini-app';
+    username: string;
+    appName?: string;
+    startParam?: string;
+    mode?: string;
+} | {
+    type: 'join-chat';
+    inviteHash: string;
+} | {
+    type: 'private-channel-post';
+    internalChatId: string;
+    messageId: number;
+} | {
+    type: 'share';
+    url?: string;
+    text?: string;
+} | {
+    type: 'unknown';
+    url: string;
+};
+declare function parseTelegramLink(link: string): ParsedTelegramLink;
+
+export { type BuildShareLinkOptions, type BuildStartAppLinkOptions, type BuildStartLinkOptions, type ParsedTelegramLink, buildShareLink, buildStartAppLink, buildStartLink, decodeStartParam, encodeStartParam, isValidStartParam, parseTelegramLink };

package/dist/links/index.js

@@ -0,0 +1,139 @@
+'use strict';
+
+// src/utils/links.ts
+function bytesToBase64Url(bytes) {
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);
+  return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function base64UrlToBytes(base64url) {
+  const base64 = base64url.replace(/-/g, "+").replace(/_/g, "/");
+  const padded = base64 + "=".repeat((4 - base64.length % 4) % 4);
+  const binary = atob(padded);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+  return bytes;
+}
+var START_PARAM_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+function isValidStartParam(param) {
+  return START_PARAM_PATTERN.test(param);
+}
+function encodeStartParam(value) {
+  const encoded = bytesToBase64Url(new TextEncoder().encode(value));
+  if (encoded.length > 64) {
+    throw new Error(
+      `[@core-ease/telegram-kit] encodeStartParam: the encoded value is ${encoded.length} characters, exceeding Telegram's 64-character limit for start parameters. Pass a shorter payload (e.g. a numeric/short ID you look up server-side, instead of embedding full data).`
+    );
+  }
+  return encoded;
+}
+function decodeStartParam(param) {
+  return new TextDecoder().decode(base64UrlToBytes(param));
+}
+function resolveStartParam(options) {
+  if (options.startParam !== void 0 && options.data !== void 0) {
+    throw new Error("[@core-ease/telegram-kit] Provide either `startParam` or `data`, not both.");
+  }
+  if (options.data !== void 0) return encodeStartParam(options.data);
+  if (options.startParam !== void 0) {
+    if (!isValidStartParam(options.startParam)) {
+      throw new Error(
+        `[@core-ease/telegram-kit] "${options.startParam}" is not a valid Telegram start parameter (allowed characters: A-Z a-z 0-9 _ -, max 64 chars). Use \`data\` instead to auto-encode arbitrary text.`
+      );
+    }
+    return options.startParam;
+  }
+  return void 0;
+}
+function buildStartLink(options) {
+  const param = resolveStartParam(options);
+  const base = `https://t.me/${options.botUsername}`;
+  return param ? `${base}?start=${param}` : base;
+}
+function buildStartAppLink(options) {
+  const param = resolveStartParam(options);
+  const base = options.appName ? `https://t.me/${options.botUsername}/${options.appName}` : `https://t.me/${options.botUsername}`;
+  const query = new URLSearchParams();
+  if (param) query.set("startapp", param);
+  if (options.mode) query.set("mode", options.mode);
+  const queryString = query.toString();
+  return queryString ? `${base}?${queryString}` : base;
+}
+function buildShareLink(options) {
+  const query = new URLSearchParams({ url: options.url });
+  if (options.text) query.set("text", options.text);
+  return `https://t.me/share/url?${query.toString()}`;
+}
+var TME_HOSTNAMES = /* @__PURE__ */ new Set(["t.me", "telegram.me", "telegram.dog"]);
+function parseTelegramLink(link) {
+  var _a, _b, _c, _d;
+  let url;
+  try {
+    url = new URL(link);
+  } catch (e) {
+    return { type: "unknown", url: link };
+  }
+  if (url.protocol === "tg:") {
+    const action = url.hostname || url.pathname.replace(/^\/+/, "");
+    if (action === "resolve") {
+      const domain = url.searchParams.get("domain");
+      const start2 = url.searchParams.get("start");
+      const startapp2 = url.searchParams.get("startapp");
+      const mode2 = (_a = url.searchParams.get("mode")) != null ? _a : void 0;
+      if (domain && start2) return { type: "bot-start", username: domain, startParam: start2 };
+      if (domain && startapp2 !== null) {
+        return { type: "mini-app", username: domain, startParam: startapp2 || void 0, mode: mode2 };
+      }
+      if (domain) return { type: "profile", username: domain };
+    }
+    if (action === "join") {
+      const invite = url.searchParams.get("invite");
+      if (invite) return { type: "join-chat", inviteHash: invite };
+    }
+    return { type: "unknown", url: link };
+  }
+  if (!TME_HOSTNAMES.has(url.hostname)) {
+    return { type: "unknown", url: link };
+  }
+  const segments = url.pathname.split("/").filter(Boolean);
+  if (segments.length === 0) return { type: "unknown", url: link };
+  if (segments[0].startsWith("+")) {
+    return { type: "join-chat", inviteHash: segments[0].slice(1) };
+  }
+  if (segments[0] === "joinchat" && segments[1]) {
+    return { type: "join-chat", inviteHash: segments[1] };
+  }
+  if (segments[0] === "share" && segments[1] === "url") {
+    return {
+      type: "share",
+      url: (_b = url.searchParams.get("url")) != null ? _b : void 0,
+      text: (_c = url.searchParams.get("text")) != null ? _c : void 0
+    };
+  }
+  if (segments[0] === "c" && segments[1] && segments[2]) {
+    const messageId = Number(segments[2]);
+    return { type: "private-channel-post", internalChatId: segments[1], messageId };
+  }
+  const username = segments[0];
+  const startapp = url.searchParams.get("startapp");
+  const start = url.searchParams.get("start");
+  const mode = (_d = url.searchParams.get("mode")) != null ? _d : void 0;
+  if (segments.length >= 2) {
+    return { type: "mini-app", username, appName: segments[1], startParam: startapp != null ? startapp : void 0, mode };
+  }
+  if (startapp !== null) {
+    return { type: "mini-app", username, startParam: startapp || void 0, mode };
+  }
+  if (start !== null) {
+    return { type: "bot-start", username, startParam: start };
+  }
+  return { type: "profile", username };
+}
+
+exports.buildShareLink = buildShareLink;
+exports.buildStartAppLink = buildStartAppLink;
+exports.buildStartLink = buildStartLink;
+exports.decodeStartParam = decodeStartParam;
+exports.encodeStartParam = encodeStartParam;
+exports.isValidStartParam = isValidStartParam;
+exports.parseTelegramLink = parseTelegramLink;

package/dist/links/index.mjs

@@ -0,0 +1,133 @@
+import '../chunk-7AARTHNW.mjs';
+
+// src/utils/links.ts
+function bytesToBase64Url(bytes) {
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);
+  return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function base64UrlToBytes(base64url) {
+  const base64 = base64url.replace(/-/g, "+").replace(/_/g, "/");
+  const padded = base64 + "=".repeat((4 - base64.length % 4) % 4);
+  const binary = atob(padded);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+  return bytes;
+}
+var START_PARAM_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+function isValidStartParam(param) {
+  return START_PARAM_PATTERN.test(param);
+}
+function encodeStartParam(value) {
+  const encoded = bytesToBase64Url(new TextEncoder().encode(value));
+  if (encoded.length > 64) {
+    throw new Error(
+      `[@core-ease/telegram-kit] encodeStartParam: the encoded value is ${encoded.length} characters, exceeding Telegram's 64-character limit for start parameters. Pass a shorter payload (e.g. a numeric/short ID you look up server-side, instead of embedding full data).`
+    );
+  }
+  return encoded;
+}
+function decodeStartParam(param) {
+  return new TextDecoder().decode(base64UrlToBytes(param));
+}
+function resolveStartParam(options) {
+  if (options.startParam !== void 0 && options.data !== void 0) {
+    throw new Error("[@core-ease/telegram-kit] Provide either `startParam` or `data`, not both.");
+  }
+  if (options.data !== void 0) return encodeStartParam(options.data);
+  if (options.startParam !== void 0) {
+    if (!isValidStartParam(options.startParam)) {
+      throw new Error(
+        `[@core-ease/telegram-kit] "${options.startParam}" is not a valid Telegram start parameter (allowed characters: A-Z a-z 0-9 _ -, max 64 chars). Use \`data\` instead to auto-encode arbitrary text.`
+      );
+    }
+    return options.startParam;
+  }
+  return void 0;
+}
+function buildStartLink(options) {
+  const param = resolveStartParam(options);
+  const base = `https://t.me/${options.botUsername}`;
+  return param ? `${base}?start=${param}` : base;
+}
+function buildStartAppLink(options) {
+  const param = resolveStartParam(options);
+  const base = options.appName ? `https://t.me/${options.botUsername}/${options.appName}` : `https://t.me/${options.botUsername}`;
+  const query = new URLSearchParams();
+  if (param) query.set("startapp", param);
+  if (options.mode) query.set("mode", options.mode);
+  const queryString = query.toString();
+  return queryString ? `${base}?${queryString}` : base;
+}
+function buildShareLink(options) {
+  const query = new URLSearchParams({ url: options.url });
+  if (options.text) query.set("text", options.text);
+  return `https://t.me/share/url?${query.toString()}`;
+}
+var TME_HOSTNAMES = /* @__PURE__ */ new Set(["t.me", "telegram.me", "telegram.dog"]);
+function parseTelegramLink(link) {
+  var _a, _b, _c, _d;
+  let url;
+  try {
+    url = new URL(link);
+  } catch (e) {
+    return { type: "unknown", url: link };
+  }
+  if (url.protocol === "tg:") {
+    const action = url.hostname || url.pathname.replace(/^\/+/, "");
+    if (action === "resolve") {
+      const domain = url.searchParams.get("domain");
+      const start2 = url.searchParams.get("start");
+      const startapp2 = url.searchParams.get("startapp");
+      const mode2 = (_a = url.searchParams.get("mode")) != null ? _a : void 0;
+      if (domain && start2) return { type: "bot-start", username: domain, startParam: start2 };
+      if (domain && startapp2 !== null) {
+        return { type: "mini-app", username: domain, startParam: startapp2 || void 0, mode: mode2 };
+      }
+      if (domain) return { type: "profile", username: domain };
+    }
+    if (action === "join") {
+      const invite = url.searchParams.get("invite");
+      if (invite) return { type: "join-chat", inviteHash: invite };
+    }
+    return { type: "unknown", url: link };
+  }
+  if (!TME_HOSTNAMES.has(url.hostname)) {
+    return { type: "unknown", url: link };
+  }
+  const segments = url.pathname.split("/").filter(Boolean);
+  if (segments.length === 0) return { type: "unknown", url: link };
+  if (segments[0].startsWith("+")) {
+    return { type: "join-chat", inviteHash: segments[0].slice(1) };
+  }
+  if (segments[0] === "joinchat" && segments[1]) {
+    return { type: "join-chat", inviteHash: segments[1] };
+  }
+  if (segments[0] === "share" && segments[1] === "url") {
+    return {
+      type: "share",
+      url: (_b = url.searchParams.get("url")) != null ? _b : void 0,
+      text: (_c = url.searchParams.get("text")) != null ? _c : void 0
+    };
+  }
+  if (segments[0] === "c" && segments[1] && segments[2]) {
+    const messageId = Number(segments[2]);
+    return { type: "private-channel-post", internalChatId: segments[1], messageId };
+  }
+  const username = segments[0];
+  const startapp = url.searchParams.get("startapp");
+  const start = url.searchParams.get("start");
+  const mode = (_d = url.searchParams.get("mode")) != null ? _d : void 0;
+  if (segments.length >= 2) {
+    return { type: "mini-app", username, appName: segments[1], startParam: startapp != null ? startapp : void 0, mode };
+  }
+  if (startapp !== null) {
+    return { type: "mini-app", username, startParam: startapp || void 0, mode };
+  }
+  if (start !== null) {
+    return { type: "bot-start", username, startParam: start };
+  }
+  return { type: "profile", username };
+}
+
+export { buildShareLink, buildStartAppLink, buildStartLink, decodeStartParam, encodeStartParam, isValidStartParam, parseTelegramLink };

package/dist/lottie/index.d.mts

@@ -0,0 +1,3 @@
+import 'react';
+export { L as LottieAnimation, a as LottieAnimationController, T as LottieSource, P as PlayMode, b as PlayerState, l as loadLottieSource, r as renderDocumentFrame } from '../engine-BDm1_hzn.mjs';
+export { LottiePlayer, LottiePlayerHandle, LottiePlayerProps } from '../animation/lottie/index.mjs';

package/dist/lottie/index.d.ts

@@ -0,0 +1,3 @@
+import 'react';
+export { L as LottieAnimation, a as LottieAnimationController, T as LottieSource, P as PlayMode, b as PlayerState, l as loadLottieSource, r as renderDocumentFrame } from '../engine-BDm1_hzn.js';
+export { LottiePlayer, LottiePlayerHandle, LottiePlayerProps } from '../animation/lottie/index.js';