@push.rocks/taskbuffer 3.5.0 → 4.1.0

package/dist_ts_web/ts/taskbuffer.classes.taskrunner.js

@@ -1,28 +1,29 @@
 import * as plugins from './taskbuffer.plugins.js';
 import { Task } from './taskbuffer.classes.task.js';
+import { logger } from './taskbuffer.logging.js';
 export class TaskRunner {
     constructor() {
-        this.maxParrallelJobs = 1;
+        this.maxParallelJobs = 1;
         this.status = 'stopped';
         this.runningTasks = new plugins.lik.ObjectMap();
-        this.qeuedTasks = [];
+        this.queuedTasks = [];
         this.runningTasks.eventSubject.subscribe(async (eventArg) => {
             this.checkExecution();
         });
     }
     /**
-     * adds a task to the qeue
+     * adds a task to the queue
      */
     addTask(taskArg) {
-        this.qeuedTasks.push(taskArg);
+        this.queuedTasks.push(taskArg);
         this.checkExecution();
     }
     /**
      * set amount of parallel tasks
-     * be careful, you might loose dependability of tasks
+     * be careful, you might lose dependability of tasks
      */
-    setMaxParallelJobs(maxParrallelJobsArg) {
-        this.maxParrallelJobs = maxParrallelJobsArg;
+    setMaxParallelJobs(maxParallelJobsArg) {
+        this.maxParallelJobs = maxParallelJobsArg;
     }
     /**
      * starts the task queue
@@ -31,15 +32,20 @@ export class TaskRunner {
         this.status = 'running';
     }
     /**
-     * checks wether execution is on point
+     * checks whether execution is on point
      */
     async checkExecution() {
-        if (this.runningTasks.getArray().length < this.maxParrallelJobs &&
+        if (this.runningTasks.getArray().length < this.maxParallelJobs &&
             this.status === 'running' &&
-            this.qeuedTasks.length > 0) {
-            const nextJob = this.qeuedTasks.shift();
+            this.queuedTasks.length > 0) {
+            const nextJob = this.queuedTasks.shift();
             this.runningTasks.add(nextJob);
-            await nextJob.trigger();
+            try {
+                await nextJob.trigger();
+            }
+            catch (err) {
+                logger.log('error', `TaskRunner: task "${nextJob.name || 'unnamed'}" failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
             this.runningTasks.remove(nextJob);
             this.checkExecution();
         }
@@ -51,4 +57,4 @@ export class TaskRunner {
         this.status = 'stopped';
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFza2J1ZmZlci5jbGFzc2VzLnRhc2tydW5uZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy90YXNrYnVmZmVyLmNsYXNzZXMudGFza3J1bm5lci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLHlCQUF5QixDQUFDO0FBRW5ELE9BQU8sRUFBRSxJQUFJLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUVwRCxNQUFNLE9BQU8sVUFBVTtJQU9yQjtRQU5PLHFCQUFnQixHQUFXLENBQUMsQ0FBQztRQUM3QixXQUFNLEdBQTBCLFNBQVMsQ0FBQztRQUMxQyxpQkFBWSxHQUNqQixJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMsU0FBUyxFQUFRLENBQUM7UUFDN0IsZUFBVSxHQUFXLEVBQUUsQ0FBQztRQUc3QixJQUFJLENBQUMsWUFBWSxDQUFDLFlBQVksQ0FBQyxTQUFTLENBQUMsS0FBSyxFQUFFLFFBQVEsRUFBRSxFQUFFO1lBQzFELElBQUksQ0FBQyxjQUFjLEVBQUUsQ0FBQztRQUN4QixDQUFDLENBQUMsQ0FBQztJQUNMLENBQUM7SUFFRDs7T0FFRztJQUNJLE9BQU8sQ0FBQyxPQUFhO1FBQzFCLElBQUksQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQzlCLElBQUksQ0FBQyxjQUFjLEVBQUUsQ0FBQztJQUN4QixDQUFDO0lBRUQ7OztPQUdHO0lBQ0ksa0JBQWtCLENBQUMsbUJBQTJCO1FBQ25ELElBQUksQ0FBQyxnQkFBZ0IsR0FBRyxtQkFBbUIsQ0FBQztJQUM5QyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsS0FBSztRQUNoQixJQUFJLENBQUMsTUFBTSxHQUFHLFNBQVMsQ0FBQztJQUMxQixDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsY0FBYztRQUN6QixJQUNFLElBQUksQ0FBQyxZQUFZLENBQUMsUUFBUSxFQUFFLENBQUMsTUFBTSxHQUFHLElBQUksQ0FBQyxnQkFBZ0I7WUFDM0QsSUFBSSxDQUFDLE1BQU0sS0FBSyxTQUFTO1lBQ3pCLElBQUksQ0FBQyxVQUFVLENBQUMsTUFBTSxHQUFHLENBQUMsRUFDMUIsQ0FBQztZQUNELE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxVQUFVLENBQUMsS0FBSyxFQUFFLENBQUM7WUFDeEMsSUFBSSxDQUFDLFlBQVksQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUM7WUFDL0IsTUFBTSxPQUFPLENBQUMsT0FBTyxFQUFFLENBQUM7WUFDeEIsSUFBSSxDQUFDLFlBQVksQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUM7WUFDbEMsSUFBSSxDQUFDLGNBQWMsRUFBRSxDQUFDO1FBQ3hCLENBQUM7SUFDSCxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsSUFBSTtRQUNmLElBQUksQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDO0lBQzFCLENBQUM7Q0FDRiJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFza2J1ZmZlci5jbGFzc2VzLnRhc2tydW5uZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy90YXNrYnVmZmVyLmNsYXNzZXMudGFza3J1bm5lci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLHlCQUF5QixDQUFDO0FBRW5ELE9BQU8sRUFBRSxJQUFJLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUNwRCxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFFakQsTUFBTSxPQUFPLFVBQVU7SUFPckI7UUFOTyxvQkFBZSxHQUFXLENBQUMsQ0FBQztRQUM1QixXQUFNLEdBQTBCLFNBQVMsQ0FBQztRQUMxQyxpQkFBWSxHQUNqQixJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMsU0FBUyxFQUFRLENBQUM7UUFDN0IsZ0JBQVcsR0FBVyxFQUFFLENBQUM7UUFHOUIsSUFBSSxDQUFDLFlBQVksQ0FBQyxZQUFZLENBQUMsU0FBUyxDQUFDLEtBQUssRUFBRSxRQUFRLEVBQUUsRUFBRTtZQUMxRCxJQUFJLENBQUMsY0FBYyxFQUFFLENBQUM7UUFDeEIsQ0FBQyxDQUFDLENBQUM7SUFDTCxDQUFDO0lBRUQ7O09BRUc7SUFDSSxPQUFPLENBQUMsT0FBYTtRQUMxQixJQUFJLENBQUMsV0FBVyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUMvQixJQUFJLENBQUMsY0FBYyxFQUFFLENBQUM7SUFDeEIsQ0FBQztJQUVEOzs7T0FHRztJQUNJLGtCQUFrQixDQUFDLGtCQUEwQjtRQUNsRCxJQUFJLENBQUMsZUFBZSxHQUFHLGtCQUFrQixDQUFDO0lBQzVDLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxLQUFLO1FBQ2hCLElBQUksQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDO0lBQzFCLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxjQUFjO1FBQ3pCLElBQ0UsSUFBSSxDQUFDLFlBQVksQ0FBQyxRQUFRLEVBQUUsQ0FBQyxNQUFNLEdBQUcsSUFBSSxDQUFDLGVBQWU7WUFDMUQsSUFBSSxDQUFDLE1BQU0sS0FBSyxTQUFTO1lBQ3pCLElBQUksQ0FBQyxXQUFXLENBQUMsTUFBTSxHQUFHLENBQUMsRUFDM0IsQ0FBQztZQUNELE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxXQUFXLENBQUMsS0FBSyxFQUFFLENBQUM7WUFDekMsSUFBSSxDQUFDLFlBQVksQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUM7WUFDL0IsSUFBSSxDQUFDO2dCQUNILE1BQU0sT0FBTyxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQzFCLENBQUM7WUFBQyxPQUFPLEdBQUcsRUFBRSxDQUFDO2dCQUNiLE1BQU0sQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLHFCQUFxQixPQUFPLENBQUMsSUFBSSxJQUFJLFNBQVMsYUFBYSxHQUFHLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxDQUFDO1lBQ3JJLENBQUM7WUFDRCxJQUFJLENBQUMsWUFBWSxDQUFDLE1BQU0sQ0FBQyxPQUFPLENBQUMsQ0FBQztZQUNsQyxJQUFJLENBQUMsY0FBYyxFQUFFLENBQUM7UUFDeEIsQ0FBQztJQUNILENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxJQUFJO1FBQ2YsSUFBSSxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUM7SUFDMUIsQ0FBQztDQUNGIn0=

package/dist_ts_web/ts/taskbuffer.interfaces.d.ts

@@ -14,6 +14,9 @@ export interface ITaskMetadata {
     buffered?: boolean;
     bufferMax?: number;
     timeout?: number;
+    lastError?: string;
+    errorCount?: number;
+    labels?: Record<string, string>;
 }
 export interface ITaskExecutionReport {
     taskName: string;
@@ -34,3 +37,11 @@ export interface IScheduledTaskInfo {
     steps?: ITaskStep[];
     metadata?: ITaskMetadata;
 }
+export type TTaskEventType = 'started' | 'step' | 'completed' | 'failed';
+export interface ITaskEvent {
+    type: TTaskEventType;
+    task: ITaskMetadata;
+    timestamp: number;
+    stepName?: string;
+    error?: string;
+}

package/dist_ts_web/ts_web/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@push.rocks/taskbuffer',
-    version: '3.5.0',
+    version: '4.1.0',
     description: 'A flexible task management library supporting TypeScript, allowing for task buffering, scheduling, and execution with dependency management.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHNfd2ViLzAwX2NvbW1pdGluZm9fZGF0YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRztJQUN4QixJQUFJLEVBQUUsd0JBQXdCO0lBQzlCLE9BQU8sRUFBRSxPQUFPO0lBQ2hCLFdBQVcsRUFBRSw4SUFBOEk7Q0FDNUosQ0FBQSJ9

package/npmextra.json

@@ -1,10 +1,5 @@
 {
-  "npmci": {
-    "npmGlobalTools": [],
-    "npmAccessLevel": "public",
-    "npmRegistryUrl": "registry.npmjs.org"
-  },
-  "gitzone": {
+  "@git.zone/cli": {
     "projectType": "npm",
     "module": {
       "githost": "code.foss.global",
@@ -25,9 +20,20 @@
         "debounced tasks",
         "distributed coordination"
       ]
+    },
+    "release": {
+      "registries": [
+        "https://verdaccio.lossless.digital",
+        "https://registry.npmjs.org"
+      ],
+      "accessLevel": "public"
     }
   },
-  "tsdoc": {
+  "@git.zone/tsdoc": {
     "legal": "\n## License and Legal Information\n\nThis repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. \n\n**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.\n\n### Trademarks\n\nThis project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.\n\n### Company Information\n\nTask Venture Capital GmbH  \nRegistered at District court Bremen HRB 35230 HB, Germany\n\nFor any legal inquiries or if you require further information, please contact us via email at hello@task.vc.\n\nBy using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.\n"
+  },
+  "@ship.zone/szci": {
+    "npmGlobalTools": [],
+    "npmRegistryUrl": "registry.npmjs.org"
   }
-}
+}

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@push.rocks/taskbuffer",
-  "version": "3.5.0",
+  "version": "4.1.0",
   "private": false,
   "description": "A flexible task management library supporting TypeScript, allowing for task buffering, scheduling, and execution with dependency management.",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",
   "type": "module",
+  "scripts": {
+    "test": "(tstest test/ --verbose --logfile --timeout 120)",
+    "build": "(tsbuild tsfolders)",
+    "buildDocs": "tsdoc"
+  },
   "repository": {
     "type": "git",
     "url": "https://code.foss.global/push.rocks/taskbuffer.git"
@@ -60,9 +65,8 @@
   "browserslist": [
     "last 1 chrome versions"
   ],
-  "scripts": {
-    "test": "(tstest test/ --verbose --logfile --timeout 120)",
-    "build": "(tsbuild tsfolders)",
-    "buildDocs": "tsdoc"
+  "packageManager": "pnpm@10.14.0+sha512.ad27a79641b49c3e481a16a805baa71817a04bbe06a38d17e60e2eaee83f6a146c6a688125f5792e48dd5ba30e7da52a5cda4c3992b9ccf333f9ce223af84748",
+  "pnpm": {
+    "overrides": {}
   }
-}
+}

package/readme.hints.md

@@ -1 +1,42 @@
- 
+# Taskbuffer Hints
+
+## Error Handling (v3.6.0+)
+- `Task` now has `catchErrors` constructor option (default: `false`)
+- Default behavior: `trigger()` rejects when taskFunction throws (breaking change from pre-3.6)
+- Set `catchErrors: true` to swallow errors (old behavior) - returns `undefined` on error
+- Error state tracked via `lastError?: Error`, `errorCount: number`, `clearError()`
+- `getMetadata()` status uses all four values: `'idle'` | `'running'` | `'completed'` | `'failed'`
+- All peripheral classes (Taskchain, Taskparallel, TaskRunner, BufferRunner, TaskDebounced, TaskManager) have proper error propagation/handling
+- `console.log` calls replaced with `logger.log()` throughout
+
+## Breaking API Rename (TaskRunner)
+- `maxParrallelJobs` → `maxParallelJobs`
+- `qeuedTasks` → `queuedTasks`
+- JSDoc typos fixed: "qeue" → "queue", "wether" → "whether", "loose" → "lose"
+- The `setMaxParallelJobs()` parameter also renamed from `maxParrallelJobsArg` to `maxParallelJobsArg`
+
+## Error Context Improvements
+- **TaskChain**: Errors now wrap the original with context: chain name, failing task name, and task index. Original error preserved via `.cause`
+- **BufferRunner**: When `catchErrors: false`, buffered task errors now reject the trigger promise (via `CycleCounter.informOfCycleError`) instead of silently resolving with `undefined`
+- **TaskChain stubs completed**: `removeTask(task)` returns `boolean`, `shiftTask()` returns `Task | undefined`
+
+## Task Labels (v4.1.0+)
+- `Task` constructor accepts optional `labels?: Record<string, string>`
+- Helper methods: `setLabel(key, value)`, `getLabel(key)`, `removeLabel(key)`, `hasLabel(key, value?)`
+- `getMetadata()` includes `labels` (shallow copy)
+- `TaskManager.getTasksByLabel(key, value)` returns matching `Task[]`
+- `TaskManager.getTasksMetadataByLabel(key, value)` returns matching `ITaskMetadata[]`
+
+## Push-Based Events (v4.1.0+)
+- `Task.eventSubject`: rxjs `Subject<ITaskEvent>` emitting `'started'`, `'step'`, `'completed'`, `'failed'` events
+- `TaskManager.taskSubject`: aggregated `Subject<ITaskEvent>` from all added tasks
+- `TaskManager.removeTask(task)` unsubscribes and removes from map
+- `TaskManager.stop()` cleans up all event subscriptions
+- Exported types: `ITaskEvent`, `TTaskEventType`
+
+## Project Structure
+- Source in `ts/`, web components in `ts_web/`
+- Tests in `test/` - naming: `*.node.ts`, `*.browser.ts`, `*.both.ts`
+- Logger: `ts/taskbuffer.logging.ts` exports `logger` (ConsoleLog from smartlog)
+- Build: `pnpm build` (tsbuild tsfolders)
+- Test: `pnpm test` or `tstest test/test.XX.name.ts --verbose`

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@push.rocks/taskbuffer',
-  version: '3.5.0',
+  version: '4.1.0',
   description: 'A flexible task management library supporting TypeScript, allowing for task buffering, scheduling, and execution with dependency management.'
 }

package/ts/index.ts

@@ -12,7 +12,7 @@ export { TaskStep } from './taskbuffer.classes.taskstep.js';
 export type { ITaskStep } from './taskbuffer.classes.taskstep.js';
 
 // Metadata interfaces
-export type { ITaskMetadata, ITaskExecutionReport, IScheduledTaskInfo } from './taskbuffer.interfaces.js';
+export type { ITaskMetadata, ITaskExecutionReport, IScheduledTaskInfo, ITaskEvent, TTaskEventType } from './taskbuffer.interfaces.js';
 
 import * as distributedCoordination from './taskbuffer.classes.distributedcoordinator.js';
 export { distributedCoordination };

package/ts/taskbuffer.classes.bufferrunner.ts

@@ -1,4 +1,5 @@
 import { Task } from './taskbuffer.classes.task.js';
+import { logger } from './taskbuffer.logging.js';
 
 export class BufferRunner {
   public task: Task;
@@ -24,9 +25,19 @@ export class BufferRunner {
   private async _run(x: any) {
     this.task.running = true;
     while (this.bufferCounter > 0) {
-      const result = await Task.runTask(this.task, { x: x });
-      this.bufferCounter--;
-      this.task.cycleCounter.informOfCycle(result);
+      try {
+        const result = await Task.runTask(this.task, { x: x });
+        this.bufferCounter--;
+        this.task.cycleCounter.informOfCycle(result);
+      } catch (err) {
+        logger.log('error', `BufferRunner: task "${this.task.name || 'unnamed'}" failed: ${err instanceof Error ? err.message : String(err)}`);
+        this.bufferCounter--;
+        if (this.task.catchErrors) {
+          this.task.cycleCounter.informOfCycle(undefined);
+        } else {
+          this.task.cycleCounter.informOfCycleError(err instanceof Error ? err : new Error(String(err)));
+        }
+      }
     }
     this.task.running = false;
   }

package/ts/taskbuffer.classes.cyclecounter.ts

@@ -33,4 +33,16 @@ export class CycleCounter {
     });
     this.cycleObjectArray = newCycleObjectArray;
   }
+  public informOfCycleError(err: Error) {
+    const newCycleObjectArray: ICycleObject[] = [];
+    this.cycleObjectArray.forEach((cycleObjectArg) => {
+      cycleObjectArg.cycleCounter--;
+      if (cycleObjectArg.cycleCounter <= 0) {
+        cycleObjectArg.deferred.reject(err);
+      } else {
+        newCycleObjectArray.push(cycleObjectArg);
+      }
+    });
+    this.cycleObjectArray = newCycleObjectArray;
+  }
 }

package/ts/taskbuffer.classes.task.ts

@@ -2,7 +2,7 @@ import * as plugins from './taskbuffer.plugins.js';
 import { BufferRunner } from './taskbuffer.classes.bufferrunner.js';
 import { CycleCounter } from './taskbuffer.classes.cyclecounter.js';
 import { TaskStep, type ITaskStep } from './taskbuffer.classes.taskstep.js';
-import type { ITaskMetadata } from './taskbuffer.interfaces.js';
+import type { ITaskMetadata, ITaskEvent, TTaskEventType } from './taskbuffer.interfaces.js';
 
 import { logger } from './taskbuffer.logging.js';
 
@@ -87,24 +87,40 @@ export class Task<T = undefined, TSteps extends ReadonlyArray<{ name: string; de
     taskToRun.running = true;
     taskToRun.runCount++;
     taskToRun.lastRun = new Date();
-    
-    // Reset steps at the beginning of task execution
+
+    // Reset steps and error state at the beginning of task execution
     taskToRun.resetSteps();
+    taskToRun.lastError = undefined;
+    taskToRun.emitEvent('started');
+
+    done.promise
+      .then(async () => {
+        taskToRun.running = false;
 
-    done.promise.then(async () => {
-      taskToRun.running = false;
-      
-      // Complete all steps when task finishes
-      taskToRun.completeAllSteps();
+        // Complete all steps when task finishes
+        taskToRun.completeAllSteps();
+        taskToRun.emitEvent(taskToRun.lastError ? 'failed' : 'completed');
 
-      // When the task has finished running, resolve the finished promise
-      taskToRun.resolveFinished();
+        // When the task has finished running, resolve the finished promise
+        taskToRun.resolveFinished();
 
-      // Create a new finished promise for the next run
-      taskToRun.finished = new Promise((resolve) => {
-        taskToRun.resolveFinished = resolve;
+        // Create a new finished promise for the next run
+        taskToRun.finished = new Promise((resolve) => {
+          taskToRun.resolveFinished = resolve;
+        });
+      })
+      .catch((err) => {
+        taskToRun.running = false;
+        taskToRun.emitEvent('failed', { error: err instanceof Error ? err.message : String(err) });
+
+        // Resolve finished so blocking dependants don't hang
+        taskToRun.resolveFinished();
+
+        // Create a new finished promise for the next run
+        taskToRun.finished = new Promise((resolve) => {
+          taskToRun.resolveFinished = resolve;
+        });
       });
-    });
 
     const options = {
       ...{ x: undefined, touchedTasksArray: [] },
@@ -133,7 +149,13 @@ export class Task<T = undefined, TSteps extends ReadonlyArray<{ name: string; de
         try {
           return await taskToRun.taskFunction(x, taskToRun.setupValue);
         } catch (e) {
-          console.log(e);
+          taskToRun.lastError = e instanceof Error ? e : new Error(String(e));
+          taskToRun.errorCount++;
+          logger.log('error', `Task "${taskToRun.name || 'unnamed'}" failed: ${taskToRun.lastError.message}`);
+          if (taskToRun.catchErrors) {
+            return undefined;
+          }
+          throw e;
         }
       })
       .then((x) => {
@@ -155,10 +177,18 @@ export class Task<T = undefined, TSteps extends ReadonlyArray<{ name: string; de
         done.resolve(x);
       })
       .catch((err) => {
-        console.log(err);
+        done.reject(err);
       });
     localDeferred.resolve();
-    return await done.promise;
+
+    try {
+      return await done.promise;
+    } catch (err) {
+      if (taskToRun.catchErrors) {
+        return undefined;
+      }
+      throw err;
+    }
   };
 
   public name: string;
@@ -187,10 +217,53 @@ export class Task<T = undefined, TSteps extends ReadonlyArray<{ name: string; de
   public lastRun?: Date;
   public runCount: number = 0;
 
+  // Error handling
+  public catchErrors: boolean = false;
+  public lastError?: Error;
+  public errorCount: number = 0;
+  public labels: Record<string, string> = {};
+  public readonly eventSubject = new plugins.smartrx.rxjs.Subject<ITaskEvent>();
+
   public get idle() {
     return !this.running;
   }
 
+  public clearError(): void {
+    this.lastError = undefined;
+  }
+
+  public setLabel(key: string, value: string): void {
+    this.labels[key] = value;
+  }
+
+  public getLabel(key: string): string | undefined {
+    return this.labels[key];
+  }
+
+  public removeLabel(key: string): boolean {
+    if (key in this.labels) {
+      delete this.labels[key];
+      return true;
+    }
+    return false;
+  }
+
+  public hasLabel(key: string, value?: string): boolean {
+    if (value !== undefined) {
+      return this.labels[key] === value;
+    }
+    return key in this.labels;
+  }
+
+  private emitEvent(type: TTaskEventType, extra?: Partial<ITaskEvent>): void {
+    this.eventSubject.next({
+      type,
+      task: this.getMetadata(),
+      timestamp: Date.now(),
+      ...extra,
+    });
+  }
+
   public taskSetup: ITaskSetupFunction<T>;
   public setupValue: T;
 
@@ -210,6 +283,8 @@ export class Task<T = undefined, TSteps extends ReadonlyArray<{ name: string; de
     name?: string;
     taskSetup?: ITaskSetupFunction<T>;
     steps?: TSteps;
+    catchErrors?: boolean;
+    labels?: Record<string, string>;
   }) {
     this.taskFunction = optionsArg.taskFunction;
     this.preTask = optionsArg.preTask;
@@ -219,6 +294,8 @@ export class Task<T = undefined, TSteps extends ReadonlyArray<{ name: string; de
     this.execDelay = optionsArg.execDelay;
     this.name = optionsArg.name;
     this.taskSetup = optionsArg.taskSetup;
+    this.catchErrors = optionsArg.catchErrors ?? false;
+    this.labels = optionsArg.labels ? { ...optionsArg.labels } : {};
 
     // Initialize steps if provided
     if (optionsArg.steps) {
@@ -271,8 +348,8 @@ export class Task<T = undefined, TSteps extends ReadonlyArray<{ name: string; de
     if (step) {
       step.start();
       this.currentStepName = stepName as string;
-      
-      // Emit event for frontend updates (could be enhanced with event emitter)
+      this.emitEvent('step', { stepName: stepName as string });
+
       if (this.name) {
         logger.log('info', `Task ${this.name}: Starting step "${stepName}" - ${step.description}`);
       }
@@ -306,10 +383,21 @@ export class Task<T = undefined, TSteps extends ReadonlyArray<{ name: string; de
 
   // Get task metadata
   public getMetadata(): ITaskMetadata {
+    let status: 'idle' | 'running' | 'completed' | 'failed';
+    if (this.running) {
+      status = 'running';
+    } else if (this.lastError) {
+      status = 'failed';
+    } else if (this.runCount > 0) {
+      status = 'completed';
+    } else {
+      status = 'idle';
+    }
+
     return {
       name: this.name || 'unnamed',
       version: this.version,
-      status: this.running ? 'running' : 'idle',
+      status,
       steps: this.getStepsMetadata(),
       currentStep: this.currentStepName,
       currentProgress: this.getProgress(),
@@ -318,6 +406,9 @@ export class Task<T = undefined, TSteps extends ReadonlyArray<{ name: string; de
       bufferMax: this.bufferMax,
       timeout: this.timeout,
       cronSchedule: this.cronJob?.cronExpression,
+      lastError: this.lastError?.message,
+      errorCount: this.errorCount,
+      labels: { ...this.labels },
     };
   }
 

package/ts/taskbuffer.classes.taskchain.ts

@@ -27,18 +27,20 @@ export class Taskchain extends Task {
           let taskCounter = 0; // counter for iterating async over the taskArray
           const iterateTasks = (x: any) => {
             if (typeof this.taskArray[taskCounter] !== 'undefined') {
-              console.log(
-                this.name + ' running: Task' + this.taskArray[taskCounter].name,
-              );
+              logger.log('info', `${this.name} running: Task ${this.taskArray[taskCounter].name}`);
               this.taskArray[taskCounter].trigger(x).then((x) => {
                 logger.log('info', this.taskArray[taskCounter].name);
                 taskCounter++;
                 iterateTasks(x);
+              }).catch((err) => {
+                const chainError = new Error(
+                  `Taskchain "${this.name}": task "${this.taskArray[taskCounter].name || 'unnamed'}" (index ${taskCounter}) failed: ${err instanceof Error ? err.message : String(err)}`
+                );
+                (chainError as any).cause = err;
+                done.reject(chainError);
               });
             } else {
-              console.log(
-                'Taskchain "' + this.name + '" completed successfully',
-              );
+              logger.log('info', `Taskchain "${this.name}" completed successfully`);
               done.resolve(x);
             }
           };
@@ -53,10 +55,15 @@ export class Taskchain extends Task {
   addTask(taskArg: Task) {
     this.taskArray.push(taskArg);
   }
-  removeTask(taskArg: Task) {
-    // TODO:
+  removeTask(taskArg: Task): boolean {
+    const index = this.taskArray.indexOf(taskArg);
+    if (index === -1) {
+      return false;
+    }
+    this.taskArray.splice(index, 1);
+    return true;
   }
-  shiftTask() {
-    // TODO:
+  shiftTask(): Task | undefined {
+    return this.taskArray.shift();
   }
 }

package/ts/taskbuffer.classes.taskdebounced.ts

@@ -1,6 +1,7 @@
 import * as plugins from './taskbuffer.plugins.js';
 
 import { Task, type ITaskFunction } from './taskbuffer.classes.task.js';
+import { logger } from './taskbuffer.logging.js';
 
 export class TaskDebounced<T = unknown> extends Task {
   private _debouncedTaskFunction: ITaskFunction;
@@ -22,8 +23,17 @@ export class TaskDebounced<T = unknown> extends Task {
       .pipe(
         plugins.smartrx.rxjs.ops.debounceTime(optionsArg.debounceTimeInMillis),
       )
-      .subscribe((x) => {
-        this.taskFunction(x);
+      .subscribe({
+        next: async (x) => {
+          try {
+            await this.taskFunction(x);
+          } catch (err) {
+            logger.log('error', `TaskDebounced "${this.name || 'unnamed'}" failed: ${err instanceof Error ? err.message : String(err)}`);
+          }
+        },
+        error: (err) => {
+          logger.log('error', `TaskDebounced "${this.name || 'unnamed'}" observable error: ${err instanceof Error ? err.message : String(err)}`);
+        },
       });
   }
 }