extended faucetDispatch to report completion of the initial build

this allows independent API consumers to perform operations at the end
of the pipeline

Author: FND

CHANGELOG.md

@@ -2,6 +2,19 @@ faucet-pipeline-core version history
 ====================================
 
 
+v3.1.0
+------
+
+_2025-10-29_
+
+no significant changes for end users
+
+notable changes for developers:
+
+* `faucetDispatch` now has a return value which reports completion of the
+  initial build
+
+
 v3.0.0
 ------
 

lib/index.js

@@ -36,7 +36,7 @@ exports.faucetDispatch = async function faucetDispatch(referenceDir, config,
 			then(buildStep(buckets.scripts.concat(buckets.styles))).
 			then(buildStep(buckets.markup));
 	});
-	runner.run();
+	let res = runner.run();
 
 	if(watch) {
 		makeWatcher(config.watchDirs, referenceDir).
@@ -55,6 +55,8 @@ exports.faucetDispatch = async function faucetDispatch(referenceDir, config,
 	} else if(liveserve) {
 		server.live(liveserve, assetManager.manifest.webRoot);
 	}
+
+	return res; // notifies consumers once the initial build has completed
 };
 
 function buildStep(plugins) {