2.5.1

• Logging requests.

2.5.0

• First official TypeScript web service release.
• Versioning scheme has changed to major.minor.patch now, dropping the last digit.

2.4.19.3

Complete port of Java web service.

1.0.0

First release of the TypeScript port of the Mapcode REST API service.

A drop-in, API-compatible replacement for the Java mapcode-rest-service, built on Fastify with the mapcode-ts library. Byte-for-byte JSON/XML parity with the Java service; superset test suite (521 tests).

Highlights

• Endpoints: /mapcode (help), /version, /status, /codes/{lat},{lon}[/{type}|/territories], /coords/{code}, /territories[/{t}], /alphabets[/{a}], with Accept-header and /xml/·/json/ content negotiation.
• In-memory typed-array OSM admin-boundary service (FlatGeobuf → flat Float64Array/CSR Uint32Array + flatbush + ray-cast point-in-polygon + admin-level/area ranking).
• .env configuration (Node --env-file); minimal runtime dependencies: fastify, mapcode-ts, flatgeobuf, flatbush.

Borders data
The service requires a FlatGeobuf borders file via MAPCODE_BORDERS_PATH. The files are attached to this release (not bundled in git):

• borders.fgb (22 MB, 100 m — default, balanced)
• borders-10m.fgb (74 MB, highest detail)
• borders-50m.fgb (33 MB)
• borders-100m.fgb (22 MB)

Run

npm install && npm run build
MAPCODE_BORDERS_PATH=./data/borders.fgb PORT=8080 node dist/index.js