@memberjunction/geo-core 5.34.1 → 5.35.0

package/dist/providers/GeocodingProviderRegistry.js

@@ -0,0 +1,125 @@
+import { BaseSingleton, MJGlobal } from '@memberjunction/global';
+import { LogError, LogStatus } from '@memberjunction/core';
+import { BaseGeocodingProvider } from './BaseGeocodingProvider.js';
+import { GoogleGeocodingProvider } from './GoogleGeocodingProvider.js';
+import { GeocodioGeocodingProvider } from './GeocodioGeocodingProvider.js';
+import { HereGeocodingProvider } from './HereGeocodingProvider.js';
+/**
+ * Singleton registry of geocoding providers. Resolves the configured provider
+ * by name and gracefully falls back when the requested one isn't configured.
+ *
+ * Built-in providers (Google, Geocod.io, HERE) are auto-registered on first
+ * access. Custom providers can be registered via Register() — they should
+ * extend BaseGeocodingProvider and be decorated with @RegisterClass for the
+ * MJ class factory if you want them resolvable by name across packages.
+ */
+export class GeocodingProviderRegistry extends BaseSingleton {
+    constructor() {
+        super();
+        this.providers = new Map();
+        this.builtInsRegistered = false;
+    }
+    static get Instance() {
+        return GeocodingProviderRegistry.getInstance();
+    }
+    /** Register a provider instance under its Name. */
+    Register(provider) {
+        this.providers.set(provider.Name.toLowerCase(), provider);
+    }
+    /**
+     * Look up a provider by name. Returns null if no provider is registered
+     * under that name or the provider isn't configured (no API key).
+     */
+    Get(name) {
+        this.ensureBuiltInsRegistered();
+        const provider = this.providers.get(name.toLowerCase());
+        if (!provider)
+            return null;
+        if (!provider.IsConfigured())
+            return null;
+        return provider;
+    }
+    /** All registered providers regardless of configuration state. */
+    All() {
+        this.ensureBuiltInsRegistered();
+        return Array.from(this.providers.values());
+    }
+    /** All providers that have credentials configured. */
+    AllConfigured() {
+        return this.All().filter(p => p.IsConfigured());
+    }
+    /**
+     * Resolve the provider to use given an optional explicit name. Resolution order:
+     *
+     * 1. If `requestedName` is supplied → return it if configured; if not, log a
+     *    warning and continue.
+     * 2. The configured default from `__mj_config_apiIntegrations.geocoding.defaultProvider`.
+     * 3. The first configured provider in priority order: geocodio → here → google.
+     *    (Geocod.io first because it has the most generous free tier for US data;
+     *    HERE second for global; Google last because of ToS storage restrictions.)
+     * 4. null if nothing is configured.
+     */
+    Resolve(requestedName) {
+        this.ensureBuiltInsRegistered();
+        if (requestedName) {
+            const explicit = this.Get(requestedName);
+            if (explicit)
+                return explicit;
+            LogStatus(`GeocodingProviderRegistry: requested provider "${requestedName}" is not configured; falling back to default.`);
+        }
+        const configuredDefault = this.readDefaultFromConfig();
+        if (configuredDefault) {
+            const fromConfig = this.Get(configuredDefault);
+            if (fromConfig)
+                return fromConfig;
+            LogError(`GeocodingProviderRegistry: default provider "${configuredDefault}" from config is not configured.`);
+        }
+        for (const name of ['geocodio', 'here', 'google']) {
+            const fallback = this.Get(name);
+            if (fallback)
+                return fallback;
+        }
+        return null;
+    }
+    readDefaultFromConfig() {
+        try {
+            const cfg = globalThis['__mj_config_apiIntegrations'];
+            const geo = cfg?.['geocoding'];
+            const v = geo?.['defaultProvider'];
+            return typeof v === 'string' && v.length > 0 ? v : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Register the three built-in providers on first access. We do this lazily
+     * (rather than at module load) so consumers who only want one provider
+     * don't pay for class instantiation of the others until needed.
+     *
+     * Uses MJGlobal.ClassFactory to honor any @RegisterClass overrides, so
+     * downstream packages can substitute their own implementations.
+     */
+    ensureBuiltInsRegistered() {
+        if (this.builtInsRegistered)
+            return;
+        this.builtInsRegistered = true;
+        const factory = MJGlobal.Instance.ClassFactory;
+        const builtIns = [
+            ['google', GoogleGeocodingProvider],
+            ['geocodio', GeocodioGeocodingProvider],
+            ['here', HereGeocodingProvider]
+        ];
+        for (const [name, ctor] of builtIns) {
+            try {
+                const instance = factory.CreateInstance(BaseGeocodingProvider, name)
+                    ?? new ctor();
+                this.providers.set(name, instance);
+            }
+            catch (e) {
+                LogError(`GeocodingProviderRegistry: failed to instantiate built-in provider "${name}": ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=GeocodingProviderRegistry.js.map

package/dist/providers/GeocodingProviderRegistry.js.map

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

package/dist/providers/GeocodioGeocodingProvider.d.ts

@@ -0,0 +1,17 @@
+import { BaseGeocodingProvider } from './BaseGeocodingProvider.js';
+import { GeocodeRequest, ProviderGeocodeResult, ReverseGeocodeRequest } from './types.js';
+/**
+ * Geocod.io provider. US, Canada, UK, and Australia only — not global.
+ * Free tier: 2,500 lookups/day. Permanent storage permitted by ToS.
+ */
+export declare class GeocodioGeocodingProvider extends BaseGeocodingProvider {
+    readonly Name = "geocodio";
+    readonly SupportedCountries: readonly ["US", "CA", "GB", "AU"];
+    readonly AllowsPersistentStorage = true;
+    IsConfigured(): boolean;
+    Geocode(req: GeocodeRequest): Promise<ProviderGeocodeResult | null>;
+    ReverseGeocode(req: ReverseGeocodeRequest): Promise<ProviderGeocodeResult | null>;
+    private getApiKey;
+    private toResult;
+}
+//# sourceMappingURL=GeocodioGeocodingProvider.d.ts.map

package/dist/providers/GeocodioGeocodingProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeocodioGeocodingProvider.d.ts","sourceRoot":"","sources":["../../src/providers/GeocodioGeocodingProvider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAgCvF;;;GAGG;AACH,qBACa,yBAA0B,SAAQ,qBAAqB;IAChE,SAAgB,IAAI,cAAc;IAClC,SAAgB,kBAAkB,oCAAqC;IACvE,SAAgB,uBAAuB,QAAQ;IAExC,YAAY,IAAI,OAAO;IAIjB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAenE,cAAc,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAS9F,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,QAAQ;CA8CnB"}

package/dist/providers/GeocodioGeocodingProvider.js

@@ -0,0 +1,109 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { LogStatus } from '@memberjunction/core';
+import { BaseGeocodingProvider } from './BaseGeocodingProvider.js';
+/**
+ * Geocod.io provider. US, Canada, UK, and Australia only — not global.
+ * Free tier: 2,500 lookups/day. Permanent storage permitted by ToS.
+ */
+let GeocodioGeocodingProvider = class GeocodioGeocodingProvider extends BaseGeocodingProvider {
+    constructor() {
+        super(...arguments);
+        this.Name = 'geocodio';
+        this.SupportedCountries = ['US', 'CA', 'GB', 'AU'];
+        this.AllowsPersistentStorage = true;
+    }
+    IsConfigured() {
+        return this.getApiKey() != null;
+    }
+    async Geocode(req) {
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            return null;
+        const params = new URLSearchParams({ q: req.AddressString, api_key: apiKey, limit: '1' });
+        if (req.CountryCode)
+            params.set('country', req.CountryCode);
+        const url = `https://api.geocod.io/v1.7/geocode?${params.toString()}`;
+        const data = await this.fetchJson(url);
+        if (!data)
+            return null;
+        if (data.error || !data.results?.length) {
+            if (data.error)
+                LogStatus(`Geocod.io: ${data.error}`);
+            return null;
+        }
+        return this.toResult(data.results[0]);
+    }
+    async ReverseGeocode(req) {
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            return null;
+        const url = `https://api.geocod.io/v1.7/reverse?q=${req.Latitude},${req.Longitude}&api_key=${apiKey}&limit=1`;
+        const data = await this.fetchJson(url);
+        if (!data || !data.results?.length)
+            return null;
+        return this.toResult(data.results[0]);
+    }
+    getApiKey() {
+        return this.resolveCredential(['GEOCODIO_API_KEY'], 'geocodio.apiKey');
+    }
+    toResult(r) {
+        // Geocod.io accuracy_type maps cleanly to our precision enum.
+        // accuracy is already 0.0–1.0.
+        let precision = 'city';
+        switch (r.accuracy_type) {
+            case 'rooftop':
+            case 'point':
+            case 'range_interpolation':
+            case 'nearest_rooftop_match':
+                precision = 'exact';
+                break;
+            case 'street_center':
+            case 'intersection':
+                precision = 'exact';
+                break;
+            case 'place':
+                precision = 'city';
+                break;
+            case 'county':
+                precision = 'county';
+                break;
+            case 'state':
+                precision = 'state_province';
+                break;
+            default:
+                precision = r.address_components.zip ? 'postal_code' : 'city';
+        }
+        const c = r.address_components;
+        const line1 = c.formatted_street
+            ? [c.number, c.formatted_street].filter(Boolean).join(' ')
+            : [c.number, c.predirectional, c.street, c.suffix].filter(Boolean).join(' ');
+        const line2 = c.secondaryunit
+            ? [c.secondaryunit, c.secondarynumber].filter(Boolean).join(' ')
+            : null;
+        return {
+            Latitude: r.location.lat,
+            Longitude: r.location.lng,
+            Precision: precision,
+            Confidence: this.normalizeConfidence(r.accuracy),
+            FormattedAddress: r.formatted_address,
+            CountryCode: c.country ?? null,
+            StateProvinceCode: c.state ?? null,
+            StateProvinceName: c.state ?? null,
+            City: c.city ?? null,
+            PostalCode: c.zip ?? null,
+            Line1: line1 || null,
+            Line2: line2
+        };
+    }
+};
+GeocodioGeocodingProvider = __decorate([
+    RegisterClass(BaseGeocodingProvider, 'geocodio')
+], GeocodioGeocodingProvider);
+export { GeocodioGeocodingProvider };
+//# sourceMappingURL=GeocodioGeocodingProvider.js.map

package/dist/providers/GeocodioGeocodingProvider.js.map

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

package/dist/providers/GoogleGeocodingProvider.d.ts

@@ -0,0 +1,22 @@
+import { BaseGeocodingProvider } from './BaseGeocodingProvider.js';
+import { GeocodeRequest, ProviderGeocodeResult, ReverseGeocodeRequest } from './types.js';
+/**
+ * Google Maps Geocoding API provider.
+ *
+ * Note on persistent storage: Google Maps Platform ToS technically forbid
+ * indefinite storage of geocoding results unless displayed on a Google Map.
+ * We expose `AllowsPersistentStorage = true` for backwards compatibility
+ * (the existing system already persists Google results) but customers with
+ * strict compliance posture should use Geocod.io or HERE as the default.
+ */
+export declare class GoogleGeocodingProvider extends BaseGeocodingProvider {
+    readonly Name = "google";
+    readonly SupportedCountries: "global";
+    readonly AllowsPersistentStorage = true;
+    IsConfigured(): boolean;
+    Geocode(req: GeocodeRequest): Promise<ProviderGeocodeResult | null>;
+    ReverseGeocode(req: ReverseGeocodeRequest): Promise<ProviderGeocodeResult | null>;
+    private getApiKey;
+    private toResult;
+}
+//# sourceMappingURL=GoogleGeocodingProvider.d.ts.map

package/dist/providers/GoogleGeocodingProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleGeocodingProvider.d.ts","sourceRoot":"","sources":["../../src/providers/GoogleGeocodingProvider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAsBvF;;;;;;;;GAQG;AACH,qBACa,uBAAwB,SAAQ,qBAAqB;IAC9D,SAAgB,IAAI,YAAY;IAChC,SAAgB,kBAAkB,EAAG,QAAQ,CAAU;IACvD,SAAgB,uBAAuB,QAAQ;IAExC,YAAY,IAAI,OAAO;IAIjB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAenE,cAAc,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAS9F,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,QAAQ;CAoCnB"}

package/dist/providers/GoogleGeocodingProvider.js

@@ -0,0 +1,110 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { LogStatus } from '@memberjunction/core';
+import { BaseGeocodingProvider } from './BaseGeocodingProvider.js';
+/**
+ * Google Maps Geocoding API provider.
+ *
+ * Note on persistent storage: Google Maps Platform ToS technically forbid
+ * indefinite storage of geocoding results unless displayed on a Google Map.
+ * We expose `AllowsPersistentStorage = true` for backwards compatibility
+ * (the existing system already persists Google results) but customers with
+ * strict compliance posture should use Geocod.io or HERE as the default.
+ */
+let GoogleGeocodingProvider = class GoogleGeocodingProvider extends BaseGeocodingProvider {
+    constructor() {
+        super(...arguments);
+        this.Name = 'google';
+        this.SupportedCountries = 'global';
+        this.AllowsPersistentStorage = true;
+    }
+    IsConfigured() {
+        return this.getApiKey() != null;
+    }
+    async Geocode(req) {
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            return null;
+        const params = new URLSearchParams({ address: req.AddressString, key: apiKey });
+        if (req.CountryCode)
+            params.set('region', req.CountryCode.toLowerCase());
+        const url = `https://maps.googleapis.com/maps/api/geocode/json?${params.toString()}`;
+        const data = await this.fetchJson(url);
+        if (!data)
+            return null;
+        if (data.status !== 'OK' || !data.results?.length) {
+            LogStatus(`Google geocoder returned status "${data.status}" for "${req.AddressString}"`);
+            return null;
+        }
+        return this.toResult(data.results[0]);
+    }
+    async ReverseGeocode(req) {
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            return null;
+        const url = `https://maps.googleapis.com/maps/api/geocode/json?latlng=${req.Latitude},${req.Longitude}&key=${apiKey}`;
+        const data = await this.fetchJson(url);
+        if (!data || data.status !== 'OK' || !data.results?.length)
+            return null;
+        return this.toResult(data.results[0]);
+    }
+    getApiKey() {
+        return this.resolveCredential(['GOOGLE_GEOCODING_API_KEY', 'GOOGLE_MAPS_API_KEY'], 'google.geocoding.apiKey');
+    }
+    toResult(r) {
+        const comp = (type, useShort = false) => {
+            const c = r.address_components.find(x => x.types.includes(type));
+            if (!c)
+                return null;
+            return useShort ? c.short_name : c.long_name;
+        };
+        const streetNumber = comp('street_number');
+        const route = comp('route');
+        const line1 = [streetNumber, route].filter(Boolean).join(' ') || null;
+        // Map Google's location_type to our enum + a normalized confidence proxy.
+        let precision = 'city';
+        let confidence = null;
+        switch (r.geometry.location_type) {
+            case 'ROOFTOP':
+                precision = 'exact';
+                confidence = 1.0;
+                break;
+            case 'RANGE_INTERPOLATED':
+                precision = 'exact';
+                confidence = 0.85;
+                break;
+            case 'GEOMETRIC_CENTER':
+                precision = 'city';
+                confidence = 0.5;
+                break;
+            case 'APPROXIMATE':
+                precision = 'state_province';
+                confidence = 0.3;
+                break;
+        }
+        return {
+            Latitude: r.geometry.location.lat,
+            Longitude: r.geometry.location.lng,
+            Precision: precision,
+            Confidence: confidence,
+            FormattedAddress: r.formatted_address,
+            CountryCode: comp('country', true),
+            StateProvinceCode: comp('administrative_area_level_1', true),
+            StateProvinceName: comp('administrative_area_level_1'),
+            City: comp('locality') ?? comp('postal_town'),
+            PostalCode: comp('postal_code'),
+            Line1: line1,
+            Line2: comp('subpremise')
+        };
+    }
+};
+GoogleGeocodingProvider = __decorate([
+    RegisterClass(BaseGeocodingProvider, 'google')
+], GoogleGeocodingProvider);
+export { GoogleGeocodingProvider };
+//# sourceMappingURL=GoogleGeocodingProvider.js.map

package/dist/providers/GoogleGeocodingProvider.js.map

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

package/dist/providers/HereGeocodingProvider.d.ts

@@ -0,0 +1,20 @@
+import { BaseGeocodingProvider } from './BaseGeocodingProvider.js';
+import { GeocodeRequest, ProviderGeocodeResult, ReverseGeocodeRequest } from './types.js';
+/**
+ * HERE Geocoding & Search API provider. Global coverage.
+ * Free tier (Freemium plan): 250k requests/month. Permanent storage permitted.
+ *
+ * Uses /v1/discover for forward geocoding because it accepts free-form input
+ * (better for messy CRM data) and /v1/revgeocode for reverse.
+ */
+export declare class HereGeocodingProvider extends BaseGeocodingProvider {
+    readonly Name = "here";
+    readonly SupportedCountries: "global";
+    readonly AllowsPersistentStorage = true;
+    IsConfigured(): boolean;
+    Geocode(req: GeocodeRequest): Promise<ProviderGeocodeResult | null>;
+    ReverseGeocode(req: ReverseGeocodeRequest): Promise<ProviderGeocodeResult | null>;
+    private getApiKey;
+    private toResult;
+}
+//# sourceMappingURL=HereGeocodingProvider.d.ts.map

package/dist/providers/HereGeocodingProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HereGeocodingProvider.d.ts","sourceRoot":"","sources":["../../src/providers/HereGeocodingProvider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAiCvF;;;;;;GAMG;AACH,qBACa,qBAAsB,SAAQ,qBAAqB;IAC5D,SAAgB,IAAI,UAAU;IAC9B,SAAgB,kBAAkB,EAAG,QAAQ,CAAU;IACvD,SAAgB,uBAAuB,QAAQ;IAExC,YAAY,IAAI,OAAO;IAIjB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAqBnE,cAAc,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAS9F,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,QAAQ;CAsCnB"}

package/dist/providers/HereGeocodingProvider.js

@@ -0,0 +1,107 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { LogStatus } from '@memberjunction/core';
+import { BaseGeocodingProvider } from './BaseGeocodingProvider.js';
+/**
+ * HERE Geocoding & Search API provider. Global coverage.
+ * Free tier (Freemium plan): 250k requests/month. Permanent storage permitted.
+ *
+ * Uses /v1/discover for forward geocoding because it accepts free-form input
+ * (better for messy CRM data) and /v1/revgeocode for reverse.
+ */
+let HereGeocodingProvider = class HereGeocodingProvider extends BaseGeocodingProvider {
+    constructor() {
+        super(...arguments);
+        this.Name = 'here';
+        this.SupportedCountries = 'global';
+        this.AllowsPersistentStorage = true;
+    }
+    IsConfigured() {
+        return this.getApiKey() != null;
+    }
+    async Geocode(req) {
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            return null;
+        // HERE's /discover requires either an `at` (lat,lng bias point) or an `in`
+        // (country/circle/bbox) filter. Use country bias when available, else fall
+        // back to a global circle centered on 0,0 with a huge radius.
+        const params = new URLSearchParams({ q: req.AddressString, limit: '1', apiKey });
+        if (req.CountryCode) {
+            params.set('in', `countryCode:${req.CountryCode.toUpperCase()}`);
+        }
+        else {
+            params.set('at', '0,0');
+        }
+        const url = `https://discover.search.hereapi.com/v1/discover?${params.toString()}`;
+        const data = await this.fetchJson(url);
+        if (!data?.items?.length) {
+            LogStatus(`HERE geocoder returned no results for "${req.AddressString}"`);
+            return null;
+        }
+        return this.toResult(data.items[0]);
+    }
+    async ReverseGeocode(req) {
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            return null;
+        const url = `https://revgeocode.search.hereapi.com/v1/revgeocode?at=${req.Latitude},${req.Longitude}&limit=1&apiKey=${apiKey}`;
+        const data = await this.fetchJson(url);
+        if (!data?.items?.length)
+            return null;
+        return this.toResult(data.items[0]);
+    }
+    getApiKey() {
+        return this.resolveCredential(['HERE_API_KEY', 'HERE_MAPS_API_KEY'], 'here.apiKey');
+    }
+    toResult(item) {
+        let precision = 'city';
+        switch (item.resultType) {
+            case 'houseNumber':
+            case 'place':
+            case 'pointOfInterest':
+                precision = 'exact';
+                break;
+            case 'street':
+                precision = 'exact';
+                break;
+            case 'postalCodePoint':
+                precision = 'postal_code';
+                break;
+            case 'locality':
+            case 'administrativeArea':
+                precision = item.address.city ? 'city' : 'state_province';
+                break;
+            default:
+                precision = 'city';
+        }
+        // HERE's queryScore is already 0.0–1.0.
+        const confidence = this.normalizeConfidence(item.scoring?.queryScore ?? null);
+        const a = item.address;
+        const line1 = [a.houseNumber, a.street].filter(Boolean).join(' ') || null;
+        return {
+            Latitude: item.position.lat,
+            Longitude: item.position.lng,
+            Precision: precision,
+            Confidence: confidence,
+            FormattedAddress: a.label ?? null,
+            CountryCode: a.countryCode ?? null,
+            StateProvinceCode: a.stateCode ?? null,
+            StateProvinceName: a.state ?? null,
+            City: a.city ?? null,
+            PostalCode: a.postalCode ?? null,
+            Line1: line1,
+            Line2: null
+        };
+    }
+};
+HereGeocodingProvider = __decorate([
+    RegisterClass(BaseGeocodingProvider, 'here')
+], HereGeocodingProvider);
+export { HereGeocodingProvider };
+//# sourceMappingURL=HereGeocodingProvider.js.map

package/dist/providers/HereGeocodingProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HereGeocodingProvider.js","sourceRoot":"","sources":["../../src/providers/HereGeocodingProvider.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAkChE;;;;;;GAMG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,qBAAqB;IAAzD;;QACa,SAAI,GAAG,MAAM,CAAC;QACd,uBAAkB,GAAG,QAAiB,CAAC;QACvC,4BAAuB,GAAG,IAAI,CAAC;IA8EnD,CAAC;IA5EU,YAAY;QACf,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC;IACpC,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,GAAmB;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,2EAA2E;QAC3E,2EAA2E;QAC3E,8DAA8D;QAC9D,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACjF,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YAClB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,MAAM,GAAG,GAAG,mDAAmD,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QACnF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAe,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACvB,SAAS,CAAC,0CAA0C,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,GAA0B;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,GAAG,GAAG,0DAA0D,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,SAAS,mBAAmB,MAAM,EAAE,CAAC;QAC/H,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAe,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM;YAAE,OAAO,IAAI,CAAC;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAEO,SAAS;QACb,OAAO,IAAI,CAAC,iBAAiB,CAAC,CAAC,cAAc,EAAE,mBAAmB,CAAC,EAAE,aAAa,CAAC,CAAC;IACxF,CAAC;IAEO,QAAQ,CAAC,IAAc;QAC3B,IAAI,SAAS,GAAqB,MAAM,CAAC;QACzC,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;YACtB,KAAK,aAAa,CAAC;YACnB,KAAK,OAAO,CAAC;YACb,KAAK,iBAAiB;gBAClB,SAAS,GAAG,OAAO,CAAC;gBAAC,MAAM;YAC/B,KAAK,QAAQ;gBACT,SAAS,GAAG,OAAO,CAAC;gBAAC,MAAM;YAC/B,KAAK,iBAAiB;gBAClB,SAAS,GAAG,aAAa,CAAC;gBAAC,MAAM;YACrC,KAAK,UAAU,CAAC;YAChB,KAAK,oBAAoB;gBACrB,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC;gBAAC,MAAM;YACrE;gBACI,SAAS,GAAG,MAAM,CAAC;QAC3B,CAAC;QAED,wCAAwC;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC;QAC9E,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QAE1E,OAAO;YACH,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG;YAC3B,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG;YAC5B,SAAS,EAAE,SAAS;YACpB,UAAU,EAAE,UAAU;YACtB,gBAAgB,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;YACjC,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;YAClC,iBAAiB,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;YACtC,iBAAiB,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;YAClC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;YACpB,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;YAChC,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,IAAI;SACd,CAAC;IACN,CAAC;CACJ,CAAA;AAjFY,qBAAqB;IADjC,aAAa,CAAC,qBAAqB,EAAE,MAAM,CAAC;GAChC,qBAAqB,CAiFjC"}

package/dist/providers/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './BaseGeocodingProvider.js';
+export * from './GoogleGeocodingProvider.js';
+export * from './GeocodioGeocodingProvider.js';
+export * from './HereGeocodingProvider.js';
+export * from './GeocodingProviderRegistry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './BaseGeocodingProvider.js';
+export * from './GoogleGeocodingProvider.js';
+export * from './GeocodioGeocodingProvider.js';
+export * from './HereGeocodingProvider.js';
+export * from './GeocodingProviderRegistry.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC"}