# Northwind SDK — Operations Manual

## Installation

```bash
npm install @northwind/sdk
export NORTHWIND_API_KEY=nw_live_...
```

## Configuration

| Option      | Type   | Default | Description               |
| ----------- | ------ | ------- | ------------------------- |
| `region`    | string | `us-1`  | API region                |
| `timeout`   | number | `30000` | Request timeout (ms)      |
| `retries`   | number | `3`     | Automatic retry attempts  |

## Basic usage

```ts
import { Northwind } from "@northwind/sdk";

const client = new Northwind({ region: "eu-1" });
const job = await client.jobs.create({ type: "sync" });
```

## Error handling

All SDK errors extend `NorthwindError` and carry a stable
`code`. Retry on `RATE_LIMITED` and `UNAVAILABLE`; treat
everything else as terminal.

> Never retry `INVALID_REQUEST` — fix the payload instead.