Berry Sweet SDK

TypeScript & JavaScript SDK resmi untuk mempermudah integrasi dengan Berry Sweet Gateway API.

🚀 Fitur

• 📤 Send Message: Kirim pesan via gateway API.
• 📄 Embeddings: Mendukung payload JSON maupun FormData (upload file/URL).
• 💬 Get Messages: Ambil riwayat pesan berdasarkan ID dengan dukungan paginasi (limit & cursor).
• 👥 Get Contacts: Ambil daftar kontak dengan dukungan paginasi.
• 🛡️ Error Handling: Menangkap HTTP error & detail response backend secara otomatis.

📦 Instalasi

Install melalui npm registry:

npm install berry-sweet
# atau
yarn add berry-sweet
# atau
pnpm add berry-sweet

🛠️ Inisialisasi

import { BerrySweet } from 'berry-sweet';

const client = new BerrySweet({
  apiKey: 'YOUR_API_KEY',
  keyPrefix: 'YOUR_KEY_PREFIX',
});

📖 Penggunaan SDK

1. Mengirim Pesan

async function handleSendMessage() {
  try {
    const response = await client.sendMessage({
      number: '628123456789',
      message: 'Halo dari Berry Sweet SDK!',
    });

    console.log('Pesan terkirim:', response);
  } catch (error: any) {
    console.error('Gagal mengirim pesan:', error.message);
  }
}

2. Membuat Embeddings

// Menggunakan URL
const result = await client.embeddings({
  url: '[https://example.com/document.pdf](https://example.com/document.pdf)',
  description: 'Dokumen penting',
});

// Menggunakan File
const result = await client.embeddings({
  file: myFileBlob, // Objek File / Blob
  description: 'Dokumen dari lokal',
});

3. Mengambil Riwayat Pesan

async function fetchMessages() {
  const messageId = 'msg-12345';
  
  // Mengambil pesan dengan opsi paginasi
  const messages = await client.getMessages(messageId, {
    limit: 20,
    cursor: 'cursor-token-xxx',
  });

  console.log('Daftar pesan:', messages);
}

4. Mengambil Daftar Kontak

async function fetchContacts() {
  // Tanpa opsi
  const contacts = await client.getContacts();

  // Dengan opsi paginasi
  const contactsPaged = await client.getContacts({
    limit: 50,
    cursor: 'cursor-token-xxx',
  });

  console.log('Daftar kontak:', contactsPaged);
}

📄 Lisensi

MIT License © 2026