@memberjunction/integration-actions

MJ Actions for triggering MemberJunction integration syncs. Connects the Integration Engine to the MJ Actions + Scheduling system.

Installation

This package is registered as a workspace package. Add it as a dependency and import it so the @RegisterClass decorator fires:

// In your bootstrap or entry point:
import '@memberjunction/integration-actions';

Actions

Run Integration Sync

Action Name: Run Integration Sync

Triggers a full sync run for a MJ: Company Integration record.

| Parameter | Direction | Type | Required | Description | |-----------|-----------|------|----------|-------------| | CompanyIntegrationID | Input | string | Yes | ID of the CompanyIntegration to sync | | TriggerType | Input | string | No | Manual, Scheduled, or Webhook (default: Manual) | | RecordsProcessed | Output | number | — | Total records processed | | RecordsCreated | Output | number | — | Records created in MJ | | RecordsUpdated | Output | number | — | Records updated in MJ | | RecordsDeleted | Output | number | — | Records deleted in MJ | | RecordsErrored | Output | number | — | Records that encountered errors | | RecordsSkipped | Output | number | — | Records that were skipped | | ErrorSummary | Output | string | — | JSON array of first 10 errors (only when errors exist) |

Result Codes:

• SUCCESS — Sync completed without errors
• SYNC_COMPLETED_WITH_ERRORS — Sync completed but some records failed
• MISSING_PARAMETER — Required CompanyIntegrationID not provided
• UNEXPECTED_ERROR — Unhandled exception during sync

Scheduling via MJ Scheduler

1. Create an MJ: Actions record for Run Integration Sync
2. Create an MJ: Action Params record for CompanyIntegrationID
3. Set up a Scheduled Job pointing to this action
4. The scheduler calls the action on the configured cadence

Usage from Code

import '@memberjunction/integration-actions'; // ensure registration
import { ActionEngine } from '@memberjunction/actions';

const engine = ActionEngine.Instance;
const result = await engine.RunAction({
    ActionName: 'Run Integration Sync',
    ContextUser: currentUser,
    Params: [
        { Name: 'CompanyIntegrationID', Type: 'Input', Value: 'your-ci-id' },
        { Name: 'TriggerType', Type: 'Input', Value: 'Scheduled' },
    ],
});

Direct Orchestrator Usage

For server-side code that doesn't go through the Actions system:

import { IntegrationOrchestrator } from '@memberjunction/integration-engine';

const orchestrator = new IntegrationOrchestrator();
const result = await orchestrator.RunSync(
    companyIntegrationID,
    contextUser,
    'Manual',
    (progress) => console.log(`${progress.PercentComplete}%`),
    (notification) => console.log(notification.Subject)
);