Socket
Book a DemoInstallSign in
Socket

nuxt-webhook-validators

Package Overview
Dependencies
Maintainers
1
Versions
22
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

nuxt-webhook-validators

A simple nuxt module that works on the edge to easily validate incoming webhooks from different services.

0.2.3
latest
Source
npmnpm
Version published
Weekly downloads
248
17.54%
Maintainers
1
Weekly downloads
 
Created
Source

webhook-validators

Nuxt Webhook Validators

npm version npm downloads License Nuxt Modules

A simple nuxt module that works on the edge to easily validate incoming webhooks from different services.

  • ✨ Release Notes

Features

Requirements

This module only works with a Nuxt server running as it uses server API routes (nuxt build).

This means that you cannot use this module with nuxt generate.

Quick Setup

  • Add nuxt-webhook-validators in your Nuxt project
npx nuxi@latest module add webhook-validators
  • Add the module in your nuxt.config.ts
export default defineNuxtConfig({
  modules: [
    'nuxt-webhook-validators'
  ],
})

Server utils

The validator helpers are auto-imported in your server/ directory.

Webhook Validators

All validator helpers are exposed globally and can be used in your server API routes.

The helpers return a boolean value indicating if the webhook request is valid or not.

The config can be defined directly from the runtimeConfig in your nuxt.config.ts:

export default defineNuxtConfig({
  runtimeConfig: {
    webhook: {
      <provider>: {
        <requiredProps>: '',
      }
    }
  }
})

It can also be set using environment variables:

NUXT_WEBHOOK_<PROVIDER>_<REQUIRED_PROPERTY> = ""

Go to playground/.env.example or playground/nuxt.config.ts to see a list of all the available properties needed for each provider.

Supported webhook validators:

  • Discord
  • Dropbox
  • Fourthwall
  • GitHub
  • GitLab
  • Heroku
  • Hygraph
  • Kick
  • MailChannels
  • Meta
  • NuxtHub
  • Paddle
  • PayPal
  • Polar
  • Resend
  • Shopify
  • Stripe
  • Svix
  • Twitch

You can add your favorite webhook validator by creating a new file in src/runtime/server/lib/validators/

Example

Validate a GitHub webhook in a server API route.

~/server/api/webhooks/github.post.ts

export default defineEventHandler(async (event) => {
  const isValidWebhook = await isValidGitHubWebhook(event)

  if (!isValidWebhook) {
    throw createError({ statusCode: 401, message: 'Unauthorized: webhook is not valid' })
  }

  // Some logic...

  return { isValidWebhook }
})

Development

# Install dependencies
npm install

# Generate type stubs
npm run dev:prepare

# Develop with the playground
npm run dev

# Build the playground
npm run dev:build

# Run ESLint
npm run lint

# Run Vitest
npm run test
npm run test:watch

# Run typecheck
npm run test:types

# Release new version
npm run release

Keywords

nuxt

FAQs

Package last updated on 06 Aug 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

About

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc

U.S. Patent No. 12,346,443 & 12,314,394. Other pending.