helios-send-core

Core client library for HeliosSend email delivery service, built by Revinity.

This is the base package that provides the core MailClient class and types. Other platform-specific packages (helios-send-node, helios-send-browser, etc.) build on top of this.

Installation

npm install helios-send-core
# or
pnpm add helios-send-core
# or
yarn add helios-send-core

Usage

import { MailClient } from 'helios-send-core';

const client = new MailClient({
  apiKey: 'your-api-key', // or token for browser usage
  baseUrl: 'https://api.helios-send.com',
});

await client.send({
  from: { email: '[email protected]', name: 'My App' },
  to: [{ email: '[email protected]' }],
  subject: 'Welcome!',
  html: '<p>Welcome to HeliosSend!</p>',
});

Features

• Isomorphic (works in Node.js and browsers)
• Automatic retries with exponential backoff
• Idempotency key support
• Type-safe with TypeScript
• Structured error handling

API

See the main documentation for full API reference.