@mtcute/convert 0.18.0-rc.5 → 0.18.0

package/dcs.d.cts

@@ -0,0 +1,4 @@
+import { DcOptions } from '@mtcute/core/utils.js';
+export declare const DC_MAPPING_PROD: Record<number, DcOptions>;
+export declare const DC_MAPPING_TEST: Record<number, DcOptions>;
+export declare function isTestDc(ip: string): boolean;

package/gramjs/__fixtures__/session.d.cts

@@ -0,0 +1 @@
+export declare const GRAMJS_SESSION = "1AgAOMTQ5LjE1NC4xNjcuNDABu60obcEYS8Yb/I7YlCwaLvW84dXCX2oGnBYG+zuMciJhHP99c8ZJvwxJgH8yU1QrqI+Gh0kK0JAuQucIpDfq/jJVLZ1ZRimq5yy1XbeEs65gtZA1+SUwZRXahh+NzGbPmOVUMCnCtRONo9GNvcx/QxSXRrh7T/K0YYN1iHsK1vJDk8/SUnthvTNmRycC+JLn4fMtctqP4Le2WPOH/deYbUF0BlwmR77M7fv1GZSInqCgWReaIl5nvn0IqA4mOCTkdOgcvwOiB2UmXwiyInxRuLdBIyLbBUDCuTlmL1m3FJqbuEpZEUJnoJf2YDFZ1wR6TfL0MUS1VwnjOcy3WIIFwwg=";

package/gramjs/convert.d.cts

@@ -0,0 +1,4 @@
+import { StringSessionData } from '@mtcute/core/utils.js';
+import { TelethonSession } from '../telethon/types.js';
+export declare function convertFromGramjsSession(session: TelethonSession | string): StringSessionData;
+export declare function convertToGramjsSession(session: StringSessionData | string): string;

package/gramjs/convert.test.d.cts

@@ -0,0 +1 @@
+export {};

package/gramjs/index.d.cts

@@ -0,0 +1,4 @@
+export * from './convert.js';
+export * from './parse.js';
+export * from './serialize.js';
+export * from './types.js';

package/gramjs/parse.d.cts

@@ -0,0 +1,2 @@
+import { TelethonSession } from '../telethon/types.js';
+export declare function parseGramjsSession(session: string): TelethonSession;

package/gramjs/parse.test.d.cts

@@ -0,0 +1 @@
+export {};

package/gramjs/serialize.d.cts

@@ -0,0 +1,2 @@
+import { TelethonSession } from '../telethon/types.js';
+export declare function serializeGramjsSession(session: TelethonSession): string;

package/gramjs/serialize.test.d.cts

@@ -0,0 +1 @@
+export {};

package/gramjs/types.d.cts

@@ -0,0 +1,7 @@
+export interface GramjsSession {
+    dcId: number;
+    ipAddress: string;
+    ipv6: boolean;
+    port: number;
+    authKey: Uint8Array;
+}

package/index.d.cts

@@ -0,0 +1,6 @@
+export * from './dcs.js';
+export * from './gramjs/index.js';
+export * from './mtkruto/index.js';
+export * from './pyrogram/index.js';
+export * from './tdesktop/index.js';
+export * from './telethon/index.js';

package/mtkruto/__fixtures__/session.d.cts

@@ -0,0 +1 @@
+export declare const MTKRUTO_SESSION = "BjItdGVzdAAB_gABAQABWEIKa07Ch-9zoA024mDOpsv20TW4YwuoRRROqSi41YQCbD3c4nKnz7BcFIu1mfn6f6Xm3OTVqoT0zib4p_AuZD9H-t8j5AagecRg-oSpQlmjoiUazKQSxnxWotGWf1mPNntAeOvDNa5t1NjXUxmqdB3e2AjYLF_E2jDESVgUuDBQUMBHIDc_xFBAlz6kVxCZ6iINJHbnyJ2F19tbEPFJvSM999RKaFj5lUUVs0qKNXEUmsFYUuIdPBzjWilY8Uvf9nYU_xXd9CUAAXS5_i4aaWlHoTIf3zn8ZEINhDIU1DMauh5vhSWt7F0fkxODjtou-7PdIunuDtqyQm4steuNJc8";

package/mtkruto/convert.d.cts

@@ -0,0 +1,4 @@
+import { StringSessionData } from '@mtcute/core/utils.js';
+import { MtkrutoSession } from './types.js';
+export declare function convertFromMtkrutoSession(session: MtkrutoSession | string): StringSessionData;
+export declare function convertToMtkrutoSession(session: StringSessionData | string): string;

package/mtkruto/convert.test.d.cts

@@ -0,0 +1 @@
+export {};

package/mtkruto/index.d.cts

@@ -0,0 +1,4 @@
+export * from './convert.js';
+export * from './parse.js';
+export * from './serialize.js';
+export * from './types.js';

package/mtkruto/parse.d.cts

@@ -0,0 +1,2 @@
+import { MtkrutoSession } from './types.js';
+export declare function parseMtkrutoSession(session: string): MtkrutoSession;

package/mtkruto/parse.test.d.cts

@@ -0,0 +1 @@
+export {};

package/mtkruto/serialize.d.cts

@@ -0,0 +1,2 @@
+import { MtkrutoSession } from './types.js';
+export declare function serializeMtkrutoSession(session: MtkrutoSession): string;

package/mtkruto/serialize.test.d.cts

@@ -0,0 +1 @@
+export {};

package/mtkruto/types.d.cts

@@ -0,0 +1,5 @@
+export interface MtkrutoSession {
+    dcId: number;
+    isTest: boolean;
+    authKey: Uint8Array;
+}

package/package.json

@@ -1,20 +1,14 @@
 {
     "name": "@mtcute/convert",
     "type": "module",
-    "version": "0.18.0-rc.5",
+    "version": "0.18.0",
     "description": "Cross-library session conversion utilities",
     "license": "MIT",
-    "homepage": "https://mtcute.dev",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/mtcute/mtcute.git"
-    },
-    "scripts": {},
     "dependencies": {
-        "@mtcute/core": "0.18.0-rc.5",
-        "@fuman/utils": "0.0.3",
-        "@fuman/net": "0.0.3",
-        "@fuman/io": "0.0.3"
+        "@mtcute/core": "^0.18.0",
+        "@fuman/utils": "0.0.4",
+        "@fuman/net": "0.0.4",
+        "@fuman/io": "0.0.4"
     },
     "exports": {
         ".": {
@@ -29,5 +23,11 @@
         }
     },
     "author": "alina sireneva <alina@tei.su>",
-    "sideEffects": false
+    "sideEffects": false,
+    "homepage": "https://mtcute.dev",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/mtcute/mtcute.git"
+    },
+    "scripts": {}
 }

package/pyrogram/__fixtures__/session.d.cts

@@ -0,0 +1 @@
+export declare const PYROGRAM_TEST_SESSION = "AgAyyvcBTk6KssqikKPxEhxfXJpkoFIgQ_o8VpCk_4g0tcHe0rVCXx34AaDKvaNOlbkJOZ4jA3AI8iDYkI2opuifbM_7S2u9MMdnrjfg5jpfkXfI9-wF8DK_UBGIe1zk_Ibn0IHLRz-lkb-QqZNhh8O8Ggb8cieamatEYwLrkjkZR7JG53q76F0ktUd22L6_bUlp9p_qgXqBg8vZdkIIs9T1OiShw2X6TNO0lYqfJVaczMVQcT9Zt0FiyrAMpovFuT7-96OFKWcQ9gzrs_SHfz9HrQgBwvNSdkVziXTtxLJXsaNz3smGeyh-CEuEgdF3enIECnzftlvvUClLN_ylcPir1bi4_wAAAAEqEi1JAA";

package/pyrogram/__fixtures__/session_old.d.cts

@@ -0,0 +1 @@
+export declare const PYROGRAM_TEST_SESSION_OLD = "AgEWdHMtuA1pC01YkNiHpL1bC0yBC3wzGZCwSRWKlA_a69RhePUN3M51NpnwSXrW3pZV9FS8WjAwUkA23uT_49t8c7Umw3ihhKD6-hTpZ5wXC2MuC0EsF0-Z6WshYhT3gmN6QhEt0jlXo5cW1BJ3MYmXtsTWNf_hJfd3_wF_ZFa58ntVV-3qd08wQRhiL_IxM7L5YazjPw0dg2z92CqRARku_oq5D29V6W6bo8T-SLzF_ujj5ZcAQL25mJtCcXfhhjp9atxcrqnKzEs05xyrehnlJZKoGmnX0mF2P_6wUHqZC9tcTBUV4AmFcbuy7m_4SYLnJ8MbftNs7aWHHNcB1R4fAAAAASoSLUkA";

package/pyrogram/convert.d.cts

@@ -0,0 +1,6 @@
+import { StringSessionData } from '@mtcute/core/utils.js';
+import { PyrogramSession } from './types.js';
+export declare function convertFromPyrogramSession(session: PyrogramSession | string): StringSessionData;
+export declare function convertToPyrogramSession(session: StringSessionData | string, params?: {
+    apiId?: number;
+}): string;

package/pyrogram/convert.test.d.cts

@@ -0,0 +1 @@
+export {};

package/pyrogram/index.d.cts

@@ -0,0 +1,4 @@
+export * from './convert.js';
+export * from './parse.js';
+export * from './serialize.js';
+export * from './types.js';

package/pyrogram/parse.d.cts

@@ -0,0 +1,2 @@
+import { PyrogramSession } from './types.js';
+export declare function parsePyrogramSession(session: string): PyrogramSession;

package/pyrogram/parse.test.d.cts

@@ -0,0 +1 @@
+export {};

package/pyrogram/serialize.d.cts

@@ -0,0 +1,2 @@
+import { PyrogramSession } from './types.js';
+export declare function serializePyrogramSession(session: PyrogramSession): string;

package/pyrogram/serialize.test.d.cts

@@ -0,0 +1 @@
+export {};

package/pyrogram/types.d.cts

@@ -0,0 +1,8 @@
+export interface PyrogramSession {
+    apiId?: number;
+    dcId: number;
+    isTest: boolean;
+    authKey: Uint8Array;
+    userId: number;
+    isBot: boolean;
+}

package/tdesktop/convert.d.cts

@@ -0,0 +1,5 @@
+import { MaybeArray } from '@fuman/utils';
+import { TdataOptions, Tdata } from './tdata.js';
+import { StringSessionData } from '@mtcute/core/utils.js';
+export declare function convertFromTdata(tdata: Tdata | TdataOptions, accountIdx?: number): Promise<StringSessionData>;
+export declare function convertToTdata(sessions: MaybeArray<StringSessionData | string>, tdata: Tdata | TdataOptions): Promise<void>;

package/tdesktop/index.d.cts

@@ -0,0 +1,5 @@
+import * as qt from './qt-bundle.js';
+export { qt };
+export * from './convert.js';
+export * from './tdata.js';
+export * from './types.js';

package/tdesktop/qt-bundle.d.cts

@@ -0,0 +1,3 @@
+import * as read from './qt-reader.js';
+import * as write from './qt-writer.js';
+export { read, write };

package/tdesktop/qt-reader.d.cts

@@ -0,0 +1,6 @@
+import { ISyncReadable } from '@fuman/io';
+import { Long } from '@mtcute/core';
+export declare function readQByteArray(readable: ISyncReadable): Uint8Array;
+export declare function readLong(readable: ISyncReadable): Long;
+export declare function readCharArray(readable: ISyncReadable): Uint8Array;
+export declare function readQString(readable: ISyncReadable): string;

package/tdesktop/qt-writer.d.cts

@@ -0,0 +1,6 @@
+import { ISyncWritable } from '@fuman/io';
+import { Long } from '@mtcute/core';
+export declare function writeQByteArray(into: ISyncWritable, buf: Uint8Array): void;
+export declare function writeLong(into: ISyncWritable, long: Long): void;
+export declare function writeCharArray(into: ISyncWritable, buf: Uint8Array): void;
+export declare function writeQString(into: ISyncWritable, str: string): void;

package/tdesktop/tdata.d.cts

@@ -0,0 +1,65 @@
+import { INodeFsLike } from '../utils/fs.js';
+import { InputTdKeyData, TdKeyData, TdMtpAuthorization } from './types.js';
+import { IExtendedCryptoProvider } from '../utils/crypto.js';
+export interface TdataOptions {
+    /** Full path to the tdata directory */
+    path: string;
+    /**
+     * File system to use for reading/writing.
+     *
+     * @default  `import('node:fs/promises')`
+     */
+    fs?: INodeFsLike;
+    /**
+     * Crypto functions to use for encryption/decryption.
+     *
+     * @default  `node:crypto`-based implementation
+     */
+    crypto?: IExtendedCryptoProvider;
+    /**
+     * Whether to ignore TDF version mismatch.
+     * If set to `true`, the version will be ignored and the file will be read as is,
+     * however the probability of errors is higher.
+     */
+    ignoreVersion?: boolean;
+    /**
+     * Whether the host machine has LE processor (default true, try changing in case of errors)
+     */
+    le?: boolean;
+    /**
+     * Value of -key cli parameter.
+     * Defaults to `data`
+     */
+    dataKey?: string;
+    /**
+     * Local passcode
+     */
+    passcode?: string;
+}
+export declare class Tdata {
+    #private;
+    readonly options: TdataOptions;
+    readonly fs: INodeFsLike;
+    readonly crypto: IExtendedCryptoProvider;
+    private constructor();
+    readonly keyData: TdKeyData;
+    static open(options: TdataOptions): Promise<Tdata>;
+    static create(options: TdataOptions & {
+        keyData: InputTdKeyData;
+    }): Promise<Tdata>;
+    getDataName(idx: number): string;
+    readFile(filename: string): Promise<[number, Uint8Array]>;
+    writeFile(filename: string, data: Uint8Array, mkdir?: boolean): Promise<void>;
+    createLocalKey(salt: Uint8Array, passcode?: string): Promise<Uint8Array>;
+    decryptLocal(encrypted: Uint8Array, key: Uint8Array): Promise<Uint8Array>;
+    encryptLocal(data: Uint8Array, key: Uint8Array): Promise<Uint8Array>;
+    readKeyData(): Promise<TdKeyData>;
+    writeKeyData(keyData: TdKeyData): Promise<void>;
+    computeDataNameKey(accountIdx: number): Promise<Uint8Array>;
+    computeDataNameKeyHex(accountIdx: number): Promise<string>;
+    readEncryptedFile(filename: string): Promise<[number, Uint8Array]>;
+    writeEncryptedFile(filename: string, data: Uint8Array, mkdir?: boolean): Promise<void>;
+    readMtpAuthorization(accountIdx?: number): Promise<TdMtpAuthorization>;
+    writeMtpAuthorization(auth: TdMtpAuthorization, accountIdx?: number): Promise<void>;
+    writeEmptyMapFile(accountIdx: number): Promise<void>;
+}

package/tdesktop/tdata.test.d.cts

@@ -0,0 +1 @@
+export {};

package/tdesktop/types.d.cts

@@ -0,0 +1,22 @@
+import { Long } from '@mtcute/core';
+export interface TdAuthKey {
+    dcId: number;
+    key: Uint8Array;
+}
+export interface TdMtpAuthorization {
+    userId: Long;
+    mainDcId: number;
+    authKeys: TdAuthKey[];
+    authKeysToDestroy: TdAuthKey[];
+}
+export interface InputTdKeyData {
+    localKey?: Uint8Array;
+    version?: number;
+    count: number;
+    order: number[];
+    active: number;
+}
+export interface TdKeyData extends InputTdKeyData {
+    version: number;
+    localKey: Uint8Array;
+}

package/telethon/__fixtures__/session.d.cts

@@ -0,0 +1 @@
+export declare const TELETHON_TEST_SESSION = "1ApWapygAUChJS1_xwUK01Is4cOvQa1JKTn1POabdMUCfLmXNYFUyvG3v9Z_qbFNFp3zYP--3aVpTYI2DpB2Ib46p_bwSC0j1QEjvdQxJj26cVj8NfslrCkYrdV3glOhdczSq08kp31eqBGXMPhA7wy7DOcSLLAoy-Jf3Q_V_Q3y2a8_64ArFJe8PFfSqkdO56VQutajNLscFUtTQXUQFLJ7ft6vIl__UOc9tpQZEiFW7jWmID79WkfYLHFjuChTVKGMLDa8YcZj6z5Sq-pXPE9VbAbJ5L1JRqXOey3QGtZgJeIEww_WWD5nMMUfhLIydD2i7eDmVoUE5EIZPpsevJmjiGLw4vJk=";

package/telethon/__fixtures__/session_v6.d.cts

@@ -0,0 +1 @@
+export declare const TELETHON_TEST_SESSION_V6 = "1ASABCyjyPfABAAAAAAAAAA4Bu4pveAFWSE51_trKsrRQeMvGXMl8fI6NsGaWqdrXXeqyaXne9qNthqnrBmH56kHfOhFUCPSoVzNNrGgnQr67AYQbkhpP_Yml2EDd8epdc6Gywh4q2NBgYyW6VBT8UKg89-FebYTO6n47I1cJMGsSZ1ddxEOpIpHXsSmPdGBSTz6uaHbLYo0jnxd59PQn4H4dKb8FxuOQsUVa3vY_o79HMVMQRVT1IksUKFg5gAe5ZJ0yx6W4pMviVbC-TYZC0HInmv2fFMv-S3rQyg1C7qpU-Gbo1P6UZC4KZGmu2pMJooFNyfRbFgl3BI5Z-FNx9TKu4UFrF9G6Q0l8PjPXOZm4j-c=";

package/telethon/convert.d.cts

@@ -0,0 +1,4 @@
+import { StringSessionData } from '@mtcute/core/utils.js';
+import { TelethonSession } from './types.js';
+export declare function convertFromTelethonSession(session: TelethonSession | string): StringSessionData;
+export declare function convertToTelethonSession(session: StringSessionData | string): string;

package/telethon/convert.test.d.cts

@@ -0,0 +1 @@
+export {};

package/telethon/index.d.cts

@@ -0,0 +1,4 @@
+export * from './convert.js';
+export * from './parse.js';
+export * from './serialize.js';
+export * from './types.js';

package/telethon/parse.d.cts

@@ -0,0 +1,2 @@
+import { TelethonSession } from './types.js';
+export declare function parseTelethonSession(session: string): TelethonSession;

package/telethon/parse.test.d.cts

@@ -0,0 +1 @@
+export {};

package/telethon/serialize.d.cts

@@ -0,0 +1,2 @@
+import { TelethonSession } from './types.js';
+export declare function serializeTelethonSession(session: TelethonSession): string;

package/telethon/serialize.test.d.cts

@@ -0,0 +1 @@
+export {};

package/telethon/types.d.cts

@@ -0,0 +1,7 @@
+export interface TelethonSession {
+    dcId: number;
+    ipAddress: string;
+    ipv6: boolean;
+    port: number;
+    authKey: Uint8Array;
+}

package/utils/crypto.d.cts

@@ -0,0 +1,9 @@
+import { MaybePromise } from '@fuman/utils';
+import { ICryptoProvider } from '@mtcute/core/utils.js';
+export interface IExtendedCryptoProvider extends ICryptoProvider {
+    createHash(algorithm: 'md5' | 'sha512'): MaybePromise<{
+        update(data: Uint8Array): MaybePromise<void>;
+        digest(): MaybePromise<Uint8Array>;
+    }>;
+}
+export declare function getDefaultCryptoProvider(): Promise<IExtendedCryptoProvider>;

package/utils/fs.d.cts

@@ -0,0 +1,11 @@
+export interface INodeFsLike {
+    readFile(path: string): Promise<Uint8Array>;
+    writeFile(path: string, data: Uint8Array): Promise<void>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    stat(path: string): Promise<{
+        size: number;
+        lastModified: number;
+    }>;
+}

package/utils/rle.d.cts

@@ -0,0 +1,3 @@
+export declare function telegramRleEncode(buf: Uint8Array): Uint8Array;
+export declare function telegramRleDecode(buf: Uint8Array): Uint8Array;
+export declare function assertNever(_: never): never;