Skrull-JSON

Brings shapeshifting abilities to your JSON data.

Skrull is a lightweight, efficient JavaScript utility for transforming JSON structures based on a given mapping. It provides a simple way to reshape JSON data

When should you use it?

When data schema in your system (S0) is different than multiple extenral systems S1, S2, ...Sn and you need to repeatedly transform data when interacting with these external systems. Example - Integrating with Multiple Partners.

Features

• Flexible JSON Transformation: Transform JSON structures based on custom mapping rules.
• Nested Field Support: Easily map nested fields in your JSON data.
• Array Handling: Handles JSON arrays gracefully during the transformation process.
• Data Manipulation: Supports manipulation of data fields, such as concatenating fields.

Installation

Install TransformJson using npm:

npm install skrull-json

Example Usage

Import the Package

import transformJson from "skrull-json";

Basic Transformation

const inputJson = {
  name: "Harsh",
  age: "13"
};

const outputFormatJson = {
  username: "",
  userAge: "",
};

const mappingJson = {
  "name": "username",
  "age": "userage"
};

Output

{
  "username": "Harsh",
  "userAge": "13"
}

Support for Nested Structures - 1

const inputJson = {
  user: {
    name: "Harsh",
    age: "13"
  }
};

const outputFormatJson = {
  username: "",
  userAge: "",
};

const mappingJson = {
  "user.name": "username",
  "user.age": "userAge"
};

Output

{
  "username": "Harsh",
  "userAge": "13"
}

Support for Nested Structures - 2

const inputJson = {
    name: "Harsh",
    age: "13",
    contact: {
        email: "[email protected]",
        phone:"1234"
    }
};

const outputFormatJson = {
  user: {
    name:"",
    contact: {
        userEmail: "",
        userPhone: ""
    }
  }
};

const mappingJson = {
  "name": "user.name",
  "contact.email": "user.contact.userEmail",
  "contact.phone": "user.contact.userPhone"
};

Output

{
  user: {
    name: 'Harsh',
    contact: { userEmail: '[email protected]', userPhone: '1234' }
  }
}

Support for Array

const inputJson = {
  user: [
    {
      firstName: "John",
      lastName: "Wick",
      age: 30,
      address: {
        street: "123 Elm St",
        city: "Somewhere",
      },
    },
  ],
};

const outputFormatJson = {
  name: "",
  userAge: "",
  userAddress: {
    streetName: "",
    city: "",
  },
};

const mappingJson = {
  "user[0].firstName": "name",
  "user[0].age": "userAge",
  "user[0].address.street": "userAddress.streetName",
  "user[0].address.city": "userAddress.city",
};

Output

{
  name: 'John',
  userAge: 30,
  userAddress: { streetName: '123 Elm St', city: 'Somewhere' }
}

Support for Data Manipulation

const inputJson = {
  user:
    {
      firstName: "John",
      lastName: "Wick"
    }
};

const outputFormatJson = {
  fullName: "",
};

const mappingJson = {
  "{user.firstName} {user.lastName}": "fullName",
};

Output

{
  name: 'John Wick',
}