@memberjunction/core-entities 5.23.0 → 5.25.0

package/dist/engines/FileStorageEngine.js.map

@@ -1 +1 @@
-{"version":3,"file":"FileStorageEngine.js","sourceRoot":"","sources":["../../src/engines/FileStorageEngine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FileStorageEngine.js","sourceRoot":"","sources":["../../src/engines/FileStorageEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyD,MAAM,sBAAsB,CAAC;AACzG,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAWpD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,qBAAsB,SAAQ,UAAiC;IAA5E;;QAUY,cAAS,GAAiC,EAAE,CAAC;QAC7C,eAAU,GAAkC,EAAE,CAAC;IAkH3D,CAAC;IA5HG;;;;OAIG;IACI,MAAM,KAAK,QAAQ;QACtB,OAAO,KAAK,CAAC,WAAW,EAAyB,CAAC;IACtD,CAAC;IAKD;;;;;OAKG;IACI,KAAK,CAAC,MAAM,CAAC,YAAsB,EAAE,WAAsB,EAAE,QAA4B;QAC5F,MAAM,OAAO,GAAwC;YACjD;gBACI,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,2BAA2B;gBACvC,YAAY,EAAE,WAAW;gBACzB,UAAU,EAAE,IAAI;aACnB;YACD;gBACI,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,4BAA4B;gBACxC,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,IAAI;aACnB;SACJ,CAAC;QACF,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;IAClE,CAAC;IAED,2CAA2C;IAC3C,0BAA0B;IAC1B,2CAA2C;IAE3C;;OAEG;IACH,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,IAAW,qBAAqB;QAC5B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAuC,CAAC;QACnE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAEtD,OAAO,IAAI,CAAC,QAAQ;aACf,GAAG,CAAC,OAAO,CAAC,EAAE;YACX,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACrD,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAC3B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QACjC,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,IAAI,EAAsC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,2CAA2C;IAC3C,iBAAiB;IACjB,2CAA2C;IAE3C;;;;OAIG;IACI,cAAc,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,UAAkB;QACrC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACI,gBAAgB,CAAC,IAAY;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED;;;;OAIG;IACI,uBAAuB,CAAC,UAAkB;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED;;;;OAIG;IACI,sBAAsB,CAAC,SAAiB;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC;CACJ"}

package/dist/engines/GeoDataEngine.d.ts

@@ -0,0 +1,141 @@
+import { BaseEngine, IMetadataProvider, UserInfo } from "@memberjunction/core";
+import { MJCountryEntity, MJStateProvinceEntity } from "../generated/entity_subclasses.js";
+/**
+ * Result of a point-in-polygon resolution.
+ */
+export interface GeoPointResolution {
+    /** The matched country, if any */
+    Country: MJCountryEntity | undefined;
+    /** The matched state/province, if any */
+    State: MJStateProvinceEntity | undefined;
+}
+/**
+ * GeoDataEngine provides cached, in-memory access to Country and StateProvince
+ * reference data. Loaded once at startup via @RegisterForStartup, all lookups
+ * are O(1) via pre-built Maps keyed by common lookup patterns.
+ *
+ * Usage:
+ * ```typescript
+ * const engine = GeoDataEngine.Instance;
+ * const country = engine.GetCountryByISO2('US');
+ * const state = engine.GetStateByCode('US-country-id', 'CO');
+ * ```
+ */
+export declare class GeoDataEngine extends BaseEngine<GeoDataEngine> {
+    static get Instance(): GeoDataEngine;
+    private _countries;
+    private _stateProvinces;
+    private _countriesByISO2;
+    private _countriesByISO3;
+    private _countriesByName;
+    private _countriesById;
+    private _statesByCountryAndCode;
+    private _statesByCountryAndName;
+    private _statesById;
+    private _countryGeometries;
+    private _stateGeometries;
+    /** Maps countryId → array of state geometries for that country */
+    private _stateGeometriesByCountry;
+    Config(forceRefresh?: boolean, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<void>;
+    protected AdditionalLoading(_contextUser?: UserInfo): Promise<void>;
+    get Countries(): MJCountryEntity[];
+    get StateProvinces(): MJStateProvinceEntity[];
+    GetCountryByISO2(iso2: string): MJCountryEntity | undefined;
+    GetCountryByISO3(iso3: string): MJCountryEntity | undefined;
+    GetCountryByName(name: string): MJCountryEntity | undefined;
+    GetCountryById(id: string): MJCountryEntity | undefined;
+    /**
+     * Resolve a country from a text value that could be a name, ISO2, or ISO3 code.
+     * Tries ISO2 first (most common), then ISO3, then name match.
+     */
+    ResolveCountry(value: string): MJCountryEntity | undefined;
+    /**
+     * Look up a state/province by its Code within a specific country.
+     * @param countryId - The country's UUID
+     * @param code - The state/province code (e.g., "CO", "ON", "NSW")
+     */
+    GetStateByCode(countryId: string, code: string): MJStateProvinceEntity | undefined;
+    /**
+     * Look up a state/province by its Name within a specific country.
+     * @param countryId - The country's UUID
+     * @param name - The state/province name (e.g., "Colorado", "Ontario")
+     */
+    GetStateByName(countryId: string, name: string): MJStateProvinceEntity | undefined;
+    GetStateById(id: string): MJStateProvinceEntity | undefined;
+    /**
+     * Resolve a state/province from a text value within a country.
+     * Tries code first, then name match.
+     */
+    ResolveState(countryId: string, value: string): MJStateProvinceEntity | undefined;
+    /**
+     * Resolve a lat/lng coordinate to its containing country and state/province
+     * using point-in-polygon testing against cached BoundaryGeoJSON data.
+     * No text matching — purely geometric.
+     *
+     * @param lat - Latitude (-90 to 90)
+     * @param lng - Longitude (-180 to 180)
+     * @returns The matched country and state/province, or undefined for each if no match
+     */
+    ResolvePointToLocation(lat: number, lng: number): GeoPointResolution;
+    /**
+     * Resolve a lat/lng coordinate to its containing country.
+     * Uses bounding-box pre-filtering then ray-casting point-in-polygon.
+     */
+    ResolvePointToCountry(lat: number, lng: number): MJCountryEntity | undefined;
+    /**
+     * Resolve a lat/lng coordinate to its containing state/province within a known country.
+     * If countryId is not provided, resolves the country first.
+     */
+    ResolvePointToState(lat: number, lng: number, countryId?: string): MJStateProvinceEntity | undefined;
+    /**
+     * Batch-resolve multiple lat/lng points in parallel.
+     * Each point is resolved independently — ideal for choropleth grouping.
+     *
+     * @param points - Array of {lat, lng} coordinates
+     * @returns Array of GeoPointResolution in the same order as input
+     */
+    ResolvePoints(points: {
+        lat: number;
+        lng: number;
+    }[]): GeoPointResolution[];
+    /**
+     * Test if a point falls inside a CachedGeometry (bbox pre-filter + ray-casting).
+     */
+    private pointInCachedGeometry;
+    /**
+     * Check if a point is inside a bounding box.
+     * BBox format: [minLng, minLat, maxLng, maxLat]
+     */
+    private pointInBBox;
+    /**
+     * Ray-casting point-in-polygon for a polygon with rings.
+     * First ring is the outer boundary (must be inside).
+     * Subsequent rings are holes (must NOT be inside).
+     */
+    private pointInPolygonRings;
+    /**
+     * Ray-casting algorithm: cast a horizontal ray from the point eastward,
+     * count how many polygon edges it crosses. Odd = inside.
+     * Coordinates are [lng, lat] pairs (GeoJSON convention).
+     */
+    private rayCast;
+    /**
+     * Parse all BoundaryGeoJSON data and build indexed geometry caches.
+     * Called once during AdditionalLoading after entities are loaded.
+     */
+    private buildGeometryCaches;
+    /**
+     * Parse a BoundaryGeoJSON value into a CachedGeometry.
+     * Supports GeoJSON Feature, Polygon, and MultiPolygon types.
+     * Returns null if the boundary is missing or unparseable.
+     */
+    private parseEntityBoundary;
+    /**
+     * Parse a single Polygon's coordinate rings and compute its bounding box.
+     * GeoJSON Polygon coordinates: [ outerRing, ...holeRings ]
+     * Each ring is an array of [lng, lat] pairs.
+     */
+    private parsePolygonCoordinates;
+    private buildLookupMaps;
+}
+//# sourceMappingURL=GeoDataEngine.d.ts.map

package/dist/engines/GeoDataEngine.d.ts.map

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

package/dist/engines/GeoDataEngine.js

@@ -0,0 +1,425 @@
+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 { BaseEngine, LogStatus } from "@memberjunction/core";
+import { RegisterForStartup } from "@memberjunction/core";
+/**
+ * GeoDataEngine provides cached, in-memory access to Country and StateProvince
+ * reference data. Loaded once at startup via @RegisterForStartup, all lookups
+ * are O(1) via pre-built Maps keyed by common lookup patterns.
+ *
+ * Usage:
+ * ```typescript
+ * const engine = GeoDataEngine.Instance;
+ * const country = engine.GetCountryByISO2('US');
+ * const state = engine.GetStateByCode('US-country-id', 'CO');
+ * ```
+ */
+let GeoDataEngine = class GeoDataEngine extends BaseEngine {
+    constructor() {
+        super(...arguments);
+        this._countries = [];
+        this._stateProvinces = [];
+        // Pre-built lookup Maps for O(1) access
+        this._countriesByISO2 = new Map();
+        this._countriesByISO3 = new Map();
+        this._countriesByName = new Map();
+        this._countriesById = new Map();
+        this._statesByCountryAndCode = new Map();
+        this._statesByCountryAndName = new Map();
+        this._statesById = new Map();
+        // Pre-parsed geometry caches for point-in-polygon testing
+        this._countryGeometries = [];
+        this._stateGeometries = [];
+        /** Maps countryId → array of state geometries for that country */
+        this._stateGeometriesByCountry = new Map();
+    }
+    static get Instance() {
+        return super.getInstance();
+    }
+    async Config(forceRefresh, contextUser, provider) {
+        const configs = [
+            {
+                Type: 'entity',
+                EntityName: 'MJ: Countries',
+                PropertyName: '_countries',
+                CacheLocal: true,
+            },
+            {
+                Type: 'entity',
+                EntityName: 'MJ: State Provinces',
+                PropertyName: '_stateProvinces',
+                CacheLocal: true,
+            }
+        ];
+        await this.Load(configs, provider, forceRefresh, contextUser);
+    }
+    async AdditionalLoading(_contextUser) {
+        this.buildLookupMaps();
+        this.buildGeometryCaches();
+    }
+    // ================================================================
+    // Cached data getters
+    // ================================================================
+    get Countries() {
+        return this._countries || [];
+    }
+    get StateProvinces() {
+        return this._stateProvinces || [];
+    }
+    // ================================================================
+    // Country lookups — all O(1)
+    // ================================================================
+    GetCountryByISO2(iso2) {
+        if (!iso2)
+            return undefined;
+        return this._countriesByISO2.get(iso2.trim().toUpperCase());
+    }
+    GetCountryByISO3(iso3) {
+        if (!iso3)
+            return undefined;
+        return this._countriesByISO3.get(iso3.trim().toUpperCase());
+    }
+    GetCountryByName(name) {
+        if (!name)
+            return undefined;
+        return this._countriesByName.get(name.trim().toLowerCase());
+    }
+    GetCountryById(id) {
+        if (!id)
+            return undefined;
+        return this._countriesById.get(id.toLowerCase());
+    }
+    /**
+     * Resolve a country from a text value that could be a name, ISO2, or ISO3 code.
+     * Tries ISO2 first (most common), then ISO3, then name match.
+     */
+    ResolveCountry(value) {
+        if (!value)
+            return undefined;
+        const trimmed = value.trim();
+        // Try ISO2 (2-char codes like "US", "GB")
+        if (trimmed.length === 2) {
+            const byISO2 = this.GetCountryByISO2(trimmed);
+            if (byISO2)
+                return byISO2;
+        }
+        // Try ISO3 (3-char codes like "USA", "GBR")
+        if (trimmed.length === 3) {
+            const byISO3 = this.GetCountryByISO3(trimmed);
+            if (byISO3)
+                return byISO3;
+        }
+        // Try name match
+        return this.GetCountryByName(trimmed);
+    }
+    // ================================================================
+    // State/Province lookups — all O(1)
+    // ================================================================
+    /**
+     * Look up a state/province by its Code within a specific country.
+     * @param countryId - The country's UUID
+     * @param code - The state/province code (e.g., "CO", "ON", "NSW")
+     */
+    GetStateByCode(countryId, code) {
+        if (!countryId || !code)
+            return undefined;
+        const key = `${countryId.toLowerCase()}|${code.trim().toUpperCase()}`;
+        return this._statesByCountryAndCode.get(key);
+    }
+    /**
+     * Look up a state/province by its Name within a specific country.
+     * @param countryId - The country's UUID
+     * @param name - The state/province name (e.g., "Colorado", "Ontario")
+     */
+    GetStateByName(countryId, name) {
+        if (!countryId || !name)
+            return undefined;
+        const key = `${countryId.toLowerCase()}|${name.trim().toLowerCase()}`;
+        return this._statesByCountryAndName.get(key);
+    }
+    GetStateById(id) {
+        if (!id)
+            return undefined;
+        return this._statesById.get(id.toLowerCase());
+    }
+    /**
+     * Resolve a state/province from a text value within a country.
+     * Tries code first, then name match.
+     */
+    ResolveState(countryId, value) {
+        if (!countryId || !value)
+            return undefined;
+        const byCode = this.GetStateByCode(countryId, value);
+        if (byCode)
+            return byCode;
+        return this.GetStateByName(countryId, value);
+    }
+    // ================================================================
+    // Point-in-polygon resolution — coordinate-based lookups
+    // ================================================================
+    /**
+     * Resolve a lat/lng coordinate to its containing country and state/province
+     * using point-in-polygon testing against cached BoundaryGeoJSON data.
+     * No text matching — purely geometric.
+     *
+     * @param lat - Latitude (-90 to 90)
+     * @param lng - Longitude (-180 to 180)
+     * @returns The matched country and state/province, or undefined for each if no match
+     */
+    ResolvePointToLocation(lat, lng) {
+        const country = this.ResolvePointToCountry(lat, lng);
+        const state = country ? this.ResolvePointToState(lat, lng, country.ID) : undefined;
+        return { Country: country, State: state };
+    }
+    /**
+     * Resolve a lat/lng coordinate to its containing country.
+     * Uses bounding-box pre-filtering then ray-casting point-in-polygon.
+     */
+    ResolvePointToCountry(lat, lng) {
+        for (const geom of this._countryGeometries) {
+            if (this.pointInCachedGeometry(lat, lng, geom)) {
+                return this._countriesById.get(geom.entityId);
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Resolve a lat/lng coordinate to its containing state/province within a known country.
+     * If countryId is not provided, resolves the country first.
+     */
+    ResolvePointToState(lat, lng, countryId) {
+        let resolvedCountryId = countryId?.toLowerCase();
+        if (!resolvedCountryId) {
+            const country = this.ResolvePointToCountry(lat, lng);
+            if (!country)
+                return undefined;
+            resolvedCountryId = country.ID.toLowerCase();
+        }
+        const stateGeoms = this._stateGeometriesByCountry.get(resolvedCountryId);
+        if (!stateGeoms)
+            return undefined;
+        for (const geom of stateGeoms) {
+            if (this.pointInCachedGeometry(lat, lng, geom)) {
+                return this._statesById.get(geom.entityId);
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Batch-resolve multiple lat/lng points in parallel.
+     * Each point is resolved independently — ideal for choropleth grouping.
+     *
+     * @param points - Array of {lat, lng} coordinates
+     * @returns Array of GeoPointResolution in the same order as input
+     */
+    ResolvePoints(points) {
+        return points.map(p => this.ResolvePointToLocation(p.lat, p.lng));
+    }
+    // ================================================================
+    // Private — point-in-polygon geometry
+    // ================================================================
+    /**
+     * Test if a point falls inside a CachedGeometry (bbox pre-filter + ray-casting).
+     */
+    pointInCachedGeometry(lat, lng, geom) {
+        // Fast rejection via overall bounding box
+        if (!this.pointInBBox(lat, lng, geom.bbox))
+            return false;
+        // Test each polygon (MultiPolygon support)
+        for (const poly of geom.polygons) {
+            if (!this.pointInBBox(lat, lng, poly.bbox))
+                continue;
+            if (this.pointInPolygonRings(lat, lng, poly.rings))
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Check if a point is inside a bounding box.
+     * BBox format: [minLng, minLat, maxLng, maxLat]
+     */
+    pointInBBox(lat, lng, bbox) {
+        return lng >= bbox[0] && lat >= bbox[1] && lng <= bbox[2] && lat <= bbox[3];
+    }
+    /**
+     * Ray-casting point-in-polygon for a polygon with rings.
+     * First ring is the outer boundary (must be inside).
+     * Subsequent rings are holes (must NOT be inside).
+     */
+    pointInPolygonRings(lat, lng, rings) {
+        if (rings.length === 0)
+            return false;
+        // Must be inside the outer ring
+        if (!this.rayCast(lat, lng, rings[0]))
+            return false;
+        // Must NOT be inside any hole
+        for (let i = 1; i < rings.length; i++) {
+            if (this.rayCast(lat, lng, rings[i]))
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Ray-casting algorithm: cast a horizontal ray from the point eastward,
+     * count how many polygon edges it crosses. Odd = inside.
+     * Coordinates are [lng, lat] pairs (GeoJSON convention).
+     */
+    rayCast(lat, lng, ring) {
+        let inside = false;
+        const n = ring.length;
+        for (let i = 0, j = n - 1; i < n; j = i++) {
+            const xi = ring[i][0], yi = ring[i][1]; // lng, lat of vertex i
+            const xj = ring[j][0], yj = ring[j][1]; // lng, lat of vertex j
+            // Check if the ray crosses this edge
+            if ((yi > lat) !== (yj > lat) &&
+                lng < (xj - xi) * (lat - yi) / (yj - yi) + xi) {
+                inside = !inside;
+            }
+        }
+        return inside;
+    }
+    // ================================================================
+    // Private — geometry cache building
+    // ================================================================
+    /**
+     * Parse all BoundaryGeoJSON data and build indexed geometry caches.
+     * Called once during AdditionalLoading after entities are loaded.
+     */
+    buildGeometryCaches() {
+        this._countryGeometries = [];
+        this._stateGeometries = [];
+        this._stateGeometriesByCountry.clear();
+        let countryParsed = 0;
+        let stateParsed = 0;
+        // Parse country boundaries
+        for (const country of this._countries) {
+            const geom = this.parseEntityBoundary(country.ID, country.BoundaryGeoJSON);
+            if (geom) {
+                this._countryGeometries.push(geom);
+                countryParsed++;
+            }
+        }
+        // Parse state/province boundaries, indexed by country
+        for (const state of this._stateProvinces) {
+            const geom = this.parseEntityBoundary(state.ID, state.BoundaryGeoJSON);
+            if (geom) {
+                this._stateGeometries.push(geom);
+                stateParsed++;
+                const countryKey = state.CountryID.toLowerCase();
+                let arr = this._stateGeometriesByCountry.get(countryKey);
+                if (!arr) {
+                    arr = [];
+                    this._stateGeometriesByCountry.set(countryKey, arr);
+                }
+                arr.push(geom);
+            }
+        }
+        LogStatus(`GeoDataEngine: parsed ${countryParsed} country and ${stateParsed} state/province boundaries for point-in-polygon`);
+    }
+    /**
+     * Parse a BoundaryGeoJSON value into a CachedGeometry.
+     * Supports GeoJSON Feature, Polygon, and MultiPolygon types.
+     * Returns null if the boundary is missing or unparseable.
+     */
+    parseEntityBoundary(entityId, boundaryGeoJSON) {
+        if (!boundaryGeoJSON)
+            return null;
+        try {
+            const raw = typeof boundaryGeoJSON === 'string' ? JSON.parse(boundaryGeoJSON) : boundaryGeoJSON;
+            const geometry = raw.type === 'Feature' ? raw.geometry : raw;
+            if (!geometry || !geometry.coordinates)
+                return null;
+            const polygons = [];
+            if (geometry.type === 'Polygon') {
+                const parsed = this.parsePolygonCoordinates(geometry.coordinates);
+                if (parsed)
+                    polygons.push(parsed);
+            }
+            else if (geometry.type === 'MultiPolygon') {
+                for (const polyCoords of geometry.coordinates) {
+                    const parsed = this.parsePolygonCoordinates(polyCoords);
+                    if (parsed)
+                        polygons.push(parsed);
+                }
+            }
+            if (polygons.length === 0)
+                return null;
+            // Compute overall bounding box across all polygons
+            const overallBbox = [
+                Math.min(...polygons.map(p => p.bbox[0])),
+                Math.min(...polygons.map(p => p.bbox[1])),
+                Math.max(...polygons.map(p => p.bbox[2])),
+                Math.max(...polygons.map(p => p.bbox[3]))
+            ];
+            return { entityId: entityId.toLowerCase(), polygons, bbox: overallBbox };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Parse a single Polygon's coordinate rings and compute its bounding box.
+     * GeoJSON Polygon coordinates: [ outerRing, ...holeRings ]
+     * Each ring is an array of [lng, lat] pairs.
+     */
+    parsePolygonCoordinates(coordinates) {
+        if (!coordinates || coordinates.length === 0)
+            return null;
+        let minLng = Infinity, minLat = Infinity, maxLng = -Infinity, maxLat = -Infinity;
+        // Compute bbox from the outer ring (first ring)
+        for (const point of coordinates[0]) {
+            if (point[0] < minLng)
+                minLng = point[0];
+            if (point[1] < minLat)
+                minLat = point[1];
+            if (point[0] > maxLng)
+                maxLng = point[0];
+            if (point[1] > maxLat)
+                maxLat = point[1];
+        }
+        return {
+            rings: coordinates,
+            bbox: [minLng, minLat, maxLng, maxLat]
+        };
+    }
+    // ================================================================
+    // Private — build O(1) lookup maps
+    // ================================================================
+    buildLookupMaps() {
+        this._countriesByISO2.clear();
+        this._countriesByISO3.clear();
+        this._countriesByName.clear();
+        this._countriesById.clear();
+        this._statesByCountryAndCode.clear();
+        this._statesByCountryAndName.clear();
+        this._statesById.clear();
+        for (const c of this._countries) {
+            if (c.ISO2)
+                this._countriesByISO2.set(c.ISO2.trim().toUpperCase(), c);
+            if (c.ISO3)
+                this._countriesByISO3.set(c.ISO3.trim().toUpperCase(), c);
+            if (c.Name)
+                this._countriesByName.set(c.Name.trim().toLowerCase(), c);
+            this._countriesById.set(c.ID.toLowerCase(), c);
+        }
+        for (const s of this._stateProvinces) {
+            const countryKey = s.CountryID.toLowerCase();
+            if (s.Code) {
+                this._statesByCountryAndCode.set(`${countryKey}|${s.Code.trim().toUpperCase()}`, s);
+            }
+            if (s.Name) {
+                this._statesByCountryAndName.set(`${countryKey}|${s.Name.trim().toLowerCase()}`, s);
+            }
+            this._statesById.set(s.ID.toLowerCase(), s);
+        }
+    }
+};
+GeoDataEngine = __decorate([
+    RegisterForStartup()
+], GeoDataEngine);
+export { GeoDataEngine };
+//# sourceMappingURL=GeoDataEngine.js.map

package/dist/engines/GeoDataEngine.js.map

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