@forgehive/runner 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ForgeHive
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { TaskInstanceType, BaseFunction } from '@forgehive/task';
+type TaskRecord<T extends TaskInstanceType = TaskInstanceType> = {
+    task: T;
+};
+type Tasks = Record<string, TaskRecord>;
+export interface RunnerParsedArguments {
+    taskName: string;
+    args: unknown;
+}
+export declare class Runner<InputType = unknown, ParseResult extends RunnerParsedArguments = RunnerParsedArguments> {
+    _tasks: Tasks;
+    parseArguments: (data: InputType) => ParseResult;
+    handler: (data: InputType) => Promise<unknown>;
+    constructor(parseArgumentsFn?: (data: InputType) => ParseResult);
+    /**
+     * Set a custom handler function
+     * @param handlerFn The custom handler function
+     */
+    setHandler(handlerFn: (data: InputType) => Promise<unknown>): void;
+    /**
+     * Default handler implementation
+     * @param data Input data
+     * @returns Output data
+     */
+    private defaultHandler;
+    describe(): void;
+    load<T extends BaseFunction>(name: string, task: TaskInstanceType<T>): void;
+    getTask<T extends BaseFunction = BaseFunction>(name: string): TaskInstanceType<T> | undefined;
+    getTasks(): Tasks;
+    getTaskList(): string[];
+    run<T extends BaseFunction, P extends Parameters<T>[0], R = ReturnType<T>>(name: string, args: P): Promise<Awaited<R>>;
+}
+export default Runner;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEhE,KAAK,UAAU,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI;IAC/D,IAAI,EAAE,CAAC,CAAA;CACR,CAAA;AAED,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AAGvC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,qBAAa,MAAM,CAAC,SAAS,GAAG,OAAO,EAAE,WAAW,SAAS,qBAAqB,GAAG,qBAAqB;IACjG,MAAM,EAAE,KAAK,CAAA;IACb,cAAc,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,WAAW,CAAA;IAChD,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;gBAEzC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,WAAW;IAsB/D;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAIlE;;;;OAIG;YACW,cAAc;IAM5B,QAAQ,IAAI,IAAI;IAQhB,IAAI,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IAI3E,OAAO,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,SAAS;IAU7F,QAAQ,IAAI,KAAK;IAIjB,WAAW,IAAI,MAAM,EAAE;IAIjB,GAAG,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAC7E,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAgBvB;AAED,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Runner = void 0;
+class Runner {
+    constructor(parseArgumentsFn) {
+        this._tasks = {};
+        // Use provided parseArguments function or default implementation
+        this.parseArguments = parseArgumentsFn || ((data) => {
+            // Check if data is an object and has the expected properties
+            if (data && typeof data === 'object' && 'task' in data && 'args' in data) {
+                return {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    taskName: String(data.task),
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    args: data.args
+                };
+            }
+            // If data doesn't have the expected structure, throw an error
+            throw new Error('Invalid task data: expected object with task and args properties');
+        });
+        // Set default handler
+        this.handler = this.defaultHandler.bind(this);
+    }
+    /**
+     * Set a custom handler function
+     * @param handlerFn The custom handler function
+     */
+    setHandler(handlerFn) {
+        this.handler = handlerFn;
+    }
+    /**
+     * Default handler implementation
+     * @param data Input data
+     * @returns Output data
+     */
+    async defaultHandler(data) {
+        const { taskName, args } = this.parseArguments(data);
+        const res = await this.run(taskName, args);
+        return res;
+    }
+    describe() {
+        const listItems = this.getTaskList();
+        console.log('Available tasks:');
+        listItems.forEach(taskName => {
+            console.log(`- ${taskName}`);
+        });
+    }
+    load(name, task) {
+        this._tasks[name] = { task };
+    }
+    getTask(name) {
+        if (this._tasks[name] === undefined) {
+            return undefined;
+        }
+        const { task } = this._tasks[name];
+        return task;
+    }
+    getTasks() {
+        return this._tasks;
+    }
+    getTaskList() {
+        return Object.keys(this._tasks);
+    }
+    async run(name, args) {
+        const exists = this._tasks[name];
+        if (exists === undefined) {
+            throw new Error(`Task ${name} not found`);
+        }
+        const { task } = exists;
+        if (task === undefined) {
+            throw new Error(`Task ${name} not found`);
+        }
+        const results = await task.run(args);
+        return results;
+    }
+}
+exports.Runner = Runner;
+exports.default = Runner;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAeA,MAAa,MAAM;IAKjB,YAAY,gBAAmD;QAC7D,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAChB,iEAAiE;QACjE,IAAI,CAAC,cAAc,GAAG,gBAAgB,IAAI,CAAC,CAAC,IAAe,EAAe,EAAE;YAC1E,6DAA6D;YAC7D,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACzE,OAAO;oBACL,8DAA8D;oBAC9D,QAAQ,EAAE,MAAM,CAAE,IAAY,CAAC,IAAI,CAAC;oBACpC,8DAA8D;oBAC9D,IAAI,EAAG,IAAY,CAAC,IAAI;iBACC,CAAA;YAC7B,CAAC;YAED,8DAA8D;YAC9D,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;QACrF,CAAC,CAAC,CAAA;QAEF,sBAAsB;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/C,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,SAAgD;QACzD,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;IAC1B,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,cAAc,CAAC,IAAe;QAC1C,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;QACpD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC1C,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,QAAQ;QACN,MAAM,SAAS,GAAa,IAAI,CAAC,WAAW,EAAE,CAAA;QAC9C,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;QAC/B,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,CAAyB,IAAY,EAAE,IAAyB;QAClE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAA;IAC9B,CAAC;IAED,OAAO,CAAwC,IAAY;QACzD,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAElC,OAAO,IAA2B,CAAA;IACpC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,WAAW;QACT,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC;IAED,KAAK,CAAC,GAAG,CACP,IAAY,EACZ,IAAO;QAEP,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAEhC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAA;QAC3C,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAA;QAEvB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAA;QAC3C,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpC,OAAO,OAAqB,CAAA;IAC9B,CAAC;CACF;AA/FD,wBA+FC;AAED,kBAAe,MAAM,CAAA"}

package/dist/test/runner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner.test.d.ts.map

package/dist/test/runner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.test.d.ts","sourceRoot":"","sources":["../../src/test/runner.test.ts"],"names":[],"mappings":""}

package/dist/test/runner.test.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable @typescript-eslint/no-unused-vars */
+const index_1 = require("../index");
+const task_1 = require("@forgehive/task");
+describe('Runner', () => {
+    it('should create a new Runner instance', () => {
+        const runner = new index_1.Runner();
+        expect(runner).toBeInstanceOf(index_1.Runner);
+        expect(runner._tasks).toEqual({});
+    });
+    it('should throw error when running non-existent task', async () => {
+        const runner = new index_1.Runner();
+        await expect(runner.run('nonExistentTask', {}))
+            .rejects.toThrow('Task nonExistentTask not found');
+    });
+    it('should handle arguments correctly', () => {
+        const runner = new index_1.Runner();
+        const data = {
+            task: 'testTask',
+            args: { value: 'test' }
+        };
+        const parsed = runner.parseArguments(data);
+        expect(parsed).toEqual({
+            taskName: 'testTask',
+            args: { value: 'test' }
+        });
+    });
+    it('should run a task', async () => {
+        const task = new task_1.Task(() => {
+            return 'hi five!!!';
+        });
+        const runner = new index_1.Runner();
+        runner.load('sample', task);
+        const result = await runner.run('sample', {});
+        expect(result).toBe('hi five!!!');
+    });
+    it('should run a task with params', async () => {
+        const taskInt = new task_1.Task(({ int }) => {
+            return int + 5;
+        });
+        const runner = new index_1.Runner();
+        runner.load('sample', taskInt);
+        const result = await runner.run('sample', { int: 6 });
+        expect(result).toBe(11);
+    });
+    it('should run multiple tasks with different params', async () => {
+        const taskInt = new task_1.Task(({ int }) => {
+            return int + 5;
+        });
+        const taskString = new task_1.Task(({ str }) => {
+            return str + ' world';
+        });
+        const runner = new index_1.Runner();
+        runner.load('int', taskInt);
+        runner.load('string', taskString);
+        const int = await runner.run('int', { int: 6 });
+        const str = await runner.run('string', { str: 'hello' });
+        expect(int).toBe(11);
+        expect(str).toBe('hello world');
+    });
+    it('should get task back and be able to run it', async () => {
+        const taskInt = new task_1.Task(async ({ int }) => {
+            return int + 5;
+        });
+        const indentity = new task_1.Task(async function ({ int }) {
+            return int + 5;
+        });
+        const runner = new index_1.Runner();
+        runner.load('int', taskInt);
+        const task = runner.getTask('int');
+        let int = 0;
+        if (task !== undefined) {
+            int = await task.run({ int: 6 });
+        }
+        const int2 = await taskInt.run({ int: 6 });
+        const int3 = await indentity.run({ int: 6 });
+        expect(int).toBe(11);
+        expect(int2).toBe(11);
+        expect(int3).toBe(11);
+    });
+    it('should return undefined if task does not exist', async () => {
+        const runner = new index_1.Runner();
+        const task = runner.getTask('int');
+        expect(task).toBeUndefined();
+    });
+});
+//# sourceMappingURL=runner.test.js.map

package/dist/test/runner.test.js.map

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

package/jest.config.js

@@ -0,0 +1,7 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['**/*.test.ts'],
+  collectCoverageFrom: ['src/**/*.ts']
+}; 

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@forgehive/runner",
+  "version": "0.1.2",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "dependencies": {
+      "@forgehive/schema": "^0.1.0",
+      "@forgehive/task": "^0.1.1"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "jest"
+  },
+  "dependencies": {
+    "@forgehive/schema": "0.1.0",
+    "@forgehive/task": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.19",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "gitHead": "0e8d2be05c08abeb14c5ac0c48d5ed367a7caafd"
+}

package/src/index.ts

@@ -0,0 +1,113 @@
+/* eslint-disable no-console */
+import { TaskInstanceType, BaseFunction } from '@forgehive/task'
+
+type TaskRecord<T extends TaskInstanceType = TaskInstanceType> = {
+  task: T
+}
+
+type Tasks = Record<string, TaskRecord>
+
+// Define the base parsed arguments interface
+export interface RunnerParsedArguments {
+  taskName: string;
+  args: unknown;
+}
+
+export class Runner<InputType = unknown, ParseResult extends RunnerParsedArguments = RunnerParsedArguments> {
+  public _tasks: Tasks
+  public parseArguments: (data: InputType) => ParseResult
+  public handler: (data: InputType) => Promise<unknown>
+
+  constructor(parseArgumentsFn?: (data: InputType) => ParseResult) {
+    this._tasks = {}
+    // Use provided parseArguments function or default implementation
+    this.parseArguments = parseArgumentsFn || ((data: InputType): ParseResult => {
+      // Check if data is an object and has the expected properties
+      if (data && typeof data === 'object' && 'task' in data && 'args' in data) {
+        return {
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          taskName: String((data as any).task),
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          args: (data as any).args
+        } as unknown as ParseResult
+      }
+
+      // If data doesn't have the expected structure, throw an error
+      throw new Error('Invalid task data: expected object with task and args properties')
+    })
+
+    // Set default handler
+    this.handler = this.defaultHandler.bind(this)
+  }
+
+  /**
+   * Set a custom handler function
+   * @param handlerFn The custom handler function
+   */
+  setHandler(handlerFn: (data: InputType) => Promise<unknown>): void {
+    this.handler = handlerFn
+  }
+
+  /**
+   * Default handler implementation
+   * @param data Input data
+   * @returns Output data
+   */
+  private async defaultHandler(data: InputType): Promise<unknown> {
+    const { taskName, args } = this.parseArguments(data)
+    const res = await this.run(taskName, args)
+    return res
+  }
+
+  describe(): void {
+    const listItems: string[] = this.getTaskList()
+    console.log('Available tasks:')
+    listItems.forEach(taskName => {
+      console.log(`- ${taskName}`)
+    })
+  }
+
+  load<T extends BaseFunction>(name: string, task: TaskInstanceType<T>): void {
+    this._tasks[name] = { task }
+  }
+
+  getTask<T extends BaseFunction = BaseFunction>(name: string): TaskInstanceType<T> | undefined {
+    if (this._tasks[name] === undefined) {
+      return undefined
+    }
+
+    const { task } = this._tasks[name]
+
+    return task as TaskInstanceType<T>
+  }
+
+  getTasks(): Tasks {
+    return this._tasks
+  }
+
+  getTaskList(): string[] {
+    return Object.keys(this._tasks)
+  }
+
+  async run<T extends BaseFunction, P extends Parameters<T>[0], R = ReturnType<T>>(
+    name: string,
+    args: P
+  ): Promise<Awaited<R>> {
+    const exists = this._tasks[name]
+
+    if (exists === undefined) {
+      throw new Error(`Task ${name} not found`)
+    }
+
+    const { task } = exists
+
+    if (task === undefined) {
+      throw new Error(`Task ${name} not found`)
+    }
+
+    const results = await task.run(args)
+    return results as Awaited<R>
+  }
+}
+
+export default Runner

package/src/test/runner.test.ts

@@ -0,0 +1,112 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+import { Runner } from '../index'
+import { Task } from '@forgehive/task'
+
+describe('Runner', () => {
+  it('should create a new Runner instance', () => {
+    const runner = new Runner()
+    expect(runner).toBeInstanceOf(Runner)
+    expect(runner._tasks).toEqual({})
+  })
+
+
+  it('should throw error when running non-existent task', async () => {
+    const runner = new Runner()
+    await expect(runner.run('nonExistentTask', {}))
+      .rejects.toThrow('Task nonExistentTask not found')
+  })
+
+  it('should handle arguments correctly', () => {
+    const runner = new Runner()
+    const data = {
+      task: 'testTask',
+      args: { value: 'test' }
+    }
+
+    const parsed = runner.parseArguments(data)
+
+    expect(parsed).toEqual({
+      taskName: 'testTask',
+      args: { value: 'test' }
+    })
+  })
+
+  it('should run a task', async () => {
+    const task = new Task(() => {
+      return 'hi five!!!'
+    })
+
+    const runner = new Runner()
+    runner.load('sample', task)
+
+    const result = await runner.run('sample', {})
+
+    expect(result).toBe('hi five!!!')
+  })
+
+  it('should run a task with params', async () => {
+    const taskInt = new Task(({ int }: { int: number }) => {
+      return int + 5
+    })
+
+    const runner = new Runner()
+    runner.load('sample', taskInt)
+
+    const result = await runner.run<typeof taskInt['_fn'], { int: number }, number>('sample', { int: 6 })
+
+    expect(result).toBe(11)
+  })
+
+  it('should run multiple tasks with different params', async () => {
+    const taskInt = new Task(({ int }: { int: number }) => {
+      return int + 5
+    })
+
+    const taskString = new Task(({ str }: { str: string }) => {
+      return str + ' world'
+    })
+
+    const runner = new Runner()
+    runner.load('int', taskInt)
+    runner.load('string', taskString)
+
+    const int = await runner.run<typeof taskInt['_fn'], { int: number }, number>('int', { int: 6 })
+    const str = await runner.run<typeof taskString['_fn'], { str: string }, string>('string', { str: 'hello' })
+
+    expect(int).toBe(11)
+    expect(str).toBe('hello world')
+  })
+
+  it('should get task back and be able to run it', async () => {
+    const taskInt = new Task(async ({ int }: { int: number }): Promise<number> => {
+      return int + 5
+    })
+
+    const indentity = new Task(async function ({ int }: { int: number }): Promise<number> {
+      return int + 5
+    })
+
+    const runner = new Runner()
+    runner.load('int', taskInt)
+
+    const task = runner.getTask<typeof taskInt['_fn']>('int')
+
+    let int = 0
+    if (task !== undefined) {
+      int = await task.run({ int: 6 })
+    }
+    const int2 = await taskInt.run({ int: 6 })
+    const int3 = await indentity.run({ int: 6 })
+
+    expect(int).toBe(11)
+    expect(int2).toBe(11)
+    expect(int3).toBe(11)
+  })
+
+  it('should return undefined if task does not exist', async () => {
+    const runner = new Runner()
+    const task = runner.getTask('int')
+
+    expect(task).toBeUndefined()
+  })
+})

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "composite": false,
+    "incremental": false,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}