Joiful – The Ultimate Validation Library for Modern Node.js Applications

Introduction to Joiful

Joiful is a powerful and flexible validation library for Node.js, designed to help developers quickly and easily validate their data models and ensure data integrity within their applications. With a simple and intuitive API, Joiful makes validation a breeze, allowing you to focus on building your application rather than writing boilerplate validation code.

Getting Started

To get started with Joiful, first install it using npm or yarn:

npm install joiful

yarn add joiful

Defining Models and Validations

Joiful uses decorators to define validation rules. Here’s a simple example:

  const jf = require('joiful');

  class User {
    @(jf.string().required())
    name;

    @(jf.number().min(18).max(30).required())
    age;

    @(jf.string().email().required())
    email;
  }

Validating Data

Once you have defined your model, you can easily validate instances of that model:

  const user = new User();
  user.name = 'John Doe';
  user.age = 25;
  user.email = 'john.doe@example.com';

  const { error } = jf.validate(user);

  if (error) {
    console.error(error.details);
  } else {
    console.log('Validation successful!');
  }

Advanced Validations

Joiful offers a variety of validators to handle more complex requirements:

  class Product {
    @(jf.string().regex(/^[a-zA-Z0-9]+$/).required())
    sku;

    @(jf.number().greater(0).required())
    price;

    @(jf.string().valid('in stock', 'out of stock', 'discontinued').required())
    status;
  }

Custom Validators

Joiful allows you to create custom validation rules using the custom() method:

  class Address {
    @(jf.string().custom((value) => {
      // Custom validation logic
      if (value.startsWith('P.O. Box')) {
        return 'P.O. Boxes are not allowed';
      }
    }).required())
    addressLine;
  }

Building a Simple Application

Here is an example of a simple Express.js application using Joiful for validation:

  const express = require('express');
  const jf = require('joiful');
  const app = express();
  app.use(express.json());

  class User {
    @(jf.string().required())
    name;

    @(jf.number().min(18).max(30).required())
    age;

    @(jf.string().email().required())
    email;
  }

  app.post('/users', (req, res) => {
    const { error } = jf.validateAsClass(req.body, User);

    if (error) {
      return res.status(400).send(error.details);
    }

    // Proceed with creating the user
    res.status(201).send('User created successfully');
  });

  app.listen(3000, () => {
    console.log('Server is running on port 3000');
  });

Joiful is a powerful tool that can greatly simplify your data validation process in Node.js applications, making your code more maintainable and error-free.

Hash: 1bfa6eb7b9dd9e5c657f333ce52093e6810ebd667e5d37936e74149a6160b699