@mt-tl/server 0.1.0

package/dist/updates/redis-presence.d.ts

@@ -0,0 +1,43 @@
+import type { Presence } from './presence.js';
+/** Minimal subset of ioredis used by {@link RedisPresence} (for testability). */
+export interface RedisLike {
+    zadd(key: string, score: number, member: string): Promise<unknown>;
+    zrem(key: string, member: string): Promise<unknown>;
+    zrangebyscore(key: string, min: number | string, max: number | string): Promise<string[]>;
+    zremrangebyscore(key: string, min: number | string, max: number | string): Promise<unknown>;
+    pexpire(key: string, ms: number): Promise<unknown>;
+}
+export interface RedisPresenceOptions {
+    ttlMs?: number;
+    now?: () => number;
+}
+/**
+ * Redis-backed presence using a per-subject sorted set `presence:{subject}` with
+ * member = nodeId and score = expiry epoch (now + ttl). This gives per-member
+ * TTL: a node's entry is considered live while its score is in the future and
+ * is refreshed by a heartbeat; stale entries are pruned on lookup. Eventually
+ * consistent by design (a crashed node's entry just expires).
+ */
+export declare class RedisPresence implements Presence {
+    private readonly redis;
+    private readonly opts;
+    constructor(redis: RedisLike, opts?: RedisPresenceOptions);
+    private ttl;
+    private now;
+    private key;
+    private authKey;
+    private addKey;
+    private lookupKey;
+    add(subject: string, nodeId: string): Promise<void>;
+    remove(subject: string, nodeId: string): Promise<void>;
+    lookup(subject: string): Promise<string[]>;
+    addAuthKey(authKeyId: string, nodeId: string): Promise<void>;
+    removeAuthKey(authKeyId: string, nodeId: string): Promise<void>;
+    lookupAuthKey(authKeyId: string): Promise<string[]>;
+}
+export interface RedisPresenceHandle {
+    presence: RedisPresence;
+    close: () => Promise<void>;
+}
+export declare function createRedisPresence(url: string, ttlMs: number): RedisPresenceHandle;
+//# sourceMappingURL=redis-presence.d.ts.map

package/dist/updates/redis-presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-presence.d.ts","sourceRoot":"","sources":["../../src/updates/redis-presence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACtB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAClE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACnD,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACzF,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3F,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACrD;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAEtC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE,oBAAyB;IAGpD,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,OAAO;YAID,MAAM;YAIN,SAAS;IAMjB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGnD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGtD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAG1C,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAG5D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAG/D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAG5D;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,aAAa,CAAA;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAQnF"}

package/dist/updates/redis-presence.js

@@ -0,0 +1,65 @@
+import Redis from 'ioredis';
+/**
+ * Redis-backed presence using a per-subject sorted set `presence:{subject}` with
+ * member = nodeId and score = expiry epoch (now + ttl). This gives per-member
+ * TTL: a node's entry is considered live while its score is in the future and
+ * is refreshed by a heartbeat; stale entries are pruned on lookup. Eventually
+ * consistent by design (a crashed node's entry just expires).
+ */
+export class RedisPresence {
+    redis;
+    opts;
+    constructor(redis, opts = {}) {
+        this.redis = redis;
+        this.opts = opts;
+    }
+    ttl() {
+        return this.opts.ttlMs ?? 60_000;
+    }
+    now() {
+        return (this.opts.now ?? Date.now)();
+    }
+    key(subject) {
+        return `presence:${subject}`;
+    }
+    authKey(authKeyId) {
+        return `presence:a:${authKeyId}`;
+    }
+    async addKey(key, nodeId) {
+        await this.redis.zadd(key, this.now() + this.ttl(), nodeId);
+        await this.redis.pexpire(key, this.ttl() * 2);
+    }
+    async lookupKey(key) {
+        const now = this.now();
+        await this.redis.zremrangebyscore(key, 0, now); // drop expired members
+        return this.redis.zrangebyscore(key, now, '+inf'); // live members
+    }
+    async add(subject, nodeId) {
+        await this.addKey(this.key(subject), nodeId);
+    }
+    async remove(subject, nodeId) {
+        await this.redis.zrem(this.key(subject), nodeId);
+    }
+    async lookup(subject) {
+        return this.lookupKey(this.key(subject));
+    }
+    async addAuthKey(authKeyId, nodeId) {
+        await this.addKey(this.authKey(authKeyId), nodeId);
+    }
+    async removeAuthKey(authKeyId, nodeId) {
+        await this.redis.zrem(this.authKey(authKeyId), nodeId);
+    }
+    async lookupAuthKey(authKeyId) {
+        return this.lookupKey(this.authKey(authKeyId));
+    }
+}
+export function createRedisPresence(url, ttlMs) {
+    const client = new Redis(url, { lazyConnect: false });
+    return {
+        presence: new RedisPresence(client, { ttlMs }),
+        close: async () => {
+            await client.quit();
+        },
+    };
+}
+//# sourceMappingURL=redis-presence.js.map

package/dist/updates/redis-presence.js.map

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

package/dist/updates/render.d.ts

@@ -0,0 +1,16 @@
+import type { LayeredRegistry } from '../tl/layered-registry.js';
+import type { TlObject } from '@mt-tl/tl';
+/**
+ * Renders a server update for a specific client layer.
+ *
+ * - Representable at the layer → unchanged.
+ * - Not representable but pts-bearing → `updateUnsupported{pts, pts_count}`
+ *   (preserves the pts accounting so the client resyncs via getDifference).
+ * - Not representable and ephemeral (no pts) → dropped (returns null).
+ *
+ * Recurses into the common containers (`updateShort`, `updates`,
+ * `updatesCombined`) so a single unrepresentable inner update doesn't sink the
+ * whole batch.
+ */
+export declare function renderUpdateForLayer(update: TlObject, layer: number, layered: LayeredRegistry): TlObject | null;
+//# sourceMappingURL=render.d.ts.map

package/dist/updates/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/updates/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEzC;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,GACzB,QAAQ,GAAG,IAAI,CAmBjB"}

package/dist/updates/render.js

@@ -0,0 +1,46 @@
+/**
+ * Renders a server update for a specific client layer.
+ *
+ * - Representable at the layer → unchanged.
+ * - Not representable but pts-bearing → `updateUnsupported{pts, pts_count}`
+ *   (preserves the pts accounting so the client resyncs via getDifference).
+ * - Not representable and ephemeral (no pts) → dropped (returns null).
+ *
+ * Recurses into the common containers (`updateShort`, `updates`,
+ * `updatesCombined`) so a single unrepresentable inner update doesn't sink the
+ * whole batch.
+ */
+export function renderUpdateForLayer(update, layer, layered) {
+    if (layered.representable(update, layer))
+        return update;
+    switch (update._) {
+        case 'updateShort': {
+            const inner = renderLeaf(update.update, layer, layered);
+            return inner ? { ...update, update: inner } : null;
+        }
+        case 'updates':
+        case 'updatesCombined': {
+            const list = Array.isArray(update.updates) ? update.updates : [];
+            const rendered = list
+                .map(u => renderLeaf(u, layer, layered))
+                .filter((u) => u !== null);
+            return { ...update, updates: rendered };
+        }
+        default:
+            return renderLeaf(update, layer, layered);
+    }
+}
+function renderLeaf(update, layer, layered) {
+    if (layered.representable(update, layer))
+        return update;
+    const pts = numberField(update, 'pts');
+    if (pts !== undefined) {
+        return { _: 'updateUnsupported', pts, pts_count: numberField(update, 'pts_count') ?? 0 };
+    }
+    return null; // ephemeral, no pts — safe to drop
+}
+function numberField(obj, key) {
+    const v = obj[key];
+    return typeof v === 'number' ? v : undefined;
+}
+//# sourceMappingURL=render.js.map

package/dist/updates/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/updates/render.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAChC,MAAgB,EAChB,KAAa,EACb,OAAwB;IAExB,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,MAAM,CAAA;IAEvD,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC;QACf,KAAK,aAAa,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,MAAkB,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;YACnE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;QACtD,CAAC;QACD,KAAK,SAAS,CAAC;QACf,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACrB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,MAAM,CAAC,OAAsB,CAAC,CAAC,CAAC,EAAE,CAAA;YAChF,MAAM,QAAQ,GAAG,IAAI;iBAChB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;iBACvC,MAAM,CAAC,CAAC,CAAC,EAAiB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;YAC7C,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;QAC3C,CAAC;QACD;YACI,OAAO,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,MAAgB,EAAE,KAAa,EAAE,OAAwB;IACzE,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,MAAM,CAAA;IACvD,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACtC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC,EAAE,mBAAmB,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAA;IAC5F,CAAC;IACD,OAAO,IAAI,CAAA,CAAC,mCAAmC;AACnD,CAAC;AAED,SAAS,WAAW,CAAC,GAAa,EAAE,GAAW;IAC3C,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;IAClB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAChD,CAAC"}

package/dist/updates/router.d.ts

@@ -0,0 +1,27 @@
+import type { JsonValue } from '@mt-tl/tl';
+import type { Presence } from './presence.js';
+import type { UpdateBus } from './update-bus.js';
+import type { UpdateMessage } from './types.js';
+export interface RouterOptions {
+    /**
+     * Anti-DDoS valve: return false to drop/coalesce an update under load.
+     * Safe to drop — clients recover via pts/getDifference. Default: deliver all.
+     */
+    shouldDeliver?: (subject: string, update: JsonValue) => boolean;
+    onError?: (err: unknown, msg: UpdateMessage) => void;
+}
+/**
+ * Presence-aware Update Router (standalone service, shard by subject in prod).
+ * Consumes worker updates, looks up which nodes hold the subject, and delivers
+ * only to those nodes — so 8 idle nodes never receive an update for a subject on
+ * node 1. This is the single place to throttle/coalesce per subject.
+ */
+export declare class UpdateRouter {
+    private readonly bus;
+    private readonly presence;
+    private readonly opts;
+    constructor(bus: UpdateBus, presence: Presence, opts?: RouterOptions);
+    start(): void;
+    private route;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/updates/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/updates/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAA;IAC/D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,KAAK,IAAI,CAAA;CACvD;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IAEjB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFJ,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,QAAQ,EAClB,IAAI,GAAE,aAAkB;IAG7C,KAAK,IAAI,IAAI;YAMC,KAAK;CAkBtB"}

package/dist/updates/router.js

@@ -0,0 +1,36 @@
+/**
+ * Presence-aware Update Router (standalone service, shard by subject in prod).
+ * Consumes worker updates, looks up which nodes hold the subject, and delivers
+ * only to those nodes — so 8 idle nodes never receive an update for a subject on
+ * node 1. This is the single place to throttle/coalesce per subject.
+ */
+export class UpdateRouter {
+    bus;
+    presence;
+    opts;
+    constructor(bus, presence, opts = {}) {
+        this.bus = bus;
+        this.presence = presence;
+        this.opts = opts;
+    }
+    start() {
+        this.bus.subscribeUpdates(msg => {
+            void this.route(msg).catch(err => this.opts.onError?.(err, msg));
+        });
+    }
+    async route(msg) {
+        // Auth-key-addressed delivery (anonymous connection); skips the per-user valve.
+        if (msg.authKeyId !== undefined) {
+            const nodes = await this.presence.lookupAuthKey(msg.authKeyId);
+            await Promise.all(nodes.map(nodeId => this.bus.publishToNode(nodeId, { authKeyId: msg.authKeyId, update: msg.update })));
+            return;
+        }
+        if (msg.subject === undefined)
+            return;
+        if (this.opts.shouldDeliver && !this.opts.shouldDeliver(msg.subject, msg.update))
+            return;
+        const nodes = await this.presence.lookup(msg.subject);
+        await Promise.all(nodes.map(nodeId => this.bus.publishToNode(nodeId, { subject: msg.subject, update: msg.update })));
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/updates/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/updates/router.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAEA;IACA;IACA;IAHrB,YACqB,GAAc,EACd,QAAkB,EAClB,OAAsB,EAAE;QAFxB,QAAG,GAAH,GAAG,CAAW;QACd,aAAQ,GAAR,QAAQ,CAAU;QAClB,SAAI,GAAJ,IAAI,CAAoB;IAC1C,CAAC;IAEJ,KAAK;QACD,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE;YAC5B,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;QACpE,CAAC,CAAC,CAAA;IACN,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,GAAkB;QAClC,gFAAgF;QAChF,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;YAC9D,MAAM,OAAO,CAAC,GAAG,CACb,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CACf,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CACnF,CACJ,CAAA;YACD,OAAM;QACV,CAAC;QACD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;YAAE,OAAM;QACrC,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC;YAAE,OAAM;QACxF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACrD,MAAM,OAAO,CAAC,GAAG,CACb,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CACpG,CAAA;IACL,CAAC;CACJ"}

package/dist/updates/types.d.ts

@@ -0,0 +1,23 @@
+import type { JsonValue } from '@mt-tl/tl';
+/**
+ * An update to deliver, addressed to exactly one target: a bound `subject` (the
+ * common case, pts-logged) OR an `authKeyId` (a specific, possibly anonymous,
+ * connection — e.g. pushing API to a not-yet-registered client; no pts). Set one.
+ */
+export interface UpdateMessage {
+    /** The subject (internal user id) to deliver to. */
+    subject?: string;
+    /** Decimal auth-key id, to address a specific (possibly anonymous) connection. */
+    authKeyId?: string;
+    /** A TL update object as tagged JSON ({ _: name, ... }). */
+    update: JsonValue;
+    /** Permanent-update sequence number (for getDifference recovery); opaque here. */
+    pts?: number;
+}
+/** A routed delivery from the Update Router to a specific gateway node. */
+export interface NodeDelivery {
+    subject?: string;
+    authKeyId?: string;
+    update: JsonValue;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/updates/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/updates/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,MAAM,EAAE,SAAS,CAAA;IACjB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAA;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,SAAS,CAAA;CACpB"}

package/dist/updates/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/updates/types.js.map

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

package/dist/updates/update-bus.d.ts

@@ -0,0 +1,29 @@
+import type { NodeDelivery, UpdateMessage } from './types.js';
+/**
+ * Message bus connecting publishers -> Update Router -> server nodes. Two impls:
+ * an in-memory one (single process) and a Redis pub/sub one (multi-instance:
+ * an `updates.in` channel for emissions and per-node `updates.node.{id}` channels
+ * for routed deliveries).
+ */
+export interface UpdateBus {
+    /** Publisher side: emit an update for a user. Fire-and-forget. */
+    publishUpdate(msg: UpdateMessage): Promise<void>;
+    /** Router side: receive all emitted updates. */
+    subscribeUpdates(handler: (msg: UpdateMessage) => void): void;
+    /** Router side: deliver a routed update to a specific node. */
+    publishToNode(nodeId: string, msg: NodeDelivery): Promise<void>;
+    /** Node side: receive deliveries addressed to this node. */
+    subscribeNode(nodeId: string, handler: (msg: NodeDelivery) => void): void;
+    close(): Promise<void>;
+}
+/** In-memory bus (single process / tests). */
+export declare class InMemoryUpdateBus implements UpdateBus {
+    private emitter;
+    constructor();
+    publishUpdate(msg: UpdateMessage): Promise<void>;
+    subscribeUpdates(handler: (msg: UpdateMessage) => void): void;
+    publishToNode(nodeId: string, msg: NodeDelivery): Promise<void>;
+    subscribeNode(nodeId: string, handler: (msg: NodeDelivery) => void): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=update-bus.d.ts.map

package/dist/updates/update-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-bus.d.ts","sourceRoot":"","sources":["../../src/updates/update-bus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACtB,kEAAkE;IAClE,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,gDAAgD;IAChD,gBAAgB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAAA;IAC7D,+DAA+D;IAC/D,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,4DAA4D;IAC5D,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAA;IACzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,8CAA8C;AAC9C,qBAAa,iBAAkB,YAAW,SAAS;IAC/C,OAAO,CAAC,OAAO,CAAqB;;IAM9B,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,gBAAgB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAIvD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAInE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/updates/update-bus.js

@@ -0,0 +1,24 @@
+import { EventEmitter } from 'node:events';
+/** In-memory bus (single process / tests). */
+export class InMemoryUpdateBus {
+    emitter = new EventEmitter();
+    constructor() {
+        this.emitter.setMaxListeners(0);
+    }
+    async publishUpdate(msg) {
+        this.emitter.emit('update', msg);
+    }
+    subscribeUpdates(handler) {
+        this.emitter.on('update', handler);
+    }
+    async publishToNode(nodeId, msg) {
+        this.emitter.emit(`node:${nodeId}`, msg);
+    }
+    subscribeNode(nodeId, handler) {
+        this.emitter.on(`node:${nodeId}`, handler);
+    }
+    async close() {
+        this.emitter.removeAllListeners();
+    }
+}
+//# sourceMappingURL=update-bus.js.map

package/dist/updates/update-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-bus.js","sourceRoot":"","sources":["../../src/updates/update-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAqB1C,8CAA8C;AAC9C,MAAM,OAAO,iBAAiB;IAClB,OAAO,GAAG,IAAI,YAAY,EAAE,CAAA;IAEpC;QACI,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;IACnC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAkB;QAClC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACpC,CAAC;IAED,gBAAgB,CAAC,OAAqC;QAClD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,GAAiB;QACjD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,MAAM,EAAE,EAAE,GAAG,CAAC,CAAA;IAC5C,CAAC;IAED,aAAa,CAAC,MAAc,EAAE,OAAoC;QAC9D,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,MAAM,EAAE,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAA;IACrC,CAAC;CACJ"}

package/dist/util/bytes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Pure-JS BigInt <-> Buffer helpers (little/big endian).
+ * Replaces the native `bigint-buffer` dependency so the gateway has no
+ * node-gyp build step. Values are treated as unsigned; this matches the
+ * existing server's `toBigIntLE`/`toBufferLE` usage for MTProto longs/ids.
+ */
+export declare function toBigIntLE(buf: Buffer): bigint;
+export declare function toBigIntBE(buf: Buffer): bigint;
+export declare function toBufferLE(value: bigint, length: number): Buffer;
+export declare function toBufferBE(value: bigint, length: number): Buffer;
+export declare function xorBuffers(a: Buffer, b: Buffer): Buffer;
+//# sourceMappingURL=bytes.d.ts.map

package/dist/util/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../src/util/bytes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQhE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQhE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvD"}

package/dist/util/bytes.js

@@ -0,0 +1,46 @@
+/**
+ * Pure-JS BigInt <-> Buffer helpers (little/big endian).
+ * Replaces the native `bigint-buffer` dependency so the gateway has no
+ * node-gyp build step. Values are treated as unsigned; this matches the
+ * existing server's `toBigIntLE`/`toBufferLE` usage for MTProto longs/ids.
+ */
+export function toBigIntLE(buf) {
+    let result = 0n;
+    for (let i = buf.length - 1; i >= 0; i--) {
+        result = (result << 8n) | BigInt(buf[i]);
+    }
+    return result;
+}
+export function toBigIntBE(buf) {
+    let result = 0n;
+    for (let i = 0; i < buf.length; i++) {
+        result = (result << 8n) | BigInt(buf[i]);
+    }
+    return result;
+}
+export function toBufferLE(value, length) {
+    const buf = Buffer.alloc(length);
+    let v = value;
+    for (let i = 0; i < length; i++) {
+        buf[i] = Number(v & 0xffn);
+        v >>= 8n;
+    }
+    return buf;
+}
+export function toBufferBE(value, length) {
+    const buf = Buffer.alloc(length);
+    let v = value;
+    for (let i = length - 1; i >= 0; i--) {
+        buf[i] = Number(v & 0xffn);
+        v >>= 8n;
+    }
+    return buf;
+}
+export function xorBuffers(a, b) {
+    const len = Math.min(a.length, b.length);
+    const res = Buffer.allocUnsafe(len);
+    for (let i = 0; i < len; i++)
+        res[i] = a[i] ^ b[i];
+    return res;
+}
+//# sourceMappingURL=bytes.js.map

package/dist/util/bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../../src/util/bytes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,UAAU,CAAC,GAAW;IAClC,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IAClC,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAc;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,GAAG,KAAK,CAAA;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAA;QAC1B,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;IACD,OAAO,GAAG,CAAA;AACd,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAc;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,GAAG,KAAK,CAAA;IACb,KAAK,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAA;QAC1B,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;IACD,OAAO,GAAG,CAAA;AACd,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;IACpD,OAAO,GAAG,CAAA;AACd,CAAC"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@mt-tl/server",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "An MTProto 2.0 server framework (Fastify-style): createServer, routes, plugins, hooks, server-push. Ships the full protocol engine — WebSocket/raw-TCP transport, handshake, AES-IGE crypto, sessions, TL (de)serialization, layered encoding — plus the handler layer, in one install.",
+  "license": "MIT",
+  "author": "Joe Beretta",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joeberetta/mt-tl.git",
+    "directory": "packages/server"
+  },
+  "homepage": "https://github.com/joeberetta/mt-tl/tree/master/packages/server#readme",
+  "bugs": "https://github.com/joeberetta/mt-tl/issues",
+  "keywords": [
+    "mtproto",
+    "telegram",
+    "server",
+    "framework",
+    "websocket",
+    "tcp",
+    "protocol",
+    "tl"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./testkit": {
+      "types": "./dist/testkit.d.ts",
+      "import": "./dist/testkit.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "prepack": "yarn run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      },
+      "./testkit": {
+        "types": "./dist/testkit.d.ts",
+        "import": "./dist/testkit.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "dependencies": {
+    "@mt-tl/tl": "0.1.0",
+    "crc-32": "^1.2.2",
+    "ioredis": "^5.4.1",
+    "mongodb": "^6.12.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@mt-tl/testing": "0.1.0",
+    "@types/node": "^20.14.0",
+    "@types/ws": "^8.5.12",
+    "demo-eos-seed-app": "0.1.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}