chiitiler 1.23.5 → 1.23.6

package/README.md

@@ -139,10 +139,10 @@ All options can be set via CLI flag or environment variable.
 | `--port <n>` | `CHIITILER_PORT` | `3000` |
 | `--debug` | `CHIITILER_DEBUG` | `false` |
 | `--user-agent <ua>` | `CHIITILER_USER_AGENT` | (none) |
-| `--prewarm` | `CHIITILER_PREWARM` | `false` |
+| `--no-prewarm` | `CHIITILER_PREWARM` | `true` |
 | — | `CHIITILER_PROCESSES` | `1` (set `0` for all CPUs) |
 
-With prewarm enabled, one tile is rendered at startup **before** the server starts listening, so renderer initialization (GL context, sharp/libvips, JIT) doesn't hit the first request. On AWS Lambda with Lambda Web Adapter, the readiness check keeps this inside the INIT phase, which runs with a full CPU boost.
+Prewarm is enabled by default: one tile is rendered at startup **before** the server starts listening, moving shared renderer initialization work into startup. Either `--no-prewarm` or `CHIITILER_PREWARM=false` disables it. Style-specific tiles, glyphs, and sprites are not preloaded.
 
 ### Cache
 
@@ -181,7 +181,7 @@ npm install
 npm run dev              # tsx watch mode
 npm run test:unit        # vitest
 npm run test:integration # end-to-end
-npm run test:benchmark   # see BENCHMARK.md
+npm run test:benchmark   # see bench/BENCHMARK.md
 npm run build            # bundle to build/main.cjs
 ```
 

package/dist/cli.js

@@ -73,8 +73,8 @@ function parsePort(port) {
     return 3000;
 }
 function parsePrewarm(prewarmFlag) {
-    // command-line option, then env
-    return prewarmFlag === true || process.env.CHIITILER_PREWARM === 'true';
+    // Commander defaults a negated option to true; either opt-out disables warmup.
+    return prewarmFlag !== false && process.env.CHIITILER_PREWARM !== 'false';
 }
 function parseDebug(debug) {
     // command-line option
@@ -106,7 +106,7 @@ export function createProgram() {
         .option('--gcs-api-endpoint <api-endpoint>', 'gcs api endpoint', '')
         .option('-p, --port <port>', 'port number')
         .option('--user-agent <user-agent>', 'User-Agent header for outbound HTTP requests')
-        .option('--prewarm', 'render one tile at startup before listening, to warm up the renderer')
+        .option('--no-prewarm', 'disable startup renderer warmup (enabled by default)')
         .option('-D, --debug', 'debug mode')
         .action(async (options) => {
         // env fallback (CHIITILER_USER_AGENT) is handled in userAgent.ts

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "chiitiler",
-  "version": "1.23.5",
+  "version": "1.23.6",
   "description": "Tiny map rendering server for MapLibre Style Spec",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",