@kubesense/kubesense-browser-core 1.2.0 → 1.4.0

package/README.md

@@ -14,6 +14,134 @@ helpers.
 > - [`@kubesense/kubesense-browser-rum-slim`][rum-slim] — RUM without Session Replay
 > - [`@kubesense/kubesense-browser-logs`][logs] — Log collection
 
+## Geolocation
+
+The SDK provides utilities to collect user geolocation data using the browser's Geolocation API.
+
+> **Note:** Collecting geolocation requires explicit user permission. The browser will prompt the user to allow location access.
+
+### API
+
+```typescript
+import { canUseGeoLocation, getCurrentPosition, watchPosition, clearWatch } from '@kubesense/kubesense-browser-core'
+
+// Check if geolocation is supported
+if (canUseGeoLocation()) {
+  // Get position once
+  getCurrentPosition(
+    (position) => {
+      console.log(position.latitude, position.longitude, position.accuracy)
+    },
+    (error) => {
+      console.error(error.message)
+    },
+    { enableHighAccuracy: true, timeout: 10000 }
+  )
+
+  // Or watch position continuously
+  const watchId = watchPosition(
+    (position) => {
+      console.log(position.latitude, position.longitude)
+    },
+    (error) => {
+      console.error(error.message)
+    }
+  )
+
+  // Stop watching
+  clearWatch(watchId)
+}
+```
+
+### Using with RUM
+
+Add location data to all RUM events via global context:
+
+```typescript
+import { getCurrentPosition, canUseGeoLocation } from '@kubesense/kubesense-browser-core'
+import { kubsenseRum } from '@kubesense/kubesense-browser-rum'
+
+if (canUseGeoLocation()) {
+  getCurrentPosition((position) => {
+    kubsenseRum.setGlobalContextProperty('geo', {
+      latitude: position.latitude,
+      longitude: position.longitude,
+      accuracy: position.accuracy,
+    })
+  })
+}
+```
+
+Or use the `beforeSend` hook to add location to individual events:
+
+```typescript
+kubsenseRum.init({
+  beforeSend: (event) => {
+    if (canUseGeoLocation()) {
+      getCurrentPosition(
+        (position) => {
+          event.context.geo = {
+            latitude: position.latitude,
+            longitude: position.longitude,
+          }
+        },
+        () => {} // Ignore errors
+      )
+    }
+  }
+})
+```
+
+### Reverse Geocoding
+
+Convert coordinates to location names (city, country, etc.) using reverse geocoding:
+
+```typescript
+import { getCurrentPosition, reverseGeocodeWithPosition, getLocationName } from '@kubesense/kubesense-browser-core'
+
+getCurrentPosition((position) => {
+  reverseGeocodeWithPosition(position, (result) => {
+    console.log(result.city)      // "San Francisco"
+    console.log(result.state)     // "California"
+    console.log(result.country)   // "United States of America"
+    console.log(getLocationName(result)) // "San Francisco, California, United States of America"
+  })
+})
+```
+
+#### API
+
+```typescript
+// Sync callback style
+reverseGeocode(lat, lon, onSuccess, onError)
+
+// Async style
+const result = await reverseGeocodeAsync(lat, lon)
+
+// With position object
+reverseGeocodeWithPosition(position, onSuccess, onError)
+const result = await reverseGeocodeWithPositionAsync(position)
+```
+
+#### Response Type
+
+```typescript
+interface GeoLocationResult {
+  city?: string           // "San Francisco"
+  state?: string          // "California"
+  stateCode?: string      // "CA"
+  country?: string        // "United States of America"
+  countryCode?: string    // "US"
+  continent?: string      // "North America"
+  timezone?: string       // "America/Los_Angeles"
+  locality?: string       // Neighborhood or suburb
+  postalCode?: string     // "94102"
+  raw?: GeocodingResponse // Raw API response
+}
+```
+
+> **Note:** By default, this uses OpenStreetMap's Nominatim API (free, no API key required). You can provide your own `baseUrl` for other geocoding services.
+
 ## License
 
 [Apache-2.0](https://github.com/kubesense-ai/kubesense-browser-sdk/blob/main/LICENSE)

package/cjs/boot/init.js

@@ -7,7 +7,7 @@ const monitor_1 = require("../tools/monitor");
 const display_1 = require("../tools/display");
 function makePublicApi(stub) {
     const publicApi = {
-        version: "1.2.0",
+        version: "1.4.0",
         // This API method is intentionally not monitored, since the only thing executed is the
         // user-provided 'callback'.  All SDK usages executed in the callback should be monitored, and
         // we don't want to interfere with the user uncaught exceptions.

package/cjs/domain/configuration/endpointBuilder.js

@@ -45,7 +45,7 @@ function buildEndpointParameters({ clientToken, internalAnalyticsSubdomain, sour
     const parameters = [
         `ksource=${source}`,
         `kubesense-api-key=${clientToken}`,
-        `kubesense-evp-origin-version=${encodeURIComponent("1.2.0")}`,
+        `kubesense-evp-origin-version=${encodeURIComponent("1.4.0")}`,
         'kubesense-evp-origin=browser',
         `kubesense-request-id=${(0, stringUtils_1.generateUUID)()}`,
     ].concat(extraParameters);

package/cjs/domain/tags.js

@@ -9,7 +9,7 @@ const display_1 = require("../tools/display");
 exports.TAG_SIZE_LIMIT = 200;
 function buildTags(configuration) {
     const { env, service, version, datacenter, sdkVersion, variant } = configuration;
-    const tags = [buildTag('sdk_version', sdkVersion !== null && sdkVersion !== void 0 ? sdkVersion : "1.2.0")];
+    const tags = [buildTag('sdk_version', sdkVersion !== null && sdkVersion !== void 0 ? sdkVersion : "1.4.0")];
     if (env) {
         tags.push(buildTag('env', env));
     }

package/cjs/domain/telemetry/telemetry.js

@@ -109,7 +109,7 @@ function startTelemetryCollection(telemetryService, configuration, hooks, observ
             type: 'telemetry',
             date: clockNow.timeStamp,
             service: telemetryService,
-            version: "1.2.0",
+            version: "1.4.0",
             source: 'browser',
             _kubesense: {
                 format_version: 2,

package/cjs/index.d.ts

@@ -81,6 +81,8 @@ export * from './domain/resourceUtils';
 export * from './domain/bufferedData';
 export * from './tools/utils/polyfills';
 export * from './tools/utils/timezone';
+export * from './tools/utils/geolocation';
+export * from './tools/utils/geocoding';
 export * from './tools/utils/numberUtils';
 export * from './tools/utils/byteUtils';
 export * from './tools/utils/objectUtils';

package/cjs/index.js

@@ -178,6 +178,8 @@ __exportStar(require("./domain/resourceUtils"), exports);
 __exportStar(require("./domain/bufferedData"), exports);
 __exportStar(require("./tools/utils/polyfills"), exports);
 __exportStar(require("./tools/utils/timezone"), exports);
+__exportStar(require("./tools/utils/geolocation"), exports);
+__exportStar(require("./tools/utils/geocoding"), exports);
 __exportStar(require("./tools/utils/numberUtils"), exports);
 __exportStar(require("./tools/utils/byteUtils"), exports);
 __exportStar(require("./tools/utils/objectUtils"), exports);

package/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/cjs/tools/utils/geocoding.d.ts

@@ -0,0 +1,60 @@
+import type { GeoPosition } from './geolocation';
+export interface GeoLocation {
+    latitude: number;
+    longitude: number;
+    accuracy?: number;
+}
+export interface GeoLocationResult {
+    city?: string;
+    state?: string;
+    stateCode?: string;
+    country?: string;
+    countryCode?: string;
+    continent?: string;
+    timezone?: string;
+    locality?: string;
+    postalCode?: string;
+    raw?: GeocodingResponse;
+}
+export interface GeocodingError {
+    code: number;
+    message: string;
+}
+interface GeocodingResponse {
+    address: {
+        city?: string;
+        town?: string;
+        village?: string;
+        municipality?: string;
+        state?: string;
+        state_code?: string;
+        country?: string;
+        country_code?: string;
+        continent?: string;
+        postcode?: string;
+        locality?: string;
+        suburb?: string;
+        neighborhood?: string;
+    };
+    timezone?: string;
+    lat: string;
+    lon: string;
+}
+export declare function reverseGeocode(latitude: number, longitude: number, onSuccess: (result: GeoLocationResult) => void, onError?: (error: GeocodingError) => void, options?: {
+    baseUrl?: string;
+    userAgent?: string;
+}): void;
+export declare function reverseGeocodeWithPosition(position: GeoPosition, onSuccess: (result: GeoLocationResult) => void, onError?: (error: GeocodingError) => void, options?: {
+    baseUrl?: string;
+    userAgent?: string;
+}): void;
+export declare function getLocationName(result: GeoLocationResult): string;
+export declare function reverseGeocodeAsync(latitude: number, longitude: number, options?: {
+    baseUrl?: string;
+    userAgent?: string;
+}): Promise<GeoLocationResult>;
+export declare function reverseGeocodeWithPositionAsync(position: GeoPosition, options?: {
+    baseUrl?: string;
+    userAgent?: string;
+}): Promise<GeoLocationResult>;
+export {};

package/cjs/tools/utils/geocoding.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reverseGeocode = reverseGeocode;
+exports.reverseGeocodeWithPosition = reverseGeocodeWithPosition;
+exports.getLocationName = getLocationName;
+exports.reverseGeocodeAsync = reverseGeocodeAsync;
+exports.reverseGeocodeWithPositionAsync = reverseGeocodeWithPositionAsync;
+const NOMINATIM_BASE_URL = 'https://nominatim.openstreetmap.org';
+function reverseGeocode(latitude, longitude, onSuccess, onError, options) {
+    var _a, _b;
+    const baseUrl = (_a = options === null || options === void 0 ? void 0 : options.baseUrl) !== null && _a !== void 0 ? _a : NOMINATIM_BASE_URL;
+    const userAgent = (_b = options === null || options === void 0 ? void 0 : options.userAgent) !== null && _b !== void 0 ? _b : 'KubesenseBrowserSDK/1.0';
+    const url = `${baseUrl}/reverse?lat=${latitude}&lon=${longitude}&format=json&addressdetails=1&timezone=1`;
+    fetch(url, {
+        headers: {
+            'User-Agent': userAgent,
+            'Accept': 'application/json',
+        },
+    })
+        .then((response) => {
+        if (!response.ok) {
+            throw new Error(`Geocoding failed: ${response.status}`);
+        }
+        return response.json();
+    })
+        .then((data) => {
+        const result = parseGeocodingResponse(data);
+        onSuccess(result);
+    })
+        .catch((error) => {
+        onError === null || onError === void 0 ? void 0 : onError({
+            code: -1,
+            message: error.message || 'Failed to reverse geocode',
+        });
+    });
+}
+function reverseGeocodeWithPosition(position, onSuccess, onError, options) {
+    reverseGeocode(position.latitude, position.longitude, onSuccess, onError, options);
+}
+function parseGeocodingResponse(data) {
+    var _a, _b, _c, _d, _e, _f;
+    const address = data.address || {};
+    return {
+        city: (_c = (_b = (_a = address.city) !== null && _a !== void 0 ? _a : address.town) !== null && _b !== void 0 ? _b : address.village) !== null && _c !== void 0 ? _c : address.municipality,
+        state: address.state,
+        stateCode: address.state_code,
+        country: address.country,
+        countryCode: (_d = address.country_code) === null || _d === void 0 ? void 0 : _d.toUpperCase(),
+        continent: address.continent,
+        timezone: data.timezone,
+        locality: (_f = (_e = address.locality) !== null && _e !== void 0 ? _e : address.suburb) !== null && _f !== void 0 ? _f : address.neighborhood,
+        postalCode: address.postcode,
+        raw: data,
+    };
+}
+function getLocationName(result) {
+    const parts = [];
+    if (result.locality) {
+        parts.push(result.locality);
+    }
+    if (result.city) {
+        parts.push(result.city);
+    }
+    if (result.state) {
+        parts.push(result.state);
+    }
+    if (result.country) {
+        parts.push(result.country);
+    }
+    return parts.join(', ');
+}
+async function reverseGeocodeAsync(latitude, longitude, options) {
+    return new Promise((resolve, reject) => {
+        reverseGeocode(latitude, longitude, resolve, (error) => reject(new Error(error.message)), options);
+    });
+}
+async function reverseGeocodeWithPositionAsync(position, options) {
+    return reverseGeocodeAsync(position.latitude, position.longitude, options);
+}
+//# sourceMappingURL=geocoding.js.map

package/cjs/tools/utils/geocoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geocoding.js","sourceRoot":"","sources":["../../../src/tools/utils/geocoding.ts"],"names":[],"mappings":";;AAiDA,wCAqCC;AAED,gEAgBC;AAmBD,0CAiBC;AAED,kDAiBC;AAED,0EAQC;AA1HD,MAAM,kBAAkB,GAAG,qCAAqC,CAAA;AAEhE,SAAgB,cAAc,CAC5B,QAAgB,EAChB,SAAiB,EACjB,SAA8C,EAC9C,OAAyC,EACzC,OAGC;;IAED,MAAM,OAAO,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,kBAAkB,CAAA;IACtD,MAAM,SAAS,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,mCAAI,yBAAyB,CAAA;IAEjE,MAAM,GAAG,GAAG,GAAG,OAAO,gBAAgB,QAAQ,QAAQ,SAAS,0CAA0C,CAAA;IAEzG,KAAK,CAAC,GAAG,EAAE;QACT,OAAO,EAAE;YACP,YAAY,EAAE,SAAS;YACvB,QAAQ,EAAE,kBAAkB;SAC7B;KACF,CAAC;SACC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QACjB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;QACzD,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,IAAuB,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;QAC3C,SAAS,CAAC,MAAM,CAAC,CAAA;IACnB,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG;YACR,IAAI,EAAE,CAAC,CAAC;YACR,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,2BAA2B;SACtD,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACN,CAAC;AAED,SAAgB,0BAA0B,CACxC,QAAqB,EACrB,SAA8C,EAC9C,OAAyC,EACzC,OAGC;IAED,cAAc,CACZ,QAAQ,CAAC,QAAQ,EACjB,QAAQ,CAAC,SAAS,EAClB,SAAS,EACT,OAAO,EACP,OAAO,CACR,CAAA;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAuB;;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAA;IAElC,OAAO;QACL,IAAI,EAAE,MAAA,MAAA,MAAA,OAAO,CAAC,IAAI,mCAAI,OAAO,CAAC,IAAI,mCAAI,OAAO,CAAC,OAAO,mCAAI,OAAO,CAAC,YAAY;QAC7E,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,UAAU;QAC7B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,MAAA,OAAO,CAAC,YAAY,0CAAE,WAAW,EAAE;QAChD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,MAAA,MAAA,OAAO,CAAC,QAAQ,mCAAI,OAAO,CAAC,MAAM,mCAAI,OAAO,CAAC,YAAY;QACpE,UAAU,EAAE,OAAO,CAAC,QAAQ;QAC5B,GAAG,EAAE,IAAI;KACV,CAAA;AACH,CAAC;AAED,SAAgB,eAAe,CAAC,MAAyB;IACvD,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,SAAiB,EACjB,OAGC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,cAAc,CACZ,QAAQ,EACR,SAAS,EACT,OAAO,EACP,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAC3C,OAAO,CACR,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAEM,KAAK,UAAU,+BAA+B,CACnD,QAAqB,EACrB,OAGC;IAED,OAAO,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;AAC5E,CAAC"}

package/cjs/tools/utils/geolocation.d.ts

@@ -0,0 +1,24 @@
+export interface GeoPosition {
+    latitude: number;
+    longitude: number;
+    accuracy: number;
+    altitude?: number;
+    altitudeAccuracy?: number;
+    heading?: number;
+    speed?: number;
+}
+export interface GeoPositionError {
+    code: number;
+    message: string;
+}
+export type GeoPositionCallback = (position: GeoPosition) => void;
+export type GeoErrorCallback = (error: GeoPositionError) => void;
+export interface GeoLocationOptions {
+    enableHighAccuracy?: boolean;
+    timeout?: number;
+    maximumAge?: number;
+}
+export declare function canUseGeoLocation(): boolean;
+export declare function getCurrentPosition(onSuccess: GeoPositionCallback, onError?: GeoErrorCallback, options?: GeoLocationOptions): void;
+export declare function watchPosition(onSuccess: GeoPositionCallback, onError?: GeoErrorCallback, options?: GeoLocationOptions): number;
+export declare function clearWatch(watchId: number): void;

package/cjs/tools/utils/geolocation.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canUseGeoLocation = canUseGeoLocation;
+exports.getCurrentPosition = getCurrentPosition;
+exports.watchPosition = watchPosition;
+exports.clearWatch = clearWatch;
+function canUseGeoLocation() {
+    return 'geolocation' in navigator;
+}
+function getCurrentPosition(onSuccess, onError, options) {
+    var _a, _b, _c;
+    if (!canUseGeoLocation()) {
+        onError === null || onError === void 0 ? void 0 : onError({
+            code: -1,
+            message: 'Geolocation is not supported by this browser',
+        });
+        return;
+    }
+    navigator.geolocation.getCurrentPosition((position) => {
+        var _a, _b, _c, _d;
+        onSuccess({
+            latitude: position.coords.latitude,
+            longitude: position.coords.longitude,
+            accuracy: position.coords.accuracy,
+            altitude: (_a = position.coords.altitude) !== null && _a !== void 0 ? _a : undefined,
+            altitudeAccuracy: (_b = position.coords.altitudeAccuracy) !== null && _b !== void 0 ? _b : undefined,
+            heading: (_c = position.coords.heading) !== null && _c !== void 0 ? _c : undefined,
+            speed: (_d = position.coords.speed) !== null && _d !== void 0 ? _d : undefined,
+        });
+    }, (error) => {
+        onError === null || onError === void 0 ? void 0 : onError({
+            code: error.code,
+            message: error.message,
+        });
+    }, {
+        enableHighAccuracy: (_a = options === null || options === void 0 ? void 0 : options.enableHighAccuracy) !== null && _a !== void 0 ? _a : false,
+        timeout: (_b = options === null || options === void 0 ? void 0 : options.timeout) !== null && _b !== void 0 ? _b : 10000,
+        maximumAge: (_c = options === null || options === void 0 ? void 0 : options.maximumAge) !== null && _c !== void 0 ? _c : 0,
+    });
+}
+function watchPosition(onSuccess, onError, options) {
+    var _a, _b, _c;
+    if (!canUseGeoLocation()) {
+        onError === null || onError === void 0 ? void 0 : onError({
+            code: -1,
+            message: 'Geolocation is not supported by this browser',
+        });
+        return -1;
+    }
+    return navigator.geolocation.watchPosition((position) => {
+        var _a, _b, _c, _d;
+        onSuccess({
+            latitude: position.coords.latitude,
+            longitude: position.coords.longitude,
+            accuracy: position.coords.accuracy,
+            altitude: (_a = position.coords.altitude) !== null && _a !== void 0 ? _a : undefined,
+            altitudeAccuracy: (_b = position.coords.altitudeAccuracy) !== null && _b !== void 0 ? _b : undefined,
+            heading: (_c = position.coords.heading) !== null && _c !== void 0 ? _c : undefined,
+            speed: (_d = position.coords.speed) !== null && _d !== void 0 ? _d : undefined,
+        });
+    }, (error) => {
+        onError === null || onError === void 0 ? void 0 : onError({
+            code: error.code,
+            message: error.message,
+        });
+    }, {
+        enableHighAccuracy: (_a = options === null || options === void 0 ? void 0 : options.enableHighAccuracy) !== null && _a !== void 0 ? _a : false,
+        timeout: (_b = options === null || options === void 0 ? void 0 : options.timeout) !== null && _b !== void 0 ? _b : 10000,
+        maximumAge: (_c = options === null || options === void 0 ? void 0 : options.maximumAge) !== null && _c !== void 0 ? _c : 0,
+    });
+}
+function clearWatch(watchId) {
+    if (canUseGeoLocation() && watchId >= 0) {
+        navigator.geolocation.clearWatch(watchId);
+    }
+}
+//# sourceMappingURL=geolocation.js.map

package/cjs/tools/utils/geolocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation.js","sourceRoot":"","sources":["../../../src/tools/utils/geolocation.ts"],"names":[],"mappings":"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"}

package/esm/boot/init.js

@@ -3,7 +3,7 @@ import { setDebugMode } from '../tools/monitor';
 import { display } from '../tools/display';
 export function makePublicApi(stub) {
     const publicApi = {
-        version: "1.2.0",
+        version: "1.4.0",
         // This API method is intentionally not monitored, since the only thing executed is the
         // user-provided 'callback'.  All SDK usages executed in the callback should be monitored, and
         // we don't want to interfere with the user uncaught exceptions.

package/esm/domain/configuration/endpointBuilder.js

@@ -41,7 +41,7 @@ function buildEndpointParameters({ clientToken, internalAnalyticsSubdomain, sour
     const parameters = [
         `ksource=${source}`,
         `kubesense-api-key=${clientToken}`,
-        `kubesense-evp-origin-version=${encodeURIComponent("1.2.0")}`,
+        `kubesense-evp-origin-version=${encodeURIComponent("1.4.0")}`,
         'kubesense-evp-origin=browser',
         `kubesense-request-id=${generateUUID()}`,
     ].concat(extraParameters);

package/esm/domain/tags.js

@@ -2,7 +2,7 @@ import { DOCS_ORIGIN, MORE_DETAILS, display } from '../tools/display';
 export const TAG_SIZE_LIMIT = 200;
 export function buildTags(configuration) {
     const { env, service, version, datacenter, sdkVersion, variant } = configuration;
-    const tags = [buildTag('sdk_version', sdkVersion !== null && sdkVersion !== void 0 ? sdkVersion : "1.2.0")];
+    const tags = [buildTag('sdk_version', sdkVersion !== null && sdkVersion !== void 0 ? sdkVersion : "1.4.0")];
     if (env) {
         tags.push(buildTag('env', env));
     }

package/esm/domain/telemetry/telemetry.js

@@ -96,7 +96,7 @@ export function startTelemetryCollection(telemetryService, configuration, hooks,
             type: 'telemetry',
             date: clockNow.timeStamp,
             service: telemetryService,
-            version: "1.2.0",
+            version: "1.4.0",
             source: 'browser',
             _kubesense: {
                 format_version: 2,

package/esm/index.d.ts

@@ -81,6 +81,8 @@ export * from './domain/resourceUtils';
 export * from './domain/bufferedData';
 export * from './tools/utils/polyfills';
 export * from './tools/utils/timezone';
+export * from './tools/utils/geolocation';
+export * from './tools/utils/geocoding';
 export * from './tools/utils/numberUtils';
 export * from './tools/utils/byteUtils';
 export * from './tools/utils/objectUtils';

package/esm/index.js

@@ -57,6 +57,8 @@ export * from './domain/resourceUtils';
 export * from './domain/bufferedData';
 export * from './tools/utils/polyfills';
 export * from './tools/utils/timezone';
+export * from './tools/utils/geolocation';
+export * from './tools/utils/geocoding';
 export * from './tools/utils/numberUtils';
 export * from './tools/utils/byteUtils';
 export * from './tools/utils/objectUtils';

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/esm/tools/utils/geocoding.d.ts

@@ -0,0 +1,60 @@
+import type { GeoPosition } from './geolocation';
+export interface GeoLocation {
+    latitude: number;
+    longitude: number;
+    accuracy?: number;
+}
+export interface GeoLocationResult {
+    city?: string;
+    state?: string;
+    stateCode?: string;
+    country?: string;
+    countryCode?: string;
+    continent?: string;
+    timezone?: string;
+    locality?: string;
+    postalCode?: string;
+    raw?: GeocodingResponse;
+}
+export interface GeocodingError {
+    code: number;
+    message: string;
+}
+interface GeocodingResponse {
+    address: {
+        city?: string;
+        town?: string;
+        village?: string;
+        municipality?: string;
+        state?: string;
+        state_code?: string;
+        country?: string;
+        country_code?: string;
+        continent?: string;
+        postcode?: string;
+        locality?: string;
+        suburb?: string;
+        neighborhood?: string;
+    };
+    timezone?: string;
+    lat: string;
+    lon: string;
+}
+export declare function reverseGeocode(latitude: number, longitude: number, onSuccess: (result: GeoLocationResult) => void, onError?: (error: GeocodingError) => void, options?: {
+    baseUrl?: string;
+    userAgent?: string;
+}): void;
+export declare function reverseGeocodeWithPosition(position: GeoPosition, onSuccess: (result: GeoLocationResult) => void, onError?: (error: GeocodingError) => void, options?: {
+    baseUrl?: string;
+    userAgent?: string;
+}): void;
+export declare function getLocationName(result: GeoLocationResult): string;
+export declare function reverseGeocodeAsync(latitude: number, longitude: number, options?: {
+    baseUrl?: string;
+    userAgent?: string;
+}): Promise<GeoLocationResult>;
+export declare function reverseGeocodeWithPositionAsync(position: GeoPosition, options?: {
+    baseUrl?: string;
+    userAgent?: string;
+}): Promise<GeoLocationResult>;
+export {};

package/esm/tools/utils/geocoding.js

@@ -0,0 +1,73 @@
+const NOMINATIM_BASE_URL = 'https://nominatim.openstreetmap.org';
+export function reverseGeocode(latitude, longitude, onSuccess, onError, options) {
+    var _a, _b;
+    const baseUrl = (_a = options === null || options === void 0 ? void 0 : options.baseUrl) !== null && _a !== void 0 ? _a : NOMINATIM_BASE_URL;
+    const userAgent = (_b = options === null || options === void 0 ? void 0 : options.userAgent) !== null && _b !== void 0 ? _b : 'KubesenseBrowserSDK/1.0';
+    const url = `${baseUrl}/reverse?lat=${latitude}&lon=${longitude}&format=json&addressdetails=1&timezone=1`;
+    fetch(url, {
+        headers: {
+            'User-Agent': userAgent,
+            'Accept': 'application/json',
+        },
+    })
+        .then((response) => {
+        if (!response.ok) {
+            throw new Error(`Geocoding failed: ${response.status}`);
+        }
+        return response.json();
+    })
+        .then((data) => {
+        const result = parseGeocodingResponse(data);
+        onSuccess(result);
+    })
+        .catch((error) => {
+        onError === null || onError === void 0 ? void 0 : onError({
+            code: -1,
+            message: error.message || 'Failed to reverse geocode',
+        });
+    });
+}
+export function reverseGeocodeWithPosition(position, onSuccess, onError, options) {
+    reverseGeocode(position.latitude, position.longitude, onSuccess, onError, options);
+}
+function parseGeocodingResponse(data) {
+    var _a, _b, _c, _d, _e, _f;
+    const address = data.address || {};
+    return {
+        city: (_c = (_b = (_a = address.city) !== null && _a !== void 0 ? _a : address.town) !== null && _b !== void 0 ? _b : address.village) !== null && _c !== void 0 ? _c : address.municipality,
+        state: address.state,
+        stateCode: address.state_code,
+        country: address.country,
+        countryCode: (_d = address.country_code) === null || _d === void 0 ? void 0 : _d.toUpperCase(),
+        continent: address.continent,
+        timezone: data.timezone,
+        locality: (_f = (_e = address.locality) !== null && _e !== void 0 ? _e : address.suburb) !== null && _f !== void 0 ? _f : address.neighborhood,
+        postalCode: address.postcode,
+        raw: data,
+    };
+}
+export function getLocationName(result) {
+    const parts = [];
+    if (result.locality) {
+        parts.push(result.locality);
+    }
+    if (result.city) {
+        parts.push(result.city);
+    }
+    if (result.state) {
+        parts.push(result.state);
+    }
+    if (result.country) {
+        parts.push(result.country);
+    }
+    return parts.join(', ');
+}
+export async function reverseGeocodeAsync(latitude, longitude, options) {
+    return new Promise((resolve, reject) => {
+        reverseGeocode(latitude, longitude, resolve, (error) => reject(new Error(error.message)), options);
+    });
+}
+export async function reverseGeocodeWithPositionAsync(position, options) {
+    return reverseGeocodeAsync(position.latitude, position.longitude, options);
+}
+//# sourceMappingURL=geocoding.js.map

package/esm/tools/utils/geocoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geocoding.js","sourceRoot":"","sources":["../../../src/tools/utils/geocoding.ts"],"names":[],"mappings":"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"}

package/esm/tools/utils/geolocation.d.ts

@@ -0,0 +1,24 @@
+export interface GeoPosition {
+    latitude: number;
+    longitude: number;
+    accuracy: number;
+    altitude?: number;
+    altitudeAccuracy?: number;
+    heading?: number;
+    speed?: number;
+}
+export interface GeoPositionError {
+    code: number;
+    message: string;
+}
+export type GeoPositionCallback = (position: GeoPosition) => void;
+export type GeoErrorCallback = (error: GeoPositionError) => void;
+export interface GeoLocationOptions {
+    enableHighAccuracy?: boolean;
+    timeout?: number;
+    maximumAge?: number;
+}
+export declare function canUseGeoLocation(): boolean;
+export declare function getCurrentPosition(onSuccess: GeoPositionCallback, onError?: GeoErrorCallback, options?: GeoLocationOptions): void;
+export declare function watchPosition(onSuccess: GeoPositionCallback, onError?: GeoErrorCallback, options?: GeoLocationOptions): number;
+export declare function clearWatch(watchId: number): void;

package/esm/tools/utils/geolocation.js

@@ -0,0 +1,71 @@
+export function canUseGeoLocation() {
+    return 'geolocation' in navigator;
+}
+export function getCurrentPosition(onSuccess, onError, options) {
+    var _a, _b, _c;
+    if (!canUseGeoLocation()) {
+        onError === null || onError === void 0 ? void 0 : onError({
+            code: -1,
+            message: 'Geolocation is not supported by this browser',
+        });
+        return;
+    }
+    navigator.geolocation.getCurrentPosition((position) => {
+        var _a, _b, _c, _d;
+        onSuccess({
+            latitude: position.coords.latitude,
+            longitude: position.coords.longitude,
+            accuracy: position.coords.accuracy,
+            altitude: (_a = position.coords.altitude) !== null && _a !== void 0 ? _a : undefined,
+            altitudeAccuracy: (_b = position.coords.altitudeAccuracy) !== null && _b !== void 0 ? _b : undefined,
+            heading: (_c = position.coords.heading) !== null && _c !== void 0 ? _c : undefined,
+            speed: (_d = position.coords.speed) !== null && _d !== void 0 ? _d : undefined,
+        });
+    }, (error) => {
+        onError === null || onError === void 0 ? void 0 : onError({
+            code: error.code,
+            message: error.message,
+        });
+    }, {
+        enableHighAccuracy: (_a = options === null || options === void 0 ? void 0 : options.enableHighAccuracy) !== null && _a !== void 0 ? _a : false,
+        timeout: (_b = options === null || options === void 0 ? void 0 : options.timeout) !== null && _b !== void 0 ? _b : 10000,
+        maximumAge: (_c = options === null || options === void 0 ? void 0 : options.maximumAge) !== null && _c !== void 0 ? _c : 0,
+    });
+}
+export function watchPosition(onSuccess, onError, options) {
+    var _a, _b, _c;
+    if (!canUseGeoLocation()) {
+        onError === null || onError === void 0 ? void 0 : onError({
+            code: -1,
+            message: 'Geolocation is not supported by this browser',
+        });
+        return -1;
+    }
+    return navigator.geolocation.watchPosition((position) => {
+        var _a, _b, _c, _d;
+        onSuccess({
+            latitude: position.coords.latitude,
+            longitude: position.coords.longitude,
+            accuracy: position.coords.accuracy,
+            altitude: (_a = position.coords.altitude) !== null && _a !== void 0 ? _a : undefined,
+            altitudeAccuracy: (_b = position.coords.altitudeAccuracy) !== null && _b !== void 0 ? _b : undefined,
+            heading: (_c = position.coords.heading) !== null && _c !== void 0 ? _c : undefined,
+            speed: (_d = position.coords.speed) !== null && _d !== void 0 ? _d : undefined,
+        });
+    }, (error) => {
+        onError === null || onError === void 0 ? void 0 : onError({
+            code: error.code,
+            message: error.message,
+        });
+    }, {
+        enableHighAccuracy: (_a = options === null || options === void 0 ? void 0 : options.enableHighAccuracy) !== null && _a !== void 0 ? _a : false,
+        timeout: (_b = options === null || options === void 0 ? void 0 : options.timeout) !== null && _b !== void 0 ? _b : 10000,
+        maximumAge: (_c = options === null || options === void 0 ? void 0 : options.maximumAge) !== null && _c !== void 0 ? _c : 0,
+    });
+}
+export function clearWatch(watchId) {
+    if (canUseGeoLocation() && watchId >= 0) {
+        navigator.geolocation.clearWatch(watchId);
+    }
+}
+//# sourceMappingURL=geolocation.js.map

package/esm/tools/utils/geolocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation.js","sourceRoot":"","sources":["../../../src/tools/utils/geolocation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,18 @@
 {
   "name": "@kubesense/kubesense-browser-core",
-  "version": "1.2.0",
+  "version": "1.4.0",
+  "description": "Core utilities shared across the Kubesense Browser SDK (session management, transport, configuration, and context).",
   "license": "Apache-2.0",
+  "keywords": [
+    "kubesense",
+    "browser",
+    "sdk",
+    "monitoring",
+    "observability",
+    "telemetry",
+    "rum",
+    "core"
+  ],
   "main": "cjs/index.js",
   "module": "esm/index.js",
   "types": "cjs/index.d.ts",
@@ -24,5 +35,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "c49352eb57b271896c63b12053001be6a2684fb0"
+  "gitHead": "af1a0950e2441f45b4303b2dc17b09f9cd0d999d"
 }

package/src/index.ts

@@ -149,6 +149,8 @@ export * from './domain/resourceUtils'
 export * from './domain/bufferedData'
 export * from './tools/utils/polyfills'
 export * from './tools/utils/timezone'
+export * from './tools/utils/geolocation'
+export * from './tools/utils/geocoding'
 export * from './tools/utils/numberUtils'
 export * from './tools/utils/byteUtils'
 export * from './tools/utils/objectUtils'

package/src/tools/utils/geocoding.ts

@@ -0,0 +1,170 @@
+import type { GeoPosition } from './geolocation'
+
+export interface GeoLocation {
+  latitude: number
+  longitude: number
+  accuracy?: number
+}
+
+export interface GeoLocationResult {
+  city?: string
+  state?: string
+  stateCode?: string
+  country?: string
+  countryCode?: string
+  continent?: string
+  timezone?: string
+  locality?: string
+  postalCode?: string
+  raw?: GeocodingResponse
+}
+
+export interface GeocodingError {
+  code: number
+  message: string
+}
+
+interface GeocodingResponse {
+  address: {
+    city?: string
+    town?: string
+    village?: string
+    municipality?: string
+    state?: string
+    state_code?: string
+    country?: string
+    country_code?: string
+    continent?: string
+    postcode?: string
+    locality?: string
+    suburb?: string
+    neighborhood?: string
+  }
+  timezone?: string
+  lat: string
+  lon: string
+}
+
+const NOMINATIM_BASE_URL = 'https://nominatim.openstreetmap.org'
+
+export function reverseGeocode(
+  latitude: number,
+  longitude: number,
+  onSuccess: (result: GeoLocationResult) => void,
+  onError?: (error: GeocodingError) => void,
+  options?: {
+    baseUrl?: string
+    userAgent?: string
+  }
+): void {
+  const baseUrl = options?.baseUrl ?? NOMINATIM_BASE_URL
+  const userAgent = options?.userAgent ?? 'KubesenseBrowserSDK/1.0'
+
+  const url = `${baseUrl}/reverse?lat=${latitude}&lon=${longitude}&format=json&addressdetails=1&timezone=1`
+
+  fetch(url, {
+    headers: {
+      'User-Agent': userAgent,
+      'Accept': 'application/json',
+    },
+  })
+    .then((response) => {
+      if (!response.ok) {
+        throw new Error(`Geocoding failed: ${response.status}`)
+      }
+      return response.json()
+    })
+    .then((data: GeocodingResponse) => {
+      const result = parseGeocodingResponse(data)
+      onSuccess(result)
+    })
+    .catch((error) => {
+      onError?.({
+        code: -1,
+        message: error.message || 'Failed to reverse geocode',
+      })
+    })
+}
+
+export function reverseGeocodeWithPosition(
+  position: GeoPosition,
+  onSuccess: (result: GeoLocationResult) => void,
+  onError?: (error: GeocodingError) => void,
+  options?: {
+    baseUrl?: string
+    userAgent?: string
+  }
+): void {
+  reverseGeocode(
+    position.latitude,
+    position.longitude,
+    onSuccess,
+    onError,
+    options
+  )
+}
+
+function parseGeocodingResponse(data: GeocodingResponse): GeoLocationResult {
+  const address = data.address || {}
+
+  return {
+    city: address.city ?? address.town ?? address.village ?? address.municipality,
+    state: address.state,
+    stateCode: address.state_code,
+    country: address.country,
+    countryCode: address.country_code?.toUpperCase(),
+    continent: address.continent,
+    timezone: data.timezone,
+    locality: address.locality ?? address.suburb ?? address.neighborhood,
+    postalCode: address.postcode,
+    raw: data,
+  }
+}
+
+export function getLocationName(result: GeoLocationResult): string {
+  const parts: string[] = []
+
+  if (result.locality) {
+    parts.push(result.locality)
+  }
+  if (result.city) {
+    parts.push(result.city)
+  }
+  if (result.state) {
+    parts.push(result.state)
+  }
+  if (result.country) {
+    parts.push(result.country)
+  }
+
+  return parts.join(', ')
+}
+
+export async function reverseGeocodeAsync(
+  latitude: number,
+  longitude: number,
+  options?: {
+    baseUrl?: string
+    userAgent?: string
+  }
+): Promise<GeoLocationResult> {
+  return new Promise((resolve, reject) => {
+    reverseGeocode(
+      latitude,
+      longitude,
+      resolve,
+      (error) => reject(new Error(error.message)),
+      options
+    )
+  })
+}
+
+export async function reverseGeocodeWithPositionAsync(
+  position: GeoPosition,
+  options?: {
+    baseUrl?: string
+    userAgent?: string
+  }
+): Promise<GeoLocationResult> {
+  return reverseGeocodeAsync(position.latitude, position.longitude, options)
+}

package/src/tools/utils/geolocation.ts

@@ -0,0 +1,111 @@
+export interface GeoPosition {
+  latitude: number
+  longitude: number
+  accuracy: number
+  altitude?: number
+  altitudeAccuracy?: number
+  heading?: number
+  speed?: number
+}
+
+export interface GeoPositionError {
+  code: number
+  message: string
+}
+
+export type GeoPositionCallback = (position: GeoPosition) => void
+export type GeoErrorCallback = (error: GeoPositionError) => void
+
+export interface GeoLocationOptions {
+  enableHighAccuracy?: boolean
+  timeout?: number
+  maximumAge?: number
+}
+
+export function canUseGeoLocation(): boolean {
+  return 'geolocation' in navigator
+}
+
+export function getCurrentPosition(
+  onSuccess: GeoPositionCallback,
+  onError?: GeoErrorCallback,
+  options?: GeoLocationOptions
+): void {
+  if (!canUseGeoLocation()) {
+    onError?.({
+      code: -1,
+      message: 'Geolocation is not supported by this browser',
+    })
+    return
+  }
+
+  navigator.geolocation.getCurrentPosition(
+    (position) => {
+      onSuccess({
+        latitude: position.coords.latitude,
+        longitude: position.coords.longitude,
+        accuracy: position.coords.accuracy,
+        altitude: position.coords.altitude ?? undefined,
+        altitudeAccuracy: position.coords.altitudeAccuracy ?? undefined,
+        heading: position.coords.heading ?? undefined,
+        speed: position.coords.speed ?? undefined,
+      })
+    },
+    (error) => {
+      onError?.({
+        code: error.code,
+        message: error.message,
+      })
+    },
+    {
+      enableHighAccuracy: options?.enableHighAccuracy ?? false,
+      timeout: options?.timeout ?? 10000,
+      maximumAge: options?.maximumAge ?? 0,
+    }
+  )
+}
+
+export function watchPosition(
+  onSuccess: GeoPositionCallback,
+  onError?: GeoErrorCallback,
+  options?: GeoLocationOptions
+): number {
+  if (!canUseGeoLocation()) {
+    onError?.({
+      code: -1,
+      message: 'Geolocation is not supported by this browser',
+    })
+    return -1
+  }
+
+  return navigator.geolocation.watchPosition(
+    (position) => {
+      onSuccess({
+        latitude: position.coords.latitude,
+        longitude: position.coords.longitude,
+        accuracy: position.coords.accuracy,
+        altitude: position.coords.altitude ?? undefined,
+        altitudeAccuracy: position.coords.altitudeAccuracy ?? undefined,
+        heading: position.coords.heading ?? undefined,
+        speed: position.coords.speed ?? undefined,
+      })
+    },
+    (error) => {
+      onError?.({
+        code: error.code,
+        message: error.message,
+      })
+    },
+    {
+      enableHighAccuracy: options?.enableHighAccuracy ?? false,
+      timeout: options?.timeout ?? 10000,
+      maximumAge: options?.maximumAge ?? 0,
+    }
+  )
+}
+
+export function clearWatch(watchId: number): void {
+  if (canUseGeoLocation() && watchId >= 0) {
+    navigator.geolocation.clearWatch(watchId)
+  }
+}