From 5c5e97faaed9f0bed5633cee9ef4e4c4e3968b91 Mon Sep 17 00:00:00 2001
From: klemek <klemek.dev@proton.me>
Date: Sun, 19 Jul 2026 14:55:56 +0200
Subject: [PATCH] feat: one-time tasks

---
 resources/lang/en.json                |  3 ++-
 resources/lang/fr.json                |  3 ++-
 resources/ts/components/CronInput.vue |  3 +++
 resources/ts/components/TaskItem.vue  | 33 +++++++++++++++------------
 resources/ts/enums.ts                 |  1 +
 resources/ts/lib/cron.ts              | 13 +++++++++++
 resources/ts/lib/tasks.ts             |  9 ++++++--
 7 files changed, 47 insertions(+), 18 deletions(-)

diff --git a/resources/lang/en.json b/resources/lang/en.json
index ab466b6..c87dcc3 100644
--- a/resources/lang/en.json
+++ b/resources/lang/en.json
@@ -6,7 +6,8 @@
             "every_week": "Every week",
             "every_month": "Every month",
             "every_year": "Every year",
-            "custom": "Custom (crontab)"
+            "custom": "Custom (crontab)",
+            "one_time": "One time (then delete)"
         },
         "week": [
             "Monday",
diff --git a/resources/lang/fr.json b/resources/lang/fr.json
index 66fdf06..cd35cb9 100644
--- a/resources/lang/fr.json
+++ b/resources/lang/fr.json
@@ -6,7 +6,8 @@
             "every_week": "Toutes les semaines",
             "every_month": "Tous les mois",
             "every_year": "Tous les ans",
-            "custom": "Personnalisé (crontab)"
+            "custom": "Personnalisé (crontab)",
+            "one_time": "Une seule fois (puis suppression)"
         },
         "week": [
             "Lundi",
diff --git a/resources/ts/components/CronInput.vue b/resources/ts/components/CronInput.vue
index db61cae..e24a2d3 100644
--- a/resources/ts/components/CronInput.vue
+++ b/resources/ts/components/CronInput.vue
@@ -82,6 +82,9 @@ watch(cron, () => {
             <option :value="CronType.CUSTOM">
                 {{ $t("cron.type.custom") }}
             </option>
+            <option :value="CronType.ONE_TIME">
+                {{ $t("cron.type.one_time") }}
+            </option>
         </select>
         <select
             v-if="cronType === CronType.EVERY_DAY"
diff --git a/resources/ts/components/TaskItem.vue b/resources/ts/components/TaskItem.vue
index 7e10939..833d7ff 100644
--- a/resources/ts/components/TaskItem.vue
+++ b/resources/ts/components/TaskItem.vue
@@ -17,6 +17,7 @@ import { isTemporary, taskCompleted, taskNextReset } from "@/lib/tasks";
 import { relativeTime } from "@/lib/dates";
 import { useAlertStore } from "@/stores/alerts";
 import { useI18n } from "vue-i18n";
+import { isOneTime } from "@/lib/cron";
 
 const emit =
     defineEmits<(e: "clone" | "delete" | "updated", task: Task) => void>();
@@ -75,20 +76,24 @@ function onSave() {
 function onCheck() {
     if (!isTemporary(task.value)) {
         if (!checked.value) {
-            const data = {
-                check_date: new Date().toISOString(),
-                previous_check_date: task.value.check_date?.toISOString(),
-            };
-            task.value.previous_check_date = task.value.check_date;
-            task.value.check_date = new Date();
-            updateTask(task.value.id, data)
-                .then((data) => {
-                    task.value = data;
-                    emit("updated", data);
-                })
-                .catch(() => {
-                    alertError(i18n.t("alerts.task_update_error"));
-                });
+            if (isOneTime(task.value.reset_cron)) {
+                emit("delete", task.value);
+            } else {
+                const data = {
+                    check_date: new Date().toISOString(),
+                    previous_check_date: task.value.check_date?.toISOString(),
+                };
+                task.value.previous_check_date = task.value.check_date;
+                task.value.check_date = new Date();
+                updateTask(task.value.id, data)
+                    .then((data) => {
+                        task.value = data;
+                        emit("updated", data);
+                    })
+                    .catch(() => {
+                        alertError(i18n.t("alerts.task_update_error"));
+                    });
+            }
         } else {
             const data = {
                 check_date: null,
diff --git a/resources/ts/enums.ts b/resources/ts/enums.ts
index 8f3004b..05d0366 100644
--- a/resources/ts/enums.ts
+++ b/resources/ts/enums.ts
@@ -5,6 +5,7 @@ export enum CronType {
     EVERY_MONTH,
     EVERY_YEAR,
     CUSTOM,
+    ONE_TIME,
 }
 
 export enum SortType {
diff --git a/resources/ts/lib/cron.ts b/resources/ts/lib/cron.ts
index 4da8c57..ff2a3b4 100644
--- a/resources/ts/lib/cron.ts
+++ b/resources/ts/lib/cron.ts
@@ -1,6 +1,8 @@
 import { CronType } from "@/enums";
 import { CronExpressionParser } from "cron-parser";
 
+const ONE_TIME_VALUE = "@one-time";
+
 export function parseCron(cron: string | null): {
     type: CronType;
     value: number;
@@ -11,6 +13,11 @@ export function parseCron(cron: string | null): {
             type: CronType.MANUAL,
             value: 0,
         };
+    } else if (cron === ONE_TIME_VALUE) {
+        return {
+            type: CronType.ONE_TIME,
+            value: 0,
+        };
     } else if ((value = /^0 (\d+) \* \* \*$/i.exec(cron)) !== null) {
         return {
             type: CronType.EVERY_DAY,
@@ -45,6 +52,8 @@ export function getCron(
     fallback: string,
 ): string | null {
     switch (type) {
+        case CronType.ONE_TIME:
+            return ONE_TIME_VALUE;
         case CronType.EVERY_DAY:
             return `0 ${value.toFixed(0)} * * *`;
         case CronType.EVERY_WEEK:
@@ -62,6 +71,10 @@ export function getCron(
     return null;
 }
 
+export function isOneTime(cron: string | null): boolean {
+    return cron === ONE_TIME_VALUE;
+}
+
 export function validCron(cron: string): boolean {
     try {
         CronExpressionParser.parse(cron);
diff --git a/resources/ts/lib/tasks.ts b/resources/ts/lib/tasks.ts
index 7c5a071..8c5988b 100644
--- a/resources/ts/lib/tasks.ts
+++ b/resources/ts/lib/tasks.ts
@@ -1,6 +1,7 @@
 import { SortType } from "@/enums";
 import type { RawTask, Task, TaskCreateData } from "@/types";
 import { CronExpressionParser } from "cron-parser";
+import { isOneTime } from "@/lib/cron";
 
 const TEMPORARY_ID = "tmp";
 
@@ -27,7 +28,7 @@ export function newTemporaryTask(data: TaskCreateData): Task {
         updated_at: new Date(),
         check_date: null,
         previous_check_date: null,
-    }
+    };
 }
 
 export function isTemporary(task: Task): boolean {
@@ -35,7 +36,11 @@ export function isTemporary(task: Task): boolean {
 }
 
 export function taskNextReset(task: Task): Date | null {
-    if (task.check_date === null || task.reset_cron === null) {
+    if (
+        task.check_date === null ||
+        task.reset_cron === null ||
+        isOneTime(task.reset_cron)
+    ) {
         return null;
     }
     try {