@qodalis/cli-server-node 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Qodalis Solutions
+
+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,146 @@
+# Qodalis CLI Server (Node.js)
+
+A Node.js CLI server framework for the [Qodalis CLI](https://github.com/qodalis-solutions/angular-web-cli) ecosystem. Built with Express.
+
+## Installation
+
+```bash
+npm install @qodalis/cli-server-node
+```
+
+## Quick Start
+
+### As a Library
+
+```typescript
+import { createCliServer, CliCommandProcessor, CliProcessCommand } from '@qodalis/cli-server-node';
+
+class MyCommandProcessor extends CliCommandProcessor {
+    command = 'greet';
+    description = 'Says hello';
+
+    async handleAsync(command: CliProcessCommand): Promise<string> {
+        return 'Hello from my server!';
+    }
+}
+
+const { app, eventSocketManager } = createCliServer({
+    configure: (builder) => {
+        builder.addProcessor(new MyCommandProcessor());
+    },
+});
+
+const server = app.listen(8047, () => {
+    console.log('CLI server listening on http://localhost:8047');
+});
+
+eventSocketManager.attach(server);
+
+process.on('SIGINT', async () => {
+    await eventSocketManager.broadcastDisconnect();
+    server.close();
+    process.exit(0);
+});
+```
+
+### As a Standalone Server
+
+```bash
+npx qodalis-cli-server
+```
+
+Or with environment variables:
+
+```bash
+PORT=9000 npx qodalis-cli-server
+```
+
+## API Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/api/cli/version` | Server version |
+| GET | `/api/cli/commands` | List available commands |
+| POST | `/api/cli/execute` | Execute a command |
+| WS | `/ws/cli/events` | WebSocket event channel |
+
+## Creating Command Processors
+
+```typescript
+import {
+    CliCommandProcessor,
+    CliCommandParameterDescriptor,
+    CliProcessCommand,
+} from '@qodalis/cli-server-node';
+
+class TimeCommandProcessor extends CliCommandProcessor {
+    command = 'time';
+    description = 'Shows the current server time';
+
+    parameters = [
+        new CliCommandParameterDescriptor('utc', 'Show time in UTC', false, 'boolean'),
+        new CliCommandParameterDescriptor('format', 'Date/time format string', false, 'string', ['-f'], 'yyyy-MM-dd HH:mm:ss'),
+    ];
+
+    async handleAsync(command: CliProcessCommand): Promise<string> {
+        const useUtc = 'utc' in (command.args ?? {});
+        const now = new Date();
+        return useUtc ? `UTC: ${now.toISOString()}` : `Local: ${now.toLocaleString()}`;
+    }
+}
+```
+
+### Sub-commands
+
+```typescript
+class MathCommandProcessor extends CliCommandProcessor {
+    command = 'math';
+    description = 'Performs basic math operations';
+    allowUnlistedCommands = false;
+
+    processors = [
+        new MathAddProcessor(),
+        new MathMultiplyProcessor(),
+    ];
+
+    async handleAsync(command: CliProcessCommand): Promise<string> {
+        return 'Usage: math add|multiply --a <number> --b <number>';
+    }
+}
+```
+
+## Docker
+
+```bash
+docker run -p 8047:8047 ghcr.io/qodalis-solutions/cli-server-node
+```
+
+The Docker image runs a demo server with sample processors (echo, status, time, hello, math).
+
+## Demo
+
+```bash
+cd demo
+npm install
+npm start
+# Server starts on http://localhost:8047
+```
+
+## Project Structure
+
+```
+src/
+  abstractions/     # ICliCommandProcessor, CliProcessCommand, parameter descriptors
+  models/           # CliServerOutput, CliServerResponse, command descriptors
+  services/         # Registry, executor, response builder, WebSocket manager
+  controllers/      # Express router for /api/cli routes
+  extensions/       # CliBuilder fluent API
+  processors/       # Built-in echo and status processors
+  create-cli-server.ts  # Factory function for standalone/library use
+  server.ts         # Standalone entry point
+demo/               # Demo app with 5 sample processors
+```
+
+## License
+
+MIT

package/dist/abstractions/cli-command-author.d.ts

@@ -0,0 +1,11 @@
+export interface ICliCommandAuthor {
+    name: string;
+    email: string;
+}
+export declare class CliCommandAuthor implements ICliCommandAuthor {
+    name: string;
+    email: string;
+    constructor(name: string, email: string);
+}
+export declare const DefaultLibraryAuthor: ICliCommandAuthor;
+//# sourceMappingURL=cli-command-author.d.ts.map

package/dist/abstractions/cli-command-author.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-author.d.ts","sourceRoot":"","sources":["../../src/abstractions/cli-command-author.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAiB,YAAW,iBAAiB;IAE3C,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;gBADb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM;CAE3B;AAED,eAAO,MAAM,oBAAoB,EAAE,iBAGlC,CAAC"}

package/dist/abstractions/cli-command-author.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultLibraryAuthor = exports.CliCommandAuthor = void 0;
+class CliCommandAuthor {
+    name;
+    email;
+    constructor(name, email) {
+        this.name = name;
+        this.email = email;
+    }
+}
+exports.CliCommandAuthor = CliCommandAuthor;
+exports.DefaultLibraryAuthor = new CliCommandAuthor('Nicolae Lupei', 'nicolae.lupei@qodalis.com');
+//# sourceMappingURL=cli-command-author.js.map

package/dist/abstractions/cli-command-author.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-author.js","sourceRoot":"","sources":["../../src/abstractions/cli-command-author.ts"],"names":[],"mappings":";;;AAKA,MAAa,gBAAgB;IAEd;IACA;IAFX,YACW,IAAY,EACZ,KAAa;QADb,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAQ;IACrB,CAAC;CACP;AALD,4CAKC;AAEY,QAAA,oBAAoB,GAAsB,IAAI,gBAAgB,CACvE,eAAe,EACf,2BAA2B,CAC9B,CAAC"}

package/dist/abstractions/cli-command-parameter-descriptor.d.ts

@@ -0,0 +1,18 @@
+export interface ICliCommandParameterDescriptor {
+    name: string;
+    aliases?: string[];
+    description: string;
+    required: boolean;
+    type: string;
+    defaultValue?: any;
+}
+export declare class CliCommandParameterDescriptor implements ICliCommandParameterDescriptor {
+    name: string;
+    description: string;
+    required: boolean;
+    type: string;
+    aliases?: string[] | undefined;
+    defaultValue?: any | undefined;
+    constructor(name: string, description: string, required?: boolean, type?: string, aliases?: string[] | undefined, defaultValue?: any | undefined);
+}
+//# sourceMappingURL=cli-command-parameter-descriptor.d.ts.map

package/dist/abstractions/cli-command-parameter-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-parameter-descriptor.d.ts","sourceRoot":"","sources":["../../src/abstractions/cli-command-parameter-descriptor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,8BAA8B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,GAAG,CAAC;CACtB;AAED,qBAAa,6BAA8B,YAAW,8BAA8B;IAErE,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,MAAM;IACnB,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE;IAClB,YAAY,CAAC,EAAE,GAAG;gBALlB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,OAAe,EACzB,IAAI,GAAE,MAAiB,EACvB,OAAO,CAAC,EAAE,MAAM,EAAE,YAAA,EAClB,YAAY,CAAC,EAAE,GAAG,YAAA;CAEhC"}

package/dist/abstractions/cli-command-parameter-descriptor.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliCommandParameterDescriptor = void 0;
+class CliCommandParameterDescriptor {
+    name;
+    description;
+    required;
+    type;
+    aliases;
+    defaultValue;
+    constructor(name, description, required = false, type = 'string', aliases, defaultValue) {
+        this.name = name;
+        this.description = description;
+        this.required = required;
+        this.type = type;
+        this.aliases = aliases;
+        this.defaultValue = defaultValue;
+    }
+}
+exports.CliCommandParameterDescriptor = CliCommandParameterDescriptor;
+//# sourceMappingURL=cli-command-parameter-descriptor.js.map

package/dist/abstractions/cli-command-parameter-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-parameter-descriptor.js","sourceRoot":"","sources":["../../src/abstractions/cli-command-parameter-descriptor.ts"],"names":[],"mappings":";;;AASA,MAAa,6BAA6B;IAE3B;IACA;IACA;IACA;IACA;IACA;IANX,YACW,IAAY,EACZ,WAAmB,EACnB,WAAoB,KAAK,EACzB,OAAe,QAAQ,EACvB,OAAkB,EAClB,YAAkB;QALlB,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAQ;QACnB,aAAQ,GAAR,QAAQ,CAAiB;QACzB,SAAI,GAAJ,IAAI,CAAmB;QACvB,YAAO,GAAP,OAAO,CAAW;QAClB,iBAAY,GAAZ,YAAY,CAAM;IAC1B,CAAC;CACP;AATD,sEASC"}

package/dist/abstractions/cli-command-processor.d.ts

@@ -0,0 +1,26 @@
+import { ICliCommandAuthor } from './cli-command-author';
+import { ICliCommandParameterDescriptor } from './cli-command-parameter-descriptor';
+import { CliProcessCommand } from './cli-process-command';
+export interface ICliCommandProcessor {
+    command: string;
+    description: string;
+    author: ICliCommandAuthor;
+    allowUnlistedCommands?: boolean;
+    valueRequired?: boolean;
+    version: string;
+    processors?: ICliCommandProcessor[];
+    parameters?: ICliCommandParameterDescriptor[];
+    handleAsync(command: CliProcessCommand): Promise<string>;
+}
+export declare abstract class CliCommandProcessor implements ICliCommandProcessor {
+    abstract command: string;
+    abstract description: string;
+    author: ICliCommandAuthor;
+    allowUnlistedCommands?: boolean;
+    valueRequired?: boolean;
+    version: string;
+    processors?: ICliCommandProcessor[];
+    parameters?: ICliCommandParameterDescriptor[];
+    abstract handleAsync(command: CliProcessCommand): Promise<string>;
+}
+//# sourceMappingURL=cli-command-processor.d.ts.map

package/dist/abstractions/cli-command-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-processor.d.ts","sourceRoot":"","sources":["../../src/abstractions/cli-command-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAwB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAC9C,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D;AAED,8BAAsB,mBAAoB,YAAW,oBAAoB;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,iBAAiB,CAAwB;IACjD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAW;IAC1B,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAE9C,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CACpE"}

package/dist/abstractions/cli-command-processor.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliCommandProcessor = void 0;
+const cli_command_author_1 = require("./cli-command-author");
+class CliCommandProcessor {
+    author = cli_command_author_1.DefaultLibraryAuthor;
+    allowUnlistedCommands;
+    valueRequired;
+    version = '1.0.0';
+    processors;
+    parameters;
+}
+exports.CliCommandProcessor = CliCommandProcessor;
+//# sourceMappingURL=cli-command-processor.js.map

package/dist/abstractions/cli-command-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-processor.js","sourceRoot":"","sources":["../../src/abstractions/cli-command-processor.ts"],"names":[],"mappings":";;;AAAA,6DAA+E;AAgB/E,MAAsB,mBAAmB;IAGrC,MAAM,GAAsB,yCAAoB,CAAC;IACjD,qBAAqB,CAAW;IAChC,aAAa,CAAW;IACxB,OAAO,GAAW,OAAO,CAAC;IAC1B,UAAU,CAA0B;IACpC,UAAU,CAAoC;CAGjD;AAXD,kDAWC"}

package/dist/abstractions/cli-process-command.d.ts

@@ -0,0 +1,9 @@
+export interface CliProcessCommand {
+    command: string;
+    data?: any;
+    chainCommands: string[];
+    rawCommand: string;
+    value?: string;
+    args: Record<string, any>;
+}
+//# sourceMappingURL=cli-process-command.d.ts.map

package/dist/abstractions/cli-process-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-process-command.d.ts","sourceRoot":"","sources":["../../src/abstractions/cli-process-command.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B"}

package/dist/abstractions/cli-process-command.js

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

package/dist/abstractions/cli-process-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-process-command.js","sourceRoot":"","sources":["../../src/abstractions/cli-process-command.ts"],"names":[],"mappings":""}

package/dist/abstractions/index.d.ts

@@ -0,0 +1,5 @@
+export { ICliCommandAuthor, CliCommandAuthor, DefaultLibraryAuthor } from './cli-command-author';
+export { CliProcessCommand } from './cli-process-command';
+export { ICliCommandParameterDescriptor, CliCommandParameterDescriptor } from './cli-command-parameter-descriptor';
+export { ICliCommandProcessor, CliCommandProcessor } from './cli-command-processor';
+//# sourceMappingURL=index.d.ts.map

package/dist/abstractions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abstractions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/abstractions/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliCommandProcessor = exports.CliCommandParameterDescriptor = exports.DefaultLibraryAuthor = exports.CliCommandAuthor = void 0;
+var cli_command_author_1 = require("./cli-command-author");
+Object.defineProperty(exports, "CliCommandAuthor", { enumerable: true, get: function () { return cli_command_author_1.CliCommandAuthor; } });
+Object.defineProperty(exports, "DefaultLibraryAuthor", { enumerable: true, get: function () { return cli_command_author_1.DefaultLibraryAuthor; } });
+var cli_command_parameter_descriptor_1 = require("./cli-command-parameter-descriptor");
+Object.defineProperty(exports, "CliCommandParameterDescriptor", { enumerable: true, get: function () { return cli_command_parameter_descriptor_1.CliCommandParameterDescriptor; } });
+var cli_command_processor_1 = require("./cli-command-processor");
+Object.defineProperty(exports, "CliCommandProcessor", { enumerable: true, get: function () { return cli_command_processor_1.CliCommandProcessor; } });
+//# sourceMappingURL=index.js.map

package/dist/abstractions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/abstractions/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiG;AAArE,sHAAA,gBAAgB,OAAA;AAAE,0HAAA,oBAAoB,OAAA;AAElE,uFAAmH;AAA1E,iJAAA,6BAA6B,OAAA;AACtE,iEAAoF;AAArD,4HAAA,mBAAmB,OAAA"}

package/dist/controllers/cli-controller.d.ts

@@ -0,0 +1,4 @@
+import { Router } from 'express';
+import { ICliCommandRegistry, ICliCommandExecutorService } from '../services';
+export declare function createCliController(registry: ICliCommandRegistry, executor: ICliCommandExecutorService): Router;
+//# sourceMappingURL=cli-controller.d.ts.map

package/dist/controllers/cli-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-controller.d.ts","sourceRoot":"","sources":["../../src/controllers/cli-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE9E,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,0BAA0B,GACrC,MAAM,CAmBR"}

package/dist/controllers/cli-controller.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCliController = createCliController;
+const express_1 = require("express");
+function createCliController(registry, executor) {
+    const router = (0, express_1.Router)();
+    router.get('/version', (_req, res) => {
+        res.json({ version: '1.0.0' });
+    });
+    router.get('/commands', (_req, res) => {
+        const descriptors = registry.processors.map(mapToDescriptor);
+        res.json(descriptors);
+    });
+    router.post('/execute', async (req, res) => {
+        const command = req.body;
+        const response = await executor.executeAsync(command);
+        res.json(response);
+    });
+    return router;
+}
+function mapToDescriptor(processor) {
+    const descriptor = {
+        command: processor.command,
+        description: processor.description,
+        version: processor.version,
+    };
+    if (processor.parameters?.length) {
+        descriptor.parameters = processor.parameters.map((p) => ({
+            name: p.name,
+            aliases: p.aliases,
+            description: p.description,
+            required: p.required,
+            type: p.type,
+            defaultValue: p.defaultValue,
+        }));
+    }
+    if (processor.processors?.length) {
+        descriptor.processors = processor.processors.map(mapToDescriptor);
+    }
+    return descriptor;
+}
+//# sourceMappingURL=cli-controller.js.map

package/dist/controllers/cli-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-controller.js","sourceRoot":"","sources":["../../src/controllers/cli-controller.ts"],"names":[],"mappings":";;AAKA,kDAsBC;AA3BD,qCAAiC;AAKjC,SAAgB,mBAAmB,CAC/B,QAA6B,EAC7B,QAAoC;IAEpC,MAAM,MAAM,GAAG,IAAA,gBAAM,GAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACjC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAClC,MAAM,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACtD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CAAC,SAA+B;IACpD,MAAM,UAAU,GAA+B;QAC3C,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,OAAO,EAAE,SAAS,CAAC,OAAO;KAC7B,CAAC;IAEF,IAAI,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAC/B,UAAU,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAC5C,CAAC,CAAC,EAA0C,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,YAAY,EAAE,CAAC,CAAC,YAAY;SAC/B,CAAC,CACL,CAAC;IACN,CAAC;IAED,IAAI,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAC/B,UAAU,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC"}

package/dist/create-cli-server.d.ts

@@ -0,0 +1,25 @@
+import { Express } from 'express';
+import cors from 'cors';
+import { CliCommandRegistry, CliEventSocketManager } from './services';
+import { CliBuilder } from './extensions';
+export interface CliServerOptions {
+    /** Base path for CLI routes. Defaults to '/api/cli'. */
+    basePath?: string;
+    /** CORS configuration. Pass `true` for permissive, `false` to disable, or a cors options object. */
+    cors?: boolean | cors.CorsOptions;
+    /** Configure processors via the builder. */
+    configure?: (builder: CliBuilder) => void;
+}
+/**
+ * Creates a fully configured Express app with CLI routes mounted.
+ *
+ * Use this for standalone server mode. For integration into an existing
+ * Express app, use `createCliController` directly instead.
+ */
+export declare function createCliServer(options?: CliServerOptions): {
+    app: Express;
+    registry: CliCommandRegistry;
+    builder: CliBuilder;
+    eventSocketManager: CliEventSocketManager;
+};
+//# sourceMappingURL=create-cli-server.d.ts.map

package/dist/create-cli-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-cli-server.d.ts","sourceRoot":"","sources":["../src/create-cli-server.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAA6B,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,MAAM,WAAW,gBAAgB;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC;IAClC,4CAA4C;IAC5C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG;IAC7D,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,UAAU,CAAC;IACpB,kBAAkB,EAAE,qBAAqB,CAAC;CAC7C,CAwBA"}

package/dist/create-cli-server.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCliServer = createCliServer;
+const express_1 = __importDefault(require("express"));
+const cors_1 = __importDefault(require("cors"));
+const services_1 = require("./services");
+const extensions_1 = require("./extensions");
+const cli_controller_1 = require("./controllers/cli-controller");
+/**
+ * Creates a fully configured Express app with CLI routes mounted.
+ *
+ * Use this for standalone server mode. For integration into an existing
+ * Express app, use `createCliController` directly instead.
+ */
+function createCliServer(options = {}) {
+    const { basePath = '/api/cli', cors: corsOption = true, configure } = options;
+    const app = (0, express_1.default)();
+    if (corsOption !== false) {
+        app.use((0, cors_1.default)(corsOption === true ? undefined : corsOption));
+    }
+    app.use(express_1.default.json());
+    const registry = new services_1.CliCommandRegistry();
+    const builder = new extensions_1.CliBuilder(registry);
+    if (configure) {
+        configure(builder);
+    }
+    const executor = new services_1.CliCommandExecutorService(registry);
+    app.use(basePath, (0, cli_controller_1.createCliController)(registry, executor));
+    const eventSocketManager = new services_1.CliEventSocketManager();
+    return { app, registry, builder, eventSocketManager };
+}
+//# sourceMappingURL=create-cli-server.js.map

package/dist/create-cli-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-cli-server.js","sourceRoot":"","sources":["../src/create-cli-server.ts"],"names":[],"mappings":";;;;;AAqBA,0CA6BC;AAlDD,sDAA2C;AAC3C,gDAAwB;AACxB,yCAAkG;AAClG,6CAA0C;AAC1C,iEAAmE;AAWnE;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,UAA4B,EAAE;IAM1D,MAAM,EAAE,QAAQ,GAAG,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9E,MAAM,GAAG,GAAG,IAAA,iBAAO,GAAE,CAAC;IAEtB,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,IAAA,cAAI,EAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,MAAM,QAAQ,GAAG,IAAI,6BAAkB,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,uBAAU,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,SAAS,EAAE,CAAC;QACZ,SAAS,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,oCAAyB,CAAC,QAAQ,CAAC,CAAC;IACzD,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAA,oCAAmB,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE3D,MAAM,kBAAkB,GAAG,IAAI,gCAAqB,EAAE,CAAC;IAEvD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC1D,CAAC"}

package/dist/extensions/cli-builder.d.ts

@@ -0,0 +1,9 @@
+import { ICliCommandProcessor } from '../abstractions';
+import { CliCommandRegistry } from '../services';
+export declare class CliBuilder {
+    private readonly _registry;
+    constructor(registry: CliCommandRegistry);
+    addProcessor(processor: ICliCommandProcessor): CliBuilder;
+    get registry(): CliCommandRegistry;
+}
+//# sourceMappingURL=cli-builder.d.ts.map

package/dist/extensions/cli-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-builder.d.ts","sourceRoot":"","sources":["../../src/extensions/cli-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAEnC,QAAQ,EAAE,kBAAkB;IAIxC,YAAY,CAAC,SAAS,EAAE,oBAAoB,GAAG,UAAU;IAKzD,IAAI,QAAQ,IAAI,kBAAkB,CAEjC;CACJ"}

package/dist/extensions/cli-builder.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliBuilder = void 0;
+class CliBuilder {
+    _registry;
+    constructor(registry) {
+        this._registry = registry;
+    }
+    addProcessor(processor) {
+        this._registry.register(processor);
+        return this;
+    }
+    get registry() {
+        return this._registry;
+    }
+}
+exports.CliBuilder = CliBuilder;
+//# sourceMappingURL=cli-builder.js.map

package/dist/extensions/cli-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-builder.js","sourceRoot":"","sources":["../../src/extensions/cli-builder.ts"],"names":[],"mappings":";;;AAGA,MAAa,UAAU;IACF,SAAS,CAAqB;IAE/C,YAAY,QAA4B;QACpC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED,YAAY,CAAC,SAA+B;QACxC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;CACJ;AAfD,gCAeC"}

package/dist/extensions/index.d.ts

@@ -0,0 +1,2 @@
+export { CliBuilder } from './cli-builder';
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/extensions/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliBuilder = void 0;
+var cli_builder_1 = require("./cli-builder");
+Object.defineProperty(exports, "CliBuilder", { enumerable: true, get: function () { return cli_builder_1.CliBuilder; } });
+//# sourceMappingURL=index.js.map

package/dist/extensions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":";;;AAAA,6CAA2C;AAAlC,yGAAA,UAAU,OAAA"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { ICliCommandAuthor, CliCommandAuthor, DefaultLibraryAuthor, CliProcessCommand, ICliCommandParameterDescriptor, CliCommandParameterDescriptor, ICliCommandProcessor, CliCommandProcessor, } from './abstractions';
+export { CliServerOutput, CliServerResponse, CliServerCommandDescriptor, CliServerCommandParameterDescriptorDto, } from './models';
+export { ICliCommandRegistry, CliCommandRegistry, ICliResponseBuilder, CliResponseBuilder, ICliCommandExecutorService, CliCommandExecutorService, CliEventSocketManager, } from './services';
+export { createCliController } from './controllers/cli-controller';
+export { CliBuilder } from './extensions';
+export { CliEchoCommandProcessor } from './processors/cli-echo-command-processor';
+export { CliStatusCommandProcessor } from './processors/cli-status-command-processor';
+export { CliSystemCommandProcessor } from './processors/cli-system-command-processor';
+export { CliHttpCommandProcessor } from './processors/cli-http-command-processor';
+export { CliHashCommandProcessor } from './processors/cli-hash-command-processor';
+export { CliBase64CommandProcessor } from './processors/cli-base64-command-processor';
+export { CliUuidCommandProcessor } from './processors/cli-uuid-command-processor';
+export { createCliServer, CliServerOptions } from './create-cli-server';
+//# 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,EACH,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,mBAAmB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACH,eAAe,EACf,iBAAiB,EACjB,0BAA0B,EAC1B,sCAAsC,GACzC,MAAM,UAAU,CAAC;AAGlB,OAAO,EACH,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,GACxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAGlF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCliServer = exports.CliUuidCommandProcessor = exports.CliBase64CommandProcessor = exports.CliHashCommandProcessor = exports.CliHttpCommandProcessor = exports.CliSystemCommandProcessor = exports.CliStatusCommandProcessor = exports.CliEchoCommandProcessor = exports.CliBuilder = exports.createCliController = exports.CliEventSocketManager = exports.CliCommandExecutorService = exports.CliResponseBuilder = exports.CliCommandRegistry = exports.CliCommandProcessor = exports.CliCommandParameterDescriptor = exports.DefaultLibraryAuthor = exports.CliCommandAuthor = void 0;
+// Abstractions
+var abstractions_1 = require("./abstractions");
+Object.defineProperty(exports, "CliCommandAuthor", { enumerable: true, get: function () { return abstractions_1.CliCommandAuthor; } });
+Object.defineProperty(exports, "DefaultLibraryAuthor", { enumerable: true, get: function () { return abstractions_1.DefaultLibraryAuthor; } });
+Object.defineProperty(exports, "CliCommandParameterDescriptor", { enumerable: true, get: function () { return abstractions_1.CliCommandParameterDescriptor; } });
+Object.defineProperty(exports, "CliCommandProcessor", { enumerable: true, get: function () { return abstractions_1.CliCommandProcessor; } });
+// Services
+var services_1 = require("./services");
+Object.defineProperty(exports, "CliCommandRegistry", { enumerable: true, get: function () { return services_1.CliCommandRegistry; } });
+Object.defineProperty(exports, "CliResponseBuilder", { enumerable: true, get: function () { return services_1.CliResponseBuilder; } });
+Object.defineProperty(exports, "CliCommandExecutorService", { enumerable: true, get: function () { return services_1.CliCommandExecutorService; } });
+Object.defineProperty(exports, "CliEventSocketManager", { enumerable: true, get: function () { return services_1.CliEventSocketManager; } });
+// Controller
+var cli_controller_1 = require("./controllers/cli-controller");
+Object.defineProperty(exports, "createCliController", { enumerable: true, get: function () { return cli_controller_1.createCliController; } });
+// Extensions
+var extensions_1 = require("./extensions");
+Object.defineProperty(exports, "CliBuilder", { enumerable: true, get: function () { return extensions_1.CliBuilder; } });
+// Processors
+var cli_echo_command_processor_1 = require("./processors/cli-echo-command-processor");
+Object.defineProperty(exports, "CliEchoCommandProcessor", { enumerable: true, get: function () { return cli_echo_command_processor_1.CliEchoCommandProcessor; } });
+var cli_status_command_processor_1 = require("./processors/cli-status-command-processor");
+Object.defineProperty(exports, "CliStatusCommandProcessor", { enumerable: true, get: function () { return cli_status_command_processor_1.CliStatusCommandProcessor; } });
+var cli_system_command_processor_1 = require("./processors/cli-system-command-processor");
+Object.defineProperty(exports, "CliSystemCommandProcessor", { enumerable: true, get: function () { return cli_system_command_processor_1.CliSystemCommandProcessor; } });
+var cli_http_command_processor_1 = require("./processors/cli-http-command-processor");
+Object.defineProperty(exports, "CliHttpCommandProcessor", { enumerable: true, get: function () { return cli_http_command_processor_1.CliHttpCommandProcessor; } });
+var cli_hash_command_processor_1 = require("./processors/cli-hash-command-processor");
+Object.defineProperty(exports, "CliHashCommandProcessor", { enumerable: true, get: function () { return cli_hash_command_processor_1.CliHashCommandProcessor; } });
+var cli_base64_command_processor_1 = require("./processors/cli-base64-command-processor");
+Object.defineProperty(exports, "CliBase64CommandProcessor", { enumerable: true, get: function () { return cli_base64_command_processor_1.CliBase64CommandProcessor; } });
+var cli_uuid_command_processor_1 = require("./processors/cli-uuid-command-processor");
+Object.defineProperty(exports, "CliUuidCommandProcessor", { enumerable: true, get: function () { return cli_uuid_command_processor_1.CliUuidCommandProcessor; } });
+// Server factory
+var create_cli_server_1 = require("./create-cli-server");
+Object.defineProperty(exports, "createCliServer", { enumerable: true, get: function () { return create_cli_server_1.createCliServer; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,eAAe;AACf,+CASwB;AAPpB,gHAAA,gBAAgB,OAAA;AAChB,oHAAA,oBAAoB,OAAA;AAGpB,6HAAA,6BAA6B,OAAA;AAE7B,mHAAA,mBAAmB,OAAA;AAWvB,WAAW;AACX,uCAQoB;AANhB,8GAAA,kBAAkB,OAAA;AAElB,8GAAA,kBAAkB,OAAA;AAElB,qHAAA,yBAAyB,OAAA;AACzB,iHAAA,qBAAqB,OAAA;AAGzB,aAAa;AACb,+DAAmE;AAA1D,qHAAA,mBAAmB,OAAA;AAE5B,aAAa;AACb,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAEnB,aAAa;AACb,sFAAkF;AAAzE,qIAAA,uBAAuB,OAAA;AAChC,0FAAsF;AAA7E,yIAAA,yBAAyB,OAAA;AAClC,0FAAsF;AAA7E,yIAAA,yBAAyB,OAAA;AAClC,sFAAkF;AAAzE,qIAAA,uBAAuB,OAAA;AAChC,sFAAkF;AAAzE,qIAAA,uBAAuB,OAAA;AAChC,0FAAsF;AAA7E,yIAAA,yBAAyB,OAAA;AAClC,sFAAkF;AAAzE,qIAAA,uBAAuB,OAAA;AAEhC,iBAAiB;AACjB,yDAAwE;AAA/D,oHAAA,eAAe,OAAA"}

package/dist/models/cli-server-command-descriptor.d.ts

@@ -0,0 +1,16 @@
+export interface CliServerCommandParameterDescriptorDto {
+    name: string;
+    aliases?: string[];
+    description: string;
+    required: boolean;
+    type: string;
+    defaultValue?: any;
+}
+export interface CliServerCommandDescriptor {
+    command: string;
+    description?: string;
+    version?: string;
+    parameters?: CliServerCommandParameterDescriptorDto[];
+    processors?: CliServerCommandDescriptor[];
+}
+//# sourceMappingURL=cli-server-command-descriptor.d.ts.map

package/dist/models/cli-server-command-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-server-command-descriptor.d.ts","sourceRoot":"","sources":["../../src/models/cli-server-command-descriptor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sCAAsC;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,sCAAsC,EAAE,CAAC;IACtD,UAAU,CAAC,EAAE,0BAA0B,EAAE,CAAC;CAC7C"}