chiitiler 1.13.0 → 1.14.1

package/README.md

@@ -14,11 +14,17 @@ chii-tiler: "tiny" in Japanese is "chiisai", shorten into "chii"
 - In this type of server, there is a de-facto - [maptiler/tileserver-gl](https://github.com/maptiler/tileserver-gl), but this is too big for me.
 - I want a server accept style.json-url and respond raster tile, inspired by [developmentseed/titiler](https://github.com/developmentseed/titiler)
 
+## usecases
+
+- [MIERUNE/tiles](https://github.com/MIERUNE/tiles) - You can find example [here](https://mierune.github.io/tiles/color.html#11.62/43.064/141.3375)
+- [dayjournal/qgis-amazonlocationservice-plugin](https://github.com/dayjournal/qgis-amazonlocationservice-plugin) - used in Maps feature
+- [Allmaps Latest - Bluesky](https://bsky.app/profile/latest.allmaps.org)
+
 ## features
 
 ### /tiles
 
-chiitiler provides you with `/tiles` raster-tile endpoint. Once server launched, you can use like this:
+chiitiler provides you with an endpoint `/tiles`. Once server launched, you can use the endpoint like this:
 
 ```planetext
 http://localhost:3000/tiles/0/0/0.png?url=https://tile.openstreetmap.jp/styles/osm-bright/style.json
@@ -105,7 +111,7 @@ you can pass server options via environment variables
 | CHIITILER_S3_ENDPOINT              |          | s3 endpoint for caching/fetching               |
 | CHIITILER_S3_FORCE_PATH_STYLE      | false    | force path style for s3, needed for minio      |
 
-### Local
+### CLI (deprecated)
 
 - Node.js v18 or v20
 
@@ -140,21 +146,23 @@ node dist/main.js tile-server -c s3 -s3b chiitiler -s3r ap-northeast-1
 # caution: TTL is not supported in S3 cache, please utilize S3 lifecycle policy
 ```
 
-#### debug page
+### debug page
 
-- in debug mode, you can access debug page: <http://localhost:3000/debug>
-- You can pass style.json url:
-  - <http://localhost:3000/debug?url=https://tile.openstreetmap.jp/styles/osm-bright/style.json>
+- in debug mode, you can access:
+    - debug page: <http://localhost:3000/debug>
+        - You can pass style.json url: <http://localhost:3000/debug?url=https://tile.openstreetmap.jp/styles/osm-bright/style.json>
+    - editor page: <http://localhost:3000/editor>
 
 ## supported protocols in style.json
 
 - `http://` or `https://` protocol are used in Style Specification
 - In addition, chiitiler supports following protocols:
   - `s3://` for S3 bucket
-  - `file://` for local file
-  - `mbtiles://` for local MBTIles files
-  - `pmtiles://` form PMTiles, remote or local or s3
-- Only when `http://` and `https://` chiitiler will cache them with a specified method.
+  - `file://` for file system
+  - `mbtiles://` for MBTIles files
+  - `pmtiles://` for PMTiles, remote or local or s3
+  - `cog://` experimental, for Cloud Optimized GeoTIFF. CRS must be EPSG:3857.
+- Only when `http://` and `https://` chiitiler cache them with a method you specified.
 
 ### example
 
@@ -191,6 +199,13 @@ node dist/main.js tile-server -c s3 -s3b chiitiler -s3r ap-northeast-1
         "s3://tiles/{z}/{x}/{y}.pbf"
       ],
       "maxzoom": 6
+    },
+    "cog": {
+      "type": "raster",
+      "tiles": [
+        "cog://https://sentinel-cogs.s3.us-west-2.amazonaws.com/sentinel-s2-l2a-cogs/54/T/WN/2024/9/S2A_54TWN_20240908_0_L2A/TCI.tif/{z}/{x}/{y}"
+      ],
+      "tileSize": 256
     }
   },
   "layers": [
@@ -233,6 +248,14 @@ node dist/main.js tile-server -c s3 -s3b chiitiler -s3r ap-northeast-1
         "circle-radius": 3,
         "circle-color": "green"
       }
+    },
+    {
+      "id": "cog",
+      "source": "cog",
+      "type": "raster",
+      "paint": {
+        "raster-opacity": 0.5
+      }
     }
   ]
 }

package/dist/render/pool.js

@@ -11,6 +11,8 @@ const TRANSPARENT_BUFFER = {
     jpeg: Buffer.from('/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjL/wAARCAABAAEDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwD3+iiigD//2Q=='),
 };
 function handleFileExt(uri) {
+    if (uri.startsWith('cog://'))
+        return 'png'; // cog:// always returns as png
     // extract extension only, take into account query string or hash
     const basename = path.basename(uri).split(/[?#]/)[0];
     const ext = basename.split('.').pop();

package/dist/render/rasterize.d.ts

@@ -1,7 +1,7 @@
 import type { RenderOptions } from '@maplibre/maplibre-gl-native';
 import type { StyleSpecification } from '@maplibre/maplibre-gl-style-spec';
 import type { Cache } from '../cache/index.js';
-declare function render(style: StyleSpecification, renderOptions: RenderOptions, cache: Cache, mode: 'tile' | 'static'): Promise<Uint8Array>;
+declare function render(style: StyleSpecification, renderOptions: RenderOptions, cache: Cache, mode: 'tile' | 'static'): Promise<Uint8Array<ArrayBufferLike>>;
 declare function renderTile(style: StyleSpecification, z: number, x: number, y: number, options: {
     tileSize: number;
     cache: Cache;

package/dist/source/cog.d.ts

@@ -0,0 +1,2 @@
+declare function getCogSource(uri: string): Promise<Buffer | null>;
+export { getCogSource };

package/dist/source/cog.js

@@ -0,0 +1,19 @@
+/// <reference lib="dom" />
+// for using native fetch in TypeScript
+import { renderTile } from 'higuruma';
+async function getCogSource(uri) {
+    const cogPath = uri.replace('cog://', '').replace(/\/\d+\/\d+\/\d+$/, '');
+    const [z, x, y] = uri.replace(`cog://${cogPath}/`, '').split('/');
+    try {
+        const tile = await renderTile(cogPath, Number(z), Number(x), Number(y));
+        const buf = Buffer.from(tile);
+        if (buf.byteLength === 129)
+            return null; // empty tile
+        return buf;
+    }
+    catch (e) {
+        console.error(`[ERROR] ${e}`);
+        return null;
+    }
+}
+export { getCogSource };

package/dist/source/fs.d.ts

@@ -1,2 +1,2 @@
-declare function getFilesystemSource(uri: string): Promise<Buffer | null>;
+declare function getFilesystemSource(uri: string): Promise<Buffer<ArrayBufferLike> | null>;
 export { getFilesystemSource };

package/dist/source/index.js

@@ -3,6 +3,7 @@ import { getHttpSource } from './http.js';
 import { getPmtilesSoruce } from './pmtiles.js';
 import { getMbtilesSource } from './mbtiles.js';
 import { getS3Source } from './s3.js';
+import { getCogSource } from './cog.js';
 import { noneCache } from '../cache/index.js';
 /**
  * retrieve sources from the uri
@@ -22,6 +23,10 @@ async function getSource(uri, cache = noneCache()) {
         data = await getMbtilesSource(uri);
     else if (uri.startsWith('pmtiles://'))
         data = await getPmtilesSoruce(uri, cache);
+    else if (uri.startsWith('cog://'))
+        data = await getCogSource(uri);
+    else
+        return null;
     return data;
 }
 export { getSource };

package/dist/source/s3.d.ts

@@ -1,2 +1,2 @@
-declare function getS3Source(uri: string): Promise<Buffer | null>;
+declare function getS3Source(uri: string): Promise<Buffer<Uint8Array<ArrayBufferLike>> | null>;
 export { getS3Source };

package/package.json

@@ -1,52 +1,52 @@
 {
-  "type": "module",
-  "name": "chiitiler",
-  "version": "1.13.0",
-  "description": "Tiny map rendering server for MapLibre Style Spec",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx watch src/main.ts tile-server -D",
-    "start": "tsc && node ./dist/main.js tile-server",
-    "test:unit": "vitest src",
-    "test:coverage": "vitest src --coverage --coverage.provider=v8",
-    "test:integration": "vitest tests/integration.test.ts",
-    "test:benchmark": "vitest bench",
-    "prepare": "npm run build"
-  },
-  "keywords": [],
-  "author": "Kanahiro Iguchi",
-  "license": "MIT",
-  "devDependencies": {
-    "@tsconfig/node20": "^20.1.4",
-    "@types/better-sqlite3": "^7.6.10",
-    "@types/node": "^20.6.0",
-    "@vitest/coverage-v8": "^1.6.0",
-    "image-size": "^1.1.1",
-    "maplibre-gl": "^3.3.1",
-    "ts-node": "^10.9.1",
-    "tsx": "^4.7.1",
-    "typescript": "^5.2.2",
-    "vitest": "^1.6.0"
-  },
-  "dependencies": {
-    "@aws-sdk/client-s3": "^3.418.0",
-    "@hono/node-server": "^1.12.0",
-    "@mapbox/sphericalmercator": "^1.2.0",
-    "@mapbox/tilebelt": "^1.0.2",
-    "@maplibre/maplibre-gl-native": "^5.4.0",
-    "@maplibre/maplibre-gl-style-spec": "^20.2.0",
-    "better-sqlite3": "^9.6.0",
-    "commander": "^11.0.0",
-    "file-system-cache": "^2.4.4",
-    "hono": "^4.5.4",
-    "lightning-pool": "^4.2.2",
-    "lru-cache": "^11.0.0",
-    "pmtiles": "^3.0.5",
-    "sharp": "^0.32.5"
-  }
+	"type": "module",
+	"name": "chiitiler",
+	"version": "1.14.1",
+	"description": "Tiny map rendering server for MapLibre Style Spec",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "npx esbuild --bundle src/main.ts --minify --outfile=build/main.cjs --platform=node --external:@maplibre/maplibre-gl-native --external:sharp",
+		"dev": "tsx watch src/main.ts tile-server -D",
+		"test:unit": "vitest src",
+		"test:coverage": "vitest src --coverage --coverage.provider=v8",
+		"test:integration": "vitest tests/integration.test.ts",
+		"test:benchmark": "vitest bench"
+	},
+	"keywords": [],
+	"author": "Kanahiro Iguchi",
+	"license": "MIT",
+	"devDependencies": {
+		"@tsconfig/node20": "^20.1.4",
+		"@types/better-sqlite3": "^7.6.10",
+		"@types/node": "^20.6.0",
+		"@vitest/coverage-v8": "^1.6.0",
+		"esbuild": "^0.25.0",
+		"image-size": "^1.1.1",
+		"maplibre-gl": "^3.3.1",
+		"ts-node": "^10.9.1",
+		"tsx": "^4.7.1",
+		"typescript": "^5.2.2",
+		"vitest": "^1.6.0",
+		"@aws-sdk/client-s3": "^3.418.0",
+		"@hono/node-server": "^1.12.0",
+		"@mapbox/sphericalmercator": "^1.2.0",
+		"@mapbox/tilebelt": "^1.0.2",
+		"@maplibre/maplibre-gl-style-spec": "^20.2.0",
+		"better-sqlite3": "^9.6.0",
+		"commander": "^11.0.0",
+		"file-system-cache": "^2.4.4",
+		"higuruma": "^0.1.6",
+		"hono": "^4.5.4",
+		"lightning-pool": "^4.2.2",
+		"lru-cache": "^11.0.0",
+		"pmtiles": "^3.0.5"
+	},
+	"dependencies": {
+		"@maplibre/maplibre-gl-native": "^5.4.0",
+		"sharp": "^0.32.5"
+	}
 }