Adding skipWhenAlreadyScheduled.

Author: Mateusz7410

force-app/main/default/classes/AsyncTest.cls

@@ -727,6 +727,49 @@ private class AsyncTest implements Database.Batchable<SObject> {
         Assert.areEqual(10, triggers[0].NextFireTime.hour());
     }
 
+    @IsTest
+    static void shouldFailWhenSchedulingJobWithTheSameName() {
+        Test.startTest();
+        try {
+            SchedulableBuilder builder = Async.batchable(new AsyncTest())
+                .asSchedulable()
+                .name(TEST_SCHEDULABLE_JOB_NAME)
+                .cronExpression(
+                    new CronBuilder()
+                        .everyXMonths(4, 3, 5, 25)
+                );
+            builder.schedule();
+            builder.schedule();
+            Assert.fail('Should throw system exception when trying to schedule the job with the same name.');
+        } catch (Exception ex) {
+            Assert.areEqual('System.AsyncException', ex.getTypeName());
+        }
+        Test.stopTest();
+    }
+
+    @IsTest
+    static void shouldSkipWhenSchedulingJobWithTheSameName() {
+        Test.startTest();
+        SchedulableBuilder builder = Async.queueable(new SuccessfulQueueableTest())
+            .asSchedulable()
+            .name(TEST_SCHEDULABLE_JOB_NAME)
+            .cronExpression(
+                new CronBuilder()
+                    .everyDay(10, 30)
+            )
+            .skipWhenAlreadyScheduled();
+        builder.schedule();
+        builder.schedule();
+        Test.stopTest();
+
+        String nameLike = TEST_SCHEDULABLE_JOB_NAME + '%';
+        List<CronTrigger> triggers = [SELECT CronExpression, NextFireTime FROM CronTrigger WHERE CronJobDetail.Name LIKE :nameLike];
+        Assert.areEqual(1, triggers.size());
+        Assert.areEqual('0 30 10 * * ? *', triggers[0].CronExpression);
+        Assert.areEqual(30, triggers[0].NextFireTime.minute());
+        Assert.areEqual(10, triggers[0].NextFireTime.hour());
+    }
+
     public Iterable<Account> start(Database.BatchableContext bc){
         // This is just a placeholder to start the batch.
         return new List<Account>{ new Account() };

force-app/main/default/classes/schedule/SchedulableBuilder.cls

@@ -1,8 +1,10 @@
 public inherited sharing class SchedulableBuilder {
     public Schedulable scheduleJob;
+    public BatchableBuilder batchableBuilder;
+
     public String name;
     public List<CronBuilder> crons = new List<CronBuilder>();
-    public BatchableBuilder batchableBuilder;
+    public Boolean skipWhenAlreadyScheduled = false;
 
     public SchedulableBuilder(QueueableBuilder builder) {
         this.scheduleJob = new QueueableSchedulable(builder);
@@ -23,20 +25,23 @@ public inherited sharing class SchedulableBuilder {
     }
 
     public SchedulableBuilder cronExpression(String cronExpression) {
-        this.crons.add(new CronBuilder(cronExpression));
-        return this;
+        return cronExpression(new CronBuilder(cronExpression));
     }
 
     public SchedulableBuilder cronExpression(CronBuilder builder) {
-        this.crons.add(builder);
-        return this;
+        return cronExpression(new List<CronBuilder> {builder});
     }
 
     public SchedulableBuilder cronExpression(List<CronBuilder> builders) {
         this.crons.addAll(builders);
         return this;
     }
 
+    public SchedulableBuilder skipWhenAlreadyScheduled() {
+        this.skipWhenAlreadyScheduled = true;
+        return this;
+    }
+
     public List<Async.AsyncResult> schedule() {
         return SchedulableManager.get().schedule(this);
     }

force-app/main/default/classes/schedule/SchedulableManager.cls

@@ -31,6 +31,10 @@ public inherited sharing class SchedulableManager {
         if ((builder.crons != null && !builder.crons.isEmpty()) && builder.batchableBuilder?.minutesFromNow != null) {
             throw new IllegalArgumentException(ERROR_MESSAGE_CRON_AND_MINUTES_SET);
         }
+
+        if (shouldSkipWhenAlreadyScheduled(builder)) {
+            return null;
+        }
 
         List<Async.AsyncResult> results = new List<Async.AsyncResult>();
         if (builder.batchableBuilder?.minutesFromNow != null) {
@@ -61,6 +65,10 @@ public inherited sharing class SchedulableManager {
         return results;
     }
 
+    private Boolean shouldSkipWhenAlreadyScheduled(SchedulableBuilder builder) {
+        return builder.skipWhenAlreadyScheduled && ![SELECT Id FROM CronJobDetail WHERE Name = :builder.name].isEmpty();
+    }
+
     public static SchedulableManager get() {
         if (instance == null) {
             instance = new SchedulableManager();

website/.vitepress/config.mts

@@ -14,7 +14,7 @@ export default defineConfig({
     sidebar: [
       {
         text: 'Introduction',
-        collapsed: true,
+        collapsed: false,
         items: [
           { text: 'Getting Started', link: '/getting-started' },
           { text: 'Installation', link: '/introduction/installation' }
@@ -28,6 +28,13 @@ export default defineConfig({
           { text: 'Batchable', link: '/api/batchable' },
           { text: 'Schedulable', link: '/api/schedulable' }
         ]
+      },
+      {
+        text: 'Explanations',
+        collapsed: false,
+        items: [
+          { text: 'Initial Scheduled Job', link: '/explanations/initial-scheduled-queuable-batch-job' }
+        ]
       }
     ],
     footer: {

website/api/schedulable.md

@@ -9,6 +9,7 @@ Schedulable job = new MySchedulableJob();
 List<Async.AsyncResult> results = Async.schedulable(job)
 	.name('Daily Processing Job')
 	.cronExpression('0 0 2 * * ? *')
+	.skipWhenAlreadyScheduled()
 	.schedule();
 System.debug('Scheduled job results: ' + results);
 ```
@@ -27,6 +28,7 @@ The following are methods for using Async with Schedulable jobs:
 - [`cronExpression(String cronExpression)`](#cronexpression)
 - [`cronExpression(CronBuilder builder)`](#cronexpression-1)
 - [`cronExpression(List<CronBuilder> builders)`](#cronexpression-2)
+- [`skipWhenAlreadyScheduled()`]()
 
 [**Build - Cron Expression**](#build---cron-expression)
 
@@ -161,6 +163,23 @@ Async.schedulable(new MySchedulableJob())
 	.cronExpression(crons);
 ```
 
+#### skipWhenAlreadyScheduled
+
+If set, the job will not be scheduled if it is already scheduled with the same name. This prevents throwing the `System.AsyncException`.
+
+**Signature**
+
+```apex
+SchedulableBuilder skipWhenAlreadyScheduled();
+```
+
+**Example**
+
+```apex
+Async.schedulable(new MySchedulableJob())
+	.skipWhenAlreadyScheduled();
+```
+
 ### Build - Cron Expression
 
 #### second

website/initial-scheduled-queuable-batch-job.md renamed to website/explanations/initial-scheduled-queuable-batch-job.md

@@ -57,8 +57,6 @@ Async Lib is a powerful Salesforce Apex framework that provides an elegant solut
 - **⚙️ Configuration-Driven**: Control job behavior through custom metadata without code changes
 - **🔗 Support Finalizers**: Execute cleanup logic after job completion with full context
 
-```
-
 ## Core Concepts
 
 ### 1. QueueableJob Base Class
@@ -94,6 +92,7 @@ Async.batchable(new MyBatchJob())
 Async.schedulable(new MySchedulableJob())
     .name('Daily Cleanup')
     .cronExpression('0 0 2 * * ? *')
+    .skipWhenAlreadyScheduled()
     .schedule();
 ```
 
@@ -213,7 +212,7 @@ Now that you understand the basics:
    2. **[Batchable API](/api/batchable.md)** - Detailed information on using Batchable jobs
    3. **[Schedulable API](/api/schedulable.md)** - Detailed information on using Schedulable jobs
 2. **Read the Blog Post** - Check out the detailed explanation: [Apex Queueable Processing Framework](https://blog.beyondthecloud.dev/blog/apex-queueable-processing-framework)
-3. **[Initial Scheduled Queueable Batch Job Explanation](/initial-scheduled-queuable-batch-job.md)** - Learn why this job is important for framework to function properly.
+3. **[Initial Scheduled Queueable Batch Job Explanation](/explanations/initial-scheduled-queuable-batch-job.md)** - Learn why this job is important for framework to function properly.
 
 ## Quick Tips
 

website/getting-started.md

@@ -2,22 +2,7 @@
 outline: deep
 ---
 
-# Installation <Badge type="tip" text="v1.0.0" />
-
-## Install via Package
-
-Install the SOQL Lib unmanaged package to your Salesforce environment:
-
-
-`/packaging/installPackage.apexp?p0=04tP6000001w95Z`
-
-<a href="https://test.salesforce.com/packaging/installPackage.apexp?p0=04tP6000001w95Z" target="_blank">
-    <p>Install on Sandbox</p>
-</a>
-
-<a href="https://login.salesforce.com/packaging/installPackage.apexp?p0=04tP6000001w95Z" target="_blank">
-    <p>Install on Production</p>
-</a>
+# Installation <Badge type="tip" text="v2.0.0" />
 
 ## Deploy via Button