@mt-tl/server 0.1.0

package/dist/tl/codec.js

@@ -0,0 +1,297 @@
+import { TlReader, BOOL_TRUE_ID, BOOL_FALSE_ID, VECTOR_ID } from './reader.js';
+import { TlWriter } from './writer.js';
+/**
+ * IR-driven (de)serializer for arbitrary TL values. Constructed types are tagged
+ * objects `{ _: name, ...fields }`. Hand-written protocol codecs (registered on
+ * the registry) take precedence for their ids; everything else routes here.
+ *
+ * When a {@link LayeredRegistry} is supplied, `encode(value, layer)` writes each
+ * type with the constructor id/fields valid at the client's layer (decoding
+ * stays global by id). Without a layer, the merged registry is used.
+ */
+export class TlCodec {
+    registry;
+    layered;
+    /** Set transiently during a single `encode(value, layer)` call. */
+    encodeLayer;
+    constructor(registry, layered) {
+        this.registry = registry;
+        this.layered = layered;
+    }
+    encode(value, layer) {
+        this.encodeLayer = this.layered && layer !== undefined ? layer : undefined;
+        try {
+            const w = new TlWriter();
+            this.writeObject(w, value);
+            return w.toBuffer();
+        }
+        finally {
+            this.encodeLayer = undefined;
+        }
+    }
+    decode(buf) {
+        return this.readObject(new TlReader(buf));
+    }
+    /** Resolve the def to serialize a name with, honoring the active encode layer. */
+    defForWrite(name) {
+        if (this.layered && this.encodeLayer !== undefined) {
+            const layerDef = this.layered.resolve(name, this.encodeLayer);
+            if (layerDef)
+                return layerDef;
+        }
+        return this.registry.getByName(name);
+    }
+    // --- boxed object (with constructor id) ---------------------------------
+    writeObject(w, value) {
+        if (typeof value === 'boolean') {
+            w.writeBool(value);
+            return;
+        }
+        if (Array.isArray(value)) {
+            w.writeUInt32(VECTOR_ID);
+            w.writeUInt32(value.length);
+            for (const el of value)
+                this.writeObject(w, el);
+            return;
+        }
+        if (value && typeof value === 'object' && '_' in value) {
+            const obj = value;
+            const codec = this.protocolCodecByName(obj._);
+            if (codec) {
+                codec.write(w, obj);
+                return;
+            }
+            const def = this.defForWrite(obj._);
+            if (!def)
+                throw new Error(`Cannot serialize unknown TL type: ${obj._}`);
+            w.writeUInt32(def.idNum);
+            this.writeFields(w, def.params, obj);
+            return;
+        }
+        throw new Error(`Cannot serialize value as boxed object: ${String(value)}`);
+    }
+    readObject(r) {
+        const id = r.readUInt32();
+        if (id === BOOL_TRUE_ID)
+            return true;
+        if (id === BOOL_FALSE_ID)
+            return false;
+        if (id === VECTOR_ID) {
+            const count = r.readUInt32();
+            const out = [];
+            for (let i = 0; i < count; i++)
+                out.push(this.readObject(r));
+            return out;
+        }
+        const protocolCodec = this.registry.getProtocolCodec(id);
+        if (protocolCodec)
+            return protocolCodec.read(r);
+        const def = this.registry.getById(id);
+        if (!def) {
+            throw new Error(`Cannot read unknown TL id 0x${(id >>> 0).toString(16).padStart(8, '0')}`);
+        }
+        const obj = { _: def.name };
+        this.readFields(r, def.params, obj);
+        return obj;
+    }
+    // --- bare constructor (no id) -------------------------------------------
+    writeBare(w, name, value) {
+        const def = this.defForWrite(name);
+        if (!def)
+            throw new Error(`Cannot serialize unknown bare type: ${name}`);
+        this.writeFields(w, def.params, (value ?? { _: name }));
+    }
+    readBare(r, name) {
+        const def = this.registry.getByName(name);
+        if (!def)
+            throw new Error(`Cannot read unknown bare type: ${name}`);
+        const obj = { _: name };
+        this.readFields(r, def.params, obj);
+        return obj;
+    }
+    // --- fields (with flags handling) ---------------------------------------
+    writeFields(w, params, obj) {
+        const bitmaskFields = collectBitmaskFields(params);
+        const flags = {};
+        for (const p of params) {
+            if (p.type.kind !== 'flag')
+                continue;
+            const v = obj[p.name];
+            const present = p.type.inner.kind === 'true' ? v === true : v !== undefined && v !== null;
+            if (present)
+                flags[p.type.flagsField] = (flags[p.type.flagsField] ?? 0) | (1 << p.type.bit);
+        }
+        for (const p of params) {
+            const t = p.type;
+            if (bitmaskFields.has(p.name)) {
+                // Bitmask field (`flags:#` or `flags:int`): write the value computed
+                // from which conditional fields are present.
+                w.writeUInt32((flags[p.name] ?? 0) >>> 0);
+            }
+            else if (t.kind === 'flag') {
+                const set = ((flags[t.flagsField] ?? 0) >>> t.bit) & 1;
+                if (set && t.inner.kind !== 'true')
+                    this.writeType(w, t.inner, obj[p.name]);
+            }
+            else {
+                this.writeType(w, t, obj[p.name]);
+            }
+        }
+    }
+    readFields(r, params, obj) {
+        const bitmaskFields = collectBitmaskFields(params);
+        const flags = {};
+        for (const p of params) {
+            const t = p.type;
+            if (bitmaskFields.has(p.name)) {
+                const v = r.readUInt32();
+                flags[p.name] = v;
+                obj[p.name] = v;
+            }
+            else if (t.kind === 'flag') {
+                const set = ((flags[t.flagsField] ?? 0) >>> t.bit) & 1;
+                if (set)
+                    obj[p.name] = t.inner.kind === 'true' ? true : this.readType(r, t.inner);
+            }
+            else {
+                obj[p.name] = this.readType(r, t);
+            }
+        }
+    }
+    // --- single typed value --------------------------------------------------
+    writeType(w, t, value) {
+        switch (t.kind) {
+            case 'int':
+                w.writeInt32(Number(value ?? 0));
+                return;
+            case 'long':
+                w.writeLong(typeof value === 'bigint' ? value : BigInt(value ?? 0));
+                return;
+            case 'double':
+                w.writeDouble(Number(value ?? 0));
+                return;
+            case 'string':
+                // Binary may be supplied for a `string` field (the protocol schema
+                // declares pq/g_a/g_b/encrypted_data as `string`). Preserve bytes
+                // exactly; `string` and `bytes` share the same wire encoding.
+                if (Buffer.isBuffer(value))
+                    w.writeBytes(value);
+                else
+                    w.writeString(value == null ? '' : String(value));
+                return;
+            case 'bytes':
+                w.writeBytes(asBuffer(value));
+                return;
+            case 'int128':
+                w.writeFixed(asBuffer(value), 16);
+                return;
+            case 'int256':
+                w.writeFixed(asBuffer(value), 32);
+                return;
+            case 'bool':
+                w.writeBool(Boolean(value));
+                return;
+            case 'true':
+                return;
+            case 'flags':
+                w.writeUInt32(Number(value ?? 0) >>> 0);
+                return;
+            case 'vector':
+                this.writeVector(w, t, Array.isArray(value) ? value : []);
+                return;
+            case 'object':
+            case 'boxed':
+                this.writeObject(w, value);
+                return;
+            case 'bare':
+                this.writeBare(w, t.name, value);
+                return;
+            case 'flag':
+                throw new Error('flag must be handled by writeFields');
+        }
+    }
+    readType(r, t) {
+        switch (t.kind) {
+            case 'int':
+                return r.readInt32();
+            case 'long':
+                return r.readLong();
+            case 'double':
+                return r.readDouble();
+            case 'string':
+                return r.readString();
+            case 'bytes':
+                return r.readBytes();
+            case 'int128':
+                return r.readInt128();
+            case 'int256':
+                return r.readInt256();
+            case 'bool':
+                return r.readUInt32() === BOOL_TRUE_ID;
+            case 'true':
+                return true;
+            case 'flags':
+                return r.readUInt32();
+            case 'vector':
+                return this.readVector(r, t);
+            case 'object':
+            case 'boxed':
+                return this.readObject(r);
+            case 'bare':
+                return this.readBare(r, t.name);
+            case 'flag':
+                throw new Error('flag must be handled by readFields');
+        }
+    }
+    writeVector(w, t, arr) {
+        if (t.boxed)
+            w.writeUInt32(VECTOR_ID);
+        w.writeUInt32(arr.length);
+        for (const el of arr)
+            this.writeType(w, t.inner, el);
+    }
+    readVector(r, t) {
+        if (t.boxed) {
+            const id = r.readUInt32();
+            if (id !== VECTOR_ID) {
+                throw new Error(`Expected Vector id, got 0x${(id >>> 0).toString(16).padStart(8, '0')}`);
+            }
+        }
+        const count = r.readUInt32();
+        const out = [];
+        for (let i = 0; i < count; i++)
+            out.push(this.readType(r, t.inner));
+        return out;
+    }
+    protocolCodecByName(name) {
+        const def = this.registry.getByName(name);
+        if (!def)
+            return undefined;
+        return this.registry.getProtocolCodec(def.idNum);
+    }
+}
+/**
+ * Names of the bitmask fields in a param list: any `#` field plus any field
+ * referenced by a conditional (`name.bit?...`). Handles schemas that declare
+ * the bitmask as `flags:int` rather than the canonical `flags:#`.
+ */
+function collectBitmaskFields(params) {
+    const names = new Set();
+    for (const p of params) {
+        if (p.type.kind === 'flags')
+            names.add(p.name);
+        else if (p.type.kind === 'flag')
+            names.add(p.type.flagsField);
+    }
+    return names;
+}
+function asBuffer(value) {
+    if (Buffer.isBuffer(value))
+        return value;
+    if (value == null)
+        return Buffer.alloc(0);
+    if (typeof value === 'string')
+        return Buffer.from(value, 'hex');
+    throw new Error(`Expected Buffer, got ${typeof value}`);
+}
+//# sourceMappingURL=codec.js.map

package/dist/tl/codec.js.map

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

package/dist/tl/layered-registry.d.ts

@@ -0,0 +1,29 @@
+import type { TlDef } from '@mt-tl/tl';
+import type { TlValue } from '@mt-tl/tl';
+/**
+ * Per-layer schema snapshots, used to encode a result/update with the
+ * constructor id and fields valid for a client's negotiated layer (decoding
+ * stays global by id). Also answers whether a value is representable at a layer
+ * — a pushed update whose type doesn't exist there must be substituted/dropped.
+ */
+export declare class LayeredRegistry {
+    private layers;
+    private sortedLayers;
+    addLayer(layer: number, defs: TlDef[]): void;
+    hasLayers(): boolean;
+    /** Every distinct def across all layers (by id) — for the decode-union registry. */
+    allDefs(): TlDef[];
+    layerNumbers(): number[];
+    /** Largest available layer <= requested (or the smallest if requested is below all). */
+    resolveLayer(requested: number): number | undefined;
+    resolve(name: string, layer: number): TlDef | undefined;
+    /** True iff every constructed type in the value tree exists at `layer`. */
+    representable(value: TlValue, layer: number): boolean;
+}
+/**
+ * Loads `scheme_<layer>.json` snapshots from a directory into a
+ * {@link LayeredRegistry}. A missing directory yields an empty registry
+ * (layered encoding then disabled — the gateway falls back to single-schema).
+ */
+export declare function loadLayeredRegistry(dir: string): LayeredRegistry;
+//# sourceMappingURL=layered-registry.d.ts.map

package/dist/tl/layered-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layered-registry.d.ts","sourceRoot":"","sources":["../../src/tl/layered-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAEtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAkBxC;;;;;GAKG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,YAAY,CAAe;IAEnC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI;IAO5C,SAAS,IAAI,OAAO;IAIpB,oFAAoF;IACpF,OAAO,IAAI,KAAK,EAAE;IAalB,YAAY,IAAI,MAAM,EAAE;IAIxB,wFAAwF;IACxF,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUnD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAMvD,2EAA2E;IAC3E,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;CAgBxD;AAeD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAgBhE"}

package/dist/tl/layered-registry.js

@@ -0,0 +1,118 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseType } from '@mt-tl/tl';
+/**
+ * Per-layer schema snapshots, used to encode a result/update with the
+ * constructor id and fields valid for a client's negotiated layer (decoding
+ * stays global by id). Also answers whether a value is representable at a layer
+ * — a pushed update whose type doesn't exist there must be substituted/dropped.
+ */
+export class LayeredRegistry {
+    layers = new Map();
+    sortedLayers = [];
+    addLayer(layer, defs) {
+        const byName = new Map();
+        for (const def of defs)
+            if (!byName.has(def.name))
+                byName.set(def.name, def);
+        this.layers.set(layer, { byName });
+        this.sortedLayers = [...this.layers.keys()].sort((a, b) => a - b);
+    }
+    hasLayers() {
+        return this.sortedLayers.length > 0;
+    }
+    /** Every distinct def across all layers (by id) — for the decode-union registry. */
+    allDefs() {
+        const seen = new Set();
+        const out = [];
+        for (const { byName } of this.layers.values()) {
+            for (const def of byName.values()) {
+                if (seen.has(def.id))
+                    continue;
+                seen.add(def.id);
+                out.push(def);
+            }
+        }
+        return out;
+    }
+    layerNumbers() {
+        return [...this.sortedLayers];
+    }
+    /** Largest available layer <= requested (or the smallest if requested is below all). */
+    resolveLayer(requested) {
+        if (!this.sortedLayers.length)
+            return undefined;
+        let best;
+        for (const layer of this.sortedLayers) {
+            if (layer <= requested)
+                best = layer;
+            else
+                break;
+        }
+        return best ?? this.sortedLayers[0];
+    }
+    resolve(name, layer) {
+        const l = this.resolveLayer(layer);
+        if (l === undefined)
+            return undefined;
+        return this.layers.get(l)?.byName.get(name);
+    }
+    /** True iff every constructed type in the value tree exists at `layer`. */
+    representable(value, layer) {
+        if (value === null || value === undefined)
+            return true;
+        if (Array.isArray(value))
+            return value.every(v => this.representable(v, layer));
+        if (Buffer.isBuffer(value))
+            return true;
+        if (typeof value === 'object') {
+            const obj = value;
+            if (typeof obj._ === 'string') {
+                if (!this.resolve(obj._, layer))
+                    return false;
+                for (const [k, v] of Object.entries(obj)) {
+                    if (k !== '_' && !this.representable(v, layer))
+                        return false;
+                }
+            }
+            return true;
+        }
+        return true; // primitives, bigint, boolean, string, number
+    }
+}
+function rawToDef(raw, kind) {
+    const id = raw.id.toLowerCase().padStart(8, '0');
+    return {
+        id,
+        idNum: parseInt(id, 16) >>> 0,
+        name: (raw.predicate ?? raw.method),
+        kind,
+        params: raw.params.map(p => ({ name: p.name, raw: p.type, type: parseType(p.type) })),
+        type: raw.type,
+        isProtocol: false,
+    };
+}
+/**
+ * Loads `scheme_<layer>.json` snapshots from a directory into a
+ * {@link LayeredRegistry}. A missing directory yields an empty registry
+ * (layered encoding then disabled — the gateway falls back to single-schema).
+ */
+export function loadLayeredRegistry(dir) {
+    const registry = new LayeredRegistry();
+    if (!existsSync(dir))
+        return registry;
+    for (const file of readdirSync(dir)) {
+        const m = file.match(/_(\d+)\.json$/);
+        if (!m)
+            continue;
+        const layer = Number(m[1]);
+        const raw = JSON.parse(readFileSync(join(dir, file), 'utf-8'));
+        const defs = [
+            ...raw.constructors.map(c => rawToDef(c, 'constructor')),
+            ...(raw.methods ?? []).map(c => rawToDef(c, 'method')),
+        ];
+        registry.addLayer(layer, defs);
+    }
+    return registry;
+}
+//# sourceMappingURL=layered-registry.js.map

package/dist/tl/layered-registry.js.map

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

package/dist/tl/protocol.d.ts

@@ -0,0 +1,126 @@
+import type { TlObject } from '@mt-tl/tl';
+/**
+ * Typed views over the immutable MTProto protocol/service constructors.
+ *
+ * These are the ~30 types the gateway reads/writes directly during the
+ * handshake, session setup and service-message handling. They are still
+ * encoded/decoded by the generic {@link TlCodec} (the constructors live in the
+ * registry); these interfaces just give the gateway code type-safety when it
+ * builds or inspects them. `_` is the constructor predicate.
+ */
+export interface ResPQ extends TlObject {
+    _: 'resPQ';
+    nonce: Buffer;
+    server_nonce: Buffer;
+    pq: Buffer;
+    server_public_key_fingerprints: bigint[];
+}
+export interface PQInnerData extends TlObject {
+    _: 'p_q_inner_data' | 'p_q_inner_data_dc' | 'p_q_inner_data_temp' | 'p_q_inner_data_temp_dc';
+    pq: Buffer;
+    p: Buffer;
+    q: Buffer;
+    nonce: Buffer;
+    server_nonce: Buffer;
+    new_nonce: Buffer;
+    dc?: number;
+    expires_in?: number;
+}
+export interface ServerDHParamsOk extends TlObject {
+    _: 'server_DH_params_ok';
+    nonce: Buffer;
+    server_nonce: Buffer;
+    encrypted_answer: Buffer;
+}
+export interface ServerDHParamsFail extends TlObject {
+    _: 'server_DH_params_fail';
+    nonce: Buffer;
+    server_nonce: Buffer;
+    new_nonce_hash: Buffer;
+}
+export interface ServerDHInnerData extends TlObject {
+    _: 'server_DH_inner_data';
+    nonce: Buffer;
+    server_nonce: Buffer;
+    g: number;
+    dh_prime: Buffer;
+    g_a: Buffer;
+    server_time: number;
+}
+export interface ClientDHInnerData extends TlObject {
+    _: 'client_DH_inner_data';
+    nonce: Buffer;
+    server_nonce: Buffer;
+    retry_id: bigint;
+    g_b: Buffer;
+}
+export interface DhGenOk extends TlObject {
+    _: 'dh_gen_ok';
+    nonce: Buffer;
+    server_nonce: Buffer;
+    new_nonce_hash1: Buffer;
+}
+export interface NewSessionCreated extends TlObject {
+    _: 'new_session_created';
+    first_msg_id: bigint;
+    unique_id: bigint;
+    server_salt: bigint;
+}
+export interface RpcResult extends TlObject {
+    _: 'rpc_result';
+    req_msg_id: bigint;
+    result: TlObject | boolean;
+}
+export interface RpcError extends TlObject {
+    _: 'rpc_error';
+    error_code: number;
+    error_message: string;
+}
+export interface Pong extends TlObject {
+    _: 'pong';
+    msg_id: bigint;
+    ping_id: bigint;
+}
+export interface MsgsAck extends TlObject {
+    _: 'msgs_ack';
+    msg_ids: bigint[];
+}
+export interface BadServerSalt extends TlObject {
+    _: 'bad_server_salt';
+    bad_msg_id: bigint;
+    bad_msg_seqno: number;
+    error_code: number;
+    new_server_salt: bigint;
+}
+export interface BadMsgNotification extends TlObject {
+    _: 'bad_msg_notification';
+    bad_msg_id: bigint;
+    bad_msg_seqno: number;
+    error_code: number;
+}
+export interface MsgContainer extends TlObject {
+    _: 'msg_container';
+    messages: TlObject[];
+}
+/** Well-known protocol constructor predicates, for branching in the pipeline. */
+export declare const Predicate: {
+    readonly req_pq: "req_pq";
+    readonly req_pq_multi: "req_pq_multi";
+    readonly req_DH_params: "req_DH_params";
+    readonly set_client_DH_params: "set_client_DH_params";
+    readonly ping: "ping";
+    readonly ping_delay_disconnect: "ping_delay_disconnect";
+    readonly msgs_ack: "msgs_ack";
+    readonly msgs_state_req: "msgs_state_req";
+    readonly rpc_drop_answer: "rpc_drop_answer";
+    readonly destroy_session: "destroy_session";
+    readonly get_future_salts: "get_future_salts";
+    readonly http_wait: "http_wait";
+    readonly msg_container: "msg_container";
+    readonly gzip_packed: "gzip_packed";
+    readonly invokeWithLayer: "invokeWithLayer";
+    readonly invokeWithoutUpdates: "invokeWithoutUpdates";
+    readonly invokeAfterMsg: "invokeAfterMsg";
+    readonly initConnection: "initConnection";
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/tl/protocol.d.ts.map

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

package/dist/tl/protocol.js

@@ -0,0 +1,22 @@
+/** Well-known protocol constructor predicates, for branching in the pipeline. */
+export const Predicate = {
+    req_pq: 'req_pq',
+    req_pq_multi: 'req_pq_multi',
+    req_DH_params: 'req_DH_params',
+    set_client_DH_params: 'set_client_DH_params',
+    ping: 'ping',
+    ping_delay_disconnect: 'ping_delay_disconnect',
+    msgs_ack: 'msgs_ack',
+    msgs_state_req: 'msgs_state_req',
+    rpc_drop_answer: 'rpc_drop_answer',
+    destroy_session: 'destroy_session',
+    get_future_salts: 'get_future_salts',
+    http_wait: 'http_wait',
+    msg_container: 'msg_container',
+    gzip_packed: 'gzip_packed',
+    invokeWithLayer: 'invokeWithLayer',
+    invokeWithoutUpdates: 'invokeWithoutUpdates',
+    invokeAfterMsg: 'invokeAfterMsg',
+    initConnection: 'initConnection',
+};
+//# sourceMappingURL=protocol.js.map

package/dist/tl/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/tl/protocol.ts"],"names":[],"mappings":"AA6HA,iFAAiF;AACjF,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,oBAAoB,EAAE,sBAAsB;IAC5C,IAAI,EAAE,MAAM;IACZ,qBAAqB,EAAE,uBAAuB;IAC9C,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IACpC,SAAS,EAAE,WAAW;IACtB,aAAa,EAAE,eAAe;IAC9B,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,iBAAiB;IAClC,oBAAoB,EAAE,sBAAsB;IAC5C,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;CAC1B,CAAA"}

package/dist/tl/reader.d.ts

@@ -0,0 +1,30 @@
+export declare const BOOL_TRUE_ID = 2574415285;
+export declare const BOOL_FALSE_ID = 3162085175;
+export declare const VECTOR_ID = 481674261;
+/**
+ * Low-level reader for the TL wire format. Exposes only primitive reads; the
+ * codec drives constructor-id dispatch, vectors and flags. Ported from the
+ * existing `protocolBuffer.js` (same little-endian / padding rules).
+ */
+export declare class TlReader {
+    private readonly buf;
+    private pos;
+    constructor(buf: Buffer);
+    get position(): number;
+    get remaining(): number;
+    private expect;
+    read(len: number): Buffer;
+    skip(len: number): void;
+    readUInt8(): number;
+    readUInt32(): number;
+    readInt32(): number;
+    /** TL `long` — 8 bytes LE, read as an unsigned bigint (matches existing server). */
+    readLong(): bigint;
+    readDouble(): number;
+    readInt128(): Buffer;
+    readInt256(): Buffer;
+    /** TL `bytes`/`string` — length-prefixed with 4-byte alignment padding. */
+    readBytes(): Buffer;
+    readString(): string;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/tl/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/tl/reader.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,aAAa,CAAA;AACtC,eAAO,MAAM,aAAa,aAAa,CAAA;AACvC,eAAO,MAAM,SAAS,YAAa,CAAA;AAEnC;;;;GAIG;AACH,qBAAa,QAAQ;IAGL,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,GAAG,CAAI;gBAEc,GAAG,EAAE,MAAM;IAExC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,OAAO,CAAC,MAAM;IAMd,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAOzB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKvB,SAAS,IAAI,MAAM;IAKnB,UAAU,IAAI,MAAM;IAOpB,SAAS,IAAI,MAAM;IAOnB,oFAAoF;IACpF,QAAQ,IAAI,MAAM;IAIlB,UAAU,IAAI,MAAM;IAOpB,UAAU,IAAI,MAAM;IAIpB,UAAU,IAAI,MAAM;IAIpB,2EAA2E;IAC3E,SAAS,IAAI,MAAM;IAanB,UAAU,IAAI,MAAM;CAGvB"}