Serverless v1.0 plugin that uses Browserify to bundle NodeJS Lambda functions. 

rynop

serverless-plugin-browserify

      this.serverless.cli.log('SlsBrowserify::globalConfig');

    const globalCustom = this.serverless.service.custom.browserify || {};

    const globalCustom = (this.serverless.service.custom && this.serverless.service.custom.browserify) || {};

      throw new this.serverless.classes.Error('custom.browserify.disable is true in serverless.yml', 'skip');

    let globalDefault = {  //Browserify plugin config

      disable: false, //Not an official option, used as internal option to skip browserify

      exclude: [],    //Not an option, but will use for setting browserify.exclude() if defined in yml

      ignore:  [],    //Not an option, but will use for setting browserify.ignore() if defined in yml

      basedir:          this.serverless.config.servicePath,

      browserField:     false,  // Setup for node app (copy logic of --node in bin/args.js)

      ignoreMissing:    true,  // Do not fail on missing optional dependencies

      detectGlobals:    true,  // We don't care if its slower, we want more mods to work

      insertGlobalVars: {      // Handle process https://github.com/substack/node-browserify/issues/1277

        //__filename: insertGlobals.lets.__filename,

        //__dirname: insertGlobals.lets.__dirname,

    this.globalBrowserifyConfig = xtend(globalDefault, globalCustom);

    //Merge together package.exclude and custom.browserify.exclude

    if (this.serverless.service.package) {

      if (this.serverless.service.package.exclude && this.serverless.service.package.exclude.length) {

        this.globalBrowserifyConfig.exclude = _.union(this.serverless.service.package.exclude, this.globalBrowserifyConfig.exclude);

      console.log('computed globalBrowserifyConfig', this.globalBrowserifyConfig);

   * Merge the global base configuration with given lambda function contextual configuration

    const functionObject         = this.serverless.service.getFunction(functionName);

    let functionBrowserifyConfig = xtend(this.globalBrowserifyConfig, functionObject.browserify || {});

    if (functionBrowserifyConfig.disable) {

      throw new this.serverless.classes.Error('browserify.disable is true on this function in serverless.yml', 'skip');

      console.log(`functionObject for ${functionName}`, functionObject);

    if (!functionBrowserifyConfig.entries.length) {

      const bundleEntryPt              = functionObject.handler.split('.')[0] + '.js';

      functionBrowserifyConfig.entries = [bundleEntryPt];

      //Merge together functions.FUNCTION.package.exclude and browserify exclude

      if (functionObject.package.exclude && functionObject.package.exclude.length) {

        functionBrowserifyConfig.exclude = _.union(functionBrowserifyConfig.exclude, functionObject.package.exclude);

      console.log('computed function BrowserifyConfig', functionBrowserifyConfig);

  "name": "serverless-plugin-browserify",

  "description": "Serverless v1.0 plugin that uses Browserify to bundle NodeJS Lambda functions.",

  "author": "Ryan Pendergast <ryan.pendergast@gmail.com> (http://rynop.com)",

    "url": "git+https://github.com/doapp-ryanp/serverless-plugin-browserify.git"

    "url": "https://github.com/doapp-ryanp/serverless-plugin-browserify/issues"

  "homepage": "https://github.com/doapp-ryanp/serverless-plugin-browserify#readme",

**NOTE:** This plugin is waiting on merge and release of https://github.com/serverless/serverless/pull/2561

[![serverless](http://public.serverless.com/badges/v3.svg)](http://www.serverless.com)

A [Serverless](https://serverless.com) v1.0 plugin that uses [Browserify](https://github.com/substack/node-browserify) to bundle your NodeJS Lambda functions.

**Why?** Lambda's with smaller code start and run faster.  Lambda also has an account wide [deployment package size limit](http://docs.aws.amazon.com/lambda/latest/dg/limits.html).  

[aws-sdk-js](https://github.com/aws/aws-sdk-js) now officially [supports browserify](https://github.com/aws/aws-sdk-js/issues/696).  Read more about why this kicks ass [on my blog](https://rynop.wordpress.com/2016/11/01/aws-sdk-for-javascript-now-fully-componentized/).

With the example `package.json` and javascript code below, the default packaging for NodeJs lambdas in Serverless produces a zip file that is **11.3 MB**, because it blindly includes all of `node_modules` in the zip.

This plugin with 2 lines of configuration produces a zip file that is **400KB!**

npm install serverless-plugin-browserify --save-dev

Add the plugin to your `serverless.yml` file and set `package.individually` to `true`:

`package.individually` is required because it makes configuration more straight forward, and if you are not packaging individually size is not a concern of yours in the 1st place.

For most use cases you should **NOT** need to do any configuration.  If you are a code ninja, read on.

The base config for browserify is read from the `custom.browserify` section of `serverless.yml`.  All [browserify options](https://github.com/substack/node-browserify#browserifyfiles--opts) are supported (most are auto configured by this plugin).  This plugin adds one special option `disable` which if `true` will bypass this plugin.

The base config can be over-ridden on a function by function basis.  Again `custom.browserify` is not required and should not even need to be defined in most cases.

    #any option defined in https://github.com/substack/node-browserify#browserifyfiles--opts

      name: ${self:provider.stage}-${self:service}-pageGet

          - ./someBig.json  #browserify can't optimize json, will take long time to parse for nothing      

**Note:** `package.include` is ignored when using this plugin.  This is a foreign concept in Browserify, every use case I've ever run across can be handled by leveraging [browserify options](https://github.com/substack/node-browserify#browserifyfiles--opts). 

When this plugin is enabled, and `package.individually` is `true`, running `serverless deploy` and `serverless deploy -f <funcName>` will automatically browserify your node lambda code.

If you want to see output of bundled file or zip simply set `SLS_DEBUG`.  Ex (using [Fish Shell](https://fishshell.com)): `env SLS_DEBUG=true sls deploy function -v -f usersGet`

Also check out the [examples](./examples) directory

Run `serverless browserify -f <functionName>`.  You can optionally dictate where the bundling output dir is by using the `-o` flag. Ex: `sls browserify -o /tmp/test -f pageUpdate`.

- **Should I use Webpack instead of this plugin?** I prefer Browserify over [webpack](https://webpack.github.io/) because I have found it supports more modules, optimizes better, and requires less configuration.

- **Why is UglifyJS not built-in?** No ES6 support.  [Issue](https://github.com/mishoo/UglifyJS2/issues/448) been open since 2014.

- **My code is not bundling correctly** The bundled code is always stored in a tmp dir on your computer.  Set `SLS_DEBUG=true` then re-run your command to output the directory.  Fish Shell ex: `env SLS_DEBUG=true sls browserify`  

		{
		"name": "serverless-plugin-browserify",
		"version": "1.0.1",
		"version": "1.0.2",
		"description": "Serverless v1.0 plugin that uses Browserify to bundle NodeJS Lambda functions.",
		@@ -5,0 +5,0 @@ "main": "index.js",

		@@ -15,3 +15,3 @@ 'use strict';

		const globalCustom = this.serverless.service.custom.browserify \|\| {};
		const globalCustom = (this.serverless.service.custom && this.serverless.service.custom.browserify) \|\| {};

		@@ -18,0 +18,0 @@ if (globalCustom.disable) {

		# Serverless Browserify Plugin

		NOTE: This plugin is waiting on merge and release of https://github.com/serverless/serverless/pull/2561

		[![serverless](http://public.serverless.com/badges/v3.svg)](http://www.serverless.com)
		@@ -6,0 +4,0 @@

Worsened metrics