@webiny/background-tasks 0.0.0-unstable.7be00a75a9 → 0.0.0-unstable.7c2def32a7

package/api/features/ListTaskLogs/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/ListTaskLogs/feature.js","sources":["../../../../src/api/features/ListTaskLogs/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { ListTaskLogsUseCase } from \"./ListTaskLogsUseCase.js\";\n\nexport const ListTaskLogsFeature = createFeature({\n    name: \"ListTaskLogs\",\n    register(container) {\n        container.register(ListTaskLogsUseCase);\n    }\n});\n"],"names":["ListTaskLogsFeature","createFeature","container","ListTaskLogsUseCase"],"mappings":";;AAGO,MAAMA,sBAAsBC,cAAc;IAC7C,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;IACvB;AACJ"}

package/api/features/ListTaskLogs/index.d.ts

@@ -0,0 +1,2 @@
+export { ListTaskLogsUseCase } from "./abstractions.js";
+export { ListTaskLogsFeature } from "./feature.js";

package/api/features/ListTaskLogs/index.js

@@ -0,0 +1,2 @@
+export { ListTaskLogsUseCase } from "./abstractions.js";
+export { ListTaskLogsFeature } from "./feature.js";

package/api/features/ListTasks/ListTasksUseCase.d.ts

@@ -0,0 +1,13 @@
+import { ListTasksUseCase as UseCaseAbstraction } from "./abstractions.js";
+import { TaskDefinition } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+import { TaskService } from "@webiny/api-core/features/task/TaskService/index.js";
+import { TasksRepository } from "../../../api/domain/task/abstractions.js";
+declare class ListTasksUseCaseImpl implements UseCaseAbstraction.Interface {
+    private readonly repository;
+    constructor(repository: TasksRepository.Interface);
+    execute<I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput, O extends TaskService.GenericOutput = TaskService.GenericOutput>(params?: UseCaseAbstraction.Params): UseCaseAbstraction.Return<I, O>;
+}
+export declare const ListTasksUseCase: typeof ListTasksUseCaseImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").IListTasksUseCase>;
+};
+export {};

package/api/features/ListTasks/ListTasksUseCase.js

@@ -0,0 +1,19 @@
+import { ListTasksUseCase } from "./abstractions.js";
+import { TasksRepository } from "../../domain/task/abstractions.js";
+class ListTasksUseCaseImpl {
+    constructor(repository){
+        this.repository = repository;
+    }
+    async execute(params) {
+        return this.repository.list(params);
+    }
+}
+const ListTasksUseCase_ListTasksUseCase = ListTasksUseCase.createImplementation({
+    implementation: ListTasksUseCaseImpl,
+    dependencies: [
+        TasksRepository
+    ]
+});
+export { ListTasksUseCase_ListTasksUseCase as ListTasksUseCase };
+
+//# sourceMappingURL=ListTasksUseCase.js.map

package/api/features/ListTasks/ListTasksUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/ListTasks/ListTasksUseCase.js","sources":["../../../../src/api/features/ListTasks/ListTasksUseCase.ts"],"sourcesContent":["import { ListTasksUseCase as UseCaseAbstraction } from \"./abstractions.js\";\nimport { TaskDefinition } from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\nimport { TaskService } from \"@webiny/api-core/features/task/TaskService/index.js\";\nimport { TasksRepository } from \"~/api/domain/task/abstractions.js\";\n\nclass ListTasksUseCaseImpl implements UseCaseAbstraction.Interface {\n    public constructor(private readonly repository: TasksRepository.Interface) {}\n\n    async execute<\n        I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput,\n        O extends TaskService.GenericOutput = TaskService.GenericOutput\n    >(params?: UseCaseAbstraction.Params): UseCaseAbstraction.Return<I, O> {\n        return this.repository.list<I, O>(params);\n    }\n}\n\nexport const ListTasksUseCase = UseCaseAbstraction.createImplementation({\n    implementation: ListTasksUseCaseImpl,\n    dependencies: [TasksRepository]\n});\n"],"names":["ListTasksUseCaseImpl","repository","params","ListTasksUseCase","UseCaseAbstraction","TasksRepository"],"mappings":";;AAKA,MAAMA;IACF,YAAoCC,UAAqC,CAAE;aAAvCA,UAAU,GAAVA;IAAwC;IAE5E,MAAM,QAGJC,MAAkC,EAAmC;QACnE,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAOA;IACtC;AACJ;AAEO,MAAMC,oCAAmBC,iBAAAA,oBAAuC,CAAC;IACpE,gBAAgBJ;IAChB,cAAc;QAACK;KAAgB;AACnC"}

package/api/features/ListTasks/abstractions.d.ts

@@ -0,0 +1,19 @@
+import type { Result } from "@webiny/feature/api";
+import { TaskService } from "@webiny/api-core/features/task/TaskService/index.js";
+import { TaskDefinition } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+import type { IListTasksResponse } from "../../../api/types.js";
+import type { IListTaskParams } from "../../../api/types.js";
+import type { BackgroundTaskPersistenceError } from "../../../api/domain/errors.js";
+type UseCaseError = BackgroundTaskPersistenceError;
+export interface IListTasksUseCase {
+    execute<I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput, O extends TaskService.GenericOutput = TaskService.GenericOutput>(params?: ListTasksParams): Promise<Result<IListTasksResponse<I, O>, UseCaseError>>;
+}
+export type ListTasksParams = IListTaskParams;
+export declare const ListTasksUseCase: import("@webiny/di").Abstraction<IListTasksUseCase>;
+export declare namespace ListTasksUseCase {
+    type Interface = IListTasksUseCase;
+    type Params = ListTasksParams;
+    type Error = UseCaseError;
+    type Return<I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput, O extends TaskService.GenericOutput = TaskService.GenericOutput> = Promise<Result<IListTasksResponse<I, O>, UseCaseError>>;
+}
+export {};

package/api/features/ListTasks/abstractions.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const ListTasksUseCase = createAbstraction("Tasks/ListTasksUseCase");
+export { ListTasksUseCase };
+
+//# sourceMappingURL=abstractions.js.map

package/api/features/ListTasks/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/ListTasks/abstractions.js","sources":["../../../../src/api/features/ListTasks/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { Result } from \"@webiny/feature/api\";\nimport { TaskService } from \"@webiny/api-core/features/task/TaskService/index.js\";\nimport { TaskDefinition } from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\nimport type { IListTasksResponse } from \"~/api/types.js\";\nimport type { IListTaskParams } from \"~/api/types.js\";\nimport type { BackgroundTaskPersistenceError } from \"~/api/domain/errors.js\";\n\ntype UseCaseError = BackgroundTaskPersistenceError;\n\nexport interface IListTasksUseCase {\n    execute<\n        I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput,\n        O extends TaskService.GenericOutput = TaskService.GenericOutput\n    >(\n        params?: ListTasksParams\n    ): Promise<Result<IListTasksResponse<I, O>, UseCaseError>>;\n}\n\nexport type ListTasksParams = IListTaskParams;\n\nexport const ListTasksUseCase = createAbstraction<IListTasksUseCase>(\"Tasks/ListTasksUseCase\");\n\nexport namespace ListTasksUseCase {\n    export type Interface = IListTasksUseCase;\n    export type Params = ListTasksParams;\n    export type Error = UseCaseError;\n\n    export type Return<\n        I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput,\n        O extends TaskService.GenericOutput = TaskService.GenericOutput\n    > = Promise<Result<IListTasksResponse<I, O>, UseCaseError>>;\n}\n"],"names":["ListTasksUseCase","createAbstraction"],"mappings":";AAqBO,MAAMA,mBAAmBC,kBAAqC"}

package/api/features/ListTasks/feature.d.ts

@@ -0,0 +1,4 @@
+export declare const ListTasksFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/api/features/ListTasks/feature.js

@@ -0,0 +1,11 @@
+import { createFeature } from "@webiny/feature/api";
+import { ListTasksUseCase } from "./ListTasksUseCase.js";
+const ListTasksFeature = createFeature({
+    name: "ListTasks",
+    register (container) {
+        container.register(ListTasksUseCase);
+    }
+});
+export { ListTasksFeature };
+
+//# sourceMappingURL=feature.js.map

package/api/features/ListTasks/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/ListTasks/feature.js","sources":["../../../../src/api/features/ListTasks/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { ListTasksUseCase } from \"./ListTasksUseCase.js\";\n\nexport const ListTasksFeature = createFeature({\n    name: \"ListTasks\",\n    register(container) {\n        container.register(ListTasksUseCase);\n    }\n});\n"],"names":["ListTasksFeature","createFeature","container","ListTasksUseCase"],"mappings":";;AAGO,MAAMA,mBAAmBC,cAAc;IAC1C,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;IACvB;AACJ"}

package/api/features/ListTasks/index.d.ts

@@ -0,0 +1,2 @@
+export { ListTasksUseCase } from "./abstractions.js";
+export { ListTasksFeature } from "./feature.js";

package/api/features/ListTasks/index.js

@@ -0,0 +1,2 @@
+export { ListTasksUseCase } from "./abstractions.js";
+export { ListTasksFeature } from "./feature.js";

package/api/features/TaskController/TaskController.d.ts

@@ -0,0 +1,49 @@
+import { TaskDefinition } from "@webiny/api-core/features/task/TaskDefinition/abstractions.js";
+import { TaskController as Abstraction } from "@webiny/api-core/features/task/TaskController/abstractions.js";
+import { TaskService } from "@webiny/api-core/features/task/TaskService/index.js";
+import { TaskExecutionContext } from "../TaskExecutionContext/abstractions.js";
+import { type ITaskTriggerParams, TaskDataStatus } from "../../../api/types.js";
+import "./augmentation.js";
+import { BaseError, Result } from "@webiny/feature/api/index.js";
+declare class TaskControllerImpl implements Abstraction.Interface {
+    private taskService;
+    private executionContext;
+    constructor(taskService: TaskService.Interface, executionContext: TaskExecutionContext.Interface);
+    private get store();
+    private get runner();
+    private get timer();
+    get response(): import("~/api/types.js").ITaskResponse<import("@webiny/api-core/features/task/TaskDefinition/abstractions.js").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions.js").ITaskOutput>;
+    state: {
+        getTask: () => import("~/api/types.js").ITask<import("@webiny/api-core/features/task/TaskDefinition/abstractions.js").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions.js").ITaskOutput>;
+        getStatus: () => TaskDataStatus;
+        getInput: () => import("@webiny/api-core/features/task/TaskDefinition/abstractions.js").ITaskInput;
+        getOutput: () => import("@webiny/api-core/features/task/TaskDefinition/abstractions.js").ITaskOutput;
+        updateInput: (input: any) => Promise<void>;
+        updateOutput: (output: any) => Promise<void>;
+    };
+    logger: {
+        info: (params: {
+            message: string;
+            data?: Record<string, any>;
+        }) => Promise<void>;
+        error: (params: {
+            message: string;
+            error?: Error | any;
+            data?: Record<string, any>;
+        }) => Promise<void>;
+    };
+    task: {
+        trigger: <CI extends TaskDefinition.TaskInput = TaskDefinition.TaskInput>(params: ITaskTriggerParams<CI>) => Promise<Result<TaskService.Task<CI>, BaseError>>;
+        listChildren: <CT extends TaskDefinition.TaskInput = TaskDefinition.TaskInput, CO extends TaskDefinition.TaskOutput = TaskDefinition.TaskOutput>(definitionId?: string) => Promise<TaskService.Task<CT, CO>[]>;
+    };
+    runtime: {
+        isCloseToTimeout: (seconds?: number) => boolean;
+        isAborted: () => boolean;
+        getRemainingSeconds: () => number;
+        getRemainingMilliseconds: () => number;
+    };
+}
+export declare const TaskController: typeof TaskControllerImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/task/TaskController/abstractions.js").ITaskController<import("@webiny/api-core/features/task/TaskDefinition/abstractions.js").ITaskInput, import("@webiny/api-core/features/task/TaskDefinition/abstractions.js").ITaskOutput>>;
+};
+export {};

package/api/features/TaskController/TaskController.js

@@ -0,0 +1,71 @@
+import { TaskController } from "@webiny/api-core/features/task/TaskController/abstractions.js";
+import { TaskService } from "@webiny/api-core/features/task/TaskService/index.js";
+import { TaskExecutionContext } from "../TaskExecutionContext/abstractions.js";
+import { TaskDataStatus } from "../../types.js";
+import "./augmentation.js";
+class TaskControllerImpl {
+    constructor(taskService, executionContext){
+        this.taskService = taskService;
+        this.executionContext = executionContext;
+        this.state = {
+            getTask: ()=>this.store.getTask(),
+            getStatus: ()=>this.store.getStatus(),
+            getInput: ()=>this.store.getInput(),
+            getOutput: ()=>this.store.getOutput(),
+            updateInput: async (input)=>await this.store.updateInput(input),
+            updateOutput: async (output)=>await this.store.updateOutput(output)
+        };
+        this.logger = {
+            info: async (params)=>{
+                await this.store.addInfoLog(params);
+            },
+            error: async (params)=>{
+                const error = params.error;
+                const errorObj = error instanceof Error ? {
+                    message: error.message,
+                    stack: error.stack
+                } : error;
+                await this.store.addErrorLog({
+                    message: params.message,
+                    error: errorObj,
+                    data: params.data
+                });
+            }
+        };
+        this.task = {
+            trigger: async (params)=>this.taskService.trigger({
+                    ...params,
+                    parent: this.store.getTask()
+                }),
+            listChildren: async (definitionId)=>this.store.listChildTasks(definitionId)
+        };
+        this.runtime = {
+            isCloseToTimeout: (seconds)=>this.runner.isCloseToTimeout(seconds),
+            isAborted: ()=>this.store.getStatus() === TaskDataStatus.ABORTED,
+            getRemainingSeconds: ()=>this.timer.getRemainingSeconds(),
+            getRemainingMilliseconds: ()=>this.timer.getRemainingMilliseconds()
+        };
+    }
+    get store() {
+        return this.executionContext.store;
+    }
+    get runner() {
+        return this.executionContext.runner;
+    }
+    get timer() {
+        return this.executionContext.timer;
+    }
+    get response() {
+        return this.executionContext.response;
+    }
+}
+const TaskController_TaskController = TaskController.createImplementation({
+    implementation: TaskControllerImpl,
+    dependencies: [
+        TaskService,
+        TaskExecutionContext
+    ]
+});
+export { TaskController_TaskController as TaskController };
+
+//# sourceMappingURL=TaskController.js.map

package/api/features/TaskController/TaskController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/TaskController/TaskController.js","sources":["../../../../src/api/features/TaskController/TaskController.ts"],"sourcesContent":["import { TaskDefinition } from \"@webiny/api-core/features/task/TaskDefinition/abstractions.js\";\nimport { TaskController as Abstraction } from \"@webiny/api-core/features/task/TaskController/abstractions.js\";\nimport { TaskService } from \"@webiny/api-core/features/task/TaskService/index.js\";\nimport { TaskExecutionContext } from \"../TaskExecutionContext/abstractions.js\";\nimport { type ITaskTriggerParams, TaskDataStatus } from \"~/api/types.js\";\nimport \"./augmentation.js\";\nimport { BaseError, Result } from \"@webiny/feature/api/index.js\";\n\nclass TaskControllerImpl implements Abstraction.Interface {\n    constructor(\n        private taskService: TaskService.Interface,\n        private executionContext: TaskExecutionContext.Interface\n    ) {}\n\n    private get store() {\n        return this.executionContext.store;\n    }\n\n    private get runner() {\n        return this.executionContext.runner;\n    }\n\n    private get timer() {\n        return this.executionContext.timer;\n    }\n\n    public get response() {\n        return this.executionContext.response;\n    }\n\n    state = {\n        getTask: () => this.store.getTask(),\n        getStatus: () => this.store.getStatus(),\n        getInput: () => this.store.getInput(),\n        getOutput: () => this.store.getOutput(),\n        updateInput: async (input: any) => await this.store.updateInput(input),\n        updateOutput: async (output: any) => await this.store.updateOutput(output)\n    };\n\n    logger = {\n        info: async (params: { message: string; data?: Record<string, any> }) => {\n            await this.store.addInfoLog(params);\n        },\n        error: async (params: {\n            message: string;\n            error?: Error | any;\n            data?: Record<string, any>;\n        }) => {\n            const error = params.error;\n            const errorObj =\n                error instanceof Error ? { message: error.message, stack: error.stack } : error;\n            await this.store.addErrorLog({\n                message: params.message,\n                error: errorObj,\n                data: params.data\n            });\n        }\n    };\n\n    task = {\n        trigger: async <CI extends TaskDefinition.TaskInput = TaskDefinition.TaskInput>(\n            params: ITaskTriggerParams<CI>\n        ): Promise<Result<TaskService.Task<CI>, BaseError>> => {\n            return this.taskService.trigger({ ...params, parent: this.store.getTask() });\n        },\n        listChildren: async <\n            CT extends TaskDefinition.TaskInput = TaskDefinition.TaskInput,\n            CO extends TaskDefinition.TaskOutput = TaskDefinition.TaskOutput\n        >(\n            definitionId?: string\n        ): Promise<TaskService.Task<CT, CO>[]> => {\n            return this.store.listChildTasks(definitionId);\n        }\n    };\n\n    runtime = {\n        isCloseToTimeout: (seconds?: number) => this.runner.isCloseToTimeout(seconds),\n        isAborted: () => this.store.getStatus() === TaskDataStatus.ABORTED,\n        getRemainingSeconds: () => this.timer.getRemainingSeconds(),\n        getRemainingMilliseconds: () => this.timer.getRemainingMilliseconds()\n    };\n}\n\nexport const TaskController = Abstraction.createImplementation({\n    implementation: TaskControllerImpl,\n    dependencies: [TaskService, TaskExecutionContext]\n});\n"],"names":["TaskControllerImpl","taskService","executionContext","input","output","params","error","errorObj","Error","definitionId","seconds","TaskDataStatus","TaskController","Abstraction","TaskService","TaskExecutionContext"],"mappings":";;;;;AAQA,MAAMA;IACF,YACYC,WAAkC,EAClCC,gBAAgD,CAC1D;aAFUD,WAAW,GAAXA;aACAC,gBAAgB,GAAhBA;aAmBZ,KAAK,GAAG;YACJ,SAAS,IAAM,IAAI,CAAC,KAAK,CAAC,OAAO;YACjC,WAAW,IAAM,IAAI,CAAC,KAAK,CAAC,SAAS;YACrC,UAAU,IAAM,IAAI,CAAC,KAAK,CAAC,QAAQ;YACnC,WAAW,IAAM,IAAI,CAAC,KAAK,CAAC,SAAS;YACrC,aAAa,OAAOC,QAAe,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAACA;YAChE,cAAc,OAAOC,SAAgB,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAACA;QACvE;aAEA,MAAM,GAAG;YACL,MAAM,OAAOC;gBACT,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAACA;YAChC;YACA,OAAO,OAAOA;gBAKV,MAAMC,QAAQD,OAAO,KAAK;gBAC1B,MAAME,WACFD,iBAAiBE,QAAQ;oBAAE,SAASF,MAAM,OAAO;oBAAE,OAAOA,MAAM,KAAK;gBAAC,IAAIA;gBAC9E,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;oBACzB,SAASD,OAAO,OAAO;oBACvB,OAAOE;oBACP,MAAMF,OAAO,IAAI;gBACrB;YACJ;QACJ;aAEA,IAAI,GAAG;YACH,SAAS,OACLA,SAEO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;oBAAE,GAAGA,MAAM;oBAAE,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO;gBAAG;YAE9E,cAAc,OAIVI,eAEO,IAAI,CAAC,KAAK,CAAC,cAAc,CAACA;QAEzC;aAEA,OAAO,GAAG;YACN,kBAAkB,CAACC,UAAqB,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAACA;YACrE,WAAW,IAAM,IAAI,CAAC,KAAK,CAAC,SAAS,OAAOC,eAAe,OAAO;YAClE,qBAAqB,IAAM,IAAI,CAAC,KAAK,CAAC,mBAAmB;YACzD,0BAA0B,IAAM,IAAI,CAAC,KAAK,CAAC,wBAAwB;QACvE;IApEG;IAEH,IAAY,QAAQ;QAChB,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK;IACtC;IAEA,IAAY,SAAS;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM;IACvC;IAEA,IAAY,QAAQ;QAChB,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK;IACtC;IAEA,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ;IACzC;AAqDJ;AAEO,MAAMC,gCAAiBC,eAAAA,oBAAgC,CAAC;IAC3D,gBAAgBb;IAChB,cAAc;QAACc;QAAaC;KAAqB;AACrD"}

package/api/features/TaskController/augmentation.d.ts

@@ -0,0 +1,60 @@
+import type { IResponseError } from "@webiny/api-core/features/task/TaskDefinition";
+import type { TaskDataStatus } from "../../../api/types.js";
+import { type ITaskTriggerParams, TaskService } from "@webiny/api-core/features/task/TaskService/index.js";
+import { TaskDefinition } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+import type { ITaskResponse } from "../../../api/response/abstractions/index.js";
+import { Result } from "@webiny/feature/api";
+import { BaseError } from "@webiny/feature/api/index.js";
+/**
+ * Augment the TaskController interface from api-core with implementation details.
+ * This allows developers to import from @webiny/api-core but get the full interface.
+ */
+declare module "@webiny/api-core/features/task/TaskController/abstractions.js" {
+    interface ITaskController<I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput, O extends TaskDefinition.TaskOutput = TaskDefinition.TaskOutput> {
+        /**
+         * Response object
+         */
+        response: ITaskResponse<I, O>;
+        /**
+         * State management - access and update task state
+         */
+        state: {
+            getTask(): TaskService.Task<I, O>;
+            getStatus(): TaskDataStatus;
+            getInput(): I;
+            getOutput(): O | undefined;
+            updateInput(input: Partial<I>): Promise<void>;
+            updateOutput(output: Partial<O>): Promise<void>;
+        };
+        /**
+         * Logging - add log entries to task
+         */
+        logger: {
+            info(params: {
+                message: string;
+                data?: Record<string, any>;
+            }): Promise<void>;
+            error(params: {
+                message: string;
+                error?: Error | IResponseError;
+                data?: Record<string, any>;
+            }): Promise<void>;
+        };
+        /**
+         * Task management - trigger and query child tasks
+         */
+        task: {
+            trigger<CI extends TaskDefinition.TaskInput = TaskDefinition.TaskInput>(params: ITaskTriggerParams<CI>): Promise<Result<TaskService.Task<CI>, BaseError>>;
+            listChildren<CT extends TaskDefinition.TaskInput = I, CO extends TaskDefinition.TaskOutput = O>(definitionId?: string): Promise<TaskService.Task<CT, CO>[]>;
+        };
+        /**
+         * Runtime checks
+         */
+        runtime: {
+            isCloseToTimeout(seconds?: number): boolean;
+            isAborted(): boolean;
+            getRemainingSeconds(): number;
+            getRemainingMilliseconds(): number;
+        };
+    }
+}

package/api/features/TaskController/index.d.ts

@@ -0,0 +1,2 @@
+import "./augmentation.js";
+export { TaskController } from "./TaskController.js";

package/api/features/TaskController/index.js

@@ -0,0 +1,2 @@
+import "./augmentation.js";
+export { TaskController } from "./TaskController.js";

package/api/features/TaskExecutionContext/TaskExecutionContext.d.ts

@@ -0,0 +1,24 @@
+import { TaskExecutionContext as Abstraction } from "./abstractions.js";
+import type { ITaskManagerStore } from "../../../api/runner/abstractions/TaskManagerStore.js";
+import type { ITaskRunner } from "../../../api/runner/abstractions/TaskRunner.js";
+import type { Timer } from "../../../api/abstractions/Timer.js";
+import type { ITaskResponse } from "../../../api/response/abstractions/index.js";
+declare class TaskExecutionContextImpl implements Abstraction.Interface {
+    private _store?;
+    private _runner?;
+    private _timer?;
+    private _response?;
+    get store(): ITaskManagerStore;
+    get runner(): ITaskRunner;
+    get timer(): Timer.Interface;
+    get response(): ITaskResponse;
+    setStore(store: ITaskManagerStore): void;
+    setRunner(runner: ITaskRunner): void;
+    setTimer(timer: Timer.Interface): void;
+    setResponse(response: ITaskResponse): void;
+    clear(): void;
+}
+export declare const TaskExecutionContext: typeof TaskExecutionContextImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").ITaskExecutionContext>;
+};
+export {};

package/api/features/TaskExecutionContext/TaskExecutionContext.js

@@ -0,0 +1,43 @@
+import { TaskExecutionContext } from "./abstractions.js";
+class TaskExecutionContextImpl {
+    get store() {
+        if (!this._store) throw new Error("TaskExecutionContext: store not set. Task execution not started.");
+        return this._store;
+    }
+    get runner() {
+        if (!this._runner) throw new Error("TaskExecutionContext: runner not set. Task execution not started.");
+        return this._runner;
+    }
+    get timer() {
+        if (!this._timer) throw new Error("TaskExecutionContext: timer not set. Task execution not started.");
+        return this._timer;
+    }
+    get response() {
+        if (!this._response) throw new Error("TaskExecutionContext: response not set. Task execution not started.");
+        return this._response;
+    }
+    setStore(store) {
+        this._store = store;
+    }
+    setRunner(runner) {
+        this._runner = runner;
+    }
+    setTimer(timer) {
+        this._timer = timer;
+    }
+    setResponse(response) {
+        this._response = response;
+    }
+    clear() {
+        this._store = void 0;
+        this._runner = void 0;
+        this._timer = void 0;
+    }
+}
+const TaskExecutionContext_TaskExecutionContext = TaskExecutionContext.createImplementation({
+    implementation: TaskExecutionContextImpl,
+    dependencies: []
+});
+export { TaskExecutionContext_TaskExecutionContext as TaskExecutionContext };
+
+//# sourceMappingURL=TaskExecutionContext.js.map

package/api/features/TaskExecutionContext/TaskExecutionContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/TaskExecutionContext/TaskExecutionContext.js","sources":["../../../../src/api/features/TaskExecutionContext/TaskExecutionContext.ts"],"sourcesContent":["import { TaskExecutionContext as Abstraction } from \"./abstractions.js\";\nimport type { ITaskManagerStore } from \"~/api/runner/abstractions/TaskManagerStore.js\";\nimport type { ITaskRunner } from \"~/api/runner/abstractions/TaskRunner.js\";\nimport type { Timer } from \"~/api/abstractions/Timer.js\";\nimport type { ITaskResponse } from \"~/api/response/abstractions/index.js\";\n\nclass TaskExecutionContextImpl implements Abstraction.Interface {\n    private _store?: ITaskManagerStore;\n    private _runner?: ITaskRunner;\n    private _timer?: Timer.Interface;\n    private _response?: ITaskResponse;\n\n    get store(): ITaskManagerStore {\n        if (!this._store) {\n            throw new Error(\"TaskExecutionContext: store not set. Task execution not started.\");\n        }\n        return this._store;\n    }\n\n    get runner(): ITaskRunner {\n        if (!this._runner) {\n            throw new Error(\"TaskExecutionContext: runner not set. Task execution not started.\");\n        }\n        return this._runner;\n    }\n\n    get timer(): Timer.Interface {\n        if (!this._timer) {\n            throw new Error(\"TaskExecutionContext: timer not set. Task execution not started.\");\n        }\n        return this._timer;\n    }\n\n    get response(): ITaskResponse {\n        if (!this._response) {\n            throw new Error(\"TaskExecutionContext: response not set. Task execution not started.\");\n        }\n        return this._response;\n    }\n\n    setStore(store: ITaskManagerStore): void {\n        this._store = store;\n    }\n\n    setRunner(runner: ITaskRunner): void {\n        this._runner = runner;\n    }\n\n    setTimer(timer: Timer.Interface): void {\n        this._timer = timer;\n    }\n\n    setResponse(response: ITaskResponse): void {\n        this._response = response;\n    }\n\n    clear(): void {\n        this._store = undefined;\n        this._runner = undefined;\n        this._timer = undefined;\n    }\n}\n\nexport const TaskExecutionContext = Abstraction.createImplementation({\n    implementation: TaskExecutionContextImpl,\n    dependencies: []\n});\n"],"names":["TaskExecutionContextImpl","Error","store","runner","timer","response","undefined","TaskExecutionContext","Abstraction"],"mappings":";AAMA,MAAMA;IAMF,IAAI,QAA2B;QAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,EACZ,MAAM,IAAIC,MAAM;QAEpB,OAAO,IAAI,CAAC,MAAM;IACtB;IAEA,IAAI,SAAsB;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO,EACb,MAAM,IAAIA,MAAM;QAEpB,OAAO,IAAI,CAAC,OAAO;IACvB;IAEA,IAAI,QAAyB;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM,EACZ,MAAM,IAAIA,MAAM;QAEpB,OAAO,IAAI,CAAC,MAAM;IACtB;IAEA,IAAI,WAA0B;QAC1B,IAAI,CAAC,IAAI,CAAC,SAAS,EACf,MAAM,IAAIA,MAAM;QAEpB,OAAO,IAAI,CAAC,SAAS;IACzB;IAEA,SAASC,KAAwB,EAAQ;QACrC,IAAI,CAAC,MAAM,GAAGA;IAClB;IAEA,UAAUC,MAAmB,EAAQ;QACjC,IAAI,CAAC,OAAO,GAAGA;IACnB;IAEA,SAASC,KAAsB,EAAQ;QACnC,IAAI,CAAC,MAAM,GAAGA;IAClB;IAEA,YAAYC,QAAuB,EAAQ;QACvC,IAAI,CAAC,SAAS,GAAGA;IACrB;IAEA,QAAc;QACV,IAAI,CAAC,MAAM,GAAGC;QACd,IAAI,CAAC,OAAO,GAAGA;QACf,IAAI,CAAC,MAAM,GAAGA;IAClB;AACJ;AAEO,MAAMC,4CAAuBC,qBAAAA,oBAAgC,CAAC;IACjE,gBAAgBR;IAChB,cAAc,EAAE;AACpB"}

package/api/features/TaskExecutionContext/abstractions.d.ts

@@ -0,0 +1,26 @@
+import type { Timer } from "../../../api/abstractions/Timer.js";
+import type { ITaskManagerStore } from "../../../api/runner/abstractions/TaskManagerStore.js";
+import type { ITaskRunner } from "../../../api/runner/abstractions/TaskRunner.js";
+import type { ITaskResponse } from "../../../api/response/abstractions/index.js";
+/**
+ * TaskExecutionContext holds runtime state for the currently executing task.
+ * Properties are set by TaskRunner before task execution.
+ *
+ * This is registered as a singleton in the DI container with empty values,
+ * then populated at runtime by TaskControl before executing each task.
+ */
+export interface ITaskExecutionContext {
+    readonly store: ITaskManagerStore;
+    readonly runner: ITaskRunner;
+    readonly timer: Timer.Interface;
+    readonly response: ITaskResponse;
+    setStore(store: ITaskManagerStore): void;
+    setRunner(runner: ITaskRunner): void;
+    setTimer(timer: Timer.Interface): void;
+    setResponse(response: ITaskResponse): void;
+    clear(): void;
+}
+export declare const TaskExecutionContext: import("@webiny/di").Abstraction<ITaskExecutionContext>;
+export declare namespace TaskExecutionContext {
+    type Interface = ITaskExecutionContext;
+}

package/api/features/TaskExecutionContext/abstractions.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const TaskExecutionContext = createAbstraction("TaskExecutionContext");
+export { TaskExecutionContext };
+
+//# sourceMappingURL=abstractions.js.map

package/api/features/TaskExecutionContext/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/TaskExecutionContext/abstractions.js","sources":["../../../../src/api/features/TaskExecutionContext/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { Timer } from \"~/api/abstractions/Timer.js\";\nimport type { ITaskManagerStore } from \"~/api/runner/abstractions/TaskManagerStore.js\";\nimport type { ITaskRunner } from \"~/api/runner/abstractions/TaskRunner.js\";\nimport type { ITaskResponse } from \"~/api/response/abstractions/index.js\";\n\n/**\n * TaskExecutionContext holds runtime state for the currently executing task.\n * Properties are set by TaskRunner before task execution.\n *\n * This is registered as a singleton in the DI container with empty values,\n * then populated at runtime by TaskControl before executing each task.\n */\nexport interface ITaskExecutionContext {\n    // Getters - may throw if not set\n    readonly store: ITaskManagerStore;\n    readonly runner: ITaskRunner;\n    readonly timer: Timer.Interface;\n    readonly response: ITaskResponse;\n\n    // Setters - called by TaskControl\n    setStore(store: ITaskManagerStore): void;\n    setRunner(runner: ITaskRunner): void;\n    setTimer(timer: Timer.Interface): void;\n    setResponse(response: ITaskResponse): void;\n\n    // Clear after execution\n    clear(): void;\n}\n\nexport const TaskExecutionContext =\n    createAbstraction<ITaskExecutionContext>(\"TaskExecutionContext\");\n\nexport namespace TaskExecutionContext {\n    export type Interface = ITaskExecutionContext;\n}\n"],"names":["TaskExecutionContext","createAbstraction"],"mappings":";AA8BO,MAAMA,uBACTC,kBAAyC"}

package/api/features/TaskExecutionContext/feature.d.ts

@@ -0,0 +1,4 @@
+export declare const TaskExecutionContextFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/api/features/TaskExecutionContext/feature.js

@@ -0,0 +1,11 @@
+import { createFeature } from "@webiny/feature/api";
+import { TaskExecutionContext } from "./TaskExecutionContext.js";
+const TaskExecutionContextFeature = createFeature({
+    name: "TaskExecutionContext",
+    register (container) {
+        container.register(TaskExecutionContext).inSingletonScope();
+    }
+});
+export { TaskExecutionContextFeature };
+
+//# sourceMappingURL=feature.js.map

package/api/features/TaskExecutionContext/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/TaskExecutionContext/feature.js","sources":["../../../../src/api/features/TaskExecutionContext/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { TaskExecutionContext } from \"./TaskExecutionContext.js\";\n\nexport const TaskExecutionContextFeature = createFeature({\n    name: \"TaskExecutionContext\",\n    register(container) {\n        container.register(TaskExecutionContext).inSingletonScope();\n    }\n});\n"],"names":["TaskExecutionContextFeature","createFeature","container","TaskExecutionContext"],"mappings":";;AAGO,MAAMA,8BAA8BC,cAAc;IACrD,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC,sBAAsB,gBAAgB;IAC7D;AACJ"}

package/api/features/TaskExecutionContext/index.d.ts

@@ -0,0 +1 @@
+export * from "./abstractions.js";

package/api/features/TaskExecutionContext/index.js

@@ -0,0 +1 @@
+export * from "./abstractions.js";

package/api/features/TaskHandlerResolver/TaskHandlerResolver.d.ts

@@ -0,0 +1,12 @@
+import type { Container, Constructor } from "@webiny/di";
+import type { TaskDefinition } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+import { TaskHandlerResolver as Abstraction } from "./abstractions.js";
+declare class ContainerTaskHandlerResolver implements Abstraction.Interface {
+    private readonly container;
+    constructor(container: Container);
+    resolve<I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput, O extends TaskDefinition.TaskOutput = TaskDefinition.TaskOutput>(handler: Constructor<TaskDefinition.Handler<I, O>>): TaskDefinition.Handler<I, O>;
+}
+export declare const TaskHandlerResolver: typeof ContainerTaskHandlerResolver & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").ITaskHandlerResolver>;
+};
+export {};

package/api/features/TaskHandlerResolver/TaskHandlerResolver.js

@@ -0,0 +1,19 @@
+import { RequestContainer } from "@webiny/event-handler-core/features/events/RequestContainer.js";
+import { TaskHandlerResolver } from "./abstractions.js";
+class ContainerTaskHandlerResolver {
+    constructor(container){
+        this.container = container;
+    }
+    resolve(handler) {
+        return this.container.resolveImplementation(handler);
+    }
+}
+const TaskHandlerResolver_TaskHandlerResolver = TaskHandlerResolver.createImplementation({
+    implementation: ContainerTaskHandlerResolver,
+    dependencies: [
+        RequestContainer
+    ]
+});
+export { TaskHandlerResolver_TaskHandlerResolver as TaskHandlerResolver };
+
+//# sourceMappingURL=TaskHandlerResolver.js.map

package/api/features/TaskHandlerResolver/TaskHandlerResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/TaskHandlerResolver/TaskHandlerResolver.js","sources":["../../../../src/api/features/TaskHandlerResolver/TaskHandlerResolver.ts"],"sourcesContent":["import type { Container, Constructor } from \"@webiny/di\";\nimport { RequestContainer } from \"@webiny/event-handler-core/features/events/RequestContainer.js\";\nimport type { TaskDefinition } from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\nimport { TaskHandlerResolver as Abstraction } from \"./abstractions.js\";\n\nclass ContainerTaskHandlerResolver implements Abstraction.Interface {\n    public constructor(private readonly container: Container) {}\n\n    public resolve<\n        I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput,\n        O extends TaskDefinition.TaskOutput = TaskDefinition.TaskOutput\n    >(handler: Constructor<TaskDefinition.Handler<I, O>>): TaskDefinition.Handler<I, O> {\n        // `resolveImplementation` builds the class from its own dependency metadata and runs it\n        // through the normal resolution path, so decorators registered against the handler still\n        // apply. It deliberately ignores registrations, which is what we want here: the definition\n        // names the class directly and nothing registers handlers against an abstraction.\n        return this.container.resolveImplementation(handler);\n    }\n}\n\nexport const TaskHandlerResolver = Abstraction.createImplementation({\n    implementation: ContainerTaskHandlerResolver,\n    dependencies: [RequestContainer]\n});\n"],"names":["ContainerTaskHandlerResolver","container","handler","TaskHandlerResolver","Abstraction","RequestContainer"],"mappings":";;AAKA,MAAMA;IACF,YAAoCC,SAAoB,CAAE;aAAtBA,SAAS,GAATA;IAAuB;IAEpD,QAGLC,OAAkD,EAAgC;QAKhF,OAAO,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAACA;IAChD;AACJ;AAEO,MAAMC,0CAAsBC,oBAAAA,oBAAgC,CAAC;IAChE,gBAAgBJ;IAChB,cAAc;QAACK;KAAiB;AACpC"}

package/api/features/TaskHandlerResolver/abstractions.d.ts

@@ -0,0 +1,17 @@
+import type { Constructor } from "@webiny/di";
+import type { TaskDefinition } from "@webiny/api-core/features/task/TaskDefinition/index.js";
+export interface ITaskHandlerResolver {
+    resolve<I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput, O extends TaskDefinition.TaskOutput = TaskDefinition.TaskOutput>(handler: Constructor<TaskDefinition.Handler<I, O>>): TaskDefinition.Handler<I, O>;
+}
+/**
+ * Builds the behaviour half of a task on demand.
+ *
+ * Something has to turn `definition.handler` (a class) into an instance, and that needs the
+ * container. Rather than injecting the container into a use case — which is the service-locator
+ * pattern we keep out of DI classes — it lives behind this one narrow abstraction. Everything else
+ * depends on `resolve(handler)` and stays testable with a stub.
+ */
+export declare const TaskHandlerResolver: import("@webiny/di").Abstraction<ITaskHandlerResolver>;
+export declare namespace TaskHandlerResolver {
+    type Interface = ITaskHandlerResolver;
+}

package/api/features/TaskHandlerResolver/abstractions.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const TaskHandlerResolver = createAbstraction("Tasks/TaskHandlerResolver");
+export { TaskHandlerResolver };
+
+//# sourceMappingURL=abstractions.js.map

package/api/features/TaskHandlerResolver/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/TaskHandlerResolver/abstractions.js","sources":["../../../../src/api/features/TaskHandlerResolver/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { Constructor } from \"@webiny/di\";\nimport type { TaskDefinition } from \"@webiny/api-core/features/task/TaskDefinition/index.js\";\n\nexport interface ITaskHandlerResolver {\n    resolve<\n        I extends TaskDefinition.TaskInput = TaskDefinition.TaskInput,\n        O extends TaskDefinition.TaskOutput = TaskDefinition.TaskOutput\n    >(\n        handler: Constructor<TaskDefinition.Handler<I, O>>\n    ): TaskDefinition.Handler<I, O>;\n}\n\n/**\n * Builds the behaviour half of a task on demand.\n *\n * Something has to turn `definition.handler` (a class) into an instance, and that needs the\n * container. Rather than injecting the container into a use case — which is the service-locator\n * pattern we keep out of DI classes — it lives behind this one narrow abstraction. Everything else\n * depends on `resolve(handler)` and stays testable with a stub.\n */\nexport const TaskHandlerResolver = createAbstraction<ITaskHandlerResolver>(\n    \"Tasks/TaskHandlerResolver\"\n);\n\nexport namespace TaskHandlerResolver {\n    export type Interface = ITaskHandlerResolver;\n}\n"],"names":["TaskHandlerResolver","createAbstraction"],"mappings":";AAqBO,MAAMA,sBAAsBC,kBAC/B"}

package/api/features/TaskHandlerResolver/feature.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Must be registered on the per-request container, which is what `registerApiRequestStack` does via
+ * `BackgroundTasksFeature`. The resolver depends on `RequestContainer`; registered on the root it
+ * would capture the root container and never see per-request registrations.
+ */
+export declare const TaskHandlerResolverFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/api/features/TaskHandlerResolver/feature.js

@@ -0,0 +1,11 @@
+import { createFeature } from "@webiny/feature/api";
+import { TaskHandlerResolver } from "./TaskHandlerResolver.js";
+const TaskHandlerResolverFeature = createFeature({
+    name: "TaskHandlerResolver",
+    register (container) {
+        container.register(TaskHandlerResolver);
+    }
+});
+export { TaskHandlerResolverFeature };
+
+//# sourceMappingURL=feature.js.map

package/api/features/TaskHandlerResolver/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/features/TaskHandlerResolver/feature.js","sources":["../../../../src/api/features/TaskHandlerResolver/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { TaskHandlerResolver } from \"./TaskHandlerResolver.js\";\n\n/**\n * Must be registered on the per-request container, which is what `registerApiRequestStack` does via\n * `BackgroundTasksFeature`. The resolver depends on `RequestContainer`; registered on the root it\n * would capture the root container and never see per-request registrations.\n */\nexport const TaskHandlerResolverFeature = createFeature({\n    name: \"TaskHandlerResolver\",\n    register(container) {\n        container.register(TaskHandlerResolver);\n    }\n});\n"],"names":["TaskHandlerResolverFeature","createFeature","container","TaskHandlerResolver"],"mappings":";;AAQO,MAAMA,6BAA6BC,cAAc;IACpD,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;IACvB;AACJ"}

package/api/features/TaskHandlerResolver/index.d.ts

@@ -0,0 +1,2 @@
+export { TaskHandlerResolver } from "./abstractions.js";
+export { TaskHandlerResolverFeature } from "./feature.js";

package/api/features/TaskHandlerResolver/index.js

@@ -0,0 +1,2 @@
+export { TaskHandlerResolver } from "./abstractions.js";
+export { TaskHandlerResolverFeature } from "./feature.js";