@memberjunction/core-actions 5.38.0 → 5.40.0

package/dist/custom/esignature/get-signature-status.action.d.ts

@@ -0,0 +1,15 @@
+import { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+import { BaseSignatureAction } from './base-esignature.action.js';
+/**
+ * Action: "Get Signature Status".
+ *
+ * Polls the provider for the current envelope status of a signature request and persists it.
+ * Thin wrapper over {@link SignatureEngine.RefreshStatus}.
+ *
+ * Inputs: SignatureRequestID (required).
+ * Outputs: Status.
+ */
+export declare class GetSignatureStatusAction extends BaseSignatureAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+}
+//# sourceMappingURL=get-signature-status.action.d.ts.map

package/dist/custom/esignature/get-signature-status.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-signature-status.action.d.ts","sourceRoot":"","sources":["../../../src/custom/esignature/get-signature-status.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;GAQG;AACH,qBACa,wBAAyB,SAAQ,mBAAmB;cAC7C,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAyB1F"}

package/dist/custom/esignature/get-signature-status.action.js

@@ -0,0 +1,48 @@
+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 { BaseAction } from '@memberjunction/actions';
+import { BaseSignatureAction } from './base-esignature.action.js';
+/**
+ * Action: "Get Signature Status".
+ *
+ * Polls the provider for the current envelope status of a signature request and persists it.
+ * Thin wrapper over {@link SignatureEngine.RefreshStatus}.
+ *
+ * Inputs: SignatureRequestID (required).
+ * Outputs: Status.
+ */
+let GetSignatureStatusAction = class GetSignatureStatusAction extends BaseSignatureAction {
+    async InternalRunAction(params) {
+        const requestId = this.getStringParam(params, 'SignatureRequestID');
+        if (!requestId) {
+            return { Success: false, ResultCode: 'PROVIDER_ERROR', Message: "Parameter 'SignatureRequestID' is required." };
+        }
+        try {
+            const engine = await this.ensureEngine(params);
+            const result = await engine.RefreshStatus(requestId, params.ContextUser);
+            if (!result.Success) {
+                const notSent = (result.ErrorMessage ?? '').includes('not been sent');
+                return {
+                    Success: false,
+                    ResultCode: notSent ? 'NOT_SENT' : 'PROVIDER_ERROR',
+                    Message: result.ErrorMessage ?? 'Status check failed.',
+                };
+            }
+            this.addOutput(params, 'Status', result.status);
+            return { Success: true, ResultCode: 'OK', Message: `Status: ${result.status}.`, Params: params.Params };
+        }
+        catch (e) {
+            return { Success: false, ResultCode: 'PROVIDER_ERROR', Message: e instanceof Error ? e.message : String(e) };
+        }
+    }
+};
+GetSignatureStatusAction = __decorate([
+    RegisterClass(BaseAction, 'Get Signature Status')
+], GetSignatureStatusAction);
+export { GetSignatureStatusAction };
+//# sourceMappingURL=get-signature-status.action.js.map

package/dist/custom/esignature/get-signature-status.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-signature-status.action.js","sourceRoot":"","sources":["../../../src/custom/esignature/get-signature-status.action.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;GAQG;AAEI,IAAM,wBAAwB,GAA9B,MAAM,wBAAyB,SAAQ,mBAAmB;IACnD,KAAK,CAAC,iBAAiB,CAAC,MAAuB;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QACpE,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;QACpH,CAAC;QAED,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YAEzE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;gBACtE,OAAO;oBACH,OAAO,EAAE,KAAK;oBACd,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,gBAAgB;oBACnD,OAAO,EAAE,MAAM,CAAC,YAAY,IAAI,sBAAsB;iBACzD,CAAC;YACN,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,MAAM,CAAC,MAAM,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5G,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjH,CAAC;IACL,CAAC;CACJ,CAAA;AA1BY,wBAAwB;IADpC,aAAa,CAAC,UAAU,EAAE,sBAAsB,CAAC;GACrC,wBAAwB,CA0BpC"}

package/dist/custom/esignature/send-document-for-signature.action.d.ts

@@ -0,0 +1,24 @@
+import { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+import { BaseSignatureAction } from './base-esignature.action.js';
+/**
+ * Action: "Send Document for Signature".
+ *
+ * Sends one or more documents through a configured signature account/provider and records the
+ * envelope lifecycle. Thin wrapper over {@link SignatureEngine.SendForSignature}.
+ *
+ * Inputs:
+ *   - SignatureAccountID (required)
+ *   - Title (required)
+ *   - Documents (required) — array of `{ filename, contentType?, contentBase64 }`
+ *   - Recipients (required) — array of `{ email, name?, routingOrder?, role? }`
+ *   - Message?, EntityID?, RecordID?, ArtifactID?, ArtifactVersionID?, SendImmediately?, Metadata?
+ *
+ * Outputs: SignatureRequestID, ExternalEnvelopeID, Status.
+ */
+export declare class SendDocumentForSignatureAction extends BaseSignatureAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private parseDocuments;
+    private parseRecipients;
+    private fail;
+}
+//# sourceMappingURL=send-document-for-signature.action.d.ts.map

package/dist/custom/esignature/send-document-for-signature.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-document-for-signature.action.d.ts","sourceRoot":"","sources":["../../../src/custom/esignature/send-document-for-signature.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAInF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAU/D;;;;;;;;;;;;;;GAcG;AACH,qBACa,8BAA+B,SAAQ,mBAAmB;cACnD,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+DvF,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,IAAI;CAMf"}

package/dist/custom/esignature/send-document-for-signature.action.js

@@ -0,0 +1,112 @@
+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 { BaseAction } from '@memberjunction/actions';
+import { BaseSignatureAction } from './base-esignature.action.js';
+/**
+ * Action: "Send Document for Signature".
+ *
+ * Sends one or more documents through a configured signature account/provider and records the
+ * envelope lifecycle. Thin wrapper over {@link SignatureEngine.SendForSignature}.
+ *
+ * Inputs:
+ *   - SignatureAccountID (required)
+ *   - Title (required)
+ *   - Documents (required) — array of `{ filename, contentType?, contentBase64 }`
+ *   - Recipients (required) — array of `{ email, name?, routingOrder?, role? }`
+ *   - Message?, EntityID?, RecordID?, ArtifactID?, ArtifactVersionID?, SendImmediately?, Metadata?
+ *
+ * Outputs: SignatureRequestID, ExternalEnvelopeID, Status.
+ */
+let SendDocumentForSignatureAction = class SendDocumentForSignatureAction extends BaseSignatureAction {
+    async InternalRunAction(params) {
+        const signatureAccountId = this.getStringParam(params, 'SignatureAccountID');
+        const title = this.getStringParam(params, 'Title');
+        const documents = this.parseDocuments(params);
+        const recipients = this.parseRecipients(params);
+        const artifactId = this.getStringParam(params, 'ArtifactID');
+        const artifactVersionId = this.getStringParam(params, 'ArtifactVersionID');
+        if (!signatureAccountId) {
+            return this.fail('ACCOUNT_NOT_FOUND', "Parameter 'SignatureAccountID' is required.");
+        }
+        if (!title) {
+            return this.fail('PROVIDER_ERROR', "Parameter 'Title' is required.");
+        }
+        // Documents may be supplied inline (base64) OR by reference to an Artifact Version already
+        // in MJ. Require at least one source.
+        if (!documents.length && !artifactVersionId) {
+            return this.fail('MISSING_DOCUMENT', "Provide 'Documents' (each with contentBase64) or an 'ArtifactVersionID' to send a document already in MemberJunction.");
+        }
+        if (!recipients.length) {
+            return this.fail('PROVIDER_ERROR', "Parameter 'Recipients' must contain at least one recipient with an email.");
+        }
+        try {
+            const engine = await this.ensureEngine(params);
+            const result = await engine.SendForSignature({
+                signatureAccountId,
+                title,
+                message: this.getStringParam(params, 'Message'),
+                documents,
+                recipients,
+                artifactId,
+                artifactVersionId,
+                entityId: this.getStringParam(params, 'EntityID'),
+                recordId: this.getStringParam(params, 'RecordID'),
+                sendImmediately: this.getBooleanParam(params, 'SendImmediately', true),
+                metadata: this.getObjectParam(params, 'Metadata'),
+                contextUser: params.ContextUser,
+            });
+            if (!result.Success) {
+                return this.fail('PROVIDER_ERROR', result.ErrorMessage ?? 'Send failed.', params, result.signatureRequestId);
+            }
+            this.addOutput(params, 'SignatureRequestID', result.signatureRequestId);
+            this.addOutput(params, 'ExternalEnvelopeID', result.externalEnvelopeId);
+            this.addOutput(params, 'Status', result.status);
+            const sentImmediately = this.getBooleanParam(params, 'SendImmediately', true);
+            return {
+                Success: true,
+                ResultCode: sentImmediately ? 'SENT' : 'DRAFT_CREATED',
+                Message: `Signature request ${result.signatureRequestId} (${result.status}).`,
+                Params: params.Params,
+            };
+        }
+        catch (e) {
+            return this.fail('PROVIDER_ERROR', e instanceof Error ? e.message : String(e), params);
+        }
+    }
+    parseDocuments(params) {
+        const raw = this.getObjectParam(params, 'Documents');
+        if (!Array.isArray(raw)) {
+            return [];
+        }
+        return raw
+            .filter((d) => d && d.filename && d.contentBase64)
+            .map((d) => ({
+            filename: d.filename,
+            contentType: d.contentType ?? 'application/pdf',
+            bytes: Buffer.from(d.contentBase64, 'base64'),
+        }));
+    }
+    parseRecipients(params) {
+        const raw = this.getObjectParam(params, 'Recipients');
+        if (!Array.isArray(raw)) {
+            return [];
+        }
+        return raw.filter((r) => r && r.email);
+    }
+    fail(resultCode, message, params, signatureRequestId) {
+        if (params && signatureRequestId) {
+            this.addOutput(params, 'SignatureRequestID', signatureRequestId);
+        }
+        return { Success: false, ResultCode: resultCode, Message: message, Params: params?.Params };
+    }
+};
+SendDocumentForSignatureAction = __decorate([
+    RegisterClass(BaseAction, 'Send Document for Signature')
+], SendDocumentForSignatureAction);
+export { SendDocumentForSignatureAction };
+//# sourceMappingURL=send-document-for-signature.action.js.map

package/dist/custom/esignature/send-document-for-signature.action.js.map

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

package/dist/custom/esignature/void-signature-request.action.d.ts

@@ -0,0 +1,15 @@
+import { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+import { BaseSignatureAction } from './base-esignature.action.js';
+/**
+ * Action: "Void Signature Request".
+ *
+ * Voids/cancels an in-flight signature request with a reason. Thin wrapper over
+ * {@link SignatureEngine.Void}.
+ *
+ * Inputs: SignatureRequestID (required), Reason (required).
+ * Outputs: Status.
+ */
+export declare class VoidSignatureRequestAction extends BaseSignatureAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+}
+//# sourceMappingURL=void-signature-request.action.d.ts.map

package/dist/custom/esignature/void-signature-request.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"void-signature-request.action.d.ts","sourceRoot":"","sources":["../../../src/custom/esignature/void-signature-request.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;GAQG;AACH,qBACa,0BAA2B,SAAQ,mBAAmB;cAC/C,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAwB1F"}

package/dist/custom/esignature/void-signature-request.action.js

@@ -0,0 +1,47 @@
+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 { BaseAction } from '@memberjunction/actions';
+import { BaseSignatureAction } from './base-esignature.action.js';
+/**
+ * Action: "Void Signature Request".
+ *
+ * Voids/cancels an in-flight signature request with a reason. Thin wrapper over
+ * {@link SignatureEngine.Void}.
+ *
+ * Inputs: SignatureRequestID (required), Reason (required).
+ * Outputs: Status.
+ */
+let VoidSignatureRequestAction = class VoidSignatureRequestAction extends BaseSignatureAction {
+    async InternalRunAction(params) {
+        const requestId = this.getStringParam(params, 'SignatureRequestID');
+        const reason = this.getStringParam(params, 'Reason');
+        if (!requestId) {
+            return { Success: false, ResultCode: 'PROVIDER_ERROR', Message: "Parameter 'SignatureRequestID' is required." };
+        }
+        if (!reason) {
+            return { Success: false, ResultCode: 'PROVIDER_ERROR', Message: "Parameter 'Reason' is required." };
+        }
+        try {
+            const engine = await this.ensureEngine(params);
+            const result = await engine.Void(requestId, reason, params.ContextUser);
+            if (!result.Success) {
+                return { Success: false, ResultCode: 'PROVIDER_ERROR', Message: result.ErrorMessage ?? 'Void failed.' };
+            }
+            this.addOutput(params, 'Status', 'Voided');
+            return { Success: true, ResultCode: 'VOIDED', Message: 'Signature request voided.', Params: params.Params };
+        }
+        catch (e) {
+            return { Success: false, ResultCode: 'PROVIDER_ERROR', Message: e instanceof Error ? e.message : String(e) };
+        }
+    }
+};
+VoidSignatureRequestAction = __decorate([
+    RegisterClass(BaseAction, 'Void Signature Request')
+], VoidSignatureRequestAction);
+export { VoidSignatureRequestAction };
+//# sourceMappingURL=void-signature-request.action.js.map

package/dist/custom/esignature/void-signature-request.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"void-signature-request.action.js","sourceRoot":"","sources":["../../../src/custom/esignature/void-signature-request.action.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;GAQG;AAEI,IAAM,0BAA0B,GAAhC,MAAM,0BAA2B,SAAQ,mBAAmB;IACrD,KAAK,CAAC,iBAAiB,CAAC,MAAuB;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;QACpH,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;QACxG,CAAC;QAED,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YAExE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,IAAI,cAAc,EAAE,CAAC;YAC5G,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAChH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjH,CAAC;IACL,CAAC;CACJ,CAAA;AAzBY,0BAA0B;IADtC,aAAa,CAAC,UAAU,EAAE,wBAAwB,CAAC;GACvC,0BAA0B,CAyBtC"}

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

@@ -44,6 +44,8 @@ export declare class ScheduledGeocodingAction extends BaseAction {
     private static readonly DEFAULT_MAX_TOTAL;
     /** Page size for RunView pagination — controls how many BaseEntity objects exist simultaneously. */
     private static readonly PAGE_SIZE;
+    /** Indentation prefix for child log lines nested under a group/entity header. */
+    private static readonly INDENT;
     /**
      * Geocoding provider name in effect for the current run. Set at the top of
      * InternalRunAction from the 'GeocodingProvider' action parameter and read
@@ -128,6 +130,9 @@ export declare class ScheduledGeocodingAction extends BaseAction {
      * @param contextUser - User context
      * @param batchSize - Number of concurrent geocoding operations per batch
      * @param existingGeoCodesMap - Optional pre-loaded map passed to GeoCodeSyncService
+     * @param progress - Optional console progress context. When supplied, each batch logs a
+     *   cumulative `records X–Y of Total` line (anchored to `progress.Offset`) instead of a
+     *   per-call `batch N/M` line that resets every page.
      */
     private geocodeBatch;
     /**
@@ -155,6 +160,28 @@ export declare class ScheduledGeocodingAction extends BaseAction {
      * exactly the same contract as a real save event.
      */
     private fireSyntheticSaveEvent;
+    /**
+     * Format an integer with locale thousands separators for console output
+     * (e.g. `2000` → `2,000`). Pinned to `en-US` for deterministic logs.
+     */
+    private fmt;
+    /**
+     * Emit the group header that precedes a single entity's batch lines, e.g.
+     * `📍 Members — 2,000 records with address data`.
+     */
+    private logEntityHeader;
+    /**
+     * Emit one indented, cumulative batch line beneath the entity header, e.g.
+     * `   ✓ records 1,991–2,000 of 2,000 · 10/10  (page 4)`. The range is anchored
+     * to `progress.Offset` so the numbers run continuously across every page.
+     */
+    private logBatchProgress;
+    /**
+     * Emit the indented per-entity completion line, reconciling geocoded vs.
+     * failed vs. already-current against the candidate total, e.g.
+     * `   ✅ Members — 1,974 geocoded, 26 already current`.
+     */
+    private logEntityComplete;
     /**
      * Get the geo address fields (non-lat/lng) for an entity.
      * These are the fields that, when non-null, indicate a record

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

@@ -1 +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;AAWrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBACa,wBAAyB,SAAQ,UAAU;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAM;IAChD,qGAAqG;IACrG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IACnD,oGAAoG;IACpG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAO;IAExC;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB,CAAuB;cAEvC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgDvF;;;;OAIG;YACW,qBAAqB;IA2BnC;;;;;;;;;;OAUG;YACW,uBAAuB;IA+ErC;;;;;;;;;OASG;YACW,oBAAoB;IAwBlC;;;OAGG;YACW,oBAAoB;IA2BlC;;;;OAIG;YACW,oBAAoB;IAkElC;;;OAGG;YACW,kBAAkB;IA6BhC;;;;OAIG;YACW,sBAAsB;IAgDpC;;;;OAIG;YACW,uBAAuB;IAmDrC;;;;;;;;;;;;;;;OAeG;YACW,YAAY;IA2B1B;;;;;;;;;;OAUG;YACW,oBAAoB;IA2BlC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;;;;;;OASG;YACW,uBAAuB;IAoCrC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,cAAc;CAMzB"}
+{"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;AA2BrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBACa,wBAAyB,SAAQ,UAAU;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAM;IAChD,qGAAqG;IACrG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IACnD,oGAAoG;IACpG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAO;IACxC,iFAAiF;IACjF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEvC;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB,CAAuB;cAEvC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgDvF;;;;OAIG;YACW,qBAAqB;IA2BnC;;;;;;;;;;OAUG;YACW,uBAAuB;IAoGrC;;;;;;;;;OASG;YACW,oBAAoB;IAyBlC;;;OAGG;YACW,oBAAoB;IA4BlC;;;;OAIG;YACW,oBAAoB;IAwElC;;;OAGG;YACW,kBAAkB;IA6BhC;;;;OAIG;YACW,sBAAsB;IAgDpC;;;;OAIG;YACW,uBAAuB;IAmDrC;;;;;;;;;;;;;;;;;;OAkBG;YACW,YAAY;IA4B1B;;;;;;;;;;OAUG;YACW,oBAAoB;IA2BlC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;;OAGG;IACH,OAAO,CAAC,GAAG;IAIX;;;OAGG;IACH,OAAO,CAAC,eAAe;IAOvB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;;;;;;OASG;YACW,uBAAuB;IAoCrC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,cAAc;CAMzB"}

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

@@ -69,6 +69,8 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
     static { this.DEFAULT_MAX_TOTAL = 50_000; }
     /** Page size for RunView pagination — controls how many BaseEntity objects exist simultaneously. */
     static { this.PAGE_SIZE = 500; }
+    /** Indentation prefix for child log lines nested under a group/entity header. */
+    static { this.INDENT = '   '; }
     async InternalRunAction(params) {
         const contextUser = params.ContextUser;
         if (!contextUser) {
@@ -79,7 +81,7 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
         const maxTotal = this.getNumericParam(params, 'MaxTotalRecords', ScheduledGeocodingAction_1.DEFAULT_MAX_TOTAL);
         const geocodingProvider = this.getStringParam(params, 'GeocodingProvider');
         this.currentGeocodingProvider = geocodingProvider ?? null;
-        LogStatus(`ScheduledGeocodingAction: Starting maintenance run (BatchSize=${batchSize}, MaxTotal=${maxTotal}, GeocodingProvider=${geocodingProvider ?? 'config-default'})`);
+        LogStatus(`🌍 Scheduled Geocoding — starting (batch ${batchSize} · max ${this.fmt(maxTotal)} · provider ${geocodingProvider ?? 'config-default'})`);
         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, params.Provider);
@@ -94,9 +96,9 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
         stats.OrphansRemoved = await this.cleanupOrphanedRecords(contextUser, batchSize, params.Provider);
         const totalRecordsProcessed = stats.MissingProcessed + stats.RetriesProcessed;
         if (totalRecordsProcessed >= maxTotal) {
-            LogStatus(`ScheduledGeocodingAction: WARNING — MaxTotal limit (${maxTotal}) reached. There may be remaining records for the next run.`);
+            LogStatus(`⚠️  MaxTotal limit (${this.fmt(maxTotal)}) reached — remaining records will be picked up on the next run.`);
         }
-        LogStatus(`ScheduledGeocodingAction: Complete — Missing: ${stats.MissingProcessed} processed (${stats.MissingSuccess} success), Retries: ${stats.RetriesProcessed} (${stats.RetriesSuccess} success), Orphans: ${stats.OrphansRemoved} removed`);
+        LogStatus(`🏁 Scheduled Geocoding — complete · missing ${this.fmt(stats.MissingProcessed)} (${this.fmt(stats.MissingSuccess)} ✓) · retries ${this.fmt(stats.RetriesProcessed)} (${this.fmt(stats.RetriesSuccess)} ✓) · orphans ${this.fmt(stats.OrphansRemoved)} removed`);
         return {
             Success: true,
             ResultCode: 'SUCCESS',
@@ -125,7 +127,7 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
             totalSuccess += entityStats.Success;
         }
         if (totalProcessed > 0) {
-            LogStatus(`ScheduledGeocodingAction: Processed ${totalProcessed} missing records (${totalSuccess} geocoded successfully)`);
+            LogStatus(`✅ Missing-record geocoding complete — ${this.fmt(totalProcessed)} processed, ${this.fmt(totalSuccess)} geocoded`);
         }
         return { Processed: totalProcessed, Success: totalSuccess };
     }
@@ -160,15 +162,23 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
             let totalSuccess = 0;
             let pageOffset = 0; // OFFSET-mode (composite-PK fallback)
             let lastSeenKey; // keyset mode
+            let pageNumber = 0; // 1-based, shown in batch lines
+            let candidateTotal = 0; // denominator: records with address data (from page-1 TotalRowCount)
+            let headerLogged = false; // emit the entity header lazily, only when there's work to do
             // Paginate through entity records to avoid loading all into memory at once.
             // Keyset pagination keeps each page O(log N) regardless of depth — a critical
             // win when the entity has millions of rows. See guides/KEYSET_PAGINATION_GUIDE.md.
             while (totalProcessed < maxRows) {
+                pageNumber++;
                 const pageResult = canUseKeyset
                     ? await this.loadEntityPageKeyset(entityInfo.Name, pkField.Name, nonNullConditions, lastSeenKey, contextUser)
                     : await this.loadEntityPageOffset(entityInfo.Name, nonNullConditions, pageOffset, contextUser);
                 if (!pageResult.Success || pageResult.Results.length === 0)
                     break;
+                // TotalRowCount reports the full count matching the filter regardless of the
+                // keyset seek predicate / page offset, so the first page gives us a stable denominator.
+                if (candidateTotal === 0)
+                    candidateTotal = pageResult.TotalRowCount;
                 const pageEntities = pageResult.Results;
                 // Filter to records missing geocodes (not in existingMap for any LocationType)
                 const missingRecords = pageEntities.filter(entity => {
@@ -179,9 +189,18 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
                     return !existingMap.has(key);
                 });
                 if (missingRecords.length > 0) {
+                    if (!headerLogged) {
+                        this.logEntityHeader(entityInfo, candidateTotal);
+                        headerLogged = true;
+                    }
                     const budget = maxRows - totalProcessed;
                     const toProcess = missingRecords.slice(0, budget);
-                    const stats = await this.geocodeBatch(toProcess, entityInfo, contextUser, batchSize, existingMap);
+                    const stats = await this.geocodeBatch(toProcess, entityInfo, contextUser, batchSize, existingMap, {
+                        Label: entityInfo.Name,
+                        Total: candidateTotal,
+                        Offset: totalProcessed,
+                        Page: pageNumber
+                    });
                     totalProcessed += stats.Processed;
                     totalSuccess += stats.Success;
                 }
@@ -200,6 +219,9 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
                     pageOffset += ScheduledGeocodingAction_1.PAGE_SIZE;
                 }
             }
+            if (headerLogged) {
+                this.logEntityComplete(entityInfo, totalProcessed, totalSuccess, candidateTotal);
+            }
             return { Processed: totalProcessed, Success: totalSuccess };
         }
         catch (e) {
@@ -231,7 +253,8 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
         }, contextUser);
         return {
             Success: result.Success,
-            Results: result.Success ? result.Results : []
+            Results: result.Success ? result.Results : [],
+            TotalRowCount: result.Success ? result.TotalRowCount : 0
         };
     }
     /**
@@ -251,7 +274,8 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
         }, contextUser);
         return {
             Success: result.Success,
-            Results: result.Success ? result.Results : []
+            Results: result.Success ? result.Results : [],
+            TotalRowCount: result.Success ? result.TotalRowCount : 0
         };
     }
     // ================================================================
@@ -270,6 +294,7 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
         let totalProcessed = 0;
         let totalSuccess = 0;
         let pageOffset = 0;
+        let retryTotal = 0; // denominator: total failed-and-retriable rows (from page-1 TotalRowCount)
         while (totalProcessed < maxTotal) {
             const pageResult = await rv.RunView({
                 EntityName: 'MJ: Record Geo Codes',
@@ -285,7 +310,8 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
             const budget = maxTotal - totalProcessed;
             const records = pageResult.Results.slice(0, budget);
             if (totalProcessed === 0) {
-                LogStatus(`ScheduledGeocodingAction: Processing failed records for retry`);
+                retryTotal = Math.min(pageResult.TotalRowCount, maxTotal);
+                LogStatus(`🔁 Retrying failed geocodes — ${this.fmt(retryTotal)} pending`);
             }
             // Group by entity for efficient processing
             const byEntity = new Map();
@@ -305,7 +331,11 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
                 const entities = await this.loadSourceEntities(geoRecords, entityInfo, contextUser, provider);
                 if (entities.length === 0)
                     continue;
-                const stats = await this.geocodeBatch(entities, entityInfo, contextUser, batchSize);
+                const stats = await this.geocodeBatch(entities, entityInfo, contextUser, batchSize, undefined, {
+                    Label: entityInfo.Name,
+                    Total: retryTotal,
+                    Offset: totalProcessed
+                });
                 totalProcessed += stats.Processed;
                 totalSuccess += stats.Success;
             }
@@ -418,7 +448,7 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
             hasMore = orphans.length >= ScheduledGeocodingAction_1.PAGE_SIZE;
         }
         if (entityRemoved > 0) {
-            LogStatus(`ScheduledGeocodingAction: Removed ${entityRemoved} orphaned geo records for ${entityInfo.Name}`);
+            LogStatus(`🧹 ${entityInfo.Name} — removed ${this.fmt(entityRemoved)} orphaned geo records`);
         }
         return entityRemoved;
     }
@@ -440,16 +470,19 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
      * @param contextUser - User context
      * @param batchSize - Number of concurrent geocoding operations per batch
      * @param existingGeoCodesMap - Optional pre-loaded map passed to GeoCodeSyncService
+     * @param progress - Optional console progress context. When supplied, each batch logs a
+     *   cumulative `records X–Y of Total` line (anchored to `progress.Offset`) instead of a
+     *   per-call `batch N/M` line that resets every page.
      */
-    async geocodeBatch(entities, entityInfo, contextUser, batchSize, existingGeoCodesMap) {
+    async geocodeBatch(entities, entityInfo, contextUser, batchSize, existingGeoCodesMap, progress) {
         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, existingGeoCodesMap)));
             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`);
+            if (progress) {
+                this.logBatchProgress(progress, i, batch.length, batchSuccess);
             }
         }
         return { Processed: entities.length, Success: totalSuccess };
@@ -513,6 +546,56 @@ let ScheduledGeocodingAction = class ScheduledGeocodingAction extends BaseAction
         });
     }
     // ================================================================
+    // Console UX helpers
+    // ================================================================
+    /**
+     * Format an integer with locale thousands separators for console output
+     * (e.g. `2000` → `2,000`). Pinned to `en-US` for deterministic logs.
+     */
+    fmt(n) {
+        return n.toLocaleString('en-US');
+    }
+    /**
+     * Emit the group header that precedes a single entity's batch lines, e.g.
+     * `📍 Members — 2,000 records with address data`.
+     */
+    logEntityHeader(entityInfo, candidateTotal) {
+        const scope = candidateTotal > 0
+            ? `${this.fmt(candidateTotal)} records with address data`
+            : 'records with address data';
+        LogStatus(`📍 ${entityInfo.Name} — ${scope}`);
+    }
+    /**
+     * Emit one indented, cumulative batch line beneath the entity header, e.g.
+     * `   ✓ records 1,991–2,000 of 2,000 · 10/10  (page 4)`. The range is anchored
+     * to `progress.Offset` so the numbers run continuously across every page.
+     */
+    logBatchProgress(progress, localIndex, batchCount, batchSuccess) {
+        const start = progress.Offset + localIndex + 1;
+        const end = progress.Offset + localIndex + batchCount;
+        const total = progress.Total > 0 ? this.fmt(progress.Total) : '?';
+        const allOk = batchSuccess === batchCount;
+        const icon = allOk ? '✓' : '⚠';
+        const failNote = allOk ? '' : ` · ${this.fmt(batchCount - batchSuccess)} failed`;
+        const pageNote = progress.Page != null ? `  (page ${progress.Page})` : '';
+        LogStatus(`${ScheduledGeocodingAction_1.INDENT}${icon} records ${this.fmt(start)}–${this.fmt(end)} of ${total} · ${batchSuccess}/${batchCount}${failNote}${pageNote}`);
+    }
+    /**
+     * Emit the indented per-entity completion line, reconciling geocoded vs.
+     * failed vs. already-current against the candidate total, e.g.
+     * `   ✅ Members — 1,974 geocoded, 26 already current`.
+     */
+    logEntityComplete(entityInfo, processed, success, candidateTotal) {
+        const failed = processed - success;
+        const alreadyCurrent = candidateTotal > 0 ? Math.max(0, candidateTotal - processed) : 0;
+        const parts = [`${this.fmt(success)} geocoded`];
+        if (failed > 0)
+            parts.push(`${this.fmt(failed)} failed`);
+        if (alreadyCurrent > 0)
+            parts.push(`${this.fmt(alreadyCurrent)} already current`);
+        LogStatus(`${ScheduledGeocodingAction_1.INDENT}✅ ${entityInfo.Name} — ${parts.join(', ')}`);
+    }
+    // ================================================================
     // Helpers
     // ================================================================
     /**