@zurigo/maps 1.0.0 → 1.0.1

package/dist/lib/google-maps/error-handler.d.ts

@@ -0,0 +1,30 @@
+export interface MapError {
+    type: 'MAPS_LOAD_ERROR' | 'GEOCODING_ERROR' | 'API_KEY_ERROR' | 'NETWORK_ERROR' | 'RATE_LIMIT_ERROR' | 'UNKNOWN_ERROR';
+    message: string;
+    code?: string;
+    details?: any;
+    retryable: boolean;
+    userMessage: string;
+}
+export declare class GoogleMapsErrorHandler {
+    private static errorMap;
+    static handleError(error: any): MapError;
+    private static isGeocodingError;
+    static getRetryDelay(attemptNumber: number): number;
+    static shouldRetry(error: MapError, attemptNumber: number, maxRetries?: number): boolean;
+    static formatErrorForLogging(error: MapError): Record<string, any>;
+}
+export declare class RetryableGeocodingService {
+    private maxRetries;
+    private baseDelay;
+    constructor(maxRetries?: number, baseDelay?: number);
+    executeWithRetry<T>(operation: () => Promise<T>, onRetry?: (error: MapError, attempt: number) => void): Promise<T>;
+}
+export declare const withErrorHandling: <T extends any[], R>(fn: (...args: T) => Promise<R>, options?: {
+    maxRetries?: number;
+    onError?: (error: MapError) => void;
+    onRetry?: (error: MapError, attempt: number) => void;
+}) => (...args: T) => Promise<R>;
+export declare const isRetryableError: (error: any) => boolean;
+export declare const getErrorUserMessage: (error: any) => string;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/lib/google-maps/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/lib/google-maps/error-handler.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,IAAI,EACA,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,eAAe,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,GAAG,CAAA;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAwEtB;IAED,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,QAAQ;IAmFxC,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAQ/B,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAKnD,MAAM,CAAC,WAAW,CAChB,KAAK,EAAE,QAAQ,EACf,aAAa,EAAE,MAAM,EACrB,UAAU,GAAE,MAAU,GACrB,OAAO;IAIV,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAgBnE;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,SAAS,CAAQ;gBAEb,UAAU,GAAE,MAAU,EAAE,SAAS,GAAE,MAAa;IAKtD,gBAAgB,CAAC,CAAC,EACtB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GACnD,OAAO,CAAC,CAAC,CAAC;CAqCd;AAGD,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,EAClD,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,UAAS;IACP,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAChD,MAIQ,GAAG,MAAM,CAAC,KAAG,OAAO,CAAC,CAAC,CAYrC,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,OAAO,GAAG,KAAG,OAG7C,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,OAAO,GAAG,KAAG,MAGhD,CAAA"}

package/dist/lib/google-maps/error-handler.js

@@ -0,0 +1,224 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getErrorUserMessage = exports.isRetryableError = exports.withErrorHandling = exports.RetryableGeocodingService = exports.GoogleMapsErrorHandler = void 0;
+class GoogleMapsErrorHandler {
+    static handleError(error) {
+        // Handle Google Maps API errors
+        if (typeof error === 'string' && this.errorMap[error]) {
+            return Object.assign({ type: 'UNKNOWN_ERROR', message: error, retryable: false, userMessage: '发生未知错误' }, this.errorMap[error]);
+        }
+        // Handle Error objects
+        if (error instanceof Error) {
+            const errorName = error.name || error.constructor.name;
+            const errorMessage = error.message || 'Unknown error';
+            // Check if it's a known error type
+            if (this.errorMap[errorName]) {
+                return Object.assign(Object.assign({ type: 'UNKNOWN_ERROR', message: errorMessage, retryable: false, userMessage: '发生未知错误' }, this.errorMap[errorName]), { details: error });
+            }
+            // Check message for common patterns
+            if (errorMessage.includes('API key')) {
+                return {
+                    type: 'API_KEY_ERROR',
+                    message: errorMessage,
+                    userMessage: 'API密钥配置问题',
+                    retryable: false,
+                    details: error,
+                };
+            }
+            if (errorMessage.includes('network') || errorMessage.includes('fetch')) {
+                return {
+                    type: 'NETWORK_ERROR',
+                    message: errorMessage,
+                    userMessage: '网络连接问题，请重试',
+                    retryable: true,
+                    details: error,
+                };
+            }
+            if (errorMessage.includes('quota') || errorMessage.includes('limit')) {
+                return {
+                    type: 'RATE_LIMIT_ERROR',
+                    message: errorMessage,
+                    userMessage: '请求频率过高，请稍后重试',
+                    retryable: true,
+                    details: error,
+                };
+            }
+        }
+        // Handle GeocodingError
+        if (this.isGeocodingError(error)) {
+            return {
+                type: 'GEOCODING_ERROR',
+                message: error.message,
+                code: error.code,
+                userMessage: error.message, // GeocodingError already has Chinese messages
+                retryable: error.code === 'OVER_QUERY_LIMIT',
+                details: error,
+            };
+        }
+        // Default unknown error
+        return {
+            type: 'UNKNOWN_ERROR',
+            message: typeof error === 'string' ? error : 'Unknown error occurred',
+            userMessage: '发生未知错误，请重试',
+            retryable: false,
+            details: error,
+        };
+    }
+    static isGeocodingError(error) {
+        return (error &&
+            typeof error.code === 'string' &&
+            typeof error.status !== 'undefined');
+    }
+    static getRetryDelay(attemptNumber) {
+        // Exponential backoff: 1s, 2s, 4s, 8s, 16s
+        return Math.min(1000 * Math.pow(2, attemptNumber), 16000);
+    }
+    static shouldRetry(error, attemptNumber, maxRetries = 3) {
+        return error.retryable && attemptNumber < maxRetries;
+    }
+    static formatErrorForLogging(error) {
+        return {
+            type: error.type,
+            message: error.message,
+            code: error.code,
+            retryable: error.retryable,
+            timestamp: new Date().toISOString(),
+            details: error.details
+                ? {
+                    name: error.details.name,
+                    message: error.details.message,
+                    stack: error.details.stack,
+                }
+                : undefined,
+        };
+    }
+}
+exports.GoogleMapsErrorHandler = GoogleMapsErrorHandler;
+GoogleMapsErrorHandler.errorMap = {
+    // Google Maps loading errors
+    InvalidKeyMapError: {
+        type: 'API_KEY_ERROR',
+        message: 'Google Maps API key is invalid',
+        userMessage: 'API密钥配置错误，请联系系统管理员',
+        retryable: false,
+    },
+    RefererNotAllowedMapError: {
+        type: 'API_KEY_ERROR',
+        message: 'Current domain is not authorized for this API key',
+        userMessage: '当前域名未授权使用此API密钥',
+        retryable: false,
+    },
+    ProjectDeniedMapError: {
+        type: 'API_KEY_ERROR',
+        message: 'Project denied access to Google Maps API',
+        userMessage: '项目无权访问Google Maps API',
+        retryable: false,
+    },
+    BillingNotEnabledMapError: {
+        type: 'API_KEY_ERROR',
+        message: 'Billing must be enabled on the Google Cloud Project',
+        userMessage: '需要启用Google Cloud项目的账单功能',
+        retryable: false,
+    },
+    ApiNotActivatedMapError: {
+        type: 'API_KEY_ERROR',
+        message: 'Google Maps API is not activated',
+        userMessage: 'Google Maps API未激活',
+        retryable: false,
+    },
+    // Network and loading errors
+    NetworkError: {
+        type: 'NETWORK_ERROR',
+        message: 'Network connection failed',
+        userMessage: '网络连接失败，请检查网络连接',
+        retryable: true,
+    },
+    TimeoutError: {
+        type: 'NETWORK_ERROR',
+        message: 'Request timed out',
+        userMessage: '请求超时，请重试',
+        retryable: true,
+    },
+    // Geocoding specific errors
+    ZERO_RESULTS: {
+        type: 'GEOCODING_ERROR',
+        message: 'No results found',
+        userMessage: '未找到匹配的地址，请尝试更详细的地址',
+        retryable: false,
+    },
+    OVER_QUERY_LIMIT: {
+        type: 'RATE_LIMIT_ERROR',
+        message: 'Query limit exceeded',
+        userMessage: '查询次数超过限制，请稍后重试',
+        retryable: true,
+    },
+    REQUEST_DENIED: {
+        type: 'API_KEY_ERROR',
+        message: 'Request denied',
+        userMessage: '请求被拒绝，请检查API配置',
+        retryable: false,
+    },
+    INVALID_REQUEST: {
+        type: 'GEOCODING_ERROR',
+        message: 'Invalid request',
+        userMessage: '请求格式无效，请检查输入',
+        retryable: false,
+    },
+};
+class RetryableGeocodingService {
+    constructor(maxRetries = 3, baseDelay = 1000) {
+        this.maxRetries = maxRetries;
+        this.baseDelay = baseDelay;
+    }
+    async executeWithRetry(operation, onRetry) {
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                const mappedError = GoogleMapsErrorHandler.handleError(error);
+                lastError = mappedError;
+                // Log error for debugging
+                console.error('Operation failed:', GoogleMapsErrorHandler.formatErrorForLogging(mappedError));
+                if (!GoogleMapsErrorHandler.shouldRetry(mappedError, attempt, this.maxRetries)) {
+                    throw mappedError;
+                }
+                if (attempt < this.maxRetries) {
+                    const delay = GoogleMapsErrorHandler.getRetryDelay(attempt);
+                    onRetry === null || onRetry === void 0 ? void 0 : onRetry(mappedError, attempt + 1);
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                }
+            }
+        }
+        throw lastError || new Error('Maximum retries exceeded');
+    }
+}
+exports.RetryableGeocodingService = RetryableGeocodingService;
+// Utility functions for common error handling patterns
+const withErrorHandling = (fn, options = {}) => {
+    const retryService = new RetryableGeocodingService(options.maxRetries);
+    return async (...args) => {
+        var _a;
+        try {
+            return await retryService.executeWithRetry(() => fn(...args), options.onRetry);
+        }
+        catch (error) {
+            const mappedError = GoogleMapsErrorHandler.handleError(error);
+            (_a = options.onError) === null || _a === void 0 ? void 0 : _a.call(options, mappedError);
+            throw mappedError;
+        }
+    };
+};
+exports.withErrorHandling = withErrorHandling;
+const isRetryableError = (error) => {
+    const mappedError = GoogleMapsErrorHandler.handleError(error);
+    return mappedError.retryable;
+};
+exports.isRetryableError = isRetryableError;
+const getErrorUserMessage = (error) => {
+    const mappedError = GoogleMapsErrorHandler.handleError(error);
+    return mappedError.userMessage;
+};
+exports.getErrorUserMessage = getErrorUserMessage;
+//# sourceMappingURL=error-handler.js.map

package/dist/lib/google-maps/error-handler.js.map

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

package/dist/lib/google-maps/geocoding-service.d.ts

@@ -0,0 +1,47 @@
+import type { GeocodeResult } from './types';
+interface BatchGeocodeRequest {
+    addresses: string[];
+    onProgress?: (completed: number, total: number) => void;
+    maxConcurrent?: number;
+}
+interface BatchGeocodeResult {
+    successful: Array<{
+        address: string;
+        result: GeocodeResult;
+    }>;
+    failed: Array<{
+        address: string;
+        error: string;
+    }>;
+}
+export declare class GeocodingService {
+    private geocoder;
+    private cache;
+    private readonly cacheTTL;
+    constructor();
+    private ensureGeocoder;
+    private generateCacheKey;
+    private getCachedResult;
+    private setCachedResult;
+    private convertGeocoderError;
+    geocodeAddress(address: string, options?: {
+        useCache?: boolean;
+        region?: string;
+        language?: string;
+    }): Promise<GeocodeResult[]>;
+    reverseGeocode(lat: number, lng: number, options?: {
+        useCache?: boolean;
+        language?: string;
+    }): Promise<GeocodeResult[]>;
+    batchGeocode({ addresses, onProgress, maxConcurrent, }: BatchGeocodeRequest): Promise<BatchGeocodeResult>;
+    clearCache(): void;
+    getCacheSize(): number;
+    getCacheStats(): {
+        size: number;
+        hits: number;
+        misses: number;
+    };
+}
+export declare const geocodingService: GeocodingService;
+export {};
+//# sourceMappingURL=geocoding-service.d.ts.map

package/dist/lib/google-maps/geocoding-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geocoding-service.d.ts","sourceRoot":"","sources":["../../../src/lib/google-maps/geocoding-service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,SAAS,CAAA;AAE5D,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,UAAU,kBAAkB;IAC1B,UAAU,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,CAAA;IAC7D,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD;AAQD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;;IAQ/C,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,oBAAoB;IA6CtB,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAA;KACb,GACL,OAAO,CAAC,aAAa,EAAE,CAAC;IA0DrB,cAAc,CAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;KACb,GACL,OAAO,CAAC,aAAa,EAAE,CAAC;IAoDrB,YAAY,CAAC,EACjB,SAAS,EACT,UAAU,EACV,aAAiB,GAClB,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoCpD,UAAU,IAAI,IAAI;IAIlB,YAAY,IAAI,MAAM;IAItB,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAShE;AAGD,eAAO,MAAM,gBAAgB,kBAAyB,CAAA"}

package/dist/lib/google-maps/geocoding-service.js

@@ -0,0 +1,224 @@
+"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.geocodingService = exports.GeocodingService = void 0;
+const config_1 = require("./config");
+const utils_1 = require("./utils");
+class GeocodingService {
+    constructor() {
+        var _a;
+        this.geocoder = null;
+        this.cache = new Map();
+        this.cacheTTL = 24 * 60 * 60 * 1000; // 24 hours in milliseconds
+        if (typeof window !== 'undefined' && ((_a = window.google) === null || _a === void 0 ? void 0 : _a.maps)) {
+            this.geocoder = new google.maps.Geocoder();
+        }
+    }
+    ensureGeocoder() {
+        var _a;
+        if (!this.geocoder && ((_a = window.google) === null || _a === void 0 ? void 0 : _a.maps)) {
+            this.geocoder = new google.maps.Geocoder();
+        }
+        if (!this.geocoder) {
+            throw new Error('Google Maps Geocoder not available');
+        }
+        return this.geocoder;
+    }
+    generateCacheKey(address) {
+        return `geocode:${address.trim().toLowerCase()}`;
+    }
+    getCachedResult(address) {
+        const cacheKey = this.generateCacheKey(address);
+        const cached = this.cache.get(cacheKey);
+        if (!cached)
+            return null;
+        const now = Date.now();
+        if (now - cached.timestamp > cached.ttl) {
+            this.cache.delete(cacheKey);
+            return null;
+        }
+        return cached.result;
+    }
+    setCachedResult(address, result) {
+        const cacheKey = this.generateCacheKey(address);
+        this.cache.set(cacheKey, {
+            result,
+            timestamp: Date.now(),
+            ttl: this.cacheTTL,
+        });
+    }
+    convertGeocoderError(status) {
+        const errorMap = {
+            [google.maps.GeocoderStatus.ZERO_RESULTS]: {
+                code: 'ZERO_RESULTS',
+                message: '未找到匹配的地址结果',
+            },
+            [google.maps.GeocoderStatus.OVER_QUERY_LIMIT]: {
+                code: 'OVER_QUERY_LIMIT',
+                message: '查询次数超过限制，请稍后重试',
+            },
+            [google.maps.GeocoderStatus.REQUEST_DENIED]: {
+                code: 'REQUEST_DENIED',
+                message: '请求被拒绝，请检查API密钥配置',
+            },
+            [google.maps.GeocoderStatus.INVALID_REQUEST]: {
+                code: 'INVALID_REQUEST',
+                message: '请求格式无效',
+            },
+            [google.maps.GeocoderStatus.UNKNOWN_ERROR]: {
+                code: 'UNKNOWN_ERROR',
+                message: '发生未知错误，请重试',
+            },
+            [google.maps.GeocoderStatus.ERROR]: {
+                code: 'UNKNOWN_ERROR',
+                message: '服务器错误，请重试',
+            },
+            [google.maps.GeocoderStatus.OK]: {
+                code: 'UNKNOWN_ERROR',
+                message: '成功',
+            },
+        };
+        const error = errorMap[status] || errorMap[google.maps.GeocoderStatus.UNKNOWN_ERROR];
+        return Object.assign(Object.assign({}, error), { status });
+    }
+    async geocodeAddress(address, options = {}) {
+        if (!(0, config_1.validateApiKey)()) {
+            throw new Error('Google Maps API key is not configured');
+        }
+        if (!address || !address.trim()) {
+            throw new Error('Address is required for geocoding');
+        }
+        const { useCache = true, region = 'cn', language = 'en' } = options;
+        // Check cache first
+        if (useCache) {
+            const cached = this.getCachedResult(address);
+            if (cached) {
+                return [cached];
+            }
+        }
+        const geocoder = this.ensureGeocoder();
+        try {
+            const response = await geocoder.geocode({
+                address: address.trim(),
+                region,
+                language,
+            });
+            if (response.results.length === 0) {
+                throw this.convertGeocoderError(google.maps.GeocoderStatus.ZERO_RESULTS);
+            }
+            // Filter results to China mainland if specified
+            const filteredResults = response.results.filter((result) => {
+                const location = result.geometry.location;
+                return (0, utils_1.isWithinChinaBounds)(location.lat(), location.lng());
+            });
+            if (filteredResults.length === 0) {
+                throw new Error('No results found within China mainland bounds');
+            }
+            const geocodeResults = filteredResults.map(utils_1.parseGoogleGeocoderResult);
+            // Cache the first result
+            if (useCache && geocodeResults.length > 0) {
+                this.setCachedResult(address, geocodeResults[0]);
+            }
+            return geocodeResults;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw this.convertGeocoderError(google.maps.GeocoderStatus.UNKNOWN_ERROR);
+        }
+    }
+    async reverseGeocode(lat, lng, options = {}) {
+        if (!(0, config_1.validateApiKey)()) {
+            throw new Error('Google Maps API key is not configured');
+        }
+        if (!(0, utils_1.isWithinChinaBounds)(lat, lng)) {
+            throw new Error('Coordinates are outside China mainland bounds');
+        }
+        const { useCache = true, language = 'en' } = options;
+        const cacheKey = `reverse:${lat.toFixed(6)},${lng.toFixed(6)}`;
+        // Check cache first
+        if (useCache) {
+            const cached = this.cache.get(cacheKey);
+            if (cached && Date.now() - cached.timestamp <= cached.ttl) {
+                return [cached.result];
+            }
+        }
+        const geocoder = this.ensureGeocoder();
+        try {
+            const response = await geocoder.geocode({
+                location: { lat, lng },
+                language,
+            });
+            if (response.results.length === 0) {
+                throw this.convertGeocoderError(google.maps.GeocoderStatus.ZERO_RESULTS);
+            }
+            const geocodeResults = response.results.map(utils_1.parseGoogleGeocoderResult);
+            // Cache the first result
+            if (useCache && geocodeResults.length > 0) {
+                this.cache.set(cacheKey, {
+                    result: geocodeResults[0],
+                    timestamp: Date.now(),
+                    ttl: this.cacheTTL,
+                });
+            }
+            return geocodeResults;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw this.convertGeocoderError(google.maps.GeocoderStatus.UNKNOWN_ERROR);
+        }
+    }
+    async batchGeocode({ addresses, onProgress, maxConcurrent = 5, }) {
+        const successful = [];
+        const failed = [];
+        const processAddress = async (address) => {
+            try {
+                const results = await this.geocodeAddress(address);
+                if (results.length > 0) {
+                    successful.push({ address, result: results[0] });
+                }
+                else {
+                    failed.push({ address, error: 'No results found' });
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                failed.push({ address, error: errorMessage });
+            }
+        };
+        // Process addresses in batches
+        const batches = [];
+        for (let i = 0; i < addresses.length; i += maxConcurrent) {
+            batches.push(addresses.slice(i, i + maxConcurrent));
+        }
+        let completed = 0;
+        for (const batch of batches) {
+            await Promise.all(batch.map(processAddress));
+            completed += batch.length;
+            onProgress === null || onProgress === void 0 ? void 0 : onProgress(completed, addresses.length);
+        }
+        return { successful, failed };
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+    getCacheSize() {
+        return this.cache.size;
+    }
+    getCacheStats() {
+        // This is a simplified version - in a real implementation,
+        // you'd track hits and misses
+        return {
+            size: this.cache.size,
+            hits: 0,
+            misses: 0,
+        };
+    }
+}
+exports.GeocodingService = GeocodingService;
+// Export a singleton instance
+exports.geocodingService = new GeocodingService();
+//# sourceMappingURL=geocoding-service.js.map

package/dist/lib/google-maps/geocoding-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geocoding-service.js","sourceRoot":"","sources":["../../../src/lib/google-maps/geocoding-service.ts"],"names":[],"mappings":";AAAA,YAAY,CAAA;;;AAEZ,qCAA6D;AAC7D,mCAAwE;AAoBxE,MAAa,gBAAgB;IAK3B;;QAJQ,aAAQ,GAAgC,IAAI,CAAA;QAC5C,UAAK,GAAG,IAAI,GAAG,EAA+B,CAAA;QACrC,aAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,2BAA2B;QAGzE,IAAI,OAAO,MAAM,KAAK,WAAW,KAAI,MAAA,MAAM,CAAC,MAAM,0CAAE,IAAI,CAAA,EAAE,CAAC;YACzD,IAAI,CAAC,QAAQ,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;QAC5C,CAAC;IACH,CAAC;IAEO,cAAc;;QACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAI,MAAA,MAAM,CAAC,MAAM,0CAAE,IAAI,CAAA,EAAE,CAAC;YAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;QAC5C,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;QACvD,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAEO,gBAAgB,CAAC,OAAe;QACtC,OAAO,WAAW,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAA;IAClD,CAAC;IAEO,eAAe,CAAC,OAAe;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAEvC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QAExB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;YACxC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YAC3B,OAAO,IAAI,CAAA;QACb,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAA;IACtB,CAAC;IAEO,eAAe,CAAC,OAAe,EAAE,MAAqB;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;QAC/C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;YACvB,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG,EAAE,IAAI,CAAC,QAAQ;SACnB,CAAC,CAAA;IACJ,CAAC;IAEO,oBAAoB,CAC1B,MAAkC;QAElC,MAAM,QAAQ,GAGV;YACF,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE;gBACzC,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,YAAY;aACtB;YACD,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,EAAE;gBAC7C,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,gBAAgB;aAC1B;YACD,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE;gBAC3C,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,kBAAkB;aAC5B;YACD,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE;gBAC5C,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,QAAQ;aAClB;YACD,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE;gBAC1C,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,YAAY;aACtB;YACD,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE;gBAClC,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,WAAW;aACrB;YACD,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE;gBAC/B,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,IAAI;aACd;SACF,CAAA;QAED,MAAM,KAAK,GACT,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAA;QACxE,uCACK,KAAK,KACR,MAAM,IACP;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,OAAe,EACf,UAII,EAAE;QAEN,IAAI,CAAC,IAAA,uBAAc,GAAE,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1D,CAAC;QAED,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QACtD,CAAC;QAED,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;QAEnE,oBAAoB;QACpB,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;YAC5C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,MAAM,CAAC,CAAA;YACjB,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;QAEtC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;gBACtC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;gBACvB,MAAM;gBACN,QAAQ;aACT,CAAC,CAAA;YAEF,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAA;YAC1E,CAAC;YAED,gDAAgD;YAChD,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;gBACzD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAA;gBACzC,OAAO,IAAA,2BAAmB,EAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAA;YAC5D,CAAC,CAAC,CAAA;YAEF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;YAClE,CAAC;YAED,MAAM,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,iCAAyB,CAAC,CAAA;YAErE,yBAAyB;YACzB,IAAI,QAAQ,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;YAClD,CAAC;YAED,OAAO,cAAc,CAAA;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAA;YACb,CAAC;YACD,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAA;QAC3E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,GAAW,EACX,GAAW,EACX,UAGI,EAAE;QAEN,IAAI,CAAC,IAAA,uBAAc,GAAE,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1D,CAAC;QAED,IAAI,CAAC,IAAA,2BAAmB,EAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAClE,CAAC;QAED,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;QACpD,MAAM,QAAQ,GAAG,WAAW,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;QAE9D,oBAAoB;QACpB,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACvC,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;gBAC1D,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACxB,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;QAEtC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;gBACtC,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;gBACtB,QAAQ;aACT,CAAC,CAAA;YAEF,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAA;YAC1E,CAAC;YAED,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAyB,CAAC,CAAA;YAEtE,yBAAyB;YACzB,IAAI,QAAQ,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;oBACvB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;oBACzB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,GAAG,EAAE,IAAI,CAAC,QAAQ;iBACnB,CAAC,CAAA;YACJ,CAAC;YAED,OAAO,cAAc,CAAA;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAA;YACb,CAAC;YACD,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAA;QAC3E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EACjB,SAAS,EACT,UAAU,EACV,aAAa,GAAG,CAAC,GACG;QACpB,MAAM,UAAU,GAAqC,EAAE,CAAA;QACvD,MAAM,MAAM,GAAiC,EAAE,CAAA;QAE/C,MAAM,cAAc,GAAG,KAAK,EAAE,OAAe,EAAiB,EAAE;YAC9D,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;gBAClD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;gBAClD,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAA;gBACrD,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAA;gBAC1D,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAA;YAC/C,CAAC;QACH,CAAC,CAAA;QAED,+BAA+B;QAC/B,MAAM,OAAO,GAAe,EAAE,CAAA;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,aAAa,EAAE,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAA;QACrD,CAAC;QAED,IAAI,SAAS,GAAG,CAAC,CAAA;QAEjB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAA;YAC5C,SAAS,IAAI,KAAK,CAAC,MAAM,CAAA;YACzB,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;QAC3C,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAA;IAC/B,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;IAED,aAAa;QACX,2DAA2D;QAC3D,8BAA8B;QAC9B,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,IAAI,EAAE,CAAC;YACP,MAAM,EAAE,CAAC;SACV,CAAA;IACH,CAAC;CACF;AArRD,4CAqRC;AAED,8BAA8B;AACjB,QAAA,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAA"}

package/dist/lib/google-maps/hooks.d.ts

@@ -0,0 +1,35 @@
+import { Loader } from '@googlemaps/js-api-loader';
+import { type GoogleMapsLibrary } from './config';
+interface UseGoogleMapsOptions {
+    libraries?: GoogleMapsLibrary[];
+    onLoad?: () => void;
+    onError?: (error: Error) => void;
+}
+interface UseGoogleMapsReturn {
+    isLoaded: boolean;
+    isLoading: boolean;
+    error: Error | null;
+    loader: Loader | null;
+}
+export declare const useGoogleMaps: (options?: UseGoogleMapsOptions) => UseGoogleMapsReturn;
+interface UseGoogleMapOptions extends google.maps.MapOptions {
+    onMapLoad?: (map: google.maps.Map) => void;
+    onMapError?: (error: Error) => void;
+}
+export declare const useGoogleMap: (containerRef: React.RefObject<HTMLElement | null>, options?: UseGoogleMapOptions) => {
+    map: google.maps.Map | null;
+    isLoaded: boolean;
+    error: Error | null;
+};
+export declare const useGeocode: () => {
+    geocodeAddress: (address: string, options?: {
+        useCache?: boolean;
+    }) => Promise<google.maps.GeocoderResult[]>;
+    reverseGeocode: (lat: number, lng: number) => Promise<google.maps.GeocoderResult[]>;
+    isGeocoding: boolean;
+    isReady: boolean;
+    error: Error | null;
+    clearError: () => void;
+};
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/lib/google-maps/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/lib/google-maps/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAElD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,UAAU,CAAA;AAYjB,UAAU,oBAAoB;IAC5B,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC/B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACjC;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAoBD,eAAO,MAAM,aAAa,GACxB,UAAS,oBAAyB,KACjC,mBA0EF,CAAA;AAED,UAAU,mBAAoB,SAAQ,MAAM,CAAC,IAAI,CAAC,UAAU;IAC1D,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAA;IAC1C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACpC;AAED,eAAO,MAAM,YAAY,GACvB,cAAc,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACjD,UAAS,mBAAwB;;;;CAkClC,CAAA;AAED,eAAO,MAAM,UAAU;8BAOR,MAAM,YACL;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAC/B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;0BAqC5B,MAAM,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;;;;;CA4C1E,CAAA"}