feat(distance): add Distance API support

[sylvesterdamgaard]

Summary

Add full Distance API support to the Node SDK, matching the PHP SDK implementation. This enables distance calculations between coordinates with type-safe enums and a flexible Coordinate class.

Changes

New Features

• Coordinate class - Flexible coordinate input handling with validation

  • Accepts strings ("lat,lng" or "lat,lng,id"), arrays ([lat, lng]), or objects ({lat, lng, id})
  • Validates latitude (-90 to 90) and longitude (-180 to 180) ranges
  • Converts to string format for GET requests and object format for POST requests

• distance() - Single origin to multiple destinations (GET /distance)

  • Supports all coordinate input formats
  • Options: mode, units, maxResults, maxDistance, minDistance, etc.

• distanceMatrix() - Multiple origins × destinations (POST /distance-matrix)

  • Full matrix calculation support
  • Same filtering options as distance()

• Async Job Methods for large calculations:

  • createDistanceMatrixJob() - Create background job
  • distanceMatrixJobStatus() - Check job status
  • distanceMatrixJobs() - List all jobs
  • getDistanceMatrixJobResults() - Get completed results
  • downloadDistanceMatrixJob() - Download to file
  • deleteDistanceMatrixJob() - Delete job

• Enhanced geocode()/reverse() - Optional distance parameters to calculate distances to destinations

New Types & Enums

• DistanceMode: straightline, driving, haversine
• DistanceUnits: miles, km
• DistanceOrderBy: distance, duration
• DistanceSortOrder: asc, desc
• Full TypeScript definitions for all response types

Other Changes

• Default API version updated to v1.9
• Package version bumped to 1.12.0
• Added "distance" and "distance-matrix" to package keywords

Test Plan

• Coordinate class unit tests (18 tests)
  • Creation from numbers, strings, arrays, objects
  • Validation of lat/lng ranges
  • toString() and toObject() conversion
• Enum value tests (4 tests)
• Integration tests with test API server (15 tests)
  • Basic distance calculation
  • Coordinate objects and array formats
  • Driving mode with duration
  • Kilometers unit
  • Max results filtering
  • Distance matrix (POST)
  • Geocode/reverse with distance
  • Job creation, status, and deletion