From bf587d1d0eaaffb7e0c20b903bd3ec1b32fa7d0f Mon Sep 17 00:00:00 2001
From: David Callizaya <davidcallizaya@gmail.com>
Date: Tue, 16 Sep 2025 18:31:15 -0400
Subject: [PATCH] Add job validation and new scheduling method
 `scheduleDateJob`

---
 .../Managers/TaskSchedulerManager.php         | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/ProcessMaker/Managers/TaskSchedulerManager.php b/ProcessMaker/Managers/TaskSchedulerManager.php
index d59dc4db80..e459bd2cee 100644
--- a/ProcessMaker/Managers/TaskSchedulerManager.php
+++ b/ProcessMaker/Managers/TaskSchedulerManager.php
@@ -12,6 +12,7 @@
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Log;
 use Illuminate\Support\Facades\Schema;
+use InvalidArgumentException;
 use PDOException;
 use ProcessMaker\Facades\WorkflowManager;
 use ProcessMaker\Jobs\StartEventConditional;
@@ -574,6 +575,9 @@ public function scheduleCycle(
      */
     public function scheduleCycleJob($interval, array $config): ScheduledTask
     {
+        if (!isset($config['job'])) {
+            throw new InvalidArgumentException('$config["job"] is required');
+        }
         $configuration = [
             'type' => 'TimeCycle',
             'interval' => $interval,
@@ -590,6 +594,33 @@ public function scheduleCycleJob($interval, array $config): ScheduledTask
         return $scheduledTask;
     }
 
+    /**
+     * Schedule a job for a specific datetime
+     *
+     * @param string $datetime in ISO-8601 format
+     * @param array $config configuration
+     *
+     * @return ScheduledTask
+     */
+    public function scheduleDateJob($datetime, array $config): ScheduledTask
+    {
+        if (!isset($config['job'])) {
+            throw new InvalidArgumentException('$config["job"] is required');
+        }
+        $configuration = [
+            'type' => 'TimeDate',
+            'date' => $datetime,
+            ...$config,
+        ];
+        $scheduledTask = new ScheduledTask();
+        $scheduledTask->configuration = json_encode($configuration);
+        $scheduledTask->type = 'SCHEDULED_JOB';
+        $scheduledTask->last_execution = null;
+        $scheduledTask->save();
+
+        return $scheduledTask;
+    }
+
     /**
      * Schedule a job execution after a time duration for the given BPMN element,
      * event definition and an optional Token object