@salesforce/afv-skills 1.22.0 → 1.24.0

package/skills/generating-apex/assets/domain.cls

@@ -1,101 +0,0 @@
-/**
- * Domain class for {SObject}.
- *              Encapsulates field-level defaults, derivations, and validations.
- *              Operates only on in-memory SObject data — no SOQL or DML.
- */
-public with sharing class {SObject}Domain {
-
-    // ─── Constants ───────────────────────────────────────────────────────
-    // TODO: Add constants for default values, statuses, etc.
-
-    // ─── Field Defaults ──────────────────────────────────────────────────
-
-    /**
-     * Applies default field values to new {SObject} records.
-     *              Call this before insert to ensure consistent defaults.
-     * @param records List of {SObject} records to apply defaults to
-     */
-    public static void applyDefaults(List<{SObject}> records) {
-        if (records == null || records.isEmpty()) {
-            return;
-        }
-
-        for ({SObject} record : records) {
-            // TODO: Set default field values
-            // Example:
-            // if (record.Status__c == null) {
-            //     record.Status__c = DEFAULT_STATUS;
-            // }
-        }
-    }
-
-    // ─── Derivations ────────────────────────────────────────────────────
-
-    /**
-     * Derives calculated field values based on other fields.
-     *              Call this before insert and before update.
-     * @param records List of {SObject} records to derive values for
-     */
-    public static void deriveFields(List<{SObject}> records) {
-        if (records == null || records.isEmpty()) {
-            return;
-        }
-
-        for ({SObject} record : records) {
-            // TODO: Derive calculated field values
-            // Example:
-            // record.FullAddress__c = buildFullAddress(record);
-        }
-    }
-
-    // ─── Validations ────────────────────────────────────────────────────
-
-    /**
-     * Validates {SObject} records and adds errors for any violations.
-     *              Call this before insert and before update.
-     * @param records List of {SObject} records to validate
-     */
-    public static void validate(List<{SObject}> records) {
-        if (records == null || records.isEmpty()) {
-            return;
-        }
-
-        for ({SObject} record : records) {
-            // TODO: Add validation rules
-            // Example:
-            // if (String.isBlank(record.Name)) {
-            //     record.addError('Name is required.');
-            // }
-        }
-    }
-
-    // ─── Comparisons ────────────────────────────────────────────────────
-
-    /**
-     * Determines which fields have changed between old and new record versions.
-     *              Useful in before update context.
-     * @param oldRecord The previous version of the record
-     * @param newRecord The current version of the record
-     * @return Set of field API names that have changed
-     */
-    public static Set<String> getChangedFields({SObject} oldRecord, {SObject} newRecord) {
-        Set<String> changedFields = new Set<String>();
-
-        if (oldRecord == null || newRecord == null) {
-            return changedFields;
-        }
-
-        Map<String, Schema.SObjectField> fieldMap = Schema.SObjectType.{SObject}.fields.getMap();
-        for (String fieldName : fieldMap.keySet()) {
-            if (oldRecord.get(fieldName) != newRecord.get(fieldName)) {
-                changedFields.add(fieldName);
-            }
-        }
-
-        return changedFields;
-    }
-
-    // ─── Private Helpers ─────────────────────────────────────────────────
-
-    // TODO: Add private helper methods as needed
-}

package/skills/generating-apex/assets/dto.cls

@@ -1,107 +0,0 @@
-/**
- * Data Transfer Object for {describe the data this DTO represents}.
- *              Used to pass structured data between layers without exposing SObjects.
- *              Serialization-friendly for use with JSON.serialize/deserialize and API responses.
- *
- * @example
- * // Create from constructor
- * {ClassName} dto = new {ClassName}('value1', 42);
- *
- * // Deserialize from JSON
- * {ClassName} dto = ({ClassName}) JSON.deserialize(jsonString, {ClassName}.class);
- */
-public with sharing class {ClassName} {
-
-    // ─── Properties ──────────────────────────────────────────────────────
-
-    /** {Describe this property} */
-    public String name { get; set; }
-
-    /** {Describe this property} */
-    public Id recordId { get; set; }
-
-    /** {Describe this property} */
-    public Boolean isActive { get; set; }
-
-    /** {Describe this property} */
-    public List<String> tags { get; set; }
-
-    // TODO: Add additional properties as needed
-
-    // ─── Constructors ────────────────────────────────────────────────────
-
-    /**
-     * No-arg constructor for deserialization compatibility
-     */
-    public {ClassName}() {
-        this.tags = new List<String>();
-        this.isActive = false;
-    }
-
-    /**
-     * Parameterized constructor for convenience
-     * @param name The name value
-     * @param recordId The associated record Id
-     */
-    public {ClassName}(String name, Id recordId) {
-        this();
-        this.name = name;
-        this.recordId = recordId;
-    }
-
-    // ─── Factory Methods ─────────────────────────────────────────────────
-
-    /**
-     * Creates a DTO instance from an SObject record
-     * @param record The source {SObject} record
-     * @return A populated {ClassName} instance
-     */
-    public static {ClassName} fromSObject(SObject record) {
-        if (record == null) {
-            return new {ClassName}();
-        }
-
-        {ClassName} dto = new {ClassName}();
-        dto.recordId = record.Id;
-        dto.name = (String) record.get('Name');
-        // TODO: Map additional fields
-
-        return dto;
-    }
-
-    /**
-     * Creates a list of DTOs from a list of SObject records
-     * @param records The source records
-     * @return List of populated {ClassName} instances
-     */
-    public static List<{ClassName}> fromSObjects(List<SObject> records) {
-        List<{ClassName}> dtos = new List<{ClassName}>();
-        if (records == null) {
-            return dtos;
-        }
-
-        for (SObject record : records) {
-            dtos.add(fromSObject(record));
-        }
-        return dtos;
-    }
-
-    // ─── Utility Methods ─────────────────────────────────────────────────
-
-    /**
-     * Serializes this DTO to a JSON string
-     * @return JSON representation of this DTO
-     */
-    public String toJson() {
-        return JSON.serialize(this);
-    }
-
-    /**
-     * Deserializes a JSON string into a {ClassName} instance
-     * @param jsonString The JSON string to deserialize
-     * @return A {ClassName} instance
-     */
-    public static {ClassName} fromJson(String jsonString) {
-        return ({ClassName}) JSON.deserialize(jsonString, {ClassName}.class);
-    }
-}

package/skills/generating-apex/assets/exception.cls

@@ -1,50 +0,0 @@
-/**
- * Custom exception for {describe when this exception is thrown}.
- *              Use this exception to signal domain-specific errors that callers
- *              can catch and handle distinctly from system exceptions.
- *
- * @example
- * throw new {ClassName}('Account merge failed: duplicate detected.');
- *
- * // Wrap a caught exception
- * try {
- *     // ... risky operation
- * } catch (DmlException e) {
- *     throw new {ClassName}('DML failed during account merge: ' + e.getMessage());
- * }
- */
-public with sharing class {ClassName} extends Exception {
-    // Apex custom exceptions automatically inherit:
-    //   - getMessage()
-    //   - getCause()
-    //   - getStackTraceString()
-    //   - setMessage(String)
-    //   - initCause(Exception)
-    //
-    // And support these constructor patterns:
-    //   - new {ClassName}()
-    //   - new {ClassName}('message')
-    //   - new {ClassName}(causeException)
-    //   - new {ClassName}('message', causeException)
-    //
-    // Note: Apex does NOT support custom constructors on Exception subclasses.
-    // To add context, use the message string or create a wrapper pattern:
-    //
-    // Example wrapper pattern (if you need structured error data):
-    //
-    // public class {ClassName}Detail {
-    //     public String errorCode;
-    //     public List<Id> failedRecordIds;
-    //     public String detail;
-    //
-    //     public {ClassName}Detail(String errorCode, List<Id> failedRecordIds, String detail) {
-    //         this.errorCode = errorCode;
-    //         this.failedRecordIds = failedRecordIds;
-    //         this.detail = detail;
-    //     }
-    //
-    //     public override String toString() {
-    //         return '[' + errorCode + '] ' + detail + ' (Records: ' + failedRecordIds + ')';
-    //     }
-    // }
-}

package/skills/generating-apex/assets/interface.cls

@@ -1,24 +0,0 @@
-/**
- * Interface for {describe the capability or contract this interface defines}.
- *              Implement this interface to provide {describe what implementations do}.
- *
- * @example
- * public class EmailNotificationService implements {InterfaceName} {
- *     public void execute(Map<String, Object> params) {
- *         // Implementation
- *     }
- * }
- */
-public interface {InterfaceName} {
-
-    /**
-     * {Describe what this method should do}
-     * @param params {Describe the parameter}
-     * @return {Describe the return value}
-     */
-    // TODO: Define interface methods
-    // Example:
-    // void execute(Map<String, Object> params);
-    // Boolean isEligible(SObject record);
-    // List<SObject> process(List<SObject> records);
-}

package/skills/generating-apex/assets/invocable.cls

@@ -1,114 +0,0 @@
-/**
- * Invocable Apex action for {describe the action}.
- * Callable from Flows, Process Builder, and Agentforce.
- * Accepts bulkified List<Request>, returns List<Response>.
- */
-public with sharing class {ClassName} {
-
-    // ─── Invocable Method ────────────────────────────────────────────────
-
-    /**
-     * {Describe what this action does}
-     * @param requests List of Request inputs from the calling Flow
-     * @return List of Response outputs returned to the calling Flow
-     */
-    @InvocableMethod(
-        label='{Display Name}'
-        description='{Describe the action for Flow Builder}'
-        category='{Category}'
-    )
-    public static List<Response> execute(List<Request> requests) {
-        List<Response> responses = new List<Response>();
-
-        // Collect all Ids upfront for bulkified query
-        Set<Id> allRecordIds = new Set<Id>();
-        for (Request req : requests) {
-            if (req.recordId != null) {
-                allRecordIds.add(req.recordId);
-            }
-        }
-
-        // Single bulkified query outside the loop
-        Map<Id, {SObject}> recordMap = allRecordIds.isEmpty()
-            ? new Map<Id, {SObject}>()
-            : new Map<Id, {SObject}>([
-                SELECT Id, Name
-                // TODO: Add required fields
-                FROM {SObject}
-                WHERE Id IN :allRecordIds
-                WITH USER_MODE
-            ]);
-
-        // Process each request
-        for (Request req : requests) {
-            responses.add(processRequest(req, recordMap));
-        }
-
-        return responses;
-    }
-
-    // ─── Private Helpers ─────────────────────────────────────────────────
-
-    /**
-     * Processes a single request and returns a response.
-     * Errors are captured in the response, not thrown.
-     * @param req The input request
-     * @param recordMap Pre-queried records keyed by Id
-     * @return A Response with success/error information
-     */
-    private static Response processRequest(Request req, Map<Id, {SObject}> recordMap) {
-        Response res = new Response();
-
-        try {
-            {SObject} record = recordMap.get(req.recordId);
-            if (record == null) {
-                res.isSuccess = false;
-                res.errorMessage = 'Record not found: ' + req.recordId;
-                res.errorType = 'NOT_FOUND';
-                return res;
-            }
-
-            // TODO: Implement business logic
-
-            res.isSuccess = true;
-        } catch (Exception e) {
-            res.isSuccess = false;
-            res.errorMessage = e.getMessage();
-            res.errorType = e.getTypeName();
-        }
-
-        return res;
-    }
-
-    // ─── Request / Response DTOs ─────────────────────────────────────────
-
-    /**
-     * Input parameters from the calling Flow
-     */
-    public class Request {
-        @InvocableVariable(label='Record Id' description='The Id of the record to process' required=true)
-        public Id recordId;
-
-        // TODO: Add additional input variables
-        // @InvocableVariable(label='Field Value' description='Value to set' required=false)
-        // public String fieldValue;
-    }
-
-    /**
-     * Output results returned to the calling Flow
-     */
-    public class Response {
-        @InvocableVariable(label='Success' description='Whether the action succeeded')
-        public Boolean isSuccess;
-
-        @InvocableVariable(label='Error Message' description='Error details if the action failed')
-        public String errorMessage;
-
-        @InvocableVariable(label='Error Type' description='Exception type name if the action failed')
-        public String errorType;
-
-        // TODO: Add additional output variables
-        // @InvocableVariable(label='Result Id' description='Id of the created/updated record')
-        // public Id resultId;
-    }
-}

package/skills/generating-apex/assets/queueable.cls

@@ -1,91 +0,0 @@
-/**
- * Queueable Apex class for {describe the async operation}.
- *              Accepts data through the constructor for stateful processing.
- *              Optionally implements Database.AllowsCallouts for external integrations.
- *
- * @example
- * // Enqueue the job
- * Id jobId = System.enqueueJob(new {ClassName}(recordIds));
- */
-public with sharing class {ClassName} implements Queueable /*, Database.AllowsCallouts */ {
-
-    // ─── Constants ───────────────────────────────────────────────────────
-    private static final Integer MAX_CHAIN_DEPTH = 5;
-
-    // ─── Instance Variables (Stateful) ───────────────────────────────────
-    private Set<Id> recordIds;
-    private Integer chainDepth;
-
-    // ─── Constructors ────────────────────────────────────────────────────
-
-    /**
-     * Creates a new queueable job to process the specified records
-     * @param recordIds Set of record Ids to process
-     */
-    public {ClassName}(Set<Id> recordIds) {
-        this(recordIds, 0);
-    }
-
-    /**
-     * Creates a new queueable job with chain depth tracking
-     * @param recordIds Set of record Ids to process
-     * @param chainDepth Current depth in the queueable chain
-     */
-    public {ClassName}(Set<Id> recordIds, Integer chainDepth) {
-        this.recordIds = recordIds ?? new Set<Id>();
-        this.chainDepth = chainDepth;
-    }
-
-    // ─── Queueable Interface ─────────────────────────────────────────────
-
-    /**
-     * Executes the asynchronous work
-     * @param context The queueable context
-     */
-    public void execute(QueueableContext context) {
-        if (this.recordIds.isEmpty()) {
-            return;
-        }
-
-        try {
-            // TODO: Implement the async processing logic
-            // List<{SObject}> records = {SObject}Selector.selectByIds(this.recordIds);
-            // ... process records ...
-
-            // Chain to next job if there's more work and we haven't hit the depth limit
-            chainIfNeeded();
-
-        } catch (Exception e) {
-            handleError(context.getJobId(), e);
-        }
-    }
-
-    // ─── Private Helpers ─────────────────────────────────────────────────
-
-    /**
-     * Chains to the next queueable job if needed, with depth guard
-     */
-    private void chainIfNeeded() {
-        // TODO: Determine if chaining is needed (e.g., remaining records to process)
-        Set<Id> remainingIds = new Set<Id>();
-
-        if (!remainingIds.isEmpty() && this.chainDepth < MAX_CHAIN_DEPTH) {
-            if (!Test.isRunningTest()) {
-                System.enqueueJob(new {ClassName}(remainingIds, this.chainDepth + 1));
-            }
-        }
-    }
-
-    /**
-     * Handles errors during execution
-     * @param jobId The async job Id
-     * @param e The exception that occurred
-     */
-    private void handleError(Id jobId, Exception e) {
-        System.debug(LoggingLevel.ERROR,
-            '{ClassName} failed (Job: ' + jobId + '): ' +
-            e.getMessage() + '\n' + e.getStackTraceString()
-        );
-        // TODO: Persist error to a log object or send notification
-    }
-}