Skip to content

forcedotcom/sf-skills / plugins/builder/integration/skills/integration-connectivity-generate

integration-connectivity-generate

Verified

Salesforce integration architecture and runtime plumbing with 120-point scoring. Use this skill to set up Named Credentials, External Credentials, External Services, REST/SOAP callout patterns, Platform Events, and Change Data Capture. TRIGGER when: user sets up Named Credentials, External Services, REST/SOAP callouts, Platform Events, CDC, or touches .namedCredential-meta.xml files. DO NOT TRIGGER when: Connected App/OAuth config (use integration-connectivity-connected-app-configure), Apex-only logic (use platform-apex-generate), data import/export (use platform-data-manage), or CDC channel-membership metadata such as PlatformEventChannel, PlatformEventChannelMember, or EnrichedField (use integration-eventing-cdc-configure).

FileKindSize
README.mdmarkdown3.5 KB
SKILL.mdskill md8.8 KB
assets/callouts/callout-retry-handler.clsother6.0 KB
assets/callouts/http-response-handler.clsother8.5 KB
assets/callouts/rest-queueable-callout.clsother8.8 KB
assets/callouts/rest-sync-callout.clsother7.4 KB
assets/cdc/cdc-handler.clsother8.4 KB
assets/cdc/cdc-subscriber-trigger.triggerother5.3 KB
assets/endpoint-security/example.cspTrustedSite-meta.xmlconfig1.8 KB
assets/endpoint-security/example.remoteSite-meta.xmlconfig1.3 KB
assets/external-credentials/jwt-external-credential.externalCredential-meta.xmlconfig3.2 KB
assets/external-credentials/oauth-external-credential.externalCredential-meta.xmlconfig3.0 KB
assets/external-services/external-service-operations.mdmarkdown5.5 KB
assets/external-services/openapi-registration.externalServiceRegistration-meta.xmlconfig4.8 KB
assets/named-credentials/certificate-auth.namedCredential-meta.xmlconfig2.2 KB
assets/named-credentials/custom-auth.namedCredential-meta.xmlconfig2.2 KB
assets/named-credentials/oauth-client-credentials.namedCredential-meta.xmlconfig1.8 KB
assets/named-credentials/oauth-jwt-bearer.namedCredential-meta.xmlconfig2.2 KB
assets/platform-events/event-publisher.clsother6.4 KB
assets/platform-events/event-subscriber-action.clsother9.5 KB
assets/platform-events/event-subscriber-trigger.triggerother3.9 KB
assets/platform-events/platform-event-definition.object-meta.xmlconfig3.7 KB
assets/soap/soap-callout-service.clsother6.4 KB
assets/soap/wsdl2apex-guide.mdmarkdown6.2 KB
references/callout-patterns.mdmarkdown21.8 KB
references/cdc-guide.mdmarkdown8.2 KB
references/cli-reference.mdmarkdown2.9 KB
references/event-driven-architecture-guide.mdmarkdown10.1 KB
references/event-patterns.mdmarkdown27.2 KB
references/external-services-guide.mdmarkdown8.4 KB
references/messaging-api-v2.mdmarkdown17.9 KB
references/named-credentials-automation.mdmarkdown6.2 KB
references/named-credentials-guide.mdmarkdown7.1 KB
references/platform-events-guide.mdmarkdown6.6 KB
references/rest-callout-patterns.mdmarkdown8.8 KB
references/scoring-rubric.mdmarkdown2.4 KB
references/security-best-practices.mdmarkdown5.9 KB
scripts/README.mdmarkdown2.9 KB
scripts/configure-named-credential.shexecutablescript9.2 KB
scripts/set-api-credential.shexecutablescript4.9 KB
scripts/suggest_credential_setup.pyscript9.3 KB
scripts/templates/setup-credentials-with-csp.shexecutablescript5.9 KB
scripts/validate_integration.pyscript13.4 KB

assets/cdc/cdc-subscriber-trigger.trigger

View on GitHub
/**
 * @description Change Data Capture (CDC) Subscriber Trigger for {{ObjectName}}
 *
 * Use Case: React to data changes in near real-time
 * - Sync data to external systems
 * - Audit logging
 * - Cache invalidation
 * - Event-driven integrations
 *
 * CDC Channel Name: {{ObjectName}}ChangeEvent
 * - Standard objects: AccountChangeEvent, ContactChangeEvent, etc.
 * - Custom objects: MyObject__ChangeEvent (append "ChangeEvent" to API name)
 *
 * Key Concepts:
 * - ChangeEventHeader contains metadata (changeType, changedFields, recordIds)
 * - Event contains changed field values (nulls for unchanged fields)
 * - Supports CREATE, UPDATE, DELETE, UNDELETE change types
 * - Gap events indicate missed events (handle replay)
 *
 * IMPORTANT:
 * - Enable CDC for object in Setup → Integrations → Change Data Capture
 * - Triggers fire in separate transaction from DML
 * - Events are retained for 3 days (replay window)
 *
 * @author {{Author}}
 * @date {{Date}}
 */
trigger {{ObjectName}}CDCSubscriber on {{ObjectName}}ChangeEvent (after insert) {

    // Track replay ID for checkpoint
    String lastReplayId = '';

    for ({{ObjectName}}ChangeEvent event : Trigger.new) {
        // Store replay ID
        lastReplayId = event.ReplayId;

        // Get change event header (metadata about the change)
        EventBus.ChangeEventHeader header = event.ChangeEventHeader;

        // Extract header information
        String changeType = header.getChangeType();
        List<String> changedFields = header.getChangedFields();
        List<String> recordIds = header.getRecordIds();
        String entityName = header.getEntityName();
        Long commitNumber = header.getCommitNumber();
        Datetime commitTimestamp = header.getCommitTimestamp();
        String transactionKey = header.getTransactionKey();

        // Log event details
        System.debug(LoggingLevel.DEBUG,
            'CDC Event - Type: ' + changeType +
            ', Entity: ' + entityName +
            ', Records: ' + recordIds +
            ', Changed Fields: ' + changedFields);

        try {
            // Route based on change type
            switch on changeType {
                when 'CREATE' {
                    {{ObjectName}}CDCHandler.handleCreate(event, header);
                }
                when 'UPDATE' {
                    {{ObjectName}}CDCHandler.handleUpdate(event, header, changedFields);
                }
                when 'DELETE' {
                    {{ObjectName}}CDCHandler.handleDelete(recordIds, header);
                }
                when 'UNDELETE' {
                    {{ObjectName}}CDCHandler.handleUndelete(event, header);
                }
                when 'GAP_CREATE', 'GAP_UPDATE', 'GAP_DELETE', 'GAP_UNDELETE' {
                    // Gap events indicate missed events
                    // Should trigger full sync for affected records
                    System.debug(LoggingLevel.WARN,
                        'GAP event detected - some events may have been missed. ' +
                        'Type: ' + changeType + ', Records: ' + recordIds);
                    {{ObjectName}}CDCHandler.handleGap(recordIds, changeType);
                }
                when 'GAP_OVERFLOW' {
                    // Too many changes to track - full sync needed
                    System.debug(LoggingLevel.ERROR,
                        'GAP_OVERFLOW - full sync required for ' + entityName);
                    {{ObjectName}}CDCHandler.handleOverflow(entityName);
                }
            }

        } catch (Exception e) {
            // Log error but continue processing
            System.debug(LoggingLevel.ERROR,
                'CDC processing error for ' + recordIds + ': ' + e.getMessage());
            System.debug(LoggingLevel.ERROR, 'Stack: ' + e.getStackTraceString());
        }
    }

    // Set resume checkpoint for durability
    if (String.isNotBlank(lastReplayId)) {
        EventBus.TriggerContext.currentContext().setResumeCheckpoint(lastReplayId);
    }
}

/*
 * ============================================================================
 * CDC TRIGGER BEST PRACTICES
 * ============================================================================
 *
 * 1. ENABLE CDC FOR OBJECT
 *    Setup → Integrations → Change Data Capture → Select Objects
 *
 * 2. HANDLE ALL CHANGE TYPES
 *    - CREATE: New record
 *    - UPDATE: Record modified
 *    - DELETE: Record deleted
 *    - UNDELETE: Record restored from recycle bin
 *    - GAP_*: Events were missed (sync required)
 *    - GAP_OVERFLOW: Too many changes (full sync needed)
 *
 * 3. USE CHANGEDEVENTHEAD FOR METADATA
 *    - getChangeType(): Operation type
 *    - getChangedFields(): List of changed field API names
 *    - getRecordIds(): Affected record IDs
 *    - getCommitTimestamp(): When change occurred
 *
 * 4. FIELD VALUES IN EVENT
 *    - Changed fields have new values
 *    - Unchanged fields are NULL
 *    - Use changedFields list to know what changed
 *
 * 5. IDEMPOTENT HANDLERS
 *    - Same event might fire multiple times
 *    - Use transactionKey to detect duplicates
 *    - Design handlers to be safe for replay
 *
 * 6. BULK CONSIDERATIONS
 *    - Multiple records can be in single event (batch DML)
 *    - Use getRecordIds() to get all affected IDs
 *    - Process all record IDs efficiently
 *
 * ============================================================================
 */
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall