# @relio/sdk

TypeScript SDK for the Relio platform.

## Installation

```bash
npm install @relio/sdk
```

## SDK modules

- `@relio/sdk/client` -- Browser & Node.js API client
- `@relio/sdk/server` -- Server-side client & webhook verification
- `@relio/sdk/core` -- Shared types, schemas, and error classes

## Quick start

```ts
import { createRelioClient } from "@relio/sdk/client";

const relio = createRelioClient({
  baseUrl: "https://app.reliocrm.com",
  apiKey: process.env.RELIO_API_KEY!,
});

const page = await relio.contacts.list({ limit: 50 });
const contact = await relio.contacts.create({
  firstName: "Ada",
  lastName: "Lovelace",
  email: [{ address: "ada@example.com", isPrimary: true }],
});
```

## Server SDK & Webhooks

```ts
import { createRelioServerClient, verifyRelioWebhookRequest } from "@relio/sdk/server";

const relio = createRelioServerClient({
  baseUrl: "https://app.reliocrm.com",
  apiKey: process.env.RELIO_API_KEY!,
});

export async function POST(req: Request) {
  const verified = await verifyRelioWebhookRequest({
    request: req,
    secret: process.env.RELIO_WEBHOOK_SECRET!,
  });

  console.log(verified.event, verified.payload);
  return new Response("ok");
}
```

## CLI

For the command-line tool, see [`relio-cli`](../cli).