astralyx-tg-bridge 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Astralyx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,141 @@
+# @astralyx/tg-bridge
+
+Convert Telegram credentials between the formats different libraries use, through
+**one readable JSON object** as the hub. Read a Telegram Desktop `tdata` folder, a
+Telethon/Pyrogram `.session` file, or a session string (GramJS/Telethon/Pyrogram) —
+and convert back out to a Telethon `.session` or a GramJS-compatible session string.
+
+**Pure Node. Zero dependencies. Fully offline.** It does not connect to Telegram,
+does not log in, and does not interact with accounts — it only reads the local
+credential and re-serializes it.
+
+The insight: a Telegram session is just a **256-byte MTProto `auth_key` bound to a
+data-center**. Every container (`tdata`, `.session`, a session string) wraps the
+same secret. This library extracts that secret into a canonical record, from which
+any supported form can be rebuilt.
+
+```
+  tdata         ─┐                               ┌─► account.json (standard object)
+  .session       ┼─►  RawCredential  ─► normalize ┼─► session string (GramJS/Telethon)
+  session string ┘   (authKey + dc + uid)         └─► .session (Telethon, rebuilt)
+```
+
+## The standard object
+
+```jsonc
+{
+  "version": 1,
+  "source": "tdata",            // tdata | session | stringSession
+  "authKey": "a1b2c3d4…",       // 256-byte MTProto key, hex — THE credential
+  "dcId": 2,                    // data-center the key is bound to (1-5)
+  "userId": 1234567890,
+  "apiId": 2040,                // Telegram Desktop pair by default
+  "apiHash": "xxxxxxxx…",
+  "stringSession": "1BQAN…",    // GramJS-compatible string, built in pure Node
+  "phone": "+10000000000",      // sidecar metadata below; not needed to connect
+  "twoFA": "••••••••",
+  "proxy": { "type": 3, "host": "…", "port": 10020, "username": "…", "password": "…" },
+  "device": { "deviceModel": "…", "systemVersion": "…", "appVersion": "…" },
+  "meta": { "…": "source-specific passthrough" },
+  "extractedAt": "2026-09-10T…Z"
+}
+```
+
+Only `authKey` + `dcId` (+ `apiId`/`apiHash`) are required to authorize later.
+Everything else is metadata carried along for convenience.
+
+## Library API
+
+```ts
+import { extractAccount, writeStandard, decodeStringSession } from '@astralyx/tg-bridge';
+
+// Extract — synchronous, returns the final object
+const acc  = extractAccount({ type: 'tdata',   path: '/path/to/tdata' });
+const acc2 = extractAccount({ type: 'session', path: '/path/to/acc.session' });
+const acc3 = extractAccount({ type: 'stringSession', session: '1BQAN…' }); // GramJS/Telethon/Pyrogram
+
+// Persist to a folder: <out>/<userId>/account.json (+ optional .session)
+writeStandard(acc, './out', { writeSession: true });
+
+// Read a stringSession prop back into raw parts (pure, no SDK)
+const { dcId, authKey } = decodeStringSession(acc.stringSession);
+```
+
+That's it — the object is yours to store or hand to whatever MTProto client you
+use elsewhere. This package never touches the network.
+
+## CLI
+
+```bash
+# One account → stdout (or a folder with --out)
+tg-bridge extract --type tdata   --path ./account/tdata  --out ./out
+tg-bridge extract --type session --path ./account.session --out ./out --session
+tg-bridge extract --type stringSession --string "1BQAN…"  --out ./out
+
+# Every account folder under a directory (auto-detects tdata vs .session)
+tg-bridge batch --type auto --dir ./tg_sessions --out ./out --session
+#   → writes ./out/<userId>/account.json for each, plus ./out/_report.json
+```
+
+## Examples
+
+Runnable, one per situation, in [`examples/`](./examples). Build once, then run —
+each writes its result to the in-project `./out/<userId>/account.json`:
+
+```bash
+npm run build
+node examples/extract-tdata.mts            # tdata folder → object
+node examples/extract-session.mts          # .session file → object
+node examples/batch-folder.mts             # a directory of account folders → one object each
+node examples/decode-string-session.mts    # read the stringSession prop back, rebuild a .session
+```
+
+Each accepts an optional path argument; with none, it uses a sensible default.
+
+## How it works
+
+**`.session`** — plain SQLite. Read `sessions.auth_key` / `dc_id` directly (via
+Node's built-in `node:sqlite`), merge a `*.json` sidecar if present.
+
+**session string** — the compact string produced by a client library. The format
+is auto-detected: GramJS and Telethon (both a `"1"` prefix + base64, differing in
+how the server address is packed) and Pyrogram (urlsafe base64 carrying the api id
+and user id). The 256-byte key and DC are read straight out.
+
+**`tdata`** — Telegram Desktop's encrypted store. The chain (verified
+byte-for-byte against real folders):
+
+1. `key_datas` → `salt`, encrypted local key. Derive the passcode key as
+   `PBKDF2-HMAC-SHA512( SHA512(salt‖passcode‖salt), salt, iter, 256 )`
+   (`iter = 1` for an empty passcode) and decrypt the 256-byte local key.
+2. Each account file is decrypted with the local key using the MTProto-v1 KDF
+   (`prepareAES_oldmtp`) + AES-256-IGE, integrity-checked via `SHA1(plaintext)[:16]`.
+3. The `dbiMtpAuthorization` (`0x4b`) block yields `userId`, the main DC, and the
+   per-DC 256-byte auth keys.
+
+**Output** — a GramJS-compatible `stringSession` is built from `(authKey, dcId)` in
+**pure Node** (`encodeStringSession`/`decodeStringSession`, no SDK), so the record
+drops straight into any GramJS-based tool; `.session` files can be rebuilt too.
+
+## Security
+
+This library handles **live, unlocked account credentials**. The standard object
+(and the folder it writes) is a full login — anyone who reads `authKey` controls
+the account, no phone or code required, and `twoFA` sits right next to it. Treat
+the output as secret material:
+
+- Don't commit it, log it, or send it to any service you don't control.
+- For anything beyond local scratch work, encrypt `authKey`/`twoFA` at rest
+  (KMS / `pgcrypto` with a key the datastore itself doesn't hold).
+
+## Requirements
+
+- Node ≥ 22.5 (uses the built-in `node:sqlite`). No other dependencies.
+
+## Scope
+
+`tg-bridge` is an **offline format bridge** only: `tdata`/`.session`/session string
+→ standard object, plus `.session` and session-string rebuild. It deliberately does
+**not** include phone/QR/bot login or any live account interaction — those require
+an MTProto client, which this package does not bundle. Use the extracted
+`authKey`/`stringSession` with your own client for anything on-network.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * tg-bridge CLI. Pure offline extraction — no network, no SDK.
+ *
+ *   tg-bridge extract --type <session|tdata> --path <p> [--json <p>] [--passcode <p>]
+ *                     [--out <dir>] [--session]
+ *   tg-bridge batch   --type <session|tdata|auto> --dir <parent> --out <dir>
+ *                     [--passcode <p>] [--session]
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const extract_1 = require("./extract");
+const standard_1 = require("./standard");
+function parseArgs(argv) {
+    const out = {};
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a.startsWith('--')) {
+            const key = a.slice(2);
+            const next = argv[i + 1];
+            if (next && !next.startsWith('--')) {
+                out[key] = next;
+                i++;
+            }
+            else {
+                out[key] = true;
+            }
+        }
+    }
+    return out;
+}
+function logAccount(acc, where) {
+    const tag = acc.userId ?? acc.phone ?? `dc${acc.dcId}`;
+    console.error(`  ✓ ${acc.source} → user ${tag} (DC ${acc.dcId}, key ${acc.authKey.length / 2}B)` +
+        (where ? ` → ${where}` : ''));
+}
+function cmdExtract(args) {
+    const type = String(args.type || '');
+    if (type !== 'session' && type !== 'tdata' && type !== 'stringSession') {
+        throw new Error('extract --type must be session, tdata, or stringSession');
+    }
+    const account = (0, extract_1.extractAccount)({
+        type,
+        path: String(args.path),
+        session: args.string ? String(args.string) : String(args.session || ''),
+        json: args.json ? String(args.json) : undefined,
+        passcode: args.passcode ? String(args.passcode) : undefined,
+        apiId: args['api-id'] ? Number(args['api-id']) : undefined,
+        apiHash: args['api-hash'] ? String(args['api-hash']) : undefined,
+    });
+    if (args.out) {
+        const res = (0, standard_1.writeStandard)(account, String(args.out), { writeSession: Boolean(args.session) });
+        logAccount(account, res.dir);
+    }
+    else {
+        process.stdout.write(JSON.stringify(account, null, 2) + '\n');
+        logAccount(account);
+    }
+}
+function cmdBatch(args) {
+    const dir = String(args.dir);
+    const out = String(args.out || './out');
+    const typeArg = String(args.type || 'auto');
+    const passcode = args.passcode ? String(args.passcode) : '';
+    const writeSession = Boolean(args.session);
+    const entries = fs
+        .readdirSync(dir)
+        .map((e) => path.join(dir, e))
+        .filter((p) => {
+        try {
+            return fs.statSync(p).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+    let ok = 0;
+    let fail = 0;
+    const failures = [];
+    for (const p of entries) {
+        const hasTdata = fs.existsSync(path.join(p, 'tdata'));
+        const hasSession = fs.readdirSync(p).some((e) => e.endsWith('.session'));
+        let type = null;
+        if (typeArg === 'tdata')
+            type = hasTdata ? 'tdata' : null;
+        else if (typeArg === 'session')
+            type = hasSession ? 'session' : null;
+        else
+            type = hasTdata ? 'tdata' : hasSession ? 'session' : null;
+        if (!type)
+            continue;
+        try {
+            const account = (0, extract_1.extractAccount)({
+                type,
+                path: type === 'tdata' ? path.join(p, 'tdata') : p,
+                passcode,
+            });
+            const res = (0, standard_1.writeStandard)(account, out, { writeSession });
+            logAccount(account, path.relative(process.cwd(), res.dir));
+            ok++;
+        }
+        catch (e) {
+            fail++;
+            failures.push({ path: p, error: e?.message || String(e) });
+            console.error(`  ✗ ${path.basename(p)} (${type}): ${e?.message || e}`);
+        }
+    }
+    const report = { total: ok + fail, ok, fail, failures, generatedAt: new Date().toISOString() };
+    fs.mkdirSync(out, { recursive: true });
+    fs.writeFileSync(path.join(out, '_report.json'), JSON.stringify(report, null, 2));
+    console.error(`\nDone: ${ok} ok, ${fail} failed. Report: ${path.join(out, '_report.json')}`);
+}
+const HELP = `tg-bridge — Telegram .session/tdata → standard JSON (offline, no deps)
+
+Commands:
+  extract   Extract one .session or tdata folder to a standard JSON object
+  batch     Extract every account folder under a directory (auto-detects type)
+
+Examples:
+  tg-bridge extract --type tdata   --path ./acc/tdata --out ./out
+  tg-bridge extract --type session --path ./acc.session
+  tg-bridge batch   --type auto    --dir ./accounts   --out ./out --session`;
+function main() {
+    const [cmd, ...rest] = process.argv.slice(2);
+    const args = parseArgs(rest);
+    try {
+        switch (cmd) {
+            case 'extract':
+                cmdExtract(args);
+                break;
+            case 'batch':
+                cmdBatch(args);
+                break;
+            default:
+                console.error(HELP);
+                process.exit(cmd ? 1 : 0);
+        }
+    }
+    catch (e) {
+        console.error('Error: ' + (e?.message || e));
+        process.exit(1);
+    }
+    process.exit(0);
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/extract.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Top-level extractor: one call that takes a `.session` file or a `tdata` folder
+ * and returns the final StandardAccount object (key + props). No network, no SDK.
+ */
+import type { ExtractProps, StandardAccount } from './types';
+export declare function extractAccount(props: ExtractProps): StandardAccount;
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAiB,eAAe,EAAE,MAAM,SAAS,CAAC;AAM5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,CA0CnE"}

package/dist/extract.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractAccount = extractAccount;
+const session_1 = require("./session");
+const tdata_1 = require("./tdata");
+const standard_1 = require("./standard");
+const stringsession_1 = require("./stringsession");
+function extractAccount(props) {
+    switch (props.type) {
+        case 'session': {
+            const raw = (0, session_1.sessionToRawCredential)(props.path, props.json);
+            return (0, standard_1.normalizeCredential)(raw, {
+                source: 'session',
+                apiId: props.apiId,
+                apiHash: props.apiHash,
+            });
+        }
+        case 'tdata': {
+            const raw = (0, tdata_1.tdataToRawCredential)(props.path, props.passcode ?? '');
+            return (0, standard_1.normalizeCredential)(raw, {
+                source: 'tdata',
+                apiId: props.apiId,
+                apiHash: props.apiHash,
+            });
+        }
+        case 'stringSession': {
+            const parsed = (0, stringsession_1.decodeAnySessionString)(props.session);
+            if (parsed.authKey.length !== 256) {
+                throw new Error(`session string auth key is ${parsed.authKey.length} bytes, expected 256`);
+            }
+            const raw = {
+                authKey: parsed.authKey,
+                dcId: parsed.dcId,
+                userId: parsed.userId ?? null,
+                serverAddress: parsed.serverAddress,
+                port: parsed.port,
+                meta: { sourceLibrary: parsed.library, apiId: parsed.apiId },
+            };
+            return (0, standard_1.normalizeCredential)(raw, {
+                source: 'stringSession',
+                apiId: props.apiId,
+                apiHash: props.apiHash,
+            });
+        }
+        default: {
+            const _exhaustive = props;
+            throw new Error(`unknown extract type: ${JSON.stringify(_exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":";;AAUA,wCA0CC;AA/CD,uCAAmD;AACnD,mCAA+C;AAC/C,yCAAiD;AACjD,mDAAyD;AAEzD,SAAgB,cAAc,CAAC,KAAmB;IAChD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,GAAG,GAAG,IAAA,gCAAsB,EAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3D,OAAO,IAAA,8BAAmB,EAAC,GAAG,EAAE;gBAC9B,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,GAAG,GAAG,IAAA,4BAAoB,EAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YACnE,OAAO,IAAA,8BAAmB,EAAC,GAAG,EAAE;gBAC9B,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,MAAM,GAAG,IAAA,sCAAsB,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,OAAO,CAAC,MAAM,sBAAsB,CAAC,CAAC;YAC7F,CAAC;YACD,MAAM,GAAG,GAAkB;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;gBAC7B,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;aAC7D,CAAC;YACF,OAAO,IAAA,8BAAmB,EAAC,GAAG,EAAE;gBAC9B,MAAM,EAAE,eAAe;gBACvB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,KAAK,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @astralyx/tg-bridge
+ *
+ * Bring any Telegram account — from a `.session` file or a `tdata` folder — into
+ * one standard JSON object (auth key + props). Pure Node, zero dependencies, no
+ * network, no SDK. Does not interact with accounts.
+ */
+export type { StandardAccount, AccountSource, ProxyConfig, DeviceInfo, ExtractProps, SessionProps, TDataProps, StringSessionProps, RawCredential, } from './types';
+export { extractAccount } from './extract';
+export { normalizeCredential, writeStandard, writeTelethonSession, buildStringSession, dcAddress, DEFAULT_API_ID, DEFAULT_API_HASH, } from './standard';
+export { encodeStringSession, decodeStringSession, decodeAnySessionString, } from './stringsession';
+export type { DecodedStringSession, ParsedSessionString, SessionStringLibrary, } from './stringsession';
+export { sessionToRawCredential } from './session';
+export { extractTData, tdataToRawCredential, resolveTdataDir } from './tdata';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EACV,eAAe,EACf,aAAa,EACb,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTdataDir = exports.tdataToRawCredential = exports.extractTData = exports.sessionToRawCredential = exports.decodeAnySessionString = exports.decodeStringSession = exports.encodeStringSession = exports.DEFAULT_API_HASH = exports.DEFAULT_API_ID = exports.dcAddress = exports.buildStringSession = exports.writeTelethonSession = exports.writeStandard = exports.normalizeCredential = exports.extractAccount = void 0;
+// One-call extraction for any input type.
+var extract_1 = require("./extract");
+Object.defineProperty(exports, "extractAccount", { enumerable: true, get: function () { return extract_1.extractAccount; } });
+// Normalization + output.
+var standard_1 = require("./standard");
+Object.defineProperty(exports, "normalizeCredential", { enumerable: true, get: function () { return standard_1.normalizeCredential; } });
+Object.defineProperty(exports, "writeStandard", { enumerable: true, get: function () { return standard_1.writeStandard; } });
+Object.defineProperty(exports, "writeTelethonSession", { enumerable: true, get: function () { return standard_1.writeTelethonSession; } });
+Object.defineProperty(exports, "buildStringSession", { enumerable: true, get: function () { return standard_1.buildStringSession; } });
+Object.defineProperty(exports, "dcAddress", { enumerable: true, get: function () { return standard_1.dcAddress; } });
+Object.defineProperty(exports, "DEFAULT_API_ID", { enumerable: true, get: function () { return standard_1.DEFAULT_API_ID; } });
+Object.defineProperty(exports, "DEFAULT_API_HASH", { enumerable: true, get: function () { return standard_1.DEFAULT_API_HASH; } });
+// Pure StringSession codec.
+var stringsession_1 = require("./stringsession");
+Object.defineProperty(exports, "encodeStringSession", { enumerable: true, get: function () { return stringsession_1.encodeStringSession; } });
+Object.defineProperty(exports, "decodeStringSession", { enumerable: true, get: function () { return stringsession_1.decodeStringSession; } });
+Object.defineProperty(exports, "decodeAnySessionString", { enumerable: true, get: function () { return stringsession_1.decodeAnySessionString; } });
+// Lower-level extractors (use directly for batch/advanced flows).
+var session_1 = require("./session");
+Object.defineProperty(exports, "sessionToRawCredential", { enumerable: true, get: function () { return session_1.sessionToRawCredential; } });
+var tdata_1 = require("./tdata");
+Object.defineProperty(exports, "extractTData", { enumerable: true, get: function () { return tdata_1.extractTData; } });
+Object.defineProperty(exports, "tdataToRawCredential", { enumerable: true, get: function () { return tdata_1.tdataToRawCredential; } });
+Object.defineProperty(exports, "resolveTdataDir", { enumerable: true, get: function () { return tdata_1.resolveTdataDir; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAmBA,0CAA0C;AAC1C,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AAEvB,0BAA0B;AAC1B,uCAQoB;AAPlB,+GAAA,mBAAmB,OAAA;AACnB,yGAAA,aAAa,OAAA;AACb,gHAAA,oBAAoB,OAAA;AACpB,8GAAA,kBAAkB,OAAA;AAClB,qGAAA,SAAS,OAAA;AACT,0GAAA,cAAc,OAAA;AACd,4GAAA,gBAAgB,OAAA;AAGlB,4BAA4B;AAC5B,iDAIyB;AAHvB,oHAAA,mBAAmB,OAAA;AACnB,oHAAA,mBAAmB,OAAA;AACnB,uHAAA,sBAAsB,OAAA;AAQxB,kEAAkE;AAClE,qCAAmD;AAA1C,iHAAA,sBAAsB,OAAA;AAC/B,iCAA8E;AAArE,qGAAA,YAAY,OAAA;AAAE,6GAAA,oBAAoB,OAAA;AAAE,wGAAA,eAAe,OAAA"}

package/dist/session/index.d.ts

@@ -0,0 +1,3 @@
+import type { RawCredential } from '../types';
+export declare function sessionToRawCredential(sessionPath: string, sidecarPath?: string): RawCredential;
+//# sourceMappingURL=index.d.ts.map

package/dist/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,UAAU,CAAC;AA8E3D,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CA4Df"}