@salesforce/afv-skills 1.1.0 → 1.2.0

package/skills/apex-class/examples/AccountSelector.cls

@@ -1,193 +0,0 @@
-/**
- * @description Selector class for Account queries.
- *              Encapsulates all SOQL for Account records.
- *              All methods return bulkified results (Lists or Maps).
- * @author Generated by Apex Class Writer Skill
- */
-public with sharing class AccountSelector {
-
-    // ─── Field Lists ─────────────────────────────────────────────────────
-
-    /**
-     * @description Returns the default set of fields to query for Account.
-     *              Centralizes field references to keep queries DRY.
-     * @return Comma-separated field list as a String
-     */
-    private static String getDefaultFields() {
-        return String.join(
-            new List<String>{
-                'Id',
-                'Name',
-                'AccountNumber',
-                'Type',
-                'Industry',
-                'AnnualRevenue',
-                'NumberOfEmployees',
-                'Phone',
-                'Website',
-                'OwnerId',
-                'CreatedDate',
-                'LastModifiedDate'
-            },
-            ', '
-        );
-    }
-
-    /**
-     * @description Returns fields needed for billing/territory operations
-     * @return Comma-separated field list as a String
-     */
-    private static String getBillingFields() {
-        return String.join(
-            new List<String>{
-                'Id',
-                'Name',
-                'BillingStreet',
-                'BillingCity',
-                'BillingState',
-                'BillingPostalCode',
-                'BillingCountry',
-                'Territory__c'
-            },
-            ', '
-        );
-    }
-
-    // ─── Query Methods ───────────────────────────────────────────────────
-
-    /**
-     * @description Selects Account records by their Ids
-     * @param recordIds Set of Account Ids to query
-     * @return List of Account records matching the provided Ids
-     * @example
-     * Set<Id> ids = new Set<Id>{ '001xx000003DGbY' };
-     * List<Account> results = AccountSelector.selectByIds(ids);
-     */
-    public static List<Account> selectByIds(Set<Id> recordIds) {
-        if (recordIds == null || recordIds.isEmpty()) {
-            return new List<Account>();
-        }
-
-        return Database.query(
-            'SELECT ' + getDefaultFields() +
-            ' FROM Account' +
-            ' WHERE Id IN :recordIds'
-        );
-    }
-
-    /**
-     * @description Selects Account records as a Map keyed by Id
-     * @param recordIds Set of Account Ids to query
-     * @return Map of Id to Account
-     */
-    public static Map<Id, Account> selectMapByIds(Set<Id> recordIds) {
-        return new Map<Id, Account>(selectByIds(recordIds));
-    }
-
-    /**
-     * @description Selects Accounts with billing address fields for territory assignment
-     * @param recordIds Set of Account Ids to query
-     * @return List of Account records with billing address fields populated
-     */
-    public static List<Account> selectWithBillingAddress(Set<Id> recordIds) {
-        if (recordIds == null || recordIds.isEmpty()) {
-            return new List<Account>();
-        }
-
-        return Database.query(
-            'SELECT ' + getBillingFields() +
-            ' FROM Account' +
-            ' WHERE Id IN :recordIds'
-        );
-    }
-
-    /**
-     * @description Selects Accounts by Account Type
-     * @param accountTypes Set of Account Type values to filter by
-     * @return List of matching Account records
-     * @example
-     * List<Account> prospects = AccountSelector.selectByType(
-     *     new Set<String>{ 'Prospect', 'Customer - Direct' }
-     * );
-     */
-    public static List<Account> selectByType(Set<String> accountTypes) {
-        if (accountTypes == null || accountTypes.isEmpty()) {
-            return new List<Account>();
-        }
-
-        return Database.query(
-            'SELECT ' + getDefaultFields() +
-            ' FROM Account' +
-            ' WHERE Type IN :accountTypes' +
-            ' ORDER BY Name ASC'
-        );
-    }
-
-    /**
-     * @description Selects Accounts by Industry with a minimum annual revenue
-     * @param industries Set of Industry values to filter by
-     * @param minRevenue Minimum AnnualRevenue threshold
-     * @return List of matching Account records ordered by revenue descending
-     * @example
-     * List<Account> techAccounts = AccountSelector.selectByIndustryAndRevenue(
-     *     new Set<String>{ 'Technology' },
-     *     1000000
-     * );
-     */
-    public static List<Account> selectByIndustryAndRevenue(Set<String> industries, Decimal minRevenue) {
-        if (industries == null || industries.isEmpty()) {
-            return new List<Account>();
-        }
-
-        Decimal revenueThreshold = minRevenue ?? 0;
-
-        return Database.query(
-            'SELECT ' + getDefaultFields() +
-            ' FROM Account' +
-            ' WHERE Industry IN :industries' +
-            ' AND AnnualRevenue >= :revenueThreshold' +
-            ' ORDER BY AnnualRevenue DESC'
-        );
-    }
-
-    /**
-     * @description Selects Accounts with their related Contacts (subquery)
-     * @param recordIds Set of Account Ids to query
-     * @return List of Account records with nested Contacts
-     */
-    public static List<Account> selectWithContacts(Set<Id> recordIds) {
-        if (recordIds == null || recordIds.isEmpty()) {
-            return new List<Account>();
-        }
-
-        return [
-            SELECT Id, Name, Type, Industry,
-                   (SELECT Id, FirstName, LastName, Email, Title
-                    FROM Contacts
-                    ORDER BY LastName ASC)
-            FROM Account
-            WHERE Id IN :recordIds
-        ];
-    }
-
-    // ─── Aggregate Queries ───────────────────────────────────────────────
-
-    /**
-     * @description Returns a count of Accounts grouped by Industry
-     * @return List of AggregateResult with Industry and record count
-     * @example
-     * List<AggregateResult> results = AccountSelector.countByIndustry();
-     * for (AggregateResult ar : results) {
-     *     System.debug(ar.get('Industry') + ': ' + ar.get('cnt'));
-     * }
-     */
-    public static List<AggregateResult> countByIndustry() {
-        return [
-            SELECT Industry, COUNT(Id) cnt
-            FROM Account
-            WHERE Industry != NULL
-            GROUP BY Industry
-            ORDER BY COUNT(Id) DESC
-        ];
-    }
-}

package/skills/apex-class/examples/AccountService.cls

@@ -1,201 +0,0 @@
-/**
- * @description Service class for Account business logic.
- *              Provides account deduplication, enrichment, and territory assignment.
- *              Delegates queries to AccountSelector and SObject manipulation to AccountDomain.
- * @author Generated by Apex Class Writer Skill
- */
-public with sharing class AccountService {
-
-    // ─── Constants ───────────────────────────────────────────────────────
-    private static final String ERROR_NULL_INPUT = 'Input cannot be null or empty.';
-    private static final String ERROR_MERGE_FAILED = 'Account merge failed for master Id: ';
-    private static final Integer MAX_MERGE_BATCH = 3;
-
-    // ─── Public API ──────────────────────────────────────────────────────
-
-    /**
-     * @description Merges duplicate Account records into a master record.
-     *              The master record retains its field values; child records are reparented.
-     * @param masterIds Map of master Account Id to Set of duplicate Account Ids to merge
-     * @return List of master Account Ids that were successfully merged
-     * @throws AccountServiceException if merge processing fails
-     * @example
-     * Map<Id, Set<Id>> mergeMap = new Map<Id, Set<Id>>{
-     *     masterAcctId => new Set<Id>{ dupeId1, dupeId2 }
-     * };
-     * List<Id> mergedIds = AccountService.mergeAccounts(mergeMap);
-     */
-    public static List<Id> mergeAccounts(Map<Id, Set<Id>> mergeMap) {
-        if (mergeMap == null || mergeMap.isEmpty()) {
-            throw new AccountServiceException(ERROR_NULL_INPUT);
-        }
-
-        // Collect all Ids for a single query
-        Set<Id> allIds = new Set<Id>();
-        allIds.addAll(mergeMap.keySet());
-        for (Set<Id> dupeIds : mergeMap.values()) {
-            allIds.addAll(dupeIds);
-        }
-
-        // Query all records at once via Selector
-        Map<Id, Account> accountMap = AccountSelector.selectMapByIds(allIds);
-
-        List<Id> successfulMerges = new List<Id>();
-        List<String> errors = new List<String>();
-
-        for (Id masterId : mergeMap.keySet()) {
-            Account master = accountMap.get(masterId);
-            if (master == null) {
-                errors.add('Master account not found: ' + masterId);
-                continue;
-            }
-
-            List<Account> duplicates = new List<Account>();
-            for (Id dupeId : mergeMap.get(masterId)) {
-                Account dupe = accountMap.get(dupeId);
-                if (dupe != null) {
-                    duplicates.add(dupe);
-                }
-            }
-
-            try {
-                // Apex merge supports up to 3 records at a time
-                for (List<Account> chunk : chunkAccounts(duplicates, MAX_MERGE_BATCH)) {
-                    Database.merge(master, chunk);
-                }
-                successfulMerges.add(masterId);
-            } catch (DmlException e) {
-                errors.add(ERROR_MERGE_FAILED + masterId + ' - ' + e.getMessage());
-            }
-        }
-
-        if (!errors.isEmpty()) {
-            System.debug(LoggingLevel.WARN, 'Merge errors: ' + String.join(errors, '\n'));
-        }
-
-        return successfulMerges;
-    }
-
-    /**
-     * @description Assigns accounts to territories based on Billing State/Country.
-     *              Uses Custom Metadata Type (Territory_Mapping__mdt) for mappings.
-     * @param accountIds Set of Account Ids to assign territories for
-     * @return Number of accounts successfully updated
-     * @throws AccountServiceException if territory assignment fails
-     */
-    public static Integer assignTerritories(Set<Id> accountIds) {
-        if (accountIds == null || accountIds.isEmpty()) {
-            throw new AccountServiceException(ERROR_NULL_INPUT);
-        }
-
-        List<Account> accounts = AccountSelector.selectWithBillingAddress(accountIds);
-        Map<String, String> territoryMap = loadTerritoryMappings();
-
-        List<Account> toUpdate = new List<Account>();
-        for (Account acct : accounts) {
-            String key = buildTerritoryKey(acct.BillingState, acct.BillingCountry);
-            String territory = territoryMap.get(key);
-
-            if (territory != null && territory != acct.Territory__c) {
-                toUpdate.add(new Account(
-                    Id = acct.Id,
-                    Territory__c = territory
-                ));
-            }
-        }
-
-        if (!toUpdate.isEmpty()) {
-            List<Database.SaveResult> results = Database.update(toUpdate, false);
-            return countSuccesses(results);
-        }
-
-        return 0;
-    }
-
-    // ─── Convenience Overloads ───────────────────────────────────────────
-
-    /**
-     * @description Single-account territory assignment convenience method
-     * @param accountId The Account Id to assign a territory for
-     * @return 1 if updated, 0 if no change needed
-     */
-    public static Integer assignTerritory(Id accountId) {
-        return assignTerritories(new Set<Id>{ accountId });
-    }
-
-    // ─── Private Helpers ─────────────────────────────────────────────────
-
-    /**
-     * @description Loads territory mappings from Custom Metadata
-     * @return Map of territory key (State:Country) to territory name
-     */
-    private static Map<String, String> loadTerritoryMappings() {
-        Map<String, String> mappings = new Map<String, String>();
-        for (Territory_Mapping__mdt mapping : Territory_Mapping__mdt.getAll().values()) {
-            String key = buildTerritoryKey(mapping.State__c, mapping.Country__c);
-            mappings.put(key, mapping.Territory_Name__c);
-        }
-        return mappings;
-    }
-
-    /**
-     * @description Builds a consistent territory lookup key
-     * @param state The billing state
-     * @param country The billing country
-     * @return A normalized key string
-     */
-    private static String buildTerritoryKey(String state, String country) {
-        return (state ?? '').toUpperCase() + ':' + (country ?? '').toUpperCase();
-    }
-
-    /**
-     * @description Chunks a list of Accounts into sublists of the given size
-     * @param accounts The accounts to chunk
-     * @param chunkSize Maximum chunk size
-     * @return List of account sublists
-     */
-    private static List<List<Account>> chunkAccounts(List<Account> accounts, Integer chunkSize) {
-        List<List<Account>> chunks = new List<List<Account>>();
-        List<Account> current = new List<Account>();
-
-        for (Account acct : accounts) {
-            current.add(acct);
-            if (current.size() == chunkSize) {
-                chunks.add(current);
-                current = new List<Account>();
-            }
-        }
-        if (!current.isEmpty()) {
-            chunks.add(current);
-        }
-        return chunks;
-    }
-
-    /**
-     * @description Counts successful results from a DML operation
-     * @param results List of Database.SaveResult
-     * @return Count of successful operations
-     */
-    private static Integer countSuccesses(List<Database.SaveResult> results) {
-        Integer count = 0;
-        for (Database.SaveResult sr : results) {
-            if (sr.isSuccess()) {
-                count++;
-            } else {
-                for (Database.Error err : sr.getErrors()) {
-                    System.debug(LoggingLevel.WARN,
-                        'Update failed for ' + sr.getId() + ': ' + err.getMessage()
-                    );
-                }
-            }
-        }
-        return count;
-    }
-
-    // ─── Exception ───────────────────────────────────────────────────────
-
-    /**
-     * @description Custom exception for AccountService errors
-     */
-    public class AccountServiceException extends Exception {}
-}

package/skills/apex-class/templates/abstract.cls

@@ -1,128 +0,0 @@
-/**
- * @description Abstract base class for {describe the family of classes this serves}.
- *              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:
- * public class SalesforceIntegrationService extends {ClassName} {
- *     protected override String getEndpoint() {
- *         return 'callout:Salesforce_API/services/data/v62.0';
- *     }
- *
- *     protected override Map<String, String> getHeaders() {
- *         return new Map<String, String>{
- *             'Content-Type' => 'application/json'
- *         };
- *     }
- * }
- */
-public abstract with sharing class {ClassName} {
-
-    // ─── Constants ───────────────────────────────────────────────────────
-    private static final Integer DEFAULT_TIMEOUT_MS = 30000;
-
-    // ─── Protected State ─────────────────────────────────────────────────
-    protected Integer timeoutMs;
-
-    // ─── Constructor ─────────────────────────────────────────────────────
-
-    /**
-     * @description Initializes the base class with default configuration
-     */
-    protected {ClassName}() {
-        this.timeoutMs = DEFAULT_TIMEOUT_MS;
-    }
-
-    // ─── Abstract Methods (must be implemented by subclasses) ────────────
-
-    /**
-     * @description 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.
-     *              Subclasses define their own required headers.
-     * @return Map of header name to header value
-     */
-    protected abstract Map<String, String> getHeaders();
-
-    // ─── Virtual Methods (can be overridden by subclasses) ───────────────
-
-    /**
-     * @description Hook called before the main operation executes.
-     *              Override to add pre-processing logic.
-     *              Default implementation does nothing.
-     * @param context Map of contextual data
-     */
-    protected virtual void beforeExecute(Map<String, Object> context) {
-        // Default: no-op — override in subclass if needed
-    }
-
-    /**
-     * @description Hook called after the main operation completes.
-     *              Override to add post-processing logic.
-     *              Default implementation does nothing.
-     * @param context Map of contextual data
-     * @param result The result from the operation
-     */
-    protected virtual void afterExecute(Map<String, Object> context, Object result) {
-        // Default: no-op — override in subclass if needed
-    }
-
-    // ─── Template Method (common workflow) ───────────────────────────────
-
-    /**
-     * @description 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
-     */
-    public Object execute(Map<String, Object> context) {
-        beforeExecute(context);
-
-        Object result;
-        try {
-            result = doExecute(context);
-        } catch (Exception e) {
-            handleError(e);
-            throw e;
-        }
-
-        afterExecute(context, result);
-        return result;
-    }
-
-    // ─── Protected Helpers ───────────────────────────────────────────────
-
-    /**
-     * @description 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
-     */
-    protected virtual Object doExecute(Map<String, Object> context) {
-        throw new UnsupportedOperationException(
-            'Subclass must override doExecute()'
-        );
-    }
-
-    /**
-     * @description Error handler called when doExecute throws.
-     *              Override to customize error handling (e.g., logging, retry).
-     * @param e The exception that was thrown
-     */
-    protected virtual void handleError(Exception e) {
-        System.debug(LoggingLevel.ERROR,
-            this.toString() + ' error: ' + e.getMessage() + '\n' + e.getStackTraceString()
-        );
-    }
-
-    // ─── Exception ───────────────────────────────────────────────────────
-
-    public class UnsupportedOperationException extends Exception {}
-}

package/skills/apex-class/templates/batch.cls

@@ -1,125 +0,0 @@
-/**
- * @description 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
- * Database.executeBatch(new {ClassName}());
- *
- * // Execute with custom batch size
- * Database.executeBatch(new {ClassName}(), 100);
- */
-public with sharing class {ClassName} implements Database.Batchable<SObject>, Database.Stateful {
-
-    // ─── Constants ───────────────────────────────────────────────────────
-    private static final Integer DEFAULT_BATCH_SIZE = 200;
-
-    // ─── Stateful Tracking ───────────────────────────────────────────────
-    private Integer totalProcessed = 0;
-    private Integer totalErrors = 0;
-    private List<String> errorMessages = new List<String>();
-
-    // ─── Constructor ─────────────────────────────────────────────────────
-
-    /**
-     * @description Default constructor
-     */
-    public {ClassName}() {
-        // Default configuration
-    }
-
-    // ─── Batchable Interface ─────────────────────────────────────────────
-
-    /**
-     * @description 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
-     */
-    public Database.QueryLocator start(Database.BatchableContext bc) {
-        return Database.getQueryLocator([
-            SELECT Id, Name
-            // TODO: Add fields needed for processing
-            FROM {SObject}
-            // TODO: Add WHERE clause to scope the records
-        ]);
-    }
-
-    /**
-     * @description 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
-     */
-    public void execute(Database.BatchableContext bc, List<{SObject}> scope) {
-        List<{SObject}> recordsToUpdate = new List<{SObject}>();
-
-        for ({SObject} record : scope) {
-            // TODO: Apply business logic to each record
-            recordsToUpdate.add(record);
-        }
-
-        if (!recordsToUpdate.isEmpty()) {
-            List<Database.SaveResult> results = Database.update(recordsToUpdate, false);
-            processResults(results);
-        }
-    }
-
-    /**
-     * @description Performs post-processing after all batches complete.
-     *              Logs a summary of the batch execution.
-     * @param bc The batch context
-     */
-    public void finish(Database.BatchableContext bc) {
-        String summary = String.format(
-            '{0} completed. Processed: {1}, Errors: {2}',
-            new List<Object>{
-                {ClassName}.class.getName(),
-                totalProcessed,
-                totalErrors
-            }
-        );
-
-        System.debug(LoggingLevel.INFO, summary);
-
-        if (!errorMessages.isEmpty()) {
-            System.debug(LoggingLevel.ERROR, 'Error details: ' + String.join(errorMessages, '\n'));
-        }
-
-        // TODO: Send completion notification email or post to chatter if needed
-    }
-
-    // ─── Private Helpers ─────────────────────────────────────────────────
-
-    /**
-     * @description Processes Database.SaveResult list, tracking successes and failures
-     * @param results List of SaveResult from a DML operation
-     */
-    private void processResults(List<Database.SaveResult> results) {
-        for (Database.SaveResult result : results) {
-            if (result.isSuccess()) {
-                totalProcessed++;
-            } else {
-                totalErrors++;
-                for (Database.Error err : result.getErrors()) {
-                    errorMessages.add(
-                        'Record ' + result.getId() + ': ' +
-                        err.getStatusCode() + ' - ' + err.getMessage()
-                    );
-                }
-            }
-        }
-    }
-
-    // ─── Static Helpers ──────────────────────────────────────────────────
-
-    /**
-     * @description Convenience method to execute with default batch size
-     * @return The batch job Id
-     */
-    public static Id run() {
-        return Database.executeBatch(new {ClassName}(), DEFAULT_BATCH_SIZE);
-    }
-}