@memberjunction/core-entities 5.24.0 → 5.26.0

package/dist/engines/FileStorageEngine.d.ts

@@ -8,24 +8,28 @@ export interface StorageAccountWithProvider {
     provider: MJFileStorageProviderEntity;
 }
 /**
- * FileStorageEngine provides centralized, cached access to file storage accounts and providers.
+ * FileStorageEngineBase provides centralized, cached access to file storage accounts and providers.
  * This engine eliminates redundant database calls by caching the data and making it available
- * across the application.
+ * across the application. It is safe to use on both client and server — it only deals with
+ * cached metadata, not file I/O.
+ *
+ * For server-side file operations (upload, download, driver initialization), use the
+ * `FileStorageEngine` class from `@memberjunction/storage` which wraps this base via containment.
  *
  * Usage:
  * ```typescript
- * const engine = FileStorageEngine.Instance;
+ * const engine = FileStorageEngineBase.Instance;
  * await engine.Config(false);  // Use cached data if available
  * const accounts = engine.AccountsWithProviders;
  * ```
  */
-export declare class FileStorageEngine extends BaseEngine<FileStorageEngine> {
+export declare class FileStorageEngineBase extends BaseEngine<FileStorageEngineBase> {
     /**
      * Returns the global instance of the class. This is a singleton class, so there is only
      * one instance of it in the application. Do not directly create new instances of it,
      * always use this method to get the instance.
      */
-    static get Instance(): FileStorageEngine;
+    static get Instance(): FileStorageEngineBase;
     private _accounts;
     private _providers;
     /**
@@ -61,6 +65,18 @@ export declare class FileStorageEngine extends BaseEngine<FileStorageEngine> {
      * @returns The provider entity or undefined if not found
      */
     GetProviderById(providerId: string): MJFileStorageProviderEntity | undefined;
+    /**
+     * Gets a file storage account by its name (case-insensitive).
+     * @param name - The name of the account to find
+     * @returns The account entity or undefined if not found
+     */
+    GetAccountByName(name: string): MJFileStorageAccountEntity | undefined;
+    /**
+     * Gets file storage accounts linked to a given provider ID.
+     * @param providerId - The provider ID to match against account.ProviderID
+     * @returns Array of matching accounts (may be empty)
+     */
+    GetAccountsByProviderID(providerId: string): MJFileStorageAccountEntity[];
     /**
      * Gets a storage account with its provider details by account ID
      * @param accountId - The ID of the account to find

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

@@ -1 +1 @@
-{"version":3,"file":"FileStorageEngine.d.ts","sourceRoot":"","sources":["../../src/engines/FileStorageEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4B,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEzG,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAEzG;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,OAAO,EAAE,0BAA0B,CAAC;IACpC,QAAQ,EAAE,2BAA2B,CAAC;CACzC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,UAAU,CAAC,iBAAiB,CAAC;IAChE;;;;OAIG;IACH,WAAkB,QAAQ,IAAI,iBAAiB,CAE9C;IAED,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;;OAKG;IACU,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhH;;OAEG;IACH,IAAW,QAAQ,IAAI,0BAA0B,EAAE,CAElD;IAED;;;OAGG;IACH,IAAW,SAAS,IAAI,2BAA2B,EAAE,CAEpD;IAED;;;OAGG;IACH,IAAW,qBAAqB,IAAI,0BAA0B,EAAE,CAW/D;IAMD;;;;OAIG;IACI,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAIhF;;;;OAIG;IACI,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS;IAInF;;;;OAIG;IACI,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,0BAA0B,GAAG,IAAI;CAOtF"}
+{"version":3,"file":"FileStorageEngine.d.ts","sourceRoot":"","sources":["../../src/engines/FileStorageEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4B,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEzG,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAEzG;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,OAAO,EAAE,0BAA0B,CAAC;IACpC,QAAQ,EAAE,2BAA2B,CAAC;CACzC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,qBAAsB,SAAQ,UAAU,CAAC,qBAAqB,CAAC;IACxE;;;;OAIG;IACH,WAAkB,QAAQ,IAAI,qBAAqB,CAElD;IAED,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;;OAKG;IACU,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhH;;OAEG;IACH,IAAW,QAAQ,IAAI,0BAA0B,EAAE,CAElD;IAED;;;OAGG;IACH,IAAW,SAAS,IAAI,2BAA2B,EAAE,CAEpD;IAED;;;OAGG;IACH,IAAW,qBAAqB,IAAI,0BAA0B,EAAE,CAW/D;IAMD;;;;OAIG;IACI,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAIhF;;;;OAIG;IACI,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS;IAInF;;;;OAIG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAI7E;;;;OAIG;IACI,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,0BAA0B,EAAE;IAIhF;;;;OAIG;IACI,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,0BAA0B,GAAG,IAAI;CAOtF"}

package/dist/engines/FileStorageEngine.js

@@ -1,18 +1,22 @@
 import { BaseEngine } from "@memberjunction/core";
 import { UUIDsEqual } from "@memberjunction/global";
 /**
- * FileStorageEngine provides centralized, cached access to file storage accounts and providers.
+ * FileStorageEngineBase provides centralized, cached access to file storage accounts and providers.
  * This engine eliminates redundant database calls by caching the data and making it available
- * across the application.
+ * across the application. It is safe to use on both client and server — it only deals with
+ * cached metadata, not file I/O.
+ *
+ * For server-side file operations (upload, download, driver initialization), use the
+ * `FileStorageEngine` class from `@memberjunction/storage` which wraps this base via containment.
  *
  * Usage:
  * ```typescript
- * const engine = FileStorageEngine.Instance;
+ * const engine = FileStorageEngineBase.Instance;
  * await engine.Config(false);  // Use cached data if available
  * const accounts = engine.AccountsWithProviders;
  * ```
  */
-export class FileStorageEngine extends BaseEngine {
+export class FileStorageEngineBase extends BaseEngine {
     constructor() {
         super(...arguments);
         this._accounts = [];
@@ -100,6 +104,22 @@ export class FileStorageEngine extends BaseEngine {
     GetProviderById(providerId) {
         return this.Providers.find(p => UUIDsEqual(p.ID, providerId));
     }
+    /**
+     * Gets a file storage account by its name (case-insensitive).
+     * @param name - The name of the account to find
+     * @returns The account entity or undefined if not found
+     */
+    GetAccountByName(name) {
+        return this.Accounts.find(a => a.Name?.trim().toLowerCase() === name.trim().toLowerCase());
+    }
+    /**
+     * Gets file storage accounts linked to a given provider ID.
+     * @param providerId - The provider ID to match against account.ProviderID
+     * @returns Array of matching accounts (may be empty)
+     */
+    GetAccountsByProviderID(providerId) {
+        return this.Accounts.filter(a => UUIDsEqual(a.ProviderID, providerId));
+    }
     /**
      * Gets a storage account with its provider details by account ID
      * @param accountId - The ID of the account to find

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":"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"}

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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"}