@mapvx/web-js 1.0.0

package/dist/es/domain/models/routeInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeInstance.js","sourceRoot":"","sources":["../../../../src/domain/models/routeInstance.ts"],"names":[],"mappings":"AA8CA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAe;IACjD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK;QACL,OAAO,EAAE,SAAS,KAAK,CAAC,EAAE,EAAE;QAC5B,QAAQ,EAAE,UAAU,KAAK,CAAC,EAAE,EAAE;QAC9B,SAAS,EAAE,WAAW,KAAK,CAAC,EAAE,EAAE;QAChC,eAAe,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC5D,gBAAgB,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC7D,iBAAiB,EAAE;YACjB,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE;SAClD;QACD,eAAe,EAAE,UAAU;QAC3B,mBAAmB,EAAE,UAAU;KAChC,CAAA;AACH,CAAC"}

package/dist/es/domain/models/routeStyle.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Union type representing different styles for route visualization
+ * Routes can be displayed with either solid colors or gradient patterns
+ * @group Routes
+ */
+export type RouteStyle = GradientStyle | SolidStyle;
+/**
+ * Interface for gradient-style route visualization
+ * Allows creating routes with color gradients for enhanced visual appeal
+ * @group Routes
+ */
+export interface GradientStyle {
+    /**
+     * Array of colors in hexadecimal format for the gradient
+     * Colors will be distributed along the route path
+     * Example: ["#FF0000", "#00FF00", "#0000FF"]
+     */
+    colors: string[];
+    /**
+     * Optional array of numbers between 0 and 1 indicating the position of each color
+     * This array must have the same length as the colors array
+     * Example: [0, 0.5, 1] - colors will be positioned at 0%, 50%, and 100% of the route
+     * If not provided, colors will be distributed evenly across the route
+     */
+    positions?: number[];
+    /**
+     * Type identifier for gradient style
+     */
+    type: "Gradient";
+}
+/**
+ * Interface for solid-color route visualization
+ * Provides simple, consistent coloring for route paths
+ * @group Routes
+ */
+export interface SolidStyle {
+    /**
+     * Color of the route line in hexadecimal format
+     * Example: "#FF0000" for red, "#0076B6" for blue
+     */
+    color: string;
+    /**
+     * Type identifier for solid style
+     */
+    type: "Solid";
+}
+//# sourceMappingURL=routeStyle.d.ts.map

package/dist/es/domain/models/routeStyle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeStyle.d.ts","sourceRoot":"","sources":["../../../../src/domain/models/routeStyle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,UAAU,CAAA;AAEnD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,MAAM,EAAE,MAAM,EAAE,CAAA;IAEhB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IAEpB;;OAEG;IACH,IAAI,EAAE,UAAU,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,IAAI,EAAE,OAAO,CAAA;CACd"}

package/dist/es/domain/models/routeStyle.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=routeStyle.js.map

package/dist/es/domain/models/routeStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeStyle.js","sourceRoot":"","sources":["../../../../src/domain/models/routeStyle.ts"],"names":[],"mappings":""}

package/dist/es/domain/models/transport.d.ts

@@ -0,0 +1,176 @@
+import { type MultiLanguage } from "./multilanguage";
+import { type MVXPlace } from "./place";
+/**
+ * Interface that represents the API response for transport services.
+ * Contains both real-time schedules and regular schedules.
+ */
+export interface TransportResponse {
+    /**
+     * List of real-time schedules for transport services
+     */
+    realtimeSchedules: RealtimeSchedule[];
+    /**
+     * List of regular schedules for transport services
+     */
+    schedules: Schedule[];
+}
+/**
+ * Interface that represents a real-time schedule of a transport service.
+ * Contains detailed information about a specific route in real-time.
+ * @group Places & Locations
+ */
+export interface RealtimeSchedule {
+    /**
+     * Name of the transport route
+     */
+    routeName: string;
+    /**
+     * Informative message about the service status
+     */
+    message: string;
+    /**
+     * Opening hours of the service (optional)
+     */
+    opening_hours?: [];
+    /**
+     * Additional properties of the service (optional)
+     */
+    properties?: [];
+    /**
+     * Name of the current stop
+     */
+    stopName: string;
+    /**
+     * Final destination of the route
+     */
+    finalDestination: string;
+    /**
+     * Origin or source of the service
+     */
+    source: string;
+    /**
+     * URL of the icon associated with the service (optional)
+     */
+    icon?: string;
+    /**
+     * Unique identifier of the vehicle
+     */
+    vehicleId: string;
+    /**
+     * Distance from the current stop in meters
+     */
+    distance: number;
+    /**
+     * Estimated arrival time in text format
+     */
+    estimatedTime: string;
+    /**
+     * Remaining time until arrival in text format
+     */
+    remainingTime: string;
+    /**
+     * Service title in multiple languages
+     */
+    title: MultiLanguage;
+    /**
+     * Indicates if the service is delayed
+     */
+    delayed: boolean;
+    /**
+     * Route direction (outbound or inbound)
+     */
+    routeDirection: string;
+    /**
+     * Route identifier
+     */
+    route: string;
+    /**
+     * Latitude of the vehicle's current location
+     */
+    latitude: number;
+    /**
+     * Longitude of the vehicle's current location
+     */
+    longitude: number;
+    /**
+     * Stop identifier
+     */
+    stopId: string;
+    /**
+     * List of stops associated with this route (optional)
+     */
+    stops?: MVXPlace[];
+}
+/**
+ * Interface that represents a regular schedule of a transport service.
+ * Contains information about fixed schedules of a transport line.
+ * @group Places & Locations
+ */
+export interface Schedule {
+    /**
+     * Identifier of the transport line
+     */
+    line: string;
+    /**
+     * Route direction (outbound or inbound)
+     */
+    routeDirection: string;
+    /**
+     * Schedules organized by days of the week
+     */
+    schedule: DaysAndTimes[];
+    /**
+     * Origin or source of the service
+     */
+    source: string;
+    /**
+     * Service title in multiple languages
+     */
+    title: MultiLanguage;
+    /**
+     * Today's schedule in text format
+     */
+    today_schedule: string;
+    /**
+     * Next schedule in text format
+     */
+    next_schedule: string;
+}
+/**
+ * Interface that represents schedules for specific days of the week.
+ * Defines which days and at what times the service operates.
+ * @group Places & Locations
+ */
+export interface DaysAndTimes {
+    /**
+     * List of days of the week in abbreviated format (e.g., ["mo", "tu", "we"])
+     */
+    days: string[];
+    /**
+     * List of schedules in text format (e.g., ["08:00", "12:00", "18:00"])
+     */
+    times: string[];
+}
+/**
+ * Class that represents a transport object in MapVX.
+ * Contains both regular schedules and real-time information.
+ * @group Others
+ */
+export declare class MVXTransport {
+    /**
+     * List of regular schedules for transport services
+     */
+    schedule: Schedule[];
+    /**
+     * List of real-time routes for transport services
+     */
+    routes: RealtimeSchedule[];
+    /**
+     * Creates a new transport instance with the parameters specified in the response of the endpoint.
+     * @hidden
+     * @param data json parameters for the transport object.
+     * @returns A new instance of MVXTransport is returned.
+     */
+    constructor(data: TransportResponse);
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/es/domain/models/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/domain/models/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,iBAAiB,EAAE,gBAAgB,EAAE,CAAA;IAErC;;OAEG;IACH,SAAS,EAAE,QAAQ,EAAE,CAAA;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,CAAA;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,CAAA;IAEf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,KAAK,EAAE,aAAa,CAAA;IAEpB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;IAEhB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,cAAc,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,QAAQ,EAAE,YAAY,EAAE,CAAA;IAExB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,KAAK,EAAE,aAAa,CAAA;IAEpB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAA;IAEd;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,QAAQ,EAAE,QAAQ,EAAE,CAAA;IAEpB;;OAEG;IACH,MAAM,EAAE,gBAAgB,EAAE,CAAA;IAE1B;;;;;OAKG;gBACS,IAAI,EAAE,iBAAiB;CAIpC"}

package/dist/es/domain/models/transport.js

@@ -0,0 +1,18 @@
+/**
+ * Class that represents a transport object in MapVX.
+ * Contains both regular schedules and real-time information.
+ * @group Others
+ */
+export class MVXTransport {
+    /**
+     * Creates a new transport instance with the parameters specified in the response of the endpoint.
+     * @hidden
+     * @param data json parameters for the transport object.
+     * @returns A new instance of MVXTransport is returned.
+     */
+    constructor(data) {
+        this.schedule = data.schedules;
+        this.routes = data.realtimeSchedules;
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/es/domain/models/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../src/domain/models/transport.ts"],"names":[],"mappings":"AAyLA;;;;GAIG;AACH,MAAM,OAAO,YAAY;IAWvB;;;;;OAKG;IACH,YAAY,IAAuB;QACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAA;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAA;IACtC,CAAC;CACF"}

package/dist/es/domain/ports/ICache.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Cache statistics interface
+ * Provides information about cache state and performance
+ * @group Configuration
+ */
+export interface CacheStats {
+    /** Current number of items in cache */
+    size: number;
+    /** Maximum allowed items in cache */
+    maxItems: number;
+    /** Optional hit rate percentage (0-100) */
+    hitRate?: number;
+}
+/**
+ * Generic cache interface (Port)
+ * Defines the contract for cache implementations in the SDK.
+ * Following hexagonal architecture, this is a port that can be
+ * implemented by different adapters (memory, localStorage, etc.)
+ *
+ * @typeParam T - The type of values stored in the cache
+ * @group Configuration
+ *
+ * @example
+ * ```typescript
+ * const cache: ICache<MVXPlace> = new LRUCache({ maxItems: 100, ttlMs: 60000 })
+ * cache.set("place-1", placeObject)
+ * const place = cache.get("place-1")
+ * ```
+ */
+export interface ICache<T> {
+    /**
+     * Retrieves a value from the cache
+     * @param key - The cache key
+     * @returns The cached value or undefined if not found/expired
+     */
+    get(key: string): T | undefined;
+    /**
+     * Stores a value in the cache
+     * @param key - The cache key
+     * @param value - The value to store
+     */
+    set(key: string, value: T): void;
+    /**
+     * Checks if a key exists in the cache
+     * @param key - The cache key
+     * @returns true if the key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Removes a specific key from the cache
+     * @param key - The cache key to remove
+     * @returns true if the key was found and removed
+     */
+    delete(key: string): boolean;
+    /**
+     * Removes all entries from the cache
+     */
+    clear(): void;
+    /**
+     * Returns current cache statistics
+     * @returns CacheStats object with size and configuration info
+     */
+    getStats(): CacheStats;
+    /**
+     * Returns all keys currently in the cache
+     * @returns Array of cache keys
+     */
+    keys(): string[];
+}
+//# sourceMappingURL=ICache.d.ts.map

package/dist/es/domain/ports/ICache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICache.d.ts","sourceRoot":"","sources":["../../../../src/domain/ports/ICache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAA;IAE/B;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IAEhC;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAEzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAE5B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;IAEb;;;OAGG;IACH,QAAQ,IAAI,UAAU,CAAA;IAEtB;;;OAGG;IACH,IAAI,IAAI,MAAM,EAAE,CAAA;CACjB"}

package/dist/es/domain/ports/ICache.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ICache.js.map

package/dist/es/domain/ports/ICache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICache.js","sourceRoot":"","sources":["../../../../src/domain/ports/ICache.ts"],"names":[],"mappings":""}

package/dist/es/domain/ports/IHttpClient.d.ts

@@ -0,0 +1,77 @@
+/**
+ * HTTP response wrapper interface
+ * Provides a consistent response structure regardless of the underlying HTTP client
+ * @group Utils
+ */
+export interface HttpResponse<T = unknown> {
+    /** Whether the request was successful (status 200-299) */
+    ok: boolean;
+    /** HTTP status code */
+    status: number;
+    /** Response data (parsed JSON or raw) */
+    data: T;
+    /** Optional status text */
+    statusText?: string;
+}
+/**
+ * HTTP request options
+ * @group Utils
+ */
+export interface HttpRequestOptions {
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Whether to parse response as JSON (default: true) */
+    parseJson?: boolean;
+}
+/**
+ * HTTP Client interface (Port)
+ * Defines the contract for HTTP operations in the SDK.
+ * Following hexagonal architecture, this is a port that can be
+ * implemented by different adapters (fetch, axios, etc.)
+ *
+ * @group Utils
+ *
+ * @example
+ * ```typescript
+ * const httpClient: IHttpClient = new FetchHttpClient()
+ * const response = await httpClient.get<UserData>('https://api.example.com/users/1')
+ * if (response.ok) {
+ *   console.log(response.data)
+ * }
+ * ```
+ */
+export interface IHttpClient {
+    /**
+     * Performs a GET request
+     * @param url - The URL to fetch
+     * @param options - Optional request configuration
+     * @returns Promise resolving to HttpResponse
+     */
+    get<T = unknown>(url: string, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Performs a POST request
+     * @param url - The URL to post to
+     * @param body - The request body (will be JSON stringified)
+     * @param options - Optional request configuration
+     * @returns Promise resolving to HttpResponse
+     */
+    post<T = unknown>(url: string, body: unknown, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Performs a PUT request
+     * @param url - The URL to put to
+     * @param body - The request body (will be JSON stringified)
+     * @param options - Optional request configuration
+     * @returns Promise resolving to HttpResponse
+     */
+    put<T = unknown>(url: string, body: unknown, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Performs a DELETE request
+     * @param url - The URL to delete
+     * @param options - Optional request configuration
+     * @returns Promise resolving to HttpResponse
+     */
+    delete<T = unknown>(url: string, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+}
+//# sourceMappingURL=IHttpClient.d.ts.map

package/dist/es/domain/ports/IHttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IHttpClient.d.ts","sourceRoot":"","sources":["../../../../src/domain/ports/IHttpClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,0DAA0D;IAC1D,EAAE,EAAE,OAAO,CAAA;IACX,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,IAAI,EAAE,CAAC,CAAA;IACP,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAErF;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAE3B;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAE3B;;;;;OAKG;IACH,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;CACzF"}

package/dist/es/domain/ports/IHttpClient.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IHttpClient.js.map

package/dist/es/domain/ports/IHttpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IHttpClient.js","sourceRoot":"","sources":["../../../../src/domain/ports/IHttpClient.ts"],"names":[],"mappings":""}

package/dist/es/domain/ports/ILogger.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Logger interface (Port)
+ * Defines the contract for logging and analytics in the SDK.
+ * Following hexagonal architecture, this is a port that can be
+ * implemented by different adapters (Countly, console, custom, etc.)
+ *
+ * @group Utils
+ *
+ * @example
+ * ```typescript
+ * const logger: ILogger = new CountlyLogger()
+ * logger.logEvent("button_click", { buttonId: "submit" })
+ * logger.logError(new Error("Something went wrong"), { userId: "123" })
+ * ```
+ */
+export interface ILogger {
+    /**
+     * Logs an analytics event
+     * @param eventName - Name of the event to log
+     * @param segmentation - Optional key-value pairs for event context
+     */
+    logEvent(eventName: string, segmentation?: Record<string, string>): void;
+    /**
+     * Logs an error to error tracking service
+     * @param error - The error to log
+     * @param context - Optional context information
+     */
+    logError(error: unknown, context?: Record<string, string>): void;
+    /**
+     * Logs a warning (less severe than error)
+     * @param error - The warning/error to log
+     * @param context - Optional context information
+     */
+    logWarning(error: unknown, context?: Record<string, string>): void;
+    /**
+     * Logs debug information (only in debug mode)
+     * @param args - Arguments to log
+     */
+    logDebug(...args: unknown[]): void;
+    /**
+     * Sets the token for segmentation
+     * @param token - API token for identifying the SDK instance
+     */
+    setToken?(token: string): void;
+    /**
+     * Enables or disables debug mode
+     * @param enabled - Whether debug logging should be enabled
+     */
+    setDebugMode?(enabled: boolean): void;
+}
+/**
+ * No-op logger implementation for testing or when logging is disabled
+ * @group Utils
+ */
+export declare class NoopLogger implements ILogger {
+    logEvent(): void;
+    logError(): void;
+    logWarning(): void;
+    logDebug(): void;
+}
+//# sourceMappingURL=ILogger.d.ts.map

package/dist/es/domain/ports/ILogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.d.ts","sourceRoot":"","sources":["../../../../src/domain/ports/ILogger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAExE;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAEhE;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAElE;;;OAGG;IACH,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAElC;;;OAGG;IACH,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B;;;OAGG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;CACtC;AAED;;;GAGG;AACH,qBAAa,UAAW,YAAW,OAAO;IACxC,QAAQ,IAAI,IAAI;IAIhB,QAAQ,IAAI,IAAI;IAIhB,UAAU,IAAI,IAAI;IAIlB,QAAQ,IAAI,IAAI;CAGjB"}

package/dist/es/domain/ports/ILogger.js

@@ -0,0 +1,19 @@
+/**
+ * No-op logger implementation for testing or when logging is disabled
+ * @group Utils
+ */
+export class NoopLogger {
+    logEvent() {
+        // No-op
+    }
+    logError() {
+        // No-op
+    }
+    logWarning() {
+        // No-op
+    }
+    logDebug() {
+        // No-op
+    }
+}
+//# sourceMappingURL=ILogger.js.map

package/dist/es/domain/ports/ILogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.js","sourceRoot":"","sources":["../../../../src/domain/ports/ILogger.ts"],"names":[],"mappings":"AAwDA;;;GAGG;AACH,MAAM,OAAO,UAAU;IACrB,QAAQ;QACN,QAAQ;IACV,CAAC;IAED,QAAQ;QACN,QAAQ;IACV,CAAC;IAED,UAAU;QACR,QAAQ;IACV,CAAC;IAED,QAAQ;QACN,QAAQ;IACV,CAAC;CACF"}

package/dist/es/domain/ports/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Domain Ports (Interfaces)
+ * These define the contracts for external dependencies following hexagonal architecture.
+ */
+export type { ICache, CacheStats } from "./ICache";
+export type { IHttpClient, HttpResponse, HttpRequestOptions } from "./IHttpClient";
+export type { ILogger } from "./ILogger";
+export { NoopLogger } from "./ILogger";
+//# sourceMappingURL=index.d.ts.map

package/dist/es/domain/ports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/ports/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAClD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClF,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA"}

package/dist/es/domain/ports/index.js

@@ -0,0 +1,6 @@
+/**
+ * Domain Ports (Interfaces)
+ * These define the contracts for external dependencies following hexagonal architecture.
+ */
+export { NoopLogger } from "./ILogger";
+//# sourceMappingURL=index.js.map

package/dist/es/domain/ports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain/ports/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA"}

package/dist/es/index.d.ts

@@ -0,0 +1,58 @@
+export type { ICache, CacheStats } from "./domain/ports/ICache";
+export type { IHttpClient, HttpResponse, HttpRequestOptions } from "./domain/ports/IHttpClient";
+export type { ILogger } from "./domain/ports/ILogger";
+export { LRUCache } from "./infrastructure/cache/LRUCache";
+export { PersistentCache } from "./infrastructure/cache/PersistentCache";
+export { CacheManager } from "./infrastructure/cache/CacheManager";
+export type { CacheConfig, CacheManagerConfig, CacheType } from "./infrastructure/cache/cacheConfig";
+export { DEFAULT_CACHE_CONFIGS, DEFAULT_MAX_STORAGE_BYTES, } from "./infrastructure/cache/cacheConfig";
+export { FetchHttpClient } from "./infrastructure/http/FetchHttpClient";
+export { CountlyLogger } from "./infrastructure/logging/CountlyLogger";
+export type { MapVXMap } from "./map/map";
+export { initializeSDK } from "./sdk";
+export type { MapVXSDK } from "./sdk";
+export type { MapVxRequestContext, SDKConfig } from "./config/sdkConfig";
+export type { AnimationConfig, AnimationDrawingConfig, AnimationStatus } from "./domain/models/animation";
+export { createRouteAnimationIconDataUrl } from "./assets/icons";
+export type { RouteAnimationIconConfig } from "./assets/icons";
+export { Banner } from "./domain/models/banner";
+export { isBasicWithIcon, isBasicWithLogo } from "./domain/models/categories";
+export type { BasicCategory, BasicWithIcon, BasicWithLogo, Category, InternalLinkCategory, NestedCategory, PhoneCategory, PlaceCategory, ProductCategory, TextCategory, UrlCategory, } from "./domain/models/categories";
+export type { CityFilterOption, InstitutionCityFilterOption, ParentPlaceCityFilterOption, } from "./domain/models/cityFilterOption";
+export type { Configuration } from "./domain/models/configuration";
+export type { CssComponent, CssCustomization, CssDefinitions, CssElement, CssScreen, CssTheme, } from "./domain/models/cssCustomization";
+export type { FitOptions, FloorUpdateOptions, ZoomOptions, BoundsOptions, PaddingOptions, PaddingValue, } from "./domain/models/fitOptions";
+export type { InnerFloor } from "./domain/models/innerFloors";
+export { Institution } from "./domain/models/institution";
+export type { LatLng, PositionCallback } from "./domain/models/latLng";
+export type { MVXLocation } from "./domain/models/location";
+export type { CameraAnimation, MapCamera } from "./domain/models/mapCamera";
+export type { MapConfig, MapTileCacheConfig } from "./domain/models/mapConfig";
+export { TextPosition } from "./domain/models/marker";
+export type { MarkerConfig, TextProperties } from "./domain/models/marker";
+export type { MultiLanguage } from "./domain/models/multilanguage";
+export type { DaysOfTheWeek, OpeningHours, OpeningTime } from "./domain/models/openingHours";
+export { MVXPlace } from "./domain/models/place";
+export type { Property } from "./domain/models/property";
+export { MVXRoute, MVXRouteLeg, MVXRouteStep } from "./domain/models/route";
+export { AnnounceFormat, TransportationMode, UnitSystem } from "./domain/models/routeConfiguration";
+export type { DrawRouteConfiguration, GetRouteConfiguration, IdLocation, RouteLocation, } from "./domain/models/routeConfiguration";
+export type { GradientStyle, RouteStyle, SolidStyle } from "./domain/models/routeStyle";
+export { MVXTransport } from "./domain/models/transport";
+export type { RealtimeSchedule, Schedule } from "./domain/models/transport";
+export type { HealthResponse } from "./interfaces/healthResponse";
+export type { InstitutionResponse } from "./interfaces/institutionResponse";
+export type { PlaceResponse } from "./interfaces/placeResponse";
+export { loadCustomization } from "./utils/update-css";
+export { OpeningHoursHelper } from "./utils/opening-hours-helper";
+/**
+ * Function to load default styles
+ * @group Utils
+ */
+export declare const loadStyles: () => void;
+/**
+ * Re-export MapLibre GL JS types for convenience
+ * @group Utils
+ */
+export type { Map as MapLibreMap, Marker as MapLibreMarker, PositionAnchor, PointLike, StyleSpecification, LngLatLike, LngLatBoundsLike, MapOptions, MapEventType, MapLayerEventType, } from "maplibre-gl";
+//# sourceMappingURL=index.d.ts.map

package/dist/es/index.d.ts.map

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