Cerrar
View Categories

Javascript SDK Changelog

Version 0.16.0 – February 03, 2026 #

Added

Version 0.15.0 – January 08, 2026 #

Added

  • Add new methods to manage GeoJSON and GeoJSONTheme. Upload a GeoJSON:
   await situmSDK.cartography.uploadGeoJSON({
     buildingId: 1234,
     geojson: myGeoJSON
   });

Delete a GeoJSON:

   await situmSDK.cartography.deleteGeoJSON(buildingId);

Upload a GeoJSON theme:

    await situmSDK.cartography.uploadGeoJSONTheme({
      buildingId: 1234,
      theme: myGeoJSONTheme
    });

Version 0.14.0 – December 11, 2025 #

Changed

  • Added new method to center camera in the Map Viewer component.
    viewer.setCamera({ zoom: 10, bearing: 0, pitch: 0, transitionDuration: 1000, center: { latitude: 42.863450025098274, longitude: -8.54359901596718 } });

Version 0.13.0 – December 11, 2025 #

Added

  • Added new method to set the UI mode of the viewer.
    viewer.setUiMode({ mode: "explore" });
  • Added new method to calculate static routes between two points.
    viewer.startDirections({ navigationFrom: 1, navigationTo: 2, routeType: "CHOOSE_SHORTEST", });

Version 0.12.3 – December 09, 2025 #

Fixed

  • Fixed incorrect export of SitumApiPermissionLevel enum.

Version 0.12.2 – December 02, 2025 #

Changed

  • Exported SitumApiPermissionLevel, BuildingListElement, PoiCategory, PoiCreateForm, PoiUpdateForm, CustomField and Organization types

Version 0.12.1 – December 01, 2025 #

Fixed

  • Fixed incorrect parameter typing in public methods selectPoiCategory, deselectPoiCategory, selectFloor, selectCar, setFollowUser and cleanTrajectory.

Changed

  • Improved MapViewer event and action typings for better developer experience and stricter type validation.

Version 0.12.0 – November 14, 2025 #

Added

  • Add new method to deselect poi categories:

viewer.deselectPoiCategory();

Fixed

  • Fixed Typescript types not being exported correctly.

Internal

  • Code analysis using Trivy.

Version 0.10.0 – October 2, 2025 #

Added

  • Add new Viewer domain to ease integration of map viewer using JS:
    • New API allows to render a map with indoor features and control it via JS apis
    • Allows to show multiple viewers on the same web page (Factory method)
    • Allows to show realtime users using Situm REST API on top of the map viewer
    • Allows to show user trajectories reports using Situm REST API on top of the map viewer
    • Added event subscribing for map is ready, poi selected, building selected, floor selected, etc
  • Add new reports domain that allows to fetch information from the Situm REST API /api/v1/reports
  • Uploaded an example on github using 2 map viewer instances and showing Real Time users & Trajectories and another one on SDK’s documentation

Improved

  • Bump JS dependencies
  • Replace eslint and prettier with biome

Security

Version 0.9.1 – April 9, 2025 #

Improved

  • Bump JS dependencies.

Version 0.9.0 – April 9, 2025 #

Added

  • New uploadImage method for uploading images to Situm services

Version 0.8.10 – February 19, 2025 #

Fixed

  • Fixed typo in path link types

Version 0.8.9 – February 17, 2025 #

Fixed

  • Rename getApiKeys to getPositioningApiKeys, and limit api key fetching to positioning privileges

Version 0.8.8 – February 10, 2025 #

Fixed

  • Republish version due to error

Version 0.8.7 – February 10, 2025 #

Fixed

  • Internal Improvements

Version 0.8.6 – February 10, 2025 #

Added

  • New function to fetch user’s positioning and read-only apikeys

Fixed

  • Typos fixing

Version 0.8.5 – November 12, 2024 #

Added

  • Added icon and selectedIcon as optional props to PoiUpdateForm

Version 0.8.4 – October 18, 2024 #

Improved

  • Improve build process to export types so third-party can use them
  • Improve GeofenceForm.geometric type

Version 0.8.3 – September 17, 2024 #

Fixed

  • Fix typo in SitumApiPermissionLevel typing enum

Version 0.8.2 – September 11, 2024 #

Added

  • Move all the auth session logic to its own domain, this allows third integrators to query for session information, specifically permission access level
  • Lazy load all internal domain (cartography, auth, realtime, user). This improves code maintability

Improved

  • Improved documentation

Version 0.8.1 – July 19, 2024 #

Fixed

  • Fix build problem

Version 0.8.0 – July 18, 2024 #

Added

  • Implement new auth mechanism by direct pass of a JWT string
  • Add method to renew expired JWT

Improvements

  • Migrate all tests to raw jest expectations, removed chai and mocha
  • Improve all JSDoc comments
  • Updated almost all dependencies to latest versions (important to fix a CVE from axios)

Fixed

  • Fix createPoi and patchPoi methods broken due to invalid types

Version 0.7.1 – April 24, 2024 #

Fixed

  • Fixed error on pois fetching duplicating pois when there were outdoor pois

Version 0.7.0 – November 3, 2023 #

Fixed

  • Query params where not passed propertly from the external api to the internal state.

Added

  • Add new compact view support for the buildings and pois endpoints. This new view allow to save bandwidth while fetching information.

Version 0.6.1 – August 18, 2023 #

Improvements

  • Remove the email parameter in email/apikey authentication. Now you only need to specify a valid apikey.

Version 0.5.0 – May 26, 2023 #

Added

  • Added cartesian coordinates to Poi instances.

Version 0.4.0 – March 30, 2023 #

  • SDKConfiguration may include an optional lang parameter to override the Accept-Language HTTP header. Fallbacks to “en” if no language is provided. This avoids known issues when retrieving translated entities (bad translations due to sending arbitrary Accept-Language headers). Usage example:
const SitumSDK = require("@situm/sdk-js");
const situmSDK = new SitumSDK({
  auth: {
    apiKey: "MY-API-KEY",
    email: "MY-EMAIL",
  },
  domain: "https://dashboard.situm.com",
  lang: "es",
});

Technically you could use any standard Accept-Language values but we recommend to stick to ISO_639-1, avoiding language variants. For example, don’t use “es-GB”, use “es” instead.

Version 0.3.0 – November 2, 2022 #

Added:

  • We added a new API endpoint to fetch the information for the current_organization endpoint which returns the data related to user’s current organization

Fixed:

  • When using custom domains we were handling the color and icons fetching in an incorrect way, so we added an adapter for Poi Categories.

Version 0.2.0 – April 24, 2022 #

Improvements:

  • Update dependencies: axios and qs, to get the latest bugfixes.

Fixed:

  • In order to get assisted coding in VS Code and supported editors, now we export types properly to dist/index.d.ts

Version 0.1.0 – March 21, 2022 #

Improvements:

  • Package building:
    • We have moved to rollup and esbuild as our internal build system. This allow us to faster builds and pluggable systems.
    • Generate cjs, umd and es5 builds, so this library can be used in old browsers and import it as a <script> tag (check our example).
  • Dependencies
    • Update to latest axios library version, to get the latest bugfixes.
    • We have removed the jwt_decode depencency and use built-in function, so we lower the package size
  • We have unified function names
    • Rename realtime.getUserPositions to realtime.getPositions
    • Rename SitumSDK.cartography.getFloorsOfBuildingId to SitumSDK.cartography.getFloors
    • Rename SitumSDK.cartography.updatePath to SitumSDK.cartography.patchPath
    • Rename SitumSDK.cartography.getPoisOfBuiding to SitumSDK.cartography.getPois, now supports filtering
    • Rename SitumSDK.cartography.searchGeofences to SitumSDK.cartography.getGeofences
  • Move SitumError class to utils
  • Avoid using a JS Proxy to resolve domains in the api base
  • Take mappers out from realtime domain class
  • Documentation
    • Added documentation for all domain methods
    • Improve typing system by using Typescript generics in the base API
    • Improved typedoc configuration to export symbols of internal domain classes

Fixed:

  • Disable injecting the SDK version through the User-Agent HTTP header for now, some browsers were crashing due to user-agent header being not writable.
  • There was a double check for User-Agent headers check in apiBase, we have removed the dulication
  • There was a double check or Content-Type header while building request headers
  • We force the internal classes to pass configuration Ensure to pass base configuration in the SitumSDK main class. We detected situations where the configuration was lost.

Version 0.0.5 – February 21, 2022 #

Improvements:

  • We have moved API to Object (functions to map server responses to TS objects) adapters into their separated forder
  • We added JSDoc Added JSDoc to all API wrappers
  • We have unified function names
    • Renamed SitumSDK.cartography.getFloorsOfBuilding to SitumSDK.cartography.getFloorsByBuildingId
    • Renamed SitumSDK.cartography.searchGeofences to SitumSDK.cartography.getGeofences

Fixed:

  • Crash in cartography fetch request due to improper server response handling

Version 0.0.4 – February 14, 2022 #

Added:

  • API wrappers for the POI REST api

Fixed:

  • ES 2017 support

Version 0.0.1 – December 30, 2021 #

Hello World! This is the first version of the Situm Javascript SDK. Please bear in mind this is the first draft version. You must not use it as a production-ready package. We will publish further more stable versions.

Added:

  • Consumer wrappers for the SITUM REST API for buildings and their cartography (floors, geofences, pois, paths, events),
  • Users and fetching realtime positioning.
  • We also added multiple authentication methods

Updated on 04/02/2026

Was this page useful?

Subscribe to our newsletter

BASIC INFORMATION ON DATA PROTECTION

Data controller: SITUM TECHNOLOGIES, S.L.
Contact: Data controller: situm@situm.es
Responsible for protection: dpo@situm.es
Purpose and legal basis: To manage the sending of SITUM newsletters only with consent.
Legitimation: Express consent of the interested party.
Recipients: The data will not be passed on to third parties with the exception of legal obligations.
Retention period: As long as the interested party remains subscribed to the newsletter (a link to unsubscribe will be available in each newsletter sent by Situm).
Rights: The interested party may at any time revoke their consent, as well as exercise their rights of opposition, access, conservation, rectification, limitation, deletion of data and not be subject to a decision based only on automated data processing, by writing to SITUM at the addresses indicated.
Additional Information: You can consult additional and detailed information on Data Protection in our privacy policy.

Please, download your copy here

Thank you for downloading our whitepaper. Please do not hesitate to contact us if you would like to know more about how our solutions can help your business. Download whitepaper


Close window