@webiny/background-tasks 0.0.0-unstable.7be00a75a9 → 6.4.0-beta.4

package/api/crud/crud.tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/crud/crud.tasks.js","sources":["../../../src/api/crud/crud.tasks.ts"],"sourcesContent":["import WebinyError from \"@webiny/error\";\nimport type {\n    Context,\n    IListTaskLogParams,\n    IListTaskParams,\n    ITaskCreateData,\n    ITaskLog,\n    ITaskLogCreateInput,\n    ITaskLogUpdateInput,\n    ITasksContextCrudObject,\n    ITaskUpdateData\n} from \"~/api/types.js\";\nimport { TaskDataStatus } from \"~/api/types.js\";\nimport { WEBINY_TASK_MODEL_ID } from \"./TaskPrivateModel.js\";\nimport { WEBINY_TASK_LOG_MODEL_ID } from \"./TaskLogPrivateModel.js\";\nimport type { CmsEntry, CmsModel } from \"@webiny/api-headless-cms/types/index.js\";\nimport { NotFoundError } from \"@webiny/handler-graphql\";\nimport { createZodError, parseIdentifier } from \"@webiny/utils\";\nimport zod from \"zod\";\nimport type { GenericRecord } from \"@webiny/api/types.js\";\nimport { GetModelUseCase } from \"@webiny/api-headless-cms/features/contentModel/GetModel\";\nimport { GetEntryByIdUseCase } from \"@webiny/api-headless-cms/features/contentEntry/GetEntryById\";\nimport { ListLatestEntriesUseCase } from \"@webiny/api-headless-cms/features/contentEntry/ListEntries\";\nimport { CreateEntryUseCase } from \"@webiny/api-headless-cms/features/contentEntry/CreateEntry\";\nimport { UpdateEntryUseCase } from \"@webiny/api-headless-cms/features/contentEntry/UpdateEntry\";\nimport { DeleteEntryUseCase } from \"@webiny/api-headless-cms/features/contentEntry/DeleteEntry\";\nimport { IdentityContext } from \"@webiny/api-core/features/security/IdentityContext/index.js\";\nimport {\n    TaskDefinitionNotFoundError,\n    TaskLogNotFoundError,\n    TaskNotFoundError\n} from \"~/api/domain/errors.js\";\nimport { TaskService } from \"@webiny/api-core/features/task/TaskService/index.js\";\nimport { TaskDefinition } from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\nimport { EventPublisher } from \"@webiny/api-core/features/eventPublisher/index.js\";\nimport {\n    TaskAfterCreateEvent,\n    TaskAfterDeleteEvent,\n    TaskAfterUpdateEvent,\n    TaskBeforeCreateEvent,\n    TaskBeforeDeleteEvent,\n    TaskBeforeUpdateEvent\n} from \"~/api/events/index.js\";\nimport { CmsWhereMapper } from \"@webiny/api-headless-cms\";\nimport { createCleanupTaskSubtree } from \"./cleanupTaskSubtree.js\";\n\nconst createRevisionId = (id: string) => {\n    const { id: entryId } = parseIdentifier(id);\n    return `${entryId}#0001`;\n};\n\nconst convertToTask = <\n    T extends TaskService.TaskInput = TaskService.TaskInput,\n    O extends TaskService.GenericOutput = TaskService.GenericOutput\n>(\n    entry: CmsEntry<TaskService.Task<T, O>>\n): TaskService.Task<T, O> => {\n    return {\n        id: entry.entryId,\n        createdOn: entry.createdOn,\n        savedOn: entry.savedOn,\n        createdBy: entry.createdBy,\n        name: entry.values.name,\n        definitionId: entry.values.definitionId,\n        input: entry.values.input,\n        output: entry.values.output,\n        taskStatus: entry.values.taskStatus,\n        executionName: entry.values.executionName || \"\",\n        eventResponse: entry.values.eventResponse,\n        startedOn: entry.values.startedOn,\n        finishedOn: entry.values.finishedOn,\n        iterations: entry.values.iterations,\n        parentId: entry.values.parentId\n    };\n};\n\nconst convertToLog = (entry: CmsEntry<ITaskLog>): ITaskLog => {\n    return {\n        id: entry.entryId,\n        createdOn: entry.createdOn,\n        createdBy: entry.createdBy,\n        executionName: entry.values.executionName,\n        task: entry.values.task,\n        iteration: entry.values.iteration,\n        items: entry.values.items || []\n    };\n};\n\ninterface IValidateParams {\n    definition: Pick<TaskDefinition.Interface, \"createInputValidation\">;\n    data: Pick<ITaskCreateData, \"input\">;\n    context: Context;\n}\n\nconst getZodSchema = (schema: GenericRecord<string, zod.ZodTypeAny> | zod.ZodTypeAny) => {\n    if (!schema) {\n        return zod.looseObject({});\n    } else if (schema instanceof zod.ZodObject) {\n        return schema.loose();\n    } else if (schema instanceof zod.ZodType) {\n        return schema;\n    }\n    return zod.looseObject(schema);\n};\n\nconst validateTaskInput = async (params: IValidateParams) => {\n    const { definition, data } = params;\n    if (!definition.createInputValidation) {\n        return;\n    }\n    const schema = definition.createInputValidation({\n        validator: zod\n    });\n    /**\n     * If the schema is not an object, we need to wrap it with the `object` function.\n     */\n    const validate = getZodSchema(schema);\n\n    const result = await validate.safeParseAsync(data.input);\n    if (result.success) {\n        return;\n    }\n    throw createZodError(result.error);\n};\n\nexport const createTaskCrud = (context: Context): ITasksContextCrudObject => {\n    const cmsWhereMapper = context.container.resolve(CmsWhereMapper);\n\n    const getTaskModel = async (): Promise<CmsModel> => {\n        const identityContext = context.container.resolve(IdentityContext);\n        return await identityContext.withoutAuthorization(async () => {\n            const getModel = context.container.resolve(GetModelUseCase);\n            const result = await getModel.execute(WEBINY_TASK_MODEL_ID);\n            if (result.isFail()) {\n                throw new WebinyError(`There is no model \"${WEBINY_TASK_MODEL_ID}\".`);\n            }\n            return result.value;\n        });\n    };\n\n    const getLogModel = async (): Promise<CmsModel> => {\n        const identityContext = context.container.resolve(IdentityContext);\n        return await identityContext.withoutAuthorization(async () => {\n            const getModel = context.container.resolve(GetModelUseCase);\n            const result = await getModel.execute(WEBINY_TASK_LOG_MODEL_ID);\n            if (result.isFail()) {\n                throw new WebinyError(`There is no model \"${WEBINY_TASK_LOG_MODEL_ID}\".`);\n            }\n            return result.value;\n        });\n    };\n\n    const getTask = async <\n        T extends TaskService.TaskInput = TaskService.TaskInput,\n        O extends TaskService.GenericOutput = TaskService.GenericOutput\n    >(\n        id: string\n    ) => {\n        const identityContext = context.container.resolve(IdentityContext);\n\n        const entry = await identityContext.withoutAuthorization(async () => {\n            const model = await getTaskModel();\n            const getEntryById = context.container.resolve(GetEntryByIdUseCase);\n            const result = await getEntryById.execute(model, createRevisionId(id));\n            if (result.isFail()) {\n                return null;\n            }\n            return result.value;\n        });\n\n        if (!entry) {\n            return null;\n        }\n\n        return convertToTask(entry as unknown as CmsEntry<TaskService.Task<T, O>>);\n    };\n\n    const listTasks = async <\n        T extends TaskService.TaskInput = TaskService.TaskInput,\n        O extends TaskService.GenericOutput = TaskService.GenericOutput\n    >(\n        params?: IListTaskParams\n    ) => {\n        const identityContext = context.container.resolve(IdentityContext);\n        const { entries, meta } = await identityContext.withoutAuthorization(async () => {\n            const model = await getTaskModel();\n            const listLatestEntries = context.container.resolve(ListLatestEntriesUseCase);\n            const result = await listLatestEntries.execute<TaskService.Task<T, O>>(model, {\n                ...params,\n                where: cmsWhereMapper.map({\n                    input: params?.where,\n                    fields: model.fields\n                })\n            });\n            if (result.isFail()) {\n                throw result.error;\n            }\n            return result.value;\n        });\n\n        return {\n            items: entries.map(item => convertToTask<T, O>(item)),\n            meta\n        };\n    };\n\n    const createTask = async (data: ITaskCreateData) => {\n        const definition = context.tasks.getDefinition(data.definitionId);\n        if (!definition) {\n            throw new TaskDefinitionNotFoundError(data.definitionId);\n        }\n\n        await validateTaskInput({\n            context,\n            definition,\n            data\n        });\n\n        const identityContext = context.container.resolve(IdentityContext);\n        const eventPublisher = context.container.resolve(EventPublisher);\n\n        const beforeCreateEvent = new TaskBeforeCreateEvent({\n            input: data\n        });\n        await eventPublisher.publish(beforeCreateEvent);\n\n        const result = await identityContext.withoutAuthorization(async () => {\n            const model = await getTaskModel();\n            const createEntry = context.container.resolve(CreateEntryUseCase);\n            return createEntry.execute(model, {\n                values: {\n                    ...data,\n                    iterations: 0,\n                    taskStatus: TaskDataStatus.PENDING\n                }\n            });\n        });\n\n        if (result.isFail()) {\n            throw result.error;\n        }\n\n        const task = convertToTask(result.value as unknown as CmsEntry<TaskService.Task>);\n\n        const afterCreateEvent = new TaskAfterCreateEvent({\n            input: data,\n            task\n        });\n        await eventPublisher.publish(afterCreateEvent);\n\n        return task;\n    };\n\n    const updateTask = async <\n        T extends TaskService.TaskInput = TaskService.TaskInput,\n        O extends TaskService.GenericOutput = TaskService.GenericOutput\n    >(\n        id: string,\n        data: ITaskUpdateData<T, O>\n    ) => {\n        const original = await getTask<T, O>(id);\n        if (!original) {\n            throw new TaskNotFoundError();\n        }\n\n        const identityContext = context.container.resolve(IdentityContext);\n        const eventPublisher = context.container.resolve(EventPublisher);\n\n        const beforeUpdateEvent = new TaskBeforeUpdateEvent({\n            input: data,\n            original\n        });\n        await eventPublisher.publish(beforeUpdateEvent);\n\n        const result = await identityContext.withoutAuthorization(async () => {\n            const model = await getTaskModel();\n            const updateEntry = context.container.resolve(UpdateEntryUseCase);\n            return updateEntry.execute(model, createRevisionId(id), {\n                values: {\n                    ...data\n                }\n            });\n        });\n\n        if (result.isFail()) {\n            throw result.error;\n        }\n\n        const task = convertToTask<T, O>(\n            result.value as unknown as CmsEntry<TaskService.Task<T, O>>\n        );\n\n        const afterUpdateEvent = new TaskAfterUpdateEvent({\n            input: data,\n            task\n        });\n        await eventPublisher.publish(afterUpdateEvent);\n\n        return task;\n    };\n\n    const deleteTask = async (id: string) => {\n        const task = await getTask(id);\n        if (!task) {\n            throw new TaskNotFoundError();\n        }\n\n        const identityContext = context.container.resolve(IdentityContext);\n        const eventPublisher = context.container.resolve(EventPublisher);\n\n        const beforeDeleteEvent = new TaskBeforeDeleteEvent({\n            task\n        });\n        await eventPublisher.publish(beforeDeleteEvent);\n\n        const result = await identityContext.withoutAuthorization(async () => {\n            const model = await getTaskModel();\n            const deleteEntry = context.container.resolve(DeleteEntryUseCase);\n            return deleteEntry.execute(model, createRevisionId(id));\n        });\n\n        if (result.isFail()) {\n            throw new TaskNotFoundError();\n        }\n\n        const afterDeleteEvent = new TaskAfterDeleteEvent({ task });\n        await eventPublisher.publish(afterDeleteEvent);\n\n        return true;\n    };\n\n    const createLog = async (task: Pick<TaskService.Task, \"id\">, data: ITaskLogCreateInput) => {\n        const identityContext = context.container.resolve(IdentityContext);\n        const result = await identityContext.withoutAuthorization(async () => {\n            const model = await getLogModel();\n            const createEntry = context.container.resolve(CreateEntryUseCase);\n            return createEntry.execute(model, {\n                values: {\n                    ...data,\n                    task: task.id\n                }\n            });\n        });\n\n        if (result.isFail()) {\n            throw result.error;\n        }\n\n        return convertToLog(result.value as unknown as CmsEntry<ITaskLog>);\n    };\n\n    const updateLog = async (id: string, data: ITaskLogUpdateInput) => {\n        const identityContext = context.container.resolve(IdentityContext);\n        const result = await identityContext.withoutAuthorization(async () => {\n            const model = await getLogModel();\n            const updateEntry = context.container.resolve(UpdateEntryUseCase);\n            return updateEntry.execute(model, createRevisionId(id), {\n                values: data\n            });\n        });\n\n        if (result.isFail()) {\n            throw new TaskLogNotFoundError();\n        }\n\n        return convertToLog(result.value as unknown as CmsEntry<ITaskLog>);\n    };\n\n    const deleteLog = async (id: string) => {\n        const identityContext = context.container.resolve(IdentityContext);\n        const result = await identityContext.withoutAuthorization(async () => {\n            const model = await getLogModel();\n            const deleteEntry = context.container.resolve(DeleteEntryUseCase);\n            return deleteEntry.execute(model, id);\n        });\n\n        if (result.isFail()) {\n            throw new TaskLogNotFoundError();\n        }\n\n        return true;\n    };\n\n    const getLog = async (id: string): Promise<ITaskLog | null> => {\n        const identityContext = context.container.resolve(IdentityContext);\n        try {\n            const result = await identityContext.withoutAuthorization(async () => {\n                const model = await getLogModel();\n                const getEntryById = context.container.resolve(GetEntryByIdUseCase);\n                return getEntryById.execute(model, id);\n            });\n\n            if (result.isFail()) {\n                throw result.error;\n            }\n\n            return convertToLog(result.value as unknown as CmsEntry<ITaskLog>);\n        } catch (ex) {\n            if (ex instanceof NotFoundError) {\n                return null;\n            }\n            throw ex;\n        }\n    };\n\n    const getLatestLog = async (taskId: string): Promise<ITaskLog> => {\n        const identityContext = context.container.resolve(IdentityContext);\n        const entry = await identityContext.withoutAuthorization(async () => {\n            const model = await getLogModel();\n            const listLatestEntries = context.container.resolve(ListLatestEntriesUseCase);\n            const result = await listLatestEntries.execute<ITaskLog>(model, {\n                where: {\n                    values: {\n                        task: taskId\n                    }\n                },\n                sort: [\"createdOn_DESC\"],\n                limit: 1\n            });\n            if (result.isFail()) {\n                throw result.error;\n            }\n            const { entries } = result.value;\n            const [item] = entries;\n            if (!item) {\n                throw new NotFoundError(`No existing latest log found for task \"${taskId}\".`);\n            }\n            return item;\n        });\n\n        return convertToLog(entry as unknown as CmsEntry<ITaskLog>);\n    };\n\n    const cleanupTaskSubtree = createCleanupTaskSubtree(context);\n\n    const listLogs = async (params: IListTaskLogParams) => {\n        const identityContext = context.container.resolve(IdentityContext);\n        const { entries, meta } = await identityContext.withoutAuthorization(async () => {\n            const model = await getLogModel();\n            const listLatestEntries = context.container.resolve(ListLatestEntriesUseCase);\n            const result = await listLatestEntries.execute<ITaskLog>(model, {\n                ...params,\n                where: cmsWhereMapper.map({\n                    input: params.where,\n                    fields: model.fields\n                })\n            });\n            if (result.isFail()) {\n                throw result.error;\n            }\n            return result.value;\n        });\n\n        return {\n            items: entries.map(item => convertToLog(item)),\n            meta\n        };\n    };\n\n    return {\n        getTask,\n        listTasks,\n        createTask,\n        updateTask,\n        deleteTask,\n        cleanupTaskSubtree,\n        createLog,\n        updateLog,\n        deleteLog,\n        getLog,\n        listLogs,\n        getLatestLog,\n        getTaskModel,\n        getLogModel\n    };\n};\n"],"names":["createRevisionId","id","entryId","parseIdentifier","convertToTask","entry","convertToLog","getZodSchema","schema","zod","validateTaskInput","params","definition","data","validate","result","createZodError","createTaskCrud","context","cmsWhereMapper","CmsWhereMapper","getTaskModel","identityContext","IdentityContext","getModel","GetModelUseCase","WEBINY_TASK_MODEL_ID","WebinyError","getLogModel","WEBINY_TASK_LOG_MODEL_ID","getTask","model","getEntryById","GetEntryByIdUseCase","listTasks","entries","meta","listLatestEntries","ListLatestEntriesUseCase","item","createTask","TaskDefinitionNotFoundError","eventPublisher","EventPublisher","beforeCreateEvent","TaskBeforeCreateEvent","createEntry","CreateEntryUseCase","TaskDataStatus","task","afterCreateEvent","TaskAfterCreateEvent","updateTask","original","TaskNotFoundError","beforeUpdateEvent","TaskBeforeUpdateEvent","updateEntry","UpdateEntryUseCase","afterUpdateEvent","TaskAfterUpdateEvent","deleteTask","beforeDeleteEvent","TaskBeforeDeleteEvent","deleteEntry","DeleteEntryUseCase","afterDeleteEvent","TaskAfterDeleteEvent","createLog","updateLog","TaskLogNotFoundError","deleteLog","getLog","ex","NotFoundError","getLatestLog","taskId","cleanupTaskSubtree","createCleanupTaskSubtree","listLogs"],"mappings":"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"}

package/api/crud/definition.tasks.d.ts

@@ -0,0 +1,2 @@
+import type { Context, ITasksContextDefinitionObject } from "../../api/types.js";
+export declare const createDefinitionCrud: (context: Context) => ITasksContextDefinitionObject;

package/api/crud/definition.tasks.js

@@ -0,0 +1,17 @@
+import { GetTaskDefinitionUseCase } from "../features/GetTaskDefinition/index.js";
+import { ListTaskDefinitionsUseCase } from "../features/ListTaskDefinitions/index.js";
+const createDefinitionCrud = (context)=>({
+        getDefinition: (id)=>{
+            const useCase = context.container.resolve(GetTaskDefinitionUseCase);
+            const result = useCase.execute(id);
+            if (result.isOk()) return result.value;
+            return null;
+        },
+        listDefinitions: ()=>{
+            const useCase = context.container.resolve(ListTaskDefinitionsUseCase);
+            return useCase.execute();
+        }
+    });
+export { createDefinitionCrud };
+
+//# sourceMappingURL=definition.tasks.js.map

package/api/crud/definition.tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/crud/definition.tasks.js","sources":["../../../src/api/crud/definition.tasks.ts"],"sourcesContent":["import type { Context, ITasksContextDefinitionObject } from \"~/api/types.js\";\nimport { TaskDefinition } from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\nimport { GetTaskDefinitionUseCase } from \"~/api/features/GetTaskDefinition/index.js\";\nimport { ListTaskDefinitionsUseCase } from \"~/api/features/ListTaskDefinitions/index.js\";\n\nexport const createDefinitionCrud = (context: Context): ITasksContextDefinitionObject => {\n    return {\n        getDefinition: <\n            I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput,\n            O extends TaskDefinition.TaskOutput = TaskDefinition.TaskOutput\n        >(\n            id: string\n        ) => {\n            const useCase = context.container.resolve(GetTaskDefinitionUseCase);\n            const result = useCase.execute<I, O>(id);\n\n            if (result.isOk()) {\n                return result.value;\n            }\n\n            return null;\n        },\n        listDefinitions: () => {\n            const useCase = context.container.resolve(ListTaskDefinitionsUseCase);\n            return useCase.execute();\n        }\n    };\n};\n"],"names":["createDefinitionCrud","context","id","useCase","GetTaskDefinitionUseCase","result","ListTaskDefinitionsUseCase"],"mappings":";;AAKO,MAAMA,uBAAuB,CAACC,UAC1B;QACH,eAAe,CAIXC;YAEA,MAAMC,UAAUF,QAAQ,SAAS,CAAC,OAAO,CAACG;YAC1C,MAAMC,SAASF,QAAQ,OAAO,CAAOD;YAErC,IAAIG,OAAO,IAAI,IACX,OAAOA,OAAO,KAAK;YAGvB,OAAO;QACX;QACA,iBAAiB;YACb,MAAMF,UAAUF,QAAQ,SAAS,CAAC,OAAO,CAACK;YAC1C,OAAOH,QAAQ,OAAO;QAC1B;IACJ"}

package/api/crud/service.tasks.d.ts

@@ -0,0 +1,2 @@
+import type { Context, ITasksContextServiceObject } from "../../api/types.js";
+export declare const createServiceCrud: (context: Context) => ITasksContextServiceObject;

package/api/crud/service.tasks.js

@@ -0,0 +1,130 @@
+import error from "@webiny/error";
+import { TaskDataStatus, TaskLogItemType } from "../types.js";
+import { NotFoundError } from "@webiny/handler-graphql";
+import { createService } from "../service/index.js";
+import { Result } from "@webiny/feature/api";
+import { TaskAbortError, TaskDefinitionNotFoundError, TaskNotFoundError, TaskServiceInfoError } from "../domain/errors.js";
+const MAX_DELAY_DAYS = 355;
+const MAX_DELAY_SECONDS = 24 * MAX_DELAY_DAYS * 3600;
+const validateDelay = ({ input, delay })=>{
+    if (!delay || delay < 0 || "number" != typeof delay || false === Number.isInteger(delay)) return;
+    if (delay < MAX_DELAY_SECONDS) return;
+    throw new error(`The maximum delay for a task is ${MAX_DELAY_DAYS} days.`, "MAX_DELAY_ERROR", {
+        ...input,
+        delay
+    });
+};
+const createServiceCrud = (context)=>{
+    const service = createService({
+        context
+    });
+    return {
+        trigger: async (params)=>{
+            const { definition: id, input: inputValues, name, parent, delay = 0 } = params;
+            const definition = context.tasks.getDefinition(id);
+            if (!definition) throw new error("Task definition was not found!", "TASK_DEFINITION_ERROR", {
+                id
+            });
+            const input = {
+                name: name || definition.title,
+                definitionId: id,
+                input: inputValues || {},
+                parentId: parent?.id
+            };
+            if (definition.onBeforeTrigger) await definition.onBeforeTrigger({
+                data: input
+            });
+            validateDelay({
+                input,
+                delay
+            });
+            let task;
+            try {
+                task = await context.tasks.createTask(input);
+            } catch (ex) {
+                console.log("Could not create the task.", ex);
+                throw ex;
+            }
+            let result = null;
+            try {
+                result = await service.send(task, delay);
+                if (!result) throw new error("Could not trigger the step function!", "TRIGGER_STEP_FUNCTION_ERROR", {
+                    task
+                });
+            } catch (ex) {
+                console.log("Could not trigger the step function.");
+                console.error(ex);
+                await context.tasks.deleteTask(task.id);
+                throw ex;
+            }
+            const updatedTask = await context.tasks.updateTask(task.id, {
+                eventResponse: result
+            });
+            return Result.ok(updatedTask);
+        },
+        fetchServiceInfo: async (input)=>{
+            const task = "object" == typeof input ? input : await context.tasks.getTask(input);
+            if (task || "string" != typeof input) {
+                if (!task) throw new error("Task was not found!", "TASK_FETCH_ERROR", {
+                    input
+                });
+            } else throw new NotFoundError(`Task "${input}" was not found!`);
+            try {
+                const info = await service.fetch(task);
+                if (info) return Result.ok(info);
+                return Result.fail(new TaskServiceInfoError());
+            } catch (ex) {
+                console.log("Service fetch error.");
+                console.error(ex);
+                return Result.fail(new TaskServiceInfoError());
+            }
+        },
+        abort: async (params)=>{
+            const task = await context.tasks.getTask(params.id);
+            if (!task) return Result.fail(new TaskNotFoundError());
+            const definition = context.tasks.getDefinition(task.definitionId);
+            if (!definition) return Result.fail(new TaskDefinitionNotFoundError(task.definitionId));
+            if (false === [
+                TaskDataStatus.PENDING,
+                TaskDataStatus.RUNNING
+            ].includes(task.taskStatus)) return Result.fail(new TaskAbortError({
+                id: params.id,
+                status: task.taskStatus
+            }));
+            let taskLog = null;
+            try {
+                taskLog = await context.tasks.getLatestLog(task.id);
+            } catch  {}
+            if (!taskLog) taskLog = await context.tasks.createLog(task, {
+                iteration: 1,
+                executionName: task.executionName
+            });
+            try {
+                const updatedTask = await context.tasks.updateTask(task.id, {
+                    taskStatus: TaskDataStatus.ABORTED
+                });
+                await context.tasks.updateLog(taskLog.id, {
+                    items: taskLog.items.concat([
+                        {
+                            message: params.message || "Task aborted.",
+                            type: TaskLogItemType.INFO,
+                            createdOn: new Date().toISOString()
+                        }
+                    ])
+                });
+                if (definition.onAbort) await definition.onAbort({
+                    task: updatedTask
+                });
+                return Result.ok(updatedTask);
+            } catch (ex) {
+                throw new error("Could not abort the task!", "TASK_ABORT_ERROR", {
+                    id: params.id,
+                    message: ex.message
+                });
+            }
+        }
+    };
+};
+export { createServiceCrud };
+
+//# sourceMappingURL=service.tasks.js.map

package/api/crud/service.tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/crud/service.tasks.js","sources":["../../../src/api/crud/service.tasks.ts"],"sourcesContent":["import WebinyError from \"@webiny/error\";\nimport type {\n    Context,\n    ITaskAbortParams,\n    ITaskCreateData,\n    ITaskLog,\n    ITasksContextServiceObject,\n    ITaskTriggerParams\n} from \"~/api/types.js\";\nimport { TaskDataStatus, TaskLogItemType } from \"~/api/types.js\";\nimport { NotFoundError } from \"@webiny/handler-graphql\";\nimport { createService } from \"~/api/service/index.js\";\nimport type { IStepFunctionServiceFetchResult } from \"~/api/service/StepFunctionServicePlugin.js\";\nimport { TaskService } from \"@webiny/api-core/features/task/TaskService/index.js\";\nimport { TaskDefinition } from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\nimport { BaseError, Result } from \"@webiny/feature/api\";\nimport {\n    TaskAbortError,\n    TaskDefinitionNotFoundError,\n    TaskNotFoundError,\n    TaskServiceInfoError\n} from \"~/api/domain/errors.js\";\n\nconst MAX_DELAY_DAYS = 355;\nconst MAX_DELAY_SECONDS = MAX_DELAY_DAYS * 24 * 60 * 60;\n\ninterface ValidateDelayParams<T extends TaskService.TaskInput> {\n    input: ITaskCreateData<T>;\n    delay?: number;\n}\n\nconst validateDelay = <T extends TaskService.TaskInput = TaskService.TaskInput>({\n    input,\n    delay\n}: ValidateDelayParams<T>): void => {\n    if (!delay || delay < 0 || typeof delay !== \"number\" || Number.isInteger(delay) === false) {\n        return;\n    } else if (delay < MAX_DELAY_SECONDS) {\n        return;\n    }\n    throw new WebinyError(\n        `The maximum delay for a task is ${MAX_DELAY_DAYS} days.`,\n        \"MAX_DELAY_ERROR\",\n        {\n            ...input,\n            delay\n        }\n    );\n};\n\nexport const createServiceCrud = (context: Context): ITasksContextServiceObject => {\n    const service = createService({\n        context\n    });\n\n    return {\n        trigger: async <\n            T extends TaskService.TaskInput = TaskService.TaskInput,\n            O extends TaskService.GenericOutput = TaskService.GenericOutput\n        >(\n            params: ITaskTriggerParams<T>\n        ): Promise<Result<TaskService.Task<T, O>, BaseError>> => {\n            const { definition: id, input: inputValues, name, parent, delay = 0 } = params;\n            const definition = context.tasks.getDefinition(id);\n            if (!definition) {\n                throw new WebinyError(`Task definition was not found!`, \"TASK_DEFINITION_ERROR\", {\n                    id\n                });\n            }\n            const input: TaskDefinition.TaskCreateData<T> = {\n                name: name || definition.title,\n                definitionId: id,\n                input: inputValues || ({} as T),\n                parentId: parent?.id\n            };\n\n            if (definition.onBeforeTrigger) {\n                await definition.onBeforeTrigger({ data: input });\n            }\n            validateDelay<T>({\n                input,\n                delay\n            });\n\n            let task: TaskService.Task<T>;\n            try {\n                task = await context.tasks.createTask<T>(input);\n            } catch (ex) {\n                console.log(\"Could not create the task.\", ex);\n                throw ex;\n            }\n\n            let result: Awaited<ReturnType<typeof service.send>> | null = null;\n            try {\n                result = await service.send(task, delay);\n\n                if (!result) {\n                    throw new WebinyError(\n                        `Could not trigger the step function!`,\n                        \"TRIGGER_STEP_FUNCTION_ERROR\",\n                        {\n                            task\n                        }\n                    );\n                }\n            } catch (ex) {\n                console.log(\"Could not trigger the step function.\");\n                console.error(ex);\n                /**\n                 * In case of failure to create the Event Bridge Event, we need to delete the task that was meant to be created.\n                 * TODO maybe we can leave the task and update it as failed - with event bridge error?\n                 */\n                await context.tasks.deleteTask(task.id);\n                throw ex;\n            }\n\n            const updatedTask = await context.tasks.updateTask<T, O>(task.id, {\n                eventResponse: result\n            });\n\n            return Result.ok(updatedTask);\n        },\n        fetchServiceInfo: async (\n            input: TaskService.Task | string\n        ): Promise<Result<IStepFunctionServiceFetchResult, BaseError<any>>> => {\n            const task = typeof input === \"object\" ? input : await context.tasks.getTask(input);\n            if (!task && typeof input === \"string\") {\n                throw new NotFoundError(`Task \"${input}\" was not found!`);\n            } else if (!task) {\n                throw new WebinyError(`Task was not found!`, \"TASK_FETCH_ERROR\", {\n                    input\n                });\n            }\n\n            try {\n                const info = (await service.fetch(task)) as IStepFunctionServiceFetchResult | null;\n                if (info) {\n                    return Result.ok(info);\n                }\n\n                return Result.fail(new TaskServiceInfoError());\n            } catch (ex) {\n                console.log(\"Service fetch error.\");\n                console.error(ex);\n                return Result.fail(new TaskServiceInfoError());\n            }\n        },\n        abort: async <\n            T extends TaskService.TaskInput = TaskService.TaskInput,\n            O extends TaskService.GenericOutput = TaskService.GenericOutput\n        >(\n            params: ITaskAbortParams\n        ): Promise<Result<TaskService.Task<T, O>, BaseError<any>>> => {\n            const task = await context.tasks.getTask<T, O>(params.id);\n            if (!task) {\n                return Result.fail(new TaskNotFoundError());\n            }\n\n            const definition = context.tasks.getDefinition<T, O>(task.definitionId);\n            if (!definition) {\n                return Result.fail(new TaskDefinitionNotFoundError(task.definitionId));\n            }\n            /**\n             * We should only be able to abort a task which is pending or running\n             */\n            if (\n                [TaskDataStatus.PENDING, TaskDataStatus.RUNNING].includes(task.taskStatus) === false\n            ) {\n                return Result.fail(\n                    new TaskAbortError({\n                        id: params.id,\n                        status: task.taskStatus\n                    })\n                );\n            }\n            let taskLog: ITaskLog | null = null;\n            try {\n                taskLog = await context.tasks.getLatestLog(task.id);\n            } catch {}\n            if (!taskLog) {\n                taskLog = await context.tasks.createLog(task, {\n                    iteration: 1,\n                    executionName: task.executionName\n                });\n            }\n            try {\n                const updatedTask = await context.tasks.updateTask<T, O>(task.id, {\n                    taskStatus: TaskDataStatus.ABORTED\n                });\n                await context.tasks.updateLog(taskLog.id, {\n                    items: taskLog.items.concat([\n                        {\n                            message: params.message || \"Task aborted.\",\n                            type: TaskLogItemType.INFO,\n                            createdOn: new Date().toISOString()\n                        }\n                    ])\n                });\n                /**\n                 * TODO: determine when to kick off the onAbort hook\n                 */\n                if (definition.onAbort) {\n                    await definition.onAbort({\n                        task: updatedTask\n                    });\n                }\n\n                return Result.ok(updatedTask);\n            } catch (ex) {\n                throw new WebinyError(`Could not abort the task!`, \"TASK_ABORT_ERROR\", {\n                    id: params.id,\n                    message: ex.message\n                });\n            }\n        }\n    };\n};\n"],"names":["MAX_DELAY_DAYS","MAX_DELAY_SECONDS","validateDelay","input","delay","Number","WebinyError","createServiceCrud","context","service","createService","params","id","inputValues","name","parent","definition","task","ex","console","result","updatedTask","Result","NotFoundError","info","TaskServiceInfoError","TaskNotFoundError","TaskDefinitionNotFoundError","TaskDataStatus","TaskAbortError","taskLog","TaskLogItemType","Date"],"mappings":"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"}

package/api/decorators/RunnableTaskDecorator.d.ts

@@ -0,0 +1,32 @@
+import { TaskDefinition } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+import type { ITaskDefinition } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+/**
+ * RunnableTaskDecorator adds runtime behavior to TaskDefinition:
+ * - Applies default values (maxIterations, isPrivate, databaseLogs, fields)
+ * - Validates task ID (must be camelCase)
+ * - Provides field management methods
+ */
+declare class RunnableTaskDecoratorImpl implements TaskDefinition.Interface {
+    private decoratee;
+    constructor(decoratee: TaskDefinition.Interface);
+    get id(): string;
+    get title(): string;
+    get description(): string | undefined;
+    get isPrivate(): boolean;
+    get databaseLogs(): boolean;
+    get maxIterations(): number;
+    get selfCleanup(): import("@webiny/api-core/features/task/TaskDefinition/abstractions").ISelfCleanup | undefined;
+    get createInputValidation(): ((params: import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskCreateInputValidationParams) => import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>> | import("@webiny/api/types").GenericRecord<PropertyKey, import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>>) | undefined;
+    get run(): (params: import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskRunParams<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>) => Promise<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskResult<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>>;
+    get onBeforeTrigger(): ((params: import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskBeforeTriggerParams<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput>) => Promise<void>) | undefined;
+    get onDone(): ((params: import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskLifecycleHook<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>) => Promise<void>) | undefined;
+    get onError(): ((params: import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskLifecycleHook<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>) => Promise<void>) | undefined;
+    get onAbort(): ((params: import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskLifecycleHook<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>) => Promise<void>) | undefined;
+    get onMaxIterations(): ((params: import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskLifecycleHook<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>) => Promise<void>) | undefined;
+    private validate;
+    getTask(): ITaskDefinition;
+}
+export declare const RunnableTaskDecorator: typeof RunnableTaskDecoratorImpl & {
+    __abstraction: import("@webiny/di").Abstraction<ITaskDefinition<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>>;
+};
+export {};

package/api/decorators/RunnableTaskDecorator.js

@@ -0,0 +1,69 @@
+import camelCase from "lodash/camelCase.js";
+import error from "@webiny/error";
+import { TaskDefinition } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+const DEFAULT_MAX_ITERATIONS = 50;
+class RunnableTaskDecoratorImpl {
+    constructor(decoratee){
+        this.decoratee = decoratee;
+        this.validate();
+    }
+    get id() {
+        return this.decoratee.id;
+    }
+    get title() {
+        return this.decoratee.title;
+    }
+    get description() {
+        return this.decoratee.description;
+    }
+    get isPrivate() {
+        return this.decoratee.isPrivate ?? false;
+    }
+    get databaseLogs() {
+        return this.decoratee.databaseLogs ?? false;
+    }
+    get maxIterations() {
+        return this.decoratee.maxIterations || DEFAULT_MAX_ITERATIONS;
+    }
+    get selfCleanup() {
+        return this.decoratee.selfCleanup;
+    }
+    get createInputValidation() {
+        return this.decoratee.createInputValidation;
+    }
+    get run() {
+        return this.decoratee.run.bind(this.decoratee);
+    }
+    get onBeforeTrigger() {
+        return this.decoratee.onBeforeTrigger?.bind(this.decoratee);
+    }
+    get onDone() {
+        return this.decoratee.onDone?.bind(this.decoratee);
+    }
+    get onError() {
+        return this.decoratee.onError?.bind(this.decoratee);
+    }
+    get onAbort() {
+        return this.decoratee.onAbort?.bind(this.decoratee);
+    }
+    get onMaxIterations() {
+        return this.decoratee.onMaxIterations?.bind(this.decoratee);
+    }
+    validate() {
+        if (camelCase(this.decoratee.id) !== this.decoratee.id) {
+            const message = `Task ID "${this.decoratee.id}" is invalid. It must be in camelCase format, for example: "myCustomTask".`;
+            console.log(message);
+            throw new error(message);
+        }
+    }
+    getTask() {
+        return this;
+    }
+}
+const RunnableTaskDecorator = TaskDefinition.createDecorator({
+    decorator: RunnableTaskDecoratorImpl,
+    dependencies: []
+});
+export { RunnableTaskDecorator };
+
+//# sourceMappingURL=RunnableTaskDecorator.js.map

package/api/decorators/RunnableTaskDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/decorators/RunnableTaskDecorator.js","sources":["../../../src/api/decorators/RunnableTaskDecorator.ts"],"sourcesContent":["import camelCase from \"lodash/camelCase.js\";\nimport WebinyError from \"@webiny/error\";\nimport { TaskDefinition } from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\nimport type { ITaskDefinition } from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\n\nconst DEFAULT_MAX_ITERATIONS = 50;\n\n/**\n * RunnableTaskDecorator adds runtime behavior to TaskDefinition:\n * - Applies default values (maxIterations, isPrivate, databaseLogs, fields)\n * - Validates task ID (must be camelCase)\n * - Provides field management methods\n */\nclass RunnableTaskDecoratorImpl implements TaskDefinition.Interface {\n    constructor(private decoratee: TaskDefinition.Interface) {\n        this.validate();\n    }\n\n    // Delegate simple properties\n    get id() {\n        return this.decoratee.id;\n    }\n\n    get title() {\n        return this.decoratee.title;\n    }\n\n    get description() {\n        return this.decoratee.description;\n    }\n\n    // Apply default values\n    get isPrivate() {\n        return this.decoratee.isPrivate ?? false;\n    }\n\n    get databaseLogs() {\n        return this.decoratee.databaseLogs ?? false;\n    }\n\n    get maxIterations() {\n        return this.decoratee.maxIterations || DEFAULT_MAX_ITERATIONS;\n    }\n\n    get selfCleanup() {\n        return this.decoratee.selfCleanup;\n    }\n\n    get createInputValidation() {\n        return this.decoratee.createInputValidation;\n    }\n\n    // Delegate lifecycle methods (bind to preserve context)\n    get run() {\n        return this.decoratee.run.bind(this.decoratee);\n    }\n\n    get onBeforeTrigger() {\n        return this.decoratee.onBeforeTrigger?.bind(this.decoratee);\n    }\n\n    get onDone() {\n        return this.decoratee.onDone?.bind(this.decoratee);\n    }\n\n    get onError() {\n        return this.decoratee.onError?.bind(this.decoratee);\n    }\n\n    get onAbort() {\n        return this.decoratee.onAbort?.bind(this.decoratee);\n    }\n\n    get onMaxIterations() {\n        return this.decoratee.onMaxIterations?.bind(this.decoratee);\n    }\n\n    // Validation logic\n    private validate(): void {\n        if (camelCase(this.decoratee.id) !== this.decoratee.id) {\n            const message = `Task ID \"${this.decoratee.id}\" is invalid. It must be in camelCase format, for example: \"myCustomTask\".`;\n            console.log(message);\n            throw new WebinyError(message);\n        }\n    }\n\n    // Method to get the underlying task (for compatibility with existing code)\n    public getTask(): ITaskDefinition {\n        return this;\n    }\n}\n\nexport const RunnableTaskDecorator = TaskDefinition.createDecorator({\n    decorator: RunnableTaskDecoratorImpl,\n    dependencies: []\n});\n"],"names":["DEFAULT_MAX_ITERATIONS","RunnableTaskDecoratorImpl","decoratee","camelCase","message","console","WebinyError","RunnableTaskDecorator","TaskDefinition"],"mappings":";;;AAKA,MAAMA,yBAAyB;AAQ/B,MAAMC;IACF,YAAoBC,SAAmC,CAAE;aAArCA,SAAS,GAATA;QAChB,IAAI,CAAC,QAAQ;IACjB;IAGA,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE;IAC5B;IAEA,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK;IAC/B;IAEA,IAAI,cAAc;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW;IACrC;IAGA,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,IAAI;IACvC;IAEA,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,IAAI;IAC1C;IAEA,IAAI,gBAAgB;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,IAAIF;IAC3C;IAEA,IAAI,cAAc;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW;IACrC;IAEA,IAAI,wBAAwB;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,qBAAqB;IAC/C;IAGA,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS;IACjD;IAEA,IAAI,kBAAkB;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,KAAK,IAAI,CAAC,SAAS;IAC9D;IAEA,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,SAAS;IACrD;IAEA,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,SAAS;IACtD;IAEA,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,SAAS;IACtD;IAEA,IAAI,kBAAkB;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,KAAK,IAAI,CAAC,SAAS;IAC9D;IAGQ,WAAiB;QACrB,IAAIG,UAAU,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE;YACpD,MAAMC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,0EAA0E,CAAC;YACzHC,QAAQ,GAAG,CAACD;YACZ,MAAM,IAAIE,MAAYF;QAC1B;IACJ;IAGO,UAA2B;QAC9B,OAAO,IAAI;IACf;AACJ;AAEO,MAAMG,wBAAwBC,eAAe,eAAe,CAAC;IAChE,WAAWP;IACX,cAAc,EAAE;AACpB"}

package/api/decorators/SelfCleaningTaskDecorator.d.ts

@@ -0,0 +1,30 @@
+import { TaskDefinition } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+import { CleanupTaskSubtreeUseCase } from "../../api/features/CleanupTaskSubtree/index.js";
+type LifecycleHook = TaskDefinition.Interface["onDone"];
+type HookParams = Parameters<NonNullable<LifecycleHook>>[0];
+export declare class SelfCleaningTaskDecoratorImpl implements TaskDefinition.Interface {
+    private readonly cleanupTaskSubtree;
+    private decoratee;
+    private readonly events;
+    constructor(cleanupTaskSubtree: CleanupTaskSubtreeUseCase.Interface, decoratee: TaskDefinition.Interface);
+    get id(): string;
+    get title(): string;
+    get description(): string | undefined;
+    get isPrivate(): boolean | undefined;
+    get maxIterations(): number | undefined;
+    get selfCleanup(): import("@webiny/api-core/features/task/TaskDefinition/abstractions").ISelfCleanup | undefined;
+    get createInputValidation(): ((params: import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskCreateInputValidationParams) => import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>> | import("@webiny/api/types").GenericRecord<PropertyKey, import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>>) | undefined;
+    get run(): (params: import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskRunParams<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>) => Promise<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskResult<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>>;
+    get onBeforeTrigger(): ((params: import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskBeforeTriggerParams<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput>) => Promise<void>) | undefined;
+    get onMaxIterations(): ((params: import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskLifecycleHook<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>) => Promise<void>) | undefined;
+    get databaseLogs(): boolean | undefined;
+    get onDone(): (params: HookParams) => Promise<void>;
+    get onError(): (params: HookParams) => Promise<void>;
+    get onAbort(): (params: HookParams) => Promise<void>;
+    private runCleanup;
+    private safeCall;
+}
+export declare const SelfCleaningTaskDecorator: typeof SelfCleaningTaskDecoratorImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskDefinition<import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions").ITaskOutput>>;
+};
+export {};

package/api/decorators/SelfCleaningTaskDecorator.js

@@ -0,0 +1,84 @@
+import { TaskDefinition } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+import { normalizeSelfCleanup } from "../utils/normalizeSelfCleanup.js";
+import { CleanupTaskSubtreeUseCase } from "../features/CleanupTaskSubtree/index.js";
+import { getErrorProperties } from "../utils/getErrorProperties.js";
+class SelfCleaningTaskDecoratorImpl {
+    constructor(cleanupTaskSubtree, decoratee){
+        this.cleanupTaskSubtree = cleanupTaskSubtree;
+        this.decoratee = decoratee;
+        this.events = normalizeSelfCleanup(decoratee.selfCleanup);
+    }
+    get id() {
+        return this.decoratee.id;
+    }
+    get title() {
+        return this.decoratee.title;
+    }
+    get description() {
+        return this.decoratee.description;
+    }
+    get isPrivate() {
+        return this.decoratee.isPrivate;
+    }
+    get maxIterations() {
+        return this.decoratee.maxIterations;
+    }
+    get selfCleanup() {
+        return this.decoratee.selfCleanup;
+    }
+    get createInputValidation() {
+        return this.decoratee.createInputValidation;
+    }
+    get run() {
+        return this.decoratee.run.bind(this.decoratee);
+    }
+    get onBeforeTrigger() {
+        return this.decoratee.onBeforeTrigger?.bind(this.decoratee);
+    }
+    get onMaxIterations() {
+        return this.decoratee.onMaxIterations?.bind(this.decoratee);
+    }
+    get databaseLogs() {
+        if (this.events.size > 0) return false;
+        return this.decoratee.databaseLogs;
+    }
+    get onDone() {
+        return async (params)=>{
+            await this.safeCall(this.decoratee.onDone, params, "onDone");
+            if (this.events.has("onSuccess")) await this.runCleanup(params);
+        };
+    }
+    get onError() {
+        return async (params)=>{
+            await this.safeCall(this.decoratee.onError, params, "onError");
+            if (this.events.has("onError")) await this.runCleanup(params);
+        };
+    }
+    get onAbort() {
+        return async (params)=>{
+            await this.safeCall(this.decoratee.onAbort, params, "onAbort");
+            if (this.events.has("onAbort")) await this.runCleanup(params);
+        };
+    }
+    async runCleanup(params) {
+        await this.cleanupTaskSubtree.execute(params.task.id);
+    }
+    async safeCall(hook, params, name) {
+        if (!hook) return;
+        try {
+            await hook.call(this.decoratee, params);
+        } catch (ex) {
+            console.error(`Error executing ${name} hook for task "${params.task.id}".`);
+            console.log(getErrorProperties(ex));
+        }
+    }
+}
+const SelfCleaningTaskDecorator = TaskDefinition.createDecorator({
+    decorator: SelfCleaningTaskDecoratorImpl,
+    dependencies: [
+        CleanupTaskSubtreeUseCase
+    ]
+});
+export { SelfCleaningTaskDecorator, SelfCleaningTaskDecoratorImpl };
+
+//# sourceMappingURL=SelfCleaningTaskDecorator.js.map

package/api/decorators/SelfCleaningTaskDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/decorators/SelfCleaningTaskDecorator.js","sources":["../../../src/api/decorators/SelfCleaningTaskDecorator.ts"],"sourcesContent":["import { TaskDefinition } from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\nimport type { ISelfCleanupEvent } from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\nimport { normalizeSelfCleanup } from \"~/api/utils/normalizeSelfCleanup.js\";\nimport { CleanupTaskSubtreeUseCase } from \"~/api/features/CleanupTaskSubtree/index.js\";\nimport { getErrorProperties } from \"~/api/utils/getErrorProperties.js\";\n\ntype LifecycleHook = TaskDefinition.Interface[\"onDone\"];\ntype HookParams = Parameters<NonNullable<LifecycleHook>>[0];\n\nexport class SelfCleaningTaskDecoratorImpl implements TaskDefinition.Interface {\n    private readonly events: ReadonlySet<ISelfCleanupEvent>;\n\n    public constructor(\n        private readonly cleanupTaskSubtree: CleanupTaskSubtreeUseCase.Interface,\n        private decoratee: TaskDefinition.Interface\n    ) {\n        this.events = normalizeSelfCleanup(decoratee.selfCleanup);\n    }\n\n    // Pass-through properties.\n    get id() {\n        return this.decoratee.id;\n    }\n    get title() {\n        return this.decoratee.title;\n    }\n    get description() {\n        return this.decoratee.description;\n    }\n    get isPrivate() {\n        return this.decoratee.isPrivate;\n    }\n    get maxIterations() {\n        return this.decoratee.maxIterations;\n    }\n    get selfCleanup() {\n        return this.decoratee.selfCleanup;\n    }\n    get createInputValidation() {\n        return this.decoratee.createInputValidation;\n    }\n    get run() {\n        return this.decoratee.run.bind(this.decoratee);\n    }\n    get onBeforeTrigger() {\n        return this.decoratee.onBeforeTrigger?.bind(this.decoratee);\n    }\n    get onMaxIterations() {\n        return this.decoratee.onMaxIterations?.bind(this.decoratee);\n    }\n\n    // databaseLogs override — any non-empty event set forces false.\n    get databaseLogs() {\n        if (this.events.size > 0) {\n            return false;\n        }\n        return this.decoratee.databaseLogs;\n    }\n\n    // Always-defined lifecycle hooks. Each runs the user's hook first, then\n    // triggers cleanup if the matching event is in the set.\n    get onDone() {\n        return async (params: HookParams) => {\n            await this.safeCall(this.decoratee.onDone, params, \"onDone\");\n            if (this.events.has(\"onSuccess\")) {\n                await this.runCleanup(params);\n            }\n        };\n    }\n\n    get onError() {\n        return async (params: HookParams) => {\n            await this.safeCall(this.decoratee.onError, params, \"onError\");\n            if (this.events.has(\"onError\")) {\n                await this.runCleanup(params);\n            }\n        };\n    }\n\n    get onAbort() {\n        return async (params: HookParams) => {\n            await this.safeCall(this.decoratee.onAbort, params, \"onAbort\");\n            if (this.events.has(\"onAbort\")) {\n                await this.runCleanup(params);\n            }\n        };\n    }\n\n    private async runCleanup(params: HookParams): Promise<void> {\n        await this.cleanupTaskSubtree.execute(params.task.id);\n    }\n\n    private async safeCall(\n        hook: LifecycleHook | undefined,\n        params: HookParams,\n        name: string\n    ): Promise<void> {\n        if (!hook) {\n            return;\n        }\n        try {\n            await hook.call(this.decoratee, params);\n        } catch (ex) {\n            console.error(`Error executing ${name} hook for task \"${params.task.id}\".`);\n            console.log(getErrorProperties(ex));\n        }\n    }\n}\n\nexport const SelfCleaningTaskDecorator = TaskDefinition.createDecorator({\n    decorator: SelfCleaningTaskDecoratorImpl,\n    dependencies: [CleanupTaskSubtreeUseCase]\n});\n"],"names":["SelfCleaningTaskDecoratorImpl","cleanupTaskSubtree","decoratee","normalizeSelfCleanup","params","hook","name","ex","console","getErrorProperties","SelfCleaningTaskDecorator","TaskDefinition","CleanupTaskSubtreeUseCase"],"mappings":";;;;AASO,MAAMA;IAGT,YACqBC,kBAAuD,EAChEC,SAAmC,CAC7C;aAFmBD,kBAAkB,GAAlBA;aACTC,SAAS,GAATA;QAER,IAAI,CAAC,MAAM,GAAGC,qBAAqBD,UAAU,WAAW;IAC5D;IAGA,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE;IAC5B;IACA,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK;IAC/B;IACA,IAAI,cAAc;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW;IACrC;IACA,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS;IACnC;IACA,IAAI,gBAAgB;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa;IACvC;IACA,IAAI,cAAc;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW;IACrC;IACA,IAAI,wBAAwB;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,qBAAqB;IAC/C;IACA,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS;IACjD;IACA,IAAI,kBAAkB;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,KAAK,IAAI,CAAC,SAAS;IAC9D;IACA,IAAI,kBAAkB;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,KAAK,IAAI,CAAC,SAAS;IAC9D;IAGA,IAAI,eAAe;QACf,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,GACnB,OAAO;QAEX,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY;IACtC;IAIA,IAAI,SAAS;QACT,OAAO,OAAOE;YACV,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAEA,QAAQ;YACnD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAChB,MAAM,IAAI,CAAC,UAAU,CAACA;QAE9B;IACJ;IAEA,IAAI,UAAU;QACV,OAAO,OAAOA;YACV,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAEA,QAAQ;YACpD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAChB,MAAM,IAAI,CAAC,UAAU,CAACA;QAE9B;IACJ;IAEA,IAAI,UAAU;QACV,OAAO,OAAOA;YACV,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAEA,QAAQ;YACpD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAChB,MAAM,IAAI,CAAC,UAAU,CAACA;QAE9B;IACJ;IAEA,MAAc,WAAWA,MAAkB,EAAiB;QACxD,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAACA,OAAO,IAAI,CAAC,EAAE;IACxD;IAEA,MAAc,SACVC,IAA+B,EAC/BD,MAAkB,EAClBE,IAAY,EACC;QACb,IAAI,CAACD,MACD;QAEJ,IAAI;YACA,MAAMA,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS,EAAED;QACpC,EAAE,OAAOG,IAAI;YACTC,QAAQ,KAAK,CAAC,CAAC,gBAAgB,EAAEF,KAAK,gBAAgB,EAAEF,OAAO,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1EI,QAAQ,GAAG,CAACC,mBAAmBF;QACnC;IACJ;AACJ;AAEO,MAAMG,4BAA4BC,eAAe,eAAe,CAAC;IACpE,WAAWX;IACX,cAAc;QAACY;KAA0B;AAC7C"}

package/api/domain/BackgroundTaskSettings.d.ts

@@ -0,0 +1,3 @@
+export interface IBackgroundTaskSettings {
+    retentionDays: number | undefined;
+}

package/api/domain/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const BACKGROUND_TASK_SETTINGS_MODEL_ID = "backgroundTaskSettings";
+export declare const BACKGROUND_TASK_MAX_RETENTION_DAYS = 3650;
+export declare const BACKGROUND_TASK_DEFAULT_RETENTION_DAYS = 90;

package/api/domain/constants.js

@@ -0,0 +1,6 @@
+const BACKGROUND_TASK_SETTINGS_MODEL_ID = "backgroundTaskSettings";
+const BACKGROUND_TASK_MAX_RETENTION_DAYS = 3650;
+const BACKGROUND_TASK_DEFAULT_RETENTION_DAYS = 90;
+export { BACKGROUND_TASK_DEFAULT_RETENTION_DAYS, BACKGROUND_TASK_MAX_RETENTION_DAYS, BACKGROUND_TASK_SETTINGS_MODEL_ID };
+
+//# sourceMappingURL=constants.js.map

package/api/domain/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/domain/constants.js","sources":["../../../src/api/domain/constants.ts"],"sourcesContent":["export const BACKGROUND_TASK_SETTINGS_MODEL_ID = \"backgroundTaskSettings\";\nexport const BACKGROUND_TASK_MAX_RETENTION_DAYS = 3650;\nexport const BACKGROUND_TASK_DEFAULT_RETENTION_DAYS = 90;\n"],"names":["BACKGROUND_TASK_SETTINGS_MODEL_ID","BACKGROUND_TASK_MAX_RETENTION_DAYS","BACKGROUND_TASK_DEFAULT_RETENTION_DAYS"],"mappings":"AAAO,MAAMA,oCAAoC;AAC1C,MAAMC,qCAAqC;AAC3C,MAAMC,yCAAyC"}

package/api/domain/errors.d.ts

@@ -0,0 +1,57 @@
+import { BaseError } from "@webiny/feature/api";
+import type { ZodError } from "zod";
+import type { ValidationIssue } from "@webiny/utils";
+export declare class TaskDefinitionNotFoundError extends BaseError<{
+    id: string;
+}> {
+    readonly code: "BackgroundTasks/TaskDefinition/NotFoundError";
+    constructor(id: string);
+}
+export declare class TaskNotFoundError extends BaseError {
+    readonly code: "BackgroundTasks/Task/NotFoundError";
+    constructor();
+}
+export declare class TaskAbortError extends BaseError<{
+    id: string;
+    status: string;
+}> {
+    readonly code: "BackgroundTasks/Task/Abort";
+    constructor(data: {
+        id: string;
+        status: string;
+    });
+}
+export declare class TaskLogNotFoundError extends BaseError {
+    readonly code: "BackgroundTasks/Log/NotFoundError";
+    constructor();
+}
+export declare class TaskServiceInfoError extends BaseError {
+    readonly code: "BackgroundTasks/Service/InfoUnavailable";
+    constructor();
+}
+interface BackgroundTaskValidationErrorData {
+    issues: ValidationIssue[];
+}
+export declare class BackgroundTaskValidationError extends BaseError<BackgroundTaskValidationErrorData> {
+    readonly code: "BackgroundTasks/ValidationError";
+    constructor(error: string | ZodError);
+}
+interface BackgroundTaskPersistenceErrorData {
+    originalMessage: string;
+    originalCode?: string;
+    originalData?: unknown;
+}
+export declare class BackgroundTaskPersistenceError extends BaseError<BackgroundTaskPersistenceErrorData> {
+    readonly code: "BackgroundTasks/PersistenceError";
+    constructor(error: Error);
+    static from(error: unknown): BackgroundTaskPersistenceError;
+}
+export declare class BackgroundTaskModelNotFoundError extends BaseError {
+    readonly code: "BackgroundTasks/ModelNotFound";
+    constructor(modelId: string);
+}
+export declare class BackgroundTaskNotAuthorizedError extends BaseError {
+    readonly code: "BackgroundTasks/NotAuthorized";
+    constructor();
+}
+export {};