@milemaker/milemaker-js 2.0.0-alpha.3 → 2.0.0-alpha.7

package/dist/types/common.types.d.ts

@@ -70,3 +70,10 @@ export type GeneralAppSettings = {
      */
     units: UnitsFormat;
 };
+/**
+ * Anchor position
+ * @type
+ * @group Common
+ * @category Types
+ */
+export type Anchor = "center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right";

package/dist/types/index.d.ts

@@ -2,4 +2,5 @@ export * from "./common.types";
 export * from "./common.enums";
 export type * from "../createMap/types";
 export type * from "../actions/types";
+export type * from "../apis/types";
 export type * from "../controls/types";

package/dist/utils/apis/api.constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Use this value to omit header which was set in bse query.
+ * It may be useful to fetch 3-d party API or when we need to specify some custom headers for a specific request for our API.
+ */
+export declare const OMIT_HEADER_VALUE = "omit";
+export declare const LICENSED_MODULE = "map_sdk";

package/dist/utils/apis/api.types.d.ts

@@ -0,0 +1,5 @@
+export declare enum ApiParams {
+    TYPE = "type",
+    API_KEY = "apiKey",
+    LICENSED_MODULE = "licensedModule"
+}

package/dist/utils/apis/logEvents.api.d.ts

@@ -0,0 +1,37 @@
+interface LogEvent {
+    data: Record<string, unknown>;
+    component: LogEventComponent;
+    datetime: string;
+}
+type LogEventDataProp = Record<string, unknown>;
+declare enum LogEventComponent {
+    MAP_SDK = "map_sdk"
+}
+export declare enum LogEventScope {
+    API = "api",
+    REACT = "react",
+    WINDOW_ERROR = "windowError",
+    WINDOW_UNHANDLED_REJECTION = "windowUnhandledRejection",
+    NDRIVE = "ndrive",
+    BILLING = "billing",
+    WEATHER = "weather"
+}
+export declare const prepareLogEvent: ({ event, scope, destination, apiKey }: {
+    event: LogEventDataProp;
+    scope: LogEventScope;
+    destination: "api" | "email";
+    apiKey: string;
+}) => Promise<LogEvent>;
+export declare const handleLogEvents: ({ events: propEvents, scope, apiKey, baseApiUrl }: {
+    events: Record<string, unknown>[];
+    scope: LogEventScope;
+    apiKey: string;
+    baseApiUrl: string;
+}) => Promise<void>;
+export declare const handleLogErrorEvents: ({ errors: propErrors, scope, apiKey, baseApiUrl }: {
+    errors: Error[];
+    scope: LogEventScope;
+    apiKey: string;
+    baseApiUrl: string;
+}) => Promise<void>;
+export {};

package/dist/utils/apis/sdkEvents.api.d.ts

@@ -0,0 +1,4 @@
+export declare const triggerMapSdkInitEvent: ({ apiKey, baseApiUrl }: {
+    apiKey: string;
+    baseApiUrl: string;
+}) => Promise<void>;

package/dist/utils/common.schemas.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export declare const LonLatTupleSchema: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+/**
+ * LongLatSchema
+ */
+export declare const LongLatSchema: z.ZodObject<{
+    lat: z.ZodNumber;
+    long: z.ZodNumber;
+}, z.core.$strip>;

package/dist/utils/constants.d.ts

@@ -1,13 +1,12 @@
-import { Env } from "./types";
+import { Env, LengthUnit, Rate } from "./types";
 export declare const PROXY_ENVS: Record<string, Env>;
 export declare const MILE_MAKER_API_ENVS: Record<Env, string>;
 export declare const MILE_MAKER_APP_ENVS: Record<Env, string>;
 export declare enum HttpHeader {
-    X_CLIENT = "x-client"
+    X_CLIENT = "x-client",
+    AUTHORIZATION = "authorization"
 }
 export declare enum XClient {
-    WEB_APP = "web_app",
-    EXCEL_ADD_IN = "excel_add_in",
     MAP_SDK = "map_sdk"
 }
 export declare const MILE_MAKER_PAGE_PATH: {
@@ -47,4 +46,15 @@ export declare const MEASURE_UNITS_LABELS: {
     };
 };
 export declare const EMAIL_SUBJECT_LENGTH_LIMITATION = 255;
-export declare const EMAIL_BODY_LENGTH_LIMITATION = 2000;
+export declare const EMAIL_BODY_LENGTH_LIMITATION = 1100;
+export declare const IndexedDB: IDBFactory;
+/**
+ * This is a MAIN_LENGTH_UNIT constant that contains the distance unit supported by the backend when making requests
+ * Takes part in imperial/metric conversion when the user selects non-imperial units in app settings
+ */
+export declare const MAIN_LENGTH_UNIT = LengthUnit.MILES;
+/**
+ * This is LENGTH_UNITS_RATES and VOLUME_UNITS_RATES constants
+ * Сontain a coefficient for converting the value in both directions
+ */
+export declare const LENGTH_UNITS_RATES: Rate<LengthUnit>;

package/dist/utils/helpers/compareLonLatLikesByDistanceKm.helper.d.ts

@@ -0,0 +1,2 @@
+import { LonLatLike } from "../../types";
+export declare const compareLonLatLikesByDistanceKm: (leftLonLatLike: LonLatLike, rightLonLatLike: LonLatLike, distanceKm?: number) => boolean;

package/dist/utils/helpers/filterLonLatLikesByDistanceKm.helper.d.ts

@@ -0,0 +1,6 @@
+import { LonLatLike } from "../../types";
+export declare const filterLonLatLikesByDistanceKm: (lonLatLikes: (LonLatLike | undefined | null)[], minDistance: number, { startOffsetKm, endOffsetKm }?: {
+    startOffsetKm?: number | undefined;
+    endOffsetKm?: number | undefined;
+}) => LonLatLike[];
+export declare const removeByOffsetKm: (lonLatLikes: LonLatLike[], direction: "right" | "left", offset: number) => LonLatLike[];

package/dist/utils/helpers/getConvertedLength.helper.d.ts

@@ -0,0 +1,12 @@
+import { LengthUnit, Nillable } from "../types";
+/** The function is needed to get a converted length value
+ * @param {Nillable<string | number>} value - Source value, length
+ * @param {LengthUnit} originUnit - Origin unit
+ * @param {LengthUnit} targetUnit - Target unit
+ * @returns {number} - Converted length number
+ */
+export declare const getConvertedLength: ({ value, originUnit, targetUnit }: {
+    value: Nillable<string | number>;
+    targetUnit: LengthUnit;
+    originUnit?: LengthUnit | undefined;
+}) => number;

package/dist/utils/helpers/getKmDistanceBetweenLonLatLike.helper.d.ts

@@ -0,0 +1,8 @@
+import { LonLatLike } from "../../types";
+/**
+ * This helper calculates the distance between two lon lat coordinates in kilometers
+ * @param {LonLatLike} firstLonLatLike The first coordinate
+ * @param {LonLatLike} secondLonLatLike The second coordinate
+ * @returns {number} Distance in km
+ */
+export declare const getKmDistanceBetweenLonLatLike: (firstLonLatLike: LonLatLike, secondLonLatLike: LonLatLike) => number;

package/dist/utils/helpers/httpHeader.helpers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * This helper is used to receive the boolean value based on condition, to understand header type is "omit".
+ * @param {Headers} headers - Request headers
+ * @param {string} name - Header name
+ */
+export declare const getIsOmitHeader: ({ headers, name }: {
+    headers: Headers;
+    name: string;
+}) => boolean;
+/**
+ * This helper is used to add new headers for request.
+ * @param {Headers} headers - Request headers
+ * @param {string} name - Header name
+ * @param {string} value - Header value
+ */
+export declare const handleHeader: ({ headers, name, value }: {
+    headers: Headers;
+    name: string;
+    value: string;
+}) => void;
+/**
+ * This helper is used to add Authorization header for request.
+ * @param {Headers} headers - Request headers
+ * @param {string} apiKey - Map SDK key
+ */
+export declare const handleAuthorizationHeader: ({ headers, apiKey }: {
+    headers: Headers;
+    apiKey: string;
+}) => void;

package/dist/utils/helpers/indexDBFactory.helper.d.ts

@@ -0,0 +1,14 @@
+import { IndexDBName } from "../types";
+interface IndexDB {
+    get<T>(key: IDBValidKey): Promise<T | undefined>;
+    get<T>(): Promise<T | undefined>;
+    save<T>(key: IDBValidKey, value: T): Promise<IDBValidKey>;
+    save<T>(value: T): Promise<IDBValidKey>;
+    update<T>(key: IDBValidKey, value: Partial<T>): Promise<IDBValidKey>;
+    update<T>(value: Partial<T>): Promise<IDBValidKey>;
+    remove(key: IDBValidKey): Promise<void>;
+    remove(): Promise<void>;
+    deleteDatabase(): void;
+}
+export declare const indexDBFactory: (databaseName: IndexDBName) => Promise<IndexDB>;
+export {};

package/dist/utils/helpers/normalizeColor.helper.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Normalizes a color string to a valid color format
+ *
+ * @param color - Color string to normalize (hex, rgb, rgba, or CSS color name)
+ * @returns Normalized color string (hex or rgba format)
+ *
+ * @example
+ * ```ts
+ * normalizeColor("orange"); // "#ffa500"
+ * normalizeColor("#fff"); // "#fff"
+ * normalizeColor("000000"); // "#000000"
+ * normalizeColor("rgba(0, 0, 0, 0.5)"); // "rgba(0, 0, 0, 0.5)"
+ * normalizeColor("invalid"); // "#000000"
+ * normalizeColor(undefined); // "#000000"
+ * ```
+ */
+export declare const normalizeColor: (color?: string) => string;

package/dist/utils/helpers/prepareAppErrorMailToData.helper.d.ts

@@ -1,7 +1,7 @@
 export declare const prepareAppErrorMailToData: ({ appError, accessToken }: {
     appError: Error;
     accessToken: string;
-}) => {
+}) => Promise<{
     subject: string;
     body: string;
-};
+}>;

package/dist/utils/helpers/roundToDecimals.helper.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Round a number to specified decimal places
+ */
+export declare const roundToDecimals: (num: number, decimals?: number) => number;

package/dist/utils/helpers/setUrlParameter.helper.d.ts

@@ -0,0 +1,5 @@
+export declare const setUrlParameter: ({ stringUrl, key, value }: {
+    stringUrl: string | undefined;
+    key: string;
+    value: string;
+}) => string;

package/dist/utils/helpers/sourcemap.helpers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Reduces a full error stack to show only relevant application code frames.
+ * In production, it first applies source map transformations, then filters out framework/library noise.
+ * In development, it just filters the stack.
+ *
+ * @param stack - Full error stack trace string
+ * @param maxFrames - Maximum number of relevant frames to return (default: 1)
+ * @returns Reduced stack trace string with only application code
+ */
+export declare function getReducedErrorStack(stack: string | undefined, maxFrames?: number): Promise<string | undefined>;
+/**
+ * This helper will either adapt the error track to the original code if possible or return the built chunk track.
+ */
+export declare function getAdaptedErrorStack(stack: string): Promise<string>;

package/dist/utils/helpers.d.ts

@@ -1,2 +1,6 @@
 export declare const getCurrentMileMakerApiEnv: (proxyEnv: string) => string;
 export declare const getCurrentMileMakerAppEnv: (proxyEnv: string) => string;
+/**
+ * Clears mapSdk cache, mostly browser one to avoid overloading the Browser API.
+ */
+export declare const clearCache: () => Promise<void>;

package/dist/utils/singletons/wasmFloat.polyfill.d.ts

@@ -0,0 +1,9 @@
+export declare class WasmFloatPolyfill {
+    private _value;
+    constructor(value: number | WasmFloatPolyfill);
+    add(value: WasmFloatPolyfill): this;
+    sub(value: WasmFloatPolyfill): this;
+    mul(value: WasmFloatPolyfill): this;
+    div(value: WasmFloatPolyfill): this;
+    valueOf(): number;
+}

package/dist/utils/singletons/wasmMath.singleton.d.ts

@@ -0,0 +1,8 @@
+import { CalculateTypeWithDestroy } from "gmp-wasm";
+export declare class WasmMathSingleton {
+    private static _instance;
+    static get Float(): CalculateTypeWithDestroy["Float"] | undefined;
+    static get get(): CalculateTypeWithDestroy | undefined;
+    static onWasmUnsupported(): void;
+    static set(config: CalculateTypeWithDestroy): void;
+}

package/dist/utils/types.d.ts

@@ -5,14 +5,29 @@ export declare enum Env {
 }
 export type UnwrapPromise<T> = T extends Promise<infer U> ? U : T;
 export type Awaited<T> = T extends PromiseLike<infer U> ? U : T;
-export declare enum ContactSupportMandatoryField {
-    MAP_SDK_KEY = "mapSdkKey",
-    BROWSER_INFO = "browserInfo",
-    TIMESTAMP = "timestamp",
-    APP_VERSION = "appVersion",
-    SCOPE = "scope"
-}
 export declare enum Mail {
     SUPPORT = "support@milemaker.com",
     SALES = "mmsales@milemaker.com"
 }
+export type MaybePromise<T> = T | PromiseLike<T>;
+export type FunctionType<Args = unknown[] | void, Return = void> = Args extends unknown[] ? (...args: Args) => Return : Args extends unknown ? (...args: unknown[]) => Return : Args extends void ? () => Return : never;
+export declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE",
+    PATCH = "PATCH"
+}
+export declare enum IndexDBName {
+    AERIS_WEATHER = "milemaker_aerisWeather"
+}
+export declare enum LengthUnit {
+    MILES = "miles",
+    KILOMETERS = "kilometers"
+}
+export declare enum VolumeUnit {
+    GALLON = "gallon",
+    LITER = "liter"
+}
+export type Rate<Unit extends LengthUnit | VolumeUnit> = Partial<Record<Unit, Partial<Record<Unit, number>>>>;
+export type Nillable<T> = T | null | undefined;

package/dist/utils/version.d.ts

@@ -1 +1 @@
-export declare const APP_VERSION = "2.0.0-alpha.3";
+export declare const APP_VERSION = "2.0.0-alpha.6";

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@milemaker/milemaker-js",
     "private": false,
-    "version": "2.0.0-alpha.3",
+    "version": "2.0.0-alpha.7",
     "type": "module",
     "license": "BSD-3-Clause",
     "files": [
@@ -29,8 +29,13 @@
     "dependencies": {
         "@googlemaps/polyline-codec": "^1.0.28",
         "detect-browser": "^5.3.0",
+        "easy-web-worker": "^7.0.5",
+        "gmp-wasm": "^1.3.2",
         "lodash": "^4.17.21",
-        "uuid": "^9.0.0"
+        "serialize-error": "^12.0.0",
+        "source-map-js": "^1.2.1",
+        "uuid": "^9.0.0",
+        "zod": "^4.2.1"
     },
     "devDependencies": {
         "@milemaker/nmaps-gl": "^1.6.10",

package/dist/controls/utils/weatherLayers.types.d.ts

@@ -1 +0,0 @@
-export type WeatherLayerType = "radar" | "alerts" | "satellite" | "roadConditions" | "temperatures" | "windSpeeds";

package/dist/helpers/sdkEvents.helpers.d.ts

@@ -1,4 +0,0 @@
-export declare const triggerMapSdkInitEvent: ({ apiKey, proxyEnv }: {
-    apiKey: string;
-    proxyEnv: string;
-}) => Promise<void>;

package/dist/utils/helpers/prepareContactSupportMandatoryFields.helper.d.ts

@@ -1,4 +0,0 @@
-import { ContactSupportMandatoryField } from "../types";
-export declare const prepareContactSupportMandatoryFields: ({ accessToken }: {
-    accessToken: string;
-}) => Record<ContactSupportMandatoryField, unknown>;