whet 0.0.9 → 0.0.12

package/bin/whet/Stone.d.ts

@@ -1,4 +1,5 @@
 import {StoneIdType} from "./magic/StoneId"
+import {MaybeArray} from "./magic/MaybeArray"
 import {CacheManager} from "./cache/CacheManager"
 import {CacheStrategy} from "./cache/Cache"
 import {SourceHash} from "./SourceHash"
@@ -35,7 +36,9 @@ export declare class Stone<T extends StoneConfig> {
 	getSource(): Promise<Source>
 	
 	/**
-	Hash of this stone with its current config. Defaults to hash of generated source.
+	* **Do not override.**
+	* Hash of this stone with its current config. Defaults to hash of generated source.
+	* Hashes of dependency stones (see `config.dependencies`) will be added to the hash.
 	*/
 	getHash(): Promise<SourceHash>
 	
@@ -72,7 +75,8 @@ export declare class Stone<T extends StoneConfig> {
 	* @param path
 	* If `path` is a directory, stores the file(s) under that path, using their standard names.
 	* If `path` is a file and this stone generates only single data source, stores it under the supplied path.
-	* @param generate If true (default), the source is exported right away.
+	* @param generate If true (default), the source is exported right away. Will not re-save the file, if it already
+	* exists under the same path and hash.
 	*/
 	setAbsolutePath(path: string, generate?: boolean): Promise<Source>
 	
@@ -95,6 +99,17 @@ export declare class Stone<T extends StoneConfig> {
 export type StoneConfig = {
 	cacheStrategy?: null | CacheStrategy, 
 	/**
+	* Registers another stone(s) as dependency of this one. Useful for external processes
+	* that use a source of some stone, but don't go via Whet to get it.
+	* Use with combination of `setAbsolutePath` on the dependency, so that the external process
+	* can rely on a fixed path.
+	* Will make sure the cached file is up to date when generating this stone.
+	* Hash of the dependency is automatically combined with hash generated by this stone. There's no
+	* need to add it manually.
+	* Do not create cyclic dependencies!
+	*/
+	dependencies?: null | MaybeArray<AnyStone>, 
+	/**
 	Defaults to the Stone's class name.
 	*/
 	id?: null | StoneIdType, 

package/bin/whet/Stone.js

@@ -1,4 +1,5 @@
 import {StoneId_Fields_} from "./magic/StoneId.js"
+import {MaybeArray_Fields_} from "./magic/MaybeArray.js"
 import {CacheStrategy, CacheDurability} from "./cache/Cache.js"
 import {Utils} from "./Utils.js"
 import {SourceId, RootDir} from "./SourceId.js"
@@ -58,7 +59,9 @@ class Stone extends Register.inherits() {
 	}
 	
 	/**
-	Hash of this stone with its current config. Defaults to hash of generated source.
+	* **Do not override.**
+	* Hash of this stone with its current config. Defaults to hash of generated source.
+	* Hashes of dependency stones (see `config.dependencies`) will be added to the hash.
 	*/
 	getHash() {
 		var _gthis = this;
@@ -68,7 +71,17 @@ class Stone extends Register.inherits() {
 				return hash;
 			} else {
 				return _gthis.getSource().then(function (s) {
-					return s.hash;
+					if (_gthis.config.dependencies != null) {
+						var _g = [];
+						var _g1 = 0;
+						var _g2 = MaybeArray_Fields_.makeArray(_gthis.config.dependencies);
+						while (_g1 < _g2.length) _g.push(_g2[_g1++].getHash());
+						return Promise.all(_g).then(function (hashes) {
+							return s.hash.add(SourceHash.merge(...hashes));
+						});
+					} else {
+						return Promise.resolve(s.hash);
+					};
 				});
 			};
 		});
@@ -82,24 +95,36 @@ class Stone extends Register.inherits() {
 	generateSource(hash) {
 		var _gthis = this;
 		Log.log(20, ...["Generating source.", {"stone": this, "hash": hash}]);
-		var dataPromise = this.generate(hash);
-		if (dataPromise != null) {
-			return dataPromise.then(function (data) {
-				if (hash == null) {
-					var result = new Array(data.length);
-					var _g = 0;
-					var _g1 = data.length;
-					while (_g < _g1) {
-						var i = _g++;
-						result[i] = SourceHash.fromBytes(data[i].data);
-					};
-					hash = SourceHash.merge(...result);
-				};
-				return new Source(data, hash, _gthis, Date.now() / 1000);
-			});
+		var init;
+		if (this.config.dependencies != null) {
+			var _g = [];
+			var _g1 = 0;
+			var _g2 = MaybeArray_Fields_.makeArray(this.config.dependencies);
+			while (_g1 < _g2.length) _g.push(_g2[_g1++].getSource());
+			init = Promise.all(_g);
 		} else {
-			return null;
+			init = Promise.resolve(null);
 		};
+		return init.then(function (_) {
+			var dataPromise = _gthis.generate(hash);
+			if (dataPromise != null) {
+				return dataPromise.then(function (data) {
+					if (hash == null) {
+						var result = new Array(data.length);
+						var _g = 0;
+						var _g1 = data.length;
+						while (_g < _g1) {
+							var i = _g++;
+							result[i] = SourceHash.fromBytes(data[i].data);
+						};
+						hash = SourceHash.merge(...result);
+					};
+					return new Source(data, hash, _gthis, Date.now() / 1000);
+				});
+			} else {
+				return null;
+			};
+		});
 	}
 	
 	/**
@@ -134,7 +159,8 @@ class Stone extends Register.inherits() {
 	* @param path
 	* If `path` is a directory, stores the file(s) under that path, using their standard names.
 	* If `path` is a file and this stone generates only single data source, stores it under the supplied path.
-	* @param generate If true (default), the source is exported right away.
+	* @param generate If true (default), the source is exported right away. Will not re-save the file, if it already
+	* exists under the same path and hash.
 	*/
 	setAbsolutePath(path, generate) {
 		if (generate == null) {

package/bin/whet/Whet.js

@@ -10,7 +10,7 @@ const $global = Register.$global
 export const Whet_Fields_ = Register.global("$hxClasses")["whet._Whet.Whet_Fields_"] = 
 class Whet_Fields_ {
 	static main() {
-		Whet_Fields_.program.enablePositionalOptions().passThroughOptions().description("Project tooling.").usage("[options] [command] [+ [command]...]").version("0.0.9", "-v, --version").allowUnknownOption(true).showSuggestionAfterError(true).option("-p, --project <file>", "project to run", "Project.mjs").option("-l, --log-level <level>", "log level, a string/number", "info");
+		Whet_Fields_.program.enablePositionalOptions().passThroughOptions().description("Project tooling.").usage("[options] [command] [+ [command]...]").version("0.0.12", "-v, --version").allowUnknownOption(true).showSuggestionAfterError(true).option("-p, --project <file>", "project to run", "Project.mjs").option("-l, --log-level <level>", "log level, a string/number", "info");
 		Whet_Fields_.program.parse();
 		var options = Whet_Fields_.program.opts();
 		if (options.logLevel != null) {

package/bin/whet/cache/CacheManager.d.ts

@@ -19,6 +19,11 @@ export declare class CacheManager {
 	defaultFileStrategy: CacheStrategy
 	getSource(stone: AnyStone): Promise<Source>
 	
+	/**
+	* Re-generates source even if the currently cached value is valid.
+	*/
+	refreshSource(stone: AnyStone): Promise<Source>
+	
 	/**
 	* Get valid directory to generate files in. The path is unique per stone based on caching rules.
 	* If hash is supplied, and a path was already assigned, the same path is returned, assuring consistency.

package/bin/whet/cache/CacheManager.js

@@ -47,6 +47,30 @@ class CacheManager extends Register.inherits() {
 		};
 	}
 	
+	/**
+	* Re-generates source even if the currently cached value is valid.
+	*/
+	refreshSource(stone) {
+		Log.log(10, ...["Re-generating cached stone.", {"stone": stone}]);
+		switch (stone.cacheStrategy._hx_index) {
+			case 0:
+				return stone.generateHash().then(function (hash) {
+					return stone.generateSource(hash);
+				});
+				break
+			case 1:
+				return this.memCache.get(stone, CacheDurability.MaxAge(-1), DurabilityCheck.SingleOnGet);
+				break
+			case 2:
+				return this.fileCache.get(stone, CacheDurability.MaxAge(-1), DurabilityCheck.SingleOnGet);
+				break
+			case 3:
+				return this.fileCache.get(stone, CacheDurability.MaxAge(-1), DurabilityCheck.SingleOnGet);
+				break
+			
+		};
+	}
+	
 	/**
 	* Get valid directory to generate files in. The path is unique per stone based on caching rules.
 	* If hash is supplied, and a path was already assigned, the same path is returned, assuring consistency.

package/bin/whet/stones/Files.d.ts

@@ -1,7 +1,7 @@
 import {StoneIdType} from "../magic/StoneId"
 import {MaybeArray} from "../magic/MaybeArray"
 import {CacheStrategy} from "../cache/Cache"
-import {Stone} from "../Stone"
+import {Stone, AnyStone} from "../Stone"
 import {SourceHash} from "../SourceHash"
 import {SourceData} from "../Source"
 import {Project} from "../Project"
@@ -15,6 +15,17 @@ export declare class Files extends Stone<FilesConfig> {
 export type FilesConfig = {
 	cacheStrategy?: null | CacheStrategy, 
 	/**
+	* Registers another stone(s) as dependency of this one. Useful for external processes
+	* that use a source of some stone, but don't go via Whet to get it.
+	* Use with combination of `setAbsolutePath` on the dependency, so that the external process
+	* can rely on a fixed path.
+	* Will make sure the cached file is up to date when generating this stone.
+	* Hash of the dependency is automatically combined with hash generated by this stone. There's no
+	* need to add it manually.
+	* Do not create cyclic dependencies!
+	*/
+	dependencies?: null | MaybeArray<AnyStone>, 
+	/**
 	Defaults to the Stone's class name.
 	*/
 	id?: null | StoneIdType, 

package/bin/whet/stones/JsonStone.d.ts

@@ -2,7 +2,7 @@ import {StoneIdType} from "../magic/StoneId"
 import {RouteType} from "../magic/RouteType"
 import {MaybeArray} from "../magic/MaybeArray"
 import {CacheStrategy} from "../cache/Cache"
-import {Stone} from "../Stone"
+import {Stone, AnyStone} from "../Stone"
 import {SourceHash} from "../SourceHash"
 import {SourceData} from "../Source"
 import {Project} from "../Project"
@@ -21,6 +21,17 @@ export declare class JsonStone extends Stone<JsonStoneConfig> {
 export type JsonStoneConfig = {
 	cacheStrategy?: null | CacheStrategy, 
 	/**
+	* Registers another stone(s) as dependency of this one. Useful for external processes
+	* that use a source of some stone, but don't go via Whet to get it.
+	* Use with combination of `setAbsolutePath` on the dependency, so that the external process
+	* can rely on a fixed path.
+	* Will make sure the cached file is up to date when generating this stone.
+	* Hash of the dependency is automatically combined with hash generated by this stone. There's no
+	* need to add it manually.
+	* Do not create cyclic dependencies!
+	*/
+	dependencies?: null | MaybeArray<AnyStone>, 
+	/**
 	Defaults to the Stone's class name.
 	*/
 	id?: null | StoneIdType, 

package/bin/whet/stones/RemoteFile.d.ts

@@ -1,6 +1,7 @@
 import {StoneIdType} from "../magic/StoneId"
+import {MaybeArray} from "../magic/MaybeArray"
 import {CacheStrategy} from "../cache/Cache"
-import {Stone} from "../Stone"
+import {Stone, AnyStone} from "../Stone"
 import {SourceHash} from "../SourceHash"
 import {SourceData} from "../Source"
 import {Project} from "../Project"
@@ -17,6 +18,17 @@ export declare class RemoteFile extends Stone<RemoteFileConfig> {
 export type RemoteFileConfig = {
 	cacheStrategy?: null | CacheStrategy, 
 	/**
+	* Registers another stone(s) as dependency of this one. Useful for external processes
+	* that use a source of some stone, but don't go via Whet to get it.
+	* Use with combination of `setAbsolutePath` on the dependency, so that the external process
+	* can rely on a fixed path.
+	* Will make sure the cached file is up to date when generating this stone.
+	* Hash of the dependency is automatically combined with hash generated by this stone. There's no
+	* need to add it manually.
+	* Do not create cyclic dependencies!
+	*/
+	dependencies?: null | MaybeArray<AnyStone>, 
+	/**
 	Defaults to the Stone's class name.
 	*/
 	id?: null | StoneIdType, 

package/bin/whet/stones/Server.d.ts

@@ -1,7 +1,8 @@
 import {Router} from "../route/Router"
 import {StoneIdType} from "../magic/StoneId"
+import {MaybeArray} from "../magic/MaybeArray"
 import {CacheStrategy} from "../cache/Cache"
-import {Stone} from "../Stone"
+import {Stone, AnyStone} from "../Stone"
 import {SourceHash} from "../SourceHash"
 import {SourceData} from "../Source"
 import {Project} from "../Project"
@@ -26,6 +27,17 @@ export declare class Server extends Stone<ServerConfig> {
 export type ServerConfig = {
 	cacheStrategy?: null | CacheStrategy, 
 	/**
+	* Registers another stone(s) as dependency of this one. Useful for external processes
+	* that use a source of some stone, but don't go via Whet to get it.
+	* Use with combination of `setAbsolutePath` on the dependency, so that the external process
+	* can rely on a fixed path.
+	* Will make sure the cached file is up to date when generating this stone.
+	* Hash of the dependency is automatically combined with hash generated by this stone. There's no
+	* need to add it manually.
+	* Do not create cyclic dependencies!
+	*/
+	dependencies?: null | MaybeArray<AnyStone>, 
+	/**
 	Defaults to the Stone's class name.
 	*/
 	id?: null | StoneIdType, 

package/bin/whet/stones/Server.js

@@ -98,26 +98,25 @@ class Server extends Register.inherits(Stone) {
 				id = (HxOverrides.cca(s, 0) == 47) ? s : "/" + s;
 			};
 			this.config.router.find(id).then(function (routeResult) {
-				var sourcePromise = (routeResult.length > 0) ? routeResult[0].get() : (_gthis.routeDynamic != null) ? _gthis.routeDynamic(id) : null;
-				if (sourcePromise != null) {
-					sourcePromise.then(function (source) {
-						res.writeHead(200, {"Content-Type": Mime.getType(Path.posix.extname(id).toLowerCase()), "Last-Modified": new Date(source.source.ctime * 1000).toUTCString(), "Content-Length": Std.string(source.data.length), "Cache-Control": "no-store, no-cache"});
-						res.write(source.data, "binary");
+				return ((routeResult.length > 0) ? routeResult[0].get() : (_gthis.routeDynamic != null) ? _gthis.routeDynamic(id) : Promise.resolve(null)).then(function (source) {
+					if (source == null) {
+						res.writeHead(404, "File not found.");
 						res.end();
-					})["catch"](function (e) {
-						Log.log(40, ...["Server error.", {"error": e}]);
-						res.writeHead(500, "Error happened.");
-						if (((e) instanceof Error)) {
-							res.write(e.stack, "utf-8");
-						} else {
-							res.write(Std.string(e), "utf-8");
-						};
-						res.end();
-					});
-				} else {
-					res.writeHead(404, "File not found.");
+						return;
+					};
+					res.writeHead(200, {"Content-Type": Mime.getType(Path.posix.extname(id).toLowerCase()), "Last-Modified": new Date(source.source.ctime * 1000).toUTCString(), "Content-Length": Std.string(source.data.length), "Cache-Control": "no-store, no-cache"});
+					res.write(source.data, "binary");
 					res.end();
-				};
+				})["catch"](function (e) {
+					Log.log(40, ...["Server error.", {"error": e}]);
+					res.writeHead(500, "Error happened.");
+					if (((e) instanceof Error)) {
+						res.write(e.stack, "utf-8");
+					} else {
+						res.write(Std.string(e), "utf-8");
+					};
+					res.end();
+				});
 			})["catch"](function (e) {
 				Log.log(40, ...["Server error.", {"error": e}]);
 				res.writeHead(500, "Error happened.");

package/bin/whet/stones/Zip.d.ts

@@ -1,7 +1,8 @@
 import {StoneIdType} from "../magic/StoneId"
 import {RoutePathType} from "../magic/RoutePathType"
+import {MaybeArray} from "../magic/MaybeArray"
 import {CacheStrategy} from "../cache/Cache"
-import {Stone} from "../Stone"
+import {Stone, AnyStone} from "../Stone"
 import {SourceHash} from "../SourceHash"
 import {SourceData} from "../Source"
 import {Project} from "../Project"
@@ -16,6 +17,17 @@ export declare class ZipStone extends Stone<ZipConfig> {
 
 export type ZipConfig = {
 	cacheStrategy?: null | CacheStrategy, 
+	/**
+	* Registers another stone(s) as dependency of this one. Useful for external processes
+	* that use a source of some stone, but don't go via Whet to get it.
+	* Use with combination of `setAbsolutePath` on the dependency, so that the external process
+	* can rely on a fixed path.
+	* Will make sure the cached file is up to date when generating this stone.
+	* Hash of the dependency is automatically combined with hash generated by this stone. There's no
+	* need to add it manually.
+	* Do not create cyclic dependencies!
+	*/
+	dependencies?: null | MaybeArray<AnyStone>, 
 	filename?: null | string, 
 	/**
 	Defaults to the Stone's class name.

package/bin/whet/stones/haxe/HaxeBuild.d.ts

@@ -1,7 +1,8 @@
 import {Hxml} from "./Hxml"
 import {StoneIdType} from "../../magic/StoneId"
+import {MaybeArray} from "../../magic/MaybeArray"
 import {CacheStrategy} from "../../cache/Cache"
-import {Stone} from "../../Stone"
+import {Stone, AnyStone} from "../../Stone"
 import {SourceHash} from "../../SourceHash"
 import {SourceData} from "../../Source"
 import {Project} from "../../Project"
@@ -22,6 +23,17 @@ export declare class HaxeBuild extends Stone<BuildConfig> {
 
 export type BuildConfig = {
 	cacheStrategy?: null | CacheStrategy, 
+	/**
+	* Registers another stone(s) as dependency of this one. Useful for external processes
+	* that use a source of some stone, but don't go via Whet to get it.
+	* Use with combination of `setAbsolutePath` on the dependency, so that the external process
+	* can rely on a fixed path.
+	* Will make sure the cached file is up to date when generating this stone.
+	* Hash of the dependency is automatically combined with hash generated by this stone. There's no
+	* need to add it manually.
+	* Do not create cyclic dependencies!
+	*/
+	dependencies?: null | MaybeArray<AnyStone>, 
 	filename?: null | string, 
 	hxml: Hxml, 
 	/**

package/bin/whet/stones/haxe/HaxeBuild.js

@@ -93,7 +93,7 @@ class HaxeBuild extends Register.inherits(Stone) {
 	addCommands() {
 		var _gthis = this;
 		this.project.addCommand("build", this).action(function (..._) {
-			return _gthis.build();
+			return _gthis.project.cache.refreshSource(_gthis);
 		});
 	}
 	list() {

package/bin/whet/stones/haxe/Hxml.d.ts

@@ -2,7 +2,7 @@ import {HaxeBuild} from "./HaxeBuild"
 import {StoneIdType} from "../../magic/StoneId"
 import {MaybeArray} from "../../magic/MaybeArray"
 import {CacheStrategy} from "../../cache/Cache"
-import {Stone} from "../../Stone"
+import {Stone, AnyStone} from "../../Stone"
 import {SourceHash} from "../../SourceHash"
 import {SourceData} from "../../Source"
 import {Project} from "../../Project"
@@ -34,6 +34,17 @@ export type HxmlConfig = {
 	dce?: null | DCE, 
 	debug?: null | boolean, 
 	defines?: null | MaybeArray<string>, 
+	/**
+	* Registers another stone(s) as dependency of this one. Useful for external processes
+	* that use a source of some stone, but don't go via Whet to get it.
+	* Use with combination of `setAbsolutePath` on the dependency, so that the external process
+	* can rely on a fixed path.
+	* Will make sure the cached file is up to date when generating this stone.
+	* Hash of the dependency is automatically combined with hash generated by this stone. There's no
+	* need to add it manually.
+	* Do not create cyclic dependencies!
+	*/
+	dependencies?: null | MaybeArray<AnyStone>, 
 	flags?: null | MaybeArray<MaybeArray<string>>, 
 	/**
 	Defaults to the Stone's class name.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "whet",
-    "version": "0.0.9",
+    "version": "0.0.12",
     "description": "NodeJS based assets management and project tooling library.",
     "scripts": {
         "devinit": "npx dts2hx commander --modular --noLibWrap",