@owservable/actions 1.6.3 → 1.7.1

package/README.md

@@ -2,28 +2,251 @@
 
 # @owservable/actions
 
-## TypeDoc Documentation
+A TypeScript library implementing the Action Pattern for creating reusable, executable units of work that can be run as commands, cronjobs, watchers, workers, or controllers.
 
-See the <a href="https://owservable.github.io/actions/docs/" target="_blank">TypeDoc documentation</a>.
+## 🚀 Features
 
-## Test Coverage
+- **Action Pattern Implementation**: Structured approach to organizing business logic
+- **Multiple Execution Contexts**: Run actions as commands, cronjobs, watchers, workers, or controllers
+- **Commander.js Integration**: Built-in CLI command support with option parsing
+- **TypeScript Support**: Full type safety with comprehensive interfaces
+- **Flexible Architecture**: Abstract base class with specialized interfaces
 
-See the <a href="https://owservable.github.io/actions/coverage/" target="_blank">Test coverage</a>.
+## 📦 Installation
 
-- functions
-	- findAction
-	- runActionAsCommand
-	- getOptionAndDefaultValue
+```bash
+npm install @owservable/actions
+```
 
+or
 
-- interfaces
-	- ActionInterface
-	- ActionAsWorkerInterface
-	- ActionAsWatcherInterface
-	- ActionAsCommandInterface
-	- ActionAsCronjobInterface
-	- ActionAsControllerInterface
+```bash
+yarn add @owservable/actions
+```
 
+or
 
-- abstracts
-    - Action
+```bash
+pnpm add @owservable/actions
+```
+
+## 🔧 Usage
+
+### Basic Action Implementation
+
+```typescript
+import { Action, ActionInterface } from '@owservable/actions';
+
+class MyAction extends Action implements ActionInterface {
+  protected _description = 'My custom action';
+
+  async handle(...args: any[]): Promise<any> {
+    // Your business logic here
+    console.log('Action executed with args:', args);
+    return { success: true };
+  }
+
+  description(): string {
+    return this._description;
+  }
+}
+```
+
+### Command Line Action
+
+```typescript
+import { Action, ActionAsCommandInterface } from '@owservable/actions';
+
+class MyCommandAction extends Action implements ActionAsCommandInterface {
+  protected _signature = 'my-command {--option=default}';
+  protected _description = 'My command action';
+
+  async handle(...args: any[]): Promise<any> {
+    // Your business logic here
+    return { success: true };
+  }
+
+  async asCommand(options: any): Promise<void> {
+    console.log('Command executed with options:', options);
+    await this.handle(options);
+  }
+
+  signature(): string {
+    return this._signature;
+  }
+
+  description(): string {
+    return this._description;
+  }
+}
+```
+
+### Running Actions as Commands
+
+```typescript
+import { runActionAsCommand } from '@owservable/actions';
+
+const action = new MyCommandAction();
+await runActionAsCommand(action);
+```
+
+### Cronjob Action
+
+```typescript
+import { Action, ActionAsCronjobInterface } from '@owservable/actions';
+
+class MyCronjobAction extends Action implements ActionAsCronjobInterface {
+  protected _schedule = '0 0 * * *'; // Daily at midnight
+  protected _description = 'Daily cleanup job';
+
+  async handle(...args: any[]): Promise<any> {
+    // Your cronjob logic here
+    return { success: true };
+  }
+
+  async asCronjob(): Promise<void> {
+    console.log('Cronjob executed');
+    await this.handle();
+  }
+
+  schedule(): string {
+    return this._schedule;
+  }
+
+  description(): string {
+    return this._description;
+  }
+}
+```
+
+### Watcher Action
+
+```typescript
+import { Action, ActionAsWatcherInterface } from '@owservable/actions';
+
+class MyWatcherAction extends Action implements ActionAsWatcherInterface {
+  protected _description = 'File watcher action';
+
+  async handle(...args: any[]): Promise<any> {
+    // Your watcher logic here
+    return { success: true };
+  }
+
+  async asWatcher(): Promise<void> {
+    console.log('Watcher executed');
+    await this.handle();
+  }
+
+  description(): string {
+    return this._description;
+  }
+}
+```
+
+## 📚 API Documentation
+
+### Base Classes
+
+#### `Action`
+Abstract base class providing common functionality for all actions.
+
+**Properties:**
+- `_signature`: Command signature for CLI actions
+- `_description`: Human-readable description
+- `_schedule`: Cron schedule for cronjob actions
+
+**Methods:**
+- `signature()`: Returns the command signature
+- `description()`: Returns the action description
+- `schedule()`: Returns the cron schedule
+
+### Interfaces
+
+#### `ActionInterface`
+Base interface that all actions must implement.
+
+**Methods:**
+- `description(): string` - Returns action description
+- `handle(...args: any[]): Promise<any>` - Main action logic
+
+#### `ActionAsCommandInterface`
+Interface for actions that can be run as CLI commands.
+
+**Extends:** `ActionInterface`
+
+**Methods:**
+- `signature(): string` - Returns command signature
+- `asCommand(options: any): Promise<void>` - Execute as command
+
+#### `ActionAsCronjobInterface`
+Interface for actions that can be run as scheduled cronjobs.
+
+**Extends:** `ActionInterface`
+
+**Methods:**
+- `asCronjob(): Promise<void>` - Execute as cronjob
+
+#### `ActionAsWatcherInterface`
+Interface for actions that can be run as file/directory watchers.
+
+**Extends:** `ActionInterface`
+
+**Methods:**
+- `asWatcher(): Promise<void>` - Execute as watcher
+
+#### `ActionAsWorkerInterface`
+Interface for actions that can be run as background workers.
+
+**Extends:** `ActionInterface`
+
+**Methods:**
+- `asWorker(): Promise<void>` - Execute as worker
+
+#### `ActionAsControllerInterface`
+Interface for actions that can be run as HTTP controllers.
+
+**Extends:** `ActionInterface`
+
+**Methods:**
+- `asController(): Promise<void>` - Execute as controller
+
+### Utility Functions
+
+#### `runActionAsCommand(action: ActionAsCommandInterface): Promise<void>`
+Executes an action as a CLI command with option parsing.
+
+#### `findCommandAction(actionsFolder: string, actionName: string): ActionAsCommandInterface`
+Finds and loads a command action from a folder.
+
+#### `getOptionAndDefaultValue(config: string): {option: string, defaultValue: any}`
+Parses command option configuration strings.
+
+## 🏗️ Requirements
+
+- Node.js >= 20
+- TypeScript support
+
+## 🧪 Testing
+
+```bash
+npm test
+```
+
+## 📖 Documentation
+
+- **TypeDoc Documentation**: [https://owservable.github.io/actions/docs/](https://owservable.github.io/actions/docs/)
+- **Test Coverage**: [https://owservable.github.io/actions/coverage/](https://owservable.github.io/actions/coverage/)
+
+## 🔗 Related Projects
+
+- [@owservable/folders](https://github.com/owservable/folders) - File system utilities
+- [@owservable/fastify-auto-routes](https://github.com/owservable/fastify-auto-routes) - Fastify auto routing
+- [owservable](https://github.com/owservable/owservable) - Main reactive backend library
+
+## 📄 License
+
+Licensed under [The Unlicense](./LICENSE).
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

package/lib/src/abstracts/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../../src/abstracts/action.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,MAA8B,MAAM;IAApC;QACW,eAAU,GAAW,EAAE,CAAC;QACxB,iBAAY,GAAW,EAAE,CAAC;QAC1B,cAAS,GAAW,EAAE,CAAC;IAalC,CAAC;IAXO,SAAS;QACf,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAEM,WAAW;QACjB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;IAEM,QAAQ;QACd,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;CACD;AAhBD,yBAgBC"}

package/lib/src/functions/find.command.action.d.ts

@@ -0,0 +1,2 @@
+export declare const findCommandAction: Function;
+export default findCommandAction;

package/lib/src/functions/find.command.action.js

@@ -0,0 +1,40 @@
+'use strict';
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findCommandAction = void 0;
+const folders_1 = require("@owservable/folders");
+const findCommandAction = (root, cliCommand) => __awaiter(void 0, void 0, void 0, function* () {
+    const actionPaths = yield (0, folders_1.listSubfoldersFilesByFolderName)(root, 'actions');
+    for (const actionPath of actionPaths) {
+        try {
+            const ActionClass = require(actionPath).default;
+            if (!ActionClass)
+                continue;
+            const actionInstance = new ActionClass();
+            const signature = actionInstance.signature();
+            if (!signature || typeof signature !== 'string')
+                continue;
+            const signatureParts = signature.trim().split(/\s+/);
+            const actionCommand = signatureParts[0];
+            if (!actionCommand || actionCommand.length === 0)
+                continue;
+            if (cliCommand === actionCommand)
+                return actionInstance;
+        }
+        catch (error) {
+            console.warn(`[@owservable/actions] Failed to load action from ${actionPath}:`, error instanceof Error ? error.message : error);
+        }
+    }
+    return null;
+});
+exports.findCommandAction = findCommandAction;
+exports.default = exports.findCommandAction;
+//# sourceMappingURL=find.command.action.js.map

package/lib/src/functions/find.command.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.command.action.js","sourceRoot":"","sources":["../../../src/functions/find.command.action.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;;;;;;;;AAEb,iDAAoE;AAI7D,MAAM,iBAAiB,GAAa,CAAO,IAAY,EAAE,UAAkB,EAA4C,EAAE;IAC/H,MAAM,WAAW,GAAa,MAAM,IAAA,yCAA+B,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAErF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACtC,IAAI,CAAC;YACJ,MAAM,WAAW,GAAuC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC;YACpF,IAAI,CAAC,WAAW;gBAAE,SAAS;YAE3B,MAAM,cAAc,GAA6B,IAAI,WAAW,EAAE,CAAC;YAGnE,MAAM,SAAS,GAAuB,cAAc,CAAC,SAAS,EAAE,CAAC;YACjE,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,SAAS;YAG1D,MAAM,cAAc,GAAa,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/D,MAAM,aAAa,GAAW,cAAc,CAAC,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAE3D,IAAI,UAAU,KAAK,aAAa;gBAAE,OAAO,cAAc,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAEhB,OAAO,CAAC,IAAI,CAAC,oDAAoD,UAAU,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACjI,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC,CAAA,CAAC;AA3BW,QAAA,iBAAiB,qBA2B5B;AACF,kBAAe,yBAAiB,CAAC"}

package/lib/{functions → src/functions}/get.option.and.default.value.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getOptionAndDefaultValue = void 0;
 const getOptionAndDefaultValue = (config) => {
     let defaultValue;
-    let option = config.substring(1).substring(-1).slice(0, -1).trim();
+    let option = config.slice(1, -1).trim();
     if (option.indexOf('=') >= 0) {
         defaultValue = option.substring(option.indexOf('=') + 1).trim();
         option = option.replace('=' + defaultValue, '').trim();

package/lib/src/functions/get.option.and.default.value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.option.and.default.value.js","sourceRoot":"","sources":["../../../src/functions/get.option.and.default.value.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AAEN,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAA0C,EAAE;IAClG,IAAI,YAAgC,CAAC;IACrC,IAAI,MAAM,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAGhD,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAC,MAAM,EAAE,YAAY,EAAC,CAAC;AAC/B,CAAC,CAAC;AAXW,QAAA,wBAAwB,4BAWnC;AACF,kBAAe,gCAAwB,CAAC"}

package/lib/src/functions/run.action.as.command.d.ts

@@ -0,0 +1,2 @@
+export declare const runActionAsCommand: Function;
+export default runActionAsCommand;

package/lib/{functions → src/functions}/run.action.as.command.js

@@ -11,21 +11,22 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runActionAsCommand = void 0;
 const commander_1 = require("commander");
-const lodash_1 = require("lodash");
 const get_option_and_default_value_1 = require("../functions/get.option.and.default.value");
 const runActionAsCommand = (action) => __awaiter(void 0, void 0, void 0, function* () {
     const program = new commander_1.Command();
     const signature = action.signature();
-    const actionCommand = (0, lodash_1.first)(signature.split(' '));
+    const actionCommand = signature.split(' ')[0];
     program
         .name('pnpm cli')
         .command(actionCommand)
         .description(action.description());
     const options = signature.match(/{([^}]*)}/g);
-    (0, lodash_1.each)(options, (config) => {
-        const { option, defaultValue } = (0, get_option_and_default_value_1.default)(config);
-        program.option(option, '', defaultValue);
-    });
+    if (options) {
+        options.forEach((config) => {
+            const { option, defaultValue } = (0, get_option_and_default_value_1.default)(config);
+            program.option(option, '', defaultValue);
+        });
+    }
     program.parse(process.argv);
     return action.asCommand(program.opts());
 });

package/lib/src/functions/run.action.as.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.action.as.command.js","sourceRoot":"","sources":["../../../src/functions/run.action.as.command.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;;;;;;;;AAEb,yCAAkC;AAGlC,4FAAiF;AAE1E,MAAM,kBAAkB,GAAa,CAAO,MAAgC,EAAiB,EAAE;IACrG,MAAM,OAAO,GAAY,IAAI,mBAAO,EAAE,CAAC;IACvC,MAAM,SAAS,GAAW,MAAM,CAAC,SAAS,EAAE,CAAC;IAC7C,MAAM,aAAa,GAAW,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtD,OAAO;SACL,IAAI,CAAC,UAAU,CAAC;SAChB,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAoB,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC/D,IAAI,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,OAAO,CAAC,CAAC,MAAc,EAAQ,EAAE;YACxC,MAAM,EAAC,MAAM,EAAE,YAAY,EAAC,GAAuD,IAAA,sCAAwB,EAAC,MAAM,CAAC,CAAC;YACpH,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC,CAAA,CAAC;AArBW,QAAA,kBAAkB,sBAqB7B;AACF,kBAAe,0BAAkB,CAAC"}

package/lib/src/interfaces/action.as.command.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.as.command.interface.js","sourceRoot":"","sources":["../../../src/interfaces/action.as.command.interface.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/lib/src/interfaces/action.as.controller.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.as.controller.interface.js","sourceRoot":"","sources":["../../../src/interfaces/action.as.controller.interface.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/lib/src/interfaces/action.as.cronjob.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.as.cronjob.interface.js","sourceRoot":"","sources":["../../../src/interfaces/action.as.cronjob.interface.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/lib/src/interfaces/action.as.watcher.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.as.watcher.interface.js","sourceRoot":"","sources":["../../../src/interfaces/action.as.watcher.interface.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/lib/src/interfaces/action.as.worker.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.as.worker.interface.js","sourceRoot":"","sources":["../../../src/interfaces/action.as.worker.interface.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/lib/src/interfaces/action.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.interface.js","sourceRoot":"","sources":["../../../src/interfaces/action.interface.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/lib/{owservable.actions.d.ts → src/owservable.actions.d.ts}

@@ -8,6 +8,9 @@ import ActionAsCommandInterface from './interfaces/action.as.command.interface';
 import ActionAsCronjobInterface from './interfaces/action.as.cronjob.interface';
 import ActionAsControllerInterface from './interfaces/action.as.controller.interface';
 import Action from './abstracts/action';
-export { findCommandAction, runActionAsCommand, getOptionAndDefaultValue, ActionInterface, ActionAsWorkerInterface, ActionAsWatcherInterface, ActionAsCommandInterface, ActionAsCronjobInterface, ActionAsControllerInterface, Action };
+import CommandSignatureType from './types/command.signature.type';
+import CommandOptionType from './types/command.option.type';
+import CommandContextType from './types/command.context.type';
+export { findCommandAction, runActionAsCommand, getOptionAndDefaultValue, ActionInterface, ActionAsWorkerInterface, ActionAsWatcherInterface, ActionAsCommandInterface, ActionAsCronjobInterface, ActionAsControllerInterface, Action, CommandSignatureType, CommandOptionType, CommandContextType };
 declare const OwservableActions: {};
 export default OwservableActions;

package/lib/src/owservable.actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owservable.actions.js","sourceRoot":"","sources":["../../src/owservable.actions.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AAGb,yEAAgE;AAsB/D,4BAtBM,6BAAiB,CAsBN;AArBlB,6EAAmE;AAsBlE,6BAtBM,+BAAkB,CAsBN;AArBnB,2FAAgF;AAsB/E,mCAtBM,sCAAwB,CAsBN;AAXzB,+CAAwC;AAsBvC,iBAtBM,gBAAM,CAsBN;AAOP,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,kBAAe,iBAAiB,CAAC"}

package/lib/src/types/command.context.type.d.ts

@@ -0,0 +1,6 @@
+type CommandContextType = {
+    signature: string;
+    options: Record<string, any>;
+    verbose?: boolean;
+};
+export default CommandContextType;

package/lib/src/types/command.context.type.js

@@ -0,0 +1,3 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command.context.type.js.map

package/lib/src/types/command.context.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.context.type.js","sourceRoot":"","sources":["../../../src/types/command.context.type.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/lib/src/types/command.option.type.d.ts

@@ -0,0 +1,6 @@
+type CommandOptionType = {
+    name: string;
+    defaultValue?: string;
+    required?: boolean;
+};
+export default CommandOptionType;

package/lib/src/types/command.option.type.js

@@ -0,0 +1,3 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command.option.type.js.map

package/lib/src/types/command.option.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.option.type.js","sourceRoot":"","sources":["../../../src/types/command.option.type.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/lib/src/types/command.signature.type.d.ts

@@ -0,0 +1,7 @@
+import CommandOptionType from './command.option.type';
+type CommandSignatureType = {
+    command: string;
+    parameters: string[];
+    options: CommandOptionType[];
+};
+export default CommandSignatureType;

package/lib/src/types/command.signature.type.js

@@ -0,0 +1,3 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command.signature.type.js.map

package/lib/src/types/command.signature.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.signature.type.js","sourceRoot":"","sources":["../../../src/types/command.signature.type.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/lib/test/abstracts/action.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/abstracts/action.spec.js

@@ -0,0 +1,60 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+const action_1 = require("../../src/abstracts/action");
+class TestAction extends action_1.default {
+    constructor(signature, description, schedule) {
+        super();
+        if (signature)
+            this._signature = signature;
+        if (description)
+            this._description = description;
+        if (schedule)
+            this._schedule = schedule;
+    }
+}
+describe('action tests', () => {
+    it('Action exists and is a function', () => {
+        expect(action_1.default).toBeDefined();
+        expect(typeof action_1.default).toBe('function');
+    });
+    it('Action can be extended', () => {
+        const action = new TestAction();
+        expect(action).toBeDefined();
+        expect(action).toBeInstanceOf(action_1.default);
+    });
+    it('Action has signature method that returns empty string by default', () => {
+        const action = new TestAction();
+        expect(typeof action.signature).toBe('function');
+        expect(action.signature()).toBe('');
+    });
+    it('Action has description method that returns empty string by default', () => {
+        const action = new TestAction();
+        expect(typeof action.description).toBe('function');
+        expect(action.description()).toBe('');
+    });
+    it('Action has schedule method that returns empty string by default', () => {
+        const action = new TestAction();
+        expect(typeof action.schedule).toBe('function');
+        expect(action.schedule()).toBe('');
+    });
+    it('Action protected properties can be set and retrieved', () => {
+        const testSignature = 'test-command {--option}';
+        const testDescription = 'Test command description';
+        const testSchedule = '0 */5 * * * *';
+        const action = new TestAction(testSignature, testDescription, testSchedule);
+        expect(action.signature()).toBe(testSignature);
+        expect(action.description()).toBe(testDescription);
+        expect(action.schedule()).toBe(testSchedule);
+    });
+    it('Action methods return string type', () => {
+        const action = new TestAction();
+        expect(typeof action.signature()).toBe('string');
+        expect(typeof action.description()).toBe('string');
+        expect(typeof action.schedule()).toBe('string');
+    });
+    it('Action is an abstract class', () => {
+        expect(action_1.default).toBeDefined();
+        expect(typeof action_1.default).toBe('function');
+    });
+});
+//# sourceMappingURL=action.spec.js.map

package/lib/test/abstracts/action.spec.js.map

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

package/lib/test/functions/find.command.action.spec.d.ts

@@ -0,0 +1 @@
+export {};