@memberjunction/core-actions 5.23.0 → 5.25.0

package/dist/custom/geo/scheduled-geocoding.action.d.ts

@@ -0,0 +1,135 @@
+import { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+import { BaseAction } from '@memberjunction/actions';
+/**
+ * Scheduled geocoding maintenance action that handles three tasks:
+ *
+ * 1. **Missing records** — Finds records in geo-enabled entities that have
+ *    non-null geo fields but no RecordGeoCode row, and geocodes them.
+ * 2. **Failed retries** — Retries RecordGeoCode rows with Status='failed'
+ *    up to a configurable max retry count.
+ * 3. **Orphan cleanup** — Removes RecordGeoCode rows whose source entity
+ *    record no longer exists.
+ *
+ * ## Parameters
+ * - **BatchSize** (default 10) — Number of records to geocode **concurrently**
+ *   in each parallel batch. Controls API rate pressure. Google Geocoding API
+ *   allows 50 QPS, so 10 is conservative and leaves headroom.
+ * - **MaxTotalRecords** (default unlimited) — Optional hard cap on the total
+ *   number of records processed in a single run. When null/0, processes all
+ *   pending records until exhausted.
+ * - **MaxRetries** (default 5) — Maximum retry count for failed geocoding
+ *   attempts before a record is considered permanently failed.
+ *
+ * ## Cache Invalidation
+ * After geocoding each record, the action loads the parent entity record
+ * and fires a synthetic BaseEntity 'save' event so that any cached RunView
+ * results containing stale lat/lng (from the RecordGeoCode JOIN) are
+ * invalidated. This ensures the server cache stays consistent.
+ *
+ * Designed to run on a schedule (every few hours) as a safety net for records
+ * that bypass BaseEntity.Save() (bulk SQL imports, direct DB operations).
+ */
+export declare class ScheduledGeocodingAction extends BaseAction {
+    private static readonly DEFAULT_MAX_RETRIES;
+    private static readonly DEFAULT_BATCH_SIZE;
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Find records in geo-enabled entities that have no RecordGeoCode row
+     * and geocode them. Processes ALL missing records (or up to maxTotal),
+     * geocoding in parallel batches of batchSize.
+     */
+    private processMissingRecords;
+    /**
+     * Process all missing RecordGeoCode rows for a single entity.
+     * Loads all entity records with non-null geo fields, filters out those
+     * that already have a RecordGeoCode row, then geocodes the rest in
+     * parallel batches.
+     *
+     * @param entityInfo - The entity to process
+     * @param contextUser - User context for data operations
+     * @param batchSize - Number of concurrent geocoding operations per batch
+     * @param maxRows - Maximum records to process (0 = unlimited)
+     */
+    private processMissingForEntity;
+    /**
+     * Retry failed geocoding attempts. Loads the source entity record
+     * and re-runs GeoCodeSyncService. Processes all eligible failures
+     * (or up to maxTotal) in parallel batches.
+     */
+    private processFailedRetries;
+    /**
+     * Load source entity records for a set of RecordGeoCode rows.
+     * Skips records whose source entity no longer exists.
+     */
+    private loadSourceEntities;
+    /**
+     * Remove RecordGeoCode rows whose source entity record no longer exists.
+     * Processes one entity at a time to keep queries efficient.
+     */
+    private cleanupOrphanedRecords;
+    /**
+     * Geocode a list of entity records in parallel batches, then fire cache
+     * invalidation events for each successfully geocoded record.
+     *
+     * For each record in the batch:
+     * 1. Run GeoCodeSyncService.SyncIfChanged to geocode and update RecordGeoCode
+     * 2. Fire a synthetic BaseEntity 'save' event with the loaded entity so that
+     *    LocalCacheManager invalidates any cached RunView results containing stale
+     *    lat/lng from the RecordGeoCode JOIN
+     *
+     * @param entities - Pre-loaded BaseEntity instances to geocode
+     * @param entityInfo - Entity metadata
+     * @param contextUser - User context
+     * @param batchSize - Number of concurrent geocoding operations per batch
+     */
+    private geocodeBatch;
+    /**
+     * Geocode a single entity record and fire a cache invalidation event.
+     *
+     * After geocoding updates the RecordGeoCode row, we need to tell the
+     * cache system that this entity record's view data has changed (because
+     * the view JOINs to RecordGeoCode for __mj_Latitude/__mj_Longitude).
+     * We do this by firing a synthetic BaseEntity 'save' event with the
+     * entity instance — the same event that BaseEntity.Save() fires.
+     *
+     * @returns true if geocoding succeeded, false otherwise
+     */
+    private geocodeAndInvalidate;
+    /**
+     * Fire a synthetic BaseEntity 'save' event via MJGlobal so that
+     * LocalCacheManager and BaseEngine listeners pick up the change.
+     *
+     * This is the same event that BaseEntity.RaiseEvent() fires after
+     * a successful Save(), but triggered externally because the record's
+     * view data changed due to a RecordGeoCode update (not a direct save).
+     *
+     * The entity instance is passed as both `component` and `event.baseEntity`
+     * so cache handlers can read EntityInfo, PrimaryKeys, and GetAll() —
+     * exactly the same contract as a real save event.
+     */
+    private fireSyntheticSaveEvent;
+    /**
+     * Get the geo address fields (non-lat/lng) for an entity.
+     * These are the fields that, when non-null, indicate a record
+     * should have a geocode.
+     */
+    private getGeoAddressFields;
+    /**
+     * Get the set of RecordIDs that already have a RecordGeoCode row for an entity.
+     */
+    private getExistingGeoCodeRecordIds;
+    /**
+     * Build a RecordID string from an entity's primary key, matching the
+     * format used in the view's LEFT JOIN to RecordGeoCode.
+     */
+    private buildRecordId;
+    /**
+     * Extract a numeric parameter with a default value.
+     */
+    private getNumericParam;
+    /**
+     * Extract an optional numeric parameter. Returns null if not provided.
+     */
+    private getNullableNumericParam;
+}
+//# sourceMappingURL=scheduled-geocoding.action.d.ts.map

package/dist/custom/geo/scheduled-geocoding.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-geocoding.action.d.ts","sourceRoot":"","sources":["../../../src/custom/geo/scheduled-geocoding.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AASrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBACa,wBAAyB,SAAQ,UAAU;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAM;cAEhC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyCvF;;;;OAIG;YACW,qBAAqB;IA0BnC;;;;;;;;;;OAUG;YACW,uBAAuB;IAyDrC;;;;OAIG;YACW,oBAAoB;IA2DlC;;;OAGG;YACW,kBAAkB;IA4BhC;;;OAGG;YACW,sBAAsB;IA0DpC;;;;;;;;;;;;;;OAcG;YACW,YAAY;IA0B1B;;;;;;;;;;OAUG;YACW,oBAAoB;IAqBlC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;YACW,2BAA2B;IAezC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAMlC"}

package/dist/custom/geo/scheduled-geocoding.action.js

@@ -0,0 +1,428 @@
+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;
+};
+var ScheduledGeocodingAction_1;
+import { BaseAction } from '@memberjunction/actions';
+import { RegisterClass, MJGlobal, MJEventType } from '@memberjunction/global';
+import { RunView, Metadata, LogStatus, LogError, CompositeKey, BaseEntity, BaseEntityEvent } from '@memberjunction/core';
+import { GeoCodeSyncService } from '@memberjunction/geo-core';
+/**
+ * Scheduled geocoding maintenance action that handles three tasks:
+ *
+ * 1. **Missing records** — Finds records in geo-enabled entities that have
+ *    non-null geo fields but no RecordGeoCode row, and geocodes them.
+ * 2. **Failed retries** — Retries RecordGeoCode rows with Status='failed'
+ *    up to a configurable max retry count.
+ * 3. **Orphan cleanup** — Removes RecordGeoCode rows whose source entity
+ *    record no longer exists.
+ *
+ * ## Parameters
+ * - **BatchSize** (default 10) — Number of records to geocode **concurrently**
+ *   in each parallel batch. Controls API rate pressure. Google Geocoding API
+ *   allows 50 QPS, so 10 is conservative and leaves headroom.
+ * - **MaxTotalRecords** (default unlimited) — Optional hard cap on the total
+ *   number of records processed in a single run. When null/0, processes all
+ *   pending records until exhausted.
+ * - **MaxRetries** (default 5) — Maximum retry count for failed geocoding
+ *   attempts before a record is considered permanently failed.
+ *
+ * ## Cache Invalidation
+ * After geocoding each record, the action loads the parent entity record
+ * and fires a synthetic BaseEntity 'save' event so that any cached RunView
+ * results containing stale lat/lng (from the RecordGeoCode JOIN) are
+ * invalidated. This ensures the server cache stays consistent.
+ *
+ * Designed to run on a schedule (every few hours) as a safety net for records
+ * that bypass BaseEntity.Save() (bulk SQL imports, direct DB operations).
+ */
+let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction {
+    static { ScheduledGeocodingAction_1 = this; }
+    static { this.DEFAULT_MAX_RETRIES = 5; }
+    static { this.DEFAULT_BATCH_SIZE = 10; }
+    async InternalRunAction(params) {
+        const contextUser = params.ContextUser;
+        if (!contextUser) {
+            return { Success: false, ResultCode: 'MISSING_USER', Message: 'ScheduledGeocodingAction requires a context user' };
+        }
+        const maxRetries = this.getNumericParam(params, 'MaxRetries', ScheduledGeocodingAction_1.DEFAULT_MAX_RETRIES);
+        const batchSize = this.getNumericParam(params, 'BatchSize', ScheduledGeocodingAction_1.DEFAULT_BATCH_SIZE);
+        const maxTotal = this.getNullableNumericParam(params, 'MaxTotalRecords');
+        LogStatus(`ScheduledGeocodingAction: Starting maintenance run (BatchSize=${batchSize}, MaxTotal=${maxTotal ?? 'unlimited'})`);
+        const stats = { MissingProcessed: 0, MissingSuccess: 0, RetriesProcessed: 0, RetriesSuccess: 0, OrphansRemoved: 0 };
+        // Step 1: Find and geocode missing records
+        const missingStats = await this.processMissingRecords(contextUser, batchSize, maxTotal);
+        stats.MissingProcessed = missingStats.Processed;
+        stats.MissingSuccess = missingStats.Success;
+        // Step 2: Retry failed geocoding attempts
+        const retryMaxTotal = maxTotal != null ? Math.max(0, maxTotal - stats.MissingProcessed) : null;
+        const retryStats = await this.processFailedRetries(contextUser, maxRetries, batchSize, retryMaxTotal);
+        stats.RetriesProcessed = retryStats.Processed;
+        stats.RetriesSuccess = retryStats.Success;
+        // Step 3: Clean up orphaned RecordGeoCode rows
+        stats.OrphansRemoved = await this.cleanupOrphanedRecords(contextUser, batchSize);
+        LogStatus(`ScheduledGeocodingAction: Complete — Missing: ${stats.MissingProcessed} processed (${stats.MissingSuccess} success), Retries: ${stats.RetriesProcessed} (${stats.RetriesSuccess} success), Orphans: ${stats.OrphansRemoved} removed`);
+        return {
+            Success: true,
+            ResultCode: 'SUCCESS',
+            Message: JSON.stringify(stats)
+        };
+    }
+    // ================================================================
+    // Step 1: Process missing RecordGeoCode rows
+    // ================================================================
+    /**
+     * Find records in geo-enabled entities that have no RecordGeoCode row
+     * and geocode them. Processes ALL missing records (or up to maxTotal),
+     * geocoding in parallel batches of batchSize.
+     */
+    async processMissingRecords(contextUser, batchSize, maxTotal) {
+        const md = new Metadata();
+        const geoEntities = md.Entities.filter(e => e.SupportsGeoCoding);
+        let totalProcessed = 0;
+        let totalSuccess = 0;
+        for (const entityInfo of geoEntities) {
+            if (maxTotal != null && totalProcessed >= maxTotal)
+                break;
+            const remaining = maxTotal != null ? maxTotal - totalProcessed : null;
+            const entityStats = await this.processMissingForEntity(entityInfo, contextUser, batchSize, remaining);
+            totalProcessed += entityStats.Processed;
+            totalSuccess += entityStats.Success;
+        }
+        if (totalProcessed > 0) {
+            LogStatus(`ScheduledGeocodingAction: Processed ${totalProcessed} missing records (${totalSuccess} geocoded successfully)`);
+        }
+        return { Processed: totalProcessed, Success: totalSuccess };
+    }
+    /**
+     * Process all missing RecordGeoCode rows for a single entity.
+     * Loads all entity records with non-null geo fields, filters out those
+     * that already have a RecordGeoCode row, then geocodes the rest in
+     * parallel batches.
+     *
+     * @param entityInfo - The entity to process
+     * @param contextUser - User context for data operations
+     * @param batchSize - Number of concurrent geocoding operations per batch
+     * @param maxRows - Maximum records to process (0 = unlimited)
+     */
+    async processMissingForEntity(entityInfo, contextUser, batchSize, maxRows) {
+        const rv = new RunView();
+        const pkField = entityInfo.FirstPrimaryKey;
+        if (!pkField)
+            return { Processed: 0, Success: 0 };
+        const geoFields = this.getGeoAddressFields(entityInfo);
+        if (geoFields.length === 0)
+            return { Processed: 0, Success: 0 };
+        try {
+            // Get all record IDs that already have a RecordGeoCode row
+            const existingRecordIds = await this.getExistingGeoCodeRecordIds(entityInfo.ID, contextUser);
+            // Load entity records with non-null geo fields
+            const nonNullConditions = geoFields.map(f => `${f.Name} IS NOT NULL`).join(' OR ');
+            const result = await rv.RunView({
+                EntityName: entityInfo.Name,
+                ExtraFilter: `(${nonNullConditions})`,
+                IgnoreMaxRows: true,
+                BypassCache: true,
+                ResultType: 'entity_object'
+            }, contextUser);
+            if (!result.Success || result.Results.length === 0) {
+                return { Processed: 0, Success: 0 };
+            }
+            // Filter to records missing geocodes
+            let missingRecords = result.Results
+                .filter(entity => {
+                const recordId = this.buildRecordId(entity);
+                return !existingRecordIds.has(recordId);
+            });
+            if (maxRows != null) {
+                missingRecords = missingRecords.slice(0, maxRows);
+            }
+            if (missingRecords.length === 0)
+                return { Processed: 0, Success: 0 };
+            // Geocode in parallel batches
+            return await this.geocodeBatch(missingRecords, entityInfo, contextUser, batchSize);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            LogError(`ScheduledGeocodingAction: Error querying missing records for ${entityInfo.Name}: ${msg}`);
+            return { Processed: 0, Success: 0 };
+        }
+    }
+    // ================================================================
+    // Step 2: Retry failed geocoding attempts
+    // ================================================================
+    /**
+     * Retry failed geocoding attempts. Loads the source entity record
+     * and re-runs GeoCodeSyncService. Processes all eligible failures
+     * (or up to maxTotal) in parallel batches.
+     */
+    async processFailedRetries(contextUser, maxRetries, batchSize, maxTotal) {
+        const rv = new RunView();
+        const failedResult = await rv.RunView({
+            EntityName: 'MJ: Record Geo Codes',
+            ExtraFilter: `Status='failed' AND RetryCount < ${maxRetries}`,
+            IgnoreMaxRows: true,
+            OrderBy: 'RetryCount ASC, GeocodedAt ASC',
+            ResultType: 'entity_object'
+        }, contextUser);
+        if (!failedResult.Success || failedResult.Results.length === 0) {
+            return { Processed: 0, Success: 0 };
+        }
+        let records = failedResult.Results;
+        if (maxTotal != null) {
+            records = records.slice(0, maxTotal);
+        }
+        LogStatus(`ScheduledGeocodingAction: ${records.length} failed records eligible for retry`);
+        const md = new Metadata();
+        let totalProcessed = 0;
+        let totalSuccess = 0;
+        // Group by entity for efficient processing
+        const byEntity = new Map();
+        for (const geoRecord of records) {
+            const key = geoRecord.EntityID;
+            let arr = byEntity.get(key);
+            if (!arr) {
+                arr = [];
+                byEntity.set(key, arr);
+            }
+            arr.push(geoRecord);
+        }
+        for (const [entityId, geoRecords] of byEntity) {
+            const entityInfo = md.EntityByID(entityId);
+            if (!entityInfo)
+                continue;
+            // Load source entity records and geocode them in parallel batches
+            const entities = await this.loadSourceEntities(geoRecords, entityInfo, contextUser);
+            if (entities.length === 0)
+                continue;
+            const stats = await this.geocodeBatch(entities, entityInfo, contextUser, batchSize);
+            totalProcessed += stats.Processed;
+            totalSuccess += stats.Success;
+        }
+        return { Processed: totalProcessed, Success: totalSuccess };
+    }
+    /**
+     * Load source entity records for a set of RecordGeoCode rows.
+     * Skips records whose source entity no longer exists.
+     */
+    async loadSourceEntities(geoRecords, entityInfo, contextUser) {
+        const md = new Metadata();
+        const entities = [];
+        for (const geoRecord of geoRecords) {
+            try {
+                const entity = await md.GetEntityObject(entityInfo.Name, contextUser);
+                const pk = new CompositeKey([{ FieldName: 'ID', Value: geoRecord.RecordID }]);
+                const loaded = await entity.InnerLoad(pk);
+                if (loaded) {
+                    entities.push(entity);
+                }
+            }
+            catch {
+                // Source record doesn't exist or can't be loaded — skip
+            }
+        }
+        return entities;
+    }
+    // ================================================================
+    // Step 3: Orphan cleanup
+    // ================================================================
+    /**
+     * Remove RecordGeoCode rows whose source entity record no longer exists.
+     * Processes one entity at a time to keep queries efficient.
+     */
+    async cleanupOrphanedRecords(contextUser, batchSize) {
+        const rv = new RunView();
+        const md = new Metadata();
+        let totalRemoved = 0;
+        // Get distinct EntityIDs from RecordGeoCode
+        const entityResult = await rv.RunView({
+            EntityName: 'MJ: Record Geo Codes',
+            Fields: ['EntityID'],
+            ResultType: 'simple',
+            IgnoreMaxRows: true
+        }, contextUser);
+        if (!entityResult.Success)
+            return 0;
+        const entityIds = [...new Set(entityResult.Results.map(r => r.EntityID))];
+        for (const entityId of entityIds) {
+            try {
+                const entityInfo = md.EntityByID(entityId);
+                if (!entityInfo)
+                    continue;
+                const pkField = entityInfo.FirstPrimaryKey;
+                if (!pkField)
+                    continue;
+                const orphanResult = await rv.RunView({
+                    EntityName: 'MJ: Record Geo Codes',
+                    ExtraFilter: `EntityID = '${entityId}' AND NOT EXISTS (SELECT 1 FROM ${entityInfo.SchemaName}.${entityInfo.BaseTable} src WHERE CAST(src.${pkField.Name} AS NVARCHAR(450)) = RecordID)`,
+                    IgnoreMaxRows: true,
+                    ResultType: 'entity_object'
+                }, contextUser);
+                if (orphanResult.Success && orphanResult.Results.length > 0) {
+                    // Delete orphans in parallel batches
+                    const orphans = orphanResult.Results;
+                    for (let i = 0; i < orphans.length; i += batchSize) {
+                        const batch = orphans.slice(i, i + batchSize);
+                        const results = await Promise.allSettled(batch.map(o => o.Delete()));
+                        totalRemoved += results.filter(r => r.status === 'fulfilled' && r.value).length;
+                    }
+                    LogStatus(`ScheduledGeocodingAction: Removed ${orphanResult.Results.length} orphaned geo records for ${entityInfo.Name}`);
+                }
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                LogError(`ScheduledGeocodingAction: Orphan cleanup error for entity ${entityId}: ${msg}`);
+            }
+        }
+        return totalRemoved;
+    }
+    // ================================================================
+    // Core: parallel batch geocoding with cache invalidation
+    // ================================================================
+    /**
+     * Geocode a list of entity records in parallel batches, then fire cache
+     * invalidation events for each successfully geocoded record.
+     *
+     * For each record in the batch:
+     * 1. Run GeoCodeSyncService.SyncIfChanged to geocode and update RecordGeoCode
+     * 2. Fire a synthetic BaseEntity 'save' event with the loaded entity so that
+     *    LocalCacheManager invalidates any cached RunView results containing stale
+     *    lat/lng from the RecordGeoCode JOIN
+     *
+     * @param entities - Pre-loaded BaseEntity instances to geocode
+     * @param entityInfo - Entity metadata
+     * @param contextUser - User context
+     * @param batchSize - Number of concurrent geocoding operations per batch
+     */
+    async geocodeBatch(entities, entityInfo, contextUser, batchSize) {
+        let totalSuccess = 0;
+        for (let i = 0; i < entities.length; i += batchSize) {
+            const batch = entities.slice(i, i + batchSize);
+            const results = await Promise.allSettled(batch.map(entity => this.geocodeAndInvalidate(entity, contextUser)));
+            const batchSuccess = results.filter(r => r.status === 'fulfilled' && r.value).length;
+            totalSuccess += batchSuccess;
+            if (entities.length > batchSize) {
+                LogStatus(`ScheduledGeocodingAction: ${entityInfo.Name} batch ${Math.floor(i / batchSize) + 1}/${Math.ceil(entities.length / batchSize)} — ${batchSuccess}/${batch.length} success`);
+            }
+        }
+        return { Processed: entities.length, Success: totalSuccess };
+    }
+    /**
+     * Geocode a single entity record and fire a cache invalidation event.
+     *
+     * After geocoding updates the RecordGeoCode row, we need to tell the
+     * cache system that this entity record's view data has changed (because
+     * the view JOINs to RecordGeoCode for __mj_Latitude/__mj_Longitude).
+     * We do this by firing a synthetic BaseEntity 'save' event with the
+     * entity instance — the same event that BaseEntity.Save() fires.
+     *
+     * @returns true if geocoding succeeded, false otherwise
+     */
+    async geocodeAndInvalidate(entity, contextUser) {
+        try {
+            const result = await GeoCodeSyncService.Instance.SyncIfChanged(entity, contextUser);
+            if (result) {
+                // Geocoding produced new coordinates — fire cache invalidation.
+                // Reload the entity to pick up fresh data from the view (including
+                // the updated __mj_Latitude/__mj_Longitude from RecordGeoCode JOIN),
+                // then raise a save event so LocalCacheManager updates its caches.
+                await entity.InnerLoad(entity.PrimaryKey);
+                this.fireSyntheticSaveEvent(entity);
+            }
+            return true;
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            LogError(`ScheduledGeocodingAction: Failed to geocode ${entity.EntityInfo.Name} record: ${msg}`);
+            return false;
+        }
+    }
+    /**
+     * Fire a synthetic BaseEntity 'save' event via MJGlobal so that
+     * LocalCacheManager and BaseEngine listeners pick up the change.
+     *
+     * This is the same event that BaseEntity.RaiseEvent() fires after
+     * a successful Save(), but triggered externally because the record's
+     * view data changed due to a RecordGeoCode update (not a direct save).
+     *
+     * The entity instance is passed as both `component` and `event.baseEntity`
+     * so cache handlers can read EntityInfo, PrimaryKeys, and GetAll() —
+     * exactly the same contract as a real save event.
+     */
+    fireSyntheticSaveEvent(entity) {
+        const event = new BaseEntityEvent();
+        event.type = 'save';
+        event.saveSubType = 'update';
+        event.baseEntity = entity;
+        event.payload = null;
+        MJGlobal.Instance.RaiseEvent({
+            component: entity,
+            event: MJEventType.ComponentEvent,
+            eventCode: BaseEntity.BaseEventCode,
+            args: event
+        });
+    }
+    // ================================================================
+    // Helpers
+    // ================================================================
+    /**
+     * Get the geo address fields (non-lat/lng) for an entity.
+     * These are the fields that, when non-null, indicate a record
+     * should have a geocode.
+     */
+    getGeoAddressFields(entityInfo) {
+        return entityInfo.Fields.filter(f => f.ExtendedType != null && f.ExtendedType.startsWith('Geo') &&
+            f.ExtendedType !== 'GeoLatitude' && f.ExtendedType !== 'GeoLongitude');
+    }
+    /**
+     * Get the set of RecordIDs that already have a RecordGeoCode row for an entity.
+     */
+    async getExistingGeoCodeRecordIds(entityId, contextUser) {
+        const rv = new RunView();
+        const existingResult = await rv.RunView({
+            EntityName: 'MJ: Record Geo Codes',
+            ExtraFilter: `EntityID = '${entityId}'`,
+            Fields: ['RecordID'],
+            ResultType: 'simple',
+            IgnoreMaxRows: true
+        }, contextUser);
+        return new Set(existingResult.Success ? existingResult.Results.map(r => r.RecordID) : []);
+    }
+    /**
+     * Build a RecordID string from an entity's primary key, matching the
+     * format used in the view's LEFT JOIN to RecordGeoCode.
+     */
+    buildRecordId(entity) {
+        const pkPairs = entity.PrimaryKey.KeyValuePairs;
+        return pkPairs.length === 1
+            ? String(pkPairs[0].Value)
+            : pkPairs.map(pk => String(pk.Value)).join('||');
+    }
+    /**
+     * Extract a numeric parameter with a default value.
+     */
+    getNumericParam(params, name, defaultValue) {
+        const param = params.Params.find(p => p.Name.trim().toLowerCase() === name.toLowerCase());
+        if (!param || param.Value === undefined || param.Value === null)
+            return defaultValue;
+        const parsed = Number(param.Value);
+        return isNaN(parsed) ? defaultValue : parsed;
+    }
+    /**
+     * Extract an optional numeric parameter. Returns null if not provided.
+     */
+    getNullableNumericParam(params, name) {
+        const param = params.Params.find(p => p.Name.trim().toLowerCase() === name.toLowerCase());
+        if (!param || param.Value === undefined || param.Value === null)
+            return null;
+        const parsed = Number(param.Value);
+        return isNaN(parsed) ? null : parsed;
+    }
+};
+ScheduledGeocodingAction = ScheduledGeocodingAction_1 = __decorate([
+    RegisterClass(BaseAction, 'Scheduled Geocoding')
+], ScheduledGeocodingAction);
+export { ScheduledGeocodingAction };
+//# sourceMappingURL=scheduled-geocoding.action.js.map

package/dist/custom/geo/scheduled-geocoding.action.js.map

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

package/dist/custom/search/search.action.d.ts

@@ -0,0 +1,67 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Action that executes a universal search across the organization's knowledge base.
+ *
+ * This action delegates to the `@memberjunction/search-engine` singleton which
+ * orchestrates vector similarity search, full-text search, entity LIKE-based search,
+ * and (optionally) storage file search. Results are fused via Reciprocal Rank Fusion (RRF),
+ * deduplicated, and enriched with entity icons, record names, and tags.
+ *
+ * Designed for use by AI agents (Sage, etc.), MCP connectors, A2A connectors,
+ * and workflow orchestration.
+ *
+ * @example
+ * ```typescript
+ * // Simple search
+ * await runAction({
+ *   ActionName: 'Search',
+ *   Params: [{ Name: 'Query', Value: 'quarterly revenue by region' }]
+ * });
+ *
+ * // Advanced search with filters
+ * await runAction({
+ *   ActionName: 'Search',
+ *   Params: [
+ *     { Name: 'Query',          Value: 'customer onboarding process' },
+ *     { Name: 'MaxResults',     Value: 10 },
+ *     { Name: 'MinScore',       Value: 0.3 },
+ *     { Name: 'EntityNames',    Value: 'Documents,Knowledge Articles' },
+ *     { Name: 'IncludeSources', Value: 'vector,fulltext' }
+ *   ]
+ * });
+ * ```
+ */
+export declare class SearchAction extends BaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Parse the IncludeSources parameter into a SearchSource array.
+     * Accepts a comma-separated string.
+     */
+    private parseIncludeSources;
+    /**
+     * Parse the EntityNames filter parameter into a string array.
+     */
+    private parseEntityNames;
+    /**
+     * Parse the Tags filter parameter into a string array.
+     */
+    private parseTags;
+    /**
+     * Build a SearchParams object from the extracted and validated parameters.
+     */
+    private buildSearchParams;
+    /**
+     * Build a SearchFilters object from the parsed filter parameters.
+     * Returns undefined if no filters are specified.
+     */
+    private buildFilters;
+    /**
+     * Convert SearchResultItem objects into serialization-safe formatted results.
+     */
+    private formatResults;
+    private getStringParam;
+    private getNumericParam;
+    private createErrorResult;
+}
+//# sourceMappingURL=search.action.d.ts.map

package/dist/custom/search/search.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.action.d.ts","sourceRoot":"","sources":["../../../src/custom/search/search.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAe,MAAM,8BAA8B,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAkCrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBACa,YAAa,SAAQ,UAAU;cAExB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiEvF;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;CAO5B"}