GitHub Release Summary - v1.0.0
π contentstack-webhook-verify v1.0.0 - Initial Release
A secure Node.js library for verifying Contentstack webhook authenticity
π Key Features
- β Cryptographic Signature Verification using Contentstack's public keys
- β Replay Attack Prevention with configurable time windows
- β Multi-Region Support (NA, EU, AZZURE-NA, AZZURE-EU, GCP-NA, GCP-EU)
- β Full TypeScript Support with comprehensive type definitions
- β Zero Dependencies for minimal footprint
- β Modern ES Module architecture
π Security First
- Validates webhook signatures against Contentstack's public keys
- Prevents replay attacks with timestamp validation
- Comprehensive input validation and error handling
- Production-ready security measures
π οΈ Developer Experience
- TypeScript with strict type checking
- Framework Agnostic - works with Express.js, Next.js, AWS Lambda
- Comprehensive Documentation with real-world examples
- Professional Build Pipeline with ESLint, Prettier, Husky
π¦ Installation
npm install contentstack-webhook-verifyβ‘ Quick Start
import verify from 'contentstack-webhook-verify';
app.post('/webhook', async (req, res) => {
try {
await verify(req.headers['x-contentstack-request-signature'], req.body);
res.status(200).send('β
Verified');
} catch (error) {
res.status(401).send('β Unauthorized');
}
});π Documentation
- Complete README - Installation, usage, examples
- API Reference - Full API documentation
- Contributing Guide - Development setup
π Multi-Framework Support
- Express.js - Middleware integration
- Next.js - API route examples
- AWS Lambda - Serverless compatibility
- Any Node.js framework - Framework agnostic design
π― Perfect For
- Content management systems
- Webhook-driven workflows
- Real-time content synchronization
- Enterprise security compliance
- Serverless webhook processors
Ready to secure your Contentstack webhooks? Get started now! π
npm install contentstack-webhook-verify