Appearance
Version Compatibility
Browser Support
The Mapsted Maps JavaScript API supports all modern browsers that implement ES2020 and the postMessage API.
| Browser | Minimum Version | Notes |
|---|---|---|
| Chrome | 90+ | Full support |
| Firefox | 90+ | Full support |
| Safari | 15+ | Full support (including iOS Safari) |
| Edge | 90+ | Full support (Chromium-based) |
| Samsung Internet | 14+ | Full support |
| Opera | 76+ | Full support |
Not Supported
- Internet Explorer (any version)
- Opera Mini
- Browsers without ES2020 support
Runtime Support
| Runtime | Minimum Version | Notes |
|---|---|---|
| Node.js | ≥ 20 | For SSR/build tools only (API requires DOM for runtime) |
| Deno | 1.30+ | Untested but should work with DOM shim |
| Bun | 1.0+ | Untested but should work |
TypeScript Support
| TypeScript | Compatibility |
|---|---|
| 5.0+ | Full support with strict mode |
| 4.x | May work but not tested; discriminated overloads require 5.0+ |
| 3.x | Not supported |
API Distribution Formats
The shapes below match package.json exports exactly — copy-paste safe.
| Format | File | package.json field(s) | Use Case |
|---|---|---|---|
| ESM | dist/index.mjs | module, exports["."].import.default | Modern bundlers (Vite, Webpack 5, Rollup), import syntax |
| CJS | dist/index.cjs | main, exports["."].require.default | Legacy Node.js require() |
| IIFE | dist/index.min.js | unpkg, jsdelivr, exports["./cdn"] | CDN <script> tag |
| Types (ESM) | dist/index.d.ts | types, exports["."].import.types | TypeScript IntelliSense for ESM consumers |
| Types (CJS) | dist/index.d.cts | exports["."].require.types | TypeScript IntelliSense for CJS consumers |
CDN Versioning
mapi.mapsted.com is the single production CDN origin and serves every version directly. The current release is 4.0.1 (date-based: 26 = 2026, 7 = July, 1 = release).
CDN URL pattern: https://mapi.mapsted.com/v{VERSION}/maps.js?id={PROPERTY_ID} — for example https://mapi.mapsted.com/v4.0.1/maps.js?id={PROPERTY_ID}.
Because mapi.mapsted.com keeps serving all versions, hardcoded legacy V3/V2 <script src> tags keep working with no change and no redirect — existing customers require no action.
| Version | Status | Lifecycle | URL Pattern |
|---|---|---|---|
| 4.0.1 | Current | GA | mapi.mapsted.com/v4.0.1/maps.js |
| v3.0.0 | Deprecated 2026-Q4 → maintenance-only 2027-Q2 → full V3 retire 2028-Q1 | Migration shim removed in the next major release (@mapsted/maps-js-api, target Q3 2028); the mapi.mapsted.com/v3.0.0/maps.js URL keeps responding throughout — hardcoded customer scripts never break | mapi.mapsted.com/v3.0.0/maps.js |
| v2.x | End-of-life | Migration support only — see V2 migration | mapi.mapsted.com/v2.x.x/maps.js |
See also: Changelog | API Reference