static_dist.js

var fss = require('../fs_extras.js'),
	Q = require('q'),
	path = require('path'),
	md5 = require('md5'),
	promiseLock = require("../promise_lock"),
	npm = require("enpeem"),
	fs = require("fs-extra"),
	_ = require("lodash");

var queue = promiseLock(),
	buildHash = require("./build_hash"),
	remove = Q.denodeify(fs.remove);

/**
 * @module {function} bit-docs-generate-html/build/static_dist
 * @parent bit-docs-generate-html/modules
 *
 * Builds a static distributable which will eventually be copied
 * to the `static` folder of the generated output.
 *
 * @signature `.build.staticDist(options)`
 *
 * Builds the static distributable with the following steps:
 *
 * 1. Copies everything from _documentjs/site/default/static_ to
 *    _documentjs/site/static/build_.
 * 2. Copies the path in `options.dest` to _documentjs/site/static/build_.
 * 3. `require`s the module at _documentjs/site/static/build/build.js_.
 * 4. Calls that "build" module function with the options and returns the result.
 *
 * The "build" module is expected to build a minified distributable
 * and copy the necessary contents to _documentjs/site/static/dist_ and
 * return a promise that resolves when complete.
 *
 * @param {{}} options
 *
 * @option {Boolean} [forceBuild=false] If set to `true`, rebuilds the
 * static bundle even if it has already been built.
 *
 * @option {String} dest The final destination ouput of the static
 * distributable.
 *
 * @option {String} static The location of static content used to overwrite or
 * add to the default static content.
 *
 * @option {Boolean} [minifyBuild=true] If set to `false` the build will not
 * be minified. This behavior should be implemented by the "build" module.
 *
 * @return {Promise} A promise that resolves if the static dist was successfully created.
 *
 */
module.exports = function(options){
	// only run one build at a time.
	return queue(function(){
		var builtAlready;

		var hash = buildHash(options);

		var distFolder = path.join("site","static","dist", hash),
			buildFolder = path.join("site","static","build", hash);

		var mkdirPromise = Q.all([
			fss.mkdirs(distFolder),
			fss.mkdirs(buildFolder)
		]);

		return mkdirPromise.then(function(){
			return fss.exists(path.join(distFolder,"bundles","bit-docs-site","static.css"))
			.then(function(exists){
				// If we have already built, don't build again
				if(exists && !options.forceBuild) {
					builtAlready = true;
					if(options.debug) {
						console.log("BUILD: Using cache",distFolder);
					}

					return;
				}

				return fss.copy(path.join("site","default","static"), buildFolder)
				.then(function(){
					if(options["static"]){
						return fss.copyFrom(options["static"], buildFolder);
					}
				});
			});
		}).then(function(){
			if(builtAlready){
				return;
			}

			return addPackages(options, buildFolder).then(function(){
				if(options.forceBuild) {
					return deletePackages(options, buildFolder, distFolder, hash);
				}
			}).then(function(){
				return installPackages(options, buildFolder, distFolder, hash);
			});
		}).then(function(){
			return {buildFolder: buildFolder, distFolder: distFolder};
		});
	});

};

var readFile = Q.denodeify(fs.readFile),
	writeFile = Q.denodeify(fs.writeFile);

function addPackages(siteConfig, buildFolder) {
	if(siteConfig.html && siteConfig.html.dependencies) {
		var fullBuildFolderPath = path.join(__dirname,"..", buildFolder);

		return readFile(path.join(fullBuildFolderPath, "package.json")).then(function(packageContents){
			var json = JSON.parse(packageContents);
			var filePathedDeps = siteConfig.html.dependencies;

			for(var depName in siteConfig.html.dependencies) {
				var possibleFilePath = siteConfig.dependencies[depName];

				if (_.startsWith(possibleFilePath,'file:')) {
					filePathedDeps[depName] = possibleFilePath;
				}
			}

			json.dependencies = _.assign(json.dependencies || {},filePathedDeps);

			return writeFile( path.join(fullBuildFolderPath, "package.json"), JSON.stringify(json) ).then(function(){

				var deps = _.map(filePathedDeps, function(version, packageName){
					return '"'+packageName+'": callIfFunction( require("'+packageName+'") )';
				});


				var src = callIfFunction.toString() + "\nmodule.exports = {\n\t"+deps.join(",\n\t")+"};";

				return writeFile( path.join(fullBuildFolderPath, "packages.js"), src);
			});
		});
	} else {
		return Q.fcall(function () {});
	}
}
function deletePackages(options, buildFolder, distFolder, hash) {
	var fullBuildNodeModulesPath = path.join(__dirname,"..", buildFolder,"node_modules");
	return remove(fullBuildNodeModulesPath);
}
function installPackages(options, buildFolder, distFolder, hash){
	var fullBuildFolderPath = path.join(__dirname,"..", buildFolder);

	if(options.debug) {
		console.log("BUILD: Installing packages");
	}
	var deferred = Q.defer();
	npm.install({
		dir: fullBuildFolderPath,
		dependencies: [],
		loglevel: options.debug ? "info" : "silent"
	}, function(err){
		if(err) {
			deferred.reject(err);
		} else {
			deferred.resolve();
		}
	});

	return deferred.promise.then(function(){
		if(options.debug) {
			console.log("BUILD: Getting build module");
		}

		var build = require("../site/static/build/"+hash+"/build.js");
		return build(options,{
			dist: distFolder,
			build: buildFolder
		});
	});
}


function callIfFunction(value){
  if(typeof value === "function") {
	value();
  }
  return value;
}