@wemap/core 14.6.0-beta.4 → 14.6.0

package/README.md

@@ -8,6 +8,7 @@ The core package provides the foundational functionality for the Wemap SDK, incl
 - **Configuration Management**: Access global configuration across all SDK packages
 - **HTTP Client**: Robust HTTP client with automatic JSON parsing, error handling, and timeout support
 - **Livemap Service**: Fetch and parse livemap data from the Wemap API
+- **Geocoding**: Forward and reverse geocoding via the Wemap geocoding API
 
 ## Getting Started
 
@@ -17,8 +18,7 @@ import { core } from '@wemap/core';
 // Initialize the SDK
 await core.init({
   emmid: 'your-emmid',
-  token: 'your-token',
-  env: 'production' // or 'development'
+  token: 'your-token'
 });
 
 // Access configuration
@@ -30,6 +30,7 @@ const config = CoreConfig.getConfig();
 - **CoreConfig**: Main configuration class for SDK initialization
 - **HttpClient**: HTTP client for making API requests
 - **LivemapService**: Service for fetching livemap data
+- **GeocodingService**: Forward and reverse geocoding
 
 ## Content search / pinpoint search
 
@@ -67,3 +68,46 @@ Query normalisation (livemap parity):
 The exported `Pinpoint` type is a minimal read model: `id`, `name`,
 `description?`, coordinates, `level?`, `altitude?`, `tags?`, `category?`,
 `image_url?`, `address?`.
+
+## Geocoding
+
+Forward and reverse geocoding against `https://geocoding.getwemap.workers.dev`.
+Does not require `core.init()`:
+
+```typescript
+import { GeocodingService, core } from '@wemap/core';
+
+const geocoding = core.createGeocodingService({ language: 'fr', region: 'fr' });
+// or: new GeocodingService({ language: 'fr' })
+
+const place = await geocoding.search('Paris');
+const places = await geocoding.searchMultiple('Paris');
+const address = await geocoding.reverseGeocode(48.85, 2.35);
+```
+
+`GeocodingResult` exposes `id`, `placeType`, `relevance`, `text`, `placeName`,
+`language?`, `latitude`, `longitude`, and optional `bbox` as
+`[west, south, east, north]`. Per-call `language` / `region` / `bbox` override
+constructor defaults.
+
+## Tags & categories
+
+Livemaps ship with a tag configuration:
+the tags used to classify pinpoints, and the categories they can be grouped by.
+Read them after `core.init()` to build tag filters, legends or category menus:
+
+```typescript
+import { CoreConfig, core } from '@wemap/core';
+
+await core.init({ emmid: '31668', token: 'YOUR_TOKEN' });
+
+const { tags, categories } = CoreConfig.getTagsConfig();
+
+// e.g. group tags by category slug
+const transport = tags.filter((tag) => tag.category === 'transport');
+```
+
+Each `LivemapTag` exposes `name`, `slug`, and optional `category` (a category
+slug), `color` and `icon`. A pinpoint references its tags by `slug`
+(`Pinpoint.tags`), so you can join the two. Each `LivemapTagCategory` exposes
+`name` and `slug`. Both arrays are empty when the livemap has no tags.

package/dist/index.d.ts

@@ -5,10 +5,13 @@ export * from './src/CoreConfig';
 export * from './src/services/LivemapService';
 export * from './src/services/BuildingService';
 export * from './src/services/PinpointManager';
+export * from './src/services/GeocodingService';
 export * from './src/services/HttpClient';
 export type { LatLngLike } from './src/types/common';
 export type { Building, IndoorLevel } from './src/types/indoor';
 export type { Pinpoint, PinpointBoundsParams, PinpointSearchQuery, PinpointSearchResponse, PinpointResolver, } from './src/types/pinpoint';
+export type { GeocodingResult, GeocodingSearchOptions, GeocodingServiceOptions, } from './src/types/geocoding';
+export type { LivemapTag, LivemapTagCategory, LivemapTagsConfig, } from './src/types/tags';
 export { latLngLikeToCoordinates, boundsToDelta } from './src/utils/map';
 export { DEFAULT_THEME, resolveTheme, themeToCssVariables, } from './src/theme';
 export type { WemapTheme } from './src/theme';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAE1C,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,QAAQ,EACR,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAE1C,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,QAAQ,EACR,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}