Botruntime Client

HTTP client for TypeScript. Queries the botruntime API.

Exact FileRef streaming

client.downloadFileRef({ fileRef, signal? }) opens the complete immutable FileRef generation through the authenticated raw endpoint and returns a Web ReadableStream<Uint8Array>. The client does not decode base64 or materialize the response as a Buffer/ArrayBuffer; pipe the stream directly to the provider and use AbortSignal for cancellation. A stale generation fails closed instead of silently reading a newer upload under the same file key. Non-2xx responses throw DownloadFileRefError with the HTTP status and the platform errorCode when one is present.

Installation

npm install --save @holocronlab/botruntime-client # for npm
yarn add @holocronlab/botruntime-client # for yarn
pnpm add @holocronlab/botruntime-client # for pnpm

Usage

import { Client, ClientInputs, ClientOutputs } from '@holocronlab/botruntime-client'

// 0. Type definitions for each operation's IO
type GetBotInput = ClientInputs['getBot']
type GetBotOutput = ClientOutputs['getBot']

const main = async () => {
  const token = 'your-token'
  const workspaceId = 'your-workspace-id'
  const botId = 'your-bot-id'
  const client = new Client({ token, workspaceId, botId })

  // 1. plain operations
  const { bot } = await client.getBot({ id: botId })
  console.log('### bot', bot)

  // 2. list utils with `.collect()` function
  const [latestConversation] = await client.list
    .conversations({ sortField: 'createdAt', sortDirection: 'desc', integrationName: 'telegram' })
    .collect({ limit: 1 })
  console.log('### latestConversation', latestConversation)

  // 3. list utils with async generator and `for await` syntax
  for await (const message of client.list.messages({ conversationId: latestConversation.id })) {
    console.log(`### [${message.userId}]`, message.payload)
  }
}

void main()