@tomtom-org/maps-sdk 0.29.2 → 0.30.1

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [0.30.1](https://github.com/tomtom-internal/maps-sdk-js/compare/v0.30.0...v0.30.1) (2025-11-05)
+
+
+### Bug Fixes
+
+* pin category mapping ([a6aecb8](https://github.com/tomtom-internal/maps-sdk-js/commit/a6aecb8569e3865d32ca814684f1c8c8d1f3b3e0))
+
+## [0.30.0](https://github.com/tomtom-internal/maps-sdk-js/compare/v0.29.2...v0.30.0) (2025-11-05)
+
+
+### Features
+
+* enable tomtom user agent headers by default ([30bcc22](https://github.com/tomtom-internal/maps-sdk-js/commit/30bcc2264e5cd335c19b8f01699bc20de1141947))
+
+
+### Bug Fixes
+
+* route example content ([4b56065](https://github.com/tomtom-internal/maps-sdk-js/commit/4b56065916e512a7d3ea2d2af00e02fbc17b1c77))
+
 ## [0.29.2](https://github.com/tomtom-internal/maps-sdk-js/compare/v0.29.1...v0.29.2) (2025-11-04)
 
 

package/README.md

@@ -1,26 +1,33 @@
-[![TomTom Logo](./tomtom-logo-big.svg)](https://www.tomtom.com/)
+[//]: # ([![TomTom Logo](./tomtom-logo-big.svg)](https://www.tomtom.com/))
 
-# Maps SDK for JavaScript
+# TomTom Maps SDK for JavaScript
 
 [**Examples**](https://docs.tomtom.com/maps-sdk-js/examples/) |
-[**Documentation**](https://docs.tomtom.com/maps-sdk-js/introduction/overview) |
+[**Documentation**](https://docs.tomtom.com/maps-sdk-js/introduction/overview)
 
 [![NPM Version](https://img.shields.io/npm/v/@tomtom-org/maps-sdk.svg)](https://www.npmjs.com/package/@tomtom-org/maps-sdk)
 
 TomTom Maps SDK for JavaScript is a **JavaScript** library for building applications using [**TomTom** location maps and services](https://docs.tomtom.com/).
 
-[![SDK Example Thumbnails](./sdk-examples-collage.png)](https://docs.tomtom.com/maps-sdk-js/examples/)
+[//]: # ([![SDK Example Thumbnails](./sdk-examples-collage.png)](https://docs.tomtom.com/maps-sdk-js/examples/))
 
 It leverages the power of [MapLibre GL JS](https://github.com/maplibre/maplibre-gl-js) and [GeoJSON](https://geojson.org/)
 to seamlessly integrate TomTom maps and services with convenient out-of-the-box support, while staying highly customizable and extensible.
 <br/><br/>
 
+## ⚠️ Public Preview Notice
+We have released some capabilities in the Maps SDK under [Public Preview](https://docs.tomtom.com/legal/public-preview) to collect feedback from the community.
+While our goal is to keep the design of the interface stable, breaking changes may occur.
+We will do our utmost to communicate these breaking changes in advance, whenever possible.
+<br/><br/>
+
 ## 🚀 Getting Started using npm
 ```
 npm i @tomtom-org/maps-sdk
 ```
 Additionally:
 * If you use the map: ```npm i maplibre-gl```
+<br/><br/>
 
 ## 📚 Documentation & Examples
 
@@ -32,16 +39,14 @@ Explore comprehensive guides and interactive examples to get the most out of Map
 ### 📖 Documentation
 - **[Getting Started Guide](https://docs.tomtom.com/maps-sdk-js/introduction/overview)** - Introduction and key features
 - **[Project Setup](https://docs.tomtom.com/maps-sdk-js/introduction/project-setup)** - Step-by-step setup instructions
-- **[Map Guides](https://docs.tomtom.com/maps-sdk-js/guides/map/)** - Display and configure interactive maps
-- **[Services Guides](https://docs.tomtom.com/maps-sdk-js/guides/services/)** - Search, routing, and geocoding
-- **[Core Utilities](https://docs.tomtom.com/maps-sdk-js/guides/core/)** - Common configurations and utilities
+- **[How the SDK Works](https://docs.tomtom.com/maps-sdk-js/guides/how-the-sdk-works)** - Architecture and concepts
 
 ### 📋 API Reference
 - **[API Reference](https://docs.tomtom.com/maps-sdk-js/reference/overview)** - Complete API documentation
 
 ### 📝 Latest Updates
 - **[Release Notes](https://docs.tomtom.com/maps-sdk-js/overview/release-notes)** - What's new and breaking changes
-<br/><br/><br/>
+<br/><br/>
 
 ## 🌍 Where can you run it on?
 * **web**: display and configure a map, search for places, plan routes, and easily display and interact with them, including your own data
@@ -50,52 +55,16 @@ Explore comprehensive guides and interactive examples to get the most out of Map
 <br/><br/>
 
 ## 📦 Bundles
-```mermaid
-flowchart TD
-    App["Your application"]
-    MapLibre["MapLibre GL JS"]
-    subgraph SDK["SDK"]
-        direction TB
-        Map["Map"]
-        Services["Services"]
-        Core["Core"]
-    end
-
-    App --> Map
-    App --> MapLibre
-    App --> Services
-    App --> Core
-    
-    Map -.-> Core
-    Map -.-> MapLibre
-
-    Services -.-> Core
-
-    classDef mapClass fill:#fffde7,stroke:#ff6f00,color:#ff6f00;
-    classDef servicesClass fill:#f3e5f5,stroke:#4a148c,color:#4a148c;
-    classDef coreClass fill:#e8f5e9,stroke:#1b5e20,color:#1b5e20;
-    classDef maplibreClass fill:#295DAA,stroke:#295DAA,color:white;
-
-    class Map mapClass;
-    class Services servicesClass;
-    class Core coreClass;
-    class MapLibre maplibreClass;
-
-    click Map "##_Map" "Go to Map section"
-    click Services "#services" "Go to Services section"
-    click Core "#core" "Go to Core section"
-    click MapLibre "https://maplibre.org/maplibre-gl-js/docs/" "Go to MapLibre GL JS documentation"
-```
-
 * [Map](#map): MapLibre-powered library for readily styled, service-compatible and interactive TomTom Maps
-* * [MapLibre](https://maplibre.org/maplibre-gl-js/docs/) is an open source peer dependency so your application can also use it directly
+  * [MapLibre](https://maplibre.org/maplibre-gl-js/docs/) is an open source peer dependency so your application can also use it directly
 * [Services](#services): Functions with GeoJSON services for TomTom location APIs
-* * Compatible with web, nodejs and React Native applications
+  * Compatible with web, nodejs and React Native applications
 * [Core](#core): shared configuration, types and utilities
-* * Facilitates seamless integration between map and services
+  * Facilitates seamless integration between map and services
+<br/><br/>
 
 ## 🗺️ Map
-The SDK [Map bundle](https://developer-staging.tomtom.com/maps-sdk-js/api-reference/home#map-modules) is built on top of [MapLibre GL JS](https://maplibre.org/maplibre-gl-js/docs/), and shares it as a dependency with your app.\
+The SDK [Map bundle](https://docs.tomtom.com/maps-sdk-js/guides/map/quickstart) is built on top of [MapLibre GL JS](https://maplibre.org/maplibre-gl-js/docs/), and shares it as a dependency with your app.\
 You can both use the TomTom and MapLibre SDKs together at any time.
 
 ### ✨ Feature highlights
@@ -117,7 +86,7 @@ Code imports from the SDK Map Bundle will come from ```@tomtom-org/maps-sdk/map`
 <br/><br/>
 
 ## 🔧 Services
-The SDK [Services bundle](https://developer-staging.tomtom.com/maps-sdk-js/api-reference/home#service-modules) integrates the TomTom location APIs into comprehensive [GeoJSON](https://geojson.org/) services.\
+The SDK [Services bundle](https://docs.tomtom.com/maps-sdk-js/guides/services/quickstart) integrates the TomTom location APIs into comprehensive [GeoJSON](https://geojson.org/) services.\
 The services can be integrated in **web**, [nodejs](https://nodejs.org/) and [React Native](https://reactnative.dev/) apps.\
 The compatibility of both inputs and outputs with [GeoJSON](https://geojson.org/) helps with further integration with geospatial tools.
 

package/core/dist/core.cjs.js

@@ -263,8 +263,7 @@ const bboxFromGeoJSON = (hasBBox) => {
 const bboxExpandedWithGeoJSON = (geoJson, bboxToExpand) => bboxExpandedWithBBox(bboxFromGeoJSON(geoJson), bboxToExpand);
 const bboxCenter = (bbox) => [(bbox[0] + bbox[2]) / 2, (bbox[1] + bbox[3]) / 2];
 const generateId = () => Date.now().toString(36) + Math.random().toString(36).substring(2);
-const TOMTOM_USER_AGENT_SDK_NAME = "TomTomSDKsMapsJS";
-const SDK_VERSION = "__SDK_VERSION__";
+const TOMTOM_USER_AGENT_SDK_NAME = "MapsSDKJS";
 const validateTrackingId = (trackingId) => {
   if (!/^[a-zA-Z0-9-]{1,100}$/.test(trackingId)) {
     throw new TypeError(
@@ -274,9 +273,7 @@ const validateTrackingId = (trackingId) => {
   return trackingId;
 };
 const generateTomTomHeaders = (params) => ({
-  ...params.tomtomUserAgent && {
-    "TomTom-User-Agent": `${TOMTOM_USER_AGENT_SDK_NAME}/${SDK_VERSION}`
-  },
+  "TomTom-User-Agent": `${TOMTOM_USER_AGENT_SDK_NAME}/${"0.30.1"}`,
   // TODO: restore if we implement oauth2 access
   // optional oauth2 access token:
   // ...(params.apiAccessToken && { Authorization: `Bearer ${params.apiAccessToken}` }),