@mt-tl/tl 0.1.0

package/dist/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,OAAO,EAAE,MAAM,eAAe,CAAA;AAEtD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9D,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnE;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,WAAW,CAAqC;IAExD,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI;IAQzD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,0EAA0E;IAC1E,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAI9C,0DAA0D;IAC1D,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAK9C,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,UAAU;CAWrB"}

package/dist/migrate.js

@@ -0,0 +1,84 @@
+/**
+ * Per-predicate migration ladders. The gateway normalizes inbound values to the
+ * canonical (newest) shape (`up`) before forwarding, and renders canonical values
+ * down to a client's layer (`down`) before encoding — so workers only ever see
+ * the canonical shape. Scales to N versions: one rung per version; adding a
+ * version appends a rung and never touches the others.
+ *
+ * Only non-additively-changed predicates need a ladder; everything else is
+ * handled by decode-union + layered-encode with no rungs (identity here).
+ */
+export class MigrationRegistry {
+    byPredicate = new Map();
+    /** Register a predicate's ladder (rungs in any order; sorted by `since`). */
+    register(predicate, rungs) {
+        this.byPredicate.set(predicate, [...rungs].sort((a, b) => a.since - b.since));
+        return this;
+    }
+    has(predicate) {
+        return this.byPredicate.has(predicate);
+    }
+    get size() {
+        return this.byPredicate.size;
+    }
+    /** Normalize a value decoded at `fromLayer` up to the canonical shape. */
+    up(value, fromLayer) {
+        return this.recurse(value, obj => this.upObject(obj, fromLayer));
+    }
+    /** Render a canonical value down to `toLayer`'s shape. */
+    down(value, toLayer) {
+        return this.recurse(value, obj => this.downObject(obj, toLayer));
+    }
+    // Children-first walk: normalize nested objects, then transform the parent.
+    recurse(value, fn) {
+        if (Array.isArray(value))
+            return value.map(v => this.recurse(v, fn));
+        if (value && typeof value === 'object' && !Buffer.isBuffer(value) && '_' in value) {
+            const obj = value;
+            const next = { _: obj._ };
+            for (const [k, v] of Object.entries(obj)) {
+                if (k !== '_')
+                    next[k] = this.recurse(v, fn);
+            }
+            return fn(next);
+        }
+        return value;
+    }
+    upObject(obj, fromLayer) {
+        const rungs = this.byPredicate.get(obj._);
+        if (!rungs)
+            return obj;
+        let cur = obj;
+        for (let i = startRung(rungs, fromLayer); i <= rungs.length - 2; i++) {
+            const up = rungs[i].up;
+            if (up)
+                cur = up(cur);
+        }
+        return cur;
+    }
+    downObject(obj, toLayer) {
+        const rungs = this.byPredicate.get(obj._);
+        if (!rungs)
+            return obj;
+        const target = startRung(rungs, toLayer);
+        let cur = obj;
+        for (let i = rungs.length - 2; i >= target; i--) {
+            const down = rungs[i].down;
+            if (down)
+                cur = down(cur);
+        }
+        return cur;
+    }
+}
+/** Index of the rung active at `layer` (the latest with since <= layer; else 0). */
+function startRung(rungs, layer) {
+    let idx = 0;
+    for (let i = 0; i < rungs.length; i++) {
+        if (rungs[i].since <= layer)
+            idx = i;
+        else
+            break;
+    }
+    return idx;
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

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

package/dist/rpc.d.ts

@@ -0,0 +1,74 @@
+import type { JsonValue } from './tl/value.js';
+/** Per-request connection context the engine attaches to every business call; surfaced as `ctx.request`. */
+export interface RpcContext {
+    /** The MTProto session id (hex). */
+    sessionId: string;
+    /** The connection's auth key id (hex). */
+    authKeyId: string;
+    /**
+     * The **subject** bound to this auth key — your app's *internal* user id,
+     * opaque to the framework and safe to share across your services (e.g. a
+     * uuid). Set it via `ctx.login(subject)`; `undefined` for an anonymous key.
+     *
+     * This is deliberately NOT the wire `user_id` your TL schema exposes to
+     * clients (Telegram-style `int`/`long`). The framework only routes/persists
+     * by `subject`; mapping `subject ⇄ public user_id` is your app's job (see the
+     * demo's `users` module). Keeping them separate lets the public id stay an
+     * `int` while the protocol runs entirely on your internal id.
+     */
+    subject?: string;
+    /** The client's negotiated TL layer. */
+    apiLayer: number;
+    /** `initConnection.api_id` — the client app id, if reported. */
+    apiId?: number;
+    /** `initConnection.device_model`, if reported. */
+    deviceModel?: string;
+    /** `initConnection.system_version`, if reported. */
+    systemVersion?: string;
+    /** `initConnection.app_version`, if reported. */
+    appVersion?: string;
+    /** `initConnection.lang_code`, if reported. */
+    langCode?: string;
+    /** Client IP (from the carrier / `X-Forwarded-For`), if known. */
+    ip?: string;
+}
+/** A decoded business method call handed to the handler layer. */
+export interface RpcRequest {
+    /** Derived from the client's reqMsgId. */
+    id: string;
+    /** TL method name, e.g. "dust.getConfig". */
+    method: string;
+    /** Decoded params as tagged JSON (bigint -> {$bigint}, Buffer -> {$bin}). */
+    params: JsonValue;
+    /** The connection context (see {@link RpcContext}). */
+    context: RpcContext;
+}
+/**
+ * A side-effect a handler records (via `ctx.login`/`logout`/`revoke`) for the
+ * engine to apply to auth-key state, returned alongside the normal result/error.
+ * Keeps the engine agnostic to your auth scheme: a `signIn` handler returns
+ * `bindUser`, and the engine binds the `subject` (your internal user id) to the
+ * auth key.
+ */
+export type SessionEffect = {
+    type: 'bindUser';
+    subject: string;
+} | {
+    type: 'unbindUser';
+} | {
+    type: 'revokeKey';
+};
+/**
+ * Response envelope (transport-agnostic). Exactly one of `result` / `error` is
+ * set; `effects` may accompany either.
+ */
+export interface RpcResponse {
+    /** A TL result as tagged JSON ({ _: name, ... }, $bigint/$bin), or a primitive. */
+    result?: JsonValue;
+    error?: {
+        code: number;
+        message: string;
+    };
+    effects?: SessionEffect[];
+}
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,4GAA4G;AAC5G,MAAM,WAAW,UAAU;IACvB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,CAAA;CACd;AAED,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACvB,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAA;IACV,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,MAAM,EAAE,SAAS,CAAA;IACjB,uDAAuD;IACvD,OAAO,EAAE,UAAU,CAAA;CACtB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAA;AAE3B;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,mFAAmF;IACnF,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IACzC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;CAC5B"}

package/dist/rpc.js

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

package/dist/rpc.js.map

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

package/dist/tl/crc32.d.ts

@@ -0,0 +1,2 @@
+export declare function getTlObjectCrc32(line: string): string;
+//# sourceMappingURL=crc32.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crc32.d.ts","sourceRoot":"","sources":["../../src/tl/crc32.ts"],"names":[],"mappings":"AAuCA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD"}

package/dist/tl/crc32.js

@@ -0,0 +1,42 @@
+import CRC32 from 'crc-32';
+/**
+ * Computes a TL constructor id (crc32 of the normalized definition line),
+ * mirroring the existing backend's `get-tl-object-crc32.js` exactly so our
+ * validation agrees with the schema's declared ids.
+ *
+ * Normalization (applied repeatedly until stable):
+ *   :bytes              -> :string
+ *   ?bytes              -> ?string
+ *   #<hex>              -> (constructor id removed)
+ *   name:flags.N?true   -> (removed; presence-only flags don't affect the id)
+ *   < > and {} and ;    -> stripped / spaced
+ *   collapse double / edge spaces
+ */
+function normalizeSchemaLine(line) {
+    const rules = [
+        [/:bytes /g, ':string '],
+        [/\?bytes /g, '?string '],
+        [/#[a-f0-9]+ /g, ' '],
+        [/ [a-zA-Z0-9_]+:flags\.[0-9]+\?true/g, ''],
+        [/</g, ' '],
+        [/>/g, ' '],
+        [/;/g, ''],
+        [/\{/g, ''],
+        [/\}/g, ''],
+    ];
+    let out = line;
+    let prev;
+    do {
+        prev = out;
+        for (const [re, to] of rules)
+            out = out.replace(re, to);
+        out = out.replace(/ {2}/g, ' ').replace(/^ /, '').replace(/ $/, '');
+    } while (out !== prev);
+    return out;
+}
+export function getTlObjectCrc32(line) {
+    const hashNum = CRC32.bstr(normalizeSchemaLine(line));
+    const unsigned = hashNum < 0 ? hashNum + 0x100000000 : hashNum;
+    return unsigned.toString(16).padStart(8, '0');
+}
+//# sourceMappingURL=crc32.js.map

package/dist/tl/crc32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc32.js","sourceRoot":"","sources":["../../src/tl/crc32.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,QAAQ,CAAA;AAE1B;;;;;;;;;;;;GAYG;AACH,SAAS,mBAAmB,CAAC,IAAY;IACrC,MAAM,KAAK,GAA4B;QACnC,CAAC,UAAU,EAAE,UAAU,CAAC;QACxB,CAAC,WAAW,EAAE,UAAU,CAAC;QACzB,CAAC,cAAc,EAAE,GAAG,CAAC;QACrB,CAAC,qCAAqC,EAAE,EAAE,CAAC;QAC3C,CAAC,IAAI,EAAE,GAAG,CAAC;QACX,CAAC,IAAI,EAAE,GAAG,CAAC;QACX,CAAC,IAAI,EAAE,EAAE,CAAC;QACV,CAAC,KAAK,EAAE,EAAE,CAAC;QACX,CAAC,KAAK,EAAE,EAAE,CAAC;KACd,CAAA;IAED,IAAI,GAAG,GAAG,IAAI,CAAA;IACd,IAAI,IAAY,CAAA;IAChB,GAAG,CAAC;QACA,IAAI,GAAG,GAAG,CAAA;QACV,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK;YAAE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QACvD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACvE,CAAC,QAAQ,GAAG,KAAK,IAAI,EAAC;IAEtB,OAAO,GAAG,CAAA;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAA;IACrD,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAA;IAC9D,OAAO,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AACjD,CAAC"}

package/dist/tl/ir.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Intermediate representation (IR) for the TL schema.
+ *
+ * A `.tl` file is parsed into a flat list of {@link TlDef} (constructors and
+ * methods). Each parameter's textual type is parsed once, at load time, into a
+ * structured {@link TlType} so the generic codec can walk it without re-parsing
+ * strings on every (de)serialization.
+ */
+export type TlType = {
+    kind: 'int';
+} | {
+    kind: 'long';
+} | {
+    kind: 'double';
+} | {
+    kind: 'string';
+} | {
+    kind: 'bytes';
+} | {
+    kind: 'int128';
+} | {
+    kind: 'int256';
+} | {
+    kind: 'bool';
+} | {
+    kind: 'true';
+} | {
+    kind: 'flags';
+} | {
+    kind: 'flag';
+    flagsField: string;
+    bit: number;
+    inner: TlType;
+} | {
+    kind: 'vector';
+    boxed: boolean;
+    inner: TlType;
+} | {
+    kind: 'object';
+} | {
+    kind: 'boxed';
+    name: string;
+} | {
+    kind: 'bare';
+    name: string;
+};
+export interface TlParam {
+    name: string;
+    /** Original textual type, kept for diagnostics / crc. */
+    raw: string;
+    type: TlType;
+}
+export interface TlDef {
+    /** 8-char lowercase hex constructor id. */
+    id: string;
+    /** Unsigned 32-bit numeric form of {@link id}. */
+    idNum: number;
+    /** predicate (constructor) or method name, e.g. `dust.getConfig`. */
+    name: string;
+    kind: 'constructor' | 'method';
+    params: TlParam[];
+    /** Boxed result/return type, e.g. `dust.CalculatedExchange`. */
+    type: string;
+    /** True for the immutable MTProto protocol layer (scheme_0_protocol + core). */
+    isProtocol: boolean;
+}
+export declare function parseType(raw: string): TlType;
+//# sourceMappingURL=ir.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../../src/tl/ir.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,MAAM,GACZ;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpC,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,KAAK;IAClB,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAA;IACV,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,aAAa,GAAG,QAAQ,CAAA;IAC9B,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,UAAU,EAAE,OAAO,CAAA;CACtB;AAID,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsD7C"}

package/dist/tl/ir.js

@@ -0,0 +1,63 @@
+/**
+ * Intermediate representation (IR) for the TL schema.
+ *
+ * A `.tl` file is parsed into a flat list of {@link TlDef} (constructors and
+ * methods). Each parameter's textual type is parsed once, at load time, into a
+ * structured {@link TlType} so the generic codec can walk it without re-parsing
+ * strings on every (de)serialization.
+ */
+const PRIMITIVES = new Set(['int', 'long', 'double', 'string', 'bytes', 'int128', 'int256', 'Bool', 'true']);
+export function parseType(raw) {
+    const t = raw.trim();
+    if (t === '#')
+        return { kind: 'flags' };
+    // conditional field: <flagsField>.<bit>?<inner>, e.g. api_hash:flags.1?string
+    const cond = t.match(/^(\w+)\.(\d+)\?(.+)$/);
+    if (cond) {
+        return {
+            kind: 'flag',
+            flagsField: cond[1],
+            bit: Number(cond[2]),
+            inner: parseType(cond[3]),
+        };
+    }
+    // Vector<T> (boxed) or vector<T> (bare)
+    const vec = t.match(/^([Vv])ector<(.+)>$/);
+    if (vec) {
+        return { kind: 'vector', boxed: vec[1] === 'V', inner: parseType(vec[2]) };
+    }
+    if (PRIMITIVES.has(t)) {
+        switch (t) {
+            case 'int':
+                return { kind: 'int' };
+            case 'long':
+                return { kind: 'long' };
+            case 'double':
+                return { kind: 'double' };
+            case 'string':
+                return { kind: 'string' };
+            case 'bytes':
+                return { kind: 'bytes' };
+            case 'int128':
+                return { kind: 'int128' };
+            case 'int256':
+                return { kind: 'int256' };
+            case 'Bool':
+                return { kind: 'bool' };
+            case 'true':
+                return { kind: 'true' };
+        }
+    }
+    if (t === 'Object' || t === 'X' || t.startsWith('!'))
+        return { kind: 'object' };
+    if (t.startsWith('%'))
+        return { kind: 'bare', name: t.slice(1) };
+    // Named type. Boxed iff the final segment is capitalized (e.g. dust.DustBalance,
+    // Currency); otherwise a bare constructor reference (e.g. future_salt).
+    const lastSeg = t.includes('.') ? t.slice(t.lastIndexOf('.') + 1) : t;
+    const first = lastSeg[0] ?? '';
+    if (first >= 'A' && first <= 'Z')
+        return { kind: 'boxed', name: t };
+    return { kind: 'bare', name: t };
+}
+//# sourceMappingURL=ir.js.map

package/dist/tl/ir.js.map

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

package/dist/tl/parser.d.ts

@@ -0,0 +1,22 @@
+import type { TlDef } from './ir.js';
+export interface ParsedLine {
+    def: TlDef;
+    /** declared id differs from the crc32 of the normalized line */
+    crcMismatch: boolean;
+}
+export interface ParseResult {
+    defs: TlDef[];
+    crcMismatches: Array<{
+        name: string;
+        id: string;
+        computed: string;
+    }>;
+}
+export declare function parseTlText(text: string, isProtocol: boolean): ParseResult;
+/**
+ * Loads every `*.tl` file from a directory into the IR. `scheme_0_protocol.tl`
+ * is flagged as protocol; the manually-parsed MTProto core constructors are
+ * merged in. Duplicate constructor ids are de-duplicated (first wins).
+ */
+export declare function parseSchemaDir(dir: string): ParseResult;
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/tl/parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAW,MAAM,SAAS,CAAA;AAmC7C,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,KAAK,CAAA;IACV,gEAAgE;IAChE,WAAW,EAAE,OAAO,CAAA;CACvB;AAyBD,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,KAAK,EAAE,CAAA;IACb,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,WAAW,CA6B1E;AAUD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CA4BvD"}

package/dist/tl/parser.js

@@ -0,0 +1,122 @@
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseType } from './ir.js';
+import { getTlObjectCrc32 } from './crc32.js';
+const LINE_RE = /^([\w.]+)#([0-9a-fA-F]+)\s*(.*?)\s*=\s*([\w.]+)\s*;\s*$/;
+/**
+ * Core MTProto constructors that scheme_0_protocol.tl leaves commented out
+ * ("parsed manually"). They still need registry entries for id<->name lookup.
+ */
+const CORE_LINES = [
+    { kind: 'constructor', line: 'vector#1cb5c415 = Vector;' },
+    { kind: 'constructor', line: 'rpc_result#f35c6d01 req_msg_id:long result:Object = RpcResult;' },
+    { kind: 'constructor', line: 'msg_container#73f1f8dc messages:vector<%Message> = MessageContainer;' },
+    {
+        kind: 'constructor',
+        line: 'message#5bb8e511 msg_id:long seqno:int bytes:int body:Object = Message;',
+    },
+    { kind: 'constructor', line: 'msg_copy#e06046b2 orig_message:Message = MessageCopy;' },
+    { kind: 'constructor', line: 'gzip_packed#3072cfa1 packed_data:bytes = Object;' },
+];
+function parseParams(paramsStr) {
+    if (!paramsStr)
+        return [];
+    return paramsStr
+        .split(/\s+/)
+        .filter(tok => tok.includes(':') && !tok.includes('{') && !tok.includes('}'))
+        .map(tok => {
+        const idx = tok.indexOf(':');
+        const name = tok.slice(0, idx);
+        const raw = tok.slice(idx + 1);
+        return { name, raw, type: parseType(raw) };
+    });
+}
+function parseLine(line, kind, isProtocol, validateCrc) {
+    const m = line.match(LINE_RE);
+    if (!m)
+        return null;
+    const [, name, hashRaw, paramsStr, type] = m;
+    const id = hashRaw.toLowerCase().padStart(8, '0');
+    const def = {
+        id,
+        idNum: parseInt(id, 16) >>> 0,
+        name: name,
+        kind,
+        params: parseParams(paramsStr ?? ''),
+        type: type,
+        isProtocol,
+    };
+    const crcMismatch = validateCrc ? getTlObjectCrc32(line.trim()) !== id : false;
+    return { def, crcMismatch };
+}
+export function parseTlText(text, isProtocol) {
+    const defs = [];
+    const crcMismatches = [];
+    let kind = 'constructor';
+    for (const rawLine of text.split('\n')) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('//') || line.startsWith('*') || line.startsWith('/*'))
+            continue;
+        if (line.includes('---types---')) {
+            kind = 'constructor';
+            continue;
+        }
+        if (line.includes('---functions---')) {
+            kind = 'method';
+            continue;
+        }
+        const parsed = parseLine(line, kind, isProtocol, true);
+        if (!parsed)
+            continue;
+        defs.push(parsed.def);
+        if (parsed.crcMismatch) {
+            crcMismatches.push({
+                name: parsed.def.name,
+                id: parsed.def.id,
+                computed: getTlObjectCrc32(line),
+            });
+        }
+    }
+    return { defs, crcMismatches };
+}
+function parseCoreLines() {
+    return CORE_LINES.map(({ kind, line }) => {
+        const parsed = parseLine(line, kind, true, false);
+        if (!parsed)
+            throw new Error(`Failed to parse core line: ${line}`);
+        return parsed.def;
+    });
+}
+/**
+ * Loads every `*.tl` file from a directory into the IR. `scheme_0_protocol.tl`
+ * is flagged as protocol; the manually-parsed MTProto core constructors are
+ * merged in. Duplicate constructor ids are de-duplicated (first wins).
+ */
+export function parseSchemaDir(dir) {
+    const files = readdirSync(dir)
+        .filter(f => f.endsWith('.tl'))
+        .sort();
+    const seen = new Set();
+    const defs = [];
+    const crcMismatches = [];
+    for (const def of parseCoreLines()) {
+        if (seen.has(def.id))
+            continue;
+        seen.add(def.id);
+        defs.push(def);
+    }
+    for (const file of files) {
+        const isProtocol = file === 'scheme_0_protocol.tl';
+        const text = readFileSync(join(dir, file), 'utf-8');
+        const res = parseTlText(text, isProtocol);
+        crcMismatches.push(...res.crcMismatches);
+        for (const def of res.defs) {
+            if (seen.has(def.id))
+                continue;
+            seen.add(def.id);
+            defs.push(def);
+        }
+    }
+    return { defs, crcMismatches };
+}
+//# sourceMappingURL=parser.js.map

package/dist/tl/parser.js.map

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

package/dist/tl/value.d.ts

@@ -0,0 +1,26 @@
+/**
+ * In-code representation of a decoded TL value.
+ *
+ * A constructed type is a tagged plain object `{ _: 'predicate.name', ...fields }`
+ * (matching the existing `toPrimitiveObject` convention). Wire primitives map to:
+ *   int -> number, long/flags -> bigint|number, double -> number, string -> string,
+ *   bytes/int128/int256 -> Buffer, Bool/true -> boolean, vector -> array.
+ */
+export type TlValue = number | bigint | boolean | string | Buffer | TlObject | TlValue[] | null | undefined;
+export interface TlObject {
+    _: string;
+    [field: string]: TlValue;
+}
+/** JSON-safe encoding so values can cross the JSON-RPC boundary. */
+export type JsonValue = number | boolean | string | null | {
+    $bigint: string;
+} | {
+    $bin: string;
+} | JsonValue[] | {
+    [k: string]: JsonValue;
+};
+export declare function toJson(value: TlValue): JsonValue;
+export declare function fromJson(value: JsonValue): TlValue;
+/** Pretty JSON string for terminal logging (bigint/Buffer made readable). */
+export declare function stringify(value: TlValue, indent?: number): string;
+//# sourceMappingURL=value.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../src/tl/value.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAA;AAE3G,MAAM,WAAW,QAAQ;IACrB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B;AAED,oEAAoE;AACpE,MAAM,MAAM,SAAS,GACf,MAAM,GACN,OAAO,GACP,MAAM,GACN,IAAI,GACJ;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB,SAAS,EAAE,GACX;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAMhC,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAUhD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAYlD;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAI,GAAG,MAAM,CAE5D"}

package/dist/tl/value.js

@@ -0,0 +1,44 @@
+function isBuffer(v) {
+    return Buffer.isBuffer(v);
+}
+export function toJson(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === 'bigint')
+        return { $bigint: value.toString() };
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'string')
+        return value;
+    if (isBuffer(value))
+        return { $bin: value.toString('base64') };
+    if (Array.isArray(value))
+        return value.map(toJson);
+    // TlObject
+    const out = {};
+    for (const [k, v] of Object.entries(value))
+        out[k] = toJson(v);
+    return out;
+}
+export function fromJson(value) {
+    if (value === null)
+        return null;
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'string')
+        return value;
+    if (Array.isArray(value))
+        return value.map(fromJson);
+    if (typeof value === 'object') {
+        if ('$bigint' in value && typeof value.$bigint === 'string')
+            return BigInt(value.$bigint);
+        if ('$bin' in value && typeof value.$bin === 'string')
+            return Buffer.from(value.$bin, 'base64');
+        const out = {};
+        for (const [k, v] of Object.entries(value))
+            out[k] = fromJson(v);
+        return out;
+    }
+    return null;
+}
+/** Pretty JSON string for terminal logging (bigint/Buffer made readable). */
+export function stringify(value, indent = 2) {
+    return JSON.stringify(toJson(value), null, indent);
+}
+//# sourceMappingURL=value.js.map

package/dist/tl/value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.js","sourceRoot":"","sources":["../../src/tl/value.ts"],"names":[],"mappings":"AA0BA,SAAS,QAAQ,CAAC,CAAU;IACxB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAc;IACjC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAA;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACtG,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAA;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClD,WAAW;IACX,MAAM,GAAG,GAA+B,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAY,CAAC,CAAA;IACzE,OAAO,GAAG,CAAA;AACd,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAgB;IACrC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACtG,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACzF,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC/F,MAAM,GAAG,GAA6B,EAAE,CAAA;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAc,CAAC,CAAA;QAC7E,OAAO,GAAe,CAAA;IAC1B,CAAC;IACD,OAAO,IAAI,CAAA;AACf,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,MAAM,GAAG,CAAC;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACtD,CAAC"}

package/dist/tools/freeze-layer.d.ts

@@ -0,0 +1,26 @@
+export interface FreezeResult {
+    constructors: number;
+    methods: number;
+    /** Path of the JSON snapshot the gateway loads. */
+    out: string;
+    /** Path of the human-readable `.tl` mirror (not loaded; for inspection/diffs). */
+    tlOut: string;
+    crcWarnings: number;
+}
+/**
+ * Freezes the `.tl` schema in `schemaDir` into a per-layer snapshot
+ * `<outDir>/scheme_<layer>.json` (loaded by the gateway) plus a human-readable
+ * `<outDir>/scheme_<layer>.tl` mirror (for inspection/diffs; not loaded). Run
+ * this when you SHIP a layer: the `.tl` you edit is the in-progress newest layer;
+ * the frozen snapshot is the historical record the gateway uses to encode for
+ * clients on that layer.
+ *
+ * The snapshot is BUSINESS-only: the immutable MTProto protocol/core types are
+ * excluded (they live in @mt-tl/tl and are loaded globally), so a business
+ * layer never carries protocol definitions.
+ *
+ * Schema ownership lives in the consumer app, so paths are explicit — apps wrap
+ * this in their own `freeze` script.
+ */
+export declare function freezeLayer(schemaDir: string, outDir: string, layer: number): FreezeResult;
+//# sourceMappingURL=freeze-layer.d.ts.map