xcomanche/icdn

[![Build Status](https://travis-ci.org/rkxtd/icdn.svg?branch=master)](https://travis-ci.org/rkxtd/icdn)
[![Coverage Status](https://coveralls.io/repos/github/rkxtd/icdn/badge.svg?branch=master)](https://coveralls.io/github/rkxtd/icdn?branch=master)
[![npm version](http://img.shields.io/npm/v/icdn.svg?style=flat)](https://www.npmjs.com/package/icdn "View this project on npm")
[![Maintainability](https://api.codeclimate.com/v1/badges/689675c1c6d30a3befe9/maintainability)](https://codeclimate.com/github/rkxtd/icdn/maintainability)
[![Test Coverage](https://api.codeclimate.com/v1/badges/689675c1c6d30a3befe9/test_coverage)](https://codeclimate.com/github/rkxtd/icdn/test_coverage)
[![dependencies Status](https://david-dm.org/rkxtd/icdn/status.svg)](https://david-dm.org/rkxtd/icdn)
[![devDependencies Status](https://david-dm.org/rkxtd/icdn/dev-status.svg)](https://david-dm.org/rkxtd/icdn?type=dev)
[![bundle size](https://img.shields.io/bundlephobia/min/icdn.svg)](https://bundlephobia.com/result?p=icdn)
![](https://img.shields.io/npm/dt/icdn.svg)
![](https://img.shields.io/github/issues/rkxtd/icdn.svg)
![](https://img.shields.io/npm/l/icdn.svg)
![](https://img.shields.io/github/last-commit/rkxtd/icdn.svg)

# icdn - dynamic image resizer with cdn options
Provides easy to use middleware, which will embed into your ecosystem and provide flexible image resizing options.
All the requested images with allowed sizes and resolutions, will be created on fly, and than saved for future usage directly from static folder.

Basically algorithm is following:
1. Hit the server with image url with desired image resolution (ex: `https://yourdomain.com/trains/1024x0/megaTrain.png`)
1. Static server verifies if such image exists in path:  `public_folder/trains/1024x0/megaTrain.png`
    - if yes - hit it directly from static folder
    - if no - ask image resizer to perform image resizing
1. Resize Image
    - Read file from base `src` folder by a path `src/trains/megaTrain.png`
    - Resize file
    - Write file to `public_folder/trains/1024x0/megaTrain.png`
1. Redirect to `originalUrl` with `301` status code: (ex: `https://yourdomain.com/trains/1024x0/megaTrain.png`)

## Integrations
So far we do have few integrations:
* `express.js`
* `fastify.js`
* `vanilla.js`

But much more are coming! In particular:
* `AWS CloudFront` + `AWS Lambda` integration
* `GCP Cloud CDN` + `GCP Functions` integration