@peaksite/api
v0.2.0
Published
Peaksite app geliştirme kiti (Node.js): Admin GraphQL istemcisi, OAuth, oturum anahtarı (EdDSA/JWKS) ve webhook doğrulama. Bağımlılıksız.
Downloads
592
Readme
@peaksite/api
Peaksite app'leri için Node.js kiti (bağımlılıksız, Node 20+). PHP karşılığı: peaksite/peaksite-php.
| | |
|---|---|
| AdminClient | Admin GraphQL API — mutation'larda otomatik Idempotency-Key, ağ hatası/429/409'da aynı anahtarla tekrar, tipli hatalar |
| SessionTokenVerifier | App Bridge oturum anahtarı: EdDSA + JWKS (Node crypto) |
| verifyWebhook / signWebhook | X-Peaksite-Signature (zaman damgalı, iki anahtar) |
| OAuth | yetki adresi + PKCE, dönüş hmac'i, kod → anahtar, token exchange |
import { AdminClient, verifyWebhook } from '@peaksite/api';
const client = new AdminClient({ shop: 'lavanta.peaksite.io', accessToken });
await client.mutate(ADJUST, { i: input }, { idempotencyKey: `trendyol-${lineId}` }); // aynı satış iki kez → tek düşüm
const event = verifyWebhook(req.headers, rawBody, [process.env.PEAKSITE_WEBHOOK_SECRET]);