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/callouts/rest-sync-callout.cls

View on GitHub
/**
 * @description Synchronous REST Callout Service for {{ServiceName}}
 *
 * Use Case: Real-time API calls where immediate response is needed
 * - User-initiated actions requiring feedback
 * - API calls NOT triggered from DML operations
 *
 * IMPORTANT: Do NOT use synchronous callouts from triggers or DML contexts.
 *            Use rest-queueable-callout.cls template instead.
 *
 * @author {{Author}}
 * @date {{Date}}
 */
public with sharing class {{ServiceName}}Callout {

    // Named Credential reference (configured in Setup)
    private static final String NAMED_CREDENTIAL = 'callout:{{NamedCredentialName}}';

    // Default timeout (max 120000 ms = 120 seconds)
    private static final Integer DEFAULT_TIMEOUT = 120000;

    /**
     * @description Make HTTP request to external API
     * @param method HTTP method (GET, POST, PUT, PATCH, DELETE)
     * @param endpoint API endpoint path (appended to Named Credential base URL)
     * @param body Request body (null for GET/DELETE)
     * @return HttpResponse from external API
     */
    public static HttpResponse makeRequest(String method, String endpoint, String body) {
        HttpRequest req = new HttpRequest();
        req.setEndpoint(NAMED_CREDENTIAL + endpoint);
        req.setMethod(method);
        req.setHeader('Content-Type', 'application/json');
        req.setHeader('Accept', 'application/json');
        req.setTimeout(DEFAULT_TIMEOUT);

        if (String.isNotBlank(body) && (method == 'POST' || method == 'PUT' || method == 'PATCH')) {
            req.setBody(body);
        }

        Http http = new Http();
        return http.send(req);
    }

    /**
     * @description GET request
     * @param endpoint API endpoint path
     * @return Parsed response as Map
     */
    public static Map<String, Object> get(String endpoint) {
        HttpResponse res = makeRequest('GET', endpoint, null);
        return handleResponse(res);
    }

    /**
     * @description GET request with query parameters
     * @param endpoint API endpoint path
     * @param params Query parameters
     * @return Parsed response as Map
     */
    public static Map<String, Object> get(String endpoint, Map<String, String> params) {
        String queryString = buildQueryString(params);
        String fullEndpoint = String.isNotBlank(queryString)
            ? endpoint + '?' + queryString
            : endpoint;
        return get(fullEndpoint);
    }

    /**
     * @description POST request
     * @param endpoint API endpoint path
     * @param payload Request body as Map
     * @return Parsed response as Map
     */
    public static Map<String, Object> post(String endpoint, Map<String, Object> payload) {
        HttpResponse res = makeRequest('POST', endpoint, JSON.serialize(payload));
        return handleResponse(res);
    }

    /**
     * @description PUT request (full resource update)
     * @param endpoint API endpoint path
     * @param payload Request body as Map
     * @return Parsed response as Map
     */
    public static Map<String, Object> put(String endpoint, Map<String, Object> payload) {
        HttpResponse res = makeRequest('PUT', endpoint, JSON.serialize(payload));
        return handleResponse(res);
    }

    /**
     * @description PATCH request (partial resource update)
     * @param endpoint API endpoint path
     * @param payload Request body as Map
     * @return Parsed response as Map
     */
    public static Map<String, Object> patch(String endpoint, Map<String, Object> payload) {
        HttpResponse res = makeRequest('PATCH', endpoint, JSON.serialize(payload));
        return handleResponse(res);
    }

    /**
     * @description DELETE request
     * @param endpoint API endpoint path
     * @return Parsed response as Map (may be empty for 204)
     */
    public static Map<String, Object> del(String endpoint) {
        HttpResponse res = makeRequest('DELETE', endpoint, null);
        return handleResponse(res);
    }

    /**
     * @description Handle HTTP response and parse JSON
     * @param res HttpResponse from callout
     * @return Parsed response as Map
     * @throws CalloutException for error status codes
     */
    private static Map<String, Object> handleResponse(HttpResponse res) {
        Integer statusCode = res.getStatusCode();
        String responseBody = res.getBody();

        // Log for debugging (consider removing in production or use custom logging)
        System.debug(LoggingLevel.DEBUG, 'Response Status: ' + statusCode);
        System.debug(LoggingLevel.DEBUG, 'Response Body: ' + responseBody);

        // Success (2xx)
        if (statusCode >= 200 && statusCode < 300) {
            if (String.isBlank(responseBody) || statusCode == 204) {
                return new Map<String, Object>();
            }
            return (Map<String, Object>) JSON.deserializeUntyped(responseBody);
        }

        // Client Error (4xx)
        if (statusCode >= 400 && statusCode < 500) {
            String errorMessage = parseErrorMessage(responseBody);
            throw new ClientException('Client Error (' + statusCode + '): ' + errorMessage);
        }

        // Server Error (5xx)
        if (statusCode >= 500) {
            throw new ServerException('Server Error (' + statusCode + '): ' + responseBody);
        }

        // Unexpected status
        throw new CalloutException('Unexpected status code: ' + statusCode);
    }

    /**
     * @description Parse error message from response body
     * @param responseBody Raw response body
     * @return Error message string
     */
    private static String parseErrorMessage(String responseBody) {
        try {
            Map<String, Object> errorResponse = (Map<String, Object>) JSON.deserializeUntyped(responseBody);

            // Common error message field names
            if (errorResponse.containsKey('error')) {
                Object error = errorResponse.get('error');
                if (error instanceof String) {
                    return (String) error;
                } else if (error instanceof Map<String, Object>) {
                    Map<String, Object> errorObj = (Map<String, Object>) error;
                    return (String) errorObj.get('message');
                }
            }
            if (errorResponse.containsKey('message')) {
                return (String) errorResponse.get('message');
            }
            if (errorResponse.containsKey('errors')) {
                return JSON.serialize(errorResponse.get('errors'));
            }

            return responseBody;
        } catch (Exception e) {
            return responseBody;
        }
    }

    /**
     * @description Build URL query string from parameters
     * @param params Map of query parameters
     * @return Encoded query string
     */
    private static String buildQueryString(Map<String, String> params) {
        if (params == null || params.isEmpty()) {
            return '';
        }

        List<String> pairs = new List<String>();
        for (String key : params.keySet()) {
            String value = params.get(key);
            if (String.isNotBlank(value)) {
                pairs.add(EncodingUtil.urlEncode(key, 'UTF-8') + '=' +
                          EncodingUtil.urlEncode(value, 'UTF-8'));
            }
        }
        return String.join(pairs, '&');
    }

    /**
     * @description Client error (4xx) exception
     */
    public class ClientException extends Exception {}

    /**
     * @description Server error (5xx) exception
     */
    public class ServerException 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