# SDKs

Dos clientes oficiales, sin dependencias en tiempo de ejecución: `@wyroapi/sdk` (Node.js 18+, TypeScript, ESM y CommonJS) y `wyro` (Python 3.9+).

```
npm install @wyroapi/sdk
pip install wyro
```

## Node.js / TypeScript

```ts
import { Wyro } from "@wyroapi/sdk";

const wyro = new Wyro({ apiKey: process.env.WYRO_API_KEY });

const post = await wyro.posts.create(
  { text: "…", platforms: ["instagram"], media: [{ url: "https://…/a.jpg" }] },
  { idempotencyKey: crypto.randomUUID() },
);
console.log(post.status, post.preview_url);

for await (const p of wyro.posts.iterate()) console.log(p.id, p.status);
```

## Python

```python
import os, uuid
from wyro import Wyro

wyro = Wyro(api_key=os.environ["WYRO_API_KEY"])

post = wyro.posts.create(
    {"text": "…", "platforms": ["instagram"], "media": [{"url": "https://…/a.jpg"}]},
    idempotency_key=str(uuid.uuid4()),
)
print(post["status"], post["preview_url"])

for p in wyro.posts.iterate():
    print(p["id"], p["status"])
```

## Qué incluyen

- **Posts**: crear, consultar, listar (con paginación por `next_cursor` o un iterador), reprogramar, cancelar y `bulk(csv, { dryRun })` para un CSV. **Cola**: consultar, configurar y próximos horarios libres. **Claves limitadas**: crear, listar y revocar.
- **Cuentas**: listar y desconectar. **Conectar**: el link para conectar una cuenta real.
- **Métricas**: `posts.metrics(id)`, `accounts.metrics(id, rango)` y `analytics.overview(rango)`.
- **Medios**: subida directa (hasta 4 MB) y un helper para la subida prefirmada de archivos más grandes.
- **Webhooks**: configurar, consultar, borrar y `verifySignature(secret, timestamp, body, signature)`.
- **Partners**: crear, listar, consultar y borrar espacios de clientes, rotar su clave y `forClient(externalId)` para actuar por un cliente con tu token de partner:

```ts
const client = wyro.forClient("client-123"); // partner token + X-Wyro-External-Id
await client.posts.create({ text: "…", platforms: ["linkedin"] });
```

- **Errores** como una excepción tipada (`WyroError`) con `code`, `message`, `fix`, `status` y `details` ([catálogo](https://wyroapi.com/docs/errores)).
- **Reintentos** ante `429` y `5xx`, respetando `Retry-After` ([límites](https://wyroapi.com/docs/limites)); las creaciones solo se reintentan si pasas un `idempotencyKey` ([idempotencia](https://wyroapi.com/docs/idempotencia)).

## Verificar un webhook

```ts
import { verifySignature } from "@wyroapi/sdk";

const ok = verifySignature(secret, req.headers["x-wyro-timestamp"], rawBody, req.headers["x-wyro-signature"]);
```
