@mt-tl/server 0.1.0

package/dist/tl/reader.js

@@ -0,0 +1,87 @@
+import { toBigIntLE } from '../util/bytes.js';
+export const BOOL_TRUE_ID = 0x997275b5;
+export const BOOL_FALSE_ID = 0xbc799737;
+export const VECTOR_ID = 0x1cb5c415;
+/**
+ * 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 class TlReader {
+    buf;
+    pos = 0;
+    constructor(buf) {
+        this.buf = buf;
+    }
+    get position() {
+        return this.pos;
+    }
+    get remaining() {
+        return this.buf.length - this.pos;
+    }
+    expect(len) {
+        if (this.buf.length < this.pos + len) {
+            throw new Error(`TL read out of bounds: need ${len}, have ${this.remaining}`);
+        }
+    }
+    read(len) {
+        this.expect(len);
+        const out = this.buf.subarray(this.pos, this.pos + len);
+        this.pos += len;
+        return out;
+    }
+    skip(len) {
+        this.expect(len);
+        this.pos += len;
+    }
+    readUInt8() {
+        this.expect(1);
+        return this.buf.readUInt8(this.pos++);
+    }
+    readUInt32() {
+        this.expect(4);
+        const v = this.buf.readUInt32LE(this.pos);
+        this.pos += 4;
+        return v;
+    }
+    readInt32() {
+        this.expect(4);
+        const v = this.buf.readInt32LE(this.pos);
+        this.pos += 4;
+        return v;
+    }
+    /** TL `long` — 8 bytes LE, read as an unsigned bigint (matches existing server). */
+    readLong() {
+        return toBigIntLE(this.read(8));
+    }
+    readDouble() {
+        this.expect(8);
+        const v = this.buf.readDoubleLE(this.pos);
+        this.pos += 8;
+        return v;
+    }
+    readInt128() {
+        return Buffer.from(this.read(16));
+    }
+    readInt256() {
+        return Buffer.from(this.read(32));
+    }
+    /** TL `bytes`/`string` — length-prefixed with 4-byte alignment padding. */
+    readBytes() {
+        let extra = 1;
+        let len = this.readUInt8();
+        if (len >= 254) {
+            len = this.readUInt8() + this.readUInt8() * 256 + this.readUInt8() * 65536;
+            extra = 4;
+        }
+        const out = Buffer.from(this.read(len));
+        const rem = (len + extra) % 4;
+        if (rem > 0)
+            this.skip(4 - rem);
+        return out;
+    }
+    readString() {
+        return this.readBytes().toString('utf-8');
+    }
+}
+//# sourceMappingURL=reader.js.map

package/dist/tl/reader.js.map

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

package/dist/tl/registry.d.ts

@@ -0,0 +1,39 @@
+import type { TlDef } from '@mt-tl/tl';
+/**
+ * Resolves TL definitions both ways: by wire constructor id (for decoding) and
+ * by name (for encoding a result the backend returned as `{ _: name, ... }`).
+ *
+ * Hand-written protocol/service classes register a {@link ProtocolCodec} for
+ * their id so the pipeline can read/write them with typed code; everything else
+ * falls through to the generic, IR-driven codec.
+ */
+export interface ProtocolCodec {
+    id: string;
+    name: string;
+    read(reader: import('./reader.js').TlReader): unknown;
+    write(writer: import('./writer.js').TlWriter, value: unknown): void;
+}
+export declare class TlRegistry {
+    private byId;
+    private byName;
+    private protocolCodecs;
+    register(def: TlDef): void;
+    registerProtocolCodec(codec: ProtocolCodec): void;
+    getById(idNum: number): TlDef | undefined;
+    getByName(name: string): TlDef | undefined;
+    getProtocolCodec(idNum: number): ProtocolCodec | undefined;
+    get size(): number;
+}
+export interface LoadSchemaResult {
+    registry: TlRegistry;
+    constructors: number;
+    methods: number;
+    crcMismatches: number;
+}
+/**
+ * Loads + merges one or more `.tl` schema directories into a single registry.
+ * The gateway merges the framework's protocol schema with the app's business
+ * schema — pass protocol first (earlier dirs win a name/id clash).
+ */
+export declare function loadSchema(dirs: string | string[]): LoadSchemaResult;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tl/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAGtC;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,MAAM,EAAE,OAAO,aAAa,EAAE,QAAQ,GAAG,OAAO,CAAA;IACrD,KAAK,CAAC,MAAM,EAAE,OAAO,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;CACtE;AAED,qBAAa,UAAU;IACnB,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,cAAc,CAAmC;IAEzD,QAAQ,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI;IAK1B,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIjD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIzC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAI1C,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1D,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,UAAU,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;CACxB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,gBAAgB,CAgBpE"}

package/dist/tl/registry.js

@@ -0,0 +1,52 @@
+import { parseSchemaDir } from '@mt-tl/tl';
+export class TlRegistry {
+    byId = new Map();
+    byName = new Map();
+    protocolCodecs = new Map();
+    register(def) {
+        if (!this.byId.has(def.idNum))
+            this.byId.set(def.idNum, def);
+        if (!this.byName.has(def.name))
+            this.byName.set(def.name, def);
+    }
+    registerProtocolCodec(codec) {
+        this.protocolCodecs.set(parseInt(codec.id, 16) >>> 0, codec);
+    }
+    getById(idNum) {
+        return this.byId.get(idNum >>> 0);
+    }
+    getByName(name) {
+        return this.byName.get(name);
+    }
+    getProtocolCodec(idNum) {
+        return this.protocolCodecs.get(idNum >>> 0);
+    }
+    get size() {
+        return this.byId.size;
+    }
+}
+/**
+ * Loads + merges one or more `.tl` schema directories into a single registry.
+ * The gateway merges the framework's protocol schema with the app's business
+ * schema — pass protocol first (earlier dirs win a name/id clash).
+ */
+export function loadSchema(dirs) {
+    const list = Array.isArray(dirs) ? dirs : [dirs];
+    const registry = new TlRegistry();
+    let constructors = 0;
+    let methods = 0;
+    let crcMismatches = 0;
+    for (const dir of list) {
+        const parsed = parseSchemaDir(dir);
+        crcMismatches += parsed.crcMismatches.length;
+        for (const def of parsed.defs) {
+            registry.register(def);
+            if (def.kind === 'method')
+                methods++;
+            else
+                constructors++;
+        }
+    }
+    return { registry, constructors, methods, crcMismatches };
+}
+//# sourceMappingURL=registry.js.map

package/dist/tl/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tl/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAiB1C,MAAM,OAAO,UAAU;IACX,IAAI,GAAG,IAAI,GAAG,EAAiB,CAAA;IAC/B,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAA;IACjC,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAA;IAEzD,QAAQ,CAAC,GAAU;QACf,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAC5D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAClE,CAAC;IAED,qBAAqB,CAAC,KAAoB;QACtC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAA;IAChE,CAAC;IAED,OAAO,CAAC,KAAa;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAA;IACrC,CAAC;IAED,SAAS,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IAED,gBAAgB,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;IACzB,CAAC;CACJ;AASD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAuB;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,QAAQ,GAAG,IAAI,UAAU,EAAE,CAAA;IACjC,IAAI,YAAY,GAAG,CAAC,CAAA;IACpB,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;QAClC,aAAa,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAA;QAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5B,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;YACtB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAA;;gBAC/B,YAAY,EAAE,CAAA;QACvB,CAAC;IACL,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,CAAA;AAC7D,CAAC"}

package/dist/tl/writer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Low-level writer for the TL wire format. Grows its backing buffer in 1 KiB
+ * steps. Ported from the existing `protocolBuffer.js`.
+ */
+export declare class TlWriter {
+    private buf;
+    private pos;
+    private readonly step;
+    constructor(preallocate?: number);
+    private alloc;
+    writeRaw(val: Buffer, len?: number): this;
+    writeUInt8(val: number): this;
+    writeUInt32(val: number): this;
+    writeInt32(val: number): this;
+    writeLong(val: bigint): this;
+    writeDouble(val: number): this;
+    /** 16/32 raw bytes for int128/int256 (left-padded if a short buffer is given). */
+    writeFixed(val: Buffer, len: number): this;
+    writeBytes(val: Buffer): this;
+    writeString(val: string): this;
+    writeBool(val: boolean): this;
+    toBuffer(): Buffer;
+}
+//# sourceMappingURL=writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/tl/writer.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,QAAQ;IACjB,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,GAAG,CAAI;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;gBAEhB,WAAW,SAAO;IAI9B,OAAO,CAAC,KAAK;IASb,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,IAAI;IAO7C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM7B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAO9B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAO7B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAO9B,kFAAkF;IAClF,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAO1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAqB7B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI9B,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAI7B,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/tl/writer.js

@@ -0,0 +1,95 @@
+import { toBufferLE } from '../util/bytes.js';
+import { BOOL_FALSE_ID, BOOL_TRUE_ID } from './reader.js';
+/**
+ * Low-level writer for the TL wire format. Grows its backing buffer in 1 KiB
+ * steps. Ported from the existing `protocolBuffer.js`.
+ */
+export class TlWriter {
+    buf;
+    pos = 0;
+    step = 1024;
+    constructor(preallocate = 1024) {
+        this.buf = Buffer.allocUnsafe(preallocate);
+    }
+    alloc(len) {
+        if (this.buf.length >= this.pos + len)
+            return;
+        let target = this.buf.length + this.step;
+        while (target < this.pos + len)
+            target += this.step;
+        const next = Buffer.allocUnsafe(target);
+        this.buf.copy(next, 0, 0, this.pos);
+        this.buf = next;
+    }
+    writeRaw(val, len = val.length) {
+        this.alloc(len);
+        val.copy(this.buf, this.pos, 0, len);
+        this.pos += len;
+        return this;
+    }
+    writeUInt8(val) {
+        this.alloc(1);
+        this.buf.writeUInt8(val & 0xff, this.pos++);
+        return this;
+    }
+    writeUInt32(val) {
+        this.alloc(4);
+        this.buf.writeUInt32LE(val >>> 0, this.pos);
+        this.pos += 4;
+        return this;
+    }
+    writeInt32(val) {
+        this.alloc(4);
+        this.buf.writeInt32LE(val | 0, this.pos);
+        this.pos += 4;
+        return this;
+    }
+    writeLong(val) {
+        return this.writeRaw(toBufferLE(BigInt(val), 8), 8);
+    }
+    writeDouble(val) {
+        this.alloc(8);
+        this.buf.writeDoubleLE(val, this.pos);
+        this.pos += 8;
+        return this;
+    }
+    /** 16/32 raw bytes for int128/int256 (left-padded if a short buffer is given). */
+    writeFixed(val, len) {
+        if (val.length === len)
+            return this.writeRaw(val, len);
+        const padded = Buffer.alloc(len);
+        val.copy(padded, len - val.length);
+        return this.writeRaw(padded, len);
+    }
+    writeBytes(val) {
+        let len;
+        if (val.length < 254) {
+            this.writeUInt8(val.length);
+            len = 1;
+        }
+        else {
+            // 0xfe marker + 3-byte LE length
+            this.writeUInt8(254);
+            this.writeUInt32(val.length);
+            this.pos--;
+            len = 4;
+        }
+        this.writeRaw(val);
+        len += val.length;
+        while (len % 4 !== 0) {
+            this.writeUInt8(0);
+            len++;
+        }
+        return this;
+    }
+    writeString(val) {
+        return this.writeBytes(val ? Buffer.from(val, 'utf-8') : Buffer.alloc(0));
+    }
+    writeBool(val) {
+        return this.writeUInt32(val ? BOOL_TRUE_ID : BOOL_FALSE_ID);
+    }
+    toBuffer() {
+        return Buffer.from(this.buf.subarray(0, this.pos));
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/tl/writer.js.map

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

package/dist/transport/connection-registry.d.ts

@@ -0,0 +1,31 @@
+import type { Connection } from './connection.js';
+/**
+ * Per-node map of authorized subject -> live connections, used to deliver
+ * server-pushed updates to the right sockets. A subject (internal user id) may
+ * have several connections (multiple devices/sessions) on one node.
+ */
+export declare class ConnectionRegistry {
+    private bySubject;
+    private connSubject;
+    private byAuthKey;
+    private connAuthKey;
+    register(subject: string, conn: Connection): void;
+    /** Index a connection by its auth key, for delivery before/without a subject. */
+    registerAuthKey(authKeyId: string, conn: Connection): void;
+    /** Remove a connection from both indexes; returns the keys it was held under. */
+    unregister(conn: Connection): {
+        subject?: string;
+        authKeyId?: string;
+    };
+    subjectOf(conn: Connection): string | undefined;
+    hasSubject(subject: string): boolean;
+    hasAuthKey(authKeyId: string): boolean;
+    getBySubject(subject: string): Connection[];
+    getByAuthKey(authKeyId: string): Connection[];
+    /** All subjects with at least one local connection (for presence heartbeat). */
+    subjects(): string[];
+    /** All auth keys with at least one local connection (for presence heartbeat). */
+    authKeys(): string[];
+    get size(): number;
+}
+//# sourceMappingURL=connection-registry.d.ts.map

package/dist/transport/connection-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-registry.d.ts","sourceRoot":"","sources":["../../src/transport/connection-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;;;GAIG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,WAAW,CAAgC;IAEnD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAOjD,iFAAiF;IACjF,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAM1D,iFAAiF;IACjF,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IActE,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS;IAI/C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAGpC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAI3C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;IAK7C,gFAAgF;IAChF,QAAQ,IAAI,MAAM,EAAE;IAGpB,iFAAiF;IACjF,QAAQ,IAAI,MAAM,EAAE;IAIpB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ"}

package/dist/transport/connection-registry.js

@@ -0,0 +1,84 @@
+/**
+ * Per-node map of authorized subject -> live connections, used to deliver
+ * server-pushed updates to the right sockets. A subject (internal user id) may
+ * have several connections (multiple devices/sessions) on one node.
+ */
+export class ConnectionRegistry {
+    bySubject = new Map();
+    connSubject = new Map();
+    byAuthKey = new Map();
+    connAuthKey = new Map();
+    register(subject, conn) {
+        const prev = this.connSubject.get(conn);
+        if (prev !== undefined && prev !== subject)
+            removeFrom(this.bySubject, prev, conn);
+        this.connSubject.set(conn, subject);
+        addTo(this.bySubject, subject, conn);
+    }
+    /** Index a connection by its auth key, for delivery before/without a subject. */
+    registerAuthKey(authKeyId, conn) {
+        if (this.connAuthKey.get(conn) === authKeyId)
+            return;
+        this.connAuthKey.set(conn, authKeyId);
+        addTo(this.byAuthKey, authKeyId, conn);
+    }
+    /** Remove a connection from both indexes; returns the keys it was held under. */
+    unregister(conn) {
+        const subject = this.connSubject.get(conn);
+        if (subject !== undefined) {
+            this.connSubject.delete(conn);
+            removeFrom(this.bySubject, subject, conn);
+        }
+        const authKeyId = this.connAuthKey.get(conn);
+        if (authKeyId !== undefined) {
+            this.connAuthKey.delete(conn);
+            removeFrom(this.byAuthKey, authKeyId, conn);
+        }
+        return { subject, authKeyId };
+    }
+    subjectOf(conn) {
+        return this.connSubject.get(conn);
+    }
+    hasSubject(subject) {
+        return this.bySubject.has(subject);
+    }
+    hasAuthKey(authKeyId) {
+        return this.byAuthKey.has(authKeyId);
+    }
+    getBySubject(subject) {
+        const set = this.bySubject.get(subject);
+        return set ? [...set] : [];
+    }
+    getByAuthKey(authKeyId) {
+        const set = this.byAuthKey.get(authKeyId);
+        return set ? [...set] : [];
+    }
+    /** All subjects with at least one local connection (for presence heartbeat). */
+    subjects() {
+        return [...this.bySubject.keys()];
+    }
+    /** All auth keys with at least one local connection (for presence heartbeat). */
+    authKeys() {
+        return [...this.byAuthKey.keys()];
+    }
+    get size() {
+        return this.connSubject.size;
+    }
+}
+function addTo(map, key, conn) {
+    let set = map.get(key);
+    if (!set) {
+        set = new Set();
+        map.set(key, set);
+    }
+    set.add(conn);
+}
+function removeFrom(map, key, conn) {
+    const set = map.get(key);
+    if (!set)
+        return;
+    set.delete(conn);
+    if (set.size === 0)
+        map.delete(key);
+}
+//# sourceMappingURL=connection-registry.js.map

package/dist/transport/connection-registry.js.map

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

package/dist/transport/connection.d.ts

@@ -0,0 +1,62 @@
+import { type Logger } from '@mt-tl/tl';
+import { Framing } from './framing.js';
+import { type MsgIdState } from '../session/message-id.js';
+import { InboundTracker } from '../session/inbound-tracker.js';
+/**
+ * Per-connection state. Holds transport framing, the negotiated TL layer,
+ * auth-key/session binding (filled after the handshake and first encrypted
+ * message), and outgoing message-id/seq counters.
+ */
+export interface ConnectionCtx extends MsgIdState {
+    connectionId: number;
+    remoteAddress?: string;
+    apiLayer: number;
+    authKeyId?: bigint;
+    authKey?: Buffer;
+    sessionId?: bigint;
+    uniqueId?: bigint;
+    serverSalt?: bigint;
+    apiId?: number;
+    deviceModel?: string;
+    systemVersion?: string;
+    appVersion?: string;
+    systemLangCode?: string;
+    langCode?: string;
+    /** Bound subject (internal user id) once the auth key is authorized. */
+    subject?: string;
+    /** Set when the client wrapped a query in `invokeWithoutUpdates` — this
+     * connection is excluded from server-push delivery. */
+    noUpdates?: boolean;
+}
+export declare class Connection {
+    private readonly transportSend;
+    private readonly transportClose;
+    readonly id: number;
+    /** Per-connection logger (carrier-scoped child); also passed to framing. */
+    readonly log: Logger;
+    readonly framing: Framing;
+    /** Inbound msg_id/seqno validation + received-message state (per session). */
+    readonly tracker: InboundTracker;
+    ctx: ConnectionCtx;
+    closed: boolean;
+    private tail;
+    /** Idle-disconnect window (ms) requested via `ping_delay_disconnect`; 0 = none. */
+    private disconnectMs;
+    private disconnectTimer?;
+    constructor(id: number, transportSend: (bytes: Buffer) => void, transportClose: () => void, remoteAddress?: string, defaultLayer?: number, log?: Logger);
+    /** Frame a fully-built MTProto packet (plaintext or encrypted) and send it. */
+    send(packet: Buffer): void;
+    nextMessageId(isNotification?: boolean): bigint;
+    nextSeqNo(contentRelated?: boolean): number;
+    /** Serialize async work per connection so messages are processed in order. */
+    enqueue(fn: () => void | Promise<void>): void;
+    /**
+     * Arm (or re-arm) the `ping_delay_disconnect` idle timer: close the connection
+     * after `delaySec` seconds of inactivity. A delay of 0 disarms it.
+     */
+    armDisconnect(delaySec: number): void;
+    /** Reset the idle timer on activity. No-op unless armed via {@link armDisconnect}. */
+    resetDisconnect(): void;
+    close(): void;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/transport/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/transport/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAE9D;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC7C,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAEhB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IAGnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;2DACuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,qBAAa,UAAU;IAgBf,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAhBnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,iBAAuB;IACvC,GAAG,EAAE,aAAa,CAAA;IAClB,MAAM,UAAQ;IACd,OAAO,CAAC,IAAI,CAAmC;IAC/C,mFAAmF;IACnF,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,eAAe,CAAC,CAA+B;gBAGnD,EAAE,EAAE,MAAM,EACO,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EACtC,cAAc,EAAE,MAAM,IAAI,EAC3C,aAAa,CAAC,EAAE,MAAM,EACtB,YAAY,SAAM,EAClB,GAAG,GAAE,MAAmB;IAc5B,+EAA+E;IAC/E,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK1B,aAAa,CAAC,cAAc,UAAQ,GAAG,MAAM;IAI7C,SAAS,CAAC,cAAc,UAAO,GAAG,MAAM;IAIxC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI7C;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKrC,sFAAsF;IACtF,eAAe,IAAI,IAAI;IAOvB,KAAK,IAAI,IAAI;CAMhB"}

package/dist/transport/connection.js

@@ -0,0 +1,77 @@
+import { noopLogger } from '@mt-tl/tl';
+import { Framing } from './framing.js';
+import { nextMessageId, nextSeqNo } from '../session/message-id.js';
+import { InboundTracker } from '../session/inbound-tracker.js';
+export class Connection {
+    transportSend;
+    transportClose;
+    id;
+    /** Per-connection logger (carrier-scoped child); also passed to framing. */
+    log;
+    framing;
+    /** Inbound msg_id/seqno validation + received-message state (per session). */
+    tracker = new InboundTracker();
+    ctx;
+    closed = false;
+    tail = Promise.resolve();
+    /** Idle-disconnect window (ms) requested via `ping_delay_disconnect`; 0 = none. */
+    disconnectMs = 0;
+    disconnectTimer;
+    constructor(id, transportSend, transportClose, remoteAddress, defaultLayer = 204, log = noopLogger) {
+        this.transportSend = transportSend;
+        this.transportClose = transportClose;
+        this.id = id;
+        this.log = log;
+        this.framing = new Framing(log);
+        this.ctx = {
+            connectionId: id,
+            remoteAddress,
+            apiLayer: defaultLayer,
+            lastMessageId: null,
+            messageSeqNo: 0,
+        };
+    }
+    /** Frame a fully-built MTProto packet (plaintext or encrypted) and send it. */
+    send(packet) {
+        if (this.closed)
+            return;
+        this.transportSend(this.framing.frame(packet));
+    }
+    nextMessageId(isNotification = false) {
+        return nextMessageId(this.ctx, isNotification);
+    }
+    nextSeqNo(contentRelated = true) {
+        return nextSeqNo(this.ctx, contentRelated);
+    }
+    /** Serialize async work per connection so messages are processed in order. */
+    enqueue(fn) {
+        this.tail = this.tail.then(fn).catch(() => { });
+    }
+    /**
+     * Arm (or re-arm) the `ping_delay_disconnect` idle timer: close the connection
+     * after `delaySec` seconds of inactivity. A delay of 0 disarms it.
+     */
+    armDisconnect(delaySec) {
+        this.disconnectMs = Math.max(0, Math.floor(delaySec)) * 1000;
+        this.resetDisconnect();
+    }
+    /** Reset the idle timer on activity. No-op unless armed via {@link armDisconnect}. */
+    resetDisconnect() {
+        if (this.disconnectTimer)
+            clearTimeout(this.disconnectTimer);
+        if (!this.disconnectMs)
+            return;
+        this.disconnectTimer = setTimeout(() => this.close(), this.disconnectMs);
+        if (typeof this.disconnectTimer.unref === 'function')
+            this.disconnectTimer.unref();
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.disconnectTimer)
+            clearTimeout(this.disconnectTimer);
+        this.transportClose();
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/transport/connection.js.map

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

package/dist/transport/framing.d.ts

@@ -0,0 +1,39 @@
+import { type Logger } from '@mt-tl/tl';
+/**
+ * MTProto transport framing. The same four modes the existing server supports
+ * are delivered identically over TCP or inside binary WebSocket frames, so the
+ * gateway feeds raw bytes here regardless of carrier.
+ *
+ * Modes: abridged (0xef), intermediate (0xeeeeeeee), full, and obfuscated
+ * (a 64-byte AES-CTR header that wraps abridged/intermediate). Detection mirrors
+ * `server.js` exactly for wire-compatibility.
+ */
+export type InnerMode = 'abridged' | 'intermediate' | 'full';
+export type Mode = InnerMode | 'obfuscated';
+export declare class Framing {
+    private readonly log;
+    mode?: Mode;
+    private inner?;
+    /** Plaintext queue from which inner packets are read. */
+    private queue;
+    /** Pre-detection accumulation. */
+    private detectBuf;
+    private sequenceIn;
+    private sequenceOut;
+    private decryptor?;
+    private encryptor?;
+    constructor(log?: Logger);
+    /** Feed received bytes; returns any complete packets that became available. */
+    feed(chunk: Buffer): Buffer[];
+    /** Frame an outgoing packet for the negotiated mode. */
+    frame(packet: Buffer): Buffer;
+    private effectiveMode;
+    private detect;
+    private drain;
+    private readOne;
+    private readAbridged;
+    private readIntermediate;
+    private readFull;
+    private frameInner;
+}
+//# sourceMappingURL=framing.d.ts.map

package/dist/transport/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../../src/transport/framing.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,WAAW,CAAA;AAKnD;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,cAAc,GAAG,MAAM,CAAA;AAC5D,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,YAAY,CAAA;AAQ3C,qBAAa,OAAO;IAYJ,OAAO,CAAC,QAAQ,CAAC,GAAG;IAXhC,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,OAAO,CAAC,KAAK,CAAC,CAAW;IACzB,yDAAyD;IACzD,OAAO,CAAC,KAAK,CAAkB;IAC/B,kCAAkC;IAClC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,SAAS,CAAC,CAAU;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAU;gBAEC,GAAG,GAAE,MAAmB;IAErD,+EAA+E;IAC/E,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAY7B,wDAAwD;IACxD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAM7B,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,MAAM;IA4Dd,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,UAAU;CAiCrB"}