Primeros pasos

curl -s "https://huwi.app/api/trpc/bot.me" \
  -H "x-api-key: $HUWI_KEY"

// huwi.ts: lo mínimo para hablar con la API de Huwi desde Node 22+ (sin librerías).
//   export HUWI_KEY=hwk_...      la clave de tu bot
const BASE = process.env.HUWI_URL ?? "https://huwi.app";
const KEY = process.env.HUWI_KEY ?? "";

export class HuwiError extends Error {
  code: string;
  status: number;
  constructor(path: string, message: string, code: string, status: number) {
    super(`${path}: ${code} ${message}`);
    this.code = code;
    this.status = status;
  }
}

async function call(path: string, init: RequestInit, query = "") {
  const response = await fetch(`${BASE}/api/trpc/${path}${query}`, {
    ...init,
    headers: { "x-api-key": KEY, "content-type": "application/json" },
  });
  const body = await response.json();
  if (!response.ok) throw new HuwiError(path, body.error.json.message, body.error.json.data.code, response.status);
  return body.result.data.json;
}

// Lecturas: GET con la entrada en ?input=.
export const query = (path: string, input?: unknown) =>
  call(path, { method: "GET" }, input === undefined ? "" : `?input=${encodeURIComponent(JSON.stringify({ json: input }))}`);

// Escrituras: POST con la entrada en el cuerpo.
export const mutate = (path: string, input: unknown = {}) =>
  call(path, { method: "POST", body: JSON.stringify({ json: input }) });

curl -s "https://huwi.app/api/trpc/message.send" \
  -H "x-api-key: $HUWI_KEY" \
  -H "content-type: application/json" \
  -d '{"json":{"chatId":"107652219945181184","clientId":"saludo-1","text":"Hola desde curl"}}'

import { mutate, query } from "./huwi.ts";

// Un bot que repite lo que le escriben. Pide novedades sin parar y confirma cada una.
let offset: string | undefined;

async function handle(update: { id: string; type: string; chatId: string | null; payload: Record<string, any> }) {
  if (update.type === "message" && update.payload.text) {
    await mutate("message.send", {
      chatId: update.chatId,
      clientId: `eco-${update.id}`, // el mismo clientId no manda dos veces el mismo mensaje
      text: `Dijiste: ${update.payload.text}`,
    });
  }
}

while (true) {
  const { updates } = await query("bot.updates", { offset, timeout: 25000 });
  for (const update of updates) {
    await handle(update);
    // Siguiente offset: el id de esta novedad + 1. Los ids son números grandes: usa BigInt.
    offset = String(BigInt(update.id) + 1n);
  }
}