@forgehive/task 0.1.0

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/README.md

@@ -0,0 +1,241 @@
+# @shadow/task
+
+A powerful task management library for creating type-safe, boundary-separated tasks with validation.
+
+## Installation
+
+```bash
+npm install @shadow/task
+```
+
+## Overview
+
+The `@shadow/task` package provides a way to create strongly-typed tasks with:
+
+- Input validation using schemas
+- Boundary separation for better testability
+- Execution modes (proxy, replay, etc.)
+- Listener support for tracking task execution
+
+## Basic Usage
+
+Here's a simple example of creating a task:
+
+```typescript
+import { createTask, Schema } from '@shadow/task';
+
+// Define a schema for task input validation
+const schema = new Schema({
+  name: Schema.string(),
+  age: Schema.number().optional()
+});
+
+// Define boundaries (external dependencies)
+const boundaries = {
+  saveToDatabase: async (data: any): Promise<void> => {
+    // Implementation...
+  },
+  sendEmail: async (to: string, subject: string): Promise<boolean> => {
+    // Implementation...
+  }
+};
+
+// Create the task with type inference
+const registerUser = createTask(
+  schema,
+  boundaries,
+  async (argv, boundaries) => {
+    // argv is typed based on the schema (has name: string, age?: number)
+    console.log(`Registering user: ${argv.name}`);
+    
+    // Call boundaries with type safety
+    await boundaries.saveToDatabase({ name: argv.name, age: argv.age });
+    const emailSent = await boundaries.sendEmail(
+      'admin@example.com',
+      `New user registered: ${argv.name}`
+    );
+    
+    return {
+      success: true,
+      emailSent,
+      user: { name: argv.name, age: argv.age }
+    };
+  }
+);
+
+// Execute the task
+const result = await registerUser.run({ name: 'John Doe', age: 30 });
+```
+
+## Type Safety
+
+The `createTask` function provides full type inference:
+
+- Input arguments are typed based on the schema
+- Boundaries are typed based on the provided boundaries object
+- Return type is inferred from the task function
+
+## Advanced Usage
+
+### Adding Listeners
+
+You can add listeners to track task execution:
+
+```typescript
+registerUser.addListener((record) => {
+  console.log('Task executed:', record);
+  // record contains:
+  // - input: The input arguments
+  // - output: The task result (if successful)
+  // - error: Error message (if failed)
+  // - boundaries: Boundary execution data
+});
+```
+
+### Execution Modes
+
+Tasks support different execution modes:
+
+- `proxy`: Normal execution (default)
+- `proxy-pass`: Use recorded data if available, otherwise execute normally
+- `proxy-catch`: Use recorded data if execution fails
+- `replay`: Only use recorded data, fail if not available
+
+```typescript
+// Change execution mode
+registerUser.setMode('replay');
+```
+
+### Boundary Data
+
+You can provide pre-recorded boundary data:
+
+```typescript
+registerUser.setBoundariesData({
+  saveToDatabase: [
+    { input: [{ name: 'John', age: 30 }], output: undefined }
+  ],
+  sendEmail: [
+    { input: ['admin@example.com', 'New user registered: John'], output: true }
+  ]
+});
+```
+
+## Real-World Example: CLI Task
+
+Here's an example of a task used in a CLI application:
+
+```typescript
+import { createTask } from '@shadow/task';
+import { Schema } from '@shadow/schema';
+import path from 'path';
+import fs from 'fs/promises';
+
+// Define the schema with optional dryRun flag
+const schema = new Schema({
+  dryRun: Schema.boolean().optional()
+});
+
+// Define boundaries for file operations
+const boundaries = {
+  saveFile: async (path: string, content: string): Promise<void> => {
+    await fs.writeFile(path, content);
+  }
+};
+
+// Create the init task
+export const init = createTask(
+  schema,
+  boundaries,
+  async (argv, boundaries) => {
+    // Handle the dryRun flag
+    const isDryRun = Boolean(argv.dryRun);
+
+    const shadowPath = path.join(process.cwd(), 'shadow.json');
+    const config = {
+      project: { name: 'MyProject' },
+      // ... other config properties
+    };
+
+    const content = JSON.stringify(config, null, 2);
+
+    // Conditionally create the file based on dryRun
+    if (!isDryRun) {
+      await boundaries.saveFile(shadowPath, content);
+      console.log(`Created shadow.json at ${shadowPath}`);
+    } else {
+      console.log('Dry run, not creating shadow.json');
+      console.log(content);
+    }
+
+    return config;
+  }
+);
+```
+
+## Testing Tasks
+
+The boundary separation makes tasks easy to test:
+
+```typescript
+import { init } from './tasks/init';
+
+describe('Init task', () => {
+  it('should create a config file when dryRun is false', async () => {
+    // Mock the saveFile boundary
+    const saveFileMock = jest.fn();
+    
+    // Override the boundaries
+    init.getBoundaries().saveFile = saveFileMock;
+    
+    // Run the task
+    await init.run({ dryRun: false });
+    
+    // Verify the boundary was called
+    expect(saveFileMock).toHaveBeenCalled();
+  });
+  
+  it('should not create a file when dryRun is true', async () => {
+    // Mock the saveFile boundary
+    const saveFileMock = jest.fn();
+    
+    // Override the boundaries
+    init.getBoundaries().saveFile = saveFileMock;
+    
+    // Run the task
+    await init.run({ dryRun: true });
+    
+    // Verify the boundary was not called
+    expect(saveFileMock).not.toHaveBeenCalled();
+  });
+});
+```
+
+## API Reference
+
+### `createTask<S, B, R>(schema, boundaries, fn, config?)`
+
+Creates a new task with type inference.
+
+- `schema`: A Schema instance for input validation
+- `boundaries`: An object containing boundary functions
+- `fn`: The task function that receives validated input and boundaries
+- `config`: Optional configuration (mode, boundariesData)
+
+Returns a `TaskInstanceType` with methods for running and managing the task.
+
+### `TaskInstanceType` Methods
+
+- `run(argv?)`: Executes the task with the given arguments
+- `addListener(fn)`: Adds a listener for task execution
+- `removeListener()`: Removes the current listener
+- `getMode()` / `setMode(mode)`: Get/set the execution mode
+- `getBoundaries()`: Get the wrapped boundary functions
+- `setBoundariesData(data)`: Set pre-recorded boundary data
+- `validate(argv?)`: Validate input without running the task
+- `isValid(argv?)`: Check if input is valid
+- `asBoundary()`: Convert the task to a boundary function
+
+## License
+
+MIT 

package/dist/index.d.ts

@@ -0,0 +1,92 @@
+import { Schema, type SchemaType, type InferSchema } from '@shadow/schema';
+import { type Mode, type Boundaries, type WrappedBoundaries } from './utils/boundary';
+export interface Task {
+    id: string;
+    title: string;
+    completed: boolean;
+}
+export type BaseFunction = (...args: any[]) => any;
+export type { BoundaryFunction, WrappedBoundaryFunction, Boundaries, WrappedBoundaries, Mode } from './utils/boundary';
+export { Schema };
+export interface TaskConfig<B extends Boundaries = Boundaries> {
+    schema?: Schema<Record<string, SchemaType>>;
+    mode?: Mode;
+    boundaries?: B;
+    boundariesData?: Record<string, unknown>;
+}
+/**
+ * Represents the record passed to task listeners
+ */
+export interface TaskRecord<InputType = unknown, OutputType = unknown> {
+    /** The input arguments passed to the task */
+    input: InputType;
+    /** The output returned by the task (if successful) */
+    output?: OutputType;
+    /** The error message if the task failed */
+    error?: string;
+    /** Boundary execution data */
+    boundaries?: Record<string, unknown>;
+}
+export interface TaskInstanceType<Func extends BaseFunction = BaseFunction, B extends Boundaries = Boundaries> {
+    getMode: () => Mode;
+    setMode: (mode: Mode) => void;
+    setSchema: (base: Schema<Record<string, SchemaType>>) => void;
+    getSchema: () => Schema<Record<string, SchemaType>> | undefined;
+    validate: <T extends Record<string, unknown> = Parameters<Func>[0]>(argv?: T) => ReturnType<Schema<Record<string, SchemaType>>['safeParse']> | undefined;
+    isValid: <T extends Record<string, unknown> = Parameters<Func>[0]>(argv?: T) => boolean;
+    addListener: <I = Parameters<Func>[0], O = ReturnType<Func>>(fn: (record: TaskRecord<I, O>) => void) => void;
+    removeListener: () => void;
+    emit: (data: Partial<TaskRecord>) => void;
+    asBoundary: () => (args: Parameters<Func>[0]) => Promise<ReturnType<Func>>;
+    getBoundaries: () => WrappedBoundaries<B>;
+    setBoundariesData: (boundariesData: Record<string, unknown>) => void;
+    getBondariesData: () => Record<string, unknown>;
+    getBondariesRunLog: () => Record<string, unknown>;
+    startRunLog: () => void;
+    run: (argv?: Parameters<Func>[0]) => Promise<ReturnType<Func>>;
+}
+export type InferSchemaType<S> = S extends Schema<any> ? InferSchema<S> : Record<string, unknown>;
+export type TaskFunction<S, B extends Boundaries> = (argv: InferSchemaType<S>, boundaries: WrappedBoundaries<B>) => Promise<any>;
+export declare const Task: {
+    new <B extends Boundaries = Boundaries, Func extends BaseFunction = BaseFunction>(fn: Func, conf?: TaskConfig<B>): {
+        _fn: Func;
+        _mode: Mode;
+        _coolDown: number;
+        _boundariesDefinition: B;
+        _boundaries: WrappedBoundaries<B>;
+        _boundariesData: Record<string, unknown> | null;
+        _schema: Schema<Record<string, SchemaType>> | undefined;
+        _listener?: ((record: TaskRecord<Parameters<Func>[0], ReturnType<Func>>) => void) | undefined;
+        getMode(): Mode;
+        setMode(mode: Mode): void;
+        setSchema(schema: Schema<Record<string, SchemaType>>): void;
+        getSchema(): Schema<Record<string, SchemaType>> | undefined;
+        validate<T extends Record<string, unknown> = Parameters<Func>[0]>(argv?: T): ReturnType<Schema<Record<string, SchemaType>>["safeParse"]> | undefined;
+        isValid<T extends Record<string, unknown> = Parameters<Func>[0]>(argv?: T): boolean;
+        addListener<I = Parameters<Func>[0], O = ReturnType<Func>>(fn: (record: TaskRecord<I, O>) => void): void;
+        removeListener(): void;
+        emit(data: Partial<TaskRecord>): void;
+        getBoundaries(): WrappedBoundaries<B>;
+        setBoundariesData(boundariesData: Record<string, unknown>): void;
+        getBondariesData(): Record<string, unknown>;
+        _createBounderies({ definition, baseData, mode }: {
+            definition: B;
+            baseData: Record<string, unknown> | null;
+            mode?: Mode;
+        }): WrappedBoundaries<B>;
+        getBondariesRunLog(): Record<string, unknown>;
+        startRunLog(): void;
+        asBoundary(): (args: Parameters<Func>[0]) => Promise<ReturnType<Func>>;
+        run(argv?: Parameters<Func>[0]): Promise<ReturnType<Func>>;
+    };
+};
+/**
+ * Helper function to create a task with proper type inference
+ * @param schema The schema to validate input against
+ * @param boundaries The boundaries to use
+ * @param fn The task function
+ * @param config Additional task configuration
+ * @returns A new Task instance with proper type inference
+ */
+export declare function createTask<S extends Schema<Record<string, SchemaType>>, B extends Boundaries, R>(schema: S, boundaries: B, fn: (argv: InferSchemaType<S>, boundaries: WrappedBoundaries<B>) => Promise<R>, config?: Omit<TaskConfig<B>, 'schema' | 'boundaries'>): TaskInstanceType<(argv: InferSchemaType<S>, boundaries: WrappedBoundaries<B>) => Promise<R>, B>;
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Task = exports.Schema = void 0;
+exports.createTask = createTask;
+const schema_1 = require("@shadow/schema");
+Object.defineProperty(exports, "Schema", { enumerable: true, get: function () { return schema_1.Schema; } });
+const boundary_1 = require("./utils/boundary");
+const Task = class Task {
+    constructor(fn, conf = {
+        schema: undefined,
+        mode: 'proxy',
+        boundaries: undefined,
+        boundariesData: undefined
+    }) {
+        var _a, _b, _c;
+        this._fn = fn;
+        this._schema = undefined;
+        if (typeof conf.schema !== 'undefined') {
+            this._schema = conf.schema;
+        }
+        this._mode = (_a = conf.mode) !== null && _a !== void 0 ? _a : 'proxy';
+        this._boundariesDefinition = (_b = conf.boundaries) !== null && _b !== void 0 ? _b : {};
+        this._listener = undefined;
+        // Cool down time before killing the process on cli runner
+        this._coolDown = 1000;
+        // Review this assignment
+        this._boundariesData = (_c = conf.boundariesData) !== null && _c !== void 0 ? _c : null;
+        this._boundaries = this._createBounderies({
+            definition: this._boundariesDefinition,
+            baseData: this._boundariesData,
+            mode: this._mode
+        });
+    }
+    getMode() {
+        return this._mode;
+    }
+    setMode(mode) {
+        for (const name in this._boundaries) {
+            const boundary = this._boundaries[name];
+            boundary.setMode(mode);
+        }
+        this._mode = mode;
+    }
+    setSchema(schema) {
+        this._schema = schema;
+    }
+    getSchema() {
+        return this._schema;
+    }
+    validate(argv) {
+        if (typeof this._schema === 'undefined') {
+            return undefined;
+        }
+        const result = this._schema.safeParse(argv);
+        return result;
+    }
+    isValid(argv) {
+        var _a;
+        if (typeof this._schema === 'undefined') {
+            return true;
+        }
+        const result = this._schema.safeParse(argv);
+        return (_a = result.success) !== null && _a !== void 0 ? _a : false;
+    }
+    // Posible improvement to handle multiple listeners, but so far its not needed
+    addListener(fn) {
+        this._listener = fn;
+    }
+    removeListener() {
+        this._listener = undefined;
+    }
+    /*
+      The listener get the input/outout of the call
+      Plus all the boundary data
+    */
+    emit(data) {
+        if (typeof this._listener === 'undefined') {
+            return;
+        }
+        const event = Object.assign(Object.assign({}, data), { boundaries: this.getBondariesRunLog() });
+        this._listener(event);
+    }
+    getBoundaries() {
+        return this._boundaries;
+    }
+    setBoundariesData(boundariesData) {
+        for (const name in this._boundaries) {
+            const boundary = this._boundaries[name];
+            let tape;
+            if (typeof boundariesData !== 'undefined') {
+                tape = boundariesData[name];
+            }
+            if (typeof boundary !== 'undefined' && typeof tape !== 'undefined') {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                boundary.setTape(tape);
+            }
+        }
+    }
+    getBondariesData() {
+        const boundaries = this._boundaries;
+        const boundariesData = {};
+        for (const name in boundaries) {
+            const boundary = boundaries[name];
+            boundariesData[name] = boundary.getTape();
+        }
+        return boundariesData;
+    }
+    _createBounderies({ definition, baseData, mode = 'proxy' }) {
+        const boundariesFns = {};
+        for (const name in definition) {
+            const boundary = (0, boundary_1.createBoundary)(definition[name]);
+            if (baseData !== null && typeof baseData[name] !== 'undefined') {
+                const tape = baseData[name];
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                boundary.setTape(tape);
+            }
+            boundary.setMode(mode);
+            boundariesFns[name] = boundary;
+        }
+        return boundariesFns;
+    }
+    getBondariesRunLog() {
+        const boundaries = this._boundaries;
+        const boundariesRunLog = {};
+        for (const name in boundaries) {
+            const boundary = boundaries[name];
+            boundariesRunLog[name] = boundary.getRunData();
+        }
+        return boundariesRunLog;
+    }
+    startRunLog() {
+        const boundaries = this._boundaries;
+        for (const name in boundaries) {
+            const boundary = boundaries[name];
+            boundary.startRun();
+        }
+    }
+    asBoundary() {
+        return async (args) => {
+            return await this.run(args);
+        };
+    }
+    async run(argv) {
+        // start run log
+        this.startRunLog();
+        const boundaries = this._boundaries;
+        const q = new Promise((resolve, reject) => {
+            const isValid = this.isValid(argv);
+            if (!isValid) {
+                this.emit({
+                    input: argv,
+                    error: 'Invalid input'
+                });
+                throw new Error('Invalid input');
+            }
+            (async () => {
+                // Use proper typing for the function call
+                const output = await this._fn(argv, boundaries);
+                return output;
+            })().then((output) => {
+                this.emit({
+                    input: argv,
+                    output
+                });
+                resolve(output);
+            }).catch((error) => {
+                this.emit({
+                    input: argv,
+                    error: error.message
+                });
+                reject(error);
+            });
+        });
+        const result = await q;
+        return result;
+    }
+};
+exports.Task = Task;
+/**
+ * Helper function to create a task with proper type inference
+ * @param schema The schema to validate input against
+ * @param boundaries The boundaries to use
+ * @param fn The task function
+ * @param config Additional task configuration
+ * @returns A new Task instance with proper type inference
+ */
+function createTask(schema, boundaries, fn, config) {
+    return new exports.Task(fn, Object.assign({ schema,
+        boundaries }, config));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/test/add-listener-with-boundaries.test.d.ts

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

package/dist/test/add-listener-with-boundaries.test.d.ts.map

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