@c4h/beatbox

Mapbox scheme URL parser and MVT configuration translator for JavaScript.

Features

- Convert mapbox:// scheme URLs to HTTP URLs
- Parse Mapbox style configuration files
- Extract and translate all resource URLs (tiles, fonts, icons, sprites)
- Generate MVT configuration with fully resolved HTTP URLs
- Support for various Mapbox resource types:
- Styles: mapbox://styles/{username}/{style_id}
- Tiles: mapbox://tiles/{tileset_id}/{z}/{x}/{y}
- Composite tiles: mapbox://mapbox.mapbox-streets-v8,mapbox.mapbox-terrain-v2
- Fonts: mapbox://fonts/{username}/{font_stack}/{range}
- Sprites: mapbox://sprites/{username}/{style_id}

Installation

$3

``sh
npm install @c4h/beatbox
`

$3

`html

`

Usage

`typescript
import { BeatBox } from '@c4h/beatbox';

// Initialize with your Mapbox access token
const beatbox = new BeatBox({
accessToken: 'your-mapbox-access-token'
});

// Convert a single mapbox:// URL to HTTP
const httpUrl = beatbox.toHttpUrl('mapbox://styles/mapbox/streets-v11');
console.log(httpUrl);
// → https://api.mapbox.com/styles/v1/mapbox/streets-v11?access_token=...

// Convert composite tileset URLs
const compositeUrl = beatbox.toHttpUrl('mapbox://mapbox.mapbox-streets-v8,mapbox.mapbox-terrain-v2');
console.log(compositeUrl);
// → https://api.mapbox.com/v4/mapbox.mapbox-streets-v8,mapbox.mapbox-terrain-v2.json?access_token=...

// Parse and translate a complete style configuration
const styleUrl = 'mapbox://styles/moritoru/ck3xqi0hh1pob1cqpanp3jxxo';
const translatedStyle = await beatbox.translateStyle(styleUrl);
// Returns style JSON with all mapbox:// URLs converted to HTTP URLs

// Get all resource URLs from a style
const resources = await beatbox.getStyleResources(styleUrl);
console.log(resources);
// → {
// style: 'https://api.mapbox.com/styles/v1/...',
// tiles: ['https://api.mapbox.com/v4/...'],
// fonts: ['https://api.mapbox.com/fonts/v1/...'],
// sprites: ['https://api.mapbox.com/styles/v1/.../sprite']
// }
`

API Documentation

$3

The main class for Mapbox URL translation.

#### Constructor Options

- accessToken (string): Your Mapbox access token (required)
- apiUrl (string): Custom Mapbox API URL (default: 'https://api.mapbox.com')

#### Methods

- toHttpUrl(mapboxUrl: string): string - Convert a single mapbox:// URL to HTTP URL
- translateStyle(styleUrl: string): Promise