bsn validator

Install

npm

npm install @cuteminded/bsn-validator

CDN

<script src="https://cdn.jsdelivr.net/npm/@cuteminded/bsn-validator/dist/index.global.js"></script>

Quick Start

JavaScript

const { isValidBSN, generateFakeBSN } = require("@cuteminded/bsn-validator");
const input = "123456782";
const fakeBSN = generateFakeBSN();

if (isValidBSN(input)) {
  console.log("Valid BSN");
}

console.log(fakeBSN);

TypeScript / ESM

import { isValidBSN, generateFakeBSN } from "@cuteminded/bsn-validator";

const input = "123456782";
const fakeBSN = generateFakeBSN();

if (isValidBSN(input)) {
  console.log("Valid BSN");
}

console.log(fakeBSN);

CDN

<script src="https://cdn.jsdelivr.net/npm/@cuteminded/bsn-validator/dist/index.global.js"></script>
<script>
  const input = "123456782";
  const fakeBSN = bsnValidator.generateFakeBSN();

  if (bsnValidator.isValidBSN(input)) {
    console.log("Valid BSN");
  }

  console.log(fakeBSN);
</script>

API

isValidBSN(bsn: string): boolean

Validates a BSN using the Dutch 11-check.

Rules:

• Accepts only 8 or 9 digits.
• Ignores leading/trailing spaces.
• Returns true when the number passes the 11-check, otherwise false.

generateFakeBSN(): string

Generates a fake BSN-like value intended for testing and development.

Notes:

• Generated values may coincide with a real BSN they are not guaranteed to be fictitious.
• The generated values are primarily intended for testing the application you are developing, not for real identity or production workflows.

Use Cases

• Form input validation for Dutch BSN fields.
• Backend request validation before processing.
• Creating mock BSN data for tests and demos.

References

• Check digit overview
• Citizen service number (BSN)

License

MIT