Rich cards

await client.sendCard(serverId, channelId, {
  content: 'Build #4821 passed on main', // required, and genuine text
  embed: {
    title: 'Build #4821 passed',
    description: '42 tests, 0 failures\nmain @ 9f2a1c, 1m 12s',
    color: '#22c55e', // or a decimal int, 0x22c55e
    url: 'https://ci.example.com/runs/4821',
  },
});

client.on('messageCreate', async (msg) => {
  if (msg.isDM || !msg.serverId) return;
  // msg.serverId is a string from here on
});

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

const embed = { title: 'Build #4821 passed', color: 0x22c55e };
await client.sendCard(serverId, channelId, {
  content: embedFallbackText(embed), // "Build #4821 passed"
  embed,
});

import { isCloakMediaUrl, CLOAK_MEDIA_ORIGIN } from '@cloak-software/bot-sdk';

isCloakMediaUrl('https://media.cloak.chat/uploads/a/logo.png'); // true
isCloakMediaUrl('https://example.com/logo.png');                // false
CLOAK_MEDIA_ORIGIN;                                             // 'https://media.cloak.chat'

const embed = {
  title: 'Build #4821 passed',
  // Every mobile user sees this line. Keep the substance here.
  description: '42 tests, 0 failures\nmain @ 9f2a1c, 1m 12s',
  fields: [
    { name: 'Duration', value: '1m 12s', inline: true },
    { name: 'Commit', value: '9f2a1c', inline: true },
  ],
};

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

try {
  await client.sendCard(serverId, channelId, card);
} catch (e) {
  if (e instanceof CloakEmbedError) {
    // e.reason: 'shape' | 'content' | 'cap' | 'media-host' | 'empty' | 'wire-cap'
    // e.field:  'embed.image.url', 'embed.fields[3].value', or undefined
    console.error(`card refused (${e.reason}) at ${e.field ?? 'the payload'}: ${e.message}`);
    return;
  }
  throw e;
}

import { Client, CloakEmbedError, embedFallbackText } from '@cloak-software/bot-sdk';

const client = new Client({
  token: process.env.CLOAK_TOKEN!,
  // Without a keystore this bot works once and is bricked on its second run.
  // See /concepts/keys-and-keystore.
  keystorePath: './card-bot.cloak-keystore.json',
  requiredPermissions: ['view_text', 'message_send'],
});

client.on('messageCreate', async (msg) => {
  if (msg.authorId === client.user?.id) return; // ignore our own messages
  if (msg.isDM || !msg.serverId) return; // cards are server-only in v1
  if (msg.content.trim() !== '!build') return;

  const embed = {
    title: 'Build #4821 passed',
    description: ['42 tests, 0 failures', 'main @ 9f2a1c, 1m 12s'].join('\n'),
    color: '#22c55e',
    url: 'https://ci.example.com/runs/4821',
    footer: { text: 'ci.example.com' },
    timestamp: new Date().toISOString(),
  };

  try {
    await client.sendCard(msg.serverId, msg.channelId, {
      content: embedFallbackText(embed),
      embed,
    });
  } catch (e) {
    if (e instanceof CloakEmbedError) {
      console.error(`card refused (${e.reason}) at ${e.field ?? 'the payload'}`);
      return;
    }
    throw e;
  }
});

client.on('sendRejected', (r) => console.warn('server refused a send', r.code, r.message));
client.on('error', (e) => console.error('sdk error', e));

client.login().catch((e) => {
  console.error('login failed', e);
  process.exit(1);
});