feat(build): Initial code and build changes.

Initial import of the code and updates to the build system.

Author: Alexandru Badiu

.babelrc

@@ -0,0 +1,9 @@
+{
+  "presets": [
+    ["env", {
+      "targets": {
+        "node": true
+      }
+    }]
+  ]
+}

.gitignore

@@ -57,3 +57,4 @@ typings/
 # dotenv environment variables file
 .env
 
+.DS_Store

README.md

@@ -0,0 +1,153 @@
+[![Stories in Ready](https://badge.waffle.io/voidberg/imagecache.png?label=ready&title=Ready)](https://waffle.io/voidberg/imagecache)
+[![Latest release on NPM](https://img.shields.io/npm/v/imagecache.svg)](https://www.npmjs.com/package/imagecache)
+[![Codeship Status for voidberg/imagecache](https://img.shields.io/codeship/0de31e00-4b12-0133-f672-7236a2d50232.svg)](https://codeship.com/projects/106113)
+[![codecov.io](http://codecov.io/github/voidberg/imagecache/coverage.svg?branch=master)](http://codecov.io/github/voidberg/imagecache?branch=master)
+[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
+[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
+[![David-dm.org](https://david-dm.org/voidberg/imagecache.svg)](https://david-dm.org/voidberg/imagecache#info=dependencies&view=table)
+[![David-dm.org](https://david-dm.org/voidberg/imagecache/dev-status.svg)](https://david-dm.org/voidberg/imagecache#info=devDependencies&view=table)
+[![MIT License](https://img.shields.io/npm/l/imagecache.svg)](https://opensource.org/licenses/MIT)
+
+#Imagecache
+---
+
+## What is it?
+
+Node image generation module based on CamanJS and inspired by Drupal's image styles.
+
+## Installation
+
+### Linux prerequisites
+* `aptitude install libcairo-dev libgif-dev libjpeg-dev`
+
+### Mac OS X prerequisites
+
+It's quite painful, be warned.
+
+* Install X Server (http://xquartz.macosforge.org/trac/wiki/X112.7.6).
+* Install X Code (https://itunes.apple.com/gb/app/xcode/id497799835?mt=12) and command line tools.
+* Install Homebrew (https://github.com/Homebrew/homebrew/wiki/Installation).
+* `export PKG_CONFIG_PATH=/opt/X11/lib/pkgconfig`.
+* Install Cairo from source: `brew install --build-from-source cairo`.
+
+## Usage
+
+```
+var presets = require('./presets.js');
+var ImageCache = require('imagecache');
+
+var imagecache = new ImageCache(presets);
+
+imagecache.render('./in.png', 'preset_one', function (err, image) {
+  // Save the image
+  image.save('out_s_crop_teaser.png');
+
+  // or
+
+  // Get a buffer, stream it etc
+  image.canvas.toBuffer();
+})
+```
+
+## Presets structure
+
+```
+{
+  preset_one: {
+    presetname: 'preset_one',
+    actions: [
+      {
+        action: 'scale_and_crop',
+        config: {
+          width: 100,
+          height: 300
+        }
+      },
+      {
+        action: 'define_canvas',
+        config: {
+          color: '#333333',
+          exact: {
+            width: 400,
+            height: 400,
+            xpos: 'center',
+            ypos: 'center'
+          }
+        }
+      }
+    ]
+  },
+  preset_two: {
+    presetname: 'preset_two',
+    actions: [
+      {
+        action: 'scale_and_crop',
+        config: {
+          width: 70,
+          height: 70,
+        }
+      }
+    ]
+  }
+}
+```
+
+### Creating plugins
+Breeze is used for plugin management. There are two types of plugins available:
+
+* Utility plugins that add functions to be used by other plugins. For example see `plugins/_converters.js` that adds utility functions for parsing parameters that are used by all other plugins.
+* Action plugins that expose one or more functions that implement actions.
+
+For example, a plugin that implements the sharpen action will attach a sharpen function to the plugin registry. The function signature is `image, config, callback` where `image` is the `CamanJS` object, `config` is the action configuration from the preset and `callback` is the function that triggers the completion of the action.
+
+```
+var self = module.exports = {
+  attach: function (options) {
+    this.sharpen = function (image, config, callback) {
+      var value = this.convertInt(config.value);
+
+      if (value > 100) {
+        value = 100;
+      }
+      if (value < 0) {
+        value = 0;
+      }
+
+      image.sharpen(value);
+      callback();
+    };
+  }
+};
+```
+
+##Imagecache actions:
+
+
+* Brightness [✓]
+* Crop [✓]
+* Define canvas [✓]
+* Desaturate [✓]
+* Negative image [✓]
+* Resize [✓]
+* Scale [✓]
+* Scale and crop [✓]
+* Sharpen [✓]
+* Contrast [✓]
+* Clip [✓]
+* Colorize [✓]
+* Exposure [✓]
+* Gamma [✓]
+* Hue [✓]
+* Noise [✓]
+* Saturation [✓]
+* Sepia [✓]
+* Vibrance [✓]
+* Curves [✓]
+* Overlay (watermark) [✓]
+* CamanJS filters (vintage, lomo, clarity, sinCity, sunrise, crossProcess, orangePeel, love, grungy, jarques, pinhole, oldBoot, glowingSun, hazyDays, herMajesty, nostalgia, hemingway, concentrate) [✓]
+
+Legend:
+
+* [✓] - Implemented
+* [✗] - Will not be implemented
+* [] - Not implemented yet

dist/index.js

@@ -0,0 +1,100 @@
+import { readdirSync, accessSync, constants } from 'fs';
+import { resolve } from 'path';
+import sharp from 'sharp';
+import async from 'async';
+
+module.exports = class ImageCache {
+  /**
+   * constructor() returns a new ImageCache
+   * instance with a list of presets.
+   *
+   * @param {Object} presets
+   * @return {ImageCache} instance
+   */
+  constructor(presets) {
+    this.presetsConfiguration = presets;
+    this.actions = {};
+    this.pluginNames = [];
+
+    readdirSync(resolve(__dirname, './plugins/')).forEach(file => {
+      let name;
+      let plugin;
+
+      if (file.match(/.+\.js/g) !== null && file !== 'index.js') {
+        name = file.replace('.js', '');
+        plugin = require(`./plugins/${file}`); // eslint-disable-line
+
+        plugin.attach(this);
+        this.pluginNames.push(name);
+      }
+    });
+  }
+
+  /**
+   * presets() returns a list
+   * of all available presets.
+   *
+   * @return {Array} list of presets
+   */
+  presets() {
+    return Object.getOwnPropertyNames(this.presetsConfiguration);
+  }
+
+  /**
+   * plugins() returns a list
+   * of all available plugins.
+   *
+   * @return {Array} list of plugins
+   */
+  plugins() {
+    return this.pluginNames;
+  }
+
+  /**
+   * render() renders an image
+   * using the supplied preset.
+   *
+   * @param {String} image
+   * @param {String} presetName
+   * @param {String} callback
+   */
+  render(image, presetName, callback) {
+    // try {
+    //   accessSync(image, constants.R_OK);
+    // } catch (imageErr) {
+    //   return callback(new Error(`File ${image} does not exist or is inaccesible.`));
+    // }
+
+    if (!this.presetsConfiguration[presetName]) {
+      return callback(new Error(`Preset ${presetName} could not be found.`));
+    }
+
+    const preset = this.presetsConfiguration[presetName];
+    let sharpInstance;
+
+    try {
+      sharpInstance = sharp(image);
+    } catch (sharpErr) {
+      callback(sharpErr);
+    }
+
+    let metadata = {};
+
+    return sharpInstance.metadata().then(info => {
+      metadata = info;
+
+      async.each(preset.actions, (action, asyncCallback) => {
+        if (!this.actions[action.action]) {
+          return asyncCallback(new Error(`Action ${action.action} for preset ${presetName} not found in loaded plugins.`));
+        }
+
+        return this.actions[action.action](sharpInstance, metadata, action.config || {}, (err, processed) => {
+          sharpInstance = processed;
+          asyncCallback(err);
+        });
+      }, err => callback(err, sharpInstance));
+    }).catch(err => {
+      return callback(err);
+    });
+  }
+};

dist/plugins/_converters.js

@@ -0,0 +1,40 @@
+/* eslint no-bitwise: ["error", { "allow": ["~"] }] */
+const S = require('string');
+
+module.exports = {
+  attach: function attach(app) {
+    app.actions.convertBoolean = value => S(value).toBool();
+
+    app.actions.convertFloat = value => S(value).toFloat();
+
+    app.actions.convertInt = value => S(value).toInt();
+
+    app.actions.convertDimension = (value, maxDimension) => {
+      let converted;
+
+      if (S(value).endsWith('%')) {
+        converted = ~~(maxDimension * S(value).replace('%', '').toInt() / 100);
+      } else {
+        converted = S(value).toInt();
+      }
+
+      return converted;
+    };
+
+    app.actions.convertPosition = (value, maxPosition, imageSize = 0) => {
+      let converted;
+
+      if (value === 'left' || value === 'top') {
+        converted = 0;
+      } else if (value === 'center') {
+        converted = ~~(maxPosition / 2) - ~~(imageSize / 2);
+      } else if (value === 'right' || value === 'bottom') {
+        converted = maxPosition;
+      } else {
+        converted = app.actions.convertDimension(value, maxPosition);
+      }
+
+      return converted;
+    };
+  }
+};

dist/plugins/blur.js

@@ -0,0 +1,9 @@
+module.exports = {
+  attach: function attach(app) {
+    app.actions.blur = (image, metadata, config, callback) => {
+      const blur = config.blur || 1;
+
+      return callback(undefined, image.sharpen(blur));
+    };
+  }
+};

dist/plugins/define_canvas.js

@@ -0,0 +1,24 @@
+import sharp from 'sharp';
+
+module.exports = {
+  attach: function attach(app) {
+    app.actions.define_canvas = (image, metadata, config, callback) => {
+      const canvas = sharp(null, {
+        create: {
+          width: config.width,
+          height: config.height,
+          channels: config.channels || 4,
+          background: config.color || '#ffffff00'
+        }
+      });
+
+      const options = {
+        gravity: config.gravity,
+        tile: config.tile || false,
+        cutout: config.cutout || false
+      };
+
+      return image.toBuffer().then(buffer => callback(undefined, canvas.overlayWith(buffer, options)));
+    };
+  }
+};

dist/plugins/file.js

@@ -0,0 +1,15 @@
+module.exports = {
+  attach: function attach(app) {
+    app.actions.file = (image, metadata, config, callback) => {
+      const filepath = config.path;
+
+      const options = {
+        gravity: config.gravity,
+        tile: config.tile || false,
+        cutout: config.cutout || false
+      };
+
+      return callback(undefined, image.overlayWith(filepath, options));
+    };
+  }
+};

dist/plugins/flip.js

@@ -0,0 +1,13 @@
+module.exports = {
+  attach: function attach(app) {
+    app.actions.flip = (image, metadata, config, callback) => {
+      const axis = config.axis || 'y';
+
+      if (axis === 'y') {
+        return callback(undefined, image.flip());
+      }
+
+      return callback(undefined, image.flop());
+    };
+  }
+};

dist/plugins/gamma.js

@@ -0,0 +1,9 @@
+module.exports = {
+  attach: function attach(app) {
+    app.actions.gamma = (image, metadata, config, callback) => {
+      const gamma = config.gamma || 2.2;
+
+      return callback(undefined, image.gamma(gamma));
+    };
+  }
+};