@salesforce/afv-skills 1.5.1 → 1.5.3

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

@@ -1,8 +1,11 @@
 /**
+<<<<<<< Updated upstream
  * @description Abstract base class for {describe the family of classes this serves}.
+=======
+ * Abstract base class for {describe the family of classes this serves}.
+>>>>>>> Stashed changes
  *              Provides common behavior and defines extension points for subclasses.
  *              Subclasses must implement the abstract methods to provide specific behavior.
- * @author Generated by Apex Class Writer Skill
  *
  * @example
  * // Extending this abstract class:
@@ -29,7 +32,7 @@ public abstract with sharing class {ClassName} {
     // ─── Constructor ─────────────────────────────────────────────────────
 
     /**
-     * @description Initializes the base class with default configuration
+     * Initializes the base class with default configuration
      */
     protected {ClassName}() {
         this.timeoutMs = DEFAULT_TIMEOUT_MS;
@@ -38,14 +41,14 @@ public abstract with sharing class {ClassName} {
     // ─── Abstract Methods (must be implemented by subclasses) ────────────
 
     /**
-     * @description Returns the endpoint URL for this integration.
+     * Returns the endpoint URL for this integration.
      *              Subclasses must provide their specific endpoint.
      * @return The endpoint URL as a String
      */
     protected abstract String getEndpoint();
 
     /**
-     * @description Returns the HTTP headers for this integration.
+     * Returns the HTTP headers for this integration.
      *              Subclasses define their own required headers.
      * @return Map of header name to header value
      */
@@ -54,7 +57,7 @@ public abstract with sharing class {ClassName} {
     // ─── Virtual Methods (can be overridden by subclasses) ───────────────
 
     /**
-     * @description Hook called before the main operation executes.
+     * Hook called before the main operation executes.
      *              Override to add pre-processing logic.
      *              Default implementation does nothing.
      * @param context Map of contextual data
@@ -64,7 +67,7 @@ public abstract with sharing class {ClassName} {
     }
 
     /**
-     * @description Hook called after the main operation completes.
+     * Hook called after the main operation completes.
      *              Override to add post-processing logic.
      *              Default implementation does nothing.
      * @param context Map of contextual data
@@ -77,7 +80,7 @@ public abstract with sharing class {ClassName} {
     // ─── Template Method (common workflow) ───────────────────────────────
 
     /**
-     * @description Executes the operation using the template method pattern.
+     * Executes the operation using the template method pattern.
      *              Calls beforeExecute → doExecute → afterExecute in sequence.
      * @param context Map of data needed for the operation
      * @return The result of the operation
@@ -100,7 +103,7 @@ public abstract with sharing class {ClassName} {
     // ─── Protected Helpers ───────────────────────────────────────────────
 
     /**
-     * @description Core execution logic — override this for the main operation.
+     * Core execution logic — override this for the main operation.
      *              Default implementation throws — subclass must provide implementation.
      * @param context Map of data needed for the operation
      * @return The result of the operation
@@ -112,7 +115,7 @@ public abstract with sharing class {ClassName} {
     }
 
     /**
-     * @description Error handler called when doExecute throws.
+     * Error handler called when doExecute throws.
      *              Override to customize error handling (e.g., logging, retry).
      * @param e The exception that was thrown
      */

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

@@ -1,8 +1,7 @@
 /**
- * @description Batch Apex class for {describe the batch operation}.
+ * Batch Apex class for {describe the batch operation}.
  *              Processes {SObject} records in configurable batch sizes.
  *              Implements Database.Stateful to track cumulative results across chunks.
- * @author Generated by Apex Class Writer Skill
  *
  * @example
  * // Execute with default batch size
@@ -24,7 +23,7 @@ public with sharing class {ClassName} implements Database.Batchable<SObject>, Da
     // ─── Constructor ─────────────────────────────────────────────────────
 
     /**
-     * @description Default constructor
+     * Default constructor
      */
     public {ClassName}() {
         // Default configuration
@@ -33,7 +32,7 @@ public with sharing class {ClassName} implements Database.Batchable<SObject>, Da
     // ─── Batchable Interface ─────────────────────────────────────────────
 
     /**
-     * @description Defines the scope of records to process.
+     * Defines the scope of records to process.
      *              Uses Database.QueryLocator for efficient large-dataset processing.
      * @param bc The batch context
      * @return QueryLocator for the records to process
@@ -48,7 +47,7 @@ public with sharing class {ClassName} implements Database.Batchable<SObject>, Da
     }
 
     /**
-     * @description Processes each batch of records.
+     * Processes each batch of records.
      *              Uses Database.update with allOrNone=false for partial success handling.
      * @param bc The batch context
      * @param scope List of {SObject} records in the current batch
@@ -68,7 +67,7 @@ public with sharing class {ClassName} implements Database.Batchable<SObject>, Da
     }
 
     /**
-     * @description Performs post-processing after all batches complete.
+     * Performs post-processing after all batches complete.
      *              Logs a summary of the batch execution.
      * @param bc The batch context
      */
@@ -94,7 +93,7 @@ public with sharing class {ClassName} implements Database.Batchable<SObject>, Da
     // ─── Private Helpers ─────────────────────────────────────────────────
 
     /**
-     * @description Processes Database.SaveResult list, tracking successes and failures
+     * Processes Database.SaveResult list, tracking successes and failures
      * @param results List of SaveResult from a DML operation
      */
     private void processResults(List<Database.SaveResult> results) {
@@ -116,7 +115,7 @@ public with sharing class {ClassName} implements Database.Batchable<SObject>, Da
     // ─── Static Helpers ──────────────────────────────────────────────────
 
     /**
-     * @description Convenience method to execute with default batch size
+     * Convenience method to execute with default batch size
      * @return The batch job Id
      */
     public static Id run() {

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

@@ -1,8 +1,7 @@
 /**
- * @description Domain class for {SObject}.
+ * Domain class for {SObject}.
  *              Encapsulates field-level defaults, derivations, and validations.
  *              Operates only on in-memory SObject data — no SOQL or DML.
- * @author Generated by Apex Class Writer Skill
  */
 public with sharing class {SObject}Domain {
 
@@ -12,7 +11,7 @@ public with sharing class {SObject}Domain {
     // ─── Field Defaults ──────────────────────────────────────────────────
 
     /**
-     * @description Applies default field values to new {SObject} records.
+     * 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
      */
@@ -33,7 +32,7 @@ public with sharing class {SObject}Domain {
     // ─── Derivations ────────────────────────────────────────────────────
 
     /**
-     * @description Derives calculated field values based on other fields.
+     * 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
      */
@@ -52,7 +51,7 @@ public with sharing class {SObject}Domain {
     // ─── Validations ────────────────────────────────────────────────────
 
     /**
-     * @description Validates {SObject} records and adds errors for any violations.
+     * Validates {SObject} records and adds errors for any violations.
      *              Call this before insert and before update.
      * @param records List of {SObject} records to validate
      */
@@ -73,7 +72,7 @@ public with sharing class {SObject}Domain {
     // ─── Comparisons ────────────────────────────────────────────────────
 
     /**
-     * @description Determines which fields have changed between old and new record versions.
+     * 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

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

@@ -1,8 +1,7 @@
 /**
- * @description Data Transfer Object for {describe the data this DTO represents}.
+ * 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.
- * @author Generated by Apex Class Writer Skill
  *
  * @example
  * // Create from constructor
@@ -15,16 +14,16 @@ public with sharing class {ClassName} {
 
     // ─── Properties ──────────────────────────────────────────────────────
 
-    /** @description {Describe this property} */
+    /** {Describe this property} */
     public String name { get; set; }
 
-    /** @description {Describe this property} */
+    /** {Describe this property} */
     public Id recordId { get; set; }
 
-    /** @description {Describe this property} */
+    /** {Describe this property} */
     public Boolean isActive { get; set; }
 
-    /** @description {Describe this property} */
+    /** {Describe this property} */
     public List<String> tags { get; set; }
 
     // TODO: Add additional properties as needed
@@ -32,7 +31,7 @@ public with sharing class {ClassName} {
     // ─── Constructors ────────────────────────────────────────────────────
 
     /**
-     * @description No-arg constructor for deserialization compatibility
+     * No-arg constructor for deserialization compatibility
      */
     public {ClassName}() {
         this.tags = new List<String>();
@@ -40,7 +39,7 @@ public with sharing class {ClassName} {
     }
 
     /**
-     * @description Parameterized constructor for convenience
+     * Parameterized constructor for convenience
      * @param name The name value
      * @param recordId The associated record Id
      */
@@ -53,7 +52,7 @@ public with sharing class {ClassName} {
     // ─── Factory Methods ─────────────────────────────────────────────────
 
     /**
-     * @description Creates a DTO instance from an SObject record
+     * Creates a DTO instance from an SObject record
      * @param record The source {SObject} record
      * @return A populated {ClassName} instance
      */
@@ -71,7 +70,7 @@ public with sharing class {ClassName} {
     }
 
     /**
-     * @description Creates a list of DTOs from a list of SObject records
+     * Creates a list of DTOs from a list of SObject records
      * @param records The source records
      * @return List of populated {ClassName} instances
      */
@@ -90,7 +89,7 @@ public with sharing class {ClassName} {
     // ─── Utility Methods ─────────────────────────────────────────────────
 
     /**
-     * @description Serializes this DTO to a JSON string
+     * Serializes this DTO to a JSON string
      * @return JSON representation of this DTO
      */
     public String toJson() {
@@ -98,7 +97,7 @@ public with sharing class {ClassName} {
     }
 
     /**
-     * @description Deserializes a JSON string into a {ClassName} instance
+     * Deserializes a JSON string into a {ClassName} instance
      * @param jsonString The JSON string to deserialize
      * @return A {ClassName} instance
      */

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

@@ -1,8 +1,7 @@
 /**
- * @description Custom exception for {describe when this exception is thrown}.
+ * 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.
- * @author Generated by Apex Class Writer Skill
  *
  * @example
  * throw new {ClassName}('Account merge failed: duplicate detected.');

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

@@ -1,7 +1,6 @@
 /**
- * @description Interface for {describe the capability or contract this interface defines}.
+ * Interface for {describe the capability or contract this interface defines}.
  *              Implement this interface to provide {describe what implementations do}.
- * @author Generated by Apex Class Writer Skill
  *
  * @example
  * public class EmailNotificationService implements {InterfaceName} {
@@ -13,7 +12,7 @@
 public interface {InterfaceName} {
 
     /**
-     * @description {Describe what this method should do}
+     * {Describe what this method should do}
      * @param params {Describe the parameter}
      * @return {Describe the return value}
      */

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

@@ -0,0 +1,114 @@
+/**
+ * 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,8 +1,7 @@
 /**
- * @description Queueable Apex class for {describe the async operation}.
+ * Queueable Apex class for {describe the async operation}.
  *              Accepts data through the constructor for stateful processing.
  *              Optionally implements Database.AllowsCallouts for external integrations.
- * @author Generated by Apex Class Writer Skill
  *
  * @example
  * // Enqueue the job
@@ -20,7 +19,7 @@ public with sharing class {ClassName} implements Queueable /*, Database.AllowsCa
     // ─── Constructors ────────────────────────────────────────────────────
 
     /**
-     * @description Creates a new queueable job to process the specified records
+     * Creates a new queueable job to process the specified records
      * @param recordIds Set of record Ids to process
      */
     public {ClassName}(Set<Id> recordIds) {
@@ -28,7 +27,7 @@ public with sharing class {ClassName} implements Queueable /*, Database.AllowsCa
     }
 
     /**
-     * @description Creates a new queueable job with chain depth tracking
+     * 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
      */
@@ -40,7 +39,7 @@ public with sharing class {ClassName} implements Queueable /*, Database.AllowsCa
     // ─── Queueable Interface ─────────────────────────────────────────────
 
     /**
-     * @description Executes the asynchronous work
+     * Executes the asynchronous work
      * @param context The queueable context
      */
     public void execute(QueueableContext context) {
@@ -64,7 +63,7 @@ public with sharing class {ClassName} implements Queueable /*, Database.AllowsCa
     // ─── Private Helpers ─────────────────────────────────────────────────
 
     /**
-     * @description Chains to the next queueable job if needed, with depth guard
+     * 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)
@@ -78,7 +77,7 @@ public with sharing class {ClassName} implements Queueable /*, Database.AllowsCa
     }
 
     /**
-     * @description Handles errors during execution
+     * Handles errors during execution
      * @param jobId The async job Id
      * @param e The exception that occurred
      */