tileblaster 1.0.10 → 1.0.13

package/builtins/convert.js

@@ -0,0 +1,58 @@
+// convert
+module.exports = function convert({ opts, data }, next){
+	const sharp = this.lib.sharp;
+	const debug = this.lib.debug;
+
+	// check if sharp is available
+	if (typeof sharp === "undefined") {
+		debug.warn("Convert: Sharp dependency is missing.");
+		return next();
+	};
+
+	// check if the tile should be converted
+	if (!["png","jpeg","jpg","gif","webp","avif","heif"].includes(data.tile.type)) {
+		debug.warn("Convert: Unsupported file type: %s", data.tile.type);
+		return next();
+	};
+
+	Promise.allSettled(["jpeg","png"].map(function(method){
+		return new Promise(function(resolve, reject) {
+			if (!opts[method]) return reject();
+
+			// copy primary tile
+			const tile = { ...data.tile };
+
+			// fixme: find suitable tile in tiles
+			sharp(tile.buffer).toFormat(method, opts[method]).toBuffer(function(err, buffer, info){
+				if (err) {
+					debug.error("Convert: %s", err);
+					return reject();
+				};
+
+				// fix tile
+				tile.buffer = buffer;
+				tile.type = method;
+				tile.mimetype = "image/"+method;
+				tile.headers = { ...tile.headers };
+
+				// remove main tile from stack
+				data.tiles = data.tiles.filter(t=>(t.path!==tile.path));
+
+				// add to tile stack
+				data.tiles.unshift(tile);
+
+				// add as main tile
+				data.tile = tile;
+
+				debug.info("Converted '%s'", tile.path.magenta);
+
+				resolve();
+
+			});
+
+		});
+	})).then(function(){
+		next();
+	});
+
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tileblaster",
-  "version": "1.0.10",
+  "version": "1.0.13",
   "description": "a quick and versatile map tile caching proxy",
   "main": "tileblaster.js",
   "bin": {

package/tileblaster.js

@@ -33,7 +33,7 @@ const tileblaster = module.exports = function tileblaster(config){
 
 	// load builtins
 	self.builtins = {};
-	self.loadBuiltins([ "cors", "parse", "check", "noop", "tileserver", "versatiles", "pmtiles", "mbtiles", "edit", "compress", "cache", "deliver", "dump", "modernize", "optimize", "sharp" ]);
+	self.loadBuiltins([ "cors", "parse", "check", "noop", "tileserver", "versatiles", "pmtiles", "mbtiles", "edit", "compress", "cache", "deliver", "dump", "modernize", "optimize", "convert", "sharp" ]);
 
 	// assemble task lists for maps
 	self.maps = {};

package/docs/config.md

@@ -1,345 +0,0 @@
-# tileblaster configuration
-
-tileblaster configuration lives in a javascript (common js) file, that exports an object containing the configuration.
-
-## Example
-
-See [config.dist.js](./config.dist.js)
-
-## Properties
-
-#### `version`
-
-config file format version. Always `1` fro now.
-
-#### `id`
-
-id of the tileblaster instance, in case you want to run more than one; default: `tileblaster`
-
-#### `treads`
-
-number of worker threads in cluster, default: 1
-
-#### `queue`
-
-number of concurrently processed tiles per worker, default: 12
-
-#### `server.url`
-
-public url including subdirectory
-
-#### `server.mount`
-
-mountpoint override, default: pathname of `config.paths.url`
-
-#### `paths.work`
-
-the base directory where files (sockets, logs, plugins, ...) go; default: `~/tileblaster`
-
-#### `paths.data`
-
-the directory in which cached tiles are saved; default: `${config.paths.work}/data`
-
-#### `paths.logs`
-
-the directory in which cached tiles are saved; default: `${config.paths.work}/logs`
-
-#### `paths.plugins`
-
-the directory from which plugins ar loaded; default: `${config.paths.work}/plugins`
-
-#### `paths.sockets`
-
-the directory i nwhich sockets are created; default: `${config.paths.work}/sockets`
-
-### `listen`
-
-an array of server listen configurations. these contain either `port` or `socket`
-
-``` js
-listen: [{
-	port: 8080, // required
-	host: "localhost", // default localhost
-},{
-	socket: "test.socket", // required, absolute path or relative to ${config.paths.socket}
-	mode: 0o660, // change socket mode to this id
-	group: 1000, // change socket group to this is
-}],
-```
-
-### `plugins`
-
-plugins, relative or absolute paths for local files, npm module names otherwise
-
-``` js
-plugins: {
-	resize: "./resize.js", // relative path, starting with ./
-	convert: "/path/to/convert.js", // absolute path
-	optimize: "someplugin", // npm module
-},
-```
-
-### `maps`
-
-each property of this object represents a map and its workflow. the workflow is an array
-of `builtin` and `plugin` directives, that get processed in the order of their definition.
-
-``` js
-{
-	// a map with id "example"
-	example: [{
-		// a builtin directive, processed first
-		builtin: "something",
-		// ...
-	},{
-		// a plugin directive, processed second
-		plugin: "some-plugin",
-		// ...
-	},{
-		// ...
-	}],
-	anoterMap: {
-		// ...
-	}
-}
-```
-
-### Builtins
-
-#### `cors`
-
-Send [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) Headers to the client. Can be limited by Origin.
-You should do this in your reverse proxy though.
-
-``` js
-{
-	builtin: "cors",
-	origins: [ "https://example.org/" ],
-	// origins: [ "*" ], // ← allow anyone
-}
-```
-
-#### `parse`
-
-Parse a client request. You can override this with your own parse function in case
-your client requires the use of a non-standard request uri or uses GET/POST data or whatever.
-
-``` js
-{
-	builtin: "parse", // /z/x/y@r.ext, other formats need plugins; set params and dest
-	parse: function(req, next){ // override parse function, req is the raw request
-		// do things to get parameters from path
-		next(null, {
-			params: { param: "1" }, // deliver parameters
-			dest: "/path/to/tile/{param}/{param}/blub.{e}{c}", // template for destination
-		});
-	},
-}
-```
-
-#### `check`
-
-Limits request dependent on parameters. You can deny access to tiles to certain zoom levels,
-within a bounding box, to specific extensions and densities, or use your own check function.
-
-``` js
-{
-	builtin: "check",
-	zoom: [ 0, 22 ], // min, max
-	bbox: [ -180, -90, 180, 90 ], // west, south, east, north
-	extensions: [ "png", "jpeg" ], // allowed extensions
-	density: [ "", "@2x", "@3x" ], // allowed density markeers
-	check: function(params, fn) { // override check function, params from parse
-		fn(new Error("Check failed")); // deliver error if check failed
-	},
-	status: 204, // http status code delivered on fail; default: 204
-	hints: false, // send `x-tileblaster-hint` header with error message
-}
-```
-
-#### `cache`
-
-Local tile cache.
-
-##### Retrieve cached tiles
-
-When no main tile is availabe, try to load it from cache.
-
-``` js
-{
-	builtin: "cache",
-	skipto: "deliver", // skip to this builtin when tile loaded from cache
-}
-```
-
-##### Store tiles
-
-If a tile is set, store it in the local cache.
-
-``` js
-{
-	builtin: "cache",
-	expires: "30d", // duration or seconds or `true` or `false`
-}
-```
-
-* `expires: 300` - Expires after this amount of seconds
-* `expires: "5y 2w 1d 5h 30m 4s"` - Expires after this [duration](https://www.npmjs.com/package/dur#user-content-time-units)
-* `expires: false` - Expires never
-* `expires: true` - Expires instantly
-
-#### `noop`
-
-Does nothing and has no real purpose.
-
-#### `tileserver`
-
-Fetch a tile from a tileserver via http(s).
-
-``` js
-{
-	builtin: "tileserver",
-	url: "https://{s}.tileserver.example/test/{z}/{x}/{y}{r}.{e}",
-	subdomains: [ "a", "b", "x" ], // random chosen and passed in as {s}
-	tms: true, // y coordinate is inverted
-	headers: {}, // additional headers sent to the backend tileserver
-	status: [ 200 ], // expected status code(s)
-	mimetypes: [ "image/png", "image/jpeg" ], // expected mime types
-	mimetype: "image/png", // overwrite mime type from server
-}
-```
-
-#### `versatiles`
-
-Fetch a tile from a local or remote [versatiles](https://versatiles.org) container.
-
-*Pro Tip:* Don't pay MapBox or "Open"MapTiles for limited access to Open Data! You can get completely free Vectortiles in [Shortbread Schema](https://shortbread.geofabrik.de/schema/) at [download.versatiles.org](https://download.versatiles.org/).
-
-``` js
-{
-	// get tile from versatiles container
-	builtin: "versatiles",
-	url: "https://cdn.example/planet.versatiles",
-	// url: "/path/to/planet.versatiles",
-	tms: false, // y coordinate is inverted
-	headers: { // headers sent to versatiles server
-		"X-Tileblaster": "True",
-	},
-}
-```
-
-#### `pmtiles`
-
-Fetch a tile from a pmtiles container.
-
-``` js
-{
-	// get tile from versatiles container
-	builtin: "pmtiles",
-	url: "https://cdn.example/planet.pmtiles",
-	// url: "/path/to/planet.pmtiles",
-}
-```
-#### `mbtiles`
-
-Retrieve a tile from a mbtiles database.
-
-``` js
-{
-	// get tile from versatiles container
-	builtin: "mbtiles",
-	file: "/path/to/planet.mbtiles",
-}
-```
-
-#### `edit`
-
-Edit vectortiles
-
-``` js
-{
-	builtin: "edit",
-	edit: function(layers){
-
-		// remove unused layer
-		layers = layers.filter(function(layer){
-			return (layer.name !== "unused-layer");
-		});
-
-		return layers;
-	},
-}
-```
-
-#### `resize`
-
-**Not yet implemented** FIXME
-
-#### `modernize`
-
-Convert JPEG or PNG raster tiles to WebP or AVIF.
-The resulting tile with the smallest size and a format the client supports becomes the main tile.
-
-``` js
-{
-	builtin: "modernize",
-	webp: {
-		quality: 90,
-		effort: 4,
-	},
-	avif: {
-		quality: 90,
-		effort: 5,
-	},
-}
-```
-
-#### `optimize`
-
-Optimise raster tiles with `mozjpeg` or `optipng`. Only results smaller than the original are kept.
-
-``` js
-{
-	plugin: "optimize",
-	png: { o: 4 }, // true or opts for optipng
-	jpeg: true, // true or opts for mozjpeg
-}
-```
-
-#### `compress`
-
-Compresses all `data.tiles` with brotli and/or gzip. The tile with the smallest size and a compression the client supports becomes the main tile.
-
-``` js
-{
-	builtin: "compress",
-	brotli: 8, // true or <level> or {opts}
-	gzip: true, // true or <level> or {opts}
-}
-```
-
-
-#### `deliver`
-
-Sends `data.tile` to the client. Adds configured response headers.
-
-``` js
-{
-	"builtin": "deliver",
-	"headers": {
-		"X-My-Header": "This is a very good header"
-	}
-}
-```
-
-#### `dump`
-
-Ends all processing and dumps the contents of `data` the console and browser.
-
-Useful for debugging.
-
-``` js
-{
-	"builtin": "dump"
-}
-```

package/docs/examples.md

@@ -1,257 +0,0 @@
-# Examples
-
-## Tileserver
-
-Serve tiles from a tileserver
-
-``` js
-{
-	example: [{
-		// takes a request for /map/0/1/2@2x.png and breaks it down into z=0, x=1, y=2, r=@2x and e=png
-		builtin: "parse",
-		/* but you can override this if you need to
-		parse: function(req, fn){
-			// `req` is the http request object
-			let fragments = req.url.split("/").pop().split(".");
-			// fn is a callback to deliver the pares parameters
-			fn(null, {
-				z: fragments[0], x: fragments[1], y: fragments[2],
-				e: fragments[3], // extension
-				r: "@2x", // density marker
-				d: 2,     // density
-				w: 512,   // tile width
-			});
-		}
-		*/
-	},{
-		// source tileserver
-		builtin: "tileserver",
-		url: "https://{s}.tileserver.example/{z}/{x}/{y}{r}.{e}?access_token=YOUR_OPENDATAGRIFTBOXTILER_ACCESS_TOKEN",
-		// optional:
-		subdomains: [ "a", "b", "c" ], // random chosen and passed in as {s}
-		tms: false, // {y} is inverted
-		headers: { // additional headers sent to tileserver
-			"Origin": "https://totally-legit-website.example/",
-			"User-Agent": "uncoolest-mobile-map-app"
-		},
-		status: [ 200 ], // expected status code(s)
-		mimetypes: [ "image/png", "image/jpeg" ], // expected mime types
-	},{
-		builtin: "deliver"
-	}]
-}
-```
-
-## Versatiles
-
-Serve tiles from a versatiles container
-
-``` js
-{
-	example: [{
-		builtin: "parse",
-	},{
-		builtin: "versatiles",
-		url: "https://cdn.example/planet.versatiles",
-	},{
-		builtin: "deliver"
-	}]
-}
-```
-
-## PMTiles
-
-Serve tiles from a pmtiles container
-
-``` js
-{
-	example: [{
-		builtin: "parse",
-	},{
-		builtin: "pmtiles",
-		url: "https://cdn.example/planet.pmtiles",
-	},{
-		builtin: "deliver"
-	}]
-}
-```
-
-## MBTiles
-
-Serve tiles from an mbtile database
-
-``` js
-{
-	example: [{
-		builtin: "parse",
-	},{
-		builtin: "mbtiles",
-		file: "/path/to/file.mbtiles",
-	},{
-		builtin: "deliver"
-	}]
-}
-```
-
-## Check parameters
-
-Limit access to tiles by zoom level, bbox, extension or density marker with `check` builtin
-
-``` js
-{
-	example: [{
-		builtin: "parse",
-	},{
-		builtin: "check",
-		zoom: [ 0, 10 ], // min, max
-		bbox: [ -180, -85, 180, 85 ], // west, south, east, north
-		extensions: [ "png", "jpeg" ], // allowed extensions
-		density: [ "", "@2x" ], // allowed density markers
-	},{
-		// source tileserver
-		builtin: "tileserver",
-		url: "https://tileserver.example/{z}/{x}/{y}{r}.{e}",
-	},{
-		builtin: "deliver"
-	}]
-}
-```
-
-## Raster tile optimization and conversion
-
-`optimize` will attemt to reduce the raster tile size by applying image optimization, `mozjpeg` for `jpeg` tiles, `optipng` for `png` tiles.
-`modernize` will convert raster tiles to `webp` and `avif` format (using `sharp`) and deliver those to capable clients.
-
-``` js
-{
-	example: [{
-		builtin: "parse",
-	},{
-		// source tileserver
-		builtin: "tileserver",
-		url: "https://tileserver.example/{z}/{x}/{y}.{e}",
-	},{
-		builtin: "optimize",
-		jpeg: {}, // use mozjpeg via wasm for jpeg tiles
-		png: { o: "3", strip: "all" }, // use optipng via wasm for png tiles
-	},{
-		builtin: "modernize",
-		webp: {
-			quality: 85, // good enough quality
-			effort: 3, // don't use much effort
-		},
-		avif: {
-			quality: 100, // 100% quality
-			lossless: true, // lossless only
-			effort: 9, // a lot of effort
-		}
-	},{
-		builtin: "deliver"
-	}]
-}
-```
-
-## Raster tile image manipulation
-
-Use [sharp](https://www.npmjs.com/package/sharp) to manipulate raster tiles.
-Example: convert a raster tile to "dark mode" by inverting the colors and rotating the hue.
-
-``` js
-{
-	example: [{
-		builtin: "parse",
-	},{
-		// source tileserver
-		builtin: "tileserver",
-		url: "https://tileserver.example/{z}/{x}/{y}.png",
-	},{
-		builtin: "sharp", // use builtin sharp
-		negate: {}, // invert colors using sharp.negate()
-		modulate: { hue: 180 }, // rotate hue by 180° using sharp.modulate({ hue: 180 })
-	},{
-		builtin: "deliver"
-	}]
-}
-```
-
-## Edit vector tiles
-
-Use [vtt](https://npmjs.com/package/vtt) to edit vectortiles.
-
-``` js
-{
-	example: [{
-		builtin: "parse",
-	},{
-		builtin: "tileserver",
-		url: "https://tileserver.example/{z}/{x}/{y}.pbf",
-	},{
-		builtin: "edit", // use builtin edit
-		edit: function(layers){
-			// `layers` is ja JSON representation of the layers in a tile
-			// return the edited `layers` data
-			return layers.filter(function(layer){
-				return layer.name !== "pois"; // remove "pois" layer
-			});
-		}
-	},{
-		builtin: "deliver"
-	}]
-}
-```
-
-## Compression
-
-Precompress tiles with brotli and gzip and deliver them to capable clients.
-Use with compressible tiles (vectortiles, json, svg) and not raster tiles.
-
-``` js
-{
-	example: [{
-		builtin: "parse",
-	},{
-		builtin: "tileserver",
-		url: "https://tileserver.example/{z}/{x}/{y}.pbf",
-	},{
-		builtin: "compress",
-		brotli: 6, // brotli compression level 6
-		gzip: 4, // gzip compression level 4
-	},{
-		builtin: "deliver"
-	}]
-}
-```
-
-## Caching
-
-``` js
-{
-	example: [{
-		builtin: "parse",
-	},{
-		builtin: "cache", // before tile retrieved: check if tile is in cache
-		skipto: "deliver", // skip to this builtin/plugin at cache hit
-	},{
-		// get tile from tileserver
-		builtin: "tileserver",
-		url: "https://tileserver.example/{z}/{x}/{y}",
-	},{
-		builtin: "cache", // after tile retrieved: store tile in cache
-		expires: "30d", // keep in cache for 30 days
-	},{
-		builtin: "deliver",
-	}]
-}
-```
-
-## CORS
-
-Allow Cross-origin resource sharing for certain domains
-
-``` js
-{
-	builtin: "cors",
-	origins: [ "https://example.org/" ], // "*" for any domain
-}
-```
-

package/docs/tileblaster.svg

@@ -1,261 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-
-<svg
-   width="150mm"
-   height="150mm"
-   viewBox="0 50 150 150"
-   version="1.1"
-   id="svg29401"
-   inkscape:version="1.2 (dc2aeda, 2022-05-15)"
-   sodipodi:docname="tileblaster.svg"
-   inkscape:export-filename="tileblaster.png"
-   inkscape:export-xdpi="86.698669"
-   inkscape:export-ydpi="86.698669"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns:xlink="http://www.w3.org/1999/xlink"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg">
-  <sodipodi:namedview
-     id="namedview29403"
-     pagecolor="#505050"
-     bordercolor="#eeeeee"
-     borderopacity="1"
-     inkscape:showpageshadow="0"
-     inkscape:pageopacity="0"
-     inkscape:pagecheckerboard="0"
-     inkscape:deskcolor="#505050"
-     inkscape:document-units="mm"
-     showgrid="false"
-     showguides="true"
-     inkscape:zoom="1"
-     inkscape:cx="382.5"
-     inkscape:cy="333.5"
-     inkscape:window-width="1859"
-     inkscape:window-height="1027"
-     inkscape:window-x="61"
-     inkscape:window-y="229"
-     inkscape:window-maximized="0"
-     inkscape:current-layer="layer1">
-    <sodipodi:guide
-       position="74.999999,38.875"
-       orientation="-1,0"
-       id="guide32273"
-       inkscape:locked="false"
-       inkscape:label=""
-       inkscape:color="rgb(0,134,229)" />
-    <sodipodi:guide
-       position="24.694444,74.999999"
-       orientation="0,1"
-       id="guide34465"
-       inkscape:locked="false"
-       inkscape:label=""
-       inkscape:color="rgb(0,134,229)" />
-    <sodipodi:guide
-       position="104.51042,150"
-       orientation="0,-1"
-       id="guide35193"
-       inkscape:locked="false" />
-    <sodipodi:guide
-       position="94.368055,0"
-       orientation="0,-1"
-       id="guide35195"
-       inkscape:locked="false" />
-    <sodipodi:guide
-       position="0,54.309027"
-       orientation="1,0"
-       id="guide35197"
-       inkscape:locked="false" />
-    <sodipodi:guide
-       position="150,32.260416"
-       orientation="1,0"
-       id="guide35199"
-       inkscape:locked="false" />
-  </sodipodi:namedview>
-  <defs
-     id="defs29398">
-    <linearGradient
-       inkscape:collect="always"
-       xlink:href="#linearGradient29346-1"
-       id="linearGradient31371"
-       gradientUnits="userSpaceOnUse"
-       gradientTransform="matrix(2.9999997,2.3590334e-8,-2.3590334e-8,2.9999997,-800.00007,-894.07809)"
-       x1="400.00006"
-       y1="468.68973"
-       x2="325.00006"
-       y2="425.38846" />
-    <linearGradient
-       inkscape:collect="always"
-       id="linearGradient29346-1">
-      <stop
-         style="stop-color:#8332ff;stop-opacity:1;"
-         offset="0"
-         id="stop29342-0" />
-      <stop
-         style="stop-color:#e816ff;stop-opacity:0.99492383;"
-         offset="1"
-         id="stop29344-8" />
-    </linearGradient>
-    <filter
-       inkscape:collect="always"
-       style="color-interpolation-filters:sRGB"
-       id="filter35252"
-       x="-0.090126778"
-       y="-0.084742466"
-       width="1.1802536"
-       height="1.1694849">
-      <feGaussianBlur
-         inkscape:collect="always"
-         stdDeviation="3.6361132"
-         id="feGaussianBlur35254" />
-    </filter>
-    <filter
-       inkscape:collect="always"
-       style="color-interpolation-filters:sRGB"
-       id="filter35272"
-       x="-0.060782709"
-       y="-0.070185916"
-       width="1.1215654"
-       height="1.1403718">
-      <feGaussianBlur
-         inkscape:collect="always"
-         stdDeviation="11.396758"
-         id="feGaussianBlur35274" />
-    </filter>
-  </defs>
-  <g
-     inkscape:label="Ebene 1"
-     inkscape:groupmode="layer"
-     id="layer1"
-     transform="translate(179.53655,1.2883869)">
-    <g
-       id="g35304"
-       transform="matrix(1.1361953,0,0,1.1361953,14.238481,-16.847521)">
-      <path
-         style="fill:#191919;fill-opacity:1;stroke-width:1.17621;stroke-linecap:round"
-         d="m -160.68486,91.293103 -1e-5,64.834477 56.14832,32.41724 56.148303,-32.41724 1e-5,-64.834477 -56.148323,-32.417242 z"
-         id="path31292" />
-      <g
-         id="g35262"
-         transform="matrix(0.22459324,-0.12966896,0.12966896,0.22459324,-210.22972,70.313386)"
-         style="opacity:0.123762;mix-blend-mode:normal;fill:#31e2ff;fill-opacity:1;filter:url(#filter35272)">
-        <path
-           id="path35256"
-           style="fill:#31e2ff;fill-opacity:1;stroke-width:13.6062;stroke-linecap:round"
-           d="M 137.49989,187.23365 24.999997,382.08718 137.50003,576.943 l 149.99996,-4e-5 -37.49998,-64.95187 -75.00001,5e-5 -74.99999,-129.90395 37.49998,-64.95114 h 75.00002 l -37.50002,64.95113 74.99999,129.90235 150,10e-6 L 475,382.08718 399.99997,252.18485 H 324.99998 L 362.5,187.23369 287.49999,187.23368 250,252.18485 l -75.00002,10e-6 37.50004,-64.95117 z m 150.00001,129.90234 74.99999,-10e-6 37.5,64.95115 -37.49999,64.95117 -75.00001,-2e-5 -37.49997,-64.95115 z"
-           sodipodi:nodetypes="cccccccccccccccccccccccccccc" />
-        <path
-           id="path35258"
-           style="opacity:0.180328;fill:#31e2ff;fill-opacity:1;stroke:none;stroke-width:2;stroke-linecap:round;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
-           d="M 137.5,187.23242 25,382.08789 150,208.88281 212.5,187.23242 Z m 150,0 -37.5,64.95117 50,-43.30078 62.5,-21.64843 z" />
-        <path
-           id="path35260"
-           style="opacity:0.180328;fill:#31e2ff;fill-opacity:1;stroke:none;stroke-width:2;stroke-linecap:round;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
-           d="m 225,295.48438 -87.5,21.65039 h 75 z M 475,382.08789 387.5,490.33984 250,511.99023 H 400 Z M 275,555.29297 137.5,576.94336 h 150 z" />
-      </g>
-      <path
-         id="path29308"
-         style="fill:#840577;fill-opacity:0.399267;stroke-width:3.5286;stroke-linecap:round"
-         d="m -154.03095,95.1353 -2.6e-4,58.35052 50.53349,29.17555 33.688976,-19.45035 -16.844482,-9.72517 -16.844494,9.72519 -33.689,-19.45038 1e-4,-19.45018 16.8445,-9.72517 -1.1e-4,19.45017 33.688789,19.45003 33.688993,-19.45036 1.86e-4,-38.900359 -33.688797,-19.450003 -16.844481,9.725168 9e-5,-19.450177 -16.8445,9.725176 -8e-5,19.450179 -16.84451,9.725176 1.1e-4,-19.450187 z m 50.53329,9.72484 16.844493,-9.725173 16.844384,9.725003 -8.8e-5,19.45018 -16.844492,9.72516 -16.844397,-9.725 z"
-         sodipodi:nodetypes="cccccccccccccccccccccccccccc" />
-      <g
-         id="g31384"
-         transform="matrix(0.22459324,-0.12966896,0.12966896,0.22459324,-210.22972,70.313386)">
-        <path
-           id="path31363"
-           style="fill:url(#linearGradient31371);fill-opacity:1;stroke-width:13.6062;stroke-linecap:round"
-           d="M 137.49989,187.23365 24.999997,382.08718 137.50003,576.943 l 149.99996,-4e-5 -37.49998,-64.95187 -75.00001,5e-5 -74.99999,-129.90395 37.49998,-64.95114 h 75.00002 l -37.50002,64.95113 74.99999,129.90235 150,10e-6 L 475,382.08718 399.99997,252.18485 H 324.99998 L 362.5,187.23369 287.49999,187.23368 250,252.18485 l -75.00002,10e-6 37.50004,-64.95117 z m 150.00001,129.90234 74.99999,-10e-6 37.5,64.95115 -37.49999,64.95117 -75.00001,-2e-5 -37.49997,-64.95115 z"
-           sodipodi:nodetypes="cccccccccccccccccccccccccccc" />
-        <path
-           id="path31365"
-           style="opacity:0.180328;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:2;stroke-linecap:round;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
-           d="M 137.5,187.23242 25,382.08789 150,208.88281 212.5,187.23242 Z m 150,0 -37.5,64.95117 50,-43.30078 62.5,-21.64843 z" />
-        <path
-           id="path31373"
-           style="opacity:0.180328;fill:#000000;fill-opacity:1;stroke:none;stroke-width:2;stroke-linecap:round;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1"
-           d="m 225,295.48438 -87.5,21.65039 h 75 z M 475,382.08789 387.5,490.33984 250,511.99023 H 400 Z M 275,555.29297 137.5,576.94336 h 150 z" />
-      </g>
-      <path
-         id="path35201"
-         style="opacity:0.576733;mix-blend-mode:normal;fill:#010101;fill-opacity:1;stroke-width:0.23538;filter:url(#filter35252)"
-         d="m -71.411808,72.221289 -5.095817,2.941939 v 5.884913 l -15.288461,8.826334 h -10.192134 l -5.09633,2.942456 -5.09633,2.942456 -5.09581,2.94194 -8.28994,4.786273 -1.20147,0.6935 -0.70125,0.40462 -25.48062,14.71125 v 17.6537 l 5.09633,2.94246 10.19214,-5.8844 5.09633,2.94194 v 35.30689 l 5.09582,2.94246 20.3848,-11.76879 -5.09633,-2.94246 v -5.8844 -23.53809 l 10.19266,-5.8844 v -5.88439 -5.2e-4 l 5.095807,-2.94194 v -5.8844 l 5.096327,-2.94245 v -5.8844 l 35.672739,-20.595639 -5.096327,-2.942456 v -5.884396 l -5.095807,2.941939 z"
-         transform="matrix(0.98017487,0,0,0.98017487,-2.0724487,2.4525763)" />
-      <g
-         id="g29366"
-         transform="matrix(0.19980409,-0.11535694,0.11535694,0.19980409,-191.07133,74.765286)">
-        <path
-           style="fill:#949fab;fill-opacity:1"
-           d="m 75.000005,338.78592 12.499997,21.65063 -75,129.90381 12.500003,21.65064 H 125.00001 L 112.5,490.34036 200,338.78592 Z"
-           id="path25198"
-           sodipodi:nodetypes="cccccccc" />
-        <path
-           style="fill:#e6e9ed;fill-opacity:1;stroke-width:4.53543;stroke-linecap:round"
-           d="M 12.499997,317.13529 50,252.18338 h 250 l 37.5,21.65064 -37.5,64.9519 H 25.000006 Z"
-           id="path25379"
-           sodipodi:nodetypes="ccccccc" />
-        <path
-           style="fill:#ed5564;fill-opacity:1;stroke-width:4.53543;stroke-linecap:round"
-           d="m 187.5,360.43655 h 50 L 225,382.08719 h -50 z"
-           id="path25444"
-           sodipodi:nodetypes="ccccc" />
-        <path
-           style="fill:#8994a2;fill-opacity:1;stroke-width:4.53543;stroke-linecap:round"
-           d="M 300,252.18338 275,295.48465 262.5,273.83402 275,252.18338 H 250 L 225,295.48465 213.13802,274.9391 225,252.18338 h -25 l -25,43.30127 -12.35149,-21.39341 12.3515,-21.90786 H 275 Z"
-           id="path25509"
-           sodipodi:nodetypes="cccccccccccccc" />
-        <path
-           style="fill:#949fab;fill-opacity:1;stroke-width:4.53543;stroke-linecap:round"
-           d="m 337.5,273.83401 -12.5,21.65064 -12.5,21.65064 175,-10e-6 -12.5,-21.65063 12.5,-21.65063 z"
-           id="path26345"
-           sodipodi:nodetypes="ccccccc" />
-        <path
-           style="fill:#8994a2;fill-opacity:1;stroke-width:4.53543;stroke-linecap:round"
-           d="m 412.49999,273.83402 12.5,-21.65064 H 450 l 12.5,21.65064 h -50.00001"
-           id="path26420" />
-        <path
-           style="fill:#8994a2;fill-opacity:1;stroke-width:4.53543;stroke-linecap:round"
-           d="m 200,338.78591 75,10e-6 -12.50001,21.65063 H 187.5 Z"
-           id="path26432"
-           sodipodi:nodetypes="ccccc" />
-        <path
-           style="fill:#ffffff;fill-opacity:0.0967742;stroke-width:4.53543;stroke-linecap:round"
-           d="M 12.499997,317.13529 50,252.18338 H 300 L 62.500003,273.83402 Z"
-           id="path26937" />
-        <path
-           style="fill:#000000;fill-opacity:0.0967742;stroke-width:4.53543;stroke-linecap:round"
-           d="M 112.5,490.34036 99.999998,468.68973 175,338.78592 h 100 l -87.5,21.65063 z"
-           id="path28766" />
-        <path
-           style="fill:#ffffff;fill-opacity:0.0967742;stroke-width:4.53543;stroke-linecap:round"
-           d="m 325,295.48465 12.5,-21.65063 h 150 z"
-           id="path28831" />
-        <path
-           style="fill:#000000;fill-opacity:0.0967742;stroke-width:4.53543;stroke-linecap:round"
-           d="M 312.5,317.13529 475,295.48465 487.49999,317.13529 Z"
-           id="path28833" />
-        <path
-           style="fill:#000000;fill-opacity:0.0967742;stroke-width:4.53543;stroke-linecap:round"
-           d="M 337.5,273.83401 275,338.78592 h 25 z"
-           id="path28835" />
-        <path
-           style="fill:#ffffff;fill-opacity:0.0967742;stroke-width:4.53543;stroke-linecap:round"
-           d="M 87.500002,360.43655 25.000006,511.991 12.500002,490.34036 Z"
-           id="path28837"
-           sodipodi:nodetypes="cccc" />
-        <path
-           style="fill:#000000;fill-opacity:0.131086;stroke-width:4.53543;stroke-linecap:round"
-           d="m 175,382.08719 h -25 l 12.5,21.65063 h -25 l 12.5,21.65064 h -25 l 12.5,21.65063 h -25 l 12.5,21.65064 z"
-           id="path28914" />
-        <path
-           style="fill:#000000;fill-opacity:0.131086;stroke-width:4.53543;stroke-linecap:round"
-           d="m 175,382.08719 12.5,-21.65064 h 50 z"
-           id="path28979" />
-        <path
-           style="fill:#ffffff;fill-opacity:0.131086;stroke-width:4.53543;stroke-linecap:round"
-           d="m 412.5,273.83402 12.49999,-21.65064 H 450 Z"
-           id="path28981" />
-      </g>
-    </g>
-  </g>
-</svg>

package/docs/todo.md

@@ -1,140 +0,0 @@
-# Todo
-
-## Roadmap
-
-### 1.0 Release
-
-* [x] Config format
-	* [x] Map format
-	* [x] Tasks fomat
-* [x] HTTP Server, Port and Socket
-	* [x] Graceful shutdown
-* [x] Debug Library → `lib/debug.js`
-* [x] Optional Module Loader → `lib/load.js`
-* [x] HTTPs Abstraction (~got or~ phin) → `lib/retrieve.js`
-* [x] Plugin Interface / Task Runner
-* [x] Builtins
-	* [x] CORS
-	* [x] Parse Request
-	* [x] Check Request
-	* [x] Tile Backends
-		* [x] ZXY Webtiles → `builtin/tileserver.js`
-		* [x] TMS Webtiles → `builtin/tileserver.js`
-		* [x] Versatiles
-		* [x] PMTiles
-		* [x] MBTiles
-	* [x] Optimization (optipng, mozjpeg, svgo?, pbfcrop?)
-	* [x] Modernize Raster Formats (png,jpeg → webp,avif)
-	* [x] Caching to Disk
-		* [x] Reading cached tile from Disk
-		* [x] Skipping Jobs
-		* [x] Etag Headers
-		* [x] Last-Modified Headers
-		* [x] Don't store if expired
-		* [x] Expires Headers
-		* [x] Don't update if already cached (in case of store-only)
-		* [x] ~Cache-Control Headers~ → Set via `deliver` builtin
-	* [x] Delivery
-	* [x] Debug Dump
-	* [x] Vectortile Editing
-	* [x] Full image manipulation for raster tiles → https://www.npmjs.com/package/sharp
-	* [x] Vectortiles Editor → https://www.npmjs.com/package/vtt
-* [x] Cache Cleaning Worker
-* [x] Documentation
-	* [x] What is Tileblaster, what is the benefit for the user
-	* [x] What can't tileblaster do
-	* [x] All config options
-	* [x] All builtins
-	* [x] Example Config
-	* [x] Example Nginx Config
-	* [x] How to use it, Standalone or behind Proxy
-	* [x] Core concepts explained (maps, work queue, builtins and plugins)
-	* [x] Examples
-		* [x] Caching proxy for a tileserver
-		* [x] Serve tiles from container
-		* [x] Raster editing: "Dark mode"
-		* [x] Vector editing: remove unused layers
-	* How to contribute, bug reports
-* [x] CLI
-	* [x] Cluster Support
-	* [x] PM2 Integration
-	* [x] Rudimentary Dev Server
-* [x] Request Queue to throttle unfulfilled requests
-* [x] Fancy Default Page
-* [x] Custom String Template function for {x} replacement instead of regex
-
-### Next
-
-* [ ] Redirects
-* [ ] Convert Geojson ↔ Topojson
-* [ ] Map Web Interface, Configurable
-* [ ] Configurable Index Page
-* [ ] Support for Glyphs and Styles, tile.json proxy
-* [x] Better Error Handling
-	* [x] Error wrapper (to pass along http status etc)?
-	* [x] Skip for nonexistant tiles
-* [ ] Render Vector Tiles with MapLibreGL-Native
-* [ ] Improve Debug Consistency
-* [ ] Documentation: How to write a plugin
-
-### Later
-
-* [ ] Screencast
-* [ ] Monitoring / Status / Statistics Interface
-* [ ] Integration with Nginx-Cache
-* [ ] Memcache → https://www.npmjs.com/package/iomem
-* [ ] Backends
-	[ ] tilebase https://www.npmjs.com/package/tilebase
-	[ ] Geotiff?
-	[ ] PostGIS database via ST_AsMVT?
-* [ ] Conversions
-	* [ ] pbf → svg
-	* [ ] svg → raster
-	* [ ] geotif → raster
-
-### Probably Never
-
-* [ ] v0 Config Migration?
-* [ ] use mbtiles database as cache?
-* [ ] Standalone Logging?
-* [ ] Config Web Interface
-* [ ] Standalone Daemon with pid files?
-* [ ] Cache: Store in MBTiles or similar?
-* [ ] GDAL?
-* [ ] Footprint
-	* [ ] Replace Phin?
-* [ ] ~Nginx Cache Hydration~ (Problem: different file owners)
-
-## Format Support
-
-* [x] Vector
-	* [x] mvt/pbf
-	* [ ] svg
-* [x] Raster
-	* [x] png
-	* [x] jpeg
-	* [x] webp
-	* [x] avif
-	* [ ] geotif (readonly)
-* [ ] Data
-	* [ ] GeoJSON
-	* [ ] TopoJSON
-	* [ ] JSON
-	* [ ] ArcJSON?
-	* [ ] WKT? → https://en.wikipedia.org/w/index.php?title=Well-known_text_representation_of_geometry
-
-## Conversions
-
-* [ ] GeoJSON ↔ TopoJSON
-* [ ] WKT → GeoJSON  TopoJSON
-* [ ] GeoJSON TopoJSON → SVG
-* [ ] PNG JPEG WEBP AVIF TIF SVG → PNG JPEG WEBP AVIF
-* [ ] MVT → SVG
-* [ ] MVT → GeoJSON TopoJSON
-
-## Etag
-
-``` js
-// nginx etag — for consistency
-etag = util.format('"%s-%s"', Math.floor(mtimeMs/1000).toString(16), filesize.toString(16));
-```