@calmo/task-runner 1.0.0 → 1.1.0

package/coverage/sorter.js

@@ -0,0 +1,210 @@
+/* eslint-disable */
+var addSorting = (function() {
+    'use strict';
+    var cols,
+        currentSort = {
+            index: 0,
+            desc: false
+        };
+
+    // returns the summary table element
+    function getTable() {
+        return document.querySelector('.coverage-summary');
+    }
+    // returns the thead element of the summary table
+    function getTableHeader() {
+        return getTable().querySelector('thead tr');
+    }
+    // returns the tbody element of the summary table
+    function getTableBody() {
+        return getTable().querySelector('tbody');
+    }
+    // returns the th element for nth column
+    function getNthColumn(n) {
+        return getTableHeader().querySelectorAll('th')[n];
+    }
+
+    function onFilterInput() {
+        const searchValue = document.getElementById('fileSearch').value;
+        const rows = document.getElementsByTagName('tbody')[0].children;
+
+        // Try to create a RegExp from the searchValue. If it fails (invalid regex),
+        // it will be treated as a plain text search
+        let searchRegex;
+        try {
+            searchRegex = new RegExp(searchValue, 'i'); // 'i' for case-insensitive
+        } catch (error) {
+            searchRegex = null;
+        }
+
+        for (let i = 0; i < rows.length; i++) {
+            const row = rows[i];
+            let isMatch = false;
+
+            if (searchRegex) {
+                // If a valid regex was created, use it for matching
+                isMatch = searchRegex.test(row.textContent);
+            } else {
+                // Otherwise, fall back to the original plain text search
+                isMatch = row.textContent
+                    .toLowerCase()
+                    .includes(searchValue.toLowerCase());
+            }
+
+            row.style.display = isMatch ? '' : 'none';
+        }
+    }
+
+    // loads the search box
+    function addSearchBox() {
+        var template = document.getElementById('filterTemplate');
+        var templateClone = template.content.cloneNode(true);
+        templateClone.getElementById('fileSearch').oninput = onFilterInput;
+        template.parentElement.appendChild(templateClone);
+    }
+
+    // loads all columns
+    function loadColumns() {
+        var colNodes = getTableHeader().querySelectorAll('th'),
+            colNode,
+            cols = [],
+            col,
+            i;
+
+        for (i = 0; i < colNodes.length; i += 1) {
+            colNode = colNodes[i];
+            col = {
+                key: colNode.getAttribute('data-col'),
+                sortable: !colNode.getAttribute('data-nosort'),
+                type: colNode.getAttribute('data-type') || 'string'
+            };
+            cols.push(col);
+            if (col.sortable) {
+                col.defaultDescSort = col.type === 'number';
+                colNode.innerHTML =
+                    colNode.innerHTML + '<span class="sorter"></span>';
+            }
+        }
+        return cols;
+    }
+    // attaches a data attribute to every tr element with an object
+    // of data values keyed by column name
+    function loadRowData(tableRow) {
+        var tableCols = tableRow.querySelectorAll('td'),
+            colNode,
+            col,
+            data = {},
+            i,
+            val;
+        for (i = 0; i < tableCols.length; i += 1) {
+            colNode = tableCols[i];
+            col = cols[i];
+            val = colNode.getAttribute('data-value');
+            if (col.type === 'number') {
+                val = Number(val);
+            }
+            data[col.key] = val;
+        }
+        return data;
+    }
+    // loads all row data
+    function loadData() {
+        var rows = getTableBody().querySelectorAll('tr'),
+            i;
+
+        for (i = 0; i < rows.length; i += 1) {
+            rows[i].data = loadRowData(rows[i]);
+        }
+    }
+    // sorts the table using the data for the ith column
+    function sortByIndex(index, desc) {
+        var key = cols[index].key,
+            sorter = function(a, b) {
+                a = a.data[key];
+                b = b.data[key];
+                return a < b ? -1 : a > b ? 1 : 0;
+            },
+            finalSorter = sorter,
+            tableBody = document.querySelector('.coverage-summary tbody'),
+            rowNodes = tableBody.querySelectorAll('tr'),
+            rows = [],
+            i;
+
+        if (desc) {
+            finalSorter = function(a, b) {
+                return -1 * sorter(a, b);
+            };
+        }
+
+        for (i = 0; i < rowNodes.length; i += 1) {
+            rows.push(rowNodes[i]);
+            tableBody.removeChild(rowNodes[i]);
+        }
+
+        rows.sort(finalSorter);
+
+        for (i = 0; i < rows.length; i += 1) {
+            tableBody.appendChild(rows[i]);
+        }
+    }
+    // removes sort indicators for current column being sorted
+    function removeSortIndicators() {
+        var col = getNthColumn(currentSort.index),
+            cls = col.className;
+
+        cls = cls.replace(/ sorted$/, '').replace(/ sorted-desc$/, '');
+        col.className = cls;
+    }
+    // adds sort indicators for current column being sorted
+    function addSortIndicators() {
+        getNthColumn(currentSort.index).className += currentSort.desc
+            ? ' sorted-desc'
+            : ' sorted';
+    }
+    // adds event listeners for all sorter widgets
+    function enableUI() {
+        var i,
+            el,
+            ithSorter = function ithSorter(i) {
+                var col = cols[i];
+
+                return function() {
+                    var desc = col.defaultDescSort;
+
+                    if (currentSort.index === i) {
+                        desc = !currentSort.desc;
+                    }
+                    sortByIndex(i, desc);
+                    removeSortIndicators();
+                    currentSort.index = i;
+                    currentSort.desc = desc;
+                    addSortIndicators();
+                };
+            };
+        for (i = 0; i < cols.length; i += 1) {
+            if (cols[i].sortable) {
+                // add the click event handler on the th so users
+                // dont have to click on those tiny arrows
+                el = getNthColumn(i).querySelector('.sorter').parentElement;
+                if (el.addEventListener) {
+                    el.addEventListener('click', ithSorter(i));
+                } else {
+                    el.attachEvent('onclick', ithSorter(i));
+                }
+            }
+        }
+    }
+    // adds sorting functionality to the UI
+    return function() {
+        if (!getTable()) {
+            return;
+        }
+        cols = loadColumns();
+        loadData();
+        addSearchBox();
+        addSortIndicators();
+        enableUI();
+    };
+})();
+
+window.addEventListener('load', addSorting);

package/dist/TaskRunner.d.ts

@@ -1,5 +1,33 @@
 import { TaskStep } from "./TaskStep.js";
 import { TaskResult } from "./TaskResult.js";
+/**
+ * Define the payload for every possible event in the lifecycle.
+ */
+export interface RunnerEventPayloads<TContext> {
+    workflowStart: {
+        context: TContext;
+        steps: TaskStep<TContext>[];
+    };
+    workflowEnd: {
+        context: TContext;
+        results: Map<string, TaskResult>;
+    };
+    taskStart: {
+        step: TaskStep<TContext>;
+    };
+    taskEnd: {
+        step: TaskStep<TContext>;
+        result: TaskResult;
+    };
+    taskSkipped: {
+        step: TaskStep<TContext>;
+        result: TaskResult;
+    };
+}
+/**
+ * A generic listener type that maps the event key to its specific payload.
+ */
+export type RunnerEventListener<TContext, K extends keyof RunnerEventPayloads<TContext>> = (data: RunnerEventPayloads<TContext>[K]) => void | Promise<void>;
 /**
  * The main class that orchestrates the execution of a list of tasks
  * based on their dependencies, with support for parallel execution.
@@ -8,10 +36,29 @@ import { TaskResult } from "./TaskResult.js";
 export declare class TaskRunner<TContext> {
     private context;
     private running;
+    private listeners;
     /**
      * @param context The shared context object to be passed to each task.
      */
     constructor(context: TContext);
+    /**
+     * Subscribe to an event.
+     * @param event The event name.
+     * @param callback The callback to execute when the event is emitted.
+     */
+    on<K extends keyof RunnerEventPayloads<TContext>>(event: K, callback: RunnerEventListener<TContext, K>): void;
+    /**
+     * Unsubscribe from an event.
+     * @param event The event name.
+     * @param callback The callback to remove.
+     */
+    off<K extends keyof RunnerEventPayloads<TContext>>(event: K, callback: RunnerEventListener<TContext, K>): void;
+    /**
+     * Emit an event to all subscribers.
+     * @param event The event name.
+     * @param data The payload for the event.
+     */
+    private emit;
     /**
      * Executes a list of tasks, respecting their dependencies and running
      * independent tasks in parallel.

package/dist/TaskRunner.js

@@ -6,12 +6,56 @@
 export class TaskRunner {
     context;
     running = new Set();
+    listeners = {};
     /**
      * @param context The shared context object to be passed to each task.
      */
     constructor(context) {
         this.context = context;
     }
+    /**
+     * Subscribe to an event.
+     * @param event The event name.
+     * @param callback The callback to execute when the event is emitted.
+     */
+    on(event, callback) {
+        if (!this.listeners[event]) {
+            // Type assertion needed because TypeScript cannot verify that the generic K
+            // matches the specific key in the mapped type during assignment.
+            this.listeners[event] = new Set();
+        }
+        // Type assertion needed to tell TS that this specific Set matches the callback type
+        this.listeners[event].add(callback);
+    }
+    /**
+     * Unsubscribe from an event.
+     * @param event The event name.
+     * @param callback The callback to remove.
+     */
+    off(event, callback) {
+        if (this.listeners[event]) {
+            this.listeners[event].delete(callback);
+        }
+    }
+    /**
+     * Emit an event to all subscribers.
+     * @param event The event name.
+     * @param data The payload for the event.
+     */
+    emit(event, data) {
+        const listeners = this.listeners[event];
+        if (listeners) {
+            for (const listener of listeners) {
+                try {
+                    listener(data);
+                }
+                catch (error) {
+                    // Prevent listener errors from bubbling up
+                    console.error(`Error in event listener for ${String(event)}:`, error);
+                }
+            }
+        }
+    }
     /**
      * Executes a list of tasks, respecting their dependencies and running
      * independent tasks in parallel.
@@ -20,6 +64,7 @@ export class TaskRunner {
      * and values are the corresponding TaskResult objects.
      */
     async execute(steps) {
+        this.emit("workflowStart", { context: this.context, steps });
         const results = new Map();
         while (results.size < steps.length) {
             const pendingSteps = steps.filter((step) => !results.has(step.name) && !this.running.has(step.name));
@@ -34,10 +79,12 @@ export class TaskRunner {
                 const deps = step.dependencies ?? [];
                 const failedDep = deps.find((dep) => results.has(dep) && results.get(dep)?.status !== "success");
                 if (failedDep) {
-                    results.set(step.name, {
+                    const result = {
                         status: "skipped",
                         message: `Skipped due to failed dependency: ${failedDep}`,
-                    });
+                    };
+                    results.set(step.name, result);
+                    this.emit("taskSkipped", { step, result });
                 }
             }
             if (readySteps.length === 0 &&
@@ -49,6 +96,7 @@ export class TaskRunner {
             }
             await Promise.all(readySteps.map(async (step) => {
                 this.running.add(step.name);
+                this.emit("taskStart", { step });
                 try {
                     const result = await step.run(this.context);
                     results.set(step.name, result);
@@ -61,9 +109,12 @@ export class TaskRunner {
                 }
                 finally {
                     this.running.delete(step.name);
+                    const result = results.get(step.name);
+                    this.emit("taskEnd", { step, result });
                 }
             }));
         }
+        this.emit("workflowEnd", { context: this.context, results });
         return results;
     }
 }

package/dist/TaskRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"TaskRunner.js","sourceRoot":"","sources":["../src/TaskRunner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TaskRunner.js","sourceRoot":"","sources":["../src/TaskRunner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@calmo/task-runner",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thalesraymond/task-runner.git"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -10,31 +14,35 @@
       "import": "./dist/index.js"
     }
   },
-  "publishConfig": {
-    "access": "public"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/thalesraymond/task-runner.git"
-  },
   "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "test": "tsc --noEmit -p tsconfig.test.json && vitest run --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "prepare": "husky",
+    "commit": "git add . &&git-cz"
+  },
   "config": {
     "commitizen": {
       "path": "git-cz"
     }
   },
   "keywords": [],
-  "author": "Thales Raymond",
+  "author": "",
   "license": "ISC",
+  "packageManager": "pnpm@10.28.0",
   "devDependencies": {
     "@commitlint/cli": "^20.3.1",
     "@commitlint/config-conventional": "^20.3.1",
     "@eslint/js": "^9.39.2",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.2",
+    "@semantic-release/npm": "^13.1.3",
+    "@semantic-release/release-notes-generator": "^14.1.0",
     "@types/node": "^25.0.9",
     "@vitest/coverage-v8": "4.0.17",
     "eslint": "^9.39.2",
@@ -42,16 +50,9 @@
     "git-cz": "^4.9.0",
     "husky": "^9.1.7",
     "prettier": "^3.8.0",
+    "semantic-release": "^25.0.2",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.53.0",
     "vitest": "^4.0.17"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run --coverage",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write .",
-    "commit": "git add . && git-cz"
   }
-}
+}

package/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+ignoredBuiltDependencies:
+  - esbuild

package/src/TaskResult.ts

@@ -0,0 +1,15 @@
+import { TaskStatus } from "./TaskStatus.js";
+
+/**
+ * Defines the result object returned by a single task step.
+ */
+export interface TaskResult {
+  /** The final status of the task. */
+  status: TaskStatus;
+  /** An optional message, typically used for success statuses. */
+  message?: string;
+  /** An optional error message, typically used for failure statuses. */
+  error?: string;
+  /** Optional data produced by the step for later inspection. */
+  data?: unknown;
+}

package/src/TaskRunner.ts

@@ -0,0 +1,200 @@
+import { TaskStep } from "./TaskStep.js";
+import { TaskResult } from "./TaskResult.js";
+
+/**
+ * Define the payload for every possible event in the lifecycle.
+ */
+export interface RunnerEventPayloads<TContext> {
+  workflowStart: {
+    context: TContext;
+    steps: TaskStep<TContext>[];
+  };
+  workflowEnd: {
+    context: TContext;
+    results: Map<string, TaskResult>;
+  };
+  taskStart: {
+    step: TaskStep<TContext>;
+  };
+  taskEnd: {
+    step: TaskStep<TContext>;
+    result: TaskResult;
+  };
+  taskSkipped: {
+    step: TaskStep<TContext>;
+    result: TaskResult;
+  };
+}
+
+/**
+ * A generic listener type that maps the event key to its specific payload.
+ */
+export type RunnerEventListener<
+  TContext,
+  K extends keyof RunnerEventPayloads<TContext>,
+> = (data: RunnerEventPayloads<TContext>[K]) => void | Promise<void>;
+
+/**
+ * Helper type for the listeners map to avoid private access issues in generic contexts.
+ */
+type ListenerMap<TContext> = {
+  [K in keyof RunnerEventPayloads<TContext>]?: Set<
+    RunnerEventListener<TContext, K>
+  >;
+};
+
+/**
+ * The main class that orchestrates the execution of a list of tasks
+ * based on their dependencies, with support for parallel execution.
+ * @template TContext The shape of the shared context object.
+ */
+export class TaskRunner<TContext> {
+  private running = new Set<string>();
+  private listeners: ListenerMap<TContext> = {};
+
+  /**
+   * @param context The shared context object to be passed to each task.
+   */
+  constructor(private context: TContext) {}
+
+  /**
+   * Subscribe to an event.
+   * @param event The event name.
+   * @param callback The callback to execute when the event is emitted.
+   */
+  public on<K extends keyof RunnerEventPayloads<TContext>>(
+    event: K,
+    callback: RunnerEventListener<TContext, K>
+  ): void {
+    if (!this.listeners[event]) {
+      // Type assertion needed because TypeScript cannot verify that the generic K
+      // matches the specific key in the mapped type during assignment.
+      this.listeners[event] = new Set() as unknown as ListenerMap<TContext>[K];
+    }
+    // Type assertion needed to tell TS that this specific Set matches the callback type
+    (this.listeners[event] as Set<RunnerEventListener<TContext, K>>).add(
+      callback
+    );
+  }
+
+  /**
+   * Unsubscribe from an event.
+   * @param event The event name.
+   * @param callback The callback to remove.
+   */
+  public off<K extends keyof RunnerEventPayloads<TContext>>(
+    event: K,
+    callback: RunnerEventListener<TContext, K>
+  ): void {
+    if (this.listeners[event]) {
+      (this.listeners[event] as Set<RunnerEventListener<TContext, K>>).delete(
+        callback
+      );
+    }
+  }
+
+  /**
+   * Emit an event to all subscribers.
+   * @param event The event name.
+   * @param data The payload for the event.
+   */
+  private emit<K extends keyof RunnerEventPayloads<TContext>>(
+    event: K,
+    data: RunnerEventPayloads<TContext>[K]
+  ): void {
+    const listeners = this.listeners[event] as
+      | Set<RunnerEventListener<TContext, K>>
+      | undefined;
+    if (listeners) {
+      for (const listener of listeners) {
+        try {
+          listener(data);
+        } catch (error) {
+          // Prevent listener errors from bubbling up
+          console.error(
+            `Error in event listener for ${String(event)}:`,
+            error
+          );
+        }
+      }
+    }
+  }
+
+  /**
+   * Executes a list of tasks, respecting their dependencies and running
+   * independent tasks in parallel.
+   * @param steps An array of TaskStep objects to be executed.
+   * @returns A Promise that resolves to a Map where keys are task names
+   * and values are the corresponding TaskResult objects.
+   */
+  async execute(steps: TaskStep<TContext>[]): Promise<Map<string, TaskResult>> {
+    this.emit("workflowStart", { context: this.context, steps });
+
+    const results = new Map<string, TaskResult>();
+
+    while (results.size < steps.length) {
+      const pendingSteps = steps.filter(
+        (step) => !results.has(step.name) && !this.running.has(step.name)
+      );
+
+      const readySteps = pendingSteps.filter((step) => {
+        const deps = step.dependencies ?? [];
+        return deps.every(
+          (dep) => results.has(dep) && results.get(dep)?.status === "success"
+        );
+      });
+
+      // Skip tasks with failed dependencies
+      for (const step of pendingSteps) {
+        if (results.has(step.name)) continue;
+        const deps = step.dependencies ?? [];
+        const failedDep = deps.find(
+          (dep) => results.has(dep) && results.get(dep)?.status !== "success"
+        );
+        if (failedDep) {
+          const result: TaskResult = {
+            status: "skipped",
+            message: `Skipped due to failed dependency: ${failedDep}`,
+          };
+          results.set(step.name, result);
+          this.emit("taskSkipped", { step, result });
+        }
+      }
+
+      if (
+        readySteps.length === 0 &&
+        this.running.size === 0 &&
+        results.size < steps.length
+      ) {
+        const unrunnableSteps = steps.filter((s) => !results.has(s.name));
+        const unrunnableStepNames = unrunnableSteps.map((s) => s.name);
+        throw new Error(
+          `Circular dependency or missing dependency detected. Unable to run tasks: ${unrunnableStepNames.join(", ")}`
+        );
+      }
+
+      await Promise.all(
+        readySteps.map(async (step) => {
+          this.running.add(step.name);
+          this.emit("taskStart", { step });
+          try {
+            const result = await step.run(this.context);
+            results.set(step.name, result);
+          } catch (e) {
+            results.set(step.name, {
+              status: "failure",
+              error: e instanceof Error ? e.message : String(e),
+            });
+          } finally {
+            this.running.delete(step.name);
+            const result = results.get(step.name)!;
+            this.emit("taskEnd", { step, result });
+          }
+        })
+      );
+    }
+
+    this.emit("workflowEnd", { context: this.context, results });
+    return results;
+  }
+}

package/src/TaskStatus.ts

@@ -0,0 +1,4 @@
+/**
+ * Represents the completion status of a task.
+ */
+export type TaskStatus = "success" | "failure" | "skipped";