@melandlabs/integrations-telegram 0.1.0

package/dist/state.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Telegram User Listener — Pure State Layer
+ *
+ * Extracted from TelegramUserListener to enable memory-only unit testing
+ * of state-machine transitions without external IO (MTProto client, timers).
+ */
+/** Calculate exponential backoff delay and whether to give up. */
+declare function calculateBackoffDelay(attempts: number, baseMs: number, maxAttempts: number): {
+    delayMs: number;
+    shouldGiveUp: boolean;
+};
+/** Determine whether a connection is stale based on last event time. */
+declare function isConnectionStale(lastEventTime: number, now: number, staleThresholdMs: number): boolean;
+/** Map UpdateConnectionState numeric codes to human-readable strings. */
+declare function resolveConnectionState(stateCode: number | string): string;
+/** Decide whether an incoming message should be processed (idempotent + dedup). */
+declare function shouldProcessMessage(msgId: number, lastProcessedId: number, ownSentIds: Set<number>): boolean;
+/** Evict oldest entries from own-sent message ID set when cap is exceeded. */
+declare function pruneOwnSentIds(set: Set<number>, maxSize: number): void;
+
+export { calculateBackoffDelay, isConnectionStale, pruneOwnSentIds, resolveConnectionState, shouldProcessMessage };

package/dist/state.js

@@ -0,0 +1,38 @@
+// src/state.ts
+function calculateBackoffDelay(attempts, baseMs, maxAttempts) {
+  const shouldGiveUp = attempts >= maxAttempts;
+  if (shouldGiveUp) {
+    return { delayMs: 0, shouldGiveUp: true };
+  }
+  const delayMs = baseMs * 2 ** attempts;
+  return { delayMs, shouldGiveUp: false };
+}
+function isConnectionStale(lastEventTime, now, staleThresholdMs) {
+  const elapsed = now - lastEventTime;
+  return elapsed > staleThresholdMs;
+}
+function resolveConnectionState(stateCode) {
+  const stateMap = {
+    0: "connecting",
+    1: "connected",
+    2: "disconnected",
+    "-1": "connectionLost"
+  };
+  return stateMap[stateCode] || `unknown(${stateCode})`;
+}
+function shouldProcessMessage(msgId, lastProcessedId, ownSentIds) {
+  if (msgId <= lastProcessedId) return false;
+  if (ownSentIds.has(msgId)) return false;
+  return true;
+}
+function pruneOwnSentIds(set, maxSize) {
+  if (set.size <= maxSize) return;
+  const oldest = set.values().next().value;
+  if (oldest !== void 0) {
+    set.delete(oldest);
+  }
+}
+
+export { calculateBackoffDelay, isConnectionStale, pruneOwnSentIds, resolveConnectionState, shouldProcessMessage };
+//# sourceMappingURL=state.js.map
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/state.ts"],"names":[],"mappings":";AAQO,SAAS,qBAAA,CACf,QAAA,EACA,MAAA,EACA,WAAA,EAC6C;AAC7C,EAAA,MAAM,eAAe,QAAA,IAAY,WAAA;AACjC,EAAA,IAAI,YAAA,EAAc;AACjB,IAAA,OAAO,EAAE,OAAA,EAAS,CAAA,EAAG,YAAA,EAAc,IAAA,EAAK;AAAA,EACzC;AACA,EAAA,MAAM,OAAA,GAAU,SAAS,CAAA,IAAK,QAAA;AAC9B,EAAA,OAAO,EAAE,OAAA,EAAS,YAAA,EAAc,KAAA,EAAM;AACvC;AAGO,SAAS,iBAAA,CAAkB,aAAA,EAAuB,GAAA,EAAa,gBAAA,EAAmC;AACxG,EAAA,MAAM,UAAU,GAAA,GAAM,aAAA;AACtB,EAAA,OAAO,OAAA,GAAU,gBAAA;AAClB;AAGO,SAAS,uBAAuB,SAAA,EAAoC;AAC1E,EAAA,MAAM,QAAA,GAAmC;AAAA,IACxC,CAAA,EAAG,YAAA;AAAA,IACH,CAAA,EAAG,WAAA;AAAA,IACH,CAAA,EAAG,cAAA;AAAA,IACH,IAAA,EAAM;AAAA,GACP;AACA,EAAA,OAAO,QAAA,CAAS,SAAmB,CAAA,IAAK,CAAA,QAAA,EAAW,SAAS,CAAA,CAAA,CAAA;AAC7D;AAGO,SAAS,oBAAA,CACf,KAAA,EACA,eAAA,EACA,UAAA,EACU;AACV,EAAA,IAAI,KAAA,IAAS,iBAAiB,OAAO,KAAA;AACrC,EAAA,IAAI,UAAA,CAAW,GAAA,CAAI,KAAK,CAAA,EAAG,OAAO,KAAA;AAClC,EAAA,OAAO,IAAA;AACR;AAGO,SAAS,eAAA,CAAgB,KAAkB,OAAA,EAAuB;AACxE,EAAA,IAAI,GAAA,CAAI,QAAQ,OAAA,EAAS;AACzB,EAAA,MAAM,MAAA,GAAS,GAAA,CAAI,MAAA,EAAO,CAAE,MAAK,CAAE,KAAA;AACnC,EAAA,IAAI,WAAW,MAAA,EAAW;AACzB,IAAA,GAAA,CAAI,OAAO,MAAM,CAAA;AAAA,EAClB;AACD","file":"state.js","sourcesContent":["/**\n * Telegram User Listener — Pure State Layer\n *\n * Extracted from TelegramUserListener to enable memory-only unit testing\n * of state-machine transitions without external IO (MTProto client, timers).\n */\n\n/** Calculate exponential backoff delay and whether to give up. */\nexport function calculateBackoffDelay(\n\tattempts: number,\n\tbaseMs: number,\n\tmaxAttempts: number,\n): { delayMs: number; shouldGiveUp: boolean } {\n\tconst shouldGiveUp = attempts >= maxAttempts;\n\tif (shouldGiveUp) {\n\t\treturn { delayMs: 0, shouldGiveUp: true };\n\t}\n\tconst delayMs = baseMs * 2 ** attempts;\n\treturn { delayMs, shouldGiveUp: false };\n}\n\n/** Determine whether a connection is stale based on last event time. */\nexport function isConnectionStale(lastEventTime: number, now: number, staleThresholdMs: number): boolean {\n\tconst elapsed = now - lastEventTime;\n\treturn elapsed > staleThresholdMs;\n}\n\n/** Map UpdateConnectionState numeric codes to human-readable strings. */\nexport function resolveConnectionState(stateCode: number | string): string {\n\tconst stateMap: Record<number, string> = {\n\t\t0: \"connecting\",\n\t\t1: \"connected\",\n\t\t2: \"disconnected\",\n\t\t\"-1\": \"connectionLost\",\n\t};\n\treturn stateMap[stateCode as number] || `unknown(${stateCode})`;\n}\n\n/** Decide whether an incoming message should be processed (idempotent + dedup). */\nexport function shouldProcessMessage(\n\tmsgId: number,\n\tlastProcessedId: number,\n\townSentIds: Set<number>,\n): boolean {\n\tif (msgId <= lastProcessedId) return false;\n\tif (ownSentIds.has(msgId)) return false;\n\treturn true;\n}\n\n/** Evict oldest entries from own-sent message ID set when cap is exceeded. */\nexport function pruneOwnSentIds(set: Set<number>, maxSize: number): void {\n\tif (set.size <= maxSize) return;\n\tconst oldest = set.values().next().value;\n\tif (oldest !== undefined) {\n\t\tset.delete(oldest);\n\t}\n}\n"]}

package/dist/tdata-converter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Main conversion function: Convert tdata to StringSession
+ */
+declare function convertTdataToStringSession(tdataPath: string): Promise<string>;
+/**
+ * Validate if a directory contains valid Telegram Desktop tdata
+ */
+declare function validateTdataDirectory(tdataPath: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Extract basic account info from tdata
+ */
+interface TdataAccountInfo {
+    userId: number;
+    dcId: number;
+}
+declare function extractAccountInfo(tdataPath: string): TdataAccountInfo | null;
+
+export { type TdataAccountInfo, convertTdataToStringSession, extractAccountInfo, validateTdataDirectory };