# sap-test-legacy-webhook

Receptor de prueba para probar [`sap-legacy-webhook-emulator`](../sap-legacy-webhook-emulator)
sin necesitar una instancia real de `sap-webhook-api` — mismo comportamiento
núcleo (recibe el `POST` con el CloudEvent, guarda cada notificación como
`.json` en `data/events/`), pero sin framework y **sin autenticación por
ahora**.

✅ Verificado de punta a punta contra un SAP Business One sobre HANA real:
capturó y guardó correctamente un evento real de `Items`
(`sap.b1.Items.Updated.v1`), tanto en HTTP como en HTTPS con certificado
autofirmado.

## Quick start

```bash
npm install
cp .env.example .env   # PORT, default 4100
npm start
```

Después, dar de alta una suscripción en `sap-legacy-webhook-emulator`
apuntando acá:

```bash
cd ../sap-legacy-webhook-emulator
npx tsx scripts/manage-subscriptions.ts subscription:add <webhookId> http://127.0.0.1:4100/webhooks/sap
npx tsx scripts/manage-subscriptions.ts filter:add <webhookId> <BizObject> <TransType> <ObjectType>
npm run run-once
```

Los eventos recibidos quedan en `data/events/<id>.json` (uno por
notificación, nombrado por el `id` del CloudEvent).

## HTTP / HTTPS

```bash
npm start          # autodetecta: HTTPS si existen certs/*.pem, si no HTTP
npm run start:http  # fuerza HTTP, ignora los certs aunque existan
npm run start:https # fuerza HTTPS — error claro si faltan los certs
```

HTTPS usa un certificado autofirmado. Sirve para probar el caso real (SAP
suele usar certificados autofirmados) y confirmar que el dispatcher los
acepta bien (ya ignora la validación de certificado —
`rejectUnauthorized: false`, ver
`sap-legacy-webhook-emulator/src/dispatcher/send-webhook.ts`).

Regenerar el certificado:

```bash
openssl req -x509 -newkey rsa:2048 -keyout certs/key.pem -out certs/cert.pem \
  -days 3650 -nodes -subj "/CN=127.0.0.1" \
  -addext "subjectAltName=DNS:localhost,IP:127.0.0.1"
```

Con HTTPS activo, la suscripción apunta a `https://127.0.0.1:4100/webhooks/sap`
en vez de `http://...`. Para cambiar la URL de una suscripción que ya
existe (sin recrearla) al pasar de HTTP a HTTPS o viceversa:

```bash
cd ../sap-legacy-webhook-emulator
npx tsx scripts/manage-subscriptions.ts subscription:update-url <webhookId> https://127.0.0.1:4100/webhooks/sap
```

## Pendiente (a propósito, no es un olvido)

Sin autenticación por ahora. Si más adelante hace falta probar HMAC,
agregar en `src/server.ts` la misma verificación que ya tiene
`sap-webhook-api/src/webhooks/webhooks.controller.ts` (`X-B1-Webhook-Signature`,
HMAC-SHA256 sobre el body crudo, activada solo si existe
`HMAC_SECRET_KEY`).

## Stack

Node/TypeScript puro (`node:http`, sin framework), ejecutado con `tsx` —
mismo criterio de simplicidad que el resto de los proyectos de prueba de
este workspace.