async-apex

/async-apex

Work with asynchronous Apex patterns using --new, --refine, or --bug-fix.

Usage

/async-apex --new          Create a new async Apex class (Batch, Queueable, Schedulable, or Future)
/async-apex --refine       Modify an existing async class
/async-apex --bug-fix      Diagnose and fix a bug in async Apex code

---

--new: Create a New Async Class

Gather Requirements

Ask the user:

1. What type? (Batch, Queueable, Schedulable, or @future method)
2. What does it process? (object, business operation)
3. What's the estimated data volume? (helps choose batch size)
4. Does it need to make HTTP callouts?
5. Should it chain to another async job after completion?

Choosing the Right Pattern

Pattern	Use When
Batch Apex	Processing large volumes (1,000+ records), scheduled or on-demand
Queueable	Single async operation, needs callouts, can chain jobs
Schedulable	Time-based execution (cron), typically kicks off a Batch
@future	Legacy simple async — prefer Queueable for new code

---

Batch Apex Pattern

public class AccountSyncBatch implements Database.Batchable<SObject>, Database.Stateful {

    private Integer processedCount = 0;
    private List<String> errors = new List<String>();

    public Database.QueryLocator start(Database.BatchableContext bc) {
        // Use QueryLocator for large volumes — no LIMIT needed here
        return Database.getQueryLocator([
            SELECT Id, Name, SyncStatus__c
            FROM Account
            WHERE SyncStatus__c = 'Pending'
            ORDER BY CreatedDate ASC
        ]);
    }

    public void execute(Database.BatchableContext bc, List<Account> scope) {
        // Each execute() gets a FRESH set of governor limits
        List<Account> toUpdate = new List<Account>();
        for (Account acc : scope) {
            acc.SyncStatus__c = 'Complete';
            toUpdate.add(acc);
        }
        Database.SaveResult[] results = Database.update(toUpdate, false);
        for (Database.SaveResult sr : results) {
            if (!sr.isSuccess()) {
                errors.add(sr.getErrors()[0].getMessage());
            } else {
                processedCount++;
            }
        }
    }

    public void finish(Database.BatchableContext bc) {
        // Chain next job or send notification
        if (!errors.isEmpty()) {
            // Log or email errors
        }
    }
}

// Execute with default 200 scope
Database.executeBatch(new AccountSyncBatch());
// Execute with custom scope size
Database.executeBatch(new AccountSyncBatch(), 50); // smaller = more SOQL budget per execute