@mapvx/web-js 1.0.0

package/dist/es/infrastructure/cache/PersistentCache.d.ts

@@ -0,0 +1,58 @@
+import type { ICache, CacheStats } from "../../domain/ports/ICache";
+import type { CacheConfig } from "./cacheConfig";
+/**
+ * Persistent Cache implementation (Decorator pattern)
+ * Wraps LRUCache with localStorage persistence.
+ *
+ * Features:
+ * - Automatic save to localStorage on modifications
+ * - Hydration from localStorage on initialization
+ * - Graceful degradation when localStorage unavailable
+ * - Storage quota management
+ * - Expired items filtered during hydration
+ *
+ * @typeParam T - The type of values stored in the cache
+ * @group Configuration
+ *
+ * @example
+ * ```typescript
+ * const cache = new PersistentCache<string>({
+ *   maxItems: 100,
+ *   ttlMs: 60000,
+ *   persistenceKey: "my_cache"
+ * })
+ * cache.set("key1", "value1") // Saved to memory and localStorage
+ * ```
+ */
+export declare class PersistentCache<T> implements ICache<T> {
+    private readonly lruCache;
+    private readonly persistenceKey;
+    private readonly maxStorageBytes;
+    private readonly ttlMs;
+    private storageAvailable;
+    constructor(config: CacheConfig, maxStorageBytes?: number);
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    keys(): string[];
+    getStats(): CacheStats;
+    /**
+     * Loads cache data from localStorage on initialization
+     */
+    private hydrate;
+    /**
+     * Saves current cache state to localStorage
+     */
+    private persist;
+    /**
+     * Removes cache data from localStorage
+     */
+    private removeFromStorage;
+    /**
+     * Checks if localStorage is available
+     */
+    private isStorageAvailable;
+}
+//# sourceMappingURL=PersistentCache.d.ts.map

package/dist/es/infrastructure/cache/PersistentCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistentCache.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/cache/PersistentCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAqBhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,MAAM,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,gBAAgB,CAAgB;gBAE5B,MAAM,EAAE,WAAW,EAAE,eAAe,CAAC,EAAE,MAAM;IASzD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAKhC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5B,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,MAAM,EAAE;IAIhB,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,OAAO,CAAC,OAAO;IAiCf;;OAEG;IACH,OAAO,CAAC,OAAO;IAmCf;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAU3B"}

package/dist/es/infrastructure/cache/PersistentCache.js

@@ -0,0 +1,156 @@
+import { DEFAULT_MAX_STORAGE_BYTES } from "./cacheConfig";
+import { LRUCache } from "./LRUCache";
+/**
+ * Persistent Cache implementation (Decorator pattern)
+ * Wraps LRUCache with localStorage persistence.
+ *
+ * Features:
+ * - Automatic save to localStorage on modifications
+ * - Hydration from localStorage on initialization
+ * - Graceful degradation when localStorage unavailable
+ * - Storage quota management
+ * - Expired items filtered during hydration
+ *
+ * @typeParam T - The type of values stored in the cache
+ * @group Configuration
+ *
+ * @example
+ * ```typescript
+ * const cache = new PersistentCache<string>({
+ *   maxItems: 100,
+ *   ttlMs: 60000,
+ *   persistenceKey: "my_cache"
+ * })
+ * cache.set("key1", "value1") // Saved to memory and localStorage
+ * ```
+ */
+export class PersistentCache {
+    constructor(config, maxStorageBytes) {
+        this.storageAvailable = true;
+        this.lruCache = new LRUCache(config);
+        this.persistenceKey = config.persistenceKey || "mvx_cache";
+        this.maxStorageBytes = maxStorageBytes !== null && maxStorageBytes !== void 0 ? maxStorageBytes : DEFAULT_MAX_STORAGE_BYTES;
+        this.ttlMs = config.ttlMs;
+        this.hydrate();
+    }
+    get(key) {
+        return this.lruCache.get(key);
+    }
+    set(key, value) {
+        this.lruCache.set(key, value);
+        this.persist();
+    }
+    has(key) {
+        return this.lruCache.has(key);
+    }
+    delete(key) {
+        const result = this.lruCache.delete(key);
+        if (result) {
+            this.persist();
+        }
+        return result;
+    }
+    clear() {
+        this.lruCache.clear();
+        this.removeFromStorage();
+    }
+    keys() {
+        return this.lruCache.keys();
+    }
+    getStats() {
+        return this.lruCache.getStats();
+    }
+    /**
+     * Loads cache data from localStorage on initialization
+     */
+    hydrate() {
+        if (!this.isStorageAvailable()) {
+            this.storageAvailable = false;
+            return;
+        }
+        try {
+            const stored = localStorage.getItem(this.persistenceKey);
+            if (!stored)
+                return;
+            const data = JSON.parse(stored);
+            if (!data.entries || !Array.isArray(data.entries)) {
+                return;
+            }
+            const now = Date.now();
+            for (const entry of data.entries) {
+                // Skip expired entries (if TTL is configured)
+                if (this.ttlMs > 0 && now - entry.timestamp > this.ttlMs) {
+                    continue;
+                }
+                // Restore to LRU cache
+                this.lruCache.set(entry.key, entry.value);
+            }
+        }
+        catch (_a) {
+            // Corrupted data or storage error - start with empty cache
+            this.storageAvailable = this.isStorageAvailable();
+        }
+    }
+    /**
+     * Saves current cache state to localStorage
+     */
+    persist() {
+        if (!this.storageAvailable)
+            return;
+        try {
+            const entries = [];
+            const keys = this.lruCache.keys();
+            for (const key of keys) {
+                const value = this.lruCache.get(key);
+                if (value !== undefined) {
+                    entries.push({
+                        key,
+                        value,
+                        timestamp: Date.now(),
+                        accessTime: Date.now(),
+                    });
+                }
+            }
+            const data = { entries };
+            const serialized = JSON.stringify(data);
+            // Check storage quota
+            if (serialized.length > this.maxStorageBytes) {
+                // Skip persistence if too large
+                return;
+            }
+            localStorage.setItem(this.persistenceKey, serialized);
+        }
+        catch (_a) {
+            // Storage quota exceeded or other error
+            this.storageAvailable = false;
+        }
+    }
+    /**
+     * Removes cache data from localStorage
+     */
+    removeFromStorage() {
+        if (!this.storageAvailable)
+            return;
+        try {
+            localStorage.removeItem(this.persistenceKey);
+        }
+        catch (_a) {
+            // Ignore errors
+        }
+    }
+    /**
+     * Checks if localStorage is available
+     */
+    isStorageAvailable() {
+        try {
+            const testKey = "__storage_test__";
+            localStorage.setItem(testKey, testKey);
+            localStorage.removeItem(testKey);
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=PersistentCache.js.map

package/dist/es/infrastructure/cache/PersistentCache.js.map

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

package/dist/es/infrastructure/cache/cacheConfig.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Cache configuration types and defaults
+ * Defines the configuration options for the caching system
+ * @module cacheConfig
+ */
+/**
+ * Cache types available in the SDK
+ * @group Configuration
+ */
+export type CacheType = "places" | "routes" | "accessibleRoutes" | "configurations" | "categories" | "vehicles" | "stops" | "subPlaces";
+/**
+ * Configuration for a single cache instance
+ * @group Configuration
+ */
+export interface CacheConfig {
+    /** Maximum number of items to store */
+    maxItems: number;
+    /** Time-to-live in milliseconds (0 = no expiration) */
+    ttlMs: number;
+    /** Optional key for localStorage persistence */
+    persistenceKey?: string;
+}
+/**
+ * Configuration for the CacheManager
+ * @group Configuration
+ */
+export interface CacheManagerConfig {
+    /** Enable localStorage persistence */
+    persistent?: boolean;
+    /** Maximum storage size in bytes for localStorage (default: 5MB) */
+    maxStorageBytes?: number;
+    /** Custom configurations per cache type */
+    configs?: Partial<Record<CacheType, Partial<CacheConfig>>>;
+}
+/**
+ * Default maximum storage size: 5MB
+ */
+export declare const DEFAULT_MAX_STORAGE_BYTES: number;
+/**
+ * Default cache configurations per type
+ * These values balance memory usage with performance
+ */
+export declare const DEFAULT_CACHE_CONFIGS: Record<CacheType, CacheConfig>;
+/**
+ * Merges user config with defaults for a specific cache type
+ * @param cacheType - The type of cache
+ * @param userConfig - Optional user-provided configuration
+ * @returns Complete cache configuration
+ */
+export declare function getCacheConfig(cacheType: CacheType, userConfig?: Partial<CacheConfig>): CacheConfig;
+//# sourceMappingURL=cacheConfig.d.ts.map

package/dist/es/infrastructure/cache/cacheConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheConfig.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/cache/cacheConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,kBAAkB,GAClB,gBAAgB,GAChB,YAAY,GACZ,UAAU,GACV,OAAO,GACP,WAAW,CAAA;AAEf;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;CAC3D;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAkB,CAAA;AAExD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAyChE,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,EACpB,UAAU,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAChC,WAAW,CAMb"}

package/dist/es/infrastructure/cache/cacheConfig.js

@@ -0,0 +1,66 @@
+/**
+ * Cache configuration types and defaults
+ * Defines the configuration options for the caching system
+ * @module cacheConfig
+ */
+/**
+ * Default maximum storage size: 5MB
+ */
+export const DEFAULT_MAX_STORAGE_BYTES = 5 * 1024 * 1024;
+/**
+ * Default cache configurations per type
+ * These values balance memory usage with performance
+ */
+export const DEFAULT_CACHE_CONFIGS = {
+    places: {
+        maxItems: 500,
+        ttlMs: 30 * 60 * 1000,
+        persistenceKey: "mvx_places",
+    },
+    routes: {
+        maxItems: 100,
+        ttlMs: 5 * 60 * 1000,
+        persistenceKey: "mvx_routes",
+    },
+    accessibleRoutes: {
+        maxItems: 100,
+        ttlMs: 5 * 60 * 1000,
+        persistenceKey: "mvx_accessible_routes",
+    },
+    configurations: {
+        maxItems: 10,
+        ttlMs: 60 * 60 * 1000,
+        persistenceKey: "mvx_configurations",
+    },
+    categories: {
+        maxItems: 20,
+        ttlMs: 60 * 60 * 1000,
+        persistenceKey: "mvx_categories",
+    },
+    vehicles: {
+        maxItems: 50,
+        ttlMs: 60 * 1000,
+        persistenceKey: "mvx_vehicles",
+    },
+    stops: {
+        maxItems: 100,
+        ttlMs: 60 * 1000,
+        persistenceKey: "mvx_stops",
+    },
+    subPlaces: {
+        maxItems: 200,
+        ttlMs: 15 * 60 * 1000,
+        persistenceKey: "mvx_subplaces",
+    },
+};
+/**
+ * Merges user config with defaults for a specific cache type
+ * @param cacheType - The type of cache
+ * @param userConfig - Optional user-provided configuration
+ * @returns Complete cache configuration
+ */
+export function getCacheConfig(cacheType, userConfig) {
+    const defaultConfig = DEFAULT_CACHE_CONFIGS[cacheType];
+    return Object.assign(Object.assign({}, defaultConfig), userConfig);
+}
+//# sourceMappingURL=cacheConfig.js.map

package/dist/es/infrastructure/cache/cacheConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheConfig.js","sourceRoot":"","sources":["../../../../src/infrastructure/cache/cacheConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0CH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAA;AAExD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAmC;IACnE,MAAM,EAAE;QACN,QAAQ,EAAE,GAAG;QACb,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACrB,cAAc,EAAE,YAAY;KAC7B;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,GAAG;QACb,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;QACpB,cAAc,EAAE,YAAY;KAC7B;IACD,gBAAgB,EAAE;QAChB,QAAQ,EAAE,GAAG;QACb,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;QACpB,cAAc,EAAE,uBAAuB;KACxC;IACD,cAAc,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACrB,cAAc,EAAE,oBAAoB;KACrC;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACrB,cAAc,EAAE,gBAAgB;KACjC;IACD,QAAQ,EAAE;QACR,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE,GAAG,IAAI;QAChB,cAAc,EAAE,cAAc;KAC/B;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,GAAG;QACb,KAAK,EAAE,EAAE,GAAG,IAAI;QAChB,cAAc,EAAE,WAAW;KAC5B;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,GAAG;QACb,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACrB,cAAc,EAAE,eAAe;KAChC;CACF,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAoB,EACpB,UAAiC;IAEjC,MAAM,aAAa,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAA;IACtD,uCACK,aAAa,GACb,UAAU,EACd;AACH,CAAC"}

package/dist/es/infrastructure/http/FetchHttpClient.d.ts

@@ -0,0 +1,41 @@
+import type { IHttpClient, HttpResponse, HttpRequestOptions } from "../../domain/ports/IHttpClient";
+/**
+ * HTTP Client implementation using the Fetch API
+ *
+ * Implements the IHttpClient interface providing HTTP operations
+ * with consistent response handling and JSON serialization.
+ *
+ * @group Utils
+ *
+ * @example
+ * ```typescript
+ * const client = new FetchHttpClient()
+ * const response = await client.get<User>('https://api.example.com/users/1')
+ * if (response.ok) {
+ *   console.log(response.data.name)
+ * }
+ * ```
+ */
+export declare class FetchHttpClient implements IHttpClient {
+    /**
+     * Performs a GET request
+     */
+    get<T = unknown>(url: string, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Performs a POST request
+     */
+    post<T = unknown>(url: string, body: unknown, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Performs a PUT request
+     */
+    put<T = unknown>(url: string, body: unknown, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Performs a DELETE request
+     */
+    delete<T = unknown>(url: string, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Internal request method that handles all HTTP methods
+     */
+    private request;
+}
+//# sourceMappingURL=FetchHttpClient.d.ts.map

package/dist/es/infrastructure/http/FetchHttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchHttpClient.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/http/FetchHttpClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAEnG;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAI3F;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAI3B;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAI3B;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAI9F;;OAEG;YACW,OAAO;CAqCtB"}

package/dist/es/infrastructure/http/FetchHttpClient.js

@@ -0,0 +1,71 @@
+/**
+ * HTTP Client implementation using the Fetch API
+ *
+ * Implements the IHttpClient interface providing HTTP operations
+ * with consistent response handling and JSON serialization.
+ *
+ * @group Utils
+ *
+ * @example
+ * ```typescript
+ * const client = new FetchHttpClient()
+ * const response = await client.get<User>('https://api.example.com/users/1')
+ * if (response.ok) {
+ *   console.log(response.data.name)
+ * }
+ * ```
+ */
+export class FetchHttpClient {
+    /**
+     * Performs a GET request
+     */
+    async get(url, options) {
+        return this.request(url, "GET", undefined, options);
+    }
+    /**
+     * Performs a POST request
+     */
+    async post(url, body, options) {
+        return this.request(url, "POST", body, options);
+    }
+    /**
+     * Performs a PUT request
+     */
+    async put(url, body, options) {
+        return this.request(url, "PUT", body, options);
+    }
+    /**
+     * Performs a DELETE request
+     */
+    async delete(url, options) {
+        return this.request(url, "DELETE", undefined, options);
+    }
+    /**
+     * Internal request method that handles all HTTP methods
+     */
+    async request(url, method, body, options) {
+        const headers = Object.assign({}, options === null || options === void 0 ? void 0 : options.headers);
+        // Add Content-Type for requests with body
+        if (body !== undefined && !headers["Content-Type"]) {
+            headers["Content-Type"] = "application/json";
+        }
+        const fetchOptions = {
+            method,
+            headers,
+        };
+        // Add body for POST/PUT requests
+        if (body !== undefined) {
+            fetchOptions.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, fetchOptions);
+        // Parse JSON response
+        const data = await response.json();
+        return {
+            ok: response.ok,
+            status: response.status,
+            statusText: response.statusText,
+            data: data,
+        };
+    }
+}
+//# sourceMappingURL=FetchHttpClient.js.map

package/dist/es/infrastructure/http/FetchHttpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchHttpClient.js","sourceRoot":"","sources":["../../../../src/infrastructure/http/FetchHttpClient.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,eAAe;IAC1B;;OAEG;IACH,KAAK,CAAC,GAAG,CAAc,GAAW,EAAE,OAA4B;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CACR,GAAW,EACX,IAAa,EACb,OAA4B;QAE5B,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CACP,GAAW,EACX,IAAa,EACb,OAA4B;QAE5B,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACnD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAc,GAAW,EAAE,OAA4B;QACjE,OAAO,IAAI,CAAC,OAAO,CAAI,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IAC3D,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,OAAO,CACnB,GAAW,EACX,MAAc,EACd,IAAc,EACd,OAA4B;QAE5B,MAAM,OAAO,qBACR,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,CACpB,CAAA;QAED,0CAA0C;QAC1C,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;YAClD,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAA;SAC7C;QAED,MAAM,YAAY,GAAgB;YAChC,MAAM;YACN,OAAO;SACR,CAAA;QAED,iCAAiC;QACjC,IAAI,IAAI,KAAK,SAAS,EAAE;YACtB,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;SACzC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;QAE/C,sBAAsB;QACtB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAElC,OAAO;YACL,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,IAAI,EAAE,IAAS;SAChB,CAAA;IACH,CAAC;CACF"}

package/dist/es/infrastructure/logging/CountlyLogger.d.ts

@@ -0,0 +1,47 @@
+import type { ILogger } from "../../domain/ports/ILogger";
+/**
+ * Countly Logger Adapter
+ *
+ * Implements ILogger interface by wrapping the existing Logger singleton.
+ * This adapter bridges the new hexagonal architecture with the existing
+ * Countly/Rollbar logging implementation.
+ *
+ * @group Utils
+ *
+ * @example
+ * ```typescript
+ * const logger: ILogger = new CountlyLogger()
+ * logger.logEvent("user_action", { action: "click" })
+ * logger.logError(new Error("Something failed"))
+ * ```
+ */
+export declare class CountlyLogger implements ILogger {
+    private readonly logger;
+    private token?;
+    constructor();
+    /**
+     * Logs an analytics event to Countly
+     */
+    logEvent(eventName: string, segmentation?: Record<string, string>): void;
+    /**
+     * Logs an error to Rollbar
+     */
+    logError(error: unknown, context?: Record<string, string>): void;
+    /**
+     * Logs a warning
+     */
+    logWarning(error: unknown, context?: Record<string, string>): void;
+    /**
+     * Logs debug information (only in debug mode)
+     */
+    logDebug(...args: unknown[]): void;
+    /**
+     * Sets the API token for enriching event segmentation
+     */
+    setToken(token: string): void;
+    /**
+     * Enriches segmentation with token if available
+     */
+    private enrichSegmentation;
+}
+//# sourceMappingURL=CountlyLogger.d.ts.map

package/dist/es/infrastructure/logging/CountlyLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CountlyLogger.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/logging/CountlyLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAGzD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,KAAK,CAAC,CAAQ;;IAMtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAKxE;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAQhE;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAQlE;;OAEG;IACH,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIlC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAY3B"}

package/dist/es/infrastructure/logging/CountlyLogger.js

@@ -0,0 +1,74 @@
+import { Logger } from "../../logger/logger";
+/**
+ * Countly Logger Adapter
+ *
+ * Implements ILogger interface by wrapping the existing Logger singleton.
+ * This adapter bridges the new hexagonal architecture with the existing
+ * Countly/Rollbar logging implementation.
+ *
+ * @group Utils
+ *
+ * @example
+ * ```typescript
+ * const logger: ILogger = new CountlyLogger()
+ * logger.logEvent("user_action", { action: "click" })
+ * logger.logError(new Error("Something failed"))
+ * ```
+ */
+export class CountlyLogger {
+    constructor() {
+        this.logger = Logger.getInstance();
+    }
+    /**
+     * Logs an analytics event to Countly
+     */
+    logEvent(eventName, segmentation) {
+        const enrichedSegmentation = this.enrichSegmentation(segmentation);
+        this.logger.logEvent(eventName, enrichedSegmentation);
+    }
+    /**
+     * Logs an error to Rollbar
+     */
+    logError(error, context) {
+        if (error instanceof Error) {
+            this.logger.logError(error, context);
+        }
+        else {
+            this.logger.logError(String(error), context);
+        }
+    }
+    /**
+     * Logs a warning
+     */
+    logWarning(error, context) {
+        if (error instanceof Error) {
+            this.logger.logWarning(error, context);
+        }
+        else {
+            this.logger.logWarning(String(error), context);
+        }
+    }
+    /**
+     * Logs debug information (only in debug mode)
+     */
+    logDebug(...args) {
+        this.logger.debugLog(...args);
+    }
+    /**
+     * Sets the API token for enriching event segmentation
+     */
+    setToken(token) {
+        this.token = token;
+    }
+    /**
+     * Enriches segmentation with token if available
+     */
+    enrichSegmentation(segmentation) {
+        const base = segmentation !== null && segmentation !== void 0 ? segmentation : {};
+        if (this.token) {
+            return Object.assign(Object.assign({}, base), { token: this.token });
+        }
+        return base;
+    }
+}
+//# sourceMappingURL=CountlyLogger.js.map

package/dist/es/infrastructure/logging/CountlyLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CountlyLogger.js","sourceRoot":"","sources":["../../../../src/infrastructure/logging/CountlyLogger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,aAAa;IAIxB;QACE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;IACpC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAiB,EAAE,YAAqC;QAC/D,MAAM,oBAAoB,GAAG,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAA;QAClE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAA;IACvD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAc,EAAE,OAAgC;QACvD,IAAI,KAAK,YAAY,KAAK,EAAE;YAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;SACrC;aAAM;YACL,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAA;SAC7C;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAc,EAAE,OAAgC;QACzD,IAAI,KAAK,YAAY,KAAK,EAAE;YAC1B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;SACvC;aAAM;YACL,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAA;SAC/C;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,GAAG,IAAe;QACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,YAAqC;QAC9D,MAAM,IAAI,GAAG,YAAY,aAAZ,YAAY,cAAZ,YAAY,GAAI,EAAE,CAAA;QAE/B,IAAI,IAAI,CAAC,KAAK,EAAE;YACd,uCACK,IAAI,KACP,KAAK,EAAE,IAAI,CAAC,KAAK,IAClB;SACF;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/es/interfaces/cache.d.ts

@@ -0,0 +1,5 @@
+export interface DataSnapshot<T> {
+    timestamp: number;
+    data: T;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/es/interfaces/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/interfaces/cache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,CAAC,CAAA;CACR"}

package/dist/es/interfaces/cache.js

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

package/dist/es/interfaces/cache.js.map

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

package/dist/es/interfaces/healthResponse.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Represents the health response from the device to the API.
+ * @group Others
+ */
+export interface HealthResponse {
+    id: string;
+    placeId: string;
+    totemId: string;
+    apiKey: string;
+    timestamp: number;
+    status: boolean;
+    ipAddress: string;
+    userAgent: string;
+    host: string;
+    referer: string;
+}
+//# sourceMappingURL=healthResponse.d.ts.map

package/dist/es/interfaces/healthResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthResponse.d.ts","sourceRoot":"","sources":["../../../src/interfaces/healthResponse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB"}

package/dist/es/interfaces/healthResponse.js

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

package/dist/es/interfaces/healthResponse.js.map

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

package/dist/es/interfaces/institutionResponse.d.ts

@@ -0,0 +1,12 @@
+import { type PropertyResponse } from "../domain/models/property";
+export interface InstitutionResponse {
+    id: string;
+    title: string;
+    category: string;
+    description?: string;
+    hasPlaces: boolean;
+    icon?: string;
+    country: string;
+    properties?: PropertyResponse[];
+}
+//# sourceMappingURL=institutionResponse.d.ts.map