mapcachetools 1.0.7 → 2.1.0

package/LICENSE

@@ -0,0 +1,16 @@
+ISC License
+
+Copyright (c) 2025 Mohammad Said Hefny
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

package/README.md

@@ -1,46 +1,122 @@
-# MAP Cache Tools
+# Map Cache Tools
 
-This tool download any area from map provider and store it as images in a folder.
-You can use these images with a library like [Leafet](https://leafletjs.com/ "Leafet") to make your own map server easily without the need to download a local OpenStreetMap server.
+A robust Node.js tool to download map tiles (satellite or terrain RGB) for a specified geographic area and zoom range, storing them as PNG images in a folder. Ideal for offline map applications, such as integration with [Leaflet](https://leafletjs.com/) or 3D rendering projects like WebGL-based terrain visualization. Features include parallel downloads, retry handling, progress tracking, and support for multiple map providers.
 
-[![Downloaded Images of Map](https://github.com/HefnySco/mapcache/blob/master/images/Screenshot%20from%202022-09-03%2002-19-12.png?raw=true "Downloaded Images of Map")](https://github.com/HefnySco/mapcache/blob/master/images/Screenshot%20from%202022-09-03%2002-19-12.png?raw=true "Downloaded Images of Map")
 
-## Usage
+Watch a demo video showcasing the tool:  
+[![Watch the video](https://github.com/HefnySco/mapcache/blob/master/images/youtube.png?raw=true)](https://youtu.be/aSb6xNOQqok)
 
-Download area from 58.5500977,-4.5231876   to 58.5501,-4.5231976 with maximum zoom in of 20 and minimum zoom in of 0 i.e. whole world zoom, and store images in folder called image_folder
 
+## Features
 
-    mapcache_download --lat1=58.5500977 --lng1=-4.5231876 --lat2=58.5501 --lng2=-4.5231976 --zin=20 --zout=0 --folder=./image_folder
+- **Supported Providers**: OpenStreetMap (OSM), Mapbox Satellite, and Mapbox Terrain RGB (for elevation data).
+- **Unified PNG Format**: All tiles are saved as PNG, with Mapbox Satellite tiles converted from JPG for consistency.
+- **Parallel Downloads**: Configurable concurrency to optimize speed while respecting provider rate limits.
+- **Retry Mechanism**: Automatically retries failed downloads (default: 3 attempts) with exponential backoff.
+- **Progress Tracking**: Displays real-time progress with percentage completion.
+- **File Management**: Skips existing files unless `--force` is used, with automatic output folder creation.
+- **Flexible Zoom**: Download tiles for a range of zoom levels (min `--zout` to max `--zin`).
+- **Integration**: Outputs tiles compatible with 3D mapping projects (e.g., Three.js terrain rendering) and Leaflet-based map servers.
 
-## Map Providers
+## Installation
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/HefnySco/mapcache.git
+   cd mapcache
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+   Note: The `sharp` library is required for JPG-to-PNG conversion. Ensure system dependencies are installed:
+   - Ubuntu/Debian: `sudo apt-get install libvips-dev`
+   - macOS: `brew install libvips`
+
+## Usage
+
+Download map tiles for a geographic area defined by two coordinates (`lat1,lng1` to `lat2,lng2`), a zoom range, and an output folder. Run the script with:
+
+```bash
+node downloader.js --lat1=<lat> --lng1=<lng> --lat2=<lat> --lng2=<lng> --zin=<max_zoom> --folder=<output_folder> [options]
+```
 
-The application supports [openstreetmap.org](https://www.openstreetmap.org/#map=7/26.805/30.246 "openstreetmap.org") 
+### Example: Download OSM Tiles
+Download OpenStreetMap tiles for a small area with zoom levels 0 to 14:
+```bash
+node downloader.js --lat1=40.7128 --lng1=-74.0060 --lat2=40.7228 --lng2=-73.9960 --zin=14 --zout=0 --folder=./site/cachedMaps
+```
 
+### Example: Download Mapbox Satellite Tiles
+Download Mapbox satellite tiles (saved as PNG, requires a Mapbox access token):
 ```bash
-mapcache_download --lat1=58.5500977 --lng1=-4.5231876 --lat2=58.5501 --lng2=-4.5231976 --zin=20  --folder=./out 
+node downloader.js --lat1=40.7128 --lng1=-74.0060 --lat2=40.7228 --lng2=-73.9960 --zin=14 --folder=./site/cachedMaps --provider=1 --token=pk.eyJ1IjoibWhlZm55IiwiYSI6ImNrZW84Nm9rYTA2ZWgycm9mdmNscmFxYzcifQ.c-zxDjXCthXmRsErPzKhbQ
+```
 
+### Example: Download Mapbox Terrain RGB Tiles
+Download Mapbox terrain RGB tiles for elevation data:
+```bash
+node downloader.js --lat1=40.7128 --lng1=-74.0060 --lat2=40.7228 --lng2=-73.9960 --zin=14 --folder=./site/cachedMaps --provider=2 --token=pk.eyJ1IjoibWhlZm55IiwiYSI6ImNrZW84Nm9rYTA2ZWgycm9mdmNscmFxYzcifQ.c-zxDjXCthXmRsErPzKhbQ
 ```
 
-and [api.mapbox.com](https://api.mapbox.com "api.mapbox.com"). You need to have a **TOKEN** for using [api.mapbox.com](https://api.mapbox.com "api.mapbox.com").
+### Options
+- `--lat1, --lng1`: Starting coordinates (required).
+- `--lat2, --lng2`: Ending coordinates (required).
+- `--zin`: Maximum zoom level (required, e.g., 18).
+- `--zout`: Minimum zoom level (default: 0).
+- `--folder`: Output folder for tiles (required, e.g., `./site/cachedMaps`).
+- `--provider`: Map provider (0=OSM, 1=Mapbox Satellite, 2=Mapbox Terrain RGB; default: 0).
+- `--token`: Mapbox access token (required for provider 1 or 2).
+- `--concurrency`: Number of parallel downloads (default: 5).
+- `--retries`: Retry attempts for failed downloads (default: 3).
+- `--force`: Redownload existing files (default: false).
+- `--help, -h`: Display help message.
+- `--version, -v`: Display script version.
+
+## Serving Tiles Locally
+
+Use a local HTTP server to serve downloaded tiles for testing with Leaflet or other map libraries:
 
 ```bash
- mapcache_download --lat1=58.5500977 --lng1=-4.5231876 --lat2=58.5501 --lng2=-4.5231976 --zin=20  --folder=./out --provider=1 --token=pk.eyJ1IjoibSahlZm59IiwiYSI6ImNrZW84Nm9rYTA2ZWgycv9mdmNscmFxYzcifQ.c-z43FdasErPzKhbQ
+cd site
+npm install -g http-server
+http-server
 ```
 
-## Sample
+Access the tiles at `http://localhost:8080/cachedMaps`. The folder `./site/cachedMaps` contains tiles named as:
+- OSM: `osm_<x>_<y>_<zoom>.png`
+- Mapbox Satellite: `sat_<x>_<y>_<zoom>.png`
+- Mapbox Terrain RGB: `terrain_<x>_<y>_<zoom>.png`
+
+## Integration with 3D Mapping Projects
 
-folder ./site contains a folder called **cachedMaps** you can put your maps into it and browse them.
+The downloaded tiles are saved as PNG, compatible with 3D mapping applications like Three.js for terrain rendering. For example, Mapbox terrain RGB tiles can be used to generate heightmaps:
 
+```javascript
+const terrainData = await textureLoader.loadAsync('terrain_<x>_<y>_<zoom>.png');
+const data = getPixelData(terrainData); // Extract RGB values
+const height = -10000 + ((r * 65536 + g * 256 + b) * 0.1); // Mapbox terrain RGB formula
+```
 
+Ensure the output folder matches your project's tile cache directory, and use the same zoom levels (e.g., 14) for consistency with your rendering logic.
+
+## Map Providers
 
-    cd ./site
-    http-server .
-    
+- **OpenStreetMap (OSM)**: Free, no token required. Tiles are natively PNG. [Website](https://www.openstreetmap.org/).
+- **Mapbox Satellite**: High-quality satellite imagery, converted from JPG to PNG for consistency. Requires a Mapbox access token. [Website](https://api.mapbox.com/).
+- **Mapbox Terrain RGB**: Elevation data encoded in RGB PNG tiles. Requires a Mapbox access token. [Website](https://docs.mapbox.com/data/tilesets/reference/mapbox-terrain-rgb-v1/).
 
+Obtain a Mapbox token from [Mapbox Account](https://account.mapbox.com/).
 
+## Notes
 
+- **Rate Limits**: Mapbox enforces rate limits (e.g., 750 requests/min for satellite, 200 for terrain RGB on free tiers). Adjust `--concurrency` to avoid being throttled.
+- **File Overwrites**: Use `--force=true` to redownload tiles if they are outdated or corrupted.
+- **File Size**: Mapbox Satellite tiles are converted to PNG, which may increase file size compared to JPG. Consider disk space for large areas.
+- **Tile Validation**: For critical applications, validate PNG tiles post-download to ensure integrity (e.g., using `sharp` metadata).
 
-### Disclaimer
-Please make sure to review any terms and conditions of map providers you want to use. Author assumes no liability for any incidental, consequential or other liability from the use of this product.
 
+## Disclaimer
 
+Please review the terms and conditions of your chosen map provider (e.g., [OpenStreetMap](https://www.openstreetmap.org/copyright), [Mapbox](https://www.mapbox.com/tos)). The author assumes no liability for any incidental, consequential, or other damages arising from the use of this tool.

package/bin/mapcache_download.js

@@ -0,0 +1,325 @@
+/*
+    Enhanced Map Tile Downloader with Terrain Support and Single Extension
+    - Downloads map tiles (satellite or terrain RGB) for a given geographic bounding box and zoom range.
+    - Saves all tiles as PNG for consistency, converting Mapbox Satellite tiles from JPG to PNG.
+    - Supports OpenStreetMap (default) and Mapbox (with token) for satellite and terrain RGB tiles.
+    - Parallel downloads with configurable concurrency to respect rate limits.
+    - Retry mechanism for failed downloads.
+    - Creates output folder if it doesn't exist.
+    - Progress reporting with total count and completion percentage.
+    - Better input validation and default values.
+    - Force redownload option.
+    - Improved error handling and logging.
+
+    Usage: node downloader.js --lat1=<lat> --lng1=<lng> --lat2=<lat> --lng2=<lng> --zin=<max_zoom> [options]
+
+    Run with --help for full options.
+*/
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const axios = require("axios");
+const sharp = require("sharp"); // Added for JPG-to-PNG conversion
+const v_pjson = require("../package.json"); // Assuming this exists; otherwise, hardcode version.
+const c_args = require("../helpers/hlp_args.js"); // Assuming this provides getArgs().
+const c_colors = require("../helpers/js_colors.js").Colors; // Assuming this provides color codes.
+
+const EARTH_RADIUS = 6378137;
+const MAX_LATITUDE = 85.0511287798;
+const R_MINOR = 6356752.314245179; // Not used, but kept for completeness.
+
+// Default values
+const DEFAULT_PROVIDER = 0; // 0: OSM, 1: Mapbox Satellite, 2: Mapbox Terrain RGB
+const DEFAULT_CONCURRENCY = 5; // Safe default to avoid rate limits
+const DEFAULT_RETRIES = 3;
+const DEFAULT_ZOUT = 0;
+const DEFAULT_FORCE = false;
+
+// Global variables
+let map_provider = DEFAULT_PROVIDER;
+let TOKEN = ""; // Required for Mapbox
+let myArgs = c_args.getArgs();
+let totalTiles = 0;
+let downloadedTiles = 0;
+
+/*
+ * Projection functions (unchanged)
+ */
+function project(p_lat, p_lng) {
+  const d = Math.PI / 180,
+    max = MAX_LATITUDE,
+    lat = Math.max(Math.min(max, p_lat), -max),
+    sin = Math.sin(lat * d);
+
+  return {
+    x: EARTH_RADIUS * p_lng * d,
+    y: (EARTH_RADIUS * Math.log((1 + sin) / (1 - sin))) / 2,
+  };
+}
+
+function unproject(point) {
+  const d = 180 / Math.PI;
+
+  return {
+    lat: (2 * Math.atan(Math.exp(point.y / EARTH_RADIUS)) - Math.PI / 2) * d,
+    lng: (point.x * d) / EARTH_RADIUS,
+  };
+}
+
+function zoomScale(zoom) {
+  return 256 * Math.pow(2, zoom);
+}
+
+function transform(point, scale) {
+  scale = scale || 1;
+  point.x = scale * (2.495320233665337e-8 * point.x + 0.5);
+  point.y = scale * (-2.495320233665337e-8 * point.y + 0.5);
+  return point;
+}
+
+function fn_convertFromLngLatToPoints(lat1, lng1, lat2, lng2, zoom) {
+  // Normalize bounds
+  if (lng1 > lng2) [lng1, lng2] = [lng2, lng1];
+  if (lat1 > lat2) [lat1, lat2] = [lat2, lat1];
+
+  let point1 = project(lat1, lng1);
+  let point2 = project(lat2, lng2);
+
+  let scaledZoom = zoomScale(zoom);
+  point1 = transform(point1, scaledZoom);
+  point2 = transform(point2, scaledZoom);
+
+  // Floor to tile indices
+  point1.x = Math.floor(point1.x / 256);
+  point1.y = Math.floor(point1.y / 256);
+  point2.x = Math.floor(point2.x / 256);
+  point2.y = Math.floor(point2.y / 256);
+
+  // Ensure point1 is top-left, point2 bottom-right
+  if (point1.y > point2.y) [point1.y, point2.y] = [point2.y, point1.y];
+
+  return [point1, point2];
+}
+
+/* ============================================================
+  Enhanced Download Function with Retry
+============================================================ */
+
+const download_image = async (url, image_path, isMapboxSatellite = false, retries = myArgs.retries || DEFAULT_RETRIES) => {
+  for (let attempt = 1; attempt <= retries; attempt++) {
+    try {
+      const response = await axios({
+        url,
+        responseType: "arraybuffer", // Changed to arraybuffer for sharp compatibility
+        timeout: 10000, // 10s timeout
+      });
+
+      // Convert to PNG if Mapbox Satellite (JPG), otherwise save directly
+      const buffer = isMapboxSatellite
+        ? await sharp(response.data).png().toBuffer()
+        : response.data;
+
+      await fs.promises.writeFile(image_path, buffer);
+      return; // Success
+    } catch (error) {
+      console.log(c_colors.BError + `Attempt ${attempt} failed for ${url}: ${error.message}` + c_colors.Reset);
+      if (attempt === retries) {
+        throw error; // Final failure
+      }
+      await new Promise(resolve => setTimeout(resolve, 1000 * attempt)); // Exponential backoff
+    }
+  }
+};
+
+/* ============================================================
+  Generate Tile URL and Filename
+============================================================ */
+
+function getTileUrlAndFilename(i, j, zoom) {
+  let url, typePrefix, isMapboxSatellite = false;
+  if (map_provider === 1) {
+    // Mapbox Satellite
+    url = `https://api.mapbox.com/styles/v1/mapbox/satellite-v9/tiles/${zoom}/${i}/${j}?access_token=${TOKEN}`;
+    typePrefix = "sat";
+    isMapboxSatellite = true;
+  } else if (map_provider === 2) {
+    // Mapbox Terrain RGB
+    url = `https://api.mapbox.com/v4/mapbox.terrain-rgb/${zoom}/${i}/${j}.png?access_token=${TOKEN}`;
+    typePrefix = "terrain";
+  } else {
+    // OpenStreetMap
+    url = `https://tile.openstreetmap.org/${zoom}/${i}/${j}.png`;
+    typePrefix = "osm";
+  }
+  const filename = `${typePrefix}_${i}_${j}_${zoom}.png`; // Always PNG
+  return { url, filename, isMapboxSatellite };
+}
+
+/* ============================================================
+  Download Tiles for a Zoom Level (Parallel with Concurrency)
+============================================================ */
+
+async function fn_download_tiles_for_zoom(point1, point2, zoom, folder, force) {
+  const tiles = [];
+  for (let i = point1.x; i <= point2.x; i++) {
+    for (let j = point1.y; j <= point2.y; j++) {
+      tiles.push({ i, j });
+    }
+  }
+
+  totalTiles += tiles.length;
+  console.log(c_colors.BSuccess + `Queueing ${tiles.length} tiles for zoom ${zoom}...` + c_colors.Reset);
+
+  // Process in batches to limit concurrency
+  const concurrency = myArgs.concurrency || DEFAULT_CONCURRENCY;
+  for (let batchStart = 0; batchStart < tiles.length; batchStart += concurrency) {
+    const batch = tiles.slice(batchStart, batchStart + concurrency);
+    await Promise.all(
+      batch.map(async ({ i, j }) => {
+        const { url, filename, isMapboxSatellite } = getTileUrlAndFilename(i, j, zoom);
+        const image_path = path.join(folder, filename);
+
+        if (!force && fs.existsSync(image_path)) {
+          console.log(c_colors.FgCyan + `Skipping existing: ${filename}` + c_colors.Reset);
+          downloadedTiles++;
+          updateProgress();
+          return;
+        }
+
+        try {
+          await download_image(url, image_path, isMapboxSatellite);
+          console.log(c_colors.BSuccess + `Downloaded: ${filename}` + c_colors.Reset);
+        } catch (error) {
+          console.error(c_colors.BError + `Failed to download ${filename} after retries.` + c_colors.Reset);
+        } finally {
+          downloadedTiles++;
+          updateProgress();
+        }
+      })
+    );
+  }
+}
+
+/* ============================================================
+  Progress Updater
+============================================================ */
+
+function updateProgress() {
+  const progress = ((downloadedTiles / totalTiles) * 100).toFixed(2);
+  console.log(c_colors.FgYellow + `Progress: ${downloadedTiles}/${totalTiles} (${progress}%)` + c_colors.Reset);
+}
+
+/* ============================================================
+  Input Validation and Argument Handling
+============================================================ */
+
+function fn_handle_arguments() {
+  myArgs = c_args.getArgs();
+  let error = false;
+
+  if (myArgs.help || myArgs.h || myArgs.version || myArgs.v) {
+    console.log(
+      c_colors.BSuccess +
+        "MAP Tile Downloader v" +
+        c_colors.FgYellow +
+        (v_pjson.version || "1.0.0") +
+        c_colors.Reset
+    );
+    console.log(c_colors.BSuccess + "Usage: node downloader.js --lat1=<lat> --lng1=<lng> --lat2=<lat> --lng2=<lng> --zin=<max_zoom> [options]" + c_colors.Reset);
+    console.log(c_colors.BSuccess + "--lat1, --lng1: Start coordinates (required)" + c_colors.Reset);
+    console.log(c_colors.BSuccess + "--lat2, --lng2: End coordinates (required)" + c_colors.Reset);
+    console.log(c_colors.BSuccess + "--zout: Min zoom (default: 0)" + c_colors.Reset);
+    console.log(c_colors.BSuccess + "--zin: Max zoom (required, e.g., 18)" + c_colors.Reset);
+    console.log(c_colors.BSuccess + "--folder: Output folder (required, e.g., ./out)" + c_colors.Reset);
+    console.log(c_colors.BSuccess + "--provider: 0=OSM (default), 1=Mapbox Satellite, 2=Mapbox Terrain RGB" + c_colors.Reset);
+    console.log(c_colors.BSuccess + "--token: Mapbox access token (required if provider=1 or 2)" + c_colors.Reset);
+    console.log(c_colors.BSuccess + "--concurrency: Parallel downloads (default: 5)" + c_colors.Reset);
+    console.log(c_colors.BSuccess + "--retries: Retry attempts per tile (default: 3)" + c_colors.Reset);
+    console.log(c_colors.BSuccess + "--force: Redownload existing files (default: false)" + c_colors.Reset);
+    process.exit(0);
+  }
+
+  // Required args
+  ["lat1", "lng1", "lat2", "lng2", "zin", "folder"].forEach(arg => {
+    if (!myArgs[arg]) {
+      error = true;
+      console.log(c_colors.BError + `Missing required argument: --${arg}` + c_colors.Reset);
+    }
+  });
+
+  // Validate lat/lng
+  ["lat1", "lat2"].forEach(arg => {
+    if (myArgs[arg] && (myArgs[arg] < -90 || myArgs[arg] > 90)) {
+      error = true;
+      console.log(c_colors.BError + `Invalid latitude ${arg}: ${myArgs[arg]} (must be -90 to 90)` + c_colors.Reset);
+    }
+  });
+  ["lng1", "lng2"].forEach(arg => {
+    if (myArgs[arg] && (myArgs[arg] < -180 || myArgs[arg] > 180)) {
+      error = true;
+      console.log(c_colors.BError + `Invalid longitude ${arg}: ${myArgs[arg]} (must be -180 to 180)` + c_colors.Reset);
+    }
+  });
+
+  // Provider and token
+  map_provider = myArgs.provider ? parseInt(myArgs.provider) : DEFAULT_PROVIDER;
+  if (map_provider === 1 || map_provider === 2) {
+    TOKEN = myArgs.token;
+    if (!TOKEN) {
+      error = true;
+      console.log(c_colors.BError + "Missing --token for Mapbox provider (satellite or terrain)." + c_colors.Reset);
+    }
+  }
+
+  // Zooms
+  myArgs.zout = myArgs.zout ? parseInt(myArgs.zout) : DEFAULT_ZOUT;
+  myArgs.zin = parseInt(myArgs.zin);
+  if (myArgs.zout > myArgs.zin || myArgs.zout < 0 || myArgs.zin > 22) {
+    error = true;
+    console.log(c_colors.BError + "Invalid zoom range: zout <= zin, 0-22." + c_colors.Reset);
+  }
+
+  // Force
+  myArgs.force = myArgs.force === "true" || myArgs.force === true ? true : DEFAULT_FORCE;
+
+  if (error) process.exit(1);
+
+  // Create folder if needed
+  const folder = myArgs.folder;
+  if (!fs.existsSync(folder)) {
+    fs.mkdirSync(folder, { recursive: true });
+    console.log(c_colors.BSuccess + `Created output folder: ${folder}` + c_colors.Reset);
+  }
+}
+
+/* ============================================================
+  Main Execution
+============================================================ */
+
+async function main() {
+  fn_handle_arguments();
+  const folder = myArgs.folder;
+  const force = myArgs.force;
+
+  // Calculate total tiles across all zooms for progress
+  for (let zoom = myArgs.zout; zoom <= myArgs.zin; zoom++) {
+    const [point1, point2] = fn_convertFromLngLatToPoints(myArgs.lat1, myArgs.lng1, myArgs.lat2, myArgs.lng2, zoom);
+    totalTiles += (point2.x - point1.x + 1) * (point2.y - point1.y + 1);
+  }
+
+  console.log(c_colors.BSuccess + `Total tiles to process: ${totalTiles}` + c_colors.Reset);
+
+  // Download per zoom
+  for (let zoom = myArgs.zout; zoom <= myArgs.zin; zoom++) {
+    const [point1, point2] = fn_convertFromLngLatToPoints(myArgs.lat1, myArgs.lng1, myArgs.lat2, myArgs.lng2, zoom);
+    await fn_download_tiles_for_zoom(point1, point2, zoom, folder, force);
+  }
+
+  console.log(c_colors.BSuccess + "Download complete!" + c_colors.Reset);
+}
+
+main().catch(error => {
+  console.error(c_colors.BError + `Unexpected error: ${error.message}` + c_colors.Reset);
+  process.exit(1);
+});

package/package.json

@@ -1,24 +1,52 @@
 {
   "name": "mapcachetools",
-  "version": "1.0.7",
-  "description": "This tool downloads images from a map provider and cache it locally on your device. Please check terms and condition of your map provider. The tool is provided as is with no responsibility from author. Please Use IT AT YOUR OWN RISK.",
-  "main": "downloadmaps.js",
-  "scripts": {
-    "start": "node ./bin/downloadmaps.js"
-  },
+  "version": "2.1.0",
+  "description": "A Node.js tool to download and cache map tiles (OSM, Mapbox Satellite, Mapbox Terrain RGB) as PNG images for offline use in mapping applications. Use at your own risk and comply with provider terms.",
+  "main": "bin/mapcache_download.js",
   "bin": {
-    "mapcache_download": "mapcache_download.js"
+    "mapcache-download": "./bin/mapcache_download.js"
+  },
+  "scripts": {
+    "start": "node ./bin/mapcache_download.js",
+    "test": "jest",
+    "prepublishOnly": "npm test"
   },
   "keywords": [
     "map",
-    "local server",
-    "cache"
+    "tile",
+    "cache",
+    "openstreetmap",
+    "mapbox",
+    "terrain",
+    "offline",
+    "leaflet",
+    "threejs"
   ],
   "homepage": "https://github.com/HefnySco/mapcache",
-  "author": "Mohammad Said Hefny - rcmobilestuff <rcmobilestuff@gmail.com> (http://www.andruav.com)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HefnySco/mapcache.git"
+  },
+  "bugs": {
+    "url": "https://github.com/HefnySco/mapcache/issues"
+  },
+  "author": "Mohammad Said Hefny <rcmobilestuff@gmail.com> (http://www.andruav.com)",
   "license": "ISC",
   "dependencies": {
-    "axios": "^0.21.1",
-    "request": "^2.88.2"
-  }
+    "axios": "^1.7.7",
+    "sharp": "^0.34.0"
+  },
+  "devDependencies": {
+    "eslint": "^8.57.0",
+    "jest": "^30.2.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "bin",
+    "helpers",
+    "README.md",
+    "LICENSE"
+  ]
 }

package/REALKEY.txt

@@ -1 +0,0 @@
-const TOKEN = "pk.eyJ1IjoiaHNhYWQiLCJhIjoiY2tqZnIwNXRuMndvdTJ4cnV0ODQ4djZ3NiJ9.LKojA3YMrG34L93jRThEGQ"