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

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

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

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

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

package/dist/{controllers/cli-controller.js → src/controllers/cli-controller-v2.js}

@@ -1,14 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCliController = createCliController;
+exports.createCliControllerV2 = createCliControllerV2;
 const express_1 = require("express");
-function createCliController(registry, executor) {
+const SERVER_VERSION = '2.0.0';
+function createCliControllerV2(registry, executor) {
     const router = (0, express_1.Router)();
     router.get('/version', (_req, res) => {
-        res.json({ version: '1.0.0' });
+        res.json({ apiVersion: 2, serverVersion: SERVER_VERSION });
     });
     router.get('/commands', (_req, res) => {
-        const descriptors = registry.processors.map(mapToDescriptor);
+        const descriptors = registry.processors
+            .filter((p) => (p.apiVersion ?? 1) >= 2)
+            .map(mapToDescriptor);
         res.json(descriptors);
     });
     router.post('/execute', async (req, res) => {
@@ -23,6 +26,7 @@ function mapToDescriptor(processor) {
         command: processor.command,
         description: processor.description,
         version: processor.version,
+        apiVersion: processor.apiVersion ?? 1,
     };
     if (processor.parameters?.length) {
         descriptor.parameters = processor.parameters.map((p) => ({
@@ -39,4 +43,4 @@ function mapToDescriptor(processor) {
     }
     return descriptor;
 }
-//# sourceMappingURL=cli-controller.js.map
+//# sourceMappingURL=cli-controller-v2.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-controller-v2.js","sourceRoot":"","sources":["../../../src/controllers/cli-controller-v2.ts"],"names":[],"mappings":";;AAOA,sDAwBC;AA/BD,qCAAiC;AAKjC,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,SAAgB,qBAAqB,CACjC,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,UAAU,EAAE,CAAC,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAClC,MAAM,WAAW,GAAG,QAAQ,CAAC,UAAU;aAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;aACvC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC1B,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;QAC1B,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,CAAC;KACxC,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/src/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;AAIjC,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAI9E,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,0BAA0B,GACrC,MAAM,CAuCR"}

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

@@ -0,0 +1,94 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCliController = createCliController;
+const express_1 = require("express");
+const os = __importStar(require("os"));
+const SERVER_VERSION = '1.0.0';
+function createCliController(registry, executor) {
+    const router = (0, express_1.Router)();
+    router.get('/version', (_req, res) => {
+        res.json({ version: SERVER_VERSION });
+    });
+    router.get('/capabilities', (_req, res) => {
+        const detectedOs = os.platform() === 'win32'
+            ? 'win32'
+            : os.platform() === 'darwin'
+                ? 'darwin'
+                : 'linux';
+        const shell = os.platform() === 'win32' ? 'powershell' : 'bash';
+        const shellPath = os.platform() === 'win32'
+            ? 'C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe'
+            : '/bin/bash';
+        res.json({
+            shell: true,
+            os: detectedOs,
+            shellPath,
+            version: SERVER_VERSION,
+        });
+    });
+    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/src/controllers/cli-controller.js.map

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

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

@@ -0,0 +1,3 @@
+import { Router } from 'express';
+export declare function createCliVersionController(): Router;
+//# sourceMappingURL=cli-version-controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-version-controller.d.ts","sourceRoot":"","sources":["../../../src/controllers/cli-version-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAMjC,wBAAgB,0BAA0B,IAAI,MAAM,CAgCnD"}

package/dist/src/controllers/cli-version-controller.js

@@ -0,0 +1,68 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCliVersionController = createCliVersionController;
+const express_1 = require("express");
+const os = __importStar(require("os"));
+const SERVER_VERSION = '2.0.0';
+function createCliVersionController() {
+    const router = (0, express_1.Router)();
+    router.get('/version', (_req, res) => {
+        res.json({
+            supportedVersions: [1, 2],
+            preferredVersion: 2,
+            serverVersion: SERVER_VERSION,
+        });
+    });
+    router.get('/capabilities', (_req, res) => {
+        const detectedOs = os.platform() === 'win32'
+            ? 'win32'
+            : os.platform() === 'darwin'
+                ? 'darwin'
+                : 'linux';
+        const shell = os.platform() === 'win32' ? 'powershell' : 'bash';
+        const shellPath = os.platform() === 'win32'
+            ? 'C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe'
+            : '/bin/bash';
+        res.json({
+            shell: true,
+            os: detectedOs,
+            shellPath,
+            version: SERVER_VERSION,
+        });
+    });
+    return router;
+}
+//# sourceMappingURL=cli-version-controller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-version-controller.js","sourceRoot":"","sources":["../../../src/controllers/cli-version-controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,gEAgCC;AAtCD,qCAAiC;AACjC,uCAAyB;AAGzB,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,SAAgB,0BAA0B;IACtC,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;YACL,iBAAiB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACzB,gBAAgB,EAAE,CAAC;YACnB,aAAa,EAAE,cAAc;SAChC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACtC,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO;YACxC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,QAAQ;gBACxB,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,OAAO,CAAC;QAElB,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;QAChE,MAAM,SAAS,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO;YACvC,CAAC,CAAC,gEAAgE;YAClE,CAAC,CAAC,WAAW,CAAC;QAElB,GAAG,CAAC,IAAI,CAAC;YACL,KAAK,EAAE,IAAI;YACX,EAAE,EAAE,UAAU;YACd,SAAS;YACT,OAAO,EAAE,cAAc;SAC1B,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/src/controllers/filesystem-controller.d.ts

@@ -0,0 +1,8 @@
+import { Router } from 'express';
+import { IFileStorageProvider } from '@qodalis/cli-server-plugin-filesystem';
+/**
+ * Creates an Express router that exposes filesystem operations backed by
+ * a pluggable `IFileStorageProvider`.
+ */
+export declare function createFilesystemRouter(provider: IFileStorageProvider): Router;
+//# sourceMappingURL=filesystem-controller.d.ts.map

package/dist/src/controllers/filesystem-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-controller.d.ts","sourceRoot":"","sources":["../../../src/controllers/filesystem-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAEpD,OAAO,EACH,oBAAoB,EAMvB,MAAM,uCAAuC,CAAC;AAmB/C;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAgI7E"}

package/dist/src/controllers/filesystem-controller.js

@@ -0,0 +1,151 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFilesystemRouter = createFilesystemRouter;
+const express_1 = require("express");
+const multer_1 = __importDefault(require("multer"));
+const cli_server_plugin_filesystem_1 = require("@qodalis/cli-server-plugin-filesystem");
+/**
+ * Maps provider errors to appropriate HTTP status codes and sends a JSON error response.
+ */
+function handleError(err, res) {
+    if (err instanceof cli_server_plugin_filesystem_1.FileNotFoundError) {
+        res.status(404).json({ error: err.message });
+    }
+    else if (err instanceof cli_server_plugin_filesystem_1.PermissionDeniedError) {
+        res.status(403).json({ error: err.message });
+    }
+    else if (err instanceof cli_server_plugin_filesystem_1.NotADirectoryError || err instanceof cli_server_plugin_filesystem_1.IsADirectoryError) {
+        res.status(400).json({ error: err.message });
+    }
+    else if (err instanceof cli_server_plugin_filesystem_1.FileExistsError) {
+        res.status(409).json({ error: err.message });
+    }
+    else {
+        res.status(500).json({ error: err.message });
+    }
+}
+/**
+ * Creates an Express router that exposes filesystem operations backed by
+ * a pluggable `IFileStorageProvider`.
+ */
+function createFilesystemRouter(provider) {
+    const router = (0, express_1.Router)();
+    const upload = (0, multer_1.default)({ storage: multer_1.default.memoryStorage() });
+    // ------------------------------------------------------------------ ls
+    router.get('/ls', async (req, res) => {
+        try {
+            const dirPath = req.query.path;
+            if (!dirPath) {
+                res.status(400).json({ error: 'Missing required query parameter: path' });
+                return;
+            }
+            const entries = await provider.list(dirPath);
+            res.json({ entries });
+        }
+        catch (err) {
+            handleError(err, res);
+        }
+    });
+    // ----------------------------------------------------------------- cat
+    router.get('/cat', async (req, res) => {
+        try {
+            const filePath = req.query.path;
+            if (!filePath) {
+                res.status(400).json({ error: 'Missing required query parameter: path' });
+                return;
+            }
+            const content = await provider.readFile(filePath);
+            res.json({ content });
+        }
+        catch (err) {
+            handleError(err, res);
+        }
+    });
+    // ---------------------------------------------------------------- stat
+    router.get('/stat', async (req, res) => {
+        try {
+            const filePath = req.query.path;
+            if (!filePath) {
+                res.status(400).json({ error: 'Missing required query parameter: path' });
+                return;
+            }
+            const fileStat = await provider.stat(filePath);
+            res.json(fileStat);
+        }
+        catch (err) {
+            handleError(err, res);
+        }
+    });
+    // ------------------------------------------------------------ download
+    router.get('/download', async (req, res) => {
+        try {
+            const filePath = req.query.path;
+            if (!filePath) {
+                res.status(400).json({ error: 'Missing required query parameter: path' });
+                return;
+            }
+            const stream = await provider.getDownloadStream(filePath);
+            // Extract filename from the path for Content-Disposition header
+            const filename = filePath.split('/').pop() || 'download';
+            res.setHeader('Content-Disposition', `attachment; filename="${filename}"`);
+            stream.pipe(res);
+        }
+        catch (err) {
+            handleError(err, res);
+        }
+    });
+    // -------------------------------------------------------------- upload
+    router.post('/upload', upload.single('file'), async (req, res) => {
+        try {
+            const targetPath = req.body?.path;
+            if (!targetPath) {
+                res.status(400).json({ error: 'Missing required field: path' });
+                return;
+            }
+            if (!req.file) {
+                res.status(400).json({ error: 'Missing required file upload' });
+                return;
+            }
+            await provider.uploadFile(targetPath, req.file.buffer);
+            res.json({ path: targetPath, size: req.file.size });
+        }
+        catch (err) {
+            handleError(err, res);
+        }
+    });
+    // --------------------------------------------------------------- mkdir
+    router.post('/mkdir', async (req, res) => {
+        try {
+            const dirPath = req.body?.path;
+            if (!dirPath) {
+                res.status(400).json({ error: 'Missing required field: path' });
+                return;
+            }
+            await provider.mkdir(dirPath, true);
+            res.json({ path: dirPath });
+        }
+        catch (err) {
+            handleError(err, res);
+        }
+    });
+    // ----------------------------------------------------------------- rm
+    router.delete('/rm', async (req, res) => {
+        try {
+            const targetPath = req.query.path;
+            if (!targetPath) {
+                res.status(400).json({ error: 'Missing required query parameter: path' });
+                return;
+            }
+            await provider.remove(targetPath, true);
+            res.json({ deleted: targetPath });
+        }
+        catch (err) {
+            handleError(err, res);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=filesystem-controller.js.map

package/dist/src/controllers/filesystem-controller.js.map

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

package/dist/{create-cli-server.d.ts → src/create-cli-server.d.ts}

@@ -3,7 +3,7 @@ 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'. */
+    /** Base path for CLI routes. Defaults to '/api/qcli'. */
     basePath?: string;
     /** CORS configuration. Pass `true` for permissive, `false` to disable, or a cors options object. */
     cors?: boolean | cors.CorsOptions;

package/dist/src/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;AAO1C,MAAM,WAAW,gBAAgB;IAC7B,yDAAyD;IACzD,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,CA+CA"}

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

@@ -0,0 +1,57 @@
+"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");
+const cli_controller_v2_1 = require("./controllers/cli-controller-v2");
+const cli_version_controller_1 = require("./controllers/cli-version-controller");
+const filesystem_controller_1 = require("./controllers/filesystem-controller");
+const cli_server_plugin_filesystem_1 = require("@qodalis/cli-server-plugin-filesystem");
+/**
+ * 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/qcli', 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);
+    // Version discovery endpoint
+    app.use('/api/qcli', (0, cli_version_controller_1.createCliVersionController)());
+    // API v1 routes
+    app.use('/api/v1/qcli', (0, cli_controller_1.createCliController)(registry, executor));
+    // API v2 routes
+    app.use('/api/v2/qcli', (0, cli_controller_v2_1.createCliControllerV2)(registry, executor));
+    // Custom basePath fallback (when user overrides the default)
+    if (basePath !== '/api/v1/qcli' && basePath !== '/api/v2/qcli') {
+        app.use(basePath, (0, cli_controller_1.createCliController)(registry, executor));
+    }
+    // Filesystem API — provider-based
+    let fsProvider = builder.fileStorageProvider;
+    if (!fsProvider && builder.fileSystemOptions) {
+        // Backward compatibility: create OsFileStorageProvider from old-style options
+        fsProvider = new cli_server_plugin_filesystem_1.OsFileStorageProvider(builder.fileSystemOptions);
+    }
+    if (fsProvider) {
+        app.use('/api/qcli/fs', (0, filesystem_controller_1.createFilesystemRouter)(fsProvider));
+    }
+    const eventSocketManager = new services_1.CliEventSocketManager();
+    return { app, registry, builder, eventSocketManager };
+}
+//# sourceMappingURL=create-cli-server.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-cli-server.js","sourceRoot":"","sources":["../../src/create-cli-server.ts"],"names":[],"mappings":";;;;;AAyBA,0CAoDC;AA7ED,sDAA2C;AAC3C,gDAAwB;AACxB,yCAAkG;AAClG,6CAA0C;AAC1C,iEAAmE;AACnE,uEAAwE;AACxE,iFAAkF;AAClF,+EAA6E;AAC7E,wFAA8E;AAW9E;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,UAA4B,EAAE;IAM1D,MAAM,EAAE,QAAQ,GAAG,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE/E,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;IAEzD,6BAA6B;IAC7B,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,IAAA,mDAA0B,GAAE,CAAC,CAAC;IAEnD,gBAAgB;IAChB,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,IAAA,oCAAmB,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEjE,gBAAgB;IAChB,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,IAAA,yCAAqB,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEnE,6DAA6D;IAC7D,IAAI,QAAQ,KAAK,cAAc,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;QAC7D,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAA,oCAAmB,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,kCAAkC;IAClC,IAAI,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAC7C,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC3C,8EAA8E;QAC9E,UAAU,GAAG,IAAI,oDAAqB,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACb,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,IAAA,8CAAsB,EAAC,UAAU,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAI,gCAAqB,EAAE,CAAC;IAEvD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,18 @@
+import { ICliCommandProcessor, ICliModule } from '../abstractions';
+import { FileSystemOptions } from '../filesystem';
+import { IFileStorageProvider } from '@qodalis/cli-server-plugin-filesystem';
+import { CliCommandRegistry } from '../services';
+export declare class CliBuilder {
+    private readonly _registry;
+    private _fileSystemOptions?;
+    private _fileStorageProvider?;
+    constructor(registry: CliCommandRegistry);
+    addProcessor(processor: ICliCommandProcessor): CliBuilder;
+    addModule(module: ICliModule): CliBuilder;
+    addFileSystem(options: FileSystemOptions): CliBuilder;
+    get registry(): CliCommandRegistry;
+    setFileStorageProvider(provider: IFileStorageProvider): CliBuilder;
+    get fileSystemOptions(): FileSystemOptions | undefined;
+    get fileStorageProvider(): IFileStorageProvider | undefined;
+}
+//# sourceMappingURL=cli-builder.d.ts.map

package/dist/src/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,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,kBAAkB,CAAC,CAAoB;IAC/C,OAAO,CAAC,oBAAoB,CAAC,CAAuB;gBAExC,QAAQ,EAAE,kBAAkB;IAIxC,YAAY,CAAC,SAAS,EAAE,oBAAoB,GAAG,UAAU;IAKzD,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU;IAOzC,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU;IAKrD,IAAI,QAAQ,IAAI,kBAAkB,CAEjC;IAED,sBAAsB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,UAAU;IAKlE,IAAI,iBAAiB,IAAI,iBAAiB,GAAG,SAAS,CAErD;IAED,IAAI,mBAAmB,IAAI,oBAAoB,GAAG,SAAS,CAE1D;CACJ"}

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

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliBuilder = void 0;
+class CliBuilder {
+    _registry;
+    _fileSystemOptions;
+    _fileStorageProvider;
+    constructor(registry) {
+        this._registry = registry;
+    }
+    addProcessor(processor) {
+        this._registry.register(processor);
+        return this;
+    }
+    addModule(module) {
+        for (const processor of module.processors) {
+            this._registry.register(processor);
+        }
+        return this;
+    }
+    addFileSystem(options) {
+        this._fileSystemOptions = options;
+        return this;
+    }
+    get registry() {
+        return this._registry;
+    }
+    setFileStorageProvider(provider) {
+        this._fileStorageProvider = provider;
+        return this;
+    }
+    get fileSystemOptions() {
+        return this._fileSystemOptions;
+    }
+    get fileStorageProvider() {
+        return this._fileStorageProvider;
+    }
+}
+exports.CliBuilder = CliBuilder;
+//# sourceMappingURL=cli-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-builder.js","sourceRoot":"","sources":["../../../src/extensions/cli-builder.ts"],"names":[],"mappings":";;;AAKA,MAAa,UAAU;IACF,SAAS,CAAqB;IACvC,kBAAkB,CAAqB;IACvC,oBAAoB,CAAwB;IAEpD,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,SAAS,CAAC,MAAkB;QACxB,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACxC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,aAAa,CAAC,OAA0B;QACpC,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC;QAClC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,sBAAsB,CAAC,QAA8B;QACjD,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAC;QACrC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACnC,CAAC;IAED,IAAI,mBAAmB;QACnB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACrC,CAAC;CACJ;AA1CD,gCA0CC"}

package/dist/src/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/src/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/src/filesystem/filesystem-options.d.ts

@@ -0,0 +1,5 @@
+export interface FileSystemOptions {
+    /** Absolute paths that the filesystem API is allowed to access. */
+    allowedPaths: string[];
+}
+//# sourceMappingURL=filesystem-options.d.ts.map

package/dist/src/filesystem/filesystem-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-options.d.ts","sourceRoot":"","sources":["../../../src/filesystem/filesystem-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAC9B,mEAAmE;IACnE,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B"}

package/dist/src/filesystem/filesystem-options.js

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

package/dist/src/filesystem/filesystem-options.js.map

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

package/dist/src/filesystem/filesystem-path-validator.d.ts

@@ -0,0 +1,15 @@
+import { FileSystemOptions } from './filesystem-options';
+/**
+ * Validates that requested filesystem paths fall within the configured
+ * allowed directories. Blocks path-traversal attempts and resolves symlinks.
+ */
+export declare class FileSystemPathValidator {
+    private readonly allowedPaths;
+    constructor(options: FileSystemOptions);
+    /**
+     * Returns `true` when `requestedPath` resolves to a location inside one
+     * of the allowed directories.
+     */
+    isPathAllowed(requestedPath: string): boolean;
+}
+//# sourceMappingURL=filesystem-path-validator.d.ts.map

package/dist/src/filesystem/filesystem-path-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-path-validator.d.ts","sourceRoot":"","sources":["../../../src/filesystem/filesystem-path-validator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;GAGG;AACH,qBAAa,uBAAuB;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;gBAE5B,OAAO,EAAE,iBAAiB;IAItC;;;OAGG;IACH,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;CAuBhD"}