@crowdedkingdoms/crowdyjs 13.0.2 → 13.1.0

package/dist/binary-wire.js

@@ -0,0 +1,446 @@
+/**
+ * Buddy client wire-format codec for the binary realtime relay
+ * (`crowdy-relay-v1`).
+ *
+ * Mirrors the game-api's `UdpMessageParserService` byte-for-byte: uplink
+ * serializers build the complete client→Buddy datagram (spatial header +
+ * payload + HMAC + gameTokenId + sequence) and downlink parsing produces the
+ * same `__typename`-tagged notification objects the GraphQL
+ * `udpNotifications` subscription delivers, so handler code is transport
+ * agnostic.
+ *
+ * The per-message HMAC key is the 64-octet game token string itself — the
+ * same bearer token the SDK already holds — computed with WebCrypto
+ * (HMAC-SHA256). Buddy verifies it server-side; the relay does not.
+ */
+import { decodeBase64, encodeBase64 } from './utils.js';
+export const RELAY_MAX_DATAGRAM_BYTES = 1232;
+/** Wire opcodes (mirror of game-api / Buddy `UdpMessageType`). */
+export const WireMessageType = {
+    MESSAGE_BUNDLE: 2,
+    GENERIC_ERROR_MESSAGE: 3,
+    CHANNEL_MESSAGE_REQUEST: 17,
+    CHANNEL_MESSAGE_NOTIFICATION: 18,
+    ACTOR_UPDATE_REQUEST_2: 128,
+    ACTOR_UPDATE_RESPONSE_2: 129,
+    ACTOR_UPDATE_NOTIFICATION_2: 130,
+    VOXEL_UPDATE_REQUEST_2: 131,
+    VOXEL_UPDATE_RESPONSE_2: 132,
+    VOXEL_UPDATE_NOTIFICATION_2: 133,
+    CLIENT_AUDIO_PACKET_2: 134,
+    CLIENT_AUDIO_NOTIFICATION_2: 135,
+    CLIENT_TEXT_PACKET_2: 136,
+    CLIENT_TEXT_NOTIFICATION_2: 137,
+    CLIENT_EVENT_NOTIFICATION_2: 138,
+    SERVER_EVENT_NOTIFICATION_2: 139,
+    SINGLE_ACTOR_MESSAGE: 142,
+};
+const SPATIAL_HEADER_SIZE = 68;
+const UUID_SIZE = 32;
+const HMAC_SIZE = 32;
+/** Client→server tail with auth: hmac(32) + gameTokenId(8) + seq(1). */
+const TAIL_AUTH_BYTES = 41;
+/** Server→client tail: epochMillis(8) + seq(1). */
+const TAIL_NO_AUTH_BYTES = 9;
+/**
+ * Wire error byte → GraphQL `UdpErrorCode` enum name (mirror of the game-api
+ * `ErrorType` numeric enum, which GraphQL serializes by name).
+ */
+const UDP_ERROR_NAMES = {
+    0: 'NO_ERROR',
+    1: 'UNKNOWN_ERROR',
+    2: 'EMAIL_NOT_FOUND',
+    3: 'BAD_PASSWORD',
+    4: 'EMAIL_ALREADY_EXISTS',
+    5: 'INVALID_TOKEN',
+    6: 'APP_NOT_FOUND',
+    7: 'UNAUTHORIZED',
+    8: 'APP_NOT_LOADED',
+    9: 'EMAIL_TOO_SHORT',
+    10: 'EMAIL_TOO_LONG',
+    11: 'PASSWORD_TOO_SHORT',
+    12: 'PASSWORD_TOO_LONG',
+    13: 'GAME_TOKEN_WRONG_SIZE',
+    14: 'NAME_TOO_LONG',
+    15: 'INVALID_REQUEST',
+    16: 'EMAIL_INVALID',
+    17: 'INVALID_TOKEN_LENGTH',
+    18: 'INVALID_APP_ID',
+    19: 'CHUNK_NOT_FOUND',
+    20: 'USER_NOT_AUTHENTICATED',
+    21: 'INVALID_STATE_DATA',
+    22: 'USER_NOT_APP_ADMIN',
+    23: 'GRID_OUTSIDE_ASSIGNMENT',
+    24: 'NO_MATCHING_GRID_ASSIGNMENT',
+    25: 'INVALID_GRID_COORDINATES',
+    26: 'GRID_ALREADY_EXISTS',
+    27: 'GRID_OVERLAPS_EXISTING',
+    28: 'GAMERTAG_ALREADY_EXISTS',
+    29: 'GRID_NOT_FOUND',
+    30: 'CANNOT_DELETE_DEFAULT_WORLD_GRID',
+    31: 'GRID_HAS_NESTED_CHILDREN',
+    32: 'TOKEN_EXPIRED',
+};
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder();
+function latin1Bytes(value) {
+    const bytes = new Uint8Array(value.length);
+    for (let i = 0; i < value.length; i += 1) {
+        bytes[i] = value.charCodeAt(i) & 0xff;
+    }
+    return bytes;
+}
+/** Import the game token as an HMAC-SHA256 WebCrypto key (once per session). */
+export async function createSignContext(gameTokenId, gameTokenString) {
+    const tokenBytes = latin1Bytes(gameTokenString);
+    const key = await crypto.subtle.importKey('raw', tokenBytes, { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+    return { gameTokenId, tokenBytes, key };
+}
+/**
+ * Spatial-message HMAC: key = token bytes; signed data =
+ * `dataBeforeHmac || tokenBytes` (mirror of `computeSpatialHmac`).
+ */
+async function signWithToken(ctx, dataBeforeHmac) {
+    const signed = new Uint8Array(dataBeforeHmac.length + ctx.tokenBytes.length);
+    signed.set(dataBeforeHmac, 0);
+    signed.set(ctx.tokenBytes, dataBeforeHmac.length);
+    const mac = await crypto.subtle.sign('HMAC', ctx.key, signed);
+    return new Uint8Array(mac);
+}
+function clampDistance(distance) {
+    return Math.max(0, Math.min(8, distance));
+}
+/**
+ * Build a complete client→Buddy spatial datagram:
+ * `header(68) + payload + hmac(32) + gameTokenId(8) + seq(1)` with
+ * `containsAuth = 1` (mirror of `serializeSpatialMessage`).
+ */
+async function serializeSpatial(ctx, messageType, appId, chunk, distance, decayRate, uuid, payload, sequenceNumber) {
+    const dataLen = SPATIAL_HEADER_SIZE + payload.length;
+    const data = new Uint8Array(dataLen);
+    const view = new DataView(data.buffer);
+    let off = 0;
+    view.setUint8(off, messageType);
+    off += 1;
+    view.setBigInt64(off, BigInt(appId), true);
+    off += 8;
+    view.setBigInt64(off, BigInt(chunk.x), true);
+    off += 8;
+    view.setBigInt64(off, BigInt(chunk.y), true);
+    off += 8;
+    view.setBigInt64(off, BigInt(chunk.z), true);
+    off += 8;
+    view.setUint8(off, clampDistance(distance));
+    off += 1;
+    view.setUint8(off, decayRate & 0xff);
+    off += 1;
+    view.setUint8(off, 1); // containsAuth
+    off += 1;
+    const uuidBytes = textEncoder.encode(uuid);
+    if (uuidBytes.length > UUID_SIZE) {
+        throw new Error(`UUID too long: ${uuidBytes.length} > ${UUID_SIZE}`);
+    }
+    data.set(uuidBytes, off);
+    off += UUID_SIZE;
+    data.set(payload, off);
+    const hmac = await signWithToken(ctx, data);
+    const total = dataLen + TAIL_AUTH_BYTES;
+    if (total > RELAY_MAX_DATAGRAM_BYTES) {
+        throw new Error(`Datagram exceeds maximum size: ${total} > ${RELAY_MAX_DATAGRAM_BYTES}`);
+    }
+    const out = new Uint8Array(total);
+    out.set(data, 0);
+    out.set(hmac, dataLen);
+    const tailView = new DataView(out.buffer);
+    tailView.setBigInt64(dataLen + HMAC_SIZE, ctx.gameTokenId, true);
+    tailView.setUint8(dataLen + HMAC_SIZE + 8, sequenceNumber & 0xff);
+    return out;
+}
+export function serializeActorUpdate(ctx, input) {
+    return serializeSpatial(ctx, WireMessageType.ACTOR_UPDATE_REQUEST_2, input.appId, input.chunk, input.distance ?? 8, input.decayRate ?? 1, input.uuid, decodeBase64(input.state ?? ''), input.sequenceNumber ?? 0);
+}
+export function serializeVoxelUpdate(ctx, input) {
+    const voxelState = decodeBase64(input.voxelState ?? '');
+    const payload = new Uint8Array(10 + voxelState.length);
+    const view = new DataView(payload.buffer);
+    view.setInt16(0, input.voxel.x, true);
+    view.setInt16(2, input.voxel.y, true);
+    view.setInt16(4, input.voxel.z, true);
+    view.setInt16(6, input.voxelType, true);
+    view.setUint16(8, voxelState.length, true);
+    payload.set(voxelState, 10);
+    return serializeSpatial(ctx, WireMessageType.VOXEL_UPDATE_REQUEST_2, input.appId, input.chunk, input.distance ?? 8, input.decayRate ?? 0, input.uuid, payload, input.sequenceNumber ?? 0);
+}
+export function serializeAudioPacket(ctx, input) {
+    return serializeSpatial(ctx, WireMessageType.CLIENT_AUDIO_PACKET_2, input.appId, input.chunk, input.distance ?? 1, input.decayRate ?? 0, input.uuid, decodeBase64(input.audioData ?? ''), input.sequenceNumber ?? 0);
+}
+export function serializeTextPacket(ctx, input) {
+    return serializeSpatial(ctx, WireMessageType.CLIENT_TEXT_PACKET_2, input.appId, input.chunk, input.distance ?? 8, input.decayRate ?? 0, input.uuid, textEncoder.encode(input.text ?? ''), input.sequenceNumber ?? 0);
+}
+export function serializeClientEvent(ctx, input) {
+    const state = decodeBase64(input.state ?? '');
+    const payload = new Uint8Array(2 + state.length);
+    new DataView(payload.buffer).setUint16(0, input.eventType, true);
+    payload.set(state, 2);
+    return serializeSpatial(ctx, WireMessageType.CLIENT_EVENT_NOTIFICATION_2, input.appId, input.chunk, input.distance ?? 8, input.decayRate ?? 0, input.uuid, payload, input.sequenceNumber ?? 0);
+}
+export function serializeSingleActorMessage(ctx, input) {
+    return serializeSpatial(ctx, WireMessageType.SINGLE_ACTOR_MESSAGE, input.appId, input.chunk, 0, 0, input.targetUuid, input.payload ? decodeBase64(input.payload) : new Uint8Array(0), input.sequenceNumber ?? 0);
+}
+/**
+ * CHANNEL_MESSAGE_REQUEST:
+ * `[1B type=17][8B channelId][32B uuid][2B payloadLen][payload][1B containsAuth]
+ *  [32B HMAC][8B gameTokenId][1B seq]` — HMAC over everything before it.
+ */
+export async function serializeChannelMessage(ctx, input) {
+    const payload = input.payload ? decodeBase64(input.payload) : new Uint8Array(0);
+    if (payload.length > 1024) {
+        throw new Error(`Channel payload exceeds 1024 bytes: ${payload.length}`);
+    }
+    const uuidBytes = textEncoder.encode(input.uuid);
+    if (uuidBytes.length !== UUID_SIZE) {
+        throw new Error(`Invalid uuid length: must be exactly ${UUID_SIZE} bytes when UTF-8 encoded. Received ${uuidBytes.length} bytes.`);
+    }
+    const prefixLen = 1 + 8 + UUID_SIZE + 2 + payload.length + 1;
+    const prefix = new Uint8Array(prefixLen);
+    const view = new DataView(prefix.buffer);
+    let off = 0;
+    view.setUint8(off, WireMessageType.CHANNEL_MESSAGE_REQUEST);
+    off += 1;
+    view.setBigUint64(off, BigInt(input.channelId), true);
+    off += 8;
+    prefix.set(uuidBytes, off);
+    off += UUID_SIZE;
+    view.setUint16(off, payload.length, true);
+    off += 2;
+    prefix.set(payload, off);
+    off += payload.length;
+    view.setUint8(off, 1); // containsAuth
+    const hmac = await signWithToken(ctx, prefix);
+    const out = new Uint8Array(prefixLen + HMAC_SIZE + 8 + 1);
+    out.set(prefix, 0);
+    out.set(hmac, prefixLen);
+    const tail = new DataView(out.buffer);
+    tail.setBigUint64(prefixLen + HMAC_SIZE, ctx.gameTokenId, true);
+    tail.setUint8(prefixLen + HMAC_SIZE + 8, (input.sequenceNumber ?? 0) & 0xff);
+    return out;
+}
+function stripNulls(value) {
+    return value.replace(/\0/g, '');
+}
+function parseSpatialParts(bytes, view) {
+    if (bytes.length < SPATIAL_HEADER_SIZE) {
+        throw new Error(`Spatial message too short for header: ${bytes.length} < ${SPATIAL_HEADER_SIZE}`);
+    }
+    let off = 1;
+    const appId = view.getBigInt64(off, true);
+    off += 8;
+    const chunkX = view.getBigInt64(off, true);
+    off += 8;
+    const chunkY = view.getBigInt64(off, true);
+    off += 8;
+    const chunkZ = view.getBigInt64(off, true);
+    off += 8;
+    const distance = view.getUint8(off);
+    off += 1;
+    const decayRate = view.getUint8(off);
+    off += 1;
+    const containsAuth = view.getUint8(off) !== 0;
+    off += 1;
+    const uuid = stripNulls(textDecoder.decode(bytes.subarray(off, off + UUID_SIZE)));
+    off += UUID_SIZE;
+    const tailBytes = containsAuth ? TAIL_AUTH_BYTES : TAIL_NO_AUTH_BYTES;
+    let payload;
+    let sequenceNumber = 0;
+    let epochMillis = 0n;
+    if (bytes.length >= SPATIAL_HEADER_SIZE + tailBytes) {
+        const payloadEnd = bytes.length - tailBytes;
+        payload = bytes.subarray(off, payloadEnd);
+        let tOff = payloadEnd;
+        if (containsAuth)
+            tOff += HMAC_SIZE;
+        epochMillis = view.getBigInt64(tOff, true);
+        sequenceNumber = view.getUint8(tOff + 8);
+    }
+    else {
+        payload = bytes.subarray(off);
+    }
+    return {
+        appId: appId.toString(),
+        chunkX: chunkX.toString(),
+        chunkY: chunkY.toString(),
+        chunkZ: chunkZ.toString(),
+        distance,
+        decayRate,
+        uuid,
+        payload,
+        sequenceNumber,
+        epochMillis: epochMillis.toString(),
+    };
+}
+function spatialCommon(p) {
+    return {
+        appId: p.appId,
+        chunkX: p.chunkX,
+        chunkY: p.chunkY,
+        chunkZ: p.chunkZ,
+        distance: p.distance,
+        decayRate: p.decayRate,
+        uuid: p.uuid,
+        sequenceNumber: p.sequenceNumber,
+        epochMillis: p.epochMillis,
+    };
+}
+function parseOne(bytes) {
+    if (bytes.length < 1)
+        return null;
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const messageType = bytes[0];
+    if (messageType === WireMessageType.GENERIC_ERROR_MESSAGE) {
+        if (bytes.length < 3)
+            return null;
+        return {
+            __typename: 'GenericErrorResponse',
+            sequenceNumber: view.getUint8(1),
+            errorCode: (UDP_ERROR_NAMES[view.getUint8(2)] ??
+                'UNKNOWN_ERROR'),
+        };
+    }
+    if (messageType === WireMessageType.CHANNEL_MESSAGE_NOTIFICATION) {
+        // [1B type][8B channelId][32B senderUuid][2B payloadLen][payload][8B epochMillis][1B seq]
+        if (bytes.length < 1 + 8 + UUID_SIZE + 2)
+            return null;
+        let off = 1;
+        const channelId = view.getBigUint64(off, true);
+        off += 8;
+        const uuid = stripNulls(textDecoder.decode(bytes.subarray(off, off + UUID_SIZE)));
+        off += UUID_SIZE;
+        const payloadLen = view.getUint16(off, true);
+        off += 2;
+        if (bytes.length < off + payloadLen + 8 + 1)
+            return null;
+        const payload = bytes.subarray(off, off + payloadLen);
+        off += payloadLen;
+        const epochMillis = view.getBigUint64(off, true);
+        off += 8;
+        const sequenceNumber = view.getUint8(off);
+        return {
+            __typename: 'ChannelMessageNotification',
+            channelId: channelId.toString(),
+            uuid,
+            payload: encodeBase64(payload),
+            sequenceNumber,
+            epochMillis: epochMillis.toString(),
+        };
+    }
+    if ((messageType & 0x80) === 0) {
+        return null; // control opcodes (COMMAND_RECONNECT etc.) never reach the client
+    }
+    const p = parseSpatialParts(bytes, view);
+    switch (messageType) {
+        case WireMessageType.ACTOR_UPDATE_RESPONSE_2:
+            return {
+                __typename: 'ActorUpdateResponse',
+                ...spatialCommon(p),
+            };
+        case WireMessageType.ACTOR_UPDATE_NOTIFICATION_2:
+            return {
+                __typename: 'ActorUpdateNotification',
+                ...spatialCommon(p),
+                state: encodeBase64(p.payload),
+            };
+        case WireMessageType.VOXEL_UPDATE_RESPONSE_2:
+            return {
+                __typename: 'VoxelUpdateResponse',
+                ...spatialCommon(p),
+            };
+        case WireMessageType.VOXEL_UPDATE_NOTIFICATION_2: {
+            if (p.payload.length < 10)
+                return null;
+            const pv = new DataView(p.payload.buffer, p.payload.byteOffset, p.payload.byteLength);
+            const stateLength = pv.getUint16(8, true);
+            return {
+                __typename: 'VoxelUpdateNotification',
+                ...spatialCommon(p),
+                voxelX: pv.getInt16(0, true),
+                voxelY: pv.getInt16(2, true),
+                voxelZ: pv.getInt16(4, true),
+                voxelType: pv.getInt16(6, true),
+                voxelState: encodeBase64(p.payload.subarray(10, 10 + stateLength)),
+            };
+        }
+        case WireMessageType.CLIENT_AUDIO_NOTIFICATION_2:
+            return {
+                __typename: 'ClientAudioNotification',
+                ...spatialCommon(p),
+                audioData: encodeBase64(p.payload),
+            };
+        case WireMessageType.CLIENT_TEXT_NOTIFICATION_2:
+            return {
+                __typename: 'ClientTextNotification',
+                ...spatialCommon(p),
+                text: stripNulls(textDecoder.decode(p.payload)),
+            };
+        case WireMessageType.CLIENT_EVENT_NOTIFICATION_2:
+        case WireMessageType.SERVER_EVENT_NOTIFICATION_2: {
+            if (p.payload.length < 2)
+                return null;
+            const pv = new DataView(p.payload.buffer, p.payload.byteOffset, p.payload.byteLength);
+            return {
+                __typename: messageType === WireMessageType.CLIENT_EVENT_NOTIFICATION_2
+                    ? 'ClientEventNotification'
+                    : 'ServerEventNotification',
+                ...spatialCommon(p),
+                eventType: pv.getUint16(0, true),
+                state: encodeBase64(p.payload.subarray(2)),
+            };
+        }
+        case WireMessageType.SINGLE_ACTOR_MESSAGE: {
+            const { distance: _d, decayRate: _r, ...rest } = spatialCommon(p);
+            return {
+                __typename: 'SingleActorMessageNotification',
+                ...rest,
+                payload: encodeBase64(p.payload),
+            };
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Parse one relay BINARY frame (one Buddy datagram, possibly a
+ * MESSAGE_BUNDLE) into notification objects. Unparseable inner messages are
+ * skipped, mirroring the server-side bundle behavior.
+ */
+export function parseRelayFrame(bytes) {
+    if (bytes.length < 1)
+        return [];
+    if (bytes[0] === WireMessageType.MESSAGE_BUNDLE) {
+        const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+        const out = [];
+        let off = 1;
+        while (off + 2 <= bytes.length) {
+            const len = view.getUint16(off, true);
+            off += 2;
+            if (off + len > bytes.length)
+                break;
+            try {
+                const parsed = parseOne(bytes.subarray(off, off + len));
+                if (parsed)
+                    out.push(parsed);
+            }
+            catch {
+                // skip unparseable bundle member
+            }
+            off += len;
+        }
+        return out;
+    }
+    try {
+        const parsed = parseOne(bytes);
+        return parsed ? [parsed] : [];
+    }
+    catch {
+        return [];
+    }
+}

package/dist/crowdy-client.d.ts

@@ -114,6 +114,20 @@ export interface CrowdyClientConfig {
          * instead of HTTP POST (requires active `udp.subscribe`).
          */
         wsUplinkMutations?: boolean;
+        /**
+         * Use the game-api's binary realtime relay (`crowdy-relay-v1`): raw
+         * WebSocket BINARY frames carrying complete client-signed Buddy wire
+         * datagrams both ways, bypassing the GraphQL hot path. All `udp.*` /
+         * `world()` / stores APIs behave identically; the SDK falls back to the
+         * GraphQL transport when the relay endpoint is unavailable. Check server
+         * support via `gameClientBootstrap.binaryRelayEnabled`.
+         */
+        binaryTransport?: boolean;
+        /**
+         * Absolute ws(s) URL of the binary relay endpoint. Defaults to the
+         * realtime WebSocket URL with its path replaced by `/realtime`.
+         */
+        binaryRelayUrl?: string;
     };
     /**
      * Optional sticky-LB cookie jar shared with the game-api HTTP client. Node

package/dist/crowdy-client.d.ts.map

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

package/dist/domains/udp.d.ts

@@ -44,6 +44,12 @@ export declare class UdpAPI {
     constructor(gql: GraphQLClient, subs: SubscriptionManager, metrics?: RealtimeMetrics | undefined);
     /** Count a message accepted for sending (see `client.metrics`). */
     private record;
+    /**
+     * Try to send over the binary relay (`crowdy-relay-v1`). Returns `null`
+     * when the relay is not active/ready so the caller falls back to the
+     * GraphQL mutation. Client-side serialize + HMAC; no GraphQL on this path.
+     */
+    private sendViaRelay;
     /**
      * Open (or re-fetch) the UDP proxy session for this game token. Idempotent:
      * if a session is already open it returns the existing status; on first open

package/dist/domains/udp.d.ts.map

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

package/dist/domains/udp.js

@@ -1,6 +1,7 @@
 import { ConnectUdpProxyDocument, DisconnectUdpProxyDocument, UdpProxyConnectionStatusDocument, SendActorUpdateDocument, SendVoxelUpdateDocument, SendAudioPacketDocument, SendTextPacketDocument, SendClientEventDocument, SendSingleActorMessageDocument, SendChannelMessageDocument, } from '../generated/graphql.js';
 import { payloadBytesOf } from '../metrics.js';
 import { SequenceAllocator } from '../utils.js';
+import { serializeActorUpdate, serializeAudioPacket, serializeChannelMessage, serializeClientEvent, serializeSingleActorMessage, serializeTextPacket, serializeVoxelUpdate, } from '../binary-wire.js';
 /**
  * UDP proxy access for browser-style clients that can't open raw UDP sockets.
  * Exposed as `client.udp`; for game loops prefer the ergonomic, app-scoped
@@ -45,6 +46,31 @@ export class UdpAPI {
     record(kind, input) {
         this.metrics?.recordSent(kind, payloadBytesOf(input));
     }
+    /**
+     * Try to send over the binary relay (`crowdy-relay-v1`). Returns `null`
+     * when the relay is not active/ready so the caller falls back to the
+     * GraphQL mutation. Client-side serialize + HMAC; no GraphQL on this path.
+     */
+    async sendViaRelay(serialize) {
+        if (!this.subs.usingBinaryTransport())
+            return null;
+        if (!this.subs.binarySendReady()) {
+            // Relay configured but not open yet (e.g. right after subscribe or a
+            // token rotation). Wait briefly rather than falling back to HTTP — an
+            // HTTP send would open a parallel GraphQL proxy session for the same
+            // token whose idle teardown deauthorizes it under the relay session.
+            const ready = await this.subs.ensureBinaryReady(2000);
+            if (!ready)
+                return null;
+        }
+        try {
+            return await this.subs.sendBinaryFrame(serialize);
+        }
+        catch {
+            // Relay hiccup (socket flapped mid-send) — let GraphQL carry this one.
+            return null;
+        }
+    }
     /**
      * Open (or re-fetch) the UDP proxy session for this game token. Idempotent:
      * if a session is already open it returns the existing status; on first open
@@ -60,6 +86,19 @@ export class UdpAPI {
      *   valid bearer game token.
      */
     async connect() {
+        if (this.subs.usingBinaryTransport()) {
+            // Binary relay mode: the relay session (opened by subscribe) IS the
+            // proxy session. Never open a parallel GraphQL proxy session for the
+            // same token — its idle teardown would deauthorize the token on the
+            // game server underneath the relay.
+            const ready = await this.subs.ensureBinaryReady();
+            return {
+                connected: ready,
+                serverIp6: null,
+                serverClientPort: null,
+                lastMessageTime: null,
+            };
+        }
         const data = await this.gql.request(ConnectUdpProxyDocument, undefined);
         return data.connectUdpProxy;
     }
@@ -73,6 +112,10 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth failures.
      */
     async disconnect() {
+        if (this.subs.usingBinaryTransport()) {
+            this.subs.disconnect();
+            return true;
+        }
         const data = await this.gql.request(DisconnectUdpProxyDocument, undefined);
         return data.disconnectUdpProxy;
     }
@@ -120,6 +163,11 @@ export class UdpAPI {
      *   token, or `BAD_USER_INPUT` for a malformed packet.
      */
     async sendActorUpdate(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeActorUpdate(ctx, input));
+        if (viaRelay !== null) {
+            this.record('actorUpdate', input);
+            return viaRelay;
+        }
         if (this.subs.wsUplinkReady()) {
             try {
                 const data = await this.subs.executeMutation(SendActorUpdateDocument, {
@@ -219,6 +267,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendVoxelUpdate(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeVoxelUpdate(ctx, input));
+        if (viaRelay !== null) {
+            this.record('voxelUpdate', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendVoxelUpdateDocument, { input });
         this.record('voxelUpdate', input);
         return data.sendVoxelUpdate;
@@ -272,6 +325,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendAudioPacket(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeAudioPacket(ctx, input));
+        if (viaRelay !== null) {
+            this.record('audio', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendAudioPacketDocument, { input });
         this.record('audio', input);
         return data.sendAudioPacket;
@@ -321,6 +379,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendTextPacket(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeTextPacket(ctx, input));
+        if (viaRelay !== null) {
+            this.record('text', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendTextPacketDocument, { input });
         this.record('text', input);
         return data.sendTextPacket;
@@ -374,6 +437,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendClientEvent(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeClientEvent(ctx, input));
+        if (viaRelay !== null) {
+            this.record('clientEvent', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendClientEventDocument, { input });
         this.record('clientEvent', input);
         return data.sendClientEvent;
@@ -425,6 +493,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendSingleActorMessage(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeSingleActorMessage(ctx, input));
+        if (viaRelay !== null) {
+            this.record('singleActorMessage', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendSingleActorMessageDocument, {
             input,
         });
@@ -452,6 +525,11 @@ export class UdpAPI {
      * @throws {CrowdyGraphQLError} on auth/validation failures.
      */
     async sendChannelMessage(input) {
+        const viaRelay = await this.sendViaRelay((ctx) => serializeChannelMessage(ctx, input));
+        if (viaRelay !== null) {
+            this.record('channelMessage', input);
+            return viaRelay;
+        }
         const data = await this.gql.request(SendChannelMessageDocument, { input });
         this.record('channelMessage', input);
         return data.sendChannelMessage;