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/platform-events/event-publisher.cls

View on GitHub
/**
 * @description Platform Event Publisher for {{EventName}}__e
 *
 * Use Case: Publish events from Apex
 * - Trigger-based event publishing
 * - Service layer event notifications
 * - Batch job completion events
 *
 * Features:
 * - Single and bulk event publishing
 * - Error handling and logging
 * - Partial success handling for bulk publishes
 *
 * @author {{Author}}
 * @date {{Date}}
 */
public with sharing class {{EventName}}Publisher {

    /**
     * @description Publish a single event
     * @param recordId ID of the triggering record
     * @param operation Operation type (CREATE, UPDATE, DELETE)
     * @param payload JSON payload data
     * @throws EventPublishException if publish fails
     */
    public static void publishEvent(Id recordId, String operation, Map<String, Object> payload) {
        {{EventName}}__e event = new {{EventName}}__e();
        event.Record_Id__c = recordId;
        event.Operation__c = operation;
        event.Payload__c = JSON.serialize(payload);
        event.Correlation_Id__c = generateCorrelationId();
        event.Event_Timestamp__c = Datetime.now();

        Database.SaveResult result = EventBus.publish(event);

        if (!result.isSuccess()) {
            String errorMessage = getErrorMessage(result);
            System.debug(LoggingLevel.ERROR, 'Event publish failed: ' + errorMessage);
            throw new EventPublishException('Failed to publish event: ' + errorMessage);
        }

        System.debug(LoggingLevel.DEBUG, 'Event published successfully. Correlation ID: ' + event.Correlation_Id__c);
    }

    /**
     * @description Publish multiple events in bulk
     * @param events List of events to publish
     * @return List of publish results
     */
    public static List<PublishResult> publishEvents(List<{{EventName}}__e> events) {
        if (events == null || events.isEmpty()) {
            return new List<PublishResult>();
        }

        // Ensure correlation IDs and timestamps
        for ({{EventName}}__e event : events) {
            if (String.isBlank(event.Correlation_Id__c)) {
                event.Correlation_Id__c = generateCorrelationId();
            }
            if (event.Event_Timestamp__c == null) {
                event.Event_Timestamp__c = Datetime.now();
            }
        }

        List<Database.SaveResult> results = EventBus.publish(events);

        List<PublishResult> publishResults = new List<PublishResult>();
        for (Integer i = 0; i < results.size(); i++) {
            Database.SaveResult sr = results[i];
            {{EventName}}__e event = events[i];

            PublishResult pr = new PublishResult();
            pr.correlationId = event.Correlation_Id__c;
            pr.success = sr.isSuccess();

            if (!sr.isSuccess()) {
                pr.errorMessage = getErrorMessage(sr);
                System.debug(LoggingLevel.ERROR,
                    'Event publish failed for correlation ' + pr.correlationId + ': ' + pr.errorMessage);
            }

            publishResults.add(pr);
        }

        return publishResults;
    }

    /**
     * @description Publish events for record changes (use in triggers)
     * @param records Changed records
     * @param operation Operation type
     */
    public static void publishForRecords(List<SObject> records, String operation) {
        if (records == null || records.isEmpty()) {
            return;
        }

        List<{{EventName}}__e> events = new List<{{EventName}}__e>();

        for (SObject record : records) {
            {{EventName}}__e event = new {{EventName}}__e();
            event.Record_Id__c = record.Id;
            event.Operation__c = operation;
            event.Payload__c = JSON.serialize(record);
            event.Correlation_Id__c = generateCorrelationId();
            event.Event_Timestamp__c = Datetime.now();
            events.add(event);
        }

        List<PublishResult> results = publishEvents(events);

        // Log any failures
        for (PublishResult pr : results) {
            if (!pr.success) {
                System.debug(LoggingLevel.ERROR, 'Publish failed: ' + pr.errorMessage);
            }
        }
    }

    /**
     * @description Create event from Map (flexible payload)
     * @param eventData Map containing event fields
     * @return Constructed event
     */
    public static {{EventName}}__e createEvent(Map<String, Object> eventData) {
        {{EventName}}__e event = new {{EventName}}__e();

        if (eventData.containsKey('recordId')) {
            event.Record_Id__c = (String) eventData.get('recordId');
        }
        if (eventData.containsKey('operation')) {
            event.Operation__c = (String) eventData.get('operation');
        }
        if (eventData.containsKey('payload')) {
            Object payload = eventData.get('payload');
            event.Payload__c = payload instanceof String
                ? (String) payload
                : JSON.serialize(payload);
        }
        if (eventData.containsKey('correlationId')) {
            event.Correlation_Id__c = (String) eventData.get('correlationId');
        } else {
            event.Correlation_Id__c = generateCorrelationId();
        }

        event.Event_Timestamp__c = Datetime.now();

        return event;
    }

    /**
     * @description Generate unique correlation ID
     * @return UUID-like correlation ID
     */
    private static String generateCorrelationId() {
        Blob b = Crypto.generateAesKey(128);
        String h = EncodingUtil.convertToHex(b);
        return h.substring(0, 8) + '-' +
               h.substring(8, 12) + '-' +
               h.substring(12, 16) + '-' +
               h.substring(16, 20) + '-' +
               h.substring(20);
    }

    /**
     * @description Extract error message from SaveResult
     * @param result Database.SaveResult
     * @return Error message string
     */
    private static String getErrorMessage(Database.SaveResult result) {
        List<String> messages = new List<String>();
        for (Database.Error err : result.getErrors()) {
            messages.add(err.getStatusCode() + ': ' + err.getMessage());
        }
        return String.join(messages, '; ');
    }

    /**
     * @description Result wrapper for bulk publish operations
     */
    public class PublishResult {
        public String correlationId;
        public Boolean success;
        public String errorMessage;
    }

    /**
     * @description Exception for event publish failures
     */
    public class EventPublishException extends Exception {}
}
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: 472kUpdated 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