zapo-js 0.2.0 → 1.0.0

package/dist/esm/transport/node/builders/prekeys.js

@@ -1,7 +1,8 @@
-import { WA_DEFAULTS, WA_NODE_TAGS, WA_XMLNS } from '../../../protocol/constants.js';
+import { toRawPubKey } from '../../../crypto/core/keys.js';
+import { WA_DEFAULTS, WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from '../../../protocol/constants.js';
 import { SIGNAL_KEY_BUNDLE_TYPE_BYTES } from '../../../signal/api/constants.js';
 import { buildIqNode } from '../../node/query.js';
-import { intToBytes, toBytesView } from '../../../util/bytes.js';
+import { intToBytes } from '../../../util/bytes.js';
 function buildSignedPreKeyNode(signedPreKey) {
     return {
         tag: WA_NODE_TAGS.SKEY,
@@ -15,58 +16,54 @@ function buildSignedPreKeyNode(signedPreKey) {
             {
                 tag: WA_NODE_TAGS.VALUE,
                 attrs: {},
-                content: toBytesView(signedPreKey.keyPair.pubKey)
+                content: toRawPubKey(signedPreKey.keyPair.pubKey)
             },
             {
                 tag: WA_NODE_TAGS.SIGNATURE,
                 attrs: {},
-                content: toBytesView(signedPreKey.signature)
+                content: signedPreKey.signature
             }
         ]
     };
 }
 export function buildPreKeyUploadIq(registrationInfo, signedPreKey, preKeys) {
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.SIGNAL, [
-        {
-            tag: WA_NODE_TAGS.REGISTRATION,
-            attrs: {},
-            content: intToBytes(4, registrationInfo.registrationId)
-        },
-        {
-            tag: WA_NODE_TAGS.TYPE,
-            attrs: {},
-            content: SIGNAL_KEY_BUNDLE_TYPE_BYTES
-        },
-        {
-            tag: WA_NODE_TAGS.IDENTITY,
-            attrs: {},
-            content: toBytesView(registrationInfo.identityKeyPair.pubKey)
-        },
-        {
-            tag: WA_NODE_TAGS.LIST,
+    const children = [];
+    children.push({
+        tag: WA_NODE_TAGS.IDENTITY,
+        attrs: {},
+        content: toRawPubKey(registrationInfo.identityKeyPair.pubKey)
+    }, {
+        tag: WA_NODE_TAGS.REGISTRATION,
+        attrs: {},
+        content: intToBytes(4, registrationInfo.registrationId)
+    }, {
+        tag: WA_NODE_TAGS.TYPE,
+        attrs: {},
+        content: SIGNAL_KEY_BUNDLE_TYPE_BYTES
+    }, {
+        tag: WA_NODE_TAGS.LIST,
+        attrs: {},
+        content: preKeys.map((record) => ({
+            tag: WA_NODE_TAGS.KEY,
             attrs: {},
-            content: preKeys.map((record) => ({
-                tag: WA_NODE_TAGS.KEY,
-                attrs: {},
-                content: [
-                    {
-                        tag: WA_NODE_TAGS.ID,
-                        attrs: {},
-                        content: intToBytes(3, record.keyId)
-                    },
-                    {
-                        tag: WA_NODE_TAGS.VALUE,
-                        attrs: {},
-                        content: toBytesView(record.keyPair.pubKey)
-                    }
-                ]
-            }))
-        },
-        buildSignedPreKeyNode(signedPreKey)
-    ]);
+            content: [
+                {
+                    tag: WA_NODE_TAGS.ID,
+                    attrs: {},
+                    content: intToBytes(3, record.keyId)
+                },
+                {
+                    tag: WA_NODE_TAGS.VALUE,
+                    attrs: {},
+                    content: toRawPubKey(record.keyPair.pubKey)
+                }
+            ]
+        }))
+    }, buildSignedPreKeyNode(signedPreKey));
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.SIGNAL, children);
 }
 export function buildSignedPreKeyRotateIq(signedPreKey) {
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.SIGNAL, [
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.SIGNAL, [
         {
             tag: WA_NODE_TAGS.ROTATE,
             attrs: {},
@@ -75,7 +72,7 @@ export function buildSignedPreKeyRotateIq(signedPreKey) {
     ]);
 }
 export function buildMissingPreKeysFetchIq(users) {
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.SIGNAL, [
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.SIGNAL, [
         {
             tag: WA_NODE_TAGS.KEY_FETCH,
             attrs: {},

package/dist/esm/transport/node/builders/presence.js

@@ -0,0 +1,39 @@
+import { isBroadcastJid, isNewsletterJid, splitJid } from '../../../protocol/jid.js';
+import { WA_NODE_TAGS } from '../../../protocol/nodes.js';
+import { WA_PRESENCE_TYPES } from '../../../protocol/presence.js';
+export function buildPresenceNode(input) {
+    const attrs = {};
+    if (input?.type) {
+        attrs.type = input.type;
+    }
+    if (input?.name) {
+        attrs.name = input.name;
+    }
+    return {
+        tag: WA_NODE_TAGS.PRESENCE,
+        attrs
+    };
+}
+function assertSubscribeJid(jid) {
+    if (isNewsletterJid(jid) || isBroadcastJid(jid)) {
+        throw new Error(`presence subscribe is not supported for jid: ${jid}`);
+    }
+    splitJid(jid);
+}
+export function buildPresenceSubscribeNode(input) {
+    assertSubscribeJid(input.jid);
+    const attrs = {
+        type: WA_PRESENCE_TYPES.SUBSCRIBE,
+        to: input.jid
+    };
+    if (input.name !== undefined) {
+        attrs.name = input.name;
+    }
+    if (input.context !== undefined) {
+        attrs.context = input.context;
+    }
+    return {
+        tag: WA_NODE_TAGS.PRESENCE,
+        attrs
+    };
+}

package/dist/esm/transport/node/builders/privacy-token.js

@@ -1,29 +1,25 @@
-import { WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from '../../../protocol/nodes.js';
+import { WA_DEFAULTS } from '../../../protocol/defaults.js';
+import { toUserJid } from '../../../protocol/jid.js';
+import { WA_IQ_TYPES, WA_XMLNS } from '../../../protocol/nodes.js';
 import { WA_PRIVACY_TOKEN_TAGS, WA_PRIVACY_TOKEN_TYPES } from '../../../protocol/privacy-token.js';
+import { buildIqNode } from '../../node/query.js';
 export function buildPrivacyTokenIqNode(input) {
-    return {
-        tag: WA_NODE_TAGS.IQ,
-        attrs: {
-            type: WA_IQ_TYPES.SET,
-            xmlns: WA_XMLNS.PRIVACY
-        },
-        content: [
-            {
-                tag: WA_PRIVACY_TOKEN_TAGS.TOKENS,
-                attrs: {},
-                content: [
-                    {
-                        tag: WA_PRIVACY_TOKEN_TAGS.TOKEN,
-                        attrs: {
-                            jid: input.jid,
-                            t: String(input.timestampS),
-                            type: input.type ?? WA_PRIVACY_TOKEN_TYPES.TRUSTED_CONTACT
-                        }
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PRIVACY, [
+        {
+            tag: WA_PRIVACY_TOKEN_TAGS.TOKENS,
+            attrs: {},
+            content: [
+                {
+                    tag: WA_PRIVACY_TOKEN_TAGS.TOKEN,
+                    attrs: {
+                        jid: toUserJid(input.jid),
+                        t: String(input.timestampS),
+                        type: input.type ?? WA_PRIVACY_TOKEN_TYPES.TRUSTED_CONTACT
                     }
-                ]
-            }
-        ]
-    };
+                }
+            ]
+        }
+    ]);
 }
 export function buildTcTokenMessageNode(token) {
     return {

package/dist/esm/transport/node/builders/privacy.js

@@ -1,14 +1,14 @@
 import { WA_DEFAULTS } from '../../../protocol/defaults.js';
-import { WA_NODE_TAGS, WA_XMLNS } from '../../../protocol/nodes.js';
+import { WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from '../../../protocol/nodes.js';
 import { WA_PRIVACY_TAGS } from '../../../protocol/privacy.js';
 import { buildIqNode } from '../../node/query.js';
 export function buildGetPrivacySettingsIq() {
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PRIVACY, [
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PRIVACY, [
         { tag: WA_NODE_TAGS.PRIVACY, attrs: {} }
     ]);
 }
 export function buildSetPrivacyCategoryIq(category, value) {
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PRIVACY, [
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PRIVACY, [
         {
             tag: WA_NODE_TAGS.PRIVACY,
             attrs: {},
@@ -22,7 +22,7 @@ export function buildSetPrivacyCategoryIq(category, value) {
     ]);
 }
 export function buildGetPrivacyDisallowedListIq(category) {
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PRIVACY, [
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PRIVACY, [
         {
             tag: WA_NODE_TAGS.PRIVACY,
             attrs: {},
@@ -36,10 +36,10 @@ export function buildGetPrivacyDisallowedListIq(category) {
     ]);
 }
 export function buildGetBlocklistIq() {
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BLOCKLIST);
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BLOCKLIST);
 }
 export function buildBlocklistChangeIq(jid, action) {
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BLOCKLIST, [
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BLOCKLIST, [
         {
             tag: 'item',
             attrs: { jid, action }

package/dist/esm/transport/node/builders/profile.js

@@ -1,4 +1,4 @@
-import { WA_DEFAULTS, WA_NODE_TAGS, WA_XMLNS } from '../../../protocol/constants.js';
+import { WA_DEFAULTS, WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from '../../../protocol/constants.js';
 import { buildIqNode } from '../../node/query.js';
 export function buildGetProfilePictureIq(targetJid, type = 'preview', existingId) {
     const pictureAttrs = {
@@ -8,7 +8,7 @@ export function buildGetProfilePictureIq(targetJid, type = 'preview', existingId
     if (existingId) {
         pictureAttrs.id = existingId;
     }
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PROFILE_PICTURE, [
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PROFILE_PICTURE, [
         {
             tag: WA_NODE_TAGS.PICTURE,
             attrs: pictureAttrs
@@ -22,7 +22,7 @@ export function buildSetProfilePictureIq(imageBytes, targetJid) {
     if (targetJid) {
         attrs.target = targetJid;
     }
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PROFILE_PICTURE, [
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PROFILE_PICTURE, [
         {
             tag: WA_NODE_TAGS.PICTURE,
             attrs: { type: 'image' },
@@ -35,12 +35,12 @@ export function buildDeleteProfilePictureIq(targetJid) {
     if (targetJid) {
         attrs.target = targetJid;
     }
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PROFILE_PICTURE, undefined, attrs);
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PROFILE_PICTURE, undefined, attrs);
 }
 export function buildSetStatusIq(text) {
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.STATUS, [
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.STATUS, [
         {
-            tag: 'status',
+            tag: WA_NODE_TAGS.STATUS,
             attrs: {},
             content: text
         }
@@ -48,7 +48,27 @@ export function buildSetStatusIq(text) {
 }
 export function buildGetDisappearingModeUsyncQueryNode() {
     return {
-        tag: 'disappearing_mode',
+        tag: WA_NODE_TAGS.DISAPPEARING_MODE,
+        attrs: {}
+    };
+}
+export function buildSetDisappearingModeIq(durationSeconds) {
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.DISAPPEARING_MODE, [
+        {
+            tag: WA_NODE_TAGS.DISAPPEARING_MODE,
+            attrs: { duration: String(durationSeconds) }
+        }
+    ]);
+}
+export function buildGetTextStatusUsyncQueryNode() {
+    return {
+        tag: WA_NODE_TAGS.TEXT_STATUS,
+        attrs: {}
+    };
+}
+export function buildGetUsernameUsyncQueryNode() {
+    return {
+        tag: WA_NODE_TAGS.USERNAME,
         attrs: {}
     };
 }
@@ -59,7 +79,7 @@ export function buildGetStatusUsyncQueryNodes() {
             attrs: {}
         },
         {
-            tag: 'status',
+            tag: WA_NODE_TAGS.STATUS,
             attrs: {}
         },
         {

package/dist/esm/transport/node/builders/retry.js

@@ -75,7 +75,7 @@ export function buildRetryReceiptNode(input) {
         id: input.originalMsgId,
         t: input.t
     };
-    if (input.error !== undefined) {
+    if (input.error !== undefined && input.error !== 0) {
         retryAttrs.error = String(input.error);
     }
     const content = [

package/dist/esm/transport/node/builders/tos.js

@@ -0,0 +1,58 @@
+import { WA_DEFAULTS } from '../../../protocol/defaults.js';
+import { WA_IQ_TYPES, WA_XMLNS } from '../../../protocol/nodes.js';
+import { buildIqNode } from '../../node/query.js';
+import { parseOptionalInt } from '../../../util/primitives.js';
+function noticeNodes(noticeIds) {
+    return noticeIds.map((id) => ({
+        tag: 'notice',
+        attrs: { id }
+    }));
+}
+export function buildTosQueryIq(noticeIds) {
+    if (noticeIds.length === 0) {
+        throw new Error('tos query requires at least one notice id');
+    }
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.TOS, [
+        {
+            tag: 'request',
+            attrs: {},
+            content: noticeNodes(noticeIds)
+        }
+    ]);
+}
+export function buildTosUpdateIq(noticeIds) {
+    if (noticeIds.length === 0) {
+        throw new Error('tos update requires at least one notice id');
+    }
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.TOS, [
+        {
+            tag: 'request',
+            attrs: { type: 'session_update' },
+            content: noticeNodes(noticeIds)
+        }
+    ]);
+}
+export function parseTosQueryResponse(node) {
+    const tosNode = Array.isArray(node.content)
+        ? node.content.find((child) => child.tag === 'tos')
+        : undefined;
+    if (!tosNode) {
+        throw new Error('tos response missing <tos> node');
+    }
+    const refreshSeconds = parseOptionalInt(tosNode.attrs.refresh) ?? 0;
+    const notices = [];
+    if (Array.isArray(tosNode.content)) {
+        for (const child of tosNode.content) {
+            if (child.tag !== 'notice')
+                continue;
+            const id = child.attrs.id;
+            if (!id)
+                continue;
+            notices.push({
+                id,
+                accepted: child.attrs.state !== 'false'
+            });
+        }
+    }
+    return { refreshSeconds, notices };
+}

package/dist/esm/transport/node/builders/usync.js

@@ -1,5 +1,7 @@
-import { WA_DEFAULTS, WA_NODE_TAGS, WA_USYNC_CONTEXTS, WA_USYNC_DEFAULTS, WA_USYNC_MODES, WA_XMLNS } from '../../../protocol/constants.js';
+import { WA_DEFAULTS, WA_IQ_TYPES, WA_NODE_TAGS, WA_USYNC_CONTEXTS, WA_USYNC_DEFAULTS, WA_USYNC_MODES, WA_XMLNS } from '../../../protocol/constants.js';
+import { findNodeChild, getNodeChildrenByTag } from '../../node/helpers.js';
 import { buildIqNode } from '../../node/query.js';
+import { parseOptionalInt } from '../../../util/primitives.js';
 export function buildUsyncUserNode(input) {
     return {
         tag: WA_NODE_TAGS.USER,
@@ -10,6 +12,53 @@ export function buildUsyncUserNode(input) {
         ...(input.content !== undefined ? { content: input.content } : {})
     };
 }
+export function iterateUsyncUsers(result) {
+    const usyncNode = findNodeChild(result, WA_NODE_TAGS.USYNC);
+    if (!usyncNode)
+        return null;
+    const listNode = findNodeChild(usyncNode, WA_NODE_TAGS.LIST);
+    if (!listNode)
+        return null;
+    return getNodeChildrenByTag(listNode, WA_NODE_TAGS.USER);
+}
+const EMPTY_USYNC_RESULT_ENVELOPE = Object.freeze({
+    errors: Object.freeze({}),
+    refresh: Object.freeze({})
+});
+/**
+ * Walks a `usync` IQ result and extracts per-protocol error envelopes plus
+ * `refresh` hints. Returns an empty envelope when the result has no `usync`
+ * payload.
+ */
+export function parseUsyncResultEnvelope(result) {
+    const usyncNode = findNodeChild(result, WA_NODE_TAGS.USYNC);
+    if (!usyncNode)
+        return EMPTY_USYNC_RESULT_ENVELOPE;
+    const resultNode = findNodeChild(usyncNode, 'result');
+    if (!resultNode)
+        return EMPTY_USYNC_RESULT_ENVELOPE;
+    if (!Array.isArray(resultNode.content))
+        return EMPTY_USYNC_RESULT_ENVELOPE;
+    const errors = {};
+    const refresh = {};
+    for (let i = 0; i < resultNode.content.length; i += 1) {
+        const protoNode = resultNode.content[i];
+        const errorNode = findNodeChild(protoNode, WA_NODE_TAGS.ERROR);
+        if (errorNode) {
+            errors[protoNode.tag] = {
+                code: parseOptionalInt(errorNode.attrs.code) ?? null,
+                text: errorNode.attrs.text ?? null,
+                backoffSeconds: parseOptionalInt(errorNode.attrs.backoff) ?? null
+            };
+            continue;
+        }
+        const refreshSeconds = parseOptionalInt(protoNode.attrs.refresh);
+        if (refreshSeconds !== undefined) {
+            refresh[protoNode.tag] = refreshSeconds;
+        }
+    }
+    return { errors, refresh };
+}
 export function buildUsyncIq(input) {
     if (input.queryProtocolNodes.length === 0) {
         throw new Error('usync query must include at least one protocol node');
@@ -18,7 +67,7 @@ export function buildUsyncIq(input) {
     for (let index = 0; index < input.users.length; index += 1) {
         users[index] = buildUsyncUserNode(input.users[index]);
     }
-    return buildIqNode('get', input.hostDomain ?? WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.USYNC, [
+    return buildIqNode(WA_IQ_TYPES.GET, input.hostDomain ?? WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.USYNC, [
         {
             tag: WA_NODE_TAGS.USYNC,
             attrs: {

package/dist/esm/transport/node/helpers.js

@@ -126,6 +126,16 @@ export function decodeNodeContentUtf8OrBytes(value, field) {
     }
     throw new Error(`node ${field} has no binary content`);
 }
+export function getNodeTextContent(node) {
+    if (!node)
+        return undefined;
+    const content = node.content;
+    if (content instanceof Uint8Array)
+        return TEXT_DECODER.decode(content);
+    if (typeof content === 'string')
+        return content;
+    return undefined;
+}
 export function decodeNodeContentBase64OrBytes(value, field) {
     if (value === null || value === undefined) {
         throw new Error(`missing binary node content for ${field}`);
@@ -138,7 +148,7 @@ export function decodeNodeContentBase64OrBytes(value, field) {
     }
     throw new Error(`missing binary node content for ${field}`);
 }
-export function formatNodeIdPrefixFromSeed(seed) {
+function formatNodeIdPrefixFromSeed(seed) {
     const left = ((seed[0] << 8) | seed[1]) >>> 0;
     const right = ((seed[2] << 8) | seed[3]) >>> 0;
     return `${left}.${right}-`;
@@ -155,3 +165,19 @@ export async function createNodeIdGenerator() {
         }
     };
 }
+export function createMobileNodeIdGenerator() {
+    let featureCounter = 0;
+    let systemCounter = 0;
+    return {
+        prefix: '0',
+        next() {
+            const id = `0${featureCounter.toString(16)}`;
+            featureCounter = (featureCounter + 1) & 0xffff;
+            return id;
+        },
+        nextSystem() {
+            systemCounter = (systemCounter + 1) & 0xffff;
+            return systemCounter.toString(16);
+        }
+    };
+}

package/dist/esm/transport/node/mex/argo-decoder.js

@@ -0,0 +1,152 @@
+import { TEXT_DECODER } from '../../../util/bytes.js';
+let cachedArgo;
+async function loadArgo() {
+    if (cachedArgo !== undefined)
+        return cachedArgo;
+    try {
+        cachedArgo = await import('argo-codec');
+    }
+    catch {
+        cachedArgo = null;
+    }
+    return cachedArgo;
+}
+export async function isMexArgoDecoderAvailable() {
+    return (await loadArgo()) !== null;
+}
+const LABEL_NULL = -1;
+const LABEL_ABSENT = -2;
+const BACKREF_BASE = -4;
+const DESC_NULL = -1;
+const DESC_FALSE = 0;
+const DESC_TRUE = 1;
+const DESC_OBJECT = 2;
+const DESC_LIST = 3;
+const DESC_STRING = 4;
+const DESC_BYTES = 5;
+const DESC_INT = 6;
+const DESC_FLOAT = 7;
+const FLAG_INLINE_EVERYTHING = 1 << 0;
+const FLAG_HAS_USER_FLAGS = 1 << 6;
+export async function decodeMexArgoResponse(bytes) {
+    const argo = await loadArgo();
+    if (!argo)
+        throw new Error('argo-codec not installed');
+    const r = new argo.Reader(bytes);
+    const flags = r.bitset();
+    const inline = (flags & FLAG_INLINE_EVERYTHING) !== 0;
+    if (flags & FLAG_HAS_USER_FLAGS)
+        r.bitset();
+    const segments = [];
+    if (!inline) {
+        while (r.pos < r.end) {
+            const len = r.label();
+            segments.push(new argo.Reader(r.bytes(len)));
+        }
+        if (segments.length === 0)
+            throw new Error('mex argo: missing core segment');
+    }
+    else {
+        segments.push(r);
+    }
+    const core = segments[segments.length - 1];
+    const blocks = inline ? new Map() : indexBlocks(segments.slice(0, -1));
+    const ctx = { core, blocks, stringSeen: [] };
+    const data = readDesc(ctx);
+    const errors = [];
+    if (core.pos < core.end) {
+        const errCount = core.label();
+        for (let i = 0; i < errCount; i++)
+            errors.push(readError(ctx));
+    }
+    return { data, errors };
+}
+function indexBlocks(slices) {
+    const m = new Map();
+    const keys = ['String', 'Int', 'Float', 'Bytes'];
+    for (let i = 0; i < slices.length && i < keys.length; i++)
+        m.set(keys[i], slices[i]);
+    return m;
+}
+function getBlock(ctx, key) {
+    const b = ctx.blocks.get(key);
+    if (!b)
+        throw new Error(`mex argo: block '${key}' missing`);
+    return b;
+}
+function readStringFromBlock(ctx) {
+    const lab = ctx.core.label();
+    if (lab < BACKREF_BASE + 1) {
+        const idx = -lab + BACKREF_BASE;
+        return ctx.stringSeen[idx];
+    }
+    const block = getBlock(ctx, 'String');
+    const s = TEXT_DECODER.decode(block.bytes(lab));
+    ctx.stringSeen.push(s);
+    return s;
+}
+function readDesc(ctx) {
+    const m = ctx.core.label();
+    switch (m) {
+        case DESC_NULL:
+            return null;
+        case DESC_FALSE:
+            return false;
+        case DESC_TRUE:
+            return true;
+        case DESC_STRING:
+            return readStringFromBlock(ctx);
+        case DESC_INT:
+            return getBlock(ctx, 'Int').label();
+        case DESC_FLOAT:
+            throw new Error('mex argo: DESC_FLOAT not implemented');
+        case DESC_BYTES:
+            throw new Error('mex argo: DESC_BYTES not implemented');
+        case DESC_LIST: {
+            const n = ctx.core.label();
+            const out = [];
+            for (let i = 0; i < n; i++)
+                out.push(readDesc(ctx));
+            return out;
+        }
+        case DESC_OBJECT: {
+            const n = ctx.core.label();
+            const out = {};
+            for (let i = 0; i < n; i++) {
+                const key = readStringFromBlock(ctx);
+                out[key] = readDesc(ctx);
+            }
+            return out;
+        }
+        default:
+            throw new Error(`mex argo: unknown DESC marker ${m}`);
+    }
+}
+function readError(ctx) {
+    const message = readStringFromBlock(ctx);
+    skipOptional(ctx); // location – never observed in MEX errors so far
+    const path = readPath(ctx);
+    const extensions = readOptionalDesc(ctx);
+    return { message, path, extensions };
+}
+function skipOptional(ctx) {
+    const lab = ctx.core.label();
+    if (lab !== LABEL_ABSENT && lab !== LABEL_NULL) {
+        // Present but not yet structurally decoded; would need a typed inner read here.
+        // For locations specifically we have no observed sample; bail loudly if hit.
+        throw new Error(`mex argo: unexpected optional present (lab=${lab}); add support`);
+    }
+}
+function readPath(ctx) {
+    const lab = ctx.core.label();
+    if (lab === LABEL_ABSENT || lab === LABEL_NULL)
+        return null;
+    return lab;
+}
+function readOptionalDesc(ctx) {
+    const lab = ctx.core.label();
+    if (lab === LABEL_ABSENT || lab === LABEL_NULL)
+        return null;
+    const v = readDesc(ctx);
+    return typeof v === 'object' && v !== null ? v : null;
+}