# my-encrypter-middleware

> encrypter for server and client

Latest version **1.0.14** (published 2021-06-15) · ISC license · 0 weekly downloads

## Install

```sh
npm install my-encrypter-middleware
pnpm add my-encrypter-middleware
yarn add my-encrypter-middleware
bun add my-encrypter-middleware
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.14 |
| Published | 2021-06-15 |
| First published | 2021-06-12 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 10.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Maintainers | martincolts |

## Links

- npm: https://www.npmjs.com/package/my-encrypter-middleware
- Repository: https://github.com/martincolts/my-encrypter-middleware
- Homepage: https://github.com/martincolts/my-encrypter-middleware#readme
- Issues: https://github.com/martincolts/my-encrypter-middleware/issues
- npm.io page: https://npm.io/package/my-encrypter-middleware

## Dependencies (1)

- [crypto-js](https://npm.io/package/crypto-js.md) ^4.0.0

## Recent versions

- 1.0.14 (latest) — 2021-06-15
- 1.0.13 — 2021-06-15
- 1.0.12 — 2021-06-14
- 1.0.11 — 2021-06-14
- 1.0.10 — 2021-06-14
- 1.0.9 — 2021-06-14
- 1.0.8 — 2021-06-13
- 1.0.7 — 2021-06-13
- 1.0.6-beta — 2021-06-13
- 1.0.6 — 2021-06-12
- 1.0.5 — 2021-06-12
- 1.0.4 — 2021-06-12
- 1.0.3 — 2021-06-12
- 1.0.2 — 2021-06-12
- 1.0.1 — 2021-06-12
- … 1 more at https://npm.io/package/my-encrypter-middleware/versions

## README

# My Encryption Middleware

The goal of this library is to provide a mechanism to transfer encrypted data through the net, to do that it provides tools to encrypt the **body** and also a **middleware** to decrypt in an express application.

This library uses AES (Advanced Encryption Standard) for encryption.

## Instalation

You can install this library with ```npm``` executing

```sh
npm install --save my-encrypter-middleware
```

## Middleware

### How to use it.

The middleware is going to decrypt the data if we send it in a body within a ```data``` field. Example:

```js
{
    'data': 'encrypted body hash'
}
```



The following example is to configure it in an [express](https://expressjs.com/) application:

```js
import { middleware } from 'my-encrypter-middleware';

const app = express();
const port = 3000;

app.use(express.json());

app.use(middleware('my key'));

app.listen(port);
```

Notice that you can provide your key, for this example is ```'my key'```

## Encrypter

### How to use it

To use the encrypter (client-side) you  need to import it and instantiate it as following:

```js
import { cipherInstance } from 'my-encrypter-middleware';

const cipher = cipherInstance('my key');
```

Keep in mind that you need to add the encryption in a body that has the ```data``` field with the encryption in it.

Example:

```js
const bodyToEncrypt = {
    ...
}

{
    'data': cipher.encrypt(bodyToEncrypt);
}
```
The following example is for an axios call:

```js
import { encryptBody } from 'my-encrypter-middleware';

const objectToEncrypt = {
    'data': 'some data',
    'list': ['one', 'two', 'three']
}

const encrypted = encryptBody(objectToEncrypt, 'my key')

console.log(encrypted);

const response = axios.post('http://localhost:3000', {'data': encrypted})
.then(response => {
    console.log(response.data);
});
```


# Contribute

How can you contribute to this package? To do it you can create a pull request to this [repository](https://github.com/martincolts/my-encrypter-middleware)

## Testing

Currently, this repo has unit and integration tests. The unit test covers the cipher encryption and decryption and the integration test is using the middleware in an express application and the cipher to encrypt the body, testing a post the check the integrity of the library.

Before push changes you can create and run test with the following command:

```sh
npm test
```

Also, you can run the test with a docker image, to do that you can execute the following command.

```sh
docker build -t my-encryption-middleware . && docker run -it my-encryption-middleware
```

Feel free to change the image tag whatever you want.

---
_Source: https://npm.io/package/my-encrypter-middleware · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._