Raw frames

// op-698: list the calendar channels this bot can view in a server
const channels = await client.raw.request([698], 698, { serverId });

// op-694: create a calendar event, with an end-to-end encrypted description
await client.raw.send(
  [694, channelId, title, client.encryptFor(serverId, description), startsAt],
  { serverId, channelId },
);

// read the firehose
client.on('raw', (frame) => console.log(frame[0], frame));

client.raw.send(frame: unknown[], opts?: RawTarget): Promise<void>

client.raw.request(
  frame: unknown[],
  replyOpcode: number,
  opts?: RawTarget & {
    timeoutMs?: number;
    match?: (payload: unknown) => boolean;
    allowReserved?: boolean;
  },
): Promise<unknown>

interface RawTarget {
  serverId?: string;
  channelId?: string;
  groupId?: string;
}

const payload = await client.raw.request([698], 698, { serverId });
const rows: unknown[] = Array.isArray(payload) ? payload : [payload];

[cloak-sdk] opcode 45 is correlated by the SDK itself; awaiting it from
raw.request can claim (or lose) the SDK's own reply. Use the mapped method
for it, or pass { allowReserved: true } to take that risk deliberately.

import { RESERVED_REPLY_OPCODES } from '@cloak-software/bot-sdk';

function canAwait(replyOpcode: number): boolean {
  return !RESERVED_REPLY_OPCODES.has(replyOpcode);
}

canAwait(698); // true, the SDK maps nothing on 698
canAwait(45);  // false, reactions are correlated by the SDK

client.on('raw', (frame) => {
  if (frame[0] === 622) console.log('key epoch bumped', frame);
});

// Your backend's opcode, not one the SDK maps. You own this constant.
const CALENDAR_EVENT_HOOK = 695;

client.on('raw', (frame) => {
  if (frame[0] !== CALENDAR_EVENT_HOOK) return;
  const serverId = String(frame[1]);
  const text = client.decryptFrom(serverId, String(frame[3]));
  if (text) console.log('event description:', text);
});