@mtcute/convert 0.17.0 → 0.18.0

package/convert/src/dcs.cjs

@@ -0,0 +1,119 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DC_MAPPING_PROD = {
+  1: {
+    main: {
+      id: 1,
+      ipAddress: "149.154.175.56",
+      port: 443
+    },
+    media: {
+      id: 1,
+      ipAddress: "149.154.175.211",
+      port: 443
+    }
+  },
+  2: {
+    main: {
+      id: 2,
+      ipAddress: "149.154.167.41",
+      port: 443
+    },
+    media: {
+      id: 2,
+      ipAddress: "149.154.167.35",
+      port: 443
+    }
+  },
+  3: {
+    main: {
+      id: 3,
+      ipAddress: "149.154.175.100",
+      port: 443
+    },
+    media: {
+      id: 3,
+      ipAddress: "149.154.175.100",
+      port: 443
+    }
+  },
+  4: {
+    main: {
+      id: 4,
+      ipAddress: "149.154.167.91",
+      port: 443
+    },
+    media: {
+      id: 4,
+      ipAddress: "149.154.167.255",
+      port: 443
+    }
+  },
+  5: {
+    main: {
+      id: 5,
+      ipAddress: "91.108.56.179",
+      port: 443
+    },
+    media: {
+      id: 5,
+      ipAddress: "149.154.171.255",
+      port: 443
+    }
+  }
+};
+const DC_MAPPING_TEST = {
+  1: {
+    main: {
+      id: 1,
+      ipAddress: "149.154.175.10",
+      port: 80,
+      testMode: true
+    },
+    media: {
+      id: 1,
+      ipAddress: "149.154.175.10",
+      port: 80,
+      testMode: true
+    }
+  },
+  2: {
+    main: {
+      id: 2,
+      ipAddress: "149.154.167.40",
+      port: 443,
+      testMode: true
+    },
+    media: {
+      id: 2,
+      ipAddress: "149.154.167.40",
+      port: 443,
+      testMode: true
+    }
+  },
+  3: {
+    main: {
+      id: 3,
+      ipAddress: "149.154.175.117",
+      port: 443,
+      testMode: true
+    },
+    media: {
+      id: 3,
+      ipAddress: "149.154.175.117",
+      port: 443,
+      testMode: true
+    }
+  }
+};
+function isTestDc(ip) {
+  return Object.values(DC_MAPPING_TEST).some((dc) => dc.main.ipAddress === ip || dc.media.ipAddress === ip);
+}
+exports.DC_MAPPING_PROD = DC_MAPPING_PROD;
+exports.DC_MAPPING_TEST = DC_MAPPING_TEST;
+exports.isTestDc = isTestDc;

package/convert/src/dcs.js

@@ -0,0 +1,114 @@
+const DC_MAPPING_PROD = {
+  1: {
+    main: {
+      id: 1,
+      ipAddress: "149.154.175.56",
+      port: 443
+    },
+    media: {
+      id: 1,
+      ipAddress: "149.154.175.211",
+      port: 443
+    }
+  },
+  2: {
+    main: {
+      id: 2,
+      ipAddress: "149.154.167.41",
+      port: 443
+    },
+    media: {
+      id: 2,
+      ipAddress: "149.154.167.35",
+      port: 443
+    }
+  },
+  3: {
+    main: {
+      id: 3,
+      ipAddress: "149.154.175.100",
+      port: 443
+    },
+    media: {
+      id: 3,
+      ipAddress: "149.154.175.100",
+      port: 443
+    }
+  },
+  4: {
+    main: {
+      id: 4,
+      ipAddress: "149.154.167.91",
+      port: 443
+    },
+    media: {
+      id: 4,
+      ipAddress: "149.154.167.255",
+      port: 443
+    }
+  },
+  5: {
+    main: {
+      id: 5,
+      ipAddress: "91.108.56.179",
+      port: 443
+    },
+    media: {
+      id: 5,
+      ipAddress: "149.154.171.255",
+      port: 443
+    }
+  }
+};
+const DC_MAPPING_TEST = {
+  1: {
+    main: {
+      id: 1,
+      ipAddress: "149.154.175.10",
+      port: 80,
+      testMode: true
+    },
+    media: {
+      id: 1,
+      ipAddress: "149.154.175.10",
+      port: 80,
+      testMode: true
+    }
+  },
+  2: {
+    main: {
+      id: 2,
+      ipAddress: "149.154.167.40",
+      port: 443,
+      testMode: true
+    },
+    media: {
+      id: 2,
+      ipAddress: "149.154.167.40",
+      port: 443,
+      testMode: true
+    }
+  },
+  3: {
+    main: {
+      id: 3,
+      ipAddress: "149.154.175.117",
+      port: 443,
+      testMode: true
+    },
+    media: {
+      id: 3,
+      ipAddress: "149.154.175.117",
+      port: 443,
+      testMode: true
+    }
+  }
+};
+function isTestDc(ip) {
+  return Object.values(DC_MAPPING_TEST).some((dc) => dc.main.ipAddress === ip || dc.media.ipAddress === ip);
+}
+export {
+  DC_MAPPING_PROD,
+  DC_MAPPING_TEST,
+  isTestDc
+};

package/convert/src/gramjs/convert.cjs

@@ -0,0 +1,30 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils_js = require("@mtcute/core/utils.js");
+const convert = require("../telethon/convert.cjs");
+const parse = require("./parse.cjs");
+const serialize = require("./serialize.cjs");
+function convertFromGramjsSession(session) {
+  if (typeof session === "string") {
+    session = parse.parseGramjsSession(session);
+  }
+  return convert.convertFromTelethonSession(session);
+}
+function convertToGramjsSession(session) {
+  if (typeof session === "string") {
+    session = utils_js.readStringSession(session);
+  }
+  return serialize.serializeGramjsSession({
+    dcId: session.primaryDcs.main.id,
+    ipAddress: session.primaryDcs.main.ipAddress,
+    port: session.primaryDcs.main.port,
+    authKey: session.authKey
+  });
+}
+exports.convertFromGramjsSession = convertFromGramjsSession;
+exports.convertToGramjsSession = convertToGramjsSession;

package/convert/src/gramjs/convert.js

@@ -0,0 +1,25 @@
+import { readStringSession } from "@mtcute/core/utils.js";
+import { convertFromTelethonSession } from "../telethon/convert.js";
+import { parseGramjsSession } from "./parse.js";
+import { serializeGramjsSession } from "./serialize.js";
+function convertFromGramjsSession(session) {
+  if (typeof session === "string") {
+    session = parseGramjsSession(session);
+  }
+  return convertFromTelethonSession(session);
+}
+function convertToGramjsSession(session) {
+  if (typeof session === "string") {
+    session = readStringSession(session);
+  }
+  return serializeGramjsSession({
+    dcId: session.primaryDcs.main.id,
+    ipAddress: session.primaryDcs.main.ipAddress,
+    port: session.primaryDcs.main.port,
+    authKey: session.authKey
+  });
+}
+export {
+  convertFromGramjsSession,
+  convertToGramjsSession
+};

package/convert/src/gramjs/parse.cjs

@@ -0,0 +1,33 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("@fuman/utils");
+const core = require("@mtcute/core");
+function parseGramjsSession(session) {
+  if (session[0] !== "1") {
+    throw new core.MtArgumentError(`Invalid session string (version = ${session[0]})`);
+  }
+  session = session.slice(1);
+  const data = utils.base64.decode(session);
+  const dv = utils.typed.toDataView(data);
+  const dcId = dv.getUint8(0);
+  const ipSize = dv.getUint16(1);
+  let pos = 3 + ipSize;
+  const ip = utils.utf8.decoder.decode(data.subarray(3, pos));
+  const port = dv.getUint16(pos);
+  pos += 2;
+  const authKey = data.subarray(pos, pos + 256);
+  return {
+    dcId,
+    ipAddress: ip,
+    ipv6: ip.includes(":"),
+    // dumb check but gramjs does this
+    port,
+    authKey
+  };
+}
+exports.parseGramjsSession = parseGramjsSession;

package/convert/src/gramjs/parse.js

@@ -0,0 +1,28 @@
+import { base64, typed, utf8 } from "@fuman/utils";
+import { MtArgumentError } from "@mtcute/core";
+function parseGramjsSession(session) {
+  if (session[0] !== "1") {
+    throw new MtArgumentError(`Invalid session string (version = ${session[0]})`);
+  }
+  session = session.slice(1);
+  const data = base64.decode(session);
+  const dv = typed.toDataView(data);
+  const dcId = dv.getUint8(0);
+  const ipSize = dv.getUint16(1);
+  let pos = 3 + ipSize;
+  const ip = utf8.decoder.decode(data.subarray(3, pos));
+  const port = dv.getUint16(pos);
+  pos += 2;
+  const authKey = data.subarray(pos, pos + 256);
+  return {
+    dcId,
+    ipAddress: ip,
+    ipv6: ip.includes(":"),
+    // dumb check but gramjs does this
+    port,
+    authKey
+  };
+}
+export {
+  parseGramjsSession
+};

package/convert/src/gramjs/serialize.cjs

@@ -0,0 +1,26 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("@fuman/utils");
+const core = require("@mtcute/core");
+function serializeGramjsSession(session) {
+  if (session.authKey.length !== 256) {
+    throw new core.MtArgumentError("authKey must be 256 bytes long");
+  }
+  const ipEncoded = utils.utf8.encoder.encode(session.ipAddress);
+  const u8 = new Uint8Array(261 + ipEncoded.length);
+  const dv = utils.typed.toDataView(u8);
+  dv.setUint8(0, session.dcId);
+  dv.setUint16(1, ipEncoded.length);
+  u8.set(ipEncoded, 3);
+  let pos = 3 + ipEncoded.length;
+  dv.setUint16(pos, session.port);
+  pos += 2;
+  u8.set(session.authKey, pos);
+  return `1${utils.base64.encode(u8)}`;
+}
+exports.serializeGramjsSession = serializeGramjsSession;

package/convert/src/gramjs/serialize.js

@@ -0,0 +1,21 @@
+import { utf8, typed, base64 } from "@fuman/utils";
+import { MtArgumentError } from "@mtcute/core";
+function serializeGramjsSession(session) {
+  if (session.authKey.length !== 256) {
+    throw new MtArgumentError("authKey must be 256 bytes long");
+  }
+  const ipEncoded = utf8.encoder.encode(session.ipAddress);
+  const u8 = new Uint8Array(261 + ipEncoded.length);
+  const dv = typed.toDataView(u8);
+  dv.setUint8(0, session.dcId);
+  dv.setUint16(1, ipEncoded.length);
+  u8.set(ipEncoded, 3);
+  let pos = 3 + ipEncoded.length;
+  dv.setUint16(pos, session.port);
+  pos += 2;
+  u8.set(session.authKey, pos);
+  return `1${base64.encode(u8)}`;
+}
+export {
+  serializeGramjsSession
+};

package/convert/src/mtkruto/convert.cjs

@@ -0,0 +1,33 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils_js = require("@mtcute/core/utils.js");
+const dcs = require("../dcs.cjs");
+const parse = require("./parse.cjs");
+const serialize = require("./serialize.cjs");
+function convertFromMtkrutoSession(session) {
+  if (typeof session === "string") {
+    session = parse.parseMtkrutoSession(session);
+  }
+  return {
+    version: 3,
+    primaryDcs: (session.isTest ? dcs.DC_MAPPING_TEST : dcs.DC_MAPPING_PROD)[session.dcId],
+    authKey: session.authKey
+  };
+}
+function convertToMtkrutoSession(session) {
+  if (typeof session === "string") {
+    session = utils_js.readStringSession(session);
+  }
+  return serialize.serializeMtkrutoSession({
+    dcId: session.primaryDcs.main.id,
+    isTest: session.primaryDcs.main.testMode ?? false,
+    authKey: session.authKey
+  });
+}
+exports.convertFromMtkrutoSession = convertFromMtkrutoSession;
+exports.convertToMtkrutoSession = convertToMtkrutoSession;

package/convert/src/mtkruto/convert.js

@@ -0,0 +1,28 @@
+import { readStringSession } from "@mtcute/core/utils.js";
+import { DC_MAPPING_TEST, DC_MAPPING_PROD } from "../dcs.js";
+import { parseMtkrutoSession } from "./parse.js";
+import { serializeMtkrutoSession } from "./serialize.js";
+function convertFromMtkrutoSession(session) {
+  if (typeof session === "string") {
+    session = parseMtkrutoSession(session);
+  }
+  return {
+    version: 3,
+    primaryDcs: (session.isTest ? DC_MAPPING_TEST : DC_MAPPING_PROD)[session.dcId],
+    authKey: session.authKey
+  };
+}
+function convertToMtkrutoSession(session) {
+  if (typeof session === "string") {
+    session = readStringSession(session);
+  }
+  return serializeMtkrutoSession({
+    dcId: session.primaryDcs.main.id,
+    isTest: session.primaryDcs.main.testMode ?? false,
+    authKey: session.authKey
+  });
+}
+export {
+  convertFromMtkrutoSession,
+  convertToMtkrutoSession
+};

package/convert/src/mtkruto/parse.cjs

@@ -0,0 +1,31 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("@fuman/utils");
+const core = require("@mtcute/core");
+const utils_js = require("@mtcute/core/utils.js");
+const rle = require("../utils/rle.cjs");
+function parseMtkrutoSession(session) {
+  const data = rle.telegramRleDecode(utils.base64.decode(session, true));
+  const reader = utils_js.TlBinaryReader.manual(data);
+  let dcIdStr = reader.string();
+  const authKey = reader.bytes();
+  const isTest = dcIdStr.endsWith("-test");
+  if (isTest) {
+    dcIdStr = dcIdStr.slice(0, -5);
+  }
+  const dcId = Number(dcIdStr);
+  if (Number.isNaN(dcId)) {
+    throw new core.MtArgumentError(`Invalid DC ID: ${dcIdStr}`);
+  }
+  return {
+    dcId,
+    isTest,
+    authKey
+  };
+}
+exports.parseMtkrutoSession = parseMtkrutoSession;

package/convert/src/mtkruto/parse.js

@@ -0,0 +1,26 @@
+import { base64 } from "@fuman/utils";
+import { MtArgumentError } from "@mtcute/core";
+import { TlBinaryReader } from "@mtcute/core/utils.js";
+import { telegramRleDecode } from "../utils/rle.js";
+function parseMtkrutoSession(session) {
+  const data = telegramRleDecode(base64.decode(session, true));
+  const reader = TlBinaryReader.manual(data);
+  let dcIdStr = reader.string();
+  const authKey = reader.bytes();
+  const isTest = dcIdStr.endsWith("-test");
+  if (isTest) {
+    dcIdStr = dcIdStr.slice(0, -5);
+  }
+  const dcId = Number(dcIdStr);
+  if (Number.isNaN(dcId)) {
+    throw new MtArgumentError(`Invalid DC ID: ${dcIdStr}`);
+  }
+  return {
+    dcId,
+    isTest,
+    authKey
+  };
+}
+export {
+  parseMtkrutoSession
+};

package/convert/src/mtkruto/serialize.cjs

@@ -0,0 +1,18 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("@fuman/utils");
+const utils_js = require("@mtcute/core/utils.js");
+const rle = require("../utils/rle.cjs");
+function serializeMtkrutoSession(session) {
+  const dcIdStr = `${session.dcId}${session.isTest ? "-test" : ""}`;
+  const writer = utils_js.TlBinaryWriter.manual(session.authKey.length + dcIdStr.length + 8);
+  writer.string(dcIdStr);
+  writer.bytes(session.authKey);
+  return utils.base64.encode(rle.telegramRleEncode(writer.result()), true);
+}
+exports.serializeMtkrutoSession = serializeMtkrutoSession;

package/convert/src/mtkruto/serialize.js

@@ -0,0 +1,13 @@
+import { base64 } from "@fuman/utils";
+import { TlBinaryWriter } from "@mtcute/core/utils.js";
+import { telegramRleEncode } from "../utils/rle.js";
+function serializeMtkrutoSession(session) {
+  const dcIdStr = `${session.dcId}${session.isTest ? "-test" : ""}`;
+  const writer = TlBinaryWriter.manual(session.authKey.length + dcIdStr.length + 8);
+  writer.string(dcIdStr);
+  writer.bytes(session.authKey);
+  return base64.encode(telegramRleEncode(writer.result()), true);
+}
+export {
+  serializeMtkrutoSession
+};

package/convert/src/pyrogram/convert.cjs

@@ -0,0 +1,42 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils_js = require("@mtcute/core/utils.js");
+const dcs = require("../dcs.cjs");
+const parse = require("./parse.cjs");
+const serialize = require("./serialize.cjs");
+function convertFromPyrogramSession(session) {
+  if (typeof session === "string") {
+    session = parse.parsePyrogramSession(session);
+  }
+  return {
+    version: 3,
+    primaryDcs: (session.isTest ? dcs.DC_MAPPING_TEST : dcs.DC_MAPPING_PROD)[session.dcId],
+    authKey: session.authKey,
+    self: {
+      userId: session.userId,
+      isBot: session.isBot,
+      isPremium: false,
+      usernames: []
+    }
+  };
+}
+function convertToPyrogramSession(session, params) {
+  if (typeof session === "string") {
+    session = utils_js.readStringSession(session);
+  }
+  return serialize.serializePyrogramSession({
+    apiId: params?.apiId,
+    isBot: session.self?.isBot ?? false,
+    isTest: session.primaryDcs.main.testMode ?? false,
+    userId: session.self?.userId ?? 0,
+    dcId: session.primaryDcs.main.id,
+    authKey: session.authKey
+  });
+}
+exports.convertFromPyrogramSession = convertFromPyrogramSession;
+exports.convertToPyrogramSession = convertToPyrogramSession;

package/convert/src/pyrogram/convert.js

@@ -0,0 +1,37 @@
+import { readStringSession } from "@mtcute/core/utils.js";
+import { DC_MAPPING_TEST, DC_MAPPING_PROD } from "../dcs.js";
+import { parsePyrogramSession } from "./parse.js";
+import { serializePyrogramSession } from "./serialize.js";
+function convertFromPyrogramSession(session) {
+  if (typeof session === "string") {
+    session = parsePyrogramSession(session);
+  }
+  return {
+    version: 3,
+    primaryDcs: (session.isTest ? DC_MAPPING_TEST : DC_MAPPING_PROD)[session.dcId],
+    authKey: session.authKey,
+    self: {
+      userId: session.userId,
+      isBot: session.isBot,
+      isPremium: false,
+      usernames: []
+    }
+  };
+}
+function convertToPyrogramSession(session, params) {
+  if (typeof session === "string") {
+    session = readStringSession(session);
+  }
+  return serializePyrogramSession({
+    apiId: params?.apiId,
+    isBot: session.self?.isBot ?? false,
+    isTest: session.primaryDcs.main.testMode ?? false,
+    userId: session.self?.userId ?? 0,
+    dcId: session.primaryDcs.main.id,
+    authKey: session.authKey
+  });
+}
+export {
+  convertFromPyrogramSession,
+  convertToPyrogramSession
+};